@flight-framework/router 0.0.6 → 0.0.7

package/dist/index.d.ts

@@ -1,169 +1,5 @@
-/**
- * Type definitions for @flight-framework/router
- */
-/**
- * Router context value provided to all components
- */
-interface RouterContextValue {
-    /** Current pathname (e.g., '/docs/routing') */
-    path: string;
-    /** URL search params as object */
-    searchParams: URLSearchParams;
-    /** Navigate to a new path */
-    navigate: (to: string, options?: NavigateOptions) => void;
-    /** Go back in history */
-    back: () => void;
-    /** Go forward in history */
-    forward: () => void;
-}
-/**
- * Props for RouterProvider component
- */
-interface RouterProviderProps {
-    /** Child components */
-    children: unknown;
-    /** Initial path for SSR (server passes request URL) */
-    initialPath?: string;
-    /** Base path for the router (e.g., '/app') */
-    basePath?: string;
-}
-/**
- * Prefetch strategy for Link component
- *
- * - 'none': No prefetching (default)
- * - 'intent': Prefetch on hover or focus (recommended for most cases)
- * - 'render': Prefetch immediately when link renders
- * - 'viewport': Prefetch when link enters the viewport (good for mobile)
- */
-type PrefetchStrategy = 'none' | 'intent' | 'render' | 'viewport';
-/**
- * Priority level for prefetch requests
- */
-type PrefetchPriority = 'high' | 'low' | 'auto';
-/**
- * Options for programmatic prefetching
- */
-interface PrefetchOptions {
-    /** Priority of the prefetch request */
-    priority?: PrefetchPriority;
-    /** Include data prefetch (loaders) */
-    includeData?: boolean;
-    /** Include module prefetch (JS chunks) */
-    includeModules?: boolean;
-}
-/**
- * Props for Link component
- */
-interface LinkProps {
-    /** Target URL path */
-    href: string;
-    /** Child content */
-    children: unknown;
-    /** CSS class name */
-    className?: string;
-    /** Open in new tab */
-    target?: string;
-    /** Link relationship */
-    rel?: string;
-    /**
-     * Prefetch strategy for the target page.
-     *
-     * - `true` or `'intent'`: Prefetch on hover/focus
-     * - `'render'`: Prefetch when link renders
-     * - `'viewport'`: Prefetch when link enters viewport
-     * - `false` or `'none'`: No prefetching (default)
-     *
-     * @default 'none'
-     */
-    prefetch?: boolean | PrefetchStrategy;
-    /** Replace current history entry instead of pushing */
-    replace?: boolean;
-    /** Scroll to top after navigation */
-    scroll?: boolean;
-    /** Aria label for accessibility */
-    'aria-label'?: string;
-    /** Click handler */
-    onClick?: (event: MouseEvent) => void;
-}
-/**
- * Options for programmatic navigation
- */
-interface NavigateOptions {
-    /** Replace current history entry instead of pushing */
-    replace?: boolean;
-    /** Scroll to top after navigation */
-    scroll?: boolean;
-    /** State data to pass to the new route */
-    state?: unknown;
-}
-/**
- * Dynamic route parameters extracted from URL
- */
-type RouteParams<T extends string = string> = Record<T, string>;
-/**
- * Search params as key-value pairs
- */
-type SearchParams = Record<string, string | string[]>;
-/**
- * Route definition for automatic route generation
- */
-interface RouteDefinition {
-    /** Route path pattern (e.g., '/docs/:slug') */
-    path: string;
-    /** Dynamic import for component */
-    component: () => Promise<{
-        default: unknown;
-    }>;
-    /** Dynamic imports for layouts (in order, root first) */
-    layouts?: Array<() => Promise<{
-        default: unknown;
-    }>>;
-    /** Dynamic import for loader function */
-    loader?: () => Promise<{
-        loader: LoaderFunction;
-    }>;
-}
-/**
- * Loader function signature
- */
-type LoaderFunction = (context: LoaderContext) => Promise<unknown> | unknown;
-/**
- * Context passed to loader functions
- */
-interface LoaderContext {
-    /** Route parameters */
-    params: RouteParams;
-    /** Request object (available on server) */
-    request?: Request;
-    /** URL search params */
-    searchParams: URLSearchParams;
-}
-/**
- * Route match result
- */
-interface RouteMatch {
-    /** Matched route definition */
-    route: RouteDefinition;
-    /** Extracted parameters */
-    params: RouteParams;
-    /** Matched path */
-    pathname: string;
-}
-
-/**
- * Router Context and Provider
- *
- * Provides routing state to the component tree.
- * SSR-safe: works on both server and client.
- */
-
-/**
- * React Context for router
- * Only used if React is available
- */
-declare let RouterContext: unknown;
-declare let RouterProvider: unknown;
-declare let useRouter: () => RouterContextValue;
+import { L as LinkProps, R as RouteParams, S as SearchParams } from './prefetch-CMmeei6-.js';
+export { g as LoaderContext, f as LoaderFunction, N as NavigateOptions, d as PrefetchOptions, k as PrefetchPageLinks, c as PrefetchPriority, P as PrefetchStrategy, e as RouteDefinition, h as RouteMatch, i as RouterContext, a as RouterContextValue, j as RouterProvider, b as RouterProviderProps, w as clearPrefetchCache, l as findRoute, o as generatePath, q as isActive, v as isPrefetched, m as matchRoute, n as navigate, x as observeForPrefetch, p as parseParams, s as prefetch, t as prefetchAll, z as prefetchPages, A as prefetchWhenIdle, r as redirect, y as setupIntentPrefetch, u as useRouter } from './prefetch-CMmeei6-.js';
 
 /**
  * @flight-framework/router - Link Component
@@ -222,46 +58,6 @@ declare function useLinkProps(href: string, options?: Partial<Omit<LinkProps, 'h
     onFocus?: () => void;
 };
 
-/**
- * @flight-framework/router - PrefetchPageLinks Component
- *
- * Renders prefetch link tags for a page. Useful for proactively
- * prefetching pages based on user behavior (e.g., search results).
- *
- * This is the Flight equivalent of React Router's PrefetchPageLinks.
- */
-
-declare let PrefetchPageLinks: unknown;
-/**
- * Prefetch multiple pages at once.
- *
- * Useful for prefetching a list of search results or related pages.
- *
- * @example
- * ```typescript
- * // Prefetch top 5 search results
- * prefetchPages([
- *     '/products/1',
- *     '/products/2',
- *     '/products/3',
- * ]);
- * ```
- */
-declare function prefetchPages(pages: string[], options?: PrefetchOptions): void;
-/**
- * Prefetch a page when idle.
- *
- * Uses requestIdleCallback if available, otherwise falls back
- * to setTimeout.
- *
- * @example
- * ```typescript
- * // Prefetch after initial render settles
- * prefetchWhenIdle('/dashboard');
- * ```
- */
-declare function prefetchWhenIdle(page: string, options?: PrefetchOptions): void;
-
 /**
  * Router Hooks
  *
@@ -296,140 +92,4 @@ declare let useParams: <T extends RouteParams = RouteParams>() => T;
 declare let useSearchParams: () => [URLSearchParams, (params: SearchParams | URLSearchParams) => void];
 declare let usePathname: () => string;
 
-/**
- * Navigation Utilities
- *
- * Programmatic navigation and route matching utilities.
- */
-
-/**
- * Navigate programmatically to a new path
- *
- * @example
- * ```ts
- * navigate('/docs');
- * navigate('/login', { replace: true });
- * navigate('/dashboard', { scroll: false, state: { from: '/home' } });
- * ```
- */
-declare function navigate(to: string, options?: NavigateOptions): void;
-/**
- * Match a pathname against a route pattern
- *
- * @example
- * ```ts
- * matchRoute('/docs/routing', '/docs/:slug');
- * // Returns: { params: { slug: 'routing' }, matched: true }
- * ```
- */
-declare function matchRoute(pathname: string, pattern: string): {
-    matched: boolean;
-    params: RouteParams;
-};
-/**
- * Parse parameters from a matched route
- *
- * @example
- * ```ts
- * parseParams('/blog/2024/my-post', '/blog/:year/:slug');
- * // Returns: { year: '2024', slug: 'my-post' }
- * ```
- */
-declare function parseParams(pathname: string, pattern: string): RouteParams;
-/**
- * Find the best matching route from a list of route definitions
- */
-declare function findRoute(pathname: string, routes: RouteDefinition[]): RouteMatch | null;
-/**
- * Generate a URL from a route pattern and params
- *
- * @example
- * ```ts
- * generatePath('/docs/:slug', { slug: 'routing' });
- * // Returns: '/docs/routing'
- * ```
- */
-declare function generatePath(pattern: string, params?: RouteParams): string;
-/**
- * Check if current path matches a pattern
- */
-declare function isActive(pattern: string): boolean;
-/**
- * Redirect to a new URL (full page navigation)
- * Use this for external redirects or when you need to break out of SPA
- */
-declare function redirect(url: string): never;
-
-/**
- * @flight-framework/router - Prefetch Utilities
- *
- * Universal prefetch system for Flight Framework.
- * Works across all UI frameworks and runtimes.
- *
- * Features:
- * - Multiple prefetch strategies (intent, render, viewport)
- * - Priority-based prefetching
- * - Module and data prefetching
- * - IntersectionObserver for viewport detection
- * - SSR-safe implementation
- */
-
-/**
- * Prefetch a URL with the specified options.
- *
- * This is the main programmatic prefetch API for Flight Framework.
- * It creates appropriate link elements for prefetching resources.
- *
- * @param href - The URL to prefetch
- * @param options - Prefetch configuration options
- *
- * @example
- * ```typescript
- * // Basic prefetch
- * prefetch('/docs');
- *
- * // High priority prefetch (for critical navigation paths)
- * prefetch('/checkout', { priority: 'high' });
- *
- * // Prefetch with data loaders
- * prefetch('/products', { includeData: true });
- * ```
- */
-declare function prefetch(href: string, options?: PrefetchOptions): void;
-/**
- * Prefetch multiple URLs at once.
- *
- * @param hrefs - Array of URLs to prefetch
- * @param options - Prefetch configuration options
- */
-declare function prefetchAll(hrefs: string[], options?: PrefetchOptions): void;
-/**
- * Check if a URL has been prefetched.
- *
- * @param href - The URL to check
- * @returns True if the URL has been prefetched
- */
-declare function isPrefetched(href: string): boolean;
-/**
- * Clear all prefetch state (useful for testing or memory management).
- */
-declare function clearPrefetchCache(): void;
-/**
- * Observe an element for viewport entry and trigger prefetch.
- *
- * @param element - The link element to observe
- * @param href - The URL to prefetch when visible
- * @returns Cleanup function to stop observing
- */
-declare function observeForPrefetch(element: Element, href: string): () => void;
-/**
- * Setup intent-based prefetching for an element.
- * Prefetches on mouseenter or focus.
- *
- * @param element - The link element
- * @param href - The URL to prefetch
- * @returns Cleanup function to remove listeners
- */
-declare function setupIntentPrefetch(element: HTMLElement, href: string): () => void;
-
-export { Link, type LinkProps, type LoaderContext, type LoaderFunction, type NavigateOptions, type PrefetchOptions, PrefetchPageLinks, type PrefetchPriority, type PrefetchStrategy, type RouteDefinition, type RouteMatch, type RouteParams, RouterContext, type RouterContextValue, RouterProvider, type RouterProviderProps, type SearchParams, clearPrefetchCache, createLink, createUsePathname, findRoute, generatePath, getPathnameServerSnapshot, getPathnameSnapshot, isActive, isPrefetched, matchRoute, navigate, observeForPrefetch, parseParams, prefetch, prefetchAll, prefetchPages, prefetchRoute, prefetchWhenIdle, redirect, setupIntentPrefetch, subscribeToPathname, useLinkProps, useParams, usePathname, useRouter, useSearchParams };
+export { Link, LinkProps, RouteParams, SearchParams, createLink, createUsePathname, getPathnameServerSnapshot, getPathnameSnapshot, prefetchRoute, subscribeToPathname, useLinkProps, useParams, usePathname, useSearchParams };