@stacksjs/stx 0.2.153 → 0.2.154

package/dist/state-management.js

@@ -505,7 +505,10 @@ else {
     });
   };
 
-  window.stx = s;
+  // Merge, never replace (#1804). s was seeded from window.stx above, so this
+  // keeps both any earlier keys and the object identity the waitForStore
+  // closure captured.
+  window.stx = Object.assign(window.stx || {}, s);
 })();
 `;
 }

package/dist/store-loader.d.ts

@@ -1,14 +1,3 @@
-/**
- * Discover store files from storesDir and bundle them into a single
- * script that can be injected into the page.
- *
- * The bundle runs `defineStore(...)` for each store — since the signals
- * runtime is already loaded, `defineStore`/`state`/`derived` are globals.
- *
- * Pass an absolute `storesDir` to look up stores there. When omitted, falls
- * back to reading `storesDir` from the stx config at the current working
- * directory — which is only correct when run from the app's own root.
- */
 export declare function getStoreScript(storesDir?: string): Promise<string | null>;
 /**
  * Clear the cached store script (for dev mode hot reload).

package/dist/store-loader.js

@@ -1,7 +1,26 @@
 import path from "node:path";
 import { loadStxConfig } from "./config.js";
 import { getPublicEnvDefine } from "./public-env.js";
+import { STX_RUNTIME_GLOBALS } from "./runtime-globals.js";
+import { transformStoreImports } from "./store-imports.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))
+    if (match[1])
+      into.add(match[1]);
+  for (const match of code.matchAll(/\b(?:const|let|var)\s*\{([^{}]*)\}\s*=/g))
+    for (const part of (match[1] ?? "").split(",")) {
+      const name = ((part.includes(":") ? part.split(":").pop() : part) ?? "").replace(/=.*$/s, "").replace(/^\s*\.\.\./, "").trim();
+      if (/^[A-Z_a-z$][\w$]*$/.test(name))
+        into.add(name);
+    }
+  for (const match of code.matchAll(/\b(?:const|let|var)\s*\[([^\]]*)\]\s*=/g))
+    for (const part of (match[1] ?? "").split(",")) {
+      const name = part.replace(/=.*$/s, "").replace(/^\s*\.\.\./, "").trim();
+      if (/^[A-Z_a-z$][\w$]*$/.test(name))
+        into.add(name);
+    }
+}
 export async function getStoreScript(storesDir) {
   let resolvedDir;
   if (storesDir)
@@ -44,11 +63,13 @@ export async function getStoreScript(storesDir) {
       return 0;
     return a.hasUseStore ? 1 : -1;
   });
-  const sortedFiles = filesWithDeps.map((f) => f.file), chunks = [], transpiler = new Bun.Transpiler({ loader: "ts", target: "browser", define: getPublicEnvDefine() });
+  const sortedFiles = filesWithDeps.map((f) => f.file), chunks = [], declaredNames = new Set, transpiler = new Bun.Transpiler({ loader: "ts", target: "browser", define: getPublicEnvDefine() });
   for (const file of sortedFiles)
     try {
       let code = await Bun.file(file).text();
       const storeName = path.basename(file, ".ts");
+      collectDeclaredNames(code, declaredNames);
+      code = transformStoreImports(code);
       code = code.replace(/^import\s+.*from\s+['"][^'"]+['"]\s*;?\s*$/gm, "");
       code = code.replace(/^export\s+(default\s+)?/gm, "");
       code = transpiler.transformSync(code);
@@ -61,10 +82,13 @@ ${code.trim()}`);
     _cachedStoreScripts.set(resolvedDir, "");
     return null;
   }
-  const code = `;(function(){
-${chunks.join(`
+  const joinedChunks = chunks.join(`
 
+`), code = `;(function(){
+var __stx = window.stx || {};
+${STX_RUNTIME_GLOBALS.filter((name) => !declaredNames.has(name) && new RegExp(`\\b${name}\\b`).test(joinedChunks)).map((name) => `var ${name} = __stx[${JSON.stringify(name)}];`).join(`
 `)}
+${joinedChunks}
 })();`;
   _cachedStoreScripts.set(resolvedDir, code);
   return code;

package/dist/strict-lint.d.ts

@@ -33,17 +33,20 @@ export declare interface StxStrictOptions {
  * with low false-positive rate).
  *
  * Phase 1 covers the five highest-hit footguns from the issue:
- *   1. stx/no-bare-function-ref-in-event       `@click="toggleLike"` (no parens)
- *   2. stx/no-view-level-script-client         `<script client>` in a view file
- *   3. stx/store-value-imports-must-be-local   value import escaping resources/stores/
- *   4. stx/no-signal-call-in-for-iteration-var calling the `:for` loop var like a signal
- *   5. stx/no-backticks-in-html-comments       a backtick inside an HTML comment
+ *   1. stx/no-bare-function-ref-in-event       `@click="store.method"` (member path)
+ *   2. stx/store-value-imports-must-be-local   value import escaping resources/stores/
+ *   3. stx/no-signal-call-in-for-iteration-var calling the `:for` loop var like a signal
+ *   4. stx/no-backticks-in-html-comments       a backtick inside an HTML comment
+ *
+ * `stx/no-view-level-script-client` was removed in #1815: it asserted at error
+ * severity that a view-level `<script client>` is silently dropped, which is
+ * false — it is the primary documented authoring pattern, and its symbols reach
+ * the built page. The rule told people to break working code.
  *
  * Remaining footguns (web-components, template tags, @include loop-var
  * forwarding, etc.) are Phase 2.
  */
 export type StxStrictRuleId = | 'stx/no-bare-function-ref-in-event'
-  | 'stx/no-view-level-script-client'
   | 'stx/store-value-imports-must-be-local'
   | 'stx/no-signal-call-in-for-iteration-var'
   | 'stx/no-backticks-in-html-comments';

package/dist/strict-lint.js

@@ -117,11 +117,11 @@ function ruleBareFunctionRef(src, spans, out) {
     if (DIRECTIVE_ATTR_NAMES.has(base))
       continue;
     const value = m[3].trim();
-    if (/^[A-Za-z_$][\w$]*(?:\.[A-Za-z_$][\w$]*)*$/.test(value)) {
+    if (/^[A-Za-z_$][\w$]*(?:\.[A-Za-z_$][\w$]*)+$/.test(value)) {
       const at = src.indexOf(m[3], m.index), { line, column } = offsetToLineCol(src, at < 0 ? m.index : at);
       out.push({
         ruleId: "stx/no-bare-function-ref-in-event",
-        message: `Event handler @${m[1]}="${value}" is a bare reference and will not fire. Call it: @${m[1]}="${value}()".`,
+        message: `Event handler @${m[1]}="${value}" is a member path, which the runtime does not invoke \u2014 it only auto-calls a plain identifier. Call it: @${m[1]}="${value}($event)".`,
         line,
         column,
         severity: "error"
@@ -129,23 +129,6 @@ function ruleBareFunctionRef(src, spans, out) {
     }
   }
 }
-function ruleViewLevelScriptClient(src, fileKind, out) {
-  if (fileKind !== "view")
-    return;
-  const re = /<script\b([^>]*)>/gi;
-  let m;
-  while ((m = re.exec(src)) !== null)
-    if (/(?:^|\s)client(?=[\s/=]|$)/i.test(m[1])) {
-      const { line, column } = offsetToLineCol(src, m.index);
-      out.push({
-        ruleId: "stx/no-view-level-script-client",
-        message: "<script client> at the top level of a view is silently dropped \u2014 only components get client scopes. Move it into a component, or use <script> (server).",
-        line,
-        column,
-        severity: "error"
-      });
-    }
-}
 function normalizePath(p) {
   const parts = p.split("/"), out = [];
   for (const seg of parts) {
@@ -268,8 +251,6 @@ export function lintStxStrict(source, options = {}) {
   const out = [], spans = rawTextSpans(source), filePath = (options.filePath ?? "").replace(/\\/g, "/"), fileKind = options.fileKind ?? (/\/components?\//i.test(filePath) ? "component" : /\/layouts?\//i.test(filePath) ? "layout" : "view");
   if (isRuleOn(options.rules, "stx/no-bare-function-ref-in-event"))
     ruleBareFunctionRef(source, spans, out);
-  if (isRuleOn(options.rules, "stx/no-view-level-script-client"))
-    ruleViewLevelScriptClient(source, fileKind, out);
   if (filePath && isRuleOn(options.rules, "stx/store-value-imports-must-be-local"))
     ruleStoreValueImports(source, filePath, out);
   if (isRuleOn(options.rules, "stx/no-signal-call-in-for-iteration-var"))

package/dist/stx.d.ts

@@ -82,23 +82,49 @@ declare function onMount(_fn: () => void | StxCleanup): void
 declare function onDestroy(_fn: () => void): void
 declare function onBeforeMount(_fn: () => void): void
 declare function onMounted(_fn: () => void | StxCleanup): void
-declare function onBeforeUpdate(_fn: () => void): void
-declare function onUpdated(_fn: () => void): void
 declare function onBeforeUnmount(_fn: () => void): void
 declare function onUnmounted(_fn: () => void): void
-declare function onErrorCaptured(_fn: (error: unknown, instance: HTMLElement | null, info: string) => boolean | void): void
+// onBeforeUpdate / onUpdated / onErrorCaptured are NOT declared: they exist in
+// reactivity.ts and composition-api.ts but have no client-runtime counterpart,
+// so declaring them promised a global that resolved to undefined (#1804).
 
 // ============================================================================
 // Template refs
 // ============================================================================
 
+/** Stable per-component id, unique across instances. */
+declare function useId(_prefix?: string): string
+/**
+ * Signal tracking a parent-driven `:prop="signal()"` attribute on the
+ * component's root element. One-way: parent to child.
+ */
+declare function useReactiveProp<T = unknown>(
+  _name: string,
+  _defaultValue?: T,
+  _options?: { parse?: (_value: string) => T },
+): StxSignal<T>
 declare function useRef<T = HTMLElement>(_name: string): { current: T | null }
 
 // ============================================================================
 // Routing / navigation
 // ============================================================================
 
-declare function navigate(_url: string, _options?: { replace?: boolean }): void
+interface StxNavigateOptions {
+  /** Replace the current history entry instead of pushing a new one. */
+  replace?: boolean
+  /** Bypass the SPA router and perform a full document load. */
+  reload?: boolean
+}
+
+/**
+ * Navigate via the SPA router.
+ *
+ * The second argument is deliberately NOT typed to also accept a boolean. The
+ * legacy positional `forceReload` boolean still works at runtime — it was the
+ * shape that actually shipped — but keeping it out of the type means nothing
+ * that type-checks today changes meaning (#1807).
+ */
+declare function navigate(_url: string, _options?: StxNavigateOptions): void
 declare function goBack(): void
 declare function goForward(): void
 declare function useRoute(): {
@@ -108,11 +134,39 @@ declare function useRoute(): {
   hash: string
 }
 declare function setRouteParams(_params: Record<string, string>): void
+/** How a search-param mutation is written to session history (#1825). */
+interface StxSearchParamsCommitOptions {
+  /** Replace the current history entry instead of pushing a new one. */
+  replace?: boolean
+}
+
+/**
+ * Reactive access to the URL query string.
+ *
+ * The declaration was wrong in both directions (#1806): it promised `delete`
+ * and `has`, which did not exist at runtime, and omitted `setAll` and `data`,
+ * which did. `delete`/`has` are now implemented rather than dropped; `get`
+ * returns `undefined` for a missing key, not `null`, which is what the runtime
+ * and the docs have always said.
+ */
 declare function useSearchParams(): {
-  get: (key: string) => string | null
-  set: (key: string, value: string) => void
-  delete: (key: string) => void
-  has: (key: string) => boolean
+  /** The backing signal — read it to make a binding reactive to the query. */
+  data: StxSignal<Record<string, string>>
+  get: (_key: string) => string | undefined
+  has: (_key: string) => boolean
+  /** Set a param. Pushes a history entry unless `{ replace: true }` is passed. */
+  set: (_key: string, _value: string, _options?: StxSearchParamsCommitOptions) => void
+  /**
+   * Remove a param. Pushes a history entry unless `{ replace: true }` is passed.
+   *
+   * CONSUMING a one-shot param — an OAuth callback result, `?checkout=success`,
+   * a flash token — needs `{ replace: true }`. Under the default push, the URL
+   * that still carries the param becomes the previous history entry, so Back
+   * replays the callback and re-runs whatever consuming it triggered (#1825).
+   */
+  delete: (_key: string, _options?: StxSearchParamsCommitOptions) => void
+  /** Set several params. Pushes a history entry unless `{ replace: true }` is passed. */
+  setAll: (_values: Record<string, string>, _options?: StxSearchParamsCommitOptions) => void
 }
 
 // ============================================================================
@@ -160,7 +214,6 @@ declare function useEventListener(
 declare function useScrollLock(
   _target?: HTMLElement | null | { current?: HTMLElement | null, value?: HTMLElement | null } | (() => HTMLElement | null | undefined),
 ): StxSignal<boolean>
-declare function useMeta(_meta: Record<string, string>): void
 declare function useClickOutside(_target: HTMLElement | StxRef<HTMLElement | null> | string | null, _handler: (event: MouseEvent) => void): StxCleanup
 declare function useFocus(_target: HTMLElement | StxRef<HTMLElement | null> | string | null): { focused: StxSignal<boolean>, focus: () => void, blur: () => void }
 
@@ -209,6 +262,44 @@ declare function useAsync<T>(_fn: () => Promise<T>): {
 declare function useLocalStorage<T>(_key: string, _defaultValue: T): StxSignal<T>
 declare function useSessionStorage<T>(_key: string, _defaultValue: T): StxSignal<T>
 
+/**
+ * Options accepted by the auto-imported `useCookie` global.
+ *
+ * This describes the CLIENT RUNTIME's cookie composable, which is what a bare
+ * `useCookie(...)` in a `<script client>` block resolves to. The module export
+ * `@stacksjs/stx/composables` accepts a slightly wider `expires` (Date, epoch ms
+ * or parseable string); the runtime calls `.toUTCString()` on it, so only a Date
+ * works there. See #1710.
+ */
+interface StxCookieOptions {
+  /** Max age in seconds. */
+  maxAge?: number
+  /** Expiration date. */
+  expires?: Date
+  /** Cookie path. Defaults to '/'. */
+  path?: string
+  /** Cookie domain. */
+  domain?: string
+  /** Secure flag. Defaults to true when location.protocol is https:. */
+  secure?: boolean
+  /** SameSite attribute. Defaults to 'Lax'. */
+  sameSite?: 'Strict' | 'Lax' | 'None' | 'strict' | 'lax' | 'none'
+  /** Value returned when the cookie is absent. Defaults to ''. */
+  defaultValue?: string
+  /** Custom encoder. Defaults to encodeURIComponent. */
+  encode?: (_value: string) => string
+  /** Custom decoder. Defaults to decodeURIComponent. */
+  decode?: (_value: string) => string
+}
+
+/**
+ * Reactive binding to a single cookie (#1808).
+ *
+ * Returns a signal, like `useLocalStorage` — writes serialise straight to
+ * `document.cookie`, and `.set('')` deletes by emitting `max-age=0`.
+ */
+declare function useCookie(_name: string, _options?: StxCookieOptions): StxSignal<string>
+
 // ============================================================================
 // WebSocket
 // ============================================================================
@@ -317,6 +408,8 @@ interface StxSeoMetaConfig {
 
 declare function useHead(_config: StxHeadConfig): void
 declare function useSeoMeta(_config: StxSeoMetaConfig): void
+/** No-op on the client; the real one runs at SSR/SSG time. */
+declare function definePageMeta(_meta: Record<string, unknown>): void
 
 // ============================================================================
 // Vue-style reactivity (alternative API)
@@ -348,9 +441,9 @@ declare function defineExpose<T extends Record<string, any>>(_exposed: T): void
 declare function defineSlots<T extends Record<string, (..._args: any[]) => any> = Record<string, (..._args: any[]) => any>>(): T
 declare function provide<T>(_key: string | symbol, _value: T): void
 declare function inject<T>(_key: string | symbol, _defaultValue?: T): T | undefined
-declare function getCurrentInstance(): any
 declare function useSlots(): Record<string, any>
-declare function useAttrs(): Record<string, any>
+// getCurrentInstance / useAttrs are NOT declared — composition-api.ts exports
+// them for server use; no client-runtime counterpart exists (#1804).
 declare function $computed<T>(_getter: () => T): StxRef<T>
 declare function $watch<T>(
   _source: (() => T) | StxRef<T> | StxSignal<T>,
@@ -462,16 +555,18 @@ declare function defineStore<S extends Record<string, any>, G extends Record<str
   },
 ): () => S & G & A
 declare function useStore<T = any>(_id: string): T
-declare function createStore<T>(_setup: () => T, _options?: StxStoreOptions): () => T
-declare function action<T extends (..._args: any[]) => any>(_fn: T): T
-declare function createSelector<T, R>(_selector: (state: T) => R): (state: T) => R
+declare function registerStoresClient(_stores: Record<string, unknown>): void
+// createStore / createSelector are exported by state-management.ts for server
+// use and `action` has no implementation anywhere; none reaches window.stx, so
+// none is declared as an ambient global (#1804).
 
 // ============================================================================
 // JSX runtime (Vue/React style)
 // ============================================================================
 
-declare function h(_tag: string | Function, _props?: Record<string, any> | null, ..._children: any[]): any
-declare const Fragment: unique symbol
+// h / Fragment belong to the JSX runtime (jsx-runtime.ts) and are resolved by
+// the transform, not destructured off window.stx — so they are not ambient
+// globals (#1804). Import them explicitly if you call them directly.
 
 // ============================================================================
 // window.stx registry

package/dist/unresolved-identifiers.d.ts

@@ -0,0 +1,50 @@
+/**
+ * Find identifiers a script CALLS that resolve to nothing in the browser.
+ *
+ * Restricted to names we can name a cause for — exports of `composables/` with
+ * no runtime counterpart. A broader "looks like a hook and is not in scope"
+ * heuristic would fire on legitimate local helpers and app composables, and a
+ * warning people learn to ignore is worse than no warning.
+ *
+ * @param source the script body, after imports have been transformed
+ * @param provided names already in scope (runtime globals, locals, imports)
+ */
+export declare function findUnresolvedIdentifiers(source: string, provided: Iterable<string>): UnresolvedIdentifier[];
+/**
+ * Report unresolved identifiers against a file, once each.
+ *
+ * Returns the diagnostics so callers can assert on them without capturing
+ * console output.
+ */
+export declare function reportUnresolvedIdentifiers(source: string, provided: Iterable<string>, filePath: string): UnresolvedIdentifier[];
+/**
+ * Diagnose an identifier a client script calls that will not exist in the browser.
+ *
+ * `packages/stx/src/composables/` exports 149 functions. Only 29 of them reach
+ * the client runtime; the other 120 are module exports with no counterpart on
+ * `window.stx`. They type-check, they autocomplete, and calling one from a
+ * `<script client>` block throws `ReferenceError` — which used to take down the
+ * whole page (fixed in the DOMContentLoaded handler, stacksjs/stx#1805).
+ *
+ * Containing the throw stops one bad name costing the document, but the author
+ * still has to work out WHY a documented, exported, type-checking composable is
+ * not defined. This turns that into a message at compile time naming the
+ * identifier, the file, and the fix.
+ *
+ * Deliberately a warning, not a build failure. #1810 is a report of the dev
+ * server aborting on one bad view with no filename; adding a second way to abort
+ * the build would be solving one complaint by creating another.
+ */
+/**
+ * Functions `composables/index.ts` exports that the client runtime does NOT
+ * provide.
+ *
+ * Generated — `test/unresolved-identifiers.test.ts` recomputes it from the real
+ * module surface and fails when this drifts, so it cannot silently rot the way
+ * the auto-import list did (#1804).
+ */
+export declare const SERVER_ONLY_COMPOSABLES: readonly string[];
+export declare interface UnresolvedIdentifier {
+  name: string
+  message: string
+}

package/dist/unresolved-identifiers.js

@@ -0,0 +1,146 @@
+export const SERVER_ONLY_COMPOSABLES = [
+  "broadcast",
+  "calculateDistance",
+  "canNotify",
+  "clearCookies",
+  "clearFetchCache",
+  "clearStorage",
+  "copyToClipboard",
+  "createShareableFile",
+  "getBatteryLevel",
+  "getCookie",
+  "getCurrentPosition",
+  "getStorageKeys",
+  "getStorageSize",
+  "getVoices",
+  "hasBattery",
+  "hasCameraPermission",
+  "hasGeolocationPermission",
+  "hasMicrophonePermission",
+  "hasNotificationPermission",
+  "hasResizeObserver",
+  "hexToHsl",
+  "hexToRgb",
+  "isBroadcastChannelSupported",
+  "isCharging",
+  "isDeviceMotionSupported",
+  "isDeviceOrientationSupported",
+  "isEventSourceSupported",
+  "isEyeDropperSupported",
+  "isInFullscreen",
+  "isMutationObserverSupported",
+  "isPermissionGranted",
+  "isSpeechRecognitionSupported",
+  "isSpeechSynthesisSupported",
+  "isWakeLockSupported",
+  "isWebSocketSupported",
+  "notify",
+  "parseCookies",
+  "pickColor",
+  "prefetch",
+  "removeCookie",
+  "requestMediaPermissions",
+  "requestMotionPermission",
+  "requestNotificationPermission",
+  "requestOrientationPermission",
+  "setCookie",
+  "share",
+  "shareCurrentPage",
+  "shareFiles",
+  "shareText",
+  "shareURL",
+  "shareWithFallback",
+  "speak",
+  "stopSpeaking",
+  "toggleFullscreen",
+  "useAsyncData",
+  "useAttributeObserver",
+  "useAutoLogout",
+  "useAutoWakeLock",
+  "useBattery",
+  "useBreakpoint",
+  "useBroadcastChannel",
+  "useChannel",
+  "useChildListObserver",
+  "useClipboard",
+  "useColorHistory",
+  "useConditionalWakeLock",
+  "useCookies",
+  "useCopySelection",
+  "useDeviceMotion",
+  "useDeviceOrientation",
+  "useElementSize",
+  "useElementTextSelection",
+  "useElementVisibility",
+  "useEventSource",
+  "useEyeDropper",
+  "useFavicon",
+  "useFullscreen",
+  "useGeolocation",
+  "useGeolocationWatch",
+  "useHotkey",
+  "useIdle",
+  "useIdleState",
+  "useInfiniteScroll",
+  "useIntersectionObserver",
+  "useIntersectionObserverMultiple",
+  "useIsDesktop",
+  "useIsMobile",
+  "useIsTablet",
+  "useKeyPressed",
+  "useKeySequence",
+  "useKeyboard",
+  "useLastActive",
+  "useLazyLoad",
+  "useMeta",
+  "useMouse",
+  "useMouseInElement",
+  "useMutationObserver",
+  "useNetwork",
+  "useNotification",
+  "useOnline",
+  "useParallax",
+  "usePermission",
+  "usePermissions",
+  "usePointer",
+  "usePost",
+  "useResizeObserver",
+  "useResizeObserverMultiple",
+  "useSSE",
+  "useScroll",
+  "useSelectionPopup",
+  "useShare",
+  "useSpeechRecognition",
+  "useSpeechSynthesis",
+  "useStorage",
+  "useTextObserver",
+  "useTextSelection",
+  "useTitle",
+  "useVisibility",
+  "useWakeLock",
+  "useWindowSize"
+];
+const SERVER_ONLY = new Set(SERVER_ONLY_COMPOSABLES);
+export function findUnresolvedIdentifiers(source, provided) {
+  const inScope = provided instanceof Set ? provided : new Set(provided), found = new Map;
+  for (const match of source.matchAll(/\b([A-Za-z_$][\w$]*)\s*\(/g)) {
+    const name = match[1];
+    if (found.has(name) || inScope.has(name) || !SERVER_ONLY.has(name))
+      continue;
+    if (new RegExp(`(?:const|let|var|function|class)\\s+${name}\\b`).test(source))
+      continue;
+    if (new RegExp(`import\\s[^;]*\\b${name}\\b[^;]*from`).test(source))
+      continue;
+    found.set(name, {
+      name,
+      message: `"${name}" is exported by @stacksjs/stx/composables but is not available in the browser \u2014 ` + `it is a server-only module export, so this call throws ReferenceError at runtime. Import it explicitly (import { ${name} } from '@stacksjs/stx/composables') so the bundler inlines it, or use a runtime equivalent from window.stx.`
+    });
+  }
+  return [...found.values()];
+}
+export function reportUnresolvedIdentifiers(source, provided, filePath) {
+  const unresolved = findUnresolvedIdentifiers(source, provided);
+  for (const item of unresolved)
+    console.warn(`[stx] ${filePath}: ${item.message}`);
+  return unresolved;
+}

package/dist/utils.js

@@ -2,7 +2,7 @@ import fs from "node:fs";
 import path from "node:path";
 import { extractAndStripCssImports, extractBridgeData, injectBrowserCoreAutoImports, processClientScript, renderVendorStyleTags } from "./client-script.js";
 import { COMPONENT_CLIENT_FACTORIES_CONTEXT_KEY, registerComponentClientFactory } from "./component-client-factories.js";
-import { interpolateScriptExpressions, processExpressions } from "./expressions.js";
+import { interpolateScriptExpressions, processExpressions, usesSignalsInScript } from "./expressions.js";
 import { COMPONENT_SCOPE_LOCAL_GLOBALS, buildRuntimeGlobalsDestructure } from "./runtime-globals.js";
 import { transformStoreImports } from "./store-imports.js";
 import { LRUCache } from "./performance-utils.js";
@@ -576,7 +576,7 @@ ${triedPaths.map((p) => `  - ${p}`).join(`
       $slots,
       __processedComponents: branchComponents,
       __sections: {},
-      ...slotContentHasExpressions(slotContent) && { __stx_force_signals: !0 }
+      __stx_signals_gate: usesSignalsInScript(componentContent) || slotContentHasExpressions(slotContent)
     };
     applyDestructuredPropDefaults(componentContent, componentContext);
     let workingContent = componentContent;
@@ -725,7 +725,7 @@ finally {
 }`, factoryId = hydrateTrigger ? null : registerComponentClientFactory(parentContext, factoryBody), wrappedContent = factoryId ? `window.__stxComponentFactories[${JSON.stringify(factoryId)}](${JSON.stringify(scopeId)});` : `(${factoryBody})(${JSON.stringify(scopeId)});`;
         if (hydrateTrigger)
           return `${vendorStyleTags}<script type="stx/island" data-stx-island="${scopeId}" data-stx-scoped${attrs}>${wrappedContent}</script>`;
-        return `${vendorStyleTags}<script data-stx-scoped${attrs}>${wrappedContent}</script>`;
+        return `${vendorStyleTags}<script data-stx-scoped data-stx-run="always"${attrs}>${wrappedContent}</script>`;
       }));
       output = output + `
 ` + scopedScripts.join(`

package/dist/variable-extractor.js

@@ -307,7 +307,13 @@ export async function extractVariables(scriptContent, context, filePath, options
         }
       return cached;
     };
-  }, effect = (_fn) => {}, batch = (fn) => fn(), onMount = (_fn) => {}, onDestroy = (_fn) => {}, definePageMeta = (_meta) => {}, useRoute = () => {
+  }, effect = (_fn) => {}, batch = (fn) => fn(), onMount = (_fn) => {}, onDestroy = (_fn) => {};
+  function definePageMeta(meta) {
+    const config = meta || {};
+    if (config.title !== void 0 || config.description !== void 0)
+      useSeoMeta({ title: config.title, description: config.description });
+  }
+  const useRoute = () => {
     const serveCtx = context.__stxServeContext, search = context.__stxServeSearch ?? serveCtx?.search ?? "", path = serveCtx?.path ?? "";
     return {
       params: context.params ?? {},
@@ -537,6 +543,7 @@ export function convertToCommonJS(scriptContent, filePath) {
     }
     if (line.startsWith("definePageMeta(")) {
       let depth = 0, done = !1;
+      const callStart = i;
       for (let j = i;j < lines.length && !done; j++) {
         let inString = null, escaped = !1;
         const text = lines[j];
@@ -573,6 +580,15 @@ export function convertToCommonJS(scriptContent, filePath) {
       }
       if (!done)
         i = lines.length;
+      const callText = lines.slice(callStart, i).join(`
+`), lifted = [];
+      for (const key of ["title", "description"]) {
+        const match = new RegExp(`\\b${key}\\s*:\\s*(['"\`])((?:\\\\.|(?!\\1)[^\\\\])*)\\1`).exec(callText);
+        if (match)
+          lifted.push(`${key}: ${JSON.stringify(match[2])}`);
+      }
+      if (lifted.length > 0)
+        convertedLines.push(`useSeoMeta({ ${lifted.join(", ")} });`);
       continue;
     }
     if (line.startsWith("import ") || line === "import" || line.startsWith("import{")) {

package/dist/x-element.js

@@ -1,5 +1,5 @@
 export function generateXElementRuntime() {
-  return `<script data-stx-scoped data-stx-x-element-runtime>
+  return `<script data-stx-scoped data-stx-x-element-runtime data-stx-run="always">
 (function() {
   'use strict';
 

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@stacksjs/stx",
   "type": "module",
-  "version": "0.2.153",
+  "version": "0.2.154",
   "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.153",
-    "@stacksjs/sanitizer": "0.2.153",
+    "@stacksjs/desktop": "0.2.154",
+    "@stacksjs/sanitizer": "0.2.154",
     "@stacksjs/ts-i18n": "^0.1.11",
-    "bun-plugin-stx": "0.2.153",
+    "bun-plugin-stx": "0.2.154",
     "bunfig": "^0.15.17",
-    "stx-router": "0.2.153",
+    "stx-router": "0.2.154",
     "ts-broadcasting": "^0.0.9",
     "ts-images": "^0.1.9",
     "ts-syntax-highlighter": "^0.2.1"