@stacksjs/stx 0.2.179 → 0.2.180

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

@@ -64,6 +64,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 +101,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()

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@stacksjs/stx",
   "type": "module",
-  "version": "0.2.179",
+  "version": "0.2.180",
   "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.180",
+    "@stacksjs/sanitizer": "0.2.180",
     "@stacksjs/ts-i18n": "^0.1.11",
-    "bun-plugin-stx": "0.2.179",
+    "bun-plugin-stx": "0.2.180",
     "bunfig": "^0.15.17",
-    "stx-router": "0.2.179",
+    "stx-router": "0.2.180",
     "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