@pibbl/core 0.0.1 → 0.0.3-alpha.109.1

package/dist/lib/mount-pibbl.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../src/lib/mount-pibbl.ts"],
-  "sourcesContent": ["import { reserveHtmlOverlay } from './html/overlay-config.js';\nimport {\n  cleanupPibblInstance,\n  GLOBAL_STATE,\n  NO_PENDING_ROOT,\n} from './global-state.js';\nimport { PIBBL_EVENT_TYPES } from './events/event-definitions.js';\nimport {\n  dispatchNativeEvent,\n  refreshInteractionCursor,\n  releaseEventNodeState,\n} from './events/dispatch.js';\nimport { createNativeListenerHub } from './events/native-listener-hub.js';\nimport type { PibblEventType as DOMPibblEventType } from './events/types.js';\nimport { Teardowns } from './teardowns.js';\nimport {\n  Canvas,\n  PibblController,\n  PibblEventRoot,\n  PibblInstance,\n  PibblNativeObserver,\n  type PibblNode,\n} from './types.js';\nimport type { PibblConfig, PibblSurfaceSnapshot } from './surface/types.js';\nimport {\n  createLegacyLayerSurfaceState,\n  createRootSurfaceState,\n  mountRootSurface,\n} from './surface/root-surface.js';\nimport { CANVAS_2D_BACKEND } from './backend/canvas-2d-backend.js';\nimport type {\n  PibblBackendDriver,\n  PibblBackendMount,\n  PibblBackendMountOptions,\n} from './backend/types.js';\nimport { createLayerSurface } from './surface/resolve-surface.js';\nimport { executeRender } from './execute-render.js';\nimport { update } from './update.js';\nimport {\n  queueBeginCommand,\n  registerRootInstance,\n} from './scheduler/realm-scheduler.js';\nimport type { PibblBeginCommandHandle } from './scheduler/types.js';\n\ntype MountPibblConfig = PibblConfig & {\n  parent?: Canvas;\n  surface?: PibblSurfaceSnapshot;\n  driver?: PibblBackendDriver<unknown>;\n};\n\nexport function mountPibbl(\n  canvas: Canvas,\n  element: PibblNode,\n  config?: MountPibblConfig,\n): PibblController {\n  if (GLOBAL_STATE.pibblInstances.has(canvas)) {\n    throw new Error('Pibbl is already mounted on this element.');\n  }\n  const mainTeardowns = new Teardowns();\n  const signal = config?.signal;\n  let ownedInstance: PibblInstance | undefined;\n  const controller: PibblController = {\n    dispose(): void {\n      const instance = ownedInstance;\n      if (!instance) {\n        return;\n      }\n      cleanupPibblInstance(instance);\n      ownedInstance = undefined;\n    },\n  };\n  const parent = config?.parent;\n  const rootCanvas = isHTMLCanvas(canvas) ? canvas : undefined;\n  const surface = parent || !rootCanvas ?\n    config?.surface ?\n      { kind: 'layer' as const, managed: true, snapshot: config.surface } :\n      createLegacyLayerSurfaceState(canvas.width, canvas.height) :\n    createRootSurfaceState(rootCanvas, config);\n\n  const parentInstance = parent ? GLOBAL_STATE.pibblInstances.get(parent) : undefined;\n  if (parent && !parentInstance) {\n    throw new Error('Parent Pibbl interaction root not found');\n  }\n\n  let pibblInstance: PibblInstance;\n  const eventRoot: PibblEventRoot = parentInstance?.eventRoot ?? createEventRoot(\n    rootCanvas,\n    mainTeardowns,\n    (type, event) => {\n      dispatchNativeEvent(pibblInstance, type, event);\n    },\n  );\n\n  pibblInstance = {\n    canvas,\n    controller,\n    root: element,\n    pendingRoot: NO_PENDING_ROOT,\n    pendingUpdateParents: false,\n    refs: new Map(),\n    renderGeneration: 0,\n    renderSeenIds: new Set(),\n    renderSeenKeys: new Set(),\n    requestedRenderRevision: 0,\n    completedRenderRevision: 0,\n    renderTimestamp: 0,\n    mainTeardowns,\n    eventRoot,\n    regions: new Set(),\n    paintEntries: new Set(),\n    cursorDefaults: new Set(),\n    interaction: {\n      hoveredRegion: undefined,\n      primaryDown: undefined,\n      primaryUp: undefined,\n      auxiliaryDown: new Map(),\n      auxiliaryUp: new Map(),\n      clickStreakTarget: undefined,\n      clickStreak: 0,\n      cursorRegion: undefined,\n      cursorDefault: undefined,\n      pointerCanvas: undefined,\n      cursorCanvas: undefined,\n      cursorStyle: undefined,\n    },\n    interactionRoot: undefined,\n    parent,\n    eventParent: undefined,\n    focusParentBridge: undefined,\n    rootLayoutBox: Object.freeze({\n      x: 0,\n      y: 0,\n      width: surface.snapshot?.logicalWidth ??\n        (surface.kind === 'root' && surface.config.mode === 'fixed' ?\n          surface.config.width :\n          surface.kind === 'root' ? surface.display.width : canvas.width),\n      height: surface.snapshot?.logicalHeight ??\n        (surface.kind === 'root' && surface.config.mode === 'fixed' ?\n          surface.config.height :\n          surface.kind === 'root' ? surface.display.height : canvas.height),\n    }),\n    surface,\n    optionalServices: new Map(),\n    backendDriver: config?.driver ?? CANVAS_2D_BACKEND,\n  };\n  pibblInstance.interactionRoot = parent ?\n      GLOBAL_STATE.pibblInstances.get(parent)?.interactionRoot :\n    pibblInstance;\n  if (!pibblInstance.interactionRoot) throw new Error('Parent Pibbl interaction root not found');\n  if (!parent) {\n    eventRoot.rootInstance = pibblInstance;\n    eventRoot.onNodeRelease = node => releaseEventNodeState(pibblInstance, node);\n    eventRoot.onTargetUpdate = target =>\n      refreshInteractionCursor(pibblInstance, target);\n  }\n  ownedInstance = pibblInstance;\n  GLOBAL_STATE.pibblInstances.set(canvas, pibblInstance);\n\n  try {\n    if (config?.htmlOverlay) reserveHtmlOverlay(pibblInstance, config.htmlOverlay);\n    if (!parent && rootCanvas) {\n      mountRootSurface(pibblInstance, rootCanvas);\n    }\n    if (signal) {\n      const abortHandler = () => controller.dispose();\n      signal.addEventListener('abort', abortHandler, { once: true });\n      mainTeardowns.add(() => {\n        signal.removeEventListener('abort', abortHandler);\n      });\n    }\n\n    if (signal?.aborted) {\n      controller.dispose();\n    }\n  } catch (error) {\n    controller.dispose();\n    throw error;\n  }\n\n  if (!parent && GLOBAL_STATE.pibblInstances.get(canvas) === pibblInstance) {\n    registerRootInstance(pibblInstance);\n  }\n\n  return controller;\n}\n\n/**\n * Mounts a private official-backend Pibbl child under an existing Pibbl root.\n *\n * @param canvas - Host canvas for this backend mount. See {@link Canvas}.\n * @param root - Initial Pibbl node tree. See {@link PibblNode}.\n * @param options - Backend driver and mount configuration. See {@link PibblBackendMountOptions}.\n * @returns Mount controls for rendering, resizing, scheduling, and disposal. See\n * {@link PibblBackendMount} .\n *\n * @see {@link Canvas}\n * @see {@link PibblNode}\n * @see {@link PibblBackendMountOptions}\n * @see {@link PibblBackendMount}\n */\nexport function mountBackendPibbl<E>(\n  canvas: Canvas,\n  root: PibblNode,\n  options: PibblBackendMountOptions<E>,\n): PibblBackendMount {\n  const { logicalWidth, logicalHeight } = options;\n  const surface = createLayerSurface(\n    logicalWidth,\n    logicalHeight,\n    canvas.width / logicalWidth,\n    canvas.height / logicalHeight,\n  );\n  const controller = mountPibbl(canvas, root, {\n    parent: options.parent,\n    surface,\n    driver: options.driver as PibblBackendDriver<unknown>,\n  });\n  const instance = GLOBAL_STATE.pibblInstances.get(canvas);\n  if (!instance) {\n    throw new Error('Pibbl backend mount did not retain its instance.');\n  }\n  const requireActiveInstance = () => {\n    if (\n      instance.mainTeardowns.closed ||\n      GLOBAL_STATE.pibblInstances.get(canvas) !== instance\n    ) {\n      throw new Error('Pibbl backend mount is no longer active.');\n    }\n  };\n  let pendingFrame: PibblBeginCommandHandle | undefined;\n  let pendingUpdateParents = false;\n  const cancelFrame = () => {\n    pendingFrame?.cancel();\n    pendingFrame = undefined;\n    pendingUpdateParents = false;\n  };\n  return Object.freeze({\n    canvas,\n    resize(nextLogicalWidth: number, nextLogicalHeight: number): void {\n      requireActiveInstance();\n      const nextSurface = createLayerSurface(\n        nextLogicalWidth,\n        nextLogicalHeight,\n        canvas.width / nextLogicalWidth,\n        canvas.height / nextLogicalHeight,\n      );\n      if (instance.surface.kind !== 'layer') {\n        throw new Error('Pibbl backend mount does not own a managed layer surface.');\n      }\n      instance.surface.snapshot = nextSurface;\n      instance.surface.managed = true;\n      instance.rootLayoutBox = Object.freeze({\n        x: 0,\n        y: 0,\n        width: nextSurface.logicalWidth,\n        height: nextSurface.logicalHeight,\n      });\n    },\n    render(nextRoot: PibblNode, timestamp: number): void {\n      requireActiveInstance();\n      executeRender(canvas, timestamp, nextRoot, false);\n    },\n    requestFrame(updateParents: boolean): void {\n      requireActiveInstance();\n      pendingUpdateParents ||= updateParents;\n      if (pendingFrame) return;\n      pendingFrame = queueBeginCommand(() => {\n        pendingFrame = undefined;\n        const updateParentsForFrame = pendingUpdateParents;\n        pendingUpdateParents = false;\n        requireActiveInstance();\n        if (updateParentsForFrame) {\n          update(canvas, undefined, true);\n        } else {\n          update(canvas);\n        }\n      });\n    },\n    dispose(): void {\n      cancelFrame();\n      controller.dispose();\n    },\n  });\n}\n\nfunction createEventRoot(\n  canvas: HTMLCanvasElement | undefined,\n  teardowns: Teardowns,\n  dispatch: (type: DOMPibblEventType, event: Event) => void,\n): PibblEventRoot {\n  const nativeListeners = canvas ? createNativeListenerHub(\n    canvas,\n    (definition, event) => dispatch(definition.type, event),\n    teardowns,\n  ) : undefined;\n  const observers = new Map<DOMPibblEventType, Set<PibblNativeObserver>>(\n    PIBBL_EVENT_TYPES.map(type => [\n      type,\n      createNativeObserverSet(type, nativeListeners),\n    ]),\n  );\n  return {\n    rootInstance: undefined,\n    canvas,\n    nativeListeners,\n    targets: new Set(),\n    listenersByComponent: new Map(),\n    observers,\n    pointerCaptures: new Map(),\n    onNodeRelease: undefined,\n    onTargetUpdate: undefined,\n  };\n}\n\nfunction createNativeObserverSet(\n  type: DOMPibblEventType,\n  nativeListeners: PibblEventRoot['nativeListeners'],\n): Set<PibblNativeObserver> {\n  const observers = new Set<PibblNativeObserver>();\n  const originalAdd = observers.add;\n  const originalDelete = observers.delete;\n  const originalClear = observers.clear;\n  let release: (() => void) | undefined;\n\n  observers.add = ((observer) => {\n    const wasEmpty = observers.size === 0;\n    originalAdd.call(observers, observer);\n    if (wasEmpty) {\n      release = nativeListeners?.acquire(type);\n    }\n    return observers;\n  }) as typeof observers.add;\n  observers.delete = ((observer) => {\n    const deleted = originalDelete.call(observers, observer);\n    if (deleted && observers.size === 0) {\n      release?.();\n      release = undefined;\n    }\n    return deleted;\n  }) as typeof observers.delete;\n  observers.clear = (() => {\n    if (observers.size > 0) {\n      originalClear.call(observers);\n      release?.();\n      release = undefined;\n    }\n  }) as typeof observers.clear;\n  return observers;\n}\n\nfunction isHTMLCanvas(canvas: Canvas): canvas is HTMLCanvasElement {\n  return typeof HTMLCanvasElement !== 'undefined' && canvas instanceof HTMLCanvasElement;\n}\n"],
-  "mappings": "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",
+  "sourcesContent": ["import { reserveHtmlOverlay } from './html/overlay-config.js';\nimport {\n  cleanupPibblInstance,\n  GLOBAL_STATE,\n  NO_PENDING_ROOT,\n} from './global-state.js';\nimport { PIBBL_EVENT_TYPES } from './events/event-definitions.js';\nimport {\n  dispatchNativeEvent,\n  refreshInteractionCursor,\n  releaseEventNodeState,\n} from './events/dispatch.js';\nimport { createNativeListenerHub } from './events/native-listener-hub.js';\nimport type { PibblEventType as DOMPibblEventType } from './events/types.js';\nimport { Teardowns } from './teardowns.js';\nimport {\n  Canvas,\n  PibblController,\n  PibblEventRoot,\n  PibblInstance,\n  PibblNativeObserver,\n  type PibblNode,\n} from './types.js';\nimport type { PibblConfig, PibblSurfaceSnapshot } from './surface/types.js';\nimport {\n  createLegacyLayerSurfaceState,\n  createRootSurfaceState,\n  mountRootSurface,\n} from './surface/root-surface.js';\nimport { CANVAS_2D_BACKEND } from './backend/canvas-2d-backend.js';\nimport type {\n  PibblBackendDriver,\n  PibblBackendMount,\n  PibblBackendMountOptions,\n} from './backend/types.js';\nimport { createLayerSurface } from './surface/resolve-surface.js';\nimport { executeRender } from './execute-render.js';\nimport { update } from './update.js';\nimport {\n  queueBeginCommand,\n  registerRootInstance,\n} from './scheduler/realm-scheduler.js';\nimport type { PibblBeginCommandHandle } from './scheduler/types.js';\n\ntype MountPibblConfig = PibblConfig & {\n  parent?: Canvas;\n  surface?: PibblSurfaceSnapshot;\n  driver?: PibblBackendDriver<unknown>;\n};\n\nexport function mountPibbl(\n  canvas: Canvas,\n  element: PibblNode,\n  config?: MountPibblConfig,\n): PibblController {\n  if (GLOBAL_STATE.pibblInstances.has(canvas)) {\n    throw new Error('Pibbl is already mounted on this element.');\n  }\n  const mainTeardowns = new Teardowns();\n  const signal = config?.signal;\n  let ownedInstance: PibblInstance | undefined;\n  const controller: PibblController = {\n    dispose(): void {\n      const instance = ownedInstance;\n      if (!instance) {\n        return;\n      }\n      cleanupPibblInstance(instance);\n      ownedInstance = undefined;\n    },\n  };\n  const parent = config?.parent;\n  const rootCanvas = isHTMLCanvas(canvas) ? canvas : undefined;\n  const surface = parent || !rootCanvas ?\n    config?.surface ?\n      { kind: 'layer' as const, managed: true, snapshot: config.surface } :\n      createLegacyLayerSurfaceState(canvas.width, canvas.height) :\n    createRootSurfaceState(rootCanvas, config);\n\n  const parentInstance = parent ? GLOBAL_STATE.pibblInstances.get(parent) : undefined;\n  if (parent && !parentInstance) {\n    throw new Error('Parent Pibbl interaction root not found');\n  }\n\n  let pibblInstance: PibblInstance;\n  const eventRoot: PibblEventRoot = parentInstance?.eventRoot ?? createEventRoot(\n    rootCanvas,\n    mainTeardowns,\n    (type, event) => {\n      dispatchNativeEvent(pibblInstance, type, event);\n    },\n  );\n\n  pibblInstance = {\n    canvas,\n    controller,\n    root: element,\n    pendingRoot: NO_PENDING_ROOT,\n    pendingUpdateParents: false,\n    refs: new Map(),\n    renderGeneration: 0,\n    renderSeenIds: new Set(),\n    renderSeenKeys: new Set(),\n    requestedRenderRevision: 0,\n    completedRenderRevision: 0,\n    renderTimestamp: 0,\n    mainTeardowns,\n    eventRoot,\n    regions: new Set(),\n    paintEntries: new Set(),\n    cursorDefaults: new Set(),\n    interaction: {\n      hoveredRegion: undefined,\n      primaryDown: undefined,\n      primaryUp: undefined,\n      auxiliaryDown: new Map(),\n      auxiliaryUp: new Map(),\n      clickStreakTarget: undefined,\n      clickStreak: 0,\n      cursorRegion: undefined,\n      cursorDefault: undefined,\n      pointerCanvas: undefined,\n      cursorCanvas: undefined,\n      cursorStyle: undefined,\n    },\n    interactionRoot: undefined,\n    parent,\n    eventParent: undefined,\n    focusParentBridge: undefined,\n    rootLayoutBox: Object.freeze({\n      x: 0,\n      y: 0,\n      width: surface.snapshot?.logicalWidth ??\n        (surface.kind === 'root' && surface.config.mode === 'fixed' ?\n          surface.config.width :\n          surface.kind === 'root' ? surface.display.width : canvas.width),\n      height: surface.snapshot?.logicalHeight ??\n        (surface.kind === 'root' && surface.config.mode === 'fixed' ?\n          surface.config.height :\n          surface.kind === 'root' ? surface.display.height : canvas.height),\n    }),\n    rootLayoutDirection: 'ltr',\n    surface,\n    optionalServices: new Map(),\n    backendDriver: config?.driver ?? CANVAS_2D_BACKEND,\n  };\n  pibblInstance.interactionRoot = parent ?\n      GLOBAL_STATE.pibblInstances.get(parent)?.interactionRoot :\n    pibblInstance;\n  if (!pibblInstance.interactionRoot) throw new Error('Parent Pibbl interaction root not found');\n  if (!parent) {\n    eventRoot.rootInstance = pibblInstance;\n    eventRoot.onNodeRelease = node => releaseEventNodeState(pibblInstance, node);\n    eventRoot.onTargetUpdate = target =>\n      refreshInteractionCursor(pibblInstance, target);\n  }\n  ownedInstance = pibblInstance;\n  GLOBAL_STATE.pibblInstances.set(canvas, pibblInstance);\n\n  try {\n    if (config?.htmlOverlay) reserveHtmlOverlay(pibblInstance, config.htmlOverlay);\n    if (!parent && rootCanvas) {\n      mountRootSurface(pibblInstance, rootCanvas);\n    }\n    if (signal) {\n      const abortHandler = () => controller.dispose();\n      signal.addEventListener('abort', abortHandler, { once: true });\n      mainTeardowns.add(() => {\n        signal.removeEventListener('abort', abortHandler);\n      });\n    }\n\n    if (signal?.aborted) {\n      controller.dispose();\n    }\n  } catch (error) {\n    controller.dispose();\n    throw error;\n  }\n\n  if (!parent && GLOBAL_STATE.pibblInstances.get(canvas) === pibblInstance) {\n    registerRootInstance(pibblInstance);\n  }\n\n  return controller;\n}\n\n/**\n * Mounts a private official-backend Pibbl child under an existing Pibbl root.\n *\n * @param canvas - Host canvas for this backend mount. See {@link Canvas}.\n * @param root - Initial Pibbl node tree. See {@link PibblNode}.\n * @param options - Backend driver and mount configuration. See {@link PibblBackendMountOptions}.\n * @returns Mount controls for rendering, resizing, scheduling, and disposal. See\n * {@link PibblBackendMount} .\n *\n * @see {@link Canvas}\n * @see {@link PibblNode}\n * @see {@link PibblBackendMountOptions}\n * @see {@link PibblBackendMount}\n */\nexport function mountBackendPibbl<E>(\n  canvas: Canvas,\n  root: PibblNode,\n  options: PibblBackendMountOptions<E>,\n): PibblBackendMount {\n  const { logicalWidth, logicalHeight } = options;\n  const surface = createLayerSurface(\n    logicalWidth,\n    logicalHeight,\n    canvas.width / logicalWidth,\n    canvas.height / logicalHeight,\n  );\n  const controller = mountPibbl(canvas, root, {\n    parent: options.parent,\n    surface,\n    driver: options.driver as PibblBackendDriver<unknown>,\n  });\n  const instance = GLOBAL_STATE.pibblInstances.get(canvas);\n  if (!instance) {\n    throw new Error('Pibbl backend mount did not retain its instance.');\n  }\n  const requireActiveInstance = () => {\n    if (\n      instance.mainTeardowns.closed ||\n      GLOBAL_STATE.pibblInstances.get(canvas) !== instance\n    ) {\n      throw new Error('Pibbl backend mount is no longer active.');\n    }\n  };\n  let pendingFrame: PibblBeginCommandHandle | undefined;\n  let pendingUpdateParents = false;\n  const cancelFrame = () => {\n    pendingFrame?.cancel();\n    pendingFrame = undefined;\n    pendingUpdateParents = false;\n  };\n  return Object.freeze({\n    canvas,\n    resize(nextLogicalWidth: number, nextLogicalHeight: number): void {\n      requireActiveInstance();\n      const nextSurface = createLayerSurface(\n        nextLogicalWidth,\n        nextLogicalHeight,\n        canvas.width / nextLogicalWidth,\n        canvas.height / nextLogicalHeight,\n      );\n      if (instance.surface.kind !== 'layer') {\n        throw new Error('Pibbl backend mount does not own a managed layer surface.');\n      }\n      instance.surface.snapshot = nextSurface;\n      instance.surface.managed = true;\n      instance.rootLayoutBox = Object.freeze({\n        x: 0,\n        y: 0,\n        width: nextSurface.logicalWidth,\n        height: nextSurface.logicalHeight,\n      });\n    },\n    render(nextRoot: PibblNode, timestamp: number): void {\n      requireActiveInstance();\n      executeRender(canvas, timestamp, nextRoot, false);\n    },\n    requestFrame(updateParents: boolean): void {\n      requireActiveInstance();\n      pendingUpdateParents ||= updateParents;\n      if (pendingFrame) return;\n      pendingFrame = queueBeginCommand(() => {\n        pendingFrame = undefined;\n        const updateParentsForFrame = pendingUpdateParents;\n        pendingUpdateParents = false;\n        requireActiveInstance();\n        if (updateParentsForFrame) {\n          update(canvas, undefined, true);\n        } else {\n          update(canvas);\n        }\n      });\n    },\n    dispose(): void {\n      cancelFrame();\n      controller.dispose();\n    },\n  });\n}\n\nfunction createEventRoot(\n  canvas: HTMLCanvasElement | undefined,\n  teardowns: Teardowns,\n  dispatch: (type: DOMPibblEventType, event: Event) => void,\n): PibblEventRoot {\n  const nativeListeners = canvas ? createNativeListenerHub(\n    canvas,\n    (definition, event) => dispatch(definition.type, event),\n    teardowns,\n  ) : undefined;\n  const observers = new Map<DOMPibblEventType, Set<PibblNativeObserver>>(\n    PIBBL_EVENT_TYPES.map(type => [\n      type,\n      createNativeObserverSet(type, nativeListeners),\n    ]),\n  );\n  return {\n    rootInstance: undefined,\n    canvas,\n    nativeListeners,\n    targets: new Set(),\n    listenersByComponent: new Map(),\n    observers,\n    pointerCaptures: new Map(),\n    onNodeRelease: undefined,\n    onTargetUpdate: undefined,\n  };\n}\n\nfunction createNativeObserverSet(\n  type: DOMPibblEventType,\n  nativeListeners: PibblEventRoot['nativeListeners'],\n): Set<PibblNativeObserver> {\n  const observers = new Set<PibblNativeObserver>();\n  const originalAdd = observers.add;\n  const originalDelete = observers.delete;\n  const originalClear = observers.clear;\n  let release: (() => void) | undefined;\n\n  observers.add = ((observer) => {\n    const wasEmpty = observers.size === 0;\n    originalAdd.call(observers, observer);\n    if (wasEmpty) {\n      release = nativeListeners?.acquire(type);\n    }\n    return observers;\n  }) as typeof observers.add;\n  observers.delete = ((observer) => {\n    const deleted = originalDelete.call(observers, observer);\n    if (deleted && observers.size === 0) {\n      release?.();\n      release = undefined;\n    }\n    return deleted;\n  }) as typeof observers.delete;\n  observers.clear = (() => {\n    if (observers.size > 0) {\n      originalClear.call(observers);\n      release?.();\n      release = undefined;\n    }\n  }) as typeof observers.clear;\n  return observers;\n}\n\nfunction isHTMLCanvas(canvas: Canvas): canvas is HTMLCanvasElement {\n  return typeof HTMLCanvasElement !== 'undefined' && canvas instanceof HTMLCanvasElement;\n}\n"],
+  "mappings": "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",
   "names": []
 }

package/dist/lib/mount-prepared-pibbl.d.ts

@@ -0,0 +1,5 @@
+import { PibblController, type PibblNode } from './types.js';
+import type { PibblConfig } from './surface/types.js';
+/** Validates a new request before it can supersede another pending request. */
+export declare function assertMountRequest(canvas: HTMLCanvasElement, element: PibblNode, config?: PibblConfig): void;
+export declare function mountPreparedPibbl(canvas: HTMLCanvasElement, element: PibblNode, config?: PibblConfig): PibblController;

package/dist/lib/mount-prepared-pibbl.js

@@ -0,0 +1,29 @@
+import { validateSurfaceConfig } from "./surface/resolve-surface.js";
+import { mountAbortError } from "./mount-request.js";
+import { GLOBAL_STATE } from "./global-state.js";
+import { mountPibbl } from "./mount-pibbl.js";
+import { assertCompatibleRootNode } from "./element/children.js";
+import { update } from "./update.js";
+function assertMountRequest(canvas, element, config) {
+  assertCompatibleRootNode(element);
+  if (!canvas || typeof canvas.getContext !== "function") throw new TypeError("Pibbl requires a canvas element.");
+  if (config?.signal?.aborted) throw mountAbortError();
+  if (!GLOBAL_STATE.pibblInstances.has(canvas)) validateSurfaceConfig(canvas, config);
+}
+function mountPreparedPibbl(canvas, element, config) {
+  const mountedInstance = GLOBAL_STATE.pibblInstances.get(canvas);
+  if (mountedInstance) {
+    update(canvas, element);
+    return mountedInstance.controller;
+  }
+  const controller = mountPibbl(canvas, element, config);
+  if (GLOBAL_STATE.pibblInstances.has(canvas)) {
+    update(canvas, element);
+  }
+  return controller;
+}
+export {
+  assertMountRequest,
+  mountPreparedPibbl
+};
+//# sourceMappingURL=mount-prepared-pibbl.js.map

package/dist/lib/mount-prepared-pibbl.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/lib/mount-prepared-pibbl.ts"],
+  "sourcesContent": ["import { validateSurfaceConfig } from './surface/resolve-surface.js';\nimport { mountAbortError } from './mount-request.js';\nimport { GLOBAL_STATE } from './global-state.js';\nimport { mountPibbl } from './mount-pibbl.js';\nimport { assertCompatibleRootNode } from './element/children.js';\nimport { PibblController, type PibblNode } from './types.js';\nimport { update } from './update.js';\nimport type { PibblConfig } from './surface/types.js';\n\n/** Validates a new request before it can supersede another pending request. */\nexport function assertMountRequest(canvas: HTMLCanvasElement, element: PibblNode, config?: PibblConfig): void {\n  assertCompatibleRootNode(element);\n  if (!canvas || typeof canvas.getContext !== \"function\") throw new TypeError(\"Pibbl requires a canvas element.\");\n  if (config?.signal?.aborted) throw mountAbortError();\n  // Live mounts retain their initial surface configuration; update options do\n  // not recapture or revalidate ignored surface fields.\n  if (!GLOBAL_STATE.pibblInstances.has(canvas)) validateSurfaceConfig(canvas, config);\n}\n\nexport function mountPreparedPibbl(\n  canvas: HTMLCanvasElement,\n  element: PibblNode,\n  config?: PibblConfig,\n): PibblController {\n  const mountedInstance = GLOBAL_STATE.pibblInstances.get(canvas);\n  if (mountedInstance) {\n    update(canvas, element);\n    return mountedInstance.controller;\n  }\n\n  const controller = mountPibbl(canvas, element, config);\n  if (GLOBAL_STATE.pibblInstances.has(canvas)) {\n    update(canvas, element);\n  }\n  return controller;\n}\n"],
+  "mappings": "AAAA,SAAS,6BAA6B;AACtC,SAAS,uBAAuB;AAChC,SAAS,oBAAoB;AAC7B,SAAS,kBAAkB;AAC3B,SAAS,gCAAgC;AAEzC,SAAS,cAAc;AAIhB,SAAS,mBAAmB,QAA2B,SAAoB,QAA4B;AAC5G,2BAAyB,OAAO;AAChC,MAAI,CAAC,UAAU,OAAO,OAAO,eAAe,WAAY,OAAM,IAAI,UAAU,kCAAkC;AAC9G,MAAI,QAAQ,QAAQ,QAAS,OAAM,gBAAgB;AAGnD,MAAI,CAAC,aAAa,eAAe,IAAI,MAAM,EAAG,uBAAsB,QAAQ,MAAM;AACpF;AAEO,SAAS,mBACd,QACA,SACA,QACiB;AACjB,QAAM,kBAAkB,aAAa,eAAe,IAAI,MAAM;AAC9D,MAAI,iBAAiB;AACnB,WAAO,QAAQ,OAAO;AACtB,WAAO,gBAAgB;AAAA,EACzB;AAEA,QAAM,aAAa,WAAW,QAAQ,SAAS,MAAM;AACrD,MAAI,aAAa,eAAe,IAAI,MAAM,GAAG;AAC3C,WAAO,QAAQ,OAAO;AAAA,EACxB;AACA,SAAO;AACT;",
+  "names": []
+}

package/dist/lib/mount-request.d.ts

@@ -0,0 +1,8 @@
+export declare function mountAbortError(): DOMException;
+export declare function cancelPendingMount(canvas: object): void;
+/** One reservation per Canvas; no mutable mount state exists while loading. */
+export declare function reserveMount(canvas: HTMLCanvasElement, signal?: AbortSignal): {
+    cancelled: Promise<never>;
+    assertCurrent(): void;
+    finish: () => void;
+};

package/dist/lib/mount-request.js

@@ -0,0 +1,41 @@
+const pendingMounts = /* @__PURE__ */ new WeakMap();
+function mountAbortError() {
+  return new DOMException("Pibbl mount was cancelled or superseded.", "AbortError");
+}
+function cancelPendingMount(canvas) {
+  pendingMounts.get(canvas)?.cancel();
+}
+function reserveMount(canvas, signal) {
+  if (signal?.aborted) throw mountAbortError();
+  cancelPendingMount(canvas);
+  let active = true;
+  let reject;
+  const cancelled = new Promise((_resolve, fail) => {
+    reject = fail;
+  });
+  const request = { cancel() {
+    if (!active) return;
+    finish();
+    reject(mountAbortError());
+  } };
+  function finish() {
+    active = false;
+    signal?.removeEventListener("abort", request.cancel);
+    if (pendingMounts.get(canvas) === request) pendingMounts.delete(canvas);
+  }
+  pendingMounts.set(canvas, request);
+  signal?.addEventListener("abort", request.cancel, { once: true });
+  return {
+    cancelled,
+    assertCurrent() {
+      if (!active || signal?.aborted || pendingMounts.get(canvas) !== request) throw mountAbortError();
+    },
+    finish
+  };
+}
+export {
+  cancelPendingMount,
+  mountAbortError,
+  reserveMount
+};
+//# sourceMappingURL=mount-request.js.map

package/dist/lib/mount-request.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/lib/mount-request.ts"],
+  "sourcesContent": ["interface MountRequest { cancel(): void }\nconst pendingMounts = new WeakMap<object, MountRequest>();\n\nexport function mountAbortError(): DOMException {\n  return new DOMException('Pibbl mount was cancelled or superseded.', 'AbortError');\n}\n\nexport function cancelPendingMount(canvas: object): void {\n  pendingMounts.get(canvas)?.cancel();\n}\n\n/** One reservation per Canvas; no mutable mount state exists while loading. */\nexport function reserveMount(canvas: HTMLCanvasElement, signal?: AbortSignal) {\n  if (signal?.aborted) throw mountAbortError();\n  cancelPendingMount(canvas);\n  let active = true;\n  let reject!: (error: unknown) => void;\n  const cancelled = new Promise<never>((_resolve, fail) => { reject = fail; });\n  const request: MountRequest = { cancel() {\n    if (!active) return;\n    finish();\n    reject(mountAbortError());\n  } };\n  function finish(): void {\n    active = false;\n    signal?.removeEventListener('abort', request.cancel);\n    if (pendingMounts.get(canvas) === request) pendingMounts.delete(canvas);\n  }\n  pendingMounts.set(canvas, request);\n  signal?.addEventListener('abort', request.cancel, { once: true });\n  return {\n    cancelled,\n    assertCurrent() { if (!active || signal?.aborted || pendingMounts.get(canvas) !== request) throw mountAbortError(); },\n    finish,\n  };\n}\n"],
+  "mappings": "AACA,MAAM,gBAAgB,oBAAI,QAA8B;AAEjD,SAAS,kBAAgC;AAC9C,SAAO,IAAI,aAAa,4CAA4C,YAAY;AAClF;AAEO,SAAS,mBAAmB,QAAsB;AACvD,gBAAc,IAAI,MAAM,GAAG,OAAO;AACpC;AAGO,SAAS,aAAa,QAA2B,QAAsB;AAC5E,MAAI,QAAQ,QAAS,OAAM,gBAAgB;AAC3C,qBAAmB,MAAM;AACzB,MAAI,SAAS;AACb,MAAI;AACJ,QAAM,YAAY,IAAI,QAAe,CAAC,UAAU,SAAS;AAAE,aAAS;AAAA,EAAM,CAAC;AAC3E,QAAM,UAAwB,EAAE,SAAS;AACvC,QAAI,CAAC,OAAQ;AACb,WAAO;AACP,WAAO,gBAAgB,CAAC;AAAA,EAC1B,EAAE;AACF,WAAS,SAAe;AACtB,aAAS;AACT,YAAQ,oBAAoB,SAAS,QAAQ,MAAM;AACnD,QAAI,cAAc,IAAI,MAAM,MAAM,QAAS,eAAc,OAAO,MAAM;AAAA,EACxE;AACA,gBAAc,IAAI,QAAQ,OAAO;AACjC,UAAQ,iBAAiB,SAAS,QAAQ,QAAQ,EAAE,MAAM,KAAK,CAAC;AAChE,SAAO;AAAA,IACL;AAAA,IACA,gBAAgB;AAAE,UAAI,CAAC,UAAU,QAAQ,WAAW,cAAc,IAAI,MAAM,MAAM,QAAS,OAAM,gBAAgB;AAAA,IAAG;AAAA,IACpH;AAAA,EACF;AACF;",
+  "names": []
+}

package/dist/lib/pibbl.d.ts

@@ -1,17 +1,25 @@
-import { PibblController, type PibblNode } from './types.js';
+import type { PibblController, PibblNode } from './types.js';
 import type { PibblConfig } from './surface/types.js';
 /**
- * Mounts or updates a canvas render component on a given HTMLCanvasElement.
- * The first mount captures the surface configuration; later calls update only
- * the root element until that controller is disposed.
- * @param canvas The canvas to render on
- * @param element The Pibbl element to render
- * @param config The mount lifetime, logical viewport, fit, and pixel density. See
- * {@link PibblConfig} .
- * @returns The stable {@link PibblController} for this canvas; dispose it to release the mount.
- *
- * @see {@link PibblNode}
- * @see {@link PibblConfig}
+ * Fetches and compiles the external layout WASM ahead of mounting. Concurrent
+ * calls share one attempt; a later call retries after failure. Creates no mount.
+ * HTML preload can independently warm the network cache.
+ * @returns A Promise fulfilled when the compatible compiled module is ready.
+ * @throws Rejects on fetch, integrity or compilation failure, with the original cause.
+ * @see {@link pibbl}
+ */
+export declare function prepareLayoutEngine(): Promise<void>;
+/**
+ * Prepares the external layout engine, then mounts or updates one Canvas.
+ * The first live mount owns surface configuration and its lifetime signal.
+ * Layout, component evaluation and scheduled frames remain synchronous.
+ * @param canvas The HTML Canvas owned by the mount.
+ * @param element The branded recursive root descriptor. See {@link PibblNode}.
+ * @param config Surface and lifetime options. See {@link PibblConfig}.
+ * @returns A Promise for the stable {@link PibblController}; dispose releases the mount.
+ * @throws Rejects on loading/mount failure, or with AbortError on cancellation,
+ * supersession or disposal while pending. A later call retries failed loading.
+ * @see {@link prepareLayoutEngine}
  * @see {@link PibblController}
  */
-export declare function pibbl(canvas: HTMLCanvasElement, element: PibblNode, config?: PibblConfig): PibblController;
+export declare function pibbl(canvas: HTMLCanvasElement, element: PibblNode, config?: PibblConfig): Promise<PibblController>;

package/dist/lib/pibbl.js

@@ -1,21 +1,23 @@
-import { GLOBAL_STATE } from "./global-state.js";
-import { mountPibbl } from "./mount-pibbl.js";
-import { assertCompatibleRootNode } from "./element/children.js";
-import { update } from "./update.js";
-function pibbl(canvas, element, config) {
-  assertCompatibleRootNode(element);
-  const mountedInstance = GLOBAL_STATE.pibblInstances.get(canvas);
-  if (mountedInstance) {
-    update(canvas, element);
-    return mountedInstance.controller;
-  }
-  const controller = mountPibbl(canvas, element, config);
-  if (GLOBAL_STATE.pibblInstances.has(canvas)) {
-    update(canvas, element);
+import { prepareLayoutModule } from "./layout/wasm/module.js";
+import { reserveMount } from "./mount-request.js";
+import { assertMountRequest, mountPreparedPibbl } from "./mount-prepared-pibbl.js";
+function prepareLayoutEngine() {
+  return prepareLayoutModule();
+}
+async function pibbl(canvas, element, config) {
+  assertMountRequest(canvas, element, config);
+  const request = reserveMount(canvas, config?.signal);
+  try {
+    await Promise.race([prepareLayoutModule(), request.cancelled]);
+    request.assertCurrent();
+    request.finish();
+    return mountPreparedPibbl(canvas, element, config);
+  } finally {
+    request.finish();
   }
-  return controller;
 }
 export {
-  pibbl
+  pibbl,
+  prepareLayoutEngine
 };
 //# sourceMappingURL=pibbl.js.map

package/dist/lib/pibbl.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../src/lib/pibbl.ts"],
-  "sourcesContent": ["import { GLOBAL_STATE } from './global-state.js';\nimport { mountPibbl } from './mount-pibbl.js';\nimport { assertCompatibleRootNode } from './element/children.js';\nimport { PibblController, type PibblNode } from './types.js';\nimport { update } from './update.js';\nimport type { PibblConfig } from './surface/types.js';\n\n/**\n * Mounts or updates a canvas render component on a given HTMLCanvasElement.\n * The first mount captures the surface configuration; later calls update only\n * the root element until that controller is disposed.\n * @param canvas The canvas to render on\n * @param element The Pibbl element to render\n * @param config The mount lifetime, logical viewport, fit, and pixel density. See\n * {@link PibblConfig} .\n * @returns The stable {@link PibblController} for this canvas; dispose it to release the mount.\n *\n * @see {@link PibblNode}\n * @see {@link PibblConfig}\n * @see {@link PibblController}\n */\nexport function pibbl(\n  canvas: HTMLCanvasElement,\n  element: PibblNode,\n  config?: PibblConfig,\n): PibblController {\n  assertCompatibleRootNode(element);\n  const mountedInstance = GLOBAL_STATE.pibblInstances.get(canvas);\n  if (mountedInstance) {\n    update(canvas, element);\n    return mountedInstance.controller;\n  }\n\n  const controller = mountPibbl(canvas, element, config);\n  if (GLOBAL_STATE.pibblInstances.has(canvas)) {\n    update(canvas, element);\n  }\n  return controller;\n}\n"],
-  "mappings": "AAAA,SAAS,oBAAoB;AAC7B,SAAS,kBAAkB;AAC3B,SAAS,gCAAgC;AAEzC,SAAS,cAAc;AAiBhB,SAAS,MACd,QACA,SACA,QACiB;AACjB,2BAAyB,OAAO;AAChC,QAAM,kBAAkB,aAAa,eAAe,IAAI,MAAM;AAC9D,MAAI,iBAAiB;AACnB,WAAO,QAAQ,OAAO;AACtB,WAAO,gBAAgB;AAAA,EACzB;AAEA,QAAM,aAAa,WAAW,QAAQ,SAAS,MAAM;AACrD,MAAI,aAAa,eAAe,IAAI,MAAM,GAAG;AAC3C,WAAO,QAAQ,OAAO;AAAA,EACxB;AACA,SAAO;AACT;",
+  "sourcesContent": ["import { prepareLayoutModule } from './layout/wasm/module.js';\nimport { reserveMount } from './mount-request.js';\nimport { assertMountRequest, mountPreparedPibbl } from './mount-prepared-pibbl.js';\nimport type { PibblController, PibblNode } from './types.js';\nimport type { PibblConfig } from './surface/types.js';\n\n/**\n * Fetches and compiles the external layout WASM ahead of mounting. Concurrent\n * calls share one attempt; a later call retries after failure. Creates no mount.\n * HTML preload can independently warm the network cache.\n * @returns A Promise fulfilled when the compatible compiled module is ready.\n * @throws Rejects on fetch, integrity or compilation failure, with the original cause.\n * @see {@link pibbl}\n */\nexport function prepareLayoutEngine(): Promise<void> { return prepareLayoutModule(); }\n\n/**\n * Prepares the external layout engine, then mounts or updates one Canvas.\n * The first live mount owns surface configuration and its lifetime signal.\n * Layout, component evaluation and scheduled frames remain synchronous.\n * @param canvas The HTML Canvas owned by the mount.\n * @param element The branded recursive root descriptor. See {@link PibblNode}.\n * @param config Surface and lifetime options. See {@link PibblConfig}.\n * @returns A Promise for the stable {@link PibblController}; dispose releases the mount.\n * @throws Rejects on loading/mount failure, or with AbortError on cancellation,\n * supersession or disposal while pending. A later call retries failed loading.\n * @see {@link prepareLayoutEngine}\n * @see {@link PibblController}\n */\nexport async function pibbl(\n  canvas: HTMLCanvasElement,\n  element: PibblNode,\n  config?: PibblConfig,\n): Promise<PibblController> {\n  assertMountRequest(canvas, element, config);\n  const request = reserveMount(canvas, config?.signal);\n  try {\n    await Promise.race([prepareLayoutModule(), request.cancelled]);\n    request.assertCurrent();\n    // Clear only the pending reservation; mounted lifetime ownership takes over.\n    request.finish();\n    return mountPreparedPibbl(canvas, element, config);\n  } finally {\n    request.finish();\n  }\n}\n"],
+  "mappings": "AAAA,SAAS,2BAA2B;AACpC,SAAS,oBAAoB;AAC7B,SAAS,oBAAoB,0BAA0B;AAYhD,SAAS,sBAAqC;AAAE,SAAO,oBAAoB;AAAG;AAerF,eAAsB,MACpB,QACA,SACA,QAC0B;AAC1B,qBAAmB,QAAQ,SAAS,MAAM;AAC1C,QAAM,UAAU,aAAa,QAAQ,QAAQ,MAAM;AACnD,MAAI;AACF,UAAM,QAAQ,KAAK,CAAC,oBAAoB,GAAG,QAAQ,SAAS,CAAC;AAC7D,YAAQ,cAAc;AAEtB,YAAQ,OAAO;AACf,WAAO,mBAAmB,QAAQ,SAAS,MAAM;AAAA,EACnD,UAAE;AACA,YAAQ,OAAO;AAAA,EACjB;AACF;",
   "names": []
 }

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>;