@zenithbuild/router 1.3.9 → 1.3.18

package/dist/index.d.ts

@@ -0,0 +1,41 @@
+/**
+ * @zenithbuild/router
+ *
+ * File-based SPA router for Zenith framework.
+ * Includes routing, navigation, and ZenLink components.
+ *
+ * Features:
+ * - Deterministic, compile-time route resolution
+ * - File-based routing (pages/ directory → routes)
+ * - SPA navigation with prefetching
+ * - ZenLink component for declarative links
+ * - Type-safe route parameters
+ * - Hydration-safe, no runtime hacks
+ *
+ * @example
+ * ```ts
+ * import { navigate, isActive, prefetch } from '@zenithbuild/router'
+ *
+ * // Navigate programmatically
+ * navigate('/about')
+ *
+ * // Check active state
+ * if (isActive('/blog')) {
+ *   console.log('On blog section')
+ * }
+ * ```
+ *
+ * @example
+ * ```ts
+ * // Build-time manifest generation
+ * import { generateRouteManifest, discoverPages } from '@zenithbuild/router/manifest'
+ *
+ * const manifest = generateRouteManifest('./src/pages')
+ * ```
+ */
+export * from "./types";
+export { generateRouteManifest, generateRouteManifestCode } from "./manifest";
+export { initRouter, resolveRoute, navigate, getRoute, onRouteChange, isActive, prefetch, isPrefetched, generateRuntimeRouterCode, zenRoute } from "./runtime";
+export { zenNavigate, zenBack, zenForward, zenGo, zenIsActive, zenPrefetch, zenIsPrefetched, zenGetRoute, zenGetParam, zenGetQuery, createZenLink, zenLink, back, forward, go, getParam, getQuery, isExternalUrl, shouldUseSPANavigation, normalizePath, setGlobalTransition, getGlobalTransition, createTransitionContext } from "./navigation/index";
+export type { ZenLinkProps, TransitionContext, TransitionHandler } from "./navigation/index";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AAMH,cAAc,SAAS,CAAA;AAMvB,OAAO,EACH,qBAAqB,EACrB,yBAAyB,EAC5B,MAAM,YAAY,CAAA;AAMnB,OAAO,EACH,UAAU,EACV,YAAY,EACZ,QAAQ,EACR,QAAQ,EACR,aAAa,EACb,QAAQ,EACR,QAAQ,EACR,YAAY,EACZ,yBAAyB,EACzB,QAAQ,EACX,MAAM,WAAW,CAAA;AAMlB,OAAO,EAEH,WAAW,EACX,OAAO,EACP,UAAU,EACV,KAAK,EACL,WAAW,EACX,WAAW,EACX,eAAe,EACf,WAAW,EACX,WAAW,EACX,WAAW,EACX,aAAa,EACb,OAAO,EAEP,IAAI,EACJ,OAAO,EACP,EAAE,EACF,QAAQ,EACR,QAAQ,EACR,aAAa,EACb,sBAAsB,EACtB,aAAa,EACb,mBAAmB,EACnB,mBAAmB,EACnB,uBAAuB,EAC1B,MAAM,oBAAoB,CAAA;AAM3B,YAAY,EACR,YAAY,EACZ,iBAAiB,EACjB,iBAAiB,EACpB,MAAM,oBAAoB,CAAA"}

package/dist/index.js

@@ -0,0 +1,56 @@
+/**
+ * @zenithbuild/router
+ *
+ * File-based SPA router for Zenith framework.
+ * Includes routing, navigation, and ZenLink components.
+ *
+ * Features:
+ * - Deterministic, compile-time route resolution
+ * - File-based routing (pages/ directory → routes)
+ * - SPA navigation with prefetching
+ * - ZenLink component for declarative links
+ * - Type-safe route parameters
+ * - Hydration-safe, no runtime hacks
+ *
+ * @example
+ * ```ts
+ * import { navigate, isActive, prefetch } from '@zenithbuild/router'
+ *
+ * // Navigate programmatically
+ * navigate('/about')
+ *
+ * // Check active state
+ * if (isActive('/blog')) {
+ *   console.log('On blog section')
+ * }
+ * ```
+ *
+ * @example
+ * ```ts
+ * // Build-time manifest generation
+ * import { generateRouteManifest, discoverPages } from '@zenithbuild/router/manifest'
+ *
+ * const manifest = generateRouteManifest('./src/pages')
+ * ```
+ */
+// ============================================
+// Core Types
+// ============================================
+export * from "./types";
+// ============================================
+// Build-time Manifest Generation
+// ============================================
+export { generateRouteManifest, generateRouteManifestCode } from "./manifest";
+// ============================================
+// Runtime Router
+// ============================================
+export { initRouter, resolveRoute, navigate, getRoute, onRouteChange, isActive, prefetch, isPrefetched, generateRuntimeRouterCode, zenRoute } from "./runtime";
+// ============================================
+// Navigation Utilities
+// ============================================
+export { 
+// Navigation API (zen* prefixed names)
+zenNavigate, zenBack, zenForward, zenGo, zenIsActive, zenPrefetch, zenIsPrefetched, zenGetRoute, zenGetParam, zenGetQuery, createZenLink, zenLink, 
+// Additional navigation utilities
+back, forward, go, getParam, getQuery, isExternalUrl, shouldUseSPANavigation, normalizePath, setGlobalTransition, getGlobalTransition, createTransitionContext } from "./navigation/index";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AAEH,+CAA+C;AAC/C,aAAa;AACb,+CAA+C;AAE/C,cAAc,SAAS,CAAA;AAEvB,+CAA+C;AAC/C,iCAAiC;AACjC,+CAA+C;AAE/C,OAAO,EACH,qBAAqB,EACrB,yBAAyB,EAC5B,MAAM,YAAY,CAAA;AAEnB,+CAA+C;AAC/C,iBAAiB;AACjB,+CAA+C;AAE/C,OAAO,EACH,UAAU,EACV,YAAY,EACZ,QAAQ,EACR,QAAQ,EACR,aAAa,EACb,QAAQ,EACR,QAAQ,EACR,YAAY,EACZ,yBAAyB,EACzB,QAAQ,EACX,MAAM,WAAW,CAAA;AAElB,+CAA+C;AAC/C,uBAAuB;AACvB,+CAA+C;AAE/C,OAAO;AACH,uCAAuC;AACvC,WAAW,EACX,OAAO,EACP,UAAU,EACV,KAAK,EACL,WAAW,EACX,WAAW,EACX,eAAe,EACf,WAAW,EACX,WAAW,EACX,WAAW,EACX,aAAa,EACb,OAAO;AACP,kCAAkC;AAClC,IAAI,EACJ,OAAO,EACP,EAAE,EACF,QAAQ,EACR,QAAQ,EACR,aAAa,EACb,sBAAsB,EACtB,aAAa,EACb,mBAAmB,EACnB,mBAAmB,EACnB,uBAAuB,EAC1B,MAAM,oBAAoB,CAAA"}

package/dist/manifest.d.ts

@@ -0,0 +1,32 @@
+import { type RouteDefinition, type ParsedSegment } from "./types";
+/**
+ * Discover all .zen files in the pages directory
+ */
+export declare function discoverPages(pagesDir: string): string[];
+/**
+ * Convert a file path to a route path
+ */
+export declare function filePathToRoutePath(filePath: string, pagesDir: string): string;
+/**
+ * Parse a route path into segments
+ */
+export declare function parseRouteSegments(routePath: string): ParsedSegment[];
+/**
+ * Calculate route score
+ */
+export declare function calculateRouteScore(segments: ParsedSegment[]): number;
+/**
+ * Extract parameter names
+ */
+export declare function extractParamNames(segments: ParsedSegment[]): string[];
+/**
+ * Convert route path to regex pattern
+ */
+export declare function routePathToRegex(routePath: string): RegExp;
+/**
+ * Generate a route definition from a file path
+ */
+export declare function generateRouteDefinition(filePath: string, pagesDir: string): RouteDefinition;
+export declare function generateRouteManifest(pagesDir: string): RouteDefinition[];
+export declare function generateRouteManifestCode(definitions: RouteDefinition[]): string;
+//# sourceMappingURL=manifest.d.ts.map

package/dist/manifest.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"manifest.d.ts","sourceRoot":"","sources":["../src/manifest.ts"],"names":[],"mappings":"AAGA,OAAO,EACH,KAAK,eAAe,EACpB,KAAK,aAAa,EAErB,MAAM,SAAS,CAAA;AAchB;;GAEG;AACH,wBAAgB,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,EAAE,CAqBxD;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAgC9E;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,SAAS,EAAE,MAAM,GAAG,aAAa,EAAE,CAuBrE;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,aAAa,EAAE,GAAG,MAAM,CASrE;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,aAAa,EAAE,GAAG,MAAM,EAAE,CAIrE;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CA2B1D;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,eAAe,CAc3F;AAED,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,MAAM,GAAG,eAAe,EAAE,CAMzE;AAED,wBAAgB,yBAAyB,CAAC,WAAW,EAAE,eAAe,EAAE,GAAG,MAAM,CAahF"}

package/dist/manifest.js

@@ -0,0 +1,180 @@
+import fs from "fs";
+import path from "path";
+import native from "../index.js";
+const { generateRouteManifestNative } = native;
+/**
+ * Scoring constants for route ranking
+ */
+const SEGMENT_SCORES = {
+    [0 /* SegmentType.Static */]: 10,
+    [1 /* SegmentType.Dynamic */]: 5,
+    [2 /* SegmentType.CatchAll */]: 1,
+    [3 /* SegmentType.OptionalCatchAll */]: 0
+};
+/**
+ * Discover all .zen files in the pages directory
+ */
+export function discoverPages(pagesDir) {
+    const pages = [];
+    function walk(dir) {
+        if (!fs.existsSync(dir))
+            return;
+        const entries = fs.readdirSync(dir, { withFileTypes: true });
+        for (const entry of entries) {
+            const fullPath = path.join(dir, entry.name);
+            if (entry.isDirectory()) {
+                walk(fullPath);
+            }
+            else if (entry.isFile() && entry.name.endsWith(".zen")) {
+                pages.push(fullPath);
+            }
+        }
+    }
+    walk(pagesDir);
+    return pages;
+}
+/**
+ * Convert a file path to a route path
+ */
+export function filePathToRoutePath(filePath, pagesDir) {
+    const relativePath = path.relative(pagesDir, filePath);
+    const withoutExt = relativePath.replace(/\.zen$/, "");
+    const segmentsList = withoutExt.split(path.sep);
+    const routeSegments = [];
+    for (const segment of segmentsList) {
+        if (segment === "index")
+            continue;
+        const optionalCatchAllMatch = segment.match(/^\[\[\.\.\.(\w+)\]\]$/);
+        if (optionalCatchAllMatch) {
+            routeSegments.push(`*${optionalCatchAllMatch[1]}?`);
+            continue;
+        }
+        const catchAllMatch = segment.match(/^\[\.\.\.(\w+)\]$/);
+        if (catchAllMatch) {
+            routeSegments.push(`*${catchAllMatch[1]}`);
+            continue;
+        }
+        const dynamicMatch = segment.match(/^\[(\w+)\]$/);
+        if (dynamicMatch) {
+            routeSegments.push(`:${dynamicMatch[1]}`);
+            continue;
+        }
+        routeSegments.push(segment);
+    }
+    const routePath = "/" + routeSegments.join("/");
+    return routePath === "/" ? "/" : routePath.replace(/\/$/, "");
+}
+/**
+ * Parse a route path into segments
+ */
+export function parseRouteSegments(routePath) {
+    if (routePath === "/")
+        return [];
+    const segmentsList = routePath.slice(1).split("/");
+    const parsed = [];
+    for (const segment of segmentsList) {
+        if (segment.startsWith("*") && segment.endsWith("?")) {
+            parsed.push({ segmentType: 3 /* SegmentType.OptionalCatchAll */, paramName: segment.slice(1, -1), raw: segment });
+            continue;
+        }
+        if (segment.startsWith("*")) {
+            parsed.push({ segmentType: 2 /* SegmentType.CatchAll */, paramName: segment.slice(1), raw: segment });
+            continue;
+        }
+        if (segment.startsWith(":")) {
+            parsed.push({ segmentType: 1 /* SegmentType.Dynamic */, paramName: segment.slice(1), raw: segment });
+            continue;
+        }
+        parsed.push({ segmentType: 0 /* SegmentType.Static */, raw: segment });
+    }
+    return parsed;
+}
+/**
+ * Calculate route score
+ */
+export function calculateRouteScore(segments) {
+    if (segments.length === 0)
+        return 100;
+    let score = 0;
+    for (const segment of segments) {
+        score += SEGMENT_SCORES[segment.segmentType];
+    }
+    const staticCount = segments.filter(s => s.segmentType === 0 /* SegmentType.Static */).length;
+    score += staticCount * 2;
+    return score;
+}
+/**
+ * Extract parameter names
+ */
+export function extractParamNames(segments) {
+    return segments
+        .filter(s => s.paramName !== undefined)
+        .map(s => s.paramName);
+}
+/**
+ * Convert route path to regex pattern
+ */
+export function routePathToRegex(routePath) {
+    if (routePath === "/")
+        return /^\/$/;
+    const segmentsList = routePath.slice(1).split("/");
+    const regexParts = [];
+    for (let i = 0; i < segmentsList.length; i++) {
+        const segment = segmentsList[i];
+        if (!segment)
+            continue;
+        if (segment.startsWith("*") && segment.endsWith("?")) {
+            regexParts.push("(?:\\/(.*))?");
+            continue;
+        }
+        if (segment.startsWith("*")) {
+            regexParts.push("\\/(.+)");
+            continue;
+        }
+        if (segment.startsWith(":")) {
+            regexParts.push("\\/([^/]+)");
+            continue;
+        }
+        const escaped = segment.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+        regexParts.push(`\\/${escaped}`);
+    }
+    return new RegExp(`^${regexParts.join("")}\\/?$`);
+}
+/**
+ * Generate a route definition from a file path
+ */
+export function generateRouteDefinition(filePath, pagesDir) {
+    const routePath = filePathToRoutePath(filePath, pagesDir);
+    const segments = parseRouteSegments(routePath);
+    const paramNames = extractParamNames(segments);
+    const score = calculateRouteScore(segments);
+    // Note: RouteDefinition extends RouteRecord, which no longer has segments
+    return {
+        path: routePath,
+        paramNames,
+        score,
+        filePath,
+        regex: routePathToRegex(routePath)
+    };
+}
+export function generateRouteManifest(pagesDir) {
+    // Optional: use native generator if available, but for now we keep the TS one for build-time safety
+    const pages = discoverPages(pagesDir);
+    const definitions = pages.map(filePath => generateRouteDefinition(filePath, pagesDir));
+    definitions.sort((a, b) => b.score - a.score);
+    return definitions;
+}
+export function generateRouteManifestCode(definitions) {
+    const routeEntries = definitions.map(def => {
+        const regex = routePathToRegex(def.path);
+        return `  {
+    path: ${JSON.stringify(def.path)},
+    regex: ${regex.toString()},
+    paramNames: ${JSON.stringify(def.paramNames)},
+    score: ${def.score},
+    filePath: ${JSON.stringify(def.filePath)}
+  }`;
+    });
+    return `// Auto-generated route manifest\n// Do not edit directly\n\nexport const routeManifest = [\n${routeEntries.join(",\n")}\n];\n`;
+}
+//# sourceMappingURL=manifest.js.map

package/dist/manifest.js.map

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

package/dist/navigation/client-router.d.ts

@@ -0,0 +1,59 @@
+/**
+ * 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 entry containing compiled output
+ */
+export interface RouteCacheEntry {
+    html: string;
+    js: string;
+    styles: string[];
+    routePath: string;
+    compiledAt: number;
+}
+/**
+ * Navigation options with explicit data
+ */
+export interface NavigateOptions {
+    loaderData?: any;
+    props?: any;
+    stores?: any;
+    replace?: boolean;
+    prefetch?: boolean;
+}
+/**
+ * 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 declare function prefetchRoute(routePath: string): Promise<void>;
+/**
+ * Get cached route entry
+ */
+export declare function getCachedRoute(routePath: string): RouteCacheEntry | 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 declare function navigate(routePath: string, options?: NavigateOptions): Promise<void>;
+/**
+ * Handle browser back/forward navigation
+ */
+export declare function setupHistoryHandling(): void;
+/**
+ * Generate navigation runtime code (to be included in bundle)
+ */
+export declare function generateNavigationRuntime(): string;
+//# sourceMappingURL=client-router.d.ts.map

package/dist/navigation/client-router.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client-router.d.ts","sourceRoot":"","sources":["../../src/navigation/client-router.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH;;GAEG;AACH,MAAM,WAAW,eAAe;IAC5B,IAAI,EAAE,MAAM,CAAA;IACZ,EAAE,EAAE,MAAM,CAAA;IACV,MAAM,EAAE,MAAM,EAAE,CAAA;IAChB,SAAS,EAAE,MAAM,CAAA;IACjB,UAAU,EAAE,MAAM,CAAA;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC5B,UAAU,CAAC,EAAE,GAAG,CAAA;IAChB,KAAK,CAAC,EAAE,GAAG,CAAA;IACX,MAAM,CAAC,EAAE,GAAG,CAAA;IACZ,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,QAAQ,CAAC,EAAE,OAAO,CAAA;CACrB;AAaD;;;;;GAKG;AACH,wBAAsB,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CA+BpE;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,SAAS,EAAE,MAAM,GAAG,eAAe,GAAG,IAAI,CAGxE;AAED;;;;;GAKG;AACH,wBAAsB,QAAQ,CAC1B,SAAS,EAAE,MAAM,EACjB,OAAO,GAAE,eAAoB,GAC9B,OAAO,CAAC,IAAI,CAAC,CAgEf;AAoGD;;GAEG;AACH,wBAAgB,oBAAoB,IAAI,IAAI,CAY3C;AAED;;GAEG;AACH,wBAAgB,yBAAyB,IAAI,MAAM,CAgJlD"}