@real-router/validation-plugin 0.31.0 → 0.32.0

package/README.md

@@ -39,6 +39,7 @@ Without this plugin, core has structural guards (constructor, plugin registratio
 - Argument shape checks for every public API call
 - `forwardTo` target existence, param compatibility, and cycle detection
 - Decoder/encoder async detection (sync required for `matchPath`/`buildPath`)
+- Codec round trips: a key a link and a reload of the same URL would commit differently, because a route's `decodeParams` does not undo its `encodeParams` or adds a key, is reported once per route and key
 - Guard answers: one that is neither `true` nor `false` is named with its type (core refuses it either way), and an async guard met by a synchronous check is reported as such
 - Dependency store structure validation
 - Limits consistency checks

package/dist/cjs/index.d.ts

@@ -1,6 +1,5 @@
 import { DefaultDependencies, PluginFactory } from "@real-router/core";
 import { RouterValidator } from "@real-router/core/validation";
-//#region src/validationPlugin.d.ts
 /**
  * The dependency map is a type parameter so the factory carries the CALLER's
  * `D` rather than the `object` default (#1621). `keyof object` is `never`, so a
@@ -15,6 +14,5 @@ import { RouterValidator } from "@real-router/core/validation";
  * this plugin actually reads dependencies.
  */
 export declare function validationPlugin<Dependencies extends DefaultDependencies = DefaultDependencies>(): PluginFactory<Dependencies>;
-//#endregion
 export type { RouterValidator };
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","names":[],"sources":["../../src/validationPlugin.ts"],"mappings":";;;;;;;;;;;;;;;;wBAkagB,iBACd,qBAAqB,sBAAsB,wBACxC,cAAc"}
+{"version":3,"file":"index.d.ts","names":[],"sources":["../../src/validationPlugin.ts"],"mappings":";;;;;;;;;;;;;;;wBAybgB,iBACd,qBAAqB,sBAAsB,wBACxC,cAAc"}

package/dist/cjs/index.js

@@ -1,2 +1,2 @@
-Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});let e=require("@real-router/core/api"),t=require("@real-router/core/utils"),n=require("@real-router/core/validation"),r=require("@real-router/core");const i=Object.freeze({maxDependencies:100,maxPlugins:50,maxListeners:1e4,warnListeners:1e3,maxLifecycleHandlers:200});function a(e){return{warn:Math.floor(e*.2),error:Math.floor(e*.5)}}function o(e){return typeof e==`string`}function s(e){return typeof e==`boolean`}function c(e,t){return e in t}const l=Object.getPrototypeOf,u=Object.values,ee=Object.hasOwn;function te(e){if(Array.isArray(e))return!0;let t=l(e);return t===null||t===Object.prototype}function ne(e,t){let n=Array.isArray(e)?e:u(e);for(let e of n)t.push(e)}function re(e){let t=typeof e;return t===`string`||t===`boolean`||t===`number`&&Number.isFinite(e)}var d=class{container;constructor(e){this.container=e}};function f(e,t,n,r){return n.has(e)?!1:r.has(e)?!0:te(e)?(n.add(e),t.push(new d(e)),ne(e,t),!0):!1}function p(e){let t=[e],n=new WeakSet,r=new WeakSet;for(;t.length>0;){let e=t.pop();if(e instanceof d)n.delete(e.container),r.add(e.container);else if(e!=null){if(typeof e==`object`){if(!f(e,t,n,r))return!1}else if(!re(e))return!1}}return!0}function ie(e){if(e==null)return!0;let t=typeof e;return t===`string`||t===`boolean`||t===`number`&&Number.isFinite(e)}function m(e){try{return ae(e)}catch{return!1}}function ae(e){if(typeof e!=`object`||!e||Array.isArray(e))return!1;let t=l(e);if(t!==null&&t!==Object.prototype)return!1;let n=!1;for(let t in e){if(!ee(e,t))continue;let r=e[t];if(!ie(r)){let e=typeof r;if(e===`function`||e===`symbol`)return!1;n=!0;break}}return!n||p(e)}const oe=[`replace`,`reload`,`force`,`forceDeactivate`,`redirected`,`revalidate`];function h(e){if(typeof e!=`object`||!e||Array.isArray(e))return!1;let t=e;for(let e of oe){let n=t[e];if(n!==void 0&&typeof n!=`boolean`)return!1}let n=t.signal;return n===void 0||n instanceof AbortSignal}const g=/\S/,_=/^[A-Z_a-z][\w-]*(?:\.[A-Z_a-z][\w-]*)*$/;function v(e,n){return(0,t.raiser)(`router`,e).type`${n}`}function se(e){return typeof e==`string`?e===``?!0:e.length>1e4?!1:e.startsWith(`@@`)?!0:_.test(e):!1}function ce(e){return se(e.name)&&typeof e.path==`string`&&m(e.params)}function y(e){return typeof e!=`object`||!e?!1:ce(e)}function b(e,t){if(typeof e!=`string`)throw v(t,`Route name must be a string, got ${typeof e}`);if(e!==``){if(!g.test(e))throw v(t,`Route name cannot contain only whitespace`);if(e.length>1e4)throw v(t,`Route name exceeds maximum length of 10000 characters. This is a technical safety limit.`);if(!e.startsWith(`@@`)&&!_.test(e))throw v(t,`Invalid route name "${e}". Each segment must start with a letter or underscore, followed by letters, numbers, underscores, or hyphens. Segments are separated by dots (e.g., "users.profile").`)}}function x(e){if(e===null)return`null`;if(typeof e!=`object`)return typeof e;try{if(Array.isArray(e))return`array[${e.length}]`;let t=e.constructor;if(typeof t==`function`){let e=t.name;if(typeof e==`string`&&e!==``&&e!==`Object`)return e}}catch{}return`object`}const S=Object.entries,le=[`defaultParams`,`defaultSearch`],ue=e=>new Map(S(e)),de=(e,t)=>{let n=S(e);return n.length!==t.size||n.some(([e,n])=>!t.has(e)||!Object.is(t.get(e),n))};var fe=class{#e=new Map;#t=new Set;watch(e){for(let t of le){let n=e[t],r=n?.deref();n!==void 0&&r!==void 0&&this.#e.set(t,{ref:n,before:ue(r)})}}check(e){for(let[t,{ref:n,before:r}]of this.#e){if(this.#t.has(t))continue;let i=n.deref();i!==void 0&&de(i,r)&&(this.#t.add(t),e.warn(`router.navigateToDefault`,`mutating \`${t}\` after createRouter() no longer affects routing — the router copied it at construction. Use the callback form (\`${t}: () => ({ … })\`), which is resolved at the point of use.`))}}};const pe=(0,t.raiser)(`cloneRouter`),me=(0,t.raiser)(`router`,`getDependency`),he=(0,t.raiser)(`router`,`setDependency`),C=Object.keys,ge=Object.getOwnPropertyDescriptor,_e=Object.getPrototypeOf,ve=Object;function ye(e){if(!e||typeof e!=`object`||Array.isArray(e))return!1;let t=_e(e);return t===null||t.constructor===ve}function be(e,n){if(typeof e!=`string`)throw(0,t.raiser)(`router`,n).type`dependency name must be a string, got ${typeof e}`}function xe(e){if(typeof e!=`string`)throw he.type`dependency name must be a string, got ${typeof e}`}function Se(e,n){if(!ye(e))throw(0,t.raiser)(`router`,n).type`Invalid argument: expected plain object, received ${x(e)}`;for(let r of C(e))if(ge(e,r)?.get)throw(0,t.raiser)(`router`,n).type`Getters not allowed: "${r}"`}function Ce(e,n,r,i){if(r===0)return;let a=new Set(n),o=0;for(let t of C(e))a.has(t)||(o+=1);let s=n.length;if(s+o>r)throw(0,t.raiser)(`router`,i).range`Dependency limit exceeded (${r}). Current: ${s}, this batch adds ${o}.`}function we(e,t){if(e===void 0)throw me.ref`dependency "${t}" not found`}function Te(e,n,r,i){if(n===0)return;let{warn:o,error:s}=a(n);if(e>=n)throw(0,t.raiser)(`router`,r).range`Dependency limit exceeded (${n}). Current: ${e}.`;e===s?i.error(`router.${r}`,`${e} dependencies registered! This indicates architectural problems. Hard limit at ${n}.`):e===o&&i.warn(`router.${r}`,`${e} dependencies registered. Consider if all are necessary.`)}function Ee(e){if(e!==void 0){if(!ye(e))throw pe.type`Invalid dependencies: expected plain object or undefined, received ${typeof e}`;for(let t of C(e))if(ge(e,t)?.get)throw pe.type`Getters not allowed in dependencies: "${t}"`}}function De(e,t,n){n.warn(`router.${t}`,`Router dependency already exists and is being overwritten:`,e)}function Oe(e,t,n){n.warn(`router.${t}`,`Overwritten:`,e.join(`, `))}function ke(e,t){t.warn(`router.removeDependency`,`Attempted to remove non-existent dependency: "${typeof e==`string`?e:String(e)}"`)}const w=(0,t.raiser)(`router`,`addEventListener`),Ae=Object.values,je=new Set(Ae(r.events));function Me(e){if(!je.has(e))throw w.type`Invalid event name: ${String(e)}. Must be one of: $start, $stop, $$start, $$leaveApprove, $$cancel, $$success, $$error`}function Ne(e,t){if(Me(e),typeof t!=`function`)throw w.type`callback must be a function, got ${typeof t}`}function Pe(e,t,n,r,o=i.maxListeners){if(o===0)return;let{warn:s,error:c}=a(o);e>=c?r.error(`router.${n}`,`${e} listeners registered for "${t}"! This is excessive. Hard limit at ${o}.`):e>=s&&r.warn(`router.${n}`,`${e} listeners registered for "${t}". Consider whether all are necessary — a growing count usually means a missing unsubscribe.`)}const T=(0,t.raiser)(`router`,`addRoute`),Fe=Object.keys;function E(e,t){return typeof e==`string`&&e!==``&&typeof t==`string`?`${e}.${t}`:t}function Ie(e,t){if(e!==void 0){if(typeof e!=`string`&&typeof e!=`function`)throw T.type`forwardTo must be a string or function for route "${t}", got ${x(e)}`;if(typeof e==`function`){let n=e.constructor.name===`AsyncFunction`,r=e.toString().includes(`__awaiter`);if(n||r)throw T.type`forwardTo callback cannot be async for route "${t}". Async functions break matchPath/buildPath.`}}}function D(e,t,n){if(e!==void 0&&(typeof e!=`object`||!e||Array.isArray(e)))throw T.type`${t} must be an object for route "${n}", got ${x(e)}`}function O(e,t){if(e.canActivate!==void 0&&typeof e.canActivate!=`function`)throw T.type`canActivate must be a function for route "${t}", got ${x(e.canActivate)}`;if(e.canDeactivate!==void 0&&typeof e.canDeactivate!=`function`)throw T.type`canDeactivate must be a function for route "${t}", got ${x(e.canDeactivate)}`;D(e.defaultParams,`defaultParams`,t),D(e.defaultSearch,`defaultSearch`,t);let{decodeParams:n,encodeParams:r}=e;if(typeof n==`function`&&n.constructor.name===`AsyncFunction`)throw T.type`decodeParams cannot be async for route "${t}". Async functions break matchPath/buildPath.`;if(typeof r==`function`&&r.constructor.name===`AsyncFunction`)throw T.type`encodeParams cannot be async for route "${t}". Async functions break matchPath/buildPath.`;if(Ie(e.forwardTo,t),e.children)for(let n of e.children)O(n,E(t,n.name))}function Le(e){let t=new Set;for(let r of e)for(let e of(0,n.buildParamMeta)(r).urlParams)t.add(e);return t}function Re(e,n,r=``,i=[]){for(let t of e){let e=r?`${r}.${t.name}`:t.name,a=[...i,t.path];if(e===n)return a;if(t.children&&n.startsWith(`${e}.`))return Re(t.children,n,e,a)}throw t.internalDefect.plain`collectPathsToRoute: route "${n}" not found`}function ze(e,t=``){let n=new Set;for(let r of e){let e=t?`${t}.${r.name}`:r.name;if(n.add(e),r.children)for(let t of ze(r.children,e))n.add(t)}return n}function Be(e,t=``){let n=new Map;for(let r of e){let e=t?`${t}.${r.name}`:r.name;if(r.forwardTo&&typeof r.forwardTo==`string`&&n.set(e,r.forwardTo),r.children)for(let[t,i]of Be(r.children,e))n.set(t,i)}return n}function Ve(e,t,n,r){return t?new Set(n.getUrlParams(e)):Le(r(e))}const He=new Set;function Ue(e,t,n,r,i,a){let o=i.hasRoute(t),s=r.has(t);if(!o&&!s)throw T.ref`forwardTo target "${t}" does not exist for route "${e}"`;let c=new Set([...a,...Le(n(e))]),l=[...Ve(t,o,i,n)].filter(e=>!c.has(e));if(l.length>0)throw T.plain`forwardTo target "${t}" requires params [${l.join(`, `)}] that are not available in source route "${e}"`}function We(e,n,i,a){let o=ze(e,a),s=t=>Re(e,a?t.slice(a.length+1):t),c=a?new Set(i.getUrlParams(a)):He,l=Be(e,a),u={...n};for(let[e,n]of l)(0,t.putField)(u,e,n);for(let[e,t]of l)Ue(e,t,s,o,i,c);for(let e of Fe(u))(0,r.resolveForwardChain)(e,u)}function Ge(e,n){if(!s(e)&&typeof e!=`function`)throw(0,t.raiser)(`router`,n).type`Handler must be a boolean or factory function, got ${x(e)}`}function Ke(e,n,r=i.maxLifecycleHandlers){if(r!==0&&e>=r)throw(0,t.raiser)(`router`,n).range`Lifecycle handler limit exceeded (${r}). This indicates too many routes with individual handlers. Consider using plugins for cross-cutting concerns.`}function qe(e,t,n,r){if(n===0)return;let{warn:i,error:o}=a(n);e>=o?r.error(`router.${t}`,`${e} lifecycle handlers registered! This is excessive. Hard limit at ${n}.`):e>=i&&r.warn(`router.${t}`,`${e} lifecycle handlers registered. Consider consolidating logic.`)}function Je(e,t,n,r){r.warn(`router.${n}`,`Overwriting existing ${t} handler for route "${e}"`)}function Ye(e,t,n){n.warn(`router.${t}`,`Guard for "${e}" returned a Promise. Sync check cannot resolve async guards — returning false.`)}function Xe(e,t){return`Guard for "${e}" must answer true or false, got ${x(t)} — read as a refusal.`}function Ze(e,t,n,r){r.warn(`router.${n}`,Xe(e,t))}function Qe(e,t,n){n.warn(`router`,Xe(e,t))}const k=(0,t.raiser)(`router`,`start`),A=(0,t.raiser)(`router`,`navigateToState`),$e=(0,t.raiser)(`router`,`navigateToDefault`),et=(0,t.raiser)(`router`,`navigate`),tt=Object.hasOwn,nt=Object.getPrototypeOf;function rt(e){if(typeof e!=`string`)throw et.type`Invalid route name: expected string, got ${x(e)}`}function it(e){if(e!==void 0&&(typeof e!=`object`||!e))throw $e.type`Invalid options: ${x(e)}. Expected NavigationOptions object.`}function at(e){if(typeof e!=`object`||!e)throw A.type`Invalid state: ${x(e)}. Expected State object.`;let t=e;if(!o(t.name))throw A.type`Invalid state.name: ${x(t.name)}. Expected string.`;if(!m(t.params))throw A.type`Invalid state.params: ${x(t.params)}. Expected plain object.`;if(!o(t.path))throw A.type`Invalid state.path: ${x(t.path)}. Expected string.`}function ot(e,n){if(!h(e))throw(0,t.raiser)(`router`,n).type`Invalid options: ${x(e)}. Expected NavigationOptions object.`}const j=/[\u0000-\u001F\u007F]/;function st(e,n){for(let r in e){if(!tt(e,r))continue;let i=e[r],a=typeof i;if(a===`symbol`||a===`bigint`)throw(0,t.raiser)(`router`,n).type`param "${r}" cannot be a ${a} — it does not round-trip through the URL path. Use a string, number, or boolean.`;if(a===`string`&&j.test(i))throw(0,t.raiser)(`router`,n).type`param "${r}" must not contain control characters (NUL / C0 / DEL) — they corrupt the URL path.`}}function M(e,n){if(e===void 0)return;let r=e!==null&&nt(e);if(Array.isArray(e)||r!==null&&r!==Object.prototype)throw(0,t.raiser)(`router`,n).type`params must be a plain object, got ${x(e)}`}function N(e,n){if(e!==void 0&&(st(e,n),!m(e)))throw(0,t.raiser)(`router`,n).type`params must be a plain object, got ${x(e)}`}function P(e,n){if(e!==void 0&&(typeof e!=`object`||!e||Array.isArray(e)))throw(0,t.raiser)(`router`,n).type`search must be a plain object, got ${x(e)}`}function ct(e){if(e!==void 0&&typeof e!=`string`)throw k.type`path must be a string, got ${x(e)}.`;if(typeof e==`string`){if(j.test(e))throw k.type`path must not contain control characters (NUL / C0 / DEL).`;if(e!==``&&!e.startsWith(`/`))throw k.type`path must start with "/", got "${e}".`}}const lt=Object.entries,ut=Object.hasOwn,F=Object.keys,dt=Object.getPrototypeOf,I={trailingSlash:[`strict`,`never`,`always`,`preserve`],queryParamsMode:[`default`,`strict`,`loose`],urlParamsEncoding:[`default`,`uri`,`uriComponent`,`none`]},ft={arrayFormat:!0,booleanFormat:!0,nullFormat:!0,numberFormat:!0},pt=new Set(F({defaultRoute:!0,defaultParams:!0,defaultSearch:!0,trailingSlash:!0,caseSensitive:!0,queryParamsMode:!0,queryParams:!0,urlParamsEncoding:!0,allowNotFound:!0,rewritePathOnMatch:!0,logger:!0,limits:!0})),mt={maxDependencies:{min:0,max:1e4},maxPlugins:{min:0,max:1e3},maxListeners:{min:0,max:1e5},warnListeners:{min:0,max:1e5},maxLifecycleHandlers:{min:0,max:1e4}};function ht(e,n,r){if(typeof n!=`number`||!Number.isInteger(n))throw(0,t.raiser)(`router`,r).type`limit "${e}" must be an integer, got ${String(n)}`;let i=mt[e];if(n<i.min||n>i.max)throw(0,t.raiser)(`router`,r).range`limit "${e}" must be between ${i.min} and ${i.max}, got ${n}`}function gt(e){let t=dt(e);return t===null||t===Object.prototype}function _t(e,n){if(!e||typeof e!=`object`||!gt(e))throw(0,t.raiser)(`router`,n).type`invalid limits: expected plain object, got ${typeof e}`;for(let[r,i]of lt(e)){if(!ut(mt,r))throw(0,t.raiser)(`router`,n).type`unknown limit: "${r}"`;i!==void 0&&ht(r,i,n)}let{warnListeners:r,maxListeners:i}=e;if(typeof r==`number`&&typeof i==`number`&&i>0&&r>i)throw(0,t.raiser)(`router`,n).range`"limits.warnListeners" (${r}) must not exceed "limits.maxListeners" (${i}) — the warning channel would be unreachable`}function L(e,n,r,i){if(e!==void 0&&(typeof e!=`string`||!r.includes(e))){let a=r.map(e=>`"${e}"`).join(`, `),o=typeof e==`string`?e:`(${typeof e})`;throw(0,t.raiser)(`router`,i).type`Invalid "${n}": "${o}". Must be one of: ${a}`}}function vt(e,n){if(e!==void 0&&typeof e!=`string`&&typeof e!=`function`)throw(0,t.raiser)(`router`,n).type`Invalid "defaultRoute": expected string or function, got ${typeof e}`}function yt(e,n,r){if(e!==void 0&&typeof e!=`function`&&(!e||typeof e!=`object`||Array.isArray(e)||!gt(e)))throw(0,t.raiser)(`router`,r).type`Invalid "${n}": expected plain object or function, got ${typeof e}`}function bt(e,n){if(e===void 0)return;if(!e||typeof e!=`object`||Array.isArray(e))throw(0,t.raiser)(`router`,n).type`Invalid "queryParams": expected plain object`;let r=e;for(let e of F(r))if(!c(e,ft))throw(0,t.raiser)(`router`,n).type`Invalid "queryParams.${e}": unknown option`}function xt(e,n){if(!e||typeof e!=`object`||Array.isArray(e))throw(0,t.raiser)(`router`,n).type`Invalid options: expected plain object`;let r=e;for(let e of F(r))if(!pt.has(e))throw(0,t.raiser)(`router`,n).type`Unknown option: "${e}"`;if(vt(r.defaultRoute,n),yt(r.defaultParams,`defaultParams`,n),yt(r.defaultSearch,`defaultSearch`,n),L(r.trailingSlash,`trailingSlash`,I.trailingSlash,n),L(r.queryParamsMode,`queryParamsMode`,I.queryParamsMode,n),L(r.urlParamsEncoding,`urlParamsEncoding`,I.urlParamsEncoding,n),r.allowNotFound!==void 0&&typeof r.allowNotFound!=`boolean`)throw(0,t.raiser)(`router`,n).type`Invalid "allowNotFound": expected boolean, got ${typeof r.allowNotFound}`;if(r.rewritePathOnMatch!==void 0&&typeof r.rewritePathOnMatch!=`boolean`)throw(0,t.raiser)(`router`,n).type`Invalid "rewritePathOnMatch": expected boolean, got ${typeof r.rewritePathOnMatch}`;if(r.caseSensitive!==void 0&&typeof r.caseSensitive!=`boolean`)throw(0,t.raiser)(`router`,n).type`Invalid "caseSensitive": expected boolean, got ${typeof r.caseSensitive}`;bt(r.queryParams,n),r.limits!==void 0&&_t(r.limits,n)}const R=(0,t.raiser)(`router`,`usePlugin`),St=Object.hasOwn,z=`router.usePlugin`,Ct={onStart:!0,onStop:!0,onTransitionStart:!0,onTransitionLeaveApprove:!0,onTransitionSuccess:!0,onTransitionError:!0,onTransitionCancel:!0};function wt(e,t,n=i.maxPlugins){if(n!==0&&e+t>n)throw R.range`Plugin limit exceeded (${n}). Current: ${e}, Attempting to add: ${t}. This indicates an architectural problem. Consider consolidating plugins.`}function Tt(e,t){if(t.includes(e))throw R.plain`Plugin factory already registered. To re-register, first unsubscribe the existing plugin.`}function Et(e,t,n){if(t===0)return;let{warn:r,error:i}=a(t);e>=i?n.error(z,`${e} plugins registered! This is excessive. Hard limit at ${t}.`):e>=r&&n.warn(z,`${e} plugins registered. Consider if all are necessary.`)}function Dt(e){for(let t in e)if(!(t===`teardown`||St(Ct,t)))throw R.type`Unknown property '${t}'. Plugin must only contain event handlers and optional teardown.`}function Ot(e){e.warn(z,`Duplicate factory in batch, will be registered once`)}function kt(e,t){t.warn(z,`Property '${e}' is not a function, skipping`)}function At(e,t){e===`onStart`&&t.warn(z,`Router already started, onStart will not be called`)}const jt=(0,t.raiser)(`router`,`navigateToDefault`),B=(0,t.raiser)(`validation-plugin`),V=Object.entries,Mt=Object.getOwnPropertyDescriptor,Nt=Object.keys;function H(e,t,n=``){for(let r of e){let e=n?`${n}.${r.name}`:r.name;t(r,e),r.children&&H(r.children,t,e)}}function U(e,t){let n=[];return H(e,(e,r)=>{let i=t(e);i!==void 0&&n.push([r,i])}),n}function Pt(e,t){try{return(0,r.resolveForwardChain)(e,t)}catch(e){let t=e.message.replace(/^\[router\] /u,``);throw B.plain({cause:e})`${t}`}}function W(e,t,n){let r=e;if(r.constructor.name===`AsyncFunction`||r.toString().includes(`__awaiter`))throw B.type`Route "${n}" ${t} cannot be async`}function Ft(e){H(e,(e,t)=>{if(typeof e.name!=`string`||!e.name)throw B.type`validateExistingRoutes: route has invalid name: ${e.name}`;if(typeof e.path!=`string`)throw B.type`validateExistingRoutes: route "${t}" has non-string path (${typeof e.path})`})}function It(e,t){for(let[n,r]of V(e)){if(!t.hasRoute(r))throw B.plain`validateForwardToConsistency: forwardTo target "${r}" does not exist in tree (source route: "${n}")`;let e=new Set(t.getUrlParams(n)),i=[...new Set(t.getUrlParams(r))].filter(t=>!e.has(t));if(i.length>0)throw B.plain`validateForwardToConsistency: forwardTo target "${r}" requires params [${i.join(`, `)}] not available in source route "${n}"`}for(let t of Nt(e))Pt(t,e)}function Lt(e,t){for(let[n,r]of e)if(typeof r!=`object`||!r||Array.isArray(r))throw B.type`validateRoutePropertiesStore: route "${n}" ${t} must be a plain object, got ${Array.isArray(r)?`array`:typeof r}`}function Rt(e){let t=U(e,e=>e.decodeParams),n=U(e,e=>e.encodeParams),r=U(e,e=>typeof e.forwardTo==`string`?void 0:e.forwardTo);for(let[e,n]of t){if(typeof n!=`function`)throw B.type`validateRoutePropertiesStore: route "${e}" decoder must be a function, got ${typeof n}`;W(n,`decoder`,e)}for(let[e,t]of n){if(typeof t!=`function`)throw B.type`validateRoutePropertiesStore: route "${e}" encoder must be a function, got ${typeof t}`;W(t,`encoder`,e)}Lt(U(e,e=>e.defaultParams),`defaultParams`),Lt(U(e,e=>e.defaultSearch),`defaultSearch`);for(let[e,t]of r){if(typeof t!=`function`)throw B.type`validateRoutePropertiesStore: route "${e}" forwardTo callback must be a function, got ${typeof t}`;W(t,`forwardTo callback`,e)}}function zt(e,t){for(let[n,r]of V(e))if(!t.hasRoute(r))throw B.plain`validateForwardToTargetsStore: forwardTo target "${r}" does not exist for route "${n}"`}function Bt(e,t){for(let t of Nt(e))if(Mt(e,t)?.get)throw B.type`validateDependenciesStructure: dependency "${t}" must not use a getter`;for(let[e,n]of V(t))if(!Number.isInteger(n))throw B.type`validateDependenciesStructure: deps.limits.${e} must be an integer, got ${String(n)}`}function Vt(e,t,n){let r=e&&typeof e==`object`?e:{},i=(r.limits&&typeof r.limits==`object`?r.limits:{}).maxDependencies,a=typeof i==`number`?i:n;if(a>0&&t>a)throw B.range`validateLimitsConsistency: dependency count (${t}) exceeds maxDependencies limit (${a})`}function Ht(e,t){return typeof e==`string`&&e!==``&&!t.hasRoute(e)}function Ut(e,t){if(Ht(e,t))throw B.plain`defaultRoute resolved to non-existent route: "${e}"`}function Wt(e,t){if(Ht(e,t))throw jt.plain`defaultRoute callback resolved to non-existent route: "${e}"`}function Gt(e,t,n){for(let r of e)t.hasRoute(r)||n.warn(`router.start`,`Guard registered for route "${r}", which the route tree does not contain. It will never run unless that route is added. Check the name for a typo.`)}const G=(0,t.raiser)(`router`,`updateRoute`),K=(0,t.raiser)(`router`,`addRoute`),Kt=(0,t.raiser)(`router`,`shouldUpdateNode`),qt=(0,t.raiser)(`router`,`matchPath`),Jt=(0,t.raiser)(`router`,`buildPath`),q=(0,t.raiser)(`router`,`isActiveRoute`),Yt=(0,t.raiser)(`router`,`setRootPath`);function J(e,n){if(e.startsWith(`@@`))throw(0,t.raiser)(`router`,n).plain`Route name "${e}" uses the reserved "${`@@`}" prefix. Routes with this prefix are internal and cannot be modified through the public API.`}function Xt(e,t){for(let n of e)n&&typeof n==`object`&&typeof n.name==`string`&&(J(n.name,t),n.children&&Xt(n.children,t))}function Zt(e){b(e,`removeRoute`)}function Qt(e){if(typeof e!=`string`)throw Yt.type`rootPath must be a string, got ${x(e)}`}function Y(e){return e.constructor.name===`AsyncFunction`||String(e).includes(`__awaiter`)}function $t(e){let t=e;if(t.canActivate!==void 0&&typeof t.canActivate!=`function`)throw K.type`canActivate must be a function, got ${x(t.canActivate)}`;if(t.canDeactivate!==void 0&&typeof t.canDeactivate!=`function`)throw K.type`canDeactivate must be a function, got ${x(t.canDeactivate)}`}function en(e,t){let n=e;if(typeof n.decodeParams==`function`&&Y(n.decodeParams))throw K.type`decodeParams cannot be async for route "${String(t)}"`;if(typeof n.encodeParams==`function`&&Y(n.encodeParams))throw K.type`encodeParams cannot be async for route "${String(t)}"`;if(typeof n.forwardTo==`function`&&Y(n.forwardTo))throw K.type`forwardTo callback cannot be async for route "${String(t)}"`}function tn(e,t){for(let n of e){if(typeof n!=`object`||!n||Array.isArray(n))throw K.type`Route must be an object, got ${x(n)}`;O(n,E(t,n.name))}}function nn(e){if(typeof e!=`string`||e===``)throw K.type`parent option must be a non-empty string, got ${x(e)}`;b(e,`addRoute`)}function rn(e,t,n,r){if(!o(e))throw q.type`name must be a string, got ${typeof e}`;if(M(t,`isActiveRoute`),n!==void 0&&typeof n!=`boolean`)throw q.type`strictEquality must be a boolean, got ${typeof n}`;if(r!==void 0&&typeof r!=`boolean`)throw q.type`ignoreQueryParams must be a boolean, got ${typeof r}`}function X(e,n,r){if(!o(e))throw(0,t.raiser)(`router`,r).type`Invalid routeName: ${x(e)}. Expected string.`;if(!m(n))throw(0,t.raiser)(`router`,r).type`Invalid routeParams: ${x(n)}. Expected plain object.`}function an(e,t){if(b(e,`updateRoute`),e===``)throw G.ref`Invalid name: empty string. Cannot update root node.`;if(t===null)throw G.type`updates must be an object, got null`;if(typeof t!=`object`||Array.isArray(t))throw G.type`updates must be an object, got ${x(t)}`}function on(e,t){if(e.constructor.name===`AsyncFunction`||e.toString().includes(`__awaiter`))throw G.type`${t} cannot be an async function`}function Z(e,t){if(e!=null){if(typeof e!=`function`)throw G.type`${t} must be a function or null, got ${typeof e}`;on(e,t)}}function sn(e){let{forwardTo:t,defaultParams:n,defaultSearch:r,decodeParams:i,encodeParams:a,canActivate:o,canDeactivate:s}=e;if(t!=null){if(typeof t!=`string`&&typeof t!=`function`)throw G.type`forwardTo must be a string, function, or null, got ${x(t)}`;typeof t==`function`&&on(t,`forwardTo callback`)}cn(n,`defaultParams`),cn(r,`defaultSearch`),Z(i,`decodeParams`),Z(a,`encodeParams`),Z(o,`canActivate`),Z(s,`canDeactivate`)}function cn(e,t){if(e!=null&&(typeof e!=`object`||Array.isArray(e)))throw G.type`${t} must be an object or null, got ${x(e)}`}function ln(e){if(!o(e)||e===``)throw Jt.type`route must be a non-empty string, got ${typeof e==`string`?`""`:typeof e}`}function un(e){let t=new Set;return function(r,i){let a=(0,n.findMisChanneledKey)(i,e(r));if(a===void 0)return;let o=`${r} ${a}`;t.has(o)||(t.add(o),console.warn(`[router] Route "${r}" declares \`${a}\` as a query param, but it was given in the \`params\` bag — the path channel. The URL is built without it, so the href does not match what you asked for; a plain click throws, but a ⌘-click, a copied link and server-rendered markup all follow the wrong URL in silence. Pass it in \`search\` instead.`))}}function dn(e){if(!o(e))throw qt.type`path must be a string, got ${typeof e}`}function fn(e){if(!o(e))throw Kt.type`nodeName must be a string, got ${typeof e}`}function pn(e,t,r,i,a){if(a){let e=t;for(let t of a.split(`.`))if(e=e.children.get(t),!e)throw K.ref`Parent route "${a}" does not exist`}let o=new Set,s=new Map;for(let r of e)(0,n.validateRoute)(r,`addRoute`,t,a??``,o,s);We(e,i,r,a)}function mn(e,t,n){let r=new Set(n.getUrlParams(e)),i=n.getUrlParams(t).filter(e=>!r.has(e));if(i.length>0)throw G.plain`forwardTo target "${t}" requires params [${i.join(`, `)}] that are not available in source route "${e}"`}function hn(e,t,n){let i={...n,[e]:t};(0,r.resolveForwardChain)(e,i)}function gn(e,t,n,r){if(!n.hasRoute(e))throw G.ref`route "${e}" does not exist`;if(t!=null&&typeof t==`string`){if(!n.hasRoute(t))throw G.plain`forwardTo target "${t}" does not exist`;mn(e,t,n),hn(e,t,r)}}const Q=(0,t.raiser)(`router`,`makeState`);function _n(e,t,n){if(!o(e))throw Q.type`Invalid name: ${x(e)}. Expected string.`;if(t!==void 0&&!m(t))throw Q.type`Invalid params: ${x(t)}. Expected plain object.`;if(n!==void 0&&!o(n))throw Q.type`Invalid path: ${x(n)}. Expected string.`}function vn(){let e=new Set;return function(t,n){let r=`${t} ${n}`;e.has(r)||(e.add(r),console.warn(`[router] Query key "${n}" is not declared on route "${t}" (\`?${n}\`), so the current \`queryParamsMode\` will not print it — it was dropped from \`state.search\` rather than published beside a \`state.path\` that cannot show it. Declare it on the route path, or use \`queryParamsMode: "loose"\` to keep undeclared keys. A \`defaultSearch\` entry for "${n}" is dead config in this mode for the same reason.`))}}function yn(){let e=new Set;return function(t,n){let r=`${t} ${n}`;e.has(r)||(e.add(r),console.warn(`[router] Param "${n}" is declared nowhere on route "${t}" — neither as a path slot (:${n}) nor as a query param (?${n}), so it stays in state.params but never reaches the URL. The state will not round-trip: matchPath(state.path) cannot recover it. Declare it on the route path if it belongs in the URL, or pass it through the search channel; keep it here only if it is deliberately app-level data.`))}}const bn=(0,t.raiser)(`validation-plugin`),xn=(0,t.raiser)(`router`,`addRoute`),$=(0,t.raiser)(`router`,`areStatesEqual`);function Sn(e){return{hasRoute:t=>{let n=e.getTree();for(let e of t.split(`.`))if(n=n?.children.get(e),!n)return!1;return!0},getUrlParams:t=>e.getUrlParams(t)}}const Cn={hasRoute:()=>!1,getUrlParams:()=>[]};function wn(e){return{tree:{...e,children:new Map,nonAbsoluteChildren:[]},lookup:Cn,forwardMap:{}}}function Tn(e,t){let n=[];for(let r of e.getTree().children.keys())n.push(t.get(r));return n}function En(e,t,n){let r=un(t=>e.getDeclaredQueryNames(t));return{routes:{validateBuildPathArgs(e,t){ln(e),r(e,t)},validateMatchPathArgs:dn,validateIsActiveRouteArgs(e,t,n,i){rn(e,t,n,i),r(e,t)},validateShouldUpdateNodeArgs:fn,validateStateBuilderArgs:X,validateRouteName(e,t){b(e,t)},validateSetRootPathArgs:Qt},options:{validateOptions:xt,validateResolvedDefaultRoute(e){Wt(e,t)}},dependencies:{validateDependencyName:be,validateSetDependencyArgs(e,t,n){xe(e)},validateDependenciesObject(t,n){Se(t,n),Ce(t,e.getDependencyKeys(),e.getResolvedLimits().maxDependencies,n)},validateDependencyExists(e,t){we(t,e)},validateDependencyCount(t,n,r){Te(t,n,r,e.logger)},validateCloneArgs:Ee,warnOverwrite(t,n){De(t,n,e.logger)},warnBatchOverwrite(t,n){Oe(t,n,e.logger)},warnRemoveNonExistent(t){ke(t,e.logger)}},plugins:{validatePluginLimit(e,t){wt(e,1,t?.maxPlugins)},validateNoDuplicatePlugins:Tt,validatePluginKeys:Dt,validateCountThresholds(t){Et(t,e.getOptions().limits?.maxPlugins??i.maxPlugins,e.logger)},warnBatchDuplicates(){Ot(e.logger)},warnPluginMethodType(t){kt(t,e.logger)}},lifecycle:{validateHandlerLimit(t,n){Ke(t,n,e.getOptions().limits?.maxLifecycleHandlers??i.maxLifecycleHandlers)},validateCountThresholds(t,n){qe(t,n,e.getOptions().limits?.maxLifecycleHandlers??i.maxLifecycleHandlers,e.logger)},warnOverwrite(t,n,r){Je(t,n,r,e.logger)},warnAsyncGuardSync(t,n){Ye(t,n,e.logger)},warnNonBooleanGuardSync(t,n,r){Ze(t,n,r,e.logger)},warnNonBooleanGuard(t,n){Qe(t,n,e.logger)}},navigation:{validateNavigateToDefaultArgs(t){it(t),n.check(e.logger)},validateNavigateToStateArgs:at,validateNavigationOptions:ot,validateParamsShape:M,validateSearch:P,validateStartArgs:ct},state:{validateMakeStateArgs:_n,reportDroppedQueryKey:vn(),reportUndeclaredParamKey:yn(),validateAreStatesEqualArgs(e,t,n){if(!y(e))throw $.type`Invalid state1: ${x(e)}. Expected State object.`;if(!y(t))throw $.type`Invalid state2: ${x(t)}. Expected State object.`;if(n!==void 0&&!s(n))throw $.type`Invalid ignoreQueryParams: ${x(n)}. Expected boolean.`}},eventBus:{validateListenerArgs(e,t){Ne(e,t)},validateCountThresholds(t,n,r){let a=e.getOptions().limits?.maxListeners??i.maxListeners;Pe(t,n,r,e.logger,a)}}}}function Dn(){return t=>{let r=(0,n.getInternals)(t),i=(0,e.getPluginApi)(t);if(t.isActive())throw bn.code(`VALIDATION_PLUGIN_AFTER_START`)`must be registered before router.start()`;if(r.validator!==null)throw bn.code(`VALIDATION_PLUGIN_ALREADY_INSTALLED`)`is already installed on this router — a clone re-runs plugin factories, so it needs no usePlugin of its own`;let a=new fe;a.watch(i.getAdoptedOrigins());let o=Sn(i),s=En(i,o,a),c=()=>{r.validator===s&&(r.validator=null)};r.validator=s;try{let n=Tn(i,(0,e.getRoutesApi)(t)),a=i.getForwardMap(),s=i.getResolvedLimits(),c=i.getOptions();Ft(n),It(a,o),Rt(n),zt(a,o),Bt(r.dependenciesGetStore().dependencies,s),Vt(c,i.getDependencyKeys().length,s.maxDependencies),r.validator.options.validateOptions(c,`constructor (retrospective)`),typeof c.defaultRoute==`string`&&Ut(c.defaultRoute,o)}catch(e){throw c(),e}let l=i.addInterceptor(`start`,(e,t)=>{try{Gt(i.getExternalGuardNames(),o,i.logger)}catch{}return e(t)}),u=i.addCheck(`buildPath:params`,e=>{N(e,`buildPath`)}),ee=i.addCheck(`buildPathResolved:params`,e=>{N(e,`buildPathResolved`)}),te=i.addCheck(`canNavigateTo:entry`,(e,t,n)=>{b(e,`canNavigateTo`),M(t,`canNavigateTo`),P(n,`canNavigateTo`)}),ne=i.addCheck(`canNavigateTo:params`,e=>{N(e,`canNavigateTo`)}),re=i.addCheck(`navigate:entry`,(e,t,n,r)=>{rt(e),M(t,`navigate`),P(n,`navigate`),ot(r,`navigate`)}),d=i.addCheck(`navigate:params`,e=>{N(e,`navigate`)}),f=(e,t)=>{for(let n of e){let e=E(t,n.name);$t(n),en(n,e),n.children!==void 0&&f(n.children,e)}},p=(e,t,n,r)=>{if(f(e,typeof n==`string`&&o.hasRoute(n)?n:void 0),n!==void 0&&(nn(n),!o.hasRoute(n)))throw xn.ref`Parent route "${n}" does not exist`;Xt(e,t),tn(e,n);let i=r();pn(e,i.tree,i.lookup,i.forwardMap,n)},ie=i.addCheck(`addRoute:batch`,(e,t)=>{p(e,`addRoute`,t,()=>({tree:i.getTree(),lookup:o,forwardMap:i.getForwardMap()}))}),m=i.addCheck(`replaceRoutes:batch`,e=>{p(e,`replaceRoutes`,void 0,()=>wn(i.getTree()))}),ae=i.addCheck(`removeRoute:entry`,e=>{Zt(e),J(e,`removeRoute`)}),oe=i.addCheck(`updateRoute:entry`,(e,t)=>{let n=t;an(e,t),J(e,`updateRoute`),sn({forwardTo:n.forwardTo,defaultParams:n.defaultParams,defaultSearch:n.defaultSearch,decodeParams:n.decodeParams,encodeParams:n.encodeParams,canActivate:n.canActivate,canDeactivate:n.canDeactivate}),gn(e,n.forwardTo,o,i.getForwardMap())}),h=i.addCheck(`hasRoute:entry`,e=>{b(e,`hasRoute`)}),g=i.addCheck(`getRoute:entry`,e=>{b(e,`getRoute`)}),_=i.addCheck(`forwardState:entry`,(e,t,n)=>{X(e,t,`forwardState`),P(n,`forwardState`)}),v=i.addCheck(`buildNavigationState:state`,(e,t,n)=>{P(n,`buildNavigationState`),X(e,t,`buildNavigationState`)}),se=i.addCheck(`addActivateGuard:entry`,(e,t)=>{b(e,`addActivateGuard`),Ge(t,`addActivateGuard`)}),ce=i.addCheck(`addDeactivateGuard:entry`,(e,t)=>{b(e,`addDeactivateGuard`),Ge(t,`addDeactivateGuard`)}),y=i.addCheck(`removeActivateGuard:entry`,e=>{b(e,`removeActivateGuard`)}),x=i.addCheck(`removeDeactivateGuard:entry`,e=>{b(e,`removeDeactivateGuard`)}),S=i.subscribeDiagnostic(`PLUGIN_AFTER_START`,e=>{At(e,i.logger)});return{teardown(){u(),ee(),te(),ne(),re(),d(),ie(),m(),ae(),oe(),h(),g(),_(),v(),se(),ce(),y(),x(),S(),l(),c()}}}}exports.validationPlugin=Dn;
+Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});let e=require("@real-router/core/api"),t=require("@real-router/core/utils"),n=require("@real-router/core/validation"),r=require("@real-router/core");const i=Object.freeze({maxDependencies:100,maxPlugins:50,maxListeners:1e4,warnListeners:1e3,maxLifecycleHandlers:200});function a(e){return{warn:Math.floor(e*.2),error:Math.floor(e*.5)}}function o(e){return typeof e==`string`}function s(e){return typeof e==`boolean`}function c(e,t){return e in t}const l=Object.getPrototypeOf,u=Object.values,ee=Object.hasOwn;function te(e){if(Array.isArray(e))return!0;let t=l(e);return t===null||t===Object.prototype}function ne(e,t){let n=Array.isArray(e)?e:u(e);for(let e of n)t.push(e)}function re(e){let t=typeof e;return t===`string`||t===`boolean`||t===`number`&&Number.isFinite(e)}var d=class{container;constructor(e){this.container=e}};function f(e,t,n,r){return n.has(e)?!1:r.has(e)?!0:te(e)?(n.add(e),t.push(new d(e)),ne(e,t),!0):!1}function p(e){let t=[e],n=new WeakSet,r=new WeakSet;for(;t.length>0;){let e=t.pop();if(e instanceof d)n.delete(e.container),r.add(e.container);else if(e!=null){if(typeof e==`object`){if(!f(e,t,n,r))return!1}else if(!re(e))return!1}}return!0}function ie(e){if(e==null)return!0;let t=typeof e;return t===`string`||t===`boolean`||t===`number`&&Number.isFinite(e)}function m(e){try{return ae(e)}catch{return!1}}function ae(e){if(typeof e!=`object`||!e||Array.isArray(e))return!1;let t=l(e);if(t!==null&&t!==Object.prototype)return!1;let n=!1;for(let t in e){if(!ee(e,t))continue;let r=e[t];if(!ie(r)){let e=typeof r;if(e===`function`||e===`symbol`)return!1;n=!0;break}}return!n||p(e)}const h=[`replace`,`reload`,`force`,`forceDeactivate`,`redirected`,`revalidate`];function oe(e){if(typeof e!=`object`||!e||Array.isArray(e))return!1;let t=e;for(let e of h){let n=t[e];if(n!==void 0&&typeof n!=`boolean`)return!1}let n=t.signal;return n===void 0||n instanceof AbortSignal}const g=/\S/,_=/^[A-Z_a-z][\w-]*(?:\.[A-Z_a-z][\w-]*)*$/;function v(e,n){return(0,t.raiser)(`router`,e).type`${n}`}function se(e){return typeof e==`string`?e===``?!0:e.length>1e4?!1:e.startsWith(`@@`)?!0:_.test(e):!1}function ce(e){return se(e.name)&&typeof e.path==`string`&&m(e.params)}function y(e){return typeof e!=`object`||!e?!1:ce(e)}function b(e,t){if(typeof e!=`string`)throw v(t,`Route name must be a string, got ${typeof e}`);if(e!==``){if(!g.test(e))throw v(t,`Route name cannot contain only whitespace`);if(e.length>1e4)throw v(t,`Route name exceeds maximum length of 10000 characters. This is a technical safety limit.`);if(!e.startsWith(`@@`)&&!_.test(e))throw v(t,`Invalid route name "${e}". Each segment must start with a letter or underscore, followed by letters, numbers, underscores, or hyphens. Segments are separated by dots (e.g., "users.profile").`)}}function x(e){if(e===null)return`null`;if(typeof e!=`object`)return typeof e;try{if(Array.isArray(e))return`array[${e.length}]`;let t=e.constructor;if(typeof t==`function`){let e=t.name;if(typeof e==`string`&&e!==``&&e!==`Object`)return e}}catch{}return`object`}const S=Object.entries,le=[`defaultParams`,`defaultSearch`],ue=e=>new Map(S(e)),de=(e,t)=>{let n=S(e);return n.length!==t.size||n.some(([e,n])=>!t.has(e)||!Object.is(t.get(e),n))};var fe=class{#e=new Map;#t=new Set;watch(e){for(let t of le){let n=e[t],r=n?.deref();n!==void 0&&r!==void 0&&this.#e.set(t,{ref:n,before:ue(r)})}}check(e){for(let[t,{ref:n,before:r}]of this.#e){if(this.#t.has(t))continue;let i=n.deref();i!==void 0&&de(i,r)&&(this.#t.add(t),e.warn(`router.navigateToDefault`,`mutating \`${t}\` after createRouter() no longer affects routing — the router copied it at construction. Use the callback form (\`${t}: () => ({ … })\`), which is resolved at the point of use.`))}}};const pe=(0,t.raiser)(`cloneRouter`),me=(0,t.raiser)(`router`,`getDependency`),he=(0,t.raiser)(`router`,`setDependency`),C=Object.keys,ge=Object.getOwnPropertyDescriptor,_e=Object.getPrototypeOf,ve=Object;function ye(e){if(!e||typeof e!=`object`||Array.isArray(e))return!1;let t=_e(e);return t===null||t.constructor===ve}function be(e,n){if(typeof e!=`string`)throw(0,t.raiser)(`router`,n).type`dependency name must be a string, got ${typeof e}`}function xe(e){if(typeof e!=`string`)throw he.type`dependency name must be a string, got ${typeof e}`}function Se(e,n){if(!ye(e))throw(0,t.raiser)(`router`,n).type`Invalid argument: expected plain object, received ${x(e)}`;for(let r of C(e))if(ge(e,r)?.get)throw(0,t.raiser)(`router`,n).type`Getters not allowed: "${r}"`}function Ce(e,n,r,i){if(r===0)return;let a=new Set(n),o=0;for(let t of C(e))a.has(t)||(o+=1);let s=n.length;if(s+o>r)throw(0,t.raiser)(`router`,i).range`Dependency limit exceeded (${r}). Current: ${s}, this batch adds ${o}.`}function we(e,t){if(e===void 0)throw me.ref`dependency "${t}" not found`}function Te(e,n,r,i){if(n===0)return;let{warn:o,error:s}=a(n);if(e>=n)throw(0,t.raiser)(`router`,r).range`Dependency limit exceeded (${n}). Current: ${e}.`;e===s?i.error(`router.${r}`,`${e} dependencies registered! This indicates architectural problems. Hard limit at ${n}.`):e===o&&i.warn(`router.${r}`,`${e} dependencies registered. Consider if all are necessary.`)}function Ee(e){if(e!==void 0){if(!ye(e))throw pe.type`Invalid dependencies: expected plain object or undefined, received ${typeof e}`;for(let t of C(e))if(ge(e,t)?.get)throw pe.type`Getters not allowed in dependencies: "${t}"`}}function De(e,t,n){n.warn(`router.${t}`,`Router dependency already exists and is being overwritten:`,e)}function Oe(e,t,n){n.warn(`router.${t}`,`Overwritten:`,e.join(`, `))}function ke(e,t){t.warn(`router.removeDependency`,`Attempted to remove non-existent dependency: "${typeof e==`string`?e:String(e)}"`)}const w=(0,t.raiser)(`router`,`addEventListener`),Ae=Object.values,je=new Set(Ae(r.events));function Me(e){if(!je.has(e))throw w.type`Invalid event name: ${String(e)}. Must be one of: $start, $stop, $$start, $$leaveApprove, $$cancel, $$success, $$error`}function Ne(e,t){if(Me(e),typeof t!=`function`)throw w.type`callback must be a function, got ${typeof t}`}function Pe(e,t,n,r,o=i.maxListeners){if(o===0)return;let{warn:s,error:c}=a(o);e>=c?r.error(`router.${n}`,`${e} listeners registered for "${t}"! This is excessive. Hard limit at ${o}.`):e>=s&&r.warn(`router.${n}`,`${e} listeners registered for "${t}". Consider whether all are necessary — a growing count usually means a missing unsubscribe.`)}const T=(0,t.raiser)(`router`,`addRoute`),Fe=Object.keys;function E(e,t){return typeof e==`string`&&e!==``&&typeof t==`string`?`${e}.${t}`:t}function Ie(e,t){if(e!==void 0){if(typeof e!=`string`&&typeof e!=`function`)throw T.type`forwardTo must be a string or function for route "${t}", got ${x(e)}`;if(typeof e==`function`){let n=e.constructor.name===`AsyncFunction`,r=e.toString().includes(`__awaiter`);if(n||r)throw T.type`forwardTo callback cannot be async for route "${t}". Async functions break matchPath/buildPath.`}}}function Le(e,t,n){if(e!==void 0&&(typeof e!=`object`||!e||Array.isArray(e)))throw T.type`${t} must be an object for route "${n}", got ${x(e)}`}function Re(e,t){if(e.canActivate!==void 0&&typeof e.canActivate!=`function`)throw T.type`canActivate must be a function for route "${t}", got ${x(e.canActivate)}`;if(e.canDeactivate!==void 0&&typeof e.canDeactivate!=`function`)throw T.type`canDeactivate must be a function for route "${t}", got ${x(e.canDeactivate)}`;Le(e.defaultParams,`defaultParams`,t),Le(e.defaultSearch,`defaultSearch`,t);let{decodeParams:n,encodeParams:r}=e;if(typeof n==`function`&&n.constructor.name===`AsyncFunction`)throw T.type`decodeParams cannot be async for route "${t}". Async functions break matchPath/buildPath.`;if(typeof r==`function`&&r.constructor.name===`AsyncFunction`)throw T.type`encodeParams cannot be async for route "${t}". Async functions break matchPath/buildPath.`;if(Ie(e.forwardTo,t),e.children)for(let n of e.children)Re(n,E(t,n.name))}function ze(e){let t=new Set;for(let r of e)for(let e of(0,n.buildParamMeta)(r).urlParams)t.add(e);return t}function Be(e,n,r=``,i=[]){for(let t of e){let e=r?`${r}.${t.name}`:t.name,a=[...i,t.path];if(e===n)return a;if(t.children&&n.startsWith(`${e}.`))return Be(t.children,n,e,a)}throw t.internalDefect.plain`collectPathsToRoute: route "${n}" not found`}function Ve(e,t=``){let n=new Set;for(let r of e){let e=t?`${t}.${r.name}`:r.name;if(n.add(e),r.children)for(let t of Ve(r.children,e))n.add(t)}return n}function He(e,t=``){let n=new Map;for(let r of e){let e=t?`${t}.${r.name}`:r.name;if(r.forwardTo&&typeof r.forwardTo==`string`&&n.set(e,r.forwardTo),r.children)for(let[t,i]of He(r.children,e))n.set(t,i)}return n}function Ue(e,t,n,r){return t?new Set(n.getUrlParams(e)):ze(r(e))}const We=new Set;function Ge(e,t,n,r,i,a){let o=i.hasRoute(t),s=r.has(t);if(!o&&!s)throw T.ref`forwardTo target "${t}" does not exist for route "${e}"`;let c=new Set([...a,...ze(n(e))]),l=[...Ue(t,o,i,n)].filter(e=>!c.has(e));if(l.length>0)throw T.plain`forwardTo target "${t}" requires params [${l.join(`, `)}] that are not available in source route "${e}"`}function Ke(e,n,i,a){let o=Ve(e,a),s=t=>Be(e,a?t.slice(a.length+1):t),c=a?new Set(i.getUrlParams(a)):We,l=He(e,a),u={...n};for(let[e,n]of l)(0,t.putField)(u,e,n);for(let[e,t]of l)Ge(e,t,s,o,i,c);for(let e of Fe(u))(0,r.resolveForwardChain)(e,u)}function qe(e,n){if(!s(e)&&typeof e!=`function`)throw(0,t.raiser)(`router`,n).type`Handler must be a boolean or factory function, got ${x(e)}`}function Je(e,n,r=i.maxLifecycleHandlers){if(r!==0&&e>=r)throw(0,t.raiser)(`router`,n).range`Lifecycle handler limit exceeded (${r}). This indicates too many routes with individual handlers. Consider using plugins for cross-cutting concerns.`}function Ye(e,t,n,r){if(n===0)return;let{warn:i,error:o}=a(n);e>=o?r.error(`router.${t}`,`${e} lifecycle handlers registered! This is excessive. Hard limit at ${n}.`):e>=i&&r.warn(`router.${t}`,`${e} lifecycle handlers registered. Consider consolidating logic.`)}function Xe(e,t,n,r){r.warn(`router.${n}`,`Overwriting existing ${t} handler for route "${e}"`)}function Ze(e,t,n){n.warn(`router.${t}`,`Guard for "${e}" returned a Promise. Sync check cannot resolve async guards — returning false.`)}function Qe(e,t){return`Guard for "${e}" must answer true or false, got ${x(t)} — read as a refusal.`}function $e(e,t,n,r){r.warn(`router.${n}`,Qe(e,t))}function et(e,t,n){n.warn(`router`,Qe(e,t))}const D=(0,t.raiser)(`router`,`start`),O=(0,t.raiser)(`router`,`navigateToState`),tt=(0,t.raiser)(`router`,`navigateToDefault`),nt=(0,t.raiser)(`router`,`navigate`),rt=Object.hasOwn,it=Object.getPrototypeOf;function at(e){if(typeof e!=`string`)throw nt.type`Invalid route name: expected string, got ${x(e)}`}function ot(e){if(e!==void 0&&(typeof e!=`object`||!e))throw tt.type`Invalid options: ${x(e)}. Expected NavigationOptions object.`}function st(e){if(typeof e!=`object`||!e)throw O.type`Invalid state: ${x(e)}. Expected State object.`;let t=e;if(!o(t.name))throw O.type`Invalid state.name: ${x(t.name)}. Expected string.`;if(!m(t.params))throw O.type`Invalid state.params: ${x(t.params)}. Expected plain object.`;if(!o(t.path))throw O.type`Invalid state.path: ${x(t.path)}. Expected string.`}function ct(e,n){if(!oe(e))throw(0,t.raiser)(`router`,n).type`Invalid options: ${x(e)}. Expected NavigationOptions object.`}const lt=/[\u0000-\u001F\u007F]/;function ut(e,n){for(let r in e){if(!rt(e,r))continue;let i=e[r],a=typeof i;if(a===`symbol`||a===`bigint`)throw(0,t.raiser)(`router`,n).type`param "${r}" cannot be a ${a} — it does not round-trip through the URL path. Use a string, number, or boolean.`;if(a===`string`&&lt.test(i))throw(0,t.raiser)(`router`,n).type`param "${r}" must not contain control characters (NUL / C0 / DEL) — they corrupt the URL path.`}}function k(e,n){if(e===void 0)return;let r=e!==null&&it(e);if(Array.isArray(e)||r!==null&&r!==Object.prototype)throw(0,t.raiser)(`router`,n).type`params must be a plain object, got ${x(e)}`}function A(e,n){if(e!==void 0&&(ut(e,n),!m(e)))throw(0,t.raiser)(`router`,n).type`params must be a plain object, got ${x(e)}`}function j(e,n){if(e!==void 0&&(typeof e!=`object`||!e||Array.isArray(e)))throw(0,t.raiser)(`router`,n).type`search must be a plain object, got ${x(e)}`}function dt(e){if(e!==void 0&&typeof e!=`string`)throw D.type`path must be a string, got ${x(e)}.`;if(typeof e==`string`){if(lt.test(e))throw D.type`path must not contain control characters (NUL / C0 / DEL).`;if(e!==``&&!e.startsWith(`/`))throw D.type`path must start with "/", got "${e}".`}}const ft=Object.entries,pt=Object.hasOwn,M=Object.keys,mt=Object.getPrototypeOf,N={trailingSlash:[`strict`,`never`,`always`,`preserve`],queryParamsMode:[`default`,`strict`,`loose`],urlParamsEncoding:[`default`,`uri`,`uriComponent`,`none`]},ht={arrayFormat:!0,booleanFormat:!0,nullFormat:!0,numberFormat:!0},gt=new Set(M({defaultRoute:!0,defaultParams:!0,defaultSearch:!0,trailingSlash:!0,caseSensitive:!0,queryParamsMode:!0,queryParams:!0,urlParamsEncoding:!0,allowNotFound:!0,rewritePathOnMatch:!0,logger:!0,limits:!0})),_t={maxDependencies:{min:0,max:1e4},maxPlugins:{min:0,max:1e3},maxListeners:{min:0,max:1e5},warnListeners:{min:0,max:1e5},maxLifecycleHandlers:{min:0,max:1e4}};function vt(e,n,r){if(typeof n!=`number`||!Number.isInteger(n))throw(0,t.raiser)(`router`,r).type`limit "${e}" must be an integer, got ${String(n)}`;let i=_t[e];if(n<i.min||n>i.max)throw(0,t.raiser)(`router`,r).range`limit "${e}" must be between ${i.min} and ${i.max}, got ${n}`}function yt(e){let t=mt(e);return t===null||t===Object.prototype}function bt(e,n){if(!e||typeof e!=`object`||!yt(e))throw(0,t.raiser)(`router`,n).type`invalid limits: expected plain object, got ${typeof e}`;for(let[r,i]of ft(e)){if(!pt(_t,r))throw(0,t.raiser)(`router`,n).type`unknown limit: "${r}"`;i!==void 0&&vt(r,i,n)}let{warnListeners:r,maxListeners:i}=e;if(typeof r==`number`&&typeof i==`number`&&i>0&&r>i)throw(0,t.raiser)(`router`,n).range`"limits.warnListeners" (${r}) must not exceed "limits.maxListeners" (${i}) — the warning channel would be unreachable`}function P(e,n,r,i){if(e!==void 0&&(typeof e!=`string`||!r.includes(e))){let a=r.map(e=>`"${e}"`).join(`, `),o=typeof e==`string`?e:`(${typeof e})`;throw(0,t.raiser)(`router`,i).type`Invalid "${n}": "${o}". Must be one of: ${a}`}}function xt(e,n){if(e!==void 0&&typeof e!=`string`&&typeof e!=`function`)throw(0,t.raiser)(`router`,n).type`Invalid "defaultRoute": expected string or function, got ${typeof e}`}function St(e,n,r){if(e!==void 0&&typeof e!=`function`&&(!e||typeof e!=`object`||Array.isArray(e)||!yt(e)))throw(0,t.raiser)(`router`,r).type`Invalid "${n}": expected plain object or function, got ${typeof e}`}function Ct(e,n){if(e===void 0)return;if(!e||typeof e!=`object`||Array.isArray(e))throw(0,t.raiser)(`router`,n).type`Invalid "queryParams": expected plain object`;let r=e;for(let e of M(r))if(!c(e,ht))throw(0,t.raiser)(`router`,n).type`Invalid "queryParams.${e}": unknown option`}function wt(e,n){if(!e||typeof e!=`object`||Array.isArray(e))throw(0,t.raiser)(`router`,n).type`Invalid options: expected plain object`;let r=e;for(let e of M(r))if(!gt.has(e))throw(0,t.raiser)(`router`,n).type`Unknown option: "${e}"`;if(xt(r.defaultRoute,n),St(r.defaultParams,`defaultParams`,n),St(r.defaultSearch,`defaultSearch`,n),P(r.trailingSlash,`trailingSlash`,N.trailingSlash,n),P(r.queryParamsMode,`queryParamsMode`,N.queryParamsMode,n),P(r.urlParamsEncoding,`urlParamsEncoding`,N.urlParamsEncoding,n),r.allowNotFound!==void 0&&typeof r.allowNotFound!=`boolean`)throw(0,t.raiser)(`router`,n).type`Invalid "allowNotFound": expected boolean, got ${typeof r.allowNotFound}`;if(r.rewritePathOnMatch!==void 0&&typeof r.rewritePathOnMatch!=`boolean`)throw(0,t.raiser)(`router`,n).type`Invalid "rewritePathOnMatch": expected boolean, got ${typeof r.rewritePathOnMatch}`;if(r.caseSensitive!==void 0&&typeof r.caseSensitive!=`boolean`)throw(0,t.raiser)(`router`,n).type`Invalid "caseSensitive": expected boolean, got ${typeof r.caseSensitive}`;Ct(r.queryParams,n),r.limits!==void 0&&bt(r.limits,n)}const F=(0,t.raiser)(`router`,`usePlugin`),Tt=Object.hasOwn,I=`router.usePlugin`,Et={onStart:!0,onStop:!0,onTransitionStart:!0,onTransitionLeaveApprove:!0,onTransitionSuccess:!0,onTransitionError:!0,onTransitionCancel:!0};function Dt(e,t,n=i.maxPlugins){if(n!==0&&e+t>n)throw F.range`Plugin limit exceeded (${n}). Current: ${e}, Attempting to add: ${t}. This indicates an architectural problem. Consider consolidating plugins.`}function Ot(e,t){if(t.includes(e))throw F.plain`Plugin factory already registered. To re-register, first unsubscribe the existing plugin.`}function kt(e,t,n){if(t===0)return;let{warn:r,error:i}=a(t);e>=i?n.error(I,`${e} plugins registered! This is excessive. Hard limit at ${t}.`):e>=r&&n.warn(I,`${e} plugins registered. Consider if all are necessary.`)}function At(e){for(let t in e)if(!(t===`teardown`||Tt(Et,t)))throw F.type`Unknown property '${t}'. Plugin must only contain event handlers and optional teardown.`}function jt(e){e.warn(I,`Duplicate factory in batch, will be registered once`)}function Mt(e,t){t.warn(I,`Property '${e}' is not a function, skipping`)}function Nt(e,t){e===`onStart`&&t.warn(I,`Router already started, onStart will not be called`)}const Pt=(0,t.raiser)(`router`,`navigateToDefault`),L=(0,t.raiser)(`validation-plugin`),R=Object.entries,Ft=Object.getOwnPropertyDescriptor,It=Object.keys;function z(e,t,n=``){for(let r of e){let e=n?`${n}.${r.name}`:r.name;t(r,e),r.children&&z(r.children,t,e)}}function B(e,t){let n=[];return z(e,(e,r)=>{let i=t(e);i!==void 0&&n.push([r,i])}),n}function Lt(e,t){try{return(0,r.resolveForwardChain)(e,t)}catch(e){let t=e.message.replace(/^\[router\] /u,``);throw L.plain({cause:e})`${t}`}}function V(e,t,n){let r=e;if(r.constructor.name===`AsyncFunction`||r.toString().includes(`__awaiter`))throw L.type`Route "${n}" ${t} cannot be async`}function Rt(e){z(e,(e,t)=>{if(typeof e.name!=`string`||!e.name)throw L.type`validateExistingRoutes: route has invalid name: ${e.name}`;if(typeof e.path!=`string`)throw L.type`validateExistingRoutes: route "${t}" has non-string path (${typeof e.path})`})}function zt(e,t){for(let[n,r]of R(e)){if(!t.hasRoute(r))throw L.plain`validateForwardToConsistency: forwardTo target "${r}" does not exist in tree (source route: "${n}")`;let e=new Set(t.getUrlParams(n)),i=[...new Set(t.getUrlParams(r))].filter(t=>!e.has(t));if(i.length>0)throw L.plain`validateForwardToConsistency: forwardTo target "${r}" requires params [${i.join(`, `)}] not available in source route "${n}"`}for(let t of It(e))Lt(t,e)}function Bt(e,t){for(let[n,r]of e)if(typeof r!=`object`||!r||Array.isArray(r))throw L.type`validateRoutePropertiesStore: route "${n}" ${t} must be a plain object, got ${Array.isArray(r)?`array`:typeof r}`}function Vt(e){let t=B(e,e=>e.decodeParams),n=B(e,e=>e.encodeParams),r=B(e,e=>typeof e.forwardTo==`string`?void 0:e.forwardTo);for(let[e,n]of t){if(typeof n!=`function`)throw L.type`validateRoutePropertiesStore: route "${e}" decoder must be a function, got ${typeof n}`;V(n,`decoder`,e)}for(let[e,t]of n){if(typeof t!=`function`)throw L.type`validateRoutePropertiesStore: route "${e}" encoder must be a function, got ${typeof t}`;V(t,`encoder`,e)}Bt(B(e,e=>e.defaultParams),`defaultParams`),Bt(B(e,e=>e.defaultSearch),`defaultSearch`);for(let[e,t]of r){if(typeof t!=`function`)throw L.type`validateRoutePropertiesStore: route "${e}" forwardTo callback must be a function, got ${typeof t}`;V(t,`forwardTo callback`,e)}}function Ht(e,t){for(let[n,r]of R(e))if(!t.hasRoute(r))throw L.plain`validateForwardToTargetsStore: forwardTo target "${r}" does not exist for route "${n}"`}function Ut(e,t){for(let t of It(e))if(Ft(e,t)?.get)throw L.type`validateDependenciesStructure: dependency "${t}" must not use a getter`;for(let[e,n]of R(t))if(!Number.isInteger(n))throw L.type`validateDependenciesStructure: deps.limits.${e} must be an integer, got ${String(n)}`}function Wt(e,t,n){let r=e&&typeof e==`object`?e:{},i=(r.limits&&typeof r.limits==`object`?r.limits:{}).maxDependencies,a=typeof i==`number`?i:n;if(a>0&&t>a)throw L.range`validateLimitsConsistency: dependency count (${t}) exceeds maxDependencies limit (${a})`}function Gt(e,t){return typeof e==`string`&&e!==``&&!t.hasRoute(e)}function Kt(e,t){if(Gt(e,t))throw L.plain`defaultRoute resolved to non-existent route: "${e}"`}function qt(e,t){if(Gt(e,t))throw Pt.plain`defaultRoute callback resolved to non-existent route: "${e}"`}function Jt(e,t,n){for(let r of e)t.hasRoute(r)||n.warn(`router.start`,`Guard registered for route "${r}", which the route tree does not contain. It will never run unless that route is added. Check the name for a typo.`)}const H=(0,t.raiser)(`router`,`updateRoute`),U=(0,t.raiser)(`router`,`addRoute`),Yt=(0,t.raiser)(`router`,`shouldUpdateNode`),Xt=(0,t.raiser)(`router`,`matchPath`),Zt=(0,t.raiser)(`router`,`buildPath`),W=(0,t.raiser)(`router`,`isActiveRoute`),Qt=(0,t.raiser)(`router`,`setRootPath`);function G(e,n){if(e.startsWith(`@@`))throw(0,t.raiser)(`router`,n).plain`Route name "${e}" uses the reserved "${`@@`}" prefix. Routes with this prefix are internal and cannot be modified through the public API.`}function $t(e,t){for(let n of e)n&&typeof n==`object`&&typeof n.name==`string`&&(G(n.name,t),n.children&&$t(n.children,t))}function en(e){b(e,`removeRoute`)}function tn(e){if(typeof e!=`string`)throw Qt.type`rootPath must be a string, got ${x(e)}`}function K(e){return e.constructor.name===`AsyncFunction`||String(e).includes(`__awaiter`)}function nn(e){let t=e;if(t.canActivate!==void 0&&typeof t.canActivate!=`function`)throw U.type`canActivate must be a function, got ${x(t.canActivate)}`;if(t.canDeactivate!==void 0&&typeof t.canDeactivate!=`function`)throw U.type`canDeactivate must be a function, got ${x(t.canDeactivate)}`}function rn(e,t){let n=e;if(typeof n.decodeParams==`function`&&K(n.decodeParams))throw U.type`decodeParams cannot be async for route "${String(t)}"`;if(typeof n.encodeParams==`function`&&K(n.encodeParams))throw U.type`encodeParams cannot be async for route "${String(t)}"`;if(typeof n.forwardTo==`function`&&K(n.forwardTo))throw U.type`forwardTo callback cannot be async for route "${String(t)}"`}function an(e,t){for(let n of e){if(typeof n!=`object`||!n||Array.isArray(n))throw U.type`Route must be an object, got ${x(n)}`;Re(n,E(t,n.name))}}function on(e){if(typeof e!=`string`||e===``)throw U.type`parent option must be a non-empty string, got ${x(e)}`;b(e,`addRoute`)}function sn(e,t,n,r){if(!o(e))throw W.type`name must be a string, got ${typeof e}`;if(k(t,`isActiveRoute`),n!==void 0&&typeof n!=`boolean`)throw W.type`strictEquality must be a boolean, got ${typeof n}`;if(r!==void 0&&typeof r!=`boolean`)throw W.type`ignoreQueryParams must be a boolean, got ${typeof r}`}function q(e,n,r){if(!o(e))throw(0,t.raiser)(`router`,r).type`Invalid routeName: ${x(e)}. Expected string.`;if(!m(n))throw(0,t.raiser)(`router`,r).type`Invalid routeParams: ${x(n)}. Expected plain object.`}function cn(e,t){if(b(e,`updateRoute`),e===``)throw H.ref`Invalid name: empty string. Cannot update root node.`;if(t===null)throw H.type`updates must be an object, got null`;if(typeof t!=`object`||Array.isArray(t))throw H.type`updates must be an object, got ${x(t)}`}function ln(e,t){if(e.constructor.name===`AsyncFunction`||e.toString().includes(`__awaiter`))throw H.type`${t} cannot be an async function`}function J(e,t){if(e!=null){if(typeof e!=`function`)throw H.type`${t} must be a function or null, got ${typeof e}`;ln(e,t)}}function un(e){let{forwardTo:t,defaultParams:n,defaultSearch:r,decodeParams:i,encodeParams:a,canActivate:o,canDeactivate:s}=e;if(t!=null){if(typeof t!=`string`&&typeof t!=`function`)throw H.type`forwardTo must be a string, function, or null, got ${x(t)}`;typeof t==`function`&&ln(t,`forwardTo callback`)}dn(n,`defaultParams`),dn(r,`defaultSearch`),J(i,`decodeParams`),J(a,`encodeParams`),J(o,`canActivate`),J(s,`canDeactivate`)}function dn(e,t){if(e!=null&&(typeof e!=`object`||Array.isArray(e)))throw H.type`${t} must be an object or null, got ${x(e)}`}function fn(e){if(!o(e)||e===``)throw Zt.type`route must be a non-empty string, got ${typeof e==`string`?`""`:typeof e}`}function pn(e){let t=new Set;return function(r,i){let a=(0,n.findMisChanneledKey)(i,e(r));if(a===void 0)return;let o=`${r} ${a}`;t.has(o)||(t.add(o),console.warn(`[router] Route "${r}" declares \`${a}\` as a query param, but it was given in the \`params\` bag — the path channel. The URL is built without it, so the href does not match what you asked for; a plain click throws, but a ⌘-click, a copied link and server-rendered markup all follow the wrong URL in silence. Pass it in \`search\` instead.`))}}function mn(e){if(!o(e))throw Xt.type`path must be a string, got ${typeof e}`}function hn(e){if(!o(e))throw Yt.type`nodeName must be a string, got ${typeof e}`}function gn(e,t,r,i,a){if(a){let e=t;for(let t of a.split(`.`))if(e=e.children.get(t),!e)throw U.ref`Parent route "${a}" does not exist`}let o=new Set,s=new Map;for(let r of e)(0,n.validateRoute)(r,`addRoute`,t,a??``,o,s);Ke(e,i,r,a)}function _n(e,t,n){let r=new Set(n.getUrlParams(e)),i=n.getUrlParams(t).filter(e=>!r.has(e));if(i.length>0)throw H.plain`forwardTo target "${t}" requires params [${i.join(`, `)}] that are not available in source route "${e}"`}function vn(e,t,n){let i={...n,[e]:t};(0,r.resolveForwardChain)(e,i)}function yn(e,t,n,r){if(!n.hasRoute(e))throw H.ref`route "${e}" does not exist`;if(t!=null&&typeof t==`string`){if(!n.hasRoute(t))throw H.plain`forwardTo target "${t}" does not exist`;_n(e,t,n),vn(e,t,r)}}const Y=(0,t.raiser)(`router`,`makeState`),bn=Object.entries;function xn(e,t,n){if(!o(e))throw Y.type`Invalid name: ${x(e)}. Expected string.`;if(t!==void 0&&!m(t))throw Y.type`Invalid params: ${x(t)}. Expected plain object.`;if(n!==void 0&&!o(n))throw Y.type`Invalid path: ${x(n)}. Expected string.`}function Sn(){let e=new Set;return function(t,n){let r=`${t} ${n}`;e.has(r)||(e.add(r),console.warn(`[router] Query key "${n}" is not declared on route "${t}" (\`?${n}\`), so the current \`queryParamsMode\` will not print it — it was dropped from \`state.search\` rather than published beside a \`state.path\` that cannot show it. Declare it on the route path, or use \`queryParamsMode: "loose"\` to keep undeclared keys. A \`defaultSearch\` entry for "${n}" is dead config in this mode for the same reason.`))}}function Cn(){let e=new Set;return function(t,n){let r=`${t} ${n}`;e.has(r)||(e.add(r),console.warn(`[router] Param "${n}" is declared nowhere on route "${t}" — neither as a path slot (:${n}) nor as a query param (?${n}), so it stays in state.params but never reaches the URL. The state will not round-trip: matchPath(state.path) cannot recover it. Declare it on the route path if it belongs in the URL, or pass it through the search channel; keep it here only if it is deliberately app-level data.`))}}function wn(e){return typeof e==`object`&&!!e&&!Array.isArray(e)}function X(e,t){let n={params:{...t.params},search:{...t.search}};if(e===void 0)return n;let r=e(n),i=r.params??n.params,a=r.search??n.search;return wn(i)&&wn(a)?{params:i,search:a}:void 0}function Tn(e,t){try{return X(e,t)}catch{return}}function Z(e){return new Map(bn(e).filter(([,e])=>e!==void 0))}function En(e){return typeof e==`number`||typeof e==`boolean`?String(e):e}function Dn(e,t){let n=Z(e.params);return{params:Object.fromEntries(t.filter(e=>n.has(e)).map(e=>[e,En(n.get(e))])),search:e.search}}function Q(e){return Array.isArray(e)?e.some(e=>Q(e)):typeof e==`object`&&!!e}function On(e,t,r){if((0,n.areParamValuesEqual)(e,t))return!0;if(!Q(e)&&!Q(t))return!1;let[i,a]=r();return(0,n.areParamValuesEqual)(i,a)}function kn(e,t,n){let r=X(t.encode,e);if(r===void 0)return[];let i=X(t.decode,Dn(r,n));if(i===void 0)return[];let a=(n,i,a)=>[r[n][i],Tn(t.encode,{...e,[n]:{...e[n],[i]:a}})?.[n][i]],o=[];for(let t of[`params`,`search`]){let r=Z(e[t]),s=Z(i[t]);for(let[e,n]of s)r.has(e)?On(r.get(e),n,()=>a(t,e,n))||o.push([t,e,`changed`]):o.push([t,e,`added`]);for(let e of r.keys())!s.has(e)&&(t===`search`||n.includes(e))&&o.push([t,e,`dropped`])}return o}function An(e){return e.decode===void 0?`The route has an encodeParams and no decodeParams to undo it.`:e.encode===void 0?`With no encodeParams, decodeParams must return each value so that it prints as the URL shows it.`:`decodeParams must undo encodeParams.`}function jn(e,t,n,r,i){let a=`Route "${e}": its codec`;switch(r){case`added`:return`${a} adds "${n}" to state.${t}, so a link commits a state without it and a reload of the same URL commits one with it. Derive "${n}" in a forwardState interceptor instead: navigate and matchPath both run it.`;case`changed`:return`${a} changes "${n}" in state.${t}, so a link and a reload of the same URL commit different values. ${An(i)}`;case`dropped`:return`${a} drops "${n}" from state.${t}, so a reload of the URL a link builds loses it. ${An(i)}`}}function Mn(e){let t=new Set;return function(n,r,i){let a;try{a=kn(n,r,i)}catch{return}for(let[i,o,s]of a){let a=`${n.name} ${i} ${o}`;t.has(a)||(t.add(a),e.warn(`router`,jn(n.name,i,o,s,r)))}}}const Nn=(0,t.raiser)(`validation-plugin`),Pn=(0,t.raiser)(`router`,`addRoute`),$=(0,t.raiser)(`router`,`areStatesEqual`);function Fn(e){return typeof e==`object`&&!!e&&!Array.isArray(e)}function In(e){return{hasRoute:t=>{let n=e.getTree();for(let e of t.split(`.`))if(n=n?.children.get(e),!n)return!1;return!0},getUrlParams:t=>e.getUrlParams(t)}}const Ln={hasRoute:()=>!1,getUrlParams:()=>[]};function Rn(e){return{tree:{...e,children:new Map,nonAbsoluteChildren:[]},lookup:Ln,forwardMap:{}}}function zn(e,t){let n=[];for(let r of e.getTree().children.keys())n.push(t.get(r));return n}function Bn(e,t,n){let r=pn(t=>e.getDeclaredQueryNames(t));return{routes:{validateBuildPathArgs(e,t){fn(e),r(e,t)},validateMatchPathArgs:mn,validateIsActiveRouteArgs(e,t,n,i){sn(e,t,n,i),r(e,t)},validateShouldUpdateNodeArgs:hn,validateStateBuilderArgs:q,validateRouteName(e,t){b(e,t)},validateSetRootPathArgs:tn},options:{validateOptions:wt,validateResolvedDefaultRoute(e){qt(e,t)}},dependencies:{validateDependencyName:be,validateSetDependencyArgs(e,t,n){xe(e)},validateDependenciesObject(t,n){Se(t,n),Ce(t,e.getDependencyKeys(),e.getResolvedLimits().maxDependencies,n)},validateDependencyExists(e,t){we(t,e)},validateDependencyCount(t,n,r){Te(t,n,r,e.logger)},validateCloneArgs:Ee,warnOverwrite(t,n){De(t,n,e.logger)},warnBatchOverwrite(t,n){Oe(t,n,e.logger)},warnRemoveNonExistent(t){ke(t,e.logger)}},plugins:{validatePluginLimit(e,t){Dt(e,1,t?.maxPlugins)},validateNoDuplicatePlugins:Ot,validatePluginKeys:At,validateCountThresholds(t){kt(t,e.getOptions().limits?.maxPlugins??i.maxPlugins,e.logger)},warnBatchDuplicates(){jt(e.logger)},warnPluginMethodType(t){Mt(t,e.logger)}},lifecycle:{validateHandlerLimit(t,n){Je(t,n,e.getOptions().limits?.maxLifecycleHandlers??i.maxLifecycleHandlers)},validateCountThresholds(t,n){Ye(t,n,e.getOptions().limits?.maxLifecycleHandlers??i.maxLifecycleHandlers,e.logger)},warnOverwrite(t,n,r){Xe(t,n,r,e.logger)},warnAsyncGuardSync(t,n){Ze(t,n,e.logger)},warnNonBooleanGuardSync(t,n,r){$e(t,n,r,e.logger)},warnNonBooleanGuard(t,n){et(t,n,e.logger)}},navigation:{validateNavigateToDefaultArgs(t){ot(t),n.check(e.logger)},validateNavigateToStateArgs:st,validateNavigationOptions:ct,validateParamsShape:k,validateSearch:j,validateStartArgs:dt},state:{validateMakeStateArgs:xn,reportDroppedQueryKey:Sn(),reportUndeclaredParamKey:Cn(),reportCodecRoundTrip:Mn(e.logger),validateAreStatesEqualArgs(e,t,n){if(!y(e))throw $.type`Invalid state1: ${x(e)}. Expected State object.`;if(!y(t))throw $.type`Invalid state2: ${x(t)}. Expected State object.`;if(n!==void 0&&!s(n))throw $.type`Invalid ignoreQueryParams: ${x(n)}. Expected boolean.`;if(n===!1){if(!Fn(e.search))throw $.type`Invalid state1.search: ${x(e.search)}. Expected a plain object.`;if(!Fn(t.search))throw $.type`Invalid state2.search: ${x(t.search)}. Expected a plain object.`}}},eventBus:{validateListenerArgs(e,t){Ne(e,t)},validateCountThresholds(t,n,r){let a=e.getOptions().limits?.maxListeners??i.maxListeners;Pe(t,n,r,e.logger,a)}}}}function Vn(){return t=>{let r=(0,n.getInternals)(t),i=(0,e.getPluginApi)(t);if(t.isActive())throw Nn.code(`VALIDATION_PLUGIN_AFTER_START`)`must be registered before router.start()`;if(r.validator!==null)throw Nn.code(`VALIDATION_PLUGIN_ALREADY_INSTALLED`)`is already installed on this router — a clone re-runs plugin factories, so it needs no usePlugin of its own`;let a=new fe;a.watch(i.getAdoptedOrigins());let o=In(i),s=Bn(i,o,a),c=()=>{r.validator===s&&(r.validator=null)};r.validator=s;try{let n=zn(i,(0,e.getRoutesApi)(t)),a=i.getForwardMap(),s=i.getResolvedLimits(),c=i.getOptions();Rt(n),zt(a,o),Vt(n),Ht(a,o),Ut(r.dependenciesGetStore().dependencies,s),Wt(c,i.getDependencyKeys().length,s.maxDependencies),r.validator.options.validateOptions(c,`constructor (retrospective)`),typeof c.defaultRoute==`string`&&Kt(c.defaultRoute,o)}catch(e){throw c(),e}let l=i.addInterceptor(`start`,(e,t)=>{try{Jt(i.getExternalGuardNames(),o,i.logger)}catch{}return e(t)}),u=i.addCheck(`buildPath:params`,e=>{A(e,`buildPath`)}),ee=i.addCheck(`buildPathResolved:params`,e=>{A(e,`buildPathResolved`)}),te=i.addCheck(`canNavigateTo:entry`,(e,t,n)=>{b(e,`canNavigateTo`),k(t,`canNavigateTo`),j(n,`canNavigateTo`)}),ne=i.addCheck(`canNavigateTo:params`,e=>{A(e,`canNavigateTo`)}),re=i.addCheck(`navigate:entry`,(e,t,n,r)=>{at(e),k(t,`navigate`),j(n,`navigate`),ct(r,`navigate`)}),d=i.addCheck(`navigate:params`,e=>{A(e,`navigate`)}),f=(e,t)=>{for(let n of e){let e=E(t,n.name);nn(n),rn(n,e),n.children!==void 0&&f(n.children,e)}},p=(e,t,n,r)=>{if(f(e,typeof n==`string`&&o.hasRoute(n)?n:void 0),n!==void 0&&(on(n),!o.hasRoute(n)))throw Pn.ref`Parent route "${n}" does not exist`;$t(e,t),an(e,n);let i=r();gn(e,i.tree,i.lookup,i.forwardMap,n)},ie=i.addCheck(`addRoute:batch`,(e,t)=>{p(e,`addRoute`,t,()=>({tree:i.getTree(),lookup:o,forwardMap:i.getForwardMap()}))}),m=i.addCheck(`replaceRoutes:batch`,e=>{p(e,`replaceRoutes`,void 0,()=>Rn(i.getTree()))}),ae=i.addCheck(`removeRoute:entry`,e=>{en(e),G(e,`removeRoute`)}),h=i.addCheck(`updateRoute:entry`,(e,t)=>{let n=t;cn(e,t),G(e,`updateRoute`),un({forwardTo:n.forwardTo,defaultParams:n.defaultParams,defaultSearch:n.defaultSearch,decodeParams:n.decodeParams,encodeParams:n.encodeParams,canActivate:n.canActivate,canDeactivate:n.canDeactivate}),yn(e,n.forwardTo,o,i.getForwardMap())}),oe=i.addCheck(`hasRoute:entry`,e=>{b(e,`hasRoute`)}),g=i.addCheck(`getRoute:entry`,e=>{b(e,`getRoute`)}),_=i.addCheck(`forwardState:entry`,(e,t,n)=>{q(e,t,`forwardState`),j(n,`forwardState`)}),v=i.addCheck(`buildNavigationState:state`,(e,t,n)=>{j(n,`buildNavigationState`),q(e,t,`buildNavigationState`)}),se=i.addCheck(`addActivateGuard:entry`,(e,t)=>{b(e,`addActivateGuard`),qe(t,`addActivateGuard`)}),ce=i.addCheck(`addDeactivateGuard:entry`,(e,t)=>{b(e,`addDeactivateGuard`),qe(t,`addDeactivateGuard`)}),y=i.addCheck(`removeActivateGuard:entry`,e=>{b(e,`removeActivateGuard`)}),x=i.addCheck(`removeDeactivateGuard:entry`,e=>{b(e,`removeDeactivateGuard`)}),S=i.subscribeDiagnostic(`PLUGIN_AFTER_START`,e=>{Nt(e,i.logger)});return{teardown(){u(),ee(),te(),ne(),re(),d(),ie(),m(),ae(),h(),oe(),g(),_(),v(),se(),ce(),y(),x(),S(),l(),c()}}}}exports.validationPlugin=Vn;
 //# sourceMappingURL=index.js.map