From 3b84469c4423a86799ae1b8e5da48e722c1cfc2f Mon Sep 17 00:00:00 2001
From: Nan Xiao <me@nanx.me>
Date: Sun, 21 Sep 2025 18:24:29 -0400
Subject: [PATCH 1/4] Add Primer color scale

---
 NAMESPACE           |  4 +++
 R/discrete-primer.R | 87 +++++++++++++++++++++++++++++++++++++++++++++
 R/palettes.R        | 21 +++++++++++
 _pkgdown.yml        |  6 ++++
 man/pal_primer.Rd   | 31 ++++++++++++++++
 man/scale_primer.Rd | 38 ++++++++++++++++++++
 6 files changed, 187 insertions(+)
 create mode 100644 R/discrete-primer.R
 create mode 100644 man/pal_primer.Rd
 create mode 100644 man/scale_primer.Rd

diff --git a/NAMESPACE b/NAMESPACE
index a43b15c..1820cf6 100644
--- a/NAMESPACE
+++ b/NAMESPACE
@@ -20,6 +20,7 @@ export(pal_material)
 export(pal_nejm)
 export(pal_npg)
 export(pal_observable)
+export(pal_primer)
 export(pal_rickandmorty)
 export(pal_simpsons)
 export(pal_startrek)
@@ -49,6 +50,7 @@ export(scale_color_material)
 export(scale_color_nejm)
 export(scale_color_npg)
 export(scale_color_observable)
+export(scale_color_primer)
 export(scale_color_rickandmorty)
 export(scale_color_simpsons)
 export(scale_color_startrek)
@@ -74,6 +76,7 @@ export(scale_colour_material)
 export(scale_colour_nejm)
 export(scale_colour_npg)
 export(scale_colour_observable)
+export(scale_colour_primer)
 export(scale_colour_rickandmorty)
 export(scale_colour_simpsons)
 export(scale_colour_startrek)
@@ -99,6 +102,7 @@ export(scale_fill_material)
 export(scale_fill_nejm)
 export(scale_fill_npg)
 export(scale_fill_observable)
+export(scale_fill_primer)
 export(scale_fill_rickandmorty)
 export(scale_fill_simpsons)
 export(scale_fill_startrek)
diff --git a/R/discrete-primer.R b/R/discrete-primer.R
new file mode 100644
index 0000000..0a0a835
--- /dev/null
+++ b/R/discrete-primer.R
@@ -0,0 +1,87 @@
+#' Primer design system palette
+#'
+#' The Primer design system data visualization palette.
+#'
+#' @param palette Palette type.
+#'   Currently there is one available option: `"default"`
+#'   (17-color palette).
+#' @param alpha Transparency level, a real number in (0, 1].
+#'   See `alpha` in [grDevices::rgb()] for details.
+#'
+#' @export pal_primer
+#'
+#' @importFrom grDevices col2rgb rgb
+#' @importFrom scales manual_pal
+#'
+#' @author Nan Xiao | \email{me@nanx.me} | <https://nanx.me>
+#'
+#' @references
+#' GitHub (2024). "Primer data visualization colors."
+#' <https://primer.style/product/ui-patterns/data-visualization/>
+#'
+#' @examples
+#' library("scales")
+#' show_col(pal_primer("default")(17))
+#' show_col(pal_primer("default", alpha = 0.6)(17))
+pal_primer <- function(palette = c("default"), alpha = 1) {
+  palette <- match.arg(palette)
+
+  if (alpha > 1L || alpha <= 0L) stop("alpha must be in (0, 1]")
+
+  raw_cols <- ggsci_db$"primer"[[palette]]
+  raw_cols_rgb <- col2rgb(raw_cols)
+  alpha_cols <- rgb(
+    raw_cols_rgb[1L, ], raw_cols_rgb[2L, ], raw_cols_rgb[3L, ],
+    alpha = alpha * 255L, names = names(raw_cols),
+    maxColorValue = 255L
+  )
+
+  manual_pal(unname(alpha_cols))
+}
+
+#' Primer color scales
+#'
+#' See [pal_primer()] for details.
+#'
+#' @inheritParams pal_primer
+#' @param ... Additional parameters for [ggplot2::discrete_scale()].
+#'
+#' @export scale_color_primer
+#'
+#' @importFrom ggplot2 discrete_scale
+#'
+#' @author Nan Xiao | \email{me@nanx.me} | <https://nanx.me>
+#'
+#' @references
+#' GitHub (2024). "Primer data visualization colors."
+#' <https://primer.style/product/ui-patterns/data-visualization/>
+#'
+#' @rdname scale_primer
+#'
+#' @examples
+#' example_scatterplot() + scale_color_primer()
+#' example_barplot() + scale_fill_primer()
+scale_color_primer <- function(palette = c("default"), alpha = 1, ...) {
+  palette <- match.arg(palette)
+  if (is_ggplot2_350()) {
+    discrete_scale("colour", palette = pal_primer(palette, alpha), ...)
+  } else {
+    discrete_scale("colour", scale_name = "primer", palette = pal_primer(palette, alpha), ...)
+  }
+}
+
+#' @export scale_colour_primer
+#' @rdname scale_primer
+scale_colour_primer <- scale_color_primer
+
+#' @export scale_fill_primer
+#' @importFrom ggplot2 discrete_scale
+#' @rdname scale_primer
+scale_fill_primer <- function(palette = c("default"), alpha = 1, ...) {
+  palette <- match.arg(palette)
+  if (is_ggplot2_350()) {
+    discrete_scale("fill", palette = pal_primer(palette, alpha), ...)
+  } else {
+    discrete_scale("fill", scale_name = "primer", palette = pal_primer(palette, alpha), ...)
+  }
+}
diff --git a/R/palettes.R b/R/palettes.R
index 00aea13..a042ec5 100644
--- a/R/palettes.R
+++ b/R/palettes.R
@@ -151,6 +151,27 @@ ggsci_db$"observable"$"observable10" <- c(
   "Gray" = "#9498A0"
 )
 
+# Primer data visualization color palette ----
+ggsci_db$"primer"$"default" <- c(
+  "Blue" = "#006EDB",
+  "Orange" = "#EB670F",
+  "Red" = "#DF0C24",
+  "Teal" = "#179B9B",
+  "Green" = "#30A147",
+  "Purple" = "#894CEB",
+  "Yellow" = "#B88700",
+  "Pink" = "#CE2C85",
+  "Brown" = "#856D4C",
+  "Lime" = "#527A29",
+  "Coral" = "#D43511",
+  "Pine" = "#167E53",
+  "Auburn" = "#9D615C",
+  "Olive" = "#64762D",
+  "Plum" = "#A830E8",
+  "Lemon" = "#866E04",
+  "Gray" = "#808FA3"
+)
+
 # Color palette from IGV ----
 ggsci_db$"igv"$"default" <- c(
   "chr1" = "#5050FF", "chr2" = "#CE3D32", "chr3" = "#749B58",
diff --git a/_pkgdown.yml b/_pkgdown.yml
index b024d4f..8d6e1ba 100644
--- a/_pkgdown.yml
+++ b/_pkgdown.yml
@@ -66,6 +66,12 @@ reference:
       - scale_color_observable
       - scale_colour_observable
       - scale_fill_observable
+  - title: "Primer"
+    contents:
+      - pal_primer
+      - scale_color_primer
+      - scale_colour_primer
+      - scale_fill_primer
   - title: "LocusZoom"
     contents:
       - pal_locuszoom
diff --git a/man/pal_primer.Rd b/man/pal_primer.Rd
new file mode 100644
index 0000000..16e179a
--- /dev/null
+++ b/man/pal_primer.Rd
@@ -0,0 +1,31 @@
+% Generated by roxygen2: do not edit by hand
+% Please edit documentation in R/discrete-primer.R
+\name{pal_primer}
+\alias{pal_primer}
+\title{Primer design system palette}
+\usage{
+pal_primer(palette = c("default"), alpha = 1)
+}
+\arguments{
+\item{palette}{Palette type.
+Currently there is one available option: \code{"default"}
+(17-color palette).}
+
+\item{alpha}{Transparency level, a real number in (0, 1].
+See \code{alpha} in \code{\link[grDevices:rgb]{grDevices::rgb()}} for details.}
+}
+\description{
+The Primer design system data visualization palette.
+}
+\examples{
+library("scales")
+show_col(pal_primer("default")(17))
+show_col(pal_primer("default", alpha = 0.6)(17))
+}
+\references{
+GitHub (2024). "Primer data visualization colors."
+\url{https://primer.style/product/ui-patterns/data-visualization/}
+}
+\author{
+Nan Xiao | \email{me@nanx.me} | \url{https://nanx.me}
+}
diff --git a/man/scale_primer.Rd b/man/scale_primer.Rd
new file mode 100644
index 0000000..893095e
--- /dev/null
+++ b/man/scale_primer.Rd
@@ -0,0 +1,38 @@
+% Generated by roxygen2: do not edit by hand
+% Please edit documentation in R/discrete-primer.R
+\name{scale_color_primer}
+\alias{scale_color_primer}
+\alias{scale_colour_primer}
+\alias{scale_fill_primer}
+\title{Primer color scales}
+\usage{
+scale_color_primer(palette = c("default"), alpha = 1, ...)
+
+scale_colour_primer(palette = c("default"), alpha = 1, ...)
+
+scale_fill_primer(palette = c("default"), alpha = 1, ...)
+}
+\arguments{
+\item{palette}{Palette type.
+Currently there is one available option: \code{"default"}
+(17-color palette).}
+
+\item{alpha}{Transparency level, a real number in (0, 1].
+See \code{alpha} in \code{\link[grDevices:rgb]{grDevices::rgb()}} for details.}
+
+\item{...}{Additional parameters for \code{\link[ggplot2:discrete_scale]{ggplot2::discrete_scale()}}.}
+}
+\description{
+See \code{\link[=pal_primer]{pal_primer()}} for details.
+}
+\examples{
+example_scatterplot() + scale_color_primer()
+example_barplot() + scale_fill_primer()
+}
+\references{
+GitHub (2024). "Primer data visualization colors."
+\url{https://primer.style/product/ui-patterns/data-visualization/}
+}
+\author{
+Nan Xiao | \email{me@nanx.me} | \url{https://nanx.me}
+}

From 7647610ae9ded33e9a9a95eae3dba04fbbe62997 Mon Sep 17 00:00:00 2001
From: Nan Xiao <me@nanx.me>
Date: Sun, 21 Sep 2025 18:24:51 -0400
Subject: [PATCH 2/4] Add Primer to vignette

---
 vignettes/ggsci.Rmd | 14 ++++++++++++++
 1 file changed, 14 insertions(+)

diff --git a/vignettes/ggsci.Rmd b/vignettes/ggsci.Rmd
index 1593486..d0d35af 100644
--- a/vignettes/ggsci.Rmd
+++ b/vignettes/ggsci.Rmd
@@ -87,6 +87,9 @@ summarized in the table below.
 | Observable      | `scale_color_observable()`   | `"observable10"`               | `pal_observable()`   |
 |                 | `scale_fill_observable()`    |                                |                      |
 +-----------------+------------------------------+--------------------------------+----------------------+
+| Primer          | `scale_color_primer()`       | `"default"`                    | `pal_primer()`       |
+|                 | `scale_fill_primer()`        |                                |                      |
++-----------------+------------------------------+--------------------------------+----------------------+
 | LocusZoom       | `scale_color_locuszoom()`    | `"default"`                    | `pal_locuszoom()`    |
 |                 | `scale_fill_locuszoom()`     |                                |                      |
 +-----------------+------------------------------+--------------------------------+----------------------+
@@ -287,6 +290,17 @@ p2_observable <- p2 + scale_fill_observable()
 grid.arrange(p1_observable, p2_observable, ncol = 2)
 ```
 
+### Primer
+
+The Primer palette follows the data visualization colors from [GitHub's Primer
+design system](https://primer.style/product/ui-patterns/data-visualization/).
+
+```{r}
+p1_primer <- p1 + scale_color_primer()
+p2_primer <- p2 + scale_fill_primer()
+grid.arrange(p1_primer, p2_primer, ncol = 2)
+```
+
 ### LocusZoom
 
 The LocusZoom palette is based on the colors used by

From 7602dbaff3741ba4a0970223c65885c6cf7a493c Mon Sep 17 00:00:00 2001
From: Nan Xiao <me@nanx.me>
Date: Sun, 21 Sep 2025 18:25:00 -0400
Subject: [PATCH 3/4] Add Primer to readme

---
 README.Rmd                            |   8 ++++++++
 README.md                             |   4 ++++
 man/figures/README-ggsci-primer-1.png | Bin 0 -> 24204 bytes
 3 files changed, 12 insertions(+)
 create mode 100644 man/figures/README-ggsci-primer-1.png

diff --git a/README.Rmd b/README.Rmd
index bc830ef..b0377f7 100644
--- a/README.Rmd
+++ b/README.Rmd
@@ -146,6 +146,14 @@ p2_observable <- p2 + scale_fill_observable()
 grid.arrange(p1_observable, p2_observable, ncol = 2)
 ```
 
+### Primer
+
+```{r, ggsci-primer}
+p1_primer <- p1 + scale_color_primer()
+p2_primer <- p2 + scale_fill_primer()
+grid.arrange(p1_primer, p2_primer, ncol = 2)
+```
+
 ### LocusZoom
 
 ```{r, ggsci-locuszoom}
diff --git a/README.md b/README.md
index 603f2d0..ffafa84 100644
--- a/README.md
+++ b/README.md
@@ -75,6 +75,10 @@ open with `vignette("ggsci")` in R) for a quick-start guide.
 
 <img src="man/figures/README-ggsci-observable-1.png" width="100%" style="display: block; margin: auto;" />
 
+### Primer
+
+<img src="man/figures/README-ggsci-primer-1.png" width="100%" style="display: block; margin: auto;" />
+
 ### LocusZoom
 
 <img src="man/figures/README-ggsci-locuszoom-1.png" width="100%" style="display: block; margin: auto;" />
diff --git a/man/figures/README-ggsci-primer-1.png b/man/figures/README-ggsci-primer-1.png
new file mode 100644
index 0000000000000000000000000000000000000000..1ba07ad3ab49c650e5afb4e25181e228ebe0cf0e
GIT binary patch
literal 24204
zcma&NcT`kO6F%5?X2>~%WRaXR3c@HTC{d6o2qFSX7A3=61p!3_L?lTP1q4ZwC5>c}
zC_xa(AUWqWv%~wo-*3<Uv%8!F!@1L4U0wZD^;3PTpBw0DQjwn_2LMoA)6y^mfSB+v
zG(n0aeBA6aF(!PFxoeqw0>I3F`U_n%Jhx7GsAiyZ^9ml1KRi5?&d_2@PF`JI-Pze0
zr#!dlNJr%MyMN@jX>rAerslvGm|Lc%4&^>-F_Y5~7IbuU9g0_`OzfA-awM|#m;m4b
z*EBBO^!dG<66y6`g%-`p<D^cnN^^+oKIEV5cI8Chs93BmyD0XtUqo3^_TWy%scQdk
zKd^p!?##Fv*{59Vb;E@A^-us1Xn<d(lD3QkFlZz6r3GvNU`N#@5j;pAPMx+7x=ZTr
z)o!=?BmfVR@JQB~)jG!}llu5zu$1DoHMV*(bX{W1fxAi6;ZKqm1Wr3DLzGNh47ZLp
z+R0ph6CPsQdm;$pZ_oMdsKy=KbDk$rbJ48^FeOYmu|it++gMeL^2nYMW<%Kok)|W&
zC)Jow#Y99XD4_r;fTE!QM=mMmpg*PZD;NBYn%5^{xJy4vgx*G>iPxVZSp5Q42;U%p
z43L4nGo5C#H*i)TTZzw){7<3!^7`S#pql#56v*LpE@)r})<P?LsE{jzf%CZ+r%z{N
z^6XR|Abdp%Q=XcFpaTG?e+)B0l|eI6hZw@yzJ{<yLS2)yJV-PcA>!HdQ771qFm0dn
zP<YLEb_D5Z$4VJoEa4ga>xn9SM1~HbBs`3UcnAujfjj1>v$tEQc*Rlq<2x(}pV#1@
zuT_}i2kUjcHQKe$Ce`33EC2gW<5W8K?)T2afbpfEYfX#JOAQjJbq**z`g8!2uy)tt
z#u9eh%KQJ1=h+4+qoi(M&!^TGIbE5*a;oWNVuC4C89rT>+EQ$;bN6?i%<B2W$PS>I
z3lbl8Yt=zLnX(Ek0d+o>TjL~YFHq`n4kE-=6xCgr^|R7q$B3Zjk{s7S=JS<aQJ8(P
zw;AOq(uwAn9-5U;he5ZMclRx}JbyX8d1qZsgYFu_iOnMc3Y_sJ$GU!A8`|#n_(wlS
zsI8U={gId!SW+7rWsbFUim>>$<Wp4BVuSyu;!`TlswZpeg~9)JG5Bw)ze0S$2<qQy
z+-5?pFP$zH!P?k07WmW_0JR>2pyfRsRgxkQu>aSz4XEA#XYC0122j9z@Q*zKVqfDw
zsqvwzF#CTa|9>?NBQ*X0C$$1rg+>4WNv$A2L>3x);B+i_s=6J}XTeShizsuCHxE2s
z=_udV|96&g`VGHbZs_ZUwOPVZleO<6*68a~q;5@NX5ZzHO;SMwN0~U!`ioKbZbcKm
zF({2|!1A~-7Qsv%ejXdTzqVOebZeaU6o2cCLF(M-KE^sBdn%i|eSQKGzgcmC$4WV`
zp2wUwT<WdjdKH~KUBANlMVy4-04R_a3k|ghzPK8>{(4DKR(Gk92Z-<f{-WtJ@#_S-
zPUWb3QqT2ILvB9U#lgM!gj+2jgV?8{zqE@f-40ZrgZ-|7+0KpnudzUkuuMSm9ITt|
zNIw1%SS$rNTjX`_4eio=2f5&n0`&Pg-gcE27TK{+s}zGEEJO4Wsm(4&oTqD+MCvX4
zf_jAi58Wl!L!%?i+Gr<&m0Bo|eHvqmc<@)H>@1FZmxPjliQ6K`1X<YW#jwPfIwg*`
z1z#it<i99L?`sD5`V&i$WB;7NH^057W7jU8f(_$3?Gp41yd{zr1tZqBxsYDI{y0rO
zvy$l>*mh>Lb!e$<v#Qn#I5pNU>ydC{#<*R%Ngf>T*J~0`HQ{Xsevovq@s#6@$PMIj
zd4DT}^pro?9;2ET9T>lH$WdKeAIKPOf_T02p=YHpeq{V5FH*_<4gvv(m1NP_6i0cx
zGNJmcY$AgqtEPso9_z%lNxUrV{usZ#Q0@Q*@;C6*z13$=7ouJaX(ogHb3tifO8#$B
z7HN=|M3Kjqth49RILpS;E+zI4E57+p#)0a)JAKZ!cLdl7zFZC@xcD3Sv*O`UzJBH)
z<JK(y^Cj1Vx!><C3{u*tG*^iHl;5!S@^-8nzr)xQ`1S*m03;hLtwbyG5_5W(UE*>X
zO*(gD<{Zd~8k_w4+-B;?HDv1(>LI5(<nY6g_V1&x{ixFrmFrV%2)<ke@zgRAgk>>k
zB};5Rj9jCfP?s;Ht-V@G;ma5^uFnQrMvijez1dr5$6RhaKm#<f`$sUt3^8h7c|Xhb
zN8nLTCaf2DbejcU%ce(pdLFY#@0R*nG>4YKt3IZPe>yOmnvkKlmzJp!LS;rAHTskF
zH<k7Ec^@;x-&=n`CN#4n)F8!b>^gP+YTcyOX~Z=O_T<gg2xGmtn{Wks(@3}T8sPf$
zdUd~v)LI068p#R!8RjK`3@3gbWvhK$uen?+jjXH)JB{i}QR4CS_mjhogQGq(!xodp
z*4l`oqd@0c?(HL}|4K5M1wHT4`|wWu`?eJ9=GqkAg$;YcK!+v(gPCX|>1E&h?uW$d
z)()Vy$vSQrSX)2fhF8e<NgfvzX>042Uh0<dItmP84zliS!n3|(IRwk~^GF{JesWq6
z5DEr$w`(~}bF;F4q6{P%eZ20CWARCeEk|)e#$o-BW#C_e6sCbm8Pw;lE5`kqdu5Z^
zg6}K7$ffU@2{XT~_17U@PbeTg)um1|f#RDlEo_0x{c(Wk?!pAl?$)YC<jqsw$RRrZ
zsuNiGEv;~ReWgXDrIlOK-u}hPi@-2b_JeGN7JT^tl}(>pLUPY;IOW8Rz+M96PZs>#
zO<P&>5!?C1+bcr%4d-8_J=i*#uimZw%CRjxGqe(se&HO|2HD57L602U996x*hHQmy
z#&thI_w%2HTuRqdf8%?B<^b*E7=9z?TK*ZPjU$iX7y^vK><E$Dofj!JIK24zYJb`I
zjw-C4Y_cJIIZxv6IP*fm#s=vMBQHBvU-n7fUDteW65joOh~p>APQ7}&lwqn(KZ>W&
z-20{xEOHh90e&A~NW9+Dn?q3A2vy|zF-$w-3NiH3qhyK6U9CXY7#P=cY<sN29Qc91
z{=e!Z)t9b*;_&o5aTkDHS)+Fqy_nwbH;bH9XX7X_jL?Vc#)si^(JpRnU%4^sk5H$k
z4GKx(R>PYjq_)XvTsCI!r2ielJ?Fk#RA(@`aMmqPf{5<73SA}VYf{f;A}OtpUEkD#
zavRY<?ufk}kb%{<5VXQ+@sLW8>TkCeufDQ;nvCjmE&2CZ2(C+z-L?I&xK?eTxmE88
z4qf6CnPTXu_sx7orEC~vm`iCKIhax8EKcFi0aGvX-Z@Ao?@2Cyy4vV@JwI-=De58n
zc=S%nW|}Z8Vh7#)wyKl*`=Tp>cR^S`=(FXbW`u;pxJ!#i28PTgizZ!@Gb46YWO<I*
zY%oK)QHop(*99zdX+B<#`Fh4tSwbk6%qER;J$p3mFY%MCje;*bRKu*eaVt>AfTrG7
zI6qEvYnqq`m<3x(f<$E-MRII`I3!MveaRPjQ~iT6mu&#It=nR8CqhXVvENQ(3|d_i
z3>+it`W?8;A5}Vrx63!`1V>JKD<FNwUTf5|uskGdo8iLzOCS-jlMEc^R4YzyBLY$N
zQG^blN8f|~=HtGF7u#3z>2^BzHbAWAvd$>E1kIHJH#UK(Fl7eGvGpJGk@%|QGtONg
zwOU|QQUVy8gFtn)zYu}(EoGUmH0}$)-TSd*d){<#2d6;_6~)SwzxOlWTC6N(PcO<q
z{6f=?QFD^8S1NUD347kV7sE%;hyAe~zK{nCL6U0JQm*9qTiH+^8(=v^JCE-nq%uJV
z57?>zwxJa92Lf=^egxIzZ5FKY<FG2^*F?xwOpG&1H55}AwfQJ;-lhMiOW&yRZ5FiA
z{#mMN$-i%d^)gi&FP$8{qj6a;OEh1YW0dxru6HjeaH_6C*(ng=6<Oe|Y9~|?Uk@KZ
zxw}Dae<0tpLq3)RTt+UlO0pgG_kUhLp03OwP#_96c)#?ugV5!SZhmc9G6_9?t!||{
zRQamA=_qRR)^vTl;LvZf^@~WJfs?!;#THz~*mM>Fd&k{lRZ;@&qIb-+4B6>vpWyMg
zXkyu`s2q0!%746csaW|sFxtHL{f{sSdY1zvIe;D&KaE;a?#Z+b7J1bEtv`@iAbDny
z4|TfrMNpX`88}?6XA`G(chcF|wdB!fe_Nzoz`k`%wu<`L3}o=R<nqIcqkNiA)>VP!
zfe|kOdN*8N6F9!TH>pN~_DtjiEh%?7OX(+Y!yeS>iYW~)5#=wg<<K7{`CYUdyI#~)
zm@*T^g&Ub)cf(OByGbJ9*H*2ruq4vueRsKA3>|1o-2%Ci>|}>l$xn`jK+-qJW~jA?
zFJ7dMajf$NRs@@TMb>Puc{_X_1HklUQk|_|eHSZk6fCd11^LGX<qxw1^Z<1fKo<xG
zx(3v(5ATZ0Ai(es;MieMwqv#WqGR=%uhfsq!`(Ts-gvyhoe{vtYVtm}z{_FA_}8p8
zDKj$t1&HU5zBb>=iR+A7N-!7g2qK1E7AT<!UeF^%N|2@u8T3-A-E<i<P8{Vo4~w)3
z0|s7t-Cc(JS;6$Fsn<FrZ%jXyQ|1f%daMbeamokQP0ik+?UUn4oY!)PjmU2fUuYo%
zb|~=08URJZI|bC=Fk+}}0H_~=_Lbmo5Z2Ahp{OA>W`xamAXftajKtt9RtbELq`?md
zcNBRC1tw$OA3c$sfuac(3nBu?Iw`(W{ufHv5f|!OJ`5Q3lhJx*c68~nJ+2<D`?Z&h
zP3`O{n8W0s{Jp+G3+PcfH&2W=Bpc?2eL!CI_UFY|67)mu?(k*g+t7E?H0fs$zgO{R
z!12W%RXFRSg^1TtxmTk=)um6u$l<Fq)^fL)3~<W4@x`9|6`)O^=OW*cG-yNe5b~xr
zoIg$aP3rT*7sG!P{9OJELK`Uy>Pfw?UP_=fs3rmSV?B)}a>0j*xj*m^+IOHFa*o%b
zlCgXFxVTtxIW=atO#;0m*kv4of7rI~$Ny~wj?@wRVVNTOtde$TzV)Y)V6jBl(pYcb
z7ZpVXtAO;|bS^guowJkF=g4=~^zQ8tEkS}^JrQ83dl~U3E-5(unTpalH!|HL1*@c<
zKmlbe)f`tE4Bk2HCW*br`VgF3tZ&EfRWvvd=~`PWQ{4S;B0;i1#CIaoF;vI2p?(5t
z%jBWEAebl}3<A<JFCbvHyDl{^Id|}N`4wxwi%9+5e#u?p0&EbxJPxoixatEuxjw=v
z|BgX+%cBJ;lA>xutn2hnRuDOe&9#AH-4kQOoxWkQM#ZI~`}C@0Dz6FdiHRK<-wSTT
z6)|lj3zA_QiM5uguj0f(k`+jQoX+9GPr5Wj1Ki1ixmc-zzf+YFet*4i&`o6Rp3sN*
zgzhcZ?~KL}-9OVGK{}>xgBe<J_|w=oF1$F%ZEvz#ClW`-k%B2MO9!pvz~t@5Gk=g$
zZqcZTPlqE-9$I`_AL6h`n^Yp-f1p`U3Ja3aDxht@u}D`akjlOP`QcT|rC$<#Gnf48
z*YaLu<g|0|0H2B%Y9X+h-!Av%;pl#xw3Ogf`u(R532R93lQbln@Ad{r>iulno1v7I
zwGL<l&KMAZI9^KokJTERC9UV-E*DNGhMlMfPv7=-#j>+hTji7%Jx_i3uL@-F!)eJ2
z+~*g!&J<N!5?8y_n);iE*4}ZC+>~XN`x~?E=@z=Kll#fuk^2*3QRaaA<^@LECms*;
zAP`bJYyWGcJ_|qdA0jA$5F%vcR|Eo$eTVz>Yo$m~zq$`i;zEY?6FXbBIs0`iixS*O
zlRQ%Bo2t7(!;`;{+Ub6Oy!ar#!8+~+<~AR2ejgvnLj#`%J(kZVj|_?6Au^~;nK#{q
zxrgiSZtJBzse242UwIC~DS{)B>k={KDP3>Z1NhFvAErvOZ~$CvSjjbB2klx0TVG>H
z(1i3oI<SjyG+|&`(Rj|C33SE+scU0(ZoM~46~4u%lG**<(jyJ$PCZ!}y{UM+Q0m4_
zmqi-xab57Am(U>6F9Cy?3T*&uG<A!G^sd)!(f;_dEVgNqKZ-2y0BA&|8(ZG@`rgH4
zH^vEtXG>?5?tgR0JM#U+LgvAHXEJlpN^m7@><?Ulfd5;wH56LdT?K(QuJl=xC?*S}
zbtUeK%yGWNMB9dmK-k=xPtL7pINEvBO$oW`T=^>Qxf7Nx{i}cc7`mtUw2Bc9$M_0D
z|M`$A8B9!qE^u#%dWu$D2r@_LFnrZ(8SEYrZhs7h;-YVGo$rQ1^d@G8>OYmru-VA2
z^gVN%iM|>{8RC~PYtDrm)ipn%vG&*G*+mdU@`30R4<M%u+BCZ8!K-EiIqUO1de&K#
z+fEH!&GFsc0j)?IVni4h{4(mK*X0LfCakZm8aI>2@-tawvnc}n6xcD`TsLlkR##8l
z{J`;8pY}80emm~ip%DL<1hhTkvZIq5XnNAlkk1xVQ<v#KtI7Ia?Gkc;8nml?30!Vg
znJMob-F0l{_1kJzpiXjlk_Po-YPHqQv%qt$c%cb~S(^7^?j7OY0DT&U2u^@?+X2@l
z(d*G<LSf&Y9Ab3);A?R%X-}zhMKY4?^LjgS(FdeQrf;uO>Wy{wmzyP=6mkLclC|`P
zYq#|WiF#@z@T!Ap#CW3)cfEh&3s|3ndN?4SOYl(cr5{p0PTF$CKs5w@w~>47CVKB7
z4Z8B+D56N2&onUpUA(m4Iv_4F`og+hG#Y$x-O&6wu2mHln$q4)KE4R{A5o)s_WWr)
zD|SX1?Y~#oSq`p^t|dK!!Fu<|LIIu|$z$lpivT{8oRm_OUCRNj50p}Hdo?0>I`D<N
zn4jiC{TF_UA7RNI&Eu$`sp;DLa&Qn*Z9Y31GYx&PcBNrhp5^IrxCjF4t0Phf$(>SK
z%GzNo^*b8C<5)|pZb>Eb^Fr@ezj!Ol;mZjRKiU1h4l=#}?B5%%>bn>_+&j*RFOgO|
zJVP0(jAlX5+(&UW?_J?SPVqC??o=%AH*&#W$7c`K9@a<95TSW_5ZLow__=D_japw)
zV6q}Z!$U=LU`~frFtNBqruydKNA7W<;K^Vo;^)G<u=5CTH(wXw5OW|ln;ed@w`i>F
z=6yBC=x3cpBy%z+X&M~VkE|TYyFJbX!N6Trd3<NQh8!3uvwmc*K%OJddG+^7yeRLF
z6d8Nkk}dFlGMO6GMC8H>0}{>LruYduN47lQRpk16iiBU=cqT-^Pvpd&{|qGq0T**$
zWN+gu$5bdmcx2uXq{V=u2A!Ee$p5=v$qna|XetMHQC3Z^T=+7&juyXbc8o;5eF<fx
zh%F-XG%!CeLYQ7;bnjz5LI8Q!+2wOmj|2@Ot`{z;?Lg-WOoG{%N`s=~4@>n2ey7L;
zvPb!tsfo#!(!PA>T~3};76@t>@g5A`PCx&={1!fUkvQZ#ofl)sOId_6*yly4CL$f%
zS<vdIvYYjMPuAu;8MxrcS2pT=yT8bzEcTXe<rV9Sd~sP3Q{s&JE4^T)HCbS-PR}})
zAf}IV-?m<}m+7p1A)j=_O?+%|DO$!RM&&!vdKX*kfLa>O$({<_KxA_27``g-mKEL&
ziFVO`>&9gAP_sYF_~_DTcJUjXM#fLIZz5`T+5@MIfD13qU>f=S$t!8CO)rlb)#qzl
z&CdR8ORfOhf<&(_;D1mcRBsVIs`tcfsGoH{>0ToPD7bHktPp>()>j4f=E1{UOzzz!
zswk+_ng{Q9c;@c+m%qv!wc#5P@1<HFc<3HQ?rRs0-LbG_;#qPjKB^m3qpwDMqatlY
zuP7Pdgg~k$Rx=OYuAO5M3U*3A`^q|`u9^j#(*NYtO%4k1e>uTWsBP$cTNVa4^RhiD
z^b%d)w)`h?nOIlP`<iC0{sS)gN@))4R`2#DDaHj9KQvA}IF!8VCcq`f><X^~o7Y<o
zU|kHMx(LbDx`de1s6`%i)POS&P<-GWFNJ&E62{bxiwN!edCco?Xs|5(ChY^6zNxI+
zt|iPrb*lv;lnY!hOW@;dx&1fiR3>kzQpvIXy*rKopX=gD!!M)t5fkT80p$#pPfXgz
zG}O+^HEX*{23$E^;U^%w8aIxBYYr5+qW(TE$$MUJ-agQ<!JW14o~mnFt`Ne3R+)tU
zM!lWFJS);i8&2Fn!Bf|MS2uA1NmigQE*9d;1*QsTKpTN|Wq%2*eZoqo<F6`#6eqE}
zAWs8w4ybk?xn>hRmNB}g&mw=QS|If&!)rb4GXA4XBgDlI(AiFw<+s`(4cpWzNE8~1
z!EH5uyH-j^*ku9F5x+p3q5o7<1(_Pn3|zu?o*7X7F8%6a{_Cwg?c^hB{&zYi$0V^q
z1DV86xaH}$i>K5cbe=2p;ftOc1qMxd9O17?qcM(EO}Y(XbUgdN-W2k}Dg<UiplS8e
zy`$LuCpd1p^p`mr*1`t(Z*Bfx?<x|5A)XjAWs3PDpMiX?2UBWauc_+X3jF|{TrKoX
ztvl|xuY4%JwmDm#%`<>+psH-p+o%48nLhjIdQHgx_GNt2XWY1Jj$E@RE-Dv(v7CD%
zHFTaT__DyVbK^0S{;Qc}l)lTycG;vA*#<_%T4UeCu>uc;AC3<cI!lBZe``VRY&O@>
zz6IQ|F&+;!@%d3aw=V(T)9nNdW9aeThZv*zgwRLrb9Xo$Keh!O(WyA)KlWZQ8NHXc
zU7kB%^xAO1uvW^_qLuCU+h$6-t4H-*#rM5x5tdI5lLhJ2f;y>KSx^xE?wTbd!@v_M
zvDePZ=Wd|J@aFn5RnemFD+fzbhFm_CS$^HeBx>6y^}Y(DMKcqO2GG-->NTX`3QY?s
z!T^cB42cmtWbH>U1{v=cCq|gP|E((UOVf|fR+<67TT?GBN2D`?a8|)w3$b>))J&;$
zxq0%V#UcNN=lc-CfRZ2%q;I^1j-aAGqBmJXa^i5m=Tz<q4OZdV_=EbvX@1@Aesx>g
zg8&ox?5K_1j_V@M2g+p=Qi-on@t*6@r4Xp-P=bN@jXfNL`K;(s7@%POkBuU`y`hwJ
zE>x(Td}(>9LIBGlBxmH1`;0?`8uNTL(HQ5k8KoKD&PX9%8t6sM)rIw@q&?iR5vlLw
z7m0@EmQ{EI6eMsFf25FhZe&t_3R5mg|AU#9?0xvR;n|<6k|sC?fdnFRgh(^fWv0OD
z2+Q5bGzb4WH^Gxb({7f`JVy<&kH?F_ZML>*o!7)k2loWjTfJZ2dCPt;!Av&&46^8a
zY9+N88Ob@x1S;t8cGo*@H26>VikH-6QqIEEqJ|@V{RU=pdnz<U`xX}w{zd9N$3IRE
z>Uskq*F(-4txEyZ!+SD%&$PLx3~9~U8GfDJHv29ve!Ge1Bi8b8?~d+Pm|qI%@q)^&
zlW`)L86iY`N;rFbl3BEze%BV+-A)#NMNu@+$o*VIso2}EUUS2A)?0*~%A3@@UG4L*
zDg!fP(rCAj#VQ-|HgsT^s<JjmM5fVVA>k-0`{*KDU#iXzd?^E<LPZn(E0`S`I;nYc
zv;2JrPm2mwSG;DND!1P%Wuy`$ffJt@|9GT>`IF6qW71^&T=q_T$2-IEyh{>vp5m-5
zwsvSoD3!Sm^FL4wgQ8a)YIzk0o04qv^D*PDa#vV%WZ|2*Ee$-|NZo$AyV(T$d;0r|
z@z)i-H8h&w`@?TA9rW$F&EK3!r8-}3AxU{C{>4{;5H=8mZ;6IQl2VvC97TLNEKKsf
z9N*JB+Kzd<ptf*u!DRBz%Z=;#+;t{fEYGt=1Yr-l{JQk}AujB2^T(%G&pjo^?kC{p
zDEE6=LGd$y4i<ysA?(4km!lwWW^PK93i|MX9mwpK*)6I?3GfZf`>Ro2;e4?J#UOKf
ze^OY6dyi2P+ttT@z9#E9p&!{@bjl3j@r!k9ln87V`?$)NJ9df#`0M$cAN%_UF_Oib
z^bxXMy)4QpVL7+>+}`lZ+{<Uj;d9<(E89{)1_uIH0LCle@<0A_nsb)}ck}EWlm2hU
z{v-0Abyzguk5=~M{^l(u@5l@5J@-j<HjCpf_zuuCu~}1e8bdrf7jFn(hQ886J-NhG
z_wT*9OZl&{ctC(2B{mduqu_4w3ufY>`E@DE6NbB_2JnkS+ERJ*xd<Z+^VzyT+)4|=
z3|WVN#Fb;UQh6VFyS-bR(7Prgt3z}@JR<Ogu4r?CzA6Ix@*e}9GXt)(&Ly(vSjW%L
z-5~<+Cxn^bcs+G*urS6CbThmn-XQR!Z2FW~2PV0vkmO~6{69Sb93T1Hw3fcECwQ+!
zYJ63il~^*`Mw#=M`UQ1pY85eg&%KS+7Z|*^EZ9AZ+E<b}jZp-YAIkyf6Qt;B8C^cP
z=Q}NWcMgWj8{EZ{{s-LD>QCET%36ZcG|@>~8icl|L|u&-VABhA(>@<!Br=8^N)K~$
zXp$a5W<S1}pWAM{#XnNDnG!`7OmleW!gX8IYe)U-tU0u(th||DcSO@;uKi97D<kZG
zC=fNWdIJz-p4I{oc9{uI0GGY>OaU2E(QSuS4k?gGqklwGJFS}l>q(sCqd_da1>%U}
zyFR%m+@U6ftU284IVx>5;-}%WX*EQg?o)*6_%sjcT{zGG81ul85#qV^)VS0^zZr9K
zgAxdK-KeX-;UeDQ5TCvky<7r|OPz5&(;ybtMWj^py5!)dC~B_TUS>d5GFh6~1@$tF
z<I?FKLXf)7#*F0`-}UV#y17I~yM%E`G%2MJY+ZODX*Bmu{L(rdaazJ+=v%+MR{AUB
zOsMNrO!ugOyxmeG0vS41wv{`#-;rUB70PUhBO=?5YL#v$x5C{6ZOQDto{HB*E`xne
zu>a|Zn=xooL7X@(=K6CxzTX!p!NTErlN7WxZ@UPk(*xSP$!|d~-f4LR&XtK|GduLr
zeYVa!7F6YMjraKeZR-h(ps3$D_%+grRe0i7XxU(9l}`VHQ;rxfHAi#{q9-i0%x4tO
z0xaJ&H}ok2Nv}(%3(p0Pn@+}`Fa>r)d{g9d)OMwGE}RJ1qg!h_%;Tboh+o_}XoCZp
zasPw$i{!HnK@Sr@+<T@ky2fKwV#THzSMs`BMPB-gw9VO1%SYe#o(o$HMcmQG?_4`9
zBmH9jrS096Q2jYv#^7K1_1i$oqn3Id0fyf8K6L}I%4LF6Q^MSp_;1~Z`VBw)1^IDs
zO2gIC$E2VGfi)eKV->1JtMaSfdV1?or2dbsreyb+#Qo}r9VSVUPF&pgKH`TuON(uw
z%RcZ&rp)P!;g`^SHZI8x%BYUW+^c@OQFlEYHaHN}hzV3d=T<D3$aCmio%bj0E>Zv&
zGF%leE@0WBU%NA$6Cfypge%7I4G@+)I2oCCfxn^Uu>TTBkV_X{D_55Ab(ift`4sM6
ztCcL8ZC>h-mQ~3AkWIW`<bnmLNvL&ri#8Tz05=(otMXS{Mo>KhPk*m6@w7^wtS88j
z`kXxzKnwnq`PO}z16YMsTm}{JK)O60TV|ig8mBy^_L2y!@*2JiLTkS_d{4m;*vVO6
ztooP{_+3rV?X1PLxbw(`>d&T_Zr4*%NHQ%{EJi&}%S^0#Bmg@P_!Zm{d~6@aBd)J^
z-o=LUimSnxG!H8j*+TU2jqS77s_mOLatY!sAxZ!cj+52^%$ZW%7c$ns)}tHkHopfZ
ztj~Tox-{WEj;99Kzc9pJXFqx2PiP8Kk?GUCY66Eg%EbL~zlV`qj#}<+EH@aKYO4ov
ze}xwd?_rt)q`Um{@rO@&{ZxZA%HAz`ZgIu#_eR{@_1f?!YO9YTZltjm_OnQrNyxte
z^%7~4UGm5Ek3HYsrsV?av-qP~5WY7gy)Xt8uRPTU`&3{*=4kvD@In+e-3D@H2L*o9
zW(ra;!`|>0n@`s>eQz(}ROGM8d}`K>-{K4}F>Lu0gDfSM5abHUqeuCU23gKK{qnsx
z0~^nEl1V&Ek2jS$km;?y8UoYpRUEi&-$4xp%u<5@(}v+f67;^w__5;0V|G~P2`Q-m
zL9{)1q(+QhUZcBnH&CP;EUJ=}cT=tpM~|?E6OBe46_!RghZRd3g)R;EKUG$IxNSav
zFh<dGmxY?<@j}RAFR_988^JSI@?5f|sfssn=SJBf+2xbWe9|J9`>SjqOb56@Hxb>V
z)ZkHbD&ktt-c1bhk)q4<0)e9AJn#C)0VbZQdje{w`EDT!%f5#1KuD2n(OHwSFBy4z
zmzQundgB?Dx>(CG^fu_FAcf_m^7ak?oy&cGeQwJZ-MusK!szieS|*P^NniXL^M)~h
zCXq<_Yj<D6ffdgMKAYcyeb?m7jO<;j_mQAwt`ALP4>b$hcxjHlk~64$a)guYhPOMr
zONW!~FPQ#JKTQc05fd(Z7&~a_T3ywwxCdHR$XVkSNiepK<B@o8sJS<;@mzwz!O8DC
zC@jwjM`FBrYD<2vb$ucB%$&@`g|Q%^zVX_(!+t-%xIyXcf~6p<s>AYuB<1ZPlemce
zbH5ymAWc~mhZu}p0u%R7B$=Nk>d}mHfk%g_YfURH_+84juKQnf=B}TSI}N}l6cf68
z7-vZ6yZ)ciP52x9_%uSo1wt$4_7Z1k@G9eXpsQq3HXYNJI+joP)xX*aXHfcWRaBfm
zPAs+1l@TR+Lq=cp^?eHStSz{^bk<?6D9Jpr&LRUl)J{A_g>dxPyNXTwlsJDt4p=3-
zN-733Kk_uNgZ>qP;g!LYSvFer$BJjHzx$4*9qSMxXAL7*`--1tMaTQ8^A3lX-@XIc
zvBf5G413+Na-^-=mp-I|2R2g0nwt45gOl-526p??4DltOh`d!J<e!go4Out!+)Xu*
ztPV{TkCib;KS)vp@W52o!{_Sq*QZ9&26+$LGY6ZNxG8Js+<&3Wa#;TiV(;to&-r3D
zWeEmx=KyN*w+{vW+=ZOQD=urS)03&vab+*m7*e>VjMGRQD}Px$PE&W(;^sbA7tY3c
zY%yW3-gT8yK5s#v0kpS%7X8)uppIvbxE%r2rOIFBFZetCRiW~cd4ZptE-+g*v_+sj
z6Ux??ALV|iF@89%x2%5k{p-?9Znk4?2)j@Vv<46CpAG&IU6pW~`sjoi%_bF=Y2Lhj
zD_fidouSU4xBfBdZD`W-?^*mOG5L9K^zi(7R)+Ftqz=)*D?{#6{9f2Y6t>}GB=e7(
z)Q4jiMdhJ?4*)%!Y~zV~+?_}?mU+=-hls_aMVx-b6`y2YFtJRNWc}<5=dG-3{bkE?
z9SI4C4reS_hHoKqQWYiI-$t-c>3nFWM+d6O)X>?K7n&}gyLtk+sEJw=yW-^L_h0X8
zs?f(RJ8G(J%#(uFFYx;duFok)=`eI(TS~srmgq-S&G7q~DD!;*XU@zVD`EyKf^H9#
zDw^l{1&tE}`{#?@pC4N_{EAR;6_uU-wHHi*QqcfzD2+c-95yKUWTQ~&pz1BLt~7W7
z9al@kipcaIA4h@~yb$n5aXwFV>_UB0sEr3L&%+lQeGy*~JFmb+xi^$LC54hk)L*Zh
zA78s6;2ULr>4vklN>f4V1*jlyqZap@gAMxbc1PY2fwc$lfkxW(uC3J>hktoV5m9vi
z!8iqsA5v!7DfQqX=Mxj>)Fuu-!F7NAdh50PYvc#rg@gd%WZJh%e~*(Qy5@KA2k)q;
z^t6E<-r)!7=T656Aa%kf4rSf334irms_0p!Jix=k7!59P^ULuV&&^@ySEz8^g7>yz
zE-J$PLXBBr+Ty++(!v-(kNWW6x#!0IsWgiJ#4QxuNQZTOk-2}FeBN)2_`)jU`T1Uq
z8bgAqEh(Ncr<IFhy2gNQE2w8)RZ2m>OU(6`0OO|F0Da-xz_>Ls?TMCyAZmp7=ob$o
zIM?)*+ZQI1<3?cf^fS*t2>>^Avn7BNfnKJo%u;qbk?mAH@hq1{^oQxm2sFx0)Hknd
zkK3s?h1_omX~7ML$-ndeTt;_mI=|dtZ#OeY6KlDO$}7LvJnkO3i?)A1v!b1WRkK3b
zZ}eF|J|?Z|Y%x6zy{*+SJsm?gG|>?eV{^xKm4gc;43gb1(eiPLI-sQCh>^0}|G0$s
zok+A2j}sV1eo9xr4nJ(c7A(>QNz*+A>t*92_K$?nU_T@n5dOkv&~+MW2)Hy%w(zX~
ziS^Fm?S*6kl*A*i<#Rag5MRl=KhBbrzMUH93S{XKvRHJ(37VFevV8IS$iML{XZ4=8
zvh}nZNqi?>s2qGh@p_6taQt^vej&(+3UKc1H<R+jUXjFLjeX#z_^OsGRU6tN^lR{6
z9~}m~(yJOGpe9Ry1D||^+gbi|#^%<~rL9<68+LQ+&$zvvm3dl{1644j$tlfgry1IL
znhVf^`F$%obpH9dA-xGw5ci9Y=PSN)wjNjd{u*^<xi(N|0bkZ53J8_7q2Q%XuqLg0
ztq6NAs`0PR%$(HObPjX#H~QqE4K>MZ%OmK$XC&;TsQR8bf-wl$^v12T@L|o)In8kd
z+H9gbk+$H@i5r)VW?h~*V(6Y*haBi5I(&q}HevzVsp&on+!d&i5URAeo)Q;7ae49A
z1eNKJqwwp*LNo~boMqHs1N4MftcT5i#DC9YfdlVK1uI(6C%dGV@WI9%wny>zo<;(J
zKqLB3?&N&<zo82I&jf->JGrlluJetNEJEpbL!39b`>kc0PR?#Mi%NZnoz0YNLPjs+
zchm00d`LKB?TQ+?gry5Vg~usdi)g(g$+K||=;USJ9vd-qc+;4J_j(uqMce6P`q=ox
zrvMfu2m0Wd_&TrU&X+j8GtSWlMwn@#m1lT*J`m&W=jXsPQImvc;fTom`<dBtgv>H4
z_+~cwzs4s8ZZAPn_3PgtArjmC!M6@qv1o6Ip1YP3b7ke4--#NH5P10`SlS<Lgth|i
zrU<PNlfQ-80BiB}j|)nO0pH2dBSDJ(%+uabG=qXMS1L~Ta<yB?c~*u}BeX}CuR)`{
zTaesHjU3cvibjQnk=ispa*`YQ-XE}_34Ahh?(^$1<EtH>asU<27rT+VH2QE8`a&m^
zktmmnA_VCn3HC>gZ2w2w7vSrdUFRC{WXK<!r;&jZvz<5MuAi(D!bTpn)KtB?>;%40
z0M)VIKbEv)q=LJ?ct}h4#?tZ>m#Csa@xap&dv|l+Gxz>oLc+c(jG!&#%%cI9-+%aX
zj55Wz>$qZXf3~QR9+0W7>}a$8OyTIna7OB+UY;3mP6|FNthTI?uA|H%iZ}0{$+;ow
zL6yO&Xi%4{LQVU><ZTZ0e5c!ZY*p2Eg!xJS^cUuNUgRyT=grdhbrExCfvVT+xXJ^0
zj=OCgT6;0}Ps$g_!boX@;X2Mob(${t*8~HeW`PrJw{YTgVC`?X&ux6?;mN^{-{7I7
zLGk@%WLw3CYCPilEVo0rc$la2(yjZHs9B-!dgM8Sw7*wt+F1>pJp}&AoC&E03$%_y
z(jVc=miI`6ebt>lb8eTJAcX=rLS5<1%4X{0_#P&cwcH@Lv#~SqPNhqCCw58ult6qz
zfd-yqXKvyKz;y4ZR`yB6=#$e3qXh!6JNQ&mm>b>n7C-K?_jBAyi%N0PjiNch=5apH
z;P)l`pBOw;L9yvdPtVTA@l}NaVaJ&<@jJudp0)R`yNmMtJ80btge!m<tBu&6v{S%f
zXhE9$Nj){V+ds$)cZam@VE8Luv(;Zxz_KkLVk%cb5&PUT1p1;Fw5=9?JpP_3WWMT}
zyBG!I+dTtXn-S6)*W_?(GQ^8YJ8t3{GO)z)g6lDG_nws<u4y_Qpc{qNw8Tpyu@Wz5
zAym^2M!u>}ywv3ikNCbTAFp&(F3q-XHQdqEcHd9s=3m;R&nc~!5>4J;e<kFsxpi27
zDeEcx2G9tRv0kuErXalV8Jf*<O>{}&aC==30WMQV-zT5^E1Oo>FX`=7+b(dP3|8vD
zJ~fvH2x!^Ci-60v9}-9Pj>qjkd`+6Kzi9aJIbqbYBu=P5<O=wyADI^V^;ouChz}oZ
zp}~iIr27!9bw-FENRlaakJ8#K5l>mOl9`thEg(}-=py#V?3JUUi3}7!w<mq)^H%M7
z)>2%&moHYH#td#YD4<~n|A2*7Be_#Au;dfoek`J%U4iI>pv$9QgJ8(^v9FM9x3}NK
zm5J{Qm}SK4D}MvbJ2tJwY5wSUt;lOpUFo$TJ+9!xzJ*?>(wkk)XF>H_kBbWe3_Xa<
zs|Rq~7?_e+vDIo(#%VJWUf-+IgEWtmdJ51<%d?BWxufQSjI3^W{V1x^f-k*;N)8kH
zUC_q>geO0z37u@AD0}&=Z?-sL`pH$$AahkMQt9CXtbX|SU%Rfxqt5|P(!E0KGvt`-
z7u4m!Oa&7A5&ig09?e$al~-iGC!8nzm*fdSF&i-<TYzVQcoact(x3C`2lxO!GZZZL
z0H_nNooef|Pf7E4$Lr?{HOhKd`WQ@$2@TBVf_UsJ5O?IhOKR{6W4@g~I&;?>QPGEv
z)El_<612FHV3`r3N5n<m*}`MJ*7m2tcP<;o{awQ63-gSPP2WtjMSP<O&lXOn2j+A>
z4u1;+Lb=WS1&0!<RNFpu#z;nm9iXexJDZ~);PyL~mB^M<P*j=cxPajCLVo)N(yy_A
zb!SxcAXsjFIS8`+AGV5nZzrD}+pwlT9ZVB3!FM{TB6-bng|Fq?Y2V#f&=x3WCP4Z4
zpo0Bd*7ui>G`AFs^=~#6e79XHPKa-P+HHP5-!t$G-&h~vEIeDs#|$ABRYn2ZD;jJ?
zJ>DWwA%S%#D<smlj}{tdtq#rhT~)97o1QM*O(fwwQ2?k;9b(ETNPhyr3)~hk5SS#5
zE_)K{WXyZWox;@;%A_&5XT7lZ>*t6PMR6FztJG9Z$Uffw0x{f@RrJ?d`@#uE0D1GB
zMehhn`dv$5ox)@*@=wZYWSsl1-Z>QEVEsFRnk?b(N%FLORIPN3RPp$zuVbYiJ7<33
z2^7uq^A~BXC(>B<J>Genfx9@Seo)s{hZ65r#?nU&Thm$(PR}{$<zKQwO#nawcoNo#
ze>0??%psD2Z6Ok^cEv%k2-o*#&70^?4W!do;(~eQ-Jv|83Z15KiT{i&ejEMlATYy3
zu=?$lW_g`RwZb+olfF#1>SI$4e4?1w!XO_!Ir#9nbjNvEiLD^Qb9VVY;j#%HDG&cG
zpI9ZW;7Hd;PDI$dJA2Qqshu*zOnZ0C+zwtsRw*@sd&?3pFT{Sx4blz3yTR5EZ+?FD
zeK1@a85y&dMeOdxuIf!|i&tDCw^mlycBQP4DDR=1Vg;z5G>0y4Q)Y;-6Ie<#`@F2Z
z`@y<sYI{91vtx&pbthVD3reVw5`TA9k^T8vvCB-BI&86|&mSJ`vU9X3Y_UmoXQ@Uk
zE=EQOJiYQLmH6y`!JZohVw7&X`ljnjCh>(04D$k07JK{laQoRlu?@HPecaahCw>(?
zfkIo?iX5o7JKki`)_ChhJh!PaB>nfO6$PigL0qS$CB?p4s5fyC#ow=<#2G(zHg@E-
z^S-df<+kt1ni*E&;Wyz%1XmDQcr6Apf-+9Rm5F~7gjd0V+T?A|z)Q}X%zbX8;w~|!
zB}SC`&}dNANMVv+YZtzyRFeYu`^zBaUC2`R76WO4v-STyI3qN}mfq9mbJOfIyQ4b(
z<f_dpBz6H`c%9hV^*es>j%Cp20h+sR0@$Pq#7@wA8OAy>)c<NZqO>6<Wk{jchYaXg
zo@hx816Vmd=9r~(M$i3C>VYCd`W^!lc=POERSCiQJZP&%d&XTL2bQrD%fy#c3#|aD
z+<}|&l?{&Q1j#{azd98vc+3k7<?Y=7jQ@8>X%H?!`~48FwPp9a#X9BAY<=J^9k$FA
zWzsxYAbvnoE1>_lmo$Otf!PK<^wYj)O#dbnz4m`*$!&pDD%TRfwH_98_d$OY_#4J_
zD7>}#a+v!*`L}PSjN*vymi^6#Y{L{JSz{{qi563C%?KMJ{+;KAF^?j}Z1};w_Q!4+
ziL>{gD#>a@gv8>nQrY;5#U{P{-lckU_vk`Jm3*WGk9gtr$SI-&O%mK@K2whOLpmVk
z_Q`?#zvX(BMhC&8f09N3)9_;_5y>P7etZWTk~2cY=%T=TncwXMwZ<Hld?kTIXj*VD
zfWUOG*10{K7#nUr3x8ldJ(f6S?_{7zg31r7duVqeX`*~%MkaH3iEwvslSQ7=Wf^G}
z;rpt3P@lDy(-8@9J{J&5@`AXli0v*(YFLR6{)gqlYf88!4ix;*c+q}A^=%VWV3tyy
zVHnRg($ZhHX*a=<SvW7sv}^20$@Cq+kNneKkArV>oK5Qn&EL&^M0<kkQLq$W`qt%%
z?#d_hr@R@)P=em6pxMVyNE8hXtn8b5H&LTyd-5r)!FJX<JYU||(I_BT&(L8P!r5~i
zQ^m%Jfi=!y&2q@tnDD|?*+(zj<P9EQ!3BL2l@+SG&YoJL>}6i?U~*4}#om&K_2?-t
zc;w%3j>D+p1fU4P=9Hcu(}CN%c2BzT{yJi?+1-Pj&l^1qtOnK}-@N=47+rpkvIg6F
z2uazALKMITZB<FKOVtRZP>uxNL%0cnB>}W76sNq8oy0$xh*s2y_UjAHlQVke)7oy&
zkyw;(WI*ep>V!FZ@Nq-0v+)FFhEowL4<X-X`Vzn%MPd(}z`b46zqHQ|I)^}iWfsi%
z{{5*!HR>owjQpmb2Y8hDA>OBPT;^M2<N19tKl0wDyVziKQAqt=6c|zf3sCw$DF=XT
ztU-8d-z!ba<Tu}uL_6aHh!@wXsX>KO*b7z9rp^##y8PK(uQx0?6}nqe7aOrjwE7=D
z5vm^NX-tG@;8Wsr3XNSNP;Yz{pT{008Y^Wrc1fB+r5nNe9iw3rC#?9b9Er9PQI>#N
zKB4QRa2Br+G#DWoP)iXmM%W5n!BE&aLVi!EGaXqmDZ{(UNa(oR^HGD<68OEaO6_rL
zgzEGrF(SPPRAK?TUYbm4eH;l)yuklhcu^ryy6dRH4Xf9?zSQ^GD8ZAgC%K|OH+mQR
zsezf1Im3jZ{P}y6JUc-&V1JiY3Yy3V`>Iv^1iiE316*l`kmwilhbPQ};1;2fkWf+K
zU&q)k7kOg@;z`P0VKunujRgJ_z*)ntxO}l1N`EwG|MQHM{Y{IdGokc-rzTLM23^wl
zlDpvccxH8_AHy9!@OymnG7x#a_wzfRX#OClp!}{`;vGoEx&`6G55X=*YkMHw$5fcK
zS1uAI2CPQ#*Q|KwjK5AjGgx0bMfF{Ckez_{1?$wQJ}F$2kUR1XB^hEooyT41(2aBa
zMt%4Kn{U|B<+JzGGv<kYoCUi^2f)WvoaewVX=UK7-{N(4^<d*O&lTO3w?@>Ml$yza
zf7?nt-$D;iYCi6U&}&oiJ)0NF!CPW5dH79i7dcO%HuNo%7#`+yQfPA}hQ<BomUNx@
zfg6`D(*KDn6<7^>MD#XQ*C#|@Z{@9OheU{7{^NV8`J$hkRt7INSPKQc7~zlJlw66r
z>BJ*?3U7mdh5~4<K$LzA4QxPeTNkjGk1Z$=59lYc12#u3<Aj4ODWb63G(Lh)Zr;(p
zWjFF}SoT{zE8s{tiCXxSzt#8kawk=xlM_ot?C*|yCckj^27E@(jl@4tP?8}r{O4SS
z9FcYhM__alL^fJ78qc3FoU4LeE5eWFZkPWIlHTlkLJJo|55?fF+E+{z<jI{=AC0(s
zk{y$3^062)pxnD+S?+0>pq(-JVz|1YwXJC$;Z9SstH4o(yhgw_2L%vJz>k!`uYa7&
z)1plHh~O!wLH`L{)elE%RGj^jLgpUl3*bB{od;K%C<L#4NR2*b1x+F#;gd_Yx1w)n
zhJ1KrZ=M|cSM)7WQ>P=THH712+i?5SQ`j(rE-8Ek!X{EGcjTwZgdIqD*i$ZCW6_S2
zc1<fF@0o3gNkOogqxYqztmA?U?rwcyt9y7`t_#R99bKkKw_0T!e7s;^p%6RX<>h$^
zMNz5vWc2Z5(3jOH5${i@dq^t+%k~$46@2c$IzxF&49J^pCqKZO%CbyrJKYz9Uj_oQ
zwBkq2XWL~qKe17RqEAC<gym98k{~@Mjanc6G&1alyp7x{^LkSJ;=X*P&S9{G+~94-
z$$vao8ghSnP)`L84(ky>p?f~9iY<4=eaSQ-!X}*A|JN{>e?b&i+|8LJ*c3$b)97zh
zAKL17pE}64U&+m0v`iY!zqNYvf*JPY6`QM$jq6&%i2Dq+5P?a$%Yk<`I5z~=&m%;i
zH#t;RCH7|L7d7Q?lCc2mMGWUN+TkLCmL*6z2zi4kls-{VDU5=zD{I=v_t2W44QcqS
zS7v$0vz+}nWQY42hFVYP?h(qdUy;Gn-GmBkpAy_wYeQ&ev&Q>tyAE21WFTC$GWz;G
zV`THe#@9+ekKm_ieR4d%s$|AS_O~R`?+-FOd@#Hcx@?qG{ah`zOF-Mg^tF@s`F#~f
zj9o!y(ifN%Xd<y2bNEoPbn%G0293v|e4)z%Cb7TOYV)pm8A)?Z&z9da(^G>{pg+sP
zV8^dn?R@;!6glCAZcyJR^N$g-FZI8#?4^W*qAb=w9)Ix<fU{>5pbzzH(Ur!3JH$-k
zJQSYxVW^q3ek_xQM#X<(mb<oPZQ!P5U!7(9nv)Y;$v+JmX+&6$znG_swbuAB2jTTU
z30)-TSVq-Uk=X+n9ulFCg6;y~#ozn7iSZp9X=MUWBf~g2fT8TEuR1{P?+&^L%4QZe
zJI7qXxpSJibyGRrxJ2gz!?r`5B<P`^C^Haq%=hya7%qm=cg|Cuk}Deu@Jbe+qW+Qb
z`DUjVK)XZNlu$NL!DgM=zS{heCS<du)bTS>0ReOVA-eg`8~$a)g^u}MBjK2{<I5L8
z0<nG!`T4+0y)r*{fBElc3V=OHA8X<8XSqimKOE_f)@!8MRPR@5{l_|swy?<yUz|@g
z8`=u4+N%&RSHH4)&xC2<`jb${LQUtcX3YrL<;(CBRGZgEQ<c8a5~!4IW$F$9oFk{T
z0HnYHg=LAJA@N6qg<AApCL2DCnx*4ivX!<xksS0iq6R&xU<qYtD-Xsd?YFEi6+PDY
zS^Yo4oC0BqLSe$_Tj9~R?k%WFbs{zHAR398w%4z-*HA%j>G$YYeA+`;LE{-|!lfBI
z<6m*>nz^i;J2a=a0Z_0U*mhxxr?m;7PdrSc02!;;&2f-kXDL!bqWx6QzlO0%b=<?R
zt`DV-f_*!3-#*J(+zoX1v{M`l%fu1te+m2}ni8f%wA?$>e-b3=n~KYP{y_@(9Yoy|
ztxX+7!104QMPw2$E|T@^Ast`a5?~}6%0M^@Sx>CWcOD&0qIq=~cDnPQ5d}R3UkZ6S
zRC4ZlhWW1uEUL{F`9Og6Gj94mE-Qid%<U`uE^few#o$N*D(1X$mK5}Pn~gjbUJ<b#
z;tPK2-mi9Av(cmVHJ$jH;6=pK{#<HsPw!#PaO=l?0kFRL;)j~39SPiOvNFyFntMpL
z0~DesUO9Qv0%lY3{1$JD6K0~x9E{_-W+ywJZi98IP=%&SuVc-M#(C@A#cx_`)67^D
zWR-g|8bx`sH{t`WyZ}5J*@bPc_sq>t3bl)G9PJUK1@o=s4T!I;o@2Q`X2vys-JNjS
z^p!b(IRb!5h{qmG_}=|+ZT|<u>~6T=naGM1p}8NoFVah_QOI;r!RHBu9py)G04GTq
zJwT3k8?*IB9PLr`MHDL>fqjz=JUd8uX)25!V2WJ~D5-0(s_Nk;hI2cwTmQS7ibxyA
zhqWT9ZcxYtYDKKCG~r6jo~LQ~9qi|}E_Xh&_N&%6zwM&X5H843vBB<SO_}&u3}{67
z4YvA`bny(RX`H^#aXy0ru~OrF*rodRU62o9=Q*{~R1aPX`i2_Pnis@$LpDOSC2DQ2
zAvggD5)<wTo#P(65^#?c@x%RJ_EnCsSq|`~ZEHhN0h^8aSyB+(T<>|ZRba+pATE^A
z&n{tAjY!9iU45jsNeVI?J{;cwL*n4d`nHy*BFF!*`9?daidRSa=A=_%2?fu#C!;W6
z^}_|K=58-+74Az|cL1%263gT;0wef?8Sqiqu;QtH_?v4dQ_CqWa{rr`CX0h=H!q=P
z??iT#fx)3I37oOyurB(4wejTfP<G#+X9hDyB#|{nRLWkmFO!rd*<ZqoiON<eLe?i#
zlA=|iOtOY3p{$dXl*&@}Wuzie$-d6-8G8TueZJ?P`F!p@+dcO@=bk(F-h&5mi-);Z
zJFH7|dC*N(S3EdDPXwP>A{v<M@@XSattFFpC9{4F=x$W(HsUBuK3ukZ9#OJlT6Sdz
z>x`2~zKQvF5Q~h;JDa&s%MDHS9ISnR9^5*8*nuN9GwBK5N9M)m^D~N^8uL2WPVzU-
zIK=F)l5Y!f{OUZ51G$;u)Bt|^B(}P(<g0zyU!B|@8Slbwex3Mm$~$HPMNjIVoEF_;
z@+CxG|3UrRKaUgH%3EqGcS4*25Hpg+1w(ULr^PIC)0ggFNacO!&tZFa!C^B-OlIWA
zX6eIH!VG<f9uB1|Gi?UyL?8))i!~{|CD0~#e3ui;VchZ9VyyQ9Vc33`;t(SKws_FL
zd5-Eyd*gdHT;+hf!*#due(|FRI|xckv<H>{nrzl3p_{lNU&dDOV;?(My$c<VSA>bP
z;|?nkTadN<rV&vMyaQ22_^P%qsh4xq%r#|`?$NHbc{Lv5iZT=7ZR>-lm2WI8+(=`m
zT=75}OJ>)D#j65U`9kGt7<J11=R_Opwhn;$^F?z4YRqM2-CJFjPI7=SHdub}<45gN
zifW9fXhKrd(@9+#`;p?2{^e@~07t9A8XS7*d-oyJtcxWni-~W6_h`7a-Lz)nDQ~`=
z#a}$f29vQ{NCoKVb|Wv{(3LcK2VB-++5uG(J6xtTyuOe+FB)FmpY(+3>`ar{os+)i
zX4LSqb{qSX$!(d}B0Jcy8wLCg8^8e7LFi{X3xSJLw$nx6!BYK?@~UoUj-DQ(zi$W<
zpC*l^@;ttXSm1IYJ9@%GQJ-#iNoGOdzLViT=MiV04L3+!QjAP;hD-jd408=Gnl`ox
zN;mxGjWEJ!CARq~Un;9ePi}XXlqx2>z~EL+sM&vYJuny(k-H$QfN0S*-t1K))E*a$
z14Z_GJ@eIad&Qu>7`6~+_d&;@yy8w{`I1q6=fG0CZ_1gSJ#6ASE4d>-)Tc3zNr8Uy
zYYvjlR8EkaCWwzmz#T4`n~9q>@r+hwbehZM5K>1hk_COwu@>|B->5?)?&J$Iugr@5
zwY|GI6fQc!(lyqfhPziLoE?VlDGM1f=)D=-&mQpHPv?;|72Ch3e*f+mA&QDryF2p8
z91qv1-Sb%o4e0&u$PHtAO5oEGZ3mu00_#4X9xq;fdXbq{<!|Y0bG9}omHx!&n8LTE
zw5iy#j7uozXL;|Lu#G<^g|=Lc9QRG!xE2iwPwaiMuRFfxlJlRG5M1DrkzGi&bCdP5
zf@coipFX{t%CzNOqJFCCd_0bK#r9Q!Y3B<k-kGDff!0{Oj6Ko}^0HKnE$(-cqG205
z7+nV`V@&McR6G9(?wHXJx9i<Q(&Dtb9*_5p#f;kWX1dG9io@MC2~XY%71sgpj-TfO
zQ^I*d(YZ9Xh@WD8>nu*a`dJ?)EQWMe7b;@+kBS@#MK722l%cOj$%Z4aEWb!n=VXu&
zg8CWYDGvC<n-p3;h0c{9(Z%Isto5YGj=5!yge4W6RbcN<tQHZqhKG7_DRMn{6q}kE
zk8DIIg-~rZ&25lOdefgh^DB3hD?;P?X(td0I?(?iuiufUmjh0uJTItZUMv8*tWj1d
z4}GV4p~Qx^ZAfAe`*j`PnX$muL$G)Pf;{`kP`Ytg6=o-UDR$hbSt$M@YEWZu!3HtY
zW>T@%f<M(NIyoEWcBJowvPMJfV`KsLz%ZkEyZ&-<NU`~h8?^w*NqStf76d4<Yj8BD
z4<R}PdDQU^vVu!B2a7DTRB5^CTi=6Wa!c);=x*rg8WMi!Ba!}N981qxfPMf<ik8~<
z$w(4RCi#8)eISqd-bFnqL8U*eaPXmH>$(**z-~!FFL&yZ>x-e8o>3a8(w;73DBCN<
z4lc5*7}VN>&$rWj7-22z=6%0*mf>8=x^Exx#nS`!614Mz<9!$Vv(YzslYI7vkyY71
zHxr|jh5Wf8mbm9mreU?)4DRaOz`?V>_KxHp9b67wm&*2jd6Yxb^sfpXoY3b74=3aO
z(ZVRsMKaWlQ#t+ANrlTpeJ_p99HH$dH1T7#i!k8TLMUZnJ0c_hw8vO2t~bT?KQ!#_
zPWZ`I%~`XLvAd`UFSHr^(;EX<DHuL_=4<zS+Sg(rD@Avks|;OHGmy(_0rExJAR-GV
zcu=Fr+UH~UAH7=S^(?;yFL-T-9FN;rg(Cn1wL|2<_U^J$K?^FHcD7~bFLT_?sfN@w
zw;Pc7CQlX$HgR!yA#OAgdzr#ed3hk6RGYeIe{dr)N%<_E$hB(~XLJqdekJJ;EG{wJ
zxN39!Jvb9M&32j&LX-*jDuxygCB1R2RADcRZo9WxyDP?v2kX|iTIt3X?||mz({iMV
z1rNqYacH{UWg@TZEkn|4LD-&%us9T11JOwZ63@Q3af*AaC!$`0J*#WlqP2iS<2HE1
zZwFd8P-P+KOAUgmi~o=~a&yWMpRF%3#|^Z8cl$^VFnHpyQW`5T1-D}t*c_U&;Qtn(
z;^!sBLs>AXp1EQB=L4W|H@#WX=*|dP1fIND_#Dg<#R(tZ&SqNs20U&1yj2qtoL3qB
zgn)Y?C3YL(u9;5Q(@)gbU+?$6vDRZAXvH3}JTnnl;!+S9bR38<bYj-mK~s{#wyg>;
zzCTkgw!lOjTMt}Q%r@kf9m25Usw!IU-+%mB#QlCn2R`NT?Qs30c}cQFq}C$x6hPsL
z9musYBeT)QCCosI1TtaS@d6UeL9e=UgMGI25H}@s{(HBy%ey><#ZS!E`Y?Z!B}V(j
zP}A2Eq9O#;2air^K<E33k%(7zc|+FEFBZ_mDS1r7n8_|RP`|^MJ*=iiV3>B9?jX=2
zA~=Y@Rd9UYPHr<@LYiKFb$z?pM(2rU_6hh`hTqd@M>hT-jj0A6!|7b(ewYE5uF-=C
zj3&kAY_w&hMs?pq1h!w?OksnJ?3olvf?t01_lr6^1g*LElR{~E(Of(z*O)NuXAR!w
zkB`eMZE@~Y2R)cCNOl_8^<jsFlilJcS?sLNl~ZXgjI2v6?=Z7XKt~2H=SMuOsCq^e
z1HrBe{K0f)%J~BF<gfc@tn&z{()kzTejeQPM3oPZ*4UUmzA?1OLrsJW@Ovi%8uylH
zG^t8;O`eua08Dy6BG=4(Sr<~Q0`I?$2g|)l+5haL*f#RchNH_|>Zl~HaTrD-oFkzz
z^TMV)O=hNyLKHtQOKL|L(?uMP=N5Q>H>C$18MHn+yx^taH79!YB_A0FCP9ZHmW%!A
z%%w^9j8-IPf%rN?WVC1fHnPH`G7q(4$t9ly?pir+GOrP6!t(!{Z1h2VSIHtX_tRVu
zoAiQMPENvuU+=b_!KBRtp=fToMjPJWbFHv1ZjR^@(3CYna^-G9EB2>`+r?qFyZEPt
zQR<}^B@8}|jeS<%ON!+h>qU-LGku>Ujem6W-T4k0$j)F1pPUk3uf>p+ieZ)$!Kv{4
z%_J{k44$FC5C|#1m~Zivqyvw7Pj+5<)mFU5X7BzPZS3*AGgi+BdkCi*-MyRXA_n$>
zvd1x;@8^rIt2z`6oQw7NewQ1xI0HnXk{#VxR|_5-{X>r{<qNAE^9YPKAJ%6CAT)8s
zg%1)64n7Zk^s)*)_fmAVy=@F4+=x)8fx3+RjS$`(bQcL6Y}!b_AGY#+0al>ocPf^n
zJi^x46;K7#eE@;=>a5CaEU@K4C083N(7!ad62i1$av}mLBpLC7Nq@k}vCc|XA9YG_
zUTx2DV^B)NCuThqm2sQYBck1%`@E8h!U<UIFbrbnAhG1E+ku!x0@5_hoHISZxWZ>v
zh6PLX76S9`MFF!HqYd@IAdfjD%0m@HhTAYI-tS1_ZCfU@RrwiS4-V%sv2ma>ODiFk
zw^$3-U(*sNpcBFbrOOb&iZ8LsCzZ`fGCia;rO1OM87u4{9)mh<9!dbjI%w=T$)`TP
zgGPqYsP<1<upi1<VYW^TtA=q#M7ZRn5<oLAxn!0DXd`dx8oW6SwOI53%Ije?n(APv
zAhuSQnB`kG8-?7<VuL1|EWJCnzp%P<f04EX`+1xzAZL8?-H1T%2-7&bT5>pus$%gZ
zQv71=qHcK_wi2NS#lY=+ego3<rtGu?WZ_Zch&{tMs;kp4a=_!J+uJWE7|vK@9C-&b
z?BwN{{y?+#eTD!7Dqk?uSEF#AR+mJtIW{_q+$cELHpy|&3;Vo{kpWmd<OMmkeMHM!
z3(ZUX7?--o5ZruTx-H(UYN8BjI)EE$@Fnul`|Ytfj9<dy@L#3)p>RvOEdw&9OI=Hk
z(9}_79*W=t0y+Y;yFjk5Gdl2DfBnD1{fFg4G-j#qI8Zynsa%ANr4UE{?717-t=t+-
zWf9TiaVX0i(8!G*I}XG`9N+0)!o(Bq=Ap-Hw3|%zHvWL*u!Lur{yIJF%F0&Po;I;z
z9%O&9<wwibHQ9W?D6o|#I59M!HLx~g+j94(eYq!KoQG1nv${Nut!)YMhem{VzXm#^
zq!R5HY}gjAXgcSd)c!cmdz&9L^UxY5hxN6^{@MpYgTi08{Mysc)mmcE<F!;sq@7?P
z@r5{b!bEU@9y_M%BY-|LgK&Vy{sdH%hunvJT+kiv$L66JVf;|WFlIfVQY$9~;L6~)
zYQZhn`@7Y#8M)fWTFhgmA($z(ksIy|J-g8SGwhr(V*|8X4S=mc9?;JxvO&JL$}UMr
zcUX5@;PsE#r*S?>XSVcy9||kr^_vm_F^mUX0aO}`kw$CwCNO`*x*Ba}J~Pg%E;Ctv
z>o|O_Np{7PQ*f00wYO{Gi{*lf$F=OpCbdPymk6LbSl&O%2N#Z5dj8VYxwAZ^`B1<=
zzH0C6e}tkqO4o@;P1&t84c7(=#VB{^3EjB|3iPoPAQqtV2>Fz2M)%v+IsK5Uo3*_W
zSPczI`%NE_WU2+agw`Skeu_ik2zKVq0xWrn_0^A<fB3QYw4`wUH>+%PQ~R0ED}7i<
zm>!Sx3+qQ1U*<1G@C6G3ou&Tou8rEi4LWzgEgHL~O_9?bv;Kclt1s0fb&7aw6e~b)
z6xd)|<Y2el8xyegN^)#yyx^)pfC<}<hCRTWy^pCgRoP{DW>6$%H8h3U)aB!nb2ztL
z$6+Nr>}uR31}`03w>kh6f2)k1MQjKS<_k_<(E<}gZ)CrjvaUK5XUCp~?+^sP718J^
zJhespx@zC?4pXvW44%BwI)PBT_Qg!&-Yn(C_yHT-TGV$jHp0O)pch2f^>Bam`IK6D
zOleixZ_Dwv?KFN?R6es38h3)93js1tfw2-BCdU8OW$PJ?Z3Y`f1PjT3<(A;dmYYbJ
zH?4pyfpT>ptoj5NTfwN62!CU6qqyQjoJmII8NzdxDi}~b35hwJrC%1dndencd%E3U
zZLiY;qs{O9M<?(9>1m7qs1B?I`12{q@Y?OCHEisB*q}ja#p$r-#s|z&vZ>S0&0n4M
zoEnOvUt!mGu-Jo@C>>x_%FoVj#KV!wiPxGEmMVO!Q!$$(R6&wC5}1`c`*YizD38+z
zDbYt<|LO0261F)iVM(#S{Y|wGdYe=d@-^X@Bs*)eDsbq6CQwDes4J>6ckbtHeB#$n
zuR7l)`iR@l$<v=#v=INB?cx!pQ`H@iDa^c-*NRV#O7g&N32yk$64+|rTqs%D87{n?
zq$s+i*t>x&@#w0J(MAi~|HfsS$8331>^s_PihKIfF$iR$w`_Xw2-^f=KsVeQEMPGz
zn?q9_ni3(;tnukUa;O|0`&S(mpltxsUC3(-nwp;r_b|jLDf{AjOmT$Yk)iJQdsInh
zEtRi0NKsRbv1+m9Z3$=ZoQmgDs5a8fzT<f`o6E*hJq$$<GO(dwFvLt^@A|U%u52)9
zVQzeU?wDZH@1WFoW9r7(7Mq1be#Xo`K%$xZ4tVw}N-|u&U%rCTVO35kaCJd1G7+l#
zYuyy?_@_?<&e@R?S9^$*0A|hp2otpu?f~{yP5rcXS3VX6kzt|T%`R=T=W%G+g<XuP
z3DeVgbZKB?G32C7Pt;5=1|%`nBU@)wv#Td9d8GlP0b4Fge$-q}+RxKG4G#vxu0FLw
zS1524NFQRRnjc#HN+QuDG@1UJ+!L{CgjgLiDR}hf-Bi(#za^4d?~?6gid<RMEE&fu
z$5h#hS`V-(O)`C@p(7E@$`11fT-{DY#4cgCo2B2@RNuTugP!iEO^a>6^a0b4CXN1j
zo2w79qA{>zJ(_c<mLD-o+sxiHvvgYhcUmiD#hi&!&`Iih!4Jy<{FHX{{$MjaJ4;c@
zWyp}7T_j3|h28Ao=rYBryL-j3I<N|ZrC68Jps~*{Cu<9^WvFoewbL+8#?mlpr1fzS
zQt*`TDpr;e5PJK=GTBIGg>l)YyhVYe+G{Ig4NithmFrVXEk39;1J{b5>i|cAOFbfV
z4gajTzhd%%e{1?5(l9#?I03<?)sKqg?AqiAgVGjh_QaJoVI=<;FD}OzLN2`)q=ekN
z&E^;I;71w8uIbxR!9*X~?ZF#X=Ze02J^J_@Hf1ZUXwony76nGD4zm%-F*lHem0{G#
z5s@#PG`|@iM>YzMHI<0XHZ*-#$K;0a{~A0@tNAyePA5$8I5M*0lL35`X41oK6?F_n
z=F*g;IvdM|@=KRAvOj!(gp(M=4xT-ukC!u626|&s?YIM&F=X8NK;>P>On1{JzzDVr
z``xuJJ0%~dL`2yVr?}U=AlHVeamHXqudJ*&kz3)A`ueznG~B9R4)UisNmnH0m(r}S
zL@jUFHf(++s;^~j#SbBSon%#cUB>8oZ@LbqU2NrB)c_ZEztc5>k3$>0xHJW}4f|pw
z{M&}*mx_e#J*U*#rru{s;V|4UTTmt^&9h>9UMuC9G^xvV_woAI58fl$N4QZo@^#4C
zMz*WW8X@62jzzvuAoHP(_frJV$S2^ay}TLckgaKWOrDZ2{wsnzmRqBI(;RmV*!J-y
zJ&$z6_Gy3+hj=mb@G8-Z?~^e%z}z0bJrrd9qS)w-upibZ1@It~OX@|^+b+9**&Hjx
z&arxmG>#oC|L{Y3cwBpOXzTs{Q&pIW07PHN_g2)1M^}fPm=NG(wS>NKaSy)f)--r}
z_`<d3bu4zO@}Orrk&?2~xYlf+TK}CJTm2Y!>n?=vQgIzBpvysp<ZP*DxY9U(Pq3KJ
z=feT&(v9-S=*59A*KXj3hmo~?OesKnzoJK~>t9YZwWr0u7op>@?6^n+`PVLN?9bjs
zb0ReqN2T!qXV&iJV8W}DYeKZwhEFvNXT^;l-CV%11iJ03WvAA63rj;QiloM4XTC1+
zT&=22`7Co#qd73=_#Ys4Sy9kr-mF64sK?os3%rkf-X)m#Xd^q*z7Yyf|M3aquA&D;
zZ2um0W4lb*-Z6`-Ww;N+KR;+6o1VC^xulX_6XG*|p!mR0bo24EobQD)ZR^V0`!eiH
z1?~&2qjL#s?Q*M9o7*g$yG8h(gmU|?J8vc0X8o93aUIjLHIpX?^9}{Ps@gBxID2DV
zsC<NKsr`s^__d?Ww(<6WV3*As&!}`SZ5njjjr{u|`ouHEU7S>RoZnlz|Dx^in$RR$
zl?kqUSK(&TiKPR{UmXr*S)2psyI>H~+r?HC-(KwE#YcbmO8f2Et221^0^5Jfol9=S
z9-N6zQ4w%BF?aL{ks^f%$ts<4NrKN6#}40JhwC6<$o{|Xw+_e^c%1)d=iomM>wZM|
zT}jrLO%8r5TB(XWarG|4`5Ui4y;Mp~p4#nYFM@p3PbGg0i)$^pS>2o*cHxvaiCpS>
za18}SI4K73k324DV&M1Ok}6g&QiB?79QJ$PGl2=Nfm7vu-n~D3TjV<89{n<e?VRKq
zwOk+4YvWywgy)fxxEw>+;-Oa?T##v(9G=Erw7lhARDoZVv1o)!xj@H&)!3$@eixiY
zPjT64ABF2SU17{jf!)5M!v}ivFs5B`=h$f22a-khUQaK{KK^2vkKVyoZ~jKHB4tj$
z!7RIVsU>b;V!H{#DD`=lqVnr5;4F-wfd1M1IPU3UYpQUm+L$5|A6lxJsq41(*WweT
z)#SM2Yp=aKk8zZD-kf)E?R{ZuDlgfmi?IFv%w{oQ$-6^u&C%e@Xy5LQ50Qf}b@3Ta
zO~XznbM1q$+ALox+~0($1uaCIr2S1C|A#aF|EAC{dRkA*Kekm(tz^B%d(8|U>Qkfs
E4<5Op@&Et;

literal 0
HcmV?d00001


From 4db01aa3cf044451eae7305d7bdc484e50d8758a Mon Sep 17 00:00:00 2001
From: Nan Xiao <me@nanx.me>
Date: Sun, 21 Sep 2025 18:25:20 -0400
Subject: [PATCH 4/4] Update news on the Primer palette

---
 NEWS.md | 7 ++++++-
 1 file changed, 6 insertions(+), 1 deletion(-)

diff --git a/NEWS.md b/NEWS.md
index 32f675e..7920f93 100644
--- a/NEWS.md
+++ b/NEWS.md
@@ -1,12 +1,17 @@
 # ggsci 3.2.0.9000
 
+## New features
+
+- Add the Primer palette in `scale_color_primer()`
+  and `scale_fill_primer()` (#62).
+
 ## Improvements
 
 - Add `example_scatterplot()` and `example_barplot()` to simplify
   discrete scale examples in documentation. This reduces boilerplate code
   and makes it easier to maintain the examples.
   Also improves graphical appearance of the examples by using a minimalist
-  theme with alternative data subsets.
+  theme with alternative data subsets (#61).
 
 # ggsci 3.2.0