@liteforge/router 0.1.0

package/dist/components.js

@@ -0,0 +1,475 @@
+import { effect } from '@liteforge/core';
+import { use, pushContext, popContext, isComponentFactory } from '@liteforge/runtime';
+import { isPathActive } from './route-matcher.js';
+import { isLazyComponent, getLazyDelay, getLazyLoading, getLazyError } from './lazy.js';
+/**
+ * RouterOutlet renders the component for the current matched route.
+ *
+ * For nested routes, each RouterOutlet tracks its depth and renders
+ * the appropriate level of the route match chain.
+ *
+ * @example
+ * ```ts
+ * // Basic usage
+ * const outlet = RouterOutlet();
+ *
+ * // With fallback for no match
+ * const outlet = RouterOutlet({ fallback: () => document.createTextNode('Not Found') });
+ * ```
+ */
+export function RouterOutlet(config = {}) {
+    const { fallback } = config;
+    // Get router from context
+    let router;
+    try {
+        router = use('router');
+    }
+    catch {
+        throw new Error('RouterOutlet requires a router in context. Make sure to use createApp with a router.');
+    }
+    // Get current outlet depth (default 0 for top-level)
+    let depth;
+    try {
+        depth = use('router:outlet-depth') ?? 0;
+    }
+    catch {
+        depth = 0;
+    }
+    // Create a container for the outlet
+    const container = document.createDocumentFragment();
+    // Placeholder comment node for positioning
+    const placeholder = document.createComment(`router-outlet:${depth}`);
+    container.appendChild(placeholder);
+    // Track current mounted component/node
+    let currentInstance = null;
+    let currentNode = null;
+    let parentNode = null;
+    // Track current route to avoid remounting same component on child navigation
+    // We compare routes (not components) because compiled routes are stable references
+    let currentRoute = null;
+    // Cleanup function for effect
+    let cleanupEffect = null;
+    // Navigation ID for race condition handling
+    let navigationId = 0;
+    // Delay timer ID
+    let delayTimerId = null;
+    /**
+     * Clear delay timer if active
+     */
+    function clearDelayTimer() {
+        if (delayTimerId !== null) {
+            clearTimeout(delayTimerId);
+            delayTimerId = null;
+        }
+    }
+    /**
+     * Unmount current content
+     * Note: Does NOT reset currentComponent - that's managed by renderComponent()
+     */
+    function unmountCurrent() {
+        clearDelayTimer();
+        if (currentInstance) {
+            currentInstance.unmount();
+            currentInstance = null;
+        }
+        if (currentNode && currentNode.parentNode) {
+            currentNode.parentNode.removeChild(currentNode);
+            currentNode = null;
+        }
+    }
+    /**
+     * Mount a node at the outlet position
+     */
+    function mountNode(node) {
+        parentNode = placeholder.parentNode;
+        if (!parentNode)
+            return;
+        // Remove current node if any (without full unmount)
+        if (currentNode && currentNode.parentNode) {
+            currentNode.parentNode.removeChild(currentNode);
+        }
+        parentNode.insertBefore(node, placeholder.nextSibling);
+        currentNode = node;
+    }
+    /**
+     * Render a sync route component
+     */
+    function renderSyncComponent(component, props) {
+        unmountCurrent();
+        parentNode = placeholder.parentNode;
+        if (!parentNode)
+            return;
+        // Check if it's a ComponentFactory
+        if (isComponentFactory(component)) {
+            pushContext({ 'router:outlet-depth': depth + 1 });
+            try {
+                currentInstance = component(props);
+                const tempContainer = document.createElement('div');
+                currentInstance.mount(tempContainer);
+                const mountedNode = tempContainer.firstChild;
+                if (mountedNode) {
+                    parentNode.insertBefore(mountedNode, placeholder.nextSibling);
+                    currentNode = mountedNode;
+                }
+            }
+            finally {
+                popContext();
+            }
+        }
+        else if (typeof component === 'function') {
+            pushContext({ 'router:outlet-depth': depth + 1 });
+            try {
+                // Call with props - some components expect them
+                const result = component(props);
+                currentNode = result;
+                parentNode.insertBefore(currentNode, placeholder.nextSibling);
+            }
+            finally {
+                popContext();
+            }
+        }
+    }
+    /**
+     * Render a route component (sync or lazy)
+     */
+    function renderComponent(route, component, props) {
+        // Same route as currently rendered → don't remount
+        // This is critical for nested routes: when navigating /dashboard → /dashboard/users,
+        // the parent layout (depth 0) stays mounted, only the child outlet (depth 1) updates
+        // We compare routes (not components) because compiled routes are stable references
+        if (route === currentRoute) {
+            return;
+        }
+        currentRoute = route;
+        // Increment navigation ID to invalidate any pending loads
+        // This must happen AFTER the route check, so same-route calls don't invalidate
+        navigationId++;
+        const thisNavigationId = navigationId;
+        // Check if it's a lazy component
+        if (isLazyComponent(component)) {
+            // Check if already loaded - use SYNCHRONOUS getLoaded() to avoid microtask race
+            const loadedComponent = component.getLoaded();
+            if (loadedComponent) {
+                // Already loaded - render SYNCHRONOUSLY (no .then(), no microtask)
+                renderSyncComponent(loadedComponent, props);
+                return;
+            }
+            // Not loaded yet - handle lazy loading with delay
+            handleLazyComponent(component, props, thisNavigationId);
+            return;
+        }
+        // Check if it's a ComponentFactory (from createComponent)
+        if (isComponentFactory(component)) {
+            renderSyncComponent(component, props);
+            return;
+        }
+        // It's a plain function (either sync or lazy loader without our wrapper)
+        if (typeof component === 'function') {
+            pushContext({ 'router:outlet-depth': depth + 1 });
+            try {
+                // Call with props - component may expect them
+                const result = component(props);
+                if (result instanceof Promise) {
+                    popContext();
+                    // Plain lazy loader - handle without delay features
+                    handlePlainLazyComponent(result, props, thisNavigationId);
+                }
+                else {
+                    unmountCurrent();
+                    parentNode = placeholder.parentNode;
+                    if (parentNode) {
+                        currentNode = result;
+                        parentNode.insertBefore(currentNode, placeholder.nextSibling);
+                    }
+                    popContext();
+                }
+            }
+            catch (error) {
+                popContext();
+                throw error;
+            }
+        }
+    }
+    /**
+     * Handle lazy-loaded component with delay behavior
+     */
+    function handleLazyComponent(lazyComponent, props, navId) {
+        const delay = getLazyDelay(lazyComponent);
+        const loadingFn = getLazyLoading(lazyComponent);
+        const errorFn = getLazyError(lazyComponent);
+        // Set up delay timer for showing loading state
+        if (delay > 0 && loadingFn) {
+            clearDelayTimer();
+            delayTimerId = setTimeout(() => {
+                if (navigationId !== navId)
+                    return; // Stale navigation
+                // Show loading state after delay
+                const loadingNode = loadingFn();
+                mountNode(loadingNode);
+            }, delay);
+        }
+        else if (delay === 0 && loadingFn) {
+            // Show loading immediately (delay = 0)
+            unmountCurrent();
+            parentNode = placeholder.parentNode;
+            if (parentNode) {
+                const loadingNode = loadingFn();
+                parentNode.insertBefore(loadingNode, placeholder.nextSibling);
+                currentNode = loadingNode;
+            }
+        }
+        // Start loading the component
+        lazyComponent().then(module => {
+            clearDelayTimer();
+            if (navigationId !== navId)
+                return; // Stale navigation
+            const loadedComponent = 'default' in module ? module.default : module;
+            renderSyncComponent(loadedComponent, props);
+        }).catch((error) => {
+            clearDelayTimer();
+            if (navigationId !== navId)
+                return; // Stale navigation
+            const err = error instanceof Error ? error : new Error(String(error));
+            console.error('Failed to load lazy component:', err);
+            if (errorFn) {
+                // Show error state with retry
+                const retry = () => {
+                    lazyComponent.reset();
+                    handleLazyComponent(lazyComponent, props, navigationId);
+                };
+                unmountCurrent();
+                parentNode = placeholder.parentNode;
+                if (parentNode) {
+                    const errorNode = errorFn(err, retry);
+                    parentNode.insertBefore(errorNode, placeholder.nextSibling);
+                    currentNode = errorNode;
+                }
+            }
+        });
+    }
+    /**
+     * Handle plain lazy component (without our wrapper)
+     */
+    async function handlePlainLazyComponent(promise, props, navId) {
+        try {
+            const module = await promise;
+            if (navigationId !== navId)
+                return; // Stale navigation
+            const component = 'default' in module ? module.default : module;
+            renderSyncComponent(component, props);
+        }
+        catch (error) {
+            if (navigationId !== navId)
+                return; // Stale navigation
+            console.error('Failed to load lazy component:', error);
+        }
+    }
+    /**
+     * Render fallback content
+     */
+    function renderFallback() {
+        unmountCurrent();
+        if (fallback) {
+            parentNode = placeholder.parentNode;
+            if (parentNode) {
+                currentNode = fallback();
+                parentNode.insertBefore(currentNode, placeholder.nextSibling);
+            }
+        }
+    }
+    // Set up effect to watch route changes
+    // We need to defer this until the placeholder is in the DOM
+    const originalPlaceholder = placeholder;
+    // Use MutationObserver to detect when we're added to DOM
+    if (typeof MutationObserver !== 'undefined') {
+        const observer = new MutationObserver(() => {
+            if (originalPlaceholder.parentNode) {
+                observer.disconnect();
+                setupRouteWatcher();
+            }
+        });
+        // Observe the document for changes
+        observer.observe(document, { childList: true, subtree: true });
+        // Also check immediately in case we're already in DOM
+        if (originalPlaceholder.parentNode) {
+            observer.disconnect();
+            // Use setTimeout to ensure context is properly set up
+            setTimeout(setupRouteWatcher, 0);
+        }
+    }
+    else {
+        // Fallback for environments without MutationObserver
+        setTimeout(setupRouteWatcher, 0);
+    }
+    function setupRouteWatcher() {
+        cleanupEffect = effect(() => {
+            const matched = router.matched();
+            const preloadedData = router.preloadedData();
+            const params = router.params();
+            const query = router.query();
+            // Get the match at our depth level
+            const matchAtDepth = matched[depth];
+            if (!matchAtDepth) {
+                // No match at this depth
+                renderFallback();
+                return;
+            }
+            const { route } = matchAtDepth;
+            const component = route.component;
+            if (!component) {
+                // Route has no component (might be redirect-only)
+                renderFallback();
+                return;
+            }
+            // Build props for the route component
+            const componentProps = {
+                params,
+                query,
+                preloaded: preloadedData,
+            };
+            renderComponent(route, component, componentProps);
+        });
+    }
+    // Return a node that cleans up when removed
+    // We wrap the placeholder in a custom behavior
+    const result = placeholder;
+    // Store cleanup function on the node for later access
+    result.__cleanup = () => {
+        if (cleanupEffect) {
+            cleanupEffect();
+            cleanupEffect = null;
+        }
+        unmountCurrent();
+    };
+    return result;
+}
+/**
+ * Link creates an anchor element with client-side navigation.
+ *
+ * @example
+ * ```ts
+ * // Basic link
+ * const link = Link({ href: '/about', children: 'About Us' });
+ *
+ * // With active class
+ * const navLink = Link({
+ *   href: '/users',
+ *   children: 'Users',
+ *   activeClass: 'nav-active',
+ *   exactActiveClass: 'nav-exact',
+ * });
+ * ```
+ */
+export function Link(config) {
+    const { href, children, activeClass = 'active', exactActiveClass = 'exact-active', exact = false, class: className, replace = false, target, attrs = {}, preload, } = config;
+    // Get router from context
+    let router;
+    try {
+        router = use('router');
+    }
+    catch {
+        throw new Error('Link requires a router in context. Make sure to use createApp with a router.');
+    }
+    // Create anchor element
+    const anchor = document.createElement('a');
+    anchor.href = href;
+    // Set children
+    if (typeof children === 'string') {
+        anchor.textContent = children;
+    }
+    else {
+        anchor.appendChild(children);
+    }
+    // Set static class
+    if (className) {
+        anchor.className = className;
+    }
+    // Set target
+    if (target) {
+        anchor.target = target;
+    }
+    // Set additional attributes
+    for (const [key, value] of Object.entries(attrs)) {
+        anchor.setAttribute(key, value);
+    }
+    // Track if preload has been triggered (only do it once)
+    let preloadTriggered = false;
+    // Handle preload on hover
+    if (preload) {
+        anchor.addEventListener('mouseenter', () => {
+            if (preloadTriggered)
+                return;
+            preloadTriggered = true;
+            // If preload is a LazyComponent, prefetch it directly
+            if (preload !== true && isLazyComponent(preload)) {
+                preload.prefetch();
+                return;
+            }
+            // If preload is true, try to find the route's lazy component
+            const resolved = router.resolve(href);
+            const routeComponent = resolved.route?.component;
+            if (routeComponent && isLazyComponent(routeComponent)) {
+                routeComponent.prefetch();
+            }
+        });
+    }
+    // Handle click for client-side navigation
+    anchor.addEventListener('click', (event) => {
+        // Don't handle if modifier keys are pressed (allow new tab)
+        if (event.metaKey || event.ctrlKey || event.shiftKey || event.altKey) {
+            return;
+        }
+        // Don't handle if target is _blank
+        if (anchor.target === '_blank') {
+            return;
+        }
+        // Don't handle external links
+        if (anchor.origin !== window.location.origin) {
+            return;
+        }
+        // Prevent default browser navigation
+        event.preventDefault();
+        // Navigate using router
+        if (replace) {
+            router.replace(href);
+        }
+        else {
+            router.navigate(href);
+        }
+    });
+    // Set up effect to manage active classes
+    const disposeEffect = effect(() => {
+        const currentPath = router.path();
+        // Check for exact match
+        const isExactActive = isPathActive(currentPath, href, true);
+        // Check for active match (exact if `exact` prop is true, otherwise prefix match)
+        const isActive = exact
+            ? isExactActive
+            : isPathActive(currentPath, href, false);
+        // Manage exact active class
+        if (isExactActive) {
+            anchor.classList.add(exactActiveClass);
+        }
+        else {
+            anchor.classList.remove(exactActiveClass);
+        }
+        // Manage active class
+        if (isActive) {
+            anchor.classList.add(activeClass);
+        }
+        else {
+            anchor.classList.remove(activeClass);
+        }
+    });
+    // Store cleanup function on the element
+    anchor.__cleanup = disposeEffect;
+    return anchor;
+}
+// =============================================================================
+// NavLink (Convenience Alias)
+// =============================================================================
+/**
+ * NavLink is an alias for Link with navigation-focused defaults.
+ */
+export const NavLink = Link;
+//# sourceMappingURL=components.js.map

package/dist/components.js.map

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

package/dist/guards.d.ts

@@ -0,0 +1,103 @@
+import type { RouteGuard, GuardFunction, GuardContext, GuardResult, CompiledRoute, NavigationTarget } from './types.js';
+/**
+ * Define a named route guard
+ *
+ * @example
+ * ```ts
+ * const authGuard = defineGuard('auth', ({ to, from, use }) => {
+ *   const auth = use('auth');
+ *   if (!auth.isAuthenticated()) {
+ *     return `/login?redirect=${encodeURIComponent(to.path)}`;
+ *   }
+ *   return true;
+ * });
+ *
+ * // Parameterized guard
+ * const roleGuard = defineGuard('role', ({ use, param }) => {
+ *   return use('auth').hasRole(param) || '/unauthorized';
+ * });
+ * ```
+ */
+export declare function defineGuard(name: string, handler: GuardFunction): RouteGuard;
+/**
+ * Guard registry for managing named guards
+ */
+export declare class GuardRegistry {
+    private guards;
+    /**
+     * Register a guard
+     */
+    register(guard: RouteGuard): void;
+    /**
+     * Register multiple guards
+     */
+    registerAll(guards: RouteGuard[]): void;
+    /**
+     * Get a guard by name
+     */
+    get(name: string): RouteGuard | undefined;
+    /**
+     * Check if a guard exists
+     */
+    has(name: string): boolean;
+    /**
+     * Unregister a guard
+     */
+    unregister(name: string): boolean;
+    /**
+     * Get all guard names
+     */
+    names(): string[];
+    /**
+     * Clear all guards
+     */
+    clear(): void;
+    /**
+     * Get the internal map (for route compilation)
+     */
+    getMap(): Map<string, RouteGuard>;
+}
+/**
+ * Normalize guard result to a consistent format
+ */
+export declare function normalizeGuardResult(result: GuardResult): {
+    allowed: boolean;
+    redirect?: NavigationTarget;
+};
+/**
+ * Run all guards for a route match
+ * Guards are run in order; first failing guard stops execution
+ */
+export declare function runGuards(guards: RouteGuard[], context: Omit<GuardContext, 'param'>): Promise<{
+    allowed: boolean;
+    redirect?: NavigationTarget;
+}>;
+/**
+ * Resolve guards from guard specification using the registry
+ * This is called at navigation time to support dynamic guard registration
+ */
+export declare function resolveGuardsFromSpec(guardSpec: CompiledRoute['guardSpec'], registry: GuardRegistry): RouteGuard[];
+/**
+ * Collect all guards for a matched route chain
+ * (including parent route guards for nested routes)
+ * Resolves string guards from the registry at runtime
+ */
+export declare function collectRouteGuards(route: CompiledRoute, registry?: GuardRegistry): RouteGuard[];
+/**
+ * Create a simple authentication guard
+ */
+export declare function createAuthGuard(isAuthenticated: () => boolean, loginPath?: string): RouteGuard;
+/**
+ * Create a role-based guard
+ * Usage: guard: 'role:admin' or guard: 'role:editor'
+ */
+export declare function createRoleGuard(hasRole: (role: string) => boolean, unauthorizedPath?: string): RouteGuard;
+/**
+ * Create a confirmation guard that can be used for unsaved changes
+ */
+export declare function createConfirmGuard(shouldConfirm: () => boolean, message?: string): RouteGuard;
+/**
+ * Create a guest-only guard (redirects authenticated users)
+ */
+export declare function createGuestGuard(isAuthenticated: () => boolean, homePath?: string): RouteGuard;
+//# sourceMappingURL=guards.d.ts.map

package/dist/guards.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"guards.d.ts","sourceRoot":"","sources":["../src/guards.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,UAAU,EACV,aAAa,EACb,YAAY,EACZ,WAAW,EACX,aAAa,EACb,gBAAgB,EACjB,MAAM,YAAY,CAAC;AAMpB;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,aAAa,GAAG,UAAU,CAE5E;AAMD;;GAEG;AACH,qBAAa,aAAa;IACxB,OAAO,CAAC,MAAM,CAAiC;IAE/C;;OAEG;IACH,QAAQ,CAAC,KAAK,EAAE,UAAU,GAAG,IAAI;IAOjC;;OAEG;IACH,WAAW,CAAC,MAAM,EAAE,UAAU,EAAE,GAAG,IAAI;IAMvC;;OAEG;IACH,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,UAAU,GAAG,SAAS;IAIzC;;OAEG;IACH,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAI1B;;OAEG;IACH,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAIjC;;OAEG;IACH,KAAK,IAAI,MAAM,EAAE;IAIjB;;OAEG;IACH,KAAK,IAAI,IAAI;IAIb;;OAEG;IACH,MAAM,IAAI,GAAG,CAAC,MAAM,EAAE,UAAU,CAAC;CAGlC;AAmCD;;GAEG;AACH,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,WAAW,GAClB;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,QAAQ,CAAC,EAAE,gBAAgB,CAAA;CAAE,CAWnD;AAED;;;GAGG;AACH,wBAAsB,SAAS,CAC7B,MAAM,EAAE,UAAU,EAAE,EACpB,OAAO,EAAE,IAAI,CAAC,YAAY,EAAE,OAAO,CAAC,GACnC,OAAO,CAAC;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,QAAQ,CAAC,EAAE,gBAAgB,CAAA;CAAE,CAAC,CAS5D;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CACnC,SAAS,EAAE,aAAa,CAAC,WAAW,CAAC,EACrC,QAAQ,EAAE,aAAa,GACtB,UAAU,EAAE,CAiCd;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,aAAa,EAAE,QAAQ,CAAC,EAAE,aAAa,GAAG,UAAU,EAAE,CAgC/F;AAMD;;GAEG;AACH,wBAAgB,eAAe,CAC7B,eAAe,EAAE,MAAM,OAAO,EAC9B,SAAS,GAAE,MAAiB,GAC3B,UAAU,CASZ;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAC7B,OAAO,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,EAClC,gBAAgB,GAAE,MAAwB,GACzC,UAAU,CAQZ;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAChC,aAAa,EAAE,MAAM,OAAO,EAC5B,OAAO,GAAE,MAAoE,GAC5E,UAAU,CAYZ;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAC9B,eAAe,EAAE,MAAM,OAAO,EAC9B,QAAQ,GAAE,MAAY,GACrB,UAAU,CAOZ"}