@fictjs/runtime 0.7.0 → 0.9.0

package/dist/loader.d.ts

@@ -1,4 +1,4 @@
-export { A as __fictUseLexicalScope } from './resume-CqeQ3v_q.js';
+export { _ as __fictUseLexicalScope } from './resume-CuyJWXP_.js';
 import './signal-C4ISF17w.js';
 
 interface PrefetchStrategy {
@@ -29,6 +29,11 @@ interface ResumableLoaderOptions {
     document?: Document;
     snapshotScriptId?: string;
     events?: string[];
+    /**
+     * Receives structured snapshot/resume issues detected by the loader.
+     * Useful for telemetry and fail-safe fallback orchestration.
+     */
+    onSnapshotIssue?: (issue: SnapshotIssue) => void;
     /**
      * Prefetch strategy configuration.
      * Set to false to disable all prefetching.
@@ -36,6 +41,15 @@ interface ResumableLoaderOptions {
      */
     prefetch?: PrefetchStrategy | false;
 }
+type SnapshotIssueCode = 'snapshot_parse_error' | 'snapshot_invalid_shape' | 'snapshot_unsupported_version' | 'scope_snapshot_missing';
+interface SnapshotIssue {
+    code: SnapshotIssueCode;
+    message: string;
+    source: string;
+    expectedVersion: number;
+    actualVersion?: number;
+    scopeId?: string;
+}
 /**
  * Reset the hydrated scopes set. Useful for testing.
  */
@@ -54,4 +68,4 @@ declare function waitForPendingHandlers(): Promise<void>;
 declare function cleanupEventListeners(): void;
 declare function installResumableLoader(options?: ResumableLoaderOptions): void;
 
-export { type PrefetchStrategy, type ResumableLoaderOptions, cleanupEventListeners, installResumableLoader, resetHydratedScopes, resetPrefetchedUrls, waitForPendingHandlers };
+export { type PrefetchStrategy, type ResumableLoaderOptions, type SnapshotIssue, type SnapshotIssueCode, cleanupEventListeners, installResumableLoader, resetHydratedScopes, resetPrefetchedUrls, waitForPendingHandlers };

package/dist/loader.js

@@ -1,5 +1,6 @@
 import {
   DelegatedEvents,
+  FICT_SSR_SNAPSHOT_SCHEMA_VERSION,
   __fictEnableResumable,
   __fictEnsureScope,
   __fictGetResume,
@@ -7,7 +8,7 @@ import {
   __fictMergeSSRState,
   __fictSetSSRState,
   __fictUseLexicalScope
-} from "./chunk-7YQK3XKY.js";
+} from "./chunk-DXG3TARY.js";
 
 // src/loader.ts
 function resolveModuleUrl(url) {
@@ -26,6 +27,8 @@ var prefetchCleanup = null;
 var eventListenerCleanup = null;
 var snapshotObserver = null;
 var processedSnapshots = /* @__PURE__ */ new Set();
+var snapshotIssueHandler = null;
+var emittedIssueKeys = /* @__PURE__ */ new Set();
 function resetHydratedScopes() {
   hydratedScopes.clear();
 }
@@ -46,9 +49,12 @@ function cleanupEventListeners() {
 function installResumableLoader(options = {}) {
   const doc = options.document ?? window.document;
   const scriptId = options.snapshotScriptId ?? "__FICT_SNAPSHOT__";
+  snapshotIssueHandler = options.onSnapshotIssue ?? null;
   hydratedScopes.clear();
   prefetchedUrls.clear();
   processedSnapshots.clear();
+  emittedIssueKeys.clear();
+  __fictSetSSRState(null);
   if (eventListenerCleanup) {
     eventListenerCleanup();
     eventListenerCleanup = null;
@@ -63,10 +69,9 @@ function installResumableLoader(options = {}) {
   }
   const snapshotEl = doc.getElementById(scriptId);
   if (snapshotEl?.textContent) {
-    try {
-      const state = JSON.parse(snapshotEl.textContent);
+    const state = parseSnapshotText(snapshotEl.textContent, `#${scriptId}`);
+    if (state) {
       __fictSetSSRState(state);
-    } catch {
     }
   }
   const snapshotScripts = doc.querySelectorAll(
@@ -121,10 +126,76 @@ function parseSnapshotScript(script) {
   processedSnapshots.add(script);
   const text = script.textContent;
   if (!text) return;
-  try {
-    const state = JSON.parse(text);
+  const source = script.id ? `#${script.id}` : "<script[data-fict-snapshot]>";
+  const state = parseSnapshotText(text, source);
+  if (state) {
     __fictMergeSSRState(state);
+  }
+}
+function parseSnapshotText(text, source) {
+  let parsed;
+  try {
+    parsed = JSON.parse(text);
   } catch {
+    emitSnapshotIssue({
+      code: "snapshot_parse_error",
+      message: "[fict/loader] Failed to parse SSR snapshot JSON.",
+      source,
+      expectedVersion: FICT_SSR_SNAPSHOT_SCHEMA_VERSION
+    });
+    return null;
+  }
+  return normalizeSnapshotState(parsed, source);
+}
+function normalizeSnapshotState(value, source) {
+  if (!isRecord(value)) {
+    emitSnapshotIssue({
+      code: "snapshot_invalid_shape",
+      message: "[fict/loader] Snapshot payload must be an object.",
+      source,
+      expectedVersion: FICT_SSR_SNAPSHOT_SCHEMA_VERSION
+    });
+    return null;
+  }
+  const rawVersion = value.v;
+  const version = rawVersion === void 0 ? FICT_SSR_SNAPSHOT_SCHEMA_VERSION : rawVersion;
+  if (!Number.isInteger(version) || version !== FICT_SSR_SNAPSHOT_SCHEMA_VERSION) {
+    const versionIssue = {
+      code: "snapshot_unsupported_version",
+      message: `[fict/loader] Snapshot schema version ${String(version)} is not supported by this runtime.`,
+      source,
+      expectedVersion: FICT_SSR_SNAPSHOT_SCHEMA_VERSION
+    };
+    if (typeof version === "number") {
+      versionIssue.actualVersion = version;
+    }
+    emitSnapshotIssue({
+      ...versionIssue
+    });
+    return null;
+  }
+  const scopes = value.scopes;
+  if (!isRecord(scopes)) {
+    emitSnapshotIssue({
+      code: "snapshot_invalid_shape",
+      message: "[fict/loader] Snapshot payload is missing a valid `scopes` object.",
+      source,
+      expectedVersion: FICT_SSR_SNAPSHOT_SCHEMA_VERSION
+    });
+    return null;
+  }
+  return { v: FICT_SSR_SNAPSHOT_SCHEMA_VERSION, scopes };
+}
+function isRecord(value) {
+  return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function emitSnapshotIssue(issue) {
+  const key = `${issue.code}|${issue.source}|${issue.scopeId ?? ""}|${issue.actualVersion ?? ""}|${issue.expectedVersion}`;
+  if (emittedIssueKeys.has(key)) return;
+  emittedIssueKeys.add(key);
+  snapshotIssueHandler?.(issue);
+  if (typeof console !== "undefined" && typeof console.warn === "function") {
+    console.warn(issue.message);
   }
 }
 function setupPrefetch(doc, strategy) {
@@ -262,9 +333,17 @@ async function handleResumableEventAsync(event) {
     const scopeId = host.getAttribute("data-fict-s");
     if (!scopeId) continue;
     const snapshot = __fictGetSSRScope(scopeId);
-    if (snapshot) {
-      __fictEnsureScope(scopeId, host, snapshot);
+    if (!snapshot) {
+      emitSnapshotIssue({
+        code: "scope_snapshot_missing",
+        message: `[fict/loader] Missing scope snapshot for ${scopeId}; skipping resumable handler execution.`,
+        source: "event",
+        expectedVersion: FICT_SSR_SNAPSHOT_SCHEMA_VERSION,
+        scopeId
+      });
+      return;
     }
+    __fictEnsureScope(scopeId, host, snapshot);
     const { url, exportName } = parseQrl(qrl);
     if (event.cancelable && (event.type === "click" || event.type === "submit")) {
       const tag = node.tagName.toLowerCase();

package/dist/loader.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/loader.ts"],"sourcesContent":["import { DelegatedEvents } from './constants'\nimport {\n  __fictEnableResumable,\n  __fictEnsureScope,\n  __fictGetResume,\n  __fictGetSSRScope,\n  __fictMergeSSRState,\n  __fictSetSSRState,\n  __fictUseLexicalScope,\n} from './resume'\n\n// ============================================================================\n// Module Resolution\n// ============================================================================\n\n/**\n * Resolve a module URL through the manifest if available.\n * In production, virtual module URLs (virtual:fict-handler:...) are mapped\n * to their built chunk URLs through the manifest.\n */\nfunction resolveModuleUrl(url: string): string {\n  const manifest = (globalThis as Record<string, unknown>).__FICT_MANIFEST__ as\n    | Record<string, string>\n    | undefined\n\n  if (manifest) {\n    // Check if the URL (without #fragment) is in the manifest\n    const resolved = manifest[url]\n    if (resolved) {\n      return resolved\n    }\n  }\n\n  return url\n}\n\n// ============================================================================\n// Types\n// ============================================================================\n\nexport interface PrefetchStrategy {\n  /**\n   * Enable visibility-based prefetch using IntersectionObserver.\n   * Prefetches modules when interactive elements come into view.\n   * @default true\n   */\n  visibility?: boolean\n  /**\n   * Root margin for IntersectionObserver (e.g., '200px' to prefetch earlier).\n   * @default '200px'\n   */\n  visibilityMargin?: string\n  /**\n   * Enable hover-based prefetch using pointerover events.\n   * Prefetches modules when user hovers over interactive elements.\n   * @default true\n   */\n  hover?: boolean\n  /**\n   * Delay in ms before prefetching on hover (debounce rapid movements).\n   * @default 50\n   */\n  hoverDelay?: number\n}\n\nexport interface ResumableLoaderOptions {\n  document?: Document\n  snapshotScriptId?: string\n  events?: string[]\n  /**\n   * Prefetch strategy configuration.\n   * Set to false to disable all prefetching.\n   * @default { visibility: true, hover: true }\n   */\n  prefetch?: PrefetchStrategy | false\n}\n\n// ============================================================================\n// State\n// ============================================================================\n\nconst hydratedScopes = new Set<string>()\nconst prefetchedUrls = new Set<string>()\nlet prefetchCleanup: (() => void) | null = null\nlet eventListenerCleanup: (() => void) | null = null\nlet snapshotObserver: MutationObserver | null = null\nconst processedSnapshots = new Set<HTMLScriptElement>()\n\n/**\n * Reset the hydrated scopes set. Useful for testing.\n */\nexport function resetHydratedScopes(): void {\n  hydratedScopes.clear()\n}\n\n/**\n * Reset the prefetched URLs set. Useful for testing.\n */\nexport function resetPrefetchedUrls(): void {\n  prefetchedUrls.clear()\n}\n\n/**\n * Set of pending handler promises. Used for testing to wait for all handlers to complete.\n */\nconst pendingHandlers = new Set<Promise<void>>()\n\n/**\n * Wait for all pending event handlers to complete. Useful for testing.\n */\nexport async function waitForPendingHandlers(): Promise<void> {\n  if (pendingHandlers.size === 0) return\n  await Promise.allSettled([...pendingHandlers])\n}\n\n/**\n * Clean up all registered event listeners. Useful for testing.\n */\nexport function cleanupEventListeners(): void {\n  if (eventListenerCleanup) {\n    eventListenerCleanup()\n    eventListenerCleanup = null\n  }\n}\n\n// ============================================================================\n// Main Entry Point\n// ============================================================================\n\nexport function installResumableLoader(options: ResumableLoaderOptions = {}): void {\n  const doc = options.document ?? window.document\n  const scriptId = options.snapshotScriptId ?? '__FICT_SNAPSHOT__'\n\n  // Reset hydrated scopes for fresh loader installation\n  hydratedScopes.clear()\n  prefetchedUrls.clear()\n  processedSnapshots.clear()\n\n  // Clean up previous event listeners\n  if (eventListenerCleanup) {\n    eventListenerCleanup()\n    eventListenerCleanup = null\n  }\n\n  // Clean up previous prefetch handlers\n  if (prefetchCleanup) {\n    prefetchCleanup()\n    prefetchCleanup = null\n  }\n\n  if (snapshotObserver) {\n    snapshotObserver.disconnect()\n    snapshotObserver = null\n  }\n\n  const snapshotEl = doc.getElementById(scriptId)\n  if (snapshotEl?.textContent) {\n    try {\n      const state = JSON.parse(snapshotEl.textContent)\n      __fictSetSSRState(state)\n    } catch {\n      // Ignore parse errors\n    }\n  }\n\n  const snapshotScripts = doc.querySelectorAll(\n    'script[type=\"application/json\"][data-fict-snapshot]',\n  )\n  for (const script of Array.from(snapshotScripts)) {\n    parseSnapshotScript(script as HTMLScriptElement)\n  }\n\n  if (typeof MutationObserver !== 'undefined') {\n    snapshotObserver = new MutationObserver(mutations => {\n      for (const mutation of mutations) {\n        for (const node of Array.from(mutation.addedNodes)) {\n          if (!(node instanceof Element)) continue\n          if (node.tagName === 'SCRIPT') {\n            const script = node as HTMLScriptElement\n            if (isSnapshotScript(script)) {\n              parseSnapshotScript(script)\n            }\n          }\n          const nested = node.querySelectorAll?.(\n            'script[type=\"application/json\"][data-fict-snapshot]',\n          )\n          if (nested && nested.length) {\n            for (const script of Array.from(nested)) {\n              parseSnapshotScript(script as HTMLScriptElement)\n            }\n          }\n        }\n      }\n    })\n    snapshotObserver.observe(doc.documentElement ?? doc, { childList: true, subtree: true })\n  }\n\n  __fictEnableResumable()\n\n  const events = options.events ?? Array.from(DelegatedEvents)\n  for (const eventName of events) {\n    doc.addEventListener(eventName, handleResumableEvent, true)\n  }\n\n  // Store cleanup function for event listeners\n  eventListenerCleanup = () => {\n    for (const eventName of events) {\n      doc.removeEventListener(eventName, handleResumableEvent, true)\n    }\n  }\n\n  // Setup prefetch if enabled\n  if (options.prefetch !== false) {\n    prefetchCleanup = setupPrefetch(doc, options.prefetch ?? {})\n  }\n}\n\nfunction isSnapshotScript(script: HTMLScriptElement): boolean {\n  return script.type === 'application/json' && script.hasAttribute('data-fict-snapshot')\n}\n\nfunction parseSnapshotScript(script: HTMLScriptElement): void {\n  if (processedSnapshots.has(script)) return\n  processedSnapshots.add(script)\n  const text = script.textContent\n  if (!text) return\n  try {\n    const state = JSON.parse(text)\n    __fictMergeSSRState(state)\n  } catch {\n    // Ignore parse errors\n  }\n}\n\n// ============================================================================\n// Prefetch Implementation\n// ============================================================================\n\nfunction setupPrefetch(doc: Document, strategy: PrefetchStrategy): () => void {\n  const cleanupFns: (() => void)[] = []\n\n  // Visibility-based prefetch\n  if (strategy.visibility !== false) {\n    const cleanup = setupVisibilityPrefetch(doc, strategy.visibilityMargin ?? '200px')\n    cleanupFns.push(cleanup)\n  }\n\n  // Hover-based prefetch\n  if (strategy.hover !== false) {\n    const cleanup = setupHoverPrefetch(doc, strategy.hoverDelay ?? 50)\n    cleanupFns.push(cleanup)\n  }\n\n  return () => {\n    for (const cleanup of cleanupFns) {\n      cleanup()\n    }\n  }\n}\n\nfunction setupVisibilityPrefetch(doc: Document, rootMargin: string): () => void {\n  // Check if IntersectionObserver is available\n  if (typeof IntersectionObserver === 'undefined') {\n    return () => {}\n  }\n\n  const observer = new IntersectionObserver(\n    entries => {\n      for (const entry of entries) {\n        if (entry.isIntersecting) {\n          const el = entry.target as Element\n          prefetchElementQrls(el)\n          // Stop observing after prefetch\n          observer.unobserve(el)\n        }\n      }\n    },\n    { rootMargin },\n  )\n\n  // Observe all elements with on:* attributes\n  const interactiveElements = doc.querySelectorAll(\n    '[on\\\\:click], [on\\\\:input], [on\\\\:change], [on\\\\:submit], [on\\\\:keydown], [on\\\\:keyup]',\n  )\n  interactiveElements.forEach(el => observer.observe(el))\n\n  // Also observe elements with data-fict-h (resumable components)\n  const resumableHosts = doc.querySelectorAll('[data-fict-h]')\n  resumableHosts.forEach(el => observer.observe(el))\n\n  return () => {\n    observer.disconnect()\n  }\n}\n\nfunction setupHoverPrefetch(doc: Document, delay: number): () => void {\n  let hoverTimeout: ReturnType<typeof setTimeout> | null = null\n  let lastHoveredElement: Element | null = null\n\n  const handlePointerOver = (event: Event) => {\n    const target = event.target\n    if (!(target instanceof Element)) return\n\n    // Find the closest element with interactive attributes\n    const interactiveEl =\n      target.closest('[on\\\\:click]') ||\n      target.closest('[on\\\\:input]') ||\n      target.closest('[on\\\\:change]') ||\n      target.closest('[on\\\\:submit]') ||\n      target.closest('[data-fict-h]')\n\n    if (!interactiveEl || interactiveEl === lastHoveredElement) return\n\n    lastHoveredElement = interactiveEl\n\n    // Clear previous timeout\n    if (hoverTimeout) {\n      clearTimeout(hoverTimeout)\n    }\n\n    // Debounce prefetch\n    hoverTimeout = setTimeout(() => {\n      prefetchElementQrls(interactiveEl)\n    }, delay)\n  }\n\n  const handlePointerOut = () => {\n    if (hoverTimeout) {\n      clearTimeout(hoverTimeout)\n      hoverTimeout = null\n    }\n    lastHoveredElement = null\n  }\n\n  doc.addEventListener('pointerover', handlePointerOver, { passive: true })\n  doc.addEventListener('pointerout', handlePointerOut, { passive: true })\n\n  return () => {\n    doc.removeEventListener('pointerover', handlePointerOver)\n    doc.removeEventListener('pointerout', handlePointerOut)\n    if (hoverTimeout) {\n      clearTimeout(hoverTimeout)\n    }\n  }\n}\n\nfunction prefetchElementQrls(el: Element): void {\n  // Prefetch event handler QRLs\n  const eventAttrs = ['on:click', 'on:input', 'on:change', 'on:submit', 'on:keydown', 'on:keyup']\n  for (const attr of eventAttrs) {\n    const qrl = el.getAttribute(attr)\n    if (qrl) {\n      prefetchQrl(qrl)\n    }\n  }\n\n  // Prefetch resume handler QRL\n  const resumeQrl = el.getAttribute('data-fict-h')\n  if (resumeQrl) {\n    prefetchQrl(resumeQrl)\n  }\n\n  // Also check children for nested QRLs\n  const children = el.querySelectorAll(\n    '[on\\\\:click], [on\\\\:input], [on\\\\:change], [on\\\\:submit], [data-fict-h]',\n  )\n  children.forEach(child => {\n    for (const attr of eventAttrs) {\n      const qrl = child.getAttribute(attr)\n      if (qrl) {\n        prefetchQrl(qrl)\n      }\n    }\n    const childResumeQrl = child.getAttribute('data-fict-h')\n    if (childResumeQrl) {\n      prefetchQrl(childResumeQrl)\n    }\n  })\n}\n\nfunction prefetchQrl(qrl: string): void {\n  const { url } = parseQrl(qrl)\n  if (!url || prefetchedUrls.has(url)) return\n\n  prefetchedUrls.add(url)\n\n  // Resolve through manifest for production builds\n  const resolvedUrl = resolveModuleUrl(url)\n\n  // Use modulepreload link for best browser support\n  if (typeof document !== 'undefined') {\n    const link = document.createElement('link')\n    link.rel = 'modulepreload'\n    link.href = resolvedUrl\n    link.crossOrigin = 'anonymous'\n    document.head.appendChild(link)\n  }\n}\n\n// ============================================================================\n\n/**\n * Wrapper that tracks the async handler promise for testing.\n */\nfunction handleResumableEvent(event: Event): void {\n  const promise = handleResumableEventAsync(event)\n  pendingHandlers.add(promise)\n  promise.finally(() => {\n    pendingHandlers.delete(promise)\n  })\n}\n\nasync function handleResumableEventAsync(event: Event): Promise<void> {\n  const path =\n    typeof event.composedPath === 'function' ? event.composedPath() : buildEventPath(event)\n\n  for (const node of path) {\n    if (!(node instanceof Element)) continue\n    const qrl = node.getAttribute(`on:${event.type}`)\n    if (!qrl) continue\n\n    const host = node.closest('[data-fict-s]') as Element | null\n    if (!host) continue\n    const scopeId = host.getAttribute('data-fict-s')\n    if (!scopeId) continue\n\n    const snapshot = __fictGetSSRScope(scopeId)\n    if (snapshot) {\n      __fictEnsureScope(scopeId, host, snapshot)\n    }\n\n    const { url, exportName } = parseQrl(qrl)\n\n    // Pre-emptively prevent default on navigations/forms while we await modules\n    if (event.cancelable && (event.type === 'click' || event.type === 'submit')) {\n      const tag = node.tagName.toLowerCase()\n      if (tag === 'a' || tag === 'form') {\n        event.preventDefault()\n      }\n    }\n\n    // Resume FIRST to set up reactive bindings BEFORE the handler runs\n    if (!hydratedScopes.has(scopeId)) {\n      const resumeQrl = host.getAttribute('data-fict-h')\n      if (resumeQrl) {\n        const { url: resumeUrl, exportName: resumeExport } = parseQrl(resumeQrl)\n        const resolvedResumeUrl = resolveModuleUrl(resumeUrl)\n        // Load the module to ensure resume functions are registered\n        await import(/* @vite-ignore */ resolvedResumeUrl)\n        // Get resume function from registry (not module exports)\n        const resumeFn = __fictGetResume(resumeExport)\n        if (typeof resumeFn === 'function') {\n          await (resumeFn as (scopeId: string, host: Element) => unknown)(scopeId, host)\n          hydratedScopes.add(scopeId)\n        }\n      }\n    }\n\n    // THEN run the handler - now signal updates will trigger DOM updates\n    const resolvedUrl = resolveModuleUrl(url)\n    const mod = await import(/* @vite-ignore */ resolvedUrl)\n    const handler = (mod as Record<string, unknown>)[exportName]\n    if (typeof handler === 'function') {\n      await (handler as (scopeId: string, ev: Event, el: Element) => unknown)(scopeId, event, node)\n    }\n\n    return\n  }\n}\n\nfunction parseQrl(qrl: string): { url: string; exportName: string } {\n  const [ref] = qrl.split('[')\n  if (!ref) {\n    return { url: '', exportName: 'default' }\n  }\n  const hashIndex = ref.lastIndexOf('#')\n  if (hashIndex === -1) {\n    return { url: ref, exportName: 'default' }\n  }\n  return { url: ref.slice(0, hashIndex), exportName: ref.slice(hashIndex + 1) }\n}\n\nfunction buildEventPath(event: Event): EventTarget[] {\n  const path: EventTarget[] = []\n  let node: EventTarget | null = event.target\n  while (node) {\n    path.push(node)\n    node = (node as Node).parentNode\n  }\n  path.push(window)\n  return path\n}\n\n// Re-export for handler authors (optional)\nexport { __fictUseLexicalScope } from './resume'\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../src/loader.ts"],"sourcesContent":["import { DelegatedEvents } from './constants'\nimport {\n  FICT_SSR_SNAPSHOT_SCHEMA_VERSION,\n  type SSRState,\n  __fictEnableResumable,\n  __fictEnsureScope,\n  __fictGetResume,\n  __fictGetSSRScope,\n  __fictMergeSSRState,\n  __fictSetSSRState,\n  __fictUseLexicalScope,\n} from './resume'\n\n// ============================================================================\n// Module Resolution\n// ============================================================================\n\n/**\n * Resolve a module URL through the manifest if available.\n * In production, virtual module URLs (virtual:fict-handler:...) are mapped\n * to their built chunk URLs through the manifest.\n */\nfunction resolveModuleUrl(url: string): string {\n  const manifest = (globalThis as Record<string, unknown>).__FICT_MANIFEST__ as\n    | Record<string, string>\n    | undefined\n\n  if (manifest) {\n    // Check if the URL (without #fragment) is in the manifest\n    const resolved = manifest[url]\n    if (resolved) {\n      return resolved\n    }\n  }\n\n  return url\n}\n\n// ============================================================================\n// Types\n// ============================================================================\n\nexport interface PrefetchStrategy {\n  /**\n   * Enable visibility-based prefetch using IntersectionObserver.\n   * Prefetches modules when interactive elements come into view.\n   * @default true\n   */\n  visibility?: boolean\n  /**\n   * Root margin for IntersectionObserver (e.g., '200px' to prefetch earlier).\n   * @default '200px'\n   */\n  visibilityMargin?: string\n  /**\n   * Enable hover-based prefetch using pointerover events.\n   * Prefetches modules when user hovers over interactive elements.\n   * @default true\n   */\n  hover?: boolean\n  /**\n   * Delay in ms before prefetching on hover (debounce rapid movements).\n   * @default 50\n   */\n  hoverDelay?: number\n}\n\nexport interface ResumableLoaderOptions {\n  document?: Document\n  snapshotScriptId?: string\n  events?: string[]\n  /**\n   * Receives structured snapshot/resume issues detected by the loader.\n   * Useful for telemetry and fail-safe fallback orchestration.\n   */\n  onSnapshotIssue?: (issue: SnapshotIssue) => void\n  /**\n   * Prefetch strategy configuration.\n   * Set to false to disable all prefetching.\n   * @default { visibility: true, hover: true }\n   */\n  prefetch?: PrefetchStrategy | false\n}\n\nexport type SnapshotIssueCode =\n  | 'snapshot_parse_error'\n  | 'snapshot_invalid_shape'\n  | 'snapshot_unsupported_version'\n  | 'scope_snapshot_missing'\n\nexport interface SnapshotIssue {\n  code: SnapshotIssueCode\n  message: string\n  source: string\n  expectedVersion: number\n  actualVersion?: number\n  scopeId?: string\n}\n\n// ============================================================================\n// State\n// ============================================================================\n\nconst hydratedScopes = new Set<string>()\nconst prefetchedUrls = new Set<string>()\nlet prefetchCleanup: (() => void) | null = null\nlet eventListenerCleanup: (() => void) | null = null\nlet snapshotObserver: MutationObserver | null = null\nconst processedSnapshots = new Set<HTMLScriptElement>()\nlet snapshotIssueHandler: ((issue: SnapshotIssue) => void) | null = null\nconst emittedIssueKeys = new Set<string>()\n\n/**\n * Reset the hydrated scopes set. Useful for testing.\n */\nexport function resetHydratedScopes(): void {\n  hydratedScopes.clear()\n}\n\n/**\n * Reset the prefetched URLs set. Useful for testing.\n */\nexport function resetPrefetchedUrls(): void {\n  prefetchedUrls.clear()\n}\n\n/**\n * Set of pending handler promises. Used for testing to wait for all handlers to complete.\n */\nconst pendingHandlers = new Set<Promise<void>>()\n\n/**\n * Wait for all pending event handlers to complete. Useful for testing.\n */\nexport async function waitForPendingHandlers(): Promise<void> {\n  if (pendingHandlers.size === 0) return\n  await Promise.allSettled([...pendingHandlers])\n}\n\n/**\n * Clean up all registered event listeners. Useful for testing.\n */\nexport function cleanupEventListeners(): void {\n  if (eventListenerCleanup) {\n    eventListenerCleanup()\n    eventListenerCleanup = null\n  }\n}\n\n// ============================================================================\n// Main Entry Point\n// ============================================================================\n\nexport function installResumableLoader(options: ResumableLoaderOptions = {}): void {\n  const doc = options.document ?? window.document\n  const scriptId = options.snapshotScriptId ?? '__FICT_SNAPSHOT__'\n  snapshotIssueHandler = options.onSnapshotIssue ?? null\n\n  // Reset hydrated scopes for fresh loader installation\n  hydratedScopes.clear()\n  prefetchedUrls.clear()\n  processedSnapshots.clear()\n  emittedIssueKeys.clear()\n  __fictSetSSRState(null)\n\n  // Clean up previous event listeners\n  if (eventListenerCleanup) {\n    eventListenerCleanup()\n    eventListenerCleanup = null\n  }\n\n  // Clean up previous prefetch handlers\n  if (prefetchCleanup) {\n    prefetchCleanup()\n    prefetchCleanup = null\n  }\n\n  if (snapshotObserver) {\n    snapshotObserver.disconnect()\n    snapshotObserver = null\n  }\n\n  const snapshotEl = doc.getElementById(scriptId)\n  if (snapshotEl?.textContent) {\n    const state = parseSnapshotText(snapshotEl.textContent, `#${scriptId}`)\n    if (state) {\n      __fictSetSSRState(state)\n    }\n  }\n\n  const snapshotScripts = doc.querySelectorAll(\n    'script[type=\"application/json\"][data-fict-snapshot]',\n  )\n  for (const script of Array.from(snapshotScripts)) {\n    parseSnapshotScript(script as HTMLScriptElement)\n  }\n\n  if (typeof MutationObserver !== 'undefined') {\n    snapshotObserver = new MutationObserver(mutations => {\n      for (const mutation of mutations) {\n        for (const node of Array.from(mutation.addedNodes)) {\n          if (!(node instanceof Element)) continue\n          if (node.tagName === 'SCRIPT') {\n            const script = node as HTMLScriptElement\n            if (isSnapshotScript(script)) {\n              parseSnapshotScript(script)\n            }\n          }\n          const nested = node.querySelectorAll?.(\n            'script[type=\"application/json\"][data-fict-snapshot]',\n          )\n          if (nested && nested.length) {\n            for (const script of Array.from(nested)) {\n              parseSnapshotScript(script as HTMLScriptElement)\n            }\n          }\n        }\n      }\n    })\n    snapshotObserver.observe(doc.documentElement ?? doc, { childList: true, subtree: true })\n  }\n\n  __fictEnableResumable()\n\n  const events = options.events ?? Array.from(DelegatedEvents)\n  for (const eventName of events) {\n    doc.addEventListener(eventName, handleResumableEvent, true)\n  }\n\n  // Store cleanup function for event listeners\n  eventListenerCleanup = () => {\n    for (const eventName of events) {\n      doc.removeEventListener(eventName, handleResumableEvent, true)\n    }\n  }\n\n  // Setup prefetch if enabled\n  if (options.prefetch !== false) {\n    prefetchCleanup = setupPrefetch(doc, options.prefetch ?? {})\n  }\n}\n\nfunction isSnapshotScript(script: HTMLScriptElement): boolean {\n  return script.type === 'application/json' && script.hasAttribute('data-fict-snapshot')\n}\n\nfunction parseSnapshotScript(script: HTMLScriptElement): void {\n  if (processedSnapshots.has(script)) return\n  processedSnapshots.add(script)\n  const text = script.textContent\n  if (!text) return\n  const source = script.id ? `#${script.id}` : '<script[data-fict-snapshot]>'\n  const state = parseSnapshotText(text, source)\n  if (state) {\n    __fictMergeSSRState(state)\n  }\n}\n\nfunction parseSnapshotText(text: string, source: string): SSRState | null {\n  let parsed: unknown\n  try {\n    parsed = JSON.parse(text)\n  } catch {\n    emitSnapshotIssue({\n      code: 'snapshot_parse_error',\n      message: '[fict/loader] Failed to parse SSR snapshot JSON.',\n      source,\n      expectedVersion: FICT_SSR_SNAPSHOT_SCHEMA_VERSION,\n    })\n    return null\n  }\n\n  return normalizeSnapshotState(parsed, source)\n}\n\nfunction normalizeSnapshotState(value: unknown, source: string): SSRState | null {\n  if (!isRecord(value)) {\n    emitSnapshotIssue({\n      code: 'snapshot_invalid_shape',\n      message: '[fict/loader] Snapshot payload must be an object.',\n      source,\n      expectedVersion: FICT_SSR_SNAPSHOT_SCHEMA_VERSION,\n    })\n    return null\n  }\n\n  const rawVersion = value.v\n  const version = rawVersion === undefined ? FICT_SSR_SNAPSHOT_SCHEMA_VERSION : rawVersion\n  if (!Number.isInteger(version) || version !== FICT_SSR_SNAPSHOT_SCHEMA_VERSION) {\n    const versionIssue: SnapshotIssue = {\n      code: 'snapshot_unsupported_version',\n      message: `[fict/loader] Snapshot schema version ${String(version)} is not supported by this runtime.`,\n      source,\n      expectedVersion: FICT_SSR_SNAPSHOT_SCHEMA_VERSION,\n    }\n    if (typeof version === 'number') {\n      versionIssue.actualVersion = version\n    }\n    emitSnapshotIssue({\n      ...versionIssue,\n    })\n    return null\n  }\n\n  const scopes = value.scopes\n  if (!isRecord(scopes)) {\n    emitSnapshotIssue({\n      code: 'snapshot_invalid_shape',\n      message: '[fict/loader] Snapshot payload is missing a valid `scopes` object.',\n      source,\n      expectedVersion: FICT_SSR_SNAPSHOT_SCHEMA_VERSION,\n    })\n    return null\n  }\n\n  return { v: FICT_SSR_SNAPSHOT_SCHEMA_VERSION, scopes: scopes as SSRState['scopes'] }\n}\n\nfunction isRecord(value: unknown): value is Record<string, unknown> {\n  return typeof value === 'object' && value !== null && !Array.isArray(value)\n}\n\nfunction emitSnapshotIssue(issue: SnapshotIssue): void {\n  const key =\n    `${issue.code}|${issue.source}|${issue.scopeId ?? ''}|` +\n    `${issue.actualVersion ?? ''}|${issue.expectedVersion}`\n  if (emittedIssueKeys.has(key)) return\n  emittedIssueKeys.add(key)\n\n  snapshotIssueHandler?.(issue)\n\n  if (typeof console !== 'undefined' && typeof console.warn === 'function') {\n    console.warn(issue.message)\n  }\n}\n\n// ============================================================================\n// Prefetch Implementation\n// ============================================================================\n\nfunction setupPrefetch(doc: Document, strategy: PrefetchStrategy): () => void {\n  const cleanupFns: (() => void)[] = []\n\n  // Visibility-based prefetch\n  if (strategy.visibility !== false) {\n    const cleanup = setupVisibilityPrefetch(doc, strategy.visibilityMargin ?? '200px')\n    cleanupFns.push(cleanup)\n  }\n\n  // Hover-based prefetch\n  if (strategy.hover !== false) {\n    const cleanup = setupHoverPrefetch(doc, strategy.hoverDelay ?? 50)\n    cleanupFns.push(cleanup)\n  }\n\n  return () => {\n    for (const cleanup of cleanupFns) {\n      cleanup()\n    }\n  }\n}\n\nfunction setupVisibilityPrefetch(doc: Document, rootMargin: string): () => void {\n  // Check if IntersectionObserver is available\n  if (typeof IntersectionObserver === 'undefined') {\n    return () => {}\n  }\n\n  const observer = new IntersectionObserver(\n    entries => {\n      for (const entry of entries) {\n        if (entry.isIntersecting) {\n          const el = entry.target as Element\n          prefetchElementQrls(el)\n          // Stop observing after prefetch\n          observer.unobserve(el)\n        }\n      }\n    },\n    { rootMargin },\n  )\n\n  // Observe all elements with on:* attributes\n  const interactiveElements = doc.querySelectorAll(\n    '[on\\\\:click], [on\\\\:input], [on\\\\:change], [on\\\\:submit], [on\\\\:keydown], [on\\\\:keyup]',\n  )\n  interactiveElements.forEach(el => observer.observe(el))\n\n  // Also observe elements with data-fict-h (resumable components)\n  const resumableHosts = doc.querySelectorAll('[data-fict-h]')\n  resumableHosts.forEach(el => observer.observe(el))\n\n  return () => {\n    observer.disconnect()\n  }\n}\n\nfunction setupHoverPrefetch(doc: Document, delay: number): () => void {\n  let hoverTimeout: ReturnType<typeof setTimeout> | null = null\n  let lastHoveredElement: Element | null = null\n\n  const handlePointerOver = (event: Event) => {\n    const target = event.target\n    if (!(target instanceof Element)) return\n\n    // Find the closest element with interactive attributes\n    const interactiveEl =\n      target.closest('[on\\\\:click]') ||\n      target.closest('[on\\\\:input]') ||\n      target.closest('[on\\\\:change]') ||\n      target.closest('[on\\\\:submit]') ||\n      target.closest('[data-fict-h]')\n\n    if (!interactiveEl || interactiveEl === lastHoveredElement) return\n\n    lastHoveredElement = interactiveEl\n\n    // Clear previous timeout\n    if (hoverTimeout) {\n      clearTimeout(hoverTimeout)\n    }\n\n    // Debounce prefetch\n    hoverTimeout = setTimeout(() => {\n      prefetchElementQrls(interactiveEl)\n    }, delay)\n  }\n\n  const handlePointerOut = () => {\n    if (hoverTimeout) {\n      clearTimeout(hoverTimeout)\n      hoverTimeout = null\n    }\n    lastHoveredElement = null\n  }\n\n  doc.addEventListener('pointerover', handlePointerOver, { passive: true })\n  doc.addEventListener('pointerout', handlePointerOut, { passive: true })\n\n  return () => {\n    doc.removeEventListener('pointerover', handlePointerOver)\n    doc.removeEventListener('pointerout', handlePointerOut)\n    if (hoverTimeout) {\n      clearTimeout(hoverTimeout)\n    }\n  }\n}\n\nfunction prefetchElementQrls(el: Element): void {\n  // Prefetch event handler QRLs\n  const eventAttrs = ['on:click', 'on:input', 'on:change', 'on:submit', 'on:keydown', 'on:keyup']\n  for (const attr of eventAttrs) {\n    const qrl = el.getAttribute(attr)\n    if (qrl) {\n      prefetchQrl(qrl)\n    }\n  }\n\n  // Prefetch resume handler QRL\n  const resumeQrl = el.getAttribute('data-fict-h')\n  if (resumeQrl) {\n    prefetchQrl(resumeQrl)\n  }\n\n  // Also check children for nested QRLs\n  const children = el.querySelectorAll(\n    '[on\\\\:click], [on\\\\:input], [on\\\\:change], [on\\\\:submit], [data-fict-h]',\n  )\n  children.forEach(child => {\n    for (const attr of eventAttrs) {\n      const qrl = child.getAttribute(attr)\n      if (qrl) {\n        prefetchQrl(qrl)\n      }\n    }\n    const childResumeQrl = child.getAttribute('data-fict-h')\n    if (childResumeQrl) {\n      prefetchQrl(childResumeQrl)\n    }\n  })\n}\n\nfunction prefetchQrl(qrl: string): void {\n  const { url } = parseQrl(qrl)\n  if (!url || prefetchedUrls.has(url)) return\n\n  prefetchedUrls.add(url)\n\n  // Resolve through manifest for production builds\n  const resolvedUrl = resolveModuleUrl(url)\n\n  // Use modulepreload link for best browser support\n  if (typeof document !== 'undefined') {\n    const link = document.createElement('link')\n    link.rel = 'modulepreload'\n    link.href = resolvedUrl\n    link.crossOrigin = 'anonymous'\n    document.head.appendChild(link)\n  }\n}\n\n// ============================================================================\n\n/**\n * Wrapper that tracks the async handler promise for testing.\n */\nfunction handleResumableEvent(event: Event): void {\n  const promise = handleResumableEventAsync(event)\n  pendingHandlers.add(promise)\n  promise.finally(() => {\n    pendingHandlers.delete(promise)\n  })\n}\n\nasync function handleResumableEventAsync(event: Event): Promise<void> {\n  const path =\n    typeof event.composedPath === 'function' ? event.composedPath() : buildEventPath(event)\n\n  for (const node of path) {\n    if (!(node instanceof Element)) continue\n    const qrl = node.getAttribute(`on:${event.type}`)\n    if (!qrl) continue\n\n    const host = node.closest('[data-fict-s]') as Element | null\n    if (!host) continue\n    const scopeId = host.getAttribute('data-fict-s')\n    if (!scopeId) continue\n\n    const snapshot = __fictGetSSRScope(scopeId)\n    if (!snapshot) {\n      emitSnapshotIssue({\n        code: 'scope_snapshot_missing',\n        message: `[fict/loader] Missing scope snapshot for ${scopeId}; skipping resumable handler execution.`,\n        source: 'event',\n        expectedVersion: FICT_SSR_SNAPSHOT_SCHEMA_VERSION,\n        scopeId,\n      })\n      return\n    }\n    __fictEnsureScope(scopeId, host, snapshot)\n\n    const { url, exportName } = parseQrl(qrl)\n\n    // Pre-emptively prevent default on navigations/forms while we await modules\n    if (event.cancelable && (event.type === 'click' || event.type === 'submit')) {\n      const tag = node.tagName.toLowerCase()\n      if (tag === 'a' || tag === 'form') {\n        event.preventDefault()\n      }\n    }\n\n    // Resume FIRST to set up reactive bindings BEFORE the handler runs\n    if (!hydratedScopes.has(scopeId)) {\n      const resumeQrl = host.getAttribute('data-fict-h')\n      if (resumeQrl) {\n        const { url: resumeUrl, exportName: resumeExport } = parseQrl(resumeQrl)\n        const resolvedResumeUrl = resolveModuleUrl(resumeUrl)\n        // Load the module to ensure resume functions are registered\n        await import(/* @vite-ignore */ resolvedResumeUrl)\n        // Get resume function from registry (not module exports)\n        const resumeFn = __fictGetResume(resumeExport)\n        if (typeof resumeFn === 'function') {\n          await (resumeFn as (scopeId: string, host: Element) => unknown)(scopeId, host)\n          hydratedScopes.add(scopeId)\n        }\n      }\n    }\n\n    // THEN run the handler - now signal updates will trigger DOM updates\n    const resolvedUrl = resolveModuleUrl(url)\n    const mod = await import(/* @vite-ignore */ resolvedUrl)\n    const handler = (mod as Record<string, unknown>)[exportName]\n    if (typeof handler === 'function') {\n      await (handler as (scopeId: string, ev: Event, el: Element) => unknown)(scopeId, event, node)\n    }\n\n    return\n  }\n}\n\nfunction parseQrl(qrl: string): { url: string; exportName: string } {\n  const [ref] = qrl.split('[')\n  if (!ref) {\n    return { url: '', exportName: 'default' }\n  }\n  const hashIndex = ref.lastIndexOf('#')\n  if (hashIndex === -1) {\n    return { url: ref, exportName: 'default' }\n  }\n  return { url: ref.slice(0, hashIndex), exportName: ref.slice(hashIndex + 1) }\n}\n\nfunction buildEventPath(event: Event): EventTarget[] {\n  const path: EventTarget[] = []\n  let node: EventTarget | null = event.target\n  while (node) {\n    path.push(node)\n    node = (node as Node).parentNode\n  }\n  path.push(window)\n  return path\n}\n\n// Re-export for handler authors (optional)\nexport { __fictUseLexicalScope } from './resume'\n"],"mappings":"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","names":[]}

package/dist/{props-84UJeWO8.d.cts → props-BpZz0AOq.d.cts}

@@ -1,5 +1,5 @@
 import { M as MemoOptions } from './signal-C4ISF17w.cjs';
-import { F as FictNode, D as DOMElement } from './effect-DAzpH7Mm.cjs';
+import { F as FictNode, R as DOMElement } from './binding-BWchH3Kp.cjs';
 
 type Memo<T> = () => T;
 declare function createMemo<T>(fn: () => T, options?: MemoOptions<T>): Memo<T>;
@@ -768,4 +768,4 @@ declare function keyed<T, K extends string | number | symbol>(target: T | PropGe
  */
 declare function prop<T>(getter: () => T, options?: PropOptions): PropGetter<T>;
 
-export { Fragment as F, JSX as J, type Memo as M, __fictProp as _, createElement as a, __fictPropsRest as b, createMemo as c, createPropsProxy as d, hydrateComponent as h, keyed as k, mergeProps as m, prop as p, render as r, template as t };
+export { Fragment as F, JSX as J, type Memo as M, __fictProp as _, __fictPropsRest as a, createPropsProxy as b, createMemo as c, createElement as d, hydrateComponent as h, keyed as k, mergeProps as m, prop as p, render as r, template as t };

package/dist/{props-BRhFK50f.d.ts → props-CjLH0JE-.d.ts}

@@ -1,5 +1,5 @@
 import { M as MemoOptions } from './signal-C4ISF17w.js';
-import { F as FictNode, D as DOMElement } from './effect-DAzpH7Mm.js';
+import { F as FictNode, R as DOMElement } from './binding-BWchH3Kp.js';
 
 type Memo<T> = () => T;
 declare function createMemo<T>(fn: () => T, options?: MemoOptions<T>): Memo<T>;
@@ -768,4 +768,4 @@ declare function keyed<T, K extends string | number | symbol>(target: T | PropGe
  */
 declare function prop<T>(getter: () => T, options?: PropOptions): PropGetter<T>;
 
-export { Fragment as F, JSX as J, type Memo as M, __fictProp as _, createElement as a, __fictPropsRest as b, createMemo as c, createPropsProxy as d, hydrateComponent as h, keyed as k, mergeProps as m, prop as p, render as r, template as t };
+export { Fragment as F, JSX as J, type Memo as M, __fictProp as _, __fictPropsRest as a, createPropsProxy as b, createMemo as c, createElement as d, hydrateComponent as h, keyed as k, mergeProps as m, prop as p, render as r, template as t };

package/dist/{resume-i-A3EFox.d.cts → resume-BJ4oHLi_.d.cts}

@@ -28,7 +28,9 @@ interface ScopeSnapshot {
     props?: Record<string, unknown>;
     vars?: Record<string, number>;
 }
+declare const FICT_SSR_SNAPSHOT_SCHEMA_VERSION = 1;
 interface SSRState {
+    v: number;
     scopes: Record<string, ScopeSnapshot>;
 }
 interface ScopeRecord {
@@ -80,4 +82,4 @@ declare function serializeValue(value: unknown, seen?: Map<object, string>, path
  */
 declare function deserializeValue(value: unknown, refs?: Map<string, unknown>, path?: string): unknown;
 
-export { __fictUseLexicalScope as A, __fictGetScopeProps as B, __fictQrl as C, __fictRegisterResume as D, __fictGetResume as E, serializeValue as F, deserializeValue as G, __fictUseContext as _, __fictPushContext as a, __fictPopContext as b, __fictUseSignal as c, __fictUseMemo as d, __fictUseEffect as e, __fictRender as f, __fictResetContext as g, __fictPrepareContext as h, __fictEnableSSR as i, __fictDisableSSR as j, __fictIsSSR as k, __fictEnableResumable as l, __fictDisableResumable as m, __fictIsResumable as n, __fictEnterHydration as o, __fictExitHydration as p, __fictIsHydrating as q, __fictRegisterScope as r, __fictGetScopeRegistry as s, __fictGetScopesForBoundary as t, __fictSerializeSSRState as u, __fictSerializeSSRStateForScopes as v, __fictSetSSRState as w, __fictMergeSSRState as x, __fictGetSSRScope as y, __fictEnsureScope as z };
+export { __fictEnsureScope as A, __fictGetScopeProps as B, __fictQrl as C, __fictRegisterResume as D, __fictGetResume as E, FICT_SSR_SNAPSHOT_SCHEMA_VERSION as F, serializeValue as G, deserializeValue as H, __fictUseLexicalScope as _, __fictUseContext as a, __fictPushContext as b, __fictPopContext as c, __fictUseSignal as d, __fictUseMemo as e, __fictUseEffect as f, __fictRender as g, __fictResetContext as h, __fictPrepareContext as i, __fictEnableSSR as j, __fictDisableSSR as k, __fictIsSSR as l, __fictEnableResumable as m, __fictDisableResumable as n, __fictIsResumable as o, __fictEnterHydration as p, __fictExitHydration as q, __fictIsHydrating as r, __fictRegisterScope as s, __fictGetScopeRegistry as t, __fictGetScopesForBoundary as u, __fictSerializeSSRState as v, __fictSerializeSSRStateForScopes as w, __fictSetSSRState as x, __fictMergeSSRState as y, __fictGetSSRScope as z };

package/dist/{resume-CqeQ3v_q.d.ts → resume-CuyJWXP_.d.ts}

@@ -28,7 +28,9 @@ interface ScopeSnapshot {
     props?: Record<string, unknown>;
     vars?: Record<string, number>;
 }
+declare const FICT_SSR_SNAPSHOT_SCHEMA_VERSION = 1;
 interface SSRState {
+    v: number;
     scopes: Record<string, ScopeSnapshot>;
 }
 interface ScopeRecord {
@@ -80,4 +82,4 @@ declare function serializeValue(value: unknown, seen?: Map<object, string>, path
  */
 declare function deserializeValue(value: unknown, refs?: Map<string, unknown>, path?: string): unknown;
 
-export { __fictUseLexicalScope as A, __fictGetScopeProps as B, __fictQrl as C, __fictRegisterResume as D, __fictGetResume as E, serializeValue as F, deserializeValue as G, __fictUseContext as _, __fictPushContext as a, __fictPopContext as b, __fictUseSignal as c, __fictUseMemo as d, __fictUseEffect as e, __fictRender as f, __fictResetContext as g, __fictPrepareContext as h, __fictEnableSSR as i, __fictDisableSSR as j, __fictIsSSR as k, __fictEnableResumable as l, __fictDisableResumable as m, __fictIsResumable as n, __fictEnterHydration as o, __fictExitHydration as p, __fictIsHydrating as q, __fictRegisterScope as r, __fictGetScopeRegistry as s, __fictGetScopesForBoundary as t, __fictSerializeSSRState as u, __fictSerializeSSRStateForScopes as v, __fictSetSSRState as w, __fictMergeSSRState as x, __fictGetSSRScope as y, __fictEnsureScope as z };
+export { __fictEnsureScope as A, __fictGetScopeProps as B, __fictQrl as C, __fictRegisterResume as D, __fictGetResume as E, FICT_SSR_SNAPSHOT_SCHEMA_VERSION as F, serializeValue as G, deserializeValue as H, __fictUseLexicalScope as _, __fictUseContext as a, __fictPushContext as b, __fictPopContext as c, __fictUseSignal as d, __fictUseMemo as e, __fictUseEffect as f, __fictRender as g, __fictResetContext as h, __fictPrepareContext as i, __fictEnableSSR as j, __fictDisableSSR as k, __fictIsSSR as l, __fictEnableResumable as m, __fictDisableResumable as n, __fictIsResumable as o, __fictEnterHydration as p, __fictExitHydration as q, __fictIsHydrating as r, __fictRegisterScope as s, __fictGetScopeRegistry as t, __fictGetScopesForBoundary as u, __fictSerializeSSRState as v, __fictSerializeSSRStateForScopes as w, __fictSetSSRState as x, __fictMergeSSRState as y, __fictGetSSRScope as z };

package/dist/{scope-DlCBL1Ft.d.cts → scope-BJCtq8hJ.d.cts}

@@ -1,4 +1,4 @@
-import { a2 as MaybeReactive } from './effect-DAzpH7Mm.cjs';
+import { M as MaybeReactive } from './binding-BWchH3Kp.cjs';
 
 interface ReactiveScope {
     run<T>(fn: () => T): T;

package/dist/{scope-D3DpsfoG.d.ts → scope-jPt5DHRT.d.ts}

@@ -1,4 +1,4 @@
-import { a2 as MaybeReactive } from './effect-DAzpH7Mm.js';
+import { M as MaybeReactive } from './binding-BWchH3Kp.js';
 
 interface ReactiveScope {
     run<T>(fn: () => T): T;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fictjs/runtime",
-  "version": "0.7.0",
+  "version": "0.9.0",
   "description": "Fict reactive runtime",
   "publishConfig": {
     "access": "public",
@@ -33,6 +33,11 @@
       "import": "./dist/internal.js",
       "require": "./dist/internal.cjs"
     },
+    "./internal/list": {
+      "types": "./dist/internal-list.d.ts",
+      "import": "./dist/internal-list.js",
+      "require": "./dist/internal-list.cjs"
+    },
     "./advanced": {
       "types": "./dist/advanced.d.ts",
       "import": "./dist/advanced.js",
@@ -68,6 +73,8 @@
     "build": "tsup",
     "dev": "tsup --watch",
     "test": "vitest run",
+    "test:stress": "FICT_RUNTIME_STRESS=1 vitest run test/runtime-stability.stress.test.ts",
+    "test:stress:long": "FICT_RUNTIME_STRESS=1 FICT_RUNTIME_SOAK_ITERS=12000 FICT_RUNTIME_CHURN_CYCLES=500 FICT_RUNTIME_LEAK_ROUNDS=120 FICT_RUNTIME_LEAK_EFFECTS_PER_ROUND=200 FICT_RUNTIME_BACKPRESSURE_UPDATES=16000 FICT_RUNTIME_MAX_DRAIN_LATENCY_MS=2500 vitest run test/runtime-stability.stress.test.ts",
     "test:watch": "vitest",
     "test:coverage": "vitest run --coverage",
     "bench": "vitest bench --run",

package/src/binding.ts

@@ -112,6 +112,16 @@ export interface BindingHandle {
   dispose: Cleanup
 }
 
+export interface ConditionalBindingOptions {
+  /**
+   * When true, track signal reads inside active branch render callbacks and
+   * re-run the branch callback on updates even if the top-level condition stays
+   * the same. This preserves reactivity for control-flow callbacks that cannot
+   * be lowered into fine-grained bindings.
+   */
+  trackBranchReads?: boolean
+}
+
 /** Managed child node with its dispose function */
 // ============================================================================
 // Utility Functions
@@ -1743,7 +1753,9 @@ export function createConditional(
   renderFalse?: () => FictNode,
   startOverride?: Comment,
   endOverride?: Comment,
+  options?: ConditionalBindingOptions,
 ): BindingHandle {
+  const trackBranchReads = options?.trackBranchReads === true
   const useProvided = !!(startOverride && endOverride)
   const startMarker = useProvided ? startOverride! : document.createComment('fict:cond:start')
   const endMarker = useProvided ? endOverride! : document.createComment('fict:cond:end')
@@ -1805,7 +1817,7 @@ export function createConditional(
           endMarker,
           parent.ownerDocument ?? document,
           () => {
-            const output = untrack(render)
+            const output = trackBranchReads ? render() : untrack(render)
             if (output == null || output === false) {
               return
             }
@@ -1837,10 +1849,102 @@ export function createConditional(
       return
     }
 
-    if (lastCondition === cond && currentNodes.length > 0) {
-      return
-    }
-    if (lastCondition === cond && lastCondition === false && renderFalse === undefined) {
+    if (!trackBranchReads) {
+      if (lastCondition === cond && currentNodes.length > 0) {
+        return
+      }
+      if (lastCondition === cond && lastCondition === false && renderFalse === undefined) {
+        return
+      }
+    } else if (lastCondition === cond) {
+      const render = cond ? renderTrue : renderFalse
+      if (!render) {
+        return
+      }
+
+      let patched = false
+      const scratchRoot = createRootContext(hostRoot)
+      const prevScratch = pushRoot(scratchRoot)
+      let handledPatchError = false
+      let scratchOutput: FictNode = null
+      try {
+        const output = render()
+        scratchOutput = output
+        if (output != null && output !== false) {
+          if (currentNodes.length === 1) {
+            patched = patchNode(currentNodes[0] ?? null, output)
+          }
+          if (!patched && Array.isArray(output)) {
+            patched = _patchFragmentChildren(currentNodes, output)
+          }
+          if (!patched && _isFragmentVNode(output)) {
+            patched = _patchFragmentChildren(currentNodes, output.props?.children)
+          }
+        }
+      } catch (err) {
+        if (handleSuspend(err as any, scratchRoot)) {
+          handledPatchError = true
+          return
+        }
+        if (handleError(err, { source: 'renderChild' }, scratchRoot)) {
+          handledPatchError = true
+          return
+        }
+        throw err
+      } finally {
+        popRoot(prevScratch)
+      }
+
+      if (handledPatchError) {
+        destroyRoot(scratchRoot)
+        return
+      }
+
+      if (patched) {
+        destroyRoot(scratchRoot)
+        return
+      }
+
+      lastCondition = cond
+
+      if (currentRoot) {
+        destroyRoot(currentRoot)
+        currentRoot = null
+      }
+      removeNodes(currentNodes)
+      currentNodes = []
+
+      const prev = pushRoot(scratchRoot)
+      let handledError = false
+      try {
+        if (scratchOutput == null || scratchOutput === false) {
+          return
+        }
+        const el = createElementFn(scratchOutput)
+        const nodes = toNodeArray(el)
+        insertNodesBefore(parent, nodes, endMarker)
+        currentNodes = nodes
+      } catch (err) {
+        if (handleSuspend(err as any, scratchRoot)) {
+          handledError = true
+          destroyRoot(scratchRoot)
+          return
+        }
+        if (handleError(err, { source: 'renderChild' }, scratchRoot)) {
+          handledError = true
+          destroyRoot(scratchRoot)
+          return
+        }
+        throw err
+      } finally {
+        popRoot(prev)
+        if (!handledError) {
+          flushOnMount(scratchRoot)
+          currentRoot = scratchRoot
+        } else {
+          currentRoot = null
+        }
+      }
       return
     }
     lastCondition = cond
@@ -1865,7 +1969,7 @@ export function createConditional(
       // tracked by createConditional's effect. This ensures that signals used
       // inside the render function (e.g., nested if conditions) don't cause
       // createConditional to re-run, which would purge child effect deps.
-      const output = untrack(render)
+      const output = trackBranchReads ? render() : untrack(render)
       if (output == null || output === false) {
         return
       }
@@ -2050,23 +2154,6 @@ export function createPortal(
 }
 
 function patchElement(el: Element, output: FictNode): boolean {
-  if (
-    output === null ||
-    output === undefined ||
-    output === false ||
-    typeof output === 'string' ||
-    typeof output === 'number'
-  ) {
-    el.textContent =
-      output === null || output === undefined || output === false ? '' : String(output)
-    return true
-  }
-
-  if (output instanceof Text) {
-    el.textContent = output.data
-    return true
-  }
-
   if (output && typeof output === 'object' && !(output instanceof Node)) {
     const vnode = output as { type?: unknown; props?: Record<string, unknown> }
     if (typeof vnode.type === 'string' && vnode.type.toLowerCase() === el.tagName.toLowerCase()) {
@@ -2131,19 +2218,6 @@ function patchElement(el: Element, output: FictNode): boolean {
     }
   }
 
-  if (output instanceof Node) {
-    if (output.nodeType === Node.ELEMENT_NODE) {
-      const nextEl = output as Element
-      if (nextEl.tagName.toLowerCase() === el.tagName.toLowerCase()) {
-        el.textContent = nextEl.textContent
-        return true
-      }
-    } else if (output.nodeType === Node.TEXT_NODE) {
-      el.textContent = (output as Text).data
-      return true
-    }
-  }
-
   return false
 }
 
@@ -2207,6 +2281,9 @@ function normalizeChildren(
   if (children === null || children === false) {
     return result
   }
+  if (_isFragmentVNode(children)) {
+    return normalizeChildren(children.props?.children, result)
+  }
   result.push(children)
   return result
 }

package/src/cycle-guard.ts

@@ -6,7 +6,7 @@ const isDev =
     : typeof process !== 'undefined' && process.env?.NODE_ENV !== 'production'
 
 export interface CycleProtectionOptions {
-  /** Enable cycle protection guards (enabled by default in all modes) */
+  /** Enable cycle protection guards (enabled by default in dev mode) */
   enabled?: boolean
   maxFlushCyclesPerMicrotask?: number
   maxEffectRunsPerFlush?: number
@@ -35,8 +35,8 @@ let enterRootGuard: (root: object) => boolean = () => true
 let exitRootGuard: (root: object) => void = () => {}
 
 const defaultOptions = {
-  // Keep cycle guards on in production to avoid infinite flush loops.
-  enabled: true,
+  // DX-first in development, performance-first in production.
+  enabled: isDev,
   maxFlushCyclesPerMicrotask: 10_000,
   maxEffectRunsPerFlush: 20_000,
   windowSize: 5,

package/src/internal/list.ts

@@ -0,0 +1,7 @@
+/**
+ * Lightweight internal list helpers for compiler-generated keyed list paths.
+ *
+ * This subpath avoids pulling the broad `@fictjs/runtime/internal` barrel when
+ * code only needs list primitives.
+ */
+export { createKeyedList, toNodeArray, type KeyedListBinding } from '../list-helpers'