@real-router/core 0.67.1 → 0.68.1

package/dist/esm/api.d.mts

@@ -1,4 +1,4 @@
-import { i as RouteTree } from "./index-BHYayJAM.mjs";
+import { i as RouteTree } from "./index-DFoTsLB1.mjs";
 import { t as Router$1 } from "./Router-Bm2qafJA.mjs";
 import { DefaultDependencies, DependenciesApi, LifecycleApi, PluginApi as PluginApi$1, Router, RoutesApi } from "@real-router/types";
 

package/dist/esm/api.mjs

@@ -1,2 +1,2 @@
-import{_ as e,a as t,b as n,c as r,d as i,f as a,g as o,i as s,l as c,o as l,p as u,r as d,s as f,u as p,y as m}from"./Router-Bl6FWI6U.mjs";import{r as h}from"./internals-C8mRvTxc.mjs";import{a as g,i as _,n as v,r as y,t as b}from"./cloneRouter-Q4bYKC4E.mjs";import{logger as x}from"@real-router/logger";function S(e,t,n){if(t){let n=t===e,r=t.startsWith(`${e}.`);if(n||r){let r=n?``:` (current: "${t}")`;return x.warn(`router.removeRoute`,`Cannot remove route "${e}" — it is currently active${r}. Navigate away first.`),!1}}return n&&x.warn(`router.removeRoute`,`Route "${e}" removed while navigation is in progress. This may cause unexpected behavior.`),!0}function C(e){return e?(x.error(`router.clearRoutes`,`Cannot clear routes while navigation is in progress. Wait for navigation to complete.`),!1):!0}const w=Object.freeze({replace:!0});function T(e,t,n,r){let i=t=>t===e||t.startsWith(`${e}.`);o(t.decoders,i),o(t.encoders,i),o(t.defaultParams,i),o(t.forwardMap,i),o(t.forwardFnMap,i),o(n,i),o(t.forwardMap,e=>i(t.forwardMap[e]));let[a,s]=r.getFactories();for(let e of Object.keys(s))i(e)&&r.clearCanActivate(e);for(let e of Object.keys(a))i(e)&&r.clearCanDeactivate(e)}function E(e,t,n,r){let i=n.forwardFnMap[t],a=n.forwardMap[t];i===void 0?a!==void 0&&(e.forwardTo=a):e.forwardTo=i,t in n.defaultParams&&(e.defaultParams=n.defaultParams[t]),t in n.decoders&&(e.decodeParams=n.decoders[t]),t in n.encoders&&(e.encodeParams=n.encoders[t]);let[o,s]=r;return t in s&&(e.canActivate=s[t]),t in o&&(e.canDeactivate=o[t]),e}function D(e,t,n,r){let i={name:e.name,path:e.path};return E(i,t,n,r),e.children&&(i.children=e.children.map(e=>D(e,`${t}.${e.name}`,n,r))),i}function O(e,t,n,r){let i={name:e,path:t};return E(i,e,n,r),Object.freeze(i)}function k(e,t){let n=new Map,r=e.lifecycleNamespace.getFactories(),i=(a,o)=>{for(let s of a){let a=o?`${o}.${s.name}`:s.name;t(a)&&n.set(a,O(a,s.path,e.config,r)),s.children&&i(s.children,a)}};return i(e.definitions,``),n}function A(e,t){let n=`${t}.`,r=k(e,e=>e===t||e.startsWith(n));return Object.freeze([...r.values()])}function j(e,t,n){let r=n.lifecycleNamespace.getFactories(),i=[],a=(e,t)=>{for(let o of e){let e=t?`${t}.${o.name}`:o.name;i.push(O(e,o.path,n.config,r)),o.children&&a(o.children,e)}};return a(e,t??``),Object.freeze(i)}function M(e,t){let n=[],r=[];for(let[r,i]of e)t.has(r)||n.push(i);for(let[n,i]of t)e.has(n)||r.push(i);return{removed:Object.freeze(n),added:Object.freeze(r)}}function N(e){let t={};return e.forwardTo!==void 0&&(t.forwardTo=e.forwardTo),e.defaultParams!==void 0&&(t.defaultParams=e.defaultParams),e.encodeParams!==void 0&&(t.encodeParams=e.encodeParams),e.decodeParams!==void 0&&(t.decodeParams=e.decodeParams),Object.freeze(t)}function P(e,t,n){s(e,t,n);let r=c(e,t,n);e.lifecycleNamespace.preflightHandlerLimit(r.pendingCanActivate.keys(),r.pendingCanDeactivate.keys(),!1),d(e,r)}function F(e,n,r,i,a){f(n,`addRoute`),t(n,``,`addRoute`),l(n,``,`addRoute`);let o=p(n,e.rootPath,e.matcherOptions);if(e.lifecycleNamespace.preflightHandlerLimit(o.pendingCanActivate.keys(),o.pendingCanDeactivate.keys(),!0),e.lifecycleNamespace.clearDefinitionGuards(),d(e,o),a?.(),i!==void 0){let e=r.matchPath(i.path,r.getOptions());if(e){let t={...e,transition:i.transition};r.setState(t),r.emitTransitionSuccess(t,i,w)}else r.navigateToNotFound(i.path)}}function I(t,n){return e(t.definitions,n)?(T(n,t.config,t.routeCustomFields,t.lifecycleNamespace),a(t),!0):!1}function L(e,t){let n=e.matcher.getSegmentsByName(t);if(!n)return;let r=m(n.at(-1)),i=e.lifecycleNamespace.getFactories();return D(r,t,e.config,i)}const R=new WeakMap;function z(e){let t=R.get(e);if(t)return t;let a=h(e),o=a.routeGetStore(),s=e=>{a.treeChanged.emit(e)},c={add:(e,t)=>{_(a.isDisposed),g(a.treeChanged.isEmitting);let r=Array.isArray(e)?e:[e],i=t?.parent;if(n(r,a.validator),i!==void 0&&a.validator?.routes.validateParentOption(i,o.tree),a.validator?.routes.throwIfInternalRouteInArray(r,`addRoute`),a.validator?.routes.validateAddRouteArgs(r),a.validator?.routes.validateRoutes(r,o),P(o,r,i),a.treeChanged.listenerCount()>0){let e=j(r,i,o);s(i===void 0?{op:`add`,added:e}:{op:`add`,added:e,parent:i})}},remove:e=>{if(_(a.isDisposed),g(a.treeChanged.isEmitting),a.validator?.routes.validateRemoveRouteArgs(e),a.validator?.routes.throwIfInternalRoute(e,`removeRoute`),r(e,`removeRoute`),!S(e,a.getStateName(),a.isTransitioning()))return;let t=a.treeChanged.listenerCount()>0?A(o,e):void 0;if(!I(o,e)){x.warn(`router.removeRoute`,`Route "${e}" not found. No changes made.`);return}t!==void 0&&s({op:`remove`,name:e,removedSubtree:t})},update:(e,t)=>{_(a.isDisposed),g(a.treeChanged.isEmitting),a.validator?.routes.validateUpdateRouteBasicArgs(e,t),a.validator?.routes.throwIfInternalRoute(e,`updateRoute`),r(e,`updateRoute`),a.validator?.routes.validateUpdateRoutePropertyTypes(e,t),a.isTransitioning()&&x.error(`router.updateRoute`,`Updating route "${e}" while navigation is in progress. This may cause unexpected behavior.`),a.validator?.routes.validateUpdateRoute(e,t,o);let n=o.lifecycleNamespace,c=i(o,n,e,t);if(a.treeChanged.listenerCount()>0){let t=N(c);Object.keys(t).length>0&&s({op:`update`,name:e,patch:t})}},clear:()=>{if(_(a.isDisposed),g(a.treeChanged.isEmitting),!C(a.isTransitioning()))return;let e=a.treeChanged.listenerCount()>0?Object.freeze([...k(o,()=>!0).values()]):void 0;u(o),o.lifecycleNamespace.clearAll(),a.clearState(),e!==void 0&&s({op:`clear`,removed:e})},has:e=>(a.validator?.routes.validateRouteName(e,`hasRoute`),o.matcher.hasRoute(e)),get:e=>(a.validator?.routes.validateRouteName(e,`getRoute`),L(o,e)),replace:t=>{_(a.isDisposed),g(a.treeChanged.isEmitting);let r=Array.isArray(t)?t:[t];if(!C(a.isTransitioning()))return;n(r,a.validator),a.validator?.routes.throwIfInternalRouteInArray(r,`replaceRoutes`),a.validator?.routes.validateAddRouteArgs(r),a.validator?.routes.validateRoutes(r,o);let i=e.getState(),c=a.treeChanged.listenerCount()>0?k(o,()=>!0):void 0;F(o,r,a,i,c===void 0?void 0:()=>{let{removed:e,added:t}=M(c,k(o,()=>!0));s({op:`replace`,removed:e,added:t})})},subscribeChanges:e=>a.treeChanged.subscribe(e)};return R.set(e,c),c}function B(e,t,n,r){if(n!==void 0){if(!Object.hasOwn(e.dependencies,t))r?.dependencies.validateDependencyCount(e,`setDependency`);else{let i=e.dependencies[t];i!==n&&!(Number.isNaN(i)&&Number.isNaN(n))&&r?.dependencies.warnOverwrite(t,`setDependency`)}e.dependencies[t]=n}}function V(e,t,n){let r=[];for(let i in t)t[i]!==void 0&&(Object.hasOwn(e.dependencies,i)?r.push(i):n?.dependencies.validateDependencyCount(e,`setDependencies`),e.dependencies[i]=t[i]);r.length>0&&n?.dependencies.warnBatchOverwrite(r,`setDependencies`)}function H(e){let t=h(e);return{get:e=>{t.validator?.dependencies.validateDependencyName(e,`getDependency`);let n=t.dependenciesGetStore(),r=n.dependencies[e];return t.validator?.dependencies.validateDependencyExists(e,n),r},getAll:()=>({...t.dependenciesGetStore().dependencies}),set:(e,n)=>{_(t.isDisposed),t.validator?.dependencies.validateSetDependencyArgs(e,n,`setDependency`),B(t.dependenciesGetStore(),e,n,t.validator)},setAll:e=>{_(t.isDisposed);let n=t.dependenciesGetStore();t.validator?.dependencies.validateDependenciesObject(e,`setDependencies`),t.validator?.dependencies.validateDependencyLimit(n,n.limits),V(n,e,t.validator)},remove:e=>{_(t.isDisposed),t.validator?.dependencies.validateDependencyName(e,`removeDependency`);let n=t.dependenciesGetStore();Object.hasOwn(n.dependencies,e)||t.validator?.dependencies.warnRemoveNonExistent(e),delete n.dependencies[e]},reset:()=>{_(t.isDisposed);let e=t.dependenciesGetStore();e.dependencies=Object.create(null)},has:e=>(t.validator?.dependencies.validateDependencyName(e,`hasDependency`),Object.hasOwn(t.dependenciesGetStore().dependencies,e))}}export{b as cloneRouter,H as getDependenciesApi,v as getLifecycleApi,y as getPluginApi,z as getRoutesApi};
+import{_ as e,a as t,c as n,d as r,f as i,g as a,i as o,l as s,o as c,p as l,r as u,s as d,u as f,v as p}from"./Router-DrBJNtHp.mjs";import{a as m,l as h}from"./esm-DVWMs97_.mjs";import{a as g,i as _,n as v,r as y,t as b}from"./cloneRouter-wDGXORhn.mjs";import{logger as x}from"@real-router/logger";function S(e,t,n){if(t){let n=t===e,r=t.startsWith(`${e}.`);if(n||r){let r=n?``:` (current: "${t}")`;return x.warn(`router.removeRoute`,`Cannot remove route "${e}" — it is currently active${r}. Navigate away first.`),!1}}return n&&x.warn(`router.removeRoute`,`Route "${e}" removed while navigation is in progress. This may cause unexpected behavior.`),!0}function C(e){return e?(x.error(`router.clearRoutes`,`Cannot clear routes while navigation is in progress. Wait for navigation to complete.`),!1):!0}const w=Object.freeze({replace:!0});function T(e,t,n,r){let i=t=>t===e||t.startsWith(`${e}.`);a(t.decoders,i),a(t.encoders,i),a(t.defaultParams,i),a(t.forwardMap,i),a(t.forwardFnMap,i),a(n,i),a(t.forwardMap,e=>i(t.forwardMap[e]));let[o,s]=r.getFactories();for(let e of Object.keys(s))i(e)&&r.clearCanActivate(e);for(let e of Object.keys(o))i(e)&&r.clearCanDeactivate(e)}function E(e,t,n,r){let i=n.forwardFnMap[t],a=n.forwardMap[t];i===void 0?a!==void 0&&(e.forwardTo=a):e.forwardTo=i,t in n.defaultParams&&(e.defaultParams=n.defaultParams[t]),t in n.decoders&&(e.decodeParams=n.decoders[t]),t in n.encoders&&(e.encodeParams=n.encoders[t]);let[o,s]=r;return t in s&&(e.canActivate=s[t]),t in o&&(e.canDeactivate=o[t]),e}function D(e,t,n,r){let i={name:e.name,path:e.path};return E(i,t,n,r),e.children&&(i.children=e.children.map(e=>D(e,`${t}.${e.name}`,n,r))),i}function O(e,t,n,r){let i={name:e,path:t};return E(i,e,n,r),Object.freeze(i)}function k(e,t){let n=new Map,r=e.lifecycleNamespace.getFactories(),i=(a,o)=>{for(let s of a){let a=o?`${o}.${s.name}`:s.name;t(a)&&n.set(a,O(a,s.path,e.config,r)),s.children&&i(s.children,a)}};return i(e.definitions,``),n}function A(e,t){let n=`${t}.`,r=k(e,e=>e===t||e.startsWith(n));return Object.freeze([...r.values()])}function j(e,t,n){let r=n.lifecycleNamespace.getFactories(),i=[],a=(e,t)=>{for(let o of e){let e=t?`${t}.${o.name}`:o.name;i.push(O(e,o.path,n.config,r)),o.children&&a(o.children,e)}};return a(e,t??``),Object.freeze(i)}function M(e,t){let n=[],r=[];for(let[r,i]of e)t.has(r)||n.push(i);for(let[n,i]of t)e.has(n)||r.push(i);return{removed:Object.freeze(n),added:Object.freeze(r)}}function N(e){let t={};return e.forwardTo!==void 0&&(t.forwardTo=e.forwardTo),e.defaultParams!==void 0&&(t.defaultParams=e.defaultParams),e.encodeParams!==void 0&&(t.encodeParams=e.encodeParams),e.decodeParams!==void 0&&(t.decodeParams=e.decodeParams),Object.freeze(t)}function P(e,t,n){o(e,t,n);let r=s(e,t,n);e.lifecycleNamespace.preflightHandlerLimit(r.pendingCanActivate.keys(),r.pendingCanDeactivate.keys(),!1),u(e,r)}function F(e,n,r,i,a){d(n,`addRoute`),t(n,``,`addRoute`),c(n,``,`addRoute`);let o=f(n,e.rootPath,e.matcherOptions);if(e.lifecycleNamespace.preflightHandlerLimit(o.pendingCanActivate.keys(),o.pendingCanDeactivate.keys(),!0),e.lifecycleNamespace.clearDefinitionGuards(),u(e,o),a?.(),i!==void 0){let e=r.matchPath(i.path,r.getOptions());if(e){let t={...e,transition:i.transition};r.setState(t),r.emitTransitionSuccess(t,i,w)}else r.navigateToNotFound(i.path)}}function I(t,n){return e(t.definitions,n)?(T(n,t.config,t.routeCustomFields,t.lifecycleNamespace),i(t),!0):!1}function L(e,t){let n=e.matcher.getSegmentsByName(t);if(!n)return;let r=m(n.at(-1)),i=e.lifecycleNamespace.getFactories();return D(r,t,e.config,i)}const R=new WeakMap;function z(e){let t=R.get(e);if(t)return t;let i=h(e),a=i.routeGetStore(),o=e=>{i.treeChanged.emit(e)},s={add:(e,t)=>{_(i.isDisposed),g(i.treeChanged.isEmitting);let n=Array.isArray(e)?e:[e],r=t?.parent;if(p(n,i.validator),r!==void 0&&i.validator?.routes.validateParentOption(r,a.tree),i.validator?.routes.throwIfInternalRouteInArray(n,`addRoute`),i.validator?.routes.validateAddRouteArgs(n),i.validator?.routes.validateRoutes(n,a),P(a,n,r),i.treeChanged.listenerCount()>0){let e=j(n,r,a);o(r===void 0?{op:`add`,added:e}:{op:`add`,added:e,parent:r})}},remove:e=>{if(_(i.isDisposed),g(i.treeChanged.isEmitting),i.validator?.routes.validateRemoveRouteArgs(e),i.validator?.routes.throwIfInternalRoute(e,`removeRoute`),n(e,`removeRoute`),!S(e,i.getStateName(),i.isTransitioning()))return;let t=i.treeChanged.listenerCount()>0?A(a,e):void 0;if(!I(a,e)){x.warn(`router.removeRoute`,`Route "${e}" not found. No changes made.`);return}t!==void 0&&o({op:`remove`,name:e,removedSubtree:t})},update:(e,t)=>{_(i.isDisposed),g(i.treeChanged.isEmitting),i.validator?.routes.validateUpdateRouteBasicArgs(e,t),i.validator?.routes.throwIfInternalRoute(e,`updateRoute`),n(e,`updateRoute`),i.validator?.routes.validateUpdateRoutePropertyTypes(e,t),i.isTransitioning()&&x.error(`router.updateRoute`,`Updating route "${e}" while navigation is in progress. This may cause unexpected behavior.`),i.validator?.routes.validateUpdateRoute(e,t,a);let s=a.lifecycleNamespace,c=r(a,s,e,t);if(i.treeChanged.listenerCount()>0){let t=N(c);Object.keys(t).length>0&&o({op:`update`,name:e,patch:t})}},clear:()=>{if(_(i.isDisposed),g(i.treeChanged.isEmitting),!C(i.isTransitioning()))return;let e=i.treeChanged.listenerCount()>0?Object.freeze([...k(a,()=>!0).values()]):void 0;l(a),a.lifecycleNamespace.clearAll(),i.clearState(),e!==void 0&&o({op:`clear`,removed:e})},has:e=>(i.validator?.routes.validateRouteName(e,`hasRoute`),a.matcher.hasRoute(e)),get:e=>(i.validator?.routes.validateRouteName(e,`getRoute`),L(a,e)),replace:t=>{_(i.isDisposed),g(i.treeChanged.isEmitting);let n=Array.isArray(t)?t:[t];if(!C(i.isTransitioning()))return;p(n,i.validator),i.validator?.routes.throwIfInternalRouteInArray(n,`replaceRoutes`),i.validator?.routes.validateAddRouteArgs(n),i.validator?.routes.validateRoutes(n,a);let r=e.getState(),s=i.treeChanged.listenerCount()>0?k(a,()=>!0):void 0;F(a,n,i,r,s===void 0?void 0:()=>{let{removed:e,added:t}=M(s,k(a,()=>!0));o({op:`replace`,removed:e,added:t})})},subscribeChanges:e=>i.treeChanged.subscribe(e)};return R.set(e,s),s}function B(e,t,n,r){if(n!==void 0){if(!Object.hasOwn(e.dependencies,t))r?.dependencies.validateDependencyCount(e,`setDependency`);else{let i=e.dependencies[t];i!==n&&!(Number.isNaN(i)&&Number.isNaN(n))&&r?.dependencies.warnOverwrite(t,`setDependency`)}e.dependencies[t]=n}}function V(e,t,n){let r=[];for(let i in t)t[i]!==void 0&&(Object.hasOwn(e.dependencies,i)?r.push(i):n?.dependencies.validateDependencyCount(e,`setDependencies`),e.dependencies[i]=t[i]);r.length>0&&n?.dependencies.warnBatchOverwrite(r,`setDependencies`)}function H(e){let t=h(e);return{get:e=>{t.validator?.dependencies.validateDependencyName(e,`getDependency`);let n=t.dependenciesGetStore(),r=n.dependencies[e];return t.validator?.dependencies.validateDependencyExists(e,n),r},getAll:()=>({...t.dependenciesGetStore().dependencies}),set:(e,n)=>{_(t.isDisposed),t.validator?.dependencies.validateSetDependencyArgs(e,n,`setDependency`),B(t.dependenciesGetStore(),e,n,t.validator)},setAll:e=>{_(t.isDisposed);let n=t.dependenciesGetStore();t.validator?.dependencies.validateDependenciesObject(e,`setDependencies`),t.validator?.dependencies.validateDependencyLimit(n,n.limits),V(n,e,t.validator)},remove:e=>{_(t.isDisposed),t.validator?.dependencies.validateDependencyName(e,`removeDependency`);let n=t.dependenciesGetStore();Object.hasOwn(n.dependencies,e)||t.validator?.dependencies.warnRemoveNonExistent(e),delete n.dependencies[e]},reset:()=>{_(t.isDisposed);let e=t.dependenciesGetStore();e.dependencies=Object.create(null)},has:e=>(t.validator?.dependencies.validateDependencyName(e,`hasDependency`),Object.hasOwn(t.dependenciesGetStore().dependencies,e))}}export{b as cloneRouter,H as getDependenciesApi,v as getLifecycleApi,y as getPluginApi,z as getRoutesApi};
 //# sourceMappingURL=api.mjs.map

package/dist/esm/api.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"api.mjs","names":["nodeToDefinition"],"sources":["../../src/namespaces/RoutesNamespace/routeGuards.ts","../../src/api/getRoutesApi.ts","../../src/api/getDependenciesApi.ts"],"sourcesContent":["import { logger } from \"@real-router/logger\";\n\n/**\n * Validates removeRoute constraints.\n * Returns false if removal should be blocked (route is active).\n * Logs warnings for edge cases.\n *\n * @param name - Route name to remove\n * @param currentStateName - Current active route name (or undefined)\n * @param isNavigating - Whether navigation is in progress\n * @returns true if removal can proceed, false if blocked\n */\nexport function validateRemoveRoute(\n  name: string,\n  currentStateName: string | undefined,\n  isNavigating: boolean,\n): boolean {\n  if (currentStateName) {\n    const isExactMatch = currentStateName === name;\n    const isParentOfCurrent = currentStateName.startsWith(`${name}.`);\n\n    if (isExactMatch || isParentOfCurrent) {\n      const suffix = isExactMatch ? \"\" : ` (current: \"${currentStateName}\")`;\n\n      logger.warn(\n        \"router.removeRoute\",\n        `Cannot remove route \"${name}\" — it is currently active${suffix}. Navigate away first.`,\n      );\n\n      return false;\n    }\n  }\n\n  if (isNavigating) {\n    logger.warn(\n      \"router.removeRoute\",\n      `Route \"${name}\" removed while navigation is in progress. This may cause unexpected behavior.`,\n    );\n  }\n\n  return true;\n}\n\n/**\n * Validates clearRoutes operation.\n * Returns false if operation should be blocked (navigation in progress).\n *\n * @param isNavigating - Whether navigation is in progress\n * @returns true if clearRoutes can proceed, false if blocked\n */\nexport function validateClearRoutes(isNavigating: boolean): boolean {\n  if (isNavigating) {\n    logger.error(\n      \"router.clearRoutes\",\n      \"Cannot clear routes while navigation is in progress. Wait for navigation to complete.\",\n    );\n\n    return false;\n  }\n\n  return true;\n}\n","import { logger } from \"@real-router/logger\";\nimport { nodeToDefinition } from \"route-tree\";\n\nimport { throwIfDisposed, throwIfReentrantTreeMutation } from \"./helpers\";\nimport { guardRouteStructure } from \"../guards\";\nimport { getInternals } from \"../internals\";\nimport {\n  clearConfigEntries,\n  removeFromDefinitions,\n} from \"../namespaces/RoutesNamespace/helpers\";\nimport {\n  validateClearRoutes,\n  validateRemoveRoute,\n} from \"../namespaces/RoutesNamespace/routeGuards\";\nimport {\n  adoptRouteArtifacts,\n  assertAddable,\n  assertNoDuplicateNamesInBatch,\n  assertNoDuplicatePathsInBatch,\n  assertNoInternalNamesInBatch,\n  assertNoInternalRouteName,\n  buildAddArtifacts,\n  buildReplaceArtifacts,\n  commitRouteUpdate,\n  commitTreeChanges,\n  resetStore,\n} from \"../namespaces/RoutesNamespace/routesStore\";\n\nimport type { RoutesApi } from \"./types\";\nimport type { RouterInternals } from \"../internals\";\nimport type { RouteLifecycleNamespace, RouteConfig } from \"../namespaces\";\nimport type { RoutesStore } from \"../namespaces/RoutesNamespace\";\nimport type { GuardFnFactory, Route } from \"../types\";\nimport type {\n  DefaultDependencies,\n  ForwardToCallback,\n  NavigationOptions,\n  Params,\n  Router,\n  State,\n  TreeChangedEvent,\n  TreeStructuralPatch,\n} from \"@real-router/types\";\nimport type { RouteDefinition, RouteTree } from \"route-tree\";\n\n// ============================================================================\n// Helpers\n// ============================================================================\n\n/**\n * Opts attached to the `TRANSITION_SUCCESS` emitted by `replace()` when it\n * revalidates the active state (#950). `replace` does not push history, so it\n * is a replace-type success — matching `navigateToNotFound`'s opts for the\n * dropped-route branch.\n */\nconst REVALIDATE_OPTS: NavigationOptions = Object.freeze({ replace: true });\n\n/**\n * Clears all config entries and lifecycle handlers for a removed route\n * (and all its descendants).\n */\nfunction clearRouteConfigurations<\n  Dependencies extends DefaultDependencies = DefaultDependencies,\n>(\n  routeName: string,\n  config: RouteConfig,\n  routeCustomFields: Record<string, Record<string, unknown>>,\n  lifecycleNamespace: RouteLifecycleNamespace<Dependencies>,\n): void {\n  const shouldClear = (name: string): boolean =>\n    name === routeName || name.startsWith(`${routeName}.`);\n\n  clearConfigEntries(config.decoders, shouldClear);\n  clearConfigEntries(config.encoders, shouldClear);\n  clearConfigEntries(config.defaultParams, shouldClear);\n  clearConfigEntries(config.forwardMap, shouldClear);\n  clearConfigEntries(config.forwardFnMap, shouldClear);\n  clearConfigEntries(routeCustomFields, shouldClear);\n\n  // Clear forwardMap entries pointing TO the deleted route (or its descendants)\n  clearConfigEntries(config.forwardMap, (key) =>\n    shouldClear(config.forwardMap[key]),\n  );\n\n  // Clear lifecycle handlers\n  const [canDeactivateFactories, canActivateFactories] =\n    lifecycleNamespace.getFactories();\n\n  for (const name of Object.keys(canActivateFactories)) {\n    if (shouldClear(name)) {\n      lifecycleNamespace.clearCanActivate(name);\n    }\n  }\n\n  for (const name of Object.keys(canDeactivateFactories)) {\n    if (shouldClear(name)) {\n      lifecycleNamespace.clearCanDeactivate(name);\n    }\n  }\n}\n\n/**\n * Re-attaches the stored config (forwardTo / defaultParams / encode-decode) and\n * lifecycle guards for `lookupName` onto `route`, then returns it (mutates in\n * place). Shared by {@link enrichRoute} (nested, bare `name`) and\n * {@link buildFlatRoute} (flat, full dotted `name`) — one source of truth for\n * the route-config field set.\n */\nfunction assignRouteConfig<\n  Dependencies extends DefaultDependencies = DefaultDependencies,\n>(\n  route: Route<Dependencies>,\n  lookupName: string,\n  config: RouteConfig,\n  factories: [\n    Record<string, GuardFnFactory<Dependencies>>,\n    Record<string, GuardFnFactory<Dependencies>>,\n  ],\n): Route<Dependencies> {\n  const forwardToFn = config.forwardFnMap[lookupName];\n  const forwardToStr = config.forwardMap[lookupName];\n\n  // eslint-disable-next-line @typescript-eslint/no-unnecessary-condition\n  if (forwardToFn !== undefined) {\n    route.forwardTo = forwardToFn;\n    // eslint-disable-next-line @typescript-eslint/no-unnecessary-condition\n  } else if (forwardToStr !== undefined) {\n    route.forwardTo = forwardToStr;\n  }\n\n  if (lookupName in config.defaultParams) {\n    route.defaultParams = config.defaultParams[lookupName];\n  }\n\n  if (lookupName in config.decoders) {\n    route.decodeParams = config.decoders[lookupName];\n  }\n\n  if (lookupName in config.encoders) {\n    route.encodeParams = config.encoders[lookupName];\n  }\n\n  const [canDeactivateFactories, canActivateFactories] = factories;\n\n  if (lookupName in canActivateFactories) {\n    route.canActivate = canActivateFactories[lookupName];\n  }\n\n  if (lookupName in canDeactivateFactories) {\n    route.canDeactivate = canDeactivateFactories[lookupName];\n  }\n\n  return route;\n}\n\n/**\n * Builds a full Route object from a bare RouteDefinition by re-attaching\n * config entries and lifecycle factories.\n *\n * RECURSIVE — call with the factories tuple obtained ONCE from\n * `lifecycleNamespace.getFactories()` and pass it through to children.\n */\nfunction enrichRoute<\n  Dependencies extends DefaultDependencies = DefaultDependencies,\n>(\n  routeDef: RouteDefinition,\n  routeName: string,\n  config: RouteConfig,\n  factories: [\n    Record<string, GuardFnFactory<Dependencies>>,\n    Record<string, GuardFnFactory<Dependencies>>,\n  ],\n): Route<Dependencies> {\n  const route: Route<Dependencies> = {\n    name: routeDef.name,\n    path: routeDef.path,\n  };\n\n  assignRouteConfig(route, routeName, config, factories);\n\n  if (routeDef.children) {\n    route.children = routeDef.children.map((child) =>\n      enrichRoute(child, `${routeName}.${child.name}`, config, factories),\n    );\n  }\n\n  return route;\n}\n\n// ============================================================================\n// TREE_CHANGED payload helpers\n// ============================================================================\n\n/**\n * Builds a single FLAT `Route` for `fullName` from the store config + lifecycle\n * factories — `name` is the FULL dotted name and there is no `children` array\n * (consumers want a flat, by-name list). Frozen on construction.\n */\nfunction buildFlatRoute<\n  Dependencies extends DefaultDependencies = DefaultDependencies,\n>(\n  fullName: string,\n  path: string,\n  config: RouteConfig,\n  factories: [\n    Record<string, GuardFnFactory<Dependencies>>,\n    Record<string, GuardFnFactory<Dependencies>>,\n  ],\n): Route<Dependencies> {\n  const route: Route<Dependencies> = { name: fullName, path };\n\n  assignRouteConfig(route, fullName, config, factories);\n\n  return Object.freeze(route);\n}\n\n/**\n * Walks the store's definitions depth-first, building a FLAT\n * `Map<fullName, Route>` for every node whose full dotted name satisfies\n * `include`. Reads the live store, so call it at the right moment relative to\n * the mutation (before for removed, after for added).\n */\nfunction collectFlatRoutes<\n  Dependencies extends DefaultDependencies = DefaultDependencies,\n>(\n  store: RoutesStore<Dependencies>,\n  include: (fullName: string) => boolean,\n): Map<string, Route<Dependencies>> {\n  const result = new Map<string, Route<Dependencies>>();\n  // eslint-disable-next-line @typescript-eslint/no-non-null-assertion -- guaranteed set after wiring\n  const factories = store.lifecycleNamespace!.getFactories();\n\n  const walk = (defs: readonly RouteDefinition[], parentName: string): void => {\n    for (const def of defs) {\n      const fullName = parentName ? `${parentName}.${def.name}` : def.name;\n\n      if (include(fullName)) {\n        result.set(\n          fullName,\n          buildFlatRoute(fullName, def.path, store.config, factories),\n        );\n      }\n\n      if (def.children) {\n        walk(def.children, fullName);\n      }\n    }\n  };\n\n  walk(store.definitions, \"\");\n\n  return result;\n}\n\n/**\n * Collects the route `name` and all of its descendants as a FLAT, frozen array.\n * MUST be called BEFORE the removal mutation — the nodes are gone afterwards.\n */\nfunction collectSubtree<\n  Dependencies extends DefaultDependencies = DefaultDependencies,\n>(\n  store: RoutesStore<Dependencies>,\n  name: string,\n): readonly Route<Dependencies>[] {\n  const prefix = `${name}.`;\n  const subtree = collectFlatRoutes(\n    store,\n    (fullName) => fullName === name || fullName.startsWith(prefix),\n  );\n\n  return Object.freeze([...subtree.values()]);\n}\n\n/**\n * Builds the FLAT, frozen payload array for an `add`, walking only the input\n * routes — O(added), not O(tree). `path` is taken from the input verbatim\n * (`sanitizeRoute` never rewrites it); config fields are read from the\n * post-commit store by full name. `add` never removes, so the input subtree is\n * exactly what changed.\n */\nfunction collectAddedRoutes<\n  Dependencies extends DefaultDependencies = DefaultDependencies,\n>(\n  routes: readonly Route<Dependencies>[],\n  parentName: string | undefined,\n  store: RoutesStore<Dependencies>,\n): readonly Route<Dependencies>[] {\n  // eslint-disable-next-line @typescript-eslint/no-non-null-assertion -- guaranteed set after wiring\n  const factories = store.lifecycleNamespace!.getFactories();\n  const result: Route<Dependencies>[] = [];\n\n  const walk = (\n    input: readonly Route<Dependencies>[],\n    parent: string,\n  ): void => {\n    for (const route of input) {\n      const fullName = parent ? `${parent}.${route.name}` : route.name;\n\n      result.push(\n        buildFlatRoute(fullName, route.path, store.config, factories),\n      );\n\n      if (route.children) {\n        walk(route.children, fullName);\n      }\n    }\n  };\n\n  walk(routes, parentName ?? \"\");\n\n  return Object.freeze(result);\n}\n\n/** Diffs two flat route maps by full name into frozen removed/added arrays. */\nfunction diffFlatRoutes<\n  Dependencies extends DefaultDependencies = DefaultDependencies,\n>(\n  before: ReadonlyMap<string, Route<Dependencies>>,\n  after: ReadonlyMap<string, Route<Dependencies>>,\n): {\n  removed: readonly Route<Dependencies>[];\n  added: readonly Route<Dependencies>[];\n} {\n  const removed: Route<Dependencies>[] = [];\n  const added: Route<Dependencies>[] = [];\n\n  for (const [fullName, route] of before) {\n    if (!after.has(fullName)) {\n      removed.push(route);\n    }\n  }\n\n  for (const [fullName, route] of after) {\n    if (!before.has(fullName)) {\n      added.push(route);\n    }\n  }\n\n  return { removed: Object.freeze(removed), added: Object.freeze(added) };\n}\n\n/**\n * Builds the structural subset of an `update()` patch (forwardTo /\n * defaultParams / encodeParams / decodeParams) from the already-destructured\n * update fields — so user getters are not re-invoked. A guard-only patch yields\n * an empty object → the caller emits no TREE_CHANGED (О-7: guards are\n * invoked-on-demand, not cached, so they need no observation channel).\n *\n * The returned envelope is a fresh object (caller's patch untouched) and is\n * frozen on construction. Nested values (e.g. `defaultParams`) are kept by\n * reference — the same objects the router stored — so exotic inputs (circular\n * refs, class instances) are tolerated, matching `update()`'s existing contract.\n */\nfunction buildStructuralPatch<\n  Dependencies extends DefaultDependencies = DefaultDependencies,\n>(fields: {\n  forwardTo?: string | ForwardToCallback<Dependencies> | null | undefined;\n  defaultParams?: Params | null | undefined;\n  decodeParams?: ((params: Params) => Params) | null | undefined;\n  encodeParams?: ((params: Params) => Params) | null | undefined;\n}): Readonly<TreeStructuralPatch<Dependencies>> {\n  const patch: TreeStructuralPatch<Dependencies> = {};\n\n  if (fields.forwardTo !== undefined) {\n    patch.forwardTo = fields.forwardTo;\n  }\n\n  if (fields.defaultParams !== undefined) {\n    patch.defaultParams = fields.defaultParams;\n  }\n\n  if (fields.encodeParams !== undefined) {\n    patch.encodeParams = fields.encodeParams;\n  }\n\n  if (fields.decodeParams !== undefined) {\n    patch.decodeParams = fields.decodeParams;\n  }\n\n  return Object.freeze(patch);\n}\n\n// ============================================================================\n// CRUD operations\n// ============================================================================\n\n/**\n * Adds one or more routes to the router.\n * Input already validated by facade.\n */\nfunction addRoutes<\n  Dependencies extends DefaultDependencies = DefaultDependencies,\n>(\n  store: RoutesStore<Dependencies>,\n  routes: Route<Dependencies>[],\n  parentName?: string,\n): void {\n  // Prepare-then-commit (issue #698): reject the silent-corruption cases\n  // up front (dup name vs existing, missing parent), build the merged tree /\n  // config into locals (async/circular forwardTo + invalid constraint throw\n  // here), then swap atomically. A rejected add leaves the store untouched.\n  assertAddable(store, routes, parentName);\n\n  const artifacts = buildAddArtifacts(store, routes, parentName);\n\n  // Pre-flight the #961 handler-limit into PREPARE so a limit-exceeding batch\n  // aborts before the swap (#1046). `add` does not clear guards, so the\n  // projection runs against the live union count (clearsDefinition = false).\n  // eslint-disable-next-line @typescript-eslint/no-non-null-assertion -- guaranteed set after wiring\n  store.lifecycleNamespace!.preflightHandlerLimit(\n    artifacts.pendingCanActivate.keys(),\n    artifacts.pendingCanDeactivate.keys(),\n    false,\n  );\n\n  adoptRouteArtifacts(store, artifacts);\n}\n\n/**\n * Atomically replaces all routes with a new set (HMR / code-splitting).\n * Prepare-then-commit (issue #698): the new set is fully built into locals\n * first — a circular/async forwardTo or invalid path throws here, leaving the\n * existing tree intact — then committed.\n */\nfunction replaceRoutes<\n  Dependencies extends DefaultDependencies = DefaultDependencies,\n>(\n  store: RoutesStore<Dependencies>,\n  routes: Route<Dependencies>[],\n  ctx: RouterInternals<Dependencies>,\n  currentState: State | undefined,\n  onCommitted?: () => void,\n): void {\n  // Reject the silent-corruption cases `assertAddable` catches for `add`, BEFORE\n  // building/swapping, so bare-core parity is symmetric (#1047): within-batch\n  // duplicate names (#968), reserved \"@@\" names (#954), and within-batch\n  // duplicate paths (#955). methodName is \"addRoute\" to match validation-plugin\n  // (which reports \"addRoute\" for replace batches too), so the no-plugin error\n  // is identical to the with-plugin one.\n  assertNoInternalNamesInBatch(routes, \"addRoute\");\n  assertNoDuplicateNamesInBatch(routes, \"\", \"addRoute\");\n  assertNoDuplicatePathsInBatch(routes, \"\", \"addRoute\");\n\n  // Build the whole new set BEFORE touching the store.\n  const artifacts = buildReplaceArtifacts(\n    routes,\n    store.rootPath,\n    store.matcherOptions,\n  );\n\n  // Pre-flight the #961 handler-limit BEFORE clearDefinitionGuards mutates, so a\n  // limit-exceeding batch aborts with BOTH the tree and the definition guards\n  // intact (#1046). replace clears definition guards first, so the projection\n  // runs against the surviving external guards (clearsDefinition = true).\n  // eslint-disable-next-line @typescript-eslint/no-non-null-assertion -- guaranteed set after wiring\n  store.lifecycleNamespace!.preflightHandlerLimit(\n    artifacts.pendingCanActivate.keys(),\n    artifacts.pendingCanDeactivate.keys(),\n    true,\n  );\n\n  // Clear definition lifecycle handlers (preserve external guards), then swap.\n  // eslint-disable-next-line @typescript-eslint/no-non-null-assertion -- guaranteed set after wiring\n  store.lifecycleNamespace!.clearDefinitionGuards();\n  adoptRouteArtifacts(store, artifacts);\n\n  // TREE_CHANGED fires here (О-5): the new tree is committed but state is not\n  // yet revalidated, so the handler sees the new tree and the still-old state.\n  onCommitted?.();\n\n  // Revalidate the active state against the new tree AND notify subscribers\n  // (#950). A structural replace can change or drop the currently-active state;\n  // emitting TRANSITION_SUCCESS makes router.subscribe / useSyncExternalStore\n  // adapters re-render instead of rendering the pre-replace state. (This is the\n  // one structural mutation that emits a transition event — clear() stays a\n  // silent reset; the asymmetry is deliberate, see #950.)\n  if (currentState !== undefined) {\n    const revalidated = ctx.matchPath(currentState.path, ctx.getOptions());\n\n    if (revalidated) {\n      // Path still matches — commit the revalidated state (preserving the prior\n      // transition meta) and emit so subscribers see it.\n      const nextState: State = {\n        ...revalidated,\n        transition: currentState.transition,\n      };\n\n      ctx.setState(nextState);\n      ctx.emitTransitionSuccess(nextState, currentState, REVALIDATE_OPTS);\n    } else {\n      // The active route no longer exists in the new tree — surface it as\n      // not-found (commits UNKNOWN_ROUTE + emits TRANSITION_SUCCESS) so the\n      // change is observable, rather than silently clearing the state.\n      ctx.navigateToNotFound(currentState.path);\n    }\n  }\n}\n\n/**\n * Removes a route and all its children.\n *\n * @returns true if removed, false if not found\n */\nfunction removeRoute<\n  Dependencies extends DefaultDependencies = DefaultDependencies,\n>(store: RoutesStore<Dependencies>, name: string): boolean {\n  const wasRemoved = removeFromDefinitions(store.definitions, name);\n\n  if (!wasRemoved) {\n    return false;\n  }\n\n  clearRouteConfigurations(\n    name,\n    store.config,\n    store.routeCustomFields,\n    // eslint-disable-next-line @typescript-eslint/no-non-null-assertion\n    store.lifecycleNamespace!,\n  );\n\n  commitTreeChanges(store);\n\n  return true;\n}\n\n/**\n * Gets a route by name with all its configuration.\n */\nfunction getRoute<\n  Dependencies extends DefaultDependencies = DefaultDependencies,\n>(\n  store: RoutesStore<Dependencies>,\n  name: string,\n): Route<Dependencies> | undefined {\n  const segments = store.matcher.getSegmentsByName(name);\n\n  if (!segments) {\n    return undefined;\n  }\n\n  // eslint-disable-next-line @typescript-eslint/no-non-null-assertion -- segments is non-empty (checked above)\n  const targetNode = segments.at(-1)! as RouteTree;\n  const definition = nodeToDefinition(targetNode);\n  // eslint-disable-next-line @typescript-eslint/no-non-null-assertion\n  const factories = store.lifecycleNamespace!.getFactories();\n\n  return enrichRoute(definition, name, store.config, factories);\n}\n\n// ============================================================================\n// API factory\n// ============================================================================\n\n// Cache the assembled RoutesApi per router — mirrors getPluginApi()/getNavigator():\n// avoids re-allocating the 9-closure bag on each call (adapters/plugins poll it\n// from constructors) and gives spy/stub helpers a stable object identity. Closures\n// capture `ctx`/`store`, both stable for the router's lifetime, so caching is safe.\n// Single cast site: the value is stored as `unknown` (RoutesApi is invariant in\n// Dependencies, so one typed map can't hold every instantiation) and cast on read.\nconst cache = new WeakMap<object, unknown>();\n\nexport function getRoutesApi<\n  Dependencies extends DefaultDependencies = DefaultDependencies,\n>(router: Router<Dependencies>): RoutesApi<Dependencies> {\n  const cached = cache.get(router);\n\n  if (cached) {\n    return cached as RoutesApi<Dependencies>;\n  }\n\n  const ctx = getInternals(router);\n\n  const store = ctx.routeGetStore();\n\n  // Single cast site: the channel is typed with default Dependencies on\n  // RouterInternals (RouterEventMap is non-generic), but payloads are built\n  // with this api's Dependencies. The runtime shape is identical.\n  const emitChange = (event: TreeChangedEvent<Dependencies>): void => {\n    ctx.treeChanged.emit(event as TreeChangedEvent);\n  };\n\n  const api: RoutesApi<Dependencies> = {\n    add: (routes, options) => {\n      throwIfDisposed(ctx.isDisposed);\n      throwIfReentrantTreeMutation(ctx.treeChanged.isEmitting);\n\n      const routeArray = Array.isArray(routes) ? routes : [routes];\n      const parentName = options?.parent;\n\n      guardRouteStructure(routeArray, ctx.validator);\n\n      if (parentName !== undefined) {\n        ctx.validator?.routes.validateParentOption(parentName, store.tree);\n      }\n\n      ctx.validator?.routes.throwIfInternalRouteInArray(routeArray, \"addRoute\");\n      ctx.validator?.routes.validateAddRouteArgs(routeArray);\n      ctx.validator?.routes.validateRoutes(routeArray, store);\n\n      addRoutes(store, routeArray, parentName);\n\n      // Built from the post-commit store (О-1), only when someone is listening.\n      if (ctx.treeChanged.listenerCount() > 0) {\n        const added = collectAddedRoutes(routeArray, parentName, store);\n\n        emitChange(\n          parentName === undefined\n            ? { op: \"add\", added }\n            : { op: \"add\", added, parent: parentName },\n        );\n      }\n    },\n\n    remove: (name) => {\n      throwIfDisposed(ctx.isDisposed);\n      throwIfReentrantTreeMutation(ctx.treeChanged.isEmitting);\n\n      ctx.validator?.routes.validateRemoveRouteArgs(name);\n      ctx.validator?.routes.throwIfInternalRoute(name, \"removeRoute\");\n      // Always-on parity backstop (#1047 / #238): a reserved \"@@\" name is\n      // internal and cannot be removed, with or without the validation-plugin.\n      assertNoInternalRouteName(name, \"removeRoute\");\n\n      const canRemove = validateRemoveRoute(\n        name,\n        ctx.getStateName(),\n        ctx.isTransitioning(),\n      );\n\n      if (!canRemove) {\n        return;\n      }\n\n      // Snapshot the subtree BEFORE the mutation — the nodes are gone after.\n      const removedSubtree =\n        ctx.treeChanged.listenerCount() > 0\n          ? collectSubtree(store, name)\n          : undefined;\n      const wasRemoved = removeRoute(store, name);\n\n      if (!wasRemoved) {\n        logger.warn(\n          \"router.removeRoute\",\n          `Route \"${name}\" not found. No changes made.`,\n        );\n\n        return;\n      }\n\n      if (removedSubtree !== undefined) {\n        emitChange({ op: \"remove\", name, removedSubtree });\n      }\n    },\n\n    update: (name, updates) => {\n      throwIfDisposed(ctx.isDisposed);\n      throwIfReentrantTreeMutation(ctx.treeChanged.isEmitting);\n\n      ctx.validator?.routes.validateUpdateRouteBasicArgs(name, updates);\n      ctx.validator?.routes.throwIfInternalRoute(name, \"updateRoute\");\n      // Always-on parity backstop (#1047 / #238): a reserved \"@@\" name is\n      // internal and cannot be updated, with or without the validation-plugin.\n      assertNoInternalRouteName(name, \"updateRoute\");\n\n      ctx.validator?.routes.validateUpdateRoutePropertyTypes(name, updates);\n\n      /* v8 ignore next 6 -- @preserve: race condition guard, mirrors Router.updateRoute() same-path guard tested via Router.ts unit tests */\n      if (ctx.isTransitioning()) {\n        logger.error(\n          \"router.updateRoute\",\n          `Updating route \"${name}\" while navigation is in progress. This may cause unexpected behavior.`,\n        );\n      }\n\n      ctx.validator?.routes.validateUpdateRoute(name, updates, store);\n\n      // Field-patch commit core (NO_TREE_REBUILD) — co-located in routesStore.ts\n      // beside the add/replace (adoptRouteArtifacts) / remove (commitTreeChanges)\n      // / clear (resetStore) cores. Returns the structural fields for the\n      // conditional emit below (each user getter read once inside).\n      // eslint-disable-next-line @typescript-eslint/no-non-null-assertion -- guaranteed set after wiring\n      const lifecycle = store.lifecycleNamespace!;\n      const structural = commitRouteUpdate(store, lifecycle, name, updates);\n\n      // Conditional emit: structural fields only. A guard-only or empty patch\n      // produces no event (О-7 + empty-patch rule).\n      if (ctx.treeChanged.listenerCount() > 0) {\n        const patch = buildStructuralPatch<Dependencies>(structural);\n\n        if (Object.keys(patch).length > 0) {\n          emitChange({ op: \"update\", name, patch });\n        }\n      }\n    },\n\n    clear: () => {\n      throwIfDisposed(ctx.isDisposed);\n      throwIfReentrantTreeMutation(ctx.treeChanged.isEmitting);\n\n      const canClear = validateClearRoutes(ctx.isTransitioning());\n\n      /* v8 ignore next 3 -- @preserve: race condition guard, mirrors Router.clearRoutes() same-path guard tested via validateClearRoutes unit tests */\n      if (!canClear) {\n        return;\n      }\n\n      // Snapshot the routes BEFORE the reset empties them. Emitted whenever\n      // there is a listener — even for an empty clear (О-4).\n      const removed =\n        ctx.treeChanged.listenerCount() > 0\n          ? Object.freeze([...collectFlatRoutes(store, () => true).values()])\n          : undefined;\n\n      resetStore(store);\n      // eslint-disable-next-line @typescript-eslint/no-non-null-assertion -- guaranteed set after wiring\n      store.lifecycleNamespace!.clearAll();\n      ctx.clearState();\n\n      if (removed !== undefined) {\n        emitChange({ op: \"clear\", removed });\n      }\n    },\n\n    has: (name) => {\n      ctx.validator?.routes.validateRouteName(name, \"hasRoute\");\n\n      return store.matcher.hasRoute(name);\n    },\n\n    get: (name) => {\n      ctx.validator?.routes.validateRouteName(name, \"getRoute\");\n\n      return getRoute(store, name);\n    },\n\n    replace: (routes) => {\n      throwIfDisposed(ctx.isDisposed);\n      throwIfReentrantTreeMutation(ctx.treeChanged.isEmitting);\n\n      const routeArray = Array.isArray(routes) ? routes : [routes];\n\n      const canReplace = validateClearRoutes(ctx.isTransitioning());\n\n      if (!canReplace) {\n        return;\n      }\n\n      guardRouteStructure(routeArray, ctx.validator);\n\n      ctx.validator?.routes.throwIfInternalRouteInArray(\n        routeArray,\n        \"replaceRoutes\",\n      );\n      ctx.validator?.routes.validateAddRouteArgs(routeArray);\n      ctx.validator?.routes.validateRoutes(routeArray, store);\n\n      const currentState = router.getState();\n\n      // The flat removed/added diff is O(N) — compute it only when someone is\n      // listening (Решение 3.B). Snapshot the old tree BEFORE the swap.\n      const before =\n        ctx.treeChanged.listenerCount() > 0\n          ? collectFlatRoutes(store, () => true)\n          : undefined;\n\n      replaceRoutes(\n        store,\n        routeArray,\n        ctx,\n        currentState,\n        before === undefined\n          ? undefined\n          : () => {\n              const after = collectFlatRoutes(store, () => true);\n              const { removed, added } = diffFlatRoutes(before, after);\n\n              emitChange({ op: \"replace\", removed, added });\n            },\n      );\n    },\n\n    subscribeChanges: (handler) => ctx.treeChanged.subscribe(handler),\n  };\n\n  cache.set(router, api);\n\n  return api;\n}\n","import { throwIfDisposed } from \"./helpers\";\nimport { getInternals } from \"../internals\";\n\nimport type { DependenciesApi } from \"./types\";\nimport type { DependenciesStore } from \"../namespaces\";\nimport type { RouterValidator } from \"../types/RouterValidator\";\nimport type { DefaultDependencies, Router } from \"@real-router/types\";\n\n// =============================================================================\n// Module-private CRUD functions\n// =============================================================================\n\nfunction setDependency(\n  store: DependenciesStore,\n  dependencyName: string,\n  dependencyValue: unknown,\n  validator?: RouterValidator | null,\n): void {\n  // undefined = \"don't set\" (feature for conditional setting)\n  if (dependencyValue === undefined) {\n    return;\n  }\n\n  const isNewKey = !Object.hasOwn(store.dependencies, dependencyName);\n\n  if (isNewKey) {\n    // Only check limit when adding new keys (overwrites don't increase count)\n    validator?.dependencies.validateDependencyCount(store, \"setDependency\");\n  } else {\n    const oldValue = (store.dependencies as Record<string, unknown>)[\n      dependencyName\n    ];\n    const isChanging = oldValue !== dependencyValue;\n    // Special case for NaN idempotency (NaN !== NaN is always true)\n    const bothAreNaN = Number.isNaN(oldValue) && Number.isNaN(dependencyValue);\n\n    if (isChanging && !bothAreNaN) {\n      validator?.dependencies.warnOverwrite(dependencyName, \"setDependency\");\n    }\n  }\n\n  (store.dependencies as Record<string, unknown>)[dependencyName] =\n    dependencyValue;\n}\n\nfunction setMultipleDependencies(\n  store: DependenciesStore,\n  deps: Record<string, unknown>,\n  validator?: RouterValidator | null,\n): void {\n  const overwrittenKeys: string[] = [];\n\n  for (const key in deps) {\n    if (deps[key] === undefined) {\n      continue;\n    }\n\n    if (Object.hasOwn(store.dependencies, key)) {\n      overwrittenKeys.push(key);\n    } else {\n      validator?.dependencies.validateDependencyCount(store, \"setDependencies\");\n    }\n\n    (store.dependencies as Record<string, unknown>)[key] = deps[key];\n  }\n\n  if (overwrittenKeys.length > 0) {\n    validator?.dependencies.warnBatchOverwrite(\n      overwrittenKeys,\n      \"setDependencies\",\n    );\n  }\n}\n\n// =============================================================================\n// Public API factory\n// =============================================================================\n\nexport function getDependenciesApi<\n  Dependencies extends DefaultDependencies = DefaultDependencies,\n>(router: Router<Dependencies>): DependenciesApi<Dependencies> {\n  const ctx = getInternals(router);\n\n  return {\n    get: (name) => {\n      ctx.validator?.dependencies.validateDependencyName(name, \"getDependency\");\n\n      const store = ctx.dependenciesGetStore();\n      const value = (store.dependencies as Record<string, unknown>)[\n        name as string\n      ];\n\n      ctx.validator?.dependencies.validateDependencyExists(\n        name as string,\n        store,\n      );\n\n      return value as Dependencies[typeof name];\n    },\n    getAll: () => ({ ...ctx.dependenciesGetStore().dependencies }),\n    set: (name, value) => {\n      throwIfDisposed(ctx.isDisposed);\n\n      ctx.validator?.dependencies.validateSetDependencyArgs(\n        name,\n        value,\n        \"setDependency\",\n      );\n\n      setDependency(ctx.dependenciesGetStore(), name, value, ctx.validator);\n    },\n    setAll: (deps) => {\n      throwIfDisposed(ctx.isDisposed);\n\n      const store = ctx.dependenciesGetStore();\n\n      ctx.validator?.dependencies.validateDependenciesObject(\n        deps,\n        \"setDependencies\",\n      );\n      ctx.validator?.dependencies.validateDependencyLimit(store, store.limits);\n\n      setMultipleDependencies(\n        store,\n        deps as Record<string, unknown>,\n        ctx.validator,\n      );\n    },\n    remove: (name) => {\n      throwIfDisposed(ctx.isDisposed);\n\n      ctx.validator?.dependencies.validateDependencyName(\n        name,\n        \"removeDependency\",\n      );\n\n      const store = ctx.dependenciesGetStore();\n\n      if (!Object.hasOwn(store.dependencies, name)) {\n        ctx.validator?.dependencies.warnRemoveNonExistent(name);\n      }\n\n      delete (store.dependencies as Record<string, unknown>)[name as string];\n    },\n    reset: () => {\n      throwIfDisposed(ctx.isDisposed);\n      const store = ctx.dependenciesGetStore();\n\n      store.dependencies = Object.create(null) as Partial<Dependencies>;\n    },\n    has: (name) => {\n      ctx.validator?.dependencies.validateDependencyName(name, \"hasDependency\");\n\n      return Object.hasOwn(ctx.dependenciesGetStore().dependencies, name);\n    },\n  };\n}\n"],"mappings":"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"}
+{"version":3,"file":"api.mjs","names":["nodeToDefinition"],"sources":["../../src/namespaces/RoutesNamespace/routeGuards.ts","../../src/api/getRoutesApi.ts","../../src/api/getDependenciesApi.ts"],"sourcesContent":["import { logger } from \"@real-router/logger\";\n\n/**\n * Validates removeRoute constraints.\n * Returns false if removal should be blocked (route is active).\n * Logs warnings for edge cases.\n *\n * @param name - Route name to remove\n * @param currentStateName - Current active route name (or undefined)\n * @param isNavigating - Whether navigation is in progress\n * @returns true if removal can proceed, false if blocked\n */\nexport function validateRemoveRoute(\n  name: string,\n  currentStateName: string | undefined,\n  isNavigating: boolean,\n): boolean {\n  if (currentStateName) {\n    const isExactMatch = currentStateName === name;\n    const isParentOfCurrent = currentStateName.startsWith(`${name}.`);\n\n    if (isExactMatch || isParentOfCurrent) {\n      const suffix = isExactMatch ? \"\" : ` (current: \"${currentStateName}\")`;\n\n      logger.warn(\n        \"router.removeRoute\",\n        `Cannot remove route \"${name}\" — it is currently active${suffix}. Navigate away first.`,\n      );\n\n      return false;\n    }\n  }\n\n  if (isNavigating) {\n    logger.warn(\n      \"router.removeRoute\",\n      `Route \"${name}\" removed while navigation is in progress. This may cause unexpected behavior.`,\n    );\n  }\n\n  return true;\n}\n\n/**\n * Validates clearRoutes operation.\n * Returns false if operation should be blocked (navigation in progress).\n *\n * @param isNavigating - Whether navigation is in progress\n * @returns true if clearRoutes can proceed, false if blocked\n */\nexport function validateClearRoutes(isNavigating: boolean): boolean {\n  if (isNavigating) {\n    logger.error(\n      \"router.clearRoutes\",\n      \"Cannot clear routes while navigation is in progress. Wait for navigation to complete.\",\n    );\n\n    return false;\n  }\n\n  return true;\n}\n","import { logger } from \"@real-router/logger\";\nimport { nodeToDefinition } from \"route-tree\";\n\nimport { throwIfDisposed, throwIfReentrantTreeMutation } from \"./helpers\";\nimport { guardRouteStructure } from \"../guards\";\nimport { getInternals } from \"../internals\";\nimport {\n  clearConfigEntries,\n  removeFromDefinitions,\n} from \"../namespaces/RoutesNamespace/helpers\";\nimport {\n  validateClearRoutes,\n  validateRemoveRoute,\n} from \"../namespaces/RoutesNamespace/routeGuards\";\nimport {\n  adoptRouteArtifacts,\n  assertAddable,\n  assertNoDuplicateNamesInBatch,\n  assertNoDuplicatePathsInBatch,\n  assertNoInternalNamesInBatch,\n  assertNoInternalRouteName,\n  buildAddArtifacts,\n  buildReplaceArtifacts,\n  commitRouteUpdate,\n  commitTreeChanges,\n  resetStore,\n} from \"../namespaces/RoutesNamespace/routesStore\";\n\nimport type { RoutesApi } from \"./types\";\nimport type { RouterInternals } from \"../internals\";\nimport type { RouteLifecycleNamespace, RouteConfig } from \"../namespaces\";\nimport type { RoutesStore } from \"../namespaces/RoutesNamespace\";\nimport type { GuardFnFactory, Route } from \"../types\";\nimport type {\n  DefaultDependencies,\n  ForwardToCallback,\n  NavigationOptions,\n  Params,\n  Router,\n  State,\n  TreeChangedEvent,\n  TreeStructuralPatch,\n} from \"@real-router/types\";\nimport type { RouteDefinition, RouteTree } from \"route-tree\";\n\n// ============================================================================\n// Helpers\n// ============================================================================\n\n/**\n * Opts attached to the `TRANSITION_SUCCESS` emitted by `replace()` when it\n * revalidates the active state (#950). `replace` does not push history, so it\n * is a replace-type success — matching `navigateToNotFound`'s opts for the\n * dropped-route branch.\n */\nconst REVALIDATE_OPTS: NavigationOptions = Object.freeze({ replace: true });\n\n/**\n * Clears all config entries and lifecycle handlers for a removed route\n * (and all its descendants).\n */\nfunction clearRouteConfigurations<\n  Dependencies extends DefaultDependencies = DefaultDependencies,\n>(\n  routeName: string,\n  config: RouteConfig,\n  routeCustomFields: Record<string, Record<string, unknown>>,\n  lifecycleNamespace: RouteLifecycleNamespace<Dependencies>,\n): void {\n  const shouldClear = (name: string): boolean =>\n    name === routeName || name.startsWith(`${routeName}.`);\n\n  clearConfigEntries(config.decoders, shouldClear);\n  clearConfigEntries(config.encoders, shouldClear);\n  clearConfigEntries(config.defaultParams, shouldClear);\n  clearConfigEntries(config.forwardMap, shouldClear);\n  clearConfigEntries(config.forwardFnMap, shouldClear);\n  clearConfigEntries(routeCustomFields, shouldClear);\n\n  // Clear forwardMap entries pointing TO the deleted route (or its descendants)\n  clearConfigEntries(config.forwardMap, (key) =>\n    shouldClear(config.forwardMap[key]),\n  );\n\n  // Clear lifecycle handlers\n  const [canDeactivateFactories, canActivateFactories] =\n    lifecycleNamespace.getFactories();\n\n  for (const name of Object.keys(canActivateFactories)) {\n    if (shouldClear(name)) {\n      lifecycleNamespace.clearCanActivate(name);\n    }\n  }\n\n  for (const name of Object.keys(canDeactivateFactories)) {\n    if (shouldClear(name)) {\n      lifecycleNamespace.clearCanDeactivate(name);\n    }\n  }\n}\n\n/**\n * Re-attaches the stored config (forwardTo / defaultParams / encode-decode) and\n * lifecycle guards for `lookupName` onto `route`, then returns it (mutates in\n * place). Shared by {@link enrichRoute} (nested, bare `name`) and\n * {@link buildFlatRoute} (flat, full dotted `name`) — one source of truth for\n * the route-config field set.\n */\nfunction assignRouteConfig<\n  Dependencies extends DefaultDependencies = DefaultDependencies,\n>(\n  route: Route<Dependencies>,\n  lookupName: string,\n  config: RouteConfig,\n  factories: [\n    Record<string, GuardFnFactory<Dependencies>>,\n    Record<string, GuardFnFactory<Dependencies>>,\n  ],\n): Route<Dependencies> {\n  const forwardToFn = config.forwardFnMap[lookupName];\n  const forwardToStr = config.forwardMap[lookupName];\n\n  // eslint-disable-next-line @typescript-eslint/no-unnecessary-condition\n  if (forwardToFn !== undefined) {\n    route.forwardTo = forwardToFn;\n    // eslint-disable-next-line @typescript-eslint/no-unnecessary-condition\n  } else if (forwardToStr !== undefined) {\n    route.forwardTo = forwardToStr;\n  }\n\n  if (lookupName in config.defaultParams) {\n    route.defaultParams = config.defaultParams[lookupName];\n  }\n\n  if (lookupName in config.decoders) {\n    route.decodeParams = config.decoders[lookupName];\n  }\n\n  if (lookupName in config.encoders) {\n    route.encodeParams = config.encoders[lookupName];\n  }\n\n  const [canDeactivateFactories, canActivateFactories] = factories;\n\n  if (lookupName in canActivateFactories) {\n    route.canActivate = canActivateFactories[lookupName];\n  }\n\n  if (lookupName in canDeactivateFactories) {\n    route.canDeactivate = canDeactivateFactories[lookupName];\n  }\n\n  return route;\n}\n\n/**\n * Builds a full Route object from a bare RouteDefinition by re-attaching\n * config entries and lifecycle factories.\n *\n * RECURSIVE — call with the factories tuple obtained ONCE from\n * `lifecycleNamespace.getFactories()` and pass it through to children.\n */\nfunction enrichRoute<\n  Dependencies extends DefaultDependencies = DefaultDependencies,\n>(\n  routeDef: RouteDefinition,\n  routeName: string,\n  config: RouteConfig,\n  factories: [\n    Record<string, GuardFnFactory<Dependencies>>,\n    Record<string, GuardFnFactory<Dependencies>>,\n  ],\n): Route<Dependencies> {\n  const route: Route<Dependencies> = {\n    name: routeDef.name,\n    path: routeDef.path,\n  };\n\n  assignRouteConfig(route, routeName, config, factories);\n\n  if (routeDef.children) {\n    route.children = routeDef.children.map((child) =>\n      enrichRoute(child, `${routeName}.${child.name}`, config, factories),\n    );\n  }\n\n  return route;\n}\n\n// ============================================================================\n// TREE_CHANGED payload helpers\n// ============================================================================\n\n/**\n * Builds a single FLAT `Route` for `fullName` from the store config + lifecycle\n * factories — `name` is the FULL dotted name and there is no `children` array\n * (consumers want a flat, by-name list). Frozen on construction.\n */\nfunction buildFlatRoute<\n  Dependencies extends DefaultDependencies = DefaultDependencies,\n>(\n  fullName: string,\n  path: string,\n  config: RouteConfig,\n  factories: [\n    Record<string, GuardFnFactory<Dependencies>>,\n    Record<string, GuardFnFactory<Dependencies>>,\n  ],\n): Route<Dependencies> {\n  const route: Route<Dependencies> = { name: fullName, path };\n\n  assignRouteConfig(route, fullName, config, factories);\n\n  return Object.freeze(route);\n}\n\n/**\n * Walks the store's definitions depth-first, building a FLAT\n * `Map<fullName, Route>` for every node whose full dotted name satisfies\n * `include`. Reads the live store, so call it at the right moment relative to\n * the mutation (before for removed, after for added).\n */\nfunction collectFlatRoutes<\n  Dependencies extends DefaultDependencies = DefaultDependencies,\n>(\n  store: RoutesStore<Dependencies>,\n  include: (fullName: string) => boolean,\n): Map<string, Route<Dependencies>> {\n  const result = new Map<string, Route<Dependencies>>();\n  // eslint-disable-next-line @typescript-eslint/no-non-null-assertion -- guaranteed set after wiring\n  const factories = store.lifecycleNamespace!.getFactories();\n\n  const walk = (defs: readonly RouteDefinition[], parentName: string): void => {\n    for (const def of defs) {\n      const fullName = parentName ? `${parentName}.${def.name}` : def.name;\n\n      if (include(fullName)) {\n        result.set(\n          fullName,\n          buildFlatRoute(fullName, def.path, store.config, factories),\n        );\n      }\n\n      if (def.children) {\n        walk(def.children, fullName);\n      }\n    }\n  };\n\n  walk(store.definitions, \"\");\n\n  return result;\n}\n\n/**\n * Collects the route `name` and all of its descendants as a FLAT, frozen array.\n * MUST be called BEFORE the removal mutation — the nodes are gone afterwards.\n */\nfunction collectSubtree<\n  Dependencies extends DefaultDependencies = DefaultDependencies,\n>(\n  store: RoutesStore<Dependencies>,\n  name: string,\n): readonly Route<Dependencies>[] {\n  const prefix = `${name}.`;\n  const subtree = collectFlatRoutes(\n    store,\n    (fullName) => fullName === name || fullName.startsWith(prefix),\n  );\n\n  return Object.freeze([...subtree.values()]);\n}\n\n/**\n * Builds the FLAT, frozen payload array for an `add`, walking only the input\n * routes — O(added), not O(tree). `path` is taken from the input verbatim\n * (`sanitizeRoute` never rewrites it); config fields are read from the\n * post-commit store by full name. `add` never removes, so the input subtree is\n * exactly what changed.\n */\nfunction collectAddedRoutes<\n  Dependencies extends DefaultDependencies = DefaultDependencies,\n>(\n  routes: readonly Route<Dependencies>[],\n  parentName: string | undefined,\n  store: RoutesStore<Dependencies>,\n): readonly Route<Dependencies>[] {\n  // eslint-disable-next-line @typescript-eslint/no-non-null-assertion -- guaranteed set after wiring\n  const factories = store.lifecycleNamespace!.getFactories();\n  const result: Route<Dependencies>[] = [];\n\n  const walk = (\n    input: readonly Route<Dependencies>[],\n    parent: string,\n  ): void => {\n    for (const route of input) {\n      const fullName = parent ? `${parent}.${route.name}` : route.name;\n\n      result.push(\n        buildFlatRoute(fullName, route.path, store.config, factories),\n      );\n\n      if (route.children) {\n        walk(route.children, fullName);\n      }\n    }\n  };\n\n  walk(routes, parentName ?? \"\");\n\n  return Object.freeze(result);\n}\n\n/** Diffs two flat route maps by full name into frozen removed/added arrays. */\nfunction diffFlatRoutes<\n  Dependencies extends DefaultDependencies = DefaultDependencies,\n>(\n  before: ReadonlyMap<string, Route<Dependencies>>,\n  after: ReadonlyMap<string, Route<Dependencies>>,\n): {\n  removed: readonly Route<Dependencies>[];\n  added: readonly Route<Dependencies>[];\n} {\n  const removed: Route<Dependencies>[] = [];\n  const added: Route<Dependencies>[] = [];\n\n  for (const [fullName, route] of before) {\n    if (!after.has(fullName)) {\n      removed.push(route);\n    }\n  }\n\n  for (const [fullName, route] of after) {\n    if (!before.has(fullName)) {\n      added.push(route);\n    }\n  }\n\n  return { removed: Object.freeze(removed), added: Object.freeze(added) };\n}\n\n/**\n * Builds the structural subset of an `update()` patch (forwardTo /\n * defaultParams / encodeParams / decodeParams) from the already-destructured\n * update fields — so user getters are not re-invoked. A guard-only patch yields\n * an empty object → the caller emits no TREE_CHANGED (О-7: guards are\n * invoked-on-demand, not cached, so they need no observation channel).\n *\n * The returned envelope is a fresh object (caller's patch untouched) and is\n * frozen on construction. Nested values (e.g. `defaultParams`) are kept by\n * reference — the same objects the router stored — so exotic inputs (circular\n * refs, class instances) are tolerated, matching `update()`'s existing contract.\n */\nfunction buildStructuralPatch<\n  Dependencies extends DefaultDependencies = DefaultDependencies,\n>(fields: {\n  forwardTo?: string | ForwardToCallback<Dependencies> | null | undefined;\n  defaultParams?: Params | null | undefined;\n  decodeParams?: ((params: Params) => Params) | null | undefined;\n  encodeParams?: ((params: Params) => Params) | null | undefined;\n}): Readonly<TreeStructuralPatch<Dependencies>> {\n  const patch: TreeStructuralPatch<Dependencies> = {};\n\n  if (fields.forwardTo !== undefined) {\n    patch.forwardTo = fields.forwardTo;\n  }\n\n  if (fields.defaultParams !== undefined) {\n    patch.defaultParams = fields.defaultParams;\n  }\n\n  if (fields.encodeParams !== undefined) {\n    patch.encodeParams = fields.encodeParams;\n  }\n\n  if (fields.decodeParams !== undefined) {\n    patch.decodeParams = fields.decodeParams;\n  }\n\n  return Object.freeze(patch);\n}\n\n// ============================================================================\n// CRUD operations\n// ============================================================================\n\n/**\n * Adds one or more routes to the router.\n * Input already validated by facade.\n */\nfunction addRoutes<\n  Dependencies extends DefaultDependencies = DefaultDependencies,\n>(\n  store: RoutesStore<Dependencies>,\n  routes: Route<Dependencies>[],\n  parentName?: string,\n): void {\n  // Prepare-then-commit (issue #698): reject the silent-corruption cases\n  // up front (dup name vs existing, missing parent), build the merged tree /\n  // config into locals (async/circular forwardTo + invalid constraint throw\n  // here), then swap atomically. A rejected add leaves the store untouched.\n  assertAddable(store, routes, parentName);\n\n  const artifacts = buildAddArtifacts(store, routes, parentName);\n\n  // Pre-flight the #961 handler-limit into PREPARE so a limit-exceeding batch\n  // aborts before the swap (#1046). `add` does not clear guards, so the\n  // projection runs against the live union count (clearsDefinition = false).\n  // eslint-disable-next-line @typescript-eslint/no-non-null-assertion -- guaranteed set after wiring\n  store.lifecycleNamespace!.preflightHandlerLimit(\n    artifacts.pendingCanActivate.keys(),\n    artifacts.pendingCanDeactivate.keys(),\n    false,\n  );\n\n  adoptRouteArtifacts(store, artifacts);\n}\n\n/**\n * Atomically replaces all routes with a new set (HMR / code-splitting).\n * Prepare-then-commit (issue #698): the new set is fully built into locals\n * first — a circular/async forwardTo or invalid path throws here, leaving the\n * existing tree intact — then committed.\n */\nfunction replaceRoutes<\n  Dependencies extends DefaultDependencies = DefaultDependencies,\n>(\n  store: RoutesStore<Dependencies>,\n  routes: Route<Dependencies>[],\n  ctx: RouterInternals<Dependencies>,\n  currentState: State | undefined,\n  onCommitted?: () => void,\n): void {\n  // Reject the silent-corruption cases `assertAddable` catches for `add`, BEFORE\n  // building/swapping, so bare-core parity is symmetric (#1047): within-batch\n  // duplicate names (#968), reserved \"@@\" names (#954), and within-batch\n  // duplicate paths (#955). methodName is \"addRoute\" to match validation-plugin\n  // (which reports \"addRoute\" for replace batches too), so the no-plugin error\n  // is identical to the with-plugin one.\n  assertNoInternalNamesInBatch(routes, \"addRoute\");\n  assertNoDuplicateNamesInBatch(routes, \"\", \"addRoute\");\n  assertNoDuplicatePathsInBatch(routes, \"\", \"addRoute\");\n\n  // Build the whole new set BEFORE touching the store.\n  const artifacts = buildReplaceArtifacts(\n    routes,\n    store.rootPath,\n    store.matcherOptions,\n  );\n\n  // Pre-flight the #961 handler-limit BEFORE clearDefinitionGuards mutates, so a\n  // limit-exceeding batch aborts with BOTH the tree and the definition guards\n  // intact (#1046). replace clears definition guards first, so the projection\n  // runs against the surviving external guards (clearsDefinition = true).\n  // eslint-disable-next-line @typescript-eslint/no-non-null-assertion -- guaranteed set after wiring\n  store.lifecycleNamespace!.preflightHandlerLimit(\n    artifacts.pendingCanActivate.keys(),\n    artifacts.pendingCanDeactivate.keys(),\n    true,\n  );\n\n  // Clear definition lifecycle handlers (preserve external guards), then swap.\n  // eslint-disable-next-line @typescript-eslint/no-non-null-assertion -- guaranteed set after wiring\n  store.lifecycleNamespace!.clearDefinitionGuards();\n  adoptRouteArtifacts(store, artifacts);\n\n  // TREE_CHANGED fires here (О-5): the new tree is committed but state is not\n  // yet revalidated, so the handler sees the new tree and the still-old state.\n  onCommitted?.();\n\n  // Revalidate the active state against the new tree AND notify subscribers\n  // (#950). A structural replace can change or drop the currently-active state;\n  // emitting TRANSITION_SUCCESS makes router.subscribe / useSyncExternalStore\n  // adapters re-render instead of rendering the pre-replace state. (This is the\n  // one structural mutation that emits a transition event — clear() stays a\n  // silent reset; the asymmetry is deliberate, see #950.)\n  if (currentState !== undefined) {\n    const revalidated = ctx.matchPath(currentState.path, ctx.getOptions());\n\n    if (revalidated) {\n      // Path still matches — commit the revalidated state (preserving the prior\n      // transition meta) and emit so subscribers see it.\n      const nextState: State = {\n        ...revalidated,\n        transition: currentState.transition,\n      };\n\n      ctx.setState(nextState);\n      ctx.emitTransitionSuccess(nextState, currentState, REVALIDATE_OPTS);\n    } else {\n      // The active route no longer exists in the new tree — surface it as\n      // not-found (commits UNKNOWN_ROUTE + emits TRANSITION_SUCCESS) so the\n      // change is observable, rather than silently clearing the state.\n      ctx.navigateToNotFound(currentState.path);\n    }\n  }\n}\n\n/**\n * Removes a route and all its children.\n *\n * @returns true if removed, false if not found\n */\nfunction removeRoute<\n  Dependencies extends DefaultDependencies = DefaultDependencies,\n>(store: RoutesStore<Dependencies>, name: string): boolean {\n  const wasRemoved = removeFromDefinitions(store.definitions, name);\n\n  if (!wasRemoved) {\n    return false;\n  }\n\n  clearRouteConfigurations(\n    name,\n    store.config,\n    store.routeCustomFields,\n    // eslint-disable-next-line @typescript-eslint/no-non-null-assertion\n    store.lifecycleNamespace!,\n  );\n\n  commitTreeChanges(store);\n\n  return true;\n}\n\n/**\n * Gets a route by name with all its configuration.\n */\nfunction getRoute<\n  Dependencies extends DefaultDependencies = DefaultDependencies,\n>(\n  store: RoutesStore<Dependencies>,\n  name: string,\n): Route<Dependencies> | undefined {\n  const segments = store.matcher.getSegmentsByName(name);\n\n  if (!segments) {\n    return undefined;\n  }\n\n  // eslint-disable-next-line @typescript-eslint/no-non-null-assertion -- segments is non-empty (checked above)\n  const targetNode = segments.at(-1)! as RouteTree;\n  const definition = nodeToDefinition(targetNode);\n  // eslint-disable-next-line @typescript-eslint/no-non-null-assertion\n  const factories = store.lifecycleNamespace!.getFactories();\n\n  return enrichRoute(definition, name, store.config, factories);\n}\n\n// ============================================================================\n// API factory\n// ============================================================================\n\n// Cache the assembled RoutesApi per router — mirrors getPluginApi()/getNavigator():\n// avoids re-allocating the 9-closure bag on each call (adapters/plugins poll it\n// from constructors) and gives spy/stub helpers a stable object identity. Closures\n// capture `ctx`/`store`, both stable for the router's lifetime, so caching is safe.\n// Single cast site: the value is stored as `unknown` (RoutesApi is invariant in\n// Dependencies, so one typed map can't hold every instantiation) and cast on read.\nconst cache = new WeakMap<object, unknown>();\n\nexport function getRoutesApi<\n  Dependencies extends DefaultDependencies = DefaultDependencies,\n>(router: Router<Dependencies>): RoutesApi<Dependencies> {\n  const cached = cache.get(router);\n\n  if (cached) {\n    return cached as RoutesApi<Dependencies>;\n  }\n\n  const ctx = getInternals(router);\n\n  const store = ctx.routeGetStore();\n\n  // Single cast site: the channel is typed with default Dependencies on\n  // RouterInternals (RouterEventMap is non-generic), but payloads are built\n  // with this api's Dependencies. The runtime shape is identical.\n  const emitChange = (event: TreeChangedEvent<Dependencies>): void => {\n    ctx.treeChanged.emit(event as TreeChangedEvent);\n  };\n\n  const api: RoutesApi<Dependencies> = {\n    add: (routes, options) => {\n      throwIfDisposed(ctx.isDisposed);\n      throwIfReentrantTreeMutation(ctx.treeChanged.isEmitting);\n\n      const routeArray = Array.isArray(routes) ? routes : [routes];\n      const parentName = options?.parent;\n\n      guardRouteStructure(routeArray, ctx.validator);\n\n      if (parentName !== undefined) {\n        ctx.validator?.routes.validateParentOption(parentName, store.tree);\n      }\n\n      ctx.validator?.routes.throwIfInternalRouteInArray(routeArray, \"addRoute\");\n      ctx.validator?.routes.validateAddRouteArgs(routeArray);\n      ctx.validator?.routes.validateRoutes(routeArray, store);\n\n      addRoutes(store, routeArray, parentName);\n\n      // Built from the post-commit store (О-1), only when someone is listening.\n      if (ctx.treeChanged.listenerCount() > 0) {\n        const added = collectAddedRoutes(routeArray, parentName, store);\n\n        emitChange(\n          parentName === undefined\n            ? { op: \"add\", added }\n            : { op: \"add\", added, parent: parentName },\n        );\n      }\n    },\n\n    remove: (name) => {\n      throwIfDisposed(ctx.isDisposed);\n      throwIfReentrantTreeMutation(ctx.treeChanged.isEmitting);\n\n      ctx.validator?.routes.validateRemoveRouteArgs(name);\n      ctx.validator?.routes.throwIfInternalRoute(name, \"removeRoute\");\n      // Always-on parity backstop (#1047 / #238): a reserved \"@@\" name is\n      // internal and cannot be removed, with or without the validation-plugin.\n      assertNoInternalRouteName(name, \"removeRoute\");\n\n      const canRemove = validateRemoveRoute(\n        name,\n        ctx.getStateName(),\n        ctx.isTransitioning(),\n      );\n\n      if (!canRemove) {\n        return;\n      }\n\n      // Snapshot the subtree BEFORE the mutation — the nodes are gone after.\n      const removedSubtree =\n        ctx.treeChanged.listenerCount() > 0\n          ? collectSubtree(store, name)\n          : undefined;\n      const wasRemoved = removeRoute(store, name);\n\n      if (!wasRemoved) {\n        logger.warn(\n          \"router.removeRoute\",\n          `Route \"${name}\" not found. No changes made.`,\n        );\n\n        return;\n      }\n\n      if (removedSubtree !== undefined) {\n        emitChange({ op: \"remove\", name, removedSubtree });\n      }\n    },\n\n    update: (name, updates) => {\n      throwIfDisposed(ctx.isDisposed);\n      throwIfReentrantTreeMutation(ctx.treeChanged.isEmitting);\n\n      ctx.validator?.routes.validateUpdateRouteBasicArgs(name, updates);\n      ctx.validator?.routes.throwIfInternalRoute(name, \"updateRoute\");\n      // Always-on parity backstop (#1047 / #238): a reserved \"@@\" name is\n      // internal and cannot be updated, with or without the validation-plugin.\n      assertNoInternalRouteName(name, \"updateRoute\");\n\n      ctx.validator?.routes.validateUpdateRoutePropertyTypes(name, updates);\n\n      /* v8 ignore next 6 -- @preserve: race condition guard, mirrors Router.updateRoute() same-path guard tested via Router.ts unit tests */\n      if (ctx.isTransitioning()) {\n        logger.error(\n          \"router.updateRoute\",\n          `Updating route \"${name}\" while navigation is in progress. This may cause unexpected behavior.`,\n        );\n      }\n\n      ctx.validator?.routes.validateUpdateRoute(name, updates, store);\n\n      // Field-patch commit core (NO_TREE_REBUILD) — co-located in routesStore.ts\n      // beside the add/replace (adoptRouteArtifacts) / remove (commitTreeChanges)\n      // / clear (resetStore) cores. Returns the structural fields for the\n      // conditional emit below (each user getter read once inside).\n      // eslint-disable-next-line @typescript-eslint/no-non-null-assertion -- guaranteed set after wiring\n      const lifecycle = store.lifecycleNamespace!;\n      const structural = commitRouteUpdate(store, lifecycle, name, updates);\n\n      // Conditional emit: structural fields only. A guard-only or empty patch\n      // produces no event (О-7 + empty-patch rule).\n      if (ctx.treeChanged.listenerCount() > 0) {\n        const patch = buildStructuralPatch<Dependencies>(structural);\n\n        if (Object.keys(patch).length > 0) {\n          emitChange({ op: \"update\", name, patch });\n        }\n      }\n    },\n\n    clear: () => {\n      throwIfDisposed(ctx.isDisposed);\n      throwIfReentrantTreeMutation(ctx.treeChanged.isEmitting);\n\n      const canClear = validateClearRoutes(ctx.isTransitioning());\n\n      /* v8 ignore next 3 -- @preserve: race condition guard, mirrors Router.clearRoutes() same-path guard tested via validateClearRoutes unit tests */\n      if (!canClear) {\n        return;\n      }\n\n      // Snapshot the routes BEFORE the reset empties them. Emitted whenever\n      // there is a listener — even for an empty clear (О-4).\n      const removed =\n        ctx.treeChanged.listenerCount() > 0\n          ? Object.freeze([...collectFlatRoutes(store, () => true).values()])\n          : undefined;\n\n      resetStore(store);\n      // eslint-disable-next-line @typescript-eslint/no-non-null-assertion -- guaranteed set after wiring\n      store.lifecycleNamespace!.clearAll();\n      ctx.clearState();\n\n      if (removed !== undefined) {\n        emitChange({ op: \"clear\", removed });\n      }\n    },\n\n    has: (name) => {\n      ctx.validator?.routes.validateRouteName(name, \"hasRoute\");\n\n      return store.matcher.hasRoute(name);\n    },\n\n    get: (name) => {\n      ctx.validator?.routes.validateRouteName(name, \"getRoute\");\n\n      return getRoute(store, name);\n    },\n\n    replace: (routes) => {\n      throwIfDisposed(ctx.isDisposed);\n      throwIfReentrantTreeMutation(ctx.treeChanged.isEmitting);\n\n      const routeArray = Array.isArray(routes) ? routes : [routes];\n\n      const canReplace = validateClearRoutes(ctx.isTransitioning());\n\n      if (!canReplace) {\n        return;\n      }\n\n      guardRouteStructure(routeArray, ctx.validator);\n\n      ctx.validator?.routes.throwIfInternalRouteInArray(\n        routeArray,\n        \"replaceRoutes\",\n      );\n      ctx.validator?.routes.validateAddRouteArgs(routeArray);\n      ctx.validator?.routes.validateRoutes(routeArray, store);\n\n      const currentState = router.getState();\n\n      // The flat removed/added diff is O(N) — compute it only when someone is\n      // listening (Решение 3.B). Snapshot the old tree BEFORE the swap.\n      const before =\n        ctx.treeChanged.listenerCount() > 0\n          ? collectFlatRoutes(store, () => true)\n          : undefined;\n\n      replaceRoutes(\n        store,\n        routeArray,\n        ctx,\n        currentState,\n        before === undefined\n          ? undefined\n          : () => {\n              const after = collectFlatRoutes(store, () => true);\n              const { removed, added } = diffFlatRoutes(before, after);\n\n              emitChange({ op: \"replace\", removed, added });\n            },\n      );\n    },\n\n    subscribeChanges: (handler) => ctx.treeChanged.subscribe(handler),\n  };\n\n  cache.set(router, api);\n\n  return api;\n}\n","import { throwIfDisposed } from \"./helpers\";\nimport { getInternals } from \"../internals\";\n\nimport type { DependenciesApi } from \"./types\";\nimport type { DependenciesStore } from \"../namespaces\";\nimport type { RouterValidator } from \"../types/RouterValidator\";\nimport type { DefaultDependencies, Router } from \"@real-router/types\";\n\n// =============================================================================\n// Module-private CRUD functions\n// =============================================================================\n\nfunction setDependency(\n  store: DependenciesStore,\n  dependencyName: string,\n  dependencyValue: unknown,\n  validator?: RouterValidator | null,\n): void {\n  // undefined = \"don't set\" (feature for conditional setting)\n  if (dependencyValue === undefined) {\n    return;\n  }\n\n  const isNewKey = !Object.hasOwn(store.dependencies, dependencyName);\n\n  if (isNewKey) {\n    // Only check limit when adding new keys (overwrites don't increase count)\n    validator?.dependencies.validateDependencyCount(store, \"setDependency\");\n  } else {\n    const oldValue = (store.dependencies as Record<string, unknown>)[\n      dependencyName\n    ];\n    const isChanging = oldValue !== dependencyValue;\n    // Special case for NaN idempotency (NaN !== NaN is always true)\n    const bothAreNaN = Number.isNaN(oldValue) && Number.isNaN(dependencyValue);\n\n    if (isChanging && !bothAreNaN) {\n      validator?.dependencies.warnOverwrite(dependencyName, \"setDependency\");\n    }\n  }\n\n  (store.dependencies as Record<string, unknown>)[dependencyName] =\n    dependencyValue;\n}\n\nfunction setMultipleDependencies(\n  store: DependenciesStore,\n  deps: Record<string, unknown>,\n  validator?: RouterValidator | null,\n): void {\n  const overwrittenKeys: string[] = [];\n\n  for (const key in deps) {\n    if (deps[key] === undefined) {\n      continue;\n    }\n\n    if (Object.hasOwn(store.dependencies, key)) {\n      overwrittenKeys.push(key);\n    } else {\n      validator?.dependencies.validateDependencyCount(store, \"setDependencies\");\n    }\n\n    (store.dependencies as Record<string, unknown>)[key] = deps[key];\n  }\n\n  if (overwrittenKeys.length > 0) {\n    validator?.dependencies.warnBatchOverwrite(\n      overwrittenKeys,\n      \"setDependencies\",\n    );\n  }\n}\n\n// =============================================================================\n// Public API factory\n// =============================================================================\n\nexport function getDependenciesApi<\n  Dependencies extends DefaultDependencies = DefaultDependencies,\n>(router: Router<Dependencies>): DependenciesApi<Dependencies> {\n  const ctx = getInternals(router);\n\n  return {\n    get: (name) => {\n      ctx.validator?.dependencies.validateDependencyName(name, \"getDependency\");\n\n      const store = ctx.dependenciesGetStore();\n      const value = (store.dependencies as Record<string, unknown>)[\n        name as string\n      ];\n\n      ctx.validator?.dependencies.validateDependencyExists(\n        name as string,\n        store,\n      );\n\n      return value as Dependencies[typeof name];\n    },\n    getAll: () => ({ ...ctx.dependenciesGetStore().dependencies }),\n    set: (name, value) => {\n      throwIfDisposed(ctx.isDisposed);\n\n      ctx.validator?.dependencies.validateSetDependencyArgs(\n        name,\n        value,\n        \"setDependency\",\n      );\n\n      setDependency(ctx.dependenciesGetStore(), name, value, ctx.validator);\n    },\n    setAll: (deps) => {\n      throwIfDisposed(ctx.isDisposed);\n\n      const store = ctx.dependenciesGetStore();\n\n      ctx.validator?.dependencies.validateDependenciesObject(\n        deps,\n        \"setDependencies\",\n      );\n      ctx.validator?.dependencies.validateDependencyLimit(store, store.limits);\n\n      setMultipleDependencies(\n        store,\n        deps as Record<string, unknown>,\n        ctx.validator,\n      );\n    },\n    remove: (name) => {\n      throwIfDisposed(ctx.isDisposed);\n\n      ctx.validator?.dependencies.validateDependencyName(\n        name,\n        \"removeDependency\",\n      );\n\n      const store = ctx.dependenciesGetStore();\n\n      if (!Object.hasOwn(store.dependencies, name)) {\n        ctx.validator?.dependencies.warnRemoveNonExistent(name);\n      }\n\n      delete (store.dependencies as Record<string, unknown>)[name as string];\n    },\n    reset: () => {\n      throwIfDisposed(ctx.isDisposed);\n      const store = ctx.dependenciesGetStore();\n\n      store.dependencies = Object.create(null) as Partial<Dependencies>;\n    },\n    has: (name) => {\n      ctx.validator?.dependencies.validateDependencyName(name, \"hasDependency\");\n\n      return Object.hasOwn(ctx.dependenciesGetStore().dependencies, name);\n    },\n  };\n}\n"],"mappings":"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"}

package/dist/esm/cloneRouter-wDGXORhn.mjs

@@ -0,0 +1,2 @@
+import{h as e,n as t,t as n,x as r}from"./Router-DrBJNtHp.mjs";import{l as i,r as a}from"./esm-DVWMs97_.mjs";function o(e){if(e())throw new t(r.ROUTER_DISPOSED)}function s(e){if(e())throw new t(r.REENTRANT_TREE_MUTATION)}const c=new WeakMap;function l(e){let n=c.get(e);if(n)return n;let a=i(e),s={makeState:(e,t,n,r)=>(a.validator?.state.validateMakeStateArgs(e,t,n),a.makeState(e,t,n,r?.params)),buildState:(e,t)=>{a.validator?.routes.validateStateBuilderArgs(e,t,`buildState`);let{name:n,params:r}=a.forwardState(e,t);return a.buildStateResolved(n,r)},forwardState:(e,t)=>(a.validator?.routes.validateStateBuilderArgs(e,t,`forwardState`),a.forwardState(e,t)),matchPath:e=>(a.validator?.routes.validateMatchPathArgs(e),a.matchPath(e,a.getOptions())),navigateToState:(e,t)=>(o(a.isDisposed),a.validator?.navigation.validateNavigateToStateArgs(e),t!==void 0&&a.validator?.navigation.validateNavigationOptions(t,`navigateToState`),a.navigateToState(e,t)),setRootPath:e=>{o(a.isDisposed),a.validator?.routes.validateSetRootPathArgs(e),a.setRootPath(e)},getRootPath:a.getRootPath,addEventListener:(e,t)=>(o(a.isDisposed),a.validator?.eventBus.validateListenerArgs(e,t),a.addEventListener(e,t)),buildNavigationState:(e,t={})=>{a.validator?.routes.validateStateBuilderArgs(e,t,`buildNavigationState`);let{name:n,params:r}=a.forwardState(e,t),i=a.buildStateResolved(n,r);if(i)return a.makeState(i.name,i.params,a.buildPath(i.name,i.params),i.meta)},getOptions:a.getOptions,getTree:a.getTree,addInterceptor:(e,t)=>{o(a.isDisposed),a.validator?.plugins.validateAddInterceptorArgs(e,t);let n=a.interceptors.get(e);return n||(n=[],a.interceptors.set(e,n)),n.push(t),()=>{let e=n.indexOf(t);e!==-1&&n.splice(e,1)}},getRouteConfig:e=>{let t=a.routeGetStore();if(t.matcher.hasRoute(e))return t.routeCustomFields[e]},extendRouter:n=>{o(a.isDisposed);let i=Object.keys(n);for(let n of i)if(n in e)throw new t(r.PLUGIN_CONFLICT,{message:`Cannot extend router: property "${n}" already exists`});for(let t of i)e[t]=n[t];let s={keys:i};a.routerExtensions.push(s);let c=!1;return()=>{if(c)return;c=!0;for(let t of s.keys)delete e[t];let t=a.routerExtensions.indexOf(s);t!==-1&&a.routerExtensions.splice(t,1)}},emitTransitionError:e=>{o(a.isDisposed),a.emitTransitionError(e)},claimContextNamespace:e=>{if(o(a.isDisposed),a.contextClaimRecords.has(e))throw new t(r.CONTEXT_NAMESPACE_ALREADY_CLAIMED,{message:`Cannot claim context namespace: "${e}" is already claimed by another plugin`});return a.contextClaimRecords.add(e),{write(t,n){t.context[e]=n},release(){a.contextClaimRecords.delete(e)}}}};return c.set(e,s),s}function u(e){let t=i(e),n=t.routeGetStore().lifecycleNamespace;return{addActivateGuard(e,r){o(t.isDisposed),t.validator?.routes.validateRouteName(e,`addActivateGuard`),t.validator?.lifecycle.validateHandler(r,`addActivateGuard`),n.addCanActivate(e,r)},addDeactivateGuard(e,r){o(t.isDisposed),t.validator?.routes.validateRouteName(e,`addDeactivateGuard`),t.validator?.lifecycle.validateHandler(r,`addDeactivateGuard`),n.addCanDeactivate(e,r)},removeActivateGuard(e){o(t.isDisposed),t.validator?.routes.validateRouteName(e,`removeActivateGuard`),n.clearCanActivate(e)},removeDeactivateGuard(e){o(t.isDisposed),t.validator?.routes.validateRouteName(e,`removeDeactivateGuard`),n.clearCanDeactivate(e)}}}function d(o,s){let c=i(o);if(c.isDisposed())throw new t(r.ROUTER_DISPOSED);c.validator?.dependencies.validateCloneArgs(s);let l=c.routeGetStore(),d=a(l.tree),f=l.config,p=l.resolvedForwardMap,m=l.routeCustomFields,{options:h,dependencies:g,pluginFactories:_}=c.getCloneState(),{definition:v,external:y}=l.lifecycleNamespace.getFactoriesByOrigin(),b=new n(d,h,{...g,...s}),x=i(b).routeGetStore(),S=x.lifecycleNamespace,[C,w]=v,[T,E]=y;for(let[e,t]of Object.entries(C))S.addCanDeactivate(e,t,!0);for(let[e,t]of Object.entries(w))S.addCanActivate(e,t,!0);let D=u(b);for(let[e,t]of Object.entries(T))D.addDeactivateGuard(e,t);for(let[e,t]of Object.entries(E))D.addActivateGuard(e,t);return _.length>0&&b.usePlugin(..._),e(x.config,f),Object.assign(x.resolvedForwardMap,p),Object.assign(x.routeCustomFields,m),b}export{s as a,o as i,u as n,l as r,d as t};
+//# sourceMappingURL=cloneRouter-wDGXORhn.mjs.map

package/dist/esm/{cloneRouter-Q4bYKC4E.mjs.map → cloneRouter-wDGXORhn.mjs.map}

@@ -1 +1 @@
-{"version":3,"file":"cloneRouter-Q4bYKC4E.mjs","names":["routeTreeToDefinitions","RouterClass"],"sources":["../../src/api/helpers.ts","../../src/api/getPluginApi.ts","../../src/api/getLifecycleApi.ts","../../src/api/cloneRouter.ts"],"sourcesContent":["// packages/core/src/api/helpers.ts\n\nimport { errorCodes } from \"../constants\";\nimport { RouterError } from \"../RouterError\";\n\nexport function throwIfDisposed(isDisposed: () => boolean): void {\n  if (isDisposed()) {\n    throw new RouterError(errorCodes.ROUTER_DISPOSED);\n  }\n}\n\n/**\n * Bans synchronous reentrant route-CRUD: a CRUD op called while a `TREE_CHANGED`\n * emit is on the stack (i.e. from inside a `subscribeChanges` handler) throws\n * `REENTRANT_TREE_MUTATION` BEFORE mutating — the tree stays atomic (#1032).\n * Deferred CRUD (`queueMicrotask` / `await`) runs after the dispatch settles and\n * is unaffected; CRUD from a transition listener is not a TREE_CHANGED dispatch.\n */\nexport function throwIfReentrantTreeMutation(isEmitting: () => boolean): void {\n  if (isEmitting()) {\n    throw new RouterError(errorCodes.REENTRANT_TREE_MUTATION);\n  }\n}\n","import { throwIfDisposed } from \"./helpers\";\nimport { errorCodes } from \"../constants\";\nimport { getInternals } from \"../internals\";\nimport { RouterError } from \"../RouterError\";\n\nimport type { PluginApi } from \"./types\";\nimport type {\n  ContextNamespaceClaim,\n  DefaultDependencies,\n  Params,\n  Router,\n  State,\n} from \"@real-router/types\";\n\n// Cache the assembled PluginApi per router — mirrors getNavigator() (#525):\n// avoids re-allocating the closure-bag on each call (plugins call this once\n// at init, but tests + nested plugins poll it), and gives spy/stub helpers\n// a stable object identity to attach to (e.g. spying on\n// `getPluginApi(router).navigateToState` to inject errors in popstate\n// recovery tests).\nconst cache = new WeakMap<object, PluginApi>();\n\nexport function getPluginApi<\n  Dependencies extends DefaultDependencies = DefaultDependencies,\n>(router: Router<Dependencies>): PluginApi {\n  const cached = cache.get(router);\n\n  if (cached) {\n    return cached;\n  }\n\n  const ctx = getInternals(router);\n  const api: PluginApi = {\n    makeState: (name, params, path, meta) => {\n      ctx.validator?.state.validateMakeStateArgs(name, params, path);\n\n      return ctx.makeState(\n        name,\n        params,\n        path,\n        meta?.params as\n          Record<string, Record<string, \"url\" | \"query\">> | undefined,\n      );\n    },\n    buildState: (routeName, routeParams) => {\n      ctx.validator?.routes.validateStateBuilderArgs(\n        routeName,\n        routeParams,\n        \"buildState\",\n      );\n\n      const { name, params } = ctx.forwardState(routeName, routeParams);\n\n      return ctx.buildStateResolved(name, params);\n    },\n    forwardState: <P extends Params = Params>(\n      routeName: string,\n      routeParams: P,\n    ) => {\n      ctx.validator?.routes.validateStateBuilderArgs(\n        routeName,\n        routeParams,\n        \"forwardState\",\n      );\n\n      return ctx.forwardState(routeName, routeParams);\n    },\n    matchPath: (path) => {\n      ctx.validator?.routes.validateMatchPathArgs(path);\n\n      return ctx.matchPath(path, ctx.getOptions());\n    },\n    navigateToState: (state, options) => {\n      throwIfDisposed(ctx.isDisposed);\n\n      ctx.validator?.navigation.validateNavigateToStateArgs(state);\n\n      if (options !== undefined) {\n        ctx.validator?.navigation.validateNavigationOptions(\n          options,\n          \"navigateToState\",\n        );\n      }\n\n      return ctx.navigateToState(state, options);\n    },\n    setRootPath: (rootPath) => {\n      throwIfDisposed(ctx.isDisposed);\n\n      ctx.validator?.routes.validateSetRootPathArgs(rootPath);\n\n      ctx.setRootPath(rootPath);\n    },\n    getRootPath: ctx.getRootPath,\n    addEventListener: (eventName, cb) => {\n      throwIfDisposed(ctx.isDisposed);\n\n      ctx.validator?.eventBus.validateListenerArgs(eventName, cb);\n\n      return ctx.addEventListener(eventName, cb);\n    },\n    buildNavigationState: (name, params = {}) => {\n      ctx.validator?.routes.validateStateBuilderArgs(\n        name,\n        params,\n        \"buildNavigationState\",\n      );\n\n      const { name: resolvedName, params: resolvedParams } = ctx.forwardState(\n        name,\n        params,\n      );\n      const routeInfo = ctx.buildStateResolved(resolvedName, resolvedParams);\n\n      if (!routeInfo) {\n        return;\n      }\n\n      return ctx.makeState(\n        routeInfo.name,\n        routeInfo.params,\n        ctx.buildPath(routeInfo.name, routeInfo.params),\n        routeInfo.meta,\n      );\n    },\n    getOptions: ctx.getOptions,\n    getTree: ctx.getTree,\n    addInterceptor: (method, fn) => {\n      throwIfDisposed(ctx.isDisposed);\n      ctx.validator?.plugins.validateAddInterceptorArgs(method, fn);\n      let list = ctx.interceptors.get(method);\n\n      if (!list) {\n        list = [];\n        ctx.interceptors.set(method, list);\n      }\n\n      list.push(fn);\n\n      return () => {\n        const index = list.indexOf(fn);\n\n        if (index !== -1) {\n          list.splice(index, 1);\n        }\n      };\n    },\n    getRouteConfig: (name) => {\n      const store = ctx.routeGetStore();\n\n      // Stryker disable next-line ConditionalExpression,BlockStatement: equivalent — a missing route yields routeCustomFields[name] === undefined, identical to this early return\n      if (!store.matcher.hasRoute(name)) {\n        return;\n      }\n\n      return store.routeCustomFields[name];\n    },\n    extendRouter: (extensions: Record<string, unknown>) => {\n      throwIfDisposed(ctx.isDisposed);\n\n      const keys = Object.keys(extensions);\n\n      for (const key of keys) {\n        if (key in router) {\n          throw new RouterError(errorCodes.PLUGIN_CONFLICT, {\n            message: `Cannot extend router: property \"${key}\" already exists`,\n          });\n        }\n      }\n\n      for (const key of keys) {\n        (router as Record<string, unknown>)[key] = extensions[key];\n      }\n\n      const extensionRecord = { keys };\n\n      ctx.routerExtensions.push(extensionRecord);\n\n      let removed = false;\n\n      return () => {\n        if (removed) {\n          return;\n        }\n\n        removed = true;\n\n        for (const key of extensionRecord.keys) {\n          delete (router as Record<string, unknown>)[key];\n        }\n\n        const idx = ctx.routerExtensions.indexOf(extensionRecord);\n\n        // Stryker disable next-line ConditionalExpression,EqualityOperator,UnaryOperator,BlockStatement: equivalent — this splice only tidies the `routerExtensions` TRACKING array; the router INSTANCE is cleaned by the `delete router[key]` loop above, and dispose()'s safety-net re-deletes any leaked key harmlessly. So no mutation of this guard/splice is behaviourally observable (full suite green with `===`, `+1`, and an empty body). Contrast the addInterceptor splice, which IS observable through buildPath and is killed behaviourally by invariantGuardMutants.test.ts.\n        if (idx !== -1) {\n          ctx.routerExtensions.splice(idx, 1);\n        }\n      };\n    },\n    emitTransitionError: (error) => {\n      throwIfDisposed(ctx.isDisposed);\n      ctx.emitTransitionError(error);\n    },\n    claimContextNamespace: (namespace: string) => {\n      throwIfDisposed(ctx.isDisposed);\n\n      if (ctx.contextClaimRecords.has(namespace)) {\n        throw new RouterError(errorCodes.CONTEXT_NAMESPACE_ALREADY_CLAIMED, {\n          message: `Cannot claim context namespace: \"${namespace}\" is already claimed by another plugin`,\n        });\n      }\n\n      ctx.contextClaimRecords.add(namespace);\n\n      return {\n        write(state: State, value: unknown) {\n          state.context[namespace] = value;\n        },\n        release() {\n          ctx.contextClaimRecords.delete(namespace);\n        },\n      } satisfies ContextNamespaceClaim;\n    },\n  };\n\n  cache.set(router, api);\n\n  return api;\n}\n","import { throwIfDisposed } from \"./helpers\";\nimport { getInternals } from \"../internals\";\n\nimport type { LifecycleApi } from \"./types\";\nimport type { DefaultDependencies, Router } from \"@real-router/types\";\n\nexport function getLifecycleApi<\n  Dependencies extends DefaultDependencies = DefaultDependencies,\n>(router: Router<Dependencies>): LifecycleApi<Dependencies> {\n  const ctx = getInternals(router);\n  // eslint-disable-next-line @typescript-eslint/no-non-null-assertion -- guaranteed set after wiring\n  const lifecycleNamespace = ctx.routeGetStore().lifecycleNamespace!;\n\n  return {\n    addActivateGuard(name, handler) {\n      throwIfDisposed(ctx.isDisposed);\n\n      ctx.validator?.routes.validateRouteName(name, \"addActivateGuard\");\n      ctx.validator?.lifecycle.validateHandler(handler, \"addActivateGuard\");\n\n      // Handler-limit enforcement lives at the namespace registration choke point\n      // (RouteLifecycleNamespace.#registerHandler) so all paths are bounded\n      // uniformly — see #961.\n      lifecycleNamespace.addCanActivate(name, handler);\n    },\n\n    addDeactivateGuard(name, handler) {\n      throwIfDisposed(ctx.isDisposed);\n\n      ctx.validator?.routes.validateRouteName(name, \"addDeactivateGuard\");\n      ctx.validator?.lifecycle.validateHandler(handler, \"addDeactivateGuard\");\n\n      lifecycleNamespace.addCanDeactivate(name, handler);\n    },\n\n    removeActivateGuard(name) {\n      throwIfDisposed(ctx.isDisposed);\n\n      ctx.validator?.routes.validateRouteName(name, \"removeActivateGuard\");\n\n      lifecycleNamespace.clearCanActivate(name);\n    },\n\n    removeDeactivateGuard(name) {\n      throwIfDisposed(ctx.isDisposed);\n\n      ctx.validator?.routes.validateRouteName(name, \"removeDeactivateGuard\");\n\n      lifecycleNamespace.clearCanDeactivate(name);\n    },\n  };\n}\n","import { routeTreeToDefinitions } from \"route-tree\";\n\nimport { errorCodes } from \"../constants\";\nimport { getInternals } from \"../internals\";\nimport { assignConfigEntries } from \"../namespaces/RoutesNamespace/helpers\";\nimport { Router as RouterClass } from \"../Router\";\nimport { RouterError } from \"../RouterError\";\nimport { getLifecycleApi } from \"./getLifecycleApi\";\n\nimport type { Route } from \"../types\";\nimport type { DefaultDependencies, Router } from \"@real-router/types\";\n\n/**\n * Build an independent router instance that shares the route tree, options,\n * lifecycle guards, and plugin factories of `router`. The primary use case\n * is **SSR multi-tenancy** — one base router per process, one clone per\n * request.\n *\n * @param router - Source router (must not be disposed).\n * @param dependencies - Optional per-clone overrides merged on top of the\n *   base router's dependencies. Always **fresh per call** in the documented\n *   SSR pattern: pass per-request state here, never store it in the base.\n *\n * @remarks\n *\n * **Dependency merge — shallow by design.** `base.dependencies` are spread\n * into the clone via `{ ...sourceDeps, ...dependencies }`. Top-level keys\n * are new objects, but **values are shared by reference**: a `Map`, `Set`,\n * class instance, function, or nested plain object stored in\n * `base.dependencies` is the **same instance** in every clone. Mutations\n * in one clone are visible in the base and in every sibling clone.\n *\n * This is intentional. `structuredClone` of dep values is **not** applied\n * because it would:\n * - strip class prototypes (`new DbClient()` → plain object, methods lost)\n * - reject functions and symbols (`DataCloneError`)\n * - fragment singleton pools (one connection pool per request — pool\n *   semantics destroyed)\n * - reject circular references\n *\n * **SSR rule of thumb.** Place values in `base.dependencies` according to\n * their lifecycle:\n *\n * - **Singletons / shared services** → `base.dependencies`. Examples: DB\n *   client, connection pool, logger, config, feature-flag client. Process-\n *   wide pooling depends on sharing these by reference.\n * - **Per-request state** → the `dependencies` override parameter (or\n *   `createRequestScope`'s `deps` argument). Examples: `currentUser`,\n *   `traceId`, `sessionId`, `abortSignal`. The override is applied last,\n *   so it wins over base keys; pass a fresh object per call.\n *\n * Cross-request data leaks are **only possible** when per-request mutable\n * state is incorrectly placed in `base.dependencies`. The override slot is\n * the safe channel.\n *\n * @example\n * ```typescript\n * // Server boot — singletons only\n * const base = createRouter(routes, options, {\n *   db: new DbClient(dbUrl),\n *   logger,\n * });\n *\n * // Per request — fresh override per call\n * const clone = cloneRouter(base, {\n *   currentUser,\n *   traceId,\n * });\n * // clone.deps.db === base.deps.db  ✓ shared pool (intentional)\n * // clone.deps.currentUser          ✓ unique per request\n * ```\n *\n * @see createRequestScope — `@real-router/core/utils` SSR helper that\n *   wraps this function and injects `abortSignal` automatically.\n */\nexport function cloneRouter<\n  Dependencies extends DefaultDependencies = DefaultDependencies,\n>(\n  router: Router<Dependencies>,\n  dependencies?: Dependencies,\n): RouterClass<Dependencies> {\n  const ctx = getInternals(router);\n\n  if (ctx.isDisposed()) {\n    throw new RouterError(errorCodes.ROUTER_DISPOSED);\n  }\n\n  ctx.validator?.dependencies.validateCloneArgs(dependencies);\n\n  // Get source store directly\n  const sourceStore = ctx.routeGetStore();\n  const routes = routeTreeToDefinitions(sourceStore.tree);\n  const routeConfig = sourceStore.config;\n  const resolvedForwardMap = sourceStore.resolvedForwardMap;\n  const routeCustomFields = sourceStore.routeCustomFields;\n\n  const {\n    options,\n    dependencies: sourceDeps,\n    pluginFactories,\n  } = ctx.getCloneState();\n  // Origin-aware factory snapshot — definition guards are re-registered with\n  // `isFromDefinition=true` on the clone so `replace()` can still strip them\n  // via `clearDefinitionGuards()`. External guards take the public lifecycle\n  // API path so they survive `replace()` symmetric with the base.\n  // eslint-disable-next-line @typescript-eslint/no-non-null-assertion -- guaranteed set after wiring\n  const sourceLifecycleNamespace = sourceStore.lifecycleNamespace!;\n  const { definition: definitionFactories, external: externalFactories } =\n    sourceLifecycleNamespace.getFactoriesByOrigin();\n\n  const mergedDeps = {\n    ...sourceDeps,\n    ...dependencies,\n  } as Dependencies;\n\n  const newRouter = new RouterClass<Dependencies>(\n    routes as Route<Dependencies>[],\n    options,\n    mergedDeps,\n  );\n\n  const newCtx = getInternals(newRouter);\n  const newStore = newCtx.routeGetStore();\n  // eslint-disable-next-line @typescript-eslint/no-non-null-assertion -- guaranteed set after wiring\n  const newLifecycleNamespace = newStore.lifecycleNamespace!;\n\n  const [definitionDeactivate, definitionActivate] = definitionFactories;\n  const [externalDeactivate, externalActivate] = externalFactories;\n\n  for (const [name, handler] of Object.entries(definitionDeactivate)) {\n    newLifecycleNamespace.addCanDeactivate(name, handler, true);\n  }\n\n  for (const [name, handler] of Object.entries(definitionActivate)) {\n    newLifecycleNamespace.addCanActivate(name, handler, true);\n  }\n\n  const lifecycle = getLifecycleApi(newRouter);\n\n  for (const [name, handler] of Object.entries(externalDeactivate)) {\n    lifecycle.addDeactivateGuard(name, handler);\n  }\n\n  for (const [name, handler] of Object.entries(externalActivate)) {\n    lifecycle.addActivateGuard(name, handler);\n  }\n\n  // Stryker disable next-line EqualityOperator: equivalent — `>= 0` is always true, but `usePlugin(...[])` with an empty spread is a no-op, so entering the block on an empty list behaves identically to skipping it. (ConditionalExpression stays live: `→false` skips a real plugin list and is killable.)\n  if (pluginFactories.length > 0) {\n    newRouter.usePlugin(...pluginFactories);\n  }\n\n  // Copy the source config + store-level maps onto the new store. The five\n  // RouteConfig sub-maps go through a single enumeration so a newly added config\n  // field is carried over automatically (#965); resolvedForwardMap and\n  // routeCustomFields are store-level (not part of RouteConfig) and stay explicit.\n  assignConfigEntries(newStore.config, routeConfig);\n  Object.assign(newStore.resolvedForwardMap, resolvedForwardMap);\n  Object.assign(newStore.routeCustomFields, routeCustomFields);\n\n  return newRouter;\n}\n"],"mappings":"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"}
+{"version":3,"file":"cloneRouter-wDGXORhn.mjs","names":["routeTreeToDefinitions","RouterClass"],"sources":["../../src/api/helpers.ts","../../src/api/getPluginApi.ts","../../src/api/getLifecycleApi.ts","../../src/api/cloneRouter.ts"],"sourcesContent":["// packages/core/src/api/helpers.ts\n\nimport { errorCodes } from \"../constants\";\nimport { RouterError } from \"../RouterError\";\n\nexport function throwIfDisposed(isDisposed: () => boolean): void {\n  if (isDisposed()) {\n    throw new RouterError(errorCodes.ROUTER_DISPOSED);\n  }\n}\n\n/**\n * Bans synchronous reentrant route-CRUD: a CRUD op called while a `TREE_CHANGED`\n * emit is on the stack (i.e. from inside a `subscribeChanges` handler) throws\n * `REENTRANT_TREE_MUTATION` BEFORE mutating — the tree stays atomic (#1032).\n * Deferred CRUD (`queueMicrotask` / `await`) runs after the dispatch settles and\n * is unaffected; CRUD from a transition listener is not a TREE_CHANGED dispatch.\n */\nexport function throwIfReentrantTreeMutation(isEmitting: () => boolean): void {\n  if (isEmitting()) {\n    throw new RouterError(errorCodes.REENTRANT_TREE_MUTATION);\n  }\n}\n","import { throwIfDisposed } from \"./helpers\";\nimport { errorCodes } from \"../constants\";\nimport { getInternals } from \"../internals\";\nimport { RouterError } from \"../RouterError\";\n\nimport type { PluginApi } from \"./types\";\nimport type {\n  ContextNamespaceClaim,\n  DefaultDependencies,\n  Params,\n  Router,\n  State,\n} from \"@real-router/types\";\n\n// Cache the assembled PluginApi per router — mirrors getNavigator() (#525):\n// avoids re-allocating the closure-bag on each call (plugins call this once\n// at init, but tests + nested plugins poll it), and gives spy/stub helpers\n// a stable object identity to attach to (e.g. spying on\n// `getPluginApi(router).navigateToState` to inject errors in popstate\n// recovery tests).\nconst cache = new WeakMap<object, PluginApi>();\n\nexport function getPluginApi<\n  Dependencies extends DefaultDependencies = DefaultDependencies,\n>(router: Router<Dependencies>): PluginApi {\n  const cached = cache.get(router);\n\n  if (cached) {\n    return cached;\n  }\n\n  const ctx = getInternals(router);\n  const api: PluginApi = {\n    makeState: (name, params, path, meta) => {\n      ctx.validator?.state.validateMakeStateArgs(name, params, path);\n\n      return ctx.makeState(\n        name,\n        params,\n        path,\n        meta?.params as\n          Record<string, Record<string, \"url\" | \"query\">> | undefined,\n      );\n    },\n    buildState: (routeName, routeParams) => {\n      ctx.validator?.routes.validateStateBuilderArgs(\n        routeName,\n        routeParams,\n        \"buildState\",\n      );\n\n      const { name, params } = ctx.forwardState(routeName, routeParams);\n\n      return ctx.buildStateResolved(name, params);\n    },\n    forwardState: <P extends Params = Params>(\n      routeName: string,\n      routeParams: P,\n    ) => {\n      ctx.validator?.routes.validateStateBuilderArgs(\n        routeName,\n        routeParams,\n        \"forwardState\",\n      );\n\n      return ctx.forwardState(routeName, routeParams);\n    },\n    matchPath: (path) => {\n      ctx.validator?.routes.validateMatchPathArgs(path);\n\n      return ctx.matchPath(path, ctx.getOptions());\n    },\n    navigateToState: (state, options) => {\n      throwIfDisposed(ctx.isDisposed);\n\n      ctx.validator?.navigation.validateNavigateToStateArgs(state);\n\n      if (options !== undefined) {\n        ctx.validator?.navigation.validateNavigationOptions(\n          options,\n          \"navigateToState\",\n        );\n      }\n\n      return ctx.navigateToState(state, options);\n    },\n    setRootPath: (rootPath) => {\n      throwIfDisposed(ctx.isDisposed);\n\n      ctx.validator?.routes.validateSetRootPathArgs(rootPath);\n\n      ctx.setRootPath(rootPath);\n    },\n    getRootPath: ctx.getRootPath,\n    addEventListener: (eventName, cb) => {\n      throwIfDisposed(ctx.isDisposed);\n\n      ctx.validator?.eventBus.validateListenerArgs(eventName, cb);\n\n      return ctx.addEventListener(eventName, cb);\n    },\n    buildNavigationState: (name, params = {}) => {\n      ctx.validator?.routes.validateStateBuilderArgs(\n        name,\n        params,\n        \"buildNavigationState\",\n      );\n\n      const { name: resolvedName, params: resolvedParams } = ctx.forwardState(\n        name,\n        params,\n      );\n      const routeInfo = ctx.buildStateResolved(resolvedName, resolvedParams);\n\n      if (!routeInfo) {\n        return;\n      }\n\n      return ctx.makeState(\n        routeInfo.name,\n        routeInfo.params,\n        ctx.buildPath(routeInfo.name, routeInfo.params),\n        routeInfo.meta,\n      );\n    },\n    getOptions: ctx.getOptions,\n    getTree: ctx.getTree,\n    addInterceptor: (method, fn) => {\n      throwIfDisposed(ctx.isDisposed);\n      ctx.validator?.plugins.validateAddInterceptorArgs(method, fn);\n      let list = ctx.interceptors.get(method);\n\n      if (!list) {\n        list = [];\n        ctx.interceptors.set(method, list);\n      }\n\n      list.push(fn);\n\n      return () => {\n        const index = list.indexOf(fn);\n\n        if (index !== -1) {\n          list.splice(index, 1);\n        }\n      };\n    },\n    getRouteConfig: (name) => {\n      const store = ctx.routeGetStore();\n\n      // Stryker disable next-line ConditionalExpression,BlockStatement: equivalent — a missing route yields routeCustomFields[name] === undefined, identical to this early return\n      if (!store.matcher.hasRoute(name)) {\n        return;\n      }\n\n      return store.routeCustomFields[name];\n    },\n    extendRouter: (extensions: Record<string, unknown>) => {\n      throwIfDisposed(ctx.isDisposed);\n\n      const keys = Object.keys(extensions);\n\n      for (const key of keys) {\n        if (key in router) {\n          throw new RouterError(errorCodes.PLUGIN_CONFLICT, {\n            message: `Cannot extend router: property \"${key}\" already exists`,\n          });\n        }\n      }\n\n      for (const key of keys) {\n        (router as Record<string, unknown>)[key] = extensions[key];\n      }\n\n      const extensionRecord = { keys };\n\n      ctx.routerExtensions.push(extensionRecord);\n\n      let removed = false;\n\n      return () => {\n        if (removed) {\n          return;\n        }\n\n        removed = true;\n\n        for (const key of extensionRecord.keys) {\n          delete (router as Record<string, unknown>)[key];\n        }\n\n        const idx = ctx.routerExtensions.indexOf(extensionRecord);\n\n        // Stryker disable next-line ConditionalExpression,EqualityOperator,UnaryOperator,BlockStatement: equivalent — this splice only tidies the `routerExtensions` TRACKING array; the router INSTANCE is cleaned by the `delete router[key]` loop above, and dispose()'s safety-net re-deletes any leaked key harmlessly. So no mutation of this guard/splice is behaviourally observable (full suite green with `===`, `+1`, and an empty body). Contrast the addInterceptor splice, which IS observable through buildPath and is killed behaviourally by invariantGuardMutants.test.ts.\n        if (idx !== -1) {\n          ctx.routerExtensions.splice(idx, 1);\n        }\n      };\n    },\n    emitTransitionError: (error) => {\n      throwIfDisposed(ctx.isDisposed);\n      ctx.emitTransitionError(error);\n    },\n    claimContextNamespace: (namespace: string) => {\n      throwIfDisposed(ctx.isDisposed);\n\n      if (ctx.contextClaimRecords.has(namespace)) {\n        throw new RouterError(errorCodes.CONTEXT_NAMESPACE_ALREADY_CLAIMED, {\n          message: `Cannot claim context namespace: \"${namespace}\" is already claimed by another plugin`,\n        });\n      }\n\n      ctx.contextClaimRecords.add(namespace);\n\n      return {\n        write(state: State, value: unknown) {\n          state.context[namespace] = value;\n        },\n        release() {\n          ctx.contextClaimRecords.delete(namespace);\n        },\n      } satisfies ContextNamespaceClaim;\n    },\n  };\n\n  cache.set(router, api);\n\n  return api;\n}\n","import { throwIfDisposed } from \"./helpers\";\nimport { getInternals } from \"../internals\";\n\nimport type { LifecycleApi } from \"./types\";\nimport type { DefaultDependencies, Router } from \"@real-router/types\";\n\nexport function getLifecycleApi<\n  Dependencies extends DefaultDependencies = DefaultDependencies,\n>(router: Router<Dependencies>): LifecycleApi<Dependencies> {\n  const ctx = getInternals(router);\n  // eslint-disable-next-line @typescript-eslint/no-non-null-assertion -- guaranteed set after wiring\n  const lifecycleNamespace = ctx.routeGetStore().lifecycleNamespace!;\n\n  return {\n    addActivateGuard(name, handler) {\n      throwIfDisposed(ctx.isDisposed);\n\n      ctx.validator?.routes.validateRouteName(name, \"addActivateGuard\");\n      ctx.validator?.lifecycle.validateHandler(handler, \"addActivateGuard\");\n\n      // Handler-limit enforcement lives at the namespace registration choke point\n      // (RouteLifecycleNamespace.#registerHandler) so all paths are bounded\n      // uniformly — see #961.\n      lifecycleNamespace.addCanActivate(name, handler);\n    },\n\n    addDeactivateGuard(name, handler) {\n      throwIfDisposed(ctx.isDisposed);\n\n      ctx.validator?.routes.validateRouteName(name, \"addDeactivateGuard\");\n      ctx.validator?.lifecycle.validateHandler(handler, \"addDeactivateGuard\");\n\n      lifecycleNamespace.addCanDeactivate(name, handler);\n    },\n\n    removeActivateGuard(name) {\n      throwIfDisposed(ctx.isDisposed);\n\n      ctx.validator?.routes.validateRouteName(name, \"removeActivateGuard\");\n\n      lifecycleNamespace.clearCanActivate(name);\n    },\n\n    removeDeactivateGuard(name) {\n      throwIfDisposed(ctx.isDisposed);\n\n      ctx.validator?.routes.validateRouteName(name, \"removeDeactivateGuard\");\n\n      lifecycleNamespace.clearCanDeactivate(name);\n    },\n  };\n}\n","import { routeTreeToDefinitions } from \"route-tree\";\n\nimport { errorCodes } from \"../constants\";\nimport { getInternals } from \"../internals\";\nimport { assignConfigEntries } from \"../namespaces/RoutesNamespace/helpers\";\nimport { Router as RouterClass } from \"../Router\";\nimport { RouterError } from \"../RouterError\";\nimport { getLifecycleApi } from \"./getLifecycleApi\";\n\nimport type { Route } from \"../types\";\nimport type { DefaultDependencies, Router } from \"@real-router/types\";\n\n/**\n * Build an independent router instance that shares the route tree, options,\n * lifecycle guards, and plugin factories of `router`. The primary use case\n * is **SSR multi-tenancy** — one base router per process, one clone per\n * request.\n *\n * @param router - Source router (must not be disposed).\n * @param dependencies - Optional per-clone overrides merged on top of the\n *   base router's dependencies. Always **fresh per call** in the documented\n *   SSR pattern: pass per-request state here, never store it in the base.\n *\n * @remarks\n *\n * **Dependency merge — shallow by design.** `base.dependencies` are spread\n * into the clone via `{ ...sourceDeps, ...dependencies }`. Top-level keys\n * are new objects, but **values are shared by reference**: a `Map`, `Set`,\n * class instance, function, or nested plain object stored in\n * `base.dependencies` is the **same instance** in every clone. Mutations\n * in one clone are visible in the base and in every sibling clone.\n *\n * This is intentional. `structuredClone` of dep values is **not** applied\n * because it would:\n * - strip class prototypes (`new DbClient()` → plain object, methods lost)\n * - reject functions and symbols (`DataCloneError`)\n * - fragment singleton pools (one connection pool per request — pool\n *   semantics destroyed)\n * - reject circular references\n *\n * **SSR rule of thumb.** Place values in `base.dependencies` according to\n * their lifecycle:\n *\n * - **Singletons / shared services** → `base.dependencies`. Examples: DB\n *   client, connection pool, logger, config, feature-flag client. Process-\n *   wide pooling depends on sharing these by reference.\n * - **Per-request state** → the `dependencies` override parameter (or\n *   `createRequestScope`'s `deps` argument). Examples: `currentUser`,\n *   `traceId`, `sessionId`, `abortSignal`. The override is applied last,\n *   so it wins over base keys; pass a fresh object per call.\n *\n * Cross-request data leaks are **only possible** when per-request mutable\n * state is incorrectly placed in `base.dependencies`. The override slot is\n * the safe channel.\n *\n * @example\n * ```typescript\n * // Server boot — singletons only\n * const base = createRouter(routes, options, {\n *   db: new DbClient(dbUrl),\n *   logger,\n * });\n *\n * // Per request — fresh override per call\n * const clone = cloneRouter(base, {\n *   currentUser,\n *   traceId,\n * });\n * // clone.deps.db === base.deps.db  ✓ shared pool (intentional)\n * // clone.deps.currentUser          ✓ unique per request\n * ```\n *\n * @see createRequestScope — `@real-router/core/utils` SSR helper that\n *   wraps this function and injects `abortSignal` automatically.\n */\nexport function cloneRouter<\n  Dependencies extends DefaultDependencies = DefaultDependencies,\n>(\n  router: Router<Dependencies>,\n  dependencies?: Dependencies,\n): RouterClass<Dependencies> {\n  const ctx = getInternals(router);\n\n  if (ctx.isDisposed()) {\n    throw new RouterError(errorCodes.ROUTER_DISPOSED);\n  }\n\n  ctx.validator?.dependencies.validateCloneArgs(dependencies);\n\n  // Get source store directly\n  const sourceStore = ctx.routeGetStore();\n  const routes = routeTreeToDefinitions(sourceStore.tree);\n  const routeConfig = sourceStore.config;\n  const resolvedForwardMap = sourceStore.resolvedForwardMap;\n  const routeCustomFields = sourceStore.routeCustomFields;\n\n  const {\n    options,\n    dependencies: sourceDeps,\n    pluginFactories,\n  } = ctx.getCloneState();\n  // Origin-aware factory snapshot — definition guards are re-registered with\n  // `isFromDefinition=true` on the clone so `replace()` can still strip them\n  // via `clearDefinitionGuards()`. External guards take the public lifecycle\n  // API path so they survive `replace()` symmetric with the base.\n  // eslint-disable-next-line @typescript-eslint/no-non-null-assertion -- guaranteed set after wiring\n  const sourceLifecycleNamespace = sourceStore.lifecycleNamespace!;\n  const { definition: definitionFactories, external: externalFactories } =\n    sourceLifecycleNamespace.getFactoriesByOrigin();\n\n  const mergedDeps = {\n    ...sourceDeps,\n    ...dependencies,\n  } as Dependencies;\n\n  const newRouter = new RouterClass<Dependencies>(\n    routes as Route<Dependencies>[],\n    options,\n    mergedDeps,\n  );\n\n  const newCtx = getInternals(newRouter);\n  const newStore = newCtx.routeGetStore();\n  // eslint-disable-next-line @typescript-eslint/no-non-null-assertion -- guaranteed set after wiring\n  const newLifecycleNamespace = newStore.lifecycleNamespace!;\n\n  const [definitionDeactivate, definitionActivate] = definitionFactories;\n  const [externalDeactivate, externalActivate] = externalFactories;\n\n  for (const [name, handler] of Object.entries(definitionDeactivate)) {\n    newLifecycleNamespace.addCanDeactivate(name, handler, true);\n  }\n\n  for (const [name, handler] of Object.entries(definitionActivate)) {\n    newLifecycleNamespace.addCanActivate(name, handler, true);\n  }\n\n  const lifecycle = getLifecycleApi(newRouter);\n\n  for (const [name, handler] of Object.entries(externalDeactivate)) {\n    lifecycle.addDeactivateGuard(name, handler);\n  }\n\n  for (const [name, handler] of Object.entries(externalActivate)) {\n    lifecycle.addActivateGuard(name, handler);\n  }\n\n  // Stryker disable next-line EqualityOperator: equivalent — `>= 0` is always true, but `usePlugin(...[])` with an empty spread is a no-op, so entering the block on an empty list behaves identically to skipping it. (ConditionalExpression stays live: `→false` skips a real plugin list and is killable.)\n  if (pluginFactories.length > 0) {\n    newRouter.usePlugin(...pluginFactories);\n  }\n\n  // Copy the source config + store-level maps onto the new store. The five\n  // RouteConfig sub-maps go through a single enumeration so a newly added config\n  // field is carried over automatically (#965); resolvedForwardMap and\n  // routeCustomFields are store-level (not part of RouteConfig) and stay explicit.\n  assignConfigEntries(newStore.config, routeConfig);\n  Object.assign(newStore.resolvedForwardMap, resolvedForwardMap);\n  Object.assign(newStore.routeCustomFields, routeCustomFields);\n\n  return newRouter;\n}\n"],"mappings":"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"}

package/dist/esm/esm-DVWMs97_.mjs

@@ -0,0 +1,2 @@
+const e=new WeakMap;function t(t){let n=e.get(t);if(!n)throw TypeError(`[real-router] Invalid router instance — not found in internals registry`);return n}function n(t,n){e.set(t,n)}function r(e,t,n){let r=t;for(let t of e){let e=r;r=(...n)=>t(e,...n)}return r(...n)}function i(e,t,n){return((...i)=>{let a=n.get(e);return!a||a.length===0?t(...i):r(a,t,i)})}function a(e,t,n){return(i,a)=>{let o=n.get(e);return!o||o.length===0?t(i,a):r(o,t,[i,a])}}const o=`[^>]*`;function s(e){let t=!1;for(let n of e)if(n===`<`)t=!0;else if(n===`>`){if(!t)return!1;t=!1}return!t}function c(e){return`(${e.replaceAll(/(^<|>$)/g,``)})`}const l=`[^/?<]+`,u=new RegExp(String.raw`([:*])(${l})(<${o}>)?(\?)?`,`g`),d=new RegExp(String.raw`([:*]${l}(?:<${o}>)?)\?(?=[/?]|$)`,`g`),f=RegExp(`<${o}>`,`g`),p=/\?(.+)$/;function m(e){return e.replaceAll(f,e=>`<${`x`.repeat(e.length-2)}>`).replaceAll(d,`$1\0`)}const h=Object.freeze([]),g=Object.freeze({}),ee=new Map;function _(e){let t=[],n=[],r=[],i={},a=new Map,o=p.exec(m(e));if(o!==null){let t=e.slice(o.index+1).split(`&`);for(let e of t){let t=e.trim();t.length>0&&(n.push(t),i[t]=`query`)}e=e.slice(0,o.index)}let s;for(;(s=u.exec(e))!==null;){let e=s[1],n=s[2],o=s[3];if(e===`*`)r.push(n),t.push(n),i[n]=`url`;else if(t.push(n),i[n]=`url`,o){let e=`^${c(o)}$`;a.set(n,{pattern:new RegExp(e),constraint:o})}}return te(t,n,r,i,a,e)}function te(e,t,n,r,i,a){return{urlParams:e.length===0?h:e,queryParams:t.length===0?h:t,spatParams:n.length===0?h:n,paramTypeMap:e.length===0&&t.length===0?g:r,constraintPatterns:i.size===0?ee:i,pathPattern:a}}const ne=/[^\w!$'()*+,.:;|~-]/gu,re=/[^\w!$'()*+,.:;|~-]/u,v={default:e=>re.test(e)?e.replaceAll(ne,e=>encodeURIComponent(e)):e,uri:encodeURI,uriComponent:encodeURIComponent,none:e=>e},ie={default:decodeURIComponent,uri:decodeURI,uriComponent:decodeURIComponent,none:e=>e},ae=(e,t,n)=>{let r=v[t],i=String(e);if(!n)return r(i);let a=i.split(`/`),o=r(a[0]);for(let e=1;e<a.length;e++)o+=`/`+r(a[e]);return o};function y(){return{staticChildren:Object.create(null),hasChildren:!1,paramChild:void 0,splatChild:void 0,route:void 0,routeIsStrong:!1,slashChildRoute:void 0}}function b(e){return e.length>1&&e.endsWith(`/`)?e.slice(0,-1):e}function oe(e,t){return e===``?t:t===``?e:e+t}function x(e){return e>=48&&e<=57||e>=65&&e<=70||e>=97&&e<=102}function se(e){let t=0;for(;t<e.length;)if(e.codePointAt(t)===37){if(t+2>=e.length)return!1;let n=e.codePointAt(t+1)??0,r=e.codePointAt(t+2)??0;if(!x(n)||!x(r))return!1;t+=3}else t++;return!0}const ce=Object.freeze([]),S=Object.freeze(new Set),le=Object.freeze(new Map),ue=Object.freeze([]),de=Object.freeze({}),fe=RegExp(`<${o}>`,`g`);function C(e,t,n,r,i){let a=t.fullName===``;a||r.push(t);let o=t.absolute,c=t.paramMeta.pathPattern,l=o&&c.startsWith(`~`)?c.slice(1):c,u=o?l:c;s(u)||Te(u),u.includes(`<>`)&&Ee(u),De(u)&&Oe(u);let d=u.replaceAll(fe,``);be(d)&&xe(u);let f=o?d:oe(n,d),p=a?i:pe(e,t,f,o?``:n,r,i);for(let n of t.children.values())C(e,n,f,r,p);a||r.pop()}function pe(e,t,n,r,i,a){let o=_e(n,r),s=Object.freeze([...i]),c=me(s),l=b(n),u=Ke(e.rootQueryParams,i),d=qe(i),{buildStaticParts:f,buildParamSlots:p}=Ge(o?b(r):l,o?i.slice(0,-1):i,e.options.urlParamsEncoding),m=p.map(e=>e.paramName),h=m.length===0?S:new Set(m);h.size!==m.length&&ke(t.fullName,m),je(t.fullName,u,h);let g={name:t.fullName,parent:a,depth:i.length-1,matchSegments:s,meta:c,declaredQueryParams:u,declaredQueryParamsSet:u.length===0?S:new Set(u),hasTrailingSlash:n.length>1&&n.endsWith(`/`),constraintPatterns:d,hasConstraints:d.size>0,buildStaticParts:f,buildParamSlots:p,buildParamNamesSet:h,cachedResult:void 0};return t.paramMeta.urlParams.length===0&&(g.cachedResult=Object.freeze({segments:g.matchSegments,params:de,meta:g.meta})),e.routesByName.set(t.fullName,g),o?he(e,g,r):ge(e,g,n,l,t),g}function me(e){let t={};for(let n of e)t[n.fullName]=n.paramTypeMap;return Object.freeze(t)}function he(e,t,n){Ve(e,t,n);let r=b(n),i=e.options.caseSensitive?r:r.toLowerCase();e.staticCache.has(i)&&e.staticCache.set(i,t)}function ge(e,t,n,r,i){if(Be(e,t,n),i.paramMeta.urlParams.length===0){let n=e.options.caseSensitive?r:r.toLowerCase();e.staticCache.set(n,t)}}function _e(e,t){return b(e)===b(t)}function w(e,t,n){throw Error(`[SegmentMatcher.registerTree] Parameter name conflict at the same path position: '${n}${e}' and '${n}${t}'. A parametric URL segment binds to a single name across every route that shares that position — the value cannot be captured under two names. Rename one so both routes agree (e.g. use '${n}${e}' in both).`)}function T(){throw Error(`[SegmentMatcher.registerTree] Empty parameter name: a parameter marker (':' or '*') or an optional '?' must be followed by a name (e.g. ':id', '*rest', ':id?'). A name-less marker or modifier would capture under an empty key at match but emit a literal at build — the two disagree, so it is rejected.`)}function ve(e){throw Error(`[SegmentMatcher.registerTree] Fused parameter marker in segment "${e}": a ':'/'*' marker must begin a segment (e.g. 'a/:b', not 'a:b'). build extracts it as a param while the trie treats the segment as a literal — the two disagree.`)}function ye(e){for(let t=0;t<e.length;t++)if(e.charCodeAt(t)>=128)return!0;return!1}function be(e){let t=e.split(`/`);for(let e=2;e<t.length;e++)if(t[e].startsWith(`*`)&&E(t[e-1])&&E(t[e-2]))return!0;return!1}function E(e){return e.startsWith(`:`)&&e.endsWith(`?`)}function xe(e){throw Error(`[SegmentMatcher.registerTree] Two optional params directly before a splat in "${e}": a single trie slot carries only one optional→splat fork, so the outer optional would overwrite the inner and the omit-outer/take-inner form would silently reshape into the splat. Split into separate routes, or drop the '?' on one.`)}function Se(e){throw Error(`[SegmentMatcher.registerTree] Non-ASCII static segment "${e}": match rejects non-ASCII input and compares static keys raw, so this route would never match. Percent-encode it (e.g. "/caf%C3%A9") or use a param.`)}function Ce(e){throw Error(`[SegmentMatcher.registerTree] Optional splat "${e}" is not supported: a splat cannot be optional — build emits multi-segment URLs the matcher rejects. Use a required splat "*name".`)}function we(e){throw Error(`[SegmentMatcher.registerTree] Optional param ":${e}?" before a splat must be constrained: an unconstrained optional before a splat is ambiguous (every multi-segment value has two readings). Add a constraint, e.g. ":${e}<[a-z]+>?", or model it as two routes.`)}function Te(e){throw Error(`[SegmentMatcher.registerTree] Unbalanced constraint delimiter ('<' or '>') in path "${e}": every '<' must be closed by a '>'. A stray delimiter desyncs match vs build (buildPath would emit a URL match rejects).`)}function Ee(e){throw Error(`[SegmentMatcher.registerTree] Empty constraint '<>' in path "${e}": a constraint body must be non-empty (e.g. '<[0-9]+>'). An empty '<>' compiles to a never-matching pattern.`)}function De(e){for(let t=0;t<e.length;t++){if(e[t]!==`>`)continue;let n=e.charAt(t+1);if(n!==``&&n!==`/`&&n!==`?`)return!0}return!1}function Oe(e){throw Error(`[SegmentMatcher.registerTree] Text fused to a constraint '>' in path "${e}": a '<...>' constraint must end its segment or be followed by '/' or an optional '?' — use "/:id<...>/rest", not "/:id<...>rest".`)}function ke(e,t){let n=new Set,r=``;for(let e of t){if(n.has(e)){r=e;break}n.add(e)}throw Error(`[SegmentMatcher.registerTree] Duplicate parameter name ':${r}' in route "${e}": a param name must be unique within a route — two positions cannot both bind ':${r}' (the second silently overwrites the first). Rename one.`)}const Ae=/[<>]/u;function je(e,t,n){for(let r of t)Ae.test(r)&&Me(e,r),n.has(r)&&Ne(e,r)}function Me(e,t){throw Error(`[SegmentMatcher.registerTree] Invalid query-param declaration "${t}" in route "${e}": a query-param name cannot contain '<' or '>'. This is a reverse-order modifier typo that leaked a constraint into the query — put the optional '?' AFTER the constraint (':id<...>?', not ':id?<...>'). It would never round-trip.`)}function Ne(e,t){throw Error(`[SegmentMatcher.registerTree] Name collision in route "${e}": "${t}" is declared as BOTH a path param (':${t}') and a query param ('?${t}'). buildPath would emit its value twice (once in the path, once in the query). Rename one.`)}function D(e,t){e.route!==void 0&&e.route!==t&&e.routeIsStrong===!0&&Pe(e.route.name,t.name),e.route=t,e.routeIsStrong=!0}function Pe(e,t){throw Error(`[SegmentMatcher.registerTree] Duplicate route path: routes "${e}" and "${t}" resolve to the same URL. The later registration would silently shadow the earlier (its deep link would resolve to the other route). Give them distinct paths.`)}const Fe=RegExp(`^[:*](${l})`),Ie=RegExp(`[:*]${l}`);function O(e){let t=Fe.exec(e)?.[1]??``;return t===``&&T(),t}function k(e,t,n){return e.paramChild?e.paramChild.name!==t&&!n.has(e)&&w(e.paramChild.name,t,`:`):(e.paramChild={node:y(),name:t,fork:void 0},n.add(e)),e.paramChild.node}function Le(e,t,n,r,i,a){let o=t.constraintPatterns.get(n)?.pattern;if(e.paramChild&&e.splatChild){o===void 0&&we(n),e.paramChild.fork={constraint:o};return}let s=i+1;if(s<=a){let t=r.indexOf(`/`,s),n=r.slice(s,t===-1?a:t);e.paramChild&&n.startsWith(`:`)&&!n.endsWith(`?`)&&(e.paramChild.fork={skipName:O(n)})}}function Re(e,t,n){if(!t.hasConstraints||!n.startsWith(`:`)||e.paramChild===void 0)return;let r=t.constraintPatterns.get(O(n))?.pattern;if(r===void 0)return;let i=e.paramChild;i.fork?.constraint===void 0?i.fork={...i.fork,constraint:r}:i.fork.constraint.source!==r.source&&(i.fork={...i.fork,constraint:RegExp(`(?:${i.fork.constraint.source})|(?:${r.source})`,i.fork.constraint.flags)})}function ze(e,t,n){return e.splatChild?e.splatChild.name!==t&&!n.has(e)&&w(e.splatChild.name,t,`*`):(e.splatChild={node:y(),name:t},n.add(e)),e.splatChild.node}function Be(e,t,n){let r=b(n);if(r===`/`){D(e.root,t);return}let i=new Set,a=new Map;A(e,e.root,r,1,t,i,a)}function A(e,t,n,r,i,a,o){let s=o.get(t);if(s===void 0)s=new Set,o.set(t,s);else if(s.has(r))return;s.add(r);let c=n.length;for(;r<=c;){let s=n.indexOf(`/`,r),l=s===-1?c:s,u=n.slice(r,l);if(u.endsWith(`?`)){u.startsWith(`*`)&&Ce(u);let r=O(u);A(e,k(t,r,a),n,l+1,i,a,o),l>=c?t.route??=i:A(e,t,n,l+1,i,a,o),Le(t,i,r,n,l,c);return}let d=t;t=j(e,t,u,a),Re(d,i,u),r=l+1}D(t,i)}function Ve(e,t,n){let r=n.slice(n.lastIndexOf(`/`)+1),i=n.split(`/`).some(e=>e.startsWith(`:`)&&e.endsWith(`?`)),a=r.startsWith(`*`);(i||a)&&He(t.name,n);let o=Ue(e,n);o.slashChildRoute=t}function He(e,t){throw Error(`[SegmentMatcher.registerTree] Index route "${e}" (path "/") under the dynamic parent "${t}" is not supported: the index cannot reliably replace the parent on every form of its path — under an optional param it binds only the present form, under a splat it is unreachable. Give the index a distinct path, or make the parent static.`)}function Ue(e,t){return We(e,e.root,t)}function We(e,t,n){let r=b(n);if(r===`/`||r===``)return t;let i=t,a=1,o=r.length,s=new Set;for(;a<=o;){let t=r.indexOf(`/`,a),n=t===-1?o:t;if(n<=a)break;let c=r.slice(a,n);i=j(e,i,c,s),a=n+1}return i}function j(e,t,n,r){if(n.startsWith(`*`)){let e=n.slice(1);e===``&&T();let i=ze(t,e,r);return t.hasChildren=!0,i}if(n.startsWith(`:`)){let e=k(t,O(n),r);return t.hasChildren=!0,e}Ie.test(n)&&ve(n),ye(n)&&Se(n);let i=e.options.caseSensitive?n:n.toLowerCase();return i in t.staticChildren||(t.staticChildren[i]=y(),t.hasChildren=!0),t.staticChildren[i]}function Ge(e,t,n){let r=new Set,i=new Set;for(let e of t){for(let t of e.paramMeta.urlParams)r.add(t);for(let t of e.paramMeta.spatParams)i.add(t)}if(r.size===0)return{buildStaticParts:[e],buildParamSlots:ue};let a=[],s=[],c=new RegExp(String.raw`[:*](${l})(?:<${o}>)?(\?)?`,`gu`),u=0,d;for(;(d=c.exec(e))!==null;){let t=d[1],r=d[2]===`?`;a.push(e.slice(u,d.index));let o=i.has(t)?e=>ae(e,n,!0):v[n];s.push({paramName:t,isOptional:r,encoder:o}),u=d.index+d[0].length}return a.push(e.slice(u)),{buildStaticParts:a,buildParamSlots:s}}function Ke(e,t){let n=[];e.length>0&&n.push(...e);for(let e of t)e.paramMeta.queryParams.length>0&&n.push(...e.paramMeta.queryParams);return n.length===0?ce:n}function qe(e){let t=new Map;for(let n of e)for(let[e,r]of n.paramMeta.constraintPatterns)t.set(e,r);return t.size===0?le:t}function Je(e){return typeof e==`string`?e:typeof e==`object`?JSON.stringify(e):String(e)}function M(e,t,n){t===`__proto__`?Object.defineProperty(e,t,{value:n,writable:!0,enumerable:!0,configurable:!0}):e[t]=n}var Ye=class{get options(){return this.#e}#e;#t=y();#n=new Map;#r=new Map;#i={cleanPath:``,normalized:``,queryString:void 0};#a=[];#o=``;#s;#c;constructor(e){this.#e={caseSensitive:e.caseSensitive??!0,strictTrailingSlash:e.strictTrailingSlash??!1,strictQueryParams:e.strictQueryParams??!1,urlParamsEncoding:e.urlParamsEncoding??`default`,parseQueryString:e.parseQueryString,buildQueryString:e.buildQueryString},this.#s=this.#e.caseSensitive,this.#c=this.#e.urlParamsEncoding===`none`?null:ie[this.#e.urlParamsEncoding]}registerTree(e){this.#a=e.paramMeta.queryParams,C({root:this.#t,options:this.#e,routesByName:this.#n,staticCache:this.#r,rootQueryParams:this.#a},e,``,[],null)}match(e){if(!this.#p(e))return;let{cleanPath:t,normalized:n,queryString:r}=this.#i,i=this.#s?n:n.toLowerCase(),a=this.#r.get(i);if(a)return this.#e.strictTrailingSlash&&!this.#_(t,a)?void 0:r===void 0&&a.cachedResult?a.cachedResult:this.#h(a,{},r);let o={},s=this.#v(n,o);if(s&&!(this.#e.strictTrailingSlash&&!this.#_(t,s))&&this.#S(o)&&!(s.hasConstraints&&!this.#w(o,s)))return this.#h(s,o,r)}buildPath(e,t,n){let r=this.#n.get(e);if(!r)throw Error(`[SegmentMatcher.buildPath] '${e}' is not defined`);r.hasConstraints&&t&&this.#l(r,e,t);let i=this.#u(r,t),a=this.#d(i,n?.trailingSlash),o=this.#f(r,t,n?.queryParamsMode);return a+(o?`?${o}`:``)}getSegmentsByName(e){return this.#n.get(e)?.matchSegments}getMetaByName(e){return this.#n.get(e)?.meta}hasRoute(e){return this.#n.has(e)}#l(e,t,n){for(let[r,i]of e.constraintPatterns){let e=n[r];if(e!=null){let n=typeof e==`object`?JSON.stringify(e):String(e);if(!i.pattern.test(n))throw Error(`[SegmentMatcher.buildPath] '${t}' — param '${r}' value '${n}' does not match constraint '${i.constraint}'`)}}}#u(e,t){let n=e.buildStaticParts,r=e.buildParamSlots;if(r.length===0)return n[0];let i=n[0];for(let[e,a]of r.entries()){let r=t?.[a.paramName];if(r==null){if(!a.isOptional)throw Error(`[SegmentMatcher.buildPath] Missing required param '${a.paramName}'`);i.length>1?i=i.slice(0,-1):n[e+1].startsWith(`/`)&&(i=``),i+=n[e+1];continue}if(r===``&&!a.isOptional)throw Error(`[SegmentMatcher.buildPath] Missing required param '${a.paramName}' (empty string)`);let o=a.encoder(Je(r));i+=o+n[e+1]}return i}#d(e,t){return t===`always`&&!e.endsWith(`/`)?`${e}/`:t===`never`&&e!==`/`&&e.endsWith(`/`)?e.slice(0,-1):e}#f(e,t,n){if(!t||e.declaredQueryParams.length===0&&n!==`loose`)return``;let r={},i=!1;for(let n of e.declaredQueryParams)n in t&&(r[n]=t[n],i=!0);if(n===`loose`)for(let n in t)Object.hasOwn(t,n)&&!e.declaredQueryParamsSet.has(n)&&!e.buildParamNamesSet.has(n)&&(r[n]=t[n],i=!0);return i?this.#e.buildQueryString(r):``}#p(e){if(e===``&&(e=`/`),e.codePointAt(0)!==47)return!1;let t=this.#m(e);if(t===-2)return!1;t===-3&&(e=this.#o);let n=t>=0?e.slice(0,t):e,r=t>=0?e.slice(t+1):void 0;if(r!==void 0){let e=r.indexOf(`#`);e!==-1&&(r=r.slice(0,e))}let i=b(n);return this.#i.cleanPath=n,this.#i.normalized=i,this.#i.queryString=r,!0}#m(e){let t=!1;for(let n=0;n<e.length;n++){let r=e.codePointAt(n);if(r===35)return this.#o=e.slice(0,n),-3;if(r===63)return n;if(r>=128)return-2;if(r===47){if(t)return-2;t=!0}else t=!1}return-1}#h(e,t,n){if(!(n!==void 0&&!this.#g(e,t,n)))return{segments:e.matchSegments,params:t,meta:e.meta}}#g(e,t,n){let r;try{r=this.#e.parseQueryString(n)}catch{return!1}if(this.#e.strictQueryParams){let n=e.declaredQueryParamsSet;for(let e in r){if(!n.has(e))return!1;M(t,e,r[e])}}else for(let e in r)M(t,e,r[e]);return!0}#_(e,t){return(e.length>1&&e.endsWith(`/`))===t.hasTrailingSlash}#v(e,t){return e.length===1?this.#t.slashChildRoute??this.#t.route:this.#y(this.#t,e,1,t)}#y(e,t,n,r){let i=e,a=t.length,o=this.#s;for(;n<=a;){let e=t.indexOf(`/`,n),s=e===-1?a:e,c=t.slice(n,s),l=o?c:c.toLowerCase(),u;if(l in i.staticChildren)u=i.staticChildren[l];else if(i.paramChild){let e=i.paramChild,o=e.fork;if(i.splatChild!==void 0){if(o?.constraint!==void 0&&!this.#x(o.constraint,c))return this.#b(i.splatChild,t,n,r);let l={[o?.skipName!==void 0&&s>=a?o.skipName:e.name]:c},u=this.#y(e.node,t,s+1,l);return u!==void 0&&(!u.hasConstraints||this.#C(u,l))?(Object.assign(r,l),u):this.#b(i.splatChild,t,n,r)}u=e.node,o?.skipName!==void 0&&s>=a?r[o.skipName]=c:r[e.name]=c}else if(i.splatChild)return this.#b(i.splatChild,t,n,r);else return;i=u,n=s+1}return i.slashChildRoute??i.route}#b(e,t,n,r){let i=e.node;if(!i.hasChildren)return r[e.name]=t.slice(n),i.route;let a={},o=this.#y(i,t,n,a);return o&&(!o.hasConstraints||this.#C(o,a))?(Object.assign(r,a),o):(r[e.name]=t.slice(n),i.route)}#x(e,t){try{return e.test(this.#c?this.#c(t):t)}catch{return!1}}#S(e){let t=this.#c;if(!t)return!0;for(let n in e){let r=e[n];if(r.includes(`%`)){if(!se(r))return!1;try{e[n]=t(r)}catch{return!1}}}return!0}#C(e,t){let n=this.#c;for(let[r,i]of e.constraintPatterns){if(!Object.hasOwn(t,r))continue;let e=t[r];if(n&&e.includes(`%`))try{e=n(e)}catch{return!1}if(!i.pattern.test(e))return!1}return!0}#w(e,t){for(let[n,r]of t.constraintPatterns)if(Object.hasOwn(e,n)&&!r.pattern.test(e[n]))return!1;return!0}};const N=e=>{let t=e.indexOf(`%`),n=e.indexOf(`+`);if(t===-1&&n===-1)return e;let r=n===-1?e:e.replaceAll(`+`,` `);return t===-1?r:decodeURIComponent(r)},P=(e,t)=>{if(e===void 0)return t.boolean.decodeUndefined();let n=t.boolean.decodeRaw(e);if(n!==null)return n;let r=N(e),i=t.number.decode(r);return i===null?t.boolean.decodeValue(r):i},F=e=>{let t=typeof e;if(t!==`string`&&t!==`number`&&t!==`boolean`)throw TypeError(`[search-params] Array element must be a string, number, or boolean — received ${t}`);return encodeURIComponent(e)},I=(e,t,n,r)=>{let i=`${e}${n}`,a=[];for(let e of t)if(e===null){let e=r.encode(i);e&&a.push(e)}else a.push(`${i}=${F(e)}`);return a.join(`&`)},L={none:{encodeArray:(e,t,n)=>I(e,t,``,n)},brackets:{encodeArray:(e,t,n)=>I(e,t,`[]`,n)},index:{encodeArray:(e,t,n)=>{let r=[];for(let[i,a]of t.entries()){let t=`${e}[${i}]`;if(a===null){let e=n.encode(t);e&&r.push(e)}else r.push(`${t}=${F(a)}`)}return r.join(`&`)},indexed:!0},comma:{encodeArray:(e,t)=>{let n=[];for(let e of t)e!==null&&n.push(F(e));return n.length===0?``:`${e}=${n.join(`,`)}`},decodeValue:e=>e.includes(`,`)?e.split(`,`):null}},R={none:{encode:(e,t)=>`${e}=${t}`,decodeUndefined:()=>null,decodeRaw:()=>null,decodeValue:e=>e},auto:{encode:(e,t)=>`${e}=${t}`,decodeUndefined:()=>null,decodeRaw:e=>e===`true`?!0:e===`false`?!1:null,decodeValue:e=>e},"empty-true":{encode:(e,t)=>t?e:`${e}=false`,decodeUndefined:()=>!0,decodeRaw:e=>e===`true`?!0:e===`false`?!1:null,decodeValue:e=>e}},z={default:{encode:e=>e},hidden:{encode:()=>``}},B={auto:{decode:e=>{let t=e.length;if(t===0)return null;let n=+(e.codePointAt(0)===45);if(n===t||t-n>1&&e.codePointAt(n)===48&&e.codePointAt(n+1)!==46)return null;let r=!1;for(let i=n;i<t;i++){let a=e.codePointAt(i);if(!(a!==void 0&&a>=48&&a<=57)){if(a===46&&!r&&i!==n&&i!==t-1){r=!0;continue}return null}}let i=Number(e);return Object.is(i,-0)||!Number.isSafeInteger(i)&&!r?null:i}},none:{decode:()=>null}},Xe=(e,t,n,r)=>({boolean:R[t],null:z[n],number:B[r],array:L[e]}),Ze={boolean:R.auto,null:z.default,number:B.auto,array:L.none},V={arrayFormat:`none`,booleanFormat:`auto`,nullFormat:`default`,numberFormat:`auto`},Qe={...V,strategies:Ze},H=e=>{if(!e||e.arrayFormat===void 0&&e.booleanFormat===void 0&&e.nullFormat===void 0&&e.numberFormat===void 0)return Qe;let t=e.arrayFormat??V.arrayFormat,n=e.booleanFormat??V.booleanFormat,r=e.nullFormat??V.nullFormat,i=e.numberFormat??V.numberFormat;return{arrayFormat:t,booleanFormat:n,nullFormat:r,numberFormat:i,strategies:Xe(t,n,r,i)}},U=e=>encodeURIComponent(e),$e=(e,t,n)=>{let r=U(e);switch(typeof t){case`string`:case`number`:return`${r}=${U(t)}`;case`boolean`:return n.strategies.boolean.encode(r,t);case`object`:return t===null?n.strategies.null.encode(r):Array.isArray(t)?n.strategies.array.encodeArray(r,t,n.strategies.null):`${r}=${U(t)}`;default:return`${r}=${U(t)}`}};function W(e,t,n){t===`__proto__`?Object.defineProperty(e,t,{value:n,writable:!0,enumerable:!0,configurable:!0}):e[t]=n}function G(e,t,n,r){if(!Object.hasOwn(e,t)){W(e,t,r?[n]:n);return}let i=e[t];Array.isArray(i)?i.push(n):W(e,t,[i,n])}function K(e,t,n,r,i){return P(r?e.slice(t+1,n):void 0,i)}function et(e,t,n){let r=t+1,i=0,a=!1;for(;r<n;){let t=e.codePointAt(r);if(t===93)return a?i:null;if(t!==void 0&&t>=48&&t<=57){i=i*10+(t-48),a=!0,r++;continue}return null}return null}function tt(e,t,n){let{searchPart:r,nameEnd:i,nameSourceEnd:a,eqPos:o,end:s,hasValue:c,decodedName:l}=e,u=et(r,i,a);if(u===null)return!1;let d=K(r,o,s,c,t),f=n.get(l);return f===void 0?n.set(l,[[u,d]]):f.push([u,d]),!0}function nt(e,t,n,r,i,a){let o=e.indexOf(`=`,t),s=o!==-1&&o<n,c=s?o:n,l=c,u=!1;for(let n=t;n<c;n++)if(e.codePointAt(n)===91){l=n,u=!0;break}let d=N(e.slice(t,l));if(!(a!==void 0&&u&&tt({searchPart:e,nameEnd:l,nameSourceEnd:c,eqPos:o,end:n,hasValue:s,decodedName:d},i,a))){if(!u&&s&&i.array.decodeValue){let t=e.slice(o+1,n),a=i.array.decodeValue(t);if(a){for(let e of a)G(r,d,P(e,i),!0);return}}G(r,d,K(e,o,n,s,i),u)}}const rt=(e,t)=>{if(e===``||e===`?`)return{};let n={};return it(e,n,H(t).strategies),n};function it(e,t,n){let r=n.array.indexed?new Map:void 0,i=0,a=e.length;for(;i<a;){let o=e.indexOf(`&`,i);o===-1&&(o=a),o>i&&nt(e,i,o,t,n,r),i=o+1}if(r!==void 0)for(let[e,n]of r)n.sort((e,t)=>e[0]-t[0]),W(t,e,n.map(e=>e[1]))}const at=(e,t)=>{let n=Object.keys(e);if(n.length===0)return``;let r=H(t),i=[];for(let t of n){let n=e[t];if(n===void 0)continue;let a=$e(t,n,r);a&&i.push(a)}return i.join(`&`)};function q(e,t){let n=e.path,r=n.startsWith(`~`),i=r?n.slice(1):n,a={name:e.name,path:i,absolute:r,children:[],parent:t};if(e.children)for(let t of e.children){let e=q(t,a);a.children.push(e)}return a}function ot(e,t,n){let r=q({name:e,path:t},null);for(let e of n){let t=q(e,r);r.children.push(t)}return r}const st=Object.freeze(new Map),ct=Object.freeze([]);function lt(e){return e.parent?.name?`${e.parent.fullName}.${e.name}`:e.name}function ut(e){let t=new Map;for(let n of e)t.set(n.name,n);return t}function dt(e,t,n){let r=[],i=[];for(let a of e){let e=J(a,t,n);r.push(e),e.absolute||i.push(e)}return{childrenMap:ut(r),nonAbsoluteChildren:i}}function J(e,t,n){let r=_(e.path),i=r.paramTypeMap,a={name:e.name,path:e.path,absolute:e.absolute,parent:t,children:void 0,paramMeta:r,nonAbsoluteChildren:void 0,fullName:``,paramTypeMap:i};if(a.fullName=lt(a),e.children.length===0)a.children=st,a.nonAbsoluteChildren=ct;else{let{childrenMap:t,nonAbsoluteChildren:r}=dt(e.children,a,n);a.children=t,a.nonAbsoluteChildren=r}return n&&(e.children.length>0&&(Object.freeze(a.nonAbsoluteChildren),Object.freeze(a.children)),Object.freeze(i),Object.freeze(r.urlParams),Object.freeze(r.queryParams),Object.freeze(r.spatParams),Object.freeze(r),Object.freeze(a)),a}function ft(e,t=!0){return J(e,null,t)}function pt(e,t){let n=[],r={add(e){return n.push(e),r},addMany(e){return n.push(...e),r},build(r){return ft(ot(e,t,n),!r?.skipFreeze)}};return r}function mt(e,t,n,r){return pt(e,t).addMany(n).build(r)}function Y(e){let t=e.absolute?`~${e.path}`:e.path,n={name:e.name,path:t};return e.children.size>0&&(n.children=Array.from(e.children.values(),Y)),n}function ht(e){return Array.from(e.children.values(),Y)}function gt(e){let t=e?.queryParams;return new Ye({...e?.caseSensitive!==void 0&&{caseSensitive:e.caseSensitive},...e?.strictTrailingSlash!==void 0&&{strictTrailingSlash:e.strictTrailingSlash},...e?.strictQueryParams!==void 0&&{strictQueryParams:e.strictQueryParams},...e?.urlParamsEncoding!==void 0&&{urlParamsEncoding:e.urlParamsEncoding},parseQueryString:e=>rt(e,t),buildQueryString:e=>at(e,t)})}function X(e,t){return TypeError(`[router.${e}] ${t}`)}function _t(e,t,n){if(!s(e))throw X(n,`Invalid path for route "${t}": unbalanced constraint delimiter ('<' or '>') in "${e}"`);if(e.includes(`<>`))throw X(n,`Invalid path for route "${t}": empty constraint '<>' in "${e}" (a constraint body must be non-empty, e.g. '<[0-9]+>')`)}function vt(e,t,n,r){let i=new Set;for(let a of e){if(i.has(a))throw X(n,`Invalid path for route "${t}": duplicate parameter name ':${a}' in "${r}" (a param name must be unique within a route — the second binding would overwrite the first)`);i.add(a)}}const yt=/[<>]/u;function bt(e,t,n,r,i){let a=new Set(e);for(let e of t){if(yt.test(e))throw X(r,`Invalid path for route "${n}": invalid query-param name "${e}" in "${i}" (a query-param name cannot contain '<' or '>' — a reverse-order modifier typo that leaked a constraint into the query; put the optional '?' after the constraint, ':id<...>?')`);if(a.has(e))throw X(r,`Invalid path for route "${n}": "${e}" is declared as both a path param and a query param in "${i}" — buildPath would emit its value twice (rename one)`)}}const xt=RegExp(`[:*](?!${l})`);function St(e){let t=!0,n=!1;for(let r of e)if(r===`/`)t=!0;else if(t)n=r===`:`||r===`*`,t=!1;else if((r===`:`||r===`*`)&&!n)return!0;return!1}function Ct(e){for(let t=0;t<e.length;t++){if(e[t]!==`>`)continue;let n=e.charAt(t+1);if(n!==``&&n!==`/`&&n!==`?`)return!0}return!1}function wt(e){let t=!0,n=!1,r=!1;for(let i of e){if(r){r=i!==`>`;continue}if(i===`<`){r=!0;continue}if(i===`/`){t=!0;continue}if(t&&=(n=i===`:`||i===`*`,!1),!n&&i.codePointAt(0)>=128)return!0}return!1}function Tt(e){let t=!0,n=!1;for(let r of e)if(r===`/`)t=!0,n=!1;else if(t)n=r===`*`,t=!1;else if(r===`?`&&n)return!0;return!1}function Et(e){for(let t=1;t<e.length;t++)if(e[t]===`?`&&e[t-1]!==`>`&&e[t+1]===`/`&&e[t+2]===`*`)return!0;return!1}function Dt(e,t,n,r){if(typeof e!=`string`){let t;throw t=e===null?`null`:Array.isArray(e)?`array`:typeof e,X(n,`Route path must be a string, got ${t}`)}if(e===``)return;if(/\s/.test(e))throw X(n,`Invalid path for route "${t}": whitespace not allowed in "${e}"`);if(!/^([/?~]|[^/]+$)/.test(e))throw X(n,`Route "${t}" has invalid path format: "${e}". Path should start with '/', '~', '?' or be a relative segment.`);if(e.includes(`//`))throw X(n,`Invalid path for route "${t}": double slashes not allowed in "${e}"`);_t(e,t,n);let{pathPattern:i,urlParams:a,queryParams:o}=_(e);if(vt(a,t,n,e),bt(a,o,t,n,e),xt.test(i))throw X(n,`Invalid path for route "${t}": parameter marker (':' or '*') without a name in "${e}"`);if(St(i))throw X(n,`Invalid path for route "${t}": parameter marker (':' or '*') must begin a segment, but "${e}" fuses one to a static prefix (use a boundary marker like "/a/:b")`);if(Ct(i))throw X(n,`Invalid path for route "${t}": text fused to a constraint '>' in "${e}" (a '<...>' must end its segment or be followed by '/' or an optional '?' — use "/:id<...>/rest", not "/:id<...>rest")`);if(Tt(i))throw X(n,`Invalid path for route "${t}": optional splat ('*name?') is not supported in "${e}" — a splat cannot be optional (use a required splat '*name')`);if(Et(i))throw X(n,`Invalid path for route "${t}": an unconstrained optional param before a splat is not supported in "${e}" — it is ambiguous (every multi-segment value has two readings). Add a constraint (e.g. ':lang<[a-z]+>?') or model it as two routes`);if(wt(i))throw X(n,`Invalid path for route "${t}": non-ASCII static segment in "${e}" — match compares static segments raw and rejects non-ASCII input, so this route would never match. Percent-encode it (e.g. '/caf%C3%A9') or use a param`);let s=r&&r.paramMeta.urlParams.length>0;if(e.startsWith(`~`)&&s)throw X(n,`Absolute path "${e}" cannot be used under parent route with URL parameters`)}const Ot=/^[A-Z_a-z][\w-]*$/,kt=/\S/,Z=1e4;function Q(e){if(e===null)return`null`;if(typeof e==`object`){try{let t=e.constructor;if(typeof t==`function`&&t.name!==`Object`)return t.name||`object`}catch{}return`object`}return typeof e}function At(e){for(let t of Object.keys(e)){let n=Object.getOwnPropertyDescriptor(e,t);if(n&&(n.get||n.set))return!0}return!1}function jt(e,t){if(!e||typeof e!=`object`)throw TypeError(`[router.${t}] Route must be an object, got ${Q(e)}`);let n=Object.getPrototypeOf(e);if(n!==Object.prototype&&n!==null)throw TypeError(`[router.${t}] Route must be a plain object, got ${Q(e)}`);if(At(e))throw TypeError(`[router.${t}] Route must not have getters or setters`)}function Mt(e,t){if(e.encodeParams!==void 0&&typeof e.encodeParams!=`function`)throw TypeError(`[router.${t}] Route "${String(e.name)}" encodeParams must be a function`)}function Nt(e,t){if(e.decodeParams!==void 0&&typeof e.decodeParams!=`function`)throw TypeError(`[router.${t}] Route "${String(e.name)}" decodeParams must be a function`)}function Pt(e,t){if(typeof e.name!=`string`)throw TypeError(`[router.${t}] Route name must be a string, got ${Q(e.name)}`);let n=e.name;if(n===``)throw TypeError(`[router.${t}] Route name cannot be empty`);if(!kt.test(n))throw TypeError(`[router.${t}] Route name cannot contain only whitespace`);if(n.length>Z)throw TypeError(`[router.${t}] Route name exceeds maximum length of ${Z} characters`);if(!n.startsWith(`@@`)){if(n.includes(`.`))throw TypeError(`[router.${t}] Route name "${n}" cannot contain dots. Use children array or { parent } option in addRoute() instead.`);if(!Ot.test(n))throw TypeError(`[router.${t}] Invalid route name "${n}". Name must start with a letter or underscore, followed by letters, numbers, underscores, or hyphens.`)}}function $(e,t){if(!t.includes(`.`))return e.children.get(t);let n=e;for(let e of t.split(`.`))if(n=n.children.get(e),!n)return;return n}function Ft(e,t,n){if($(e,t))throw Error(`[router.${n}] Route "${t}" already exists`)}function It(e,t,n){if(e.has(t))throw Error(`[router.${n}] Duplicate route "${t}" in batch`);e.add(t)}function Lt(e,t,n,r){let i=t===``?e:$(e,t);if(i){for(let e of i.children.values())if(e.path===n)throw Error(`[router.${r}] Path "${n}" is already defined`)}}function Rt(e,t,n,r){let i=e.get(t);if(i?.has(n))throw Error(`[router.${r}] Path "${n}" is already defined`);i?i.add(n):e.set(t,new Set([n]))}function zt(e,t,n,r=``,i,a){jt(e,t);let o=e;Pt(o,t),Dt(o.path,o.name,t,n),Mt(o,t),Nt(o,t);let s=o.name,c=r?`${r}.${s}`:s;n&&c&&Ft(n,c,t),i&&It(i,c,t);let l=o.path,u=r;if(n&&Lt(n,u,l,t),a&&Rt(a,u,l,t),o.children!==void 0){if(!Array.isArray(o.children))throw TypeError(`[router.${t}] Route "${s}" children must be an array, got ${Q(o.children)}`);for(let e of o.children)zt(e,t,n,c,i,a)}}export{Y as a,i as c,gt as i,t as l,mt as n,V as o,ht as r,a as s,zt as t,n as u};
+//# sourceMappingURL=esm-DVWMs97_.mjs.map