@real-router/validation-plugin 0.17.12 → 0.18.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/dist/esm/index.d.mts.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"index.d.mts","names":[],"sources":["../../src/validationPlugin.ts"],"mappings":";;;;;;;;;;;;;;;;
|
|
1
|
+
{"version":3,"file":"index.d.mts","names":[],"sources":["../../src/validationPlugin.ts"],"mappings":";;;;;;;;;;;;;;;;wBAiZgB,iBACd,qBAAqB,sBAAsB,wBACxC,cAAc"}
|
package/dist/esm/index.mjs
CHANGED
|
@@ -1,2 +1,2 @@
|
|
|
1
|
-
import{RouterError as e,events as t,resolveForwardChain as n}from"@real-router/core";import{getPluginApi as r}from"@real-router/core/api";import{freezeThrownError as i,putField as a}from"@real-router/core/utils";import{getInternals as o,validateRoute as s}from"@real-router/core/validation";const c=Object.freeze({maxDependencies:100,maxPlugins:50,maxListeners:1e4,warnListeners:1e3,maxLifecycleHandlers:200});function l(e){return{warn:Math.floor(e*.2),error:Math.floor(e*.5)}}function u(e){return typeof e==`string`}function d(e){return typeof e==`boolean`}function ee(e,t){return e in t}const f=Object.getPrototypeOf,te=Object.values,ne=Object.hasOwn;function re(e){if(Array.isArray(e))return!0;let t=f(e);return t===null||t===Object.prototype}function ie(e,t){let n=Array.isArray(e)?e:te(e);for(let e of n)t.push(e)}function ae(e){let t=typeof e;return t===`string`||t===`boolean`||t===`number`&&Number.isFinite(e)}var p=class{container;constructor(e){this.container=e}};function oe(e,t,n,r){return n.has(e)?!1:r.has(e)?!0:re(e)?(n.add(e),t.push(new p(e)),ie(e,t),!0):!1}function se(e){let t=[e],n=new WeakSet,r=new WeakSet;for(;t.length>0;){let e=t.pop();if(e instanceof p){n.delete(e.container),r.add(e.container);continue}if(e!=null){if(typeof e==`object`){if(!oe(e,t,n,r))return!1;continue}if(!ae(e))return!1}}return!0}function ce(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 le(e)}catch{return!1}}function le(e){if(typeof e!=`object`||!e||Array.isArray(e))return!1;let t=f(e);if(t!==null&&t!==Object.prototype)return!1;let n=!1;for(let t in e){if(!ne(e,t))continue;let r=e[t];if(!ce(r)){let e=typeof r;if(e===`function`||e===`symbol`)return!1;n=!0;break}}return!n||se(e)}const ue=[`replace`,`reload`,`force`,`forceDeactivate`,`redirected`];function de(e){if(typeof e!=`object`||!e||Array.isArray(e))return!1;let t=e;for(let e of ue){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 fe=/\S/,h=/^[A-Z_a-z][\w-]*(?:\.[A-Z_a-z][\w-]*)*$/;function g(e,t){return TypeError(`[router.${e}] ${t}`)}function pe(e){return typeof e==`string`?e===``?!0:e.length>1e4?!1:e.startsWith(`@@`)?!0:h.test(e):!1}function me(e){return pe(e.name)&&typeof e.path==`string`&&m(e.params)}function _(e){return typeof e!=`object`||!e?!1:me(e)}function v(e,t){if(typeof e!=`string`)throw g(t,`Route name must be a string, got ${typeof e}`);if(e!==``){if(!fe.test(e))throw g(t,`Route name cannot contain only whitespace`);if(e.length>1e4)throw g(t,`Route name exceeds maximum length of 10000 characters. This is a technical safety limit.`);if(!e.startsWith(`@@`)&&!h.test(e))throw g(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 y(e){if(e===null)return`null`;if(Array.isArray(e))return`array[${e.length}]`;if(typeof e==`object`){try{let t=e.constructor;if(typeof t==`function`&&t.name!==`Object`)return t.name||`object`}catch{}return`object`}return typeof e}const b=Object.entries,he=[`defaultParams`,`defaultSearch`],ge=e=>new Map(b(e)),_e=(e,t)=>{let n=b(e);return n.length!==t.size||n.some(([e,n])=>!t.has(e)||!Object.is(t.get(e),n))};var ve=class{#e=new Map;#t=new Set;watch(e){for(let t of he){let n=e[t],r=n?.deref();n!==void 0&&r!==void 0&&this.#e.set(t,{ref:n,before:ge(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&&_e(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 x=Object.keys,S=Object.getOwnPropertyDescriptor,ye=Object.getPrototypeOf,be=Object;function C(e){if(!e||typeof e!=`object`)return!1;let t=ye(e);return t===null||t.constructor===be}function xe(e,t){if(typeof e!=`string`)throw TypeError(`[router.${t}] dependency name must be a string, got ${typeof e}`)}function Se(e){if(typeof e!=`string`)throw TypeError(`[router.setDependency] dependency name must be a string, got ${typeof e}`)}function Ce(e,t){if(!C(e))throw TypeError(`[router.${t}] Invalid argument: expected plain object, received ${y(e)}`);for(let n of x(e))if(S(e,n)?.get)throw TypeError(`[router.${t}] Getters not allowed: "${n}"`)}function we(e,t){if(e===void 0)throw ReferenceError(`[router.getDependency] dependency "${t}" not found`)}function Te(e,t,n){let r=e,i=r.limits?.maxDependencies??c.maxDependencies;if(i===0)return;let a=x(r.dependencies).length,{warn:o,error:s}=l(i);if(a>=i)throw RangeError(`[router.${t}] Dependency limit exceeded (${i}). Current: ${a}.`);a===s?n.error(`router.${t}`,`${a} dependencies registered! This indicates architectural problems. Hard limit at ${i}.`):a===o&&n.warn(`router.${t}`,`${a} dependencies registered. Consider if all are necessary.`)}function Ee(e){if(e!==void 0){if(!C(e))throw TypeError(`[cloneRouter] Invalid dependencies: expected plain object or undefined, received ${typeof e}`);for(let t of x(e))if(S(e,t)?.get)throw TypeError(`[cloneRouter] 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 Ae=Object.values,je=new Set(Ae(t));function Me(e){if(!je.has(e))throw TypeError(`[router.addEventListener] 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 TypeError(`[router.addEventListener] callback must be a function, got ${typeof t}`)}function Pe(e,t,n,r,i=c.maxListeners){if(i===0)return;let{warn:a,error:o}=l(i);e>=o?r.error(`router.${n}`,`${e} listeners registered for "${t}"! This is excessive. Hard limit at ${i}.`):e>=a&&r.warn(`router.${n}`,`${e} listeners registered for "${t}". Consider whether all are necessary — a growing count usually means a missing unsubscribe.`)}function Fe(e,t){if(!d(e)&&typeof e!=`function`)throw TypeError(`[router.${t}] Handler must be a boolean or factory function, got ${y(e)}`)}function Ie(e,t,n=c.maxLifecycleHandlers){if(n!==0&&e>=n)throw RangeError(`[router.${t}] Lifecycle handler limit exceeded (${n}). This indicates too many routes with individual handlers. Consider using plugins for cross-cutting concerns.`)}function Le(e,t,n,r){if(n===0)return;let{warn:i,error:a}=l(n);e>=a?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 Re(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.`)}const Be=Object.hasOwn,Ve=Object.getPrototypeOf;function He(e){if(typeof e!=`string`)throw TypeError(`[router.navigate] Invalid route name: expected string, got ${y(e)}`)}function Ue(e){if(e!==void 0&&(typeof e!=`object`||!e))throw TypeError(`[router.navigateToDefault] Invalid options: ${y(e)}. Expected NavigationOptions object.`)}function We(e){if(typeof e!=`object`||!e)throw TypeError(`[router.navigateToState] Invalid state: ${y(e)}. Expected State object.`);let t=e;if(!u(t.name))throw TypeError(`[router.navigateToState] Invalid state.name: ${y(t.name)}. Expected string.`);if(!m(t.params))throw TypeError(`[router.navigateToState] Invalid state.params: ${y(t.params)}. Expected plain object.`);if(!u(t.path))throw TypeError(`[router.navigateToState] Invalid state.path: ${y(t.path)}. Expected string.`)}function Ge(e,t){if(!de(e))throw TypeError(`[router.${t}] Invalid options: ${y(e)}. Expected NavigationOptions object.`)}const w=/[\u0000-\u001F\u007F]/;function Ke(e,t){for(let n in e){if(!Be(e,n))continue;let r=e[n],i=typeof r;if(i===`symbol`||i===`bigint`)throw TypeError(`[router.${t}] param "${n}" cannot be a ${i} — it does not round-trip through the URL path. Use a string, number, or boolean.`);if(i===`string`&&w.test(r))throw TypeError(`[router.${t}] param "${n}" must not contain control characters (NUL / C0 / DEL) — they corrupt the URL path.`)}}function T(e,t){if(e===void 0)return;let n=e!==null&&Ve(e);if(n!==null&&n!==Object.prototype)throw TypeError(`[router.${t}] params must be a plain object, got ${y(e)}`)}function qe(e,t){if(e!==void 0&&(Ke(e,t),!m(e)))throw TypeError(`[router.${t}] params must be a plain object, got ${y(e)}`)}function Je(e,t){if(e!==void 0&&(typeof e!=`object`||!e||Array.isArray(e)))throw TypeError(`[router.${t}] search must be a plain object, got ${y(e)}`)}function Ye(e){if(e!==void 0&&typeof e!=`string`)throw TypeError(`[router.start] path must be a string, got ${y(e)}.`);if(typeof e==`string`){if(w.test(e))throw TypeError(`[router.start] path must not contain control characters (NUL / C0 / DEL).`);if(e!==``&&!e.startsWith(`/`))throw TypeError(`[router.start] path must start with "/", got "${e}".`)}}const E=Object.entries,Xe=Object.hasOwn,Ze=Object.keys,Qe=Object.getPrototypeOf,D={trailingSlash:[`strict`,`never`,`always`,`preserve`],queryParamsMode:[`default`,`strict`,`loose`],urlParamsEncoding:[`default`,`uri`,`uriComponent`,`none`]},O={arrayFormat:[`none`,`brackets`,`index`,`comma`],booleanFormat:[`none`,`auto`,`empty-true`],nullFormat:[`default`,`hidden`],numberFormat:[`none`,`auto`]},$e=new Set([`defaultRoute`,`defaultParams`,`defaultSearch`,`trailingSlash`,`caseSensitive`,`queryParamsMode`,`queryParams`,`urlParamsEncoding`,`allowNotFound`,`rewritePathOnMatch`,`logger`,`limits`]),k={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 et(e,t,n){if(typeof t!=`number`||!Number.isInteger(t))throw TypeError(`[router.${n}] limit "${e}" must be an integer, got ${String(t)}`);let r=k[e];if(t<r.min||t>r.max)throw RangeError(`[router.${n}] limit "${e}" must be between ${r.min} and ${r.max}, got ${t}`)}function A(e){let t=Qe(e);return t===null||t===Object.prototype}function tt(e,t){if(!e||typeof e!=`object`||!A(e))throw TypeError(`[router.${t}] invalid limits: expected plain object, got ${typeof e}`);for(let[n,r]of E(e)){if(!Xe(k,n))throw TypeError(`[router.${t}] unknown limit: "${n}"`);r!==void 0&&et(n,r,t)}let{warnListeners:n,maxListeners:r}=e;if(typeof n==`number`&&typeof r==`number`&&r>0&&n>r)throw RangeError(`[router.${t}] "limits.warnListeners" (${n}) must not exceed "limits.maxListeners" (${r}) — the warning channel would be unreachable`)}function j(e,t,n,r){if(e!==void 0&&(typeof e!=`string`||!n.includes(e))){let i=n.map(e=>`"${e}"`).join(`, `);throw TypeError(`[router.${r}] Invalid "${t}": "${typeof e==`string`?e:`(${typeof e})`}". Must be one of: ${i}`)}}function nt(e,t){if(e!==void 0&&typeof e!=`string`&&typeof e!=`function`)throw TypeError(`[router.${t}] Invalid "defaultRoute": expected string or function, got ${typeof e}`)}function M(e,t,n){if(e!==void 0&&typeof e!=`function`&&(!e||typeof e!=`object`||Array.isArray(e)||!A(e)))throw TypeError(`[router.${n}] Invalid "${t}": expected plain object or function, got ${typeof e}`)}function rt(e,t){if(e===void 0)return;if(!e||typeof e!=`object`||Array.isArray(e))throw TypeError(`[router.${t}] Invalid "queryParams": expected plain object`);let n=e;for(let[e,r]of E(n)){if(!ee(e,O))throw TypeError(`[router.${t}] Invalid "queryParams.${e}": unknown option`);j(r,`queryParams.${e}`,O[e],t)}}function it(e,t){if(!e||typeof e!=`object`||Array.isArray(e))throw TypeError(`[router.${t}] Invalid options: expected plain object`);let n=e;for(let e of Ze(n))if(!$e.has(e))throw TypeError(`[router.${t}] Unknown option: "${e}"`);if(nt(n.defaultRoute,t),M(n.defaultParams,`defaultParams`,t),M(n.defaultSearch,`defaultSearch`,t),j(n.trailingSlash,`trailingSlash`,D.trailingSlash,t),j(n.queryParamsMode,`queryParamsMode`,D.queryParamsMode,t),j(n.urlParamsEncoding,`urlParamsEncoding`,D.urlParamsEncoding,t),n.allowNotFound!==void 0&&typeof n.allowNotFound!=`boolean`)throw TypeError(`[router.${t}] Invalid "allowNotFound": expected boolean, got ${typeof n.allowNotFound}`);if(n.rewritePathOnMatch!==void 0&&typeof n.rewritePathOnMatch!=`boolean`)throw TypeError(`[router.${t}] Invalid "rewritePathOnMatch": expected boolean, got ${typeof n.rewritePathOnMatch}`);if(n.caseSensitive!==void 0&&typeof n.caseSensitive!=`boolean`)throw TypeError(`[router.${t}] Invalid "caseSensitive": expected boolean, got ${typeof n.caseSensitive}`);rt(n.queryParams,t),n.limits!==void 0&&tt(n.limits,t)}const at=Object.hasOwn,N=`router.usePlugin`,ot={onStart:!0,onStop:!0,onTransitionStart:!0,onTransitionLeaveApprove:!0,onTransitionSuccess:!0,onTransitionError:!0,onTransitionCancel:!0};function st(e,t,n=c.maxPlugins){if(n!==0&&e+t>n)throw RangeError(`[router.usePlugin] Plugin limit exceeded (${n}). Current: ${e}, Attempting to add: ${t}. This indicates an architectural problem. Consider consolidating plugins.`)}function ct(e,t){if(t.includes(e))throw Error(`[router.usePlugin] Plugin factory already registered. To re-register, first unsubscribe the existing plugin.`)}function lt(e,t,n){if(t===0)return;let{warn:r,error:i}=l(t);e>=i?n.error(N,`${e} plugins registered! This is excessive. Hard limit at ${t}.`):e>=r&&n.warn(N,`${e} plugins registered. Consider if all are necessary.`)}function ut(e){for(let t in e)if(!(t===`teardown`||at(ot,t)))throw TypeError(`[router.usePlugin] Unknown property '${t}'. Plugin must only contain event handlers and optional teardown.`)}function dt(e){e.warn(N,`Duplicate factory in batch, will be registered once`)}function ft(e,t){t.warn(N,`Property '${e}' is not a function, skipping`)}function pt(e,t){e===`onStart`&&t.warn(N,`Router already started, onStart will not be called`)}const P=Object.entries,mt=Object.getOwnPropertyDescriptor,F=Object.keys;function I(e,t){if(!e||typeof e!=`object`)throw TypeError(`[validation-plugin] ${t}: store must be an object`);let n=e;if(!Array.isArray(n.definitions))throw TypeError(`[validation-plugin] ${t}: store.definitions must be an array`);if(!n.config||typeof n.config!=`object`)throw TypeError(`[validation-plugin] ${t}: store.config must be an object`);if(!n.tree||typeof n.tree!=`object`)throw TypeError(`[validation-plugin] ${t}: store.tree must be an object`);return n}function L(e,t,n=``){for(let r of e){let e=n?`${n}.${r.name}`:r.name;t(r,e),r.children&&L(r.children,t,e)}}function R(e,t){let n=t.split(`.`),r=e;for(let e of n)if(r=r.children.get(e),!r)return!1;return!0}function ht(e,t){try{return n(e,t)}catch(e){throw Error(`[validation-plugin] ${e.message}`,{cause:e})}}function z(e){let t=new Set;for(let n of e)for(let e of n.paramMeta.urlParams)t.add(e);return t}function B(e,t,n){let r=e;if(r.constructor.name===`AsyncFunction`||r.toString().includes(`__awaiter`))throw TypeError(`[validation-plugin] Route "${n}" ${t} cannot be async`)}function gt(e){L(I(e,`validateExistingRoutes`).definitions,(e,t)=>{if(typeof e.name!=`string`||!e.name)throw TypeError(`[validation-plugin] validateExistingRoutes: route has invalid name: ${e.name}`);if(typeof e.path!=`string`)throw TypeError(`[validation-plugin] validateExistingRoutes: route "${t}" has non-string path (${typeof e.path})`)})}function _t(e){let{config:t,tree:n,matcher:r}=I(e,`validateForwardToConsistency`);for(let[e,i]of P(t.forwardMap)){if(!R(n,i))throw Error(`[validation-plugin] validateForwardToConsistency: forwardTo target "${i}" does not exist in tree (source route: "${e}")`);let t=r.getSegmentsByName(e),a=r.getSegmentsByName(i);if(t&&a){let n=z(t),r=[...z(a)].filter(e=>!n.has(e));if(r.length>0)throw Error(`[validation-plugin] validateForwardToConsistency: forwardTo target "${i}" requires params [${r.join(`, `)}] not available in source route "${e}"`)}}for(let e of F(t.forwardMap))ht(e,t.forwardMap)}function V(e,t){for(let[n,r]of P(e))if(typeof r!=`object`||!r||Array.isArray(r))throw TypeError(`[validation-plugin] validateRoutePropertiesStore: route "${n}" ${t} must be a plain object, got ${Array.isArray(r)?`array`:typeof r}`)}function vt(e){let{config:t}=I(e,`validateRoutePropertiesStore`);for(let[e,n]of P(t.decoders)){if(typeof n!=`function`)throw TypeError(`[validation-plugin] validateRoutePropertiesStore: route "${e}" decoder must be a function, got ${typeof n}`);B(n,`decoder`,e)}for(let[e,n]of P(t.encoders)){if(typeof n!=`function`)throw TypeError(`[validation-plugin] validateRoutePropertiesStore: route "${e}" encoder must be a function, got ${typeof n}`);B(n,`encoder`,e)}V(t.defaultParams,`defaultParams`),V(t.defaultSearch,`defaultSearch`);for(let[e,n]of P(t.forwardFnMap)){if(typeof n!=`function`)throw TypeError(`[validation-plugin] validateRoutePropertiesStore: route "${e}" forwardTo callback must be a function, got ${typeof n}`);B(n,`forwardTo callback`,e)}}function yt(e){let{config:t,tree:n}=I(e,`validateForwardToTargetsStore`);for(let[e,r]of P(t.forwardMap))if(!R(n,r))throw Error(`[validation-plugin] validateForwardToTargetsStore: forwardTo target "${r}" does not exist for route "${e}"`)}function bt(e){if(!e||typeof e!=`object`)throw TypeError(`[validation-plugin] validateDependenciesStructure: deps must be an object`);let t=e;if(!t.dependencies||typeof t.dependencies!=`object`)throw TypeError(`[validation-plugin] validateDependenciesStructure: deps.dependencies must be an object`);let n=t.dependencies;for(let e of F(n))if(mt(n,e)?.get)throw TypeError(`[validation-plugin] validateDependenciesStructure: dependency "${e}" must not use a getter`);if(!t.limits||typeof t.limits!=`object`)throw TypeError(`[validation-plugin] validateDependenciesStructure: deps.limits must be an object`);let r=t.limits;for(let e of[`maxDependencies`,`maxPlugins`,`maxListeners`,`warnListeners`,`maxLifecycleHandlers`])if(!Number.isInteger(r[e]))throw TypeError(`[validation-plugin] validateDependenciesStructure: deps.limits.${e} must be an integer, got ${String(r[e])}`)}function xt(e){let t=e&&typeof e==`object`?e:{};return t.limits&&typeof t.limits==`object`?t.limits:{}}function St(e,t){if(!e||typeof e!=`object`)return;let n=e,r=n.dependencies,i=n.limits;if(!r||typeof r!=`object`||!i||typeof i!=`object`)return;let a=F(r).length,o=i,s=t.maxDependencies,c=o.maxDependencies,l=typeof s==`number`?s:c;if(typeof l==`number`&&l>0&&a>l)throw RangeError(`[validation-plugin] validateLimitsConsistency: dependency count (${a}) exceeds maxDependencies limit (${l})`)}function Ct(e,t){St(t,xt(e))}function H(e,t){if(typeof e==`string`&&e&&!R(I(t,`validateResolvedDefaultRoute`).tree,e))throw Error(`[validation-plugin] defaultRoute resolved to non-existent route: "${e}"`)}function wt(e,t){let n=I(e,`warnOrphanedGuards`),r=n.lifecycleNamespace;if(typeof r?.getFactoriesByOrigin!=`function`)return;let[i,a]=r.getFactoriesByOrigin().external,o=new Set;for(let e of[...Object.keys(i),...Object.keys(a)])R(n.tree,e)||o.add(e);for(let e of o)t.warn(`router.start`,`Guard registered for route "${e}", which the route tree does not contain. It will never run unless that route is added. Check the name for a typo.`)}const Tt=Object.keys;function Et(e,t){if(e!==void 0){if(typeof e!=`string`&&typeof e!=`function`)throw TypeError(`[router.addRoute] forwardTo must be a string or function for route "${t}", got ${y(e)}`);if(typeof e==`function`){let n=e.constructor.name===`AsyncFunction`,r=e.toString().includes(`__awaiter`);if(n||r)throw TypeError(`[router.addRoute] forwardTo callback cannot be async for route "${t}". Async functions break matchPath/buildPath.`)}}}function U(e,t,n){if(e!==void 0&&(typeof e!=`object`||!e||Array.isArray(e)))throw TypeError(`[router.addRoute] ${t} must be an object for route "${n}", got ${y(e)}`)}function W(e,t){if(e.canActivate!==void 0&&typeof e.canActivate!=`function`)throw TypeError(`[router.addRoute] canActivate must be a function for route "${t}", got ${y(e.canActivate)}`);if(e.canDeactivate!==void 0&&typeof e.canDeactivate!=`function`)throw TypeError(`[router.addRoute] canDeactivate must be a function for route "${t}", got ${y(e.canDeactivate)}`);if(U(e.defaultParams,`defaultParams`,t),U(e.defaultSearch,`defaultSearch`,t),e.decodeParams?.constructor.name===`AsyncFunction`)throw TypeError(`[router.addRoute] decodeParams cannot be async for route "${t}". Async functions break matchPath/buildPath.`);if(e.encodeParams?.constructor.name===`AsyncFunction`)throw TypeError(`[router.addRoute] encodeParams cannot be async for route "${t}". Async functions break matchPath/buildPath.`);if(Et(e.forwardTo,t),e.children)for(let n of e.children)W(n,`${t}.${n.name}`)}function Dt(e){let t=new Set,n=/[*:]([A-Z_a-z]\w*)/g,r;for(;(r=n.exec(e))!==null;)t.add(r[1]);return t}function G(e){let t=new Set;for(let n of e)for(let e of Dt(n))t.add(e);return t}function K(e,t,n=``,r=[]){for(let i of e){let e=n?`${n}.${i.name}`:i.name,a=[...r,i.path];if(e===t)return a;if(i.children&&t.startsWith(`${e}.`))return K(i.children,t,e,a)}throw Error(`[internal] collectPathsToRoute: route "${t}" not found`)}function q(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 q(r.children,e))n.add(t)}return n}function J(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 J(r.children,e))n.set(t,i)}return n}function Y(e){let t=new Set;for(let n of e)for(let e of n.paramMeta.urlParams)t.add(e);return t}function Ot(e,t,n,r){return t?Y(n.getSegmentsByName(e)??[]):G(K(r,e))}const kt=new Set;function At(e,t,n,r,i,a){let o=i.hasRoute(t),s=r.has(t);if(!o&&!s)throw ReferenceError(`[router.addRoute] forwardTo target "${t}" does not exist for route "${e}"`);let c=new Set([...a,...G(K(n,e))]),l=[...Ot(t,o,i,n)].filter(e=>!c.has(e));if(l.length>0)throw Error(`[router.addRoute] forwardTo target "${t}" requires params [${l.join(`, `)}] that are not available in source route "${e}"`)}function jt(e,t,r,i){let o=q(e),s=i?new Set([...o].map(e=>`${i}.${e}`)):o,c=i?Y(r.getSegmentsByName(i)):kt,l=J(e),u={...t};for(let[e,t]of l)a(u,e,t);for(let[t,n]of l)At(t,n,e,s,r,c);for(let e of Tt(u))n(e,u)}function Mt(e,t){if(e.startsWith(`@@`))throw Error(`[router.${t}] Route name "${e}" uses the reserved "@@" prefix. Routes with this prefix are internal and cannot be modified through the public API.`)}function Nt(e,t){for(let n of e)n&&typeof n==`object`&&typeof n.name==`string`&&(Mt(n.name,t),n.children&&Nt(n.children,t))}function Pt(e){v(e,`removeRoute`)}function Ft(e){if(typeof e!=`string`)throw TypeError(`[router.setRootPath] rootPath must be a string, got ${y(e)}`)}function X(e){return e.constructor.name===`AsyncFunction`||String(e).includes(`__awaiter`)}function It(e){let t=e;if(t.canActivate!==void 0&&typeof t.canActivate!=`function`)throw TypeError(`[router.addRoute] canActivate must be a function, got ${y(t.canActivate)}`);if(t.canDeactivate!==void 0&&typeof t.canDeactivate!=`function`)throw TypeError(`[router.addRoute] canDeactivate must be a function, got ${y(t.canDeactivate)}`)}function Lt(e){let t=e,n=t.name;if(t.decodeParams!==void 0&&X(t.decodeParams))throw TypeError(`[router.addRoute] decodeParams cannot be async for route "${String(n)}"`);if(t.encodeParams!==void 0&&X(t.encodeParams))throw TypeError(`[router.addRoute] encodeParams cannot be async for route "${String(n)}"`);if(typeof t.forwardTo==`function`&&X(t.forwardTo))throw TypeError(`[router.addRoute] forwardTo callback cannot be async for route "${String(n)}"`)}function Rt(e){for(let t of e){if(typeof t!=`object`||!t||Array.isArray(t))throw TypeError(`[router.addRoute] Route must be an object, got ${y(t)}`);W(t,t.name)}}function zt(e){if(typeof e!=`string`||e===``)throw TypeError(`[router.addRoute] parent option must be a non-empty string, got ${y(e)}`);v(e,`addRoute`)}function Bt(e,t,n,r){if(!u(e))throw TypeError(`[router.isActiveRoute] name must be a string, got ${typeof e}`);if(T(t,`isActiveRoute`),n!==void 0&&typeof n!=`boolean`)throw TypeError(`[router.isActiveRoute] strictEquality must be a boolean, got ${typeof n}`);if(r!==void 0&&typeof r!=`boolean`)throw TypeError(`[router.isActiveRoute] ignoreQueryParams must be a boolean, got ${typeof r}`)}function Vt(e,t,n){if(!u(e))throw TypeError(`[router.${n}] Invalid routeName: ${y(e)}. Expected string.`);if(!m(t))throw TypeError(`[router.${n}] Invalid routeParams: ${y(t)}. Expected plain object.`)}function Ht(e,t){if(v(e,`updateRoute`),e===``)throw ReferenceError(`[router.updateRoute] Invalid name: empty string. Cannot update root node.`);if(t===null)throw TypeError(`[router.updateRoute] updates must be an object, got null`);if(typeof t!=`object`||Array.isArray(t))throw TypeError(`[router.updateRoute] updates must be an object, got ${y(t)}`)}function Z(e,t){if(e.constructor.name===`AsyncFunction`||e.toString().includes(`__awaiter`))throw TypeError(`[router.updateRoute] ${t} cannot be an async function`)}function Q(e,t){if(e!=null){if(typeof e!=`function`)throw TypeError(`[router.updateRoute] ${t} must be a function or null, got ${typeof e}`);Z(e,t)}}function Ut(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 TypeError(`[router.updateRoute] forwardTo must be a string, function, or null, got ${y(t)}`);typeof t==`function`&&Z(t,`forwardTo callback`)}$(n,`defaultParams`),$(r,`defaultSearch`),Q(i,`decodeParams`),Q(a,`encodeParams`),Q(o,`canActivate`),Q(s,`canDeactivate`)}function $(e,t){if(e!=null&&(typeof e!=`object`||Array.isArray(e)))throw TypeError(`[router.updateRoute] ${t} must be an object or null, got ${y(e)}`)}function Wt(e){if(!u(e)||e===``)throw TypeError(`[router.buildPath] route must be a non-empty string, got ${typeof e==`string`?`""`:typeof e}`)}function Gt(e){if(!u(e))throw TypeError(`[router.matchPath] path must be a string, got ${typeof e}`)}function Kt(e){if(!u(e))throw TypeError(`[router.shouldUpdateNode] nodeName must be a string, got ${typeof e}`)}function qt(e,t,n,r,i){if(i&&t){let e=t;for(let t of i.split(`.`))if(e=e.children.get(t),!e)throw ReferenceError(`[router.addRoute] Parent route "${i}" does not exist`)}let a=new Set,o=new Map;for(let n of e)s(n,`addRoute`,t,i??``,a,o);n&&r&&jt(e,r,n,i)}function Jt(e){let t=new Set;for(let n of e)for(let e of n.paramMeta.urlParams)t.add(e);return t}function Yt(e,t,n){let r=n.getSegmentsByName(e),i=n.getSegmentsByName(t),a=Jt(r),o=[];for(let e of i)for(let t of e.paramMeta.urlParams)o.push(t);let s=o.filter(e=>!a.has(e));if(s.length>0)throw Error(`[router.addRoute] forwardTo target "${t}" requires params [${s.join(`, `)}] that are not available in source route "${e}"`)}function Xt(e,t,r){let i={...r.forwardMap,[e]:t};n(e,i)}function Zt(e,t,n,r,i){if(!n(e))throw ReferenceError(`[router.updateRoute] route "${e}" does not exist`);if(t!=null&&typeof t==`string`){if(!n(t))throw Error(`[router.updateRoute] forwardTo target "${t}" does not exist`);Yt(e,t,r),Xt(e,t,i)}}function Qt(e,t,n){if(!u(e))throw TypeError(`[router.makeState] Invalid name: ${y(e)}. Expected string.`);if(t!==void 0&&!m(t))throw TypeError(`[router.makeState] Invalid params: ${y(t)}. Expected plain object.`);if(n!==void 0&&!u(n))throw TypeError(`[router.makeState] Invalid path: ${y(n)}. Expected string.`)}function $t(){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 en(){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 tn(e,t){return{routes:{validateBuildPathArgs:Wt,validateMatchPathArgs:Gt,validateIsActiveRouteArgs:Bt,validateShouldUpdateNodeArgs:Kt,validateStateBuilderArgs:Vt,validateAddRouteArgs(e){Rt(e)},validateRoutes(e,t,n){let r=t;qt(e,r.tree,r.matcher,r.config?.forwardMap,n)},validateRemoveRouteArgs:Pt,validateUpdateRouteBasicArgs:Ht,validateUpdateRoutePropertyTypes(e,t){let n=t;Ut({forwardTo:n.forwardTo,defaultParams:n.defaultParams,defaultSearch:n.defaultSearch,decodeParams:n.decodeParams,encodeParams:n.encodeParams,canActivate:n.canActivate,canDeactivate:n.canDeactivate})},validateUpdateRoute(e,t,n){let r=n,i=t.forwardTo;Zt(e,i,e=>r.matcher.hasRoute(e),r.matcher,r.config)},validateParentOption(e,t){zt(e);let n=t;for(let t of e.split(`.`)){let r=n.children.get(t);if(!r)throw ReferenceError(`[router.addRoute] Parent route "${e}" does not exist`);n=r}},validateRouteName(e,t){v(e,t)},throwIfInternalRoute(e,t){Mt(e,t)},throwIfInternalRouteInArray(e,t){Nt(e,t)},validateSetRootPathArgs:Ft,guardRouteCallbacks:It,guardNoAsyncCallbacks:Lt},options:{validateOptions:it,validateResolvedDefaultRoute:H},dependencies:{validateDependencyName:xe,validateSetDependencyArgs(e,t,n){Se(e)},validateDependenciesObject:Ce,validateDependencyExists(e,t){let n=t.dependencies?.[e];we(n,e)},validateDependencyCount(t,n){Te(t,n,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){st(e,1,t?.maxPlugins)},validateNoDuplicatePlugins:ct,validatePluginKeys:ut,validateCountThresholds(t){lt(t,e.getOptions().limits?.maxPlugins??c.maxPlugins,e.logger)},warnBatchDuplicates(){dt(e.logger)},warnPluginMethodType(t){ft(t,e.logger)},warnPluginAfterStart(t){pt(t,e.logger)}},lifecycle:{validateHandler:Fe,validateHandlerLimit(t,n){Ie(t,n,e.getOptions().limits?.maxLifecycleHandlers??c.maxLifecycleHandlers)},validateCountThresholds(t,n){Le(t,n,e.getOptions().limits?.maxLifecycleHandlers??c.maxLifecycleHandlers,e.logger)},warnOverwrite(t,n,r){Re(t,n,r,e.logger)},warnAsyncGuardSync(t,n){ze(t,n,e.logger)}},navigation:{validateNavigateArgs:He,validateNavigateToDefaultArgs(n){Ue(n),t.check(e.logger)},validateNavigateToStateArgs:We,validateNavigationOptions:Ge,validateParams:qe,validateParamsShape:T,validateSearch:Je,validateStartArgs:Ye},state:{validateMakeStateArgs:Qt,reportDroppedQueryKey:$t(),reportUndeclaredParamKey:en(),validateAreStatesEqualArgs(e,t,n){if(!_(e))throw TypeError(`[router.areStatesEqual] Invalid state1: ${y(e)}. Expected State object.`);if(!_(t))throw TypeError(`[router.areStatesEqual] Invalid state2: ${y(t)}. Expected State object.`);if(n!==void 0&&!d(n))throw TypeError(`[router.areStatesEqual] Invalid ignoreQueryParams: ${y(n)}. Expected boolean.`)}},eventBus:{validateListenerArgs(e,t){Ne(e,t)},validateCountThresholds(t,n,r){let i=e.getOptions().limits?.maxListeners??c.maxListeners;Pe(t,n,r,e.logger,i)}}}}function nn(){return t=>{let n=o(t);if(t.isActive())throw i(new e(`VALIDATION_PLUGIN_AFTER_START`,{message:`validation-plugin must be registered before router.start()`}));let a=new ve;a.watch(n.getAdoptedOrigins()),n.validator=tn(n,a);try{let e=n.routeGetStore(),t=n.dependenciesGetStore(),r=n.getOptions();gt(e),_t(e),vt(e),yt(e),bt(t),Ct(r,t),n.validator.options.validateOptions(r,`constructor (retrospective)`),typeof r.defaultRoute==`string`&&H(r.defaultRoute,e)}catch(e){throw n.validator=null,e}let s=r(t).addInterceptor(`start`,(e,t)=>{try{wt(n.routeGetStore(),n.logger)}catch{}return e(t)});return{teardown(){s(),n.validator=null}}}}export{nn as validationPlugin};
|
|
1
|
+
import{RouterError as e,events as t,resolveForwardChain as n}from"@real-router/core";import{getPluginApi as r}from"@real-router/core/api";import{freezeThrownError as i,putField as a}from"@real-router/core/utils";import{findMisChanneledKey as o,getInternals as s,validateRoute as c}from"@real-router/core/validation";const l=Object.freeze({maxDependencies:100,maxPlugins:50,maxListeners:1e4,warnListeners:1e3,maxLifecycleHandlers:200});function u(e){return{warn:Math.floor(e*.2),error:Math.floor(e*.5)}}function d(e){return typeof e==`string`}function f(e){return typeof e==`boolean`}function ee(e,t){return e in t}const te=Object.getPrototypeOf,ne=Object.values,re=Object.hasOwn;function ie(e){if(Array.isArray(e))return!0;let t=te(e);return t===null||t===Object.prototype}function ae(e,t){let n=Array.isArray(e)?e:ne(e);for(let e of n)t.push(e)}function oe(e){let t=typeof e;return t===`string`||t===`boolean`||t===`number`&&Number.isFinite(e)}var p=class{container;constructor(e){this.container=e}};function se(e,t,n,r){return n.has(e)?!1:r.has(e)?!0:ie(e)?(n.add(e),t.push(new p(e)),ae(e,t),!0):!1}function ce(e){let t=[e],n=new WeakSet,r=new WeakSet;for(;t.length>0;){let e=t.pop();if(e instanceof p){n.delete(e.container),r.add(e.container);continue}if(e!=null){if(typeof e==`object`){if(!se(e,t,n,r))return!1;continue}if(!oe(e))return!1}}return!0}function le(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 ue(e)}catch{return!1}}function ue(e){if(typeof e!=`object`||!e||Array.isArray(e))return!1;let t=te(e);if(t!==null&&t!==Object.prototype)return!1;let n=!1;for(let t in e){if(!re(e,t))continue;let r=e[t];if(!le(r)){let e=typeof r;if(e===`function`||e===`symbol`)return!1;n=!0;break}}return!n||ce(e)}const de=[`replace`,`reload`,`force`,`forceDeactivate`,`redirected`];function fe(e){if(typeof e!=`object`||!e||Array.isArray(e))return!1;let t=e;for(let e of de){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 pe=/\S/,h=/^[A-Z_a-z][\w-]*(?:\.[A-Z_a-z][\w-]*)*$/;function g(e,t){return TypeError(`[router.${e}] ${t}`)}function me(e){return typeof e==`string`?e===``?!0:e.length>1e4?!1:e.startsWith(`@@`)?!0:h.test(e):!1}function he(e){return me(e.name)&&typeof e.path==`string`&&m(e.params)}function _(e){return typeof e!=`object`||!e?!1:he(e)}function v(e,t){if(typeof e!=`string`)throw g(t,`Route name must be a string, got ${typeof e}`);if(e!==``){if(!pe.test(e))throw g(t,`Route name cannot contain only whitespace`);if(e.length>1e4)throw g(t,`Route name exceeds maximum length of 10000 characters. This is a technical safety limit.`);if(!e.startsWith(`@@`)&&!h.test(e))throw g(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 y(e){if(e===null)return`null`;if(Array.isArray(e))return`array[${e.length}]`;if(typeof e==`object`){try{let t=e.constructor;if(typeof t==`function`&&t.name!==`Object`)return t.name||`object`}catch{}return`object`}return typeof e}const b=Object.entries,ge=[`defaultParams`,`defaultSearch`],_e=e=>new Map(b(e)),ve=(e,t)=>{let n=b(e);return n.length!==t.size||n.some(([e,n])=>!t.has(e)||!Object.is(t.get(e),n))};var ye=class{#e=new Map;#t=new Set;watch(e){for(let t of ge){let n=e[t],r=n?.deref();n!==void 0&&r!==void 0&&this.#e.set(t,{ref:n,before:_e(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&&ve(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 x=Object.keys,S=Object.getOwnPropertyDescriptor,be=Object.getPrototypeOf,xe=Object;function C(e){if(!e||typeof e!=`object`)return!1;let t=be(e);return t===null||t.constructor===xe}function Se(e,t){if(typeof e!=`string`)throw TypeError(`[router.${t}] dependency name must be a string, got ${typeof e}`)}function Ce(e){if(typeof e!=`string`)throw TypeError(`[router.setDependency] dependency name must be a string, got ${typeof e}`)}function we(e,t){if(!C(e))throw TypeError(`[router.${t}] Invalid argument: expected plain object, received ${y(e)}`);for(let n of x(e))if(S(e,n)?.get)throw TypeError(`[router.${t}] Getters not allowed: "${n}"`)}function Te(e,t,n){let r=t,i=r.limits?.maxDependencies??l.maxDependencies;if(i===0)return;let a=x(r.dependencies),o=new Set(a),s=0;for(let t of x(e))o.has(t)||(s+=1);let c=a.length;if(c+s>i)throw RangeError(`[router.${n}] Dependency limit exceeded (${i}). Current: ${c}, this batch adds ${s}.`)}function Ee(e,t){if(e===void 0)throw ReferenceError(`[router.getDependency] dependency "${t}" not found`)}function De(e,t,n){let r=e,i=r.limits?.maxDependencies??l.maxDependencies;if(i===0)return;let a=x(r.dependencies).length,{warn:o,error:s}=u(i);if(a>=i)throw RangeError(`[router.${t}] Dependency limit exceeded (${i}). Current: ${a}.`);a===s?n.error(`router.${t}`,`${a} dependencies registered! This indicates architectural problems. Hard limit at ${i}.`):a===o&&n.warn(`router.${t}`,`${a} dependencies registered. Consider if all are necessary.`)}function Oe(e){if(e!==void 0){if(!C(e))throw TypeError(`[cloneRouter] Invalid dependencies: expected plain object or undefined, received ${typeof e}`);for(let t of x(e))if(S(e,t)?.get)throw TypeError(`[cloneRouter] Getters not allowed in dependencies: "${t}"`)}}function ke(e,t,n){n.warn(`router.${t}`,`Router dependency already exists and is being overwritten:`,e)}function Ae(e,t,n){n.warn(`router.${t}`,`Overwritten:`,e.join(`, `))}function je(e,t){t.warn(`router.removeDependency`,`Attempted to remove non-existent dependency: "${typeof e==`string`?e:String(e)}"`)}const Me=Object.values,Ne=new Set(Me(t));function Pe(e){if(!Ne.has(e))throw TypeError(`[router.addEventListener] Invalid event name: ${String(e)}. Must be one of: $start, $stop, $$start, $$leaveApprove, $$cancel, $$success, $$error`)}function Fe(e,t){if(Pe(e),typeof t!=`function`)throw TypeError(`[router.addEventListener] callback must be a function, got ${typeof t}`)}function Ie(e,t,n,r,i=l.maxListeners){if(i===0)return;let{warn:a,error:o}=u(i);e>=o?r.error(`router.${n}`,`${e} listeners registered for "${t}"! This is excessive. Hard limit at ${i}.`):e>=a&&r.warn(`router.${n}`,`${e} listeners registered for "${t}". Consider whether all are necessary — a growing count usually means a missing unsubscribe.`)}function Le(e,t){if(!f(e)&&typeof e!=`function`)throw TypeError(`[router.${t}] Handler must be a boolean or factory function, got ${y(e)}`)}function Re(e,t,n=l.maxLifecycleHandlers){if(n!==0&&e>=n)throw RangeError(`[router.${t}] Lifecycle handler limit exceeded (${n}). This indicates too many routes with individual handlers. Consider using plugins for cross-cutting concerns.`)}function ze(e,t,n,r){if(n===0)return;let{warn:i,error:a}=u(n);e>=a?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 Be(e,t,n,r){r.warn(`router.${n}`,`Overwriting existing ${t} handler for route "${e}"`)}function Ve(e,t,n){n.warn(`router.${t}`,`Guard for "${e}" returned a Promise. Sync check cannot resolve async guards — returning false.`)}const He=Object.hasOwn,Ue=Object.getPrototypeOf;function We(e){if(typeof e!=`string`)throw TypeError(`[router.navigate] Invalid route name: expected string, got ${y(e)}`)}function Ge(e){if(e!==void 0&&(typeof e!=`object`||!e))throw TypeError(`[router.navigateToDefault] Invalid options: ${y(e)}. Expected NavigationOptions object.`)}function Ke(e){if(typeof e!=`object`||!e)throw TypeError(`[router.navigateToState] Invalid state: ${y(e)}. Expected State object.`);let t=e;if(!d(t.name))throw TypeError(`[router.navigateToState] Invalid state.name: ${y(t.name)}. Expected string.`);if(!m(t.params))throw TypeError(`[router.navigateToState] Invalid state.params: ${y(t.params)}. Expected plain object.`);if(!d(t.path))throw TypeError(`[router.navigateToState] Invalid state.path: ${y(t.path)}. Expected string.`)}function qe(e,t){if(!fe(e))throw TypeError(`[router.${t}] Invalid options: ${y(e)}. Expected NavigationOptions object.`)}const w=/[\u0000-\u001F\u007F]/;function Je(e,t){for(let n in e){if(!He(e,n))continue;let r=e[n],i=typeof r;if(i===`symbol`||i===`bigint`)throw TypeError(`[router.${t}] param "${n}" cannot be a ${i} — it does not round-trip through the URL path. Use a string, number, or boolean.`);if(i===`string`&&w.test(r))throw TypeError(`[router.${t}] param "${n}" must not contain control characters (NUL / C0 / DEL) — they corrupt the URL path.`)}}function T(e,t){if(e===void 0)return;let n=e!==null&&Ue(e);if(n!==null&&n!==Object.prototype)throw TypeError(`[router.${t}] params must be a plain object, got ${y(e)}`)}function Ye(e,t){if(e!==void 0&&(Je(e,t),!m(e)))throw TypeError(`[router.${t}] params must be a plain object, got ${y(e)}`)}function Xe(e,t){if(e!==void 0&&(typeof e!=`object`||!e||Array.isArray(e)))throw TypeError(`[router.${t}] search must be a plain object, got ${y(e)}`)}function Ze(e){if(e!==void 0&&typeof e!=`string`)throw TypeError(`[router.start] path must be a string, got ${y(e)}.`);if(typeof e==`string`){if(w.test(e))throw TypeError(`[router.start] path must not contain control characters (NUL / C0 / DEL).`);if(e!==``&&!e.startsWith(`/`))throw TypeError(`[router.start] path must start with "/", got "${e}".`)}}const E=Object.entries,Qe=Object.hasOwn,$e=Object.keys,et=Object.getPrototypeOf,D={trailingSlash:[`strict`,`never`,`always`,`preserve`],queryParamsMode:[`default`,`strict`,`loose`],urlParamsEncoding:[`default`,`uri`,`uriComponent`,`none`]},tt={arrayFormat:[`none`,`brackets`,`index`,`comma`],booleanFormat:[`none`,`auto`,`empty-true`],nullFormat:[`default`,`hidden`],numberFormat:[`none`,`auto`]},nt=new Set([`defaultRoute`,`defaultParams`,`defaultSearch`,`trailingSlash`,`caseSensitive`,`queryParamsMode`,`queryParams`,`urlParamsEncoding`,`allowNotFound`,`rewritePathOnMatch`,`logger`,`limits`]),O={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 rt(e,t,n){if(typeof t!=`number`||!Number.isInteger(t))throw TypeError(`[router.${n}] limit "${e}" must be an integer, got ${String(t)}`);let r=O[e];if(t<r.min||t>r.max)throw RangeError(`[router.${n}] limit "${e}" must be between ${r.min} and ${r.max}, got ${t}`)}function k(e){let t=et(e);return t===null||t===Object.prototype}function it(e,t){if(!e||typeof e!=`object`||!k(e))throw TypeError(`[router.${t}] invalid limits: expected plain object, got ${typeof e}`);for(let[n,r]of E(e)){if(!Qe(O,n))throw TypeError(`[router.${t}] unknown limit: "${n}"`);r!==void 0&&rt(n,r,t)}let{warnListeners:n,maxListeners:r}=e;if(typeof n==`number`&&typeof r==`number`&&r>0&&n>r)throw RangeError(`[router.${t}] "limits.warnListeners" (${n}) must not exceed "limits.maxListeners" (${r}) — the warning channel would be unreachable`)}function A(e,t,n,r){if(e!==void 0&&(typeof e!=`string`||!n.includes(e))){let i=n.map(e=>`"${e}"`).join(`, `);throw TypeError(`[router.${r}] Invalid "${t}": "${typeof e==`string`?e:`(${typeof e})`}". Must be one of: ${i}`)}}function at(e,t){if(e!==void 0&&typeof e!=`string`&&typeof e!=`function`)throw TypeError(`[router.${t}] Invalid "defaultRoute": expected string or function, got ${typeof e}`)}function j(e,t,n){if(e!==void 0&&typeof e!=`function`&&(!e||typeof e!=`object`||Array.isArray(e)||!k(e)))throw TypeError(`[router.${n}] Invalid "${t}": expected plain object or function, got ${typeof e}`)}function ot(e,t){if(e===void 0)return;if(!e||typeof e!=`object`||Array.isArray(e))throw TypeError(`[router.${t}] Invalid "queryParams": expected plain object`);let n=e;for(let[e,r]of E(n)){if(!ee(e,tt))throw TypeError(`[router.${t}] Invalid "queryParams.${e}": unknown option`);A(r,`queryParams.${e}`,tt[e],t)}}function st(e,t){if(!e||typeof e!=`object`||Array.isArray(e))throw TypeError(`[router.${t}] Invalid options: expected plain object`);let n=e;for(let e of $e(n))if(!nt.has(e))throw TypeError(`[router.${t}] Unknown option: "${e}"`);if(at(n.defaultRoute,t),j(n.defaultParams,`defaultParams`,t),j(n.defaultSearch,`defaultSearch`,t),A(n.trailingSlash,`trailingSlash`,D.trailingSlash,t),A(n.queryParamsMode,`queryParamsMode`,D.queryParamsMode,t),A(n.urlParamsEncoding,`urlParamsEncoding`,D.urlParamsEncoding,t),n.allowNotFound!==void 0&&typeof n.allowNotFound!=`boolean`)throw TypeError(`[router.${t}] Invalid "allowNotFound": expected boolean, got ${typeof n.allowNotFound}`);if(n.rewritePathOnMatch!==void 0&&typeof n.rewritePathOnMatch!=`boolean`)throw TypeError(`[router.${t}] Invalid "rewritePathOnMatch": expected boolean, got ${typeof n.rewritePathOnMatch}`);if(n.caseSensitive!==void 0&&typeof n.caseSensitive!=`boolean`)throw TypeError(`[router.${t}] Invalid "caseSensitive": expected boolean, got ${typeof n.caseSensitive}`);ot(n.queryParams,t),n.limits!==void 0&&it(n.limits,t)}const ct=Object.hasOwn,M=`router.usePlugin`,lt={onStart:!0,onStop:!0,onTransitionStart:!0,onTransitionLeaveApprove:!0,onTransitionSuccess:!0,onTransitionError:!0,onTransitionCancel:!0};function ut(e,t,n=l.maxPlugins){if(n!==0&&e+t>n)throw RangeError(`[router.usePlugin] Plugin limit exceeded (${n}). Current: ${e}, Attempting to add: ${t}. This indicates an architectural problem. Consider consolidating plugins.`)}function dt(e,t){if(t.includes(e))throw Error(`[router.usePlugin] Plugin factory already registered. To re-register, first unsubscribe the existing plugin.`)}function ft(e,t,n){if(t===0)return;let{warn:r,error:i}=u(t);e>=i?n.error(M,`${e} plugins registered! This is excessive. Hard limit at ${t}.`):e>=r&&n.warn(M,`${e} plugins registered. Consider if all are necessary.`)}function pt(e){for(let t in e)if(!(t===`teardown`||ct(lt,t)))throw TypeError(`[router.usePlugin] Unknown property '${t}'. Plugin must only contain event handlers and optional teardown.`)}function mt(e){e.warn(M,`Duplicate factory in batch, will be registered once`)}function ht(e,t){t.warn(M,`Property '${e}' is not a function, skipping`)}function gt(e,t){e===`onStart`&&t.warn(M,`Router already started, onStart will not be called`)}const N=Object.entries,_t=Object.getOwnPropertyDescriptor,P=Object.keys;function F(e,t){if(!e||typeof e!=`object`)throw TypeError(`[validation-plugin] ${t}: store must be an object`);let n=e;if(!Array.isArray(n.definitions))throw TypeError(`[validation-plugin] ${t}: store.definitions must be an array`);if(!n.config||typeof n.config!=`object`)throw TypeError(`[validation-plugin] ${t}: store.config must be an object`);if(!n.tree||typeof n.tree!=`object`)throw TypeError(`[validation-plugin] ${t}: store.tree must be an object`);return n}function I(e,t,n=``){for(let r of e){let e=n?`${n}.${r.name}`:r.name;t(r,e),r.children&&I(r.children,t,e)}}function L(e,t){let n=t.split(`.`),r=e;for(let e of n)if(r=r.children.get(e),!r)return!1;return!0}function vt(e,t){try{return n(e,t)}catch(e){throw Error(`[validation-plugin] ${e.message}`,{cause:e})}}function R(e){let t=new Set;for(let n of e)for(let e of n.paramMeta.urlParams)t.add(e);return t}function z(e,t,n){let r=e;if(r.constructor.name===`AsyncFunction`||r.toString().includes(`__awaiter`))throw TypeError(`[validation-plugin] Route "${n}" ${t} cannot be async`)}function yt(e){I(F(e,`validateExistingRoutes`).definitions,(e,t)=>{if(typeof e.name!=`string`||!e.name)throw TypeError(`[validation-plugin] validateExistingRoutes: route has invalid name: ${e.name}`);if(typeof e.path!=`string`)throw TypeError(`[validation-plugin] validateExistingRoutes: route "${t}" has non-string path (${typeof e.path})`)})}function bt(e){let{config:t,tree:n,matcher:r}=F(e,`validateForwardToConsistency`);for(let[e,i]of N(t.forwardMap)){if(!L(n,i))throw Error(`[validation-plugin] validateForwardToConsistency: forwardTo target "${i}" does not exist in tree (source route: "${e}")`);let t=r.getSegmentsByName(e),a=r.getSegmentsByName(i);if(t&&a){let n=R(t),r=[...R(a)].filter(e=>!n.has(e));if(r.length>0)throw Error(`[validation-plugin] validateForwardToConsistency: forwardTo target "${i}" requires params [${r.join(`, `)}] not available in source route "${e}"`)}}for(let e of P(t.forwardMap))vt(e,t.forwardMap)}function B(e,t){for(let[n,r]of N(e))if(typeof r!=`object`||!r||Array.isArray(r))throw TypeError(`[validation-plugin] validateRoutePropertiesStore: route "${n}" ${t} must be a plain object, got ${Array.isArray(r)?`array`:typeof r}`)}function xt(e){let{config:t}=F(e,`validateRoutePropertiesStore`);for(let[e,n]of N(t.decoders)){if(typeof n!=`function`)throw TypeError(`[validation-plugin] validateRoutePropertiesStore: route "${e}" decoder must be a function, got ${typeof n}`);z(n,`decoder`,e)}for(let[e,n]of N(t.encoders)){if(typeof n!=`function`)throw TypeError(`[validation-plugin] validateRoutePropertiesStore: route "${e}" encoder must be a function, got ${typeof n}`);z(n,`encoder`,e)}B(t.defaultParams,`defaultParams`),B(t.defaultSearch,`defaultSearch`);for(let[e,n]of N(t.forwardFnMap)){if(typeof n!=`function`)throw TypeError(`[validation-plugin] validateRoutePropertiesStore: route "${e}" forwardTo callback must be a function, got ${typeof n}`);z(n,`forwardTo callback`,e)}}function St(e){let{config:t,tree:n}=F(e,`validateForwardToTargetsStore`);for(let[e,r]of N(t.forwardMap))if(!L(n,r))throw Error(`[validation-plugin] validateForwardToTargetsStore: forwardTo target "${r}" does not exist for route "${e}"`)}function Ct(e){if(!e||typeof e!=`object`)throw TypeError(`[validation-plugin] validateDependenciesStructure: deps must be an object`);let t=e;if(!t.dependencies||typeof t.dependencies!=`object`)throw TypeError(`[validation-plugin] validateDependenciesStructure: deps.dependencies must be an object`);let n=t.dependencies;for(let e of P(n))if(_t(n,e)?.get)throw TypeError(`[validation-plugin] validateDependenciesStructure: dependency "${e}" must not use a getter`);if(!t.limits||typeof t.limits!=`object`)throw TypeError(`[validation-plugin] validateDependenciesStructure: deps.limits must be an object`);let r=t.limits;for(let e of[`maxDependencies`,`maxPlugins`,`maxListeners`,`warnListeners`,`maxLifecycleHandlers`])if(!Number.isInteger(r[e]))throw TypeError(`[validation-plugin] validateDependenciesStructure: deps.limits.${e} must be an integer, got ${String(r[e])}`)}function wt(e){let t=e&&typeof e==`object`?e:{};return t.limits&&typeof t.limits==`object`?t.limits:{}}function Tt(e,t){if(!e||typeof e!=`object`)return;let n=e,r=n.dependencies,i=n.limits;if(!r||typeof r!=`object`||!i||typeof i!=`object`)return;let a=P(r).length,o=i,s=t.maxDependencies,c=o.maxDependencies,l=typeof s==`number`?s:c;if(typeof l==`number`&&l>0&&a>l)throw RangeError(`[validation-plugin] validateLimitsConsistency: dependency count (${a}) exceeds maxDependencies limit (${l})`)}function Et(e,t){Tt(t,wt(e))}function V(e,t){if(typeof e==`string`&&e&&!L(F(t,`validateResolvedDefaultRoute`).tree,e))throw Error(`[validation-plugin] defaultRoute resolved to non-existent route: "${e}"`)}function Dt(e,t){let n=F(e,`warnOrphanedGuards`),r=n.lifecycleNamespace;if(typeof r?.getFactoriesByOrigin!=`function`)return;let[i,a]=r.getFactoriesByOrigin().external,o=new Set;for(let e of[...P(i),...P(a)])L(n.tree,e)||o.add(e);for(let e of o)t.warn(`router.start`,`Guard registered for route "${e}", which the route tree does not contain. It will never run unless that route is added. Check the name for a typo.`)}const Ot=Object.keys;function kt(e,t){if(e!==void 0){if(typeof e!=`string`&&typeof e!=`function`)throw TypeError(`[router.addRoute] forwardTo must be a string or function for route "${t}", got ${y(e)}`);if(typeof e==`function`){let n=e.constructor.name===`AsyncFunction`,r=e.toString().includes(`__awaiter`);if(n||r)throw TypeError(`[router.addRoute] forwardTo callback cannot be async for route "${t}". Async functions break matchPath/buildPath.`)}}}function H(e,t,n){if(e!==void 0&&(typeof e!=`object`||!e||Array.isArray(e)))throw TypeError(`[router.addRoute] ${t} must be an object for route "${n}", got ${y(e)}`)}function U(e,t){if(e.canActivate!==void 0&&typeof e.canActivate!=`function`)throw TypeError(`[router.addRoute] canActivate must be a function for route "${t}", got ${y(e.canActivate)}`);if(e.canDeactivate!==void 0&&typeof e.canDeactivate!=`function`)throw TypeError(`[router.addRoute] canDeactivate must be a function for route "${t}", got ${y(e.canDeactivate)}`);if(H(e.defaultParams,`defaultParams`,t),H(e.defaultSearch,`defaultSearch`,t),e.decodeParams?.constructor.name===`AsyncFunction`)throw TypeError(`[router.addRoute] decodeParams cannot be async for route "${t}". Async functions break matchPath/buildPath.`);if(e.encodeParams?.constructor.name===`AsyncFunction`)throw TypeError(`[router.addRoute] encodeParams cannot be async for route "${t}". Async functions break matchPath/buildPath.`);if(kt(e.forwardTo,t),e.children)for(let n of e.children)U(n,`${t}.${n.name}`)}function At(e){let t=new Set,n=/[*:]([A-Z_a-z]\w*)/g,r;for(;(r=n.exec(e))!==null;)t.add(r[1]);return t}function W(e){let t=new Set;for(let n of e)for(let e of At(n))t.add(e);return t}function G(e,t,n=``,r=[]){for(let i of e){let e=n?`${n}.${i.name}`:i.name,a=[...r,i.path];if(e===t)return a;if(i.children&&t.startsWith(`${e}.`))return G(i.children,t,e,a)}throw Error(`[internal] collectPathsToRoute: route "${t}" not found`)}function K(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 K(r.children,e))n.add(t)}return n}function q(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 q(r.children,e))n.set(t,i)}return n}function J(e){let t=new Set;for(let n of e)for(let e of n.paramMeta.urlParams)t.add(e);return t}function jt(e,t,n,r){return t?J(n.getSegmentsByName(e)??[]):W(G(r,e))}const Mt=new Set;function Nt(e,t,n,r,i,a){let o=i.hasRoute(t),s=r.has(t);if(!o&&!s)throw ReferenceError(`[router.addRoute] forwardTo target "${t}" does not exist for route "${e}"`);let c=new Set([...a,...W(G(n,e))]),l=[...jt(t,o,i,n)].filter(e=>!c.has(e));if(l.length>0)throw Error(`[router.addRoute] forwardTo target "${t}" requires params [${l.join(`, `)}] that are not available in source route "${e}"`)}function Pt(e,t,r,i){let o=K(e),s=i?new Set([...o].map(e=>`${i}.${e}`)):o,c=i?J(r.getSegmentsByName(i)):Mt,l=q(e),u={...t};for(let[e,t]of l)a(u,e,t);for(let[t,n]of l)Nt(t,n,e,s,r,c);for(let e of Ot(u))n(e,u)}function Y(e,t){if(e.startsWith(`@@`))throw Error(`[router.${t}] Route name "${e}" uses the reserved "@@" prefix. Routes with this prefix are internal and cannot be modified through the public API.`)}function X(e,t){for(let n of e)n&&typeof n==`object`&&typeof n.name==`string`&&(Y(n.name,t),n.children&&X(n.children,t))}function Ft(e){v(e,`removeRoute`)}function It(e){if(typeof e!=`string`)throw TypeError(`[router.setRootPath] rootPath must be a string, got ${y(e)}`)}function Z(e){return e.constructor.name===`AsyncFunction`||String(e).includes(`__awaiter`)}function Lt(e){let t=e;if(t.canActivate!==void 0&&typeof t.canActivate!=`function`)throw TypeError(`[router.addRoute] canActivate must be a function, got ${y(t.canActivate)}`);if(t.canDeactivate!==void 0&&typeof t.canDeactivate!=`function`)throw TypeError(`[router.addRoute] canDeactivate must be a function, got ${y(t.canDeactivate)}`)}function Rt(e){let t=e,n=t.name;if(t.decodeParams!==void 0&&Z(t.decodeParams))throw TypeError(`[router.addRoute] decodeParams cannot be async for route "${String(n)}"`);if(t.encodeParams!==void 0&&Z(t.encodeParams))throw TypeError(`[router.addRoute] encodeParams cannot be async for route "${String(n)}"`);if(typeof t.forwardTo==`function`&&Z(t.forwardTo))throw TypeError(`[router.addRoute] forwardTo callback cannot be async for route "${String(n)}"`)}function zt(e){for(let t of e){if(typeof t!=`object`||!t||Array.isArray(t))throw TypeError(`[router.addRoute] Route must be an object, got ${y(t)}`);U(t,t.name)}}function Bt(e){if(typeof e!=`string`||e===``)throw TypeError(`[router.addRoute] parent option must be a non-empty string, got ${y(e)}`);v(e,`addRoute`)}function Vt(e,t,n,r){if(!d(e))throw TypeError(`[router.isActiveRoute] name must be a string, got ${typeof e}`);if(T(t,`isActiveRoute`),n!==void 0&&typeof n!=`boolean`)throw TypeError(`[router.isActiveRoute] strictEquality must be a boolean, got ${typeof n}`);if(r!==void 0&&typeof r!=`boolean`)throw TypeError(`[router.isActiveRoute] ignoreQueryParams must be a boolean, got ${typeof r}`)}function Ht(e,t,n){if(!d(e))throw TypeError(`[router.${n}] Invalid routeName: ${y(e)}. Expected string.`);if(!m(t))throw TypeError(`[router.${n}] Invalid routeParams: ${y(t)}. Expected plain object.`)}function Ut(e,t){if(v(e,`updateRoute`),e===``)throw ReferenceError(`[router.updateRoute] Invalid name: empty string. Cannot update root node.`);if(t===null)throw TypeError(`[router.updateRoute] updates must be an object, got null`);if(typeof t!=`object`||Array.isArray(t))throw TypeError(`[router.updateRoute] updates must be an object, got ${y(t)}`)}function Q(e,t){if(e.constructor.name===`AsyncFunction`||e.toString().includes(`__awaiter`))throw TypeError(`[router.updateRoute] ${t} cannot be an async function`)}function $(e,t){if(e!=null){if(typeof e!=`function`)throw TypeError(`[router.updateRoute] ${t} must be a function or null, got ${typeof e}`);Q(e,t)}}function Wt(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 TypeError(`[router.updateRoute] forwardTo must be a string, function, or null, got ${y(t)}`);typeof t==`function`&&Q(t,`forwardTo callback`)}Gt(n,`defaultParams`),Gt(r,`defaultSearch`),$(i,`decodeParams`),$(a,`encodeParams`),$(o,`canActivate`),$(s,`canDeactivate`)}function Gt(e,t){if(e!=null&&(typeof e!=`object`||Array.isArray(e)))throw TypeError(`[router.updateRoute] ${t} must be an object or null, got ${y(e)}`)}function Kt(e){if(!d(e)||e===``)throw TypeError(`[router.buildPath] route must be a non-empty string, got ${typeof e==`string`?`""`:typeof e}`)}function qt(e){let t=new Set;return function(n,r){let i=o(r,e(n));if(i===void 0)return;let a=`${n} ${i}`;t.has(a)||(t.add(a),console.warn(`[router] Route "${n}" declares \`${i}\` 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 Jt(e){if(!d(e))throw TypeError(`[router.matchPath] path must be a string, got ${typeof e}`)}function Yt(e){if(!d(e))throw TypeError(`[router.shouldUpdateNode] nodeName must be a string, got ${typeof e}`)}function Xt(e,t,n,r,i){if(i&&t){let e=t;for(let t of i.split(`.`))if(e=e.children.get(t),!e)throw ReferenceError(`[router.addRoute] Parent route "${i}" does not exist`)}let a=new Set,o=new Map;for(let n of e)c(n,`addRoute`,t,i??``,a,o);n&&r&&Pt(e,r,n,i)}function Zt(e){let t=new Set;for(let n of e)for(let e of n.paramMeta.urlParams)t.add(e);return t}function Qt(e,t,n){let r=n.getSegmentsByName(e),i=n.getSegmentsByName(t),a=Zt(r),o=[];for(let e of i)for(let t of e.paramMeta.urlParams)o.push(t);let s=o.filter(e=>!a.has(e));if(s.length>0)throw Error(`[router.addRoute] forwardTo target "${t}" requires params [${s.join(`, `)}] that are not available in source route "${e}"`)}function $t(e,t,r){let i={...r.forwardMap,[e]:t};n(e,i)}function en(e,t,n,r,i){if(!n(e))throw ReferenceError(`[router.updateRoute] route "${e}" does not exist`);if(t!=null&&typeof t==`string`){if(!n(t))throw Error(`[router.updateRoute] forwardTo target "${t}" does not exist`);Qt(e,t,r),$t(e,t,i)}}function tn(e,t,n){if(!d(e))throw TypeError(`[router.makeState] Invalid name: ${y(e)}. Expected string.`);if(t!==void 0&&!m(t))throw TypeError(`[router.makeState] Invalid params: ${y(t)}. Expected plain object.`);if(n!==void 0&&!d(n))throw TypeError(`[router.makeState] Invalid path: ${y(n)}. Expected string.`)}function nn(){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 rn(){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 an(e,t){let n=qt(t=>e.getQueryParams(t));return{routes:{validateBuildPathArgs(e,t){Kt(e),n(e,t)},validateMatchPathArgs:Jt,validateIsActiveRouteArgs(e,t,r,i){Vt(e,t,r,i),n(e,t)},validateShouldUpdateNodeArgs:Yt,validateStateBuilderArgs:Ht,validateAddRouteArgs(e){zt(e)},validateRoutes(e,t,n){let r=t;Xt(e,r.tree,r.matcher,r.config?.forwardMap,n)},validateRemoveRouteArgs:Ft,validateUpdateRouteBasicArgs:Ut,validateUpdateRoutePropertyTypes(e,t){let n=t;Wt({forwardTo:n.forwardTo,defaultParams:n.defaultParams,defaultSearch:n.defaultSearch,decodeParams:n.decodeParams,encodeParams:n.encodeParams,canActivate:n.canActivate,canDeactivate:n.canDeactivate})},validateUpdateRoute(e,t,n){let r=n,i=t.forwardTo;en(e,i,e=>r.matcher.hasRoute(e),r.matcher,r.config)},validateParentOption(e,t){Bt(e);let n=t;for(let t of e.split(`.`)){let r=n.children.get(t);if(!r)throw ReferenceError(`[router.addRoute] Parent route "${e}" does not exist`);n=r}},validateRouteName(e,t){v(e,t)},throwIfInternalRoute(e,t){Y(e,t)},throwIfInternalRouteInArray(e,t){X(e,t)},validateSetRootPathArgs:It,guardRouteCallbacks:Lt,guardNoAsyncCallbacks:Rt},options:{validateOptions:st,validateResolvedDefaultRoute:V},dependencies:{validateDependencyName:Se,validateSetDependencyArgs(e,t,n){Ce(e)},validateDependenciesObject(t,n){we(t,n),Te(t,e.dependenciesGetStore(),n)},validateDependencyExists(e,t){let n=t.dependencies?.[e];Ee(n,e)},validateDependencyCount(t,n){De(t,n,e.logger)},validateCloneArgs:Oe,warnOverwrite(t,n){ke(t,n,e.logger)},warnBatchOverwrite(t,n){Ae(t,n,e.logger)},warnRemoveNonExistent(t){je(t,e.logger)}},plugins:{validatePluginLimit(e,t){ut(e,1,t?.maxPlugins)},validateNoDuplicatePlugins:dt,validatePluginKeys:pt,validateCountThresholds(t){ft(t,e.getOptions().limits?.maxPlugins??l.maxPlugins,e.logger)},warnBatchDuplicates(){mt(e.logger)},warnPluginMethodType(t){ht(t,e.logger)},warnPluginAfterStart(t){gt(t,e.logger)}},lifecycle:{validateHandler:Le,validateHandlerLimit(t,n){Re(t,n,e.getOptions().limits?.maxLifecycleHandlers??l.maxLifecycleHandlers)},validateCountThresholds(t,n){ze(t,n,e.getOptions().limits?.maxLifecycleHandlers??l.maxLifecycleHandlers,e.logger)},warnOverwrite(t,n,r){Be(t,n,r,e.logger)},warnAsyncGuardSync(t,n){Ve(t,n,e.logger)}},navigation:{validateNavigateArgs:We,validateNavigateToDefaultArgs(n){Ge(n),t.check(e.logger)},validateNavigateToStateArgs:Ke,validateNavigationOptions:qe,validateParams:Ye,validateParamsShape:T,validateSearch:Xe,validateStartArgs:Ze},state:{validateMakeStateArgs:tn,reportDroppedQueryKey:nn(),reportUndeclaredParamKey:rn(),validateAreStatesEqualArgs(e,t,n){if(!_(e))throw TypeError(`[router.areStatesEqual] Invalid state1: ${y(e)}. Expected State object.`);if(!_(t))throw TypeError(`[router.areStatesEqual] Invalid state2: ${y(t)}. Expected State object.`);if(n!==void 0&&!f(n))throw TypeError(`[router.areStatesEqual] Invalid ignoreQueryParams: ${y(n)}. Expected boolean.`)}},eventBus:{validateListenerArgs(e,t){Fe(e,t)},validateCountThresholds(t,n,r){let i=e.getOptions().limits?.maxListeners??l.maxListeners;Ie(t,n,r,e.logger,i)}}}}function on(){return t=>{let n=s(t);if(t.isActive())throw i(new e(`VALIDATION_PLUGIN_AFTER_START`,{message:`validation-plugin must be registered before router.start()`}));let a=new ye;a.watch(n.getAdoptedOrigins()),n.validator=an(n,a);try{let e=n.routeGetStore(),t=n.dependenciesGetStore(),r=n.getOptions();yt(e),bt(e),xt(e),St(e),Ct(t),Et(r,t),n.validator.options.validateOptions(r,`constructor (retrospective)`),typeof r.defaultRoute==`string`&&V(r.defaultRoute,e)}catch(e){throw n.validator=null,e}let o=r(t).addInterceptor(`start`,(e,t)=>{try{Dt(n.routeGetStore(),n.logger)}catch{}return e(t)});return{teardown(){o(),n.validator=null}}}}export{on as validationPlugin};
|
|
2
2
|
//# sourceMappingURL=index.mjs.map
|