From 2e2c3e7bac3533af29b737ef7d789e2bb3af29ab Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?andr=C3=A9s=20gonz=C3=A1lez?= Date: Fri, 12 Sep 2025 11:15:03 +0200 Subject: [PATCH] :books: Add doc for variants (#7258) --- docs/img/variants/01-variants-create.webp | Bin 0 -> 9656 bytes docs/img/variants/02-variants-created.webp | Bin 0 -> 4988 bytes .../variants/03-variants-property-add.webp | Bin 0 -> 16198 bytes .../variants/04-variants-properties-edit.webp | Bin 0 -> 19744 bytes docs/img/variants/05-variants-use.webp | Bin 0 -> 8494 bytes docs/img/variants/06-variants-combine.webp | Bin 0 -> 17676 bytes .../variants-connections-conditions.png | Bin 0 -> 81770 bytes docs/user-guide/components/index.njk | 279 ++++++++++++++---- docs/user-guide/introduction/shortcuts.njk | 5 + 9 files changed, 227 insertions(+), 57 deletions(-) create mode 100644 docs/img/variants/01-variants-create.webp create mode 100644 docs/img/variants/02-variants-created.webp create mode 100644 docs/img/variants/03-variants-property-add.webp create mode 100644 docs/img/variants/04-variants-properties-edit.webp create mode 100644 docs/img/variants/05-variants-use.webp create mode 100644 docs/img/variants/06-variants-combine.webp create mode 100644 docs/img/variants/variants-connections-conditions.png diff --git a/docs/img/variants/01-variants-create.webp b/docs/img/variants/01-variants-create.webp new file mode 100644 index 0000000000000000000000000000000000000000..fe757e60c2584e8eb40ef92b755e27d1582bbcf8 GIT binary patch literal 9656 zcmV;pB}dv)Nk&GnB>(_dMM6+kP&iDaB>(^~pTb4}Rf~c)lA@jE{F~;vg&-gzCO}b= zzBpF)SSm+fdBFLOP=a;qQI>T~(Ht{)eO4`2lEhVY@n}0INqkdVSJQcj@WE={3F}cz zDf|CLlB0BY!_3Ug%*|Mh1I^t-&Argf8Gfn>A2z!H+P28-QE3O+}+*X z-63)fT_SgPcXxMpm)+6-dFHpj8G1p7!LqrKv1C5a1GBzgL z2+yd1XsduyuHTp%Y-%8;fqyw0o&u=Arw78*$8Q?9R>iczLnD-M zt2mT!E8ux1rVQDVWSh2C=gV!|w((@!wryQ(?;gW}+qRJ;duDe3|Jn3R(tk*7Bq@@d zRm*&QL%m-~)wZpllEdBI-QC^Y-QC^Yeaimj`~C3W@55Sn8+QU&5sI*#AZQ@6(10B) z($L2Pk>X#2GZiTG?jZ;JKYLnChsl6DDKr%4{8v+n2yDM|2tg=FKn=FTmPRZUwr#@j z|G68=LeREtV|tV9{ddDgk|KF_?in)b-G`KNv;XVks2NLPW@cvQ3|I;?Gcz+;3d3MH z4l^@Yvh)vn!m;K5fMhwcEd3Q@=x^v{O2{$IkSlQoaWCmEN6wKe`L!|y1RF?A3_WoJ zoE~!KGOe6)ngVj)Env@F3(ohredLsFgj?7ee&^h`1>W0quqC93RIqU7>t44R3D>rr zjg*>SGdZ=sslqe1ZQHhspEon>9ox2TPkJQW)^@nnAWrRex-wZ`ZMWCHztmQ2+s>3z zezDE|vtb)akyko==Ku0bOUkxAkL7Hm_z^+~BoIOrg%D+g5ON`?f+`TQC`6e;l!XwK zpaeqv6ha^hA%27qNbn9KQ|WqSj8?$H@JE+BqWXM5m6_}cOmTL{p)11>VZ6Lej$Y~RKIcEt@8_4!bI?s+e zY(X=}U!rZ>PFm3kMyYlIB^mGkKgFOI>`{7=qNvCtSA-w{fRg4s7-E9VAnZ;S|9?jz z2L@>e;K7jf9~LCLZJUM78Nm(dJs9w_FD5u+mQVQCi{hnYoMtBXvfTw{zd0Z)HHO;* zjF-T0d#Dy!{`jRpTujNi+l-041PXrz)QKE-KysL}<2bh9OQ85yK#hnwO!;wQaJ&Rg zOocE(V8ZbdIHvm0<8B5)?(PA{OK^7&)xl*j#0BIfa8(Bb2nHZ8fuTAuC<4h#putkU znJk72hs@7xF<9Q=Nt#E4I?7jLSLw+9XcLs1HOWt#z?RLK(6&V>HWlQyo9Z zVcQ00iBV)iA?!6^uae|5k3tYqT4h5jlr>8;`e(142oPmE)LIN*pMJ}R4vV!D*CT`t zVF^*E+T#pwZ)ON#4s58<%m0*&@Ks)9-Xi(<9B=yXg@^}P=4??OtLYgbI>lMhCLiKH zy*M>BCZK2^19I$xpI1TO!R_%jTVQJi;|%lfMK`(ZaUOa(>Ywt<^Be$@|0ghdaG4!u z_M>deHpFno;9uLI7yGf)MN)bC^w@{6C%dy}CYr|U88Qsx2!~s;@f79B6VyGR*v!MI zqzsKyuI=)-hnhy%XqNm_x&g9O4)!7X;URy8T_V}V;A0q@CJmAuLNz|nJ_uI}b-pxy zWDNku)3&el`0uWLT!URwq&cH&{12cRn0k(^^A+i)hT=y}Zwd00$M!RC(BECoG77wJ z_JH!h?3uxONv5qBhdSS!HZno8%AHw$5vdtKO1bueJgsI)^ka;(PrM+XVbUa;UKD;7 z3zEdoabWoRxtGMd7?IPPQJ!V5f7rm-V*Z8eWr=2kL}wu>zpS`hNX+TiuPJbSNL$23 z=;c7Aht3E_IOdOJMMWO<6**An@l>7cr(oI^LAMDVNDBElfgD$LhJFm0HVsIOu4zbT z=d$V@3CPn?!q*jw%F>I~*rbPKv~+1K;4J3NutYBx2nLIoUN%OQd0xKtgmdbfdoqP4V&9kle;)J@>Z&4kd>f_@la8 zF691&Zogb;X}R#uOZl7`3Csr^IWI+m=Fyh8GXl8>AgmOePfYa|{5kJ*)kx&?yC?Gb z-6;9|?w)w|mXOchC*s+gM?8B+NoQ{}`Ru))i5H)#TAbQZd6Lrq<8p0KQOy{hjFc8> zfcz#;W**o46nU~!r1dG4uTTe5~;37Nz zv=(Xq$~o0h3fa1C&9`>t(Oa;bajt6D`gv}898xx)e}3DR)%-u6_rmkfKYwQCII?(b z+PUPoDA=sEU^pFqx}i0x0%dvf{QArapnPy zV^|I@tn1XXm|;xkwgCJKgg^44_qfd-b#tQg6!PWlTURy!<=@#ke<;FhI)8Qj2tvMS z7={1(O%jwwg3PCV8h&se7?6&KEHb+pWls=&+qPu zXKxAl?0q7hy?N7r^p5To6Qr}Zxd{d?oHU`Zy#PeB_udP<=ONs}T3&YKpiEpGjAZI@ z8FE3%4G?RNKYl;aGK4qL?n>y3@qmHuBJT?b5Y8%Q9Pk^2rGj2*(7uRT{GJ}?mnE;Y9(e`L3DL}rI^s>FwPP5Qp z6(@tNnS?A6EO%SebVhsz0BY4V=7@=?GK@!!Z}D8fXgV@A2QppIjoQ-VrOV+4b^B5e z7TN<$N_vf60|&;X2$|sEBpVGN(pxs3L#C4JQ3L=cj(QWaL^0btCIR3qO0Bd5CPr6@ z>(_O{wE)i0Z|j6(4H`Gam@w>%2xx{BW#`T_fsl!Gx|yNQoQLj|cF@$tle;pt0^o(- znBGKo^la&NS%90~rT>G8LD!ge(YKr_0P{_o^oyPhn-y~$fc6fj<})b+(H54bcnwpP z0`O2H3IU;#Tjz8rE_8hEa<~>iz0rAgfalIM4a0bKm6&eRq$Z=d&~56N=M2tzX~0gw z1!XgG*iqHp0du>0-Jb9^UE|cI3y0nxdB`fZy{Q@IK#Fl{y|%lDd@J?@w0mKghK>%I zd?oiJWc|X{lKGn_eP;-M7AMu6OTtjc0#Wd+{9yS^fE+_3mA7c@6F{UnyM-^=1repM)BU zEOy!ydTL{i{PBq@o)`LcBteY{M+{G6A@_yv+C-}(1KVGf#@JgX4Hx5xD;MU^^ zyG;2^#XEf{*6AfJmBg?4^xw63$;$7(iS3eTVM(@8ziZC{a`m{o5XQ$0{VvU=pjCaf zsKUJ&?FFKq&$*QlvOYKs_t8i~cI>XG%p%VeQ+`<@NIP}BB8dxpL1#;W3 z@$C1t_{oYNz6$1Rm8`2o9qx>Ofa@{}V|@0|AL9q^e_LNQuEkL{y#w^BX}}Qxr$z1^ zG=M<3m{)rDrQE1rk2pxVWj=l$=86j98sT}7H0o8owrkx2NdpS^SZvoKM*ewnEiO`a zVE5Hv;fNc`Hqlza?)JV2T6E^_(6BF0j7EP15i8Ah*|yi>DLbALqine14y_UFZtt6% zPH$|~v6q>+3?enW-0@f-M*Mz?5hH&+L2P@;TQC*TfA}b$Dc?ltz#*W5G3Fi<^A8@NAj|oAX(=DMHExOd)s6@Cc}2ZqOD| z3CCUO+$#!EC%xbSOOH>mnwpQ%fl%)4TNYZnk*^Fd7KD#9z0vltz8J73%R<*Qz5*71 z&iavc=9oj7`=teyl#9fvZ6)*{=J}jTVq1+A0iDUDI!#sfdtxRpkt}?A#hr>yYP39J zmU~ol6VQQVy(h`bT5WOqq8;~QqkOOJL_)J4U78f=|EdwR}u?sG2b>mTQAO{`_Glo%2+0r4p)p7o+CbzL1dTN&)u$NB~= z?T#9(PY+G>4jR_x=){ugRaZFUgfShbJ#130s3q$Cud7KoKP^tn9$d#33>83<#zW~r zqZ%#>#>MJnk&l4x#s?zG#_lPU`&Xgfo5yEBQ}KyqC;zq$qpJ#*sbQ1G>x;q)BtQqmj#V}u}V?S%O%;Ds^gpin|v~;)EpewRb zK8u8d{9!#$cdMt@nLf<`w560>=l-cJxj*G2rc^?jKIlXrN5{?LC{oPD?6(Y~FtD5i zhQIZu+ix&&g}ahT>~cjk0?PqShmo8~Uo+Y2>FS#uI5n_;FXt2?WN5aOQ9T;{&Gui1 zz>%TvdxDcKoYGp#CO2n?$!*z@5u!-4 zirhBsmi@TdPPDWy)rzJy`(>1TI!nyqB$b@1X)KPg3dH~jqIdt!MPQ_BX&DTC(N67O zT>X;{Pxqa>+3;yoEfp+}FGauT8c1Rw=(17rHQ};63d8`vH;{=n6H6^geOw-r%!8I?GUR@>9@(g>=0*klhw-{rrZb0*_BNSG$u zyT<0mA>+OHIPC~vd1Bs4wiFeYEWJgS9C&sM_Hi?hJ&APc6MdXHW#G3}roItfh0pJ0d_%_`f)7!qjQl}bPjmA)hjCq(v6a$VXlA`W^LTU$8ynn?U z_q33IvhZFwq-uOTZAjPLAXR|ibBIY}gWs;_D1S;hWp8}h3ig+l+x$ag(*CZ+$t zP+XgjcL^2-2q#vSF8R192^uuF^#&7h+DwEpuNefhEMhtFPOVgJYIxNTvbWfQbtrb# z#c#~Q0un8~``H9se+kO);)C!J8h^J91s`^5ZzdlGA3er&gkEO~&Wsehdu!+jS6;$%EMmUV?v-p&18=Akp`=TFq&a7&TEc#&u;ZI|6Q-R?TF zB_6Sd{HgWj@r5)zTpM4RE-cXe@kt{oAj_YZC_LF6=O_=P;5axWz`7DBB4ug+rk10wdWCc>rp{5V28r4 zct~9uG*x-TZr_QJ7<69wy1KFawAx*DyD7kwd(A4QTyo}JyWiJ?((tg28zn}*SYC&RNeK1IrhlrVB8}T$N_J!cAaj^S1pc zXJ^`-{CWEAicm7O2TN82vi2AiSoOK{*Pa!twOS2W^bG^MeQe21nP^_^_RL3&F$Owj z&sBfRu#1EP03vbCN%znI<1_6=iVi^$Y|5 zsS_wl%=Fti=)AOe40=!ZfD0(kQZ+s1qd4V7fI>=+>Hn;p7JW&UYv`BtG$n)oe^>bJ zWtDv~BgE{9^|BM-2D}BkrFv5`?8_oO-+qLEij@wCS&l?-R=Q1u(mSKw@D=Eh_&L4D zju5lwfrAQU%kp#&$bv$etqMPz7Xew!*Q&ES6$llq%Jn7j`G70sb)57M9pg+{`&2R+ zI&bYlTO1Q6lrp3o9K_<*RCBaqy=duU1?!%m-f{GwqgZ6FUi*%E6RFd_{?M~m(0RE! zsVs2==lz53Jw5Fbj2WEz^iE&nxG^!p0V%I41Pl`hRNm6fB80LxHRf}tL4XxKgmMOe z3+gD+A<{P#n1%S|(ae@5ak)`|Pv+Xs`v$^6Ons`Rc@(BYPswHpQe!bHMatQ3-a$jJ zScN;v)mY`I1TfXA%;eI_NO@Gb*1rhlsn2jR0(!;&uyR|-W4!C`1=?pmA4W4hBB}1~ z0WigwufA$fA~G)_qn-bv$;qV7>Qu=eKtwE$LhhB33L7gM0J z!Zp{70O1l|Z!_F7be=bl;fuW-gJb6R9jIgx_nDMOH>ePq69*QL$2{_=_VJ$0|1cLdHA|erCT(CJ0SGQpObKzi=Hzw zbl!do|NSeJ^F>msSl2%zD`xtR!gp6U5Gma%LiB}&kW&r985JZH%=4vySX?0>ZIhzO z)UQSIN!tXCin$yBg8(fOCaPT1UxdE43E{a2H~=mn(<4TF0u?E5PSoR+>+N1`+%ee6Gu(&&= z-=f@I+5Y64e0uzP7$!pFLX-XfPd0%!n?Xxx3P(aRl=I;Y&ed}KLAM?*!$v3*)*Rki z9~Oc87lSoWnkn6sY0fiq?!mFF9=Mj{_R9=8+Q0^IARGd%VK6uo>PY$K0@)InsV~=! zX+5rN?AQpl1;6QFm;&0tda#g7c+!;-!?U|wh8$(dEs)QgC(Ys76gt7gaJ1u-EGGDP z@GQZQgSlIwpi~^ME)5t3y260kW)U`;<(tsMFISP`mQ^4v;rz5S><-1k92d=edJqGB zR@r@t|E6|TlHy{^J)zlGsDZwXGO=b1%@~pp!WclzEZ^x+V#;!EBo8O#i8bM4OiqDEA#_Os541Nr7W1s|W|Hop&TLd`zVzV_!+49QJ$ zm1T%{fG-&L#Xf&R$BV;;5r3W{M*Vsw99IWT*+slvAR&qA{32qoBlSiPTKJidVE<2` z=k#R0crSyGX;YTX5SJANWstV}DI3SNAD>-YmXW_7agb}vvf7Iu(y?dRxSvv*I~I+P z&%rjsC$a?ze77`yWTIfQ>vi3~*$2F8S?#{+7yka{S`209LuO)SJ&xH$Lfe$iEq9=? z{b+}C;QGMks#5vLb06Y9e!;t;qX$FGV7WE_KkAE{BM6sy6C?n*fwc4j2Y}(h2LIZ| zb%zatyy5W`=@yU*28-BhRR?Wn_`}fbH#UJmW^n9v9b2r0@AJIEjN4rDFl3u6P^kx= zH^?U38!Tnra62lj)mkOnmNSxERUC#-q`Z8+kaz^ZE3>{!-c$?51YcL;$Iw=lmK5o|d>ufwd-gW*PdU_(WVQJ;k*h66kTz)|Qa zS1U&b*T;Al9fd&6deJt-j@?ey70s1&lz(}&f7x1zTGch;h@HN~=LoTZwW{*Yt}QlH zcZB3c0lqO+WWNsh=Gl$EERGky#}2#2^5MKDP0W^0cD;_%E=eEix8*g{`crG z+uKOYdu@9DzEM?`4t|;=_|;1PU+(e`8;c{$^lPrb8;Z(e9OYz}*z2TCjC)O*82$Kl zoM`O@?-Xh?dmc90F=#kQ7U|6jlFu%=Z|z5Ci+}or4U2wxzvk2byKXB=cbP`3Ao<`i zb{?KTL&$8A#qB!Ptx#DRZnr;|4a)X2A5OaU=JzM~W}D%Y0gOSVS02g}-VKZwMJv;( zn<>@zr8MeIzFJgrGYIXz`*PTMSM78_ILOYsa`$Ebq09``ypo#bfEY&|8s7fIqMwP^ zOWsy#Z?({1FwWq+u9vNX$-&nnTpaQi@DedWA7Ylp+6jMqazL=*m&;9uPi{vCJd3Yl zFb*;LkB}AZjQur{Qj!Yxw8kAFdeZh_+T!)$GmFC+!*iXSM)kcZgE}I(=Ka7442~Cg z4w{%bs^tX^VrIxeQV;acJ5Q#kePa@Jhs3Nby6-BXcpAy(_m%^d8nR1L9|)m?<;~P# z{7KP;-EV-WqnomzFEsyx6YZ`M>!e}0F&Y*x=2|%<_eK|r%55m`;Y7Qj%fSTs%;PIc z4u;$4Hi)$$v!3Pxj(QXYfs4x4>id9~I7xCDD%l>bG-J_oEAiqs^T<`bt3jzx|Es_{~jM- z5Eayx#1zO9)UTp=s^cxU(g7en6Vj&4WNOFRbZ*)`-9ue-G0;u4G&K)q3b%_{-QPlD z3Sftlq5PrUtu2W>>jHTWSjAO?@&yU!Z=l zt+PZVIU!x(4Z_v_o8(%9wo1F!Cj*K;G2n(RND%a^l3I(qAe)R26#6 zANOxb)1(Zq7KEQb`fET}JS&|j-$aomr$BBlWGMZwfFU2U+q_RzHmw=$j?`PQ$mPh@?;qz-cw6#%@6$BWNXb)wc6Z4-E}|E*v@yK* zG^Q4Qz|gw_KxOBO3CT2nZq9B4+OisStJ#z(7m#WGhuX)MxJ@YdOzzlrSev*QZGoV2(-8nf!g05tO zR&R|%v6~TnI=O?@06LRN@j$;%7PSc#G8B!oKYN1!x_fx!k$~@^h z0A*&k&{%B)5@{0buhvh+^e#g!)xEgFkaxf1AAiZBHle~aVW@*?e1*^fZ}%!_Q=SUh z?x%S7lzGy10J>X!0sB8+s4u?(#A!#J8;R?sGaQ`g6j})Xj77^kHj3JW3erBeo4Z84 zBU6TWaj9ra9(_K1j@Ze~AQ)v4%ghxQeD+YO^kbMGVO&sEZTKD2eL+V@+N9Yw`K(QYcAM$Di6vxj18Aq(BJN~E*M)64E!fbk+l9dS1@8)T2KX^iS) uahp)pyDYd_z?>ATn?*kIwH2!s@=-Em*LbJu-r-QC^Y$KBoC-F=>&J96#Zd**k} zxyZi*B&Vs3kc@O&Kr^bC28bqG%Ag0gc*tpjdNd{52CyEy5IWfOh9{>2dLSjF0IG1y zh_nvE38A>n=s_FWlyHmSAJW2>!9x`rQHmZUg@_L5iiax597vLtR`)*~50AS*Jl_Qf zNO-pGu%mzT_3W2?-NW`^SKirUUO zf7Sk;NM=y2f-06b&?^XI?I6rFxP(yYks-yLtf9uX3^OxWEFUKIHKoGLDIexUGDxO! zVNMni$5g6Z7*;T_gWv{6g;&rg8yJ)$L$!cV%XZ2*5Wp)ZJbRAk|d{*{{Ooy z@Dx8i@$a##)X4CTw zinsO8a`wIu^ES=vQX=lZ-w7j^#?nQ`60y*Ug?$~=5Uj;JeQNQprOD9)|q8XGBq8{wtg zxb?y%d1}oe=bFBa7onJ3Z@jo~>qR&wR>QybZYabT3)8PE&73F38|lWZCW}*OSukyx zauz(0l~E_5A-?aJICc->53RTk;-!w^OKT_mkQ1ZJP9Ae782$UoxN{Va*M4TpmN89J0DU~ z=eB|;h8y8koQVyJyE-}7@M*jl#guyE#W&@FVnQ{FU!GKLE*;v0$lY=tT}L+|aZj4- z4;p*+wb|$Js+=nb3DvrrC|7lD9Yp({Q_kWctPDXy+f(KdF=iKP{aHyG#spzww1dhM zV&=3W=d?>Xz>IOKp+lS0Z87;MQsEqdsULC+mD$-YLiC*VVB&^Oi7?YIOIg_a#_bkD zc;EBOf(Ktaq*jWMg_zWJ&&pUkq^70Lkx zT|-~_rFl@zE#mgKkAv4taqi>ho`+3-jpm#i3e&Kfm4 zt_p20gufIQstn z_0OP@ue^9v*Crfprk2gk6k;qB6PcLE7a2(xj3b?iav95)sX}U)+&X0B-U51l z`*8I2{p**3ERH-95)ttQO+x*7 z2@SG1K)C&k+_9F$4MbF~)$Sp@Debx1j4WZX$Je(~Z=XND8GQa*JmaT@Lu48UCc5k6 z#82~~rLlce`HyvROPy(n$kt$=53R5bLb}Xt%_}0lrpbv&yRzfWB#d2U8Y-5F?nm}@ zzn&v-cAyC{BWoxnqo|?54azxano-3Ci5}tXpjBO#jyG?jqN)1GOVPJvn zRi>eFpntT7SzAG2PiQgq&q7XZXPr(eVQEe?DGL9Q?9urBNDb*V{)%=oJN|UHf6c@P{AswB!WH3Jx|b z@g)lZ!>s?OI=1MH%GlviCKB1tr$E6oiA!p!x;0CjP_mt2meVl7I(}Q z(h(A>YT1HlxmHXeYv1c2zGyi>c>ceKvDBz5(z=N+Pd2$}7O&S#=#L7`%Bx)^P6&=ni;C zFbFNNP{=@>hdv1JjHYJQnw#|?S`6d?dY2;f=Lms7IPK)sD54 zpuM6hX0H;K<7rtK1}S4=#}gF9EeBJwU@S+k$DqV9b_vnjtku3@SR%f{#Dd5-HuV(j z>HGWhj~JwUxVdd&t=80)##juK152x13Rc%;T`;+OS(VRP9q9!SCU{|yk-hy>-@gZ7 zqF-EPvp&#X%<%joC3Cw~-;yfF0C?c+R*&1WuuMOS{CE0J2!yPOoX+E z7ay#-m;eAHL&Wb(4g1O0VhWWM#T^kyJSj?x-_GhCD+rCADYAIjt8O13@DgPsV3HWK3IuQa7@bM8 zu=SoUG(^_-F!y_2Z5Wy7WZ^#c-!`_@BQWUDv{e*0R{UT>z7>ONu^tnMKS8FY99Ip2 z*meswi(!YRt)e(IYzd~jyQKzm<@!jrNs+>Jfk4tZNp-=UzU>7OpjJX#vaa!I`m>a~ zoh`dKK@h5ga?RmvBmp)9Y<5-{wd0kBDZ7Y(XZ85*vzP&lNhEcUA#Q3q{drbn?wdW= z6z&V1a`PEtm-6X@4n>imIDC#E2(rLN{OgCcQVDgVSQKZQa}e>d>sggou0EW=fix|>oPFqE(l7v z7eOx7{><%}CM~3TYD5T*VlgobS$^#--yFmOVEpi|cB%1C`@XaK6-XYI60abQmtUL9 zHk;#gp{=6Sp^>7v*a{IqGyHmNkltu3FxvyYelI+BSmqvt(@U3k`wo<0zWrzHX0daT@fDFedNeJ>61`!8e_LCK05|R8Z=TAN7Fro zgoaH-h2L4RJBS5x;K>QwRfZdxtUh!qkz#vX20eMDc2(ugV2o)R)hT{Z@JzMA=|j6k zDW{R5xZ0evNV~7tFD+b5Nd||~(D0cka7*)M)0^b|HHOE;u4INCIn>#vA9nT~lofX8 z_T#D_M$!-+iXuQdJE_jU(``pc{i2u;iNqsCNbsa-GHk4A8`HfOVPFNOpEMdO;8Q5A zqw~8&oCom6N)Uc(e8Gx?oYZsdRsy}h|Q_6p8J@rnxp;PV1Au*9sE{c#tVW>;ERNsVj`I2;6(=Rdrc!EWiNe#Ung> z6+Qo+m#5GR7ZFTu+1b1_VU~skQj!=&0^<+;_--C__Rm zON5rl9-gTLiQA1>)8wyU4xcKbE&8Py61Th4MrZeC4qpDU(SEvt9 z%poub8-qdOcFTTh0ir2$j?Egpc{1oW`wBSRZtg~b7Bo)4Ou!g2_ft zI-|O-jA#l|c+-VRTlzOhkg=d#wwAxOWeL6_ZJjS^2?}8qp3Oi-pJItsnRpRV)w5u+ zt}?M*E7j8H)7QlgPj6`uik=0HbrYKPpme}HvcqAjbsRw^5)qS-y>Dn(ZApQyy$~aa z8+s`jR(ume1D>OizqD6TWBg+_@SZe}$Gu&O(D{2q@u<=g;) z8QZGT>Zqax_@&On6k8yjpd7|LnZtV?p5zh8_qp8te4C(c^X$MS(&K3yrfcP8n(ophJwKtFVJ`sew_ZikvnomR|2uHbEYvkC*-#F7S$12P1o$*Dt zO&X{4{pj;rw>(K96{=bGxu6{CxzfOoO~9_aT;L05Rddweg`{!J*pEK1UCvU>`1~{Q zN#U9teSZJ$!trJnR8v@qK0G=^dc8c)YmB8YFsCz>FP)V}ngq%-4k0BhsHWDNvXPFy^&>!G8V;5;^)?Sf2I=1aFTaM@c?S6p`49OI`49OI`49OI`49Q; GbY&noD#d01 literal 0 HcmV?d00001 diff --git a/docs/img/variants/03-variants-property-add.webp b/docs/img/variants/03-variants-property-add.webp new file mode 100644 index 0000000000000000000000000000000000000000..c41f78e44515f6ff1ebc845a3099b73f096f2175 GIT binary patch literal 16198 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%0AQm0doL81 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 literal 0 HcmV?d00001 diff --git a/docs/img/variants/05-variants-use.webp b/docs/img/variants/05-variants-use.webp new file mode 100644 index 0000000000000000000000000000000000000000..51eaf1c1e24579b1ccaf2dcd45a31132cb0451c3 GIT binary patch literal 8494 zcmV+}A<^DaNk&E{ApihZMM6+kP&iB)Apig`pTa)?YEjU(k#o87M}6}LfQXm?cL4RB zyEVN@Cw}Oa=az%YPEB5zn&9K?WGA=$5Z9Y!>R!W@Sv;lIGGLKsDL32yHgeh^2!bFu zkq{=&tZhLcHc#3t2%Cfr+?*zHb07qQAP7Q$1Q3KE2r70cN*g&2$5=)>&3OSfvZt?u zzf%KSf!o*y=I&I1n{W*-WseR8Mi)GnM%6vwMis z&K|b~ryATz?7~NP>)VtkSJ}44wr=BxAGUCI5(FCyVTB!R<}k2>jm3bllZAz_f{h^9 ztY9Jhw=8Ab_JpnF|Bp{Z#Kc5IM8uTa9VmBHI#3vuJBC6`M7w<=W)$&>^q&peNQ!*- z{3YXRzoZ)hpeng(L(IpFD?H7Cn3<*x$6Mdy&O z0;>j>AW0GcsBQBNP9&Lx8)-IUoDFHB%FIk-8OB>$E7h2-2{SyQPf4$Q;y$4-=uxf& zfN5L(2cyFrl~htQa8mM}dVx!s*)B6PGc!GJnI7}Tnu^*U7Cm+EKO{(!oJQFU^5&&8 z3$uitbfWElBsom&Tuq(#-h1zF+-$3zU8gmO_(x(K9_XxnzuTL1q|#of}-;7}KwTZ568j_{78 zYunC9`Zr(qAj4*6=gDep+qP}nE8Dg`?NaiEUu;y*6wc|l|Bl#3QY1%OJZ8Q>-Ddk= z*Ud5nDB;)yOoIgh8VUqXK_Ssmfkq;ra1Fu=w3QR#3nAV5HYfWie% zp+H#S0H+{uiUSZ(AfTKGDDYf5-oWEDMw%lpk`}m&xX)V{E(KS)VrdVc4P55z(r|64 z^a|?k09wEUcmnrcAX{k)w;I54g*1cvoNAp3?l|sTDV3VQIp-I(c(uwMI$Km24akw}f4)=9*(Me}Iap{cXy3%=@ z&UB^|7Z-=a;cz&rei9XjOaIxhjiktXx@V}E|2t+%ti8%_Mux|EY9{@0UikfyCIGCB zr6A;rj7#C^Fe7-WIQFad$ejj%X|L;$$>wq}BVMda$d)GlYvMn~#5zdM)^doQ)o=$J zk&ZSQ$CShgEkTJejy7Y6IB`rf4mYFiu7x8vJF8)R32KBPV#YDWSW3{EnI%Cjgxq0o zEdr%UED3@kPH0Ag&Q9%1kPNXzXO|FEV}{IbMKv$=MP_TG8gd6RTNT+5WJYLLimb-% zp4I)nLy^-XeiH5z2Z@IV zw3Lb!gN^|K$eKE-E$0zn$cR#e_(^z993&P#P<>rqiUA=gOOLr7XW}Swnr?m*9zv*# z5~p>^lqN%;+NOr*pf-|E0n*cn3;}Hk@PN!)MROXH2~CcBkFs-IyYj!|_s($~w%ip6 zkdV%xqa9nzC0Cq`r~>ewP}MJ(%M?~32W8J##*4C`kN2jNR{~4CH(kiFqb?X4bd*}k z_sOKtsMU^`+X^-eM1ZU8*SZ>OCM&C%ocEZiRdGN#cnQ<+#U-l=0xYCXSh7M1j2Hb~ zOSpO!5t8tY3ekxRu2|+tSOFxC-Rh4eW5*q29RX*1-lnDod&z==PGk&dM;I@fa(uKd zx0xUXk0xrD7myRKDym{11O8$%elL))WCXDVM<=cUKuQL}Wrd;MrUox#K~5~`BlCs$ zO?tX*CQvc@E&ftoaFt=%ZVicJP00+LmQFi71c^t~&7%v>NwqU0Lrkp+!$qV;!K04R zZ|+B2>QOfB)QK2Bzb)3>PO!9@LPi zWui-8a}nuqv(-$aNWw-~U$Ob_){!7Nx5|IoXRu>I`2V{azEDf3g_~@MQ|N#_mYtYG z@X!qePky=BccQlP6uNj?Wwg~iosj7 zArJ}jrsw3o-YE3AC+Ak8`?!?|3$M^)T-Bv7E%()Wqu|Ng{B{fUnH`_Y`+ zO(}D_(;CEX*C+2*`Ad2>pgH-B;;g5Oxh~hG7#Y1uCy>5Ls>wM0x!rz49C&an+nUX` zy3IxbINMJ85~uLs@Qm!!%saPPNCIpQ`Aw=vCnHr}U$D8Z*0Nu$euGiI$g=j}G!~M= zl_Ga+n)Q>BD$iPG;irR5utu)cTdJF1lz#KqT>4Hb#dt>mraJOgiTyiMo(CA3@$?sS zuAUd1xLu)M;APJDai?#9QbV4J}tHSYrcaAnO{6J*=c~c2B>!4 zE4cn(p4BhK^rzB0CmFj6E?Ow`v>Ie!SC!*@2l?#N1<##0K~l0r*lOcAv4z-+JdL1+ zBiIvH79uY)qy)(eX(~IZ?kiQ1M2gmgL?elh^JJlfuDeT%WYs&qy=JmRXL zSe^+X9A{pJcRd<030;SaW)ffI^(G%gKoijy8IQPd7G1kD`5+vciGPemSY;aaY(e*F zQTS=Y{~%S4)t{ehvEUWQksUJN1)msxs>>E-9~{KL#@0PU2PYC7=c#$2ZV<|`FiB=L zFFKT z<(eL>m*Ku6bfqWu6k8LHlTFjvDg3mP;J8!?DcsAIxrPV%o>s#RGahl~%!pbT_$&MU z1b2|9ffPg#{W-4Mm>KkEUvc_#UIzMeUK{#zUNG8oUPbzIURt_yUT=Hr5%lJ95jde3 zO9{<+Tp4!PBIwWK#%bceCjO%l9exDqp&FoJZ<&j7q|(BKNo5!1##)fhdr54V#TTS{ z-55(BiNnn(M-)RKoB_8;K(XWKnl{<|)TsMwKm9Ene1s9Ukc1S79J>2&rtQ?KA%A8r z9`BMwq=ef-c^66?+bdy?Hlqo&^VW4hcv3( zD18@NV(U`2x;RT40^WvwHcX*qZ1xgnfAhU9T~@G#V)Yv0e^>^vo{-oHFw&G=YakcPUuW4*~(bnDh7t zIME&hSH)H;`M$7mU5#2VSp=w%5g74F&1438N6i}~3;uW_Es`318hBxM&fv^uKPWM2V zXTn85m^=J{6@jeS23u?#XP(VK+PHuOdSWc9kq2?tG`a&IJf;w(Vt%3i%E%ArP$)Er ztxqVG;*M#zbf8YhcrE*H&)9~6E%FE_RoMO>xqz(_ZSZmdIW@|aD zQsAs0nxkF4%5VU9&~bBZW+Depqn3$-0ya-v+cheq`H#2p2$_jl(zPC?S#va4-!g7` z>_tq`{fg=Bs+HXah%&Cau~`?*Bv>Yslt_uB*@eU7D%~K!VDje{%jRuM&OQj1$pioZ zu)-XpaNh;lP;G<=8dNon44sx$Ibqbg;LUzd0MVen8K>{(XaNzgLd39!qSvJj_o1#K zYS0wC;@lH%K*PKT#dAVcad`@hehXa*YGtryzfpi_5wrJRzzaZXD0VQEupAIKvu(pO zBpz6^-#tj=hlI`6N#zz7}c|)FQB^?-RsUhUCf(3QsIMu8U5+mrz(zl z{g6Fg>FNq@Cu<1m)|W8Y2j?&Q?@v2ZEdXcwj=~DrWx&zTS(*qnRd-m{U?&dLC^V+LDag_D7#oScSkuBi z!?SPm!<)X%@VYP_GrDqHM)UH*0&?0iYoLi<+I(^_o6YLv4@X*waR*!#+c8%?o?xWq{dTx((5z{&Vnh%88<@$(1Jgd-pXWZmMZ_MAl$Gyzc#un!3vgG1mEk3p!b!M2{($P)NMi;CY~cXM6;);I2{&kq^H2Z%DQAk##(S^M za2dYOzEVQt(ZZ7>SO70;t0?(+cN<^-fZPK!+lDcdI8npH!Jk*M%m zb#ck7 zKx?}cya7=;`<^^)n^;oB;aEnFm|q1%d{{$MX|IJ3DE;=2%M=hlihE5S=w3hm1K;O=&(Os_sN zPC0>iKIzj7e{D@U5Am~GW3R#11oE*SjJrCt;*)nPRd}6-XoT-0U)y^{zE&M@*WIRs z$hzceqJf2Ux(_78^lse660#x-@vKM)i@yf4P|rXd)*bG;V=&5fP`?VH(ZCnV>tqQe z*>~&HVYOxmmde$dU1G9?@&3t8obdLBy}c1yJHJjf*S?r4F56YljFcF?Pp*^nZhcLZ z!h%*Twg+*-dkywp14Le;8-!N4jBru90pLN4D_zMFhL41hG(A*5K^+$R zoy)Xnlb3b}FOKC(B!ui6hcCKA-JGc4A3&7krcp@4Wr8*R8}SU<`GbAJc&yfG4gjv! z_@3EIxhP0EPtC0ACkm|+p>8OI%kq9U37O&E0KwmW!eh3vT}+E-itfHI%=Ksy_UE(D z-M|8;5u8bjlky!ULf!mxnVzSVooQ~Of}9b8#v1v#QOJsFYwx%5V!y>ye;9ESFw8U629qVax*Y&IDVK!Bnd zcWsWjlok8Fu@pH0CwI;0YLyCgbK-LjT*GL;mbIVSw_jjJvNZEJ3ZT#gFroKwn9hU& z0_foI!|(7_Ie$GhTi*$kb@Iy?S5mj`t*Sm22^z%4CrozR?li+#9ZPJTclv2mwE_y* zDz)3wn$=QWq*M*d7+-!~RDK)lT02@*5|a$518?u~oCtByxui=DhS@I!Pe*$KQqp&7s3~~K>^x&1NY<)P)mTqT-)T{I?(!*S;uEw5RoW&AR2xE-^Wci`zG2n%h29$nHLIp48~Py>DUr zZGzb1yqJW~BbJQ<4`(CKeMcaeHH;C^gXzFY#pJ_F|H>=?;(>dp&eeAV#Av(;(76-u z|A<&M|5L90+#bV=nu7loV@hGG?6q z)uU^&J$9b-)$z_ovL^rK>bcFG1EdQfs|ipE zL`F7ytaiUAA9kDb-qZ}H;86wcK=rhhvv@T#3zleyHQHNo0tK9olF~xLZ2)&M7wNL< zBJKQSd+rE#kjAfb^J`&fnBQl#J8YV{dX;j|D5RoYF=%WFfBQBrvlbFU`LD4EzJ#pyPW=ZULv+{KiZ_nit=7qkARz@b{4PZ zise0=>h+Ei=r>b3b?HF9vOxV)rgQ1xYU>hZb_dUs%r$gumDO6Noi#Z2Z!%Lbsuw8 zv~hV8!BAxvzRy*d8TAcNfOCZ%E%Iv^vq#4ZyZ~<6ia7CPPB#Ro*wD({T=>^q)|b#3 z1l}VG7MI8Af20(!SMNM|k&dW<(~(C|-(nP?sX#8Ao6QiHwZ)l-pKCOqFFSmQE0ep-uM1cO^H3gGIq>x+Nb9NPYdOOtQ$*qm`=l|(OnR*tJ(c)(rJFF2p zE|9TP+XtTwwS)j2|Exe%erl*+tb5A;WBF8mb{AqXpH+~#BqbeXS>rzMj_9BPZ$7s_8Ub2 z*t6d~0>GZWB?tg_`aYom-07Q#!yw;x6pKad*KNjQ5qUK6Ut`dTbXe;oOYXvuNzHxJ zG>a6t-&q|tjom6Vf!A9o8A1o_GViZ7M4#IzAG4vGuk<$JH6VydyRS8Qp%2*I^3YQP z8WrVy_6Ok3>jxAf=q!DmByac~2A#UhHNO)qqoE28jDXX>1j+~Aa9)&U%|(k`#EM`h z9~os;H?g27uOC3j$VmCD=qUgnXl5~>H3g4a&P`qIvTUK~rfn&J0QkJkN`~zVTNFY5&%-u!EAEJ+$?FWXyVraze-FNhmLu-Em>og zj}OfGo=W-cfDiQ-7Lt*{YKv-Q?k@`XwL9toeG6lHei$jM?tN+26oM0YDY{cUCW`X< z0cF+HY?i!aKTtvr005bpv&Il~AW^P#8<9*NZHcFpN)3}szrj(~8M}gIyYi7X%<4f& zxX`H8hAI64^~XErs+puOH62M;vX2~6laZS0!qK3LXO?$K*N9~nDL{#NRbx9;D1Dn- z&Oz1@+IuREC{?9~+1~9}^A$%YuE7ni-G;q?1;dw1yR{sgFDI<;h!Pm?F&HnV8jD4F z{eW_{l<0~&e7FvgX5lrWSRv<55yf#-@1=fL|*kp639FDdiIYDKS=;6^7E@QwdU&yQEK#C7c}+ zJD(eDe9s$3WAT97iC&|AIP zC^cuj4*(zli5*}+7DoJQLW6J;|MlIFXlP1B)I3UWiKV?aRlu+0wxKP1aE?-DGL-&9 zD-aMhTRa+NhH&Y9x45%z{*Y{5J)LnHP}Uq-WW!eQs3qgl-PX;lIIkZ-prkLRdw~Fe z5jvG)g`98EI|Bd-XkskGSwMhEIYS6{jz)rU1NEpk3}d231WTF%;0aL~pXWdv<*}IS z5C-cW5(cRF(iB~>*4K@91rpq1ucjgu=6@ibn)|%Z^suMSB5%?!&g%yd>8Wk$HzQhE zLq$a7Rx{7LMU2cMS710pU~WLZHpK* zGJhBw#GRv$CRs(5e6olA&A?35*)S=3<_VUeOUB`s(1}4$vSsYYy2bmgu2jEl(;I{1 ze@|X_Rj{$)i2b=P1xrmD;Q#}IYu9wD{i!9Yjr4(pbh^${p>dY%-gb^gA4~H2joQQo ze~_@)SbEGmxrDOAYKe0|2twbc=h_xD#|5)!o8z?lI-Tc}mP_ahZm>G0*juq&S-Dmj z4j!}Yi4p%+jl)1U*zl^A&7Pt@W}jh5CITU=SZZnrn;&E}k4ur$yH>Y3N-gX4Cd}t? zQ!DweiT|4Tud!y7Y^GvX8pa4pFm60A1IVQ%Qv(>bw>bF6Js8igPFoCaoBX?w*B%aW9m9_0X>~Y~ z!tfBt$Y`C?`@ql<>?%%a7cK+{2}3Brub9SSUb1mEU%mtofwJ@%?B$_Xytpz`XNW*o zaelj7p}sTqscqW19;Io6WSyhn{5!Z}DeLOek7evKfv(~|8RDSB4QRv_**H|A)=N6r z>Hhp?!oBYcOr56%x{6cXMolIAD5ez}RkXKc(37?XPtvDglRY#Y>KM9&svCvMwJHt+ z8N1E|yNXjiQ?`zdy#G+h%GC7kiJy5i)!H`hjkTVuuNaKll+;&PWB57h?T zXppiAd7`fe|EHzlX3R~$z)>V}FeSS+l0x}I&$ ztcn*o4i?nDx1jVcE7_NJcP*CDAmu68WLw@iz=2UL-6I$%!3Vy`l+Yf<67Oi{n(m`>Or)da-=VRmMh_gHM2f!5ay&47oD>7(4MGzS3x<+=}he%z>w25CkH zd!`p7`&|NM{ZV_osK!!x*XDQ-70x)#_!VGy$CD@b2!`RxbckD8X3`Xy;dzyos?4+1GjkAGDQ@`)s8qNPwx}JscfND#rPOCd~~<69m5MBq>nRB0U$ut zO0=q)W6cp2t-@7k~&G6PnTaOpSrOH3^Z8axLyU^`@K5%+;alDMRiy9BcMB zA~hr<+`pF|iz5*o<4Mb4L_i8frT<(1dvnZq4Xy=$UXm1oTM)TzY9SC}(=Hkkw*xfr zsCu}UkSzImLHWlVzyPdk$8#Mk`z+cyIE#tPFuai%p2ZbywBY zTc8mVvXK6jv}IC8!MX@JiH21W158pPV11;DA8w<94bb$lu%^{|5`*0fN-kvWWb}=~Zj(i0F_rg`MvqV6nTz#1*4c zar<$IG&`$9+%}M5MT_N>xkSTJ9OFu!6iIn=tWjcg(;jRTL1vEjgm%7 z$6zXw+HRb)ZQHhO+rF>SlWp5~wUS7-wmog5o`@`2;j!Z|qp=KOT+J-!o_S_FcQB?f zEwKNxAW3qpCJWCqhXUm8c24GxZnf=hBd478-qo-@Yzw>fYy(@u9`C*PerNrzytgZb z_W~owqyOAcrj&6pdO-#1Kp7iA1rx5xWYCLD=2(b4V-+(EOv+d-u!@P~nNJ%N%b=5S zu~Z8xK!{joZHOuu%dixjGqDUyVKx!tDS-K$!wMK8mTTZv!B_^J$i-{W2`W$(YycH7 zWW0v?ZG)K(g0^jQ{*b#^H;}e1-kW@ct) zW@ct)W@ct)W@hFIGxPud{r&Hqd;h=RJtrWi<0i3lVr#+W)ONNIu-U_Pqr-{Bt4EfZ zB~DZsXAyI1Co3pghViw`GLelhGs~WlWoB-e(T$D2z7ltkkpVlpr(suCoys}2wai<% zQAJx#J4jW~mPVFkBg_32JcFby%o0lB=$>0iuJ1BgZhh;Rnb(kU0atEUFjrSHe9xH; z6n&25Hj*SsGW}(peV!HRW(eB0ZO*AQ3V;70L6YRC$-X;Sgc*51i}}&1w*Rr*(6~Wy zlXA{E=bUrSIp>^n)&?aI>cvcz{xfrD{&VJc&(2kXv6UEP3V-!l1nP!_#6w4Ia5jo% zVI+&gD3r+vkh2*GfEWnHZOvdi2L>*M!Lj{%XEVrzwle{HE9XQYQ^+X9K$ZLK-VF8_ zgwKL-DFlu%Tp5H=+{zXS*W24D+zkQ+l4M5y|J<<7un5|=ZA@>Hz5kBbwv8lacV_SV zS2Q!;ryXnm*UN4GBhArh#9(G-X6A`lW@d)5#nPM^G2_skx%Uowu9=xZ%*;F_mU*PZ za-|Eu-~a!=H`X16Ho)o9V(lup0;*D`N|m%JndHPzXPZ4qY9zHA z4xeq?=KriQqqA)rNs6H9ItT&)CW*z40b`7A7V3GPeccHI^}1~BKP^a-WVcNg0Nv8+ zmVvj+@h{zG`(Ihgf9+f|x}!U~v)Wmwk!HQqUB7p|-<7V`-u2$kE@r)Ez4zu~W-sPQ zqieKgaCiNVbftSGy!U=2%(Qa<=gc`X2On-oP66IFK(s{=dQS~d1^J4Q4z>q~h!F7> zfcK^a^rI0MdLkQ>dWa~1GAO`%6P*GGeJ5}v3Lqn%HmHFrr~++-H$6}TrviuweH*kx z1vEkhWH-d6-h|$!G~fzATgYY<;9ayCE+Zl$M}$towQXzKe09emR8E822=2DDNWG;R zQg`=lf6(1s>fVgd;68~004hrJ><&5{-QA#vaCA2)b}YYB*S*i6<*G{0`G;4M{ibKO|i*EMyyF47Kd&gv{;2ICpJv0gVBHH^LXp7x8sv!6}15<2J6MTs0Q>;gOTnIwoIcag7VfjzRlMTv3WCOF6c2CE)~l z1Jf&0N~L&AIAqMwRFR6rlVR29Rg`KcR&lr!CRATrf{G%fE7cqP)}EM~xP?ip$C`1s zrF@T>&x`pB_vZjJE^sAKC1TRMfE4Amfy)=ud4?rw6`@Eb%F%(O@m}EaWf|Y-s8OM8 z!JkzPusipLPmfC}pp{QCnsP`?3CpfgXLrUhF5f_jaQo`xbi(&J?!VT5YfYApxCDoc zuNwYORDn`no3MRBf))Y(YIqZ}K&h!s!^`pgU`IU;M1j&&oACLtp-=q}_@A`ZX8U>w zoiqd*N?UEhgtBGTsh^DyyOdY~Dr&V|0-5yOEWNxZ(6Stl`nm8>z)dBuVbQkYeQjoQ zUS0?t0!P0iSg7Q8oEiC=fNPbe<&@B4<8kcrtr`^Cg}=&t4qQ3d>ktBOrsas6 zcy6CM)JshLPZ{VI9^dc10(Clrt`T5im8PpEs@p4}#kI<%TJl7lV}l^>WGe7^5P>z= z9qKp1ZVY+_n5`FbD>d5^sW%cg6m1a!_rFg(HRa4N6MzZ?S|H>qj+QmK*A|S4p%lF1lCt0^|$pWH3i{QFQT;w{bOZMg{xU1&4Ned+rkp!J;b}0D?_^ z;swb;>^MposoM?o7QUYXt7imcK4xlsuF66@>ls3$CGVs%w$zcn6>T(`aEp*=`RCYE;JB0%=oipHv57Kg< z%lwl_QR;Bd@$}@u{q-`ThwG{!LMs^T8jjF6n0rU4X1>9!h9g?u=+xKHOUbo!^j&3C zRfd4tvHe#Ivg@Q6<3&U~$C5mTEag~~pIqIc;a4m7|E1Rg;BS4l^v3)yaag&gqJg33XbLnX#~OVOM@$NPoJ*44r!^O0*v z=IWvmo=}H7^NFOCr{U}hOsT?gRXDT;BdcKL8bn;gkQoS=K;A{&=exr7-2c8;Nq9zO$011k{w*5-u;%Gaw9d+$9RUY;1Qne-W z9oW{`js{>XOZb%|nJ-0YRU-3c9ex8q#C5jy4BR!ufZDnTZVf4JgdG;9kkNo_&9uXm zm0Guf0l75X&fQnsh;oFbICIg88PWA#RIFsAvDpfku|f`=ba3?;kV7MaZJF8-PV|>d zISTK3f5z}G*1gv3Vy&T?tEtv1in)Sp3>38}XJ#BG`ilKl(5vdOK$7DEnRA!6?JL)t z^E~&*bK!w?`lPu#2Rto@dyHS}H#*bA;{=JvOY*%Cq|>mD%Fzu2uQES5uRsbBmEe4Q zplq7b=_6|0`PPa|It~`}-G0@=llzqZZbH&d?&I1H?W*#?V-xD=N!3uw_*NyH)izpU zDQO4>WNi_ZnnalE?y-Syd2bDuw)yHFVF+P}AO^GcVDQn_!(T2A^6WUZFiWawrW8HAS3 zq|u%iCupYBG;v*t(UsN*nedh%HF~@(_ls2;Li&zDc)1-4(%pt|swp=OT$g8fl?V-p z(WW?a1M)W)XCe_Z#b|0{1ZPa7Y8o7coe~L~Rh|PUyd!z<2g9Y~laUyfYN6cLG&q(7 zXu2OlFrbbOg^=RRnKXR|VY)eF8XSlE8^FAQD3S%w<_{Tl$-DvyV98YHsI zy_n6lt_i9@IK2kJb*lX4fG$?l!Nv#65M3v%#I72Uk&^fvX-L-u&lON?uz=8_p`;~5 zuwYLzAK7ZcpZ3S7mEj_g10(?$1SaF=hT~Na+!(j6W8Y8*<$*5XTFY#7Yqd&KKM|WY zLKMs(15NBtHA{t4mJ8TlISmYCqa{UA60`4Z-a&clacqp77~J7 z&yzFM(Xc6z>u9~lQqnx$p_+Xqco68+LJl|jZ6R_nK8az+gSkBjsn_VY1Wyqt+mZxQ z9Q(V}m^hBpd&zkxGFF!#QGK(4iN9N1V0C}qD&JT9%_@ut-G(-FoPWlyWf^EY1Hv}8 z98wa=97>K1|L~zGV+_W$k;b|+;j2bGKqictBJgnNfgBT#?7h}6xVo*>JA*n>LT-YaMnj1lojz=A@N{j_KYK3(L z1+#(xkVhu+ggM<}O0vp$!-vWP=hzuS6MG?U3u<+UVl#xb0e4z+!s@lz?jKWxb$I|XQMw04qYj;f&MJtzAlGvC1PMU8Z%IF;meh7S69Rck z{5hc)D~T>fOC2NKKnj5Yw*zwRv9Cdj(Fy3&lOkfevB$=Tg7plOKQfm)@>H(j!Y3`Y}J<$!KgOE zG@A&wphvw{fy~8_?MR`FZatFPO1q7HqN8W1m@GB^8R&z+VBKd4BShib`Su;|p|HLp z4gP_Ud9LP@dm~Ir(&KXS;1C^>(n|pHD}(;f2$aJlVHyM$dUV#61;fbUl<=o#M1Kf9 ziK*omGznlX$E}|b_;`M-|E(CLhOcymhIybOhJ~Piwjx0;WdOxJtYK) zWlw#2wSn_Pc@@V~8%jxySH{it9ssr}UgNO8ufJQ|W~?DIBH;FIWsUeFfQn|H4ZMaDq@3V#be zZXtuLPV1zO4oN1XE`BU@KZJ{ZV@*5^Efw7$_sjVcxg2%g5 z_d6OFL3y!+%uD;<>v>DGU<{M7oMNgqj!TEu?Np~Dab$#UPm_$)QXzHVwdq0D!__Nhc!kF8^qmfKbu z+&3QWPsg2FU-ru;<$D!V5;nwfI24JUuD0>KruPftgA8vIj|XynH$OuujWnw7w^`;f zHJMe=O~53RWx#|E9U zMkRod8(VbEM&YJf1LF=z6P&N#J{gU~Jw08Ur59+Is&UFLdLKXtLFtdIDb$&^>2NQ> zJ4oYl;lC7<;1*aqU2XI8{Ij>#V}1`k`T z^ABmH8TmHLnS`b=dL*MT^92yMu_?j>l6LgU*4k7ags(UcDL{-LvF<#Gv=f4WnR}X@ zE>H|Varszar8E+c|7SzLTlMI2Xxm)JLZ&z~=yY-#Hi6Ac(_6p>`Id8C!&*(@)g>@v zP#RA3bDNd060|R}-)2~lm3(n#gqI5MAaf{zE_EtJF9sdv3q;zc?fHd-z~w_^=Ovf8 zXVhP2?6t!9Cm?wbd@~WV>j3}b#q&lOqYiDOYCt{7V3S|)e+9FUKP!`5??DfCLh%Lo zuJGqwkB8KFCc9za(|_CZLuVDkP$BG)tcyE9D!jC_RK;HlRI&fgQ%+K9c?VSk>PglG zw{NR=u*>=qwt0$J0j>9K7%&DQYjjvMmK?bq`keo}o;6=xa=fs8N)UeGKhMmChM*47A76n92M z(i?pUXV59HTha4FWi5m4h|Y5;{B^}2QLUL`au=={zSP6{yT!Gz+Yr(xin1Gr)*L@K z?!df;5V5Hi{=%xOb#XYlq0STYx?PxcO)%%%OD*12*icGBt8?tK?s7yZaP_eb2h!kJ zFN{?|{~Igpcgldzlj}CJi>nMhBQ9=PxLych@-9aewo!H#ve*s>1~Va|J;Ow}CC2Oi zxpoC}H3v2da2p=3+8Nz(Frfeu{*6XxC_ucc3H#PMX(H2AgpLbHbjDHDW7HLrNrB|G z;#1#1MsSK}Co44II)@>iZ|B>$*VF;zsb?#QGOXdgJB$#81^E`4V!!`Lp#+BX_(Z+p z7EC}tXIYPVjT;{!v$=$O#oT0%L<{h%(_IhFUwYbgkVr2x*bwy2OtL- za~LFA9NI@OR@m`}TZW9}@=_mliCrQMouAsJJHl?rdQ7pl$(lmRg})9Ebw#rBWZn@5 zA*stF$msSU912TDGqN(AlkWEiO8VqFQjDHZ@i=;WK9MC4ed66QT3_qO7GKKSu1Q81 zL-;e%#J2#qpU;nHyK}W)A_kxgx8nUQm3Ja=Yaox1@`R<`Vg{aPK)K)F)+#Cc`)9$T zsYNgu!=Qa5`h*zQO^u4yP`~dwZ$?7z!*FsqM6eaxbqDjtNO7v=9qm0&GA}~%L+Pc) zs?ydHz?lnk!{BHPZIL?MiqrP>Wp%Z}@|z%wQL>~pr*j;89w8?umn>*q1#(s6)PS~Y z6{Fe-Qp8czx|u)52BBQ%?Aayn-u%lcQ}@AD;d*US^#|H{Y~lMC)oc_^p=ADhZk@US ztGcb>eTs6{)BfHAW7tUEaH^(YB%8=iz!*_x@kflTN<%;;=3s!n@pQwTA?lYmw?y23E&Qk;ytg86R!i(+vJ7FaR(DFo4Mz#YW5tdo&vv z*o1x$fdIJqLh9iV;Nwo!(^BYh`^oOSsa%qa?F}IiqV!GJ5d+a!(JX>L?47UyewOK4 z*FcuWWT5VC%6Z(rp4_kcsRm#$N^=IH)j+*LO=xC+#3&pl0lco{y{a*jYTeT&eGxXO zH<-tFxY0L|MRvKbgcbA(eTZ;;C6#&b9+U9Q|4e3!@3C17@# zs>aFb){T1H86~~gj=_m%$K*t^i|rZjjtsOi>}dv@)Et#@-P0WLczxbr-o0DLtoC)I zQ^**@Esf_@Q;deDTg>vU8=Z48UbMkgB8)_Noye+RcOS&eEh!@7L~~0dTz9XR*Oe?} zg~21p(T*5g(hyRGo8jg@-IhR3r^2YYCI2=J&Rm`9mQc*i^I>zJX7nhuFEb90j#PCZ zuIoGMKfd$|EOH}e?kLG%$22y>Sd}o17c?D+>-shy>I9OrSraY*dwFhiwnbqy-Xu=c zjSsFs*$3g@XNH&n2Mar8sU5$CWbXY$G9J%sU_-bT&D{HM4dzsX19hpXEfGJHV7GxM z(=mxnqT@7k@2kf9AFqw{(nu9IO zB3=)r=6&S0C&q;;(TXXJCGH;QYiyTxM^ymb?1ugTv(%KFW=WZ>q57|^LAH@{(xE|0 zxYCX*ZJ6hb%u`zWF(q}MguJzkUdIhzOcOfO_vqn2_uUTsH$ib+{;zw&HpjUAU!TPt zW*En}ju2)T*SFrWO)#!+T_#MbGGx>dcGw-soaL@scx~v4WRf!PfExg?bZVyWrfUL0 zT(4-NRj=T0{TQ86U&Sj_yrucL+7YdKz^WhSOP|Jm75Cs;v!bTeSFm5necI(`>ZZy8 zdwA8uyyj`NT-mLqVgbq`A4yvJ@?wDWu)e&SI8V(Ka%1o>Y#p2j4wWS24v`tKwGJ>?}D@q7LK{-(Solwrk~{*tsRPu8GZJBlpGj z8@{s1kLgt+HL!qWWvLycOTZSR#C>X}dTsku6nM-nQlmAyP zT-{g{>W^3!raQOE|H@OV?>Q&evh>m+Gj}UYvmdgen$AN4`M2pJlzEAEQ#;bOxcgg2#rg&S*AgLYMW+Kyu{C1rY%YW8kDu>q6Tpx z>5n`gc0&zS+&)Cal@s+$x3xAft?5RfXckJvQIpW zk%d!4bV{w__t!&gb)KLzZ8_|EFYZ8Po&URE#+IKnZJ%@Ow3gKL1?w6`zuOZh)$eMj z8T79!tOJW~OvvI|ABB7ll4!GXCDOKG?wRYM>GCa86`0QYUDT@ujVTSM_H$P||i zNLh*u!i^YD&BSml+}!rlyKi^OjNez>CH&&lAjJ%}ZuCfO3T)jdO;JZxCg)@uRkDUk z-XN8&{a>{;tgTv(=F(v6MrrDH;-uP+C5?rvoi=S`4W*1L9XTm!DDAnzj(xFao-;6y zY3N7QzNZ+WQwsO3J@9{f4k7BJ0IEi|*@#fKfICXW`r?H#Z&10d+WFI>2FjcZ3ttuE z)}R!xP$*^`FATGQ z;Jh5!s0W5P`|g!{>I7&00o_N9ELrL?Y80+MBs=pSLmg<=-8ZW0g=fwXZSsHp?=}H~ z*0ji{sf{8Edl+HkX#oezAo1b&)VK}-2H)yPvU9`|i=*bk_uc!I-Fe%;5EJ#x!pjyw zdx|+4pUZ2abdWLa=R;B0-R?XoT9M52x@mfaM-bBB8sY#zS3+Pu^mLTC{T0RUc|pE{ zkkyz$UJ|T3Mj7k8Zm4M7M3|^TlGJnp{kh#5cMCy&I0!YxXCDlFjv&TUGvN&L{H*#! zq?BNMSiISN^w<)m_&3XSYrL$*6;}ZzMT@2-TbmS;pNQ0v$lM*@ir9YI_->4u3xLif z+p;7oMku3I%1>h#c?U89m|)`OVz_Ycw4RKGs5MhXka>w{ zRwR1O$O!GO>M~*rtC@=G4?Cl7I^S`|#JZkh@>gc1kF5sZ>Ogn}yVV8LRSN{;*#psp)kK%Xs`AMf<&LX< zuPVLav4(}~cm$^7p+N)Mmdp+6|FJR39_McR!em`<900H?2_~$VA_GX*`h|=2)Ysvw z@}9tp4Ze8@-Il$qR?c+T^uDmkcwLI@hDRHgg?&KVxbKjjC3pP>cZ=~LMxmK=+)VhL zu^1u)kfs+{Y;DAoU)e((Vc`VMP{75QPHQq=*C)9IU&+EZCRjzf+hR-h7TZk}ZVPlz z>^i8}%1;&E7(9g@PtuEdq<5}t$>R-3j58hAMBG;*xd8(^ zBsO{r#%xOseG{tuPDjqv*7-jUKrl_ugELVqY!UztZF488z8nvJsx2oc*xOMKQ;Ce} zI=%1Q=279AMbnU^iZHD{Y^kGZ<`B#t70KP%``v4B0OFT86Q{`q3K2H@tIeERev_`? z{MoIJ0zDUf=Fd@zaSLE~yzVVsNQ(|BeyS2Egw7ylw-A9DpDgw0L>L zLws5TDOI+BI1>9qq_UfC;3>1OwbK@kPo#~_46;m7F;yXf)l*<#xG4i8QiEQJ2b99E8srTzupu~^x9hV=azty z9XX)z7Xc4ZgnaU6Sw>Jba6U>9WP!1`Mm(ugQ7hA1OUvlL_5P&s*ns#T%tgW`rsj#nQh)!x4kjy%WtlO$aJ7Sl>Ks&N}G zBRYt6Zm(+84;nORh;EFNvmnYyRdm}RHEMLXN3f==w6uY)FpVv6OyN_Msp|=&WR=Rv z3;C71m3p=aKCF;GTkVo~=l|xW!Uc2n8afoaG`b|$#t3xeN=A__oVJ9?aZBSD=jb-V z0ca0{`6C&HC(R{H0e8lRRYduHb+Mp`+S-d^qRyRbs37b0Bkh{Tvjuk6FZEuhqhW)B zf|_eikP<}uW%bTef<|T0r>WtZ+jnlnzb6RTUQ9*UggmAjx5oh(jNz}+%&fTuof5Xo zpD9Hf?+~WbxG74Dr5>@fCXSn0ahK>3E>ou64A2LGf&5n=P7$hZJlG)(SSn1(;B^qZ z$Wf)&Pr<}-rUEX3U2^0h0LRF51KO&YI*px){Q=)@j6f+{Qj{h09`qVaj9Y|1Jx8?> z4nW^VPItgZr{19zG(wM_hLWd z4l>5MJ%lcu?qdkt|INDh_%O<~u9gkG%yz~uA;tOn!H3tAj1 zvR2qoLTQ>Z7lh-LlPM5ocoo3HDV`XtULA0>lp)i}8*R78Olu3(JWcTt#t4*hk|LhN zfdNd$?npxt_iWH1joYJeWJ<`;`hzQo9?|lGkNa&WVI>nhcP{dY*?s5k_U6}gDk}!w zi%|(GT6AD1koME_t4LXYEsOw!H5+b!r^2=I455G;=c}Mb9TONZAMA<2S@$w<30a0G zHto8RgDgjzo}Dht_5A%axQHS4iyLmGk;GV1<$$9_VPcFx8C#OQr~?cJ20;F&#Q&f> zz2-wvGAUDX0CtW`^D$BN;~W!r&)Qvxi92^L!@(ByojdxUDhA(+rP)MG{p1{a_Jyw^ z*LOID$sU}D0dYf0&X9y(1xQOSU1=d=k{^90g8;p9a!sHXr8o|Gs3OPzh5%2U-ViX& z0!iL~ys`EV(TlEoDWZgm@bF_m^ zUIMK)hQ-dBV+3|@OdkImwTKlr2woJ|EUdEROZ11a?G{)$U5d$Y3t|wqum_*rCdL{l z+TEWCo;w%Ag1&QiJnHXOYFfX0U98)2T^&it6F)`x(2!s@ell$Ecv(*;V+4;UBJ#yH zjCiF(F~*I)wh4l2`xZgK`DppdK#5M*wRR7w=2qP-2bgkS9T0nK63U8+GFpnyV=bJq z<|dfD^Nse=hlS)WkHVa=;i1Al`X_1+BF>%5%!0micRubX*4ZWR?g;&FspH59Zq2x3 zkg~>4WE!^Tj*o&CJO+(e*;1JW-9~Ozoq^oI96sj|F|_?rQWmA;{b(4qlrNlLr~8b<{zq3TIQSFttH zZl!=!`BB+Kq+mYqA20Hohued!m3k7_2RT^$$5}vq1*1!HV~jvYwj`T75J4XXouYjV z!Z+y8yEfDi(Q;y-{9+QeWMa;pOZo_b!6wgxREfSMc4qE77lCZ<6Izz0qVzAl3+XC) z<)?&&joljX!oy@wtC=Bnjh|>#99X9joOTHwgU3rfop$LLJRUapiGY6H+m>RXj0i4F zl;+bjnCMiue>0-5)6?SCs`JBg_cdfaef!Mk@fXkFn0ovL!4rd3EA8OYX9|;d@#B9B zUKFdrhJfR~I)2c=OqBCjL9-ysIojG#LP3ES!~)QME7Nm*onjtJ{$hU$1b{rQ-h9Cr z_Rffwur=-3qLZ?Rvt||nM0FIR_PndebLU=FbLy+L_^ZVoumH#23yNdwc%+)S?_313 zxlg86DFVV;V{BY7eQgl(Vr$KV;5M@qHh!XUU`2T2`en&)tmokIY@uWDc(u-biV14U zM!3>}Ui=YJztIfLnp>138i0BXA7ZX%$7=wrjfbn&-gvMxHvpXC7$^2UDC1<2piSD> zsiy!@qLM5!zMI&pF~!!%u%817#m&ItWL1i4H!ll9)r|*{t_|Q=?6pFu9J73J^%NHL z8ae>%_s=%?gb~*J>rjpwnaEBciUkw(YeaBNvLte|*{E~pn1AXrfd0CbXM~D9cdoAU zJ5qu^u9vjIYQ~!vpk7lV&3MCy5c86+D#ui*VT_j))AyZ=K{ofvgsUD+Zsi9Gcqq(%`7&JpP;BbOVjd-NWG#TMeuk99fQZKb?#Fdp(u0yGYxAtV62-1f{E^pA%qc0 zf7N8EOcp3ywot$CIxtycwuNj?z-h2N5~aNY1C<4S$@*}s5sah1O!CCwA=bLXtM38U z`a^JEB_!%@E=w71B{W_jrww#DHFv--?+wan>sR@Bm<-M;W>N0lX1PIVtY|f(3eO6uDYtnfA0uC{$ zuNTy`@VK>u9)aDYFj;^bpj&#qPSBcGF+{0jy-tQ(1tXc7+~M>95EN1N&4>y(SP)cg z<`LUbuRATbeuQyG%hqG^l!=}Z#ssKF^^B=$SX>@wQvFD0m^vPv&DwY=1aqGhi?cuw z5j?c^=SRnxrLgf6jh5wb?`Akq1o7=gNIgol3SZMH%J21Dg=27tw-g|KDNn4x?h_zNea}DRtd5rB{md)}E0d zsfv}3eI-*QDS7C3Pt>|eLE|Sc6+GV1^F~L9YL=+I4el4QT4i~hMK;)oT&%gX>tHIX0)<|61g`>>2jZ(%H=wFgPh@%(VAFb5P5yzMAfrq z7R{+1qTKh?uNbX#*v>hq8AVN%if3EF+th0HWlNBR!!I}HNI(W0pm(SiY7cVBV0 zeRiAtKL^0%Ov`2$OpNB&a{y_}e6=spmwoBR`$ogb1Y{c5$$fcE;OkQ4W}_q$*&PZa zoJb{#@eok`GsB6gaIEPo4#2=-B8uLNAxu8{(D>Yv03H=wI=fY(o*A4@C-;r&lh^ev zWacDyfxy^6g%PU9MyW!gw}_bg)T*z@2jdAYPFRG?hR>dBxP? z1F~)%^E}sa{`L>t2ZX7bi(7=h=3EH&DA7|yz88&4F+N~WM{)xOc1kf3HMjW%h!^Dm zzyv%MWE7qPq;CJjS+mRfioy5X=2{g8an#u}=&J1G#<~9oe`7INzrnqnc7?G#9^`(p z_WsDZ_qEC{V#T~?e$&B8yUW~0Kj z&f}&qw|DD^N$_uFo=$eD-y+W&qITP?3o+mT7}wPpBIC!4Vv`CKpx2}P3OH+eq1-RZ z|J?iXYaP7US0Gds%QddU##17_5tpI-1wBU$h5kD<-Ymg5GhU4nyhVBMh~m6Ubrdpx z*9W#5cj}r003FI?*9ecq*FJQyt)a_$cJJYyYBRRawb zSv*lBb_bH={)gH;GzMiAlXKNfNYhFpH!gfgs#$iMNLk@S^YJRHtP)|ZC(X_ebf8iz z{RTCpTAYx#yHtMT2r)sS2I#8d?ouaBA=A)Rg9D)NX>aW`h->2=de#7l;JkI$StQ@S z{_8MfZJ^N>a<<-P8yQzix$0EP92zRehDypwX+yQ?rrX^8f~rOA>w1lsBj@TZG}b2M z?bh85(J`~Q1VC@aAe|(1P5wYSO@(zP*&F~EXuBD6@I}v`i*;Q=9@{JNs+Hs`~S6H(z z8QABv%u{OmF$MXMBzk8VzKI*Uj1fB1`)Eo>-#X{S{q%_~YBqCfm3Q*yOZ62j?mQYL zmq)6Z2rPRiW~)8Znhv^B7}bojG_)wxwz+@h+nt|#Ut~Vhn>x%b)<89COU|-wY|&Rd@6x2XN=HIUxa z{Q0PUnl3B&%S(3cs?qdwZpQ7+*R$`x4Z34M=~(kOH-x$wXqs;T4csx{bVb9bn}MhK z2G9QtKy7a9bVJB|W9LB#IhL`*K-B*DFn6kk6lt$cSyMt^M2gR`xfx z-7)Mu?jPx*|AZVWAxDqDM<(FNqXm?$3tAYbuC&1g%fW^eC}Z7p^DR{ zSCeUvNNLmLqD`|Vqc+{t#-Y^7Y5w6V3G|S>K6%w9SF|45@y3(4Nh1ZJta=iqPdk|c zS&m{+<<=^8j`018QASxMn>&2i_d_G;Myqa`Ks55Sxp*f-hc(3idfN{D>VR9PP5!3$ z0;xo33(?C6g_lhthQNG2`fL_|PCTLd+hza3`wB zH>OV;JQg0p6`n?2J)Nk!Pt`n)T0TQT=MmC&&Y_^@lSSc&Zl6aAm#uH$2su6#LTQYt z&nQQcclJ;!z${}-IDDv%&+9aPh|L#Irsq(fkAova7;2tX(~~=aIsK&$bC`8^IVqF2VGErsOD+=qU-X)tW6X;q4Vd06E97_ zSvisC3s<8=s^*)QT~*&HpNNOrj zb|@-Nkc4C{s4-{){r_py)Sq4Z~8kO03fHFDaRKO(97l#kIv^?X)Q5OVO8 z4V^HvQVnf&YDy=*KA~f+Ok)2q%3)%ZAwuvcrD(?|*S#zaH&+l31D}Jk+Ie|PCJBFC zNZy+L+CpLNk{TVW26`yf{P};A6MlqBV3p`9nt6RaR3!S%Uv2uzO~{Y;*W3Arw;d(d zZ(T4KzwOUDQX;pj8WH6%Fw0>2VyEE{XXtg?Y??ni6Nh~r>^-$n3vcbvfwkH?Bri<_ z{PiK3`(2|(;QAc2R`kLEZgfz}R_BT2Hfa9eh2*Z@ts?_K*%|QgU0^bPnmbb9}#@IDQrA4HNP2 z%bPqIDcPgtEYU&Idv+2}pik>Ubrl2VAQbe830J2Qbv~XNbr&=En0pct5)jcEt>m2heV; zlI9kw(6}_*pyTK2Z1UJa<7D_hhzdXONBLn*U!B93RRy7(?J7ich**=c6~7DQ00kfy zkThw0-wS_QT)u|TGUpgn@D`u$?p}`UWR_qNC*$ueDts?nZ(9S_%xhDuGm$MOt|f}^ z0BKv%4+g407zTAY1g3`f!;%V^>3H_qsurLYX7G~bM1}8Vu}HDOM0dnmKCvAjS0#}E zm0=mtXiS~+qI8A; zx>Ks>>3F?3TXnL(X~5rhB`W;=*{a5~4-rx!?L?Mg6IOakD8)HSooDXTi-_t#B*}9` zMXFs0vnS*b!n}jI=S#tG0l4=bsI-pjcMZ_fvQ?{Eg%*g4E{p`$3ah{k(hD$NM^IU1 z1O8=%l}T=A^*JQZ>4{S3OzW%t8qgJNi7vlEblGSC(DSmZRjoriM8pwF0st!wScfS0 zNGP3HbxJi_37~$6kn->WJSCPvOk}u=33(cvLk$9gy~H+jgNzZlMrAlJwwexaiiG1& z;eZk_H`H%&KxA3ATPRRDr5@ff#U6JyXTUWL2prc=jRu~~`(Ej&dUE58*(tPwUJ(Zn zSXTMrZTIk4u4Aauw1)IEQ|0Fd!UwWA6rs$Bz-PL*Ze6z~%$vJ&J=k%<*3CRD6p=WG z9+lBfY^6dK!8E^Vmg+yx)W@vmY{!9&h~75zvi0o9+#hJbRw;A1DPkTHI%+$GpH$-E zI$sYHrL~EErnS=akMzLcU<3eLErSy%!VN@`rnY<)J`nxrTeXb4OvYJ&kTRzqMt;u_ zP$qt$o-4v&oY#h(zqeYCVoy-Hh8srVx)r^y?k_k%6iC4}yvXXcoDvTnP#0e@C{?*3 zG~nrcs`YwJ>raiba4Kc7eei(<1<)3UK_%+`@4{T|jl}`>;VGhN>j8K0AA)EdqrZfi z3m57sstiL+XWY{+1w}`lKJ-dg3IotaFMUKffF63Khi0HuwD1XhTy#i1 zEimf*!ZlBizLIBOxMfJd57wj_Ctp|pvjz9w3W6p7H#!MpH#+1c4w;S!-wTO43aftI zliNVLo|YZHB=*0;QcVs~`?}F4*7f*zn6;spyR^6GmiSe|uk)$xa4@}G=Z7MB#NZYk zG`B>i*wtgjqP}^M3#otZlV%BOF^V%mqk(ayKUDr#gdl!&vfAh7HM54;6VK1w-nbJ< z57r*Zt?QmW`Dixb4UG}!j3_=TlfHzO3E2_$&KKYwqh zH~}}+ZirtHp#ycPAT!Z<8S13IL)ISeEJiTluG;SgudN6XGR3h$^|qc}6Ki3 znYK<*w{4d~Jl(Q1yuFu!?eH$Sr<2G#$zAOHJzLj5z%}v*>&2G{`k4#|YXP4@JRDh`Ua^( zUFY+Y2lw}DayQ4F0p6@bd#5sw1yvMCSxG3Z(Bc}Ku8XpCzk8nJ^`bg-bZ+M>b7jB= z&J6gUJp(E-pezfDvtV)-6y`u~HjtVNB;*3a^B}4KR?P>*|L+OYUc%%8;JzJ3?pb;l z47sypEwp{*edGcddFzoF_xTN{8HpQ>rdd70kQ;z+C*T4dvvdM(8-rS;n(frZ@}>WF znk4^El5H67gbY788JXU-gHRzQV*S z$K16`4+Xo{g-3U~)fMF>%Ca^~I5`n`k4rgwGA}y`FXRKmvX`y$)-3H0PWvp}98XWS zt*gvg3)ZJ@D$Fi9@=|7V7T)9f&I+}%<6@fb@_m7cSC6S<=M!W*b%a-RcF+3Nm34{S zGOf$9%wZDn9vA)4tEq_TN;-mM{`+>*4Rvkl(r%gSvpn;d0=(yye38t>Oi|JsO2h)P zeTBJHd$dg(vLf@D2E6Cx-SeN{uBZ!R{;dg;3|G}<+NC4B+Lx`on=2Rl_12 zIv%^OEUGpu#k|l6Esa9Hs5Gn8iaypsHe|0Zil#z=ksIsLK}sik9YxSww2&nkg1muZ zg?(5XeaHIUAmtG2(hl1dB5!1nVBiLt6*)ETonB@>jX1B$)3v`woTWg`=cdZn^f4XTD z=Z+>7_yw8-n-V*m(vre^)0xU-9yIv>4zWAKJ@mlPrWB3wbbF5f)knr zmt4rDz>^e0;j~-f*z)0AzJ3A8xd_6^lQa3|oA&_GH{X17@}wYqlzgB*pF1quPKBEe zhYDzx@=8((b6m)bwAgIMHzrm*?9ZiY^BE)!6lIX|wW*x{a4~j&+-w%pMySB?l@~WK zSHY$mlIk{BI7+~dMP#{%^b05|BFS7qU#u`q zC$4~`xMP|XFE%Gc)ibEIA0>{DeBf9KJEmNuHx%QRXH3?5=;;Xgrgw;UIPR|C~sl!_DxR2`4?&lClCPX&?JPyvB_=s}>MFc9b-_$X)>1p3Sg0_~fC zK*H%D5TSE+i@GTA2MlL|P(9Ib*lHqH>!8q0p9O_Wu%z z!f>IB`R?v@rZ&rND2!xya+oC50y9dXWrXh>l%|R`3x=#{^gVzd4+u1>}qv!ndKj-3;!7sCM_PY@1Ee}_MK{VMj5XK)G(_l8>N zok+11py2&)6hs+P`Yb;ZH9TNG#GHrWL*aUMMJHTCIJ~t>x-jowC{OV70~f5`rAfBs za}Y=Ffdf|c4f=;yc+ipd^b(%AJ9$nGWZN@YTwSqBC6bM zW-gERT-26V=(iNw2KP5dDa^3SNX2L4yrX^Vb5q7?BPZzxItJw@}0LJ zLTfVpUSx`rBPQDk?huHzgYry`WJ@%aIaD}{zqoR2-fCF2A|Y`1c;^7z^c!_VEE zy|}uLZQ8}BP#+!|;17F-ar8s`|(+}F==53$U}uV&f)>@1jWa@~~RTkwWw zy2SEXvGTFv{I=GMaHU9k$k2@tErO5*`Z}BM!MN@a&Dbcu!cpitawcfx-|yTAZ#6ue zO?Eo8h|tiVq8*BXCA0?RAGilVuT<&Z+*22X_ zL)X&lJb;bu1>?*2JgDmKy20_9(VR}15U7JQw zW>`~D|7&vDa&SewS{yObfNsIWkM}8r1%r#Ef^bva$&8g23w^hiTF8TW+4M@2>BSiX zg&m4dg^qM)@t;hw_qjO}K8|~-j?K?$*<47>3}4_6Ghlgb%%T3HOY_aI^#{l|J)HKu zCFxrcl>W$R%1jPKgWLO0c;d%sgTDJ#8=wn+iRjuR{f0)8vnU?5EpZd)%_~n&VT>e0 zIip`C-<^++=r2KbY>S`P*HeKTJwPxZUFmCN*;p`E2-)~>od{bI0T1gpx)jEWkL=UN zKEpNN!wbKnQF_lo0-7}j-DeJY3mARW=}QmAJf^ZUDagn&1e~OxT4vot& z+8=uqBjZ#ZQ{a5ldK&`748$z|AF=ucDr&*Oqw({{|ap!Td9Lb!v{Y>AN8T;XlP!k$C&CuTrt8A3{ zqbK_cix_pKUE5EGd-9CKU^yQkrhaG0v42J>`kp*sFFtL9EM<~{V?osTx_c|U{=fl| z-juh8Gn>zjR=_*eVrD^=;cMGtMGI~^hm)Ue4T07UTYBy1p=;ykYksv4Fsc~Z3)anW zH&r9V)wCiF#&!xL$k?`iwV3PD@yfL2ulF{dPB`mpYp3o{%rlRDeqI!!y<()2f2q9e zS`tcm(Jgkrh!7x@U{3Y&+BNc(=x{YC-s32le86qaXF~VTVyI>P9pT0dFU%XcR zOh+@5w9(x_vQ*C@!$Zx;#G|JdD5^C_3fG#idjq#APBBBRdL8~4FzsN~e*S4;tA}u5 zCzYj_*95su?Ec`WL7;4)L_$=wu>Ln==l8vhTKTPbm+L$|c z!#72jKHMLnm2$H@p7Sh<`jYdje_&+FK|{yAgU4S^82`*CKtp@oG$f>}s0d85={^o} z7NnoD@|eIlPaW}8u!^r?t{g_a4Fa=aJIGwHa=vW0u{WkfKG2);KJD}Nr?wLIL+z67 zp#AWG48%Z18YD|r6BEn7RGw~3UXqBf)XjUDWt z^{}%bbt3_I95Y*a-Wn@h6kBF&mF?-Vq>e&Bjp5(n3VPyMK2g|Fja#d^KtZz&o4{I+ z;U8SwvH6~QT4Rvor%bE;HK7Ki58kq3#EK57**V940U~E5SyF-&NaN z+L+A8M8y5Kn3=KW7!N|u2Ka#2Xk!CP%v)*BQUBH1i~*jK^T>~aaQqo?7dNah*>v|} z<&0>oC#}!YviOR<8tvd!U$tYGhtAy0Xcfg~YYz#}gA0&^RvJBSppa8h4s5*qhds$~ z4na8ClDnZ5FNWs{eHB;uKG*fnJkRJ2@p?O@6A~6rS>7sN=j_jhQGS-OOz3}Q9e`e~ zxI%>ui0+4!H+C8f(mWe>3wT4_RLdh=^>kYaeN1D-kXE~if{tvb&8*JVWA=!v_00Ee zbSYB}%3B_E9IaeU1z8(WXL`WsK^T3WK;I~=N}V`bo%fVrmg+Y1T z?u<+11INm>cMZTZ$VD6~Mms0pSdEWk&m0PuE=ZF~_8>N++Ba5W2W@{euL5_4a7AWJ zVzM(O#UC6SX{IH>*Q%TxHRQb2O3qK)w4n7tb1BmH#ICU(SejFFLaAyhp2A-TU6Xde zS#4x4SQbFi!a7!9@*lfEj?7XV~B5OsvL`I z8mt?+rr*~(Q0lkp*>Fs0Fk!rPB_5PSem!DopI2cTgAs+|8-n2&aCN{|pP4OD(%~E+ zXhno=GCaG0-c7zIB-kdoc+HV{{sVtQEidxN^>4Ka{ntZQQG>ix^|F~JHD4=4CK(zX zD6_25JNMC~@KcJerv7?p*g-hsIHQJ#9m|8YKMD~+@_9M=#i~EUVRDo=xLFc*0~`C< zuWm!KmM61(HUHf@G6l5qJ9kK+MOYPsaMKNIjcz!u`yK~;e7PrnbB_|iVcpA_B|7L(IeKkz5Rg#PJ8_BI}ry zCvW43P7|3_t~oKH5ir(}1IIAJw?J2k(`BP8eW!J#Rh7Q~Cco|mW8Al*beSO7neb8J zd=KtA$Z|B>e52b*Q86dCw#YhwGn7<*HFtaacWrJ7xu9z}Z zqftulA`&y`4MmfZBKHGj4{MUk=)rV73Lo{yJ6aN-*P3K@Bmi8Mda);{4$Yv3DF*(8-X82nzm(gh4kFe?&?2ZXu2o#Y>hm!&D1(0tKc`!MIH? ziR?br5~S~)os>MIQ;!!N0CbC0kX^bG$7EY9_3%hSATFDHjhpk3{s)D(2>E?KNKKHDwfta%oN)wiprC4M&&;` zFDMpiWEQ*AX1i?|cp^&|sg)bFA2<4Mokq2GB)QNupALuic=I0+Mn^iNMx+eCoN%_@W=f|*l(b5}0n;N>M zYz+?Y>AIBOnm)wMY&BeUc5XHbJROH$-{XvvopyyT^q(@7_{Lw3!9W26P zZ!+n-jaxiv+x%HpiP`IHW@ct$B5C)yFx$}pu7G;3csuzY=szEyJh4Z;i?TUHBdwj< zQ&v$ibRD2G{e3M5-#i~L z3_XuYIIY$cYe-X#wBM9>UO2|69V!!~qv=Tl{!X3uf$AV~vOzHz34iI00g+wU?psy2 z(O*p)Q9z3y7gwLIfi?*hX;o<3H7*j=n8c_{8zj;uQ|jEFNBtE7?|83db<4TLziW)k zulynr$NjV$VMf<{WDS7~XY$#R#C}Mmg~AbTFH0nFzR%m+Rz#bj)( z&%q=nFJ6=EzlxHSKSR-cE@V?&Q&QKMlN;Cs>P`z9b}A2rZrjI;a1OetxX)uv-Ba!R zY8^}JD;G7k^HXFLG!`gWyqS@2h**-fv!z@|SPQShHt0rep^h=)&d)~@O2x-HfAkXu z{%Pr$>~m7Pj=^3{`h4TsvVo8y=EOPP&IblK`MD<%&|lupFnGFer2AIAUI@aHn0=>X zZ&tJT^v!KT^KH$d6p;CiKTm&BN@IUKw32vuJPD+fY&Iy)@;+W_uFz(QgJjy)LHgp( z&d$h1JiaXza5|=1lxbHiRGA_@`aD10I4!rNaD7l;yE>S)())11DK-|pDL8haT~=>9 z{j<873lanOKJw6K`ox?*bgH08yoOqA<0@{>6%O;b#h%rD~Dn)dxqF!S# z#3yrv9<)DfTS1qY9}CF5&WoHAlj6?@_g4oZIdLZszoFR|mbJ}3SNqy!vWltUP4RJY zPg@KUc_W3%2Qw81?QX~IH%6}uM=X=LiG|>rnwkQuemp4pj88n`;vIp7XVDa6A6Mtu z-p(x!BC2j5xuv&TF@sfT8r`DLFczassl&87oQlwJVbm%=i&PzIHlP1>272x*Jv^Un zG_vLlv2<;`j?2&|!FBPXd^`IJQIFva`+FVSCenR`(rK<4Lf)uXq~*})>Ku=u8)qQn z(;qvKJm0`~?4f2U&e!U*kGP9q?`XD= zI>9TKHsHDc0g20eEHz)vmiR)eP+bNduZ4c1I`uSQbA2Ytj#K_8Ge$umB0p*u~1@v1e}J(_QYv61)TGoq#&@=b&QN$oFVOVD%rz^Erp{-Js6OX}Ey>N*i(4-@jU=T9e?UeB{$@j=;N`A@SVWw@+lH8psB&&B|b>>7Sn@9{1FonzvIKqr`#V zZmzBj-6v#E0&ZIMD`s>$@25Ee&Y}fYyf)<|?kCjz_caUK5^041un_;Zju&_uO8GCV z^Daw?y}8hUod?F=vYQX!9^_`pZOpUdBFD3BliY5$(jP9edKZl6w+6KB;i2>SLEo`? zn+14?8vu+vT2*EafV4ILMpbY<)2{MvKrO&^!KS1gz$uP$utrlocqC!AquvecElsf| z4^>(ZwZi~~Vn`cRd?9Y~Omsst;;uULC*Nxw0s?IY#yOqn zAD2Wd*F(C4*bd9u&CS>9SyX+uOQUH&ULiofH3ZGvGf*TO&^q+mf2n5FB)<7hOcaW5 zfIeg2U^;Pegf+LUPs=Go4F;7!efCpyjD$Romo7#{PT~XqL7?y#U%#Nhy|rVT&B=R6 ze`V6P{^v9^{9iB{g*7k9%tAs!LU3@f05D5``AnDnoZde$x@jp=N}~w;cSdOJ$5q6h z>pI8;WaHP;$WqRC+i8>@bEb_eJ_nCCtARTiR;ns0kF$Y~gh4*-E7rXI!E<}=<@MPY zKwl!^iCundT^8R?)(il~VO)`+tQRki~pBUB%W@Y-Qd8S{Q`vpIf9aejEq3KZHMod!j$_+CLgV|#6`xKR@t;1 zrN8_3U$S2fD7*R zI5Eb=8K}cn_}L{r^sx+0+G{dekdQf|9=v_jdfepgMMd^Qe#&RG99thy`znW@%Fisd?M%VMB zhiH`kCIT4BmCxgDLA((FtK;M2bZG`au!Md8nrYp*IBlCEYOPqBmzO6PM+|WxE3pyg zW>^@gSmZEKYB^6|;C%vR_V%1!{hTWrjZKMO#dn;BqK0h9G*LMIQtK}IN@ zcxSeGiYVlWXOT7*L~BHS6LrOb_{Vd%@Ez$Np;;ahmRW3N+b^#FX;!?(N}rTBL#~P` z<2%r{a%m^Gl_)=Nj^0uFQeCQ$V@XZe`-;Dh$6>2EBa^K4=J>&= z<}yX&of>snM+lCnr7L>86sgkYlsy-XwPzX)k2&5X-z!;lU?>7EvO2FSoL*89Jlk#b zl^mHAGrh_b6*`6QVRhNB4j*@SUi1(gQvPhe^8xUIZM~wFMFrh6xZQ}7oV-H23<813 z$jBs*$nn1FI|DkJ8^BGV=T?!>y=4c_0`; z@2#4!t^-%_suVEh6GbMUSM}l+d=KUd$KD4Zt-D()vreHKhj}eFpK+*0dG4`*S7NzfR79SU@6=iM#Myy!z=vc z+Pq}X4~Ti1a(^X1y;SvNzxeNdrvD~$t#RPl7c%tW$h>!$J+Z><5f@>l_ zjj{=bPB5QZ)N_C9j`(3eCt9rM?R>nh|AFDSB1q@ zfT&v`L`(ERK>Vrp`Q8X(uL-I$z_N4C^m_flPB-tr*>Hp^-om&e*^Gq@L3$<yZ46sU?ipzw;6)A!jC&!dH!O2Jiu;;|C8jC9u%*iTQa{ z7ttNRL@+e$1k4L~*LdM78YQ}u@HEEo4If!NC;q#wGw-P=bXYE<_CyDzN3kWF%2~!z&ZNjO$nKV;*BH1Tu zy9|V+@$m&jvWoBx>?74-A>o`+ASDaJ-@JKa9Zm$z*_tQiu2z8f=k8{yk_6;jdUMv6|- zE!;5#cpQK@%+?#8oe#@BU$Dl+ZU927jC#n{xWvuJhqCsS0h*qf+49n7M}^7BJJJE! zAqf|vYKdXu3%`Gd&18ztQa+tV^Z}Ug`;A&m{w@G_{TJDB!7-jS(M$ZD>R0w|#HdXNh< zB#4YeonWFdiS}#qqh5NepkJst(s$f>&{U+fFQrwHT(mZ#U8YT1o*bT`@v20-QVB8 zK@(4z?K=l^5OFOqAuU)GAitP=LrCWFJ8po06(2iW3QXTsbV%l=tm4XPu9xXEc|&W3 z9k90SyJ~3s3=?o_JM#nvKtqxI^I!E8#XlFK`AD!i^Wq{~0WIOk8^^x@w`K|?{ zb^P1r_yw-Fy*uA-Tn%{mq+|H`e1PEwP<$?b{(Jf4`e^ZmjqBA~RshZmz~!Y|myMd7 z*F#XSj$2PU)B^9PL_7{TVXTHNm*usiK3fTL;%8sg{;i=&Gyw{Oki*DtQh@=3x?i!# zGfhMMvGutbaoOt4oto&L+?)m@*Wk~JP5AAwmX9m%V5a3zee0%}G4pJ=k^e?C<{P^4WV{;5lBCF#>kBZVDP!Z?&KAEu1V$`7DiC{%)A#Oj zR04Cve{jC6M0Z>`^d#@UM%_OW_Fq>?djF=f<=0=V=sW(-z`-3R zC)ZIs&en#Oe(HT=#LclapUN;h_dQU0to^S0N`G@^y7N(w9#+0V`0q+?Oz0$$z|9K; zRDiE=lC)6(t=IlJfRXB({4KVq4QW@H1;&p(OCUB!l$DWCZhf6peY_^=dWaUATngac z0NHgfO(@*R){G@-FPyM`ufF9?QBPP@;`pljyWt~X4rK$121qDa4!Y^tily&%PJ#3w z`tP*YD%<75`Yj7MRs41>R0^NW<@c)`RV#OQ_lbO2+KztD5BjN!bmAAHG!iuab*d$r z%qi9i`i}E87Jwd1FZ~^v|HF%#d=5}L71{;KkRk%QnnM?LK9blM30;_^S~HVqm}@~y zegvFhY@7?JB+NgLiY`R|qmh*h#Kw#*-|7u%><4^gz0`zRX}jgw*+xJD0by%dJ3v%m zW$W^)=J+4+P|M@;a7@?w)bh;rprA(I&NZ<)y(9v13W~`E z%xXNwlW~f_U99JpLsr_`x~j-8DO&Q;1MCbkJWc6RSd$k8T~PDKv3{A>z2fKev54>pMEcYaG7drzn2G zZTjJx1%<|KHffjT0D>2oI{@=iWE#8J4P`01zrQ#5eT}lr*IKfsZje8Rmr2wkQGoci}rtFS~z)tZ?naG6@ z*&*+_G~17M0Wc5$U%rp7fcrG5=$uf9L1#|DCS6MC=K`5M`0SHEnk5h)gL0li;GRMI z_2eN(HG*3yQnP=T5i!jhnj{ivViF|E@m}~+2eUn8$ilVbBWp^fYSi7|gU`&CUCJk- zn8v?dmiFBH?KBO3Z@cO-@d*hjB%mec0?rkI36t=0Be;Tfi19hY@%4g`tl=Jg-iP2n z6&lQdUq%y1IU+Go6XWBczLkdSWosKni}9*Gxu&Xz%!umXKNnpP(4~OH1ddtbKrylE z28YE4pDWv_A!E3R-bw@KL>?jUt?=;P0J=`$kSpEVH`O-aK|iTYgd zk$?MN8nAg)^-mn|*)ysAoTJubq%H4{EGBzpMi({q_OHxjqWSlk7C`O{ZF6F`+RhO9 z$PM-akniPYZ*LFuvfIk+tegn-jja0R&-&tcH4I+&f4@_a5G zNF+r>+Ru5k8h(`USC-R%NJSuxg>`jx4KU;?+oW6N`d?!JF#1%V$(a-ueMIj*81RL3-iIPxBI0QvItTR$;aGeAp7_$QBE)-~y3aidBmuLDDt zw?a5s!o)NqE|L07CZF$^eFO^`XU{)2y$%u8e|4vQu zxx2twMcSzSp9Y%(3*yHWM!PJ!U9Yywv}KVzGHaG= zVn+MZp?2A)vgsJE9MzJv+sI8!A$(-1gp6S!hAAj7eFoTE@1a9Yfmcl+JI^zrSKu4zF`?Qy65+^;CP>dg33Ig ztCkh(Uw;w;1Xxj(cqUs7&c{B_N%+a^!(LJ!1ecd>o+K~z4>|CtKip4Fc*VMv-|@nZWgP`;QKsjf!D@=oucNJz@)OT zw%IgS_}a&bWUe_ZsHP|ilNA!b$z^+`YFx_?rYO?guO+Km$K+kw*s8oRqip2TaLLoKc*rMo!hC8-`W{JZI|@p|U_<&>^0{zrF+Z!(X#<=LS5mx`7PL9?5XibU1zoMt3wR$5=}x z9R$Z}SxCG+PvafA2K#TUOX-&2Qf3zH-X0^C{M_FvfBgD;>|-{Yz!j4yvtr?*9K*dE z8pSj8UzFnNNFTx0T}E8;8p$5=9EI_ccDr*?HE6=pm%|Z-IX4See{!wy>Kc3Ki*T=e zZxMFse((8OM-WOa=7$bO%TZXZ-jw>%7{)3xG0)}&Sp2C?rKkobIdivf=hDi_ms%M~ zX>wuaF|de?w`DkD43~0^;Mk&K-v>qG_XwgGG)UwlBmz%yO;fzp@LG+vyF@Hl^LFT? ze+1iZ79XqI%93z1#ESk=Pc8zV_l-L!4 zJmyfTBG9vY7jx_ZOaD^jjC|LRSwi&XZU9=uQao=ziD%xDC?ywC85yabOHL>#>V!(G!(mw2{;5$5yhu7-RPxG#p0b5fk3un~ud5r!M0vK#YvmYP=R=r`7Ay(f2bqW4R$wfl1F)+36lR-8VK+j@n6 z8Zye&p@`gU2+DMHczR@G8QT?69?XP){eoqV9^+UFpBFTI6@t-?j1(HI-LLW%IppVv zkJ!O)&n+m+7PbO3q=E556J4sPVC$jaFVCP|NkIPJZI9>)U=}CWOm4MXI0==DcmgXd^>=XC1Af$_ezrJ7JD1en^u3a-0RCT>zU3B4q;vdQ#;%3U$YDtWpFCtN88)V6S&Qsv3(k;z|BU#ln|ssROx{ zZF~1wI;2zAJ-n3qXzuUVT=ck8IdomkKVt51q~{b5{MF(Xt7v^kSyk0>iUNP%0qzDX ztEo+Oq1he93akJk=;>R{r_2${S8?BWnfbUl3MsvJizv!xs1!e!yP*euM;XkZ|yQ3q@X|NO`|DEfV~#&rHtuQ(1i_v)L(_=eX`-)ZZ>w_wn|9 zpERN{)C2_4utJ@QD5p4^+)OfHf)ph~PxB>jSqT#1n9?NS8OesQ3xh8m!17J)cB8;6 zA-HR}4nS}LCiDn+7H)tPPHKK}N|6zmIsk`!&;5rGrusU-WZ!ZaDU;nitUh;ib_ULr z>uC%osS1BZEd+Q66*{nXCe@-I9Q%``zc42=)0RIAFo~RRDtg^g@x|C_Ch@~ov{{l> zjU!tLrM@42Ctn^xaDJV)%okp5=pQLIc0s2B@!%&hJ1_~vQ4^n^G$~Rv9_E}GzGtRC z+JesNP>Ku7iDdb`bCR$Q`!Yy`^_b{HXQxlpb@OcpWRll~sOvPEpfo0UFg<;LI>WY^ z;@UZ)Co-Czn@V$_B#(~8$+=Hu5)&*-*0j@@&nSxJN z7NfbK%^w}<)bJ99{T;yq#F;?C87D;3`vxLXQT|7C3A&-<$^6G(;zYU-S`aO195YyFf*2`e*68$}^Cx$*->=`q ziA%{c5M{_yj}*cW<+MliRL$Jr{tE=>;HTiph0l0An+^+?Td-KtF(G(1U}6DeoW#WA z;i&P248K?rz$T63mr|v3H;Q8EOL@|LQUPG|h*mE?GGGQ7J?`sp7&LvuR2@LNeQ`2? zN>$Od%1agO<*P5jrIqpAanr8GbQSC52LTEifNV0Kc$ZwcAhQ5+xpgD0^-ZxSX!5dL zU8VLnB=?IL#WwNy3_kHN6nG1sj|uf91MQ3@q{U+?%>FG z$G-Hl6(|?dcCYRc!=>~zzAGaFYq2)pi1d}f`e1Tj@K5~UA_rIZGI(NjW`8i5c?6$s zH($y%fH&KVE5aJL`NDc%jF^|=6RiRu71f#5{@f*_gMZC3(9;9!AW|)cQrQZWj>6uk zdi^`=OVI#INLYmIg~{!A7jVtS*Dzi6vbAGdv)3nr;L37ny-(nqkM2-RVzV9DDnN!JJ@)pIdxltrvTAM>7X01t zX;&?1-oFwaNfq0S;pyS@dvVBsLP7h9|49L&Z~o8xu2f5tG)20fhIDrynwg~0S8p1f zR#gL0zSkeS3v2DEiv|xcZH58Mmb)v?En)n}{Ga-`QK_4Ch6izxcgBt&KP`mWmJjDt z+3Vx{{+0#o)@sw3evsGR06SM)xJ#G0t^*zoToPQZ7UZ+FA7B9lxtI&>C#@^Ta@TrU-^ZR}@P)VFF)6s+{9xXPG zW$;8WdjMp!R6qbl;YV15JU1iv&zG$k1i z@x)Ho_E<*6PJTUk`a5^KyZQa#(B+MHK^o0F|C{uBL7J0Elv6U2D$)`Mr^FjZ5VJQ^ z_p)H<`Em965vUFawG2T4TL6~+QcDI_2h5_Oq9$wbo==07vVrv^FJ;D6-;?&nWsk+h zmFtG}b<>|^`hax@=(Z~WnSdg8k{f)~|H#f*=@ARC{H;bZfwEX;FhD)vgDJZn? zOc4=0JkKUKh+Pxviv41F>O&WY<}j1xJhvSO_}BHMuZf7 z`L^E0RMN3u@jOds$|QUiRuCsjCXS{FOG2HojGg=S*D?+#6>^c31s};}=t8JlbO4Z% z*RdW9BeE6J(fSKi_$$E`xOjM)Z?F`{3t~3Rtf@Z}v9 zr1@4MQ@}OFy!2CZl}#oez3fT?vyfT00fszLJhAQ{VvvLVyZ58tewz24INjellm#?< zNv&?&of0F1$`G(1|A+$y%u=l0c4g0BfK+RnLa4r@DrR2*kP66gDeRv)CNXS!HRk5# z$UGI=j4;J`%8gdRxM+HHkZnD9E`+|Hd|#&X1ip*xm37>NtxFd)MkjI z+dr+21rH0t+vWW)h#-{*iLnCGO&~+>b>FvGDPeXd&lCo#dG8GcnIz{2x9~Rx(2C`5 z3l(m`%*@ScRW!}W&P&xgTCQeB)E}7mMC{4N)eL<+VjLE)Rvt0uT)eE3ZgX~{K1937KOu%zS)|fg z)6&K8Fs6^vbim`crbQS(f6tFZr_Iu%cXkx*)}sSTa5PEeFhp$|OD0~^I+elyjI(a1 z(jFm!IEmCMS_Fz+TM9k?lrbbFobN35i+hRXH`ED1i6-qi9#Q40gMv)23otK|jHH!p z*+13^?(k5tv$SAbUPp7R3|)}`o1Iv2drnc%h8@lOJOtbwxOP*qK&X8jveT4J7x77u zq&F?ZUOicwZ#$qnM-^wkZFwGb3rpT@y-Q=(HYh%|C%Sc+sZL~**g5@>xYTJnY|HuG z08`k8Su6oAtg^|{aqmQ!eKQCqHW_C=nhE1X;M83i8XoT9Zt}x_*}TXh>08rY$zV*0 z79(l2$r|i8{~9~&vGK`tX!m-8k+E9UV8dm>078OyKVO`fa~&(azqho7Xp@SP@;YW@ z@;d*{jk}*sq>?h4i`&e>aTYj=H~M#so|8wGAGDVLZ0_1&b(lIuhc!>DrFtpRgn zXef{U%^&rQV+l(iTPGpbPzyt`A0(d&HB3DyS8g-CODH=zxi|SH>>UHEnlHM`n^%4+ z6eP0Ff^SWY14+WBQU%xqq<(ZwvS#u4-e$WQ>2VBIEcOY>6lr*$$PzC5pS1rHdiF#5 zAsWBQ57Ab{7^(ddUL?a9z($Xg>eWWKe&2r7;!M&wg{7vz2z%a2o}9b zuxKN+&nNDUa{#bY6&Pw@{!0_LJy0&vRhuBZvZxp?<6ebV@9(w|e4@tw$VTb5zt@-T zMLQ|a{k z?df3<{U)KH5~ExJnV5(M$$)B*K{GvAR5*3vC}C*MoVY{h!~Ney)PInL1N)caL+6Qw zm0q(EU4)87U6IcV30{(j`8IQ4BMEI=`F%p$shsCv9&;7x)miQctug^cgri1GW-4X; zMprW2ubttBA&i=u5RX58Zd}%oHpmz?rds!`CzK%y0=FYln=oZrG!jk{(%jrSHZinz z9@@$w22+H#5Ma(67-xIuwN8?gfgt6Go1jLM8TZHY551h6mI%G+Cd-Rao^Gv1?#X?Y z${&elK6&woTAOxtmDgKxkgs^9*%AHDT@u@>q|`g1fX2n#@`RDjO|b}Gm+(6~-zvc> zXSO|b#156aU!5&d&}nlhrrhwBgoA&KT}Fj0PfK-GiK)f{TfwNMyiIst5A`_D95Hcf zqGEX9yYq;A!~CKL!)B>V=b9n$91#>GYw?p4sH&fN8%h=vtRY+X3Ol?zC<94W3~j@o z?F2V&ZUh5VW)D5;SRXb~@#GQ`Bx7D{ZH-mN%_$*EJ&8p(3QN8jo)Lz`gksQ_*DErm z5SQJUi@oe_j!0cN7=2yCN#YIF>~u7-tii#q^(b!G|MTPg+CCq7_&eoqOsb>EfJQPSx%uaj!7(tZxQ(@nS1EkJ45vrk1Lf@CflcCgZk^ zZ-s;X2zxOSY4;rH?lyG1KNOIC@~|iUl~SgcsH0?2P&cur%xtkCIKm@~U;sn-kR#~H zMhuS$ZT|WN*xG;ymSTbM#x%@yWgcUr6=8R!a0?48ol`}YTj*tyLTUuDLKrW5R9SWm z{+9XMWS%_Jtg3l??=T$;LX^oE9L9 zH~pv{)i`JokGT6s?GF{`obuGQf0biY3T-I*yKZ_}N6IZ8A46Tp(2BnQ`jx3n3qIh) zuA#-Tf;G3zF*>O^*koLaAs{&D$6jyh&pb>%Y?6DXGOrJ*il#0h%s8iHWoHFpL_*cA z-d3`dg!UqQIKih0Zb zq;~Phc8LqxR_}Hw)mmtRXbSxhJ^TH}$#2N+8xmsY!&Qz8gXyH}D6r)>6WAzq@&JW@ zVnzVLe01?D1%TTH*VtpZ;lL#A%91r^>cBV_yx7sw2}KKx+H9ZF*z~pcWuO4@r})nR z*e|@dHvkl~NOo=r^Ugu`%QgN38@P;W1^;I)KyQO1g_z&jdQ}y%F1nq|qJt-TE(UdZ zy*G5~)P~7oA*T!n#7h^^y!9Vi1QIfdh^&ky!uX+>Lj|Qg)(>SgsdU~c4Xv*s-~XcN zdQl|Ol9H3BtYmYtDy$}HnD5J$oDWZ(P67)8{%VORB#vYWQ2PFR{q{wjSwX$&-%t$} zTv!8pzmB+atJXx)ejKht^m`U%1w9Jv?2DG%mZ^EvyPO`S)of`CoF$ z(R(j^6-luj0JlFgMYcN+G8#z;3!_pip@vpbG22h+xQ@2K^b~ zePU=kUPmBnmepWEAT53hKV9ELr9m8xtg%hPW^kF8|M-F^OKmH!aqc^}J{ zX0DKmCTh0H&o46>M*WRGy}LW_A``7p1i6Ho`jkRN8*WkbreEniQ8p`#$sLs&gc16N zQzo4xn+Vd?1M}ifWwT?Rz9c>IDt>$t{8YqTN~`o+8>4J=vZYMx^TCtjax1Xbw0&%4 zbti^P5douI(D}f0VDNY2iYGLksP-+fFJg!uDeOG;UfZ``H4Zr#Uk)8Co%ZZwAofZ? z{e+-BjnaQWM2w7mPHS_%zxs86bWL%8j6z{Dez;@~p@Q7yx4uz=K9ABImek%<}FLAgdJ7E{XnUTbH?|0cZPOQn{6 zq{HXhRl{$DfA_|=3NWqg%#o>OR44v_G@WHsRQ=nwhYpDWiJ@Ck=>~zJk;Xv=kZzO? z>5#ffI}uE?;TR=Kg(q zg8#4Q&tLU>3+YQnKkZNYI(@aL(zFgu>@)4#=^1OuCj_!S1246p?JgoLjDnu3$(Tb; zX<`4uruL5!msPE9WaZ7xjdn3{$oey0^h|6&v%5xI{na=i7SkgaLTw*5&dDKT3(lhs zA^bo|rJHBP;29V#Hn?Cjglt|E_x1Kp@-0II`o43AIKRoepG!|UWSb6hq8@KI7Xq9m8E$ zQ2`EFk1#mT21wUd%|T!}2%Fj1Fv*#ikG-4L)lw=h@_goy3)Ot97HotODI@u_o@Y#U zYncf=y+uWA;q+8^#O3SF`{8j>Bn8WM#S*Te{ylsR7Jm()_@g&ISA|7vCYX>_&({FGYV zubm;4Edai<39Q{lCS4H1i1RxiL~26(r+j+*-Cg`i;K80o$bnW7n6}g}rlqFdpM*+y z16V(MUW@h3f8_~;&=TCoH0=Jx3Y~P#q6sSn)@qKkm^Hxnc1wV8;zIf^4*-wgtw||vV27|}B$7WD&WC0q%OKNz;(tMa z!_2ykka)TQ=&mSWmw42Pa+jOHUZaXBg;_Z}sWNh<#S>Y}zPMX_mE4j<3gRP=lBe<5 za?W_Vug-Y*q*TaFQBD3#JxRD9)>*ILwTJ7Rt za4;IkO5kTRjqi2F+p`}T*Z*bcz@>6n2CE{SegDE&LZl2JAunFMaHM?4N@n{1d3pWv zIf{#(?)Fe&n%~7mHZMj5StG|0_oAm_dbEA!&MqqT4=Q9iD zIk>t5-~tSM>d0&>fTJ-s?iA#027tX5iGAklQ|%DZ-?8-pN^A+5z_9!0Nd9UM1P5K$ zwvRP$`mWA^6`z1Lub{dIBqh0lS!SoHinLU;>8Onpj*5v4#!v`o*z_Iz_E;}uN=c7I zo4}(K0H!fMX%US!#rIgYb9Zx7g}+3NOWrPMcwbT%uioxd&kor5pdksSFI#8u8`;(N zm$Oac#m$*VzSrxO|Nd2R04J`B1Gu7lzgtwp6K~{F0{y-g$Hp2zUbxQ>#Bv!5X!n3)0zpQPhB0Sy%iT!qOh?^nR-Dgx3 z8+v`(Vo;7DwdTHbkE(}usYbg(^+Icx+dqW*O2lqKY?*xXV_?PhX5}l)EQK%>Lv#56 zFi2@O%%XATa!bN|ffHj@XKA%eC3J zOVxh)X#SXLP~Pzag<7h5P90l;acV5b!7YE1XBflDfmMY4(a|J zBbR+Y823vi*>Sz*4p-_@mcVR9Z6y@Hz zh!l&z<{*o@O{`E(X<0`T<9`qI@{n4qT7HFJ36reOs2E}&i=F%baEAH48alS~kkYT; zyRezoLmGc+lh`UOKzA(fR273LjJ+WB-uRhXqHp}$CV8ovm{s&&V+?4ncJX_N8`1X zwRm-}PHW(HgqECkR`aetbva!6KO9O>wjnn-CXyl^m(i15s^%h~muimct(>8~bY3}cd_FNWYME?w3R;pqrAakKQ z_@i>5k;w5SHCy8OT!^mTujEJ!qkdP%D^-dYp%;-1wdzC$q4lNR&D|ZZh)M`nn;wxZ zx}|H;yntvWqC}Y0R^1h$S)iFcMO{j&I$_X!5W3U#tlbe&_;7>NK#A82>+AC^n@X(SRiQyxfJ|SY90OEEqE`dCwgh^ekytbZOYV( z&4G1rujAZW-ZBm&GjidORC}In)63DJ#hzv@g84r}G~r+wv&ftGy@`Y$WzHYC0ZE+< zHJ~;LtO-j@w$@M*MtGCIriYlankVoexNvf+ID`@Y=PZG1V&iD^xgD6sqrxzoP9ZcX z>y=_~s&^j?|*qXEbv=-%o4Uc z@dZ)f<*|1UsX2~DX&BHBQ4rD%3xlC7d8x9asFq#u_lYF*v_ZtO1hR3Q!3mn#u0)vh z=u)&l%!2%b735S!rO4>4J~E*csUY>BWq~#@Wo0N(yCA_@fQ!>am$&b4k*bIGYzL=V8WMc=d2UCN8#ltR6fH zk5grb_DHe(itYVgHEFDg;$Nh`nUk}?^&#<9P3n=t7`IijdW?4`uG9%n zBL%XIG(|)vZTQHIX~VNwB9sBIgTIT51Mn<(ENf>)u+8Hc;Uc?k&9EQ#3sreDC8Eu& zc-PaepZ=EyaKg_HgK_tY{oG6?m0efVZ(hEXzzqa}Af~_=Nhycr^joe$Ibbrd=O$!a z_b^v+NHh9o&HgFb#A^Lb{LIvYQWj_K-r2fpqC|DnyzP4g@OizOi; zdBvRHyzE=wpAz-wU|64p!G#tX{@#P~)milmRJtFNk_UgZGuVc^iEIbVz zwS>$;!cH_<8@8{3Oo}|!eum96MIrEyA^n};g2)|BmI&hDxAT6DccY$OxgJtEREll% zvsLjJLB%b@uu(dX7N%;BcZLI-djOhbozk0y>X5aSs)(SZkAuczj+-QYu=m?vL|S{+ zK#>$F=TPyp=bh@df;=w-5&AjWT4J;c5!vs9HG==^LWQt=i>_HTH~3XVsQgNU!{#+3 zm=THa7q%>GTG|iOR8iZn3ehn&_#-2iBqFtPADuL;nSyY>I?U5ROfkE*u4P~e%fD6Q zwht!=@`hi9i}TZQMw^yiV3(d9!O{_$;N!{L1(u+3U9UKFiPz%4&)&W(n39qwA#H-| za*Y-hVRy$m>%xdPZhQWAtdJqBnl&snqif{Spi<^PJ^&~4=ElQCW-yav&e9Um%|%U< zrVg7>kQ2({iFXdgtCd^qF;*P8?*GM5wz`Kd=0?83#X6bY?@A~*$w!)6tW>+0lQtTN znOnPajm1uZ>|t;+J15GSC?UELOPeR-6c{S&F`=fz8z#((gtn!}Qx!gUmjD5B^rv>8 z=II{|5RTP-vM}a*DSq{s2~gD5OnJHc`N_05hpWDG!i!^S8%D>EeR!1K2YwIRp^H&* zzgM7t)V}@d{lQX1NFYsy*-J1mWO!RN2AI%rcw(^6CTH7Cj^C3;@yPi!JQQzKsA9yk zJ1|SKs70wOpQmZ~J>yGc{o=plS;8PAWFgYt@7-R3J)LrMab7KF7x7B0r3uc_1aE|$ z(RqtYs)z$30pHGY>|U8TUa7eXHCIMm4qRHzgTux*Yg1fQy18jxt`<vkb3C_|6I$)zThe)z&6XnU{;%AdbyH9h(K)9 zPt7pD#q!qAP9{Uw*XPpsVlGxkYpcHZW8LZkb<+q^l2c=IHd00n_}__3nflcn7Q;Il z!>1WeztUlJHi}1t;ced7{bm72lT`UwUS>z}aD_T1Azo9X>|BW;L^e=;%bX~P1UImI zq@|_6jH7(@7(+_Ee6Dq)d`L)lX;e#^0R zDBf`UkwohX8^uYi)*F`MaHtc(V888bOiXl!`zV^#muhZ0EANG=jD?b@Sz87#8u58M z6$KJr@==<X#Br8Max37iQ(avt%>>F zt?gukEViFPuA|unXqRVEX5MW5f;|-}` zda;St`QBw06=@f{E|@3NZ2;0R)vBJEiOB|_XzyKk0=nwIPFJWxO1?*WOiYZPt$q8$ zCC3opGA$cJl*oLa?j*p_C7-KhXq8+JH?K3T;)d&vaF>Ie+g%+iBi%vwKXm+WqNIUs={fM#b{go5y8|>(k_?#>tuU zb2AMKd0CQWbdqo7y9=IqoKV2}{K~=1GadAg3p60=VPo>I|DK~*R+26uUb6yE2n4p# zppcK3+g$5>_?{?QZ;wdy`E8}Xx^yFfl0kkznbP=`8yG6 zE~BrDJsTh*CYMhQ0*L|dD3X8kQIoB&FEyyQuaC3+-U-yQ*}Up#C06Dt8lhC^<~1$s z4iI9zY;AYTAKO~b-P@br4W3*s+Fx0tSf}u)BGa+vMWRPmDugU#PLIlJ@Q4d9e}r6m zEwo;VT~A4zeWTp^t=4=1*pPR{?YI3$eQs*e%0O<-?YGsNH1{-s!~>?GW6X-DN&BmV z!ZF#oKO*l}jvpV5#_tOJZVRe73{L`|sXVmQvp&FIK7M*UCOf6l8*AH1u^p@u1Lm!k zmX_^jt@f*@hd+(0asO%&o`Nzth8PvIS^i$#;ftMg00N!wahZH#@{To8cYk7H0(g@WWi^&urc?m4uiW`0CF3brsLbctfIAy)&Q0L-S{Twj z?CpDd>E8R@mAABM`RIk=Nj4A|F|F(Ko0szraDG=l)s=Ml%ci2j%2MCxUdS=#+yQt_ z{k-1;=Y8^XCWwc2NSyao^XkLnm0!i&evt8(5q=4F*^{UH9ee(i3-2P6ESeQ^T{$Em{)igzx_E#P ziX(M6Eq+H0hv4YzvzO!rfJRBHrJOzgri;hCk0%+$?EQ~7zX-D$X**sMq`y?}=b8H( zhsZ;uef;UG`@_GCmGi669Rz#07&Z&j=sb&3Q(ADG=h?*Q{oK(X;{C*$&$MenXh$F+ zZXAfF+J)GrvzcPQ@#lOBq>krIikb4qMnEsWyS>M*1MWefL_1brabuLDxb0= z;kRu2xMTmAKevx2bq<7Pc==t2`t?A#dt1))IB^4a@gLWorgVYH>zLoezTdy{r`vLj zujiBRIPU|^W~cn=x8eQo)raNPNUMi&Y5dnNqQ*o=8N%~GbViY;Ig|Hd%8ZF(K}8QX)_h)7 zI1{m0NXKhUr9@uhT_r**Ihxj+h$3oNlsJ^xuMJ8={unbp?($J`ux&=1TXXb;=%^_3 z2=Sunh;$(R#1OkUm z@zrmmaAXBaq%}N-O?q7Lc;L5rWLG0Boxhasqr&T$-LAPJWI2L9N5EyWkSy_pHinWL zw4oyCljPWiww**_D&}+MTc)<4CqRf82?Im1;FCTmCxx#Qq##PRaooMaM6z~~*id8T z9*Ca4zRU{^urpf`lu09s_M^Uj2{Zr4#8SD|VP53#co-MDJP;fRlOo~8-A9?0^T`On z7nUn!muWey(<^ViOtcmW+jQ{ty#!9FR`Kr#-wzZsR(v5ItM-y!tWIM+f}&;*^U?+| z*xNn#-`%?U`Yq3nkHk}#7(0U0!lzw|E~s+wD#A3CgM$OOS6EKftfd-y4wyd!qR%-j zTsU88zx49HxqHsC7&E+u0vS?6JkdE9Z)fQmM33)RfX^L4%1ify`G2c^XM!uIN%hJq zD)5LA&ljLUlsYoQJq5jJx))JKf6wh_rm~3zs^|PIvz)D5s>Au+TYJ$_Z zNR*Ns)i%nEkfmDNkuGtTJTk1yI7Pr8*&nR}6(otQ3Hom|lPjR7KN`|7217{Uv|eMC$|Y# zs0P~7U6S1tr@qWk`(wOC1rIInz|7SN9Zr@k4a95YWE7LM<6@x-^6>T|JHNF@YW_2i z(Uku-TezA?21-O5j@Luqh#$8UXWW$7dv8+AJjm`-MYA&bBGqYY4F=L;G88(QmaxG(Q3i!qt6VoaY2K>8znQ;oz`UOCu_|chsx{{c zGb_X%RIFbuVp{e-cY2&nyY#Q%0{w42HknCDc1Hg=Cb@-kk2j%$@**n##TnqEf2BrvOHYq` zlfDS|AHp7cE7yxEsN^Ll4Z(OJ;kZ5Xr>S3EPh^nnMOQp@ZtsCN6g^G4XQ7CNd#yug zosz5>5r8pi@bp{aLaY63)$f==(03XVIw+ERDA&Ar7|t?1>p+*viNWElXzUwbCTv4xR=9|677@jUh=0pS2ZhkKW3-9xBIXPIgM+Qn< zcRvZ1hf6$FKV6j9ubf7&UfYw5WcZwP(>#U7wC*%LT}$|0)kl<+xB!c7?-VXb24qUx zI_H#!L6Q~CP`MG=nVm`qxFgK(-=ez;>3K-6_~*Z3W_|@EKJ;mZoUCK{Ir@zO8~6rI z5lnizAZNM4LERy=i#HBn)Q1&yrT;KJ(nF0?5jPYDPZ`x5&3pMjAo4%SFY7nUH^2+U#F`{(5BO zW-PGQd6~92rk_**_vX-S=Qn;8YP29yu?X9{8_YTx9b38vc7rVhuCgZwy z&dzrYqlx(SFJzSHFlFhlFGTy9%*EoRAa9%QCieD9b#2Y`;nJIuqIx#480b%u9OHwK zA4hrRe*fP2UEaSl-NZqY?j!_lG@u-vlvMuv%&=*q*dLrQDk;e?0-dis=#wyBU0K99 z0JgmzBz=`?;sj#9iUx&ggHWZuBRpDXy$9YIAcLNR+CsWHls8Hg8o>#f_+$*aFl}g< zx{@Uwm6>VIH*;+Z_>Ue}C2L(g+o;^(VqFGdue;HeOfRF=PTF`_7I|rthQLVZ;@F?c z`Hw;_4sM@JfDcPP_G;e(e4Lcp{Hmg5t1XO;kW+BFEY2$QIDP8O}=N z_!qV1DSt!%mWWqW6j&ysMBbWM8fGbD!YK+pl-z|x_r~L$4LCZy%3&}%`s8?LRZN?Y z)}>ehw3y&e@T9k*V;|!C9J?UWH9(@$pZ6o$;^AM##=g>yH=SOj?5AK7T2Ay{us{k~ zZPAyhxv)nQQq+%*eAZUPRQ5~dN;SUy_ul-6c4N_j>D{H!*U~tPbds3EMXeoJ4vc0& zpvnEowAI)?_L6L!evN3}XdJ}>ir%Y@S37Cp^2v+~0?82wQQBma5^l>=5P_^!Kvc;26elox~OpK`Op7DJ~DPh>u$1z#PrJ_$xC9Z};ojon=865+%}2HLWitxE6G%N< zsp&A+Sn`w#X=CNZlk%9g-dnp@a5Zyj6_w0Jo;e8#@Q3&4Iyj0`{-hiUKd*dGTfiU$v;qgPTGJ6h}~7Ilu7CF64->- z5|a(YG~a_NB~U8i5r>9rjOY%(X1ZxfWD_wQX{EV`LkHhS3q{BUb!G42dQIsSeCfdYs@nc- zM|zX*Wy#|4@atg>RhEM8PqEW4$*?i(##ZEW7@-?xED>x43E=RzJDb)>9PTtLL3K1< z{byb$VLC~9YPqL>NvSaa)3MR1Ul0wyyP}A#-OjcYi_Vc!&lbY4d}Pv^eqFW>4Ksz! zz3KDMX2i0MA}7tA+E-SMf;I7JI}Yq1EUW2D=f24mtFo$`Wr2ZLLN8)o#DX2V;LlxD znw>CBuGqe68&j7{gn>_`5D#IIQ>A2$Mc=F}jXwJ9wwD*AhoyHFGp9b=`JSi}JvfS3o8=QNrbLs+yllz<_RK{?aK z^;##2<7>7dWR_W*|1f2eaJz+4Q&K9du%yTa#ndqNKpjzP(G)pmEY+XBPrt;NB_%B# zHJe}R{1V=C>RTh!m68y=Y41s$qfYQ4!@(>g-~u%YpIs(Bwub@9dC7G*p-gf3b?tHG zP$h5kQfDZnk1U5I%{lPwYbf5E;nxsbDrv@dljBMLS-D#^Yv=htpRUrps11Ix&Dxk* zy(or52$k4#$dKzhsJL>Y2}dNc4hre*UiH{49%c|v8#w$U9&28kto{~4iG#Awfh2Ea zElR?QG%xUWB0bftgAyrM1}=@tJR6+EC02;#;PlBTO1vcA$I!gqHsuXH{O^?qVSL8E z0FKVp7xKD>rO53x3rxRLe!U(l6p|SHk)xpKzRw4(NJv^v4M$y9vv4?g`A>>=Q_0%a zx1@*JH`3U6(wm^QZHWu$=R?8cW<7+5*d$-H>(HdO{Wj+obJ}vG9dja z%2U+nEykFixSz+w`bGck2n}Jis#z$nZN2eJoi_2NFMDFhqAn@AGqM|Tk1Z*bWdIQs z>bV7AiJ&LYAq(~Pz(@_m)PI-t`ObgjP;Az)ogtPo#X+u&R>$Z8RYt?*Ux$|rH!YKx ze@Js*S2O(bJJ`56ojf951T~W=`N*F`>s3X9=wDKwzy4%vZRID5^c|I2&C3Hif!)ku z@!v+y<5l{-pmG1OvVmD3U;6jr&k0&kBiGcg982BU$dr?gg{E21cn;T2je#;LWXb!O3W7|ow2yq7w_=Tn)&-iDzQ8Y0(YsHMb=bP z%c*{TzL~tZh<;o0l^Kb9h^BJXRlrQADa01MI$;az{)AfLQizO`OzXAHeJ8@zM^zdD ziuhZS`>zNgcD$$7e6o1;xEAo>MHRMWwUzpAfYBKJR~6sTe*$CTPuZ3SVo!UPX}p7G zT+@|Vlc(7kl}$B~Jo4f>`o^%8Y6BAw%&>P#Y(&XCA5_C2 z{U$^AuuIfvx;Xsw`TGslsaedfWYcu^Pg?PXLsF;tdhv}Eim#pxEjA@Aj<*={Ny{sV zgnadsCeA~IY3wfeVJ}Grec4!2iTl1Sj!HChyBXP)*$;YA`($Pm0Ju3U|Hri3r$ygR zxM+P;WDNSiFP!~;Yq-W|fAzlc&c7i)Y|~@(C_MBBHy4a-^<6_H2v_1%`rH6&D3FmF zOOY8Ycc-CuxZbp3-!S_@B<~AC`|I3bMreiSrVneAe3JUuB-1|>HLM@bICNXt)H0)8 znHgtx9*WLelZU1e4=aB2mwdUX!mbHqk}{|-rc)|)84M2!WVK_Uq~XzQQbzMd`$`@P zc?KBRNLaTVvMPnEc(tHi5Sb8$n!aa3DyYOucV z=wxpY{mM~DmChWhvCF%jL!m^fK>hx-_w8tRf|)F9>6>%L&rMcj50^C3mMRamC2oUu zQSBoN>K7NY-HjJ%R$|(Ju|Cd$u^JMW@T&+1>58M*w4)W$^|f9N6*9l|Ma*`sYMNk| zDWYa!VkWFBp$P0Scz3X3WkMsS<8-!)ls>2Q&`l%(#sn5rlde`BYn+nH43CPH9Zyn7 zNQsXjESmGP{+CESo2$(joPdVBFzSt>u#IonWb!TN#EUu-pUtiJBiXttl)*MZi5Z#@lqKwArNfvNw7By8AV2l8A)hs zo3mZbN`L9>n!fdTCVzq=!7P-73kDM?SN;#_n_@>Jnt+S??vml*Ir$fFe50ANG2``4 zn8e#j20D52F~zbg`Bwr|tCuXP3se)MlKnXaCk(sXEK@}<#r{%7Z;7w`U3E)Q5xtdT1)$@?@K zB++~+b2pI}i_*51?@)ID(FxH?Qt8z3Ei1uh^h-|}=fH-3b~ z4o(9@mqxwqyhY}^m`Vb9IlXZObdjIy;k{Cnjx2F$(H;~>*U{%T7V@(PTTQjhrT_82 z)c-7D=6X8i7}Hm=#L$9a--`-5c(s*Q_~pv1+Q0h^9=!JECPCMNKvK&H6$d3`t%VQ? z2^5AIgZg{3=C?Y$jgW?R^JFy(43+qo4Zk3QQVj7zsJ5-YhNoF;v^zX zTZCZos`7$1wLA&t_s~3w-4SZjNwY7y(!I6sH%mujOp|`jG+4eF66GOXv3cW(pBW>S~Z#2F4OCeN`kHm{Q7NzXg$$ zBcRMG7Fe3o867Mmy0+QwW=_pCy=xfvW<2?vFLK69e5^_fsZS+z;<4CBq9k$RFmT`) z^x&!dIc0I(^nuZ6&-m&aJt{iAd2#d6(bN9bMQhCGJ=4HQu)1oBzSe$qC>E_hlLioQ zJ&{}al!X#A>{^!#hn9tnQZrx$`$N2L2{xH}x1!1NbskeT)^iy80O~jJ_1l3xndp6v z;y!d4lbDyo!p=Z;g{x!jloUACIg+~~8i@hVrI4O15zY!%-)2JjQzXbrI1n^k~d*n8`@dd2}_J29xWqD_+xGq8$7O3xrgl0k|K^)<#O4sY2A zy^aFS-C*hOG<>y!+%z)b5}88NO+x8xE(1I^vM_1MOoc|Yl;YPK&QDiI%NPIr0^b*B z*PybMl9@hE`PfoCt>S(ag<{e{!-|UTosAMSGyQY>-|>~j@jP}!F)DPA2NRW)XhOFj*vLFluXsO7W^Ynw z`!jmj&{+acCQ->$s+Q>xtr;}_(J1Z(R~@R!S|rVRB&w)>?NVbRYZ@YNHpyAaU$)AE z$nM9V-tP)sDN_yZ#|E5Tln#4$%q60ye9og;u0ck$x!g)0iY9(VMb(ipz(p{TvtWv> zkdKb4XM8|zb!uD{M=je>)qxvHAg#g%*Vq|L0>Ie=Z9o>)dnM>KL0}0)UP2^yUc#K4 zZ&ik_22mt8YaS_X-E4@lPQ(TQNsTp_myYEnRAG?3e|e=*+OQS&a3Wa~Tb+eW0&T_8 z7cy;h$`|#g1r5+*x!5B?Q1&z5>*<-!d}2QMz#uMu_S?_;Jy?$(^Pe9B=*xwl?dK$O zik$@!#9|Su6cK6wzs{C9%vx#t`kE2RZFjuHdEPGCfeo{wXxdy`c$1zim$C%vjLuo%70Hd2$h8Evl3$heWJ|^T)ppQ zsZr^%yTrywNp~Qoo2Cqrl`ivY@u=e#@Y!RxR9>x@o5n1q+E#*e$HUH_KIDNoLoK{v ztQDTAI){TL;hTSw21>i7FNaAd0yfMxNNvgiG+l}p-Dq(nB!(LTn<&`=+mibN(mztbzIHk%6QQW2!H)Au3xFAzyb?Fd-13fm5&3%t%vwf>xR6slm#K?h8z_=xC0 zHFY&PEL?Kt-EZmb(*9I6jAtBk=t?(Wf@+S(`Wk6_(4-_|dAjn#LR$5cVL3Bq1gx++ zE{Ro}`l)q?p=p<-{6I$~1tI{;BMKV*!x-+hY*#%qI90OnX#Z>2BpoPyg zQUI2Mh6}&j2(rBI{Np~h&hvKEf04B}3r(-J#wlE~O)brhkUS1BF_e!!FTg_7G z$e1S&^xiq;jEa+dQJat|wl%`ksX#J$(>FgxvqXhX0HUJmmPL2BAeMOimlUC9+7wsd z0-OcL#gAvLn^hWBS9P;sHbivk2`l(uE3nL!_k+s(s6)^#&2>d}E?bGiwWe~EE}JOZ zpxi#;f~&VCfA$S*g)V*~?w_T;@9!zjHpb}9%D4%;@^84eT2n83zXLyzX8wN_G3^<6 zX(;=Ygs8cZm169$8PgznshWm)Dhjglz6&w6vm&U?Vw4-qM)i6{{4SmadsF8_qJ{vN zzFa9Hgsay-z|>KFD8z%I5H0H0u#>862ZP*~bo11A#r(QfjJTOZwd_^#Lq;!8M>}wF z>h-G{3DNTbohp{MakGSKu|Dmg?aJrZ@+W-s2PND^hNx`dgc>uJdyUxE*{{A875$lb zLoht?&41r-Z^ZEK&zvP5B~CWLC2o13r+yd=;yG~Flw;X0qOOM>LCN~!)Xj;9ZnIEc zEV_Lfb8U2Wy4$#iw$8GhL4%B&xzm$n4T|>uRd*N{w6idT``7B0vS6>8qOQHK!8na_ zY7soNwn#G1on9i3&{67yvXbFacC_7`ceduBkg{PXKnbCYlWb|n?tOX?#X-6J%sC7x zq;X_j?3-cb)M@>~%#eh4;}&cR)J<0!^P+}7#R|fcn&yRSW_4GMEm5fSpkXMej6DI> z<2JRNjaz#(H^nh#aJc|~UPnr-&f8W4FzQ_U-iR0V^4uZ5KcP&Ze-PIutu>!;7Alsm zRjr)wO_V)-wD*bhvE?o%vFb~yZr#@eV%p|;*z7vrE#RglGn{8`)rrJ6vxQWDQj%MC zE!*yA%3-p?ItTF2a(&&5C8W}@2#QopkkyQNTv16s6X}SyX!$8`%WzV9z?b^r3tQY`F95Q)$O-Qh8gKAx``r~fk0a{?$J_Zw{>b-ns~^fvM|2ue`&u< zcqP<{XS20iX9@W>IBW!8VWI+z@pMYUAsqJ2m)nvsV6}n|gbO@8a}v3opn`u^wr>vw zS8k%em=L8##OMBX@h7B3O(@j+OTAKz(aiybjGvj!URAP(o8;_7XrlXTb|s61(Pt$H z{wwc4WN#flK|27&rkESohJn>u- zv)zwotB38y|H@+P4~4=0xS8TmQQ4|RMk|}a+X^e3@+-yM=QEfZY!+vUWhaXIH2Tw= zBTuw*mTjVdHPrEZ3ZV@aMB0| zF+qGkN6Njo*#Trl&9-#$a0lbNxq(e1Y&`k{mpdn13zMC|mAmXj{Y__Z<8yW)-U!{*%_e3cf&$Fue; zFAdfr&8r!QeGI$#t77{I{+j=C^=S)6ZOBjbiLqi3SJdBg$87irp$h2;UE9^XZ`^fp zd;yvuNmMArzZO01tF|rUfBOK+y42*l*mW;fAf^~E#yK8X`y}CIPhDmSTLBtk$THS|Bpr;9_2y)yMMzn2G9RqBKAJ8MUcXjvN3log^=y@^2 zsaJ3Jk@D)eVKe%*UY)~#5@%ZWth0weE1J)-;L${Ex#Y^;pbdUqITMH_G*2jcq6*mP z6fUH+9=CZd9s*M6^*TR;Er2RKx;Qy)*gqcG-?a*b6P9wATE*cV!!_O{H!nW|0q;QP z6wowc-+WkisAlK&0Q5UKOI$fW(@sE?V2*|tP=q%m|MoOa&h(32*~O2sdj|TIlcIfq zQn@W~KLQB153;T2FEg&+uidntuKK!uGSg?houKiU0*)e3(`oYNaibiV4T`IcjgFE; z`Q#-i74oU52~0SDtY17Nd977DJ7RGL)CvAfNtYY@Ryzq#HuRp!AJS)~J=t(`@7Iwe zRY$S>F~bH!GTqL^vAaHbeY|*H7$bhdeoV=hEco~sn&FAC#|t(d;QE`FV39rhe=I

67CN`DaDfBw|-pV4Ow>Aep@#!IcYZNH9 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 A-~a#s literal 0 HcmV?d00001 diff --git a/docs/user-guide/components/index.njk b/docs/user-guide/components/index.njk index 6aa8ba78c6..ecd68c7ab8 100644 --- a/docs/user-guide/components/index.njk +++ b/docs/user-guide/components/index.njk @@ -7,19 +7,20 @@ desc: Streamline your design workflow with Penpot's Components guide! Learn to c

Speed your workflow with the reusable power of components.

A component is an object or group of objects that can be reused multiple times across files. This can help you maintain consistency across a group of designs.

-

A component has two parts:

+

Components basics

+

A component consists of two elements:

    -
  • Main component: This is the source of truth, a single object in which the main properties of the component are defined.
  • -
  • Component copy (also known as instance): These are duplicates of Main components that inherit its properties.
  • - +
  • Main component: The original source of truth. It defines the core properties of the component.
  • +
  • Component copy (also known as instance): A duplicate of the main component that inherits its properties.
  • +
Components main and copy
Mains and copies have different icons. Mains also have a title header at the viewport.

All component copies used in a file are linked in a way that updates made to the Main component can reflect in their component copies. You can override properties for component copies, so that you can manage singularities while maintaining properties in common.

-

Creating components

-

Create a component

+

Create components

+

Create a component

  1. Select an object or a group of them.
  2. Press Ctrl + K or right click and select the option “Create component” at the object menu.
  3. @@ -30,10 +31,10 @@ desc: Streamline your design workflow with Penpot's Components guide! Learn to c -

    Duplicate a component

    +

    Duplicate a component

    You can duplicate a component the same way you can duplicate any other layer. When duplicating a component, you are creating a component copy that will be linked to its main component.

    -

    Duplicate as main component

    +

    Duplicate as main component

    You can duplicate a component as a new main component from the assets sidebar. Just select the component at the library, open the menu with right click and select the option "Duplicate main".

    -

    Delete a main component

    +

    Delete a main component

    You can delete main components and its copies anytime the same way you can delete any other layer.

    Deleting a main component at the viewport means deleting it at the assets library and viceversa, so be careful!

    @@ -50,7 +51,7 @@ desc: Streamline your design workflow with Penpot's Components guide! Learn to c
    -

    Restore a main component

    +

    Restore a main component

    If a main component has been deleted and you have access to a copy of it, you can use the copy to restore its main. There are two ways to do it:

    • From the viewport menu: Select the component copy of a deleted main component, right click and press the option "Restore main component".
    • @@ -61,11 +62,36 @@ desc: Streamline your design workflow with Penpot's Components guide! Learn to c
      Mains and copies have different icons. Mains also have a title header at the viewport.
      -

      Group components

      -

      Create component groups

      +

      Find main components

      +

      Where's my component? There are ways to find main components at the assets panel and at the design viewport.

      + +

      Find a main component at the assets panel

      +

      Select a main component at the viewport and then press "Show in assets panel" at the options of the right sidebar.

      +
      + +
      + +

      Find a main component at the viewport

      +

      Select a component copy and then press "Show main component" at the viewport menu or the right sidebar menu.

      +
      + +
      + +

      Main components page

      +

      If you find a page at a file called "Main components" this will probably mean that the file had assets with the previous components system and has been migrated to the current components system. The previous system didn't have the components as layers at the design file, only at the assets library, so when migrating a file to the new version Penpot automatically creates a page where to place all the components, grouping them using the library groups structure.

      +
      + Main components page +
      + +

      Working with components

      +

      Group components

      At the Components section from the Assets library, there are two ways to create groups in a components library.

        -
      1. Using slashes (/): Select one component and rename it as follows: "FOLDER NAME/COMPONENT NAME". For example, "Buttons/Alert Button".
      2. +
      3. Using slashes (/): Select one component and rename it as follows: "FOLDER NAME/COMPONENT NAME". For example, "Buttons/Alert Button".
      4. Using the "Group" option: Select one or more components at the Assets library, right click to show the menu and then select "Group".
      @@ -74,10 +100,10 @@ desc: Streamline your design workflow with Penpot's Components guide! Learn to c
      -

      Ungroup components

      +

      Ungroup components

      You can ungroup the components the same ways you can group them, via the menu option ("Ungroup" in this case) or renaming them.

      -

      Drag components to groups

      +

      Drag components to groups

      One very direct way to move components between groups at the assets library is by dragging them.

      -

      Find components

      -

      Where's my component? There are ways to find some components at the assets panel and at the design viewport.

      +

      Detach components

      +

      Detach a component copy to unlink it from its Main component and transform it into a group layer. Press Ctrl + Shift + K or right click and select the option “Detach instance” at the component menu.

      +

      You can also detach components in bulk by selecting several components and performing the same action.

      -

      Find a main component at the assets panel

      -

      Select a main component at the viewport and then press "Show in assets panel" at the options of the right sidebar.

      +

      Annotate components

      +

      You can add text annotations to main components. The annotations are shown in every component copy. It is extremely useful to attach specifications that can be read at each component copy.

      -
      -

      Find a main component at the viewport

      -

      Select a component copy and then press "Show main component" at the viewport menu or the right sidebar menu.

      +

      The annotations are also shown at the Inspect tab, as another option to improve communication between designers and developers.

      -
      + +

      Component Overrides & Relationships

      +

      Component overrides

      +

      Main components represent the more generic information of an element in a design system. You will usually need to change specific things (like a text, a color or an icon) in a component while maintaining the inheritance of the rest of it properties. Component overrides allows you to do that in Penpot.

      +

      Overrides are modifications made in a specific copy that are not in its main component. With overrides you can keep changes at the component copies while maintaining synchronization with the Main component.

      +
      + Components overrides +
      + +

      Reset overrides

      +

      Right click and select the option “Reset overrides” at the component menu to get it to the state of the Main component.

      +
      +
      -

      Update main component from copy

      +

      Update main from copies

      You can push changes made at a component copy to a main component:

      1. Select a component copy that has changes that override one or more properties of its main component.
      2. @@ -118,27 +158,7 @@ desc: Streamline your design workflow with Penpot's Components guide! Learn to c Prompt shown to update a main component that is in a shared library -

        Component overrides

        -

        Main components represent the more generic information of an element in a design system. You will usually need to change specific things (like a text, a color or an icon) in a component while maintaining the inheritance of the rest of it properties. Component overrides allows you to do that in Penpot.

        -

        Overrides are modifications made in a specific copy that are not in its main component. With overrides you can keep changes at the component copies while maintaining synchronization with the Main component.

        -
        - Components overrides -
        - -

        Reset overrides

        -

        Right click and select the option “Reset overrides” at the component menu to get it to the state of the Main component.

        -
        - -
        - -

        Detach component

        -

        Detach a component copy to unlink it from its Main component and transform it into a group layer. Press Ctrl + Shift + K or right click and select the option “Detach instance” at the component menu.

        -

        You can also detach components in bulk by selecting several components and performing the same action.

        - - -

        Swap components

        +

        Swap components

        Penpot allows you to easily substitute component copies with other component copies.

        1. Select a component copy. You can not swap main components.
        2. @@ -153,21 +173,166 @@ desc: Streamline your design workflow with Penpot's Components guide! Learn to c -

          Annotate components

          -

          You can add text annotations to main components. The annotations are shown in every component copy. It is extremely useful to attach specifications that can be read at each component copy.

          + +

          Component Variants

          +

          Variants allow you to group similar components, such as buttons, icons, or toggles, into a single, customizable component. Rather than navigating through separate components for every possible state, size, or style, you can manage them all from one unified component using clearly defined properties.

          +

          Imagine a single button component that can switch between primary and secondary styles, active and disabled states, and small to large sizes. Useful, right? That’s the power of Variants.

          + +

          Why are Variants Important?

          +
            +
          • Cleaner libraries
            + Keep related designs organized in the Design viewport, Layers panel, and swap menu. Variants streamline your components into tidy, manageable sets, allowing you to retain overrides when switching between them. +
          • +
          • Faster design workflows
            + Make it easier to find and select the right version by quickly switching between states or styles using simple property controls. +
          • +
          • Better team collaboration
            + With variants, you can match the way states are handled in code, helping designers and developers stay in sync, fostering better collaboration between design and development teams. +
          • +
          +
          - + +
          Penpot – Variants sneak peek
          -

          The annotations are also shown at the Inspect tab, as another option to improve communication between designers and developers.

          +

          Understanding variants: properties and values

          +

          A component’s variants are organized by properties and their values.

          +
            +
          • Properties define the dimensions that distinguish your variants (for example: Color, Size, State).
          • +
          • Values are the specific options within a property (for example: Primary/Secondary, Small/Large, Default/Hover/Pressed)
          • +
          +

          Each variant is simply one unique combination of values across all properties (for example, Color=Primary + Size=Small + State=Hover).

          +

          Variants must have at least one property, and property values should be kept consistent to make switching predictable and to preserve overrides across connected layers.

          + +

          Create and modify variants

          + +

          Create variants

          +

          You can create variants from an existing component or from another variant:

          +
            +
          • From a component: Press Ctrl + K or right-click and select the menu option Create variant.
          • +
          • From a variant: Select the variant and press Ctrl + K or right-click and select the menu option Create variant.
          • +
          • By dragging: Drag a main component into an existing component with variants to add it as a new variant.
          • +
          • From the Design tab (right sidebar): Select a component or a variant, open the context menu next to the component name and select the menu option Create variant.
          • +
          - Annotations at inspect tab + Variants creation button +
          +

          When a variant is created:

          +
            +
          • It appears next to the original in a dedicated variant area (by default in horizontal flex layout).
          • +
          • Shared layers between variants are automatically connected (connection conditions) so that overrides can be preserved.
          • +
          • Variants are named using their property values (e.g., Primary / Hover).
          • +
          +
          + Variant created
          -

          Main components page

          -

          If you find a page at a file called "Main components" this will probably mean that the file had assets with the previous components system and has been migrated to the current components system. The previous system didn't have the components as layers at the design file, only at the assets library, so when migrating a file to the new version Penpot automatically creates a page where to place all the components, grouping them using the library groups structure.

          +

          Manage variant properties

          +

          Properties are key to defining and differentiating your variants. They appear in the Design tab when a variant or component with variants is selected.

          - Main components page + Add variant property
          +
          Add new properties
          +
            +
          • From the Design tab: When the component or one of its variants is selected, you can add a new property via a menu. This property will be added to all existing variants with a default value (e.g., Value 1).
          • +
          • From the Layers panel: using the formula [property_name]=[value].
          • +
          + +
          Edit properties
          +
            +
          • From the Design tab: Select a component or a variant, then click on the property name to edit its name and/or value.
          • +
          • From the Layers panel: using the formula [property_name]=[value].
          • +
          +
          + Edit variant property +
          + +
          Delete properties
          +
            +
          • From the Design tab: Select the main component (not an individual variant) and press the minus button next to the property.
          • +
          • From the Layers panel: You can delete a property by editing the names of all variants so that none of them contain that property in their formula.
          • +
          +

          Variants must have at least one property. You can’t delete the last one.

          +

          When multiple variants are selected, the Design tab will show all their properties and values. If a property has different values across the selected variants, it will display “Mixed,” allowing you to override them collectively.

          + +

          Delete Variants

          +
            +
          • Select the variant, press right-click, and select the menu option Delete.
          • +
          • Dragging a variant outside its component turns it into an independent component instead of deleting it.
          • +
          +

          If you delete the last variant, the entire component is removed.

          + +

          Restore Variants

          +

          If you have a copy of a variant whose original was deleted, you can restore it:

          +
            +
          • Select the variant copy, press right-click, and select the menu option Restore variant (will show if the main component still exists).
          • +
          + +

          Use variants

          +

          Once you have created your variants, you can place a copy of a component with variants into your design and then switch between its different versions.

          + +

          From the Assets tab

          +

          Drag and drop a component with variants from the Assets tab onto the design viewport, just like you would with any other component. Once placed, you can then use its properties in the Design tab to switch to the desired variant.

          + +

          From the Design tab

          +

          When a variant is selected:

          +
            +
          • You’ll see its properties and values.
          • +
          • Change one or more property values to switch to another variant.
          • +
          • If your chosen combination doesn’t exist, Penpot will suggest the closest match.
          • +
          +
          + Using variants +
          + +

          Understanding overrides

          +

          A key benefit of variants is the ability to preserve overrides when you switch between them. An override is a specific change you make to a component instance that diverges from its original definition (e.g., changing text content or a specific color).

          +

          Layers between variants are considered connected if they:

          +
            +
          1. Share the same name.
          2. +
          3. Are the same type. Rectangle, ellipse, paths, and boolean operations count as the same type.
          4. +
          5. Have the same hierarchy level. Groups, boards, and layouts are considered equivalent.
          6. +
          +
          + Variants connections conditions +
          +

          Example: If Variant 1 has a text layer named label with red color, and you change its content to Click here in an instance, then switch to Variant 2 (which also has a label text layer), the Click here content will be preserved, and Variant 2’s color will be applied.

          +

          Changing any of these (e.g., renaming or grouping a layer) breaks the connection, but reverting the change will restore it.

          + +

          Bulk converting components to variants

          +

          If you already have multiple related components, you can combine them into a single component with variants:

          +
            +
          • From Assets tab: Select components in the same group and right-click → Combine as variants.
          • +
          • From viewport: Select multiple components → Right-click → Combine as variants.
          • +
          • From Design tab: If conditions are met, a Combine as variants button appears on the component card.
          • +
          +
          + Combining components as variants +
          +

          Conditions:

          +
            +
          • Components must be on the same page.
          • +
          • Components that already have variants cannot be combined.
          • +
          +

          When combined:

          +
            +
          • A variant area is created containing all former components.
          • +
          • Property names and values are generated from the component names.
          • +
          + +

          Transforming Variants Back into Components

          +

          To turn a variant into an independent component:

          +
            +
          • Drag it outside the variant area (Design viewport or Layers panel).
          • +
          • Cut and paste it outside the variant area.
          • +
          +

          The new component’s name includes the original component name and the variant’s property values.

          \ No newline at end of file diff --git a/docs/user-guide/introduction/shortcuts.njk b/docs/user-guide/introduction/shortcuts.njk index 00fdadf777..0f9a317bdd 100644 --- a/docs/user-guide/introduction/shortcuts.njk +++ b/docs/user-guide/introduction/shortcuts.njk @@ -263,6 +263,11 @@ desc: Get quickstart tips, shortcuts, and tutorials for Penpot! Learn interface CtrlShiftK K + + Create Variant + CtrlK + K + Flip horizontal CtrlH