@real-router/core 0.1.0 → 0.2.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/README.md +248 -363
- package/dist/cjs/index.d.ts +1 -1
- package/dist/cjs/index.js +1 -1
- package/dist/cjs/index.js.map +1 -1
- package/dist/cjs/metafile-cjs.json +1 -1
- package/dist/esm/index.d.mts +1 -1
- package/dist/esm/index.mjs +1 -1
- package/dist/esm/index.mjs.map +1 -1
- package/dist/esm/metafile-esm.json +1 -1
- package/package.json +3 -2
package/dist/cjs/index.d.ts
CHANGED
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
import { ErrorCodeKeys, ErrorCodeValues,
|
|
1
|
+
import { ErrorCodeKeys, ErrorCodeValues, ErrorCodeToValueMap, EventToNameMap, State, DefaultDependencies, Route, Options, Router } from 'core-types';
|
|
2
2
|
export { ActivationFn, ActivationFnFactory, CancelFn, Config, DefaultDependencies, DoneFn, Listener, Middleware, MiddlewareFactory, NavigationOptions, Options, Params, Plugin, PluginFactory, Route, Router, SimpleState, State, StateMeta, SubscribeFn, SubscribeState, Subscription, Unsubscribe } from 'core-types';
|
|
3
3
|
|
|
4
4
|
type ConstantsKeys = "UNKNOWN_ROUTE";
|
package/dist/cjs/index.js
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
var e=require("type-guards"),t=require("route-tree"),r=Symbol("real-router.routeTree"),n=Symbol("real-router.routeDefinitions"),o=Symbol("real-router.resolvedForwardMap"),a=Symbol("real-router.rootPath"),i=Symbol("real-router.config"),s=Object.freeze({ROUTER_NOT_STARTED:"NOT_STARTED",NO_START_PATH_OR_STATE:"NO_START_PATH_OR_STATE",ROUTER_ALREADY_STARTED:"ALREADY_STARTED",ROUTE_NOT_FOUND:"ROUTE_NOT_FOUND",SAME_STATES:"SAME_STATES",CANNOT_DEACTIVATE:"CANNOT_DEACTIVATE",CANNOT_ACTIVATE:"CANNOT_ACTIVATE",TRANSITION_ERR:"TRANSITION_ERR",TRANSITION_CANCELLED:"CANCELLED"}),c={UNKNOWN_ROUTE:"@@real-router/UNKNOWN_ROUTE"},u="onStart",d="onStop",f="onTransitionStart",l="onTransitionCancel",p="onTransitionSuccess",m="onTransitionError",h={ROUTER_START:"$start",ROUTER_STOP:"$stop",TRANSITION_START:"$$start",TRANSITION_CANCEL:"$$cancel",TRANSITION_SUCCESS:"$$success",TRANSITION_ERROR:"$$error"},w=new WeakSet;function v(e){if(null!==e&&"object"==typeof e&&!Object.isFrozen(e))if(Object.freeze(e),Array.isArray(e))for(const t of e)v(t);else for(const t in e)v(e[t])}function y(e){return e?(w.has(e)||(v(e),w.add(e)),e):e}function g(e){switch(e){case"never":return"never";case"always":return"always";default:return"default"}}function T(e){const t={trailingSlashMode:g(e.trailingSlash),queryParamsMode:e.queryParamsMode,urlParamsEncoding:e.urlParamsEncoding};return void 0!==e.queryParams&&(t.queryParams=e.queryParams),t}var S=new Set(Object.values(s)),E=new Set(["code","segment","path","redirect"]),R=new Set(["setCode","setErrorInstance","setAdditionalFields","hasField","getField","toJSON"]),b=class extends Error{segment;path;redirect;code;constructor(e,{message:t,segment:r,path:n,redirect:o,...a}={}){super(t??e),this.code=e,this.segment=r,this.path=n,this.redirect=o?function(e){if(!e)return e;if("object"!=typeof(t=e)||null===t||"string"!=typeof t.name||"string"!=typeof t.path||"object"!=typeof t.params||null===t.params)throw new TypeError("[deepFreezeState] Expected valid State object, got: "+typeof e);var t;const r=structuredClone(e),n=new WeakSet;return function e(t){if(null===t||"object"!=typeof t)return;if(n.has(t))return;n.add(t),Object.freeze(t);const r=Array.isArray(t)?t:Object.values(t);for(const t of r)e(t)}(r),r}(o):void 0;for(const[e,t]of Object.entries(a)){if(E.has(e))throw new TypeError(`[RouterError] Cannot set reserved property "${e}"`);R.has(e)||(this[e]=t)}}setCode(e){this.code=e,S.has(this.message)&&(this.message=e)}setErrorInstance(e){if(!e)throw new TypeError("[RouterError.setErrorInstance] err parameter is required and must be an Error instance");this.message=e.message,this.cause=e.cause,this.stack=e.stack??""}setAdditionalFields(e){for(const[t,r]of Object.entries(e)){if(E.has(t))throw new TypeError(`[RouterError.setAdditionalFields] Cannot set reserved property "${t}"`);R.has(t)||(this[t]=r)}}hasField(e){return e in this}getField(e){return this[e]}toJSON(){const e={code:this.code,message:this.message};void 0!==this.segment&&(e.segment=this.segment),void 0!==this.path&&(e.path=this.path),void 0!==this.redirect&&(e.redirect=this.redirect);const t=new Set(["code","message","segment","path","redirect","stack"]);for(const r in this)Object.hasOwn(this,r)&&!t.has(r)&&(e[r]=this[r]);return e}};function O(e,t){if("string"!=typeof t)throw new TypeError(`[router.${e}]: dependency name must be a string, got ${typeof t}`)}function N(e,t){const r=Object.keys(e).length;if(20===r)console.warn(`[router.${t}] 20 dependencies registered. Consider if all are necessary.`);else if(50===r)console.error(`[router.${t}] 50 dependencies registered! This indicates architectural problems. Hard limit at 100.`);else if(r>=100)throw new Error(`[router.${t}] Dependency limit exceeded (100). Current: ${r}. This is likely a bug in your code. If you genuinely need more dependencies, your architecture needs refactoring.`)}function A(e){return e.name?e.name:"anonymous"}function $(t,r){if("function"!=typeof t)throw new TypeError(`[router.useMiddleware] Middleware factory must return a function, got ${e.getTypeDescription(t)}. Factory: ${A(r)}`)}function I(t){const r=new Set,n=new Map;return t.useMiddleware=(...o)=>{!function(e,t){const r=e+t;if(r>50)throw new Error(`[router.useMiddleware] Middleware limit exceeded (50). Current: ${t}, Attempting to add: ${e}. This indicates an architectural problem. Consider consolidating middleware.`);r>=30?console.error(`[router.useMiddleware] ${r} middleware registered! This is excessive and will impact performance. Hard limit at 50.`):r>=15&&console.warn(`[router.useMiddleware] ${r} middleware registered. Consider if all are necessary.`)}(o.length,r.size),o.forEach((t,n)=>{if(function(t,r){if("function"!=typeof t)throw new TypeError(`[router.useMiddleware] Expected middleware factory function at index ${r}, got ${e.getTypeDescription(t)}`)}(t,n),r.has(t))throw new Error(`[router.useMiddleware] Middleware factory already registered. To re-register, first unsubscribe the existing middleware. Factory: ${A(t)}`)});const a=[];try{for(const e of o){const r=e(t,t.getDependency);$(r,e),a.push({factory:e,middleware:r})}}catch(e){throw console.error("[router.useMiddleware] Failed to initialize middleware, rolling back",e),e}for(const{factory:e,middleware:t}of a)r.add(e),n.set(e,t);return()=>{for(const{factory:e}of a)r.delete(e)||console.warn("[router.useMiddleware] Attempted to remove non-existent middleware factory. This might indicate a memory leak or incorrect cleanup logic."),n.delete(e)}},t.clearMiddleware=()=>(r.clear(),n.clear(),t),t.getMiddlewareFactories=()=>[...r],t.getMiddlewareFunctions=()=>[...n.values()],t}var P=(e,t)=>{if(t)return t.setCode(e),t},_=(e,t)=>{const r=e.meta,n=t.meta,o=r?.params,a=n?.params,i=o&&a?{...o,...a}:o??a??{},s={id:1,options:{},redirected:!1,...n,...r,params:i};return{...e,meta:s}},j=(t,r,n)=>{const o=n?{segment:n}:{};void 0!==t&&("boolean"!=typeof t?e.isState(t)?r(void 0,t):e.isPromise(t)?t.then(e=>{"boolean"==typeof e?e?r():r(new b(s.TRANSITION_ERR,o)):r(void 0,e)},e=>{let t=o;e instanceof Error?(t={...o,message:e.message,stack:e.stack},"cause"in e&&void 0!==e.cause&&(t.cause=e.cause)):e&&"object"==typeof e&&(t={...o,...e}),r(new b(s.TRANSITION_ERR,t))}):r(new b(s.TRANSITION_ERR,{...o,message:"Invalid lifecycle result type: "+typeof t})):t?r():r(new b(s.TRANSITION_ERR,o)))},D=new Set(["code","segment","path","redirect"]);function k(e,t){const r=t?{segment:t}:{};if(e instanceof Error)return{...r,message:e.message,stack:e.stack,..."cause"in e&&void 0!==e.cause&&{cause:e.cause}};if(e&&"object"==typeof e){const t={};for(const[r,n]of Object.entries(e))D.has(r)||(t[r]=n);return{...r,...t}}return r}function C(e,t,r){try{e(t,r)}catch(e){console.error("[core:lifecycle] Error in lifecycle callback:",e)}}var x=(t,r,n,o,a,i,c)=>{let u=r;const d=o.filter(e=>t.has(e));if(0===d.length)return void C(c,void 0,u);let f=0;const l=(e,t)=>{if(e)if(e.redirect){const t=new b(a,{message:"Guards cannot redirect. Use middleware for redirects.",attemptedRedirect:e.redirect});p(t)}else p(e);else p(void 0,t)},p=(r,o)=>{if(i())return void C(c,new b(s.TRANSITION_CANCELLED),u);if(r)return void C(c,P(a,r),u);if(o&&o!==u&&e.isState(o)){if(o.name!==u.name){const e=new b(a,{message:"Guards cannot redirect to different route. Use middleware.",attemptedRedirect:{name:o.name,params:o.params,path:o.path}});return void C(c,e,u)}(o.params!==u.params||o.path!==u.path)&&console.error("[core:transition] Warning: State mutated during transition",{from:u,to:o}),u=_(o,u)}if(f>=d.length)return void C(c,void 0,u);const p=d[f++],m=t.get(p);try{const e=m.call(null,u,n,l);j(e,l,p)}catch(e){l(new b(s.TRANSITION_ERR,k(e,p)))}};p()};function L(e,t,r){try{e(t,r)}catch(e){console.error("[real-router:middleware] Error in middleware callback:",e)}}var M=".";function U(e){const t=[];for(let r=e.length-1;r>=0;r--)t.push(e[r]);return t}function F(e,t){const r=t.meta?.params[e];if(!r||"object"!=typeof r)return{};const n={};for(const e in r){if(!Object.hasOwn(r,e))continue;if(void 0===r[e])continue;const o=t.params[e];null!=o&&("string"==typeof o||"number"==typeof o||"boolean"==typeof o?n[e]=String(o):console.warn(`[transitionPath.extractSegmentParams] Unsupported param type for key "${e}": ${typeof o}. Only primitives (string, number, boolean) are supported.`,typeof o))}return n}function W(e){if(!e)return[""];const t=e.indexOf(M);if(-1===t)return[e];const r=e.indexOf(M,t+1);if(-1===r)return[e.slice(0,t),e];const n=e.indexOf(M,r+1);return-1===n?[e.slice(0,t),e.slice(0,r),e]:-1===e.indexOf(M,n+1)?[e.slice(0,t),e.slice(0,r),e.slice(0,n),e]:function(e){const t=e.split(M),r=t.length,n=[t[0]];let o=t[0].length;for(let a=1;a<r-1;a++)o+=1+t[a].length,n.push(e.slice(0,o));return n.push(e),n}(e)}function q(t,r){if(e.validateState(t,"getTransitionPath"),!r)return{intersection:"",toActivate:W(t.name),toDeactivate:[]};if(e.validateState(r,"getTransitionPath"),(t.meta?.options??{}).reload)return{intersection:"",toActivate:W(t.name),toDeactivate:U(W(r.name))};const n=void 0!==t.meta?.params,o=void 0!==r.meta?.params;if(!n&&!o)return{intersection:"",toActivate:W(t.name),toDeactivate:U(W(r.name))};if(t.name===r.name&&n&&o){const e=t.meta&&0===Object.keys(t.meta.params).length,n=r.meta&&0===Object.keys(r.meta.params).length;if(e&&n)return{intersection:t.name,toActivate:[],toDeactivate:[]}}const a=W(t.name),i=W(r.name),s=function(e,t,r,n,o){for(let a=0;a<o;a++){const o=r[a],i=n[a];if(o!==i)return a;const s=F(o,e),c=F(i,t),u=Object.keys(s),d=Object.keys(c);if(u.length!==d.length)return a;for(const e of u)if(s[e]!==c[e])return a}return o}(t,r,a,i,Math.min(i.length,a.length)),c=[];for(let e=i.length-1;e>=s;e--)c.push(i[e]);const u=a.slice(s);return{intersection:r&&s>0?i[s-1]:"",toDeactivate:c,toActivate:u}}function z(t,r,n,o,a){let i=!1,u=!1;const[d,f]=t.getLifecycleFunctions(),l=t.getMiddlewareFunctions(),p=r.name===c.UNKNOWN_ROUTE,m=()=>i||!t.isActive(),h=(e,t)=>{u||(u=!0,a(e,t??r))};return(()=>{const{toDeactivate:a,toActivate:i}=q(r,n),c=!p&&i.length>0,u=l.length>0;var w;w=(o,a)=>{o?h(o,a):((e,t)=>{c?x(f,e,n,i,s.CANNOT_ACTIVATE,m,(e,r)=>{t(e,r)}):t(void 0,e)})(a,(o,a)=>{o?h(o,a):((t,r)=>{u?((t,r,n,o,a)=>{let i=r,c=0;const u=(e,t)=>{e?d(e):d(void 0,t)},d=(r,d)=>{if(o())return void L(a,new b(s.TRANSITION_CANCELLED),i);if(r)return void L(a,P(s.TRANSITION_ERR,r),i);if(d&&d!==i&&e.isState(d)&&((d.name!==i.name||d.params!==i.params||d.path!==i.path)&&console.error("[real-router:middleware] Warning: State mutated during middleware execution",{from:i,to:d}),i=_(d,i)),c>=t.length)return void L(a,void 0,i);const f=t[c++];try{const e=f.call(null,i,n,u);j(e,u)}catch(e){u(new b(s.TRANSITION_ERR,k(e)))}};d()})(l,t,n,m,(e,t)=>{r(e,t)}):r(void 0,t)})(a,(e,o)=>{if(e)h(e,o);else{if(n){const e=W(r.name),o=W(n.name),a=new Set(e);for(const e of o)!a.has(e)&&d.has(e)&&t.clearCanDeactivate(e)}h(void 0,o)}})})},n&&!o.forceDeactivate&&a.length>0?x(d,r,n,a,s.CANNOT_DEACTIVATE,m,w):w(void 0,r)})(),()=>{i||u||(i=!0,h(new b(s.TRANSITION_CANCELLED)))}}var B=()=>{};function K(e,...t){try{e(...t)}catch(e){console.error("[router.navigate] Error in navigation callback:",e)}}function V(t){let r=null,n=!1;return t.navigate=function(r,n,o,a){const{params:i,opts:c,callback:u}=function(e,t,r){if("function"==typeof e)return{params:{},opts:{},callback:e};const n=e??{};return"function"==typeof t?{params:n,opts:{},callback:t}:{params:n,opts:t??{},callback:r??B}}(n,o,a);if(!t.isStarted())return K(u,new b(s.ROUTER_NOT_STARTED)),B;if(!e.isNavigationOptions(c))throw new TypeError(`[router.navigate] Invalid options: ${e.getTypeDescription(c)}. Expected NavigationOptions object.`);const d=t.buildStateWithSegments(r,i);if(!d){const e=new b(s.ROUTE_NOT_FOUND);return K(u,e),t.invokeEventListeners(h.TRANSITION_ERROR,void 0,t.getState(),e),B}const{state:f,segments:l}=d,p=t.makeState(f.name,f.params,t.buildPathWithSegments(f.name,f.params,l),{params:f.meta,options:c,redirected:c.redirected??!1});if(c.skipTransition)return K(u,void 0,p),B;const m=t.getState();if(!c.reload&&!c.force&&t.areStatesEqual(m,p,!1)){const e=new b(s.SAME_STATES);return K(u,e),t.invokeEventListeners(h.TRANSITION_ERROR,p,m,e),B}return t.navigateToState(p,m,c,u,!0)},t.navigateToDefault=function(r,n){const o=t.getOptions();if(!o.defaultRoute)return B;let a={},i=B;if("function"==typeof r?i=r:r&&(a=r,i=n??B),!e.isNavigationOptions(a))throw new TypeError(`[router.navigateToDefault] Invalid options: ${e.getTypeDescription(a)}. Expected NavigationOptions object.`);return t.navigate(o.defaultRoute,o.defaultParams,a,i)},t.navigateToState=(e,o,a,i,u)=>(n&&console.warn("[router.navigate] Concurrent navigation detected on shared router instance. For SSR, use router.clone() to create isolated instance per request."),r&&(r(),r=null),n=!1,n=!0,t.invokeEventListeners(h.TRANSITION_START,e,o),r=z(t,e,o,a,(d,f)=>{if(n=!1,r=null,d)d.code===s.TRANSITION_CANCELLED?t.invokeEventListeners(h.TRANSITION_CANCEL,e,o):t.invokeEventListeners(h.TRANSITION_ERROR,e,o,d),K(i,d);else if(f.name===c.UNKNOWN_ROUTE||t.hasRoute(f.name))t.setState(f),u&&t.invokeEventListeners(h.TRANSITION_SUCCESS,f,o,a),K(i,void 0,f);else{const e=new b(s.ROUTE_NOT_FOUND,{routeName:f.name});K(i,e),t.invokeEventListeners(h.TRANSITION_ERROR,void 0,t.getState(),e)}}),r),t.isNavigating=()=>t.isStarted()&&n,t}function H(e,t,...r){if(0===t.size)return;const n=[...t];for(const t of n)try{Function.prototype.apply.call(t,void 0,r)}catch(t){console.error(`[Router] Error in listener for ${e}:`,t)}}function G(t){const r={};function n(e){const t=r[e];if(t)return t;const n=new Set;return r[e]=n,n}let o=null;const a=()=>(o??={[h.ROUTER_START]:0,[h.TRANSITION_START]:0,[h.TRANSITION_SUCCESS]:0,[h.TRANSITION_ERROR]:0,[h.TRANSITION_CANCEL]:0,[h.ROUTER_STOP]:0},o),i=new Set([h.ROUTER_START,h.TRANSITION_START,h.TRANSITION_SUCCESS,h.TRANSITION_ERROR,h.TRANSITION_CANCEL,h.ROUTER_STOP]),s=(e,t)=>{if(!i.has(e))throw new Error(`Invalid event name: ${e}`);if("function"!=typeof t)throw new TypeError(`Expected callback to be a function for event ${e}`)};t.invokeEventListeners=(t,r,o,s)=>{(e=>{if(!i.has(e))throw new Error(`Invalid event name: ${e}`);if(a()[e]>=5)throw new Error(`[Router] Maximum recursion depth (5) exceeded for event: ${e}`)})(t);const c=a();try{switch(c[t]++,t){case h.TRANSITION_START:case h.TRANSITION_CANCEL:if(!r)throw new TypeError(`[router.invokeEventListeners] toState is required for event "${t}"`);if(!e.isState(r))throw new TypeError(`[router.invokeEventListeners] toState is invalid for event "${t}". Expected State object with name, path, and params.`);if(o&&!e.isState(o))throw new TypeError(`[router.invokeEventListeners] fromState is invalid for event "${t}". Expected State object with name, path, and params.`);H(t,n(t),r,o);break;case h.TRANSITION_ERROR:if(r&&!e.isState(r))throw new TypeError(`[router.invokeEventListeners] toState is invalid for event "${t}". Expected State object with name, path, and params.`);if(o&&!e.isState(o))throw new TypeError(`[router.invokeEventListeners] fromState is invalid for event "${t}". Expected State object with name, path, and params.`);if(!s)throw new TypeError(`[router.invokeEventListeners] error is required for event "${t}"`);if(!(s instanceof b))throw new TypeError(`[router.invokeEventListeners] error must be a RouterError instance for event "${t}". Got: ${"object"==typeof s?s.constructor.name:typeof s}`);H(t,n(t),r,o,s);break;case h.TRANSITION_SUCCESS:if(!r)throw new TypeError(`[router.invokeEventListeners] toState is required for event "${t}"`);if(!e.isState(r))throw new TypeError(`[router.invokeEventListeners] toState is invalid for event "${t}". Expected State object with name, path, and params.`);if(o&&!e.isState(o))throw new TypeError(`[router.invokeEventListeners] fromState is invalid for event "${t}". Expected State object with name, path, and params.`);if(!s)throw new TypeError(`[router.invokeEventListeners] options is required for event "${t}"`);if(s instanceof b)throw new TypeError(`[router.invokeEventListeners] options cannot be a RouterError for event "${t}". Use TRANSITION_ERROR event for errors.`);if(!e.isNavigationOptions(s))throw new TypeError(`[router.invokeEventListeners] options is invalid for event "${t}". Expected NavigationOptions object.`);H(t,n(t),r,o,s);break;default:H(t,n(t))}}finally{c[t]--}},t.hasListeners=e=>{if(!i.has(e))return!1;const t=r[e];return void 0!==t&&t.size>0},t.removeEventListener=(e,t)=>{s(e,t);const n=r[e];n&&0!==n.size&&(n.delete(t)||console.warn(`[Router] Attempted to remove non-existent listener for "${e}". This might indicate a memory leak or incorrect cleanup logic.`))},t.addEventListener=(e,r)=>{s(e,r);const o=n(e);if(o.has(r))throw new Error(`[router.addEventListener] Listener already exists for event "${e}". Each listener function can only be registered once per event. Store the returned unsubscribe function to remove the listener.`);if(1e3===o.size&&console.warn(`[router.addEventListener] Warning: Event "${e}" has ${o.size} listeners. This might indicate a memory leak.`),o.size>=1e4)throw new Error(`[router.addEventListener] Maximum listener limit (10000) reached for event "${e}". This is a critical memory leak. The application is creating listeners exponentially. Check for loops or recursive calls that register listeners.`);return o.add(r),()=>{t.removeEventListener(e,r)}},t.subscribe=function(e){if("function"!=typeof e)throw new TypeError("[router.subscribe] Expected a function. For Observable pattern use router[Symbol.observable]().subscribe(observer)");return t.addEventListener(h.TRANSITION_SUCCESS,(t,r)=>{e({route:t,previousRoute:r})})};const c="function"==typeof Symbol&&Symbol.observable||"@@observable",u=new WeakMap;return t[c]=function(){return{subscribe(e,r={}){const n="function"==typeof e?{next:e}:e,o=u.get(n);if(o?.active)return console.warn("[router.observable] Duplicate subscription prevented. Same observer already subscribed."),{unsubscribe:o.unsubscribe,get closed(){return!o.active}};const{signal:a,replay:i=!0}=r;if(a?.aborted)return{unsubscribe:()=>{},closed:!0};let s=!1;const c=e=>{if(!s&&n.next)try{n.next(e)}catch(e){if(console.error("[router.observable] Error in observer.next:",e),n.error)try{n.error(e)}catch(e){console.error("[router.observable] Error in observer.error:",e)}}},d=t.addEventListener(h.TRANSITION_SUCCESS,(e,t)=>{c({route:e,previousRoute:t})}),f={unsubscribe:()=>{if(!s&&(s=!0,f.active=!1,d(),n.complete))try{n.complete()}catch(e){console.error("[router.observable] Error in observer.complete:",e)}},active:!0};if(u.set(n,f),a&&a.addEventListener("abort",()=>{f.unsubscribe()},{once:!0}),i){const e=t.getState();e&&queueMicrotask(()=>{c({route:e,previousRoute:void 0})})}return{unsubscribe:f.unsubscribe,get closed(){return s}}},[c](){return this}}},t}var Y={defaultRoute:"",defaultParams:{},trailingSlash:"preserve",queryParamsMode:"loose",queryParams:{arrayFormat:"none",booleanFormat:"none",nullFormat:"default"},caseSensitive:!1,urlParamsEncoding:"default",allowNotFound:!0,rewritePathOnMatch:!0},J={trailingSlash:["strict","never","always","preserve"],queryParamsMode:["default","strict","loose"],urlParamsEncoding:["default","uri","uriComponent","none"]},Q={arrayFormat:["none","brackets","index","comma"],booleanFormat:["none","string","empty-true"],nullFormat:["default","hidden"]};function Z(t,r,n,o){if(n&&"object"==typeof n)return function(t,r,n){if(!t||"object"!=typeof t||t.constructor!==Object)throw new TypeError(`[router.${n}] Invalid type for "${r}": expected plain object, got ${e.getTypeDescription(t)}`);for(const e in t)if(Object.getOwnPropertyDescriptor(t,e)?.get)throw new TypeError(`[router.${n}] Getters not allowed in "${r}": "${e}"`)}(r,t,o),void("queryParams"===t&&function(t,r){for(const n in t){if(!e.isObjKey(n,Q)){const e=Object.keys(Q).map(e=>`"${e}"`).join(", ");throw new TypeError(`[router.${r}] Unknown queryParams key: "${n}". Valid keys: ${e}`)}const o=t[n],a=Q[n];if(!a.includes(o)){const e=a.map(e=>`"${e}"`).join(", ");throw new TypeError(`[router.${r}] Invalid value for queryParams.${n}: expected one of ${e}, got "${String(o)}"`)}}}(r,o));if(typeof r!=typeof n)throw new TypeError(`[router.${o}] Invalid type for "${t}": expected ${typeof n}, got ${typeof r}`);t in J&&function(e,t,r){const n=J[e];if(!n.includes(t)){const o=n.map(e=>`"${e}"`).join(", ");throw new TypeError(`[router.${r}] Invalid value for "${e}": expected one of ${o}, got "${String(t)}"`)}}(t,r,o)}function X(e){Object.freeze(e);for(const t of Object.keys(e)){const r=e[t];r&&"object"==typeof r&&r.constructor===Object&&X(r)}return e}var ee="router.usePlugin",te={[u]:h.ROUTER_START,[d]:h.ROUTER_STOP,[p]:h.TRANSITION_SUCCESS,[f]:h.TRANSITION_START,[m]:h.TRANSITION_ERROR,[l]:h.TRANSITION_CANCEL},re=Object.keys(te).filter(t=>e.isObjKey(t,te));function ne(t){const r=new Set;function n(r){const n=r(t,t.getDependency);(t=>{if(!t||"object"!=typeof t||Array.isArray(t))throw new TypeError(`[router.usePlugin] Plugin factory must return an object, got ${e.getTypeDescription(t)}`);if("function"==typeof t.then)throw new TypeError("[router.usePlugin] Async plugin factories are not supported. Factory returned a Promise instead of a plugin object.");for(const r in t)if("teardown"!==r&&!e.isObjKey(r,te))throw new TypeError(`[router.usePlugin] Unknown property '${r}'. Plugin must only contain event handlers and optional teardown.`)})(n),Object.freeze(n);const o=[];for(const e of re)e in n&&("function"==typeof n[e]?(o.push(t.addEventListener(te[e],n[e])),e===u&&t.isStarted()&&console.warn(`[${ee}] Router already started, onStart will not be called`)):console.warn(`[${ee}] Property '${e}' is not a function, skipping`));return()=>{o.forEach(e=>{e()}),"function"==typeof n.teardown&&n.teardown()}}return t.getPlugins=()=>[...r],t.usePlugin=(...e)=>{((e,t)=>{const r=e+t;if(r>50)throw new Error("[router.usePlugin] Plugin limit exceeded (50)");r>=25?console.error(`[${ee}] ${r} plugins registered!`):r>=10&&console.warn(`[${ee}] ${r} plugins registered`)})(e.length,r.size);const t=function(e,t){const r=new Set;for(const n of e){if("function"!=typeof n)throw new TypeError("[router.usePlugin] Expected plugin factory function, got "+typeof n);if(t.has(n))throw new Error("[router.usePlugin] Plugin factory already registered. To re-register, first unsubscribe the existing plugin.");r.has(n)?console.warn(`[${ee}] Duplicate factory in batch, will be registered once`):r.add(n)}return r}(e,r),o=[];try{for(const e of t){const t=n(e);o.push({factory:e,cleanup:t})}}catch(e){for(const{cleanup:e}of o)try{e()}catch(e){console.error(`[${ee}] Cleanup error:`,e)}throw e}for(const{factory:e}of o)r.add(e);let a=!1;return()=>{if(!a){a=!0;for(const{factory:e}of o)r.delete(e);for(const{cleanup:e}of o)try{e()}catch(e){console.error(`[${ee}] Error during cleanup:`,e)}}}},t}function oe(t,r){if(!e.isBoolean(t)&&"function"!=typeof t)throw new TypeError(`[router.${r}] Handler must be a boolean or factory function, got ${e.getTypeDescription(t)}`)}function ae(t){const r=new Map,n=new Map,o=new Map,a=new Map,i=new Set;function s(r,n,o,a,s,c){if(i.has(n))throw new Error(`[router.${c}] Cannot modify route "${n}" during its own registration`);a.has(n)?console.warn(`[router.${c}] Overwriting existing ${r} handler for route "${n}"`):function(e,t){if(e>=200)throw new Error(`[router.${t}] Lifecycle handler limit exceeded (200). This indicates too many routes with individual handlers. Consider using middleware for cross-cutting concerns.`);e>=100?console.error(`[router.${t}] ${e} lifecycle handlers registered! This is excessive. Hard limit at 200.`):e>=50&&console.warn(`[router.${t}] ${e} lifecycle handlers registered. Consider consolidating logic.`)}(a.size+1,c);const u=e.isBoolean(o)?function(e){const t=()=>e;return()=>t}(o):o;a.set(n,u),i.add(n);try{const r=u(t,t.getDependency);if("function"!=typeof r)throw new TypeError(`[router.${c}] Factory must return a function, got ${e.getTypeDescription(r)}`);s.set(n,r)}catch(e){throw a.delete(n),e}finally{i.delete(n)}}return t.getLifecycleFactories=()=>{const e={},t={};for(const[t,n]of r)e[t]=n;for(const[e,r]of n)t[e]=r;return[e,t]},t.getLifecycleFunctions=()=>[o,a],t.canActivate=(r,o)=>(e.validateRouteName(r,"canActivate"),oe(o,"canActivate"),s("activate",r,o,n,a,"canActivate"),t),t.canDeactivate=(n,a)=>(e.validateRouteName(n,"canDeactivate"),oe(a,"canDeactivate"),s("deactivate",n,a,r,o,"canDeactivate"),t),t.clearCanDeactivate=(n,a=!1)=>{if(e.validateRouteName(n,"clearCanDeactivate"),i.has(n))throw new Error(`[router.clearCanDeactivate] Cannot modify route "${n}" during its own registration`);const s=r.delete(n),c=o.delete(n);return a||s||c||console.warn(`[router.clearCanDeactivate] No canDeactivate handler found for route "${n}"`),t},t.clearCanActivate=(r,o=!1)=>{if(e.validateRouteName(r,"clearCanActivate"),i.has(r))throw new Error(`[router.clearCanActivate] Cannot modify route "${r}" during its own registration`);const s=n.delete(r),c=a.delete(r);return o||s||c||console.warn(`[router.clearCanActivate] No canActivate handler found for route "${r}"`),t},t}function ie(e){return e[r]}function se(e,t){e[r]=t}function ce(e){return e[o]}function ue(e,t){e[o]=t}function de(e){return e[i]}function fe(e,r){const n=r??function(e){let t="";for(const r of e)r.name&&(t&&(t+="."),t+=r.name);return t}(e.segments);return{name:n,params:e.params,meta:t.getMetaFromSegments(e.segments)}}var le=Symbol("real-router.buildOptionsCache");function pe(r){return r.buildPath=(n,o)=>{if(!e.isString(n)||""===n)throw new TypeError("[real-router] buildPath: route must be a non-empty string, got "+("string"==typeof n?'""':typeof n));if(n===c.UNKNOWN_ROUTE)return e.isString(o?.path)?o.path:"";const a=de(r),i=Object.hasOwn(a.defaultParams,n)?{...a.defaultParams[n],...o}:o??{},s="function"==typeof a.encoders[n]?a.encoders[n]({...i}):i,u=r[le]??T(r.getOptions());return t.buildPath(ie(r),n,s,u)},r.buildPathWithSegments=(n,o,a)=>{if(!e.isString(n)||""===n)throw new TypeError("[real-router] buildPathWithSegments: route must be a non-empty string, got "+("string"==typeof n?'""':typeof n));if(n===c.UNKNOWN_ROUTE)return e.isString(o.path)?o.path:"";const i=de(r),s=Object.hasOwn(i.defaultParams,n)?{...i.defaultParams[n],...o}:o,u="function"==typeof i.encoders[n]?i.encoders[n]({...s}):s,d=r[le]??T(r.getOptions());return t.buildPath(ie(r),n,u,d,a)},r.matchPath=(n,o)=>{if(!e.isString(n))throw new TypeError("[real-router] matchPath: path must be a string, got "+typeof n);const a=r.getOptions(),i=function(e){return{...T(e),caseSensitive:e.caseSensitive,strictTrailingSlash:"strict"===e.trailingSlash,strongMatching:!1}}(a),s=t.matchSegments(ie(r),n,i);if(s){const e=fe(s),{name:t,params:i,meta:c}=e,{decoders:u}=de(r),d="function"==typeof u[t]?u[t](i):i,{name:f,params:l}=r.forwardState(t,d),p=a.rewritePathOnMatch?r.buildPath(f,l):n;return r.makeState(f,l,p,{params:c,options:{},source:o,redirected:!1})}},r.setRootPath=e=>{const o=r;o[a]=e,se(r,t.createRouteTree("",e,o[n],{skipValidation:!0}))},r.getRootPath=()=>r[a]||"",r}var me=()=>{},he=new b(s.NO_START_PATH_OR_STATE),we=new b(s.ROUTER_ALREADY_STARTED),ve=Symbol("started"),ye=Symbol("active");function ge(t){t[ve]=!1,t[ye]=!1;const r=()=>{t[ye]=!1};return t.isStarted=()=>!!t[ve],t.isActive=()=>!!t[ye],t.start=(...n)=>{const o=t.getOptions(),[a,i]=(e=>{if(e.length>2)throw new Error("Invalid number of arguments");const[t,r]=e;return t?"function"==typeof t?[void 0,t]:[t,r??me]:[void 0,me]})(n);let c=!1;if(t.isStarted()||t.isActive())return c=!0,i(we),t;if(!a&&!o.defaultRoute)return c=!0,t.hasListeners(h.TRANSITION_ERROR)&&t.invokeEventListeners(h.TRANSITION_ERROR,void 0,void 0,he),i(he),t;t[ye]=!0;const u=(e,r={})=>{t.navigateToState(e,void 0,r,(e,t)=>{f(e,t)},!1)},d={replace:!0},f=(e,n,o=!1)=>{e?(r(),o&&t.hasListeners(h.TRANSITION_ERROR)&&t.invokeEventListeners(h.TRANSITION_ERROR,void 0,void 0,e)):(t[ve]=!0,t.invokeEventListeners(h.ROUTER_START),t.invokeEventListeners(h.TRANSITION_SUCCESS,n,void 0,{replace:!0})),((e,t)=>{c?console.warn("[real-router] Callback already invoked"):(c=!0,i(e,t))})(e,n)},l=a??o.defaultRoute,p=((t,r)=>{if("string"==typeof t)return r.matchPath(t);if(e.isState(t)){try{r.buildPath(t.name,t.params)}catch{return}return t}})(l,t),m="string"==typeof l?l:"";return(void 0!==p||o.allowNotFound||o.defaultRoute&&!a)&&function(e,t){delete e[le],e[le]=T(t)}(t,o),p?u(p,d):o.defaultRoute&&!a?((e,r,n)=>{const o=t.buildState(e,r);if(!o)return void f(new b(s.ROUTE_NOT_FOUND,{routeName:e}),void 0,!0);const a=t.makeState(o.name,o.params,t.buildPath(o.name,o.params),{params:o.meta,options:n,redirected:!1});u(a,n)})(o.defaultRoute,o.defaultParams,d):o.allowNotFound?u(t.makeNotFoundState(m,d),d):f(new b(s.ROUTE_NOT_FOUND,{path:m}),void 0,!0),t},t.stop=()=>(r(),t.isStarted()&&(t[ve]=!1,t.setState(void 0),t.invokeEventListeners(h.ROUTER_STOP)),t),t}function Te(t,r){if(void 0!==t.canActivate&&"function"!=typeof t.canActivate)throw new TypeError(`[router.addRoute] canActivate must be a function for route "${r}", got ${e.getTypeDescription(t.canActivate)}`);if(void 0!==t.defaultParams){const n=t.defaultParams;if(null===n||"object"!=typeof n||Array.isArray(n))throw new TypeError(`[router.addRoute] defaultParams must be an object for route "${r}", got ${e.getTypeDescription(t.defaultParams)}`)}if(t.children)for(const e of t.children)Te(e,`${r}.${e.name}`)}function Se(e){const t=new Set;for(const r of e){const e=r.parser;for(const r of e.urlParams)t.add(r);for(const r of e.spatParams)t.add(r)}return t}function Ee(e){const t=new Set,r=/[*:]([A-Z_a-z]\w*)/g;let n;for(;null!==(n=r.exec(e));)t.add(n[1]);return t}function Re(e,t,r="",n=[]){for(const o of e){const e=r?`${r}.${o.name}`:o.name,a=[...n,o.path];if(e===t)return a;if(o.children&&t.startsWith(`${e}.`))return Re(o.children,t,e,a)}}function be(e){const t=new Set;for(const r of e)for(const e of Ee(r))t.add(e);return t}function Oe(e,t=""){const r=new Set;for(const n of e){const e=t?`${t}.${n.name}`:n.name;if(r.add(e),n.children)for(const t of Oe(n.children,e))r.add(t)}return r}function Ne(e,t=""){const r=new Map;for(const n of e){const e=t?`${t}.${n.name}`:n.name;if(n.forwardTo&&r.set(e,n.forwardTo),n.children)for(const[t,o]of Ne(n.children,e))r.set(t,o)}return r}function Ae(e,r,n,o,a){const i=function(e,t){const r=t.split(".");let n=e;for(const e of r)if(n=n.childrenByName.get(e),!n)return!1;return!0}(a,r),s=o.has(r);if(!i&&!s)throw new Error(`[router.addRoute] forwardTo target "${r}" does not exist for route "${e}"`);const c=be(Re(n,e)),u=function(e,r,n,o){return r?Se(t.getSegmentsByName(n,e)):be(Re(o,e))}(r,i,a,n),d=[...u].filter(e=>!c.has(e));if(d.length>0)throw new Error(`[router.addRoute] forwardTo target "${r}" requires params [${d.join(", ")}] that are not available in source route "${e}"`)}function $e(e,t,r){const n=Oe(e),o=Ne(e),a={...t};for(const[e,t]of o)a[e]=t;for(const[t,a]of o)Ae(t,a,e,n,r);for(const e of Object.keys(a))Pe(e,a)}function Ie(e,t){e.canActivate&&t.canActivate(e.name,e.canActivate)}function Pe(e,t,r=100){const n=new Set,o=[e];let a=e;for(;t[a];){const e=t[a];if(n.has(e)){const t=o.indexOf(e),r=[...o.slice(t),e];throw new Error(`Circular forwardTo: ${r.join(" → ")}`)}if(n.add(a),o.push(e),a=e,o.length>r)throw new Error(`forwardTo chain exceeds maximum depth (${r}): ${o.join(" → ")}`)}return a}function _e(e){const{forwardMap:t}=de(e),r={};for(const e of Object.keys(t))r[e]=Pe(e,t);ue(e,r)}function je(e,t){e.forwardTo&&(e.canActivate&&console.warn(`[real-router] Route "${e.name}" has both forwardTo and canActivate. canActivate will be ignored because forwardTo creates a redirect (industry standard). Move canActivate to the target route "${e.forwardTo}".`),de(t).forwardMap[e.name]=e.forwardTo)}function De(e,t){const r=de(t);e.decodeParams&&(r.decoders[e.name]=t=>e.decodeParams?.(t)??t),e.encodeParams&&(r.encoders[e.name]=t=>e.encodeParams?.(t)??t)}function ke(e,t){e.defaultParams&&(de(t).defaultParams[e.name]=e.defaultParams)}function Ce(e,t,r=""){for(const n of e){const e=r?`${r}.${n.name}`:n.name,o={...n,name:e};Ie(o,t),je(o,t),De(o,t),ke(o,t),n.children&&Ce(n.children,t,e)}}function xe(e,t){for(const r of Object.keys(e))t(r)&&delete e[r]}function Le(e){const t={name:e.name,path:e.path};return e.children&&(t.children=e.children.map(e=>Le(e))),t}function Me(e,t,r=""){for(let n=0;n<e.length;n++){const o=e[n],a=r?`${r}.${o.name}`:o.name;if(a===t)return e.splice(n,1),!0;if(o.children&&t.startsWith(`${a}.`)&&Me(o.children,t,a))return!0}return!1}function Ue(e,t,r){void 0!==r&&(null===r?delete e[t]:e[t]=r)}var Fe=new Set;function We(r){return r.isActiveRoute=(t,n={},o=!1,a=!0)=>{if(Fe.has(t)||(e.validateRouteName(t,"isActiveRoute"),Fe.add(t)),function(t){if(!e.isParams(t))throw new TypeError(`[router.isActiveRoute] Invalid params structure: ${e.getTypeDescription(t)}`)}(n),void 0!==o&&"boolean"!=typeof o)throw new TypeError("[router.isActiveRoute] strictEquality must be a boolean, got "+typeof o);if(void 0!==a&&"boolean"!=typeof a)throw new TypeError("[router.isActiveRoute] ignoreQueryParams must be a boolean, got "+typeof a);if(""===t)return console.warn('[real-router] isActiveRoute("") called with empty string. The root node is not considered active for any named route. To check if router has active state, use: router.getState() !== undefined'),!1;const i=r.getState();if(!i)return!1;const s=i.name;if(s!==t&&!s.startsWith(`${t}.`)&&!t.startsWith(`${s}.`))return!1;const c=de(r).defaultParams[t];if(o||s===t){const e=c?{...c,...n}:n;return r.areStatesEqual({name:t,params:e,path:""},i,a)}const u=i.params;return!!function(e,t){for(const r in e)if(e[r]!==t[r])return!1;return!0}(n,u)&&(!c||function(e,t,r){for(const n in e)if(!(n in r)&&e[n]!==t[n])return!1;return!0}(c,u,n))},r.shouldUpdateNode=t=>{if(!e.isString(t))throw new TypeError("[router.shouldUpdateNode] nodeName must be a string, got "+typeof t);return(e,r)=>{if(!e||"object"!=typeof e||!("name"in e))throw new TypeError("[router.shouldUpdateNode] toState must be valid State object");if(e.meta?.options.reload)return!0;if(""===t&&!r)return!0;const{intersection:n,toActivate:o,toDeactivate:a}=q(e,r);return t===n||!!o.includes(t)||a.includes(t)}},r.clone=(e={})=>{const n=ie(r),o=He(t.routeTreeToDefinitions(n),r.getOptions(),e);o.useMiddleware(...r.getMiddlewareFactories()),o.usePlugin(...r.getPlugins());const a=de(r);!function(e,t){e[i]=t}(o,{decoders:{...a.decoders},encoders:{...a.encoders},defaultParams:structuredClone(a.defaultParams),forwardMap:{...a.forwardMap}}),ue(o,{...ce(r)});const[s,c]=r.getLifecycleFactories();for(const e of Object.keys(s))o.canDeactivate(e,s[e]);for(const e of Object.keys(c))o.canActivate(e,c[e]);return o},r}function qe(e){return null===e?"null":Array.isArray(e)?"array":typeof e}function ze(e,t){if(null!=e){if("function"!=typeof e)throw new TypeError(`[real-router] updateRoute: ${t} must be a function or null, got ${typeof e}`);if("AsyncFunction"===e.constructor.name)throw new TypeError(`[real-router] updateRoute: ${t} cannot be an async function`)}}function Be(r){return o=>{const i=function(e){return t=>{const r=e=>e===t||e.startsWith(`${t}.`),n=de(e);xe(n.decoders,r),xe(n.encoders,r),xe(n.defaultParams,r),xe(n.forwardMap,r),xe(n.forwardMap,e=>r(n.forwardMap[e]));const[o,a]=e.getLifecycleFactories();for(const t of Object.keys(a))r(t)&&e.clearCanActivate(t,!0);for(const t of Object.keys(o))r(t)&&e.clearCanDeactivate(t,!0)}}(o),s=(c=de(o).forwardMap,(e,r,n,o)=>{const a=t.getSegmentsByName(o,r);if(!a)throw new Error(`[real-router] updateRoute: forwardTo target "${r}" does not exist`);const i=Se(n),s=[...Se(a)].filter(e=>!i.has(e));if(s.length>0)throw new Error(`[real-router] updateRoute: forwardTo target "${r}" requires params [${s.join(", ")}] that are not available in source route "${e}"`);c[e]=r});var c;o.forward=(e,r)=>{console.warn("[router.forward] Method is deprecated. Use `forwardTo` property in route configuration instead.");const n=ie(o),a=t.getSegmentsByName(n,e);if(!a)throw new Error(`[real-router] forward: source route "${e}" does not exist`);const i=t.getSegmentsByName(n,r);if(!i)throw new Error(`[real-router] forward: target route "${r}" does not exist`);const s=Se(a),c=Se(i),u=[];for(const e of c)s.has(e)||u.push(e);if(u.length>0)throw new Error(`[real-router] forward: target route "${r}" requires params [${u.join(", ")}] that are not available in source route "${e}"`);return de(o).forwardMap[e]=r,_e(o),o};const u=o,d=r.map(e=>Le(e));function f(e,r=!1){se(o,t.createRouteTree("",u[a],e,{skipValidation:r}))}function l(){return ie(o)}return u[a]="",se(o,t.createRouteTree("",u[a],d)),ue(o,{}),u[n]=d,Ce(r,o),_e(o),o.addRoute=e=>{const r=Array.isArray(e)?[...e]:[e];!function(e){const r=new Set,n=new Map;for(const o of e)t.validateRoute(o,"addRoute",l(),"",r,n),Te(o,o.name);$e(e,de(o).forwardMap,l())}(r);for(const e of r)d.push(Le(e));return Ce(r,o),f(d,!0),_e(o),o},o.removeRoute=t=>{e.validateRouteName(t,"removeRoute");const r=o.getState();if(r){const e=r.name,n=e===t,a=e.startsWith(`${t}.`);if(n||a)return console.warn(`[router.removeRoute] Cannot remove route "${t}" — it is currently active${n?"":` (current: "${e}")`}. Navigate away first.`),o}return o.isNavigating()&&console.warn(`[router.removeRoute] Route "${t}" removed while navigation is in progress. This may cause unexpected behavior.`),Me(d,t)?(i(t),f(d,!0),_e(o),o):(console.warn(`[router.removeRoute] Route "${t}" not found. No changes made.`),o)},o.clearRoutes=()=>{if(o.isNavigating())return console.error("[router.clearRoutes] Cannot clear routes while navigation is in progress. Wait for navigation to complete."),o;d.length=0;const e=de(o);for(const t in e.decoders)delete e.decoders[t];for(const t in e.encoders)delete e.encoders[t];for(const t in e.defaultParams)delete e.defaultParams[t];for(const t in e.forwardMap)delete e.forwardMap[t];const[t,r]=o.getLifecycleFactories();for(const e in r)o.clearCanActivate(e,!0);for(const e in t)o.clearCanDeactivate(e,!0);return o.setState(void 0),f(d,!0),_e(o),o},o.getRoute=r=>{e.validateRouteName(r,"getRoute");const n=l(),a=t.getSegmentsByName(n,r);if(!a)return;const i=a.at(-1),s=t.nodeToDefinition(i),[,c]=o.getLifecycleFactories(),u=function(e,t){const r=(n,o)=>{const a={name:n.name,path:n.path},i=e.forwardMap[o];return i&&(a.forwardTo=i),o in e.defaultParams&&(a.defaultParams=e.defaultParams[o]),o in e.decoders&&(a.decodeParams=e.decoders[o]),o in e.encoders&&(a.encodeParams=e.encoders[o]),o in t&&(a.canActivate=t[o]),n.children&&(a.children=n.children.map(e=>r(e,`${o}.${e.name}`))),a};return r}(de(o),c);return u(s,r)},o.hasRoute=r=>{e.validateRouteName(r,"hasRoute");const n=l();return t.hasSegmentsByName(n,r)},o.updateRoute=(r,n)=>{e.validateRouteName(r,"updateRoute"),function(e){if(null===e||"object"!=typeof e||Array.isArray(e))throw new TypeError(`[real-router] updateRoute: updates must be an object, got ${qe(e)}`)}(n);const a=l(),i=t.getSegmentsByName(a,r);if(!i)throw new ReferenceError(`[real-router] updateRoute: route "${r}" does not exist`);o.isNavigating()&&console.error(`[router.updateRoute] Route "${r}" config modified while navigation is in progress. Changes will apply immediately and may affect the current transition.`);const c=de(o),{forwardTo:u,defaultParams:d,decodeParams:f,encodeParams:p,canActivate:m}=n;return null!=u&&Pe(r,{...c.forwardMap,[r]:u}),function(e){if(null!=e&&("object"!=typeof e||Array.isArray(e)))throw new TypeError(`[real-router] updateRoute: defaultParams must be an object or null, got ${qe(e)}`)}(d),ze(f,"decodeParams"),ze(p,"encodeParams"),void 0!==u&&(null===u?delete c.forwardMap[r]:s(r,u,i,a),_e(o)),Ue(c.defaultParams,r,d),Ue(c.decoders,r,f),Ue(c.encoders,r,p),void 0!==m&&(null===m?o.clearCanActivate(r,!0):o.canActivate(r,m)),o},o}}function Ke(e,t){return e===t||!(!Array.isArray(e)||!Array.isArray(t))&&e.length===t.length&&e.every((e,r)=>Ke(e,t[r]))}function Ve(r){let n,o,a=0;const i=()=>ie(r),s=new Map;return r.getState=()=>n,r.setState=t=>{void 0!==t&&e.validateState(t,"router.setState"),o=n,n=t?Object.isFrozen(t)?t:y(t):void 0},r.getPreviousState=()=>o,r.makeState=(t,n,o,i,s)=>{if(!e.isString(t))throw new TypeError(`[router.makeState] Invalid name: ${e.getTypeDescription(t)}. Expected string.`);if(void 0!==n&&!e.isParams(n))throw new TypeError(`[router.makeState] Invalid params: ${e.getTypeDescription(n)}. Expected plain object.`);if(void 0!==o&&!e.isString(o))throw new TypeError(`[router.makeState] Invalid path: ${e.getTypeDescription(o)}. Expected string.`);if(void 0!==s&&"number"!=typeof s)throw new TypeError(`[router.makeState] Invalid forceId: ${e.getTypeDescription(s)}. Expected number.`);const c=i?{...i,id:s??++a,params:i.params,options:i.options,redirected:i.redirected}:void 0,u=de(r).defaultParams;let d;return d=Object.hasOwn(u,t)?{...u[t],...n}:n?{...n}:{},y({name:t,params:d,path:o??r.buildPath(t,n),meta:c})},r.makeNotFoundState=(t,n)=>{if(!e.isString(t))throw new TypeError(`[router.makeNotFoundState] Invalid path: ${e.getTypeDescription(t)}. Expected string.`);if(void 0!==n&&!e.isNavigationOptions(n))throw new TypeError(`[router.makeNotFoundState] Invalid options: ${e.getTypeDescription(n)}. Expected NavigationOptions object.`);return r.makeState(c.UNKNOWN_ROUTE,{path:t},t,n?{options:n,params:{},redirected:!1}:void 0)},r.areStatesEqual=(e,r,n=!0)=>{if(!e||!r)return!!e==!!r;if(e.name!==r.name)return!1;if(n){const n=e.meta?.params??r.meta?.params;return(n?function(e){const t=[];for(const r in e){const n=e[r];for(const e in n)"url"===n[e]&&t.push(e)}return t}(n):(e=>{const r=s.get(e);if(void 0!==r)return r;const n=t.getSegmentsByName(i(),e);if(!n)return s.set(e,[]),[];const o=n.flatMap(e=>e.parser?e.parser.urlParams:[]);return s.set(e,o),o})(e.name)).every(t=>Ke(e.params[t],r.params[t]))}const o=Object.keys(e.params),a=Object.keys(r.params);return o.length===a.length&&o.every(t=>t in r.params&&Ke(e.params[t],r.params[t]))},r.areStatesDescendants=(t,r)=>(e.validateState(t,"areStatesDescendants"),e.validateState(r,"areStatesDescendants"),console.warn("[real-router] areStatesDescendants is deprecated and will be removed in the next major version. Use router.isActiveRoute() instead."),!!r.name.startsWith(`${t.name}.`)&&Object.keys(t.params).every(e=>Ke(t.params[e],r.params[e]))),r.forwardState=(t,n)=>{if(!e.isString(t))throw new TypeError(`[router.forwardState] Invalid routeName: ${e.getTypeDescription(t)}. Expected string.`);if(!e.isParams(n))throw new TypeError(`[router.forwardState] Invalid routeParams: ${e.getTypeDescription(n)}. Expected plain object.`);const o=ce(r)[t]??t,{defaultParams:a}=de(r),i=Object.hasOwn(a,t),s=Object.hasOwn(a,o);let c;return c=i&&s?{...a[t],...a[o],...n}:i?{...a[t],...n}:s?{...a[o],...n}:n,{name:o,params:c}},r.buildState=(n,o)=>{if(!e.isString(n))throw new TypeError(`[router.buildState] Invalid routeName: ${e.getTypeDescription(n)}. Expected string.`);if(!e.isParams(o))throw new TypeError(`[router.buildState] Invalid routeParams: ${e.getTypeDescription(o)}. Expected plain object.`);const{name:a,params:s}=r.forwardState(n,o),c=t.getSegmentsByName(i(),a);if(c)return fe({segments:c,params:s},a)},r.buildStateWithSegments=(n,o)=>{if(!e.isString(n))throw new TypeError(`[router.buildStateWithSegments] Invalid routeName: ${e.getTypeDescription(n)}. Expected string.`);if(!e.isParams(o))throw new TypeError(`[router.buildStateWithSegments] Invalid routeParams: ${e.getTypeDescription(o)}. Expected plain object.`);const{name:a,params:s}=r.forwardState(n,o),c=t.getSegmentsByName(i(),a);if(c)return{state:fe({segments:c,params:s},a),segments:c}},r}var He=(t=[],r={},n={})=>{const o={[i]:{decoders:{},encoders:{},defaultParams:{},forwardMap:{}}};return((...e)=>t=>e.reduce((e,t)=>t(e),t))(function(t){return r=>{for(const[r,n]of Object.entries(t)){if(!e.isObjKey(r,Y))throw new TypeError(`[router.options] Unknown option: "${r}"`);void 0!==n&&Z(r,n,Y[r],"withOptions")}let n=X({...Y,...t});return r.getOptions=()=>n,r.setOption=(t,o)=>{if(!e.isString(t))throw new TypeError("[router.setOption]: option name must be a string, got "+typeof t);if(r.isStarted()&&"defaultRoute"!==t&&"defaultParams"!==t)throw new Error("[router.setOption] Options cannot be changed after router.start(). Only defaultRoute/defaultParams can be changed after start.");if(!Object.hasOwn(n,t))throw new ReferenceError(`[router.setOption]: option "${t}" not found`);Z(t,o,Y[t],"setOption");const a=o&&"object"==typeof o&&o.constructor===Object?{...o}:o;return n=X({...n,[t]:a}),r},r}}(r),function(t){const r=t=>{if(!t||"object"!=typeof t||t.constructor!==Object)throw new TypeError(`[router.setDependencies] Invalid argument: expected plain object, received ${e.getTypeDescription(t)}`);for(const e in t)if(Object.getOwnPropertyDescriptor(t,e)?.get)throw new TypeError(`[router.setDependencies] Getters not allowed: "${e}"`);N({...n,...t},"setDependencies");const r=[];for(const e in t)void 0!==t[e]&&(Object.hasOwn(n,e)&&r.push(e),n[e]=t[e]);r.length>0&&console.warn("[router.setDependencies] Overwritten:",r.join(", "))},n=Object.create(null);return r(t),t=>(t.setDependency=(e,r)=>{if(void 0===r)return t;if(O("setDependency",e),Object.hasOwn(n,e)){const t=n[e],o=t!==r,a=Number.isNaN(t)&&Number.isNaN(r);o&&!a&&console.warn("[router.setDependency] Router dependency already exists and is being overwritten:",e)}else N(n,"setDependency");return n[e]=r,t},t.setDependencies=e=>(r(e),t),t.getDependency=e=>{O("getDependency",e);const t=n[e];if(void 0===t)throw new ReferenceError(`[router.getDependency]: dependency "${String(e)}" not found`);return t},t.getDependencies=()=>({...n}),t.removeDependency=r=>(Object.hasOwn(n,r)||console.warn(`[router.removeDependency] Attempted to remove non-existent dependency: "${e.getTypeDescription(r)}"`),delete n[r],t),t.hasDependency=e=>Object.hasOwn(n,e),t.resetDependencies=()=>{for(const e in n)delete n[e];return t},t)}(n),G,Ve,ge,ae,V,ne,I,function(e){return t=>[Be(e),pe,We].reduce((e,t)=>t(e),t)}(t))(o)};exports.RouterError=b,exports.constants=c,exports.createRouter=He,exports.errorCodes=s,exports.events=h;//# sourceMappingURL=index.js.map
|
|
1
|
+
var e=require("type-guards"),t=require("logger"),r=require("route-tree"),n=Symbol("real-router.routeTree"),o=Symbol("real-router.routeDefinitions"),a=Symbol("real-router.resolvedForwardMap"),i=Symbol("real-router.rootPath"),s=Symbol("real-router.config"),c=Object.freeze({ROUTER_NOT_STARTED:"NOT_STARTED",NO_START_PATH_OR_STATE:"NO_START_PATH_OR_STATE",ROUTER_ALREADY_STARTED:"ALREADY_STARTED",ROUTE_NOT_FOUND:"ROUTE_NOT_FOUND",SAME_STATES:"SAME_STATES",CANNOT_DEACTIVATE:"CANNOT_DEACTIVATE",CANNOT_ACTIVATE:"CANNOT_ACTIVATE",TRANSITION_ERR:"TRANSITION_ERR",TRANSITION_CANCELLED:"CANCELLED"}),u={UNKNOWN_ROUTE:"@@router/UNKNOWN_ROUTE"},d="onStart",f="onStop",l="onTransitionStart",p="onTransitionCancel",m="onTransitionSuccess",g="onTransitionError",h={ROUTER_START:"$start",ROUTER_STOP:"$stop",TRANSITION_START:"$$start",TRANSITION_CANCEL:"$$cancel",TRANSITION_SUCCESS:"$$success",TRANSITION_ERROR:"$$error"},w=new WeakSet;function v(e){if(null!==e&&"object"==typeof e&&!Object.isFrozen(e))if(Object.freeze(e),Array.isArray(e))for(const t of e)v(t);else for(const t in e)v(e[t])}function y(e){return e?(w.has(e)||(v(e),w.add(e)),e):e}function T(e){switch(e){case"never":return"never";case"always":return"always";default:return"default"}}function E(e){const t={trailingSlashMode:T(e.trailingSlash),queryParamsMode:e.queryParamsMode,urlParamsEncoding:e.urlParamsEncoding};return void 0!==e.queryParams&&(t.queryParams=e.queryParams),t}var S=new Set(Object.values(c)),b=new Set(["code","segment","path","redirect"]),R=new Set(["setCode","setErrorInstance","setAdditionalFields","hasField","getField","toJSON"]),O=class extends Error{segment;path;redirect;code;constructor(e,{message:t,segment:r,path:n,redirect:o,...a}={}){super(t??e),this.code=e,this.segment=r,this.path=n,this.redirect=o?function(e){if(!e)return e;if(null===(t=e)||"object"!=typeof t||"string"!=typeof t.name||"string"!=typeof t.path||"object"!=typeof t.params||null===t.params)throw new TypeError("[deepFreezeState] Expected valid State object, got: "+typeof e);var t;const r=structuredClone(e),n=new WeakSet;return function e(t){if(null===t||"object"!=typeof t)return;if(n.has(t))return;n.add(t),Object.freeze(t);const r=Array.isArray(t)?t:Object.values(t);for(const t of r)e(t)}(r),r}(o):void 0;for(const[e,t]of Object.entries(a)){if(b.has(e))throw new TypeError(`[RouterError] Cannot set reserved property "${e}"`);R.has(e)||(this[e]=t)}}setCode(e){this.code=e,S.has(this.message)&&(this.message=e)}setErrorInstance(e){if(!e)throw new TypeError("[RouterError.setErrorInstance] err parameter is required and must be an Error instance");this.message=e.message,this.cause=e.cause,this.stack=e.stack??""}setAdditionalFields(e){for(const[t,r]of Object.entries(e)){if(b.has(t))throw new TypeError(`[RouterError.setAdditionalFields] Cannot set reserved property "${t}"`);R.has(t)||(this[t]=r)}}hasField(e){return e in this}getField(e){return this[e]}toJSON(){const e={code:this.code,message:this.message};void 0!==this.segment&&(e.segment=this.segment),void 0!==this.path&&(e.path=this.path),void 0!==this.redirect&&(e.redirect=this.redirect);const t=new Set(["code","message","segment","path","redirect","stack"]);for(const r in this)Object.hasOwn(this,r)&&!t.has(r)&&(e[r]=this[r]);return e}};function N(e,t){if("string"!=typeof t)throw new TypeError(`[router.${e}]: dependency name must be a string, got ${typeof t}`)}function A(e,r){const n=Object.keys(e).length;if(20===n)t.logger.warn(`router.${r}`,"20 dependencies registered. Consider if all are necessary.");else if(50===n)t.logger.error(`router.${r}`,"50 dependencies registered! This indicates architectural problems. Hard limit at 100.");else if(n>=100)throw new Error(`[router.${r}] Dependency limit exceeded (100). Current: ${n}. This is likely a bug in your code. If you genuinely need more dependencies, your architecture needs refactoring.`)}function $(e){return e.name?e.name:"anonymous"}function I(t,r){if("function"!=typeof t)throw new TypeError(`[router.useMiddleware] Middleware factory must return a function, got ${e.getTypeDescription(t)}. Factory: ${$(r)}`)}function P(r){const n=new Set,o=new Map;return r.useMiddleware=(...a)=>{!function(e,r){const n=e+r;if(n>50)throw new Error(`[router.useMiddleware] Middleware limit exceeded (50). Current: ${r}, Attempting to add: ${e}. This indicates an architectural problem. Consider consolidating middleware.`);n>=30?t.logger.error("router.useMiddleware",`${n} middleware registered! This is excessive and will impact performance. Hard limit at 50.`):n>=15&&t.logger.warn("router.useMiddleware",`${n} middleware registered. Consider if all are necessary.`)}(a.length,n.size),a.forEach((t,r)=>{if(function(t,r){if("function"!=typeof t)throw new TypeError(`[router.useMiddleware] Expected middleware factory function at index ${r}, got ${e.getTypeDescription(t)}`)}(t,r),n.has(t))throw new Error(`[router.useMiddleware] Middleware factory already registered. To re-register, first unsubscribe the existing middleware. Factory: ${$(t)}`)});const i=[];try{for(const e of a){const t=e(r,r.getDependency);I(t,e),i.push({factory:e,middleware:t})}}catch(e){throw t.logger.error("router.useMiddleware","Failed to initialize middleware, rolling back",e),e}for(const{factory:e,middleware:t}of i)n.add(e),o.set(e,t);return()=>{for(const{factory:e}of i)n.delete(e)||t.logger.warn("router.useMiddleware","Attempted to remove non-existent middleware factory. This might indicate a memory leak or incorrect cleanup logic."),o.delete(e)}},r.clearMiddleware=()=>(n.clear(),o.clear(),r),r.getMiddlewareFactories=()=>[...n],r.getMiddlewareFunctions=()=>[...o.values()],r}var _=(e,t)=>{if(t)return t.setCode(e),t},j=(e,t)=>{const r=e.meta,n=t.meta,o=r?.params,a=n?.params,i=o&&a?{...o,...a}:o??a??{},s={id:1,options:{},redirected:!1,...n,...r,params:i};return{...e,meta:s}},k=(t,r,n)=>{const o=n?{segment:n}:{};void 0!==t&&("boolean"!=typeof t?e.isState(t)?r(void 0,t):e.isPromise(t)?t.then(e=>{"boolean"==typeof e?e?r():r(new O(c.TRANSITION_ERR,o)):r(void 0,e)},e=>{let t=o;e instanceof Error?(t={...o,message:e.message,stack:e.stack},"cause"in e&&void 0!==e.cause&&(t.cause=e.cause)):e&&"object"==typeof e&&(t={...o,...e}),r(new O(c.TRANSITION_ERR,t))}):r(new O(c.TRANSITION_ERR,{...o,message:"Invalid lifecycle result type: "+typeof t})):t?r():r(new O(c.TRANSITION_ERR,o)))},D=new Set(["code","segment","path","redirect"]);function C(e,t){const r=t?{segment:t}:{};if(e instanceof Error)return{...r,message:e.message,stack:e.stack,..."cause"in e&&void 0!==e.cause&&{cause:e.cause}};if(e&&"object"==typeof e){const t={};for(const[r,n]of Object.entries(e))D.has(r)||(t[r]=n);return{...r,...t}}return r}function x(e,r,n){try{e(r,n)}catch(e){t.logger.error("core:lifecycle","Error in lifecycle callback:",e)}}var L=(r,n,o,a,i,s,u)=>{let d=n;const f=a.filter(e=>r.has(e));if(0===f.length)return void x(u,void 0,d);let l=0;const p=(e,t)=>{if(e)if(e.redirect){const t=new O(i,{message:"Guards cannot redirect. Use middleware for redirects.",attemptedRedirect:e.redirect});m(t)}else m(e);else m(void 0,t)},m=(n,a)=>{if(s())return void x(u,new O(c.TRANSITION_CANCELLED),d);if(n)return void x(u,_(i,n),d);if(a&&a!==d&&e.isState(a)){if(a.name!==d.name){const e=new O(i,{message:"Guards cannot redirect to different route. Use middleware.",attemptedRedirect:{name:a.name,params:a.params,path:a.path}});return void x(u,e,d)}(a.params!==d.params||a.path!==d.path)&&t.logger.error("core:transition","Warning: State mutated during transition",{from:d,to:a}),d=j(a,d)}if(l>=f.length)return void x(u,void 0,d);const m=f[l++],g=r.get(m);try{const e=g.call(null,d,o,p);k(e,p,m)}catch(e){p(new O(c.TRANSITION_ERR,C(e,m)))}};m()};function M(e,r,n){try{e(r,n)}catch(e){t.logger.error("real-router:middleware","Error in middleware callback:",e)}}var U=".";function F(e){const t=[];for(let r=e.length-1;r>=0;r--)t.push(e[r]);return t}function q(e,r){const n=r.meta?.params[e];if(!n||"object"!=typeof n)return{};const o={};for(const e in n){if(!Object.hasOwn(n,e))continue;if(void 0===n[e])continue;const a=r.params[e];null!=a&&("string"==typeof a||"number"==typeof a||"boolean"==typeof a?o[e]=String(a):t.logger.warn("transitionPath.extractSegmentParams",`Unsupported param type for key "${e}": ${typeof a}. Only primitives (string, number, boolean) are supported.`,typeof a))}return o}function W(e){if(!e)return[""];const t=e.indexOf(U);if(-1===t)return[e];const r=e.indexOf(U,t+1);if(-1===r)return[e.slice(0,t),e];const n=e.indexOf(U,r+1);return-1===n?[e.slice(0,t),e.slice(0,r),e]:-1===e.indexOf(U,n+1)?[e.slice(0,t),e.slice(0,r),e.slice(0,n),e]:function(e){const t=e.split(U),r=t.length,n=[t[0]];let o=t[0].length;for(let a=1;a<r-1;a++)o+=1+t[a].length,n.push(e.slice(0,o));return n.push(e),n}(e)}function z(t,r){if(e.validateState(t,"getTransitionPath"),!r)return{intersection:"",toActivate:W(t.name),toDeactivate:[]};if(e.validateState(r,"getTransitionPath"),(t.meta?.options??{}).reload)return{intersection:"",toActivate:W(t.name),toDeactivate:F(W(r.name))};const n=void 0!==t.meta?.params,o=void 0!==r.meta?.params;if(!n&&!o)return{intersection:"",toActivate:W(t.name),toDeactivate:F(W(r.name))};if(t.name===r.name&&n&&o){const e=t.meta&&0===Object.keys(t.meta.params).length,n=r.meta&&0===Object.keys(r.meta.params).length;if(e&&n)return{intersection:t.name,toActivate:[],toDeactivate:[]}}const a=W(t.name),i=W(r.name),s=function(e,t,r,n,o){for(let a=0;a<o;a++){const o=r[a],i=n[a];if(o!==i)return a;const s=q(o,e),c=q(i,t),u=Object.keys(s),d=Object.keys(c);if(u.length!==d.length)return a;for(const e of u)if(s[e]!==c[e])return a}return o}(t,r,a,i,Math.min(i.length,a.length)),c=[];for(let e=i.length-1;e>=s;e--)c.push(i[e]);const u=a.slice(s);return{intersection:s>0?i[s-1]:"",toDeactivate:c,toActivate:u}}function B(r,n,o,a,i){let s=!1,d=!1;const[f,l]=r.getLifecycleFunctions(),p=r.getMiddlewareFunctions(),m=n.name===u.UNKNOWN_ROUTE,g=()=>s||!r.isActive(),h=(e,t)=>{d||(d=!0,i(e,t??n))};return(()=>{const{toDeactivate:i,toActivate:s}=z(n,o),u=!m&&s.length>0,d=p.length>0;var w;w=(a,i)=>{a?h(a,i):((e,t)=>{u?L(l,e,o,s,c.CANNOT_ACTIVATE,g,(e,r)=>{t(e,r)}):t(void 0,e)})(i,(a,i)=>{a?h(a,i):((r,n)=>{d?((r,n,o,a,i)=>{let s=n,u=0;const d=(e,t)=>{e?f(e):f(void 0,t)},f=(n,f)=>{if(a())return void M(i,new O(c.TRANSITION_CANCELLED),s);if(n)return void M(i,_(c.TRANSITION_ERR,n),s);if(f&&f!==s&&e.isState(f)&&((f.name!==s.name||f.params!==s.params||f.path!==s.path)&&t.logger.error("real-router:middleware","Warning: State mutated during middleware execution",{from:s,to:f}),s=j(f,s)),u>=r.length)return void M(i,void 0,s);const l=r[u++];try{const e=l.call(null,s,o,d);k(e,d)}catch(e){d(new O(c.TRANSITION_ERR,C(e)))}};f()})(p,r,o,g,(e,t)=>{n(e,t)}):n(void 0,r)})(i,(e,t)=>{if(e)h(e,t);else{if(o){const e=W(n.name),t=W(o.name),a=new Set(e);for(const e of t)!a.has(e)&&f.has(e)&&r.clearCanDeactivate(e)}h(void 0,t)}})})},o&&!a.forceDeactivate&&i.length>0?L(f,n,o,i,c.CANNOT_DEACTIVATE,g,w):w(void 0,n)})(),()=>{s||d||(s=!0,h(new O(c.TRANSITION_CANCELLED)))}}var K=()=>{};function V(e,...r){try{e(...r)}catch(e){t.logger.error("router.navigate","Error in navigation callback:",e)}}function H(r){let n=null,o=!1;return r.navigate=function(t,n,o,a){const{params:i,opts:s,callback:u}=function(e,t,r){if("function"==typeof e)return{params:{},opts:{},callback:e};const n=e??{};return"function"==typeof t?{params:n,opts:{},callback:t}:{params:n,opts:t??{},callback:r??K}}(n,o,a);if(!r.isStarted())return V(u,new O(c.ROUTER_NOT_STARTED)),K;if(!e.isNavigationOptions(s))throw new TypeError(`[router.navigate] Invalid options: ${e.getTypeDescription(s)}. Expected NavigationOptions object.`);const d=r.buildStateWithSegments(t,i);if(!d){const e=new O(c.ROUTE_NOT_FOUND);return V(u,e),r.invokeEventListeners(h.TRANSITION_ERROR,void 0,r.getState(),e),K}const{state:f,segments:l}=d,p=r.makeState(f.name,f.params,r.buildPathWithSegments(f.name,f.params,l),{params:f.meta,options:s,redirected:s.redirected??!1});if(s.skipTransition)return V(u,void 0,p),K;const m=r.getState();if(!s.reload&&!s.force&&r.areStatesEqual(m,p,!1)){const e=new O(c.SAME_STATES);return V(u,e),r.invokeEventListeners(h.TRANSITION_ERROR,p,m,e),K}return r.navigateToState(p,m,s,u,!0)},r.navigateToDefault=function(t,n){const o=r.getOptions();if(!o.defaultRoute)return K;let a={},i=K;if("function"==typeof t?i=t:t&&(a=t,i=n??K),!e.isNavigationOptions(a))throw new TypeError(`[router.navigateToDefault] Invalid options: ${e.getTypeDescription(a)}. Expected NavigationOptions object.`);return r.navigate(o.defaultRoute,o.defaultParams,a,i)},r.navigateToState=(e,a,i,s,d)=>(o&&t.logger.warn("router.navigate","Concurrent navigation detected on shared router instance. For SSR, use router.clone() to create isolated instance per request."),n&&(n(),n=null),o=!1,o=!0,r.invokeEventListeners(h.TRANSITION_START,e,a),n=B(r,e,a,i,(t,f)=>{if(o=!1,n=null,t)t.code===c.TRANSITION_CANCELLED?r.invokeEventListeners(h.TRANSITION_CANCEL,e,a):r.invokeEventListeners(h.TRANSITION_ERROR,e,a,t),V(s,t);else if(f.name===u.UNKNOWN_ROUTE||r.hasRoute(f.name))r.setState(f),d&&r.invokeEventListeners(h.TRANSITION_SUCCESS,f,a,i),V(s,void 0,f);else{const e=new O(c.ROUTE_NOT_FOUND,{routeName:f.name});V(s,e),r.invokeEventListeners(h.TRANSITION_ERROR,void 0,r.getState(),e)}}),n),r.isNavigating=()=>r.isStarted()&&o,r}function G(e,r,...n){if(0===r.size)return;const o=[...r];for(const r of o)try{Function.prototype.apply.call(r,void 0,n)}catch(r){t.logger.error("Router",`Error in listener for ${e}:`,r)}}function J(r){const n={};function o(e){const t=n[e];if(t)return t;const r=new Set;return n[e]=r,r}let a=null;const i=()=>(a??={[h.ROUTER_START]:0,[h.TRANSITION_START]:0,[h.TRANSITION_SUCCESS]:0,[h.TRANSITION_ERROR]:0,[h.TRANSITION_CANCEL]:0,[h.ROUTER_STOP]:0},a),s=new Set([h.ROUTER_START,h.TRANSITION_START,h.TRANSITION_SUCCESS,h.TRANSITION_ERROR,h.TRANSITION_CANCEL,h.ROUTER_STOP]),c=(e,t)=>{if(!s.has(e))throw new Error(`Invalid event name: ${e}`);if("function"!=typeof t)throw new TypeError(`Expected callback to be a function for event ${e}`)};r.invokeEventListeners=(t,r,n,a)=>{(e=>{if(!s.has(e))throw new Error(`Invalid event name: ${e}`);if(i()[e]>=5)throw new Error(`[Router] Maximum recursion depth (5) exceeded for event: ${e}`)})(t);const c=i();try{switch(c[t]++,t){case h.TRANSITION_START:case h.TRANSITION_CANCEL:if(!r)throw new TypeError(`[router.invokeEventListeners] toState is required for event "${t}"`);if(!e.isState(r))throw new TypeError(`[router.invokeEventListeners] toState is invalid for event "${t}". Expected State object with name, path, and params.`);if(n&&!e.isState(n))throw new TypeError(`[router.invokeEventListeners] fromState is invalid for event "${t}". Expected State object with name, path, and params.`);G(t,o(t),r,n);break;case h.TRANSITION_ERROR:if(r&&!e.isState(r))throw new TypeError(`[router.invokeEventListeners] toState is invalid for event "${t}". Expected State object with name, path, and params.`);if(n&&!e.isState(n))throw new TypeError(`[router.invokeEventListeners] fromState is invalid for event "${t}". Expected State object with name, path, and params.`);if(!a)throw new TypeError(`[router.invokeEventListeners] error is required for event "${t}"`);if(!(a instanceof O))throw new TypeError(`[router.invokeEventListeners] error must be a RouterError instance for event "${t}". Got: ${"object"==typeof a?a.constructor.name:typeof a}`);G(t,o(t),r,n,a);break;case h.TRANSITION_SUCCESS:if(!r)throw new TypeError(`[router.invokeEventListeners] toState is required for event "${t}"`);if(!e.isState(r))throw new TypeError(`[router.invokeEventListeners] toState is invalid for event "${t}". Expected State object with name, path, and params.`);if(n&&!e.isState(n))throw new TypeError(`[router.invokeEventListeners] fromState is invalid for event "${t}". Expected State object with name, path, and params.`);if(!a)throw new TypeError(`[router.invokeEventListeners] options is required for event "${t}"`);if(a instanceof O)throw new TypeError(`[router.invokeEventListeners] options cannot be a RouterError for event "${t}". Use TRANSITION_ERROR event for errors.`);if(!e.isNavigationOptions(a))throw new TypeError(`[router.invokeEventListeners] options is invalid for event "${t}". Expected NavigationOptions object.`);G(t,o(t),r,n,a);break;default:G(t,o(t))}}finally{c[t]--}},r.hasListeners=e=>{if(!s.has(e))return!1;const t=n[e];return void 0!==t&&t.size>0},r.removeEventListener=(e,r)=>{c(e,r);const o=n[e];o&&0!==o.size&&(o.delete(r)||t.logger.warn("Router",`Attempted to remove non-existent listener for "${e}". This might indicate a memory leak or incorrect cleanup logic.`))},r.addEventListener=(e,n)=>{c(e,n);const a=o(e);if(a.has(n))throw new Error(`[router.addEventListener] Listener already exists for event "${e}". Each listener function can only be registered once per event. Store the returned unsubscribe function to remove the listener.`);if(1e3===a.size&&t.logger.warn("router.addEventListener",`Warning: Event "${e}" has ${a.size} listeners. This might indicate a memory leak.`),a.size>=1e4)throw new Error(`[router.addEventListener] Maximum listener limit (10000) reached for event "${e}". This is a critical memory leak. The application is creating listeners exponentially. Check for loops or recursive calls that register listeners.`);return a.add(n),()=>{r.removeEventListener(e,n)}},r.subscribe=function(e){if("function"!=typeof e)throw new TypeError("[router.subscribe] Expected a function. For Observable pattern use router[Symbol.observable]().subscribe(observer)");return r.addEventListener(h.TRANSITION_SUCCESS,(t,r)=>{e({route:t,previousRoute:r})})};const u="function"==typeof Symbol&&Symbol.observable||"@@observable",d=new WeakMap;return r[u]=function(){return{subscribe(e,n={}){const o="function"==typeof e?{next:e}:e,a=d.get(o);if(a?.active)return t.logger.warn("router.observable","Duplicate subscription prevented. Same observer already subscribed."),{unsubscribe:a.unsubscribe,get closed(){return!a.active}};const{signal:i,replay:s=!0}=n;if(i?.aborted)return{unsubscribe:()=>{},closed:!0};let c=!1;const u=e=>{if(!c&&o.next)try{o.next(e)}catch(e){if(t.logger.error("router.observable","Error in observer.next:",e),o.error)try{o.error(e)}catch(e){t.logger.error("router.observable","Error in observer.error:",e)}}},f=r.addEventListener(h.TRANSITION_SUCCESS,(e,t)=>{u({route:e,previousRoute:t})}),l={unsubscribe:()=>{if(!c&&(c=!0,l.active=!1,f(),o.complete))try{o.complete()}catch(e){t.logger.error("router.observable","Error in observer.complete:",e)}},active:!0};if(d.set(o,l),i&&i.addEventListener("abort",()=>{l.unsubscribe()},{once:!0}),s){const e=r.getState();e&&queueMicrotask(()=>{u({route:e,previousRoute:void 0})})}return{unsubscribe:l.unsubscribe,get closed(){return c}}},[u](){return this}}},r}var Y={defaultRoute:"",defaultParams:{},trailingSlash:"preserve",queryParamsMode:"loose",queryParams:{arrayFormat:"none",booleanFormat:"none",nullFormat:"default"},caseSensitive:!1,urlParamsEncoding:"default",allowNotFound:!0,rewritePathOnMatch:!0},Q={trailingSlash:["strict","never","always","preserve"],queryParamsMode:["default","strict","loose"],urlParamsEncoding:["default","uri","uriComponent","none"]},Z={arrayFormat:["none","brackets","index","comma"],booleanFormat:["none","string","empty-true"],nullFormat:["default","hidden"]};function X(t,r,n,o){if(n&&"object"==typeof n)return function(t,r,n){if(!t||"object"!=typeof t||t.constructor!==Object)throw new TypeError(`[router.${n}] Invalid type for "${r}": expected plain object, got ${e.getTypeDescription(t)}`);for(const e in t)if(Object.getOwnPropertyDescriptor(t,e)?.get)throw new TypeError(`[router.${n}] Getters not allowed in "${r}": "${e}"`)}(r,t,o),void("queryParams"===t&&function(t,r){for(const n in t){if(!e.isObjKey(n,Z)){const e=Object.keys(Z).map(e=>`"${e}"`).join(", ");throw new TypeError(`[router.${r}] Unknown queryParams key: "${n}". Valid keys: ${e}`)}const o=t[n],a=Z[n];if(!a.includes(o)){const e=a.map(e=>`"${e}"`).join(", ");throw new TypeError(`[router.${r}] Invalid value for queryParams.${n}: expected one of ${e}, got "${String(o)}"`)}}}(r,o));if(typeof r!=typeof n)throw new TypeError(`[router.${o}] Invalid type for "${t}": expected ${typeof n}, got ${typeof r}`);t in Q&&function(e,t,r){const n=Q[e];if(!n.includes(t)){const o=n.map(e=>`"${e}"`).join(", ");throw new TypeError(`[router.${r}] Invalid value for "${e}": expected one of ${o}, got "${String(t)}"`)}}(t,r,o)}function ee(e){Object.freeze(e);for(const t of Object.keys(e)){const r=e[t];r&&"object"==typeof r&&r.constructor===Object&&ee(r)}return e}var te="router.usePlugin",re={[d]:h.ROUTER_START,[f]:h.ROUTER_STOP,[m]:h.TRANSITION_SUCCESS,[l]:h.TRANSITION_START,[g]:h.TRANSITION_ERROR,[p]:h.TRANSITION_CANCEL},ne=Object.keys(re).filter(t=>e.isObjKey(t,re));function oe(r){const n=new Set;function o(n){const o=n(r,r.getDependency);(t=>{if(!t||"object"!=typeof t||Array.isArray(t))throw new TypeError(`[router.usePlugin] Plugin factory must return an object, got ${e.getTypeDescription(t)}`);if("function"==typeof t.then)throw new TypeError("[router.usePlugin] Async plugin factories are not supported. Factory returned a Promise instead of a plugin object.");for(const r in t)if("teardown"!==r&&!e.isObjKey(r,re))throw new TypeError(`[router.usePlugin] Unknown property '${r}'. Plugin must only contain event handlers and optional teardown.`)})(o),Object.freeze(o);const a=[];for(const e of ne)e in o&&("function"==typeof o[e]?(a.push(r.addEventListener(re[e],o[e])),e===d&&r.isStarted()&&t.logger.warn(te,"Router already started, onStart will not be called")):t.logger.warn(te,`Property '${e}' is not a function, skipping`));return()=>{a.forEach(e=>{e()}),"function"==typeof o.teardown&&o.teardown()}}return r.getPlugins=()=>[...n],r.usePlugin=(...e)=>{((e,r)=>{const n=e+r;if(n>50)throw new Error("[router.usePlugin] Plugin limit exceeded (50)");n>=25?t.logger.error(te,`${n} plugins registered!`):n>=10&&t.logger.warn(te,`${n} plugins registered`)})(e.length,n.size);const r=function(e,r){const n=new Set;for(const o of e){if("function"!=typeof o)throw new TypeError("[router.usePlugin] Expected plugin factory function, got "+typeof o);if(r.has(o))throw new Error("[router.usePlugin] Plugin factory already registered. To re-register, first unsubscribe the existing plugin.");n.has(o)?t.logger.warn(te,"Duplicate factory in batch, will be registered once"):n.add(o)}return n}(e,n),a=[];try{for(const e of r){const t=o(e);a.push({factory:e,cleanup:t})}}catch(e){for(const{cleanup:e}of a)try{e()}catch(e){t.logger.error(te,"Cleanup error:",e)}throw e}for(const{factory:e}of a)n.add(e);let i=!1;return()=>{if(!i){i=!0;for(const{factory:e}of a)n.delete(e);for(const{cleanup:e}of a)try{e()}catch(e){t.logger.error(te,"Error during cleanup:",e)}}}},r}function ae(t,r){if(!e.isBoolean(t)&&"function"!=typeof t)throw new TypeError(`[router.${r}] Handler must be a boolean or factory function, got ${e.getTypeDescription(t)}`)}function ie(r){const n=new Map,o=new Map,a=new Map,i=new Map,s=new Set;function c(n,o,a,i,c,u){if(s.has(o))throw new Error(`[router.${u}] Cannot modify route "${o}" during its own registration`);i.has(o)?t.logger.warn(`router.${u}`,`Overwriting existing ${n} handler for route "${o}"`):function(e,r){if(e>=200)throw new Error(`[router.${r}] Lifecycle handler limit exceeded (200). This indicates too many routes with individual handlers. Consider using middleware for cross-cutting concerns.`);e>=100?t.logger.error(`router.${r}`,`${e} lifecycle handlers registered! This is excessive. Hard limit at 200.`):e>=50&&t.logger.warn(`router.${r}`,`${e} lifecycle handlers registered. Consider consolidating logic.`)}(i.size+1,u);const d=e.isBoolean(a)?function(e){const t=()=>e;return()=>t}(a):a;i.set(o,d),s.add(o);try{const t=d(r,r.getDependency);if("function"!=typeof t)throw new TypeError(`[router.${u}] Factory must return a function, got ${e.getTypeDescription(t)}`);c.set(o,t)}catch(e){throw i.delete(o),e}finally{s.delete(o)}}return r.getLifecycleFactories=()=>{const e={},t={};for(const[t,r]of n)e[t]=r;for(const[e,r]of o)t[e]=r;return[e,t]},r.getLifecycleFunctions=()=>[a,i],r.canActivate=(t,n)=>(e.validateRouteName(t,"canActivate"),ae(n,"canActivate"),c("activate",t,n,o,i,"canActivate"),r),r.canDeactivate=(t,o)=>(e.validateRouteName(t,"canDeactivate"),ae(o,"canDeactivate"),c("deactivate",t,o,n,a,"canDeactivate"),r),r.clearCanDeactivate=(o,i=!1)=>{if(e.validateRouteName(o,"clearCanDeactivate"),s.has(o))throw new Error(`[router.clearCanDeactivate] Cannot modify route "${o}" during its own registration`);const c=n.delete(o),u=a.delete(o);return i||c||u||t.logger.warn("router.clearCanDeactivate",`No canDeactivate handler found for route "${o}"`),r},r.clearCanActivate=(n,a=!1)=>{if(e.validateRouteName(n,"clearCanActivate"),s.has(n))throw new Error(`[router.clearCanActivate] Cannot modify route "${n}" during its own registration`);const c=o.delete(n),u=i.delete(n);return a||c||u||t.logger.warn("router.clearCanActivate",`No canActivate handler found for route "${n}"`),r},r}function se(e){return e[n]}function ce(e,t){e[n]=t}function ue(e){return e[a]}function de(e,t){e[a]=t}function fe(e){return e[s]}function le(e,t){const n=t??function(e){let t="";for(const r of e)r.name&&(t&&(t+="."),t+=r.name);return t}(e.segments);return{name:n,params:e.params,meta:r.getMetaFromSegments(e.segments)}}var pe=Symbol("real-router.buildOptionsCache");function me(t){return t.buildPath=(n,o)=>{if(!e.isString(n)||""===n)throw new TypeError("[real-router] buildPath: route must be a non-empty string, got "+("string"==typeof n?'""':typeof n));if(n===u.UNKNOWN_ROUTE)return e.isString(o?.path)?o.path:"";const a=fe(t),i=Object.hasOwn(a.defaultParams,n)?{...a.defaultParams[n],...o}:o??{},s="function"==typeof a.encoders[n]?a.encoders[n]({...i}):i,c=t[pe]??E(t.getOptions());return r.buildPath(se(t),n,s,c)},t.buildPathWithSegments=(n,o,a)=>{if(!e.isString(n)||""===n)throw new TypeError("[real-router] buildPathWithSegments: route must be a non-empty string, got "+("string"==typeof n?'""':typeof n));if(n===u.UNKNOWN_ROUTE)return e.isString(o.path)?o.path:"";const i=fe(t),s=Object.hasOwn(i.defaultParams,n)?{...i.defaultParams[n],...o}:o,c="function"==typeof i.encoders[n]?i.encoders[n]({...s}):s,d=t[pe]??E(t.getOptions());return r.buildPath(se(t),n,c,d,a)},t.matchPath=(n,o)=>{if(!e.isString(n))throw new TypeError("[real-router] matchPath: path must be a string, got "+typeof n);const a=t.getOptions(),i=function(e){return{...E(e),caseSensitive:e.caseSensitive,strictTrailingSlash:"strict"===e.trailingSlash,strongMatching:!1}}(a),s=r.matchSegments(se(t),n,i);if(s){const e=le(s),{name:r,params:i,meta:c}=e,{decoders:u}=fe(t),d="function"==typeof u[r]?u[r](i):i,{name:f,params:l}=t.forwardState(r,d),p=a.rewritePathOnMatch?t.buildPath(f,l):n;return t.makeState(f,l,p,{params:c,options:{},source:o,redirected:!1})}},t.setRootPath=e=>{const n=t;n[i]=e,ce(t,r.createRouteTree("",e,n[o],{skipValidation:!0}))},t.getRootPath=()=>t[i]||"",t}var ge=()=>{},he=new O(c.NO_START_PATH_OR_STATE),we=new O(c.ROUTER_ALREADY_STARTED),ve=Symbol("started"),ye=Symbol("active");function Te(r){r[ve]=!1,r[ye]=!1;const n=()=>{r[ye]=!1};return r.isStarted=()=>!!r[ve],r.isActive=()=>!!r[ye],r.start=(...o)=>{const a=r.getOptions(),[i,s]=(e=>{if(e.length>2)throw new Error("Invalid number of arguments");const[t,r]=e;return t?"function"==typeof t?[void 0,t]:[t,r??ge]:[void 0,ge]})(o);let u=!1;if(r.isStarted()||r.isActive())return u=!0,s(we),r;if(!i&&!a.defaultRoute)return u=!0,r.hasListeners(h.TRANSITION_ERROR)&&r.invokeEventListeners(h.TRANSITION_ERROR,void 0,void 0,he),s(he),r;r[ye]=!0;const d=(e,t={})=>{r.navigateToState(e,void 0,t,(e,t)=>{l(e,t)},!1)},f={replace:!0},l=(e,o,a=!1)=>{e?(n(),a&&r.hasListeners(h.TRANSITION_ERROR)&&r.invokeEventListeners(h.TRANSITION_ERROR,void 0,void 0,e)):(r[ve]=!0,r.invokeEventListeners(h.ROUTER_START),r.invokeEventListeners(h.TRANSITION_SUCCESS,o,void 0,{replace:!0})),((e,r)=>{u?t.logger.warn("real-router","Callback already invoked"):(u=!0,s(e,r))})(e,o)},p=i??a.defaultRoute,m=((t,r)=>{if("string"==typeof t)return r.matchPath(t);if(e.isState(t)){try{r.buildPath(t.name,t.params)}catch{return}return t}})(p,r),g="string"==typeof p?p:"";return(void 0!==m||a.allowNotFound||a.defaultRoute&&!i)&&function(e,t){delete e[pe],e[pe]=E(t)}(r,a),m?d(m,f):a.defaultRoute&&!i?((e,t,n)=>{const o=r.buildState(e,t);if(!o)return void l(new O(c.ROUTE_NOT_FOUND,{routeName:e}),void 0,!0);const a=r.makeState(o.name,o.params,r.buildPath(o.name,o.params),{params:o.meta,options:n,redirected:!1});d(a,n)})(a.defaultRoute,a.defaultParams,f):a.allowNotFound?d(r.makeNotFoundState(g,f),f):l(new O(c.ROUTE_NOT_FOUND,{path:g}),void 0,!0),r},r.stop=()=>(n(),r.isStarted()&&(r[ve]=!1,r.setState(void 0),r.invokeEventListeners(h.ROUTER_STOP)),r),r}function Ee(t,r){if(void 0!==t.canActivate&&"function"!=typeof t.canActivate)throw new TypeError(`[router.addRoute] canActivate must be a function for route "${r}", got ${e.getTypeDescription(t.canActivate)}`);if(void 0!==t.defaultParams){const n=t.defaultParams;if(null===n||"object"!=typeof n||Array.isArray(n))throw new TypeError(`[router.addRoute] defaultParams must be an object for route "${r}", got ${e.getTypeDescription(t.defaultParams)}`)}if(t.children)for(const e of t.children)Ee(e,`${r}.${e.name}`)}function Se(e){const t=new Set;for(const r of e){const e=r.parser;for(const r of e.urlParams)t.add(r);for(const r of e.spatParams)t.add(r)}return t}function be(e){const t=new Set,r=/[*:]([A-Z_a-z]\w*)/g;let n;for(;null!==(n=r.exec(e));)t.add(n[1]);return t}function Re(e,t,r="",n=[]){for(const o of e){const e=r?`${r}.${o.name}`:o.name,a=[...n,o.path];if(e===t)return a;if(o.children&&t.startsWith(`${e}.`))return Re(o.children,t,e,a)}}function Oe(e){const t=new Set;for(const r of e)for(const e of be(r))t.add(e);return t}function Ne(e,t=""){const r=new Set;for(const n of e){const e=t?`${t}.${n.name}`:n.name;if(r.add(e),n.children)for(const t of Ne(n.children,e))r.add(t)}return r}function Ae(e,t=""){const r=new Map;for(const n of e){const e=t?`${t}.${n.name}`:n.name;if(n.forwardTo&&r.set(e,n.forwardTo),n.children)for(const[t,o]of Ae(n.children,e))r.set(t,o)}return r}function $e(e,t,n,o,a){const i=function(e,t){const r=t.split(".");let n=e;for(const e of r)if(n=n.childrenByName.get(e),!n)return!1;return!0}(a,t),s=o.has(t);if(!i&&!s)throw new Error(`[router.addRoute] forwardTo target "${t}" does not exist for route "${e}"`);const c=Oe(Re(n,e)),u=function(e,t,n,o){return t?Se(r.getSegmentsByName(n,e)):Oe(Re(o,e))}(t,i,a,n),d=[...u].filter(e=>!c.has(e));if(d.length>0)throw new Error(`[router.addRoute] forwardTo target "${t}" requires params [${d.join(", ")}] that are not available in source route "${e}"`)}function Ie(e,t,r){const n=Ne(e),o=Ae(e),a={...t};for(const[e,t]of o)a[e]=t;for(const[t,a]of o)$e(t,a,e,n,r);for(const e of Object.keys(a))_e(e,a)}function Pe(e,t){e.canActivate&&t.canActivate(e.name,e.canActivate)}function _e(e,t,r=100){const n=new Set,o=[e];let a=e;for(;t[a];){const e=t[a];if(n.has(e)){const t=o.indexOf(e),r=[...o.slice(t),e];throw new Error(`Circular forwardTo: ${r.join(" → ")}`)}if(n.add(a),o.push(e),a=e,o.length>r)throw new Error(`forwardTo chain exceeds maximum depth (${r}): ${o.join(" → ")}`)}return a}function je(e){const{forwardMap:t}=fe(e),r={};for(const e of Object.keys(t))r[e]=_e(e,t);de(e,r)}function ke(e,r){e.forwardTo&&(e.canActivate&&t.logger.warn("real-router",`Route "${e.name}" has both forwardTo and canActivate. canActivate will be ignored because forwardTo creates a redirect (industry standard). Move canActivate to the target route "${e.forwardTo}".`),fe(r).forwardMap[e.name]=e.forwardTo)}function De(e,t){const r=fe(t);e.decodeParams&&(r.decoders[e.name]=t=>e.decodeParams?.(t)??t),e.encodeParams&&(r.encoders[e.name]=t=>e.encodeParams?.(t)??t)}function Ce(e,t){e.defaultParams&&(fe(t).defaultParams[e.name]=e.defaultParams)}function xe(e,t,r=""){for(const n of e){const e=r?`${r}.${n.name}`:n.name,o={...n,name:e};Pe(o,t),ke(o,t),De(o,t),Ce(o,t),n.children&&xe(n.children,t,e)}}function Le(e,t){for(const r of Object.keys(e))t(r)&&delete e[r]}function Me(e){const t={name:e.name,path:e.path};return e.children&&(t.children=e.children.map(e=>Me(e))),t}function Ue(e,t,r=""){for(let n=0;n<e.length;n++){const o=e[n],a=r?`${r}.${o.name}`:o.name;if(a===t)return e.splice(n,1),!0;if(o.children&&t.startsWith(`${a}.`)&&Ue(o.children,t,a))return!0}return!1}function Fe(e,t,r){void 0!==r&&(null===r?delete e[t]:e[t]=r)}var qe=new Set;function We(n){return n.isActiveRoute=(r,o={},a=!1,i=!0)=>{if(qe.has(r)||(e.validateRouteName(r,"isActiveRoute"),qe.add(r)),function(t){if(!e.isParams(t))throw new TypeError(`[router.isActiveRoute] Invalid params structure: ${e.getTypeDescription(t)}`)}(o),void 0!==a&&"boolean"!=typeof a)throw new TypeError("[router.isActiveRoute] strictEquality must be a boolean, got "+typeof a);if(void 0!==i&&"boolean"!=typeof i)throw new TypeError("[router.isActiveRoute] ignoreQueryParams must be a boolean, got "+typeof i);if(""===r)return t.logger.warn("real-router",'isActiveRoute("") called with empty string. The root node is not considered active for any named route. To check if router has active state, use: router.getState() !== undefined'),!1;const s=n.getState();if(!s)return!1;const c=s.name;if(c!==r&&!c.startsWith(`${r}.`)&&!r.startsWith(`${c}.`))return!1;const u=fe(n).defaultParams[r];if(a||c===r){const e=u?{...u,...o}:o;return n.areStatesEqual({name:r,params:e,path:""},s,i)}const d=s.params;return!!function(e,t){for(const r in e)if(e[r]!==t[r])return!1;return!0}(o,d)&&(!u||function(e,t,r){for(const n in e)if(!(n in r)&&e[n]!==t[n])return!1;return!0}(u,d,o))},n.shouldUpdateNode=t=>{if(!e.isString(t))throw new TypeError("[router.shouldUpdateNode] nodeName must be a string, got "+typeof t);return(e,r)=>{if(!e||"object"!=typeof e||!("name"in e))throw new TypeError("[router.shouldUpdateNode] toState must be valid State object");if(e.meta?.options.reload)return!0;if(""===t&&!r)return!0;const{intersection:n,toActivate:o,toDeactivate:a}=z(e,r);return t===n||!!o.includes(t)||a.includes(t)}},n.clone=(e={})=>{const t=se(n),o=Je(r.routeTreeToDefinitions(t),n.getOptions(),e);o.useMiddleware(...n.getMiddlewareFactories()),o.usePlugin(...n.getPlugins());const a=fe(n);!function(e,t){e[s]=t}(o,{decoders:{...a.decoders},encoders:{...a.encoders},defaultParams:structuredClone(a.defaultParams),forwardMap:{...a.forwardMap}}),de(o,{...ue(n)});const[i,c]=n.getLifecycleFactories();for(const e of Object.keys(i))o.canDeactivate(e,i[e]);for(const e of Object.keys(c))o.canActivate(e,c[e]);return o},n}function ze(e){return null===e?"null":Array.isArray(e)?"array":typeof e}function Be(e,t){if(null!=e){if("function"!=typeof e)throw new TypeError(`[real-router] updateRoute: ${t} must be a function or null, got ${typeof e}`);if("AsyncFunction"===e.constructor.name)throw new TypeError(`[real-router] updateRoute: ${t} cannot be an async function`)}}function Ke(n){return a=>{const s=function(e){return t=>{const r=e=>e===t||e.startsWith(`${t}.`),n=fe(e);Le(n.decoders,r),Le(n.encoders,r),Le(n.defaultParams,r),Le(n.forwardMap,r),Le(n.forwardMap,e=>r(n.forwardMap[e]));const[o,a]=e.getLifecycleFactories();for(const t of Object.keys(a))r(t)&&e.clearCanActivate(t,!0);for(const t of Object.keys(o))r(t)&&e.clearCanDeactivate(t,!0)}}(a),c=(u=fe(a).forwardMap,(e,t,n,o)=>{const a=r.getSegmentsByName(o,t);if(!a)throw new Error(`[real-router] updateRoute: forwardTo target "${t}" does not exist`);const i=Se(n),s=[...Se(a)].filter(e=>!i.has(e));if(s.length>0)throw new Error(`[real-router] updateRoute: forwardTo target "${t}" requires params [${s.join(", ")}] that are not available in source route "${e}"`);u[e]=t});var u;a.forward=(e,n)=>{t.logger.warn("router.forward","Method is deprecated. Use `forwardTo` property in route configuration instead.");const o=se(a),i=r.getSegmentsByName(o,e);if(!i)throw new Error(`[real-router] forward: source route "${e}" does not exist`);const s=r.getSegmentsByName(o,n);if(!s)throw new Error(`[real-router] forward: target route "${n}" does not exist`);const c=Se(i),u=Se(s),d=[];for(const e of u)c.has(e)||d.push(e);if(d.length>0)throw new Error(`[real-router] forward: target route "${n}" requires params [${d.join(", ")}] that are not available in source route "${e}"`);return fe(a).forwardMap[e]=n,je(a),a};const d=a,f=n.map(e=>Me(e));function l(e,t=!1){ce(a,r.createRouteTree("",d[i],e,{skipValidation:t}))}function p(){return se(a)}return d[i]="",ce(a,r.createRouteTree("",d[i],f)),de(a,{}),d[o]=f,xe(n,a),je(a),a.addRoute=e=>{const t=Array.isArray(e)?[...e]:[e];!function(e){const t=new Set,n=new Map;for(const o of e)r.validateRoute(o,"addRoute",p(),"",t,n),Ee(o,o.name);Ie(e,fe(a).forwardMap,p())}(t);for(const e of t)f.push(Me(e));return xe(t,a),l(f,!0),je(a),a},a.removeRoute=r=>{e.validateRouteName(r,"removeRoute");const n=a.getState();if(n){const e=n.name,o=e===r,i=e.startsWith(`${r}.`);if(o||i)return t.logger.warn("router.removeRoute",`Cannot remove route "${r}" — it is currently active${o?"":` (current: "${e}")`}. Navigate away first.`),a}return a.isNavigating()&&t.logger.warn("router.removeRoute",`Route "${r}" removed while navigation is in progress. This may cause unexpected behavior.`),Ue(f,r)?(s(r),l(f,!0),je(a),a):(t.logger.warn("router.removeRoute",`Route "${r}" not found. No changes made.`),a)},a.clearRoutes=()=>{if(a.isNavigating())return t.logger.error("router.clearRoutes","Cannot clear routes while navigation is in progress. Wait for navigation to complete."),a;f.length=0;const e=fe(a);for(const t in e.decoders)delete e.decoders[t];for(const t in e.encoders)delete e.encoders[t];for(const t in e.defaultParams)delete e.defaultParams[t];for(const t in e.forwardMap)delete e.forwardMap[t];const[r,n]=a.getLifecycleFactories();for(const e in n)a.clearCanActivate(e,!0);for(const e in r)a.clearCanDeactivate(e,!0);return a.setState(void 0),l(f,!0),je(a),a},a.getRoute=t=>{e.validateRouteName(t,"getRoute");const n=p(),o=r.getSegmentsByName(n,t);if(!o)return;const i=o.at(-1),s=r.nodeToDefinition(i),[,c]=a.getLifecycleFactories(),u=function(e,t){const r=(n,o)=>{const a={name:n.name,path:n.path},i=e.forwardMap[o];return i&&(a.forwardTo=i),o in e.defaultParams&&(a.defaultParams=e.defaultParams[o]),o in e.decoders&&(a.decodeParams=e.decoders[o]),o in e.encoders&&(a.encodeParams=e.encoders[o]),o in t&&(a.canActivate=t[o]),n.children&&(a.children=n.children.map(e=>r(e,`${o}.${e.name}`))),a};return r}(fe(a),c);return u(s,t)},a.hasRoute=t=>{e.validateRouteName(t,"hasRoute");const n=p();return r.hasSegmentsByName(n,t)},a.updateRoute=(n,o)=>{e.validateRouteName(n,"updateRoute"),function(e){if(null===e||"object"!=typeof e||Array.isArray(e))throw new TypeError(`[real-router] updateRoute: updates must be an object, got ${ze(e)}`)}(o);const i=p(),s=r.getSegmentsByName(i,n);if(!s)throw new ReferenceError(`[real-router] updateRoute: route "${n}" does not exist`);a.isNavigating()&&t.logger.error("router.updateRoute",`Route "${n}" config modified while navigation is in progress. Changes will apply immediately and may affect the current transition.`);const u=fe(a),{forwardTo:d,defaultParams:f,decodeParams:l,encodeParams:m,canActivate:g}=o;return null!=d&&_e(n,{...u.forwardMap,[n]:d}),function(e){if(null!=e&&("object"!=typeof e||Array.isArray(e)))throw new TypeError(`[real-router] updateRoute: defaultParams must be an object or null, got ${ze(e)}`)}(f),Be(l,"decodeParams"),Be(m,"encodeParams"),void 0!==d&&(null===d?delete u.forwardMap[n]:c(n,d,s,i),je(a)),Fe(u.defaultParams,n,f),Fe(u.decoders,n,l),Fe(u.encoders,n,m),void 0!==g&&(null===g?a.clearCanActivate(n,!0):a.canActivate(n,g)),a},a}}function Ve(e,t){return e===t||!(!Array.isArray(e)||!Array.isArray(t))&&e.length===t.length&&e.every((e,r)=>Ve(e,t[r]))}function He(n){let o,a,i=0;const s=()=>se(n),c=new Map;return n.getState=()=>o,n.setState=t=>{void 0!==t&&e.validateState(t,"router.setState"),a=o,o=t?Object.isFrozen(t)?t:y(t):void 0},n.getPreviousState=()=>a,n.makeState=(t,r,o,a,s)=>{if(!e.isString(t))throw new TypeError(`[router.makeState] Invalid name: ${e.getTypeDescription(t)}. Expected string.`);if(void 0!==r&&!e.isParams(r))throw new TypeError(`[router.makeState] Invalid params: ${e.getTypeDescription(r)}. Expected plain object.`);if(void 0!==o&&!e.isString(o))throw new TypeError(`[router.makeState] Invalid path: ${e.getTypeDescription(o)}. Expected string.`);if(void 0!==s&&"number"!=typeof s)throw new TypeError(`[router.makeState] Invalid forceId: ${e.getTypeDescription(s)}. Expected number.`);const c=a?{...a,id:s??++i,params:a.params,options:a.options,redirected:a.redirected}:void 0,u=fe(n).defaultParams;let d;return d=Object.hasOwn(u,t)?{...u[t],...r}:r?{...r}:{},y({name:t,params:d,path:o??n.buildPath(t,r),meta:c})},n.makeNotFoundState=(t,r)=>{if(!e.isString(t))throw new TypeError(`[router.makeNotFoundState] Invalid path: ${e.getTypeDescription(t)}. Expected string.`);if(void 0!==r&&!e.isNavigationOptions(r))throw new TypeError(`[router.makeNotFoundState] Invalid options: ${e.getTypeDescription(r)}. Expected NavigationOptions object.`);return n.makeState(u.UNKNOWN_ROUTE,{path:t},t,r?{options:r,params:{},redirected:!1}:void 0)},n.areStatesEqual=(e,t,n=!0)=>{if(!e||!t)return!!e==!!t;if(e.name!==t.name)return!1;if(n){const n=e.meta?.params??t.meta?.params;return(n?function(e){const t=[];for(const r in e){const n=e[r];for(const e in n)"url"===n[e]&&t.push(e)}return t}(n):(e=>{const t=c.get(e);if(void 0!==t)return t;const n=r.getSegmentsByName(s(),e);if(!n)return c.set(e,[]),[];const o=n.flatMap(e=>e.parser?e.parser.urlParams:[]);return c.set(e,o),o})(e.name)).every(r=>Ve(e.params[r],t.params[r]))}const o=Object.keys(e.params),a=Object.keys(t.params);return o.length===a.length&&o.every(r=>r in t.params&&Ve(e.params[r],t.params[r]))},n.areStatesDescendants=(r,n)=>(e.validateState(r,"areStatesDescendants"),e.validateState(n,"areStatesDescendants"),t.logger.warn("real-router","areStatesDescendants is deprecated and will be removed in the next major version. Use router.isActiveRoute() instead."),!!n.name.startsWith(`${r.name}.`)&&Object.keys(r.params).every(e=>Ve(r.params[e],n.params[e]))),n.forwardState=(t,r)=>{if(!e.isString(t))throw new TypeError(`[router.forwardState] Invalid routeName: ${e.getTypeDescription(t)}. Expected string.`);if(!e.isParams(r))throw new TypeError(`[router.forwardState] Invalid routeParams: ${e.getTypeDescription(r)}. Expected plain object.`);const o=ue(n)[t]??t,{defaultParams:a}=fe(n),i=Object.hasOwn(a,t),s=Object.hasOwn(a,o);let c;return c=i&&s?{...a[t],...a[o],...r}:i?{...a[t],...r}:s?{...a[o],...r}:r,{name:o,params:c}},n.buildState=(t,o)=>{if(!e.isString(t))throw new TypeError(`[router.buildState] Invalid routeName: ${e.getTypeDescription(t)}. Expected string.`);if(!e.isParams(o))throw new TypeError(`[router.buildState] Invalid routeParams: ${e.getTypeDescription(o)}. Expected plain object.`);const{name:a,params:i}=n.forwardState(t,o),c=r.getSegmentsByName(s(),a);if(c)return le({segments:c,params:i},a)},n.buildStateWithSegments=(t,o)=>{if(!e.isString(t))throw new TypeError(`[router.buildStateWithSegments] Invalid routeName: ${e.getTypeDescription(t)}. Expected string.`);if(!e.isParams(o))throw new TypeError(`[router.buildStateWithSegments] Invalid routeParams: ${e.getTypeDescription(o)}. Expected plain object.`);const{name:a,params:i}=n.forwardState(t,o),c=r.getSegmentsByName(s(),a);if(c)return{state:le({segments:c,params:i},a),segments:c}},n}var Ge=new Set(["all","warn-error","error-only"]);var Je=(r=[],n={},o={})=>{n.logger&&function(e){if("object"!=typeof e||null===e)throw new TypeError("Logger config must be an object");const t=e;for(const e of Object.keys(t))if("level"!==e&&"callback"!==e)throw new TypeError(`Unknown logger config property: "${e}"`);if("level"in t&&void 0!==t.level&&("string"!=typeof(r=t.level)||!Ge.has(r)))throw new TypeError(`Invalid logger level: ${function(e){return"string"==typeof e?`"${e}"`:"object"==typeof e?JSON.stringify(e):String(e)}(t.level)}. Expected: "all" | "warn-error" | "error-only"`);var r;if("callback"in t&&void 0!==t.callback&&"function"!=typeof t.callback)throw new TypeError("Logger callback must be a function, got "+typeof t.callback);return!0}(n.logger)&&(t.logger.configure(n.logger),delete n.logger);const a={[s]:{decoders:{},encoders:{},defaultParams:{},forwardMap:{}}};return((...e)=>t=>e.reduce((e,t)=>t(e),t))(function(t){return r=>{for(const[r,n]of Object.entries(t)){if(!e.isObjKey(r,Y))throw new TypeError(`[router.options] Unknown option: "${r}"`);void 0!==n&&X(r,n,Y[r],"withOptions")}let n=ee({...Y,...t});return r.getOptions=()=>n,r.setOption=(t,o)=>{if(!e.isString(t))throw new TypeError("[router.setOption]: option name must be a string, got "+typeof t);if(r.isStarted()&&"defaultRoute"!==t&&"defaultParams"!==t)throw new Error("[router.setOption] Options cannot be changed after router.start(). Only defaultRoute/defaultParams can be changed after start.");if(!Object.hasOwn(n,t))throw new ReferenceError(`[router.setOption]: option "${t}" not found`);X(t,o,Y[t],"setOption");const a=o&&"object"==typeof o&&o.constructor===Object?{...o}:o;return n=ee({...n,[t]:a}),r},r}}(n),function(r){const n=r=>{if(!r||"object"!=typeof r||r.constructor!==Object)throw new TypeError(`[router.setDependencies] Invalid argument: expected plain object, received ${e.getTypeDescription(r)}`);for(const e in r)if(Object.getOwnPropertyDescriptor(r,e)?.get)throw new TypeError(`[router.setDependencies] Getters not allowed: "${e}"`);A({...o,...r},"setDependencies");const n=[];for(const e in r)void 0!==r[e]&&(Object.hasOwn(o,e)&&n.push(e),o[e]=r[e]);n.length>0&&t.logger.warn("router.setDependencies","Overwritten:",n.join(", "))},o=Object.create(null);return n(r),r=>(r.setDependency=(e,n)=>{if(void 0===n)return r;if(N("setDependency",e),Object.hasOwn(o,e)){const r=o[e],a=r!==n,i=Number.isNaN(r)&&Number.isNaN(n);a&&!i&&t.logger.warn("router.setDependency","Router dependency already exists and is being overwritten:",e)}else A(o,"setDependency");return o[e]=n,r},r.setDependencies=e=>(n(e),r),r.getDependency=e=>{N("getDependency",e);const t=o[e];if(void 0===t)throw new ReferenceError(`[router.getDependency]: dependency "${String(e)}" not found`);return t},r.getDependencies=()=>({...o}),r.removeDependency=n=>(Object.hasOwn(o,n)||t.logger.warn("router.removeDependency",`Attempted to remove non-existent dependency: "${e.getTypeDescription(n)}"`),delete o[n],r),r.hasDependency=e=>Object.hasOwn(o,e),r.resetDependencies=()=>{for(const e in o)delete o[e];return r},r)}(o),J,He,Te,ie,H,oe,P,function(e){return t=>[Ke(e),me,We].reduce((e,t)=>t(e),t)}(r))(a)};exports.RouterError=O,exports.constants=u,exports.createRouter=Je,exports.errorCodes=c,exports.events=h;//# sourceMappingURL=index.js.map
|