@stacksjs/stx 0.2.336 → 0.2.338

package/dist/ssg.js

@@ -1,5 +1,5 @@
 // @bun
-import{Gk as Uq,Hk as Iq,Lk as Fq}from"./chunk-e1sxe3q4.js";import{Mk as Eq,Nk as Tq,Ok as Dq}from"./chunk-4jdj52c5.js";import{hl as _q,kl as zq,ll as Aq}from"./chunk-zz8qgqa1.js";import"./chunk-p1hy2bwn.js";import{Dr as n,Xm as Oq,eq as P,tp as Bq,vo as l,yo as Hq}from"./chunk-kxtqbrfr.js";import"./chunk-caaenc3w.js";import"./chunk-amxtypkp.js";import"./chunk-nat3actx.js";import"./chunk-q0g5c39d.js";import{fu as Xq}from"./chunk-kffndzch.js";import"./chunk-c2ta859c.js";import"./chunk-r8rbf28v.js";import{Cu as d}from"./chunk-gptwwv3c.js";import"./chunk-n66k2v2q.js";import"./chunk-vvd659y4.js";import"./chunk-7r80apc5.js";import"./chunk-2tjk867y.js";import"./chunk-t8ctvjqe.js";import"./chunk-deqnt1w5.js";import{$v as jq,Zv as Yq,_v as Vq,aw as Gq,bw as Lq,cw as Nq}from"./chunk-hzfd8cz0.js";import"./chunk-q569zmrr.js";import{sw as y}from"./chunk-hyfjnn7g.js";import O from"fs";import j from"path";import{createHash as xq}from"crypto";function yq(q){try{return new Bun.Transpiler({loader:"js",minifyWhitespace:!0}).transformSync(q).replace(/\}(var |let |const |function )/g,"};$1").trim()}catch{return q}}var Pq=/<script\s+type="stx\/island"\s+data-stx-island="([^"]+)"([^>]*)>([\s\S]*?)<\/script>/g;function Cq(q){return Bun.hash(q).toString(16)}function Qq(q,Z={}){if(!q.includes('type="stx/island"'))return{html:q,chunks:[]};let $=new Map,Q=q.replace(Pq,(J,W,z,A)=>{let G=A.trim();if(!G)return J;if(/\bdata-stx-src=/.test(z))return J;if(Z.minify)G=yq(G);let X=Cq(G);if(!$.has(X))$.set(X,G);let B=Z.integrity?` data-stx-integrity="sha384-${xq("sha384").update(G).digest("base64")}"`:"";return`<script type="stx/island" data-stx-island="${W}" data-stx-src="/_stx/islands/${X}.js"${B}${z}></script>`}),K=Array.from($,([J,W])=>({hash:J,code:W}));return{html:Q,chunks:K}}var gq=new Set(["visible","idle"]);function Zq(q){if(!q.includes("data-stx-src="))return q;let Z=new Map,$=/data-stx-scope="([^"]+)"[^>]*?stx-hydrate="([^"]+)"/g,Q;while((Q=$.exec(q))!==null)Z.set(Q[1],Q[2]);let K=new Set,J=/data-stx-island="([^"]+)"[^>]*?data-stx-src="([^"]+)"/g,W;while((W=J.exec(q))!==null)if(gq.has(Z.get(W[1])||""))K.add(W[2]);let z=q.lastIndexOf("</head>");if(K.size===0||z===-1)return q;let A=Array.from(K).filter((G)=>!q.includes(`rel="prefetch" href="${G}"`)).map((G)=>`<link rel="prefetch" href="${G}" as="script">`).join("");if(!A)return q;return q.slice(0,z)+A+q.slice(z)}var fq=["STX_SITE_URL","SITE_URL","URL","VERCEL_URL","CF_PAGES_URL"];function h(q){let Z=q.trim();if(!Z)return null;let $=/^https?:\/\//i.test(Z)?Z:`https://${Z}`;try{return new URL($).origin+new URL($).pathname.replace(/\/$/,"")}catch{return null}}function mq(q){for(let Z of fq){let $=q[Z];if(!$)continue;let Q=h($);if(Q)return{url:Q,source:"env",via:Z}}return null}function $q(q){if(!q||typeof q!=="object")return null;let Z=q,$=Z.site?.url??Z.url??Z.app?.url;return typeof $==="string"?h($):null}async function dq(q){let{existsSync:Z}=await import("fs"),$=await import("path");for(let Q of["site.config.ts","site.config.js",".config/site.config.ts"]){let K=$.resolve(q,Q);if(!Z(K))continue;try{let J=await import(K),W=$q(J.default??J);if(W)return W}catch{}}return null}async function Kq(q={}){let Z=q.cwd??process.cwd(),$=q.env??process.env;if(q.explicit){let W=h(q.explicit);if(W)return{url:W,source:"option"}}let Q=$q(q.stxConfig);if(Q)return{url:Q,source:"stx.config",via:"site.url"};let K=await dq(Z);if(K)return{url:K,source:"site.config",via:"url"};let J=mq($);if(J)return J;return{url:"http://localhost",source:"fallback"}}function Wq(){return["No site URL configured \u2014 sitemap.xml and robots.txt will point at http://localhost.","  Set one in stx.config.ts (site: { url: 'https://example.com' }), in site.config.ts,","  via --domain, or with SITE_URL in the build environment."].join(`
+import{Ak as Fq,vk as Uq,wk as Iq}from"./chunk-4904n5v0.js";import{Bk as Eq,Ck as Tq,Dk as Dq}from"./chunk-f6sejeg3.js";import{$k as zq,Yk as _q,al as Aq}from"./chunk-ypzm47q3.js";import"./chunk-1yj4xd6n.js";import{Jp as P,Om as Oq,io as l,lo as Hq,rr as n}from"./chunk-e3rgky2r.js";import"./chunk-d7zxg9bp.js";import"./chunk-t00ga194.js";import"./chunk-hrdd26r4.js";import"./chunk-7r79j1hs.js";import"./chunk-ay336sqb.js";import{ht as Xq}from"./chunk-nhbc464j.js";import{mt as d}from"./chunk-vaggjvsm.js";import"./chunk-q9ckfwhh.js";import"./chunk-kermxyfe.js";import"./chunk-k3dtvay1.js";import{Tt as Bq}from"./chunk-aved735s.js";import"./chunk-799s9mwc.js";import"./chunk-7r80apc5.js";import"./chunk-2tjk867y.js";import"./chunk-t8ctvjqe.js";import"./chunk-deqnt1w5.js";import{$v as jq,Zv as Yq,_v as Vq,aw as Gq,bw as Lq,cw as Nq}from"./chunk-w0hzaka3.js";import"./chunk-wb90259a.js";import{tw as y}from"./chunk-5g6rprcy.js";import O from"fs";import j from"path";import{createHash as xq}from"crypto";function yq(q){try{return new Bun.Transpiler({loader:"js",minifyWhitespace:!0}).transformSync(q).replace(/\}(var |let |const |function )/g,"};$1").trim()}catch{return q}}var Pq=/<script\s+type="stx\/island"\s+data-stx-island="([^"]+)"([^>]*)>([\s\S]*?)<\/script>/g;function Cq(q){return Bun.hash(q).toString(16)}function Qq(q,Z={}){if(!q.includes('type="stx/island"'))return{html:q,chunks:[]};let $=new Map,Q=q.replace(Pq,(J,W,z,A)=>{let G=A.trim();if(!G)return J;if(/\bdata-stx-src=/.test(z))return J;if(Z.minify)G=yq(G);let X=Cq(G);if(!$.has(X))$.set(X,G);let B=Z.integrity?` data-stx-integrity="sha384-${xq("sha384").update(G).digest("base64")}"`:"";return`<script type="stx/island" data-stx-island="${W}" data-stx-src="/_stx/islands/${X}.js"${B}${z}></script>`}),K=Array.from($,([J,W])=>({hash:J,code:W}));return{html:Q,chunks:K}}var gq=new Set(["visible","idle"]);function Zq(q){if(!q.includes("data-stx-src="))return q;let Z=new Map,$=/data-stx-scope="([^"]+)"[^>]*?stx-hydrate="([^"]+)"/g,Q;while((Q=$.exec(q))!==null)Z.set(Q[1],Q[2]);let K=new Set,J=/data-stx-island="([^"]+)"[^>]*?data-stx-src="([^"]+)"/g,W;while((W=J.exec(q))!==null)if(gq.has(Z.get(W[1])||""))K.add(W[2]);let z=q.lastIndexOf("</head>");if(K.size===0||z===-1)return q;let A=Array.from(K).filter((G)=>!q.includes(`rel="prefetch" href="${G}"`)).map((G)=>`<link rel="prefetch" href="${G}" as="script">`).join("");if(!A)return q;return q.slice(0,z)+A+q.slice(z)}var fq=["STX_SITE_URL","SITE_URL","URL","VERCEL_URL","CF_PAGES_URL"];function h(q){let Z=q.trim();if(!Z)return null;let $=/^https?:\/\//i.test(Z)?Z:`https://${Z}`;try{return new URL($).origin+new URL($).pathname.replace(/\/$/,"")}catch{return null}}function mq(q){for(let Z of fq){let $=q[Z];if(!$)continue;let Q=h($);if(Q)return{url:Q,source:"env",via:Z}}return null}function $q(q){if(!q||typeof q!=="object")return null;let Z=q,$=Z.site?.url??Z.url??Z.app?.url;return typeof $==="string"?h($):null}async function dq(q){let{existsSync:Z}=await import("fs"),$=await import("path");for(let Q of["site.config.ts","site.config.js",".config/site.config.ts"]){let K=$.resolve(q,Q);if(!Z(K))continue;try{let J=await import(K),W=$q(J.default??J);if(W)return W}catch{}}return null}async function Kq(q={}){let Z=q.cwd??process.cwd(),$=q.env??process.env;if(q.explicit){let W=h(q.explicit);if(W)return{url:W,source:"option"}}let Q=$q(q.stxConfig);if(Q)return{url:Q,source:"stx.config",via:"site.url"};let K=await dq(Z);if(K)return{url:K,source:"site.config",via:"url"};let J=mq($);if(J)return J;return{url:"http://localhost",source:"fallback"}}function Wq(){return["No site URL configured \u2014 sitemap.xml and robots.txt will point at http://localhost.","  Set one in stx.config.ts (site: { url: 'https://example.com' }), in site.config.ts,","  via --domain, or with SITE_URL in the build environment."].join(`
 `)}class wq{cacheDir;cache=new Map;loaded=!1;salt;constructor(q,Z=""){this.cacheDir=q,this.salt=Z}async load(){if(this.loaded)return;let q=j.join(this.cacheDir,"build-cache.json");if(await Bun.file(q).exists())try{let Z=JSON.parse(await Bun.file(q).text());for(let[$,Q]of Object.entries(Z))this.cache.set($,Q)}catch{}this.loaded=!0}async save(){await O.promises.mkdir(this.cacheDir,{recursive:!0});let q=j.join(this.cacheDir,"build-cache.json"),Z={};for(let[$,Q]of this.cache)Z[$]=Q;await Bun.write(q,JSON.stringify(Z))}getHash(q,Z){let $=O.statSync(q),Q=`${this.salt}|${q}:${$.mtimeMs}`;for(let J of Z)if(O.existsSync(J)){let W=O.statSync(J);Q+=`:${J}:${W.mtimeMs}`}let K=0;for(let J=0;J<Q.length;J++){let W=Q.charCodeAt(J);K=(K<<5)-K+W,K=K&K}return Math.abs(K).toString(36)}get(q,Z){let $=this.cache.get(q);if(!$)return null;let Q=this.getHash(Z,$.dependencies??[]);if($.hash!==Q)return this.cache.delete(q),null;return $.html}set(q,Z,$,Q){let K=this.getHash(Z,$);this.cache.set(q,{hash:K,html:Q,generatedAt:Date.now(),dependencies:$})}}class Rq{cacheDir;constructor(q){this.cacheDir=q}getFilePath(q){let Z=q.replace(/[^a-zA-Z0-9]/g,"_")+".json";return j.join(this.cacheDir,"isr",Z)}async get(q){let Z=this.getFilePath(q);if(!await Bun.file(Z).exists())return null;try{return JSON.parse(await Bun.file(Z).text())}catch{return null}}async set(q,Z){let $=this.getFilePath(q);await O.promises.mkdir(j.dirname($),{recursive:!0}),await Bun.write($,JSON.stringify(Z))}async invalidate(q){let Z=this.getFilePath(q);if(await Bun.file(Z).exists())await O.promises.unlink(Z)}async invalidatePattern(q){let Z=j.join(this.cacheDir,"isr");if(!O.existsSync(Z))return;let $=await O.promises.readdir(Z);for(let Q of $){let K=Q.replace(/_/g,"/").replace(".json","");if(q.test(K))await O.promises.unlink(j.join(Z,Q))}}async needsRevalidation(q){let Z=await this.get(q);if(!Z)return!0;return Date.now()>Z.revalidateAfter}}async function pq(q){try{let $=(await Bun.file(q).text()).match(/<script\s+server\b[^>]*>([\s\S]*?)<\/script>/i);if(!$)return null;let Q=$[1];if(!Q.includes("getStaticPaths"))return null;let K=Q.match(/(?:export\s+)?(?:async\s+)?function\s+getStaticPaths\s*\([^)]*\)\s*\{([\s\S]*?)\n[\t ]*\}/);if(!K)return null;return await Function(`
       return (async function getStaticPaths() {
         ${K[1]}
@@ -41,7 +41,7 @@ ${q.map((Q)=>{let K=new URL(Q.loc,Z).href,J=`  <url>
 ${$.join(`
 `)}
   </channel>
-</rss>`}async function aq(q={}){let Z=Date.now();Aq();let $=await n(process.cwd()),Q=$.build||{},K=await Kq({explicit:q.domain||Q.domain,stxConfig:$});if(K.source==="fallback"&&(q.sitemap??Q.sitemap??!0))console.warn(Wq());let J={router:q.router??$?.router??{},pagesDir:q.pagesDir||Q.pagesDir||"pages",outputDir:q.outputDir||Q.outputDir||"dist",baseUrl:q.baseUrl||Q.baseUrl||"/",domain:K.url,revalidate:q.revalidate??Q.revalidate??!1,sitemap:q.sitemap??Q.sitemap??!0,sitemapExclude:q.sitemapExclude||Q.sitemapExclude||[],robots:q.robots??Q.robots??!0,rss:q.rss??Q.rss??!1,concurrency:q.concurrency||Q.concurrency||10,cache:q.cache??Q.cache??!0,cacheDir:q.cacheDir||Q.cacheDir||d(process.cwd(),"ssg-cache"),contentLoaders:q.contentLoaders||[],hooks:q.hooks||{},minify:q.minify??Q.minify??!0,generate404:q.generate404??Q.generate404??!0,publicDir:q.publicDir||Q.publicDir||"public",trailingSlash:q.trailingSlash??Q.trailingSlash??!1,cleanOutput:q.cleanOutput??Q.cleanOutput??!0,cacheSalt:q.cacheSalt??"",partialsDir:q.partialsDir||$?.partialsDir||"",componentsDir:q.componentsDir||$?.componentsDir||"",failOnIncludeError:q.failOnIncludeError??!0,chunkIslands:q.chunkIslands===!0,prefetchIslands:q.prefetchIslands===!0,integrityIslands:q.integrityIslands===!0},W={totalPages:0,successCount:0,failedCount:0,cachedCount:0,buildTime:0,pages:[],errors:[]},z=new Set,A=0,G={},X={};await J.hooks.onBuildStart?.();try{if(J.cleanOutput&&O.existsSync(J.outputDir))await O.promises.rm(J.outputDir,{recursive:!0});await O.promises.mkdir(J.outputDir,{recursive:!0});let L=J.cacheSalt;if(!L){let{resolveUserCssConfig:Y,fingerprintConfig:N}=await import("./chunk-k6ky5et7.js");try{L=N(await Y(process.cwd()))}catch{}}let{prepareImageDelivery:_}=await import("./chunk-xdmb578h.js"),F=await _(J.publicDir,J.outputDir);if(F.count>0)console.log(`Optimized ${F.count} image(s) for responsive delivery`),L=[L,F.fingerprint].filter(Boolean).join(":");let C=new wq(J.cacheDir,L);if(J.cache)await C.load();try{let{generateCss:Y}=await import("./chunk-k6ky5et7.js");await Y('<div class="bg-black"></div>')}catch{}Yq();let kq=$?.routeMiddleware?.dir||"middleware";await jq(process.cwd(),kq);let p=Vq();if(p.length>0)console.log(`Loaded ${p.length} middleware: ${p.join(", ")}`);let bq=$?.routeMiddleware?.global||[];Fq($?.layoutsDir,d(process.cwd()));let i=l(".",{pagesDir:J.pagesDir,pagesDirs:$?._layerPageDirs});console.log(`Found ${i.length} routes`);let g=[];for(let Y of i){let N=await uq(Y);for(let H of N)g.push({route:Y,url:H.url,params:H.params,props:H.props,revalidate:H.revalidate??J.revalidate})}W.totalPages=g.length,console.log(`Generating ${W.totalPages} pages...`);let b=[],s=[];for(let Y=0;Y<g.length;Y+=J.concurrency)s.push(g.slice(Y,Y+J.concurrency));for(let Y of s)await Promise.all(Y.map(async(N)=>{let{route:H,url:V,params:S,props:Sq,revalidate:a}=N;try{await J.hooks.onPageStart?.(V);let w=await Bun.file(H.filePath).text(),R=JJ(w),vq=R?.middleware?Array.isArray(R.middleware)?R.middleware:[R.middleware]:[],t=[...bq,...vq];if(t.length>0){let D=Gq(V,S,R||{}),M=Lq(D,null,void 0,{isServer:!0}),E=await Nq(t,M);if(E.redirect){let U=typeof E.redirect==="string"?E.redirect:E.redirect.path||E.redirect,x=QJ(String(U),V),k=ZJ(V,J);await O.promises.mkdir(j.dirname(k),{recursive:!0}),await Bun.write(k,x),W.successCount++,W.pages.push({route:V,outputPath:k,size:Buffer.byteLength(x),cached:!1}),b.push({loc:V,lastmod:new Date().toISOString()}),console.log(`  \u21B3 ${V} \u2192 redirect to ${U}`);return}if(E.abort){let U=typeof E.abort==="string"?E.abort:E.abort?.error?.message||"aborted";console.warn(`  \u21B3 ${V} \u2014 middleware aborted: ${U}`);return}}let e=w.match(/definePageMeta\s*\(\s*\{[\s\S]*?validate\s*:\s*((?:\([^)]*\)|[^,}])*(?:\{[\s\S]*?\})?)/m);if(e)try{if(!await Function("route",`
+</rss>`}async function aq(q={}){let Z=Date.now();Aq();let $=await n(process.cwd()),Q=$.build||{},K=await Kq({explicit:q.domain||Q.domain,stxConfig:$});if(K.source==="fallback"&&(q.sitemap??Q.sitemap??!0))console.warn(Wq());let J={router:q.router??$?.router??{},pagesDir:q.pagesDir||Q.pagesDir||"pages",outputDir:q.outputDir||Q.outputDir||"dist",baseUrl:q.baseUrl||Q.baseUrl||"/",domain:K.url,revalidate:q.revalidate??Q.revalidate??!1,sitemap:q.sitemap??Q.sitemap??!0,sitemapExclude:q.sitemapExclude||Q.sitemapExclude||[],robots:q.robots??Q.robots??!0,rss:q.rss??Q.rss??!1,concurrency:q.concurrency||Q.concurrency||10,cache:q.cache??Q.cache??!0,cacheDir:q.cacheDir||Q.cacheDir||d(process.cwd(),"ssg-cache"),contentLoaders:q.contentLoaders||[],hooks:q.hooks||{},minify:q.minify??Q.minify??!0,generate404:q.generate404??Q.generate404??!0,publicDir:q.publicDir||Q.publicDir||"public",trailingSlash:q.trailingSlash??Q.trailingSlash??!1,cleanOutput:q.cleanOutput??Q.cleanOutput??!0,cacheSalt:q.cacheSalt??"",partialsDir:q.partialsDir||$?.partialsDir||"",componentsDir:q.componentsDir||$?.componentsDir||"",failOnIncludeError:q.failOnIncludeError??!0,chunkIslands:q.chunkIslands===!0,prefetchIslands:q.prefetchIslands===!0,integrityIslands:q.integrityIslands===!0},W={totalPages:0,successCount:0,failedCount:0,cachedCount:0,buildTime:0,pages:[],errors:[]},z=new Set,A=0,G={},X={};await J.hooks.onBuildStart?.();try{if(J.cleanOutput&&O.existsSync(J.outputDir))await O.promises.rm(J.outputDir,{recursive:!0});await O.promises.mkdir(J.outputDir,{recursive:!0});let L=J.cacheSalt;if(!L){let{resolveUserCssConfig:Y,fingerprintConfig:N}=await import("./chunk-m1p2n3nf.js");try{L=N(await Y(process.cwd()))}catch{}}let{prepareImageDelivery:_}=await import("./chunk-97ej3abh.js"),F=await _(J.publicDir,J.outputDir);if(F.count>0)console.log(`Optimized ${F.count} image(s) for responsive delivery`),L=[L,F.fingerprint].filter(Boolean).join(":");let C=new wq(J.cacheDir,L);if(J.cache)await C.load();try{let{generateCss:Y}=await import("./chunk-m1p2n3nf.js");await Y('<div class="bg-black"></div>')}catch{}Yq();let kq=$?.routeMiddleware?.dir||"middleware";await jq(process.cwd(),kq);let p=Vq();if(p.length>0)console.log(`Loaded ${p.length} middleware: ${p.join(", ")}`);let bq=$?.routeMiddleware?.global||[];Fq($?.layoutsDir,d(process.cwd()));let i=l(".",{pagesDir:J.pagesDir,pagesDirs:$?._layerPageDirs});console.log(`Found ${i.length} routes`);let g=[];for(let Y of i){let N=await uq(Y);for(let H of N)g.push({route:Y,url:H.url,params:H.params,props:H.props,revalidate:H.revalidate??J.revalidate})}W.totalPages=g.length,console.log(`Generating ${W.totalPages} pages...`);let b=[],s=[];for(let Y=0;Y<g.length;Y+=J.concurrency)s.push(g.slice(Y,Y+J.concurrency));for(let Y of s)await Promise.all(Y.map(async(N)=>{let{route:H,url:V,params:S,props:Sq,revalidate:a}=N;try{await J.hooks.onPageStart?.(V);let w=await Bun.file(H.filePath).text(),R=JJ(w),vq=R?.middleware?Array.isArray(R.middleware)?R.middleware:[R.middleware]:[],t=[...bq,...vq];if(t.length>0){let D=Gq(V,S,R||{}),M=Lq(D,null,void 0,{isServer:!0}),E=await Nq(t,M);if(E.redirect){let U=typeof E.redirect==="string"?E.redirect:E.redirect.path||E.redirect,x=QJ(String(U),V),k=ZJ(V,J);await O.promises.mkdir(j.dirname(k),{recursive:!0}),await Bun.write(k,x),W.successCount++,W.pages.push({route:V,outputPath:k,size:Buffer.byteLength(x),cached:!1}),b.push({loc:V,lastmod:new Date().toISOString()}),console.log(`  \u21B3 ${V} \u2192 redirect to ${U}`);return}if(E.abort){let U=typeof E.abort==="string"?E.abort:E.abort?.error?.message||"aborted";console.warn(`  \u21B3 ${V} \u2014 middleware aborted: ${U}`);return}}let e=w.match(/definePageMeta\s*\(\s*\{[\s\S]*?validate\s*:\s*((?:\([^)]*\)|[^,}])*(?:\{[\s\S]*?\})?)/m);if(e)try{if(!await Function("route",`
                 const validate = ${e[1]};
                 return validate(route);
               `)({params:S})){console.warn(`Validation failed for ${V}, skipping...`);return}}catch{}let I=null,qq=!1;if(J.cache){if(I=C.get(V,H.filePath),I)qq=!0,W.cachedCount++}if(!I){let D=await Mq(H,S,Sq,J,$);if(I=D.html,J.failOnIncludeError&&D.includeFailures.length>0)throw Error(`${D.includeFailures.length} include(s) failed to resolve, so this page would have shipped with an error banner where the markup should be:

package/dist/stx-virtual-ts.d.ts

@@ -1,3 +1,106 @@
+/**
+ * Turn a `.stx` file into TypeScript that a real compiler can check
+ * (stacksjs/stx#1852, asks 4 and 5).
+ *
+ * `stx typecheck` and the VS Code tsserver plugin both need the same answer to
+ * "what TypeScript is in this file, and where did it come from". They used to
+ * answer it differently, and the editor's answer was wrong in three ways at
+ * once: it concatenated every script block into one buffer, which made two
+ * blocks that legitimately declare the same name collide; it dropped the HTML
+ * while doing so, so **every diagnostic landed on the wrong line**; and it then
+ * suppressed every "Cannot find name" mentioning a hardcoded list of runtime
+ * globals, which also suppressed genuine typos.
+ *
+ * This module is the single extractor, so the editor and CI cannot disagree
+ * about what a file contains or where a diagnostic belongs.
+ *
+ * ## Positions survive by construction
+ *
+ * The virtual source is built as an array of lines the same length as the
+ * source, with each block's body written at the index it already occupies. A
+ * diagnostic's line number therefore *is* the line number in the `.stx` file —
+ * no offset table, and nothing to get wrong when a file has several blocks.
+ *
+ * Only synthetic lines appended past the end of the file need a map, and
+ * {@link VirtualFile.lineMap} carries it.
+ *
+ * ## What is deliberately not attempted
+ *
+ * Template expressions are checked for syntax and for names that resolve, not
+ * for deep types. Two things stand in the way, and pretending otherwise would
+ * produce false positives in a CI gate:
+ *
+ *  - The runtime globals are typed `any` (see `runtime-globals.ts`), so a
+ *    signal's value type is unknown to begin with.
+ *  - Templates auto-unwrap signals — `:if="flag"` reads the value while
+ *    `@click="flag.set(true)"` reads the signal object — so the same name has
+ *    two types depending on the attribute it appears in.
+ *
+ * Server-block bindings do have real types, and those are checked: see
+ * {@link buildTemplateScopeSource}, which inlines server bodies so
+ * `{{ row.total_vists }}` fails against a typed row.
+ *
+ * @module stx-virtual-ts
+ */
+export type ScriptKind = 'server' | 'client' | 'plain';
+export interface ScriptBlock {
+    kind: ScriptKind;
+    /** Block body, without the surrounding tags. */
+    code: string;
+    /** 1-based line in the source file where the body's first character sits. */
+    startLine: number;
+    /** The opening tag's attributes, trimmed. */
+    attrs: string;
+}
+/** A `{{ }}` interpolation or a directive attribute value. */
+export interface TemplateExpression {
+    /** A generated contract check anchors at its source value, not its TS wrapper. */
+    anchor?: boolean;
+    /** The expression text, with any filter chain already removed. */
+    code: string;
+    /** 1-based line of the expression's first character. */
+    line: number;
+    /** 1-based column of the expression's first character. */
+    column: number;
+    kind: 'interpolation' | 'directive';
+    /** For directives, the attribute name (`:if`, `@click`, `x-text`). */
+    attribute?: string;
+    /**
+     * 0-based offset of the expression's first character, used to work out which
+     * `@if` / `@unless` blocks enclose it. Not part of a diagnostic; `line` and
+     * `column` carry that.
+     */
+    offset?: number;
+}
+/** A synthetic line's origin, for diagnostics that land outside the source. */
+export interface MappedLine {
+    line: number;
+    column: number;
+    /** Present when the line came from a template expression. */
+    expression?: TemplateExpression;
+    /**
+     * Characters of wrapper before the expression starts on the synthetic line.
+     *
+     * Subtracting it turns a column in the virtual line into a column inside the
+     * expression, so a squiggle lands on the offending identifier rather than at
+     * the start of the attribute.
+     */
+    prefixLength?: number;
+}
+export interface VirtualFile {
+    text: string;
+    componentDependencies?: Map<string, string>;
+    /**
+     * Virtual 1-based line → where it came from.
+     *
+     * Only holds entries for lines the source does not already account for.
+     * Anything absent is at its own line number, because the body was written at
+     * the index it occupies in the file.
+     */
+    lineMap: Map<number, MappedLine>;
+    /** Lines after this are synthetic. */
+    sourceLineCount: number;
+}
 /**
  * Pull the script blocks out of a `.stx` source, with the line each body starts on.
  *
@@ -23,6 +126,19 @@ export declare function maskNonTemplateRegions(source: string): string;
  * is TypeScript, and `||` is a real operator that must survive.
  */
 export declare function stripFilterChain(expression: string): string;
+/**
+ * Placeholder for a server interpolation spliced into a client expression.
+ *
+ * `:show="photos()[{{ idx }}]"` is real stx — the server fills `{{ idx }}` in
+ * before the client ever parses the attribute. Left in place it is a syntax
+ * error, so it is replaced with a declared `any`; the interpolation itself is
+ * still extracted and checked on its own.
+ */
+export declare const INTERPOLATION_PLACEHOLDER = "__stx_interpolated";
+/** Name of the generated helper that reads an iterable's element type. */
+export declare const ELEMENT_HELPER = "__StxElement";
+/** Name of the generated helper that models a template's signal auto-unwrap. */
+export declare const UNWRAP_HELPER = "__StxTemplateValue";
 export declare function substituteInterpolations(value: string): string;
 /**
  * The same substitution, but the result occupies the same space as the source.
@@ -76,6 +192,27 @@ export declare function blankScriptDirectives(code: string): string;
  * the braces literally.
  */
 export declare function extractTemplateExpressions(source: string): TemplateExpression[];
+/**
+ * Names a template introduces that no script block declares.
+ *
+ * Loop bindings are collected for the whole file rather than tracked per
+ * subtree. That is deliberately over-permissive: using a loop variable outside
+ * its loop goes unreported, which is a missing error, whereas scoping it
+ * precisely without an HTML parser would invent errors that are not there.
+ */
+export interface TemplateBinding {
+    name: string;
+    /**
+     * The iterable it was drawn from, when that is a plain identifier.
+     *
+     * `@foreach(rows as row)` can then type `row` as `rows`' element type, which
+     * is what turns a renamed column into a compile error rather than a silent
+     * `undefined`. Anything more complex than an identifier stays `any` — a call
+     * or a member chain would need the whole expression to resolve, and being
+     * wrong there invents errors.
+     */
+    iterable?: string;
+}
 export declare function collectTemplateBindings(source: string): TemplateBinding[];
 /**
  * Top-level names a script block declares.
@@ -86,6 +223,13 @@ export declare function collectTemplateBindings(source: string): TemplateBinding
 export declare function collectBlockDeclarations(code: string): string[];
 /** Ambient declarations for the globals the stx runtime injects. */
 export declare function runtimeGlobalDeclarations(): string;
+/**
+ * Context the server injects into a `<script server>` block.
+ *
+ * Mirrors what `serve.ts` puts in scope. Declaring these is what lets the
+ * checker report a genuine typo instead of suppressing every unresolved name.
+ */
+export declare const STX_SERVER_CONTEXT: readonly ['params', 'query', 'cookies', 'host', 'ip', 'setResponseStatus', 'setResponseHeader', 'notFound', 'request', 'url', 'definePageMeta', 'defineClientPayload', 'defineStore', 'props', '$props'];
 export declare function serverContextDeclarations(): string;
 /**
  * The names a `defineClientPayload({ … })` call publishes, or `null` when the
@@ -101,7 +245,10 @@ export declare function serverContextDeclarations(): string;
  */
 export declare function extractClientPayloadNames(serverCode: string): string[] | null;
 /** Top-level `import` statements, and everything else, separated. */
-export declare function splitTopLevelImports(code: string): { imports: string, body: string };
+export declare function splitTopLevelImports(code: string): {
+    imports: string;
+    body: string;
+};
 /**
  * Declarations that give a client block the server values it is actually given.
  *
@@ -146,7 +293,10 @@ export declare function splitTopLevelImports(code: string): { imports: string, b
  * than a blanked copy, because the declaration's BODY is what has to be carried
  * across, not just its name.
  */
-export declare function extractTypeDeclarations(code: string): Array<{ name: string, text: string }>;
+export declare function extractTypeDeclarations(code: string): Array<{
+    name: string;
+    text: string;
+}>;
 export declare function clientPayloadDeclarations(serverCode: string, clientCode?: string): string;
 /**
  * Declarations at the TOP LEVEL of a block, ignoring anything nested.
@@ -180,6 +330,19 @@ export declare function collectTopLevelDeclarations(code: string): string[];
  * not actually mention any server name.
  */
 export declare function scrapedBridgeNames(serverCode: string, clientCode: string): string[];
+/** Marker comment so a generated preamble is recognisable in a dumped buffer. */
+export declare const PAYLOAD_COMMENT = "stx: types for the declared client payload (#1868)";
+/** The same, for a page still relying on the name-scraping bridge. */
+export declare const SCRAPED_COMMENT = "stx: untyped bridge names \u2014 declare a defineClientPayload to check these (#1868)";
+/**
+ * Names the template engine puts in scope for every page.
+ *
+ * Declared rather than suppressed. The editor plugin used to drop every
+ * "Cannot find name" whose message mentioned one of a hardcoded list, which
+ * also dropped genuine typos; giving the names a declaration means an
+ * unrecognised one is still an error (#1852 ask 3).
+ */
+export declare const STX_TEMPLATE_GLOBALS: readonly ['$env', '$user', '$slot', '$slots', '$attrs', '$props', '$page', '$route', '$loop', 'loop', '$errors', '$csrf', 'props', 'slot'];
 /**
  * Names declared by both a server block and a client/plain block.
  *
@@ -218,7 +381,10 @@ export declare function crossScopeCollisions(blocks: readonly ScriptBlock[]): st
  * rather than twice.
  */
 export declare function guardChainAt(source: string, offset: number): string[];
-export declare function expressionStatement(expression: TemplateExpression): { text: string, prefixLength: number } | null;
+export declare function expressionStatement(expression: TemplateExpression): {
+    text: string;
+    prefixLength: number;
+} | null;
 /**
  * Rewrite relative module specifiers to absolute paths against the real file.
  *
@@ -246,6 +412,31 @@ export declare function expressionStatement(expression: TemplateExpression): { t
  * change a line count, so every diagnostic still lands on the author's line.
  */
 export declare function absolutizeRelativeSpecifiers(code: string, originDir: string): string;
+export interface BuildVirtualOptions {
+    /** Enables component call-site checks using the renderer's file lookup. */
+    filePath?: string;
+    componentsDir?: string;
+    projectRoot?: string;
+    readComponent?: (file: string) => string | undefined;
+    /** Append `{{ }}` and directive expressions. Default true. */
+    templateExpressions?: boolean;
+    /**
+     * Directory the `.stx` file really lives in.
+     *
+     * Relative imports in its script blocks are resolved against it, since the
+     * buffer this builds is written somewhere else entirely (#1928).
+     */
+    originDir?: string;
+    /** Append ambient declarations at all. Default true. */
+    globals?: boolean;
+    /**
+     * Declare the stx runtime globals as `any`. Default true.
+     *
+     * Pass `false` when the program already includes the package's `stx.d.ts`,
+     * which types them properly — these would shadow it.
+     */
+    runtimeGlobals?: boolean;
+}
 /**
  * Build one line-aligned TypeScript buffer for a whole `.stx` file.
  *
@@ -260,9 +451,19 @@ export declare function buildVirtualTypeScript(source: string, options?: BuildVi
 /** Offsets at which each 1-based line starts. */
 export declare function lineStarts(text: string): number[];
 /** Offset → 1-based line and column. */
-export declare function offsetToPosition(starts: readonly number[], offset: number): { line: number, column: number };
+export declare function offsetToPosition(starts: readonly number[], offset: number): {
+    line: number;
+    column: number;
+};
 /** 1-based line and column → offset, clamped to the line. */
 export declare function positionToOffset(starts: readonly number[], line: number, column: number): number;
+/** Where a diagnostic in a virtual buffer belongs in the `.stx` file. */
+export interface ResolvedPosition {
+    line: number;
+    column: number;
+    /** Set when the diagnostic came from a template expression. */
+    expression?: TemplateExpression;
+}
 /**
  * Translate a position in a virtual buffer back to the `.stx` file.
  *
@@ -271,94 +472,3 @@ export declare function positionToOffset(starts: readonly number[], line: number
  * must be dropped rather than pointed at an arbitrary line.
  */
 export declare function resolvePosition(virtual: VirtualFile, line: number, column: number): ResolvedPosition | null;
-/**
- * Placeholder for a server interpolation spliced into a client expression.
- *
- * `:show="photos()[{{ idx }}]"` is real stx — the server fills `{{ idx }}` in
- * before the client ever parses the attribute. Left in place it is a syntax
- * error, so it is replaced with a declared `any`; the interpolation itself is
- * still extracted and checked on its own.
- */
-export declare const INTERPOLATION_PLACEHOLDER: '__stx_interpolated';
-/** Name of the generated helper that reads an iterable's element type. */
-export declare const ELEMENT_HELPER: '__StxElement';
-/** Name of the generated helper that models a template's signal auto-unwrap. */
-export declare const UNWRAP_HELPER: '__StxTemplateValue';
-/**
- * Context the server injects into a `<script server>` block.
- *
- * Mirrors what `serve.ts` puts in scope. Declaring these is what lets the
- * checker report a genuine typo instead of suppressing every unresolved name.
- */
-export declare const STX_SERVER_CONTEXT: readonly ['params', 'query', 'cookies', 'host', 'ip', 'setResponseStatus', 'setResponseHeader', 'notFound', 'request', 'url', 'definePageMeta', unknown, unknown, 'defineStore', unknown, unknown, unknown, unknown, unknown, '$props'];
-/** Marker comment so a generated preamble is recognisable in a dumped buffer. */
-export declare const PAYLOAD_COMMENT: 'stx: types for the declared client payload (#1868)';
-/** The same, for a page still relying on the name-scraping bridge. */
-export declare const SCRAPED_COMMENT: 'stx: untyped bridge names — declare a defineClientPayload to check these (#1868)';
-/**
- * Names the template engine puts in scope for every page.
- *
- * Declared rather than suppressed. The editor plugin used to drop every
- * "Cannot find name" whose message mentioned one of a hardcoded list, which
- * also dropped genuine typos; giving the names a declaration means an
- * unrecognised one is still an error (#1852 ask 3).
- */
-export declare const STX_TEMPLATE_GLOBALS: readonly ['$env', '$user', '$slot', '$slots', '$attrs', '$props', '$page', '$route', '$loop', unknown, unknown, '$errors', '$csrf', 'props', 'slot'];
-export declare interface ScriptBlock {
-  kind: ScriptKind
-  code: string
-  startLine: number
-  attrs: string
-}
-/** A `{{ }}` interpolation or a directive attribute value. */
-export declare interface TemplateExpression {
-  anchor?: boolean
-  code: string
-  line: number
-  column: number
-  kind: 'interpolation' | 'directive'
-  attribute?: string
-  offset?: number
-}
-/** A synthetic line's origin, for diagnostics that land outside the source. */
-export declare interface MappedLine {
-  line: number
-  column: number
-  expression?: TemplateExpression
-  prefixLength?: number
-}
-export declare interface VirtualFile {
-  text: string
-  componentDependencies?: Map<string, string>
-  lineMap: Map<number, MappedLine>
-  sourceLineCount: number
-}
-/**
- * Names a template introduces that no script block declares.
- *
- * Loop bindings are collected for the whole file rather than tracked per
- * subtree. That is deliberately over-permissive: using a loop variable outside
- * its loop goes unreported, which is a missing error, whereas scoping it
- * precisely without an HTML parser would invent errors that are not there.
- */
-export declare interface TemplateBinding {
-  name: string
-  iterable?: string
-}
-export declare interface BuildVirtualOptions {
-  filePath?: string
-  componentsDir?: string
-  projectRoot?: string
-  readComponent?: (file: string) => string | undefined
-  templateExpressions?: boolean
-  originDir?: string
-  globals?: boolean
-  runtimeGlobals?: boolean
-}
-/** Where a diagnostic in a virtual buffer belongs in the `.stx` file. */
-export declare interface ResolvedPosition {
-  line: number
-  column: number
-  expression?: TemplateExpression
-}
-export type ScriptKind = 'server' | 'client' | 'plain';

package/dist/template-syntax-escape.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Make a substituted VALUE unreadable as template syntax.
+ *
+ * A value reaches the output in the middle of a pipeline: expression passes run
+ * again over component expansion and over loop bodies, and the client runtime
+ * reads the document afterwards. So whatever a value contains gets a second
+ * look, and text that looks like template syntax is acted on -- the value is
+ * data, and data must not become markup.
+ *
+ * Every replacement here is a character reference, so nothing needs restoring
+ * afterwards and no placeholder can leak into a page. What a reader sees is
+ * unchanged: the browser decodes the references before anything reads them, an
+ * attribute parses back to the original character, and JSON.parse of a data
+ * attribute still works.
+ *
+ * Two modules escape values -- expressions.ts for template output and
+ * server-components.ts for its own substitution -- and they have to agree, so
+ * the rules live here rather than in either of them. This module deliberately
+ * imports nothing: server-components.ts keeps its own dependency-light escaping
+ * and can use this without pulling in the expression machinery.
+ *
+ * @module template-syntax-escape
+ */
+/**
+ * A zero-width joiner. It breaks a syntax pattern while changing nothing a
+ * reader sees: no width, no line-breaking behaviour, and it copies as an
+ * invisible character.
+ */
+export declare const WORD_JOINER = "⁠";
+/**
+ * Neutralise template syntax in an ALREADY HTML-escaped value.
+ *
+ * Call it after HTML escaping: it relies on `<`, `>` and the quotes being gone,
+ * and on `{`, `}`, `@` and `(` still being themselves.
+ */
+export declare function neutralizeTemplateSyntax(escaped: string): string;

package/dist/template-syntax-escape.js

@@ -0,0 +1,8 @@
+export const WORD_JOINER = "⁠";
+const DIRECTIVE_IN_VALUE = /@(?=[a-zA-Z_]\w*\s*\(|end[a-zA-Z]*\b|else(?:if)?\b|empty\b|case\b|default\b|break\b|continue\b|fallback\b)/g;
+function joinBraces(length) {
+  return Array.from({ length }, () => "{").join(WORD_JOINER);
+}
+export function neutralizeTemplateSyntax(escaped) {
+  return escaped.replace(/\{{2,}/g, (match) => joinBraces(match.length)).replace(/\{(?=!)/g, `{${WORD_JOINER}`).replace(DIRECTIVE_IN_VALUE, "@");
+}

package/dist/utils.js

@@ -21,6 +21,7 @@ import { findSfcTemplateBlock } from "./sfc-template.js";
 import { importOnce } from "./lazy-module.js";
 import { stashScriptElements } from "./html-masking.js";
 import { markProjectedRefs } from "./misc-directives.js";
+import { collectBlockDeclarations } from "./stx-virtual-ts.js";
 export {
   extractDirectiveNames,
   getPositionInfo,
@@ -708,16 +709,20 @@ ${triedPaths.map((p) => `  - ${p}`).join(`
         preservedExpressionBaseline = new Set(Array.isArray(parentContext.__stx_preserved_client_expressions) ? parentContext.__stx_preserved_client_expressions : []);
       }
     }
+    const ownServerNames = new Set;
     for (const match of scriptMatches) {
       const attrs = match[1] || "";
       let content = match[2] || "";
       const isServerScript = attrs.includes("server");
       if (shouldTranspileTypeScript(attrs) && content.trim())
         content = transpileTypeScript(content);
-      if (isServerScript && content)
+      if (isServerScript && content) {
+        for (const name of collectBlockDeclarations(content))
+          ownServerNames.add(name);
         try {
           await extractVariables(content, componentContext, componentFilePath);
         } catch (e) {}
+      }
       if (!isServerScript) {
         let cleanContent = content.replace(/^\s*const\s*\{[^}]+\}\s*=\s*window\.stx\s*;?\s*\n?/gm, "");
         const hasMustache = cleanContent.includes("{{") && cleanContent.includes("}}"), hasRawMarker = cleanContent.includes("{!!") && cleanContent.includes("!!}");
@@ -756,9 +761,11 @@ ${triedPaths.map((p) => `  - ${p}`).join(`
       content: projectRefs(slot.content)
     }]));
     templateContent = await applySlots(templateContent, projectRefs(defaultSlot), projectedSlots, componentContext);
-    const clientSignalNames = componentClientSignalNames(clientScripts), inheritedClientSignalNames = Array.isArray(componentContext.__stx_client_signal_names) ? componentContext.__stx_client_signal_names : [];
+    const clientSignalNames = componentClientSignalNames(clientScripts), inheritedClientSignalNames = (Array.isArray(componentContext.__stx_client_signal_names) ? componentContext.__stx_client_signal_names : []).filter((name) => !ownServerNames.has(name));
     if (clientSignalNames.length > 0 || inheritedClientSignalNames.length > 0)
       componentContext.__stx_client_signal_names = [...new Set([...inheritedClientSignalNames, ...clientSignalNames])];
+    else
+      delete componentContext.__stx_client_signal_names;
     const componentOptions = {
       ...options,
       _rootComponentsDir: options._rootComponentsDir || options.componentsDir,

package/dist/variable-extractor.d.ts

@@ -53,6 +53,7 @@ export declare function isModuleResolutionFailure(message: string): boolean;
  * as a correct answer rather than as a failure, which is exactly the shape that
  * is expensive to find.
  */
+export declare function isSyntaxFailure(error: unknown): boolean;
 export declare function isMissingBindingFailure(message: string): boolean;
 /**
  * Extract variables from script content and add them to context

package/dist/variable-extractor.js

@@ -275,6 +275,12 @@ export function stripTypeScript(scriptContent) {
 export function isModuleResolutionFailure(message) {
   return /cannot find module|could not resolve|module not found|failed to resolve/i.test(message);
 }
+export function isSyntaxFailure(error) {
+  if (error instanceof SyntaxError)
+    return !0;
+  const message = error instanceof Error ? error.message : String(error);
+  return /SyntaxError|Unexpected (token|identifier|string|number|keyword|end of)|Unterminated|Expected .+ but found/i.test(message);
+}
 export function isMissingBindingFailure(message) {
   if (!/is not defined|can't find variable/i.test(message))
     return !1;
@@ -550,6 +556,8 @@ export async function extractVariables(scriptContent, context, filePath, options
     const msg = primaryError instanceof Error ? primaryError.message : String(primaryError);
     if (isModuleResolutionFailure(msg))
       console.warn(`[stx] server <script> in ${filePath ?? "<unknown>"} imports a module that does not resolve, so every variable in that script is undefined. Cause: ${msg}`);
+    else if (isSyntaxFailure(primaryError))
+      console.warn(`[stx] server <script> in ${filePath ?? "<unknown>"} does not parse, so every variable in that script is undefined. Cause: ${msg}`);
     else if (isMissingBindingFailure(msg))
       console.warn(`[stx] server <script> in ${filePath ?? "<unknown>"} names something that does not exist, so every variable in that script is undefined. Optional chaining does not help here: an undefined identifier throws before the chain is reached. Cause: ${msg}`);
     else if (process.env.STX_DEBUG)

package/dist/visual-testing.js

@@ -1,5 +1,5 @@
 // @bun
-import"./chunk-hyfjnn7g.js";import B from"fs";import $ from"path";import k from"crypto";var V=[{name:"mobile",width:375,height:667,isMobile:!0,hasTouch:!0},{name:"tablet",width:768,height:1024,isMobile:!0,hasTouch:!0},{name:"desktop",width:1280,height:800,isMobile:!1,hasTouch:!1},{name:"wide",width:1920,height:1080,isMobile:!1,hasTouch:!1}];function J(N={}){let Y={snapshotDir:N.snapshotDir||"__snapshots__",screenshotDir:N.screenshotDir||"__screenshots__",updateSnapshots:N.updateSnapshots||process.env.UPDATE_SNAPSHOTS==="true",threshold:N.threshold??0.01,viewports:N.viewports||V,generateDiff:N.generateDiff??!0,diffDir:N.diffDir||"__diffs__",compare:N.compare||b,ci:N.ci??process.env.CI==="true",retries:N.retries??(N.ci?3:1)};return{async snapshot(M,X){let q=$.join(Y.snapshotDir,`${X}.html`),G=C(M),Q=K(G);if(await Bun.file(q).exists()){let W=await Bun.file(q).text(),Z=K(C(W));if(Q===Z)return{passed:!0,snapshotPath:q,message:"Snapshot matches"};if(Y.updateSnapshots)return await B.promises.mkdir($.dirname(q),{recursive:!0}),await Bun.write(q,G),{passed:!0,snapshotPath:q,message:"Snapshot updated"};let F=$.join(Y.diffDir,`${X}.actual.html`),U=$.join(Y.diffDir,`${X}.diff.html`);return await B.promises.mkdir(Y.diffDir,{recursive:!0}),await Bun.write(F,G),await Bun.write(U,I(W,G)),{passed:!1,snapshotPath:q,actualPath:F,diffPath:U,message:"Snapshot does not match"}}return await B.promises.mkdir($.dirname(q),{recursive:!0}),await Bun.write(q,G),{passed:!0,snapshotPath:q,message:"New snapshot created"}},async snapshotJson(M,X){let q=$.join(Y.snapshotDir,`${X}.json`),G=JSON.stringify(M,null,2);if(await Bun.file(q).exists()){let Q=await Bun.file(q).text();if(G===Q)return{passed:!0,snapshotPath:q};if(Y.updateSnapshots)return await Bun.write(q,G),{passed:!0,snapshotPath:q,message:"Snapshot updated"};return{passed:!1,snapshotPath:q,message:`JSON snapshot mismatch:
+import"./chunk-5g6rprcy.js";import B from"fs";import $ from"path";import k from"crypto";var V=[{name:"mobile",width:375,height:667,isMobile:!0,hasTouch:!0},{name:"tablet",width:768,height:1024,isMobile:!0,hasTouch:!0},{name:"desktop",width:1280,height:800,isMobile:!1,hasTouch:!1},{name:"wide",width:1920,height:1080,isMobile:!1,hasTouch:!1}];function J(N={}){let Y={snapshotDir:N.snapshotDir||"__snapshots__",screenshotDir:N.screenshotDir||"__screenshots__",updateSnapshots:N.updateSnapshots||process.env.UPDATE_SNAPSHOTS==="true",threshold:N.threshold??0.01,viewports:N.viewports||V,generateDiff:N.generateDiff??!0,diffDir:N.diffDir||"__diffs__",compare:N.compare||b,ci:N.ci??process.env.CI==="true",retries:N.retries??(N.ci?3:1)};return{async snapshot(M,X){let q=$.join(Y.snapshotDir,`${X}.html`),G=C(M),Q=K(G);if(await Bun.file(q).exists()){let W=await Bun.file(q).text(),Z=K(C(W));if(Q===Z)return{passed:!0,snapshotPath:q,message:"Snapshot matches"};if(Y.updateSnapshots)return await B.promises.mkdir($.dirname(q),{recursive:!0}),await Bun.write(q,G),{passed:!0,snapshotPath:q,message:"Snapshot updated"};let F=$.join(Y.diffDir,`${X}.actual.html`),U=$.join(Y.diffDir,`${X}.diff.html`);return await B.promises.mkdir(Y.diffDir,{recursive:!0}),await Bun.write(F,G),await Bun.write(U,I(W,G)),{passed:!1,snapshotPath:q,actualPath:F,diffPath:U,message:"Snapshot does not match"}}return await B.promises.mkdir($.dirname(q),{recursive:!0}),await Bun.write(q,G),{passed:!0,snapshotPath:q,message:"New snapshot created"}},async snapshotJson(M,X){let q=$.join(Y.snapshotDir,`${X}.json`),G=JSON.stringify(M,null,2);if(await Bun.file(q).exists()){let Q=await Bun.file(q).text();if(G===Q)return{passed:!0,snapshotPath:q};if(Y.updateSnapshots)return await Bun.write(q,G),{passed:!0,snapshotPath:q,message:"Snapshot updated"};return{passed:!1,snapshotPath:q,message:`JSON snapshot mismatch:
 ${z(Q,G)}`}}return await B.promises.mkdir($.dirname(q),{recursive:!0}),await Bun.write(q,G),{passed:!0,snapshotPath:q,message:"New snapshot created"}},matchInlineSnapshot(M,X){let q=C(M);if(X===void 0)return{passed:!0,expected:q};let G=C(X);return{passed:q===G,expected:q}},getConfig(){return Y}}}function D(N={}){let Y=J(N),M=Y.getConfig();return{async compareScreenshots(X,q,G="desktop"){let Q=$.join(M.screenshotDir,G,`${X}.png`),W=$.join(M.diffDir,G,`${X}.actual.png`),Z=$.join(M.diffDir,G,`${X}.diff.png`);if(await Bun.file(Q).exists()){let F=await Bun.file(Q).arrayBuffer(),U=Buffer.from(F),_=await M.compare(q,U);if(_.match||_.diffPercentage<=M.threshold)return{viewport:G,passed:!0,baselinePath:Q};if(M.updateSnapshots)return await B.promises.mkdir($.dirname(Q),{recursive:!0}),await Bun.write(Q,q),{viewport:G,passed:!0,baselinePath:Q};if(await B.promises.mkdir($.dirname(W),{recursive:!0}),await Bun.write(W,q),_.diffImage&&M.generateDiff)await Bun.write(Z,_.diffImage);return{viewport:G,passed:!1,baselinePath:Q,actualPath:W,diffPath:M.generateDiff?Z:void 0,diffPercentage:_.diffPercentage}}return await B.promises.mkdir($.dirname(Q),{recursive:!0}),await Bun.write(Q,q),{viewport:G,passed:!0,baselinePath:Q}},async testViewports(X,q,G=M.viewports){let Q=[];for(let W of G){let Z=null;for(let F=0;F<M.retries;F++)try{let U=await q(W),_=await this.compareScreenshots(X,U,W.name);Q.push(_),Z=null;break}catch(U){if(Z=U,F<M.retries-1)await new Promise((_)=>setTimeout(_,100*(F+1)))}if(Z)Q.push({viewport:W.name,passed:!1,baselinePath:"",diffPercentage:100})}return Q},getSnapshotTester(){return Y}}}function L(N={}){let M=D(N).getSnapshotTester(),X=new Map;return{addStory(q){X.set(`${q.component}/${q.name}`,q)},addStories(q){for(let G of q)this.addStory(G)},getStories(){return Array.from(X.values())},getStoriesForComponent(q){return Array.from(X.values()).filter((G)=>G.component===q)},async testStory(q){let G=X.get(q);if(!G)return{name:q,passed:!1,duration:0,snapshots:[],screenshots:[],errors:[Error(`Story not found: ${q}`)]};let Q=Date.now(),W={name:q,passed:!0,duration:0,snapshots:[],screenshots:[],errors:[]};try{let Z=await G.render(),F=await M.snapshot(Z,q.replace(/\//g,"-"));if(W.snapshots.push(F),!F.passed)W.passed=!1}catch(Z){W.passed=!1,W.errors.push(Z)}return W.duration=Date.now()-Q,W},async testAllStories(){let q=[];for(let G of X.keys()){let Q=await this.testStory(G);q.push(Q)}return q},async generateStoryIndex(){let q={};for(let G of X.values()){if(!q[G.component])q[G.component]=[];q[G.component].push({name:G.name,args:G.args})}return JSON.stringify(q,null,2)}}}async function S(N,Y={}){let M={outputDir:Y.outputDir||"visual-test-report",format:Y.format||"html",title:Y.title||"Visual Test Report",includeScreenshots:Y.includeScreenshots??!0};await B.promises.mkdir(M.outputDir,{recursive:!0});let X=N.length,q=N.filter((F)=>F.passed).length,G=X-q,Q=N.reduce((F,U)=>F+U.duration,0);if(M.format==="json"){let F={title:M.title,summary:{total:X,passed:q,failed:G,duration:Q},results:N,generatedAt:new Date().toISOString()},U=$.join(M.outputDir,"report.json");return await Bun.write(U,JSON.stringify(F,null,2)),U}if(M.format==="markdown"){let F=`# ${M.title}
 
 `;F+=`## Summary

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@stacksjs/stx",
   "type": "module",
-  "version": "0.2.336",
+  "version": "0.2.338",
   "description": "A performant UI Framework. Powered by Bun.",
   "author": "Chris Breuer <chris@stacksjs.org>",
   "license": "MIT",
@@ -116,14 +116,14 @@
   },
   "dependencies": {
     "@stacksjs/ts-css": "^0.3.2",
-    "@stacksjs/clapp": "^0.2.14",
-    "@stacksjs/desktop": "0.2.336",
-    "@stacksjs/sanitizer": "0.2.336",
+    "@stacksjs/clapp": "^0.2.16",
+    "@stacksjs/desktop": "0.2.338",
+    "@stacksjs/sanitizer": "0.2.338",
     "@stacksjs/ts-i18n": "^0.1.11",
-    "bun-plugin-stx": "0.2.336",
-    "bunfig": "^0.15.17",
-    "stx-router": "0.2.336",
-    "ts-broadcasting": "^0.0.9",
+    "bun-plugin-stx": "0.2.338",
+    "bunfig": "^0.15.19",
+    "stx-router": "0.2.338",
+    "ts-broadcasting": "^0.0.10",
     "ts-images": "^0.2.22",
     "ts-syntax-highlighter": "^0.2.1"
   }

package/dist/chunk-046dp691.js

@@ -1,2 +0,0 @@
-// @bun
-import{hl as a,il as b,jl as c,kl as d,ll as e,ml as f,nl as g,ol as h,pl as i,ql as j,rl as k,sl as l,tl as m,ul as n,vl as o}from"./chunk-zz8qgqa1.js";import"./chunk-p1hy2bwn.js";import"./chunk-kxtqbrfr.js";import"./chunk-caaenc3w.js";import"./chunk-amxtypkp.js";import"./chunk-nat3actx.js";import"./chunk-q0g5c39d.js";import"./chunk-kffndzch.js";import"./chunk-c2ta859c.js";import"./chunk-r8rbf28v.js";import"./chunk-gptwwv3c.js";import"./chunk-n66k2v2q.js";import"./chunk-vvd659y4.js";import"./chunk-7r80apc5.js";import"./chunk-2tjk867y.js";import"./chunk-t8ctvjqe.js";import"./chunk-deqnt1w5.js";import"./chunk-hzfd8cz0.js";import"./chunk-q569zmrr.js";import"./chunk-hyfjnn7g.js";export{o as tempBuildName,b as shouldLogBundlerDiagnostics,f as setBundlerFallbackMode,l as rewriteRegistryImports,g as resolveBundlerFallback,j as registryIdForPath,c as recordBundleFailure,m as queueClientBundleBuild,k as normalizeRegistrySpecifiers,h as hasUserImports,d as getBundleFailures,a as clientBundleDependencies,e as clearBundleFailures,n as bundleClientScript,i as MODULE_SPECIFIER_PREFIX};

package/dist/chunk-1brnvyhv.js

@@ -1,2 +0,0 @@
-// @bun
-import{To as a,Vo as b,Xo as c,Yo as d,fq as e,gq as f,hq as g,iq as h,jq as i,kq as j,lq as k,mq as l,nq as m,oq as n,pq as o,qq as p,rq as q,sq as r,tq as s,uq as t,vq as u,wq as v,xq as w,yq as x}from"./chunk-kxtqbrfr.js";import"./chunk-caaenc3w.js";import"./chunk-amxtypkp.js";import"./chunk-nat3actx.js";import"./chunk-q0g5c39d.js";import"./chunk-kffndzch.js";import"./chunk-c2ta859c.js";import"./chunk-r8rbf28v.js";import"./chunk-gptwwv3c.js";import"./chunk-n66k2v2q.js";import"./chunk-vvd659y4.js";import"./chunk-7r80apc5.js";import"./chunk-2tjk867y.js";import"./chunk-t8ctvjqe.js";import"./chunk-deqnt1w5.js";import"./chunk-hzfd8cz0.js";import"./chunk-q569zmrr.js";import"./chunk-hyfjnn7g.js";export{e as validateTemplate,g as validateDirective,n as userComponentFileExists,m as transpileTypeScript,p as slotContentHasExpressions,k as shouldTranspileTypeScript,t as resolveTemplatePath,r as renderComponentWithSlot,j as isJavaScriptScript,o as isHydrateTrigger,d as hasVariables,h as hasDirectives,u as getSourceLineInfo,l as getSharedTranspiler,f as getPositionInfo,x as getComponentCacheStats,s as fileExists,a as extractVariables,c as extractScriptFromTemplate,i as extractDirectiveNames,v as createDetailedErrorMessage,b as convertToCommonJS,q as componentClientSignalNames,w as clearComponentCache};

package/dist/chunk-3ntf8f5e.js

@@ -1,2 +0,0 @@
-// @bun
-import{ji as a,ki as b}from"./chunk-ya5m5vbn.js";import"./chunk-hyfjnn7g.js";export{a as processTeleportDirectives,b as ensureTeleportTargets};

package/dist/chunk-4tnxnzja.js

@@ -1,2 +0,0 @@
-// @bun
-import{bl as a,cl as b,dl as c,el as d,fl as e}from"./chunk-zsnrcbw1.js";import"./chunk-hyfjnn7g.js";export{b as injectPwaTags,e as generateThemeColorMeta,c as generateSwRegistrationScript,a as generatePwaTags,d as generateManifestLink};

package/dist/chunk-63yfp05p.js

@@ -1,2 +0,0 @@
-// @bun
-import{bq as b,cq as c,dq as d,eq as e,yo as a}from"./chunk-kxtqbrfr.js";import"./chunk-caaenc3w.js";import"./chunk-amxtypkp.js";import"./chunk-nat3actx.js";import"./chunk-q0g5c39d.js";import"./chunk-kffndzch.js";import"./chunk-c2ta859c.js";import"./chunk-r8rbf28v.js";import"./chunk-gptwwv3c.js";import"./chunk-n66k2v2q.js";import"./chunk-vvd659y4.js";import"./chunk-7r80apc5.js";import"./chunk-2tjk867y.js";import"./chunk-t8ctvjqe.js";import"./chunk-deqnt1w5.js";import"./chunk-hzfd8cz0.js";import"./chunk-q569zmrr.js";import"./chunk-hyfjnn7g.js";export{d as validateClientScript,c as processOnceDirective,b as processJsonDirective,e as processDirectives,a as injectRouterScript};

package/dist/chunk-7y4eqkv4.js

@@ -1,2 +0,0 @@
-// @bun
-import{lt as a,mt as b}from"./chunk-amxtypkp.js";import"./chunk-hyfjnn7g.js";export{b as resolveStxTargets,a as looksLikeGlob};

package/dist/chunk-7ywnkv1f.js

@@ -1,2 +0,0 @@
-// @bun
-import{$i as e,Xi as a,Yi as b,Zi as c,_i as d,aj as f,bj as g,cj as h,dj as i,ej as j,fj as k,gj as l,hj as m,ij as n}from"./chunk-ymrxpwr8.js";import"./chunk-kxtqbrfr.js";import"./chunk-caaenc3w.js";import"./chunk-amxtypkp.js";import"./chunk-nat3actx.js";import"./chunk-q0g5c39d.js";import"./chunk-kffndzch.js";import"./chunk-c2ta859c.js";import"./chunk-r8rbf28v.js";import"./chunk-gptwwv3c.js";import"./chunk-n66k2v2q.js";import"./chunk-vvd659y4.js";import"./chunk-7r80apc5.js";import"./chunk-2tjk867y.js";import"./chunk-t8ctvjqe.js";import"./chunk-deqnt1w5.js";import"./chunk-hzfd8cz0.js";import"./chunk-q569zmrr.js";import"./chunk-hyfjnn7g.js";export{i as streamingSuspenseDirective,m as streamToResponse,g as streamTemplateSimple,a as streamTemplate,d as renderStreamingPage,k as registerStreamingDirectives,e as processStreamDirectives,l as processSectionDirectives,j as islandDirective,n as generateHydrationRuntime,f as extractStreamBoundaries,h as createStreamRenderer,b as buildSuspenseResolveScript,c as SUSPENSE_RESOLVER_RUNTIME};