@askrjs/askr 0.0.30 → 0.0.31

package/dist/runtime/component.d.ts

@@ -38,6 +38,11 @@ interface ComponentInstance {
     key: string | number;
     dispose(): void;
   }>;
+  errorBoundaryState?: {
+    error: unknown | null;
+    resetKey: unknown;
+    notified: boolean;
+  };
 }
 declare function createComponentInstance(id: string, fn: ComponentFunction, props: Props, target: Element | null): ComponentInstance;
 type OwnedChildScope = {

package/dist/runtime/component.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"component.d.ts","names":[],"sources":["../../src/runtime/component.ts"],"mappings":";;;;;;;UA4BiB,iBAAA;EACf,EAAA;EACA,EAAA,EAAI,iBAAA;EACJ,KAAA,EAAO,KAAA;EACP,MAAA,EAAQ,OAAA;EACR,OAAA;EACA,eAAA,EAAiB,eAAA;EACjB,GAAA;EAEA,aAAA;EACA,WAAA,EAAa,KAAA;EACb,oBAAA;EACA,YAAA;EAEA,iBAAA;EACA,eAAA;EACA,WAAA;EACA,eAAA;EACA,oBAAA;EACA,mBAAA;EACA,eAAA,EAAiB,KAAA,6BACa,OAAA;EAE9B,UAAA,EAAY,KAAA;EACZ,gBAAA;EACA,UAAA,EAAY,YAAA;EACZ,MAAA;EAGA,mBAAA;EACA,eAAA;EACA,mBAAA,GAAsB,GAAA,CAAI,cAAA;EAC1B,gBAAA,GAAmB,GAAA,CAAI,cAAA;EACvB,kBAAA,GAAqB,GAAA;EAIrB,YAAA,GAAe,OAAA;EACf,iBAAA,GAAoB,GAAA;IAClB,GAAA;IACA,OAAA;EAAA;AAAA;AAAA,iBAIY,uBAAA,CACd,EAAA,UACA,EAAA,EAAI,iBAAA,EACJ,KAAA,EAAO,KAAA,EACP,MAAA,EAAQ,OAAA,UACP,iBAAA;AAAA,KA4DE,eAAA;EACH,GAAA;EACA,OAAA;AAAA;AAAA,iBAac,2BAAA,CAAA,GAA+B,iBAAA;AAAA,iBAK/B,2BAAA,CACd,QAAA,EAAU,iBAAA;AAAA,iBAYI,sBAAA,CACd,SAAA,8BAAuC,OAAA;AAAA,iBAkDzB,mBAAA,CACd,QAAA,EAAU,iBAAA,EACV,MAAA,EAAQ,OAAA;AAAA,iBA0DM,qBAAA,GAAA,CACd,QAAA,EAAU,iBAAA,EACV,eAAA,UACA,MAAA,QAAc,CAAA,GACb,CAAA;;;;;;iBAsPa,qBAAA,CACd,QAAA,EAAU,iBAAA,aACC,OAAA;AAAA,iBA8BG,oBAAA,CAAqB,QAAA,EAAU,iBAAA;;;;;;iBAyF/B,gBAAA,CAAiB,QAAA,EAAU,iBAAA;AAAA,iBAW3B,kBAAA,CAAA,GAAsB,iBAAA;;;;;;;;;;AA/kBtC;;;;;;;;;;;;;;;;;;;AA4DC;;;;;AAoBD;;;;;AAKA;;;iBAuiBgB,SAAA,CAAA,GAAa,WAAA;;AA1hB7B;;;;;AAmDA;;iBAyfgB,yBAAA,CAA0B,QAAA,EAAU,iBAAA;AAAA,iBAIpC,iBAAA,CAAA;AAAA,iBAIA,cAAA,CACd,QAAA,EAAU,iBAAA,EACV,QAAA;AAAA,iBAgCc,oBAAA,CAAA;AAAA,iBAIA,eAAA,CAAA;AAAA,iBAIA,aAAA,CAAc,KAAA;;;AA/e9B;;;iBAwfgB,cAAA,CAAe,QAAA,EAAU,iBAAA;;;;;iBAQzB,gBAAA,CAAiB,QAAA,EAAU,iBAAA;AAAA,iBAuD3B,uBAAA,CACd,QAAA,EAAU,iBAAA,EACV,KAAA,EAAO,eAAA;AAAA,iBAMO,yBAAA,CACd,QAAA,EAAU,iBAAA,EACV,KAAA,EAAO,eAAA"}
+{"version":3,"file":"component.d.ts","names":[],"sources":["../../src/runtime/component.ts"],"mappings":";;;;;;;UA4BiB,iBAAA;EACf,EAAA;EACA,EAAA,EAAI,iBAAA;EACJ,KAAA,EAAO,KAAA;EACP,MAAA,EAAQ,OAAA;EACR,OAAA;EACA,eAAA,EAAiB,eAAA;EACjB,GAAA;EAEA,aAAA;EACA,WAAA,EAAa,KAAA;EACb,oBAAA;EACA,YAAA;EAEA,iBAAA;EACA,eAAA;EACA,WAAA;EACA,eAAA;EACA,oBAAA;EACA,mBAAA;EACA,eAAA,EAAiB,KAAA,6BACa,OAAA;EAE9B,UAAA,EAAY,KAAA;EACZ,gBAAA;EACA,UAAA,EAAY,YAAA;EACZ,MAAA;EAGA,mBAAA;EACA,eAAA;EACA,mBAAA,GAAsB,GAAA,CAAI,cAAA;EAC1B,gBAAA,GAAmB,GAAA,CAAI,cAAA;EACvB,kBAAA,GAAqB,GAAA;EAIrB,YAAA,GAAe,OAAA;EACf,iBAAA,GAAoB,GAAA;IAClB,GAAA;IACA,OAAA;EAAA;EAEF,kBAAA;IACE,KAAA;IACA,QAAA;IACA,QAAA;EAAA;AAAA;AAAA,iBAIY,uBAAA,CACd,EAAA,UACA,EAAA,EAAI,iBAAA,EACJ,KAAA,EAAO,KAAA,EACP,MAAA,EAAQ,OAAA,UACP,iBAAA;AAAA,KA4DE,eAAA;EACH,GAAA;EACA,OAAA;AAAA;AAAA,iBAac,2BAAA,CAAA,GAA+B,iBAAA;AAAA,iBAK/B,2BAAA,CACd,QAAA,EAAU,iBAAA;AAAA,iBAYI,sBAAA,CACd,SAAA,8BAAuC,OAAA;AAAA,iBAkDzB,mBAAA,CACd,QAAA,EAAU,iBAAA,EACV,MAAA,EAAQ,OAAA;AAAA,iBA0DM,qBAAA,GAAA,CACd,QAAA,EAAU,iBAAA,EACV,eAAA,UACA,MAAA,QAAc,CAAA,GACb,CAAA;;;;;;iBAsPa,qBAAA,CACd,QAAA,EAAU,iBAAA,aACC,OAAA;AAAA,iBA8BG,oBAAA,CAAqB,QAAA,EAAU,iBAAA;;;;;;iBAyF/B,gBAAA,CAAiB,QAAA,EAAU,iBAAA;AAAA,iBAW3B,kBAAA,CAAA,GAAsB,iBAAA;;;;;;;;;AA/kBtC;;;;;;;;;;;;;;;;;;;AA4DC;;;;;AAoBD;;;;;AAKA;;;;iBAuiBgB,SAAA,CAAA,GAAa,WAAA;AA1hB7B;;;;;AAmDA;;;AAnDA,iBA4iBgB,yBAAA,CAA0B,QAAA,EAAU,iBAAA;AAAA,iBAIpC,iBAAA,CAAA;AAAA,iBAIA,cAAA,CACd,QAAA,EAAU,iBAAA,EACV,QAAA;AAAA,iBAgCc,oBAAA,CAAA;AAAA,iBAIA,eAAA,CAAA;AAAA,iBAIA,aAAA,CAAc,KAAA;;AA/e9B;;;;iBAwfgB,cAAA,CAAe,QAAA,EAAU,iBAAA;;;;;iBAQzB,gBAAA,CAAiB,QAAA,EAAU,iBAAA;AAAA,iBAuD3B,uBAAA,CACd,QAAA,EAAU,iBAAA,EACV,KAAA,EAAO,eAAA;AAAA,iBAMO,yBAAA,CACd,QAAA,EAAU,iBAAA,EACV,KAAA,EAAO,eAAA"}

package/dist/runtime/component.js.map

@@ -1 +1 @@
-{"version":3,"file":"component.js","names":[],"sources":["../../src/runtime/component.ts"],"sourcesContent":["/**\n * Component instance lifecycle management\n * Internal only — users never see this\n */\n\nimport { type State } from './state';\nimport { globalScheduler } from './scheduler';\nimport type { Props } from '../common/props';\nimport type { ComponentFunction } from '../common/component';\nimport {\n  // withContext is the sole primitive for context restoration\n  withContext,\n  type ContextFrame,\n} from './context';\nimport {\n  type ReadableSource,\n  finalizeReadableSubscriptions,\n  cleanupReadableSubscriptions,\n} from './readable';\nimport {\n  isDevelopmentEnvironment,\n  isProductionEnvironment,\n} from '../common/env';\nimport { logger } from '../dev/logger';\nimport { incDevCounter, setDevValue } from './dev-namespace';\n\nexport type { ComponentFunction } from '../common/component';\n\nexport interface ComponentInstance {\n  id: string;\n  fn: ComponentFunction;\n  props: Props;\n  target: Element | null;\n  mounted: boolean;\n  abortController: AbortController | null; // Lazily created per-component abort lifecycle\n  ssr?: boolean; // Set to true for SSR temporary instances\n  // Opt-in strict cleanup mode: when true cleanup errors are aggregated and re-thrown\n  cleanupStrict?: boolean;\n  stateValues: State<unknown>[]; // Persistent state storage across renders\n  evaluationGeneration: number; // Prevents stale async evaluation completions\n  notifyUpdate: (() => void) | null; // Callback for state updates (persisted on instance)\n  // Internal: prebound helpers to avoid per-update closures (allocation hot-path)\n  _pendingFlushTask?: () => void; // Clears hasPendingUpdate and triggers notifyUpdate\n  _pendingRunTask?: () => void; // Clears hasPendingUpdate and runs component\n  _enqueueRun?: () => void; // Batches run requests and enqueues _pendingRunTask\n  stateIndexCheck: number; // Track state indices to catch conditional calls\n  expectedStateIndices: number[]; // Expected sequence of render-scoped hook indices (frozen after first render)\n  firstRenderComplete: boolean; // Flag to detect transition from first to subsequent renders\n  mountOperations: Array<\n    () => void | (() => void) | Promise<void | (() => void)>\n  >; // Operations to run when component mounts\n  cleanupFns: Array<() => void>; // Cleanup functions to run on unmount\n  hasPendingUpdate: boolean; // Flag to batch state updates (coalescing)\n  ownerFrame: ContextFrame | null; // Provider chain for this component (set by Scope, never overwritten)\n  isRoot?: boolean;\n\n  // Render-tracking for precise subscriptions (internal)\n  _currentRenderToken?: number; // Token for the in-progress render (set before render)\n  lastRenderToken?: number; // Token of the last *committed* render\n  _pendingReadSources?: Set<ReadableSource<unknown>>; // Readables read during the in-progress render\n  _lastReadSources?: Set<ReadableSource<unknown>>; // Readables read during the last committed render\n  devWarningsEmitted?: Set<string>; // Dev-only warning dedupe for this instance\n\n  // Placeholder for null-returning components. When a component initially returns\n  // null, we create a comment placeholder so updates can replace it with content.\n  _placeholder?: Comment;\n  _ownedChildScopes?: Set<{\n    key: string | number;\n    dispose(): void;\n  }>;\n}\n\nexport function createComponentInstance(\n  id: string,\n  fn: ComponentFunction,\n  props: Props,\n  target: Element | null\n): ComponentInstance {\n  const instance: ComponentInstance = {\n    id,\n    fn,\n    props,\n    target,\n    mounted: false,\n    abortController: null,\n    stateValues: [],\n    evaluationGeneration: 0,\n    notifyUpdate: null,\n    // Prebound helpers (initialized below) to avoid per-update allocations\n    _pendingFlushTask: undefined,\n    _pendingRunTask: undefined,\n    _enqueueRun: undefined,\n    stateIndexCheck: -1,\n    expectedStateIndices: [],\n    firstRenderComplete: false,\n    mountOperations: [],\n    cleanupFns: [],\n    hasPendingUpdate: false,\n    ownerFrame: null, // Will be set by renderer when vnode is marked\n    ssr: false,\n    cleanupStrict: false,\n    isRoot: false,\n\n    // Render-tracking (for precise state subscriptions)\n    _currentRenderToken: undefined,\n    lastRenderToken: 0,\n    _pendingReadSources: undefined,\n    _lastReadSources: undefined,\n    devWarningsEmitted: undefined,\n  };\n\n  // Initialize prebound helper tasks once per instance to avoid allocations\n  instance._pendingRunTask = () => {\n    // Clear pending flag when the run task executes\n    instance.hasPendingUpdate = false;\n    // Execute component run (will set up notifyUpdate before render)\n    runComponent(instance);\n  };\n\n  instance._enqueueRun = () => {\n    if (!instance.hasPendingUpdate) {\n      instance.hasPendingUpdate = true;\n      // Enqueue single run task (coalesces multiple writes)\n      globalScheduler.enqueue(instance._pendingRunTask!);\n    }\n  };\n\n  // Default state-driven updates enqueue the run task directly. Specialized\n  // runtimes (for example `For` item instances) can still override this hook.\n  instance._pendingFlushTask = instance._pendingRunTask;\n\n  return instance;\n}\n\nlet currentInstance: ComponentInstance | null = null;\nlet stateIndex = 0;\n\ntype OwnedChildScope = {\n  key: string | number;\n  dispose(): void;\n};\n\nfunction ensureAbortController(instance: ComponentInstance): AbortController {\n  let controller = instance.abortController;\n  if (!controller || controller.signal.aborted) {\n    controller = new AbortController();\n    instance.abortController = controller;\n  }\n  return controller;\n}\n\n// Export for state.ts to access\nexport function getCurrentComponentInstance(): ComponentInstance | null {\n  return currentInstance;\n}\n\n// Export for SSR to set temporary instance\nexport function setCurrentComponentInstance(\n  instance: ComponentInstance | null\n): void {\n  currentInstance = instance;\n}\n\n/**\n * Register a mount operation that will run after the component is mounted\n * Used by operations (task, on, timer, etc) to execute after render completes\n */\nimport { isBulkCommitActive } from './fastlane';\nimport { evaluate, cleanupInstancesUnder } from '../renderer';\n\nexport function registerMountOperation(\n  operation: () => void | (() => void) | Promise<void | (() => void)>\n): void {\n  const instance = getCurrentComponentInstance();\n  if (instance) {\n    // If we're in bulk-commit fast lane, registering mount operations is a\n    // violation of the fast-lane preconditions. Throw in dev, otherwise ignore\n    // silently in production (we must avoid scheduling work during bulk commit).\n    if (isBulkCommitActive()) {\n      if (isDevelopmentEnvironment()) {\n        throw new Error(\n          'registerMountOperation called during bulk commit fast-lane'\n        );\n      }\n      return;\n    }\n    instance.mountOperations.push(operation);\n  }\n}\n\n/**\n * Execute all mount operations for a component\n * These run after the component is rendered and mounted to the DOM\n */\nfunction executeMountOperations(instance: ComponentInstance): void {\n  // Only execute mount operations for root app instance. Child component\n  // operations are currently registered but should not be executed (per\n  // contract tests). They remain registered for cleanup purposes.\n  if (!instance.isRoot) return;\n\n  const mountOperations = instance.mountOperations;\n  if (mountOperations.length === 0) {\n    return;\n  }\n\n  for (const operation of mountOperations) {\n    const result = operation();\n    if (result instanceof Promise) {\n      result.then((cleanup) => {\n        if (typeof cleanup === 'function') {\n          instance.cleanupFns.push(cleanup);\n        }\n      });\n    } else if (typeof result === 'function') {\n      instance.cleanupFns.push(result);\n    }\n  }\n  // Clear the operations array so they don't run again on subsequent renders\n  instance.mountOperations = [];\n}\n\nexport function mountInstanceInline(\n  instance: ComponentInstance,\n  target: Element | null\n): void {\n  instance.target = target;\n  // Record backref on host element so renderer can clean up when the\n  // node is removed. Avoids leaks if the node is detached or replaced.\n  try {\n    if (target instanceof Element) {\n      const host = target as Element & {\n        __ASKR_INSTANCE?: ComponentInstance;\n        __ASKR_INSTANCES?: ComponentInstance[];\n      };\n      const instances = host.__ASKR_INSTANCES ?? [];\n      const nextInstances = instances.filter((entry) => entry !== instance);\n      nextInstances.push(instance);\n      host.__ASKR_INSTANCES = nextInstances;\n      host.__ASKR_INSTANCE = nextInstances[0] ?? instance;\n    }\n  } catch (err) {\n    void err;\n  }\n\n  // Ensure notifyUpdate is available for async resource completions that may\n  // try to trigger re-render. This mirrors the setup in executeComponent().\n  // Use prebound enqueue helper to avoid allocating a new closure\n  instance.notifyUpdate = instance._enqueueRun!;\n\n  const wasFirstMount = !instance.mounted;\n  instance.mounted = true;\n  if (wasFirstMount && instance.mountOperations.length > 0) {\n    executeMountOperations(instance);\n  }\n}\n\n/**\n * Run a component synchronously: execute function, handle result\n * This is the internal workhorse that manages async continuations and generation tracking.\n * Must always be called through the scheduler.\n *\n * ACTOR INVARIANT: This function is enqueued as a task, never called directly.\n */\nlet _globalRenderCounter = 0;\n\nfunction resetRenderState(instance: ComponentInstance): void {\n  instance.stateIndexCheck = -1;\n\n  for (const state of instance.stateValues) {\n    if (state) {\n      state._hasBeenRead = false;\n    }\n  }\n\n  instance._pendingReadSources = undefined;\n}\n\nfunction nextRenderToken(): number {\n  return ++_globalRenderCounter;\n}\n\nexport function renderScopedComponent<T>(\n  instance: ComponentInstance,\n  startStateIndex: number,\n  render: () => T\n): T {\n  const savedInstance = currentInstance;\n  const savedStateIndex = stateIndex;\n\n  instance.notifyUpdate = instance._enqueueRun!;\n  resetRenderState(instance);\n  instance._currentRenderToken = nextRenderToken();\n\n  currentInstance = instance;\n  stateIndex = startStateIndex;\n\n  let didComplete = false;\n\n  try {\n    const executionFrame: ContextFrame = {\n      parent: instance.ownerFrame,\n      values: null,\n    };\n    const result = withContext(executionFrame, render);\n    didComplete = true;\n    return result;\n  } finally {\n    if (!didComplete) {\n      instance._pendingReadSources = undefined;\n      instance._currentRenderToken = undefined;\n    }\n    currentInstance = savedInstance;\n    stateIndex = savedStateIndex;\n  }\n}\n\nfunction runComponent(instance: ComponentInstance): void {\n  // CRITICAL: Ensure notifyUpdate is available for state.set() calls during this render.\n  // This must be set before executeComponentSync() runs, not after.\n  // Use prebound enqueue helper to avoid allocating per-render closures\n  instance.notifyUpdate = instance._enqueueRun!;\n\n  // Assign a token for this in-progress render and start a fresh pending-read set\n  instance._currentRenderToken = nextRenderToken();\n  instance._pendingReadSources = undefined;\n  const domSnapshot = instance.target ? instance.target.innerHTML : '';\n\n  const result = executeComponentSync(instance);\n  if (result instanceof Promise) {\n    // Async components are not supported. Components must be synchronous and\n    // must not return a Promise from their render function.\n    throw new Error(\n      'Async components are not supported. Components must be synchronous.'\n    );\n  } else {\n    // Try runtime fast-lane synchronously; if it activates we do not enqueue\n    // follow-up work and the commit happens atomically in this task.\n    // (Runtime fast-lane has conservative preconditions.)\n    const fastlaneBridge = (\n      globalThis as {\n        __ASKR_FASTLANE?: {\n          tryRuntimeFastLaneSync?: (\n            instance: unknown,\n            result: unknown\n          ) => boolean;\n        };\n      }\n    ).__ASKR_FASTLANE;\n    try {\n      const used = fastlaneBridge?.tryRuntimeFastLaneSync?.(instance, result);\n      if (used) {\n        warnUnusedStateReads(instance);\n        return;\n      }\n    } catch (err) {\n      // If invariant check failed in dev, surface the error; otherwise fall back\n      if (isDevelopmentEnvironment()) throw err;\n    }\n\n    // Fallback: enqueue the render/commit normally\n    globalScheduler.enqueue(() => {\n      // Handle placeholder-based updates: when a component initially returned null,\n      // we created a comment placeholder. If it now has content, we need to create\n      // a host element and replace the placeholder.\n      if (!instance.target && instance._placeholder) {\n        // Component previously returned null (has placeholder), check if now has content\n        if (result === null || result === undefined) {\n          // Still null - nothing to do, keep placeholder\n          finalizeReadSubscriptions(instance);\n          warnUnusedStateReads(instance);\n          return;\n        }\n\n        // Has content now - need to create DOM and replace placeholder\n        const placeholder = instance._placeholder;\n        const parent = placeholder.parentNode;\n        if (!parent) {\n          // Placeholder was removed from DOM - can't render\n          logger.warn(\n            '[Askr] placeholder no longer in DOM, cannot render component'\n          );\n          return;\n        }\n\n        // Create a new host element for the content\n        const host = document.createElement('div');\n        const executionFrame: ContextFrame = {\n          parent: instance.ownerFrame,\n          values: null,\n        };\n\n        // Set up instance for normal updates\n        const oldInstance = currentInstance;\n        currentInstance = instance;\n        try {\n          withContext(executionFrame, () => {\n            evaluate(result, host);\n          });\n\n          // Replace placeholder with host\n          parent.replaceChild(host, placeholder);\n\n          // Set up instance for future updates\n          instance.target = host;\n          instance._placeholder = undefined;\n          (\n            host as Element & { __ASKR_INSTANCE?: ComponentInstance }\n          ).__ASKR_INSTANCE = instance;\n\n          finalizeReadSubscriptions(instance);\n          warnUnusedStateReads(instance);\n        } finally {\n          currentInstance = oldInstance;\n        }\n        return;\n      }\n\n      if (instance.target) {\n        let oldChildren: Node[] = [];\n        try {\n          const wasFirstMount = !instance.mounted;\n          // Ensure nested component executions during evaluation have access to\n          // the current component instance. This allows nested components to\n          // call `state()`, `resource()`, and other runtime helpers which\n          // rely on `getCurrentComponentInstance()` being available.\n          const oldInstance = currentInstance;\n          currentInstance = instance;\n          const executionFrame: ContextFrame = {\n            parent: instance.ownerFrame,\n            values: null,\n          };\n          // Capture snapshot of current children (by reference) so we can\n          // restore them on render failure without losing event listeners or\n          // instance attachments.\n          oldChildren = Array.from(instance.target.childNodes);\n\n          try {\n            withContext(executionFrame, () => {\n              evaluate(result, instance.target);\n            });\n          } catch (e) {\n            // If evaluation failed, attempt to cleanup any partially-added nodes\n            // and restore the old children to preserve listeners and instances.\n            try {\n              const newChildren = Array.from(instance.target.childNodes);\n              for (const n of newChildren) {\n                try {\n                  cleanupInstancesUnder(n);\n                } catch (err) {\n                  logger.warn(\n                    '[Askr] error cleaning up failed commit children:',\n                    err\n                  );\n                }\n              }\n            } catch (_err) {\n              void _err;\n            }\n\n            // Restore original children by re-inserting the old node references\n            // this preserves attached listeners and instance backrefs.\n            try {\n              incDevCounter('__DOM_REPLACE_COUNT');\n              setDevValue(\n                '__LAST_DOM_REPLACE_STACK_COMPONENT_RESTORE',\n                new Error().stack\n              );\n            } catch (e) {\n              void e;\n            }\n            instance.target.replaceChildren(...oldChildren);\n            throw e;\n          } finally {\n            currentInstance = oldInstance;\n          }\n\n          // Commit succeeded — finalize recorded state reads so subscriptions reflect\n          // the last *committed* render. This updates per-state reader maps\n          // deterministically and synchronously with the commit.\n          finalizeReadSubscriptions(instance);\n          warnUnusedStateReads(instance);\n\n          instance.mounted = true;\n          // Execute mount operations after first mount (do NOT run these with\n          // currentInstance set - they may perform state mutations/registrations)\n          if (wasFirstMount && instance.mountOperations.length > 0) {\n            executeMountOperations(instance);\n          }\n        } catch (renderError) {\n          // Atomic rendering: rollback on render error. Attempt non-lossy restore of\n          // original child node references to preserve listeners/instances.\n          try {\n            const currentChildren = Array.from(instance.target.childNodes);\n            for (const n of currentChildren) {\n              try {\n                cleanupInstancesUnder(n);\n              } catch (err) {\n                logger.warn(\n                  '[Askr] error cleaning up partial children during rollback:',\n                  err\n                );\n              }\n            }\n          } catch (_err) {\n            void _err;\n          }\n\n          try {\n            incDevCounter('__DOM_REPLACE_COUNT');\n            setDevValue(\n              '__LAST_DOM_REPLACE_STACK_COMPONENT_ROLLBACK',\n              new Error().stack\n            );\n            instance.target.replaceChildren(...oldChildren);\n          } catch {\n            // Fallback to innerHTML restore if replaceChildren fails for some reason.\n            instance.target.innerHTML = domSnapshot;\n          }\n\n          throw renderError;\n        }\n      }\n    });\n  }\n}\n\n/**\n * Execute a component's render function synchronously.\n * Returns either a vnode/promise immediately (does NOT render).\n * Rendering happens separately through runComponent.\n */\nexport function renderComponentInline(\n  instance: ComponentInstance\n): unknown | Promise<unknown> {\n  // Ensure inline executions (rendered during parent's evaluate) still\n  // receive a render token and have their state reads finalized so\n  // subscriptions are correctly recorded. If this function is called\n  // as part of a scheduled run, the token will already be set by\n  // runComponent and we should not overwrite it.\n  const hadToken = instance._currentRenderToken !== undefined;\n  const prevToken = instance._currentRenderToken;\n  const prevPendingReads = instance._pendingReadSources;\n  if (!hadToken) {\n    instance._currentRenderToken = nextRenderToken();\n    instance._pendingReadSources = undefined;\n  }\n\n  try {\n    const result = executeComponentSync(instance);\n    // If we set the token for inline execution, finalize subscriptions now\n    // because the component is effectively committed as part of the parent's\n    // synchronous evaluation.\n    if (!hadToken) {\n      finalizeReadSubscriptions(instance);\n    }\n    return result;\n  } finally {\n    // Restore previous token/read states for nested inline render scenarios\n    instance._currentRenderToken = prevToken;\n    instance._pendingReadSources = prevPendingReads;\n  }\n}\n\nexport function warnUnusedStateReads(instance: ComponentInstance): void {\n  for (let i = 0; i < instance.stateValues.length; i++) {\n    const state = instance.stateValues[i];\n    const hasCommittedUsage =\n      (state?._readers?.size ?? 0) > 0 ||\n      ((state as { _derivedSubscribers?: Set<unknown> } | undefined)\n        ?._derivedSubscribers?.size ?? 0) > 0;\n\n    if (state && !state._hasBeenRead && !hasCommittedUsage) {\n      try {\n        const name = instance.fn?.name || '<anonymous>';\n        warnInstanceOnce(\n          instance,\n          `unused-state:${i}`,\n          `[askr] Unused state variable detected in ${name} at index ${i}. State should be read during render or removed.`\n        );\n      } catch {\n        warnInstanceOnce(\n          instance,\n          `unused-state:${i}`,\n          `[askr] Unused state variable detected. State should be read during render or removed.`\n        );\n      }\n    }\n  }\n}\n\nfunction executeComponentSync(\n  instance: ComponentInstance\n): unknown | Promise<unknown> {\n  resetRenderState(instance);\n  incDevCounter('componentRuns');\n  incDevCounter('componentReruns');\n\n  currentInstance = instance;\n  stateIndex = 0;\n\n  try {\n    // Track render time in dev mode\n    const renderStartTime = isDevelopmentEnvironment() ? Date.now() : 0;\n\n    // Create context object with abort signal\n    const context = {\n      get signal(): AbortSignal {\n        return ensureAbortController(instance).signal;\n      },\n    };\n\n    // Execute component within its owner frame (provider chain).\n    // This ensures all context reads see the correct provider values.\n    // We create a new execution frame whose parent is the ownerFrame. The\n    // `values` map is lazily allocated to avoid per-render Map allocations\n    // for components that do not use context.\n    const executionFrame: ContextFrame = {\n      parent: instance.ownerFrame,\n      values: null,\n    };\n    const result = withContext(executionFrame, () =>\n      instance.fn(instance.props, context)\n    );\n\n    // Check render time\n    const renderTime = Date.now() - renderStartTime;\n    if (renderTime > 5) {\n      warnInstanceOnce(\n        instance,\n        'slow-render',\n        `[askr] Slow render detected: ${renderTime}ms. Consider optimizing component performance.`\n      );\n    }\n\n    // Mark first render complete after successful execution\n    // This enables hook order validation on subsequent renders\n    if (!instance.firstRenderComplete) {\n      instance.firstRenderComplete = true;\n    }\n\n    return result;\n  } finally {\n    // Synchronous path: we did not push a fresh frame, so nothing to pop here.\n    currentInstance = null;\n  }\n}\n\n/**\n * Public entry point: Execute component with full lifecycle (execute + render)\n * Handles both initial mount and re-execution. Always enqueues through scheduler.\n * Single entry point to avoid lifecycle divergence.\n */\nexport function executeComponent(instance: ComponentInstance): void {\n  // Lazily recreate abort controller only when signal is actually requested.\n  instance.abortController = null;\n\n  // Setup notifyUpdate callback using prebound helper to avoid per-call closures\n  instance.notifyUpdate = instance._enqueueRun!;\n\n  // Enqueue the initial component run\n  globalScheduler.enqueue(instance._pendingRunTask!);\n}\n\nexport function getCurrentInstance(): ComponentInstance | null {\n  return currentInstance;\n}\n\n/**\n * Get the abort signal for the current component\n * Used to cancel async operations on unmount/navigation\n *\n * The signal is guaranteed to be aborted when:\n * - Component unmounts\n * - Navigation occurs (different route)\n * - Parent is destroyed\n *\n * IMPORTANT: getSignal() must be called during component render execution.\n * It captures the current component instance from context.\n *\n * @returns AbortSignal that will be aborted when component unmounts\n * @throws Error if called outside component execution\n *\n * @example\n * ```ts\n * // ✅ Correct: called during render, used in async operation\n * export async function UserPage({ id }: { id: string }) {\n *   const signal = getSignal();\n *   const user = await fetch(`/api/users/${id}`, { signal });\n *   return <div>{user.name}</div>;\n * }\n *\n * // ✅ Correct: passed to event handler\n * export function Button() {\n *   const signal = getSignal();\n *   return {\n *     type: 'button',\n *     props: {\n *       onClick: async () => {\n *         const data = await fetch(url, { signal });\n *       }\n *     }\n *   };\n * }\n *\n * // ❌ Wrong: called outside component context\n * const signal = getSignal(); // Error: not in component\n * ```\n */\nexport function getSignal(): AbortSignal {\n  if (!currentInstance) {\n    throw new Error(\n      'getSignal() can only be called during component render execution. ' +\n        'Ensure you are calling this from inside your component function.'\n    );\n  }\n  return ensureAbortController(currentInstance).signal;\n}\n\n/**\n * Finalize read subscriptions for an instance after a successful commit.\n * - Update per-state readers map to point to this instance's last committed token\n * - Remove this instance from states it no longer reads\n * This is deterministic and runs synchronously with commit to ensure\n * subscribers are only notified when they actually read a state in their\n * last committed render.\n */\nexport function finalizeReadSubscriptions(instance: ComponentInstance): void {\n  finalizeReadableSubscriptions(instance);\n}\n\nexport function getNextStateIndex(): number {\n  return stateIndex++;\n}\n\nexport function claimHookIndex(\n  instance: ComponentInstance,\n  hookName: string\n): number {\n  const index = getNextStateIndex();\n\n  if (index < instance.stateIndexCheck) {\n    throw new Error(\n      `Hook index violation: ${hookName}() call at index ${index}, ` +\n        `but previously saw index ${instance.stateIndexCheck}. ` +\n        `This happens when render-scoped hooks are called conditionally (inside if/for/etc). ` +\n        `Move all ${hookName}() calls to the top level of your component function, ` +\n        `before any conditionals.`\n    );\n  }\n\n  instance.stateIndexCheck = index;\n\n  if (instance.firstRenderComplete) {\n    if (!instance.expectedStateIndices.includes(index)) {\n      throw new Error(\n        `Hook order violation: ${hookName}() called at index ${index}, ` +\n          `but this index was not in the first render's sequence [${instance.expectedStateIndices.join(', ')}]. ` +\n          `This usually means ${hookName}() is inside a conditional or loop. ` +\n          `Move all render-scoped hooks to the top level of your component function.`\n      );\n    }\n  } else {\n    instance.expectedStateIndices.push(index);\n  }\n\n  return index;\n}\n\nexport function getCurrentStateIndex(): number {\n  return stateIndex;\n}\n\nexport function resetStateIndex(): void {\n  stateIndex = 0;\n}\n\nexport function setStateIndex(value: number): void {\n  stateIndex = value;\n}\n\n/**\n * Mount a component instance.\n * This is just an alias to executeComponent() to maintain API compatibility.\n * All lifecycle logic is unified in executeComponent().\n */\nexport function mountComponent(instance: ComponentInstance): void {\n  executeComponent(instance);\n}\n\n/**\n * Clean up component — abort pending operations\n * Called on unmount or route change\n */\nexport function cleanupComponent(instance: ComponentInstance): void {\n  const ownedChildScopes = instance._ownedChildScopes;\n  if (ownedChildScopes && ownedChildScopes.size > 0) {\n    instance._ownedChildScopes = new Set();\n    for (const scope of ownedChildScopes) {\n      scope.dispose();\n    }\n  }\n\n  // Execute cleanup functions (from mount effects)\n  const cleanupErrors: unknown[] = [];\n  const cleanupFns = instance.cleanupFns;\n  for (const cleanup of cleanupFns) {\n    try {\n      cleanup();\n    } catch (err) {\n      if (instance.cleanupStrict) {\n        cleanupErrors.push(err);\n      } else {\n        // Preserve previous behavior: log warnings in dev and continue\n        if (isDevelopmentEnvironment()) {\n          logger.warn('[Askr] cleanup function threw:', err);\n        }\n      }\n    }\n  }\n  instance.cleanupFns = [];\n  if (cleanupErrors.length > 0) {\n    // If strict mode, surface all cleanup errors as an AggregateError after attempting all cleanups\n    throw new AggregateError(\n      cleanupErrors,\n      `Cleanup failed for component ${instance.id}`\n    );\n  }\n\n  // Remove deterministic state subscriptions for this instance\n  cleanupReadableSubscriptions(instance);\n\n  // Abort all pending operations\n  if (instance.abortController && !instance.abortController.signal.aborted) {\n    instance.abortController.abort();\n  }\n  instance.abortController = null;\n\n  // Clear update callback to prevent dangling references and stale updates\n  instance.notifyUpdate = null;\n  instance._placeholder = undefined;\n\n  // Mark instance as unmounted so external tracking (e.g., portal host lists)\n  // can deterministically prune stale instances. Not marking this leads to\n  // retained \"mounted\" flags across cleanup boundaries which breaks\n  // owner selection in the portal fallback.\n  instance.mounted = false;\n}\n\nexport function registerOwnedChildScope(\n  instance: ComponentInstance,\n  scope: OwnedChildScope\n): void {\n  const scopes = (instance._ownedChildScopes ??= new Set());\n  scopes.add(scope);\n}\n\nexport function unregisterOwnedChildScope(\n  instance: ComponentInstance,\n  scope: OwnedChildScope\n): void {\n  instance._ownedChildScopes?.delete(scope);\n}\n\nfunction warnInstanceOnce(\n  instance: ComponentInstance,\n  key: string,\n  message: string\n): void {\n  if (isProductionEnvironment()) return;\n  const warnings = (instance.devWarningsEmitted ??= new Set());\n  if (warnings.has(key)) return;\n  warnings.add(key);\n  logger.warn(message);\n}\n"],"mappings":"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"}
+{"version":3,"file":"component.js","names":[],"sources":["../../src/runtime/component.ts"],"sourcesContent":["/**\n * Component instance lifecycle management\n * Internal only — users never see this\n */\n\nimport { type State } from './state';\nimport { globalScheduler } from './scheduler';\nimport type { Props } from '../common/props';\nimport type { ComponentFunction } from '../common/component';\nimport {\n  // withContext is the sole primitive for context restoration\n  withContext,\n  type ContextFrame,\n} from './context';\nimport {\n  type ReadableSource,\n  finalizeReadableSubscriptions,\n  cleanupReadableSubscriptions,\n} from './readable';\nimport {\n  isDevelopmentEnvironment,\n  isProductionEnvironment,\n} from '../common/env';\nimport { logger } from '../dev/logger';\nimport { incDevCounter, setDevValue } from './dev-namespace';\n\nexport type { ComponentFunction } from '../common/component';\n\nexport interface ComponentInstance {\n  id: string;\n  fn: ComponentFunction;\n  props: Props;\n  target: Element | null;\n  mounted: boolean;\n  abortController: AbortController | null; // Lazily created per-component abort lifecycle\n  ssr?: boolean; // Set to true for SSR temporary instances\n  // Opt-in strict cleanup mode: when true cleanup errors are aggregated and re-thrown\n  cleanupStrict?: boolean;\n  stateValues: State<unknown>[]; // Persistent state storage across renders\n  evaluationGeneration: number; // Prevents stale async evaluation completions\n  notifyUpdate: (() => void) | null; // Callback for state updates (persisted on instance)\n  // Internal: prebound helpers to avoid per-update closures (allocation hot-path)\n  _pendingFlushTask?: () => void; // Clears hasPendingUpdate and triggers notifyUpdate\n  _pendingRunTask?: () => void; // Clears hasPendingUpdate and runs component\n  _enqueueRun?: () => void; // Batches run requests and enqueues _pendingRunTask\n  stateIndexCheck: number; // Track state indices to catch conditional calls\n  expectedStateIndices: number[]; // Expected sequence of render-scoped hook indices (frozen after first render)\n  firstRenderComplete: boolean; // Flag to detect transition from first to subsequent renders\n  mountOperations: Array<\n    () => void | (() => void) | Promise<void | (() => void)>\n  >; // Operations to run when component mounts\n  cleanupFns: Array<() => void>; // Cleanup functions to run on unmount\n  hasPendingUpdate: boolean; // Flag to batch state updates (coalescing)\n  ownerFrame: ContextFrame | null; // Provider chain for this component (set by Scope, never overwritten)\n  isRoot?: boolean;\n\n  // Render-tracking for precise subscriptions (internal)\n  _currentRenderToken?: number; // Token for the in-progress render (set before render)\n  lastRenderToken?: number; // Token of the last *committed* render\n  _pendingReadSources?: Set<ReadableSource<unknown>>; // Readables read during the in-progress render\n  _lastReadSources?: Set<ReadableSource<unknown>>; // Readables read during the last committed render\n  devWarningsEmitted?: Set<string>; // Dev-only warning dedupe for this instance\n\n  // Placeholder for null-returning components. When a component initially returns\n  // null, we create a comment placeholder so updates can replace it with content.\n  _placeholder?: Comment;\n  _ownedChildScopes?: Set<{\n    key: string | number;\n    dispose(): void;\n  }>;\n  errorBoundaryState?: {\n    error: unknown | null;\n    resetKey: unknown;\n    notified: boolean;\n  };\n}\n\nexport function createComponentInstance(\n  id: string,\n  fn: ComponentFunction,\n  props: Props,\n  target: Element | null\n): ComponentInstance {\n  const instance: ComponentInstance = {\n    id,\n    fn,\n    props,\n    target,\n    mounted: false,\n    abortController: null,\n    stateValues: [],\n    evaluationGeneration: 0,\n    notifyUpdate: null,\n    // Prebound helpers (initialized below) to avoid per-update allocations\n    _pendingFlushTask: undefined,\n    _pendingRunTask: undefined,\n    _enqueueRun: undefined,\n    stateIndexCheck: -1,\n    expectedStateIndices: [],\n    firstRenderComplete: false,\n    mountOperations: [],\n    cleanupFns: [],\n    hasPendingUpdate: false,\n    ownerFrame: null, // Will be set by renderer when vnode is marked\n    ssr: false,\n    cleanupStrict: false,\n    isRoot: false,\n\n    // Render-tracking (for precise state subscriptions)\n    _currentRenderToken: undefined,\n    lastRenderToken: 0,\n    _pendingReadSources: undefined,\n    _lastReadSources: undefined,\n    devWarningsEmitted: undefined,\n  };\n\n  // Initialize prebound helper tasks once per instance to avoid allocations\n  instance._pendingRunTask = () => {\n    // Clear pending flag when the run task executes\n    instance.hasPendingUpdate = false;\n    // Execute component run (will set up notifyUpdate before render)\n    runComponent(instance);\n  };\n\n  instance._enqueueRun = () => {\n    if (!instance.hasPendingUpdate) {\n      instance.hasPendingUpdate = true;\n      // Enqueue single run task (coalesces multiple writes)\n      globalScheduler.enqueue(instance._pendingRunTask!);\n    }\n  };\n\n  // Default state-driven updates enqueue the run task directly. Specialized\n  // runtimes (for example `For` item instances) can still override this hook.\n  instance._pendingFlushTask = instance._pendingRunTask;\n\n  return instance;\n}\n\nlet currentInstance: ComponentInstance | null = null;\nlet stateIndex = 0;\n\ntype OwnedChildScope = {\n  key: string | number;\n  dispose(): void;\n};\n\nfunction ensureAbortController(instance: ComponentInstance): AbortController {\n  let controller = instance.abortController;\n  if (!controller || controller.signal.aborted) {\n    controller = new AbortController();\n    instance.abortController = controller;\n  }\n  return controller;\n}\n\n// Export for state.ts to access\nexport function getCurrentComponentInstance(): ComponentInstance | null {\n  return currentInstance;\n}\n\n// Export for SSR to set temporary instance\nexport function setCurrentComponentInstance(\n  instance: ComponentInstance | null\n): void {\n  currentInstance = instance;\n}\n\n/**\n * Register a mount operation that will run after the component is mounted\n * Used by operations (task, on, timer, etc) to execute after render completes\n */\nimport { isBulkCommitActive } from './fastlane';\nimport { evaluate, cleanupInstancesUnder } from '../renderer';\n\nexport function registerMountOperation(\n  operation: () => void | (() => void) | Promise<void | (() => void)>\n): void {\n  const instance = getCurrentComponentInstance();\n  if (instance) {\n    // If we're in bulk-commit fast lane, registering mount operations is a\n    // violation of the fast-lane preconditions. Throw in dev, otherwise ignore\n    // silently in production (we must avoid scheduling work during bulk commit).\n    if (isBulkCommitActive()) {\n      if (isDevelopmentEnvironment()) {\n        throw new Error(\n          'registerMountOperation called during bulk commit fast-lane'\n        );\n      }\n      return;\n    }\n    instance.mountOperations.push(operation);\n  }\n}\n\n/**\n * Execute all mount operations for a component\n * These run after the component is rendered and mounted to the DOM\n */\nfunction executeMountOperations(instance: ComponentInstance): void {\n  // Only execute mount operations for root app instance. Child component\n  // operations are currently registered but should not be executed (per\n  // contract tests). They remain registered for cleanup purposes.\n  if (!instance.isRoot) return;\n\n  const mountOperations = instance.mountOperations;\n  if (mountOperations.length === 0) {\n    return;\n  }\n\n  for (const operation of mountOperations) {\n    const result = operation();\n    if (result instanceof Promise) {\n      result.then((cleanup) => {\n        if (typeof cleanup === 'function') {\n          instance.cleanupFns.push(cleanup);\n        }\n      });\n    } else if (typeof result === 'function') {\n      instance.cleanupFns.push(result);\n    }\n  }\n  // Clear the operations array so they don't run again on subsequent renders\n  instance.mountOperations = [];\n}\n\nexport function mountInstanceInline(\n  instance: ComponentInstance,\n  target: Element | null\n): void {\n  instance.target = target;\n  // Record backref on host element so renderer can clean up when the\n  // node is removed. Avoids leaks if the node is detached or replaced.\n  try {\n    if (target instanceof Element) {\n      const host = target as Element & {\n        __ASKR_INSTANCE?: ComponentInstance;\n        __ASKR_INSTANCES?: ComponentInstance[];\n      };\n      const instances = host.__ASKR_INSTANCES ?? [];\n      const nextInstances = instances.filter((entry) => entry !== instance);\n      nextInstances.push(instance);\n      host.__ASKR_INSTANCES = nextInstances;\n      host.__ASKR_INSTANCE = nextInstances[0] ?? instance;\n    }\n  } catch (err) {\n    void err;\n  }\n\n  // Ensure notifyUpdate is available for async resource completions that may\n  // try to trigger re-render. This mirrors the setup in executeComponent().\n  // Use prebound enqueue helper to avoid allocating a new closure\n  instance.notifyUpdate = instance._enqueueRun!;\n\n  const wasFirstMount = !instance.mounted;\n  instance.mounted = true;\n  if (wasFirstMount && instance.mountOperations.length > 0) {\n    executeMountOperations(instance);\n  }\n}\n\n/**\n * Run a component synchronously: execute function, handle result\n * This is the internal workhorse that manages async continuations and generation tracking.\n * Must always be called through the scheduler.\n *\n * ACTOR INVARIANT: This function is enqueued as a task, never called directly.\n */\nlet _globalRenderCounter = 0;\n\nfunction resetRenderState(instance: ComponentInstance): void {\n  instance.stateIndexCheck = -1;\n\n  for (const state of instance.stateValues) {\n    if (state) {\n      state._hasBeenRead = false;\n    }\n  }\n\n  instance._pendingReadSources = undefined;\n}\n\nfunction nextRenderToken(): number {\n  return ++_globalRenderCounter;\n}\n\nexport function renderScopedComponent<T>(\n  instance: ComponentInstance,\n  startStateIndex: number,\n  render: () => T\n): T {\n  const savedInstance = currentInstance;\n  const savedStateIndex = stateIndex;\n\n  instance.notifyUpdate = instance._enqueueRun!;\n  resetRenderState(instance);\n  instance._currentRenderToken = nextRenderToken();\n\n  currentInstance = instance;\n  stateIndex = startStateIndex;\n\n  let didComplete = false;\n\n  try {\n    const executionFrame: ContextFrame = {\n      parent: instance.ownerFrame,\n      values: null,\n    };\n    const result = withContext(executionFrame, render);\n    didComplete = true;\n    return result;\n  } finally {\n    if (!didComplete) {\n      instance._pendingReadSources = undefined;\n      instance._currentRenderToken = undefined;\n    }\n    currentInstance = savedInstance;\n    stateIndex = savedStateIndex;\n  }\n}\n\nfunction runComponent(instance: ComponentInstance): void {\n  // CRITICAL: Ensure notifyUpdate is available for state.set() calls during this render.\n  // This must be set before executeComponentSync() runs, not after.\n  // Use prebound enqueue helper to avoid allocating per-render closures\n  instance.notifyUpdate = instance._enqueueRun!;\n\n  // Assign a token for this in-progress render and start a fresh pending-read set\n  instance._currentRenderToken = nextRenderToken();\n  instance._pendingReadSources = undefined;\n  const domSnapshot = instance.target ? instance.target.innerHTML : '';\n\n  const result = executeComponentSync(instance);\n  if (result instanceof Promise) {\n    // Async components are not supported. Components must be synchronous and\n    // must not return a Promise from their render function.\n    throw new Error(\n      'Async components are not supported. Components must be synchronous.'\n    );\n  } else {\n    // Try runtime fast-lane synchronously; if it activates we do not enqueue\n    // follow-up work and the commit happens atomically in this task.\n    // (Runtime fast-lane has conservative preconditions.)\n    const fastlaneBridge = (\n      globalThis as {\n        __ASKR_FASTLANE?: {\n          tryRuntimeFastLaneSync?: (\n            instance: unknown,\n            result: unknown\n          ) => boolean;\n        };\n      }\n    ).__ASKR_FASTLANE;\n    try {\n      const used = fastlaneBridge?.tryRuntimeFastLaneSync?.(instance, result);\n      if (used) {\n        warnUnusedStateReads(instance);\n        return;\n      }\n    } catch (err) {\n      // If invariant check failed in dev, surface the error; otherwise fall back\n      if (isDevelopmentEnvironment()) throw err;\n    }\n\n    // Fallback: enqueue the render/commit normally\n    globalScheduler.enqueue(() => {\n      // Handle placeholder-based updates: when a component initially returned null,\n      // we created a comment placeholder. If it now has content, we need to create\n      // a host element and replace the placeholder.\n      if (!instance.target && instance._placeholder) {\n        // Component previously returned null (has placeholder), check if now has content\n        if (result === null || result === undefined) {\n          // Still null - nothing to do, keep placeholder\n          finalizeReadSubscriptions(instance);\n          warnUnusedStateReads(instance);\n          return;\n        }\n\n        // Has content now - need to create DOM and replace placeholder\n        const placeholder = instance._placeholder;\n        const parent = placeholder.parentNode;\n        if (!parent) {\n          // Placeholder was removed from DOM - can't render\n          logger.warn(\n            '[Askr] placeholder no longer in DOM, cannot render component'\n          );\n          return;\n        }\n\n        // Create a new host element for the content\n        const host = document.createElement('div');\n        const executionFrame: ContextFrame = {\n          parent: instance.ownerFrame,\n          values: null,\n        };\n\n        // Set up instance for normal updates\n        const oldInstance = currentInstance;\n        currentInstance = instance;\n        try {\n          withContext(executionFrame, () => {\n            evaluate(result, host);\n          });\n\n          // Replace placeholder with host\n          parent.replaceChild(host, placeholder);\n\n          // Set up instance for future updates\n          instance.target = host;\n          instance._placeholder = undefined;\n          (\n            host as Element & { __ASKR_INSTANCE?: ComponentInstance }\n          ).__ASKR_INSTANCE = instance;\n\n          finalizeReadSubscriptions(instance);\n          warnUnusedStateReads(instance);\n        } finally {\n          currentInstance = oldInstance;\n        }\n        return;\n      }\n\n      if (instance.target) {\n        let oldChildren: Node[] = [];\n        try {\n          const wasFirstMount = !instance.mounted;\n          // Ensure nested component executions during evaluation have access to\n          // the current component instance. This allows nested components to\n          // call `state()`, `resource()`, and other runtime helpers which\n          // rely on `getCurrentComponentInstance()` being available.\n          const oldInstance = currentInstance;\n          currentInstance = instance;\n          const executionFrame: ContextFrame = {\n            parent: instance.ownerFrame,\n            values: null,\n          };\n          // Capture snapshot of current children (by reference) so we can\n          // restore them on render failure without losing event listeners or\n          // instance attachments.\n          oldChildren = Array.from(instance.target.childNodes);\n\n          try {\n            withContext(executionFrame, () => {\n              evaluate(result, instance.target);\n            });\n          } catch (e) {\n            // If evaluation failed, attempt to cleanup any partially-added nodes\n            // and restore the old children to preserve listeners and instances.\n            try {\n              const newChildren = Array.from(instance.target.childNodes);\n              for (const n of newChildren) {\n                try {\n                  cleanupInstancesUnder(n);\n                } catch (err) {\n                  logger.warn(\n                    '[Askr] error cleaning up failed commit children:',\n                    err\n                  );\n                }\n              }\n            } catch (_err) {\n              void _err;\n            }\n\n            // Restore original children by re-inserting the old node references\n            // this preserves attached listeners and instance backrefs.\n            try {\n              incDevCounter('__DOM_REPLACE_COUNT');\n              setDevValue(\n                '__LAST_DOM_REPLACE_STACK_COMPONENT_RESTORE',\n                new Error().stack\n              );\n            } catch (e) {\n              void e;\n            }\n            instance.target.replaceChildren(...oldChildren);\n            throw e;\n          } finally {\n            currentInstance = oldInstance;\n          }\n\n          // Commit succeeded — finalize recorded state reads so subscriptions reflect\n          // the last *committed* render. This updates per-state reader maps\n          // deterministically and synchronously with the commit.\n          finalizeReadSubscriptions(instance);\n          warnUnusedStateReads(instance);\n\n          instance.mounted = true;\n          // Execute mount operations after first mount (do NOT run these with\n          // currentInstance set - they may perform state mutations/registrations)\n          if (wasFirstMount && instance.mountOperations.length > 0) {\n            executeMountOperations(instance);\n          }\n        } catch (renderError) {\n          // Atomic rendering: rollback on render error. Attempt non-lossy restore of\n          // original child node references to preserve listeners/instances.\n          try {\n            const currentChildren = Array.from(instance.target.childNodes);\n            for (const n of currentChildren) {\n              try {\n                cleanupInstancesUnder(n);\n              } catch (err) {\n                logger.warn(\n                  '[Askr] error cleaning up partial children during rollback:',\n                  err\n                );\n              }\n            }\n          } catch (_err) {\n            void _err;\n          }\n\n          try {\n            incDevCounter('__DOM_REPLACE_COUNT');\n            setDevValue(\n              '__LAST_DOM_REPLACE_STACK_COMPONENT_ROLLBACK',\n              new Error().stack\n            );\n            instance.target.replaceChildren(...oldChildren);\n          } catch {\n            // Fallback to innerHTML restore if replaceChildren fails for some reason.\n            instance.target.innerHTML = domSnapshot;\n          }\n\n          throw renderError;\n        }\n      }\n    });\n  }\n}\n\n/**\n * Execute a component's render function synchronously.\n * Returns either a vnode/promise immediately (does NOT render).\n * Rendering happens separately through runComponent.\n */\nexport function renderComponentInline(\n  instance: ComponentInstance\n): unknown | Promise<unknown> {\n  // Ensure inline executions (rendered during parent's evaluate) still\n  // receive a render token and have their state reads finalized so\n  // subscriptions are correctly recorded. If this function is called\n  // as part of a scheduled run, the token will already be set by\n  // runComponent and we should not overwrite it.\n  const hadToken = instance._currentRenderToken !== undefined;\n  const prevToken = instance._currentRenderToken;\n  const prevPendingReads = instance._pendingReadSources;\n  if (!hadToken) {\n    instance._currentRenderToken = nextRenderToken();\n    instance._pendingReadSources = undefined;\n  }\n\n  try {\n    const result = executeComponentSync(instance);\n    // If we set the token for inline execution, finalize subscriptions now\n    // because the component is effectively committed as part of the parent's\n    // synchronous evaluation.\n    if (!hadToken) {\n      finalizeReadSubscriptions(instance);\n    }\n    return result;\n  } finally {\n    // Restore previous token/read states for nested inline render scenarios\n    instance._currentRenderToken = prevToken;\n    instance._pendingReadSources = prevPendingReads;\n  }\n}\n\nexport function warnUnusedStateReads(instance: ComponentInstance): void {\n  for (let i = 0; i < instance.stateValues.length; i++) {\n    const state = instance.stateValues[i];\n    const hasCommittedUsage =\n      (state?._readers?.size ?? 0) > 0 ||\n      ((state as { _derivedSubscribers?: Set<unknown> } | undefined)\n        ?._derivedSubscribers?.size ?? 0) > 0;\n\n    if (state && !state._hasBeenRead && !hasCommittedUsage) {\n      try {\n        const name = instance.fn?.name || '<anonymous>';\n        warnInstanceOnce(\n          instance,\n          `unused-state:${i}`,\n          `[askr] Unused state variable detected in ${name} at index ${i}. State should be read during render or removed.`\n        );\n      } catch {\n        warnInstanceOnce(\n          instance,\n          `unused-state:${i}`,\n          `[askr] Unused state variable detected. State should be read during render or removed.`\n        );\n      }\n    }\n  }\n}\n\nfunction executeComponentSync(\n  instance: ComponentInstance\n): unknown | Promise<unknown> {\n  resetRenderState(instance);\n  incDevCounter('componentRuns');\n  incDevCounter('componentReruns');\n\n  currentInstance = instance;\n  stateIndex = 0;\n\n  try {\n    // Track render time in dev mode\n    const renderStartTime = isDevelopmentEnvironment() ? Date.now() : 0;\n\n    // Create context object with abort signal\n    const context = {\n      get signal(): AbortSignal {\n        return ensureAbortController(instance).signal;\n      },\n    };\n\n    // Execute component within its owner frame (provider chain).\n    // This ensures all context reads see the correct provider values.\n    // We create a new execution frame whose parent is the ownerFrame. The\n    // `values` map is lazily allocated to avoid per-render Map allocations\n    // for components that do not use context.\n    const executionFrame: ContextFrame = {\n      parent: instance.ownerFrame,\n      values: null,\n    };\n    const result = withContext(executionFrame, () =>\n      instance.fn(instance.props, context)\n    );\n\n    // Check render time\n    const renderTime = Date.now() - renderStartTime;\n    if (renderTime > 5) {\n      warnInstanceOnce(\n        instance,\n        'slow-render',\n        `[askr] Slow render detected: ${renderTime}ms. Consider optimizing component performance.`\n      );\n    }\n\n    // Mark first render complete after successful execution\n    // This enables hook order validation on subsequent renders\n    if (!instance.firstRenderComplete) {\n      instance.firstRenderComplete = true;\n    }\n\n    return result;\n  } finally {\n    // Synchronous path: we did not push a fresh frame, so nothing to pop here.\n    currentInstance = null;\n  }\n}\n\n/**\n * Public entry point: Execute component with full lifecycle (execute + render)\n * Handles both initial mount and re-execution. Always enqueues through scheduler.\n * Single entry point to avoid lifecycle divergence.\n */\nexport function executeComponent(instance: ComponentInstance): void {\n  // Lazily recreate abort controller only when signal is actually requested.\n  instance.abortController = null;\n\n  // Setup notifyUpdate callback using prebound helper to avoid per-call closures\n  instance.notifyUpdate = instance._enqueueRun!;\n\n  // Enqueue the initial component run\n  globalScheduler.enqueue(instance._pendingRunTask!);\n}\n\nexport function getCurrentInstance(): ComponentInstance | null {\n  return currentInstance;\n}\n\n/**\n * Get the abort signal for the current component\n * Used to cancel async operations on unmount/navigation\n *\n * The signal is guaranteed to be aborted when:\n * - Component unmounts\n * - Navigation occurs (different route)\n * - Parent is destroyed\n *\n * IMPORTANT: getSignal() must be called during component render execution.\n * It captures the current component instance from context.\n *\n * @returns AbortSignal that will be aborted when component unmounts\n * @throws Error if called outside component execution\n *\n * @example\n * ```ts\n * // ✅ Correct: called during render, used in async operation\n * export async function UserPage({ id }: { id: string }) {\n *   const signal = getSignal();\n *   const user = await fetch(`/api/users/${id}`, { signal });\n *   return <div>{user.name}</div>;\n * }\n *\n * // ✅ Correct: passed to event handler\n * export function Button() {\n *   const signal = getSignal();\n *   return {\n *     type: 'button',\n *     props: {\n *       onClick: async () => {\n *         const data = await fetch(url, { signal });\n *       }\n *     }\n *   };\n * }\n *\n * // ❌ Wrong: called outside component context\n * const signal = getSignal(); // Error: not in component\n * ```\n */\nexport function getSignal(): AbortSignal {\n  if (!currentInstance) {\n    throw new Error(\n      'getSignal() can only be called during component render execution. ' +\n        'Ensure you are calling this from inside your component function.'\n    );\n  }\n  return ensureAbortController(currentInstance).signal;\n}\n\n/**\n * Finalize read subscriptions for an instance after a successful commit.\n * - Update per-state readers map to point to this instance's last committed token\n * - Remove this instance from states it no longer reads\n * This is deterministic and runs synchronously with commit to ensure\n * subscribers are only notified when they actually read a state in their\n * last committed render.\n */\nexport function finalizeReadSubscriptions(instance: ComponentInstance): void {\n  finalizeReadableSubscriptions(instance);\n}\n\nexport function getNextStateIndex(): number {\n  return stateIndex++;\n}\n\nexport function claimHookIndex(\n  instance: ComponentInstance,\n  hookName: string\n): number {\n  const index = getNextStateIndex();\n\n  if (index < instance.stateIndexCheck) {\n    throw new Error(\n      `Hook index violation: ${hookName}() call at index ${index}, ` +\n        `but previously saw index ${instance.stateIndexCheck}. ` +\n        `This happens when render-scoped hooks are called conditionally (inside if/for/etc). ` +\n        `Move all ${hookName}() calls to the top level of your component function, ` +\n        `before any conditionals.`\n    );\n  }\n\n  instance.stateIndexCheck = index;\n\n  if (instance.firstRenderComplete) {\n    if (!instance.expectedStateIndices.includes(index)) {\n      throw new Error(\n        `Hook order violation: ${hookName}() called at index ${index}, ` +\n          `but this index was not in the first render's sequence [${instance.expectedStateIndices.join(', ')}]. ` +\n          `This usually means ${hookName}() is inside a conditional or loop. ` +\n          `Move all render-scoped hooks to the top level of your component function.`\n      );\n    }\n  } else {\n    instance.expectedStateIndices.push(index);\n  }\n\n  return index;\n}\n\nexport function getCurrentStateIndex(): number {\n  return stateIndex;\n}\n\nexport function resetStateIndex(): void {\n  stateIndex = 0;\n}\n\nexport function setStateIndex(value: number): void {\n  stateIndex = value;\n}\n\n/**\n * Mount a component instance.\n * This is just an alias to executeComponent() to maintain API compatibility.\n * All lifecycle logic is unified in executeComponent().\n */\nexport function mountComponent(instance: ComponentInstance): void {\n  executeComponent(instance);\n}\n\n/**\n * Clean up component — abort pending operations\n * Called on unmount or route change\n */\nexport function cleanupComponent(instance: ComponentInstance): void {\n  const ownedChildScopes = instance._ownedChildScopes;\n  if (ownedChildScopes && ownedChildScopes.size > 0) {\n    instance._ownedChildScopes = new Set();\n    for (const scope of ownedChildScopes) {\n      scope.dispose();\n    }\n  }\n\n  // Execute cleanup functions (from mount effects)\n  const cleanupErrors: unknown[] = [];\n  const cleanupFns = instance.cleanupFns;\n  for (const cleanup of cleanupFns) {\n    try {\n      cleanup();\n    } catch (err) {\n      if (instance.cleanupStrict) {\n        cleanupErrors.push(err);\n      } else {\n        // Preserve previous behavior: log warnings in dev and continue\n        if (isDevelopmentEnvironment()) {\n          logger.warn('[Askr] cleanup function threw:', err);\n        }\n      }\n    }\n  }\n  instance.cleanupFns = [];\n  if (cleanupErrors.length > 0) {\n    // If strict mode, surface all cleanup errors as an AggregateError after attempting all cleanups\n    throw new AggregateError(\n      cleanupErrors,\n      `Cleanup failed for component ${instance.id}`\n    );\n  }\n\n  // Remove deterministic state subscriptions for this instance\n  cleanupReadableSubscriptions(instance);\n\n  // Abort all pending operations\n  if (instance.abortController && !instance.abortController.signal.aborted) {\n    instance.abortController.abort();\n  }\n  instance.abortController = null;\n\n  // Clear update callback to prevent dangling references and stale updates\n  instance.notifyUpdate = null;\n  instance._placeholder = undefined;\n\n  // Mark instance as unmounted so external tracking (e.g., portal host lists)\n  // can deterministically prune stale instances. Not marking this leads to\n  // retained \"mounted\" flags across cleanup boundaries which breaks\n  // owner selection in the portal fallback.\n  instance.mounted = false;\n}\n\nexport function registerOwnedChildScope(\n  instance: ComponentInstance,\n  scope: OwnedChildScope\n): void {\n  const scopes = (instance._ownedChildScopes ??= new Set());\n  scopes.add(scope);\n}\n\nexport function unregisterOwnedChildScope(\n  instance: ComponentInstance,\n  scope: OwnedChildScope\n): void {\n  instance._ownedChildScopes?.delete(scope);\n}\n\nfunction warnInstanceOnce(\n  instance: ComponentInstance,\n  key: string,\n  message: string\n): void {\n  if (isProductionEnvironment()) return;\n  const warnings = (instance.devWarningsEmitted ??= new Set());\n  if (warnings.has(key)) return;\n  warnings.add(key);\n  logger.warn(message);\n}\n"],"mappings":"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"}

package/dist/ssr/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","names":[],"sources":["../../src/ssr/index.ts"],"mappings":";;;;;;;;KAiFY,SAAA,GAAY,YAAA;AAAA,iBAQR,wBAAA,CAAA;AAAA,iBAmBA,uBAAA,CAAA;;;;;AAmtBhB;iBAAgB,kBAAA,CACd,SAAA,GACE,KAAA,GAAQ,MAAA,sBACL,KAAA,GAAQ,UAAA,iDACb,KAAA,GAAQ,MAAA,mBACR,OAAA;EAAY,IAAA;EAAe,IAAA,GAAO,OAAA;AAAA;AAAA,iBA2BpB,0BAAA,CAA2B,IAAA;EACzC,GAAA;EACA,MAAA,EAAQ,KAAA;IAAQ,IAAA;IAAc,OAAA,EAAS,YAAA;IAAc,SAAA;EAAA;EACrD,OAAA,EAAS,YAAA;EACT,MAAA,GAAS,MAAA;EACT,OAAA;IAAY,IAAA;IAAe,IAAA,GAAO,OAAA;EAAA;AAAA;AAAA,iBA6Bd,cAAA,CAAe,IAAA;EACnC,GAAA;EACA,QAAA,GAAW,aAAA;EACX,MAAA,GAAS,KAAA;IAAQ,IAAA;IAAc,OAAA,EAAS,YAAA;IAAc,SAAA;EAAA;EACtD,IAAA,GAAO,gBAAA;EACP,MAAA,GAAS,WAAA;AAAA,IACP,OAAA,CAAQ,kBAAA;AAAA,iBAmCI,wBAAA,CAAyB,IAAA;EACvC,GAAA;EACA,MAAA,EAAQ,KAAA;IAAQ,IAAA;IAAc,OAAA,EAAS,YAAA;IAAc,SAAA;EAAA;EACrD,OAAA;IAAY,IAAA;IAAe,IAAA,GAAO,OAAA;EAAA;AAAA;AAAA,iBAqBpB,yBAAA,CAA0B,IAAA;EACxC,IAAA,EAAM,OAAA;EACN,GAAA;EACA,MAAA,EAAQ,KAAA;IAAQ,IAAA;IAAc,OAAA,EAAS,YAAA;IAAc,SAAA;EAAA;EACrD,OAAA;IAAY,IAAA;IAAe,IAAA,GAAO,OAAA;EAAA;AAAA;AAAA,KAkDxB,QAAA;EACV,IAAA;EACA,OAAA,EAAS,YAAA;EACT,SAAA;AAAA;AAAA,iBAGc,cAAA,CACd,SAAA,GACE,KAAA,GAAQ,MAAA,sBACL,KAAA,GAAQ,UAAA;AAAA,iBAEC,cAAA,CAAe,IAAA;EAC7B,GAAA;EACA,MAAA,EAAQ,QAAA;EACR,IAAA;EACA,IAAA,GAAO,OAAA;AAAA;AAAA,iBAuBO,cAAA,CAAe,IAAA;EAC7B,GAAA;EACA,MAAA,EAAQ,QAAA;EACR,IAAA;EACA,IAAA,GAAO,OAAA;EACP,OAAA,CAAQ,IAAA;EACR,UAAA;AAAA"}
+{"version":3,"file":"index.d.ts","names":[],"sources":["../../src/ssr/index.ts"],"mappings":";;;;;;;;KAkFY,SAAA,GAAY,YAAA;AAAA,iBAQR,wBAAA,CAAA;AAAA,iBAmBA,uBAAA,CAAA;;;;;AA+/BhB;iBAAgB,kBAAA,CACd,SAAA,GACE,KAAA,GAAQ,MAAA,sBACL,KAAA,GAAQ,UAAA,iDACb,KAAA,GAAQ,MAAA,mBACR,OAAA;EAAY,IAAA;EAAe,IAAA,GAAO,OAAA;AAAA;AAAA,iBA2BpB,0BAAA,CAA2B,IAAA;EACzC,GAAA;EACA,MAAA,EAAQ,KAAA;IAAQ,IAAA;IAAc,OAAA,EAAS,YAAA;IAAc,SAAA;EAAA;EACrD,OAAA,EAAS,YAAA;EACT,MAAA,GAAS,MAAA;EACT,OAAA;IAAY,IAAA;IAAe,IAAA,GAAO,OAAA;EAAA;AAAA;AAAA,iBA6Bd,cAAA,CAAe,IAAA;EACnC,GAAA;EACA,QAAA,GAAW,aAAA;EACX,MAAA,GAAS,KAAA;IAAQ,IAAA;IAAc,OAAA,EAAS,YAAA;IAAc,SAAA;EAAA;EACtD,IAAA,GAAO,gBAAA;EACP,MAAA,GAAS,WAAA;AAAA,IACP,OAAA,CAAQ,kBAAA;AAAA,iBAmCI,wBAAA,CAAyB,IAAA;EACvC,GAAA;EACA,MAAA,EAAQ,KAAA;IAAQ,IAAA;IAAc,OAAA,EAAS,YAAA;IAAc,SAAA;EAAA;EACrD,OAAA;IAAY,IAAA;IAAe,IAAA,GAAO,OAAA;EAAA;AAAA;AAAA,iBAqBpB,yBAAA,CAA0B,IAAA;EACxC,IAAA,EAAM,OAAA;EACN,GAAA;EACA,MAAA,EAAQ,KAAA;IAAQ,IAAA;IAAc,OAAA,EAAS,YAAA;IAAc,SAAA;EAAA;EACrD,OAAA;IAAY,IAAA;IAAe,IAAA,GAAO,OAAA;EAAA;AAAA;AAAA,KAkDxB,QAAA;EACV,IAAA;EACA,OAAA,EAAS,YAAA;EACT,SAAA;AAAA;AAAA,iBAGc,cAAA,CACd,SAAA,GACE,KAAA,GAAQ,MAAA,sBACL,KAAA,GAAQ,UAAA;AAAA,iBAEC,cAAA,CAAe,IAAA;EAC7B,GAAA;EACA,MAAA,EAAQ,QAAA;EACR,IAAA;EACA,IAAA,GAAO,OAAA;AAAA;AAAA,iBAuBO,cAAA,CAAe,IAAA;EAC7B,GAAA;EACA,MAAA,EAAQ,QAAA;EACR,IAAA;EACA,IAAA,GAAO,OAAA;EACP,OAAA,CAAQ,IAAA;EACR,UAAA;AAAA"}

package/dist/ssr/index.js

@@ -1,4 +1,5 @@
 import { __CONTROL_BOUNDARY__ } from "../common/control.js";
+import { __ERROR_BOUNDARY__ } from "../common/vnode.js";
 import { logger } from "../dev/logger.js";
 import { ELEMENT_TYPE, Fragment } from "../common/jsx.js";
 import { createComponentInstance, getCurrentComponentInstance, setCurrentComponentInstance } from "../runtime/component.js";
@@ -78,6 +79,88 @@ function renderChildrenSync(children, ctx) {
 	}
 	return Array.from({ length: children.length }, (_, index) => renderChildSync(children[index], ctx)).join("");
 }
+function normalizeRenderableChildren(value) {
+	if (value === null || value === void 0 || value === false) return [];
+	return Array.isArray(value) ? value : [value];
+}
+function getErrorBoundaryState(node) {
+	return node.__instance?.errorBoundaryState ?? null;
+}
+function createDefaultErrorBoundaryFallbackVNode(error) {
+	const message = error instanceof Error ? error.stack || error.message || error.name : typeof error === "string" ? error : (() => {
+		try {
+			return JSON.stringify(error);
+		} catch {
+			return String(error);
+		}
+	})();
+	return {
+		$$typeof: ELEMENT_TYPE,
+		type: "div",
+		props: {
+			role: "alert",
+			"data-askr-error-boundary": "true",
+			style: {
+				boxSizing: "border-box",
+				padding: "1rem",
+				border: "1px solid currentColor",
+				borderRadius: "0.75rem",
+				display: "grid",
+				gap: "0.75rem",
+				maxWidth: "100%"
+			},
+			children: [
+				{
+					$$typeof: ELEMENT_TYPE,
+					type: "strong",
+					props: { children: ["Something went wrong while rendering this view."] }
+				},
+				{
+					$$typeof: ELEMENT_TYPE,
+					type: "p",
+					props: {
+						style: { margin: "0" },
+						children: ["The app recovered into a visible fallback so the error is not hidden in the console."]
+					}
+				},
+				{
+					$$typeof: ELEMENT_TYPE,
+					type: "details",
+					props: {
+						open: true,
+						children: [{
+							$$typeof: ELEMENT_TYPE,
+							type: "summary",
+							props: { children: ["Error details"] }
+						}, {
+							$$typeof: ELEMENT_TYPE,
+							type: "pre",
+							props: {
+								style: {
+									margin: "0",
+									whiteSpace: "pre-wrap",
+									wordBreak: "break-word"
+								},
+								children: [message]
+							}
+						}]
+					}
+				}
+			]
+		},
+		key: null
+	};
+}
+function resolveErrorBoundaryFallbackNode(fallback, error, reset) {
+	return typeof fallback === "function" ? fallback(error, reset) : fallback !== void 0 ? fallback : createDefaultErrorBoundaryFallbackVNode(error);
+}
+function renderErrorBoundaryFallbackValue(fallback, error, reset, ctx) {
+	const nextValue = resolveErrorBoundaryFallbackNode(fallback, error, reset);
+	return Array.isArray(nextValue) ? renderChildrenSync(normalizeRenderableChildren(nextValue), ctx) : renderChildSync(nextValue, ctx);
+}
+function renderErrorBoundaryFallbackValueToSink(fallback, error, reset, sink, ctx) {
+	sink.write(renderErrorBoundaryFallbackValue(fallback, error, reset, ctx));
+}
 function getControlBoundaryState(node) {
 	const boundaryNode = node;
 	return boundaryNode._controlState ?? boundaryNode._forState ?? null;
@@ -151,6 +234,28 @@ function renderNodeSync(node, ctx) {
 			return renderChildrenSync(childrenArr, ctx);
 		}
 		if (type === __CONTROL_BOUNDARY__) return renderChildrenSync(evaluateControlBoundaryChildren(node), ctx);
+		if (type === __ERROR_BOUNDARY__) {
+			const boundaryState = getErrorBoundaryState(node);
+			const fallback = props?.fallback;
+			const reset = () => {
+				const state = node.__instance?.errorBoundaryState;
+				if (state) {
+					state.error = null;
+					state.notified = false;
+				}
+			};
+			if (boundaryState?.error != null) return renderErrorBoundaryFallbackValue(fallback, boundaryState.error, reset, ctx);
+			try {
+				return renderChildrenSync(normalizeRenderableChildren(props?.children), ctx);
+			} catch (error) {
+				if (boundaryState) {
+					boundaryState.error = error;
+					boundaryState.notified = true;
+				}
+				logger.error("[Askr] ErrorBoundary caught render error:", error);
+				return renderErrorBoundaryFallbackValue(fallback, error, reset, ctx);
+			}
+		}
 		throw new Error(`renderNodeSync: unsupported VNode symbol type: ${String(type)}`);
 	}
 	const typeStr = type;
@@ -178,6 +283,32 @@ function renderNodeSyncToSink(node, sink, ctx) {
 			renderChildrenSyncToSink(evaluateControlBoundaryChildren(node), sink, ctx);
 			return;
 		}
+		if (type === __ERROR_BOUNDARY__) {
+			const boundaryState = getErrorBoundaryState(node);
+			const fallback = props?.fallback;
+			const reset = () => {
+				const state = node.__instance?.errorBoundaryState;
+				if (state) {
+					state.error = null;
+					state.notified = false;
+				}
+			};
+			if (boundaryState?.error != null) {
+				renderErrorBoundaryFallbackValueToSink(fallback, boundaryState.error, reset, sink, ctx);
+				return;
+			}
+			try {
+				renderChildrenSyncToSink(normalizeRenderableChildren(props?.children), sink, ctx);
+			} catch (error) {
+				if (boundaryState) {
+					boundaryState.error = error;
+					boundaryState.notified = true;
+				}
+				logger.error("[Askr] ErrorBoundary caught render error:", error);
+				renderErrorBoundaryFallbackValueToSink(fallback, error, reset, sink, ctx);
+			}
+			return;
+		}
 		throw new Error(`renderNodeSyncToSink: unsupported VNode symbol type: ${String(type)}`);
 	}
 	const typeStr = type;
@@ -364,6 +495,33 @@ function verifyExpectedNode(node, state, ctx) {
 			for (let index = 0; index < children.length; index += 1) if (!verifyExpectedNode(children[index], state, ctx)) return false;
 			return true;
 		}
+		if (type === __ERROR_BOUNDARY__) {
+			const boundaryState = getErrorBoundaryState(vnode);
+			const fallback = props?.fallback;
+			const reset = () => {
+				const stateRef = vnode.__instance?.errorBoundaryState;
+				if (stateRef) {
+					stateRef.error = null;
+					stateRef.notified = false;
+				}
+			};
+			const snapshot = {
+				current: state.current,
+				pendingText: state.pendingText
+			};
+			if (boundaryState?.error != null) return verifyRenderableNode(resolveErrorBoundaryFallbackNode(fallback, boundaryState.error, reset), state, ctx);
+			try {
+				if (verifyExpectedChildren(normalizeRenderableChildren(props?.children), state, ctx)) return true;
+			} catch (error) {
+				if (boundaryState) {
+					boundaryState.error = error;
+					boundaryState.notified = true;
+				}
+			}
+			state.current = snapshot.current;
+			state.pendingText = snapshot.pendingText;
+			return verifyRenderableNode(resolveErrorBoundaryFallbackNode(fallback, boundaryState?.error ?? /* @__PURE__ */ new Error("ErrorBoundary render failed"), reset), state, ctx);
+		}
 		if (type !== Fragment) throw new Error(`verifyHydrationSyncForUrl: unsupported VNode symbol type: ${String(type)}`);
 		const children = getRenderableChildren(vnode);
 		if (!children || children.length === 0) return true;
@@ -406,6 +564,14 @@ function verifyHydrationRoot(root, node, ctx) {
 	if (!verifyExpectedNode(node, state, ctx)) return false;
 	return flushPendingText(state) && state.current === null;
 }
+function verifyExpectedChildren(children, state, ctx) {
+	if (!children || children.length === 0) return true;
+	for (let index = 0; index < children.length; index += 1) if (!verifyExpectedNode(children[index], state, ctx)) return false;
+	return true;
+}
+function verifyRenderableNode(value, state, ctx) {
+	return Array.isArray(value) ? verifyExpectedChildren(normalizeRenderableChildren(value), state, ctx) : verifyExpectedNode(value, state, ctx);
+}
 /**
 * Single synchronous SSR entrypoint: render a component to an HTML string.
 * This is strictly synchronous and deterministic. Optionally provide a seed