@pibbl/core 0.0.1 → 0.0.3-alpha.85.1

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

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

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

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

package/dist/lib/events/propagation.js

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

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

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

package/dist/lib/execute-render.js

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

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

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../src/lib/execute-render.ts"],
-  "sourcesContent": ["import { RootRenderTransaction } from './render-transaction.js';\nimport {\n  clearTempState,\n  GLOBAL_STATE,\n  NO_PENDING_ROOT,\n} from './global-state.js';\nimport { render } from './render.js';\nimport { initializeCurrentWorldTransformAnchor } from './render-target.js';\nimport {\n  Canvas,\n  type PibblNode,\n} from './types.js';\nimport type {\n  PibblBackendFrame,\n} from './backend/types.js';\nimport type { PibblFrameSnapshot } from './scheduler/types.js';\nimport { withSignalWriteForbidden } from './signals/graph.js';\n\n/**\n * Gets the root element for a canvas and renders it. This is the\n * entry point for rendering the entire tree.\n * @param canvas The canvas to render on\n */\nexport function executeRender(\n  canvas: Canvas,\n  renderTimestamp: number,\n  updatedRoot?: PibblNode | typeof NO_PENDING_ROOT,\n  _updateParents = false,\n  frameSnapshot?: PibblFrameSnapshot,\n): void {\n  if (!canvas) {\n    throw new Error('No canvas element provided');\n  }\n\n  const pibblInstance = GLOBAL_STATE.pibblInstances.get(canvas);\n\n  if (!pibblInstance) {\n    throw new Error('Pibbl is not mounted on this element');\n  }\n\n  if (pibblInstance.mainTeardowns.closed) return;\n\n  const inheritedTransaction = pibblInstance.eventRoot.renderTransaction;\n  const renderTransaction = inheritedTransaction ?? new RootRenderTransaction();\n  const ownsRenderTransaction = !inheritedTransaction;\n  if (ownsRenderTransaction) {\n    pibblInstance.eventRoot.renderTransaction = renderTransaction;\n  }\n  let transactionFinished = false;\n  const finishTransaction = (success: boolean) => {\n    if (!ownsRenderTransaction || transactionFinished) return;\n    transactionFinished = true;\n    (renderTransaction as RootRenderTransaction).finish(success);\n  };\n\n  const prevCurrentPibblInstance = GLOBAL_STATE.currentPibblInstance;\n  const prevCanvas = GLOBAL_STATE.canvas;\n  const prevRenderContext = GLOBAL_STATE.renderContext;\n  const prevRenderTarget = GLOBAL_STATE.renderTarget;\n  const prevWorldBaseTransform = GLOBAL_STATE.worldBaseTransform;\n  const prevWorldExactTransform = GLOBAL_STATE.worldExactTransform;\n  const prevWorldPaintAnchorTransform = GLOBAL_STATE.worldPaintAnchorTransform;\n  const prevPresentationTransformLineage = GLOBAL_STATE.presentationTransformLineage;\n  const prevPresentationTransformLineageTrackingDepth =\n    GLOBAL_STATE.presentationTransformLineageTrackingDepth;\n  const prevRenderTransaction = GLOBAL_STATE.renderTransaction;\n  const prevFrameSnapshot = GLOBAL_STATE.frameSnapshot;\n  const prevPrimitiveReceiverToken = GLOBAL_STATE.primitiveReceiverToken;\n  const prevSeenIds = GLOBAL_STATE.seenIds;\n  const prevSeenKeys = GLOBAL_STATE.seenKeys;\n  const prevComponentRefs = GLOBAL_STATE.componentRefs;\n  const prevComponentHookIndex = GLOBAL_STATE.componentHookIndex;\n  const prevComponentIsMounting = GLOBAL_STATE.componentIsMounting;\n  const prevClippingStack = GLOBAL_STATE.clippingStack;\n  const prevLayoutStack = GLOBAL_STATE.layoutStack;\n  const prevBackendDriver = GLOBAL_STATE.backendDriver;\n  const prevBackendFrame = GLOBAL_STATE.backendFrame;\n  const prevBackendEnvironment = GLOBAL_STATE.backendEnvironment;\n  let frame: PibblBackendFrame<unknown> | undefined;\n  let frameSuccess = false;\n  let renderSeenIds: Set<string> | undefined;\n  let renderSeenKeys: Set<string> | undefined;\n  try {\n    const activeFrameSnapshot = frameSnapshot ?? (\n      prevFrameSnapshot?.logicalTime === renderTimestamp ?\n        prevFrameSnapshot :\n        Object.freeze({\n          frameId: prevFrameSnapshot?.frameId ?? 0,\n          hostTime: prevFrameSnapshot?.hostTime ?? renderTimestamp,\n          logicalTime: renderTimestamp,\n        })\n    );\n    GLOBAL_STATE.frameSnapshot = activeFrameSnapshot;\n    GLOBAL_STATE.currentPibblInstance = pibblInstance;\n    for (const service of pibblInstance.optionalServices.values()) service.beginRender?.();\n    GLOBAL_STATE.renderTransaction = renderTransaction;\n    GLOBAL_STATE.currentPibblInstance.renderTimestamp = activeFrameSnapshot.logicalTime;\n    GLOBAL_STATE.canvas = canvas;\n    const rootNode = arguments.length >= 3 && updatedRoot !== NO_PENDING_ROOT ?\n      updatedRoot :\n      GLOBAL_STATE.currentPibblInstance.root;\n    GLOBAL_STATE.currentPibblInstance.root = rootNode;\n    const driver = pibblInstance.backendDriver;\n    GLOBAL_STATE.backendDriver = driver;\n    frame = driver.beginFrame({\n      canvas,\n      logicalWidth: pibblInstance.rootLayoutBox.width,\n      logicalHeight: pibblInstance.rootLayoutBox.height,\n      backingWidth: canvas.width,\n      backingHeight: canvas.height,\n      renderTimestamp: activeFrameSnapshot.logicalTime,\n    });\n    if (!frame) {\n      pibblInstance.eventRoot.html?.suspend(pibblInstance);\n      finishTransaction(true);\n      return;\n    }\n    pibblInstance.eventRoot.html?.beginRender(pibblInstance);\n    GLOBAL_STATE.backendFrame = frame;\n    GLOBAL_STATE.backendEnvironment = frame.environment;\n    GLOBAL_STATE.renderContext = frame.context2D;\n    GLOBAL_STATE.renderTarget = frame.renderTarget;\n    GLOBAL_STATE.worldBaseTransform = frame.worldBaseTransform;\n    GLOBAL_STATE.worldExactTransform = undefined;\n    GLOBAL_STATE.worldPaintAnchorTransform = undefined;\n    GLOBAL_STATE.presentationTransformLineage = undefined;\n    GLOBAL_STATE.presentationTransformLineageTrackingDepth = 0;\n    if (\n      frame.context2D !== undefined &&\n      frame.renderTarget !== undefined &&\n      frame.worldBaseTransform !== undefined\n    ) {\n      initializeCurrentWorldTransformAnchor(frame.worldBaseTransform);\n    }\n    GLOBAL_STATE.clippingStack = [];\n    const surface = pibblInstance.surface.snapshot;\n    const logicalWidth = surface?.logicalWidth ?? pibblInstance.rootLayoutBox.width;\n    const logicalHeight = surface?.logicalHeight ?? pibblInstance.rootLayoutBox.height;\n    const previousRootBox = pibblInstance.rootLayoutBox;\n    if (\n      previousRootBox.width !== logicalWidth ||\n      previousRootBox.height !== logicalHeight\n    ) {\n      pibblInstance.rootLayoutBox = Object.freeze({\n        x: 0,\n        y: 0,\n        width: logicalWidth,\n        height: logicalHeight,\n      });\n    }\n    GLOBAL_STATE.layoutStack = [{\n      allocation: pibblInstance.rootLayoutBox,\n      percentageBasis: pibblInstance.rootLayoutBox,\n    }];\n\n    const renderGeneration = ++pibblInstance.renderGeneration;\n    renderSeenIds = pibblInstance.renderSeenIds;\n    renderSeenKeys = pibblInstance.renderSeenKeys;\n    renderSeenIds.clear();\n    renderSeenKeys.clear();\n    GLOBAL_STATE.seenIds = renderSeenIds;\n    GLOBAL_STATE.seenKeys = renderSeenKeys;\n    const id = 'root';\n    renderSeenIds.add(id);\n    withSignalWriteForbidden(\n      'Pibbl render',\n      () => render(rootNode, id, undefined),\n    );\n\n    for (const [id, componentRefs] of pibblInstance.refs) {\n      if (componentRefs.renderGeneration === renderGeneration) continue;\n      componentRefs.teardowns.execute();\n      pibblInstance.refs.delete(id);\n    }\n    frameSuccess = true;\n    for (const service of pibblInstance.optionalServices.values()) service.endRender?.(true);\n    driver.finishFrame(frame, true);\n    finishTransaction(true);\n  } catch (error) {\n    for (const service of pibblInstance.optionalServices.values()) service.endRender?.(false);\n    finishTransaction(false);\n    for (const refs of pibblInstance.refs.values()) {\n      refs.teardowns.execute();\n    }\n    pibblInstance.refs.clear();\n    throw error;\n  } finally {\n    try {\n      if (frame && !frameSuccess) {\n        pibblInstance.backendDriver.finishFrame(frame, false);\n      }\n    } finally {\n      try {\n        clearTempState();\n        GLOBAL_STATE.clippingStack = prevClippingStack;\n        GLOBAL_STATE.layoutStack = prevLayoutStack;\n        if (ownsRenderTransaction) {\n          try {\n            finishTransaction(false);\n          } finally {\n            if (pibblInstance.eventRoot.renderTransaction === renderTransaction) {\n              pibblInstance.eventRoot.renderTransaction = undefined;\n            }\n          }\n        }\n      } finally {\n        renderSeenIds?.clear();\n        renderSeenKeys?.clear();\n        GLOBAL_STATE.currentPibblInstance = prevCurrentPibblInstance;\n        GLOBAL_STATE.canvas = prevCanvas;\n        GLOBAL_STATE.renderContext = prevRenderContext;\n        GLOBAL_STATE.renderTarget = prevRenderTarget;\n        GLOBAL_STATE.worldBaseTransform = prevWorldBaseTransform;\n        GLOBAL_STATE.worldExactTransform = prevWorldExactTransform;\n        GLOBAL_STATE.worldPaintAnchorTransform = prevWorldPaintAnchorTransform;\n        GLOBAL_STATE.presentationTransformLineage = prevPresentationTransformLineage;\n        GLOBAL_STATE.presentationTransformLineageTrackingDepth =\n          prevPresentationTransformLineageTrackingDepth;\n        GLOBAL_STATE.renderTransaction = prevRenderTransaction;\n        GLOBAL_STATE.frameSnapshot = prevFrameSnapshot;\n        GLOBAL_STATE.primitiveReceiverToken = prevPrimitiveReceiverToken;\n        GLOBAL_STATE.seenIds = prevSeenIds;\n        GLOBAL_STATE.seenKeys = prevSeenKeys;\n        GLOBAL_STATE.componentRefs = prevComponentRefs;\n        GLOBAL_STATE.componentHookIndex = prevComponentHookIndex;\n        GLOBAL_STATE.componentIsMounting = prevComponentIsMounting;\n        GLOBAL_STATE.backendDriver = prevBackendDriver;\n        GLOBAL_STATE.backendFrame = prevBackendFrame;\n        GLOBAL_STATE.backendEnvironment = prevBackendEnvironment;\n      }\n    }\n  }\n}\n"],
-  "mappings": "AAAA,SAAS,6BAA6B;AACtC;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,OACK;AACP,SAAS,cAAc;AACvB,SAAS,6CAA6C;AAStD,SAAS,gCAAgC;AAOlC,SAAS,cACd,QACA,iBACA,aACA,iBAAiB,OACjB,eACM;AACN,MAAI,CAAC,QAAQ;AACX,UAAM,IAAI,MAAM,4BAA4B;AAAA,EAC9C;AAEA,QAAM,gBAAgB,aAAa,eAAe,IAAI,MAAM;AAE5D,MAAI,CAAC,eAAe;AAClB,UAAM,IAAI,MAAM,sCAAsC;AAAA,EACxD;AAEA,MAAI,cAAc,cAAc,OAAQ;AAExC,QAAM,uBAAuB,cAAc,UAAU;AACrD,QAAM,oBAAoB,wBAAwB,IAAI,sBAAsB;AAC5E,QAAM,wBAAwB,CAAC;AAC/B,MAAI,uBAAuB;AACzB,kBAAc,UAAU,oBAAoB;AAAA,EAC9C;AACA,MAAI,sBAAsB;AAC1B,QAAM,oBAAoB,CAAC,YAAqB;AAC9C,QAAI,CAAC,yBAAyB,oBAAqB;AACnD,0BAAsB;AACtB,IAAC,kBAA4C,OAAO,OAAO;AAAA,EAC7D;AAEA,QAAM,2BAA2B,aAAa;AAC9C,QAAM,aAAa,aAAa;AAChC,QAAM,oBAAoB,aAAa;AACvC,QAAM,mBAAmB,aAAa;AACtC,QAAM,yBAAyB,aAAa;AAC5C,QAAM,0BAA0B,aAAa;AAC7C,QAAM,gCAAgC,aAAa;AACnD,QAAM,mCAAmC,aAAa;AACtD,QAAM,gDACJ,aAAa;AACf,QAAM,wBAAwB,aAAa;AAC3C,QAAM,oBAAoB,aAAa;AACvC,QAAM,6BAA6B,aAAa;AAChD,QAAM,cAAc,aAAa;AACjC,QAAM,eAAe,aAAa;AAClC,QAAM,oBAAoB,aAAa;AACvC,QAAM,yBAAyB,aAAa;AAC5C,QAAM,0BAA0B,aAAa;AAC7C,QAAM,oBAAoB,aAAa;AACvC,QAAM,kBAAkB,aAAa;AACrC,QAAM,oBAAoB,aAAa;AACvC,QAAM,mBAAmB,aAAa;AACtC,QAAM,yBAAyB,aAAa;AAC5C,MAAI;AACJ,MAAI,eAAe;AACnB,MAAI;AACJ,MAAI;AACJ,MAAI;AACF,UAAM,sBAAsB,kBAC1B,mBAAmB,gBAAgB,kBACjC,oBACA,OAAO,OAAO;AAAA,MACZ,SAAS,mBAAmB,WAAW;AAAA,MACvC,UAAU,mBAAmB,YAAY;AAAA,MACzC,aAAa;AAAA,IACf,CAAC;AAEL,iBAAa,gBAAgB;AAC7B,iBAAa,uBAAuB;AACpC,eAAW,WAAW,cAAc,iBAAiB,OAAO,EAAG,SAAQ,cAAc;AACrF,iBAAa,oBAAoB;AACjC,iBAAa,qBAAqB,kBAAkB,oBAAoB;AACxE,iBAAa,SAAS;AACtB,UAAM,WAAW,UAAU,UAAU,KAAK,gBAAgB,kBACxD,cACA,aAAa,qBAAqB;AACpC,iBAAa,qBAAqB,OAAO;AACzC,UAAM,SAAS,cAAc;AAC7B,iBAAa,gBAAgB;AAC7B,YAAQ,OAAO,WAAW;AAAA,MACxB;AAAA,MACA,cAAc,cAAc,cAAc;AAAA,MAC1C,eAAe,cAAc,cAAc;AAAA,MAC3C,cAAc,OAAO;AAAA,MACrB,eAAe,OAAO;AAAA,MACtB,iBAAiB,oBAAoB;AAAA,IACvC,CAAC;AACD,QAAI,CAAC,OAAO;AACV,oBAAc,UAAU,MAAM,QAAQ,aAAa;AACnD,wBAAkB,IAAI;AACtB;AAAA,IACF;AACA,kBAAc,UAAU,MAAM,YAAY,aAAa;AACvD,iBAAa,eAAe;AAC5B,iBAAa,qBAAqB,MAAM;AACxC,iBAAa,gBAAgB,MAAM;AACnC,iBAAa,eAAe,MAAM;AAClC,iBAAa,qBAAqB,MAAM;AACxC,iBAAa,sBAAsB;AACnC,iBAAa,4BAA4B;AACzC,iBAAa,+BAA+B;AAC5C,iBAAa,4CAA4C;AACzD,QACE,MAAM,cAAc,UACpB,MAAM,iBAAiB,UACvB,MAAM,uBAAuB,QAC7B;AACA,4CAAsC,MAAM,kBAAkB;AAAA,IAChE;AACA,iBAAa,gBAAgB,CAAC;AAC9B,UAAM,UAAU,cAAc,QAAQ;AACtC,UAAM,eAAe,SAAS,gBAAgB,cAAc,cAAc;AAC1E,UAAM,gBAAgB,SAAS,iBAAiB,cAAc,cAAc;AAC5E,UAAM,kBAAkB,cAAc;AACtC,QACE,gBAAgB,UAAU,gBAC1B,gBAAgB,WAAW,eAC3B;AACA,oBAAc,gBAAgB,OAAO,OAAO;AAAA,QAC1C,GAAG;AAAA,QACH,GAAG;AAAA,QACH,OAAO;AAAA,QACP,QAAQ;AAAA,MACV,CAAC;AAAA,IACH;AACA,iBAAa,cAAc,CAAC;AAAA,MAC1B,YAAY,cAAc;AAAA,MAC1B,iBAAiB,cAAc;AAAA,IACjC,CAAC;AAED,UAAM,mBAAmB,EAAE,cAAc;AACzC,oBAAgB,cAAc;AAC9B,qBAAiB,cAAc;AAC/B,kBAAc,MAAM;AACpB,mBAAe,MAAM;AACrB,iBAAa,UAAU;AACvB,iBAAa,WAAW;AACxB,UAAM,KAAK;AACX,kBAAc,IAAI,EAAE;AACpB;AAAA,MACE;AAAA,MACA,MAAM,OAAO,UAAU,IAAI,MAAS;AAAA,IACtC;AAEA,eAAW,CAACA,KAAI,aAAa,KAAK,cAAc,MAAM;AACpD,UAAI,cAAc,qBAAqB,iBAAkB;AACzD,oBAAc,UAAU,QAAQ;AAChC,oBAAc,KAAK,OAAOA,GAAE;AAAA,IAC9B;AACA,mBAAe;AACf,eAAW,WAAW,cAAc,iBAAiB,OAAO,EAAG,SAAQ,YAAY,IAAI;AACvF,WAAO,YAAY,OAAO,IAAI;AAC9B,sBAAkB,IAAI;AAAA,EACxB,SAAS,OAAO;AACd,eAAW,WAAW,cAAc,iBAAiB,OAAO,EAAG,SAAQ,YAAY,KAAK;AACxF,sBAAkB,KAAK;AACvB,eAAW,QAAQ,cAAc,KAAK,OAAO,GAAG;AAC9C,WAAK,UAAU,QAAQ;AAAA,IACzB;AACA,kBAAc,KAAK,MAAM;AACzB,UAAM;AAAA,EACR,UAAE;AACA,QAAI;AACF,UAAI,SAAS,CAAC,cAAc;AAC1B,sBAAc,cAAc,YAAY,OAAO,KAAK;AAAA,MACtD;AAAA,IACF,UAAE;AACA,UAAI;AACF,uBAAe;AACf,qBAAa,gBAAgB;AAC7B,qBAAa,cAAc;AAC3B,YAAI,uBAAuB;AACzB,cAAI;AACF,8BAAkB,KAAK;AAAA,UACzB,UAAE;AACA,gBAAI,cAAc,UAAU,sBAAsB,mBAAmB;AACnE,4BAAc,UAAU,oBAAoB;AAAA,YAC9C;AAAA,UACF;AAAA,QACF;AAAA,MACF,UAAE;AACA,uBAAe,MAAM;AACrB,wBAAgB,MAAM;AACtB,qBAAa,uBAAuB;AACpC,qBAAa,SAAS;AACtB,qBAAa,gBAAgB;AAC7B,qBAAa,eAAe;AAC5B,qBAAa,qBAAqB;AAClC,qBAAa,sBAAsB;AACnC,qBAAa,4BAA4B;AACzC,qBAAa,+BAA+B;AAC5C,qBAAa,4CACX;AACF,qBAAa,oBAAoB;AACjC,qBAAa,gBAAgB;AAC7B,qBAAa,yBAAyB;AACtC,qBAAa,UAAU;AACvB,qBAAa,WAAW;AACxB,qBAAa,gBAAgB;AAC7B,qBAAa,qBAAqB;AAClC,qBAAa,sBAAsB;AACnC,qBAAa,gBAAgB;AAC7B,qBAAa,eAAe;AAC5B,qBAAa,qBAAqB;AAAA,MACpC;AAAA,IACF;AAAA,EACF;AACF;",
+  "sourcesContent": ["import { RootRenderTransaction } from './render-transaction.js';\nimport {\n  clearTempState,\n  GLOBAL_STATE,\n  NO_PENDING_ROOT,\n} from './global-state.js';\nimport { render } from './render.js';\nimport { initializeCurrentWorldTransformAnchor } from './render-target.js';\nimport {\n  Canvas,\n  type PibblNode,\n} from './types.js';\nimport type {\n  PibblBackendFrame,\n} from './backend/types.js';\nimport type { PibblFrameSnapshot } from './scheduler/types.js';\nimport { withSignalWriteForbidden } from './signals/graph.js';\n\n/**\n * Gets the root element for a canvas and renders it. This is the\n * entry point for rendering the entire tree.\n * @param canvas The canvas to render on\n */\nexport function executeRender(\n  canvas: Canvas,\n  renderTimestamp: number,\n  updatedRoot?: PibblNode | typeof NO_PENDING_ROOT,\n  _updateParents = false,\n  frameSnapshot?: PibblFrameSnapshot,\n): void {\n  if (!canvas) {\n    throw new Error('No canvas element provided');\n  }\n\n  const pibblInstance = GLOBAL_STATE.pibblInstances.get(canvas);\n\n  if (!pibblInstance) {\n    throw new Error('Pibbl is not mounted on this element');\n  }\n\n  if (pibblInstance.mainTeardowns.closed) return;\n\n  const inheritedTransaction = pibblInstance.eventRoot.renderTransaction;\n  const renderTransaction = inheritedTransaction ?? new RootRenderTransaction();\n  const ownsRenderTransaction = !inheritedTransaction;\n  if (ownsRenderTransaction) {\n    pibblInstance.eventRoot.renderTransaction = renderTransaction;\n  }\n  let transactionFinished = false;\n  const finishTransaction = (success: boolean) => {\n    if (!ownsRenderTransaction || transactionFinished) return;\n    transactionFinished = true;\n    (renderTransaction as RootRenderTransaction).finish(success);\n  };\n\n  const prevCurrentPibblInstance = GLOBAL_STATE.currentPibblInstance;\n  const prevCanvas = GLOBAL_STATE.canvas;\n  const prevRenderContext = GLOBAL_STATE.renderContext;\n  const prevRenderTarget = GLOBAL_STATE.renderTarget;\n  const prevWorldBaseTransform = GLOBAL_STATE.worldBaseTransform;\n  const prevWorldExactTransform = GLOBAL_STATE.worldExactTransform;\n  const prevWorldPaintAnchorTransform = GLOBAL_STATE.worldPaintAnchorTransform;\n  const prevPresentationTransformLineage = GLOBAL_STATE.presentationTransformLineage;\n  const prevPresentationTransformLineageTrackingDepth =\n    GLOBAL_STATE.presentationTransformLineageTrackingDepth;\n  const prevRenderTransaction = GLOBAL_STATE.renderTransaction;\n  const prevFrameSnapshot = GLOBAL_STATE.frameSnapshot;\n  const prevPrimitiveReceiverToken = GLOBAL_STATE.primitiveReceiverToken;\n  const prevSeenIds = GLOBAL_STATE.seenIds;\n  const prevSeenKeys = GLOBAL_STATE.seenKeys;\n  const prevComponentRefs = GLOBAL_STATE.componentRefs;\n  const prevComponentHookIndex = GLOBAL_STATE.componentHookIndex;\n  const prevComponentIsMounting = GLOBAL_STATE.componentIsMounting;\n  const prevClippingStack = GLOBAL_STATE.clippingStack;\n  const prevLayoutStack = GLOBAL_STATE.layoutStack;\n  const prevBackendDriver = GLOBAL_STATE.backendDriver;\n  const prevBackendFrame = GLOBAL_STATE.backendFrame;\n  const prevBackendEnvironment = GLOBAL_STATE.backendEnvironment;\n  let frame: PibblBackendFrame<unknown> | undefined;\n  let frameSuccess = false;\n  let renderSeenIds: Set<string> | undefined;\n  let renderSeenKeys: Set<string> | undefined;\n  try {\n    const activeFrameSnapshot = frameSnapshot ?? (\n      prevFrameSnapshot?.logicalTime === renderTimestamp ?\n        prevFrameSnapshot :\n        Object.freeze({\n          frameId: prevFrameSnapshot?.frameId ?? 0,\n          hostTime: prevFrameSnapshot?.hostTime ?? renderTimestamp,\n          logicalTime: renderTimestamp,\n        })\n    );\n    GLOBAL_STATE.frameSnapshot = activeFrameSnapshot;\n    GLOBAL_STATE.currentPibblInstance = pibblInstance;\n    for (const service of pibblInstance.optionalServices.values()) service.beginRender?.();\n    GLOBAL_STATE.renderTransaction = renderTransaction;\n    GLOBAL_STATE.currentPibblInstance.renderTimestamp = activeFrameSnapshot.logicalTime;\n    GLOBAL_STATE.canvas = canvas;\n    const rootNode = arguments.length >= 3 && updatedRoot !== NO_PENDING_ROOT ?\n      updatedRoot :\n      GLOBAL_STATE.currentPibblInstance.root;\n    GLOBAL_STATE.currentPibblInstance.root = rootNode;\n    const driver = pibblInstance.backendDriver;\n    GLOBAL_STATE.backendDriver = driver;\n    frame = driver.beginFrame({\n      canvas,\n      logicalWidth: pibblInstance.rootLayoutBox.width,\n      logicalHeight: pibblInstance.rootLayoutBox.height,\n      backingWidth: canvas.width,\n      backingHeight: canvas.height,\n      renderTimestamp: activeFrameSnapshot.logicalTime,\n    });\n    if (!frame) {\n      pibblInstance.eventRoot.html?.suspend(pibblInstance);\n      finishTransaction(true);\n      return;\n    }\n    pibblInstance.eventRoot.html?.beginRender(pibblInstance);\n    GLOBAL_STATE.backendFrame = frame;\n    GLOBAL_STATE.backendEnvironment = frame.environment;\n    GLOBAL_STATE.renderContext = frame.context2D;\n    GLOBAL_STATE.renderTarget = frame.renderTarget;\n    GLOBAL_STATE.worldBaseTransform = frame.worldBaseTransform;\n    GLOBAL_STATE.worldExactTransform = undefined;\n    GLOBAL_STATE.worldPaintAnchorTransform = undefined;\n    GLOBAL_STATE.presentationTransformLineage = undefined;\n    GLOBAL_STATE.presentationTransformLineageTrackingDepth = 0;\n    if (\n      frame.context2D !== undefined &&\n      frame.renderTarget !== undefined &&\n      frame.worldBaseTransform !== undefined\n    ) {\n      initializeCurrentWorldTransformAnchor(frame.worldBaseTransform);\n    }\n    GLOBAL_STATE.clippingStack = [];\n    const surface = pibblInstance.surface.snapshot;\n    const logicalWidth = surface?.logicalWidth ?? pibblInstance.rootLayoutBox.width;\n    const logicalHeight = surface?.logicalHeight ?? pibblInstance.rootLayoutBox.height;\n    const previousRootBox = pibblInstance.rootLayoutBox;\n    if (\n      previousRootBox.width !== logicalWidth ||\n      previousRootBox.height !== logicalHeight\n    ) {\n      pibblInstance.rootLayoutBox = Object.freeze({\n        x: 0,\n        y: 0,\n        width: logicalWidth,\n        height: logicalHeight,\n      });\n    }\n    GLOBAL_STATE.layoutStack = [{\n      allocation: pibblInstance.rootLayoutBox,\n      percentageBasis: pibblInstance.rootLayoutBox,\n    }];\n\n    const renderGeneration = ++pibblInstance.renderGeneration;\n    if (!pibblInstance.parent) {\n      renderTransaction.onFinish((success) => {\n        if (success) pibblInstance.committedRenderGeneration = renderGeneration;\n      });\n      if (pibblInstance.rootFrameObservers?.size) {\n        renderTransaction.onAfterFinish?.((success) => {\n          const observers = pibblInstance.rootFrameObservers;\n          if (!observers) return;\n          for (const observer of observers)\n            observer(success, renderGeneration);\n        });\n      }\n    }\n    renderSeenIds = pibblInstance.renderSeenIds;\n    renderSeenKeys = pibblInstance.renderSeenKeys;\n    renderSeenIds.clear();\n    renderSeenKeys.clear();\n    GLOBAL_STATE.seenIds = renderSeenIds;\n    GLOBAL_STATE.seenKeys = renderSeenKeys;\n    const id = 'root';\n    renderSeenIds.add(id);\n    withSignalWriteForbidden(\n      'Pibbl render',\n      () => render(rootNode, id, undefined),\n    );\n\n    for (const [id, componentRefs] of pibblInstance.refs) {\n      if (componentRefs.renderGeneration === renderGeneration) continue;\n      componentRefs.teardowns.execute();\n      pibblInstance.refs.delete(id);\n    }\n    frameSuccess = true;\n    for (const service of pibblInstance.optionalServices.values()) service.endRender?.(true);\n    driver.finishFrame(frame, true);\n    finishTransaction(true);\n  } catch (error) {\n    for (const service of pibblInstance.optionalServices.values()) service.endRender?.(false);\n    finishTransaction(false);\n    for (const refs of pibblInstance.refs.values()) {\n      refs.teardowns.execute();\n    }\n    pibblInstance.refs.clear();\n    throw error;\n  } finally {\n    try {\n      if (frame && !frameSuccess) {\n        pibblInstance.backendDriver.finishFrame(frame, false);\n      }\n    } finally {\n      try {\n        clearTempState();\n        GLOBAL_STATE.clippingStack = prevClippingStack;\n        GLOBAL_STATE.layoutStack = prevLayoutStack;\n        if (ownsRenderTransaction) {\n          try {\n            finishTransaction(false);\n          } finally {\n            if (pibblInstance.eventRoot.renderTransaction === renderTransaction) {\n              pibblInstance.eventRoot.renderTransaction = undefined;\n            }\n          }\n        }\n      } finally {\n        renderSeenIds?.clear();\n        renderSeenKeys?.clear();\n        GLOBAL_STATE.currentPibblInstance = prevCurrentPibblInstance;\n        GLOBAL_STATE.canvas = prevCanvas;\n        GLOBAL_STATE.renderContext = prevRenderContext;\n        GLOBAL_STATE.renderTarget = prevRenderTarget;\n        GLOBAL_STATE.worldBaseTransform = prevWorldBaseTransform;\n        GLOBAL_STATE.worldExactTransform = prevWorldExactTransform;\n        GLOBAL_STATE.worldPaintAnchorTransform = prevWorldPaintAnchorTransform;\n        GLOBAL_STATE.presentationTransformLineage = prevPresentationTransformLineage;\n        GLOBAL_STATE.presentationTransformLineageTrackingDepth =\n          prevPresentationTransformLineageTrackingDepth;\n        GLOBAL_STATE.renderTransaction = prevRenderTransaction;\n        GLOBAL_STATE.frameSnapshot = prevFrameSnapshot;\n        GLOBAL_STATE.primitiveReceiverToken = prevPrimitiveReceiverToken;\n        GLOBAL_STATE.seenIds = prevSeenIds;\n        GLOBAL_STATE.seenKeys = prevSeenKeys;\n        GLOBAL_STATE.componentRefs = prevComponentRefs;\n        GLOBAL_STATE.componentHookIndex = prevComponentHookIndex;\n        GLOBAL_STATE.componentIsMounting = prevComponentIsMounting;\n        GLOBAL_STATE.backendDriver = prevBackendDriver;\n        GLOBAL_STATE.backendFrame = prevBackendFrame;\n        GLOBAL_STATE.backendEnvironment = prevBackendEnvironment;\n      }\n    }\n  }\n}\n"],
+  "mappings": "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",
   "names": ["id"]
 }

package/dist/lib/hooks/use-animated-value.d.ts

@@ -1,24 +1,14 @@
-import type { PibblSpringAnimatedValueOptions, PibblTweenAnimatedValueOptions } from '../animation/types.js';
+import type { PibblAnimatedValueOptions } from '../animation/types.js';
 import type { Signal, SignalValue } from '../signals/types.js';
+type AnimatedValueInputs<T> = {
+    readonly [K in keyof PibblAnimatedValueOptions<T>]: SignalValue<PibblAnimatedValueOptions<T>[K]>;
+};
 /**
- * Animates a numeric target using an analytic spring. See {@link PibblSpringAnimatedValueOptions}
- * and {@link Signal}.
- * @param target - Target value or signal whose changes start transitions. See {@link SignalValue}.
- * @param options - Spring or tween configuration, including signal-backed fields. See
- * {@link SignalValue} , {@link PibblSpringAnimatedValueOptions} .
- * @returns A readonly signal containing the animated value. See {@link Signal}.
+ * Presents a target through an immutable animation definition or a pure animation factory.
+ * @param targetInput - Target value or signal. See {@link SignalValue}.
+ * @param optionsInput - Animation definition, initial value, equality, and diagnostic settings;
+ * fields and the options object may be signals. See {@link PibblAnimatedValueOptions}.
+ * @returns One stable readonly animated signal. See {@link Signal}.
  */
-export declare function useAnimatedValue(target: SignalValue<number>, options: SignalValue<{
-    readonly [K in keyof PibblSpringAnimatedValueOptions]: SignalValue<PibblSpringAnimatedValueOptions[K]>;
-}>): Signal<number>;
-/**
- * Animates a target using a tween and optional custom interpolation. See
- * {@link PibblTweenAnimatedValueOptions} and {@link Signal}.
- * @param target - Target value or signal whose changes start transitions. See {@link SignalValue}.
- * @param options - Spring or tween configuration, including signal-backed fields. See
- * {@link SignalValue} , {@link PibblTweenAnimatedValueOptions} .
- * @returns A readonly signal containing the animated value. See {@link Signal}.
- */
-export declare function useAnimatedValue<T>(target: SignalValue<T>, options: SignalValue<{
-    readonly [K in keyof PibblTweenAnimatedValueOptions<T>]: SignalValue<PibblTweenAnimatedValueOptions<T>[K]>;
-}>): Signal<T>;
+export declare function useAnimatedValue<T>(targetInput: SignalValue<T>, optionsInput: SignalValue<AnimatedValueInputs<NoInfer<T>>>): Signal<T>;
+export {};

package/dist/lib/hooks/use-animated-value.js

@@ -1,8 +1,9 @@
+import { bindAnimationTarget } from "../animation/definition.js";
+import { drive } from "../animation/program.js";
+import { withSignalWriteForbidden } from "../signals/graph.js";
 import {
   createAnimationPlaybackController
 } from "../animation/playback.js";
-import { spring, tween } from "../animation/definition.js";
-import { drive } from "../animation/program.js";
 import { GLOBAL_STATE } from "../global-state.js";
 import {
   isSignal,
@@ -11,45 +12,16 @@ import {
   untracked
 } from "../signals/graph.js";
 import { resolveSignalValue } from "../signals/resolve-signal-value.js";
-import { requireHookContext, useHookSlot } from "./hook-slot.js";
-function hasOwn(value, key) {
-  return Object.prototype.hasOwnProperty.call(value, key);
-}
+import { requireHookContext, useHookSlot, withHooksForbidden } from "./hook-slot.js";
 function normalizeCandidate(target, options) {
   if (typeof options !== "object" || options === null) {
-    throw new TypeError("Pibbl transition options must be an object.");
-  }
-  if (options.type !== "tween" && options.type !== "spring") {
-    throw new TypeError('Pibbl transition type must be "tween" or "spring".');
+    throw new TypeError("useAnimatedValue options must be an object.");
   }
   if (options.equals !== void 0 && typeof options.equals !== "function") {
     throw new TypeError("Pibbl transition equals must be a function.");
   }
   const snapshot = Object.freeze({ ...options });
-  if (snapshot.type === "spring") {
-    spring({
-      from: target,
-      to: target,
-      mass: snapshot.mass,
-      stiffness: snapshot.stiffness,
-      damping: snapshot.damping,
-      initialVelocity: snapshot.initialVelocity,
-      restSpeed: snapshot.restSpeed,
-      restDelta: snapshot.restDelta,
-      maxDuration: snapshot.maxDuration,
-      debugName: snapshot.debugName
-    });
-  } else {
-    tween({
-      from: target,
-      to: target,
-      duration: snapshot.duration,
-      easing: snapshot.easing,
-      interpolate: snapshot.interpolate,
-      debugName: snapshot.debugName
-    });
-  }
-  const hasInitial = hasOwn(options, "initial");
+  const hasInitial = Object.prototype.hasOwnProperty.call(options, "initial");
   return Object.freeze({
     options: snapshot,
     equals: snapshot.equals ?? Object.is,
@@ -58,31 +30,6 @@ function normalizeCandidate(target, options) {
     target
   });
 }
-function programFor(output, from, candidate, springVelocity) {
-  const options = candidate.options;
-  if (options.type === "spring") {
-    return drive(output, spring({
-      from,
-      to: candidate.target,
-      mass: options.mass,
-      stiffness: options.stiffness,
-      damping: options.damping,
-      initialVelocity: springVelocity ?? options.initialVelocity,
-      restSpeed: options.restSpeed,
-      restDelta: options.restDelta,
-      maxDuration: options.maxDuration,
-      debugName: options.debugName
-    }));
-  }
-  return drive(output, tween({
-    from,
-    to: candidate.target,
-    duration: options.duration,
-    easing: options.easing,
-    interpolate: options.interpolate,
-    debugName: options.debugName
-  }));
-}
 function isCurrentSlot(slot) {
   return !slot.componentRefs.teardowns.closed && !slot.pibblInstance.mainTeardowns.closed && GLOBAL_STATE.pibblInstances.get(slot.pibblInstance.canvas) === slot.pibblInstance && slot.pibblInstance.refs.get(slot.componentRefs.id) === slot.componentRefs;
 }
@@ -91,13 +38,14 @@ function useAnimatedValue(targetInput, optionsInput) {
   const target = resolveSignalValue(targetInput);
   const options = resolveTransitionOptions(optionsInput);
   const candidate = normalizeCandidate(target, options);
-  const slot = useHookSlot("transition", (teardowns) => {
+  const slot = useHookSlot("animatedValue", (teardowns) => {
     const output = signal(candidate.initial);
-    const program = programFor(output, candidate.initial, candidate);
-    const controller = createAnimationPlaybackController(program, {
+    const program2 = programFor(output, candidate.initial, candidate);
+    const controller = createAnimationPlaybackController(program2, {
       conflict: "replace",
       debugName: candidate.options.debugName
     });
+    controller.setDeferredStatusCommandOwner(pibblInstance.mainTeardowns);
     const value = {
       componentRefs,
       controller,
@@ -111,6 +59,12 @@ function useAnimatedValue(targetInput, optionsInput) {
     teardowns.add(() => controller.dispose());
     return value;
   }).value;
+  const program = programFor(
+    slot.output,
+    slot.settled ? untracked(() => slot.output.get()) : candidate.initial,
+    candidate,
+    slot.settled ? slot.controller.committedSpringSnapshot()?.velocity : void 0
+  );
   const shouldEnter = !slot.settled && candidate.hasInitial && !candidate.equals(candidate.initial, candidate.target);
   const shouldRetarget = slot.settled && !candidate.equals(slot.target, candidate.target);
   const previousProvisionalValue = untracked(() => slot.output.get());
@@ -130,7 +84,7 @@ function useAnimatedValue(targetInput, optionsInput) {
     slot.target = candidate.target;
     if (!shouldEnter && !shouldRetarget) {
       slot.controller.adopt(
-        programFor(slot.output, slot.output.get(), candidate),
+        program,
         {
           conflict: "replace",
           debugName: candidate.options.debugName
@@ -138,13 +92,6 @@ function useAnimatedValue(targetInput, optionsInput) {
       );
       return;
     }
-    const springVelocity = candidate.options.type === "spring" ? slot.controller.committedSpringSnapshot()?.velocity : void 0;
-    const program = programFor(
-      slot.output,
-      slot.output.get(),
-      candidate,
-      springVelocity
-    );
     slot.controller.retarget(program, {
       conflict: "replace",
       debugName: candidate.options.debugName
@@ -163,6 +110,12 @@ function resolveTransitionOptions(input) {
   }
   return resolved ?? source;
 }
+function programFor(output, from, candidate, velocity) {
+  const context = Object.freeze({ from, to: candidate.target, velocity });
+  const animation = candidate.options.animation;
+  const definition = typeof animation === "function" ? withHooksForbidden("Animation factories cannot call hooks.", () => withSignalWriteForbidden("Animation factories cannot write to signals.", () => animation(context))) : animation;
+  return drive(output, bindAnimationTarget(definition, context));
+}
 export {
   useAnimatedValue
 };

package/dist/lib/hooks/use-animated-value.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../src/lib/hooks/use-animated-value.ts"],
-  "sourcesContent": ["import {\n  createAnimationPlaybackController,\n  type AnimationPlaybackController,\n} from '../animation/playback.js';\nimport { spring, tween } from '../animation/definition.js';\nimport { drive } from '../animation/program.js';\nimport type {\n  PibblAnimationProgram,\n  PibblSpringAnimatedValueOptions,\n  PibblTweenAnimatedValueOptions,\n} from '../animation/types.js';\nimport { GLOBAL_STATE } from '../global-state.js';\nimport {\n  isSignal,\n  provisionSignalValueForRender,\n  signal,\n  untracked,\n} from '../signals/graph.js';\nimport { resolveSignalValue } from '../signals/resolve-signal-value.js';\nimport type {\n  Signal,\n  SignalEquals,\n  SignalValue,\n  WritableSignal,\n} from '../signals/types.js';\nimport type { PibblComponentRefs, PibblInstance } from '../types.js';\nimport { requireHookContext, useHookSlot } from './hook-slot.js';\n\ntype PibblTransitionOptions<T> =\n  | PibblTweenAnimatedValueOptions<T>\n  | PibblSpringAnimatedValueOptions;\n\ntype PibblTransitionOptionsInput<T> =\n  | {\n      readonly [K in keyof PibblTweenAnimatedValueOptions<T>]:\n        SignalValue<PibblTweenAnimatedValueOptions<T>[K]>;\n    }\n  | {\n      readonly [K in keyof PibblSpringAnimatedValueOptions]:\n        SignalValue<PibblSpringAnimatedValueOptions[K]>;\n    };\n\ninterface PibblTransitionCandidate<T> {\n  readonly options: PibblTransitionOptions<T>;\n  readonly equals: SignalEquals<T>;\n  readonly hasInitial: boolean;\n  readonly initial: T;\n  readonly target: T;\n}\n\ninterface PibblTransitionHookSlot<T> {\n  readonly componentRefs: PibblComponentRefs<any>;\n  readonly controller: AnimationPlaybackController;\n  readonly pibblInstance: PibblInstance;\n  readonly output: WritableSignal<T>;\n  readonly readonlyOutput: Signal<T>;\n  renderRevision: number;\n  settled: boolean;\n  target: T;\n}\n\nfunction hasOwn(value: object, key: PropertyKey): boolean {\n  return Object.prototype.hasOwnProperty.call(value, key);\n}\n\nfunction normalizeCandidate<T>(\n  target: T,\n  options: PibblTransitionOptions<T>,\n): PibblTransitionCandidate<T> {\n  if (typeof options !== 'object' || options === null) {\n    throw new TypeError('Pibbl transition options must be an object.');\n  }\n  if (options.type !== 'tween' && options.type !== 'spring') {\n    throw new TypeError('Pibbl transition type must be \"tween\" or \"spring\".');\n  }\n  if (options.equals !== undefined && typeof options.equals !== 'function') {\n    throw new TypeError('Pibbl transition equals must be a function.');\n  }\n  const snapshot = Object.freeze({ ...options }) as PibblTransitionOptions<T>;\n  if (snapshot.type === 'spring') {\n    spring({\n      from: target as number,\n      to: target as number,\n      mass: snapshot.mass,\n      stiffness: snapshot.stiffness,\n      damping: snapshot.damping,\n      initialVelocity: snapshot.initialVelocity,\n      restSpeed: snapshot.restSpeed,\n      restDelta: snapshot.restDelta,\n      maxDuration: snapshot.maxDuration,\n      debugName: snapshot.debugName,\n    });\n  } else {\n    tween({\n      from: target,\n      to: target,\n      duration: snapshot.duration,\n      easing: snapshot.easing,\n      interpolate: snapshot.interpolate,\n      debugName: snapshot.debugName,\n    });\n  }\n  const hasInitial = hasOwn(options, 'initial');\n  return Object.freeze({\n    options: snapshot,\n    equals: (snapshot.equals ?? Object.is) as SignalEquals<T>,\n    hasInitial,\n    initial: (hasInitial ? snapshot.initial : target) as T,\n    target,\n  });\n}\n\nfunction programFor<T>(\n  output: WritableSignal<T>,\n  from: T,\n  candidate: PibblTransitionCandidate<T>,\n  springVelocity?: number,\n): PibblAnimationProgram {\n  const options = candidate.options;\n  if (options.type === 'spring') {\n    return drive(output as unknown as WritableSignal<number>, spring({\n      from: from as number,\n      to: candidate.target as number,\n      mass: options.mass,\n      stiffness: options.stiffness,\n      damping: options.damping,\n      initialVelocity: springVelocity ?? options.initialVelocity,\n      restSpeed: options.restSpeed,\n      restDelta: options.restDelta,\n      maxDuration: options.maxDuration,\n      debugName: options.debugName,\n    }));\n  }\n  return drive(output, tween({\n    from,\n    to: candidate.target,\n    duration: options.duration,\n    easing: options.easing,\n    interpolate: options.interpolate,\n    debugName: options.debugName,\n  }));\n}\n\nfunction isCurrentSlot<T>(slot: PibblTransitionHookSlot<T>): boolean {\n  return !slot.componentRefs.teardowns.closed &&\n    !slot.pibblInstance.mainTeardowns.closed &&\n    GLOBAL_STATE.pibblInstances.get(slot.pibblInstance.canvas) === slot.pibblInstance &&\n    slot.pibblInstance.refs.get(slot.componentRefs.id) === slot.componentRefs;\n}\n\n/**\n * Animates a numeric target using an analytic spring. See {@link PibblSpringAnimatedValueOptions}\n * and {@link Signal}.\n * @param target - Target value or signal whose changes start transitions. See {@link SignalValue}.\n * @param options - Spring or tween configuration, including signal-backed fields. See\n * {@link SignalValue} , {@link PibblSpringAnimatedValueOptions} .\n * @returns A readonly signal containing the animated value. See {@link Signal}.\n */\nexport function useAnimatedValue(\n  target: SignalValue<number>,\n  options: SignalValue<{\n    readonly [K in keyof PibblSpringAnimatedValueOptions]:\n      SignalValue<PibblSpringAnimatedValueOptions[K]>;\n  }>,\n): Signal<number>;\n/**\n * Animates a target using a tween and optional custom interpolation. See\n * {@link PibblTweenAnimatedValueOptions} and {@link Signal}.\n * @param target - Target value or signal whose changes start transitions. See {@link SignalValue}.\n * @param options - Spring or tween configuration, including signal-backed fields. See\n * {@link SignalValue} , {@link PibblTweenAnimatedValueOptions} .\n * @returns A readonly signal containing the animated value. See {@link Signal}.\n */\nexport function useAnimatedValue<T>(\n  target: SignalValue<T>,\n  options: SignalValue<{\n    readonly [K in keyof PibblTweenAnimatedValueOptions<T>]:\n      SignalValue<PibblTweenAnimatedValueOptions<T>[K]>;\n  }>,\n): Signal<T>;\n/**\n * Returns a mount-owned signal that animates toward the current target using the supplied\n * transition options.\n *\n * @param targetInput - Target value or signal whose changes start transitions. See\n * {@link SignalValue} .\n * @param optionsInput - Spring or tween configuration, including signal-backed fields. See\n * {@link SignalValue} , {@link PibblTransitionOptionsInput} .\n * @returns A readonly signal containing the animated value. See {@link Signal}.\n *\n * @see {@link SignalValue}\n * @see {@link Signal}\n */\nexport function useAnimatedValue<T>(\n  targetInput: SignalValue<T>,\n  optionsInput: SignalValue<PibblTransitionOptionsInput<T>>,\n): Signal<T> {\n  const { componentRefs, pibblInstance } = requireHookContext();\n  const target = resolveSignalValue(targetInput);\n  const options = resolveTransitionOptions(optionsInput);\n  const candidate = normalizeCandidate(target, options);\n  const slot = useHookSlot<PibblTransitionHookSlot<T>>('transition', teardowns => {\n    const output = signal(candidate.initial);\n    const program = programFor(output, candidate.initial, candidate);\n    const controller = createAnimationPlaybackController(program, {\n      conflict: 'replace',\n      debugName: candidate.options.debugName,\n    });\n    const value: PibblTransitionHookSlot<T> = {\n      componentRefs,\n      controller,\n      pibblInstance,\n      output,\n      readonlyOutput: output.asReadonly(),\n      renderRevision: 0,\n      settled: false,\n      target: candidate.target,\n    };\n    teardowns.add(() => controller.dispose());\n    return value;\n  }).value;\n\n  const shouldEnter = !slot.settled && candidate.hasInitial &&\n    !candidate.equals(candidate.initial, candidate.target);\n  const shouldRetarget = slot.settled &&\n    !candidate.equals(slot.target, candidate.target);\n  const previousProvisionalValue = untracked(() => slot.output.get());\n  const hasProvisionalValue = !slot.settled &&\n    !Object.is(previousProvisionalValue, candidate.initial);\n  const transaction = GLOBAL_STATE.renderTransaction;\n  if (!transaction) {\n    throw new Error('useAnimatedValue requires an active Pibbl render transaction.');\n  }\n  if (hasProvisionalValue) {\n    provisionSignalValueForRender(slot.output, candidate.initial, transaction);\n  }\n  const revision = ++slot.renderRevision;\n  transaction.onFinish(success => {\n    if (!success) return;\n    if (revision !== slot.renderRevision || !isCurrentSlot(slot)) return;\n    slot.settled = true;\n    slot.target = candidate.target;\n    if (!shouldEnter && !shouldRetarget) {\n      slot.controller.adopt(\n        programFor(slot.output, slot.output.get(), candidate),\n        {\n          conflict: 'replace',\n          debugName: candidate.options.debugName,\n        },\n      );\n      return;\n    }\n    const springVelocity = candidate.options.type === 'spring' ?\n      slot.controller.committedSpringSnapshot()?.velocity : undefined;\n    const program = programFor(\n      slot.output,\n      slot.output.get(),\n      candidate,\n      springVelocity,\n    );\n    slot.controller.retarget(program, {\n      conflict: 'replace',\n      debugName: candidate.options.debugName,\n    });\n  });\n  return slot.readonlyOutput;\n}\n\nfunction resolveTransitionOptions<T>(\n  input: SignalValue<PibblTransitionOptionsInput<T>>,\n): PibblTransitionOptions<T> {\n  const source = resolveSignalValue(input);\n  let resolved: Record<PropertyKey, unknown> | undefined;\n  for (const key in source) {\n    const value = source[key as keyof typeof source];\n    if (!isSignal(value)) continue;\n    resolved ??= { ...source };\n    resolved[key] = resolveSignalValue(value as SignalValue<unknown>);\n  }\n  return (resolved ?? source) as PibblTransitionOptions<T>;\n}\n"],
-  "mappings": "AAAA;AAAA,EACE;AAAA,OAEK;AACP,SAAS,QAAQ,aAAa;AAC9B,SAAS,aAAa;AAMtB,SAAS,oBAAoB;AAC7B;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OACK;AACP,SAAS,0BAA0B;AAQnC,SAAS,oBAAoB,mBAAmB;AAmChD,SAAS,OAAO,OAAe,KAA2B;AACxD,SAAO,OAAO,UAAU,eAAe,KAAK,OAAO,GAAG;AACxD;AAEA,SAAS,mBACP,QACA,SAC6B;AAC7B,MAAI,OAAO,YAAY,YAAY,YAAY,MAAM;AACnD,UAAM,IAAI,UAAU,6CAA6C;AAAA,EACnE;AACA,MAAI,QAAQ,SAAS,WAAW,QAAQ,SAAS,UAAU;AACzD,UAAM,IAAI,UAAU,oDAAoD;AAAA,EAC1E;AACA,MAAI,QAAQ,WAAW,UAAa,OAAO,QAAQ,WAAW,YAAY;AACxE,UAAM,IAAI,UAAU,6CAA6C;AAAA,EACnE;AACA,QAAM,WAAW,OAAO,OAAO,EAAE,GAAG,QAAQ,CAAC;AAC7C,MAAI,SAAS,SAAS,UAAU;AAC9B,WAAO;AAAA,MACL,MAAM;AAAA,MACN,IAAI;AAAA,MACJ,MAAM,SAAS;AAAA,MACf,WAAW,SAAS;AAAA,MACpB,SAAS,SAAS;AAAA,MAClB,iBAAiB,SAAS;AAAA,MAC1B,WAAW,SAAS;AAAA,MACpB,WAAW,SAAS;AAAA,MACpB,aAAa,SAAS;AAAA,MACtB,WAAW,SAAS;AAAA,IACtB,CAAC;AAAA,EACH,OAAO;AACL,UAAM;AAAA,MACJ,MAAM;AAAA,MACN,IAAI;AAAA,MACJ,UAAU,SAAS;AAAA,MACnB,QAAQ,SAAS;AAAA,MACjB,aAAa,SAAS;AAAA,MACtB,WAAW,SAAS;AAAA,IACtB,CAAC;AAAA,EACH;AACA,QAAM,aAAa,OAAO,SAAS,SAAS;AAC5C,SAAO,OAAO,OAAO;AAAA,IACnB,SAAS;AAAA,IACT,QAAS,SAAS,UAAU,OAAO;AAAA,IACnC;AAAA,IACA,SAAU,aAAa,SAAS,UAAU;AAAA,IAC1C;AAAA,EACF,CAAC;AACH;AAEA,SAAS,WACP,QACA,MACA,WACA,gBACuB;AACvB,QAAM,UAAU,UAAU;AAC1B,MAAI,QAAQ,SAAS,UAAU;AAC7B,WAAO,MAAM,QAA6C,OAAO;AAAA,MAC/D;AAAA,MACA,IAAI,UAAU;AAAA,MACd,MAAM,QAAQ;AAAA,MACd,WAAW,QAAQ;AAAA,MACnB,SAAS,QAAQ;AAAA,MACjB,iBAAiB,kBAAkB,QAAQ;AAAA,MAC3C,WAAW,QAAQ;AAAA,MACnB,WAAW,QAAQ;AAAA,MACnB,aAAa,QAAQ;AAAA,MACrB,WAAW,QAAQ;AAAA,IACrB,CAAC,CAAC;AAAA,EACJ;AACA,SAAO,MAAM,QAAQ,MAAM;AAAA,IACzB;AAAA,IACA,IAAI,UAAU;AAAA,IACd,UAAU,QAAQ;AAAA,IAClB,QAAQ,QAAQ;AAAA,IAChB,aAAa,QAAQ;AAAA,IACrB,WAAW,QAAQ;AAAA,EACrB,CAAC,CAAC;AACJ;AAEA,SAAS,cAAiB,MAA2C;AACnE,SAAO,CAAC,KAAK,cAAc,UAAU,UACnC,CAAC,KAAK,cAAc,cAAc,UAClC,aAAa,eAAe,IAAI,KAAK,cAAc,MAAM,MAAM,KAAK,iBACpE,KAAK,cAAc,KAAK,IAAI,KAAK,cAAc,EAAE,MAAM,KAAK;AAChE;AA6CO,SAAS,iBACd,aACA,cACW;AACX,QAAM,EAAE,eAAe,cAAc,IAAI,mBAAmB;AAC5D,QAAM,SAAS,mBAAmB,WAAW;AAC7C,QAAM,UAAU,yBAAyB,YAAY;AACrD,QAAM,YAAY,mBAAmB,QAAQ,OAAO;AACpD,QAAM,OAAO,YAAwC,cAAc,eAAa;AAC9E,UAAM,SAAS,OAAO,UAAU,OAAO;AACvC,UAAM,UAAU,WAAW,QAAQ,UAAU,SAAS,SAAS;AAC/D,UAAM,aAAa,kCAAkC,SAAS;AAAA,MAC5D,UAAU;AAAA,MACV,WAAW,UAAU,QAAQ;AAAA,IAC/B,CAAC;AACD,UAAM,QAAoC;AAAA,MACxC;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA,gBAAgB,OAAO,WAAW;AAAA,MAClC,gBAAgB;AAAA,MAChB,SAAS;AAAA,MACT,QAAQ,UAAU;AAAA,IACpB;AACA,cAAU,IAAI,MAAM,WAAW,QAAQ,CAAC;AACxC,WAAO;AAAA,EACT,CAAC,EAAE;AAEH,QAAM,cAAc,CAAC,KAAK,WAAW,UAAU,cAC7C,CAAC,UAAU,OAAO,UAAU,SAAS,UAAU,MAAM;AACvD,QAAM,iBAAiB,KAAK,WAC1B,CAAC,UAAU,OAAO,KAAK,QAAQ,UAAU,MAAM;AACjD,QAAM,2BAA2B,UAAU,MAAM,KAAK,OAAO,IAAI,CAAC;AAClE,QAAM,sBAAsB,CAAC,KAAK,WAChC,CAAC,OAAO,GAAG,0BAA0B,UAAU,OAAO;AACxD,QAAM,cAAc,aAAa;AACjC,MAAI,CAAC,aAAa;AAChB,UAAM,IAAI,MAAM,+DAA+D;AAAA,EACjF;AACA,MAAI,qBAAqB;AACvB,kCAA8B,KAAK,QAAQ,UAAU,SAAS,WAAW;AAAA,EAC3E;AACA,QAAM,WAAW,EAAE,KAAK;AACxB,cAAY,SAAS,aAAW;AAC9B,QAAI,CAAC,QAAS;AACd,QAAI,aAAa,KAAK,kBAAkB,CAAC,cAAc,IAAI,EAAG;AAC9D,SAAK,UAAU;AACf,SAAK,SAAS,UAAU;AACxB,QAAI,CAAC,eAAe,CAAC,gBAAgB;AACnC,WAAK,WAAW;AAAA,QACd,WAAW,KAAK,QAAQ,KAAK,OAAO,IAAI,GAAG,SAAS;AAAA,QACpD;AAAA,UACE,UAAU;AAAA,UACV,WAAW,UAAU,QAAQ;AAAA,QAC/B;AAAA,MACF;AACA;AAAA,IACF;AACA,UAAM,iBAAiB,UAAU,QAAQ,SAAS,WAChD,KAAK,WAAW,wBAAwB,GAAG,WAAW;AACxD,UAAM,UAAU;AAAA,MACd,KAAK;AAAA,MACL,KAAK,OAAO,IAAI;AAAA,MAChB;AAAA,MACA;AAAA,IACF;AACA,SAAK,WAAW,SAAS,SAAS;AAAA,MAChC,UAAU;AAAA,MACV,WAAW,UAAU,QAAQ;AAAA,IAC/B,CAAC;AAAA,EACH,CAAC;AACD,SAAO,KAAK;AACd;AAEA,SAAS,yBACP,OAC2B;AAC3B,QAAM,SAAS,mBAAmB,KAAK;AACvC,MAAI;AACJ,aAAW,OAAO,QAAQ;AACxB,UAAM,QAAQ,OAAO,GAA0B;AAC/C,QAAI,CAAC,SAAS,KAAK,EAAG;AACtB,iBAAa,EAAE,GAAG,OAAO;AACzB,aAAS,GAAG,IAAI,mBAAmB,KAA6B;AAAA,EAClE;AACA,SAAQ,YAAY;AACtB;",
-  "names": []
+  "sourcesContent": ["import { bindAnimationTarget } from '../animation/definition.js';\nimport { drive } from '../animation/program.js';\nimport { withSignalWriteForbidden } from '../signals/graph.js';\nimport {\n  createAnimationPlaybackController,\n  type AnimationPlaybackController,\n} from '../animation/playback.js';\nimport type {\n  PibblAnimatedValueOptions,\n} from '../animation/types.js';\nimport { GLOBAL_STATE } from '../global-state.js';\nimport {\n  isSignal,\n  provisionSignalValueForRender,\n  signal,\n  untracked,\n} from '../signals/graph.js';\nimport { resolveSignalValue } from '../signals/resolve-signal-value.js';\nimport type {\n  Signal,\n  SignalEquals,\n  SignalValue,\n  WritableSignal,\n} from '../signals/types.js';\nimport type { PibblComponentRefs, PibblInstance } from '../types.js';\nimport { requireHookContext, useHookSlot, withHooksForbidden } from './hook-slot.js';\n\ntype AnimatedValueInputs<T> = {\n  readonly [K in keyof PibblAnimatedValueOptions<T>]: SignalValue<PibblAnimatedValueOptions<T>[K]>;\n};\n\ninterface PibblTransitionCandidate<T> {\n  readonly options: PibblAnimatedValueOptions<T>;\n  readonly equals: SignalEquals<T>;\n  readonly hasInitial: boolean;\n  readonly initial: T;\n  readonly target: T;\n}\n\ninterface PibblTransitionHookSlot<T> {\n  readonly componentRefs: PibblComponentRefs<any>;\n  readonly controller: AnimationPlaybackController;\n  readonly pibblInstance: PibblInstance;\n  readonly output: WritableSignal<T>;\n  readonly readonlyOutput: Signal<T>;\n  renderRevision: number;\n  settled: boolean;\n  target: T;\n}\n\nfunction normalizeCandidate<T>(\n  target: T,\n  options: PibblAnimatedValueOptions<T>,\n): PibblTransitionCandidate<T> {\n  if (typeof options !== 'object' || options === null) {\n    throw new TypeError('useAnimatedValue options must be an object.');\n  }\n  if (options.equals !== undefined && typeof options.equals !== 'function') {\n    throw new TypeError('Pibbl transition equals must be a function.');\n  }\n  const snapshot = Object.freeze({ ...options });\n  const hasInitial = Object.prototype.hasOwnProperty.call(options, 'initial');\n  return Object.freeze({\n    options: snapshot,\n    equals: snapshot.equals ?? Object.is,\n    hasInitial,\n    initial: (hasInitial ? snapshot.initial : target) as T,\n    target,\n  });\n}\n\nfunction isCurrentSlot<T>(slot: PibblTransitionHookSlot<T>): boolean {\n  return !slot.componentRefs.teardowns.closed &&\n    !slot.pibblInstance.mainTeardowns.closed &&\n    GLOBAL_STATE.pibblInstances.get(slot.pibblInstance.canvas) === slot.pibblInstance &&\n    slot.pibblInstance.refs.get(slot.componentRefs.id) === slot.componentRefs;\n}\n\n/**\n * Presents a target through an immutable animation definition or a pure animation factory.\n * @param targetInput - Target value or signal. See {@link SignalValue}.\n * @param optionsInput - Animation definition, initial value, equality, and diagnostic settings;\n * fields and the options object may be signals. See {@link PibblAnimatedValueOptions}.\n * @returns One stable readonly animated signal. See {@link Signal}.\n */\nexport function useAnimatedValue<T>(\n  targetInput: SignalValue<T>,\n  optionsInput: SignalValue<AnimatedValueInputs<NoInfer<T>>>,\n): Signal<T> {\n  const { componentRefs, pibblInstance } = requireHookContext();\n  const target = resolveSignalValue(targetInput);\n  const options = resolveTransitionOptions<T>(optionsInput);\n  const candidate = normalizeCandidate(target, options);\n  const slot = useHookSlot<PibblTransitionHookSlot<T>>('animatedValue', teardowns => {\n    const output = signal(candidate.initial);\n    const program = programFor(output, candidate.initial, candidate);\n    const controller = createAnimationPlaybackController(program, {\n      conflict: 'replace',\n      debugName: candidate.options.debugName,\n    });\n    controller.setDeferredStatusCommandOwner(pibblInstance.mainTeardowns);\n    const value: PibblTransitionHookSlot<T> = {\n      componentRefs,\n      controller,\n      pibblInstance,\n      output,\n      readonlyOutput: output.asReadonly(),\n      renderRevision: 0,\n      settled: false,\n      target: candidate.target,\n    };\n    teardowns.add(() => controller.dispose());\n    return value;\n  }).value;\n\n  // Prepare user-defined work while Render can still fail transactionally. No factory runs\n  // in onFinish, where a late exception could otherwise adopt only part of the update.\n  const program = programFor(slot.output,\n    slot.settled ? untracked(() => slot.output.get()) : candidate.initial,\n    candidate, slot.settled ? slot.controller.committedSpringSnapshot()?.velocity : undefined);\n\n  const shouldEnter = !slot.settled && candidate.hasInitial &&\n    !candidate.equals(candidate.initial, candidate.target);\n  const shouldRetarget = slot.settled &&\n    !candidate.equals(slot.target, candidate.target);\n  const previousProvisionalValue = untracked(() => slot.output.get());\n  const hasProvisionalValue = !slot.settled &&\n    !Object.is(previousProvisionalValue, candidate.initial);\n  const transaction = GLOBAL_STATE.renderTransaction;\n  if (!transaction) {\n    throw new Error('useAnimatedValue requires an active Pibbl render transaction.');\n  }\n  if (hasProvisionalValue) {\n    provisionSignalValueForRender(slot.output, candidate.initial, transaction);\n  }\n  const revision = ++slot.renderRevision;\n  transaction.onFinish(success => {\n    if (!success) return;\n    if (revision !== slot.renderRevision || !isCurrentSlot(slot)) return;\n    slot.settled = true;\n    slot.target = candidate.target;\n    if (!shouldEnter && !shouldRetarget) {\n      slot.controller.adopt(\n        program,\n        {\n          conflict: 'replace',\n          debugName: candidate.options.debugName,\n        },\n      );\n      return;\n    }\n    slot.controller.retarget(program, {\n      conflict: 'replace',\n      debugName: candidate.options.debugName,\n    });\n  });\n  return slot.readonlyOutput;\n}\n\nfunction resolveTransitionOptions<T>(\n  input: SignalValue<AnimatedValueInputs<T>>,\n): PibblAnimatedValueOptions<T> {\n  const source = resolveSignalValue(input);\n  let resolved: Record<PropertyKey, unknown> | undefined;\n  for (const key in source) {\n    const value = source[key as keyof typeof source];\n    if (!isSignal(value)) continue;\n    resolved ??= { ...source };\n    resolved[key] = resolveSignalValue(value as SignalValue<unknown>);\n  }\n  return (resolved ?? source) as PibblAnimatedValueOptions<T>;\n}\n\nfunction programFor<T>(\n  output: WritableSignal<T>, from: T, candidate: PibblTransitionCandidate<T>, velocity?: number,\n) {\n  const context = Object.freeze({ from, to: candidate.target, velocity });\n  const animation = candidate.options.animation;\n  const definition = typeof animation === 'function'\n    ? withHooksForbidden('Animation factories cannot call hooks.', () =>\n      withSignalWriteForbidden('Animation factories cannot write to signals.', () => animation(context)))\n    : animation;\n  return drive(output, bindAnimationTarget(definition, context));\n}\n"],
+  "mappings": "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",
+  "names": ["program"]
 }

package/dist/lib/hooks/use-playback.js

@@ -28,6 +28,7 @@ function usePlayback(programInput, optionsInput = {}) {
       candidate.program,
       candidateOptions
     );
+    controller.setDeferredStatusCommandOwner(pibblInstance.mainTeardowns);
     const onEvent = (event) => {
       if (isCurrentSlot(value)) value.latestOptions.onEvent?.(event);
     };

package/dist/lib/hooks/use-playback.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../src/lib/hooks/use-playback.ts"],
-  "sourcesContent": ["import {\n  createAnimationPlaybackController,\n  normalizeAnimationPlaybackCandidate,\n  type AnimationPlaybackController,\n} from '../animation/playback.js';\nimport type {\n  PibblAnimationProgram,\n  PibblPlayback,\n  PibblPlaybackEvent,\n  PibblPlaybackOptions,\n} from '../animation/types.js';\nimport { GLOBAL_STATE } from '../global-state.js';\nimport { isSignal } from '../signals/graph.js';\nimport { resolveSignalValue } from '../signals/resolve-signal-value.js';\nimport type { SignalValue } from '../signals/types.js';\nimport type { PibblComponentRefs, PibblInstance } from '../types.js';\nimport { requireHookContext, useHookSlot } from './hook-slot.js';\n\ntype PibblPlaybackOptionsInput = {\n  readonly [K in keyof PibblPlaybackOptions]: SignalValue<PibblPlaybackOptions[K]>;\n};\n\ninterface PibblPlaybackHookSlot {\n  readonly controller: AnimationPlaybackController;\n  readonly componentRefs: PibblComponentRefs<any>;\n  readonly pibblInstance: PibblInstance;\n  latestOptions: PibblPlaybackOptions;\n  mountSettled: boolean;\n  readonly onError: (error: unknown) => void;\n  readonly onEvent: (event: PibblPlaybackEvent) => void;\n  renderRevision: number;\n}\n\nfunction isCurrentSlot(slot: PibblPlaybackHookSlot): boolean {\n  return !slot.componentRefs.teardowns.closed &&\n    !slot.pibblInstance.mainTeardowns.closed &&\n    GLOBAL_STATE.pibblInstances.get(slot.pibblInstance.canvas) === slot.pibblInstance &&\n    slot.pibblInstance.refs.get(slot.componentRefs.id) === slot.componentRefs;\n}\n\nfunction controllerOptions(\n  candidate: PibblPlaybackOptions,\n  onEvent: (event: PibblPlaybackEvent) => void,\n  onError: (error: unknown) => void,\n): PibblPlaybackOptions {\n  return {\n    ...candidate,\n    onEvent: typeof candidate.onEvent === 'function' ?\n      onEvent : candidate.onEvent,\n    onError: typeof candidate.onError === 'function' ?\n      onError : candidate.onError,\n  };\n}\n\n/**\n * Creates one component-owned animation playback handle for a hook slot.\n *\n * @param programInput - Animation program, optionally supplied by a signal. See\n * {@link SignalValue} , {@link PibblAnimationProgram} .\n * @param optionsInput - Playback configuration, optionally supplied by a signal. See\n * {@link SignalValue} , {@link PibblPlaybackOptionsInput} .\n * @returns Stable mount-owned playback controls and reactive status/time values. See\n * {@link PibblPlayback} .\n *\n * @see {@link SignalValue}\n * @see {@link PibblAnimationProgram}\n * @see {@link PibblPlayback}\n */\nexport function usePlayback(\n  programInput: SignalValue<PibblAnimationProgram>,\n  optionsInput: SignalValue<PibblPlaybackOptionsInput> = {},\n): PibblPlayback {\n  const { componentRefs, pibblInstance } = requireHookContext();\n  const program = resolveSignalValue(programInput);\n  const options = resolvePlaybackOptions(optionsInput);\n  const candidate = normalizeAnimationPlaybackCandidate(program, options);\n  const candidateOptions = candidate.options;\n  const slot = useHookSlot<PibblPlaybackHookSlot>('playback', teardowns => {\n    let value!: PibblPlaybackHookSlot;\n    const controller = createAnimationPlaybackController(\n      candidate.program,\n      candidateOptions,\n    );\n    const onEvent = (event: PibblPlaybackEvent): void => {\n      if (isCurrentSlot(value)) value.latestOptions.onEvent?.(event);\n    };\n    const onError = (error: unknown): void => {\n      if (isCurrentSlot(value)) value.latestOptions.onError?.(error);\n    };\n    value = {\n      controller,\n      componentRefs,\n      pibblInstance,\n      latestOptions: {},\n      mountSettled: false,\n      onError,\n      onEvent,\n      renderRevision: 0,\n    };\n    controller.adopt(\n      candidate.program,\n      controllerOptions(candidateOptions, onEvent, onError),\n    );\n    teardowns.add(() => controller.dispose());\n    return value;\n  }).value;\n  const revision = ++slot.renderRevision;\n  const transaction = GLOBAL_STATE.renderTransaction;\n  if (!transaction) {\n    throw new Error('usePlayback requires an active Pibbl render transaction.');\n  }\n  transaction.onFinish(success => {\n    if (!success || revision !== slot.renderRevision || !isCurrentSlot(slot)) return;\n    slot.controller.adopt(\n      candidate.program,\n      controllerOptions(candidateOptions, slot.onEvent, slot.onError),\n    );\n    slot.latestOptions = candidateOptions;\n    if (!slot.mountSettled) {\n      slot.mountSettled = true;\n      if (candidateOptions.autoplay === true) slot.controller.handle.play();\n    }\n  });\n  return slot.controller.handle;\n}\n\nfunction resolvePlaybackOptions(\n  input: SignalValue<PibblPlaybackOptionsInput>,\n): PibblPlaybackOptions {\n  const source = resolveSignalValue(input);\n  let resolved: Record<PropertyKey, unknown> | undefined;\n  for (const key in source) {\n    const value = source[key as keyof PibblPlaybackOptionsInput];\n    if (!isSignal(value)) continue;\n    resolved ??= { ...source };\n    resolved[key] = resolveSignalValue(value as SignalValue<unknown>);\n  }\n  return (resolved ?? source) as PibblPlaybackOptions;\n}\n"],
-  "mappings": "AAAA;AAAA,EACE;AAAA,EACA;AAAA,OAEK;AAOP,SAAS,oBAAoB;AAC7B,SAAS,gBAAgB;AACzB,SAAS,0BAA0B;AAGnC,SAAS,oBAAoB,mBAAmB;AAiBhD,SAAS,cAAc,MAAsC;AAC3D,SAAO,CAAC,KAAK,cAAc,UAAU,UACnC,CAAC,KAAK,cAAc,cAAc,UAClC,aAAa,eAAe,IAAI,KAAK,cAAc,MAAM,MAAM,KAAK,iBACpE,KAAK,cAAc,KAAK,IAAI,KAAK,cAAc,EAAE,MAAM,KAAK;AAChE;AAEA,SAAS,kBACP,WACA,SACA,SACsB;AACtB,SAAO;AAAA,IACL,GAAG;AAAA,IACH,SAAS,OAAO,UAAU,YAAY,aACpC,UAAU,UAAU;AAAA,IACtB,SAAS,OAAO,UAAU,YAAY,aACpC,UAAU,UAAU;AAAA,EACxB;AACF;AAgBO,SAAS,YACd,cACA,eAAuD,CAAC,GACzC;AACf,QAAM,EAAE,eAAe,cAAc,IAAI,mBAAmB;AAC5D,QAAM,UAAU,mBAAmB,YAAY;AAC/C,QAAM,UAAU,uBAAuB,YAAY;AACnD,QAAM,YAAY,oCAAoC,SAAS,OAAO;AACtE,QAAM,mBAAmB,UAAU;AACnC,QAAM,OAAO,YAAmC,YAAY,eAAa;AACvE,QAAI;AACJ,UAAM,aAAa;AAAA,MACjB,UAAU;AAAA,MACV;AAAA,IACF;AACA,UAAM,UAAU,CAAC,UAAoC;AACnD,UAAI,cAAc,KAAK,EAAG,OAAM,cAAc,UAAU,KAAK;AAAA,IAC/D;AACA,UAAM,UAAU,CAAC,UAAyB;AACxC,UAAI,cAAc,KAAK,EAAG,OAAM,cAAc,UAAU,KAAK;AAAA,IAC/D;AACA,YAAQ;AAAA,MACN;AAAA,MACA;AAAA,MACA;AAAA,MACA,eAAe,CAAC;AAAA,MAChB,cAAc;AAAA,MACd;AAAA,MACA;AAAA,MACA,gBAAgB;AAAA,IAClB;AACA,eAAW;AAAA,MACT,UAAU;AAAA,MACV,kBAAkB,kBAAkB,SAAS,OAAO;AAAA,IACtD;AACA,cAAU,IAAI,MAAM,WAAW,QAAQ,CAAC;AACxC,WAAO;AAAA,EACT,CAAC,EAAE;AACH,QAAM,WAAW,EAAE,KAAK;AACxB,QAAM,cAAc,aAAa;AACjC,MAAI,CAAC,aAAa;AAChB,UAAM,IAAI,MAAM,0DAA0D;AAAA,EAC5E;AACA,cAAY,SAAS,aAAW;AAC9B,QAAI,CAAC,WAAW,aAAa,KAAK,kBAAkB,CAAC,cAAc,IAAI,EAAG;AAC1E,SAAK,WAAW;AAAA,MACd,UAAU;AAAA,MACV,kBAAkB,kBAAkB,KAAK,SAAS,KAAK,OAAO;AAAA,IAChE;AACA,SAAK,gBAAgB;AACrB,QAAI,CAAC,KAAK,cAAc;AACtB,WAAK,eAAe;AACpB,UAAI,iBAAiB,aAAa,KAAM,MAAK,WAAW,OAAO,KAAK;AAAA,IACtE;AAAA,EACF,CAAC;AACD,SAAO,KAAK,WAAW;AACzB;AAEA,SAAS,uBACP,OACsB;AACtB,QAAM,SAAS,mBAAmB,KAAK;AACvC,MAAI;AACJ,aAAW,OAAO,QAAQ;AACxB,UAAM,QAAQ,OAAO,GAAsC;AAC3D,QAAI,CAAC,SAAS,KAAK,EAAG;AACtB,iBAAa,EAAE,GAAG,OAAO;AACzB,aAAS,GAAG,IAAI,mBAAmB,KAA6B;AAAA,EAClE;AACA,SAAQ,YAAY;AACtB;",
+  "sourcesContent": ["import {\n  createAnimationPlaybackController,\n  normalizeAnimationPlaybackCandidate,\n  type AnimationPlaybackController,\n} from '../animation/playback.js';\nimport type {\n  PibblAnimationProgram,\n  PibblPlayback,\n  PibblPlaybackEvent,\n  PibblPlaybackOptions,\n} from '../animation/types.js';\nimport { GLOBAL_STATE } from '../global-state.js';\nimport { isSignal } from '../signals/graph.js';\nimport { resolveSignalValue } from '../signals/resolve-signal-value.js';\nimport type { SignalValue } from '../signals/types.js';\nimport type { PibblComponentRefs, PibblInstance } from '../types.js';\nimport { requireHookContext, useHookSlot } from './hook-slot.js';\n\ntype PibblPlaybackOptionsInput = {\n  readonly [K in keyof PibblPlaybackOptions]: SignalValue<PibblPlaybackOptions[K]>;\n};\n\ninterface PibblPlaybackHookSlot {\n  readonly controller: AnimationPlaybackController;\n  readonly componentRefs: PibblComponentRefs<any>;\n  readonly pibblInstance: PibblInstance;\n  latestOptions: PibblPlaybackOptions;\n  mountSettled: boolean;\n  readonly onError: (error: unknown) => void;\n  readonly onEvent: (event: PibblPlaybackEvent) => void;\n  renderRevision: number;\n}\n\nfunction isCurrentSlot(slot: PibblPlaybackHookSlot): boolean {\n  return !slot.componentRefs.teardowns.closed &&\n    !slot.pibblInstance.mainTeardowns.closed &&\n    GLOBAL_STATE.pibblInstances.get(slot.pibblInstance.canvas) === slot.pibblInstance &&\n    slot.pibblInstance.refs.get(slot.componentRefs.id) === slot.componentRefs;\n}\n\nfunction controllerOptions(\n  candidate: PibblPlaybackOptions,\n  onEvent: (event: PibblPlaybackEvent) => void,\n  onError: (error: unknown) => void,\n): PibblPlaybackOptions {\n  return {\n    ...candidate,\n    onEvent: typeof candidate.onEvent === 'function' ?\n      onEvent : candidate.onEvent,\n    onError: typeof candidate.onError === 'function' ?\n      onError : candidate.onError,\n  };\n}\n\n/**\n * Creates one component-owned animation playback handle for a hook slot.\n *\n * @param programInput - Animation program, optionally supplied by a signal. See\n * {@link SignalValue} , {@link PibblAnimationProgram} .\n * @param optionsInput - Playback configuration, optionally supplied by a signal. See\n * {@link SignalValue} , {@link PibblPlaybackOptionsInput} .\n * @returns Stable mount-owned playback controls and reactive status/time values. See\n * {@link PibblPlayback} .\n *\n * @see {@link SignalValue}\n * @see {@link PibblAnimationProgram}\n * @see {@link PibblPlayback}\n */\nexport function usePlayback(\n  programInput: SignalValue<PibblAnimationProgram>,\n  optionsInput: SignalValue<PibblPlaybackOptionsInput> = {},\n): PibblPlayback {\n  const { componentRefs, pibblInstance } = requireHookContext();\n  const program = resolveSignalValue(programInput);\n  const options = resolvePlaybackOptions(optionsInput);\n  const candidate = normalizeAnimationPlaybackCandidate(program, options);\n  const candidateOptions = candidate.options;\n  const slot = useHookSlot<PibblPlaybackHookSlot>('playback', teardowns => {\n    let value!: PibblPlaybackHookSlot;\n    const controller = createAnimationPlaybackController(\n      candidate.program,\n      candidateOptions,\n    );\n    controller.setDeferredStatusCommandOwner(pibblInstance.mainTeardowns);\n    const onEvent = (event: PibblPlaybackEvent): void => {\n      if (isCurrentSlot(value)) value.latestOptions.onEvent?.(event);\n    };\n    const onError = (error: unknown): void => {\n      if (isCurrentSlot(value)) value.latestOptions.onError?.(error);\n    };\n    value = {\n      controller,\n      componentRefs,\n      pibblInstance,\n      latestOptions: {},\n      mountSettled: false,\n      onError,\n      onEvent,\n      renderRevision: 0,\n    };\n    controller.adopt(\n      candidate.program,\n      controllerOptions(candidateOptions, onEvent, onError),\n    );\n    teardowns.add(() => controller.dispose());\n    return value;\n  }).value;\n  const revision = ++slot.renderRevision;\n  const transaction = GLOBAL_STATE.renderTransaction;\n  if (!transaction) {\n    throw new Error('usePlayback requires an active Pibbl render transaction.');\n  }\n  transaction.onFinish(success => {\n    if (!success || revision !== slot.renderRevision || !isCurrentSlot(slot)) return;\n    slot.controller.adopt(\n      candidate.program,\n      controllerOptions(candidateOptions, slot.onEvent, slot.onError),\n    );\n    slot.latestOptions = candidateOptions;\n    if (!slot.mountSettled) {\n      slot.mountSettled = true;\n      if (candidateOptions.autoplay === true) slot.controller.handle.play();\n    }\n  });\n  return slot.controller.handle;\n}\n\nfunction resolvePlaybackOptions(\n  input: SignalValue<PibblPlaybackOptionsInput>,\n): PibblPlaybackOptions {\n  const source = resolveSignalValue(input);\n  let resolved: Record<PropertyKey, unknown> | undefined;\n  for (const key in source) {\n    const value = source[key as keyof PibblPlaybackOptionsInput];\n    if (!isSignal(value)) continue;\n    resolved ??= { ...source };\n    resolved[key] = resolveSignalValue(value as SignalValue<unknown>);\n  }\n  return (resolved ?? source) as PibblPlaybackOptions;\n}\n"],
+  "mappings": "AAAA;AAAA,EACE;AAAA,EACA;AAAA,OAEK;AAOP,SAAS,oBAAoB;AAC7B,SAAS,gBAAgB;AACzB,SAAS,0BAA0B;AAGnC,SAAS,oBAAoB,mBAAmB;AAiBhD,SAAS,cAAc,MAAsC;AAC3D,SAAO,CAAC,KAAK,cAAc,UAAU,UACnC,CAAC,KAAK,cAAc,cAAc,UAClC,aAAa,eAAe,IAAI,KAAK,cAAc,MAAM,MAAM,KAAK,iBACpE,KAAK,cAAc,KAAK,IAAI,KAAK,cAAc,EAAE,MAAM,KAAK;AAChE;AAEA,SAAS,kBACP,WACA,SACA,SACsB;AACtB,SAAO;AAAA,IACL,GAAG;AAAA,IACH,SAAS,OAAO,UAAU,YAAY,aACpC,UAAU,UAAU;AAAA,IACtB,SAAS,OAAO,UAAU,YAAY,aACpC,UAAU,UAAU;AAAA,EACxB;AACF;AAgBO,SAAS,YACd,cACA,eAAuD,CAAC,GACzC;AACf,QAAM,EAAE,eAAe,cAAc,IAAI,mBAAmB;AAC5D,QAAM,UAAU,mBAAmB,YAAY;AAC/C,QAAM,UAAU,uBAAuB,YAAY;AACnD,QAAM,YAAY,oCAAoC,SAAS,OAAO;AACtE,QAAM,mBAAmB,UAAU;AACnC,QAAM,OAAO,YAAmC,YAAY,eAAa;AACvE,QAAI;AACJ,UAAM,aAAa;AAAA,MACjB,UAAU;AAAA,MACV;AAAA,IACF;AACA,eAAW,8BAA8B,cAAc,aAAa;AACpE,UAAM,UAAU,CAAC,UAAoC;AACnD,UAAI,cAAc,KAAK,EAAG,OAAM,cAAc,UAAU,KAAK;AAAA,IAC/D;AACA,UAAM,UAAU,CAAC,UAAyB;AACxC,UAAI,cAAc,KAAK,EAAG,OAAM,cAAc,UAAU,KAAK;AAAA,IAC/D;AACA,YAAQ;AAAA,MACN;AAAA,MACA;AAAA,MACA;AAAA,MACA,eAAe,CAAC;AAAA,MAChB,cAAc;AAAA,MACd;AAAA,MACA;AAAA,MACA,gBAAgB;AAAA,IAClB;AACA,eAAW;AAAA,MACT,UAAU;AAAA,MACV,kBAAkB,kBAAkB,SAAS,OAAO;AAAA,IACtD;AACA,cAAU,IAAI,MAAM,WAAW,QAAQ,CAAC;AACxC,WAAO;AAAA,EACT,CAAC,EAAE;AACH,QAAM,WAAW,EAAE,KAAK;AACxB,QAAM,cAAc,aAAa;AACjC,MAAI,CAAC,aAAa;AAChB,UAAM,IAAI,MAAM,0DAA0D;AAAA,EAC5E;AACA,cAAY,SAAS,aAAW;AAC9B,QAAI,CAAC,WAAW,aAAa,KAAK,kBAAkB,CAAC,cAAc,IAAI,EAAG;AAC1E,SAAK,WAAW;AAAA,MACd,UAAU;AAAA,MACV,kBAAkB,kBAAkB,KAAK,SAAS,KAAK,OAAO;AAAA,IAChE;AACA,SAAK,gBAAgB;AACrB,QAAI,CAAC,KAAK,cAAc;AACtB,WAAK,eAAe;AACpB,UAAI,iBAAiB,aAAa,KAAM,MAAK,WAAW,OAAO,KAAK;AAAA,IACtE;AAAA,EACF,CAAC;AACD,SAAO,KAAK,WAAW;AACzB;AAEA,SAAS,uBACP,OACsB;AACtB,QAAM,SAAS,mBAAmB,KAAK;AACvC,MAAI;AACJ,aAAW,OAAO,QAAQ;AACxB,UAAM,QAAQ,OAAO,GAAsC;AAC3D,QAAI,CAAC,SAAS,KAAK,EAAG;AACtB,iBAAa,EAAE,GAAG,OAAO;AACzB,aAAS,GAAG,IAAI,mBAAmB,KAA6B;AAAA,EAClE;AACA,SAAQ,YAAY;AACtB;",
   "names": []
 }