@flightdev/transitions 0.2.0

package/dist/page/index.d.ts

@@ -0,0 +1,87 @@
+import { P as PageTransitionConfig, T as TransitionPreset, C as CustomTransition, c as TransitionDirection, f as TransitionContext } from '../types-BA4L37s4.js';
+
+/**
+ * @flightdev/transitions - Page Transitions
+ *
+ * Page-level transition management for route navigation.
+ */
+
+/**
+ * Define transition configuration for the current page
+ * Similar to Nuxt's definePageMeta but for transitions only
+ *
+ * @example
+ * ```tsx
+ * // In a page component
+ * definePageTransition({
+ *   default: 'slide-left',
+ *   backTransition: 'slide-right',
+ *   duration: 250,
+ * });
+ *
+ * export default function DashboardPage() {
+ *   return <div>Dashboard</div>;
+ * }
+ * ```
+ */
+declare function definePageTransition(config: PageTransitionConfig): void;
+/**
+ * Get the transition configuration for a specific page
+ */
+declare function getPageTransition(path: string): PageTransitionConfig | undefined;
+/**
+ * Clear all page transition configurations
+ * Useful for testing or hot module replacement
+ */
+declare function clearPageTransitions(): void;
+/**
+ * Options for executing a page transition
+ */
+interface ExecutePageTransitionOptions {
+    /** The path being navigated to */
+    to: string;
+    /** The path being navigated from */
+    from?: string;
+    /** Override the transition type */
+    transition?: TransitionPreset | CustomTransition | false;
+    /** Force a specific direction */
+    direction?: TransitionDirection;
+    /** Callback to execute the actual DOM update */
+    updateDOM: () => void | Promise<void>;
+}
+/**
+ * Execute a page transition
+ *
+ * This is the main function used by the router integration to
+ * perform transitions between pages.
+ *
+ * @example
+ * ```typescript
+ * await executePageTransition({
+ *   to: '/dashboard',
+ *   from: '/home',
+ *   updateDOM: () => {
+ *     // Update the page content
+ *   },
+ * });
+ * ```
+ */
+declare function executePageTransition(options: ExecutePageTransitionOptions): Promise<void>;
+/**
+ * Register a callback to run before a page leaves
+ */
+declare function onBeforePageLeave(callback: (context: TransitionContext) => void): () => void;
+/**
+ * Register a callback to run after a page leaves
+ */
+declare function onAfterPageLeave(callback: (context: TransitionContext) => void): () => void;
+/**
+ * Register a callback to run before a page enters
+ */
+declare function onBeforePageEnter(callback: (context: TransitionContext) => void): () => void;
+/**
+ * Register a callback to run after a page enters
+ */
+declare function onAfterPageEnter(callback: (context: TransitionContext) => void): () => void;
+
+export { type ExecutePageTransitionOptions, clearPageTransitions, definePageTransition, executePageTransition, getPageTransition, onAfterPageEnter, onAfterPageLeave, onBeforePageEnter, onBeforePageLeave };

package/dist/page/index.js

@@ -0,0 +1,7 @@
+import '../chunk-XLVYHPII.js';
+export { clearPageTransitions, definePageTransition, executePageTransition, getPageTransition, onAfterPageEnter, onAfterPageLeave, onBeforePageEnter, onBeforePageLeave } from '../chunk-SPUGO5I5.js';
+import '../chunk-QSB65CTV.js';
+import '../chunk-X2A7XWYR.js';
+import '../chunk-OV3U5STU.js';
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/page/index.js.map

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

package/dist/presets/index.d.ts

@@ -0,0 +1,192 @@
+import { C as CustomTransition, T as TransitionPreset } from '../types-BA4L37s4.js';
+
+/**
+ * @flightdev/transitions - Fade Presets
+ *
+ * Fade transition presets for smooth opacity-based animations.
+ */
+
+/**
+ * Simple fade transition
+ * Elements fade in/out with opacity only
+ */
+declare const fade: CustomTransition;
+/**
+ * Fade with subtle scale
+ * Elements fade and slightly shrink on exit, grow on enter
+ */
+declare const fadeScale: CustomTransition;
+/**
+ * Fade with blur effect
+ * Elements fade and blur on exit, unblur on enter
+ */
+declare const fadeBlur: CustomTransition;
+/**
+ * Slow fade for dramatic effect
+ * Longer duration for hero sections or important content
+ */
+declare const fadeSlow: CustomTransition;
+/**
+ * Fast fade for snappy UI
+ * Quick transitions for responsive feel
+ */
+declare const fadeFast: CustomTransition;
+
+/**
+ * @flightdev/transitions - Slide Presets
+ *
+ * Slide transition presets for directional page animations.
+ */
+
+/**
+ * Slide from left
+ * New content slides in from the left, old slides out to the right
+ */
+declare const slideLeft: CustomTransition;
+/**
+ * Slide from right
+ * New content slides in from the right, old slides out to the left
+ */
+declare const slideRight: CustomTransition;
+/**
+ * Slide from top
+ * New content slides in from the top, old slides out to the bottom
+ */
+declare const slideUp: CustomTransition;
+/**
+ * Slide from bottom
+ * New content slides in from the bottom, old slides out to the top
+ * Common for modals and bottom sheets
+ */
+declare const slideDown: CustomTransition;
+/**
+ * Slide with fade (subtle offset)
+ * Elements slide a small distance while fading
+ * Less dramatic than full slide
+ */
+declare const slideFade: CustomTransition;
+/**
+ * Slide with scale (iOS-like)
+ * Elements slide and scale slightly for depth effect
+ */
+declare const slideScale: CustomTransition;
+/**
+ * Slide overlay (modal-like)
+ * New content slides over old content which stays in place
+ */
+declare const slideOverlay: CustomTransition;
+
+/**
+ * @flightdev/transitions - Scale Presets
+ *
+ * Scale transition presets for zoom-based animations.
+ */
+
+/**
+ * Scale in/out
+ * Elements grow on enter, shrink on exit
+ */
+declare const scale: CustomTransition;
+/**
+ * Scale up (zoom in effect)
+ * Elements scale from smaller to normal
+ */
+declare const scaleUp: CustomTransition;
+/**
+ * Scale down (zoom out effect)
+ * Elements scale from larger to normal
+ */
+declare const scaleDown: CustomTransition;
+/**
+ * Scale fade (subtle)
+ * Very subtle scale with fade for refined UI
+ */
+declare const scaleFade: CustomTransition;
+/**
+ * Pop (bouncy scale)
+ * Elements pop in with overshoot for playful UI
+ */
+declare const pop: CustomTransition;
+/**
+ * Expand from center
+ * Elements expand from center point
+ */
+declare const expand: CustomTransition;
+
+/**
+ * @flightdev/transitions - Special Presets
+ *
+ * Special transition presets for advanced effects.
+ */
+
+/**
+ * No transition (instant swap)
+ * Use when you want to disable transitions for specific pages
+ */
+declare const none: CustomTransition;
+/**
+ * Flip horizontal (3D rotation)
+ * Elements flip like a card horizontally
+ */
+declare const flipX: CustomTransition;
+/**
+ * Flip vertical (3D rotation)
+ * Elements flip like a card vertically
+ */
+declare const flipY: CustomTransition;
+/**
+ * Rotate in/out
+ * Elements rotate while fading
+ */
+declare const rotate: CustomTransition;
+/**
+ * Swing in (pendulum effect)
+ * Elements swing in from the top
+ */
+declare const swing: CustomTransition;
+/**
+ * Morph placeholder
+ * Actual morph is handled by shared element transitions
+ */
+declare const morph: CustomTransition;
+/**
+ * Wipe left (reveal effect)
+ * Content is revealed from right to left using clip-path
+ */
+declare const wipeLeft: CustomTransition;
+/**
+ * Wipe up (reveal effect)
+ * Content is revealed from bottom to top using clip-path
+ */
+declare const wipeUp: CustomTransition;
+/**
+ * Circle reveal
+ * Content is revealed in a circular pattern from center
+ */
+declare const circleReveal: CustomTransition;
+
+/**
+ * @flightdev/transitions - Presets Module
+ *
+ * All transition presets exported for easy consumption.
+ */
+
+/**
+ * Map of preset names to transition definitions
+ * Used by resolveTransition to look up presets by name
+ */
+declare const presetMap: Record<TransitionPreset, CustomTransition>;
+/**
+ * Get a preset transition by name
+ */
+declare function getPreset(name: TransitionPreset): CustomTransition | undefined;
+/**
+ * Check if a string is a valid preset name
+ */
+declare function isPresetName(name: string): name is TransitionPreset;
+/**
+ * Get all available preset names
+ */
+declare function getPresetNames(): TransitionPreset[];
+
+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, slideOverlay, slideRight, slideScale, slideUp, swing, wipeLeft, wipeUp };

package/dist/presets/index.js

@@ -0,0 +1,3 @@
+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, slideOverlay, slideRight, slideScale, slideUp, swing, wipeLeft, wipeUp } from '../chunk-QSB65CTV.js';
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/presets/index.js.map

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

package/dist/router/index.d.ts

@@ -0,0 +1,104 @@
+import { T as TransitionPreset, C as CustomTransition, c as TransitionDirection, P as PageTransitionConfig } from '../types-BA4L37s4.js';
+
+/**
+ * @flightdev/transitions - Router Integration
+ *
+ * Integration with @flightdev/router for seamless page transitions.
+ */
+
+/**
+ * Options for navigating with transitions
+ */
+interface NavigateWithTransitionOptions {
+    /** Replace current history entry instead of push */
+    replace?: boolean;
+    /** Scroll to top after navigation */
+    scroll?: boolean;
+    /** State to pass to the new route */
+    state?: Record<string, unknown>;
+    /** Transition to use (overrides page default) */
+    transition?: TransitionPreset | CustomTransition | false;
+    /** Force transition even if globally disabled */
+    forceTransition?: boolean;
+    /** Direction hint for the transition */
+    direction?: TransitionDirection;
+}
+/**
+ * Navigate to a URL with transition support
+ *
+ * This function wraps the standard navigation with View Transitions API
+ * support and integrates with the Flight transitions system.
+ *
+ * @example
+ * ```typescript
+ * import { navigateWithTransition } from '@flightdev/transitions/router';
+ *
+ * // Simple navigation
+ * await navigateWithTransition('/about');
+ *
+ * // With options
+ * await navigateWithTransition('/dashboard', {
+ *   transition: 'slide-left',
+ *   replace: false,
+ * });
+ * ```
+ */
+declare function navigateWithTransition(to: string, options?: NavigateWithTransitionOptions): Promise<void>;
+/**
+ * Set up history navigation listeners for back/forward transitions
+ *
+ * Call this once during app initialization to enable transitions
+ * for browser back/forward navigation.
+ *
+ * @example
+ * ```typescript
+ * import { setupHistoryTransitions } from '@flightdev/transitions/router';
+ *
+ * // In your app initialization
+ * setupHistoryTransitions();
+ * ```
+ */
+declare function setupHistoryTransitions(): () => void;
+/**
+ * Prefetch a route's assets for faster transitions
+ *
+ * @example
+ * ```typescript
+ * // Prefetch on hover
+ * element.addEventListener('mouseenter', () => {
+ *   prefetchRoute('/about');
+ * });
+ * ```
+ */
+declare function prefetchRoute(url: string): void;
+/**
+ * Check if a route has been prefetched
+ */
+declare function isRoutePrefetched(url: string): boolean;
+/**
+ * Configure transitions based on route patterns
+ */
+interface RouteTransitionConfig {
+    /** Route pattern (supports wildcards) */
+    pattern: string;
+    /** Transition configuration for this route */
+    transition: PageTransitionConfig;
+}
+/**
+ * Register transition configs for route patterns
+ *
+ * @example
+ * ```typescript
+ * registerRouteTransitions([
+ *   { pattern: '/dashboard/*', transition: { default: 'slide-left' } },
+ *   { pattern: '/settings', transition: { default: 'fade' } },
+ * ]);
+ * ```
+ */
+declare function registerRouteTransitions(configs: RouteTransitionConfig[]): void;
+/**
+ * Get transition config for a route based on registered patterns
+ */
+declare function getRouteTransitionConfig(path: string): PageTransitionConfig | undefined;
+
+export { type NavigateWithTransitionOptions, type RouteTransitionConfig, getRouteTransitionConfig, isRoutePrefetched, navigateWithTransition, prefetchRoute, registerRouteTransitions, setupHistoryTransitions };

package/dist/router/index.js

@@ -0,0 +1,7 @@
+export { getRouteTransitionConfig, isRoutePrefetched, navigateWithTransition, prefetchRoute, registerRouteTransitions, setupHistoryTransitions } from '../chunk-DZC3OLDU.js';
+import '../chunk-SPUGO5I5.js';
+import '../chunk-QSB65CTV.js';
+import '../chunk-X2A7XWYR.js';
+import '../chunk-OV3U5STU.js';
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/router/index.js.map

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

package/dist/transition-manager-QWm4OSFw.d.ts

@@ -0,0 +1,62 @@
+import { i as TransitionsConfig, j as TransitionState, k as TransitionListener, P as PageTransitionConfig, c as TransitionDirection } from './types-BA4L37s4.js';
+
+/**
+ * @flightdev/transitions - Transition Manager
+ *
+ * Central orchestrator for all transition operations.
+ * Manages state, configuration, and coordinates between different
+ * transition types (page, layout, component).
+ */
+
+/**
+ * Create a new transition manager instance
+ *
+ * @example
+ * ```typescript
+ * const manager = createTransitionManager({
+ *   pageTransition: 'fade',
+ *   duration: 200,
+ * });
+ *
+ * // Subscribe to state changes
+ * manager.subscribe((state) => {
+ *   console.log('Transition state:', state);
+ * });
+ *
+ * // Start a transition
+ * await manager.startPageTransition('/new-page');
+ * ```
+ */
+declare function createTransitionManager(initialConfig?: TransitionsConfig): TransitionManager;
+interface TransitionManager {
+    /** Get current transition state (readonly copy) */
+    getState(): TransitionState;
+    /** Get current configuration (readonly copy) */
+    getConfig(): TransitionsConfig;
+    /** Update configuration */
+    configure(config: TransitionsConfig): void;
+    /** Subscribe to state changes, returns unsubscribe function */
+    subscribe(listener: TransitionListener): () => void;
+    /** Start a page transition */
+    startPageTransition(to: string, config?: PageTransitionConfig): Promise<void>;
+    /** Skip the current transition immediately */
+    skipTransition(): void;
+    /** Check if transitions are enabled */
+    isEnabled(): boolean;
+    /** Check if View Transitions API is supported */
+    isViewTransitionSupported(): boolean;
+    /** Set the navigation direction */
+    setDirection(direction: TransitionDirection): void;
+    /** Clean up resources */
+    destroy(): void;
+}
+/**
+ * Get or create the global transition manager instance
+ */
+declare function getTransitionManager(): TransitionManager;
+/**
+ * Initialize the global transition manager with configuration
+ */
+declare function initTransitions(config: TransitionsConfig): TransitionManager;
+
+export { type TransitionManager as T, createTransitionManager as c, getTransitionManager as g, initTransitions as i };