@ssgoi/core 7.1.2 → 7.1.3-beta.1

package/README.md

@@ -83,25 +83,73 @@ DOM lifetime:
 This supports persistent layouts, inner tab transitions, and bottom navigation
 with one SSGOI instance.
 
-## Transition context
+## Motion overrides
 
-Custom effects receive semantic direction through `context`:
+Keep the preset's defaults and change only the selected direction or named group:
 
 ```ts
-import { defineTransition } from "@ssgoi/core";
-
-const effect = defineTransition({
-  prepare: ({ from, to, context }) => {
-    // Pre-paint setup.
-    return {};
+import { axis, spring } from "@ssgoi/core";
+
+const tuned = axis({ type: "x" }, {
+  override: {
+    forward({ animation }) {
+      const out = animation.select("out");
+      animation.select("in").set({
+        integrator: spring({ stiffness: 320, damping: 30 }),
+        startAt: { after: out, at: 0.3 },
+      });
+    },
   },
-  animation: ({ from, to, context }) => {
-    // context.direction is "forward" or "backward".
+});
+```
+
+The callback receives `{ animation, context }`. Named children are inferred from
+that preset's return type. `animation.set({ integrator })` explicitly retunes the
+whole group. Numeric start thresholds use first crossing; `at: "settled"` waits
+for completion. Custom `Integrator` instances are supported.
+
+[Motion guide](https://ssgoi.dev/docs/motion) ·
+[Plain-text API](https://ssgoi.dev/llms/motion.txt)
+
+## Custom transitions
+
+`defineTransition` pairs each direction's preparation with its animation factory.
+Prepared values and concrete return types are inferred independently. The core
+accepts any `Animation`; it does not require `MultiAnimation`.
+
+```ts
+import { defineTransition, WebAnimation, spring } from "@ssgoi/core";
+
+const physics = spring({ stiffness: 300, damping: 30 });
+const makeDirection = () => ({
+  animation({ from }: { from: HTMLElement }) {
+    const previousOpacity = from.style.opacity;
+    const animation = new WebAnimation({
+      element: from,
+      integrator: physics,
+      style: (_t, u) => ({ opacity: u }),
+      onComplete() {
+        from.style.opacity = previousOpacity;
+        animation.releaseFill();
+      },
+    });
     return animation;
   },
 });
+
+const effect = defineTransition({
+  forward: makeDirection(),
+  backward: makeDirection(),
+});
 ```
 
+The core determines `context.direction` from route rules and history. Transitions
+consume it unchanged. Keep per-run DOM snapshots in prepared data or animation
+closures and restore styles when reusable page nodes finish animating.
+
+[Complete custom transition example](https://ssgoi.dev/docs/custom-transitions) ·
+[Custom integrators and lifecycle reference](https://ssgoi.dev/llms/custom-transitions.txt)
+
 ## Effect index
 
 - `fade`: unrelated pages.

package/dist/animation/animation.d.ts

@@ -1,6 +1,26 @@
 import { Animation as RuntimeAnimation } from '../runtime/animation';
 import { StyleObject } from '../runtime/motion-state';
+import { Integrator } from './integrator/types';
+/** A start dependency between siblings in the same composite. */
+export interface AnimationStart<TTarget = HTMLElement, TStyle = StyleObject> {
+    after: Animation<TTarget, TStyle>;
+    /** Numeric progress means first crossing; settled waits for completion. */
+    at: number | "settled";
+}
+export interface AnimationPatch<TTarget = HTMLElement, TStyle = StyleObject> {
+    /** An integrator instance, including a custom stateless implementation. */
+    integrator?: Integrator;
+    /** null restores the parent's original scheduling for this child. */
+    startAt?: AnimationStart<TTarget, TStyle> | null;
+}
 /** Web-compatible default; platform-neutral consumers use @ssgoi/core/runtime. */
 export declare abstract class Animation<TTarget = HTMLElement, TStyle = StyleObject> extends RuntimeAnimation<TTarget, TStyle> {
+    private _startCondition;
+    /** Scheduling metadata read by the parent immediately before playback. */
+    get startCondition(): Readonly<AnimationStart<TTarget, TStyle>> | undefined;
+    /** Retune this animation before playback; omitted values stay unchanged. */
+    set(patch: AnimationPatch<TTarget, TStyle>): this;
+    /** Custom drivers can opt into physics editing by implementing this method. */
+    protected setIntegrator(_integrator: Integrator): void;
 }
 //# sourceMappingURL=animation.d.ts.map

package/dist/animation/animation.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"animation.d.ts","sourceRoot":"","sources":["../../src/lib/animation/animation.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,IAAI,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AACrE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAE3D,kFAAkF;AAClF,8BAAsB,SAAS,CAC7B,OAAO,GAAG,WAAW,EACrB,MAAM,GAAG,WAAW,CACpB,SAAQ,gBAAgB,CAAC,OAAO,EAAE,MAAM,CAAC;CAAG"}
+{"version":3,"file":"animation.d.ts","sourceRoot":"","sources":["../../src/lib/animation/animation.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,IAAI,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AACrE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAC3D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAErD,iEAAiE;AACjE,MAAM,WAAW,cAAc,CAAC,OAAO,GAAG,WAAW,EAAE,MAAM,GAAG,WAAW;IACzE,KAAK,EAAE,SAAS,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;IAClC,2EAA2E;IAC3E,EAAE,EAAE,MAAM,GAAG,SAAS,CAAC;CACxB;AAED,MAAM,WAAW,cAAc,CAAC,OAAO,GAAG,WAAW,EAAE,MAAM,GAAG,WAAW;IACzE,2EAA2E;IAC3E,UAAU,CAAC,EAAE,UAAU,CAAC;IACxB,qEAAqE;IACrE,OAAO,CAAC,EAAE,cAAc,CAAC,OAAO,EAAE,MAAM,CAAC,GAAG,IAAI,CAAC;CAClD;AAED,kFAAkF;AAClF,8BAAsB,SAAS,CAC7B,OAAO,GAAG,WAAW,EACrB,MAAM,GAAG,WAAW,CACpB,SAAQ,gBAAgB,CAAC,OAAO,EAAE,MAAM,CAAC;IACzC,OAAO,CAAC,eAAe,CAA8C;IAErE,0EAA0E;IAC1E,IAAI,cAAc,IAAI,QAAQ,CAAC,cAAc,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC,GAAG,SAAS,CAE1E;IAED,4EAA4E;IAC5E,GAAG,CAAC,KAAK,EAAE,cAAc,CAAC,OAAO,EAAE,MAAM,CAAC,GAAG,IAAI;IAyBjD,+EAA+E;IAC/E,SAAS,CAAC,aAAa,CAAC,WAAW,EAAE,UAAU,GAAG,IAAI;CAGvD"}

package/dist/animation/integrator/double-spring-integrator.d.ts

@@ -20,6 +20,9 @@ export interface DoubleSpringIntegratorConfig extends SpringIntegratorConfig {
     follower?: number | FollowerSpringConfig;
 }
 export declare class DoubleSpringIntegrator implements Integrator {
+    /** Leader spring values (the follower is derived; see `follower`). */
+    readonly stiffness: number;
+    readonly damping: number;
     private readonly leader;
     private readonly follower;
     private readonly restDelta;

package/dist/animation/integrator/double-spring-integrator.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"double-spring-integrator.d.ts","sourceRoot":"","sources":["../../../src/lib/animation/integrator/double-spring-integrator.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAE3D,OAAO,EAEL,KAAK,sBAAsB,EAC5B,MAAM,qBAAqB,CAAC;AAE7B;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,8DAA8D;IAC9D,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,8DAA8D;IAC9D,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,4BAA6B,SAAQ,sBAAsB;IAC1E;;;;OAIG;IACH,QAAQ,CAAC,EAAE,MAAM,GAAG,oBAAoB,CAAC;CAC1C;AAOD,qBAAa,sBAAuB,YAAW,UAAU;IACvD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAmB;IAC1C,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAmB;IAC5C,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;gBAEvB,MAAM,EAAE,4BAA4B;IAyChD,IAAI,CAAC,KAAK,EAAE,eAAe,EAAE,MAAM,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,eAAe;IA6BzE,SAAS,CAAC,KAAK,EAAE,eAAe,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO;CAmB3D"}
+{"version":3,"file":"double-spring-integrator.d.ts","sourceRoot":"","sources":["../../../src/lib/animation/integrator/double-spring-integrator.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAE3D,OAAO,EAEL,KAAK,sBAAsB,EAC5B,MAAM,qBAAqB,CAAC;AAE7B;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,8DAA8D;IAC9D,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,8DAA8D;IAC9D,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,4BAA6B,SAAQ,sBAAsB;IAC1E;;;;OAIG;IACH,QAAQ,CAAC,EAAE,MAAM,GAAG,oBAAoB,CAAC;CAC1C;AAOD,qBAAa,sBAAuB,YAAW,UAAU;IACvD,sEAAsE;IACtE,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAmB;IAC1C,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAmB;IAC5C,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;gBAEvB,MAAM,EAAE,4BAA4B;IA2ChD,IAAI,CAAC,KAAK,EAAE,eAAe,EAAE,MAAM,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,eAAe;IA6BzE,SAAS,CAAC,KAAK,EAAE,eAAe,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO;CAmB3D"}

package/dist/animation/integrator/inertia-integrator.d.ts

@@ -19,8 +19,8 @@ export interface InertiaIntegratorConfig {
     restDelta?: number;
 }
 export declare class InertiaIntegrator implements Integrator {
-    private readonly acceleration;
-    private readonly resistance;
+    readonly acceleration: number;
+    readonly resistance: number;
     private readonly resistanceType;
     private readonly min;
     private readonly max;

package/dist/animation/integrator/inertia-integrator.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"inertia-integrator.d.ts","sourceRoot":"","sources":["../../../src/lib/animation/integrator/inertia-integrator.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAM3D,MAAM,MAAM,cAAc,GAAG,QAAQ,GAAG,WAAW,CAAC;AAEpD,MAAM,WAAW,uBAAuB;IACtC,wDAAwD;IACxD,YAAY,EAAE,MAAM,CAAC;IACrB,iFAAiF;IACjF,UAAU,EAAE,MAAM,CAAC;IACnB,wFAAwF;IACxF,cAAc,CAAC,EAAE,cAAc,CAAC;IAChC,6BAA6B;IAC7B,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,6BAA6B;IAC7B,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,wDAAwD;IACxD,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,qDAAqD;IACrD,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,8DAA8D;IAC9D,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,qBAAa,iBAAkB,YAAW,UAAU;IAClD,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAS;IACtC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAiB;IAChD,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAqB;IACzC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAqB;IACzC,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAS;IACzC,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAS;IACvC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;gBAEvB,MAAM,EAAE,uBAAuB;IAW3C,IAAI,CAAC,KAAK,EAAE,eAAe,EAAE,MAAM,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,eAAe;IA8DzE,SAAS,CAAC,KAAK,EAAE,eAAe,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO;CAK3D"}
+{"version":3,"file":"inertia-integrator.d.ts","sourceRoot":"","sources":["../../../src/lib/animation/integrator/inertia-integrator.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAM3D,MAAM,MAAM,cAAc,GAAG,QAAQ,GAAG,WAAW,CAAC;AAEpD,MAAM,WAAW,uBAAuB;IACtC,wDAAwD;IACxD,YAAY,EAAE,MAAM,CAAC;IACrB,iFAAiF;IACjF,UAAU,EAAE,MAAM,CAAC;IACnB,wFAAwF;IACxF,cAAc,CAAC,EAAE,cAAc,CAAC;IAChC,6BAA6B;IAC7B,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,6BAA6B;IAC7B,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,wDAAwD;IACxD,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,qDAAqD;IACrD,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,8DAA8D;IAC9D,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,qBAAa,iBAAkB,YAAW,UAAU;IAClD,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAiB;IAChD,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAqB;IACzC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAqB;IACzC,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAS;IACzC,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAS;IACvC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;gBAEvB,MAAM,EAAE,uBAAuB;IAW3C,IAAI,CAAC,KAAK,EAAE,eAAe,EAAE,MAAM,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,eAAe;IA8DzE,SAAS,CAAC,KAAK,EAAE,eAAe,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO;CAK3D"}

package/dist/animation/integrator/spring-integrator.d.ts

@@ -8,6 +8,8 @@ export interface SpringIntegratorConfig {
     restSpeed?: number;
 }
 export declare class SpringIntegrator implements Integrator {
+    readonly stiffness: number;
+    readonly damping: number;
     private readonly omega;
     private readonly zeta;
     private readonly restDelta;

package/dist/animation/integrator/spring-integrator.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"spring-integrator.d.ts","sourceRoot":"","sources":["../../../src/lib/animation/integrator/spring-integrator.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAM3D,MAAM,WAAW,sBAAsB;IACrC,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,8DAA8D;IAC9D,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,8DAA8D;IAC9D,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,qBAAa,gBAAiB,YAAW,UAAU;IACjD,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAS;IAC/B,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAS;IAC9B,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;gBAEvB,MAAM,EAAE,sBAAsB;IAU1C,IAAI,CAAC,KAAK,EAAE,eAAe,EAAE,MAAM,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,eAAe;IAmBzE,SAAS,CAAC,KAAK,EAAE,eAAe,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO;CAM3D"}
+{"version":3,"file":"spring-integrator.d.ts","sourceRoot":"","sources":["../../../src/lib/animation/integrator/spring-integrator.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAM3D,MAAM,WAAW,sBAAsB;IACrC,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,8DAA8D;IAC9D,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,8DAA8D;IAC9D,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,qBAAa,gBAAiB,YAAW,UAAU;IACjD,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAS;IAC/B,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAS;IAC9B,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;gBAEvB,MAAM,EAAE,sBAAsB;IAa1C,IAAI,CAAC,KAAK,EAAE,eAAe,EAAE,MAAM,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,eAAe;IAmBzE,SAAS,CAAC,KAAK,EAAE,eAAe,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO;CAM3D"}

package/dist/animation/multi-animation.d.ts

@@ -1,5 +1,11 @@
-import { Pose, Timeline } from '../types/index.ts';
-import { Animation } from './animation';
+import { PhysicsOptions, Pose, Timeline } from '../types/index.ts';
+import { Animation, AnimationPatch } from './animation';
+import { Integrator } from './integrator';
+import { WebAnimation } from './web-animation';
+export interface TrackPatch {
+    /** New physics — an `Integrator` instance or the `{ spring | inertia }` shape. */
+    integrator?: Integrator | PhysicsOptions;
+}
 export type MultiAnimationMode = "parallel" | "sequence";
 export interface MultiAnimationOptions {
     mode?: MultiAnimationMode;
@@ -20,17 +26,39 @@ export interface MultiAnimationOptions {
  * Composite that drives several child Animations.
  *
  * - `parallel`: all children play together (optionally staggered via `startAt`)
- * - `sequence`: each child waits for the previous to settle, then plays
+ * - `sequence`: legacy numeric first-arrival chaining; use startCondition with
+ *   at: "settled" for explicit completion dependencies
  *
  * Pose/Timeline reads fan out to every child for diagnostic / inspection use.
  */
-export declare class MultiAnimation extends Animation {
-    private children;
-    private startAt;
+export declare class MultiAnimation<Name extends string = string> extends Animation {
+    private readonly _children;
+    private readonly progressChildren;
+    private _startAt;
+    private readonly namedChildren;
+    private restoreChildCallbacks;
+    private runId;
     private pendingComplete;
     private running;
     private pendingStartObservers;
-    constructor(children: Animation[], opts?: MultiAnimationOptions);
+    constructor(children: readonly Animation[] | Record<Name, Animation>, opts?: MultiAnimationOptions);
+    /** Child animations in play order. */
+    get children(): readonly Animation[];
+    /**
+     * Per-child start thresholds (see `MultiAnimationOptions.startAt`). Read
+     * at run time, so replacing it before `play()` changes the overlap.
+     */
+    get startAt(): number[];
+    set startAt(value: number[]);
+    /** Every `WebAnimation` in this composite, nested composites included. */
+    tracks(): WebAnimation[];
+    /** Select a registered child, which may itself be a composite. */
+    select(name: Name): Animation;
+    set(patch: AnimationPatch): this;
+    /** @deprecated Prefer select(name).set({ integrator }). */
+    set(name: Name, patch: TrackPatch): this;
+    /** Setting the composite explicitly retunes every child in the group. */
+    protected setIntegrator(integrator: Integrator): void;
     play(): void;
     reverse(): void;
     pause(): void;
@@ -46,10 +74,10 @@ export declare class MultiAnimation extends Animation {
     get playbackRate(): number;
     set playbackRate(rate: number);
     private startRun;
-    private scheduleStart;
+    private buildDependencies;
     private hasReachedThreshold;
     private clearPendingStartObservers;
-    private handleChildComplete;
+    private restoreCompletionHandlers;
     private handleFinished;
     findTimeForProgress(_threshold: number): number | null;
 }

package/dist/animation/multi-animation.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"multi-animation.d.ts","sourceRoot":"","sources":["../../src/lib/animation/multi-animation.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,QAAQ,CAAC;AAC7C,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAGxC,MAAM,MAAM,kBAAkB,GAAG,UAAU,GAAG,UAAU,CAAC;AAEzD,MAAM,WAAW,qBAAqB;IACpC,IAAI,CAAC,EAAE,kBAAkB,CAAC;IAC1B;;;;;;;;;;OAUG;IACH,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;CACpB;AAED;;;;;;;GAOG;AACH,qBAAa,cAAe,SAAQ,SAAS;IAC3C,OAAO,CAAC,QAAQ,CAAc;IAC9B,OAAO,CAAC,OAAO,CAAW;IAC1B,OAAO,CAAC,eAAe,CAAK;IAC5B,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,qBAAqB,CAAyB;gBAE1C,QAAQ,EAAE,SAAS,EAAE,EAAE,IAAI,GAAE,qBAA0B;IAgBnE,IAAI,IAAI,IAAI;IAIZ,OAAO,IAAI,IAAI;IAIf,KAAK,IAAI,IAAI;IAMb,QAAQ,IAAI,IAAI;IAOhB,IAAI,QAAQ,IAAI,MAAM,CAKrB;IAED,OAAO,IAAI,IAAI,EAAE;IAIjB,WAAW,IAAI,QAAQ,EAAE;IAIzB,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,GAAG,IAAI;IAO/B,IAAI,WAAW,IAAI,OAAO,CAEzB;IACD,IAAI,QAAQ,IAAI,OAAO,CAKtB;IACD,IAAI,UAAU,IAAI,OAAO,CAExB;IACD,IAAI,WAAW,IAAI,OAAO,CAEzB;IAED,IAAI,YAAY,IAAI,MAAM,CAEzB;IACD,IAAI,YAAY,CAAC,IAAI,EAAE,MAAM,EAG5B;IAID,OAAO,CAAC,QAAQ;IAuBhB,OAAO,CAAC,aAAa;IA8BrB,OAAO,CAAC,mBAAmB;IAU3B,OAAO,CAAC,0BAA0B;IAKlC,OAAO,CAAC,mBAAmB;IAK3B,OAAO,CAAC,cAAc;IAMtB,mBAAmB,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;CAOvD"}
+{"version":3,"file":"multi-animation.d.ts","sourceRoot":"","sources":["../../src/lib/animation/multi-animation.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,QAAQ,CAAC;AAC7D,OAAO,EACL,SAAS,EACT,KAAK,cAAc,EAEpB,MAAM,aAAa,CAAC;AAErB,OAAO,EAAsB,KAAK,UAAU,EAAE,MAAM,cAAc,CAAC;AACnE,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAE/C,MAAM,WAAW,UAAU;IACzB,kFAAkF;IAClF,UAAU,CAAC,EAAE,UAAU,GAAG,cAAc,CAAC;CAC1C;AAQD,MAAM,MAAM,kBAAkB,GAAG,UAAU,GAAG,UAAU,CAAC;AAEzD,MAAM,WAAW,qBAAqB;IACpC,IAAI,CAAC,EAAE,kBAAkB,CAAC;IAC1B;;;;;;;;;;OAUG;IACH,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;CACpB;AAED;;;;;;;;GAQG;AACH,qBAAa,cAAc,CAAC,IAAI,SAAS,MAAM,GAAG,MAAM,CAAE,SAAQ,SAAS;IACzE,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAc;IACxC,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAc;IAC/C,OAAO,CAAC,QAAQ,CAAW;IAC3B,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAyB;IACvD,OAAO,CAAC,qBAAqB,CAAyB;IACtD,OAAO,CAAC,KAAK,CAAK;IAClB,OAAO,CAAC,eAAe,CAAK;IAC5B,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,qBAAqB,CAAyB;gBAGpD,QAAQ,EAAE,SAAS,SAAS,EAAE,GAAG,MAAM,CAAC,IAAI,EAAE,SAAS,CAAC,EACxD,IAAI,GAAE,qBAA0B;IA4BlC,sCAAsC;IACtC,IAAI,QAAQ,IAAI,SAAS,SAAS,EAAE,CAEnC;IAED;;;OAGG;IACH,IAAI,OAAO,IAAI,MAAM,EAAE,CAEtB;IACD,IAAI,OAAO,CAAC,KAAK,EAAE,MAAM,EAAE,EAE1B;IAED,0EAA0E;IAC1E,MAAM,IAAI,YAAY,EAAE;IASxB,kEAAkE;IAClE,MAAM,CAAC,IAAI,EAAE,IAAI,GAAG,SAAS;IAM7B,GAAG,CAAC,KAAK,EAAE,cAAc,GAAG,IAAI;IAChC,2DAA2D;IAC3D,GAAG,CAAC,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,UAAU,GAAG,IAAI;IAYxC,yEAAyE;IACzE,SAAS,CAAC,aAAa,CAAC,UAAU,EAAE,UAAU,GAAG,IAAI;IAIrD,IAAI,IAAI,IAAI;IAIZ,OAAO,IAAI,IAAI;IAIf,KAAK,IAAI,IAAI;IAMb,QAAQ,IAAI,IAAI;IAQhB,IAAI,QAAQ,IAAI,MAAM,CAKrB;IAED,OAAO,IAAI,IAAI,EAAE;IAIjB,WAAW,IAAI,QAAQ,EAAE;IAIzB,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,GAAG,IAAI;IAO/B,IAAI,WAAW,IAAI,OAAO,CAEzB;IACD,IAAI,QAAQ,IAAI,OAAO,CAKtB;IACD,IAAI,UAAU,IAAI,OAAO,CAExB;IACD,IAAI,WAAW,IAAI,OAAO,CAEzB;IAED,IAAI,YAAY,IAAI,MAAM,CAEzB;IACD,IAAI,YAAY,CAAC,IAAI,EAAE,MAAM,EAG5B;IAID,OAAO,CAAC,QAAQ;IA6DhB,OAAO,CAAC,iBAAiB;IA2CzB,OAAO,CAAC,mBAAmB;IAY3B,OAAO,CAAC,0BAA0B;IAKlC,OAAO,CAAC,yBAAyB;IAKjC,OAAO,CAAC,cAAc;IAQtB,mBAAmB,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;CAMvD"}

package/dist/animation/web-animation.d.ts

@@ -11,6 +11,12 @@ export interface WebAnimationOptions {
     upperBound?: number;
     onUpdate?: (poses: Pose[]) => void;
     onComplete?: () => void;
+    /**
+     * Role label for this track (`"out"`, `"in"`, `"shared"`, `"overlay"`).
+     * Presets usually leave it unset; `withOverride` fills it in from element
+     * identity so user overrides can address tracks by role.
+     */
+    label?: string;
 }
 /**
  * Single-element animation driven by an Integrator simulation, played through
@@ -36,8 +42,10 @@ export interface WebAnimationOptions {
  * animation's pose is handed in via `matchInto`, we look up by element.
  */
 export declare class WebAnimation extends Animation {
-    private element;
-    private integrator;
+    private readonly _element;
+    private _integrator;
+    /** Role label, see `WebAnimationOptions.label`. */
+    label: string | undefined;
     private styleFn;
     private lowerBound;
     private upperBound;
@@ -56,6 +64,16 @@ export declare class WebAnimation extends Animation {
     private settled;
     private reversing;
     constructor(opts: WebAnimationOptions);
+    /** The DOM node this track drives. */
+    get element(): HTMLElement;
+    /**
+     * Physics that drives this track. Read lazily at `play()` / `reverse()`
+     * (the simulation runs then), so replacing it before playback takes effect
+     * for the next run — this is what `withOverride` relies on.
+     */
+    get integrator(): Integrator;
+    set integrator(integrator: Integrator);
+    protected setIntegrator(integrator: Integrator): void;
     play(): void;
     reverse(): void;
     pause(): void;

package/dist/animation/web-animation.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"web-animation.d.ts","sourceRoot":"","sources":["../../src/lib/animation/web-animation.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,WAAW,EAAE,QAAQ,EAAiB,MAAM,QAAQ,CAAC;AACzE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAG/C,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AASxC,MAAM,WAAW,mBAAmB;IAClC,OAAO,EAAE,WAAW,CAAC;IACrB,UAAU,EAAE,UAAU,CAAC;IACvB,KAAK,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,KAAK,WAAW,CAAC;IAC7C,gEAAgE;IAChE,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,8DAA8D;IAC9D,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,IAAI,EAAE,KAAK,IAAI,CAAC;IACnC,UAAU,CAAC,EAAE,MAAM,IAAI,CAAC;CACzB;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,qBAAa,YAAa,SAAQ,SAAS;IACzC,OAAO,CAAC,OAAO,CAAc;IAC7B,OAAO,CAAC,UAAU,CAAa;IAC/B,OAAO,CAAC,OAAO,CAAwC;IACvD,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,UAAU,CAAS;IAE3B,OAAO,CAAC,YAAY,CAAS;IAC7B,OAAO,CAAC,eAAe,CAAK;IAC5B,OAAO,CAAC,MAAM,CAAkB;IAChC,OAAO,CAAC,KAAK,CAAqC;IAClD,OAAO,CAAC,KAAK,CAAK;IAClB,OAAO,CAAC,eAAe,CAAS;IAChC,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,iBAAiB,CAAuB;IAChD,OAAO,CAAC,gBAAgB,CAA6B;IACrD,OAAO,CAAC,mBAAmB,CAAK;IAChC,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,SAAS,CAAS;gBAEd,IAAI,EAAE,mBAAmB;IAYrC,IAAI,IAAI,IAAI;IAiBZ,OAAO,IAAI,IAAI;IAQf,KAAK,IAAI,IAAI;IAYb,QAAQ,IAAI,IAAI;IAWhB;;;;;;OAMG;IACH,WAAW,IAAI,IAAI;IAInB,IAAI,WAAW,IAAI,OAAO,CAEzB;IACD,IAAI,QAAQ,IAAI,OAAO,CAEtB;IACD,IAAI,UAAU,IAAI,OAAO,CAExB;IACD,IAAI,WAAW,IAAI,OAAO,CAEzB;IAED,IAAI,QAAQ,IAAI,MAAM,CAMrB;IAED,mBAAmB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IAcrD,IAAI,YAAY,IAAI,MAAM,CAEzB;IACD,IAAI,YAAY,CAAC,IAAI,EAAE,MAAM,EAG5B;IAED,OAAO,IAAI,IAAI,EAAE;IAcjB,WAAW,IAAI,QAAQ,EAAE;IAczB,SAAS,CAAC,KAAK,EAAE,IAAI,EAAE,GAAG,IAAI;IAS9B,OAAO,CAAC,SAAS;IAiEjB,OAAO,CAAC,UAAU;IAYlB,OAAO,CAAC,gBAAgB;YASV,cAAc;IAwB5B,OAAO,CAAC,uBAAuB;IA8B/B,OAAO,CAAC,wBAAwB;IAqChC,OAAO,CAAC,cAAc;IAUtB,OAAO,CAAC,mBAAmB;IAiB3B,OAAO,CAAC,YAAY;CAQrB"}
+{"version":3,"file":"web-animation.d.ts","sourceRoot":"","sources":["../../src/lib/animation/web-animation.ts"],"names":[],"mappings":"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"}

package/dist/index-B_K3Vnj-.js

@@ -0,0 +1,55 @@
+const s = Symbol("ssgoi.transition.definition"), d = Symbol("ssgoi.transition.prepared-run");
+function c(t, n) {
+  return {
+    context: n,
+    prepare: (o) => {
+      var r;
+      return ((r = t.prepare) == null ? void 0 : r.call(t, { ...o, context: n })) ?? {};
+    },
+    // Prepared values are opaque to the dispatcher and passed back verbatim.
+    // The selected branch is captured in this run, so forward's prepared data
+    // cannot reach backward's factory even when preparations overlap.
+    animation: (o) => t.animation({ ...o, context: n })
+  };
+}
+function u(t) {
+  return {
+    [s]: t,
+    prepare(n) {
+      return ((r) => {
+        const e = r.prepare(n), i = (a) => ({ ...a, [d]: r });
+        return typeof e.then == "function" ? Promise.resolve(e).then(i) : i(e);
+      })(t[n.context.direction](n.context));
+    },
+    animation(n) {
+      return (n[d] ?? t[n.context.direction](n.context)).animation(n);
+    }
+  };
+}
+function w(t, n = {}) {
+  return f(u({
+    forward: (r) => c(t.forward, r),
+    backward: (r) => c(t.backward, r)
+  }), n.override);
+}
+function f(t, n) {
+  if (!n) return t;
+  const o = t[s], r = (e, i) => ({
+    ...e,
+    animation(a) {
+      const p = e.animation(a);
+      return i == null || i({
+        animation: p,
+        context: e.context
+      }), p;
+    }
+  });
+  return u({
+    forward: (e) => r(o.forward(e), n.forward),
+    backward: (e) => r(o.backward(e), n.backward)
+  });
+}
+export {
+  w as d,
+  f as w
+};

package/dist/index-CtyacfH7.cjs

@@ -0,0 +1 @@
+"use strict";const s=Symbol("ssgoi.transition.definition"),d=Symbol("ssgoi.transition.prepared-run");function c(t,n){return{context:n,prepare:o=>{var r;return((r=t.prepare)==null?void 0:r.call(t,{...o,context:n}))??{}},animation:o=>t.animation({...o,context:n})}}function u(t){return{[s]:t,prepare(n){return(r=>{const e=r.prepare(n),i=a=>({...a,[d]:r});return typeof e.then=="function"?Promise.resolve(e).then(i):i(e)})(t[n.context.direction](n.context))},animation(n){return(n[d]??t[n.context.direction](n.context)).animation(n)}}}function w(t,n={}){return f(u({forward:r=>c(t.forward,r),backward:r=>c(t.backward,r)}),n.override)}function f(t,n){if(!n)return t;const o=t[s],r=(e,i)=>({...e,animation(a){const p=e.animation(a);return i==null||i({animation:p,context:e.context}),p}});return u({forward:e=>r(o.forward(e),n.forward),backward:e=>r(o.backward(e),n.backward)})}exports.defineTransition=w;exports.withOverride=f;