@zenithbuild/router 0.5.0-beta.2.3

package/dist/runtime.js

@@ -0,0 +1,157 @@
+/**
+ * Zenith Runtime Router (Native Bridge)
+ *
+ * SPA-style client-side router with SSR support via native resolution.
+ */
+// @ts-ignore
+import native from "../index.js";
+import { state } from "@zenithbuild/runtime";
+const { resolveRouteNative, generateRuntimeRouterNative } = native;
+// Zenith strict signal integration: use reactive state
+const currentRoute = state({
+    path: "/",
+    params: {},
+    query: {},
+    matched: undefined
+});
+const routeListeners = new Set();
+let routeManifest = [];
+let routerOutlet = null;
+export function initRouter(manifest, outlet) {
+    routeManifest = manifest;
+    if (outlet) {
+        routerOutlet = typeof outlet === "string" ? document.querySelector(outlet) : outlet;
+    }
+    window.addEventListener("popstate", handlePopState);
+    resolveAndRender(window.location.pathname, parseQueryString(window.location.search), false);
+}
+function parseQueryString(search) {
+    const query = {};
+    if (!search || search === "?")
+        return query;
+    const params = new URLSearchParams(search);
+    params.forEach((value, key) => { query[key] = value; });
+    return query;
+}
+function handlePopState(_event) {
+    resolveAndRender(window.location.pathname, parseQueryString(window.location.search), false, false);
+}
+/**
+ * Resolve route - uses native implementation if available (Node.js/SSR)
+ * or falls back to JS implementation for the browser.
+ */
+export function resolveRoute(pathname) {
+    if (typeof process !== 'undefined' && process.versions && process.versions.node) {
+        // SSR / Node environment
+        const resolved = resolveRouteNative(pathname, routeManifest);
+        if (!resolved)
+            return null;
+        return {
+            record: resolved.matched,
+            params: resolved.params
+        };
+    }
+    // Client-side fallback implementation
+    const normalizedPath = pathname === "" ? "/" : pathname;
+    for (const route of routeManifest) {
+        const regex = route.regex instanceof RegExp ? route.regex : new RegExp(route.regex.source, route.regex.flags);
+        const match = regex.exec(normalizedPath);
+        if (match) {
+            const params = {};
+            for (let i = 0; i < route.paramNames.length; i++) {
+                const paramName = route.paramNames[i];
+                const paramValue = match[i + 1];
+                if (paramName && paramValue !== undefined) {
+                    params[paramName] = decodeURIComponent(paramValue);
+                }
+            }
+            return { record: route, params };
+        }
+    }
+    return null;
+}
+async function resolveAndRender(path, query, updateHistory = true, replace = false) {
+    const prevRoute = { ...currentRoute };
+    const resolved = resolveRoute(path);
+    if (resolved) {
+        // Update reactive state properties instead of replacing object
+        currentRoute.path = path;
+        currentRoute.params = resolved.params;
+        currentRoute.query = query;
+        currentRoute.matched = resolved.record;
+        const pageModule = resolved.record.module || (resolved.record.load ? await resolved.record.load() : null);
+        if (pageModule)
+            await renderPage(pageModule);
+    }
+    else {
+        currentRoute.path = path;
+        currentRoute.params = {};
+        currentRoute.query = query;
+        currentRoute.matched = undefined;
+    }
+    if (updateHistory) {
+        const url = path + (Object.keys(query).length > 0 ? "?" + new URLSearchParams(query).toString() : "");
+        if (replace)
+            window.history.replaceState(null, "", url);
+        else
+            window.history.pushState(null, "", url);
+    }
+    notifyListeners(currentRoute, prevRoute);
+    window.__zenith_route = currentRoute;
+}
+async function renderPage(pageModule) {
+    if (!routerOutlet)
+        return;
+    routerOutlet.innerHTML = pageModule.html;
+    // ... logic for styles and scripts
+}
+function notifyListeners(route, prevRoute) {
+    routeListeners.forEach(listener => { listener(route, prevRoute); });
+}
+export async function navigate(to, options = {}) {
+    let path, query = {};
+    if (to.includes("?")) {
+        const [pathname, search] = to.split("?");
+        path = pathname || "/";
+        query = parseQueryString("?" + (search || ""));
+    }
+    else
+        path = to;
+    await resolveAndRender(path, query, true, options.replace || false);
+}
+// Return the reactive proxy directly
+export function getRoute() { return currentRoute; }
+/**
+ * zenRoute() - Zenith Law: Environment Resolution
+ *
+ * Canonical primitive for resolving the current route environment.
+ * Must be resolved once and execute before state initialization.
+ */
+export function zenRoute() {
+    const path = typeof window !== 'undefined' ? window.location.pathname : currentRoute.path;
+    return {
+        path,
+        slugs: getSlugs(path)
+    };
+}
+function getSlugs(path) {
+    return path.split('/').filter(Boolean);
+}
+export function onRouteChange(listener) {
+    routeListeners.add(listener);
+    return () => { routeListeners.delete(listener); };
+}
+export function isActive(path, exact = false) {
+    return exact ? currentRoute.path === path : currentRoute.path.startsWith(path);
+}
+export async function prefetch(path) {
+    const resolved = resolveRoute(path);
+    if (resolved && resolved.record.load && !resolved.record.module) {
+        resolved.record.module = await resolved.record.load();
+    }
+}
+export function isPrefetched(_path) { return false; }
+export function generateRuntimeRouterCode() {
+    return generateRuntimeRouterNative();
+}
+//# sourceMappingURL=runtime.js.map

package/dist/runtime.js.map

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

package/dist/types.d.ts

@@ -0,0 +1,50 @@
+/**
+ * Zenith Router Types
+ *
+ * Re-exports types from the native Rust implementation.
+ */
+import { RouteRecord as NativeRouteRecord, RouteState as NativeRouteState, RouteManifest as NativeRouteManifest, SegmentType as NativeSegmentType, ParsedSegment as NativeParsedSegment } from "../index.js";
+export { NativeSegmentType as SegmentType };
+export interface RouteRecord extends Omit<NativeRouteRecord, 'regex'> {
+    regex: RegExp;
+}
+export interface RouteState extends Omit<NativeRouteState, 'matched'> {
+    matched?: RouteRecord;
+}
+export interface RouteManifest extends Omit<NativeRouteManifest, 'routes'> {
+    routes: RouteRecord[];
+}
+export interface ParsedSegment extends NativeParsedSegment {
+}
+export interface PageModule {
+    html: string;
+    scripts: string[];
+    styles: string[];
+    meta?: PageMeta;
+}
+export interface PageMeta {
+    title?: string;
+    description?: string;
+    [key: string]: string | undefined;
+}
+export interface NavigateOptions {
+    replace?: boolean;
+    scrollToTop?: boolean;
+    state?: Record<string, unknown>;
+}
+export interface RouteDefinition extends RouteRecord {
+}
+export interface RuntimeRouteRecord extends RouteRecord {
+    module?: PageModule | null;
+    load?: () => Promise<PageModule>;
+}
+export type RouteListener = (route: RouteState, prevRoute: RouteState) => void;
+export interface Router {
+    readonly route: RouteState;
+    navigate(to: string, options?: NavigateOptions): Promise<void>;
+    resolve(path: string): {
+        record: RouteRecord;
+        params: Record<string, string>;
+    } | null;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EACH,WAAW,IAAI,iBAAiB,EAChC,UAAU,IAAI,gBAAgB,EAC9B,aAAa,IAAI,mBAAmB,EACpC,WAAW,IAAI,iBAAiB,EAChC,aAAa,IAAI,mBAAmB,EACvC,MAAM,aAAa,CAAA;AAEpB,OAAO,EAAE,iBAAiB,IAAI,WAAW,EAAE,CAAA;AAE3C,MAAM,WAAW,WAAY,SAAQ,IAAI,CAAC,iBAAiB,EAAE,OAAO,CAAC;IACjE,KAAK,EAAE,MAAM,CAAA;CAChB;AAED,MAAM,WAAW,UAAW,SAAQ,IAAI,CAAC,gBAAgB,EAAE,SAAS,CAAC;IACjE,OAAO,CAAC,EAAE,WAAW,CAAA;CACxB;AAED,MAAM,WAAW,aAAc,SAAQ,IAAI,CAAC,mBAAmB,EAAE,QAAQ,CAAC;IACtE,MAAM,EAAE,WAAW,EAAE,CAAA;CACxB;AAED,MAAM,WAAW,aAAc,SAAQ,mBAAmB;CAAI;AAE9D,MAAM,WAAW,UAAU;IACvB,IAAI,EAAE,MAAM,CAAA;IACZ,OAAO,EAAE,MAAM,EAAE,CAAA;IACjB,MAAM,EAAE,MAAM,EAAE,CAAA;IAChB,IAAI,CAAC,EAAE,QAAQ,CAAA;CAClB;AAED,MAAM,WAAW,QAAQ;IACrB,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAAA;CACpC;AAED,MAAM,WAAW,eAAe;IAC5B,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,WAAW,CAAC,EAAE,OAAO,CAAA;IACrB,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAClC;AAED,MAAM,WAAW,eAAgB,SAAQ,WAAW;CAAI;AAExD,MAAM,WAAW,kBAAmB,SAAQ,WAAW;IACnD,MAAM,CAAC,EAAE,UAAU,GAAG,IAAI,CAAC;IAC3B,IAAI,CAAC,EAAE,MAAM,OAAO,CAAC,UAAU,CAAC,CAAC;CACpC;AAED,MAAM,MAAM,aAAa,GAAG,CAAC,KAAK,EAAE,UAAU,EAAE,SAAS,EAAE,UAAU,KAAK,IAAI,CAAC;AAE/E,MAAM,WAAW,MAAM;IACnB,QAAQ,CAAC,KAAK,EAAE,UAAU,CAAA;IAC1B,QAAQ,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IAC9D,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG;QAAE,MAAM,EAAE,WAAW,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;KAAE,GAAG,IAAI,CAAA;CACxF"}

package/dist/types.js

@@ -0,0 +1,7 @@
+/**
+ * Zenith Router Types
+ *
+ * Re-exports types from the native Rust implementation.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG"}

package/package.json

@@ -0,0 +1,62 @@
+{
+  "name": "@zenithbuild/router",
+  "version": "0.5.0-beta.2.3",
+  "description": "File-based SPA router for Zenith framework with deterministic, compile-time route resolution",
+  "license": "MIT",
+  "type": "module",
+  "main": "./dist/index.js",
+  "files": [
+    "dist",
+    "template.js",
+    "index.js",
+    "index.d.ts",
+    "README.md",
+    "dist/**",
+    "LICENSE",
+    "package.json"
+  ],
+  "exports": {
+    ".": "./dist/index.js",
+    "./template": "./template.js",
+    "./ZenLink.zen": "./dist/ZenLink.zen"
+  },
+  "keywords": [
+    "zenith",
+    "router",
+    "spa",
+    "file-based-routing",
+    "compile-time"
+  ],
+  "author": "Zenith Team",
+  "repository": {
+    "type": "git",
+    "url": "git+ssh://git@github.com/zenithbuild/zenith-router.git"
+  },
+  "scripts": {
+    "format": "prettier --write \"**/*.ts\"",
+    "format:check": "prettier --check \"**/*.ts\"",
+    "typecheck": "tsc --noEmit",
+    "build": "mkdir -p dist && cp -a src/* dist/ && cp src/ZenLink.zen dist/ZenLink.zen",
+    "release": "bun run scripts/release.ts",
+    "release:dry": "bun run scripts/release.ts --dry-run",
+    "release:patch": "bun run scripts/release.ts --bump=patch",
+    "release:minor": "bun run scripts/release.ts --bump=minor",
+    "release:major": "bun run scripts/release.ts --bump=major",
+    "contract:deps": "node dependency_contract.spec.js",
+    "contract:scan": "node contract-scan.mjs",
+    "contract:template": "node template-contract.spec.js",
+    "test": "npm run contract:deps && npm run contract:scan && npm run contract:template",
+    "test:legacy": "NODE_OPTIONS=--experimental-vm-modules jest --config jest.config.js",
+    "prepublishOnly": "npm run build"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "private": false,
+  "devDependencies": {
+    "@napi-rs/cli": "^2.18.4",
+    "@types/bun": "latest",
+    "@types/node": "latest",
+    "prettier": "^3.7.4"
+  }
+}

package/template.js

@@ -0,0 +1,260 @@
+function normalizeManifestJson(manifestJson) {
+    return manifestJson.replace(/\r\n/g, '\n').replace(/\r/g, '\n');
+}
+
+function sanitizeImportSpecifier(specifier) {
+    return specifier
+        .replace(/\\/g, '\\\\')
+        .replace(/'/g, "\\'")
+        .replace(/\r\n/g, '')
+        .replace(/[\r\n]/g, '');
+}
+
+export function renderRouterModule(opts) {
+    if (!opts || typeof opts !== 'object') {
+        throw new Error('renderRouterModule(opts) requires an options object');
+    }
+
+    const { manifestJson, runtimeImport, coreImport } = opts;
+
+    if (typeof manifestJson !== 'string' || manifestJson.length === 0) {
+        throw new Error('renderRouterModule(opts) requires opts.manifestJson string');
+    }
+    if (typeof runtimeImport !== 'string' || runtimeImport.length === 0) {
+        throw new Error('renderRouterModule(opts) requires opts.runtimeImport string');
+    }
+    if (typeof coreImport !== 'string' || coreImport.length === 0) {
+        throw new Error('renderRouterModule(opts) requires opts.coreImport string');
+    }
+
+    const manifest = normalizeManifestJson(manifestJson);
+    const runtimeSpec = sanitizeImportSpecifier(runtimeImport);
+    const coreSpec = sanitizeImportSpecifier(coreImport);
+
+    const lines = [
+        `import { hydrate as __zenithHydrate } from '${runtimeSpec}';`,
+        `import { zenOnMount as __zenithOnMount } from '${coreSpec}';`,
+        '',
+        'void __zenithHydrate;',
+        'void __zenithOnMount;',
+        '',
+        `const __ZENITH_MANIFEST__ = ${manifest};`,
+        '',
+        'let activeCleanup = null;',
+        'let navigationToken = 0;',
+        '',
+        'function splitPath(path) {',
+        "  return path.split('/').filter(Boolean);",
+        '}',
+        '',
+        'function normalizeCatchAll(segments) {',
+        "  return segments.filter(Boolean).join('/');",
+        '}',
+        '',
+        'function requiresServerReload(route) {',
+        '  const routes = __ZENITH_MANIFEST__.server_routes || __ZENITH_MANIFEST__.serverRoutes || [];',
+        "  return Array.isArray(routes) && routes.includes(route);",
+        '}',
+        '',
+        'function segmentWeight(segment) {',
+        '  if (!segment) return 0;',
+        "  if (segment.startsWith('*')) return 1;",
+        "  if (segment.startsWith(':')) return 2;",
+        '  return 3;',
+        '}',
+        '',
+        'function routeClass(segments) {',
+        '  let hasParam = false;',
+        '  let hasCatchAll = false;',
+        '  for (let i = 0; i < segments.length; i++) {',
+        '    const segment = segments[i];',
+        "    if (segment.startsWith('*')) {",
+        '      hasCatchAll = true;',
+        "    } else if (segment.startsWith(':')) {",
+        '      hasParam = true;',
+        '    }',
+        '  }',
+        '  if (!hasParam && !hasCatchAll) return 3;',
+        '  if (hasCatchAll) return 1;',
+        '  return 2;',
+        '}',
+        '',
+        'function compareRouteSpecificity(a, b) {',
+        "  if (a === '/' && b !== '/') return -1;",
+        "  if (b === '/' && a !== '/') return 1;",
+        '  const aSegs = splitPath(a);',
+        '  const bSegs = splitPath(b);',
+        '  const aClass = routeClass(aSegs);',
+        '  const bClass = routeClass(bSegs);',
+        '  if (aClass !== bClass) {',
+        '    return bClass - aClass;',
+        '  }',
+        '  const max = Math.min(aSegs.length, bSegs.length);',
+        '  for (let i = 0; i < max; i++) {',
+        '    const aWeight = segmentWeight(aSegs[i]);',
+        '    const bWeight = segmentWeight(bSegs[i]);',
+        '    if (aWeight !== bWeight) {',
+        '      return bWeight - aWeight;',
+        '    }',
+        '  }',
+        '  if (aSegs.length !== bSegs.length) {',
+        '    return bSegs.length - aSegs.length;',
+        '  }',
+        '  return a.localeCompare(b);',
+        '}',
+        '',
+        'function resolveRoute(pathname) {',
+        '  if (__ZENITH_MANIFEST__.chunks[pathname]) {',
+        '    return { route: pathname, params: {} };',
+        '  }',
+        '',
+        '  const pathnameSegments = splitPath(pathname);',
+        '  const routes = Object.keys(__ZENITH_MANIFEST__.chunks).sort(compareRouteSpecificity);',
+        '',
+        '  for (let i = 0; i < routes.length; i++) {',
+        '    const route = routes[i];',
+        '    const routeSegments = splitPath(route);',
+        '    const params = Object.create(null);',
+        '    let routeIndex = 0;',
+        '    let pathIndex = 0;',
+        '    let matched = true;',
+        '',
+        '    while (routeIndex < routeSegments.length) {',
+        '      const routeSegment = routeSegments[routeIndex];',
+        "      if (routeSegment.startsWith('*')) {",
+        "        const optionalCatchAll = routeSegment.endsWith('?');",
+        "        const key = optionalCatchAll ? routeSegment.slice(1, -1) : routeSegment.slice(1);",
+        '        if (routeIndex !== routeSegments.length - 1) {',
+        '          matched = false;',
+        '          break;',
+        '        }',
+        '        const rest = pathnameSegments.slice(pathIndex);',
+        '        const rootRequiredCatchAll = !optionalCatchAll && routeSegments.length === 1;',
+        '        if (rest.length === 0 && !optionalCatchAll && !rootRequiredCatchAll) {',
+        '          matched = false;',
+        '          break;',
+        '        }',
+        '        params[key] = normalizeCatchAll(rest);',
+        '        pathIndex = pathnameSegments.length;',
+        '        routeIndex = routeSegments.length;',
+        '        continue;',
+        '      }',
+        '      if (pathIndex >= pathnameSegments.length) {',
+        '        matched = false;',
+        '        break;',
+        '      }',
+        '      const pathnameSegment = pathnameSegments[pathIndex];',
+        "      if (routeSegment.startsWith(':')) {",
+        '        params[routeSegment.slice(1)] = pathnameSegment;',
+        '      } else if (routeSegment !== pathnameSegment) {',
+        '        matched = false;',
+        '        break;',
+        '      }',
+        '      routeIndex += 1;',
+        '      pathIndex += 1;',
+        '    }',
+        '',
+        '    if (matched && routeIndex === routeSegments.length && pathIndex === pathnameSegments.length) {',
+        '      return { route, params: { ...params } };',
+        '    }',
+        '  }',
+        '',
+        '  return null;',
+        '}',
+        '',
+        'function teardownRuntime() {',
+        "  if (typeof activeCleanup === 'function') {",
+        '    activeCleanup();',
+        '    activeCleanup = null;',
+        '  }',
+        '}',
+        '',
+        'async function mountRoute(route, params, token) {',
+        '  if (token !== navigationToken) return;',
+        '  teardownRuntime();',
+        '  if (token !== navigationToken) return;',
+        '',
+        '  const pageModule = await import(__ZENITH_MANIFEST__.chunks[route]);',
+        '  if (token !== navigationToken) return;',
+        '',
+        '  const mountFn = pageModule.__zenith_mount || pageModule.default;',
+        "  if (typeof mountFn === 'function') {",
+        '    const cleanup = mountFn(document, params);',
+        "    activeCleanup = typeof cleanup === 'function' ? cleanup : null;",
+        '  }',
+        '}',
+        '',
+        'async function navigate(pathname, url) {',
+        '  const next = resolveRoute(pathname);',
+        '  if (!next) return false;',
+        '',
+        '  navigationToken += 1;',
+        '  const token = navigationToken;',
+        '',
+        '  await mountRoute(next.route, next.params, token);',
+        '  if (token !== navigationToken) return false;',
+        "  if (typeof window.scrollTo === 'function') {",
+        '    window.scrollTo(0, 0);',
+        '  }',
+        '  return true;',
+        '}',
+        '',
+        'function handleNavigationFailure(error, url) {',
+        "  console.error('[Zenith Router] navigation failed', error);",
+        "  if (url && typeof url.href === 'string') {",
+        '    window.location.assign(url.href);',
+        '  }',
+        '}',
+        '',
+        'function isInternalLink(anchor) {',
+        "  if (!anchor || anchor.target || anchor.hasAttribute('download')) return false;",
+        "  const href = anchor.getAttribute('href');",
+        "  if (!href || href.startsWith('#') || href.startsWith('mailto:') || href.startsWith('tel:')) return false;",
+        '  const url = new URL(anchor.href, window.location.href);',
+        '  return url.origin === window.location.origin;',
+        '}',
+        '',
+        'function start() {',
+        "  if (typeof history === 'object' && history && 'scrollRestoration' in history) {",
+        "    history.scrollRestoration = 'manual';",
+        '  }',
+        '',
+        "  document.addEventListener('click', function (event) {",
+        "    if (event.defaultPrevented || event.button !== 0 || event.metaKey || event.ctrlKey || event.shiftKey || event.altKey) return;",
+        "    const target = event.target && event.target.closest ? event.target.closest('a[data-zen-link]') : null;",
+        '    if (!isInternalLink(target)) return;',
+        '',
+        '    const url = new URL(target.href, window.location.href);',
+        '    const hashOnlyNavigation =',
+        '      url.hash &&',
+        '      url.pathname === window.location.pathname &&',
+        '      url.search === window.location.search;',
+        '    if (hashOnlyNavigation) return;',
+        '    const nextPath = url.pathname;',
+        "    if (nextPath === window.location.pathname && url.search === window.location.search && url.hash === window.location.hash) return;",
+        '    const resolved = resolveRoute(nextPath);',
+        '    if (!resolved) return;',
+        '    if (requiresServerReload(resolved.route)) return;',
+        '',
+        '    try {',
+        '      window.location.assign(url.href);',
+        '    } catch (e) {',
+        "      console.error('[Zenith Router] click navigation failed, falling back to browser default', e);",
+        '    }',
+        '  });',
+        '',
+        '',
+        '  navigate(window.location.pathname, null).catch(function (error) {',
+        "    console.error('[Zenith Router] initial navigation failed', error);",
+        '  });',
+        '}',
+        '',
+        "if (document.readyState === 'loading') {",
+        "  document.addEventListener('DOMContentLoaded', start, { once: true });",
+        '} else {',
+        '  start();',
+        '}'
+    ];
+
+    return `${lines.join('\n')}\n`;
+}