From e99954fe636e45ea56e20c41f5f3570fd3e6a387 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Iv=C3=A1n=20G=C3=B3mez=20Pinta?=
<44321109+GomezIvann@users.noreply.github.com>
Date: Thu, 10 Apr 2025 11:43:01 +0200
Subject: [PATCH 1/4] Image component refactor
---
apps/website/pages/components/image/code.tsx | 17 +++
apps/website/pages/components/image/index.tsx | 24 ++---
apps/website/pages/components/image/usage.tsx | 21 ----
.../components/image/ImagePageLayout.tsx | 8 +-
.../components/image/code/ImageCodePage.tsx | 102 +++++++++---------
.../ImageOverviewPage.tsx} | 40 ++++---
packages/lib/src/image/Image.tsx | 71 ++++++------
packages/lib/src/image/types.ts | 6 --
8 files changed, 134 insertions(+), 155 deletions(-)
create mode 100644 apps/website/pages/components/image/code.tsx
delete mode 100644 apps/website/pages/components/image/usage.tsx
rename apps/website/screens/components/image/{usage/ImageUsagePage.tsx => overview/ImageOverviewPage.tsx} (86%)
diff --git a/apps/website/pages/components/image/code.tsx b/apps/website/pages/components/image/code.tsx
new file mode 100644
index 0000000000..414f22b22b
--- /dev/null
+++ b/apps/website/pages/components/image/code.tsx
@@ -0,0 +1,17 @@
+import Head from "next/head";
+import type { ReactElement } from "react";
+import ImageCodePage from "screens/components/image/code/ImageCodePage";
+import ImagePageLayout from "screens/components/image/ImagePageLayout";
+
+const Code = () => (
+ <>
+
+ Image code — Halstack Design System
+
+
+
+);
+
+Code.getLayout = (page: ReactElement) => {page};
+
+export default Code;
diff --git a/apps/website/pages/components/image/index.tsx b/apps/website/pages/components/image/index.tsx
index 6c2f07f025..96c0877704 100644
--- a/apps/website/pages/components/image/index.tsx
+++ b/apps/website/pages/components/image/index.tsx
@@ -1,21 +1,17 @@
import Head from "next/head";
import type { ReactElement } from "react";
import ImagePageLayout from "screens/components/image/ImagePageLayout";
-import ImageCodePage from "screens/components/image/code/ImageCodePage";
+import ImageOverviewPage from "screens/components/image/overview/ImageOverviewPage";
-const Index = () => {
- return (
- <>
-
- Image — Halstack Design System
-
-
-
- );
-};
+const Index = () => (
+ <>
+
+ Image — Halstack Design System
+
+
+
+);
-Index.getLayout = function getLayout(page: ReactElement) {
- return {page};
-};
+Index.getLayout = (page: ReactElement) => {page};
export default Index;
diff --git a/apps/website/pages/components/image/usage.tsx b/apps/website/pages/components/image/usage.tsx
deleted file mode 100644
index 2649e3fd21..0000000000
--- a/apps/website/pages/components/image/usage.tsx
+++ /dev/null
@@ -1,21 +0,0 @@
-import Head from "next/head";
-import type { ReactElement } from "react";
-import ImagePageLayout from "screens/components/image/ImagePageLayout";
-import ImageUsagePage from "screens/components/image/usage/ImageUsagePage";
-
-const Usage = () => {
- return (
- <>
-
- Image Usage — Halstack Design System
-
-
-
- );
-};
-
-Usage.getLayout = function getLayout(page: ReactElement) {
- return {page};
-};
-
-export default Usage;
diff --git a/apps/website/screens/components/image/ImagePageLayout.tsx b/apps/website/screens/components/image/ImagePageLayout.tsx
index 8935daceba..3de90020ef 100644
--- a/apps/website/screens/components/image/ImagePageLayout.tsx
+++ b/apps/website/screens/components/image/ImagePageLayout.tsx
@@ -6,8 +6,8 @@ import { ReactNode } from "react";
const ImagePageHeading = ({ children }: { children: ReactNode }) => {
const tabs = [
- { label: "Code", path: "/components/image" },
- { label: "Usage", path: "/components/image/usage" },
+ { label: "Overview", path: "/components/image" },
+ { label: "Code", path: "/components/image/code" },
];
return (
@@ -15,8 +15,8 @@ const ImagePageHeading = ({ children }: { children: ReactNode }) => {
- The Image component is used to embed images in Halstack-based user interfaces.
-
+ The image component is used to embed images in Halstack-based user interfaces.
+
{children}
diff --git a/apps/website/screens/components/image/code/ImageCodePage.tsx b/apps/website/screens/components/image/code/ImageCodePage.tsx
index 3a5adb2ddf..245d4b0355 100644
--- a/apps/website/screens/components/image/code/ImageCodePage.tsx
+++ b/apps/website/screens/components/image/code/ImageCodePage.tsx
@@ -53,6 +53,14 @@ const sections = [
| - |
+
+ | height |
+
+ string
+ |
+ Sets the rendered height of the image. |
+ - |
+
| lazyLoading |
@@ -67,110 +75,102 @@ const sections = [
|
+ | objectFit |
-
-
- src
-
- |
-
- string
- |
- URL of the image. |
- - |
-
-
- | srcSet |
-
- string
+ 'contain' | 'cover' | 'fill' | 'none' | 'scale-down'
|
- List of one or more strings separated by commas indicating a set of possible images for the user agent to
- use. See{" "}
-
+ Sets the object-fit CSS property. See{" "}
+
MDN
{" "}
for further information.
|
- - |
+
+ 'fill'
+ |
- | sizes |
+ objectPosition |
string
|
- One or more strings separated by commas, indicating a set of source sizes. If the srcSet{" "}
- attribute is absent or contains no values with a width descriptor, then this attribute has no effect. See{" "}
-
+ Sets the object-position CSS property. See{" "}
+
MDN
{" "}
for further information.
|
- - |
+
+ '50% 50%'
+ |
- | width |
+ onError |
- string
+ {"React.ReactEventHandler "}
|
- Sets the rendered width of the image. |
+ This function will be called when the image fails to load. |
- |
- | height |
+ onLoad |
- string
+ {"React.ReactEventHandler "}
|
- Sets the rendered height of the image. |
+ This function will be called when the image is loaded. |
- |
- | objectFit |
+ sizes |
- 'contain' | 'cover' | 'fill' | 'none' | 'scale-down'
+ string
|
- Sets the object-fit CSS property. See{" "}
-
+ One or more strings separated by commas, indicating a set of source sizes. If the srcSet{" "}
+ attribute is absent or contains no values with a width descriptor, then this attribute has no effect. See{" "}
+
MDN
{" "}
for further information.
|
+ - |
+
+
|
- 'fill'
+
+
+ src
+
+ |
+
+ string
|
+ URL of the image. |
+ - |
- | objectPosition |
+ srcSet |
string
|
- Sets the object-position CSS property. See{" "}
-
+ List of one or more strings separated by commas indicating a set of possible images for the user agent to
+ use. See{" "}
+
MDN
{" "}
for further information.
|
-
- '50% 50%'
- |
-
-
- | onLoad |
-
- {"React.ReactEventHandler "}
- |
- This function will be called when the image is loaded. |
- |
- | onError |
+ width |
- {"React.ReactEventHandler "}
+ string
|
- This function will be called when the image fails to load. |
+ Sets the rendered width of the image. |
- |
diff --git a/apps/website/screens/components/image/usage/ImageUsagePage.tsx b/apps/website/screens/components/image/overview/ImageOverviewPage.tsx
similarity index 86%
rename from apps/website/screens/components/image/usage/ImageUsagePage.tsx
rename to apps/website/screens/components/image/overview/ImageOverviewPage.tsx
index cdb24b8e7d..c4c8d4780d 100644
--- a/apps/website/screens/components/image/usage/ImageUsagePage.tsx
+++ b/apps/website/screens/components/image/overview/ImageOverviewPage.tsx
@@ -6,11 +6,11 @@ import QuickNavContainerLayout from "@/common/QuickNavContainerLayout";
const sections = [
{
- title: "Overview",
+ title: "Introduction",
content: (
<>
- The Image component serves as a versatile tool for efficiently loading and displaying visual content across
+ The image component serves as a versatile tool for efficiently loading and displaying visual content across
diverse contexts within your application. This powerful component is designed to optimize performance while
enhancing the overall user experience. By leveraging its capabilities, developers can seamlessly integrate
images into their projects, ensuring smooth rendering and responsive behavior.
@@ -102,39 +102,39 @@ const sections = [
content: (
- Use high-quality images. Always use high-resolution images to deliver a crisp and clear
+ Use high-quality images: always use high-resolution images to deliver a crisp and clear
display, especially on high-density (retina) screens. This ensures a professional look and prevents
pixelation.
- Optimize images. Compress and optimize images for the web to minimize file sizes. Reducing
+ Optimize images: compress and optimize images for the web to minimize file sizes. Reducing
load times and bandwidth consumption is crucial for performance, especially on mobile devices.
- Leverage modern formats. Whenever possible, use newer image formats like WebP for improved
+ Leverage modern formats: whenever possible, use newer image formats like WebP for improved
compression without sacrificing quality. Be sure to provide fallback formats for browsers that don't support
them.
- Allow lazy loading. Implement lazy loading (loading="lazy") for images that
+ Allow lazy loading: implement lazy loading (loading="lazy") for images that
appear later on the page (below the fold). This helps speed up initial page loads and improve overall
performance.
- Use responsive image techniques. Make use of srcset and sizes props
+ Use responsive image techniques: make use of srcset and sizes props
to serve images that adapt to different screen resolutions and sizes, ensuring the best display quality across
devices.
- Avoid using images for text content. Text embedded within images reduces accessibility and
+ Avoid using images for text content: text embedded within images reduces accessibility and
harms SEO. Always use HTML text to ensure readability by screen readers and search engines.
- Limit decorative images. Avoid overloading pages with unnecessary decorative images. This not
+ Limit decorative images: avoid overloading pages with unnecessary decorative images. This not
only reduces performance but can also distract users from the main content.
- Avoid images for icons. Use scalable vector graphics (SVGs) instead of images for icons. SVGs
+ Avoid images for icons: use scalable vector graphics (SVGs) instead of images for icons. SVGs
offer better performance, scalability, and accessibility across various screen sizes.
@@ -142,15 +142,13 @@ const sections = [
},
];
-const ImageUsagePage = () => {
- return (
-
-
-
-
-
-
- );
-};
+const ImageOverviewPage = () => (
+
+
+
+
+
+
+);
-export default ImageUsagePage;
+export default ImageOverviewPage;
diff --git a/packages/lib/src/image/Image.tsx b/packages/lib/src/image/Image.tsx
index 01c1d9a898..5f3d1b3193 100644
--- a/packages/lib/src/image/Image.tsx
+++ b/packages/lib/src/image/Image.tsx
@@ -1,24 +1,23 @@
-import styled, { ThemeProvider } from "styled-components";
-import { ReactNode, useCallback, useContext } from "react";
-import ImagePropsType, { CaptionWrapperProps } from "./types";
-import HalstackContext from "../HalstackContext";
+import styled from "styled-components";
+import { ReactNode } from "react";
+import ImagePropsType from "./types";
const Figure = styled.figure`
display: flex;
flex-direction: column;
- gap: 1rem;
+ gap: var(--spacing-gap-ml);
width: fit-content;
margin: 0;
padding: 0;
`;
const CaptionContainer = styled.figcaption`
- color: ${(props) => props.theme.captionFontColor};
- font-family: ${(props) => props.theme.captionFontFamily};
- font-size: ${(props) => props.theme.captionFontSize};
- font-style: ${(props) => props.theme.captionFontStyle};
- font-weight: ${(props) => props.theme.captionFontWeight};
- line-height: ${(props) => props.theme.captionLineHeight};
+ color: var(--color-fg-neutral-dark);
+ font-family: var(--typography-font-family);
+ font-size: var(--typography-label-m);
+ font-style: normal;
+ font-weight: var(--typography-label-regular);
+ line-height: normal;
`;
const CaptionWrapper = ({ caption, children }: { caption: ImagePropsType["caption"]; children: ReactNode }) =>
@@ -34,38 +33,34 @@ const CaptionWrapper = ({ caption, children }: { caption: ImagePropsType["captio
export default function DxcImage({
alt,
caption,
- lazyLoading = false,
- src,
- srcSet,
- sizes,
- width,
height,
+ lazyLoading = false,
objectFit,
objectPosition,
- onLoad,
onError,
+ onLoad,
+ sizes,
+ src,
+ srcSet,
+ width,
}: ImagePropsType) {
- const colorsTheme = useContext(HalstackContext);
-
return (
-
-
- 
-
-
+
+
+
);
}
diff --git a/packages/lib/src/image/types.ts b/packages/lib/src/image/types.ts
index c78742f830..e06cce9c85 100644
--- a/packages/lib/src/image/types.ts
+++ b/packages/lib/src/image/types.ts
@@ -66,10 +66,4 @@ type Props = {
onError?: ReactEventHandler;
};
-export type CaptionWrapperProps = {
- condition: boolean;
- wrapper: (children: ReactNode) => JSX.Element;
- children: ReactNode;
-};
-
export default Props;
From be7d20dabe88b649f2bb50ed8db1b7761d99d73c Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Iv=C3=A1n=20G=C3=B3mez=20Pinta?=
<44321109+GomezIvann@users.noreply.github.com>
Date: Thu, 10 Apr 2025 12:56:43 +0200
Subject: [PATCH 2/4] Image design & doc updates
---
.../image/overview/ImageOverviewPage.tsx | 24 +++++++++++++++++-
.../image/overview/images/image_anatomy.png | Bin 0 -> 364745 bytes
packages/lib/src/image/Image.tsx | 6 ++---
3 files changed, 25 insertions(+), 5 deletions(-)
create mode 100644 apps/website/screens/components/image/overview/images/image_anatomy.png
diff --git a/apps/website/screens/components/image/overview/ImageOverviewPage.tsx b/apps/website/screens/components/image/overview/ImageOverviewPage.tsx
index c4c8d4780d..5aa798ba45 100644
--- a/apps/website/screens/components/image/overview/ImageOverviewPage.tsx
+++ b/apps/website/screens/components/image/overview/ImageOverviewPage.tsx
@@ -1,8 +1,10 @@
-import { DxcImage, DxcParagraph, DxcFlex, DxcBulletedList } from "@dxc-technology/halstack-react";
+import { DxcParagraph, DxcFlex, DxcBulletedList } from "@dxc-technology/halstack-react";
import Code from "@/common/Code";
import DocFooter from "@/common/DocFooter";
import QuickNavContainer from "@/common/QuickNavContainer";
import QuickNavContainerLayout from "@/common/QuickNavContainerLayout";
+import Image from "@/common/Image";
+import anatomy from "./images/image_anatomy.png";
const sections = [
{
@@ -30,6 +32,26 @@ const sections = [
),
},
+ {
+ title: "Anatomy",
+ content: (
+ <>
+
+
+
+ Image: a visual element used to illustrate content, provide context, or support
+ storytelling. It should be relevant and meaningful, helping users better understand the subject or message
+ being conveyed.
+
+
+ Caption (Optional): a short piece of descriptive text placed below the image. It
+ provides context, credits, or additional explanation for the image, improving accessibility and user
+ comprehension.
+
+
+
+ ),
+ },
{
title: "Accessibility",
content: (
diff --git a/apps/website/screens/components/image/overview/images/image_anatomy.png b/apps/website/screens/components/image/overview/images/image_anatomy.png
new file mode 100644
index 0000000000000000000000000000000000000000..87e669238e3b50ab1eede31e5e7db95e1ea8a126
GIT binary patch
literal 364745
zcmeEuWmr^exHbv`N_R;r(jX|^0s;;p-5@#AJv4|&$Vf>kEg{X&9n#$l!vI6q&^a`G
z?6Y;BbDeX(@Avm(|CnpmT2pK8^{nT;<6Z0XTNQb{N7Rqd(9rM{6=c=X(6BzBq1_+B
zzJIsn26WMS_jJ!yUH%nX$7T9Ynd99u@`z+C6M3wEKh~(Ei8bLe)dDmTCs?|LwJZKEW)7o^<)o
z+W+!Zbgw>O9?O(6J^H`?4%+>f8Fg6yuN`5;crPW1!IAm@*ps{6@cDN){v64F(fF_B
z^e-C!qVYev+wW%aZ*BZr8~@hE!oMTze<2V5qVb1E{6!A`MdM#I{uf^VAH&AKwefFl
z{97CUp=|%vu>aLW`2PfrTMX*jjF0++Dd@qoS1mOZq#}WbP4pL
zpncqcM+#2_$|~HkyKE7&IL_i29&{dN!eaX)brreOZ$}D%#JCn%8Pv8>k&$T${%AstpF*_tA66p%qf2y+?FXE
zsOM2yDX~9Y4}`Fg&EL4t%EsmB6r)_~lf~zn?N5)?SJEO3Nu$2(o~yG(1v*lga8voc
zD#VYZjnpw(Ufn3?!6;{ovXvVz+_6QG;#cru(HEfrWO=?INABYxI%J1wvs^*3QKHRf
zA==}vix?xL%>qBe?`8Vo-Ouq_165tdz0IhD>^R3Zt>|ND0z5>uStT6j&isgnB*Ksk
zmg&siM&-$0a?)z&Etr-Q6DcY<{ON)DKl~#g^0J>78*E;-gB{>30n53!DUm{dkgZKd
z!`o;eV*2eQ)u#RGG>#YEka6P(onqSumqcsRdt6idpWV7M!Mp(`n`U#{
z(aDCwu%R?R{4OH8It#+rINSS|>Oy;QEHOjQ#yc-SLxrE?Ue0aRW$OiyAB1Gc8-4d9
z_mNMKOP%heRpXpJ7N4ktMwqD8sqe@!O-)H=)*xd($>qu{_etkKE41i*0;IIOcZH*U2cY|_V0{JR(01I<}_qIZ+i3ObnHh3OC8sd2QtFM=K{+Dr7^5K?rAZ
z1ox(J_66f(%WT7CJQ5q>&PorKU9W0FTKE?PZAa$e{oQ
z)n`o!&JsiAGJ{4`c~s3L8(-jWw{YR!U(OsF``6#j+>-^>X_v@W+^&Q-Q47Dg?n84W
zV!_V4Ndrs{4Jx^`iw|X(WdX8^cDKiv;aqiVjUon2
zm$X5X(4vb$zW%i>2}oMagyH&=IZ;*kD{J?r!m-Wa%sAgs2xm*RhJ!$p?*TYazw+adNkJ1
zyR-Y)JSMVCwpVHBu%9MqP3$Buj0}saAz8=LrjG$73V!zwI0AR&;kf*o^lyFn4)80@
zdh5vhgxK7k7_N}+Gg#Jq_B8#Pu~tY+a1;jsI9JTU#DhtGYW*9f3
zZ!TPH3cz7@Q@s9kWOkQ|tHzPW1R9|FQ=^OmC8#N?^hCz6wlw8&?YmEsGe%_NgfS*b
z^k1rWaayFeAAPmNCRjye>{d3gDrT<^F13TK4z`O5RU1%d~t
zn8&{c@9J&-OQh7_q~n+6{qwTPrky&2Pzfh2QHmNMrWq%QWn2VIEZdklR0rkzW~>36OOlrPU3{`M&}X>^
zFLMQMN{HPCGg|yW)Z;IjTNiOHp(=SER
zJ@Q|C>OTJD3L}rJPhd2o7({%9T%_Uq;>%{fJ0N`d6*S~{BYtrsoq0NF(qO{0%O=}k48JCUBVr9&T3a-ceWEJptHD&I@NfH9xk{m=ez~7L3sg!Qt+(Y$yC=P7E9{JFWL*M$lK{4O+
zimb|ASY3LL3!@AReKa-hP3f1hJ`0XMKYMF(oQMN3=k9sz^6^O(_CUEirzMvg(@GHC
zggBkO*?L6PKHhvN2~<-A|BurMW<0&=rSL6bUUPO{s-M&;B;s
z!kJ|CQcl*kWM67B6=8~R=&+D6WXc8(ome12QKoq4ZZ-_5bjWn%-q6XT48nlNfTye?h*>|-^2w
z=kGE<@ePfJ6?Nb2pB!e!zC5mC(qlpLx5XCY%H`M)fZ47~%Tp#@Hn+yCfrglh_fngZ
zx8qc%PG3$Zv;*JhrLXpg93tYu5a@yc^5A$@aTuWbxO{
zs(2X(pm4uj5wL1N&a@E`<0OoFJMrLk<_P^+Sd)=a{4iU#GHg21Skbj4UaoyGI8#dp
z)}V7h^=Knu{Q7bEpy{+joW%POBePIu4Y0{~hiQ=l0|?}LbEje?S%5Ii96@v^tgQ2B--1T|Aqi1J2^IoGR9L0t>2jhoxbi(er44boHO
zuN+xzHbyL4DJ65S{2tj(*vzdkIwB5iU|Q#Kil<|QWXKR(-Uhukxu~<9tOKDGuyuQ!ID1DImAqiFp_gteVF9PPS!0nyBs-xAU1(K)`^!Le<^#Le`C}#vWEH
z4;Hhr`jZO&_lBGFLHuD&_gRjH7#BgI8Dx00JzQ05QvA>hN!?}Mx%7+x!RAaC8i|YP
zqhubPT5&5E%IGA#BPY_9LsEv@e)jzSHCdf-1izm{WHYI!R*a5t;=uIJa7=y87Y4rh
zvo#u-yZ#RB`3LKaM6Aj$sn)giW#g5Qw6p-3p1vH}esFGdE8!}jbNFfFm%PEmHdAiC
z4Os=$L-R>^gkXMrE+?LP^Stm=PF~6}WmKkQ?YZVx{F@{HCvU|NlJV?I;0xt!*1?)t
z5$mUszShxvzQ*oVk!k;2<>tf80rsT4fc%JdBIv3P8!Yfq`XLh}wusPyW
zcd3J9Nb*Bl3EN5kG*_R$nrkRs+3)7cf6v-APJRgmEg7v4(#?{Fy;1OCAG+5m%+=TK
zrNtWQmDJsw!X>fGssCDixNb}663q3JH!pJ49Y|0E#$RMZcb+@n+ZIkaC?xR|-=1#&
zYEGWQwR`TLT1+C)NUt$}R$>y7*bP5anW~B>V)Qd$1HPrup(!S^3nHNsXIPE@wn4gSmiXf;RsP)CFiLrS
zv!OrPu-|DJ&X7Gc)Fwzg)MwT!c*G>sdA3=m>f+e0Y5YRM+s!Z+f(qtObG1Jan7Ig(
z(JE{N#?PsHqPi5`zUXry0}UfjQ`S>a_qYN*e=;ks-YT%?*WJWbAO<)jyfXyWoI
z5#c*btC|sAEW#Ad0nV4Do9w-m7u0bsVSpK{vqFz+DTN`c9aXwap(23c&wTTg6Pa=T
zSHg!E{_VyZRQunuKNc1@hNx)2e{kkrc>3n-lgy`v&fLXk!r^kSF?$egC2Q0DAf4ok
zfMO~Cj(T5DUCm|;V%SgOrBEt&#YlyfabHvpb}!(|AF);&dZ$u-Hi&Tku25aVXqKso
zRb8PlML+G(sqXmAJe;{MA>8y%8D5U}F4i{3y&}WyX&$6oQ@k(=y?R2lwVvOeZ})u*pZ6SZjn5C?;nBTMZV$Z??cOWJOs7zR$+$?J
zOAGq3fjX~FmeY;B*41Yf`tRw^c;u1}cEF7@P3+eT)_8B5QiOFh=_DLJTaOogtbR&i
z6mO^H_yI0S^Q1r8FD)q}?bV3n%4Q`ZQg1#hEj_)^Ag0#~+-n>%^^*2nR+F{CN~xWZ
zKsLvJs!$jSgy1YQh^-JiLl~E0nNh?8nBhi>D&@J`04-%b>|B?Cs4M37;7IR^@;>({l>xQ&R
zqnvd+&pDBreoD2)P&J~W@ui~i;I-|?&PQLxdWXC80+1x-M+^D^I^VLa`crWFpI~=H
zFeXYx)-Ag}%g0D_Zh)_kUZ_vm(&ebJjm;=VB}=9Z2pRY!c;?
znSFxwTFc?FL;;8?$nP7-eWG{aiH6?8EY-q2E(oJLpU~y{0k@%F+S-e_?)=gldFDunlB~BprO*1`YFPpue9E^&y{N2F&7sC7I(*OQRJ{O(L`<7Jws=UXl(
zW04kjjqc>s|52iOgTY~G{N~kLm#L7=l2_$d0!e8JnY7edrxG=z0mD(GOcgw
zXN+4&C(*K&#U8@8Nng{vS9FL;yjeCGQ2zzc*nT2d0mK{SN62$^g=irntlhJ+
zAH~deQB%DRUeK1F-HButfTeef&8TX=!a;S#>s7Goc5lnhY1roybiBYx}V!U2jULJ$!+sxM1qN
zE2G`%Bi`QZ&~E@vH}@!-Oq
zguOzBlNR4XwEwjH>bRujJxOW9<@~1nwB~?mcs=FIr&q}0mVBUhy5?yGgj+Q3I6J-U
zWaH~pK;_#x=X%PTmE=9``E&P{c@-EscuAJO0TT-+CcgYzHA7gI0M*2MuhfOa!?Z`L
zO@`Ly!vz}IuS^IVH6>QreNHynyun+x0j%F+KR0nDs_x;(^Jk^Jan;>RVj@Q8=oeI%
zaAYpEf@Lpdke@HVC3DaBmFf#uH1L+o*us00WBw?H8*>TCL1)S2efWjf@*h%YOO$c%
zTL0Qr6#J?Z>8Y3&O`T%y*PHWgdT79M@FJMO^zq0ffwV_KmM_I`~?s-i*TGb0qX@7#+aftem7C=8^pn%
zf?4Wb#xXm?8k_Gtw$b~3*~aeDl^
z6?#fITykf=Zs@GTTf0$|joua|j0e;=dQY`23Gw0Iy1&{|BqPkkgx0O;8Um`PbT2VR
zIisCH-*PL$3{=vv4j65Wl@q3i6?p6GpGO%e5Q!)ySz1<~y(&{pG};~|M~Ydxl%(}g
zikPzTBaU6-dxpHG9oQ__12l4?9*LM_`xswxVAVirb-bwNpq!_}oA*8U9H^RKgl|h5
zn{2A@eNrcJ0>P0=`KvFAeTP3d1inwJQQZ
zhK9v)IP^~*lZj%oIxP}(2N?)wljy*nSqZi8?;X4vh
zB>z+Z*c+aMnQsKtEHa;};Rdt+;`q~vPl+?``SD0E{T{~w_ir$g6INn`=mKMf@t8ZZ
zt~hrs-%0RBN9awgn0RL4@BrFRaz~S$InAE<
zRdt%x>j#bc>M#mbqr+)>P|5r@^o6mxB6pC;3^dQ=!U5WlEZfV_#rPGpSQAep3)qX(
zx&HDc1^3TL?J0wvl>B=>!+sye8jGZ_I{i-alOIolrnxE8^LD-)q_-t^
ze@0jUq4+1HqB96C@ur&W=BGfD6Ki7IG`Oc#3Lx1M{0bx@YZ_Usy0~ZnZ<>%+u(LtN
zelcpub&xeK&Lw7dXOO$x`%EFT7jI$v>sX&>u<~uSu-U^F@DhTnER_6XLu;oj`P816
z^@)eHzURu@X>Xn0J(N(MMK<6%gW)6AkW4-LFe4zp`&(Lg0qs&*N?$jJFtcTj(j~iS
z3E6`Whl|3K^Dtf~$`niX-AR8u_|oB1$A*a({M7tL6~5~4SJ(aZS8Cue+-gMyubPl~qTfCZY;h(OsvRNo4@{2&u}PzazXkdPhN)w#2YJ$(Aol
zT}>qd7mR9eeQ@L^JlDyc8pVH7u)_1m;i*fP*e(JFQ+dBFBN7dVR0
zz#$~c!=;l@w)V_pT>VPsrE%~}QLNrrou^l+V|?sez;8`WMx@tMw)BPwIjS+sDoXhx
zQJD2O#qfxiw|@zK=eJy5d}k`oh?^1zt#vejp!~_q-u(oC+EF#;xRao2%|r~XY&EWiAe+u*Gp));hjtyX3XjyQCk|>8ZT1R!y2OT5L@&M4^-QZR_^p+W
z$NBozyu?Inpo)qKnOmc?N|`7na%80XfNg%$%WU1VGy%jDchzm=efm|;*&oyVFNZas
z=z<()glDNj0&uN{%>m8idKM!DF-9?_1g%Bni$KgD3qus{OjT#=&MW%V<|hbTGY$XH
zj+f>A!1gmXD%}s_1ttG%<=I|&_
ziQaj+vw6IWlHB1jmvzl&nanbPMH64{^rjg7$J}#vTOUhb{XRcS??CaEdqDGdyIWAX
zj{+xTE)q-}#wDMGSnKg6cGlR6SCWii^QY`M!doyM$JD}bSL%%DN@1O(*XsIS-)%M$
zyY<{p{pI0${E`mvvvRhUOovP3#0^YHvWHdh1)U+ReKh!aq$g
zAK9vby`Z962JQ*4TwooD%zRj*hQ}6_`>6?3S`iXoIJ8vUl3^;M{+ZO8wak!;4LE{_yJBp1x5c
zDj>^@odAHu(C%mQ;APnaFz0h9#e~MlylhE^0F#E75y(Kxl1d08mQBv)dX6N2DOO)^
z3T~TnqPW??<2w)%D4<-FrT((PI~fAG5N1#Bo5DyQSeflGCzU`yEe&1wLvO;M31&R%
z+By>4+l2LPr%EJH>Tq$z4F_5XQ;Q@m>K9okKPCHds+;sWl1;nu@G?_qXb=20x=Dp;
zXC1#o*|vHpBcu_r3+qqLd1)iE(*D-N0)-ueG`QSZ>usX6x=$qfNh~*cJSooddM8;G
zbJ$A+_`QaF&?k^KzX&odaf4||^t}*Du;V*5A!K2DUa6zu+vn4uqfC8N1k2f!cebor
z&3mB0)hUd*R7j8TE)k(N#y3!>EiA^~Ojn+}mr&t{=8bn~orn42P1ub@)$5+9lE%hw
zqo1;ii(vt^`KtulH40Sa`Zx(c==j_lt`4>U?3SzV;hm;m%HOK|a~Kuw^g+Y|cF^DY
z;4$HTsDVdxnd)^)R^x-mVU31|lo5sO5$DQCtSd2fO7}$26#F<1@@W$wz%RlpHci$Ya4SO@YROix_Cz;!$
zM*QuXpWvTsI8N_axgWh`=5MA%bN?W$L60Y@?|!n7gK$=TNRij)nXBY+x0~Yw
zJPwYm218A{$063~K;DMFTe4IS^{Dc_#o?5kkb~qeYn6q{Cx6d^!AnRaq&eIgw53gh@5Ntn%z*J0Bk((sH%>m
zro~H@wh#gvpN5Ad@+@n_@C5}!?54~a@SEA!b6$B`5w+}6$S?^Il&jDI>GNfMATBXm
z^ImfHbj0J2>3*N$a{;1=l1l$`I2jtLk|&Lw$FcyN~s09zv%Z5dCuSTTl!a;9h4j0
ztLH=|jOKdV_GY%2yGmz?v3{B!&IsAwhRb*9x8;y-T1lkZ^4Di@>WRLKhFMSY^j{d7
zgt9dx-?c@kj!9xytMrOSNO>*JESx{_O0}KE|7>Tla?P?aAeSIm7^$*~dJ
zswL(85yV;c&nLz
zdq$tV
z!??WhWNhTrWrlb222Lq1T*o}J;RoU)l{#nk1F&gk6^7-tJN!eIn
z{EpL9h)253e8{zLCuf~)&zItTDqVL(zIFOMVqe5(Il^~nm?|9(TK=*q`LtfBcn90j
zcBA>ioNzM#7`Kf&NW$hJa9#A%9KX@(`$RjI9W@HU7Mzy%CR)%3Ms7WGp+hHDgZD(z
z1O>f)P1jGjN?*q{SViVtm|)q#u4nUmw9+&}E9TKF+PQ5^6L(O8VC!eG!#NK2MC>WT
zMiWnh0Ls>jZ+$fcsggE)fYY%)t`)x(`XhkEJ1aZ>$RBL
zl$3nf=2L>!S=Vm`j!W*m#4nGjt9pvL5GZ}n@5TE9K8%RrxbVzD
z`)ZB34&H*-j%Ko?oPb21Bf!jEg?5l?YHbKbEvNOJH62BUfeAM*U
z`)4J4&+w1N#@^R@ulLtLp&z)(#aKgbGaFk^oRZvUoqzEud674J$mQ)ca4u1ki
zHF8}E%$x(^+p*p7^>>_%NvZ)@7f6yz@&^6N+Z4&*Pfb@uY#s)6*L~u)0XN~EhSVhE
z)s^*=G&2!!mM*N|vVY>kvs6-N
zkCD2_?P3P>*eQ%nmw<^rpTe9lrg1CP%@-U#NQu0W|TE@7|=++%LmmMmhXd#&mP
zp$N$WvociwV-ytl-3O0|$qTGX)A(Kh|Ig`X9Df%j=yZOj{CfeWA(W*`jB&eo8egxf#qlSSpSJj?zk
z^q|%DR&ME|#3)l|Y-tZv1q-cPIgm~gW`uWh7`q4O+FCDLCkAWp!Z_Vg#qpfnI737m
zHZewqwC^e?U*2-Y<(2wmP`|7o&)}b!nUFZSA|UnP^jfmomo6))p{!I9e$^ps(8b+w
zkFFaE?P`(4{N~!S4%woeJXQnc&1X6~SH6yp^UV`RTlF^ILw>sPHVyjD
z^NoCY{D)6AV&3%yh%^!2-^W#o$qA}aD6~iCQiGFVTPH#pYF$uD?(L;27>lSu}dEdCvfy;Ie
zANWkEzM!GIDD1w&{8gpF8~flPQe=vz5<|(1u%AADQ+|XKXybA)lylgB$iu+V^~KT6s*lyT#;@UT3W>Xo3QP7`k6=&3t}MZGHv%YEEDAyKBZ1+D*7=B)Ca(m`Mo-OZnA_Qc5Ey8^V_
z5VV|Q1so5~-)13pB`=p9`z06m+a>o`)35XCe~>h_pB%uCPOG=?)rueVS#>hW&$%aS
zHy9)#8bhtMo#3Uq_ioVWs!@itL+cNobgV|A8}zlSA#7c#Ekg6pQp=`b$A%g$<$@lj
zz?dADm~VxZ!8u`}vl$7mw8=tuZAK7^WTWqnYnPM2pk|LmWVO_U4}8+FclLd(Uqnq6
z8`r7Nv(V=U&nC)_N=6&OA|=4O;M9q-Yl~~Wl>z?43!pQ^&@r2=3NCp_$7xA_&G;>Ob}9ymmKwvX|#HO
z^=Z39*oW#Z%AoSbC)lY1@3jhpT%)x*Eo&0?daqYGPm{U&3i8h3)w!epi9cWgDLQ{X
z)I{C!m%n$`Mz}wD#B+PG*CCh+L0k-9t-$o+KR{;97Gv8mg8~FQP06Hh51_2=z
z;*#rSm$(Vktj>sZvTUkWEs;~Zv;S6E((N{cq@wIUkz+illt%0rF
zIe$p?h#G&tXW!?QBzfOz0$%HUkaxJez9KKk6zsH-d*V==uwiJybV;pzbS1T^epU)8
zNIlaWzc^ty5y{X`432*WJn=fw*>g%wL8s2B@?DQt$dp6;Sz*l%-6Nk
z7Dm%e_jUm1Yc<0KjEdi_QpNE1?36rOz8yI<-Yb!A61Px+n`{gI1O~&2>%G{z&Uc8r
zEFZY@@6z*X8r(WKYR_afj?Rv4dwYN)?DW(Hq1L_0ExXdMyn_Zh%|v2eU6pIl6^0mx
zmQZ@+c|kid`cBHXCa=I+;vL2C7TbFALilwwJyk%N-jv_IPQdY{->-kBIEp^p$J-FS
zM~r_D+cyyVs!h=UC~dML_5#{+dwDoK>~}36aI+_TQ;9&MGEQ5JfY7J31B%5tu<
z+FZz~_Aop^1oOqlw)Ek`c|cSOmrHuz?H%7p0G)hlzZ6yw^_0Z%O)Xg2+0RJ5a3A*g
zsKbeZvjRjfODkg$3nQ2NdN;%nJ3a@1Um~4_TUCyXBW`Q4{@#3_m}9zlC(|o;4P{r#
z!N8@FFC}AJ6VPg&@nh@r_eY#i4WL&37mwgxlcFy5Pu;&P#7Co>3^`p{b05cd-x0nh
z8KS+2#Tm@C=SmH2v(iILE0^_o@D<8`h;XFTrNOo9jptt*&X|bLBwJ2)Ah)3{hv50M
z;^dYyv9~1o0lV|J5IIoki)$h5GuNVYKY1@hE=x!`X(4ZPl^A!)$?BE*F}BS{69g+C
z%lbeJ&X9I(1>UDT9#++{p>C>3*YS50KiLynX`y-sylyi+9X3sGu~%4}jci03K2B{^
zqgt>dueeNn2VZr$*$Py@4dO4Tj*php
zriNx}XW6EyhMzOSDB?eZ{l9KUQTR?4;|_su53e>Iud-T>Yi@S;{87a)MD~>jjvNYh
zb1La;q&G1~a{qwPU<=vos1RUe7iG4N@||5t%kj^(*dd
zk4EQe1-3WNj4V*vfnae50uuPW?|g>#gc4ZYP!|u3sm^kbRq8FWvF`ij^V0p0DPOwT
zL$|oRbUHXt7&L8}-_i%TeGUqQPL~)}o!M5XChyQ%uF1uzKYcFxrR9wwMAbBBk4I}G
zs9cJM9tzo5hS$Fc-nPuU{!*+86o%(_kC%@A;!&xC>?8zdLJ-F#Hc_
zTF!CqYA|#+GJV;Tb#7ShD&PX^wnqGFv%*;n*N55kRu;BBDo6*qR@C)wwJNK)A+Hdb
zCNih5HM)^|fBvyBwAK=Y)4xF8a@_++>w_<{--6X)cWVvkL(7^6i=&ip9>SMcKKd?Vf
zuTivi(^xy|hX2_7Ev)7;NzC>W>bTxOh5XRh_@rkpZSOd9R@6<;_^Z#lHUt2)iw80F
zicMeF)afwMro&sg9E&BW`WsLj#OOdX
zuKl@qw)sZDQ@7Mn!QmAndt!(ZMW5TZaV`Qcb9FfC5e{^
z&8kFtRMJF$|#nKr0)9biql7jB*&xs^=Fi
z8$E_Rqq08Rxb0-T)fe>50QXcdbp%1G?6^rUN3Pog!U(2P`-ZR`y|jn4yZEX5e{@JH8g=Kw9x_Tin)l|Xqz
z_~92t@Grc3y*z~WwHFR1>H*I;p!6C102@WvkxlKwFFR$pH
zEYtq=<81+A=<8u-&h~}OS7!ui?Gp&pX>iHb=H{gC8@V|w{GT4(&LuyFzIi`!CNgLl
zlH@$sF~M4HNbl-oj~Hx!WLB}8b1iJ&j#L^FnCx9x8*)LNrmD8H&>W2oaUUM3XZN71
z#s~<_ftE_+?t0YKuh!TkAjv7Gzkhy44s{(?N1l<22^gcxsWd;gYdYWSji}Z$5MI*3
zgn|cSq;^yy?O1gyli4zUs%ZaVDJe*+>Xw7JFflAb8l_K-Fg5N=pj>bAe5bpaVU(e;
zvnVGkLA8=RR0ZTxGxNAI!}ICj`)8K8%3s#(-*x9q9DOUc&~n*-+utxd6L8GYazJ8o
zx%ro>@c15QNWh$-T5*BPlY5xTS@Ugl0QG54L-CpYDK&h7TL
z1Dq}}zqAy|kg}B_ey#&pPeA3kZN~T&ay8-ilYeiIwPnw**xd_%xUVdC=nK$;Cg`@?f;X1-?EbcadT8bj;!O0tmUvEG?!V_z$3c+-d{GOpaSfx
zzsF`p8Rak?&fjhN!_32Vq0iX#_^VP*aHq|uPs~?UQU;OC-;o7BoW3?csObiUNM~aU
zQV?;CdK`RxMKQr)68w0G@=qe0{8u?s(FWd?bGOoh$+_yyrR4dzq)(z~oZD?z07}w-
zS@JA#-csE~JnVy5dqTG^U}4!8)d*iVV`fRMFrW*)8KW%Z(-rx|iz#eD*DzD&+A=-d
z#n+`Z{5~Q^_}m+3NiYw0oX`g3DEAoT*QO^zRgqO(od$TbC<7pz^nYHsdeV~|(SBCt
z8@~OvXj^cVqmJB1S*3rmq`k&%jwa`uq3ZgS4!`+lx&+ys(!yH)d!nloPLFqByMO=?
zD%^Zd4u440#pe{<*{h|W%x6$FjwTY7G~9X|(&b*w3z0uNXK-ad#plq+W?QX3W451Uk38hXoA*6WjG
zTRjM}qfZvC{p`7=w<`{$6A*M!XA*gFGH~WXR(~pQqGffByXh&ze2}4peWl>uhJoAB
z8W~y-NAXd`8%rS?Ah-{{81${#FXm^(OF>IzkrbC&9brL1oW#yWdM-iQrGTTdBE5;P
zej!h`3R_+qkTHrl$DN?c#-)wr1e3!md#y+%c%ucuRsq~)raH@;`=U}SmZPx)L1yz4
zAO4~Dmw%OLI^(0e5|x*e^7ma%y*@s|-AxR*_GrF#Xz>z*B6pkLcRVm
zAj_z&8N8W_oikeAfC7i%Now&6-0-EM8$YEpPWm(~^RzYRFeP+0wi`C^s;Qp~EiUq&
z$t~@fD-shgIr3abLNxiw3}Gw-M>(_8Y3jF&+<*ZtGe0N7dL#8g434YJ&DdX0oCI|@
zWY5{2?Um8Mm=dAS0&&`>U=La@6RLXj_wCujDexN>1!P0+;XINr$BzaXZRNE~doS-R;5eQM65;kG)@(ont+3+*6t@z7wH;C^(j%%oKF>7VH!a;V2G5
z45At>#feBlb*p|TSaUb^k>|_MA{ntQwiY1?@&1#QwIG*(bYM-9USmX+kq}-1zW%Ga
zW@sM8L_zUY&TJy7ncPKu#W6Q?-|$5ZrnkbChdqyF@6A>Me^!IjKVdHSUyPwm{`uV@
zjv+dm_rHyDm>WIy+dI9Q30UpEy^y@6FkJl0o1CE@xnbT&zrBb;7(NW#qqt|UH$~#+
z_crnHm}rVFXh$O5)K>^@$=;DPkU~pa(AJ25!-1~n!34lDYGdG
z_p9i2OAN*(*lJy8;LNQK*1*#wn_!I}RTkD6DH?hAF5e_|pJXjlm%uLD4Tikbo4
z!lMuxbLFnHL>%MGm+bPiCIurYr_2CA77ll!RhE!R4#}hcQ0(RM=jpd@At{4q+SZY2
z@BqK95Lb)Jq!U%VnhkKZUX(PqwzwghXSj%#Dj6UhcPUy&hQkI2T+204RBJ3f+cjL-
z!`GAa(+c~5(P+wiAzfXqmtjNQ1-~IT%!#VQhVlt}Lb+VmKQe4q@lFhn+2g+}ihHQ52N!
zPU-G$1f-;6U$
zrSSK3dr=Q(LS=I3h2#B)91`<>wZ_jpze9Z`IamF>dM
zT;H9Hhs?GInD6Y1KdITJrJ%=6iu>sMeB>LvNRqOyJKWW%Ix}WHk6?RZ;GvC7ujI>H
z5nG=sN8NKGQ4i`|nbP%aZp1ko7Rh`BF)AVM8g^>jm
z`U!p$1Li8|Im?pfLP?*B@H$?DlOA-O7wjsbBNc1BcuM)tl&Ds1<6{L~Y5uYc0k~V$UB7qjV-}>yT&twNDLC~eOQ#aZS%zcS|#M7n?4IWrb##W!Tt2_RW
zVOIKw3a$_-0H08m{nqa6$kyw2;|PcFbe!mEXz8ZL_Ni?Nj^ma#5Al??t2y6mZr>B6
zBbelhBNgRv#i-b~=L1f)M#gWN@Ri@&AcdW83d8JDjV_n+N>HSCMFx#rGg!4uuY{&j
z@J`(bC@yo)#u%uCJ=nx^h}R|_{n<(53PxOIX;oIF-{
ztKQ{#k4%Pe=PV3-S7~Y(5XaTk;Bl*dR&IIAv>=nQ>6pP#UhP>Qic1_E`Au?
zzDTQxV=uf?$aX9Ka7VJ#YJBw65=?F%_sKTwl&<=n$y=3;1zpl&UvFi+evXoci5Z53
z{bk~`3WL$1q;pytTqVQW!qiRy0wbHr%!iR$10NG(nO;DjvJe&6)pdZy)K?Gx=-Ru_
zmFObOrUr~=uh~RAAgE3Fcj(bE1bzl>bjsC~&-^eTzm6W)#9JGDZW^|p&fD(t&VOvw
z3E1HG`L(&qaRP!*wm$r#Fh2t*gj%@IFI=)rZ6p>H;e0(LE8bf+26?bW(8mW)e}Zt8
z2O~XBCH*Xuw3HybF2~W_BNfn}cQrFCBNv9PUo~HrmdWqbKRZZqj!0w_TTlzD>8sYR
zLU982(YeO=QIs!Z@jk3(pQSYEufHK<|Wb!*~I0McZP$Dk^Pf(7*(&jA)$GuuSLpG7We
z8nQmJ)-7P4exgme_}z#W3&K2O5R^06+O3(%*A8>Y7SdM{c3Gj$q|^{s7oDtj=Pew|
z#7{i)BM}|=TXqbG%Pi_$61=bgudB6P%|xJ??}#bx-8eURUzR>?Ilol910r9qop4?J
z#2ubg+&b%)yrfhW?RnMZ*Tg$mej+}mR|+a>zM#||oi_0Mm8)nc^X3S#C2JY4!QLAc
zp#j3rbFD{kdRvr0gkkLRDD0U4@qQJiToVP!HfC`VL?TLVq)q5B+#lb%kM;euz|$|6
zx<%M3a0n4p443vLbZazP8#4PA1M*;Y-w_u$@)|JkGTG1e2i3QE&braCzlmK~P{b$T
z*C;e3UU{6nAk{TeXq(T+)<2MmAoyD$Kcs;-sC@Vm0N*492Eq;6_8i~Y?t&SkzpccQ
z3+rNW!D#?1Mjy0tKLvCaDt^8xw`3!NWW~B+56Y-FF@M^0ETTb+?TBLzp{d*8=xOW}
z>fyTX-ClAgX=@eE2NT0+_?Be8Bt@!M8=J`)MZ(+g*5ul1eSlG*mCcgu?dgELN4HY%{)P
z)(nMtjT<%JGPLKd&8DGVj(z#z9Vf)h?Nkc*W{QjPCEar)-L>16!y5{PVH*{Gj|`PC
z7Eyyqc3ah#`$kXKXDoUyrOH!hF~X>3D$(o-0=kVSwM5ScOV6SUB=ZBSV?vcrZ}GzX
z*e6P%JtL02H`*zB#0N100gYPJ;{d39b3{8M^QcG-j0u-j$w^ubI5#-@?2
zhs4|}LPx9Xbw4MLew!Av-K|}FTs9@^vq>ET#hoUG2kh0A!2ObGV4c;LNRI{)Yj3?`DFI&&v
zD))Rll+v#=OT2Q!t8DBLX9I7xtJC^h?IY8>*@{$4A(a&~<%JfE36@&}^;9TQP2Q1u
zuW!Q$V24DG`amZ}tK+z*b-m5Dp!@Tb*Dh%=zBZkyZJ2}i8llU
z!GtGU%U-O!a@RHaQGWmHV^${q$>ogUc}aXxF@WVQ{l9nQf5(XFhUh2fReX!(oaL_c
zDiS25Jaeu!@ZR>2+ogM*fXU$u7VA!?cW4;BgYE}rHZ61v+YUdxdFx6kVInk^!#uWl>Ud8XPnm^ZYflKj&2d~-)&vx^W24;)I`79J{EgM>{RPbMIPXtGB3Kdg737o>GmV8bRfIa@fU*)^dP8s%$=&ZQ?I9;V1BcjCCw;imhgC
zy3SOe5s2j~4LEN@i_ew2KN`_AT^(~Cd(lWD|NL&Ya?Hg`x>tLz9Yx*JFCvkGW{sN+S1AZe?ahn$S{%K^8Xnd
z+K(6&!3^h;jiPIfZDO&ox48W=qHZu5Z?xbSYhyhRXX@lfagGThw9nL8hptDu!dWOSwi{zNH|Vx4+qoR2)0I#)I^Wq=JR-PGU+e>*s+lWUFoq7felB
zcVlah`P5w-NS)=#y;tVt4DBK}Dt_x;kG!gUm>=+{jW7wbEoegjHh+xo3~=;%!$
z|GAC4=IeD$V&;$}*Wu#I!>UbX{z#vnJ;rdIw~H`$1RW7<5gN8
zU9RG}fYmvbxZD=J{yWLLAGdj>fkQ-HV+k739)SlA`=l|p{7yBg?^)cL7H9HFTop_l
zyviHu!>(sKy2GhN?l5XX^6z>hcI1+S-U;OR$%VAHJfEdZ&t1oMkA>40{BDMqJCRxLDB2Ulh$s>)L3#cm^@R@JSeC4T{d_5D%JLw!SA#z2j%O-NibnM5sTli6iZRq|
zziW0x8fvkw_3{W_Y?NU8wj#VwY{@h$?JnBP~HiUoVg7#7LSJV
z4A020zEY7C6Nmar4?jMtUhYr4knH9q;C^3mrR|(W);r2-52L0b=lvD{$ePo!
zq|*s_Wf|?*s7tQzed+3Wv5faO<6MkP`VcHvhTZWe!S^fp!*a0LL;qb>VEG^6{xM&?
z2zzAj<3vXE%G(Wx`_H4=L2++#F9Y(CF$_a@k|ohYDo`UahWEsf0KZp0Ud)fFHSrS6
zC@@V#t#5U>cs5KO0?ZzOgC~}ksXfF^!5;j!I}O|7MODLGIyF`Epy3bKomIXJ3?(1h
z&}zS5*}ic4qMQ2z(o~@z;!W
zsGH#mZc-70M|H>=e^tNDAMzNV%{zD=%*M
zZq91b!%uG^RP=ugRVkiR3=@T8!~#+%;~o6&C+oU-$;cVW-0{QP)zL6B4?0
zLFhr>MOfF+=Jp#jyOIA6{m??ZejQnCw}J{!Y7Zd#Tq7-J+e$o*+-VNd$a8|tiM(I>JMu-k+SamtPYvEy;>2QGcN%SPI2$dySNMI3-!6H
zyxRQET)9K
z?NNUS=*JRDP>>zJa9kR_u=ftoEW9|EP0{kvv$~PnZ=`M4eJb}t1b=y6E>49@pyxi3
zAsWJOipo+%Ns=^us5ym^X354rq3KPfBldv$KEj}_A0rN2y%Q8X#TSPSZtY1OO~Czl
zT^;Sy%%3|X-vX_D%MnInWcTgPUESd*LAQ<)&q4xu2k%m1!9Wi)%AbUHmFRD*WycEd
zR)k@9QotJ*%wON18(!xxWwbn8!&+}2aiwW>a7O6iaaB$J*}3uEdF_2-V~I}Y2ajvV
zpSML_!?l#pcMVw!$d45L^I6akr+l0n~zXIotSS|VMf`mtUl*AaW!
zs}@k*Om^0gP_`3iTvV=oX5s8vR5>ub6LR4>>9=rNIFQ<33kn+=V*zK)|4tlLT>I(V
zu+1ttu2Igtl1WFsfsdjgo-{c{lFsf`e)bd4cB5#K{&Ki~%VfdR%dzxnkT9sSTBTMf
zp{sb!epW>i%aCW(i5%I10dt4Wy
zZFLL=K2815OHVHPAMXaK!4=MHwT96(9gF=?C^W33@5#VvbECJ>=eGYw@X;|muYkU^
zLVX-kY853c0?QecFYcuvw%#~63(H|*^v`V0HdG(3BXHu9$qM||{&-)YuMylY)dTo_
zNDdg-J7fct5=NK@o6EW_h6$v!N!vU+>|IkNV`;&t3-hLw49eQ$TMB%O6h?JLZK@qu
z-}`rg)UIdZN|cCZOb_C5{<=5i5+ARga9h9fVE?hpVl2;>u3DDP)_f1|mVzN0P1C0o
zR9+NJnL(~_Hp=*h-_0UW8s{Tz-9RM|`sm8r7visiKQW0Bu=@KeZ57OHHE)pDfcC*N
z!$+&rjvZe6tsp$IJGo1<>|MgU2uaY5n_+zW>a?}nik?!WlgN>i%cY0K;iSE{ny^^T
zogRaS~xt%$2a%`kq1$
z(lnL}Ypad+O|Ka(1F4Ab+VmIS8_SV)s;5Wly{{5Txj3=t<5Az!-
zO&>dPQqmW>SpdxhHfm8Sno#tu@mg2TrPoPZ)eJBwCY11$+etR@5oIL7^azr|IvO_1}iiDXvJ6N%2R!BNw!70&utF4Yg
zv+>PrGgecR9o|*u9OCt9M^|gW+C3+p-PUxjZvmQrPBy`>{Ho1k06#3&q`22fhTdOp
z2lnxfb`(B!DJ*zStgm50!}}tlu&ylpzy_vaE$%7mGgKkAIAbO$%vFnajo6*a`@IXs=nCK1fY}5s=OduB@G{&$W}39rDJ5W+4ktV@_JaPnO8nw&+xcGG*@5^&)vznY{bTnQ^yzVblnJ@etujKAg%xSC
zbWc3AVz%eU&mIX8m$hom^GV0E<}{h^5>^?M^ar!BJyaJkZX7C{Zj0gPs8y94P|Y=I
zQdq@vm}>h||6A(4xobb0?a5i*r&94V3v4P#VzK>AqoW9$DWmhpc@sh8hEMVW0}M8!
zh2Mjx)7%b(&<|%jo7F8e>#bXhxe4Ct80)0c$CLbeB@0=3Qz?zD6gx3SoertlB`6-RdkM3GS#VKjRy%0GrWB@?4mC$D=6MKOb^o>
z_E8DH@)pqSd7Q*1hz+6>n;Au6=-LW|5n`-ziGEl|C#SvXTw-Z7#BdFM!Fcn=skKmw
z{*p)EL5M-fg?o
z@O>m`J<-ot`{27t-_{LJL`L2(DO@~@ixf2l9Q8p1r
z>1$TS9sI7cEO^V+e$g@BqC(nwkafT%Li;j)|E0dCnSmV(6#V4TLKop2KlTj7u5@BE
z?RSx|O;?aiD+2L{V$Q|I@!-*-#Fp-q$tHkn?D||*O%G{)i$j7MPB}vBCJclI7SAuk
z=(TSI(Ozbny`cW=@%~$es0N9+Xjq0}pa-8B=d9;MVAHKr);`~_u99Mp0$H5zIR>%p
z{qD8R?o4Ep$0vTsGFI@u2~J}LotyzSKQ53Zx)9eOKty%g%_=`z{5fl7r8@Fn>?Jr|Mc&QE=B|#}8nb={`T(B@^`D=?~=+UzWc3y!`eaZU!lE5N@!~6I-u5
z#d^pd<_#Y!hB<``mpBpJf0Ly*68Z0=eT6X%Jl2V~U12;{ou0U`-43IFPL7D#
zh~FRE8S%A2Qs*yuBbwTnRSsn}4i>6a&=vx};TjT@F&8_nnE0CR
zQtk~{i)kS7Y2el%dV0avWg1X+VYoN(m{kkfn+~>@X*RNQoBUixev+S0AS2Hq1T8U
zEeV$xoaEy_%mJV5mriD?7^zUKZpTzU-(9)LR~E}NDAZ(sIlMNtbodrNY~w+Q`!5`A
z=;3g5ae4O#j++efU$xvP51#8_<3)Fe*
zZIgGQ`w2a(97=DE`Rk{A^SS3J@6
zs)#I9*0X%cG(Nu|hJPMKEZ9T!$Tg(KHF;Q7osyA@0D6qhSo&V!oW2(86He?TpRB4IW@HS;qa({0P@Aj
z&v$#Az0DJG%;WK<{As&sSg~7&oZE
z;&M;B=1vX9`2!zGgC1fN_6M`X-V6@oQ`8%O#~{cUUVSSoK3t5VIAU1BsvO#H34F2}
zTJsX>8|=od2D#E|I}f4tM7XSdW0cwq`;mAm+qOv)H%G55u5d?qq@1i
zpRIoD0Rf<;yMe{Y>xoQzV~Pxx#W^KGr5?FDpyHL&&J=4}v=q*WeS1+KQ_be=ApWu6
z@{ydR5f?X0e&6(;aTd@DyhzQ!
z^>Qt@tH@p#i;P)`h=4@r+l7>8@?rT>f4n=kqR^p0YS`X>?LcFZ7ba;w6tk2YPq5qT
znd6>*dYR)@{P#=r#IPyv6xR^nl;Nkh?rC3cOuKJoEy!hjn-6bEdR#t<
zw}GYJb2HkC=6$OQ4bNj^NO;5sv(gE16P?CU6&-BnmP}q!0AQp(35M?y>~DG%3dJj$
zSaYmkCNr;p#}F*TWQrL)%iwfe9d%q9kqi*cQ0w_q)fHPstuw%TN$_sp@knk`?o+|n
zBCbFL5(Yd~`xOBU>D1mziyytAxKO9mpz+AK>M_N!2;AIQC+b`yS}7@uADGb$3Y`vC
z^u2^XE1nshV!pP;Df+>%TYR+Wcqw-C(39j?*02cyAJkB6&BJuB=4*OL9h*0O%UTXW
zPol%~xqyJe)~SigrXP|8iY9wTPl@eYrNs6MTxjZ*IDN)xD3HZ41?jpV`grA<;L4E2
zsMfdu9Bt{J>Xrw4jJP9~+;K
zyz)qa=YA5Dn8=9m&oVZ$(_^et$WN@d|19v6AmG1!>Jh({RuK$(+P8hoo%UK|MDP`L
z+{oYd8yvvs1n+@r4G%%RYNS}9%~pods9eA`=MgKD?~OlkfR0x~Nw)6Ref<2)k
z$wKnnThn#vb%sP{H8a4+kv4o}o}+#XWoG(WG8E`v0b`ibOPn;g(@#ALopiaM;AKWwN~q#|)`mf5l+jTSSV@iDZ(
zke>^i(U-J+9E~}Ucja&SD;uiOBO+W=Otv%yi?QnpK%qd7J%+_S0-e(u0{${kXg6q;
z^q>9zBL)IVN^J>4#BOA4_?j)%bKe6b@jHFP`+naO4e>ifBct&sipLIDG0Cj=Cwf%B
zI&BM)h{}Ga)U*;(4(ud0DFnnWgc)He43u&3rdT#cLi_oU_jO)UwknTjp&_#)Wn6y9
zR^~nA%^z+VpO&xM@7>@aU&1t-vHuAjOMOTcySv#FVqOuy)L&rI@i`d%p5hFvIPD80
zODO{)U^{Wl%XN(=1<7Lvb<1
z8kYfDqs44A&a2q3u5y_|tin4}`y^D8VR@T=_V%m&vVPlU^X56@(epu$H9^*-LI~4>
z=LZ$rMr1kwdrTuk*NGdqnm}5g&h8EnW-{9dW$C}8bU<>C0_2+(csrPilQKxFo*mioDzL&6S
zY?8@JJxg_Q56F@`Mw4^%&(l+6L78JRvt;-n^PZ9L{QA~xQ90WF=;b-Js3xnKGL8eH
z;;;`F4+>8WOBX?AZQ;h}5#$g);56%qLk9Jz
zzWP^;zXXvH5xmhoR!IIpPyD&vh!@q0@AcAsTF*2F#5?0D8_uRm&}(}TXf=Afk4bVF
zP=W*$z75w8RIgCFoT*6Sc_m{Q0C*u(bh|6dI=sPp()3Chk-}+B9U{6mmW)_u!J?ln
zuYas20+c`c`$$9@G<6
z(Q+sbAl`g+dFL@Jhzjdr}#zHdaSn>rqEeRXZd(8Y&%i~!ET7qFV52&}OORk7Flf86U9hRly5)M=W8-tcT5C?!-Mu
zA3kSLJ-@nTL~{HzJDTcNer`N%#D*694rmM9jh^|^gnlAt&L
zb!BA$Q%B{)XbYZ5AgocdtU+Mb&*(&8q-DElTK;27KV_LGhdsh{{Nm-{u72l4Sy>@b
z7|{hVi^%cB|8X&u8&gJs!uJ9o(^zt@9x-u2-ZMC7?k?iYhQcTfwBmn76t9X*H}~M^
zaP|GD;8_Dx0v=du>)o%$XLaUr37Y=J4^57GB&3Xq%fxc9xYUGaqX%oz`{PrFxMVAWyf6_4>jpWCPV
z7>xFe48f)^mB=;C4YN%?v%-_mXj{rNIb&g1=J!3*H%YEzImuno$%1G#wCu1=ZiU?e
z))xFK>Tpks2=bGBQ?YNW8#T&VP2S-u!Nj_IrjLx3x|!zygKO
zOR>lE$Z@&rhF;V-L;$ng;dEMFl&#OefDOtBqHYak{srQycY2zSpmIF`G=6F4Gyg}O
z9YOp?j$V<0f^?I_ik%T+cR$U|*USRh@{yJnKh~((Xb-OkXNDvH@@44
ze78*rbIwb$?$esPIZ{x2H^y@a=IQd5OzPetb{(`dVf748#(an`eYHO9
z^Mb)t9`M?^Os`Byc2$k9Pgh5&_1CHDHgy@!R5l`9BL80Zvp;U1$bEG)A^`K%TVwnyF1bu}>)z1b)W*wKulm#!b(`>|>K6ru?4PhS0qTl#DoF
z1f%~1mRE+i8&w+T}SPF$TvSL~V
zg=nupCa+gt#}rrW&}ZvwoS=FdED735dZAl>aoJUgyr7WaX)kC#f+nn$ARuFIwRsWo$#Q7M^J<`G1VamG
zsb?2Mb>1NR6=+
zzm5LR0zlGG0yVb^dhb{>Wz4GZ9yWP(E54eX;IoHpI`ABU*3_+v1{ht&G-1CWIbC^s
za*dxcrT*uqq=rafj+i|sJp3DjNl+jdj?H<0Jzx^;m(md*jGm1@(SgLT_skOX#0K&b
z!KPDzzhVVnA)OklveOjRS`or~Y8t_1!A1=uiY-{n>fX(?KX|kwGUP^d*C4e0vU`mv
zTY-DYVibDT#{Iuho6;SfM{>Km%;W4RQIY!I5Ph(jVRz%LMBI@hJf$fFHy8+pxR!OO
zU-=UTfO{q}?9*#e6mhs_rtvZvd&hr?*8@mJcE4PZlRtMECHuFEA6VBn&8euNrq9{JS>i_
z$}piUloMO7H9NgQb^`$#ZED)>M(D=(K2;YaX1<MF+EqcSV6YHf@R?=0Y<$P#e$R%*au=~g3hLUSMDp0l(#%4mR|OT15bYC3odE`#bfFPSiaHro!D0c++?AZq
zLE&LBXe@wj4<=NiueO0
zX+ng5)jH>McYSq>G?$ZnpeXs=r}E_UIMeS{A&dvf(;{O=jv-$v-(p1VcF(Nq29{K-
z2CImaVnla`n5ORK-+or_`R>3_4^Dr0#XZiT5X$2q4Wq#nu5m)890o*xB(60BG7*`a
z_xIpNoB9}Q_8!X5n=V_o5t!-GRY$u2;za6C?Cj-tjWh_`ct6MY201%Yx{8Ar&@V(_dY({>G#2b0px=csmHyV9+Y&8efig1Zq*>Luv5fz-s8;L)-X}Si
z2Ojj(<2o;5i3QsVY-~DaXG{9q=`i~=YCBN8v~mX^)HpF)WeMdx4%ZZTifWaOB>xGj
z8s;L~D+or{&YR#EGVf2O{6Jk?<@%B*lc(`hW!O40oFHzoJ6TLW7&e1}dDBK3;f(~Ntb*v-+Tz$c7=46&DM4B;vEop-ES6jlva5mq%4doC
zfKaLsRpLv}I6#WnTmAkh)bT$@5(Gbz{1tqIzjyl=067i`lr`Z%Ry_rCSQ~S4Khm6W
zn+#!NQ>jwnUC5zNDRmN|w}4&gZUEC9Z!Nq4LZ7$}QeeggCX1`sqCHcWJX&PDl?@@i
zIg@Jbiy}rDSOv-;lQn3Gtm%_o3sN-Fhwdkk>$PLJG%!=nT;xqJP>TRsQpEQDo>O$b6
zXAAO-<{58S(TTGwe+seZfd3X<9>H?F+d%j7$6p-(aU!z+I1vo>9RhzvKge38B-(8IQNw`0W~VhNu5B36J%g$DVoB)F{^f#6nMniFhvmGf?9%Dt>7yR<{9iM|8rBlg0l^<|$RcvdyQJ4`;(1jHepiLiqpmgS(|jme{W$MaJ6fu|CjXFp}W
znKkLLsst@V!#9=|9E4Vm;4H)Zmf4E2=>A%yJxs9
zh3&54txndXURlb-xYM8v_&h>q9LQ%dK8I)pp_LjX$aKQXT;knq4z<_WmP<+swM=0E
zRnSSbQFo<=3DNA`p+CeVSTm{H?`zjgg=cYzf3K)*j`Ok#B|LH7pkE;%73JW*f>i@Y!!d(ykrz!aP<}B_J$8
zq|T<7#yL3^LEbjr9tREAqI0c>x-`SX)8%Upvkk9BU2+nOw;8E9*#k56hk`Su5%{+<
z+^CkDV8q+MVYDy6__UvL<#q`CqJJ=OGF&2K4hj);a=xr@9okS6F)8nki#}=A7_3g`
z<%@t36IdOedPLTgkC&c^nlHgc(bX~qt0Yn41$i4y@hFyI{%g1-mQVgDlarqjy?-^Q
zgw)4K&UH>*{A6SKK~#MUe5$J)n4q_{_S}SnwPWkOTXajU;IrX!5o*Neyw9V&X<-eE
z?~+*s7*d2278>@aa_16p(Lq%DBs8%G+Kf`%Ua-!oTjkN=hzQ=Z1FnlfpQlfSIp|W;
zoFu72eTy~a-ryUCyTTJq4J2`Z0a5LjpJR{f9+o{eWwJ9o;4A9#3dU{}sSpjsaIkwj
zf8&4t9Ptm35vuK8{{?aa)-kVl2*XP9l%Q$8)%ka3+i#ejnV#FdF@aZ+5d6Npd$A^s
zO2MvytZ6IT6`_2;ek%JuZ@^<_5pb-
zvXTYkA+`k=p9IW2Xa61hMHK253B6(88C6Do{)?|#b}ZP5j436~l7-*E2hf$Ulv4g=
zjy0?Cl^%|}+7#It5y+n9z1ZjOoRg5^CWllf(R877pz5A4db%U$9BHm78H`W|RcC@b
zhm7WAj~S>)i<22ZoOK$<>WF2Wf$tpMY9+Wo?MW=pB3HRDtWhBn
z3v^b7q1>&Zjom2y>XTmw>zTL6z*~A}XIxt+^|uWkukfuwj}7uxW}BM-%HIj$EdB;DY0bQiumbHiefZR~%M*wGok`n}a1U3Qe=DjoVT7tAr
zDfO1zV?}|w!n6%U9%vtQF72_V`_IN+SvfX-r3dU6@dnS6l>d9LDDBvuOG;#feY{5c
zi(<6rgKy7)RiiM;=3+4XC5KPL$=NQ28)F+z5*AZ@Y#1OsWe$eH0*kB^O9kUm>a#$+
zss_pkc4Z1=G_`)YTN?9^dU76y1QkXgX>i^(J>f-row~*t
zv(@hBeNY4eOQAf%qwzTaK1#rk*?MM_xu9O8{k)X42`$HeA=SrZx^RYPS(E#sh_`1J
z)>7HSX8$S6GhMzeyz}c?e;IGK0nzS{
znR#cok&_U#B6;EO4IG^^NkS#b?J=YI*~z%JLLQGF#+b&L#-%R%cT2I`X3yciKJ6;Ig`-RlT#Kk-)
zL{Cc4Y}sQvV74M5EE{EkO{QF(Mscf?_({HsWMmbM7xp1mM0yKYU>v=ci|qc0;Z{o6
zB_%IyAHRNi&vwhh3jz~%8gXm)>4c1TXg8!;PXL4Ex>AZ8pmAh)4V(soa$Vpd9~*3t
zA=?YKIoY*n+jj!!@-gRjHOxXdjjcwp^p-b>%K1hgd_Ms29VLQQ8By9)IMwrM&iMjC
zMMZQUY|^>wqsx)b@t}g&<^iDG7h|aIxG+rSS27HI0j2R%N@=;p$h2u?vZg;8?G%6g
z*OD0j(Z@uMcK=p6Z;=OVRakudvhAA|f4o;&n@Y(TFiG0jfBRxwdCfSM(J1NCgZyQp
zv%Y-DkJh3gy)tVcTZ`L-QHGvEc0>e`1hLK~85%e9+%ueq-eO&T)7+Wx+HH8HxCD$W
zW+qt99NUs6ln_CDguh^0?8eEhrff$zd#{CG>2t@DuFkhp4#Q
zi5Rnoq_4c(TK6P(yxh9L&G2AXHF=}2q-V-Mb|v$hR+z<;RuAJj^2K$J?IVLCdw^^8
z-J2f+xfsSRrj)1iEH)c&oct=EDdt=7VANxl?r{x{CXG6gL|F|s6mz}gMzU6KRUP25
zHUE3N{UkmT!Lu%jCn1af)JEXz%T9>>+3ZxnbjuR(do>c=^31u_W4HOF21y;jU0LFu
zYK<3zl*dF*$zFW?+3*uLu8WJv_cl&2q^n_+fABLOf2fT2!9qVuh~7Bf!9X!7AINs6
zBC;k!+s-GzVnELkK(p5iJuU8U0!~V?<5Ubt@^d?n_&~tK2q{84uQ~GpY`MuP?TsIY
z15FZrQ^zSvMl@WF$j`mCUV&dVb?52(!YYbc4i^^7D(hL0yDE?)IB#Wf2LJv&C8ofi
z4XFgNk^bvY0uXnRVAKQ%b$aO$>dv^H0sh0kabnjwM|ECXQKgVfnAV6?lJmc+T8u=q
z5uP?)ip;A@ceRXv=qU#ubQ{>3?;Xn=2chpfv)&E1G)8XtHYHBQWu$$WAWkVHxav5)
z!)#g9DKr{u@;XU<4A6^0b1r#Mk`HKDKV8gYY6`d=8Jutom{qVP81_WS4IewNUyuiW
z07$W>$k_gM+Axtz&n;4nPTKLpfFU)r=0xfK8g+s<^7^{r+x}LX
zweQJUIWM2hn7SaxxA%J674*Z9abc_%d*@^CcV@ic^_d1k^fl>2oG9$_+8P#|@!8MR
z!}(p+Bt^xV^Pj@AS*kAI7E4DU1OO|l=(*+PRw{dRXC@<+CK$A_he#A$`{`a|Fer#>
zH1Vn`wUEoNsn$$pS!)pti}TC((5APpH3ni&oDG_ELAP2Ir9G7|(n(;qY+4dy4fP}Q
zQEXyYDcU@mqwffn%z!G()WJyrJyfoVguz6E;)8Exs4<^`s{`RVgdY$|W6mg*!%cD5
zjNf!tAM#4Cr4wB#L?{-0RxL`;(v(<)YH&35Q+=D)ocvw!F5%!F^gJn+mi^r+w2~(6
zP4>ip)7BbTa3@i7y@UO)-b<4FLa!S+CfF;>=T@}~<39cf?2|8KDpf8e^sGY{CLQ@HAd*k=eJB2a;T!MGzCl*vMpbyQ)v@iKe%$Orr)ysJbA$n
zDtFg7qLh{-7`aC*CF+`A|DaooYlU9DsZPG#noPa9ssw*${9ru=H-gq}LSDnm)8hQb
zh7VoUhS*4`wmZMuxXdS%g{|g6VCJPBElPy~wJ&&LEe$#`A^x%Ho3y-Uhk6h*Ehf(v
zc|XpuPyl;mgz6+WA#?hSd$q+SU9Z>p;pt*pXJS9NTu6^|)=1
zX%jCDY7?t??>+-{owWZ}NkaZqNvQ2s@c+iIq+t^75Y`R|a#uZa1T3|cGkZpNYEW;}
z-e+DZy0KpAIO%5>zzsN6?B-MOvZljWB;
z=MUs;%W@QM;*REKSOV5eW}Tp{Y{ou_M_mF*Nn0U%G}Gt*`H2!?@N5e!^(gw^C2~9j
za#zKB8neU7@p$FEvXYdIhQ{u$Vq}e~5+Wv+?uccK-IT$+QO|MDVn2m6|0t1Abw;${
zETWmg`r$xpugTQ#9rX~%C%(e1$_Y~_mgb#gm=L_A)mPCJx70TpS#s;lxdpi>Ci7E7
zrH<>9IxEnq<#0Pb8iIa>R)EC1PynXjq#e883Pk7&pYN+@>*`rhl-drzqr7M6do6(tks2@?q@VLJteT*e~sJ76r77uex
z>2dS_W9uEm^K82B;iiom+fHNKR%6??%?6EaTxo14S8Ut1Z9D0kKELPgb05e1|9XBp
zXJ*fywbouUo6>VQEJ#bKrgI(6<>14v^h%VPv}GISut82Dbr-x1eatzoB`V7hsjCot
zSp@0p#UmY^Jc3mIoNU&VK}Pj>l@;=r$aS9l5xgr8T7{MW3t=vxK69VXm(4ZK@yZ;m
zCowwll*R(PAloXCpi}%}f0gt1FLvOMw(N4{$JS`FIpj-SQAKhCOyKIX2J$H8BH4&f
z9kRf<*LEL2m&DA`79_GBj8{5RICSW=^l@>IpbU|JUsEIO0e4@rq)hJz6uVnIMwwX|
zYV(6gdjcNks?{4AGe9viNq_9n$}YVEUhJ}kD`;oOQ^vB8$#UmhmRLAiXAV}wSD43Z
zKBU4c$#eufRKJ0MHQJOdqI4a2-U>r#yBEVYJk%aYynpshE7-?QdP9>kfFb<9b=`y&
z@+H%xym!=oR&uOr_(0Rk_HC=em!t<_CK6p(lC_GF3HJwjAQV%hpB02kkqu>Zr3y*L
z=9ubk32vU_@`y*>ouy2bgj24K?%W{UE!dEODw!%56~kiygCE{)LtM6(dnT3X
z0VWz5dhJfx89n;=&2AXo)myT597-a$x}YDO$&_zWqnktL&@E^tf>kHvDUyW#eIkK^
z;4b_f?jWl^Xfd#6UvZRkgjx3M4JfazOup==
z{*y!l;ih?XcbX0z5I!+Lc^J3hsN
z&!=-zO3D|5O
zP5~rw@YF&T6-uG~^IsVq@K`8!pkR9Ksh&n7lWhu}TbBiol?6oA$s)CaCdTq!vJA4T
z0@{}d7GhRfD=L0m9!+bmiQ{m5*P1Xc0kkeS&ZBNI
zq@n~H?51Lwm~vTZdbvl9Qm#r2R)ZX;W(+r=g*%sXOYYOeZxn*!CpTcI_29zPwl!Mc
z5h=s5JGth0Nyj;LRv9jo^t+#|m*CJq^H!aDk9UGAbi*-FWl3DbWpP5-5(3gzR~@Vs
zv(aP8@3Mlk`q~aqoBysK0{fplA}c`S^%wbpfx5ZmFHFdAeT(E-FOijPd$))*I+g7h
zQkj@N0*u8;Z?zu(idIZAQV=Uu_QX;gDF9!}bAZ^0RVB>~n+E5^P>t(njHKI3hsQ(x
z=BVQQbGUVwda5SAxX$ip{8cR=N`NDVy{1wy(mzk_p7C*Bg9Dzn4_v#r0&3lDevI&Y
zE)S)QtHQBwWNSrzfALDXF+$7y0Od%_j@rP?X|Q{1^YX3fer;#Ds`xH043m0-I=-jU
z!g3LDOJo9b^NnU)?fjywazSeNMhg5nsXCDs#9jZcAfO;z)FnU~nTbt|wa)qM%ngp-
z#B?CL(9|%|#STh=V&xnsegUUmfhA`>2A9{hXvQRA3xo8ir!u=COeKNUX?6w?2yG5lEsoxt;TxP^p)O#^yVyP=;!
zk{&QF*Ex;o`p4~MUDa2=EU2~Ji)62`=oVZON5I@JZKjcCAUx^ez`=@(s|(e>E44W7
zK)!J!_qlmn_wAAEr&Zh2fl>SFT48N8H*M+wP~D|R4PM8gvY6l8O{Y@exGQofNGr?t
z7d3mUzcjhMns*il5or%Cfh{zyriXV`3qim9FI?0_Km4+EJIHPSFw4#<$Ws>$dl>oV
zmgO}oHntVOZHT6b1^dADBo&Wk9qVh;e5Fowv;nJ1=88pkk_n=MzdeujMPpd~t-bBq
zu>Ixt@SU21yfaWC7Tfvi2en8^3d0ige6?n=?pc@FHP#YxV%b}F8od)n8?IyGjcSnc
zt5K1rJPV<74N?1{2@6z*F7G4;%&Ntbi+R%OH&_V{RLmFA$OQn4(pU37}T28)}C
z4Xwq*Bt>9xfsFjayn{8e!#`*m0a6R+V*}8^nS=h9`?)P3K3?wOylG$xZPhZd?HtJ$(O$heD<>DhktH*-w%_I%TY{*#sHIT6te|U`P9rrUM&wYkRe;-+qW#K+l
zzWc14KWjAyKFTEDxQQ$Qnu>)4Ld7V4FYd(lF$Kt`55e6LJ>Ys
zBQ=tvG0$|Re*p61x&?@=?qOm1ZazN*&w-`@}fpmIo
zKx0^JPAL8H3Cjlw?pH(3rf|Rl9m4`FU#Yz;Kh#`ffzkpPa(F;KYw5{+1xJ1ZHS2h%
za05)dInJPTtk<~Qu6%D=Q~{?jIoE-J;rJgil=Qn4yIgnp3`NIqsW@8TTBWezYHI2;|deVd%%HpVWDz#Fm?h?__!2YP~
zfiISyhCm1gUNQ@O7lioO2bZBjPv)@L|JaE#;-5
z7gmi>3aEw_0?qSY-)FxYDSA!B?rhS)3<#K14VjjnEzN4;d}z~=8Xci9hgI-w8K
zS`^6)v>iaI+uodBqg1|T#6qjC&UO8%L#4^adBBYQ;)P+9#IHBcc}*VcgX;Ncl;
z_tv7^tU{tf6t+tU9(2P>Qkgzp+DU5rZTG94=TO(r85cAOV?D5Z%fmvR)Iypg4I0Qi
zG(X)GNzzmRu0;0-=fw+BDG=7CS_X61>?eAPN0!E+*~`aKR($e;hg{0(G!aa8bG>eQ
z{e{|n8(@_7SlVC9sP&1;b)*Q>*0I(dI;NJ+;%17-Sm2VjT);v}6)DSN6iwC^rDg;(
z2m24)W_kD=iGe+l0W3Ihh-hL&n+pmB(@{=7sQY^*q)(kc_9dn@b7Nv6brx(r9;Ch3
z>U|u?mUfF|-#kv4VQtBSc$jIG>)%>-x|C9peAkDGN*zQW60WSx>t`L-RP2pTofmOR
z)jbs9#>}RMvUm&n3^|pz4fG+6-FxK=FBum)K2@j^U0f%u$vK03MC#wbl>b9;QMB~`
zR?~1q^%_?8#I!Jsc#s?~%SH?@&Mi7TCyyyH%$+7@xv#M(#uVwJyBL`*AA^I}dRmc6
zsUE+PF3es?fHTdt6kym*9NcR{P-r8MsD6^k`zvOyGk(aMJ|m>eLCF7yJuZ(CHwo)G
zZ@o&vrj|W=8b{h_Y~su6)aX+*s9&1GyIbw4~Z|Q4knh^3|rQ&S5M%l>?UORj@8k9FsId9
zxO=#CH$r})F_@ozTd|ph<|rPpIWjt_T;RI@ndCFDZN8F3Y#N-OL?ZT5Ws^bdJZ-da
z%~?nXPKyF0LJ24?aGL9`QLk($EF~uO?JrrC=!6;bvmmq)QReQv=Y!Ob0xh`0w*aY>
zjSiHz{mMlo!>no$f5VKhE~pOJbYs}5VXPCGDK8CDj&Z*09BX`rU#{_+~9&!q!$;)3B7!^X#=Oa7q=l
z2O%d0A1{BY*07_Ye$Ky_4X>nyGp*pEcGyzk8@PV20v&Hzg8;RYs(PYg4NP-!c{2oN!_^w$uNLsiiKRf6D%
zFW)^syrQ0_Ni=*+@9MStlB~}A(d~wE!DE}ESZNt9+J6C?X+TIOCpwcL~V&_I6qbn85z
zoP#vL@9?=Bxn_9j5aGLb1QG=7k6**FGH+b`_W_XGQB2EAojewTX$b9#VFrjj+jf|z
zZ1B(g0udolG_l9_>E!s>RPfuqPXE#1Y}r2hNM3oWVp0r?3aP3t%~dwsMu;sLY8_Mi
zpVy&wow3dkqP!3}8hrF_ZOoz~;m1vvhTz6Rje=0BZm^jmNynWauyECa~puv~xXK8p{>SLAsW&E!~^5#~I^dz)6=`IdI+Y7BJ;fnNCL+7XWgSRE0
zn3zpV``ASF?VHOLHz?XEccZVSSUI7~klU8I0^tc0w337e0^l(oAq6PI1+iXy1w3VA7~3J_#W|WUd{a^KYIKr~hvzbn_8Xc`
zcfg)!4*{t}#gh^EWk|({#*mcP-AfXgMiYG5YnS1P0M(sekrrp6z8~{l{fE)!(5<>(
zpSX$pB@_YGdz@-30QxlT^M3ayHq4bG615dj>bV5E9%9`7=PH4@>kpP*IoP^Lm{pdY
zlg@C>D>g~3Ed_V)U;V{D`YC_B*!WC&1h0!lqHVj#zX2{NAh@VZr57eXoanM~vjLbv
z`f4AqgObU{owDZ04Bldy*mbC44AGF1GpjB7pn%I*sY)xdA(Un)c4hgx=fv>0gm59ys0`IK|x
z^TXDu&`sn}F{2PMLOL)Ah0GjcBnPz<-|1vvEw6guwRk=AJzUj#^G=F6kQn25uM3;0
zX!iOi-z_ekG^2|k3brOrIt&K1M>b&~1_*0kQr^z-7GB={!-GLuzEM*n=urLf!UFjU
z|7aIy79i4czJdMtk|B;z9sAbjnmR>|?#;wjsk)wXD&g!F#J`Lt7cHOIVyUKTM%P$1
z(_v&o%30Lb=eYVUm#0;fkk4ZYI_<}7iq&49+%hPB=}_)!ur!*9gU4pGbY
z&Bm~`u5OL=S7fRPt?a_N!T_efT1ocNtckfMN&cL$Sy~@V_K`)}5~C`4ff@k@M|zPO
zq-XZN?r7th8RG5x*7>^+1gaOXsjaOK^D|3%IxAKe<49xYLWBuTu9o13~rfzP6%5NZ*aXNn^*_
z?UlKEA-u^58CEyKj0VvZ$lNIb*t_56BVDiKQazO@Ri!4-C|1x1inYzwML>rGuV~?T
z`(KxdJICZ2nw?s(6H6=B_qf{HTKX^2X4d5=&Hk1e{5k{wa5q7I(UgC7GXe4C9K3Ef
zewgn1DPi)`m7g@;CWdW;0lfPvDxfH_kcgZx%iO-v715#UR%0eCGLp|B*Ga&1#IVW9
z0&hOt^U2tTO(OL)f3b*aK?QrZCc0#P&~iPtS}yOHnNYsXf&p~W{}>F@uSfkc#I|Go
zOm|)A35))3KgR$gCC$X;;@{+3DXFD>2{v@jdVQ&|
zJWZ?U2BYW@W;u=TL1UvaoOsO;V9&JbUbZWAq@fHO+Yu+Imx4@iOZqKtWsyO1XnvSf
zTC^7{m>pIz!h8if8+)^&K!6qSf;zw~XBZ{5MNPK#Kr$!Ka775iyxocLH?X#JJhgq4
z1ui@ly{#3E))a40qq*;g8#WDa|Lx`fV|_o^LSO$&I6iv$njywrj%qx&Zgk68h@7FW
zaC8D3IwfWzM2p54ZdWTEIIJpRmbYEEJk-DWluA?fPAvNo15AN_
z_dPt&*%tz+ZVz^o*gJt^P}sRyfrjgzLfBH0l|oJ28c{On5YvW#K3YR5;5%F7eo|5(RfQ4ySqHpGJ%s3
z8QZQdU3&fUhxXWh`6FPHRIzXkQeW~CDVd!;OIlYd%sNIOBR23a7?Bw67r;Q)%1*)8
z(ek*`H$Hq$%QRBKMV^)y{zgY;YX{x{f*FY$WEF9
zI_zEbE_;^scXZ{`s#ii1SsCZs3*{dtQ6$FUF(BGn
zR<=7H;E;l97w!9XCx-f}BgC59kzOrga?61+H
z%ETF&&55!oj%2VHt5<4OvkuG)1uy{~1Bw1aZ5B{K&dXhd&Xd^|Ru)!xs?Q}{M{!!t
zhnwC0-a7j1H$w1n78u(_kpG=M0pH5u0K|P?EhA%^+r68!eHYK%z=^V*y~S%Dr)^e-
z&f!o&ARPmE_J<8qGo<|IB#Q+~BwvwaZeKkOzD5hNDX*ghbGRH0>TC@aw)6~jl!)Dz
zB*csJi;MGfitzIEC1`AJt3KddaXjl_Jsp;k%cefQwdgn3L(g|B+a)c{i1ygdISJix
zy`BkgC<69t6Esm!Q=)(%JqVWVIDX3#eRp;FvtY`Bg+@cPQd|A7$~x5Gl+860GSO6-
zMkh8u$mBjzs$W#}%B*}QUz(`VEejAs-F+H6_GiA7hnZk0(}7eWAsLm7yvc)Na!?t<6(!8_NJmXaFE!DwwNV(w`{$=|@BO{$qmAHW6C
zB+!ro68q$Q>B}*YC!?Y?=r;AhNE*~xs!|S|c9S+9qCZd4
z=1`6?uJ7dp3D=o54knos#jJDJF498
z2G7yY>wzeAK;fTTR0m~M^%oruQD+)cCs5
ztFAjg{wGUt&hl0z$wh=MW5zv_SYO}OA!I8i!NG{d*QloOVvkDNCROiJdWvL^y+!mf
z2j$WB-^6BbWBJ|JuoNU$fJ;P7fi~#Zov4K_UH9>&Gz_^iIsxCX{EVxO1NQ9)mMf>ih+lc>Wbrrx
zJ47*RBexLO-C*gV63gVF!!6VnrM$|GC&39{v<~uJ43K(`=$2H4wDmY->9euCy1sZ}Htw*B-Ye
z|Cg$oZr&|q4V)iysG;GSuBnN)3?H1Gge75daL=c$D=7B-!^^*x@palis$R=JljuLH
z-ZH@_*CAd+uQR;UoA8zv8mW_vwjdE|i!X5YiOWRYsY}A&u!s-6Xh)I5z3dOVFm6m6
zCWO(J9cWfBgEvtwzIK!c&ehi4&OvUxz43^DozV53$f!;FNZBb
z#X>EsMgs#z0C*WHWe8^W;E&P7PcgLd+gl3}=0am71Pd&Cnyt`G48MF{(Tw!p>sKn;
zR_0B!d?(KFg({7?j^7N{@*-rm?k+*NPW4N(P^&9(!yt)tLYRPa94O)kz@9ooeD8n1
zcm)ty6Idk>Rj)D)d87|U4(yWv
z_2N{)%G5IfdjH&b_HYV4X4K$(olaxY%(SEsyKPedZH`wvXPTLAzE=dsv#iZl>`JNe
z5p%nckiirF&r8UL^}%m94v)gO|4T7+#6UB6JPRU8v*7i~D+yu=;~rc!&}fEHYvNTw
z$-hSk&u0C+V0xZr=UWtw&7=l++q=Tw458oiSXn2Q;zbf#-=d>qOuoE*Ib{VXk^f}3
zq#;f-Z(mWxCf2wttLU)k1?&oaX9BPOUWNm4jOw1&gf{BiEq|oIo9f?FWowREouu8
z((ID(-fIzX)YlX8!-^KQmFCkt`zDSr=++QNSqh(~S|FX%S;I8o2O$W^G?6hX+i23?|qaC0lk2)}PocBt>K*3MFRTd)P%rkO0+P#I`XiVn
zat^t*ck;-rJ?>x5_Mgu)NZJib)dRd@zZ8KWV=6t5&{bx@Wn5e({`Pc!7;K#T^q4W%UN+X_j>eE95p{XtCYVe&*JMlpy#t(GR!t
z!2O@z4r~+K=MsV1xRY9C3F&Hkhs&oprMWI%8@$TxKk+P$j9HVB7oExCjrf?vsdDqR
zT7{B;G9K_bQ!MNiCF0X^Wx{%&c^@+0VJ40wa{|Eou7$g7D_v}N-&3ZG)y^e*`XXNs
z6Vus!|L*~kKl;YH+n=nsQ%Dc~U%mgbnUJ97@f}YT@jV4%*;BU~8Zfw15%QfzXk9R)
z-OatH0G=r1ZacR#TuhIAjH{L#%Cejahvgg4BMZO$<#_Mh=cY>kiHW<;O`zN(C@82w
z=4Y(+W0%2>CEDCE_UmX+d=m2tKH?;sRSif_Q&+qkc|DuzGV>R%w-DTVN|!Rlc69gB
zy}8Lb(ee@`xY|?|1GoBYAab=w{eo^=$k;W6XKw4=Bwbii0CIrA8f$KwVPGAk8FsOn
zt=8t4$h*e(hJhYC0SGGVMTH<^#V)7r^X4z6sD