@stacksjs/stx 0.2.354 → 0.2.356

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

@@ -49,6 +49,15 @@ export interface ScriptBlock {
     code: string;
     /** 1-based line in the source file where the body's first character sits. */
     startLine: number;
+    /**
+     * 1-based column of the body's first character. Greater than 1 when the
+     * code starts on the line the opening tag is on (`<script client>const a`),
+     * which a buffer has to pad for or every diagnostic on that line lands
+     * left of the code it is about.
+     */
+    startColumn?: number;
+    /** Offset of the body's first character in the source. */
+    offset?: number;
     /** The opening tag's attributes, trimmed. */
     attrs: string;
 }
@@ -99,6 +108,8 @@ export interface MappedLine {
 export interface VirtualFile {
     text: string;
     componentDependencies?: Map<string, string>;
+    /** Whether the `reference` option's directive was written (line 1 was free). */
+    referenced?: boolean;
     /**
      * Virtual 1-based line → where it came from.
      *
@@ -239,7 +250,17 @@ export declare function runtimeGlobalDeclarations(): string;
  * checker report a genuine typo instead of suppressing every unresolved name.
  */
 export declare const STX_SERVER_CONTEXT: readonly ['params', 'query', 'cookies', 'host', 'ip', 'setResponseStatus', 'setResponseHeader', 'notFound', 'request', 'url', 'definePageMeta', 'defineClientPayload', 'defineStore', 'props', '$props'];
-export declare function serverContextDeclarations(): string;
+export declare function serverContextDeclarations(typed?: ReadonlySet<string>): string;
+/**
+ * Names a global declaration file declares as values: `declare function`,
+ * `declare const` / `let` / `var`, at the start of a line.
+ *
+ * Used to keep the `any` fallbacks below from colliding with a TYPED global of
+ * the same name in `stx.d.ts` — `definePageMeta` and `defineStore` are both
+ * server context and typed runtime globals, and `declare var x: any` beside
+ * `declare function x()` is a conflict that leaves the name typed by neither.
+ */
+export declare function declaredGlobalNames(declarations: string): Set<string>;
 /**
  * The names a `defineClientPayload({ … })` call publishes, or `null` when the
  * page does not declare one.
@@ -421,6 +442,19 @@ export declare function expressionStatement(expression: TemplateExpression): {
  * change a line count, so every diagnostic still lands on the author's line.
  */
 export declare function absolutizeRelativeSpecifiers(code: string, originDir: string): string;
+/**
+ * Spaces that put a block's first line at the column it occupies in the file.
+ *
+ * A body that starts on the opening tag's line (`<script client>const a = 1`)
+ * was written from column 1, so every diagnostic on that line pointed left of
+ * the code it was about by the width of the tag.
+ */
+export declare function firstLinePadding(block: ScriptBlock): string;
+/**
+ * Local names a block's `import` declarations bind, type-only ones included:
+ * `import a, { b as c, type D } from 'x'` and `import * as ns from 'x'`.
+ */
+export declare function collectImportedNames(code: string): string[];
 export interface BuildVirtualOptions {
     /** Enables component call-site checks using the renderer's file lookup. */
     filePath?: string;
@@ -438,6 +472,28 @@ export interface BuildVirtualOptions {
     originDir?: string;
     /** Append ambient declarations at all. Default true. */
     globals?: boolean;
+    /**
+     * Where the server context, the `@stacksjs/browser` auto-imports and the
+     * template globals are declared. Default `'module'`.
+     *
+     * `'global'` wraps them in `declare global { … }`. Declared in the module
+     * they share a scope with the author's own bindings, so a block's
+     * `const { query } = defineProps()` is a redeclaration of the context's
+     * `query`; declared globally, the block's binding shadows it instead, as it
+     * does in `stx typecheck`, whose context is a global file. The editor, which
+     * has one buffer per file, needs the global form.
+     */
+    contextScope?: 'module' | 'global';
+    /**
+     * A declaration file to pull into the program with a triple-slash
+     * reference, written on the buffer's first line.
+     *
+     * That line is always blank when the file opens with markup or with a
+     * `<script>` tag on a line of its own, which is how every real file starts,
+     * so nothing moves. When code sits on line 1 the reference is left out and
+     * {@link VirtualFile.referenced} says so, so the caller can fall back.
+     */
+    reference?: string;
     /**
      * Declare the stx runtime globals as `any`. Default true.
      *
@@ -479,6 +535,23 @@ export interface ResolvedPosition {
      */
     inGuard?: boolean;
 }
+/**
+ * Whether a diagnostic on a template-expression line is an artefact of how the
+ * expression was wrapped rather than a fault in it. Both checkers drop these,
+ * so the editor and `stx typecheck` agree:
+ *
+ *  - A hit inside the `if (…) {` wrapper that markup guards put around an
+ *    expression is about the enclosing CONDITION, which is checked on a line
+ *    of its own. This copy would report the same fault again against innocent
+ *    markup (stacksjs/stx#2013).
+ *  - TS2774 ("this condition will always return true since this function is
+ *    always defined") is wrong about a template, and only about a template.
+ *    {@link UNWRAP_HELPER} types a signal as the intersection of the signal and
+ *    its value, which stays callable, and the runtime unwraps a name the
+ *    expression only reads — so `x-class="ready ? '' : 'hidden'"` does not
+ *    always return true. In a script block it is a true positive and is kept.
+ */
+export declare function isTemplateArtefact(position: ResolvedPosition, code: number): boolean;
 /**
  * Translate a position in a virtual buffer back to the `.stx` file.
  *

package/dist/stx-virtual-ts.js

@@ -20,7 +20,7 @@ export function extractScriptBlocks(source) {
     if (typeMatch && !/^(?:module|text\/(?:javascript|typescript))$/i.test(typeMatch[1]))
       continue;
     const kind = /\bserver\b/.test(attrs) ? "server" : /\bclient\b/.test(attrs) ? "client" : "plain", startLine = lineAt(source, bodyStart);
-    blocks.push({ kind, code: body, startLine, attrs });
+    blocks.push({ kind, code: body, startLine, startColumn: columnAt(source, bodyStart), offset: bodyStart, attrs });
   }
   return blocks;
 }
@@ -340,10 +340,13 @@ export const STX_SERVER_CONTEXT = [
   "props",
   "$props"
 ];
-export function serverContextDeclarations() {
-  return STX_SERVER_CONTEXT.map((name) => `declare var ${name}: any`).join(`
+export function serverContextDeclarations(typed = new Set) {
+  return STX_SERVER_CONTEXT.filter((name) => !typed.has(name)).map((name) => `declare var ${name}: any`).join(`
 `);
 }
+export function declaredGlobalNames(declarations) {
+  return new Set([...declarations.matchAll(/^declare (?:function|const|let|var)\s+([A-Za-z_$][\w$]*)/gm)].map((match) => match[1]));
+}
 export function extractClientPayloadNames(serverCode) {
   const call = /\bdefineClientPayload\s*\(\s*\{([\s\S]*?)\}\s*\)/g;
   let match, found = !1;
@@ -608,6 +611,27 @@ export function absolutizeRelativeSpecifiers(code, originDir) {
     return `${prefix}${quote}${absolute}${quote}`;
   });
 }
+export function firstLinePadding(block) {
+  return " ".repeat(Math.max(0, (block.startColumn ?? 1) - 1));
+}
+export function collectImportedNames(code) {
+  const names = new Set, stripped = stripCommentsAndLiterals(code);
+  for (const match of stripped.matchAll(/\bimport\s+(?:type\s+)?([\w$*{}\s,]+?)\s+from\b/g)) {
+    const clause = match[1], named = /\{([^}]*)\}/.exec(clause);
+    for (const part of named?.[1].split(",") ?? []) {
+      const local = part.trim().replace(/^type\s+/, "").split(/\s+as\s+/).pop()?.trim();
+      if (local && /^[A-Z_$][\w$]*$/i.test(local))
+        names.add(local);
+    }
+    const outside = clause.replace(/\{[^}]*\}/, ""), namespace = /\*\s*as\s+([A-Z_$][\w$]*)/i.exec(outside);
+    if (namespace)
+      names.add(namespace[1]);
+    const defaultName = /^\s*([A-Z_$][\w$]*)/i.exec(outside);
+    if (defaultName && defaultName[1] !== "type")
+      names.add(defaultName[1]);
+  }
+  return [...names].sort();
+}
 export function buildVirtualTypeScript(source, options = {}) {
   const blocks = extractScriptBlocks(source), sourceLines = source.split(`
 `), lines = Array.from({ length: sourceLines.length }, () => ""), lineMap = new Map, components = options.filePath && options.templateExpressions !== !1 ? componentContractChecks(source, maskNonTemplateRegions(source), {
@@ -617,14 +641,24 @@ export function buildVirtualTypeScript(source, options = {}) {
     readComponent: options.readComponent,
     scriptCode: (text, file) => extractScriptBlocks(text).map((block) => absolutizeRelativeSpecifiers(block.code, path.dirname(file))).join(`
 `)
-  }) : void 0;
-  for (const block of blocks)
-    absolutizeRelativeSpecifiers(block.code, options.originDir ?? "").split(`
-`).forEach((text, i) => {
+  }) : void 0, occupied = new Set, blockEnds = [];
+  for (const block of blocks) {
+    const code = blankScriptDirectives(substituteInterpolationsInPlace(block.code)), bodyLines = absolutizeRelativeSpecifiers(code, options.originDir ?? "").split(`
+`);
+    bodyLines.forEach((text, i) => {
       const index = block.startLine - 1 + i;
-      if (index < lines.length)
-        lines[index] = text;
+      if (index < lines.length) {
+        lines[index] = i === 0 ? firstLinePadding(block) + text : text;
+        occupied.add(index);
+      }
     });
+    blockEnds.push(block.startLine - 1 + bodyLines.length - 1);
+  }
+  for (const end of blockEnds) {
+    const at = lines[end]?.trim() === "" ? end : end + 1;
+    if (at < lines.length && lines[at].trim() === "" && (at === end || !occupied.has(at)))
+      lines[at] = ";";
+  }
   const append = (text, origin) => {
     for (const [index, line] of text.split(`
 `).entries()) {
@@ -635,17 +669,33 @@ export function buildVirtualTypeScript(source, options = {}) {
   };
   if (options.globals !== !1) {
     append("");
-    if (options.runtimeGlobals !== !1)
-      for (const decl of runtimeGlobalDeclarations().split(`
-`))
-        append(decl);
-    for (const decl of serverContextDeclarations().split(`
-`))
-      append(decl);
-    for (const name of BROWSER_CORE_IMPORTS)
-      append(`declare var ${name}: any`);
-    for (const name of STX_TEMPLATE_GLOBALS)
-      append(`declare var ${name}: any`);
+    const bound = new Set([
+      ...blocks.flatMap((block) => collectBlockDeclarations(block.code)),
+      ...blocks.flatMap((block) => collectImportedNames(block.code))
+    ]), declareAny = (name) => {
+      if (!bound.has(name))
+        append(`declare var ${name}: any`);
+    };
+    if (options.runtimeGlobals !== !1) {
+      if (!bound.has("window"))
+        append("declare var window: any");
+      for (const name of STX_RUNTIME_GLOBALS)
+        declareAny(name);
+    }
+    const contextNames = [...new Set([...STX_SERVER_CONTEXT, ...BROWSER_CORE_IMPORTS, ...STX_TEMPLATE_GLOBALS])].filter((name) => options.runtimeGlobals !== !1 || !STX_RUNTIME_GLOBALS.includes(name));
+    if (options.contextScope === "global") {
+      append("declare global {");
+      for (const name of contextNames)
+        append(`  var ${name}: any`);
+      append("}");
+    } else {
+      for (const name of STX_SERVER_CONTEXT)
+        declareAny(name);
+      for (const name of BROWSER_CORE_IMPORTS)
+        declareAny(name);
+      for (const name of STX_TEMPLATE_GLOBALS)
+        declareAny(name);
+    }
     append(`declare var ${INTERPOLATION_PLACEHOLDER}: any`);
     const declared = new Set(blocks.flatMap((block) => collectBlockDeclarations(block.code)));
     append(`type ${ELEMENT_HELPER}<T> = T extends readonly (infer E)[] ? E : T extends Iterable<infer E2> ? E2 : any`);
@@ -695,9 +745,14 @@ export function buildVirtualTypeScript(source, options = {}) {
         append("});");
     }
   }
+  let referenced = !1;
+  if (options.reference && lines[0] !== void 0 && lines[0].trim() === "") {
+    lines[0] = `/// <reference path=${JSON.stringify(options.reference.replace(/\\/g, "/"))} />`;
+    referenced = !0;
+  }
   append("export {}");
   return { text: lines.join(`
-`), lineMap, sourceLineCount: sourceLines.length, componentDependencies: components?.dependencies };
+`), lineMap, sourceLineCount: sourceLines.length, componentDependencies: components?.dependencies, referenced };
 }
 export function lineStarts(text) {
   const starts = [0];
@@ -721,6 +776,11 @@ export function positionToOffset(starts, line, column) {
   const index = Math.min(Math.max(line, 1), starts.length) - 1, next = index + 1 < starts.length ? starts[index + 1] - 1 : Number.MAX_SAFE_INTEGER;
   return Math.min(starts[index] + Math.max(column, 1) - 1, next);
 }
+export function isTemplateArtefact(position, code) {
+  if (!position.expression)
+    return !1;
+  return position.inGuard === !0 || code === 2774;
+}
 export function resolvePosition(virtual, line, column) {
   const mapped = virtual.lineMap.get(line);
   if (!mapped)

package/dist/typecheck.d.ts

@@ -34,6 +34,19 @@ export declare function sourcePathFor(virtualPath: string): string;
  * than hand tsc a path to nothing.
  */
 export declare function findRuntimeTypeDeclarations(): string | null;
+/**
+ * Locate the package's own `stx-module.d.ts`, which declares the virtual `stx`
+ * module a `.stx` block imports from.
+ *
+ * It used to be generated here as `declare module 'stx' { export * from
+ * '@stacksjs/stx' }`, which typed `from 'stx'` as the whole package. That is
+ * not what the specifier binds: a client block gets only what is destructured
+ * off `window.stx`, a server block only what the engine passes in, and every
+ * other name fails at runtime (stacksjs/stx#2028). The declaration file says
+ * exactly that, and the editor plugin loads the same one, so the two checkers
+ * cannot disagree about it.
+ */
+export declare function findStxModuleDeclarations(): string | null;
 export declare function typecheckStxFiles(files: string[], options?: TypecheckOptions): Promise<TypecheckResult>;
 /** Render diagnostics the way a CLI should: file:line:col, then the message. */
 export declare function formatTypecheckDiagnostics(diagnostics: TypecheckDiagnostic[]): string;

package/dist/typecheck.js

@@ -14,35 +14,24 @@ import {
   scrapedBridgeNames,
   serverContextDeclarations,
   blankScriptDirectives,
+  declaredGlobalNames,
+  firstLinePadding,
+  isTemplateArtefact,
   substituteInterpolationsInPlace
 } from "./stx-virtual-ts.js";
+import { stxImportDiagnostics } from "./stx-module-imports.js";
 export {
   extractScriptBlocks,
   extractTemplateExpressions
 } from "./stx-virtual-ts.js";
 export function buildVirtualSource(block, serverCode = "", originDir = "") {
   const leadingNewlines = block.startLine > 1 ? `
-`.repeat(block.startLine - 1) : "", code = blankScriptDirectives(substituteInterpolationsInPlace(block.code)), payload = block.kind === "client" || block.kind === "plain" ? clientPayloadDeclarations(serverCode, block.code) : "";
+`.repeat(block.startLine - 1) : "", code = firstLinePadding(block) + blankScriptDirectives(substituteInterpolationsInPlace(block.code)), payload = block.kind === "client" || block.kind === "plain" ? clientPayloadDeclarations(serverCode, block.code) : "";
   return absolutizeRelativeSpecifiers(`${leadingNewlines + code}
 ${payload}
 export {}
 `, originDir);
 }
-function virtualStxModuleDeclaration(files) {
-  const anchor = files.length > 0 ? path.dirname(path.resolve(files[0])) : process.cwd();
-  try {
-    Bun.resolveSync("@stacksjs/stx", anchor);
-  } catch {
-    return "";
-  }
-  return [
-    "// Generated \u2014 `stx` is the virtual specifier client-script.ts strips.",
-    "declare module 'stx' {",
-    "  export * from '@stacksjs/stx'",
-    "}"
-  ].join(`
-`);
-}
 const WINDOW_OWNED_NAMES = new Set([
   "name",
   "status",
@@ -94,9 +83,15 @@ export function sourcePathFor(virtualPath) {
   return virtualPath.replace(/\.__stx_(?:server|client|plain|template)\d+\.ts$/, "");
 }
 export function findRuntimeTypeDeclarations() {
+  return findPackageDeclarations("stx.d.ts");
+}
+export function findStxModuleDeclarations() {
+  return findPackageDeclarations("stx-module.d.ts");
+}
+function findPackageDeclarations(name) {
   for (const candidate of [
-    path.resolve(import.meta.dir, "..", "stx.d.ts"),
-    path.resolve(import.meta.dir, "..", "..", "stx.d.ts")
+    path.resolve(import.meta.dir, "..", name),
+    path.resolve(import.meta.dir, "..", "..", name)
   ])
     if (existsSync(candidate))
       return candidate;
@@ -190,7 +185,7 @@ function readProjectPathAliases(startDir) {
   return { paths: absolute };
 }
 export async function typecheckStxFiles(files, options = {}) {
-  const checkClient = options.client !== !1, checkServer = options.server !== !1, checkTemplates = options.templates !== !1, componentsDir = options.componentsDir ?? (checkTemplates ? (await loadStxConfig()).componentsDir : void 0), virtualFiles = new Map, scrapedByFile = new Map, checkedFiles = [];
+  const checkClient = options.client !== !1, checkServer = options.server !== !1, checkTemplates = options.templates !== !1, componentsDir = options.componentsDir ?? (checkTemplates ? (await loadStxConfig()).componentsDir : void 0), virtualFiles = new Map, scrapedByFile = new Map, importDiagnostics = [], checkedFiles = [];
   let blockCount = 0, expressionCount = 0;
   const runtimeTypes = findRuntimeTypeDeclarations();
   for (const file of files) {
@@ -200,6 +195,16 @@ export async function typecheckStxFiles(files, options = {}) {
       return checkClient;
     }), serverCode = extractScriptBlocks(source).filter((block) => block.kind === "server").map((block) => block.code).join(`
 `);
+    for (const d of stxImportDiagnostics(source, blocks))
+      importDiagnostics.push({
+        file,
+        line: d.line,
+        column: d.column,
+        code: 0,
+        message: d.message,
+        category: "error",
+        blockKind: d.kind
+      });
     if (checkClient && serverCode) {
       const clientBlocks = blocks.filter((block) => block.kind !== "server"), names = [...new Set(clientBlocks.flatMap((block) => scrapedBridgeNames(serverCode, block.code)))];
       if (names.length > 0)
@@ -227,20 +232,22 @@ export async function typecheckStxFiles(files, options = {}) {
       });
   }
   if (virtualFiles.size === 0)
-    return { diagnostics: [], checkedFiles, blockCount: 0, expressionCount: 0 };
+    return { diagnostics: importDiagnostics, checkedFiles, blockCount: 0, expressionCount: 0 };
   const ambient = (options.extraLibs ?? []).map((lib) => path.resolve(lib));
   if (runtimeTypes)
     ambient.push(runtimeTypes);
+  const stxModule = runtimeTypes ? findStxModuleDeclarations() : null;
+  if (stxModule)
+    ambient.push(stxModule);
   const globalsDts = `${stateDir()}/typecheck/__stx_globals.d.ts`, globalDecls = [
     "// Generated \u2014 the context serve.ts injects into <script server> blocks.",
-    serverContextDeclarations(),
+    serverContextDeclarations(runtimeTypes ? declaredGlobalNames(readFileSync(runtimeTypes, "utf8")) : void 0),
     ...runtimeTypes ? [] : ["declare const window: any", ...STX_RUNTIME_GLOBALS.map((name) => `declare const ${name}: any`)],
     [
       "// Generated \u2014 the names stx auto-imports from @stacksjs/browser.",
       ...BROWSER_CORE_IMPORTS.map((name) => `declare const ${name}: any`)
     ].join(`
 `),
-    virtualStxModuleDeclaration(files),
     composableGlobalDeclarations(await listComposableModules())
   ].filter(Boolean).join(`
 `), workDir = `${stateDir()}/typecheck`;
@@ -305,9 +312,7 @@ export async function typecheckStxFiles(files, options = {}) {
         const at = resolvePosition(entry.virtual, line, column);
         if (!at?.expression)
           continue;
-        if (at.inGuard)
-          continue;
-        if (Number(code) === 2774)
+        if (isTemplateArtefact(at, Number(code)))
           continue;
         line = at.line;
         column = at.column;
@@ -345,6 +350,7 @@ export async function typecheckStxFiles(files, options = {}) {
         blockKind: scraped.kind
       });
     }
+  diagnostics.push(...importDiagnostics);
   const seen = new Set, unique = diagnostics.filter((d) => {
     const key = `${d.file}:${d.line}:${d.column}:${d.code}:${d.message}`;
     if (seen.has(key))

package/dist/variable-extractor.d.ts

@@ -1,25 +1,5 @@
-/**
- * The runtime bindings the engine hands a `<script server>` block as function
- * parameters, in the order the parameters are declared.
- *
- * This drives the `new Function` parameter list rather than sitting beside it,
- * because the two must not drift: the value list below it is positional, so a
- * name added in one place and not the other silently rebinds every argument
- * after it.
- *
- * It is also the set a `from 'stx'` import must not redeclare. A server script
- * writing the documented `import { defineProps } from 'stx'` was rewritten to
- * `const { defineProps } = await import('stx')`, and that `const` shadows the
- * parameter of the same name. The package's own `defineProps` reads
- * `globalThis.__STX_CURRENT_PROPS__`, which nothing on the server path ever
- * sets — so props came back `{}` and every component rendered empty.
- *
- * It went unnoticed because `stx` does not resolve inside this repo (the
- * published package is `@stacksjs/stx`; the root `stx` is private), so the
- * generated `await import('stx')` rejected and the shadowing binding was never
- * created. The failure needed a real install to appear.
- */
-export declare const STX_ENGINE_BINDING_NAMES: readonly ['module', 'exports', 'require', 'props', '$props', '$bool', 'defineProps', 'withDefaults', 'defineClientPayload', 'useServerData', 'useRuntimeConfig', 'useServerRuntimeConfig', 'state', 'derived', 'effect', 'batch', 'onMount', 'onDestroy', 'definePageMeta', 'useRoute', 'useRouter', 'useHead', 'useSeoMeta', 'setResponseStatus', 'setResponseHeader', 'notFound', 'ref', 'reactive', 'computed', 'watch', 'onMounted', 'onUnmounted', 'nextTick', 'defineEmits', 'defineExpose', 'defineSlots', 'provide', 'inject', 'useColorMode', 'useDark', 'useMediaQuery', 'useScrollLock', 'usePreferredDark', 'usePreferredLight', 'usePreferredReducedMotion', 'usePreferredContrast', 'window', 'document', 'console', 'confirm', 'alert', 'fetch', 'params'];
+import { STX_ENGINE_BINDING_NAMES } from './engine-bindings';
+export { STX_ENGINE_BINDING_NAMES };
 /**
  * Strip TypeScript-specific syntax to make it executable as JavaScript
  *

package/dist/variable-extractor.js

@@ -4,61 +4,9 @@ import { useServerData, withServerData } from "./server-data.js";
 import { prepareRuntimeConfig } from "./runtime-config-loader.js";
 import { currentRuntimeConfig, resolveRuntimeConfig, useRuntimeConfig, useServerRuntimeConfig, withRuntimeConfig } from "./runtime-config-server.js";
 import { getSharedTranspiler } from "./utils.js";
-export const STX_ENGINE_BINDING_NAMES = [
-  "module",
-  "exports",
-  "require",
-  "props",
-  "$props",
-  "$bool",
-  "defineProps",
-  "withDefaults",
-  "defineClientPayload",
-  "useServerData",
-  "useRuntimeConfig",
-  "useServerRuntimeConfig",
-  "state",
-  "derived",
-  "effect",
-  "batch",
-  "onMount",
-  "onDestroy",
-  "definePageMeta",
-  "useRoute",
-  "useRouter",
-  "useHead",
-  "useSeoMeta",
-  "setResponseStatus",
-  "setResponseHeader",
-  "notFound",
-  "ref",
-  "reactive",
-  "computed",
-  "watch",
-  "onMounted",
-  "onUnmounted",
-  "nextTick",
-  "defineEmits",
-  "defineExpose",
-  "defineSlots",
-  "provide",
-  "inject",
-  "useColorMode",
-  "useDark",
-  "useMediaQuery",
-  "useScrollLock",
-  "usePreferredDark",
-  "usePreferredLight",
-  "usePreferredReducedMotion",
-  "usePreferredContrast",
-  "window",
-  "document",
-  "console",
-  "confirm",
-  "alert",
-  "fetch",
-  "params"
-];
+import { STX_ENGINE_BINDING_NAMES } from "./engine-bindings.js";
+
+export { STX_ENGINE_BINDING_NAMES };
 const ENGINE_BINDINGS = new Set(STX_ENGINE_BINDING_NAMES), CONTEXT_RESERVED_BINDINGS = new Set(["props", "$props", "defineProps"]), STX_RUNTIME_SPECIFIERS = new Set(["stx", "@stacksjs/stx"]);
 import { findMatchingDelimiter } from "./parser/tokenizer.js";
 import { mergeHeadConfigs, seoMetaToHeadConfig } from "./head.js";

package/dist/visual-testing.js

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

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@stacksjs/stx",
   "type": "module",
-  "version": "0.2.354",
+  "version": "0.2.356",
   "description": "A performant UI Framework. Powered by Bun.",
   "author": "Chris Breuer <chris@stacksjs.org>",
   "license": "MIT",
@@ -84,7 +84,8 @@
     "LICENSE.md",
     "README.md",
     "dist",
-    "stx.d.ts"
+    "stx.d.ts",
+    "stx-module.d.ts"
   ],
   "scripts": {
     "build": "bun run build:css && bun --bun build.ts",
@@ -117,12 +118,12 @@
   "dependencies": {
     "@stacksjs/ts-css": "^0.3.2",
     "@stacksjs/clapp": "^0.2.16",
-    "@stacksjs/desktop": "0.2.354",
-    "@stacksjs/sanitizer": "0.2.354",
+    "@stacksjs/desktop": "0.2.356",
+    "@stacksjs/sanitizer": "0.2.356",
     "@stacksjs/ts-i18n": "^0.1.11",
-    "bun-plugin-stx": "0.2.354",
+    "bun-plugin-stx": "0.2.356",
     "bunfig": "^0.15.19",
-    "stx-router": "0.2.354",
+    "stx-router": "0.2.356",
     "ts-broadcasting": "^0.0.10",
     "ts-images": "^0.2.22",
     "ts-syntax-highlighter": "^0.2.1"