From d628c615678c61cc8ab7aa424d382527acb42a26 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Andr=C3=A9=20Dias?= Date: Thu, 5 Aug 2021 19:45:12 +0200 Subject: [PATCH] Text - README documentation (#19073) Co-authored-by: tringakrasniqi Co-authored-by: Makoto Morimoto --- packages/react-text/README.md | 98 +++++++++++++++++- .../react-text/assets/typography-examples.gif | Bin 0 -> 33597 bytes 2 files changed, 96 insertions(+), 2 deletions(-) create mode 100644 packages/react-text/assets/typography-examples.gif diff --git a/packages/react-text/README.md b/packages/react-text/README.md index a37feac50e699..b79042d255b93 100644 --- a/packages/react-text/README.md +++ b/packages/react-text/README.md @@ -1,5 +1,99 @@ # @fluentui/react-text -**React Text component and wrappers for [Fluent UI React](https://developer.microsoft.com/en-us/fluentui)** +> WIP 🚧 - These are not production-ready components as we are still in a Beta phase. -These are not production-ready components and **should never be used in product**. This space is useful for testing new components whose APIs might change before final release. + + +The Text component exists to ensure consistency in your application's content by setting fixed sizes and other styles. +This package also exports wrappers which ensure your text follows the Fluent design standards of typography. + +## Usage + +To use the Text components in your application, you can start by installing the main package of Fluent UI components: + + + +```sh +npm install @fluentui/react-components +``` + +```jsx +import { FluentProvider, Text } from '@fluentui/react-components'; + +const App = () => ( + + Fluent UI Text! + +); +``` + +Or by installing only the `@fluentui/react-text` package. Keep in mind you'll need to install the FluentProvider package as well: + +```sh +npm install @fluentui/react-text +npm install @fluentui/react-provider +``` + +```jsx +import { FluentProvider } from '@fluentui/react-provider'; +import { Text } from '@fluentui/react-text'; + +const App = () => ( + + Fluent UI Text! + +); +``` + +## Typography wrappers + +![List of typography variants by sorted descending by size](./assets/typography-examples.gif 'Typography wrapper list') + +Wrappers offer an easy way to use text according to the Fluent Design System while also providing semantic code readability. + +Below is an example of the Display wrapper vs using the Text component: + +```tsx +import { Text, Display } from '@fluentui/react-text'; + +const Example = () => ( + <> + + This text is styled like a Display variant. + + This text is also styled like a Display variant. + +); +``` + +As you can see, using the `Display` wrapper is a lot easier to read and provides a clearer visual of the page's layout. + +## Semantic elements + +By default, Text and all the typography wrappers render a `` element. You should use the `as` property to ensure your page has proper semantic elements such as heading or paragraph elements. + +```html +
+ Headline + Subheadline + This is simple example +
+``` + +This will result in the following DOM structure: + +```html +
+

Headline

+

Subheadline

+

This is simple example

+
+``` + +## API + +For more information about the components, please refer to the [API documentation](https://aka.ms/fluentui-storybook). + +## Migration + +For migration information, have a look at the [migration guide](./MIGRATION.md). diff --git a/packages/react-text/assets/typography-examples.gif b/packages/react-text/assets/typography-examples.gif new file mode 100644 index 0000000000000000000000000000000000000000..7bc14802fa171cdbb2659a3eaa7308d65c78f999 GIT binary patch literal 33597 zcmV(=K-s@XNk%w1VG0D=0rvm^0000aBqU^`r%g{k|L(S;QY77>P*Ef#BvPWxv7{s< zLr|gJw(kFmdMAj&(d*5q_4V~6Bx9;$WF~#Rh9o2|QghD8htcxwK!=IR&f;@YFIsn< zrpD#MfF?2|BuYt2ha_VpB!#?yOZoZvKR-VvVq&JLV8y6`|NP@kY@)KVvXGIHf2`C{ zJ1RzcvC;GXC3Sf3+rYoSzf_FE%k<7MF)_c|?}J1npnq+D!1#%XFgHz3VkcorUva{b zVAp`n6VgV(Qxj#De2w!|ce&W5M0DpQWCVkD=1S29LT@U?H>#in(2 zb(zB4j;zuC_0D7`h|Y*4Yn8@_m!*d!hpOiOMm8kFk)ZwT!(CopBtVqg+uPNmXvFRR z_Q{A?bc#4QIM2_|WKB2k;MLFm{$#A`r{B*0{{H{{@q=kiBqnZ?KqPJ@B!Yv3hsyq> zkBs8NnO9d=OlgGJ{n-EJsw5;(Q+}<8b6M%?=_))a1kKn{h2>rme-V#Kgsi$G|a0WI}_&hQaGaMMbD(EGQ@_ z#lowPVlroEXW;$+jDBV$E;x;jjkDwaeX`~L{?3+`mhtcLF=3ERPfewYvw&GO^Vg|M zP-LsCtN!@HW2)mPgT^>6B=Pzc(POXbrPDV1fx3?rPQLv_jW2?g9+O8&Wx&O+C zY>Ta~n|J)=!J$NU)&6g9sBUT*$DY!-o(fN}Ncs zqQ#3CGiuz(v7^V2AVZ2ANwTELlPFWFT*({Vj%brcUw(Z-vbL-yCySMM(z=I1PPQ1AB zNZ}SBk!WH7LO|e{Ft>oHOBhc{xZ;Hw=J*zjGSZ09hbxMBl!_*z_z{sHw%C=8D>fOx zEyY|iNg1$sf>Aj!nm9>~6Pk#lj$o#R<%(PW*rbp~Az7i39;r#8l3X$A@%1nmPo5E=`gU2%xkIO6ss(?b_?FiJr;o zijZ<7sjQR+Yiq5y2m|dx!ZbPQQlN@j))i&wf-F`Lz%t1S#G01virW&TYK5o@T(K@c3W0=_0*0yJ0zk5zNZP-(m~Z59WBF;H5!Y4n>NCynpY2R-ozopO{t>&#ZK zX!BHIZyj6LU;k9MvtzUW=(bf#|BX;N2s`QRy>N?lbya)Y?Hb-ggZOYp_P%W*+6e{H zH-#VY>s8f?%Z>F@jXTa7O`aVH!iBz=Xe!6mkktB*)eAb}9ZCBi4gBWmOd z6%3!trYHj^Hbj94Dc2UfK)^qg!E>$C3h^d#g%30d8|RCk@){xo*HZz7<=BSQ`$MhcmdA(L1U?c620ROJs|iex0UAjy!rT|o|wG|??45yOKR6Pb== zCPl&^j9RYfk*8EhD^27DA3=aeAex&qXl6mm(4=zoYi%IHWI=GZf{}WyASqp`BVD?Xuqh*= zD>4N4%1XVn+DfewQHD&Nw9K3uWT_SEW+NbA(|LwOq(4O>N0CaWO9(bq^DKi`O(cgP z3PiEg+NDBH+6dHn;$O8Af@2#3SXW*mlWf&lLkMT9TU>~uX0zTzXnDPpNl1iRH;h@r@|keEhovx`&4Vm;Mc-v&Ut2+>+s^VQPO5^cWIs;@(aAqU^i zXd&DUfL>QX(!;XuskIX4j}|*8pvu!k3M25e+BOjUQfqkxp)BMy=h<{BUh&2{y4KmHVA8nyAb0x38$ze?^Z=;UMG3#$`>Z_?;z_+)2dnj zXKbb~h98RH2@5a4-IT#%70i*N`j*cHIk78iaoDS=*OkCMbiQtxx!oEBZ+>Q~)J7}Y z(!$r7)JuqjZ>xg7d3P!-mdFT%E4dgunjmHF)5v~F+Z!ob(o${2YjF%Ek;%4m2JuAS z7(G8yQ>duQb?;XV0t>WCaSQ5m5}^ZmT=DIgx0igjK+sI5Pbb91M13hiWZ)!T`*=mU zTG=)_>Qa^=rx17oHg3^s6Jdi^HJHQ`!a(#xY(cgo|7VZyTA@dlW3!DI zq?3|MkeE}5>Wx+=Lt(jGI-x2M&8CnSq)pEzQ8-ycwri??`)^^l93cet`Qqn7XO)+|*9F6xxIbKYmNz`-khaft* zR_bj%F5TlvGT8^pM|4lfK$uOcLEgYl*UE>%`Ou8Mbsw5(jfOq&LXbiK&@`D2*1LkB1Mks4xhc*FL3j#+1 zDJBpj@DE<}5p~CQxs6aLMWur3!aVBLIMTimc1pEYb8zp2WB3)enM}`Ywg8?8}#^;6z zu}1QD5aSh2So4RRC|(UnA(V&_3ph9<6?p~`hCZiljevR-f`g6Vdg8Nn9f)!p;bmNg z5UvO!us9Hmh+JsrB>U13n8;b7_&`V$gpVRTr1xvuri@#_j9#^I13`j5s1UNKKbg2) zYy*KGVU4`#jSXRS?`2ekHHwJUZ<+>OO9+l2LXGp+ap~AAdDDgA6^th03#=#*5I}1g zczE4M5WC1C;)sM!a(=*Kh!BB@E23AG2qMc*}si3d?e520r(VuUKt zBy$E+2~~U-A&~{)jvr)T1h{ZEC@L1XBEC>e0f`Y8>5SL^1tOPlTqY?HS=f_ZLm?cv z5FF_c9%&*=7=)+@ZAa#RN=ZpssCNeulG%kzGI@z}vXmoHVhVwaya;s#ag-Hu31AtN zd>B+iC3^}XmSYKl8fI{`$ZWH75GvVw`)HBJh=*>YKx;Ubv6d=cg^*40a)+3R9Cv)Q zS9%t)Nkf?syV#SjB}8GjJi4Zk0|8zY0*@AflG`>?h8J9RhYyi;0<5H1$Q3S&NFv5LC7zaVc+`vv35_n;(~o2v!UPC&{1( z(U$>$WCti_2w{-9C{!V+ojDkv8bN@kqI$CniVKFF* zr7F4*AH%8x5tYMsm>TJy?|7F?lb4=?Z6^GkKbqM9K1%CiFlk=iYbr8}yi5_97Q72O)nPJkxnoksBELth- zXU#G0W^vV@BNI%H+jH4yrtCJUAm`*#J}pN~eM4-vE8;+_cU zutJ$rr9-a|t1Ad5m;6+w=_Dr@6utbvy)5dkVbS`Z~0fN#pKs#gvxkZd275LEez z#usq(juIdl}xpORJY)vH#(^sfvP4Vv5nx47jl#TNUw?7HDB9hW{bA9 zqOsZb5Kb$tz!|wv+msb(opnfze#?!asS--|0m{&^17US`I}nR1U{H5OV@k0L@r%F| zv=lODth<(Txow3P5l+izr4zQVNV@!Zj8e-jR67x23XI5VpsEL+y&?=go4i6RsUQoz zvwN!9$5g9Rng7Y736-9z8Mi6_C~WtrGE~|mS9@(WnGwG0sRNN}j3%AUQYqL9tRTX- z3h@Nj>q?LdqOy97yqmshHX5g?3psv>}>hl85Ba2CV957AK%yuVA#5PkZ; zoy&k?sAO(eHUXx=AkmMu@&SB{s}Ia)`q~H+yuowZ!n6y%ij=WRx+)QYW2jO(fXlyN z+^wl4$X9Gmfc9E}pu?O0cSz* z7~D{Oqq0gj&VUI@y08M}a0pj$j6CeL0_uwAONw?pZN|*Z3GojrWyU|6%@;wiKvS}N zi^>mbkx!MQZ|p8AS48qm&-NUnCt}MI3Z22b%l|CMzYG(Hpt<8J3@^pT;_Jr!T)Biy z!2m7J%KNDV-3ZbDd~Pqz5Y^1H*X+^;-JsiyI4#W(+MA1Xd`80HcP1pBSBlY_TGVM1 zQHCINP&cXzv9_5RPcav(-}}r=_tAPRtL5u}+se@rL9gul#{nR*@4_YytJTQ-5XMtV zQr((gOxAsx$##8=(kjO8<;x8T%qX!)w&HInEo>^y)z)0E_j}V=yVMcA%(^7aKugV+ zB!7O4$CCTg*WR00dU-P^wX+rSOjwMkd~s?!-A68D;1lC*JaCxDttmJi0ZT#R6@y^mDgy2q`~ zf1TKV`Vfx)qOwYRgE9czIrYZM>`9FMmWW+3 zL|eKwD-jgx#r#{-x}w>x6V#LSefzwpxpsMTqM!_px+A5h^5}~68OXV;qo3=FU#fsB zUAr6Mo=0YS1s&TN;fhM~qTb?;HWPFEOutpy5EgE;9Sz82O_(>H!uKr^=v@vm z5M@l_5Mke*MoATnG5Rgt4PmSl*fqu7pa{m!a9oq_dCL2xxx@P@-ppBHjlicJ+7K}U zpx2Nw1S%bFul>E+?(Dc5p{dy|!de0mlHT1W?4}*j<2K<_xf{M#?BV-O>DaRnNp7X6 zJ>1hg-3(g6i7J}RtC!qO;VS~&T6)5u*5%^$V>ue(e;Rh79_CkF;H@RQIE+%|Tim{j z=_>P7NG9k3@ap_L>Y!aAFWV6kh*R0v-b%dFAkmj2`itS*2(UYo4r}N07@iF=rFt$9 z%TCL``w+&uJVgq;jWF+B&Ey%u={7L}#){=ny5^#;@7S%{332Mi?#!vqy|uns;VrmC zIa1fo(ix63mEDow3e=^(UtM~G!0hV?VbzZ8e#tq2G6nI%p3c=sSTrsWY&q#_Yj z{Ur7)!~~y`nro{bk&QLLP!#%pj|}r3A?YqfY7ibQ+K%9=9>Va)@(l6v%uecc^0w~2 zYqzb?;8 zzCnn3KA_^~#vSz@p|nB}2x%GYd$mu#5_82J(T#7Fj&8oO{AG5Ul3RSuyb(9 z5Fn5IH(a5nmyI+(_>Sx-h#%KI?URA~4@kARXOEQ7JW_(65mD)FR>$q43=jbX3KRmN z(Lsa>6)t4B5Q30_0=<;0F|e4YhQcBSCFcH!uL`gDEV*f zDiGUX35c+Gs!W>>DUEkv-6I0CBBKp9W71C5w z7ccno3^^4n3sImf588r+a^OQyLGz+Ss7$C#Oz4mgZn`B#9!X>WXv>m((bF{>4QuMk zk2ZR5Op#=eP*4hq6ibGkuE6G&DigY*(2a`m^PnM10x~5^Bk~K=g%XRX1{)Ct(9Hm9 zSx%rO8(PmKP8(u$BS#quB+`gVJ!r~-NN8=LK>m;`ScISzNLse66-*@RlAI*3h9D@1 z1R59WP$H>Bf~BNOoofr5RfY5vScb}w>ykru`scAa5gIn#1~=-GAssiG*0nhU2$Id33jPZ<<8eh9kNKo6`;&1{Pf|CP?LkXm*$(739+YrMZJVSz*3gjvJ_Cs%zF& zW`t}l$&fOx2qTOuR={~TkYQ71RS2#q!@iOM!;+zJjTZT!V>i;}khQ~*VFjou8^+t4 z2)5EALl^cj+G4}L>1vO+{>*EEO4jx>U0`t$f0}GBd7|(zo>1P^#Ghpr?7sCAM(wrTC-Q?|Z;U_i0Ng@yWFsJmY<9rU zjEgE#3)s4PovuLasig*Axh>;-%5#bJck6dW?l$HQWW~4+2Q1Env9Um z_DLv%mdd41e90pRB2IhxkeyZW1dBFOgP8`UiUS$jLiac+mA;9kJ2hcY=GO>@Ui5GB zi(*!52GkSzqL6PgXCusr$+Gn?0NIh3MK6a|g~&jyT=b_{*2q<4Zf{2?^`5ZQQd0!F zk}72wt7qf@*M!pWC4_D0QXZN(O>G4KR1~GG)DU=!KPY2`IYTK&Ir)b*uF_%$yu@7( zvP!;1^(KO)YAmM`tAVVuvK#YEMm;f!!j?p03!&z=OgmBot+Ak78Y)$W2^+*BWR~?r z;!~S44As)cI<3W~RU4^-nCd5^iLEMj56G>m$iS`3Q^wB}a#oR)#92`$6RmnQM{TZaY5`8Wh*;g z5dL8c8j7!EP;075WcPX7J#9Y`atH%QO9dU~>pVr0AqOKTWe1@y*cwu`l7N)5o)AJI zN&K(e8p0P7b0&9~vc!!X^2Qkd^y6gITM~&zQ*gz_s&ktHW6#uJ#uU4z=N8Ia4TlZ!A|rx#7XxdFl9zijuhK3x!TF|f`qZzm)X^xdBrCnsbymS z>hmC2_RJsHOO+=y&1N4^29-zl<(J$xj<=9Ql=3S~l|s|Pqb9XvHiHd3nnxGHcmkC_ z%#-@e#}I!IhH1wH0a#4p1M{hc9AseWso>Z^2-T$Bbb%WZ=pt>;mBAJ+@vB>W;19l# z0kKQHn_R>3GsTz$EP#FOYvWqiy!Q3Cx$9c*l;ILGslg?-a0nJ>6Ws@~+q#kCZg`Wa z47%9$N4y}1GTbg^tz``V3!fkiU1%FQUckoOoa2ddp!zrm%4L&D$}ZGUF%z)%+O=zb*?j|$O1WH*v)=+w5R9E zu{C$v-QHsJy`3r)9>{;>es{df9PF6dd*0V0>bwVD@KRqFwg!KAer^=;2&rU5*t&Sg zN4_$B7Zc_04#1{LUh|u;Wvr0O`N2~i@yo0*=uLn6b5~bpmVbNWnTvYZ$NnpOvE;>N zFLlum{8lzkdJ> zKmmk3`!l;I@U<(r0vYJBkQqP+%((xXiU@o_3amg2G`j)}yL>XNw!1(Nq>2e-iV*xj z5-dRz1h)+2x($R4mpefh95lsRJ>h#n8mvJZtfds(x)sCLMfcWDa=8wQ$i9bFDjJ6C(I%t+(Ix6LowvKK+pw_>$VOY zLp5AOHf%%xH+(}lj6*q`LprQOJG?_Y%tJlgLq6<7Km0>L3`9X3L_#b?Lp(%8OhiRo zL`G~xM|?y`j6_MCL`tkgOT0u(%tTGxL{98PPy9qs3`J2KMN%w9Q#?gfOhr{(MOJJ@ zSA0cSj73?TMOv&yTf9YF%tc+?MPBShU;IU23`SubMq(^RV?0J=Oh#o~MrLeAXM9Fz zj7DjkMry1^YrIBm%tme8MsDmzZ~R7Z3`cPsM{?x4Pb)`sOh-mMM;}xMnMkmP2)Rj6 zI1oa^F@ZQa=r^3eH%!5fV~ZALvo>`cNK0hL8sxFQq6$$dq#E!ACTs{GBdan1p0tSD~di#GTYlom^?&-JV6v|z@`X; zYx=6k3ze1}ip+b7c;cc<5XhJ;NzH0g`FIR zaB&;oK_P^9{suz0WYo6Pum2)QgJ@0QXx6*#s+vCVIgx=x^1%;P* z+l>I5(Ho7@@!U$rQ#p>4gL2rfb_jwZ`NK*n4hN>(ctoaH$U5NgagC=FX!aO5-@VF`d&ZG>>O zvV6sgmy{Y&)mDK0z{je~uR2htJRs3j7U5i}z=x87s`L!t+>M-cBQH?6)zZ@XS)K@LlZZH1xItMtm;^6)9omdo zkkpEySV;;=)^l2rNkvjayEG=9lmN5Yk$qbDo03bg4^EQ-PgtArnIMRzG05RG(OC#s zFtA%_&-eT(dQlegaoR?(%>Y^fa)AJ4m@Bb_G@|9$`(lbur7pEyh8AjR9yq|8s<2?tu;){S1+)0RDDTPR&L8Q5K0%D==@&#EZf+1!a)O4XETUX?B0JB>l5 ztx?g9R+t!Gk$B!7lwSJXJZPa$&2Z3xXwRxhOM!SH@%sv#Qs{uH?Y$ zKN!WH5s(2%{KNFi))%tTb^dO!)5M;0I?cokpa!z zs@+l=W(O`bcP&yNcB;KXiAKNwc}9wBf>MI51-GfQDM_$RKBk|l z6ZbNxf_~xU{n?ag=;-NNrcGWI_LsSe*NL8Ko9n+RMxOkfks-TOdK zSSV_vK5C>!>R>iyiH%TfJ&^$W*MvCf9nLiUT~@mlwA64_n(peR>p!W%5%5jf)RXB( z%`>~pQOby9Eh;XdKGAO;2nZQpd2 zpK;_x)+E<9(Nb=N{_M@bhHF*jCBvJga$X4V{chnNZwrH#k4;j$OYXah*{T-cYr+w! zNllq?ZJe`hgg~DFYR{am*^}!n+s5yln~nhMZSpQ~ih`CNj_V9n@BqMTf@N;vWnb!& zBk6wOg8<(E2baRM>_)Ip;HJ0hjL-hG??&*>95ZkfFYgrcUA-_cD23>DhRB7jlLTyv z{f@%>zL*4O5)Gl-CT@fq{|u2~+kghtqe5uOy_H~2Qu#hDUgGc+k8-{{rW(+~g*b#1 z3KpD8@F$p{I*|{^C8(RoJoXNt`U>Lzb5Z40K4qXCieJsli-B@^ZJYrD&6_A?z?ve| zDOaP>RVn}T^cZDI!yixJpA?t~C8bi3BwMk5;*;+ua_28T2t43IaHc^su*#Hs- zetvYBjUaujT!ygc1@Tg?F5@3R2wwMArUY;VV(~harzW>`Y*)WN3d)B18&H0xeMZ99 zw3(i@l8!&7bocYP8m}?4 za%N}q_!uukAbF9v)s$T7cnsE>kpo7xc${zGkOi}dmoZDLm^jKpJVPIE=&@_nz&qMI|y0h4v?|LOtH+I7}hUZT!{frNo1g;MX8SsTa zD0V}*gh?R*Uppn!o`1XBC{@c#<(7YOlBkMj?J^q+pSiw7|X0CS*)$-sVr z(Eb9K2Mq{-F93)n*%}dS6pTWEgo_F?Z0PVI#E1tI23Qyo;zWfPH!{pvkt4{EB1e)e zY4Rk>lqy%UZ0YhP%$N*WQH-!hCeD{0De~;e(}|Hr^deDI#lYkpia>KRZR+$X)TmOY zvUHS+q5>@)5o(<3(c;LjEX7iV+9ggWatS{b;xLe-qd1RRtZf@I295!v0`%%ZCurHg zf(H|xN;9F&!ew{=`fQwVsir6tfoLt6^f6$?nm2Rq?3wURum-t)^h#QENU|zbe@+=s zjN=M7FCv58n9ZPzRG2t6N2@jP;KH3A4v=_wOva9VE*)AF-ot5Vxj?)eV5!-3I8tOT zOl6e@O325PFCWn=#Z5)FQbhffb?Vb&<(uc&MbO^m=EOtPmt}bXQv3puA2$H_1vB+2 zxL|q39mn8F$^obpVDcOj05!99R6u@eR7c@c(}>^!W{Sl_S3>+jxFU;!QDMs{Qb5xX zeDBd0){QCE$RaEGCDcSQ#W=&$J_9-w&wmL4QNb3x3`r3JyEx<=MW2`=jcp03*CLl) zQstnAUPeg&8g?dmqE4{<{0HnBGEMkVk8hbmoWZvYGC6;+6$#iW7@mr@bweJQ}^L$-5!} zk|m`7>_Y?x@GL=qrp!=e6eUOyz#Ti(>SF?rJhXWdgOtcQL!kIYGVGKBQE?$C(g+o9 z3`uiAD6BHXkYD(vD98^wgcl-v_4N%DyoP(xxs8CloQiEf^Z*WO1<(X0`FI>r&H%dC z2-#-$fObRI^0dH13sW>pHr6>N^+wi(0NtXECRDDq9Z-Zg%3WD<3SYl5gaR&k9r_6- z9CV7a%K`95#R+BKo%-q&(>Kl5B=+?eM}hM-c-m=#=*~MH05MDLBb}93es5rcMDTOh z{bSx9lQoYhba_3;>eHOy4~ckl05wIB+fFa;L+I|;-VA*=S3*oLQBAcpu3XRqouK&t zhSQywrZW0+_dDK2gbE4hgkBQzhPKqtA@gX5IG)smWaQy#5TTph@TND1V8KVhA_&MJ zaTE|HY+uuQ%Q8sAIfwizA(JB-49R1(h;+dcS@H=GW+1MpDMAz4DBsiyVvT+@<_EtB zTbK&shg|fA1r2ma#oE`1w!O_UadQ?{gVq+>`B=%_JHG-_nL&Vq^ zb2u?o6e2{Dd}b0G!tEhi_kS&=SuBajqf!wU#fo5r|6Xa(V+C>P>LpGX1!k`Aew zDSJ|ZYUt{Ien3NG6ab8q_0mtX>`5&j;*MPS$S1goBoiHjIaO{^kf9`@As+%VIW|IO zFLX#3G#4;}C@y3V2|@{Ds7~O_5F?~n4i_32H5xR_g+c5>J(}5*A6TF!No)i%ez+VU zaN~)hw3xZxRK>1ft79 z5Kj}5gg!RL6}un=5gp^OnE)}CJ`HA2Z|E4PM)iLM@!@h55R3bj$s93k_#ddA=1HYuCuY7X=gE)lm}SA0vDa|5jP1E zH52s2d~f{%CVX)O6x|}FcBRM{HgFACfCpH6T3bZgCJ$eTmSG900BvczNVyT@tGx&Z zWzUf%u|=c~mGA|YC?bU|RM&?N?8KMs_8z)TJO~_6OMb$c%6`@&nD8_`R zu`*scH(9fVc0)pEgkCxTndaH1T`3Qw#*-j$$d4KW%dU~2GyvbUqqGivIrEA$0D$!f z2?8{Sfw;rDjbMcoxYrOApc*kFd~WM*oP^a`Ba_JzC6Z_V;L3PVdWAxHKbqn_$b#97meX|Ea*nm0hlqJPfsMS%Db9-iWP9S66>joAiB**L~RJa z3qtAu{CjlO&evP$Jmk}&k7Lb<$eqil;5oK#&wYM6RQ?QR8$hIIPH^Q+1HjjU^f~~H zbI4c4w$bW3gw&bsv=n*kziASLw=#QmLCPs(kgQr8c}P7uF$1%Qj& zz2|A(2!8CX*AJ39LEipPxnKL%f}%yW9w1hWD1O-FL(FUr3lTj-z5RY3F-p8C{h4yQ z5j~qbu}9o9PCca9Ek9`5VbR)UOr7D&R*eqF0NzE^9U5IlLhzqM_+RBvM54%y<}rle zjYO-N8^Ndn!8}MgX`V-XTS=5u^W|CV)Zf9O+pl?q#}!Vo9moD9Pa{ZRK{$@Sq{Mao z)1vT8032Y}Bp}4ioLoI%?UY}gJsa*B-{M{WTmET@w%nf+G6eFK32Ss+@ioNnIh{y& z1pXDoc|l=FloRFI8c$qa4|0@4pnwnt9LFR?F9gYd?OLckgtw^QL$IIw?P1ixUq}o? zBH%(LJc8ZO*ef+$*^x#LIs`hQpU$yWaV#R*v5f%MVNumtIZ*}y{$E5eAhbZ@z!AiS zDS!&N%ohgUu8o8RVhYgYz=Z);afpUT^xj4|LKyJFIUGR*og9AM%)pG8C2HZWnV?zC z7|`7yR_NPF$c(blpzA4#GPd33K-|&U86q--C#shrGT||v(=aNcL1jv@wP22nqw+nX zFPch1NTRW%A{r&a6I22(41g)A2pPuzTjZ&fZE51YnVUQuSx*3gDYOoMAR*gnW2H&s zHZom0@}Wb*1okn+0|Xg>j1**j5gKAsLSoy5^n|DR&qpd`5)R~~fj!_*7B)l%j>Lt1lg)^b38G0D77I64V*$0o95#k%+*Cv~qB;4`o{^zNwB&@8 ziR7H4Nz{Q4!r=x`ovw8xPoRoRX;V6VS`t1SH)dobFeOKxphNJTBXT2HWMf%z;k+aS zS(+t7V2_Fch>E~uKvsaX(WF*xWs&_HPnZKR^v!Y5*##P-j1|Wzo+a@;BxK4&L{g1l zE{8=bomc+V8;#gW0?0>35ha5E8fhG)++C@TCrh|$EQYMOX z6iYcN3rYcjtl$a0WZYYB>3<4Kl{Vyd@&~7S>ZdxYy^%y0qysoS2}N+;q*f}gDk_#f zC~=9TlP;v5WZ>jEomzUQmA)67x)ZLF=eA}bo8{1|jA=tW&`<(GT^(z(Dr-pejJY|; z6cR+Mp^AC_VnV$CDW2XdNnjtHapHc?-;?&@mqCQgJV?u!6iR?*Y*iwpmSkqwr-`ma zeip1;ngn!hLU$#Ex$5X_h6I~Uj^gwlm3W9a*(+NrR(||iK_FjnmMR#UBgB!V%oK~n zY8^=gX-hc58F<-oIBcylYB6eLvrZ8fU8hF?Aw$Hhwjdunwro+*oNCY+$ub08I^PdQ z1kxg8{rTrcJOFi-2G71kIr-$EYNkVc5n$oV($d+|;w#%Cot}zPu%G}7`s+fXBgRT! zL9`lnp_>ZEqntMzR}5NH5!0rQb4sV3z}01ahyAVY`~0%QWe zup^!n$JH_aB9v{Z(bi0$AWElr1O%qx-NGy1s$Rl2s!Mzoe-v&w`t08bs;?U3NO^<` z;!E$ztr@*5LG0WjvW9hxYWDFW)%LCr_MUZwXF)Jy&kk=rRU_@T#5DX|>Kep*Ev+{# zT~sQJZ5dnJmM=$OUyXd#W!7!x9L_^5mDs=;5RfHDAZ( z`#wh_cwZhx#E4_YP-iUU=`B7wvcGi1Tg@h#o4 zKGI98Wvt|7Qt*{TIbi@oplsh@LlcT8t|H|OXHCK>FADO66!20(tmlq(@lFUb&%ALM zk8&c{F(c=0<-Onnf`cM!p%kleAfH}A%mX2}uwTBi{yr-jgWDW;N}>3O*t}-MbulVG zV0W+v^8sHMuaYR&;57Pe9_6zA;m3%{jOj5%$@PSau!5pFgde=uR(%yK*JUuDav#wD zPeUvdPe3l|?${zl3Z@mZ{W)MB0RtF7Vip zK>x^hb%Kg1z!CW2Qr(R=AOS2SfHcTX&)P4;!XQudf;ad=CqNQ!ZSh)|0)4H*5r9t6 zUIa6KL4OtBN6VK;le9^LS@Y5y7Gx4W6JvlZnHi+97*}NgT;QdZ*5Bd@@&N%gq=A_Q zKne7yVGH}+j_vnXZ~PhSHrSWN)@!T6ptl2L<5R~8O=Xm1aTiUbSHFIA)ilhLA9RoNEI1Ct{68Ef*;~GQ-O;Bmar}} zlwnU>Wj01mM+6xvFL;}`wZtTZJ>dbXv`9I1L@@Nv>Nh9qiGCBwHRQ+_Ily*LhCq}R zI;1yG%!0VQw@=8mLs`cJLj;}aR1z`na)`~2;O==JBD9i55-51YsUB8!q=0ZTS~_?_ zumKI^h{V!j{erlNCxpuV^K$$EE(j+=I>slTT1WQw8&*|5npa;36U^d1V2n2^`O3nfZHTd%+zV6>f@q>3bHu^v=t(Yq;IY{8c znSpA{tG?FO+JDls=qCf(`50dS`^K3(mk9Vav{{%9KyI&WA zpxG?dY|UMMK`|6UJ`A}?xC0KL2;O)(x~n@7usagC`<>TQ&@wbWlOk~$21L17M!J|mRw|h$4tsbLM9GK3JB*Pjo zd;#fu{Pg?3yZY_wDXD)ry{P<+u{^*#5ClmO@ZkE-5(M@f7+W|OYY>bBcOiWsJ=3)O zL!1R=|BkeYYYafpz8Ay%)NZ~H!P)yez>^Nn2fzZUj!4+C?3}zIm;8_8Pd-$X|6g5ezUO~FXJj$x zM`q=}dk|Aa7%J}Qx5TQhzU#lfU@#x@!oFjbK4@QlR8YyS)4oceRAcf!@CQFfbc5G} zAt%kb@b{VRzZUL8MZwN~@>_-xMnCme|EJ+iZiPLOc)9hD%<@Bh;&;FJk3ac)Mo0+~ z50<~Xe80AyzWTpE{Kx-PoPT7uy8J&3``hmQ??3+oL?eL%2^KVX5Me@v3mG?o9P7e$dHNtQHu5@kx2BsE3Z7=V(*U=&_1T6q&^PMte>_VoD^ zXi%X;i54|_6lqeWOPMxx`V?wZsZ*&|wR#n6R;^pPcJ=xd|7=*XW672^dlqe4wQJe7 zb^8`>T)A`U*0p;VZ(hB7`S$hu7jR&~g9#Tld>C=B61!xwI{8!9(RWt;~!&KqOb&b`s@0KI>^4DOJ)apV%cV~v5M z#YS1|N-3NtiX8p$fI^`M9^oT^FM62c8S)%_&>`rin=pXt8X-WEjUr&cq54Fk!UtzI z8V|z5Fw~Gkfz)FUCl42jFM#8cb8oq+P;g_E>CQ8#{|iAhlFl4j4x)mI3E3E=#3Yq$ zL_!Lsv+%?KAW3ncdCsxJH-cP*2!#ZW$?+u;8=5ALPHN=IN-UQoD#|GbS~1I;woC{{ z8R?_Zs%dO_>5F0le2EM6t^;#A1+*v#g*_<*B+fM*ea(?!B$d<;nqs_QQc1b9rUi3= z(T%r88=2D~^`sMXAyRXK^HHHV^^_o1Tf}qB;$oaHB2}FV0!&w45J;XIHrk{JE!|_I zzb^F2Vj~1X8c0GQWBOHoxQ+?Br7mZ)`AN_U_- zah;9Usk-Q3BR2<%huHv_8R*`PRDp*e12!^r|Da_+*=Pdv=qX?$M%kTsHEwV9Hq?UP zMQDsdILOB0a}(MaC3h+Q$z+sBmUqV5s$w}|b7S5JTY{n#Gl*e}B?yjgX z&WGG3S)q_Sthc9>h1SVwlUBC1XnI|)3f~x?6=)etgNeh5#9KabX>4Cf&`9Ewj$g>f;hzJ6mcNDK24El70p!J06e>Yn(vLN41Tq#mAt@Zn zScC+Y2Bu?Hsn#VoQaB(Uayq$eL>Ex85h+w78v}$R5dJlg ztU1Am0+En~Fz2uB!SaULq)ZO4*{ygKqZkNE5IBp$3FNqlm@oN+H#*_E00hb)NJPjq zL{N+Yfaw$DL}fZRvd(q_iaRgVS0h*`B@TTvoEzyAIL(=mF`96MFAWMPT}`K+0Zs8f+b>JWT@ z34^8(M}C$=h<^0~6GuQ?{{Ue6$c;>bS-o)LEPfh*UWn)=MN8m{Opv2q{0XN8F=})^ zAzcyk~$pT?|vGQ!H+>_g3W^E%mrN<0^cF|jW0S_UG!LNuz3>y#x8IB`koM?B8 zAaUmbrNpi8HgXFEu;6pbLxNF7C&Y9f^S#j8 zX0bl$mY0We6v(oC|2B$a3M9HZdn~Th1B6i^%d|flXyZ0w4)E&Ik`bGuhXS?{7sSsI zKFX@`Sliw2hIhQRottx^E8Vmaz&$RQR}7fv+R?%`#9>P|jYV$@itwh~z*A`2W} zQkF%SRWf5VE5EpQva%Yh*KmW2D2N3>Wb#DU52?6frPGep978pj;yeVW$8qOE{LH)J2+^{^-L=? zPBc-diY(D?U;r!T!FD{x0Qh#RFL72uQ21$qbXd^^k>W;t>mfh~Af>7XlNL+NksK_# zifMC1o(-~R|4l{~AzjX?F2fA4dVr}3h3JGh8@tIN7uh{WhH{dZT!ZC?^I1URE6HJKL@a7_Xy)(1KFwBYH|KUusey`WBr1NfDmal6NI*;Q+NO@ zy&JKq|EJaNX|w(kfs0B!0;IikYV8a%&7Zqx*n^Krhr@m`7!e&JV`l3H^b0!CHJZE~kPfG?tOt4PN2`~q!rpaqBVk17p)UBrg8oKui3{4)nSX z`Ywh5L1o+OL;v)z)*_7n+0Xq1Pax_b#a^NUph4Rjk3G(9;shdRLTCZC=%K6w#wH7h z|N4*Cnhyr=;`umB`UpuqHo+8pK?iqm2k#-8uJ0hSZ&-4W2YJv3RV_Mx5BzqEA=IN` zXyevs!*ggu=jhKM-smNoAQ?;{4+P=;8W39Mk5nQHMxjY$F1($!ZMH_y`XRCuj@1F#a6D5=u$r&SnVdPzR4t zLLl#=HcmY(ZTF&#++JwNVh|MRVg?1V1`V*FEO8-#&>*(t6vJpCUhS-wQ0x|>1R14g z+=O#1tps0hPQYv)Vico~39WIAMlco0j<+T&A!#llx-1$t?FU>@8z16Chy`ElgoO;n z?sjZWXk!FDt#D}POkPOmfJ0|n;UoNj^ zs;L=7DdWV%L)7CX_iO7~&ples^a_q(M3Ux6G9hM(?tJ4R?UB>N9^HoqC^R`4HXmO;m~1W|Jvr<&;epJ zF&}4V{&Y!+O7bQ0Y9K&}Z3-}x3gXpPXluN{Xe4(`EtRPihE>f%lfxW2Os!V_1< zs_htVw2n+W6K^3Tqy(a1qA&*rGUQz52%6kn$9}UbS?Piy1%O6Q)rn5ys!w&U%PLZ&2&EU?lnr0h=oWAzzHv^v>~-wP0~Fv0zVIbmQLf|k^Hm?!O zvQa%EpbGlQoiHih8lkH4bXXnJ8f{FST*n1qsZ}9z72V@g{}Uu5q9d^&)uS?kQe%&D znxF@G;aWLDIQq1o{!}f^wNGkKS!>m@v3)>|n=OaUEMK4}dIzO3*SF;yyqM zgE)7C4hQKx;(rS9$Vziy*HGT3fo&5c8CZY~SI2u!HE^eu1>FH0@%y=U1cp*1Rfe?8qfa7lF<#v>JK`c0P4G4bU*pd$-j<@e35BVJ(!Wt4( zI>4ZgVL0YCb0iEoX=tL2<#LsYf{_unJwf>q5vBj4!yMB1lHb@G$O)XV3RS@=1$;vu z!~j+R<`6_dO?VZTb*MOipaQnw2;2!n|A!<29^r#ef(oknnkS|U>cIoVmPt%mBv9Fl z6`3i`IVlKW2zZ&Ct~E9I!3JfeJi%1NG2$$+!576dJJ;sAmwhM^( zr=Kdhu^Rz--A99zxe+Wu0~$yP0I(pOv2A7Hfw-$W>VOnHVEGcFdalQ+cBh8a*Q&19 z0ms8YvI7$wiFb1cselZXANrABhprDodtFC)>ROxPQqIJ5&s$+omW_k69b;OCZ zzqb+0S9!Wvv;`zl&FrTi?si?G&S>i`DXPlSnxEIY@Yu)FG7TXJ zJ38z{zI7z00L?XN1K#u-Vkz^!CQ zUZaT+WZ9T%i8dmD5e7*C{}1BBdk9xhfTu>*Y^iPnPD`RFfePl^98&AIjUydQH5Lh? zzo#RVG<#n_TmfQXtF0yis$pNXR4Hl6H)~l*2O`C#1CJ6Ss1baI$`W%dWQ_LiI&xRN zEt$OwqNe8o7EVBPAR!H40Tu`ZmHU(!t^pRp ze4+|UMgrzN^_JzzkiAe;hvVFToR6?&|T)Z;$y*%vzD zM*tyyEJhas;F0eHRC|7-Mfay$T(;1qhn8{`?Q_BjIw=?msi8ni2?P?^H4D%*L%8Qkll zfpin900`na+M+0E8~npxtN>Kb~g4dy<90F|gr z=S(F;$ITe##n2|oQ~*>UbThXshO{)zIsH{wAX_yJ-roY?!yZCHG~N-oLqY^>=b0sK zOeLovvtErAMKXLEo5U4_vs6`Vm?-i*dn8Bn#gIG9;s(MhyEpVLjE zb!;G@+d0Cw|7J2El@h-N;zY{wjtfd;uG-<<7~;cFEhoNF4EaRx@y(KwNGc4ir&=i? ze_;j+3#2|1AO^!JtD!-t<>EsCXrg9lqrB8(VG*LJDN9)iiiTkCKbd@>z3=GM_R96v)wkha+VvtCar z@mhwO?#+I>AZ}lLazEk1nmYwwqAQ!s#rg23IPuFER~Y|p2k^}1#iwb`WZm9q03twu zMU4tJS|<>U5rd7UwFv-3i@`3aApRKzgc-wvcLWmL2yz*P0IC!PWJHiO7jX2rQBxF>CZ!6@fir7Cs{ty^ zS;)|8$&EBW(rm`i5z7Eh4bm$hP-df~aSgH(=;UVDsUhGU6lfD9K7kXm%^ev)uF=2@ zMFxnlM{8EAkT*KK%5WOLRY%0}0VPC8z0w|E!cw}XUbSoPe3i56M zqLO?2{tZ01@ZrRZ8$XUbx$@=An>&9FJ-YPi)Ehobj8nH0u#K#SFlmr3_C~sang`7= zUO$09ehDwju>5)Ratkg41vKyJpuN=w*i=L#K^%2kUyXF2+EcrMG>s3=%!gVd@I}R! z|4Fq)wvlc`T?Qdg-*q?DY{FTy-e?<`R*+F0qDB*MLh)A+hjNKmpLX08bRl^Hp;Z)K z3(;7RZiQ`>qi~dA$k2pTxZy#Ea#3N6c~Y?OOpMp9_#s2QqTq zgp%n-P)AP1lSM?V1u&$7E*2zO0KIsVMh2cB2qU5fVZkLJ7Jj*3G}bBl;gQ8rG0uad zY4n$(W}W%sM^^R;WTF9Vw-EtTK{BRpJZ@wZvc+l$Qjx*gn%Q+^G=f5u0hqJI|1}v< zab0~~SfYV>Y`ie*pIN@x7DFhMOQCAf-YB7@bneS~P# zVV(>Fal{ZC)}1yGaRcdlk{UI^!xBeKaY181R0~AgMhc^3Qyjo4Yp>0P-vU;h?CC}; zlQhUgs0!N@NHDeZ<46E*ilJRlG5G4Eg7Eut)JyE8Iu z7s3W%YA;}VF*H~JJQn-2ehi`1^l;d^)!I@)aLHIBjRI;A6+SenwqZwOJ z@fI{-0FQzgfPrqol{mqcUyga^ns3fI!3LXoEO&Y?+-KE$;=~~rA#0qn|LMMAF{l&i zEIVeB`exOrD!3dlRu>4W0~52hmuXPr$THems%EFPR$JmNev%|p8!M}1a~n4=RKegU zykuJs-?hQTlBtSc42{gGVO9;Dtw1LiOSXsw{Ve})Rsn%kdV?Bx8}ZREx)DJ|&Lq02 zo^QxD7LYV9Z@zOMqu_!+hTP0movWY)FNnbmYVd-ei;vi>(mg(nheNZ#mp%g22(nSI zI5aU}yGpo`6B?urH*k$a(D%3(xll4A+r$ylH^0c~Aauj~)Jp`i!baeOOUi=?uL`on z=^aKO`#@5+mIpZn(84l(0MGS)GmMQiFesra)JBj2jTaeFRpJAi|FHr9!-5Dff{iHJ z4{~OZD3(uza@kY>TyZu{SS)Tvno0ofXb?ZtFmR1P9~dCzh>Fyu3x*pT%f@0AEpqX6 zjp$#eHbO%u8bp9UV3)BqRk+iOgei!#Dl=LLq!{kA?UWT-ONZFy#`eA%zkMH0$JOo*7NaY$*V@2tfWI zClKg;&mcDo05PtCi%uxuGflk3D5!yiRUCtfsuSTYzOaF72vZ=HYa~!Aum)J*!VS*I z(%c-Ax7TI&Ct6lGk*SrRdmc}|> zPV8|WnT#(`B|6U+U_+A?84)KhHP7(~QCRaFR*r)TVOm4j*!n>leEBaY zk_5^Z&~Y7*a;mgIalzTd~7709|aA`jV`2e_mIR2Oc0o*&QvR(fkq5^+MA|5pqWDCVe-D#;rQu!-k9W-N#! zusfgcIwrIX>4G4d8-Oo7F_F@Bt||2j-~bDFzyv-HU&-XxI-cPa5K%&82HOZKv;q-a z>P0fXVJHPD_BZZ$$Ag+MgN#X-!lJrxhVPTkx5CA78SC(eLoAswCYUDQ742fXa0Uv0 z0Tb2WkZRT7hy~}j2WhM>C8!{Z&otpgS&0ESeiDFBV1fe~o7-LJ%Mf?qU;teDf{7V) z0)I5g%j`f=&A^A;uPw?(=)#B+sDu+oSYikd@-l|K1i(f-;1Nxd1s;r0BxMDlxAlUI zAHeaTPq5>^F=_>advPKl1$hYc{6rx*fDqJg@pT^1u&{@PsRT;S6uM!ygXuh)aCp6tB3&FOKnyYkcDz z@3_Z54)TzTeB>lAxyetC@|3H5wM=t@43%^4)mZ4 zT{+WW$ybd%k^~REIqIomif&gN-RxT3|F-mv)R&I+tovF%5Zcb@WS#WQYK016Zqky? ztaZ_T#3*Mq&eg$Q_1?UFPI4YXlX`&(JjUn*4Bl}yaN-U`NBPfbFTCNk!u9!VXBr~- z0yjby15u=aJ9JUH_vS;}-gF@yI3RR#B0u?z$3qNKXe!&6GxuzV9XP3nQytK79uZLi z_U6gRMyz2~prG>byg&RrDymS}Lqe++&A_txRiTKY@3D*AP+SR>*Tm+ch7HoWN)W5d%2z6F{H@-*6+T7kG8Z0w*{ranT?@ zVTU(Dc4C%@hFB1L_8`4L|74kAYF}`R1`#~90}}r6T_aN&WYbM>Q-VH-j5h~_q_Z9C z1r$Z7fL%}z_*Hs15e9$r1@e{}=kXEhVOYGx<)2zz%mOW zXy@^OmB(C?^+dW6Tj%jysU!mPv5!U}0G-u>4>TY3;f?k@Rb1Qb9ZEN^EN z=&%+*QH`K7jq`DlV>n8Y6#y6jf^sJi4nTWAv5)X}9#_bC^C2wJMO=?p5D4M~p5OyN z(F94@U2%7HKeKD7n2bMJbIX{3L^KS3kaSnGH2ud47%>Ak@c5J)`00)`S~gTfnh@d+fr z0-g{CCs0|nqZ=f^1~xDZF+h9Ob6u`MC0(EogVIk%aSN`niCJ+QK#&9rfdVH08(is? zQBoO~0R-l-mzH2L^YjDq*A1-#9ug@KB=7?q0DYt&5IGb@6#$#j*CZ?Sc5tHrd)b#( zHISeqn1pGV0#QA|00MZh4LP9?>wzqH14o834VF+_jUax9^mi!Gk8X7t6(BVh=^k`p zL`ESKcOgI76P!S)o-8Mn$Oje#h<#%jGB7bz^3e<7Fqr|UGfQX?aMKoz;wmFUeLguk zEY=7j;hpSw{~$o58xb`PmBcL%5g2qqM^JVqQ18>g~ zp+Hj*WU~TMP@!9@gdjQ!3otUWvMDzz5c_2i^S~26ArK!z7vE)!#v*UR7#UNlB_h}> zY}y+?Lku>+S!yFM51|m35kgjxL*CS)ePR?l#FLHirSb+hJaToHAzvYxit)A)irP20 zPzggo{|*8%jDupEt5cGEdBu)l6=DG@R5j8TxV-(#6 zH`RKwgX?k4s({Z*MC2(PFuQz^<06i6j0pn-oiGYl=$I+6Q-22G z2pL0J)|VPC;vXWq8gPLC7w`}?s(RRXDLto|2$&{7wz)K65C>)e9=t0NG)yr>Y{W>M6)3R@1JFH~QdLQm zdRFlRrO*Y)ut=mE08%gq&?f?1BD4Yl1f1}EaZp1l`4C?)18(aGiO>$!X@CQA#ey&g zOVb5UX`o%q0bd-(CSki5oVyw9T*OIx!h$|*aGQVQreaGr=HLKK>L7r;{}7FGjOF11 zr7#SJ>>7fFANx=Z*)R{eV5^Z~4Rcu#?odM%WEFh8G{eAoP30dzu*fkW%*8b;y~%zx z^aD&NKwUY1T;iudEY24v#M(-PbQ)nLdCurGT>wZl6-h=Jc^)4^HbXMPBe<>XJ1pbd zS-8tLW7Jv|Oc%t!1n04lx{(Kw1q3iz5H87*PX{9-(}GYN01qgQ_%%SY;;*+Whh8hn z8_-{1a5jvG(fcU25^Ej`kX}TD5(?^q30->(-9JF#3I$ymiD$XEHyzOf{UHi^j4{|TP~1Us+cLlta;alXuL-Pa9q&Yfq;Tf*s8_wZ-^$>E=5xhYKl^}~b7i9Th7<4h;zM;Yju0xztQ5T^WnZB6*B%D<@hdg&5C=dV3??hG*0Dr zW#gQLpM@9VnrH zHF_+DB1m*}H;5EUiaqG1UO|Q4sE7U=iLTGhQR&8!{}hjIZf`Cew4S|^e(7o=6`Rf) zE`1x1;vd2?Al_~2#jZK1?z(=30yUY|d#GuNsCSL9*+4)H^gAAkt|Q2j|B@APa%L?IPd-kz0ys%?WxD?vF<9UH*ojP+NZR4jwS>8J6q+o-PHyh^E%r zkkaPUUhPNT8<&0t!}JNL#_xm29S@(05-;u*zcQA$>rBWhC6N?Er7Zex>_g8v$o_Q4 z6H2mh1V6FoNnv4;y?cTrD#gGDQh*58UM6>;|Lsw*2~}WB55iQb6eXWv3JezLjbIIb z9sqAp44kkKOB7Rl=2qDwE21$A*-#I8{?)~>Oez+(U&t~;f)ZoV5io!skbw}N&;xdd zvr{w)S+E1O>ZWw@_>qsofszF~)(M==D@o1^<`@|RQR0xh91N`^}F^d8%jeG(XO0*FHNfC-R z(i8;}1E^5~?AsGk>zDu&UN%Z(q!HIyV!NOUAP{B%1qx9hoLLiJ0G?Gr`jis1QADMV zQU!4JVjwbYKynzRkg$9h-aSqg3m#f!-VaLuii&pKr zCdCFw4#4H*x&ThZ4vdO1Y6yxQ6Dy<~T=;O}#f=|Fo?Q8I=FOcyhaO$}bn4ZuU&o$Z z`*!Z#htrlBUcBw9Dhaac`judp{|*5bEse6N2tj%UCdVw<2tE0z@(JQM3KWnAq74DZ zLON)&wchj1ztdb`qAh|v8c-{SCi2UPRQwz1u(b>fZkdm=@`;S~+7qb66VuXvr0 z;i6J%pe&UvNJNloym3Mu2`cbFf*h%56s2e*54R|Ei-NZafAcO+J@@3ZPe1T1WTQ) zj!0wz60r(H$`KVs(2%Ku zIbI^wQ9FB0(>EhQMNCU%8^QEca%(eU%5yUvDAnSkC8#|He+_n6kfyEn+NxMh6jg*S ztxe6{;2HQ%2Mt9yVTBiFxM7DMhB)Fp5jFQ*@@SJ{3tu+gn2u-S=_i0U3h_k)_s#{e z-AxDTbU(4+6}75OOyPLrd(_l)vII%4*%!Uul1a8ZXDx_HGS(rAsR=}kv)3-#{301s zj<^WPSpihGAOK^cre|L`uxnZ29I?dY#`>eV=9|~b&*Iy%j#l0OTzKL^F~JU zN?nU!mmT{ptt3e7fS?8H?Z|osDc||hXPo(Q4-~~4Nl6j}rd-8IbQi>61~s@r4tCIC zq*GM;=2w=&o#7WSvWZpRLyuRH&=F{vU4C2^w)41%Nr54VKAwUgga8jTqu56^2;vSF z41^)7fQL>1|B)Gw7)CfuselIZV}J;B;$XchSR({MEF{$?Gn?s*Pn_^Y&QQf73iwPT zs9+4+5sfnZxDC+$)*c)VM29S+o!i_;!=pSzGiB6UV+NxQ38{;Ps96jQ{TCd|ATE&s zm`E142og9BM2X&k8uLOw-E4rxRkZU6)@dC--wgk>ycIZIc9 z&~9;>Ldbei3}Ip9ECKj}YktsxlQkj;9tc2d_&|(Y#1MC%st|he72#yeeOx{ooa=7S_?@5r*5)@3e@K7cmVhAKp)hksdlbjeZmQQN2%W?u?b>Z44 zIk)-G|NBYi6RsHrGW$-e?S##TC*6~1 z8!wUDG3~j`W-8<$#S>o?P_j#GN~oT#AqPG|a)*aT^d}UpW-u>0yEhB~nF;^~L2hbP zAe_{awg|v3hXsb)(9)_`#cEcyy4CF1l1CPF2RN|V3rv75dp>Xm5Qs4d#}TA#$;5*v z_SUlY!AzP2p@JwX^@SeHp(d1}0x3KI1ez@742Y17Ebst@F4#k!MjXmhHJ{Kz5S5YzH0~4t)1p?j1+l~skogIAlqp(oaib>vF?On7y}u#}4`A7JwnEch!|^}ApG_Se7v1+bsGM=Lx*M?@*R zszqE9U|&jAcCIh?&?o*`#rfb-ZI9_t?ijzFu%_3}hk~*~mvma*~z2WF|M+$xnuIl%+gn zDp%RcSH^OdwY+66ciGEd26LFjJZ3VN+017~bDGt>W;VCk&2NTtaSqb2J6TXV|L9Q& zZQkQ5M_PFrw%ACE7D*gEQwGn%DRi6_y=X=c$`OY(Xc{Rq=ZYc5&e1t^p{GUFD^DX8 zm=Sbx5*?C52WQmSVPS#5@K7d4fnTnl({!Nj9<1E|dAu%}(f{MK_%B1*s3DY=Ogs zUJ{LLXQX`P(B=`=wZ2yGf7yzkkw#Vk7Tt^BZODh+3y{SrQU()+kg z)>04X?XHM}Y~l~!ScL|(?U7IPAPwUf1&HwRg>b-P96;cn8NT8BmSn>(KuEzW9MAHT zxts#EzkTikC|0KbNYh*w@^~uyo zGIa-)&<2ei5kB!<;*lLBBMm1IgEt9)Vn~5&7zYo?6za1+>`Rx#C@jht0|j6QSZIf& zQl$z=16;U)C3-2_bAwSR0Un4x135SJNCr;81#lPzb&!ius6GJ1igVGqR6suE8y3Vn z7Xmau1f&R7*nn%$K>vuq39LY<(1z-}K2AG}A9#T~0Etm^!aab(+$y~)w89s&1oNpn zIdQl);Ek7h3Z`H|kLZkphyVtN9kr+r1jCX7mC^*O}i9& z3z#yd^O>_$3`JG+4}6f2D3rnTz=%;}1uDG4YP7})BbxwJ2-SNyFYJxCPzgkY35=K= zZJ~$$_1sv0#tn@2~XgnrbDAjpDV*Z>;{Bu80b7jf_a~poEC{CubbBF^EQC|MSV?xyGR+N(YObedI=OJU1+f z1OpMrD5Q-f7>21F1_;m(An3k8@Wz##L++`=r=^_3ILSIQ0+mz{dMh1aD@<3Bg*3>3Tw##L)H-H3OtQ=dXTe8gH~_U^ z51z0H+GH`1EXv*FP5qJwvtmjES-4cXfiG+W2T?G^jK@7-ihVpqipUY(m>jiWjIMk~ zu-pT`pvGs+#4MNvv&6g~I04}EHF;wlK+pk!|6m0`7>A1~rgMuRDVPJL^g>+FxC-d5Ds=?pBC8wmgBzvRk(AbnV}ZG_PUlKsIb@f(>|qs2~rE;Iw#{(FdF!NvI1Ja*$CA*HIW(J#~UC zRI4(HN|eKcs%qDFjn{WP2o_A8ZopS|xH)%t1Z0whB*=zLWf_d9MF(&L4={%$_^U2B zgOS?+KT5Q6r8soW*cFY~!ovf{|9}iW;5(sP1V`Z5Wb#;cbys+m*N|M2GtfHjS`Vk) zuI^gas{J45%D(8@mj1E+p#5Ehw)GDRE{a&0iom^wPo9~h1C?D+`%Q>!ZqB(Mcl+y+{I;kW~?eKA%TJLFggbz_cuR1ok;lvM#;&2`<^?T*i7nb8#v*(DCqO^#py zfwzq%++~i^HP7al1~wuWJJE!-)erKxgJhuq9E9EHga7ml%?jTIU+^^v+Kt}x|3%;Bkllk&6}X6|M`40R&;&c^jpGd!*i;CgpdaM*2m!E) z_8}1d;NRV4g$ZbbuzVD;5Z!yskJ1%70M=i0YJ)Y1f?w0!b8wLeRvDRa0PVG1^2Oa% zv6BnVBSmq72PO{@*3<+Jm%a_*Ho%_G_1^idwDh&%8?N2(=)wlRJNN8J7%pE@%MXvp zU+o26+$CQe(O&d`mQXN)Y21-@$lvB|5eWvE{8(PZC}NQ`U5^-IDhA(!U=U~g;3XcF zq!MGqFyC{*;xpEpOCgW2AY!A?Udvz*_Wh4Vm|^QYYghu{h986+R9%MSsiZTx0u|s0* zHMKY?%egWl0HqIEbsePzVM+xPV{IiABI%6g0RTol;#$uUj06vdT0S@fF#}LqgsW#wjCKo4Qf^e4W|3z6v zhG``Z6~um@|Lx$cSe4SgX7GrBBS;qQ^<}Xs-OQ#P)n@H;kqO`sZT+nf@Q9ODao)ZL z?mzx$gt6(%4qoEu2Ht%ap>7UM;L_lR?&uyAyk?l<_TD@>Yw6bR?be*#sNq7fZqu!f zRViWa|2FUQM(^}i@AYQy_IB_0hVS^6@A;F z<0f61NEGl`W~&fy{&sMpWQ9aY00Xa#erAr>HjV=CpaDM)4R?+SH*OkcU-C`s2RCt| z^ycO8@C&!*cd>8{;_wWAapx%Tgcj+~Uhxyx@oN0+5UOWZNCJf54gc0~XCV(DM+ggA zm0e8WRepv4jp1$NV^*L9RuBLRfab)YpHNsi#h7Lbux!iN77A{+J0SD5D5iT9fO!6F zn8sw)4&N&uU1RR@Db8k}_!d)9l#&?eZ6*SBw&)!fbSsSUJ=YJihKge@@GQP&DE?>+ z|Nm@9e(gTbaZF|fT`1&Vj&O7F=BR)c`t@Q{)^M1<19dC)ymqNyCTacPjW)kzV{`M) zt%^@S6>lE!QEwX($89bL^zR<@U$30!00l zC|KqfH|AuQ=xBc8=($JT=;wh>asANaq3d(X=yUQ;h+=2+27dL8BzDmC@IK#mDV&T( zX`fYxiCzEmjtF#M=XY@9YCNv-Uf1wyS9X2>=4Mao@RhbuPjq?nWkwjSP|$~|MoS6$ z<#(URKzC$ezxUuM_ZDZFW=?kkd3Aty;zHl%+ZgB&ZgHp_>CUooHNf#1@AsN#v{N?- zWB&kQVn6axId&spblgp74u|x9ne=U(aaNcFN?vMkKV+y_Tl<9yPzPh0MqYjPcuwgo z>fQ7~&SFR2`D|w-Wx>f|qOh9r1Lw`M9UGc(-R$IC)cGaIr|00$-IQ zNBBi{5!9uGEVkd?f#{X+dpQx(N7w^Rz=USH3q8<*+vbsM9{1#)xx&{_NNO?dSgP_x|q(|L_<8@&70P z@;CqUNB{I!|Mh48_ILmHhyVDO|M{o?`nUi4$N&7-|NZBGfM_IeAi;tL4foDRU;xnl^9Z%&BuH z&z?Si0u3s3DAA%uk0MQ~bScxOPM<=JDs?K=s#dRJ&8l@P*REc_f(