@real-router/core 0.44.1 → 0.45.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/dist/cjs/{Router-C0qFcU9Q.js → Router-CF-hVxvn.js} +2 -2
- package/dist/cjs/Router-CF-hVxvn.js.map +1 -0
- package/dist/cjs/api.js +1 -1
- package/dist/cjs/api.js.map +1 -1
- package/dist/cjs/index.js +1 -1
- package/dist/esm/{Router-BrXjxABs.mjs → Router-BP_Wjnyr.mjs} +2 -2
- package/dist/esm/Router-BP_Wjnyr.mjs.map +1 -0
- package/dist/esm/api.mjs +1 -1
- package/dist/esm/api.mjs.map +1 -1
- package/dist/esm/index.mjs +1 -1
- package/package.json +3 -3
- package/src/api/getRoutesApi.ts +13 -2
- package/dist/cjs/Router-C0qFcU9Q.js.map +0 -1
- package/dist/esm/Router-BrXjxABs.mjs.map +0 -1
package/dist/esm/api.mjs
CHANGED
|
@@ -1,2 +1,2 @@
|
|
|
1
|
-
import{c as e,i as t,l as n,n as r,o as i,r as a,s as o,t as s,u as c}from"./Router-
|
|
1
|
+
import{c as e,i as t,l as n,n as r,o as i,r as a,s as o,t as s,u as c}from"./Router-BP_Wjnyr.mjs";import{c as l,t as u}from"./RouterError-BOUkCIgf.mjs";import{r as d,t as f}from"./internals-CCymabFj.mjs";import{n as p,t as m}from"./getPluginApi-BvOUPp3g.mjs";import{logger as h}from"@real-router/logger";function g(e,t,n){if(t){let n=t===e,r=t.startsWith(`${e}.`);if(n||r){let r=n?``:` (current: "${t}")`;return h.warn(`router.removeRoute`,`Cannot remove route "${e}" — it is currently active${r}. Navigate away first.`),!1}}return n&&h.warn(`router.removeRoute`,`Route "${e}" removed while navigation is in progress. This may cause unexpected behavior.`),!0}function _(e){return e?(h.error(`router.clearRoutes`,`Cannot clear routes while navigation is in progress. Wait for navigation to complete.`),!1):!0}function v(e,t,n=``){for(let r of e){let e=n?`${n}.${r.name}`:r.name;if(e===t)return r;if(r.children&&t.startsWith(`${e}.`))return v(r.children,t,e)}}function y(e,t,n,r){let a=t=>t===e||t.startsWith(`${e}.`);i(t.decoders,a),i(t.encoders,a),i(t.defaultParams,a),i(t.forwardMap,a),i(t.forwardFnMap,a),i(n,a),i(t.forwardMap,e=>a(t.forwardMap[e]));let[o,s]=r.getFactories();for(let e of Object.keys(s))a(e)&&r.clearCanActivate(e);for(let e of Object.keys(o))a(e)&&r.clearCanDeactivate(e)}function b(e,t,n,r){return t===null?(delete n.forwardMap[e],delete n.forwardFnMap[e]):typeof t==`string`?(delete n.forwardFnMap[e],n.forwardMap[e]=t):(delete n.forwardMap[e],n.forwardFnMap[e]=t),r(n)}function x(e,t,n,r){let i={name:e.name,path:e.path},a=n.forwardFnMap[t],o=n.forwardMap[t];a===void 0?o!==void 0&&(i.forwardTo=o):i.forwardTo=a,t in n.defaultParams&&(i.defaultParams=n.defaultParams[t]),t in n.decoders&&(i.decodeParams=n.decoders[t]),t in n.encoders&&(i.encodeParams=n.encoders[t]);let[s,c]=r;return t in c&&(i.canActivate=c[t]),t in s&&(i.canDeactivate=s[t]),e.children&&(i.children=e.children.map(e=>x(e,`${t}.${e.name}`,n,r))),i}function S(n,r,i){if(i){let t=v(n.definitions,i);t.children??=[];for(let n of r)t.children.push(e(n))}else for(let t of r)n.definitions.push(e(t));t(r,n.config,n.routeCustomFields,n.pendingCanActivate,n.pendingCanDeactivate,n.depsStore,i??``),n.treeOperations.commitTreeChanges(n)}function C(n,i,a,o){r(n),n.lifecycleNamespace.clearDefinitionGuards();for(let t of i)n.definitions.push(e(t));if(t(i,n.config,n.routeCustomFields,n.pendingCanActivate,n.pendingCanDeactivate,n.depsStore,``),n.treeOperations.commitTreeChanges(n),o!==void 0){let e=a.matchPath(o,a.getOptions());e?a.setState(e):a.clearState()}}function w(e,t){return o(e.definitions,t)?(y(t,e.config,e.routeCustomFields,e.lifecycleNamespace),e.treeOperations.commitTreeChanges(e),!0):!1}function T(e,t,n){if(n.forwardTo!==void 0&&(e.resolvedForwardMap=b(t,n.forwardTo,e.config,e=>a(e))),n.defaultParams!==void 0&&(n.defaultParams===null?delete e.config.defaultParams[t]:e.config.defaultParams[t]=n.defaultParams),n.decodeParams!==void 0)if(n.decodeParams===null)delete e.config.decoders[t];else{let r=n.decodeParams;e.config.decoders[t]=e=>r(e)??e}if(n.encodeParams!==void 0)if(n.encodeParams===null)delete e.config.encoders[t];else{let r=n.encodeParams;e.config.encoders[t]=e=>r(e)??e}}function E(e,t){let n=e.matcher.getSegmentsByName(t);if(!n)return;let r=n.at(-1),i=e.treeOperations.nodeToDefinition(r),a=e.lifecycleNamespace.getFactories();return x(i,t,e.config,a)}function D(e){let t=d(e),n=t.routeGetStore(),r=f(`add`,(e,t)=>{S(n,e,t?.parent)},t.interceptors);return{add:(e,i)=>{p(t.isDisposed);let a=Array.isArray(e)?e:[e],o=i?.parent;c(a,t.validator),o!==void 0&&t.validator?.routes.validateParentOption(o,n.tree),t.validator?.routes.throwIfInternalRouteInArray(a,`addRoute`),t.validator?.routes.validateAddRouteArgs(a),t.validator?.routes.validateRoutes(a,n),r(a,o===void 0?void 0:{parent:o})},remove:e=>{p(t.isDisposed),t.validator?.routes.validateRemoveRouteArgs(e),t.validator?.routes.throwIfInternalRoute(e,`removeRoute`),g(e,t.getStateName(),t.isTransitioning())&&(w(n,e)||h.warn(`router.removeRoute`,`Route "${e}" not found. No changes made.`))},update:(e,r)=>{p(t.isDisposed),t.validator?.routes.validateUpdateRouteBasicArgs(e,r),t.validator?.routes.throwIfInternalRoute(e,`updateRoute`);let{forwardTo:i,defaultParams:a,decodeParams:o,encodeParams:s,canActivate:c,canDeactivate:l}=r;t.validator?.routes.validateUpdateRoutePropertyTypes(e,r),t.isTransitioning()&&h.error(`router.updateRoute`,`Updating route "${e}" while navigation is in progress. This may cause unexpected behavior.`),t.validator?.routes.validateUpdateRoute(e,r,n),T(n,e,{forwardTo:i,defaultParams:a,decodeParams:o,encodeParams:s}),c!==void 0&&(c===null?n.lifecycleNamespace.clearCanActivate(e):n.lifecycleNamespace.addCanActivate(e,c,!0)),l!==void 0&&(l===null?n.lifecycleNamespace.clearCanDeactivate(e):n.lifecycleNamespace.addCanDeactivate(e,l,!0))},clear:()=>{p(t.isDisposed),_(t.isTransitioning())&&(n.treeOperations.resetStore(n),n.lifecycleNamespace.clearAll(),t.clearState())},has:e=>(t.validator?.routes.validateRouteName(e,`hasRoute`),n.matcher.hasRoute(e)),get:e=>(t.validator?.routes.validateRouteName(e,`getRoute`),E(n,e)),replace:r=>{p(t.isDisposed);let i=Array.isArray(r)?r:[r];if(!_(t.isTransitioning()))return;c(i,t.validator),t.validator?.routes.throwIfInternalRouteInArray(i,`replaceRoutes`),t.validator?.routes.validateAddRouteArgs(i),t.validator?.routes.validateRoutes(i,n);let a=e.getState()?.path;C(n,i,t,a)}}}function O(e,t,n,r){if(n===void 0)return!1;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`)}return e.dependencies[t]=n,!0}function k(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 A(e){let t=d(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)=>{p(t.isDisposed),t.validator?.dependencies.validateSetDependencyArgs(e,n,`setDependency`),O(t.dependenciesGetStore(),e,n,t.validator)},setAll:e=>{p(t.isDisposed);let n=t.dependenciesGetStore();t.validator?.dependencies.validateDependenciesObject(e,`setDependencies`),t.validator?.dependencies.validateDependencyLimit(n,n.limits),k(n,e,t.validator)},remove:e=>{p(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:()=>{p(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))}}function j(e){let t=d(e),n=t.routeGetStore().lifecycleNamespace;return{addActivateGuard(e,r){p(t.isDisposed),t.validator?.routes.validateRouteName(e,`addActivateGuard`),t.validator?.lifecycle.validateHandler(r,`addActivateGuard`);let i=n.getHandlerCount(`activate`);t.validator?.lifecycle.validateHandlerLimit(i,t.dependenciesGetStore().limits,`canActivate`),n.addCanActivate(e,r)},addDeactivateGuard(e,r){p(t.isDisposed),t.validator?.routes.validateRouteName(e,`addDeactivateGuard`),t.validator?.lifecycle.validateHandler(r,`addDeactivateGuard`);let i=n.getHandlerCount(`deactivate`);t.validator?.lifecycle.validateHandlerLimit(i,t.dependenciesGetStore().limits,`canDeactivate`),n.addCanDeactivate(e,r)},removeActivateGuard(e){p(t.isDisposed),t.validator?.routes.validateRouteName(e,`removeActivateGuard`),n.clearCanActivate(e)},removeDeactivateGuard(e){p(t.isDisposed),t.validator?.routes.validateRouteName(e,`removeDeactivateGuard`),n.clearCanDeactivate(e)}}}function M(e,t){let r=d(e);if(r.isDisposed())throw new u(l.ROUTER_DISPOSED);r.validator?.dependencies.validateCloneArgs(t);let i=r.routeGetStore(),a=n(i.tree),o=i.config,c=i.resolvedForwardMap,f=i.routeCustomFields,p=r.cloneOptions(),m=r.cloneDependencies(),[h,g]=r.getLifecycleFactories(),_=r.getPluginFactories(),v=new s(a,p,{...m,...t}),y=j(v);for(let[e,t]of Object.entries(h))y.addDeactivateGuard(e,t);for(let[e,t]of Object.entries(g))y.addActivateGuard(e,t);_.length>0&&v.usePlugin(..._);let b=d(v).routeGetStore();return Object.assign(b.config.decoders,o.decoders),Object.assign(b.config.encoders,o.encoders),Object.assign(b.config.defaultParams,o.defaultParams),Object.assign(b.config.forwardMap,o.forwardMap),Object.assign(b.config.forwardFnMap,o.forwardFnMap),Object.assign(b.resolvedForwardMap,c),Object.assign(b.routeCustomFields,f),v}export{M as cloneRouter,A as getDependenciesApi,j as getLifecycleApi,m as getPluginApi,D as getRoutesApi};
|
|
2
2
|
//# sourceMappingURL=api.mjs.map
|
package/dist/esm/api.mjs.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"api.mjs","names":["routeTreeToDefinitions","RouterClass"],"sources":["../../src/namespaces/RoutesNamespace/routeGuards.ts","../../src/api/getRoutesApi.ts","../../src/api/getDependenciesApi.ts","../../src/api/getLifecycleApi.ts","../../src/api/cloneRouter.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\";\n\nimport { throwIfDisposed } from \"./helpers\";\nimport { guardRouteStructure } from \"../guards\";\nimport { getInternals } from \"../internals\";\nimport {\n clearConfigEntries,\n removeFromDefinitions,\n sanitizeRoute,\n} from \"../namespaces/RoutesNamespace/helpers\";\nimport {\n validateClearRoutes,\n validateRemoveRoute,\n} from \"../namespaces/RoutesNamespace/routeGuards\";\nimport {\n clearRouteData,\n refreshForwardMap,\n registerAllRouteHandlers,\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 Params,\n Router,\n} from \"@real-router/types\";\nimport type { RouteDefinition, RouteTree } from \"route-tree\";\n\n// ============================================================================\n// Helpers\n// ============================================================================\n\n/**\n * Recursively finds a route definition by its full dotted name.\n */\nfunction findDefinition(\n definitions: RouteDefinition[],\n fullName: string,\n parentPrefix = \"\",\n): RouteDefinition | undefined {\n for (const def of definitions) {\n const currentFullName = parentPrefix\n ? `${parentPrefix}.${def.name}`\n : def.name;\n\n if (currentFullName === fullName) {\n return def;\n }\n\n if (def.children && fullName.startsWith(`${currentFullName}.`)) {\n return findDefinition(def.children, fullName, currentFullName);\n }\n }\n\n /* v8 ignore next -- @preserve: defensive return, callers validate route exists before calling */\n return undefined;\n}\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 * Updates forwardTo for a route in config and returns the refreshed resolved\n * forward map (REPLACE semantics — caller must call ctx.setResolvedForwardMap).\n */\nfunction updateForwardTo<\n Dependencies extends DefaultDependencies = DefaultDependencies,\n>(\n name: string,\n forwardTo: string | ForwardToCallback<Dependencies> | null,\n config: RouteConfig,\n refreshForwardMapFn: (config: RouteConfig) => Record<string, string>,\n): Record<string, string> {\n if (forwardTo === null) {\n delete config.forwardMap[name];\n delete config.forwardFnMap[name];\n } else if (typeof forwardTo === \"string\") {\n delete config.forwardFnMap[name];\n config.forwardMap[name] = forwardTo;\n } else {\n delete config.forwardMap[name];\n config.forwardFnMap[name] = forwardTo;\n }\n\n return refreshForwardMapFn(config);\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 const forwardToFn = config.forwardFnMap[routeName];\n const forwardToStr = config.forwardMap[routeName];\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 (routeName in config.defaultParams) {\n route.defaultParams = config.defaultParams[routeName];\n }\n\n if (routeName in config.decoders) {\n route.decodeParams = config.decoders[routeName];\n }\n\n if (routeName in config.encoders) {\n route.encodeParams = config.encoders[routeName];\n }\n\n const [canDeactivateFactories, canActivateFactories] = factories;\n\n if (routeName in canActivateFactories) {\n route.canActivate = canActivateFactories[routeName];\n }\n\n if (routeName in canDeactivateFactories) {\n route.canDeactivate = canDeactivateFactories[routeName];\n }\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// 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 if (parentName) {\n // eslint-disable-next-line @typescript-eslint/no-non-null-assertion\n const parentDef = findDefinition(store.definitions, parentName)!;\n\n parentDef.children ??= [];\n\n for (const route of routes) {\n parentDef.children.push(sanitizeRoute(route));\n }\n } else {\n for (const route of routes) {\n store.definitions.push(sanitizeRoute(route));\n }\n }\n\n registerAllRouteHandlers(\n routes,\n store.config,\n store.routeCustomFields,\n store.pendingCanActivate,\n store.pendingCanDeactivate,\n store.depsStore,\n parentName ?? \"\",\n );\n\n store.treeOperations.commitTreeChanges(store);\n}\n\n/**\n * Atomically replaces all routes with a new set.\n * Follows RFC 6-step semantics for HMR support.\n */\nfunction replaceRoutes<\n Dependencies extends DefaultDependencies = DefaultDependencies,\n>(\n store: RoutesStore<Dependencies>,\n routes: Route<Dependencies>[],\n ctx: RouterInternals<Dependencies>,\n currentPath: string | undefined,\n): void {\n // Step 2: Clear route data (WITHOUT tree rebuild)\n clearRouteData(store);\n\n // Step 3: Clear definition lifecycle handlers (preserve external guards)\n // eslint-disable-next-line @typescript-eslint/no-non-null-assertion -- guaranteed set after wiring\n store.lifecycleNamespace!.clearDefinitionGuards();\n\n // Step 4: Register new routes\n for (const route of routes) {\n store.definitions.push(sanitizeRoute(route));\n }\n\n registerAllRouteHandlers(\n routes,\n store.config,\n store.routeCustomFields,\n store.pendingCanActivate,\n store.pendingCanDeactivate,\n store.depsStore,\n \"\",\n );\n\n // Step 5: One tree rebuild\n store.treeOperations.commitTreeChanges(store);\n\n // Step 6: Revalidate state\n if (currentPath !== undefined) {\n const revalidated = ctx.matchPath(currentPath, ctx.getOptions());\n\n if (revalidated) {\n ctx.setState(revalidated);\n } else {\n ctx.clearState();\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 store.treeOperations.commitTreeChanges(store);\n\n return true;\n}\n\n/**\n * Updates a route's configuration in place.\n */\nfunction updateRouteConfig<\n Dependencies extends DefaultDependencies = DefaultDependencies,\n>(\n store: RoutesStore<Dependencies>,\n name: string,\n updates: {\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 },\n): void {\n if (updates.forwardTo !== undefined) {\n store.resolvedForwardMap = updateForwardTo(\n name,\n updates.forwardTo,\n store.config,\n (config) => refreshForwardMap(config),\n );\n }\n\n if (updates.defaultParams !== undefined) {\n if (updates.defaultParams === null) {\n delete store.config.defaultParams[name];\n } else {\n store.config.defaultParams[name] = updates.defaultParams;\n }\n }\n\n if (updates.decodeParams !== undefined) {\n if (updates.decodeParams === null) {\n delete store.config.decoders[name];\n } else {\n const decoder = updates.decodeParams;\n\n store.config.decoders[name] = (params: Params): Params =>\n (decoder(params) as Params | undefined) ?? params;\n }\n }\n\n if (updates.encodeParams !== undefined) {\n if (updates.encodeParams === null) {\n delete store.config.encoders[name];\n } else {\n const encoder = updates.encodeParams;\n\n store.config.encoders[name] = (params: Params): Params =>\n (encoder(params) as Params | undefined) ?? params;\n }\n }\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 = store.treeOperations.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\nexport function getRoutesApi<\n Dependencies extends DefaultDependencies = DefaultDependencies,\n>(router: Router<Dependencies>): RoutesApi<Dependencies> {\n const ctx = getInternals(router);\n\n const store = ctx.routeGetStore();\n\n return {\n add: (routes, options) => {\n throwIfDisposed(ctx.isDisposed);\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\n remove: (name) => {\n throwIfDisposed(ctx.isDisposed);\n\n ctx.validator?.routes.validateRemoveRouteArgs(name);\n ctx.validator?.routes.throwIfInternalRoute(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 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 },\n\n update: (name, updates) => {\n throwIfDisposed(ctx.isDisposed);\n\n ctx.validator?.routes.validateUpdateRouteBasicArgs(name, updates);\n ctx.validator?.routes.throwIfInternalRoute(name, \"updateRoute\");\n\n const {\n forwardTo,\n defaultParams,\n decodeParams,\n encodeParams,\n canActivate,\n canDeactivate,\n } = updates;\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 updateRouteConfig(store, name, {\n forwardTo,\n defaultParams,\n decodeParams,\n encodeParams,\n });\n\n if (canActivate !== undefined) {\n if (canActivate === null) {\n // eslint-disable-next-line @typescript-eslint/no-non-null-assertion -- guaranteed set after wiring\n store.lifecycleNamespace!.clearCanActivate(name);\n } else {\n // eslint-disable-next-line @typescript-eslint/no-non-null-assertion -- guaranteed set after wiring\n store.lifecycleNamespace!.addCanActivate(name, canActivate, true);\n }\n }\n\n if (canDeactivate !== undefined) {\n if (canDeactivate === null) {\n // eslint-disable-next-line @typescript-eslint/no-non-null-assertion -- guaranteed set after wiring\n store.lifecycleNamespace!.clearCanDeactivate(name);\n } else {\n // eslint-disable-next-line @typescript-eslint/no-non-null-assertion -- guaranteed set after wiring\n store.lifecycleNamespace!.addCanDeactivate(name, canDeactivate, true);\n }\n }\n },\n\n clear: () => {\n throwIfDisposed(ctx.isDisposed);\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 store.treeOperations.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\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\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 currentPath = router.getState()?.path;\n\n replaceRoutes(store, routeArray, ctx, currentPath);\n },\n };\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): boolean {\n // undefined = \"don't set\" (feature for conditional setting)\n if (dependencyValue === undefined) {\n return false;\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 return true;\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 if (Object.hasOwn(store.dependencies, key)) {\n overwrittenKeys.push(key);\n } else {\n validator?.dependencies.validateDependencyCount(\n store,\n \"setDependencies\",\n );\n }\n\n (store.dependencies as Record<string, unknown>)[key] = deps[key];\n }\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(\n ctx.dependenciesGetStore(),\n name as string,\n value,\n ctx.validator,\n );\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 as string)) {\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(\n ctx.dependenciesGetStore().dependencies,\n name as string,\n );\n },\n };\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 const activateCount = lifecycleNamespace.getHandlerCount(\"activate\");\n\n ctx.validator?.lifecycle.validateHandlerLimit(\n activateCount,\n ctx.dependenciesGetStore().limits,\n \"canActivate\",\n );\n\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 const deactivateCount = lifecycleNamespace.getHandlerCount(\"deactivate\");\n\n ctx.validator?.lifecycle.validateHandlerLimit(\n deactivateCount,\n ctx.dependenciesGetStore().limits,\n \"canDeactivate\",\n );\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 { 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\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 options = ctx.cloneOptions();\n const sourceDeps = ctx.cloneDependencies();\n const [canDeactivateFactories, canActivateFactories] =\n ctx.getLifecycleFactories();\n const pluginFactories = ctx.getPluginFactories();\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 lifecycle = getLifecycleApi(newRouter);\n\n for (const [name, handler] of Object.entries(canDeactivateFactories)) {\n lifecycle.addDeactivateGuard(name, handler);\n }\n\n for (const [name, handler] of Object.entries(canActivateFactories)) {\n lifecycle.addActivateGuard(name, handler);\n }\n\n if (pluginFactories.length > 0) {\n newRouter.usePlugin(...pluginFactories);\n }\n\n const newCtx = getInternals(newRouter);\n const newStore = newCtx.routeGetStore();\n\n // Apply cloned config directly to new store\n Object.assign(newStore.config.decoders, routeConfig.decoders);\n Object.assign(newStore.config.encoders, routeConfig.encoders);\n Object.assign(newStore.config.defaultParams, routeConfig.defaultParams);\n Object.assign(newStore.config.forwardMap, routeConfig.forwardMap);\n Object.assign(newStore.config.forwardFnMap, routeConfig.forwardFnMap);\n Object.assign(newStore.resolvedForwardMap, resolvedForwardMap);\n Object.assign(newStore.routeCustomFields, routeCustomFields);\n\n return newRouter;\n}\n"],"mappings":"ySAYA,SAAgB,EACd,EACA,EACA,EACS,CACT,GAAI,EAAkB,CACpB,IAAM,EAAe,IAAqB,EACpC,EAAoB,EAAiB,WAAW,GAAG,EAAK,GAAG,CAEjE,GAAI,GAAgB,EAAmB,CACrC,IAAM,EAAS,EAAe,GAAK,eAAe,EAAiB,IAOnE,OALA,EAAO,KACL,qBACA,wBAAwB,EAAK,4BAA4B,EAAO,wBACjE,CAEM,IAWX,OAPI,GACF,EAAO,KACL,qBACA,UAAU,EAAK,gFAChB,CAGI,GAUT,SAAgB,EAAoB,EAAgC,CAUlE,OATI,GACF,EAAO,MACL,qBACA,wFACD,CAEM,IAGF,GCpBT,SAAS,EACP,EACA,EACA,EAAe,GACc,CAC7B,IAAK,IAAM,KAAO,EAAa,CAC7B,IAAM,EAAkB,EACpB,GAAG,EAAa,GAAG,EAAI,OACvB,EAAI,KAER,GAAI,IAAoB,EACtB,OAAO,EAGT,GAAI,EAAI,UAAY,EAAS,WAAW,GAAG,EAAgB,GAAG,CAC5D,OAAO,EAAe,EAAI,SAAU,EAAU,EAAgB,EAYpE,SAAS,EAGP,EACA,EACA,EACA,EACM,CACN,IAAM,EAAe,GACnB,IAAS,GAAa,EAAK,WAAW,GAAG,EAAU,GAAG,CAExD,EAAmB,EAAO,SAAU,EAAY,CAChD,EAAmB,EAAO,SAAU,EAAY,CAChD,EAAmB,EAAO,cAAe,EAAY,CACrD,EAAmB,EAAO,WAAY,EAAY,CAClD,EAAmB,EAAO,aAAc,EAAY,CACpD,EAAmB,EAAmB,EAAY,CAGlD,EAAmB,EAAO,WAAa,GACrC,EAAY,EAAO,WAAW,GAAK,CACpC,CAGD,GAAM,CAAC,EAAwB,GAC7B,EAAmB,cAAc,CAEnC,IAAK,IAAM,KAAQ,OAAO,KAAK,EAAqB,CAC9C,EAAY,EAAK,EACnB,EAAmB,iBAAiB,EAAK,CAI7C,IAAK,IAAM,KAAQ,OAAO,KAAK,EAAuB,CAChD,EAAY,EAAK,EACnB,EAAmB,mBAAmB,EAAK,CASjD,SAAS,EAGP,EACA,EACA,EACA,EACwB,CAYxB,OAXI,IAAc,MAChB,OAAO,EAAO,WAAW,GACzB,OAAO,EAAO,aAAa,IAClB,OAAO,GAAc,UAC9B,OAAO,EAAO,aAAa,GAC3B,EAAO,WAAW,GAAQ,IAE1B,OAAO,EAAO,WAAW,GACzB,EAAO,aAAa,GAAQ,GAGvB,EAAoB,EAAO,CAUpC,SAAS,EAGP,EACA,EACA,EACA,EAIqB,CACrB,IAAM,EAA6B,CACjC,KAAM,EAAS,KACf,KAAM,EAAS,KAChB,CAEK,EAAc,EAAO,aAAa,GAClC,EAAe,EAAO,WAAW,GAGnC,IAAgB,IAAA,GAGT,IAAiB,IAAA,KAC1B,EAAM,UAAY,GAHlB,EAAM,UAAY,EAMhB,KAAa,EAAO,gBACtB,EAAM,cAAgB,EAAO,cAAc,IAGzC,KAAa,EAAO,WACtB,EAAM,aAAe,EAAO,SAAS,IAGnC,KAAa,EAAO,WACtB,EAAM,aAAe,EAAO,SAAS,IAGvC,GAAM,CAAC,EAAwB,GAAwB,EAgBvD,OAdI,KAAa,IACf,EAAM,YAAc,EAAqB,IAGvC,KAAa,IACf,EAAM,cAAgB,EAAuB,IAG3C,EAAS,WACX,EAAM,SAAW,EAAS,SAAS,IAAK,GACtC,EAAY,EAAO,GAAG,EAAU,GAAG,EAAM,OAAQ,EAAQ,EAAU,CACpE,EAGI,EAWT,SAAS,EAGP,EACA,EACA,EACM,CACN,GAAI,EAAY,CAEd,IAAM,EAAY,EAAe,EAAM,YAAa,EAAW,CAE/D,EAAU,WAAa,EAAE,CAEzB,IAAK,IAAM,KAAS,EAClB,EAAU,SAAS,KAAK,EAAc,EAAM,CAAC,MAG/C,IAAK,IAAM,KAAS,EAClB,EAAM,YAAY,KAAK,EAAc,EAAM,CAAC,CAIhD,EACE,EACA,EAAM,OACN,EAAM,kBACN,EAAM,mBACN,EAAM,qBACN,EAAM,UACN,GAAc,GACf,CAED,EAAM,eAAe,kBAAkB,EAAM,CAO/C,SAAS,EAGP,EACA,EACA,EACA,EACM,CAEN,EAAe,EAAM,CAIrB,EAAM,mBAAoB,uBAAuB,CAGjD,IAAK,IAAM,KAAS,EAClB,EAAM,YAAY,KAAK,EAAc,EAAM,CAAC,CAiB9C,GAdA,EACE,EACA,EAAM,OACN,EAAM,kBACN,EAAM,mBACN,EAAM,qBACN,EAAM,UACN,GACD,CAGD,EAAM,eAAe,kBAAkB,EAAM,CAGzC,IAAgB,IAAA,GAAW,CAC7B,IAAM,EAAc,EAAI,UAAU,EAAa,EAAI,YAAY,CAAC,CAE5D,EACF,EAAI,SAAS,EAAY,CAEzB,EAAI,YAAY,EAUtB,SAAS,EAEP,EAAkC,EAAuB,CAiBzD,OAhBmB,EAAsB,EAAM,YAAa,EAAK,EAMjE,EACE,EACA,EAAM,OACN,EAAM,kBAEN,EAAM,mBACP,CAED,EAAM,eAAe,kBAAkB,EAAM,CAEtC,IAbE,GAmBX,SAAS,EAGP,EACA,EACA,EAMM,CAkBN,GAjBI,EAAQ,YAAc,IAAA,KACxB,EAAM,mBAAqB,EACzB,EACA,EAAQ,UACR,EAAM,OACL,GAAW,EAAkB,EAAO,CACtC,EAGC,EAAQ,gBAAkB,IAAA,KACxB,EAAQ,gBAAkB,KAC5B,OAAO,EAAM,OAAO,cAAc,GAElC,EAAM,OAAO,cAAc,GAAQ,EAAQ,eAI3C,EAAQ,eAAiB,IAAA,GAC3B,GAAI,EAAQ,eAAiB,KAC3B,OAAO,EAAM,OAAO,SAAS,OACxB,CACL,IAAM,EAAU,EAAQ,aAExB,EAAM,OAAO,SAAS,GAAS,GAC5B,EAAQ,EAAO,EAA2B,EAIjD,GAAI,EAAQ,eAAiB,IAAA,GAC3B,GAAI,EAAQ,eAAiB,KAC3B,OAAO,EAAM,OAAO,SAAS,OACxB,CACL,IAAM,EAAU,EAAQ,aAExB,EAAM,OAAO,SAAS,GAAS,GAC5B,EAAQ,EAAO,EAA2B,GAQnD,SAAS,EAGP,EACA,EACiC,CACjC,IAAM,EAAW,EAAM,QAAQ,kBAAkB,EAAK,CAEtD,GAAI,CAAC,EACH,OAIF,IAAM,EAAa,EAAS,GAAG,GAAG,CAC5B,EAAa,EAAM,eAAe,iBAAiB,EAAW,CAE9D,EAAY,EAAM,mBAAoB,cAAc,CAE1D,OAAO,EAAY,EAAY,EAAM,EAAM,OAAQ,EAAU,CAO/D,SAAgB,EAEd,EAAuD,CACvD,IAAM,EAAM,EAAa,EAAO,CAE1B,EAAQ,EAAI,eAAe,CAEjC,MAAO,CACL,KAAM,EAAQ,IAAY,CACxB,EAAgB,EAAI,WAAW,CAE/B,IAAM,EAAa,MAAM,QAAQ,EAAO,CAAG,EAAS,CAAC,EAAO,CACtD,EAAa,GAAS,OAE5B,EAAoB,EAAY,EAAI,UAAU,CAE1C,IAAe,IAAA,IACjB,EAAI,WAAW,OAAO,qBAAqB,EAAY,EAAM,KAAK,CAGpE,EAAI,WAAW,OAAO,4BAA4B,EAAY,WAAW,CACzE,EAAI,WAAW,OAAO,qBAAqB,EAAW,CACtD,EAAI,WAAW,OAAO,eAAe,EAAY,EAAM,CAEvD,EAAU,EAAO,EAAY,EAAW,EAG1C,OAAS,GAAS,CAChB,EAAgB,EAAI,WAAW,CAE/B,EAAI,WAAW,OAAO,wBAAwB,EAAK,CACnD,EAAI,WAAW,OAAO,qBAAqB,EAAM,cAAc,CAE7C,EAChB,EACA,EAAI,cAAc,CAClB,EAAI,iBAAiB,CACtB,GAMkB,EAAY,EAAO,EAAK,EAGzC,EAAO,KACL,qBACA,UAAU,EAAK,+BAChB,GAIL,QAAS,EAAM,IAAY,CACzB,EAAgB,EAAI,WAAW,CAE/B,EAAI,WAAW,OAAO,6BAA6B,EAAM,EAAQ,CACjE,EAAI,WAAW,OAAO,qBAAqB,EAAM,cAAc,CAE/D,GAAM,CACJ,YACA,gBACA,eACA,eACA,cACA,iBACE,EAEJ,EAAI,WAAW,OAAO,iCAAiC,EAAM,EAAQ,CAGjE,EAAI,iBAAiB,EACvB,EAAO,MACL,qBACA,mBAAmB,EAAK,wEACzB,CAGH,EAAI,WAAW,OAAO,oBAAoB,EAAM,EAAS,EAAM,CAE/D,EAAkB,EAAO,EAAM,CAC7B,YACA,gBACA,eACA,eACD,CAAC,CAEE,IAAgB,IAAA,KACd,IAAgB,KAElB,EAAM,mBAAoB,iBAAiB,EAAK,CAGhD,EAAM,mBAAoB,eAAe,EAAM,EAAa,GAAK,EAIjE,IAAkB,IAAA,KAChB,IAAkB,KAEpB,EAAM,mBAAoB,mBAAmB,EAAK,CAGlD,EAAM,mBAAoB,iBAAiB,EAAM,EAAe,GAAK,GAK3E,UAAa,CACX,EAAgB,EAAI,WAAW,CAEd,EAAoB,EAAI,iBAAiB,CAAC,GAO3D,EAAM,eAAe,WAAW,EAAM,CAEtC,EAAM,mBAAoB,UAAU,CACpC,EAAI,YAAY,GAGlB,IAAM,IACJ,EAAI,WAAW,OAAO,kBAAkB,EAAM,WAAW,CAElD,EAAM,QAAQ,SAAS,EAAK,EAGrC,IAAM,IACJ,EAAI,WAAW,OAAO,kBAAkB,EAAM,WAAW,CAElD,EAAS,EAAO,EAAK,EAG9B,QAAU,GAAW,CACnB,EAAgB,EAAI,WAAW,CAE/B,IAAM,EAAa,MAAM,QAAQ,EAAO,CAAG,EAAS,CAAC,EAAO,CAI5D,GAAI,CAFe,EAAoB,EAAI,iBAAiB,CAAC,CAG3D,OAGF,EAAoB,EAAY,EAAI,UAAU,CAE9C,EAAI,WAAW,OAAO,4BACpB,EACA,gBACD,CACD,EAAI,WAAW,OAAO,qBAAqB,EAAW,CACtD,EAAI,WAAW,OAAO,eAAe,EAAY,EAAM,CAEvD,IAAM,EAAc,EAAO,UAAU,EAAE,KAEvC,EAAc,EAAO,EAAY,EAAK,EAAY,EAErD,CCpiBH,SAAS,EACP,EACA,EACA,EACA,EACS,CAET,GAAI,IAAoB,IAAA,GACtB,MAAO,GAKT,GAFiB,CAAC,OAAO,OAAO,EAAM,aAAc,EAAe,CAIjE,GAAW,aAAa,wBAAwB,EAAO,gBAAgB,KAClE,CACL,IAAM,EAAY,EAAM,aACtB,GAEiB,IAAa,GAId,EAFC,OAAO,MAAM,EAAS,EAAI,OAAO,MAAM,EAAgB,GAGxE,GAAW,aAAa,cAAc,EAAgB,gBAAgB,CAO1E,MAHC,GAAM,aAAyC,GAC9C,EAEK,GAGT,SAAS,EACP,EACA,EACA,EACM,CACN,IAAM,EAA4B,EAAE,CAEpC,IAAK,IAAM,KAAO,EACZ,EAAK,KAAS,IAAA,KACZ,OAAO,OAAO,EAAM,aAAc,EAAI,CACxC,EAAgB,KAAK,EAAI,CAEzB,GAAW,aAAa,wBACtB,EACA,kBACD,CAGF,EAAM,aAAyC,GAAO,EAAK,IAI5D,EAAgB,OAAS,GAC3B,GAAW,aAAa,mBACtB,EACA,kBACD,CAQL,SAAgB,EAEd,EAA6D,CAC7D,IAAM,EAAM,EAAa,EAAO,CAEhC,MAAO,CACL,IAAM,GAAS,CACb,EAAI,WAAW,aAAa,uBAAuB,EAAM,gBAAgB,CAEzE,IAAM,EAAQ,EAAI,sBAAsB,CAClC,EAAS,EAAM,aACnB,GAQF,OALA,EAAI,WAAW,aAAa,yBAC1B,EACA,EACD,CAEM,GAET,YAAe,CAAE,GAAG,EAAI,sBAAsB,CAAC,aAAc,EAC7D,KAAM,EAAM,IAAU,CACpB,EAAgB,EAAI,WAAW,CAE/B,EAAI,WAAW,aAAa,0BAC1B,EACA,EACA,gBACD,CAED,EACE,EAAI,sBAAsB,CAC1B,EACA,EACA,EAAI,UACL,EAEH,OAAS,GAAS,CAChB,EAAgB,EAAI,WAAW,CAE/B,IAAM,EAAQ,EAAI,sBAAsB,CAExC,EAAI,WAAW,aAAa,2BAC1B,EACA,kBACD,CACD,EAAI,WAAW,aAAa,wBAAwB,EAAO,EAAM,OAAO,CAExE,EACE,EACA,EACA,EAAI,UACL,EAEH,OAAS,GAAS,CAChB,EAAgB,EAAI,WAAW,CAE/B,EAAI,WAAW,aAAa,uBAC1B,EACA,mBACD,CAED,IAAM,EAAQ,EAAI,sBAAsB,CAEnC,OAAO,OAAO,EAAM,aAAc,EAAe,EACpD,EAAI,WAAW,aAAa,sBAAsB,EAAK,CAGzD,OAAQ,EAAM,aAAyC,IAEzD,UAAa,CACX,EAAgB,EAAI,WAAW,CAC/B,IAAM,EAAQ,EAAI,sBAAsB,CAExC,EAAM,aAAe,OAAO,OAAO,KAAK,EAE1C,IAAM,IACJ,EAAI,WAAW,aAAa,uBAAuB,EAAM,gBAAgB,CAElE,OAAO,OACZ,EAAI,sBAAsB,CAAC,aAC3B,EACD,EAEJ,CChKH,SAAgB,EAEd,EAA0D,CAC1D,IAAM,EAAM,EAAa,EAAO,CAE1B,EAAqB,EAAI,eAAe,CAAC,mBAE/C,MAAO,CACL,iBAAiB,EAAM,EAAS,CAC9B,EAAgB,EAAI,WAAW,CAE/B,EAAI,WAAW,OAAO,kBAAkB,EAAM,mBAAmB,CACjE,EAAI,WAAW,UAAU,gBAAgB,EAAS,mBAAmB,CAErE,IAAM,EAAgB,EAAmB,gBAAgB,WAAW,CAEpE,EAAI,WAAW,UAAU,qBACvB,EACA,EAAI,sBAAsB,CAAC,OAC3B,cACD,CAED,EAAmB,eAAe,EAAM,EAAQ,EAGlD,mBAAmB,EAAM,EAAS,CAChC,EAAgB,EAAI,WAAW,CAE/B,EAAI,WAAW,OAAO,kBAAkB,EAAM,qBAAqB,CACnE,EAAI,WAAW,UAAU,gBAAgB,EAAS,qBAAqB,CAEvE,IAAM,EAAkB,EAAmB,gBAAgB,aAAa,CAExE,EAAI,WAAW,UAAU,qBACvB,EACA,EAAI,sBAAsB,CAAC,OAC3B,gBACD,CAED,EAAmB,iBAAiB,EAAM,EAAQ,EAGpD,oBAAoB,EAAM,CACxB,EAAgB,EAAI,WAAW,CAE/B,EAAI,WAAW,OAAO,kBAAkB,EAAM,sBAAsB,CAEpE,EAAmB,iBAAiB,EAAK,EAG3C,sBAAsB,EAAM,CAC1B,EAAgB,EAAI,WAAW,CAE/B,EAAI,WAAW,OAAO,kBAAkB,EAAM,wBAAwB,CAEtE,EAAmB,mBAAmB,EAAK,EAE9C,CCpDH,SAAgB,EAGd,EACA,EAC2B,CAC3B,IAAM,EAAM,EAAa,EAAO,CAEhC,GAAI,EAAI,YAAY,CAClB,MAAM,IAAI,EAAY,EAAW,gBAAgB,CAGnD,EAAI,WAAW,aAAa,kBAAkB,EAAa,CAG3D,IAAM,EAAc,EAAI,eAAe,CACjC,EAASA,EAAuB,EAAY,KAAK,CACjD,EAAc,EAAY,OAC1B,EAAqB,EAAY,mBACjC,EAAoB,EAAY,kBAEhC,EAAU,EAAI,cAAc,CAC5B,EAAa,EAAI,mBAAmB,CACpC,CAAC,EAAwB,GAC7B,EAAI,uBAAuB,CACvB,EAAkB,EAAI,oBAAoB,CAO1C,EAAY,IAAIC,EACpB,EACA,EAPiB,CACjB,GAAG,EACH,GAAG,EACJ,CAMA,CAEK,EAAY,EAAgB,EAAU,CAE5C,IAAK,GAAM,CAAC,EAAM,KAAY,OAAO,QAAQ,EAAuB,CAClE,EAAU,mBAAmB,EAAM,EAAQ,CAG7C,IAAK,GAAM,CAAC,EAAM,KAAY,OAAO,QAAQ,EAAqB,CAChE,EAAU,iBAAiB,EAAM,EAAQ,CAGvC,EAAgB,OAAS,GAC3B,EAAU,UAAU,GAAG,EAAgB,CAIzC,IAAM,EADS,EAAa,EAAU,CACd,eAAe,CAWvC,OARA,OAAO,OAAO,EAAS,OAAO,SAAU,EAAY,SAAS,CAC7D,OAAO,OAAO,EAAS,OAAO,SAAU,EAAY,SAAS,CAC7D,OAAO,OAAO,EAAS,OAAO,cAAe,EAAY,cAAc,CACvE,OAAO,OAAO,EAAS,OAAO,WAAY,EAAY,WAAW,CACjE,OAAO,OAAO,EAAS,OAAO,aAAc,EAAY,aAAa,CACrE,OAAO,OAAO,EAAS,mBAAoB,EAAmB,CAC9D,OAAO,OAAO,EAAS,kBAAmB,EAAkB,CAErD"}
|
|
1
|
+
{"version":3,"file":"api.mjs","names":["routeTreeToDefinitions","RouterClass"],"sources":["../../src/namespaces/RoutesNamespace/routeGuards.ts","../../src/api/getRoutesApi.ts","../../src/api/getDependenciesApi.ts","../../src/api/getLifecycleApi.ts","../../src/api/cloneRouter.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\";\n\nimport { throwIfDisposed } from \"./helpers\";\nimport { guardRouteStructure } from \"../guards\";\nimport { createInterceptable, getInternals } from \"../internals\";\nimport {\n clearConfigEntries,\n removeFromDefinitions,\n sanitizeRoute,\n} from \"../namespaces/RoutesNamespace/helpers\";\nimport {\n validateClearRoutes,\n validateRemoveRoute,\n} from \"../namespaces/RoutesNamespace/routeGuards\";\nimport {\n clearRouteData,\n refreshForwardMap,\n registerAllRouteHandlers,\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 Params,\n Router,\n} from \"@real-router/types\";\nimport type { RouteDefinition, RouteTree } from \"route-tree\";\n\n// ============================================================================\n// Helpers\n// ============================================================================\n\n/**\n * Recursively finds a route definition by its full dotted name.\n */\nfunction findDefinition(\n definitions: RouteDefinition[],\n fullName: string,\n parentPrefix = \"\",\n): RouteDefinition | undefined {\n for (const def of definitions) {\n const currentFullName = parentPrefix\n ? `${parentPrefix}.${def.name}`\n : def.name;\n\n if (currentFullName === fullName) {\n return def;\n }\n\n if (def.children && fullName.startsWith(`${currentFullName}.`)) {\n return findDefinition(def.children, fullName, currentFullName);\n }\n }\n\n /* v8 ignore next -- @preserve: defensive return, callers validate route exists before calling */\n return undefined;\n}\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 * Updates forwardTo for a route in config and returns the refreshed resolved\n * forward map (REPLACE semantics — caller must call ctx.setResolvedForwardMap).\n */\nfunction updateForwardTo<\n Dependencies extends DefaultDependencies = DefaultDependencies,\n>(\n name: string,\n forwardTo: string | ForwardToCallback<Dependencies> | null,\n config: RouteConfig,\n refreshForwardMapFn: (config: RouteConfig) => Record<string, string>,\n): Record<string, string> {\n if (forwardTo === null) {\n delete config.forwardMap[name];\n delete config.forwardFnMap[name];\n } else if (typeof forwardTo === \"string\") {\n delete config.forwardFnMap[name];\n config.forwardMap[name] = forwardTo;\n } else {\n delete config.forwardMap[name];\n config.forwardFnMap[name] = forwardTo;\n }\n\n return refreshForwardMapFn(config);\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 const forwardToFn = config.forwardFnMap[routeName];\n const forwardToStr = config.forwardMap[routeName];\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 (routeName in config.defaultParams) {\n route.defaultParams = config.defaultParams[routeName];\n }\n\n if (routeName in config.decoders) {\n route.decodeParams = config.decoders[routeName];\n }\n\n if (routeName in config.encoders) {\n route.encodeParams = config.encoders[routeName];\n }\n\n const [canDeactivateFactories, canActivateFactories] = factories;\n\n if (routeName in canActivateFactories) {\n route.canActivate = canActivateFactories[routeName];\n }\n\n if (routeName in canDeactivateFactories) {\n route.canDeactivate = canDeactivateFactories[routeName];\n }\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// 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 if (parentName) {\n // eslint-disable-next-line @typescript-eslint/no-non-null-assertion\n const parentDef = findDefinition(store.definitions, parentName)!;\n\n parentDef.children ??= [];\n\n for (const route of routes) {\n parentDef.children.push(sanitizeRoute(route));\n }\n } else {\n for (const route of routes) {\n store.definitions.push(sanitizeRoute(route));\n }\n }\n\n registerAllRouteHandlers(\n routes,\n store.config,\n store.routeCustomFields,\n store.pendingCanActivate,\n store.pendingCanDeactivate,\n store.depsStore,\n parentName ?? \"\",\n );\n\n store.treeOperations.commitTreeChanges(store);\n}\n\n/**\n * Atomically replaces all routes with a new set.\n * Follows RFC 6-step semantics for HMR support.\n */\nfunction replaceRoutes<\n Dependencies extends DefaultDependencies = DefaultDependencies,\n>(\n store: RoutesStore<Dependencies>,\n routes: Route<Dependencies>[],\n ctx: RouterInternals<Dependencies>,\n currentPath: string | undefined,\n): void {\n // Step 2: Clear route data (WITHOUT tree rebuild)\n clearRouteData(store);\n\n // Step 3: Clear definition lifecycle handlers (preserve external guards)\n // eslint-disable-next-line @typescript-eslint/no-non-null-assertion -- guaranteed set after wiring\n store.lifecycleNamespace!.clearDefinitionGuards();\n\n // Step 4: Register new routes\n for (const route of routes) {\n store.definitions.push(sanitizeRoute(route));\n }\n\n registerAllRouteHandlers(\n routes,\n store.config,\n store.routeCustomFields,\n store.pendingCanActivate,\n store.pendingCanDeactivate,\n store.depsStore,\n \"\",\n );\n\n // Step 5: One tree rebuild\n store.treeOperations.commitTreeChanges(store);\n\n // Step 6: Revalidate state\n if (currentPath !== undefined) {\n const revalidated = ctx.matchPath(currentPath, ctx.getOptions());\n\n if (revalidated) {\n ctx.setState(revalidated);\n } else {\n ctx.clearState();\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 store.treeOperations.commitTreeChanges(store);\n\n return true;\n}\n\n/**\n * Updates a route's configuration in place.\n */\nfunction updateRouteConfig<\n Dependencies extends DefaultDependencies = DefaultDependencies,\n>(\n store: RoutesStore<Dependencies>,\n name: string,\n updates: {\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 },\n): void {\n if (updates.forwardTo !== undefined) {\n store.resolvedForwardMap = updateForwardTo(\n name,\n updates.forwardTo,\n store.config,\n (config) => refreshForwardMap(config),\n );\n }\n\n if (updates.defaultParams !== undefined) {\n if (updates.defaultParams === null) {\n delete store.config.defaultParams[name];\n } else {\n store.config.defaultParams[name] = updates.defaultParams;\n }\n }\n\n if (updates.decodeParams !== undefined) {\n if (updates.decodeParams === null) {\n delete store.config.decoders[name];\n } else {\n const decoder = updates.decodeParams;\n\n store.config.decoders[name] = (params: Params): Params =>\n (decoder(params) as Params | undefined) ?? params;\n }\n }\n\n if (updates.encodeParams !== undefined) {\n if (updates.encodeParams === null) {\n delete store.config.encoders[name];\n } else {\n const encoder = updates.encodeParams;\n\n store.config.encoders[name] = (params: Params): Params =>\n (encoder(params) as Params | undefined) ?? params;\n }\n }\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 = store.treeOperations.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\nexport function getRoutesApi<\n Dependencies extends DefaultDependencies = DefaultDependencies,\n>(router: Router<Dependencies>): RoutesApi<Dependencies> {\n const ctx = getInternals(router);\n\n const store = ctx.routeGetStore();\n\n const interceptableAdd = createInterceptable(\n \"add\",\n (routeArray: Route<Dependencies>[], options?: { parent?: string }) => {\n addRoutes(store, routeArray, options?.parent);\n },\n ctx.interceptors,\n );\n\n return {\n add: (routes, options) => {\n throwIfDisposed(ctx.isDisposed);\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 interceptableAdd(\n routeArray,\n parentName === undefined ? undefined : { parent: parentName },\n );\n },\n\n remove: (name) => {\n throwIfDisposed(ctx.isDisposed);\n\n ctx.validator?.routes.validateRemoveRouteArgs(name);\n ctx.validator?.routes.throwIfInternalRoute(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 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 },\n\n update: (name, updates) => {\n throwIfDisposed(ctx.isDisposed);\n\n ctx.validator?.routes.validateUpdateRouteBasicArgs(name, updates);\n ctx.validator?.routes.throwIfInternalRoute(name, \"updateRoute\");\n\n const {\n forwardTo,\n defaultParams,\n decodeParams,\n encodeParams,\n canActivate,\n canDeactivate,\n } = updates;\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 updateRouteConfig(store, name, {\n forwardTo,\n defaultParams,\n decodeParams,\n encodeParams,\n });\n\n if (canActivate !== undefined) {\n if (canActivate === null) {\n // eslint-disable-next-line @typescript-eslint/no-non-null-assertion -- guaranteed set after wiring\n store.lifecycleNamespace!.clearCanActivate(name);\n } else {\n // eslint-disable-next-line @typescript-eslint/no-non-null-assertion -- guaranteed set after wiring\n store.lifecycleNamespace!.addCanActivate(name, canActivate, true);\n }\n }\n\n if (canDeactivate !== undefined) {\n if (canDeactivate === null) {\n // eslint-disable-next-line @typescript-eslint/no-non-null-assertion -- guaranteed set after wiring\n store.lifecycleNamespace!.clearCanDeactivate(name);\n } else {\n // eslint-disable-next-line @typescript-eslint/no-non-null-assertion -- guaranteed set after wiring\n store.lifecycleNamespace!.addCanDeactivate(name, canDeactivate, true);\n }\n }\n },\n\n clear: () => {\n throwIfDisposed(ctx.isDisposed);\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 store.treeOperations.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\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\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 currentPath = router.getState()?.path;\n\n replaceRoutes(store, routeArray, ctx, currentPath);\n },\n };\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): boolean {\n // undefined = \"don't set\" (feature for conditional setting)\n if (dependencyValue === undefined) {\n return false;\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 return true;\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 if (Object.hasOwn(store.dependencies, key)) {\n overwrittenKeys.push(key);\n } else {\n validator?.dependencies.validateDependencyCount(\n store,\n \"setDependencies\",\n );\n }\n\n (store.dependencies as Record<string, unknown>)[key] = deps[key];\n }\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(\n ctx.dependenciesGetStore(),\n name as string,\n value,\n ctx.validator,\n );\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 as string)) {\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(\n ctx.dependenciesGetStore().dependencies,\n name as string,\n );\n },\n };\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 const activateCount = lifecycleNamespace.getHandlerCount(\"activate\");\n\n ctx.validator?.lifecycle.validateHandlerLimit(\n activateCount,\n ctx.dependenciesGetStore().limits,\n \"canActivate\",\n );\n\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 const deactivateCount = lifecycleNamespace.getHandlerCount(\"deactivate\");\n\n ctx.validator?.lifecycle.validateHandlerLimit(\n deactivateCount,\n ctx.dependenciesGetStore().limits,\n \"canDeactivate\",\n );\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 { 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\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 options = ctx.cloneOptions();\n const sourceDeps = ctx.cloneDependencies();\n const [canDeactivateFactories, canActivateFactories] =\n ctx.getLifecycleFactories();\n const pluginFactories = ctx.getPluginFactories();\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 lifecycle = getLifecycleApi(newRouter);\n\n for (const [name, handler] of Object.entries(canDeactivateFactories)) {\n lifecycle.addDeactivateGuard(name, handler);\n }\n\n for (const [name, handler] of Object.entries(canActivateFactories)) {\n lifecycle.addActivateGuard(name, handler);\n }\n\n if (pluginFactories.length > 0) {\n newRouter.usePlugin(...pluginFactories);\n }\n\n const newCtx = getInternals(newRouter);\n const newStore = newCtx.routeGetStore();\n\n // Apply cloned config directly to new store\n Object.assign(newStore.config.decoders, routeConfig.decoders);\n Object.assign(newStore.config.encoders, routeConfig.encoders);\n Object.assign(newStore.config.defaultParams, routeConfig.defaultParams);\n Object.assign(newStore.config.forwardMap, routeConfig.forwardMap);\n Object.assign(newStore.config.forwardFnMap, routeConfig.forwardFnMap);\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/index.mjs
CHANGED
|
@@ -1,2 +1,2 @@
|
|
|
1
|
-
import{a as e,t}from"./Router-
|
|
1
|
+
import{a as e,t}from"./Router-BP_Wjnyr.mjs";import{c as n,l as r,o as i,s as a,t as o}from"./RouterError-BOUkCIgf.mjs";const s=(e=[],n={},r={})=>new t(e,n,r),c=new WeakMap,l=e=>{let t=c.get(e);return t||(t=Object.freeze({navigate:e.navigate,getState:e.getState,isActiveRoute:e.isActiveRoute,canNavigateTo:e.canNavigateTo,subscribe:e.subscribe,subscribeLeave:e.subscribeLeave,isLeaveApproved:e.isLeaveApproved}),c.set(e,t)),t};export{t as Router,o as RouterError,i as UNKNOWN_ROUTE,a as constants,s as createRouter,n as errorCodes,r as events,l as getNavigator,e as resolveForwardChain};
|
|
2
2
|
//# sourceMappingURL=index.mjs.map
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@real-router/core",
|
|
3
|
-
"version": "0.
|
|
3
|
+
"version": "0.45.0",
|
|
4
4
|
"type": "commonjs",
|
|
5
5
|
"description": "A simple, powerful, view-agnostic, modular and extensible router",
|
|
6
6
|
"main": "./dist/cjs/index.js",
|
|
@@ -87,9 +87,9 @@
|
|
|
87
87
|
"homepage": "https://github.com/greydragon888/real-router",
|
|
88
88
|
"sideEffects": false,
|
|
89
89
|
"dependencies": {
|
|
90
|
-
"@real-router/logger": "^0.2.1",
|
|
91
90
|
"@real-router/fsm": "^0.2.2",
|
|
92
|
-
"@real-router/
|
|
91
|
+
"@real-router/logger": "^0.2.1",
|
|
92
|
+
"@real-router/types": "^0.31.0"
|
|
93
93
|
},
|
|
94
94
|
"devDependencies": {
|
|
95
95
|
"event-emitter": "^0.1.2",
|
package/src/api/getRoutesApi.ts
CHANGED
|
@@ -2,7 +2,7 @@ import { logger } from "@real-router/logger";
|
|
|
2
2
|
|
|
3
3
|
import { throwIfDisposed } from "./helpers";
|
|
4
4
|
import { guardRouteStructure } from "../guards";
|
|
5
|
-
import { getInternals } from "../internals";
|
|
5
|
+
import { createInterceptable, getInternals } from "../internals";
|
|
6
6
|
import {
|
|
7
7
|
clearConfigEntries,
|
|
8
8
|
removeFromDefinitions,
|
|
@@ -405,6 +405,14 @@ export function getRoutesApi<
|
|
|
405
405
|
|
|
406
406
|
const store = ctx.routeGetStore();
|
|
407
407
|
|
|
408
|
+
const interceptableAdd = createInterceptable(
|
|
409
|
+
"add",
|
|
410
|
+
(routeArray: Route<Dependencies>[], options?: { parent?: string }) => {
|
|
411
|
+
addRoutes(store, routeArray, options?.parent);
|
|
412
|
+
},
|
|
413
|
+
ctx.interceptors,
|
|
414
|
+
);
|
|
415
|
+
|
|
408
416
|
return {
|
|
409
417
|
add: (routes, options) => {
|
|
410
418
|
throwIfDisposed(ctx.isDisposed);
|
|
@@ -422,7 +430,10 @@ export function getRoutesApi<
|
|
|
422
430
|
ctx.validator?.routes.validateAddRouteArgs(routeArray);
|
|
423
431
|
ctx.validator?.routes.validateRoutes(routeArray, store);
|
|
424
432
|
|
|
425
|
-
|
|
433
|
+
interceptableAdd(
|
|
434
|
+
routeArray,
|
|
435
|
+
parentName === undefined ? undefined : { parent: parentName },
|
|
436
|
+
);
|
|
426
437
|
},
|
|
427
438
|
|
|
428
439
|
remove: (name) => {
|