@pibbl/core 0.0.2 → 0.0.3-alpha.90.1

package/dist/internal.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../src/internal.ts"],
-  "sourcesContent": ["import type { PibblInternalFrame, pibblInternalOnRenderFinish, pibblInternalRequestRender } from './lib/scheduler/renderer-participant.js';\nimport type { PibblConfig, PibblPixelRatio } from './lib/surface/types.js';\n/**\n * @packageDocumentation\n * Reserved for official Pibbl packages that are released in lockstep with\n * `@pibbl/core`. This version-coupled module is not a stable third-party plugin\n * API and intentionally does not re-export the public root module.\n */\n\nexport { createBackendToken } from \"./lib/backend/types.js\";\nexport type {\n  PibblBackendDriver,\n  PibblBackendEventTargetOptions,\n  PibblBackendFrame,\n  PibblBackendFrameInput,\n  PibblBackendMount,\n  PibblBackendMountOptions,\n  PibblBackendPrimitiveDefinition,\n  PibblBackendPrimitiveInput,\n  PibblBackendPrimitiveProgram,\n  PibblBackendToken,\n  PibblNestedResolverInput,\n} from \"./lib/backend/types.js\";\nexport type { SignalProgramProps, SignalStyle } from \"./lib/types.js\";\nexport {\n  pibblInternalRunPurePrimitiveResolver,\n  defineBackendPrimitive,\n  derivePrimitive,\n} from \"./lib/define-primitive.js\";\nexport { mountBackendPibbl } from \"./lib/mount-pibbl.js\";\nexport {\n  useInternalHookSlot,\n  withHooksForbidden,\n} from \"./lib/hooks/hook-slot.js\";\nexport { useValueMemoSlot as useInternalValueMemoSlot } from \"./lib/hooks/use-value-memo-slot.js\";\nexport {\n  haveSameLayerNodeTree,\n  materializeRetainedLayerChildren,\n  snapshotLayerNodeTree,\n} from \"./lib/components/layer-node-equality.js\";\nexport type { LayerNodeSnapshot } from \"./lib/components/layer-node-equality.js\";\nexport type { PibblEventTargetRegistration } from \"./lib/events/registrations.js\";\nexport type { PibblElementSource } from \"./lib/element/metadata.js\";\nexport { pibblInternalCreatePropAttachment } from \"./lib/element-enhancers.js\";\nexport type {\n  PibblInternalMountedPropAttachment,\n  PibblInternalPrimitiveAttachmentInput,\n} from \"./lib/element-enhancers.js\";\nexport type { PibblHitTestOutput } from \"./lib/events/paint-entry.js\";\nexport { hasPibblEventHandler } from \"./lib/events/event-definitions.js\";\nexport {\n  pibblInternalCurrentSimulationOwner,\n  pibblInternalOnSimulationRenderTransactionFinish,\n  pibblInternalQueueSimulationBegin,\n  pibblInternalQueueSimulationCommitAcknowledgement,\n  pibblInternalQueueSimulationComplete,\n  pibblInternalRegisterSimulationAdvance,\n  pibblInternalRequestSimulationRender,\n} from \"./lib/scheduler/simulation-participant.js\";\nexport type {\n  PibblInternalAdvanceLane,\n  PibblInternalSimulationOwner,\n} from \"./lib/scheduler/simulation-participant.js\";\n\nimport type {\n  PibblBackendEventTargetOptions,\n  PibblBackendMount,\n  PibblBackendToken,\n  PibblNestedResolverInput,\n} from \"./lib/backend/types.js\";\nimport {\n  createTarget,\n  releaseTarget,\n  updateTarget,\n  type PibblEventTargetRegistration,\n} from \"./lib/events/registrations.js\";\nimport { PibblPaintEntryKind } from \"./lib/events/paint-entry.js\";\nimport type { PibblEventHandlers, PibblPointerEvents } from \"./lib/events/types.js\";\nimport { getCurrentPibblInstance, GLOBAL_STATE } from \"./lib/global-state.js\";\nimport {\n  requireHookContext,\n  useInternalHookSlot,\n} from \"./lib/hooks/hook-slot.js\";\nimport { getCurrentWorldTransform } from \"./lib/render-target.js\";\nimport {\n  getElementSource,\n  type PibblElementSource,\n} from \"./lib/element/metadata.js\";\nimport { getSurfaceSnapshot } from \"./lib/surface/transform.js\";\nimport type {\n  Canvas,\n  PibblComponentRefs,\n  PibblInstance,\n} from \"./lib/types.js\";\nimport type { PibblInteractionLayer } from \"./lib/types.js\";\nimport { update } from \"./lib/update.js\";\nimport { queueBeginCommand } from \"./lib/scheduler/realm-scheduler.js\";\nimport type { PibblBeginCommandHandle } from \"./lib/scheduler/types.js\";\n\ninterface CurrentInstanceFrameRequestState {\n  readonly componentRefs: PibblComponentRefs<any>;\n  readonly instance: PibblInstance;\n  active: boolean;\n  handle: PibblBeginCommandHandle | undefined;\n  updateParents: boolean;\n}\n\nconst frameRequestsByComponent = new WeakMap<\n  PibblComponentRefs<any>,\n  CurrentInstanceFrameRequestState\n>();\n/**\n * Reads the selected official backend's current frame environment.\n *\n * @param token - Backend identity required by the caller. See {@link PibblBackendToken}.\n * @returns The active environment for that backend.\n *\n * @see {@link PibblBackendToken}\n */\nexport function getBackendEnvironment<E>(token: PibblBackendToken): E {\n  const driver = GLOBAL_STATE.backendDriver;\n  const frame = GLOBAL_STATE.backendFrame;\n  if (!driver || !frame || driver.token !== token) {\n    throw new Error(\"The requested Pibbl backend environment is not active.\");\n  }\n  return frame.environment as E;\n}\n\n/**\n * Returns the timestamp shared by the current Pibbl render transaction.\n *\n * @returns The active frame timestamp in milliseconds.\n *\n * @see {@link PibblInternalFrame}\n */\nexport function getCurrentFrameTimestamp(): number {\n  return getCurrentPibblInstance().renderTimestamp;\n}\n\n/**\n * Returns the active instance's owning Canvas, never a transient filter target.\n *\n * @returns The host canvas of the active backend mount. See {@link Canvas}.\n *\n * @see {@link Canvas}\n */\nexport function getCurrentBackendHostCanvas(): Canvas {\n  return getCurrentPibblInstance().canvas;\n}\n\n/**\n * Returns development JSX source metadata for the current component.\n *\n * @returns Source metadata for the current element, or undefined when unavailable. See\n * {@link PibblElementSource} .\n *\n * @see {@link PibblElementSource}\n */\nexport function getCurrentElementSource(): PibblElementSource | undefined {\n  const { componentRefs } = requireHookContext();\n  return getElementSource(componentRefs.element);\n}\n\n/**\n * Returns the active surface's independent effective backing densities.\n *\n * @returns Backing pixels per logical unit on each axis.\n *\n * @see {@link PibblPixelRatio}\n */\nexport function getCurrentSurfaceDensity(): Readonly<{ x: number; y: number }> {\n  const surface = getSurfaceSnapshot(getCurrentPibblInstance());\n  return Object.freeze({\n    x: surface.backingPixelsPerLogicalUnitX,\n    y: surface.backingPixelsPerLogicalUnitY,\n  });\n}\n\n/**\n * Returns the active root-logical viewport for an official renderer hook.\n *\n * @returns The current logical viewport width and height.\n *\n * @see {@link PibblConfig}\n */\nexport function getCurrentLogicalViewport(): Readonly<{\n  width: number;\n  height: number;\n}> {\n  const surface = getSurfaceSnapshot(getCurrentPibblInstance());\n  return Object.freeze({\n    width: surface.logicalWidth,\n    height: surface.logicalHeight,\n  });\n}\n\n/**\n * Registers a callback on the root-wide transaction containing this render.\n *\n * @param callback - Callback receiving whether the current render transaction succeeded.\n *\n * @see {@link pibblInternalOnRenderFinish}\n */\nexport function onCurrentRenderFinish(\n  callback: (success: boolean) => void,\n): void {\n  requireHookContext();\n  const transaction = GLOBAL_STATE.renderTransaction;\n  if (!transaction) {\n    throw new Error(\"No Pibbl render transaction is active.\");\n  }\n  transaction.onFinish(callback);\n}\n\n/**\n * Requests a coalesced frame for the current private backend instance.\n *\n * @param updateParents - Whether ancestor compositions should also receive a frame request.\n *\n * @see {@link pibblInternalRequestRender}\n */\nexport function requestCurrentInstanceFrame(updateParents: boolean): void {\n  const { componentRefs, pibblInstance } = requireHookContext();\n  let state = frameRequestsByComponent.get(componentRefs);\n  if (!state) {\n    state = {\n      componentRefs,\n      instance: pibblInstance,\n      active: true,\n      handle: undefined,\n      updateParents: false,\n    };\n    frameRequestsByComponent.set(componentRefs, state);\n    componentRefs.teardowns.add(() =>\n      releaseCurrentInstanceFrameRequest(state!),\n    );\n  }\n  state.updateParents ||= updateParents;\n  if (state.handle) return;\n  state.handle = queueBeginCommand(() => {\n    state!.handle = undefined;\n    const updateParentsForFrame = state!.updateParents;\n    state!.updateParents = false;\n    if (!isCurrentInstanceFrameRequestActive(state!)) return;\n    if (updateParentsForFrame) {\n      update(state!.instance.canvas, undefined, true);\n    } else {\n      update(state!.instance.canvas);\n    }\n  });\n}\n\n/**\n * Retains one geometry-independent target for an official backend picker.\n *\n * @param handlers - Handlers for the backend target. See {@link PibblEventHandlers}.\n * @param options - Backend geometry and focus metadata. See {@link PibblBackendEventTargetOptions}.\n * @param pointerEvents - Pointer participation policy; defaults to auto. See\n * {@link PibblPointerEvents} .\n * @returns The live registration, or undefined when registration is unnecessary. See\n * {@link PibblEventTargetRegistration} .\n *\n * @see {@link PibblEventHandlers}\n * @see {@link PibblBackendEventTargetOptions}\n * @see {@link PibblPointerEvents}\n * @see {@link PibblEventTargetRegistration}\n */\nexport function useBackendEventTarget(\n  handlers: PibblEventHandlers,\n  options: PibblBackendEventTargetOptions = {},\n  pointerEvents: PibblPointerEvents = \"auto\",\n): PibblEventTargetRegistration | undefined {\n  const { componentRefs, pibblInstance } = requireHookContext();\n  const hookIndex = GLOBAL_STATE.componentHookIndex;\n  const slot = useInternalHookSlot(\"backendEventTarget\", (teardowns) => {\n    const target = createTarget(pibblInstance, componentRefs, hookIndex);\n    teardowns.add(() => releaseTarget(target));\n    return { target, emptyPath: new Path2D() };\n  });\n  const { target, emptyPath } = slot.value;\n  if (pointerEvents === \"none\") {\n    releaseTarget(target);\n    return undefined;\n  }\n  updateTarget(\n    target,\n    handlers,\n    { ...options, path: emptyPath },\n    true,\n    options.deferKeyboardNavigationGeometry ?? false,\n  );\n  if (target.paintEntry) {\n    target.owner.paintEntries.delete(target.paintEntry);\n    target.paintEntry = undefined;\n  }\n  return target;\n}\n\n/**\n * Tests whether an official backend target can still win coordinate picking.\n *\n * @param target - Registration whose ownership is being checked. See\n * {@link PibblEventTargetRegistration} .\n * @returns Whether the target registration is still live.\n *\n * @see {@link PibblEventTargetRegistration}\n */\nexport function isBackendEventTargetLive(\n  target: PibblEventTargetRegistration,\n): boolean {\n  const { owner } = target;\n  return (\n    target.live &&\n    !owner.mainTeardowns.closed &&\n    owner.eventRoot.targets.has(target)\n  );\n}\n\n/**\n * Temporarily releases one backend target; its retained hook may enroll it again.\n *\n * @param target - Target registration to release. See {@link PibblEventTargetRegistration}.\n *\n * @see {@link PibblEventTargetRegistration}\n */\nexport function releaseBackendEventTarget(\n  target: PibblEventTargetRegistration,\n): void {\n  releaseTarget(target);\n  target.keyboardNavigationBounds = undefined;\n  target.keyboardNavigationPoints = undefined;\n}\n\n/**\n * Registers work that runs after this component's rendered descendants.\n *\n * @param callback - Callback to execute after the current component renders.\n *\n * @see {@link pibblInternalOnRenderFinish}\n */\nexport function setCurrentComponentAfterRender(callback: () => void): void {\n  const { componentRefs } = requireHookContext();\n  const previous = componentRefs.onAfterRender;\n  componentRefs.onAfterRender = previous\n    ? () => {\n        try {\n          previous();\n        } finally {\n          callback();\n        }\n      }\n    : callback;\n}\n\n/**\n * Installs one stable nested backend resolver in the current Canvas paint order.\n *\n * @param input - Nested coordinate resolver and its target metadata. See\n * {@link PibblNestedResolverInput} .\n *\n * @see {@link PibblNestedResolverInput}\n */\nexport function registerNestedInteractionResolver(\n  input: PibblNestedResolverInput,\n): void {\n  const { componentRefs, pibblInstance } = requireHookContext();\n  const childInstance = backendMountInstance(input.child);\n  if (\n    childInstance.parent !== pibblInstance.canvas ||\n    childInstance.eventRoot !== pibblInstance.eventRoot\n  ) {\n    throw new Error(\n      \"A nested Pibbl backend mount must belong to the current instance and same event root.\",\n    );\n  }\n  const slot = useInternalHookSlot<{\n    entry: PibblInteractionLayer;\n    child: PibblBackendMount;\n  }>(\"nestedInteractionResolver\", (teardowns) => {\n    const entry: PibblInteractionLayer = {\n      paintKind: PibblPaintEntryKind.Resolver,\n      instance: childInstance,\n      bounds: input.bounds,\n      transform: new DOMMatrix(),\n      clippingStack: [],\n      resolveLocal: input.resolveLocal,\n    };\n    const value = { entry, child: input.child };\n    teardowns.add(() => {\n      pibblInstance.paintEntries.delete(entry);\n      if (entry.instance.focusParentBridge === entry) {\n        entry.instance.focusParentBridge = undefined;\n      }\n      if (entry.instance.eventParent === componentRefs) {\n        entry.instance.eventParent = undefined;\n      }\n    });\n    return value;\n  });\n  const { entry } = slot.value;\n  if (\n    (childInstance.eventParent !== undefined &&\n      childInstance.eventParent !== componentRefs) ||\n    (childInstance.focusParentBridge !== undefined &&\n      childInstance.focusParentBridge !== entry)\n  ) {\n    throw new Error(\n      \"A nested Pibbl backend mount already belongs to another nested resolver.\",\n    );\n  }\n  pibblInstance.paintEntries.delete(entry);\n  if (slot.value.child !== input.child) {\n    if (entry.instance.focusParentBridge === entry) {\n      entry.instance.focusParentBridge = undefined;\n    }\n    if (entry.instance.eventParent === componentRefs) {\n      entry.instance.eventParent = undefined;\n    }\n    slot.value.child = input.child;\n  }\n  entry.instance = childInstance;\n  entry.instance.eventParent = componentRefs;\n  entry.bounds = input.bounds;\n  entry.transform = getCurrentWorldTransform();\n  entry.clippingStack = Array.from(GLOBAL_STATE.clippingStack);\n  entry.resolveLocal = input.resolveLocal;\n  entry.instance.focusParentBridge = entry;\n  if (input.pointerEvents === \"auto\") {\n    pibblInstance.paintEntries.add(entry);\n  }\n}\n\nfunction backendMountInstance(mount: PibblBackendMount) {\n  const instance = GLOBAL_STATE.pibblInstances.get(mount.canvas);\n  if (!instance) {\n    throw new Error(\"Nested Pibbl backend mount is not active.\");\n  }\n  return instance;\n}\n\nfunction cancelCurrentInstanceFrameRequest(\n  state: CurrentInstanceFrameRequestState,\n): void {\n  state.handle?.cancel();\n  state.handle = undefined;\n  state.updateParents = false;\n}\n\nfunction releaseCurrentInstanceFrameRequest(\n  state: CurrentInstanceFrameRequestState,\n): void {\n  if (!state.active) return;\n  state.active = false;\n  cancelCurrentInstanceFrameRequest(state);\n  frameRequestsByComponent.delete(state.componentRefs);\n\n}\n\nfunction isCurrentInstanceFrameRequestActive(\n  state: CurrentInstanceFrameRequestState,\n): boolean {\n  return (\n    state.active &&\n    !state.componentRefs.teardowns.closed &&\n    !state.instance.mainTeardowns.closed &&\n    GLOBAL_STATE.pibblInstances.get(state.instance.canvas) === state.instance &&\n    state.instance.refs.get(state.componentRefs.id) === state.componentRefs\n  );\n}\nexport {\n  pibblInternalAssertCommandAllowed,\n  pibblInternalCreateSignalConsumer,\n  pibblInternalCurrentFrame,\n  pibblInternalCurrentRenderOwner,\n  pibblInternalOnRenderFinish,\n  pibblInternalPaintTarget,\n  pibblInternalQueueBegin,\n  pibblInternalQueueComplete,\n  pibblInternalQueueCurrentCommit,\n  pibblInternalQueueCurrentComplete,\n  pibblInternalRegisterAdvance,\n  pibblInternalRequestRender,\n  pibblInternalRequestRendererWork,\n} from \"./lib/scheduler/renderer-participant.js\";\nexport type {\n  PibblInternalCommandHandle,\n  PibblInternalFrame,\n  PibblInternalRendererWorkKind,\n  PibblInternalRenderOwner,\n  PibblInternalSignalBatch,\n  PibblInternalSignalConsumer,\n} from \"./lib/scheduler/renderer-participant.js\";\n\nexport { pushLayoutBox } from \"./lib/layout/context.js\";\n\nexport {\n  ManualSchedulerDriver as PibblInternalManualSchedulerDriver,\n  installSchedulerDriverForTest as pibblInternalInstallTestSchedulerDriver,\n  snapshotRealmScheduler as pibblInternalSnapshotRealmScheduler,\n} from \"./lib/scheduler/testing.js\";\n\nexport { getCurrentWorldTransform as pibblInternalCurrentWorldTransform } from \"./lib/render-target.js\";\n\nexport { borrowTextureRaster, resolveTexturePaint, validateTexturePaint } from './lib/textures/texture-protocol.js';\nexport type { BorrowedTextureRaster } from './lib/textures/texture-protocol.js';\n"],
-  "mappings": "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",
+  "sourcesContent": ["import type { PibblInternalFrame, pibblInternalOnRenderFinish, pibblInternalRequestRender } from './lib/scheduler/renderer-participant.js';\nimport type { PibblConfig, PibblPixelRatio } from './lib/surface/types.js';\n/**\n * @packageDocumentation\n * Reserved for official Pibbl packages that are released in lockstep with\n * `@pibbl/core`. This version-coupled module is not a stable third-party plugin\n * API and intentionally does not re-export the public root module.\n */\n\nexport { createBackendToken } from \"./lib/backend/types.js\";\nexport type {\n  PibblBackendDriver,\n  PibblBackendEventTargetOptions,\n  PibblBackendFrame,\n  PibblBackendFrameInput,\n  PibblBackendMount,\n  PibblBackendMountOptions,\n  PibblBackendPrimitiveDefinition,\n  PibblBackendPrimitiveInput,\n  PibblBackendPrimitiveProgram,\n  PibblBackendToken,\n  PibblNestedResolverInput,\n} from \"./lib/backend/types.js\";\nexport type { SignalProgramProps, SignalStyle } from \"./lib/types.js\";\nexport {\n  pibblInternalRunPurePrimitiveResolver,\n  defineBackendPrimitive,\n  derivePrimitive,\n} from \"./lib/define-primitive.js\";\nexport { mountBackendPibbl } from \"./lib/mount-pibbl.js\";\nexport {\n  useInternalHookSlot,\n  withHooksForbidden,\n} from \"./lib/hooks/hook-slot.js\";\nexport { useValueMemoSlot as useInternalValueMemoSlot } from \"./lib/hooks/use-value-memo-slot.js\";\nexport {\n  haveSameLayerNodeTree,\n  materializeRetainedLayerChildren,\n  snapshotLayerNodeTree,\n} from \"./lib/components/layer-node-equality.js\";\nexport type { LayerNodeSnapshot } from \"./lib/components/layer-node-equality.js\";\nexport type { PibblEventTargetRegistration } from \"./lib/events/registrations.js\";\nexport type { PibblElementSource } from \"./lib/element/metadata.js\";\nexport { pibblInternalCreatePropAttachment } from \"./lib/element-enhancers.js\";\nexport type {\n  PibblInternalMountedPropAttachment,\n  PibblInternalPrimitiveAttachmentInput,\n} from \"./lib/element-enhancers.js\";\nexport type { PibblHitTestOutput } from \"./lib/events/paint-entry.js\";\nexport { hasPibblEventHandler } from \"./lib/events/event-definitions.js\";\nexport {\n  pibblInternalCurrentSimulationOwner,\n  pibblInternalOnSimulationRenderTransactionFinish,\n  pibblInternalQueueSimulationBegin,\n  pibblInternalQueueSimulationCommitAcknowledgement,\n  pibblInternalQueueSimulationComplete,\n  pibblInternalRegisterSimulationAdvance,\n  pibblInternalRequestSimulationRender,\n} from \"./lib/scheduler/simulation-participant.js\";\nexport type {\n  PibblInternalAdvanceLane,\n  PibblInternalSimulationOwner,\n} from \"./lib/scheduler/simulation-participant.js\";\n\nimport type {\n  PibblBackendEventTargetOptions,\n  PibblBackendMount,\n  PibblBackendToken,\n  PibblNestedResolverInput,\n} from \"./lib/backend/types.js\";\nimport {\n  createTarget,\n  releaseTarget,\n  updateTarget,\n  type PibblEventTargetRegistration,\n} from \"./lib/events/registrations.js\";\nimport { PibblPaintEntryKind } from \"./lib/events/paint-entry.js\";\nimport type { PibblEventHandlers, PibblPointerEvents } from \"./lib/events/types.js\";\nimport { getCurrentPibblInstance, GLOBAL_STATE } from \"./lib/global-state.js\";\nexport { captureSeriesInspectionFrame } from \"./lib/series-inspection-frame.js\";\nexport { borrowDispatchResource } from \"./lib/events/event-facade.js\";\nimport {\n  requireHookContext,\n  useInternalHookSlot,\n} from \"./lib/hooks/hook-slot.js\";\nimport { getCurrentWorldTransform } from \"./lib/render-target.js\";\nimport {\n  getElementSource,\n  type PibblElementSource,\n} from \"./lib/element/metadata.js\";\nimport { getSurfaceSnapshot } from \"./lib/surface/transform.js\";\nimport type {\n  Canvas,\n  PibblComponentRefs,\n  PibblInstance,\n} from \"./lib/types.js\";\nimport type { PibblInteractionLayer } from \"./lib/types.js\";\nimport { update } from \"./lib/update.js\";\nimport { queueBeginCommand } from \"./lib/scheduler/realm-scheduler.js\";\nimport type { PibblBeginCommandHandle } from \"./lib/scheduler/types.js\";\n\ninterface CurrentInstanceFrameRequestState {\n  readonly componentRefs: PibblComponentRefs<any>;\n  readonly instance: PibblInstance;\n  active: boolean;\n  handle: PibblBeginCommandHandle | undefined;\n  updateParents: boolean;\n}\n\nconst frameRequestsByComponent = new WeakMap<\n  PibblComponentRefs<any>,\n  CurrentInstanceFrameRequestState\n>();\n/**\n * Reads the selected official backend's current frame environment.\n *\n * @param token - Backend identity required by the caller. See {@link PibblBackendToken}.\n * @returns The active environment for that backend.\n *\n * @see {@link PibblBackendToken}\n */\nexport function getBackendEnvironment<E>(token: PibblBackendToken): E {\n  const driver = GLOBAL_STATE.backendDriver;\n  const frame = GLOBAL_STATE.backendFrame;\n  if (!driver || !frame || driver.token !== token) {\n    throw new Error(\"The requested Pibbl backend environment is not active.\");\n  }\n  return frame.environment as E;\n}\n\n/**\n * Returns the timestamp shared by the current Pibbl render transaction.\n *\n * @returns The active frame timestamp in milliseconds.\n *\n * @see {@link PibblInternalFrame}\n */\nexport function getCurrentFrameTimestamp(): number {\n  return getCurrentPibblInstance().renderTimestamp;\n}\n\n/**\n * Returns the active instance's owning Canvas, never a transient filter target.\n *\n * @returns The host canvas of the active backend mount. See {@link Canvas}.\n *\n * @see {@link Canvas}\n */\nexport function getCurrentBackendHostCanvas(): Canvas {\n  return getCurrentPibblInstance().canvas;\n}\n\n/**\n * Returns development JSX source metadata for the current component.\n *\n * @returns Source metadata for the current element, or undefined when unavailable. See\n * {@link PibblElementSource} .\n *\n * @see {@link PibblElementSource}\n */\nexport function getCurrentElementSource(): PibblElementSource | undefined {\n  const { componentRefs } = requireHookContext();\n  return getElementSource(componentRefs.element);\n}\n\n/**\n * Returns the active surface's independent effective backing densities.\n *\n * @returns Backing pixels per logical unit on each axis.\n *\n * @see {@link PibblPixelRatio}\n */\nexport function getCurrentSurfaceDensity(): Readonly<{ x: number; y: number }> {\n  const surface = getSurfaceSnapshot(getCurrentPibblInstance());\n  return Object.freeze({\n    x: surface.backingPixelsPerLogicalUnitX,\n    y: surface.backingPixelsPerLogicalUnitY,\n  });\n}\n\n/**\n * Returns the active root-logical viewport for an official renderer hook.\n *\n * @returns The current logical viewport width and height.\n *\n * @see {@link PibblConfig}\n */\nexport function getCurrentLogicalViewport(): Readonly<{\n  width: number;\n  height: number;\n}> {\n  const surface = getSurfaceSnapshot(getCurrentPibblInstance());\n  return Object.freeze({\n    width: surface.logicalWidth,\n    height: surface.logicalHeight,\n  });\n}\n\n/**\n * Registers a callback on the root-wide transaction containing this render.\n *\n * @param callback - Callback receiving whether the current render transaction succeeded.\n *\n * @see {@link pibblInternalOnRenderFinish}\n */\nexport function onCurrentRenderFinish(\n  callback: (success: boolean) => void,\n): void {\n  requireHookContext();\n  const transaction = GLOBAL_STATE.renderTransaction;\n  if (!transaction) {\n    throw new Error(\"No Pibbl render transaction is active.\");\n  }\n  transaction.onFinish(callback);\n}\n\n/**\n * Requests a coalesced frame for the current private backend instance.\n *\n * @param updateParents - Whether ancestor compositions should also receive a frame request.\n *\n * @see {@link pibblInternalRequestRender}\n */\nexport function requestCurrentInstanceFrame(updateParents: boolean): void {\n  const { componentRefs, pibblInstance } = requireHookContext();\n  let state = frameRequestsByComponent.get(componentRefs);\n  if (!state) {\n    state = {\n      componentRefs,\n      instance: pibblInstance,\n      active: true,\n      handle: undefined,\n      updateParents: false,\n    };\n    frameRequestsByComponent.set(componentRefs, state);\n    componentRefs.teardowns.add(() =>\n      releaseCurrentInstanceFrameRequest(state!),\n    );\n  }\n  state.updateParents ||= updateParents;\n  if (state.handle) return;\n  state.handle = queueBeginCommand(() => {\n    state!.handle = undefined;\n    const updateParentsForFrame = state!.updateParents;\n    state!.updateParents = false;\n    if (!isCurrentInstanceFrameRequestActive(state!)) return;\n    if (updateParentsForFrame) {\n      update(state!.instance.canvas, undefined, true);\n    } else {\n      update(state!.instance.canvas);\n    }\n  });\n}\n\n/**\n * Retains one geometry-independent target for an official backend picker.\n *\n * @param handlers - Handlers for the backend target. See {@link PibblEventHandlers}.\n * @param options - Backend geometry and focus metadata. See {@link PibblBackendEventTargetOptions}.\n * @param pointerEvents - Pointer participation policy; defaults to auto. See\n * {@link PibblPointerEvents} .\n * @returns The live registration, or undefined when registration is unnecessary. See\n * {@link PibblEventTargetRegistration} .\n *\n * @see {@link PibblEventHandlers}\n * @see {@link PibblBackendEventTargetOptions}\n * @see {@link PibblPointerEvents}\n * @see {@link PibblEventTargetRegistration}\n */\nexport function useBackendEventTarget(\n  handlers: PibblEventHandlers,\n  options: PibblBackendEventTargetOptions = {},\n  pointerEvents: PibblPointerEvents = \"auto\",\n): PibblEventTargetRegistration | undefined {\n  const { componentRefs, pibblInstance } = requireHookContext();\n  const hookIndex = GLOBAL_STATE.componentHookIndex;\n  const slot = useInternalHookSlot(\"backendEventTarget\", (teardowns) => {\n    const target = createTarget(pibblInstance, componentRefs, hookIndex);\n    teardowns.add(() => releaseTarget(target));\n    return { target, emptyPath: new Path2D() };\n  });\n  const { target, emptyPath } = slot.value;\n  if (pointerEvents === \"none\") {\n    releaseTarget(target);\n    return undefined;\n  }\n  updateTarget(\n    target,\n    handlers,\n    { ...options, path: emptyPath },\n    true,\n    options.deferKeyboardNavigationGeometry ?? false,\n  );\n  if (target.paintEntry) {\n    target.owner.paintEntries.delete(target.paintEntry);\n    target.paintEntry = undefined;\n  }\n  return target;\n}\n\n/**\n * Tests whether an official backend target can still win coordinate picking.\n *\n * @param target - Registration whose ownership is being checked. See\n * {@link PibblEventTargetRegistration} .\n * @returns Whether the target registration is still live.\n *\n * @see {@link PibblEventTargetRegistration}\n */\nexport function isBackendEventTargetLive(\n  target: PibblEventTargetRegistration,\n): boolean {\n  const { owner } = target;\n  return (\n    target.live &&\n    !owner.mainTeardowns.closed &&\n    owner.eventRoot.targets.has(target)\n  );\n}\n\n/**\n * Temporarily releases one backend target; its retained hook may enroll it again.\n *\n * @param target - Target registration to release. See {@link PibblEventTargetRegistration}.\n *\n * @see {@link PibblEventTargetRegistration}\n */\nexport function releaseBackendEventTarget(\n  target: PibblEventTargetRegistration,\n): void {\n  releaseTarget(target);\n  target.keyboardNavigationBounds = undefined;\n  target.keyboardNavigationPoints = undefined;\n}\n\n/**\n * Registers work that runs after this component's rendered descendants.\n *\n * @param callback - Callback to execute after the current component renders.\n *\n * @see {@link pibblInternalOnRenderFinish}\n */\nexport function setCurrentComponentAfterRender(callback: () => void): void {\n  const { componentRefs } = requireHookContext();\n  const previous = componentRefs.onAfterRender;\n  componentRefs.onAfterRender = previous\n    ? () => {\n        try {\n          previous();\n        } finally {\n          callback();\n        }\n      }\n    : callback;\n}\n\n/**\n * Installs one stable nested backend resolver in the current Canvas paint order.\n *\n * @param input - Nested coordinate resolver and its target metadata. See\n * {@link PibblNestedResolverInput} .\n *\n * @see {@link PibblNestedResolverInput}\n */\nexport function registerNestedInteractionResolver(\n  input: PibblNestedResolverInput,\n): void {\n  const { componentRefs, pibblInstance } = requireHookContext();\n  const childInstance = backendMountInstance(input.child);\n  if (\n    childInstance.parent !== pibblInstance.canvas ||\n    childInstance.eventRoot !== pibblInstance.eventRoot\n  ) {\n    throw new Error(\n      \"A nested Pibbl backend mount must belong to the current instance and same event root.\",\n    );\n  }\n  const slot = useInternalHookSlot<{\n    entry: PibblInteractionLayer;\n    child: PibblBackendMount;\n  }>(\"nestedInteractionResolver\", (teardowns) => {\n    const entry: PibblInteractionLayer = {\n      paintKind: PibblPaintEntryKind.Resolver,\n      instance: childInstance,\n      bounds: input.bounds,\n      transform: new DOMMatrix(),\n      clippingStack: [],\n      resolveLocal: input.resolveLocal,\n    };\n    const value = { entry, child: input.child };\n    teardowns.add(() => {\n      pibblInstance.paintEntries.delete(entry);\n      if (entry.instance.focusParentBridge === entry) {\n        entry.instance.focusParentBridge = undefined;\n      }\n      if (entry.instance.eventParent === componentRefs) {\n        entry.instance.eventParent = undefined;\n      }\n    });\n    return value;\n  });\n  const { entry } = slot.value;\n  if (\n    (childInstance.eventParent !== undefined &&\n      childInstance.eventParent !== componentRefs) ||\n    (childInstance.focusParentBridge !== undefined &&\n      childInstance.focusParentBridge !== entry)\n  ) {\n    throw new Error(\n      \"A nested Pibbl backend mount already belongs to another nested resolver.\",\n    );\n  }\n  pibblInstance.paintEntries.delete(entry);\n  if (slot.value.child !== input.child) {\n    if (entry.instance.focusParentBridge === entry) {\n      entry.instance.focusParentBridge = undefined;\n    }\n    if (entry.instance.eventParent === componentRefs) {\n      entry.instance.eventParent = undefined;\n    }\n    slot.value.child = input.child;\n  }\n  entry.instance = childInstance;\n  entry.instance.eventParent = componentRefs;\n  entry.bounds = input.bounds;\n  entry.transform = getCurrentWorldTransform();\n  entry.clippingStack = Array.from(GLOBAL_STATE.clippingStack);\n  entry.resolveLocal = input.resolveLocal;\n  entry.instance.focusParentBridge = entry;\n  if (input.pointerEvents === \"auto\") {\n    pibblInstance.paintEntries.add(entry);\n  }\n}\n\nfunction backendMountInstance(mount: PibblBackendMount) {\n  const instance = GLOBAL_STATE.pibblInstances.get(mount.canvas);\n  if (!instance) {\n    throw new Error(\"Nested Pibbl backend mount is not active.\");\n  }\n  return instance;\n}\n\nfunction cancelCurrentInstanceFrameRequest(\n  state: CurrentInstanceFrameRequestState,\n): void {\n  state.handle?.cancel();\n  state.handle = undefined;\n  state.updateParents = false;\n}\n\nfunction releaseCurrentInstanceFrameRequest(\n  state: CurrentInstanceFrameRequestState,\n): void {\n  if (!state.active) return;\n  state.active = false;\n  cancelCurrentInstanceFrameRequest(state);\n  frameRequestsByComponent.delete(state.componentRefs);\n\n}\n\nfunction isCurrentInstanceFrameRequestActive(\n  state: CurrentInstanceFrameRequestState,\n): boolean {\n  return (\n    state.active &&\n    !state.componentRefs.teardowns.closed &&\n    !state.instance.mainTeardowns.closed &&\n    GLOBAL_STATE.pibblInstances.get(state.instance.canvas) === state.instance &&\n    state.instance.refs.get(state.componentRefs.id) === state.componentRefs\n  );\n}\nexport {\n  pibblInternalAssertCommandAllowed,\n  pibblInternalCreateSignalConsumer,\n  pibblInternalCurrentFrame,\n  pibblInternalCurrentRenderOwner,\n  pibblInternalOnRenderFinish,\n  pibblInternalPaintTarget,\n  pibblInternalQueueBegin,\n  pibblInternalQueueComplete,\n  pibblInternalQueueCurrentCommit,\n  pibblInternalQueueCurrentComplete,\n  pibblInternalRegisterAdvance,\n  pibblInternalRequestRender,\n  pibblInternalRequestRendererWork,\n} from \"./lib/scheduler/renderer-participant.js\";\nexport type {\n  PibblInternalCommandHandle,\n  PibblInternalFrame,\n  PibblInternalRendererWorkKind,\n  PibblInternalRenderOwner,\n  PibblInternalSignalBatch,\n  PibblInternalSignalConsumer,\n} from \"./lib/scheduler/renderer-participant.js\";\n\nexport { pushLayoutBox } from \"./lib/layout/context.js\";\n\nexport {\n  ManualSchedulerDriver as PibblInternalManualSchedulerDriver,\n  installSchedulerDriverForTest as pibblInternalInstallTestSchedulerDriver,\n  snapshotRealmScheduler as pibblInternalSnapshotRealmScheduler,\n} from \"./lib/scheduler/testing.js\";\n\nexport { getCurrentWorldTransform as pibblInternalCurrentWorldTransform } from \"./lib/render-target.js\";\n\nexport { borrowTextureRaster, resolveTexturePaint, validateTexturePaint } from './lib/textures/texture-protocol.js';\nexport type { BorrowedTextureRaster } from './lib/textures/texture-protocol.js';\n"],
+  "mappings": "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",
   "names": ["useInternalHookSlot", "target", "entry", "getCurrentWorldTransform"]
 }

package/dist/lib/events/event-facade.d.ts

@@ -13,6 +13,19 @@ export interface CreatePibblEventInput<K extends PibblEventType> {
     /** Root-logical coordinate supplied by the family adapter. */
     readonly y?: number;
 }
+/** Private opt-in dispatch ownership; ordinary events allocate no resource map.
+ * @param event - The currently dispatched logical event.
+ * @param key - Identity of this optional integration resource.
+ * @param create - Lazy initializer with an exact dispatch-end disposer.
+ * @returns Shared resource for this logical dispatch.
+ * @see {@link PibblEvent}
+ */
+export declare function borrowDispatchResource<T>(event: PibblEvent, key: object, create: () => {
+    value: T;
+    dispose: () => void;
+}): T;
+/** Releases optional synchronous resources even when a handler fails. */
+export declare function finishEventDispatch(event: PibblEvent): void;
 export declare function createPibblEvent<K extends PibblEventType>(input: CreatePibblEventInput<K>): PibblEventMap[K];
 export declare function setPibblEventInvocation(event: PibblEvent, currentTarget: PibblEventTarget, eventPhase: PibblEventPhase): void;
 export declare function isPibblPropagationStopped(event: PibblEvent): boolean;

package/dist/lib/events/event-facade.js

@@ -2,6 +2,27 @@ import {
   getPibblEventDefinition
 } from "./event-definitions.js";
 const states = /* @__PURE__ */ new WeakMap();
+function borrowDispatchResource(event, key, create) {
+  const state = requiredState(event);
+  if (state.dispatchFinished) throw new Error("Inspection dispatch has expired.");
+  const resources = state.resources ??= /* @__PURE__ */ new Map();
+  let resource = resources.get(key);
+  if (!resource) {
+    resource = create();
+    resources.set(key, resource);
+  }
+  return resource.value;
+}
+function finishEventDispatch(event) {
+  const state = requiredState(event);
+  state.dispatchFinished = true;
+  const resources = state.resources;
+  if (resources) {
+    for (const resource of resources.values()) resource.dispose();
+    resources.clear();
+    state.resources = void 0;
+  }
+}
 function createPibblEvent(input) {
   const definition = requiredDefinition(input.type);
   const originalEvent = input.originalEvent;
@@ -180,7 +201,9 @@ function pick(value, keys) {
   return result;
 }
 export {
+  borrowDispatchResource,
   createPibblEvent,
+  finishEventDispatch,
   isPibblImmediatePropagationStopped,
   isPibblPropagationStopped,
   setPibblEventInvocation

package/dist/lib/events/event-facade.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../src/lib/events/event-facade.ts"],
-  "sourcesContent": ["import {\n  getPibblEventDefinition,\n  type PibblEventDefinition,\n} from './event-definitions.js';\nimport type { PibblEventNode } from './registrations.js';\nimport type {\n  PibblEvent,\n  PibblEventMap,\n  PibblEventPhase,\n  PibblEventTarget,\n  PibblEventType,\n} from './types.js';\n\nexport type PibblOriginalEvent<K extends PibblEventType> =\n  PibblEventMap[K] extends PibblEvent<infer TOriginal> ? TOriginal : Event;\n\nexport interface CreatePibblEventInput<K extends PibblEventType> {\n  readonly type: K;\n  readonly target: PibblEventNode;\n  readonly path: readonly PibblEventNode[];\n  readonly relatedTarget?: PibblEventNode | null;\n  readonly originalEvent: PibblOriginalEvent<K>;\n  readonly sourceEvent?: Event;\n  /** Root-logical coordinate supplied by the family adapter. */\n  readonly x?: number;\n  /** Root-logical coordinate supplied by the family adapter. */\n  readonly y?: number;\n}\n\ninterface PibblEventFacadeState {\n  currentTarget: PibblEventTarget;\n  eventPhase: PibblEventPhase;\n  defaultPrevented: boolean;\n  propagationStopped: boolean;\n  immediatePropagationStopped: boolean;\n}\n\nconst states = new WeakMap<object, PibblEventFacadeState>();\n\nexport function createPibblEvent<K extends PibblEventType>(\n  input: CreatePibblEventInput<K>,\n): PibblEventMap[K] {\n  const definition = requiredDefinition(input.type);\n  const originalEvent = input.originalEvent;\n  const cancelable = definition.cancelable && originalEvent.cancelable;\n  const publicPath = Object.freeze(\n    input.path.map(node => node.publicTarget),\n  );\n  const state: PibblEventFacadeState = {\n    currentTarget: input.target.publicTarget,\n    eventPhase: 2,\n    defaultPrevented: cancelable && originalEvent.defaultPrevented,\n    propagationStopped: false,\n    immediatePropagationStopped: false,\n  };\n  const facade = {\n    type: input.type,\n    target: input.target.publicTarget,\n    relatedTarget: input.relatedTarget?.publicTarget ?? null,\n    bubbles: definition.bubbles,\n    cancelable,\n    timeStamp: originalEvent.timeStamp,\n    originalEvent,\n    sourceEvent: input.sourceEvent,\n    get currentTarget() {\n      return state.currentTarget;\n    },\n    get eventPhase() {\n      return state.eventPhase;\n    },\n    get defaultPrevented() {\n      return state.defaultPrevented;\n    },\n    composedPath() {\n      return publicPath;\n    },\n    preventDefault() {\n      if (!cancelable) return;\n      state.defaultPrevented = true;\n      originalEvent.preventDefault();\n    },\n    stopPropagation() {\n      state.propagationStopped = true;\n      originalEvent.stopPropagation();\n    },\n    stopImmediatePropagation() {\n      state.propagationStopped = true;\n      state.immediatePropagationStopped = true;\n      originalEvent.stopImmediatePropagation();\n    },\n  } as PibblEvent & Record<string, unknown>;\n  states.set(facade, state);\n  projectFamilyFields(facade, definition, input);\n  return facade as unknown as PibblEventMap[K];\n}\n\nexport function setPibblEventInvocation(\n  event: PibblEvent,\n  currentTarget: PibblEventTarget,\n  eventPhase: PibblEventPhase,\n): void {\n  const state = requiredState(event);\n  state.currentTarget = currentTarget;\n  state.eventPhase = eventPhase;\n}\n\nexport function isPibblPropagationStopped(event: PibblEvent): boolean {\n  return requiredState(event).propagationStopped;\n}\n\nexport function isPibblImmediatePropagationStopped(event: PibblEvent): boolean {\n  return requiredState(event).immediatePropagationStopped;\n}\n\nfunction requiredState(event: PibblEvent): PibblEventFacadeState {\n  const state = states.get(event);\n  if (!state) throw new Error('Pibbl event facade state is unavailable.');\n  return state;\n}\n\nfunction requiredDefinition(type: PibblEventType): PibblEventDefinition {\n  const definition = getPibblEventDefinition(type);\n  if (!definition) throw new Error(`Unsupported Pibbl event type: ${type}`);\n  return definition;\n}\n\nfunction projectFamilyFields<K extends PibblEventType>(\n  facade: PibblEvent & Record<string, unknown>,\n  definition: PibblEventDefinition,\n  input: CreatePibblEventInput<K>,\n): void {\n  const original: unknown = input.originalEvent;\n  if (definition.coordinate) {\n    Object.assign(facade, { x: input.x ?? 0, y: input.y ?? 0 });\n  }\n\n  switch (definition.family) {\n    case 'pointer':\n      projectMouseFields(facade, original as PointerEvent);\n      Object.assign(facade, pick(original as PointerEvent, [\n        'pointerId',\n        'width',\n        'height',\n        'pressure',\n        'tangentialPressure',\n        'tiltX',\n        'tiltY',\n        'twist',\n        'pointerType',\n        'isPrimary',\n      ]));\n      break;\n    case 'mouse':\n      projectMouseFields(facade, original as MouseEvent);\n      break;\n    case 'touch':\n      projectModifierFields(facade, original as TouchEvent);\n      Object.assign(facade, pick(original as TouchEvent, [\n        'touches',\n        'targetTouches',\n        'changedTouches',\n      ]));\n      break;\n    case 'wheel':\n      projectMouseFields(facade, original as WheelEvent);\n      Object.assign(facade, pick(original as WheelEvent, [\n        'deltaX',\n        'deltaY',\n        'deltaZ',\n        'deltaMode',\n      ]));\n      break;\n    case 'keyboard':\n      projectModifierFields(facade, original as KeyboardEvent);\n      Object.assign(facade, pick(original as KeyboardEvent, [\n        'key',\n        'code',\n        'location',\n        'repeat',\n        'isComposing',\n      ]));\n      break;\n    case 'input':\n      if (definition.type === 'beforeinput' || definition.type === 'input') {\n        Object.assign(facade, pick(original as InputEvent, [\n          'data',\n          'dataTransfer',\n          'inputType',\n          'isComposing',\n        ]));\n      }\n      break;\n    case 'composition':\n      Object.assign(facade, pick(original as CompositionEvent, ['data']));\n      break;\n    case 'clipboard':\n      Object.assign(facade, pick(original as ClipboardEvent, ['clipboardData']));\n      break;\n    case 'drag':\n      projectMouseFields(facade, original as DragEvent);\n      Object.assign(facade, pick(original as DragEvent, ['dataTransfer']));\n      break;\n    case 'focus':\n      break;\n  }\n}\n\nfunction projectMouseFields(\n  facade: PibblEvent & Record<string, unknown>,\n  original: MouseEvent,\n): void {\n  projectModifierFields(facade, original);\n  Object.assign(facade, pick(original, [\n    'clientX',\n    'clientY',\n    'screenX',\n    'screenY',\n    'movementX',\n    'movementY',\n    'button',\n    'buttons',\n    'detail',\n  ]));\n}\n\nfunction projectModifierFields(\n  facade: PibblEvent & Record<string, unknown>,\n  original: MouseEvent | TouchEvent | KeyboardEvent,\n): void {\n  Object.assign(facade, pick(original, [\n    'altKey',\n    'ctrlKey',\n    'metaKey',\n    'shiftKey',\n  ]));\n}\n\nfunction pick<T extends object, K extends keyof T>(\n  value: T,\n  keys: readonly K[],\n): Pick<T, K> {\n  const result = {} as Pick<T, K>;\n  for (const key of keys) result[key] = value[key];\n  return result;\n}\n"],
-  "mappings": "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",
+  "sourcesContent": ["import {\n  getPibblEventDefinition,\n  type PibblEventDefinition,\n} from './event-definitions.js';\nimport type { PibblEventNode } from './registrations.js';\nimport type {\n  PibblEvent,\n  PibblEventMap,\n  PibblEventPhase,\n  PibblEventTarget,\n  PibblEventType,\n} from './types.js';\n\nexport type PibblOriginalEvent<K extends PibblEventType> =\n  PibblEventMap[K] extends PibblEvent<infer TOriginal> ? TOriginal : Event;\n\nexport interface CreatePibblEventInput<K extends PibblEventType> {\n  readonly type: K;\n  readonly target: PibblEventNode;\n  readonly path: readonly PibblEventNode[];\n  readonly relatedTarget?: PibblEventNode | null;\n  readonly originalEvent: PibblOriginalEvent<K>;\n  readonly sourceEvent?: Event;\n  /** Root-logical coordinate supplied by the family adapter. */\n  readonly x?: number;\n  /** Root-logical coordinate supplied by the family adapter. */\n  readonly y?: number;\n}\n\ninterface PibblEventFacadeState {\n  dispatchFinished?: boolean;\n  resources?: Map<object, { value: unknown; dispose: () => void }>;\n  currentTarget: PibblEventTarget;\n  eventPhase: PibblEventPhase;\n  defaultPrevented: boolean;\n  propagationStopped: boolean;\n  immediatePropagationStopped: boolean;\n}\n\nconst states = new WeakMap<object, PibblEventFacadeState>();\n\n/** Private opt-in dispatch ownership; ordinary events allocate no resource map.\n * @param event - The currently dispatched logical event.\n * @param key - Identity of this optional integration resource.\n * @param create - Lazy initializer with an exact dispatch-end disposer.\n * @returns Shared resource for this logical dispatch.\n * @see {@link PibblEvent}\n */\nexport function borrowDispatchResource<T>(event: PibblEvent, key: object, create: () => {value:T;dispose:()=>void}): T {\n  const state = requiredState(event);\n  if (state.dispatchFinished) throw new Error('Inspection dispatch has expired.');\n  const resources = state.resources ??= new Map();\n  let resource = resources.get(key);\n  if (!resource) { resource = create(); resources.set(key,resource); }\n  return resource.value as T;\n}\n\n/** Releases optional synchronous resources even when a handler fails. */\nexport function finishEventDispatch(event: PibblEvent): void {\n  const state = requiredState(event);\n  state.dispatchFinished = true;\n  const resources = state.resources;\n  if (resources) {\n    for (const resource of resources.values()) resource.dispose();\n    resources.clear();\n    state.resources = undefined;\n  }\n}\n\nexport function createPibblEvent<K extends PibblEventType>(\n  input: CreatePibblEventInput<K>,\n): PibblEventMap[K] {\n  const definition = requiredDefinition(input.type);\n  const originalEvent = input.originalEvent;\n  const cancelable = definition.cancelable && originalEvent.cancelable;\n  const publicPath = Object.freeze(\n    input.path.map(node => node.publicTarget),\n  );\n  const state: PibblEventFacadeState = {\n    currentTarget: input.target.publicTarget,\n    eventPhase: 2,\n    defaultPrevented: cancelable && originalEvent.defaultPrevented,\n    propagationStopped: false,\n    immediatePropagationStopped: false,\n  };\n  const facade = {\n    type: input.type,\n    target: input.target.publicTarget,\n    relatedTarget: input.relatedTarget?.publicTarget ?? null,\n    bubbles: definition.bubbles,\n    cancelable,\n    timeStamp: originalEvent.timeStamp,\n    originalEvent,\n    sourceEvent: input.sourceEvent,\n    get currentTarget() {\n      return state.currentTarget;\n    },\n    get eventPhase() {\n      return state.eventPhase;\n    },\n    get defaultPrevented() {\n      return state.defaultPrevented;\n    },\n    composedPath() {\n      return publicPath;\n    },\n    preventDefault() {\n      if (!cancelable) return;\n      state.defaultPrevented = true;\n      originalEvent.preventDefault();\n    },\n    stopPropagation() {\n      state.propagationStopped = true;\n      originalEvent.stopPropagation();\n    },\n    stopImmediatePropagation() {\n      state.propagationStopped = true;\n      state.immediatePropagationStopped = true;\n      originalEvent.stopImmediatePropagation();\n    },\n  } as PibblEvent & Record<string, unknown>;\n  states.set(facade, state);\n  projectFamilyFields(facade, definition, input);\n  return facade as unknown as PibblEventMap[K];\n}\n\nexport function setPibblEventInvocation(\n  event: PibblEvent,\n  currentTarget: PibblEventTarget,\n  eventPhase: PibblEventPhase,\n): void {\n  const state = requiredState(event);\n  state.currentTarget = currentTarget;\n  state.eventPhase = eventPhase;\n}\n\nexport function isPibblPropagationStopped(event: PibblEvent): boolean {\n  return requiredState(event).propagationStopped;\n}\n\nexport function isPibblImmediatePropagationStopped(event: PibblEvent): boolean {\n  return requiredState(event).immediatePropagationStopped;\n}\n\nfunction requiredState(event: PibblEvent): PibblEventFacadeState {\n  const state = states.get(event);\n  if (!state) throw new Error('Pibbl event facade state is unavailable.');\n  return state;\n}\n\nfunction requiredDefinition(type: PibblEventType): PibblEventDefinition {\n  const definition = getPibblEventDefinition(type);\n  if (!definition) throw new Error(`Unsupported Pibbl event type: ${type}`);\n  return definition;\n}\n\nfunction projectFamilyFields<K extends PibblEventType>(\n  facade: PibblEvent & Record<string, unknown>,\n  definition: PibblEventDefinition,\n  input: CreatePibblEventInput<K>,\n): void {\n  const original: unknown = input.originalEvent;\n  if (definition.coordinate) {\n    Object.assign(facade, { x: input.x ?? 0, y: input.y ?? 0 });\n  }\n\n  switch (definition.family) {\n    case 'pointer':\n      projectMouseFields(facade, original as PointerEvent);\n      Object.assign(facade, pick(original as PointerEvent, [\n        'pointerId',\n        'width',\n        'height',\n        'pressure',\n        'tangentialPressure',\n        'tiltX',\n        'tiltY',\n        'twist',\n        'pointerType',\n        'isPrimary',\n      ]));\n      break;\n    case 'mouse':\n      projectMouseFields(facade, original as MouseEvent);\n      break;\n    case 'touch':\n      projectModifierFields(facade, original as TouchEvent);\n      Object.assign(facade, pick(original as TouchEvent, [\n        'touches',\n        'targetTouches',\n        'changedTouches',\n      ]));\n      break;\n    case 'wheel':\n      projectMouseFields(facade, original as WheelEvent);\n      Object.assign(facade, pick(original as WheelEvent, [\n        'deltaX',\n        'deltaY',\n        'deltaZ',\n        'deltaMode',\n      ]));\n      break;\n    case 'keyboard':\n      projectModifierFields(facade, original as KeyboardEvent);\n      Object.assign(facade, pick(original as KeyboardEvent, [\n        'key',\n        'code',\n        'location',\n        'repeat',\n        'isComposing',\n      ]));\n      break;\n    case 'input':\n      if (definition.type === 'beforeinput' || definition.type === 'input') {\n        Object.assign(facade, pick(original as InputEvent, [\n          'data',\n          'dataTransfer',\n          'inputType',\n          'isComposing',\n        ]));\n      }\n      break;\n    case 'composition':\n      Object.assign(facade, pick(original as CompositionEvent, ['data']));\n      break;\n    case 'clipboard':\n      Object.assign(facade, pick(original as ClipboardEvent, ['clipboardData']));\n      break;\n    case 'drag':\n      projectMouseFields(facade, original as DragEvent);\n      Object.assign(facade, pick(original as DragEvent, ['dataTransfer']));\n      break;\n    case 'focus':\n      break;\n  }\n}\n\nfunction projectMouseFields(\n  facade: PibblEvent & Record<string, unknown>,\n  original: MouseEvent,\n): void {\n  projectModifierFields(facade, original);\n  Object.assign(facade, pick(original, [\n    'clientX',\n    'clientY',\n    'screenX',\n    'screenY',\n    'movementX',\n    'movementY',\n    'button',\n    'buttons',\n    'detail',\n  ]));\n}\n\nfunction projectModifierFields(\n  facade: PibblEvent & Record<string, unknown>,\n  original: MouseEvent | TouchEvent | KeyboardEvent,\n): void {\n  Object.assign(facade, pick(original, [\n    'altKey',\n    'ctrlKey',\n    'metaKey',\n    'shiftKey',\n  ]));\n}\n\nfunction pick<T extends object, K extends keyof T>(\n  value: T,\n  keys: readonly K[],\n): Pick<T, K> {\n  const result = {} as Pick<T, K>;\n  for (const key of keys) result[key] = value[key];\n  return result;\n}\n"],
+  "mappings": "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",
   "names": []
 }

package/dist/lib/events/propagation.js

@@ -1,6 +1,7 @@
 import { getPibblEventDefinition } from "./event-definitions.js";
 import {
   createPibblEvent,
+  finishEventDispatch,
   isPibblImmediatePropagationStopped,
   isPibblPropagationStopped,
   setPibblEventInvocation
@@ -14,23 +15,27 @@ function dispatchEventPath(input) {
   const path = buildEventPath(input.target);
   const event = createPibblEvent({ ...input, path });
   const targetIndex = path.length - 1;
-  for (let index = 0; index < targetIndex; index++) {
-    if (isPibblPropagationStopped(event)) break;
-    invoke(path[index], input.type, true, 1, event);
-  }
-  if (!isPibblPropagationStopped(event) && input.target.live) {
-    invoke(input.target, input.type, true, 2, event);
-    if (!isPibblImmediatePropagationStopped(event)) {
-      invoke(input.target, input.type, false, 2, event);
-    }
-  }
-  if (definition.bubbles && !isPibblPropagationStopped(event)) {
-    for (let index = targetIndex - 1; index >= 0; index--) {
+  try {
+    for (let index = 0; index < targetIndex; index++) {
       if (isPibblPropagationStopped(event)) break;
-      invoke(path[index], input.type, false, 3, event);
+      invoke(path[index], input.type, true, 1, event);
+    }
+    if (!isPibblPropagationStopped(event) && input.target.live) {
+      invoke(input.target, input.type, true, 2, event);
+      if (!isPibblImmediatePropagationStopped(event)) {
+        invoke(input.target, input.type, false, 2, event);
+      }
+    }
+    if (definition.bubbles && !isPibblPropagationStopped(event)) {
+      for (let index = targetIndex - 1; index >= 0; index--) {
+        if (isPibblPropagationStopped(event)) break;
+        invoke(path[index], input.type, false, 3, event);
+      }
     }
+    return event;
+  } finally {
+    finishEventDispatch(event);
   }
-  return event;
 }
 function invoke(node, type, capture, phase, event) {
   if (!node.live) return;

package/dist/lib/events/propagation.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../src/lib/events/propagation.ts"],
-  "sourcesContent": ["import { getPibblEventDefinition } from './event-definitions.js';\nimport {\n  createPibblEvent,\n  isPibblImmediatePropagationStopped,\n  isPibblPropagationStopped,\n  setPibblEventInvocation,\n  type CreatePibblEventInput,\n} from './event-facade.js';\nimport { buildEventPath } from './event-path.js';\nimport type {\n  PibblEventNode,\n  PibblNormalizedHandlers,\n} from './registrations.js';\nimport type {\n  PibblEvent,\n  PibblEventMap,\n  PibblEventPhase,\n  PibblEventType,\n} from './types.js';\n\nexport interface DispatchEventPathInput<K extends PibblEventType>\n  extends Omit<CreatePibblEventInput<K>, 'path'> {\n  readonly target: PibblEventNode;\n}\n\ntype PibblNormalizedCaptureKey = `${PibblEventType}Capture`;\n\nexport function dispatchEventPath<K extends PibblEventType>(\n  input: DispatchEventPathInput<K>,\n): PibblEventMap[K] {\n  const definition = getPibblEventDefinition(input.type);\n  if (!definition) {\n    throw new Error(`Unsupported Pibbl event type: ${input.type}`);\n  }\n  const path = buildEventPath(input.target);\n  const event = createPibblEvent({ ...input, path });\n  const targetIndex = path.length - 1;\n\n  for (let index = 0; index < targetIndex; index++) {\n    if (isPibblPropagationStopped(event)) break;\n    invoke(path[index], input.type, true, 1, event);\n  }\n\n  if (!isPibblPropagationStopped(event) && input.target.live) {\n    invoke(input.target, input.type, true, 2, event);\n    if (!isPibblImmediatePropagationStopped(event)) {\n      invoke(input.target, input.type, false, 2, event);\n    }\n  }\n\n  if (definition.bubbles && !isPibblPropagationStopped(event)) {\n    for (let index = targetIndex - 1; index >= 0; index--) {\n      if (isPibblPropagationStopped(event)) break;\n      invoke(path[index], input.type, false, 3, event);\n    }\n  }\n\n  return event;\n}\n\nfunction invoke(\n  node: PibblEventNode,\n  type: PibblEventType,\n  capture: boolean,\n  phase: PibblEventPhase,\n  event: PibblEvent,\n): void {\n  if (!node.live) return;\n  const key = capture ? `${type}Capture` as PibblNormalizedCaptureKey : type;\n  const handler = node.handlers[key as keyof PibblNormalizedHandlers];\n  if (!handler) return;\n  setPibblEventInvocation(event, node.publicTarget, phase);\n  try {\n    (handler as (event: PibblEvent) => void)(event);\n  } catch (error) {\n    reportDispatchError(error);\n  }\n}\n\nfunction reportDispatchError(error: unknown): void {\n  try {\n    globalThis.reportError(error);\n  } catch {\n    // Reporting cannot suppress unrelated handlers in this logical dispatch.\n  }\n}\n"],
-  "mappings": "AAAA,SAAS,+BAA+B;AACxC;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OAEK;AACP,SAAS,sBAAsB;AAmBxB,SAAS,kBACd,OACkB;AAClB,QAAM,aAAa,wBAAwB,MAAM,IAAI;AACrD,MAAI,CAAC,YAAY;AACf,UAAM,IAAI,MAAM,iCAAiC,MAAM,IAAI,EAAE;AAAA,EAC/D;AACA,QAAM,OAAO,eAAe,MAAM,MAAM;AACxC,QAAM,QAAQ,iBAAiB,EAAE,GAAG,OAAO,KAAK,CAAC;AACjD,QAAM,cAAc,KAAK,SAAS;AAElC,WAAS,QAAQ,GAAG,QAAQ,aAAa,SAAS;AAChD,QAAI,0BAA0B,KAAK,EAAG;AACtC,WAAO,KAAK,KAAK,GAAG,MAAM,MAAM,MAAM,GAAG,KAAK;AAAA,EAChD;AAEA,MAAI,CAAC,0BAA0B,KAAK,KAAK,MAAM,OAAO,MAAM;AAC1D,WAAO,MAAM,QAAQ,MAAM,MAAM,MAAM,GAAG,KAAK;AAC/C,QAAI,CAAC,mCAAmC,KAAK,GAAG;AAC9C,aAAO,MAAM,QAAQ,MAAM,MAAM,OAAO,GAAG,KAAK;AAAA,IAClD;AAAA,EACF;AAEA,MAAI,WAAW,WAAW,CAAC,0BAA0B,KAAK,GAAG;AAC3D,aAAS,QAAQ,cAAc,GAAG,SAAS,GAAG,SAAS;AACrD,UAAI,0BAA0B,KAAK,EAAG;AACtC,aAAO,KAAK,KAAK,GAAG,MAAM,MAAM,OAAO,GAAG,KAAK;AAAA,IACjD;AAAA,EACF;AAEA,SAAO;AACT;AAEA,SAAS,OACP,MACA,MACA,SACA,OACA,OACM;AACN,MAAI,CAAC,KAAK,KAAM;AAChB,QAAM,MAAM,UAAU,GAAG,IAAI,YAAyC;AACtE,QAAM,UAAU,KAAK,SAAS,GAAoC;AAClE,MAAI,CAAC,QAAS;AACd,0BAAwB,OAAO,KAAK,cAAc,KAAK;AACvD,MAAI;AACF,IAAC,QAAwC,KAAK;AAAA,EAChD,SAAS,OAAO;AACd,wBAAoB,KAAK;AAAA,EAC3B;AACF;AAEA,SAAS,oBAAoB,OAAsB;AACjD,MAAI;AACF,eAAW,YAAY,KAAK;AAAA,EAC9B,QAAQ;AAAA,EAER;AACF;",
+  "sourcesContent": ["import { getPibblEventDefinition } from './event-definitions.js';\nimport {\n  createPibblEvent,\n  finishEventDispatch,\n  isPibblImmediatePropagationStopped,\n  isPibblPropagationStopped,\n  setPibblEventInvocation,\n  type CreatePibblEventInput,\n} from './event-facade.js';\nimport { buildEventPath } from './event-path.js';\nimport type {\n  PibblEventNode,\n  PibblNormalizedHandlers,\n} from './registrations.js';\nimport type {\n  PibblEvent,\n  PibblEventMap,\n  PibblEventPhase,\n  PibblEventType,\n} from './types.js';\n\nexport interface DispatchEventPathInput<K extends PibblEventType>\n  extends Omit<CreatePibblEventInput<K>, 'path'> {\n  readonly target: PibblEventNode;\n}\n\ntype PibblNormalizedCaptureKey = `${PibblEventType}Capture`;\n\nexport function dispatchEventPath<K extends PibblEventType>(\n  input: DispatchEventPathInput<K>,\n): PibblEventMap[K] {\n  const definition = getPibblEventDefinition(input.type);\n  if (!definition) {\n    throw new Error(`Unsupported Pibbl event type: ${input.type}`);\n  }\n  const path = buildEventPath(input.target);\n  const event = createPibblEvent({ ...input, path });\n  const targetIndex = path.length - 1;\n  try {\n  for (let index = 0; index < targetIndex; index++) {\n    if (isPibblPropagationStopped(event)) break;\n    invoke(path[index], input.type, true, 1, event);\n  }\n\n  if (!isPibblPropagationStopped(event) && input.target.live) {\n    invoke(input.target, input.type, true, 2, event);\n    if (!isPibblImmediatePropagationStopped(event)) {\n      invoke(input.target, input.type, false, 2, event);\n    }\n  }\n\n  if (definition.bubbles && !isPibblPropagationStopped(event)) {\n    for (let index = targetIndex - 1; index >= 0; index--) {\n      if (isPibblPropagationStopped(event)) break;\n      invoke(path[index], input.type, false, 3, event);\n    }\n  }\n\n  return event;\n  } finally { finishEventDispatch(event); }\n}\n\nfunction invoke(\n  node: PibblEventNode,\n  type: PibblEventType,\n  capture: boolean,\n  phase: PibblEventPhase,\n  event: PibblEvent,\n): void {\n  if (!node.live) return;\n  const key = capture ? `${type}Capture` as PibblNormalizedCaptureKey : type;\n  const handler = node.handlers[key as keyof PibblNormalizedHandlers];\n  if (!handler) return;\n  setPibblEventInvocation(event, node.publicTarget, phase);\n  try {\n    (handler as (event: PibblEvent) => void)(event);\n  } catch (error) {\n    reportDispatchError(error);\n  }\n}\n\nfunction reportDispatchError(error: unknown): void {\n  try {\n    globalThis.reportError(error);\n  } catch {\n    // Reporting cannot suppress unrelated handlers in this logical dispatch.\n  }\n}\n"],
+  "mappings": "AAAA,SAAS,+BAA+B;AACxC;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OAEK;AACP,SAAS,sBAAsB;AAmBxB,SAAS,kBACd,OACkB;AAClB,QAAM,aAAa,wBAAwB,MAAM,IAAI;AACrD,MAAI,CAAC,YAAY;AACf,UAAM,IAAI,MAAM,iCAAiC,MAAM,IAAI,EAAE;AAAA,EAC/D;AACA,QAAM,OAAO,eAAe,MAAM,MAAM;AACxC,QAAM,QAAQ,iBAAiB,EAAE,GAAG,OAAO,KAAK,CAAC;AACjD,QAAM,cAAc,KAAK,SAAS;AAClC,MAAI;AACJ,aAAS,QAAQ,GAAG,QAAQ,aAAa,SAAS;AAChD,UAAI,0BAA0B,KAAK,EAAG;AACtC,aAAO,KAAK,KAAK,GAAG,MAAM,MAAM,MAAM,GAAG,KAAK;AAAA,IAChD;AAEA,QAAI,CAAC,0BAA0B,KAAK,KAAK,MAAM,OAAO,MAAM;AAC1D,aAAO,MAAM,QAAQ,MAAM,MAAM,MAAM,GAAG,KAAK;AAC/C,UAAI,CAAC,mCAAmC,KAAK,GAAG;AAC9C,eAAO,MAAM,QAAQ,MAAM,MAAM,OAAO,GAAG,KAAK;AAAA,MAClD;AAAA,IACF;AAEA,QAAI,WAAW,WAAW,CAAC,0BAA0B,KAAK,GAAG;AAC3D,eAAS,QAAQ,cAAc,GAAG,SAAS,GAAG,SAAS;AACrD,YAAI,0BAA0B,KAAK,EAAG;AACtC,eAAO,KAAK,KAAK,GAAG,MAAM,MAAM,OAAO,GAAG,KAAK;AAAA,MACjD;AAAA,IACF;AAEA,WAAO;AAAA,EACP,UAAE;AAAU,wBAAoB,KAAK;AAAA,EAAG;AAC1C;AAEA,SAAS,OACP,MACA,MACA,SACA,OACA,OACM;AACN,MAAI,CAAC,KAAK,KAAM;AAChB,QAAM,MAAM,UAAU,GAAG,IAAI,YAAyC;AACtE,QAAM,UAAU,KAAK,SAAS,GAAoC;AAClE,MAAI,CAAC,QAAS;AACd,0BAAwB,OAAO,KAAK,cAAc,KAAK;AACvD,MAAI;AACF,IAAC,QAAwC,KAAK;AAAA,EAChD,SAAS,OAAO;AACd,wBAAoB,KAAK;AAAA,EAC3B;AACF;AAEA,SAAS,oBAAoB,OAAsB;AACjD,MAAI;AACF,eAAW,YAAY,KAAK;AAAA,EAC9B,QAAQ;AAAA,EAER;AACF;",
   "names": []
 }

package/dist/lib/execute-render.js

@@ -114,6 +114,19 @@ function executeRender(canvas, renderTimestamp, updatedRoot, _updateParents = fa
       percentageBasis: pibblInstance.rootLayoutBox
     }];
     const renderGeneration = ++pibblInstance.renderGeneration;
+    if (!pibblInstance.parent) {
+      renderTransaction.onFinish((success) => {
+        if (success) pibblInstance.committedRenderGeneration = renderGeneration;
+      });
+      if (pibblInstance.rootFrameObservers?.size) {
+        renderTransaction.onAfterFinish?.((success) => {
+          const observers = pibblInstance.rootFrameObservers;
+          if (!observers) return;
+          for (const observer of observers)
+            observer(success, renderGeneration);
+        });
+      }
+    }
     renderSeenIds = pibblInstance.renderSeenIds;
     renderSeenKeys = pibblInstance.renderSeenKeys;
     renderSeenIds.clear();

package/dist/lib/execute-render.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../src/lib/execute-render.ts"],
-  "sourcesContent": ["import { RootRenderTransaction } from './render-transaction.js';\nimport {\n  clearTempState,\n  GLOBAL_STATE,\n  NO_PENDING_ROOT,\n} from './global-state.js';\nimport { render } from './render.js';\nimport { initializeCurrentWorldTransformAnchor } from './render-target.js';\nimport {\n  Canvas,\n  type PibblNode,\n} from './types.js';\nimport type {\n  PibblBackendFrame,\n} from './backend/types.js';\nimport type { PibblFrameSnapshot } from './scheduler/types.js';\nimport { withSignalWriteForbidden } from './signals/graph.js';\n\n/**\n * Gets the root element for a canvas and renders it. This is the\n * entry point for rendering the entire tree.\n * @param canvas The canvas to render on\n */\nexport function executeRender(\n  canvas: Canvas,\n  renderTimestamp: number,\n  updatedRoot?: PibblNode | typeof NO_PENDING_ROOT,\n  _updateParents = false,\n  frameSnapshot?: PibblFrameSnapshot,\n): void {\n  if (!canvas) {\n    throw new Error('No canvas element provided');\n  }\n\n  const pibblInstance = GLOBAL_STATE.pibblInstances.get(canvas);\n\n  if (!pibblInstance) {\n    throw new Error('Pibbl is not mounted on this element');\n  }\n\n  if (pibblInstance.mainTeardowns.closed) return;\n\n  const inheritedTransaction = pibblInstance.eventRoot.renderTransaction;\n  const renderTransaction = inheritedTransaction ?? new RootRenderTransaction();\n  const ownsRenderTransaction = !inheritedTransaction;\n  if (ownsRenderTransaction) {\n    pibblInstance.eventRoot.renderTransaction = renderTransaction;\n  }\n  let transactionFinished = false;\n  const finishTransaction = (success: boolean) => {\n    if (!ownsRenderTransaction || transactionFinished) return;\n    transactionFinished = true;\n    (renderTransaction as RootRenderTransaction).finish(success);\n  };\n\n  const prevCurrentPibblInstance = GLOBAL_STATE.currentPibblInstance;\n  const prevCanvas = GLOBAL_STATE.canvas;\n  const prevRenderContext = GLOBAL_STATE.renderContext;\n  const prevRenderTarget = GLOBAL_STATE.renderTarget;\n  const prevWorldBaseTransform = GLOBAL_STATE.worldBaseTransform;\n  const prevWorldExactTransform = GLOBAL_STATE.worldExactTransform;\n  const prevWorldPaintAnchorTransform = GLOBAL_STATE.worldPaintAnchorTransform;\n  const prevPresentationTransformLineage = GLOBAL_STATE.presentationTransformLineage;\n  const prevPresentationTransformLineageTrackingDepth =\n    GLOBAL_STATE.presentationTransformLineageTrackingDepth;\n  const prevRenderTransaction = GLOBAL_STATE.renderTransaction;\n  const prevFrameSnapshot = GLOBAL_STATE.frameSnapshot;\n  const prevPrimitiveReceiverToken = GLOBAL_STATE.primitiveReceiverToken;\n  const prevSeenIds = GLOBAL_STATE.seenIds;\n  const prevSeenKeys = GLOBAL_STATE.seenKeys;\n  const prevComponentRefs = GLOBAL_STATE.componentRefs;\n  const prevComponentHookIndex = GLOBAL_STATE.componentHookIndex;\n  const prevComponentIsMounting = GLOBAL_STATE.componentIsMounting;\n  const prevClippingStack = GLOBAL_STATE.clippingStack;\n  const prevLayoutStack = GLOBAL_STATE.layoutStack;\n  const prevBackendDriver = GLOBAL_STATE.backendDriver;\n  const prevBackendFrame = GLOBAL_STATE.backendFrame;\n  const prevBackendEnvironment = GLOBAL_STATE.backendEnvironment;\n  let frame: PibblBackendFrame<unknown> | undefined;\n  let frameSuccess = false;\n  let renderSeenIds: Set<string> | undefined;\n  let renderSeenKeys: Set<string> | undefined;\n  try {\n    const activeFrameSnapshot = frameSnapshot ?? (\n      prevFrameSnapshot?.logicalTime === renderTimestamp ?\n        prevFrameSnapshot :\n        Object.freeze({\n          frameId: prevFrameSnapshot?.frameId ?? 0,\n          hostTime: prevFrameSnapshot?.hostTime ?? renderTimestamp,\n          logicalTime: renderTimestamp,\n        })\n    );\n    GLOBAL_STATE.frameSnapshot = activeFrameSnapshot;\n    GLOBAL_STATE.currentPibblInstance = pibblInstance;\n    for (const service of pibblInstance.optionalServices.values()) service.beginRender?.();\n    GLOBAL_STATE.renderTransaction = renderTransaction;\n    GLOBAL_STATE.currentPibblInstance.renderTimestamp = activeFrameSnapshot.logicalTime;\n    GLOBAL_STATE.canvas = canvas;\n    const rootNode = arguments.length >= 3 && updatedRoot !== NO_PENDING_ROOT ?\n      updatedRoot :\n      GLOBAL_STATE.currentPibblInstance.root;\n    GLOBAL_STATE.currentPibblInstance.root = rootNode;\n    const driver = pibblInstance.backendDriver;\n    GLOBAL_STATE.backendDriver = driver;\n    frame = driver.beginFrame({\n      canvas,\n      logicalWidth: pibblInstance.rootLayoutBox.width,\n      logicalHeight: pibblInstance.rootLayoutBox.height,\n      backingWidth: canvas.width,\n      backingHeight: canvas.height,\n      renderTimestamp: activeFrameSnapshot.logicalTime,\n    });\n    if (!frame) {\n      pibblInstance.eventRoot.html?.suspend(pibblInstance);\n      finishTransaction(true);\n      return;\n    }\n    pibblInstance.eventRoot.html?.beginRender(pibblInstance);\n    GLOBAL_STATE.backendFrame = frame;\n    GLOBAL_STATE.backendEnvironment = frame.environment;\n    GLOBAL_STATE.renderContext = frame.context2D;\n    GLOBAL_STATE.renderTarget = frame.renderTarget;\n    GLOBAL_STATE.worldBaseTransform = frame.worldBaseTransform;\n    GLOBAL_STATE.worldExactTransform = undefined;\n    GLOBAL_STATE.worldPaintAnchorTransform = undefined;\n    GLOBAL_STATE.presentationTransformLineage = undefined;\n    GLOBAL_STATE.presentationTransformLineageTrackingDepth = 0;\n    if (\n      frame.context2D !== undefined &&\n      frame.renderTarget !== undefined &&\n      frame.worldBaseTransform !== undefined\n    ) {\n      initializeCurrentWorldTransformAnchor(frame.worldBaseTransform);\n    }\n    GLOBAL_STATE.clippingStack = [];\n    const surface = pibblInstance.surface.snapshot;\n    const logicalWidth = surface?.logicalWidth ?? pibblInstance.rootLayoutBox.width;\n    const logicalHeight = surface?.logicalHeight ?? pibblInstance.rootLayoutBox.height;\n    const previousRootBox = pibblInstance.rootLayoutBox;\n    if (\n      previousRootBox.width !== logicalWidth ||\n      previousRootBox.height !== logicalHeight\n    ) {\n      pibblInstance.rootLayoutBox = Object.freeze({\n        x: 0,\n        y: 0,\n        width: logicalWidth,\n        height: logicalHeight,\n      });\n    }\n    GLOBAL_STATE.layoutStack = [{\n      allocation: pibblInstance.rootLayoutBox,\n      percentageBasis: pibblInstance.rootLayoutBox,\n    }];\n\n    const renderGeneration = ++pibblInstance.renderGeneration;\n    renderSeenIds = pibblInstance.renderSeenIds;\n    renderSeenKeys = pibblInstance.renderSeenKeys;\n    renderSeenIds.clear();\n    renderSeenKeys.clear();\n    GLOBAL_STATE.seenIds = renderSeenIds;\n    GLOBAL_STATE.seenKeys = renderSeenKeys;\n    const id = 'root';\n    renderSeenIds.add(id);\n    withSignalWriteForbidden(\n      'Pibbl render',\n      () => render(rootNode, id, undefined),\n    );\n\n    for (const [id, componentRefs] of pibblInstance.refs) {\n      if (componentRefs.renderGeneration === renderGeneration) continue;\n      componentRefs.teardowns.execute();\n      pibblInstance.refs.delete(id);\n    }\n    frameSuccess = true;\n    for (const service of pibblInstance.optionalServices.values()) service.endRender?.(true);\n    driver.finishFrame(frame, true);\n    finishTransaction(true);\n  } catch (error) {\n    for (const service of pibblInstance.optionalServices.values()) service.endRender?.(false);\n    finishTransaction(false);\n    for (const refs of pibblInstance.refs.values()) {\n      refs.teardowns.execute();\n    }\n    pibblInstance.refs.clear();\n    throw error;\n  } finally {\n    try {\n      if (frame && !frameSuccess) {\n        pibblInstance.backendDriver.finishFrame(frame, false);\n      }\n    } finally {\n      try {\n        clearTempState();\n        GLOBAL_STATE.clippingStack = prevClippingStack;\n        GLOBAL_STATE.layoutStack = prevLayoutStack;\n        if (ownsRenderTransaction) {\n          try {\n            finishTransaction(false);\n          } finally {\n            if (pibblInstance.eventRoot.renderTransaction === renderTransaction) {\n              pibblInstance.eventRoot.renderTransaction = undefined;\n            }\n          }\n        }\n      } finally {\n        renderSeenIds?.clear();\n        renderSeenKeys?.clear();\n        GLOBAL_STATE.currentPibblInstance = prevCurrentPibblInstance;\n        GLOBAL_STATE.canvas = prevCanvas;\n        GLOBAL_STATE.renderContext = prevRenderContext;\n        GLOBAL_STATE.renderTarget = prevRenderTarget;\n        GLOBAL_STATE.worldBaseTransform = prevWorldBaseTransform;\n        GLOBAL_STATE.worldExactTransform = prevWorldExactTransform;\n        GLOBAL_STATE.worldPaintAnchorTransform = prevWorldPaintAnchorTransform;\n        GLOBAL_STATE.presentationTransformLineage = prevPresentationTransformLineage;\n        GLOBAL_STATE.presentationTransformLineageTrackingDepth =\n          prevPresentationTransformLineageTrackingDepth;\n        GLOBAL_STATE.renderTransaction = prevRenderTransaction;\n        GLOBAL_STATE.frameSnapshot = prevFrameSnapshot;\n        GLOBAL_STATE.primitiveReceiverToken = prevPrimitiveReceiverToken;\n        GLOBAL_STATE.seenIds = prevSeenIds;\n        GLOBAL_STATE.seenKeys = prevSeenKeys;\n        GLOBAL_STATE.componentRefs = prevComponentRefs;\n        GLOBAL_STATE.componentHookIndex = prevComponentHookIndex;\n        GLOBAL_STATE.componentIsMounting = prevComponentIsMounting;\n        GLOBAL_STATE.backendDriver = prevBackendDriver;\n        GLOBAL_STATE.backendFrame = prevBackendFrame;\n        GLOBAL_STATE.backendEnvironment = prevBackendEnvironment;\n      }\n    }\n  }\n}\n"],
-  "mappings": "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",
+  "sourcesContent": ["import { RootRenderTransaction } from './render-transaction.js';\nimport {\n  clearTempState,\n  GLOBAL_STATE,\n  NO_PENDING_ROOT,\n} from './global-state.js';\nimport { render } from './render.js';\nimport { initializeCurrentWorldTransformAnchor } from './render-target.js';\nimport {\n  Canvas,\n  type PibblNode,\n} from './types.js';\nimport type {\n  PibblBackendFrame,\n} from './backend/types.js';\nimport type { PibblFrameSnapshot } from './scheduler/types.js';\nimport { withSignalWriteForbidden } from './signals/graph.js';\n\n/**\n * Gets the root element for a canvas and renders it. This is the\n * entry point for rendering the entire tree.\n * @param canvas The canvas to render on\n */\nexport function executeRender(\n  canvas: Canvas,\n  renderTimestamp: number,\n  updatedRoot?: PibblNode | typeof NO_PENDING_ROOT,\n  _updateParents = false,\n  frameSnapshot?: PibblFrameSnapshot,\n): void {\n  if (!canvas) {\n    throw new Error('No canvas element provided');\n  }\n\n  const pibblInstance = GLOBAL_STATE.pibblInstances.get(canvas);\n\n  if (!pibblInstance) {\n    throw new Error('Pibbl is not mounted on this element');\n  }\n\n  if (pibblInstance.mainTeardowns.closed) return;\n\n  const inheritedTransaction = pibblInstance.eventRoot.renderTransaction;\n  const renderTransaction = inheritedTransaction ?? new RootRenderTransaction();\n  const ownsRenderTransaction = !inheritedTransaction;\n  if (ownsRenderTransaction) {\n    pibblInstance.eventRoot.renderTransaction = renderTransaction;\n  }\n  let transactionFinished = false;\n  const finishTransaction = (success: boolean) => {\n    if (!ownsRenderTransaction || transactionFinished) return;\n    transactionFinished = true;\n    (renderTransaction as RootRenderTransaction).finish(success);\n  };\n\n  const prevCurrentPibblInstance = GLOBAL_STATE.currentPibblInstance;\n  const prevCanvas = GLOBAL_STATE.canvas;\n  const prevRenderContext = GLOBAL_STATE.renderContext;\n  const prevRenderTarget = GLOBAL_STATE.renderTarget;\n  const prevWorldBaseTransform = GLOBAL_STATE.worldBaseTransform;\n  const prevWorldExactTransform = GLOBAL_STATE.worldExactTransform;\n  const prevWorldPaintAnchorTransform = GLOBAL_STATE.worldPaintAnchorTransform;\n  const prevPresentationTransformLineage = GLOBAL_STATE.presentationTransformLineage;\n  const prevPresentationTransformLineageTrackingDepth =\n    GLOBAL_STATE.presentationTransformLineageTrackingDepth;\n  const prevRenderTransaction = GLOBAL_STATE.renderTransaction;\n  const prevFrameSnapshot = GLOBAL_STATE.frameSnapshot;\n  const prevPrimitiveReceiverToken = GLOBAL_STATE.primitiveReceiverToken;\n  const prevSeenIds = GLOBAL_STATE.seenIds;\n  const prevSeenKeys = GLOBAL_STATE.seenKeys;\n  const prevComponentRefs = GLOBAL_STATE.componentRefs;\n  const prevComponentHookIndex = GLOBAL_STATE.componentHookIndex;\n  const prevComponentIsMounting = GLOBAL_STATE.componentIsMounting;\n  const prevClippingStack = GLOBAL_STATE.clippingStack;\n  const prevLayoutStack = GLOBAL_STATE.layoutStack;\n  const prevBackendDriver = GLOBAL_STATE.backendDriver;\n  const prevBackendFrame = GLOBAL_STATE.backendFrame;\n  const prevBackendEnvironment = GLOBAL_STATE.backendEnvironment;\n  let frame: PibblBackendFrame<unknown> | undefined;\n  let frameSuccess = false;\n  let renderSeenIds: Set<string> | undefined;\n  let renderSeenKeys: Set<string> | undefined;\n  try {\n    const activeFrameSnapshot = frameSnapshot ?? (\n      prevFrameSnapshot?.logicalTime === renderTimestamp ?\n        prevFrameSnapshot :\n        Object.freeze({\n          frameId: prevFrameSnapshot?.frameId ?? 0,\n          hostTime: prevFrameSnapshot?.hostTime ?? renderTimestamp,\n          logicalTime: renderTimestamp,\n        })\n    );\n    GLOBAL_STATE.frameSnapshot = activeFrameSnapshot;\n    GLOBAL_STATE.currentPibblInstance = pibblInstance;\n    for (const service of pibblInstance.optionalServices.values()) service.beginRender?.();\n    GLOBAL_STATE.renderTransaction = renderTransaction;\n    GLOBAL_STATE.currentPibblInstance.renderTimestamp = activeFrameSnapshot.logicalTime;\n    GLOBAL_STATE.canvas = canvas;\n    const rootNode = arguments.length >= 3 && updatedRoot !== NO_PENDING_ROOT ?\n      updatedRoot :\n      GLOBAL_STATE.currentPibblInstance.root;\n    GLOBAL_STATE.currentPibblInstance.root = rootNode;\n    const driver = pibblInstance.backendDriver;\n    GLOBAL_STATE.backendDriver = driver;\n    frame = driver.beginFrame({\n      canvas,\n      logicalWidth: pibblInstance.rootLayoutBox.width,\n      logicalHeight: pibblInstance.rootLayoutBox.height,\n      backingWidth: canvas.width,\n      backingHeight: canvas.height,\n      renderTimestamp: activeFrameSnapshot.logicalTime,\n    });\n    if (!frame) {\n      pibblInstance.eventRoot.html?.suspend(pibblInstance);\n      finishTransaction(true);\n      return;\n    }\n    pibblInstance.eventRoot.html?.beginRender(pibblInstance);\n    GLOBAL_STATE.backendFrame = frame;\n    GLOBAL_STATE.backendEnvironment = frame.environment;\n    GLOBAL_STATE.renderContext = frame.context2D;\n    GLOBAL_STATE.renderTarget = frame.renderTarget;\n    GLOBAL_STATE.worldBaseTransform = frame.worldBaseTransform;\n    GLOBAL_STATE.worldExactTransform = undefined;\n    GLOBAL_STATE.worldPaintAnchorTransform = undefined;\n    GLOBAL_STATE.presentationTransformLineage = undefined;\n    GLOBAL_STATE.presentationTransformLineageTrackingDepth = 0;\n    if (\n      frame.context2D !== undefined &&\n      frame.renderTarget !== undefined &&\n      frame.worldBaseTransform !== undefined\n    ) {\n      initializeCurrentWorldTransformAnchor(frame.worldBaseTransform);\n    }\n    GLOBAL_STATE.clippingStack = [];\n    const surface = pibblInstance.surface.snapshot;\n    const logicalWidth = surface?.logicalWidth ?? pibblInstance.rootLayoutBox.width;\n    const logicalHeight = surface?.logicalHeight ?? pibblInstance.rootLayoutBox.height;\n    const previousRootBox = pibblInstance.rootLayoutBox;\n    if (\n      previousRootBox.width !== logicalWidth ||\n      previousRootBox.height !== logicalHeight\n    ) {\n      pibblInstance.rootLayoutBox = Object.freeze({\n        x: 0,\n        y: 0,\n        width: logicalWidth,\n        height: logicalHeight,\n      });\n    }\n    GLOBAL_STATE.layoutStack = [{\n      allocation: pibblInstance.rootLayoutBox,\n      percentageBasis: pibblInstance.rootLayoutBox,\n    }];\n\n    const renderGeneration = ++pibblInstance.renderGeneration;\n    if (!pibblInstance.parent) {\n      renderTransaction.onFinish((success) => {\n        if (success) pibblInstance.committedRenderGeneration = renderGeneration;\n      });\n      if (pibblInstance.rootFrameObservers?.size) {\n        renderTransaction.onAfterFinish?.((success) => {\n          const observers = pibblInstance.rootFrameObservers;\n          if (!observers) return;\n          for (const observer of observers)\n            observer(success, renderGeneration);\n        });\n      }\n    }\n    renderSeenIds = pibblInstance.renderSeenIds;\n    renderSeenKeys = pibblInstance.renderSeenKeys;\n    renderSeenIds.clear();\n    renderSeenKeys.clear();\n    GLOBAL_STATE.seenIds = renderSeenIds;\n    GLOBAL_STATE.seenKeys = renderSeenKeys;\n    const id = 'root';\n    renderSeenIds.add(id);\n    withSignalWriteForbidden(\n      'Pibbl render',\n      () => render(rootNode, id, undefined),\n    );\n\n    for (const [id, componentRefs] of pibblInstance.refs) {\n      if (componentRefs.renderGeneration === renderGeneration) continue;\n      componentRefs.teardowns.execute();\n      pibblInstance.refs.delete(id);\n    }\n    frameSuccess = true;\n    for (const service of pibblInstance.optionalServices.values()) service.endRender?.(true);\n    driver.finishFrame(frame, true);\n    finishTransaction(true);\n  } catch (error) {\n    for (const service of pibblInstance.optionalServices.values()) service.endRender?.(false);\n    finishTransaction(false);\n    for (const refs of pibblInstance.refs.values()) {\n      refs.teardowns.execute();\n    }\n    pibblInstance.refs.clear();\n    throw error;\n  } finally {\n    try {\n      if (frame && !frameSuccess) {\n        pibblInstance.backendDriver.finishFrame(frame, false);\n      }\n    } finally {\n      try {\n        clearTempState();\n        GLOBAL_STATE.clippingStack = prevClippingStack;\n        GLOBAL_STATE.layoutStack = prevLayoutStack;\n        if (ownsRenderTransaction) {\n          try {\n            finishTransaction(false);\n          } finally {\n            if (pibblInstance.eventRoot.renderTransaction === renderTransaction) {\n              pibblInstance.eventRoot.renderTransaction = undefined;\n            }\n          }\n        }\n      } finally {\n        renderSeenIds?.clear();\n        renderSeenKeys?.clear();\n        GLOBAL_STATE.currentPibblInstance = prevCurrentPibblInstance;\n        GLOBAL_STATE.canvas = prevCanvas;\n        GLOBAL_STATE.renderContext = prevRenderContext;\n        GLOBAL_STATE.renderTarget = prevRenderTarget;\n        GLOBAL_STATE.worldBaseTransform = prevWorldBaseTransform;\n        GLOBAL_STATE.worldExactTransform = prevWorldExactTransform;\n        GLOBAL_STATE.worldPaintAnchorTransform = prevWorldPaintAnchorTransform;\n        GLOBAL_STATE.presentationTransformLineage = prevPresentationTransformLineage;\n        GLOBAL_STATE.presentationTransformLineageTrackingDepth =\n          prevPresentationTransformLineageTrackingDepth;\n        GLOBAL_STATE.renderTransaction = prevRenderTransaction;\n        GLOBAL_STATE.frameSnapshot = prevFrameSnapshot;\n        GLOBAL_STATE.primitiveReceiverToken = prevPrimitiveReceiverToken;\n        GLOBAL_STATE.seenIds = prevSeenIds;\n        GLOBAL_STATE.seenKeys = prevSeenKeys;\n        GLOBAL_STATE.componentRefs = prevComponentRefs;\n        GLOBAL_STATE.componentHookIndex = prevComponentHookIndex;\n        GLOBAL_STATE.componentIsMounting = prevComponentIsMounting;\n        GLOBAL_STATE.backendDriver = prevBackendDriver;\n        GLOBAL_STATE.backendFrame = prevBackendFrame;\n        GLOBAL_STATE.backendEnvironment = prevBackendEnvironment;\n      }\n    }\n  }\n}\n"],
+  "mappings": "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",
   "names": ["id"]
 }

package/dist/lib/recording/recording.d.ts

@@ -0,0 +1,43 @@
+import type { Canvas } from "../types.js";
+import type { PibblFrameRecording, PibblFrameRecordingOptions, PibblFrameRecordingSession, PibblGifExportOptions } from "./types.js";
+/** Private deterministic ownership evidence; not a public diagnostics API. */
+export declare const recordingResources: {
+    workers: number;
+    urls: number;
+    observers: number;
+    timers: number;
+    abortListeners: number;
+    requests: number;
+    exports: number;
+};
+/**
+ * Record committed bitmap frames from any live Pibbl root canvas.
+ *
+ * Capture uses the existing render lifecycle; it never starts a render loop.
+ * Stop retains frames; cancel discards them. Dispose the completed recording
+ * after reading or exporting it. Resizing, failed renders, unreadable pixels,
+ * allocation failure, and capture queue overflow reject and release the session.
+ *
+ * @param canvas The canvas belonging to a live Pibbl root mount.
+ * @param options Capture duration, maximum frame rate, allocation headroom, and cancellation.
+ * @returns Stable controls and promises for one recording session.
+ * @see {@link PibblFrameRecordingOptions}
+ * @see {@link PibblFrameRecordingSession}
+ */
+export declare function recordFrames(canvas: Canvas, options: PibblFrameRecordingOptions): PibblFrameRecordingSession;
+/**
+ * Encode a retained recording to an image/gif Blob in its worker's WASM encoder.
+ *
+ * Pixels remain worker-owned. Cancellation stops encoding and preserves the
+ * recording; disposing the recording cancels all pending reads and exports.
+ * GIF timing is rounded cumulatively to 10ms units. Without an opaque background,
+ * alpha below 128 is transparent and other pixels are opaque. Only one export
+ * per recording may run at a time. Requires workers, WebAssembly, and blob-worker CSP permission.
+ *
+ * @param recording Retained frames returned by recordFrames.
+ * @param options Output dimensions, palette, dithering, sampling, looping, background, progress, and cancellation.
+ * @returns Encoded GIF bytes as a caller-owned Blob.
+ * @see {@link PibblGifExportOptions}
+ * @see {@link PibblFrameRecording}
+ */
+export declare function exportGif(recording: PibblFrameRecording, options?: PibblGifExportOptions): Promise<Blob>;