@weasel-js/core 1.9.4 → 1.10.0

package/dist/animation/poseHelpers.js.map

@@ -1 +1 @@
-{"version":3,"file":"poseHelpers.js","names":["cancelKeyFor","id","recordTransformOp","adapter","op","createTransformOp","label","tweenPose","geometry","opts","RECT_POSE_DESCRIPTOR","lerp","from","recordOp","animator","a","b","t","value","springPose","progress"],"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 { SceneAdapter } from 'core/adapters/types';\nimport type { AnimationHandle, Animator, EasingSpec, SpringPresetName } from './types';\n\n/** Options for `tweenPose`. */\nexport interface TweenPoseOptions<TPose> {\n  id: string;\n  to: TPose;\n  ms: number;\n  easing?: EasingSpec;\n  /** Pose descriptor with a `lerp(from, to, t)` method. Defaults to\n   *  `RECT_POSE_DESCRIPTOR`, which interpolates x/y/width/height linearly. */\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  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  onDone?: () => void;\n}\n\nconst cancelKeyFor = (id: string): string => `pose:${id}`;\n\nfunction recordTransformOp<TPose>(\n  adapter: SceneAdapter<{ id: string }, 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`, writing each frame through the\n * adapter.\n *\n * Unlike the color helpers this really does move the node. Undo therefore has\n * to be considered: by default a single transform op covering the whole\n * animation is recorded up front, so one undo returns the node to where it\n * started rather than replaying frames.\n */\nexport function tweenPose<TNode extends { id: string }, TPose>(\n  animator: Animator,\n  adapter: SceneAdapter<TNode, TPose>,\n  opts: TweenPoseOptions<TPose>,\n): AnimationHandle {\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  const recordOp = opts.recordOp ?? true;\n  const label = opts.opLabel ?? 'animate';\n  if (recordOp) recordTransformOp(adapter as never, opts.id, from, opts.to, label);\n  return animator.tween<TPose>({\n    from,\n    to: opts.to,\n    ms: opts.ms,\n    easing: opts.easing,\n    cancelKey: cancelKeyFor(opts.id),\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/** `tweenPose` driven by a spring instead of a duration. Same op-recording\n *  behavior. */\nexport function springPose<TNode extends { id: string }, TPose>(\n  animator: Animator,\n  adapter: SceneAdapter<TNode, TPose>,\n  opts: SpringPoseOptions<TPose>,\n): AnimationHandle {\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  const recordOp = opts.recordOp ?? true;\n  const label = opts.opLabel ?? 'animate';\n  if (recordOp) recordTransformOp(adapter as never, opts.id, from, opts.to, label);\n  // For pose springs: integrate progress (0..1) as the spring's value, then\n  // use lerp(from, to, progress) for the actual visual write. This avoids\n  // requiring full add/subtract/scale/magnitude on TPose.\n  const progressLerp = (a: number, b: number, t: number) => a + (b - a) * t;\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: cancelKeyFor(opts.id),\n    interpolate: progressLerp,\n    onTick: (progress) => adapter.setPose(opts.id, lerp(from, opts.to, progress)),\n    onDone: opts.onDone,\n  });\n}\n"],"mappings":";;;AAoCA,IAAMA,KAAgB,MAAuB,QAAQC;AAErD,SAASC,EACP,GACA,GACA,GACA,GACA,GACM;CACN,IAAI,CAACC,EAAQ,UAAU;CACvB,IAAMC,IAAKC,EAAyB;EAAE;EAAI;EAAM;EAAI;CAAM,CAAC;CAC3D,EAAQ,SAAS,CAACD,CAAE,GAAGE,CAAK;AAC9B;AAWA,SAAgBC,EACd,GACA,GACA,GACiB;CACjB,IAAMC,IAAYC,EAAK,YAAaC;CACpC,IAAI,CAACF,EAAS,MACZ,MAAU,MAAM,iEAAiE;CAEnF,IAAMG,IAAOH,EAAS,MAChBI,IAAOT,EAAQ,QAAQM,EAAK,EAAE,GAC9BI,IAAWJ,EAAK,YAAY,IAC5BH,IAAQG,EAAK,WAAW;CAE9B,OADII,KAAUX,EAAkBC,GAAkBM,EAAK,IAAIG,GAAMH,EAAK,IAAIH,CAAK,GACxEQ,EAAS,MAAa;EAC3B;EACA,IAAIL,EAAK;EACT,IAAIA,EAAK;EACT,QAAQA,EAAK;EACb,WAAWT,EAAaS,EAAK,EAAE;EAC/B,cAAc,GAAG,GAAG,MAAME,EAAKI,GAAGC,GAAGC,CAAC;EACtC,SAAS,MAAUd,EAAQ,QAAQM,EAAK,IAAIS,CAAK;EACjD,QAAQT,EAAK;CACf,CAAC;AACH;AAIA,SAAgBU,EACd,GACA,GACA,GACiB;CACjB,IAAMX,IAAYC,EAAK,YAAaC;CACpC,IAAI,CAACF,EAAS,MACZ,MAAU,MAAM,kEAAkE;CAEpF,IAAMG,IAAOH,EAAS,MAChBI,IAAOT,EAAQ,QAAQM,EAAK,EAAE,GAC9BI,IAAWJ,EAAK,YAAY,IAC5BH,IAAQG,EAAK,WAAW;CAM9B,OALII,KAAUX,EAAkBC,GAAkBM,EAAK,IAAIG,GAAMH,EAAK,IAAIH,CAAK,GAKxEQ,EAAS,OAAe;EAC7B,MAAM;EACN,IAAI;EACJ,QAAQL,EAAK;EACb,WAAWA,EAAK;EAChB,SAASA,EAAK;EACd,MAAMA,EAAK;EACX,WAAWT,EAAaS,EAAK,EAAE;EAC/B,cAToB,GAAW,GAAW,MAAcM,KAAKC,IAAID,KAAKE;EAUtE,SAAS,MAAad,EAAQ,QAAQM,EAAK,IAAIE,EAAKC,GAAMH,EAAK,IAAIW,CAAQ,CAAC;EAC5E,QAAQX,EAAK;CACf,CAAC;AACH"}
+{"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":";;;;AA+DA,IAAaA,KAAW,MAAuB,QAAQC;AAEvD,SAASC,EACP,GACA,GACA,GACA,GACA,GACM;CACN,IAAI,CAACC,EAAQ,UAAU;CACvB,IAAMC,IAAKC,EAAyB;EAAE;EAAI;EAAM;EAAI;CAAM,CAAC;CAC3D,EAAQ,SAAS,CAACD,CAAE,GAAGE,CAAK;AAC9B;AAmBA,SAAgBC,EACd,GACA,GACA,GACiB;CACjB,IAAMC,IAAWC,EAAK,YAAY,IAC5BH,IAAQG,EAAK,WAAW,WACxBC,IAAYV,EAAQS,EAAK,EAAE,GAC3BE,IAASR,EAAQ,aAAaM,EAAK,IAAIA,EAAK,QAAQ;CAC1D,IAAIE,GAAQ;EACV,IAAMC,IAAYD,EAAO,UAAU;EACnC,AAAIH,KAAUN,EAAkBC,GAASM,EAAK,IAAIG,GAAWH,EAAK,IAAIH,CAAK;EAC3E,IAAMO,IAAOJ,EAAK,UAAU;EAO5B,OANIA,EAAK,SACAK,EAAeC,GAAUJ,GAAQ;GACtC,OAAOC;GAAW,MAAMH,EAAK,QAAQG;GAAW,IAAIH,EAAK;GAAI,IAAIA,EAAK;GAAI,QAAQA,EAAK;GACvF;GAAW,aAAaI,OAAU,GAAG,GAAG,MAAMA,EAAKG,GAAGC,GAAGC,CAAC;GAAI,QAAQT,EAAK;EAC7E,CAAC,IAEIM,EAAS,MAAa;GAC3B;GACA,MAAMN,EAAK,QAAQG;GACnB,IAAIH,EAAK;GACT,IAAIA,EAAK;GACT,QAAQA,EAAK;GACb;GACA,WAAW;GACX,aAAaI,OAAU,GAAG,GAAG,MAAMA,EAAKG,GAAGC,GAAGC,CAAC;GAC/C,QAAQT,EAAK;EACf,CAAC;CACH;CACA,IAAMU,IAAYV,EAAK,YAAaW;CACpC,IAAI,CAACD,EAAS,MACZ,MAAU,MAAM,iEAAiE;CAEnF,IAAMN,IAAOM,EAAS,MAChBE,IAAOlB,EAAQ,QAAQM,EAAK,EAAE;CAEpC,OADID,KAAUN,EAAkBC,GAASM,EAAK,IAAIY,GAAMZ,EAAK,IAAIH,CAAK,GAC/DS,EAAS,MAAa;EAC3B,MAAMN,EAAK,QAAQY;EACnB,IAAIZ,EAAK;EACT,IAAIA,EAAK;EACT,QAAQA,EAAK;EACb;EACA,cAAc,GAAG,GAAG,MAAMI,EAAKG,GAAGC,GAAGC,CAAC;EACtC,SAAS,MAAUf,EAAQ,QAAQM,EAAK,IAAIa,CAAK;EACjD,QAAQb,EAAK;CACf,CAAC;AACH;AAQA,SAAgBc,EACd,GACA,GACA,GACiB;CACjB,IAAMf,IAAWC,EAAK,YAAY,IAC5BH,IAAQG,EAAK,WAAW,WACxBC,IAAYV,EAAQS,EAAK,EAAE,GAC3BE,IAASR,EAAQ,aAAaM,EAAK,IAAIA,EAAK,QAAQ;CAC1D,IAAIE,GAAQ;EAGV,IAAMa,IAAQb,EAAO,KAAK,GACpBC,IAAYD,EAAO,UAAU;EAQnC,OAPIH,KAAUN,EAAkBC,GAASM,EAAK,IAAIG,GAAWH,EAAK,IAAIH,CAAK,GACvEG,EAAK,SACAgB,EAAgBV,GAAUJ,GAAQ;GACvC,OAAOC;GAAW,MAAMY;GAAO,IAAIf,EAAK;GAAI;GAAW,QAAQA,EAAK;GACpE,QAAQ;IAAE,QAAQA,EAAK;IAAQ,WAAWA,EAAK;IAAW,SAASA,EAAK;IAAS,MAAMA,EAAK;GAAK;EACnG,CAAC,IAEIM,EAAS,OAAc;GAC5B;GACA,MAAMS;GACN,IAAIf,EAAK;GACT,QAAQA,EAAK;GACb,WAAWA,EAAK;GAChB,SAASA,EAAK;GACd,MAAMA,EAAK;GACX;GACA,QAAQA,EAAK;EACf,CAAC;CACH;CACA,IAAMU,IAAYV,EAAK,YAAaW;CACpC,IAAI,CAACD,EAAS,MACZ,MAAU,MAAM,kEAAkE;CAEpF,IAAMN,IAAOM,EAAS,MAChBE,IAAOlB,EAAQ,QAAQM,EAAK,EAAE;CAGpC,OAFID,KAAUN,EAAkBC,GAASM,EAAK,IAAIY,GAAMZ,EAAK,IAAIH,CAAK,GAE/DS,EAAS,OAAe;EAC7B,MAAM;EACN,IAAI;EACJ,QAAQN,EAAK;EACb,WAAWA,EAAK;EAChB,SAASA,EAAK;EACd,MAAMA,EAAK;EACX;EACA,cAAc,GAAG,GAAG,MAAMO,KAAKC,IAAID,KAAKE;EACxC,SAAS,MAAaf,EAAQ,QAAQM,EAAK,IAAII,EAAKQ,GAAMZ,EAAK,IAAIiB,CAAQ,CAAC;EAC5E,QAAQjB,EAAK;CACf,CAAC;AACH;AAqBA,SAASkB,EAAO,GAAuB;CACrC,IAAoB,OAAOC,KAAS,YAAhCA,KAA4C,QAAQA,GAAM;EAC5D,IAAM3B,IAAM2B,EAAyB;EACrC,IAAI,OAAO3B,KAAO,UAAU,OAAOA;CACrC;CACA,IAAI,OAAO2B,KAAS,YAAY,OAAOA,KAAS,UAAU,OAAO,OAAOA,CAAI;CAC5E,MAAU,MACR,wIAEF;AACF;AAGA,SAAgBC,EACd,GACA,GACA,GACiB;CACjB,OAAOd,EAAS,QAAQN,EAAK,OAAOA,EAAK,KAAK,CAAC,CAAC,MAC7C,GAAM,MACLc,EAAWR,GAAUZ,GAAS;EAC5B,IAAIwB,EAAOC,CAAI;EACf,IAAInB,EAAK,GAAGmB,GAAM,CAAC;EACnB,QAAQnB,EAAK;EACb,WAAWA,EAAK;EAChB,SAASA,EAAK;EACd,MAAMA,EAAK;EACX,UAAUA,EAAK;EACf,UAAUA,EAAK;EACf,SAASA,EAAK;EACd,QAAQA,EAAK;CACf,CAAC,GACH;EAAE,WAAWA,EAAK;EAAW,OAAOA,EAAK;CAAM,CACjD;AACF"}

package/dist/animation/poseTarget.js

@@ -0,0 +1,115 @@
+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";
+//#region src/animation/poseTarget.ts
+function i(e, t) {
+	return e?.axes?.(t) ?? n(t);
+}
+var a = /* @__PURE__ */ new WeakMap();
+function o(e) {
+	let t = a.get(e);
+	return t || (t = () => e.commit(), a.set(e, t)), t;
+}
+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;
+		}
+		return r;
+	};
+	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]));
+		}),
+		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;
+			});
+		})
+	};
+}
+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);
+			}
+			t.pose = o, i.add(a);
+		}
+		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);
+				return;
+			}
+			d = !1, a.get(c) === u && a.clear(c), i?.(null), t?.();
+		},
+		publish: o(a)
+	});
+	return f;
+}
+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;
+}
+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]);
+}
+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,
+		get() {
+			let t = n.get(u);
+			return t && (_ = e(n, t)), t && !b?.active && (v = t.pose), _;
+		},
+		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);
+		}
+	}, () => {
+		n.get(u) || y.delete(r);
+	}, () => {
+		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;
+}
+//#endregion
+export { u as createPoseTarget, s as liveAxes, i as poseAxes, p as scenePoseTarget };
+
+//# sourceMappingURL=poseTarget.js.map

package/dist/animation/poseTarget.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"poseTarget.js","names":["poseAxes","descriptor","like","axesOf","publishers","publisherOf","publish","overrides","liveAxes","get","axes","current","now","next","count","p","a","d","n","i","out","at","riders","riding","seen","id","beside","pose","cascade","entry","build","opts","installed","target","createTarget","overwritten","ride","onRest","createPoseTarget","sceneTargets","samePose","b","ka","k","scenePoseTarget","made","scene","nid","node","by","RECT_POSE_DESCRIPTOR","held","fits","documentPose","last","mine","cache"],"sources":["../../src/animation/poseTarget.ts"],"sourcesContent":["import { RECT_POSE_DESCRIPTOR, type PoseDescriptor } from '../core/geometry/poseDescriptor';\nimport { documentPose, type PoseSource } from '../core/scene/effectivePose';\nimport type { NodeId, PoseOverride, PoseOverrides } from '../core/scene/types';\nimport { axesOf } from '@weasel-js/animator';\nimport { createTarget, type Target, type TargetAxes } from '@weasel-js/animator';\n\n/** What {@link createPoseTarget} takes. */\nexport interface PoseTargetOptions<TPose> {\n  /** The node whose pose it is. */\n  id: string;\n  /** The node's committed pose: where the document says it is. */\n  get(): TPose;\n  /** Commits a pose: an animation's destination as it starts, and where a canceled one stopped. */\n  set(pose: TPose): void;\n  /** Where the pose on screen is published while the node moves. */\n  overrides: PoseOverrides<TPose>;\n  /** Supplies the pose's axes through `PoseDescriptor.axes`. Without one, or where it answers\n   *  null, the pose has to be a number, an array of numbers, or an object of numeric fields. */\n  descriptor?: PoseDescriptor<TPose>;\n}\n\n/** The part of a scene {@link scenePoseTarget} reads and writes. A `Scene` satisfies it. */\nexport interface PoseTargetScene<TPose> extends PoseSource<TPose> {\n  readonly overrides: PoseOverrides<TPose>;\n  setPose(id: NodeId, pose: TPose): void;\n  untracked<T>(fn: () => T): T;\n}\n\n/** How `like`'s kind of pose maps to axes: the descriptor's own mapping, else its flat numeric\n *  fields. Null for a pose with neither. */\nexport function poseAxes<TPose>(\n  descriptor: PoseDescriptor<TPose> | undefined,\n  like: TPose,\n): TargetAxes<TPose> | null {\n  return descriptor?.axes?.(like) ?? (axesOf(like) as TargetAxes<TPose> | null);\n}\n\nconst publishers = new WeakMap<object, () => void>();\n\n/** One function per overrides table, so every target publishing into it shares one commit a frame. */\nfunction publisherOf<TPose>(overrides: PoseOverrides<TPose>): () => void {\n  let publish = publishers.get(overrides);\n  if (!publish) {\n    publish = () => overrides.commit();\n    publishers.set(overrides, publish);\n  }\n  return publish;\n}\n\n/**\n * `poseAxes` for the pose `get` answers, with `from` keeping the fields that are not axes as\n * that pose has them now. Reading them once would leave them stale in every pose a canceled\n * animation commits. Null where the pose has no axes.\n */\nexport function liveAxes<TPose>(\n  descriptor: PoseDescriptor<TPose> | undefined,\n  get: () => TPose,\n): TargetAxes<TPose> | null {\n  let like = get();\n  let axes = poseAxes(descriptor, like);\n  if (!axes) return null;\n  const { count, angles } = axes;\n  const current = (): TargetAxes<TPose> => {\n    const now = get();\n    if (now !== like) {\n      const next = poseAxes(descriptor, now);\n      if (next && next.count === count) axes = next;\n      like = now;\n    }\n    return axes!;\n  };\n  return {\n    count,\n    angles,\n    to: (p) => current().to(p),\n    from: (a) => current().from(a),\n    add: axes.add && ((p, d) => {\n      const now = current();\n      if (now.add) return now.add(p, d);\n      return now.from(now.to(p).map((n, i) => n + d[i]!));\n    }),\n    write: axes.write && ((p, out, at) => {\n      const now = current();\n      if (now.write) now.write(p, out, at);\n      else now.to(p).forEach((n, i) => { out[at + i] = n; });\n    }),\n  };\n}\n\n/** How a container's pose target carries its descendants, for {@link scenePoseTarget}. */\nexport interface PoseCascade<TPose> {\n  /** Commits `pose` to the container, moving its descendants' poses with it. */\n  write(pose: TPose): void;\n  /** The descendants, each at the pose to show it at while the container shows at `pose`. */\n  beside(pose: TPose): Iterable<readonly [NodeId, TPose]>;\n}\n\n/** Shows a moving container's descendants through overrides of their own, and takes them back\n *  as it rests. A descendant something else already overrides is left to it. */\nfunction riders<TPose>(overrides: PoseOverrides<TPose>, cascade: PoseCascade<TPose>): (pose: TPose | null) => void {\n  const riding = new Map<NodeId, PoseOverride<TPose>>();\n  return (pose) => {\n    const seen = new Set<NodeId>();\n    for (const [id, beside] of pose === null ? [] : cascade.beside(pose)) {\n      let entry = riding.get(id);\n      if (!entry) {\n        if (overrides.has(id)) continue;\n        riding.set(id, entry = {});\n        overrides.set(id, entry);\n      }\n      entry.pose = beside;\n      seen.add(id);\n    }\n    for (const [id, entry] of riding) {\n      if (seen.has(id)) continue;\n      if (overrides.get(id) === entry) overrides.clear(id);\n      riding.delete(id);\n    }\n  };\n}\n\nfunction build<TPose>(\n  opts: PoseTargetOptions<TPose>,\n  onRest?: () => void,\n  /** Whether something else has written the committed pose since an animation last did. */\n  overwritten?: () => boolean,\n  /** Told the pose on screen each time it is shown, and null as the node comes to rest. */\n  ride?: (pose: TPose | null) => void,\n): Target<TPose> | null {\n  const { overrides } = opts;\n  const id = opts.id as NodeId;\n  const axes = liveAxes(opts.descriptor, opts.get);\n  if (!axes) return null;\n  const entry: PoseOverride<TPose> = {};\n  let installed = false;\n  const target = createTarget<TPose>({\n    get: opts.get,\n    set: opts.set,\n    axes,\n    show(pose) {\n      // The writer wins: what was left to travel belonged to a pose that is no longer committed.\n      if (target.active && overwritten?.()) target.stop({ commit: false });\n      if (target.active) {\n        entry.pose = pose;\n        // Installed once per run: an override laid over it since, a drag's, is not taken back.\n        if (!installed) overrides.set(id, entry);\n        installed = true;\n        ride?.(pose);\n        return;\n      }\n      installed = false;\n      if (overrides.get(id) === entry) overrides.clear(id);\n      ride?.(null);\n      onRest?.();\n    },\n    publish: publisherOf(overrides),\n  });\n  return target;\n}\n\n/**\n * A {@link Target} over one node's pose. Animations on it commit their destination through\n * `set` as they start, and the pose on screen reaches the paint and pick walks as a pose\n * override: installed while the node moves and cleared when it comes to rest.\n *\n * Throws for a pose with no axes. Make one per node: two targets over one node do not add.\n * {@link scenePoseTarget} keeps that one for a scene's nodes.\n */\nexport function createPoseTarget<TPose>(opts: PoseTargetOptions<TPose>): Target<TPose> {\n  const target = build(opts);\n  if (!target) {\n    throw new Error('createPoseTarget: this pose has no axes; give a descriptor whose `axes` maps it');\n  }\n  return target;\n}\n\nconst sceneTargets = new WeakMap<object, Map<string, Target<unknown>>>();\n\nfunction samePose(a: unknown, b: unknown): boolean {\n  if (a === b) return true;\n  if (typeof a !== 'object' || typeof b !== 'object' || a === null || b === null) return false;\n  const ka = Object.keys(a);\n  return ka.length === Object.keys(b).length\n    && ka.every((k) => (a as Record<string, unknown>)[k] === (b as Record<string, unknown>)[k]);\n}\n\n/**\n * The pose target of node `id` in `scene`: the same one on every call, so everything animating\n * the node adds. Its committed value is the node's document pose, written without recording;\n * a caller that wants the move in history records its own op first.\n *\n * Undefined for a node that is not in the scene, or whose pose has no axes. `descriptor`\n * defaults to `RECT_POSE_DESCRIPTOR`. With `cascade`, for a container whose descendants hold\n * poses of their own, a commit goes through `cascade.write` and the descendants are shown\n * traveling beside the container. Both are read the first time a node's target is made.\n */\nexport function scenePoseTarget<TPose>(\n  scene: PoseTargetScene<TPose>,\n  id: string,\n  descriptor?: PoseDescriptor<TPose>,\n  cascade?: PoseCascade<TPose>,\n): Target<TPose> | undefined {\n  let made = sceneTargets.get(scene.overrides);\n  if (!made) {\n    made = new Map();\n    sceneTargets.set(scene.overrides, made);\n  }\n  const nid = id as NodeId;\n  const node = scene.get(nid);\n  const by = descriptor ?? (RECT_POSE_DESCRIPTOR as unknown as PoseDescriptor<TPose>);\n  const held = made.get(id) as Target<TPose> | undefined;\n  // A pose that has changed shape at rest, a polygon given more points, needs axes made for it.\n  const fits = !held || held.active || !node\n    || poseAxes(by, documentPose(scene, node))?.count === held.axisCount;\n  if (held && fits) return held;\n  if (!node) return undefined;\n  // A node removed mid-flight keeps answering with the last pose it had.\n  let last = documentPose(scene, node);\n  /** The node's pose as an animation last left it, or as it was when the first one started. */\n  let mine: TPose | undefined;\n  const cache = made;\n  let target: Target<TPose> | null = null;\n  target = build<TPose>({\n    id,\n    descriptor: by,\n    overrides: scene.overrides,\n    get() {\n      const n = scene.get(nid);\n      if (n) last = documentPose(scene, n);\n      if (n && !target?.active) mine = n.pose;\n      return last;\n    },\n    set(pose) {\n      const n = scene.get(nid);\n      if (!n) return;\n      if (!samePose(n.pose, pose)) scene.untracked(() => (cascade ? cascade.write(pose) : scene.setPose(nid, pose)));\n      mine = scene.get(nid)?.pose;\n    },\n  }, () => {\n    if (!scene.get(nid)) cache.delete(id);\n  }, () => {\n    const n = scene.get(nid);\n    return !!n && mine !== undefined && !samePose(n.pose, mine);\n  }, cascade && riders(scene.overrides, cascade));\n  if (!target) return undefined;\n  made.set(id, target as Target<unknown>);\n  return target;\n}\n"],"mappings":"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"}

package/dist/animation/reflow.js

@@ -1,121 +1,151 @@
 import { documentPose as e, effectivePose as t } from "../core/scene/effectivePose.js";
 import { RECT_POSE_DESCRIPTOR as n } from "../core/geometry/poseDescriptor.js";
-import { useEffect as r, useMemo as i } from "react";
-import { useLatest as a } from "@weasel-js/react";
+import { liveAxes as r } from "./poseTarget.js";
+import { useEffect as i, useMemo as a } from "react";
+import { useLatest as o } from "@weasel-js/react";
+import { createTarget as s } from "@weasel-js/animator";
 //#region src/animation/reflow.ts
-var o = (e) => `reflow:${e}`;
-function s(e, t) {
+var c = (e) => `reflow:${e}`;
+function l(e, t) {
 	if (Object.is(e, t)) return !0;
 	if (typeof e != "object" || typeof t != "object" || e === null || t === null || Array.isArray(e) !== Array.isArray(t)) return !1;
 	let n = Object.keys(e);
 	if (n.length !== Object.keys(t).length) return !1;
-	for (let r of n) if (!s(e[r], t[r])) return !1;
+	for (let r of n) if (!l(e[r], t[r])) return !1;
 	return !0;
 }
-function c(r, i, a) {
-	let c = /* @__PURE__ */ new Map(), l = !1, u = null, d = () => {
-		u ||= i.onTick(() => {
-			l && (l = !1, r.overrides.commit());
+function u(i, a, o) {
+	let u = /* @__PURE__ */ new Map(), d = !1, f = null, p = () => {
+		f ||= a.onTick(() => {
+			d && (d = !1, i.overrides.commit());
 		});
-	}, f = () => {
-		c.size > 0 || !u || (u(), u = null);
-	}, p = (e, t) => {
-		c.get(e) === t && c.delete(e);
+	}, m = () => {
+		u.size > 0 || !f || (f(), f = null);
+	}, h = (e, t) => {
+		u.get(e) === t && u.delete(e);
 		let n = e;
-		r.overrides.get(n) === t.entry && r.overrides.clear(n), l = !0;
-	}, m = (e, t, c, u) => {
-		let m = t.entry.pose;
-		if (t.target = c, t.settling = u, s(m, c)) {
-			t.handle?.cancel(), t.handle = null, t.entry.pose = c, u && p(e, t), r.overrides.commit(), f();
+		i.overrides.get(n) === t.entry && i.overrides.clear(n), d = !0;
+	}, g = (e, t, n, r) => {
+		let s = t.entry.pose;
+		if (t.settling = r, l(s, n)) {
+			a.cancelKey(c(e)), t.slot = n, t.entry.pose = n, r && h(e, t), i.overrides.commit(), m();
 			return;
 		}
-		let h = a(), g = (h.geometry ?? n).lerp;
-		if (!g) throw Error("useAnimatedReflow: geometry has no lerp; supply geometry: { ..., lerp }");
-		let _ = (e) => {
-			t.entry.pose = g(m, c, e), l = !0;
-		}, v = () => {
-			t.handle = null, t.settling && (p(e, t), f());
-		}, y = o(e), b = h.label ?? "reflow";
-		d(), t.handle = h.spring ? i.spring({
-			from: 0,
-			to: 1,
-			...h.spring,
-			cancelKey: y,
-			label: b,
-			onTick: _,
-			onDone: v
-		}) : i.tween({
-			from: 0,
-			to: 1,
-			ms: h.ms ?? 200,
-			easing: h.easing,
-			cancelKey: y,
-			label: b,
-			onTick: _,
-			onDone: v
-		}), r.overrides.commit();
-	}, h = (e, t) => i.isActive(o(e)) || s(t.entry.pose, t.target), g = (e) => {
-		let t = c.get(e);
-		if (!t) return;
-		c.delete(e), t.handle?.cancel();
-		let n = e;
-		r.overrides.get(n) === t.entry && (r.overrides.clear(n), r.overrides.commit()), f();
-	}, _ = (e, n, i, a) => {
-		if (i) a !== void 0 && (i.entry.pose = a);
+		if (t.target?.active && l(t.slot, n)) return;
+		let u = o(), f = u.geometry?.lerp, g = () => {
+			!t.target?.active && t.settling && (h(e, t), m());
+		}, _ = c(e), v = u.label ?? "reflow";
+		if (p(), t.target) u.spring ? a.spring({
+			target: t.target,
+			to: n,
+			...u.spring,
+			cancelKey: _,
+			label: v,
+			onDone: g
+		}) : a.tween({
+			target: t.target,
+			to: n,
+			ms: u.ms ?? 200,
+			easing: u.easing,
+			cancelKey: _,
+			interrupt: !1,
+			label: v,
+			onDone: g,
+			interpolate: f && ((e, t, n) => f(e, t, n))
+		});
 		else {
-			let o = a ?? t(r, n);
-			i = {
-				entry: { pose: o },
-				target: o,
-				settling: !1,
-				handle: null
-			}, c.set(e, i);
+			if (!f) throw Error("useAnimatedReflow: this pose has no axes; supply geometry: { ..., lerp }");
+			t.slot = n;
+			let e = (e) => {
+				t.entry.pose = f(s, n, e), d = !0;
+			};
+			u.spring ? a.spring({
+				from: 0,
+				to: 1,
+				...u.spring,
+				cancelKey: _,
+				label: v,
+				onTick: e,
+				onDone: g
+			}) : a.tween({
+				from: 0,
+				to: 1,
+				ms: u.ms ?? 200,
+				easing: u.easing,
+				cancelKey: _,
+				label: v,
+				onTick: e,
+				onDone: g
+			});
 		}
-		return r.overrides.get(e) !== i.entry && r.overrides.set(e, i.entry), i;
-	};
+		i.overrides.commit();
+	}, _ = (e, t) => a.isActive(c(e)) || l(t.entry.pose, t.slot), v = (e) => {
+		let t = u.get(e);
+		if (!t) return;
+		u.delete(e), a.cancelKey(c(e));
+		let n = e;
+		i.overrides.get(n) === t.entry && (i.overrides.clear(n), i.overrides.commit()), m();
+	}, y = (e, t) => {
+		let i = {
+			entry: { pose: t },
+			slot: t,
+			settling: !1,
+			target: null
+		}, a = o().geometry ?? n, c = r(a, () => i.slot);
+		return c && (i.target = s({
+			axes: c,
+			get: () => i.slot,
+			set: (e) => {
+				i.slot = e;
+			},
+			show: (e) => {
+				i.entry.pose = e, d = !0;
+			}
+		})), u.set(e, i), i;
+	}, b = (e, n, r, o) => (r ? o !== void 0 && (a.cancelKey(c(e)), r.slot = o, r.entry.pose = o) : r = y(e, o ?? t(i, n)), i.overrides.get(e) !== r.entry && i.overrides.set(e, r.entry), r);
 	return {
 		glide(e, t, n) {
-			let i = r.get(e);
-			if (!i) return;
-			let a = n?.from, o = c.get(e);
-			o && a === void 0 && !o.settling && s(o.target, t) && h(e, o) || m(e, _(e, i, o, a), t, !1);
+			let r = i.get(e);
+			if (!r) return;
+			let a = n?.from, o = u.get(e);
+			o && a === void 0 && !o.settling && l(o.slot, t) && _(e, o) || g(e, b(e, r, o, a), t, !1);
 		},
 		settle(t, n) {
-			let i = n?.from, a = c.get(t);
-			if (!a && i === void 0) return;
-			let o = r.get(t);
+			let r = n?.from, a = u.get(t);
+			if (!a && r === void 0) return;
+			let o = i.get(t);
 			if (!o) {
-				g(t);
+				v(t);
 				return;
 			}
-			let l = e(r, o);
-			if (a && i === void 0) {
-				if (a.settling && s(a.target, l) && h(t, a)) return;
-				m(t, a, l, !0);
+			let s = e(i, o);
+			if (a && r === void 0) {
+				if (a.settling && l(a.slot, s) && _(t, a)) return;
+				g(t, a, s, !0);
 				return;
 			}
-			m(t, _(t, o, a, i), l, !0);
+			g(t, b(t, o, a, r), s, !0);
 		},
-		stop: g,
-		poseOf: (e) => c.get(e)?.entry.pose,
+		stop: v,
+		poseOf: (e) => u.get(e)?.entry.pose,
 		dispose() {
-			for (let e of [...c.keys()]) g(e);
+			for (let e of [...u.keys()]) v(e);
 		}
 	};
 }
-function l(e, t, n = {}) {
-	return c(e, t, () => n);
+function d(e, t, n = {}) {
+	return u(e, t, () => n);
 }
-function u(e, t, n) {
-	let o = a(n || {}), s = !!n, l = i(() => s ? c(e, t, () => o.current) : null, [
+function f(e, t, n) {
+	let r = o(n || {}), s = !!n, c = a(() => s ? u(e, t, () => r.current) : null, [
 		s,
 		e,
 		t,
-		o
+		r
 	]);
-	return r(() => () => l?.dispose(), [l]), l;
+	return i(() => () => c?.dispose(), [c]), c;
 }
 //#endregion
-export { l as createReflowTransition, u as useAnimatedReflow };
+export { d as createReflowTransition, f as useAnimatedReflow };
 
 //# sourceMappingURL=reflow.js.map

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"}