@flightdev/transitions 0.2.0

package/dist/chunk-ZI6E7GNQ.js

@@ -0,0 +1,136 @@
+import { flip } from './chunk-OV3U5STU.js';
+
+// src/layout/layout-transition.ts
+var layoutTransitionConfigs = /* @__PURE__ */ new Map();
+function defineLayoutTransition(layoutId, config) {
+  layoutTransitionConfigs.set(layoutId, config);
+}
+function getLayoutTransition(layoutId) {
+  return layoutTransitionConfigs.get(layoutId);
+}
+function clearLayoutTransitions() {
+  layoutTransitionConfigs.clear();
+}
+var sharedElementRegistry = /* @__PURE__ */ new Map();
+function registerSharedElement(name, element) {
+  sharedElementRegistry.set(name, element);
+  element.style.viewTransitionName = name;
+}
+function unregisterSharedElement(name) {
+  const element = sharedElementRegistry.get(name);
+  if (element) {
+    element.style.viewTransitionName = "";
+  }
+  sharedElementRegistry.delete(name);
+}
+function getSharedElement(name) {
+  return sharedElementRegistry.get(name);
+}
+function clearSharedElements() {
+  sharedElementRegistry.forEach((element) => {
+    element.style.viewTransitionName = "";
+  });
+  sharedElementRegistry.clear();
+}
+function getSharedElementNames() {
+  return Array.from(sharedElementRegistry.keys());
+}
+async function animateSharedElement(options) {
+  const { name, duration = 300, easing, onComplete } = options;
+  const element = sharedElementRegistry.get(name);
+  if (!element) {
+    console.warn(`[Flight Transitions] Shared element "${name}" not found`);
+    return;
+  }
+  await new Promise((resolve) => {
+    flip(element, () => {
+    }, {
+      duration,
+      easing,
+      onComplete: () => {
+        onComplete?.();
+        resolve();
+      }
+    });
+  });
+}
+var persistentLayouts = /* @__PURE__ */ new Set();
+function markLayoutPersistent(layoutId) {
+  persistentLayouts.add(layoutId);
+}
+function isLayoutPersistent(layoutId) {
+  return persistentLayouts.has(layoutId);
+}
+function clearPersistentLayouts() {
+  persistentLayouts.clear();
+}
+async function executeLayoutTransition(fromLayoutId, toLayoutId, updateDOM) {
+  const toConfig = layoutTransitionConfigs.get(toLayoutId);
+  if (fromLayoutId === toLayoutId && toConfig?.persist) {
+    await updateDOM();
+    return;
+  }
+  if (toConfig?.sharedElements) {
+    for (const config of toConfig.sharedElements) {
+      const element = sharedElementRegistry.get(config.name);
+      if (element) {
+        element.style.viewTransitionName = config.name;
+      }
+    }
+  }
+  await updateDOM();
+}
+function autoRegisterSharedElements() {
+  if (typeof document === "undefined") return;
+  const elements = document.querySelectorAll("[data-transition-name]");
+  elements.forEach((el) => {
+    if (el instanceof HTMLElement) {
+      const name = el.dataset.transitionName;
+      if (name) {
+        registerSharedElement(name, el);
+      }
+    }
+  });
+}
+function setupSharedElementObserver() {
+  if (typeof document === "undefined") return () => {
+  };
+  const observer = new MutationObserver((mutations) => {
+    for (const mutation of mutations) {
+      mutation.addedNodes.forEach((node) => {
+        if (node instanceof HTMLElement) {
+          const name = node.dataset?.transitionName;
+          if (name) {
+            registerSharedElement(name, node);
+          }
+          const children = node.querySelectorAll("[data-transition-name]");
+          children.forEach((child) => {
+            if (child instanceof HTMLElement) {
+              const childName = child.dataset.transitionName;
+              if (childName) {
+                registerSharedElement(childName, child);
+              }
+            }
+          });
+        }
+      });
+      mutation.removedNodes.forEach((node) => {
+        if (node instanceof HTMLElement) {
+          const name = node.dataset?.transitionName;
+          if (name) {
+            unregisterSharedElement(name);
+          }
+        }
+      });
+    }
+  });
+  observer.observe(document.body, {
+    childList: true,
+    subtree: true
+  });
+  return () => observer.disconnect();
+}
+
+export { animateSharedElement, autoRegisterSharedElements, clearLayoutTransitions, clearPersistentLayouts, clearSharedElements, defineLayoutTransition, executeLayoutTransition, getLayoutTransition, getSharedElement, getSharedElementNames, isLayoutPersistent, markLayoutPersistent, registerSharedElement, setupSharedElementObserver, unregisterSharedElement };
+//# sourceMappingURL=chunk-ZI6E7GNQ.js.map
+//# sourceMappingURL=chunk-ZI6E7GNQ.js.map

package/dist/chunk-ZI6E7GNQ.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/layout/layout-transition.ts"],"names":[],"mappings":"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","file":"chunk-ZI6E7GNQ.js","sourcesContent":["/**\r\n * @flightdev/transitions - Layout Transitions\r\n * \r\n * Layout-level transitions for persistent UI elements across navigations.\r\n */\r\n\r\nimport type {\r\n    LayoutTransitionConfig,\r\n    SharedElementConfig,\r\n    ResolvedTransition,\r\n} from '../core/types';\r\nimport { flip } from '../core/animation-engine';\r\n\r\n// =============================================================================\r\n// LAYOUT TRANSITION CONFIG\r\n// =============================================================================\r\n\r\n/** Storage for layout-specific transition configurations */\r\nconst layoutTransitionConfigs = new Map<string, LayoutTransitionConfig>();\r\n\r\n/**\r\n * Define transition configuration for a layout\r\n * \r\n * @example\r\n * ```tsx\r\n * // In a layout component\r\n * defineLayoutTransition({\r\n *   default: 'fade',\r\n *   persist: true, // Layout persists during page transitions\r\n *   sharedElements: [\r\n *     { name: 'header', animation: 'none' },\r\n *     { name: 'sidebar', animation: 'none' },\r\n *   ],\r\n * });\r\n * ```\r\n */\r\nexport function defineLayoutTransition(\r\n    layoutId: string,\r\n    config: LayoutTransitionConfig\r\n): void {\r\n    layoutTransitionConfigs.set(layoutId, config);\r\n}\r\n\r\n/**\r\n * Get the transition configuration for a layout\r\n */\r\nexport function getLayoutTransition(\r\n    layoutId: string\r\n): LayoutTransitionConfig | undefined {\r\n    return layoutTransitionConfigs.get(layoutId);\r\n}\r\n\r\n/**\r\n * Clear all layout transition configurations\r\n */\r\nexport function clearLayoutTransitions(): void {\r\n    layoutTransitionConfigs.clear();\r\n}\r\n\r\n// =============================================================================\r\n// SHARED ELEMENT TRANSITIONS\r\n// =============================================================================\r\n\r\n/** Registry of shared elements on the current page */\r\nconst sharedElementRegistry = new Map<string, HTMLElement>();\r\n\r\n/**\r\n * Register a shared element for transition\r\n * \r\n * @example\r\n * ```typescript\r\n * // Register an element\r\n * registerSharedElement('hero-image', document.getElementById('hero'));\r\n * \r\n * // On navigation, elements with matching names will animate between positions\r\n * ```\r\n */\r\nexport function registerSharedElement(name: string, element: HTMLElement): void {\r\n    sharedElementRegistry.set(name, element);\r\n\r\n    // Set the view-transition-name CSS property\r\n    element.style.viewTransitionName = name;\r\n}\r\n\r\n/**\r\n * Unregister a shared element\r\n */\r\nexport function unregisterSharedElement(name: string): void {\r\n    const element = sharedElementRegistry.get(name);\r\n    if (element) {\r\n        element.style.viewTransitionName = '';\r\n    }\r\n    sharedElementRegistry.delete(name);\r\n}\r\n\r\n/**\r\n * Get a registered shared element\r\n */\r\nexport function getSharedElement(name: string): HTMLElement | undefined {\r\n    return sharedElementRegistry.get(name);\r\n}\r\n\r\n/**\r\n * Clear all shared elements\r\n */\r\nexport function clearSharedElements(): void {\r\n    sharedElementRegistry.forEach((element) => {\r\n        element.style.viewTransitionName = '';\r\n    });\r\n    sharedElementRegistry.clear();\r\n}\r\n\r\n/**\r\n * Get all registered shared element names\r\n */\r\nexport function getSharedElementNames(): string[] {\r\n    return Array.from(sharedElementRegistry.keys());\r\n}\r\n\r\n// =============================================================================\r\n// SHARED ELEMENT ANIMATION\r\n// =============================================================================\r\n\r\n/**\r\n * Options for shared element transition\r\n */\r\nexport interface SharedElementTransitionOptions {\r\n    /** Name of the shared element */\r\n    name: string;\r\n    /** Duration of the animation */\r\n    duration?: number;\r\n    /** Easing function */\r\n    easing?: string;\r\n    /** Callback when animation completes */\r\n    onComplete?: () => void;\r\n}\r\n\r\n/**\r\n * Animate a shared element between two states using FLIP\r\n * \r\n * This manually implements shared element transitions for browsers\r\n * that don't support the View Transitions API.\r\n */\r\nexport async function animateSharedElement(\r\n    options: SharedElementTransitionOptions\r\n): Promise<void> {\r\n    const { name, duration = 300, easing, onComplete } = options;\r\n    const element = sharedElementRegistry.get(name);\r\n\r\n    if (!element) {\r\n        console.warn(`[Flight Transitions] Shared element \"${name}\" not found`);\r\n        return;\r\n    }\r\n\r\n    // Use FLIP animation\r\n    await new Promise<void>((resolve) => {\r\n        const handle = flip(element, () => {\r\n            // This would be called after DOM update\r\n        }, {\r\n            duration,\r\n            easing,\r\n            onComplete: () => {\r\n                onComplete?.();\r\n                resolve();\r\n            },\r\n        });\r\n    });\r\n}\r\n\r\n// =============================================================================\r\n// LAYOUT PERSISTENCE\r\n// =============================================================================\r\n\r\n/**\r\n * Track which layouts should persist during transitions\r\n */\r\nconst persistentLayouts = new Set<string>();\r\n\r\n/**\r\n * Mark a layout as persistent (it won't transition)\r\n */\r\nexport function markLayoutPersistent(layoutId: string): void {\r\n    persistentLayouts.add(layoutId);\r\n}\r\n\r\n/**\r\n * Check if a layout is persistent\r\n */\r\nexport function isLayoutPersistent(layoutId: string): boolean {\r\n    return persistentLayouts.has(layoutId);\r\n}\r\n\r\n/**\r\n * Clear persistent layout tracking\r\n */\r\nexport function clearPersistentLayouts(): void {\r\n    persistentLayouts.clear();\r\n}\r\n\r\n// =============================================================================\r\n// LAYOUT TRANSITION EXECUTION\r\n// =============================================================================\r\n\r\n/**\r\n * Execute a layout transition\r\n * \r\n * Unlike page transitions, layout transitions are more subtle and\r\n * typically involve animating specific sections while preserving others.\r\n */\r\nexport async function executeLayoutTransition(\r\n    fromLayoutId: string | null,\r\n    toLayoutId: string,\r\n    updateDOM: () => void | Promise<void>\r\n): Promise<void> {\r\n    const toConfig = layoutTransitionConfigs.get(toLayoutId);\r\n\r\n    // If layout is persistent and same, no transition needed\r\n    if (fromLayoutId === toLayoutId && toConfig?.persist) {\r\n        await updateDOM();\r\n        return;\r\n    }\r\n\r\n    // Configure shared elements if specified\r\n    if (toConfig?.sharedElements) {\r\n        for (const config of toConfig.sharedElements) {\r\n            const element = sharedElementRegistry.get(config.name);\r\n            if (element) {\r\n                element.style.viewTransitionName = config.name;\r\n            }\r\n        }\r\n    }\r\n\r\n    // Execute the DOM update\r\n    await updateDOM();\r\n}\r\n\r\n// =============================================================================\r\n// AUTO-DETECTION OF SHARED ELEMENTS\r\n// =============================================================================\r\n\r\n/**\r\n * Automatically find and register shared elements based on data attributes\r\n * \r\n * Elements with `data-transition-name` or `transition:name` will be registered.\r\n */\r\nexport function autoRegisterSharedElements(): void {\r\n    if (typeof document === 'undefined') return;\r\n\r\n    // Find elements with data-transition-name\r\n    const elements = document.querySelectorAll('[data-transition-name]');\r\n\r\n    elements.forEach((el) => {\r\n        if (el instanceof HTMLElement) {\r\n            const name = el.dataset.transitionName;\r\n            if (name) {\r\n                registerSharedElement(name, el);\r\n            }\r\n        }\r\n    });\r\n}\r\n\r\n/**\r\n * Set up a MutationObserver to auto-register shared elements\r\n */\r\nexport function setupSharedElementObserver(): () => void {\r\n    if (typeof document === 'undefined') return () => { };\r\n\r\n    const observer = new MutationObserver((mutations) => {\r\n        for (const mutation of mutations) {\r\n            // Check added nodes\r\n            mutation.addedNodes.forEach((node) => {\r\n                if (node instanceof HTMLElement) {\r\n                    // Check the node itself\r\n                    const name = node.dataset?.transitionName;\r\n                    if (name) {\r\n                        registerSharedElement(name, node);\r\n                    }\r\n\r\n                    // Check children\r\n                    const children = node.querySelectorAll('[data-transition-name]');\r\n                    children.forEach((child) => {\r\n                        if (child instanceof HTMLElement) {\r\n                            const childName = child.dataset.transitionName;\r\n                            if (childName) {\r\n                                registerSharedElement(childName, child);\r\n                            }\r\n                        }\r\n                    });\r\n                }\r\n            });\r\n\r\n            // Check removed nodes\r\n            mutation.removedNodes.forEach((node) => {\r\n                if (node instanceof HTMLElement) {\r\n                    const name = node.dataset?.transitionName;\r\n                    if (name) {\r\n                        unregisterSharedElement(name);\r\n                    }\r\n                }\r\n            });\r\n        }\r\n    });\r\n\r\n    observer.observe(document.body, {\r\n        childList: true,\r\n        subtree: true,\r\n    });\r\n\r\n    return () => observer.disconnect();\r\n}\r\n"]}

package/dist/component/index.d.ts

@@ -0,0 +1,87 @@
+import { T as TransitionPreset, C as CustomTransition } from '../types-BA4L37s4.js';
+
+/**
+ * @flightdev/transitions - Component Transitions
+ *
+ * Component-level transitions for enter/leave animations.
+ * Framework-agnostic primitives that adapters build upon.
+ */
+
+/**
+ * Creates a presence controller for managing enter/exit animations
+ *
+ * @example
+ * ```typescript
+ * const presence = createPresence(element, {
+ *   type: 'fade',
+ *   onComplete: () => element.remove(),
+ * });
+ *
+ * // Show
+ * await presence.enter();
+ *
+ * // Hide
+ * await presence.exit();
+ * ```
+ */
+declare function createPresence(element: HTMLElement, options?: PresenceOptions): PresenceController;
+interface PresenceOptions {
+    type?: TransitionPreset | CustomTransition;
+    duration?: number;
+    appear?: boolean;
+    onEnterStart?: () => void;
+    onEnterComplete?: () => void;
+    onExitStart?: () => void;
+    onExitComplete?: () => void;
+}
+interface PresenceController {
+    readonly isPresent: boolean;
+    enter(): Promise<void>;
+    exit(): Promise<void>;
+    cancel(): void;
+}
+/**
+ * Creates a transition group controller for list animations
+ *
+ * @example
+ * ```typescript
+ * const group = createTransitionGroup(containerElement, {
+ *   type: 'fade',
+ *   stagger: 50,
+ * });
+ *
+ * // Animate items entering
+ * group.addItems([item1, item2, item3]);
+ *
+ * // Animate items leaving
+ * group.removeItems([item2]);
+ * ```
+ */
+declare function createTransitionGroup(container: HTMLElement, options?: TransitionGroupOptions): TransitionGroupController;
+interface TransitionGroupOptions {
+    type?: TransitionPreset | CustomTransition;
+    stagger?: number;
+    appear?: boolean;
+}
+interface TransitionGroupController {
+    readonly items: HTMLElement[];
+    addItems(items: HTMLElement[]): Promise<void>;
+    removeItems(items: HTMLElement[]): Promise<void>;
+    reorderItems(newOrder: HTMLElement[], animate?: boolean): Promise<void>;
+}
+/**
+ * Simple visibility toggle with transition
+ */
+declare function toggleVisibility(element: HTMLElement, show: boolean, options?: {
+    type?: TransitionPreset | CustomTransition;
+    duration?: number;
+}): Promise<void>;
+/**
+ * Transition between two elements (one out, one in)
+ */
+declare function crossfade(outElement: HTMLElement, inElement: HTMLElement, options?: {
+    type?: TransitionPreset | CustomTransition;
+    mode?: 'in-out' | 'out-in' | 'simultaneous';
+}): Promise<void>;
+
+export { type PresenceController, type PresenceOptions, type TransitionGroupController, type TransitionGroupOptions, createPresence, createTransitionGroup, crossfade, toggleVisibility };

package/dist/component/index.js

@@ -0,0 +1,5 @@
+export { createPresence, createTransitionGroup, crossfade, toggleVisibility } from '../chunk-GEYKSLH6.js';
+import '../chunk-QSB65CTV.js';
+import '../chunk-OV3U5STU.js';
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/component/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"index.js"}

package/dist/config/index.d.ts

@@ -0,0 +1,93 @@
+import { i as TransitionsConfig, T as TransitionPreset, C as CustomTransition } from '../types-BA4L37s4.js';
+
+/**
+ * @flightdev/transitions - Configuration Module
+ *
+ * Configuration helpers and defaults for the transitions system.
+ */
+
+/**
+ * Default transitions configuration
+ */
+declare const defaultConfig: TransitionsConfig;
+/**
+ * Define transitions configuration
+ *
+ * Use this in flight.config.ts to configure transitions globally.
+ *
+ * @example
+ * ```typescript
+ * // flight.config.ts
+ * import { defineConfig } from '@flightdev/core';
+ * import { defineTransitionsConfig } from '@flightdev/transitions/config';
+ *
+ * export default defineConfig({
+ *   transitions: defineTransitionsConfig({
+ *     pageTransition: 'slide-left',
+ *     duration: 300,
+ *   }),
+ * });
+ * ```
+ */
+declare function defineTransitionsConfig(config: Partial<TransitionsConfig>): TransitionsConfig;
+/**
+ * Initialize the transitions system with configuration
+ *
+ * Call this during app initialization to set up transitions.
+ *
+ * @example
+ * ```typescript
+ * import { initializeTransitions } from '@flightdev/transitions/config';
+ *
+ * initializeTransitions({
+ *   pageTransition: 'fade',
+ *   reduceMotion: 'respect-system',
+ * });
+ * ```
+ */
+declare function initializeTransitions(config?: Partial<TransitionsConfig>): void;
+/**
+ * Update transitions configuration at runtime
+ *
+ * @example
+ * ```typescript
+ * // Disable transitions
+ * updateTransitionsConfig({ enabled: false });
+ *
+ * // Change default transition
+ * updateTransitionsConfig({ pageTransition: 'slide-left' });
+ * ```
+ */
+declare function updateTransitionsConfig(config: Partial<TransitionsConfig>): void;
+/**
+ * Get the current transitions configuration
+ */
+declare function getTransitionsConfig(): TransitionsConfig;
+/**
+ * Check if a value is a valid transition preset name
+ */
+declare function isTransitionPreset(value: unknown): value is TransitionPreset;
+/**
+ * Check if a value is a custom transition definition
+ */
+declare function isCustomTransition(value: unknown): value is CustomTransition;
+/**
+ * Check if the current environment supports transitions
+ */
+declare function isTransitionsSupported(): boolean;
+/**
+ * Get browser capability information
+ */
+declare function getCapabilities(): TransitionCapabilities;
+interface TransitionCapabilities {
+    /** Browser supports View Transitions API */
+    viewTransitionsApi: boolean;
+    /** Browser supports Web Animations API */
+    webAnimationsApi: boolean;
+    /** Browser supports CSS view-transition-name */
+    cssViewTransitions: boolean;
+    /** User prefers reduced motion */
+    reducedMotion: boolean;
+}
+
+export { type TransitionCapabilities, defaultConfig, defineTransitionsConfig, getCapabilities, getTransitionsConfig, initializeTransitions, isCustomTransition, isTransitionPreset, isTransitionsSupported, updateTransitionsConfig };

package/dist/config/index.js

@@ -0,0 +1,5 @@
+export { defaultConfig, defineTransitionsConfig, getCapabilities, getTransitionsConfig, initializeTransitions, isCustomTransition, isTransitionPreset, isTransitionsSupported, updateTransitionsConfig } from '../chunk-N7U5LD4Z.js';
+import '../chunk-X2A7XWYR.js';
+import '../chunk-OV3U5STU.js';
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/config/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"index.js"}

package/dist/core/index.d.ts

@@ -0,0 +1,107 @@
+import { d as TransitionKeyframe, F as FillMode, R as ResolvedTransition, T as TransitionPreset, C as CustomTransition } from '../types-BA4L37s4.js';
+export { A as AnimatableProperty, L as LayoutTransitionConfig, m as LinkWithTransitionProps, N as NavigateWithTransitionOptions, P as PageTransitionConfig, e as ReduceMotionBehavior, S as SharedElementConfig, f as TransitionContext, c as TransitionDirection, h as TransitionGroupProps, l as TransitionInput, k as TransitionListener, g as TransitionProps, j as TransitionState, i as TransitionsConfig, V as ViewTransition, a as ViewTransitionOptions, b as ViewTransitionResult } from '../types-BA4L37s4.js';
+export { C as CrossDocumentTransitionOptions, e as enableCrossDocumentTransitions, a as isCrossDocumentTransitionSupported, i as isViewTransitionSupported, s as startViewTransition } from '../view-transition-LSN_PSbm.js';
+export { T as TransitionManager, c as createTransitionManager, g as getTransitionManager, i as initTransitions } from '../transition-manager-QWm4OSFw.js';
+
+/**
+ * @flightdev/transitions - Animation Engine
+ *
+ * Low-level animation primitives using the Web Animations API.
+ * Provides performant, interruptible animations with proper cleanup.
+ */
+
+/** Default animation duration in milliseconds */
+declare const DEFAULT_DURATION = 200;
+/** Default easing function */
+declare const DEFAULT_EASING = "cubic-bezier(0.4, 0, 0.2, 1)";
+/** Reduced motion duration (near-instant) */
+declare const REDUCED_MOTION_DURATION = 1;
+/**
+ * Options for creating an animation
+ */
+interface AnimationOptions {
+    /** Animation duration in milliseconds */
+    duration?: number;
+    /** CSS easing function */
+    easing?: string;
+    /** Delay before animation starts */
+    delay?: number;
+    /** Animation fill mode */
+    fill?: FillMode;
+    /** Callback when animation starts */
+    onStart?: () => void;
+    /** Callback when animation completes */
+    onComplete?: () => void;
+    /** Callback when animation is cancelled */
+    onCancel?: () => void;
+}
+/**
+ * Result from creating an animation
+ */
+interface AnimationHandle {
+    /** The underlying Animation object */
+    animation: Animation;
+    /** Promise that resolves when animation finishes */
+    finished: Promise<void>;
+    /** Cancel the animation */
+    cancel(): void;
+    /** Pause the animation */
+    pause(): void;
+    /** Resume a paused animation */
+    resume(): void;
+    /** Reverse the animation direction */
+    reverse(): void;
+    /** Set the current time (0-1 normalized) */
+    seek(progress: number): void;
+}
+/**
+ * Animate an element with keyframes
+ *
+ * Uses the Web Animations API for smooth, performant animations.
+ *
+ * @example
+ * ```typescript
+ * const handle = animate(element, {
+ *   from: { opacity: '1', transform: 'scale(1)' },
+ *   to: { opacity: '0', transform: 'scale(0.95)' }
+ * }, { duration: 200 });
+ *
+ * await handle.finished;
+ * ```
+ */
+declare function animate(element: Element, keyframe: TransitionKeyframe, options?: AnimationOptions): AnimationHandle;
+/**
+ * Animate an element out (leaving)
+ */
+declare function animateOut(element: Element, transition: ResolvedTransition, options?: Omit<AnimationOptions, 'duration' | 'easing'>): AnimationHandle;
+/**
+ * Animate an element in (entering)
+ */
+declare function animateIn(element: Element, transition: ResolvedTransition, options?: Omit<AnimationOptions, 'duration' | 'easing'>): AnimationHandle;
+/**
+ * Resolve a preset name or custom transition to a normalized format
+ */
+declare function resolveTransition(input: TransitionPreset | CustomTransition | false, reducedMotion?: boolean): ResolvedTransition | null;
+/**
+ * Check if user prefers reduced motion
+ */
+declare function prefersReducedMotion(): boolean;
+/**
+ * Subscribe to reduced motion preference changes
+ */
+declare function onReducedMotionChange(callback: (prefersReduced: boolean) => void): () => void;
+/**
+ * Cancel all running animations on an element
+ */
+declare function cancelAnimations(element: Element): void;
+/**
+ * Wait for all animations on an element to complete
+ */
+declare function waitForAnimations(element: Element): Promise<void>;
+/**
+ * FLIP animation helper (First, Last, Invert, Play)
+ * Useful for shared element transitions
+ */
+declare function flip(element: HTMLElement, callback: () => void | Promise<void>, options?: AnimationOptions): AnimationHandle;
+
+export { type AnimationHandle, type AnimationOptions, CustomTransition, DEFAULT_DURATION, DEFAULT_EASING, FillMode, REDUCED_MOTION_DURATION, ResolvedTransition, TransitionKeyframe, TransitionPreset, animate, animateIn, animateOut, cancelAnimations, flip, onReducedMotionChange, prefersReducedMotion, resolveTransition, waitForAnimations };

package/dist/core/index.js

@@ -0,0 +1,5 @@
+import '../chunk-W7HSR35B.js';
+export { createTransitionManager, enableCrossDocumentTransitions, getTransitionManager, initTransitions, isCrossDocumentTransitionSupported, isViewTransitionSupported, startViewTransition } from '../chunk-X2A7XWYR.js';
+export { DEFAULT_DURATION, DEFAULT_EASING, REDUCED_MOTION_DURATION, animate, animateIn, animateOut, cancelAnimations, flip, onReducedMotionChange, prefersReducedMotion, resolveTransition, waitForAnimations } from '../chunk-OV3U5STU.js';
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/core/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"index.js"}

package/dist/index.d.ts

@@ -0,0 +1,10 @@
+export { C as CustomTransition, L as LayoutTransitionConfig, P as PageTransitionConfig, e as ReduceMotionBehavior, R as ResolvedTransition, S as SharedElementConfig, f as TransitionContext, c as TransitionDirection, h as TransitionGroupProps, d as TransitionKeyframe, k as TransitionListener, T as TransitionPreset, g as TransitionProps, j as TransitionState, i as TransitionsConfig, V as ViewTransition, a as ViewTransitionOptions, b as ViewTransitionResult } from './types-BA4L37s4.js';
+export { e as enableCrossDocumentTransitions, a as isCrossDocumentTransitionSupported, i as isViewTransitionSupported, s as startViewTransition } from './view-transition-LSN_PSbm.js';
+export { DEFAULT_DURATION, DEFAULT_EASING, animate, animateIn, animateOut, cancelAnimations, flip, onReducedMotionChange, prefersReducedMotion, resolveTransition, waitForAnimations } from './core/index.js';
+export { c as createTransitionManager, g as getTransitionManager, i as initTransitions } from './transition-manager-QWm4OSFw.js';
+export { definePageTransition, executePageTransition, getPageTransition, onAfterPageEnter, onAfterPageLeave, onBeforePageEnter, onBeforePageLeave } from './page/index.js';
+export { animateSharedElement, autoRegisterSharedElements, defineLayoutTransition, getSharedElement, registerSharedElement, setupSharedElementObserver, unregisterSharedElement } from './layout/index.js';
+export { createPresence, createTransitionGroup, crossfade, toggleVisibility } from './component/index.js';
+export { circleReveal, expand, fade, fadeBlur, fadeFast, fadeScale, fadeSlow, flipX, flipY, getPreset, getPresetNames, isPresetName, morph, none, pop, presetMap, rotate, scale, scaleDown, scaleFade, scaleUp, slideDown, slideFade, slideLeft, slideRight, slideScale, slideUp, wipeLeft, wipeUp } from './presets/index.js';
+export { defaultConfig, defineTransitionsConfig, getCapabilities, getTransitionsConfig, initializeTransitions, isTransitionsSupported, updateTransitionsConfig } from './config/index.js';
+export { navigateWithTransition, prefetchRoute, registerRouteTransitions, setupHistoryTransitions } from './router/index.js';

package/dist/index.js

@@ -0,0 +1,11 @@
+export { navigateWithTransition, prefetchRoute, registerRouteTransitions, setupHistoryTransitions } from './chunk-DZC3OLDU.js';
+export { defaultConfig, defineTransitionsConfig, getCapabilities, getTransitionsConfig, initializeTransitions, isTransitionsSupported, updateTransitionsConfig } from './chunk-N7U5LD4Z.js';
+export { createPresence, createTransitionGroup, crossfade, toggleVisibility } from './chunk-GEYKSLH6.js';
+import './chunk-XLVYHPII.js';
+export { definePageTransition, executePageTransition, getPageTransition, onAfterPageEnter, onAfterPageLeave, onBeforePageEnter, onBeforePageLeave } from './chunk-SPUGO5I5.js';
+export { animateSharedElement, autoRegisterSharedElements, defineLayoutTransition, getSharedElement, registerSharedElement, setupSharedElementObserver, unregisterSharedElement } from './chunk-ZI6E7GNQ.js';
+export { circleReveal, expand, fade, fadeBlur, fadeFast, fadeScale, fadeSlow, flipX, flipY, getPreset, getPresetNames, isPresetName, morph, none, pop, presetMap, rotate, scale, scaleDown, scaleFade, scaleUp, slideDown, slideFade, slideLeft, slideRight, slideScale, slideUp, wipeLeft, wipeUp } from './chunk-QSB65CTV.js';
+export { createTransitionManager, enableCrossDocumentTransitions, getTransitionManager, initTransitions, isCrossDocumentTransitionSupported, isViewTransitionSupported, startViewTransition } from './chunk-X2A7XWYR.js';
+export { DEFAULT_DURATION, DEFAULT_EASING, animate, animateIn, animateOut, cancelAnimations, flip, onReducedMotionChange, prefersReducedMotion, resolveTransition, waitForAnimations } from './chunk-OV3U5STU.js';
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"index.js"}

package/dist/layout/index.d.ts

@@ -0,0 +1,112 @@
+import { L as LayoutTransitionConfig } from '../types-BA4L37s4.js';
+
+/**
+ * @flightdev/transitions - Layout Transitions
+ *
+ * Layout-level transitions for persistent UI elements across navigations.
+ */
+
+/**
+ * Define transition configuration for a layout
+ *
+ * @example
+ * ```tsx
+ * // In a layout component
+ * defineLayoutTransition({
+ *   default: 'fade',
+ *   persist: true, // Layout persists during page transitions
+ *   sharedElements: [
+ *     { name: 'header', animation: 'none' },
+ *     { name: 'sidebar', animation: 'none' },
+ *   ],
+ * });
+ * ```
+ */
+declare function defineLayoutTransition(layoutId: string, config: LayoutTransitionConfig): void;
+/**
+ * Get the transition configuration for a layout
+ */
+declare function getLayoutTransition(layoutId: string): LayoutTransitionConfig | undefined;
+/**
+ * Clear all layout transition configurations
+ */
+declare function clearLayoutTransitions(): void;
+/**
+ * Register a shared element for transition
+ *
+ * @example
+ * ```typescript
+ * // Register an element
+ * registerSharedElement('hero-image', document.getElementById('hero'));
+ *
+ * // On navigation, elements with matching names will animate between positions
+ * ```
+ */
+declare function registerSharedElement(name: string, element: HTMLElement): void;
+/**
+ * Unregister a shared element
+ */
+declare function unregisterSharedElement(name: string): void;
+/**
+ * Get a registered shared element
+ */
+declare function getSharedElement(name: string): HTMLElement | undefined;
+/**
+ * Clear all shared elements
+ */
+declare function clearSharedElements(): void;
+/**
+ * Get all registered shared element names
+ */
+declare function getSharedElementNames(): string[];
+/**
+ * Options for shared element transition
+ */
+interface SharedElementTransitionOptions {
+    /** Name of the shared element */
+    name: string;
+    /** Duration of the animation */
+    duration?: number;
+    /** Easing function */
+    easing?: string;
+    /** Callback when animation completes */
+    onComplete?: () => void;
+}
+/**
+ * Animate a shared element between two states using FLIP
+ *
+ * This manually implements shared element transitions for browsers
+ * that don't support the View Transitions API.
+ */
+declare function animateSharedElement(options: SharedElementTransitionOptions): Promise<void>;
+/**
+ * Mark a layout as persistent (it won't transition)
+ */
+declare function markLayoutPersistent(layoutId: string): void;
+/**
+ * Check if a layout is persistent
+ */
+declare function isLayoutPersistent(layoutId: string): boolean;
+/**
+ * Clear persistent layout tracking
+ */
+declare function clearPersistentLayouts(): void;
+/**
+ * Execute a layout transition
+ *
+ * Unlike page transitions, layout transitions are more subtle and
+ * typically involve animating specific sections while preserving others.
+ */
+declare function executeLayoutTransition(fromLayoutId: string | null, toLayoutId: string, updateDOM: () => void | Promise<void>): Promise<void>;
+/**
+ * Automatically find and register shared elements based on data attributes
+ *
+ * Elements with `data-transition-name` or `transition:name` will be registered.
+ */
+declare function autoRegisterSharedElements(): void;
+/**
+ * Set up a MutationObserver to auto-register shared elements
+ */
+declare function setupSharedElementObserver(): () => void;
+
+export { type SharedElementTransitionOptions, animateSharedElement, autoRegisterSharedElements, clearLayoutTransitions, clearPersistentLayouts, clearSharedElements, defineLayoutTransition, executeLayoutTransition, getLayoutTransition, getSharedElement, getSharedElementNames, isLayoutPersistent, markLayoutPersistent, registerSharedElement, setupSharedElementObserver, unregisterSharedElement };

package/dist/layout/index.js

@@ -0,0 +1,4 @@
+export { animateSharedElement, autoRegisterSharedElements, clearLayoutTransitions, clearPersistentLayouts, clearSharedElements, defineLayoutTransition, executeLayoutTransition, getLayoutTransition, getSharedElement, getSharedElementNames, isLayoutPersistent, markLayoutPersistent, registerSharedElement, setupSharedElementObserver, unregisterSharedElement } from '../chunk-ZI6E7GNQ.js';
+import '../chunk-OV3U5STU.js';
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/layout/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"index.js"}