@liteforge/router 0.1.0

package/dist/lazy.js

@@ -0,0 +1,458 @@
+/**
+ * Create a lazy-loaded component
+ *
+ * The returned function acts as a LazyComponent that can be used in route definitions.
+ * It provides caching, error handling, and prefetching capabilities.
+ *
+ * @example
+ * ```ts
+ * // Basic usage
+ * const LazyDashboard = lazy(() => import('./pages/Dashboard'));
+ *
+ * // With options
+ * const LazySettings = lazy(
+ *   () => import('./pages/Settings'),
+ *   {
+ *     loading: () => document.createTextNode('Loading settings...'),
+ *     timeout: 5000,
+ *   }
+ * );
+ *
+ * // In route definition
+ * const routes = [
+ *   { path: '/dashboard', component: LazyDashboard },
+ *   { path: '/settings', component: LazySettings },
+ * ];
+ *
+ * // Prefetch component
+ * LazyDashboard.prefetch();
+ * ```
+ */
+export function lazy(loader, options = {}) {
+    const state = { current: { status: 'idle' } };
+    let loadPromise = null;
+    /**
+     * Load the component with caching
+     */
+    async function load() {
+        // Return cached if already loaded
+        if (state.current.status === 'loaded') {
+            return { default: state.current.component };
+        }
+        // Return existing promise if already loading
+        if (loadPromise) {
+            return loadPromise;
+        }
+        state.current = { status: 'loading' };
+        // Track timing for minLoadTime
+        const startTime = Date.now();
+        // Create the loading promise with optional timeout
+        const timeoutPromise = options.timeout && options.timeout > 0
+            ? new Promise((_, reject) => setTimeout(() => reject(new Error(`Lazy component load timed out after ${options.timeout}ms`)), options.timeout))
+            : null;
+        loadPromise = (async () => {
+            try {
+                // Race against timeout if specified
+                const result = timeoutPromise
+                    ? await Promise.race([loader(), timeoutPromise])
+                    : await loader();
+                // Enforce minimum load time to prevent flash
+                if (options.minLoadTime && options.minLoadTime > 0) {
+                    const elapsed = Date.now() - startTime;
+                    const remaining = options.minLoadTime - elapsed;
+                    if (remaining > 0) {
+                        await new Promise(resolve => setTimeout(resolve, remaining));
+                    }
+                }
+                // Extract component from result
+                const component = 'default' in result ? result.default : result;
+                state.current = { status: 'loaded', component };
+                return result;
+            }
+            catch (error) {
+                const err = error instanceof Error ? error : new Error(String(error));
+                state.current = { status: 'error', error: err };
+                loadPromise = null; // Allow retry
+                throw err;
+            }
+        })();
+        return loadPromise;
+    }
+    /**
+     * Prefetch the component without rendering
+     */
+    async function prefetch() {
+        try {
+            await load();
+        }
+        catch {
+            // Silently ignore prefetch errors
+        }
+    }
+    /**
+     * Check if component is loaded
+     */
+    function isLoaded() {
+        return state.current.status === 'loaded';
+    }
+    /**
+     * Get the loaded component synchronously.
+     * Returns undefined if not loaded yet.
+     * This avoids the microtask delay of using .then() on a resolved Promise.
+     */
+    function getLoaded() {
+        if (state.current.status === 'loaded') {
+            return state.current.component;
+        }
+        return undefined;
+    }
+    /**
+     * Reset state to idle (for retry)
+     */
+    function reset() {
+        state.current = { status: 'idle' };
+        loadPromise = null;
+    }
+    // Trigger prefetch immediately if requested
+    if (options.prefetch) {
+        // Use setTimeout to avoid blocking
+        setTimeout(prefetch, 0);
+    }
+    // Return function that acts as LazyComponent
+    const wrapper = load;
+    wrapper.prefetch = prefetch;
+    wrapper.isLoaded = isLoaded;
+    wrapper.getLoaded = getLoaded;
+    wrapper.reset = reset;
+    // Expose internal state for debugging/testing
+    Object.defineProperty(wrapper, '__lazyState', {
+        get: () => state.current,
+        enumerable: false,
+    });
+    Object.defineProperty(wrapper, '__loader', {
+        value: loader,
+        enumerable: false,
+    });
+    Object.defineProperty(wrapper, '__options', {
+        value: options,
+        enumerable: false,
+    });
+    return wrapper;
+}
+// =============================================================================
+// Prefetching Utilities
+// =============================================================================
+/**
+ * Prefetch multiple lazy components
+ *
+ * @example
+ * ```ts
+ * // Prefetch all admin pages
+ * prefetchAll([LazyAdminDashboard, LazyAdminUsers, LazyAdminSettings]);
+ * ```
+ */
+export async function prefetchAll(components) {
+    await Promise.all(components.map(component => {
+        if ('prefetch' in component && typeof component.prefetch === 'function') {
+            return component.prefetch();
+        }
+        // For plain LazyComponent, just call it to trigger load
+        return component().catch(() => { });
+    }));
+}
+/**
+ * Check if a component is a lazy component
+ */
+export function isLazyComponent(component) {
+    return (typeof component === 'function' &&
+        'prefetch' in component &&
+        'isLoaded' in component &&
+        'reset' in component);
+}
+/**
+ * Get the delay option from a lazy component (default: 200ms)
+ */
+export function getLazyDelay(component) {
+    const options = component.__options;
+    return options?.delay ?? 200;
+}
+/**
+ * Get the loading component from a lazy component
+ */
+export function getLazyLoading(component) {
+    return component.__options?.loading;
+}
+/**
+ * Get the error component from a lazy component
+ */
+export function getLazyError(component) {
+    return component.__options?.error;
+}
+// =============================================================================
+// Preload Link Helpers
+// =============================================================================
+/**
+ * Create a preload function that prefetches lazy components on link hover
+ *
+ * @example
+ * ```ts
+ * const preloadOnHover = createPreloadOnHover({
+ *   '/dashboard': LazyDashboard,
+ *   '/settings': LazySettings,
+ * });
+ *
+ * // Attach to link element
+ * linkElement.addEventListener('mouseenter', () => preloadOnHover('/dashboard'));
+ * ```
+ */
+export function createPreloadOnHover(componentMap) {
+    const prefetched = new Set();
+    return (path) => {
+        // Already prefetched
+        if (prefetched.has(path))
+            return;
+        const component = componentMap[path];
+        if (!component)
+            return;
+        prefetched.add(path);
+        if ('prefetch' in component && typeof component.prefetch === 'function') {
+            component.prefetch();
+        }
+        else {
+            component().catch(() => { });
+        }
+    };
+}
+/**
+ * Create an intersection observer that prefetches lazy components when links enter viewport
+ *
+ * @example
+ * ```ts
+ * const observer = createPreloadOnVisible({
+ *   '/dashboard': LazyDashboard,
+ *   '/settings': LazySettings,
+ * });
+ *
+ * // Observe link elements
+ * document.querySelectorAll('a[href]').forEach(link => {
+ *   observer.observe(link, link.getAttribute('href')!);
+ * });
+ *
+ * // Cleanup when done
+ * observer.disconnect();
+ * ```
+ */
+export function createPreloadOnVisible(componentMap, options = {}) {
+    const prefetched = new Set();
+    const elementPathMap = new WeakMap();
+    /* v8 ignore start */
+    // IntersectionObserver is only available in browsers
+    let observer = null;
+    if (typeof IntersectionObserver !== 'undefined') {
+        observer = new IntersectionObserver((entries) => {
+            for (const entry of entries) {
+                if (!entry.isIntersecting)
+                    continue;
+                const path = elementPathMap.get(entry.target);
+                if (!path || prefetched.has(path))
+                    continue;
+                const component = componentMap[path];
+                if (!component)
+                    continue;
+                prefetched.add(path);
+                observer.unobserve(entry.target);
+                if ('prefetch' in component && typeof component.prefetch === 'function') {
+                    component.prefetch();
+                }
+                else {
+                    component().catch(() => { });
+                }
+            }
+        }, options);
+    }
+    /* v8 ignore stop */
+    return {
+        observe(element, path) {
+            elementPathMap.set(element, path);
+            /* v8 ignore next */
+            observer?.observe(element);
+        },
+        unobserve(element) {
+            elementPathMap.delete(element);
+            /* v8 ignore next */
+            observer?.unobserve(element);
+        },
+        disconnect() {
+            /* v8 ignore next */
+            observer?.disconnect();
+        },
+    };
+}
+// =============================================================================
+// Inline Lazy Import Support
+// =============================================================================
+/**
+ * Type guard: check if a value is a function that can be used as a component
+ */
+function isComponentFunction(value) {
+    return typeof value === 'function';
+}
+/**
+ * Resolve the component export from a dynamically imported module.
+ *
+ * @param module - The imported module object
+ * @param exportName - Optional named export to use (default: 'default')
+ * @returns The resolved component function
+ * @throws Error if no component can be found in the module
+ *
+ * Resolution order:
+ * 1. If exportName is specified, use that export
+ * 2. If module has 'default' export, use that
+ * 3. Use the first function export found (convenience fallback)
+ */
+export function resolveModuleExport(module, exportName) {
+    // 1. Explicit named export
+    if (exportName !== undefined) {
+        const exported = module[exportName];
+        if (!isComponentFunction(exported)) {
+            throw new Error(`Export "${exportName}" not found or not a function in lazy-loaded module. ` +
+                `Available exports: ${Object.keys(module).join(', ')}`);
+        }
+        return exported;
+    }
+    // 2. Default export
+    if ('default' in module && isComponentFunction(module.default)) {
+        return module.default;
+    }
+    // 3. First function export (fallback)
+    for (const key of Object.keys(module)) {
+        const value = module[key];
+        if (isComponentFunction(value)) {
+            return value;
+        }
+    }
+    throw new Error(`No component found in lazy-loaded module. ` +
+        `Available exports: ${Object.keys(module).join(', ')}`);
+}
+/**
+ * Check if a component is a pre-wrapped lazy component (created with lazy()).
+ * This is the existing lazy() wrapper with prefetch/isLoaded/reset methods.
+ */
+export function isWrappedLazyComponent(component) {
+    return (typeof component === 'function' &&
+        'prefetch' in component &&
+        'isLoaded' in component &&
+        'reset' in component);
+}
+/**
+ * Check if a component is an inline lazy import function.
+ *
+ * An inline lazy import is a zero-argument function that returns a Promise.
+ * We detect this by calling the function and checking if it returns a thenable.
+ * The result is cached so we only detect once.
+ *
+ * Note: This is a heuristic. Static components that return Promises would be
+ * incorrectly detected as lazy. However, this is rare in practice since
+ * components should return DOM nodes synchronously.
+ */
+const detectedLazyCache = new WeakMap();
+export function detectInlineLazyImport(component) {
+    // Must be a function
+    if (typeof component !== 'function') {
+        return false;
+    }
+    // Check cache
+    if (detectedLazyCache.has(component)) {
+        return detectedLazyCache.get(component) === true;
+    }
+    // Already wrapped with lazy() - not an inline import
+    if (isWrappedLazyComponent(component)) {
+        detectedLazyCache.set(component, false);
+        return false;
+    }
+    // Inline lazy imports are zero-argument functions
+    // Static components also have length 0 if they don't use props
+    // We'll use a different heuristic: check function body for 'import('
+    // This is not 100% reliable but works for the common case
+    const fnString = component.toString();
+    const looksLikeImport = fnString.includes('import(') || fnString.includes('import (');
+    detectedLazyCache.set(component, looksLikeImport);
+    return looksLikeImport;
+}
+/**
+ * Wrap an inline lazy import with the lazy() function.
+ *
+ * This converts: `() => import('./Component.js')`
+ * Into a full lazy component with loading states, caching, etc.
+ *
+ * @param importFn - The inline import function
+ * @param exportName - Named export to use from the module
+ * @param routeLazyConfig - Per-route lazy config
+ * @param globalDefaults - Global lazy defaults from router options
+ */
+export function wrapInlineLazy(importFn, exportName, routeLazyConfig, globalDefaults) {
+    // Merge route config with global defaults
+    const delay = routeLazyConfig?.delay ?? globalDefaults?.delay ?? 200;
+    const timeout = routeLazyConfig?.timeout ?? globalDefaults?.timeout ?? 10000;
+    const minLoadTime = routeLazyConfig?.minLoadTime ?? globalDefaults?.minLoadTime;
+    const loading = globalDefaults?.loading;
+    const error = globalDefaults?.error;
+    // Create a loader that resolves the export
+    const loader = async () => {
+        const module = await importFn();
+        const component = resolveModuleExport(module, exportName);
+        return { default: component };
+    };
+    // Build options
+    const options = {
+        delay,
+        timeout,
+    };
+    if (minLoadTime !== undefined) {
+        options.minLoadTime = minLoadTime;
+    }
+    if (loading !== undefined) {
+        options.loading = () => {
+            // Call the loading component
+            const result = loading();
+            // If it's a Node, return it; otherwise create a text node
+            if (result instanceof Node) {
+                return result;
+            }
+            return document.createTextNode('Loading...');
+        };
+    }
+    if (error !== undefined) {
+        options.error = error;
+    }
+    return lazy(loader, options);
+}
+/**
+ * Process a route component during compilation.
+ *
+ * - If it's a static component, return as-is
+ * - If it's already wrapped with lazy(), return as-is
+ * - If it's an inline lazy import, wrap it with lazy()
+ *
+ * @param component - The route component to process
+ * @param exportName - Named export to use (for inline lazy)
+ * @param routeLazyConfig - Per-route lazy config
+ * @param globalDefaults - Global lazy defaults
+ * @returns The processed component (either original or wrapped)
+ */
+export function processRouteComponent(component, exportName, routeLazyConfig, globalDefaults) {
+    if (component === undefined) {
+        return undefined;
+    }
+    // Already a pre-wrapped lazy component
+    if (isWrappedLazyComponent(component)) {
+        return component;
+    }
+    // Detect inline lazy import
+    if (detectInlineLazyImport(component)) {
+        return wrapInlineLazy(component, exportName, routeLazyConfig, globalDefaults);
+    }
+    // Static component - return as-is
+    return component;
+}
+//# sourceMappingURL=lazy.js.map

package/dist/lazy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lazy.js","sourceRoot":"","sources":["../src/lazy.ts"],"names":[],"mappings":"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"}

package/dist/middleware.d.ts

@@ -0,0 +1,69 @@
+import type { RouteMiddleware, MiddlewareFunction, MiddlewareContext, NavigationTarget } from './types.js';
+/**
+ * Define a named route middleware
+ *
+ * @example
+ * ```ts
+ * const loggerMiddleware = defineMiddleware('logger', async (ctx, next) => {
+ *   console.log(`Navigating from ${ctx.from?.path} to ${ctx.to.path}`);
+ *   await next();
+ *   console.log(`Navigation complete to ${ctx.to.path}`);
+ * });
+ *
+ * const analyticsMiddleware = defineMiddleware('analytics', async (ctx, next) => {
+ *   const analytics = ctx.use('analytics');
+ *   analytics.track('page_view', { path: ctx.to.path });
+ *   await next();
+ * });
+ * ```
+ */
+export declare function defineMiddleware(name: string, handler: MiddlewareFunction): RouteMiddleware;
+/**
+ * Compose multiple middleware into a single function
+ * Uses an onion-style execution model (like Koa)
+ */
+export declare function composeMiddleware(middleware: RouteMiddleware[]): (context: MiddlewareContext) => Promise<{
+    redirect?: NavigationTarget;
+}>;
+/**
+ * Run middleware chain with abort capability
+ */
+export declare function runMiddleware(middleware: RouteMiddleware[], context: MiddlewareContext): Promise<{
+    completed: boolean;
+    redirect?: NavigationTarget;
+}>;
+/**
+ * Create a logger middleware
+ */
+export declare function createLoggerMiddleware(options?: {
+    prefix?: string;
+    logTiming?: boolean;
+}): RouteMiddleware;
+/**
+ * Create a scroll restoration middleware
+ */
+export declare function createScrollMiddleware(options?: {
+    behavior?: ScrollBehavior;
+    scrollToHash?: boolean;
+}): RouteMiddleware;
+/**
+ * Create a page title middleware
+ */
+export declare function createTitleMiddleware(options?: {
+    suffix?: string;
+    separator?: string;
+    defaultTitle?: string;
+}): RouteMiddleware;
+/**
+ * Create an analytics middleware
+ */
+export declare function createAnalyticsMiddleware(trackFn: (event: string, data: Record<string, unknown>) => void): RouteMiddleware;
+/**
+ * Create a loading indicator middleware
+ */
+export declare function createLoadingMiddleware(options?: {
+    onStart?: () => void;
+    onEnd?: () => void;
+    delay?: number;
+}): RouteMiddleware;
+//# sourceMappingURL=middleware.d.ts.map

package/dist/middleware.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"middleware.d.ts","sourceRoot":"","sources":["../src/middleware.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,eAAe,EACf,kBAAkB,EAClB,iBAAiB,EACjB,gBAAgB,EACjB,MAAM,YAAY,CAAC;AAMpB;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,kBAAkB,GAAG,eAAe,CAE3F;AAMD;;;GAGG;AACH,wBAAgB,iBAAiB,CAC/B,UAAU,EAAE,eAAe,EAAE,GAC5B,CAAC,OAAO,EAAE,iBAAiB,KAAK,OAAO,CAAC;IAAE,QAAQ,CAAC,EAAE,gBAAgB,CAAA;CAAE,CAAC,CAsC1E;AAED;;GAEG;AACH,wBAAsB,aAAa,CACjC,UAAU,EAAE,eAAe,EAAE,EAC7B,OAAO,EAAE,iBAAiB,GACzB,OAAO,CAAC;IAAE,SAAS,EAAE,OAAO,CAAC;IAAC,QAAQ,CAAC,EAAE,gBAAgB,CAAA;CAAE,CAAC,CAkB9D;AAMD;;GAEG;AACH,wBAAgB,sBAAsB,CACpC,OAAO,GAAE;IACP,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,OAAO,CAAC;CAChB,GACL,eAAe,CAkBjB;AAID;;GAEG;AACH,wBAAgB,sBAAsB,CACpC,OAAO,GAAE;IACP,QAAQ,CAAC,EAAE,cAAc,CAAC;IAC1B,YAAY,CAAC,EAAE,OAAO,CAAC;CACnB,GACL,eAAe,CAqCjB;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CACnC,OAAO,GAAE;IACP,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,YAAY,CAAC,EAAE,MAAM,CAAC;CAClB,GACL,eAAe,CAuBjB;AAID;;GAEG;AACH,wBAAgB,yBAAyB,CACvC,OAAO,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,GAC9D,eAAe,CAWjB;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CACrC,OAAO,GAAE;IACP,OAAO,CAAC,EAAE,MAAM,IAAI,CAAC;IACrB,KAAK,CAAC,EAAE,MAAM,IAAI,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;CACX,GACL,eAAe,CA8BjB"}