@ssgoi/core 6.1.0 → 6.2.1

package/dist/transitions/axis/index.d.ts

@@ -6,6 +6,14 @@ import { SsgoiPathTransition } from '../../types/index.ts';
  * - `"snappy"` — tight, decisive page swap (KakaoTalk style).
  */
 export type AxisXVariant = "default" | "snappy";
+/**
+ * Public `variant` value for `axis({ type: "y" })`.
+ *
+ * - `"default"` — directional fade-through. Forward = bottom→top.
+ * - `"non-directional"` — direction-agnostic. Incoming always rises from
+ *   below; outgoing fades in place.
+ */
+export type AxisYVariant = "default" | "non-directional";
 /**
  * Legacy `feel` axis. Kept for source compatibility only.
  *
@@ -32,7 +40,7 @@ export type AxisConfig = {
     feel?: AxisFeelDeprecated;
 } | {
     type: "y";
-    variant?: "default";
+    variant?: AxisYVariant;
     options?: {};
 } | {
     type: "z";

package/dist/transitions/axis/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/lib/transitions/axis/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,QAAQ,CAAC;AAiBlD;;;;;GAKG;AACH,MAAM,MAAM,YAAY,GAAG,SAAS,GAAG,QAAQ,CAAC;AAEhD;;;;;;;;GAQG;AACH,MAAM,MAAM,kBAAkB,GAAG,QAAQ,GAAG,OAAO,CAAC;AAEpD,MAAM,MAAM,UAAU,GAAG;IACvB,KAAK,EAAE,SAAS,MAAM,EAAE,CAAC;CAC1B,GAAG,CACA;IACE,IAAI,CAAC,EAAE,GAAG,CAAC;IACX,OAAO,CAAC,EAAE,YAAY,CAAC;IACvB,OAAO,CAAC,EAAE,EAAE,CAAC;IACb;;;;;;OAMG;IACH,IAAI,CAAC,EAAE,kBAAkB,CAAC;CAC3B,GACD;IAAE,IAAI,EAAE,GAAG,CAAC;IAAC,OAAO,CAAC,EAAE,SAAS,CAAC;IAAC,OAAO,CAAC,EAAE,EAAE,CAAA;CAAE,GAChD;IAAE,IAAI,EAAE,GAAG,CAAC;IAAC,OAAO,CAAC,EAAE,SAAS,CAAC;IAAC,OAAO,CAAC,EAAE,EAAE,CAAA;CAAE,CACnD,CAAC;AA4BF,wBAAgB,IAAI,CAAC,MAAM,EAAE,UAAU,GAAG,mBAAmB,EAAE,CAY9D"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/lib/transitions/axis/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,QAAQ,CAAC;AAmBlD;;;;;GAKG;AACH,MAAM,MAAM,YAAY,GAAG,SAAS,GAAG,QAAQ,CAAC;AAEhD;;;;;;GAMG;AACH,MAAM,MAAM,YAAY,GAAG,SAAS,GAAG,iBAAiB,CAAC;AAEzD;;;;;;;;GAQG;AACH,MAAM,MAAM,kBAAkB,GAAG,QAAQ,GAAG,OAAO,CAAC;AAEpD,MAAM,MAAM,UAAU,GAAG;IACvB,KAAK,EAAE,SAAS,MAAM,EAAE,CAAC;CAC1B,GAAG,CACA;IACE,IAAI,CAAC,EAAE,GAAG,CAAC;IACX,OAAO,CAAC,EAAE,YAAY,CAAC;IACvB,OAAO,CAAC,EAAE,EAAE,CAAC;IACb;;;;;;OAMG;IACH,IAAI,CAAC,EAAE,kBAAkB,CAAC;CAC3B,GACD;IAAE,IAAI,EAAE,GAAG,CAAC;IAAC,OAAO,CAAC,EAAE,YAAY,CAAC;IAAC,OAAO,CAAC,EAAE,EAAE,CAAA;CAAE,GACnD;IAAE,IAAI,EAAE,GAAG,CAAC;IAAC,OAAO,CAAC,EAAE,SAAS,CAAC;IAAC,OAAO,CAAC,EAAE,EAAE,CAAA;CAAE,CACnD,CAAC;AA+BF,wBAAgB,IAAI,CAAC,MAAM,EAAE,UAAU,GAAG,mBAAmB,EAAE,CAY9D"}

package/dist/transitions/axis/provider/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/lib/transitions/axis/provider/index.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,QAAQ,EAAE,YAAY,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAC;AAKjE,KAAK,eAAe,GAAG;IAAE,MAAM,EAAE,YAAY,CAAA;CAAE,GAAG,OAAO,CACvD,MAAM,CAAC,QAAQ,EAAE,YAAY,CAAC,CAC/B,CAAC;AAKF,eAAO,MAAM,cAAc,EAAE,MAAM,CAAC,QAAQ,EAAE,eAAe,CAM5D,CAAC;AAEF,wBAAgB,mBAAmB,CACjC,IAAI,EAAE,QAAQ,EACd,IAAI,EAAE,QAAQ,GACb,YAAY,CAGd"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/lib/transitions/axis/provider/index.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,QAAQ,EAAE,YAAY,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAC;AAKjE,KAAK,eAAe,GAAG;IAAE,MAAM,EAAE,YAAY,CAAA;CAAE,GAAG,OAAO,CACvD,MAAM,CAAC,QAAQ,EAAE,YAAY,CAAC,CAC/B,CAAC;AAIF,eAAO,MAAM,cAAc,EAAE,MAAM,CAAC,QAAQ,EAAE,eAAe,CAI5D,CAAC;AAEF,wBAAgB,mBAAmB,CACjC,IAAI,EAAE,QAAQ,EACd,IAAI,EAAE,QAAQ,GACb,YAAY,CAGd"}

package/dist/transitions/axis/provider/x/index.d.ts

@@ -1,3 +1,5 @@
 import { AxisFeel, AxisProvider } from '../../types';
-export declare const X_PROVIDERS: Record<AxisFeel, AxisProvider>;
+export declare const X_PROVIDERS: {
+    snappy: AxisProvider;
+} & Partial<Record<AxisFeel, AxisProvider>>;
 //# sourceMappingURL=index.d.ts.map

package/dist/transitions/axis/provider/x/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/lib/transitions/axis/provider/x/index.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAK1D,eAAO,MAAM,WAAW,EAAE,MAAM,CAAC,QAAQ,EAAE,YAAY,CAGtD,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/lib/transitions/axis/provider/x/index.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAQ1D,eAAO,MAAM,WAAW,EAAE;IAAE,MAAM,EAAE,YAAY,CAAA;CAAE,GAAG,OAAO,CAC1D,MAAM,CAAC,QAAQ,EAAE,YAAY,CAAC,CAI/B,CAAC"}

package/dist/transitions/axis/provider/y/directional.d.ts

@@ -0,0 +1,3 @@
+import { AxisProvider } from '../../types';
+export declare function createDirectionalYProvider(): AxisProvider;
+//# sourceMappingURL=directional.d.ts.map

package/dist/transitions/axis/provider/y/directional.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"directional.d.ts","sourceRoot":"","sources":["../../../../../src/lib/transitions/axis/provider/y/directional.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAEV,YAAY,EAEb,MAAM,aAAa,CAAC;AAoDrB,wBAAgB,0BAA0B,IAAI,YAAY,CAOzD"}

package/dist/transitions/axis/provider/y/index.d.ts

@@ -0,0 +1,5 @@
+import { AxisFeel, AxisProvider } from '../../types';
+export declare const Y_PROVIDERS: {
+    snappy: AxisProvider;
+} & Partial<Record<AxisFeel, AxisProvider>>;
+//# sourceMappingURL=index.d.ts.map

package/dist/transitions/axis/provider/y/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/lib/transitions/axis/provider/y/index.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAO1D,eAAO,MAAM,WAAW,EAAE;IAAE,MAAM,EAAE,YAAY,CAAA;CAAE,GAAG,OAAO,CAC1D,MAAM,CAAC,QAAQ,EAAE,YAAY,CAAC,CAK/B,CAAC"}

package/dist/transitions/axis/provider/y/non-directional.d.ts

@@ -0,0 +1,3 @@
+import { AxisProvider } from '../../types';
+export declare function createNonDirectionalYProvider(): AxisProvider;
+//# sourceMappingURL=non-directional.d.ts.map

package/dist/transitions/axis/provider/y/non-directional.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"non-directional.d.ts","sourceRoot":"","sources":["../../../../../src/lib/transitions/axis/provider/y/non-directional.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAEV,YAAY,EAEb,MAAM,aAAa,CAAC;AA+CrB,wBAAgB,6BAA6B,IAAI,YAAY,CAO5D"}

package/dist/transitions/axis/types.d.ts

@@ -3,14 +3,17 @@ import { MultiAnimationOptions } from '../../animation/multi-animation';
 export type AxisType = "x" | "y" | "z";
 export type AxisDirection = "forward" | "backward";
 /**
- * UX flavor *within* a single axis. Independent dimension from `AxisType`:
- *   - `snappy` — tight, decisive page swap. KakaoTalk-style on x.
- *   - `fluid`  — relaxed, fade-through. Flutter SharedAxisTransition-style on x.
+ * UX flavor *within* a single axis. Independent dimension from `AxisType`; the
+ * set of meaningful values differs per type:
+ *   - x: `snappy` (KakaoTalk tab swap) | `fluid` (Material SharedAxisTransition)
+ *   - y: `directional` (forward = bottom→top) | `non-directional` (in always
+ *     rises from below; out fades in place)
+ *   - z: `snappy` only
  *
- * Only `x` currently ships both flavors; `y` and `z` only have `snappy` and
- * fall back to it when `fluid` is requested.
+ * Providers may alias unsupported feels to an in-axis default — `snappy` is
+ * the universal fallback inside `resolveAxisProvider`.
  */
-export type AxisFeel = "snappy" | "fluid";
+export type AxisFeel = "snappy" | "fluid" | "directional" | "non-directional";
 export interface AxisOptions {
     type?: AxisType;
     direction?: AxisDirection;

package/dist/transitions/axis/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/lib/transitions/axis/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,QAAQ,CAAC;AAC1D,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,iCAAiC,CAAC;AAE7E,MAAM,MAAM,QAAQ,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,CAAC;AACvC,MAAM,MAAM,aAAa,GAAG,SAAS,GAAG,UAAU,CAAC;AAEnD;;;;;;;GAOG;AACH,MAAM,MAAM,QAAQ,GAAG,QAAQ,GAAG,OAAO,CAAC;AAE1C,MAAM,WAAW,WAAW;IAC1B,IAAI,CAAC,EAAE,QAAQ,CAAC;IAChB,SAAS,CAAC,EAAE,aAAa,CAAC;IAC1B,IAAI,CAAC,EAAE,QAAQ,CAAC;CACjB;AAED,MAAM,MAAM,eAAe,GAAG,CAAC,QAAQ,EAAE,MAAM,KAAK,WAAW,CAAC;AAEhE,MAAM,WAAW,cAAc;IAC7B,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,WAAW,CAAC;IACxB,OAAO,EAAE,eAAe,CAAC;CAC1B;AAED,MAAM,WAAW,mBAAmB;IAClC,GAAG,EAAE,cAAc,CAAC;IACpB,EAAE,EAAE,cAAc,CAAC;CACpB;AAED,MAAM,WAAW,qBAAqB;IACpC,SAAS,EAAE,aAAa,CAAC;CAC1B;AAED,MAAM,WAAW,YAAY;IAC3B;;;;;OAKG;IACH,UAAU,EAAE,cAAc,CAAC;IAC3B,qCAAqC;IACrC,SAAS,EAAE,cAAc,CAAC;IAC1B;;;;;OAKG;IACH,WAAW,CAAC,EAAE,qBAAqB,CAAC;IACpC,qEAAqE;IACrE,KAAK,EAAE,CAAC,IAAI,EAAE,qBAAqB,KAAK,mBAAmB,CAAC;CAC7D"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/lib/transitions/axis/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,QAAQ,CAAC;AAC1D,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,iCAAiC,CAAC;AAE7E,MAAM,MAAM,QAAQ,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,CAAC;AACvC,MAAM,MAAM,aAAa,GAAG,SAAS,GAAG,UAAU,CAAC;AAEnD;;;;;;;;;;GAUG;AACH,MAAM,MAAM,QAAQ,GAAG,QAAQ,GAAG,OAAO,GAAG,aAAa,GAAG,iBAAiB,CAAC;AAE9E,MAAM,WAAW,WAAW;IAC1B,IAAI,CAAC,EAAE,QAAQ,CAAC;IAChB,SAAS,CAAC,EAAE,aAAa,CAAC;IAC1B,IAAI,CAAC,EAAE,QAAQ,CAAC;CACjB;AAED,MAAM,MAAM,eAAe,GAAG,CAAC,QAAQ,EAAE,MAAM,KAAK,WAAW,CAAC;AAEhE,MAAM,WAAW,cAAc;IAC7B,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,WAAW,CAAC;IACxB,OAAO,EAAE,eAAe,CAAC;CAC1B;AAED,MAAM,WAAW,mBAAmB;IAClC,GAAG,EAAE,cAAc,CAAC;IACpB,EAAE,EAAE,cAAc,CAAC;CACpB;AAED,MAAM,WAAW,qBAAqB;IACpC,SAAS,EAAE,aAAa,CAAC;CAC1B;AAED,MAAM,WAAW,YAAY;IAC3B;;;;;OAKG;IACH,UAAU,EAAE,cAAc,CAAC;IAC3B,qCAAqC;IACrC,SAAS,EAAE,cAAc,CAAC;IAC1B;;;;;OAKG;IACH,WAAW,CAAC,EAAE,qBAAqB,CAAC;IACpC,qEAAqE;IACrE,KAAK,EAAE,CAAC,IAAI,EAAE,qBAAqB,KAAK,mBAAmB,CAAC;CAC7D"}

package/dist/transitions/fade/index.d.ts

@@ -3,11 +3,8 @@ import { PresetConfig } from '../utils';
 import { FadeOptions, FadeType, FadeVariant } from './types';
 export type { FadeOptions, FadeType, FadeVariant } from './types';
 /**
- * Fade preset configuration.
- *
- * Default `type` is `"fade-through"` (sequential fade-out → fade-in).
- * The `"cross-fade"` type and `"smooth"` variant are tracked on the TODO
- * board and intentionally not part of the public type yet.
+ * Fade preset configuration. Default `type` is `"fade-through"` —
+ * sequential fade-out → fade-in.
  */
 export type FadeConfig = PresetConfig<{
     paths: readonly string[];

package/dist/transitions/fade/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/lib/transitions/fade/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,QAAQ,CAAC;AAClD,OAAO,EAAkC,KAAK,YAAY,EAAE,MAAM,UAAU,CAAC;AAE7E,OAAO,KAAK,EAAE,WAAW,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAElE,YAAY,EAAE,WAAW,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAElE;;;;;;GAMG;AACH,MAAM,MAAM,UAAU,GAAG,YAAY,CACnC;IAAE,KAAK,EAAE,SAAS,MAAM,EAAE,CAAA;CAAE,EAC5B,QAAQ,EACR,WAAW,EACX,WAAW,CACZ,CAAC;AAEF,wBAAgB,IAAI,CAAC,MAAM,EAAE,UAAU,GAAG,mBAAmB,EAAE,CAG9D"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/lib/transitions/fade/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,QAAQ,CAAC;AAClD,OAAO,EAAkC,KAAK,YAAY,EAAE,MAAM,UAAU,CAAC;AAE7E,OAAO,KAAK,EAAE,WAAW,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAElE,YAAY,EAAE,WAAW,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAElE;;;GAGG;AACH,MAAM,MAAM,UAAU,GAAG,YAAY,CACnC;IAAE,KAAK,EAAE,SAAS,MAAM,EAAE,CAAA;CAAE,EAC5B,QAAQ,EACR,WAAW,EACX,WAAW,CACZ,CAAC;AAEF,wBAAgB,IAAI,CAAC,MAAM,EAAE,UAAU,GAAG,mBAAmB,EAAE,CAG9D"}

package/dist/transitions/fade/types.d.ts

@@ -1,12 +1,6 @@
 /**
- * Public option shapes for the fade preset.
- *
- * Default `type` is `"fade-through"` — the current sequential
- * fade-out → fade-in behavior.
- *
- * Not yet exposed (tracked separately on the TODO board):
- *   - `type: "cross-fade"` (simultaneous fade)
- *   - `variant: "smooth"`
+ * Public option shapes for the fade preset. Default `type` is
+ * `"fade-through"` — the sequential fade-out → fade-in behavior.
  */
 export type FadeType = "fade-through";
 export type FadeVariant = "default";

package/dist/transitions/fade/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/lib/transitions/fade/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,MAAM,MAAM,QAAQ,GAAG,cAAc,CAAC;AAEtC,MAAM,MAAM,WAAW,GAAG,SAAS,CAAC;AAEpC,MAAM,MAAM,WAAW,GAAG,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/lib/transitions/fade/types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,MAAM,QAAQ,GAAG,cAAc,CAAC;AAEtC,MAAM,MAAM,WAAW,GAAG,SAAS,CAAC;AAEpC,MAAM,MAAM,WAAW,GAAG,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC"}

package/dist/transitions/hero/index.d.ts

@@ -1,17 +1,20 @@
 import { SsgoiPathTransition } from '../../types/index.ts';
 import { PresetConfig } from '../utils';
-import { HeroOptions, HeroVariant } from './types';
-export type { HeroOptions, HeroVariant } from './types';
+import { HeroOptions, HeroType, HeroVariant } from './types';
+export type { HeroOptions, HeroType, HeroVariant } from './types';
 /**
  * Hero preset configuration.
  *
- * Single-behavior preset: no `type` discriminator. The unified
- * `{ variant, options }` slots are exposed. The `"snappy"` variant is
- * tracked on the TODO board and is intentionally not part of the public
- * type yet.
+ * - `type: "static"` (default) — incoming-page chrome snaps in; the shared
+ *   element morphs in place via clip-path inset + uniform scale.
+ * - `type: "fade"` — both pages cross-fade as whole surfaces while a
+ *   temporary shared-element clone morphs above them. Use when each side has
+ *   its own chrome (e.g., a detail screen with its own back button / app bar).
+ * - `variant: "default"` — only value today; reserved for future tonal
+ *   variants without re-shaping the public API.
  */
 export type HeroConfig = PresetConfig<{
     paths: readonly string[];
-}, never, HeroVariant, HeroOptions>;
+}, HeroType, HeroVariant, HeroOptions>;
 export declare function hero(config: HeroConfig): SsgoiPathTransition[];
 //# sourceMappingURL=index.d.ts.map

package/dist/transitions/hero/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/lib/transitions/hero/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,QAAQ,CAAC;AAClD,OAAO,EAAkC,KAAK,YAAY,EAAE,MAAM,UAAU,CAAC;AAE7E,OAAO,KAAK,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAExD,YAAY,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAExD;;;;;;;GAOG;AACH,MAAM,MAAM,UAAU,GAAG,YAAY,CACnC;IAAE,KAAK,EAAE,SAAS,MAAM,EAAE,CAAA;CAAE,EAC5B,KAAK,EACL,WAAW,EACX,WAAW,CACZ,CAAC;AAEF,wBAAgB,IAAI,CAAC,MAAM,EAAE,UAAU,GAAG,mBAAmB,EAAE,CAG9D"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/lib/transitions/hero/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,QAAQ,CAAC;AAClD,OAAO,EAAkC,KAAK,YAAY,EAAE,MAAM,UAAU,CAAC;AAE7E,OAAO,KAAK,EAAE,WAAW,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAElE,YAAY,EAAE,WAAW,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAElE;;;;;;;;;;GAUG;AACH,MAAM,MAAM,UAAU,GAAG,YAAY,CACnC;IAAE,KAAK,EAAE,SAAS,MAAM,EAAE,CAAA;CAAE,EAC5B,QAAQ,EACR,WAAW,EACX,WAAW,CACZ,CAAC;AAEF,wBAAgB,IAAI,CAAC,MAAM,EAAE,UAAU,GAAG,mBAAmB,EAAE,CAO9D"}

package/dist/transitions/hero/keys.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Shared hero attribute keys. Lives in its own module so both the dispatcher
+ * (transition.ts) and the chrome providers can consume them without creating
+ * an import cycle through provider/index.ts.
+ */
+export declare const HERO_ENTER_KEY = "data-hero-enter-key";
+export declare const HERO_EXIT_KEY = "data-hero-exit-key";
+export declare const HERO_LEGACY_KEY = "data-hero-key";
+/** CSS selector matching any hero-keyed element. */
+export declare const HERO_ANY_KEY_SELECTOR = "[data-hero-enter-key],[data-hero-exit-key],[data-hero-key]";
+/** True if `el` itself carries any hero key. */
+export declare function isHeroKeyed(el: HTMLElement): boolean;
+/** True if `el` is hero-keyed or contains any hero-keyed descendant. */
+export declare function isOrContainsHeroKey(el: HTMLElement): boolean;
+//# sourceMappingURL=keys.d.ts.map

package/dist/transitions/hero/keys.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"keys.d.ts","sourceRoot":"","sources":["../../../src/lib/transitions/hero/keys.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,eAAO,MAAM,cAAc,wBAAwB,CAAC;AACpD,eAAO,MAAM,aAAa,uBAAuB,CAAC;AAClD,eAAO,MAAM,eAAe,kBAAkB,CAAC;AAE/C,oDAAoD;AACpD,eAAO,MAAM,qBAAqB,+DAAgE,CAAC;AAEnG,gDAAgD;AAChD,wBAAgB,WAAW,CAAC,EAAE,EAAE,WAAW,GAAG,OAAO,CAMpD;AAED,wEAAwE;AACxE,wBAAgB,mBAAmB,CAAC,EAAE,EAAE,WAAW,GAAG,OAAO,CAG5D"}

package/dist/transitions/hero/provider/fade.d.ts

@@ -0,0 +1,3 @@
+import { HeroStrategy } from '../types';
+export declare const createFadeChromeStrategy: () => HeroStrategy;
+//# sourceMappingURL=fade.d.ts.map

package/dist/transitions/hero/provider/fade.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fade.d.ts","sourceRoot":"","sources":["../../../../src/lib/transitions/hero/provider/fade.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAqB,YAAY,EAAE,MAAM,UAAU,CAAC;AA4ChE,eAAO,MAAM,wBAAwB,QAAO,YACT,CAAC"}

package/dist/transitions/hero/provider/index.d.ts

@@ -0,0 +1,8 @@
+import { HeroStrategy, HeroType } from '../types';
+/**
+ * Chrome-handling strategy keyed on `HeroType`. The dispatcher in
+ * transition.ts looks the factory up here and assembles it next to the
+ * always-on TileStrategy — never branches on the type itself.
+ */
+export declare const HERO_CHROME_PROVIDERS: Record<HeroType, () => HeroStrategy>;
+//# sourceMappingURL=index.d.ts.map

package/dist/transitions/hero/provider/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/lib/transitions/hero/provider/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAC;AAIvD;;;;GAIG;AACH,eAAO,MAAM,qBAAqB,EAAE,MAAM,CAAC,QAAQ,EAAE,MAAM,YAAY,CAGtE,CAAC"}

package/dist/transitions/hero/provider/static.d.ts

@@ -0,0 +1,3 @@
+import { HeroStrategy } from '../types';
+export declare const createStaticChromeStrategy: () => HeroStrategy;
+//# sourceMappingURL=static.d.ts.map

package/dist/transitions/hero/provider/static.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"static.d.ts","sourceRoot":"","sources":["../../../../src/lib/transitions/hero/provider/static.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAkB,YAAY,EAAE,MAAM,UAAU,CAAC;AAoB7D,eAAO,MAAM,0BAA0B,QAAO,YAChB,CAAC"}

package/dist/transitions/hero/transition.d.ts

@@ -1,7 +1,8 @@
-import { PhysicsOptions, TransitionConfig } from '../../types/index.ts';
-export interface HeroOptions {
-    physics?: PhysicsOptions;
-    maxDistance?: number;
-}
-export declare const hero: (options?: HeroOptions) => TransitionConfig;
+import { TransitionConfig } from '../../types/index.ts';
+import { HeroResolved, NormalizedHeroOptions } from './types';
+export type { HeroType, HeroVariant, NormalizedHeroOptions } from './types';
+type HeroExtras = {
+    resolved: HeroResolved;
+};
+export declare const hero: (options: NormalizedHeroOptions) => TransitionConfig<HeroExtras>;
 //# sourceMappingURL=transition.d.ts.map

package/dist/transitions/hero/transition.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"transition.d.ts","sourceRoot":"","sources":["../../../src/lib/transitions/hero/transition.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,QAAQ,CAAC;AAa/D,MAAM,WAAW,WAAW;IAC1B,OAAO,CAAC,EAAE,cAAc,CAAC;IACzB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAYD,eAAO,MAAM,IAAI,GAAI,UAAS,WAAgB,KAAG,gBA+FhD,CAAC"}
+{"version":3,"file":"transition.d.ts","sourceRoot":"","sources":["../../../src/lib/transitions/hero/transition.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAkB,gBAAgB,EAAE,MAAM,QAAQ,CAAC;AAU/D,OAAO,KAAK,EAIV,YAAY,EAGZ,qBAAqB,EACtB,MAAM,SAAS,CAAC;AAEjB,YAAY,EAAE,QAAQ,EAAE,WAAW,EAAE,qBAAqB,EAAE,MAAM,SAAS,CAAC;AAua5E,KAAK,UAAU,GAAG;IAAE,QAAQ,EAAE,YAAY,CAAA;CAAE,CAAC;AAE7C,eAAO,MAAM,IAAI,GACf,SAAS,qBAAqB,KAC7B,gBAAgB,CAAC,UAAU,CA2E7B,CAAC"}

package/dist/transitions/hero/types.d.ts

@@ -1,12 +1,55 @@
+import { PhysicsOptions } from '../../types/index.ts';
+import { Animation } from '../../animation';
 /**
- * Public option shapes for the hero preset.
- *
- * Single-behavior preset (no `type` slot). Exposes the unified
- * `{ variant, options }` slots.
- *
- * Not yet exposed (tracked separately on the TODO board):
- *   - `variant: "snappy"`
+ * - `static` — the shared element morphs in place; the incoming page's chrome
+ *   snaps in. Default.
+ * - `fade` — both pages cross-fade as whole surfaces while a temporary hero
+ *   clone morphs above them.
  */
+export type HeroType = "static" | "fade";
 export type HeroVariant = "default";
 export type HeroOptions = Record<string, never>;
+export interface NormalizedHeroOptions {
+    type: HeroType;
+    variant: HeroVariant;
+}
+export interface HeroPair {
+    key: string;
+    fromEl: HTMLElement;
+    toEl: HTMLElement;
+}
+export interface HeroResolved {
+    pairs: HeroPair[];
+}
+export interface HeroPrepareCtx {
+    from: Promise<HTMLElement>;
+    to: Promise<HTMLElement>;
+    resolved: Promise<HeroResolved>;
+}
+export interface HeroContributeCtx {
+    from: HTMLElement;
+    to: HTMLElement;
+    resolved: HeroResolved;
+    physics: PhysicsOptions;
+    scrollOffset: {
+        x: number;
+        y: number;
+    };
+    positionedParent: HTMLElement;
+    maxDistance: number;
+    /**
+     * Mutation registry. Strategies push restore callbacks here; the dispatcher
+     * fires them on completion. Keeps cleanup local to each strategy instead of
+     * leaking back into the dispatcher.
+     */
+    onComplete: (fn: () => void) => void;
+}
+/**
+ * Strategy interface. Both methods are optional — a no-op strategy is a
+ * legitimate factory return value (e.g. static chrome).
+ */
+export interface HeroStrategy {
+    prepare?: (ctx: HeroPrepareCtx) => void;
+    contribute?: (ctx: HeroContributeCtx) => Animation[];
+}
 //# sourceMappingURL=types.d.ts.map

package/dist/transitions/hero/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/lib/transitions/hero/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,MAAM,MAAM,WAAW,GAAG,SAAS,CAAC;AAEpC,MAAM,MAAM,WAAW,GAAG,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/lib/transitions/hero/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,QAAQ,CAAC;AAC7C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAMjD;;;;;GAKG;AACH,MAAM,MAAM,QAAQ,GAAG,QAAQ,GAAG,MAAM,CAAC;AACzC,MAAM,MAAM,WAAW,GAAG,SAAS,CAAC;AACpC,MAAM,MAAM,WAAW,GAAG,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;AAOhD,MAAM,WAAW,qBAAqB;IACpC,IAAI,EAAE,QAAQ,CAAC;IACf,OAAO,EAAE,WAAW,CAAC;CACtB;AAMD,MAAM,WAAW,QAAQ;IACvB,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,WAAW,CAAC;IACpB,IAAI,EAAE,WAAW,CAAC;CACnB;AAED,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,QAAQ,EAAE,CAAC;CACnB;AAUD,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,OAAO,CAAC,WAAW,CAAC,CAAC;IAC3B,EAAE,EAAE,OAAO,CAAC,WAAW,CAAC,CAAC;IACzB,QAAQ,EAAE,OAAO,CAAC,YAAY,CAAC,CAAC;CACjC;AAED,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,WAAW,CAAC;IAClB,EAAE,EAAE,WAAW,CAAC;IAChB,QAAQ,EAAE,YAAY,CAAC;IACvB,OAAO,EAAE,cAAc,CAAC;IACxB,YAAY,EAAE;QAAE,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IACvC,gBAAgB,EAAE,WAAW,CAAC;IAC9B,WAAW,EAAE,MAAM,CAAC;IACpB;;;;OAIG;IACH,UAAU,EAAE,CAAC,EAAE,EAAE,MAAM,IAAI,KAAK,IAAI,CAAC;CACtC;AAED;;;GAGG;AACH,MAAM,WAAW,YAAY;IAC3B,OAAO,CAAC,EAAE,CAAC,GAAG,EAAE,cAAc,KAAK,IAAI,CAAC;IACxC,UAAU,CAAC,EAAE,CAAC,GAAG,EAAE,iBAAiB,KAAK,SAAS,EAAE,CAAC;CACtD"}

package/dist/transitions/zoom/provider/blur.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"blur.d.ts","sourceRoot":"","sources":["../../../../src/lib/transitions/zoom/provider/blur.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,QAAQ,CAAC;AAC7C,OAAO,KAAK,EAEV,iBAAiB,EACjB,UAAU,EAEV,cAAc,EACd,YAAY,EACZ,YAAY,EACb,MAAM,UAAU,CAAC;AAClB,OAAO,EAAE,SAAS,EAAoC,MAAM,oBAAoB,CAAC;AAGjF,eAAO,MAAM,YAAY,EAAE,cAE1B,CAAC;AAmEF,qBAAa,sBAAuB,YAAW,YAAY;IACzD,QAAQ,CAAC,OAAO,iBAAgB;IAEhC,UAAU,CAAC,GAAG,EAAE,iBAAiB,GAAG,SAAS,EAAE;CAkBhD;AAQD,qBAAa,eAAgB,YAAW,YAAY;IAClD,OAAO,CAAC,GAAG,EAAE,cAAc,GAAG,OAAO,CAAC,UAAU,CAAC;IAQjD,UAAU,CAAC,GAAG,EAAE,iBAAiB,GAAG,SAAS,EAAE;CAWhD;AAMD,wBAAgB,kBAAkB,IAAI,YAAY,CASjD"}
+{"version":3,"file":"blur.d.ts","sourceRoot":"","sources":["../../../../src/lib/transitions/zoom/provider/blur.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,QAAQ,CAAC;AAC7C,OAAO,KAAK,EAEV,iBAAiB,EACjB,UAAU,EAEV,cAAc,EACd,YAAY,EACZ,YAAY,EACb,MAAM,UAAU,CAAC;AAClB,OAAO,EACL,SAAS,EAGV,MAAM,oBAAoB,CAAC;AAG5B,eAAO,MAAM,YAAY,EAAE,cAM1B,CAAC;AAmEF,qBAAa,sBAAuB,YAAW,YAAY;IACzD,QAAQ,CAAC,OAAO,iBAAgB;IAEhC,UAAU,CAAC,GAAG,EAAE,iBAAiB,GAAG,SAAS,EAAE;CAkBhD;AAQD,qBAAa,eAAgB,YAAW,YAAY;IAClD,OAAO,CAAC,GAAG,EAAE,cAAc,GAAG,OAAO,CAAC,UAAU,CAAC;IAQjD,UAAU,CAAC,GAAG,EAAE,iBAAiB,GAAG,SAAS,EAAE;CAWhD;AAMD,wBAAgB,kBAAkB,IAAI,YAAY,CASjD"}

package/dist/transitions/zoom/provider/static.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"static.d.ts","sourceRoot":"","sources":["../../../../src/lib/transitions/zoom/provider/static.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,QAAQ,CAAC;AAC7C,OAAO,KAAK,EAEV,iBAAiB,EACjB,YAAY,EACZ,YAAY,EACb,MAAM,UAAU,CAAC;AAClB,OAAO,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAG/C,eAAO,MAAM,cAAc,EAAE,cAE5B,CAAC;AAgBF,qBAAa,wBAAyB,YAAW,YAAY;IAC3D,QAAQ,CAAC,OAAO,iBAAkB;IAElC,UAAU,CAAC,IAAI,EAAE,iBAAiB,GAAG,SAAS,EAAE;CAGjD;AAMD,wBAAgB,oBAAoB,IAAI,YAAY,CAQnD"}
+{"version":3,"file":"static.d.ts","sourceRoot":"","sources":["../../../../src/lib/transitions/zoom/provider/static.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,QAAQ,CAAC;AAC7C,OAAO,KAAK,EAEV,iBAAiB,EACjB,YAAY,EACZ,YAAY,EACb,MAAM,UAAU,CAAC;AAClB,OAAO,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAG/C,eAAO,MAAM,cAAc,EAAE,cAM5B,CAAC;AAgBF,qBAAa,wBAAyB,YAAW,YAAY;IAC3D,QAAQ,CAAC,OAAO,iBAAkB;IAElC,UAAU,CAAC,IAAI,EAAE,iBAAiB,GAAG,SAAS,EAAE;CAGjD;AAMD,wBAAgB,oBAAoB,IAAI,YAAY,CAQnD"}

package/dist/transitions/zoom/transition.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"transition.d.ts","sourceRoot":"","sources":["../../../src/lib/transitions/zoom/transition.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAkB,gBAAgB,EAAE,MAAM,QAAQ,CAAC;AAa/D,OAAO,KAAK,EACV,qBAAqB,EAGrB,UAAU,EAKX,MAAM,SAAS,CAAC;AAEjB,YAAY,EAAE,QAAQ,EAAE,WAAW,EAAE,qBAAqB,EAAE,MAAM,SAAS,CAAC;AA0Q5E,eAAO,MAAM,IAAI,GACf,SAAS,qBAAqB,KAC7B,gBAAgB,CAAC,UAAU,CAmF7B,CAAC"}
+{"version":3,"file":"transition.d.ts","sourceRoot":"","sources":["../../../src/lib/transitions/zoom/transition.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAkB,gBAAgB,EAAE,MAAM,QAAQ,CAAC;AAa/D,OAAO,KAAK,EACV,qBAAqB,EAGrB,UAAU,EAKX,MAAM,SAAS,CAAC;AAEjB,YAAY,EAAE,QAAQ,EAAE,WAAW,EAAE,qBAAqB,EAAE,MAAM,SAAS,CAAC;AA4Q5E,eAAO,MAAM,IAAI,GACf,SAAS,qBAAqB,KAC7B,gBAAgB,CAAC,UAAU,CAmF7B,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ssgoi/core",
-  "version": "6.1.0",
+  "version": "6.2.1",
   "description": "Core animation engine for SSGOI - Native app-like page transitions with spring physics",
   "private": false,
   "type": "module",

package/dist/transitions/axis/provider/y.d.ts

@@ -1,3 +0,0 @@
-import { AxisProvider } from '../types';
-export declare function createYProvider(): AxisProvider;
-//# sourceMappingURL=y.d.ts.map

package/dist/transitions/axis/provider/y.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"y.d.ts","sourceRoot":"","sources":["../../../../src/lib/transitions/axis/provider/y.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAEV,YAAY,EAEb,MAAM,UAAU,CAAC;AAuClB,wBAAgB,eAAe,IAAI,YAAY,CAO9C"}