@weasel-js/core 1.10.1 → 1.11.0

package/dist/animation/poseHelpers.js

@@ -1,129 +1,169 @@
-import { RECT_POSE_DESCRIPTOR as e } from "../core/geometry/poseDescriptor.js";
-import { createTransformOp as t } from "../core/ops/transform.js";
-import { rewindingSpring as n, rewindingTween as r } from "./rewind.js";
+import { RECT_POSE_DESCRIPTOR } from "../core/geometry/poseDescriptor.js";
+import { createTransformOp } from "../core/ops/transform.js";
+import { rewindingSpring, rewindingTween } from "./rewind.js";
+
 //#region src/animation/poseHelpers.ts
-var i = (e) => `pose:${e}`;
-function a(e, n, r, i, a) {
-	if (!e.applyOps) return;
-	let o = t({
-		id: n,
-		from: r,
-		to: i,
-		label: a
+/** The cancel key every move of node `id`'s pose shares. */
+var poseKey = (id) => `pose:${id}`;
+function recordTransformOp(adapter, id, from, to, label) {
+	if (!adapter.applyOps) return;
+	const op = createTransformOp({
+		id,
+		from,
+		to,
+		label
 	});
-	e.applyOps([o], a);
+	adapter.applyOps([op], label);
 }
-function o(t, n, o) {
-	let s = o.recordOp ?? !0, c = o.opLabel ?? "animate", l = i(o.id), u = n.poseTarget?.(o.id, o.geometry);
-	if (u) {
-		let e = u.committed();
-		s && a(n, o.id, e, o.to, c);
-		let i = o.geometry?.lerp;
-		return o.rewind ? r(t, u, {
-			start: e,
-			from: o.from ?? e,
-			to: o.to,
-			ms: o.ms,
-			easing: o.easing,
-			cancelKey: l,
-			interpolate: i && ((e, t, n) => i(e, t, n)),
-			onDone: o.onDone
-		}) : t.tween({
-			target: u,
-			from: o.from ?? e,
-			to: o.to,
-			ms: o.ms,
-			easing: o.easing,
-			cancelKey: l,
-			interrupt: !1,
-			interpolate: i && ((e, t, n) => i(e, t, n)),
-			onDone: o.onDone
+/**
+* Animate one node's pose to `to` over `ms`.
+*
+* On an adapter with `poseTarget`, the destination is committed as the move starts. A
+* scene-backed adapter shows the travel through the scene's pose overrides, so the document
+* holds `to` throughout and nothing is written per frame; a store with no overrides, behind
+* `createWrittenPoseTarget`, is written the pose on screen each frame and `to` as the move ends. Moves on one node add: a
+* second `tweenPose` bends the first toward its own destination and cancels nothing. They share
+* the key `pose:<id>` for `cancelKey`, `pauseKey`, and `isActive`.
+*
+* By default one transform op covering the whole move is recorded up front, so one undo
+* returns the node to where it started. Undone mid-flight, the node comes to rest on the
+* undone pose, or with `rewind` travels back to it.
+*
+* An adapter without `poseTarget`, and a pose its descriptor gives no axes for, keep the older
+* behavior: `setPose` is written each frame, and a new move on the node cancels the one running.
+*/
+function tweenPose(animator, adapter, opts) {
+	const recordOp = opts.recordOp ?? true;
+	const label = opts.opLabel ?? "animate";
+	const cancelKey = poseKey(opts.id);
+	const target = adapter.poseTarget?.(opts.id, opts.geometry);
+	if (target) {
+		const committed = target.committed();
+		if (recordOp) recordTransformOp(adapter, opts.id, committed, opts.to, label);
+		const lerp = opts.geometry?.lerp;
+		if (opts.rewind) return rewindingTween(animator, target, {
+			start: committed,
+			from: opts.from ?? committed,
+			to: opts.to,
+			ms: opts.ms,
+			easing: opts.easing,
+			cancelKey,
+			interpolate: lerp && ((a, b, t) => lerp(a, b, t)),
+			onDone: opts.onDone
+		});
+		return animator.tween({
+			target,
+			from: opts.from ?? committed,
+			to: opts.to,
+			ms: opts.ms,
+			easing: opts.easing,
+			cancelKey,
+			interrupt: false,
+			interpolate: lerp && ((a, b, t) => lerp(a, b, t)),
+			onDone: opts.onDone
 		});
 	}
-	let d = o.geometry ?? e;
-	if (!d.lerp) throw Error("tweenPose: geometry has no lerp; supply geometry: { ..., lerp }");
-	let f = d.lerp, p = n.getPose(o.id);
-	return s && a(n, o.id, p, o.to, c), t.tween({
-		from: o.from ?? p,
-		to: o.to,
-		ms: o.ms,
-		easing: o.easing,
-		cancelKey: l,
-		interpolate: (e, t, n) => f(e, t, n),
-		onTick: (e) => n.setPose(o.id, e),
-		onDone: o.onDone
+	const geometry = opts.geometry ?? RECT_POSE_DESCRIPTOR;
+	if (!geometry.lerp) throw new Error("tweenPose: geometry has no lerp; supply geometry: { ..., lerp }");
+	const lerp = geometry.lerp;
+	const from = adapter.getPose(opts.id);
+	if (recordOp) recordTransformOp(adapter, opts.id, from, opts.to, label);
+	return animator.tween({
+		from: opts.from ?? from,
+		to: opts.to,
+		ms: opts.ms,
+		easing: opts.easing,
+		cancelKey,
+		interpolate: (a, b, t) => lerp(a, b, t),
+		onTick: (value) => adapter.setPose(opts.id, value),
+		onDone: opts.onDone
 	});
 }
-function s(t, r, o) {
-	let s = o.recordOp ?? !0, c = o.opLabel ?? "animate", l = i(o.id), u = r.poseTarget?.(o.id, o.geometry);
-	if (u) {
-		let e = u.read(), i = u.committed();
-		return s && a(r, o.id, i, o.to, c), o.rewind ? n(t, u, {
-			start: i,
-			from: e,
-			to: o.to,
-			cancelKey: l,
-			onDone: o.onDone,
+/**
+* `tweenPose` driven by a spring instead of a duration, with the same op recording.
+*
+* On an adapter with `poseTarget` it interrupts every move under `pose:<id>` and starts at
+* their velocity, from the pose on screen. Otherwise it falls back as `tweenPose` does.
+*/
+function springPose(animator, adapter, opts) {
+	const recordOp = opts.recordOp ?? true;
+	const label = opts.opLabel ?? "animate";
+	const cancelKey = poseKey(opts.id);
+	const target = adapter.poseTarget?.(opts.id, opts.geometry);
+	if (target) {
+		const shown = target.read();
+		const committed = target.committed();
+		if (recordOp) recordTransformOp(adapter, opts.id, committed, opts.to, label);
+		if (opts.rewind) return rewindingSpring(animator, target, {
+			start: committed,
+			from: shown,
+			to: opts.to,
+			cancelKey,
+			onDone: opts.onDone,
 			tuning: {
-				preset: o.preset,
-				stiffness: o.stiffness,
-				damping: o.damping,
-				mass: o.mass
+				preset: opts.preset,
+				stiffness: opts.stiffness,
+				damping: opts.damping,
+				mass: opts.mass
 			}
-		}) : t.spring({
-			target: u,
-			from: e,
-			to: o.to,
-			preset: o.preset,
-			stiffness: o.stiffness,
-			damping: o.damping,
-			mass: o.mass,
-			cancelKey: l,
-			onDone: o.onDone
+		});
+		return animator.spring({
+			target,
+			from: shown,
+			to: opts.to,
+			preset: opts.preset,
+			stiffness: opts.stiffness,
+			damping: opts.damping,
+			mass: opts.mass,
+			cancelKey,
+			onDone: opts.onDone
 		});
 	}
-	let d = o.geometry ?? e;
-	if (!d.lerp) throw Error("springPose: geometry has no lerp; supply geometry: { ..., lerp }");
-	let f = d.lerp, p = r.getPose(o.id);
-	return s && a(r, o.id, p, o.to, c), t.spring({
+	const geometry = opts.geometry ?? RECT_POSE_DESCRIPTOR;
+	if (!geometry.lerp) throw new Error("springPose: geometry has no lerp; supply geometry: { ..., lerp }");
+	const lerp = geometry.lerp;
+	const from = adapter.getPose(opts.id);
+	if (recordOp) recordTransformOp(adapter, opts.id, from, opts.to, label);
+	return animator.spring({
 		from: 0,
 		to: 1,
-		preset: o.preset,
-		stiffness: o.stiffness,
-		damping: o.damping,
-		mass: o.mass,
-		cancelKey: l,
-		interpolate: (e, t, n) => e + (t - e) * n,
-		onTick: (e) => r.setPose(o.id, f(p, o.to, e)),
-		onDone: o.onDone
+		preset: opts.preset,
+		stiffness: opts.stiffness,
+		damping: opts.damping,
+		mass: opts.mass,
+		cancelKey,
+		interpolate: (a, b, t) => a + (b - a) * t,
+		onTick: (progress) => adapter.setPose(opts.id, lerp(from, opts.to, progress)),
+		onDone: opts.onDone
 	});
 }
-function c(e) {
-	if (typeof e == "object" && e && "id" in e) {
-		let t = e.id;
-		if (typeof t == "string") return t;
+function itemId(item) {
+	if (item != null && typeof item === "object" && "id" in item) {
+		const id = item.id;
+		if (typeof id === "string") return id;
 	}
-	if (typeof e == "string" || typeof e == "number") return String(e);
-	throw Error("staggerSpringPose: each item must either be a primitive (string/number) or have a string `id` field. Otherwise pose ids would collide.");
+	if (typeof item === "string" || typeof item === "number") return String(item);
+	throw new Error("staggerSpringPose: each item must either be a primitive (string/number) or have a string `id` field. Otherwise pose ids would collide.");
 }
-function l(e, t, n) {
-	return e.stagger(n.items, n.delay).each((r, i) => s(e, t, {
-		id: c(r),
-		to: n.to(r, i),
-		preset: n.preset,
-		stiffness: n.stiffness,
-		damping: n.damping,
-		mass: n.mass,
-		geometry: n.geometry,
-		recordOp: n.recordOp,
-		opLabel: n.opLabel,
-		rewind: n.rewind
+/** `springPose` for each of `items`, started `delay` apart as `animator.stagger` counts it. */
+function staggerSpringPose(animator, adapter, opts) {
+	return animator.stagger(opts.items, opts.delay).each((item, i) => springPose(animator, adapter, {
+		id: itemId(item),
+		to: opts.to(item, i),
+		preset: opts.preset,
+		stiffness: opts.stiffness,
+		damping: opts.damping,
+		mass: opts.mass,
+		geometry: opts.geometry,
+		recordOp: opts.recordOp,
+		opLabel: opts.opLabel,
+		rewind: opts.rewind
 	}), {
-		cancelKey: n.cancelKey,
-		label: n.label
+		cancelKey: opts.cancelKey,
+		label: opts.label
 	});
 }
-//#endregion
-export { i as poseKey, s as springPose, l as staggerSpringPose, o as tweenPose };
 
+//#endregion
+export { poseKey, springPose, staggerSpringPose, tweenPose };
 //# sourceMappingURL=poseHelpers.js.map

package/dist/animation/poseHelpers.js.map

@@ -1 +1 @@
-{"version":3,"file":"poseHelpers.js","names":["poseKey","id","recordTransformOp","adapter","op","createTransformOp","label","tweenPose","recordOp","opts","cancelKey","target","committed","lerp","rewindingTween","animator","a","b","t","geometry","RECT_POSE_DESCRIPTOR","from","value","springPose","shown","rewindingSpring","progress","itemId","item","staggerSpringPose"],"sources":["../../src/animation/poseHelpers.ts"],"sourcesContent":["import { createTransformOp } from 'core/ops/transform';\nimport { RECT_POSE_DESCRIPTOR, type PoseDescriptor } from 'interactions/actions/resize/geometry';\nimport type { Op } from 'core/ops/types';\nimport type {\n  AnimationHandle, Animator, EasingSpec, SpringPresetName, StaggerDelay, StaggerOptions,\n} from '@weasel-js/animator';\nimport type { Target } from '@weasel-js/animator';\nimport { rewindingSpring, rewindingTween } from './rewind';\n\n/** The part of an adapter `tweenPose` and `springPose` use. The adapter `sceneToAdapter` and\n *  `useSceneAdapter` build is one. */\nexport interface PoseAnimationAdapter<TPose> {\n  getPose(id: string): TPose;\n  setPose(id: string, pose: TPose): void;\n  applyOps?(ops: Op[], label: string): void;\n  /** See `MoveAdapter.poseTarget`. */\n  poseTarget?(id: string, descriptor?: PoseDescriptor<TPose>): Target<TPose> | undefined;\n}\n\n/** Options for `tweenPose`. */\nexport interface TweenPoseOptions<TPose> {\n  id: string;\n  to: TPose;\n  /** Where the move appears to start. Default: where the node is. Nothing is written there. */\n  from?: TPose;\n  ms: number;\n  easing?: EasingSpec;\n  /** Supplies the pose's axes, and its `lerp` is the path the move follows. Without one the\n   *  adapter's own descriptor maps the pose and each axis travels in a straight line. */\n  geometry?: PoseDescriptor<TPose>;\n  /** When true (default), emit a transform op before the tween so undo\n   *  restores the pre-animation pose. */\n  recordOp?: boolean;\n  /** Label for the recorded op. Default: `'animate'`. */\n  opLabel?: string;\n  /**\n   * When true, a move undone mid-flight travels back to where it began, and one redone\n   * mid-way back turns forward again, where by default the node comes to rest on the written\n   * pose at once. `onDone` is called only when the move arrives at `to`. Needs an adapter with\n   * `poseTarget`. Default false.\n   */\n  rewind?: boolean;\n  onDone?: () => void;\n}\n\n/** Options for `springPose`. */\nexport interface SpringPoseOptions<TPose> {\n  id: string;\n  to: TPose;\n  preset?: SpringPresetName;\n  stiffness?: number;\n  damping?: number;\n  mass?: number;\n  geometry?: PoseDescriptor<TPose>;\n  recordOp?: boolean;\n  opLabel?: string;\n  /** As `TweenPoseOptions.rewind`: undone mid-flight, it springs back to where it began from\n   *  where it is, at the speed it has. */\n  rewind?: boolean;\n  onDone?: () => void;\n}\n\n/** The cancel key every move of node `id`'s pose shares. */\nexport const poseKey = (id: string): string => `pose:${id}`;\n\nfunction recordTransformOp<TPose>(\n  adapter: PoseAnimationAdapter<TPose>,\n  id: string,\n  from: TPose,\n  to: TPose,\n  label: string,\n): void {\n  if (!adapter.applyOps) return;\n  const op = createTransformOp<TPose>({ id, from, to, label });\n  adapter.applyOps([op], label);\n}\n\n/**\n * Animate one node's pose to `to` over `ms`.\n *\n * On an adapter with `poseTarget`, the destination is committed as the move starts. A\n * scene-backed adapter shows the travel through the scene's pose overrides, so the document\n * holds `to` throughout and nothing is written per frame; a store with no overrides, behind\n * `createWrittenPoseTarget`, is written the pose on screen each frame and `to` as the move ends. Moves on one node add: a\n * second `tweenPose` bends the first toward its own destination and cancels nothing. They share\n * the key `pose:<id>` for `cancelKey`, `pauseKey`, and `isActive`.\n *\n * By default one transform op covering the whole move is recorded up front, so one undo\n * returns the node to where it started. Undone mid-flight, the node comes to rest on the\n * undone pose, or with `rewind` travels back to it.\n *\n * An adapter without `poseTarget`, and a pose its descriptor gives no axes for, keep the older\n * behavior: `setPose` is written each frame, and a new move on the node cancels the one running.\n */\nexport function tweenPose<TPose>(\n  animator: Animator,\n  adapter: PoseAnimationAdapter<TPose>,\n  opts: TweenPoseOptions<TPose>,\n): AnimationHandle {\n  const recordOp = opts.recordOp ?? true;\n  const label = opts.opLabel ?? 'animate';\n  const cancelKey = poseKey(opts.id);\n  const target = adapter.poseTarget?.(opts.id, opts.geometry);\n  if (target) {\n    const committed = target.committed();\n    if (recordOp) recordTransformOp(adapter, opts.id, committed, opts.to, label);\n    const lerp = opts.geometry?.lerp;\n    if (opts.rewind) {\n      return rewindingTween(animator, target, {\n        start: committed, from: opts.from ?? committed, to: opts.to, ms: opts.ms, easing: opts.easing,\n        cancelKey, interpolate: lerp && ((a, b, t) => lerp(a, b, t)), onDone: opts.onDone,\n      });\n    }\n    return animator.tween<TPose>({\n      target,\n      from: opts.from ?? committed,\n      to: opts.to,\n      ms: opts.ms,\n      easing: opts.easing,\n      cancelKey,\n      interrupt: false,\n      interpolate: lerp && ((a, b, t) => lerp(a, b, t)),\n      onDone: opts.onDone,\n    });\n  }\n  const geometry = (opts.geometry ?? (RECT_POSE_DESCRIPTOR as unknown as PoseDescriptor<TPose>));\n  if (!geometry.lerp) {\n    throw new Error('tweenPose: geometry has no lerp; supply geometry: { ..., lerp }');\n  }\n  const lerp = geometry.lerp;\n  const from = adapter.getPose(opts.id);\n  if (recordOp) recordTransformOp(adapter, opts.id, from, opts.to, label);\n  return animator.tween<TPose>({\n    from: opts.from ?? from,\n    to: opts.to,\n    ms: opts.ms,\n    easing: opts.easing,\n    cancelKey,\n    interpolate: (a, b, t) => lerp(a, b, t),\n    onTick: (value) => adapter.setPose(opts.id, value),\n    onDone: opts.onDone,\n  });\n}\n\n/**\n * `tweenPose` driven by a spring instead of a duration, with the same op recording.\n *\n * On an adapter with `poseTarget` it interrupts every move under `pose:<id>` and starts at\n * their velocity, from the pose on screen. Otherwise it falls back as `tweenPose` does.\n */\nexport function springPose<TPose>(\n  animator: Animator,\n  adapter: PoseAnimationAdapter<TPose>,\n  opts: SpringPoseOptions<TPose>,\n): AnimationHandle {\n  const recordOp = opts.recordOp ?? true;\n  const label = opts.opLabel ?? 'animate';\n  const cancelKey = poseKey(opts.id);\n  const target = adapter.poseTarget?.(opts.id, opts.geometry);\n  if (target) {\n    // Read ahead of the op: the spring starts from the pose on screen, wherever that commit\n    // and the interrupted moves leave the committed one.\n    const shown = target.read();\n    const committed = target.committed();\n    if (recordOp) recordTransformOp(adapter, opts.id, committed, opts.to, label);\n    if (opts.rewind) {\n      return rewindingSpring(animator, target, {\n        start: committed, from: shown, to: opts.to, cancelKey, onDone: opts.onDone,\n        tuning: { preset: opts.preset, stiffness: opts.stiffness, damping: opts.damping, mass: opts.mass },\n      });\n    }\n    return animator.spring<TPose>({\n      target,\n      from: shown,\n      to: opts.to,\n      preset: opts.preset,\n      stiffness: opts.stiffness,\n      damping: opts.damping,\n      mass: opts.mass,\n      cancelKey,\n      onDone: opts.onDone,\n    });\n  }\n  const geometry = (opts.geometry ?? (RECT_POSE_DESCRIPTOR as unknown as PoseDescriptor<TPose>));\n  if (!geometry.lerp) {\n    throw new Error('springPose: geometry has no lerp; supply geometry: { ..., lerp }');\n  }\n  const lerp = geometry.lerp;\n  const from = adapter.getPose(opts.id);\n  if (recordOp) recordTransformOp(adapter, opts.id, from, opts.to, label);\n  // The spring integrates progress from 0 to 1, and lerp makes the pose from it.\n  return animator.spring<number>({\n    from: 0,\n    to: 1,\n    preset: opts.preset,\n    stiffness: opts.stiffness,\n    damping: opts.damping,\n    mass: opts.mass,\n    cancelKey,\n    interpolate: (a, b, t) => a + (b - a) * t,\n    onTick: (progress) => adapter.setPose(opts.id, lerp(from, opts.to, progress)),\n    onDone: opts.onDone,\n  });\n}\n\n/** Options for `staggerSpringPose`: the items and their delays, each item's destination, and\n *  the spring tuning. `cancelKey` and `label` belong to the stagger as a whole; each item's\n *  spring keeps its own `pose:<id>` key. */\nexport interface StaggerSpringPoseOptions<TItem, TPose> extends StaggerOptions {\n  /** Each is a node id, or carries one in a string `id` field. */\n  items: readonly TItem[];\n  delay: StaggerDelay;\n  to: (item: TItem, index: number) => TPose;\n  preset?: SpringPresetName;\n  stiffness?: number;\n  damping?: number;\n  mass?: number;\n  geometry?: PoseDescriptor<TPose>;\n  recordOp?: boolean;\n  opLabel?: string;\n  /** As `SpringPoseOptions.rewind`, for each item's spring. */\n  rewind?: boolean;\n}\n\nfunction itemId(item: unknown): string {\n  if (item != null && typeof item === 'object' && 'id' in item) {\n    const id = (item as { id: unknown }).id;\n    if (typeof id === 'string') return id;\n  }\n  if (typeof item === 'string' || typeof item === 'number') return String(item);\n  throw new Error(\n    'staggerSpringPose: each item must either be a primitive (string/number) ' +\n      'or have a string `id` field. Otherwise pose ids would collide.',\n  );\n}\n\n/** `springPose` for each of `items`, started `delay` apart as `animator.stagger` counts it. */\nexport function staggerSpringPose<TItem, TPose>(\n  animator: Animator,\n  adapter: PoseAnimationAdapter<TPose>,\n  opts: StaggerSpringPoseOptions<TItem, TPose>,\n): AnimationHandle {\n  return animator.stagger(opts.items, opts.delay).each(\n    (item, i) =>\n      springPose(animator, adapter, {\n        id: itemId(item),\n        to: opts.to(item, i),\n        preset: opts.preset,\n        stiffness: opts.stiffness,\n        damping: opts.damping,\n        mass: opts.mass,\n        geometry: opts.geometry,\n        recordOp: opts.recordOp,\n        opLabel: opts.opLabel,\n        rewind: opts.rewind,\n      }),\n    { cancelKey: opts.cancelKey, label: opts.label },\n  );\n}\n"],"mappings":"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"}
+{"version":3,"file":"poseHelpers.js","names":[],"sources":["../../src/animation/poseHelpers.ts"],"sourcesContent":["import { createTransformOp } from 'core/ops/transform';\nimport { RECT_POSE_DESCRIPTOR, type PoseDescriptor } from 'interactions/actions/resize/geometry';\nimport type { Op } from 'core/ops/types';\nimport type {\n  AnimationHandle, Animator, EasingSpec, SpringPresetName, StaggerDelay, StaggerOptions,\n} from '@weasel-js/animator';\nimport type { Target } from '@weasel-js/animator';\nimport { rewindingSpring, rewindingTween } from './rewind';\n\n/** The part of an adapter `tweenPose` and `springPose` use. The adapter `sceneToAdapter` and\n *  `useSceneAdapter` build is one. */\nexport interface PoseAnimationAdapter<TPose> {\n  getPose(id: string): TPose;\n  setPose(id: string, pose: TPose): void;\n  applyOps?(ops: Op[], label: string): void;\n  /** See `MoveAdapter.poseTarget`. */\n  poseTarget?(id: string, descriptor?: PoseDescriptor<TPose>): Target<TPose> | undefined;\n}\n\n/** Options for `tweenPose`. */\nexport interface TweenPoseOptions<TPose> {\n  id: string;\n  to: TPose;\n  /** Where the move appears to start. Default: where the node is. Nothing is written there. */\n  from?: TPose;\n  ms: number;\n  easing?: EasingSpec;\n  /** Supplies the pose's axes, and its `lerp` is the path the move follows. Without one the\n   *  adapter's own descriptor maps the pose and each axis travels in a straight line. */\n  geometry?: PoseDescriptor<TPose>;\n  /** When true (default), emit a transform op before the tween so undo\n   *  restores the pre-animation pose. */\n  recordOp?: boolean;\n  /** Label for the recorded op. Default: `'animate'`. */\n  opLabel?: string;\n  /**\n   * When true, a move undone mid-flight travels back to where it began, and one redone\n   * mid-way back turns forward again, where by default the node comes to rest on the written\n   * pose at once. `onDone` is called only when the move arrives at `to`. Needs an adapter with\n   * `poseTarget`. Default false.\n   */\n  rewind?: boolean;\n  onDone?: () => void;\n}\n\n/** Options for `springPose`. */\nexport interface SpringPoseOptions<TPose> {\n  id: string;\n  to: TPose;\n  preset?: SpringPresetName;\n  stiffness?: number;\n  damping?: number;\n  mass?: number;\n  geometry?: PoseDescriptor<TPose>;\n  recordOp?: boolean;\n  opLabel?: string;\n  /** As `TweenPoseOptions.rewind`: undone mid-flight, it springs back to where it began from\n   *  where it is, at the speed it has. */\n  rewind?: boolean;\n  onDone?: () => void;\n}\n\n/** The cancel key every move of node `id`'s pose shares. */\nexport const poseKey = (id: string): string => `pose:${id}`;\n\nfunction recordTransformOp<TPose>(\n  adapter: PoseAnimationAdapter<TPose>,\n  id: string,\n  from: TPose,\n  to: TPose,\n  label: string,\n): void {\n  if (!adapter.applyOps) return;\n  const op = createTransformOp<TPose>({ id, from, to, label });\n  adapter.applyOps([op], label);\n}\n\n/**\n * Animate one node's pose to `to` over `ms`.\n *\n * On an adapter with `poseTarget`, the destination is committed as the move starts. A\n * scene-backed adapter shows the travel through the scene's pose overrides, so the document\n * holds `to` throughout and nothing is written per frame; a store with no overrides, behind\n * `createWrittenPoseTarget`, is written the pose on screen each frame and `to` as the move ends. Moves on one node add: a\n * second `tweenPose` bends the first toward its own destination and cancels nothing. They share\n * the key `pose:<id>` for `cancelKey`, `pauseKey`, and `isActive`.\n *\n * By default one transform op covering the whole move is recorded up front, so one undo\n * returns the node to where it started. Undone mid-flight, the node comes to rest on the\n * undone pose, or with `rewind` travels back to it.\n *\n * An adapter without `poseTarget`, and a pose its descriptor gives no axes for, keep the older\n * behavior: `setPose` is written each frame, and a new move on the node cancels the one running.\n */\nexport function tweenPose<TPose>(\n  animator: Animator,\n  adapter: PoseAnimationAdapter<TPose>,\n  opts: TweenPoseOptions<TPose>,\n): AnimationHandle {\n  const recordOp = opts.recordOp ?? true;\n  const label = opts.opLabel ?? 'animate';\n  const cancelKey = poseKey(opts.id);\n  const target = adapter.poseTarget?.(opts.id, opts.geometry);\n  if (target) {\n    const committed = target.committed();\n    if (recordOp) recordTransformOp(adapter, opts.id, committed, opts.to, label);\n    const lerp = opts.geometry?.lerp;\n    if (opts.rewind) {\n      return rewindingTween(animator, target, {\n        start: committed, from: opts.from ?? committed, to: opts.to, ms: opts.ms, easing: opts.easing,\n        cancelKey, interpolate: lerp && ((a, b, t) => lerp(a, b, t)), onDone: opts.onDone,\n      });\n    }\n    return animator.tween<TPose>({\n      target,\n      from: opts.from ?? committed,\n      to: opts.to,\n      ms: opts.ms,\n      easing: opts.easing,\n      cancelKey,\n      interrupt: false,\n      interpolate: lerp && ((a, b, t) => lerp(a, b, t)),\n      onDone: opts.onDone,\n    });\n  }\n  const geometry = (opts.geometry ?? (RECT_POSE_DESCRIPTOR as unknown as PoseDescriptor<TPose>));\n  if (!geometry.lerp) {\n    throw new Error('tweenPose: geometry has no lerp; supply geometry: { ..., lerp }');\n  }\n  const lerp = geometry.lerp;\n  const from = adapter.getPose(opts.id);\n  if (recordOp) recordTransformOp(adapter, opts.id, from, opts.to, label);\n  return animator.tween<TPose>({\n    from: opts.from ?? from,\n    to: opts.to,\n    ms: opts.ms,\n    easing: opts.easing,\n    cancelKey,\n    interpolate: (a, b, t) => lerp(a, b, t),\n    onTick: (value) => adapter.setPose(opts.id, value),\n    onDone: opts.onDone,\n  });\n}\n\n/**\n * `tweenPose` driven by a spring instead of a duration, with the same op recording.\n *\n * On an adapter with `poseTarget` it interrupts every move under `pose:<id>` and starts at\n * their velocity, from the pose on screen. Otherwise it falls back as `tweenPose` does.\n */\nexport function springPose<TPose>(\n  animator: Animator,\n  adapter: PoseAnimationAdapter<TPose>,\n  opts: SpringPoseOptions<TPose>,\n): AnimationHandle {\n  const recordOp = opts.recordOp ?? true;\n  const label = opts.opLabel ?? 'animate';\n  const cancelKey = poseKey(opts.id);\n  const target = adapter.poseTarget?.(opts.id, opts.geometry);\n  if (target) {\n    // Read ahead of the op: the spring starts from the pose on screen, wherever that commit\n    // and the interrupted moves leave the committed one.\n    const shown = target.read();\n    const committed = target.committed();\n    if (recordOp) recordTransformOp(adapter, opts.id, committed, opts.to, label);\n    if (opts.rewind) {\n      return rewindingSpring(animator, target, {\n        start: committed, from: shown, to: opts.to, cancelKey, onDone: opts.onDone,\n        tuning: { preset: opts.preset, stiffness: opts.stiffness, damping: opts.damping, mass: opts.mass },\n      });\n    }\n    return animator.spring<TPose>({\n      target,\n      from: shown,\n      to: opts.to,\n      preset: opts.preset,\n      stiffness: opts.stiffness,\n      damping: opts.damping,\n      mass: opts.mass,\n      cancelKey,\n      onDone: opts.onDone,\n    });\n  }\n  const geometry = (opts.geometry ?? (RECT_POSE_DESCRIPTOR as unknown as PoseDescriptor<TPose>));\n  if (!geometry.lerp) {\n    throw new Error('springPose: geometry has no lerp; supply geometry: { ..., lerp }');\n  }\n  const lerp = geometry.lerp;\n  const from = adapter.getPose(opts.id);\n  if (recordOp) recordTransformOp(adapter, opts.id, from, opts.to, label);\n  // The spring integrates progress from 0 to 1, and lerp makes the pose from it.\n  return animator.spring<number>({\n    from: 0,\n    to: 1,\n    preset: opts.preset,\n    stiffness: opts.stiffness,\n    damping: opts.damping,\n    mass: opts.mass,\n    cancelKey,\n    interpolate: (a, b, t) => a + (b - a) * t,\n    onTick: (progress) => adapter.setPose(opts.id, lerp(from, opts.to, progress)),\n    onDone: opts.onDone,\n  });\n}\n\n/** Options for `staggerSpringPose`: the items and their delays, each item's destination, and\n *  the spring tuning. `cancelKey` and `label` belong to the stagger as a whole; each item's\n *  spring keeps its own `pose:<id>` key. */\nexport interface StaggerSpringPoseOptions<TItem, TPose> extends StaggerOptions {\n  /** Each is a node id, or carries one in a string `id` field. */\n  items: readonly TItem[];\n  delay: StaggerDelay;\n  to: (item: TItem, index: number) => TPose;\n  preset?: SpringPresetName;\n  stiffness?: number;\n  damping?: number;\n  mass?: number;\n  geometry?: PoseDescriptor<TPose>;\n  recordOp?: boolean;\n  opLabel?: string;\n  /** As `SpringPoseOptions.rewind`, for each item's spring. */\n  rewind?: boolean;\n}\n\nfunction itemId(item: unknown): string {\n  if (item != null && typeof item === 'object' && 'id' in item) {\n    const id = (item as { id: unknown }).id;\n    if (typeof id === 'string') return id;\n  }\n  if (typeof item === 'string' || typeof item === 'number') return String(item);\n  throw new Error(\n    'staggerSpringPose: each item must either be a primitive (string/number) ' +\n      'or have a string `id` field. Otherwise pose ids would collide.',\n  );\n}\n\n/** `springPose` for each of `items`, started `delay` apart as `animator.stagger` counts it. */\nexport function staggerSpringPose<TItem, TPose>(\n  animator: Animator,\n  adapter: PoseAnimationAdapter<TPose>,\n  opts: StaggerSpringPoseOptions<TItem, TPose>,\n): AnimationHandle {\n  return animator.stagger(opts.items, opts.delay).each(\n    (item, i) =>\n      springPose(animator, adapter, {\n        id: itemId(item),\n        to: opts.to(item, i),\n        preset: opts.preset,\n        stiffness: opts.stiffness,\n        damping: opts.damping,\n        mass: opts.mass,\n        geometry: opts.geometry,\n        recordOp: opts.recordOp,\n        opLabel: opts.opLabel,\n        rewind: opts.rewind,\n      }),\n    { cancelKey: opts.cancelKey, label: opts.label },\n  );\n}\n"],"mappings":"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"}

package/dist/animation/poseTarget.js

@@ -1,115 +1,188 @@
-import { documentPose as e } from "../core/scene/effectivePose.js";
-import { RECT_POSE_DESCRIPTOR as t } from "../core/geometry/poseDescriptor.js";
-import { axesOf as n, createTarget as r } from "@weasel-js/animator";
+import { documentPose } from "../core/scene/effectivePose.js";
+import { RECT_POSE_DESCRIPTOR } from "../core/geometry/poseDescriptor.js";
+import { axesOf, createTarget } from "@weasel-js/animator";
+
 //#region src/animation/poseTarget.ts
-function i(e, t) {
-	return e?.axes?.(t) ?? n(t);
+/** How `like`'s kind of pose maps to axes: the descriptor's own mapping, else its flat numeric
+*  fields. Null for a pose with neither. */
+function poseAxes(descriptor, like) {
+	return descriptor?.axes?.(like) ?? axesOf(like);
 }
-var a = /* @__PURE__ */ new WeakMap();
-function o(e) {
-	let t = a.get(e);
-	return t || (t = () => e.commit(), a.set(e, t)), t;
+var publishers = /* @__PURE__ */ new WeakMap();
+/** One function per overrides table, so every target publishing into it shares one commit a frame. */
+function publisherOf(overrides) {
+	let publish = publishers.get(overrides);
+	if (!publish) {
+		publish = () => overrides.commit();
+		publishers.set(overrides, publish);
+	}
+	return publish;
 }
-function s(e, t) {
-	let n = t(), r = i(e, n);
-	if (!r) return null;
-	let { count: a, angles: o } = r, s = () => {
-		let o = t();
-		if (o !== n) {
-			let t = i(e, o);
-			t && t.count === a && (r = t), n = o;
+/**
+* `poseAxes` for the pose `get` answers, with `from` keeping the fields that are not axes as
+* that pose has them now. Reading them once would leave them stale in every pose a canceled
+* animation commits. Null where the pose has no axes.
+*/
+function liveAxes(descriptor, get) {
+	let like = get();
+	let axes = poseAxes(descriptor, like);
+	if (!axes) return null;
+	const { count, angles } = axes;
+	const current = () => {
+		const now = get();
+		if (now !== like) {
+			const next = poseAxes(descriptor, now);
+			if (next && next.count === count) axes = next;
+			like = now;
 		}
-		return r;
+		return axes;
 	};
 	return {
-		count: a,
-		angles: o,
-		to: (e) => s().to(e),
-		from: (e) => s().from(e),
-		add: r.add && ((e, t) => {
-			let n = s();
-			return n.add ? n.add(e, t) : n.from(n.to(e).map((e, n) => e + t[n]));
+		count,
+		angles,
+		to: (p) => current().to(p),
+		from: (a) => current().from(a),
+		add: axes.add && ((p, d) => {
+			const now = current();
+			if (now.add) return now.add(p, d);
+			return now.from(now.to(p).map((n, i) => n + d[i]));
 		}),
-		write: r.write && ((e, t, n) => {
-			let r = s();
-			r.write ? r.write(e, t, n) : r.to(e).forEach((e, r) => {
-				t[n + r] = e;
+		write: axes.write && ((p, out, at) => {
+			const now = current();
+			if (now.write) now.write(p, out, at);
+			else now.to(p).forEach((n, i) => {
+				out[at + i] = n;
 			});
 		})
 	};
 }
-function c(e, t) {
-	let n = /* @__PURE__ */ new Map();
-	return (r) => {
-		let i = /* @__PURE__ */ new Set();
-		for (let [a, o] of r === null ? [] : t.beside(r)) {
-			let t = n.get(a);
-			if (!t) {
-				if (e.has(a)) continue;
-				n.set(a, t = {}), e.set(a, t);
+/** Shows a moving container's descendants through overrides of their own, and takes them back
+*  as it rests. A descendant something else already overrides is left to it. */
+function riders(overrides, cascade) {
+	const riding = /* @__PURE__ */ new Map();
+	return (pose) => {
+		const seen = /* @__PURE__ */ new Set();
+		for (const [id, beside] of pose === null ? [] : cascade.beside(pose)) {
+			let entry = riding.get(id);
+			if (!entry) {
+				if (overrides.has(id)) continue;
+				riding.set(id, entry = {});
+				overrides.set(id, entry);
 			}
-			t.pose = o, i.add(a);
+			entry.pose = beside;
+			seen.add(id);
+		}
+		for (const [id, entry] of riding) {
+			if (seen.has(id)) continue;
+			if (overrides.get(id) === entry) overrides.clear(id);
+			riding.delete(id);
 		}
-		for (let [t, r] of n) i.has(t) || (e.get(t) === r && e.clear(t), n.delete(t));
 	};
 }
-function l(e, t, n, i) {
-	let { overrides: a } = e, c = e.id, l = s(e.descriptor, e.get);
-	if (!l) return null;
-	let u = {}, d = !1, f = r({
-		get: e.get,
-		set: e.set,
-		axes: l,
-		show(e) {
-			if (f.active && n?.() && f.stop({ commit: !1 }), f.active) {
-				u.pose = e, d || a.set(c, u), d = !0, i?.(e);
+function build(opts, onRest, overwritten, ride) {
+	const { overrides } = opts;
+	const id = opts.id;
+	const axes = liveAxes(opts.descriptor, opts.get);
+	if (!axes) return null;
+	const entry = {};
+	let installed = false;
+	const target = createTarget({
+		get: opts.get,
+		set: opts.set,
+		axes,
+		show(pose) {
+			if (target.active && overwritten?.()) target.stop({ commit: false });
+			if (target.active) {
+				entry.pose = pose;
+				if (!installed) overrides.set(id, entry);
+				installed = true;
+				ride?.(pose);
 				return;
 			}
-			d = !1, a.get(c) === u && a.clear(c), i?.(null), t?.();
+			installed = false;
+			if (overrides.get(id) === entry) overrides.clear(id);
+			ride?.(null);
+			onRest?.();
 		},
-		publish: o(a)
+		publish: publisherOf(overrides)
 	});
-	return f;
+	return target;
 }
-function u(e) {
-	let t = l(e);
-	if (!t) throw Error("createPoseTarget: this pose has no axes; give a descriptor whose `axes` maps it");
-	return t;
+/**
+* A {@link Target} over one node's pose. Animations on it commit their destination through
+* `set` as they start, and the pose on screen reaches the paint and pick walks as a pose
+* override: installed while the node moves and cleared when it comes to rest.
+*
+* Throws for a pose with no axes. Make one per node: two targets over one node do not add.
+* {@link scenePoseTarget} keeps that one for a scene's nodes.
+*/
+function createPoseTarget(opts) {
+	const target = build(opts);
+	if (!target) throw new Error("createPoseTarget: this pose has no axes; give a descriptor whose `axes` maps it");
+	return target;
 }
-var d = /* @__PURE__ */ new WeakMap();
-function f(e, t) {
-	if (e === t) return !0;
-	if (typeof e != "object" || typeof t != "object" || e === null || t === null) return !1;
-	let n = Object.keys(e);
-	return n.length === Object.keys(t).length && n.every((n) => e[n] === t[n]);
+var sceneTargets = /* @__PURE__ */ new WeakMap();
+function samePose(a, b) {
+	if (a === b) return true;
+	if (typeof a !== "object" || typeof b !== "object" || a === null || b === null) return false;
+	const ka = Object.keys(a);
+	return ka.length === Object.keys(b).length && ka.every((k) => a[k] === b[k]);
 }
-function p(n, r, a, o) {
-	let s = d.get(n.overrides);
-	s || (s = /* @__PURE__ */ new Map(), d.set(n.overrides, s));
-	let u = r, p = n.get(u), m = a ?? t, h = s.get(r), g = !h || h.active || !p || i(m, e(n, p))?.count === h.axisCount;
-	if (h && g) return h;
-	if (!p) return;
-	let _ = e(n, p), v, y = s, b = null;
-	if (b = l({
-		id: r,
-		descriptor: m,
-		overrides: n.overrides,
+/**
+* The pose target of node `id` in `scene`: the same one on every call, so everything animating
+* the node adds. Its committed value is the node's document pose, written without recording;
+* a caller that wants the move in history records its own op first.
+*
+* Undefined for a node that is not in the scene, or whose pose has no axes. `descriptor`
+* defaults to `RECT_POSE_DESCRIPTOR`. With `cascade`, for a container whose descendants hold
+* poses of their own, a commit goes through `cascade.write` and the descendants are shown
+* traveling beside the container. Both are read the first time a node's target is made.
+*/
+function scenePoseTarget(scene, id, descriptor, cascade) {
+	let made = sceneTargets.get(scene.overrides);
+	if (!made) {
+		made = /* @__PURE__ */ new Map();
+		sceneTargets.set(scene.overrides, made);
+	}
+	const nid = id;
+	const node = scene.get(nid);
+	const by = descriptor ?? RECT_POSE_DESCRIPTOR;
+	const held = made.get(id);
+	const fits = !held || held.active || !node || poseAxes(by, documentPose(scene, node))?.count === held.axisCount;
+	if (held && fits) return held;
+	if (!node) return void 0;
+	let last = documentPose(scene, node);
+	/** The node's pose as an animation last left it, or as it was when the first one started. */
+	let mine;
+	const cache = made;
+	let target = null;
+	target = build({
+		id,
+		descriptor: by,
+		overrides: scene.overrides,
 		get() {
-			let t = n.get(u);
-			return t && (_ = e(n, t)), t && !b?.active && (v = t.pose), _;
+			const n = scene.get(nid);
+			if (n) last = documentPose(scene, n);
+			if (n && !target?.active) mine = n.pose;
+			return last;
 		},
-		set(e) {
-			let t = n.get(u);
-			t && (f(t.pose, e) || n.untracked(() => o ? o.write(e) : n.setPose(u, e)), v = n.get(u)?.pose);
+		set(pose) {
+			const n = scene.get(nid);
+			if (!n) return;
+			if (!samePose(n.pose, pose)) scene.untracked(() => cascade ? cascade.write(pose) : scene.setPose(nid, pose));
+			mine = scene.get(nid)?.pose;
 		}
 	}, () => {
-		n.get(u) || y.delete(r);
+		if (!scene.get(nid)) cache.delete(id);
 	}, () => {
-		let e = n.get(u);
-		return !!e && v !== void 0 && !f(e.pose, v);
-	}, o && c(n.overrides, o)), b) return s.set(r, b), b;
+		const n = scene.get(nid);
+		return !!n && mine !== void 0 && !samePose(n.pose, mine);
+	}, cascade && riders(scene.overrides, cascade));
+	if (!target) return void 0;
+	made.set(id, target);
+	return target;
 }
-//#endregion
-export { u as createPoseTarget, s as liveAxes, i as poseAxes, p as scenePoseTarget };
 
+//#endregion
+export { createPoseTarget, liveAxes, poseAxes, scenePoseTarget };
 //# sourceMappingURL=poseTarget.js.map