@fictjs/runtime 0.8.0 → 0.10.0

package/dist/list-BBzsJhrm.d.ts

@@ -0,0 +1,71 @@
+import { S as SignalAccessor } from './signal-Z4KkDk9h.js';
+
+/**
+ * Low-level DOM node helpers shared across runtime modules.
+ * Keep this file dependency-free to avoid module cycles.
+ */
+/**
+ * Convert a value to a flat array of DOM nodes.
+ * Defensively handles proxies and non-DOM values.
+ */
+declare function toNodeArray(node: Node | Node[] | unknown): Node[];
+/**
+ * Insert nodes before an anchor node, preserving order.
+ * Uses DocumentFragment for batch insertion when inserting multiple nodes.
+ */
+declare function insertNodesBefore(parent: ParentNode & Node, nodes: Node[], anchor: Node | null): void;
+/**
+ * Remove an array of nodes from the DOM.
+ */
+declare function removeNodes(nodes: Node[]): void;
+declare function getSlotEnd(start: Comment): Comment;
+declare function resolvePath(root: Node, path: number[]): Node | null;
+
+/**
+ * List Helpers for Compiler-Generated Fine-Grained Updates
+ *
+ * These helpers are used by the compiler to generate efficient keyed list rendering.
+ * They provide low-level primitives for DOM node manipulation without rebuilding.
+ */
+
+/**
+ * Binding handle returned by createKeyedList for compiler-generated code
+ */
+interface KeyedListBinding {
+    /** Document fragment placeholder inserted by the compiler/runtime */
+    marker: Comment | DocumentFragment;
+    /** Start marker comment node */
+    startMarker: Comment;
+    /** End marker comment node */
+    endMarker: Comment;
+    /** Flush pending items - call after markers are inserted into DOM */
+    flush?: () => void;
+    /** Cleanup function */
+    dispose: () => void;
+}
+type FineGrainedRenderItem<T> = (itemSig: SignalAccessor<T>, indexSig: SignalAccessor<number>, key: string | number) => Node[];
+/**
+ * Move nodes to a position before the anchor node.
+ * This is optimized to avoid unnecessary DOM operations.
+ *
+ * @param parent - Parent node to move nodes within
+ * @param nodes - Array of nodes to move
+ * @param anchor - Node to insert before (or null for end)
+ */
+declare function moveNodesBefore(parent: Node, nodes: Node[], anchor: Node | null): void;
+/**
+ * Check if a node is between two markers
+ */
+declare function isNodeBetweenMarkers(node: Node, startMarker: Comment, endMarker: Comment): boolean;
+/**
+ * Create a keyed list binding with automatic diffing and DOM updates.
+ * This is used by compiler-generated code for efficient list rendering.
+ *
+ * @param getItems - Function that returns the current array of items
+ * @param keyFn - Function to extract unique key from each item
+ * @param renderItem - Function that creates DOM nodes for each item
+ * @returns Binding handle with markers and dispose function
+ */
+declare function createKeyedList<T>(getItems: () => T[], keyFn: (item: T, index: number) => string | number, renderItem: FineGrainedRenderItem<T>, needsIndex?: boolean, startMarker?: Comment, endMarker?: Comment): KeyedListBinding;
+
+export { type KeyedListBinding as K, removeNodes as a, isNodeBetweenMarkers as b, createKeyedList as c, getSlotEnd as g, insertNodesBefore as i, moveNodesBefore as m, resolvePath as r, toNodeArray as t };

package/dist/list-_NJCcjl1.d.cts

@@ -0,0 +1,71 @@
+import { S as SignalAccessor } from './signal-Z4KkDk9h.cjs';
+
+/**
+ * Low-level DOM node helpers shared across runtime modules.
+ * Keep this file dependency-free to avoid module cycles.
+ */
+/**
+ * Convert a value to a flat array of DOM nodes.
+ * Defensively handles proxies and non-DOM values.
+ */
+declare function toNodeArray(node: Node | Node[] | unknown): Node[];
+/**
+ * Insert nodes before an anchor node, preserving order.
+ * Uses DocumentFragment for batch insertion when inserting multiple nodes.
+ */
+declare function insertNodesBefore(parent: ParentNode & Node, nodes: Node[], anchor: Node | null): void;
+/**
+ * Remove an array of nodes from the DOM.
+ */
+declare function removeNodes(nodes: Node[]): void;
+declare function getSlotEnd(start: Comment): Comment;
+declare function resolvePath(root: Node, path: number[]): Node | null;
+
+/**
+ * List Helpers for Compiler-Generated Fine-Grained Updates
+ *
+ * These helpers are used by the compiler to generate efficient keyed list rendering.
+ * They provide low-level primitives for DOM node manipulation without rebuilding.
+ */
+
+/**
+ * Binding handle returned by createKeyedList for compiler-generated code
+ */
+interface KeyedListBinding {
+    /** Document fragment placeholder inserted by the compiler/runtime */
+    marker: Comment | DocumentFragment;
+    /** Start marker comment node */
+    startMarker: Comment;
+    /** End marker comment node */
+    endMarker: Comment;
+    /** Flush pending items - call after markers are inserted into DOM */
+    flush?: () => void;
+    /** Cleanup function */
+    dispose: () => void;
+}
+type FineGrainedRenderItem<T> = (itemSig: SignalAccessor<T>, indexSig: SignalAccessor<number>, key: string | number) => Node[];
+/**
+ * Move nodes to a position before the anchor node.
+ * This is optimized to avoid unnecessary DOM operations.
+ *
+ * @param parent - Parent node to move nodes within
+ * @param nodes - Array of nodes to move
+ * @param anchor - Node to insert before (or null for end)
+ */
+declare function moveNodesBefore(parent: Node, nodes: Node[], anchor: Node | null): void;
+/**
+ * Check if a node is between two markers
+ */
+declare function isNodeBetweenMarkers(node: Node, startMarker: Comment, endMarker: Comment): boolean;
+/**
+ * Create a keyed list binding with automatic diffing and DOM updates.
+ * This is used by compiler-generated code for efficient list rendering.
+ *
+ * @param getItems - Function that returns the current array of items
+ * @param keyFn - Function to extract unique key from each item
+ * @param renderItem - Function that creates DOM nodes for each item
+ * @returns Binding handle with markers and dispose function
+ */
+declare function createKeyedList<T>(getItems: () => T[], keyFn: (item: T, index: number) => string | number, renderItem: FineGrainedRenderItem<T>, needsIndex?: boolean, startMarker?: Comment, endMarker?: Comment): KeyedListBinding;
+
+export { type KeyedListBinding as K, removeNodes as a, isNodeBetweenMarkers as b, createKeyedList as c, getSlotEnd as g, insertNodesBefore as i, moveNodesBefore as m, resolvePath as r, toNodeArray as t };

package/dist/loader.cjs

@@ -7,7 +7,8 @@
 
 
 
-var _chunkFSCBL7RIcjs = require('./chunk-FSCBL7RI.cjs');
+
+var _chunkEQ5E4WOVcjs = require('./chunk-EQ5E4WOV.cjs');
 
 // 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 = _nullishCoalesce(options.document, () => ( window.document));
   const scriptId = _nullishCoalesce(options.snapshotScriptId, () => ( "__FICT_SNAPSHOT__"));
+  snapshotIssueHandler = _nullishCoalesce(options.onSnapshotIssue, () => ( null));
   hydratedScopes.clear();
   prefetchedUrls.clear();
   processedSnapshots.clear();
+  emittedIssueKeys.clear();
+  _chunkEQ5E4WOVcjs.__fictSetSSRState.call(void 0, null);
   if (eventListenerCleanup) {
     eventListenerCleanup();
     eventListenerCleanup = null;
@@ -63,10 +69,9 @@ function installResumableLoader(options = {}) {
   }
   const snapshotEl = doc.getElementById(scriptId);
   if (_optionalChain([snapshotEl, 'optionalAccess', _ => _.textContent])) {
-    try {
-      const state = JSON.parse(snapshotEl.textContent);
-      _chunkFSCBL7RIcjs.__fictSetSSRState.call(void 0, state);
-    } catch (e) {
+    const state = parseSnapshotText(snapshotEl.textContent, `#${scriptId}`);
+    if (state) {
+      _chunkEQ5E4WOVcjs.__fictSetSSRState.call(void 0, state);
     }
   }
   const snapshotScripts = doc.querySelectorAll(
@@ -99,8 +104,8 @@ function installResumableLoader(options = {}) {
     });
     snapshotObserver.observe(_nullishCoalesce(doc.documentElement, () => ( doc)), { childList: true, subtree: true });
   }
-  _chunkFSCBL7RIcjs.__fictEnableResumable.call(void 0, );
-  const events = _nullishCoalesce(options.events, () => ( Array.from(_chunkFSCBL7RIcjs.DelegatedEvents)));
+  _chunkEQ5E4WOVcjs.__fictEnableResumable.call(void 0, );
+  const events = _nullishCoalesce(options.events, () => ( Array.from(_chunkEQ5E4WOVcjs.DelegatedEvents)));
   for (const eventName of events) {
     doc.addEventListener(eventName, handleResumableEvent, true);
   }
@@ -121,10 +126,76 @@ function parseSnapshotScript(script) {
   processedSnapshots.add(script);
   const text = script.textContent;
   if (!text) return;
+  const source = script.id ? `#${script.id}` : "<script[data-fict-snapshot]>";
+  const state = parseSnapshotText(text, source);
+  if (state) {
+    _chunkEQ5E4WOVcjs.__fictMergeSSRState.call(void 0, state);
+  }
+}
+function parseSnapshotText(text, source) {
+  let parsed;
   try {
-    const state = JSON.parse(text);
-    _chunkFSCBL7RIcjs.__fictMergeSSRState.call(void 0, state);
-  } catch (e2) {
+    parsed = JSON.parse(text);
+  } catch (e) {
+    emitSnapshotIssue({
+      code: "snapshot_parse_error",
+      message: "[fict/loader] Failed to parse SSR snapshot JSON.",
+      source,
+      expectedVersion: _chunkEQ5E4WOVcjs.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: _chunkEQ5E4WOVcjs.FICT_SSR_SNAPSHOT_SCHEMA_VERSION
+    });
+    return null;
+  }
+  const rawVersion = value.v;
+  const version = rawVersion === void 0 ? _chunkEQ5E4WOVcjs.FICT_SSR_SNAPSHOT_SCHEMA_VERSION : rawVersion;
+  if (!Number.isInteger(version) || version !== _chunkEQ5E4WOVcjs.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: _chunkEQ5E4WOVcjs.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: _chunkEQ5E4WOVcjs.FICT_SSR_SNAPSHOT_SCHEMA_VERSION
+    });
+    return null;
+  }
+  return { v: _chunkEQ5E4WOVcjs.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}|${_nullishCoalesce(issue.scopeId, () => ( ""))}|${_nullishCoalesce(issue.actualVersion, () => ( ""))}|${issue.expectedVersion}`;
+  if (emittedIssueKeys.has(key)) return;
+  emittedIssueKeys.add(key);
+  _optionalChain([snapshotIssueHandler, 'optionalCall', _4 => _4(issue)]);
+  if (typeof console !== "undefined" && typeof console.warn === "function") {
+    console.warn(issue.message);
   }
 }
 function setupPrefetch(doc, strategy) {
@@ -247,7 +318,11 @@ function prefetchQrl(qrl) {
 function handleResumableEvent(event) {
   const promise = handleResumableEventAsync(event);
   pendingHandlers.add(promise);
-  promise.finally(() => {
+  void promise.catch((error) => {
+    if (typeof console !== "undefined" && typeof console.error === "function") {
+      console.error("[fict/loader] Failed to handle resumable event.", error);
+    }
+  }).finally(() => {
     pendingHandlers.delete(promise);
   });
 }
@@ -261,10 +336,18 @@ async function handleResumableEventAsync(event) {
     if (!host) continue;
     const scopeId = host.getAttribute("data-fict-s");
     if (!scopeId) continue;
-    const snapshot = _chunkFSCBL7RIcjs.__fictGetSSRScope.call(void 0, scopeId);
-    if (snapshot) {
-      _chunkFSCBL7RIcjs.__fictEnsureScope.call(void 0, scopeId, host, snapshot);
+    const snapshot = _chunkEQ5E4WOVcjs.__fictGetSSRScope.call(void 0, scopeId);
+    if (!snapshot) {
+      emitSnapshotIssue({
+        code: "scope_snapshot_missing",
+        message: `[fict/loader] Missing scope snapshot for ${scopeId}; skipping resumable handler execution.`,
+        source: "event",
+        expectedVersion: _chunkEQ5E4WOVcjs.FICT_SSR_SNAPSHOT_SCHEMA_VERSION,
+        scopeId
+      });
+      continue;
     }
+    _chunkEQ5E4WOVcjs.__fictEnsureScope.call(void 0, scopeId, host, snapshot);
     const { url, exportName } = parseQrl(qrl);
     if (event.cancelable && (event.type === "click" || event.type === "submit")) {
       const tag = node.tagName.toLowerCase();
@@ -281,7 +364,7 @@ async function handleResumableEventAsync(event) {
           /* @vite-ignore */
           resolvedResumeUrl
         )));
-        const resumeFn = _chunkFSCBL7RIcjs.__fictGetResume.call(void 0, resumeExport);
+        const resumeFn = _chunkEQ5E4WOVcjs.__fictGetResume.call(void 0, resumeExport);
         if (typeof resumeFn === "function") {
           await resumeFn(scopeId, host);
           hydratedScopes.add(scopeId);
@@ -328,5 +411,5 @@ function buildEventPath(event) {
 
 
 
-exports.__fictUseLexicalScope = _chunkFSCBL7RIcjs.__fictUseLexicalScope; exports.cleanupEventListeners = cleanupEventListeners; exports.installResumableLoader = installResumableLoader; exports.resetHydratedScopes = resetHydratedScopes; exports.resetPrefetchedUrls = resetPrefetchedUrls; exports.waitForPendingHandlers = waitForPendingHandlers;
+exports.__fictUseLexicalScope = _chunkEQ5E4WOVcjs.__fictUseLexicalScope; exports.cleanupEventListeners = cleanupEventListeners; exports.installResumableLoader = installResumableLoader; exports.resetHydratedScopes = resetHydratedScopes; exports.resetPrefetchedUrls = resetPrefetchedUrls; exports.waitForPendingHandlers = waitForPendingHandlers;
 //# sourceMappingURL=loader.cjs.map

package/dist/loader.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["/home/runner/work/fict/fict/packages/runtime/dist/loader.cjs","../src/loader.ts"],"names":[],"mappings":"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","file":"/home/runner/work/fict/fict/packages/runtime/dist/loader.cjs","sourcesContent":[null,"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"]}
+{"version":3,"sources":["/home/runner/work/fict/fict/packages/runtime/dist/loader.cjs","../src/loader.ts"],"names":[],"mappings":"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","file":"/home/runner/work/fict/fict/packages/runtime/dist/loader.cjs","sourcesContent":[null,"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  void promise\n    .catch(error => {\n      if (typeof console !== 'undefined' && typeof console.error === 'function') {\n        console.error('[fict/loader] Failed to handle resumable event.', error)\n      }\n    })\n    .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      continue\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"]}

package/dist/loader.d.cts

@@ -1,5 +1,5 @@
-export { A as __fictUseLexicalScope } from './resume-i-A3EFox.cjs';
-import './signal-C4ISF17w.cjs';
+export { _ as __fictUseLexicalScope } from './resume-DPZxmA95.cjs';
+import './signal-Z4KkDk9h.cjs';
 
 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.d.ts

@@ -1,5 +1,5 @@
-export { A as __fictUseLexicalScope } from './resume-CqeQ3v_q.js';
-import './signal-C4ISF17w.js';
+export { _ as __fictUseLexicalScope } from './resume-C5IKAIdh.js';
+import './signal-Z4KkDk9h.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 };