@aphrody/m3-motion 3.2.5 → 3.3.0

package/dist/components/M3ListStagger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"M3ListStagger.d.ts","sourceRoot":"","sources":["../../src/components/M3ListStagger.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAE/B,OAAO,KAAK,EAAE,eAAe,EAAY,MAAM,cAAc,CAAC;AAG9D,MAAM,WAAW,kBAAkB;IACjC;;;OAGG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB;;;OAGG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB;;;OAGG;IACH,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,KAAK,CAAC,aAAa,CAAC;IAC5B,QAAQ,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;CAC5B;AAED,MAAM,WAAW,sBAAuB,SAAQ,eAAe,CAAC,KAAK,CAAC;IACpE,QAAQ,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;CAC5B;AAiCD;;;;;;;GAOG;AACH,eAAO,MAAM,aAAa,2FAmBzB,CAAC;AAIF;;;GAGG;AACH,eAAO,MAAM,iBAAiB,4GAa7B,CAAC"}

package/dist/components/M3SharedAxis.d.ts

@@ -0,0 +1,35 @@
+import * as React from "react";
+import type { HTMLMotionProps, Transition } from "motion/react";
+export interface M3SharedAxisProps extends HTMLMotionProps<"div"> {
+    /**
+     * If true, the component will transition in. If false, it will transition out.
+     * If omitted, the component behaves as a standard motion element meant to be unmounted/mounted
+     * by an external <AnimatePresence>.
+     */
+    in?: boolean;
+    /**
+     * Axis of translation.
+     * @default "x"
+     */
+    axis?: "x" | "y" | "z";
+    /**
+     * Direction of navigation. If true, slides forward/up/zoom-in. If false, slides backward/down/zoom-out.
+     * @default true
+     */
+    forward?: boolean;
+    /**
+     * If true, animate the transition on initial mount.
+     * @default true
+     */
+    appear?: boolean;
+    /**
+     * Custom transition for the shared axis animation.
+     */
+    transition?: Transition;
+}
+/**
+ * M3SharedAxis transition component.
+ * Implements the Material 3 Shared Axis motion pattern (X, Y, Z axes).
+ */
+export declare const M3SharedAxis: React.ForwardRefExoticComponent<Omit<M3SharedAxisProps, "ref"> & React.RefAttributes<HTMLDivElement>>;
+//# sourceMappingURL=M3SharedAxis.d.ts.map

package/dist/components/M3SharedAxis.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"M3SharedAxis.d.ts","sourceRoot":"","sources":["../../src/components/M3SharedAxis.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAE/B,OAAO,KAAK,EAAE,eAAe,EAAE,UAAU,EAAY,MAAM,cAAc,CAAC;AAG1E,MAAM,WAAW,iBAAkB,SAAQ,eAAe,CAAC,KAAK,CAAC;IAC/D;;;;OAIG;IACH,EAAE,CAAC,EAAE,OAAO,CAAC;IACb;;;OAGG;IACH,IAAI,CAAC,EAAE,GAAG,GAAG,GAAG,GAAG,GAAG,CAAC;IACvB;;;OAGG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB;;;OAGG;IACH,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB;;OAEG;IACH,UAAU,CAAC,EAAE,UAAU,CAAC;CACzB;AAED;;;GAGG;AACH,eAAO,MAAM,YAAY,uGA6DxB,CAAC"}

package/dist/components/M3Transition.d.ts

@@ -0,0 +1,36 @@
+import * as React from "react";
+import type { HTMLMotionProps, MotionStyle, Variants } from "motion/react";
+export type M3TransitionPattern = "fade" | "fade-through" | "shared-axis-x" | "shared-axis-y" | "shared-axis-z" | "collapse";
+export interface M3TransitionProps extends Omit<HTMLMotionProps<"div">, "variants" | "style"> {
+    style?: MotionStyle;
+    /**
+     * Unique key representing the active view/content. Changing this key triggers the transition.
+     */
+    stateKey: React.Key;
+    /**
+     * Which M3 transition pattern to apply.
+     * @default "fade"
+     */
+    pattern?: M3TransitionPattern;
+    /**
+     * Direction of navigation for shared-axis-* patterns.
+     * @default true
+     */
+    forward?: boolean;
+    /**
+     * Custom variants — overrides the pattern defaults entirely.
+     */
+    variants?: Variants;
+    /**
+     * AnimatePresence mode.
+     * @default "wait"
+     */
+    mode?: "wait" | "sync" | "popLayout";
+}
+/**
+ * M3Transition — generic Material 3 transition wrapper.
+ * Supports all standard M3 patterns via the `pattern` prop.
+ * The `stateKey` prop drives AnimatePresence re-mounts.
+ */
+export declare const M3Transition: React.ForwardRefExoticComponent<Omit<M3TransitionProps, "ref"> & React.RefAttributes<HTMLDivElement>>;
+//# sourceMappingURL=M3Transition.d.ts.map

package/dist/components/M3Transition.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"M3Transition.d.ts","sourceRoot":"","sources":["../../src/components/M3Transition.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAE/B,OAAO,KAAK,EAAE,eAAe,EAAE,WAAW,EAAc,QAAQ,EAAE,MAAM,cAAc,CAAC;AAGvF,MAAM,MAAM,mBAAmB,GAC3B,MAAM,GACN,cAAc,GACd,eAAe,GACf,eAAe,GACf,eAAe,GACf,UAAU,CAAC;AAEf,MAAM,WAAW,iBAAkB,SAAQ,IAAI,CAAC,eAAe,CAAC,KAAK,CAAC,EAAE,UAAU,GAAG,OAAO,CAAC;IAC3F,KAAK,CAAC,EAAE,WAAW,CAAC;IACpB;;OAEG;IACH,QAAQ,EAAE,KAAK,CAAC,GAAG,CAAC;IACpB;;;OAGG;IACH,OAAO,CAAC,EAAE,mBAAmB,CAAC;IAC9B;;;OAGG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB;;OAEG;IACH,QAAQ,CAAC,EAAE,QAAQ,CAAC;IACpB;;;OAGG;IACH,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,WAAW,CAAC;CACtC;AA0HD;;;;GAIG;AACH,eAAO,MAAM,YAAY,uGAoCxB,CAAC"}

package/dist/easings.d.ts

@@ -0,0 +1,60 @@
+/**
+ * Material Design 3 Easing Presets.
+ * Represented as cubic-bezier array coordinates [x1, y1, x2, y2].
+ *
+ * Source of truth: packages/material-web/tokens/versions/v0_192/_md-sys-motion.scss
+ * and docs/01-md3-spec-foundations.md §7.1
+ *
+ * Note on `emphasized`: the full M3 emphasized path is a 2-segment spline
+ * (not expressible as a single cubic-bezier). The token file maps
+ * easing-emphasized to cubic-bezier(0.2, 0, 0, 1) — identical to standard —
+ * because that is the closest single-bezier approximation used in web
+ * implementations. Use emphasizedDecelerate / emphasizedAccelerate for
+ * enter/exit transitions respectively (recommended practice per spec §7.1).
+ */
+export declare const m3Easings: {
+    /** Closest single-bezier approximation. Use emphasizedDecelerate/Accelerate for transitions. */
+    readonly emphasized: readonly [0.2, 0, 0, 1];
+    readonly emphasizedDecelerate: readonly [0.05, 0.7, 0.1, 1];
+    readonly emphasizedAccelerate: readonly [0.3, 0, 0.8, 0.15];
+    readonly standard: readonly [0.2, 0, 0, 1];
+    readonly standardDecelerate: readonly [0, 0, 0, 1];
+    readonly standardAccelerate: readonly [0.3, 0, 1, 1];
+    readonly linear: readonly [0, 0, 1, 1];
+    /** Legacy (M2 default) — kept for migration compatibility. */
+    readonly legacy: readonly [0.4, 0, 0.2, 1];
+    readonly legacyDecelerate: readonly [0, 0, 0.2, 1];
+    readonly legacyAccelerate: readonly [0.4, 0, 1, 1];
+};
+export type M3EasingKey = keyof typeof m3Easings;
+export type M3EasingValue = (typeof m3Easings)[M3EasingKey];
+/**
+ * Material Design 3 Duration Presets (in seconds, compatible with Motion duration option).
+ *
+ * Canonical values from _md-sys-motion.scss:
+ * short1=50ms, short2=100ms, short3=150ms, short4=200ms
+ * medium1=250ms, medium2=300ms, medium3=350ms, medium4=400ms
+ * long1=450ms, long2=500ms, long3=550ms, long4=600ms
+ * extraLong1=700ms, extraLong2=800ms, extraLong3=900ms, extraLong4=1000ms
+ */
+export declare const m3Durations: {
+    readonly short1: 0.05;
+    readonly short2: 0.1;
+    readonly short3: 0.15;
+    readonly short4: 0.2;
+    readonly medium1: 0.25;
+    readonly medium2: 0.3;
+    readonly medium3: 0.35;
+    readonly medium4: 0.4;
+    readonly long1: 0.45;
+    readonly long2: 0.5;
+    readonly long3: 0.55;
+    readonly long4: 0.6;
+    readonly extraLong1: 0.7;
+    readonly extraLong2: 0.8;
+    readonly extraLong3: 0.9;
+    readonly extraLong4: 1;
+};
+export type M3DurationKey = keyof typeof m3Durations;
+export type M3DurationValue = (typeof m3Durations)[M3DurationKey];
+//# sourceMappingURL=easings.d.ts.map

package/dist/easings.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"easings.d.ts","sourceRoot":"","sources":["../src/easings.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,SAAS;IACpB,gGAAgG;aAChG,UAAU,YAAG,GAAG,EAAE,CAAG,EAAE,CAAG,EAAE,CAAG;aAC/B,oBAAoB,YAAG,IAAI,EAAE,GAAG,EAAE,GAAG,EAAE,CAAG;aAC1C,oBAAoB,YAAG,GAAG,EAAE,CAAG,EAAE,GAAG,EAAE,IAAI;aAC1C,QAAQ,YAAG,GAAG,EAAE,CAAG,EAAE,CAAG,EAAE,CAAG;aAC7B,kBAAkB,YAAG,CAAG,EAAE,CAAG,EAAE,CAAG,EAAE,CAAG;aACvC,kBAAkB,YAAG,GAAG,EAAE,CAAG,EAAE,CAAG,EAAE,CAAG;aACvC,MAAM,YAAG,CAAG,EAAE,CAAG,EAAE,CAAG,EAAE,CAAG;IAC3B,8DAA8D;aAC9D,MAAM,YAAG,GAAG,EAAE,CAAG,EAAE,GAAG,EAAE,CAAG;aAC3B,gBAAgB,YAAG,CAAG,EAAE,CAAG,EAAE,GAAG,EAAE,CAAG;aACrC,gBAAgB,YAAG,GAAG,EAAE,CAAG,EAAE,CAAG,EAAE,CAAG;CAC7B,CAAC;AAEX,MAAM,MAAM,WAAW,GAAG,MAAM,OAAO,SAAS,CAAC;AACjD,MAAM,MAAM,aAAa,GAAG,CAAC,OAAO,SAAS,CAAC,CAAC,WAAW,CAAC,CAAC;AAE5D;;;;;;;;GAQG;AACH,eAAO,MAAM,WAAW;aACtB,MAAM,EAAE,IAAI;aACZ,MAAM,EAAE,GAAG;aACX,MAAM,EAAE,IAAI;aACZ,MAAM,EAAE,GAAG;aACX,OAAO,EAAE,IAAI;aACb,OAAO,EAAE,GAAG;aACZ,OAAO,EAAE,IAAI;aACb,OAAO,EAAE,GAAG;aACZ,KAAK,EAAE,IAAI;aACX,KAAK,EAAE,GAAG;aACV,KAAK,EAAE,IAAI;aACX,KAAK,EAAE,GAAG;aACV,UAAU,EAAE,GAAG;aACf,UAAU,EAAE,GAAG;aACf,UAAU,EAAE,GAAG;aACf,UAAU,EAAE,CAAG;CACP,CAAC;AAEX,MAAM,MAAM,aAAa,GAAG,MAAM,OAAO,WAAW,CAAC;AACrD,MAAM,MAAM,eAAe,GAAG,CAAC,OAAO,WAAW,CAAC,CAAC,aAAa,CAAC,CAAC"}

package/dist/hooks/useM3Animate.d.ts

@@ -0,0 +1,21 @@
+import type { AnimationScope, AnimationPlaybackControlsWithThen, AnimationSequence, SequenceOptions, ElementOrSelector, DOMKeyframesDefinition, AnimationOptions, MotionValue, UnresolvedValueKeyframe, ValueAnimationTransition, ObjectTarget } from "motion/react";
+/**
+ * Overloaded type for the scoped animate function returned by useM3Animate.
+ * Mirrors the overload set of the underlying motion animate, adding M3 defaults.
+ */
+export interface M3AnimateFn {
+    (sequence: AnimationSequence, options?: SequenceOptions): AnimationPlaybackControlsWithThen;
+    (value: string | MotionValue<string>, keyframes: string | UnresolvedValueKeyframe<string>[], options?: ValueAnimationTransition<string>): AnimationPlaybackControlsWithThen;
+    (value: number | MotionValue<number>, keyframes: number | UnresolvedValueKeyframe<number>[], options?: ValueAnimationTransition<number>): AnimationPlaybackControlsWithThen;
+    <V extends string | number>(value: V | MotionValue<V>, keyframes: V | UnresolvedValueKeyframe<V>[], options?: ValueAnimationTransition<V>): AnimationPlaybackControlsWithThen;
+    (element: ElementOrSelector, keyframes: DOMKeyframesDefinition, options?: AnimationOptions): AnimationPlaybackControlsWithThen;
+    <O extends object>(object: O | O[], keyframes: ObjectTarget<O>, options?: AnimationOptions): AnimationPlaybackControlsWithThen;
+}
+/**
+ * A custom hook wrapping motion's `useAnimate` that injects Material 3 motion defaults
+ * (emphasized easing and medium2 duration) for all imperative DOM animations.
+ *
+ * SSR-safe: useAnimate creates refs; no DOM access occurs at module or render time.
+ */
+export declare function useM3Animate<T extends Element = HTMLElement>(): [AnimationScope<T>, M3AnimateFn];
+//# sourceMappingURL=useM3Animate.d.ts.map

package/dist/hooks/useM3Animate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useM3Animate.d.ts","sourceRoot":"","sources":["../../src/hooks/useM3Animate.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,cAAc,EACd,iCAAiC,EACjC,iBAAiB,EACjB,eAAe,EACf,iBAAiB,EACjB,sBAAsB,EACtB,gBAAgB,EAChB,WAAW,EACX,uBAAuB,EACvB,wBAAwB,EACxB,YAAY,EACb,MAAM,cAAc,CAAC;AAGtB;;;GAGG;AACH,MAAM,WAAW,WAAW;IAC1B,CAAC,QAAQ,EAAE,iBAAiB,EAAE,OAAO,CAAC,EAAE,eAAe,GAAG,iCAAiC,CAAC;IAC5F,CACE,KAAK,EAAE,MAAM,GAAG,WAAW,CAAC,MAAM,CAAC,EACnC,SAAS,EAAE,MAAM,GAAG,uBAAuB,CAAC,MAAM,CAAC,EAAE,EACrD,OAAO,CAAC,EAAE,wBAAwB,CAAC,MAAM,CAAC,GACzC,iCAAiC,CAAC;IACrC,CACE,KAAK,EAAE,MAAM,GAAG,WAAW,CAAC,MAAM,CAAC,EACnC,SAAS,EAAE,MAAM,GAAG,uBAAuB,CAAC,MAAM,CAAC,EAAE,EACrD,OAAO,CAAC,EAAE,wBAAwB,CAAC,MAAM,CAAC,GACzC,iCAAiC,CAAC;IACrC,CAAC,CAAC,SAAS,MAAM,GAAG,MAAM,EACxB,KAAK,EAAE,CAAC,GAAG,WAAW,CAAC,CAAC,CAAC,EACzB,SAAS,EAAE,CAAC,GAAG,uBAAuB,CAAC,CAAC,CAAC,EAAE,EAC3C,OAAO,CAAC,EAAE,wBAAwB,CAAC,CAAC,CAAC,GACpC,iCAAiC,CAAC;IACrC,CACE,OAAO,EAAE,iBAAiB,EAC1B,SAAS,EAAE,sBAAsB,EACjC,OAAO,CAAC,EAAE,gBAAgB,GACzB,iCAAiC,CAAC;IACrC,CAAC,CAAC,SAAS,MAAM,EACf,MAAM,EAAE,CAAC,GAAG,CAAC,EAAE,EACf,SAAS,EAAE,YAAY,CAAC,CAAC,CAAC,EAC1B,OAAO,CAAC,EAAE,gBAAgB,GACzB,iCAAiC,CAAC;CACtC;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,CAAC,SAAS,OAAO,GAAG,WAAW,KAAK,CAAC,cAAc,CAAC,CAAC,CAAC,EAAE,WAAW,CAAC,CA0ChG"}

package/dist/index.d.ts

@@ -0,0 +1,12 @@
+export * from "./springs.js";
+export * from "./easings.js";
+export * from "./spring-interpolation.js";
+export * from "./components/M3Fade.js";
+export * from "./components/M3SharedAxis.js";
+export * from "./components/M3FadeThrough.js";
+export * from "./components/M3Collapse.js";
+export * from "./components/M3ContainerTransform.js";
+export * from "./components/M3Transition.js";
+export * from "./components/M3ListStagger.js";
+export * from "./hooks/useM3Animate.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAC;AAC7B,cAAc,cAAc,CAAC;AAC7B,cAAc,2BAA2B,CAAC;AAC1C,cAAc,wBAAwB,CAAC;AACvC,cAAc,8BAA8B,CAAC;AAC7C,cAAc,+BAA+B,CAAC;AAC9C,cAAc,4BAA4B,CAAC;AAC3C,cAAc,sCAAsC,CAAC;AACrD,cAAc,8BAA8B,CAAC;AAC7C,cAAc,+BAA+B,CAAC;AAC9C,cAAc,yBAAyB,CAAC"}