@fictjs/runtime 0.5.1 → 0.6.0

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  __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\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\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  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  __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\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  __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":[]}

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

@@ -35,6 +35,7 @@ interface ScopeRecord {
     id: string;
     ctx: HookContext;
     host: Element;
+    boundaryId?: string;
     type?: string;
     props?: Record<string, unknown>;
 }
@@ -49,8 +50,11 @@ declare function __fictExitHydration(): void;
 declare function __fictIsHydrating(): boolean;
 declare function __fictRegisterScope(ctx: HookContext, host: Element, type?: string, props?: Record<string, unknown>): string;
 declare function __fictGetScopeRegistry(): Map<string, ScopeRecord>;
+declare function __fictGetScopesForBoundary(boundaryId: string): string[];
 declare function __fictSerializeSSRState(): SSRState;
+declare function __fictSerializeSSRStateForScopes(scopeIds: Iterable<string>): SSRState;
 declare function __fictSetSSRState(state: SSRState | null): void;
+declare function __fictMergeSSRState(state: SSRState | null): void;
 declare function __fictGetSSRScope(id: string): ScopeSnapshot | undefined;
 declare function __fictEnsureScope(scopeId: string, host: Element, snapshot?: ScopeSnapshot): HookContext;
 declare function __fictUseLexicalScope(scopeId: string, names: string[]): unknown[];
@@ -76,4 +80,4 @@ declare function serializeValue(value: unknown, seen?: Map<object, string>, path
  */
 declare function deserializeValue(value: unknown, refs?: Map<string, unknown>, path?: string): unknown;
 
-export { __fictRegisterResume as A, __fictGetResume as B, serializeValue as C, deserializeValue as D, __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, __fictSerializeSSRState as t, __fictSetSSRState as u, __fictGetSSRScope as v, __fictEnsureScope as w, __fictUseLexicalScope as x, __fictGetScopeProps as y, __fictQrl as z };
+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 };

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

@@ -35,6 +35,7 @@ interface ScopeRecord {
     id: string;
     ctx: HookContext;
     host: Element;
+    boundaryId?: string;
     type?: string;
     props?: Record<string, unknown>;
 }
@@ -49,8 +50,11 @@ declare function __fictExitHydration(): void;
 declare function __fictIsHydrating(): boolean;
 declare function __fictRegisterScope(ctx: HookContext, host: Element, type?: string, props?: Record<string, unknown>): string;
 declare function __fictGetScopeRegistry(): Map<string, ScopeRecord>;
+declare function __fictGetScopesForBoundary(boundaryId: string): string[];
 declare function __fictSerializeSSRState(): SSRState;
+declare function __fictSerializeSSRStateForScopes(scopeIds: Iterable<string>): SSRState;
 declare function __fictSetSSRState(state: SSRState | null): void;
+declare function __fictMergeSSRState(state: SSRState | null): void;
 declare function __fictGetSSRScope(id: string): ScopeSnapshot | undefined;
 declare function __fictEnsureScope(scopeId: string, host: Element, snapshot?: ScopeSnapshot): HookContext;
 declare function __fictUseLexicalScope(scopeId: string, names: string[]): unknown[];
@@ -76,4 +80,4 @@ declare function serializeValue(value: unknown, seen?: Map<object, string>, path
  */
 declare function deserializeValue(value: unknown, refs?: Map<string, unknown>, path?: string): unknown;
 
-export { __fictRegisterResume as A, __fictGetResume as B, serializeValue as C, deserializeValue as D, __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, __fictSerializeSSRState as t, __fictSetSSRState as u, __fictGetSSRScope as v, __fictEnsureScope as w, __fictUseLexicalScope as x, __fictGetScopeProps as y, __fictQrl as z };
+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 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fictjs/runtime",
-  "version": "0.5.1",
+  "version": "0.6.0",
   "description": "Fict reactive runtime",
   "publishConfig": {
     "access": "public",

package/src/internal.ts

@@ -50,8 +50,11 @@ export {
   __fictIsHydrating,
   __fictRegisterScope,
   __fictGetScopeRegistry,
+  __fictGetScopesForBoundary,
   __fictSerializeSSRState,
+  __fictSerializeSSRStateForScopes,
   __fictSetSSRState,
+  __fictMergeSSRState,
   __fictGetSSRScope,
   __fictEnsureScope,
   __fictUseLexicalScope,
@@ -62,6 +65,7 @@ export {
   serializeValue,
   deserializeValue,
 } from './resume'
+export { __fictGetSSRStreamHooks, __fictSetSSRStreamHooks } from './ssr-stream'
 
 // ============================================================================
 // Props Helpers (Compiler-generated code)

package/src/loader.ts

@@ -4,6 +4,7 @@ import {
   __fictEnsureScope,
   __fictGetResume,
   __fictGetSSRScope,
+  __fictMergeSSRState,
   __fictSetSSRState,
   __fictUseLexicalScope,
 } from './resume'
@@ -82,6 +83,8 @@ const hydratedScopes = new Set<string>()
 const prefetchedUrls = new Set<string>()
 let prefetchCleanup: (() => void) | null = null
 let eventListenerCleanup: (() => void) | null = null
+let snapshotObserver: MutationObserver | null = null
+const processedSnapshots = new Set<HTMLScriptElement>()
 
 /**
  * Reset the hydrated scopes set. Useful for testing.
@@ -131,6 +134,7 @@ export function installResumableLoader(options: ResumableLoaderOptions = {}): vo
   // Reset hydrated scopes for fresh loader installation
   hydratedScopes.clear()
   prefetchedUrls.clear()
+  processedSnapshots.clear()
 
   // Clean up previous event listeners
   if (eventListenerCleanup) {
@@ -144,6 +148,11 @@ export function installResumableLoader(options: ResumableLoaderOptions = {}): vo
     prefetchCleanup = null
   }
 
+  if (snapshotObserver) {
+    snapshotObserver.disconnect()
+    snapshotObserver = null
+  }
+
   const snapshotEl = doc.getElementById(scriptId)
   if (snapshotEl?.textContent) {
     try {
@@ -154,6 +163,38 @@ export function installResumableLoader(options: ResumableLoaderOptions = {}): vo
     }
   }
 
+  const snapshotScripts = doc.querySelectorAll(
+    'script[type="application/json"][data-fict-snapshot]',
+  )
+  for (const script of Array.from(snapshotScripts)) {
+    parseSnapshotScript(script as HTMLScriptElement)
+  }
+
+  if (typeof MutationObserver !== 'undefined') {
+    snapshotObserver = new MutationObserver(mutations => {
+      for (const mutation of mutations) {
+        for (const node of Array.from(mutation.addedNodes)) {
+          if (!(node instanceof Element)) continue
+          if (node.tagName === 'SCRIPT') {
+            const script = node as HTMLScriptElement
+            if (isSnapshotScript(script)) {
+              parseSnapshotScript(script)
+            }
+          }
+          const nested = node.querySelectorAll?.(
+            'script[type="application/json"][data-fict-snapshot]',
+          )
+          if (nested && nested.length) {
+            for (const script of Array.from(nested)) {
+              parseSnapshotScript(script as HTMLScriptElement)
+            }
+          }
+        }
+      }
+    })
+    snapshotObserver.observe(doc.documentElement ?? doc, { childList: true, subtree: true })
+  }
+
   __fictEnableResumable()
 
   const events = options.events ?? Array.from(DelegatedEvents)
@@ -174,6 +215,23 @@ export function installResumableLoader(options: ResumableLoaderOptions = {}): vo
   }
 }
 
+function isSnapshotScript(script: HTMLScriptElement): boolean {
+  return script.type === 'application/json' && script.hasAttribute('data-fict-snapshot')
+}
+
+function parseSnapshotScript(script: HTMLScriptElement): void {
+  if (processedSnapshots.has(script)) return
+  processedSnapshots.add(script)
+  const text = script.textContent
+  if (!text) return
+  try {
+    const state = JSON.parse(text)
+    __fictMergeSSRState(state)
+  } catch {
+    // Ignore parse errors
+  }
+}
+
 // ============================================================================
 // Prefetch Implementation
 // ============================================================================

package/src/resume.ts

@@ -1,5 +1,6 @@
 import type { HookContext } from './hooks'
 import { createSignal, isSignal } from './signal'
+import { __fictGetCurrentSSRBoundary } from './ssr-stream'
 import { createStore, isStoreProxy, unwrapStore } from './store'
 
 // ============================================================================
@@ -43,6 +44,7 @@ export interface ScopeRecord {
   id: string
   ctx: HookContext
   host: Element
+  boundaryId?: string
   type?: string
   props?: Record<string, unknown>
 }
@@ -52,6 +54,7 @@ let resumableEnabled = false
 let hydrating = false
 let scopeCounter = 0
 let scopeRegistry = new Map<string, ScopeRecord>()
+let boundaryScopes = new Map<string, Set<string>>()
 let snapshotState: SSRState | null = null
 const resumedScopes = new Map<
   string,
@@ -62,12 +65,14 @@ export function __fictEnableSSR(): void {
   ssrEnabled = true
   scopeCounter = 0
   scopeRegistry = new Map()
+  boundaryScopes = new Map()
   resumedScopes.clear()
   snapshotState = null
 }
 
 export function __fictDisableSSR(): void {
   ssrEnabled = false
+  boundaryScopes = new Map()
 }
 
 export function __fictEnableResumable(): void {
@@ -124,6 +129,16 @@ export function __fictRegisterScope(
   if (props !== undefined) {
     record.props = props
   }
+  const boundaryId = __fictGetCurrentSSRBoundary()
+  if (boundaryId) {
+    record.boundaryId = boundaryId
+    let scopes = boundaryScopes.get(boundaryId)
+    if (!scopes) {
+      scopes = new Set()
+      boundaryScopes.set(boundaryId, scopes)
+    }
+    scopes.add(id)
+  }
   scopeRegistry.set(id, record)
   return id
 }
@@ -132,6 +147,12 @@ export function __fictGetScopeRegistry(): Map<string, ScopeRecord> {
   return scopeRegistry
 }
 
+export function __fictGetScopesForBoundary(boundaryId: string): string[] {
+  const scopes = boundaryScopes.get(boundaryId)
+  if (!scopes) return []
+  return Array.from(scopes)
+}
+
 export function __fictSerializeSSRState(): SSRState {
   const scopes: Record<string, ScopeSnapshot> = {}
 
@@ -155,6 +176,31 @@ export function __fictSerializeSSRState(): SSRState {
   return { scopes }
 }
 
+export function __fictSerializeSSRStateForScopes(scopeIds: Iterable<string>): SSRState {
+  const scopes: Record<string, ScopeSnapshot> = {}
+
+  for (const id of scopeIds) {
+    const record = scopeRegistry.get(id)
+    if (!record) continue
+    const snapshot: ScopeSnapshot = {
+      id,
+      slots: serializeSlots(record.ctx),
+    }
+    if (record.type !== undefined) {
+      snapshot.t = record.type
+    }
+    if (record.props !== undefined) {
+      snapshot.props = record.props
+    }
+    if (record.ctx.slotMap !== undefined) {
+      snapshot.vars = record.ctx.slotMap
+    }
+    scopes[id] = snapshot
+  }
+
+  return { scopes }
+}
+
 export function __fictSetSSRState(state: SSRState | null): void {
   snapshotState = state
   if (!state) {
@@ -162,6 +208,15 @@ export function __fictSetSSRState(state: SSRState | null): void {
   }
 }
 
+export function __fictMergeSSRState(state: SSRState | null): void {
+  if (!state) return
+  if (!snapshotState) {
+    snapshotState = { scopes: { ...state.scopes } }
+    return
+  }
+  Object.assign(snapshotState.scopes, state.scopes)
+}
+
 export function __fictGetSSRScope(id: string): ScopeSnapshot | undefined {
   return snapshotState?.scopes[id]
 }

package/src/ssr-stream.ts

@@ -0,0 +1,38 @@
+export interface SSRStreamHooks {
+  registerBoundary?: (start: Comment, end: Comment) => string | null
+  boundaryPending?: (id: string) => void
+  boundaryResolved?: (id: string) => void
+  onError?: (error: unknown, boundaryId?: string) => void
+}
+
+let ssrStreamHooks: SSRStreamHooks | null = null
+const boundaryStack: string[] = []
+
+export function __fictSetSSRStreamHooks(hooks: SSRStreamHooks | null): void {
+  ssrStreamHooks = hooks
+  if (!hooks) {
+    boundaryStack.length = 0
+  }
+}
+
+export function __fictGetSSRStreamHooks(): SSRStreamHooks | null {
+  return ssrStreamHooks
+}
+
+export function __fictPushSSRBoundary(id: string): void {
+  boundaryStack.push(id)
+}
+
+export function __fictPopSSRBoundary(expected?: string): void {
+  if (boundaryStack.length === 0) return
+  const top = boundaryStack[boundaryStack.length - 1]
+  if (expected && top !== expected) {
+    boundaryStack.pop()
+    return
+  }
+  boundaryStack.pop()
+}
+
+export function __fictGetCurrentSSRBoundary(): string | null {
+  return boundaryStack.length > 0 ? boundaryStack[boundaryStack.length - 1]! : null
+}

package/src/suspense.ts

@@ -12,6 +12,7 @@ import {
 } from './lifecycle'
 import { insertNodesBefore, removeNodes, toNodeArray } from './node-ops'
 import { createSignal } from './signal'
+import { __fictGetSSRStreamHooks, __fictPopSSRBoundary, __fictPushSSRBoundary } from './ssr-stream'
 import type { BaseProps, FictNode, SuspenseToken } from './types'
 
 export interface SuspenseProps extends BaseProps {
@@ -49,6 +50,7 @@ const isThenable = (value: unknown): value is PromiseLike<unknown> =>
   typeof (value as PromiseLike<unknown>).then === 'function'
 
 export function Suspense(props: SuspenseProps): FictNode {
+  const streamHooks = __fictGetSSRStreamHooks()
   const pending = createSignal(0)
   let resolvedOnce = false
   let epoch = 0
@@ -76,7 +78,12 @@ export function Suspense(props: SuspenseProps): FictNode {
     const root = createRootContext(hostRoot)
     const prev = pushRoot(root)
     let nodes: Node[] = []
+    let boundaryPushed = false
     try {
+      if (streamBoundaryId) {
+        __fictPushSSRBoundary(streamBoundaryId)
+        boundaryPushed = true
+      }
       const output = createElement(view)
       nodes = toNodeArray(output)
       // Suspended view: child threw a suspense token and was handled upstream.
@@ -90,9 +97,9 @@ export function Suspense(props: SuspenseProps): FictNode {
         destroyRoot(root)
         return
       }
-      const parentNode = marker.parentNode as (ParentNode & Node) | null
+      const parentNode = endMarker.parentNode as (ParentNode & Node) | null
       if (parentNode) {
-        insertNodesBefore(parentNode, nodes, marker)
+        insertNodesBefore(parentNode, nodes, endMarker)
       }
     } catch (err) {
       popRoot(prev)
@@ -101,6 +108,10 @@ export function Suspense(props: SuspenseProps): FictNode {
         throw err
       }
       return
+    } finally {
+      if (boundaryPushed) {
+        __fictPopSSRBoundary(streamBoundaryId ?? undefined)
+      }
     }
     popRoot(prev)
     flushOnMount(root)
@@ -113,10 +124,22 @@ export function Suspense(props: SuspenseProps): FictNode {
   }
 
   const fragment = document.createDocumentFragment()
-  const marker = document.createComment('fict:suspense')
-  fragment.appendChild(marker)
+  const startMarker = document.createComment('fict:suspense-start')
+  const endMarker = document.createComment('fict:suspense-end')
+  fragment.appendChild(startMarker)
+  fragment.appendChild(endMarker)
   let cleanup: (() => void) | undefined
   let activeNodes: Node[] = []
+  let streamBoundaryId: string | null = null
+  let streamPending = false
+
+  if (streamHooks?.registerBoundary) {
+    streamBoundaryId = streamHooks.registerBoundary(startMarker, endMarker) ?? null
+    if (streamBoundaryId) {
+      startMarker.data = `fict:suspense-start:${streamBoundaryId}`
+      endMarker.data = `fict:suspense-end:${streamBoundaryId}`
+    }
+  }
 
   const onResolveMaybe = () => {
     if (!resolvedOnce) {
@@ -127,6 +150,10 @@ export function Suspense(props: SuspenseProps): FictNode {
 
   registerSuspenseHandler(token => {
     const tokenEpoch = epoch
+    if (!streamPending && streamBoundaryId && streamHooks?.boundaryPending) {
+      streamPending = true
+      streamHooks.boundaryPending(streamBoundaryId)
+    }
     pending(pending() + 1)
     // Directly render fallback instead of using switchView to avoid
     // triggering the effect which would cause duplicate renders
@@ -155,6 +182,10 @@ export function Suspense(props: SuspenseProps): FictNode {
           if (newPending === 0) {
             // Directly render children instead of using switchView
             renderView(props.children ?? null)
+            if (streamPending && streamBoundaryId && streamHooks?.boundaryResolved) {
+              streamPending = false
+              streamHooks.boundaryResolved(streamBoundaryId)
+            }
             onResolveMaybe()
           }
         },
@@ -165,9 +196,29 @@ export function Suspense(props: SuspenseProps): FictNode {
           }
           const newPending = Math.max(0, pending() - 1)
           pending(newPending)
-          props.onReject?.(err)
-          if (!handleError(err, { source: 'render' }, hostRoot)) {
-            throw err
+          let rejectionError = err
+          try {
+            props.onReject?.(err)
+          } catch (callbackError) {
+            rejectionError = callbackError
+          }
+
+          const handled = handleError(rejectionError, { source: 'render' }, hostRoot)
+          if (!handled) {
+            if (streamHooks?.onError) {
+              streamHooks.onError(rejectionError, streamBoundaryId ?? undefined)
+              return
+            }
+            throw rejectionError
+          }
+          if (
+            newPending === 0 &&
+            streamPending &&
+            streamBoundaryId &&
+            streamHooks?.boundaryResolved
+          ) {
+            streamPending = false
+            streamHooks.boundaryResolved(streamBoundaryId)
           }
         },
       )
@@ -195,6 +246,10 @@ export function Suspense(props: SuspenseProps): FictNode {
         pending(0)
         // Directly render children instead of using switchView
         renderView(props.children ?? null)
+        if (streamPending && streamBoundaryId && streamHooks?.boundaryResolved) {
+          streamPending = false
+          streamHooks.boundaryResolved(streamBoundaryId)
+        }
       }
     })
   }