From 3b44d73d64d0b89287499684369188ee92dc4f31 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Sergio=20Sastre=20Fl=C3=B3rez?=
Date: Thu, 4 Jun 2026 20:27:17 +0200
Subject: [PATCH 01/20] new image and wording
---
README.md | 46 +++++++-----------
README_DEPRECATED.md | 2 +
composable_preview_scanner_overview.png | Bin 361939 -> 511118 bytes
...le_preview_scanner_overview_deprecated.png | Bin 0 -> 361939 bytes
4 files changed, 20 insertions(+), 28 deletions(-)
create mode 100644 composable_preview_scanner_overview_deprecated.png
diff --git a/README.md b/README.md
index 6b2e664b..1ba9f1a9 100644
--- a/README.md
+++ b/README.md
@@ -13,15 +13,12 @@
-A library to help auto-generate screenshot tests from Composable Previews (e.g. **Android**, **Glance** & **Compose Multiplatform**) with any screenshot testing library:
+A Compose Multiplatform friendly library to help auto-generate screenshot tests from Composable Previews (e.g. **Android**, **Glance**) with any screenshot testing library:
JVM-based (i.e. Paparazzi, Roborazzi) as well as Instrumentation-based (i.e. Shot, Dropshots, Android-Testify, etc.)

> [!NOTE]
-> 1. Support for Wear OS Tile `@Previews` is under evaluation
-> 2. `common` and `desktop` previews are deprecated in favour of the `android` preview (`androidx.compose.ui.tooling.preview.Preview`), which can be used
-> in `common` and JVM-based source sets like `desktop` since Compose Multiplatform 1.10.0-beta-02. This library has also deprecated its support. More info in [README_DEPRECATED.md](README_DEPRECATED.md)
-
+> If you are still using the deprecated `org.jetbrains.compose.ui.tooling.preview.Preview`, see [README_DEPRECATED.md](README_DEPRECATED.md)
#### Provide anonymous feedback
Already using ComposablePreviewScanner?
@@ -29,25 +26,26 @@ I'd love to hear your thoughts!
Help shape its future by taking [this quick survey](https://forms.gle/jcvggBxv14CLqjFo6)
# Comparison with other solutions
-| | Composable Preview Scanner | Showkase | Compose Preview Screenshot Testing |
-|------------------------------------------------------|------------------------------------------------------------------------|-----------------------------------------------------------------|-----------------------------------------------|
-| Independent of AGP version | ✅ | ✅ | ❌ |
-| Library-agnostic solution | ✅ | ✅ | ❌1 |
-| Scans previews in different sources sets2 | ✅ main
✅ screenshotTest
✅ androidTest | ✅ main
❌ screenshotTest
❌ androidTest | ❌ main
✅ screenshotTest
❌ androidTest |
-| Preview Infos available | ✅ | ❌3 | ✅ |
-| Specific Config (e.g. for Libs) available | ✅4 | ❌ | ⚠️5 |
-| Supported Preview types | ✅ Android ✅ Glance ✅ Compose Multiplatform 6 | ✅ Android ❌Glance ❌Compose Multiplatform 7 | ✅ Android ❌ Glance ❌ Compose Multiplatform |
+| | Composable Preview Scanner | Showkase | Compose Preview Screenshot Testing |
+|------------------------------------------------------|-----------------------------------------------------------|--------------------------------------------|---------------------------------------------|
+| Independent of AGP version | ✅ | ✅ | ❌ |
+| Library-agnostic solution | ✅ | ✅ | ❌1 |
+| Scans previews in different sources sets2 | ✅ main
✅ screenshotTest
✅ androidTest | ✅ main
❌ screenshotTest
❌ androidTest | ❌ main
✅ screenshotTest
❌ androidTest |
+| Preview Infos available | ✅ | ❌3 | ✅ |
+| Specific Config (e.g. for Libs) available | ✅4 | ❌ | ⚠️5 |
+| Supported Preview types | ✅ Android✅ Glance❌ Wear 6 | ✅ Android❌ Glance❌ Wear | ✅ Android❌ Glance❌ Wear |
+| Supported Locations (Android Previews) | ✅ Android✅ Desktop/JVM ✅ Common | ✅ Android ❌ Desktop/JVM7❌ Common | ✅ Android Desktop/JVM❌ Common |
1 Compose Preview Screenshot Testing is a standalone solution based on LayoutLib, whereas ComposablePreviewScanner and Showkase provide Composables' infos so you can run screenshot tests with your favourite screenshot testing library.
2 From version 0.5.0, ComposablePreviewScanner can scan previews in any source set. Compose Preview Screenshot Testing requires to put the previews in a brand-new "screenshotTest" source.
3 Showkase components only hold information about the Composable, but not about the Preview Info (i.e. ApiLevel, Locale, UiMode, FontScale...).
4 ComposablePreviewScanner supports adding extra lib-config (e.g. Paparazzi's Rendering Mode or Roborazzi's compare options) in the form of annotations that are additionally added to the preview. You can check how in the examples below in [Jvm Screenshot Tests](#jvm-screenshot-tests) and [Instrumentation Screenshot Tests](#instrumentation-screenshot-tests) respectively.
5 Compose Preview Screenshot Testing supports *only general tolerance* via gradle plugin from version [0.0.1-alpha06](https://developer.android.com/studio/preview/compose-screenshot-testing#001-alpha06)
-6 Desktop Previews (which are deprecated since Compose Multiplatform 1.10.0-beta02) are supported with a workaround. See [README_DEPRECATED.md](README_DEPRECATED.md)
+6 Wear Previews support is planned
7 [Showkase: Compose Multiplatform Support](https://github.com/airbnb/Showkase/issues/364)
ComposablePreviewScanner also works with:
-- **NEW*** `@PreviewWrapper` (since 0.9.0+) automatically. No changes required in the Screenshot Testing library using ComposablePreviewScanner.
+- **NEW** `@PreviewWrapper` (since 0.9.0+) automatically. No changes required in the Screenshot Testing library using ComposablePreviewScanner.
- `@PreviewParameters` (for Compose Multiplatform since 0.6.0+)
- Multi-Previews, including `@PreviewScreenSizes`, `@PreviewFontScales`, `@PreviewLightDark`, and `@PreviewDynamicColors` as well as custom multi-previews.
- private `@Previews` (from version 0.1.3+)
@@ -73,14 +71,6 @@ dependencies {
// glance previews (androidx.glance.preview.Preview)
// supported since 0.7.0+ in android target
testImplementation("io.github.sergio-sastre.ComposablePreviewScanner:glance:")
-
- // common previews (org.jetbrains.compose.ui.tooling.preview.Preview) (deprecated)
- // supported in jvm targets e.g. android & desktop
- testImplementation("io.github.sergio-sastre.ComposablePreviewScanner:common:")
-
- // desktop previews (androidx.compose.desktop.ui.tooling.preview.Preview) via custom annotation (deprecated)
- // supported in jvm targets e.g. android & desktop
- testImplementation("io.github.sergio-sastre.ComposablePreviewScanner:jvm:")
}
```
@@ -131,7 +121,7 @@ If you encounter any issues when executing the screenshot tests, take a look at
2. [Compose Multiplatform Support](#compose-multiplatform-support)
## API
-`AndroidComposablePreviewScanner`, `GlanceComposablePreviewScanner`, `CommonComposablePreviewScanner` (deprecated), and `JvmAnnotationScanner` (deprecated) have the same API.
+`AndroidComposablePreviewScanner` and `GlanceComposablePreviewScanner` have the same API.
The API is pretty simple:
```kotlin
@@ -900,9 +890,9 @@ To write such screenshot tests you have to:
1 Unfortunately, Paparazzi is not able to always render screenshots accurately for Glance `@Preview`s without `widthDp`.
## Compose Multiplatform Support
-Starting with Compose Multiplatform 1.10.0-beta02, Common and Desktop @Preview annotations are deprecated. Instead, Android `@Preview` can now be used across `common` and `desktop` platforms.
-ComposablePreviewScanner 0.8.0+ fully supports this modern setup. You can use the `AndroidComposablePreviewScanner` to scan for `@Preview` annotations across all relevant source sets, including commonMain.
-For example, to scan previews located in both a platform-specific (androidMain or desktopMain) and a shared (commonMain) source set, you would configure the scanner like this:
+Android `@Preview`s can be used across `common`or `android` and `desktop` platforms.
+ComposablePreviewScanner 0.8.0+ fully supports this modern setup. You can use the `AndroidComposablePreviewScanner` to scan for `@Preview` annotations across all relevant source sets, including `commonMain`.
+For example, to scan previews located in both a platform-specific (`androidMain` or `desktopMain`) and a ui-shared (e.g. `commonMain`) source set, you would configure the scanner like this:
```kotlin
AndroidComposablePreviewScanner()
@@ -941,7 +931,7 @@ In these tech-talks have also been mentioned the benefits of using ComposablePre
# Testing
The core of ComposablePreviewScanner has been (and it's being) developed using Test-Driven Development (TDD).
-I strongly believe this approach is one of the key reasons the library has very few known bugs although it's widely used with over 150k monthly downloads.
+I strongly believe this approach is one of the key reasons the library has very few known bugs although it's widely used with over 300k monthly downloads (130k from Jitpack, Roborazzi integrates ComposablePreviewScanner with maven-central, which download count is unknown but estimated to be much higher).
However, some tests have specific preconditions and may be skipped if those aren't met.
For example, when running tests to retrieve @Previews from a SourceSet other than main, such as screenshotTest or androidTest,
diff --git a/README_DEPRECATED.md b/README_DEPRECATED.md
index d52da6d0..47bbdd67 100644
--- a/README_DEPRECATED.md
+++ b/README_DEPRECATED.md
@@ -1,10 +1,12 @@
# Deprecated Modules
+
> [!WARNING]
> The `:common` and `:jvm` modules are deprecated and will be removed in version 0.10.0.
> Starting with Compose Multiplatform 1.10.0-beta02, Common and Desktop `@Preview` annotations are deprecated in favour of the Android `@Preview` annotation (`androidx.compose.ui.tooling.preview.Preview`), which can be used across `common` and `desktop` platforms as well.
> After migrating to these Android `@Preview`s, please migrate to using `AndroidComposablePreviewScanner` as described in the main [README.md](README.md).
+
### Common Previews (Deprecated)
You can find executable examples here:
- [Roborazzi](https://github.com/sergio-sastre/roborazzi/blob/droidcon/preview_tests/sample-generate-preview-common/src/androidUnitTest/kotlin/com/github/takahirom/preview/tests/CommonPreviewTest.kt)
diff --git a/composable_preview_scanner_overview.png b/composable_preview_scanner_overview.png
index da2f918f01c4aa550d9aad9e0526abb883d5e49b..6b11e2b03e5ec73f8b57da290919a8db722af4b5 100644
GIT binary patch
literal 511118
zcmeFZby!qg_cx9Rf`B4|fV7}=N;e`QB5ly!-5nwV(x|`?0|-MZ-5rwB-3$^#NarvN
zFu%k7#C`w1&huX1=l$#bBs0^*
zvIc}9?Jx6%ketfCF7ZAU74DrR8WbmO9g%^|PNGWt861gv73X>G%88-M{e8c|)t>dc
z#hr_mdy0=Sq^RY$&UzoW6VFALgkve(S+pPq3w5M33i*E;&QeG(xkLJ$4`c7)ZTU~Q
z7*@B9bIqKIKMG}qiED;=ViJ9y#;woJ$=SbSFEd5HPsAWblum?t3T|)ihy-=4INmiA
zs{|>u`rI7pkRAv}l~bW~)PqMh_}4#t`t;EML3du{*p}9F?YEJ#`-ed}S}iF@=_?QO
z4Nm!7MzwfG!JGtUD!ehv_vj)Rz_ddBH!*3GV(5aX1^UljcZaMJvVyxOlwwN~NBchZ
zth6IO!Zgzxtx@h*`^CtO*23
zyOl7`owQ6V*8diJ_!W}x36!5Qzz+%vE@EGjP}L*l#O^8&cqm#0*=|A
z`dBEvmk5Izh)CYzsp8CZr?iqMUZ?ztq5BqR@5Ut^?)yN?5^~2Ucb~~VHn>sNDiVu>
z*CJ4YANTh9Pi`SR<+mDNZu7m1_{myxbLI(|C$4uZh9|aM3l8^CxJ_$L2|bt?JCo
z`kc%x+W3oR9^Fd<)@zTR6w1LM;i_hN)-SJrz2}BA9zh}JCucHD!gtFq+WiSKqitCC
zNd3tA$lUej8FL+}-+e!v`B0iC0bQ{?$>h9|ydhCx-ya$$7#(oSCOY?N_1$|xW{z=q
zEuurc)U|+Nf{-#wsk5lvzH_H-!Z4+jddh!``F5yASJI-c(-WcFoYz62vq7TK^=~)Z
zZ~c^5gzbrVQZ^7u+~E4Y_A_FyYftG^`5gb8{K-edXO4_mM4s>Oy)S&v@czbkyYCoA
zk$Ey%#Cl;y?WRj2#yq9Tp24RdPL+X|%7B7>AXv)2P`7kWq1MLP&pBP8=b^^k2ol9l
zpQ>V6pY>-Uvph^6Pk-2Y68*p;wmO#W2dG=6JAH-afb_uDEA5;Dp^nf-C?h8Eu&|$E
z=X^H~W)G$h9>uG^7jo}rxLi29Z1j?KhkA!gxOh0^ImsiNY`W~1+5OME;)>XAu`b6&
z#Wluz_0;x+#&fa2HB?Fb@FKov7vxf9=w=Y)8NOO)wT(B8$BZXtwPR)Y+Vj=@E78~9
zSBkF&zn!S7y<}ibVa>A7PRn%HXzm+H?f`eBS6aP3E*Q|F9XJ2xmA5~BFm63oH`bIl
zI@UO@F;@L;GGB5+$|lj8eMmE>)L=QhbI&$@nzOvN{Lmsj`9g|#f^VE)SU2BG^DtpG
zFQF=-I6>1UX5vwyk=@s-Q1`MEP1+cK*_~*+W#2GX(|1~QbK
zpIf@M|H`N=t88|Qb_+Vzq12!(Qp)ew(+*`~yJt-_Hm~Yx9;tU?9SDQc~h>%0s!_9Y6cSJ4ahn5Y!_eOp$
zkQ$Omo~aac<3PnlO^p1_RpKrU!4>
zJnZaIHx_Qa@;dPP)Q}d%NlAGA{!(F2W0rAN$w$C%a1FM=T*AuCdRmuMkLVnnkR(Hi
zH9ay?oP8Zyh^#iM4y$r=@L2G#P|fH5Rua(FKwT+nC3@)5v`}d}c}!oQdA&ZYKD*v0
z;(Ej;oP2A#YRyJLUExi>g;l?Pe`Cst|6JGXWbJ}U!11-h>)1F=R3ual9^G(NyCgNO
zVWX|ZzP7;_87ixb;C)52S~;&Lh-y4F+1=q-2#AfEjV;ECW>y>fjl#E(=q?%u$wjx!
zrkRE_)mxQ0KOYLQh$9XrYYggDu))^C{X%+voqK)I^0;zDrRsM0%*VQ{I_TN@S+vXL
znl^NvtmV?&F!Jhh9c0Gtp*S`L)
zBW&hX`ZthvQXyGUt-ejej_<|Xtrl-q(f4$})F$oh+2i&?4}YX?zik%Nb|!+PTE
z@Yn{_Yd?B2^_$1Ehl6|n?yvRRyG@hCv!gyS9u9j=dzUFVNras=MSkzS;!v9VPQ%3g
zOlARz=W3&yLq1J|-*zWPhjIy#wHL){*^)?+SS0woVLf;tqUT9UYv+UXj1v&P!R>~-
z%@mXaNR5rb#^NZ0bVToRu?~Y8!*z#;4xJ13{<)V$OO5l$gyEmVOtk8fk$!!stjmpc
zi_WzPu8#)#ksQcyr1p9LicTB+?QTq`Mpst{)lG}Cdr}YZm>y#6Rbg%rXI}e4=O^s6
z_|id~WoQiE@-Pt9u5kg+qDxiefBd3Cw!j=incljBG%QM2r9#Gt2BWGne#4bkY`Rs-dCI&{R6$aKnuTcg*uU@gh`|6&5d|v+)f`J44
zcNchje!=|L)%cuWuK(*8=P~dd#uJUF3JSodhKaM8nZ1jpgKLZ$S2u9trsFd$7Yq#2
zM_2D_3hEE{fagzHz0`EoRC*y|;$X*VWa?mS#_4J2c=a3%F;5ZT(9X=&h|bf_*4{);<|Oq+fTShx#JK)FYZ7>f&9tj9i^@ty
z%HwXHdiw|W+SjF-EGqvH{erk!^i
zXQy(KjJX+O`)?$ClEaH#V0<`@^^COp)B89*Oa;34s-I%9q^0Q+?MtF4cN%{raOgOz
z6_2hZAR5=6mvIEy_4hUMGW4%az2S9P1H%EgEY2GsezFKobpQE>|
zef!h7H%#fjlg3+MP!|7{`~XS(J*YqD=I@#MheiCYet%lg-!}CR`}o^Y{Kf76?I`|s
z6#o;Y{Ou_Ib`-zC*S{Ub-;UyMNAa6k{1M*$jVS(~Llk@pUrdZtNP2?Tb?P}Xp;=FE
zjj9LwN@O0somMLzGch!AP+WT~^m~9Fn8Zm}BQ~0j0ay7GIsY}fCMLB^871mE-?Az_
zEeL`P>4!t*tJ}pi?Z_D?Yf(wPjXjM$g1uGiW;j*-zE?hZWrCU4!8Pf`9a`5D{zl_-J`nejo
z`ocIa2QRK}c4>}KpCm#>l(|g27v}s?k#`Q>p|cDPsLRNAxgYu0k^FPc0#h;H^`>F{
zPuu?ImE6|?qY-*et3C$zB9ygAkF`0B`EDh|Fjs<>Ct~#O$M_EyNQ59G@C4vHX!x#By>r9!7cNqySN)}EbeKd^M5E+-iiY6judPN^K}P0AP`
zQcV?X{NS}O;-m)YGO4tPr=;{->r#fOdv|o90q}`bBD7QA^6+M#wgi_lY98MNIvinA
zq3vTm;fwb@nt-4yMq;mj%6GR;e8w+bW`m#Rr*s0*G!PV
z#$qp86-^BNb~Sd9@6pIPaP=lGr{Lhov%lE!UqrwigdOdk8
z!g8q%ZFI`zQCZ$mOrK#!e)F;J1KKtJy-ZE#lh%*%9FpaB!ZyZD%fxTG+7{|8evw&Y
zqj~&^1~B~>t|s%OzgxxCnHNP;we{iy-n(qZ`$@f&fm6eBj|J#KgW1LM%LynC*@D`G
zz_B{9+RewaoPia$a11|j@aD`RX>iJY~f<&H|dUb@<>=1HBwQ^kNB{Zj)b3y`Iy4zM9
zAuP}NY;m7N8=9)4+t#iC
z_RC~6bxnQvV8_)~CZmuX?z`Lnk=OZ9MccTg%*p&6ztLEF^?I}$qU&y{V`oVu?I
ztqd=)LwwwY(pF!>U|Kv?L1@|tB*g>9erIy%KaPEsrj~iY8^s3knFf;=j;CXGlO6I@
zm~j_*p(ag`3@Pc}3rvM%i7r#;LTlHH6?`6x{u;N~Qg}ccl!9EEL0$AuHT9%b_%rqW
zd(8hn;2y=s0$H39|Gd13PBv0sHZZ#yFSdlvEL6gLtq-XSCH0ndUKI9zYjQJ~I|-we
z^UInz^15}pj2Z0AqkNIh6&+;Y^#kb?=ks~DUuri+Cy71D|3+oejCyso95Gl!ctq-WQ^CEt
zb+Dt2?Etq|1!qvd4VQda(mA-s<2NTC_=EV4Zkm`4?|<+;1b4f0-yR4D?ETX8K6#*4
zEXhlrB3)iPT(fQRrV|1xOngHB+2>pSoXBmz?VCc32Y3*I6kB1fN`6ikwEm)1MRPSsJK7YwlArC502OQ$Gv`Prt9*{f
zw2K!>HiI|ZTqRh98mcy){o2p+;xh7~7x5}T7P>hY#F|{g=T6
zDv+!vPTpU;7=FaF_5qt^EaiJ|eRP4FmuZ*d+|e4S<4k8_%fJ2+ZFwyoOggTvXJec+
zm}JQ=eUd0U+L>hZo1L=HSp&yGw%(dsb?z4j9_&Q?k1Bzy-MM=X+FGyG#k7m%Ij|Gh
zF51+#i}@sqUwu>C{?@L#D>a70#`9P;Y_agV8s&3ZWC$by+AHDUmWOB|qb161I6Pn1
zoGLH3^8%UYLr79~4QK^@Peq5T?d26CZ$1CZ0RA;=Er$SBk!+6Hy^9trUddNnWMAUYj3w|S>$=qy5rU0zZUKeW*HPU50q(gtDkJDEZtN?bDPqV@Jh+BZsYs=XkbnyhGJby|RXv
z&LcCrF06F$KBQmja7AQW&?e8MZ>mJ4DE1E{Dmqgny}b%*ms-b2FI+u+=RViQqA`v@
z9zY5)Nqy+>#1)1!+`{Yt{PfAL0g2+Eun_;X$ut@|>;Rj#%9=xs$xg^ZBYXqib*fd$
zYooODAsUf7+-T~4#GXzjjx!K_GA1^cq^~vVJW&8vsa=t~EqpPG3(s+Mb{{K`k$mt)
zEWyn5$twF07(2Z@1~GOZmW&M^ot##qrV8t6c}7sM8xeTRZy2?5vhHWAxaDcALtyu!
zb#*&PO=*F4@MFIp01m^Kq3-5!-ZPL(f@O6J9Wnp@r%t_HMIRP9t}ow*@}qM{d{3kt
zYj1uCK|k%+Fnt)fZ4h%pyDan}+AD8t$mzJ?@lDEG
zM{ysj;*k*Au18UStL~h@5o|wsMF|naPTq`fw2{~M?R?_&tKNW09A{AF$zG2}wbt{%
zeQKMk&RYQo^HV27IU!vd3rA=dfX}QzpX7*UB@+>N&9E6q7~?6_v#gnp7KT2tsB%c_@S6W6MN_F
zoJK?kW1i}Jy~v{3$lVdge?}ILsM+M5?C3$&v0*2F^HJVmL*tFG7+(SINWE4`4vh%|
z`pm2M#ZUhY7{yd<^FGFgK?TRkC0Lihf%=1v3ZCClS`+F
zOrPmFz)<70LHIn$2S4iDdRWTq9cWn^QiG$)>0C%x24)h=@3q9Gy{cM{y!=`)}
z>d2LM#Sb+v!y(J<1|otY8hP~zMbmz!fvdNw#YqJNj=}*I-2_6HhiF7^7!E9rxwy~@
zblM1jVi)Y&UgM=#%Z{zZfRG}Mg*-z=N`#wWQ5Yp^t1Rz!qzwF%R_Xf6b(6)7UJXYt
zBRn<_xl+iSP@{ff_KhV!@%*`(__cGUbm_j@u|)9n*bO$G3OnYi;u-SIT~Bs_xl5U?
zXHk6}C&u8z*2(ry<+sDUA0=%au#@1csoWc=zJT4^UxyKPS{^f1^GmL+G(ABhYpE-M
znWAhhg>I4nPqBB7nLUQ(dxF%z-#Z}6&dL&7kL=FQS+qty6FcwsG4`C5qB>e)fUJEH
zR(r8V_8gIyyJy#!fLVj|(DxGTqM3}Ol_GoR
zWTpI@oiL)J|JMikre^w`^RaQBno@_DQeSj^Z5hMGGiRwTXJ`Oxn~x6JjAHTq5(;sEc-<4B@T{
zVD@5G`?QE{Mic~lS(G5Ha@nVJnaP$exuACmfzX$HgVKBARTEkr`+B8g&!G+fLC2P{
z6TmLdz=wem^!PucC*&;}dM$s#_zX#zZ92YaxW0wgalZ_>q(V%!g7TORIx)86e~*vo~x
zhK?lpOb58Ho83A8$uZYslcxKtQXx7uj9bGLGlyP3SL!{UUpOdLz|`^-KCmizE-o;4
zVJdcXTyMO6D@MS|wGCY?#H|m+iTgdZ(P);#D{v6`*&qfvcY+QRN!|Nw&EE1yh4VZiPr&GKh7|9W;pAJfqgMsG
zJz}iezCVbZT=6&tC0vbG!nF*AQ~6j+&x!MrFJD9aghAMeo24el6Po)D)tx49B&LqM
z2%e#_&=!1PDQ_+)G3+4DP{~e91ly^SGxU0C=%t%L+{g@~C<2_G
zTi)Fmy$i>JQ&37~fZwi6sGIn|;L=}(Wpd|^F3t4>4fN*qwgrmEE@9$D1)tzG*%^+Y
zf77jb8_D4RD@*A77L#n(yCM?JB7An0XB7xCi~e4%L|@NYL$RaE`lZ%lC{g92
z^&!(^dUVh70o=uI>mvStm?3WeKZv_?E--Pgf&a^ua0Gc__E4G04Bm?Rp|cF(UNm%RsR|v&GK6!dDR4A{W=Z$$uaD~UZwVt0w49Rb-W`c%T0j2EYqb;J>b`B
z(Z|i&a?a3>Lm^#o=Y>K*n_#-%39>VO-D-;K;JfS?WR?tqi=y#hQ)CX
zm%yTRS(@b_Tb<`0$89kXZpTkL?s6IkcR@7+N!&zGxMwuzJBlb_z-ZI~ib35Tzeyk#Ev`{$SBnpOkrE0D6zyf8fi3
zjJH$7k8JP~m{9KYEavJZN^og|7
z(nQC>ugm~vD0;@Qphe^na56)_aZleqxGfch98hl;A}LY>%~7e8P#mIY@M
z;y`W!%G}W4V3$7rJ6rIA0qC7o#r*^{wB%cll`G`CrOn$%)hx&jKB?gU@g#d|1R?TJmdB`1{Np@fo9$V
z^NHL-sQp@h&aw(-TqN`4q~PewPx9ugb!dJoCBeVV
z={IcT)KjldrKjkfNndb=X^ezdA7)Fx#F1ZW3TS-v+V7$$?{wv0u?haV&ft5!W#PZ8J3vOTD{Zm05;SV5FJ1
zMNDjn5|aN>7@uFXlQXt5fJ@BI3Vc!o>I5^8W=WkoI@2J9il&;e@L=i$b{jE15^#v;
z(E-lLU?St`g-z)Et^clPX>aI2$?p`mQ->vN^efy3!+i6}E3K`$?^XEeSFc@|<8iNP
zycL$)D+$)Hm&~=AARI2G^
zv@^V5J+YFzCsj|acv79&_3XWsyho+@WI2EK-SOeAbk{9kWK!YRd=LI=Vmf>tbNLe|
zxXqeJ&gFt!%VU1-H=&^>j5VHi%q)BTnVve>MZqW`fHEbKJkpF-Bl1kSd6I)ra_9ya4!DqyrLS39y~9
zk_NgN^ZsbvCh}u#HxGJGT@&S%O!h=@aGVED9I(Aq)0y;$;~v0W8ZG!r&;}p%Or$lY
zUxsZp%YlXUQi7ApZ!FtJYI8JF(AsP?Sx-Nk-iTrVQREz2McOvxi#Q{swTCSU;JY7M
z3scl192bh*l*hw!)*28ba^id0@?9Ivh)>M!2@ru#X=*ruYj?V}K{gDPnuz#WlMawW
z#IKfa7x0E1nmNIGe67`N@Y?U=zJ|#`#>}Uku*N6dn|(5%;Gi{t*{M~2xC8ifY0fM|
z=h{LlJ3G7K`EhE!`PAXzVIn;}J)Up5qIDL>S;e!E#zyhy*~SblV7<>OlM|Z|fDN+2
zif4;|PC%F=u-w|ZPD>Tu1ck284^v*>*bEE|T;JY~$N(T#WTcF{y*r4_-eHi=tGDv?r3sYQ
zVYxA32Uu``NkNlu$02w_2i@fTr@|`BBq>rXj+`&f$T`_zsCe$MZbNxgjhTi7zvD!X
zZsBVazTn96&gH5TXIFRk&Mo0`XUKMVGUAVCms_kZJW~=NYlu`t`I-^od
z+Cri>mOH1)%xrAu%Q()ENR2OEc|`93wuv%hUBTLPK#X3Hg5iS2u+h!rC5{iJ@^oY0
z3dH5f8}QM<;d1O7YLIP68uVvU>ayFIZ)cs41g`)1E@#W?)<5KeZd||K42Cq`n
zjccXnKZA^?M;?{B{#ep1v(@TL5*6*~kd7O1F2iuHDr0{;hx;%$psduLcJR~{uA}1D
zCmk`p-?zFF_tYLMt$fJkrOeO~+N_`!G2m<`DwgC?
z_FBVM`!+s$I5T76HY2S$RfFX`J!o@Q+r0dFvK_Ke%f+8$A$fcoovoyC0O=ZAA_H`=
zlG`Xy9go#xK!+;3XgcbrePf#JI~^C(Ys=5GlfUOwj^)h};ZVC8Qn|NhIGyizb!3FH
z$6z0>b%Muo=JYxFwLh1?GX41dWji?gb2*9$*8Q$utGl*_Z44Y{YP1R+>jPthXnmG`
zcv`~RoKP2p?a3sT&{98n23##p5FA%l(5JLkk7F=CmWI-7;@X7;oo@4&uu
zur7PR29eW@59f*qtl+o_uCz0hdeCYr8E<;P?l4K^KiRonQm7#?J^;@DUB@l3<99I7zD=
z<_S=Xn-QTb>?pL>8u%X8*4FlM5N5J}4S#uxO8UT(*?>pnEohiXxdF*P(TF0$@a
zs2wZPvt^Uz$IcF|z6B(>M?4vy&)W?P)HCoKPV&Q>FkG8nKFipZCUBsQw65~l2o+y=
z9a&XNt@g}l@0X*S`t?2_V^vUZ<@U!ih=l0q8y+{IgT_}SAA=3z9$jd}s7)Ws4|ng=
zBBypC%Wg4bsf?;(JWb|ji;0ZPqI1xp@;V}N8kn|dcj}@g#^KPRa3SM-W(1oXHG(PF
z>!#w`GPHx8e`xUu<7>lr)}tzICOi78=ZLDI&N^bJEj{GqpfN$yZP{yBboZosx<9D!Fhyf
zLF2~ox}UGkSP1LKN7J(!mR^@mIPD{3)HL(Gt1@mSpC;ld5~)>gngYVgPfQ!VBq7l!
z-n94SlRLXX`2Z%37X+sgV!9$2`y`DN&iq~`R*-Jn>P^#<&!Mt)mI6^V;;epcDuvTb
zXat0tB^?t)C@RKA<@7u92hJGIVIp)N)RA&31ok3Wyi!yaTUSHb%UceHh8+9S=82iW
zp1xq09bu>MPVyZiW{Q~*NMq@VT={_n$!mYkJ&TY;Bu=RD#aUD-JvPXp;WDRY`9#!Y
zwrV?S&zaQN{^TR}kj8U?5M)(X%c@&`se8$^#*38wG9NwHvnNgi0G*w!wVm%&$8UtR
zSa8gUi}?usc(n=xB|9|Xfya&cT3&;-v*y)Z4JNlgv<3Xi0Lf)bpb}ExDI6V7#O&
zsUMY@NRf`5*!eJvS`Cd-JvI$qObK9;L&N+I`2uFTnnHojN+a(w$Mp{L2Ut}c_bJ0u
zrF)g^LkhEB&tzm|tZ!_Dj}8cN=%1D0FV#SzKOiDVWrb}DmBtAwFNB7)x+!#Bh{jh+
z%tmuOf407I>gSgXPqA-!gq>KOy}IE{f)|`4;ZmzR({*IvR#Hr)Pji2YmtVsddhfv@l}n5+dDq39meWscdF2_3
zbPHjP%fk5#SRtEW=X^Rs&9-hcY;5Op?t(qL$eGG}*vaWCZEpNVCo(4;l0a(}p-2tW
zytu#_kuabPN;w%!Pfrj{{+$#xY$gFJ!nmr(mC#gWBvJ($*NWGXaYh)!3%autpymP*
z=G$djhP43H84!W@d1~RY)B5zOl^PCzXU=)JdpT0nP%Rp-5;!T%`gFh
z(K`9Vns*@iEiGavyk`0Hn{30=!_WjuRTixJy{zlY74QZ=b6PR3uTOoP`YZ0(_tWET
z#N4|f2=AItZ+uyW>J^aMal4B-I;j7?7!6W?@$@Qwtzk)!K_fqdJIobk8L;b+x#>~MH6^Q-91c-@
z_BD;o-7uzfa$o2jb?WMP$Dd}y;F63_YGDMEi
zOt@B>leMwUsh`%Dp-Q5}sCbP%=LBkU*|l+1Kxg~j$l}-G0`6$8MZk6pO;n2HSy0~5
z_C*tikdYNcuinH6zEZ)NJKv8vYU7|!eU;}Lu6FOz->oJ_BZjR(po9r|xKk&H1}Jdc
zWv+6Qnanf;LSF@a~-Ap|Ehpo~x!=dNs18K9M188IL?4X|}W
zF6a}-_^v^Dwh@W;13%FC<&y_j>%V0=dpw%;-xW{`H`&3=Y_+ZRo{<109d)y;5%SIP
zd?UmXiMGU6Nf4y4QOOX2{k~k)hNp7qc1&b@GQUcDHppMpfA50L#M3cv5snGkov$9H
z%J&xj8gwySy%;ujR!%I5*}
z+Xii5|rQ{0lO(7UECcNl9j5g?L#?DHQPX)B=KY+#i6`8Zj}M@ctz)4-+S
zf->K`(dzOnRax%al#&OHQ>Esc5Bn_f(9HL!4uG1ycVouUxsBJDK$N|%@2aZtv=_p1
zF2=`45<$ulp6!?t6;H#junjv$1}+@_pJ{p4vlP=#|BMQ
zgoVCBA|f*yt3rMzner42lop;}ByR|ar6q%K7)6%i^a92P(@1lh4$t!lwh4MwCZx-L
z9_R%G=!xy^R>ug}h#`j%PMy0Ak4dSTg;;}l1#9M--R0*_Cf{__>Aa5dnvM3`OaeTn
za{Aa$XU_B(fKBr7`!(aap5l?chk^>)#UO6zp&?8SX@SfR6i494T{H&r0w+*9U)-B?
z7mq{UW#%~$__5m2L}{pqK7t;trbmB{mK1o-Vwr-SkfOONMt#a?cPltfzv$Js{q~vT
zeOiOd!I~`}kYJ=@wmR`dEas5a`7bFT$v*JCH%N)x#W~cnf&(@Eh-b5%*IB)rO$kw16_`&=yg4m=a_s5qr~dNXvd=fQGR9bH7}M5
z-IR7M59L>uZ0((*>5(?j0IRW(uAzpMgC)g5arS{z1Fjfn6}%Ib))^-1O{N!#TmY5o
z^Kb{XRJh*)azNg+5QFPfDy&uMYE+
zmG>#c7Bo8E{BHLDr*N?Zgo*Hdz`|7h;a|T6P^V#83xtmyQL6jx(g9kdR;1bz>tD?F
zPYgV58ct;`WO=Zy%i(4TaA%E^g9=}~7ZV!ajxX3=cP<2+9Xi41;j;496$9`3iABox
zoHOpUi3$iNgKXk?-a9h!?YDF8BrX7jX8S;)*aU&rw5M{mbw1nr
z3omMOIime$lbrfelw*2Yy7djJCDRfW7h!IK#nC#K=Quob_3#YDb!CIJcMD{4vke2}
zg;9mub@!tIXm8uJ`=e%2rJ2?*#=)jDwi8X>xkLrvigrKGnh*ajDlA3?I(|A24qXcB
z^0i!n6%zMU!?GIvVtIhB{H!9*;*X$~BLmgAP8CdokvcSt%e7`=co+fz27%xwxpcTdbOUug@KmppA4Ke;gjMI#`
z@*o+0=}G6fQ(L;PDF5zG>hv`WS}Kdnli*>AW;SaEq}(m=yaZGK8^&oOh^6M>9}5
z;C~$5NKrdAPHKUIvMs&k1$9{x`^RjLXAMfQ*ywSREw4(}vrp*OI(Jr?OQv*8{ytV-
zpuW;;b-Pv+4U14RiK%x8lId!YjS7Jl5P8wdlWGq{gY-^6k!W8c5+wtaO%cO4Z;O6>
z)SqWlegeCMLQe;a{TZ5$icwI@8cxy(Vgcr?RTwl%rL$$?7E%3)=l7s0!?)@>JOdYd
z9i^vZL74*g?0N@la&>1S;!$pI<_>E&4Y*tCu8K8#>IY)HKSs>^@s8AZ!{xqkKlwdwYq6{6pDroDTnKgln8dGW^iRx
zEL%wR8cr*MfXyd*BnW4#U!wjq~D6;S~WJ*2mmsZP|p<~c*ov^1$N-)eehGV_F)GRj)XK1O;e?Qh{m}n
z69{v%GUH>-&eMfxB@YSV#f5K!0{i^G^M-+bK*5}s!PFxgG~oyL56tWVt>JP@Es~iT
zCaR*|k)>@(RDx&QrUCIs3hzw~Dmvizy{!24dR#g!3n>JlzBcE_T_{cghZ!nZ
z)y)vlA!5u}H;h_E;_i3`30-Ok|BS`?K(N!gY*!A3qutDwd{e9g->!Yb#s1WJ%Nh9w
z^^0q>(ym-7#Q4hk3EBx{vJddy
zqEGVdt)}O}h-J#;$AKR-KQ{J5?{15y0(*%Z!jYF7Ie7#GlAF=K3TRdU6u@#rQSd2h
zG)hALS*mo7bUuPGoV`IzJ6*Gz*G7A1Vk7Vjn%oIH;U+M_B3|ZG5<6Wfl
zFDC;j@=w*0wDe2l=qVHrcW1}iHNI9UwyoMAs_B3ISTDvGZ(!~D4|~4G$6f4Mx{4ti
zgbx{KNEfzzIDrj5@E_a22A@mwEzQR4={8CR9%HG{d=w+K1dc>
zP#dMdG@_o&&oKy482-nTP@-agScJ(#e4-vhWvF>m%L^c?o{9C@X_S<>ENzY&k10y?
z^sIduepyHf31}mZdc8)b`8~@Ixu>Z7K?CX*h`W~+ma;C4tzJ|&^*THSwS+7^JHXL+
zdenX?v?9E=e+wNrdkN@cvVEi(I&g*;80{4SvAMjKf59)Aku$=+H#a(ZulW+y$jj-w
z;l;yVA$D&T@y^A35#}qh*&6z~!{B0kq4PRioV#?-nSwiAyV9e;fcoidbwYX{Fu$M!?k|tUg}ip{Q-|g27TmL5I%>>VJJO57ui8=
z4Jt5xA4Ch(H~Q5Yi4rzaYZg&
zWzTNT5{0cUCa`%*?ksfq7u;XGN}|R{*QDkH8d%>16p%I)?||LV@S&EOQk({nMP3n^
zF0G&PCIONNd~MLXk!E|_ZlA6BL~%bP!r^su%W7{a$!1_?N+5LzS~3>!W&IB5=QiNnuIuLgj+
z{l(P1(qE!*SwGYB0OrRqxbZbK`q{}0Bs%4|bJ6s9Y5}Wk$U5J~y-(X$bw&NBD_?L-
zmy4-VZ?LZf^z1~iYZiLI%R^rwM$^es&zPPT^s<3!a^6+v{8%2vSYqj4j}ht@L8JUx{j36^(dvs)3?_BPi`R
zG-XXg>Vdk}&vw8bQm!0AUxq8d*s)#SrjujVl|t|amnFYlKa~m(R~e;et_6{!tLMfK
z$S$r2?PsG-y?tR3sE=t8+9c}T&SLTtbz&8MHd~s_B66d=kEgqg$kOlRHXzTt(+>B=
zWruw#jF%}McuJz
zZu;{~0%5doE#HozRknIqTa1v{m8ANG)H2Z}=&aV;Ha1~TXgY^y^k#=KbEB*BZvPsPo((V?5eu?-uq*(#DwA$>38%)1D32r~^gKTF2X^;X*U3rcx
z1%COhGLhH9y#Yn&&!j8~%OWSzrXgIesAt4yAv+|37im+cpQa49_lWL>tK(J2taZ;s
z+b}ScZtsU?>ffgsyt7=FG8wS(T&kn`o+1h)ul-&LUDi8
z!B_9)`vfKjB%@JI0gD%3FsQg;|KxOzNrGBuq9{tbRH!KFFxdFWP8*>0CZjjCCPMo_H0=PyEy^9yjhHCX_X^bSwbHY@T0Lje+-EEchqb
zYQ#9D$ttz!E_CB&BAj~Viz8nx)H2E0_=i;`&z=4*LJeRCk=U`1A-WwIjIZeM)2@;U
z<)qZ)mD>EB#PO6gG|^89#UD!SwZc1|^n!xRU<&i!6;jxbTjd@EgJ_{8!k0%+11P@H
z`f@+l+H}U#jXv%s!vhM$T>yJy{B}yS2{RFq#DAW?->gs5%Oxh#&)+1s&!e<%in&a}
z>{iv$27=zJ4p{n?7xl7BIJ_54{JbT4MV$@kYq6j)xEx#(AXhs0DF`w*JPst@-G;0y
zDYDgt{ntDK81zp*9cHFUXL1Z=M7xCzIAlsa*mmHLXGd*jFGM(;AA&L+HYb=(7hya!
zT8W-~kLIc+_Z?r}Kz4c_PbqV`Rd-?2);?UNspJ+<(Q@{(ofJ)JF}+DL`@GbwW2R=+
zZ{fotG~-9|gxK$5#>#mCpopGzr59+_;sBe%uD6^_c5vxBM87yv*by8o6&ez<^l8$7
zYS(vCG_w&R9>s7^1R*Ny#Vb%3e^{$o3E^tm+X(oeQ&jV~EPQ)Qi(>Pm9&d%8;!#zN
zo7cpH!{u|yriUV=uGuB7eg(a*5`hZD-DC$mBZ4Gv&R5?6yRZvC3lxW;k?xDD!m*b>
zQb1@HY!Y0cV$AsD)6>i;sBlpgjJ?8l=m}0Ij^t^R(9zygO1moKUX7BEpT*2b^=VjF
zmS#kEV*-#XxyxapZ}_!A<)pAuDp4KKX1<%(D@7d;C@sJfjF`Pj22WXf(ezTJDjGh<
zcHW4=q`#ojJG@jhS*DKh(Ptt?moe11DmZ$y#fWBOIyV9{stP8I?@`6^<{QsMi<3D2
zpOwbLSpS;m)UcZ4Wy#1;uEyR&
z5!qQo?cY%3|7o{oqB>B1#bM4N{xEo@4wCk+*F^lrjT=i_E`!kv$oYj2UWaShcMdfn
zgC?oNh*1SPd@gvl`xJ80K9cJXC|NyEq@}avsSVn!)V2*cSj@Y9n-4{*(Q+2K;OzzM
zDT9nm2``?l;!~Ca!Bez)!TGOLCuD9>)Ub8o4+tfivhG(xwZNt+?IR~}j5
z#pCnipj#SZ5=He!V+h#0(B-p$n%&QI84T|x!;;o1*BEslW3SOwAROqF<}5me#_#tJ
z20U=Lo&KZ^iZIc4k*MS(w4J`=N10B3Sjpx31SqXOl<;+87xU8c9vFSsbym_mgw>?-
zMll2S6fy;k2juIZLqkOsS>3c9(5?d@vSH{n
zk(*sF$8_$7grx+Bqv8zmINsWK+XY268L(EbrkL^n5%!f~aW&nR2@nWDg1ZE0+}$-;
zV6t|7R)ySuv+oZ#;6?rzh$cV_Or`M!7NXLp}|o^w|1+Iy{4yH4Fv1#vYHF%uN-
z+YBrz%9`38+ky7TfVS&v;nc!spy%E`EhOw(fXRQ8Aw$ji^MZrfb5CkW7LaxJMdB}s
z_vU>!2F??49
zw0P!=F$f4?0(}4ZrQeVL`QZQqjDUbnu#b>|T^^_o?}QK@9xf^^-6Jpk4#w^77$}*y
ztAnV;a?9?xD9B(V8-x}36~AY|+a1%NRJxwrk$uPF$WD{9kY?aUqIY3^%#WTYtk*DD
zy~9GPW7tJRfUIvt&ba?*fJfx^@Cy*SGc26&Nw)*+YB&u#V3tGzy?uyE3rX=NJ*8E)ObzWSj
zaK;cV+Lr<_vphngkjXw-a6Pr$5F=uww?kVXfUX#7*iv1BZdoEMawG)*e`
zy&SI8cnqaC;j5p`Vgj&jUM&(6L67^OSv0H0-0t5HGPbl7>-p7X428_h2OQ%D0oCF>kg
zEyj5kK^Li&_Ow2^SIbHV-_Apb>#Z}6_UmCx}2~taN-R@zR62plDGs$
zO0M=Uo9^PR`oMjhtf-CxklybfZj#MJF1W(KmBvnnz?mN
z?uwefnL4$?&3YfXq|CH;3Ig1X8F%-LFopt$$@o)0i(O#($Dk3X67Syz{z8R)libf2
zo1wJ1HFYQyNV}lOqFF9SQ`k4`Sz16)khhL+l{oX?nbb6;irdHO>To$0Nr3SQ1@cLr
z=cgG4%2bgD;=J8OKhW+y7^?sCLkfJ80gV-unAj2Y|6{1c!#=bYEnSET<~x~>)xgOG
zlvb7wIL?pv`mVR4(^pSc)yysdL%)m;^`&Wz^lhqK(_9zf67jaCn1S!qQ$$8QDU}#}
zjX`X*6yLmLS&~%I>_81Hy%!L1>b;|LuzElfc^
zG18-s#du9gw=4s6ECc9xKWy<S!y{L@*Hm_Oh5AY)p~S
zPF-3g`iPS%v-u#X9F117s8ra%*F66-1c{t~a@ai))idco4zx`l(r0K{0xE(}x|ift
zsy|~l%apKhAaOGu`lRV~yG@Y1Q$J0QLC8z$QILMB&07)uX_nvoC4LS|!9JwA8LfZ>
z8Ot&pFsCNkRX@o~IXfR6SE?kaOOy{67+r^*4JU#!)Iy&^=2i|)Ub!Kt8`^%DcCoVd
zyh=sGs$)BZbyB(_ygk`?PttZX@S8rl+c@6R$sM?XKEzAcnBq7edhZUE`6(Be6e-wyb36xD}j&hS%dN
zh;3a5gisQ>VfU!86Jk{jj5b#h^ztC~3}Az>est(^2Q_~&B6Usf+jVpEESdaLDh4O-
zNUilgooRb@F=^DXBKyNXGH}#P*wG8VtRUcnI*|GQiwz1i2pe)dX3X0E2R0YqfAncs
zszBsSwXzm2Z~zOvQYcEXv9T}P13N;SuPXwz3Vp+;0y%5grs9uJSaxPIyQ5R|$w*9_
z=j6T*4I0U0Fu+Cb7@)zrw9F@T$shwMmxQ$?CD4I9jR#Yg4*qInZsHDL$Esnjjaq9!9Q=Wdb&
z52NjkU%E$|DbQadLlp&AaBa9
z4*o1HK^i@CQrK{8R=XIs69?eB49(QL*m$dQ(ph3CytM1KOCSB|3!ua=V-K3@Crmma
znTs2TOA|W1BdhQ%5nY)j5=IZ~Kzya6%lS&k#E}HtvRbrTZdd|^KmzyH>kc;@e;Uol
zdE)Ublp}!3kjmb!#0wKKjq=jT1m?{ky9>to%kC$I#CReAhHY{q-#~M9!I#-j%{NCL
zhjQq0|Gu>SS0>GpM?$b|md8WGjQgkHSPJCpkD^Js9tp?eEF~}LU;f&*X{#whjlCs;+!dotK^cak?`3=ehU0S1)O=
zV^UKYaq_Gf((y;61ZU+lVOxCy;
z)%EpNO%^q*IU|c%P
zioYRB{OW_?_*oz~j7~UE4ygpbAO&(Je!fS8v}SDAKF(0uk8c3^fP(^N{@o~Iz{f$@
z*0r~sh<13dLi#c)Ka$^+UC`K;GR^
z=9K#@SyMh$wb_s>w#LRqvm25!k4b3yozXA?4})>uq1#W}|8us%iz62?5LT
zJgOK<{zbrE$BJDJqkOpAQhCe?(i;4V5M1BSju;kVUn?BJUHg`6CcK|ZBXpE+wPsXH
zCw0n+WK#k5TjTn2u~e(cA?-r}5HSgrl4&8Z-@m|>2j>}begSGUOt~Us6%RDxdqi0C
zzCb9|5}Vj2j~FYUXA0{(3K=h1Vut>W(%+S>jtErGmJtgai2tRWT?l_;VT4caVTh&&
zAR_`1>4g0S@GI`gZd68%B#a!BB-if>Z8}7#h+)wsn(H;=7<$jT)c8
z&=Bb<+9w(JCjLYR?4we}R?rQa>znEn6)et0l(MT<%2$N2T7yH28dYLE0{T_d&*v;@
zgj1Lkn;mBMiNyvA6yZnpmVF*CcTVdwIU|CK;T{*<)TwKHjJZJ{#uZwZY7;c-EGUA~}5<2vLz^o@$NvRG9V(n81TlD|3RW
z>2}u@?ndc7&XKjMCm6TL^)&gJL86z=;Ra^?cB!hMtl;vJvF*tDn;udkKEH^ZXS+V7
z?7yh_zn}d+;;A6wn0R*?JNY;Lod||Dh!_#Lr(cbxPcztk2)f29F7Ee}=d_EirG_G%
z!$l2#Y%>wlC$KR@M6iAQ&9N5I4woIbJCVoaCqf$2Bmv#Qj}klNM=npgoqfI@*qaBT
zLX*=}M&ddvmU9*obGxA3E&^2D+tD4*2Nq*b0b0uPTh*+^iOY+K72*9menSW7bLjyXNKq^&
zrrIukWjLH}GX4v;O)Ti4p&k6W<@`YHyP1eYRiN7#>}haCwx%fW9NF_uISuW;Wpe6B
zQNvu;h+GH*Qa<+SZJwEXV!h@wk!)Jte)S|W9gh=48G%}wMV$=3q)e%RPVUT3V}>id
zi1VoxTH;|6q#B!PYjp=C^J6m#$7pv03Mi3OIDpBTP6kOv`p}Gg_}=7mrjYC3oI#SQ
zFq_*^6G7s^lGRd$^Ed>tHP~gC$t#9N3Q$K%#B~Ruqqv(s@4t
zp2WD%VN#b8%Ay*Ozbh<;yC&C+j6FO*UBTii3AX2FD5WelYpf%B^UVOn{G@8^kc0bo
z2pWs4w1&6nND-A)%x&}bAe^RD%*s$h*hZ4a&-$dcCyHQ`5}4q=cR!O6S#9rWwiszX
ziE6T-p;D9Bw($dnor*VZawe_1{hCVYg8_PQz}~kR?ll<0FqGC6Q9B#|{4cE~cbhh&
zACt%~RdI7{k5;ecv4hvLQ%qKpJhvgVkjy{A0IE);U6G>l0GKs_pJ6x9_cW
znb6Rs-o4_L+8=&l^XI?&G8(edOiwa`#y1~GX<0w%UM-2*MFa=;OMAb4?hnI*hp&Py
z@Kh(Lty|Ht?k%`FT~KQFZvb|eLdhm2+Kbuc5TNSo_sewKkq}dwPpoB6lr7a*tLxDW
z-2HA3nOQa|+|hp;Z?8HkBhhtHnsPkA_VOAUj_B}3O&sXc3J3?f1+CRq;uys2rF<=hB^@X<8mo=HpNf^W3Gom}H_CAJhd+%P?DXIJ_
zr$OSFW^j~}!^Jcg=f2udcEAO}1PLcM;OI+Fg2EzhZmE?opG{JUMBF;wwS=JY^7;9Ccg45a>i5am
zHPse;Jg^B`_tq{owvY#ZNPA{!A;hA|iADk&cwTEn6S
zj-bZ7+!n8AvC;C9*{W9e9VVqvgvhF^ZJ5^9l*J;_^R^pHhF9d~vKI1C
zpss>4aS9v?J{M8K>)yL($*!oI^Q><}
z1N*!D{)aCH3i<=SKPJdGkHxxwL7B&=XoqaXZ(&+?%51mHsbBe-|Hc
zSozhJW$P*51uc;Xj;(nM!>Oa~OTksk7`+LmP$2Guo(!TdaG
z`=gpwBS)>>`{q8qUpRa0+p6SSpP>cW)fO@s~wO
zP63TQe)7Y4097T$au6=6I{BvBzI~aIJJFK}yzqHZFd)VrjAe0HAq>%t%Ig?pSsciV
zWs)Q(FMLuH7<6c0Vw$+m!(mb#@nMN|!xaS0RCq9NObeE55kjknR}BpE_-6t1(!~%%
zS}$K@>SU|5x-RRMngTy@U^#@3`VsdH+qCVG3864%qLC-Yo8fJx&A1+5uZ0V0eNBg`
zD$4COB*sa;BW>LT?4i^6^?{m=)JSzWoqXgAwjG8rFr9H7%#e1+Lxv%9@t#?%e?8N_
zfQOUFM}g*AO!sKf(6E0W0J)V{lN|ux=V4+%tOBIC&Y&DM9Ipz)`TFE
z1#(Ml9T)YcS#NBe#i5SrVzs&(mV0#m7j1OV8ykb?$F>;et65Z|O+l?o14L4LK3zlzSGp<`Po$r`1jehbHHwI?SGRB@z2lNzUWje-yF@H}vkT_9t;JeV;CdV!2kH&wXyf^BOQI9AaI>mfl!cA}XRN
z%LCk*i5al=3_6zte-(M^g1yO@g1S_N=6SA(t!sP9&u61R=JK?QiT@|in^gX|6)GUj
z_4gGTXb`Z7kSkA(oCwJ{yUyNNCD>Jur*Lc!r#{zGWeVoA7`DqMu$`_D3Mq5sgS@8j$am61WjkrB&3=k_4NazM~+QUAM`~+hRu)?kIQaV6dUkbDV?Jf
zDy}(friQa~wpl5hShj974-~J*O2}@Pr%d|IJD
zru+UNq~Uc3-+C_W)|fxwAmhM=jTYW1WAjV*)`p9fsIcF)_wV?PwF)=?`UIKjKHhz`
zX$V!l9eP^yyYxmiQJLgULXO0ZWHQ&idioSRp`$A4%)@@gGyeZoEWiC3a|D;gvVSR-
zcs>X*aeLhEjB?L~kGLK}TAwP@|926uk$tedw?x6OPsT@Ch$!&{fX^!QQPF{s!@QJHN|?st)cl#$S{G7
zuF8o70JCMbhBcpc*F;be}
z;oe28yS@oNVa;I42KS0}cWZ+)byCIDPLsB>LKJNN-3h)WV&tm%yi{8?_%-zYscgF=
z#=8`*-4>#Mg%ho$b{;3SFTnckirKDVr%5?+{_nW|KePn_3|I6|-SDGL{hQltOc72P
zoAF9KA2NGEX*$#)z<4))AQ98(K*%3ZY_}OjW|XmQ0TX|FVWt4aB>aa0yAb9Bt$P{J
zjPFu~1@w~;aM9zkl%@(E7$;Jr!BnKM;dOdE*_tSrEi56So)}|O?XWCJs>s&Bx0W;r
zR8Gl<8p+0|+Wn**u9V*@)Dyh62RCEoUNMZYQxt6BhoO2XSa5nKBO{$DyXN
z*Lz&P+gerPpvt#(HBq}|cU^6snak
zW^?j#Ps_X%`$7D$MU;CLQE>Hz#O^q)5;!MJNfp<>;_$J8+$uFTF+B|=lQ7QQuRj)z
zNp;^atytn){z|xKaaBW|sCk=*@7fV5_+{3hcgYB2Yqmf1V+lz7whp<9_?dbt!3anG{4
zq--7op*Vt%ikNfYSU=7Za~4u9SN2KAlOqab>ixQku>?6q(fwxZoIm#xs3Zz88Er+D
zBtw4Sih4(I;8N41o*G${WcBV&IRa=}N%T1T2P4Y@e2c1^(gcEssc1NNtigkavC(J;
zUXC4&7Et34_Q^C4oor0U(o*7Qnn5KAD^GzbhzRFj>yOV9IGY+XxL;`x
z-|oB)Hv9=8QI(Qq8TKwCGd5#BVwbnV7u@yqT2&yFN&wPeNf;1FFGG;2Sxz_@StA
zmQXRXX=R4`G6%|-P-MNDpRan
znS6K9f*RYh`+T~6v9KsQV@wu@8-MG-gS%7>W6k@_C3%pujS$u(LEgb4&s}n5uUmUT
z9|wZGYnM-FCSAYly)C}d>pC9*aQ7t|{trn0P4=423U&>?wRMQ
z7Y1QC59`G#%=*SbN)ONRpxB=g=;|W@(e*x(wO`9bn~WT}=yj0#GFvr$di(|kfV1Z@
z%_LT15-dv}iXNYHTFUl9iN^=PxxAPIi@SvSp5In7aGnr|4sQO#beL+1B__+G>duSLY
zL}`m}mgZ97s)D5Xe}yUtlmGfKG4zLz41JA)mHwMxMv&4SJP{;4_?CLY
z1Kh8nsl1G`$2n@`{#-YK_(z3)KEiF3j8_Xk7~zpIcZkDSA&h>)j$X777SIF3dwP3K
zV%eogT2j?8a$J}*`1N}#9Dr{9L+do7!6GmMVsWxspPt?dg_szMM5?wFk_5Kd?k_UJ?S(Iy$hRlAH_L-ZQ*$bl46QLNxSXwcfnw$vv%Z
zIQ1YycK+<4alo-g<}bkh_k91;ByvRv3b|cJE<@}82K9g7-t+;&>Y<0r0W;ySc3&Fr
z`9t48sOMa>f|6a0gM~0v*rYHp$h1ELHK`_w(XJBz7RWpkn+V!0R*
zM(6i}i%0bhEe{S>I^=D{wt`k*O{`%RQ_`|&=r8Bouk+K*C{X&a=^~TabW_c<2949r
zGZP*(lPbdp8Z|6xzUOV>)B-aE4jF8$tNozGDqj
zKTKz{Cc7o$ZL-hzR#9?+bSr9&_0$
za-!;9d6m*u4`XJ|k{moUF(xNEHgtz+fWwGbMsXgsIv7UlcQq}|7EE`_M$kKcpebAu
zEz%qJpIvLaV2{k@x>3S{upqdBvuPtI#YG2h7CxxwnNJXX;g1UWLKC|XMrbwXBTX>C
zC6z)hJ!$TGs$&pwY+PQL37Q2YSy!&WS_WA|uZRKXHG80PtY-kku8U`Y;Zk6Zbx~!H
zx7RDwj`2POEsc6PfF|>2bA@LmJ$2k}@}B~c`h(VXQFy&xJNcPvupovq#i#T1{2gG?;8?fvlfO(#Upx!#uS5b`!2kX77luuD@?ZyWfxC6m(16@ET^p;+y
zV4+5O?kM&e${07|XD${lwA8*3M)zx*kn#M{0o2X5_JKh?icHe)`|vOaFBNR^5f&Vk
zwT)?flbhYwco96^KPqn4eq*ErhY@HZ2-nngPN|p+taUK5wVaVjm2slQ{Ww~4t^%of
z7sH67fVcS@5p*%3o7=Z7OT`_Ba*~{_}kZiHcavE#apT6-2cMEr~*M?dDIF
zoZnkVBf5z`vDI^<2P)%teA_R6W?6nx)2Ab(Xou1qnB`ArrJ`{@pTv#ix^Hu#39(Ng2^`KyI$@iITu-QI?oCNZBF8B0R0>gcU*qs^4sZ+{>VL5ZG$7<1yWx)`F4@w7osi|JVbu*SIXGPC`ZTX}?W@SSH
za(Y6k$yUTtmOVE&_(9#HMFG#@^^!1hxB?a`6QpI=iz}Dp%$!+6`n?|xkJS?ykpt7F
z2zqg#TBTw?xZY@N*2oR_KzCa(qqNwUx{Lj^evAj6`kQ4BzY`<9@6Y??WCO8Jg{+@&
zWA_+AZu(@1YOayZ-S+diN2ZN@N@6f$g^1Jnp<|jpg!J&v{N7
z$r=z5>~EIxe-u-k!F5MFu}Db%dD9KU0)442_IOV`A)aRFx(dFMVCAk*t1+m?Zs>1;z|8mI=-=(o3$ls
zivcFUQ}hYna{$ASRItu8j0*fry)AJ~T3z>xfR)8`|I&o0Ijo3*TB8w=>GNcG-)_h2
z(*|ke>t}9vgI`+!*9Kh-8p($cL(3YFC>J{^T>?V)0zx=YIrFJS6MzDC
zwF~*ah)DY%qWKlTlS&BieBHK1?mag
z!8uq;;YA0}T&f10Ayx)eNjkigIRdB?X9=E8RzLB7m!n?)_)BWv7CE@M;5THFn3=3+36dexVeys;xfywJM=*(?3#G8w?s!WD
zZyf+@`Jk3QDTlcD0ao&Xf?Fksq_9DE2=Tzp(%bLCfQ$E>e*g5+G1hRo=DYvkdQ$j-
zmF-~C$}yGqeo98>HJ~eGo0zF!yJ}9IOZloc&hR$q#-w-Re(u3*C@2eBI~!Ve!tYS@
zh&VX?F7O;uha$U`6h$GIqBX2v{fC&FMP4iT17)o$VvG#)s`6s^dm%DD=H_A-`gEHa!FzjAcS0Y~6};+_Vk
zjE#e(Sje}KNkpoD}Iw)9gVCD}at0>yXnKcl9;DqYW?q5tXf;G0}^(?pzbwMIFaNM8S+{l{m0p+!>pGmSx>D
zzoHJF)OkPWK~&b=nq}k7Wy(tLUQlrAmMdid9rKHPIrN11gV^i6uj3Mb@8`mvs6znDphU
zdN%M#mtI{)GSe1&eQhG!`R$O5q(<}a#0AP?pVL4p)~7Zmx5!p!2psoH^wVdt;IzI(q8`z5w
zj~2eznI3BL)Z?uFMVxy5%@G>pQKgw%efwqdv|StJig)ECX$sfjX%!sP?NPD)Arpd-
z#u)bar)i`nwv1e5=ja@YqW+?|I8g6`X5rzu$CVof80*D^+D>|JT3dCpg3oL0
zmwNbhjmoP&-zMiQjdv`U_o=WkzgZkRA?%KN$rrA&9L|J`0Du+VY>WfBPNxt(uff3?
ziQc+@-V1VgKY6x83u^3bvu*w=o%Dt*EXdH-)dHo<{{F_F_>|U)b+
zvD;PsZb4!`Hh-M<*N`Rkd~Czb^qOT||7XDh?Wm%(pbchiB<(flzQ
zoT0<0a}*vnd-5|XzkwWcY;eJHra;Iev^nHjd81!NQ{uB-BF5KD@+
zr6jF1o3uG|>gWf*90xGzQ*1fd&UDHm#vfbWk~J!97`y^;irFO`Edji&po5G$$^d&2
zk?B9Gt8=rIO+7<~xe8XE2uElia8?@a%Pf(@iKv-iob%Ulsvc0vnz(qJ7)bge0gFk!
zq66>`t~>39b{d^N5N9g^To$DZKGV1C6BBPwlt!(|Qwf2&&O0tlEQi5g87;`Uh5}*(
z*I$Q27uv1BgX7lDwI-)Z9x)pYt!@p40PoFTEWhI?`>nCU@dv3%A{E`oshq92lj#*l1FCo$Bl#MWUqREN6qy_e}VOz4hhGEWiI
zD||J18v~}9roAkV3$SO-)PF)HTkt?CRK}OjGuIyKr|OA(-@ctN0SdxznFosHW;2~a
zo_OoSM0m9I&>JL*;Eh*hN(e_Tg2zD_wQQmF|p1v^v4Ou}zR6j?V>Q(8WBrv3`owav@t_XlX1i4v_7p6G4&y*jIK#lr?cVg{
z!2$aV{9dEsv{))l4+H(>v$DHIXFN#~p60aO$V02mICOjbkZ&+|3|E7#)*!NkvsVkQ
zd*|9|8(YzSG58eS?!Yux!{TF~6As`mqI*8nYWvWN%07UgSh_~PdVYWdYyIr8wdz=W
z{M^10&Q}Fda$OoqlNCcXx2DT^0Xpx(y5Pmvm96gNLqr9S-JKhT=*lLt=Xd4kGEJ=CF#jf@A%IDNEDooi1k!&?DFm=H
zh_k2rb{^tJ(7M
z#8>OsMQu}BV{fLCoHrS*Ds96Q`)pW6N9As+k*(vb=(!|ItCo-c_;4{Of2RjV_UbP4
z*VI0m{8sXNo#6gy?V#-_tx+~9(C}1MC1=yYQrlnN!}x98@goqSDj4j{9>pD?r
zP03y3Oj_e@W7C=LoVM{BLUr#pWE<7UYKo-Zxt`ch7@FO4fuLdTila{%L0iDV3x<~;
zXtiN=5itb!)Jxbhuc5L)Y^+5p8YqJG%O({KJPwP`UT+V%qEb>O%C^Zw5|Poc&q8a)
z0P5PdrJTl?Bj9iy1|}n<{PsZCiE#~Bvv8c6#jnIqq0yS|63r|vpgs;>r-djz(Sd`c
z=mXrf*qDU)2^FEK-CL>?J8e=);)jb75xUr>;h_=gd?2DNDXB!?;DIiaFp`cZMtGWv
zhP8R`b0M#we|}tx?UD$R4G~%L!`q0vt_)J9dc)SKYSq?N(*iIFfmHwqB#EC^Z`@C)
zof*|@7_uVtY5hWKW{=|2+OGy(PDtGt_O3xxNXpXsNq0#U`aQQ7crO##xYQ$)zPX#r9MRQEM#WNk7
zJ}`h(+g~Iv_ro5z$9?rkGlM?IrYxHw;uzZ3yT9L!fi1jcXEQH@=I{LG$sFNXKdz`z
z5O)+jzV-oCQo(kxww&ce*9X)gcs`7*eL8TaJWt>$CmrTyM**_PBcAup5fbf{ar(x*
z%YGKOjrE{$(Qes)^OB)(TW7-{2hfy~t0t3XJ&G?n-Sm@>Qn4%VC2TK{wnnvXea6)u
zFK#5yZPgp81oqEW(VZXsdM65@2G_nIaG0@h{mMHxE(eZZ7EQ&<4KURrY@I_
z4DZy;%adhwO`^&nv~^_@A7_OH*s=$m&-O;#d#+=r+MLvCri*F77jkl}+|PmYbk1Kn
zA6XyVE5ZkNr03hHT?{S@=g!Zz`-(+6<9mOvhhFAgDqCs(^@_ElHGi2xyo=ZfIy?%R
zTXbSyy0Rfro>N+Hmp3uDA@A04K)dp_68FbYqzjsFW1G11z@tm(ln`wC^*pyDc+Rx`
zi{qjh_j`lZWu&2HOsl*0Y9LAOn8_?D?E-%%5o>#`tSY+D(C^xej*n?(I2J?sLuSL;
zTb!pZ9SIQ2`1AYg@VVzWzH9PN8S~AG!q8_Rd9%U5&zf}Uald*_5Eqla3X@q_IpV3R
zIx^p88Yx+L&yRm^R<8BFzvunw6+26jwC3Nn0??R)mO!=V0+pSl{<0l?u8A+&BfUO=
z+F8t5|8sqhGqP&WG0Rxl0dp-rZ}<4%Zl-)X?xh~i$kS05mB;%^e&*705uC~cdsAJz
zWmW%l8#_XF$%aktX{vm4IU5C+rnfNC+YeJ(D-aKPN!n_6*~RxN;E%2Ti69~IIu_d+G=l;
zaR@`#b-qv)Evqy(HgOr8(TT-o9GEBVw_BkC`JfWcc+b6-a=|@S0EAO5%<3)t4ue})
z7l=I<*Q9tt0s=S|cz~8~Eu6~nxZH9-stY_QS>nomN{!Bkq1i{qMi7bqNKatH1@CE%
z6+K?Y+A-L+jEAZ&aQGxqZm_*KYIkMb#sgg&W0X}&4~)*{zWptCJQTqAz;=#|1qg0T
zlk=>oYFhC#M>f_oL0Nb8sn?KhXJR#3%SG^rx+foFO0!$~uC)%)z7)hcWi1kuu<&$H
z*vyJn`rRgv20JuF^sVsK0XH>Q>6!>;FgbfQ3U$fqm>40G3#$2@Q=-KRJ{1_{&dV`J}75j5OO>AvZ8;%11;KyoYB
zyNiHC29B6`8x5JJVGGNt4KJl3g}IChj*k(^hU7)94#6}N{4RgAlJLN`B&xy7=ZXJnvERHqCS60e>b?QKofXQ^B}G0t
z=1)3-o7#!qs;vq`dAqFzs!Ep&C=QvDTXvFB!NWJ2-tXAhrW)zu8hf5?kN(S1C;Ob-
z!!b~utC6R1NGoVVbLqQ}ZFmyv+Bw>$OLyeZzK
zC!7Z$nzYo+kEJOwDa`592XFo=puGlEVZO5t7Z)ZJ{^}*%2fuqyef`>boA(ps8vlz9Tl~}0
zQWM#E(*F0aJfAN>XKpjSBjPjv`0D+F$F_PPN0vt6IIV5%8xivcMjrndU-Y|@kNed&
z6&b8YG$VLe%r6=uj!(=~3VK!P4mt8?P~lw~iPHe@`BmNT^P1m`Ok<$-MaST4@)SQcY>4Gk)K)qN9ULo3b)?}5hgjy$y|SPlfbAnq#v0U{oR2Ds`+MN|
z#4{ru|61bUCPr+d2wI>DkCD%cL>b!2Pr>6@O!2+Y`
zDkMKo5nlsa*O?+jmlt$iehCRC3onQ*ox9R#IZxi-nUO!AVkgK*BD_os!#CfdbXz_GL1?G(N#1=#QxcdlZ(8v2o#fU`08#lIQ
zg}TnPf^t2dbf>J~ifyhjr5e2Q9k&^3c&{qlK%SL~!Tz!5G$tnX@ydM4r-X?{jE4&w9?KM;sjQB3$&S#rmzxnc!CEo;+4_958cSZ=Wa*
zuLoXLihvq;cLxT$9{c0OsOj1-u05Hm86o-_ZJ1u-=lR=?as7sHS7T5aPgdiGFPfHT
zjI8PInGZ+H!Zr8VhEP?;n=}e(@E%C1l|0~@g#<&H$N}s__X2SNC2k|$M=+6{#O#}{
zd$F|#&q`bV3ruAWmJeYhwpaHVd@#~K+Bfg*xs`ZDV;dvNc|#WK*4CYAB5|9jceZ&l
zNode;?AqU2742OQk6F89Tg-p+q*#osPvg!TC-(DqY@A=gcwZBbov`B?4DTIr5g5F@
zDo;Yp>ROteSIXY)?X_ksr15~i)Nigk0l8zjl-#e^-X~Wrj0i1%c$+43ZaBQWuUv%;
zbQom+o#*}|B|?FkzHk9MvVXCtj|3aS-@AW8XL3=qK>7%C5Y#%{AjSJ7Wc$M9@c9|&t{Gipb7x?T1znMsrHlK_EHKcWG
z*GrZd4$pP1H<>
zX?!(;{%IXKdiAr=K8BbYZ&-0Xbw^f*hC{6=ZTyx>$DO=m&3r_6{3U&GF+sA?D-qP@)6Sun
zp((c~q$Sn5FWj#Aq=~h{633Gr*HQ`<1}^7E`EAmNxNz52D#`N-jvx6#;#rE9O=>5i
zoX{;)s^gN$p&7cGo_D(o4bgesLPEz?wRXdcLe#JRQKBxAza23UC!xZvu5xnQul1|8
z?CjN-L}l^~J$#t9k6Xe=7Q7H&L2f@6lEWn1cR2-UO?B7d3^&Gr!^_Qe?Oz3b>l6Ye
z-T1TGYRf-0)h=*2{Gv(S|
zT+++0!g;IsO|3rCSis&S_gg$@e31?n0Cx7uC5}U_;Q&t*2yq0FPu*2=>kw11}KRfAJn8t-8PN=yD1
z`m60n&?171*Fe#;Oj7DPQkS1d>yK+$8s2D00Dl
zB&f*FRr0=_UWe1T1*K7^&}aIjg>=Y9ZWz1oJk73$E7RE>{b25?)!&c+0?AsVM>&^H
zq-s^U(3^ldU9IXs9f})h;3jJd)|bPLVeIV*Ei#&5BSxHUPo$9OUlWLh^!6cUKp#bVGL7CvU+2)0Nb>r5PAT}A
zwOEve*_o_1+(I`ljr8`BC0?uvY_d{aGVTy|m&gKAzRd5pXr?zUo_ckSM3nr?k1
zf7Dny*yt|qAt2{X%?A?%j?g^;OB>wybG+F1rZ&v~2%BT=A-1Hf-5Q^wR`WX4z@Dq7(Em9^a6a5eUXnMab>=TkO!NpYYB{L?^LQADqjRe`zZm+vN5e
zl2Wi4O&i^P=*N)G`=PJwxi&ad(uNkuuJIbitfUw<8CYP57QyLY&m*A>Vy6AnhEmpE
z&RT@i_TC^7qxM>GTzgQ?VcxBLT1;C=DJJ?=%SAnA@bT2y@|K0$*+g_HLg4y_Y|0A8=c|q2F)9M2!>W?E$Ym=n_~^>AcNCPPwOE|N2eg
z&+eDRx(b@K*w%3)Y0@=Z&AKOsUd|$U-qS>XRYg~{Vcq6`(b?d^)cM-Nph)(6YzgTF
z2v{Vop(R{7ZOzZUZoYD3Y3!=TYM=rvOI5lE7DgIzZN9M_NFQ#dr=PGmr_oy;^2c^v
z!gBD};ixgwP07S^UZTq*5B<)P7Z-WQX+;r1A@}LJAZ5DZG&Le8WkWel3mgRdRPqeY
zX_9egaK+-q}y#uHV^5MdmqN5gTcTx_IoN^b_q@)(O@MjFg
z-0)W(4>NYTTI)Y1#06?nxB&RLtp}N_tb7D{s_Z=`^?bY$SHtZNZjeEETs8p?I(I^w0SHzDJTW|4J;gB*FI_(=$M{v_K5v>in
zU>pF1wAa^u*^oEM9bGiobgB$yRIMJDg$_A;p+1~Z6qwO!NyKfYi|@?N_7nS>4AE-W
z9A-qkm9~_Vv$_&MHYrS-q!i&Z9$mZsoms^)R2Nw=L@}H(if^mypIsAbjXc`BceVYx
zAv?AII*jxe4{MX#Bon*o(aYz)hm-#_krDeJgd0*`|7#3&82g|80)yW;rVh)qYo=ZB
z7(4M7)pKVV;MoavX6&0r_nq^~`fQt`!6AyQekn45pQpf%UOEhN@lS43ugHxjMh9G2
z*2)h@q8slj-vw<>h;(h-b_E7kh{ZbMre~rStei*scE6JcwTxs2w$+>omSt#p`tm%T
zIS{x%f2qO^jl$oG8xpu_U3VAH-e#3elzpomHo|Ij^gWw0V%zx|*B_jGqj9gguX|0N
zw(-2Ky(zf*OdsPE4lzBv1>U7}-HJcRW@?Ker8IQ5S~dVOm6tXC{4Ru*w=0Nw`}B4e
zVCRNw`KWdw__94jmgZP{qkZ48=a5kps1@64`*wV)kL3P5q+Rp4wwVu`C~hj?%pdwC
z2Q-q^g)X(|Odc$_xm1%d<|c>h*TVynDX~FP8abWGnJ1QWCE;enltl_g0y`
z*2*B~!eeP}xfO;3x3dtD?aLUGZj)+^x}V|~lRt*FZWTKgaEj2)&w}@#$H&;CsIe8k
zo)71uM2O{60NNNlJ0%CUud261rGY*;($bgJJRxbF+E2Q~B1j!83>f;FBNXN$PJjeW
zbo5y(@vPrNLcIRwPG;IB?Hl<#$=?!%c4eLCGaHrua~}xIFeNuRLAtZM|T=d?TR#yWO9i
zj;=S-74>p-$e_Z_RnQehY!Zt0{b~EJMz$yQ1&W>0vu^;9{o^|yPNJ@;6c1A#k``Dp
z>`O|sU%tS1aG0B%Q^$umA0c7^zX+g%88B+SH}O6
zv-tCOP>D-AmA1~>*8py^oO@5>3&3)Q~J#chPr+V
zhn0k$$p%nNZ+YtHfXQ+ZAkNe9hPg_WN-xRBoR|*)uU`F#bN6N!F!akvL3J{Dk@WS9
zuwr=ZEG|Oh)83D5=dPzvto$&YD46r%rC!#@e!(f>nPC8Aj&_KMM~%v70bk8%<$4SP
zp&Ndj7mv_Q=Dpbw#Y!40FE`#xD|)?XXz0FPGb?4N?A^YAeJI(Cz8+R__I|W+lHSGUyfM$Fx>|X2pryd_-oPAONPc{si~~d|BVSLmOY(I}dNkvYs+e6Dyt)kGAKhm9&($q=78=
zk&a6=U0f}cNoVMFgp792^bR+~`ZsGv7O4E~YCGrib{p@lVTk7ytnY>Gui&10!!&Usne7Lxk^ImECt^S3B<(=6$gf7}>k+hrykFtUr%+
zjPWz)&flhUUyM^cvE7;eck1mwBXHe;ko*XMYd7#8q&+)Oh^D}J;_Wm&5zcmsi2nHU
zY3vm<7k7>!LrR^bcL*3=#P!C9i`kJgM4DXac`KEk4A1!I14rs=9@-U*U3VcV2izr1
z3p^$*1rGX4f$R_KP=3Sgf$cwgV*R@$JkS)>Q>ze!Up^Fs>4;!N#*qNrT=T`O0)#+;felT%X8(hgNo%fumf#1n&
zmTx#~Z1{>YWT-`SWQ=jp1E8l2GF)Gu%~aR@Rlo?4%y*`)iWyj&r$}h}{GSmNaiD^{
zyd}Ov3cF}`5N<(Qb&D616Mewgp5|G^-1KhfZpwkFlyDyYRy=V{b9V(0h2;zA
zqerl-3S>~TW|O~+N|-ZiT@g=Ywzi0gfE!LNZ+2^KU$4KC-AWpGmr=Sg6Z@3cn7*#9
zCnKGU+X?1NP>WDfRFHgnu>Bh}>47m6T43TMOY-Q(slX%%tK$C3eW{`;iT(9q+O~!>
ztj7!?kER7+CE<(e>69DmbON9SiP){BAfLFoqanNgd0y{pBz+!08p`u!55S^xuAt(}
z{Gi`)2FP}9+Au6S&HHdhu)L2KsDmO$rr&(QbY>1U#Z=B
z@$tsFaoeukkQxP=Q0I#1)79Jf_P-ta-A9Qw9Y3q2exv@z8@Brwqi*@~K4JLnDSM&q
z%f;n^=YkZfhdtkT163$5u7IKj*82M-UhL{USA~OjDk}#{A6e#ah!ed`e!k7xG&7Uz
zGR^H|{YJKM$>ThNWz7?^W+Xk+lspbdauratQcN&fkuCe)%Dhpcy6;;`>+a5nlK67@y>bXASL_}5aO0d3+{uDDhi>gB5lhAYR+q&==IukqWA3^hgwYM|1!16g4M=*+3hVN6wHf}`s8s3odWx)oU}JMGj<&YYWIX(XO5z`O4#IDsY>EjumGijYW=$8SOw1y8o)EbY;v;a
z!@l8B3Wqlf+C5b34nIQ$Lly+AQ<{QNGP_EdfhIo(-
zucyK#t*`)6qsdK_BaKd!1RJh^tyfcUQ>Hf=LZfxTzNHyZAnW?ks%hoBq{UbvNM`U>
z2{Hlvjf)+rJXmnOfQra*29!y^Y>4GvFN$oP!2|8-}dK-
zr5327ZH0$fG%14Ec^L&0HAa%Er^BRThH{W?A>Y2u0Gd=!a*RmIXOGvIDKAvu@uXfP+6{tgOxYrr4`x-@ctt8)jp*t;f07m@my4-
z>aQk{i)7PH+;oQyt7wzR2O^WyxHui%Cu7~CxM6U&w4|3@G>@M|WTmI!s5@@f$#2hcJ5l0H=THIA#xh*r?b(FM&9JJ;Gr0V
zZtM@ZpWP|dO}_N4dng$K1<`acxjlucVQcfLxo96)^^z&Rct5`_NU`4W`xy?#E#wTr
zZfvvap)~nabAR!%6-`L`|1I5p943djdL^xyw!~-4DnlJaPHXydFI&b{FkB+O#e4Pn
z*G%bDkc)y1sAk<5$W^fHMv%@~BbX24pUbO?^R(AG4>=nqy`R0mRJafo%zH3+g>5uR
zmF}&SBdE;47aBp#Qcs(!!yWR+jzBifJ6b^2y0^?DW#a-GT(iI3n&;4a+fdQRZ3eo=
zg?xeLy%0j(ropBP-G`M&-35eJe--p|FR*TZwAWF^1^I1Cn5RL@POzT9cIU&Y6&^I+
zt3yt#n!Bw5t#2=gQMNWy22-Bv0g{t*hoI>3tY+&XX##S=I|IlHpbSoqi>IFC8<_Kj
zbjTVmC)7@m?aa~RW9V3b9f8c%bH3W^mH%=rPrLKRJ6|P=sevz+22I@Xb_otC-FKQ_
zZd$G^i593iQ~+1IM6m#zB+t8}5J@s`#MkHB!XHMgFUvW}r>0(7)gOzFqeQWDoe!rK
zMy=G1)K}wqqUJ4zvu@hu(L&-)5-q(F-f^#puXAYp<~uYjcr9|)>^+zHu&g1W4c#O?
z$88Y!-Rzw2Ltg0&$4jgnO^3QNT@GYXk7SAe??se@QY*XX^HM9)Ds{DIhn$!1AVwx1tm>lb;w)CB#miwFMb;q$2zJ2~5`&T!rQh*j?I8}8l`?bGJ
z(6c21ML8P0TiX4CRuqplcwAwa87Y*__a
z5bCepuhUT3@)aO;-gpq7U4{=|7yrRb`&1cA
z)5$kSKbA^EYr_uK4v3e&%}Qx^n*k(NRZ}O2$JSDL9@J^zU
zcnym3jYp=2ppES^OZg9UlDqT<4;PRm@o$g-cRMOGq-F1HHzVR^aQBY_Ti9tPV+6rylw{XhICNS&NSl7bB%f@rO
zhWHR#0PaJAZNvuJ&NIUMy6+0#oJ_;PBlwM(sG1~a)x)|6edEGRw?@Uvm+Q+;P$!l{
zDmu=1D*Z;kIKtJ*1$8`3%H2hwhzG3vWZ#nJYZs12CL*s9Ffr&7k%fA^_hT39M+fv0
zxJ2zcd%&2|8A~#r03q3=t+PVk;1wv#H*trR7yB90{^Xo!7?IUkURruqmop}EX+jf&
z8M@AUq+nU`9L8>WZ)a{ci*0UzT~#}r(nTAPYsD3^PC0t0f&_E{xk$K6BX#9+Sp_6ViE1RqLU|V)<8~vjyv@4^wJkla;gLS7O
z^N&-2)=X#G9vJ+w_rTsQ#irbgTAOqKiNSi&DB7Ty%KY*X3q$>69WO<%CgLI_p#+q2
zy*ifDs(9M))or4=+3W3>&^)fEQ``8mpQ&U$>jYPCIL+9rV+%Su*|UB6Cdj0-XX^9C
z>qW<-e}Y82O)Nbxc;h}U^M_8xJc_Z-2Mx$9NxynHR?x&xcpH6ayuZ%-$W5g-I<-s`
zz$QEd7B|770!C-Qtmit;>W
z5~;_i)LU%U&Lud#$u$(A0>~=4u9i5`bv=fU2sC$uK>1`Z0B+@3ssJMRjVf5PBQt3&
zD0H88xDrpS@agy4tj{(g(=O(o^+Yr9XS=a$f1;COgTe1jvuOsABi%=6kS>np$$~h!kZQQqzx~nI*|P=vg+JVPvy~d
zs9zLG<1$K5b<8oBX_K`J=Bh2b!(gw-^;5NGv^5L-ZW4c+7{>%b37jB<{OGsDCa~jT
z9_6%wwd7KH5yya0AHuQmYaQ`WdYBT8TM(4u=(j552|gs0jSnTZj5`uvXHk`F(?GR*tD
zFG)2d*n%7zMZL9vpEOD>?Vz=JHEGv0%i4p0GsZv-+Yh_#0wPjF*6v!A`*e(1U_AH0
zE%*+1vPz5J=v@ORsZN$C%NnKvlVsyi#9lTYMB2cT0b(WW;=8Z2X1Zr``$+bdS!;2U
zKM}bciHu4&q4|U_KGaqomI5m?*0iu6`F7x}Z8uT*)hkvGJzY8&uyYjyYfQ&QVyR|q
z2H#00YACuzyoYlBmHYwAxZ?h=?9iy}K->BrSxX>irGD
z1)d%X2^65Nkiy=h#WH##-W)xooz3BQnBA$$>0R|l4Ra;sB(H1OKjxT3eTmEnf@V+5
zm}}i&@^JcG%WR^F*GBWK0N?@LScz_ChT#$v%|iwB{H!iCaC^vk{%ZVPFkVwA#?oYN
zCbTT{Ql}R>UKJl}Q|q12&_3?-ii<$TR~DywdV=yI&)&*a%Eg#EQm|?PtdO=YHv5lG
zsk)wH;-z_lvlK#!+EzK0q!COJoazpO0r0!>L(`_?)aiAn)_pAB()!-R>c5GyZ5()
z{S8(BmHK{ML~LM7z!AM`o9+7dD?>
zd{)$yo)=Qe2p!soB!=(tnL^PePp}MW-QYP|`-=_j@pQ`x9)`M|qtl=}*E@J#s3c7;
z5=R#WK>=S3h3GMxhKMo_Sl5vLY)+)VW|+sCT39iYaIYDk%^wdIuCRYM%e$T@)(+Tf7zfGYKjr3Ak5;dC
zS&fH^Qi@Xk4r4nQO4N&QbVUU9h*-hrF@%ndY`Kw7zMHuq$NTOq#Rjuw^uT{!-*}44uK+IZ2Qi>1o4+
z`nadC>iqZ?#+iTpCy&q&pL!!t;`*p5)Kyw^8fo
z?iuezcDo|YRo~gkSHbb1wyI$3q^^`(>d|k5QFzU($>%WM=Oyq&Rhs^oLtTFf_HWg(wyB{~L7t7Y6AjgOn5NC@qSr|A8a_gHG)G=)NA0wQZ5-
zwEwsaX&9<`oJCtG0NAcqy6MNXt1!4~Of)p+AUNGO-TOfqw?wDKi^?KQCCSEa*LR!f
z9zA-kat~a|AlY`Fxork>%ZzB;F55LX@8=q}YV~GptTI3qgWO4=0Cvw_Y>}0<@P@m~
zb?mlJ2u+{sos+Fy;CTrQ8&FZH`P*Mu2Ef5fnjWv7R!m{+mcH;zt|TPH6xxy&0#ML(
zyHHTNd(Ub-66DYUr%0%zz*SGbHvq+)7@+h!zpL=HFK2e4ZE|^5a;&}4
zpTu&rc80sjdMxvGem9cqX~`i}T&?qo7!WflBaDVV?f*DOQW|keD8mq*7V-2K+q@FT
zEf!vJ{(%iz)aOm90_mqKE!Pmqhabm^;^J^GFR%6+-mV6{4>9O4NhtJTh``L?&{S4v
z;IW@kkRf5}>A@`Sj%aY1{}>PS+uQJJP@g*jl~BvP-`tHk!MDmD8>Ob46m8f!xo=q#
z`u5xfe57HqJ|fh&6C<#trpwViU=CdymYTy~43mBAMC|_Qp=tU?cRu|lHU&gnzTSeC
z#ht>R`&j;VAqcN7J1@ZilGKw7gu1_?A|1gc(Exr)tzcF<1q#LsnT#!S*t{iiVVY#ZG#s1A&GFu4T3Yfy@V!v@wAKGXQ
z&TYU1=yo7Mk*20X4fE;B)FC@O)Mc3S*716!Atp09Q|(eA?jYA-W
z;tw!V85&YefR@3@H76b3D`>f>bc3|8lbv)cgTi=>Tu&Z5Q(%QE%~X*}F?9F5P-g4-
zxl_d%WdS;AfBlxdg$bWQm3cexf3uVSDF^yZ(9pm}ZC0g!Lt~m_a0o8@&FhJ!BQ21(
zEQNfL<(EiFg{lWmv(^eUB7HxB$z@0hX |