@fictjs/runtime 0.8.0 → 0.10.0

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-F4RVNXOL.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) {
@@ -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);
   });
 }
@@ -262,9 +337,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
+      });
+      continue;
     }
+    __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  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"],"mappings":"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","names":[]}

package/dist/{props-84UJeWO8.d.cts → props--zJ4ebbT.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 { M as MemoOptions } from './signal-Z4KkDk9h.cjs';
+import { F as FictNode, R as DOMElement } from './binding-DUEukRxl.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-BAGR7j-j.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 { M as MemoOptions } from './signal-Z4KkDk9h.js';
+import { F as FictNode, R as DOMElement } from './binding-DqxS9ZQf.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-C5IKAIdh.d.ts}

@@ -1,4 +1,4 @@
-import { a as SignalOptions, S as SignalAccessor, M as MemoOptions, C as ComputedAccessor } from './signal-C4ISF17w.cjs';
+import { a as SignalOptions, S as SignalAccessor, M as MemoOptions, C as ComputedAccessor, E as EffectOptions } from './signal-Z4KkDk9h.js';
 
 interface HookContext {
     slots: unknown[];
@@ -17,7 +17,7 @@ declare function __fictPopContext(): void;
 declare function __fictResetContext(): void;
 declare function __fictUseSignal<T>(ctx: HookContext, initial: T, optionsOrSlot?: number | SignalOptions<T>, slot?: number): SignalAccessor<T>;
 declare function __fictUseMemo<T>(ctx: HookContext, fn: () => T, optionsOrSlot?: number | MemoOptions<T>, slot?: number): ComputedAccessor<T>;
-declare function __fictUseEffect(ctx: HookContext, fn: () => void, slot?: number): void;
+declare function __fictUseEffect(ctx: HookContext, fn: () => void, optionsOrSlot?: number | EffectOptions, slot?: number): void;
 declare function __fictRender<T>(ctx: HookContext, fn: () => T): T;
 
 type SlotSnapshot = [index: number, type: 'sig', value: unknown] | [index: number, type: 'store', value: unknown] | [index: number, type: 'raw', value: unknown];
@@ -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-DPZxmA95.d.cts}

@@ -1,4 +1,4 @@
-import { a as SignalOptions, S as SignalAccessor, M as MemoOptions, C as ComputedAccessor } from './signal-C4ISF17w.js';
+import { a as SignalOptions, S as SignalAccessor, M as MemoOptions, C as ComputedAccessor, E as EffectOptions } from './signal-Z4KkDk9h.cjs';
 
 interface HookContext {
     slots: unknown[];
@@ -17,7 +17,7 @@ declare function __fictPopContext(): void;
 declare function __fictResetContext(): void;
 declare function __fictUseSignal<T>(ctx: HookContext, initial: T, optionsOrSlot?: number | SignalOptions<T>, slot?: number): SignalAccessor<T>;
 declare function __fictUseMemo<T>(ctx: HookContext, fn: () => T, optionsOrSlot?: number | MemoOptions<T>, slot?: number): ComputedAccessor<T>;
-declare function __fictUseEffect(ctx: HookContext, fn: () => void, slot?: number): void;
+declare function __fictUseEffect(ctx: HookContext, fn: () => void, optionsOrSlot?: number | EffectOptions, slot?: number): void;
 declare function __fictRender<T>(ctx: HookContext, fn: () => T): T;
 
 type SlotSnapshot = [index: number, type: 'sig', value: unknown] | [index: number, type: 'store', value: unknown] | [index: number, type: 'raw', value: unknown];
@@ -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-D3DpsfoG.d.ts → scope-CuImnvh1.d.ts}

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

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

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

package/dist/{signal-C4ISF17w.d.cts → signal-Z4KkDk9h.d.cts}

@@ -19,6 +19,17 @@ interface MemoOptions<T> {
     name?: string;
     /** Source location */
     devToolsSource?: string;
+    /** Internal memo created by compiler runtime plumbing (hidden from DevTools) */
+    internal?: boolean;
+}
+/**
+ * Options for creating an effect
+ */
+interface EffectOptions {
+    /** Debug name */
+    name?: string;
+    /** Source location */
+    devToolsSource?: string;
 }
 /**
  * Signal accessor - function to get/set signal value
@@ -63,4 +74,4 @@ declare function __resetReactiveState(): void;
  */
 declare function createSelector<T>(source: () => T, equalityFn?: (a: T, b: T) => boolean): (key: T) => boolean;
 
-export { type ComputedAccessor as C, type MemoOptions as M, type SignalAccessor as S, __resetReactiveState as _, type SignalOptions as a, createSelector as c, effectScope as e, signal as s };
+export { type ComputedAccessor as C, type EffectOptions as E, type MemoOptions as M, type SignalAccessor as S, __resetReactiveState as _, type SignalOptions as a, createSelector as c, effectScope as e, signal as s };

package/dist/{signal-C4ISF17w.d.ts → signal-Z4KkDk9h.d.ts}

@@ -19,6 +19,17 @@ interface MemoOptions<T> {
     name?: string;
     /** Source location */
     devToolsSource?: string;
+    /** Internal memo created by compiler runtime plumbing (hidden from DevTools) */
+    internal?: boolean;
+}
+/**
+ * Options for creating an effect
+ */
+interface EffectOptions {
+    /** Debug name */
+    name?: string;
+    /** Source location */
+    devToolsSource?: string;
 }
 /**
  * Signal accessor - function to get/set signal value
@@ -63,4 +74,4 @@ declare function __resetReactiveState(): void;
  */
 declare function createSelector<T>(source: () => T, equalityFn?: (a: T, b: T) => boolean): (key: T) => boolean;
 
-export { type ComputedAccessor as C, type MemoOptions as M, type SignalAccessor as S, __resetReactiveState as _, type SignalOptions as a, createSelector as c, effectScope as e, signal as s };
+export { type ComputedAccessor as C, type EffectOptions as E, type MemoOptions as M, type SignalAccessor as S, __resetReactiveState as _, type SignalOptions as a, createSelector as c, effectScope as e, signal as s };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fictjs/runtime",
-  "version": "0.8.0",
+  "version": "0.10.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",
@@ -65,9 +70,11 @@
   "author": "unadlib",
   "license": "MIT",
   "scripts": {
-    "build": "tsup",
+    "build": "pnpm run clean && 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",