@askrjs/askr 0.0.44 → 0.0.46

package/dist/foundations/structures/layer.js.map

@@ -1 +1 @@
-{"version":3,"file":"layer.js","names":[],"sources":["../../../src/foundations/structures/layer.ts"],"sourcesContent":["/**\n * createLayer\n *\n * Manages stacking order and coordination for overlays (modals, popovers, etc).\n *\n * INVARIANTS:\n * 1. Layers are ordered by registration time (FIFO)\n * 2. Only the top layer handles Escape key\n * 3. Only the top layer handles outside pointer events\n * 4. Nested layers are supported\n * 5. Does not implement portals (orthogonal concern)\n * 6. No automatic DOM insertion (caller controls mounting)\n *\n * DESIGN:\n * - Returns a layer manager with register/unregister API\n * - Each layer has a unique ID and can query if it's the top layer\n * - Escape and outside pointer coordination via callbacks\n * - No z-index management (CSS concern)\n *\n * USAGE:\n *   const manager = createLayer();\n *\n *   const layer = manager.register({\n *     onEscape: () => { ... },\n *     onOutsidePointer: () => { ... }\n *   });\n *\n *   layer.isTop(); // true if this is the topmost layer\n *   layer.unregister();\n */\n\nexport interface LayerOptions {\n  /**\n   * Called when Escape is pressed and this is the top layer\n   */\n  onEscape?: () => void;\n\n  /**\n   * Called when pointer event occurs outside and this is the top layer\n   */\n  onOutsidePointer?: (e: PointerEvent) => void;\n\n  /**\n   * Optional node reference for outside pointer detection\n   */\n  node?: Node | null;\n}\n\nexport interface Layer {\n  /**\n   * Unique layer ID\n   */\n  id: number;\n\n  /**\n   * Check if this layer is the topmost\n   */\n  isTop(): boolean;\n\n  /**\n   * Remove this layer from the stack\n   */\n  unregister(): void;\n}\n\nexport interface LayerManager {\n  /**\n   * Register a new layer\n   */\n  register(options: LayerOptions): Layer;\n\n  /**\n   * Get all active layers in order\n   */\n  layers(): ReadonlyArray<Layer>;\n\n  /**\n   * Manually trigger escape handling on the top layer\n   */\n  handleEscape(): void;\n\n  /**\n   * Manually trigger outside pointer handling on the top layer\n   */\n  handleOutsidePointer(e: PointerEvent): void;\n}\n\nexport function createLayer(): LayerManager {\n  const stack: Array<{\n    id: number;\n    options: LayerOptions;\n  }> = [];\n\n  let nextId = 1;\n\n  function register(options: LayerOptions): Layer {\n    const id = nextId++;\n    const entry = { id, options };\n    stack.push(entry);\n\n    function isTop(): boolean {\n      return stack[stack.length - 1]?.id === id;\n    }\n\n    function unregister(): void {\n      const index = stack.findIndex((e) => e.id === id);\n      if (index !== -1) {\n        stack.splice(index, 1);\n      }\n    }\n\n    return {\n      id,\n      isTop,\n      unregister,\n    };\n  }\n\n  function layers(): ReadonlyArray<Layer> {\n    return stack.map((entry) => ({\n      id: entry.id,\n      isTop: () => stack[stack.length - 1]?.id === entry.id,\n      unregister: () => {\n        const index = stack.findIndex((e) => e.id === entry.id);\n        if (index !== -1) {\n          stack.splice(index, 1);\n        }\n      },\n    }));\n  }\n\n  function handleEscape(): void {\n    const top = stack[stack.length - 1];\n    if (top) {\n      top.options.onEscape?.();\n    }\n  }\n\n  function handleOutsidePointer(e: PointerEvent): void {\n    const top = stack[stack.length - 1];\n    if (!top) return;\n\n    const node = top.options.node;\n    if (node && e.target instanceof Node) {\n      // Check if the event target is outside the layer node\n      if (!node.contains(e.target)) {\n        top.options.onOutsidePointer?.(e);\n      }\n    } else {\n      // No node provided, always trigger\n      top.options.onOutsidePointer?.(e);\n    }\n  }\n\n  return {\n    register,\n    layers,\n    handleEscape,\n    handleOutsidePointer,\n  };\n}\n\n/**\n * USAGE EXAMPLE:\n *\n * const layerManager = createLayer();\n *\n * function Modal({ onClose }) {\n *   const modalRef = ref<HTMLDivElement>();\n *\n *   const layer = layerManager.register({\n *     node: modalRef.current,\n *     onEscape: onClose,\n *     onOutsidePointer: onClose,\n *   });\n *\n *   onUnmount(() => layer.unregister());\n *\n *   return (\n *     <div ref={modalRef}>\n *       <h1>Modal</h1>\n *       {layer.isTop() && <p>I am on top!</p>}\n *     </div>\n *   );\n * }\n */\n"],"mappings":";AAuFA,SAAgB,cAA4B;CAC1C,MAAM,QAGD,CAAC;CAEN,IAAI,SAAS;CAEb,SAAS,SAAS,SAA8B;EAC9C,MAAM,KAAK;EACX,MAAM,QAAQ;GAAE;GAAI;EAAQ;EAC5B,MAAM,KAAK,KAAK;EAEhB,SAAS,QAAiB;GACxB,OAAO,MAAM,MAAM,SAAS,IAAI,OAAO;EACzC;EAEA,SAAS,aAAmB;GAC1B,MAAM,QAAQ,MAAM,WAAW,MAAM,EAAE,OAAO,EAAE;GAChD,IAAI,UAAU,IACZ,MAAM,OAAO,OAAO,CAAC;EAEzB;EAEA,OAAO;GACL;GACA;GACA;EACF;CACF;CAEA,SAAS,SAA+B;EACtC,OAAO,MAAM,KAAK,WAAW;GAC3B,IAAI,MAAM;GACV,aAAa,MAAM,MAAM,SAAS,IAAI,OAAO,MAAM;GACnD,kBAAkB;IAChB,MAAM,QAAQ,MAAM,WAAW,MAAM,EAAE,OAAO,MAAM,EAAE;IACtD,IAAI,UAAU,IACZ,MAAM,OAAO,OAAO,CAAC;GAEzB;EACF,EAAE;CACJ;CAEA,SAAS,eAAqB;EAC5B,MAAM,MAAM,MAAM,MAAM,SAAS;EACjC,IAAI,KACF,IAAI,QAAQ,WAAW;CAE3B;CAEA,SAAS,qBAAqB,GAAuB;EACnD,MAAM,MAAM,MAAM,MAAM,SAAS;EACjC,IAAI,CAAC,KAAK;EAEV,MAAM,OAAO,IAAI,QAAQ;EACzB,IAAI,QAAQ,EAAE,kBAAkB,MAE9B;OAAI,CAAC,KAAK,SAAS,EAAE,MAAM,GACzB,IAAI,QAAQ,mBAAmB,CAAC;EAClC,OAGA,IAAI,QAAQ,mBAAmB,CAAC;CAEpC;CAEA,OAAO;EACL;EACA;EACA;EACA;CACF;AACF"}
+{"version":3,"file":"layer.js","names":[],"sources":["../../../src/foundations/structures/layer.ts"],"sourcesContent":["/**\n * createLayer\n *\n * Manages stacking order and coordination for overlays (modals, popovers, etc).\n *\n * INVARIANTS:\n * 1. Layers are ordered by registration time (FIFO)\n * 2. Only the top layer handles Escape key\n * 3. Only the top layer handles outside pointer events\n * 4. Nested layers are supported\n * 5. Does not implement portals (orthogonal concern)\n * 6. No automatic DOM insertion (caller controls mounting)\n *\n * DESIGN:\n * - Returns a layer manager with register/unregister API\n * - Each layer has a unique ID and can query if it's the top layer\n * - Escape and outside pointer coordination via callbacks\n * - No z-index management (CSS concern)\n *\n * USAGE:\n *   const manager = createLayer();\n *\n *   const layer = manager.register({\n *     onEscape: () => { ... },\n *     onOutsidePointer: () => { ... }\n *   });\n *\n *   layer.isTop(); // true if this is the topmost layer\n *   layer.unregister();\n */\n\nexport interface LayerOptions {\n  /**\n   * Called when Escape is pressed and this is the top layer\n   */\n  onEscape?: () => void;\n\n  /**\n   * Called when pointer event occurs outside and this is the top layer\n   */\n  onOutsidePointer?: (e: PointerEvent) => void;\n\n  /**\n   * Optional node reference for outside pointer detection\n   */\n  node?: Node | null;\n}\n\nexport interface Layer {\n  /**\n   * Unique layer ID\n   */\n  id: number;\n\n  /**\n   * Check if this layer is the topmost\n   */\n  isTop(): boolean;\n\n  /**\n   * Remove this layer from the stack\n   */\n  unregister(): void;\n}\n\nexport interface LayerManager {\n  /**\n   * Register a new layer\n   */\n  register(options: LayerOptions): Layer;\n\n  /**\n   * Get all active layers in order\n   */\n  layers(): ReadonlyArray<Layer>;\n\n  /**\n   * Manually trigger escape handling on the top layer\n   */\n  handleEscape(): void;\n\n  /**\n   * Manually trigger outside pointer handling on the top layer\n   */\n  handleOutsidePointer(e: PointerEvent): void;\n}\n\nexport function createLayer(): LayerManager {\n  const stack: Array<{\n    id: number;\n    options: LayerOptions;\n  }> = [];\n\n  let nextId = 1;\n\n  function register(options: LayerOptions): Layer {\n    const id = nextId++;\n    const entry = { id, options };\n    stack.push(entry);\n\n    function isTop(): boolean {\n      return stack[stack.length - 1]?.id === id;\n    }\n\n    function unregister(): void {\n      const index = stack.findIndex((e) => e.id === id);\n      if (index !== -1) {\n        stack.splice(index, 1);\n      }\n    }\n\n    return {\n      id,\n      isTop,\n      unregister,\n    };\n  }\n\n  function layers(): ReadonlyArray<Layer> {\n    return stack.map((entry) => ({\n      id: entry.id,\n      isTop: () => stack[stack.length - 1]?.id === entry.id,\n      unregister: () => {\n        const index = stack.findIndex((e) => e.id === entry.id);\n        if (index !== -1) {\n          stack.splice(index, 1);\n        }\n      },\n    }));\n  }\n\n  function handleEscape(): void {\n    const top = stack[stack.length - 1];\n    if (top) {\n      top.options.onEscape?.();\n    }\n  }\n\n  function handleOutsidePointer(e: PointerEvent): void {\n    const top = stack[stack.length - 1];\n    if (!top) return;\n\n    const node = top.options.node;\n    if (node && e.target instanceof Node) {\n      // Check if the event target is outside the layer node\n      if (!node.contains(e.target)) {\n        top.options.onOutsidePointer?.(e);\n      }\n    } else {\n      // No node provided, always trigger\n      top.options.onOutsidePointer?.(e);\n    }\n  }\n\n  return {\n    register,\n    layers,\n    handleEscape,\n    handleOutsidePointer,\n  };\n}\n\n/**\n * USAGE EXAMPLE:\n *\n * const layerManager = createLayer();\n *\n * function Modal({ onClose }) {\n *   const modalRef = ref<HTMLDivElement>();\n *\n *   const layer = layerManager.register({\n *     node: modalRef.current,\n *     onEscape: onClose,\n *     onOutsidePointer: onClose,\n *   });\n *\n *   onUnmount(() => layer.unregister());\n *\n *   return (\n *     <div ref={modalRef}>\n *       <h1>Modal</h1>\n *       {layer.isTop() && <p>I am on top!</p>}\n *     </div>\n *   );\n * }\n */\n"],"mappings":";AAuFA,SAAgB,cAA4B;CAC1C,MAAM,QAGD,CAAC;CAEN,IAAI,SAAS;CAEb,SAAS,SAAS,SAA8B;EAC9C,MAAM,KAAK;EACX,MAAM,QAAQ;GAAE;GAAI;EAAQ;EAC5B,MAAM,KAAK,KAAK;EAEhB,SAAS,QAAiB;GACxB,OAAO,MAAM,MAAM,SAAS,EAAE,EAAE,OAAO;EACzC;EAEA,SAAS,aAAmB;GAC1B,MAAM,QAAQ,MAAM,WAAW,MAAM,EAAE,OAAO,EAAE;GAChD,IAAI,UAAU,IACZ,MAAM,OAAO,OAAO,CAAC;EAEzB;EAEA,OAAO;GACL;GACA;GACA;EACF;CACF;CAEA,SAAS,SAA+B;EACtC,OAAO,MAAM,KAAK,WAAW;GAC3B,IAAI,MAAM;GACV,aAAa,MAAM,MAAM,SAAS,EAAE,EAAE,OAAO,MAAM;GACnD,kBAAkB;IAChB,MAAM,QAAQ,MAAM,WAAW,MAAM,EAAE,OAAO,MAAM,EAAE;IACtD,IAAI,UAAU,IACZ,MAAM,OAAO,OAAO,CAAC;GAEzB;EACF,EAAE;CACJ;CAEA,SAAS,eAAqB;EAC5B,MAAM,MAAM,MAAM,MAAM,SAAS;EACjC,IAAI,KACF,IAAI,QAAQ,WAAW;CAE3B;CAEA,SAAS,qBAAqB,GAAuB;EACnD,MAAM,MAAM,MAAM,MAAM,SAAS;EACjC,IAAI,CAAC,KAAK;EAEV,MAAM,OAAO,IAAI,QAAQ;EACzB,IAAI,QAAQ,EAAE,kBAAkB,MAE9B;OAAI,CAAC,KAAK,SAAS,EAAE,MAAM,GACzB,IAAI,QAAQ,mBAAmB,CAAC;EAClC,OAGA,IAAI,QAAQ,mBAAmB,CAAC;CAEpC;CAEA,OAAO;EACL;EACA;EACA;EACA;CACF;AACF"}

package/dist/foundations/structures/portal.js.map

@@ -1 +1 @@
-{"version":3,"file":"portal.js","names":[],"sources":["../../../src/foundations/structures/portal.tsx"],"sourcesContent":["/**\n * Portal / Host primitive.\n *\n * Foundations remain runtime-agnostic: a portal is an explicit read/write slot.\n * Scheduling and attachment are owned by the runtime when `createPortalSlot`\n * exists; otherwise this falls back to a local slot (deterministic, but does\n * not schedule updates).\n *\n * POLICY DECISIONS (LOCKED):\n *\n * 1. Local Mutable State\n *    Foundations may use local mutable state ONLY to model deterministic slots,\n *    never to coordinate timing, effects, or ordering. The fallback mode uses\n *    closure-local `mounted` and `value` variables which are non-escaping and\n *    deterministic.\n *\n * 2. Return Type Philosophy\n *    Portal call signatures return `unknown` (intentionally opaque). The runtime\n *    owns the concrete type. This prevents foundations from assuming JSX.Element\n *    or DOM node types, maintaining runtime-agnostic portability.\n */\n\nimport {\n  markReactivePropsDirtySource,\n  markReadableDerivedSubscribersDirty,\n  notifyReadableReaders,\n  recordReadableRead,\n  type ReadableSource,\n} from '../../runtime/readable';\nimport {\n  getCurrentComponentInstance,\n  getCurrentPortalScope,\n  type ComponentInstance,\n} from '../../runtime/component';\nimport type { RenderableChild } from '../../common/vnode';\n\nexport interface Portal<T extends RenderableChild = RenderableChild> {\n  /** Mount point — rendered exactly once */\n  (): unknown;\n\n  /** Render content into the portal */\n  render(props: { children?: T }): unknown;\n}\n\nexport interface PortalProps {\n  children?: RenderableChild;\n}\n\nfunction createPortalSlot<T>(): {\n  read(): unknown;\n  write(value: T | undefined): void;\n} {\n  let currentValue: T | undefined;\n\n  const source = (() => {\n    recordReadableRead(source);\n    return currentValue;\n  }) as ReadableSource<T | undefined>;\n\n  return {\n    read() {\n      return source();\n    },\n    write(value: T | undefined) {\n      if (Object.is(currentValue, value)) {\n        return;\n      }\n\n      currentValue = value;\n      markReadableDerivedSubscribersDirty(source);\n      markReactivePropsDirtySource(source);\n      notifyReadableReaders(source);\n    },\n  };\n}\n\nexport function definePortal<\n  T extends RenderableChild = RenderableChild,\n>(): Portal<T> {\n  // Using `typeof createPortalSlot` is safe even if the identifier is not\n  // defined at runtime (it returns 'undefined' rather than throwing).\n  if (typeof createPortalSlot === 'function') {\n    const slot = createPortalSlot<T>();\n\n    function PortalHost() {\n      return slot.read();\n    }\n\n    PortalHost.render = function PortalRender(props: { children?: T }) {\n      slot.write(props.children);\n      return null;\n    };\n\n    return PortalHost as Portal<T>;\n  }\n\n  // Deterministic local fallback (SSR/tests). No runtime scheduling.\n  // Writes are accepted only after the host has rendered at least once.\n  //\n  // CRITICAL BEHAVIOR:\n  // - Writes update local state but do NOT trigger re-renders\n  // - The portal host will reflect changes only when the component tree\n  //   re-renders for other reasons (e.g., parent state change)\n  // - This is safe for SSR and tests where rendering is synchronous\n  //   and externally controlled\n  // - In runtime mode, createPortalSlot handles scheduling automatically\n  let mounted = false;\n  let value: T | undefined;\n\n  function PortalHostFallback() {\n    mounted = true;\n    return value as unknown;\n  }\n\n  PortalHostFallback.render = function PortalRenderFallback(props: {\n    children?: T;\n  }) {\n    if (!mounted) return null;\n    value = props.children;\n    return null;\n  };\n\n  return PortalHostFallback as Portal<T>;\n}\n\ntype DefaultPortalState = {\n  portal: Portal<RenderableChild>;\n  owner: ComponentInstance | null;\n  cleanupOwners: WeakSet<ComponentInstance>;\n};\n\nlet _defaultPortalStates = new Map<object, DefaultPortalState>();\nlet _hasPendingDefaultPortalValue = false;\nlet _pendingDefaultPortalValue: RenderableChild | undefined = undefined;\n\nexport function _resetDefaultPortal(): void {\n  _defaultPortalStates = new Map<object, DefaultPortalState>();\n  _hasPendingDefaultPortalValue = false;\n  _pendingDefaultPortalValue = undefined;\n}\n\nexport function disposeDefaultPortalScope(scope: object | null): void {\n  if (!scope) {\n    return;\n  }\n\n  const state = _defaultPortalStates.get(scope);\n  if (state) {\n    state.portal.render({ children: undefined });\n  }\n\n  _defaultPortalStates.delete(scope);\n}\n\nfunction isComponentPortalScope(scope: object): scope is ComponentInstance {\n  return Array.isArray((scope as ComponentInstance).cleanupFns);\n}\n\nfunction isStaleDefaultPortalScope(scope: object): boolean {\n  if (!isComponentPortalScope(scope)) {\n    return false;\n  }\n\n  if (scope.target && scope.target.isConnected === false) {\n    return true;\n  }\n\n  return scope.mounted === false;\n}\n\nfunction pruneStaleDefaultPortalScopes(): void {\n  if (_defaultPortalStates.size === 0) {\n    return;\n  }\n\n  for (const scope of Array.from(_defaultPortalStates.keys())) {\n    if (isStaleDefaultPortalScope(scope)) {\n      disposeDefaultPortalScope(scope);\n    }\n  }\n}\n\nfunction getSingleDefaultPortalScope(): object | null {\n  pruneStaleDefaultPortalScopes();\n\n  if (_defaultPortalStates.size !== 1) {\n    return null;\n  }\n\n  return _defaultPortalStates.keys().next().value ?? null;\n}\n\nfunction getDefaultPortalState(scope: object): DefaultPortalState {\n  let state = _defaultPortalStates.get(scope);\n  if (!state) {\n    state = {\n      portal: definePortal<RenderableChild>(),\n      owner: null,\n      cleanupOwners: new WeakSet<ComponentInstance>(),\n    };\n    _defaultPortalStates.set(scope, state);\n  }\n  return state;\n}\n\nfunction resolveDefaultPortalScope(\n  owner: ComponentInstance | null\n): object | null {\n  return (\n    owner?.portalScope ??\n    getCurrentPortalScope() ??\n    getSingleDefaultPortalScope()\n  );\n}\n\nfunction writeDefaultPortal(\n  props: PortalProps,\n  owner: ComponentInstance | null\n): void {\n  const scope = resolveDefaultPortalScope(owner);\n  if (!scope) {\n    if (_defaultPortalStates.size !== 0) {\n      return;\n    }\n\n    _hasPendingDefaultPortalValue = true;\n    _pendingDefaultPortalValue = props.children;\n    return;\n  }\n\n  const state = getDefaultPortalState(scope);\n  _hasPendingDefaultPortalValue = false;\n  _pendingDefaultPortalValue = undefined;\n  state.portal.render(props);\n  state.owner = owner;\n}\n\nfunction applyPendingDefaultPortalValue(scope: object): void {\n  if (!_hasPendingDefaultPortalValue) {\n    return;\n  }\n\n  const state = getDefaultPortalState(scope);\n  state.portal.render({ children: _pendingDefaultPortalValue });\n  state.owner = null;\n  _hasPendingDefaultPortalValue = false;\n  _pendingDefaultPortalValue = undefined;\n}\n\nfunction registerDefaultPortalOwner(owner: ComponentInstance): void {\n  const scope = resolveDefaultPortalScope(owner);\n  if (!scope) {\n    return;\n  }\n\n  const state = getDefaultPortalState(scope);\n  if (state.cleanupOwners.has(owner)) {\n    return;\n  }\n\n  state.cleanupOwners.add(owner);\n  owner.cleanupFns.push(() => {\n    const currentState = _defaultPortalStates.get(scope);\n    if (!currentState) {\n      return;\n    }\n\n    if (currentState.owner === owner) {\n      currentState.portal.render({ children: undefined });\n      currentState.owner = null;\n    }\n    currentState.cleanupOwners.delete(owner);\n  });\n}\n\nexport function clearDefaultPortalForInstance(\n  instance: ComponentInstance\n): void {\n  const scope = instance.portalScope;\n  if (!scope) {\n    return;\n  }\n\n  const state = _defaultPortalStates.get(scope);\n  if (!state) {\n    return;\n  }\n\n  _hasPendingDefaultPortalValue = false;\n  _pendingDefaultPortalValue = undefined;\n  state.portal.render({ children: undefined });\n  state.owner = null;\n}\n\nexport const DefaultPortal: Portal<RenderableChild> = (() => {\n  function Host() {\n    const scope = resolveDefaultPortalScope(getCurrentComponentInstance());\n    if (!scope) {\n      return null;\n    }\n\n    applyPendingDefaultPortalValue(scope);\n    const v = getDefaultPortalState(scope).portal();\n    return v === undefined ? null : v;\n  }\n  Host.render = function Render(props: { children?: RenderableChild }) {\n    writeDefaultPortal(props, getCurrentComponentInstance());\n    return null;\n  };\n  return Host as Portal<RenderableChild>;\n})();\n\nexport function Portal(props: PortalProps): null {\n  const owner = getCurrentComponentInstance();\n  if (owner) {\n    registerDefaultPortalOwner(owner);\n  }\n  writeDefaultPortal(props, owner);\n  return null;\n}\n\n/**\n * NOTE:\n * createPortalSlot is a runtime primitive.\n * It owns scheduling, consistency, and SSR behavior.\n */\n"],"mappings":"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"}
+{"version":3,"file":"portal.js","names":[],"sources":["../../../src/foundations/structures/portal.tsx"],"sourcesContent":["/**\n * Portal / Host primitive.\n *\n * Foundations remain runtime-agnostic: a portal is an explicit read/write slot.\n * Scheduling and attachment are owned by the runtime when `createPortalSlot`\n * exists; otherwise this falls back to a local slot (deterministic, but does\n * not schedule updates).\n *\n * POLICY DECISIONS (LOCKED):\n *\n * 1. Local Mutable State\n *    Foundations may use local mutable state ONLY to model deterministic slots,\n *    never to coordinate timing, effects, or ordering. The fallback mode uses\n *    closure-local `mounted` and `value` variables which are non-escaping and\n *    deterministic.\n *\n * 2. Return Type Philosophy\n *    Portal call signatures return `unknown` (intentionally opaque). The runtime\n *    owns the concrete type. This prevents foundations from assuming JSX.Element\n *    or DOM node types, maintaining runtime-agnostic portability.\n */\n\nimport {\n  markReactivePropsDirtySource,\n  markReadableDerivedSubscribersDirty,\n  notifyReadableReaders,\n  recordReadableRead,\n  type ReadableSource,\n} from '../../runtime/readable';\nimport {\n  getCurrentComponentInstance,\n  getCurrentPortalScope,\n  type ComponentInstance,\n} from '../../runtime/component';\nimport type { RenderableChild } from '../../common/vnode';\n\nexport interface Portal<T extends RenderableChild = RenderableChild> {\n  /** Mount point — rendered exactly once */\n  (): unknown;\n\n  /** Render content into the portal */\n  render(props: { children?: T }): unknown;\n}\n\nexport interface PortalProps {\n  children?: RenderableChild;\n}\n\nfunction createPortalSlot<T>(): {\n  read(): unknown;\n  write(value: T | undefined): void;\n} {\n  let currentValue: T | undefined;\n\n  const source = (() => {\n    recordReadableRead(source);\n    return currentValue;\n  }) as ReadableSource<T | undefined>;\n\n  return {\n    read() {\n      return source();\n    },\n    write(value: T | undefined) {\n      if (Object.is(currentValue, value)) {\n        return;\n      }\n\n      currentValue = value;\n      markReadableDerivedSubscribersDirty(source);\n      markReactivePropsDirtySource(source);\n      notifyReadableReaders(source);\n    },\n  };\n}\n\nexport function definePortal<\n  T extends RenderableChild = RenderableChild,\n>(): Portal<T> {\n  // Using `typeof createPortalSlot` is safe even if the identifier is not\n  // defined at runtime (it returns 'undefined' rather than throwing).\n  if (typeof createPortalSlot === 'function') {\n    const slot = createPortalSlot<T>();\n\n    function PortalHost() {\n      return slot.read();\n    }\n\n    PortalHost.render = function PortalRender(props: { children?: T }) {\n      slot.write(props.children);\n      return null;\n    };\n\n    return PortalHost as Portal<T>;\n  }\n\n  // Deterministic local fallback (SSR/tests). No runtime scheduling.\n  // Writes are accepted only after the host has rendered at least once.\n  //\n  // CRITICAL BEHAVIOR:\n  // - Writes update local state but do NOT trigger re-renders\n  // - The portal host will reflect changes only when the component tree\n  //   re-renders for other reasons (e.g., parent state change)\n  // - This is safe for SSR and tests where rendering is synchronous\n  //   and externally controlled\n  // - In runtime mode, createPortalSlot handles scheduling automatically\n  let mounted = false;\n  let value: T | undefined;\n\n  function PortalHostFallback() {\n    mounted = true;\n    return value as unknown;\n  }\n\n  PortalHostFallback.render = function PortalRenderFallback(props: {\n    children?: T;\n  }) {\n    if (!mounted) return null;\n    value = props.children;\n    return null;\n  };\n\n  return PortalHostFallback as Portal<T>;\n}\n\ntype DefaultPortalState = {\n  portal: Portal<RenderableChild>;\n  owner: ComponentInstance | null;\n  cleanupOwners: WeakSet<ComponentInstance>;\n};\n\nlet _defaultPortalStates = new Map<object, DefaultPortalState>();\nlet _hasPendingDefaultPortalValue = false;\nlet _pendingDefaultPortalValue: RenderableChild | undefined = undefined;\n\nexport function _resetDefaultPortal(): void {\n  _defaultPortalStates = new Map<object, DefaultPortalState>();\n  _hasPendingDefaultPortalValue = false;\n  _pendingDefaultPortalValue = undefined;\n}\n\nexport function disposeDefaultPortalScope(scope: object | null): void {\n  if (!scope) {\n    return;\n  }\n\n  const state = _defaultPortalStates.get(scope);\n  if (state) {\n    state.portal.render({ children: undefined });\n  }\n\n  _defaultPortalStates.delete(scope);\n}\n\nfunction isComponentPortalScope(scope: object): scope is ComponentInstance {\n  return Array.isArray((scope as ComponentInstance).cleanupFns);\n}\n\nfunction isStaleDefaultPortalScope(scope: object): boolean {\n  if (!isComponentPortalScope(scope)) {\n    return false;\n  }\n\n  if (scope.target && scope.target.isConnected === false) {\n    return true;\n  }\n\n  return scope.mounted === false;\n}\n\nfunction pruneStaleDefaultPortalScopes(): void {\n  if (_defaultPortalStates.size === 0) {\n    return;\n  }\n\n  for (const scope of Array.from(_defaultPortalStates.keys())) {\n    if (isStaleDefaultPortalScope(scope)) {\n      disposeDefaultPortalScope(scope);\n    }\n  }\n}\n\nfunction getSingleDefaultPortalScope(): object | null {\n  pruneStaleDefaultPortalScopes();\n\n  if (_defaultPortalStates.size !== 1) {\n    return null;\n  }\n\n  return _defaultPortalStates.keys().next().value ?? null;\n}\n\nfunction getDefaultPortalState(scope: object): DefaultPortalState {\n  let state = _defaultPortalStates.get(scope);\n  if (!state) {\n    state = {\n      portal: definePortal<RenderableChild>(),\n      owner: null,\n      cleanupOwners: new WeakSet<ComponentInstance>(),\n    };\n    _defaultPortalStates.set(scope, state);\n  }\n  return state;\n}\n\nfunction resolveDefaultPortalScope(\n  owner: ComponentInstance | null\n): object | null {\n  return (\n    owner?.portalScope ??\n    getCurrentPortalScope() ??\n    getSingleDefaultPortalScope()\n  );\n}\n\nfunction writeDefaultPortal(\n  props: PortalProps,\n  owner: ComponentInstance | null\n): void {\n  const scope = resolveDefaultPortalScope(owner);\n  if (!scope) {\n    if (_defaultPortalStates.size !== 0) {\n      return;\n    }\n\n    _hasPendingDefaultPortalValue = true;\n    _pendingDefaultPortalValue = props.children;\n    return;\n  }\n\n  const state = getDefaultPortalState(scope);\n  _hasPendingDefaultPortalValue = false;\n  _pendingDefaultPortalValue = undefined;\n  state.portal.render(props);\n  state.owner = owner;\n}\n\nfunction applyPendingDefaultPortalValue(scope: object): void {\n  if (!_hasPendingDefaultPortalValue) {\n    return;\n  }\n\n  const state = getDefaultPortalState(scope);\n  state.portal.render({ children: _pendingDefaultPortalValue });\n  state.owner = null;\n  _hasPendingDefaultPortalValue = false;\n  _pendingDefaultPortalValue = undefined;\n}\n\nfunction registerDefaultPortalOwner(owner: ComponentInstance): void {\n  const scope = resolveDefaultPortalScope(owner);\n  if (!scope) {\n    return;\n  }\n\n  const state = getDefaultPortalState(scope);\n  if (state.cleanupOwners.has(owner)) {\n    return;\n  }\n\n  state.cleanupOwners.add(owner);\n  owner.cleanupFns.push(() => {\n    const currentState = _defaultPortalStates.get(scope);\n    if (!currentState) {\n      return;\n    }\n\n    if (currentState.owner === owner) {\n      currentState.portal.render({ children: undefined });\n      currentState.owner = null;\n    }\n    currentState.cleanupOwners.delete(owner);\n  });\n}\n\nexport function clearDefaultPortalForInstance(\n  instance: ComponentInstance\n): void {\n  const scope = instance.portalScope;\n  if (!scope) {\n    return;\n  }\n\n  const state = _defaultPortalStates.get(scope);\n  if (!state) {\n    return;\n  }\n\n  _hasPendingDefaultPortalValue = false;\n  _pendingDefaultPortalValue = undefined;\n  state.portal.render({ children: undefined });\n  state.owner = null;\n}\n\nexport const DefaultPortal: Portal<RenderableChild> = (() => {\n  function Host() {\n    const scope = resolveDefaultPortalScope(getCurrentComponentInstance());\n    if (!scope) {\n      return null;\n    }\n\n    applyPendingDefaultPortalValue(scope);\n    const v = getDefaultPortalState(scope).portal();\n    return v === undefined ? null : v;\n  }\n  Host.render = function Render(props: { children?: RenderableChild }) {\n    writeDefaultPortal(props, getCurrentComponentInstance());\n    return null;\n  };\n  return Host as Portal<RenderableChild>;\n})();\n\nexport function Portal(props: PortalProps): null {\n  const owner = getCurrentComponentInstance();\n  if (owner) {\n    registerDefaultPortalOwner(owner);\n  }\n  writeDefaultPortal(props, owner);\n  return null;\n}\n\n/**\n * NOTE:\n * createPortalSlot is a runtime primitive.\n * It owns scheduling, consistency, and SSR behavior.\n */\n"],"mappings":"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"}

package/dist/fx/fx.js.map

@@ -1 +1 @@
-{"version":3,"file":"fx.js","names":[],"sources":["../../src/fx/fx.ts"],"sourcesContent":["import { globalScheduler } from '../runtime/scheduler';\nimport { getCurrentComponentInstance } from '../runtime/component';\nimport { logger } from '../dev/logger';\nimport { noopEventListener, noopEventListenerWithFlush } from './noop';\n\nexport type CancelFn = () => void;\n\n// Platform-specific timer handle types\ntype TimeoutHandle = ReturnType<typeof setTimeout> | null;\n// rAF may fall back to setTimeout in some environments/tests, include both\ntype RafHandle =\n  | ReturnType<typeof requestAnimationFrame>\n  | ReturnType<typeof setTimeout>\n  | null;\n// requestIdleCallback may be unavailable; allow setTimeout fallback handle\ntype IdleHandle =\n  | ReturnType<typeof requestIdleCallback>\n  | ReturnType<typeof setTimeout>\n  | null;\n\nfunction throwIfDuringRender(): void {\n  const inst = getCurrentComponentInstance();\n  if (inst !== null) {\n    throw new Error(\n      '[Askr] calling FX handler during render is not allowed. Move calls to event handlers or effects.'\n    );\n  }\n}\n\n/**\n * Helper: schedule a user callback through the global scheduler\n */\nfunction enqueueUserCallback(fn: () => void) {\n  globalScheduler.enqueue(() => {\n    try {\n      fn();\n    } catch (err) {\n      // Keep behavior consistent with other scheduler-queued work\n      logger.error('[Askr] FX handler error:', err);\n    }\n  });\n}\n\n// ---------- Event handlers ----------\n\nexport function debounceEvent(\n  ms: number,\n  handler: EventListener,\n  options?: { leading?: boolean; trailing?: boolean }\n): EventListener & { cancel(): void; flush(): void } {\n  const { leading = false, trailing = true } = options || {};\n\n  const inst = getCurrentComponentInstance();\n  // On SSR, event handlers are inert\n  if (inst && inst.ssr) {\n    return noopEventListenerWithFlush;\n  }\n\n  let timeoutId: TimeoutHandle = null;\n  let lastEvent: Event | null = null;\n  let lastCallTime = 0;\n\n  const debounced = function (this: unknown, ev: Event) {\n    // Disallow using returned handler during render\n    throwIfDuringRender();\n\n    const now = Date.now();\n    lastEvent = ev;\n\n    if (timeoutId !== null) {\n      clearTimeout(timeoutId);\n      timeoutId = null;\n    }\n\n    if (leading && now - lastCallTime >= ms) {\n      enqueueUserCallback(() => handler.call(null, ev));\n      lastCallTime = now;\n    }\n\n    if (trailing) {\n      timeoutId = setTimeout(() => {\n        // Schedule through scheduler\n        if (lastEvent) {\n          enqueueUserCallback(() => handler.call(null, lastEvent!));\n        }\n        timeoutId = null;\n        lastCallTime = Date.now();\n      }, ms);\n    }\n  } as EventListener & { cancel(): void; flush(): void };\n\n  debounced.cancel = () => {\n    if (timeoutId !== null) {\n      clearTimeout(timeoutId);\n      timeoutId = null;\n    }\n    lastEvent = null;\n  };\n\n  debounced.flush = () => {\n    if (timeoutId !== null) {\n      clearTimeout(timeoutId);\n      const ev = lastEvent;\n      lastEvent = null;\n      timeoutId = null;\n      if (ev) enqueueUserCallback(() => handler.call(null, ev));\n    }\n  };\n\n  // Auto-cleanup on component unmount\n  if (inst) {\n    (inst.cleanupFns ??= []).push(() => {\n      debounced.cancel();\n    });\n  }\n\n  return debounced;\n}\n\nexport function throttleEvent(\n  ms: number,\n  handler: EventListener,\n  options?: { leading?: boolean; trailing?: boolean }\n): EventListener & { cancel(): void } {\n  const { leading = true, trailing = true } = options || {};\n\n  const inst = getCurrentComponentInstance();\n  if (inst && inst.ssr) {\n    return noopEventListener;\n  }\n\n  let lastCallTime = 0;\n  let timeoutId: TimeoutHandle = null;\n  let lastEvent: Event | null = null;\n\n  const throttled = function (this: unknown, ev: Event) {\n    throwIfDuringRender();\n\n    const now = Date.now();\n    lastEvent = ev;\n\n    if (leading && now - lastCallTime >= ms) {\n      enqueueUserCallback(() => handler.call(null, ev));\n      lastCallTime = now;\n      if (timeoutId !== null) {\n        clearTimeout(timeoutId);\n        timeoutId = null;\n      }\n    } else if (!leading && lastCallTime === 0) {\n      lastCallTime = now;\n    }\n\n    if (trailing && timeoutId === null) {\n      const wait = ms - (now - lastCallTime);\n      timeoutId = setTimeout(\n        () => {\n          if (lastEvent)\n            enqueueUserCallback(() => handler.call(null, lastEvent!));\n          lastCallTime = Date.now();\n          timeoutId = null;\n        },\n        Math.max(0, wait)\n      );\n    }\n  } as EventListener & { cancel(): void };\n\n  throttled.cancel = () => {\n    if (timeoutId !== null) {\n      clearTimeout(timeoutId);\n      timeoutId = null;\n    }\n    lastEvent = null;\n  };\n\n  if (inst) {\n    (inst.cleanupFns ??= []).push(() => throttled.cancel());\n  }\n\n  return throttled;\n}\n\nexport function rafEvent(\n  handler: EventListener\n): EventListener & { cancel(): void } {\n  const inst = getCurrentComponentInstance();\n  if (inst && inst.ssr) {\n    return noopEventListener;\n  }\n\n  let frameId: RafHandle = null;\n  let lastEvent: Event | null = null;\n\n  const scheduleFrame = () => {\n    const rAF =\n      typeof requestAnimationFrame !== 'undefined'\n        ? requestAnimationFrame\n        : (cb: FrameRequestCallback) => setTimeout(() => cb(Date.now()), 16);\n\n    frameId = rAF(() => {\n      frameId = null;\n      if (lastEvent) {\n        const ev = lastEvent;\n        lastEvent = null;\n        enqueueUserCallback(() => handler.call(null, ev));\n      }\n    });\n  };\n\n  const fn = function (this: unknown, ev: Event) {\n    throwIfDuringRender();\n    lastEvent = ev;\n    if (frameId === null) scheduleFrame();\n  } as EventListener & { cancel(): void };\n\n  fn.cancel = () => {\n    if (frameId !== null) {\n      // If frameId is numeric and cancelAnimationFrame is available, use it;\n      // otherwise fall back to clearTimeout for the setTimeout fallback.\n      if (\n        typeof cancelAnimationFrame !== 'undefined' &&\n        typeof frameId === 'number'\n      ) {\n        cancelAnimationFrame(frameId);\n      } else {\n        clearTimeout(frameId as ReturnType<typeof setTimeout>);\n      }\n      frameId = null;\n    }\n    lastEvent = null;\n  };\n\n  if (inst) (inst.cleanupFns ??= []).push(() => fn.cancel());\n\n  return fn;\n}\n\n// ---------- Scheduled work ----------\n\nexport function scheduleTimeout(ms: number, fn: () => void): CancelFn {\n  throwIfDuringRender();\n  const inst = getCurrentComponentInstance();\n  if (inst && inst.ssr) {\n    return () => {};\n  }\n\n  let id: TimeoutHandle = setTimeout(() => {\n    id = null;\n    enqueueUserCallback(fn);\n  }, ms);\n\n  const cancel = () => {\n    if (id !== null) {\n      clearTimeout(id);\n      id = null;\n    }\n  };\n\n  if (inst) (inst.cleanupFns ??= []).push(cancel);\n  return cancel;\n}\n\nexport function scheduleIdle(\n  fn: () => void,\n  options?: { timeout?: number }\n): CancelFn {\n  throwIfDuringRender();\n  const inst = getCurrentComponentInstance();\n  if (inst && inst.ssr) return () => {};\n\n  let id: IdleHandle = null;\n  let usingRIC = false;\n\n  if (typeof requestIdleCallback !== 'undefined') {\n    usingRIC = true;\n    id = requestIdleCallback(() => {\n      id = null;\n      enqueueUserCallback(fn);\n    }, options);\n  } else {\n    // Fallback: schedule on next macrotask\n    id = setTimeout(() => {\n      id = null;\n      enqueueUserCallback(fn);\n    }, 0);\n  }\n\n  const cancel = () => {\n    if (id !== null) {\n      // If using requestIdleCallback and available, call cancelIdleCallback for numeric ids.\n      if (\n        usingRIC &&\n        typeof cancelIdleCallback !== 'undefined' &&\n        typeof id === 'number'\n      ) {\n        cancelIdleCallback(id);\n      } else {\n        clearTimeout(id as ReturnType<typeof setTimeout>);\n      }\n      id = null;\n    }\n  };\n\n  if (inst) (inst.cleanupFns ??= []).push(cancel);\n  return cancel;\n}\n\nexport interface RetryOptions {\n  maxAttempts?: number;\n  delayMs?: number;\n  backoff?: (attemptIndex: number) => number;\n}\n\nexport function scheduleRetry<T>(\n  fn: () => Promise<T>,\n  options?: RetryOptions\n): { cancel(): void } {\n  throwIfDuringRender();\n  const inst = getCurrentComponentInstance();\n  if (inst && inst.ssr) return { cancel: () => {} };\n\n  const {\n    maxAttempts = 3,\n    delayMs = 100,\n    backoff = (i: number) => delayMs * Math.pow(2, i),\n  } = options || {};\n\n  let cancelled = false;\n\n  const attempt = (index: number) => {\n    if (cancelled) return;\n    // Run user fn inside scheduler\n    globalScheduler.enqueue(() => {\n      if (cancelled) return;\n      // Call fn (it may be async)\n      const p = fn();\n      p.then(\n        () => {\n          // Completed successfully\n        },\n        () => {\n          if (cancelled) return;\n          if (index + 1 < maxAttempts) {\n            const delay = backoff(index);\n            // Schedule next attempt via setTimeout so it gets enqueued through scheduleTimeout\n            setTimeout(() => {\n              attempt(index + 1);\n            }, delay);\n          }\n        }\n      ).catch((e) => {\n        logger.error('[Askr] scheduleRetry error:', e);\n      });\n    });\n  };\n\n  // Start first attempt\n  attempt(0);\n\n  const cancel = () => {\n    cancelled = true;\n  };\n\n  if (inst) (inst.cleanupFns ??= []).push(cancel);\n  return { cancel };\n}\n"],"mappings":"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"}
+{"version":3,"file":"fx.js","names":[],"sources":["../../src/fx/fx.ts"],"sourcesContent":["import { globalScheduler } from '../runtime/scheduler';\nimport { getCurrentComponentInstance } from '../runtime/component';\nimport { logger } from '../dev/logger';\nimport { noopEventListener, noopEventListenerWithFlush } from './noop';\n\nexport type CancelFn = () => void;\n\n// Platform-specific timer handle types\ntype TimeoutHandle = ReturnType<typeof setTimeout> | null;\n// rAF may fall back to setTimeout in some environments/tests, include both\ntype RafHandle =\n  | ReturnType<typeof requestAnimationFrame>\n  | ReturnType<typeof setTimeout>\n  | null;\n// requestIdleCallback may be unavailable; allow setTimeout fallback handle\ntype IdleHandle =\n  | ReturnType<typeof requestIdleCallback>\n  | ReturnType<typeof setTimeout>\n  | null;\n\nfunction throwIfDuringRender(): void {\n  const inst = getCurrentComponentInstance();\n  if (inst !== null) {\n    throw new Error(\n      '[Askr] calling FX handler during render is not allowed. Move calls to event handlers or effects.'\n    );\n  }\n}\n\n/**\n * Helper: schedule a user callback through the global scheduler\n */\nfunction enqueueUserCallback(fn: () => void) {\n  globalScheduler.enqueue(() => {\n    try {\n      fn();\n    } catch (err) {\n      // Keep behavior consistent with other scheduler-queued work\n      logger.error('[Askr] FX handler error:', err);\n    }\n  });\n}\n\n// ---------- Event handlers ----------\n\nexport function debounceEvent(\n  ms: number,\n  handler: EventListener,\n  options?: { leading?: boolean; trailing?: boolean }\n): EventListener & { cancel(): void; flush(): void } {\n  const { leading = false, trailing = true } = options || {};\n\n  const inst = getCurrentComponentInstance();\n  // On SSR, event handlers are inert\n  if (inst && inst.ssr) {\n    return noopEventListenerWithFlush;\n  }\n\n  let timeoutId: TimeoutHandle = null;\n  let lastEvent: Event | null = null;\n  let lastCallTime = 0;\n\n  const debounced = function (this: unknown, ev: Event) {\n    // Disallow using returned handler during render\n    throwIfDuringRender();\n\n    const now = Date.now();\n    lastEvent = ev;\n\n    if (timeoutId !== null) {\n      clearTimeout(timeoutId);\n      timeoutId = null;\n    }\n\n    if (leading && now - lastCallTime >= ms) {\n      enqueueUserCallback(() => handler.call(null, ev));\n      lastCallTime = now;\n    }\n\n    if (trailing) {\n      timeoutId = setTimeout(() => {\n        // Schedule through scheduler\n        if (lastEvent) {\n          enqueueUserCallback(() => handler.call(null, lastEvent!));\n        }\n        timeoutId = null;\n        lastCallTime = Date.now();\n      }, ms);\n    }\n  } as EventListener & { cancel(): void; flush(): void };\n\n  debounced.cancel = () => {\n    if (timeoutId !== null) {\n      clearTimeout(timeoutId);\n      timeoutId = null;\n    }\n    lastEvent = null;\n  };\n\n  debounced.flush = () => {\n    if (timeoutId !== null) {\n      clearTimeout(timeoutId);\n      const ev = lastEvent;\n      lastEvent = null;\n      timeoutId = null;\n      if (ev) enqueueUserCallback(() => handler.call(null, ev));\n    }\n  };\n\n  // Auto-cleanup on component unmount\n  if (inst) {\n    (inst.cleanupFns ??= []).push(() => {\n      debounced.cancel();\n    });\n  }\n\n  return debounced;\n}\n\nexport function throttleEvent(\n  ms: number,\n  handler: EventListener,\n  options?: { leading?: boolean; trailing?: boolean }\n): EventListener & { cancel(): void } {\n  const { leading = true, trailing = true } = options || {};\n\n  const inst = getCurrentComponentInstance();\n  if (inst && inst.ssr) {\n    return noopEventListener;\n  }\n\n  let lastCallTime = 0;\n  let timeoutId: TimeoutHandle = null;\n  let lastEvent: Event | null = null;\n\n  const throttled = function (this: unknown, ev: Event) {\n    throwIfDuringRender();\n\n    const now = Date.now();\n    lastEvent = ev;\n\n    if (leading && now - lastCallTime >= ms) {\n      enqueueUserCallback(() => handler.call(null, ev));\n      lastCallTime = now;\n      if (timeoutId !== null) {\n        clearTimeout(timeoutId);\n        timeoutId = null;\n      }\n    } else if (!leading && lastCallTime === 0) {\n      lastCallTime = now;\n    }\n\n    if (trailing && timeoutId === null) {\n      const wait = ms - (now - lastCallTime);\n      timeoutId = setTimeout(\n        () => {\n          if (lastEvent)\n            enqueueUserCallback(() => handler.call(null, lastEvent!));\n          lastCallTime = Date.now();\n          timeoutId = null;\n        },\n        Math.max(0, wait)\n      );\n    }\n  } as EventListener & { cancel(): void };\n\n  throttled.cancel = () => {\n    if (timeoutId !== null) {\n      clearTimeout(timeoutId);\n      timeoutId = null;\n    }\n    lastEvent = null;\n  };\n\n  if (inst) {\n    (inst.cleanupFns ??= []).push(() => throttled.cancel());\n  }\n\n  return throttled;\n}\n\nexport function rafEvent(\n  handler: EventListener\n): EventListener & { cancel(): void } {\n  const inst = getCurrentComponentInstance();\n  if (inst && inst.ssr) {\n    return noopEventListener;\n  }\n\n  let frameId: RafHandle = null;\n  let lastEvent: Event | null = null;\n\n  const scheduleFrame = () => {\n    const rAF =\n      typeof requestAnimationFrame !== 'undefined'\n        ? requestAnimationFrame\n        : (cb: FrameRequestCallback) => setTimeout(() => cb(Date.now()), 16);\n\n    frameId = rAF(() => {\n      frameId = null;\n      if (lastEvent) {\n        const ev = lastEvent;\n        lastEvent = null;\n        enqueueUserCallback(() => handler.call(null, ev));\n      }\n    });\n  };\n\n  const fn = function (this: unknown, ev: Event) {\n    throwIfDuringRender();\n    lastEvent = ev;\n    if (frameId === null) scheduleFrame();\n  } as EventListener & { cancel(): void };\n\n  fn.cancel = () => {\n    if (frameId !== null) {\n      // If frameId is numeric and cancelAnimationFrame is available, use it;\n      // otherwise fall back to clearTimeout for the setTimeout fallback.\n      if (\n        typeof cancelAnimationFrame !== 'undefined' &&\n        typeof frameId === 'number'\n      ) {\n        cancelAnimationFrame(frameId);\n      } else {\n        clearTimeout(frameId as ReturnType<typeof setTimeout>);\n      }\n      frameId = null;\n    }\n    lastEvent = null;\n  };\n\n  if (inst) (inst.cleanupFns ??= []).push(() => fn.cancel());\n\n  return fn;\n}\n\n// ---------- Scheduled work ----------\n\nexport function scheduleTimeout(ms: number, fn: () => void): CancelFn {\n  throwIfDuringRender();\n  const inst = getCurrentComponentInstance();\n  if (inst && inst.ssr) {\n    return () => {};\n  }\n\n  let id: TimeoutHandle = setTimeout(() => {\n    id = null;\n    enqueueUserCallback(fn);\n  }, ms);\n\n  const cancel = () => {\n    if (id !== null) {\n      clearTimeout(id);\n      id = null;\n    }\n  };\n\n  if (inst) (inst.cleanupFns ??= []).push(cancel);\n  return cancel;\n}\n\nexport function scheduleIdle(\n  fn: () => void,\n  options?: { timeout?: number }\n): CancelFn {\n  throwIfDuringRender();\n  const inst = getCurrentComponentInstance();\n  if (inst && inst.ssr) return () => {};\n\n  let id: IdleHandle = null;\n  let usingRIC = false;\n\n  if (typeof requestIdleCallback !== 'undefined') {\n    usingRIC = true;\n    id = requestIdleCallback(() => {\n      id = null;\n      enqueueUserCallback(fn);\n    }, options);\n  } else {\n    // Fallback: schedule on next macrotask\n    id = setTimeout(() => {\n      id = null;\n      enqueueUserCallback(fn);\n    }, 0);\n  }\n\n  const cancel = () => {\n    if (id !== null) {\n      // If using requestIdleCallback and available, call cancelIdleCallback for numeric ids.\n      if (\n        usingRIC &&\n        typeof cancelIdleCallback !== 'undefined' &&\n        typeof id === 'number'\n      ) {\n        cancelIdleCallback(id);\n      } else {\n        clearTimeout(id as ReturnType<typeof setTimeout>);\n      }\n      id = null;\n    }\n  };\n\n  if (inst) (inst.cleanupFns ??= []).push(cancel);\n  return cancel;\n}\n\nexport interface RetryOptions {\n  maxAttempts?: number;\n  delayMs?: number;\n  backoff?: (attemptIndex: number) => number;\n}\n\nexport function scheduleRetry<T>(\n  fn: () => Promise<T>,\n  options?: RetryOptions\n): { cancel(): void } {\n  throwIfDuringRender();\n  const inst = getCurrentComponentInstance();\n  if (inst && inst.ssr) return { cancel: () => {} };\n\n  const {\n    maxAttempts = 3,\n    delayMs = 100,\n    backoff = (i: number) => delayMs * Math.pow(2, i),\n  } = options || {};\n\n  let cancelled = false;\n\n  const attempt = (index: number) => {\n    if (cancelled) return;\n    // Run user fn inside scheduler\n    globalScheduler.enqueue(() => {\n      if (cancelled) return;\n      // Call fn (it may be async)\n      const p = fn();\n      p.then(\n        () => {\n          // Completed successfully\n        },\n        () => {\n          if (cancelled) return;\n          if (index + 1 < maxAttempts) {\n            const delay = backoff(index);\n            // Schedule next attempt via setTimeout so it gets enqueued through scheduleTimeout\n            setTimeout(() => {\n              attempt(index + 1);\n            }, delay);\n          }\n        }\n      ).catch((e) => {\n        logger.error('[Askr] scheduleRetry error:', e);\n      });\n    });\n  };\n\n  // Start first attempt\n  attempt(0);\n\n  const cancel = () => {\n    cancelled = true;\n  };\n\n  if (inst) (inst.cleanupFns ??= []).push(cancel);\n  return { cancel };\n}\n"],"mappings":"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"}

package/dist/fx/timing.js.map

@@ -1 +1 @@
-{"version":3,"file":"timing.js","names":[],"sources":["../../src/fx/timing.ts"],"sourcesContent":["/**\n * Timing utilities — pure helpers for common async patterns\n * No framework coupling. No lifecycle awareness.\n */\n\nexport interface DebounceOptions {\n  leading?: boolean;\n  trailing?: boolean;\n}\n\nexport interface ThrottleOptions {\n  leading?: boolean;\n  trailing?: boolean;\n}\n\nexport interface RetryOptions {\n  maxAttempts?: number;\n  delayMs?: number;\n  backoff?: (attemptIndex: number) => number;\n}\n\ntype AnyFn = (...args: never[]) => unknown;\n\n/**\n * Debounce — delay execution, coalesce rapid calls\n *\n * Useful for: text input, resize, autosave\n *\n * @param fn Function to debounce\n * @param ms Delay in milliseconds\n * @param options trailing (default true), leading\n * @returns Debounced function with cancel() method\n *\n * @example\n * ```ts\n * const save = debounce((text) => api.save(text), 500);\n * input.addEventListener('input', (e) => save(e.target.value));\n * save.cancel(); // stop any pending execution\n * ```\n */\nexport function debounce<T extends AnyFn>(\n  fn: T,\n  ms: number,\n  options?: DebounceOptions\n): T & { cancel(): void } {\n  let timeoutId: NodeJS.Timeout | null = null;\n  const { leading = false, trailing = true } = options || {};\n  let lastArgs: unknown[] | null = null;\n  let lastThis: unknown = null;\n  let lastCallTime = 0;\n\n  const debounced = function (this: unknown, ...args: unknown[]) {\n    const callTime = Date.now();\n    lastArgs = args;\n    // eslint-disable-next-line @typescript-eslint/no-this-alias\n    lastThis = this;\n\n    if (timeoutId !== null) {\n      clearTimeout(timeoutId);\n    }\n\n    if (leading && callTime - lastCallTime >= ms) {\n      fn.apply(this, args);\n      lastCallTime = callTime;\n    }\n\n    if (trailing) {\n      timeoutId = setTimeout(() => {\n        fn.apply(lastThis, lastArgs!);\n        timeoutId = null;\n        lastCallTime = Date.now();\n      }, ms);\n    }\n  };\n\n  debounced.cancel = () => {\n    if (timeoutId !== null) {\n      clearTimeout(timeoutId);\n      timeoutId = null;\n    }\n  };\n\n  return debounced as T & { cancel(): void };\n}\n\n/**\n * Throttle — rate-limit execution, keep first/last\n *\n * Useful for: scroll, mouse move, high-frequency events\n *\n * @param fn Function to throttle\n * @param ms Minimum interval between calls in milliseconds\n * @param options leading (default true), trailing (default true)\n * @returns Throttled function with cancel() method\n *\n * @example\n * ```ts\n * const handleScroll = throttle(updateUI, 100);\n * window.addEventListener('scroll', handleScroll);\n * handleScroll.cancel();\n * ```\n */\nexport function throttle<T extends AnyFn>(\n  fn: T,\n  ms: number,\n  options?: ThrottleOptions\n): T & { cancel(): void } {\n  let lastCallTime: number | null = null;\n  let timeoutId: NodeJS.Timeout | null = null;\n  const { leading = true, trailing = true } = options || {};\n  let lastArgs: unknown[] | null = null;\n  let lastThis: unknown = null;\n\n  const throttled = function (this: unknown, ...args: unknown[]) {\n    const callTime = Date.now();\n    const timeSinceLastCall =\n      lastCallTime === null\n        ? Number.POSITIVE_INFINITY\n        : callTime - lastCallTime;\n    lastArgs = args;\n    // eslint-disable-next-line @typescript-eslint/no-this-alias\n    lastThis = this;\n\n    if (leading && timeSinceLastCall >= ms) {\n      fn.apply(this, args);\n      lastCallTime = callTime;\n      if (timeoutId !== null) {\n        clearTimeout(timeoutId);\n        timeoutId = null;\n      }\n      return;\n    }\n\n    if (!leading && lastCallTime === null) {\n      lastCallTime = callTime;\n    }\n\n    if (trailing && timeoutId === null) {\n      timeoutId = setTimeout(\n        () => {\n          fn.apply(lastThis, lastArgs!);\n          lastCallTime = Date.now();\n          timeoutId = null;\n        },\n        lastCallTime === null ? ms : Math.max(0, ms - (callTime - lastCallTime))\n      );\n    }\n  };\n\n  throttled.cancel = () => {\n    if (timeoutId !== null) {\n      clearTimeout(timeoutId);\n      timeoutId = null;\n    }\n  };\n\n  return throttled as T & { cancel(): void };\n}\n\n/**\n * Once — guard against double execution\n *\n * Useful for: init logic, event safety\n *\n * @param fn Function to call at most once\n * @returns Function that executes fn only on first call\n *\n * @example\n * ```ts\n * const init = once(setup);\n * init(); // runs\n * init(); // does nothing\n * init(); // does nothing\n * ```\n */\nexport function once<T extends AnyFn>(fn: T): T {\n  let called = false;\n  let result: unknown;\n\n  return ((...args: unknown[]) => {\n    if (!called) {\n      called = true;\n      result = fn(...args);\n    }\n    return result;\n  }) as T;\n}\n\n/**\n * Defer — schedule on microtask queue\n *\n * Useful for: run-after-current-stack logic\n * More reliable than setTimeout(..., 0)\n *\n * @param fn Function to defer\n *\n * @example\n * ```ts\n * defer(() => update()); // runs after current stack, before next macrotask\n * ```\n */\nexport function defer(fn: () => void): void {\n  Promise.resolve().then(fn);\n}\n\n/**\n * RAF — coalesce multiple updates into single frame\n *\n * Useful for: animation, layout work, render updates\n *\n * @param fn Function to schedule on next animation frame\n * @returns Function that schedules fn on requestAnimationFrame\n *\n * @example\n * ```ts\n * const update = raf(render);\n * update(); // schedules on next frame\n * update(); // same frame, no duplicate\n * ```\n */\nexport function raf<T extends AnyFn>(fn: T): T {\n  let frameId: number | null = null;\n  let lastArgs: unknown[] | null = null;\n  let lastThis: unknown = null;\n\n  return function (this: unknown, ...args: unknown[]) {\n    lastArgs = args;\n    // eslint-disable-next-line @typescript-eslint/no-this-alias\n    lastThis = this;\n\n    if (frameId === null) {\n      frameId = requestAnimationFrame(() => {\n        fn.apply(lastThis, lastArgs!);\n        frameId = null;\n      });\n    }\n  } as T;\n}\n\n/**\n * Idle — schedule low-priority work\n *\n * Useful for: background prep, non-urgent updates\n * Falls back to setTimeout if requestIdleCallback unavailable\n *\n * @param fn Function to call when idle\n * @param options timeout for fallback\n *\n * @example\n * ```ts\n * idle(() => prefetchData());\n * ```\n */\nexport function idle(fn: () => void, options?: { timeout?: number }): void {\n  if (typeof requestIdleCallback !== 'undefined') {\n    requestIdleCallback(fn, options ? { timeout: options.timeout } : undefined);\n  } else {\n    // Fallback: defer to microtask, then use setTimeout\n    Promise.resolve().then(() => {\n      setTimeout(fn, 0);\n    });\n  }\n}\n\n/**\n * Timeout — Promise-based delay\n *\n * Useful for: readable async code, waiting between retries\n *\n * @param ms Milliseconds to wait\n * @returns Promise that resolves after delay\n *\n * @example\n * ```ts\n * await timeout(300);\n * console.log('300ms later');\n * ```\n */\nexport function timeout(ms: number): Promise<void> {\n  return new Promise((resolve) => setTimeout(resolve, ms));\n}\n\n/**\n * Retry — attempt function with backoff\n *\n * Useful for: network calls, transient failures\n *\n * @param fn Async function to retry\n * @param options maxAttempts, delayMs, backoff function\n * @returns Promise with final result or error\n *\n * @example\n * ```ts\n * const data = await retry(() => fetch(url), {\n *   maxAttempts: 3,\n *   delayMs: 100,\n * });\n * ```\n */\nexport async function retry<T>(\n  fn: () => Promise<T>,\n  options?: RetryOptions\n): Promise<T> {\n  const {\n    maxAttempts = 3,\n    delayMs = 100,\n    backoff = (i: number) => delayMs * Math.pow(2, i),\n  } = options || {};\n\n  let lastError: Error | null = null;\n\n  for (let attempt = 0; attempt < maxAttempts; attempt++) {\n    try {\n      return await fn();\n    } catch (error) {\n      lastError = error as Error;\n      if (attempt < maxAttempts - 1) {\n        const delay = backoff(attempt);\n        await timeout(delay);\n      }\n    }\n  }\n\n  throw lastError || new Error('Retry failed');\n}\n"],"mappings":"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"}
+{"version":3,"file":"timing.js","names":[],"sources":["../../src/fx/timing.ts"],"sourcesContent":["/**\n * Timing utilities — pure helpers for common async patterns\n * No framework coupling. No lifecycle awareness.\n */\n\nexport interface DebounceOptions {\n  leading?: boolean;\n  trailing?: boolean;\n}\n\nexport interface ThrottleOptions {\n  leading?: boolean;\n  trailing?: boolean;\n}\n\nexport interface RetryOptions {\n  maxAttempts?: number;\n  delayMs?: number;\n  backoff?: (attemptIndex: number) => number;\n}\n\ntype AnyFn = (...args: never[]) => unknown;\n\n/**\n * Debounce — delay execution, coalesce rapid calls\n *\n * Useful for: text input, resize, autosave\n *\n * @param fn Function to debounce\n * @param ms Delay in milliseconds\n * @param options trailing (default true), leading\n * @returns Debounced function with cancel() method\n *\n * @example\n * ```ts\n * const save = debounce((text) => api.save(text), 500);\n * input.addEventListener('input', (e) => save(e.target.value));\n * save.cancel(); // stop any pending execution\n * ```\n */\nexport function debounce<T extends AnyFn>(\n  fn: T,\n  ms: number,\n  options?: DebounceOptions\n): T & { cancel(): void } {\n  let timeoutId: NodeJS.Timeout | null = null;\n  const { leading = false, trailing = true } = options || {};\n  let lastArgs: unknown[] | null = null;\n  let lastThis: unknown = null;\n  let lastCallTime = 0;\n\n  const debounced = function (this: unknown, ...args: unknown[]) {\n    const callTime = Date.now();\n    lastArgs = args;\n    // eslint-disable-next-line @typescript-eslint/no-this-alias\n    lastThis = this;\n\n    if (timeoutId !== null) {\n      clearTimeout(timeoutId);\n    }\n\n    if (leading && callTime - lastCallTime >= ms) {\n      fn.apply(this, args);\n      lastCallTime = callTime;\n    }\n\n    if (trailing) {\n      timeoutId = setTimeout(() => {\n        fn.apply(lastThis, lastArgs!);\n        timeoutId = null;\n        lastCallTime = Date.now();\n      }, ms);\n    }\n  };\n\n  debounced.cancel = () => {\n    if (timeoutId !== null) {\n      clearTimeout(timeoutId);\n      timeoutId = null;\n    }\n  };\n\n  return debounced as T & { cancel(): void };\n}\n\n/**\n * Throttle — rate-limit execution, keep first/last\n *\n * Useful for: scroll, mouse move, high-frequency events\n *\n * @param fn Function to throttle\n * @param ms Minimum interval between calls in milliseconds\n * @param options leading (default true), trailing (default true)\n * @returns Throttled function with cancel() method\n *\n * @example\n * ```ts\n * const handleScroll = throttle(updateUI, 100);\n * window.addEventListener('scroll', handleScroll);\n * handleScroll.cancel();\n * ```\n */\nexport function throttle<T extends AnyFn>(\n  fn: T,\n  ms: number,\n  options?: ThrottleOptions\n): T & { cancel(): void } {\n  let lastCallTime: number | null = null;\n  let timeoutId: NodeJS.Timeout | null = null;\n  const { leading = true, trailing = true } = options || {};\n  let lastArgs: unknown[] | null = null;\n  let lastThis: unknown = null;\n\n  const throttled = function (this: unknown, ...args: unknown[]) {\n    const callTime = Date.now();\n    const timeSinceLastCall =\n      lastCallTime === null\n        ? Number.POSITIVE_INFINITY\n        : callTime - lastCallTime;\n    lastArgs = args;\n    // eslint-disable-next-line @typescript-eslint/no-this-alias\n    lastThis = this;\n\n    if (leading && timeSinceLastCall >= ms) {\n      fn.apply(this, args);\n      lastCallTime = callTime;\n      if (timeoutId !== null) {\n        clearTimeout(timeoutId);\n        timeoutId = null;\n      }\n      return;\n    }\n\n    if (!leading && lastCallTime === null) {\n      lastCallTime = callTime;\n    }\n\n    if (trailing && timeoutId === null) {\n      timeoutId = setTimeout(\n        () => {\n          fn.apply(lastThis, lastArgs!);\n          lastCallTime = Date.now();\n          timeoutId = null;\n        },\n        lastCallTime === null ? ms : Math.max(0, ms - (callTime - lastCallTime))\n      );\n    }\n  };\n\n  throttled.cancel = () => {\n    if (timeoutId !== null) {\n      clearTimeout(timeoutId);\n      timeoutId = null;\n    }\n  };\n\n  return throttled as T & { cancel(): void };\n}\n\n/**\n * Once — guard against double execution\n *\n * Useful for: init logic, event safety\n *\n * @param fn Function to call at most once\n * @returns Function that executes fn only on first call\n *\n * @example\n * ```ts\n * const init = once(setup);\n * init(); // runs\n * init(); // does nothing\n * init(); // does nothing\n * ```\n */\nexport function once<T extends AnyFn>(fn: T): T {\n  let called = false;\n  let result: unknown;\n\n  return ((...args: unknown[]) => {\n    if (!called) {\n      called = true;\n      result = fn(...args);\n    }\n    return result;\n  }) as T;\n}\n\n/**\n * Defer — schedule on microtask queue\n *\n * Useful for: run-after-current-stack logic\n * More reliable than setTimeout(..., 0)\n *\n * @param fn Function to defer\n *\n * @example\n * ```ts\n * defer(() => update()); // runs after current stack, before next macrotask\n * ```\n */\nexport function defer(fn: () => void): void {\n  Promise.resolve().then(fn);\n}\n\n/**\n * RAF — coalesce multiple updates into single frame\n *\n * Useful for: animation, layout work, render updates\n *\n * @param fn Function to schedule on next animation frame\n * @returns Function that schedules fn on requestAnimationFrame\n *\n * @example\n * ```ts\n * const update = raf(render);\n * update(); // schedules on next frame\n * update(); // same frame, no duplicate\n * ```\n */\nexport function raf<T extends AnyFn>(fn: T): T {\n  let frameId: number | null = null;\n  let lastArgs: unknown[] | null = null;\n  let lastThis: unknown = null;\n\n  return function (this: unknown, ...args: unknown[]) {\n    lastArgs = args;\n    // eslint-disable-next-line @typescript-eslint/no-this-alias\n    lastThis = this;\n\n    if (frameId === null) {\n      frameId = requestAnimationFrame(() => {\n        fn.apply(lastThis, lastArgs!);\n        frameId = null;\n      });\n    }\n  } as T;\n}\n\n/**\n * Idle — schedule low-priority work\n *\n * Useful for: background prep, non-urgent updates\n * Falls back to setTimeout if requestIdleCallback unavailable\n *\n * @param fn Function to call when idle\n * @param options timeout for fallback\n *\n * @example\n * ```ts\n * idle(() => prefetchData());\n * ```\n */\nexport function idle(fn: () => void, options?: { timeout?: number }): void {\n  if (typeof requestIdleCallback !== 'undefined') {\n    requestIdleCallback(fn, options ? { timeout: options.timeout } : undefined);\n  } else {\n    // Fallback: defer to microtask, then use setTimeout\n    Promise.resolve().then(() => {\n      setTimeout(fn, 0);\n    });\n  }\n}\n\n/**\n * Timeout — Promise-based delay\n *\n * Useful for: readable async code, waiting between retries\n *\n * @param ms Milliseconds to wait\n * @returns Promise that resolves after delay\n *\n * @example\n * ```ts\n * await timeout(300);\n * console.log('300ms later');\n * ```\n */\nexport function timeout(ms: number): Promise<void> {\n  return new Promise((resolve) => setTimeout(resolve, ms));\n}\n\n/**\n * Retry — attempt function with backoff\n *\n * Useful for: network calls, transient failures\n *\n * @param fn Async function to retry\n * @param options maxAttempts, delayMs, backoff function\n * @returns Promise with final result or error\n *\n * @example\n * ```ts\n * const data = await retry(() => fetch(url), {\n *   maxAttempts: 3,\n *   delayMs: 100,\n * });\n * ```\n */\nexport async function retry<T>(\n  fn: () => Promise<T>,\n  options?: RetryOptions\n): Promise<T> {\n  const {\n    maxAttempts = 3,\n    delayMs = 100,\n    backoff = (i: number) => delayMs * Math.pow(2, i),\n  } = options || {};\n\n  let lastError: Error | null = null;\n\n  for (let attempt = 0; attempt < maxAttempts; attempt++) {\n    try {\n      return await fn();\n    } catch (error) {\n      lastError = error as Error;\n      if (attempt < maxAttempts - 1) {\n        const delay = backoff(attempt);\n        await timeout(delay);\n      }\n    }\n  }\n\n  throw lastError || new Error('Retry failed');\n}\n"],"mappings":"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"}

package/dist/renderer/children.js.map

@@ -1 +1 @@
-{"version":3,"file":"children.js","names":[],"sources":["../../src/renderer/children.ts"],"sourcesContent":["import { setDevValue, incDevCounter } from '../runtime/dev-namespace';\nimport { getRuntimeEnv } from './env';\nimport { keyedElements } from './keyed';\nimport { teardownNodeSubtree } from './cleanup';\nimport { createDOMNode, updateElementFromVnode } from './dom';\nimport { _isDOMElement, type DOMElement, type VNode } from './types';\nimport {\n  hasNonTrivialProps,\n  logFastPathDebug,\n  now,\n  recordDOMReplace,\n  recordFastPathStats,\n  tagNamesEqualIgnoreCase,\n} from './utils';\n\nfunction upperCommonTagName(tag: string): string | null {\n  switch (tag) {\n    case 'div':\n      return 'DIV';\n    case 'span':\n      return 'SPAN';\n    case 'p':\n      return 'P';\n    case 'a':\n      return 'A';\n    case 'button':\n      return 'BUTTON';\n    case 'input':\n      return 'INPUT';\n    case 'ul':\n      return 'UL';\n    case 'ol':\n      return 'OL';\n    case 'li':\n      return 'LI';\n    default:\n      return null;\n  }\n}\n\nfunction tagsEqualIgnoreCase(\n  elementTagName: string,\n  vnodeType: string\n): boolean {\n  if (elementTagName === vnodeType) return true;\n\n  const upperCommon = upperCommonTagName(vnodeType);\n  if (upperCommon !== null && elementTagName === upperCommon) return true;\n\n  return tagNamesEqualIgnoreCase(elementTagName, vnodeType);\n}\n\nexport function performBulkPositionalKeyedTextUpdate(\n  parent: Element,\n  keyedVnodes: Array<{ key: string | number; vnode: VNode }>\n) {\n  const total = keyedVnodes.length;\n  let reused = 0;\n  let updatedKeys = 0;\n  const start = now();\n  const env = getRuntimeEnv();\n  const debugFastPath =\n    env.ASKR_FASTPATH_DEBUG === '1' || env.ASKR_FASTPATH_DEBUG === 'true';\n\n  for (let index = 0; index < total; index += 1) {\n    const { key, vnode } = keyedVnodes[index];\n    const child = parent.children[index] as Element | undefined;\n\n    if (\n      child &&\n      _isDOMElement(vnode) &&\n      typeof (vnode as DOMElement).type === 'string'\n    ) {\n      const vnodeType = (vnode as DOMElement).type as string;\n\n      if (tagsEqualIgnoreCase(child.tagName, vnodeType)) {\n        const children =\n          (vnode as DOMElement).children ||\n          (vnode as DOMElement).props?.children;\n\n        if (debugFastPath) {\n          logFastPathDebug('positional idx', index, {\n            chTag: child.tagName,\n            vnodeType,\n            chChildNodes: child.childNodes.length,\n            childrenType: Array.isArray(children) ? 'array' : typeof children,\n          });\n        }\n\n        updateTextContent(child, children, vnode as DOMElement);\n        setDataKey(child, key, () => (updatedKeys += 1));\n        reused += 1;\n        continue;\n      }\n\n      if (debugFastPath) {\n        logFastPathDebug('positional tag mismatch', index, {\n          chTag: child.tagName,\n          vnodeType,\n        });\n      }\n    } else if (debugFastPath) {\n      logFastPathDebug('positional missing or invalid', index, { ch: !!child });\n    }\n\n    replaceNodeAtPosition(parent, index, vnode);\n  }\n\n  const elapsed = now() - start;\n  updateKeyedElementsMap(parent, keyedVnodes);\n\n  const stats = { n: total, reused, updatedKeys, t: elapsed } as const;\n  recordFastPathStats(stats, 'bulkKeyedPositionalHits');\n\n  return stats;\n}\n\nfunction updateTextContent(\n  el: Element,\n  children: unknown,\n  vnode: DOMElement\n): void {\n  if (typeof children === 'string' || typeof children === 'number') {\n    setTextNodeData(el, String(children));\n    if (vnode.props && hasNonTrivialProps(vnode.props)) {\n      updateElementFromVnode(el, vnode, false);\n    }\n    return;\n  }\n\n  if (\n    Array.isArray(children) &&\n    children.length === 1 &&\n    (typeof children[0] === 'string' || typeof children[0] === 'number')\n  ) {\n    setTextNodeData(el, String(children[0]));\n    if (vnode.props && hasNonTrivialProps(vnode.props)) {\n      updateElementFromVnode(el, vnode, false);\n    }\n    return;\n  }\n\n  if (!tryUpdateTwoChildTextPattern(el, vnode)) {\n    updateElementFromVnode(el, vnode);\n  }\n}\n\nfunction tryUpdateTwoChildTextPattern(\n  parentEl: Element,\n  vnode: DOMElement\n): boolean {\n  const vnodeChildren = vnode.props?.children ?? vnode.children;\n  if (!Array.isArray(vnodeChildren) || vnodeChildren.length !== 2) return false;\n\n  const firstChild = vnodeChildren[0];\n  const secondChild = vnodeChildren[1];\n  if (!_isDOMElement(firstChild) || !_isDOMElement(secondChild)) return false;\n  if (\n    typeof firstChild.type !== 'string' ||\n    typeof secondChild.type !== 'string'\n  ) {\n    return false;\n  }\n\n  const firstElement = parentEl.children[0] as Element | undefined;\n  const secondElement = parentEl.children[1] as Element | undefined;\n  if (!firstElement || !secondElement) return false;\n  if (parentEl.children.length !== 2 || parentEl.childNodes.length !== 2) {\n    return false;\n  }\n\n  if (!tagsEqualIgnoreCase(firstElement.tagName, firstChild.type)) return false;\n  if (!tagsEqualIgnoreCase(secondElement.tagName, secondChild.type))\n    return false;\n\n  const firstText = (firstChild.children ||\n    firstChild.props?.children) as unknown;\n  const secondText = (secondChild.children ||\n    secondChild.props?.children) as unknown;\n\n  if (typeof firstText === 'string' || typeof firstText === 'number') {\n    setTextNodeData(firstElement, String(firstText));\n  } else if (\n    Array.isArray(firstText) &&\n    firstText.length === 1 &&\n    (typeof firstText[0] === 'string' || typeof firstText[0] === 'number')\n  ) {\n    setTextNodeData(firstElement, String(firstText[0]));\n  } else {\n    return false;\n  }\n\n  if (typeof secondText === 'string' || typeof secondText === 'number') {\n    setTextNodeData(secondElement, String(secondText));\n  } else if (\n    Array.isArray(secondText) &&\n    secondText.length === 1 &&\n    (typeof secondText[0] === 'string' || typeof secondText[0] === 'number')\n  ) {\n    setTextNodeData(secondElement, String(secondText[0]));\n  } else {\n    return false;\n  }\n\n  return true;\n}\n\nfunction setTextNodeData(el: Element, text: string): void {\n  if (el.childNodes.length === 1 && el.firstChild?.nodeType === 3) {\n    const textNode = el.firstChild as Text;\n    if (textNode.data !== text) textNode.data = text;\n  } else {\n    el.textContent = text;\n  }\n}\n\nfunction setDataKey(\n  el: Element,\n  key: string | number,\n  onSet: () => void\n): void {\n  try {\n    const next = String(key);\n    if (el.getAttribute('data-key') === next) return;\n    el.setAttribute('data-key', next);\n    onSet();\n  } catch {\n    // Ignore errors setting data-key\n  }\n}\n\nfunction replaceNodeAtPosition(\n  parent: Element,\n  index: number,\n  vnode: VNode\n): void {\n  const dom = createDOMNode(vnode);\n  if (dom) {\n    const existing = parent.children[index];\n    if (existing) {\n      teardownNodeSubtree(existing);\n      parent.replaceChild(dom, existing);\n    } else {\n      parent.appendChild(dom);\n    }\n  }\n}\n\nfunction updateKeyedElementsMap(\n  parent: Element,\n  keyedVnodes: Array<{ key: string | number; vnode: VNode }>\n): void {\n  try {\n    const existing = keyedElements.get(parent);\n    const newKeyMap = existing\n      ? (existing.clear(), existing)\n      : new Map<string | number, Element>();\n\n    for (let index = 0; index < keyedVnodes.length; index += 1) {\n      const key = keyedVnodes[index].key;\n      const child = parent.children[index] as Element | undefined;\n      if (child) newKeyMap.set(key, child);\n    }\n\n    keyedElements.set(parent, newKeyMap);\n  } catch {\n    // Ignore errors updating key map\n  }\n}\n\nexport function performBulkTextReplace(parent: Element, newChildren: VNode[]) {\n  const start = now();\n  const existing = Array.from(parent.childNodes);\n  const finalNodes: Node[] = [];\n  let reused = 0;\n  let created = 0;\n\n  for (let index = 0; index < newChildren.length; index += 1) {\n    const result = processChildNode(\n      newChildren[index],\n      existing[index],\n      finalNodes\n    );\n    if (result === 'reused') reused += 1;\n    else if (result === 'created') created += 1;\n  }\n\n  const tBuild = now() - start;\n  const tCommit = commitBulkReplace(parent, finalNodes);\n\n  keyedElements.delete(parent);\n\n  const stats = {\n    n: newChildren.length,\n    reused,\n    created,\n    tBuild,\n    tCommit,\n  } as const;\n  recordBulkTextStats(stats);\n\n  return stats;\n}\n\nfunction processChildNode(\n  vnode: VNode,\n  existingNode: ChildNode | undefined,\n  finalNodes: Node[]\n): 'reused' | 'created' | 'skipped' {\n  if (typeof vnode === 'string' || typeof vnode === 'number') {\n    return processTextVnode(String(vnode), existingNode, finalNodes);\n  }\n\n  if (typeof vnode === 'object' && vnode !== null && 'type' in vnode) {\n    return processElementVnode(vnode, existingNode, finalNodes);\n  }\n\n  return 'skipped';\n}\n\nfunction processTextVnode(\n  text: string,\n  existingNode: ChildNode | undefined,\n  finalNodes: Node[]\n): 'reused' | 'created' {\n  if (existingNode && existingNode.nodeType === 3) {\n    (existingNode as Text).data = text;\n    finalNodes.push(existingNode);\n    return 'reused';\n  }\n\n  finalNodes.push(document.createTextNode(text));\n  return 'created';\n}\n\nfunction processElementVnode(\n  vnode: VNode,\n  existingNode: ChildNode | undefined,\n  finalNodes: Node[]\n): 'reused' | 'created' | 'skipped' {\n  const vnodeObj = vnode as unknown as { type?: unknown };\n\n  if (typeof vnodeObj.type === 'string') {\n    const tag = vnodeObj.type;\n    if (\n      existingNode &&\n      existingNode.nodeType === 1 &&\n      tagsEqualIgnoreCase((existingNode as Element).tagName, tag)\n    ) {\n      updateElementFromVnode(existingNode as Element, vnode);\n      finalNodes.push(existingNode);\n      return 'reused';\n    }\n  }\n\n  const dom = createDOMNode(vnode);\n  if (dom) {\n    finalNodes.push(dom);\n    return 'created';\n  }\n\n  return 'skipped';\n}\n\nfunction commitBulkReplace(parent: Element, nodes: Node[]): number {\n  const startedAt = Date.now();\n  const fragment = document.createDocumentFragment();\n\n  for (let index = 0; index < nodes.length; index += 1) {\n    fragment.appendChild(nodes[index]);\n  }\n\n  try {\n    for (let node = parent.firstChild; node; ) {\n      const next = node.nextSibling;\n      teardownNodeSubtree(node);\n      node = next;\n    }\n  } catch {\n    // SLOW PATH: cleanup failure\n  }\n\n  recordDOMReplace('bulk-text-replace');\n  parent.replaceChildren(fragment);\n  return Date.now() - startedAt;\n}\n\nfunction recordBulkTextStats(stats: {\n  n: number;\n  reused: number;\n  created: number;\n  tBuild: number;\n  tCommit: number;\n}): void {\n  try {\n    setDevValue('__LAST_BULK_TEXT_FASTPATH_STATS', stats);\n    setDevValue('__LAST_FASTPATH_STATS', stats);\n    setDevValue('__LAST_FASTPATH_COMMIT_COUNT', 1);\n    incDevCounter('bulkTextFastpathHits');\n  } catch {\n    // Ignore stats errors\n  }\n}\n\nexport function isBulkTextFastPathEligible(\n  parent: Element,\n  newChildren: VNode[]\n) {\n  const env = getRuntimeEnv();\n  const threshold = Number(env.ASKR_BULK_TEXT_THRESHOLD) || 1024;\n  const requiredFraction = 0.8;\n\n  const total = Array.isArray(newChildren) ? newChildren.length : 0;\n\n  if (total < threshold) {\n    recordBulkDiag({\n      phase: 'bulk-unkeyed-eligible',\n      reason: 'too-small',\n      total,\n      threshold,\n    });\n    return false;\n  }\n\n  const result = countSimpleChildren(newChildren);\n  if (result.componentFound !== undefined) {\n    recordBulkDiag({\n      phase: 'bulk-unkeyed-eligible',\n      reason: 'component-child',\n      index: result.componentFound,\n    });\n    return false;\n  }\n\n  const fraction = result.simple / total;\n  const eligible =\n    fraction >= requiredFraction && parent.childNodes.length >= total;\n\n  recordBulkDiag({\n    phase: 'bulk-unkeyed-eligible',\n    total,\n    simple: result.simple,\n    fraction,\n    requiredFraction,\n    eligible,\n  });\n\n  return eligible;\n}\n\nfunction countSimpleChildren(children: VNode[]): {\n  simple: number;\n  componentFound?: number;\n} {\n  let simple = 0;\n\n  for (let index = 0; index < children.length; index += 1) {\n    const child = children[index];\n\n    if (typeof child === 'string' || typeof child === 'number') {\n      simple += 1;\n      continue;\n    }\n\n    if (typeof child === 'object' && child !== null && 'type' in child) {\n      const dom = child as DOMElement;\n\n      if (typeof dom.type === 'function') {\n        return { simple, componentFound: index };\n      }\n\n      if (typeof dom.type === 'string' && isSimpleElement(dom)) {\n        simple += 1;\n      }\n    }\n  }\n\n  return { simple };\n}\n\nfunction isSimpleElement(dom: DOMElement): boolean {\n  const children = dom.props?.children ?? dom.children;\n\n  if (children === null || children === undefined) return true;\n\n  if (typeof children === 'string' || typeof children === 'number') {\n    return true;\n  }\n\n  if (\n    Array.isArray(children) &&\n    children.length === 1 &&\n    (typeof children[0] === 'string' || typeof children[0] === 'number')\n  ) {\n    return true;\n  }\n\n  return false;\n}\n\nfunction recordBulkDiag(data: Record<string, unknown>): void {\n  const env = getRuntimeEnv();\n  if (env.NODE_ENV !== 'production' || env.ASKR_FASTPATH_DEBUG === '1') {\n    try {\n      setDevValue('__BULK_DIAG', data);\n    } catch {\n      // Ignore\n    }\n  }\n}\n"],"mappings":"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"}
+{"version":3,"file":"children.js","names":[],"sources":["../../src/renderer/children.ts"],"sourcesContent":["import { setDevValue, incDevCounter } from '../runtime/dev-namespace';\nimport { getRuntimeEnv } from './env';\nimport { keyedElements } from './keyed';\nimport { teardownNodeSubtree } from './cleanup';\nimport { createDOMNode, updateElementFromVnode } from './dom';\nimport { _isDOMElement, type DOMElement, type VNode } from './types';\nimport {\n  hasNonTrivialProps,\n  logFastPathDebug,\n  now,\n  recordDOMReplace,\n  recordFastPathStats,\n  tagNamesEqualIgnoreCase,\n} from './utils';\n\nfunction upperCommonTagName(tag: string): string | null {\n  switch (tag) {\n    case 'div':\n      return 'DIV';\n    case 'span':\n      return 'SPAN';\n    case 'p':\n      return 'P';\n    case 'a':\n      return 'A';\n    case 'button':\n      return 'BUTTON';\n    case 'input':\n      return 'INPUT';\n    case 'ul':\n      return 'UL';\n    case 'ol':\n      return 'OL';\n    case 'li':\n      return 'LI';\n    default:\n      return null;\n  }\n}\n\nfunction tagsEqualIgnoreCase(\n  elementTagName: string,\n  vnodeType: string\n): boolean {\n  if (elementTagName === vnodeType) return true;\n\n  const upperCommon = upperCommonTagName(vnodeType);\n  if (upperCommon !== null && elementTagName === upperCommon) return true;\n\n  return tagNamesEqualIgnoreCase(elementTagName, vnodeType);\n}\n\nexport function performBulkPositionalKeyedTextUpdate(\n  parent: Element,\n  keyedVnodes: Array<{ key: string | number; vnode: VNode }>\n) {\n  const total = keyedVnodes.length;\n  let reused = 0;\n  let updatedKeys = 0;\n  const start = now();\n  const env = getRuntimeEnv();\n  const debugFastPath =\n    env.ASKR_FASTPATH_DEBUG === '1' || env.ASKR_FASTPATH_DEBUG === 'true';\n\n  for (let index = 0; index < total; index += 1) {\n    const { key, vnode } = keyedVnodes[index];\n    const child = parent.children[index] as Element | undefined;\n\n    if (\n      child &&\n      _isDOMElement(vnode) &&\n      typeof (vnode as DOMElement).type === 'string'\n    ) {\n      const vnodeType = (vnode as DOMElement).type as string;\n\n      if (tagsEqualIgnoreCase(child.tagName, vnodeType)) {\n        const children =\n          (vnode as DOMElement).children ||\n          (vnode as DOMElement).props?.children;\n\n        if (debugFastPath) {\n          logFastPathDebug('positional idx', index, {\n            chTag: child.tagName,\n            vnodeType,\n            chChildNodes: child.childNodes.length,\n            childrenType: Array.isArray(children) ? 'array' : typeof children,\n          });\n        }\n\n        updateTextContent(child, children, vnode as DOMElement);\n        setDataKey(child, key, () => (updatedKeys += 1));\n        reused += 1;\n        continue;\n      }\n\n      if (debugFastPath) {\n        logFastPathDebug('positional tag mismatch', index, {\n          chTag: child.tagName,\n          vnodeType,\n        });\n      }\n    } else if (debugFastPath) {\n      logFastPathDebug('positional missing or invalid', index, { ch: !!child });\n    }\n\n    replaceNodeAtPosition(parent, index, vnode);\n  }\n\n  const elapsed = now() - start;\n  updateKeyedElementsMap(parent, keyedVnodes);\n\n  const stats = { n: total, reused, updatedKeys, t: elapsed } as const;\n  recordFastPathStats(stats, 'bulkKeyedPositionalHits');\n\n  return stats;\n}\n\nfunction updateTextContent(\n  el: Element,\n  children: unknown,\n  vnode: DOMElement\n): void {\n  if (typeof children === 'string' || typeof children === 'number') {\n    setTextNodeData(el, String(children));\n    if (vnode.props && hasNonTrivialProps(vnode.props)) {\n      updateElementFromVnode(el, vnode, false);\n    }\n    return;\n  }\n\n  if (\n    Array.isArray(children) &&\n    children.length === 1 &&\n    (typeof children[0] === 'string' || typeof children[0] === 'number')\n  ) {\n    setTextNodeData(el, String(children[0]));\n    if (vnode.props && hasNonTrivialProps(vnode.props)) {\n      updateElementFromVnode(el, vnode, false);\n    }\n    return;\n  }\n\n  if (!tryUpdateTwoChildTextPattern(el, vnode)) {\n    updateElementFromVnode(el, vnode);\n  }\n}\n\nfunction tryUpdateTwoChildTextPattern(\n  parentEl: Element,\n  vnode: DOMElement\n): boolean {\n  const vnodeChildren = vnode.props?.children ?? vnode.children;\n  if (!Array.isArray(vnodeChildren) || vnodeChildren.length !== 2) return false;\n\n  const firstChild = vnodeChildren[0];\n  const secondChild = vnodeChildren[1];\n  if (!_isDOMElement(firstChild) || !_isDOMElement(secondChild)) return false;\n  if (\n    typeof firstChild.type !== 'string' ||\n    typeof secondChild.type !== 'string'\n  ) {\n    return false;\n  }\n\n  const firstElement = parentEl.children[0] as Element | undefined;\n  const secondElement = parentEl.children[1] as Element | undefined;\n  if (!firstElement || !secondElement) return false;\n  if (parentEl.children.length !== 2 || parentEl.childNodes.length !== 2) {\n    return false;\n  }\n\n  if (!tagsEqualIgnoreCase(firstElement.tagName, firstChild.type)) return false;\n  if (!tagsEqualIgnoreCase(secondElement.tagName, secondChild.type))\n    return false;\n\n  const firstText = (firstChild.children ||\n    firstChild.props?.children) as unknown;\n  const secondText = (secondChild.children ||\n    secondChild.props?.children) as unknown;\n\n  if (typeof firstText === 'string' || typeof firstText === 'number') {\n    setTextNodeData(firstElement, String(firstText));\n  } else if (\n    Array.isArray(firstText) &&\n    firstText.length === 1 &&\n    (typeof firstText[0] === 'string' || typeof firstText[0] === 'number')\n  ) {\n    setTextNodeData(firstElement, String(firstText[0]));\n  } else {\n    return false;\n  }\n\n  if (typeof secondText === 'string' || typeof secondText === 'number') {\n    setTextNodeData(secondElement, String(secondText));\n  } else if (\n    Array.isArray(secondText) &&\n    secondText.length === 1 &&\n    (typeof secondText[0] === 'string' || typeof secondText[0] === 'number')\n  ) {\n    setTextNodeData(secondElement, String(secondText[0]));\n  } else {\n    return false;\n  }\n\n  return true;\n}\n\nfunction setTextNodeData(el: Element, text: string): void {\n  if (el.childNodes.length === 1 && el.firstChild?.nodeType === 3) {\n    const textNode = el.firstChild as Text;\n    if (textNode.data !== text) textNode.data = text;\n  } else {\n    el.textContent = text;\n  }\n}\n\nfunction setDataKey(\n  el: Element,\n  key: string | number,\n  onSet: () => void\n): void {\n  try {\n    const next = String(key);\n    if (el.getAttribute('data-key') === next) return;\n    el.setAttribute('data-key', next);\n    onSet();\n  } catch {\n    // Ignore errors setting data-key\n  }\n}\n\nfunction replaceNodeAtPosition(\n  parent: Element,\n  index: number,\n  vnode: VNode\n): void {\n  const dom = createDOMNode(vnode);\n  if (dom) {\n    const existing = parent.children[index];\n    if (existing) {\n      teardownNodeSubtree(existing);\n      parent.replaceChild(dom, existing);\n    } else {\n      parent.appendChild(dom);\n    }\n  }\n}\n\nfunction updateKeyedElementsMap(\n  parent: Element,\n  keyedVnodes: Array<{ key: string | number; vnode: VNode }>\n): void {\n  try {\n    const existing = keyedElements.get(parent);\n    const newKeyMap = existing\n      ? (existing.clear(), existing)\n      : new Map<string | number, Element>();\n\n    for (let index = 0; index < keyedVnodes.length; index += 1) {\n      const key = keyedVnodes[index].key;\n      const child = parent.children[index] as Element | undefined;\n      if (child) newKeyMap.set(key, child);\n    }\n\n    keyedElements.set(parent, newKeyMap);\n  } catch {\n    // Ignore errors updating key map\n  }\n}\n\nexport function performBulkTextReplace(parent: Element, newChildren: VNode[]) {\n  const start = now();\n  const existing = Array.from(parent.childNodes);\n  const finalNodes: Node[] = [];\n  let reused = 0;\n  let created = 0;\n\n  for (let index = 0; index < newChildren.length; index += 1) {\n    const result = processChildNode(\n      newChildren[index],\n      existing[index],\n      finalNodes\n    );\n    if (result === 'reused') reused += 1;\n    else if (result === 'created') created += 1;\n  }\n\n  const tBuild = now() - start;\n  const tCommit = commitBulkReplace(parent, finalNodes);\n\n  keyedElements.delete(parent);\n\n  const stats = {\n    n: newChildren.length,\n    reused,\n    created,\n    tBuild,\n    tCommit,\n  } as const;\n  recordBulkTextStats(stats);\n\n  return stats;\n}\n\nfunction processChildNode(\n  vnode: VNode,\n  existingNode: ChildNode | undefined,\n  finalNodes: Node[]\n): 'reused' | 'created' | 'skipped' {\n  if (typeof vnode === 'string' || typeof vnode === 'number') {\n    return processTextVnode(String(vnode), existingNode, finalNodes);\n  }\n\n  if (typeof vnode === 'object' && vnode !== null && 'type' in vnode) {\n    return processElementVnode(vnode, existingNode, finalNodes);\n  }\n\n  return 'skipped';\n}\n\nfunction processTextVnode(\n  text: string,\n  existingNode: ChildNode | undefined,\n  finalNodes: Node[]\n): 'reused' | 'created' {\n  if (existingNode && existingNode.nodeType === 3) {\n    (existingNode as Text).data = text;\n    finalNodes.push(existingNode);\n    return 'reused';\n  }\n\n  finalNodes.push(document.createTextNode(text));\n  return 'created';\n}\n\nfunction processElementVnode(\n  vnode: VNode,\n  existingNode: ChildNode | undefined,\n  finalNodes: Node[]\n): 'reused' | 'created' | 'skipped' {\n  const vnodeObj = vnode as unknown as { type?: unknown };\n\n  if (typeof vnodeObj.type === 'string') {\n    const tag = vnodeObj.type;\n    if (\n      existingNode &&\n      existingNode.nodeType === 1 &&\n      tagsEqualIgnoreCase((existingNode as Element).tagName, tag)\n    ) {\n      updateElementFromVnode(existingNode as Element, vnode);\n      finalNodes.push(existingNode);\n      return 'reused';\n    }\n  }\n\n  const dom = createDOMNode(vnode);\n  if (dom) {\n    finalNodes.push(dom);\n    return 'created';\n  }\n\n  return 'skipped';\n}\n\nfunction commitBulkReplace(parent: Element, nodes: Node[]): number {\n  const startedAt = Date.now();\n  const fragment = document.createDocumentFragment();\n\n  for (let index = 0; index < nodes.length; index += 1) {\n    fragment.appendChild(nodes[index]);\n  }\n\n  try {\n    for (let node = parent.firstChild; node; ) {\n      const next = node.nextSibling;\n      teardownNodeSubtree(node);\n      node = next;\n    }\n  } catch {\n    // SLOW PATH: cleanup failure\n  }\n\n  recordDOMReplace('bulk-text-replace');\n  parent.replaceChildren(fragment);\n  return Date.now() - startedAt;\n}\n\nfunction recordBulkTextStats(stats: {\n  n: number;\n  reused: number;\n  created: number;\n  tBuild: number;\n  tCommit: number;\n}): void {\n  try {\n    setDevValue('__LAST_BULK_TEXT_FASTPATH_STATS', stats);\n    setDevValue('__LAST_FASTPATH_STATS', stats);\n    setDevValue('__LAST_FASTPATH_COMMIT_COUNT', 1);\n    incDevCounter('bulkTextFastpathHits');\n  } catch {\n    // Ignore stats errors\n  }\n}\n\nexport function isBulkTextFastPathEligible(\n  parent: Element,\n  newChildren: VNode[]\n) {\n  const env = getRuntimeEnv();\n  const threshold = Number(env.ASKR_BULK_TEXT_THRESHOLD) || 1024;\n  const requiredFraction = 0.8;\n\n  const total = Array.isArray(newChildren) ? newChildren.length : 0;\n\n  if (total < threshold) {\n    recordBulkDiag({\n      phase: 'bulk-unkeyed-eligible',\n      reason: 'too-small',\n      total,\n      threshold,\n    });\n    return false;\n  }\n\n  const result = countSimpleChildren(newChildren);\n  if (result.componentFound !== undefined) {\n    recordBulkDiag({\n      phase: 'bulk-unkeyed-eligible',\n      reason: 'component-child',\n      index: result.componentFound,\n    });\n    return false;\n  }\n\n  const fraction = result.simple / total;\n  const eligible =\n    fraction >= requiredFraction && parent.childNodes.length >= total;\n\n  recordBulkDiag({\n    phase: 'bulk-unkeyed-eligible',\n    total,\n    simple: result.simple,\n    fraction,\n    requiredFraction,\n    eligible,\n  });\n\n  return eligible;\n}\n\nfunction countSimpleChildren(children: VNode[]): {\n  simple: number;\n  componentFound?: number;\n} {\n  let simple = 0;\n\n  for (let index = 0; index < children.length; index += 1) {\n    const child = children[index];\n\n    if (typeof child === 'string' || typeof child === 'number') {\n      simple += 1;\n      continue;\n    }\n\n    if (typeof child === 'object' && child !== null && 'type' in child) {\n      const dom = child as DOMElement;\n\n      if (typeof dom.type === 'function') {\n        return { simple, componentFound: index };\n      }\n\n      if (typeof dom.type === 'string' && isSimpleElement(dom)) {\n        simple += 1;\n      }\n    }\n  }\n\n  return { simple };\n}\n\nfunction isSimpleElement(dom: DOMElement): boolean {\n  const children = dom.props?.children ?? dom.children;\n\n  if (children === null || children === undefined) return true;\n\n  if (typeof children === 'string' || typeof children === 'number') {\n    return true;\n  }\n\n  if (\n    Array.isArray(children) &&\n    children.length === 1 &&\n    (typeof children[0] === 'string' || typeof children[0] === 'number')\n  ) {\n    return true;\n  }\n\n  return false;\n}\n\nfunction recordBulkDiag(data: Record<string, unknown>): void {\n  const env = getRuntimeEnv();\n  if (env.NODE_ENV !== 'production' || env.ASKR_FASTPATH_DEBUG === '1') {\n    try {\n      setDevValue('__BULK_DIAG', data);\n    } catch {\n      // Ignore\n    }\n  }\n}\n"],"mappings":"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"}

package/dist/renderer/cleanup.js.map

@@ -1 +1 @@
-{"version":3,"file":"cleanup.js","names":[],"sources":["../../src/renderer/cleanup.ts"],"sourcesContent":["import { cleanupComponent } from '../runtime/component';\nimport type { ComponentInstance } from '../runtime/component';\nimport { logger } from '../dev/logger';\nimport { incDevCounter } from '../runtime/dev-namespace';\nimport {\n  clearDelegatedHandlersForElement,\n  removeDelegatedListener,\n} from '../runtime/events';\n\ntype InstanceHost = Node & {\n  __ASKR_INSTANCE?: unknown;\n  __ASKR_INSTANCES?: unknown[];\n};\n\n// ─────────────────────────────────────────────────────────────────────────────\n// Instance Cleanup Helpers\n// ─────────────────────────────────────────────────────────────────────────────\n\nfunction cleanupSingleInstance(\n  node: InstanceHost,\n  errors: unknown[] | null,\n  strict: boolean\n): void {\n  const instances = new Set<ComponentInstance>();\n\n  if (Array.isArray(node.__ASKR_INSTANCES)) {\n    for (const instance of node.__ASKR_INSTANCES) {\n      if (instance) {\n        instances.add(instance as ComponentInstance);\n      }\n    }\n  }\n\n  if (node.__ASKR_INSTANCE) {\n    instances.add(node.__ASKR_INSTANCE as ComponentInstance);\n  }\n\n  for (const instance of instances) {\n    try {\n      cleanupComponent(instance);\n    } catch (err) {\n      if (strict) errors!.push(err);\n      else logger.warn('[Askr] cleanupComponent failed:', err);\n    }\n  }\n\n  try {\n    delete node.__ASKR_INSTANCE;\n    delete node.__ASKR_INSTANCES;\n  } catch (e) {\n    if (strict) errors!.push(e);\n  }\n}\n\nfunction teardownSingleElement(\n  element: Element,\n  errors: unknown[] | null,\n  strict: boolean\n): void {\n  try {\n    removeElementListeners(element);\n  } catch (err) {\n    if (strict) errors!.push(err);\n    else logger.warn('[Askr] removeElementListeners failed:', err);\n  }\n\n  try {\n    removeElementReactiveProps(element);\n  } catch (err) {\n    if (strict) errors!.push(err);\n    else logger.warn('[Askr] removeElementReactiveProps failed:', err);\n  }\n\n  try {\n    cleanupSingleInstance(element as InstanceHost, errors, strict);\n  } catch (err) {\n    if (strict) errors!.push(err);\n    else logger.warn('[Askr] cleanupSingleInstance failed:', err);\n  }\n}\n\n// Walk descendant elements with minimal allocations.\n// HOT PATH: used during subtree teardown (replace/unmount).\nfunction forEachDescendantElement(root: Element, visit: (el: Element) => void) {\n  // Prefer TreeWalker when available; it avoids allocating a NodeList.\n  try {\n    const doc = root.ownerDocument;\n    const createTreeWalker = doc?.createTreeWalker;\n    if (typeof createTreeWalker === 'function') {\n      // NodeFilter.SHOW_ELEMENT === 1\n      const walker = createTreeWalker.call(doc, root, 1);\n      let n = walker.firstChild();\n      while (n) {\n        visit(n as Element);\n        n = walker.nextNode();\n      }\n      return;\n    }\n  } catch {\n    // SLOW PATH: TreeWalker unavailable\n  }\n\n  // Fallback: querySelectorAll\n  const descendants = root.querySelectorAll('*');\n  for (let i = 0; i < descendants.length; i++) {\n    visit(descendants[i]);\n  }\n}\n\nfunction forEachDescendantNode(root: Node, visit: (node: Node) => void) {\n  try {\n    const doc = root.ownerDocument;\n    const createTreeWalker = doc?.createTreeWalker;\n    if (typeof createTreeWalker === 'function') {\n      // NodeFilter.SHOW_ALL === 0xffffffff\n      const walker = createTreeWalker.call(doc, root, 0xffffffff);\n      let node = walker.nextNode();\n      while (node) {\n        visit(node);\n        node = walker.nextNode();\n      }\n      return;\n    }\n  } catch {\n    // SLOW PATH: TreeWalker unavailable\n  }\n\n  const stack = Array.from(root.childNodes).reverse();\n  while (stack.length > 0) {\n    const node = stack.pop()!;\n    visit(node);\n    for (let child = node.lastChild; child; child = child.previousSibling) {\n      stack.push(child);\n    }\n  }\n}\n\nfunction forEachElementInSubtree(root: Element, visit: (el: Element) => void) {\n  visit(root);\n  forEachDescendantElement(root, visit);\n}\n\n// Track listeners so we can remove them on cleanup\nexport interface ListenerMapEntry {\n  handler: EventListener;\n  original: EventListener;\n  eventName: string;\n  options?: boolean | AddEventListenerOptions;\n  isDelegated?: boolean;\n  updateHandler?: (nextHandler: EventListener) => void;\n}\nexport const elementListeners = new WeakMap<\n  Element,\n  Map<string, ListenerMapEntry>\n>();\n\n// ─────────────────────────────────────────────────────────────────────────────\n// Public API\n// ─────────────────────────────────────────────────────────────────────────────\n\n/**\n * Clean up component instance attached to a DOM node\n * Accepts an optional `opts.strict` flag to surface errors instead of swallowing them.\n */\nexport function cleanupInstanceIfPresent(\n  node: Node | null,\n  opts?: { strict?: boolean }\n): void {\n  if (!node) return;\n\n  const strict = opts?.strict ?? false;\n  const errors: unknown[] | null = strict ? [] : null;\n\n  // Clean up the node itself\n  try {\n    cleanupSingleInstance(node as InstanceHost, errors, strict);\n  } catch (err) {\n    if (strict) errors!.push(err);\n    else logger.warn('[Askr] cleanupInstanceIfPresent failed:', err);\n  }\n\n  // Clean up any nested instances, including null-component comment hosts.\n  try {\n    forEachDescendantNode(node, (descendant) => {\n      try {\n        cleanupSingleInstance(descendant as InstanceHost, errors, strict);\n      } catch (err) {\n        if (strict) errors!.push(err);\n        else\n          logger.warn(\n            '[Askr] cleanupInstanceIfPresent descendant cleanup failed:',\n            err\n          );\n      }\n    });\n  } catch (err) {\n    if (strict) errors!.push(err);\n    else\n      logger.warn(\n        '[Askr] cleanupInstanceIfPresent descendant query failed:',\n        err\n      );\n  }\n\n  if (errors && errors.length > 0) {\n    throw new AggregateError(errors, 'cleanupInstanceIfPresent failed');\n  }\n}\n\n// Public helper to clean up any component instances under a node. Used by\n// runtime commit logic to ensure component instances are torn down when their\n// host nodes are removed during an update.\nexport function cleanupInstancesUnder(\n  node: Node | null,\n  opts?: { strict?: boolean }\n): void {\n  cleanupInstanceIfPresent(node, opts);\n}\n\nexport function teardownNodeSubtree(\n  node: Node | null,\n  opts?: { strict?: boolean }\n): void {\n  if (!node) return;\n\n  const strict = opts?.strict ?? false;\n  const errors: unknown[] | null = strict ? [] : null;\n\n  if (!(node instanceof Element)) {\n    cleanupSingleInstance(node as InstanceHost, errors, strict);\n    if (errors && errors.length > 0) {\n      throw new AggregateError(errors, 'teardownNodeSubtree failed');\n    }\n    return;\n  }\n\n  try {\n    teardownSingleElement(node, errors, strict);\n    forEachDescendantNode(node, (descendant) => {\n      if (descendant instanceof Element) {\n        teardownSingleElement(descendant, errors, strict);\n      } else {\n        cleanupSingleInstance(descendant as InstanceHost, errors, strict);\n      }\n    });\n  } catch (err) {\n    if (strict) errors!.push(err);\n    else logger.warn('[Askr] teardownNodeSubtree failed:', err);\n  }\n\n  if (errors && errors.length > 0) {\n    throw new AggregateError(errors, 'teardownNodeSubtree failed');\n  }\n}\n\n// Track reactive props cleanup functions and their function references\nexport interface ReactivePropCleanupEntry {\n  cleanup: () => void;\n  fnRef: unknown;\n  updateFn?: (nextValue: unknown) => void;\n}\n\nexport const REACTIVE_CHILDREN_KEY = '__askr_reactive_children__';\n\nexport const elementReactivePropsCleanup = new WeakMap<\n  Element,\n  Map<string, ReactivePropCleanupEntry>\n>();\n\nexport function removeElementReactiveProps(element: Element): void {\n  const cleanupMap = elementReactivePropsCleanup.get(element);\n  if (cleanupMap) {\n    for (const entry of cleanupMap.values()) {\n      try {\n        entry.cleanup();\n      } catch (err) {\n        logger.warn('[Askr] reactive prop cleanup failed:', err);\n      }\n    }\n    elementReactivePropsCleanup.delete(element);\n  }\n}\n\nexport function removeElementListeners(element: Element): void {\n  const map = elementListeners.get(element);\n  if (map) {\n    for (const entry of map.values()) {\n      incDevCounter('listenerRemoves');\n      if (entry.isDelegated) {\n        removeDelegatedListener(element, entry.eventName);\n      } else {\n        if (entry.options !== undefined)\n          element.removeEventListener(\n            entry.eventName,\n            entry.handler,\n            entry.options\n          );\n        else element.removeEventListener(entry.eventName, entry.handler);\n      }\n    }\n    elementListeners.delete(element);\n  }\n\n  clearDelegatedHandlersForElement(element);\n}\n\nexport function removeAllListeners(root: Element | null): void {\n  if (!root) return;\n\n  forEachElementInSubtree(root, (el) => {\n    removeElementListeners(el);\n    removeElementReactiveProps(el);\n  });\n}\n"],"mappings":"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"}
+{"version":3,"file":"cleanup.js","names":[],"sources":["../../src/renderer/cleanup.ts"],"sourcesContent":["import { cleanupComponent } from '../runtime/component';\nimport type { ComponentInstance } from '../runtime/component';\nimport { logger } from '../dev/logger';\nimport { incDevCounter } from '../runtime/dev-namespace';\nimport {\n  clearDelegatedHandlersForElement,\n  removeDelegatedListener,\n} from '../runtime/events';\n\ntype InstanceHost = Node & {\n  __ASKR_INSTANCE?: unknown;\n  __ASKR_INSTANCES?: unknown[];\n};\n\n// ─────────────────────────────────────────────────────────────────────────────\n// Instance Cleanup Helpers\n// ─────────────────────────────────────────────────────────────────────────────\n\nfunction cleanupSingleInstance(\n  node: InstanceHost,\n  errors: unknown[] | null,\n  strict: boolean\n): void {\n  const instances = new Set<ComponentInstance>();\n\n  if (Array.isArray(node.__ASKR_INSTANCES)) {\n    for (const instance of node.__ASKR_INSTANCES) {\n      if (instance) {\n        instances.add(instance as ComponentInstance);\n      }\n    }\n  }\n\n  if (node.__ASKR_INSTANCE) {\n    instances.add(node.__ASKR_INSTANCE as ComponentInstance);\n  }\n\n  for (const instance of instances) {\n    try {\n      cleanupComponent(instance);\n    } catch (err) {\n      if (strict) errors!.push(err);\n      else logger.warn('[Askr] cleanupComponent failed:', err);\n    }\n  }\n\n  try {\n    delete node.__ASKR_INSTANCE;\n    delete node.__ASKR_INSTANCES;\n  } catch (e) {\n    if (strict) errors!.push(e);\n  }\n}\n\nfunction teardownSingleElement(\n  element: Element,\n  errors: unknown[] | null,\n  strict: boolean\n): void {\n  try {\n    removeElementListeners(element);\n  } catch (err) {\n    if (strict) errors!.push(err);\n    else logger.warn('[Askr] removeElementListeners failed:', err);\n  }\n\n  try {\n    removeElementReactiveProps(element);\n  } catch (err) {\n    if (strict) errors!.push(err);\n    else logger.warn('[Askr] removeElementReactiveProps failed:', err);\n  }\n\n  try {\n    cleanupSingleInstance(element as InstanceHost, errors, strict);\n  } catch (err) {\n    if (strict) errors!.push(err);\n    else logger.warn('[Askr] cleanupSingleInstance failed:', err);\n  }\n}\n\n// Walk descendant elements with minimal allocations.\n// HOT PATH: used during subtree teardown (replace/unmount).\nfunction forEachDescendantElement(root: Element, visit: (el: Element) => void) {\n  // Prefer TreeWalker when available; it avoids allocating a NodeList.\n  try {\n    const doc = root.ownerDocument;\n    const createTreeWalker = doc?.createTreeWalker;\n    if (typeof createTreeWalker === 'function') {\n      // NodeFilter.SHOW_ELEMENT === 1\n      const walker = createTreeWalker.call(doc, root, 1);\n      let n = walker.firstChild();\n      while (n) {\n        visit(n as Element);\n        n = walker.nextNode();\n      }\n      return;\n    }\n  } catch {\n    // SLOW PATH: TreeWalker unavailable\n  }\n\n  // Fallback: querySelectorAll\n  const descendants = root.querySelectorAll('*');\n  for (let i = 0; i < descendants.length; i++) {\n    visit(descendants[i]);\n  }\n}\n\nfunction forEachDescendantNode(root: Node, visit: (node: Node) => void) {\n  try {\n    const doc = root.ownerDocument;\n    const createTreeWalker = doc?.createTreeWalker;\n    if (typeof createTreeWalker === 'function') {\n      // NodeFilter.SHOW_ALL === 0xffffffff\n      const walker = createTreeWalker.call(doc, root, 0xffffffff);\n      let node = walker.nextNode();\n      while (node) {\n        visit(node);\n        node = walker.nextNode();\n      }\n      return;\n    }\n  } catch {\n    // SLOW PATH: TreeWalker unavailable\n  }\n\n  const stack = Array.from(root.childNodes).reverse();\n  while (stack.length > 0) {\n    const node = stack.pop()!;\n    visit(node);\n    for (let child = node.lastChild; child; child = child.previousSibling) {\n      stack.push(child);\n    }\n  }\n}\n\nfunction forEachElementInSubtree(root: Element, visit: (el: Element) => void) {\n  visit(root);\n  forEachDescendantElement(root, visit);\n}\n\n// Track listeners so we can remove them on cleanup\nexport interface ListenerMapEntry {\n  handler: EventListener;\n  original: EventListener;\n  eventName: string;\n  options?: boolean | AddEventListenerOptions;\n  isDelegated?: boolean;\n  updateHandler?: (nextHandler: EventListener) => void;\n}\nexport const elementListeners = new WeakMap<\n  Element,\n  Map<string, ListenerMapEntry>\n>();\n\n// ─────────────────────────────────────────────────────────────────────────────\n// Public API\n// ─────────────────────────────────────────────────────────────────────────────\n\n/**\n * Clean up component instance attached to a DOM node\n * Accepts an optional `opts.strict` flag to surface errors instead of swallowing them.\n */\nexport function cleanupInstanceIfPresent(\n  node: Node | null,\n  opts?: { strict?: boolean }\n): void {\n  if (!node) return;\n\n  const strict = opts?.strict ?? false;\n  const errors: unknown[] | null = strict ? [] : null;\n\n  // Clean up the node itself\n  try {\n    cleanupSingleInstance(node as InstanceHost, errors, strict);\n  } catch (err) {\n    if (strict) errors!.push(err);\n    else logger.warn('[Askr] cleanupInstanceIfPresent failed:', err);\n  }\n\n  // Clean up any nested instances, including null-component comment hosts.\n  try {\n    forEachDescendantNode(node, (descendant) => {\n      try {\n        cleanupSingleInstance(descendant as InstanceHost, errors, strict);\n      } catch (err) {\n        if (strict) errors!.push(err);\n        else\n          logger.warn(\n            '[Askr] cleanupInstanceIfPresent descendant cleanup failed:',\n            err\n          );\n      }\n    });\n  } catch (err) {\n    if (strict) errors!.push(err);\n    else\n      logger.warn(\n        '[Askr] cleanupInstanceIfPresent descendant query failed:',\n        err\n      );\n  }\n\n  if (errors && errors.length > 0) {\n    throw new AggregateError(errors, 'cleanupInstanceIfPresent failed');\n  }\n}\n\n// Public helper to clean up any component instances under a node. Used by\n// runtime commit logic to ensure component instances are torn down when their\n// host nodes are removed during an update.\nexport function cleanupInstancesUnder(\n  node: Node | null,\n  opts?: { strict?: boolean }\n): void {\n  cleanupInstanceIfPresent(node, opts);\n}\n\nexport function teardownNodeSubtree(\n  node: Node | null,\n  opts?: { strict?: boolean }\n): void {\n  if (!node) return;\n\n  const strict = opts?.strict ?? false;\n  const errors: unknown[] | null = strict ? [] : null;\n\n  if (!(node instanceof Element)) {\n    cleanupSingleInstance(node as InstanceHost, errors, strict);\n    if (errors && errors.length > 0) {\n      throw new AggregateError(errors, 'teardownNodeSubtree failed');\n    }\n    return;\n  }\n\n  try {\n    teardownSingleElement(node, errors, strict);\n    forEachDescendantNode(node, (descendant) => {\n      if (descendant instanceof Element) {\n        teardownSingleElement(descendant, errors, strict);\n      } else {\n        cleanupSingleInstance(descendant as InstanceHost, errors, strict);\n      }\n    });\n  } catch (err) {\n    if (strict) errors!.push(err);\n    else logger.warn('[Askr] teardownNodeSubtree failed:', err);\n  }\n\n  if (errors && errors.length > 0) {\n    throw new AggregateError(errors, 'teardownNodeSubtree failed');\n  }\n}\n\n// Track reactive props cleanup functions and their function references\nexport interface ReactivePropCleanupEntry {\n  cleanup: () => void;\n  fnRef: unknown;\n  updateFn?: (nextValue: unknown) => void;\n}\n\nexport const REACTIVE_CHILDREN_KEY = '__askr_reactive_children__';\n\nexport const elementReactivePropsCleanup = new WeakMap<\n  Element,\n  Map<string, ReactivePropCleanupEntry>\n>();\n\nexport function removeElementReactiveProps(element: Element): void {\n  const cleanupMap = elementReactivePropsCleanup.get(element);\n  if (cleanupMap) {\n    for (const entry of cleanupMap.values()) {\n      try {\n        entry.cleanup();\n      } catch (err) {\n        logger.warn('[Askr] reactive prop cleanup failed:', err);\n      }\n    }\n    elementReactivePropsCleanup.delete(element);\n  }\n}\n\nexport function removeElementListeners(element: Element): void {\n  const map = elementListeners.get(element);\n  if (map) {\n    for (const entry of map.values()) {\n      incDevCounter('listenerRemoves');\n      if (entry.isDelegated) {\n        removeDelegatedListener(element, entry.eventName);\n      } else {\n        if (entry.options !== undefined)\n          element.removeEventListener(\n            entry.eventName,\n            entry.handler,\n            entry.options\n          );\n        else element.removeEventListener(entry.eventName, entry.handler);\n      }\n    }\n    elementListeners.delete(element);\n  }\n\n  clearDelegatedHandlersForElement(element);\n}\n\nexport function removeAllListeners(root: Element | null): void {\n  if (!root) return;\n\n  forEachElementInSubtree(root, (el) => {\n    removeElementListeners(el);\n    removeElementReactiveProps(el);\n  });\n}\n"],"mappings":"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"}

package/dist/renderer/dom.js

@@ -1301,11 +1301,12 @@ function isFragmentVNode(node) {
 }
 function normalizeComponentChildren(result) {
 	if (result === null || result === void 0 || result === false) return [];
-	if (Array.isArray(result)) return result;
-	if (isFragmentVNode(result)) {
-		const children = result.props?.children ?? result.children ?? [];
-		return Array.isArray(children) ? children : [children];
+	if (Array.isArray(result)) {
+		const children = [];
+		for (const child of result) children.push(...normalizeComponentChildren(child));
+		return children;
 	}
+	if (isFragmentVNode(result)) return normalizeComponentChildren(result.props?.children ?? result.children ?? []);
 	return [result];
 }
 function syncComponentElement(currentDom, node, type, props, parentNamespace, forceChildrenUpdate = false, retainedHostInstances) {
@@ -1973,21 +1974,22 @@ function updateElementChildren(el, children, forceUpdate = false) {
 		return;
 	}
 	if (Array.isArray(children)) {
-		if (trySyncScalarChildSequenceInPlace(el, children)) {
+		const normalizedChildren = normalizeComponentChildren(children);
+		if (trySyncScalarChildSequenceInPlace(el, normalizedChildren)) {
 			keyedElements.delete(el);
 			return;
 		}
-		if (hasKeyedVNodeChildren(children)) {
-			const newKeyMap = reconcileKeyedChildren(el, children, getOrBuildDomKeyMap(el));
+		if (hasKeyedVNodeChildren(normalizedChildren)) {
+			const newKeyMap = reconcileKeyedChildren(el, normalizedChildren, getOrBuildDomKeyMap(el));
 			keyedElements.set(el, newKeyMap);
 			return;
 		}
-		if (isBulkTextFastPathEligible(el, children)) {
-			performBulkTextReplace(el, children);
+		if (isBulkTextFastPathEligible(el, normalizedChildren)) {
+			performBulkTextReplace(el, normalizedChildren);
 			keyedElements.delete(el);
 			return;
 		}
-		updateUnkeyedChildren(el, children, forceUpdate);
+		updateUnkeyedChildren(el, normalizedChildren, forceUpdate);
 		return;
 	}
 	if (_isDOMElement(children)) {