@mks2508/mks-ui 0.2.1 → 0.3.2

package/dist/react-ui/primitives/waapi/core/animationConstants.d.ts

@@ -0,0 +1,156 @@
+/**
+ * Obtains responsive animation duration for the current device.
+ * Returns 0 if the user prefers reduced motion, 60% on mobile.
+ * @param baseDuration - Base duration in ms
+ * @returns Adjusted duration for the current device
+ */
+export declare const getResponsiveDuration: (baseDuration: number) => number;
+/**
+ * Obtains responsive stagger delay for the current device.
+ * Returns 0 if the user prefers reduced motion, 50% on mobile.
+ * @param baseDelay - Base delay in ms
+ * @returns Adjusted delay for the current device
+ */
+export declare const getResponsiveStagger: (baseDelay: number) => number;
+/** Core timing constants (ms) */
+export declare const TIMING: {
+    readonly ENTER_DURATION: 200;
+    readonly EXIT_DURATION: 180;
+    readonly COLLAPSE_DURATION: 200;
+    readonly FLIP_DURATION: 300;
+    readonly ENTER_STAGGER: 15;
+    readonly EXIT_STAGGER: 0;
+    readonly COLLAPSE_DELAY: 30;
+    readonly FLIP_DELAY_PERCENT: 0.25;
+    readonly MIN_DELTA_PX: 1;
+};
+/** Transform offsets (px/deg) */
+export declare const TRANSFORMS: {
+    readonly OFFSET_Y_ENTER: 8;
+    readonly OFFSET_Y_EXIT: -8;
+    readonly OFFSET_X: 16;
+    readonly SCALE_ENTER: 0.85;
+    readonly SCALE_EXIT: 0.85;
+    readonly ROTATE_EXIT: 0;
+};
+/** Visual effects */
+export declare const EFFECTS: {
+    readonly BLUR_ENTER: 4;
+    readonly BLUR_EXIT: 2;
+};
+/** Research-based easing curves (Material Design + CSS-Tricks + Josh W. Comeau) */
+export declare const EASINGS: {
+    readonly MATERIAL_DECELERATE: "cubic-bezier(0, 0, 0.2, 1)";
+    readonly MATERIAL_ACCELERATE: "cubic-bezier(0.4, 0, 1, 1)";
+    readonly MATERIAL_STANDARD: "cubic-bezier(0.4, 0, 0.2, 1)";
+    readonly EASE_REORDER: "cubic-bezier(0.215, 0.61, 0.355, 1)";
+    readonly EASE_OUT_CUBIC: "cubic-bezier(0.33, 1, 0.68, 1)";
+    readonly EASE_IN_CUBIC: "cubic-bezier(0.32, 0, 0.67, 0)";
+    readonly EASE_IN_OUT: "cubic-bezier(0.42, 0, 0.58, 1)";
+    readonly EASE_OUT_EXPO: "cubic-bezier(0.16, 1, 0.3, 1)";
+    readonly EASE_FLIP: "cubic-bezier(0.2, 0, 0.2, 1)";
+    readonly SPRING_GENTLE: "linear(0, 0.009, 0.035 2.1%, 0.141 4.4%, 0.723 12.9%, 0.938 16.7%, 1.017 19.4%, 1.067, 1.099 24.3%, 1.108 26%, 1.100, 1.078 30.1%, 1.049 32.5%, 0.994 37.3%, 0.981 40.2%, 0.974 43.4%, 0.975 50.2%, 0.997 62.5%, 1.001 74.7%, 1)";
+    readonly SPRING_SNAPPY: "linear(0, 0.006, 0.024 2%, 0.096 4.2%, 0.397 9.3%, 0.861 15.8%, 1.002 18.7%, 1.093 21.4%, 1.143 24%, 1.156, 1.149 28.3%, 1.115 31.5%, 1.022 40%, 0.988 47.1%, 0.984 55.1%, 0.998 72.3%, 1.001 85.4%, 1)";
+};
+/** Responsive animation configurations with accessibility */
+export declare const RESPONSIVE_CONFIGS: {
+    readonly tokenEnter: {
+        readonly duration: number;
+        readonly stagger: number;
+        readonly easing: "cubic-bezier(0, 0, 0.2, 1)";
+        readonly blur: 4;
+        readonly offsetY: 8;
+        readonly scale: 0.85;
+    };
+    readonly tokenExit: {
+        readonly duration: number;
+        readonly stagger: number;
+        readonly easing: "cubic-bezier(0.4, 0, 1, 1)";
+        readonly blur: 2;
+        readonly offsetY: -8;
+        readonly scale: 0.85;
+    };
+    readonly collapse: {
+        readonly duration: number;
+        readonly delay: 30;
+        readonly easing: "cubic-bezier(0.4, 0, 0.2, 1)";
+    };
+    readonly flip: {
+        readonly duration: number;
+        readonly delayPercent: 0.25;
+        readonly easing: "cubic-bezier(0.215, 0.61, 0.355, 1)";
+    };
+};
+/** Legacy defaults for backward compatibility */
+export declare const ANIMATION_DEFAULTS: {
+    DURATION_ENTER: 200;
+    DURATION_EXIT: 180;
+    DURATION_FLIP: 300;
+    STAGGER_DELAY: 15;
+    OFFSET_VERTICAL: 8;
+    OFFSET_HORIZONTAL: 16;
+    BLUR_AMOUNT: 4;
+    EASING_ENTER: "cubic-bezier(0.33, 1, 0.68, 1)";
+    EASING_EXIT: "cubic-bezier(0.32, 0, 0.67, 0)";
+    EASING_FLIP: "linear(0, 0.009, 0.035 2.1%, 0.141 4.4%, 0.723 12.9%, 0.938 16.7%, 1.017 19.4%, 1.067, 1.099 24.3%, 1.108 26%, 1.100, 1.078 30.1%, 1.049 32.5%, 0.994 37.3%, 0.981 40.2%, 0.974 43.4%, 0.975 50.2%, 0.997 62.5%, 1.001 74.7%, 1)";
+    SPRING_EASING: "linear(0, 0.009, 0.035 2.1%, 0.141 4.4%, 0.723 12.9%, 0.938 16.7%, 1.017 19.4%, 1.067, 1.099 24.3%, 1.108 26%, 1.100, 1.078 30.1%, 1.049 32.5%, 0.994 37.3%, 0.981 40.2%, 0.974 43.4%, 0.975 50.2%, 0.997 62.5%, 1.001 74.7%, 1)";
+};
+/** Composite presets for specific use cases */
+export declare const ANIMATION_CONFIGS: {
+    readonly tokenEnter: {
+        readonly duration: 200;
+        readonly stagger: 15;
+        readonly easing: "cubic-bezier(0, 0, 0.2, 1)";
+        readonly blur: 4;
+        readonly offsetY: 8;
+        readonly scale: 0.85;
+    };
+    readonly tokenExit: {
+        readonly duration: 180;
+        readonly stagger: 0;
+        readonly easing: "cubic-bezier(0.4, 0, 1, 1)";
+        readonly blur: 2;
+        readonly offsetY: -8;
+        readonly scale: 0.85;
+    };
+    readonly collapse: {
+        readonly duration: 200;
+        readonly delay: 30;
+        readonly easing: "cubic-bezier(0.4, 0, 0.2, 1)";
+    };
+    readonly flip: {
+        readonly duration: 300;
+        readonly delayPercent: 0.25;
+        readonly easing: "cubic-bezier(0.215, 0.61, 0.355, 1)";
+    };
+};
+/** High-level animation presets */
+export declare const PRESETS: {
+    newToken: {
+        mode: "character";
+        direction: "vertical";
+        staggerDelay: number;
+        blur: boolean;
+        widthAnimation: boolean;
+        duration: number;
+        initial: "initial";
+    };
+    existingToken: {
+        mode: "none";
+        blur: boolean;
+        widthAnimation: boolean;
+        initial: false;
+    };
+    placeholder: {
+        mode: "word";
+        direction: "vertical";
+        blur: boolean;
+        widthAnimation: boolean;
+        duration: number;
+    };
+    separator: {
+        duration: number;
+        widthAnimation: boolean;
+    };
+};
+//# sourceMappingURL=animationConstants.d.ts.map

package/dist/react-ui/primitives/waapi/core/animationConstants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"animationConstants.d.ts","sourceRoot":"","sources":["../../../../../src/react-ui/primitives/waapi/core/animationConstants.ts"],"names":[],"mappings":"AAcA;;;;;GAKG;AACH,eAAO,MAAM,qBAAqB,GAAI,cAAc,MAAM,KAAG,MAY5D,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,oBAAoB,GAAI,WAAW,MAAM,KAAG,MAQxD,CAAC;AAEF,iCAAiC;AACjC,eAAO,MAAM,MAAM;;;;;;;;;;CAaT,CAAC;AAEX,iCAAiC;AACjC,eAAO,MAAM,UAAU;;;;;;;CASb,CAAC;AAEX,qBAAqB;AACrB,eAAO,MAAM,OAAO;;;CAGV,CAAC;AAEX,mFAAmF;AACnF,eAAO,MAAM,OAAO;;;;;;;;;;;;CAiBV,CAAC;AAEX,6DAA6D;AAC7D,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;CA2BrB,CAAC;AAEX,iDAAiD;AACjD,eAAO,MAAM,kBAAkB;;;;;;;;;;;;CAgB9B,CAAC;AAEF,+CAA+C;AAC/C,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;;;CA2BpB,CAAC;AAEX,mCAAmC;AACnC,eAAO,MAAM,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;CA8BnB,CAAC"}

package/dist/react-ui/primitives/waapi/core/animationConstants.js

@@ -0,0 +1,180 @@
+//#region src/react-ui/primitives/waapi/core/animationConstants.ts
+/**
+* Obtains responsive animation duration for the current device.
+* Returns 0 if the user prefers reduced motion, 60% on mobile.
+* @param baseDuration - Base duration in ms
+* @returns Adjusted duration for the current device
+*/
+const getResponsiveDuration = (baseDuration) => {
+	if (typeof window === "undefined") return baseDuration;
+	if (window.matchMedia("(prefers-reduced-motion: reduce)").matches) return 0;
+	if (window.innerWidth < 768) return Math.round(baseDuration * .6);
+	return baseDuration;
+};
+/**
+* Obtains responsive stagger delay for the current device.
+* Returns 0 if the user prefers reduced motion, 50% on mobile.
+* @param baseDelay - Base delay in ms
+* @returns Adjusted delay for the current device
+*/
+const getResponsiveStagger = (baseDelay) => {
+	if (typeof window === "undefined") return baseDelay;
+	if (window.matchMedia("(prefers-reduced-motion: reduce)").matches) return 0;
+	return window.innerWidth < 768 ? Math.round(baseDelay * .5) : baseDelay;
+};
+/** Core timing constants (ms) */
+const TIMING = {
+	ENTER_DURATION: 200,
+	EXIT_DURATION: 180,
+	COLLAPSE_DURATION: 200,
+	FLIP_DURATION: 300,
+	ENTER_STAGGER: 15,
+	EXIT_STAGGER: 0,
+	COLLAPSE_DELAY: 30,
+	FLIP_DELAY_PERCENT: .25,
+	MIN_DELTA_PX: 1
+};
+/** Transform offsets (px/deg) */
+const TRANSFORMS = {
+	OFFSET_Y_ENTER: 8,
+	OFFSET_Y_EXIT: -8,
+	OFFSET_X: 16,
+	SCALE_ENTER: .85,
+	SCALE_EXIT: .85,
+	ROTATE_EXIT: 0
+};
+/** Visual effects */
+const EFFECTS = {
+	BLUR_ENTER: 4,
+	BLUR_EXIT: 2
+};
+/** Research-based easing curves (Material Design + CSS-Tricks + Josh W. Comeau) */
+const EASINGS = {
+	MATERIAL_DECELERATE: "cubic-bezier(0, 0, 0.2, 1)",
+	MATERIAL_ACCELERATE: "cubic-bezier(0.4, 0, 1, 1)",
+	MATERIAL_STANDARD: "cubic-bezier(0.4, 0, 0.2, 1)",
+	EASE_REORDER: "cubic-bezier(0.215, 0.61, 0.355, 1)",
+	EASE_OUT_CUBIC: "cubic-bezier(0.33, 1, 0.68, 1)",
+	EASE_IN_CUBIC: "cubic-bezier(0.32, 0, 0.67, 0)",
+	EASE_IN_OUT: "cubic-bezier(0.42, 0, 0.58, 1)",
+	EASE_OUT_EXPO: "cubic-bezier(0.16, 1, 0.3, 1)",
+	EASE_FLIP: "cubic-bezier(0.2, 0, 0.2, 1)",
+	SPRING_GENTLE: `linear(0, 0.009, 0.035 2.1%, 0.141 4.4%, 0.723 12.9%, 0.938 16.7%, 1.017 19.4%, 1.067, 1.099 24.3%, 1.108 26%, 1.100, 1.078 30.1%, 1.049 32.5%, 0.994 37.3%, 0.981 40.2%, 0.974 43.4%, 0.975 50.2%, 0.997 62.5%, 1.001 74.7%, 1)`,
+	SPRING_SNAPPY: `linear(0, 0.006, 0.024 2%, 0.096 4.2%, 0.397 9.3%, 0.861 15.8%, 1.002 18.7%, 1.093 21.4%, 1.143 24%, 1.156, 1.149 28.3%, 1.115 31.5%, 1.022 40%, 0.988 47.1%, 0.984 55.1%, 0.998 72.3%, 1.001 85.4%, 1)`
+};
+/** Responsive animation configurations with accessibility */
+const RESPONSIVE_CONFIGS = {
+	tokenEnter: {
+		get duration() {
+			return getResponsiveDuration(TIMING.ENTER_DURATION);
+		},
+		get stagger() {
+			return getResponsiveStagger(TIMING.ENTER_STAGGER);
+		},
+		easing: EASINGS.MATERIAL_DECELERATE,
+		blur: EFFECTS.BLUR_ENTER,
+		offsetY: TRANSFORMS.OFFSET_Y_ENTER,
+		scale: TRANSFORMS.SCALE_ENTER
+	},
+	tokenExit: {
+		get duration() {
+			return getResponsiveDuration(TIMING.EXIT_DURATION);
+		},
+		get stagger() {
+			return getResponsiveStagger(TIMING.EXIT_STAGGER);
+		},
+		easing: EASINGS.MATERIAL_ACCELERATE,
+		blur: EFFECTS.BLUR_EXIT,
+		offsetY: TRANSFORMS.OFFSET_Y_EXIT,
+		scale: TRANSFORMS.SCALE_EXIT
+	},
+	collapse: {
+		get duration() {
+			return getResponsiveDuration(TIMING.COLLAPSE_DURATION);
+		},
+		delay: TIMING.COLLAPSE_DELAY,
+		easing: EASINGS.MATERIAL_STANDARD
+	},
+	flip: {
+		get duration() {
+			return getResponsiveDuration(TIMING.FLIP_DURATION);
+		},
+		delayPercent: TIMING.FLIP_DELAY_PERCENT,
+		easing: EASINGS.EASE_REORDER
+	}
+};
+/** Legacy defaults for backward compatibility */
+const ANIMATION_DEFAULTS = {
+	DURATION_ENTER: TIMING.ENTER_DURATION,
+	DURATION_EXIT: TIMING.EXIT_DURATION,
+	DURATION_FLIP: TIMING.FLIP_DURATION,
+	STAGGER_DELAY: TIMING.ENTER_STAGGER,
+	OFFSET_VERTICAL: TRANSFORMS.OFFSET_Y_ENTER,
+	OFFSET_HORIZONTAL: TRANSFORMS.OFFSET_X,
+	BLUR_AMOUNT: EFFECTS.BLUR_ENTER,
+	EASING_ENTER: EASINGS.EASE_OUT_CUBIC,
+	EASING_EXIT: EASINGS.EASE_IN_CUBIC,
+	EASING_FLIP: EASINGS.SPRING_GENTLE,
+	SPRING_EASING: EASINGS.SPRING_GENTLE
+};
+/** Composite presets for specific use cases */
+const ANIMATION_CONFIGS = {
+	tokenEnter: {
+		duration: TIMING.ENTER_DURATION,
+		stagger: TIMING.ENTER_STAGGER,
+		easing: EASINGS.MATERIAL_DECELERATE,
+		blur: EFFECTS.BLUR_ENTER,
+		offsetY: TRANSFORMS.OFFSET_Y_ENTER,
+		scale: TRANSFORMS.SCALE_ENTER
+	},
+	tokenExit: {
+		duration: TIMING.EXIT_DURATION,
+		stagger: TIMING.EXIT_STAGGER,
+		easing: EASINGS.MATERIAL_ACCELERATE,
+		blur: EFFECTS.BLUR_EXIT,
+		offsetY: TRANSFORMS.OFFSET_Y_EXIT,
+		scale: TRANSFORMS.SCALE_EXIT
+	},
+	collapse: {
+		duration: TIMING.COLLAPSE_DURATION,
+		delay: TIMING.COLLAPSE_DELAY,
+		easing: EASINGS.MATERIAL_STANDARD
+	},
+	flip: {
+		duration: TIMING.FLIP_DURATION,
+		delayPercent: TIMING.FLIP_DELAY_PERCENT,
+		easing: EASINGS.EASE_REORDER
+	}
+};
+/** High-level animation presets */
+const PRESETS = {
+	newToken: {
+		mode: "character",
+		direction: "vertical",
+		staggerDelay: 15,
+		blur: true,
+		widthAnimation: true,
+		duration: 200,
+		initial: "initial"
+	},
+	existingToken: {
+		mode: "none",
+		blur: false,
+		widthAnimation: false,
+		initial: false
+	},
+	placeholder: {
+		mode: "word",
+		direction: "vertical",
+		blur: true,
+		widthAnimation: false,
+		duration: 150
+	},
+	separator: {
+		duration: 100,
+		widthAnimation: true
+	}
+};
+
+//#endregion
+export { ANIMATION_CONFIGS, ANIMATION_DEFAULTS, EASINGS, EFFECTS, PRESETS, RESPONSIVE_CONFIGS, TIMING, TRANSFORMS, getResponsiveDuration, getResponsiveStagger };

package/dist/react-ui/primitives/waapi/core/index.d.ts

@@ -0,0 +1,16 @@
+/**
+ * WAAPI Core — FLIP animation infrastructure.
+ *
+ * Provides the composable hooks and constants that power
+ * Reorder, Morph, and other WAAPI primitives.
+ *
+ * @module primitives/waapi/core
+ */
+export { TIMING, TRANSFORMS, EFFECTS, EASINGS, RESPONSIVE_CONFIGS, ANIMATION_CONFIGS, ANIMATION_DEFAULTS, PRESETS, getResponsiveDuration, getResponsiveStagger, } from './animationConstants';
+export type { IFLIPDelta, IAnimationTiming, IPositionRect, IElementRegistryAPI, IElementRegistryCallbacks, IPositionCaptureAPI, IPositionCaptureOptions, IFLIPAnimationAPI, IFLIPAnimationOptions, IExitOptions, IEnterOptions, IAnimationOrchestratorConfig, IAnimationOrchestratorAPI, IOrchestratorState, IAnimationEvent, } from './types';
+export type { FLIPBehavior, ExitPositionStrategy, AnimationPhase, } from './types';
+export { useElementRegistry } from './useElementRegistry';
+export { usePositionCapture } from './usePositionCapture';
+export { useFLIPAnimation } from './useFLIPAnimation';
+export { useAnimationOrchestrator } from './useAnimationOrchestrator';
+//# sourceMappingURL=index.d.ts.map

package/dist/react-ui/primitives/waapi/core/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/react-ui/primitives/waapi/core/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,EACL,MAAM,EACN,UAAU,EACV,OAAO,EACP,OAAO,EACP,kBAAkB,EAClB,iBAAiB,EACjB,kBAAkB,EAClB,OAAO,EACP,qBAAqB,EACrB,oBAAoB,GACrB,MAAM,sBAAsB,CAAC;AAG9B,YAAY,EACV,UAAU,EACV,gBAAgB,EAChB,aAAa,EACb,mBAAmB,EACnB,yBAAyB,EACzB,mBAAmB,EACnB,uBAAuB,EACvB,iBAAiB,EACjB,qBAAqB,EACrB,YAAY,EACZ,aAAa,EACb,4BAA4B,EAC5B,yBAAyB,EACzB,kBAAkB,EAClB,eAAe,GAChB,MAAM,SAAS,CAAC;AAEjB,YAAY,EACV,YAAY,EACZ,oBAAoB,EACpB,cAAc,GACf,MAAM,SAAS,CAAC;AAGjB,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC1D,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC1D,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACtD,OAAO,EAAE,wBAAwB,EAAE,MAAM,4BAA4B,CAAC"}

package/dist/react-ui/primitives/waapi/core/index.js

@@ -0,0 +1,5 @@
+import { ANIMATION_CONFIGS, ANIMATION_DEFAULTS, EASINGS, EFFECTS, PRESETS, RESPONSIVE_CONFIGS, TIMING, TRANSFORMS, getResponsiveDuration, getResponsiveStagger } from "./animationConstants.js";
+import { useElementRegistry } from "./useElementRegistry.js";
+import { usePositionCapture } from "./usePositionCapture.js";
+import { useFLIPAnimation } from "./useFLIPAnimation.js";
+import { useAnimationOrchestrator } from "./useAnimationOrchestrator.js";

package/dist/react-ui/primitives/waapi/core/types.d.ts

@@ -0,0 +1,143 @@
+/**
+ * Core types for headless animation primitives.
+ * Based on WAAPI (Web Animations API) patterns.
+ *
+ * @module primitives/waapi/core/types
+ */
+/** Calculated delta between two captured positions of an element */
+export interface IFLIPDelta {
+    id: string;
+    deltaX: number;
+    deltaY: number;
+    deltaWidth: number;
+    deltaHeight: number;
+    isSignificant: boolean;
+}
+/** Timing configuration for a single animation */
+export interface IAnimationTiming {
+    duration: number;
+    delay?: number;
+    easing: string;
+    fill?: FillMode;
+}
+/** Captured position rectangle */
+export interface IPositionRect {
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+}
+/** API for tracking DOM elements by ID */
+export interface IElementRegistryAPI {
+    register: (id: string, el: HTMLElement | null) => void;
+    unregister: (id: string) => void;
+    get: (id: string) => HTMLElement | undefined;
+    getAll: () => Map<string, HTMLElement>;
+    has: (id: string) => boolean;
+    clear: () => void;
+    size: number;
+}
+/** Callbacks for element registry lifecycle events */
+export interface IElementRegistryCallbacks {
+    onRegister?: (id: string, el: HTMLElement) => void;
+    onUnregister?: (id: string) => void;
+}
+/** API for capturing element positions and calculating FLIP deltas */
+export interface IPositionCaptureAPI {
+    capture: (excludeIds?: Set<string>) => Map<string, DOMRect>;
+    getPosition: (id: string) => DOMRect | undefined;
+    calculateDeltas: (before: Map<string, DOMRect>, after: Map<string, DOMRect>) => Map<string, IFLIPDelta>;
+    getLastCapture: () => Map<string, DOMRect>;
+    clear: () => void;
+}
+/** Options for position capture behavior */
+export interface IPositionCaptureOptions {
+    minDeltaPx?: number;
+}
+/** Options for individual FLIP animations */
+export interface IFLIPAnimationOptions {
+    duration?: number;
+    easing?: string;
+    onStart?: (id: string) => void;
+    onComplete?: (id: string) => void;
+}
+/** API for executing FLIP animations */
+export interface IFLIPAnimationAPI {
+    animate: (element: HTMLElement, delta: IFLIPDelta, options?: IFLIPAnimationOptions) => Animation;
+    animateAll: (elements: Map<string, HTMLElement>, deltas: Map<string, IFLIPDelta>, options?: IFLIPAnimationOptions) => Promise<void>;
+    cancel: (id: string) => void;
+    cancelAll: () => void;
+    isAnimating: (id?: string) => boolean;
+}
+/** Options for exit animations */
+export interface IExitOptions {
+    duration?: number;
+    easing?: string;
+    collapseWidth?: boolean;
+    additionalIds?: string[];
+    onComplete?: () => void;
+}
+/** Options for enter animations */
+export interface IEnterOptions {
+    duration?: number;
+    easing?: string;
+    stagger?: number;
+    onComplete?: () => void;
+}
+/**
+ * Controls which elements animate when an item exits.
+ * - `'all'`: All remaining elements animate to fill the gap (default)
+ * - `'siblings-after'`: Only elements after the exiting one animate
+ * - `'none'`: No FLIP animation, item exits in-place
+ */
+export type FLIPBehavior = 'all' | 'siblings-after' | 'none';
+/**
+ * Controls how the exiting element is positioned during exit animation.
+ * - `'absolute-fixed'`: Position absolute with fixed coordinates (default)
+ * - `'in-place'`: Stay in flow, no position change
+ * - `'custom'`: Consumer handles positioning via CSS/callbacks
+ */
+export type ExitPositionStrategy = 'absolute-fixed' | 'in-place' | 'custom';
+/** Configuration for the animation orchestrator */
+export interface IAnimationOrchestratorConfig {
+    exitDuration?: number;
+    flipDuration?: number;
+    enterDuration?: number;
+    exitEasing?: string;
+    flipEasing?: string;
+    enterEasing?: string;
+    flipBehavior?: FLIPBehavior;
+    exitPositionStrategy?: ExitPositionStrategy;
+    minDeltaPx?: number;
+    onExitComplete?: (id: string) => void;
+    onEnterComplete?: (id: string) => void;
+}
+/** Full API surface of the animation orchestrator */
+export interface IAnimationOrchestratorAPI {
+    registry: IElementRegistryAPI;
+    positions: IPositionCaptureAPI;
+    flip: IFLIPAnimationAPI;
+    registerElement: (id: string, el: HTMLElement | null) => void;
+    startExit: (id: string, options?: IExitOptions) => Promise<void>;
+    startEnter: (id: string, options?: IEnterOptions) => Promise<void>;
+    isAnimating: (id?: string) => boolean;
+    cancelAnimation: (id: string) => void;
+    cancelAllAnimations: () => void;
+    capturePositions: (excludeIds?: Set<string>) => Map<string, DOMRect>;
+}
+/** Internal state tracked by the orchestrator */
+export interface IOrchestratorState {
+    animatingIds: Set<string>;
+    positions: Map<string, DOMRect>;
+    activeAnimations: Map<string, Animation[]>;
+}
+/** Phase of an animation lifecycle */
+export type AnimationPhase = 'idle' | 'exit' | 'flip' | 'enter' | 'completed';
+/** Animation event emitted during orchestration */
+export interface IAnimationEvent {
+    id: string;
+    phase: AnimationPhase;
+    timestamp: number;
+    duration?: number;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/react-ui/primitives/waapi/core/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../../src/react-ui/primitives/waapi/core/types.ts"],"names":[],"mappings":"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"}

package/dist/react-ui/primitives/waapi/core/useAnimationOrchestrator.d.ts

@@ -0,0 +1,32 @@
+import type { IAnimationOrchestratorAPI, IAnimationOrchestratorConfig } from './types';
+/**
+ * Main animation orchestrator hook.
+ * Composes useElementRegistry, usePositionCapture, and useFLIPAnimation
+ * into a full FLIP exit/enter pipeline.
+ *
+ * Handles the full exit animation sequence:
+ * 1. Capture positions of remaining elements (FIRST)
+ * 2. Apply position:absolute to exiting element
+ * 3. Force synchronous reflow
+ * 4. Capture AFTER positions (LAST)
+ * 5. Calculate INVERT deltas and PLAY FLIP animations
+ * 6. Run exit animation (per-token stagger or whole-element)
+ * 7. Wait for all animations to complete
+ * 8. Cleanup and notify completion
+ *
+ * @param config - Optional orchestrator configuration
+ * @returns Full orchestrator API
+ *
+ * @example
+ * ```tsx
+ * const orchestrator = useAnimationOrchestrator({
+ *   onExitComplete: (id) => removeFromList(id)
+ * });
+ *
+ * <div ref={el => orchestrator.registerElement('item-1', el)} />
+ *
+ * await orchestrator.startExit('item-1');
+ * ```
+ */
+export declare function useAnimationOrchestrator(config?: IAnimationOrchestratorConfig): IAnimationOrchestratorAPI;
+//# sourceMappingURL=useAnimationOrchestrator.d.ts.map

package/dist/react-ui/primitives/waapi/core/useAnimationOrchestrator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useAnimationOrchestrator.d.ts","sourceRoot":"","sources":["../../../../../src/react-ui/primitives/waapi/core/useAnimationOrchestrator.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EACV,yBAAyB,EACzB,4BAA4B,EAI7B,MAAM,SAAS,CAAC;AAEjB;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,wBAAgB,wBAAwB,CACtC,MAAM,CAAC,EAAE,4BAA4B,GACpC,yBAAyB,CAgY3B"}