@pibbl/core 0.0.1

package/dist/lib/render-layer/controller.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/lib/render-layer/controller.ts"],
+  "sourcesContent": ["import { GLOBAL_STATE, getCurrentPibblInstance } from \"../global-state.js\";\nimport { getCurrentWorldTransform } from \"../render-target.js\";\nimport {\n  queueFrameCompletion,\n  requestInstanceRender,\n} from \"../scheduler/realm-scheduler.js\";\nimport type { PibblComponentRefs, RenderingContext2D } from \"../types.js\";\nimport type { PibblPointerEvents } from \"../events/types.js\";\nimport {\n  PibblHitDisposition,\n  PibblPaintEntryKind,\n  type PibblHitTestOutput,\n  type PibblNestedPaintEntry,\n} from \"../events/paint-entry.js\";\nimport {\n  createTarget,\n  releaseTarget,\n  updateTarget,\n  type PibblEventTargetRegistration,\n} from \"../events/registrations.js\";\nimport {\n  hasResolverPointerCapture,\n  releaseResolverInputWinner,\n  releaseResolverPointerCapture,\n  setResolverPointerCapture,\n  type PibblResolverInputType,\n  type PibblResolverInputWinner,\n} from \"../events/resolver-input.js\";\nimport type {\n  PibblRenderLayerContext,\n  PibblRenderLayerDefinition,\n  PibblRenderLayerFrame,\n  PibblRenderLayerHit,\n  PibblRenderLayerInteractionSnapshot,\n  PibblRenderLayerSize,\n  PibblRenderLayerTarget,\n} from \"./types.js\";\n\nclass SynchronousLifecycleError extends TypeError {}\n\ninterface StagedInteraction<Target extends object> {\n  readonly snapshot: PibblRenderLayerInteractionSnapshot<Target>;\n  readonly targets: readonly PibblRenderLayerTarget<Target>[];\n  readonly transform: DOMMatrix;\n  readonly clippingStack: PibblNestedPaintEntry[\"clippingStack\"];\n}\n\ninterface RenderCandidate<Target extends object> {\n  readonly bitmap: ImageBitmap;\n  readonly interaction: StagedInteraction<Target>;\n  readonly policy: RenderLayerPolicy;\n}\n\ninterface RenderLayerPolicy {\n  readonly missBehavior: \"pass-through\" | \"block\" | \"target-layer\";\n  readonly pointerEvents: PibblPointerEvents | undefined;\n  readonly keyboardFocusable: boolean | undefined;\n  readonly keyboardNavigationBounds:\n    | Readonly<{\n        x: number;\n        y: number;\n        width: number;\n        height: number;\n      }>\n    | undefined;\n}\n\ninterface WinnerState<Target extends object> {\n  readonly point: Readonly<{ x: number; y: number }>;\n  readonly hit: PibblRenderLayerHit<Target>;\n}\n\nconst MISS_SNAPSHOT: PibblRenderLayerInteractionSnapshot<object> = Object.freeze({\n  targets: Object.freeze([]),\n  hitTest: () => Object.freeze({ kind: \"miss\" as const }),\n});\n\nconst RESOLVER_INPUT_TYPES = Object.freeze([\n  \"pointerdown\",\n  \"pointermove\",\n  \"pointerup\",\n  \"pointercancel\",\n  \"wheel\",\n  \"contextmenu\",\n  \"click\",\n] as const);\n\nconst RESOLVER_CAPTURE_INPUT_TYPES = Object.freeze([\n  \"pointermove\",\n  \"pointerup\",\n  \"pointercancel\",\n] as const);\n\n// The private target deliberately owns no user callback. This eligibility\n// marker lets the shared keyboard default dispatch its click through the\n// component's one structural listener.\nconst STRUCTURAL_CLICK_ELIGIBILITY = () => {};\n\nexport function assertSynchronous(value: unknown, callback: string): void {\n  if (value && typeof (value as { then?: unknown }).then === \"function\") {\n    throw new SynchronousLifecycleError(\n      `defineRenderLayer ${callback}() must be synchronous.`,\n    );\n  }\n}\n\nexport class RenderLayerController<Props, Resources, Target extends object> {\n  private readonly instance = getCurrentPibblInstance();\n  private readonly refs: PibblComponentRefs<any>;\n  private readonly canvas: OffscreenCanvas;\n  private readonly context: PibblRenderLayerContext;\n  private resources: Resources | undefined;\n  private created = false;\n  private disposed = false;\n  private size: PibblRenderLayerSize | undefined;\n  private props: Readonly<Props> | undefined;\n  private needsRender = true;\n  private needsResize = true;\n  private inputGated = true;\n  private candidate: RenderCandidate<Target> | undefined;\n  private committed: ImageBitmap | undefined;\n  private committedInteraction:\n    PibblRenderLayerInteractionSnapshot<Target> | undefined;\n  private committedTargetDescriptors: readonly PibblRenderLayerTarget<Target>[] =\n    Object.freeze([]);\n  private readonly committedTargets = new Map<\n    Target,\n    PibblEventTargetRegistration\n  >();\n  private readonly layerTarget: PibblEventTargetRegistration;\n  private committedPolicy: RenderLayerPolicy = Object.freeze({\n    missBehavior: \"pass-through\",\n    pointerEvents: undefined,\n    keyboardFocusable: undefined,\n    keyboardNavigationBounds: undefined,\n  });\n  private resolverTransform = new DOMMatrix();\n  private resolverInverseTransform = new DOMMatrix();\n  private resolverBounds = new Path2D();\n  private resolverSize: PibblRenderLayerSize | undefined;\n  private resolutionErrorQueued = false;\n  private readonly inputNativeReleases = new Map<\n    PibblResolverInputType,\n    () => void\n  >();\n  private readonly resolverEntry: PibblNestedPaintEntry;\n  private readonly inputWinner: PibblResolverInputWinner;\n  private lastTime: number | undefined;\n\n  constructor(\n    private readonly definition: PibblRenderLayerDefinition<\n      Props,\n      Resources,\n      Target\n    >,\n    refs: PibblComponentRefs<any>,\n  ) {\n    this.refs = refs;\n    this.layerTarget = createTarget(this.instance, refs, -1);\n    this.inputWinner = {\n      eventRoot: this.instance.eventRoot,\n      deliver: (type, point, originalEvent, state) =>\n        this.deliverInput(type, point, originalEvent, state),\n      onPointerCaptureChange: () =>\n        this.updateInputNativeOwnership(\n          Boolean(this.committedInteraction?.onInput),\n        ),\n    };\n    this.resolverEntry = {\n      paintKind: PibblPaintEntryKind.Resolver,\n      instance: this.instance,\n      bounds: this.resolverBounds,\n      transform: this.resolverTransform,\n      clippingStack: [],\n      resolveLocal: (x, y, output) => this.resolveLocal(x, y, output),\n    };\n    assertCapability();\n    this.canvas = new OffscreenCanvas(1, 1);\n    const controller = this;\n    this.context = Object.freeze({\n      canvas: this.canvas,\n      get size() {\n        if (!controller.size) {\n          throw new Error(\"Render layer size is unavailable before mount.\");\n        }\n        return controller.size;\n      },\n      invalidate() {\n        controller.invalidate(true);\n      },\n    });\n    refs.teardowns.add(() => this.dispose());\n  }\n\n  render(\n    props: Readonly<Props>,\n    size: PibblRenderLayerSize,\n    ctx: RenderingContext2D,\n    policy: RenderLayerPolicy = this.committedPolicy,\n  ): void {\n    if (this.disposed) return;\n    const initial = !this.created;\n    const propsChanged = !initial && !sameProps(this.props, props);\n    const sizeChanged = !sameSize(this.size, size);\n    const policyChanged = !samePolicy(this.committedPolicy, policy);\n    this.size = size;\n    this.publishResolver(size);\n    if (sizeChanged) {\n      this.canvas.width = size.backingWidth;\n      this.canvas.height = size.backingHeight;\n      this.needsResize = true;\n      this.needsRender = true;\n    }\n    if (initial) {\n      const resources = this.definition.create(this.context, props);\n      assertSynchronous(resources, \"create\");\n      this.resources = resources;\n      this.created = true;\n    } else {\n      try {\n        if (propsChanged && this.definition.update) {\n          assertSynchronous(\n            this.definition.update(this.resources!, props, this.context),\n            \"update\",\n          );\n        }\n        if (this.needsResize && this.definition.resize) {\n          assertSynchronous(\n            this.definition.resize(this.resources!, size, this.context),\n            \"resize\",\n          );\n          this.needsResize = false;\n        }\n      } catch (error) {\n        if (isSynchronousViolation(error)) throw error;\n        this.failCandidate(ctx, size, error);\n        return;\n      }\n    }\n    if (initial && this.needsResize && this.definition.resize) {\n      try {\n        assertSynchronous(\n          this.definition.resize(this.resources!, size, this.context),\n          \"resize\",\n        );\n        this.needsResize = false;\n      } catch (error) {\n        if (isSynchronousViolation(error)) throw error;\n        this.failCandidate(ctx, size, error);\n        return;\n      }\n    }\n    if (!this.definition.resize) this.needsResize = false;\n    this.props = snapshotProps(props);\n    if (initial || propsChanged || sizeChanged || this.needsRender) {\n      const frame = this.createFrame();\n      this.needsRender = false;\n      try {\n        assertSynchronous(\n          this.definition.render(this.resources!, frame, this.context),\n          \"render\",\n        );\n      } catch (error) {\n        if (isSynchronousViolation(error)) throw error;\n        this.failCandidate(ctx, size, error);\n        return;\n      }\n      let interaction: StagedInteraction<Target>;\n      try {\n        interaction = this.settleInteraction(props);\n      } catch (error) {\n        if (isSynchronousViolation(error)) throw error;\n        this.failCandidate(ctx, size, error);\n        return;\n      }\n      const stagedPolicy = snapshotPolicy(policy);\n      const candidate = this.canvas.transferToImageBitmap();\n      this.candidate?.bitmap.close();\n      const stagedCandidate = {\n        bitmap: candidate,\n        interaction,\n        policy: stagedPolicy,\n      };\n      this.candidate = stagedCandidate;\n      const transaction = GLOBAL_STATE.renderTransaction;\n      transaction?.onFinish((success) =>\n        this.finishCandidate(stagedCandidate, success),\n      );\n      if (!transaction) this.finishCandidate(stagedCandidate, true);\n      ctx.drawImage(\n        candidate,\n        0,\n        0,\n        size.backingWidth,\n        size.backingHeight,\n        0,\n        0,\n        size.width,\n        size.height,\n      );\n      return;\n    }\n    const transaction = GLOBAL_STATE.renderTransaction;\n    transaction?.onFinish((success) => {\n      if (success && !this.disposed) {\n        if (policyChanged && this.committedInteraction) {\n          this.commitInteraction(\n            {\n              snapshot: this.committedInteraction,\n              targets: this.committedTargetDescriptors,\n              transform: this.resolverTransform,\n              clippingStack: this.resolverEntry.clippingStack,\n            },\n            snapshotPolicy(policy),\n          );\n        }\n        this.refreshCommittedTargetGeometry();\n      }\n    });\n    if (!transaction && policyChanged && this.committedInteraction) {\n      this.commitInteraction(\n        {\n          snapshot: this.committedInteraction,\n          targets: this.committedTargetDescriptors,\n          transform: this.resolverTransform,\n          clippingStack: this.resolverEntry.clippingStack,\n        },\n        snapshotPolicy(policy),\n      );\n    }\n    this.drawCommitted(ctx, size);\n  }\n\n  private publishResolver(size: PibblRenderLayerSize): void {\n    if (!sameSize(this.resolverSize, size)) {\n      const bounds = new Path2D();\n      bounds.rect(0, 0, size.width, size.height);\n      this.resolverBounds = bounds;\n      this.resolverEntry.bounds = bounds;\n      this.resolverSize = size;\n    }\n    this.resolverTransform = getCurrentWorldTransform();\n    this.resolverInverseTransform = this.resolverTransform.inverse();\n    this.resolverEntry.transform = this.resolverTransform;\n    this.resolverEntry.clippingStack = Array.from(GLOBAL_STATE.clippingStack);\n    // Sets preserve insertion order, so refresh the retained entry at its\n    // current Canvas paint position on every traversal.\n    this.instance.paintEntries.delete(this.resolverEntry);\n    this.instance.paintEntries.add(this.resolverEntry);\n  }\n\n  private drawCommitted(\n    ctx: RenderingContext2D,\n    size: PibblRenderLayerSize,\n  ): void {\n    if (this.committed) {\n      ctx.drawImage(\n        this.committed,\n        0,\n        0,\n        size.backingWidth,\n        size.backingHeight,\n        0,\n        0,\n        size.width,\n        size.height,\n      );\n    }\n  }\n\n  private createFrame(): PibblRenderLayerFrame {\n    const snapshot = GLOBAL_STATE.frameSnapshot;\n    const time = snapshot?.logicalTime ?? this.instance.renderTimestamp;\n    const delta = this.lastTime === undefined ? 0 : time - this.lastTime;\n    this.lastTime = time;\n    return Object.freeze({\n      frameId: snapshot?.frameId ?? 0,\n      time,\n      delta,\n      deltaSeconds: delta / 1000,\n      invalidate: () => this.invalidate(false),\n    });\n  }\n\n  private invalidate(gateInput: boolean): void {\n    if (\n      this.disposed ||\n      this.refs.teardowns.closed ||\n      this.instance.mainTeardowns.closed\n    )\n      return;\n    this.needsRender = true;\n    if (gateInput) this.inputGated = true;\n    requestInstanceRender(this.instance);\n  }\n\n  private settleInteraction(props: Readonly<Props>): StagedInteraction<Target> {\n    const snapshot =\n      this.definition.interaction?.settle(this.resources!, props, this.size!) ??\n      (MISS_SNAPSHOT as PibblRenderLayerInteractionSnapshot<Target>);\n    assertSynchronous(snapshot, \"interaction.settle\");\n    const targets: PibblRenderLayerTarget<Target>[] = [];\n    const identities = new Set<Target>();\n    for (const target of snapshot.targets) {\n      if (identities.has(target.target)) {\n        throw new Error(\n          \"Render layer interaction contains a duplicate target identity.\",\n        );\n      }\n      identities.add(target.target);\n      targets.push(\n        Object.freeze({\n          ...target,\n          handlers: target.handlers\n            ? Object.freeze({ ...target.handlers })\n            : undefined,\n          keyboardNavigationBounds: target.keyboardNavigationBounds\n            ? Object.freeze({ ...target.keyboardNavigationBounds })\n            : undefined,\n        }),\n      );\n    }\n    return {\n      snapshot,\n      targets: Object.freeze(targets),\n      transform: this.resolverTransform,\n      clippingStack: this.resolverEntry.clippingStack,\n    };\n  }\n\n  private finishCandidate(\n    candidate: RenderCandidate<Target>,\n    success: boolean,\n  ): void {\n    if (this.candidate !== candidate) return;\n    this.candidate = undefined;\n    if (!success || this.disposed) {\n      candidate.bitmap.close();\n      return;\n    }\n    this.commitInteraction(candidate.interaction, candidate.policy);\n    this.committed?.close();\n    this.committed = candidate.bitmap;\n    this.resolutionErrorQueued = false;\n    this.inputGated = false;\n  }\n\n  /** Publishes one interaction snapshot only after its bitmap transaction wins. */\n  private commitInteraction(\n    interaction: StagedInteraction<Target>,\n    policy: RenderLayerPolicy,\n  ): void {\n    const retained = new Set<Target>();\n    for (const descriptor of policy.pointerEvents === \"none\"\n      ? []\n      : interaction.targets) {\n      if (descriptor.pointerEvents === \"none\") continue;\n      retained.add(descriptor.target);\n      let registration = this.committedTargets.get(descriptor.target);\n      if (!registration) {\n        registration = createTarget(\n          this.instance,\n          this.refs,\n          this.committedTargets.size + 1,\n        );\n        this.committedTargets.set(descriptor.target, registration);\n      }\n      updateTarget(\n        registration,\n        descriptor.handlers ?? {},\n        {\n          path: new Path2D(),\n          cursor: descriptor.cursor,\n          keyboardFocusable: descriptor.keyboardFocusable,\n          keyboardNavigationBounds: descriptor.keyboardNavigationBounds,\n        },\n        true,\n      );\n      this.applyResolverGeometry(registration, interaction);\n      this.observeTransactionalFocusTarget(registration);\n    }\n    for (const [identity, registration] of this.committedTargets) {\n      if (retained.has(identity)) continue;\n      releaseTarget(registration);\n      this.committedTargets.delete(identity);\n    }\n    if (\n      policy.pointerEvents !== \"none\" &&\n      policy.missBehavior === \"target-layer\"\n    ) {\n      updateTarget(\n        this.layerTarget,\n        { onClick: STRUCTURAL_CLICK_ELIGIBILITY },\n        {\n          path: new Path2D(),\n          keyboardFocusable: policy.keyboardFocusable,\n          keyboardNavigationBounds: policy.keyboardNavigationBounds,\n        },\n        true,\n      );\n      this.applyResolverGeometry(this.layerTarget, interaction);\n      this.observeTransactionalFocusTarget(this.layerTarget);\n    } else {\n      releaseTarget(this.layerTarget);\n    }\n    this.committedInteraction = interaction.snapshot;\n    this.committedTargetDescriptors = interaction.targets;\n    this.committedPolicy = policy;\n    this.updateInputNativeOwnership(Boolean(interaction.snapshot.onInput));\n  }\n\n  private applyResolverGeometry(\n    target: PibblEventTargetRegistration,\n    interaction: StagedInteraction<Target>,\n  ): void {\n    if (!target.paintEntry) return;\n    target.paintEntry.transform = interaction.transform;\n    target.paintEntry.clippingStack = interaction.clippingStack;\n    target.owner.paintEntries.delete(target.paintEntry);\n  }\n\n  private refreshCommittedTargetGeometry(): void {\n    const interaction = {\n      transform: this.resolverTransform,\n      clippingStack: this.resolverEntry.clippingStack,\n    } as StagedInteraction<Target>;\n    for (const target of this.committedTargets.values()) {\n      this.applyResolverGeometry(target, interaction);\n      this.instance.eventRoot.focusPolicy?.observeTarget(target);\n      this.observeTransactionalFocusTarget(target);\n    }\n    if (this.layerTarget.live) {\n      this.applyResolverGeometry(this.layerTarget, interaction);\n      this.instance.eventRoot.focusPolicy?.observeTarget(this.layerTarget);\n      this.observeTransactionalFocusTarget(this.layerTarget);\n    }\n  }\n\n  private observeTransactionalFocusTarget(\n    target: PibblEventTargetRegistration,\n  ): void {\n    this.instance.eventRoot.focusPolicy?.observeTransactionalTarget?.(target);\n  }\n\n  private resolveLocal(\n    localX: number,\n    localY: number,\n    output: PibblHitTestOutput,\n  ): void {\n    if (this.committedPolicy.pointerEvents === \"none\") {\n      output.disposition = PibblHitDisposition.Miss;\n      output.target = null;\n      return;\n    }\n    const state = this.resolveWinnerState(localX, localY);\n    output.winner = this.inputWinner;\n    output.winnerState = state;\n    switch (state.hit.kind) {\n      case \"miss\":\n        if (this.committedPolicy.missBehavior === \"pass-through\") {\n          output.disposition = PibblHitDisposition.Miss;\n          output.target = null;\n          delete output.winner;\n          delete output.winnerState;\n        } else if (this.committedPolicy.missBehavior === \"block\") {\n          output.disposition = PibblHitDisposition.Block;\n          output.target = null;\n        } else {\n          output.disposition = PibblHitDisposition.Target;\n          output.target = this.layerTarget.live ? this.layerTarget : null;\n        }\n        return;\n      case \"block\":\n        output.disposition = PibblHitDisposition.Block;\n        output.target = null;\n        return;\n      case \"target\": {\n        const target = this.committedTargets.get(state.hit.target);\n        if (!target?.live) {\n          output.disposition = PibblHitDisposition.Block;\n          output.target = null;\n          output.winnerState = {\n            point: state.point,\n            hit: Object.freeze({ kind: \"block\" as const }),\n          } satisfies WinnerState<Target>;\n          this.reportUnknownTarget();\n          return;\n        }\n        output.disposition = PibblHitDisposition.Target;\n        output.target = target;\n      }\n    }\n  }\n\n  private resolveWinnerState(\n    localX: number,\n    localY: number,\n  ): WinnerState<Target> {\n    const point = Object.freeze({ x: localX, y: localY });\n    if (this.inputGated || !this.committedInteraction) {\n      return { point, hit: Object.freeze({ kind: \"block\" }) };\n    }\n    const hit = this.committedInteraction.hitTest(point);\n    if (hit.kind === \"target\" && !this.committedTargets.has(hit.target)) {\n      this.reportUnknownTarget();\n      return { point, hit: Object.freeze({ kind: \"block\" }) };\n    }\n    return { point, hit };\n  }\n\n  private reportUnknownTarget(): void {\n    if (this.resolutionErrorQueued) return;\n    this.resolutionErrorQueued = true;\n    queueFrameCompletion(() => {\n      throw new Error(\n        \"Render layer hitTest() returned a target absent from its committed snapshot.\",\n      );\n    });\n  }\n\n  private deliverInput(\n    type: PibblResolverInputType,\n    rootPoint: Readonly<{ x: number; y: number }>,\n    originalEvent: PointerEvent | WheelEvent | MouseEvent,\n    resolvedState: unknown,\n  ): void {\n    const snapshot = this.committedInteraction;\n    if (!snapshot?.onInput || this.disposed) return;\n    let state = resolvedState as WinnerState<Target> | undefined;\n    if (!state) {\n      const local = this.resolverInverseTransform.transformPoint(\n        new DOMPoint(rootPoint.x, rootPoint.y),\n      );\n      state = this.resolveWinnerState(local.x, local.y);\n    }\n    snapshot.onInput(\n      Object.freeze({\n        type,\n        point: state.point,\n        hit: state.hit,\n        originalEvent,\n        setPointerCapture: (pointerId: number) =>\n          setResolverPointerCapture(this.inputWinner, pointerId),\n        releasePointerCapture: (pointerId: number) =>\n          releaseResolverPointerCapture(this.inputWinner, pointerId),\n      }),\n    );\n  }\n\n  private updateInputNativeOwnership(enabled: boolean): void {\n    const required = new Set<PibblResolverInputType>(\n      enabled\n        ? RESOLVER_INPUT_TYPES\n        : hasResolverPointerCapture(this.inputWinner)\n          ? RESOLVER_CAPTURE_INPUT_TYPES\n          : [],\n    );\n    for (const [type, release] of this.inputNativeReleases) {\n      if (required.has(type)) continue;\n      release();\n      this.inputNativeReleases.delete(type);\n    }\n    const hub = this.instance.eventRoot.nativeListeners;\n    if (!hub) return;\n    for (const type of required) {\n      if (!this.inputNativeReleases.has(type)) {\n        this.inputNativeReleases.set(type, hub.acquire(type));\n      }\n    }\n  }\n\n  private failCandidate(\n    ctx: RenderingContext2D,\n    size: PibblRenderLayerSize,\n    error: unknown,\n  ): void {\n    this.inputGated = true;\n    this.drawCommitted(ctx, size);\n    queueFrameCompletion(() => {\n      throw error;\n    });\n  }\n\n  private dispose(): void {\n    if (this.disposed) return;\n    this.disposed = true;\n    try {\n      if (this.created && this.definition.dispose) {\n        assertSynchronous(\n          this.definition.dispose(this.resources!, this.context),\n          \"dispose\",\n        );\n      }\n    } finally {\n      this.canvas.width = this.canvas.height = 0;\n      this.candidate?.bitmap.close();\n      this.committed?.close();\n      for (const target of this.committedTargets.values())\n        releaseTarget(target);\n      this.committedTargets.clear();\n      releaseTarget(this.layerTarget);\n      releaseResolverInputWinner(this.inputWinner);\n      this.updateInputNativeOwnership(false);\n      this.candidate = undefined;\n      this.committed = undefined;\n      this.committedInteraction = undefined;\n    }\n  }\n}\n\nfunction assertCapability(): void {\n  if (\n    typeof OffscreenCanvas !== \"function\" ||\n    typeof OffscreenCanvas.prototype.transferToImageBitmap !== \"function\"\n  ) {\n    throw new Error(\n      \"defineRenderLayer requires OffscreenCanvas with transferToImageBitmap().\",\n    );\n  }\n}\n\nfunction sameSize(\n  a: PibblRenderLayerSize | undefined,\n  b: PibblRenderLayerSize,\n): boolean {\n  return (\n    !!a &&\n    a.width === b.width &&\n    a.height === b.height &&\n    a.backingWidth === b.backingWidth &&\n    a.backingHeight === b.backingHeight\n  );\n}\n\nfunction isSynchronousViolation(error: unknown): boolean {\n  return error instanceof SynchronousLifecycleError;\n}\n\nfunction snapshotProps<Props>(props: Readonly<Props>): Readonly<Props> {\n  return Object.freeze({ ...props });\n}\n\nfunction sameProps<Props>(\n  a: Readonly<Props> | undefined,\n  b: Readonly<Props>,\n): boolean {\n  if (!a) return false;\n  const aKeys = Reflect.ownKeys(a);\n  const bKeys = Reflect.ownKeys(b as object);\n  return (\n    aKeys.length === bKeys.length &&\n    aKeys.every(\n      (key) =>\n        Object.prototype.hasOwnProperty.call(b, key) &&\n        Object.is(a[key as keyof Props], b[key as keyof Props]),\n    )\n  );\n}\n\nfunction snapshotPolicy(policy: RenderLayerPolicy): RenderLayerPolicy {\n  return Object.freeze({\n    missBehavior: policy.missBehavior,\n    pointerEvents: policy.pointerEvents,\n    keyboardFocusable: policy.keyboardFocusable,\n    keyboardNavigationBounds: policy.keyboardNavigationBounds\n      ? Object.freeze({\n          ...policy.keyboardNavigationBounds,\n        })\n      : undefined,\n  });\n}\n\nfunction samePolicy(a: RenderLayerPolicy, b: RenderLayerPolicy): boolean {\n  return (\n    a.missBehavior === b.missBehavior &&\n    a.pointerEvents === b.pointerEvents &&\n    a.keyboardFocusable === b.keyboardFocusable &&\n    a.keyboardNavigationBounds?.x === b.keyboardNavigationBounds?.x &&\n    a.keyboardNavigationBounds?.y === b.keyboardNavigationBounds?.y &&\n    a.keyboardNavigationBounds?.width === b.keyboardNavigationBounds?.width &&\n    a.keyboardNavigationBounds?.height === b.keyboardNavigationBounds?.height\n  );\n}\n"],
+  "mappings": "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",
+  "names": ["transaction"]
+}

package/dist/lib/render-layer/define-render-layer.d.ts

@@ -0,0 +1,17 @@
+import type { PibblComponent } from "../types.js";
+import type { PibblRenderLayerDefinition, PibblRenderLayerProps } from "./types.js";
+/**
+ * Defines a Pibbl component backed by a persistent external-renderer surface and resource lifetime.
+ * Pibbl schedules frames and commits the bitmap and interaction snapshot together; the definition
+ * owns application-resource cleanup.
+ *
+ * @param definition - Synchronous resource lifecycle, rendering, and interaction implementation.
+ * See {@link PibblRenderLayerDefinition} .
+ * @returns A Pibbl component that owns one external-renderer boundary per mounted identity. See
+ * {@link PibblComponent} , {@link PibblRenderLayerProps} .
+ *
+ * @see {@link PibblRenderLayerDefinition}
+ * @see {@link PibblComponent}
+ * @see {@link PibblRenderLayerProps}
+ */
+export declare function defineRenderLayer<Props, Resources, Target extends object = object>(definition: PibblRenderLayerDefinition<Props, Resources, Target>): PibblComponent<PibblRenderLayerProps<Props>>;

package/dist/lib/render-layer/define-render-layer.js

@@ -0,0 +1,90 @@
+import { definePrimitive } from "../define-primitive.js";
+import { GLOBAL_STATE } from "../global-state.js";
+import { createLayerSurface } from "../surface/resolve-surface.js";
+import {
+  resolveRequiredLength,
+  stripLayoutParticipation
+} from "../style/resolve-built-in.js";
+import { PIBBL_EVENT_DEFINITIONS } from "../events/event-definitions.js";
+import { wireStructuralEvents } from "../components/structural-events.js";
+import { RenderLayerController } from "./controller.js";
+function defineRenderLayer(definition) {
+  const immutableDefinition = snapshotDefinition(definition);
+  const primitive = definePrimitive(
+    function renderDefinedRenderLayer(props, style, ctx) {
+      wireStructuralEvents(props);
+      const refs = GLOBAL_STATE.componentRefs;
+      let controller = refs.refs[0];
+      if (!controller) {
+        controller = new RenderLayerController(immutableDefinition, refs);
+        refs.refs[0] = controller;
+      }
+      const surface = GLOBAL_STATE.currentPibblInstance.surface.snapshot;
+      const layerSurface = createLayerSurface(
+        style.width,
+        style.height,
+        surface.backingPixelsPerLogicalUnitX,
+        surface.backingPixelsPerLogicalUnitY
+      );
+      const size = Object.freeze({
+        width: style.width,
+        height: style.height,
+        backingWidth: layerSurface.backingWidth,
+        backingHeight: layerSurface.backingHeight,
+        pixelRatioX: layerSurface.backingPixelsPerLogicalUnitX,
+        pixelRatioY: layerSurface.backingPixelsPerLogicalUnitY
+      });
+      controller.render(customProps(props), size, ctx, {
+        missBehavior: props.missBehavior ?? "pass-through",
+        pointerEvents: props.pointerEvents,
+        keyboardFocusable: props.keyboardFocusable,
+        keyboardNavigationBounds: props.keyboardNavigationBounds
+      });
+    },
+    { resolveStyle }
+  );
+  return primitive;
+}
+const resolveStyle = (style, context) => ({
+  ...stripLayoutParticipation(style),
+  width: resolveRequiredLength(
+    style.width ?? context.allocation.width,
+    context.percentageBasis.width,
+    "width",
+    context
+  ),
+  height: resolveRequiredLength(
+    style.height ?? context.allocation.height,
+    context.percentageBasis.height,
+    "height",
+    context
+  )
+});
+function customProps(props) {
+  const custom = { ...props };
+  delete custom.missBehavior;
+  delete custom.pointerEvents;
+  delete custom.keyboardFocusable;
+  delete custom.keyboardNavigationBounds;
+  for (const definition of PIBBL_EVENT_DEFINITIONS) {
+    delete custom[definition.prop];
+    delete custom[definition.captureProp];
+  }
+  return custom;
+}
+function snapshotDefinition(definition) {
+  return Object.freeze({
+    create: definition.create,
+    update: definition.update,
+    resize: definition.resize,
+    render: definition.render,
+    dispose: definition.dispose,
+    interaction: definition.interaction ? Object.freeze({
+      settle: definition.interaction.settle
+    }) : void 0
+  });
+}
+export {
+  defineRenderLayer
+};
+//# sourceMappingURL=define-render-layer.js.map

package/dist/lib/render-layer/define-render-layer.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/lib/render-layer/define-render-layer.ts"],
+  "sourcesContent": ["import { definePrimitive } from \"../define-primitive.js\";\nimport { GLOBAL_STATE } from \"../global-state.js\";\nimport { createLayerSurface } from \"../surface/resolve-surface.js\";\nimport {\n  resolveRequiredLength,\n  stripLayoutParticipation,\n} from \"../style/resolve-built-in.js\";\nimport type {\n  PibblComponent,\n  PrimitiveCapabilities,\n  RenderingContext2D,\n} from \"../types.js\";\nimport { PIBBL_EVENT_DEFINITIONS } from \"../events/event-definitions.js\";\nimport { wireStructuralEvents } from \"../components/structural-events.js\";\nimport { RenderLayerController } from \"./controller.js\";\nimport type {\n  PibblRenderLayerDefinition,\n  PibblRenderLayerProps,\n  PibblRenderLayerSize,\n  PibblRenderLayerStyle,\n} from \"./types.js\";\n\ntype ResolvedRenderLayerStyle = PibblRenderLayerStyle & {\n  readonly width: number;\n  readonly height: number;\n};\n\n/**\n * Defines a Pibbl component backed by a persistent external-renderer surface and resource lifetime.\n * Pibbl schedules frames and commits the bitmap and interaction snapshot together; the definition\n * owns application-resource cleanup.\n *\n * @param definition - Synchronous resource lifecycle, rendering, and interaction implementation.\n * See {@link PibblRenderLayerDefinition} .\n * @returns A Pibbl component that owns one external-renderer boundary per mounted identity. See\n * {@link PibblComponent} , {@link PibblRenderLayerProps} .\n *\n * @see {@link PibblRenderLayerDefinition}\n * @see {@link PibblComponent}\n * @see {@link PibblRenderLayerProps}\n */\nexport function defineRenderLayer<\n  Props,\n  Resources,\n  Target extends object = object,\n>(\n  definition: PibblRenderLayerDefinition<Props, Resources, Target>,\n): PibblComponent<PibblRenderLayerProps<Props>> {\n  const immutableDefinition = snapshotDefinition(definition);\n  const primitive = (definePrimitive as any)(\n    function renderDefinedRenderLayer(\n      props: Readonly<PibblRenderLayerProps<Props>>,\n      style: Readonly<ResolvedRenderLayerStyle>,\n      ctx: RenderingContext2D,\n    ) {\n      wireStructuralEvents(props);\n      const refs = GLOBAL_STATE.componentRefs!;\n      let controller = refs.refs[0] as\n        RenderLayerController<Props, Resources, Target> | undefined;\n      if (!controller) {\n        controller = new RenderLayerController(immutableDefinition, refs);\n        refs.refs[0] = controller;\n      }\n      const surface = GLOBAL_STATE.currentPibblInstance!.surface.snapshot!;\n      const layerSurface = createLayerSurface(\n        style.width,\n        style.height,\n        surface.backingPixelsPerLogicalUnitX,\n        surface.backingPixelsPerLogicalUnitY,\n      );\n      const size: PibblRenderLayerSize = Object.freeze({\n        width: style.width,\n        height: style.height,\n        backingWidth: layerSurface.backingWidth,\n        backingHeight: layerSurface.backingHeight,\n        pixelRatioX: layerSurface.backingPixelsPerLogicalUnitX,\n        pixelRatioY: layerSurface.backingPixelsPerLogicalUnitY,\n      });\n      controller.render(customProps(props) as Props, size, ctx, {\n        missBehavior: props.missBehavior ?? \"pass-through\",\n        pointerEvents: props.pointerEvents,\n        keyboardFocusable: props.keyboardFocusable,\n        keyboardNavigationBounds: props.keyboardNavigationBounds,\n      });\n    },\n    { resolveStyle },\n  );\n  return primitive as PibblComponent<PibblRenderLayerProps<Props>>;\n}\n\nconst resolveStyle: NonNullable<\n  PrimitiveCapabilities<\n    PibblRenderLayerProps<any>,\n    PibblRenderLayerStyle,\n    PibblRenderLayerStyle,\n    ResolvedRenderLayerStyle\n  >[\"resolveStyle\"]\n> = (style, context) =>\n  ({\n    ...stripLayoutParticipation(style),\n    width: resolveRequiredLength(\n      style.width ?? context.allocation.width,\n      context.percentageBasis.width,\n      \"width\",\n      context,\n    ),\n    height: resolveRequiredLength(\n      style.height ?? context.allocation.height,\n      context.percentageBasis.height,\n      \"height\",\n      context,\n    ),\n  }) as ResolvedRenderLayerStyle;\n\nfunction customProps<Props>(\n  props: Readonly<PibblRenderLayerProps<Props>>,\n): Props {\n  const custom = { ...props } as Record<PropertyKey, unknown>;\n  delete custom.missBehavior;\n  delete custom.pointerEvents;\n  delete custom.keyboardFocusable;\n  delete custom.keyboardNavigationBounds;\n  for (const definition of PIBBL_EVENT_DEFINITIONS) {\n    delete custom[definition.prop];\n    delete custom[definition.captureProp];\n  }\n  return custom as Props;\n}\n\nfunction snapshotDefinition<Props, Resources, Target extends object>(\n  definition: PibblRenderLayerDefinition<Props, Resources, Target>,\n): PibblRenderLayerDefinition<Props, Resources, Target> {\n  return Object.freeze({\n    create: definition.create,\n    update: definition.update,\n    resize: definition.resize,\n    render: definition.render,\n    dispose: definition.dispose,\n    interaction: definition.interaction\n      ? Object.freeze({\n          settle: definition.interaction.settle,\n        })\n      : undefined,\n  });\n}\n"],
+  "mappings": "AAAA,SAAS,uBAAuB;AAChC,SAAS,oBAAoB;AAC7B,SAAS,0BAA0B;AACnC;AAAA,EACE;AAAA,EACA;AAAA,OACK;AAMP,SAAS,+BAA+B;AACxC,SAAS,4BAA4B;AACrC,SAAS,6BAA6B;AA2B/B,SAAS,kBAKd,YAC8C;AAC9C,QAAM,sBAAsB,mBAAmB,UAAU;AACzD,QAAM,YAAa;AAAA,IACjB,SAAS,yBACP,OACA,OACA,KACA;AACA,2BAAqB,KAAK;AAC1B,YAAM,OAAO,aAAa;AAC1B,UAAI,aAAa,KAAK,KAAK,CAAC;AAE5B,UAAI,CAAC,YAAY;AACf,qBAAa,IAAI,sBAAsB,qBAAqB,IAAI;AAChE,aAAK,KAAK,CAAC,IAAI;AAAA,MACjB;AACA,YAAM,UAAU,aAAa,qBAAsB,QAAQ;AAC3D,YAAM,eAAe;AAAA,QACnB,MAAM;AAAA,QACN,MAAM;AAAA,QACN,QAAQ;AAAA,QACR,QAAQ;AAAA,MACV;AACA,YAAM,OAA6B,OAAO,OAAO;AAAA,QAC/C,OAAO,MAAM;AAAA,QACb,QAAQ,MAAM;AAAA,QACd,cAAc,aAAa;AAAA,QAC3B,eAAe,aAAa;AAAA,QAC5B,aAAa,aAAa;AAAA,QAC1B,aAAa,aAAa;AAAA,MAC5B,CAAC;AACD,iBAAW,OAAO,YAAY,KAAK,GAAY,MAAM,KAAK;AAAA,QACxD,cAAc,MAAM,gBAAgB;AAAA,QACpC,eAAe,MAAM;AAAA,QACrB,mBAAmB,MAAM;AAAA,QACzB,0BAA0B,MAAM;AAAA,MAClC,CAAC;AAAA,IACH;AAAA,IACA,EAAE,aAAa;AAAA,EACjB;AACA,SAAO;AACT;AAEA,MAAM,eAOF,CAAC,OAAO,aACT;AAAA,EACC,GAAG,yBAAyB,KAAK;AAAA,EACjC,OAAO;AAAA,IACL,MAAM,SAAS,QAAQ,WAAW;AAAA,IAClC,QAAQ,gBAAgB;AAAA,IACxB;AAAA,IACA;AAAA,EACF;AAAA,EACA,QAAQ;AAAA,IACN,MAAM,UAAU,QAAQ,WAAW;AAAA,IACnC,QAAQ,gBAAgB;AAAA,IACxB;AAAA,IACA;AAAA,EACF;AACF;AAEF,SAAS,YACP,OACO;AACP,QAAM,SAAS,EAAE,GAAG,MAAM;AAC1B,SAAO,OAAO;AACd,SAAO,OAAO;AACd,SAAO,OAAO;AACd,SAAO,OAAO;AACd,aAAW,cAAc,yBAAyB;AAChD,WAAO,OAAO,WAAW,IAAI;AAC7B,WAAO,OAAO,WAAW,WAAW;AAAA,EACtC;AACA,SAAO;AACT;AAEA,SAAS,mBACP,YACsD;AACtD,SAAO,OAAO,OAAO;AAAA,IACnB,QAAQ,WAAW;AAAA,IACnB,QAAQ,WAAW;AAAA,IACnB,QAAQ,WAAW;AAAA,IACnB,QAAQ,WAAW;AAAA,IACnB,SAAS,WAAW;AAAA,IACpB,aAAa,WAAW,cACpB,OAAO,OAAO;AAAA,MACZ,QAAQ,WAAW,YAAY;AAAA,IACjC,CAAC,IACD;AAAA,EACN,CAAC;AACH;",
+  "names": []
+}

package/dist/lib/render-layer/types.d.ts

@@ -0,0 +1,315 @@
+import type { defineRenderLayer } from "./define-render-layer.js";
+import type { PibblComponent } from "../element/types.js";
+import type { LayoutBox } from "../layout/types.js";
+import type { PibblEventFocusOptions, PibblEventHandlers, PibblEventParticipationOptions, PibblPointerEvents } from "../events/types.js";
+import type { BoxStyle, LayoutItemStyle } from "../style/types.js";
+import type { SystemStyle } from "../types.js";
+/**
+ * Logical surface size, backing-store dimensions, and effective pixel ratios of an external render
+ * layer.
+ *
+ * @see {@link PibblRenderLayerDefinition}
+ * @see {@link PibblRenderLayerContext}
+ * @see {@link PibblRenderLayerInteraction}
+ */
+export interface PibblRenderLayerSize {
+    /**
+     * Horizontal extent in the units of the containing geometry or surface. See
+     * {@link PibblRenderLayerSize}.
+     */
+    readonly width: number;
+    /**
+     * Vertical extent in the units of the containing geometry or surface. See
+     * {@link PibblRenderLayerSize}.
+     */
+    readonly height: number;
+    /** Width of the backing raster in physical pixels. See {@link PibblRenderLayerSize}. */
+    readonly backingWidth: number;
+    /** Height of the backing raster in physical pixels. See {@link PibblRenderLayerSize}. */
+    readonly backingHeight: number;
+    /**
+     * Effective ratio of backing pixels to logical units on the x axis. See
+     * {@link PibblRenderLayerSize}.
+     */
+    readonly pixelRatioX: number;
+    /**
+     * Effective ratio of backing pixels to logical units on the y axis. See
+     * {@link PibblRenderLayerSize}.
+     */
+    readonly pixelRatioY: number;
+}
+/**
+ * Shared scheduler timing and invalidation supplied to an external renderer for one frame.
+ *
+ * @see {@link PibblRenderLayerDefinition}
+ */
+export interface PibblRenderLayerFrame {
+    /** Identifier of the shared scheduler frame. See {@link PibblRenderLayerFrame}. */
+    readonly frameId: number;
+    /** Current shared logical time in milliseconds. See {@link PibblRenderLayerFrame}. */
+    readonly time: number;
+    /** Elapsed frame time in milliseconds. See {@link PibblRenderLayerFrame}. */
+    readonly delta: number;
+    /** Elapsed frame time in seconds. See {@link PibblRenderLayerFrame}. */
+    readonly deltaSeconds: number;
+    /** Requests another Pibbl render through the shared scheduler. See {@link PibblRenderLayerFrame}. */
+    invalidate(): void;
+}
+/**
+ * The Pibbl-owned offscreen canvas, current size, and frame-invalidation capability.
+ *
+ * @see {@link PibblRenderLayerSize}
+ * @see {@link PibblRenderLayerDefinition}
+ */
+export interface PibblRenderLayerContext {
+    /** Canvas surface associated with this resource or mount. See {@link PibblRenderLayerContext}. */
+    readonly canvas: OffscreenCanvas;
+    /** Current logical dimensions, backing-store dimensions, and effective pixel ratios. See {@link PibblRenderLayerSize}. */
+    readonly size: PibblRenderLayerSize;
+    /**
+     * Requests another Pibbl render through the shared scheduler. See {@link PibblRenderLayerContext}.
+     */
+    invalidate(): void;
+}
+/**
+ * Layout and outer Canvas composition style for an external render layer.
+ *
+ * @see {@link SystemStyle}
+ * @see {@link BoxStyle}
+ * @see {@link LayoutItemStyle}
+ * @see {@link PibblRenderLayerComponentProps}
+ */
+export interface PibblRenderLayerStyle extends SystemStyle, BoxStyle, LayoutItemStyle {
+}
+/**
+ * A hit-test decision: pass through, block lower paint, or select one logical target.
+ *
+ * @see {@link PibblRenderLayerInput}
+ * @see {@link PibblRenderLayerInteractionSnapshot}
+ */
+export type PibblRenderLayerHit<Target extends object> = {
+    /** Selects the kind of geometry, material, or result. See {@link PibblRenderLayerHit}. */
+    readonly kind: "miss";
+} | {
+    /** Selects the kind of geometry, material, or result. See {@link PibblRenderLayerHit}. */
+    readonly kind: "block";
+} | {
+    /** Selects the kind of geometry, material, or result. See {@link PibblRenderLayerHit}. */
+    readonly kind: "target";
+    /** The selected logical target or target configuration. See {@link PibblRenderLayerHit}. */
+    readonly target: Target;
+};
+/**
+ * Stable target identity with event, cursor, and keyboard-focus metadata.
+ *
+ * @see {@link PibblEventHandlers}
+ * @see {@link PibblPointerEvents}
+ * @see {@link LayoutBox}
+ * @see {@link PibblRenderLayerInteractionSnapshot}
+ */
+export interface PibblRenderLayerTarget<Target extends object> {
+    /** The selected logical target or target configuration. See {@link PibblRenderLayerTarget}. */
+    readonly target: Target;
+    /** Event handlers dispatched for this logical target. See {@link PibblEventHandlers}. */
+    readonly handlers?: PibblEventHandlers;
+    /** Whether this content participates in pointer targeting. See {@link PibblPointerEvents}. */
+    readonly pointerEvents?: PibblPointerEvents;
+    /** Cursor shown while this target owns pointer presentation. See {@link PibblRenderLayerTarget}. */
+    readonly cursor?: string;
+    /** Whether the target may receive keyboard focus. See {@link PibblRenderLayerTarget}. */
+    readonly keyboardFocusable?: boolean;
+    /** Logical rectangle used for directional keyboard navigation. See {@link LayoutBox}. */
+    readonly keyboardNavigationBounds?: Readonly<LayoutBox>;
+}
+/**
+ * Pibbl-routed pointer input in layer-local coordinates with pointer-capture operations.
+ *
+ * @see {@link PibblRenderLayerHit}
+ * @see {@link PibblRenderLayerInteractionSnapshot}
+ */
+export interface PibblRenderLayerInput<Target extends object> {
+    /**
+     * Selects `"pointerdown"` , `"pointermove"` , `"pointerup"` , `"pointercancel"` , `"wheel"` ,
+     * `"contextmenu"` , `"click"` for type. See {@link PibblRenderLayerInput}.
+     */
+    readonly type: "pointerdown" | "pointermove" | "pointerup" | "pointercancel" | "wheel" | "contextmenu" | "click";
+    /**
+     * Pointer position in the external layer's logical local coordinates. See
+     * {@link PibblRenderLayerInput}.
+     */
+    readonly point: Readonly<{
+        /**
+         * Horizontal coordinate or displacement in the containing coordinate system. See
+         * {@link PibblRenderLayerInput}.
+         */
+        x: number;
+        /**
+         * Vertical coordinate or displacement in the containing coordinate system. See
+         * {@link PibblRenderLayerInput}.
+         */
+        y: number;
+    }>;
+    /** Target, block, or miss decision associated with the input. See {@link PibblRenderLayerHit}. */
+    readonly hit: PibblRenderLayerHit<Target>;
+    /** The originating browser event. See {@link PibblRenderLayerInput}. */
+    readonly originalEvent: PointerEvent | WheelEvent | MouseEvent;
+    /**
+     * Captures the pointer for this logical target until release or cancellation. See
+     * {@link PibblRenderLayerInput}.
+     * @param pointerId - Pointer identifier from the routed pointer event.
+     */
+    setPointerCapture(pointerId: number): void;
+    /**
+     * Releases this target's capture of the identified pointer. See {@link PibblRenderLayerInput}.
+     * @param pointerId - Pointer identifier from the routed pointer event.
+     */
+    releasePointerCapture(pointerId: number): void;
+}
+/**
+ * Targets and hit testing committed atomically with one rendered bitmap generation.
+ *
+ * @see {@link PibblRenderLayerTarget}
+ * @see {@link PibblRenderLayerHit}
+ * @see {@link PibblRenderLayerInput}
+ * @see {@link PibblRenderLayerInteraction}
+ */
+export interface PibblRenderLayerInteractionSnapshot<Target extends object> {
+    /** Logical targets exposed by this committed generation. See {@link PibblRenderLayerTarget}. */
+    readonly targets: Iterable<PibblRenderLayerTarget<Target>>;
+    /**
+     * Resolves a layer-local point to a target, block, or miss decision. See
+     * {@link PibblRenderLayerHit}.
+     * @param point - Pointer position in layer-local logical coordinates.
+     * @returns A target hit, a blocking hit, or a miss for this interaction generation. See
+     * {@link PibblRenderLayerHit} .
+     */
+    hitTest(point: Readonly<{
+        /**
+         * Horizontal coordinate or displacement in the containing coordinate system. See
+         * {@link PibblRenderLayerInteractionSnapshot}.
+         */
+        x: number;
+        /**
+         * Vertical coordinate or displacement in the containing coordinate system. See
+         * {@link PibblRenderLayerInteractionSnapshot}.
+         */
+        y: number;
+    }>): PibblRenderLayerHit<Target>;
+    /**
+     * Receives Pibbl-routed input for this committed interaction generation. See
+     * {@link PibblRenderLayerInteractionSnapshot}.
+     * @param input - Pibbl-routed input for the committed interaction generation. See
+     * {@link PibblRenderLayerInput} .
+     */
+    onInput?(input: Readonly<PibblRenderLayerInput<Target>>): void;
+}
+/**
+ * Settles renderer resources into the interaction snapshot for a committed generation.
+ *
+ * @see {@link PibblRenderLayerSize}
+ * @see {@link PibblRenderLayerInteractionSnapshot}
+ * @see {@link PibblRenderLayerDefinition}
+ */
+export interface PibblRenderLayerInteraction<Props, Resources, Target extends object> {
+    /**
+     * Captures interaction state corresponding to the generation being committed. See
+     * {@link PibblRenderLayerInteractionSnapshot}.
+     * @param resources - Resources representing the rendered scene.
+     * @param props - Props used for the committed render.
+     * @param size - Logical and backing dimensions for this generation. See
+     * {@link PibblRenderLayerSize} .
+     * @returns The interaction snapshot to commit together with the rendered bitmap. See
+     * {@link PibblRenderLayerInteractionSnapshot} .
+     */
+    settle(resources: Resources, props: Readonly<Props>, size: Readonly<PibblRenderLayerSize>): PibblRenderLayerInteractionSnapshot<Target>;
+}
+/**
+ * Pibbl-owned style, event, focus, and miss-handling props shared by external layers.
+ *
+ * @see {@link PibblEventHandlers}
+ * @see {@link PibblEventParticipationOptions}
+ * @see {@link PibblRenderLayerStyle}
+ * @see {@link PibblRenderLayerProps}
+ */
+export interface PibblRenderLayerComponentProps extends PibblEventHandlers, PibblEventFocusOptions, PibblEventParticipationOptions {
+    /** Declared presentation and layout properties. See {@link PibblRenderLayerStyle}. */
+    readonly style?: PibblRenderLayerStyle;
+    /**
+     * How a layer miss participates in arbitration with lower painted content. See
+     * {@link PibblRenderLayerComponentProps}.
+     */
+    readonly missBehavior?: "pass-through" | "block" | "target-layer";
+}
+/**
+ * Resource creation, update, resizing, rendering, disposal, and interaction lifecycle of an
+ * external layer.
+ *
+ * @see {@link PibblRenderLayerContext}
+ * @see {@link PibblRenderLayerSize}
+ * @see {@link PibblRenderLayerFrame}
+ * @see {@link PibblRenderLayerInteraction}
+ * @see {@link defineRenderLayer}
+ */
+export interface PibblRenderLayerDefinition<Props, Resources, Target extends object = object> {
+    /**
+     * Allocates application resources once for this mounted layer identity. See
+     * {@link PibblRenderLayerDefinition}.
+     * @param context - Mount-owned canvas, size, and invalidation services. See
+     * {@link PibblRenderLayerContext} .
+     * @param initialProps - Props supplied for the first mounted render.
+     * @returns Persistent application resources retained until dispose.
+     */
+    create(context: Readonly<PibblRenderLayerContext>, initialProps: Readonly<Props>): Resources;
+    /**
+     * Applies the latest props to existing resources before rendering. See
+     * {@link PibblRenderLayerDefinition}.
+     * @param resources - Resources previously returned by create.
+     * @param props - Latest component props.
+     * @param context - Mount-owned canvas, size, and invalidation services. See
+     * {@link PibblRenderLayerContext} .
+     */
+    update?(resources: Resources, props: Readonly<Props>, context: Readonly<PibblRenderLayerContext>): void;
+    /**
+     * Adjusts resources to the newly resolved logical and backing-store dimensions. See
+     * {@link PibblRenderLayerDefinition}.
+     * @param resources - Resources previously returned by create.
+     * @param size - New logical and backing dimensions. See {@link PibblRenderLayerSize}.
+     * @param context - Mount-owned canvas, size, and invalidation services. See
+     * {@link PibblRenderLayerContext} .
+     */
+    resize?(resources: Resources, size: Readonly<PibblRenderLayerSize>, context: Readonly<PibblRenderLayerContext>): void;
+    /**
+     * Draws this generation using Pibbl's frame; invalidate only when another frame is needed. See
+     * {@link PibblRenderLayerDefinition}.
+     * @param resources - Resources previously returned by create.
+     * @param frame - Shared Pibbl frame timing and invalidation service. See
+     * {@link PibblRenderLayerFrame} .
+     * @param context - Mount-owned canvas, size, and invalidation services. See
+     * {@link PibblRenderLayerContext} .
+     */
+    render(resources: Resources, frame: Readonly<PibblRenderLayerFrame>, context: Readonly<PibblRenderLayerContext>): void;
+    /**
+     * Releases application resources when the mounted layer is torn down. See
+     * {@link PibblRenderLayerDefinition}.
+     * @param resources - Resources previously returned by create, whose application-owned resources
+     * must be released.
+     * @param context - Mount-owned context for this resource lifetime. See
+     * {@link PibblRenderLayerContext} .
+     */
+    dispose?(resources: Resources, context: Readonly<PibblRenderLayerContext>): void;
+    /**
+     * Builds the interaction snapshot committed with the rendered bitmap. See
+     * {@link PibblRenderLayerInteraction}.
+     */
+    interaction?: PibblRenderLayerInteraction<Props, Resources, Target>;
+}
+type PibblRenderLayerReservedProp = "key" | "style" | "missBehavior" | keyof PibblEventHandlers | keyof PibblEventFocusOptions | keyof PibblEventParticipationOptions;
+/**
+ * Application props combined with layer props; reserved Pibbl prop collisions are rejected.
+ *
+ * @see {@link PibblRenderLayerComponentProps}
+ * @see {@link defineRenderLayer}
+ */
+export type PibblRenderLayerProps<Props> = Extract<keyof Props, PibblRenderLayerReservedProp> extends never ? Props & PibblRenderLayerComponentProps : never;
+export type PibblRenderLayerComponent<Props> = PibblComponent<PibblRenderLayerProps<Props>>;
+export {};

package/dist/lib/render-target.d.ts

@@ -0,0 +1,27 @@
+import type { LayoutBox } from './layout/types.js';
+import type { PibblSurfaceSnapshot } from './surface/types.js';
+import type { RenderingContext2D } from './types.js';
+export interface RenderTargetSnapshot {
+    readonly logicalBounds: Readonly<LayoutBox>;
+    readonly backingWidth: number;
+    readonly backingHeight: number;
+    readonly renderTransform: DOMMatrix;
+    readonly inverseRenderTransform: DOMMatrix;
+}
+export declare function rootRenderTarget(surface: PibblSurfaceSnapshot): RenderTargetSnapshot;
+export declare function getCurrentPaintTransform(): DOMMatrix;
+/**
+ * Returns the current logical world transform, optionally incorporating a supplied paint
+ * transform.
+ *
+ * @param paintTransform - Optional paint transform to include in the world transform.
+ * @returns The transform mapping local geometry into world coordinates.
+ *
+ * @see {@link LayoutBox}
+ */
+export declare function getCurrentWorldTransform(paintTransform?: DOMMatrix): DOMMatrix;
+/** Whether direct Canvas calls changed paint since the last Pibbl-owned anchor. */
+export declare function hasCurrentWorldTransformCanvasDelta(paintTransform?: DOMMatrix): boolean;
+export declare function setCurrentWorldTransformAnchor(exactWorld: DOMMatrix): void;
+export declare function initializeCurrentWorldTransformAnchor(worldBase: DOMMatrix): void;
+export declare function withRenderTarget<T>(context: RenderingContext2D, target: RenderTargetSnapshot, worldBase: DOMMatrix, work: () => T): T;