@ohos-ports/stacksjs-stx 0.2.287-beta.0

package/dist/cli.js

@@ -0,0 +1,174 @@
+#!/usr/bin/env bun
+// @bun
+import{Ha as a,Te as F,Va as r,Ve as v,We as P,nb as n,o as m,oa as l,ob as p,pe as s,qb as i,qe as t,vb as e}from"./chunk-6hmnaza7.js";import"./chunk-19nfvxfw.js";import"./chunk-ferav3bw.js";import"./chunk-n3ggrhb3.js";import"./chunk-k56rjjc0.js";import"./chunk-vqxmxgaj.js";import"./chunk-mkd9kjgb.js";import"./chunk-7b329e5v.js";import"./chunk-pzm13sdc.js";import"./chunk-nx5qkm8k.js";import"./chunk-kxzb4et3.js";import"./chunk-bz820epz.js";import"./chunk-dhh5q7qt.js";import"./chunk-h4xh8cms.js";import"./chunk-qr82je1m.js";import"./chunk-rbb7dvja.js";import"./chunk-248e84r1.js";import"./chunk-w3ycm4na.js";import"./chunk-1kah92n2.js";import"./chunk-zqqx1qaj.js";import"./chunk-74cv4ta1.js";import"./chunk-wcm80anz.js";import"./chunk-y7m2dpd3.js";import"./chunk-9y0g8kzt.js";import"./chunk-t6nseeb9.js";import"./chunk-xttsqmkm.js";import"./chunk-54st8g2j.js";import"./chunk-nsp1cw38.js";import"./chunk-z4jhj5e5.js";import"./chunk-9n0gvfrg.js";import"./chunk-7q9mwh4v.js";import"./chunk-refwkt87.js";import"./chunk-kdh37tp8.js";import"./chunk-866y9d8b.js";import"./chunk-fed3xsp9.js";import"./chunk-a0nfbmeh.js";import"./chunk-9wr7zcad.js";import"./chunk-71t0yan0.js";import"./chunk-58f0mthg.js";import{cl as u,dl as c}from"./chunk-4ww3znrr.js";import"./chunk-y11cxbxd.js";import{Es as f}from"./chunk-92mj1t26.js";import"./chunk-8mjdpr94.js";import"./chunk-pkaabd8h.js";import"./chunk-xpp135ad.js";import{$s as A}from"./chunk-wrzwgkbx.js";import"./chunk-5kk8gsj2.js";import"./chunk-38ejahd9.js";import"./chunk-ypmqf7tm.js";import"./chunk-de7fye10.js";import"./chunk-v5e1gxwm.js";import"./chunk-b6ej2fdf.js";import"./chunk-x650vjcp.js";import{gv as B}from"./chunk-qc1f74ek.js";import{spawn as o}from"child_process";import L from"fs";import zb from"os";import $ from"path";import w from"process";import{CLI as wb}from"@stacksjs/clapp";var N="0.2.287";var __dirname="/home/runner/work/stx/stx/packages/stx/bin",E=new wb("stx");function h(J){let Z=typeof J==="string"?Number.parseInt(J,10):J;if(Number.isNaN(Z))return{isValid:!1,error:"Port must be a valid number",suggestion:"Try using a number between 1024 and 65535"};if(Z<1024||Z>65535)return{isValid:!1,error:"Port must be between 1024 and 65535",suggestion:"Try using a port between 1024 and 65535"};return{isValid:!0}}function d(J){try{if(!L.existsSync(J)){let K=$.dirname(J),x=$.basename(J);if(L.existsSync(K)){let z=L.readdirSync(K).filter((j)=>j.toLowerCase().includes(x.toLowerCase().substring(0,3))||j.endsWith(".stx")||j.endsWith(".md")),k=z.length>0?`File not found. Similar files in ${K}: ${z.slice(0,3).join(", ")}`:`File not found. Directory ${K} exists but doesn't contain the specified file.`;return{isValid:!1,error:`File does not exist: ${J}`,suggestion:k}}return{isValid:!1,error:`File does not exist: ${J}`,suggestion:"Check the file path and try again"}}if(L.statSync(J).isDirectory())return{isValid:!1,error:`Expected file but got directory: ${J}`,suggestion:"Specify a .stx or .md file path"};return{isValid:!0}}catch(Z){return{isValid:!1,error:`Cannot access file: ${J}`,suggestion:"Check file permissions and path"}}}function y(J){let Z=typeof J==="string"?Number.parseInt(J,10):J;if(Number.isNaN(Z))return{isValid:!1,error:"Timeout must be a valid number",suggestion:"Specify timeout in milliseconds (e.g., 5000 for 5 seconds)"};if(Z<100)return{isValid:!1,error:"Timeout too short (minimum 100ms)",suggestion:"Use a timeout of at least 100ms"};if(Z>300000)return{isValid:!1,error:"Timeout too long (maximum 5 minutes)",suggestion:"Use a timeout of less than 300000ms (5 minutes)"};return{isValid:!0}}var V=(J)=>J.includes("*")||J.includes("?")||J.includes("{")||J.includes("["),jb=(J)=>J.endsWith(".stx")||J.endsWith(".md");function S(J,Z=1){if(console.error(`\u274C ${J.error}`),J.suggestion)console.error(`\uD83D\uDCA1 suggestion: ${J.suggestion}`);w.exit(Z)}function kb(J){if(!J)return;let Z;try{Z=JSON.parse(J)}catch(K){console.error(`\u274C --info-plist is not valid JSON: ${K.message}`),w.exit(1)}if(typeof Z!=="object"||Z===null||Array.isArray(Z))console.error(`\u274C --info-plist must be a JSON object, e.g. '{"NSFocusStatusUsageDescription":"\u2026"}'`),w.exit(1);for(let[K,x]of Object.entries(Z))if(typeof x!=="string"&&typeof x!=="number"&&typeof x!=="boolean")console.error(`\u274C --info-plist value for "${K}" must be a string, number or boolean`),w.exit(1);return Z}async function Hb(J,Z){try{let K=["test"],x=[];if(J&&J.length>0)for(let W of J)if(V(W))try{let H=await Array.fromAsync(new Bun.Glob(W).scan({onlyFiles:!0,absolute:!0}));if(H.length===0)console.warn(`Warning: No files found matching pattern: ${W}`);else if(x.push(...H),Z.verbose)console.log(`Found ${H.length} file(s) matching pattern: ${W}`)}catch(H){return console.error(`Error expanding glob pattern ${W}:`,H),!1}else x.push(W);if(x.length===0)return console.error("Error: No test files found matching the provided patterns."),!1;if(K.push(...x),Z.filter)K.push("--pattern",Z.filter);if(Z.timeout)K.push("--timeout",Z.timeout.toString());if(Z.reporter&&Z.reporter!=="default")if(Z.reporter==="junit"){let W=$.join(zb.tmpdir(),`stx-test-report-${Date.now()}.xml`);K.push("--reporter",Z.reporter),K.push("--reporter-outfile",W)}else console.warn(`Warning: Reporter '${Z.reporter}' is not supported. Using default reporter.`);if(Z.coverage)K.push("--coverage");if(Z.watch)K.push("--watch");K.push("--preload",$.join(__dirname,"../../../test-utils/happy-dom.ts"));let b={...w.env,STX_TEST_MODE:"true",STX_TEST_UI:Z.ui?"true":"false",STX_TEST_VERBOSE:Z.verbose?"true":"false"},z="bun";if(Z.verbose)console.log(`Running: ${z} ${K.join(" ")}`);let k=performance.now(),j=o(z,K,{stdio:"inherit",shell:!1,env:b});return new Promise((W)=>{j.on("close",(H)=>{let Y=((performance.now()-k)/1000).toFixed(2);if(H===0)W(!0);else W(!1)}),w.on("SIGINT",()=>{console.log(`
+Test run interrupted`),j.kill("SIGINT"),w.exit(1)})})}catch(K){return console.error("Error running tests:",K instanceof Error?K.message:String(K)),!1}}var Qb=w.argv.length>=3&&(jb(w.argv[2])&&L.existsSync(w.argv[2])||V(w.argv[2]));if(Qb){let J=w.argv[2],Z={port:3000,watch:!0,cache:!0,markdown:{syntaxHighlighting:{enabled:!0,serverSide:!0,defaultTheme:"github-dark",highlightUnknownLanguages:!0}}};for(let K=3;K<w.argv.length;K++){let x=w.argv[K];if(x==="--port"&&K+1<w.argv.length){let b=h(w.argv[++K]);if(!b.isValid)S(b);Z.port=Number.parseInt(w.argv[K],10)}else if(x==="--no-watch")Z.watch=!1;else if(x==="--highlight-theme"&&K+1<w.argv.length){if(!Z.markdown)Z.markdown={};if(!Z.markdown.syntaxHighlighting)Z.markdown.syntaxHighlighting={};Z.markdown.syntaxHighlighting.defaultTheme=w.argv[++K]}else if(x==="--no-highlight"){if(!Z.markdown)Z.markdown={};if(!Z.markdown.syntaxHighlighting)Z.markdown.syntaxHighlighting={};Z.markdown.syntaxHighlighting.enabled=!1}else if(x==="--no-highlight-unknown"){if(!Z.markdown)Z.markdown={};if(!Z.markdown.syntaxHighlighting)Z.markdown.syntaxHighlighting={};Z.markdown.syntaxHighlighting.highlightUnknownLanguages=!1}else if(x==="--no-cache")Z.cache=!1;else if(x==="--native")Z.native=!0}if(V(J))try{let K=await Array.fromAsync(new Bun.Glob(J).scan({onlyFiles:!0,absolute:!0})),x=J.endsWith(".stx")?K.filter((j)=>j.endsWith(".stx")):J.endsWith(".md")?K.filter((j)=>j.endsWith(".md")):K.filter((j)=>j.endsWith(".stx")||j.endsWith(".md")),b=J.split("*")[0].replace(/\/$/,"")||".",z=$.resolve(b);try{let j=new Bun.Glob("**/*.stx"),H=(await Array.fromAsync(j.scan({cwd:z,onlyFiles:!0,absolute:!0}))).filter((U)=>/\[.+\]/.test($.basename(U)));for(let U of H)if(!x.includes(U))x.push(U)}catch{}if(x.length===0)console.error(`Error: No STX or Markdown files found matching pattern: ${J}`),w.exit(1);if(!await v(x,Z))w.exit(1)}catch(K){console.error("Failed to process files:",K),w.exit(1)}else F(J,Z).catch((K)=>{console.error("Failed to start dev server:",K),w.exit(1)})}else{let J=function(x,b){let z=[];for(let k=0;k<=b.length;k++)z[k]=[k];for(let k=0;k<=x.length;k++)z[0][k]=k;for(let k=1;k<=b.length;k++)for(let j=1;j<=x.length;j++)if(b.charAt(k-1)===x.charAt(j-1))z[k][j]=z[k-1][j-1];else z[k][j]=Math.min(z[k-1][j-1]+1,z[k][j-1]+1,z[k-1][j]+1);return z[b.length][x.length]};E.command("docs","Generate documentation for components, templates, and directives").option("--output <dir>","Output directory for documentation",{default:"docs"}).option("--format <format>","Documentation format (markdown, html, json)",{default:"markdown"}).option("--components-dir <dir>","Components directory",{default:"components"}).option("--templates-dir <dir>","Templates directory",{default:"."}).option("--no-components","Disable components documentation").option("--no-templates","Disable templates documentation").option("--no-directives","Disable directives documentation").option("--extra-content <content>","Extra content to include in documentation").example("stx docs --output docs --format html").action(async(x)=>{try{if(await r(x))console.log("Documentation generated successfully."),w.exit(0);else console.error("Documentation generation failed."),w.exit(1)}catch(b){console.error("Error generating documentation:",b),w.exit(1)}}),E.command("iconify <command>","Generate Iconify icon packages").option("--output <dir>","Output directory for generated packages",{default:"packages"}).option("--icons <icons>","Comma-separated list of specific icons to generate").example("stx iconify list").example("stx iconify generate mdi").example("stx iconify generate lucide --icons home,settings,user").action(async(x,b)=>{try{let{fetchCollections:z,generatePackage:k}=await import("./chunk-qzkhpsam.js");if(x==="list"){console.log(`
+\uD83D\uDCDA Fetching available icon collections...
+`);let j=await z(),W=Object.entries(j).sort((H,U)=>U[1].total-H[1].total);console.log(`Available collections:
+`);for(let[H,U]of W){let Y=U;console.log(`  ${H.padEnd(30)} ${Y.name} (${Y.total} icons)`)}console.log(`
+Total: ${W.length} collections`)}else if(x.startsWith("generate")){let j=x==="generate"?"":x.replace("generate:","").replace("generate-","").replace("generate","").trim();if(!j)console.error("Error: Please specify a collection prefix"),console.error("Usage: stx iconify generate <prefix> [--icons icon1,icon2,...]"),w.exit(1);let W=b.output||$.join(w.cwd(),"packages/collections"),H=b.icons?b.icons.split(",").map((U)=>U.trim()):void 0;await k(j,W,H),console.log(`
+\u2713 Package generated successfully!`),console.log(`
+To use the package:`),console.log(`  1. cd packages/collections/iconify-${j}`),console.log("  2. bun install"),console.log("  3. bun run build")}else console.error(`Unknown iconify command: ${x}`),console.error("Available commands: list, generate"),w.exit(1)}catch(z){console.error("Error:",z instanceof Error?z.message:String(z)),w.exit(1)}}),E.command("pwa <command>","PWA tools - audit configuration and build output").option("--output <dir>","Build output directory to audit",{default:"dist"}).example("stx pwa audit").example("stx pwa audit --output build").action(async(x,b)=>{try{if(x==="audit"){let{runPwaAudit:z,formatAuditResult:k}=await import("./chunk-tndhnk9e.js"),{loadConfig:j}=await import("./chunk-ydrz60kr.js");console.log(`
+\uD83D\uDD0D Running PWA audit...
+`);let W=await j(),H=b.output||"dist",U=z(W,H);if(console.log(k(U)),U.failed>0)w.exit(1)}else console.error(`Unknown pwa command: ${x}`),console.error("Available commands: audit"),w.exit(1)}catch(z){console.error("Error:",z instanceof Error?z.message:String(z)),w.exit(1)}}),E.command("dev [file]","Start a development server for an STX app or file").option("--port <port>","Port to use for the dev server",{default:3000}).option("--pages <dir>",'Directory containing page templates (default: pagesDir from stx.config.ts, else "pages")').option("--no-watch","Disable file watching and auto-reload").option("--native","Open in a native desktop window using Zyte").option("--titlebar-hidden","Hide the native titlebar but keep the traffic-light buttons (web content draws under a transparent full-size titlebar). Implies --native.").option("--highlight-theme <theme>","Syntax highlighting theme for Markdown code blocks",{default:"github-dark"}).option("--no-highlight","Disable syntax highlighting for Markdown code blocks").option("--no-highlight-unknown","Disable syntax highlighting for unknown languages in Markdown").option("--no-cache","Disable caching of parsed files").option("--no-hmr","Disable HMR / live-reload script injection (useful for clean network traces)").option("--profile","Print per-directive timing for every page render via performanceMonitor").option("--debug-directives","Log directive ordering and intermediate template state during rendering").example("stx dev").example("stx dev --port 8080").example("stx dev --pages src/pages").example("stx dev template.stx").example("stx dev components/hero.stx --port 8080").example("stx dev **/*.stx").example("stx dev docs/guide.md").example("stx dev template.stx --native").action(async(x,b)=>{try{if(b.port!==void 0){let k=h(b.port);if(!k.isValid)S(k);b.port=Number.parseInt(String(b.port),10)}if(b.timeout!==void 0){let k=y(b.timeout);if(!k.isValid)S(k)}let z={syntaxHighlighting:{enabled:b.highlight!==!1,serverSide:!0,defaultTheme:b.highlightTheme||"github-dark",highlightUnknownLanguages:b.highlightUnknown!==!1}};if(!x){if(!await P(".",{port:b.port,watch:b.watch!==!1,native:b.native||b.titlebarHidden||!1,titlebarHidden:b.titlebarHidden===!0,cache:b.cache!==!1,hotReload:b.hmr!==!1,profile:b.profile===!0,debugDirectives:b.debugDirectives===!0,...b.pages&&{pagesDir:b.pages}}))w.exit(1);return}if(!V(x))try{let k=await import("fs");if(k.existsSync(x)&&k.statSync(x).isDirectory()){if(!await P(x,{port:b.port,watch:b.watch!==!1,native:b.native||b.titlebarHidden||!1,titlebarHidden:b.titlebarHidden===!0,cache:b.cache!==!1,hotReload:b.hmr!==!1,profile:b.profile===!0,debugDirectives:b.debugDirectives===!0,...b.pages&&{pagesDir:b.pages}}))w.exit(1);return}}catch{}if(V(x)){console.log(`Expanding glob pattern: ${x}`);let k=await A.timeAsync("glob-expansion",async()=>{return Array.fromAsync(new Bun.Glob(x).scan({onlyFiles:!0,absolute:!0}))}),j=x.endsWith(".stx")?k.filter((Y)=>Y.endsWith(".stx")):x.endsWith(".md")?k.filter((Y)=>Y.endsWith(".md")):k.filter((Y)=>Y.endsWith(".stx")||Y.endsWith(".md"));if(j.length===0)console.error(`No STX or Markdown files found matching pattern: ${x}`),console.error("Try using patterns like '*.stx' or 'components/**/*.stx'"),w.exit(1);let W=x.split("*")[0].replace(/\/$/,"")||".",H=$.resolve(W);try{let Y=new Bun.Glob("**/*.stx"),X=(await Array.fromAsync(Y.scan({cwd:H,onlyFiles:!0,absolute:!0}))).filter((_)=>/\[.+\]/.test($.basename(_)));for(let _ of X)if(!j.includes(_))j.push(_)}catch{}if(console.log(`Found ${j.length} ${j.length===1?"file":"files"} matching ${x}`),!await v(j,{port:b.port,watch:b.watch!==!1,native:b.native||b.titlebarHidden||!1,titlebarHidden:b.titlebarHidden===!0,markdown:z,cache:b.cache!==!1}))w.exit(1)}else{if(!V(x)){let j=d(x);if(!j.isValid)S(j)}if(!await F(x,{port:b.port,watch:b.watch!==!1,native:b.native||b.titlebarHidden||!1,titlebarHidden:b.titlebarHidden===!0,markdown:z,cache:b.cache!==!1}))w.exit(1)}}catch(z){console.error("Error starting dev server:",z),w.exit(1)}}),E.command("a11y [target]","Scan .stx files for accessibility issues (directory, file, or glob)").option("--no-recursive","Disable recursive scanning of directories").option("--ignore <paths>","Comma-separated paths to ignore",{default:""}).option("--json","Output results as JSON").option("--output <file>","Write results to a file instead of stdout").option("--fix","Automatically fix common accessibility issues").example("stx a11y ./templates").example('stx a11y "resources/**/*.stx"').example("stx a11y resources/emails/welcome.stx").example("stx a11y --json --output a11y-report.json").action(async(x=".",b)=>{try{console.log(`Scanning ${x} for accessibility issues...`);let z=b.ignore?b.ignore.split(",").map((U)=>U.trim()):[],{results:k,scannedFiles:j}=await f(x,{recursive:b.recursive!==!1,ignorePaths:z});if(j.length===0)console.log(`
+  No .stx files matched ${x}
+`),w.exit(1);let W=Object.keys(k).length,H=Object.values(k).reduce((U,Y)=>U+Y.length,0);if(b.json){let U=JSON.stringify(k,null,2);if(b.output)await Bun.write(b.output,U),console.log(`A11y scan results written to ${b.output}`);else console.log(U)}else if(W===0)console.log(`\u2713 No accessibility issues found in ${j.length} file(s)!`);else{console.log(`Found ${H} accessibility issues in ${W} files:
+`);for(let[U,Y]of Object.entries(k)){let Q=$.relative(w.cwd(),U);console.log(`
+${Q} (${Y.length} issues):`);for(let X of Y){if(console.log(`  \u2022 ${X.impact.toUpperCase()}: ${X.message}`),console.log(`    ${X.help}`),X.helpUrl)console.log(`    More info: ${X.helpUrl}`);console.log(`    Element: ${X.element.substring(0,100)}${X.element.length>100?"...":""}`),console.log("")}}if(console.log(`
+Total: ${H} issues in ${W} files`),b.output){let U=`
+<!DOCTYPE html>
+<html lang="en">
+<head>
+  <meta charset="UTF-8">
+  <title>STX Accessibility Report</title>
+  <style>
+    body { font-family: system-ui, -apple-system, sans-serif; line-height: 1.6; max-width: 1200px; margin: 0 auto; padding: 20px; }
+    h1 { color: #333; }
+    .summary { margin-bottom: 30px; padding: 15px; background: #f5f5f5; border-radius: 5px; }
+    .file { margin-bottom: 30px; border: 1px solid #ddd; border-radius: 5px; overflow: hidden; }
+    .file-header { padding: 10px 15px; background: #eee; font-weight: bold; border-bottom: 1px solid #ddd; }
+    .issue { padding: 15px; border-bottom: 1px solid #eee; }
+    .issue:last-child { border-bottom: none; }
+    .issue-impact { display: inline-block; padding: 2px 8px; border-radius: 3px; font-size: 12px; font-weight: bold; color: white; margin-right: 10px; }
+    .critical { background-color: #d00; }
+    .serious { background-color: #f50; }
+    .moderate { background-color: #e90; }
+    .minor { background-color: #0a7; }
+    .issue-element { font-family: monospace; padding: 8px; background: #f5f5f5; margin-top: 10px; border-radius: 3px; overflow: auto; }
+    .help-url { font-size: 14px; }
+  </style>
+</head>
+<body>
+  <h1>STX Accessibility Report</h1>
+
+  <div class="summary">
+    <p>Found ${H} accessibility issues in ${W} files</p>
+    <p>Generated on ${new Date().toLocaleString()}</p>
+  </div>
+
+  ${Object.entries(k).map(([Y,Q])=>`
+    <div class="file">
+      <div class="file-header">${$.relative(w.cwd(),Y)} (${Q.length} issues)</div>
+      ${Q.map((X)=>`
+        <div class="issue">
+          <span class="issue-impact ${X.impact}">${X.impact.toUpperCase()}</span>
+          <strong>${X.message}</strong>
+          <p>${X.help}</p>
+          ${X.helpUrl?`<a class="help-url" href="${X.helpUrl}" target="_blank">More information</a>`:""}
+          <pre class="issue-element">${X.element.replace(/</g,"&lt;").replace(/>/g,"&gt;")}</pre>
+        </div>
+      `).join("")}
+    </div>
+  `).join("")}
+</body>
+</html>
+              `.trim();await Bun.write(b.output,U),console.log(`A11y scan results written to ${b.output}`)}}w.exit(H>0?1:0)}catch(z){console.error("Error scanning for accessibility issues:",z),w.exit(1)}}),E.command("components:build [input]","Compile .stx files into a progressive web component library").option("--out <dir>","Output directory",{default:"dist/components"}).option("--prefix <name>","Prefix for inferred custom-element tags",{default:"stx"}).option("--shadow","Use open Shadow DOM by default").option("--no-progressive","Always render client templates on connection").option("--no-manifest","Skip custom-elements.json generation").option("--no-types","Skip TypeScript and JSX declarations").option("--no-css","Skip CSS output").option("--no-bundle","Skip bundle.js generation").option("--no-minify","Do not minify bundle.js and CSS").option("--sourcemap","Generate an external bundle source map").example("stx components:build components --out dist --prefix acme").example("stx components:build src/components --shadow --sourcemap").action(async(x,b)=>{try{let z=await a({inputDir:x||"components",outputDir:b.out,prefix:b.prefix,shadowDOM:b.shadow?"open":!1,progressive:b.progressive!==!1,manifest:b.manifest!==!1,declarations:b.types!==!1,css:b.css!==!1,bundle:b.bundle!==!1,minify:b.minify!==!1,sourcemap:b.sourcemap?"external":!1});console.log(`Built ${z.components.length} web component${z.components.length===1?"":"s"} to ${$.resolve(b.out)}`),console.log(`Generated ${z.files.length} files (${(z.totalBytes/1024).toFixed(1)} kB)`);for(let k of z.components)console.log(`  ${k.tag} <- ${$.relative(w.cwd(),k.source)}`)}catch(z){console.error(`Component library build failed: ${z.message}`),w.exit(1)}}),E.command("build [input]","Generate static HTML files from STX templates (SSG)").option("--pages <dir>","Directory containing page templates",{default:"pages"}).option("--out <dir>","Output directory for generated files",{default:"dist"}).option("--domain <url>","Site domain for absolute URLs (e.g., https://example.com)").option("--base <path>","Base URL path for the site",{default:"/"}).option("--sitemap","Generate sitemap.xml",{default:!0}).option("--no-sitemap","Disable sitemap generation").option("--rss","Generate RSS feed").option("--minify","Minify HTML output",{default:!0}).option("--no-minify","Disable HTML minification").option("--no-cache","Disable build caching").option("--clean","Clean output directory before build",{default:!0}).option("--no-clean","Keep existing files in output directory").option("--concurrency <n>","Parallel page generation limit",{default:"10"}).option("--public <dir>","Directory with static assets to copy",{default:"public"}).option("--trailing-slash","Add trailing slashes to URLs").option("--verbose","Show detailed build output").option("--port <number>","Development server port for preview").option("--timeout <ms>","Build timeout in milliseconds").example("stx build").example("stx build --pages src/pages --out public").example("stx build --domain https://example.com --sitemap").example("stx build --no-minify --verbose").action(async(x,b)=>{try{let z=performance.now();if(b.port!==void 0){let Y=Number.parseInt(b.port,10);if(Y<1024||Y>65535){if(Y<1024)console.error(`
+  Port must be between 1024 and 65535`),console.error(`
+  suggestion: Try using a port between 1024 and 65535 (e.g., --port 3000)`);else console.error(`
+  Port must be between 1024 and 65535`);w.exit(1)}}if(b.timeout!==void 0){let Y=Number.parseInt(b.timeout,10);if(Number.isNaN(Y))console.error(`
+  Timeout must be a valid number`),w.exit(1)}if(x){let Y=$.resolve(x);if(!L.existsSync(Y))console.error(`
+  File not found: ${x}`),w.exit(1);if(!x.endsWith(".stx"))console.error(`
+  File must have .stx extension: ${x}`),w.exit(1)}let k=$.resolve(b.pages),j=$.resolve(b.out);if(!x&&!L.existsSync(k))console.error(`
+  Pages directory not found: ${k}`),console.log(`
+  Create a 'pages' directory with .stx files, or use --pages to specify a different directory.`),w.exit(1);let{buildApp:W}=await import("./chunk-gtcrpmz1.js");c();let H=await W({root:x?$.dirname(x):void 0,debug:b.verbose,ssg:{pagesDir:b.pages,outputDir:b.out,domain:b.domain,baseUrl:b.base,sitemap:b.sitemap,rss:b.rss,minify:b.minify,cache:b.cache!==!1,cleanOutput:b.clean,concurrency:Number.parseInt(b.concurrency,10)||10,publicDir:b.public,trailingSlash:b.trailingSlash,generate404:!0,hooks:b.verbose?{onPageStart:(Y)=>console.log(`    Generating: ${Y}`),onPageEnd:(Y,Q)=>console.log(`    Generated: ${Y} (${Q.length} bytes)`),onError:(Y,Q)=>console.error(`    Error in ${Q}: ${Y.message}`)}:void 0},ssr:{outputDir:b.out==="dist"?".output":b.out,debug:b.verbose}}),U=((performance.now()-z)/1000).toFixed(2);if(H.mode==="ssr"&&H.ssr)console.log(`
+  Build complete! (SSR)
+`),console.log(`    Pages compiled: ${H.ssr.pageCount}`),console.log(`    Output: ${H.ssr.outputDir}`),console.log(`    Duration: ${U}s
+`);else if(H.ssg){if(console.log(`
+  Build complete! (SSG)
+`),console.log(`    Pages generated: ${H.ssg.successCount}`),H.ssg.failedCount>0)console.log(`    Failed: ${H.ssg.failedCount}`);if(H.ssg.cachedCount>0)console.log(`    From cache: ${H.ssg.cachedCount}`);if(H.ssg.sitemapPath)console.log(`    Sitemap: ${$.relative(w.cwd(),H.ssg.sitemapPath)}`);if(H.ssg.rssPath)console.log(`    RSS: ${$.relative(w.cwd(),H.ssg.rssPath)}`);if(console.log(`    Build time: ${U}s`),console.log(`    Output: ${$.relative(w.cwd(),b.out||"dist")}/
+`),H.ssg.errors.length>0){console.log("  Errors:");for(let Q of H.ssg.errors)console.error(`    ${Q.route}: ${Q.error}`);console.log("")}if(b.verbose&&H.ssg.pages.length>0&&H.ssg.pages.length<=20){console.log("  Generated pages:");for(let Q of H.ssg.pages){let X=$.relative(w.cwd(),Q.outputPath),_=(Q.size/1024).toFixed(1);console.log(`    ${X} (${_} KB)${Q.cached?" [cached]":""}`)}console.log("")}let Y=u();if(Y.length>0){console.error(`
+  ${Y.length} client script(s) failed to bundle:
+`);for(let Q of Y)console.error(`    ${$.relative(w.cwd(),Q.filePath)}
+      ${Q.message}
+`);console.error(`  The unbundled source would have been shipped. Refusing to report success.
+`),w.exit(1)}if(H.ssg.failedCount>0)console.error(`
+  Build completed with ${H.ssg.failedCount} error(s). Fix the issues above and try again.
+`),w.exit(1);console.log("  To preview locally:"),console.log(`    cd ${b.out||"dist"} && npx serve
+`)}}catch(z){console.error(`
+  Build failed:`,z instanceof Error?z.message:String(z)),w.exit(1)}}),E.command("start","Start the production server (serves pre-built .output/)").option("--port <number>","Server port",{default:"3000"}).option("--output <dir>","Output directory from stx build",{default:".output"}).example("stx start").example("stx start --port 8080").action(async(x)=>{try{let b=$.resolve(x.output);if(!L.existsSync($.join(b,"manifest.json")))console.error("\n  No production build found. Run `stx build --out .output` first.\n"),w.exit(1);let{startProductionServer:z}=await import("./chunk-p3242nck.js");await z({outputDir:b,port:Number.parseInt(x.port,10)||3000})}catch(b){console.error(`
+  Failed to start production server:`,b instanceof Error?b.message:String(b)),w.exit(1)}}),E.command("deploy [directory]","Deploy built site to Netlify").option("--site-id <id>","Netlify site ID (or set NETLIFY_SITE_ID env var)").option("--token <token>","Auth token (or set NETLIFY_AUTH_TOKEN env var)").option("--production","Deploy to production (default: draft preview)").option("--message <msg>","Deploy message/title").option("--no-build","Skip build step before deploy").option("--open","Open deployed URL in browser").option("--dry-run","Preview deployment without uploading").option("--init","Initialize Netlify configuration for this project").example("stx deploy").example("stx deploy --production").example("stx deploy dist --site-id my-site-abc123").example("stx deploy --init").example("stx deploy --dry-run").action(async(x,b)=>{try{let{deploy:z,initNetlify:k,DeployError:j}=await import("./chunk-btav940g.js");if(console.log(`\x1B[1mstx deploy\x1B[0m \x1B[2mv${N}\x1B[0m`),b.init){console.log(`
+\uD83D\uDCDD Initializing Netlify configuration...
+`);let H=await k({directory:x||w.cwd(),siteId:b.siteId});if(console.log(`\u2713 Created ${H.configPath}`),H.siteId)console.log("\u2713 Saved site ID to .env.local");console.log(`
+You can now deploy with: stx deploy`);return}if(b.build!==!1){if(console.log(`
+\uD83D\uDD28 Building project...`),await Bun.spawn(["bun","run","build"],{stdio:["inherit","inherit","inherit"],cwd:w.cwd()}).exited!==0)console.error("\u274C Build failed"),w.exit(1);console.log(`\u2713 Build complete
+`)}console.log(`\uD83D\uDE80 Deploying to Netlify...
+`);let W=await z({directory:x||"dist",siteId:b.siteId,token:b.token,production:b.production,message:b.message,build:!1,open:b.open,dryRun:b.dryRun,onProgress:(H)=>{if(H.stage==="upload"&&H.percent!==void 0){if(w.stdout.write(`\r  Uploading: ${H.percent}%`),H.percent===100)w.stdout.write(`
+`)}}});if(W.success){if(console.log(`
+\u2713 Deployed successfully!
+`),console.log(`  ${b.dryRun?"Would deploy":"Draft URL"}:  ${W.url}`),W.siteUrl)console.log(`  Site URL:   ${W.siteUrl}`);if(!b.dryRun)console.log(`
+  Deploy ID:  ${W.deployId}`),console.log(`  Duration:   ${(W.duration/1000).toFixed(1)}s`),console.log(`  Files:      ${W.filesUploaded}`)}}catch(z){if(z instanceof Error&&z.name==="DeployError")console.error(`
+\u274C ${z.message}`),w.exit(1);console.error(`
+\u274C Deploy failed:`,z instanceof Error?z.message:String(z)),w.exit(1)}}),E.command("images <input>","Optimize images for production").option("-o, --output <dir>","Output directory",{default:"dist/images"}).option("-w, --widths <sizes>","Output widths (comma-separated)",{default:"320,640,768,1024,1280,1536,1920"}).option("-f, --formats <types>","Output formats (comma-separated)",{default:"webp,jpeg"}).option("-q, --quality <n>","Output quality (1-100)",{default:"80"}).option("--placeholder <type>","Placeholder type: blur, dominant-color, none",{default:"none"}).option("--dry-run","Preview without processing").option("--verbose","Show detailed output").example("stx images public/images").example("stx images public/images -o dist/images").example("stx images public/images --widths 640,1024,1920").example("stx images public/images --formats webp,avif").example("stx images public/images --quality 85").example("stx images public/images --dry-run").action(async(x,b)=>{try{let{optimizeDirectory:z,isSharpAvailable:k,formatSize:j}=await import("./chunk-csbgwaa5.js"),W=await import("fs"),H=await import("path");if(console.log(`\x1B[1mstx images\x1B[0m \x1B[2mv${N}\x1B[0m`),!await k())console.error(`
+\u274C sharp is required for image optimization.`),console.log(`
+Install sharp with:`),console.log("  bun add sharp"),w.exit(1);let Y=b.widths.split(",").map((G)=>Number.parseInt(G.trim(),10)).filter((G)=>!Number.isNaN(G)),Q=b.formats.split(",").map((G)=>G.trim().toLowerCase()),X=Number.parseInt(b.quality,10)||80,_=b.placeholder,q=H.resolve(x);if(!W.existsSync(q))console.error(`
+\u274C Input directory not found: ${q}`),w.exit(1);if(!W.statSync(q).isDirectory())console.error(`
+\u274C Input must be a directory: ${q}`),w.exit(1);if(console.log(`
+\uD83D\uDCF8 Input:   ${q}`),console.log(`\uD83D\uDCC1 Output:  ${H.resolve(b.output)}`),console.log(`\uD83D\uDCD0 Widths:  ${Y.join(", ")}`),console.log(`\uD83C\uDFA8 Formats: ${Q.join(", ")}`),console.log(`\u2728 Quality: ${X}`),b.dryRun){console.log(`
+\uD83D\uDD0D Dry run mode - no files will be written
+`);let G=async(T)=>{let C=[],R=await W.promises.readdir(T,{withFileTypes:!0});for(let D of R){let g=H.join(T,D.name);if(D.isDirectory())C.push(...await G(g));else if(/\.(jpg|jpeg|png|webp|avif|gif)$/i.test(D.name))C.push(g)}return C},I=await G(q);console.log(`Found ${I.length} images:`);for(let T of I){let C=H.relative(q,T),R=W.statSync(T);console.log(`  ${C} (${j(R.size)})`)}let bb=I.length*Y.length*Q.length;console.log(`
+Would generate ~${bb} image variants`);return}console.log(`
+\u23F3 Optimizing images...
+`);let M=await z(q,b.output,{widths:Y,formats:Q,quality:X,placeholder:_,verbose:b.verbose});if(console.log(`
+\u2713 Optimization complete!
+`),console.log(`  Images processed: ${M.stats.optimizedImages}/${M.stats.totalImages}`),console.log(`  Variants created: ${M.stats.variants}`),M.stats.savedBytes>0)console.log(`  Estimated savings: ~${j(M.stats.savedBytes)}`)}catch(z){console.error(`
+\u274C Image optimization failed:`,z instanceof Error?z.message:String(z)),w.exit(1)}}),E.command("bundle [directory]","Analyze bundle size and composition").option("-o, --output <file>","Output file path").option("--json","Output as JSON").option("--text","Output as text summary").option("--markdown","Output as Markdown").option("--no-open","Do not open HTML report in browser").option("--no-gzip","Do not show gzip sizes").option("--threshold <size>","Fail if total size exceeds threshold (e.g., 500KB, 1MB)").option("--top <n>","Number of top modules to show",{default:"20"}).example("stx bundle").example("stx bundle dist/").example("stx bundle dist/ --json").example("stx bundle dist/ --text").example("stx bundle dist/ --threshold 500KB").example("stx bundle dist/ --no-open").action(async(x,b)=>{try{let{analyze:z,formatBytes:k,parseSize:j}=await import("./chunk-5w1e3yxs.js"),W=await import("path");console.log(`\x1B[1mstx bundle\x1B[0m \x1B[2mv${N}\x1B[0m`);let H=x||"dist",U=W.resolve(H);if(!(await import("fs")).existsSync(U))console.error(`
+\u274C Directory not found: ${U}`),console.log("\nRun `stx build` first to generate build output."),w.exit(1);let Q="html";if(b.json)Q="json";else if(b.text)Q="text";else if(b.markdown)Q="markdown";console.log(`
+\uD83D\uDCE6 Analyzing: ${U}`);let X=await z({directory:U,output:b.output,format:Q,open:b.open!==!1&&Q==="html",gzip:b.gzip!==!1,threshold:b.threshold,topModules:Number.parseInt(b.top||"20",10),recommendations:!0});if(Q==="html"){if(console.log(`
+\u2713 Report generated: ${X.outputPath}`),b.open!==!1)console.log("  Opening in browser...")}else console.log(X.report);if(X.exceedsThreshold){let _=b.threshold;console.error(`
+\u274C Bundle size (${k(X.stats.totalSize)}) exceeds threshold (${_})`),w.exit(1)}if(Q==="html"){if(console.log(`
+\uD83D\uDCCA Summary:`),console.log(`   Total Size:  ${k(X.stats.totalSize)}`),console.log(`   Gzip Size:   ${k(X.stats.totalGzipSize)}`),console.log(`   Modules:     ${X.stats.moduleCount}`),console.log(`   Chunks:      ${X.stats.chunks.length}`),X.stats.duplicates.length>0)console.log(`   Duplicates:  ${X.stats.duplicates.length}`)}}catch(z){console.error(`
+\u274C Bundle analysis failed:`,z instanceof Error?z.message:String(z)),w.exit(1)}}),E.command("test [patterns...]","Run tests with Bun test runner and browser environment").option("--watch","Watch for changes and rerun tests").option("--filter <pattern>","Only run tests matching the given pattern").option("--reporter <reporter>","Test reporter to use: default or junit (junit requires Bun v1.0+)",{default:"default"}).option("--timeout <ms>","Test timeout in milliseconds",{default:5000}).option("--coverage","Enable code coverage").option("--ui","Coming soon").option("--verbose","Show verbose output including test command").example("stx test").example("stx test packages/stx/test/").example("stx test **/*.test.ts --verbose").example('stx test --filter "should process"').example("stx test --watch --verbose").example("stx test --reporter junit").action(async(x,b)=>{try{if(console.log(`\x1B[1mstx test\x1B[0m \x1B[2mv${N} (${e})\x1B[0m`),b.timeout){let j=y(b.timeout);if(!j.isValid)S(j)}let z=typeof x==="string"?[x]:x||[];if(z.length===0)z.push("**/*.test.ts","**/*.test.js","**/*.spec.ts","**/*.spec.js");if(b.verbose)console.log("Test patterns:",z),console.log("Options:",JSON.stringify({watch:b.watch||!1,filter:b.filter||"none",reporter:b.reporter||"default",timeout:b.timeout||5000,coverage:b.coverage||!1,ui:b.ui||!1},null,2));if(!await A.timeAsync("test-execution",()=>Hb(z,b))&&!b.watch)w.exit(1)}catch(z){console.error("Error running tests:",z),w.exit(1)}}),E.command("init [file]","Create a new STX file").alias("new").option("--force","Overwrite existing file").option("--template <file>","Path to a template file to use as a base").example("stx init").example("stx init page.stx").example("stx new contact.stx").example("stx new components/button.stx --template examples/components/button.stx").action(async(x="index.stx",b)=>{try{if(await i(x,{force:b.force,template:b.template}))console.log(`
+\u2728 Successfully created file: ${x}`),console.log(`
+To view it in the development server:`),console.log(`  stx dev ${x}
+`);else console.error(`
+\u274C Failed to create file: ${x}`),w.exit(1)}catch(z){console.error("Error creating file:",z),w.exit(1)}}),E.command("format [patterns...]","Format STX and Markdown files automatically").option("--check","Check if files are formatted (exit with error if not)").option("--write","Write formatted files back to disk (default)").option("--diff","Show diff of changes that would be made").option("--ignore <patterns>","Comma-separated patterns to ignore").example("stx format").example("stx format **/*.stx").example("stx format **/*.md").example("stx format **/*.{stx,md}").example("stx format --check").example("stx format --diff --ignore node_modules/**").action(async(x,b)=>{try{if(b.check&&b.write)console.error("\u274C Options --check and --write are mutually exclusive"),console.error("\uD83D\uDCA1 Use --check to verify formatting or --write to apply changes, but not both"),w.exit(1);let z=x&&x.length>0?x:["**/*.stx","**/*.md"],k=b.ignore?b.ignore.split(",").map((Q)=>Q.trim()):["node_modules/**","dist/**",".git/**"],j=[];for(let Q of z){let X=await Array.fromAsync(new Bun.Glob(Q).scan({onlyFiles:!0,absolute:!0}));j.push(...X.filter((_)=>_.endsWith(".stx")||_.endsWith(".md")))}if(j=j.filter((Q)=>{return!k.some((X)=>{let _=X.replace(/\*\*/g,".*").replace(/\*/g,"[^/]*");return new RegExp(_).test(Q)})}),j.length===0){console.log("No STX or Markdown files found to format.");return}let W=j.filter((Q)=>Q.endsWith(".stx")),H=j.filter((Q)=>Q.endsWith(".md"));console.log(`Formatting ${j.length} files (${W.length} .stx, ${H.length} .md)...`);let U=0,Y=0;for(let Q of j)try{let X=await Bun.file(Q).text(),q=Q.endsWith(".md")?p(X):n(X);if(X!==q)if(b.check)console.log(`\u274C ${$.relative(w.cwd(),Q)} needs formatting`),Y++;else if(b.diff)console.log(`
+\uD83D\uDCDD ${$.relative(w.cwd(),Q)}:`),console.log("--- Original"),console.log("+++ Formatted"),console.log(`@@ Changes in ${$.basename(Q)} @@`),console.log("+ Formatted content would be applied");else await Bun.write(Q,q),console.log(`\u2705 Formatted ${$.relative(w.cwd(),Q)}`),U++}catch(X){console.error(`\u274C Error formatting ${$.relative(w.cwd(),Q)}:`,X),Y++}if(b.check&&Y>0)console.log(`
+${Y} files need formatting. Run 'stx format' to fix.`),w.exit(1);else if(!b.check&&!b.diff)console.log(`\u2728 Formatted ${U} files successfully`)}catch(z){console.error("Error formatting files:",z),w.exit(1)}}),E.command("perf [command...]","Show performance statistics for STX operations").option("--clear","Clear performance statistics").option("--json","Output as JSON").example("stx perf").example("stx perf --clear").example("stx perf --json").action(async(x,b)=>{try{if(b.clear){A.clear(),console.log("\u2705 Performance statistics cleared");return}let z=A.getStats();if(Object.keys(z).length===0){if(b.json){console.log(JSON.stringify({},null,2));return}console.log("No performance data available. Run some STX commands first.");return}if(b.json)console.log(JSON.stringify(z,null,2));else{console.log(`
+\uD83D\uDCCA STX Performance Statistics
+`);for(let[k,j]of Object.entries(z))console.log(`\uD83D\uDD27 ${k}:`),console.log(`   Count: ${j.count}`),console.log(`   Average: ${j.avgTime.toFixed(2)}ms`),console.log(`   Total: ${j.totalTime.toFixed(2)}ms`),console.log(`   Min: ${j.minTime.toFixed(2)}ms`),console.log(`   Max: ${j.maxTime.toFixed(2)}ms`),console.log("")}}catch(z){console.error("Error showing performance stats:",z),w.exit(1)}}),E.command("typecheck [patterns...]","Type-check the TypeScript inside .stx script blocks").option("--no-client","Skip <script client> and bare <script> blocks").option("--no-server","Skip <script server> blocks").option("--no-templates","Skip {{ }} and directive expressions in the markup").option("--lib <path>","Extra ambient declaration file (repeatable)").example("stx typecheck").example('stx typecheck "resources/views/**/*.stx"').action(async(x,b)=>{let{formatTypecheckDiagnostics:z,typecheckStxFiles:k}=await import("./chunk-p98kfh94.js"),{resolveStxTargets:j}=await import("./chunk-h8yqsz9m.js"),W=Array.isArray(x)?x:x?[x]:[],H=W.length?W:["**/*.stx"],U=await j(H);if(U.length===0){console.log(`
+  No .stx files matched ${H.join(", ")}
+`);return}let Y=m(w.argv,"--lib"),Q=Y.length>0?Y:b.lib?Array.isArray(b.lib)?b.lib:[b.lib]:[],X=await k(U,{client:b.client!==!1,server:b.server!==!1,templates:b.templates!==!1,extraLibs:Q});if(X.failure)console.error(`
+  Type-check did not run.
+
+  ${X.failure.split(`
+`).join(`
+  `)}
+`),w.exit(2);let _=X.diagnostics.filter((q)=>q.category==="error");if(X.diagnostics.length>0)console.error(`
+${z(X.diagnostics)}
+`);if(console.log(`  Checked ${X.blockCount} script block(s) and ${X.expressionCount} template expression(s) in ${X.checkedFiles.length} file(s) \u2014 `+`${_.length} error(s), ${X.diagnostics.length-_.length} warning(s)
+`),_.length>0)w.exit(1)}),E.command("codemod [patterns...]","Find hand-rolled code that an stx primitive already covers").option("--fix","Write the safe rewrites (default is report-only)").option("--rule <rule>","Run one rule only: confirm | tooltip (rewritable) \xB7 alert | route-params | search-params | navigate | "+"fetch | polling | debounce | click-outside | focus | clipboard | watch (report-only)").example("stx codemod").example("stx codemod --rule route-params").example('stx codemod --fix "resources/views/**/*.stx"').action(async(x,b)=>{let{codemodSource:z,formatCodemodFindings:k}=await import("./chunk-nkb3scg6.js"),j=globalThis.Bun.Glob,W=Array.isArray(x)?x:x?[x]:[],H=W.length?W:["**/*.stx","**/*.ts"],U=b.rule?[b.rule]:void 0;if(b.rule&&b.rule!=="confirm"&&b.rule!=="tooltip")console.error(`Unknown rule "${b.rule}". Expected: confirm | tooltip`),w.exit(1);let Y=new Set,Q=[],X=0,_=new Set;try{let q=Bun.spawnSync(["git","ls-files","--others","--ignored","--exclude-standard","-z"],{cwd:w.cwd(),stdout:"pipe",stderr:"pipe"});for(let O of new TextDecoder().decode(q.stdout).split("\x00"))if(O)_.add($.resolve(w.cwd(),O))}catch{}for(let q of H)for await(let O of new j(q).scan({cwd:w.cwd(),absolute:!0})){if(O.includes("/node_modules/")||O.includes("/dist/")||Y.has(O)||_.has(O))continue;Y.add(O);let M=await Bun.file(O).text(),G=z(M,{file:O,rules:U});if(Q.push(...G.findings),b.fix&&G.code!==M)await Bun.write(O,G.code),X++}if(console.error(k(Q,Boolean(b.fix))),b.fix)console.error(`
+${X} file(s) written.`)}),E.command("doctor","Diagnose the stx framework-runtime resolution + staleness chain").option("--json","Output the report as JSON").example("stx doctor").example("stx doctor --json").action(async(x)=>{try{let b;try{b=(await import("./chunk-zg75gjns.js")).generateSignalsRuntime}catch{b=void 0}let z=await s({generateRuntime:b});if(x.json)console.log(JSON.stringify(z,null,2));else console.log(t(z));if(!z.ok)w.exit(1)}catch(b){console.error("Error running doctor:",b),w.exit(1)}}),E.command("debug <file>","Debug STX template processing step by step").option("--step","Step through processing stages interactively").option("--verbose","Show detailed processing information").option("--context <data>","JSON string of context data to use").option("--save-report <file>","Save debug report to file").example("stx debug template.stx").example("stx debug template.stx --step").example(`stx debug template.stx --context '{"name": "John", "items": [1,2,3]}'`).action(async(x,b)=>{try{let z=d(x);if(!z.isValid)S(z);console.log(`\uD83D\uDD0D Debugging stx template: ${x}
+`);let k={};if(b.context)try{k=JSON.parse(b.context)}catch(H){console.error("\u274C Invalid JSON in --context option"),w.exit(1)}let j=await Bun.file(x).text();console.log(`\uD83D\uDCC4 Template Content (${j.length} chars):`),console.log("\u2500".repeat(50)),console.log(j.substring(0,500)+(j.length>500?`
+...
+`:"")),console.log("\u2500".repeat(50));let W=j.match(/<script\b[^>]*>([\s\S]*?)<\/script>/i);if(W)console.log(`
+\uD83D\uDCDC Script Section Found:`),console.log("\u2500".repeat(30)),console.log(W[1].trim()),console.log("\u2500".repeat(30));if(console.log(`
+\uD83D\uDCCA Processing Context:`),console.log(JSON.stringify(k,null,2)),b.step)console.log(`
+\u26A0\uFE0F  Interactive step-through not yet implemented. Use --verbose for detailed output.`);if(b.verbose)console.log(`
+\uD83D\uDD27 Verbose processing information will be shown during template processing.`);if(console.log(`
+\u2728 Debug analysis complete. Full step-by-step debugging coming soon!`),b.saveReport){let H={file:x,timestamp:new Date().toISOString(),templateLength:j.length,hasScript:!!W,context:k};await Bun.write(b.saveReport,JSON.stringify(H,null,2)),console.log(`\uD83D\uDCCB Debug report saved to: ${b.saveReport}`)}}catch(z){console.error("Error debugging template:",z),w.exit(1)}}),E.command("status [directory]","Show status of STX project and files").option("--verbose","Show detailed information").option("--json","Output as JSON").example("stx status").example("stx status ./src --verbose").action(async(x=".",b)=>{try{let z=$.resolve(x),k=$.join(z,"stx.config.ts"),j=$.join(z,"package.json"),W=await Array.fromAsync(new Bun.Glob("**/*.stx").scan({cwd:z,onlyFiles:!0,absolute:!0})),H=await Array.fromAsync(new Bun.Glob("**/*.md").scan({cwd:z,onlyFiles:!0,absolute:!0})),U={projectRoot:z,hasConfig:L.existsSync(k),hasPackageJson:L.existsSync(j),stxFiles:W.length,markdownFiles:H.length,totalFiles:W.length+H.length};if(b.verbose)U.stxFileList=W.map((Y)=>$.relative(z,Y)),U.markdownFileList=H.map((Y)=>$.relative(z,Y));if(b.json)console.log(JSON.stringify(U,null,2));else{if(console.log(`
+\uD83D\uDCCB stx Project Status
+`),console.log(`\uD83D\uDCC1 Project Root: ${z}`),console.log(`\u2699\uFE0F  Config File: ${U.hasConfig?"\u2705 Found":"\u274C Not found"}`),console.log(`\uD83D\uDCE6 Package.json: ${U.hasPackageJson?"\u2705 Found":"\u274C Not found"}`),console.log(`\uD83D\uDCC4 stx Files: ${U.stxFiles}`),console.log(`\uD83D\uDCDD Markdown Files: ${U.markdownFiles}`),console.log(`\uD83D\uDCCA Total Files: ${U.totalFiles}`),b.verbose&&W.length>0)console.log(`
+\uD83D\uDCC4 STX Files:`),W.forEach((Y)=>{console.log(`   ${$.relative(z,Y)}`)});if(b.verbose&&H.length>0)console.log(`
+\uD83D\uDCDD Markdown Files:`),H.forEach((Y)=>{console.log(`   ${$.relative(z,Y)}`)})}}catch(z){console.error("Error getting project status:",z),w.exit(1)}}),E.command("watch [patterns...]","Watch STX files for changes and run commands").option("--command <cmd>","Command to run on file changes",{default:"build"}).option("--ignore <patterns>","Comma-separated patterns to ignore").option("--debounce <ms>","Debounce delay before running command after change",{default:300}).option("--output <dir>","Output directory for command results").option("--verbose","Show detailed file change information").option("--clear","Clear console before running command").example("stx watch").example('stx watch **/*.stx --command "stx build"').example('stx watch --ignore "node_modules/**,dist/**"').action(async(x,b)=>{try{if(!x||x.length===0)console.error("\u274C Input file or pattern is required"),console.error("\uD83D\uDCA1 Specify a file pattern to watch (e.g., stx watch *.stx)"),w.exit(1);let z=Array.isArray(x)?x:[x],k=b.ignore?b.ignore.split(",").map((_)=>_.trim()):["node_modules/**","dist/**",".git/**"];if(b.debounce!==void 0){if(!y(b.debounce).isValid)console.error("\u274C Debounce must be a valid number"),console.error("\uD83D\uDCA1 Specify debounce in milliseconds (e.g., --debounce 300)"),w.exit(1)}if(b.output){if((b.output.match(/\.\.\//g)||[]).length>=3)console.error("\u274C Invalid output directory"),console.error("\uD83D\uDCA1 Specify a valid output directory path"),w.exit(1)}let j=b.debounce||300;console.log(`\uD83D\uDC40 Watching files: ${z.join(", ")}`),console.log(`\uD83D\uDEAB Ignoring: ${k.join(", ")}`),console.log(`\u23F1\uFE0F  Debounce: ${j}ms`),console.log(`\uD83D\uDD27 Command: ${b.command}`),console.log(`
+Press Ctrl+C to stop watching...
+`);let W,H=!1,U=new Set;U.add(w.cwd());for(let _ of z)(await Array.fromAsync(new Bun.Glob(_).scan({onlyFiles:!0,absolute:!0}))).forEach((O)=>{U.add($.dirname(O))});let Y=async()=>{if(H)return;if(H=!0,b.clear)console.clear();console.log(`\uD83D\uDD04 Running: ${b.command}`);let _=Date.now();try{let[q,...O]=b.command.split(" ");o(q,O,{stdio:"inherit",shell:!0}).on("close",(G)=>{let I=Date.now()-_;if(G===0)console.log(`\u2705 Command completed successfully in ${I}ms`);else console.log(`\u274C Command failed with exit code ${G} after ${I}ms`);H=!1})}catch(q){console.error("\u274C Error running command:",q),H=!1}},Q=(_,q)=>{if(!q)return;if(k.some((G)=>{if(G.includes("*"))return q.match(G.replace(/\*/g,".*"));return q.includes(G)})){if(b.verbose)console.log(`\uD83D\uDEAB Ignoring: ${q}`);return}if(!z.some((G)=>{if(G.includes("*"))return q.match(G.replace(/\*/g,".*"));return q.endsWith(G)})){if(b.verbose)console.log(`\u23ED\uFE0F  Skipping: ${q} (doesn't match patterns)`);return}if(b.verbose)console.log(`\uD83D\uDCDD ${_.toUpperCase()}: ${q}`);if(W)clearTimeout(W);W=setTimeout(Y,j)},X=[];for(let _ of U)try{let q=L.watch(_,{recursive:!0},Q);if(X.push(q),b.verbose)console.log(`\uD83D\uDCC1 Watching directory: ${_}`)}catch(q){console.warn(`\u26A0\uFE0F  Could not watch directory: ${_}`)}w.on("SIGINT",()=>{console.log(`
+\uD83D\uDED1 Stopping file watcher...`),X.forEach((_)=>_.close()),w.exit(0)})}catch(z){console.error("Error setting up file watcher:",z),w.exit(1)}}),E.command("analyze [patterns...]","Analyze STX templates for performance and best practices").option("--json","Output results as JSON").option("--detailed","Show detailed analysis for each file").option("--only-issues","Only show files with issues").option("--save-report <file>","Save analysis report to file").option("--threshold <level>","Only show issues at or above this level (info, warning, error)",{default:"info"}).example("stx analyze").example("stx analyze **/*.stx --detailed").example("stx analyze --only-issues --threshold warning").action(async(x,b)=>{try{let z=x&&x.length>0?x:["**/*.stx"],k=b.threshold||"info",j={info:0,warning:1,error:2},W=j[k];if(!b.json)console.log("\uD83D\uDD0D Analyzing stx templates...");let{results:H,summary:U}=await l(z);if(H.length===0){console.log("No STX files found to analyze.");return}let Y=b.onlyIssues?H.filter((Q)=>Q.issues.some((X)=>j[X.type]>=W)):H;if(b.json){let Q={summary:U,results:Y,generatedAt:new Date().toISOString()};if(b.saveReport)await Bun.write(b.saveReport,JSON.stringify(Q,null,2)),console.log(`\uD83D\uDCCB Analysis report saved to: ${b.saveReport}`);else console.log(JSON.stringify(Q,null,2));return}if(console.log(`
+\uD83D\uDCCA Analysis Summary`),console.log("\u2500".repeat(50)),console.log(`\uD83D\uDCC1 Files analyzed: ${U.totalFiles}`),console.log(`\uD83D\uDCCF Total lines: ${U.totalLines.toLocaleString()}`),console.log(`\uD83E\uDDEE Average complexity: ${U.avgComplexity}/10`),console.log(`\u26A0\uFE0F  Total issues: ${U.totalIssues}`),console.log(`\uD83D\uDE80 Performance score: ${U.performanceScore}/10`),Object.keys(U.issuesByCategory).length>0){console.log(`
+\uD83D\uDCCB Issues by category:`);for(let[Q,X]of Object.entries(U.issuesByCategory))console.log(`   ${Q}: ${X}`)}if(U.recommendations.length>0)console.log(`
+\uD83D\uDCA1 Project recommendations:`),U.recommendations.forEach((Q)=>{console.log(`   \u2022 ${Q}`)});if(b.detailed){console.log(`
+\uD83D\uDCC4 Detailed File Analysis`),console.log("\u2550".repeat(60));for(let Q of Y){if(console.log(`
+\uD83D\uDCDD ${$.relative(w.cwd(),Q.file)}`),console.log(`   Lines: ${Q.metrics.lines} | Complexity: ${Q.metrics.complexity}/10 | Estimated render: ${Q.performance.estimatedRenderTime}ms`),Q.issues.length>0){let X=Q.issues.filter((_)=>j[_.type]>=W);if(X.length>0)console.log(`   Issues (${X.length}):`),X.forEach((_)=>{let q=_.type==="error"?"\u274C":_.type==="warning"?"\u26A0\uFE0F":"\u2139\uFE0F";if(console.log(`     ${q} ${_.message}`),_.suggestion)console.log(`        \uD83D\uDCA1 ${_.suggestion}`)})}if(Q.suggestions.length>0)console.log(`   Suggestions (${Q.suggestions.length}):`),Q.suggestions.forEach((X)=>{let _=X.impact==="high"?"\uD83D\uDD25":X.impact==="medium"?"\u26A1":"\uD83D\uDCAB";console.log(`     ${_} ${X.message} (${X.impact} impact, ${X.effort} effort)`)})}}else if(Y.length>0&&!b.onlyIssues)console.log(`
+\uD83D\uDCC4 Files with issues:`),Y.forEach((Q)=>{let X=Q.issues.filter((_)=>j[_.type]>=W).length;if(X>0)console.log(`   ${$.relative(w.cwd(),Q.file)} (${X} issues)`)});if(b.saveReport){let Q={summary:U,results:Y,generatedAt:new Date().toISOString(),commandOptions:b};await Bun.write(b.saveReport,JSON.stringify(Q,null,2)),console.log(`
+\uD83D\uDCCB Analysis report saved to: ${b.saveReport}`)}console.log(`
+\u2728 Analysis complete! Use --detailed for more information.`)}catch(z){console.error("Error analyzing templates:",z),w.exit(1)}}),E.command("screenshot [input]","Capture PNG screenshot(s) of page(s) via Bun WebView \u2014 a file, URL, or dist directory").option("--out <dir>","Output directory",{default:"screenshots"}).option("--width <px>","Viewport width",{default:"1440"}).option("--height <px>","Viewport height",{default:"2200"}).option("--wait <ms>","Settle time after navigation before capture",{default:"800"}).option("--timeout <ms>","Hard cap on waiting for navigation",{default:"15000"}).option("--full-page","Capture the entire scrollable page, not just the viewport").option("--wait-selector <sel>","Wait until a CSS selector exists before capturing").option("--format <fmt>","Image format: png | jpeg | webp",{default:"png"}).option("--backend <name>","WebView backend: webkit (macOS, default) | chrome").action(async(x,b)=>{let{captureScreenshots:z}=await import("./chunk-24ps8kft.js"),k=x||"dist";try{let j=await z(k,b.out,{width:Number.parseInt(b.width,10),height:Number.parseInt(b.height,10),waitMs:Number.parseInt(b.wait,10),timeoutMs:Number.parseInt(b.timeout,10),fullPage:Boolean(b.fullPage),waitSelector:b.waitSelector,format:b.format,backend:b.backend});for(let W of j)console.log(`\uD83D\uDCF8 ${W.output} (${(W.bytes/1024).toFixed(0)} KB)`);console.log(`
+\u2728 Captured ${j.length} screenshot(s) to ${b.out}/ via Bun WebView`)}catch(j){console.error(`Screenshot failed: ${j.message}`),w.exit(1)}}),E.command("version","Show the version of the CLI").action(()=>{console.log(N)}),E.command("interactive","Start interactive REPL mode for template development").alias("i").option("--context <file>","Load initial context from JSON file").option("--cwd <directory>","Set working directory").option("--verbose","Show verbose output").action(async(x)=>{let{startInteractive:b}=await import("./chunk-122tyfre.js"),z={};if(x.context){let k=$.resolve(x.context);if(L.existsSync(k))try{let j=L.readFileSync(k,"utf-8");z=JSON.parse(j)}catch(j){console.error("Error loading context file:",j),w.exit(1)}else console.error(`Context file not found: ${k}`),w.exit(1)}await b({context:z,cwd:x.cwd?$.resolve(x.cwd):w.cwd(),verbose:x.verbose})}),E.command("build:native <input>","Build stx template into a native desktop/mobile app").option("--output <dir>","Output directory",{default:"dist/native"}).option("--target <platform>","Target platform: macos, windows, linux, ios, android").option("--format <format>","Output format: app, dmg, pkg, msi, zip, deb, rpm, appimage, ipa, apk").option("--name <name>","Application name (defaults to filename)").option("--version <version>","Application version",{default:"1.0.0"}).option("--description <desc>","Application description").option("--author <author>","Author/Maintainer name").option("--bundle-id <id>","Bundle identifier (macOS/iOS)").option("--icon <path>","Path to application icon").option("--width <width>","Window width",{default:"1200"}).option("--height <height>","Window height",{default:"800"}).option("--title <title>","Window title").option("--system-tray","Enable system tray/menubar mode").option("--menubar-only","Run without a dock icon (implied by --system-tray)").option("--category <type>","LSApplicationCategoryType (macOS)").option("--copyright <text>","NSHumanReadableCopyright (macOS)").option("--min-system-version <v>","LSMinimumSystemVersion (macOS)").option("--info-plist <json>","Extra Info.plist keys as a JSON object (macOS)").option("--dev-tools","Enable developer tools").option("--frameless","Create frameless window").option("--always-on-top","Keep window always on top").option("--craft-path <path>","Path to Craft binary").option("--verbose","Show verbose output").example("stx build:native app.stx --target macos").example("stx build:native app.stx --target macos --format dmg").example("stx build:native app.stx --target linux --format appimage").example('stx build:native app.stx --name "My App" --icon icon.png').action(async(x,b)=>{try{let{buildNative:z,getAvailableTargets:k,getAvailableFormats:j}=await import("./chunk-3zv4wz87.js"),W=$.resolve(x);if(!L.existsSync(W))console.error(`\u274C Input file not found: ${x}`),w.exit(1);let H=k();if(b.target&&!["macos","windows","linux","ios","android"].includes(b.target))console.error(`\u274C Invalid target: ${b.target}`),console.error("\uD83D\uDCA1 Available targets: macos, windows, linux, ios, android"),console.error(`\uD83D\uDCA1 Targets available on this machine: ${H.join(", ")}`),w.exit(1);let U=b.target||H[0],Y=j(U);if(b.format&&!Y.includes(b.format))console.error(`\u274C Invalid format for ${U}: ${b.format}`),console.error(`\uD83D\uDCA1 Available formats: ${Y.join(", ")}`),w.exit(1);console.log(`
+\uD83D\uDD28 Building native app...`),console.log(`   Input:  ${x}`),console.log(`   Target: ${U}`),console.log(`   Format: ${b.format||"default"}`),console.log(`   Output: ${b.output}
+`);let Q=await z({input:W,output:$.resolve(b.output),target:U,format:b.format,name:b.name,version:b.version,description:b.description,author:b.author,bundleId:b.bundleId,icon:b.icon?$.resolve(b.icon):void 0,window:{title:b.title,width:Number.parseInt(b.width,10),height:Number.parseInt(b.height,10),frameless:b.frameless,alwaysOnTop:b.alwaysOnTop},systemTray:b.systemTray,menubarOnly:b.menubarOnly,category:b.category,copyright:b.copyright,minimumSystemVersion:b.minSystemVersion,infoPlist:kb(b.infoPlist),devTools:b.devTools,craftPath:b.craftPath,verbose:b.verbose});if(Q.success){if(console.log("\u2705 Build successful!"),console.log(`   Output: ${Q.outputPath}`),Q.duration)console.log(`   Duration: ${(Q.duration/1000).toFixed(2)}s`);if(U==="macos"&&Q.format==="app")console.log(`
+\uD83D\uDCA1 To run: open "${Q.outputPath}"`);else if(U==="linux"&&Q.format==="appimage")console.log(`
+\uD83D\uDCA1 To run: chmod +x "${Q.outputPath}" && "${Q.outputPath}"`)}else console.error(`\u274C Build failed: ${Q.error}`),w.exit(1)}catch(z){console.error(`\u274C Build error: ${z.message}`),w.exit(1)}}),E.command("story","Start component showcase and testing server").option("-p, --port <port>","Server port",{default:"6006"}).option("-o, --open","Open browser automatically",{default:!1}).option("--host <host>","Host to bind to",{default:"localhost"}).example("stx story").example("stx story --port 3000 --open").action(async(x)=>{try{let{devCommand:b}=await import("./chunk-acn1b56m.js");await b({port:x.port?Number.parseInt(x.port,10):6006,open:x.open,host:x.host})}catch(b){console.error(`\u274C Story error: ${b.message}`),w.exit(1)}}),E.command("story:build","Build static story site").option("-o, --outDir <dir>","Output directory",{default:".stx/dist/story"}).example("stx story:build").example("stx story:build --outDir ./docs/components").action(async(x)=>{try{let{buildCommand:b}=await import("./chunk-xgnc1wy6.js");await b({outDir:x.outDir})}catch(b){console.error(`\u274C Story build error: ${b.message}`),w.exit(1)}}),E.command("story:test","Run visual regression tests").option("-u, --update","Update snapshots",{default:!1}).option("-f, --filter <name>","Filter components by name").example("stx story:test").example("stx story:test --update").example("stx story:test --filter Button").action(async(x)=>{try{let{createContext:b}=await import("./chunk-ccspd3mc.js"),{runVisualTests:z,updateSnapshots:k,formatTestResults:j}=await import("./chunk-fvhm8psm.js"),W=await b({mode:"build"});if(x.update){let H=await k(W,{filter:x.filter?[x.filter]:void 0});console.log(`Updated ${H} snapshots`)}else{let H=await z(W,{filter:x.filter?[x.filter]:void 0});if(console.log(j(H)),H.failed>0)w.exit(1)}}catch(b){console.error(`\u274C Story test error: ${b.message}`),w.exit(1)}}),E.command("compile <input>","Compile stx template to native Craft component code").option("--target <platform>","Target platform: macos, windows, linux, ios, android, universal",{default:"universal"}).option("--format <format>","Output format: zig, typescript, json",{default:"zig"}).option("--output <path>","Output directory for compiled files",{default:"./dist"}).option("--optimize","Enable optimizations",{default:!0}).option("--tree-shake","Enable tree shaking",{default:!0}).option("--hot-reload","Enable hot reload support",{default:!1}).option("--sourcemaps","Generate source maps",{default:!1}).option("--bundle","Bundle all dependencies",{default:!0}).option("--minify","Minify output",{default:!1}).option("--verbose","Show detailed output",{default:!1}).example("stx compile app.stx").example("stx compile app.stx --target macos --format zig").example("stx compile app.stx --format typescript --output ./native").example("stx compile app.stx --optimize --tree-shake --minify").action(async(x,b)=>{try{let{compileToNative:z}=await import("./chunk-qpyjak7z.js"),k=$.resolve(x);if(!L.existsSync(k))console.error(`\u274C Input file not found: ${x}`),w.exit(1);let j=["macos","windows","linux","ios","android","universal"];if(!j.includes(b.target))console.error(`\u274C Invalid target: ${b.target}`),console.error(`\uD83D\uDCA1 Available targets: ${j.join(", ")}`),w.exit(1);let W=["zig","typescript","json"];if(!W.includes(b.format))console.error(`\u274C Invalid format: ${b.format}`),console.error(`\uD83D\uDCA1 Available formats: ${W.join(", ")}`),w.exit(1);console.log(`
+\uD83D\uDD27 Compiling stx template to native code...`),console.log(`   Input:  ${x}`),console.log(`   Target: ${b.target}`),console.log(`   Format: ${b.format}`),console.log(`   Output: ${b.output}
+`);let H=L.readFileSync(k,"utf-8"),U=await z(H,{target:b.target,format:b.format,optimize:b.optimize,treeShake:b.treeShake,hotReload:b.hotReload,debug:b.verbose,sourceMaps:b.sourcemaps,bundle:b.bundle,minify:b.minify}),Y=$.resolve(b.output);if(!L.existsSync(Y))L.mkdirSync(Y,{recursive:!0});let Q=$.basename(x,$.extname(x)),X=b.format==="typescript"?"ts":b.format==="json"?"json":"zig",_=$.join(Y,`${Q}.${X}`);L.writeFileSync(_,U.code);let q=$.join(Y,`${Q}.manifest.json`);if(L.writeFileSync(q,JSON.stringify(U.manifest,null,2)),b.sourcemaps&&U.sourceMaps){let O=$.join(Y,`${Q}.${X}.map`);L.writeFileSync(O,U.sourceMaps)}if(b.target==="universal"&&U.platformCode.size>0)for(let[O,M]of U.platformCode){let G=$.join(Y,`${Q}.${O}.${X}`);L.writeFileSync(G,M)}if(console.log("\u2705 Compilation successful!"),console.log(`   Output: ${_}`),console.log(`   Manifest: ${q}`),console.log(`
+\uD83D\uDCCA Statistics:`),console.log(`   Compilation time: ${U.stats.compilationTime.toFixed(2)}ms`),console.log(`   Total components: ${U.stats.totalComponents}`),console.log(`   Native components: ${U.stats.nativeComponents}`),console.log(`   Web fallback components: ${U.stats.webComponents}`),console.log(`   Bundle size: ${(U.stats.bundleSize/1024).toFixed(2)}KB`),U.stats.warnings.length>0){console.log(`
+\u26A0\uFE0F  Warnings:`);for(let O of U.stats.warnings)console.log(`   - ${O.message}`)}if(U.stats.errors.length>0){console.log(`
+\u274C Errors:`);for(let O of U.stats.errors)console.log(`   - ${O.message}`)}}catch(z){console.error(`\u274C Compilation error: ${z.message}`),w.exit(1)}});let Z=E.commands.flatMap((x)=>[x.name,...x.aliasNames??[]]).filter((x)=>Boolean(x)),K=w.argv.slice(2);if(K.length>0&&!K[0].startsWith("-")){let x=K[0];if(x==="")console.error("\u274C No command provided"),console.error("\uD83D\uDCA1 Use --help to see available commands"),w.exit(1);if(!Z.includes(x)){let b=B("fs"),z=B("path"),k=x;if(!z.isAbsolute(k))k=z.resolve(w.cwd(),k);if(b.existsSync(k)){let j=b.statSync(k);if(j.isFile()||j.isDirectory())w.argv=[w.argv[0],w.argv[1],"dev",...K]}else{let j=Z.map((H)=>({command:H,distance:J(x,H)}));j.sort((H,U)=>H.distance-U.distance);let W=j[0];if(W.distance<=3)console.error(`\u274C Unknown command: ${x}`),console.error(`\uD83D\uDCA1 Did you mean: ${W.command}?`),console.error(`
+Run 'stx --help' to see available commands.`),w.exit(1);console.error(`\u274C Unknown command or path: ${x}`),console.error(`
+Run 'stx --help' to see available commands.`),w.exit(1)}}}E.help(),E.version(N),E.parse(w.argv)}

package/dist/client/directive.d.ts

@@ -0,0 +1,17 @@
+/**
+ * STX Router Directive
+ *
+ * Usage in templates:
+ *   @stxRouter - Inject the SPA router script
+ *   @stxRouter('main') - Specify custom container selector
+ */
+import type { CustomDirective } from '../types';
+/**
+ * Handler for @stxRouter directive
+ * Injects the SPA router script into the page
+ */
+export declare function stxRouterHandler(_content: string, params: string[], _context: Record<string, unknown>, _filePath: string): Promise<string>;
+/**
+ * Custom directive for @stxRouter
+ */
+export declare const stxRouterDirective: CustomDirective;

package/dist/client/directive.js

@@ -0,0 +1,14 @@
+import { getRouterScript } from "./index.js";
+export async function stxRouterHandler(_content, params, _context, _filePath) {
+  const container = params[0]?.replace(/['"]/g, "") || "main";
+  let script = getRouterScript();
+  if (container !== "main")
+    script = script.replace("container:'main'", `container:'${container}'`);
+  return `<script data-stx-router>${script}</script>`;
+}
+export const stxRouterDirective = {
+  name: "stxRouter",
+  handler: stxRouterHandler,
+  hasEndTag: !1,
+  description: "Inject the STX SPA router script for client-side navigation"
+};

package/dist/client/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * STX Client-Side Modules
+ *
+ * Browser-side functionality for STX applications.
+ */
+export * from './directive';
+export { getRouterScript } from 'stx-router';

package/dist/client/index.js

@@ -0,0 +1,2 @@
+export * from "./directive.js";
+export { getRouterScript } from "stx-router";