@real-router/core 0.80.0 → 0.81.0

package/dist/cjs/Router.js

@@ -1,2 +1,2 @@
-const e=require("./constants.js"),t=require("./foundation/event-emitter/EventEmitter.js"),n=require("./foundation/logger/RouterLogger.js"),r=require("./guards.js"),i=require("./helpers.js"),a=require("./internals.js"),o=require("./namespaces/DependenciesNamespace/dependenciesStore.js"),s=require("./namespaces/OptionsNamespace/OptionsNamespace.js"),c=require("./namespaces/StateNamespace/StateNamespace.js"),l=require("./namespaces/PluginsNamespace/PluginsNamespace.js"),u=require("./namespaces/RouteLifecycleNamespace/RouteLifecycleNamespace.js"),d=require("./transitionPath.js"),f=require("./namespaces/RoutesNamespace/RoutesNamespace.js"),p=require("./RouterError.js"),m=require("./namespaces/NavigationNamespace/NavigationNamespace.js"),h=require("./namespaces/RouterLifecycleNamespace/RouterLifecycleNamespace.js"),g=require("./routerFSM.js"),_=require("./namespaces/EventBusNamespace/EventBusNamespace.js"),v=require("./namespaces/RouterLifecycleNamespace/constants.js"),y=require("./wiring/wireNamespaces.js"),b=Object.freeze({}),x=new Set([e.errorCodes.SAME_STATES,e.errorCodes.TRANSITION_CANCELLED,e.errorCodes.ROUTER_NOT_STARTED,e.errorCodes.ROUTE_NOT_FOUND,e.errorCodes.CANNOT_ACTIVATE,e.errorCodes.CANNOT_DEACTIVATE]);var S=class S{#e;#t;#n;#r;#i;#a;#o;#s;#c;#l;#u;#d;constructor(d=[],p={},v={}){let{logger:x,...C}=p;x&&r.assertLoggerConfig(x);let T=new n.RouterLogger(x);this.#u=e=>{S.#f(e)||T.error(`router.navigate`,`Unexpected navigation error`,e)},this.#d=e=>{S.#f(e)||T.error(`router.start`,`Unexpected start error`,e)},s.OptionsNamespace.validateOptionsIsObject(p),r.guardDependencies(v),d.length>0&&r.guardRouteStructure(d),this.#e=new s.OptionsNamespace(C),this.#t=i.createLimits(C.limits),this.#n=o.createDependenciesStore(v),this.#r=new c.StateNamespace,this.#i=new f.RoutesNamespace(d,w(this.#e.get()),T),this.#a=new u.RouteLifecycleNamespace,this.#o=new l.PluginsNamespace,this.#s=new m.NavigationNamespace,this.#c=new h.RouterLifecycleNamespace;let E=g.createRouterFSM(),D=new t.EventEmitter({onListenerError:(e,t)=>{T.error(`Router`,`Error in listener for ${e}:`,t)},onListenerWarn:(e,t)=>{T.warn(`router.addEventListener`,`Event "${e}" has ${t} listeners — possible memory leak`)}});this.#l=new _.EventBusNamespace({routerFSM:E,emitter:D,abortController:e=>{this.#s.abortCurrentController(e)}});let O=new Map;a.registerInternals(this,{logger:T,makeState:(e,t,n,r)=>this.#r.makeState(e,t,n,r),forwardState:a.createBinaryInterceptable(`forwardState`,(e,t)=>this.#i.forwardState(e,t),O),buildStateResolved:(e,t)=>this.#i.buildStateResolved(e,t),matchPath:(e,t)=>this.#i.matchPath(e,t),getOptions:()=>this.#e.get(),addEventListener:(e,t)=>this.#l.addEventListener(e,t),treeChanged:{emit:e=>{this.#l.emitTreeChanged(e)},subscribe:e=>this.#l.subscribeTreeChanged(e),listenerCount:()=>this.#l.treeChangedListenerCount(),isEmitting:()=>this.#l.isEmittingTreeChanged()},buildPath:a.createBinaryInterceptable(`buildPath`,(t,n)=>this.#i.buildPath(t,n??e.EMPTY_PARAMS,this.#e.get()),O),emitTransitionError:e=>{this.#l.sendFailSafe(void 0,this.#r.get(),e)},emitTransitionSuccess:(e,t,n)=>{this.#l.emitTransitionSuccess(e,t,n)},navigateToNotFound:e=>this.#s.navigateToNotFound(e),start:a.createInterceptable(`start`,e=>this.#c.start(e),O),navigateToState:(e,t)=>{this.#m();let n=this.#s.navigateToState(e,t??b);return this.#s.lastSyncResolved?this.#s.lastSyncResolved=!1:this.#s.lastSyncRejected?this.#s.lastSyncRejected=!1:this.#p(n),n},interceptors:O,setRootPath:e=>{this.#i.setRootPath(e)},getRootPath:()=>this.#i.getStore().rootPath,getTree:()=>this.#i.getStore().tree,isDisposed:()=>this.#l.isDisposed(),validator:null,dependenciesGetStore:()=>this.#n,getCloneState:()=>({options:{...this.#e.get()},dependencies:{...this.#n.dependencies},pluginFactories:this.#o.getAll(),loggerConfig:T.getConfig()}),routeGetStore:()=>this.#i.getStore(),getStateName:()=>this.#r.get()?.name,isTransitioning:()=>this.#l.isTransitioning(),clearState:()=>{this.#r.set(void 0)},setState:e=>{this.#r.set(e)},routerExtensions:[],contextClaimRecords:new Set,hydrationState:null}),y.wireNamespaces({router:this,options:this.#e,limits:this.#t,dependenciesStore:this.#n,state:this.#r,routes:this.#i,routeLifecycle:this.#a,plugins:this.#o,navigation:this.#s,lifecycle:this.#c,eventBus:this.#l}),this.isActiveRoute=this.isActiveRoute.bind(this),this.buildPath=this.buildPath.bind(this),this.getState=this.getState.bind(this),this.getPreviousState=this.getPreviousState.bind(this),this.areStatesEqual=this.areStatesEqual.bind(this),this.shouldUpdateNode=this.shouldUpdateNode.bind(this),this.isActive=this.isActive.bind(this),this.start=this.start.bind(this),this.stop=this.stop.bind(this),this.dispose=this.dispose.bind(this),this.canNavigateTo=this.canNavigateTo.bind(this),this.usePlugin=this.usePlugin.bind(this),this.navigate=this.navigate.bind(this),this.navigateToDefault=this.navigateToDefault.bind(this),this.navigateToNotFound=this.navigateToNotFound.bind(this),this.subscribe=this.subscribe.bind(this),this.subscribeLeave=this.subscribeLeave.bind(this),this.isLeaveApproved=this.isLeaveApproved.bind(this);try{this.#i.flushPendingGuards()}catch(e){throw this.dispose(),e}}isActiveRoute(e,t,n,r){return a.getInternals(this).validator?.routes.validateIsActiveRouteArgs(e,t,n,r),a.getInternals(this).validator?.routes.validateRouteName(e,`isActiveRoute`),e===``?(a.getInternals(this).logger.warn(`real-router`,`isActiveRoute("") called with empty string. Root node is not considered a parent of any route.`),!1):this.#i.isActiveRoute(e,t,n,r)}buildPath(e,t){let n=a.getInternals(this);return n.validator?.routes.validateBuildPathArgs(e),n.validator?.navigation.validateParams(t,`buildPath`),n.buildPath(e,i.normalizeParams(t))}getState(){return this.#r.get()}getPreviousState(){return this.#r.getPrevious()}areStatesEqual(e,t,n=!0){return a.getInternals(this).validator?.state.validateAreStatesEqualArgs(e,t,n),this.#r.areStatesEqual(e,t,n)}shouldUpdateNode(e){return a.getInternals(this).validator?.routes.validateShouldUpdateNodeArgs(e),f.RoutesNamespace.shouldUpdateNode(e)}isActive(){return this.#l.isActive()}start(e){if(!this.#l.canStart())return Promise.reject(v.CACHED_ALREADY_STARTED_ERROR);a.getInternals(this).validator?.navigation.validateStartArgs(e),this.#l.sendStart();let t;try{let n=a.getInternals(this).start(e);t=typeof n?.then==`function`?n:Promise.reject(TypeError("[router.start] a `start` interceptor returned without calling next(). Every start interceptor must return `next(path)`."))}catch(e){t=Promise.reject(e)}let n=t.catch(e=>this.#h(e));return this.#p(n,this.#d),n}stop(){return this.#l.sendCancelIfPossible(this.#r.get()),!this.#l.isReady()&&!this.#l.isTransitioning()&&!this.#l.isStarting()?this:(this.#c.stop(),this.#l.sendStop(),this)}dispose(){if(this.#l.isDisposed())return;this.#l.sendCancelIfPossible(this.#r.get()),(this.#l.isReady()||this.#l.isTransitioning())&&(this.#c.stop(),this.#l.sendStop()),this.#l.sendDispose(),this.#l.clearAll(),this.#o.disposeAll();let e=a.getInternals(this);for(let t of e.routerExtensions)for(let e of t.keys)delete this[e];e.routerExtensions.length=0,e.contextClaimRecords.clear(),e.interceptors.clear(),this.#i.clearRoutes(),this.#a.clearAll(),this.#r.reset(),this.#n.dependencies=Object.create(null),this.#g()}canNavigateTo(e,t){let n=a.getInternals(this);if(n.validator?.routes.validateRouteName(e,`canNavigateTo`),n.validator?.navigation.validateParams(t,`canNavigateTo`),!this.#i.hasRoute(e))return!1;let{name:r,params:o}=n.forwardState(e,t??{}),s;try{let e=i.normalizeParams(o),t=this.#i.getMetaForState(r),a=n.buildPath(r,e);s=this.#r.makeState(r,e,a,t,!0)}catch{return!1}let c=this.#r.get(),{toDeactivate:l,toActivate:u}=d.getTransitionPath(s,c);return this.#a.canNavigateTo(l,u,s,c)}usePlugin(...t){if(this.#l.isDisposed())throw new p.RouterError(e.errorCodes.ROUTER_DISPOSED);let n=t.filter(Boolean);if(n.length===0)return()=>{};let r=a.getInternals(this);r.validator?.plugins.validatePluginLimit(this.#o.count(),this.#t);for(let e of n)r.validator?.plugins.validateNoDuplicatePlugins(e,this.#o.getAll());return this.#o.use(...n)}subscribe(e){return _.EventBusNamespace.validateSubscribeListener(e),this.#l.subscribe(e)}subscribeLeave(e){return _.EventBusNamespace.validateSubscribeLeaveListener(e),this.#l.subscribeLeave(e)}isLeaveApproved(){return this.#l.isLeaveApproved()}navigate(t,n,r){this.#m();let i=a.getInternals(this);i.validator?.navigation.validateNavigateArgs(t),i.validator?.navigation.validateParams(n,`navigate`);let o=r??b;i.validator?.navigation.validateNavigationOptions(o,`navigate`);let s=this.#s.navigate(t,n??e.EMPTY_PARAMS,o);return this.#s.lastSyncResolved?this.#s.lastSyncResolved=!1:this.#s.lastSyncRejected?this.#s.lastSyncRejected=!1:this.#p(s),s}navigateToDefault(e){this.#m();let t=a.getInternals(this);t.validator?.navigation.validateNavigateToDefaultArgs(e);let n=e??b;t.validator?.navigation.validateNavigationOptions(n,`navigateToDefault`);let r=this.#s.navigateToDefault(n);return this.#s.lastSyncResolved?this.#s.lastSyncResolved=!1:this.#s.lastSyncRejected?this.#s.lastSyncRejected=!1:this.#p(r),r}navigateToNotFound(t){if(this.#m(),!this.#l.isActive())throw new p.RouterError(e.errorCodes.ROUTER_NOT_STARTED);if(t!==void 0&&typeof t!=`string`)throw TypeError(`[router.navigateToNotFound] path must be a string, got ${typeof t}`);if(t!==void 0)return this.#s.navigateToNotFound(t);let n=this.#r.get();if(n===void 0)throw new p.RouterError(e.errorCodes.ROUTER_NOT_STARTED,{message:`[router.navigateToNotFound] cannot derive the path before the start navigation commits — pass an explicit path`});return this.#s.navigateToNotFound(n.path)}static#f(e){return e instanceof p.RouterError&&x.has(e.code)}#p(e,t=this.#u){e.catch(t)}#m(){if(this.#l.isProcessing())throw new p.RouterError(e.errorCodes.REENTRANT_NAVIGATION)}#h(e){throw this.#l.isReady()&&this.#r.get()===void 0?(this.#c.stop(),this.#l.sendStop()):this.#l.isStarting()&&this.#l.sendFail(void 0,void 0,e),e}#g(){this.navigate=C,this.navigateToDefault=C,this.navigateToNotFound=C,this.start=C,this.stop=C,this.usePlugin=C,this.subscribe=C,this.subscribeLeave=C,this.canNavigateTo=C}};function C(){throw new p.RouterError(e.errorCodes.ROUTER_DISPOSED)}function w(e){return{strictTrailingSlash:e.trailingSlash===`strict`,caseSensitive:e.caseSensitive,strictQueryParams:e.queryParamsMode===`strict`,urlParamsEncoding:e.urlParamsEncoding,queryParams:e.queryParams}}exports.Router=S;
+const e=require("./constants.js"),t=require("./guards.js"),n=require("./helpers.js"),r=require("./internals.js"),i=require("./namespaces/DependenciesNamespace/dependenciesStore.js"),a=require("./namespaces/OptionsNamespace/OptionsNamespace.js"),o=require("./namespaces/StateNamespace/StateNamespace.js"),s=require("./namespaces/PluginsNamespace/PluginsNamespace.js"),c=require("./namespaces/RouteLifecycleNamespace/RouteLifecycleNamespace.js"),l=require("./transitionPath.js"),u=require("./namespaces/RoutesNamespace/RoutesNamespace.js"),d=require("./RouterError.js"),f=require("./namespaces/NavigationNamespace/NavigationNamespace.js"),p=require("./namespaces/RouterLifecycleNamespace/RouterLifecycleNamespace.js"),m=require("./routerFSM.js"),h=require("./namespaces/EventBusNamespace/EventBusNamespace.js"),g=require("./namespaces/RouterLifecycleNamespace/constants.js"),_=require("./utils/event-emitter/EventEmitter.js"),v=require("./utils/logger/RouterLogger.js"),y=require("./wiring/wireNamespaces.js"),b=Object.freeze({}),x=new Set([e.errorCodes.SAME_STATES,e.errorCodes.TRANSITION_CANCELLED,e.errorCodes.ROUTER_NOT_STARTED,e.errorCodes.ROUTE_NOT_FOUND,e.errorCodes.CANNOT_ACTIVATE,e.errorCodes.CANNOT_DEACTIVATE]);var S=class S{#e;#t;#n;#r;#i;#a;#o;#s;#c;#l;#u;#d;constructor(l=[],d={},g={}){let{logger:x,...C}=d;x&&t.assertLoggerConfig(x);let T=new v.RouterLogger(x);this.#u=e=>{S.#f(e)||T.error(`router.navigate`,`Unexpected navigation error`,e)},this.#d=e=>{S.#f(e)||T.error(`router.start`,`Unexpected start error`,e)},a.OptionsNamespace.validateOptionsIsObject(d),t.guardDependencies(g),l.length>0&&t.guardRouteStructure(l),this.#e=new a.OptionsNamespace(C),this.#t=n.createLimits(C.limits),this.#n=i.createDependenciesStore(g),this.#r=new o.StateNamespace,this.#i=new u.RoutesNamespace(l,w(this.#e.get()),T),this.#a=new c.RouteLifecycleNamespace,this.#o=new s.PluginsNamespace,this.#s=new f.NavigationNamespace,this.#c=new p.RouterLifecycleNamespace;let E=m.createRouterFSM(),D=new _.EventEmitter({onListenerError:(e,t)=>{T.error(`Router`,`Error in listener for ${e}:`,t)},onListenerWarn:(e,t)=>{T.warn(`router.addEventListener`,`Event "${e}" has ${t} listeners — possible memory leak`)}});this.#l=new h.EventBusNamespace({routerFSM:E,emitter:D,abortController:e=>{this.#s.abortCurrentController(e)}});let O=new Map;r.registerInternals(this,{logger:T,makeState:(e,t,n,r)=>this.#r.makeState(e,t,n,r),forwardState:r.createBinaryInterceptable(`forwardState`,(e,t)=>this.#i.forwardState(e,t),O),buildStateResolved:(e,t)=>this.#i.buildStateResolved(e,t),matchPath:(e,t)=>this.#i.matchPath(e,t),getOptions:()=>this.#e.get(),addEventListener:(e,t)=>this.#l.addEventListener(e,t),treeChanged:{emit:e=>{this.#l.emitTreeChanged(e)},subscribe:e=>this.#l.subscribeTreeChanged(e),listenerCount:()=>this.#l.treeChangedListenerCount(),isEmitting:()=>this.#l.isEmittingTreeChanged()},buildPath:r.createBinaryInterceptable(`buildPath`,(t,n)=>this.#i.buildPath(t,n??e.EMPTY_PARAMS,this.#e.get()),O),emitTransitionError:e=>{this.#l.sendFailSafe(void 0,this.#r.get(),e)},emitTransitionSuccess:(e,t,n)=>{this.#l.emitTransitionSuccess(e,t,n)},navigateToNotFound:e=>this.#s.navigateToNotFound(e),start:r.createInterceptable(`start`,e=>this.#c.start(e),O),navigateToState:(e,t)=>{this.#m();let n=this.#s.navigateToState(e,t??b);return this.#s.lastSyncResolved?this.#s.lastSyncResolved=!1:this.#s.lastSyncRejected?this.#s.lastSyncRejected=!1:this.#p(n),n},interceptors:O,setRootPath:e=>{this.#i.setRootPath(e)},getRootPath:()=>this.#i.getStore().rootPath,getTree:()=>this.#i.getStore().tree,isDisposed:()=>this.#l.isDisposed(),validator:null,dependenciesGetStore:()=>this.#n,getCloneState:()=>({options:{...this.#e.get()},dependencies:{...this.#n.dependencies},pluginFactories:this.#o.getAll(),loggerConfig:T.getConfig()}),routeGetStore:()=>this.#i.getStore(),getStateName:()=>this.#r.get()?.name,isTransitioning:()=>this.#l.isTransitioning(),clearState:()=>{this.#r.set(void 0)},setState:e=>{this.#r.set(e)},routerExtensions:[],contextClaimRecords:new Set,hydrationState:null}),y.wireNamespaces({router:this,options:this.#e,limits:this.#t,dependenciesStore:this.#n,state:this.#r,routes:this.#i,routeLifecycle:this.#a,plugins:this.#o,navigation:this.#s,lifecycle:this.#c,eventBus:this.#l}),this.isActiveRoute=this.isActiveRoute.bind(this),this.buildPath=this.buildPath.bind(this),this.getState=this.getState.bind(this),this.getPreviousState=this.getPreviousState.bind(this),this.areStatesEqual=this.areStatesEqual.bind(this),this.shouldUpdateNode=this.shouldUpdateNode.bind(this),this.isActive=this.isActive.bind(this),this.start=this.start.bind(this),this.stop=this.stop.bind(this),this.dispose=this.dispose.bind(this),this.canNavigateTo=this.canNavigateTo.bind(this),this.usePlugin=this.usePlugin.bind(this),this.navigate=this.navigate.bind(this),this.navigateToDefault=this.navigateToDefault.bind(this),this.navigateToNotFound=this.navigateToNotFound.bind(this),this.subscribe=this.subscribe.bind(this),this.subscribeLeave=this.subscribeLeave.bind(this),this.isLeaveApproved=this.isLeaveApproved.bind(this);try{this.#i.flushPendingGuards()}catch(e){throw this.dispose(),e}}isActiveRoute(e,t,n,i){return r.getInternals(this).validator?.routes.validateIsActiveRouteArgs(e,t,n,i),r.getInternals(this).validator?.routes.validateRouteName(e,`isActiveRoute`),e===``?(r.getInternals(this).logger.warn(`real-router`,`isActiveRoute("") called with empty string. Root node is not considered a parent of any route.`),!1):this.#i.isActiveRoute(e,t,n,i)}buildPath(e,t){let i=r.getInternals(this);return i.validator?.routes.validateBuildPathArgs(e),i.validator?.navigation.validateParams(t,`buildPath`),i.buildPath(e,n.normalizeParams(t))}getState(){return this.#r.get()}getPreviousState(){return this.#r.getPrevious()}areStatesEqual(e,t,n=!0){return r.getInternals(this).validator?.state.validateAreStatesEqualArgs(e,t,n),this.#r.areStatesEqual(e,t,n)}shouldUpdateNode(e){return r.getInternals(this).validator?.routes.validateShouldUpdateNodeArgs(e),u.RoutesNamespace.shouldUpdateNode(e)}isActive(){return this.#l.isActive()}start(e){if(!this.#l.canStart())return Promise.reject(g.CACHED_ALREADY_STARTED_ERROR);r.getInternals(this).validator?.navigation.validateStartArgs(e),this.#l.sendStart();let t;try{let n=r.getInternals(this).start(e);t=typeof n?.then==`function`?n:Promise.reject(TypeError("[router.start] a `start` interceptor returned without calling next(). Every start interceptor must return `next(path)`."))}catch(e){t=Promise.reject(e)}let n=t.catch(e=>this.#h(e));return this.#p(n,this.#d),n}stop(){return this.#l.sendCancelIfPossible(this.#r.get()),!this.#l.isReady()&&!this.#l.isTransitioning()&&!this.#l.isStarting()?this:(this.#c.stop(),this.#l.sendStop(),this)}dispose(){if(this.#l.isDisposed())return;this.#l.sendCancelIfPossible(this.#r.get()),(this.#l.isReady()||this.#l.isTransitioning())&&(this.#c.stop(),this.#l.sendStop()),this.#l.sendDispose(),this.#l.clearAll(),this.#o.disposeAll();let e=r.getInternals(this);for(let t of e.routerExtensions)for(let e of t.keys)delete this[e];e.routerExtensions.length=0,e.contextClaimRecords.clear(),e.interceptors.clear(),this.#i.clearRoutes(),this.#a.clearAll(),this.#r.reset(),this.#n.dependencies=Object.create(null),this.#g()}canNavigateTo(e,t){let i=r.getInternals(this);if(i.validator?.routes.validateRouteName(e,`canNavigateTo`),i.validator?.navigation.validateParams(t,`canNavigateTo`),!this.#i.hasRoute(e))return!1;let{name:a,params:o}=i.forwardState(e,t??{}),s;try{let e=n.normalizeParams(o),t=this.#i.getMetaForState(a),r=i.buildPath(a,e);s=this.#r.makeState(a,e,r,t,!0)}catch{return!1}let c=this.#r.get(),{toDeactivate:u,toActivate:d}=l.getTransitionPath(s,c);return this.#a.canNavigateTo(u,d,s,c)}usePlugin(...t){if(this.#l.isDisposed())throw new d.RouterError(e.errorCodes.ROUTER_DISPOSED);let n=t.filter(Boolean);if(n.length===0)return()=>{};let i=r.getInternals(this);i.validator?.plugins.validatePluginLimit(this.#o.count(),this.#t);for(let e of n)i.validator?.plugins.validateNoDuplicatePlugins(e,this.#o.getAll());return this.#o.use(...n)}subscribe(e){return h.EventBusNamespace.validateSubscribeListener(e),this.#l.subscribe(e)}subscribeLeave(e){return h.EventBusNamespace.validateSubscribeLeaveListener(e),this.#l.subscribeLeave(e)}isLeaveApproved(){return this.#l.isLeaveApproved()}navigate(t,n,i){this.#m();let a=r.getInternals(this);a.validator?.navigation.validateNavigateArgs(t),a.validator?.navigation.validateParams(n,`navigate`);let o=i??b;a.validator?.navigation.validateNavigationOptions(o,`navigate`);let s=this.#s.navigate(t,n??e.EMPTY_PARAMS,o);return this.#s.lastSyncResolved?this.#s.lastSyncResolved=!1:this.#s.lastSyncRejected?this.#s.lastSyncRejected=!1:this.#p(s),s}navigateToDefault(e){this.#m();let t=r.getInternals(this);t.validator?.navigation.validateNavigateToDefaultArgs(e);let n=e??b;t.validator?.navigation.validateNavigationOptions(n,`navigateToDefault`);let i=this.#s.navigateToDefault(n);return this.#s.lastSyncResolved?this.#s.lastSyncResolved=!1:this.#s.lastSyncRejected?this.#s.lastSyncRejected=!1:this.#p(i),i}navigateToNotFound(t){if(this.#m(),!this.#l.isActive())throw new d.RouterError(e.errorCodes.ROUTER_NOT_STARTED);if(t!==void 0&&typeof t!=`string`)throw TypeError(`[router.navigateToNotFound] path must be a string, got ${typeof t}`);if(t!==void 0)return this.#s.navigateToNotFound(t);let n=this.#r.get();if(n===void 0)throw new d.RouterError(e.errorCodes.ROUTER_NOT_STARTED,{message:`[router.navigateToNotFound] cannot derive the path before the start navigation commits — pass an explicit path`});return this.#s.navigateToNotFound(n.path)}static#f(e){return e instanceof d.RouterError&&x.has(e.code)}#p(e,t=this.#u){e.catch(t)}#m(){if(this.#l.isProcessing())throw new d.RouterError(e.errorCodes.REENTRANT_NAVIGATION)}#h(e){throw this.#l.isReady()&&this.#r.get()===void 0?(this.#c.stop(),this.#l.sendStop()):this.#l.isStarting()&&this.#l.sendFail(void 0,void 0,e),e}#g(){this.navigate=C,this.navigateToDefault=C,this.navigateToNotFound=C,this.start=C,this.stop=C,this.usePlugin=C,this.subscribe=C,this.subscribeLeave=C,this.canNavigateTo=C}};function C(){throw new d.RouterError(e.errorCodes.ROUTER_DISPOSED)}function w(e){return{strictTrailingSlash:e.trailingSlash===`strict`,caseSensitive:e.caseSensitive,strictQueryParams:e.queryParamsMode===`strict`,urlParamsEncoding:e.urlParamsEncoding,queryParams:e.queryParams}}exports.Router=S;
 //# sourceMappingURL=Router.js.map

package/dist/cjs/Router.js.map

@@ -1 +1 @@
-{"version":3,"file":"Router.js","names":["errorCodes","#options","#limits","#dependenciesStore","#state","#routes","#routeLifecycle","#plugins","#navigation","#lifecycle","#eventBus","#onSuppressedNavigateError","#onSuppressedStartError","RouterLogger","#isExpectedRejection","OptionsNamespace","createLimits","createDependenciesStore","StateNamespace","RoutesNamespace","RouteLifecycleNamespace","PluginsNamespace","NavigationNamespace","RouterLifecycleNamespace","createRouterFSM","EventEmitter","EventBusNamespace","createBinaryInterceptable","EMPTY_PARAMS","createInterceptable","#assertNotReentrant","#suppressUnhandledRejection","getInternals","normalizeParams","CACHED_ALREADY_STARTED_ERROR","#unwindFailedStart","#markDisposed","getTransitionPath","RouterError"],"sources":["../../src/Router.ts"],"sourcesContent":["// packages/core/src/Router.ts\n\n/**\n * Router class - facade with integrated namespaces.\n *\n * All functionality is now provided by namespace classes.\n */\n\nimport { EMPTY_PARAMS, errorCodes } from \"./constants\";\nimport { EventEmitter } from \"./foundation/event-emitter\";\nimport { RouterLogger } from \"./foundation/logger\";\nimport {\n  assertLoggerConfig,\n  guardDependencies,\n  guardRouteStructure,\n} from \"./guards\";\nimport { createLimits, normalizeParams } from \"./helpers\";\nimport {\n  createBinaryInterceptable,\n  createInterceptable,\n  getInternals,\n  registerInternals,\n} from \"./internals\";\nimport {\n  EventBusNamespace,\n  NavigationNamespace,\n  OptionsNamespace,\n  PluginsNamespace,\n  RouteLifecycleNamespace,\n  RouterLifecycleNamespace,\n  RoutesNamespace,\n  StateNamespace,\n  createDependenciesStore,\n} from \"./namespaces\";\nimport { CACHED_ALREADY_STARTED_ERROR } from \"./namespaces/RouterLifecycleNamespace/constants\";\nimport { RouterError } from \"./RouterError\";\nimport { createRouterFSM } from \"./routerFSM\";\nimport { getTransitionPath } from \"./transitionPath\";\nimport { wireNamespaces } from \"./wiring\";\n\nimport type { CreateMatcherOptions } from \"./engine\";\nimport type { RouterInternals } from \"./internals\";\nimport type { DependenciesStore } from \"./namespaces\";\nimport type {\n  DefaultDependencies,\n  LeaveFn,\n  NavigationOptions,\n  Options,\n  Params,\n  Router as RouterInterface,\n  State,\n  SubscribeFn,\n  Unsubscribe,\n  PluginFactory,\n  Route,\n} from \"./types\";\nimport type { Limits, RouterEventMap } from \"./types/internal\";\n\nconst EMPTY_OPTS: Readonly<NavigationOptions> = Object.freeze({});\n\n// Module-level so #isExpectedRejection allocates nothing per navigate()/start() call.\n// These are expected navigation outcomes owned by the caller, not internal\n// bugs — the safety net stays silent for them and lets awaiting callers see\n// the rejection. CANNOT_ACTIVATE / CANNOT_DEACTIVATE belong here: a guard\n// blocking (or a plugin's guard-blocked back()/forward()) is a normal result,\n// so a fire-and-forget call must not emit a spurious \"Unexpected navigation\n// error\" (#721).\nconst SUPPRESSED_ERROR_CODES: ReadonlySet<string> = new Set([\n  errorCodes.SAME_STATES,\n  errorCodes.TRANSITION_CANCELLED,\n  errorCodes.ROUTER_NOT_STARTED,\n  errorCodes.ROUTE_NOT_FOUND,\n  errorCodes.CANNOT_ACTIVATE,\n  errorCodes.CANNOT_DEACTIVATE,\n]);\n\n/**\n * Router class with integrated namespace architecture.\n *\n * All functionality is provided by namespace classes:\n * - OptionsNamespace: getOptions (immutable)\n * - DependenciesStore: get/set/remove dependencies\n * - EventEmitter: subscribe\n * - StateNamespace: state storage (getState, setState, getPreviousState)\n * - RoutesNamespace: route tree operations\n * - RouteLifecycleNamespace: canActivate/canDeactivate guards\n * - PluginsNamespace: plugin lifecycle\n * - NavigationNamespace: navigate\n * - RouterLifecycleNamespace: start, stop, isStarted\n *\n * @internal This class implementation is internal. Use createRouter() instead.\n */\nexport class Router<\n  Dependencies extends DefaultDependencies = DefaultDependencies,\n> implements RouterInterface<Dependencies> {\n  [key: string]: unknown;\n\n  // ============================================================================\n  // Namespaces\n  // ============================================================================\n\n  readonly #options: OptionsNamespace;\n  readonly #limits: Limits;\n  readonly #dependenciesStore: DependenciesStore<Dependencies>;\n  readonly #state: StateNamespace;\n  readonly #routes: RoutesNamespace<Dependencies>;\n  readonly #routeLifecycle: RouteLifecycleNamespace<Dependencies>;\n  readonly #plugins: PluginsNamespace<Dependencies>;\n  readonly #navigation: NavigationNamespace;\n  readonly #lifecycle: RouterLifecycleNamespace;\n\n  readonly #eventBus: EventBusNamespace;\n\n  /**\n   * Per-instance suppressors for fire-and-forget navigate / start. They log\n   * through THIS router's logger (built in the constructor) — so, unlike the\n   * former static \"one allocation per class\" closures, they are two closures per\n   * instance. Trade accepted with the per-router logger (#724): the logger is\n   * per-instance, so its suppressors must be too. The #931 category split is\n   * preserved — navigate failures log under \"router.navigate\", start failures\n   * under \"router.start\" (a start interceptor throwing a plain Error after\n   * next() committed, #763, or a cryptic path TypeError — neither a suppressed\n   * RouterError). The log line IS reachable: a subscribeLeave listener that\n   * throws rejects navigate() with the original NON-suppressed error, and a\n   * Symbol path-param's stringify TypeError is likewise non-suppressed.\n   */\n  readonly #onSuppressedNavigateError: (error: unknown) => void;\n  readonly #onSuppressedStartError: (error: unknown) => void;\n\n  // ============================================================================\n  // Constructor\n  // ============================================================================\n\n  /**\n   * @param routes - Route definitions\n   * @param options - Router options\n   * @param dependencies - DI dependencies\n   */\n  constructor(\n    routes: Route<Dependencies>[] = [],\n    options: Partial<Options> = {},\n    dependencies: Dependencies = {} as Dependencies,\n  ) {\n    // Extract the logger config WITHOUT mutating the caller's `options` object\n    // (#724). `routerOptions` is the logger-stripped view handed to the options\n    // pipeline so `logger` never lands in the frozen router options.\n    const { logger: loggerConfig, ...routerOptions } = options;\n\n    if (loggerConfig) {\n      assertLoggerConfig(loggerConfig);\n    }\n\n    // Per-router logger instance — replaces the former process-global singleton\n    // whose configure() leaked across every router in the process, last\n    // createRouter winning (#724). Stored on ctx (registerInternals below), so\n    // the facade reads getInternals(this).logger; namespaces receive it via\n    // their deps at wiring; plugins reach it through getPluginApi(router).logger.\n    const logger = new RouterLogger(loggerConfig);\n\n    // Per-instance fire-and-forget suppressors (see field declarations): they\n    // log through THIS router's logger, so they are built here, not static.\n    this.#onSuppressedNavigateError = (error: unknown): void => {\n      if (Router.#isExpectedRejection(error)) {\n        return;\n      }\n\n      logger.error(\"router.navigate\", \"Unexpected navigation error\", error);\n    };\n    this.#onSuppressedStartError = (error: unknown): void => {\n      if (Router.#isExpectedRejection(error)) {\n        return;\n      }\n\n      logger.error(\"router.start\", \"Unexpected start error\", error);\n    };\n\n    // =========================================================================\n    // Validate inputs before creating namespaces\n    // =========================================================================\n\n    // Always validate the caller's options (catches non-object / array inputs)\n    OptionsNamespace.validateOptionsIsObject(options);\n\n    // Unconditional guard-level validation before creating namespaces\n    guardDependencies(dependencies);\n\n    // Stryker disable next-line EqualityOperator: equivalent — `>= 0` is always true, but `guardRouteStructure([])` on an empty array is a no-op, so validating an empty list behaves identically to skipping it. (ConditionalExpression stays live: `→false` skips validation of a real route list and is killable.)\n    if (routes.length > 0) {\n      guardRouteStructure(routes);\n    }\n\n    // =========================================================================\n    // Create Namespaces\n    // =========================================================================\n\n    this.#options = new OptionsNamespace(routerOptions);\n    this.#limits = createLimits(routerOptions.limits);\n    this.#dependenciesStore =\n      createDependenciesStore<Dependencies>(dependencies);\n    this.#state = new StateNamespace();\n    this.#routes = new RoutesNamespace<Dependencies>(\n      routes,\n      deriveMatcherOptions(this.#options.get()),\n      logger,\n    );\n    this.#routeLifecycle = new RouteLifecycleNamespace<Dependencies>();\n    this.#plugins = new PluginsNamespace<Dependencies>();\n    this.#navigation = new NavigationNamespace();\n    this.#lifecycle = new RouterLifecycleNamespace();\n\n    // =========================================================================\n    // Initialize EventBus\n    // =========================================================================\n\n    const routerFSM = createRouterFSM();\n\n    const emitter = new EventEmitter<RouterEventMap>({\n      // Shared per-listener error sink: EventEmitter reports synchronous listener\n      // throws here, and EventBusNamespace.subscribe routes an async listener's\n      // rejected Promise through the SAME sink (#944) — both land in one place.\n      onListenerError: (eventName, error) => {\n        logger.error(\"Router\", `Error in listener for ${eventName}:`, error);\n      },\n      onListenerWarn: (eventName, count) => {\n        logger.warn(\n          \"router.addEventListener\",\n          `Event \"${eventName}\" has ${count} listeners — possible memory leak`,\n        );\n      },\n    });\n\n    this.#eventBus = new EventBusNamespace({\n      routerFSM,\n      emitter,\n      // The FSM CANCEL action aborts the in-flight\n      // navigation controller via this injected effect — \"FSM CANCEL ⟹\n      // controller aborted\" in one place. `#navigation` is constructed above.\n      abortController: (reason) => {\n        this.#navigation.abortCurrentController(reason);\n      },\n    });\n\n    // =========================================================================\n    // Register Internals (WeakMap for plugin/infrastructure access)\n    // =========================================================================\n    // Registered BEFORE wiring (#1331) so every namespace's deps-closure sees a\n    // router already present in the internals registry — `getInternals(router)`\n    // never throws during wiring, and guard factories flushed at the end of the\n    // constructor see a fully-registered instance.\n\n    const interceptorsMap: RouterInternals[\"interceptors\"] = new Map();\n\n    registerInternals(this, {\n      logger,\n      makeState: (name, params, path, meta) =>\n        this.#state.makeState(name, params, path, meta),\n      // `as unknown as` is required: createBinaryInterceptable returns a\n      // non-generic `(a: A, b: B) => R`, but RouterInternals[\"forwardState\"]\n      // is declared with a generic parameter `<P extends Params = Params>`,\n      // which tsc will not infer from the non-generic source. Sonar S4325\n      // misclassifies this as a redundant cast.\n      forwardState: createBinaryInterceptable(\n        \"forwardState\",\n        (name: string, params: Params) =>\n          this.#routes.forwardState(name, params),\n        interceptorsMap,\n      ) as unknown as RouterInternals[\"forwardState\"],\n      buildStateResolved: (name, params) =>\n        this.#routes.buildStateResolved(name, params),\n      matchPath: (path, matchOptions) =>\n        this.#routes.matchPath(path, matchOptions),\n      getOptions: () => this.#options.get(),\n      addEventListener: (eventName, cb) =>\n        this.#eventBus.addEventListener(eventName, cb),\n      treeChanged: {\n        emit: (event) => {\n          this.#eventBus.emitTreeChanged(event);\n        },\n        subscribe: (handler) => this.#eventBus.subscribeTreeChanged(handler),\n        listenerCount: () => this.#eventBus.treeChangedListenerCount(),\n        isEmitting: () => this.#eventBus.isEmittingTreeChanged(),\n      },\n      buildPath: createBinaryInterceptable(\n        \"buildPath\",\n        (route: string, params?: Params) =>\n          this.#routes.buildPath(\n            route,\n            params ?? EMPTY_PARAMS,\n            this.#options.get(),\n          ),\n        interceptorsMap,\n      ),\n      emitTransitionError: (error) => {\n        this.#eventBus.sendFailSafe(undefined, this.#state.get(), error);\n      },\n      emitTransitionSuccess: (toState, fromState, opts) => {\n        this.#eventBus.emitTransitionSuccess(toState, fromState, opts);\n      },\n      navigateToNotFound: (path) => this.#navigation.navigateToNotFound(path),\n      start: createInterceptable(\n        \"start\",\n        (path: string) => {\n          return this.#lifecycle.start(path);\n        },\n        interceptorsMap,\n      ),\n      navigateToState: (state, navOpts) => {\n        // Plugin-only navigation primitive (#525). Mirrors the same\n        // unhandled-rejection suppression and lastSync* bookkeeping used by\n        // the public Router.navigate facade so plugin call-sites can\n        // fire-and-forget the returned promise (popstate handlers do).\n        this.#assertNotReentrant();\n\n        const promiseState = this.#navigation.navigateToState(\n          state,\n          navOpts ?? EMPTY_OPTS,\n        );\n\n        if (this.#navigation.lastSyncResolved) {\n          this.#navigation.lastSyncResolved = false;\n        } else if (this.#navigation.lastSyncRejected) {\n          this.#navigation.lastSyncRejected = false;\n        } else {\n          this.#suppressUnhandledRejection(promiseState);\n        }\n\n        return promiseState;\n      },\n      interceptors: interceptorsMap,\n      setRootPath: (rootPath) => {\n        this.#routes.setRootPath(rootPath);\n      },\n      getRootPath: () => this.#routes.getStore().rootPath,\n      getTree: () => this.#routes.getStore().tree,\n      isDisposed: () => this.#eventBus.isDisposed(),\n      validator: null,\n      // Dependencies (issue #172)\n      dependenciesGetStore: () => this.#dependenciesStore,\n      // Clone support (issue #173)\n      getCloneState: () => ({\n        options: { ...this.#options.get() },\n        dependencies: { ...this.#dependenciesStore.dependencies },\n        pluginFactories: this.#plugins.getAll(),\n        // `logger` is a const in this constructor's scope (a RouterLogger class\n        // instance), so getConfig() yields the resolved config a clone inherits\n        // — frozen options don't carry `logger`, so cloneRouter reads it here.\n        loggerConfig: logger.getConfig(),\n      }),\n      routeGetStore: () => this.#routes.getStore(),\n      // Cross-namespace state (issue #174)\n      getStateName: () => this.#state.get()?.name,\n      isTransitioning: () => this.#eventBus.isTransitioning(),\n      clearState: () => {\n        this.#state.set(undefined);\n      },\n      setState: (state) => {\n        this.#state.set(state);\n      },\n      routerExtensions: [],\n      contextClaimRecords: new Set(),\n      hydrationState: null,\n    });\n\n    // =========================================================================\n    // Wire Dependencies\n    // =========================================================================\n\n    wireNamespaces<Dependencies>({\n      router: this,\n      options: this.#options,\n      limits: this.#limits,\n      dependenciesStore: this.#dependenciesStore,\n      state: this.#state,\n      routes: this.#routes,\n      routeLifecycle: this.#routeLifecycle,\n      plugins: this.#plugins,\n      navigation: this.#navigation,\n      lifecycle: this.#lifecycle,\n      eventBus: this.#eventBus,\n    });\n\n    // =========================================================================\n    // Bind Public Methods\n    // =========================================================================\n    // All public methods that access private fields must be bound to preserve\n    // `this` context when methods are extracted as references.\n    // See: https://github.com/tc39/proposal-bind-operator\n    // =========================================================================\n\n    // Path & State Building\n    this.isActiveRoute = this.isActiveRoute.bind(this);\n    this.buildPath = this.buildPath.bind(this);\n\n    // State Management\n    this.getState = this.getState.bind(this);\n    this.getPreviousState = this.getPreviousState.bind(this);\n    this.areStatesEqual = this.areStatesEqual.bind(this);\n    this.shouldUpdateNode = this.shouldUpdateNode.bind(this);\n\n    // Router Lifecycle\n    this.isActive = this.isActive.bind(this);\n    this.start = this.start.bind(this);\n    this.stop = this.stop.bind(this);\n    this.dispose = this.dispose.bind(this);\n\n    // Route Lifecycle (Guards)\n    this.canNavigateTo = this.canNavigateTo.bind(this);\n\n    // Plugins\n    this.usePlugin = this.usePlugin.bind(this);\n\n    // Navigation\n    this.navigate = this.navigate.bind(this);\n    this.navigateToDefault = this.navigateToDefault.bind(this);\n    this.navigateToNotFound = this.navigateToNotFound.bind(this);\n\n    // Subscription\n    this.subscribe = this.subscribe.bind(this);\n    this.subscribeLeave = this.subscribeLeave.bind(this);\n    this.isLeaveApproved = this.isLeaveApproved.bind(this);\n\n    // =========================================================================\n    // Flush initial-route guard factories\n    // =========================================================================\n    // Deferred out of wiring (#1331): the pending canActivate/canDeactivate\n    // factories from initial route definitions are compiled and executed HERE,\n    // on the fully-built and bound router — a factory calling read-only methods\n    // (`buildPath()`, `isActiveRoute()`, `getState()`) no longer hits a\n    // half-assembled instance. Side-effectful calls (`navigate`, `usePlugin`,\n    // route-CRUD) stay OUT OF CONTRACT: factories re-execute outside the\n    // constructor (cloneRouter re-compiles definition guards per clone;\n    // #recompileSlot re-runs a factory after a definition-only clear), so any\n    // side effect would duplicate per re-execution — see CLAUDE.md. Runtime\n    // add()/replace() compile guards in their own PREPARE phase and never touch\n    // these pending maps.\n    //\n    // Fail-closed on a factory throw: by this point a router reference leaked\n    // from an earlier factory is fully operational, while later guards would\n    // stay silently unregistered — a fail-open guard bypass. Disposing before\n    // the rethrow turns any leaked reference into a ROUTER_DISPOSED-throwing\n    // husk (pre-#1331 such a reference was inert because getInternals threw).\n    try {\n      this.#routes.flushPendingGuards();\n    } catch (error) {\n      this.dispose();\n\n      throw error;\n    }\n  }\n\n  // ============================================================================\n  // Path & State Building\n  // ============================================================================\n\n  isActiveRoute(\n    name: string,\n    params?: Params,\n    strictEquality?: boolean,\n    ignoreQueryParams?: boolean,\n  ): boolean {\n    getInternals(this).validator?.routes.validateIsActiveRouteArgs(\n      name,\n      params,\n      strictEquality,\n      ignoreQueryParams,\n    );\n\n    getInternals(this).validator?.routes.validateRouteName(\n      name,\n      \"isActiveRoute\",\n    );\n\n    // Empty string is special case - warn and return false (root node is not a parent)\n    if (name === \"\") {\n      getInternals(this).logger.warn(\n        \"real-router\",\n        'isActiveRoute(\"\") called with empty string. Root node is not considered a parent of any route.',\n      );\n\n      return false;\n    }\n\n    return this.#routes.isActiveRoute(\n      name,\n      params,\n      strictEquality,\n      ignoreQueryParams,\n    );\n  }\n\n  buildPath(route: string, params?: Params): string {\n    const ctx = getInternals(this);\n\n    ctx.validator?.routes.validateBuildPathArgs(route);\n    ctx.validator?.navigation.validateParams(params, \"buildPath\");\n\n    return ctx.buildPath(route, normalizeParams(params));\n  }\n\n  // ============================================================================\n  // State Management (delegated to StateNamespace)\n  // ============================================================================\n\n  getState<P extends Params = Params>(): State<P> | undefined {\n    return this.#state.get<P>();\n  }\n\n  getPreviousState(): State | undefined {\n    return this.#state.getPrevious();\n  }\n\n  areStatesEqual(\n    state1: State | undefined,\n    state2: State | undefined,\n    ignoreQueryParams = true,\n  ): boolean {\n    getInternals(this).validator?.state.validateAreStatesEqualArgs(\n      state1,\n      state2,\n      ignoreQueryParams,\n    );\n\n    return this.#state.areStatesEqual(state1, state2, ignoreQueryParams);\n  }\n\n  shouldUpdateNode(\n    nodeName: string,\n  ): (toState: State, fromState?: State) => boolean {\n    getInternals(this).validator?.routes.validateShouldUpdateNodeArgs(nodeName);\n\n    return RoutesNamespace.shouldUpdateNode(nodeName);\n  }\n\n  // ============================================================================\n  // Router Lifecycle\n  // ============================================================================\n\n  isActive(): boolean {\n    return this.#eventBus.isActive();\n  }\n\n  start(startPath: string): Promise<State> {\n    if (!this.#eventBus.canStart()) {\n      return Promise.reject(CACHED_ALREADY_STARTED_ERROR);\n    }\n\n    getInternals(this).validator?.navigation.validateStartArgs(startPath);\n\n    // FSM bookkeeping is split across the facade and RouterLifecycleNamespace by\n    // design, NOT a missed consolidation (#940): `sendStart()` runs HERE, before\n    // the interceptor chain, so the STARTING window spans the whole start\n    // pipeline. A pre-`next()` interceptor throw then unwinds via STARTING →\n    // `sendFail`, which emits TRANSITION_ERROR from STARTING (EventBusNamespace\n    // FAIL action) for `onTransitionError` plugins. Moving `sendStart()` into the\n    // namespace (the interceptor *target*) would skip STARTING on a pre-`next()`\n    // throw — the namespace is never reached — silently dropping that\n    // TRANSITION_ERROR: a #668 regression. The commit (`completeStart`) lives in\n    // the namespace; recovery needs facade state (`#state`, `#lifecycle`), so it\n    // stays here in `#unwindFailedStart`.\n    this.#eventBus.sendStart();\n\n    // Convert sync interceptor throws to rejections so the recovery path is\n    // reachable; otherwise the throw escapes synchronously, the FSM is left in\n    // STARTING, and the router is permanently bricked (#668).\n    let internalStart: Promise<State>;\n\n    try {\n      const chainResult: unknown = getInternals(this).start(startPath);\n\n      // A `start` interceptor that returns without calling next() yields a\n      // non-thenable (typically undefined); the `.catch` below would then throw\n      // a cryptic `TypeError: ...reading 'catch'` and leave the FSM stuck in\n      // STARTING. Reject with an actionable message so recovery unwinds via\n      // #unwindFailedStart — the same deferred-crash class as the #939\n      // start-path guard (#1411).\n      internalStart =\n        typeof (chainResult as { then?: unknown } | null | undefined)?.then ===\n        \"function\"\n          ? (chainResult as Promise<State>)\n          : Promise.reject(\n              new TypeError(\n                \"[router.start] a `start` interceptor returned without calling next(). Every start interceptor must return `next(path)`.\",\n              ),\n            );\n    } catch (syncError: unknown) {\n      // eslint-disable-next-line @typescript-eslint/prefer-promise-reject-errors -- preserve original throw shape from user-provided start interceptor\n      internalStart = Promise.reject(syncError);\n    }\n\n    const promiseState = internalStart.catch((error: unknown) =>\n      this.#unwindFailedStart(error),\n    );\n\n    this.#suppressUnhandledRejection(\n      promiseState,\n      this.#onSuppressedStartError,\n    );\n\n    return promiseState;\n  }\n\n  stop(): this {\n    // SendCancelIfPossible → FSM CANCEL → the CANCEL action\n    // aborts the in-flight controller (waking the pipeline). No separate abort.\n    this.#eventBus.sendCancelIfPossible(this.#state.get());\n\n    // `isStarting()` is included (#1185): a stop() while `start()` is parked in\n    // an async start-interceptor (FSM STARTING, before `next()`) must cancel the\n    // start, not silently no-op. `sendStop()` takes STARTING → IDLE (FSM table),\n    // and `RouterLifecycleNamespace.start` re-checks `isIdle()` after the\n    // interceptor chain and rejects with TRANSITION_CANCELLED — mirroring the\n    // guard-phase behavior (which already cancels from TRANSITION_STARTED).\n    if (\n      !this.#eventBus.isReady() &&\n      !this.#eventBus.isTransitioning() &&\n      !this.#eventBus.isStarting()\n    ) {\n      return this;\n    }\n\n    this.#lifecycle.stop();\n    this.#eventBus.sendStop();\n\n    return this;\n  }\n\n  dispose(): void {\n    // Stryker disable next-line BlockStatement: equivalent — emptying the early-return re-runs the dispose body on a 2nd call, but it is fully idempotent (FSM `send(DISPOSE)` no-ops from DISPOSED, `disposeAll()` already cleared `#unsubscribes`, every clear is idempotent). (ConditionalExpression stays live: `→true` always-returns and never disposes = killed.)\n    if (this.#eventBus.isDisposed()) {\n      return;\n    }\n\n    // the FSM CANCEL action aborts the in-flight controller.\n    this.#eventBus.sendCancelIfPossible(this.#state.get());\n\n    if (this.#eventBus.isReady() || this.#eventBus.isTransitioning()) {\n      this.#lifecycle.stop();\n      this.#eventBus.sendStop();\n    }\n\n    this.#eventBus.sendDispose();\n    this.#eventBus.clearAll();\n\n    this.#plugins.disposeAll();\n\n    // Safety net: clean up extensions plugins failed to remove in teardown\n    const ctx = getInternals(this);\n\n    for (const extension of ctx.routerExtensions) {\n      for (const key of extension.keys) {\n        delete (this as Record<string, unknown>)[key];\n      }\n    }\n\n    ctx.routerExtensions.length = 0;\n\n    // Safety net: release context namespace claims plugins failed to release in teardown\n    ctx.contextClaimRecords.clear();\n\n    // Safety net: drop interceptors plugins failed to remove in teardown (#1199).\n    // The third per-plugin registration channel — symmetric with routerExtensions\n    // / contextClaimRecords above. `buildPath` is not method-swapped by dispose\n    // and reads this Map live, so a leaked interceptor would otherwise still run\n    // on the disposed router.\n    ctx.interceptors.clear();\n\n    this.#routes.clearRoutes();\n    this.#routeLifecycle.clearAll();\n    this.#state.reset();\n    this.#dependenciesStore.dependencies = Object.create(\n      null,\n    ) as Partial<Dependencies>;\n\n    this.#markDisposed();\n  }\n\n  // ============================================================================\n  // Route Lifecycle (Guards)\n  // ============================================================================\n\n  canNavigateTo(name: string, params?: Params): boolean {\n    const ctx = getInternals(this);\n\n    ctx.validator?.routes.validateRouteName(name, \"canNavigateTo\");\n    ctx.validator?.navigation.validateParams(params, \"canNavigateTo\");\n\n    if (!this.#routes.hasRoute(name)) {\n      return false;\n    }\n\n    const { name: resolvedName, params: resolvedParams } = ctx.forwardState(\n      name,\n      params ?? {},\n    );\n\n    // Build `toState` exactly as `buildNavigateState` does — WITH route-meta and\n    // normalized params — so `getTransitionPath` takes its STANDARD PATH and\n    // trims the shared ancestor, mirroring navigate's guard set (#970). A\n    // meta-less `toState` makes both sides meta-less (the committed `getState()`\n    // carries no meta after a path-matched `start()`), so `getTransitionPath`\n    // takes FAST PATH 3 and (de)activates the WHOLE chain incl. shared ancestors\n    // → false-negative (\"Link disabled though the click would succeed\").\n    // `normalizeParams` also aligns the params guards observe with navigate's.\n    // `skipFreeze` (5th arg) mirrors the navigate guard phase, where guards see\n    // an unfrozen, transition-less `toState` (freeze happens later in\n    // `completeTransition`).\n    //\n    // A capability predicate must answer, not throw: if the target path can't be\n    // built from these params (e.g. a required path param is missing), the route\n    // is simply unreachable with this input — return `false` rather than letting\n    // `buildPath` throw (#725).\n    let toState: State;\n\n    try {\n      const normalizedParams = normalizeParams(resolvedParams);\n      const meta = this.#routes.getMetaForState(resolvedName);\n      const path = ctx.buildPath(resolvedName, normalizedParams);\n\n      toState = this.#state.makeState(\n        resolvedName,\n        normalizedParams,\n        path,\n        meta,\n        true,\n      );\n    } catch {\n      return false;\n    }\n\n    const fromState = this.#state.get();\n\n    const { toDeactivate, toActivate } = getTransitionPath(toState, fromState);\n\n    return this.#routeLifecycle.canNavigateTo(\n      toDeactivate,\n      toActivate,\n      toState,\n      fromState,\n    );\n  }\n\n  // ============================================================================\n  // Plugins\n  // ============================================================================\n\n  usePlugin(\n    ...plugins: (PluginFactory<Dependencies> | false | null | undefined)[]\n  ): Unsubscribe {\n    // Post-dispose guard, mirroring #946 for subscribe/subscribeLeave. A\n    // reference captured before dispose() (`const up = router.usePlugin`)\n    // bypasses the #markDisposed method swap, so the swap alone is not enough:\n    // without this, the factory would run on a disposed router (real side\n    // effects), listeners would land in the cleared emitter, and teardown would\n    // never fire — a silent zombie plugin (#1196).\n    if (this.#eventBus.isDisposed()) {\n      throw new RouterError(errorCodes.ROUTER_DISPOSED);\n    }\n\n    const filtered = plugins.filter(Boolean) as PluginFactory<Dependencies>[];\n\n    if (filtered.length === 0) {\n      return () => {};\n    }\n\n    const ctx = getInternals(this);\n\n    ctx.validator?.plugins.validatePluginLimit(\n      this.#plugins.count(),\n      this.#limits,\n    );\n    for (const plugin of filtered) {\n      // `getAll()` sits inside the optional-chain argument on purpose: with no\n      // validator installed (production default) the `?.` short-circuits and the\n      // array is never allocated. Hoisting it out would either allocate on the\n      // no-validator hot path or push the dev-only branch out of coverage.\n      ctx.validator?.plugins.validateNoDuplicatePlugins(\n        plugin,\n        this.#plugins.getAll(),\n      );\n    }\n\n    return this.#plugins.use(...filtered);\n  }\n\n  // ============================================================================\n  // Subscription (backed by EventEmitter)\n  // ============================================================================\n\n  subscribe(listener: SubscribeFn): Unsubscribe {\n    EventBusNamespace.validateSubscribeListener(listener);\n\n    return this.#eventBus.subscribe(listener);\n  }\n\n  subscribeLeave(listener: LeaveFn): Unsubscribe {\n    EventBusNamespace.validateSubscribeLeaveListener(listener);\n\n    return this.#eventBus.subscribeLeave(listener);\n  }\n\n  isLeaveApproved(): boolean {\n    return this.#eventBus.isLeaveApproved();\n  }\n\n  // ============================================================================\n  // Navigation\n  // ============================================================================\n\n  navigate(\n    routeName: string,\n    routeParams?: Params,\n    options?: NavigationOptions,\n  ): Promise<State> {\n    this.#assertNotReentrant();\n\n    const ctx = getInternals(this);\n\n    ctx.validator?.navigation.validateNavigateArgs(routeName);\n    ctx.validator?.navigation.validateParams(routeParams, \"navigate\");\n\n    const opts = options ?? EMPTY_OPTS;\n\n    ctx.validator?.navigation.validateNavigationOptions(opts, \"navigate\");\n\n    const promiseState = this.#navigation.navigate(\n      routeName,\n      routeParams ?? EMPTY_PARAMS,\n      opts,\n    );\n\n    if (this.#navigation.lastSyncResolved) {\n      this.#navigation.lastSyncResolved = false;\n    } else if (this.#navigation.lastSyncRejected) {\n      // Cached rejection — already pre-suppressed at module load, skip .catch()\n      this.#navigation.lastSyncRejected = false;\n    } else {\n      this.#suppressUnhandledRejection(promiseState);\n    }\n\n    return promiseState;\n  }\n\n  navigateToDefault(options?: NavigationOptions): Promise<State> {\n    this.#assertNotReentrant();\n\n    const ctx = getInternals(this);\n\n    ctx.validator?.navigation.validateNavigateToDefaultArgs(options);\n\n    const opts = options ?? EMPTY_OPTS;\n\n    ctx.validator?.navigation.validateNavigationOptions(\n      opts,\n      \"navigateToDefault\",\n    );\n\n    const promiseState = this.#navigation.navigateToDefault(opts);\n\n    if (this.#navigation.lastSyncResolved) {\n      this.#navigation.lastSyncResolved = false;\n    } else if (this.#navigation.lastSyncRejected) {\n      this.#navigation.lastSyncRejected = false;\n    } else {\n      this.#suppressUnhandledRejection(promiseState);\n    }\n\n    return promiseState;\n  }\n\n  navigateToNotFound(path?: string): State {\n    this.#assertNotReentrant();\n\n    if (!this.#eventBus.isActive()) {\n      throw new RouterError(errorCodes.ROUTER_NOT_STARTED);\n    }\n\n    if (path !== undefined && typeof path !== \"string\") {\n      throw new TypeError(\n        `[router.navigateToNotFound] path must be a string, got ${typeof path}`,\n      );\n    }\n\n    if (path !== undefined) {\n      return this.#navigation.navigateToNotFound(path);\n    }\n\n    // #1172: a path-less call derives the default path from the committed state.\n    // During the two-phase start window the router is active (`isActive()` true)\n    // while `getState()` is still undefined, so throw an actionable RouterError\n    // instead of a cryptic `TypeError` from dereferencing the absent state —\n    // same class as the #939 always-on invariant guards.\n    const current = this.#state.get();\n\n    if (current === undefined) {\n      throw new RouterError(errorCodes.ROUTER_NOT_STARTED, {\n        message:\n          \"[router.navigateToNotFound] cannot derive the path before the start navigation commits — pass an explicit path\",\n      });\n    }\n\n    return this.#navigation.navigateToNotFound(current.path);\n  }\n\n  /**\n   * Classifies a fire-and-forget rejection as an EXPECTED outcome that must\n   * stay silent (no log). Shared by the navigate and start suppressors so the\n   * suppression contract lives in one place.\n   *\n   * A suppressed RouterError code is a normal caller-owned navigation result\n   * (a guard block, SAME_STATES, ROUTER_NOT_STARTED, …) — see\n   * SUPPRESSED_ERROR_CODES (#721).\n   *\n   * The #945 RecursionDepthError carve-out is gone: a reentrant navigate() from a\n   * listener can no longer self-feed — it throws REENTRANT_NAVIGATION\n   * synchronously at the facade (RFC navigation-cancellation-unification §4), so\n   * navigate()'s promise never rejects with a recursion error (re-entrant emits\n   * are coalesced at the emitter, #1033; reentrant route-CRUD throws\n   * REENTRANT_TREE_MUTATION to the CRUD caller, #1032 — not through a navigate\n   * promise).\n   */\n  static #isExpectedRejection(error: unknown): boolean {\n    return (\n      error instanceof RouterError && SUPPRESSED_ERROR_CODES.has(error.code)\n    );\n  }\n\n  /**\n   * Fire-and-forget safety: prevents unhandled rejection warnings when\n   * navigate/navigateToDefault/start is called without await. Expected errors\n   * are silently suppressed; unexpected ones are logged under `onSuppressed`'s\n   * category — navigate by default; start() passes #onSuppressedStartError so\n   * its failures are logged as \"router.start\", not \"router.navigate\" (#931).\n   */\n  #suppressUnhandledRejection(\n    promise: Promise<State>,\n    onSuppressed: (error: unknown) => void = this.#onSuppressedNavigateError,\n  ): void {\n    promise.catch(onSuppressed);\n  }\n\n  /**\n   * Rejects a synchronous reentrant navigation — `navigate` /\n   * `navigateToDefault` / `navigateToState` / `navigateToNotFound` called from\n   * inside a transition-event listener while a transition is being dispatched\n   * (RFC navigation-cancellation-unification §4). Throws synchronously: inside a\n   * listener the emit's `onListenerError` isolation surfaces it (visible,\n   * non-fatal); a DEFERRED (async / microtask) navigate from a listener runs\n   * after dispatch settles and is allowed. Always-on core invariant guard (not\n   * validator-gated).\n   */\n  #assertNotReentrant(): void {\n    if (this.#eventBus.isProcessing()) {\n      throw new RouterError(errorCodes.REENTRANT_NAVIGATION);\n    }\n  }\n\n  /**\n   * Settles the FSM after a failed start pipeline, then re-throws so the\n   * rejection still surfaces to the caller. Three cases, by what the pipeline\n   * reached before throwing:\n   *\n   * - **Pre-commit, READY** (`isReady()` and no committed state): an interceptor\n   *   threw after `completeStart()` reached READY but before any state committed\n   *   (e.g. an activation guard blocked the start navigation) — return READY →\n   *   IDLE via `stop()` so the router is reusable.\n   * - **Pre-commit, STARTING** (`isStarting()`): the pipeline threw before\n   *   `completeStart()` — a sync interceptor throw before `next()`, or a throw\n   *   inside the namespace before commit — so unwind STARTING → IDLE via\n   *   `sendFail`, which also emits TRANSITION_ERROR from STARTING (#668).\n   * - **Post-commit, READY with committed state** (neither branch fires): a\n   *   loader/interceptor threw AFTER `navigateToState` committed and emitted\n   *   TRANSITION_SUCCESS (the SSR/RSC loader window). Keep the committed state —\n   *   rolling back would retract an observed success (\"phantom success\", #763);\n   *   the error still surfaces via the re-throw.\n   */\n  #unwindFailedStart(error: unknown): never {\n    if (this.#eventBus.isReady() && this.#state.get() === undefined) {\n      this.#lifecycle.stop();\n      this.#eventBus.sendStop();\n    } else if (this.#eventBus.isStarting()) {\n      this.#eventBus.sendFail(undefined, undefined, error);\n    }\n\n    throw error;\n  }\n\n  #markDisposed(): void {\n    this.navigate = throwDisposed;\n    this.navigateToDefault = throwDisposed;\n    this.navigateToNotFound = throwDisposed;\n    this.start = throwDisposed;\n    this.stop = throwDisposed;\n    this.usePlugin = throwDisposed;\n\n    this.subscribe = throwDisposed;\n    this.subscribeLeave = throwDisposed;\n    this.canNavigateTo = throwDisposed;\n  }\n}\n\nfunction throwDisposed(): never {\n  throw new RouterError(errorCodes.ROUTER_DISPOSED);\n}\n\n/**\n * Derives CreateMatcherOptions from router Options.\n * Maps core option names to matcher option names.\n */\nfunction deriveMatcherOptions(\n  options: Readonly<Options>,\n): CreateMatcherOptions {\n  return {\n    strictTrailingSlash: options.trailingSlash === \"strict\",\n    caseSensitive: options.caseSensitive,\n    strictQueryParams: options.queryParamsMode === \"strict\",\n    urlParamsEncoding: options.urlParamsEncoding,\n    // eslint-disable-next-line @typescript-eslint/no-non-null-assertion\n    queryParams: options.queryParams!,\n  };\n}\n"],"mappings":"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"}
+{"version":3,"file":"Router.js","names":["errorCodes","#options","#limits","#dependenciesStore","#state","#routes","#routeLifecycle","#plugins","#navigation","#lifecycle","#eventBus","#onSuppressedNavigateError","#onSuppressedStartError","RouterLogger","#isExpectedRejection","OptionsNamespace","createLimits","createDependenciesStore","StateNamespace","RoutesNamespace","RouteLifecycleNamespace","PluginsNamespace","NavigationNamespace","RouterLifecycleNamespace","createRouterFSM","EventEmitter","EventBusNamespace","createBinaryInterceptable","EMPTY_PARAMS","createInterceptable","#assertNotReentrant","#suppressUnhandledRejection","getInternals","normalizeParams","CACHED_ALREADY_STARTED_ERROR","#unwindFailedStart","#markDisposed","getTransitionPath","RouterError"],"sources":["../../src/Router.ts"],"sourcesContent":["// packages/core/src/Router.ts\n\n/**\n * Router class - facade with integrated namespaces.\n *\n * All functionality is now provided by namespace classes.\n */\n\nimport { EMPTY_PARAMS, errorCodes } from \"./constants\";\nimport {\n  assertLoggerConfig,\n  guardDependencies,\n  guardRouteStructure,\n} from \"./guards\";\nimport { createLimits, normalizeParams } from \"./helpers\";\nimport {\n  createBinaryInterceptable,\n  createInterceptable,\n  getInternals,\n  registerInternals,\n} from \"./internals\";\nimport {\n  EventBusNamespace,\n  NavigationNamespace,\n  OptionsNamespace,\n  PluginsNamespace,\n  RouteLifecycleNamespace,\n  RouterLifecycleNamespace,\n  RoutesNamespace,\n  StateNamespace,\n  createDependenciesStore,\n} from \"./namespaces\";\nimport { CACHED_ALREADY_STARTED_ERROR } from \"./namespaces/RouterLifecycleNamespace/constants\";\nimport { RouterError } from \"./RouterError\";\nimport { createRouterFSM } from \"./routerFSM\";\nimport { getTransitionPath } from \"./transitionPath\";\nimport { EventEmitter } from \"./utils/event-emitter\";\nimport { RouterLogger } from \"./utils/logger\";\nimport { wireNamespaces } from \"./wiring\";\n\nimport type { CreateMatcherOptions } from \"./engine\";\nimport type { RouterInternals } from \"./internals\";\nimport type { DependenciesStore } from \"./namespaces\";\nimport type {\n  DefaultDependencies,\n  LeaveFn,\n  NavigationOptions,\n  Options,\n  Params,\n  Router as RouterInterface,\n  State,\n  SubscribeFn,\n  Unsubscribe,\n  PluginFactory,\n  Route,\n} from \"./types\";\nimport type { Limits, RouterEventMap } from \"./types/internal\";\n\nconst EMPTY_OPTS: Readonly<NavigationOptions> = Object.freeze({});\n\n// Module-level so #isExpectedRejection allocates nothing per navigate()/start() call.\n// These are expected navigation outcomes owned by the caller, not internal\n// bugs — the safety net stays silent for them and lets awaiting callers see\n// the rejection. CANNOT_ACTIVATE / CANNOT_DEACTIVATE belong here: a guard\n// blocking (or a plugin's guard-blocked back()/forward()) is a normal result,\n// so a fire-and-forget call must not emit a spurious \"Unexpected navigation\n// error\" (#721).\nconst SUPPRESSED_ERROR_CODES: ReadonlySet<string> = new Set([\n  errorCodes.SAME_STATES,\n  errorCodes.TRANSITION_CANCELLED,\n  errorCodes.ROUTER_NOT_STARTED,\n  errorCodes.ROUTE_NOT_FOUND,\n  errorCodes.CANNOT_ACTIVATE,\n  errorCodes.CANNOT_DEACTIVATE,\n]);\n\n/**\n * Router class with integrated namespace architecture.\n *\n * All functionality is provided by namespace classes:\n * - OptionsNamespace: getOptions (immutable)\n * - DependenciesStore: get/set/remove dependencies\n * - EventEmitter: subscribe\n * - StateNamespace: state storage (getState, setState, getPreviousState)\n * - RoutesNamespace: route tree operations\n * - RouteLifecycleNamespace: canActivate/canDeactivate guards\n * - PluginsNamespace: plugin lifecycle\n * - NavigationNamespace: navigate\n * - RouterLifecycleNamespace: start, stop, isStarted\n *\n * @internal This class implementation is internal. Use createRouter() instead.\n */\nexport class Router<\n  Dependencies extends DefaultDependencies = DefaultDependencies,\n> implements RouterInterface<Dependencies> {\n  [key: string]: unknown;\n\n  // ============================================================================\n  // Namespaces\n  // ============================================================================\n\n  readonly #options: OptionsNamespace;\n  readonly #limits: Limits;\n  readonly #dependenciesStore: DependenciesStore<Dependencies>;\n  readonly #state: StateNamespace;\n  readonly #routes: RoutesNamespace<Dependencies>;\n  readonly #routeLifecycle: RouteLifecycleNamespace<Dependencies>;\n  readonly #plugins: PluginsNamespace<Dependencies>;\n  readonly #navigation: NavigationNamespace;\n  readonly #lifecycle: RouterLifecycleNamespace;\n\n  readonly #eventBus: EventBusNamespace;\n\n  /**\n   * Per-instance suppressors for fire-and-forget navigate / start. They log\n   * through THIS router's logger (built in the constructor) — so, unlike the\n   * former static \"one allocation per class\" closures, they are two closures per\n   * instance. Trade accepted with the per-router logger (#724): the logger is\n   * per-instance, so its suppressors must be too. The #931 category split is\n   * preserved — navigate failures log under \"router.navigate\", start failures\n   * under \"router.start\" (a start interceptor throwing a plain Error after\n   * next() committed, #763, or a cryptic path TypeError — neither a suppressed\n   * RouterError). The log line IS reachable: a subscribeLeave listener that\n   * throws rejects navigate() with the original NON-suppressed error, and a\n   * Symbol path-param's stringify TypeError is likewise non-suppressed.\n   */\n  readonly #onSuppressedNavigateError: (error: unknown) => void;\n  readonly #onSuppressedStartError: (error: unknown) => void;\n\n  // ============================================================================\n  // Constructor\n  // ============================================================================\n\n  /**\n   * @param routes - Route definitions\n   * @param options - Router options\n   * @param dependencies - DI dependencies\n   */\n  constructor(\n    routes: Route<Dependencies>[] = [],\n    options: Partial<Options> = {},\n    dependencies: Dependencies = {} as Dependencies,\n  ) {\n    // Extract the logger config WITHOUT mutating the caller's `options` object\n    // (#724). `routerOptions` is the logger-stripped view handed to the options\n    // pipeline so `logger` never lands in the frozen router options.\n    const { logger: loggerConfig, ...routerOptions } = options;\n\n    if (loggerConfig) {\n      assertLoggerConfig(loggerConfig);\n    }\n\n    // Per-router logger instance — replaces the former process-global singleton\n    // whose configure() leaked across every router in the process, last\n    // createRouter winning (#724). Stored on ctx (registerInternals below), so\n    // the facade reads getInternals(this).logger; namespaces receive it via\n    // their deps at wiring; plugins reach it through getPluginApi(router).logger.\n    const logger = new RouterLogger(loggerConfig);\n\n    // Per-instance fire-and-forget suppressors (see field declarations): they\n    // log through THIS router's logger, so they are built here, not static.\n    this.#onSuppressedNavigateError = (error: unknown): void => {\n      if (Router.#isExpectedRejection(error)) {\n        return;\n      }\n\n      logger.error(\"router.navigate\", \"Unexpected navigation error\", error);\n    };\n    this.#onSuppressedStartError = (error: unknown): void => {\n      if (Router.#isExpectedRejection(error)) {\n        return;\n      }\n\n      logger.error(\"router.start\", \"Unexpected start error\", error);\n    };\n\n    // =========================================================================\n    // Validate inputs before creating namespaces\n    // =========================================================================\n\n    // Always validate the caller's options (catches non-object / array inputs)\n    OptionsNamespace.validateOptionsIsObject(options);\n\n    // Unconditional guard-level validation before creating namespaces\n    guardDependencies(dependencies);\n\n    // Stryker disable next-line EqualityOperator: equivalent — `>= 0` is always true, but `guardRouteStructure([])` on an empty array is a no-op, so validating an empty list behaves identically to skipping it. (ConditionalExpression stays live: `→false` skips validation of a real route list and is killable.)\n    if (routes.length > 0) {\n      guardRouteStructure(routes);\n    }\n\n    // =========================================================================\n    // Create Namespaces\n    // =========================================================================\n\n    this.#options = new OptionsNamespace(routerOptions);\n    this.#limits = createLimits(routerOptions.limits);\n    this.#dependenciesStore =\n      createDependenciesStore<Dependencies>(dependencies);\n    this.#state = new StateNamespace();\n    this.#routes = new RoutesNamespace<Dependencies>(\n      routes,\n      deriveMatcherOptions(this.#options.get()),\n      logger,\n    );\n    this.#routeLifecycle = new RouteLifecycleNamespace<Dependencies>();\n    this.#plugins = new PluginsNamespace<Dependencies>();\n    this.#navigation = new NavigationNamespace();\n    this.#lifecycle = new RouterLifecycleNamespace();\n\n    // =========================================================================\n    // Initialize EventBus\n    // =========================================================================\n\n    const routerFSM = createRouterFSM();\n\n    const emitter = new EventEmitter<RouterEventMap>({\n      // Shared per-listener error sink: EventEmitter reports synchronous listener\n      // throws here, and EventBusNamespace.subscribe routes an async listener's\n      // rejected Promise through the SAME sink (#944) — both land in one place.\n      onListenerError: (eventName, error) => {\n        logger.error(\"Router\", `Error in listener for ${eventName}:`, error);\n      },\n      onListenerWarn: (eventName, count) => {\n        logger.warn(\n          \"router.addEventListener\",\n          `Event \"${eventName}\" has ${count} listeners — possible memory leak`,\n        );\n      },\n    });\n\n    this.#eventBus = new EventBusNamespace({\n      routerFSM,\n      emitter,\n      // The FSM CANCEL action aborts the in-flight\n      // navigation controller via this injected effect — \"FSM CANCEL ⟹\n      // controller aborted\" in one place. `#navigation` is constructed above.\n      abortController: (reason) => {\n        this.#navigation.abortCurrentController(reason);\n      },\n    });\n\n    // =========================================================================\n    // Register Internals (WeakMap for plugin/infrastructure access)\n    // =========================================================================\n    // Registered BEFORE wiring (#1331) so every namespace's deps-closure sees a\n    // router already present in the internals registry — `getInternals(router)`\n    // never throws during wiring, and guard factories flushed at the end of the\n    // constructor see a fully-registered instance.\n\n    const interceptorsMap: RouterInternals[\"interceptors\"] = new Map();\n\n    registerInternals(this, {\n      logger,\n      makeState: (name, params, path, meta) =>\n        this.#state.makeState(name, params, path, meta),\n      // `as unknown as` is required: createBinaryInterceptable returns a\n      // non-generic `(a: A, b: B) => R`, but RouterInternals[\"forwardState\"]\n      // is declared with a generic parameter `<P extends Params = Params>`,\n      // which tsc will not infer from the non-generic source. Sonar S4325\n      // misclassifies this as a redundant cast.\n      forwardState: createBinaryInterceptable(\n        \"forwardState\",\n        (name: string, params: Params) =>\n          this.#routes.forwardState(name, params),\n        interceptorsMap,\n      ) as unknown as RouterInternals[\"forwardState\"],\n      buildStateResolved: (name, params) =>\n        this.#routes.buildStateResolved(name, params),\n      matchPath: (path, matchOptions) =>\n        this.#routes.matchPath(path, matchOptions),\n      getOptions: () => this.#options.get(),\n      addEventListener: (eventName, cb) =>\n        this.#eventBus.addEventListener(eventName, cb),\n      treeChanged: {\n        emit: (event) => {\n          this.#eventBus.emitTreeChanged(event);\n        },\n        subscribe: (handler) => this.#eventBus.subscribeTreeChanged(handler),\n        listenerCount: () => this.#eventBus.treeChangedListenerCount(),\n        isEmitting: () => this.#eventBus.isEmittingTreeChanged(),\n      },\n      buildPath: createBinaryInterceptable(\n        \"buildPath\",\n        (route: string, params?: Params) =>\n          this.#routes.buildPath(\n            route,\n            params ?? EMPTY_PARAMS,\n            this.#options.get(),\n          ),\n        interceptorsMap,\n      ),\n      emitTransitionError: (error) => {\n        this.#eventBus.sendFailSafe(undefined, this.#state.get(), error);\n      },\n      emitTransitionSuccess: (toState, fromState, opts) => {\n        this.#eventBus.emitTransitionSuccess(toState, fromState, opts);\n      },\n      navigateToNotFound: (path) => this.#navigation.navigateToNotFound(path),\n      start: createInterceptable(\n        \"start\",\n        (path: string) => {\n          return this.#lifecycle.start(path);\n        },\n        interceptorsMap,\n      ),\n      navigateToState: (state, navOpts) => {\n        // Plugin-only navigation primitive (#525). Mirrors the same\n        // unhandled-rejection suppression and lastSync* bookkeeping used by\n        // the public Router.navigate facade so plugin call-sites can\n        // fire-and-forget the returned promise (popstate handlers do).\n        this.#assertNotReentrant();\n\n        const promiseState = this.#navigation.navigateToState(\n          state,\n          navOpts ?? EMPTY_OPTS,\n        );\n\n        if (this.#navigation.lastSyncResolved) {\n          this.#navigation.lastSyncResolved = false;\n        } else if (this.#navigation.lastSyncRejected) {\n          this.#navigation.lastSyncRejected = false;\n        } else {\n          this.#suppressUnhandledRejection(promiseState);\n        }\n\n        return promiseState;\n      },\n      interceptors: interceptorsMap,\n      setRootPath: (rootPath) => {\n        this.#routes.setRootPath(rootPath);\n      },\n      getRootPath: () => this.#routes.getStore().rootPath,\n      getTree: () => this.#routes.getStore().tree,\n      isDisposed: () => this.#eventBus.isDisposed(),\n      validator: null,\n      // Dependencies (issue #172)\n      dependenciesGetStore: () => this.#dependenciesStore,\n      // Clone support (issue #173)\n      getCloneState: () => ({\n        options: { ...this.#options.get() },\n        dependencies: { ...this.#dependenciesStore.dependencies },\n        pluginFactories: this.#plugins.getAll(),\n        // `logger` is a const in this constructor's scope (a RouterLogger class\n        // instance), so getConfig() yields the resolved config a clone inherits\n        // — frozen options don't carry `logger`, so cloneRouter reads it here.\n        loggerConfig: logger.getConfig(),\n      }),\n      routeGetStore: () => this.#routes.getStore(),\n      // Cross-namespace state (issue #174)\n      getStateName: () => this.#state.get()?.name,\n      isTransitioning: () => this.#eventBus.isTransitioning(),\n      clearState: () => {\n        this.#state.set(undefined);\n      },\n      setState: (state) => {\n        this.#state.set(state);\n      },\n      routerExtensions: [],\n      contextClaimRecords: new Set(),\n      hydrationState: null,\n    });\n\n    // =========================================================================\n    // Wire Dependencies\n    // =========================================================================\n\n    wireNamespaces<Dependencies>({\n      router: this,\n      options: this.#options,\n      limits: this.#limits,\n      dependenciesStore: this.#dependenciesStore,\n      state: this.#state,\n      routes: this.#routes,\n      routeLifecycle: this.#routeLifecycle,\n      plugins: this.#plugins,\n      navigation: this.#navigation,\n      lifecycle: this.#lifecycle,\n      eventBus: this.#eventBus,\n    });\n\n    // =========================================================================\n    // Bind Public Methods\n    // =========================================================================\n    // All public methods that access private fields must be bound to preserve\n    // `this` context when methods are extracted as references.\n    // See: https://github.com/tc39/proposal-bind-operator\n    // =========================================================================\n\n    // Path & State Building\n    this.isActiveRoute = this.isActiveRoute.bind(this);\n    this.buildPath = this.buildPath.bind(this);\n\n    // State Management\n    this.getState = this.getState.bind(this);\n    this.getPreviousState = this.getPreviousState.bind(this);\n    this.areStatesEqual = this.areStatesEqual.bind(this);\n    this.shouldUpdateNode = this.shouldUpdateNode.bind(this);\n\n    // Router Lifecycle\n    this.isActive = this.isActive.bind(this);\n    this.start = this.start.bind(this);\n    this.stop = this.stop.bind(this);\n    this.dispose = this.dispose.bind(this);\n\n    // Route Lifecycle (Guards)\n    this.canNavigateTo = this.canNavigateTo.bind(this);\n\n    // Plugins\n    this.usePlugin = this.usePlugin.bind(this);\n\n    // Navigation\n    this.navigate = this.navigate.bind(this);\n    this.navigateToDefault = this.navigateToDefault.bind(this);\n    this.navigateToNotFound = this.navigateToNotFound.bind(this);\n\n    // Subscription\n    this.subscribe = this.subscribe.bind(this);\n    this.subscribeLeave = this.subscribeLeave.bind(this);\n    this.isLeaveApproved = this.isLeaveApproved.bind(this);\n\n    // =========================================================================\n    // Flush initial-route guard factories\n    // =========================================================================\n    // Deferred out of wiring (#1331): the pending canActivate/canDeactivate\n    // factories from initial route definitions are compiled and executed HERE,\n    // on the fully-built and bound router — a factory calling read-only methods\n    // (`buildPath()`, `isActiveRoute()`, `getState()`) no longer hits a\n    // half-assembled instance. Side-effectful calls (`navigate`, `usePlugin`,\n    // route-CRUD) stay OUT OF CONTRACT: factories re-execute outside the\n    // constructor (cloneRouter re-compiles definition guards per clone;\n    // #recompileSlot re-runs a factory after a definition-only clear), so any\n    // side effect would duplicate per re-execution — see CLAUDE.md. Runtime\n    // add()/replace() compile guards in their own PREPARE phase and never touch\n    // these pending maps.\n    //\n    // Fail-closed on a factory throw: by this point a router reference leaked\n    // from an earlier factory is fully operational, while later guards would\n    // stay silently unregistered — a fail-open guard bypass. Disposing before\n    // the rethrow turns any leaked reference into a ROUTER_DISPOSED-throwing\n    // husk (pre-#1331 such a reference was inert because getInternals threw).\n    try {\n      this.#routes.flushPendingGuards();\n    } catch (error) {\n      this.dispose();\n\n      throw error;\n    }\n  }\n\n  // ============================================================================\n  // Path & State Building\n  // ============================================================================\n\n  isActiveRoute(\n    name: string,\n    params?: Params,\n    strictEquality?: boolean,\n    ignoreQueryParams?: boolean,\n  ): boolean {\n    getInternals(this).validator?.routes.validateIsActiveRouteArgs(\n      name,\n      params,\n      strictEquality,\n      ignoreQueryParams,\n    );\n\n    getInternals(this).validator?.routes.validateRouteName(\n      name,\n      \"isActiveRoute\",\n    );\n\n    // Empty string is special case - warn and return false (root node is not a parent)\n    if (name === \"\") {\n      getInternals(this).logger.warn(\n        \"real-router\",\n        'isActiveRoute(\"\") called with empty string. Root node is not considered a parent of any route.',\n      );\n\n      return false;\n    }\n\n    return this.#routes.isActiveRoute(\n      name,\n      params,\n      strictEquality,\n      ignoreQueryParams,\n    );\n  }\n\n  buildPath(route: string, params?: Params): string {\n    const ctx = getInternals(this);\n\n    ctx.validator?.routes.validateBuildPathArgs(route);\n    ctx.validator?.navigation.validateParams(params, \"buildPath\");\n\n    return ctx.buildPath(route, normalizeParams(params));\n  }\n\n  // ============================================================================\n  // State Management (delegated to StateNamespace)\n  // ============================================================================\n\n  getState<P extends Params = Params>(): State<P> | undefined {\n    return this.#state.get<P>();\n  }\n\n  getPreviousState(): State | undefined {\n    return this.#state.getPrevious();\n  }\n\n  areStatesEqual(\n    state1: State | undefined,\n    state2: State | undefined,\n    ignoreQueryParams = true,\n  ): boolean {\n    getInternals(this).validator?.state.validateAreStatesEqualArgs(\n      state1,\n      state2,\n      ignoreQueryParams,\n    );\n\n    return this.#state.areStatesEqual(state1, state2, ignoreQueryParams);\n  }\n\n  shouldUpdateNode(\n    nodeName: string,\n  ): (toState: State, fromState?: State) => boolean {\n    getInternals(this).validator?.routes.validateShouldUpdateNodeArgs(nodeName);\n\n    return RoutesNamespace.shouldUpdateNode(nodeName);\n  }\n\n  // ============================================================================\n  // Router Lifecycle\n  // ============================================================================\n\n  isActive(): boolean {\n    return this.#eventBus.isActive();\n  }\n\n  start(startPath: string): Promise<State> {\n    if (!this.#eventBus.canStart()) {\n      return Promise.reject(CACHED_ALREADY_STARTED_ERROR);\n    }\n\n    getInternals(this).validator?.navigation.validateStartArgs(startPath);\n\n    // FSM bookkeeping is split across the facade and RouterLifecycleNamespace by\n    // design, NOT a missed consolidation (#940): `sendStart()` runs HERE, before\n    // the interceptor chain, so the STARTING window spans the whole start\n    // pipeline. A pre-`next()` interceptor throw then unwinds via STARTING →\n    // `sendFail`, which emits TRANSITION_ERROR from STARTING (EventBusNamespace\n    // FAIL action) for `onTransitionError` plugins. Moving `sendStart()` into the\n    // namespace (the interceptor *target*) would skip STARTING on a pre-`next()`\n    // throw — the namespace is never reached — silently dropping that\n    // TRANSITION_ERROR: a #668 regression. The commit (`completeStart`) lives in\n    // the namespace; recovery needs facade state (`#state`, `#lifecycle`), so it\n    // stays here in `#unwindFailedStart`.\n    this.#eventBus.sendStart();\n\n    // Convert sync interceptor throws to rejections so the recovery path is\n    // reachable; otherwise the throw escapes synchronously, the FSM is left in\n    // STARTING, and the router is permanently bricked (#668).\n    let internalStart: Promise<State>;\n\n    try {\n      const chainResult: unknown = getInternals(this).start(startPath);\n\n      // A `start` interceptor that returns without calling next() yields a\n      // non-thenable (typically undefined); the `.catch` below would then throw\n      // a cryptic `TypeError: ...reading 'catch'` and leave the FSM stuck in\n      // STARTING. Reject with an actionable message so recovery unwinds via\n      // #unwindFailedStart — the same deferred-crash class as the #939\n      // start-path guard (#1411).\n      internalStart =\n        typeof (chainResult as { then?: unknown } | null | undefined)?.then ===\n        \"function\"\n          ? (chainResult as Promise<State>)\n          : Promise.reject(\n              new TypeError(\n                \"[router.start] a `start` interceptor returned without calling next(). Every start interceptor must return `next(path)`.\",\n              ),\n            );\n    } catch (syncError: unknown) {\n      // eslint-disable-next-line @typescript-eslint/prefer-promise-reject-errors -- preserve original throw shape from user-provided start interceptor\n      internalStart = Promise.reject(syncError);\n    }\n\n    const promiseState = internalStart.catch((error: unknown) =>\n      this.#unwindFailedStart(error),\n    );\n\n    this.#suppressUnhandledRejection(\n      promiseState,\n      this.#onSuppressedStartError,\n    );\n\n    return promiseState;\n  }\n\n  stop(): this {\n    // SendCancelIfPossible → FSM CANCEL → the CANCEL action\n    // aborts the in-flight controller (waking the pipeline). No separate abort.\n    this.#eventBus.sendCancelIfPossible(this.#state.get());\n\n    // `isStarting()` is included (#1185): a stop() while `start()` is parked in\n    // an async start-interceptor (FSM STARTING, before `next()`) must cancel the\n    // start, not silently no-op. `sendStop()` takes STARTING → IDLE (FSM table),\n    // and `RouterLifecycleNamespace.start` re-checks `isIdle()` after the\n    // interceptor chain and rejects with TRANSITION_CANCELLED — mirroring the\n    // guard-phase behavior (which already cancels from TRANSITION_STARTED).\n    if (\n      !this.#eventBus.isReady() &&\n      !this.#eventBus.isTransitioning() &&\n      !this.#eventBus.isStarting()\n    ) {\n      return this;\n    }\n\n    this.#lifecycle.stop();\n    this.#eventBus.sendStop();\n\n    return this;\n  }\n\n  dispose(): void {\n    // Stryker disable next-line BlockStatement: equivalent — emptying the early-return re-runs the dispose body on a 2nd call, but it is fully idempotent (FSM `send(DISPOSE)` no-ops from DISPOSED, `disposeAll()` already cleared `#unsubscribes`, every clear is idempotent). (ConditionalExpression stays live: `→true` always-returns and never disposes = killed.)\n    if (this.#eventBus.isDisposed()) {\n      return;\n    }\n\n    // the FSM CANCEL action aborts the in-flight controller.\n    this.#eventBus.sendCancelIfPossible(this.#state.get());\n\n    if (this.#eventBus.isReady() || this.#eventBus.isTransitioning()) {\n      this.#lifecycle.stop();\n      this.#eventBus.sendStop();\n    }\n\n    this.#eventBus.sendDispose();\n    this.#eventBus.clearAll();\n\n    this.#plugins.disposeAll();\n\n    // Safety net: clean up extensions plugins failed to remove in teardown\n    const ctx = getInternals(this);\n\n    for (const extension of ctx.routerExtensions) {\n      for (const key of extension.keys) {\n        delete (this as Record<string, unknown>)[key];\n      }\n    }\n\n    ctx.routerExtensions.length = 0;\n\n    // Safety net: release context namespace claims plugins failed to release in teardown\n    ctx.contextClaimRecords.clear();\n\n    // Safety net: drop interceptors plugins failed to remove in teardown (#1199).\n    // The third per-plugin registration channel — symmetric with routerExtensions\n    // / contextClaimRecords above. `buildPath` is not method-swapped by dispose\n    // and reads this Map live, so a leaked interceptor would otherwise still run\n    // on the disposed router.\n    ctx.interceptors.clear();\n\n    this.#routes.clearRoutes();\n    this.#routeLifecycle.clearAll();\n    this.#state.reset();\n    this.#dependenciesStore.dependencies = Object.create(\n      null,\n    ) as Partial<Dependencies>;\n\n    this.#markDisposed();\n  }\n\n  // ============================================================================\n  // Route Lifecycle (Guards)\n  // ============================================================================\n\n  canNavigateTo(name: string, params?: Params): boolean {\n    const ctx = getInternals(this);\n\n    ctx.validator?.routes.validateRouteName(name, \"canNavigateTo\");\n    ctx.validator?.navigation.validateParams(params, \"canNavigateTo\");\n\n    if (!this.#routes.hasRoute(name)) {\n      return false;\n    }\n\n    const { name: resolvedName, params: resolvedParams } = ctx.forwardState(\n      name,\n      params ?? {},\n    );\n\n    // Build `toState` exactly as `buildNavigateState` does — WITH route-meta and\n    // normalized params — so `getTransitionPath` takes its STANDARD PATH and\n    // trims the shared ancestor, mirroring navigate's guard set (#970). A\n    // meta-less `toState` makes both sides meta-less (the committed `getState()`\n    // carries no meta after a path-matched `start()`), so `getTransitionPath`\n    // takes FAST PATH 3 and (de)activates the WHOLE chain incl. shared ancestors\n    // → false-negative (\"Link disabled though the click would succeed\").\n    // `normalizeParams` also aligns the params guards observe with navigate's.\n    // `skipFreeze` (5th arg) mirrors the navigate guard phase, where guards see\n    // an unfrozen, transition-less `toState` (freeze happens later in\n    // `completeTransition`).\n    //\n    // A capability predicate must answer, not throw: if the target path can't be\n    // built from these params (e.g. a required path param is missing), the route\n    // is simply unreachable with this input — return `false` rather than letting\n    // `buildPath` throw (#725).\n    let toState: State;\n\n    try {\n      const normalizedParams = normalizeParams(resolvedParams);\n      const meta = this.#routes.getMetaForState(resolvedName);\n      const path = ctx.buildPath(resolvedName, normalizedParams);\n\n      toState = this.#state.makeState(\n        resolvedName,\n        normalizedParams,\n        path,\n        meta,\n        true,\n      );\n    } catch {\n      return false;\n    }\n\n    const fromState = this.#state.get();\n\n    const { toDeactivate, toActivate } = getTransitionPath(toState, fromState);\n\n    return this.#routeLifecycle.canNavigateTo(\n      toDeactivate,\n      toActivate,\n      toState,\n      fromState,\n    );\n  }\n\n  // ============================================================================\n  // Plugins\n  // ============================================================================\n\n  usePlugin(\n    ...plugins: (PluginFactory<Dependencies> | false | null | undefined)[]\n  ): Unsubscribe {\n    // Post-dispose guard, mirroring #946 for subscribe/subscribeLeave. A\n    // reference captured before dispose() (`const up = router.usePlugin`)\n    // bypasses the #markDisposed method swap, so the swap alone is not enough:\n    // without this, the factory would run on a disposed router (real side\n    // effects), listeners would land in the cleared emitter, and teardown would\n    // never fire — a silent zombie plugin (#1196).\n    if (this.#eventBus.isDisposed()) {\n      throw new RouterError(errorCodes.ROUTER_DISPOSED);\n    }\n\n    const filtered = plugins.filter(Boolean) as PluginFactory<Dependencies>[];\n\n    if (filtered.length === 0) {\n      return () => {};\n    }\n\n    const ctx = getInternals(this);\n\n    ctx.validator?.plugins.validatePluginLimit(\n      this.#plugins.count(),\n      this.#limits,\n    );\n    for (const plugin of filtered) {\n      // `getAll()` sits inside the optional-chain argument on purpose: with no\n      // validator installed (production default) the `?.` short-circuits and the\n      // array is never allocated. Hoisting it out would either allocate on the\n      // no-validator hot path or push the dev-only branch out of coverage.\n      ctx.validator?.plugins.validateNoDuplicatePlugins(\n        plugin,\n        this.#plugins.getAll(),\n      );\n    }\n\n    return this.#plugins.use(...filtered);\n  }\n\n  // ============================================================================\n  // Subscription (backed by EventEmitter)\n  // ============================================================================\n\n  subscribe(listener: SubscribeFn): Unsubscribe {\n    EventBusNamespace.validateSubscribeListener(listener);\n\n    return this.#eventBus.subscribe(listener);\n  }\n\n  subscribeLeave(listener: LeaveFn): Unsubscribe {\n    EventBusNamespace.validateSubscribeLeaveListener(listener);\n\n    return this.#eventBus.subscribeLeave(listener);\n  }\n\n  isLeaveApproved(): boolean {\n    return this.#eventBus.isLeaveApproved();\n  }\n\n  // ============================================================================\n  // Navigation\n  // ============================================================================\n\n  navigate(\n    routeName: string,\n    routeParams?: Params,\n    options?: NavigationOptions,\n  ): Promise<State> {\n    this.#assertNotReentrant();\n\n    const ctx = getInternals(this);\n\n    ctx.validator?.navigation.validateNavigateArgs(routeName);\n    ctx.validator?.navigation.validateParams(routeParams, \"navigate\");\n\n    const opts = options ?? EMPTY_OPTS;\n\n    ctx.validator?.navigation.validateNavigationOptions(opts, \"navigate\");\n\n    const promiseState = this.#navigation.navigate(\n      routeName,\n      routeParams ?? EMPTY_PARAMS,\n      opts,\n    );\n\n    if (this.#navigation.lastSyncResolved) {\n      this.#navigation.lastSyncResolved = false;\n    } else if (this.#navigation.lastSyncRejected) {\n      // Cached rejection — already pre-suppressed at module load, skip .catch()\n      this.#navigation.lastSyncRejected = false;\n    } else {\n      this.#suppressUnhandledRejection(promiseState);\n    }\n\n    return promiseState;\n  }\n\n  navigateToDefault(options?: NavigationOptions): Promise<State> {\n    this.#assertNotReentrant();\n\n    const ctx = getInternals(this);\n\n    ctx.validator?.navigation.validateNavigateToDefaultArgs(options);\n\n    const opts = options ?? EMPTY_OPTS;\n\n    ctx.validator?.navigation.validateNavigationOptions(\n      opts,\n      \"navigateToDefault\",\n    );\n\n    const promiseState = this.#navigation.navigateToDefault(opts);\n\n    if (this.#navigation.lastSyncResolved) {\n      this.#navigation.lastSyncResolved = false;\n    } else if (this.#navigation.lastSyncRejected) {\n      this.#navigation.lastSyncRejected = false;\n    } else {\n      this.#suppressUnhandledRejection(promiseState);\n    }\n\n    return promiseState;\n  }\n\n  navigateToNotFound(path?: string): State {\n    this.#assertNotReentrant();\n\n    if (!this.#eventBus.isActive()) {\n      throw new RouterError(errorCodes.ROUTER_NOT_STARTED);\n    }\n\n    if (path !== undefined && typeof path !== \"string\") {\n      throw new TypeError(\n        `[router.navigateToNotFound] path must be a string, got ${typeof path}`,\n      );\n    }\n\n    if (path !== undefined) {\n      return this.#navigation.navigateToNotFound(path);\n    }\n\n    // #1172: a path-less call derives the default path from the committed state.\n    // During the two-phase start window the router is active (`isActive()` true)\n    // while `getState()` is still undefined, so throw an actionable RouterError\n    // instead of a cryptic `TypeError` from dereferencing the absent state —\n    // same class as the #939 always-on invariant guards.\n    const current = this.#state.get();\n\n    if (current === undefined) {\n      throw new RouterError(errorCodes.ROUTER_NOT_STARTED, {\n        message:\n          \"[router.navigateToNotFound] cannot derive the path before the start navigation commits — pass an explicit path\",\n      });\n    }\n\n    return this.#navigation.navigateToNotFound(current.path);\n  }\n\n  /**\n   * Classifies a fire-and-forget rejection as an EXPECTED outcome that must\n   * stay silent (no log). Shared by the navigate and start suppressors so the\n   * suppression contract lives in one place.\n   *\n   * A suppressed RouterError code is a normal caller-owned navigation result\n   * (a guard block, SAME_STATES, ROUTER_NOT_STARTED, …) — see\n   * SUPPRESSED_ERROR_CODES (#721).\n   *\n   * The #945 RecursionDepthError carve-out is gone: a reentrant navigate() from a\n   * listener can no longer self-feed — it throws REENTRANT_NAVIGATION\n   * synchronously at the facade (RFC navigation-cancellation-unification §4), so\n   * navigate()'s promise never rejects with a recursion error (re-entrant emits\n   * are coalesced at the emitter, #1033; reentrant route-CRUD throws\n   * REENTRANT_TREE_MUTATION to the CRUD caller, #1032 — not through a navigate\n   * promise).\n   */\n  static #isExpectedRejection(error: unknown): boolean {\n    return (\n      error instanceof RouterError && SUPPRESSED_ERROR_CODES.has(error.code)\n    );\n  }\n\n  /**\n   * Fire-and-forget safety: prevents unhandled rejection warnings when\n   * navigate/navigateToDefault/start is called without await. Expected errors\n   * are silently suppressed; unexpected ones are logged under `onSuppressed`'s\n   * category — navigate by default; start() passes #onSuppressedStartError so\n   * its failures are logged as \"router.start\", not \"router.navigate\" (#931).\n   */\n  #suppressUnhandledRejection(\n    promise: Promise<State>,\n    onSuppressed: (error: unknown) => void = this.#onSuppressedNavigateError,\n  ): void {\n    promise.catch(onSuppressed);\n  }\n\n  /**\n   * Rejects a synchronous reentrant navigation — `navigate` /\n   * `navigateToDefault` / `navigateToState` / `navigateToNotFound` called from\n   * inside a transition-event listener while a transition is being dispatched\n   * (RFC navigation-cancellation-unification §4). Throws synchronously: inside a\n   * listener the emit's `onListenerError` isolation surfaces it (visible,\n   * non-fatal); a DEFERRED (async / microtask) navigate from a listener runs\n   * after dispatch settles and is allowed. Always-on core invariant guard (not\n   * validator-gated).\n   */\n  #assertNotReentrant(): void {\n    if (this.#eventBus.isProcessing()) {\n      throw new RouterError(errorCodes.REENTRANT_NAVIGATION);\n    }\n  }\n\n  /**\n   * Settles the FSM after a failed start pipeline, then re-throws so the\n   * rejection still surfaces to the caller. Three cases, by what the pipeline\n   * reached before throwing:\n   *\n   * - **Pre-commit, READY** (`isReady()` and no committed state): an interceptor\n   *   threw after `completeStart()` reached READY but before any state committed\n   *   (e.g. an activation guard blocked the start navigation) — return READY →\n   *   IDLE via `stop()` so the router is reusable.\n   * - **Pre-commit, STARTING** (`isStarting()`): the pipeline threw before\n   *   `completeStart()` — a sync interceptor throw before `next()`, or a throw\n   *   inside the namespace before commit — so unwind STARTING → IDLE via\n   *   `sendFail`, which also emits TRANSITION_ERROR from STARTING (#668).\n   * - **Post-commit, READY with committed state** (neither branch fires): a\n   *   loader/interceptor threw AFTER `navigateToState` committed and emitted\n   *   TRANSITION_SUCCESS (the SSR/RSC loader window). Keep the committed state —\n   *   rolling back would retract an observed success (\"phantom success\", #763);\n   *   the error still surfaces via the re-throw.\n   */\n  #unwindFailedStart(error: unknown): never {\n    if (this.#eventBus.isReady() && this.#state.get() === undefined) {\n      this.#lifecycle.stop();\n      this.#eventBus.sendStop();\n    } else if (this.#eventBus.isStarting()) {\n      this.#eventBus.sendFail(undefined, undefined, error);\n    }\n\n    throw error;\n  }\n\n  #markDisposed(): void {\n    this.navigate = throwDisposed;\n    this.navigateToDefault = throwDisposed;\n    this.navigateToNotFound = throwDisposed;\n    this.start = throwDisposed;\n    this.stop = throwDisposed;\n    this.usePlugin = throwDisposed;\n\n    this.subscribe = throwDisposed;\n    this.subscribeLeave = throwDisposed;\n    this.canNavigateTo = throwDisposed;\n  }\n}\n\nfunction throwDisposed(): never {\n  throw new RouterError(errorCodes.ROUTER_DISPOSED);\n}\n\n/**\n * Derives CreateMatcherOptions from router Options.\n * Maps core option names to matcher option names.\n */\nfunction deriveMatcherOptions(\n  options: Readonly<Options>,\n): CreateMatcherOptions {\n  return {\n    strictTrailingSlash: options.trailingSlash === \"strict\",\n    caseSensitive: options.caseSensitive,\n    strictQueryParams: options.queryParamsMode === \"strict\",\n    urlParamsEncoding: options.urlParamsEncoding,\n    // eslint-disable-next-line @typescript-eslint/no-non-null-assertion\n    queryParams: options.queryParams!,\n  };\n}\n"],"mappings":"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"}

package/dist/cjs/buildParamMeta-DniluAIV.js.map

@@ -1 +1 @@
-{"version":3,"file":"buildParamMeta-DniluAIV.js","names":["LT","QUESTION","SLASH"],"sources":["../../src/internals.ts","../../src/engine/path-matcher/parseSegment.ts","../../src/engine/path-matcher/buildParamMeta.ts"],"sourcesContent":["import type { RouteTree } from \"./engine\";\nimport type { DependenciesStore } from \"./namespaces\";\nimport type { RoutesStore } from \"./namespaces/RoutesNamespace\";\nimport type { Router as RouterClass } from \"./Router\";\nimport type {\n  DefaultDependencies,\n  EventName,\n  LoggerConfig,\n  NavigationOptions,\n  Options,\n  Params,\n  Plugin,\n  Router as RouterInterface,\n  RouterLogger,\n  RouteTreeState,\n  SerializedRouterState,\n  SimpleState,\n  State,\n  TreeChangedEvent,\n  Unsubscribe,\n  EventMethodMap,\n  PluginFactory,\n} from \"./types\";\nimport type { RouterValidator } from \"./types/RouterValidator\";\n\nexport interface RouterInternals<\n  D extends DefaultDependencies = DefaultDependencies,\n> {\n  readonly makeState: <P extends Params = Params>(\n    name: string,\n    params?: P,\n    path?: string,\n    meta?: Record<string, Record<string, \"url\" | \"query\">>,\n  ) => State<P>;\n\n  readonly forwardState: <P extends Params = Params>(\n    routeName: string,\n    routeParams: P,\n  ) => SimpleState<P>;\n\n  readonly buildStateResolved: (\n    resolvedName: string,\n    resolvedParams: Params,\n  ) => RouteTreeState | undefined;\n\n  readonly matchPath: <P extends Params = Params>(\n    path: string,\n    options?: Options,\n  ) => State<P> | undefined;\n\n  readonly getOptions: () => Options;\n\n  readonly addEventListener: <E extends EventName>(\n    eventName: E,\n    cb: Plugin[EventMethodMap[E]],\n  ) => Unsubscribe;\n\n  /**\n   * Route-tree mutation channel — internal access for the `getRoutesApi`\n   * wrapper. A dedicated bridge is required because the public\n   * `addEventListener<E extends EventName>` structurally rejects\n   * `\"TREE_CHANGED\"` (it is not in the public `EventName` union), is strict on\n   * duplicates, and exposes neither `emit` nor `listenerCount`.\n   */\n  readonly treeChanged: {\n    readonly emit: (event: TreeChangedEvent) => void;\n    readonly subscribe: (\n      handler: (event: TreeChangedEvent) => void,\n    ) => Unsubscribe;\n    readonly listenerCount: () => number;\n    /**\n     * True while a `TREE_CHANGED` emit is on the stack — `getRoutesApi` reads it\n     * to reject reentrant route-CRUD from a `subscribeChanges` handler (#1032).\n     */\n    readonly isEmitting: () => boolean;\n  };\n\n  readonly buildPath: (route: string, params?: Params) => string;\n\n  readonly emitTransitionError: (error: Error) => void;\n\n  /**\n   * Emits `TRANSITION_SUCCESS` directly (no FSM transition) — used by\n   * `getRoutesApi().replace()` to notify `router.subscribe` listeners when a\n   * structural replace revalidates the active state (#950). Mirrors the success\n   * emission `completeTransition` / `navigateToNotFound` perform.\n   */\n  readonly emitTransitionSuccess: (\n    toState: State,\n    fromState: State | undefined,\n    opts?: NavigationOptions,\n  ) => void;\n\n  /**\n   * Commits the not-found (`UNKNOWN_ROUTE`) state for `path` and emits\n   * `TRANSITION_SUCCESS` — the `NavigationNamespace.navigateToNotFound`\n   * primitive. `replace()` uses it when a structural replace drops the active\n   * route, so subscribers are notified instead of the state silently clearing\n   * (#950).\n   */\n  readonly navigateToNotFound: (path: string) => State;\n\n  readonly start: (path: string) => Promise<State>;\n\n  /**\n   * Plugin-only navigation entry point — delegates to\n   * `NavigationNamespace.navigateToState` (`getPluginApi(router).navigateToState`).\n   * Hidden from `Router`/`Navigator` to keep the userland surface minimal;\n   * see `core-types/src/api.ts` for usage docs.\n   */\n  readonly navigateToState: (\n    state: State,\n    options?: NavigationOptions,\n  ) => Promise<State>;\n\n  /* eslint-disable @typescript-eslint/no-explicit-any -- heterogeneous map: stores different InterceptorFn<M> types under different keys */\n  readonly interceptors: Map<\n    string,\n    ((next: (...args: any[]) => any, ...args: any[]) => any)[]\n  >;\n  /* eslint-enable @typescript-eslint/no-explicit-any */\n\n  readonly setRootPath: (rootPath: string) => void;\n  readonly getRootPath: () => string;\n\n  readonly getTree: () => RouteTree;\n\n  readonly isDisposed: () => boolean;\n\n  validator: RouterValidator | null;\n\n  // Per-router logger instance (built from `options.logger` in the Router\n  // constructor). The facade reads it as `getInternals(this).logger`; namespaces\n  // receive it via their deps at wiring; plugins reach it through\n  // `getPluginApi(router).logger`. Replaces the former process-global singleton\n  // from the standalone `@real-router/logger` package (now folded into\n  // `foundation/logger`), whose `configure()` leaked across routers (#724).\n  readonly logger: RouterLogger;\n\n  // Dependencies (issue #172)\n  readonly dependenciesGetStore: () => DependenciesStore<D>;\n\n  // Clone support (issue #173, consolidated #964). One accessor for the\n  // source-side snapshot a clone carries over besides the route store, so a new\n  // clone-relevant subsystem is wired in a single place instead of being spread\n  // across separate methods.\n  readonly getCloneState: () => {\n    options: Options;\n    dependencies: Record<string, unknown>;\n    pluginFactories: PluginFactory<D>[];\n    // Resolved logger config of the base router, so a clone can build its OWN\n    // logger inheriting the base's level/callback. Frozen `options` do NOT carry\n    // `logger` (stripped in the constructor), so `options` above can't convey it;\n    // cloneRouter merges a per-request override (traceId) over this snapshot.\n    loggerConfig: LoggerConfig;\n  };\n\n  // Consolidated route data store (issue #174 Phase 2)\n  readonly routeGetStore: () => RoutesStore<D>;\n\n  // Cross-namespace state (issue #174)\n  readonly getStateName: () => string | undefined;\n  readonly isTransitioning: () => boolean;\n  readonly clearState: () => void;\n  readonly setState: (state: State) => void;\n  readonly routerExtensions: { keys: string[] }[];\n  readonly contextClaimRecords: Set<string>;\n\n  /**\n   * One-shot hydration scratchpad populated by `hydrateRouter` immediately\n   * before delegating to `router.start(parsed.path)` and cleared in the\n   * matching `finally`. SSR loader plugins read this slot directly via\n   * `getInternals(router).hydrationState` to short-circuit their own loader\n   * call when the server-resolved namespace value is already present in the\n   * parsed state (#596). `null` outside of an active `hydrateRouter`\n   * invocation.\n   */\n  hydrationState: SerializedRouterState | null;\n}\n\n// eslint-disable-next-line @typescript-eslint/no-explicit-any -- existential type: stores RouterInternals for all Dependencies types\nconst internals = new WeakMap<object, RouterInternals<any>>();\n\nexport function getInternals<D extends DefaultDependencies>(\n  router: RouterInterface<D>,\n): RouterInternals<D> {\n  const ctx = internals.get(router);\n\n  if (!ctx) {\n    throw new TypeError(\n      \"[real-router] Invalid router instance — not found in internals registry\",\n    );\n  }\n\n  return ctx as RouterInternals<D>;\n}\n\nexport function registerInternals<D extends DefaultDependencies>(\n  router: RouterClass<D>,\n  ctx: RouterInternals<D>,\n): void {\n  internals.set(router, ctx);\n}\n\n/* eslint-disable @typescript-eslint/no-explicit-any, @typescript-eslint/no-unsafe-return, @typescript-eslint/no-unsafe-argument -- internal chain execution: type safety enforced at public API boundary (PluginApi.addInterceptor) */\nfunction executeInterceptorChain<T>(\n  interceptors: ((next: (...args: any[]) => any, ...args: any[]) => any)[],\n  original: (...args: any[]) => T,\n  args: any[],\n): T {\n  let chain = original as (...args: any[]) => any;\n\n  for (const interceptor of interceptors) {\n    const prev = chain;\n\n    chain = (...chainArgs: any[]) => interceptor(prev, ...chainArgs);\n  }\n\n  return chain(...args) as T;\n}\n\n/**\n * Variadic interceptor wrapper — wraps a function of any arity, returning the\n * same callable type `T`. Use {@link createBinaryInterceptable} instead when the\n * wrapped method takes exactly two args and the caller needs the precise\n * `(a, b) => r` signature preserved (the variadic form widens args to `any[]`).\n */\nexport function createInterceptable<T extends (...args: any[]) => any>(\n  name: string,\n  original: T,\n  interceptors: Map<\n    string,\n    ((next: (...args: any[]) => any, ...args: any[]) => any)[]\n  >,\n): T {\n  return ((...args: any[]) => {\n    const chain = interceptors.get(name);\n\n    if (!chain || chain.length === 0) {\n      return original(...args);\n    }\n\n    return executeInterceptorChain(chain, original, args);\n  }) as T;\n}\n\n/**\n * Two-argument interceptor wrapper — preserves the exact `(a: A, b: B) => R`\n * signature, which the variadic {@link createInterceptable} cannot express\n * (it widens args to `any[]`). Used for the binary interceptable methods\n * `forwardState(routeName, routeParams)` and `buildPath(route, params)`.\n */\nexport function createBinaryInterceptable<A, B, R>(\n  name: string,\n  original: (a: A, b: B) => R,\n  interceptors: Map<\n    string,\n    ((next: (...args: any[]) => any, ...args: any[]) => any)[]\n  >,\n): (a: A, b: B) => R {\n  return (arg1: A, arg2: B) => {\n    const chain = interceptors.get(name);\n\n    if (!chain || chain.length === 0) {\n      return original(arg1, arg2);\n    }\n\n    return executeInterceptorChain(chain, original, [arg1, arg2]);\n  };\n}\n/* eslint-enable @typescript-eslint/no-explicit-any, @typescript-eslint/no-unsafe-return, @typescript-eslint/no-unsafe-argument */\n","/**\n * Canonical route-segment tokenizer.\n *\n * The single owner of \"where does a name / marker / constraint end\" for ONE\n * path segment (post-`/`-split). It replaces the five name-boundary compositions\n * of `PARAM_NAME_PATTERN` currently spread across `buildParamMeta` (L1),\n * `registration` (L2 build + L3 trie), and `route-tree`'s validation gate (L4),\n * so those layers can never disagree on a boundary (the gate↔backstop drift\n * class — #858 / #1050 / #1150 / #1311 / #1149 / #1324).\n *\n * A single left-to-right `charCodeAt` scan produces either a token tuple or a\n * typed error. Grammar — **3 tokens only** (`static | :param | *splat`); the\n * grammar has no optional `:x?` or `<re>` constraint forms. Any `<`/`>` or a\n * post-name `?` in the path is a *registration error* carrying a replacement\n * recipe (`optional-removed` / `constraint-removed`), not a token:\n * 1. Leading `:`/`*` → param/splat; otherwise `static` (a marker glued *after* a\n *    static prefix ⇒ `fused-marker`; any `<`/`>` (a former constraint) ⇒\n *    `constraint-removed`; a trailing `?` on a marker-less segment ⇒ `name-less`\n *    — the modifier has no param name, #1241 / `/faq?`).\n * 2. name = any char except `<`/`?` (no `/` remains inside a segment); a name\n *    ending in a bare `:`/`*` ⇒ `trailing-marker` (#1324). A *mid* marker stays\n *    a name char — `:a:b` → name `a:b`, preserved.\n * 3. empty name ⇒ `name-less` (#858).\n * 4. a `<` after the name (a former `<re>` constraint) ⇒ `constraint-removed`.\n * 5. a post-name `?` (a former optional modifier, on `:param` or `*splat`) ⇒\n *    `optional-removed`.\n *\n * @module parseSegment\n */\n\n/* eslint-disable unicorn/prefer-code-point, unicorn/prefer-includes-over-repeated-comparisons, sonarjs/cognitive-complexity -- charCodeAt code-unit scan + a single inlined branchy pass are this RFC's char-scan perf basis (§9); the same deliberate choices as registration/trie.ts hasNonAsciiSegment (#1285) and SegmentMatcher's inlined #traverseFrom. A `[LT,GT,QUESTION].includes(code)` boundary check would allocate an array literal per scanned char. Markers compared are ASCII (`:` `*` `<` `>` `?`, < 0x80). */\n\n/** A successfully tokenized segment (3-token grammar: `static | :param | *splat`). */\nexport type SegmentTokens =\n  | { readonly kind: \"static\"; readonly text: string }\n  | { readonly kind: \"param\"; readonly name: string }\n  | { readonly kind: \"splat\"; readonly name: string };\n\n/** Grammar-shape rejections, each mirroring a registration guard. */\nexport type SegmentErrorCode =\n  | \"name-less\" // #858 — a marker with no name\n  | \"trailing-marker\" // #1324 — a param name ending in a bare `:`/`*`\n  | \"fused-marker\" // #1050 — a marker glued after a static prefix\n  | \"optional-removed\" // M1 — a `:x?`/`*x?` optional modifier (removed; two sibling routes)\n  | \"constraint-removed\"; // M1 — a `<re>` constraint or stray `<`/`>` (removed; validate in a guard)\n\nexport interface SegmentError {\n  readonly error: SegmentErrorCode;\n}\n\nconst COLON = 58; // :\nconst STAR = 42; // *\nconst LT = 60; // <\nconst GT = 62; // >\nconst QUESTION = 63; // ?\nconst SLASH = 47; // /\n\nconst isMarker = (code: number): boolean => code === COLON || code === STAR;\n\n/**\n * Splits a path into its `/`-delimited segments. A plain `/`-split (M1): the\n * 3-token grammar has no `<...>` constraint whose body could legally contain a\n * `/`, so no constraint-awareness is needed — a stray `<`/`>` is a\n * `constraint-removed` error, caught per segment by `parseSegment`. This is the\n * **segmentation** half of the path-grammar unification: `parseSegment` owns the\n * per-segment grammar, `splitPathSegments` owns where a segment begins and ends.\n *\n * @param path - a route path (query already stripped by the caller)\n * @returns the segments in order, including empty leading/trailing/`//` segments\n *   (the caller skips empties, matching the current behaviour)\n */\nexport function splitPathSegments(path: string): string[] {\n  const segments: string[] = [];\n  let start = 0;\n\n  for (let i = 0; i < path.length; i += 1) {\n    if (path.charCodeAt(i) !== SLASH) {\n      continue;\n    }\n\n    segments.push(path.slice(start, i));\n    start = i + 1;\n  }\n\n  segments.push(path.slice(start));\n\n  return segments;\n}\n\n/**\n * Tokenizes a single path segment (already split on `/`).\n *\n * @param segment - one `/`-delimited segment of a route path\n * @returns the segment's tokens, or a typed grammar error\n */\nexport function parseSegment(segment: string): SegmentTokens | SegmentError {\n  const length = segment.length;\n\n  if (length === 0) {\n    return { kind: \"static\", text: \"\" };\n  }\n\n  // ---- static segment (no leading marker) -------------------------------\n  if (!isMarker(segment.charCodeAt(0))) {\n    for (let i = 0; i < length; i += 1) {\n      const code = segment.charCodeAt(i);\n\n      // A `<`/`>` (a former `<re>` constraint or a stray delimiter) is no longer\n      // grammar — M1 removed constraints. Reject with the constraint recipe.\n      if (code === LT || code === GT) {\n        return { error: \"constraint-removed\" };\n      }\n\n      // A marker glued after a static prefix is extracted as a param by build/meta\n      // but compiled as a static literal by the trie (#1050) — reject it as fused.\n      // A marker ENDING the segment (a static ending in `:`/`*` — `/a:`, `/a*`, F2)\n      // is NOT fused: caught by `i + 1 < length` being false. Every other following\n      // char is fused — including a `?` (`a:?`): that shape never reaches the\n      // tokenizer through a real path (a `?` after a bare marker is not a valid\n      // `:name?` form, so the query mask strips it before `/`-segmentation), so a\n      // direct call correctly reports fused-marker. (`a<`/`a>` already returned\n      // `constraint-removed` above, so no `<`-follows exception is needed here.)\n      if (isMarker(code) && i + 1 < length) {\n        return { error: \"fused-marker\" };\n      }\n    }\n\n    // A trailing `?` is a former optional modifier; on a marker-less segment (no\n    // param name) it is a modifier-with-no-name — name-less (#858/#1241, `/faq?`),\n    // NOT `optional-removed` (there is no param to route to two siblings). The\n    // backstop rejects it by the SAME rule: its `endsWith(\"?\")` fork routes the\n    // segment to `extractParamName` → this tokenizer. Owning the `?` here (not\n    // only in the marker branch) is what lets the gate and backstop agree on it —\n    // otherwise the gate reads `faq?` as a valid static (#1324 §4).\n    if (segment.charCodeAt(length - 1) === QUESTION) {\n      return { error: \"name-less\" };\n    }\n\n    return { kind: \"static\", text: segment };\n  }\n\n  const splat = segment.charCodeAt(0) === STAR;\n\n  // ---- name: up to the first `<`/`>` (former constraint delimiter, reserved —\n  // В1.3) or `?` (former optional). A segment holds no `/`. -----------------\n  let cursor = 1;\n\n  while (cursor < length) {\n    const code = segment.charCodeAt(cursor);\n\n    if (code === LT || code === GT || code === QUESTION) {\n      break;\n    }\n\n    cursor += 1;\n  }\n\n  const name = segment.slice(1, cursor);\n\n  if (name.length === 0) {\n    return { error: \"name-less\" }; // #858\n  }\n\n  if (isMarker(name.charCodeAt(name.length - 1))) {\n    return { error: \"trailing-marker\" }; // #1324\n  }\n\n  // ---- former constraint / optional modifiers (removed in M1) ------------\n  // The name scan stops at the first `<`/`>` or `?`. Either is a form removed\n  // in M1: a `<re>` constraint (also a stray `<`/`>` — В1.3), or a `:x?`/`*x?`\n  // optional. Only `?` is the optional; `<`/`>` are the constraint recipe.\n  // Reject with the matching replacement recipe rather than tokenize it.\n  if (cursor < length) {\n    return segment.charCodeAt(cursor) === QUESTION\n      ? { error: \"optional-removed\" }\n      : { error: \"constraint-removed\" }; // LT or GT\n  }\n\n  return splat ? { kind: \"splat\", name } : { kind: \"param\", name };\n}\n\n/**\n * Returns the first per-segment grammar error in a path, or `undefined` if every\n * segment tokenizes cleanly.\n *\n * The **validation-facing** entry over the tokenizer: `route-tree`'s\n * `validateRoutePath` calls this instead of re-running its own split+parse loop,\n * so the gate and the matcher's own grammar cannot drift (#1324) and the loop\n * stays single-sourced here — the tokenizer primitives (`parseSegment`,\n * `splitPathSegments`) need not leak into the package's public surface. An empty\n * segment tokenizes as `static` (never an error), so leading/trailing/`//`\n * empties are skipped naturally.\n *\n * @param path - a route path (query already stripped by the caller)\n * @returns the first `SegmentErrorCode` (scanned left to right), or `undefined`\n */\nexport function findSegmentGrammarError(\n  path: string,\n): SegmentErrorCode | undefined {\n  for (const segment of splitPathSegments(path)) {\n    const token = parseSegment(segment);\n\n    if (\"error\" in token) {\n      return token.error;\n    }\n  }\n\n  return undefined;\n}\n\n/** A removed-form (M1) match, describing the offending segment and — for an\n * optional — the two sibling paths that replace it (path without the optional\n * segment + path with the param made required). The route-tree gate uses this to\n * build a route-contextual replacement recipe; the matcher backstop uses only the\n * error code (a shorter, path-free recipe). */\nexport type RemovedForm =\n  | {\n      readonly code: \"optional-removed\";\n      readonly segment: string;\n      readonly withoutSegment: string;\n      readonly requiredForm: string;\n    }\n  | { readonly code: \"constraint-removed\"; readonly segment: string };\n\n/**\n * The rich (route-tree gate) view over the tokenizer for a removed form: finds\n * the first `optional-removed` / `constraint-removed` segment and, for an\n * optional, computes its two replacement sibling paths from the ACTUAL path\n * (dropping the segment → without-form; dropping the trailing `?` → required\n * form). Returns `undefined` if no removed form is present (the gate then uses\n * `findSegmentGrammarError` for a surviving grammar rejection).\n *\n * @param path - a route path (query already stripped by the caller)\n */\nexport function describeRemovedForm(path: string): RemovedForm | undefined {\n  const segments = splitPathSegments(path);\n\n  for (let i = 0; i < segments.length; i += 1) {\n    const token = parseSegment(segments[i]);\n\n    if (!(\"error\" in token)) {\n      continue;\n    }\n\n    // First error wins (mirrors `findSegmentGrammarError`): describe it ONLY if\n    // it is a removed form, else return undefined so the caller falls to the\n    // surviving-code message — this keeps the gate's reason in lockstep with the\n    // matcher backstop's first-error verdict.\n    if (token.error === \"optional-removed\") {\n      const segment = segments[i];\n      const required = [...segments];\n\n      // Drop the `?` optional modifier AND everything after it (the tokenizer\n      // stopped the name at the first `?`, so it is the modifier). Using the `?`\n      // index — not a blind `slice(0, -1)` — keeps the required sibling VALID for\n      // a reverse/compound form whose `?` is not the last char: `:b?<x>` → `:b`\n      // (not `:b?<x`), `:id??` → `:id` (not `:id?`). #1516\n      required[i] = segment.slice(0, segment.indexOf(\"?\"));\n\n      return {\n        code: \"optional-removed\",\n        segment,\n        withoutSegment: segments.filter((_, j) => j !== i).join(\"/\"),\n        requiredForm: required.join(\"/\"),\n      };\n    }\n\n    return token.error === \"constraint-removed\"\n      ? { code: \"constraint-removed\", segment: segments[i] }\n      : undefined;\n  }\n\n  return undefined;\n}\n","/**\n * Route Parameter Metadata Extraction.\n *\n * Extracts parameter metadata from route path patterns without requiring\n * a full path-parser instance. Replaces parser.urlParams/queryParams/spatParams.\n *\n * @module buildParamMeta\n */\n\nimport { parseSegment, splitPathSegments } from \"./parseSegment\";\n\nimport type { ParamMeta } from \"./types\";\n\n/**\n * A query-param NAME may not contain `<`/`>` (#1242 §5.1) — a constraint\n * delimiter leaked into the query via a reverse-order modifier typo (`/a/:b?<c>`\n * parses the `?` as the query start, making `<c>` the query name). Consumed by\n * the route-tree gate and the `registerTree` backstop; relocated here from the\n * deleted `constraint-grammar.ts` when M1 removed constraints (query-param name\n * validation is a query concern, and this module owns query extraction).\n */\nexport const INVALID_QUERY_NAME_RGX = /[<>]/u;\n\nconst QUESTION = 0x3f; // ?\nconst SLASH = 0x2f; // /\nconst LT = 0x3c; // <\n\n/**\n * Locates the query separator `?` in a route path — the FIRST `?` whose tail is\n * non-empty and does not begin with `/`, `?`, or `<` (M1 §3.3). The 3-token\n * grammar leaves `?` a single role (there is no optional modifier and no\n * constraint body to hide one), so no length-preserving mask is needed. The three\n * excluded tails keep a REMOVED form in the path part, where `parseSegment`\n * rejects it with a recipe instead of mis-reading it as a query declaration:\n * - end-of-string (`/:id?`) and `/` (`/:id?/edit`) → a bare `:x?` optional;\n * - `?` (`/:id??tab`) → the leading `?` is the optional, the later `?` the query;\n * - `<` (`/a/:b?<x>`) → a reverse-order `:b?<x>` (optional then a former constraint).\n *\n * @param path - a route path\n * @returns the index of the query separator, or -1 if there is none\n */\nfunction findQuerySeparator(path: string): number {\n  for (let i = 0; i < path.length; i += 1) {\n    if (path.codePointAt(i) !== QUESTION) {\n      continue;\n    }\n\n    // `next` is the code point after the `?`, or the `-1` sentinel at end-of-string.\n    // The `-1` sentinel is the SOLE end-of-string guard — the former separate\n    // `next !== undefined` conjunct was dead (the ternary bounds the index, so\n    // `codePointAt` never returns `undefined`; the `!` is a type assertion, not a\n    // runtime branch, so it keeps the scan at 100% coverage). Mirrors `#scanPath`.\n    // eslint-disable-next-line @typescript-eslint/no-non-null-assertion -- ternary-bounded in-range index; codePointAt is defined\n    const next = i + 1 < path.length ? path.codePointAt(i + 1)! : -1;\n\n    if (next !== -1 && next !== SLASH && next !== QUESTION && next !== LT) {\n      return i;\n    }\n  }\n\n  return -1;\n}\n\n/**\n * Builds parameter metadata from a route path pattern.\n *\n * Extracts URL parameters, query parameters, and splat parameters\n * from the path pattern string.\n *\n * @param path - Route path pattern (e.g., \"/users/:id/posts/:postId?q\")\n * @returns Parameter metadata object\n *\n * @example\n * ```typescript\n * buildParamMeta(\"/users/:id\")\n * // → { urlParams: [\"id\"], queryParams: [], spatParams: [], paramTypeMap: { id: \"url\" } }\n *\n * buildParamMeta(\"/search?q&page\")\n * // → { urlParams: [], queryParams: [\"q\", \"page\"], spatParams: [],\n * //     paramTypeMap: { q: \"query\", page: \"query\" } }\n *\n * buildParamMeta(\"/files/*path\")\n * // → { urlParams: [\"path\"], queryParams: [], spatParams: [\"path\"],\n * //     paramTypeMap: { path: \"url\" } }\n * ```\n */\n// Shared frozen sentinels for the common no-params case — avoid a fresh empty\n// array/object per route (#1009). ParamMeta fields are Readonly*; match/build\n// only read them, and computeCaches' Object.freeze on the arrays/object is a\n// no-op on an already-frozen shared instance.\nconst EMPTY_PARAM_NAMES: readonly string[] = Object.freeze([]);\nconst EMPTY_PARAM_TYPE_MAP: Readonly<Record<string, \"url\" | \"query\">> =\n  Object.freeze({});\n\n// Whole-meta shared sentinel for the fully-static case: every collection is a\n// #1009 sentinel AND pathPattern degenerates to the input path itself (no query\n// to strip), so the wrapper carries zero per-route information. The RETAINING\n// caller (route-tree's computeCaches) swaps a matching fresh result for this\n// instance — buildParamMeta itself keeps returning fresh objects so the\n// validation gate can read the real pathPattern of arbitrary input paths.\n// `pathPattern` is \"\" here; the one stored-meta reader (`registerNode`) falls\n// back to `node.path` on identity match.\nexport const EMPTY_PARAM_META: ParamMeta = Object.freeze({\n  urlParams: EMPTY_PARAM_NAMES,\n  queryParams: EMPTY_PARAM_NAMES,\n  spatParams: EMPTY_PARAM_NAMES,\n  paramTypeMap: EMPTY_PARAM_TYPE_MAP,\n  pathPattern: \"\",\n});\n\n/**\n * Extracts URL/splat params from a path's segments into the given accumulators\n * via the canonical `parseSegment` tokenizer. Split out of `buildParamMeta` so\n * the builder stays under the cognitive-complexity budget. A malformed segment\n * (token errors) or a `static` segment contributes nothing — a malformed route is\n * rejected downstream before it compiles, so its meta is moot.\n */\nfunction collectUrlParams(\n  path: string,\n  urlParams: string[],\n  spatParams: string[],\n  paramTypeMap: Record<string, \"url\" | \"query\">,\n): void {\n  for (const segment of splitPathSegments(path)) {\n    if (segment.length === 0) {\n      continue;\n    }\n\n    const token = parseSegment(segment);\n\n    if (\"error\" in token || token.kind === \"static\") {\n      continue;\n    }\n\n    urlParams.push(token.name);\n    paramTypeMap[token.name] = \"url\";\n\n    if (token.kind === \"splat\") {\n      spatParams.push(token.name);\n    }\n  }\n}\n\nexport function buildParamMeta(path: string): ParamMeta {\n  const urlParams: string[] = [];\n  const queryParams: string[] = [];\n  const spatParams: string[] = [];\n  const paramTypeMap: Record<string, \"url\" | \"query\"> = {};\n\n  // Locate the real query separator (M1 §3.3: first `?` whose tail is not a\n  // former optional/reverse form).\n  const separator = findQuerySeparator(path);\n\n  if (separator !== -1) {\n    const queryString = path.slice(separator + 1);\n    const params = queryString.split(\"&\");\n\n    for (const param of params) {\n      const paramName = param.trim();\n\n      if (paramName.length > 0) {\n        queryParams.push(paramName);\n        paramTypeMap[paramName] = \"query\";\n      }\n    }\n\n    path = path.slice(0, separator);\n  }\n\n  collectUrlParams(path, urlParams, spatParams, paramTypeMap);\n\n  return shareEmptyCollections(\n    urlParams,\n    queryParams,\n    spatParams,\n    paramTypeMap,\n    path,\n  );\n}\n\n// #1009: swap each freshly-built empty collection for a shared frozen sentinel\n// — factored out of buildParamMeta so the hot builder stays under the cognitive-\n// complexity budget. match/build only read these (Readonly*), and computeCaches'\n// Object.freeze is a no-op on an already-frozen shared instance.\nfunction shareEmptyCollections(\n  urlParams: string[],\n  queryParams: string[],\n  spatParams: string[],\n  paramTypeMap: Record<string, \"url\" | \"query\">,\n  pathPattern: string,\n): ParamMeta {\n  return {\n    urlParams: urlParams.length === 0 ? EMPTY_PARAM_NAMES : urlParams,\n    queryParams: queryParams.length === 0 ? EMPTY_PARAM_NAMES : queryParams,\n    spatParams: spatParams.length === 0 ? EMPTY_PARAM_NAMES : spatParams,\n    paramTypeMap:\n      urlParams.length === 0 && queryParams.length === 0\n        ? EMPTY_PARAM_TYPE_MAP\n        : paramTypeMap,\n    pathPattern,\n  };\n}\n"],"mappings":"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"}
+{"version":3,"file":"buildParamMeta-DniluAIV.js","names":["LT","QUESTION","SLASH"],"sources":["../../src/internals.ts","../../src/engine/path-matcher/parseSegment.ts","../../src/engine/path-matcher/buildParamMeta.ts"],"sourcesContent":["import type { RouteTree } from \"./engine\";\nimport type { DependenciesStore } from \"./namespaces\";\nimport type { RoutesStore } from \"./namespaces/RoutesNamespace\";\nimport type { Router as RouterClass } from \"./Router\";\nimport type {\n  DefaultDependencies,\n  EventName,\n  LoggerConfig,\n  NavigationOptions,\n  Options,\n  Params,\n  Plugin,\n  Router as RouterInterface,\n  RouterLogger,\n  RouteTreeState,\n  SerializedRouterState,\n  SimpleState,\n  State,\n  TreeChangedEvent,\n  Unsubscribe,\n  EventMethodMap,\n  PluginFactory,\n} from \"./types\";\nimport type { RouterValidator } from \"./types/RouterValidator\";\n\nexport interface RouterInternals<\n  D extends DefaultDependencies = DefaultDependencies,\n> {\n  readonly makeState: <P extends Params = Params>(\n    name: string,\n    params?: P,\n    path?: string,\n    meta?: Record<string, Record<string, \"url\" | \"query\">>,\n  ) => State<P>;\n\n  readonly forwardState: <P extends Params = Params>(\n    routeName: string,\n    routeParams: P,\n  ) => SimpleState<P>;\n\n  readonly buildStateResolved: (\n    resolvedName: string,\n    resolvedParams: Params,\n  ) => RouteTreeState | undefined;\n\n  readonly matchPath: <P extends Params = Params>(\n    path: string,\n    options?: Options,\n  ) => State<P> | undefined;\n\n  readonly getOptions: () => Options;\n\n  readonly addEventListener: <E extends EventName>(\n    eventName: E,\n    cb: Plugin[EventMethodMap[E]],\n  ) => Unsubscribe;\n\n  /**\n   * Route-tree mutation channel — internal access for the `getRoutesApi`\n   * wrapper. A dedicated bridge is required because the public\n   * `addEventListener<E extends EventName>` structurally rejects\n   * `\"TREE_CHANGED\"` (it is not in the public `EventName` union), is strict on\n   * duplicates, and exposes neither `emit` nor `listenerCount`.\n   */\n  readonly treeChanged: {\n    readonly emit: (event: TreeChangedEvent) => void;\n    readonly subscribe: (\n      handler: (event: TreeChangedEvent) => void,\n    ) => Unsubscribe;\n    readonly listenerCount: () => number;\n    /**\n     * True while a `TREE_CHANGED` emit is on the stack — `getRoutesApi` reads it\n     * to reject reentrant route-CRUD from a `subscribeChanges` handler (#1032).\n     */\n    readonly isEmitting: () => boolean;\n  };\n\n  readonly buildPath: (route: string, params?: Params) => string;\n\n  readonly emitTransitionError: (error: Error) => void;\n\n  /**\n   * Emits `TRANSITION_SUCCESS` directly (no FSM transition) — used by\n   * `getRoutesApi().replace()` to notify `router.subscribe` listeners when a\n   * structural replace revalidates the active state (#950). Mirrors the success\n   * emission `completeTransition` / `navigateToNotFound` perform.\n   */\n  readonly emitTransitionSuccess: (\n    toState: State,\n    fromState: State | undefined,\n    opts?: NavigationOptions,\n  ) => void;\n\n  /**\n   * Commits the not-found (`UNKNOWN_ROUTE`) state for `path` and emits\n   * `TRANSITION_SUCCESS` — the `NavigationNamespace.navigateToNotFound`\n   * primitive. `replace()` uses it when a structural replace drops the active\n   * route, so subscribers are notified instead of the state silently clearing\n   * (#950).\n   */\n  readonly navigateToNotFound: (path: string) => State;\n\n  readonly start: (path: string) => Promise<State>;\n\n  /**\n   * Plugin-only navigation entry point — delegates to\n   * `NavigationNamespace.navigateToState` (`getPluginApi(router).navigateToState`).\n   * Hidden from `Router`/`Navigator` to keep the userland surface minimal;\n   * see `core-types/src/api.ts` for usage docs.\n   */\n  readonly navigateToState: (\n    state: State,\n    options?: NavigationOptions,\n  ) => Promise<State>;\n\n  /* eslint-disable @typescript-eslint/no-explicit-any -- heterogeneous map: stores different InterceptorFn<M> types under different keys */\n  readonly interceptors: Map<\n    string,\n    ((next: (...args: any[]) => any, ...args: any[]) => any)[]\n  >;\n  /* eslint-enable @typescript-eslint/no-explicit-any */\n\n  readonly setRootPath: (rootPath: string) => void;\n  readonly getRootPath: () => string;\n\n  readonly getTree: () => RouteTree;\n\n  readonly isDisposed: () => boolean;\n\n  validator: RouterValidator | null;\n\n  // Per-router logger instance (built from `options.logger` in the Router\n  // constructor). The facade reads it as `getInternals(this).logger`; namespaces\n  // receive it via their deps at wiring; plugins reach it through\n  // `getPluginApi(router).logger`. Replaces the former process-global singleton\n  // from the standalone `@real-router/logger` package (now folded into\n  // `utils/logger`), whose `configure()` leaked across routers (#724).\n  readonly logger: RouterLogger;\n\n  // Dependencies (issue #172)\n  readonly dependenciesGetStore: () => DependenciesStore<D>;\n\n  // Clone support (issue #173, consolidated #964). One accessor for the\n  // source-side snapshot a clone carries over besides the route store, so a new\n  // clone-relevant subsystem is wired in a single place instead of being spread\n  // across separate methods.\n  readonly getCloneState: () => {\n    options: Options;\n    dependencies: Record<string, unknown>;\n    pluginFactories: PluginFactory<D>[];\n    // Resolved logger config of the base router, so a clone can build its OWN\n    // logger inheriting the base's level/callback. Frozen `options` do NOT carry\n    // `logger` (stripped in the constructor), so `options` above can't convey it;\n    // cloneRouter merges a per-request override (traceId) over this snapshot.\n    loggerConfig: LoggerConfig;\n  };\n\n  // Consolidated route data store (issue #174 Phase 2)\n  readonly routeGetStore: () => RoutesStore<D>;\n\n  // Cross-namespace state (issue #174)\n  readonly getStateName: () => string | undefined;\n  readonly isTransitioning: () => boolean;\n  readonly clearState: () => void;\n  readonly setState: (state: State) => void;\n  readonly routerExtensions: { keys: string[] }[];\n  readonly contextClaimRecords: Set<string>;\n\n  /**\n   * One-shot hydration scratchpad populated by `hydrateRouter` immediately\n   * before delegating to `router.start(parsed.path)` and cleared in the\n   * matching `finally`. SSR loader plugins read this slot directly via\n   * `getInternals(router).hydrationState` to short-circuit their own loader\n   * call when the server-resolved namespace value is already present in the\n   * parsed state (#596). `null` outside of an active `hydrateRouter`\n   * invocation.\n   */\n  hydrationState: SerializedRouterState | null;\n}\n\n// eslint-disable-next-line @typescript-eslint/no-explicit-any -- existential type: stores RouterInternals for all Dependencies types\nconst internals = new WeakMap<object, RouterInternals<any>>();\n\nexport function getInternals<D extends DefaultDependencies>(\n  router: RouterInterface<D>,\n): RouterInternals<D> {\n  const ctx = internals.get(router);\n\n  if (!ctx) {\n    throw new TypeError(\n      \"[real-router] Invalid router instance — not found in internals registry\",\n    );\n  }\n\n  return ctx as RouterInternals<D>;\n}\n\nexport function registerInternals<D extends DefaultDependencies>(\n  router: RouterClass<D>,\n  ctx: RouterInternals<D>,\n): void {\n  internals.set(router, ctx);\n}\n\n/* eslint-disable @typescript-eslint/no-explicit-any, @typescript-eslint/no-unsafe-return, @typescript-eslint/no-unsafe-argument -- internal chain execution: type safety enforced at public API boundary (PluginApi.addInterceptor) */\nfunction executeInterceptorChain<T>(\n  interceptors: ((next: (...args: any[]) => any, ...args: any[]) => any)[],\n  original: (...args: any[]) => T,\n  args: any[],\n): T {\n  let chain = original as (...args: any[]) => any;\n\n  for (const interceptor of interceptors) {\n    const prev = chain;\n\n    chain = (...chainArgs: any[]) => interceptor(prev, ...chainArgs);\n  }\n\n  return chain(...args) as T;\n}\n\n/**\n * Variadic interceptor wrapper — wraps a function of any arity, returning the\n * same callable type `T`. Use {@link createBinaryInterceptable} instead when the\n * wrapped method takes exactly two args and the caller needs the precise\n * `(a, b) => r` signature preserved (the variadic form widens args to `any[]`).\n */\nexport function createInterceptable<T extends (...args: any[]) => any>(\n  name: string,\n  original: T,\n  interceptors: Map<\n    string,\n    ((next: (...args: any[]) => any, ...args: any[]) => any)[]\n  >,\n): T {\n  return ((...args: any[]) => {\n    const chain = interceptors.get(name);\n\n    if (!chain || chain.length === 0) {\n      return original(...args);\n    }\n\n    return executeInterceptorChain(chain, original, args);\n  }) as T;\n}\n\n/**\n * Two-argument interceptor wrapper — preserves the exact `(a: A, b: B) => R`\n * signature, which the variadic {@link createInterceptable} cannot express\n * (it widens args to `any[]`). Used for the binary interceptable methods\n * `forwardState(routeName, routeParams)` and `buildPath(route, params)`.\n */\nexport function createBinaryInterceptable<A, B, R>(\n  name: string,\n  original: (a: A, b: B) => R,\n  interceptors: Map<\n    string,\n    ((next: (...args: any[]) => any, ...args: any[]) => any)[]\n  >,\n): (a: A, b: B) => R {\n  return (arg1: A, arg2: B) => {\n    const chain = interceptors.get(name);\n\n    if (!chain || chain.length === 0) {\n      return original(arg1, arg2);\n    }\n\n    return executeInterceptorChain(chain, original, [arg1, arg2]);\n  };\n}\n/* eslint-enable @typescript-eslint/no-explicit-any, @typescript-eslint/no-unsafe-return, @typescript-eslint/no-unsafe-argument */\n","/**\n * Canonical route-segment tokenizer.\n *\n * The single owner of \"where does a name / marker / constraint end\" for ONE\n * path segment (post-`/`-split). It replaces the five name-boundary compositions\n * of `PARAM_NAME_PATTERN` currently spread across `buildParamMeta` (L1),\n * `registration` (L2 build + L3 trie), and `route-tree`'s validation gate (L4),\n * so those layers can never disagree on a boundary (the gate↔backstop drift\n * class — #858 / #1050 / #1150 / #1311 / #1149 / #1324).\n *\n * A single left-to-right `charCodeAt` scan produces either a token tuple or a\n * typed error. Grammar — **3 tokens only** (`static | :param | *splat`); the\n * grammar has no optional `:x?` or `<re>` constraint forms. Any `<`/`>` or a\n * post-name `?` in the path is a *registration error* carrying a replacement\n * recipe (`optional-removed` / `constraint-removed`), not a token:\n * 1. Leading `:`/`*` → param/splat; otherwise `static` (a marker glued *after* a\n *    static prefix ⇒ `fused-marker`; any `<`/`>` (a former constraint) ⇒\n *    `constraint-removed`; a trailing `?` on a marker-less segment ⇒ `name-less`\n *    — the modifier has no param name, #1241 / `/faq?`).\n * 2. name = any char except `<`/`?` (no `/` remains inside a segment); a name\n *    ending in a bare `:`/`*` ⇒ `trailing-marker` (#1324). A *mid* marker stays\n *    a name char — `:a:b` → name `a:b`, preserved.\n * 3. empty name ⇒ `name-less` (#858).\n * 4. a `<` after the name (a former `<re>` constraint) ⇒ `constraint-removed`.\n * 5. a post-name `?` (a former optional modifier, on `:param` or `*splat`) ⇒\n *    `optional-removed`.\n *\n * @module parseSegment\n */\n\n/* eslint-disable unicorn/prefer-code-point, unicorn/prefer-includes-over-repeated-comparisons, sonarjs/cognitive-complexity -- charCodeAt code-unit scan + a single inlined branchy pass are this RFC's char-scan perf basis (§9); the same deliberate choices as registration/trie.ts hasNonAsciiSegment (#1285) and SegmentMatcher's inlined #traverseFrom. A `[LT,GT,QUESTION].includes(code)` boundary check would allocate an array literal per scanned char. Markers compared are ASCII (`:` `*` `<` `>` `?`, < 0x80). */\n\n/** A successfully tokenized segment (3-token grammar: `static | :param | *splat`). */\nexport type SegmentTokens =\n  | { readonly kind: \"static\"; readonly text: string }\n  | { readonly kind: \"param\"; readonly name: string }\n  | { readonly kind: \"splat\"; readonly name: string };\n\n/** Grammar-shape rejections, each mirroring a registration guard. */\nexport type SegmentErrorCode =\n  | \"name-less\" // #858 — a marker with no name\n  | \"trailing-marker\" // #1324 — a param name ending in a bare `:`/`*`\n  | \"fused-marker\" // #1050 — a marker glued after a static prefix\n  | \"optional-removed\" // M1 — a `:x?`/`*x?` optional modifier (removed; two sibling routes)\n  | \"constraint-removed\"; // M1 — a `<re>` constraint or stray `<`/`>` (removed; validate in a guard)\n\nexport interface SegmentError {\n  readonly error: SegmentErrorCode;\n}\n\nconst COLON = 58; // :\nconst STAR = 42; // *\nconst LT = 60; // <\nconst GT = 62; // >\nconst QUESTION = 63; // ?\nconst SLASH = 47; // /\n\nconst isMarker = (code: number): boolean => code === COLON || code === STAR;\n\n/**\n * Splits a path into its `/`-delimited segments. A plain `/`-split (M1): the\n * 3-token grammar has no `<...>` constraint whose body could legally contain a\n * `/`, so no constraint-awareness is needed — a stray `<`/`>` is a\n * `constraint-removed` error, caught per segment by `parseSegment`. This is the\n * **segmentation** half of the path-grammar unification: `parseSegment` owns the\n * per-segment grammar, `splitPathSegments` owns where a segment begins and ends.\n *\n * @param path - a route path (query already stripped by the caller)\n * @returns the segments in order, including empty leading/trailing/`//` segments\n *   (the caller skips empties, matching the current behaviour)\n */\nexport function splitPathSegments(path: string): string[] {\n  const segments: string[] = [];\n  let start = 0;\n\n  for (let i = 0; i < path.length; i += 1) {\n    if (path.charCodeAt(i) !== SLASH) {\n      continue;\n    }\n\n    segments.push(path.slice(start, i));\n    start = i + 1;\n  }\n\n  segments.push(path.slice(start));\n\n  return segments;\n}\n\n/**\n * Tokenizes a single path segment (already split on `/`).\n *\n * @param segment - one `/`-delimited segment of a route path\n * @returns the segment's tokens, or a typed grammar error\n */\nexport function parseSegment(segment: string): SegmentTokens | SegmentError {\n  const length = segment.length;\n\n  if (length === 0) {\n    return { kind: \"static\", text: \"\" };\n  }\n\n  // ---- static segment (no leading marker) -------------------------------\n  if (!isMarker(segment.charCodeAt(0))) {\n    for (let i = 0; i < length; i += 1) {\n      const code = segment.charCodeAt(i);\n\n      // A `<`/`>` (a former `<re>` constraint or a stray delimiter) is no longer\n      // grammar — M1 removed constraints. Reject with the constraint recipe.\n      if (code === LT || code === GT) {\n        return { error: \"constraint-removed\" };\n      }\n\n      // A marker glued after a static prefix is extracted as a param by build/meta\n      // but compiled as a static literal by the trie (#1050) — reject it as fused.\n      // A marker ENDING the segment (a static ending in `:`/`*` — `/a:`, `/a*`, F2)\n      // is NOT fused: caught by `i + 1 < length` being false. Every other following\n      // char is fused — including a `?` (`a:?`): that shape never reaches the\n      // tokenizer through a real path (a `?` after a bare marker is not a valid\n      // `:name?` form, so the query mask strips it before `/`-segmentation), so a\n      // direct call correctly reports fused-marker. (`a<`/`a>` already returned\n      // `constraint-removed` above, so no `<`-follows exception is needed here.)\n      if (isMarker(code) && i + 1 < length) {\n        return { error: \"fused-marker\" };\n      }\n    }\n\n    // A trailing `?` is a former optional modifier; on a marker-less segment (no\n    // param name) it is a modifier-with-no-name — name-less (#858/#1241, `/faq?`),\n    // NOT `optional-removed` (there is no param to route to two siblings). The\n    // backstop rejects it by the SAME rule: its `endsWith(\"?\")` fork routes the\n    // segment to `extractParamName` → this tokenizer. Owning the `?` here (not\n    // only in the marker branch) is what lets the gate and backstop agree on it —\n    // otherwise the gate reads `faq?` as a valid static (#1324 §4).\n    if (segment.charCodeAt(length - 1) === QUESTION) {\n      return { error: \"name-less\" };\n    }\n\n    return { kind: \"static\", text: segment };\n  }\n\n  const splat = segment.charCodeAt(0) === STAR;\n\n  // ---- name: up to the first `<`/`>` (former constraint delimiter, reserved —\n  // В1.3) or `?` (former optional). A segment holds no `/`. -----------------\n  let cursor = 1;\n\n  while (cursor < length) {\n    const code = segment.charCodeAt(cursor);\n\n    if (code === LT || code === GT || code === QUESTION) {\n      break;\n    }\n\n    cursor += 1;\n  }\n\n  const name = segment.slice(1, cursor);\n\n  if (name.length === 0) {\n    return { error: \"name-less\" }; // #858\n  }\n\n  if (isMarker(name.charCodeAt(name.length - 1))) {\n    return { error: \"trailing-marker\" }; // #1324\n  }\n\n  // ---- former constraint / optional modifiers (removed in M1) ------------\n  // The name scan stops at the first `<`/`>` or `?`. Either is a form removed\n  // in M1: a `<re>` constraint (also a stray `<`/`>` — В1.3), or a `:x?`/`*x?`\n  // optional. Only `?` is the optional; `<`/`>` are the constraint recipe.\n  // Reject with the matching replacement recipe rather than tokenize it.\n  if (cursor < length) {\n    return segment.charCodeAt(cursor) === QUESTION\n      ? { error: \"optional-removed\" }\n      : { error: \"constraint-removed\" }; // LT or GT\n  }\n\n  return splat ? { kind: \"splat\", name } : { kind: \"param\", name };\n}\n\n/**\n * Returns the first per-segment grammar error in a path, or `undefined` if every\n * segment tokenizes cleanly.\n *\n * The **validation-facing** entry over the tokenizer: `route-tree`'s\n * `validateRoutePath` calls this instead of re-running its own split+parse loop,\n * so the gate and the matcher's own grammar cannot drift (#1324) and the loop\n * stays single-sourced here — the tokenizer primitives (`parseSegment`,\n * `splitPathSegments`) need not leak into the package's public surface. An empty\n * segment tokenizes as `static` (never an error), so leading/trailing/`//`\n * empties are skipped naturally.\n *\n * @param path - a route path (query already stripped by the caller)\n * @returns the first `SegmentErrorCode` (scanned left to right), or `undefined`\n */\nexport function findSegmentGrammarError(\n  path: string,\n): SegmentErrorCode | undefined {\n  for (const segment of splitPathSegments(path)) {\n    const token = parseSegment(segment);\n\n    if (\"error\" in token) {\n      return token.error;\n    }\n  }\n\n  return undefined;\n}\n\n/** A removed-form (M1) match, describing the offending segment and — for an\n * optional — the two sibling paths that replace it (path without the optional\n * segment + path with the param made required). The route-tree gate uses this to\n * build a route-contextual replacement recipe; the matcher backstop uses only the\n * error code (a shorter, path-free recipe). */\nexport type RemovedForm =\n  | {\n      readonly code: \"optional-removed\";\n      readonly segment: string;\n      readonly withoutSegment: string;\n      readonly requiredForm: string;\n    }\n  | { readonly code: \"constraint-removed\"; readonly segment: string };\n\n/**\n * The rich (route-tree gate) view over the tokenizer for a removed form: finds\n * the first `optional-removed` / `constraint-removed` segment and, for an\n * optional, computes its two replacement sibling paths from the ACTUAL path\n * (dropping the segment → without-form; dropping the trailing `?` → required\n * form). Returns `undefined` if no removed form is present (the gate then uses\n * `findSegmentGrammarError` for a surviving grammar rejection).\n *\n * @param path - a route path (query already stripped by the caller)\n */\nexport function describeRemovedForm(path: string): RemovedForm | undefined {\n  const segments = splitPathSegments(path);\n\n  for (let i = 0; i < segments.length; i += 1) {\n    const token = parseSegment(segments[i]);\n\n    if (!(\"error\" in token)) {\n      continue;\n    }\n\n    // First error wins (mirrors `findSegmentGrammarError`): describe it ONLY if\n    // it is a removed form, else return undefined so the caller falls to the\n    // surviving-code message — this keeps the gate's reason in lockstep with the\n    // matcher backstop's first-error verdict.\n    if (token.error === \"optional-removed\") {\n      const segment = segments[i];\n      const required = [...segments];\n\n      // Drop the `?` optional modifier AND everything after it (the tokenizer\n      // stopped the name at the first `?`, so it is the modifier). Using the `?`\n      // index — not a blind `slice(0, -1)` — keeps the required sibling VALID for\n      // a reverse/compound form whose `?` is not the last char: `:b?<x>` → `:b`\n      // (not `:b?<x`), `:id??` → `:id` (not `:id?`). #1516\n      required[i] = segment.slice(0, segment.indexOf(\"?\"));\n\n      return {\n        code: \"optional-removed\",\n        segment,\n        withoutSegment: segments.filter((_, j) => j !== i).join(\"/\"),\n        requiredForm: required.join(\"/\"),\n      };\n    }\n\n    return token.error === \"constraint-removed\"\n      ? { code: \"constraint-removed\", segment: segments[i] }\n      : undefined;\n  }\n\n  return undefined;\n}\n","/**\n * Route Parameter Metadata Extraction.\n *\n * Extracts parameter metadata from route path patterns without requiring\n * a full path-parser instance. Replaces parser.urlParams/queryParams/spatParams.\n *\n * @module buildParamMeta\n */\n\nimport { parseSegment, splitPathSegments } from \"./parseSegment\";\n\nimport type { ParamMeta } from \"./types\";\n\n/**\n * A query-param NAME may not contain `<`/`>` (#1242 §5.1) — a constraint\n * delimiter leaked into the query via a reverse-order modifier typo (`/a/:b?<c>`\n * parses the `?` as the query start, making `<c>` the query name). Consumed by\n * the route-tree gate and the `registerTree` backstop; relocated here from the\n * deleted `constraint-grammar.ts` when M1 removed constraints (query-param name\n * validation is a query concern, and this module owns query extraction).\n */\nexport const INVALID_QUERY_NAME_RGX = /[<>]/u;\n\nconst QUESTION = 0x3f; // ?\nconst SLASH = 0x2f; // /\nconst LT = 0x3c; // <\n\n/**\n * Locates the query separator `?` in a route path — the FIRST `?` whose tail is\n * non-empty and does not begin with `/`, `?`, or `<` (M1 §3.3). The 3-token\n * grammar leaves `?` a single role (there is no optional modifier and no\n * constraint body to hide one), so no length-preserving mask is needed. The three\n * excluded tails keep a REMOVED form in the path part, where `parseSegment`\n * rejects it with a recipe instead of mis-reading it as a query declaration:\n * - end-of-string (`/:id?`) and `/` (`/:id?/edit`) → a bare `:x?` optional;\n * - `?` (`/:id??tab`) → the leading `?` is the optional, the later `?` the query;\n * - `<` (`/a/:b?<x>`) → a reverse-order `:b?<x>` (optional then a former constraint).\n *\n * @param path - a route path\n * @returns the index of the query separator, or -1 if there is none\n */\nfunction findQuerySeparator(path: string): number {\n  for (let i = 0; i < path.length; i += 1) {\n    if (path.codePointAt(i) !== QUESTION) {\n      continue;\n    }\n\n    // `next` is the code point after the `?`, or the `-1` sentinel at end-of-string.\n    // The `-1` sentinel is the SOLE end-of-string guard — the former separate\n    // `next !== undefined` conjunct was dead (the ternary bounds the index, so\n    // `codePointAt` never returns `undefined`; the `!` is a type assertion, not a\n    // runtime branch, so it keeps the scan at 100% coverage). Mirrors `#scanPath`.\n    // eslint-disable-next-line @typescript-eslint/no-non-null-assertion -- ternary-bounded in-range index; codePointAt is defined\n    const next = i + 1 < path.length ? path.codePointAt(i + 1)! : -1;\n\n    if (next !== -1 && next !== SLASH && next !== QUESTION && next !== LT) {\n      return i;\n    }\n  }\n\n  return -1;\n}\n\n/**\n * Builds parameter metadata from a route path pattern.\n *\n * Extracts URL parameters, query parameters, and splat parameters\n * from the path pattern string.\n *\n * @param path - Route path pattern (e.g., \"/users/:id/posts/:postId?q\")\n * @returns Parameter metadata object\n *\n * @example\n * ```typescript\n * buildParamMeta(\"/users/:id\")\n * // → { urlParams: [\"id\"], queryParams: [], spatParams: [], paramTypeMap: { id: \"url\" } }\n *\n * buildParamMeta(\"/search?q&page\")\n * // → { urlParams: [], queryParams: [\"q\", \"page\"], spatParams: [],\n * //     paramTypeMap: { q: \"query\", page: \"query\" } }\n *\n * buildParamMeta(\"/files/*path\")\n * // → { urlParams: [\"path\"], queryParams: [], spatParams: [\"path\"],\n * //     paramTypeMap: { path: \"url\" } }\n * ```\n */\n// Shared frozen sentinels for the common no-params case — avoid a fresh empty\n// array/object per route (#1009). ParamMeta fields are Readonly*; match/build\n// only read them, and computeCaches' Object.freeze on the arrays/object is a\n// no-op on an already-frozen shared instance.\nconst EMPTY_PARAM_NAMES: readonly string[] = Object.freeze([]);\nconst EMPTY_PARAM_TYPE_MAP: Readonly<Record<string, \"url\" | \"query\">> =\n  Object.freeze({});\n\n// Whole-meta shared sentinel for the fully-static case: every collection is a\n// #1009 sentinel AND pathPattern degenerates to the input path itself (no query\n// to strip), so the wrapper carries zero per-route information. The RETAINING\n// caller (route-tree's computeCaches) swaps a matching fresh result for this\n// instance — buildParamMeta itself keeps returning fresh objects so the\n// validation gate can read the real pathPattern of arbitrary input paths.\n// `pathPattern` is \"\" here; the one stored-meta reader (`registerNode`) falls\n// back to `node.path` on identity match.\nexport const EMPTY_PARAM_META: ParamMeta = Object.freeze({\n  urlParams: EMPTY_PARAM_NAMES,\n  queryParams: EMPTY_PARAM_NAMES,\n  spatParams: EMPTY_PARAM_NAMES,\n  paramTypeMap: EMPTY_PARAM_TYPE_MAP,\n  pathPattern: \"\",\n});\n\n/**\n * Extracts URL/splat params from a path's segments into the given accumulators\n * via the canonical `parseSegment` tokenizer. Split out of `buildParamMeta` so\n * the builder stays under the cognitive-complexity budget. A malformed segment\n * (token errors) or a `static` segment contributes nothing — a malformed route is\n * rejected downstream before it compiles, so its meta is moot.\n */\nfunction collectUrlParams(\n  path: string,\n  urlParams: string[],\n  spatParams: string[],\n  paramTypeMap: Record<string, \"url\" | \"query\">,\n): void {\n  for (const segment of splitPathSegments(path)) {\n    if (segment.length === 0) {\n      continue;\n    }\n\n    const token = parseSegment(segment);\n\n    if (\"error\" in token || token.kind === \"static\") {\n      continue;\n    }\n\n    urlParams.push(token.name);\n    paramTypeMap[token.name] = \"url\";\n\n    if (token.kind === \"splat\") {\n      spatParams.push(token.name);\n    }\n  }\n}\n\nexport function buildParamMeta(path: string): ParamMeta {\n  const urlParams: string[] = [];\n  const queryParams: string[] = [];\n  const spatParams: string[] = [];\n  const paramTypeMap: Record<string, \"url\" | \"query\"> = {};\n\n  // Locate the real query separator (M1 §3.3: first `?` whose tail is not a\n  // former optional/reverse form).\n  const separator = findQuerySeparator(path);\n\n  if (separator !== -1) {\n    const queryString = path.slice(separator + 1);\n    const params = queryString.split(\"&\");\n\n    for (const param of params) {\n      const paramName = param.trim();\n\n      if (paramName.length > 0) {\n        queryParams.push(paramName);\n        paramTypeMap[paramName] = \"query\";\n      }\n    }\n\n    path = path.slice(0, separator);\n  }\n\n  collectUrlParams(path, urlParams, spatParams, paramTypeMap);\n\n  return shareEmptyCollections(\n    urlParams,\n    queryParams,\n    spatParams,\n    paramTypeMap,\n    path,\n  );\n}\n\n// #1009: swap each freshly-built empty collection for a shared frozen sentinel\n// — factored out of buildParamMeta so the hot builder stays under the cognitive-\n// complexity budget. match/build only read these (Readonly*), and computeCaches'\n// Object.freeze is a no-op on an already-frozen shared instance.\nfunction shareEmptyCollections(\n  urlParams: string[],\n  queryParams: string[],\n  spatParams: string[],\n  paramTypeMap: Record<string, \"url\" | \"query\">,\n  pathPattern: string,\n): ParamMeta {\n  return {\n    urlParams: urlParams.length === 0 ? EMPTY_PARAM_NAMES : urlParams,\n    queryParams: queryParams.length === 0 ? EMPTY_PARAM_NAMES : queryParams,\n    spatParams: spatParams.length === 0 ? EMPTY_PARAM_NAMES : spatParams,\n    paramTypeMap:\n      urlParams.length === 0 && queryParams.length === 0\n        ? EMPTY_PARAM_TYPE_MAP\n        : paramTypeMap,\n    pathPattern,\n  };\n}\n"],"mappings":"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"}

package/dist/cjs/engine/builder/buildTree.js

@@ -1,2 +1,2 @@
-function e(t,n){let r=t.path,i=r.startsWith(`~`),a=i?r.slice(1):r,o={name:t.name,path:a,absolute:i,children:[],parent:n};if(t.children)for(let n of t.children){let t=e(n,o);o.children.push(t)}return o}function t(t,n,r){let i=e({name:t,path:n},null);for(let t of r){let n=e(t,i);i.children.push(n)}return i}exports.buildTree=t;
+function e(t,n){let r=t.path,i=r.startsWith(`~`),a=i?r.slice(1):r,o=a!==``&&!a.startsWith(`/`)&&!a.startsWith(`?`)?`/${a}`:a,s={name:t.name,path:o,absolute:i,children:[],parent:n};if(t.children)for(let n of t.children){let t=e(n,s);s.children.push(t)}return s}function t(t,n,r){let i=e({name:t,path:n},null);for(let t of r){let n=e(t,i);i.children.push(n)}return i}exports.buildTree=t;
 //# sourceMappingURL=buildTree.js.map

package/dist/cjs/engine/builder/buildTree.js.map

@@ -1 +1 @@
-{"version":3,"file":"buildTree.js","names":[],"sources":["../../../../src/engine/builder/buildTree.ts"],"sourcesContent":["/**\n * Tree Building.\n *\n * Constructs the mutable tree structure from route definitions.\n *\n * @module builder/buildTree\n */\n\nimport type { RouteDefinition } from \"../types\";\n\n// =============================================================================\n// Mutable Node Type (internal)\n// =============================================================================\n\n/**\n * Mutable version of RouteTree used during building.\n * After building, this is converted to immutable RouteTree.\n */\nexport interface MutableRouteNode {\n  name: string;\n  path: string;\n  absolute: boolean;\n  children: MutableRouteNode[];\n  parent: MutableRouteNode | null;\n}\n\n// =============================================================================\n// Building Functions\n// =============================================================================\n\n/**\n * Creates a mutable node from a route definition.\n *\n * @param definition - Route definition object\n * @param definition.name - Route name\n * @param definition.path - Route path\n * @param definition.children - Optional child routes\n * @param parent - Parent node (null for root)\n * @returns Mutable node\n */\nfunction createNode(\n  definition: {\n    name: string;\n    path: string;\n    children?: RouteDefinition[] | undefined;\n  },\n  parent: MutableRouteNode | null,\n): MutableRouteNode {\n  const path = definition.path;\n  const absolute = path.startsWith(\"~\");\n  const normalizedPath = absolute ? path.slice(1) : path;\n\n  const node: MutableRouteNode = {\n    name: definition.name,\n    path: normalizedPath,\n    absolute,\n    children: [],\n    parent,\n  };\n\n  // Recursively add children\n  if (definition.children) {\n    for (const childDef of definition.children) {\n      const childNode = createNode(childDef, node);\n\n      node.children.push(childNode);\n    }\n  }\n\n  return node;\n}\n\n/**\n * Builds the mutable tree structure from route definitions.\n *\n * Simplified single-pass algorithm:\n * - Creates root node\n * - Adds each route as direct child of root\n * - createNode() handles nested children recursively\n *\n * @param rootName - Root node name (typically \"\")\n * @param rootPath - Root node path (typically \"\")\n * @param routes - Route definitions\n * @returns Mutable root node\n */\nexport function buildTree(\n  rootName: string,\n  rootPath: string,\n  routes: readonly RouteDefinition[],\n): MutableRouteNode {\n  const root = createNode({ name: rootName, path: rootPath }, null);\n\n  for (const route of routes) {\n    const node = createNode(route, root);\n\n    root.children.push(node);\n  }\n\n  return root;\n}\n"],"mappings":"AAwCA,SAAS,EACP,EAKA,EACkB,CAClB,IAAM,EAAO,EAAW,KAClB,EAAW,EAAK,WAAW,GAAG,EAC9B,EAAiB,EAAW,EAAK,MAAM,CAAC,EAAI,EAE5C,EAAyB,CAC7B,KAAM,EAAW,KACjB,KAAM,EACN,WACA,SAAU,CAAC,EACX,QACF,EAGA,GAAI,EAAW,SACb,IAAK,IAAM,KAAY,EAAW,SAAU,CAC1C,IAAM,EAAY,EAAW,EAAU,CAAI,EAE3C,EAAK,SAAS,KAAK,CAAS,CAC9B,CAGF,OAAO,CACT,CAeA,SAAgB,EACd,EACA,EACA,EACkB,CAClB,IAAM,EAAO,EAAW,CAAE,KAAM,EAAU,KAAM,CAAS,EAAG,IAAI,EAEhE,IAAK,IAAM,KAAS,EAAQ,CAC1B,IAAM,EAAO,EAAW,EAAO,CAAI,EAEnC,EAAK,SAAS,KAAK,CAAI,CACzB,CAEA,OAAO,CACT"}
+{"version":3,"file":"buildTree.js","names":[],"sources":["../../../../src/engine/builder/buildTree.ts"],"sourcesContent":["/**\n * Tree Building.\n *\n * Constructs the mutable tree structure from route definitions.\n *\n * @module builder/buildTree\n */\n\nimport type { RouteDefinition } from \"../types\";\n\n// =============================================================================\n// Mutable Node Type (internal)\n// =============================================================================\n\n/**\n * Mutable version of RouteTree used during building.\n * After building, this is converted to immutable RouteTree.\n */\nexport interface MutableRouteNode {\n  name: string;\n  path: string;\n  absolute: boolean;\n  children: MutableRouteNode[];\n  parent: MutableRouteNode | null;\n}\n\n// =============================================================================\n// Building Functions\n// =============================================================================\n\n/**\n * Creates a mutable node from a route definition.\n *\n * @param definition - Route definition object\n * @param definition.name - Route name\n * @param definition.path - Route path\n * @param definition.children - Optional child routes\n * @param parent - Parent node (null for root)\n * @returns Mutable node\n */\nfunction createNode(\n  definition: {\n    name: string;\n    path: string;\n    children?: RouteDefinition[] | undefined;\n  },\n  parent: MutableRouteNode | null,\n): MutableRouteNode {\n  const path = definition.path;\n  const absolute = path.startsWith(\"~\");\n  const stripped = absolute ? path.slice(1) : path;\n  // #1407: normalize a missing leading \"/\". The trie, buildFullPath, and every\n  // downstream layer assume a leading-\"/\" path; a non-absolute path without one\n  // (`foo`, `:id`) fuses onto its parent across the segment boundary, and an\n  // absolute `~foo` (slash-less) compiles a dead route (the trie scans from\n  // index 1, dropping the first char). After the `~`-strip, prepend \"/\" to any\n  // non-empty path that lacks it — `foo`/`~foo` → `/foo`, `:id` → `/:id`,\n  // `foo?q` → `/foo?q` — leaving `/foo`/`~/foo` and the empty root untouched.\n  // A query-only path (`?q`) has no leading path segment to slash (the `?` starts\n  // the query), so it is skipped too. The path-matcher's \"I only see leading-'/'\n  // paths\" invariant becomes correct-by-construction.\n  const normalizedPath =\n    stripped !== \"\" && !stripped.startsWith(\"/\") && !stripped.startsWith(\"?\")\n      ? `/${stripped}`\n      : stripped;\n\n  const node: MutableRouteNode = {\n    name: definition.name,\n    path: normalizedPath,\n    absolute,\n    children: [],\n    parent,\n  };\n\n  // Recursively add children\n  if (definition.children) {\n    for (const childDef of definition.children) {\n      const childNode = createNode(childDef, node);\n\n      node.children.push(childNode);\n    }\n  }\n\n  return node;\n}\n\n/**\n * Builds the mutable tree structure from route definitions.\n *\n * Simplified single-pass algorithm:\n * - Creates root node\n * - Adds each route as direct child of root\n * - createNode() handles nested children recursively\n *\n * @param rootName - Root node name (typically \"\")\n * @param rootPath - Root node path (typically \"\")\n * @param routes - Route definitions\n * @returns Mutable root node\n */\nexport function buildTree(\n  rootName: string,\n  rootPath: string,\n  routes: readonly RouteDefinition[],\n): MutableRouteNode {\n  const root = createNode({ name: rootName, path: rootPath }, null);\n\n  for (const route of routes) {\n    const node = createNode(route, root);\n\n    root.children.push(node);\n  }\n\n  return root;\n}\n"],"mappings":"AAwCA,SAAS,EACP,EAKA,EACkB,CAClB,IAAM,EAAO,EAAW,KAClB,EAAW,EAAK,WAAW,GAAG,EAC9B,EAAW,EAAW,EAAK,MAAM,CAAC,EAAI,EAWtC,EACJ,IAAa,IAAM,CAAC,EAAS,WAAW,GAAG,GAAK,CAAC,EAAS,WAAW,GAAG,EACpE,IAAI,IACJ,EAEA,EAAyB,CAC7B,KAAM,EAAW,KACjB,KAAM,EACN,WACA,SAAU,CAAC,EACX,QACF,EAGA,GAAI,EAAW,SACb,IAAK,IAAM,KAAY,EAAW,SAAU,CAC1C,IAAM,EAAY,EAAW,EAAU,CAAI,EAE3C,EAAK,SAAS,KAAK,CAAS,CAC9B,CAGF,OAAO,CACT,CAeA,SAAgB,EACd,EACA,EACA,EACkB,CAClB,IAAM,EAAO,EAAW,CAAE,KAAM,EAAU,KAAM,CAAS,EAAG,IAAI,EAEhE,IAAK,IAAM,KAAS,EAAQ,CAC1B,IAAM,EAAO,EAAW,EAAO,CAAI,EAEnC,EAAK,SAAS,KAAK,CAAI,CACzB,CAEA,OAAO,CACT"}

package/dist/cjs/engine/path-matcher/registration/trieNodes.js.map

@@ -1 +1 @@
-{"version":3,"file":"trieNodes.js","names":["parseSegment","createSegmentNode"],"sources":["../../../../../src/engine/path-matcher/registration/trieNodes.ts"],"sourcesContent":["// Trie node construction: param-name extraction + the param/splat child creators\n// (#736). Consumed by `trie` during insertion.\n\nimport { parseSegment } from \"../parseSegment\";\nimport { createSegmentNode } from \"../pathUtils\";\nimport { throwEmptyParamName, throwParamNameConflict } from \"./errors\";\n\nimport type { SegmentNode } from \"../types\";\n\n/**\n * Extracts the param name from a marker-led segment (`:name` / `*name`),\n * delegating the boundary to the canonical `parseSegment` tokenizer (#1324) so the\n * trie backstop, the route-tree gate, and `buildParamMeta` share ONE grammar and\n * cannot drift. `registerNode`'s per-segment grammar pre-pass has already rejected\n * every malformed form (name-less #858, trailing marker `:y*`/`:y:` #1324, fused\n * marker #1050, and the M1 removed optional/constraint forms), so a `:param` /\n * `*splat` name is guaranteed here — the error/`static` branches below are an\n * unreachable typed backstop. Single source for the param branch in\n * `processSegment` (the 3-token walk no longer forks, #1516).\n */\nexport function extractParamName(segment: string): string {\n  const token = parseSegment(segment);\n\n  // registerNode's per-segment grammar pass (Реш.2) rejects every malformed segment\n  // — name-less (#858), trailing-marker (#1324), fused-marker (#1050), constraint\n  // forms — before trie insertion, so a param|splat name is guaranteed here. The\n  // error/`static` branches are unreachable, kept as a typed defensive backstop.\n  /* v8 ignore start -- unreachable: registerNode's grammar pass rejects non-name segments first */\n  if (\"error\" in token || token.kind === \"static\") {\n    throwEmptyParamName();\n  }\n  /* v8 ignore stop */\n\n  return token.name;\n}\n\n/**\n * Returns the param child of `node`, creating it on first use. A pre-existing\n * child with a *different* name is a #736 conflict (two routes binding the same\n * trie position under different names). With the 3-token grammar (M1) insertion is\n * a strict linear walk, so a single route never revisits a slot it created — the\n * former optional-omit `ownNodes` exception is gone with optional params.\n */\nexport function ensureParamChild(\n  node: SegmentNode,\n  paramName: string,\n): SegmentNode {\n  if (!node.paramChild) {\n    node.paramChild = { node: createSegmentNode(), name: paramName };\n  } else if (node.paramChild.name !== paramName) {\n    throwParamNameConflict(node.paramChild.name, paramName, \":\");\n  }\n\n  return node.paramChild.node;\n}\n\n/** Splat counterpart of {@link ensureParamChild}. */\nexport function ensureSplatChild(\n  node: SegmentNode,\n  splatName: string,\n): SegmentNode {\n  if (!node.splatChild) {\n    node.splatChild = { node: createSegmentNode(), name: splatName };\n  } else if (node.splatChild.name !== splatName) {\n    throwParamNameConflict(node.splatChild.name, splatName, \"*\");\n  }\n\n  return node.splatChild.node;\n}\n"],"mappings":"4FAoBA,SAAgB,EAAiB,EAAyB,CACxD,IAAM,EAAQA,EAAAA,aAAa,CAAO,EAYlC,OALI,UAAW,GAAS,EAAM,OAAS,WACrC,EAAA,oBAAoB,EAIf,EAAM,IACf,CASA,SAAgB,EACd,EACA,EACa,CAOb,OANK,EAAK,WAEC,EAAK,WAAW,OAAS,GAClC,EAAA,uBAAuB,EAAK,WAAW,KAAM,EAAW,GAAG,EAF3D,EAAK,WAAa,CAAE,KAAMC,EAAAA,kBAAkB,EAAG,KAAM,CAAU,EAK1D,EAAK,WAAW,IACzB,CAGA,SAAgB,EACd,EACA,EACa,CAOb,OANK,EAAK,WAEC,EAAK,WAAW,OAAS,GAClC,EAAA,uBAAuB,EAAK,WAAW,KAAM,EAAW,GAAG,EAF3D,EAAK,WAAa,CAAE,KAAMA,EAAAA,kBAAkB,EAAG,KAAM,CAAU,EAK1D,EAAK,WAAW,IACzB"}
+{"version":3,"file":"trieNodes.js","names":["parseSegment","createSegmentNode"],"sources":["../../../../../src/engine/path-matcher/registration/trieNodes.ts"],"sourcesContent":["// Trie node construction: param-name extraction + the param/splat child creators\n// (#736). Consumed by `trie` during insertion.\n\nimport { parseSegment } from \"../parseSegment\";\nimport { createSegmentNode } from \"../pathUtils\";\nimport { throwEmptyParamName, throwParamNameConflict } from \"./errors\";\n\nimport type { SegmentNode } from \"../types\";\n\n/**\n * Extracts the param name from a marker-led segment (`:name` / `*name`),\n * delegating the boundary to the canonical `parseSegment` tokenizer (#1324) so the\n * trie backstop, the route-tree gate, and `buildParamMeta` share ONE grammar and\n * cannot drift. `registerNode`'s per-segment grammar pre-pass has already rejected\n * every malformed form (name-less #858, trailing marker `:y*`/`:y:` #1324, fused\n * marker #1050, and the M1 removed optional/constraint forms), so a `:param` /\n * `*splat` name is guaranteed here — the error/`static` branches below are an\n * unreachable typed backstop. Single source for the param branch in\n * `processSegment` (the 3-token walk no longer forks, #1516).\n */\nexport function extractParamName(segment: string): string {\n  const token = parseSegment(segment);\n\n  // registerNode's per-segment grammar pass (Реш.2) rejects every malformed segment\n  // — name-less (#858), trailing-marker (#1324), fused-marker (#1050), constraint\n  // forms — before trie insertion, so a param|splat name is guaranteed here. The\n  // error/`static` branches are unreachable, kept as a typed defensive backstop.\n  // This ALSO relies on createNode's leading-`/` normalization (#1407): a\n  // slash-less path (`a:`) let the trie's index-1 scan drop the leading char and\n  // reach `:` here (a name-less marker) — normalization keeps that branch dead.\n  /* v8 ignore start -- unreachable: registerNode's grammar pass rejects non-name segments first */\n  if (\"error\" in token || token.kind === \"static\") {\n    throwEmptyParamName();\n  }\n  /* v8 ignore stop */\n\n  return token.name;\n}\n\n/**\n * Returns the param child of `node`, creating it on first use. A pre-existing\n * child with a *different* name is a #736 conflict (two routes binding the same\n * trie position under different names). With the 3-token grammar (M1) insertion is\n * a strict linear walk, so a single route never revisits a slot it created — the\n * former optional-omit `ownNodes` exception is gone with optional params.\n */\nexport function ensureParamChild(\n  node: SegmentNode,\n  paramName: string,\n): SegmentNode {\n  if (!node.paramChild) {\n    node.paramChild = { node: createSegmentNode(), name: paramName };\n  } else if (node.paramChild.name !== paramName) {\n    throwParamNameConflict(node.paramChild.name, paramName, \":\");\n  }\n\n  return node.paramChild.node;\n}\n\n/** Splat counterpart of {@link ensureParamChild}. */\nexport function ensureSplatChild(\n  node: SegmentNode,\n  splatName: string,\n): SegmentNode {\n  if (!node.splatChild) {\n    node.splatChild = { node: createSegmentNode(), name: splatName };\n  } else if (node.splatChild.name !== splatName) {\n    throwParamNameConflict(node.splatChild.name, splatName, \"*\");\n  }\n\n  return node.splatChild.node;\n}\n"],"mappings":"4FAoBA,SAAgB,EAAiB,EAAyB,CACxD,IAAM,EAAQA,EAAAA,aAAa,CAAO,EAelC,OALI,UAAW,GAAS,EAAM,OAAS,WACrC,EAAA,oBAAoB,EAIf,EAAM,IACf,CASA,SAAgB,EACd,EACA,EACa,CAOb,OANK,EAAK,WAEC,EAAK,WAAW,OAAS,GAClC,EAAA,uBAAuB,EAAK,WAAW,KAAM,EAAW,GAAG,EAF3D,EAAK,WAAa,CAAE,KAAMC,EAAAA,kBAAkB,EAAG,KAAM,CAAU,EAK1D,EAAK,WAAW,IACzB,CAGA,SAAgB,EACd,EACA,EACa,CAOb,OANK,EAAK,WAEC,EAAK,WAAW,OAAS,GAClC,EAAA,uBAAuB,EAAK,WAAW,KAAM,EAAW,GAAG,EAF3D,EAAK,WAAa,CAAE,KAAMA,EAAAA,kBAAkB,EAAG,KAAM,CAAU,EAK1D,EAAK,WAAW,IACzB"}

package/dist/cjs/internals.js.map

@@ -1 +1 @@
-{"version":3,"file":"internals.js","names":[],"sources":["../../src/internals.ts"],"sourcesContent":["import type { RouteTree } from \"./engine\";\nimport type { DependenciesStore } from \"./namespaces\";\nimport type { RoutesStore } from \"./namespaces/RoutesNamespace\";\nimport type { Router as RouterClass } from \"./Router\";\nimport type {\n  DefaultDependencies,\n  EventName,\n  LoggerConfig,\n  NavigationOptions,\n  Options,\n  Params,\n  Plugin,\n  Router as RouterInterface,\n  RouterLogger,\n  RouteTreeState,\n  SerializedRouterState,\n  SimpleState,\n  State,\n  TreeChangedEvent,\n  Unsubscribe,\n  EventMethodMap,\n  PluginFactory,\n} from \"./types\";\nimport type { RouterValidator } from \"./types/RouterValidator\";\n\nexport interface RouterInternals<\n  D extends DefaultDependencies = DefaultDependencies,\n> {\n  readonly makeState: <P extends Params = Params>(\n    name: string,\n    params?: P,\n    path?: string,\n    meta?: Record<string, Record<string, \"url\" | \"query\">>,\n  ) => State<P>;\n\n  readonly forwardState: <P extends Params = Params>(\n    routeName: string,\n    routeParams: P,\n  ) => SimpleState<P>;\n\n  readonly buildStateResolved: (\n    resolvedName: string,\n    resolvedParams: Params,\n  ) => RouteTreeState | undefined;\n\n  readonly matchPath: <P extends Params = Params>(\n    path: string,\n    options?: Options,\n  ) => State<P> | undefined;\n\n  readonly getOptions: () => Options;\n\n  readonly addEventListener: <E extends EventName>(\n    eventName: E,\n    cb: Plugin[EventMethodMap[E]],\n  ) => Unsubscribe;\n\n  /**\n   * Route-tree mutation channel — internal access for the `getRoutesApi`\n   * wrapper. A dedicated bridge is required because the public\n   * `addEventListener<E extends EventName>` structurally rejects\n   * `\"TREE_CHANGED\"` (it is not in the public `EventName` union), is strict on\n   * duplicates, and exposes neither `emit` nor `listenerCount`.\n   */\n  readonly treeChanged: {\n    readonly emit: (event: TreeChangedEvent) => void;\n    readonly subscribe: (\n      handler: (event: TreeChangedEvent) => void,\n    ) => Unsubscribe;\n    readonly listenerCount: () => number;\n    /**\n     * True while a `TREE_CHANGED` emit is on the stack — `getRoutesApi` reads it\n     * to reject reentrant route-CRUD from a `subscribeChanges` handler (#1032).\n     */\n    readonly isEmitting: () => boolean;\n  };\n\n  readonly buildPath: (route: string, params?: Params) => string;\n\n  readonly emitTransitionError: (error: Error) => void;\n\n  /**\n   * Emits `TRANSITION_SUCCESS` directly (no FSM transition) — used by\n   * `getRoutesApi().replace()` to notify `router.subscribe` listeners when a\n   * structural replace revalidates the active state (#950). Mirrors the success\n   * emission `completeTransition` / `navigateToNotFound` perform.\n   */\n  readonly emitTransitionSuccess: (\n    toState: State,\n    fromState: State | undefined,\n    opts?: NavigationOptions,\n  ) => void;\n\n  /**\n   * Commits the not-found (`UNKNOWN_ROUTE`) state for `path` and emits\n   * `TRANSITION_SUCCESS` — the `NavigationNamespace.navigateToNotFound`\n   * primitive. `replace()` uses it when a structural replace drops the active\n   * route, so subscribers are notified instead of the state silently clearing\n   * (#950).\n   */\n  readonly navigateToNotFound: (path: string) => State;\n\n  readonly start: (path: string) => Promise<State>;\n\n  /**\n   * Plugin-only navigation entry point — delegates to\n   * `NavigationNamespace.navigateToState` (`getPluginApi(router).navigateToState`).\n   * Hidden from `Router`/`Navigator` to keep the userland surface minimal;\n   * see `core-types/src/api.ts` for usage docs.\n   */\n  readonly navigateToState: (\n    state: State,\n    options?: NavigationOptions,\n  ) => Promise<State>;\n\n  /* eslint-disable @typescript-eslint/no-explicit-any -- heterogeneous map: stores different InterceptorFn<M> types under different keys */\n  readonly interceptors: Map<\n    string,\n    ((next: (...args: any[]) => any, ...args: any[]) => any)[]\n  >;\n  /* eslint-enable @typescript-eslint/no-explicit-any */\n\n  readonly setRootPath: (rootPath: string) => void;\n  readonly getRootPath: () => string;\n\n  readonly getTree: () => RouteTree;\n\n  readonly isDisposed: () => boolean;\n\n  validator: RouterValidator | null;\n\n  // Per-router logger instance (built from `options.logger` in the Router\n  // constructor). The facade reads it as `getInternals(this).logger`; namespaces\n  // receive it via their deps at wiring; plugins reach it through\n  // `getPluginApi(router).logger`. Replaces the former process-global singleton\n  // from the standalone `@real-router/logger` package (now folded into\n  // `foundation/logger`), whose `configure()` leaked across routers (#724).\n  readonly logger: RouterLogger;\n\n  // Dependencies (issue #172)\n  readonly dependenciesGetStore: () => DependenciesStore<D>;\n\n  // Clone support (issue #173, consolidated #964). One accessor for the\n  // source-side snapshot a clone carries over besides the route store, so a new\n  // clone-relevant subsystem is wired in a single place instead of being spread\n  // across separate methods.\n  readonly getCloneState: () => {\n    options: Options;\n    dependencies: Record<string, unknown>;\n    pluginFactories: PluginFactory<D>[];\n    // Resolved logger config of the base router, so a clone can build its OWN\n    // logger inheriting the base's level/callback. Frozen `options` do NOT carry\n    // `logger` (stripped in the constructor), so `options` above can't convey it;\n    // cloneRouter merges a per-request override (traceId) over this snapshot.\n    loggerConfig: LoggerConfig;\n  };\n\n  // Consolidated route data store (issue #174 Phase 2)\n  readonly routeGetStore: () => RoutesStore<D>;\n\n  // Cross-namespace state (issue #174)\n  readonly getStateName: () => string | undefined;\n  readonly isTransitioning: () => boolean;\n  readonly clearState: () => void;\n  readonly setState: (state: State) => void;\n  readonly routerExtensions: { keys: string[] }[];\n  readonly contextClaimRecords: Set<string>;\n\n  /**\n   * One-shot hydration scratchpad populated by `hydrateRouter` immediately\n   * before delegating to `router.start(parsed.path)` and cleared in the\n   * matching `finally`. SSR loader plugins read this slot directly via\n   * `getInternals(router).hydrationState` to short-circuit their own loader\n   * call when the server-resolved namespace value is already present in the\n   * parsed state (#596). `null` outside of an active `hydrateRouter`\n   * invocation.\n   */\n  hydrationState: SerializedRouterState | null;\n}\n\n// eslint-disable-next-line @typescript-eslint/no-explicit-any -- existential type: stores RouterInternals for all Dependencies types\nconst internals = new WeakMap<object, RouterInternals<any>>();\n\nexport function getInternals<D extends DefaultDependencies>(\n  router: RouterInterface<D>,\n): RouterInternals<D> {\n  const ctx = internals.get(router);\n\n  if (!ctx) {\n    throw new TypeError(\n      \"[real-router] Invalid router instance — not found in internals registry\",\n    );\n  }\n\n  return ctx as RouterInternals<D>;\n}\n\nexport function registerInternals<D extends DefaultDependencies>(\n  router: RouterClass<D>,\n  ctx: RouterInternals<D>,\n): void {\n  internals.set(router, ctx);\n}\n\n/* eslint-disable @typescript-eslint/no-explicit-any, @typescript-eslint/no-unsafe-return, @typescript-eslint/no-unsafe-argument -- internal chain execution: type safety enforced at public API boundary (PluginApi.addInterceptor) */\nfunction executeInterceptorChain<T>(\n  interceptors: ((next: (...args: any[]) => any, ...args: any[]) => any)[],\n  original: (...args: any[]) => T,\n  args: any[],\n): T {\n  let chain = original as (...args: any[]) => any;\n\n  for (const interceptor of interceptors) {\n    const prev = chain;\n\n    chain = (...chainArgs: any[]) => interceptor(prev, ...chainArgs);\n  }\n\n  return chain(...args) as T;\n}\n\n/**\n * Variadic interceptor wrapper — wraps a function of any arity, returning the\n * same callable type `T`. Use {@link createBinaryInterceptable} instead when the\n * wrapped method takes exactly two args and the caller needs the precise\n * `(a, b) => r` signature preserved (the variadic form widens args to `any[]`).\n */\nexport function createInterceptable<T extends (...args: any[]) => any>(\n  name: string,\n  original: T,\n  interceptors: Map<\n    string,\n    ((next: (...args: any[]) => any, ...args: any[]) => any)[]\n  >,\n): T {\n  return ((...args: any[]) => {\n    const chain = interceptors.get(name);\n\n    if (!chain || chain.length === 0) {\n      return original(...args);\n    }\n\n    return executeInterceptorChain(chain, original, args);\n  }) as T;\n}\n\n/**\n * Two-argument interceptor wrapper — preserves the exact `(a: A, b: B) => R`\n * signature, which the variadic {@link createInterceptable} cannot express\n * (it widens args to `any[]`). Used for the binary interceptable methods\n * `forwardState(routeName, routeParams)` and `buildPath(route, params)`.\n */\nexport function createBinaryInterceptable<A, B, R>(\n  name: string,\n  original: (a: A, b: B) => R,\n  interceptors: Map<\n    string,\n    ((next: (...args: any[]) => any, ...args: any[]) => any)[]\n  >,\n): (a: A, b: B) => R {\n  return (arg1: A, arg2: B) => {\n    const chain = interceptors.get(name);\n\n    if (!chain || chain.length === 0) {\n      return original(arg1, arg2);\n    }\n\n    return executeInterceptorChain(chain, original, [arg1, arg2]);\n  };\n}\n/* eslint-enable @typescript-eslint/no-explicit-any, @typescript-eslint/no-unsafe-return, @typescript-eslint/no-unsafe-argument */\n"],"mappings":"AAqLA,MAAM,EAAY,IAAI,QAEtB,SAAgB,EACd,EACoB,CACpB,IAAM,EAAM,EAAU,IAAI,CAAM,EAEhC,GAAI,CAAC,EACH,MAAU,UACR,yEACF,EAGF,OAAO,CACT,CAEA,SAAgB,EACd,EACA,EACM,CACN,EAAU,IAAI,EAAQ,CAAG,CAC3B,CAGA,SAAS,EACP,EACA,EACA,EACG,CACH,IAAI,EAAQ,EAEZ,IAAK,IAAM,KAAe,EAAc,CACtC,IAAM,EAAO,EAEb,GAAS,GAAG,IAAqB,EAAY,EAAM,GAAG,CAAS,CACjE,CAEA,OAAO,EAAM,GAAG,CAAI,CACtB,CAQA,SAAgB,EACd,EACA,EACA,EAIG,CACH,QAAS,GAAG,IAAgB,CAC1B,IAAM,EAAQ,EAAa,IAAI,CAAI,EAMnC,MAJI,CAAC,GAAS,EAAM,SAAW,EACtB,EAAS,GAAG,CAAI,EAGlB,EAAwB,EAAO,EAAU,CAAI,CACtD,EACF,CAQA,SAAgB,EACd,EACA,EACA,EAImB,CACnB,OAAQ,EAAS,IAAY,CAC3B,IAAM,EAAQ,EAAa,IAAI,CAAI,EAMnC,MAJI,CAAC,GAAS,EAAM,SAAW,EACtB,EAAS,EAAM,CAAI,EAGrB,EAAwB,EAAO,EAAU,CAAC,EAAM,CAAI,CAAC,CAC9D,CACF"}
+{"version":3,"file":"internals.js","names":[],"sources":["../../src/internals.ts"],"sourcesContent":["import type { RouteTree } from \"./engine\";\nimport type { DependenciesStore } from \"./namespaces\";\nimport type { RoutesStore } from \"./namespaces/RoutesNamespace\";\nimport type { Router as RouterClass } from \"./Router\";\nimport type {\n  DefaultDependencies,\n  EventName,\n  LoggerConfig,\n  NavigationOptions,\n  Options,\n  Params,\n  Plugin,\n  Router as RouterInterface,\n  RouterLogger,\n  RouteTreeState,\n  SerializedRouterState,\n  SimpleState,\n  State,\n  TreeChangedEvent,\n  Unsubscribe,\n  EventMethodMap,\n  PluginFactory,\n} from \"./types\";\nimport type { RouterValidator } from \"./types/RouterValidator\";\n\nexport interface RouterInternals<\n  D extends DefaultDependencies = DefaultDependencies,\n> {\n  readonly makeState: <P extends Params = Params>(\n    name: string,\n    params?: P,\n    path?: string,\n    meta?: Record<string, Record<string, \"url\" | \"query\">>,\n  ) => State<P>;\n\n  readonly forwardState: <P extends Params = Params>(\n    routeName: string,\n    routeParams: P,\n  ) => SimpleState<P>;\n\n  readonly buildStateResolved: (\n    resolvedName: string,\n    resolvedParams: Params,\n  ) => RouteTreeState | undefined;\n\n  readonly matchPath: <P extends Params = Params>(\n    path: string,\n    options?: Options,\n  ) => State<P> | undefined;\n\n  readonly getOptions: () => Options;\n\n  readonly addEventListener: <E extends EventName>(\n    eventName: E,\n    cb: Plugin[EventMethodMap[E]],\n  ) => Unsubscribe;\n\n  /**\n   * Route-tree mutation channel — internal access for the `getRoutesApi`\n   * wrapper. A dedicated bridge is required because the public\n   * `addEventListener<E extends EventName>` structurally rejects\n   * `\"TREE_CHANGED\"` (it is not in the public `EventName` union), is strict on\n   * duplicates, and exposes neither `emit` nor `listenerCount`.\n   */\n  readonly treeChanged: {\n    readonly emit: (event: TreeChangedEvent) => void;\n    readonly subscribe: (\n      handler: (event: TreeChangedEvent) => void,\n    ) => Unsubscribe;\n    readonly listenerCount: () => number;\n    /**\n     * True while a `TREE_CHANGED` emit is on the stack — `getRoutesApi` reads it\n     * to reject reentrant route-CRUD from a `subscribeChanges` handler (#1032).\n     */\n    readonly isEmitting: () => boolean;\n  };\n\n  readonly buildPath: (route: string, params?: Params) => string;\n\n  readonly emitTransitionError: (error: Error) => void;\n\n  /**\n   * Emits `TRANSITION_SUCCESS` directly (no FSM transition) — used by\n   * `getRoutesApi().replace()` to notify `router.subscribe` listeners when a\n   * structural replace revalidates the active state (#950). Mirrors the success\n   * emission `completeTransition` / `navigateToNotFound` perform.\n   */\n  readonly emitTransitionSuccess: (\n    toState: State,\n    fromState: State | undefined,\n    opts?: NavigationOptions,\n  ) => void;\n\n  /**\n   * Commits the not-found (`UNKNOWN_ROUTE`) state for `path` and emits\n   * `TRANSITION_SUCCESS` — the `NavigationNamespace.navigateToNotFound`\n   * primitive. `replace()` uses it when a structural replace drops the active\n   * route, so subscribers are notified instead of the state silently clearing\n   * (#950).\n   */\n  readonly navigateToNotFound: (path: string) => State;\n\n  readonly start: (path: string) => Promise<State>;\n\n  /**\n   * Plugin-only navigation entry point — delegates to\n   * `NavigationNamespace.navigateToState` (`getPluginApi(router).navigateToState`).\n   * Hidden from `Router`/`Navigator` to keep the userland surface minimal;\n   * see `core-types/src/api.ts` for usage docs.\n   */\n  readonly navigateToState: (\n    state: State,\n    options?: NavigationOptions,\n  ) => Promise<State>;\n\n  /* eslint-disable @typescript-eslint/no-explicit-any -- heterogeneous map: stores different InterceptorFn<M> types under different keys */\n  readonly interceptors: Map<\n    string,\n    ((next: (...args: any[]) => any, ...args: any[]) => any)[]\n  >;\n  /* eslint-enable @typescript-eslint/no-explicit-any */\n\n  readonly setRootPath: (rootPath: string) => void;\n  readonly getRootPath: () => string;\n\n  readonly getTree: () => RouteTree;\n\n  readonly isDisposed: () => boolean;\n\n  validator: RouterValidator | null;\n\n  // Per-router logger instance (built from `options.logger` in the Router\n  // constructor). The facade reads it as `getInternals(this).logger`; namespaces\n  // receive it via their deps at wiring; plugins reach it through\n  // `getPluginApi(router).logger`. Replaces the former process-global singleton\n  // from the standalone `@real-router/logger` package (now folded into\n  // `utils/logger`), whose `configure()` leaked across routers (#724).\n  readonly logger: RouterLogger;\n\n  // Dependencies (issue #172)\n  readonly dependenciesGetStore: () => DependenciesStore<D>;\n\n  // Clone support (issue #173, consolidated #964). One accessor for the\n  // source-side snapshot a clone carries over besides the route store, so a new\n  // clone-relevant subsystem is wired in a single place instead of being spread\n  // across separate methods.\n  readonly getCloneState: () => {\n    options: Options;\n    dependencies: Record<string, unknown>;\n    pluginFactories: PluginFactory<D>[];\n    // Resolved logger config of the base router, so a clone can build its OWN\n    // logger inheriting the base's level/callback. Frozen `options` do NOT carry\n    // `logger` (stripped in the constructor), so `options` above can't convey it;\n    // cloneRouter merges a per-request override (traceId) over this snapshot.\n    loggerConfig: LoggerConfig;\n  };\n\n  // Consolidated route data store (issue #174 Phase 2)\n  readonly routeGetStore: () => RoutesStore<D>;\n\n  // Cross-namespace state (issue #174)\n  readonly getStateName: () => string | undefined;\n  readonly isTransitioning: () => boolean;\n  readonly clearState: () => void;\n  readonly setState: (state: State) => void;\n  readonly routerExtensions: { keys: string[] }[];\n  readonly contextClaimRecords: Set<string>;\n\n  /**\n   * One-shot hydration scratchpad populated by `hydrateRouter` immediately\n   * before delegating to `router.start(parsed.path)` and cleared in the\n   * matching `finally`. SSR loader plugins read this slot directly via\n   * `getInternals(router).hydrationState` to short-circuit their own loader\n   * call when the server-resolved namespace value is already present in the\n   * parsed state (#596). `null` outside of an active `hydrateRouter`\n   * invocation.\n   */\n  hydrationState: SerializedRouterState | null;\n}\n\n// eslint-disable-next-line @typescript-eslint/no-explicit-any -- existential type: stores RouterInternals for all Dependencies types\nconst internals = new WeakMap<object, RouterInternals<any>>();\n\nexport function getInternals<D extends DefaultDependencies>(\n  router: RouterInterface<D>,\n): RouterInternals<D> {\n  const ctx = internals.get(router);\n\n  if (!ctx) {\n    throw new TypeError(\n      \"[real-router] Invalid router instance — not found in internals registry\",\n    );\n  }\n\n  return ctx as RouterInternals<D>;\n}\n\nexport function registerInternals<D extends DefaultDependencies>(\n  router: RouterClass<D>,\n  ctx: RouterInternals<D>,\n): void {\n  internals.set(router, ctx);\n}\n\n/* eslint-disable @typescript-eslint/no-explicit-any, @typescript-eslint/no-unsafe-return, @typescript-eslint/no-unsafe-argument -- internal chain execution: type safety enforced at public API boundary (PluginApi.addInterceptor) */\nfunction executeInterceptorChain<T>(\n  interceptors: ((next: (...args: any[]) => any, ...args: any[]) => any)[],\n  original: (...args: any[]) => T,\n  args: any[],\n): T {\n  let chain = original as (...args: any[]) => any;\n\n  for (const interceptor of interceptors) {\n    const prev = chain;\n\n    chain = (...chainArgs: any[]) => interceptor(prev, ...chainArgs);\n  }\n\n  return chain(...args) as T;\n}\n\n/**\n * Variadic interceptor wrapper — wraps a function of any arity, returning the\n * same callable type `T`. Use {@link createBinaryInterceptable} instead when the\n * wrapped method takes exactly two args and the caller needs the precise\n * `(a, b) => r` signature preserved (the variadic form widens args to `any[]`).\n */\nexport function createInterceptable<T extends (...args: any[]) => any>(\n  name: string,\n  original: T,\n  interceptors: Map<\n    string,\n    ((next: (...args: any[]) => any, ...args: any[]) => any)[]\n  >,\n): T {\n  return ((...args: any[]) => {\n    const chain = interceptors.get(name);\n\n    if (!chain || chain.length === 0) {\n      return original(...args);\n    }\n\n    return executeInterceptorChain(chain, original, args);\n  }) as T;\n}\n\n/**\n * Two-argument interceptor wrapper — preserves the exact `(a: A, b: B) => R`\n * signature, which the variadic {@link createInterceptable} cannot express\n * (it widens args to `any[]`). Used for the binary interceptable methods\n * `forwardState(routeName, routeParams)` and `buildPath(route, params)`.\n */\nexport function createBinaryInterceptable<A, B, R>(\n  name: string,\n  original: (a: A, b: B) => R,\n  interceptors: Map<\n    string,\n    ((next: (...args: any[]) => any, ...args: any[]) => any)[]\n  >,\n): (a: A, b: B) => R {\n  return (arg1: A, arg2: B) => {\n    const chain = interceptors.get(name);\n\n    if (!chain || chain.length === 0) {\n      return original(arg1, arg2);\n    }\n\n    return executeInterceptorChain(chain, original, [arg1, arg2]);\n  };\n}\n/* eslint-enable @typescript-eslint/no-explicit-any, @typescript-eslint/no-unsafe-return, @typescript-eslint/no-unsafe-argument */\n"],"mappings":"AAqLA,MAAM,EAAY,IAAI,QAEtB,SAAgB,EACd,EACoB,CACpB,IAAM,EAAM,EAAU,IAAI,CAAM,EAEhC,GAAI,CAAC,EACH,MAAU,UACR,yEACF,EAGF,OAAO,CACT,CAEA,SAAgB,EACd,EACA,EACM,CACN,EAAU,IAAI,EAAQ,CAAG,CAC3B,CAGA,SAAS,EACP,EACA,EACA,EACG,CACH,IAAI,EAAQ,EAEZ,IAAK,IAAM,KAAe,EAAc,CACtC,IAAM,EAAO,EAEb,GAAS,GAAG,IAAqB,EAAY,EAAM,GAAG,CAAS,CACjE,CAEA,OAAO,EAAM,GAAG,CAAI,CACtB,CAQA,SAAgB,EACd,EACA,EACA,EAIG,CACH,QAAS,GAAG,IAAgB,CAC1B,IAAM,EAAQ,EAAa,IAAI,CAAI,EAMnC,MAJI,CAAC,GAAS,EAAM,SAAW,EACtB,EAAS,GAAG,CAAI,EAGlB,EAAwB,EAAO,EAAU,CAAI,CACtD,EACF,CAQA,SAAgB,EACd,EACA,EACA,EAImB,CACnB,OAAQ,EAAS,IAAY,CAC3B,IAAM,EAAQ,EAAa,IAAI,CAAI,EAMnC,MAJI,CAAC,GAAS,EAAM,SAAW,EACtB,EAAS,EAAM,CAAI,EAGrB,EAAwB,EAAO,EAAU,CAAC,EAAM,CAAI,CAAC,CAC9D,CACF"}