@stacksjs/stx 0.2.674 → 0.2.676

package/dist/native/compiler/headwind-to-style.js

@@ -1,6 +1,6 @@
 import { DENSITY_FONT_SIZES, DENSITY_SPACING, SEMANTIC_TOKENS, SHAPE_TOKENS, tokenVariable } from "../../theme-tokens.js";
 import { nativeDensitySpacing, nativeDensityType, nativeShapeRadius } from "./design-tokens.js";
-import { nativeBreakpoint, nativeShortcut, nativeThemeColor } from "./style-config.js";
+import { nativeBreakpoint, nativeShortcut, nativeThemeColor, nativeThemeFont } from "./style-config.js";
 import { parseNativeStyle } from "./inline-style.js";
 const colors = {
   transparent: "transparent",
@@ -712,6 +712,18 @@ const classParsers = {
   "overflow-x-scroll": () => !0,
   "overflow-y-auto": () => !0,
   "overflow-y-scroll": () => !0,
+  "font-sans": (_, style) => {
+    style.fontFamily = nativeThemeFont("sans") ?? "sans-serif";
+    return !0;
+  },
+  "font-serif": (_, style) => {
+    style.fontFamily = nativeThemeFont("serif") ?? "serif";
+    return !0;
+  },
+  "font-mono": (_, style) => {
+    style.fontFamily = nativeThemeFont("mono") ?? "monospace";
+    return !0;
+  },
   "font-thin": (_, style) => {
     style.fontWeight = "100";
     return !0;

package/dist/native/compiler/html-to-ir.d.ts

@@ -21,6 +21,8 @@ export declare function mustacheBinding(text: string): string | null;
 export declare function translateHtmlToIR(html: string, options?: TranslateOptions): Promise<TranslationResult>;
 /** The same translation, wrapped in an `STXDocument` for the renderers. */
 export declare function translateHtmlToDocument(html: string, options?: TranslateOptions & { script?: STXDocument['script'] }): Promise<{ document: STXDocument, diagnostics: TranslationDiagnostic[] }>;
+/** Explicit website-only markup; unlike chrome this does not configure app navigation. */
+export declare function excludeNativeSubtrees(html: string): Promise<string>;
 /**
  * Every event name at least one renderer dispatches on.
  *

package/dist/native/compiler/html-to-ir.js

@@ -22,6 +22,7 @@ export const NATIVE_EVENTS = new Set([
   "onEndReached",
   "onError",
   "onFocus",
+  "onPageSelected",
   "onLayout",
   "onLoad",
   "onLoadEnd",
@@ -248,6 +249,7 @@ function settle(frame, diagnostics) {
   return node;
 }
 export async function translateHtmlToIR(html, options = {}) {
+  html = await excludeNativeSubtrees(html);
   const diagnostics = [], stylesheetTheme = await extractStylesheetTheme(html, (name) => diagnostics.push({ kind: "unsupported-theme-rule", tag: "style", name })), stylesheetVariables = createStyleVariables(stylesheetTheme.light).computed(), usedClasses = new Set([...html.matchAll(/\sclass(?:name)?\s*=\s*"([^"]*)"/gi)].flatMap((match) => match[1].split(/\s+/))), stylesheetRules = await extractStylesheetRules(html, (name, classes) => {
     if (!classes.length || classes.some((name) => usedClasses.has(name)))
       diagnostics.push({ kind: "unsupported-style-rule", tag: "style", name });
@@ -566,3 +568,10 @@ export async function translateHtmlToDocument(html, options = {}) {
     diagnostics
   };
 }
+export async function excludeNativeSubtrees(html) {
+  if (!/\bdata-native-exclude\b/i.test(html))
+    return html;
+  return new HTMLRewriter().on("[data-native-exclude]", { element(element) {
+    element.remove();
+  } }).transform(new Response(html)).text();
+}

package/dist/native/compiler/ir.d.ts

@@ -296,6 +296,7 @@ export type STXEventType = | 'onPress'
   | 'onMomentumScrollBegin'
   | 'onMomentumScrollEnd'
   // Layout events
+  | 'onPageSelected'
   | 'onLayout'
   // List events
   | 'onEndReached'

package/dist/native/compiler/render-screen.js

@@ -5,7 +5,7 @@ import { classifyAttribute, extractBindingManifest } from "../../binding-manifes
 import { processDirectives } from "../../process.js";
 import { processScriptSetup } from "../../signal-processing.js";
 import { appThemeCSS } from "./app-theme.js";
-import { translateHtmlToDocument } from "./html-to-ir.js";
+import { excludeNativeSubtrees, translateHtmlToDocument } from "./html-to-ir.js";
 import { extractClientScript } from "./client-script.js";
 import { extractLayoutChrome } from "./layout-chrome.js";
 import { extractGeneratedSetupScript, extractNativeClientScripts } from "./setup-script.js";
@@ -20,6 +20,7 @@ export function nativePrimitivesDir() {
   return candidates[0];
 }
 export async function compileScreenSource(source, filePath, options = {}) {
+  source = await excludeNativeSubtrees(source);
   const root = options.root ?? path.dirname(filePath), loaded = await loadStxConfig(root), sourceRoot = typeof loaded.root === "string" && loaded.root ? path.resolve(root, loaded.root) : root, fromRoot = (dir, fallback) => dir ? path.isAbsolute(dir) ? dir : path.resolve(sourceRoot, dir) : path.join(sourceRoot, fallback), config = {
     root,
     layoutsDir: fromRoot(loaded.layoutsDir, "layouts"),
@@ -29,11 +30,11 @@ export async function compileScreenSource(source, filePath, options = {}) {
     buildMode: "serve",
     cache: !1,
     _targetComponentDirs: [nativePrimitivesDir()],
-    _targetComponentFallbackNames: ["Button", "Checkbox", "Switch", "TextInput"],
+    _targetComponentFallbackNames: ["Button", "Checkbox", "Switch", "TextInput", "Video"],
     _nativeHostAttrs: !0,
     skipEventDirectives: !0,
     _pluginComponentDirs: loaded._pluginComponentDirs ?? []
-  }, context = { ...options.context ?? {}, __stx_inject_css: !1, __stx_native_screen: !0 }, dependencies = new Set([filePath]), renderedHtml = await processDirectives(source, context, filePath, config, dependencies), { html: content, chrome } = await extractLayoutChrome(renderedHtml), { html, manifest } = extractBindingManifest(content), theme = await appThemeCSS(root), { document, diagnostics } = await translateHtmlToDocument(theme ? `<style>${theme}</style>${html}` : html, {
+  }, context = { ...options.context ?? {}, __stx_inject_css: !1, __stx_native_screen: !0 }, dependencies = new Set([filePath]), renderedHtml = await processDirectives(source, context, filePath, config, dependencies), { html: content, chrome } = await extractLayoutChrome(await excludeNativeSubtrees(renderedHtml)), { html, manifest } = extractBindingManifest(await excludeNativeSubtrees(content)), theme = await appThemeCSS(root), { document, diagnostics } = await translateHtmlToDocument(theme ? `<style>${theme}</style>${html}` : html, {
     source: filePath,
     script: extractClientScript(source)
   });

package/dist/native/compiler/style-config.d.ts

@@ -13,6 +13,8 @@ export declare function nativeShortcut(name: string): string | undefined;
 export declare function nativeThemeColor(name: string): string | undefined;
 /** A breakpoint's min-width in points, or undefined when `name` is not one. */
 export declare function nativeBreakpoint(name: string): number | undefined;
+/** The app font stack; generic families are resolved by the platform host. */
+export declare function nativeThemeFont(name: string): string | undefined;
 /**
  * The app's own utility vocabulary, for native styles.
  *
@@ -28,5 +30,6 @@ export declare const DEFAULT_BREAKPOINTS: Readonly<Record<string, number>>;
 export declare interface NativeStyleConfig {
   shortcuts?: Record<string, string>
   colors?: Record<string, unknown>
+  fontFamily?: Record<string, string | string[]>
   breakpoints?: Record<string, number>
 }

package/dist/native/compiler/style-config.js

@@ -33,6 +33,7 @@ function resolve(config) {
   return {
     shortcuts: new Map(Object.entries(config.shortcuts ?? {}).filter(([, value]) => typeof value === "string")),
     colors: flattenColors(config.colors),
+    fontFamily: new Map(Object.entries(config.fontFamily ?? {}).map(([name, value]) => [name, Array.isArray(value) ? value.join(", ") : value])),
     breakpoints: new Map(Object.entries({ ...DEFAULT_BREAKPOINTS, ...breakpointsOf(config.breakpoints) }))
   };
 }
@@ -56,6 +57,7 @@ export function nativeStyleConfigFrom(cssConfig) {
   const theme = cssConfig.theme ?? {}, shortcuts = Object.fromEntries(Object.entries(cssConfig.shortcuts ?? {}).filter(([, value]) => typeof value === "string"));
   return {
     ...Object.keys(shortcuts).length ? { shortcuts } : {},
+    ...theme.fontFamily ? { fontFamily: JSON.parse(JSON.stringify(theme.fontFamily)) } : {},
     ...theme.colors ? { colors: JSON.parse(JSON.stringify(theme.colors)) } : {},
     ...theme.screens ? { breakpoints: breakpointsOf(theme.screens) } : {}
   };
@@ -69,3 +71,6 @@ export function nativeThemeColor(name) {
 export function nativeBreakpoint(name) {
   return active().breakpoints.get(name);
 }
+export function nativeThemeFont(name) {
+  return active().fontFamily.get(name);
+}

package/dist/native/components/primitives.d.ts

@@ -81,6 +81,8 @@ export declare interface ScrollViewProps extends ViewProps {
   refreshControl?: RefreshControlProps
   stickyHeaderIndices?: number[]
   scrollTarget?: string | { id: string, key?: string | number, animated?: boolean } | null
+  pageIndex?: number
+  onPageSelected?: (event: { nativeEvent: { index: number, count: number } }) => void
   pagingEnabled?: boolean
   scrollEnabled?: boolean
 }

package/dist/native/event-names.js

@@ -32,6 +32,8 @@ export const NATIVE_EVENT_NAMES = {
   momentumscrollbegin: "onMomentumScrollBegin",
   "momentum-scroll-end": "onMomentumScrollEnd",
   momentumscrollend: "onMomentumScrollEnd",
+  "page-selected": "onPageSelected",
+  pageselected: "onPageSelected",
   refresh: "onRefresh",
   layout: "onLayout",
   "end-reached": "onEndReached",

package/dist/native/prop-names.js

@@ -43,6 +43,7 @@ const NATIVE_PROP_NAMES = [
   "numberOfLines",
   "numColumns",
   "onEndReachedThreshold",
+  "pageIndex",
   "pagingEnabled",
   "passwordRules",
   "placeholderTextColor",

package/dist/native/runtime/craft-bridge.js

@@ -1,9 +1,10 @@
-import { STXBridge } from "../bridge/protocol.js";
+import { NativeCapabilityError, STXBridge } from "../bridge/protocol.js";
 import { createEventSourceClass, createStreamingBody } from "./event-stream.js";
 import { abortError, isNativeDocument, NativeFormData, nativeFormParts, updateNativeDocumentVisibility } from "./jsc-globals.js";
 import { buttonsKey, changedTabItems, chromePath, hostButton, mergeChromeButtons } from "./navigation-chrome.js";
 import { installNativeNavigation, nativeRouteParams } from "./web-navigation.js";
 import { installNativeWebStorage } from "./web-storage.js";
+const permissionFallbacks = new WeakSet;
 function capabilityFlags(capabilities) {
   return {
     desktop: capabilities.has("desktop"),
@@ -549,13 +550,6 @@ export function installCraftBridge(protocol, nativeBridge, target = globalThis,
       openSettings: () => request("Push", "openSettings", []).then(Boolean)
     };
     craft.registerPush = craft.push.register;
-    craft.permissions = Object.assign({}, craft.permissions, {
-      check: (permission) => permission === "notifications" ? craft.push.getPermissionStatus() : Promise.resolve("undetermined"),
-      request: (permission) => permission === "notifications" ? craft.push.requestPermission() : Promise.resolve("undetermined"),
-      openSettings: () => craft.push.openSettings().then(() => {
-        return;
-      })
-    });
     protocol.on("PUSH_TOKEN", ({ payload }) => {
       const token = String(payload?.token || "");
       if (!token)
@@ -565,6 +559,19 @@ export function installCraftBridge(protocol, nativeBridge, target = globalThis,
         target.dispatchEvent(new target.CustomEvent("craftPushToken", { detail: { token } }));
     });
   }
+  const permissions = craft.permissions ??= {}, unsupportedPermission = (method, permission) => Promise.reject(new NativeCapabilityError("PERMISSION_UNSUPPORTED", `Native permissions.${method}${permission === void 0 ? "" : `("${permission}")`} is not supported by this host`)), permissionDefaults = {
+    check: (permission) => capabilities.has("push") && permission === "notifications" ? craft.push.getPermissionStatus() : unsupportedPermission("check", permission),
+    request: (permission) => capabilities.has("push") && permission === "notifications" ? craft.push.requestPermission() : unsupportedPermission("request", permission),
+    openSettings: () => capabilities.has("push") ? craft.push.openSettings().then(() => {
+      return;
+    }) : unsupportedPermission("openSettings")
+  };
+  for (const [method, fallback] of Object.entries(permissionDefaults)) {
+    if (typeof permissions[method] === "function" && !permissionFallbacks.has(permissions[method]))
+      continue;
+    permissions[method] = fallback;
+    permissionFallbacks.add(fallback);
+  }
   if (capabilities.has("health")) {
     craft.health = {
       requestAuthorization: (types, options = {}) => ask("Health", "requestAuthorization", [types, options]),

package/dist/pwa.js

@@ -1,6 +1,6 @@
 // @bun
-import{Ts,jt,vc,mu}from"./chunk-6sjtyd0k.js";import{Es,Jo,pu,fu,gu}from"./chunk-dgc1a3yt.js";import{hc,yc,bc,uu,du}from"./chunk-d09q93yf.js";import{ze,wn,Yo}from"./chunk-35ezh7de.js";import{hu,yu,bu,vu,$s,Gp}from"./chunk-5zhp87wv.js";import B from"fs";import w from"path";import O from"fs";import u from"path";var v=[72,96,128,144,152,192,384,512],S=[120,152,167,180],P=[16,32];async function M(n,t){let e={success:!0,generatedFiles:[],errors:[],warnings:[]},r=n.pwa?.icons;if(!r?.src)return e.errors.push("No source icon specified in pwa.icons.src"),e.success=!1,e;let o=u.isAbsolute(r.src)?r.src:u.resolve(process.cwd(),r.src);if(!await Bun.file(o).exists())return e.errors.push(`Source icon not found: ${o}`),e.success=!1,e;let a=u.resolve(t,r.outputDir||"pwa-icons");try{O.mkdirSync(a,{recursive:!0})}catch{return e.errors.push(`Failed to create output directory: ${a}`),e.success=!1,e}let s=r.sizes||v,l=r.generateWebP??!0,p=r.generateAppleIcons??!0;try{let c;try{c=await import("sharp")}catch{return e.errors.push(`sharp is not installed. Install it with: bun add sharp
-Icon generation requires the sharp package for image processing.`),e.success=!1,e}let g=await c.default(o).metadata();if(g.width&&g.width<512)e.warnings.push(`Source icon is ${g.width}x${g.height}. Recommend using at least 512x512 for best quality.`);for(let i of s){let d=u.join(a,`icon-${i}x${i}.png`);if(await c.default(o).resize(i,i,{fit:"contain",background:{r:0,g:0,b:0,alpha:0}}).png().toFile(d),e.generatedFiles.push(d),l){let x=u.join(a,`icon-${i}x${i}.webp`);await c.default(o).resize(i,i,{fit:"contain",background:{r:0,g:0,b:0,alpha:0}}).webp({quality:90}).toFile(x),e.generatedFiles.push(x)}}if(p){for(let d of S){let x=u.join(a,`apple-touch-icon-${d}x${d}.png`);await c.default(o).resize(d,d,{fit:"contain",background:{r:255,g:255,b:255,alpha:1}}).png().toFile(x),e.generatedFiles.push(x)}let i=u.join(a,"apple-touch-icon.png");await c.default(o).resize(180,180,{fit:"contain",background:{r:255,g:255,b:255,alpha:1}}).png().toFile(i),e.generatedFiles.push(i)}for(let i of P){let d=u.join(a,`favicon-${i}x${i}.png`);await c.default(o).resize(i,i,{fit:"contain",background:{r:0,g:0,b:0,alpha:0}}).png().toFile(d),e.generatedFiles.push(d)}let f=512,y=u.join(a,`icon-maskable-${f}x${f}.png`),m=Math.floor(f*0.1),k=f-m*2;await c.default(o).resize(k,k,{fit:"contain",background:{r:0,g:0,b:0,alpha:0}}).extend({top:m,bottom:m,left:m,right:m,background:{r:255,g:255,b:255,alpha:1}}).png().toFile(y),e.generatedFiles.push(y)}catch(c){let h=c instanceof Error?c.message:String(c);e.errors.push(`Icon generation failed: ${h}`),e.success=!1}return e}function N(n){let t=n.sizes||v,e=n.outputDir?`/${n.outputDir}`:"/pwa-icons",r=n.generateWebP??!0,o=n.generateAppleIcons??!0,a=[];for(let s of t)if(a.push(`${e}/icon-${s}x${s}.png`),r)a.push(`${e}/icon-${s}x${s}.webp`);if(o){a.push(`${e}/apple-touch-icon.png`);for(let s of S)a.push(`${e}/apple-touch-icon-${s}x${s}.png`)}for(let s of P)a.push(`${e}/favicon-${s}x${s}.png`);return a.push(`${e}/icon-maskable-512x512.png`),a}async function I(){try{return await import("sharp"),!0}catch{return!1}}function A(n,t,e,r){let o=[],a=r.join(" ");for(let s of n)if(o.push({src:`${t}/icon-${s}x${s}.png`,sizes:`${s}x${s}`,type:"image/png",purpose:a}),e)o.push({src:`${t}/icon-${s}x${s}.webp`,sizes:`${s}x${s}`,type:"image/webp",purpose:a});return o}function C(n){return n.map((t)=>({name:t.name,short_name:t.shortName,description:t.description,url:t.url,icons:t.icons?.map((e)=>({src:e.src,sizes:e.sizes,type:e.type}))}))}function T(n){let t=n.pwa?.shareTarget;if(!t?.enabled)return;let e={action:t.action||"/share",method:t.method||"POST",enctype:t.enctype||"multipart/form-data",params:{title:t.params?.title||"title",text:t.params?.text||"text",url:t.params?.url||"url"}};if(t.acceptFiles&&t.acceptFiles.length>0)e.params.files=t.acceptFiles.map((r)=>({name:r.name,accept:r.accept}));return e}function H(n){let t=n.pwa?.fileHandlers;if(!t?.enabled||!t.accept)return;let e=[{action:t.action||"/",accept:t.accept,launch_type:t.launchType||"single-client"}];if(t.icons)e[0].icons=t.icons.map((r)=>({src:r.src,sizes:r.sizes,type:r.type}));return e}function W(n){let t=n.pwa?.protocolHandlers;if(!t||t.length===0)return;return t.map((e)=>({protocol:e.protocol,url:e.url}))}function j(n){let t=n.pwa;if(!t?.enabled||!t.manifest)return null;let{manifest:e,icons:r}=t,o=r?.sizes||[72,96,128,144,152,192,384,512],a=r?.outputDir?`/${r.outputDir}`:"/pwa-icons",s=r?.generateWebP??!0,l=r?.purpose||["any","maskable"],p={name:e.name,short_name:e.shortName||e.name,description:e.description,start_url:e.startUrl||"/",display:e.display||"standalone",display_override:e.displayOverride,orientation:e.orientation,theme_color:e.themeColor,background_color:e.backgroundColor,scope:e.scope||"/",lang:e.lang,dir:e.dir,id:e.id,categories:e.categories,icons:A(o,a,s,l)};if(e.shortcuts&&e.shortcuts.length>0)p.shortcuts=C(e.shortcuts);if(e.screenshots&&e.screenshots.length>0)p.screenshots=e.screenshots.map((f)=>({src:f.src,sizes:f.sizes,type:f.type,label:f.label,form_factor:f.platform}));let c=T(n);if(c)p.share_target=c;let h=H(n);if(h)p.file_handlers=h;let g=W(n);if(g)p.protocol_handlers=g;if(e.launchHandler)p.launch_handler={client_mode:e.launchHandler};if(e.handleLinks)p.handle_links=e.handleLinks;if(e.edgeSidePanel?.enabled)p.edge_side_panel={preferred_width:e.edgeSidePanel.preferredWidth};return p}function _(n){let t=j(n);if(!t)return"";let e=JSON.parse(JSON.stringify(t));return JSON.stringify(e,null,2)}function q(n,t){return{...t,...n,shortcuts:n.shortcuts||t.shortcuts,screenshots:n.screenshots||t.screenshots,categories:n.categories||t.categories}}function D(n){let t=[],e=n.pwa;if(!e?.enabled)return t;let r=e.manifest;if(!r)return t.push("PWA manifest configuration is missing"),t;if(!r.name)t.push("Manifest name is required");let o=["fullscreen","standalone","minimal-ui","browser"];if(r.display&&!o.includes(r.display))t.push(`Invalid display mode: ${r.display}. Must be one of: ${o.join(", ")}`);let a=["any","natural","landscape","landscape-primary","landscape-secondary","portrait","portrait-primary","portrait-secondary"];if(r.orientation&&!a.includes(r.orientation))t.push(`Invalid orientation: ${r.orientation}`);let s=/^#([0-9A-Fa-f]{3}|[0-9A-Fa-f]{6})$/;if(r.themeColor&&!s.test(r.themeColor))t.push(`Invalid theme color: ${r.themeColor}. Must be a valid hex color.`);if(r.backgroundColor&&!s.test(r.backgroundColor))t.push(`Invalid background color: ${r.backgroundColor}. Must be a valid hex color.`);if(e.shareTarget?.enabled){if(!e.shareTarget.action)t.push("Share target action URL is required")}if(e.fileHandlers?.enabled){if(!e.fileHandlers.accept||Object.keys(e.fileHandlers.accept).length===0)t.push("File handlers must specify accepted MIME types")}if(e.protocolHandlers)for(let l of e.protocolHandlers){if(!l.protocol)t.push("Protocol handler missing protocol");if(!l.url||!l.url.includes("%s"))t.push(`Protocol handler URL must contain %s placeholder: ${l.protocol}`)}return t}import z from"path";async function F(n){let t=n.pwa?.offline;if(!t?.enabled)return"";if(t.page){let e=z.isAbsolute(t.page)?t.page:z.resolve(process.cwd(),t.page);if(await Bun.file(e).exists())try{let{processDirectives:r}=await import("./chunk-jzjpyyw2.js"),o=await Bun.file(e).text();return await r(o,{},e,n,new Set)}catch(r){console.warn(`[PWA] Failed to process custom offline page: ${r}`)}else console.warn(`[PWA] Custom offline page not found: ${e}`)}return E(n)}function E(n){let t=n.pwa?.offline,e=n.pwa?.manifest,r=t?.fallbackTitle||"You are offline",o=t?.fallbackMessage||"Please check your internet connection and try again.",a=e?.themeColor||"#4f46e5",s=e?.shortName||e?.name||"App";return`<!DOCTYPE html>
+import{Rs,Bt,xc,yu}from"./chunk-5z8mq37c.js";import{$s,Zo,gu,mu,hu}from"./chunk-fzc98qgn.js";import{bc,vc,wc,pu,fu}from"./chunk-jv021x8e.js";import{He,Sn,Qo}from"./chunk-k72jqz6a.js";import{bu,vu,wu,xu,As,Xp}from"./chunk-mabja59q.js";import B from"fs";import w from"path";import O from"fs";import u from"path";var v=[72,96,128,144,152,192,384,512],S=[120,152,167,180],P=[16,32];async function M(n,t){let e={success:!0,generatedFiles:[],errors:[],warnings:[]},r=n.pwa?.icons;if(!r?.src)return e.errors.push("No source icon specified in pwa.icons.src"),e.success=!1,e;let o=u.isAbsolute(r.src)?r.src:u.resolve(process.cwd(),r.src);if(!await Bun.file(o).exists())return e.errors.push(`Source icon not found: ${o}`),e.success=!1,e;let a=u.resolve(t,r.outputDir||"pwa-icons");try{O.mkdirSync(a,{recursive:!0})}catch{return e.errors.push(`Failed to create output directory: ${a}`),e.success=!1,e}let s=r.sizes||v,l=r.generateWebP??!0,p=r.generateAppleIcons??!0;try{let c;try{c=await import("sharp")}catch{return e.errors.push(`sharp is not installed. Install it with: bun add sharp
+Icon generation requires the sharp package for image processing.`),e.success=!1,e}let g=await c.default(o).metadata();if(g.width&&g.width<512)e.warnings.push(`Source icon is ${g.width}x${g.height}. Recommend using at least 512x512 for best quality.`);for(let i of s){let d=u.join(a,`icon-${i}x${i}.png`);if(await c.default(o).resize(i,i,{fit:"contain",background:{r:0,g:0,b:0,alpha:0}}).png().toFile(d),e.generatedFiles.push(d),l){let x=u.join(a,`icon-${i}x${i}.webp`);await c.default(o).resize(i,i,{fit:"contain",background:{r:0,g:0,b:0,alpha:0}}).webp({quality:90}).toFile(x),e.generatedFiles.push(x)}}if(p){for(let d of S){let x=u.join(a,`apple-touch-icon-${d}x${d}.png`);await c.default(o).resize(d,d,{fit:"contain",background:{r:255,g:255,b:255,alpha:1}}).png().toFile(x),e.generatedFiles.push(x)}let i=u.join(a,"apple-touch-icon.png");await c.default(o).resize(180,180,{fit:"contain",background:{r:255,g:255,b:255,alpha:1}}).png().toFile(i),e.generatedFiles.push(i)}for(let i of P){let d=u.join(a,`favicon-${i}x${i}.png`);await c.default(o).resize(i,i,{fit:"contain",background:{r:0,g:0,b:0,alpha:0}}).png().toFile(d),e.generatedFiles.push(d)}let f=512,y=u.join(a,`icon-maskable-${f}x${f}.png`),m=Math.floor(f*0.1),k=f-m*2;await c.default(o).resize(k,k,{fit:"contain",background:{r:0,g:0,b:0,alpha:0}}).extend({top:m,bottom:m,left:m,right:m,background:{r:255,g:255,b:255,alpha:1}}).png().toFile(y),e.generatedFiles.push(y)}catch(c){let h=c instanceof Error?c.message:String(c);e.errors.push(`Icon generation failed: ${h}`),e.success=!1}return e}function N(n){let t=n.sizes||v,e=n.outputDir?`/${n.outputDir}`:"/pwa-icons",r=n.generateWebP??!0,o=n.generateAppleIcons??!0,a=[];for(let s of t)if(a.push(`${e}/icon-${s}x${s}.png`),r)a.push(`${e}/icon-${s}x${s}.webp`);if(o){a.push(`${e}/apple-touch-icon.png`);for(let s of S)a.push(`${e}/apple-touch-icon-${s}x${s}.png`)}for(let s of P)a.push(`${e}/favicon-${s}x${s}.png`);return a.push(`${e}/icon-maskable-512x512.png`),a}async function I(){try{return await import("sharp"),!0}catch{return!1}}function A(n,t,e,r){let o=[],a=r.join(" ");for(let s of n)if(o.push({src:`${t}/icon-${s}x${s}.png`,sizes:`${s}x${s}`,type:"image/png",purpose:a}),e)o.push({src:`${t}/icon-${s}x${s}.webp`,sizes:`${s}x${s}`,type:"image/webp",purpose:a});return o}function C(n){return n.map((t)=>({name:t.name,short_name:t.shortName,description:t.description,url:t.url,icons:t.icons?.map((e)=>({src:e.src,sizes:e.sizes,type:e.type}))}))}function T(n){let t=n.pwa?.shareTarget;if(!t?.enabled)return;let e={action:t.action||"/share",method:t.method||"POST",enctype:t.enctype||"multipart/form-data",params:{title:t.params?.title||"title",text:t.params?.text||"text",url:t.params?.url||"url"}};if(t.acceptFiles&&t.acceptFiles.length>0)e.params.files=t.acceptFiles.map((r)=>({name:r.name,accept:r.accept}));return e}function H(n){let t=n.pwa?.fileHandlers;if(!t?.enabled||!t.accept)return;let e=[{action:t.action||"/",accept:t.accept,launch_type:t.launchType||"single-client"}];if(t.icons)e[0].icons=t.icons.map((r)=>({src:r.src,sizes:r.sizes,type:r.type}));return e}function W(n){let t=n.pwa?.protocolHandlers;if(!t||t.length===0)return;return t.map((e)=>({protocol:e.protocol,url:e.url}))}function j(n){let t=n.pwa;if(!t?.enabled||!t.manifest)return null;let{manifest:e,icons:r}=t,o=r?.sizes||[72,96,128,144,152,192,384,512],a=r?.outputDir?`/${r.outputDir}`:"/pwa-icons",s=r?.generateWebP??!0,l=r?.purpose||["any","maskable"],p={name:e.name,short_name:e.shortName||e.name,description:e.description,start_url:e.startUrl||"/",display:e.display||"standalone",display_override:e.displayOverride,orientation:e.orientation,theme_color:e.themeColor,background_color:e.backgroundColor,scope:e.scope||"/",lang:e.lang,dir:e.dir,id:e.id,categories:e.categories,icons:A(o,a,s,l)};if(e.shortcuts&&e.shortcuts.length>0)p.shortcuts=C(e.shortcuts);if(e.screenshots&&e.screenshots.length>0)p.screenshots=e.screenshots.map((f)=>({src:f.src,sizes:f.sizes,type:f.type,label:f.label,form_factor:f.platform}));let c=T(n);if(c)p.share_target=c;let h=H(n);if(h)p.file_handlers=h;let g=W(n);if(g)p.protocol_handlers=g;if(e.launchHandler)p.launch_handler={client_mode:e.launchHandler};if(e.handleLinks)p.handle_links=e.handleLinks;if(e.edgeSidePanel?.enabled)p.edge_side_panel={preferred_width:e.edgeSidePanel.preferredWidth};return p}function _(n){let t=j(n);if(!t)return"";let e=JSON.parse(JSON.stringify(t));return JSON.stringify(e,null,2)}function q(n,t){return{...t,...n,shortcuts:n.shortcuts||t.shortcuts,screenshots:n.screenshots||t.screenshots,categories:n.categories||t.categories}}function D(n){let t=[],e=n.pwa;if(!e?.enabled)return t;let r=e.manifest;if(!r)return t.push("PWA manifest configuration is missing"),t;if(!r.name)t.push("Manifest name is required");let o=["fullscreen","standalone","minimal-ui","browser"];if(r.display&&!o.includes(r.display))t.push(`Invalid display mode: ${r.display}. Must be one of: ${o.join(", ")}`);let a=["any","natural","landscape","landscape-primary","landscape-secondary","portrait","portrait-primary","portrait-secondary"];if(r.orientation&&!a.includes(r.orientation))t.push(`Invalid orientation: ${r.orientation}`);let s=/^#([0-9A-Fa-f]{3}|[0-9A-Fa-f]{6})$/;if(r.themeColor&&!s.test(r.themeColor))t.push(`Invalid theme color: ${r.themeColor}. Must be a valid hex color.`);if(r.backgroundColor&&!s.test(r.backgroundColor))t.push(`Invalid background color: ${r.backgroundColor}. Must be a valid hex color.`);if(e.shareTarget?.enabled){if(!e.shareTarget.action)t.push("Share target action URL is required")}if(e.fileHandlers?.enabled){if(!e.fileHandlers.accept||Object.keys(e.fileHandlers.accept).length===0)t.push("File handlers must specify accepted MIME types")}if(e.protocolHandlers)for(let l of e.protocolHandlers){if(!l.protocol)t.push("Protocol handler missing protocol");if(!l.url||!l.url.includes("%s"))t.push(`Protocol handler URL must contain %s placeholder: ${l.protocol}`)}return t}import z from"path";async function F(n){let t=n.pwa?.offline;if(!t?.enabled)return"";if(t.page){let e=z.isAbsolute(t.page)?t.page:z.resolve(process.cwd(),t.page);if(await Bun.file(e).exists())try{let{processDirectives:r}=await import("./chunk-wk1gt95z.js"),o=await Bun.file(e).text();return await r(o,{},e,n,new Set)}catch(r){console.warn(`[PWA] Failed to process custom offline page: ${r}`)}else console.warn(`[PWA] Custom offline page not found: ${e}`)}return E(n)}function E(n){let t=n.pwa?.offline,e=n.pwa?.manifest,r=t?.fallbackTitle||"You are offline",o=t?.fallbackMessage||"Please check your internet connection and try again.",a=e?.themeColor||"#4f46e5",s=e?.shortName||e?.name||"App";return`<!DOCTYPE html>
 <html lang="en">
 <head>
   <meta charset="UTF-8">
@@ -233,4 +233,4 @@ Icon generation requires the sharp package for image processing.`),e.success=!1,
     }, 5000);
   </script>
 </body>
-</html>`}function b(n){return n.replace(/&/g,"&amp;").replace(/</g,"&lt;").replace(/>/g,"&gt;").replace(/"/g,"&quot;").replace(/'/g,"&#39;")}async function re(n,t){let e={success:!0,files:{icons:[]},errors:[],warnings:[]},r=n.pwa;if(!r?.enabled)return e;try{B.mkdirSync(t,{recursive:!0})}catch{return e.errors.push(`Failed to create output directory: ${t}`),e.success=!1,e}try{let a=_(n);if(a){let s=w.join(t,"manifest.json");await Bun.write(s,a),e.files.manifest=s}}catch(a){let s=a instanceof Error?a.message:String(a);e.errors.push(`Failed to generate manifest.json: ${s}`),e.success=!1}if(r.icons?.src)if(await I()){let s=await M(n,t);if(e.files.icons=s.generatedFiles,e.warnings.push(...s.warnings),!s.success)e.errors.push(...s.errors),e.success=!1}else e.warnings.push("sharp is not installed. Skipping icon generation. Install with: bun add sharp");if(r.offline?.enabled)try{let a=await F(n);if(a){let s=w.join(t,"offline.html");await Bun.write(s,a),e.files.offlinePage=s}}catch(a){let s=a instanceof Error?a.message:String(a);e.errors.push(`Failed to generate offline page: ${s}`),e.success=!1}let o;if(r.precache?.enabled){let a=ze(t,n);o={fileCount:a.fileCount,totalSize:a.totalSize},e.precacheStats=o}try{let a=Ts(n,t);if(a){let s=jt(n),l=w.join(t,s);await Bun.write(l,a),e.files.serviceWorker=l}}catch(a){let s=a instanceof Error?a.message:String(a);e.errors.push(`Failed to generate service worker: ${s}`),e.success=!1}return e}function ae(n,t){return Jo(n,t)}function se(n){return n.pwa?.enabled===!0}export{S as APPLE_TOUCH_ICON_SIZES,v as DEFAULT_ICON_SIZES,P as FAVICON_SIZES,yc as auditBuildOutput,hc as auditConfig,re as buildPwaAssets,bc as calculateAuditResult,du as formatAuditResult,Yo as formatSize,j as generateManifest,_ as generateManifestJson,fu as generateManifestLink,F as generateOfflinePage,ze as generatePrecacheManifest,wn as generatePrecacheManifestJs,M as generatePwaIcons,Es as generatePwaTags,Ts as generateServiceWorker,mu as generateServiceWorkerAuto,pu as generateSwRegistrationScript,gu as generateThemeColorMeta,N as getExpectedIconPaths,jt as getServiceWorkerFileName,Jo as injectPwaTags,se as isPwaEnabled,I as isSharpAvailable,vc as isWorkboxEnabled,q as mergeManifestConfig,ae as processPwaHtml,$s as pwaDirectives,hu as pwaInstallDirective,bu as pwaOfflineDirective,vu as pwaPushDirective,yu as pwaUpdateDirective,Gp as registerPwaDirectives,uu as runPwaAudit,D as validateManifest};
+</html>`}function b(n){return n.replace(/&/g,"&amp;").replace(/</g,"&lt;").replace(/>/g,"&gt;").replace(/"/g,"&quot;").replace(/'/g,"&#39;")}async function re(n,t){let e={success:!0,files:{icons:[]},errors:[],warnings:[]},r=n.pwa;if(!r?.enabled)return e;try{B.mkdirSync(t,{recursive:!0})}catch{return e.errors.push(`Failed to create output directory: ${t}`),e.success=!1,e}try{let a=_(n);if(a){let s=w.join(t,"manifest.json");await Bun.write(s,a),e.files.manifest=s}}catch(a){let s=a instanceof Error?a.message:String(a);e.errors.push(`Failed to generate manifest.json: ${s}`),e.success=!1}if(r.icons?.src)if(await I()){let s=await M(n,t);if(e.files.icons=s.generatedFiles,e.warnings.push(...s.warnings),!s.success)e.errors.push(...s.errors),e.success=!1}else e.warnings.push("sharp is not installed. Skipping icon generation. Install with: bun add sharp");if(r.offline?.enabled)try{let a=await F(n);if(a){let s=w.join(t,"offline.html");await Bun.write(s,a),e.files.offlinePage=s}}catch(a){let s=a instanceof Error?a.message:String(a);e.errors.push(`Failed to generate offline page: ${s}`),e.success=!1}let o;if(r.precache?.enabled){let a=He(t,n);o={fileCount:a.fileCount,totalSize:a.totalSize},e.precacheStats=o}try{let a=Rs(n,t);if(a){let s=Bt(n),l=w.join(t,s);await Bun.write(l,a),e.files.serviceWorker=l}}catch(a){let s=a instanceof Error?a.message:String(a);e.errors.push(`Failed to generate service worker: ${s}`),e.success=!1}return e}function ae(n,t){return Zo(n,t)}function se(n){return n.pwa?.enabled===!0}export{S as APPLE_TOUCH_ICON_SIZES,v as DEFAULT_ICON_SIZES,P as FAVICON_SIZES,vc as auditBuildOutput,bc as auditConfig,re as buildPwaAssets,wc as calculateAuditResult,fu as formatAuditResult,Qo as formatSize,j as generateManifest,_ as generateManifestJson,mu as generateManifestLink,F as generateOfflinePage,He as generatePrecacheManifest,Sn as generatePrecacheManifestJs,M as generatePwaIcons,$s as generatePwaTags,Rs as generateServiceWorker,yu as generateServiceWorkerAuto,gu as generateSwRegistrationScript,hu as generateThemeColorMeta,N as getExpectedIconPaths,Bt as getServiceWorkerFileName,Zo as injectPwaTags,se as isPwaEnabled,I as isSharpAvailable,xc as isWorkboxEnabled,q as mergeManifestConfig,ae as processPwaHtml,As as pwaDirectives,bu as pwaInstallDirective,wu as pwaOfflineDirective,xu as pwaPushDirective,vu as pwaUpdateDirective,Xp as registerPwaDirectives,pu as runPwaAudit,D as validateManifest};

package/dist/signal-processing.js

@@ -447,32 +447,91 @@ function nextSiblingHasElse(template, fromIndex) {
 export function preEvalLiteralReactiveIfs(template) {
   if (!template.includes(":if") && !template.includes(":show") && !template.includes("x-if") && !template.includes("x-show") && !template.includes("@if=") && !template.includes("@show="))
     return template;
-  const skipRanges = [], rawTagRe = /<(script|style)\b[^>]*>[\s\S]*?<\/\1\s*>/gi;
-  let rawMatch;
-  while ((rawMatch = rawTagRe.exec(template)) !== null)
-    skipRanges.push([rawMatch.index, rawMatch.index + rawMatch[0].length]);
-  const inSkipRange = (i) => skipRanges.some(([s, e]) => i >= s && i < e), tagWithLiteralIf = /<([a-zA-Z][\w-]*)\b((?:\s+[^=\s>]+(?:=(?:"[^"]*"|'[^']*'|[^\s>]*))?)*?)\s+(:if|:show|x-if|x-show|@if|@show)\s*=\s*"([^"]*)"((?:\s+[^=\s>]+(?:=(?:"[^"]*"|'[^']*'|[^\s>]*))?)*\s*)(\/?)>/g, replacements = [];
-  let m;
-  while ((m = tagWithLiteralIf.exec(template)) !== null) {
-    if (inSkipRange(m.index))
-      continue;
-    const [full, tag, beforeAttrs, attrName, value, afterAttrs, selfClose] = m, verdict = evalLiteralCondition(value);
+  const candidates = [], tagName = /<([a-zA-Z][\w-]*)/y, whitespace = /\s/, conditionalNames = new Set([":if", ":show", "x-if", "x-show", "@if", "@show"]);
+  scanAtElementPosition(template, (html, start) => {
+    tagName.lastIndex = start;
+    const name = tagName.exec(html);
+    if (!name || /^(?:script|style)$/i.test(name[1]))
+      return -1;
+    let i = tagName.lastIndex, conditional;
+    while (i < html.length) {
+      const beforeSpace = i;
+      while (i < html.length && whitespace.test(html[i]))
+        i++;
+      let closing = i;
+      if (html[closing] === "/") {
+        closing++;
+        while (closing < html.length && whitespace.test(html[closing]))
+          closing++;
+      }
+      if (html[closing] === ">") {
+        if (conditional)
+          candidates.push({ start, end: closing + 1, tag: name[1], ...conditional });
+        return -1;
+      }
+      if (i === beforeSpace)
+        return -1;
+      const attrStart = i;
+      while (i < html.length && !whitespace.test(html[i]) && html[i] !== "=" && html[i] !== ">")
+        i++;
+      if (i === attrStart)
+        return -1;
+      const attrName = html.slice(attrStart, i);
+      if (attrName.startsWith("@") && attrName.includes("("))
+        return -1;
+      const nameEnd = i;
+      let valueStart = i;
+      while (valueStart < html.length && whitespace.test(html[valueStart]))
+        valueStart++;
+      if (html[valueStart] !== "=") {
+        i = nameEnd;
+        continue;
+      }
+      valueStart++;
+      while (valueStart < html.length && whitespace.test(html[valueStart]))
+        valueStart++;
+      const quote = html[valueStart];
+      if (quote === '"' || quote === "'") {
+        const end = html.indexOf(quote, valueStart + 1);
+        if (end === -1)
+          return -1;
+        if (!conditional && quote === '"' && conditionalNames.has(attrName))
+          conditional = {
+            attrName,
+            attrStart: beforeSpace,
+            attrEnd: end + 1,
+            value: html.slice(valueStart + 1, end)
+          };
+        i = end + 1;
+      } else {
+        i = valueStart;
+        while (i < html.length && !whitespace.test(html[i]) && html[i] !== ">")
+          i++;
+      }
+    }
+    return -1;
+  });
+  const replacements = [];
+  let skippedThrough = -1;
+  for (const candidate of candidates) {
+    const { start: startIdx, end: startTagEnd, tag, attrName, value } = candidate;
+    if (startIdx < skippedThrough)
+      continue;
+    const verdict = evalLiteralCondition(value);
     if (verdict === void 0)
       continue;
-    const startIdx = m.index, startTagEnd = startIdx + full.length, elementEnd = !!selfClose || /\/\s*>$/.test(full) || VOID_ELEMENT_TAGS.has(tag.toLowerCase()) ? startTagEnd : findElementEnd(template, startIdx, tag, startTagEnd);
+    const elementEnd = /\/\s*>$/.test(template.slice(startIdx, startTagEnd)) || VOID_ELEMENT_TAGS.has(tag.toLowerCase()) ? startTagEnd : findElementEnd(template, startIdx, tag, startTagEnd);
     if (elementEnd === -1)
       continue;
-    if ((attrName === ":if" || attrName === "x-if" || attrName === "@if") && nextSiblingHasElse(template, elementEnd)) {
-      tagWithLiteralIf.lastIndex = startTagEnd;
+    if ((attrName === ":if" || attrName === "x-if" || attrName === "@if") && nextSiblingHasElse(template, elementEnd))
       continue;
-    }
     if (verdict === !0) {
-      const rebuiltStartTag = `<${tag}${beforeAttrs}${afterAttrs}${selfClose}>`;
+      const rebuiltStartTag = template.slice(startIdx, candidate.attrStart) + template.slice(candidate.attrEnd, startTagEnd);
       replacements.push({ start: startIdx, end: startTagEnd, replacement: rebuiltStartTag });
       continue;
     }
     replacements.push({ start: startIdx, end: elementEnd, replacement: "" });
-    tagWithLiteralIf.lastIndex = elementEnd;
+    skippedThrough = elementEnd;
   }
   if (replacements.length === 0)
     return template;

package/dist/ssg-static-paths.d.ts

@@ -0,0 +1,12 @@
+import type { StaticPath, StaticPathsResult } from './ssg';
+/** Define static paths for dynamic routes (used in templates). */
+export declare function defineStaticPaths(pathsFn: () => Promise<StaticPath[]> | StaticPath[]): () => Promise<StaticPathsResult>;
+/**
+ * Preserve failure provenance instead of collapsing it into "hook absent".
+ * Hook evaluation remains isolated from the page's other server declarations;
+ * this does not add imported/module-closure evaluation to the SSG.
+ */
+export declare function readStaticPaths(filePath: string): Promise<StaticPathsOutcome>;
+export type StaticPathsOutcome = | { kind: 'absent' }
+  | { kind: 'ok', value: StaticPathsResult }
+  | { kind: 'error', phase: 'read' | 'parse' | 'execute' | 'result', error: Error }

package/dist/ssg-static-paths.js

@@ -0,0 +1,62 @@
+import { classifyAllScripts } from "./script-classifier.js";
+import { declaresClientIdentifier } from "./client-declarations.js";
+import { bracketDepths, stripCommentsAndLiterals } from "./strip-literals.js";
+import { extractBalancedExpression, findMatchingDelimiter } from "./parser/tokenizer.js";
+export function defineStaticPaths(pathsFn) {
+  return async () => ({ paths: await pathsFn(), fallback: !1 });
+}
+let transpiler;
+function hookExpression(code) {
+  const masked = stripCommentsAndLiterals(code), { depths } = bracketDepths(masked), declarations = /\b(?:async\s+)?function\s+getStaticPaths\s*\(/g;
+  let match;
+  while ((match = declarations.exec(masked)) !== null) {
+    if (depths[match.index] !== 0)
+      continue;
+    const paramsEnd = findMatchingDelimiter(masked, "(", ")", declarations.lastIndex - 1), bodyStart = masked.indexOf("{", paramsEnd + 1), bodyEnd = findMatchingDelimiter(masked, "{", "}", bodyStart);
+    if (paramsEnd < 0 || bodyStart < 0 || bodyEnd < 0)
+      break;
+    return code.slice(match.index, bodyEnd + 1);
+  }
+  const variables = /\b(?:const|let|var)\s+getStaticPaths\s*=/g;
+  while ((match = variables.exec(masked)) !== null) {
+    if (depths[match.index] !== 0)
+      continue;
+    const end = extractBalancedExpression(masked, variables.lastIndex).endPos;
+    return code.slice(variables.lastIndex, end).trim();
+  }
+  throw SyntaxError("Could not extract getStaticPaths; use a top-level function or const declaration");
+}
+export async function readStaticPaths(filePath) {
+  let phase = "read";
+  try {
+    const content = await Bun.file(filePath).text();
+    phase = "parse";
+    const scripts = classifyAllScripts(content), serverScripts = [...scripts.server, ...scripts.client, ...scripts.signals].filter((script) => /(?:^|\s)server(?:\s|=|$)/i.test(stripCommentsAndLiterals(script.attrs))).sort((a, b) => content.indexOf(a.fullTag) - content.indexOf(b.fullTag));
+    for (const script of serverScripts) {
+      if (!/\bgetStaticPaths\b/.test(stripCommentsAndLiterals(script.content)))
+        continue;
+      const code = (transpiler ??= new Bun.Transpiler({ loader: "ts", target: "bun" })).transformSync(script.content);
+      if (!/\bgetStaticPaths\b/.test(stripCommentsAndLiterals(code)))
+        continue;
+      const expression = hookExpression(code);
+      if (/\bdefineStaticPaths\b/.test(stripCommentsAndLiterals(expression)) && declaresClientIdentifier(code, "defineStaticPaths"))
+        throw SyntaxError("Cannot evaluate a module-local defineStaticPaths binding during isolated hook extraction");
+      phase = "execute";
+      const hook = Function("defineStaticPaths", `return (${expression})`)(defineStaticPaths);
+      if (typeof hook !== "function")
+        throw TypeError("getStaticPaths must be a function");
+      const returned = await hook();
+      phase = "result";
+      const value = Array.isArray(returned) ? { paths: returned } : returned;
+      if (!value || typeof value !== "object" || !("paths" in value) || !Array.isArray(value.paths))
+        throw TypeError("getStaticPaths must return { paths: [...] } or an array of paths");
+      for (const entry of value.paths)
+        if (!entry || typeof entry !== "object" || !entry.params || typeof entry.params !== "object" || Array.isArray(entry.params))
+          throw TypeError("Each getStaticPaths path must contain a params object");
+      return { kind: "ok", value };
+    }
+    return { kind: "absent" };
+  } catch (error) {
+    return { kind: "error", phase, error: error instanceof Error ? error : Error(String(error)) };
+  }
+}

package/dist/ssg.d.ts

@@ -1,4 +1,5 @@
 /// <reference path="./stx.d.ts" />
+import { defineStaticPaths } from './ssg-static-paths';
 import type { StxOptions } from './types';
 /**
  * Whether a page declares an `action` — the export that receives its own POST.
@@ -34,10 +35,6 @@ export declare function createISRHandler(options?: SSGConfig): {
   revalidate: (route: string) => Promise<void>
   invalidate: (route: string | RegExp) => Promise<void>
 };
-/**
- * Define static paths for dynamic routes (used in templates)
- */
-export declare function defineStaticPaths(pathsFn: () => Promise<StaticPath[]> | StaticPath[]): () => Promise<StaticPathsResult>;
 /**
  * Create a markdown content loader
  */
@@ -193,6 +190,7 @@ declare class FileISRCache implements ISRCache {
   invalidatePattern(pattern: RegExp): Promise<void>;
   needsRevalidation(route: string): Promise<boolean>;
 }
+export { defineStaticPaths } from './ssg-static-paths';
 // =============================================================================
 // Exports
 // =============================================================================