@pibbl/core 0.0.1 → 0.0.2

package/dist/lib/animation/types.d.ts

@@ -2,8 +2,8 @@ import type { Signal } from "../signals/types.js";
 import type { defineAnimation, keyframes, spring, stepper, tween } from "./definition.js";
 import type { marker, parallel, repeat } from "./program.js";
 import type { useAnimatedValue } from "../hooks/use-animated-value.js";
-import type { SignalEquals } from "../signals/types.js";
 import type { usePlayback } from "../hooks/use-playback.js";
+import type { SignalEquals } from '../signals/types.js';
 declare const pibblAnimationDefinitionBrand: unique symbol;
 declare const pibblAnimationProgramBrand: unique symbol;
 /**
@@ -14,7 +14,6 @@ declare const pibblAnimationProgramBrand: unique symbol;
  *
  * @see {@link PibblKeyframesOptions}
  * @see {@link PibblTweenOptions}
- * @see {@link PibblTweenAnimatedValueOptions}
  */
 export type PibblEasing = (progress: number) => number;
 /**
@@ -27,7 +26,6 @@ export type PibblEasing = (progress: number) => number;
  *
  * @see {@link PibblKeyframesOptions}
  * @see {@link PibblTweenOptions}
- * @see {@link PibblTweenAnimatedValueOptions}
  */
 export type PibblInterpolator<T> = (from: T, to: T, progress: number) => T;
 /**
@@ -78,8 +76,8 @@ export interface PibblAnimationRepeatOptions {
 export interface PibblTweenOptions<T> {
     /** Starting endpoint or value. See {@link PibblTweenOptions}. */
     readonly from?: T;
-    /** Destination endpoint or value. See {@link PibblTweenOptions}. */
-    readonly to: T;
+    /** Destination endpoint; omit when useAnimatedValue supplies the target. See {@link PibblTweenOptions}. */
+    readonly to?: T;
     /** Duration of the animation or transition in milliseconds. See {@link PibblTweenOptions}. */
     readonly duration: number;
     /** Maps normalized progress before interpolation. See {@link PibblEasing}. */
@@ -126,8 +124,8 @@ export interface PibblKeyframesOptions<T> {
 export interface PibblSpringOptions {
     /** Starting endpoint or value. See {@link PibblSpringOptions}. */
     readonly from?: number;
-    /** Destination endpoint or value. See {@link PibblSpringOptions}. */
-    readonly to: number;
+    /** Destination endpoint; omit when useAnimatedValue supplies the target. See {@link PibblSpringOptions}. */
+    readonly to?: number;
     /** Mass used by the spring or physics calculation. See {@link PibblSpringOptions}. */
     readonly mass?: number;
     /** Spring stiffness controlling acceleration toward the target. See {@link PibblSpringOptions}. */
@@ -155,79 +153,37 @@ export interface PibblSpringOptions {
     readonly debugName?: string;
 }
 /**
- * Target-driven tween configuration for an animated value hook.
- *
- * @see {@link PibblEasing}
- * @see {@link PibblInterpolator}
- * @see {@link SignalEquals}
+ * Current endpoints and optional committed spring velocity supplied to an animation factory.
+ * @see {@link PibblAnimatedValueOptions}
  */
-export interface PibblTweenAnimatedValueOptions<T> {
-    /** The literal "tween" identifying this variant. See {@link PibblTweenAnimatedValueOptions}. */
-    readonly type: 'tween';
-    /**
-     * Duration of the animation or transition in milliseconds. See
-     * {@link PibblTweenAnimatedValueOptions}.
-     */
-    readonly duration: number;
-    /** Maps normalized progress before interpolation. See {@link PibblEasing}. */
-    readonly easing?: PibblEasing;
-    /**
-     * Produces a value between two endpoints at the supplied progress. See {@link PibblInterpolator}.
-     */
-    readonly interpolate?: PibblInterpolator<T>;
-    /**
-     * Compares old and new values to suppress equivalent updates. See
-     * {@link PibblTweenAnimatedValueOptions}.
-     */
-    readonly equals?: import('../signals/types.js').SignalEquals<T>;
-    /** Initial animated value used when the hook mounts. See {@link PibblTweenAnimatedValueOptions}. */
-    readonly initial?: T;
-    /** Optional label used in diagnostics. See {@link PibblTweenAnimatedValueOptions}. */
-    readonly debugName?: string;
+export interface PibblAnimationTarget<T> {
+    /** Last presented value, or the explicit mount initial value. See {@link useAnimatedValue}. */
+    readonly from: T;
+    /** Latest requested target. See {@link useAnimatedValue}. */
+    readonly to: T;
+    /** Committed analytic spring velocity, when the previous run is a spring. See {@link spring}. */
+    readonly velocity?: number;
 }
 /**
- * Target-driven spring configuration for an animated value hook.
- *
+ * Definition-based target animation with mount-owned equality and initial presentation.
  * @see {@link useAnimatedValue}
- * @see {@link SignalEquals}
+ * @see {@link PibblAnimationDefinition}
  */
-export interface PibblSpringAnimatedValueOptions {
-    /** The literal "spring" identifying this variant. See {@link PibblSpringAnimatedValueOptions}. */
-    readonly type: 'spring';
-    /** Mass used by the spring or physics calculation. See {@link PibblSpringAnimatedValueOptions}. */
-    readonly mass?: number;
-    /**
-     * Spring stiffness controlling acceleration toward the target. See
-     * {@link PibblSpringAnimatedValueOptions}.
-     */
-    readonly stiffness?: number;
-    /** Spring damping controlling the loss of velocity. See {@link PibblSpringAnimatedValueOptions}. */
-    readonly damping?: number;
-    /** Starting velocity of the spring. See {@link PibblSpringAnimatedValueOptions}. */
-    readonly initialVelocity?: number;
-    /**
-     * Velocity threshold used to determine when the spring has settled. See
-     * {@link PibblSpringAnimatedValueOptions}.
-     */
-    readonly restSpeed?: number;
-    /**
-     * Distance-from-target threshold used to determine when the spring has settled. See
-     * {@link PibblSpringAnimatedValueOptions}.
-     */
-    readonly restDelta?: number;
+export interface PibblAnimatedValueOptions<T> {
     /**
-     * Maximum duration allowed before the spring is forced to complete. See
-     * {@link PibblSpringAnimatedValueOptions}.
+     * Immutable definition or pure factory receiving the hook-owned endpoints. Factories run
+     * synchronously during render and cannot write signals or call hooks.
+     * @see {@link PibblAnimationTarget}
+     * @see {@link PibblAnimationDefinition}
+     * @param target - Current endpoints and previous spring velocity. See {@link PibblAnimationTarget}.
+     * @returns A concrete animation definition. See {@link PibblAnimationDefinition}.
      */
-    readonly maxDuration?: number;
-    /**
-     * Compares old and new values to suppress equivalent updates. See
-     * {@link PibblSpringAnimatedValueOptions}.
-     */
-    readonly equals?: import('../signals/types.js').SignalEquals<number>;
-    /** Initial animated value used when the hook mounts. See {@link PibblSpringAnimatedValueOptions}. */
-    readonly initial?: number;
-    /** Optional label used in diagnostics. See {@link PibblSpringAnimatedValueOptions}. */
+    readonly animation: PibblAnimationDefinition<T> | ((target: PibblAnimationTarget<T>) => PibblAnimationDefinition<T>);
+    /** Comparison used to suppress equal targets. See {@link SignalEquals}. */
+    readonly equals?: SignalEquals<T>;
+    /** Initial presented value; omitted initial values present the target without entrance motion. See {@link useAnimatedValue}. */
+    readonly initial?: T;
+    /** Optional playback diagnostic label. See {@link useAnimatedValue}. */
     readonly debugName?: string;
 }
 /**

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": "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",
-  "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": []
 }

package/package.json

@@ -1,17 +1,17 @@
 {
   "name": "@pibbl/core",
   "type": "module",
-  "version": "0.0.1",
+  "version": "0.0.2",
   "description": "Canvas 2D component runtime with JSX and createElement authoring",
   "author": "Ben Lesh <ben@benlesh.com>",
   "license": "MIT",
-  "homepage": "https://github.com/benlesh/crc",
+  "homepage": "https://github.com/benlesh/pibbl",
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/benlesh/crc.git",
+    "url": "git+https://github.com/benlesh/pibbl.git",
     "directory": "packages/core"
   },
-  "bugs": "https://github.com/benlesh/crc/issues",
+  "bugs": "https://github.com/benlesh/pibbl/issues",
   "keywords": [
     "canvas",
     "jsx",
@@ -78,6 +78,14 @@
     "./sprites/formats/texture-packer": {
       "types": "./dist/features/sprites/formats/texture-packer.d.ts",
       "default": "./dist/features/sprites/formats/texture-packer.mjs"
+    },
+    "./machines": {
+      "types": "./dist/features/machines/index.d.ts",
+      "default": "./dist/features/machines/index.mjs"
+    },
+    "./machines/animation": {
+      "types": "./dist/features/machines/animation.d.ts",
+      "default": "./dist/features/machines/animation.mjs"
     }
   },
   "main": "./dist/index.mjs",
@@ -130,6 +138,12 @@
       ],
       "sprites/formats/texture-packer": [
         "./dist/features/sprites/formats/texture-packer.d.ts"
+      ],
+      "machines": [
+        "./dist/features/machines/index.d.ts"
+      ],
+      "machines/animation": [
+        "./dist/features/machines/animation.d.ts"
       ]
     }
   },

package/dist/features/viz/lib/scale.d.ts

@@ -1,11 +0,0 @@
-import type { ScaleProps } from "./types.js";
-/**
- * Declares a named linear or band scale in the current layout for descendant visualization
- * components.
- *
- * @param props - Scale identity, domain, range, and child content. See {@link ScaleProps}.
- * @returns The scale's child content with the scale registered for descendants.
- *
- * @see {@link ScaleProps}
- */
-export declare function Scale(props: ScaleProps): import("@pibbl/core").PibblNode;

package/dist/features/viz/lib/scale.js

@@ -1,80 +0,0 @@
-import { resolveSignalValue, useComputed, useLayoutBox } from "@pibbl/core";
-import { equalScale, resolveLinearScale } from "./linear-scale.js";
-import { resolveBandScale } from "./band-scale.js";
-import { captureScaleLookup, provideScale } from "./scale-context.js";
-function Scale(props) {
-  if ((typeof props.id !== "string" || props.id.length === 0) && typeof props.id !== "symbol")
-    throw new TypeError("Scale id requires a nonempty string or symbol.");
-  if (props.type !== "linear" && props.type !== "band")
-    throw new TypeError(`Scale supports type="linear" or type="band".`);
-  const { width, height } = useLayoutBox();
-  const lookup = captureScaleLookup("Scale bandwidthOf");
-  function resolveParent() {
-    const range = resolveSignalValue(props.range);
-    if (props.type !== "band" || typeof range !== "object" || range === null || !("bandwidthOf" in range))
-      return void 0;
-    const parent2 = lookup(range.bandwidthOf, "band")?.get();
-    if (!parent2 || parent2.type !== "band")
-      throw new TypeError("Scale bandwidthOf requires an ancestor band scale.");
-    return parent2;
-  }
-  const parent = useComputed(resolveParent, [
-    props.type,
-    props.range,
-    lookup
-  ]).get();
-  function resolvedRange() {
-    const currentParent = resolveParent();
-    return currentParent ? [0, currentParent.bandwidth] : resolveSignalValue(props.range);
-  }
-  const dependencies = [
-    parent,
-    props.type,
-    props.domain,
-    props.range,
-    props.reverse,
-    props.type === "band" ? props.paddingInner : void 0,
-    props.type === "band" ? props.paddingOuter : void 0,
-    width,
-    height
-  ];
-  const value = useComputed(
-    () => props.type === "band" ? resolveBandScale(
-      resolveSignalValue(props.domain),
-      resolvedRange(),
-      resolveSignalValue(props.reverse ?? false),
-      width,
-      height,
-      resolveSignalValue(props.paddingInner ?? 0),
-      resolveSignalValue(props.paddingOuter ?? 0)
-    ) : resolveLinearScale(
-      resolveSignalValue(props.domain),
-      resolvedRange(),
-      resolveSignalValue(props.reverse ?? false),
-      width,
-      height
-    ),
-    dependencies,
-    { equals: equalScale }
-  );
-  const linear = useComputed(() => {
-    const resolved = value.get();
-    if (resolved.type !== "linear")
-      throw new TypeError(
-        'useScale requires type=linear; use useScale(id, "band") for band scales.'
-      );
-    return resolved;
-  }, dependencies);
-  const band = useComputed(() => {
-    const resolved = value.get();
-    if (resolved.type !== "band")
-      throw new TypeError("useScale requires type=band.");
-    return resolved;
-  }, dependencies);
-  provideScale(props.id, value, linear, band);
-  return props.children;
-}
-export {
-  Scale
-};
-//# sourceMappingURL=scale.js.map

package/dist/features/viz/lib/scale.js.map

@@ -1,7 +0,0 @@
-{
-  "version": 3,
-  "sources": ["../../../../src/features/viz/lib/scale.ts"],
-  "sourcesContent": ["import { resolveSignalValue, useComputed, useLayoutBox } from \"@pibbl/core\";\nimport type { ScaleProps, ScaleRange } from \"./types.js\";\nimport { equalScale, resolveLinearScale } from \"./linear-scale.js\";\nimport { resolveBandScale } from \"./band-scale.js\";\nimport { captureScaleLookup, provideScale } from \"./scale-context.js\";\n/**\n * Declares a named linear or band scale in the current layout for descendant visualization\n * components.\n *\n * @param props - Scale identity, domain, range, and child content. See {@link ScaleProps}.\n * @returns The scale's child content with the scale registered for descendants.\n *\n * @see {@link ScaleProps}\n */\nexport function Scale(props: ScaleProps) {\n  if (\n    (typeof props.id !== \"string\" || props.id.length === 0) &&\n    typeof props.id !== \"symbol\"\n  )\n    throw new TypeError(\"Scale id requires a nonempty string or symbol.\");\n  if (props.type !== \"linear\" && props.type !== \"band\")\n    throw new TypeError(`Scale supports type=\"linear\" or type=\"band\".`);\n  const { width, height } = useLayoutBox();\n  const lookup = captureScaleLookup(\"Scale bandwidthOf\");\n  function resolveParent() {\n    const range = resolveSignalValue(props.range);\n    if (\n      props.type !== \"band\" ||\n      typeof range !== \"object\" ||\n      range === null ||\n      !(\"bandwidthOf\" in range)\n    )\n      return undefined;\n    const parent = lookup(range.bandwidthOf, \"band\")?.get();\n    if (!parent || parent.type !== \"band\")\n      throw new TypeError(\"Scale bandwidthOf requires an ancestor band scale.\");\n    return parent;\n  }\n  // This snapshot admits allocation changes into the current render transaction.\n  // The formula also reads the live ancestor, preserving synchronous signal reads.\n  const parent = useComputed(resolveParent, [\n    props.type,\n    props.range,\n    lookup,\n  ]).get();\n  function resolvedRange(): ScaleRange {\n    const currentParent = resolveParent();\n    return currentParent\n      ? [0, currentParent.bandwidth]\n      : (resolveSignalValue(props.range) as ScaleRange);\n  }\n  const dependencies = [\n    parent,\n    props.type,\n    props.domain,\n    props.range,\n    props.reverse,\n    props.type === \"band\" ? props.paddingInner : undefined,\n    props.type === \"band\" ? props.paddingOuter : undefined,\n    width,\n    height,\n  ];\n  const value = useComputed(\n    () =>\n      props.type === \"band\"\n        ? resolveBandScale(\n            resolveSignalValue(props.domain),\n            resolvedRange(),\n            resolveSignalValue(props.reverse ?? false),\n            width,\n            height,\n            resolveSignalValue(props.paddingInner ?? 0),\n            resolveSignalValue(props.paddingOuter ?? 0),\n          )\n        : resolveLinearScale(\n            resolveSignalValue(props.domain),\n            resolvedRange(),\n            resolveSignalValue(props.reverse ?? false),\n            width,\n            height,\n          ),\n    dependencies,\n    { equals: equalScale },\n  );\n  const linear = useComputed(() => {\n    const resolved = value.get();\n    if (resolved.type !== \"linear\")\n      throw new TypeError(\n        'useScale requires type=linear; use useScale(id, \"band\") for band scales.',\n      );\n    return resolved;\n  }, dependencies);\n  const band = useComputed(() => {\n    const resolved = value.get();\n    if (resolved.type !== \"band\")\n      throw new TypeError(\"useScale requires type=band.\");\n    return resolved;\n  }, dependencies);\n  provideScale(props.id, value, linear, band);\n  return props.children;\n}\n"],
-  "mappings": "AAAA,SAAS,oBAAoB,aAAa,oBAAoB;AAE9D,SAAS,YAAY,0BAA0B;AAC/C,SAAS,wBAAwB;AACjC,SAAS,oBAAoB,oBAAoB;AAU1C,SAAS,MAAM,OAAmB;AACvC,OACG,OAAO,MAAM,OAAO,YAAY,MAAM,GAAG,WAAW,MACrD,OAAO,MAAM,OAAO;AAEpB,UAAM,IAAI,UAAU,gDAAgD;AACtE,MAAI,MAAM,SAAS,YAAY,MAAM,SAAS;AAC5C,UAAM,IAAI,UAAU,8CAA8C;AACpE,QAAM,EAAE,OAAO,OAAO,IAAI,aAAa;AACvC,QAAM,SAAS,mBAAmB,mBAAmB;AACrD,WAAS,gBAAgB;AACvB,UAAM,QAAQ,mBAAmB,MAAM,KAAK;AAC5C,QACE,MAAM,SAAS,UACf,OAAO,UAAU,YACjB,UAAU,QACV,EAAE,iBAAiB;AAEnB,aAAO;AACT,UAAMA,UAAS,OAAO,MAAM,aAAa,MAAM,GAAG,IAAI;AACtD,QAAI,CAACA,WAAUA,QAAO,SAAS;AAC7B,YAAM,IAAI,UAAU,oDAAoD;AAC1E,WAAOA;AAAA,EACT;AAGA,QAAM,SAAS,YAAY,eAAe;AAAA,IACxC,MAAM;AAAA,IACN,MAAM;AAAA,IACN;AAAA,EACF,CAAC,EAAE,IAAI;AACP,WAAS,gBAA4B;AACnC,UAAM,gBAAgB,cAAc;AACpC,WAAO,gBACH,CAAC,GAAG,cAAc,SAAS,IAC1B,mBAAmB,MAAM,KAAK;AAAA,EACrC;AACA,QAAM,eAAe;AAAA,IACnB;AAAA,IACA,MAAM;AAAA,IACN,MAAM;AAAA,IACN,MAAM;AAAA,IACN,MAAM;AAAA,IACN,MAAM,SAAS,SAAS,MAAM,eAAe;AAAA,IAC7C,MAAM,SAAS,SAAS,MAAM,eAAe;AAAA,IAC7C;AAAA,IACA;AAAA,EACF;AACA,QAAM,QAAQ;AAAA,IACZ,MACE,MAAM,SAAS,SACX;AAAA,MACE,mBAAmB,MAAM,MAAM;AAAA,MAC/B,cAAc;AAAA,MACd,mBAAmB,MAAM,WAAW,KAAK;AAAA,MACzC;AAAA,MACA;AAAA,MACA,mBAAmB,MAAM,gBAAgB,CAAC;AAAA,MAC1C,mBAAmB,MAAM,gBAAgB,CAAC;AAAA,IAC5C,IACA;AAAA,MACE,mBAAmB,MAAM,MAAM;AAAA,MAC/B,cAAc;AAAA,MACd,mBAAmB,MAAM,WAAW,KAAK;AAAA,MACzC;AAAA,MACA;AAAA,IACF;AAAA,IACN;AAAA,IACA,EAAE,QAAQ,WAAW;AAAA,EACvB;AACA,QAAM,SAAS,YAAY,MAAM;AAC/B,UAAM,WAAW,MAAM,IAAI;AAC3B,QAAI,SAAS,SAAS;AACpB,YAAM,IAAI;AAAA,QACR;AAAA,MACF;AACF,WAAO;AAAA,EACT,GAAG,YAAY;AACf,QAAM,OAAO,YAAY,MAAM;AAC7B,UAAM,WAAW,MAAM,IAAI;AAC3B,QAAI,SAAS,SAAS;AACpB,YAAM,IAAI,UAAU,8BAA8B;AACpD,WAAO;AAAA,EACT,GAAG,YAAY;AACf,eAAa,MAAM,IAAI,OAAO,QAAQ,IAAI;AAC1C,SAAO,MAAM;AACf;",
-  "names": ["parent"]
-}