From 3b5bd4bcbabcfe4538d3c607fa2ec31a6d320da7 Mon Sep 17 00:00:00 2001 From: Austin1serb Date: Sat, 24 Oct 2026 15:51:25 -0600 Subject: [PATCH 1/4] fix(core): keep Tailwind variants out of local font CSS --- packages/core/__tests__/e2e/next-ssr.spec.js | 19 ++++ .../__tests__/fixtures/next/app/fonts/OFL.txt | 93 ++++++++++++++++++ .../fixtures/next/app/fonts/README.md | 4 + .../fixtures/next/app/fonts/geist-latin.woff2 | Bin 0 -> 28356 bytes .../__tests__/fixtures/next/app/layout.tsx | 10 +- packages/core/__tests__/unit/index.test.cjs | 71 ++++++++++++- packages/core/src/postcss/index.cts | 23 ++++- wiki/.wiki-system/audit-state.json | 2 +- wiki/decision-log.md | 4 + wiki/pages/core/variant-extractor.md | 5 + 10 files changed, 223 insertions(+), 8 deletions(-) create mode 100644 packages/core/__tests__/fixtures/next/app/fonts/OFL.txt create mode 100644 packages/core/__tests__/fixtures/next/app/fonts/README.md create mode 100644 packages/core/__tests__/fixtures/next/app/fonts/geist-latin.woff2 diff --git a/packages/core/__tests__/e2e/next-ssr.spec.js b/packages/core/__tests__/e2e/next-ssr.spec.js index 9ebb914..20b05ac 100644 --- a/packages/core/__tests__/e2e/next-ssr.spec.js +++ b/packages/core/__tests__/e2e/next-ssr.spec.js @@ -3,6 +3,25 @@ import { test, expect } from "@playwright/test"; test.describe.configure({ mode: "serial" }); +test("local fonts load without leaking Tailwind directives into their CSS", async ({ page }) => { + await page.goto("/test", { waitUntil: "networkidle" }); + const stylesheetUrls = await page.locator('link[rel="stylesheet"]').evaluateAll((links) => links.map((link) => link.href)); + let fontCss = ""; + for (const url of stylesheetUrls) { + const response = await page.request.get(url); + expect(response.ok()).toBe(true); + const css = await response.text(); + expect(/@(?:custom-variant|slot)\b/.test(css), `Uncompiled Tailwind directives in ${url}`).toBe(false); + if (css.includes("--font-test")) fontCss += css; + } + expect(fontCss).toContain("@font-face"); + const loadedFontCount = await page.evaluate(async () => { + const family = window.getComputedStyle(document.body).getPropertyValue("--font-test"); + return (await document.fonts.load(`16px ${family}`)).length; + }); + expect(loadedFontCount).toBeGreaterThan(0); +}); + test.describe("Zero-UI Comprehensive Test Suite", () => { test.beforeEach(async ({ page }) => { await page.goto("/test", { waitUntil: "networkidle" }); diff --git a/packages/core/__tests__/fixtures/next/app/fonts/OFL.txt b/packages/core/__tests__/fixtures/next/app/fonts/OFL.txt new file mode 100644 index 0000000..dac9ac2 --- /dev/null +++ b/packages/core/__tests__/fixtures/next/app/fonts/OFL.txt @@ -0,0 +1,93 @@ +Copyright 2024 The Geist Project Authors (https://github.com/vercel/geist-font) + +This Font Software is licensed under the SIL Open Font License, Version 1.1. +This license is copied below, and is also available with a FAQ at: +https://openfontlicense.org + + +----------------------------------------------------------- +SIL OPEN FONT LICENSE Version 1.1 - 26 February 2007 +----------------------------------------------------------- + +PREAMBLE +The goals of the Open Font License (OFL) are to stimulate worldwide +development of collaborative font projects, to support the font creation +efforts of academic and linguistic communities, and to provide a free and +open framework in which fonts may be shared and improved in partnership +with others. + +The OFL allows the licensed fonts to be used, studied, modified and +redistributed freely as long as they are not sold by themselves. The +fonts, including any derivative works, can be bundled, embedded, +redistributed and/or sold with any software provided that any reserved +names are not used by derivative works. The fonts and derivatives, +however, cannot be released under any other type of license. The +requirement for fonts to remain under this license does not apply +to any document created using the fonts or their derivatives. + +DEFINITIONS +"Font Software" refers to the set of files released by the Copyright +Holder(s) under this license and clearly marked as such. This may +include source files, build scripts and documentation. + +"Reserved Font Name" refers to any names specified as such after the +copyright statement(s). + +"Original Version" refers to the collection of Font Software components as +distributed by the Copyright Holder(s). + +"Modified Version" refers to any derivative made by adding to, deleting, +or substituting -- in part or in whole -- any of the components of the +Original Version, by changing formats or by porting the Font Software to a +new environment. + +"Author" refers to any designer, engineer, programmer, technical +writer or other person who contributed to the Font Software. + +PERMISSION & CONDITIONS +Permission is hereby granted, free of charge, to any person obtaining +a copy of the Font Software, to use, study, copy, merge, embed, modify, +redistribute, and sell modified and unmodified copies of the Font +Software, subject to the following conditions: + +1) Neither the Font Software nor any of its individual components, +in Original or Modified Versions, may be sold by itself. + +2) Original or Modified Versions of the Font Software may be bundled, +redistributed and/or sold with any software, provided that each copy +contains the above copyright notice and this license. These can be +included either as stand-alone text files, human-readable headers or +in the appropriate machine-readable metadata fields within text or +binary files as long as those fields can be easily viewed by the user. + +3) No Modified Version of the Font Software may use the Reserved Font +Name(s) unless explicit written permission is granted by the corresponding +Copyright Holder. This restriction only applies to the primary font name as +presented to the users. + +4) The name(s) of the Copyright Holder(s) or the Author(s) of the Font +Software shall not be used to promote, endorse or advertise any +Modified Version, except to acknowledge the contribution(s) of the +Copyright Holder(s) and the Author(s) or with their explicit written +permission. + +5) The Font Software, modified or unmodified, in part or in whole, +must be distributed entirely under this license, and must not be +distributed under any other license. The requirement for fonts to +remain under this license does not apply to any document created +using the Font Software. + +TERMINATION +This license becomes null and void if any of the above conditions are +not met. + +DISCLAIMER +THE FONT SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, +EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO ANY WARRANTIES OF +MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT +OF COPYRIGHT, PATENT, TRADEMARK, OR OTHER RIGHT. IN NO EVENT SHALL THE +COPYRIGHT HOLDER BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, +INCLUDING ANY GENERAL, SPECIAL, INDIRECT, INCIDENTAL, OR CONSEQUENTIAL +DAMAGES, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING +FROM, OUT OF THE USE OR INABILITY TO USE THE FONT SOFTWARE OR FROM +OTHER DEALINGS IN THE FONT SOFTWARE. diff --git a/packages/core/__tests__/fixtures/next/app/fonts/README.md b/packages/core/__tests__/fixtures/next/app/fonts/README.md new file mode 100644 index 0000000..2592910 --- /dev/null +++ b/packages/core/__tests__/fixtures/next/app/fonts/README.md @@ -0,0 +1,4 @@ +`geist-latin.woff2` is the Geist Latin font bundled with Next.js 15.5.18 +(`next/dist/next-devtools/server/font/geist-latin.woff2`). It is used to exercise +`next/font/local` without network requests. Its SIL Open Font License is in +[OFL.txt](./OFL.txt); upstream: https://github.com/vercel/geist-font. diff --git a/packages/core/__tests__/fixtures/next/app/fonts/geist-latin.woff2 b/packages/core/__tests__/fixtures/next/app/fonts/geist-latin.woff2 new file mode 100644 index 0000000000000000000000000000000000000000..445e0e55cbb80e4a1fd7d429c4384b61b453da2b GIT binary patch literal 28356 zcmV(}K+wN;Pew8T0RR910B*zp6951J0P~Ol0B%kI0RR9100000000000000000000 z0000Qg(n+& zaLWIml5~yOz-t2({l2e2PZEMghBjqXoRuad%@s&wb)vJPLP+d`+538@4o_h#GBIt0 zaMi+1bo;fCw93v1Q$*}AADlawc;bL$6deHm0)y8c zl!mA2{8wnOLIV}3C8_xjV(j<-<)B!K{zZMG+BKe1rd7p02F42fwTTdX(DxJb)-W1WCM(DUu?~7Fh_EWQZ{UAfmCh z??5L-Pu4tEhCMt6LVj~4njDxs7(a1sw;;=wN~sw%0U_XV8hUJe_++>&(x$XcY2(t? z<)YX8_u=!b?+e_fQ)><0KFE`CTI-Lv>kiaWnzr%#Be%XD5F>;L5kedZ5+F#2VEyU# zF}2f5hFmhEC)>Dhy-O$wPh z<(TdjP|5Nlk?yDFMrLafuG6_itWi28PSgN()eD zFDUWugW{c`&JRgqdz>{-oQ*5tkT(!BXT~rzumFJ4G zbLrZhsj`bF1@u`!>>SX;^Lf)f_%QK391LZ`b8VL!kW%G9 z5bzk0Ffc0#@gzQ;V1%e<|Dg~wh`A_8j1rH4`FDnDOH)CAb*S8cA)e)*nhP8!m+YnFsvsCLr;CN1;hFBZ7f-3+30qiqv z*Dn|svZ@=UTZ@@6q_Q2?i&4u`3R(+1AmF!u-yUX=PZf_9fM6dt3$(+}1_4Hb7!kYd zmaT&N~*#%9+;v!5JPmh9;BH=}0>riBHFbkSmdrctx?h<4Wdb!$mZ<@z6|vpl=KO)VP7w2IL)F;QA+aYsF%8;5CZU6y!vE+! zYpuGL*J-G38!-8zkIHYYjcTr@Yw9L#&AFIk*^!DArE_%MSUfR={v89JZ(fT;-J7mVb0{EnPo%;^L(x zV`kP;AIJC1rZQpkXxkEU*nH2Rtr>cx2$<5+bqhW?>oT_^!1V@k%0m8I2Qah9f9MoZ{9Q^g zfWv^@fX#r_fW_eI6H(jzC{4(iJK75uMrkYL9M)QhIHje8+2r%z!T(Aa7JRg5q`-wO z??q`B>wm_|Kn7|x;-=c7*~bXom#{tW^E-t+>pWHg`i}x9kv2?~aEp6%3?`XBYT2mR zc!cs?ZZ9*;Azs#hON`24Zb9F`r)nzlj$L=Q+ao8P3g^(CNL`rPeb{+p(-h57ZEZ8fpNtr>|8?(@UP!Jc%;Z&rYgu10inF& z73OKc74g@SAxEBH7r`?e3uB5R=YD0Nw1$EThuX*6_TvFGp_OQqdg4=06U z-f8Q0h@F`{_|nPujQbFUUz7W<{=ODYarLGGDdp@Bu=vAOX;c3jT8k~Q)H2Jhuu_Fp zDqYdwS6BV!CX;5j-PNL1n|3|=JoDUJ13nq@*%x1Z^W6_W0|jA#tsz&{UZY@aES_PO z5L-%W8FR}Ctst-xrh>$(CYT!S7G7?KT*Gh!%S~)1Jk2<6<7*-Epv{&)NDq*DG4&xm zZRS8jc?(5!Nsfe#NcqQF&2hr;+<%&_2K76^CAm`e`=t=L}(V=x;H6hX87w`v8~)VTk~y7(@#dNY9-X!n9n4Bd&X_*T0Jlx>s^1C-Kjktm}Y0 zDF`y%WV2nf(XW-lo;9!7Z~fI=^e_yvZsvNZ+>1y4FKuKwpim0w89g0F2}>!qHb%_0 zE4#%Nys(N|By08H!7siY?CqZpuKn&IYa^fzZ(kc&R8BbH+LP3LVP%i9F&d=DNw6)0 z0Q1?Z^-hR0+=yPa_F_uO2|k1&vvE@0T&l*Jajmz9u1#`3nt0OOBL+ETtMyOb#$6G& z;2I@(EMV~m;=h4*-Ram0$t7UfsE_jkzbl^&B6A2EX?wy-=gy3>qOUGYF=gNc`AIM^ z65h*1<{S^s=Oi&gn;5S!l1v5Lqn3kj{bP%GJH-YZ6m*r{D3orYjW3)k6|8ipD3(&L z1tgUOywy1wzf>xPJ<;D*VJ6gG$Qsdckz#SIbtfUdWd}<9uw{txuPJdeQ)ijlzovO)iJEfGBdMjhG2F`0 z;4)xyJ`^b#kn*5yb@&xT#=SZy@8li6Fs51Q4%B3f=hTv)!>M1vA&Dv{rLNgw!lvLY zf{Bqe;6}MgXlpF;I=`%N2RwGrOw&}ED3I{>H^Fi>Yz3pYsIraPi8pF=EE-%#yYE0& z(&MBA74Q=OWO3~2!JHJleFaz)@dbz*F@!E0Xv+c-@lG9bSz<*Dof*r=_2$QCvL%;U z2BgcF=^inXnNFTyClykZ)iF3o6|OBV^VyG#rDf1|)ps;73~09IptUfglHbt9fZW>sHJxEV)+ltdWU2^hHdRm4x!#*F{E$AS5sb z?(HjlS$NR#2h>0eWdT{ab2qd3nw(TM6(t43Y(!D$gXu*Fa#sfH^)d%nlge1YvTV@G zsd=NdlC)k>e6q}j$i+6?z&9z41HWJ;ZDPMASfZFn)?Sdps28QO@iE`B`OwHmRsOcs z57+r6i~*|*@H{H7&|qZ7Y#^r245UBdJAENJ9DJsX^hrFq#9wcvHfF%jW zsCGm?l@ir~WGDq6e$v<4lrogz@hCfwqRcw6c#1LzYJs&t-786fP%gYuOALqOiO4ZQ(&kyfF&Aus@vaEm`_jmTkSxePSlm*PiZpNcV-Rm9#>4Z7!RQR>*m`) z$TM5dVMsgG9j0&QdXvRF{F_WIn`oYch?DTHlmd%ymC}aI;NMKFyA0c{BJXG)QXb{D zGN{Sl$s8dixh-Olj%#k*8$7|C9@!Z06hpeN0~0bsq8kxTRjw+g+FpN6ye(<^BOc$; zi#-x?Pca7W&C0cUlIK3F4Ou@S(6yIwSWi`YQ;OV~xLGrRJ-J4pB3sXCH^|c71rxmT zJH_VD8paG(3@S>>VwIdNtqZZ>7g{N3Hm2TLXw}=B;mQ;&K zoIyQ^g!cd!sar2%l3d7!%)rU;c}E1!eB&S?W0bZbBQ1mC{L(h0md-Wn9FA=?SFwgl zYY->62YtAQs#rM#_hxZ7?dFeCa5ST$Je+Ic-vZ}gBW$+w`i!>gEwi6ZE|q2KLV15{ zq)ss_k`lM?j%ScrIwvk^%;nUjtVG|4Z+z&AwvB^Y%rZ7-jer`pyvU83bCU_B_iI7_ zUU{gCpKQJW-~3NVvH_TP`J-9%rok{x|CW^r$&8h|A*8W%+DNK*jn7XibUWb;;RSq4 z{1CtYmb1rnwxxpC$k`qjeteA3)|*|NJH_&vp}KOKe-nY<-F9|Xr4IA_kgc%e@3sZP zqPf+j7R=VXV{@Ys@AGti@g6-Ct5f)pY^^!Z3Vp9oX}K$YE9>TLEmK~nS&Q{r^A>G7 zY}J)_=<(c6Z|yVix!R{-upeggto7#1jd$9~o&AH-{4(@2fz_4a>g3v4ij8bj7jjJY zrdqBvo>0%WP&nkM>Wx3eBx~*kHp}qDyE(n8L8DBLBS?*)3r%1go#k5Y=_8Oz(luJ;I;wFe@T>a#?ElTn8hCov=B|h;G-Rr ztv?d8k{1Y(+B~RO&U3Tbo)>KkeufGB<_NoiKa%JdCTh+I2N#Y9;cr7g!kjrN>tE$; zSW>V>QBpzdY2lpdATEG&g}A}FpLjeB!=dMc%Qs{pKmJ4lvP7UT4B;7xkN{&~ZsZA* zXdGm`iKHe4i1C}5$)+Gom3D^Qfsg^ogvmn4hRK2Cp7`?2#x}=Xq?|ukEHUif`?gkYTS~IoVoZO*wmz@^Q z9%L77+6i=U(8*C32i+X?u+dAQkBz6TxUYZMhbF8}9)^Me3uYvQg(rLUgBQZUm-S_a zNdivHn~gM*ds%QH(tTj3YZJ<2s)K8S?oxVo233wo3q3dTO4pSw^}rJ zATc^>qgNRvb||q!gBBU8cj7=?g#!zxC0Awpou>!IJt_xm>3_OK3S}A#5o4nW2#JW9 z(Q@U^V3I7Qu0Q^xj?r(x=YtZn<(x9=-v8!WzZjLSxptNNkiPiJ*Y*sO%bspiWi>h$ z(fj!5wj_#ZVu&S1tj8r;1;Pjb00000001nB z1wF~YzJ^_wlz+Gs0Zhu5BAh4P({#pCB#)uNUG6c#eK4NF1kuE6lJxy9K8c~9Qk7}J z!HJ0y$({4rV5B-q*vpJq`Adtu1K%9X9gm8=!o;2B>KcddTt0W=-g3LXUpCrzJtSlz zKBSy!KljLxd=wmsc^=xyHu}@1p&$B4RUXb@8{1RA@qX~fkHcSX`iL4c+@pMsE2cKMAQ_EA0B}qr_q#@<$ z4INih{JsYCXmp+$fdwHiGv##S&xN0dpkzsi@&cyCOL#HZ>wepJuMoOg-du{0;H9zu+Rc3@1}JWfI~^&AS=ITowznE@l0`)y1_PQ(ah z4$Esz8;pk#tkFO*Ehn?=%`?^kbNmV^64?>P=PesyM2y&Wjtq2+826u;^Q9FSFji-2 zWh<2%${1tlBf_a|i%6j`%6MbK6EtqX1*|}!^%5$^n^HRQPM;OZ&_W4N2Q3>@FTZ$f zloM==pO9>XYLpMSslO=BEERIi7=FTdP97Pj^0J8Y&zc;;xOyz#aKY`4lFUdJiI#Fz zv_xsM_Yp6gjN#WDE0A9Jb6LyO1q0_069i1|ks?;h<$Ef`>T@ zO*Ty~SF`0^Eab|LtP6(RT&Ty>DUff13}Z}@6%K8@d)}BZ6k)ZI-2A;(N=_`;hXvLF z$soWGPCX#HlbTapjo$TZq2QGMyYQ7vw@tpq~nJow{(+E}&$Wbt07hpkr2nGR9 zKj*~r*1w?fWvF<~<&WC+F*RR;``?9IKZ314hRZ*LihsHUZUG8NbMF_dHUG7BUub{d z0sOgzM|}Sb{ENCic*|`vH(^Z!&4oKl?>X-Gwl=rATB8q`AI^KIdTe=YdyGHPwej1; zZK^hNJ2*YMV_t`_L);PUh;`2GG{*}XdPTGTqnHu z&4O>4Vp_aheC6B4-_2AOm9%n~a*y)3c9-^u_Ney6dFXuLeAoHm3-HCe=i|m5#>+o( zt+#)vuy3&Mvp@e;=RV}!sb0u@NW^>Hu!fP{DpSKg( znY^?326@Z6H~Y42+)Dn z9XQLE?68BBEL@{pNsNE^e^sFU6_HBtD4-TD6R-jTD(2GxV-&Co?DEs6Yz=_-TF|}5 z`)nnYbbLiiHdVGF%OF4&F%xL37uDRmcy!Qs#VQ*vst*&}m(CzoFI(fUxjeag#irc6 za$DvIXqy^flUgV@Cak`fsQlbk!~LMhxbai&q@O9|k+3ax3{?YsHzWyKpKY#Jr&SwqJ4nLb!$M`q-AMwN7c|iPu!}R$G$U~!NB)6pU zwxajC=9wmgA>gg&T0LMgq(O@-n*HjkAHMnShBpuj2akY+IVlTr3bvH&*mLH>l^b^+ z^nCd86X3Dio&+XZnEUVw;~EvqJ1}X55&SVvn8HtTG;T=WTacwy+i7zk2>Xz<5J|iM2rc zG{6AsYB<7OY@&H5H6-cMH6N#bWKTybEDvYujNC9LBZHO`dI@~jq^e?o7HAeBjZfCs zm6G&$FQ2-v1zht9j4d@n>?-z>-h7q#A|!46fd8MBW-N(KbI2VBx0yX*KwZee&=g1% zW%efB9Vp|Y$0YlDs|;aUhG*I;8gwbD4wa#ScDozyzI8wu;)VnETr*ElhUkq<%u^Sf z8V)^WCpT5<^l~KHZ{5T)u7%Vr^Rv{~vm#B%sVX6ZG)T{7#MwdWQ&UX6+_e@ngCk(F zT^m@uPm$HidpB&1fMZ|gd=`tC^-;81^Ook|d*dBl^d_o|j{Ab_*(Abdn>@D9K4xe= z+PA138PY^5bNc{2=Ff{M@K1)XgGQjIZE8mQE)MZDQa)j^$;AfvVC4^>PqUlS?B#3$ z8Ssf}ZRAMVS$}9lBAmG~;=p|VSN0?)ML&cb@Co_ibC%PR#HWJf0+wQLZM3cbK-YjZ zZ-Kt>3(A@k8ZJ^bA1l~+I(0ucd&u4YZNu80A__|9n1F6}Wzh4aIG!L=05Wlj_58HZ z^vd>`r+N$8oXVP|(3Zo?x6EK{tIGFsc-n0cx!i}nv_{PVbp}Xy*)vNW z+K~ijNXTe*SX;4to4;ld%=M_XIfj&^a*tX}4T$}4$V0T#ZCPHMA_t3*2~7HPaWk@) zuriPefSb4dTw{i&+R|L~0@kR0tdK2}gBAyZWCqy1?ekrX#XdA3ZGdztonLDklJjby zYX5P7MFcZ!)ybJ$z?yqs?2ITL-ICk|w<+tb^ROsN!TD3J%El=G_b_vfrCTtKrWucp z)k%<-;j9i1PS>8lTBVA2C>m2Ary;39YVWc@jT zL*B#9fXs{R{w5J5Rd61=hdRtqIH!YH4I_PE*en3J7u3{?~NE!ext?Xmh*^xM{0|Y*>%)G4UY}ZjNN$~ zl6@AjLv~Nc!og&H+E&|WtLkgxaLu~xZQNATv&bH9hUk}XFP^ogFP0KYG$m@$z%*G9 zjXsRbGYxlDWnBE_lC@@#bcisZy}*(m}iR7 z+Sn|&CFGE^gT#(u-BR^5^Wffa*lyR`v1+nsir6qkuy(4>-nr%OJCM+Td&DQ0o3QPD zBt*LoeSV9}p2|*HOA8}oo%N(ln)(d50^+G8C*mvCoaMG_POJG?9T*v;ChR424(1VA z#ia&fuO*|`nD>R>AccYSZFTI;WeJw4-kyea@jL&u7%tORb)xKJ-v5 zu$b}5bp~g2j+r4st{S7f zrN~1N*7dvq71(Oq_r``6=s9CSnIZ5)`+l%$(-nLpS&q`CmQC_(nceGf{Q8dI#8{^yNsBA4l&S4Dc0TxgiGEfGLay{c|Ux*J;Cuujkq8|C_ zsmXD3YGP8%S)jda_MSsBGq+h`*Rli~pD`9=5XA_@qPZ5fxeQj~=f<2#rxWfGa$-;x zifVt{@wC$?`w}mPzWjcn76(bOkZuW@He9K}{Ad#U7auO>^nzp@Q;E2jJqsY7#6%H$ zD1;1*451ZKu?%SzhIW&}9oUTbjX67Q%%xyI@g4v+u+*+Y9b zh1QOYtX;PuHwrVJ;U9G852>Wo`N8DP-)-B+UE^zlYsS-{OVIH^20zf#<2|^!wIjU1 zigwL};*6PSJdzA_kh1&y0r~2jm$WAh%FNWagYtrdvG2q`5j-shDN|&^izi-;M-(P! zTXuvs0WK5H*$e}~GmZf!M@1pj(-L`i9u4>`>aZi{nPzM4t5gfOcHImlJAU2eRgG_! zPg?S#@Vrno`06)#vlmCr9V|;37>t};9c%9ZgM!?HG5`MIVgG>#BLE*fUDMoX!Yv62c%4YE_8klHD?FZ|1=R46EcCa(++y^P6{d3mO zt@wX_QOessMX@4Cs@CL*sgNVoA?d7>_k)yambXW3YK0Y2+$jmfAl%G=%HNNQPMI@o z@3IU31I0mBn;*sx0a6fLYIXH8+;K*S9HV$fm9rY+Hhde=(iMS2UV+RiCVmqh=|1at;bQMz6g>P<{(T(JTWOm-pv~KTe-Vg>bFSNgDOFhhbjn(mE zW+0b(v?0WStBYIv^8fVOdEK)S)Ww!p56~YJXPLD$_>zOIUKAz$5$3T*#0J^*6DML* zO7WpoBHuHV`>gC9vl3U#p20n-ptrU~NH!PK;zEH-${**%*EjGy;A62Koo8w=c2RPaAT+(uuJe>#Jqy0&C7dH+?p1f0~@1^QOuyj0-dQ8 zY^*JqHyu{-=1wA%8wkx*u8IhLM&zmHnpv?p_E2G(aa50jL62%TX1n9Pnhgaxba z-_%E9R4VPK;usc4hQs{&1nd$#{xyukX2j#6af0&=J8<_Y+ztm-dyPq+)%k3c@yeUl zXrIv(5rvc*q!Tg?dws^CJOmqJ>ROum&E^v;$naTcAPoW}mq5ibmoFU*5@|r0Xs4~a zuRCkRMnWY_n8UQyufq%uzaO^%N=%o5;+?pp=0*dT7P`)Q#BR!iqPoHNzdox-edcO=MHgh~quHt2PT5e1DBKO15IlXlY6 zPOK?%)rzW9+fo+st3~sPi|@!oB~4KXstnG{YCih|N{mk)8=8*5HiL#z3w=*X9bk5e zJKL#TvO;`?(GI2E<1(0;oz>2>F#uxw)u4)quoupEp!=m|4F7J?gFRp%`rZ5Y_?P6 z!qI&uSbk*WNMdnU97(lq_rh)S(g68?n1_q98&9o0)p36EKWAmPezNTokl%`1>-JvayI&cheo7JW3es9?XS| z%-T48hNb>eNd>EclkNZ9q^aS}3(ncOcurXee6YljOjDH92!Ap|D&}*Dj%d_JMdD*B zQUY8M8HuC&hlbDtBZ)|q3`2(P{Sh7srP_CFNJ&@Iu+2(_7E&ARzZt>t(jB-(@SRP`FzlzkxQ`gG#I3WpKM(+Wt6WI=M94?J3CgVKW@0sM4~?^jv{J z;mkrMSodfbk^Lgo5lfCe8u_(|270EqS80pmamMn91@T5{uZr)%1R5nNVx(l7H`8_w z<4@~BEBNjno4McZw)fAs0zH!&^q3yV#p)h$Ea-;GOd(Z)$EP0IYmRm7ob*unzFvx} zc6FIey%=F19JIJYu2_sz^4ti&S>feN+)5?i>lTBT`pxGCe02a+Tb%x6hj&i-zwmh2V2I{aPG?@Fj~Zai_kMZ&oJ5D;3AZei`$A;Of!Kn0JQl)j zNXkK^V7I}jcA8PdWmX&A2Ebv)`Xl8~V#>?cHSzRj@B~r?7d%d9m(?pe7q<7ZG4e#8zA-n@DOkPW0D18EVb^6jC*$5HIn3dguS`3yapZ_HMnytCb z+j_d*-w!*Xp!=*~H;=nmSk(Yk74N=!guUax{_Fp#1qJ`@6B+JFr|E9DJ2w^Uahavf zZWk)^NWy@dM^W1RnoVG9-}}2i{IIP$RZ9tTwY_Y;;N88VlLES zLaZu+_txSoXLfo zv`r6LpT5SGJG55YRXO+C)3O6iTI{6J$o~tAwU*D@wKhD)J;M5_R(fIg`COQ5{S&a7 zi489R!pPL=wb}u#PNxIGVCj?;4$LNUd%W%NR(sfRhe=E#fOP&O0oiW(ZncJJH$M%6 zEsbOwBPaYZ@G9@%hI6Upb?1s7J6-YKQYpD-M`z)0hAEbllun;yg06@qgTN{1@th zps#E=MTrNV=$n!$Ah}I?$!yIX;yM9p-A{aSl85>>zW>FS8{hMmpZ>IG#HY3_5YO@2 z#zIfq!S=@CzWf4MhsZ?67m}>_s$q1)S1X)Dz9AH8Ac#q@NSpFP!E;3y9b>#HO^}Ep z0=NoCP8LBTjd64@7M=49vbDFDn_Zs0(->}}$S{fY1Tetj zu!_D4+wfoM$lm#R`@u!a_QKiu2cyX+`zZO+5UQ8$Z~pGM5~^!5Q_Z4)4$<_b9S$un z+xf_p6vq63;VzrIxJqs8Nw+xHtcA0|b^5lv=7DGndf)v>TGv_e((x^-ui5dUrp|hC z^ShjQnMUCRlbQL2*`%!6Wr5JXD-4c56$xlDE+3H_kp!vP`>rxIG_`~~@EK)lkDf7GaTjuhNB9-HHh>D1v!F00Y&K(}Q-OYek}5%$fm%D# zE;CSYgt5wLaLANxb2*M?f{By{1yR2APyBnP$xV$Wc~(n8p!ep&j1jle$hq{-3J&Zk z_m{;b-e%#h2e&VmNwjc^$I;8Xn;NR{GJfs$V$mI-UKEGi!mm4$q z{G;3XsNZK8Bclju&Pz!`+G(+fp@tbVn+sBcHOL^$<~1j^>QZKCZV+QjP}8Ivw+HtX6l zMu(%-2-7TKw$&ts#qB1CT*9e6?<=*V3uFuTsaZEFE3UHCz?NT?)-SQoU24}=bDcN(NM#n}M2Ysx5FwOCi~l`{2O(b z@{_fw-_fGyQ2ky<;=1g=9vuhc?jcOX)^>x5xIuL~-0;`teFRt8M09rsO@G7t{X24V z)ynae2KEKs#>5o6SMa_2wOl!8QEB&`ErIPJYhN4<^@rSg>wEBFc`}gN zg`@YngHLvSk;q*r-^OS$5c<9OiLXED<$9N^6Q_(!^x?nWbpL_s^^R1y3b1SEI%5v~ zx8+Nkb~6ixfAD=IVdA#l)C=d}_w>Az$3GmZOsQ0G=r9>nQkp|cY!z+N={AXkyZN== zed1-*@ISRQMShf{*J-r_Vnjh^^N!$-%HF>Vc#q8_Px{#X-SXBEBjO ztpbuTq*|QDM}tup-adQzw85c-)$0_QpywN#o>ZDdm=mnC3sAw>9oxzlmwoj?aa%ci z<}5R_tg~EGjSH*fv+kHP%S~L3&;}%fo|zu7=QG8gJxyaDRm)x}FF&j}k#w+%z81*e zm<(ap@36tSWld~|>*02lAO!Ht}#E&N;5?)foxcBe%L3XfTrZx*RKVp}VbT&(6 z7RqTB&aGkQ-Cf!u_7f%?$MQr(`H>RwC(N6=Ow)DImR+>b#dc_j7Q@Qg3|Q>XNeDb^;6SMK+9CY`G%NP4oIm zOZ!o@?4Pz=i&p$UTKV6oVjQjd^Q%?<7d8dIfd79)U9CIi>fC8p@6PC~K5FOm5z?)> zQp+joI88lgIBVwyu-YLf9*^u5JC(-&pPp=-&L&sq;%VG^WdndIejN9#qUi&vfwY>z z&f-hR1u0}z0{qi(Uv%`4O)J@+6*oA%-FR}O#$fJ``kQM!bqkmr`H!FeoHN1%LlknB8;(=CpfDh5!rv5hS2)Yn5V3>*ts1 zGFx?PJBeqnrD?}}$3cu#<`@{Ow1Q)y0 zCu5!O^ltq@N^wfHHB(B^%#LtdGIZs`dIM@VZ=mbEBvAnboKECK zh;qiJ1frO?O_jt2`77NOL){sA`c`TGOilK>^0rL^LETiQVnv~|jdz)JL{!t z+Mbs)IW~Yz9DjDa2z(v47-(1lWR99LQ1m)evxx+FZ&_C6f*{zT&&E%!cS#Z!nn}yUqA_A{B@~OUOeXRHeJ++Nho*`^p#|>->YuntL_hER zJ0?coSMmkt^bFL2S^x?L4%wRwB3M$^WfK>Npf6m$o^SC?E$Se@)v)mkGy-=_zi z7jeX>u4Y9QbJrC4K0Ya5D9j0SsELsWkXb#AmEhPsr#iz0e@;}{0&fQPx0L;in8 zQ#AA1UPmF82ZmFMKQ#X2_zU8%<4xq9bhP15`9=J`*+-dA3wC+Gc_+MUv)HUTH_v+P zL$hC){hQhU_J8$H`ZwnG=O5!L)9NvzpVbRW>Sr;CQISusT?O zu}QXo?O>-BZ@M;lBHuQq(uXxFG~bT)o<$2-V7#!Ku&KBc}|y;FTr-NNtUe-MCXX-%kRwx(WlP4JcO(M!@A z+KV1R$I;{H8FU_9O0T5%1j99p0xS&328_7}XA8J=njQ#&4*+atz4c)%xMSy1T!t(e zkEY>l_h!^K?5Df_WM5gxO!I~($k?C%f}Y_Me-4k~Wn$uh1OQAIAR#%p#TEjPp#2N< zaayc9(frZl4l!$@Ye%CjKuO>fSK($rr68W2}EdU0wYkm*LU$S?lh**IY9IqJ|K6C+7BLU_JaG7A8i|-mY0FEL>xr zT)6ilc;??%{`ZphgavegNb?9eFR@&s2%Ml)GK``zb_DhwjHjMqNT3Cf^p%bZB}vfA zjDkCiY2ujt!Wy*Yi^KV}n7*o8oA-EqI7wOhP3UFGIyv@6;_P!A(wut(@PodB1}McQ zr9t^9m?;w_(HTjxar^$6w2omSogqQ@l4z-oInNJ;`bv7TFW?13;gWB+QvVku6BK?Q zshTT$2zdtjGI>mk#Q|nrJ443c&Z-m-4L-pe8_td0bP|+`>&4jz@2{HR1)4z%`aX)p z`*eO2;UfiBx>vnRxvo(tGa63_gx5y4Il%)EqcM;ogxrXg671kg;I-_?K?0NC$vb)$ zEUAe^?&NAoL5aPI^Y(;&wu-<#wHJgnhITh6x9gP*blg79g&qd{7!M{xbbUpz^ToNP z_%$7SES<}U^j&WR&-^{r`;==6UP(auB^oRuU2(A=^ zwILAA`ItPM?_YW4AKbKf^Ubk0C6<69sB#WC`AXqv|43sED`07`;gaI%L* zdDX0nNCdZMkTy8@aP%BYofO)kQ{2)dQg1Lx2w_xuF z4?Qd_FMqfih*A&NbgBEaI9dCEKj3`%Y0K}w-@Hid?o#{Ts_8~JT~l@fPH+-tb4RMEg1D#szqoskm4!uvu*Yp>H= zgiZKO{J!sXTYv8XEFAD*ApSslX7fUdRHLnrW$pP#??lBSi4MjX@S5f_wHtd~g(;KH z#y~8FjdY__dLziE*+kC$dNMiI4ulnBkQ9`wK|NJU@ig!(741S3%?t}DP4Vux+8FB} zlhf%Ba+z=eA3pN!+mNbwq7@0w#q(${q{TF|^_vDMIDeHVn_V#mNrdg_$zBBI@MZp8 z-Kv-#T7hPA1+1B3P|rB|NK<3B;2V4eCj3UWQd9as84GF4|d))2uh z!?>W4ATLrT*FeiuQ6^+p8j5|Ddd96JTv)Bw%DMt4LV0v^IA6@03ZWyQz%2I`P?tZ- z;U)$50Fz+|>fy^b>YAt6YR|#uUIO?^-*?BVK-*9VZ zpkf8l^_CIH`Vm2D%{QUnyjTuv#oqvNkeMi_IOamIYUDnw5>PnmAu-W~$qej<-HPhE zY#je`tE2{MDHB0wvC!lSQj97}w|dz%77fjQguO~lb4-O{gNKfRt3|n&=Txdb;9f-* znZ7Ifv8o4F6g@&Jgew!*@tU==le@!=Q~G0B>d1{{^$7OV%^KP$NWDCJZGgJ?Yk#A> z)Q*sJG|epIxKjlyq%q!eyWLfAV^+ZOZETOI+kt*At9@rGvva~vxYs@KBO{YmC5DDZ zVCz{hafSp7WRtvYV}s~gwUL>kNh*}@A1~y zz3Ikn5OVV8sr}i97mZ8gpMlwTs$<{CEAKx778Fu^RLiCPC9RW~2%&GH!`tM4yN|zg zKYYsc7Ia7e(NGH*z`!-GcE{9x(|H10Z;7={v}-8@tC+iy;U-W&9u?W6{*n-le^}}K zn1J57rA)U{pQ<0(^1oB^Dj4Th>z{-8Inb~BJOh`lH|QOIG^Q~prpE*ULNU7j_>^JA zO`Cx~O8m#KY2psBI%5vrw7d@*FOwNary2Z>HPsVT^jra?Qqk(TP)s1>Dv^Tj9n2I> z-7O`Pe7wun+I|gvxA%%dgb3{*xh&Ffvk8`pIGPF?Is@Lq&k zi;v=i>G%=7!V$QZ1Kxv={l%&7_bC?&yb5B^3&liiEXyOgsZ?{?UDQ5g18FiD$O>$< z7sgP>$JkDewTR7dkP14~%Q=;6d6|DJfYEapnYKhln|JB=I#swJHaJm37+Td) zndgOXHS0n1Pn8TsGLVTg|3JLX(H2XPP@s@H7q3b)PMFTW~rAf%I1%mtoJi**S1r{gbHeXtCDd0hAA5KBOVvA`Cbk+Sw14Btwfm~ zAc$*rP!tzH}hTOS&ey6kAS<24W z-D*G41dIz)4KPICH;h_|p~L;swU8^!0faTMS?cYQMX}i^)ntCGNm8V+KqMocpDPlx zBGO<8KPq-6gMpKPgSj24({*7q(YOzA3t<8}vflG-NU7ISHdIf@Ty?{N^J;9fvqD9q zJgVj;*8K(ByE4jfUi576a9ei*yts9Idaj4wOJESoTkPnXmd#9&6IDavxveWV-74>oyj3&c?4w-ABc(cd%m7Sy_zqTR$#qAKQuq?81J zfNqhk+)D=slmbCch#-)li;2WgkZcOv0EP|&0dcARa5j}{D_pp+7D42Ga6><4UXH(g z3I6mV|0g?v?XVraV_P;s@O{~8(^^IaQYi%LrnVP~V%|>krC(3U4CI@Bw>RkM2=z$r zVL^MNAWr)9lm>*P*hFM}J5Aw#uMWxC9&@ZyUi6NEQCZ86rD1Vw28wnA0n6O*WUxQV zOqi<7p0};uR(X|>8e!5+x`JazZYXC%J)qHuN@d#{tVtml>WUG0NcqOjp|pDf0VA^2 z;1%qba9+90iB9N~8CzRMX3XiH)i}zkfvVmGLon>dK|W^(!`|%(Pz9-} zH_)m74!e4*_oHwBOh zr%zE-K+~z_RN!XknoxhOR8uLcY1Ami8P?2T%{QC`az@@OWD08$_#7HqbXP>!lP(Na z!3KNtGWRZmCMuFyr%Ae6Hyw!~vcMyTAK>J0b=c(FJqv_zEsdgySO?9it%#_N85xCM zPf>yGcW$qQ)`$z6+w>QGxX*{V5X+%%f6(`5+5^aE+!fd*tGVy3DCo zl#8hH`L>C&V~%V z8k$(K`Uu0zG+O&=9TsJH*3}t_BzzKK9)`0E*K9{jg(KjIKG5d|YLx^tVIeF*7f`x= zk01m`V1-6G(Nn7!Q7W}NH8>{XS}B>92vTzO0yiIvu|Zr!q01Ze;gf)sjByF>v5u~5*9`>Pd(QK48Y9Ens<$G+iKS#y^X+uE|G;rC|fL`5N>a&%F)&{+}CA+6M$ zS?|{Zpd!#bR?-ySXpS-E!{F*={IAsJ55NSA{so7oMX(rMIFe5DB8>*r6wa!|$d7nQI^x&8AsI}e9!k?m15bLBQ=OKT%pAke%@2jr-q_z;FD_|FTWSOx)4HNj&mTZA zWhwPYzm`PHd+$pn6DGliSZr^P(w#(^VlVF(h@%o8ao8E97uxS;OP&^pX~VX-j_nv87hh$K&T=M#K~)X5aIuzYigMZIGFGQJ zcixwpndwIwdL0lNGG~XOq(F5`a*~gSGL5m&apHW_@Fr$hY*=oCS7vfYg54MS2U`#x z9U}y^8f`c}ymz&wkh@#t&d=P~ju3ZhX0K1;v;}TJZvvQ-utGaMiia%q+&~eWMhnI= z_4eLuZ70^#IZLFw^pId3Y$){5;zh+yC4npyE4(0jql?zauDMZ>pLF}MWh_jCU7beg zQuSuFt_4q~-6$$}7 zyQO8G!0ypH84ksl3372?6e-B^BJ+G+*D8t^%jN9kahWW$t%rsGzM0qF$$+*EpNn0= z^d%L;G*%QSH1=(0#C;0uG~;?uDfw6-moFoRD2SmQyAvOLJJ?=h@Zm}F3kLebkWv{1 z^e=87uSM zxnL;?W7Kac3gf7MUN;E;!%G(RIbv(l&I2iYYQPPJ6~@im4@sw^@f-I%vghp{)d+51 zg3W8&HGFjKB~2eXA)@$`I$PQ31~okRv49hpPKqwLH{(L$3ZVMaYj8z zhD5_110Vqd_6jfeZCf3{WZZ9oEbih2P)Sq3M`O5gxlpvY5OV!iN))5QeoS=Xo%R+A z0l~5A?5w6qN=NCdYmgT(?8BgbIRY!2c_QIx%c0X%EjNdYe>F<-`EB5T5%k}YWuIgN zE{!kt{V<6=o}8WobngQ=b2;1%4mmmjl*Y)k(}c5n>+EeF2~v13ZYvbh*ABa|wd?QA zsJ;^T9UNZvKiCC3PYTy`)C0}Xg-kBH1*4UiC#JosT&+f{P9weQg4q4Yh<>uRCDovY zb|Td*FP95qGEPa_L`))a=woB-7UDvf0v_apc7-1B;haU0H_{%th*Dq4ma7m_^-3$K z+ilOQXEjsdd4WshL==6_ZF&xPRmn)F0M~NeN+~4?^@bq2urNw}hGlIvW(Z;0b4t(Wk+jJCXHAaf?{OVQ{E^n+Q1*A6pF6cmp-$et;#YI zQL&(G`)zHg2ATkXnFB5(x=?7kqXSf}Ru~IYHg`tyHM;&GPc^Q&kyo!VhR>+XQ8F|G z@O!5?Z^F!i*O*O1hY#(9`LIUtBGc(EaFb*1R|?Ab<^CPr9t128F(@4%OaWxhf|xou z@7;9Q7Y?jnr384vTW?#IQn^Em-TT0kh*W+n%&9KggqXCp6KmS53qbE3_nYSqxk(DG z2pYmhafL)_Z=f{0;7c!CR!ZmwiSMtMG&K=o``eqI=>L-5 ziIiTkoNJ)(yFLqBU<-PCWWiC}F!Ruo?I?2NzM|bIqYN$%xzuVRtVIbw;W#5er3DRL zR|-7N!}$&pU2=wvPdB_yvjP{3EJT<_K}cZ?rrGT&M#_)1oAcu3dPF$NvO4_KX4LR+ zrhoc*e62>+1B@gCZc#)FhXP%fKO=7k1V6+O;yXnVoDAN z9K_+75<`QvqLdBt!N)Zvzt*5ihk-wx7WfLLop1g1eKH!p=$!Wa25=6;O>aRdu#_yt zVci5ZEwv5T2mRST1&y-o9()41>|i;pT-Dq#x$xaKWT(*pDp}s74>U-2>xJqp8#rVA zV~iMBTw`H_Pu3;asnUEbXUj#8Z67Y>>o-LHxb~JHP6z+*wt6fQD&g9b06D-0rDW}D zxrlCdN;di3aWl@zS3)a+5s{iME1C>D$j%YC6CGU24ySM}HO#B8AgUNEQ&qujin1s! z9gRzZLF!@`3&Vz>pqV7Bb^SSnniY=$(K|>bQfO-tfnuLJ>~*W4Sq`hV^XQ#1#x{hc zk)f7W(TNFK@7xooLmunwJnDp7T|KfVIOEHuE0ZOk(s&9^1!6KmL~~-AE1y)jxU@vb z8277IwJ>#{?X?!pF`=M!2fcxhK^Q{wGM^PwQeZq_ZKGBL_6WJi`L^!|bmT&Fbi&#V zv2wivRGsHNZ)CST5S?-v z`oI_+Y2bduqe?)H)(xG5ydxTIpU(?^trlis>yA#Fh>gfvt?Tmh5uh7wL2D2%Z0%hk zg?S}9vX0@@I*5HRsOVe-S?gRqFF9#0f6K+&l)*;Qv|*<`To1OUs)yB{U#pa}SuWjI zCK)l5)%T<~*bV3tQF7 zb%?4;d(XA8qr z_vj(W!9)GC6)hYbU_S|b4=uq8Sm~E8_r=|)n;`-{%iDW2U}LUUk(Xl$XK2S4*s|0R zGH8l{x{F%Swn-h9xIxAd8+3_S3?80>1V9AVaD%t(6T(qArq++lrX|K>%(elAnH9Uv z3o?sZbpT@nO~Gm|qZUrAk^)1dB?t!yFDe1hW&Y{pFw3T>PS(c%+{ng(2D&j}_QORG zSU%$E)+%frbOO;uvHPdtv~gfVb8zkCsOA5GA0Cej53W&f!1+5)9l(n)9ws&7S`$^} zf=HW16$)9TikX(W;7yOMm7n-dD7G}ciM%|%TcwjZXF-EZ|2Qg5#4ZD-Ef2l$ZDJ5p>RTW1T z6W_2CW&~(zVnlh$4;NE$V}|hUkc-lyrNz)`l}ZOd+4CWEwPHKI?>JBl65o+AQY=MA z>`X+_Xj+n*vTSOl?0rq!AgqP8?GnV9UiYYO!+hD*fOCoAh=_<;+$xZw*|^~vqo9)3 zAj0cYm^UC18L@UzHf`yP@McO#r8Gsruw&|H-TZ^2k$&^CZyc%^w0V9cEzNiH6{D-s*L#twc0CmUcaeECs7tUbXJelJ!Yf@@U(u7&4ha z*G?p~9?{43i9;!2rOYA$tWe-sMROP)&TVgg8trA8soN2Y!`jNZ`xI?8s|#YlFb!}X z0L(&5wpVW)ARI7wTx!@(jm{WQhIJH!WHiU!-!2UL%&KS=yk^sJ{26jp!vtPC-{_dD z_5}=vJ{hQ*n5p*nLpq5E03m~hLTAkDVz*5dATk)Hs(LDuQ3y`fVuId6Wl?< z4eB$gu6Xv*jrA$2U9W=@BrHGUNHRl93AH<+Z?Mb5iDyQ#NY}}lt(&nls2OjACd1o& zn|b|Cv&@ZK%?u5Y&{DBoPDO^&nRQH@DDKza_iUg{~7(?NxN37zl z47a=UOjm5rvaTUurPzoFe!&nKS=F$s*`fhai55NrAe5#vtAZdPyzn4oh%ByybbQeW zq1DtB88h7$>OYe*O%o(=AFkDGaG$i@0?YGVlc1qpS{Mp4e63P(qm1bDN z55t3`H@oIeT!ShQ4rqC~`@o?@?3Ev?Zawq~_&(^Yu;OoHV1Sv6<`ybRz%iuVE-dfz zSCK$#G+~8$rpTHx9UM=AL;Fz6)&v&bfE~%|yl0wIvi`Pgag#5%mI(6pES69vpW7Ll zv4%8ad3hsHr975=7=rfWw{O3J05~j}HB~h*)@hnq8>Wa-c)xGrThp|Dj}sa zhZvR(d0Z0S#NqXrgY4J(HGVo?X7Ak2k;H6P1eT^*;jrr%o`0(kU_Q)km_sQUBE#%< zgVS0rpNNlAO}YN#<3s`9g_xMwfx$jLk8eq2mkisBDj9JeO>NX`YlfQOKR}^8v@zEt zOR7jy;@#EW1KBHADjK^BFwBLyd?6+#UWx!+;Pz{^Dp?Uz2WPmx<0H&$tx=W6!fh80 zy;(v3g5Ub_36W$cZz~hbej#sb*6oGn|MzIUP&jmmPfpj3-l;6AuIn`lXQ_hEMaFM5 z2WVT$uB46>DI+)VWX~VpIQO%6eyJ;PFnsA8B%x4j4PitHuHJ;$ag18g@NjU01)jv4a{$g`-H#MeI4dXYY_uZ z2iB=m+{lK5y-v6ow_n<+)fq;%lVrs2&=$H+rq-v%{iuU32n0{UyDN+H+w^?2TH?R0 zh6g*6LwNoX0N_RZSqu7t#lkszqulS)gS~k3t#O`rj-a^3X94^TZd+2u0(b^~BA)ea z4ls%~WdR(7Z3ajw~I6 z&NR3G`O9a(m(*3s6w2Ftgjir5%rHPsB>UhS4dD)X5lv^)q2!O@q%p?M0J74Z;)S08 zkQzr<@JG&%%fH6qD}RKiz(YJf*q4yjFP+$?-Z}vnbwWr`0A$(DX>{?9)=Dx00&yP! z@??ehJCR-%9l=kSP-K8;q5#>qH-EiesO$GdOeFVjm4VO_EP?3|B1Hs^CB8sU*hvL|1CtyJWU@t~<45u2fHgNM9N z8)xql=e9Cr;5QII@k&o{uOa{aJOB)_truwI*Xes(G4iHkj{scC#x>oKyI14#I(?F+ zH7uJ146qA=&ww8^DryX?S!#<$sa6c4WIz?X-O8Pm3%UN||32}=*Toa?olaQTyn*Be z>&i7TU4K1s`*!bJumj$OA0BM_w3Y!5dHf02+F!pmNU{e@0Ng13bOhC*bYw_2F>@V6 zB47u5UMg@g)R9ygl^4Q-YNj%-tryTvhU+9Oh@J;O#1HWHrxSkl``Y>*z@yQ1WY~sP|x+J5n1`WQ#eObhkc2lz|U?b6Z2ocUDUHuU`BQ{G!o83K5h{JhXJJ zpIFt^8%RIEpAt%~z+dt1R zkbpqMOXhK}@9ZHTeRSx(Fz88Qw&HZj@i36l?naloLJ-Xc?CkV;BqWWQyr zd2!Z`%C~QB^XpOF%fe?Nx%C(mYo}$^*TijK%W9N3LXN$W@usK~R_*(wNVP|53@YuK zX|c}63R>GG9QJM18?CZu8HI<=L2vQTz{TkF;`M$;a%DmBlijbAg(2A1xf^CMgu~Du z`)jguj5~N-p?K%B=T8}wWP!y?^vEW1sJmop!YQZU<(P zswWKO1PNWAaf=Sc&$e&53V0dAFOv z+p;!9=o&y^bmL%nwQUyJs8N6@P%XAW(v7MDXjHdg3ok>Sdo2ajP`0*hO9`3Yz-Lxu zs5lz&_eEM5&=#UriKuTCcB?UWTYK)-z5Dr#(GGc3)3~CQ<-59a zJnfl{G~y!pv{i2;(>|<*2WaTJYB4X}mla;3@Xb68otzXo%iOk&Hfmz(3j3Zut(buh zBPmV{!I|_?Ywn}Oz10&p+tD~*vrU-0$2(n9HUmP4D8U*-!i-%CY@-yxJhLeEW^3(s zEyLW4<5WYT^<#<&RNih;uU&FZ!`d*h%1RZb-EEW_YP1>$c<5A|qVUb$yb}uLz@<_! z7!pTDkh=b6M7m~cJ;Safz5TD2%ujt8cyeqgCsXawG^?>SDW?A3FH47y(Gv z0dR1W9@~q}3j+E=&hyMMm5N;M^tx`4OY#E0Ip|C&`@9w`IYhW3!%4GnlWHS%);c_|XNlzCc0ghd68<8aPnqI8F!fanHvhR)bSHDET>|qV6i4u(>@6CpQJbd)TG2%8kj5j za$+PBMrkbUNCW430XhB%{s8=ct8w-T&Qy7j_EA2WJRvqkoLJxL83H}IWK-nL> zQb8wL{jGDMlZrA{Ygl+ywF7H$4LeYQLX7p@j3VGsK&~no*C)eBu^e`{6rLQ1MH;s{ zV-um~(Q!Z-&dvSHURekaV=bT8iroLQl-`1TG8^pYYYS-vihzY$phd#8f0khfka}BB zx%g@VV2+3>^)Z*eyYMU63FDK#X8*KzU_gSInjvfQrFnb)Xr}oie}siF?`@mI{6owu zF*s{>lk{S!*?(8|Zl6%P~m5r6}4uKulq9T&-YPrj5$2 zZ1Dk-K@|aDI@wV%jS!)ft*>{-rpa$~`)qj3`iAmpertD^kP_-ecT(TAX1u(Dh!^%Q zn>4~ZX&-cAUBH|8Xz%{02|sTh7CK5?iyn@Zbs`Xx)tZI&1!N%+*JXO$IvmSDxO{+P7E$#a$Fxkx(KsA{BO#j6?qN1;TF1ZI zE^DD$Om|*;wl#|MYO~N1P{1m*?pU(vfX|kaK_mHoLAz!z=9YK$9Dyk;*fTM4E>A<5 z$^9NVmopiw^ha6=r5Vcv1$*iy6>Ah;-RWOL5a}kR}Rj^F|PD*eh zsW|Uz?GS5peN5L_J<=qW=`hda@+D7DZzHc^mx@_KqJsXj&^@s3nhZb`XOH&sjDN9$ z!b;3;JTx07UX0R`wuY=4fNL!f&OqCmsD*ktYIq8z1YAhw+ejmV2%&Z10bu8Fb5Y!+ z?iGVUp!-*1XTR$8=NAJ}z+9@ihj_-(EbpreUa%zwrUfYn2++7R)-p7e-xR*`V1DK* zTxRJs)`GP_aq$1H`I<$r2_dQ(QB_d7U|WhLNe79p-guiGQkl-83=cuhN5{290wdj>^`A}der)V{j2v$HV>4Qf_bwN%*Uob6vtetmJ~3h%}Y zC(+-FAe|j8gCq$oLE?@qGX61yKnUtmyM8P@VDHN*%kAQ|@ygf(XRpF0;}0?DHyZ9p zNAgP3bE;Wmv|Wv^U5Z{-9SwcT%|W*5rPV8%55jUs8<^9VS2K}jhus3i^Pa1AGDGun z;qYniPjTip5Co(>OBJIQHFtMkrr0hbjuK}r!T!bY-4p~DbwS8P_FZ9t4K$z>Bg4Wh zJm}4$Pvgx?UNAF13#NZSJp2{o7myqGtB#GZfKLp77EEni7a<|KDxjwnrH#p8_ZH?t zXPaY2$RBqRmoC+v{;fFhZUh;oWbMHTan)MbX_^awVv+u{)odfca2* zpI7;%xO&t7QSF#1TYNoy1Diq%zk1h>k>e;ZS}em-PTlwZO{<@9w>$#ec&`N*2Sn>x z-C56>uxi^z@XzgRPPn7X_QRe5?qaM8reHFi2%R_2g-kXw(L{U?;c^o>Lv41>|x`lb0Rb$|1l(UAP(lwJ3wdOv!X^IN5%XgCE&VV~bQ z75U9p&X^oybSq+WU16B=lfS(-?r%^3^_xauu>7y5pZlBaxu>7_YX?tkm;e1dyrx;i zQdl(da9^>e2Jy8Fh{hszR8o46>mZ7+;9)`bTTJ{UKjMCT9|a-<%4;wt7|z&1P|35T zB~z?w6=qn$;=(MjYJ+`hseS%7C&15=># zW-MzpdCtsrz1g`)d7_4% zzb)A?R9AOaSpP20FWVyGMl{d;~_rXsmKsBjTcNH7b|572%EVWN99gZ8Ws9 z5z8w^Cl!!VPL$$eL{Q}qE2KBz16%S!69?u&wsd*g+*68;-Hh!<_{x`@z~xUFXhE?l zWV?1k-o*xee<#r8{fCphhCfV@QJLgFuS*a+myX?ic})NQ(RzKkdp8RLWed~b`qF`0R(&m zjl#?cXWjn`hyJw6d<+biu04F{gTB4Yimk=$evGmH$pyWa8I1@gO$s2K<1V>E}Zjy$5)s;d} z!Ts^fQj(X3uGqGNkCs@CNx*0rp1`9ns|8k)sgICokO7gz?tUqM-M9pW_^Bb3L1Id1 z>pQocmd};KaJ$NtMp>6qB{ONo30cplMobP~McTZiis4pP$lw7T`PB)5l?O}W&+*Ad zbPm?lcAi-TCo8sRnE{nXQH4%E@6H8D8PTv3V-U=R0MLRB_;2>D=|om0X(|f-O+$)_ z*IFzp6UZqPM`yhh3UQUtf|@>RN}+m48vn5ERbRk?Fmr;SDHa{-*0@c#CQghGRAxF) zc(QV%OH+<7pfneS^9Y>;>0^O0nOY~G z$lPMJ6U?xZUvotli^#`KB^SL)p1pL*2&X%Pq{d27wz+*3%{$Ei)?p2<*^nvr8WJ^` z2-(ccGW;L+ctIe`Dk7AE0a525-j>aDI5e;UyizhvgesvJeqrL=^H72;7hyydWGriZ z`WQL{FmFON!-~HWlBh8cu~JI^YJt+PC8>vt72}O${)f;Smq|HGwb~G>QbBHswpdD3 zl1SB#Sh6Y#dhJnkI*^j4BZB&(Mtyh(Io8NdF&#}ZN#L9vo}Wm`Xfeh@+>r{gr3N}e z?v#i4pV-mX?RHJvw1O?t)pu=CPXFUPOWTpmvt7`p)Whx!(4%%Rc5MySshMy0YZ{nt z9c0Bd-C5`_cTA4mpgL>8PIGG_pHcpM98a}HLK(Apr##SlA!@`WymHAqi-?=T>-JtZhk3aMA?dF(geu`nPgfI~K-fsRKMUoUNRi?y# z3!FCEpOTF+)+*zSS8kET7Mft9NsQjRY;vZ;HP^#}y{edf%$&~qwE6z6$-_nz;vg>K zAwCiyVMGzfERvW<8jD!QDzaEd9-Am)EB|vw75g~EF=`D4{qJKmq2m;7oTH0NT;m3h zdpzP9FCqdq6iy%cfPtI^#wAguAY%4eMLnG`oxL2 zdbLe#vFD0+Yi93ubR9ZC?03|Oy^gL>M>IMDb>{D=Gyen~!R+vE&j7j(ATXdKuqyxn z&=m%B3;=z_yo+-lnTxu&~15n0 zZ&2;RNMC {children} diff --git a/packages/core/__tests__/unit/index.test.cjs b/packages/core/__tests__/unit/index.test.cjs index c1f2c80..373be14 100644 --- a/packages/core/__tests__/unit/index.test.cjs +++ b/packages/core/__tests__/unit/index.test.cjs @@ -1,4 +1,5 @@ const postcss = require("postcss"); +const tailwindcss = require("@tailwindcss/postcss"); const { test } = require("node:test"); const assert = require("node:assert"); const fs = require("fs"); @@ -46,7 +47,7 @@ async function runTest(files, callback, cache = true) { } // Run PostCSS - const result = await postcss([plugin()]).process("", { from: undefined }); + const result = await postcss([plugin()]).process("@tailwind utilities;", { from: undefined }); // Run assertions await callback(result); @@ -96,6 +97,70 @@ test("generates body attributes file correctly", async () => { ); }); +test("leaves non-Tailwind CSS unchanged, including generated local-font modules", async () => { + await runTest( + { + "app/test.jsx": `import { useUI } from '@react-zero-ui/core'; + function Component() { + const [theme, setTheme] = useUI('theme', 'light'); + return
; + }`, + }, + async () => { + const stylesheets = [ + ["empty.css", ""], + ["plain.css", '/* @import "tailwindcss"; */ @media (width > 600px) { .label { color: red; } }'], + ["plain.module.css", ".label { color: red; }"], + [ + "testfont_123.module.css", + '@font-face { font-family: "testFont"; src: url("./test.woff2") format("woff2"); font-display: swap; }\n.variable { --font-test: "testFont"; }', + ], + ]; + // A plain stylesheet still triggers attribute generation, even when it runs first. + fs.unlinkSync(getAttrFile()); + for (const [filename, css] of stylesheets) { + const result = await postcss([plugin(), tailwindcss({ optimize: false })]).process(css, { from: path.resolve(filename) }); + assert.strictEqual(result.css, css, `${filename} must not receive Tailwind-only directives`); + assert(result.messages.some((message) => message.type === "dependency" && message.file.endsWith("app/test.jsx"))); + assert(fs.readFileSync(getAttrFile(), "utf8").includes('"data-theme": "light"')); + } + } + ); +}); + +test("compiles Zero UI variants in Tailwind entrypoints and CSS modules", async () => { + await runTest( + { + "app/test.jsx": `import { useUI, useScopedUI } from '@react-zero-ui/core'; + function Component() { + const [theme, setTheme] = useUI('theme', 'light'); + setTheme('dark'); + const [panel, setPanel] = useScopedUI('panel', 'closed'); + setPanel('open'); + return
; + }`, + "base.css": "@tailwind utilities source(none);", + }, + async () => { + const stylesheets = [ + ["globals.css", '@import "./base.css"; @source inline("theme-dark:hidden panel-open:block");'], + ["utilities.css", '@tailwind utilities source(none); @source inline("theme-dark:hidden panel-open:block");'], + ["reference.module.css", '@reference "./base.css"; .label { @apply theme-dark:hidden panel-open:block; }'], + ["apply.module.css", ".label { @apply theme-dark:hidden panel-open:block; }"], + ["variant.module.css", ".label { @variant theme-dark { display: none; } @variant panel-open { display: block; } }"], + ]; + for (const [filename, css] of stylesheets) { + const result = await postcss([plugin(), tailwindcss({ optimize: false })]).process(css, { from: path.resolve(filename) }); + assert.match(result.css, /body\[data-theme=['"]dark['"]\]/, `${filename} must compile the global variant`); + assert.match(result.css, /\[data-panel=['"]open['"]\]/, `${filename} must compile the scoped variant`); + assert.match(result.css, /display: none/); + assert.match(result.css, /display: block/); + assert.doesNotMatch(result.css, /@(?:custom-variant|slot|apply|variant)\b/, `${filename} must not leak Tailwind directives`); + } + } + ); +}); + test("warns instead of auto-initializing when project setup is missing", async () => { await runTest( { @@ -240,7 +305,7 @@ test("watches for file changes", async () => { await new Promise((resolve) => setTimeout(resolve, 500)); // Re-process to check if watcher picked up changes - const result2 = await postcss([plugin()]).process("", { from: undefined }); + const result2 = await postcss([plugin()]).process("@tailwind utilities;", { from: undefined }); assert(result2.css.includes("@custom-variant watch-test-updated"), "Should detect new state"); } @@ -344,7 +409,7 @@ test("handles concurrent file modifications", async () => { } // Final processing should work correctly - const finalResult = await postcss([plugin()]).process("", { from: undefined }); + const finalResult = await postcss([plugin()]).process("@tailwind utilities;", { from: undefined }); assert(finalResult.css.includes("AUTO-GENERATED"), "Should handle rapid changes"); } diff --git a/packages/core/src/postcss/index.cts b/packages/core/src/postcss/index.cts index 608991e..c52d86b 100644 --- a/packages/core/src/postcss/index.cts +++ b/packages/core/src/postcss/index.cts @@ -2,7 +2,10 @@ /** * @type {import('postcss').PluginCreator} */ -type Root = { prepend: (css: string) => void }; +type Root = { + prepend: (css: string) => void; + walkAtRules: (name: RegExp, callback: () => false | void) => void; +}; type Result = { messages: { type: string; plugin: string; file: string; parent: string }[]; opts: { from: string }; @@ -50,6 +53,18 @@ function warnIfNotInitialized(result: Result, isZeroUiInitialized: RuntimeModule result.warn("[Zero-UI] Zero UI is not initialized. Run `react-zero-ui` to patch your project config.", { plugin: zeroUIPlugin }); } +function usesTailwind(root: Root): boolean { + // Match @tailwindcss/postcss's early-bail directives. @custom-variant alone + // does not trigger compilation, so injecting it into plain CSS (including + // next/font's generated modules) leaks @custom-variant and @slot to the bundler. + let found = false; + root.walkAtRules(/^(import|reference|theme|variant|config|plugin|apply|tailwind)$/, () => { + found = true; + return false; + }); + return found; +} + const plugin = () => { return { postcssPlugin: zeroUIPlugin, @@ -58,8 +73,10 @@ const plugin = () => { const { buildCss, generateAttributesFile, isZeroUiInitialized, processVariants, formatError, registerDeps } = await loadRuntimeModules(); const { finalVariants, initialGlobalValues, sourceFiles } = await processVariants(); - const cssBlock = buildCss(finalVariants); - if (cssBlock?.trim()) root.prepend(cssBlock + "\n"); + if (usesTailwind(root)) { + const cssBlock = buildCss(finalVariants); + if (cssBlock?.trim()) root.prepend(cssBlock + "\n"); + } /* ── register file-dependencies for HMR ─────────────────── */ registerDeps(result, zeroUIPlugin, sourceFiles, result.opts.from ?? ""); diff --git a/wiki/.wiki-system/audit-state.json b/wiki/.wiki-system/audit-state.json index b92f33e..1291c08 100644 --- a/wiki/.wiki-system/audit-state.json +++ b/wiki/.wiki-system/audit-state.json @@ -17,7 +17,7 @@ "fingerprint": "sha256:11358f09ada6750e64039028d9e7aed6581256fa3a6811b29608d5c830ade664" }, "pages/core/variant-extractor.md": { - "fingerprint": "sha256:aad71c1479c002a6d7cb328112a479968b4784290b4e2e8142a3faf3bd9617ca" + "fingerprint": "sha256:5e71ec27b44b04f7de27da7b5924310525f8536cd52f472c3d2cdade03be6a6a" }, "pages/docs-website.md": { "fingerprint": "sha256:427d27f3996c4418070af852ac243ba4921aa36eecead0308abdb126534367b4" diff --git a/wiki/decision-log.md b/wiki/decision-log.md index e6d9c77..dd4cd4c 100644 --- a/wiki/decision-log.md +++ b/wiki/decision-log.md @@ -19,3 +19,7 @@ Consumers reported `fast-glob` → `micromatch` → `braces` through core. At re ## 2026-10-19 — Keep Node 22 support when choosing the glob implementation After comparing native glob with both scans, the user chose to retain `tinyglobby` and fix its handling of symlinked source roots. Native glob required exclusion workarounds in the probes, and its directory-symlink support needed by Next layout discovery is available from Node 24.16 / 26.1, not Node 22. Preserving Node 22 with native glob would require extra traversal logic. Separate source-pattern scans restore the old root-symlink behavior without changing the Node requirement or following nested symlinks. [Native API history](https://nodejs.org/docs/latest-v24.x/api/fs.html#fsglobsyncpattern-options); [scan contract](pages/core/variant-extractor.md). + +## 2026-10-24 — Inspect stylesheet directives before injecting variants + +Reproduced Next.js local-font parsing warnings with a packed core fixture. Zero UI injected Tailwind-only rules into generated font CSS, which [Tailwind deliberately skips](https://github.com/tailwindlabs/tailwindcss/blob/v4.2.2/packages/%40tailwindcss-postcss/src/index.ts#L86-L107). Gate injection by stylesheet directives rather than excluding `.module.css`: user modules may legitimately consume Zero UI variants. The regression checks both font loading and served CSS; successful rendering alone missed the warning. [Integration contract and tests](pages/core/variant-extractor.md). diff --git a/wiki/pages/core/variant-extractor.md b/wiki/pages/core/variant-extractor.md index 23efe13..9057ed4 100644 --- a/wiki/pages/core/variant-extractor.md +++ b/wiki/pages/core/variant-extractor.md @@ -9,6 +9,9 @@ paths: - packages/core/src/postcss/index.cts - packages/core/src/postcss/vite.ts - packages/core/src/postcss/utilities.ts + - packages/core/__tests__/unit/index.test.cjs + - packages/core/__tests__/e2e/next-ssr.spec.js + - packages/core/__tests__/fixtures/next/app/layout.tsx --- # Variant Extractor @@ -29,6 +32,8 @@ Source and Next layout discovery use `tinyglobby`. Source discovery scans each p [index.cts](../../../packages/core/src/postcss/index.cts) is the CommonJS PostCSS entry; it lazily imports ESM helpers. Run Zero-UI before Tailwind so custom variants exist when Tailwind processes utilities. It registers source dependencies for watch mode, warns once per working directory when initialization is missing, and still generates attributes. Application config changes belong to [explicit setup](setup-cli.md). +Variant injection requires a directive recognized by Tailwind's PostCSS early-bail check: `@import`, `@reference`, `@theme`, `@variant`, `@config`, `@plugin`, `@apply`, or `@tailwind`. Plain stylesheets, including `next/font/local` generated CSS modules, stay unchanged; attribute generation and dependency registration still run. `@custom-variant` alone does not trigger Tailwind compilation, so unconditional injection leaks it and `@slot` into Next's CSS parser. Preserve CSS modules using Tailwind directives; filename exclusion would block legitimate variants. [PostCSS integration tests](../../../packages/core/__tests__/unit/index.test.cjs) cover both paths; [Next fixture tests](../../../packages/core/__tests__/e2e/next-ssr.spec.js) check local-font loading and served CSS. + Development extraction failures become warnings and leave the server alive; production failures throw. A running dev server alone does not establish that variants compiled successfully. [vite.ts](../../../packages/core/src/postcss/vite.ts) adds Zero-UI/Tailwind to PostCSS and reads generated attributes during HTML transformation; missing startup output can therefore fail before later CSS generation helps. ## Cache debugging From 5f20dfc516e0cb619f3dd016eb0aa68283a4fe6a Mon Sep 17 00:00:00 2001 From: Austin1serb Date: Sat, 24 Oct 2026 15:51:48 -0600 Subject: [PATCH 2/4] docs(core): document hook behavior and scoped roots --- packages/core/src/index.ts | 54 +++++++++++++++++++++++++++++- packages/core/src/internal.ts | 7 ++++ wiki/.wiki-system/audit-state.json | 2 +- 3 files changed, 61 insertions(+), 2 deletions(-) diff --git a/packages/core/src/index.ts b/packages/core/src/index.ts index ddb04f6..cb08d85 100644 --- a/packages/core/src/index.ts +++ b/packages/core/src/index.ts @@ -2,22 +2,74 @@ import { useRef } from "react"; import { cssVar, makeSetter } from "./internal.js"; +/** A value or an updater receiving the current DOM value, falling back to the hook's initial value. */ type UIAction = T | ((prev: T) => T); type ScopedRef = ((node: HTMLElement | null) => void) & { current: HTMLElement | null }; +/** Updates the element attached through `ref` without triggering React re-renders. */ interface ScopedSetterFn { - (action: UIAction): void; // ← SINGLE source of truth + /** Writes a value or applies an updater to the current DOM value. The ref must be attached first. */ + (action: UIAction): void; + /** + * Attach to exactly one scope root. The setter updates this element's `data-*` attribute + * (or CSS variable); render the initial value on the same element. + */ ref?: ScopedRef; cssVar?: typeof cssVar; } +/** Updates `` without triggering React re-renders; updater functions read the current DOM value. */ type GlobalSetterFn = (action: UIAction) => void; +/** + * Returns the supplied initial value and a setter that writes `data-{key}` on ``. + * Updates do not trigger React re-renders; the first value does not track DOM changes. + * Zero UI's PostCSS plugin generates the `key-value:` Tailwind variants used in your source, + * so elements anywhere under `` can respond through CSS. Render alternate states up front. + * + * @param key - Stable kebab-case key, resolvable at build time. + * @param initial - Static default for generated `bodyAttributes`; use the same default everywhere this key is declared. + * @param flag - Pass {@link cssVar} to write `--{key}` instead of a data attribute. + * @returns `[initial, setter]`. The setter accepts a value or an updater reading the current DOM value. + * @example + * ```tsx + * const [, setScrolled] = useUI<"true" | "false">("scrolled", "false"); + * return ( + * + * ); + * ``` + * @see https://zero-ui.dev/docs/api-reference#useuitkey-initial-flag + */ function useUI(key: string, initial: T, flag?: typeof cssVar): [T, GlobalSetterFn] { return [initial, useRef(makeSetter(key, initial, () => document.body, flag)).current as GlobalSetterFn]; } +/** + * Returns the supplied initial value and a setter that writes `data-{key}` on one element. + * Updates do not trigger React re-renders; the first value does not track DOM changes. + * Attach `setter.ref` to the scope root: the setter updates this element's attribute. + * Render the initial `data-{key}` on the same element. Zero UI's PostCSS plugin generates + * `key-value:` Tailwind variants used in your source for this element and its descendants. + * + * @param key - Stable kebab-case key, resolvable at build time. Each hook instance has its own target. + * @param initialValue - Static default; use the same default everywhere this key is declared. + * @param flag - Pass {@link cssVar} to write `--{key}` instead of a data attribute. + * @returns `[initialValue, setter]`. The setter accepts a value or an updater reading the current DOM value. + * @example + * ```tsx + * const [initial, setPanel] = useScopedUI<"open" | "closed">("panel", "closed"); + * return ( + *
+ * + *
Details
+ *
+ * ); + * ``` + * @see https://zero-ui.dev/docs/api-reference#usescopeduitkey-initial-flag + */ function useScopedUI(key: string, initialValue: T, flag?: typeof cssVar): [T, ScopedSetterFn] { // Create a ref to hold the DOM element that will receive the data-* attributes // This allows scoping UI state to specific elements instead of always using document.body diff --git a/packages/core/src/internal.ts b/packages/core/src/internal.ts index 3a53ce7..97e2f73 100644 --- a/packages/core/src/internal.ts +++ b/packages/core/src/internal.ts @@ -1,6 +1,13 @@ // src/internal.ts import type { UIAction } from "./index.js"; +/** + * Pass as the third argument to `useUI` or `useScopedUI` to update an inline CSS variable + * `--{key}` on the target element instead of a `data-*` attribute, without React re-renders. + * Supply the initial CSS value in styles or a `var()` fallback; the hook does not initialize it. + * + * @see https://zero-ui.dev/docs/api-reference#cssvar + */ export const cssVar: unique symbol = Symbol("cssVar"); export function makeSetter(key: string, initialValue: T, getTarget: () => HTMLElement, flag?: typeof cssVar) { diff --git a/wiki/.wiki-system/audit-state.json b/wiki/.wiki-system/audit-state.json index 1291c08..dd37474 100644 --- a/wiki/.wiki-system/audit-state.json +++ b/wiki/.wiki-system/audit-state.json @@ -11,7 +11,7 @@ "fingerprint": "sha256:2fdfe64ad0dd18658ffc2efbeb9e138ff7982b60f7d232b7c844ad91aa50432b" }, "pages/core/runtime-hooks.md": { - "fingerprint": "sha256:85f8659cfb30965e31dee7e826f125e3731d735df4f68b01d6707c9dd50a17c3" + "fingerprint": "sha256:a6c9eb745ba0359265a9fc332763fb561e695cd0724850e485f5bbf14107d31c" }, "pages/core/setup-cli.md": { "fingerprint": "sha256:11358f09ada6750e64039028d9e7aed6581256fa3a6811b29608d5c830ade664" From 4c328cf4d7ed745cc77cb90dac7d039e25ce2c6a Mon Sep 17 00:00:00 2001 From: Austin1serb Date: Sat, 24 Oct 2026 16:00:51 -0600 Subject: [PATCH 3/4] test(core): load only the bundled local font --- packages/core/__tests__/e2e/next-ssr.spec.js | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/packages/core/__tests__/e2e/next-ssr.spec.js b/packages/core/__tests__/e2e/next-ssr.spec.js index 20b05ac..39c4030 100644 --- a/packages/core/__tests__/e2e/next-ssr.spec.js +++ b/packages/core/__tests__/e2e/next-ssr.spec.js @@ -16,7 +16,8 @@ test("local fonts load without leaking Tailwind directives into their CSS", asyn } expect(fontCss).toContain("@font-face"); const loadedFontCount = await page.evaluate(async () => { - const family = window.getComputedStyle(document.body).getPropertyValue("--font-test"); + // Load the bundled font only; Next's Arial fallback may be absent on CI hosts. + const family = window.getComputedStyle(document.body).getPropertyValue("--font-test").split(",")[0].trim(); return (await document.fonts.load(`16px ${family}`)).length; }); expect(loadedFontCount).toBeGreaterThan(0); From 681524acc4642ace0a68fef8f309a2b0f5a04102 Mon Sep 17 00:00:00 2001 From: Austin1serb Date: Sat, 24 Oct 2026 16:00:51 -0600 Subject: [PATCH 4/4] chore(core): bump patch version to 0.4.5 --- packages/core/package.json | 2 +- wiki/.wiki-system/audit-state.json | 10 +++++----- 2 files changed, 6 insertions(+), 6 deletions(-) diff --git a/packages/core/package.json b/packages/core/package.json index 5921981..682bbeb 100644 --- a/packages/core/package.json +++ b/packages/core/package.json @@ -1,6 +1,6 @@ { "name": "@react-zero-ui/core", - "version": "0.4.4", + "version": "0.4.5", "private": false, "scripts": { "build": "rm -rf dist && tsc -p tsconfig.build.json", diff --git a/wiki/.wiki-system/audit-state.json b/wiki/.wiki-system/audit-state.json index dd37474..53fa433 100644 --- a/wiki/.wiki-system/audit-state.json +++ b/wiki/.wiki-system/audit-state.json @@ -2,13 +2,13 @@ "version": 1, "pages": { "pages/architecture.md": { - "fingerprint": "sha256:27863bef93f7a6f73ea0834509d1bad9c425eeb3061c297d90a4212191ebebd4" + "fingerprint": "sha256:2f8a7e4305dcd6470b84d51ef75c6023ad9ba1646ac8caace622af19be417a9b" }, "pages/build-test-ci.md": { - "fingerprint": "sha256:e0e832aa0eb7d6964298d7d37b6e0eca3ae700f12b4af9b7e437dc1943d1439e" + "fingerprint": "sha256:4c423b6bb65ee130ac98a4e427f5fc867b9297f18d26bbdaa3ceda0fa6f857b7" }, "pages/core/experimental-runtime.md": { - "fingerprint": "sha256:2fdfe64ad0dd18658ffc2efbeb9e138ff7982b60f7d232b7c844ad91aa50432b" + "fingerprint": "sha256:67d04de39de73d77d8aea0537b0ce85d4513773e60231a6d109e9fa038844bc2" }, "pages/core/runtime-hooks.md": { "fingerprint": "sha256:a6c9eb745ba0359265a9fc332763fb561e695cd0724850e485f5bbf14107d31c" @@ -17,7 +17,7 @@ "fingerprint": "sha256:11358f09ada6750e64039028d9e7aed6581256fa3a6811b29608d5c830ade664" }, "pages/core/variant-extractor.md": { - "fingerprint": "sha256:5e71ec27b44b04f7de27da7b5924310525f8536cd52f472c3d2cdade03be6a6a" + "fingerprint": "sha256:e0df7d05d724f8a21ef46437f8dadb72f7b318d46dbdb76c3226d83dda773793" }, "pages/docs-website.md": { "fingerprint": "sha256:427d27f3996c4418070af852ac243ba4921aa36eecead0308abdb126534367b4" @@ -26,7 +26,7 @@ "fingerprint": "sha256:a8f10d30b35e3acf4a26670a61305bb535a15a72e6620b8b7b185dbd8e6f2d02" }, "pages/packages-publishing.md": { - "fingerprint": "sha256:cf1c2f75e2f1b41af4afef00b538e5390123fe26fe063f0ee90a832a58e3d09d" + "fingerprint": "sha256:42f7d54532dbca9bc416e064283f7f64a13df91b92e561af28ba98e72f825929" } } }