@zenithbuild/router 0.7.10 → 0.7.11

package/dist/events.d.ts

@@ -4,18 +4,24 @@ type RouteChangeDetail = {
     params?: RouteParams;
     matched: boolean;
 };
-type RouteProtectionPolicy = {
+export type AdvisoryRoutePolicy = {
     onDeny?: 'stay' | 'redirect' | 'render403' | ((ctx: any) => void);
     defaultLoginPath?: string;
     deny401RedirectToLogin?: boolean;
     forbiddenPath?: string;
 };
+/** @deprecated Use AdvisoryRoutePolicy. This policy only controls client navigation UX. */
+export type RouteProtectionPolicy = AdvisoryRoutePolicy;
 type RouteEventHandler = (payload: unknown) => void | Promise<void>;
 export declare function onRouteChange(callback: (detail: RouteChangeDetail) => void): () => void;
 export declare function _dispatchRouteChange(detail: RouteChangeDetail): void;
 export declare function _clearSubscribers(): void;
 export declare function _getSubscriberCount(): number;
+export declare function setAdvisoryRoutePolicy(policy: AdvisoryRoutePolicy): void;
+export declare function _getAdvisoryRoutePolicy(): AdvisoryRoutePolicy;
+/** @deprecated Use setAdvisoryRoutePolicy. This policy only controls client navigation UX. */
 export declare function setRouteProtectionPolicy(policy: RouteProtectionPolicy): void;
+/** @deprecated Use _getAdvisoryRoutePolicy. This policy only controls client navigation UX. */
 export declare function _getRouteProtectionPolicy(): RouteProtectionPolicy;
 export declare function on(eventName: string, handler: RouteEventHandler): void;
 export declare function off(eventName: string, handler: RouteEventHandler): void;

package/dist/events.js

@@ -28,8 +28,6 @@ export function _getSubscriberCount() {
 const ROUTE_POLICY_KEY = '__zenith_route_protection_policy';
 const ROUTE_EVENT_LISTENERS_KEY = '__zenith_route_event_listeners';
 const ROUTE_EVENT_NAMES = [
-    'guard:start',
-    'guard:end',
     'route-check:start',
     'route-check:end',
     'route-check:error',
@@ -70,14 +68,22 @@ function ensureRouteProtectionState() {
     }
     return { policy, listeners };
 }
-export function setRouteProtectionPolicy(policy) {
+export function setAdvisoryRoutePolicy(policy) {
     const state = ensureRouteProtectionState();
     state.policy = Object.assign({}, state.policy, policy);
     getRouteProtectionScope()[ROUTE_POLICY_KEY] = state.policy;
 }
-export function _getRouteProtectionPolicy() {
+export function _getAdvisoryRoutePolicy() {
     return ensureRouteProtectionState().policy;
 }
+/** @deprecated Use setAdvisoryRoutePolicy. This policy only controls client navigation UX. */
+export function setRouteProtectionPolicy(policy) {
+    setAdvisoryRoutePolicy(policy);
+}
+/** @deprecated Use _getAdvisoryRoutePolicy. This policy only controls client navigation UX. */
+export function _getRouteProtectionPolicy() {
+    return _getAdvisoryRoutePolicy();
+}
 export function on(eventName, handler) {
     const eventListeners = ensureRouteProtectionState().listeners[eventName];
     if (eventListeners instanceof Set) {

package/dist/index.d.ts

@@ -2,4 +2,4 @@ export { createRouter } from "./router.js";
 export { zenNavigationShell } from "./navigation-shell.js";
 export { matchRoute } from "./match.js";
 export { navigate, refreshCurrentRoute, back, forward, getCurrentPath } from "./navigate.js";
-export { onRouteChange, on, off, setRouteProtectionPolicy, _getRouteProtectionPolicy, _dispatchRouteEvent } from "./events.js";
+export { onRouteChange, on, off, setAdvisoryRoutePolicy, _getAdvisoryRoutePolicy, setRouteProtectionPolicy, _getRouteProtectionPolicy, _dispatchRouteEvent } from "./events.js";

package/dist/index.js

@@ -5,6 +5,6 @@
 // ---------------------------------------------------------------------------
 export { createRouter } from './router.js';
 export { navigate, refreshCurrentRoute, back, forward, getCurrentPath } from './navigate.js';
-export { onRouteChange, on, off, setRouteProtectionPolicy, _getRouteProtectionPolicy, _dispatchRouteEvent } from './events.js';
+export { onRouteChange, on, off, setAdvisoryRoutePolicy, _getAdvisoryRoutePolicy, setRouteProtectionPolicy, _getRouteProtectionPolicy, _dispatchRouteEvent } from './events.js';
 export { zenNavigationShell } from './navigation-shell.js';
 export { matchRoute } from './match.js';

package/index.d.ts

@@ -56,13 +56,16 @@ export declare function getCurrentPath(): string;
 export declare function onRouteChange(listener: (event: any) => void): () => void;
 export declare function matchRoute(routes: any[], path: string): any;
 
-export interface RouteProtectionPolicy {
+export interface AdvisoryRoutePolicy {
     onDeny?: "stay" | "redirect" | "render403" | ((ctx: any) => void);
     defaultLoginPath?: string;
     deny401RedirectToLogin?: boolean;
     forbiddenPath?: string;
 }
 
+/** @deprecated Use AdvisoryRoutePolicy. This policy only controls client navigation UX. */
+export type RouteProtectionPolicy = AdvisoryRoutePolicy;
+
 export type NavigationType = "push" | "pop" | "refresh";
 export type NavigationShellPhase = "idle" | "leaving" | "swapping" | "entering";
 
@@ -115,8 +118,6 @@ export interface NavigationLifecyclePayload {
 export type RouteEventHandler = (payload: unknown) => void | Promise<void>;
 
 export type RouteEventName =
-    | "guard:start"
-    | "guard:end"
     | "route-check:start"
     | "route-check:end"
     | "route-check:error"
@@ -133,7 +134,12 @@ export type RouteEventName =
     | "navigation:abort"
     | "navigation:error";
 
+export declare function setAdvisoryRoutePolicy(policy: AdvisoryRoutePolicy): void;
+export declare function _getAdvisoryRoutePolicy(): AdvisoryRoutePolicy;
+/** @deprecated Use setAdvisoryRoutePolicy. This policy only controls client navigation UX. */
 export declare function setRouteProtectionPolicy(policy: RouteProtectionPolicy): void;
+/** @deprecated Use _getAdvisoryRoutePolicy. This policy only controls client navigation UX. */
+export declare function _getRouteProtectionPolicy(): RouteProtectionPolicy;
 export declare function on(eventName: RouteEventName, handler: RouteEventHandler): void;
 export declare function off(eventName: RouteEventName, handler: RouteEventHandler): void;
 export declare function zenNavigationShell(ref: { current?: Element | null }, options?: NavigationShellOptions | null): NavigationShellController;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zenithbuild/router",
-  "version": "0.7.10",
+  "version": "0.7.11",
   "description": "File-based SPA router for Zenith framework with deterministic, compile-time route resolution",
   "license": "MIT",
   "type": "module",
@@ -56,7 +56,7 @@
     "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": "npm run contract:deps && npm run contract:scan && npm run contract:template && npm run test:legacy",
     "test:legacy": "NODE_OPTIONS=--experimental-vm-modules jest --config jest.config.js",
     "prepublishOnly": "npm run build"
   },
@@ -65,9 +65,12 @@
   },
   "private": false,
   "devDependencies": {
+    "@jest/globals": "^30.2.0",
     "@napi-rs/cli": "^2.18.4",
     "@types/bun": "latest",
     "@types/node": "latest",
+    "jest": "^30.2.0",
+    "jest-environment-jsdom": "^30.2.0",
     "prettier": "^3.7.4",
     "typescript": "^5.7.3"
   }

package/template-core.js

@@ -12,8 +12,6 @@ const __ZENITH_BASE_PATH__ = normalizeBasePath(
 );
 const __ZENITH_ROUTE_EVENT_KEY = "__zenith_route_event_listeners";
 const __ZENITH_ROUTE_EVENT_NAMES = [
-  "guard:start",
-  "guard:end",
   "route-check:start",
   "route-check:end",
   "route-check:error",