@stacksjs/stx 0.2.179 → 0.2.181

package/dist/store-loader.js

@@ -4,6 +4,7 @@ import { getPublicEnvDefine } from "./public-env.js";
 import { STX_RUNTIME_GLOBALS } from "./runtime-globals.js";
 import { readSigned, sourceSignature, writeSigned } from "./source-signature.js";
 import { stripModuleImports, transformStoreImports } from "./store-imports.js";
+import { getSharedTranspiler } from "./utils.js";
 const _cachedStoreScripts = new Map;
 function collectDeclaredNames(code, into) {
   for (const match of code.matchAll(/\b(?:const|let|var|function|class)\s+([A-Z_a-z$][\w$]*)/g))
@@ -64,7 +65,7 @@ export async function getStoreScript(storesDir) {
       return 0;
     return a.hasUseStore ? 1 : -1;
   });
-  const sortedFiles = filesWithDeps.map((f) => f.file), chunks = [], declaredNames = new Set, transpiler = new Bun.Transpiler({ loader: "ts", target: "browser", define: getPublicEnvDefine() });
+  const sortedFiles = filesWithDeps.map((f) => f.file), chunks = [], declaredNames = new Set, transpiler = getSharedTranspiler({ loader: "ts", target: "browser", define: getPublicEnvDefine() });
   for (const file of sortedFiles)
     try {
       let code = await Bun.file(file).text();

package/dist/stx.d.ts

@@ -586,9 +586,36 @@ declare function $watch<T>(
 // Toast notifications
 // ============================================================================
 
+/*
+ * Every option `addToast` reads (#1932).
+ *
+ * `title`, `id` and `dark` shipped in the runtime for #1913 and none of them
+ * reached here, so the feature built to unblock a migration could not be called
+ * from a typechecked file — `stx typecheck` rejected the exact snippet that
+ * issue was closed with.
+ *
+ * `test/signals/toast-declaration-drift.test.ts` now reads the option names out
+ * of the runtime and fails if this list falls behind again. Adding an option
+ * here without the runtime reading it fails too: a documented option that does
+ * nothing is the quieter half of the same problem.
+ */
 interface StxToastOptions {
   /** Auto-dismiss duration in ms. 0 = persistent. Default: 3000 */
   duration?: number
+  /** Heading rendered above the message, in bold. */
+  title?: string
+  /**
+   * Semantic key. A second toast with the same id REPLACES the first in place
+   * rather than stacking, and `dismiss(id)` ends it — so a persistent
+   * "Publishing…" toast and the call that clears it need not thread the numeric
+   * handle between them.
+   */
+  id?: string | number
+  /**
+   * Force the dark or light palette. Omitted, it follows the document — the
+   * `dark` class, then `data-theme` / `data-color-mode`, then the OS setting.
+   */
+  dark?: boolean
 }
 
 interface StxToast {
@@ -600,8 +627,15 @@ interface StxToast {
   info: (message: string, options?: StxToastOptions) => number
   /** Show a warning toast (yellow) */
   warning: (message: string, options?: StxToastOptions) => number
-  /** Dismiss a toast by id, or all toasts if no id is given */
-  dismiss: (id?: number) => void
+  /**
+   * Dismiss a toast, or all of them if nothing is given.
+   *
+   * Takes the semantic `id` the toast was created with, or the numeric handle
+   * these methods return. The runtime branches on which it got, so a caller does
+   * not have to know which kind it is holding — this used to accept `number`
+   * only, which made replace-by-id unreachable from a typechecked call site.
+   */
+  dismiss: (id?: string | number) => void
 }
 
 declare const toast: StxToast

package/dist/utils.d.ts

@@ -23,6 +23,7 @@ export declare function isJavaScriptScript(attrs: string): boolean;
  * Default: ALL scripts are TypeScript unless explicitly marked as JS
  */
 export declare function shouldTranspileTypeScript(attrs: string): boolean;
+export declare function getSharedTranspiler(options: ConstructorParameters<typeof Bun.Transpiler>[0]): Bun.Transpiler;
 /**
  * Transpile TypeScript code to JavaScript using Bun (sync version)
  */

package/dist/utils.js

@@ -11,6 +11,7 @@ import { getPublicEnvDefine } from "./public-env.js";
 import { processScopedStyles } from "./style-scoping.js";
 import { findSfcTemplateBlock } from "./sfc-template.js";
 import { importOnce } from "./lazy-module.js";
+import { stashScriptElements } from "./html-masking.js";
 export {
   extractDirectiveNames,
   getPositionInfo,
@@ -64,6 +65,23 @@ export function isJavaScriptScript(attrs) {
 export function shouldTranspileTypeScript(attrs) {
   return !isJavaScriptScript(attrs);
 }
+const transpilerPool = new Map;
+export function getSharedTranspiler(options) {
+  let key;
+  try {
+    key = JSON.stringify(options);
+  } catch {
+    return new Bun.Transpiler(options);
+  }
+  const pooled = transpilerPool.get(key);
+  if (pooled)
+    return pooled;
+  if (transpilerPool.size >= 16)
+    transpilerPool.clear();
+  const transpiler = new Bun.Transpiler(options);
+  transpilerPool.set(key, transpiler);
+  return transpiler;
+}
 export function transpileTypeScript(code) {
   try {
     let processedCode = code.replace(/^\s*import\s+\w+\s+from\s+['"][^'"]*\.stx['"]\s*;?\s*$/gm, "");
@@ -84,7 +102,7 @@ export function transpileTypeScript(code) {
       placeholders.push(match);
       return `"__STX_EXPR_${idx}__"`;
     });
-    let result = new Bun.Transpiler({
+    let result = getSharedTranspiler({
       loader: "ts",
       target: "browser",
       define: getPublicEnvDefine()
@@ -564,7 +582,14 @@ ${triedPaths.map((p) => `  - ${p}`).join(`
     for (const [key, val] of Object.entries(parentContext))
       if (!key.startsWith("__") || internalKeysToPreserve.has(key))
         filteredParentContext[key] = val;
-    const { extractSlotContent } = await importOnce("stx/slots", () => import("./slots.js")), parsedSlotContent = extractSlotContent(slotContent), $slots = {};
+    const stashedCallerScripts = stashScriptElements(slotContent), callerClientScripts = [], componentSlotContent = stashedCallerScripts.output.replace(/\x00STX_SCRIPT_(\d+)\x00/g, (_match, index) => {
+      const script = stashedCallerScripts.scripts[Number(index)] || "", attrs = script.match(/^<script\b([^>]*)>/i)?.[1] || "", type = attrs.match(/\btype\s*=\s*["']([^"']+)["']/i)?.[1]?.toLowerCase(), executable = !type || ["module", "text/javascript", "application/javascript"].includes(type);
+      if (!/\bserver\b/i.test(attrs) && executable) {
+        callerClientScripts.push(script);
+        return "";
+      }
+      return script;
+    }), { extractSlotContent } = await importOnce("stx/slots", () => import("./slots.js")), parsedSlotContent = extractSlotContent(componentSlotContent), $slots = {};
     if (parsedSlotContent.defaultSlot?.trim())
       $slots.default = parsedSlotContent.defaultSlot;
     for (const [slotName, slotDef] of parsedSlotContent.namedSlots)
@@ -573,7 +598,7 @@ ${triedPaths.map((p) => `  - ${p}`).join(`
       ...filteredParentContext,
       ...props,
       props,
-      slot: slotContent,
+      slot: componentSlotContent,
       $slots,
       __processedComponents: branchComponents,
       __sections: {},
@@ -762,7 +787,9 @@ finally {
         output,
         dependencies: [...dependencies].filter((dependency) => !dependencyBaseline.has(dependency))
       });
-    return output;
+    return callerClientScripts.length > 0 ? `${output}
+${callerClientScripts.join(`
+`)}` : output;
   } catch (error) {
     return `[Error processing component: ${error instanceof Error ? error.message : String(error)}]`;
   } finally {

package/dist/variable-extractor.js

@@ -1,5 +1,6 @@
 var {require}=import.meta;import path from "node:path";
 import process from "node:process";
+import { getSharedTranspiler } from "./utils.js";
 export const STX_ENGINE_BINDING_NAMES = [
   "module",
   "exports",
@@ -272,7 +273,7 @@ export async function extractVariables(scriptContent, context, filePath, options
     return;
   let jsContent;
   try {
-    const transpiler = new Bun.Transpiler({ loader: "ts", target: "browser", define: getPublicEnvDefine() });
+    const transpiler = getSharedTranspiler({ loader: "ts", target: "browser", define: getPublicEnvDefine() });
     let processedCode = scriptContent.replace(/^\s*import\s+\w+\s+from\s+['"][^'"]*\.stx['"]\s*;?\s*$/gm, "");
     processedCode = processedCode.replace(/^\s*import\s+['"][^'"]*\.stx['"]\s*;?\s*$/gm, "");
     jsContent = transpiler.transformSync(processedCode);

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@stacksjs/stx",
   "type": "module",
-  "version": "0.2.179",
+  "version": "0.2.181",
   "description": "A performant UI Framework. Powered by Bun.",
   "author": "Chris Breuer <chris@stacksjs.org>",
   "license": "MIT",
@@ -117,12 +117,12 @@
   "dependencies": {
     "@cwcss/crosswind": "^0.2.14",
     "@stacksjs/clapp": "^0.2.0",
-    "@stacksjs/desktop": "0.2.179",
-    "@stacksjs/sanitizer": "0.2.179",
+    "@stacksjs/desktop": "0.2.181",
+    "@stacksjs/sanitizer": "0.2.181",
     "@stacksjs/ts-i18n": "^0.1.11",
-    "bun-plugin-stx": "0.2.179",
+    "bun-plugin-stx": "0.2.181",
     "bunfig": "^0.15.17",
-    "stx-router": "0.2.179",
+    "stx-router": "0.2.181",
     "ts-broadcasting": "^0.0.9",
     "ts-images": "^0.1.9",
     "ts-syntax-highlighter": "^0.2.1"

package/stx.d.ts

@@ -586,9 +586,36 @@ declare function $watch<T>(
 // Toast notifications
 // ============================================================================
 
+/*
+ * Every option `addToast` reads (#1932).
+ *
+ * `title`, `id` and `dark` shipped in the runtime for #1913 and none of them
+ * reached here, so the feature built to unblock a migration could not be called
+ * from a typechecked file — `stx typecheck` rejected the exact snippet that
+ * issue was closed with.
+ *
+ * `test/signals/toast-declaration-drift.test.ts` now reads the option names out
+ * of the runtime and fails if this list falls behind again. Adding an option
+ * here without the runtime reading it fails too: a documented option that does
+ * nothing is the quieter half of the same problem.
+ */
 interface StxToastOptions {
   /** Auto-dismiss duration in ms. 0 = persistent. Default: 3000 */
   duration?: number
+  /** Heading rendered above the message, in bold. */
+  title?: string
+  /**
+   * Semantic key. A second toast with the same id REPLACES the first in place
+   * rather than stacking, and `dismiss(id)` ends it — so a persistent
+   * "Publishing…" toast and the call that clears it need not thread the numeric
+   * handle between them.
+   */
+  id?: string | number
+  /**
+   * Force the dark or light palette. Omitted, it follows the document — the
+   * `dark` class, then `data-theme` / `data-color-mode`, then the OS setting.
+   */
+  dark?: boolean
 }
 
 interface StxToast {
@@ -600,8 +627,15 @@ interface StxToast {
   info: (message: string, options?: StxToastOptions) => number
   /** Show a warning toast (yellow) */
   warning: (message: string, options?: StxToastOptions) => number
-  /** Dismiss a toast by id, or all toasts if no id is given */
-  dismiss: (id?: number) => void
+  /**
+   * Dismiss a toast, or all of them if nothing is given.
+   *
+   * Takes the semantic `id` the toast was created with, or the numeric handle
+   * these methods return. The runtime branches on which it got, so a caller does
+   * not have to know which kind it is holding — this used to accept `number`
+   * only, which made replace-by-id unreachable from a typechecked call site.
+   */
+  dismiss: (id?: string | number) => void
 }
 
 declare const toast: StxToast