white-label-router 5.0.0 → 6.0.0

package/PACKAGE_MANAGERS.md

@@ -0,0 +1,19 @@
+# Package manager support
+
+`white-label-router` supports npm, Yarn, and pnpm consumers.
+
+## Install
+
+```sh
+npm install white-label-router
+yarn add white-label-router
+pnpm add white-label-router
+```
+
+CI packs the real distributable artifact and installs that same artifact with all three package managers before exercising the public Router API.
+
+## Repository development
+
+The committed `package-lock.json` remains the repository's canonical dependency lockfile and npm remains the maintenance/audit path used by the primary CI job. Yarn and pnpm compatibility does not require committing `yarn.lock` or `pnpm-lock.yaml`.
+
+Nested project scripts use Node's `--run` support so `npm test`, `yarn test`, and `pnpm test` do not depend on another package manager to invoke child scripts.

package/README.md

@@ -138,13 +138,13 @@ router.routes = {
 };
 ```
 
-`secure()` must return exactly `true` to allow navigation. On a successful route change, the previous route's `destroy()` runs before the next route's `initialize()`.
+`secure()` must return exactly `true` to allow navigation. Router validates the destination guard and runnable view behavior before tearing down the current route. On a successful route change, the previous route's `destroy()` then runs before the next route's `initialize()`.
 
 ## Matching
 
 Routes match complete path boundaries. `/products` matches `/products` and `/products/42`, but not `/products-old`.
 
-When multiple route prefixes match, Router selects the **longest matching route**, so specific routes win without depending on object insertion order:
+When multiple route prefixes match, Router selects the **longest matching route**, so specific routes win without depending on object insertion order. Only own route-table properties participate in matching:
 
 ```js
 router.routes = {
@@ -171,7 +171,7 @@ Routes receive the configured `scope` and a location object:
 }
 ```
 
-`data.url` contains path segments after the matched prefix, `data.query` contains parsed query values, and `data.mediator` contains navigation data supplied programmatically or through the mediator. Values are URI-decoded with standard WHATWG URL APIs; applications must still validate untrusted values.
+`data.url` contains path segments after the matched prefix, `data.query` contains parsed query values, and `data.mediator` contains navigation data supplied programmatically or through `CustomEvent.detail`. Values are URI-decoded with standard WHATWG URL APIs; applications must still validate untrusted values.
 
 ## Programmatic navigation
 
@@ -185,11 +185,13 @@ const result = router.navigate('/products/42', {
 
 In browsers, successful navigation updates history unless the call represents `popstate`. On servers it dispatches without History API effects.
 
+Rejected navigation is atomic from Router's perspective: cross-origin browser URLs, failed guards, and routes without runnable view behavior return `false` without destroying the current route, pushing browser history, or replacing the last successful `url`, selected route, or location payload.
+
 Calling `navigate()` without a URL dispatches the current browser URL. In a non-browser runtime the safe default is `/`; server applications should normally supply the request URL explicitly.
 
 ## Mediator integration
 
-Assign any EventEmitter-compatible mediator that provides `on()` and `removeListener()`:
+Assign any standards-based event target that provides `addEventListener()` and `removeEventListener()`. `white-label-mediator` is the first-party implementation:
 
 ```js
 import Mediator from 'white-label-mediator';
@@ -200,23 +202,27 @@ const router = new Router();
 router.mediator = mediator;
 router.initialize();
 
-mediator.emit('router:navigate', {
-    url: '/account',
-    reason: 'Session refreshed'
-});
+mediator.dispatchEvent(new CustomEvent('router:navigate', {
+    detail: {
+        url: '/account',
+        reason: 'Session refreshed'
+    }
+}));
 ```
 
-The complete event object becomes `location.data.mediator`. `destroy()` removes listeners owned by Router. Repeated listener initialization is idempotent.
+The `CustomEvent.detail` value becomes `location.data.mediator`. `destroy()` removes the listener owned by Router. Repeated listener initialization is idempotent. Reassigning `router.mediator` while listeners are active removes `router:navigate` from the previous mediator before subscribing to the replacement.
+
+Router does not import or require `white-label-mediator`; the integration is structural so another compatible EventTarget can be used instead.
 
 ## Public API
 
 | Member | Behavior | Returns |
 | --- | --- | --- |
-| `routes` | Ordered route table of functions or lifecycle route objects. | Configuration property; not a method. |
+| `routes` | Route table of functions or lifecycle route objects; matching uses the longest own path prefix, not insertion order. | Configuration property; not a method. |
 | `scope` | Application scope passed to route callbacks. | Configuration property; not a method. |
-| `mediator` | Optional EventEmitter-compatible source for `router:navigate`. | Configuration property; not a method. |
+| `mediator` | Optional EventTarget-compatible source for `router:navigate`; active subscriptions move when this property changes. | Configuration property; not a method. |
 | `initialize(url?)` | Dispatch the browser URL or an explicit server URL and attach applicable listeners. | The same `Router` instance. |
-| `navigate(url?, data?, isPopState?)` | Match and run a route; update browser history when appropriate. | The same `Router` instance on success; `false` for cross-origin browser URLs, rejected guards, or routes without runnable view behavior. |
+| `navigate(url?, data?, isPopState?)` | Match and run a route; update browser history when appropriate. Rejected navigation preserves the current route state. | The same `Router` instance on success; `false` for cross-origin browser URLs, rejected guards, or routes without runnable view behavior. |
 | `addListeners()` | Attach browser and optional mediator listeners once. | The same `Router` instance. |
 | `removeListeners()` | Release listeners owned by this router. | The same `Router` instance. |
 | `destroy()` | Release routing listeners. | The same `Router` instance after cleanup. |
@@ -244,7 +250,7 @@ The default focus selector is `main h1`. Set `focus: false` for an in-page refin
 
 ## Browser history behavior
 
-Initialization dispatches the current URL without adding a duplicate history entry. Back/forward navigation reads `window.location`—including path, query, and hash—even when history state is null or belongs to another application. History state is not treated as the authoritative URL.
+Initialization dispatches the current URL without adding a duplicate history entry. Back/forward navigation reads `window.location`—including path, query, and hash—even when history state is null or belongs to another application. History state is not treated as the authoritative URL. Rejected navigation does not add a history entry.
 
 ## TypeScript
 
@@ -274,10 +280,10 @@ npm run audit
 npm pack --dry-run
 ```
 
-Tests cover browser behavior, DOM-free server routing, and parity of the shared route contract. Coverage enforces 100% statements, branches, functions, and lines per implementation file. CI builds authored source, uploads generated artifacts for inspection, audits dependencies, packs the package, and verifies the packed public API across npm, Yarn, and pnpm.
+Tests cover browser behavior, DOM-free server routing, atomic rejected navigation, mediator reassignment, and parity of the shared route contract. Coverage enforces 100% statements, branches, functions, and lines per implementation file. CI verifies both the documented Node 22.18 minimum and the primary Node 24 line, builds authored source, audits dependencies, packs the package, and verifies the packed public API across npm, Yarn, and pnpm.
 
 Edit `src/*.ts` and regenerate `dist`; do not edit generated files directly.
 
 ## Design boundary
 
-Router owns URL-to-intent translation. It intentionally does not own application state, rendering, data loading, authentication policy, or server infrastructure. Real links and server URLs remain the foundation; Router enhances them instead of replacing them.
+Router owns URL-to-intent translation. It intentionally does not own application state, rendering, data loading, authentication policy, or server infrastructure. Real links and server URLs remain the foundation; Router enhances them instead of replacing them.

package/dist/index.d.ts

@@ -24,10 +24,10 @@ interface RouteObject {
     };
 }
 type Route = RouteHandler | RouteObject;
-/** Minimal event-bus contract required by the router. */
+/** Minimal standards-based event target contract required by the router. */
 interface NavigationMediator {
-    on(event: string, callback: (data?: NavigationData) => unknown): unknown;
-    removeListener(event: string, callback: (data?: NavigationData) => unknown): unknown;
+    addEventListener(type: string, callback: EventListenerOrEventListenerObject, options?: boolean | AddEventListenerOptions): void;
+    removeEventListener(type: string, callback: EventListenerOrEventListenerObject, options?: boolean | EventListenerOptions): void;
 }
 /** History API router that also dispatches request URLs in non-browser runtimes. */
 declare class Router {
@@ -37,14 +37,18 @@ declare class Router {
     scope: Element | null;
     previousRoute: string | null;
     pageTitle: string | null;
-    mediator: NavigationMediator | false;
     boundPushStateClick: (event: MouseEvent) => unknown;
     boundPopState: (event: PopStateEvent) => unknown;
-    boundMediatorNavigate: (data?: NavigationData) => unknown;
+    boundMediatorNavigate: EventListener;
     listenersInitialized: boolean;
     locationData: LocationData;
+    private currentMediator;
+    private boundMediator;
     /** Create an instance with its own state and listener references. */
     constructor();
+    get mediator(): NavigationMediator | false;
+    /** Move an active router:navigate subscription when the mediator changes. */
+    set mediator(value: NavigationMediator | false);
     /** True when browser navigation APIs are available. */
     private isBrowserRuntime;
     /** Stable base URL for WHATWG URL parsing in browser and server runtimes. */
@@ -53,6 +57,8 @@ declare class Router {
     private getCurrentUrl;
     /** Normalize browser navigation to a same-origin path, query, and hash. */
     private normalizeBrowserUrl;
+    /** Return whether a selected route has runnable view behavior. */
+    private isRunnableRoute;
     /**
      * Start this instance and return it for lifecycle chaining.
      * In a browser the URL is optional and defaults to window.location. On a server pass the request URL.

package/dist/index.js

@@ -7,12 +7,13 @@ class Router {
     scope;
     previousRoute;
     pageTitle;
-    mediator;
     boundPushStateClick;
     boundPopState;
     boundMediatorNavigate;
     listenersInitialized;
     locationData = { url: '', data: { url: [], mediator: undefined, query: {} } };
+    currentMediator = false;
+    boundMediator = false;
     /** Create an instance with its own state and listener references. */
     constructor() {
         this.routes = {
@@ -28,14 +29,30 @@ class Router {
         this.scope = null;
         this.previousRoute = null;
         this.pageTitle = null;
-        this.mediator = false;
         this.boundPushStateClick = this.eventPushStateClick.bind(this);
         this.boundPopState = this.eventPopState.bind(this);
-        this.boundMediatorNavigate = (data = {}) => {
+        this.boundMediatorNavigate = (event) => {
+            const data = event.detail ?? {};
             this.navigate(data.url, data, false);
         };
         this.listenersInitialized = false;
     }
+    get mediator() { return this.currentMediator; }
+    /** Move an active router:navigate subscription when the mediator changes. */
+    set mediator(value) {
+        if (value === this.currentMediator) {
+            return;
+        }
+        if (this.listenersInitialized && this.boundMediator) {
+            this.boundMediator.removeEventListener('router:navigate', this.boundMediatorNavigate);
+            this.boundMediator = false;
+        }
+        this.currentMediator = value;
+        if (this.listenersInitialized && value) {
+            value.addEventListener('router:navigate', this.boundMediatorNavigate);
+            this.boundMediator = value;
+        }
+    }
     /** True when browser navigation APIs are available. */
     isBrowserRuntime() {
         return typeof window !== 'undefined' && typeof document !== 'undefined';
@@ -62,6 +79,11 @@ class Router {
         }
         return `${parsedUrl.pathname}${parsedUrl.search}${parsedUrl.hash}`;
     }
+    /** Return whether a selected route has runnable view behavior. */
+    isRunnableRoute(route) {
+        return typeof route === 'function' || typeof route.view === 'function' ||
+            Boolean(route.view && typeof route.view.initialize === 'function');
+    }
     /**
      * Start this instance and return it for lifecycle chaining.
      * In a browser the URL is optional and defaults to window.location. On a server pass the request URL.
@@ -81,8 +103,9 @@ class Router {
             document.addEventListener('click', this.boundPushStateClick);
             window.addEventListener('popstate', this.boundPopState);
         }
-        if (this.mediator) {
-            this.mediator.on('router:navigate', this.boundMediatorNavigate);
+        if (this.currentMediator) {
+            this.currentMediator.addEventListener('router:navigate', this.boundMediatorNavigate);
+            this.boundMediator = this.currentMediator;
         }
         this.listenersInitialized = true;
         return this;
@@ -101,8 +124,9 @@ class Router {
             document.removeEventListener('click', this.boundPushStateClick);
             window.removeEventListener('popstate', this.boundPopState);
         }
-        if (this.mediator) {
-            this.mediator.removeListener('router:navigate', this.boundMediatorNavigate);
+        if (this.boundMediator) {
+            this.boundMediator.removeEventListener('router:navigate', this.boundMediatorNavigate);
+            this.boundMediator = false;
         }
         this.listenersInitialized = false;
         return this;
@@ -130,8 +154,7 @@ class Router {
             return true;
         }
         e.preventDefault();
-        this.url = `${location.pathname}${location.search}${location.hash}`;
-        this.navigate(undefined, {}, false);
+        this.navigate(`${location.pathname}${location.search}${location.hash}`, {}, false);
         return this;
     }
     /** Restore browser history state without adding a new history entry. */
@@ -195,6 +218,9 @@ class Router {
     }
     /** Select a route, enforce its guard, transition view lifecycles, and update browser history when available. */
     navigate(url, mediatorData, isPopState = false) {
+        const previousUrl = this.url;
+        const previousSelectedRoute = this.route;
+        const previousLocationData = this.locationData;
         if (url !== undefined) {
             this.url = url;
         }
@@ -203,12 +229,13 @@ class Router {
         }
         const normalizedUrl = this.normalizeBrowserUrl(this.url);
         if (normalizedUrl === null) {
+            this.url = previousUrl;
             return false;
         }
         this.url = normalizedUrl;
         this.route = null;
         const pathname = new URL(this.url, this.getOrigin()).pathname;
-        for (const route in this.routes) {
+        for (const route of Object.keys(this.routes)) {
             if (route === 'defaultRoute' || (pathname !== route && !pathname.startsWith(`${route}/`))) {
                 continue;
             }
@@ -222,7 +249,11 @@ class Router {
         }
         if (this.route) {
             const selected = this.routes[this.route];
-            if (typeof selected !== 'function' && selected.secure && selected.secure(this.scope, this.locationData) !== true) {
+            if ((typeof selected !== 'function' && selected.secure && selected.secure(this.scope, this.locationData) !== true) ||
+                !this.isRunnableRoute(selected)) {
+                this.url = previousUrl;
+                this.route = previousSelectedRoute;
+                this.locationData = previousLocationData;
                 return false;
             }
             const previous = this.previousRoute ? this.routes[this.previousRoute] : undefined;
@@ -235,11 +266,8 @@ class Router {
             else if (typeof selected.view === 'function') {
                 selected.view(this.scope, this.locationData);
             }
-            else if (selected.view && typeof selected.view.initialize === 'function') {
-                selected.view.initialize(this.scope, this.locationData);
-            }
             else {
-                return false;
+                selected.view.initialize(this.scope, this.locationData);
             }
             this.applyPageContext(selected);
             this.previousRoute = this.route;

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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","sourcesContent":["/** Navigation payload, including caller-defined metadata. */\ninterface NavigationData {url?: string; [key: string]: unknown}\n/** URL-derived values supplied to route handlers. */\ninterface LocationData {url: string; data: {url: string[]; mediator: NavigationData | undefined; query: Record<string, string>}}\ntype RouteHandler = (scope: Element | null, location: LocationData) => unknown;\n/** An object route can own a function or a view lifecycle. */\ninterface RouteObject {title?: string; focus?: string | false; secure?: RouteHandler; view?: RouteHandler | {initialize?: RouteHandler; destroy?: RouteHandler}}\ntype Route = RouteHandler | RouteObject;\n/** Minimal event-bus contract required by the router. */\ninterface NavigationMediator {\n    on(event: string, callback: (data?: NavigationData) => unknown): unknown;\n    removeListener(event: string, callback: (data?: NavigationData) => unknown): unknown;\n}\n/** History API router that also dispatches request URLs in non-browser runtimes. */\nclass Router {\n    routes: Record<string, Route>;\n    url: string;\n    route: string | null;\n    scope: Element | null;\n    previousRoute: string | null;\n    pageTitle: string | null;\n    mediator: NavigationMediator | false;\n    boundPushStateClick: (event: MouseEvent) => unknown;\n    boundPopState: (event: PopStateEvent) => unknown;\n    boundMediatorNavigate: (data?: NavigationData) => unknown;\n    listenersInitialized: boolean;\n    locationData: LocationData = {url: '', data: {url: [], mediator: undefined, query: {}}};\n\n    /** Create an instance with its own state and listener references. */\n    constructor() {\n        this.routes = {\n            defaultRoute: {\n                view: {\n                    initialize: () => true,\n                    destroy: () => true\n                }\n            }\n        };\n        this.url = '';\n        this.route = null;\n        this.scope = null;\n        this.previousRoute = null;\n        this.pageTitle = null;\n        this.mediator = false;\n        this.boundPushStateClick = this.eventPushStateClick.bind(this);\n        this.boundPopState = this.eventPopState.bind(this);\n        this.boundMediatorNavigate = (data = {}) => {\n            this.navigate(data.url, data, false);\n        };\n        this.listenersInitialized = false;\n    }\n\n    /** True when browser navigation APIs are available. */\n    private isBrowserRuntime() {\n        return typeof window !== 'undefined' && typeof document !== 'undefined';\n    }\n\n    /** Stable base URL for WHATWG URL parsing in browser and server runtimes. */\n    private getOrigin() {\n        return this.isBrowserRuntime() ? window.location.origin : 'http://white-label.invalid';\n    }\n\n    /** Read the authoritative browser URL, or retain the supplied server URL. */\n    private getCurrentUrl() {\n        if (!this.isBrowserRuntime()) {return this.url || '/';}\n        return window.location.pathname + window.location.search + (window.location.hash || '');\n    }\n\n    /** Normalize browser navigation to a same-origin path, query, and hash. */\n    private normalizeBrowserUrl(url: string) {\n        if (!this.isBrowserRuntime()) {return url;}\n        const parsedUrl = new URL(url || '/', window.location.href || `${window.location.origin}/`);\n        if (parsedUrl.origin !== window.location.origin) {return null;}\n        return `${parsedUrl.pathname}${parsedUrl.search}${parsedUrl.hash}`;\n    }\n\n    /**\n     * Start this instance and return it for lifecycle chaining.\n     * In a browser the URL is optional and defaults to window.location. On a server pass the request URL.\n     */\n    initialize(url?: string) {\n        this.url = url ?? this.getCurrentUrl();\n        this.addListeners();\n        this.navigate(undefined, {}, true);\n        return this;\n    }\n\n    /** Register browser and optional mediator handlers once. */\n    addListeners() {\n        if (this.listenersInitialized) {return this;}\n        if (this.isBrowserRuntime()) {\n            document.addEventListener('click', this.boundPushStateClick);\n            window.addEventListener('popstate', this.boundPopState);\n        }\n        if (this.mediator) {this.mediator.on('router:navigate', this.boundMediatorNavigate);}\n        this.listenersInitialized = true;\n        return this;\n    }\n\n    /** Release owned state and listeners so the instance can leave the application lifecycle. */\n    destroy() {\n        this.removeListeners();\n        return this;\n    }\n\n    /** Release listeners owned by this instance; subclasses may extend the lifecycle hook. */\n    removeListeners() {\n        if (!this.listenersInitialized) {return this;}\n        if (this.isBrowserRuntime()) {\n            document.removeEventListener('click', this.boundPushStateClick);\n            window.removeEventListener('popstate', this.boundPopState);\n        }\n        if (this.mediator) {this.mediator.removeListener('router:navigate', this.boundMediatorNavigate);}\n        this.listenersInitialized = false;\n        return this;\n    }\n\n    /** Intercept eligible same-origin push-state links while preserving normal browser actions. */\n    eventPushStateClick(e: MouseEvent) {\n        if (typeof window === 'undefined') {return true;}\n        if (e.defaultPrevented || (e.button !== undefined && e.button !== 0) || e.metaKey || e.ctrlKey || e.shiftKey || e.altKey) {\n            return true;\n        }\n        const eventTarget = e.target as Element | null;\n        const source = eventTarget && (typeof eventTarget.closest === 'function' ? eventTarget : eventTarget.parentElement);\n        const anchor = source && typeof source.closest === 'function' ? source.closest('a[href][data-pushstate]') : null;\n        if (!anchor) {return true;}\n        const target = anchor.getAttribute('target');\n        if (anchor.hasAttribute('download') || (target && target.toLowerCase() !== '_self')) {return true;}\n        const location = new URL(anchor.getAttribute('href') || '', window.location.href || `${window.location.origin}/`);\n        if (location.origin !== window.location.origin) {return true;}\n        e.preventDefault();\n        this.url = `${location.pathname}${location.search}${location.hash}`;\n        this.navigate(undefined, {}, false);\n        return this;\n    }\n\n    /** Restore browser history state without adding a new history entry. */\n    eventPopState() {\n        if (typeof window === 'undefined') {return this;}\n        this.url = this.getCurrentUrl();\n        this.navigate(undefined, {}, true);\n        return this;\n    }\n\n    /** Decode URL query parameters, keeping the last value for duplicate keys. */\n    parseQueryString(queryString: string) {\n        return Object.fromEntries(new URLSearchParams(queryString));\n    }\n\n    /** Build decoded path, query, and mediator data for the selected route. */\n    setLocationData(mediatorData?: NavigationData) {\n        const parsedUrl = new URL(this.url || '/', this.getOrigin());\n        const matchedRoute = this.route && this.route !== 'defaultRoute' ? this.route : '';\n        this.locationData = {\n            url: this.url,\n            data: {url: [], mediator: mediatorData, query: {}}\n        };\n        this.locationData.data.url = parsedUrl.pathname\n            .slice(matchedRoute.length)\n            .split('/')\n            .filter(Boolean)\n            .map((fragment) => {\n                try {return decodeURIComponent(fragment);} catch (_error) {return fragment;}\n            });\n        this.locationData.data.query = this.parseQueryString(parsedUrl.search);\n    }\n\n    /** Update page context after a route renders. DOM effects are browser-only. */\n    applyPageContext(route: Route) {\n        if (typeof route === 'function') {\n            this.pageTitle = null;\n            return this;\n        }\n        this.pageTitle = typeof route.title === 'string' ? route.title : null;\n        if (!this.isBrowserRuntime()) {return this;}\n        if (this.pageTitle) {document.title = this.pageTitle;}\n        if (route.focus !== false) {\n            const target = document.querySelector<HTMLElement>(route.focus || 'main h1');\n            if (target) {\n                if (!target.hasAttribute('tabindex')) {target.setAttribute('tabindex', '-1');}\n                target.focus();\n            }\n        }\n        return this;\n    }\n\n    /** Select a route, enforce its guard, transition view lifecycles, and update browser history when available. */\n    navigate(url?: string, mediatorData?: NavigationData, isPopState = false) {\n        if (url !== undefined) {this.url = url;}\n        if (!this.url) {this.url = this.getCurrentUrl();}\n        const normalizedUrl = this.normalizeBrowserUrl(this.url);\n        if (normalizedUrl === null) {return false;}\n        this.url = normalizedUrl;\n        this.route = null;\n        const pathname = new URL(this.url, this.getOrigin()).pathname;\n        for (const route in this.routes) {\n            if (route === 'defaultRoute' || (pathname !== route && !pathname.startsWith(`${route}/`))) {continue;}\n            if (!this.route || route.length > this.route.length) {this.route = route;}\n        }\n        this.setLocationData(mediatorData);\n        if (!this.route && this.routes.defaultRoute) {this.route = 'defaultRoute';}\n        if (this.route) {\n            const selected = this.routes[this.route]!;\n            if (typeof selected !== 'function' && selected.secure && selected.secure(this.scope, this.locationData) !== true) {\n                return false;\n            }\n            const previous = this.previousRoute ? this.routes[this.previousRoute] : undefined;\n            if (previous && typeof previous !== 'function' && typeof previous.view === 'object' && previous.view.destroy) {\n                previous.view.destroy(this.scope, this.locationData);\n            }\n            if (typeof selected === 'function') {\n                selected(this.scope, this.locationData);\n            } else if (typeof selected.view === 'function') {\n                selected.view(this.scope, this.locationData);\n            } else if (selected.view && typeof selected.view.initialize === 'function') {\n                selected.view.initialize(this.scope, this.locationData);\n            } else {\n                return false;\n            }\n            this.applyPageContext(selected);\n            this.previousRoute = this.route;\n        }\n        if (!isPopState && this.isBrowserRuntime()) {\n            window.history.pushState(this.url, this.pageTitle || '', this.url);\n        }\n        return this;\n    }\n}\n\n/** Public route configuration and navigation payload types. */\nnamespace Router {\n    export type Handler = RouteHandler;\n    export type Route = RouteHandler | RouteObject;\n    export type Location = LocationData;\n    export type Navigation = NavigationData;\n}\nexport = Router;\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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","sourcesContent":["/** Navigation payload, including caller-defined metadata. */\ninterface NavigationData {url?: string; [key: string]: unknown}\n/** URL-derived values supplied to route handlers. */\ninterface LocationData {url: string; data: {url: string[]; mediator: NavigationData | undefined; query: Record<string, string>}}\ntype RouteHandler = (scope: Element | null, location: LocationData) => unknown;\n/** An object route can own a function or a view lifecycle. */\ninterface RouteObject {title?: string; focus?: string | false; secure?: RouteHandler; view?: RouteHandler | {initialize?: RouteHandler; destroy?: RouteHandler}}\ntype Route = RouteHandler | RouteObject;\n/** Minimal standards-based event target contract required by the router. */\ninterface NavigationMediator {\n    addEventListener(type: string, callback: EventListenerOrEventListenerObject, options?: boolean | AddEventListenerOptions): void;\n    removeEventListener(type: string, callback: EventListenerOrEventListenerObject, options?: boolean | EventListenerOptions): void;\n}\n/** History API router that also dispatches request URLs in non-browser runtimes. */\nclass Router {\n    routes: Record<string, Route>;\n    url: string;\n    route: string | null;\n    scope: Element | null;\n    previousRoute: string | null;\n    pageTitle: string | null;\n    boundPushStateClick: (event: MouseEvent) => unknown;\n    boundPopState: (event: PopStateEvent) => unknown;\n    boundMediatorNavigate: EventListener;\n    listenersInitialized: boolean;\n    locationData: LocationData = {url: '', data: {url: [], mediator: undefined, query: {}}};\n    private currentMediator: NavigationMediator | false = false;\n    private boundMediator: NavigationMediator | false = false;\n\n    /** Create an instance with its own state and listener references. */\n    constructor() {\n        this.routes = {\n            defaultRoute: {\n                view: {\n                    initialize: () => true,\n                    destroy: () => true\n                }\n            }\n        };\n        this.url = '';\n        this.route = null;\n        this.scope = null;\n        this.previousRoute = null;\n        this.pageTitle = null;\n        this.boundPushStateClick = this.eventPushStateClick.bind(this);\n        this.boundPopState = this.eventPopState.bind(this);\n        this.boundMediatorNavigate = (event: Event) => {\n            const data = (event as CustomEvent<NavigationData | undefined>).detail ?? {};\n            this.navigate(data.url, data, false);\n        };\n        this.listenersInitialized = false;\n    }\n\n    get mediator(): NavigationMediator | false {return this.currentMediator;}\n\n    /** Move an active router:navigate subscription when the mediator changes. */\n    set mediator(value: NavigationMediator | false) {\n        if (value === this.currentMediator) {return;}\n        if (this.listenersInitialized && this.boundMediator) {\n            this.boundMediator.removeEventListener('router:navigate', this.boundMediatorNavigate);\n            this.boundMediator = false;\n        }\n        this.currentMediator = value;\n        if (this.listenersInitialized && value) {\n            value.addEventListener('router:navigate', this.boundMediatorNavigate);\n            this.boundMediator = value;\n        }\n    }\n\n    /** True when browser navigation APIs are available. */\n    private isBrowserRuntime() {\n        return typeof window !== 'undefined' && typeof document !== 'undefined';\n    }\n\n    /** Stable base URL for WHATWG URL parsing in browser and server runtimes. */\n    private getOrigin() {\n        return this.isBrowserRuntime() ? window.location.origin : 'http://white-label.invalid';\n    }\n\n    /** Read the authoritative browser URL, or retain the supplied server URL. */\n    private getCurrentUrl() {\n        if (!this.isBrowserRuntime()) {return this.url || '/';}\n        return window.location.pathname + window.location.search + (window.location.hash || '');\n    }\n\n    /** Normalize browser navigation to a same-origin path, query, and hash. */\n    private normalizeBrowserUrl(url: string) {\n        if (!this.isBrowserRuntime()) {return url;}\n        const parsedUrl = new URL(url || '/', window.location.href || `${window.location.origin}/`);\n        if (parsedUrl.origin !== window.location.origin) {return null;}\n        return `${parsedUrl.pathname}${parsedUrl.search}${parsedUrl.hash}`;\n    }\n\n    /** Return whether a selected route has runnable view behavior. */\n    private isRunnableRoute(route: Route): boolean {\n        return typeof route === 'function' || typeof route.view === 'function' ||\n            Boolean(route.view && typeof route.view.initialize === 'function');\n    }\n\n    /**\n     * Start this instance and return it for lifecycle chaining.\n     * In a browser the URL is optional and defaults to window.location. On a server pass the request URL.\n     */\n    initialize(url?: string) {\n        this.url = url ?? this.getCurrentUrl();\n        this.addListeners();\n        this.navigate(undefined, {}, true);\n        return this;\n    }\n\n    /** Register browser and optional mediator handlers once. */\n    addListeners() {\n        if (this.listenersInitialized) {return this;}\n        if (this.isBrowserRuntime()) {\n            document.addEventListener('click', this.boundPushStateClick);\n            window.addEventListener('popstate', this.boundPopState);\n        }\n        if (this.currentMediator) {\n            this.currentMediator.addEventListener('router:navigate', this.boundMediatorNavigate);\n            this.boundMediator = this.currentMediator;\n        }\n        this.listenersInitialized = true;\n        return this;\n    }\n\n    /** Release owned state and listeners so the instance can leave the application lifecycle. */\n    destroy() {\n        this.removeListeners();\n        return this;\n    }\n\n    /** Release listeners owned by this instance; subclasses may extend the lifecycle hook. */\n    removeListeners() {\n        if (!this.listenersInitialized) {return this;}\n        if (this.isBrowserRuntime()) {\n            document.removeEventListener('click', this.boundPushStateClick);\n            window.removeEventListener('popstate', this.boundPopState);\n        }\n        if (this.boundMediator) {\n            this.boundMediator.removeEventListener('router:navigate', this.boundMediatorNavigate);\n            this.boundMediator = false;\n        }\n        this.listenersInitialized = false;\n        return this;\n    }\n\n    /** Intercept eligible same-origin push-state links while preserving normal browser actions. */\n    eventPushStateClick(e: MouseEvent) {\n        if (typeof window === 'undefined') {return true;}\n        if (e.defaultPrevented || (e.button !== undefined && e.button !== 0) || e.metaKey || e.ctrlKey || e.shiftKey || e.altKey) {\n            return true;\n        }\n        const eventTarget = e.target as Element | null;\n        const source = eventTarget && (typeof eventTarget.closest === 'function' ? eventTarget : eventTarget.parentElement);\n        const anchor = source && typeof source.closest === 'function' ? source.closest('a[href][data-pushstate]') : null;\n        if (!anchor) {return true;}\n        const target = anchor.getAttribute('target');\n        if (anchor.hasAttribute('download') || (target && target.toLowerCase() !== '_self')) {return true;}\n        const location = new URL(anchor.getAttribute('href') || '', window.location.href || `${window.location.origin}/`);\n        if (location.origin !== window.location.origin) {return true;}\n        e.preventDefault();\n        this.navigate(`${location.pathname}${location.search}${location.hash}`, {}, false);\n        return this;\n    }\n\n    /** Restore browser history state without adding a new history entry. */\n    eventPopState() {\n        if (typeof window === 'undefined') {return this;}\n        this.url = this.getCurrentUrl();\n        this.navigate(undefined, {}, true);\n        return this;\n    }\n\n    /** Decode URL query parameters, keeping the last value for duplicate keys. */\n    parseQueryString(queryString: string) {\n        return Object.fromEntries(new URLSearchParams(queryString));\n    }\n\n    /** Build decoded path, query, and mediator data for the selected route. */\n    setLocationData(mediatorData?: NavigationData) {\n        const parsedUrl = new URL(this.url || '/', this.getOrigin());\n        const matchedRoute = this.route && this.route !== 'defaultRoute' ? this.route : '';\n        this.locationData = {\n            url: this.url,\n            data: {url: [], mediator: mediatorData, query: {}}\n        };\n        this.locationData.data.url = parsedUrl.pathname\n            .slice(matchedRoute.length)\n            .split('/')\n            .filter(Boolean)\n            .map((fragment) => {\n                try {return decodeURIComponent(fragment);} catch (_error) {return fragment;}\n            });\n        this.locationData.data.query = this.parseQueryString(parsedUrl.search);\n    }\n\n    /** Update page context after a route renders. DOM effects are browser-only. */\n    applyPageContext(route: Route) {\n        if (typeof route === 'function') {\n            this.pageTitle = null;\n            return this;\n        }\n        this.pageTitle = typeof route.title === 'string' ? route.title : null;\n        if (!this.isBrowserRuntime()) {return this;}\n        if (this.pageTitle) {document.title = this.pageTitle;}\n        if (route.focus !== false) {\n            const target = document.querySelector<HTMLElement>(route.focus || 'main h1');\n            if (target) {\n                if (!target.hasAttribute('tabindex')) {target.setAttribute('tabindex', '-1');}\n                target.focus();\n            }\n        }\n        return this;\n    }\n\n    /** Select a route, enforce its guard, transition view lifecycles, and update browser history when available. */\n    navigate(url?: string, mediatorData?: NavigationData, isPopState = false) {\n        const previousUrl = this.url;\n        const previousSelectedRoute = this.route;\n        const previousLocationData = this.locationData;\n        if (url !== undefined) {this.url = url;}\n        if (!this.url) {this.url = this.getCurrentUrl();}\n        const normalizedUrl = this.normalizeBrowserUrl(this.url);\n        if (normalizedUrl === null) {\n            this.url = previousUrl;\n            return false;\n        }\n        this.url = normalizedUrl;\n        this.route = null;\n        const pathname = new URL(this.url, this.getOrigin()).pathname;\n        for (const route of Object.keys(this.routes)) {\n            if (route === 'defaultRoute' || (pathname !== route && !pathname.startsWith(`${route}/`))) {continue;}\n            if (!this.route || route.length > this.route.length) {this.route = route;}\n        }\n        this.setLocationData(mediatorData);\n        if (!this.route && this.routes.defaultRoute) {this.route = 'defaultRoute';}\n        if (this.route) {\n            const selected = this.routes[this.route]!;\n            if ((typeof selected !== 'function' && selected.secure && selected.secure(this.scope, this.locationData) !== true) ||\n                !this.isRunnableRoute(selected)) {\n                this.url = previousUrl;\n                this.route = previousSelectedRoute;\n                this.locationData = previousLocationData;\n                return false;\n            }\n            const previous = this.previousRoute ? this.routes[this.previousRoute] : undefined;\n            if (previous && typeof previous !== 'function' && typeof previous.view === 'object' && previous.view.destroy) {\n                previous.view.destroy(this.scope, this.locationData);\n            }\n            if (typeof selected === 'function') {\n                selected(this.scope, this.locationData);\n            } else if (typeof selected.view === 'function') {\n                selected.view(this.scope, this.locationData);\n            } else {\n                selected.view!.initialize!(this.scope, this.locationData);\n            }\n            this.applyPageContext(selected);\n            this.previousRoute = this.route;\n        }\n        if (!isPopState && this.isBrowserRuntime()) {\n            window.history.pushState(this.url, this.pageTitle || '', this.url);\n        }\n        return this;\n    }\n}\n\n/** Public route configuration and navigation payload types. */\nnamespace Router {\n    export type Handler = RouteHandler;\n    export type Route = RouteHandler | RouteObject;\n    export type Location = LocationData;\n    export type Navigation = NavigationData;\n}\nexport = Router;\n"]}

package/package.json

@@ -1,12 +1,13 @@
 {
   "name": "white-label-router",
-  "version": "5.0.0",
+  "version": "6.0.0",
   "description": "Framework-independent TypeScript router for browser, server, and request-scoped Node.js functions with progressive enhancement, guards, and accessible navigation.",
   "sideEffects": false,
   "main": "dist/index.js",
   "files": [
     "dist",
-    "README.md"
+    "README.md",
+    "PACKAGE_MANAGERS.md"
   ],
   "engines": {
     "node": "^22.18.0 || >=24.11.0"