@weasel-js/core 1.9.4 → 1.10.1

package/dist/animation/reflow.js.map

@@ -1 +1 @@
-{"version":3,"file":"reflow.js","names":["keyFor","id","samePose","a","b","ka","k","makeReflow","glides","dirty","unsubscribe","subscribe","animator","scene","unsubscribeIfIdle","release","g","nid","run","from","to","settling","o","read","lerp","RECT_POSE_DESCRIPTOR","onTick","p","onDone","cancelKey","label","onCourse","stop","claim","start","effectivePose","node","opts","pose","home","documentPose","createReflowTransition","useAnimatedReflow","latest","useLatest","enabled","reflow","useMemo","useEffect"],"sources":["../../src/animation/reflow.ts"],"sourcesContent":["import { useEffect, useMemo } from 'react';\nimport { useLatest } from '@weasel-js/react';\nimport { RECT_POSE_DESCRIPTOR, type PoseDescriptor } from '../core/geometry/poseDescriptor';\nimport { documentPose, effectivePose, type PosedNode, type PoseSource } from '../core/scene/effectivePose';\nimport type { NodeId, PoseOverride, PoseOverrides } from '../core/scene/types';\nimport type { ReflowTransition } from '../layout/types';\nimport type { AnimationHandle, Animator, EasingSpec, SpringPresetName } from './types';\n\n/** How a reflowed sibling travels: a duration and easing, or a spring. */\nexport interface ReflowTransitionOptions<TPose> {\n  /** Default 200. Ignored under `spring`. */\n  ms?: number;\n  easing?: EasingSpec;\n  /** Travel on a spring instead of a duration. A retarget restarts it from\n   *  the pose on screen, so position stays continuous and velocity does not\n   *  carry over. */\n  spring?: {\n    preset?: SpringPresetName;\n    stiffness?: number;\n    damping?: number;\n    mass?: number;\n  };\n  /** Supplies the `lerp` between two poses. Default `RECT_POSE_DESCRIPTOR`. */\n  geometry?: PoseDescriptor<TPose>;\n  /** Names each glide in `animator.watch` and `live()`. Default `'reflow'`. */\n  label?: string;\n}\n\n/** A {@link ReflowTransition} the animator drives. `dispose` drops every\n *  override it holds; the transition stays usable afterward. */\nexport interface AnimatedReflow<TPose = unknown> extends ReflowTransition<TPose> {\n  dispose(): void;\n}\n\n/** The part of a scene a reflow transition reads and overrides. */\nexport interface ReflowScene<TPose> extends PoseSource<TPose> {\n  readonly overrides: PoseOverrides<TPose>;\n}\n\ninterface Glide<TPose> {\n  entry: PoseOverride<TPose>;\n  target: TPose;\n  settling: boolean;\n  handle: AnimationHandle | null;\n}\n\n/** The animator's cancel-key for one node's glide. */\nconst keyFor = (id: string): string => `reflow:${id}`;\n\nfunction samePose(a: unknown, b: unknown): boolean {\n  if (Object.is(a, b)) return true;\n  if (typeof a !== 'object' || typeof b !== 'object' || a === null || b === null) return false;\n  if (Array.isArray(a) !== Array.isArray(b)) return false;\n  const ka = Object.keys(a);\n  if (ka.length !== Object.keys(b).length) return false;\n  for (const k of ka) {\n    if (!samePose((a as Record<string, unknown>)[k], (b as Record<string, unknown>)[k])) return false;\n  }\n  return true;\n}\n\nfunction makeReflow<TPose>(\n  scene: ReflowScene<TPose>,\n  animator: Animator,\n  read: () => ReflowTransitionOptions<TPose>,\n): AnimatedReflow<TPose> {\n  const glides = new Map<string, Glide<TPose>>();\n  let dirty = false;\n  let unsubscribe: (() => void) | null = null;\n\n  // Ticks only mark the frame dirty; one commit per animator frame publishes\n  // every glide at once.\n  const subscribe = (): void => {\n    if (unsubscribe) return;\n    unsubscribe = animator.onTick(() => {\n      if (!dirty) return;\n      dirty = false;\n      scene.overrides.commit();\n    });\n  };\n  const unsubscribeIfIdle = (): void => {\n    if (glides.size > 0 || !unsubscribe) return;\n    unsubscribe();\n    unsubscribe = null;\n  };\n\n  const release = (id: string, g: Glide<TPose>): void => {\n    if (glides.get(id) === g) glides.delete(id);\n    const nid = id as NodeId;\n    if (scene.overrides.get(nid) === g.entry) scene.overrides.clear(nid);\n    dirty = true;\n  };\n\n  const run = (id: string, g: Glide<TPose>, to: TPose, settling: boolean): void => {\n    const from = g.entry.pose as TPose;\n    g.target = to;\n    g.settling = settling;\n    if (samePose(from, to)) {\n      g.handle?.cancel();\n      g.handle = null;\n      g.entry.pose = to;\n      if (settling) release(id, g);\n      scene.overrides.commit();\n      unsubscribeIfIdle();\n      return;\n    }\n    const o = read();\n    const lerp = (o.geometry ?? (RECT_POSE_DESCRIPTOR as unknown as PoseDescriptor<TPose>)).lerp;\n    if (!lerp) throw new Error('useAnimatedReflow: geometry has no lerp; supply geometry: { ..., lerp }');\n    const onTick = (p: number): void => {\n      g.entry.pose = lerp(from, to, p);\n      dirty = true;\n    };\n    const onDone = (): void => {\n      g.handle = null;\n      if (!g.settling) return;\n      release(id, g);\n      unsubscribeIfIdle();\n    };\n    const cancelKey = keyFor(id);\n    const label = o.label ?? 'reflow';\n    subscribe();\n    // The shared key is what retargets: the new animation interrupts the old.\n    g.handle = o.spring\n      ? animator.spring<number>({ from: 0, to: 1, ...o.spring, cancelKey, label, onTick, onDone })\n      : animator.tween<number>({ from: 0, to: 1, ms: o.ms ?? 200, easing: o.easing, cancelKey, label, onTick, onDone });\n    scene.overrides.commit();\n  };\n\n  // False for a glide canceled through the animator: it stopped short of its\n  // target and nothing is carrying it there.\n  const onCourse = (id: string, g: Glide<TPose>): boolean =>\n    animator.isActive(keyFor(id)) || samePose(g.entry.pose, g.target);\n\n  const stop = (id: string): void => {\n    const g = glides.get(id);\n    if (!g) return;\n    glides.delete(id);\n    g.handle?.cancel();\n    const nid = id as NodeId;\n    if (scene.overrides.get(nid) === g.entry) {\n      scene.overrides.clear(nid);\n      scene.overrides.commit();\n    }\n    unsubscribeIfIdle();\n  };\n\n  // The glide for `id`, created if absent, starting from `from` when given,\n  // and published over whatever override is showing the node.\n  const claim = (\n    id: string,\n    node: PosedNode<TPose>,\n    g: Glide<TPose> | undefined,\n    from: TPose | undefined,\n  ): Glide<TPose> => {\n    if (!g) {\n      const start = from ?? effectivePose(scene, node);\n      g = { entry: { pose: start }, target: start, settling: false, handle: null };\n      glides.set(id, g);\n    } else if (from !== undefined) {\n      g.entry.pose = from;\n    }\n    if (scene.overrides.get(id as NodeId) !== g.entry) scene.overrides.set(id as NodeId, g.entry);\n    return g;\n  };\n\n  return {\n    glide(id, pose, opts) {\n      const node = scene.get(id as NodeId);\n      if (!node) return;\n      const from = opts?.from;\n      const g = glides.get(id);\n      if (g && from === undefined && !g.settling && samePose(g.target, pose) && onCourse(id, g)) return;\n      run(id, claim(id, node, g, from), pose, false);\n    },\n    settle(id, opts) {\n      const from = opts?.from;\n      const g = glides.get(id);\n      if (!g && from === undefined) return;\n      const node = scene.get(id as NodeId);\n      if (!node) { stop(id); return; }\n      const home = documentPose(scene, node);\n      if (g && from === undefined) {\n        if (g.settling && samePose(g.target, home) && onCourse(id, g)) return;\n        run(id, g, home, true);\n        return;\n      }\n      run(id, claim(id, node, g, from), home, true);\n    },\n    stop,\n    poseOf: (id) => glides.get(id)?.entry.pose,\n    dispose() {\n      for (const id of [...glides.keys()]) stop(id);\n    },\n  };\n}\n\n/**\n * A reflow transition over `animator`: each glide is a tween (or spring) of\n * its own, keyed `reflow:<id>`, so a new target for a node interrupts the\n * glide it is on and `animator.cancelKey` reaches one node's. See\n * {@link useAnimatedReflow} for the hook form.\n */\nexport function createReflowTransition<TPose>(\n  scene: ReflowScene<TPose>,\n  animator: Animator,\n  opts: ReflowTransitionOptions<TPose> = {},\n): AnimatedReflow<TPose> {\n  return makeReflow(scene, animator, () => opts);\n}\n\n/**\n * Opt a canvas's layout reflow into animation: pass the result to\n * `<SceneCanvas reflowTransition>` and siblings a drag displaces glide to\n * their slots instead of snapping. `null` (or `false`) turns it off, and\n * whatever it was holding snaps home. Option changes apply from the next\n * glide on, without rebuilding.\n */\nexport function useAnimatedReflow<TPose>(\n  scene: ReflowScene<TPose>,\n  animator: Animator,\n  opts: ReflowTransitionOptions<TPose> | null | false | undefined,\n): AnimatedReflow<TPose> | null {\n  const latest = useLatest(opts || {});\n  const enabled = !!opts;\n  const reflow = useMemo(\n    () => (enabled ? makeReflow(scene, animator, () => latest.current) : null),\n    [enabled, scene, animator, latest],\n  );\n  useEffect(() => () => reflow?.dispose(), [reflow]);\n  return reflow;\n}\n"],"mappings":"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"}
+{"version":3,"file":"reflow.js","names":["keyFor","id","samePose","a","b","ka","k","makeReflow","glides","dirty","unsubscribe","subscribe","animator","scene","unsubscribeIfIdle","release","g","nid","run","from","settling","to","o","read","lerp","onDone","cancelKey","label","t","onTick","p","onCourse","stop","start","pose","descriptor","RECT_POSE_DESCRIPTOR","axes","liveAxes","createTarget","slot","shown","claim","effectivePose","node","opts","home","documentPose","createReflowTransition","useAnimatedReflow","latest","useLatest","enabled","reflow","useMemo","useEffect"],"sources":["../../src/animation/reflow.ts"],"sourcesContent":["import { useEffect, useMemo } from 'react';\nimport { useLatest } from '@weasel-js/react';\nimport { RECT_POSE_DESCRIPTOR, type PoseDescriptor } from '../core/geometry/poseDescriptor';\nimport { documentPose, effectivePose, type PosedNode, type PoseSource } from '../core/scene/effectivePose';\nimport type { NodeId, PoseOverride, PoseOverrides } from '../core/scene/types';\nimport type { ReflowTransition } from '../layout/types';\nimport { liveAxes } from './poseTarget';\nimport { createTarget, type Target } from '@weasel-js/animator';\nimport type { Animator, EasingSpec, SpringPresetName } from '@weasel-js/animator';\n\n/** How a reflowed sibling travels: a duration and easing, or a spring. */\nexport interface ReflowTransitionOptions<TPose> {\n  /** Default 200. Ignored under `spring`. */\n  ms?: number;\n  easing?: EasingSpec;\n  /** Travel on a spring instead of a duration. A retarget starts a new spring\n   *  from the pose on screen at the speed the node was moving. */\n  spring?: {\n    preset?: SpringPresetName;\n    stiffness?: number;\n    damping?: number;\n    mass?: number;\n  };\n  /** Supplies the pose's axes, and its `lerp` is the path a timed glide\n   *  follows. Default `RECT_POSE_DESCRIPTOR`, each axis in a straight line.\n   *  A pose with no axes glides by `lerp` alone, and a retarget restarts it. */\n  geometry?: PoseDescriptor<TPose>;\n  /** Names each glide in `animator.watch` and `live()`. Default `'reflow'`. */\n  label?: string;\n}\n\n/** A {@link ReflowTransition} the animator drives. `dispose` drops every\n *  override it holds; the transition stays usable afterward. */\nexport interface AnimatedReflow<TPose = unknown> extends ReflowTransition<TPose> {\n  dispose(): void;\n}\n\n/** The part of a scene a reflow transition reads and overrides. */\nexport interface ReflowScene<TPose> extends PoseSource<TPose> {\n  readonly overrides: PoseOverrides<TPose>;\n}\n\ninterface Glide<TPose> {\n  entry: PoseOverride<TPose>;\n  /** Where the layout wants the node shown: what its target commits. */\n  slot: TPose;\n  settling: boolean;\n  /** Null for a pose with no axes, which glides by `lerp`. */\n  target: Target<TPose> | null;\n}\n\n/** The animator's cancel-key for one node's glide. */\nconst keyFor = (id: string): string => `reflow:${id}`;\n\nfunction samePose(a: unknown, b: unknown): boolean {\n  if (Object.is(a, b)) return true;\n  if (typeof a !== 'object' || typeof b !== 'object' || a === null || b === null) return false;\n  if (Array.isArray(a) !== Array.isArray(b)) return false;\n  const ka = Object.keys(a);\n  if (ka.length !== Object.keys(b).length) return false;\n  for (const k of ka) {\n    if (!samePose((a as Record<string, unknown>)[k], (b as Record<string, unknown>)[k])) return false;\n  }\n  return true;\n}\n\nfunction makeReflow<TPose>(\n  scene: ReflowScene<TPose>,\n  animator: Animator,\n  read: () => ReflowTransitionOptions<TPose>,\n): AnimatedReflow<TPose> {\n  const glides = new Map<string, Glide<TPose>>();\n  let dirty = false;\n  let unsubscribe: (() => void) | null = null;\n\n  // Ticks only mark the frame dirty; one commit per animator frame publishes\n  // every glide at once.\n  const subscribe = (): void => {\n    if (unsubscribe) return;\n    unsubscribe = animator.onTick(() => {\n      if (!dirty) return;\n      dirty = false;\n      scene.overrides.commit();\n    });\n  };\n  const unsubscribeIfIdle = (): void => {\n    if (glides.size > 0 || !unsubscribe) return;\n    unsubscribe();\n    unsubscribe = null;\n  };\n\n  const release = (id: string, g: Glide<TPose>): void => {\n    if (glides.get(id) === g) glides.delete(id);\n    const nid = id as NodeId;\n    if (scene.overrides.get(nid) === g.entry) scene.overrides.clear(nid);\n    dirty = true;\n  };\n\n  const run = (id: string, g: Glide<TPose>, to: TPose, settling: boolean): void => {\n    const from = g.entry.pose as TPose;\n    g.settling = settling;\n    if (samePose(from, to)) {\n      animator.cancelKey(keyFor(id));\n      g.slot = to;\n      g.entry.pose = to;\n      if (settling) release(id, g);\n      scene.overrides.commit();\n      unsubscribeIfIdle();\n      return;\n    }\n    // Already on its way there: whatever is moving it finishes the job.\n    if (g.target?.active && samePose(g.slot, to)) return;\n    const o = read();\n    const lerp = o.geometry?.lerp;\n    const onDone = (): void => {\n      if (g.target?.active || !g.settling) return;\n      release(id, g);\n      unsubscribeIfIdle();\n    };\n    const cancelKey = keyFor(id);\n    const label = o.label ?? 'reflow';\n    subscribe();\n    if (g.target) {\n      // A spring interrupts what is moving the node and takes its velocity; a timed glide adds to it.\n      if (o.spring) animator.spring<TPose>({ target: g.target, to, ...o.spring, cancelKey, label, onDone });\n      else {\n        animator.tween<TPose>({\n          target: g.target, to, ms: o.ms ?? 200, easing: o.easing, cancelKey, interrupt: false, label, onDone,\n          interpolate: lerp && ((a, b, t) => lerp(a, b, t)),\n        });\n      }\n    } else {\n      if (!lerp) throw new Error('useAnimatedReflow: this pose has no axes; supply geometry: { ..., lerp }');\n      g.slot = to;\n      const onTick = (p: number): void => {\n        g.entry.pose = lerp(from, to, p);\n        dirty = true;\n      };\n      // The shared key is what retargets: the new animation interrupts the old.\n      if (o.spring) animator.spring<number>({ from: 0, to: 1, ...o.spring, cancelKey, label, onTick, onDone });\n      else animator.tween<number>({ from: 0, to: 1, ms: o.ms ?? 200, easing: o.easing, cancelKey, label, onTick, onDone });\n    }\n    scene.overrides.commit();\n  };\n\n  // False for a glide canceled through the animator: it stopped short of its\n  // slot and nothing is carrying it there.\n  const onCourse = (id: string, g: Glide<TPose>): boolean =>\n    animator.isActive(keyFor(id)) || samePose(g.entry.pose, g.slot);\n\n  const stop = (id: string): void => {\n    const g = glides.get(id);\n    if (!g) return;\n    glides.delete(id);\n    animator.cancelKey(keyFor(id));\n    const nid = id as NodeId;\n    if (scene.overrides.get(nid) === g.entry) {\n      scene.overrides.clear(nid);\n      scene.overrides.commit();\n    }\n    unsubscribeIfIdle();\n  };\n\n  const start = (id: string, pose: TPose): Glide<TPose> => {\n    const g: Glide<TPose> = { entry: { pose }, slot: pose, settling: false, target: null };\n    const descriptor = read().geometry ?? (RECT_POSE_DESCRIPTOR as unknown as PoseDescriptor<TPose>);\n    const axes = liveAxes(descriptor, () => g.slot);\n    if (axes) {\n      g.target = createTarget<TPose>({\n        axes,\n        get: () => g.slot,\n        set: (slot) => { g.slot = slot; },\n        show: (shown) => {\n          g.entry.pose = shown;\n          dirty = true;\n        },\n      });\n    }\n    glides.set(id, g);\n    return g;\n  };\n\n  // The glide for `id`, created if absent, starting from `from` when given,\n  // and published over whatever override is showing the node.\n  const claim = (\n    id: string,\n    node: PosedNode<TPose>,\n    g: Glide<TPose> | undefined,\n    from: TPose | undefined,\n  ): Glide<TPose> => {\n    if (!g) {\n      g = start(id, from ?? effectivePose(scene, node));\n    } else if (from !== undefined) {\n      animator.cancelKey(keyFor(id));\n      g.slot = from;\n      g.entry.pose = from;\n    }\n    if (scene.overrides.get(id as NodeId) !== g.entry) scene.overrides.set(id as NodeId, g.entry);\n    return g;\n  };\n\n  return {\n    glide(id, pose, opts) {\n      const node = scene.get(id as NodeId);\n      if (!node) return;\n      const from = opts?.from;\n      const g = glides.get(id);\n      if (g && from === undefined && !g.settling && samePose(g.slot, pose) && onCourse(id, g)) return;\n      run(id, claim(id, node, g, from), pose, false);\n    },\n    settle(id, opts) {\n      const from = opts?.from;\n      const g = glides.get(id);\n      if (!g && from === undefined) return;\n      const node = scene.get(id as NodeId);\n      if (!node) { stop(id); return; }\n      const home = documentPose(scene, node);\n      if (g && from === undefined) {\n        if (g.settling && samePose(g.slot, home) && onCourse(id, g)) return;\n        run(id, g, home, true);\n        return;\n      }\n      run(id, claim(id, node, g, from), home, true);\n    },\n    stop,\n    poseOf: (id) => glides.get(id)?.entry.pose,\n    dispose() {\n      for (const id of [...glides.keys()]) stop(id);\n    },\n  };\n}\n\n/**\n * A reflow transition over `animator`. Each node it moves has an animation\n * target whose committed value is the slot the layout wants it shown at, and\n * a new slot is a new animation on that target under the key `reflow:<id>`:\n * a timed glide adds to the ones still running, a spring interrupts them at\n * their velocity, and `animator.cancelKey` reaches one node's. See\n * {@link useAnimatedReflow} for the hook form.\n */\nexport function createReflowTransition<TPose>(\n  scene: ReflowScene<TPose>,\n  animator: Animator,\n  opts: ReflowTransitionOptions<TPose> = {},\n): AnimatedReflow<TPose> {\n  return makeReflow(scene, animator, () => opts);\n}\n\n/**\n * Opt a canvas's layout reflow into animation: pass the result to\n * `<SceneCanvas reflowTransition>` and siblings a drag displaces glide to\n * their slots instead of snapping. `null` (or `false`) turns it off, and\n * whatever it was holding snaps home. Option changes apply from the next\n * glide on, without rebuilding.\n */\nexport function useAnimatedReflow<TPose>(\n  scene: ReflowScene<TPose>,\n  animator: Animator,\n  opts: ReflowTransitionOptions<TPose> | null | false | undefined,\n): AnimatedReflow<TPose> | null {\n  const latest = useLatest(opts || {});\n  const enabled = !!opts;\n  const reflow = useMemo(\n    () => (enabled ? makeReflow(scene, animator, () => latest.current) : null),\n    [enabled, scene, animator, latest],\n  );\n  useEffect(() => () => reflow?.dispose(), [reflow]);\n  return reflow;\n}\n"],"mappings":"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"}

package/dist/animation/rewind.js

@@ -0,0 +1,66 @@
+import { easeOut as e, resolveEasing as t } from "@weasel-js/geom";
+//#region src/animation/rewind.ts
+function n(e) {
+	return {
+		get id() {
+			return e().id;
+		},
+		cancel: () => e().cancel(),
+		pause: () => e().pause(),
+		resume: () => e().resume(),
+		setTimeScale: (t) => e().setTimeScale(t),
+		timeScale: () => e().timeScale(),
+		isPaused: () => e().isPaused()
+	};
+}
+function r(e, t) {
+	let n = e.axes.to(e.committed()), r = e.axes.to(t);
+	return n.every((e, t) => e === r[t]);
+}
+function i(i, a, o) {
+	let s = t(o.easing ?? e), { ms: c } = o, l, u = (e, t, n) => {
+		let d = e === 0 && t, f = c > 0 ? s(e / c) : 1, p = t ? c - e : e, m = t ? o.to : o.start;
+		if (!d && (p < 1 || (t ? f >= 1 : f <= 0))) {
+			a.stop({ commit: !1 }), t && o.onDone?.();
+			return;
+		}
+		let h = t ? (t) => (s((e + p * t) / c) - f) / (1 - f) : (t) => 1 - s(e * (1 - t) / c) / f, g = l = i.tween({
+			target: a,
+			from: n,
+			to: m,
+			ms: p,
+			easing: d ? s : h,
+			cancelKey: o.cancelKey,
+			interrupt: !1,
+			interpolate: o.interpolate,
+			onDone: t ? o.onDone : void 0,
+			onTick(n) {
+				if (r(a, m) || !r(a, t ? o.start : o.to)) return;
+				let s = i.live().find((e) => e.id === g.id)?.elapsed ?? 0, c = e + (t ? 1 : -1) * Math.min(p, s);
+				a.stop({ commit: !1 }), u(c, !t, n);
+			}
+		});
+	};
+	return u(0, !0, o.from), n(() => l);
+}
+function a(e, t, i) {
+	let a, o = (n, s) => {
+		let c = n ? i.to : i.start;
+		a = e.spring({
+			target: t,
+			from: s,
+			to: c,
+			...i.tuning,
+			cancelKey: i.cancelKey,
+			onDone: n ? i.onDone : void 0,
+			onTick(e) {
+				!r(t, c) && r(t, n ? i.start : i.to) && o(!n, e);
+			}
+		});
+	};
+	return o(!0, i.from), n(() => a);
+}
+//#endregion
+export { a as rewindingSpring, i as rewindingTween };
+
+//# sourceMappingURL=rewind.js.map

package/dist/animation/rewind.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rewind.js","names":["following","current","s","holds","doc","target","want","pose","x","i","rewindingTween","ease","resolveEasing","easeOut","leg","first","at","forward","done","ms","span","dest","easing","v","mine","animator","elapsed","row","now","value","rewindingSpring","o"],"sources":["../../src/animation/rewind.ts"],"sourcesContent":["import { easeOut, resolveEasing, type EasingSpec } from '@weasel-js/geom';\nimport type { AnimationHandle, Animator, Target, TargetSpringOptions } from '@weasel-js/animator';\n\n/** A move of a pose between the document pose it began at and the one it commits. */\ninterface Ends<TPose> {\n  /** The document pose before the move: what an undo of it writes back. */\n  start: TPose;\n  /** The pose the move commits. */\n  to: TPose;\n  cancelKey: string;\n  /** Called when the move arrives at `to`, never when it arrives back at `start`. */\n  onDone?: () => void;\n}\n\n/** What {@link rewindingTween} takes. */\nexport interface RewindingTween<TPose> extends Ends<TPose> {\n  /** Where the move appears to start. */\n  from: TPose;\n  ms: number;\n  easing?: EasingSpec;\n  interpolate?: (a: TPose, b: TPose, t: number) => TPose;\n}\n\n/** What {@link rewindingSpring} takes. */\nexport interface RewindingSpring<TPose> extends Ends<TPose> {\n  from: TPose;\n  tuning: Pick<TargetSpringOptions<TPose>, 'preset' | 'stiffness' | 'damping' | 'mass'>;\n}\n\n/** A handle that answers for whichever leg of a move is running. */\nfunction following(current: () => AnimationHandle): AnimationHandle {\n  return {\n    get id() { return current().id; },\n    cancel: () => current().cancel(),\n    pause: () => current().pause(),\n    resume: () => current().resume(),\n    setTimeScale: (s) => current().setTimeScale(s),\n    timeScale: () => current().timeScale(),\n    isPaused: () => current().isPaused(),\n  };\n}\n\n/** Whether the document holds `pose`, as the target's axes read both. */\nfunction holds<TPose>(target: Target<TPose>, pose: TPose): boolean {\n  const doc = target.axes.to(target.committed());\n  const want = target.axes.to(pose);\n  return doc.every((x, i) => x === want[i]);\n}\n\n/**\n * A tween of `target` from `start` to `to` that follows the document when the move is undone\n * and redone mid-flight: once the document holds the pose at its other end, it turns around\n * and travels there along the positions it passed, at the pace it passed them. Any other\n * write still wins at once, as it does for a plain move.\n */\nexport function rewindingTween<TPose>(\n  animator: Animator, target: Target<TPose>, o: RewindingTween<TPose>,\n): AnimationHandle {\n  const ease = resolveEasing(o.easing ?? easeOut);\n  const { ms } = o;\n  let current: AnimationHandle;\n\n  /** Travels from `from`, the pose on screen with the move `at` ms along, toward `to` when\n   *  `forward` and back toward `start` when not. */\n  const leg = (at: number, forward: boolean, from: TPose): void => {\n    const first = at === 0 && forward;\n    const done = ms > 0 ? ease(at / ms) : 1;\n    const span = forward ? ms - at : at;\n    const dest = forward ? o.to : o.start;\n    // Nothing of the move lies that way: the pose is at that end already.\n    if (!first && (span < 1 || (forward ? done >= 1 : done <= 0))) {\n      target.stop({ commit: false });\n      if (forward) o.onDone?.();\n      return;\n    }\n    // The share of this leg's travel covered `v` of the way through its time.\n    const easing = forward\n      ? (v: number) => (ease((at + span * v) / ms) - done) / (1 - done)\n      : (v: number) => 1 - ease((at * (1 - v)) / ms) / done;\n    const mine: AnimationHandle = current = animator.tween<TPose>({\n      target,\n      from,\n      to: dest,\n      ms: span,\n      easing: first ? ease : easing,\n      cancelKey: o.cancelKey,\n      interrupt: false,\n      interpolate: o.interpolate,\n      onDone: forward ? o.onDone : undefined,\n      onTick(value) {\n        if (holds(target, dest) || !holds(target, forward ? o.start : o.to)) return;\n        const elapsed = animator.live().find((row) => row.id === mine.id)?.elapsed ?? 0;\n        const now = at + (forward ? 1 : -1) * Math.min(span, elapsed);\n        target.stop({ commit: false });\n        leg(now, !forward, value);\n      },\n    });\n  };\n  leg(0, true, o.from);\n  return following(() => current);\n}\n\n/**\n * A spring of `target` from `start` to `to` that follows the document as\n * {@link rewindingTween} does: it springs toward the pose at its other end from where it is,\n * at the speed it has.\n */\nexport function rewindingSpring<TPose>(\n  animator: Animator, target: Target<TPose>, o: RewindingSpring<TPose>,\n): AnimationHandle {\n  let current: AnimationHandle;\n  const leg = (forward: boolean, from: TPose): void => {\n    const dest = forward ? o.to : o.start;\n    current = animator.spring<TPose>({\n      target,\n      from,\n      to: dest,\n      ...o.tuning,\n      // Under the key it interrupts the leg before it, and starts at that one's velocity.\n      cancelKey: o.cancelKey,\n      onDone: forward ? o.onDone : undefined,\n      onTick(value) {\n        if (holds(target, dest) || !holds(target, forward ? o.start : o.to)) return;\n        leg(!forward, value);\n      },\n    });\n  };\n  leg(true, o.from);\n  return following(() => current);\n}\n"],"mappings":";;AA8BA,SAASA,EAAU,GAAiD;CAClE,OAAO;EACL,IAAI,KAAK;GAAE,OAAOC,EAAQ,CAAC,CAAC;EAAI;EAChC,cAAcA,EAAQ,CAAC,CAAC,OAAO;EAC/B,aAAaA,EAAQ,CAAC,CAAC,MAAM;EAC7B,cAAcA,EAAQ,CAAC,CAAC,OAAO;EAC/B,eAAe,MAAMA,EAAQ,CAAC,CAAC,aAAaC,CAAC;EAC7C,iBAAiBD,EAAQ,CAAC,CAAC,UAAU;EACrC,gBAAgBA,EAAQ,CAAC,CAAC,SAAS;CACrC;AACF;AAGA,SAASE,EAAa,GAAuB,GAAsB;CACjE,IAAMC,IAAMC,EAAO,KAAK,GAAGA,EAAO,UAAU,CAAC,GACvCC,IAAOD,EAAO,KAAK,GAAGE,CAAI;CAChC,OAAOH,EAAI,OAAO,GAAG,MAAMI,MAAMF,EAAKG,EAAE;AAC1C;AAQA,SAAgBC,EACd,GAAoB,GAAuB,GAC1B;CACjB,IAAMC,IAAOC,EAAc,EAAE,UAAUC,CAAO,GACxC,EAAE,UAAO,GACXZ,GAIEa,KAAO,GAAY,GAAkB,MAAsB;EAC/D,IAAMC,IAAQC,MAAO,KAAKC,GACpBC,IAAOC,IAAK,IAAIR,EAAKK,IAAKG,CAAE,IAAI,GAChCC,IAAOH,IAAUE,IAAKH,IAAKA,GAC3BK,IAAOJ,IAAU,EAAE,KAAK,EAAE;EAEhC,IAAI,CAACF,MAAUK,IAAO,MAAMH,IAAUC,KAAQ,IAAIA,KAAQ,KAAK;GAE7D,AADAb,EAAO,KAAK,EAAE,QAAQ,GAAM,CAAC,GACzBY,KAAS,EAAE,SAAS;GACxB;EACF;EAEA,IAAMK,IAASL,KACV,OAAeN,GAAMK,IAAKI,IAAOG,KAAKJ,CAAE,IAAID,MAAS,IAAIA,MACzD,MAAc,IAAIP,EAAMK,KAAM,IAAIO,KAAMJ,CAAE,IAAID,GAC7CM,IAAwB,IAAUC,EAAS,MAAa;GAC5D;GACA;GACA,IAAIJ;GACJ,IAAID;GACJ,QAAQL,IAAQJ,IAAOW;GACvB,WAAW,EAAE;GACb,WAAW;GACX,aAAa,EAAE;GACf,QAAQL,IAAU,EAAE,SAAS,KAAA;GAC7B,OAAO,GAAO;IACZ,IAAId,EAAME,GAAQgB,CAAI,KAAK,CAAClB,EAAME,GAAQY,IAAU,EAAE,QAAQ,EAAE,EAAE,GAAG;IACrE,IAAMS,IAAUD,EAAS,KAAK,CAAC,CAAC,MAAM,MAAQE,EAAI,OAAOH,EAAK,EAAE,CAAC,EAAE,WAAW,GACxEI,IAAMZ,KAAMC,IAAU,IAAI,MAAM,KAAK,IAAIG,GAAMM,CAAO;IAE5D,AADArB,EAAO,KAAK,EAAE,QAAQ,GAAM,CAAC,GAC7BS,EAAIc,GAAK,CAACX,GAASY,CAAK;GAC1B;EACF,CAAC;CACH;CAEA,OADAf,EAAI,GAAG,IAAM,EAAE,IAAI,GACZd,QAAgBC,CAAO;AAChC;AAOA,SAAgB6B,EACd,GAAoB,GAAuB,GAC1B;CACjB,IAAI7B,GACEa,KAAO,GAAkB,MAAsB;EACnD,IAAMO,IAAOJ,IAAUc,EAAE,KAAKA,EAAE;EAChC,IAAUN,EAAS,OAAc;GAC/B;GACA;GACA,IAAIJ;GACJ,GAAGU,EAAE;GAEL,WAAWA,EAAE;GACb,QAAQd,IAAUc,EAAE,SAAS,KAAA;GAC7B,OAAO,GAAO;IACZ,AAAI,GAAM1B,GAAQgB,CAAI,KAAMlB,EAAME,GAAQY,IAAUc,EAAE,QAAQA,EAAE,EAAE,KAClEjB,EAAI,CAACG,GAASY,CAAK;GACrB;EACF,CAAC;CACH;CAEA,OADAf,EAAI,IAAMiB,EAAE,IAAI,GACT/B,QAAgBC,CAAO;AAChC"}

package/dist/animation/rig/bindRig.js

@@ -1,74 +1,106 @@
-import { mat3 as e } from "../../renderer/math/mat3.js";
-import { AUTO_POSE_DESCRIPTOR as t } from "../../interactions/actions/resize/autoPoseDescriptor.js";
-import { resolveSkeleton as n } from "./resolveSkeleton.js";
+import { AUTO_POSE_DESCRIPTOR as e } from "../../core/geometry/autoPoseDescriptor.js";
+import { createRigSeat as t } from "./rigSeat.js";
+import { bindSkins as n, dataRestPath as r } from "./skinBinding.js";
+import { mat3 as i } from "@weasel-js/geom";
+import { resolveSkeleton as a } from "@weasel-js/animator";
 //#region src/animation/rig/bindRig.ts
-function r(t) {
-	return (n, { rest: r, fromRest: i }) => {
-		let a = t.getBounds(r), o = a.x + a.width / 2, s = a.y + a.height / 2, [c, l] = e.apply(i, o, s), u = t.translate ? t.translate(r, c - o, l - s) : t.remapBounds(r, a, {
+function o(e) {
+	return (t, { rest: n, fromRest: r }) => {
+		let a = e.getBounds(n), o = a.x + a.width / 2, s = a.y + a.height / 2, [c, l] = i.apply(r, o, s), u = e.translate ? e.translate(n, c - o, l - s) : e.remapBounds(n, a, {
 			...a,
 			x: a.x + c - o,
 			y: a.y + l - s
 		});
-		if (!t.withRotation) return u;
-		let d = t.getRotation?.(r) ?? 0, f = Math.cos(d), p = Math.sin(d);
-		return t.withRotation(u, Math.atan2(i[1] * f + i[4] * p, i[0] * f + i[3] * p));
+		if (!e.withRotation) return u;
+		let d = e.getRotation?.(n) ?? 0, f = Math.cos(d), p = Math.sin(d);
+		return e.withRotation(u, Math.atan2(r[1] * f + r[4] * p, r[0] * f + r[3] * p));
 	};
 }
-function i(i) {
-	let { scene: a, skeleton: o } = i, s = i.apply ?? r(i.descriptor ?? t), c = n(o, {}), l = [];
-	for (let [t, n] of Object.entries(i.bindings)) {
-		let r = c.get(t);
-		if (!r) throw Error(`bindRig: the skeleton has no joint "${t}".`);
-		let i = e.invert(r);
-		if (!i) throw Error(`bindRig: joint "${t}" is singular at the bind pose.`);
-		for (let e of typeof n == "string" ? [n] : n) {
-			let n = a.get(e);
-			if (!n) throw Error(`bindRig: joint "${t}" is bound to node "${e}", which the scene lacks.`);
-			l.push({
-				node: e,
-				joint: t,
+function s(e) {
+	let n = t(e.skeleton), { rig: r, binding: i } = c(e, n);
+	return n.binding = i, r;
+}
+function c(t, s) {
+	let { scene: c, skeleton: l } = t, u = t.descriptor ?? e, d = t.apply ?? o(u), f = a(l, {}), p = /* @__PURE__ */ new Map(), m = (e) => {
+		let t = p.get(e);
+		if (t) return t;
+		let n = f.get(e);
+		if (!n) throw Error(`bindRig: the skeleton has no joint "${e}".`);
+		if (t = i.invert(n) ?? void 0, !t) throw Error(`bindRig: joint "${e}" is singular at the bind pose.`);
+		return p.set(e, t), t;
+	}, h = n(c, t.skins ?? {}, t.restPath ?? r, u);
+	h.joints.forEach(m);
+	let g = [];
+	for (let [e, n] of Object.entries(t.bindings ?? {})) {
+		m(e);
+		let r = f.get(e);
+		for (let i of typeof n == "string" ? [n] : n) {
+			if (t.skins && i in t.skins) throw Error(`bindRig: node "${i}" is both bound to joint "${e}" and skinned.`);
+			let n = c.get(i);
+			if (!n) throw Error(`bindRig: joint "${e}" is bound to node "${i}", which the scene lacks.`);
+			g.push({
+				node: i,
+				joint: e,
 				rest: n.pose,
 				restWorld: r,
-				restInverse: i,
 				entry: { pose: n.pose }
 			});
 		}
 	}
-	let u = c, d = !1, f = () => {
-		if (d) {
-			d = !1;
-			for (let e of l) a.overrides.clear(e.node);
+	let _ = f, v = !1, y = () => {
+		if (v) {
+			v = !1;
+			for (let e of g) c.overrides.clear(e.node);
+			h.release();
 		}
-	};
+	}, b = () => {
+		s.shown = !1, y();
+	}, x = (e) => {
+		let t = a(l, e), { root: n } = s;
+		if (n) for (let [e, r] of t) t.set(e, i.multiply(n, r));
+		_ = t;
+		let r = /* @__PURE__ */ new Map(), o = (e) => {
+			let n = r.get(e);
+			return n || (n = i.multiply(t.get(e), m(e)), r.set(e, n)), n;
+		};
+		for (let e of g) {
+			let n = t.get(e.joint);
+			e.entry.pose = d(n, {
+				joint: e.joint,
+				node: e.node,
+				rest: e.rest,
+				restWorld: e.restWorld,
+				fromRest: o(e.joint)
+			}), v || c.overrides.set(e.node, e.entry);
+		}
+		h.joints.forEach(o), h.show(r), v = !0, s.shown = !0, c.overrides.commit();
+	}, { target: S } = s;
 	return {
-		skeleton: o,
-		pose(t, r) {
-			let i = n(o, t);
-			if (r) for (let [t, n] of i) i.set(t, e.multiply(r, n));
-			u = i;
-			let c = /* @__PURE__ */ new Map();
-			for (let t of l) {
-				let n = i.get(t.joint), r = c.get(t.joint);
-				r || (r = e.multiply(n, t.restInverse), c.set(t.joint, r)), t.entry.pose = s(n, {
-					joint: t.joint,
-					node: t.node,
-					rest: t.rest,
-					restWorld: t.restWorld,
-					fromRest: r
-				}), d || a.overrides.set(t.node, t.entry);
-			}
-			d = !0, a.overrides.commit();
+		rig: {
+			skeleton: l,
+			target: S,
+			pose(e, t) {
+				s.committed = e, t && (s.root = t), x(S.read());
+			},
+			place(e) {
+				s.root = e, x(S.read());
+			},
+			world: () => _,
+			bake(e = "Bake rig pose") {
+				v && (c.batch(e, () => {
+					for (let e of g) e.entry.pose !== void 0 && c.setPose(e.node, e.entry.pose);
+					h.write();
+				}), b());
+			},
+			release: b
 		},
-		world: () => u,
-		bake(e = "Bake rig pose") {
-			d && (a.batch(e, () => {
-				for (let e of l) e.entry.pose !== void 0 && a.setPose(e.node, e.entry.pose);
-			}), f());
-		},
-		release: f
+		binding: {
+			show: x,
+			drop: y
+		}
 	};
 }
 //#endregion
-export { i as bindRig, r as rigidRigApply };
+export { s as bindRig, c as bindRigOn, o as rigidRigApply };
 
 //# sourceMappingURL=bindRig.js.map

package/dist/animation/rig/bindRig.js.map

@@ -1 +1 @@
-{"version":3,"file":"bindRig.js","names":["rigidRigApply","b","descriptor","rest","cx","cy","nx","ny","mat3","fromRest","moved","r0","ux","uy","bindRig","options","apply","AUTO_POSE_DESCRIPTOR","restWorlds","resolveSkeleton","skeleton","bound","joint","ids","restWorld","restInverse","node","scene","world","installed","release","local","pose","root","name","m","w","delta","label"],"sources":["../../../src/animation/rig/bindRig.ts"],"sourcesContent":["import type { PoseDescriptor } from '../../core/geometry/poseDescriptor';\nimport type { NodeId, PoseOverride, PoseOverrides } from '../../core/scene/types';\nimport { AUTO_POSE_DESCRIPTOR } from '../../interactions/actions/resize/autoPoseDescriptor';\nimport { mat3, type GlMat3 } from '../../renderer/math/mat3';\nimport { resolveSkeleton } from './resolveSkeleton';\nimport type { Pose, Skeleton } from './types';\n\n/** The part of a scene a rig writes to. */\nexport interface RigScene<TPose> {\n  get(id: NodeId): { pose: TPose } | undefined;\n  readonly overrides: PoseOverrides<TPose>;\n  setPose(id: NodeId, pose: TPose): void;\n  batch<T>(label: string, fn: () => T): T;\n}\n\n/** What a `RigApply` knows about the node it is posing. */\nexport interface RigApplyContext<TPose> {\n  /** The joint the node rides. */\n  joint: string;\n  node: NodeId;\n  /** The node's document pose when the rig was bound — where it sits at the\n   *  bind pose. */\n  rest: TPose;\n  /** The joint's world transform at the bind pose. */\n  restWorld: GlMat3;\n  /** `world * inverse(restWorld)`: the motion since the bind pose, in world\n   *  space. Carrying `rest` by it is what welding the node to the joint means. */\n  fromRest: GlMat3;\n}\n\n/** Turns a joint's world transform into a pose for one bound node. The only\n *  part of a rig that knows the scene's pose shape. */\nexport type RigApply<TPose> = (world: GlMat3, ctx: RigApplyContext<TPose>) => TPose;\n\n/** Options for `bindRig`. */\nexport interface BindRigOptions<TPose> {\n  scene: RigScene<TPose>;\n  skeleton: Skeleton;\n  /** Joint name → the node or nodes that ride it. Each node keeps the offset\n   *  from its joint that it has at the bind pose. */\n  bindings: Readonly<Record<string, NodeId | readonly NodeId[]>>;\n  /** Default: {@link rigidRigApply} over `descriptor`. */\n  apply?: RigApply<TPose>;\n  /** The descriptor the default `apply` reads and writes poses through.\n   *  Default `AUTO_POSE_DESCRIPTOR`. */\n  descriptor?: PoseDescriptor<TPose>;\n}\n\n/** A skeleton bound to scene nodes, as `bindRig` returns it. */\nexport interface Rig {\n  readonly skeleton: Skeleton;\n  /**\n   * Resolve `pose` and move every bound node to it, through the scene's pose\n   * overrides — no history entry, no document write, no version bump — then\n   * commit them. The per-frame write. `root` places the rig in the world, and\n   * may mirror it.\n   */\n  pose(pose: Pose, root?: GlMat3): void;\n  /** The joint world transforms the last `pose` resolved, root applied. */\n  world(): ReadonlyMap<string, GlMat3>;\n  /** Write the current frame into the bound nodes' document poses as one\n   *  undo entry, and drop the overrides. Later frames stay relative to the\n   *  bind-time rest, so baking does not compound. */\n  bake(label?: string): void;\n  /** Drop the overrides; the nodes show their document poses again until the\n   *  next `pose`. */\n  release(): void;\n}\n\n/**\n * Carries a node rigidly with its joint: the rest pose's center moves by\n * `fromRest`, and its rotation turns with the rest pose's x-axis. Scale in the\n * joint chain moves positions but not sizes — the pose model holds no shear,\n * and a sized pose under anisotropic scale would need one. Write an `apply`\n * that reads `world` to size nodes from joint scale.\n */\nexport function rigidRigApply<TPose>(descriptor: PoseDescriptor<TPose>): RigApply<TPose> {\n  return (_world, { rest, fromRest }) => {\n    const b = descriptor.getBounds(rest);\n    const cx = b.x + b.width / 2;\n    const cy = b.y + b.height / 2;\n    const [nx, ny] = mat3.apply(fromRest, cx, cy);\n    const moved = descriptor.translate\n      ? descriptor.translate(rest, nx - cx, ny - cy)\n      : descriptor.remapBounds(rest, b, { ...b, x: b.x + nx - cx, y: b.y + ny - cy });\n    if (!descriptor.withRotation) return moved;\n    const r0 = descriptor.getRotation?.(rest) ?? 0;\n    const ux = Math.cos(r0);\n    const uy = Math.sin(r0);\n    return descriptor.withRotation(\n      moved,\n      Math.atan2(fromRest[1] * ux + fromRest[4] * uy, fromRest[0] * ux + fromRest[3] * uy),\n    );\n  };\n}\n\ninterface Bound<TPose> {\n  node: NodeId;\n  joint: string;\n  rest: TPose;\n  restWorld: GlMat3;\n  restInverse: GlMat3;\n  entry: PoseOverride<TPose>;\n}\n\n/**\n * Bind a skeleton's joints to scene nodes. Nodes are written in world space\n * and the rig resolves its own hierarchy, so bound nodes are best left\n * unparented, or under containers whose pose does not compose into theirs;\n * the scene's tree stays free to order and group them for drawing.\n */\nexport function bindRig<TPose>(options: BindRigOptions<TPose>): Rig {\n  const { scene, skeleton } = options;\n  const apply = options.apply ?? rigidRigApply(options.descriptor ?? (AUTO_POSE_DESCRIPTOR as PoseDescriptor<TPose>));\n  const restWorlds = resolveSkeleton(skeleton, {});\n\n  const bound: Bound<TPose>[] = [];\n  for (const [joint, ids] of Object.entries(options.bindings)) {\n    const restWorld = restWorlds.get(joint);\n    if (!restWorld) throw new Error(`bindRig: the skeleton has no joint \"${joint}\".`);\n    const restInverse = mat3.invert(restWorld);\n    if (!restInverse) throw new Error(`bindRig: joint \"${joint}\" is singular at the bind pose.`);\n    for (const node of typeof ids === 'string' ? [ids] : (ids as readonly NodeId[])) {\n      const n = scene.get(node);\n      if (!n) throw new Error(`bindRig: joint \"${joint}\" is bound to node \"${node}\", which the scene lacks.`);\n      bound.push({ node, joint, rest: n.pose, restWorld, restInverse, entry: { pose: n.pose } });\n    }\n  }\n\n  let world: ReadonlyMap<string, GlMat3> = restWorlds;\n  let installed = false;\n\n  const release = () => {\n    if (!installed) return;\n    installed = false;\n    for (const b of bound) scene.overrides.clear(b.node);\n  };\n\n  return {\n    skeleton,\n    pose(pose, root) {\n      const local = resolveSkeleton(skeleton, pose);\n      if (root) for (const [name, m] of local) local.set(name, mat3.multiply(root, m));\n      world = local;\n      const fromRest = new Map<string, GlMat3>();\n      for (const b of bound) {\n        const w = local.get(b.joint)!;\n        let delta = fromRest.get(b.joint);\n        if (!delta) {\n          delta = mat3.multiply(w, b.restInverse);\n          fromRest.set(b.joint, delta);\n        }\n        b.entry.pose = apply(w, { joint: b.joint, node: b.node, rest: b.rest, restWorld: b.restWorld, fromRest: delta });\n        if (!installed) scene.overrides.set(b.node, b.entry);\n      }\n      installed = true;\n      scene.overrides.commit();\n    },\n    world: () => world,\n    bake(label = 'Bake rig pose') {\n      if (!installed) return;\n      scene.batch(label, () => {\n        for (const b of bound) if (b.entry.pose !== undefined) scene.setPose(b.node, b.entry.pose);\n      });\n      release();\n    },\n    release,\n  };\n}\n"],"mappings":"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"}
+{"version":3,"file":"bindRig.js","names":["rigidRigApply","b","descriptor","rest","cx","cy","nx","ny","mat3","fromRest","moved","r0","ux","uy","bindRig","seat","createRigSeat","options","bindRigOn","binding","rig","AUTO_POSE_DESCRIPTOR","apply","restWorlds","resolveSkeleton","skeleton","restInverses","restInverseOf","inverse","joint","restWorld","skins","bindSkins","scene","dataRestPath","bound","ids","node","world","installed","drop","release","show","local","pose","root","name","m","motionOf","delta","w","at","target","label"],"sources":["../../../src/animation/rig/bindRig.ts"],"sourcesContent":["import type { PoseDescriptor } from '../../core/geometry/poseDescriptor';\nimport type { NodeId, PoseOverride } from '../../core/scene/types';\nimport { AUTO_POSE_DESCRIPTOR } from 'core/geometry/autoPoseDescriptor';\nimport { mat3, type GlMat3 } from '@weasel-js/geom';\nimport type { Target } from '@weasel-js/animator';\nimport { resolveSkeleton } from '@weasel-js/animator';\nimport type { Pose, Skeleton } from '@weasel-js/animator';\nimport type { Skin } from '@weasel-js/animator';\nimport { createRigSeat, type RigBinding, type RigSeat } from './rigSeat';\nimport { bindSkins, dataRestPath, type RestPath, type SkinScene } from './skinBinding';\n\n/** The part of a scene a rig writes to. */\nexport interface RigScene<TPose> extends SkinScene<TPose> {\n  batch<T>(label: string, fn: () => T): T;\n}\n\n/** What a `RigApply` knows about the node it is posing. */\nexport interface RigApplyContext<TPose> {\n  /** The joint the node rides. */\n  joint: string;\n  node: NodeId;\n  /** The node's document pose when the rig was bound — where it sits at the\n   *  bind pose. */\n  rest: TPose;\n  /** The joint's world transform at the bind pose. */\n  restWorld: GlMat3;\n  /** `world * inverse(restWorld)`: the motion since the bind pose, in world\n   *  space. Carrying `rest` by it is what welding the node to the joint means. */\n  fromRest: GlMat3;\n}\n\n/** Turns a joint's world transform into a pose for one bound node. The only\n *  part of a rig that knows the scene's pose shape. */\nexport type RigApply<TPose> = (world: GlMat3, ctx: RigApplyContext<TPose>) => TPose;\n\n/** Options for `bindRig`. */\nexport interface BindRigOptions<TPose> {\n  scene: RigScene<TPose>;\n  skeleton: Skeleton;\n  /** Joint name → the node or nodes that ride it. Each node keeps the offset\n   *  from its joint that it has at the bind pose. */\n  bindings?: Readonly<Record<string, NodeId | readonly NodeId[]>>;\n  /** Node id → the weights its path bends by. Where a bound node moves whole with one joint,\n   *  a skinned node's points each follow their own joints, and the rig shows the bent path\n   *  through the node's pose override, posed at the path's bounds. */\n  skins?: Readonly<Record<NodeId, Skin>>;\n  /** Where a skinned node's path is drawn when the rig is bound. Default\n   *  {@link dataRestPath}: the node's `data.path`, through its pose. */\n  restPath?: RestPath<TPose>;\n  /** Default: {@link rigidRigApply} over `descriptor`. */\n  apply?: RigApply<TPose>;\n  /** The descriptor the default `apply` reads and writes poses through.\n   *  Default `AUTO_POSE_DESCRIPTOR`. */\n  descriptor?: PoseDescriptor<TPose>;\n}\n\n/** A skeleton bound to scene nodes, as `bindRig` returns it. */\nexport interface Rig {\n  readonly skeleton: Skeleton;\n  /**\n   * The rig's pose as a value an animator moves. Its committed value starts as `{}`, the bind\n   * pose, and each frame the rig is posed with what the target shows. A clip is a\n   * `SampledTrack<Pose>` given this as its `target`: clips on one rig crossfade by their\n   * `weight`s, weights short of 1 leave the rest to the committed pose, and a `spring` or\n   * `tween` from a pose away from the committed one adds on top. `animator.hold` shows a pose made elsewhere the same way, an\n   * IK solve included.\n   */\n  readonly target: Target<Pose>;\n  /**\n   * Commit `pose` and move every bound node to what the target now shows, which is `pose`\n   * unless something is animating the target; a hold on it weighs the new pose in when it is\n   * next read, at the animator's next frame or the hold's `touch()`. Writes go through the scene's pose overrides —\n   * no history entry, no document write, no version bump — and are committed. `root`, where\n   * given, replaces the placement, as {@link Rig.place}.\n   */\n  pose(pose: Pose, root?: GlMat3): void;\n  /** Place the rig in the world by `root`, which may mirror it, and pose it there. It stays\n   *  until placed again; with no `root`, the rig goes back to where its skeleton puts it. */\n  place(root?: GlMat3): void;\n  /** The joint world transforms as the rig was last posed, root applied. */\n  world(): ReadonlyMap<string, GlMat3>;\n  /** Write the current frame into the bound nodes' document poses as one\n   *  undo entry, and drop the overrides. A skinned node's bent path goes into\n   *  its `data.path`. Later frames stay relative to the bind-time rest, so\n   *  baking does not compound. */\n  bake(label?: string): void;\n  /** Drop the overrides; the nodes show their document poses again until the\n   *  rig is next posed. */\n  release(): void;\n}\n\n/**\n * Carries a node rigidly with its joint: the rest pose's center moves by\n * `fromRest`, and its rotation turns with the rest pose's x-axis. Scale in the\n * joint chain moves positions but not sizes — the pose model holds no shear,\n * and a sized pose under anisotropic scale would need one. Write an `apply`\n * that reads `world` to size nodes from joint scale.\n */\nexport function rigidRigApply<TPose>(descriptor: PoseDescriptor<TPose>): RigApply<TPose> {\n  return (_world, { rest, fromRest }) => {\n    const b = descriptor.getBounds(rest);\n    const cx = b.x + b.width / 2;\n    const cy = b.y + b.height / 2;\n    const [nx, ny] = mat3.apply(fromRest, cx, cy);\n    const moved = descriptor.translate\n      ? descriptor.translate(rest, nx - cx, ny - cy)\n      : descriptor.remapBounds(rest, b, { ...b, x: b.x + nx - cx, y: b.y + ny - cy });\n    if (!descriptor.withRotation) return moved;\n    const r0 = descriptor.getRotation?.(rest) ?? 0;\n    const ux = Math.cos(r0);\n    const uy = Math.sin(r0);\n    return descriptor.withRotation(\n      moved,\n      Math.atan2(fromRest[1] * ux + fromRest[4] * uy, fromRest[0] * ux + fromRest[3] * uy),\n    );\n  };\n}\n\ninterface Bound<TPose> {\n  node: NodeId;\n  joint: string;\n  rest: TPose;\n  restWorld: GlMat3;\n  entry: PoseOverride<TPose>;\n}\n\n/**\n * Bind a skeleton's joints to scene nodes. Nodes are written in world space\n * and the rig resolves its own hierarchy, so bound nodes are best left\n * unparented, or under containers whose pose does not compose into theirs;\n * the scene's tree stays free to order and group them for drawing.\n */\nexport function bindRig<TPose>(options: BindRigOptions<TPose>): Rig {\n  const seat = createRigSeat(options.skeleton);\n  const { rig, binding } = bindRigOn(options, seat);\n  seat.binding = binding;\n  return rig;\n}\n\n/** {@link bindRig} on a seat the caller keeps. The rig shows the seat's target once its\n *  `binding` is the seat's. */\nexport function bindRigOn<TPose>(\n  options: BindRigOptions<TPose>,\n  seat: RigSeat,\n): { rig: Rig; binding: RigBinding } {\n  const { scene, skeleton } = options;\n  const descriptor = options.descriptor ?? (AUTO_POSE_DESCRIPTOR as PoseDescriptor<TPose>);\n  const apply = options.apply ?? rigidRigApply(descriptor);\n  const restWorlds = resolveSkeleton(skeleton, {});\n  const restInverses = new Map<string, GlMat3>();\n  const restInverseOf = (joint: string): GlMat3 => {\n    let inverse = restInverses.get(joint);\n    if (inverse) return inverse;\n    const restWorld = restWorlds.get(joint);\n    if (!restWorld) throw new Error(`bindRig: the skeleton has no joint \"${joint}\".`);\n    inverse = mat3.invert(restWorld) ?? undefined;\n    if (!inverse) throw new Error(`bindRig: joint \"${joint}\" is singular at the bind pose.`);\n    restInverses.set(joint, inverse);\n    return inverse;\n  };\n\n  const skins = bindSkins(scene, options.skins ?? {}, options.restPath ?? dataRestPath, descriptor);\n  skins.joints.forEach(restInverseOf);\n\n  const bound: Bound<TPose>[] = [];\n  for (const [joint, ids] of Object.entries(options.bindings ?? {})) {\n    restInverseOf(joint);\n    const restWorld = restWorlds.get(joint)!;\n    for (const node of typeof ids === 'string' ? [ids] : (ids as readonly NodeId[])) {\n      if (options.skins && node in options.skins) {\n        throw new Error(`bindRig: node \"${node}\" is both bound to joint \"${joint}\" and skinned.`);\n      }\n      const n = scene.get(node);\n      if (!n) throw new Error(`bindRig: joint \"${joint}\" is bound to node \"${node}\", which the scene lacks.`);\n      bound.push({ node, joint, rest: n.pose, restWorld, entry: { pose: n.pose } });\n    }\n  }\n\n  let world: ReadonlyMap<string, GlMat3> = restWorlds;\n  let installed = false;\n\n  const drop = () => {\n    if (!installed) return;\n    installed = false;\n    for (const b of bound) scene.overrides.clear(b.node);\n    skins.release();\n  };\n  const release = () => {\n    seat.shown = false;\n    drop();\n  };\n\n  const show = (pose: Pose): void => {\n    const local = resolveSkeleton(skeleton, pose);\n    const { root } = seat;\n    if (root) for (const [name, m] of local) local.set(name, mat3.multiply(root, m));\n    world = local;\n    const fromRest = new Map<string, GlMat3>();\n    const motionOf = (joint: string): GlMat3 => {\n      let delta = fromRest.get(joint);\n      if (!delta) {\n        delta = mat3.multiply(local.get(joint)!, restInverseOf(joint));\n        fromRest.set(joint, delta);\n      }\n      return delta;\n    };\n    for (const b of bound) {\n      const w = local.get(b.joint)!;\n      b.entry.pose = apply(w, { joint: b.joint, node: b.node, rest: b.rest, restWorld: b.restWorld, fromRest: motionOf(b.joint) });\n      if (!installed) scene.overrides.set(b.node, b.entry);\n    }\n    skins.joints.forEach(motionOf);\n    skins.show(fromRest);\n    installed = true;\n    seat.shown = true;\n    scene.overrides.commit();\n  };\n\n  const { target } = seat;\n  const rig: Rig = {\n    skeleton,\n    target,\n    pose(pose, at) {\n      seat.committed = pose;\n      if (at) seat.root = at;\n      show(target.read());\n    },\n    place(at) {\n      seat.root = at;\n      show(target.read());\n    },\n    world: () => world,\n    bake(label = 'Bake rig pose') {\n      if (!installed) return;\n      scene.batch(label, () => {\n        for (const b of bound) if (b.entry.pose !== undefined) scene.setPose(b.node, b.entry.pose);\n        skins.write();\n      });\n      release();\n    },\n    release,\n  };\n  return { rig, binding: { show, drop } };\n}\n"],"mappings":"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"}

package/dist/animation/rig/rigNode.js

@@ -0,0 +1,99 @@
+import { AUTO_POSE_DESCRIPTOR as e } from "../../core/geometry/autoPoseDescriptor.js";
+import { createRigSeat as t } from "./rigSeat.js";
+import { useSeatedRig as n } from "./useRig.js";
+import { poseFrameInverseOf as r, poseFrameOf as i } from "@weasel-js/geom";
+import { useMemo as a, useState as o, useSyncExternalStore as s } from "react";
+//#region src/animation/rig/rigNode.ts
+var c = (e, t, n) => e ? [e[0] * t + e[2] * n + e[4], e[1] * t + e[3] * n + e[5]] : [t, n];
+function l(t, n, r = e) {
+	let a = r.getBounds(n), o = i(n), s = r.getRotation?.(n) ?? 0;
+	return { joints: t.joints.map((e) => {
+		if (e.parent != null) return e;
+		let [t, n] = c(o, a.x + e.bind.x, a.y + e.bind.y);
+		return {
+			...e,
+			bind: {
+				...e.bind,
+				x: t,
+				y: n,
+				rotation: e.bind.rotation + s
+			}
+		};
+	}) };
+}
+function u(t, n, i = e) {
+	let a = i.getBounds(n), o = r(n), s = i.getRotation?.(n) ?? 0;
+	return { joints: t.joints.map((e) => {
+		if (e.parent != null) return e;
+		let [t, n] = c(o, e.bind.x, e.bind.y);
+		return {
+			...e,
+			bind: {
+				...e.bind,
+				x: t - a.x,
+				y: n - a.y,
+				rotation: e.bind.rotation - s
+			}
+		};
+	}) };
+}
+var d = /* @__PURE__ */ new Map(), f = () => () => {}, p = () => d;
+function m(e, t, n, r = d) {
+	let i = e.get(t);
+	if (!i) throw Error(`rigFromNode: the rig is node "${t}", which the scene lacks.`);
+	let a = i.data?.skeleton;
+	if (!a) throw Error(`rigFromNode: node "${t}" has no skeleton in its data.`);
+	let o = {
+		skeleton: l(a, i.pose, n),
+		bindings: {},
+		skins: {},
+		refs: [i.pose, i.data]
+	}, s = (t) => {
+		for (let n of e.childrenOf(t)) {
+			let t = e.get(n);
+			if (!t) continue;
+			let i = t.data, a = r.get(n) ?? i?.skin;
+			o.refs.push(n, t.pose, t.data, a), a ? o.skins[n] = a : i?.joint !== void 0 && (o.bindings[i.joint] ??= []).push(n), s(n);
+		}
+	};
+	return s(t), o;
+}
+var h = (e, t) => e === t || e.refs.length === t.refs.length && e.refs.every((e, n) => e === t.refs[n]);
+function g(t, n, r = e) {
+	let { skeleton: i, bindings: a, skins: o } = m(t, n, r);
+	return {
+		skeleton: i,
+		bindings: a,
+		skins: o
+	};
+}
+function _(r) {
+	let { scene: i, node: c, apply: l, descriptor: u, restPath: d, painting: g } = r, _ = s(i.subscribe, i.getVersion), v = s(g?.listen ?? f, g?.painted ?? p), y = a(() => m(i, c, u ?? e, v), [
+		i,
+		c,
+		u,
+		_,
+		v
+	]), [b, x] = o(y), S = h(b, y) ? b : y;
+	S !== b && x(y);
+	let C = JSON.stringify(S.skeleton.joints.map((e) => e.name)), [w, T] = o(() => ({
+		joints: C,
+		seat: t(S.skeleton)
+	})), { seat: E } = w;
+	return w.joints !== C && (E = t(S.skeleton, w.seat), T({
+		joints: C,
+		seat: E
+	})), n({
+		scene: i,
+		skeleton: S.skeleton,
+		bindings: S.bindings,
+		skins: S.skins,
+		apply: l,
+		descriptor: u,
+		restPath: d
+	}, E);
+}
+//#endregion
+export { l as placeSkeleton, g as rigFromNode, u as unplaceSkeleton, _ as useRigNode };
+
+//# sourceMappingURL=rigNode.js.map

package/dist/animation/rig/rigNode.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rigNode.js","names":["through","m","x","y","placeSkeleton","AUTO_POSE_DESCRIPTOR","box","descriptor","pose","frame","poseFrameOf","turn","skeleton","joint","unplaceSkeleton","inverse","poseFrameInverseOf","UNPAINTED","noWord","unpainted","read","node","scene","id","local","out","walk","child","parent","n","data","skin","painted","sameRefs","a","b","r","i","rigFromNode","useRigNode","options","version","useSyncExternalStore","painting","next","useMemo","held","setHeld","useState","parts","joints","seated","setSeated","createRigSeat","useSeatedRig","seat"],"sources":["../../../src/animation/rig/rigNode.ts"],"sourcesContent":["import { useMemo, useState, useSyncExternalStore } from 'react';\nimport { poseFrameInverseOf, poseFrameOf } from '@weasel-js/geom';\nimport { AUTO_POSE_DESCRIPTOR } from 'core/geometry/autoPoseDescriptor';\nimport type { PoseDescriptor } from '../../core/geometry/poseDescriptor';\nimport type { NodeId } from '../../core/scene/types';\nimport type { BindRigOptions, Rig, RigScene } from './bindRig';\nimport type { Skin } from '@weasel-js/animator';\nimport type { Skeleton } from '@weasel-js/animator';\nimport { createRigSeat } from './rigSeat';\nimport { useSeatedRig } from './useRig';\n\n/** What a rig reads from node data: a `skeleton` on the node that is the rig, and on the nodes\n *  under it a `skin` for a path that bends or a `joint` for a node that rides one whole. */\nexport interface RigNodeData {\n  /** Joints relative to the node's pose: its box's top-left corner, turned as the node is. */\n  skeleton?: Skeleton;\n  skin?: Skin;\n  joint?: string;\n}\n\n/** Weights to bind in place of the document's, and word of when they change. A `RigEditState`\n *  is one: it holds what a stroke of the weight tool has painted and not yet written. */\nexport interface PaintedSkins {\n  /** By node. A new map whenever the weights change. */\n  painted(): ReadonlyMap<NodeId, Skin>;\n  listen(fn: () => void): () => void;\n}\n\n/** The part of a scene `rigFromNode` reads. */\nexport interface RigNodeSource<TPose> {\n  get(id: NodeId): { pose: TPose; data?: unknown } | undefined;\n  childrenOf(id: NodeId): readonly NodeId[];\n}\n\n/** The skeleton, bindings, and skins a rig node declares, as `bindRig` takes them. */\nexport interface RigNodeParts {\n  skeleton: Skeleton;\n  bindings: Record<string, NodeId[]>;\n  skins: Record<NodeId, Skin>;\n}\n\ninterface Reading extends RigNodeParts {\n  /** Every node, pose, and data object the parts were read from, to tell when they are stale. */\n  refs: unknown[];\n}\n\ntype Affine = readonly [number, number, number, number, number, number];\nconst through = (m: Affine | null, x: number, y: number): [number, number] =>\n  (m ? [m[0] * x + m[2] * y + m[4], m[1] * x + m[3] * y + m[5]] : [x, y]);\n\n/**\n * A skeleton as a rig node's data keeps it, moved to where the node's pose puts it: its root\n * joints are offset from the pose box's top-left corner and turned as the node is. Joints\n * under a root are relative to their parents and are left as they are.\n */\nexport function placeSkeleton<TPose>(\n  skeleton: Skeleton,\n  pose: TPose,\n  descriptor: PoseDescriptor<TPose> = AUTO_POSE_DESCRIPTOR as PoseDescriptor<TPose>,\n): Skeleton {\n  const box = descriptor.getBounds(pose);\n  const frame = poseFrameOf(pose);\n  const turn = descriptor.getRotation?.(pose) ?? 0;\n  return {\n    joints: skeleton.joints.map((joint) => {\n      if (joint.parent != null) return joint;\n      const [x, y] = through(frame, box.x + joint.bind.x, box.y + joint.bind.y);\n      return { ...joint, bind: { ...joint.bind, x, y, rotation: joint.bind.rotation + turn } };\n    }),\n  };\n}\n\n/** The inverse of {@link placeSkeleton}: a skeleton in the scene's space, as the node at\n *  `pose` would keep it in its data. */\nexport function unplaceSkeleton<TPose>(\n  skeleton: Skeleton,\n  pose: TPose,\n  descriptor: PoseDescriptor<TPose> = AUTO_POSE_DESCRIPTOR as PoseDescriptor<TPose>,\n): Skeleton {\n  const box = descriptor.getBounds(pose);\n  const inverse = poseFrameInverseOf(pose);\n  const turn = descriptor.getRotation?.(pose) ?? 0;\n  return {\n    joints: skeleton.joints.map((joint) => {\n      if (joint.parent != null) return joint;\n      const [x, y] = through(inverse, joint.bind.x, joint.bind.y);\n      return { ...joint, bind: { ...joint.bind, x: x - box.x, y: y - box.y, rotation: joint.bind.rotation - turn } };\n    }),\n  };\n}\n\nconst UNPAINTED: ReadonlyMap<NodeId, Skin> = new Map();\nconst noWord = (): (() => void) => () => {};\nconst unpainted = (): ReadonlyMap<NodeId, Skin> => UNPAINTED;\n\nfunction read<TPose>(\n  scene: RigNodeSource<TPose>,\n  id: NodeId,\n  descriptor: PoseDescriptor<TPose>,\n  painted: ReadonlyMap<NodeId, Skin> = UNPAINTED,\n): Reading {\n  const node = scene.get(id);\n  if (!node) throw new Error(`rigFromNode: the rig is node \"${id}\", which the scene lacks.`);\n  const local = (node.data as RigNodeData | null | undefined)?.skeleton;\n  if (!local) throw new Error(`rigFromNode: node \"${id}\" has no skeleton in its data.`);\n\n  const skeleton = placeSkeleton(local, node.pose, descriptor);\n\n  const out: Reading = { skeleton, bindings: {}, skins: {}, refs: [node.pose, node.data] };\n  const walk = (parent: NodeId): void => {\n    for (const child of scene.childrenOf(parent)) {\n      const n = scene.get(child);\n      if (!n) continue;\n      const data = n.data as RigNodeData | null | undefined;\n      const skin = painted.get(child) ?? data?.skin;\n      out.refs.push(child, n.pose, n.data, skin);\n      if (skin) out.skins[child] = skin;\n      else if (data?.joint !== undefined) (out.bindings[data.joint] ??= []).push(child);\n      walk(child);\n    }\n  };\n  walk(id);\n  return out;\n}\n\nconst sameRefs = (a: Reading, b: Reading): boolean =>\n  a === b || (a.refs.length === b.refs.length && a.refs.every((r, i) => r === b.refs[i]));\n\n/**\n * Read a rig out of the scene: the skeleton in `id`'s `data.skeleton`, placed by that node's\n * pose, and under it every node whose data has a `skin` or names a `joint`.\n */\nexport function rigFromNode<TPose>(\n  scene: RigNodeSource<TPose>,\n  id: NodeId,\n  descriptor: PoseDescriptor<TPose> = AUTO_POSE_DESCRIPTOR as PoseDescriptor<TPose>,\n): RigNodeParts {\n  const { skeleton, bindings, skins } = read(scene, id, descriptor);\n  return { skeleton, bindings, skins };\n}\n\n/** Options for `useRigNode`. */\nexport interface UseRigNodeOptions<TPose>\n  extends Pick<BindRigOptions<TPose>, 'apply' | 'descriptor' | 'restPath'> {\n  scene: RigScene<TPose> & RigNodeSource<TPose> & {\n    subscribe(listener: () => void): () => void;\n    getVersion(): number;\n  };\n  /** The node whose data holds the skeleton. */\n  node: NodeId;\n  /** Weights bound in place of a node's `data.skin` while they are held. Give it the\n   *  `RigEditState` the weight tool has, and a stroke bends the path as it is painted. */\n  painting?: PaintedSkins;\n}\n\n/**\n * A {@link Rig} read from a node, as {@link rigFromNode} reads it. It is bound again when the\n * rig node or a node under it changes its pose or data, or when nodes under it come or go; an\n * edit elsewhere in the scene leaves it alone. A rig bound again keeps its `target`, with the\n * animations running on it, its committed pose, and its placement, unless the skeleton's\n * joints were added, removed, renamed, or reordered. Then it has a new `target`, which takes\n * over the placement and the pose of every joint the skeleton still names. Animations go on\n * running on the target they were started on and show through the new one, so a joint that\n * was renamed stops moving.\n */\nexport function useRigNode<TPose>(options: UseRigNodeOptions<TPose>): Rig {\n  const { scene, node, apply, descriptor, restPath, painting } = options;\n  const version = useSyncExternalStore(scene.subscribe, scene.getVersion);\n  const painted = useSyncExternalStore(painting?.listen ?? noWord, painting?.painted ?? unpainted);\n  const next = useMemo(\n    () => read(scene, node, descriptor ?? (AUTO_POSE_DESCRIPTOR as PoseDescriptor<TPose>), painted),\n    // `version` is what says the scene may answer differently.\n    // eslint-disable-next-line react-hooks/exhaustive-deps\n    [scene, node, descriptor, version, painted],\n  );\n  // Each read makes new objects; the rig must outlive a read that found nothing changed.\n  const [held, setHeld] = useState(next);\n  const parts = sameRefs(held, next) ? held : next;\n  if (parts !== held) setHeld(next);\n  const joints = JSON.stringify(parts.skeleton.joints.map((joint) => joint.name));\n  // A pose target's axes are its joints' names in order, so the seat holds while those do,\n  // and the next one takes over from it.\n  const [seated, setSeated] = useState(() => ({ joints, seat: createRigSeat(parts.skeleton) }));\n  let { seat } = seated;\n  if (seated.joints !== joints) {\n    seat = createRigSeat(parts.skeleton, seated.seat);\n    setSeated({ joints, seat });\n  }\n  return useSeatedRig({\n    scene, skeleton: parts.skeleton, bindings: parts.bindings, skins: parts.skins, apply, descriptor, restPath,\n  }, seat);\n}\n"],"mappings":"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"}

package/dist/animation/rig/rigSeat.js

@@ -0,0 +1,59 @@
+import { createTarget as e, skeletonAxes as t } from "@weasel-js/animator";
+//#region src/animation/rig/rigSeat.ts
+var n = (e) => e.target.active || e.carried !== null && n(e.carried.seat);
+function r(e) {
+	let { target: t } = e.seat, n = t.axes.to(t.read());
+	return e.axis.map((t) => t < 0 ? 0 : n[t] - e.from[t]);
+}
+function i(e, t) {
+	let n = {};
+	for (let { name: r } of t.joints) {
+		let t = e[r];
+		t && (n[r] = t);
+	}
+	return n;
+}
+function a(a, s) {
+	let c = t(a), l = (e, t, n) => c.from(c.to(e).map((e, r) => e + n * t[r])), u = {
+		committed: s ? i(s.target.read(), a) : {},
+		root: s?.root,
+		binding: null,
+		shown: s?.shown ?? !1,
+		carried: s && n(s) ? o(s, c.names ?? []) : null,
+		target: e({
+			get: () => {
+				let { carried: e } = u;
+				if (!e) return u.committed;
+				let t = l(u.committed, r(e), 1);
+				return n(e.seat) || (u.committed = t, u.carried = null), t;
+			},
+			set: (e) => {
+				let { carried: t } = u;
+				u.committed = t ? l(e, r(t), -1) : e;
+			},
+			axes: c,
+			show: (e) => u.binding?.show(e)
+		})
+	};
+	return u;
+}
+function o(e, t) {
+	let { target: n } = e, r = n.axes.names ?? [];
+	return {
+		seat: e,
+		from: n.axes.to(n.read()),
+		axis: t.map((e) => r.indexOf(e))
+	};
+}
+function s(e, t) {
+	e.binding = t;
+	let n = e.carried?.seat;
+	n && (n.binding = {
+		show: () => e.binding?.show(e.target.read()),
+		drop: () => {}
+	}), e.shown && t.show(e.target.read());
+}
+//#endregion
+export { a as createRigSeat, s as seatBinding };
+
+//# sourceMappingURL=rigSeat.js.map

package/dist/animation/rig/rigSeat.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rigSeat.js","names":["moving","seat","travel","carried","now","target","k","jointsOf","out","skeleton","joint","pose","name","createRigSeat","axes","skeletonAxes","shifted","v","sign","by","i","prior","carry","createTarget","had","names","seatBinding","binding"],"sources":["../../../src/animation/rig/rigSeat.ts"],"sourcesContent":["import type { GlMat3 } from '@weasel-js/geom';\nimport { createTarget, skeletonAxes, type Pose, type Skeleton, type Target } from '@weasel-js/animator';\n\n/** One binding of a rig to the scene: what a seat shows its pose through. */\nexport interface RigBinding {\n  show(pose: Pose): void;\n  /** Drop the overrides, leaving the seat as it is. */\n  drop(): void;\n}\n\n/** The seat another took over from, while something still moves its target. */\ninterface Carried {\n  seat: RigSeat;\n  /** That seat's target as it read when this one was made, as its axes. */\n  from: number[];\n  /** For each axis of this seat, that seat's axis of the same name; -1 where it has none. */\n  axis: number[];\n}\n\n/**\n * A rig's pose apart from the binding that shows it: the target, the committed pose, and the\n * placement. A rig bound again on the seat it had goes on under the animations running on its\n * target.\n */\nexport interface RigSeat {\n  readonly target: Target<Pose>;\n  /** The committed pose, less what `carried` adds to it. */\n  committed: Pose;\n  root: GlMat3 | undefined;\n  binding: RigBinding | null;\n  /** Whether the pose is on screen: set as a binding shows it, cleared as the rig is released. */\n  shown: boolean;\n  /** The seat this one took over from as the skeleton's joints changed. What moves that\n   *  seat's target since then is added to this one's, on the joints both skeletons name. */\n  carried: Carried | null;\n}\n\nconst moving = (seat: RigSeat): boolean =>\n  seat.target.active || (seat.carried !== null && moving(seat.carried.seat));\n\n/** How far `carried`'s target has moved since it was taken over from, in the new seat's axes. */\nfunction travel(carried: Carried): number[] {\n  const { target } = carried.seat;\n  const now = target.axes.to(target.read());\n  return carried.axis.map((k) => (k < 0 ? 0 : now[k]! - carried.from[k]!));\n}\n\n/** The joints of `pose` that `skeleton` names. */\nfunction jointsOf(pose: Pose, skeleton: Skeleton): Pose {\n  const out: Pose = {};\n  for (const { name } of skeleton.joints) {\n    const joint = pose[name];\n    if (joint) out[name] = joint;\n  }\n  return out;\n}\n\n/**\n * A seat for a skeleton with these joints in this order. With no `prior` it is at the bind\n * pose. With one, it takes over where that seat stands: its placement, and its pose on the\n * joints `skeleton` still names. Animations go on running on the prior seat's target, and\n * this one shows them.\n */\nexport function createRigSeat(skeleton: Skeleton, prior?: RigSeat): RigSeat {\n  const axes = skeletonAxes(skeleton);\n  const shifted = (pose: Pose, by: number[], sign: 1 | -1): Pose =>\n    axes.from(axes.to(pose).map((v, i) => v + sign * by[i]!));\n  const seat: RigSeat = {\n    committed: prior ? jointsOf(prior.target.read(), skeleton) : {},\n    root: prior?.root,\n    binding: null,\n    shown: prior?.shown ?? false,\n    carried: prior && moving(prior) ? carry(prior, axes.names ?? []) : null,\n    target: createTarget<Pose>({\n      get: () => {\n        const { carried } = seat;\n        if (!carried) return seat.committed;\n        const pose = shifted(seat.committed, travel(carried), 1);\n        if (!moving(carried.seat)) {\n          seat.committed = pose;\n          seat.carried = null;\n        }\n        return pose;\n      },\n      set: (pose) => {\n        const { carried } = seat;\n        seat.committed = carried ? shifted(pose, travel(carried), -1) : pose;\n      },\n      axes,\n      show: (pose) => seat.binding?.show(pose),\n    }),\n  };\n  return seat;\n}\n\nfunction carry(prior: RigSeat, names: readonly string[]): Carried {\n  const { target } = prior;\n  const had = target.axes.names ?? [];\n  return { seat: prior, from: target.axes.to(target.read()), axis: names.map((name) => had.indexOf(name)) };\n}\n\n/** Make `binding` the one `seat` shows through, and show it what the last one had on screen.\n *  A seat it took over from shows through it too. */\nexport function seatBinding(seat: RigSeat, binding: RigBinding): void {\n  seat.binding = binding;\n  const prior = seat.carried?.seat;\n  if (prior) prior.binding = { show: () => seat.binding?.show(seat.target.read()), drop: () => {} };\n  if (seat.shown) binding.show(seat.target.read());\n}\n"],"mappings":";;AAqCA,IAAMA,KAAU,MACdC,EAAK,OAAO,UAAWA,EAAK,YAAY,QAAQD,EAAOC,EAAK,QAAQ,IAAI;AAG1E,SAASC,EAAO,GAA4B;CAC1C,IAAM,EAAE,cAAWC,EAAQ,MACrBC,IAAMC,EAAO,KAAK,GAAGA,EAAO,KAAK,CAAC;CACxC,OAAOF,EAAQ,KAAK,KAAK,MAAOG,IAAI,IAAI,IAAIF,EAAIE,KAAMH,EAAQ,KAAKG,EAAI;AACzE;AAGA,SAASC,EAAS,GAAY,GAA0B;CACtD,IAAMC,IAAY,CAAC;CACnB,KAAK,IAAM,EAAE,aAAUC,EAAS,QAAQ;EACtC,IAAMC,IAAQC,EAAKC;EACnB,AAAIF,MAAO,EAAIE,KAAQF;CACzB;CACA,OAAOF;AACT;AAQA,SAAgBK,EAAc,GAAoB,GAA0B;CAC1E,IAAMC,IAAOC,EAAaN,CAAQ,GAC5BO,KAAW,GAAY,GAAc,MACzCF,EAAK,KAAKA,EAAK,GAAGH,CAAI,CAAC,CAAC,KAAK,GAAG,MAAMM,IAAIC,IAAOC,EAAGC,EAAG,CAAC,GACpDnB,IAAgB;EACpB,WAAWoB,IAAQd,EAASc,EAAM,OAAO,KAAK,GAAGZ,CAAQ,IAAI,CAAC;EAC9D,MAAMY,GAAO;EACb,SAAS;EACT,OAAOA,GAAO,SAAS;EACvB,SAASA,KAASrB,EAAOqB,CAAK,IAAIC,EAAMD,GAAOP,EAAK,SAAS,CAAC,CAAC,IAAI;EACnE,QAAQS,EAAmB;GACzB,WAAW;IACT,IAAM,EAAE,eAAYtB;IACpB,IAAI,CAACE,GAAS,OAAOF,EAAK;IAC1B,IAAMU,IAAOK,EAAQf,EAAK,WAAWC,EAAOC,CAAO,GAAG,CAAC;IAKvD,OAJKH,EAAOG,EAAQ,IAAI,MACtB,EAAK,YAAYQ,GACjB,EAAK,UAAU,OAEVA;GACT;GACA,MAAM,MAAS;IACb,IAAM,EAAE,eAAYV;IACpB,EAAK,YAAYE,IAAUa,EAAQL,GAAMT,EAAOC,CAAO,GAAG,EAAE,IAAIQ;GAClE;GACA;GACA,OAAO,MAASV,EAAK,SAAS,KAAKU,CAAI;EACzC,CAAC;CACH;CACA,OAAOV;AACT;AAEA,SAASqB,EAAM,GAAgB,GAAmC;CAChE,IAAM,EAAE,cAAWD,GACbG,IAAMnB,EAAO,KAAK,SAAS,CAAC;CAClC,OAAO;EAAE,MAAMgB;EAAO,MAAMhB,EAAO,KAAK,GAAGA,EAAO,KAAK,CAAC;EAAG,MAAMoB,EAAM,KAAK,MAASD,EAAI,QAAQZ,CAAI,CAAC;CAAE;AAC1G;AAIA,SAAgBc,EAAY,GAAe,GAA2B;CACpE,EAAK,UAAUC;CACf,IAAMN,IAAQpB,EAAK,SAAS;CAE5B,AADIoB,MAAO,EAAM,UAAU;EAAE,YAAYpB,EAAK,SAAS,KAAKA,EAAK,OAAO,KAAK,CAAC;EAAG,YAAY,CAAC;CAAE,IAC5FA,EAAK,SAAO0B,EAAQ,KAAK1B,EAAK,OAAO,KAAK,CAAC;AACjD"}