@zenithbuild/router 0.6.5 → 0.6.7

package/dist/navigation/client-router.js

@@ -1,373 +0,0 @@
-/**
- * Navigation & Prefetch Runtime
- *
- * Phase 7: Prefetch compiled output, safe SPA navigation, route caching
- *
- * This runtime handles:
- * - Prefetching compiled HTML + JS for routes
- * - Caching prefetched routes
- * - Safe DOM mounting and hydration
- * - Browser history management
- * - Explicit data exposure for navigation
- */
-/**
- * Route cache - stores prefetched compiled output
- */
-const routeCache = new Map();
-/**
- * Current navigation state
- */
-let currentRoute = '';
-let navigationInProgress = false;
-/**
- * Prefetch a route's compiled output
- *
- * @param routePath - The route path to prefetch (e.g., "/dashboard")
- * @returns Promise that resolves when prefetch is complete
- */
-export async function prefetchRoute(routePath) {
-    // Normalize route path
-    const normalizedPath = routePath === '' ? '/' : routePath;
-    // Check if already cached
-    if (routeCache.has(normalizedPath)) {
-        return Promise.resolve();
-    }
-    // In a real implementation, this would fetch from the build output
-    // For Phase 7, we'll generate a placeholder that indicates the route needs to be built
-    try {
-        // Fetch compiled HTML + JS
-        // In production, this would be:
-        // const htmlResponse = await fetch(`${normalizedPath}.html`)
-        // const jsResponse = await fetch(`${normalizedPath}.js`)
-        // For now, return a placeholder that indicates prefetch structure
-        const cacheEntry = {
-            html: `<!-- Prefetched route: ${normalizedPath} -->`,
-            js: `// Prefetched route runtime: ${normalizedPath}`,
-            styles: [],
-            routePath: normalizedPath,
-            compiledAt: Date.now()
-        };
-        routeCache.set(normalizedPath, cacheEntry);
-    }
-    catch (error) {
-        console.warn(`[Zenith] Failed to prefetch route ${normalizedPath}:`, error);
-        throw error;
-    }
-}
-/**
- * Get cached route entry
- */
-export function getCachedRoute(routePath) {
-    const normalizedPath = routePath === '' ? '/' : routePath;
-    return routeCache.get(normalizedPath) || null;
-}
-/**
- * Navigate to a route with explicit data
- *
- * @param routePath - The route path to navigate to
- * @param options - Navigation options with loaderData, props, stores
- */
-export async function navigate(routePath, options = {}) {
-    if (navigationInProgress) {
-        console.warn('[Zenith] Navigation already in progress, skipping');
-        return;
-    }
-    navigationInProgress = true;
-    try {
-        const normalizedPath = routePath === '' ? '/' : routePath;
-        // Check if route is cached, otherwise prefetch
-        let cacheEntry = getCachedRoute(normalizedPath);
-        if (!cacheEntry && options.prefetch !== false) {
-            await prefetchRoute(normalizedPath);
-            cacheEntry = getCachedRoute(normalizedPath);
-        }
-        if (!cacheEntry) {
-            throw new Error(`Route ${normalizedPath} not found. Ensure the route is compiled.`);
-        }
-        // Cleanup previous route
-        cleanupPreviousRoute();
-        // Get router outlet
-        const outlet = getRouterOutlet();
-        if (!outlet) {
-            throw new Error('Router outlet not found. Ensure <div id="zenith-outlet"></div> exists.');
-        }
-        // Mount compiled HTML
-        outlet.innerHTML = cacheEntry.html;
-        // Inject styles
-        injectStyles(cacheEntry.styles);
-        // Execute JS runtime (compiled expressions + hydration)
-        await executeRouteRuntime(cacheEntry.js, {
-            loaderData: options.loaderData || {},
-            props: options.props || {},
-            stores: options.stores || {}
-        });
-        // Update browser history
-        if (typeof window !== 'undefined') {
-            const url = normalizedPath + (window.location.search || '');
-            if (options.replace) {
-                window.history.replaceState({ route: normalizedPath }, '', url);
-            }
-            else {
-                window.history.pushState({ route: normalizedPath }, '', url);
-            }
-        }
-        currentRoute = normalizedPath;
-        // Dispatch navigation event
-        dispatchNavigationEvent(normalizedPath, options);
-    }
-    catch (error) {
-        console.error('[Zenith] Navigation error:', error);
-        throw error;
-    }
-    finally {
-        navigationInProgress = false;
-    }
-}
-/**
- * Cleanup previous route
- */
-function cleanupPreviousRoute() {
-    if (typeof window === 'undefined')
-        return;
-    // Cleanup hydration runtime
-    if (window.zenithCleanup) {
-        ;
-        window.zenithCleanup();
-    }
-    // Remove previous page styles
-    document.querySelectorAll('style[data-zen-route-style]').forEach(style => {
-        style.remove();
-    });
-    // Clear window state (if needed)
-    // State is managed per-route, so we don't clear it here
-}
-/**
- * Get router outlet element
- */
-function getRouterOutlet() {
-    if (typeof window === 'undefined')
-        return null;
-    return document.querySelector('#zenith-outlet') || document.querySelector('[data-zen-outlet]');
-}
-/**
- * Inject route styles
- */
-function injectStyles(styles) {
-    if (typeof window === 'undefined')
-        return;
-    styles.forEach((styleContent, index) => {
-        const style = document.createElement('style');
-        style.setAttribute('data-zen-route-style', String(index));
-        style.textContent = styleContent;
-        document.head.appendChild(style);
-    });
-}
-/**
- * Execute route runtime JS
- *
- * This executes the compiled JS bundle for the route, which includes:
- * - Expression wrappers
- * - Hydration runtime
- * - Event bindings
- */
-async function executeRouteRuntime(jsCode, data) {
-    if (typeof window === 'undefined')
-        return;
-    try {
-        // Execute the compiled JS (which registers expressions and hydration functions)
-        // In a real implementation, this would use a script tag or eval (secure context)
-        const script = document.createElement('script');
-        script.textContent = jsCode;
-        document.head.appendChild(script);
-        document.head.removeChild(script);
-        // After JS executes, call hydrate with explicit data
-        if (window.zenithHydrate) {
-            const state = window.__ZENITH_STATE__ || {};
-            window.zenithHydrate(state, data.loaderData, data.props, data.stores, getRouterOutlet());
-        }
-    }
-    catch (error) {
-        console.error('[Zenith] Error executing route runtime:', error);
-        throw error;
-    }
-}
-/**
- * Dispatch navigation event
- */
-function dispatchNavigationEvent(routePath, options) {
-    if (typeof window === 'undefined')
-        return;
-    const event = new CustomEvent('zenith:navigate', {
-        detail: {
-            route: routePath,
-            loaderData: options.loaderData,
-            props: options.props,
-            stores: options.stores
-        }
-    });
-    window.dispatchEvent(event);
-}
-/**
- * Handle browser back/forward navigation
- */
-export function setupHistoryHandling() {
-    if (typeof window === 'undefined')
-        return;
-    window.addEventListener('popstate', (event) => {
-        const state = event.state;
-        const routePath = state?.route || window.location.pathname;
-        // Navigate without pushing to history (browser already changed it)
-        navigate(routePath, { replace: true, prefetch: false }).catch((error) => {
-            console.error('[Zenith] History navigation error:', error);
-        });
-    });
-}
-/**
- * Generate navigation runtime code (to be included in bundle)
- */
-export function generateNavigationRuntime() {
-    return `
-// Zenith Navigation Runtime (Phase 7)
-(function() {
-  'use strict';
-  
-  // Route cache
-  const __zen_routeCache = new Map();
-  
-  // Current route state
-  let __zen_currentRoute = '';
-  let __zen_navigationInProgress = false;
-  
-  /**
-   * Prefetch a route
-   */
-  async function prefetchRoute(routePath) {
-    const normalizedPath = routePath === '' ? '/' : routePath;
-    
-    if (__zen_routeCache.has(normalizedPath)) {
-      return Promise.resolve();
-    }
-    
-    try {
-      // Fetch compiled HTML + JS
-      // This is a placeholder - in production, fetch from build output
-      const cacheEntry = {
-        html: '<!-- Prefetched: ' + normalizedPath + ' -->',
-        js: '// Prefetched runtime: ' + normalizedPath,
-        styles: [],
-        routePath: normalizedPath,
-        compiledAt: Date.now()
-      };
-      
-      __zen_routeCache.set(normalizedPath, cacheEntry);
-    } catch (error) {
-      console.warn('[Zenith] Prefetch failed:', routePath, error);
-      throw error;
-    }
-  }
-  
-  /**
-   * Navigate to route with explicit data
-   */
-  async function navigate(routePath, options) {
-    options = options || {};
-    
-    if (__zen_navigationInProgress) {
-      console.warn('[Zenith] Navigation in progress');
-      return;
-    }
-    
-    __zen_navigationInProgress = true;
-    
-    try {
-      const normalizedPath = routePath === '' ? '/' : routePath;
-      
-      // Get cached route or prefetch
-      let cacheEntry = __zen_routeCache.get(normalizedPath);
-      if (!cacheEntry && options.prefetch !== false) {
-        await prefetchRoute(normalizedPath);
-        cacheEntry = __zen_routeCache.get(normalizedPath);
-      }
-      
-      if (!cacheEntry) {
-        throw new Error('Route not found: ' + normalizedPath);
-      }
-      
-      // Get outlet
-      const outlet = document.querySelector('#zenith-outlet') || document.querySelector('[data-zen-outlet]');
-      if (!outlet) {
-        throw new Error('Router outlet not found');
-      }
-      
-      // Mount HTML
-      outlet.innerHTML = cacheEntry.html;
-      
-      // Execute runtime JS
-      if (cacheEntry.js) {
-        const script = document.createElement('script');
-        script.textContent = cacheEntry.js;
-        document.head.appendChild(script);
-        document.head.removeChild(script);
-      }
-      
-      // Hydrate with explicit data
-      if (window.zenithHydrate) {
-        const state = window.__ZENITH_STATE__ || {};
-        window.zenithHydrate(
-          state,
-          options.loaderData || {},
-          options.props || {},
-          options.stores || {},
-          outlet
-        );
-      }
-      
-      // Update history
-      const url = normalizedPath + (window.location.search || '');
-      if (options.replace) {
-        window.history.replaceState({ route: normalizedPath }, '', url);
-      } else {
-        window.history.pushState({ route: normalizedPath }, '', url);
-      }
-      
-      __zen_currentRoute = normalizedPath;
-      
-      // Dispatch event
-      window.dispatchEvent(new CustomEvent('zenith:navigate', {
-        detail: { route: normalizedPath, options: options }
-      }));
-    } catch (error) {
-      console.error('[Zenith] Navigation error:', error);
-      throw error;
-    } finally {
-      __zen_navigationInProgress = false;
-    }
-  }
-  
-  /**
-   * Handle browser history
-   */
-  function setupHistoryHandling() {
-    window.addEventListener('popstate', function(event) {
-      const state = event.state;
-      const routePath = state && state.route ? state.route : window.location.pathname;
-      
-      navigate(routePath, { replace: true, prefetch: false }).catch(function(error) {
-        console.error('[Zenith] History navigation error:', error);
-      });
-    });
-  }
-  
-  // Initialize history handling
-  setupHistoryHandling();
-  
-  // Expose API
-  if (typeof window !== 'undefined') {
-    window.__zenith_navigate = navigate;
-    window.__zenith_prefetch = prefetchRoute;
-    window.navigate = navigate; // Global convenience
-  }
-})();
-`;
-}
-//# sourceMappingURL=client-router.js.map

package/dist/navigation/client-router.js.map

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

package/dist/navigation/index.d.ts

@@ -1,30 +0,0 @@
-/**
- * Zenith Navigation System
- *
- * Provides SPA navigation utilities and the ZenLink API.
- *
- * @package @zenithbuild/router
- *
- * @example
- * ```ts
- * import { navigate, isActive, prefetch, zenLink } from '@zenithbuild/router/navigation'
- *
- * // Programmatic navigation
- * navigate('/about')
- *
- * // Check active state
- * if (isActive('/blog')) {
- *   console.log('On blog section')
- * }
- *
- * // Prefetch for faster navigation
- * prefetch('/dashboard')
- *
- * // Create link programmatically
- * const link = zenLink({ href: '/contact', children: 'Contact' })
- * ```
- */
-export { zenNavigate, navigate, zenBack, back, zenForward, forward, zenGo, go, zenIsActive, isActive, zenPrefetch, prefetch, zenIsPrefetched, isPrefetched, setGlobalTransition, getGlobalTransition, createTransitionContext, zenGetRoute, getRoute, zenGetParam, getParam, zenGetQuery, getQuery, createZenLink, zenLink, isExternalUrl, shouldUseSPANavigation, normalizePath } from './zen-link';
-export * from './client-router';
-export type { ZenLinkProps, TransitionContext, TransitionHandler, NavigateOptions } from './zen-link';
-//# sourceMappingURL=index.d.ts.map

package/dist/navigation/index.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/navigation/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAGH,OAAO,EAEH,WAAW,EACX,QAAQ,EACR,OAAO,EACP,IAAI,EACJ,UAAU,EACV,OAAO,EACP,KAAK,EACL,EAAE,EAGF,WAAW,EACX,QAAQ,EAGR,WAAW,EACX,QAAQ,EACR,eAAe,EACf,YAAY,EAGZ,mBAAmB,EACnB,mBAAmB,EACnB,uBAAuB,EAGvB,WAAW,EACX,QAAQ,EACR,WAAW,EACX,QAAQ,EACR,WAAW,EACX,QAAQ,EAGR,aAAa,EACb,OAAO,EAGP,aAAa,EACb,sBAAsB,EACtB,aAAa,EAChB,MAAM,YAAY,CAAA;AAEnB,cAAc,iBAAiB,CAAA;AAG/B,YAAY,EACR,YAAY,EACZ,iBAAiB,EACjB,iBAAiB,EACjB,eAAe,EAClB,MAAM,YAAY,CAAA"}

package/dist/navigation/index.js

@@ -1,44 +0,0 @@
-/**
- * Zenith Navigation System
- *
- * Provides SPA navigation utilities and the ZenLink API.
- *
- * @package @zenithbuild/router
- *
- * @example
- * ```ts
- * import { navigate, isActive, prefetch, zenLink } from '@zenithbuild/router/navigation'
- *
- * // Programmatic navigation
- * navigate('/about')
- *
- * // Check active state
- * if (isActive('/blog')) {
- *   console.log('On blog section')
- * }
- *
- * // Prefetch for faster navigation
- * prefetch('/dashboard')
- *
- * // Create link programmatically
- * const link = zenLink({ href: '/contact', children: 'Contact' })
- * ```
- */
-// Export all navigation utilities
-export { 
-// Navigation API
-zenNavigate, navigate, zenBack, back, zenForward, forward, zenGo, go, 
-// Active state
-zenIsActive, isActive, 
-// Prefetching
-zenPrefetch, prefetch, zenIsPrefetched, isPrefetched, 
-// Transitions API
-setGlobalTransition, getGlobalTransition, createTransitionContext, 
-// Route state
-zenGetRoute, getRoute, zenGetParam, getParam, zenGetQuery, getQuery, 
-// ZenLink factory
-createZenLink, zenLink, 
-// Utilities
-isExternalUrl, shouldUseSPANavigation, normalizePath } from './zen-link';
-export * from './client-router';
-//# sourceMappingURL=index.js.map

package/dist/navigation/index.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/navigation/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAEH,kCAAkC;AAClC,OAAO;AACH,iBAAiB;AACjB,WAAW,EACX,QAAQ,EACR,OAAO,EACP,IAAI,EACJ,UAAU,EACV,OAAO,EACP,KAAK,EACL,EAAE;AAEF,eAAe;AACf,WAAW,EACX,QAAQ;AAER,cAAc;AACd,WAAW,EACX,QAAQ,EACR,eAAe,EACf,YAAY;AAEZ,kBAAkB;AAClB,mBAAmB,EACnB,mBAAmB,EACnB,uBAAuB;AAEvB,cAAc;AACd,WAAW,EACX,QAAQ,EACR,WAAW,EACX,QAAQ,EACR,WAAW,EACX,QAAQ;AAER,kBAAkB;AAClB,aAAa,EACb,OAAO;AAEP,YAAY;AACZ,aAAa,EACb,sBAAsB,EACtB,aAAa,EAChB,MAAM,YAAY,CAAA;AAEnB,cAAc,iBAAiB,CAAA"}

package/dist/navigation/zen-link.d.ts

@@ -1,234 +0,0 @@
-/**
- * ZenLink Runtime Module
- *
- * Provides programmatic navigation and ZenLink utilities.
- * This module can be imported in `.zen` files or TypeScript.
- *
- * @package @zenithbuild/router
- *
- * @example
- * ```ts
- * import { navigate, zenLink, isActive } from '@zenithbuild/router'
- *
- * // Programmatic navigation
- * navigate('/about')
- *
- * // Check active state
- * if (isActive('/blog')) {
- *   console.log('On blog section')
- * }
- * ```
- */
-/**
- * Props for ZenLink component
- */
-export interface ZenLinkProps {
-    /** Target URL path */
-    href: string;
-    /** Optional CSS class(es) */
-    class?: string;
-    /** Link target (_blank, _self, etc.) */
-    target?: '_blank' | '_self' | '_parent' | '_top';
-    /** Click handler (called before navigation) */
-    onClick?: (event: MouseEvent) => void | boolean;
-    /** Preload the linked page on hover */
-    preload?: boolean;
-    /** Future: Transition configuration */
-    onTransition?: TransitionHandler;
-    /** Future: Disable page transition animation */
-    noTransition?: boolean;
-    /** Match exact path for active state */
-    exact?: boolean;
-    /** Additional aria attributes */
-    ariaLabel?: string;
-    /** Replace history instead of push */
-    replace?: boolean;
-    /** Link content (children) */
-    children?: string | HTMLElement | HTMLElement[];
-}
-/**
- * Transition context for Transitions API
- */
-export interface TransitionContext {
-    /** Current page element */
-    currentPage: HTMLElement | null;
-    /** Next page element (after load) */
-    nextPage: HTMLElement | null;
-    /** Between/loading page element */
-    betweenPage: HTMLElement | null;
-    /** Navigation direction */
-    direction: 'forward' | 'back';
-    /** Origin path */
-    fromPath: string;
-    /** Destination path */
-    toPath: string;
-    /** Route params */
-    params: Record<string, string>;
-    /** Query params */
-    query: Record<string, string>;
-}
-/**
- * Transition handler function
- */
-export type TransitionHandler = (context: TransitionContext) => void | Promise<void>;
-/**
- * Navigation options
- */
-export interface NavigateOptions {
-    /** Replace current history entry instead of pushing */
-    replace?: boolean;
-    /** Scroll to top after navigation */
-    scrollToTop?: boolean;
-    /** Transition handler for this navigation */
-    onTransition?: TransitionHandler;
-    /** Skip transition animation */
-    noTransition?: boolean;
-    /** State to pass to the next page */
-    state?: Record<string, unknown>;
-}
-/**
- * Check if URL is external (different origin)
- */
-export declare function isExternalUrl(url: string): boolean;
-/**
- * Check if link should use SPA navigation
- */
-export declare function shouldUseSPANavigation(href: string, target?: string): boolean;
-/**
- * Normalize a path
- */
-export declare function normalizePath(path: string): string;
-/**
- * Navigate to a new URL (SPA navigation)
- *
- * This is the primary API for programmatic navigation.
- *
- * @example
- * ```ts
- * // Simple navigation
- * navigate('/about')
- *
- * // With options
- * navigate('/dashboard', { replace: true })
- *
- * // With transition
- * navigate('/gallery', {
- *   onTransition: async (ctx) => {
- *     await animateOut(ctx.currentPage)
- *     await animateIn(ctx.nextPage)
- *   }
- * })
- * ```
- */
-export declare function zenNavigate(to: string, options?: NavigateOptions): Promise<void>;
-export declare const navigate: typeof zenNavigate;
-/**
- * Navigate back in history
- */
-export declare function zenBack(): void;
-export declare const back: typeof zenBack;
-/**
- * Navigate forward in history
- */
-export declare function zenForward(): void;
-export declare const forward: typeof zenForward;
-/**
- * Navigate to a specific history index
- */
-export declare function zenGo(delta: number): void;
-export declare const go: typeof zenGo;
-/**
- * Check if a path is currently active
- *
- * @example
- * ```ts
- * // Check if on blog section
- * if (isActive('/blog')) {
- *   addClass(link, 'active')
- * }
- *
- * // Exact match only
- * if (isActive('/blog', true)) {
- *   addClass(link, 'active-exact')
- * }
- * ```
- */
-export declare function zenIsActive(path: string, exact?: boolean): boolean;
-export declare const isActive: typeof zenIsActive;
-/**
- * Prefetch a route for faster navigation
- *
- * @example
- * ```ts
- * // Prefetch on hover
- * element.addEventListener('mouseenter', () => {
- *   prefetch('/about')
- * })
- * ```
- */
-export declare function zenPrefetch(path: string): Promise<void>;
-export declare const prefetch: typeof zenPrefetch;
-/**
- * Check if a route has been prefetched
- */
-export declare function zenIsPrefetched(path: string): boolean;
-export declare const isPrefetched: typeof zenIsPrefetched;
-/**
- * Set global transition handler
- *
- * This allows setting a layout-level transition that applies to all navigations.
- *
- * @example
- * ```ts
- * // In layout component
- * setGlobalTransition(async (ctx) => {
- *   ctx.currentPage?.classList.add('fade-out')
- *   await delay(300)
- *   ctx.nextPage?.classList.add('fade-in')
- * })
- * ```
- */
-export declare function setGlobalTransition(handler: TransitionHandler | null): void;
-/**
- * Get current global transition handler
- */
-export declare function getGlobalTransition(): TransitionHandler | null;
-/**
- * Create a transition context
- */
-export declare function createTransitionContext(fromPath: string, toPath: string, direction?: 'forward' | 'back'): TransitionContext;
-/**
- * Get current route state
- */
-export declare function zenGetRoute(): {
-    path: string;
-    params: Record<string, string>;
-    query: Record<string, string>;
-};
-export declare const getRoute: typeof zenGetRoute;
-/**
- * Get a route parameter
- */
-export declare function zenGetParam(name: string): string | undefined;
-export declare const getParam: typeof zenGetParam;
-/**
- * Get a query parameter
- */
-export declare function zenGetQuery(name: string): string | undefined;
-export declare const getQuery: typeof zenGetQuery;
-/**
- * Create a ZenLink element programmatically
- *
- * @example
- * ```ts
- * const link = createZenLink({
- *   href: '/about',
- *   class: 'nav-link',
- *   children: 'About Us'
- * })
- * container.appendChild(link)
- * ```
- */
-export declare function createZenLink(props: ZenLinkProps): HTMLAnchorElement;
-export declare const zenLink: typeof createZenLink;
-//# sourceMappingURL=zen-link.d.ts.map