@real-router/core 0.40.1 → 0.42.0

package/dist/esm/RouterError-D0RlQE_5.mjs

@@ -0,0 +1,2 @@
+const e=Object.freeze({ROUTER_NOT_STARTED:`NOT_STARTED`,NO_START_PATH_OR_STATE:`NO_START_PATH_OR_STATE`,ROUTER_ALREADY_STARTED:`ALREADY_STARTED`,ROUTE_NOT_FOUND:`ROUTE_NOT_FOUND`,SAME_STATES:`SAME_STATES`,CANNOT_DEACTIVATE:`CANNOT_DEACTIVATE`,CANNOT_ACTIVATE:`CANNOT_ACTIVATE`,TRANSITION_ERR:`TRANSITION_ERR`,TRANSITION_CANCELLED:`CANCELLED`,ROUTER_DISPOSED:`DISPOSED`,PLUGIN_CONFLICT:`PLUGIN_CONFLICT`}),t=`@@router/UNKNOWN_ROUTE`,n={UNKNOWN_ROUTE:t},r={ROUTER_START:`onStart`,ROUTER_STOP:`onStop`,TRANSITION_START:`onTransitionStart`,TRANSITION_CANCEL:`onTransitionCancel`,TRANSITION_SUCCESS:`onTransitionSuccess`,TRANSITION_ERROR:`onTransitionError`},i={ROUTER_START:`$start`,ROUTER_STOP:`$stop`,TRANSITION_START:`$$start`,TRANSITION_CANCEL:`$$cancel`,TRANSITION_SUCCESS:`$$success`,TRANSITION_ERROR:`$$error`},a={maxDependencies:100,maxPlugins:50,maxListeners:1e4,warnListeners:1e3,maxEventDepth:5,maxLifecycleHandlers:200},o=Object.freeze({});function s(e){if(typeof e!=`object`||!e)return!1;let t=e;return typeof t.name==`string`&&typeof t.path==`string`&&typeof t.params==`object`&&t.params!==null}function c(e){if(!e)return e;if(!s(e))throw TypeError(`[deepFreezeState] Expected valid State object, got: ${typeof e}`);let t=structuredClone(e),n=new WeakSet;function r(e){if(!(typeof e!=`object`||!e)&&!n.has(e))if(n.add(e),Object.freeze(e),Array.isArray(e))for(let t of e)r(t);else for(let t in e)r(e[t])}return r(t),t}const l=new WeakSet;function u(e){if(!(typeof e!=`object`||!e)&&!Object.isFrozen(e))if(Object.freeze(e),Array.isArray(e))for(let t of e)u(t);else for(let t in e)u(e[t])}function d(e){return!e||l.has(e)?e:(u(e),l.add(e),e)}function f(e={}){return{...a,...e}}const p=new Set(Object.values(e)),m=new Set([`code`,`segment`,`path`,`redirect`]),h=new Set([`setCode`,`setErrorInstance`,`setAdditionalFields`,`hasField`,`getField`,`toJSON`]);var g=class extends Error{segment;path;redirect;code;constructor(e,{message:t,segment:n,path:r,redirect:i,...a}={}){super(t??e),this.code=e,this.segment=n,this.path=r,this.redirect=i?c(i):void 0;for(let[e,t]of Object.entries(a)){if(m.has(e))throw TypeError(`[RouterError] Cannot set reserved property "${e}"`);h.has(e)||(this[e]=t)}}setCode(e){this.code=e,p.has(this.message)&&(this.message=e)}setErrorInstance(e){if(!e)throw TypeError(`[RouterError.setErrorInstance] err parameter is required and must be an Error instance`);this.message=e.message,this.cause=e.cause,this.stack=e.stack??``}setAdditionalFields(e){for(let[t,n]of Object.entries(e)){if(m.has(t))throw TypeError(`[RouterError.setAdditionalFields] Cannot set reserved property "${t}"`);h.has(t)||(this[t]=n)}}hasField(e){return e in this}getField(e){return this[e]}toJSON(){let e={code:this.code,message:this.message};this.segment!==void 0&&(e.segment=this.segment),this.path!==void 0&&(e.path=this.path),this.redirect!==void 0&&(e.redirect=this.redirect);let t=new Set([`code`,`message`,`segment`,`path`,`redirect`,`stack`]);for(let n in this)Object.hasOwn(this,n)&&!t.has(n)&&(e[n]=this[n]);return e}};export{o as a,e as c,a as i,i as l,f as n,t as o,d as r,n as s,g as t,r as u};
+//# sourceMappingURL=RouterError-D0RlQE_5.mjs.map

package/dist/esm/RouterError-D0RlQE_5.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"RouterError-D0RlQE_5.mjs","names":[],"sources":["../../src/constants.ts","../../src/helpers.ts","../../src/RouterError.ts"],"sourcesContent":["// packages/core/src/constants.ts\n\nimport type {\n  EventToNameMap,\n  EventToPluginMap,\n  ErrorCodeToValueMap,\n  ErrorCodeKeys,\n  ErrorCodeValues,\n} from \"@real-router/types\";\n\nexport type ConstantsKeys = \"UNKNOWN_ROUTE\";\n\nexport type Constants = Record<ConstantsKeys, string>;\n\n// =============================================================================\n// Error Codes (migrated from router-error)\n// =============================================================================\n\nexport type ErrorCodes = Record<ErrorCodeKeys, ErrorCodeValues>;\n\n/**\n * Error codes for router operations.\n * Used to identify specific failure scenarios in navigation and lifecycle.\n * Frozen to prevent accidental modifications.\n */\nexport const errorCodes: ErrorCodeToValueMap = Object.freeze({\n  ROUTER_NOT_STARTED: \"NOT_STARTED\", // navigate() called before start()\n  NO_START_PATH_OR_STATE: \"NO_START_PATH_OR_STATE\", // start() without initial route\n  ROUTER_ALREADY_STARTED: \"ALREADY_STARTED\", // start() called twice\n  ROUTE_NOT_FOUND: \"ROUTE_NOT_FOUND\", // Navigation to non-existent route\n  SAME_STATES: \"SAME_STATES\", // Navigate to current route without reload\n  CANNOT_DEACTIVATE: \"CANNOT_DEACTIVATE\", // canDeactivate guard blocked navigation\n  CANNOT_ACTIVATE: \"CANNOT_ACTIVATE\", // canActivate guard blocked navigation\n  TRANSITION_ERR: \"TRANSITION_ERR\", // Generic transition failure\n  TRANSITION_CANCELLED: \"CANCELLED\", // Navigation cancelled by user or new navigation\n  ROUTER_DISPOSED: \"DISPOSED\", // Router has been disposed\n  PLUGIN_CONFLICT: \"PLUGIN_CONFLICT\", // Plugin tried to extend router with already-existing property\n});\n\n/**\n * General router constants.\n * Special route names and identifiers.\n */\nexport const UNKNOWN_ROUTE = \"@@router/UNKNOWN_ROUTE\";\n\nexport const constants: Constants = {\n  UNKNOWN_ROUTE,\n};\n\n/**\n * Plugin method names.\n * Maps to methods that plugins can implement to hook into router lifecycle.\n */\nexport const plugins: EventToPluginMap = {\n  ROUTER_START: \"onStart\", // Plugin method called when router starts\n  ROUTER_STOP: \"onStop\", // Plugin method called when router stops\n  TRANSITION_START: \"onTransitionStart\", // Plugin method called when navigation begins\n  TRANSITION_CANCEL: \"onTransitionCancel\", // Plugin method called when navigation cancelled\n  TRANSITION_SUCCESS: \"onTransitionSuccess\", // Plugin method called when navigation succeeds\n  TRANSITION_ERROR: \"onTransitionError\", // Plugin method called when navigation fails\n};\n\n/**\n * Event names for router event system.\n * Used with addEventListener/removeEventListener for reactive subscriptions.\n */\nexport const events: EventToNameMap = {\n  ROUTER_START: \"$start\", // Emitted when router.start() succeeds\n  ROUTER_STOP: \"$stop\", // Emitted when router.stop() is called\n  TRANSITION_START: \"$$start\", // Emitted when navigation begins\n  TRANSITION_CANCEL: \"$$cancel\", // Emitted when navigation is cancelled\n  TRANSITION_SUCCESS: \"$$success\", // Emitted when navigation completes successfully\n  TRANSITION_ERROR: \"$$error\", // Emitted when navigation fails\n};\n\nexport const DEFAULT_LIMITS = {\n  maxDependencies: 100,\n  maxPlugins: 50,\n  maxListeners: 10_000,\n  warnListeners: 1000,\n  maxEventDepth: 5,\n  maxLifecycleHandlers: 200,\n} as const;\n\nexport const EMPTY_PARAMS: Readonly<Record<string, never>> = Object.freeze({});\n","// packages/core/src/helpers.ts\n\nimport { DEFAULT_LIMITS } from \"./constants\";\n\nimport type { Limits } from \"./types\";\nimport type { State, LimitsConfig } from \"@real-router/types\";\n\n// =============================================================================\n// State Helpers\n// =============================================================================\n\n/**\n * Structural type guard for State object.\n * Only checks required fields exist with correct types.\n * Does NOT validate params serializability (allows circular refs).\n *\n * Use `isState` from type-guards for full validation (serializable params).\n * Use this for internal operations like deepFreezeState that handle any object structure.\n *\n * @param value - Value to check\n * @returns true if value has State structure\n * @internal\n */\nfunction isStateStructural(value: unknown): value is State {\n  if (value === null || typeof value !== \"object\") {\n    return false;\n  }\n\n  const obj = value as Record<string, unknown>;\n\n  return (\n    typeof obj.name === \"string\" &&\n    typeof obj.path === \"string\" &&\n    typeof obj.params === \"object\" &&\n    obj.params !== null\n  );\n}\n\n/**\n * Deep freezes State object to prevent mutations.\n * Creates a deep clone first, then recursively freezes the clone and all nested objects.\n * Uses simple recursive freezing after cloning (no need for WeakSet since clone has no circular refs).\n *\n * @param state - The State object to freeze\n * @returns A frozen deep clone of the state\n * @throws {TypeError} If state is not a valid State object\n *\n * @example\n * const state = { name: 'home', params: {}, path: '/' };\n * const frozen = deepFreezeState(state);\n * // frozen.params is now immutable\n * // original state is unchanged\n */\nexport function deepFreezeState<T extends State>(state: T): T {\n  // Early return for null/undefined\n  // eslint-disable-next-line @typescript-eslint/no-unnecessary-condition\n  if (!state) {\n    return state;\n  }\n\n  // Validate State structure (structural check, allows circular refs)\n  if (!isStateStructural(state)) {\n    throw new TypeError(\n      `[deepFreezeState] Expected valid State object, got: ${typeof state}`,\n    );\n  }\n\n  // Create a deep clone to avoid mutating the original\n  // structuredClone preserves circular references, so we need to track visited objects\n  const clonedState = structuredClone(state);\n\n  // WeakSet to track visited objects (prevent infinite recursion with circular refs)\n  const visited = new WeakSet<object>();\n\n  // Recursive freeze function with circular reference protection\n  function freezeClonedRecursive(obj: unknown): void {\n    // Skip primitives, null, undefined\n    // Note: typeof undefined === \"undefined\" !== \"object\", so checking undefined is redundant\n    if (obj === null || typeof obj !== \"object\") {\n      return;\n    }\n\n    // Skip already visited objects (circular reference protection)\n    if (visited.has(obj)) {\n      return;\n    }\n\n    // Mark as visited\n    visited.add(obj);\n\n    // Freeze the object/array itself\n    Object.freeze(obj);\n\n    // Iterate without Object.values() allocation\n    if (Array.isArray(obj)) {\n      for (const item of obj) {\n        freezeClonedRecursive(item);\n      }\n    } else {\n      for (const key in obj) {\n        freezeClonedRecursive((obj as Record<string, unknown>)[key]);\n      }\n    }\n  }\n\n  // Freeze the entire cloned state tree\n  freezeClonedRecursive(clonedState);\n\n  return clonedState;\n}\n\n// WeakSet to track already frozen root objects for O(1) re-freeze check\nconst frozenRoots = new WeakSet<object>();\n\n// Module-scope recursive freeze function - better JIT optimization, no allocation per call\nfunction freezeRecursive(obj: unknown): void {\n  // Skip primitives, null\n  if (obj === null || typeof obj !== \"object\") {\n    return;\n  }\n\n  // Skip already frozen objects (handles potential shared refs)\n  if (Object.isFrozen(obj)) {\n    return;\n  }\n\n  // Freeze the object/array\n  Object.freeze(obj);\n\n  // Iterate without Object.values() allocation\n  if (Array.isArray(obj)) {\n    for (const item of obj) {\n      freezeRecursive(item);\n    }\n  } else {\n    for (const key in obj) {\n      freezeRecursive((obj as Record<string, unknown>)[key]);\n    }\n  }\n}\n\n/**\n * Freezes State object in-place without cloning.\n * Optimized for hot paths where state is known to be a fresh object.\n *\n * IMPORTANT: Only use this when you know the state is a fresh object\n * that hasn't been exposed to external code yet (e.g., from makeState()).\n *\n * @param state - The State object to freeze (must be a fresh object)\n * @returns The same state object, now frozen\n * @internal\n */\nexport function freezeStateInPlace<T extends State>(state: T): T {\n  // Early return for null/undefined - state from makeState() is never null\n  // eslint-disable-next-line @typescript-eslint/no-unnecessary-condition\n  if (!state) {\n    return state;\n  }\n\n  // Fast path: already processed root object - O(1) check\n  if (frozenRoots.has(state)) {\n    return state;\n  }\n\n  freezeRecursive(state);\n\n  // Mark root as processed for future calls\n  frozenRoots.add(state);\n\n  return state;\n}\n\n/**\n * Merges user limits with defaults.\n * Returns frozen object for immutability.\n */\nexport function createLimits(userLimits: Partial<LimitsConfig> = {}): Limits {\n  return { ...DEFAULT_LIMITS, ...userLimits };\n}\n","// packages/core/src/RouterError.ts\n\nimport { errorCodes } from \"./constants\";\nimport { deepFreezeState } from \"./helpers\";\n\nimport type { State } from \"@real-router/types\";\n\n// Pre-compute Set of error code values for O(1) lookup in setCode()\n// This avoids creating array and doing linear search on every setCode() call\nconst errorCodeValues = new Set(Object.values(errorCodes));\n\n// Reserved built-in properties - throw error if user tries to set these\nconst reservedProperties = new Set([\"code\", \"segment\", \"path\", \"redirect\"]);\n\n// Reserved method names - silently ignore attempts to overwrite these\nconst reservedMethods = new Set([\n  \"setCode\",\n  \"setErrorInstance\",\n  \"setAdditionalFields\",\n  \"hasField\",\n  \"getField\",\n  \"toJSON\",\n]);\n\nexport class RouterError extends Error {\n  [key: string]: unknown;\n\n  // Using public properties to ensure structural compatibility\n  // with RouterError interface in core-types\n  readonly segment: string | undefined;\n  readonly path: string | undefined;\n  readonly redirect: State | undefined;\n\n  // Note: code appears to be writable but setCode() should be used\n  // to properly update both code and message together\n  code: string;\n\n  /**\n   * Creates a new RouterError instance.\n   *\n   * The options object accepts built-in fields (message, segment, path, redirect)\n   * and any additional custom fields, which will all be attached to the error instance.\n   *\n   * @param code - The error code (e.g., \"ROUTE_NOT_FOUND\", \"CANNOT_ACTIVATE\")\n   * @param options - Optional configuration object\n   * @param options.message - Custom error message (defaults to code if not provided)\n   * @param options.segment - The route segment where the error occurred\n   * @param options.path - The full path where the error occurred\n   * @param options.redirect - Optional redirect state for navigation errors\n   *\n   * @example\n   * ```typescript\n   * // Basic error\n   * const err1 = new RouterError(\"ROUTE_NOT_FOUND\");\n   *\n   * // Error with custom message\n   * const err2 = new RouterError(\"ERR\", { message: \"Something went wrong\" });\n   *\n   * // Error with context and custom fields\n   * const err3 = new RouterError(\"CANNOT_ACTIVATE\", {\n   *   message: \"Insufficient permissions\",\n   *   segment: \"admin\",\n   *   path: \"/admin/users\",\n   *   userId: \"123\"  // custom field\n   * });\n   *\n   * // Error with redirect\n   * const err4 = new RouterError(\"TRANSITION_ERR\", {\n   *   redirect: { name: \"home\", path: \"/\", params: {} }\n   * });\n   * ```\n   */\n  constructor(\n    code: string,\n    {\n      message,\n      segment,\n      path,\n      redirect,\n      ...rest\n    }: {\n      [key: string]: unknown;\n      message?: string | undefined;\n      segment?: string | undefined;\n      path?: string | undefined;\n      redirect?: State | undefined;\n    } = {},\n  ) {\n    super(message ?? code);\n\n    this.code = code;\n    this.segment = segment;\n    this.path = path;\n    // Deep freeze redirect to prevent mutations (creates a frozen clone)\n    this.redirect = redirect ? deepFreezeState(redirect) : undefined;\n\n    // Assign custom fields, checking reserved properties and filtering out reserved method names\n    // Issue #39: Throw for reserved properties to match setAdditionalFields behavior\n    for (const [key, value] of Object.entries(rest)) {\n      if (reservedProperties.has(key)) {\n        throw new TypeError(\n          `[RouterError] Cannot set reserved property \"${key}\"`,\n        );\n      }\n\n      if (!reservedMethods.has(key)) {\n        this[key] = value;\n      }\n    }\n  }\n\n  /**\n   * Updates the error code and conditionally updates the message.\n   *\n   * If the current message is one of the standard error code values\n   * (e.g., \"ROUTE_NOT_FOUND\", \"SAME_STATES\"), it will be replaced with the new code.\n   * This allows keeping error messages in sync with codes when using standard error codes.\n   *\n   * If the message is custom (not a standard error code), it will be preserved.\n   *\n   * @param newCode - The new error code to set\n   *\n   * @example\n   * // Message follows code (standard error code as message)\n   * const err = new RouterError(\"ROUTE_NOT_FOUND\", { message: \"ROUTE_NOT_FOUND\" });\n   * err.setCode(\"CUSTOM_ERROR\"); // message becomes \"CUSTOM_ERROR\"\n   *\n   * @example\n   * // Custom message is preserved\n   * const err = new RouterError(\"ERR\", { message: \"Custom error message\" });\n   * err.setCode(\"NEW_CODE\"); // message stays \"Custom error message\"\n   */\n  setCode(newCode: string): void {\n    this.code = newCode;\n\n    // Only update message if it's a standard error code value (not a custom message)\n    if (errorCodeValues.has(this.message)) {\n      this.message = newCode;\n    }\n  }\n\n  /**\n   * Copies properties from another Error instance to this RouterError.\n   *\n   * This method updates the message, cause, and stack trace from the provided error.\n   * Useful for wrapping native errors while preserving error context.\n   *\n   * @param err - The Error instance to copy properties from\n   * @throws {TypeError} If err is null or undefined\n   *\n   * @example\n   * ```typescript\n   * const routerErr = new RouterError(\"TRANSITION_ERR\");\n   * try {\n   *   // some operation that might fail\n   * } catch (nativeErr) {\n   *   routerErr.setErrorInstance(nativeErr);\n   *   throw routerErr;\n   * }\n   * ```\n   */\n  setErrorInstance(err: Error): void {\n    // eslint-disable-next-line @typescript-eslint/no-unnecessary-condition\n    if (!err) {\n      throw new TypeError(\n        \"[RouterError.setErrorInstance] err parameter is required and must be an Error instance\",\n      );\n    }\n\n    this.message = err.message;\n    this.cause = err.cause;\n    this.stack = err.stack ?? \"\";\n  }\n\n  /**\n   * Adds custom fields to the error object.\n   *\n   * This method allows attaching arbitrary data to the error for debugging or logging purposes.\n   * All fields become accessible as properties on the error instance and are included in JSON serialization.\n   *\n   * Reserved method names (setCode, setErrorInstance, setAdditionalFields, hasField, getField, toJSON)\n   * are automatically filtered out to prevent accidental overwriting of class methods.\n   *\n   * @param fields - Object containing custom fields to add to the error\n   *\n   * @example\n   * ```typescript\n   * const err = new RouterError(\"CANNOT_ACTIVATE\");\n   * err.setAdditionalFields({\n   *   userId: \"123\",\n   *   attemptedRoute: \"/admin\",\n   *   reason: \"insufficient permissions\"\n   * });\n   *\n   * console.log(err.userId); // \"123\"\n   * console.log(JSON.stringify(err)); // includes all custom fields\n   * ```\n   */\n  setAdditionalFields(fields: Record<string, unknown>): void {\n    // Assign fields, throwing for reserved properties, silently ignoring methods\n    for (const [key, value] of Object.entries(fields)) {\n      if (reservedProperties.has(key)) {\n        throw new TypeError(\n          `[RouterError.setAdditionalFields] Cannot set reserved property \"${key}\"`,\n        );\n      }\n\n      if (!reservedMethods.has(key)) {\n        this[key] = value;\n      }\n    }\n  }\n\n  /**\n   * Checks if a custom field exists on the error object.\n   *\n   * This method checks for both custom fields added via setAdditionalFields()\n   * and built-in fields (code, message, segment, etc.).\n   *\n   * @param key - The field name to check\n   * @returns `true` if the field exists, `false` otherwise\n   *\n   * @example\n   * ```typescript\n   * const err = new RouterError(\"ERR\", { segment: \"users\" });\n   * err.setAdditionalFields({ userId: \"123\" });\n   *\n   * err.hasField(\"userId\");  // true\n   * err.hasField(\"segment\"); // true\n   * err.hasField(\"unknown\"); // false\n   * ```\n   */\n  hasField(key: string): boolean {\n    return key in this;\n  }\n\n  /**\n   * Retrieves a custom field value from the error object.\n   *\n   * This method can access both custom fields and built-in fields.\n   * Returns `undefined` if the field doesn't exist.\n   *\n   * @param key - The field name to retrieve\n   * @returns The field value, or `undefined` if it doesn't exist\n   *\n   * @example\n   * ```typescript\n   * const err = new RouterError(\"ERR\");\n   * err.setAdditionalFields({ userId: \"123\", role: \"admin\" });\n   *\n   * err.getField(\"userId\"); // \"123\"\n   * err.getField(\"role\");   // \"admin\"\n   * err.getField(\"code\");   // \"ERR\" (built-in field)\n   * err.getField(\"unknown\"); // undefined\n   * ```\n   */\n  getField(key: string): unknown {\n    return this[key];\n  }\n\n  /**\n   * Serializes the error to a JSON-compatible object.\n   *\n   * This method is automatically called by JSON.stringify() and includes:\n   * - Built-in fields: code, message, segment (if set), path (if set), redirect (if set)\n   * - All custom fields added via setAdditionalFields() or constructor\n   * - Excludes: stack trace (for security/cleanliness)\n   *\n   * @returns A plain object representation of the error, suitable for JSON serialization\n   *\n   * @example\n   * ```typescript\n   * const err = new RouterError(\"ROUTE_NOT_FOUND\", {\n   *   message: \"Route not found\",\n   *   path: \"/admin/users/123\"\n   * });\n   * err.setAdditionalFields({ userId: \"123\" });\n   *\n   * JSON.stringify(err);\n   * // {\n   * //   \"code\": \"ROUTE_NOT_FOUND\",\n   * //   \"message\": \"Route not found\",\n   * //   \"path\": \"/admin/users/123\",\n   * //   \"userId\": \"123\"\n   * // }\n   * ```\n   */\n  toJSON(): Record<string, unknown> {\n    const result: Record<string, unknown> = {\n      code: this.code,\n      message: this.message,\n    };\n\n    if (this.segment !== undefined) {\n      result.segment = this.segment;\n    }\n    if (this.path !== undefined) {\n      result.path = this.path;\n    }\n    if (this.redirect !== undefined) {\n      result.redirect = this.redirect;\n    }\n\n    // add all public fields\n    // Using Set.has() for O(1) lookup instead of Array.includes() O(n)\n    // Overall complexity: O(n) instead of O(n*m)\n    const excludeKeys = new Set([\n      \"code\",\n      \"message\",\n      \"segment\",\n      \"path\",\n      \"redirect\",\n      \"stack\",\n    ]);\n\n    for (const key in this) {\n      if (Object.hasOwn(this, key) && !excludeKeys.has(key)) {\n        result[key] = this[key];\n      }\n    }\n\n    return result;\n  }\n}\n"],"mappings":"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"}

package/dist/esm/RouterValidator-DphcVMEp.d.mts

@@ -0,0 +1,112 @@
+//#region src/types/RouterValidator.d.ts
+/**
+ * RouterValidator interface - defines all validation methods used by the router.
+ *
+ * This interface is implemented by the validation plugin and injected into RouterInternals.
+ * When ctx.validator is null (default), validation is skipped.
+ * When ctx.validator is set (by validation plugin), all methods are called.
+ *
+ * All parameters use `unknown` type to avoid coupling to internal type names.
+ */
+interface RouterValidator {
+  /**
+   * Route validation methods
+   */
+  routes: {
+    validateBuildPathArgs: (route: unknown) => void;
+    validateMatchPathArgs: (path: unknown) => void;
+    validateIsActiveRouteArgs: (name: unknown, params: unknown, strict: unknown, ignoreQP: unknown) => void;
+    validateShouldUpdateNodeArgs: (name: unknown) => void;
+    validateStateBuilderArgs: (name: unknown, params: unknown, caller: string) => void;
+    validateAddRouteArgs: (routes: unknown) => void;
+    validateRoutes: (routes: unknown[], tree: unknown) => void;
+    validateRemoveRouteArgs: (name: unknown) => void;
+    validateUpdateRouteBasicArgs: (name: unknown, updates: unknown) => void;
+    validateUpdateRoutePropertyTypes: (name: string, updates: unknown) => void;
+    validateUpdateRoute: (name: string, updates: unknown, tree: unknown) => void;
+    validateParentOption: (parent: unknown, tree: unknown) => void;
+    validateRouteName: (name: unknown, caller: string) => void;
+    throwIfInternalRoute: (name: unknown, caller: string) => void;
+    throwIfInternalRouteInArray: (routes: unknown[], caller: string) => void;
+    validateExistingRoutes: (store: unknown) => void;
+    validateForwardToConsistency: (store: unknown) => void;
+    validateSetRootPathArgs: (rootPath: unknown) => void;
+    guardRouteCallbacks: (route: unknown) => void;
+    guardNoAsyncCallbacks: (route: unknown) => void;
+  };
+  /**
+   * Options validation methods
+   */
+  options: {
+    validateLimitValue: (name: string, value: unknown) => void;
+    validateLimits: (limits: unknown) => void;
+    validateOptions: (options: unknown, methodName: string) => void;
+  };
+  /**
+   * Dependencies validation methods
+   */
+  dependencies: {
+    validateDependencyName: (name: unknown, caller: string) => void;
+    validateSetDependencyArgs: (name: unknown, value: unknown, caller: string) => void;
+    validateDependenciesObject: (deps: unknown, caller: string) => void;
+    validateDependencyExists: (name: string, store: unknown) => void;
+    validateDependencyLimit: (store: unknown, limits: unknown) => void;
+    validateDependenciesStructure: (store: unknown) => void;
+    validateDependencyCount: (store: unknown, methodName: string) => void;
+    validateCloneArgs: (dependencies: unknown) => void;
+    warnOverwrite: (name: string, methodName: string) => void;
+    warnBatchOverwrite: (keys: string[], methodName: string) => void;
+    warnRemoveNonExistent: (name: unknown) => void;
+  };
+  /**
+   * Plugin validation methods
+   */
+  plugins: {
+    validatePluginLimit: (count: number, limits: unknown) => void;
+    validateNoDuplicatePlugins: (factory: unknown, factories: unknown[]) => void;
+    validatePluginKeys: (plugin: unknown) => void;
+    validateCountThresholds: (count: number) => void;
+    warnBatchDuplicates: (plugins: unknown[]) => void;
+    warnPluginMethodType: (methodName: string) => void;
+    warnPluginAfterStart: (methodName: string) => void;
+    validateAddInterceptorArgs: (method: unknown, fn: unknown) => void;
+  };
+  /**
+   * Lifecycle guard validation methods
+   */
+  lifecycle: {
+    validateHandler: (handler: unknown, caller: string) => void;
+    validateNotRegistering: (name: string, guards: unknown, caller: string) => void;
+    validateHandlerLimit: (count: number, limits: unknown, caller: string) => void;
+    validateCountThresholds: (count: number, methodName: string) => void;
+    warnOverwrite: (name: string, type: string, methodName: string) => void;
+    warnAsyncGuardSync: (name: string, methodName: string) => void;
+  };
+  /**
+   * Navigation validation methods
+   */
+  navigation: {
+    validateNavigateArgs: (name: unknown) => void;
+    validateNavigateToDefaultArgs: (options: unknown) => void;
+    validateNavigationOptions: (options: unknown, caller: string) => void;
+    validateParams: (params: unknown, methodName: string) => void;
+    validateStartArgs: (path: unknown) => void;
+  };
+  /**
+   * State validation methods
+   */
+  state: {
+    validateMakeStateArgs: (name: unknown, params: unknown, path: unknown) => void;
+    validateAreStatesEqualArgs: (s1: unknown, s2: unknown, ignoreQP: unknown) => void;
+  };
+  /**
+   * Event bus validation methods
+   */
+  eventBus: {
+    validateEventName: (name: unknown) => void;
+    validateListenerArgs: (name: unknown, cb: unknown) => void;
+  };
+}
+//#endregion
+export { RouterValidator as t };
+//# sourceMappingURL=RouterValidator-DphcVMEp.d.mts.map

package/dist/esm/api.d.mts

@@ -1,20 +1,25 @@
-import { PluginApi as PluginApi$1, DefaultDependencies, Router, RoutesApi, DependenciesApi, LifecycleApi } from '@real-router/types';
-export { DependenciesApi, LifecycleApi, RoutesApi } from '@real-router/types';
-import { R as RouteTree } from './index.d-y2b-8_3Y.mjs';
-import { R as Router$1 } from './Router-B-Pev7K2.mjs';
+import { f as RouteTree, t as Router$1 } from "./Router-4JRfQLMM.mjs";
+import { DefaultDependencies, DependenciesApi, LifecycleApi, PluginApi as PluginApi$1, Router, RoutesApi } from "@real-router/types";
 
+//#region src/api/types.d.ts
 interface PluginApi extends Omit<PluginApi$1, "getTree"> {
-    getTree: () => RouteTree;
+  getTree: () => RouteTree;
 }
-
+//#endregion
+//#region src/api/getPluginApi.d.ts
 declare function getPluginApi<Dependencies extends DefaultDependencies = DefaultDependencies>(router: Router<Dependencies>): PluginApi;
-
+//#endregion
+//#region src/api/getRoutesApi.d.ts
 declare function getRoutesApi<Dependencies extends DefaultDependencies = DefaultDependencies>(router: Router<Dependencies>): RoutesApi<Dependencies>;
-
+//#endregion
+//#region src/api/getDependenciesApi.d.ts
 declare function getDependenciesApi<Dependencies extends DefaultDependencies = DefaultDependencies>(router: Router<Dependencies>): DependenciesApi<Dependencies>;
-
+//#endregion
+//#region src/api/getLifecycleApi.d.ts
 declare function getLifecycleApi<Dependencies extends DefaultDependencies = DefaultDependencies>(router: Router<Dependencies>): LifecycleApi<Dependencies>;
-
+//#endregion
+//#region src/api/cloneRouter.d.ts
 declare function cloneRouter<Dependencies extends DefaultDependencies = DefaultDependencies>(router: Router<Dependencies>, dependencies?: Dependencies): Router$1<Dependencies>;
-
-export { type PluginApi, cloneRouter, getDependenciesApi, getLifecycleApi, getPluginApi, getRoutesApi };
+//#endregion
+export { type DependenciesApi, type LifecycleApi, type PluginApi, type RoutesApi, cloneRouter, getDependenciesApi, getLifecycleApi, getPluginApi, getRoutesApi };
+//# sourceMappingURL=api.d.mts.map

package/dist/esm/api.mjs

@@ -1 +1,2 @@
-import{guardRouteStructure as e,f as t,Router as a,clearRouteData as n,sanitizeRoute as r,registerAllRouteHandlers as o,removeFromDefinitions as i,clearConfigEntries as d,refreshForwardMap as s}from"./chunk-MNRZAE7T.mjs";import{throwIfDisposed as c}from"./chunk-HHIXK5UM.mjs";export{getPluginApi}from"./chunk-HHIXK5UM.mjs";import{RouterError as l,errorCodes as u}from"./chunk-5QXFUUDL.mjs";import{getInternals as p}from"./chunk-QUUNDESP.mjs";import{logger as v}from"@real-router/logger";function f(e){return!e||(v.error("router.clearRoutes","Cannot clear routes while navigation is in progress. Wait for navigation to complete."),!1)}function m(e,t,a=""){for(const n of e){const e=a?`${a}.${n.name}`:n.name;if(e===t)return n;if(n.children&&t.startsWith(`${e}.`))return m(n.children,t,e)}}function g(e,t,a,n){const r={name:e.name,path:e.path},o=a.forwardFnMap[t],i=a.forwardMap[t];void 0!==o?r.forwardTo=o:void 0!==i&&(r.forwardTo=i),t in a.defaultParams&&(r.defaultParams=a.defaultParams[t]),t in a.decoders&&(r.decodeParams=a.decoders[t]),t in a.encoders&&(r.encodeParams=a.encoders[t]);const[d,s]=n;return t in s&&(r.canActivate=s[t]),t in d&&(r.canDeactivate=d[t]),e.children&&(r.children=e.children.map(e=>g(e,`${t}.${e.name}`,a,n))),r}function D(e,t,a){if(a){const n=m(e.definitions,a);n.children??=[];for(const e of t)n.children.push(r(e))}else for(const a of t)e.definitions.push(r(a));o(t,e.config,e.routeCustomFields,e.pendingCanActivate,e.pendingCanDeactivate,e.depsStore,a??""),e.treeOperations.commitTreeChanges(e)}function h(e,t){const a=e.matcher.getSegmentsByName(t);if(!a)return;const n=a.at(-1),r=e.treeOperations.nodeToDefinition(n),o=e.lifecycleNamespace.getFactories();return g(r,t,e.config,o)}function w(t){const a=p(t),l=a.routeGetStore();return{add:(t,n)=>{c(a.isDisposed);const r=Array.isArray(t)?t:[t],o=n?.parent;e(r,a.validator),void 0!==o&&a.validator?.routes.validateParentOption(o,l.tree),a.validator?.routes.throwIfInternalRouteInArray(r,"addRoute"),a.validator?.routes.validateAddRouteArgs(r),a.validator?.routes.validateRoutes(r,l),D(l,r,o)},remove:e=>{c(a.isDisposed),a.validator?.routes.validateRemoveRouteArgs(e),a.validator?.routes.throwIfInternalRoute(e,"removeRoute");const t=function(e,t,a){if(t){const a=t===e,n=t.startsWith(`${e}.`);if(a||n)return v.warn("router.removeRoute",`Cannot remove route "${e}" — it is currently active${a?"":` (current: "${t}")`}. Navigate away first.`),!1}return a&&v.warn("router.removeRoute",`Route "${e}" removed while navigation is in progress. This may cause unexpected behavior.`),!0}(e,a.getStateName(),a.isTransitioning());t&&(function(e,t){return!!i(e.definitions,t)&&(function(e,t,a,n){const r=t=>t===e||t.startsWith(`${e}.`);d(t.decoders,r),d(t.encoders,r),d(t.defaultParams,r),d(t.forwardMap,r),d(t.forwardFnMap,r),d(a,r),d(t.forwardMap,e=>r(t.forwardMap[e]));const[o,i]=n.getFactories();for(const e of Object.keys(i))r(e)&&n.clearCanActivate(e);for(const e of Object.keys(o))r(e)&&n.clearCanDeactivate(e)}(t,e.config,e.routeCustomFields,e.lifecycleNamespace),e.treeOperations.commitTreeChanges(e),!0)}(l,e)||v.warn("router.removeRoute",`Route "${e}" not found. No changes made.`))},update:(e,t)=>{c(a.isDisposed),a.validator?.routes.validateUpdateRouteBasicArgs(e,t),a.validator?.routes.throwIfInternalRoute(e,"updateRoute");const{forwardTo:n,defaultParams:r,decodeParams:o,encodeParams:i,canActivate:d,canDeactivate:u}=t;a.validator?.routes.validateUpdateRoutePropertyTypes(e,t),a.isTransitioning()&&v.error("router.updateRoute",`Updating route "${e}" while navigation is in progress. This may cause unexpected behavior.`),a.validator?.routes.validateUpdateRoute(e,t,l),function(e,t,a){if(void 0!==a.forwardTo&&(e.resolvedForwardMap=function(e,t,a){return null===t?(delete a.forwardMap[e],delete a.forwardFnMap[e]):"string"==typeof t?(delete a.forwardFnMap[e],a.forwardMap[e]=t):(delete a.forwardMap[e],a.forwardFnMap[e]=t),(e=>s(e))(a)}(t,a.forwardTo,e.config)),void 0!==a.defaultParams&&(null===a.defaultParams?delete e.config.defaultParams[t]:e.config.defaultParams[t]=a.defaultParams),void 0!==a.decodeParams)if(null===a.decodeParams)delete e.config.decoders[t];else{const n=a.decodeParams;e.config.decoders[t]=e=>n(e)??e}if(void 0!==a.encodeParams)if(null===a.encodeParams)delete e.config.encoders[t];else{const n=a.encodeParams;e.config.encoders[t]=e=>n(e)??e}}(l,e,{forwardTo:n,defaultParams:r,decodeParams:o,encodeParams:i}),void 0!==d&&(null===d?l.lifecycleNamespace.clearCanActivate(e):l.lifecycleNamespace.addCanActivate(e,d,!0)),void 0!==u&&(null===u?l.lifecycleNamespace.clearCanDeactivate(e):l.lifecycleNamespace.addCanDeactivate(e,u,!0))},clear:()=>{c(a.isDisposed),f(a.isTransitioning())&&(l.treeOperations.resetStore(l),l.lifecycleNamespace.clearAll(),a.clearState())},has:e=>(a.validator?.routes.validateRouteName(e,"hasRoute"),l.matcher.hasRoute(e)),get:e=>(a.validator?.routes.validateRouteName(e,"getRoute"),h(l,e)),replace:i=>{c(a.isDisposed);const d=Array.isArray(i)?i:[i];if(!f(a.isTransitioning()))return;e(d,a.validator),a.validator?.routes.throwIfInternalRouteInArray(d,"replaceRoutes"),a.validator?.routes.validateAddRouteArgs(d),a.validator?.routes.validateRoutes(d,l);const s=t.getState()?.path;!function(e,t,a,i){n(e),e.lifecycleNamespace.clearDefinitionGuards();for(const a of t)e.definitions.push(r(a));if(o(t,e.config,e.routeCustomFields,e.pendingCanActivate,e.pendingCanDeactivate,e.depsStore,""),e.treeOperations.commitTreeChanges(e),void 0!==i){const e=a.matchPath(i,a.getOptions());e?a.setState(e):a.clearState()}}(l,d,a,s)}}}function y(e){const t=p(e);return{get:e=>{t.validator?.dependencies.validateDependencyName(e,"getDependency");const a=t.dependenciesGetStore(),n=a.dependencies[e];return t.validator?.dependencies.validateDependencyExists(e,a),n},getAll:()=>({...t.dependenciesGetStore().dependencies}),set:(e,a)=>{c(t.isDisposed),t.validator?.dependencies.validateSetDependencyArgs(e,a,"setDependency"),function(e,t,a,n){if(void 0===a)return!1;if(Object.hasOwn(e.dependencies,t)){const r=e.dependencies[t],o=r!==a,i=Number.isNaN(r)&&Number.isNaN(a);o&&!i&&n?.dependencies.warnOverwrite(t,"setDependency")}else n?.dependencies.validateDependencyCount(e,"setDependency");e.dependencies[t]=a}(t.dependenciesGetStore(),e,a,t.validator)},setAll:e=>{c(t.isDisposed);const a=t.dependenciesGetStore();t.validator?.dependencies.validateDependenciesObject(e,"setDependencies"),t.validator?.dependencies.validateDependencyLimit(a,a.limits),function(e,t,a){const n=[];for(const r in t)void 0!==t[r]&&(Object.hasOwn(e.dependencies,r)?n.push(r):a?.dependencies.validateDependencyCount(e,"setDependencies"),e.dependencies[r]=t[r]);n.length>0&&a?.dependencies.warnBatchOverwrite(n,"setDependencies")}(a,e,t.validator)},remove:e=>{c(t.isDisposed),t.validator?.dependencies.validateDependencyName(e,"removeDependency");const a=t.dependenciesGetStore();Object.hasOwn(a.dependencies,e)||t.validator?.dependencies.warnRemoveNonExistent(e),delete a.dependencies[e]},reset:()=>{c(t.isDisposed),t.dependenciesGetStore().dependencies=Object.create(null)},has:e=>(t.validator?.dependencies.validateDependencyName(e,"hasDependency"),Object.hasOwn(t.dependenciesGetStore().dependencies,e))}}function R(e){const t=p(e),a=t.routeGetStore().lifecycleNamespace;return{addActivateGuard(e,n){c(t.isDisposed),t.validator?.routes.validateRouteName(e,"addActivateGuard"),t.validator?.lifecycle.validateHandler(n,"addActivateGuard");const r=a.getHandlerCount("activate");t.validator?.lifecycle.validateHandlerLimit(r,t.dependenciesGetStore().limits,"canActivate"),a.addCanActivate(e,n)},addDeactivateGuard(e,n){c(t.isDisposed),t.validator?.routes.validateRouteName(e,"addDeactivateGuard"),t.validator?.lifecycle.validateHandler(n,"addDeactivateGuard");const r=a.getHandlerCount("deactivate");t.validator?.lifecycle.validateHandlerLimit(r,t.dependenciesGetStore().limits,"canDeactivate"),a.addCanDeactivate(e,n)},removeActivateGuard(e){c(t.isDisposed),t.validator?.routes.validateRouteName(e,"removeActivateGuard"),a.clearCanActivate(e)},removeDeactivateGuard(e){c(t.isDisposed),t.validator?.routes.validateRouteName(e,"removeDeactivateGuard"),a.clearCanDeactivate(e)}}}function A(e,n){const r=p(e);if(r.isDisposed())throw new l(u.ROUTER_DISPOSED);r.validator?.dependencies.validateCloneArgs(n);const o=r.routeGetStore(),i=t(o.tree),d=o.config,s=o.resolvedForwardMap,c=o.routeCustomFields,v=r.cloneOptions(),f=r.cloneDependencies(),[m,g]=r.getLifecycleFactories(),D=r.getPluginFactories(),h={...f,...n},w=new a(i,v,h),y=R(w);for(const[e,t]of Object.entries(m))y.addDeactivateGuard(e,t);for(const[e,t]of Object.entries(g))y.addActivateGuard(e,t);D.length>0&&w.usePlugin(...D);const A=p(w).routeGetStore();return Object.assign(A.config.decoders,d.decoders),Object.assign(A.config.encoders,d.encoders),Object.assign(A.config.defaultParams,d.defaultParams),Object.assign(A.config.forwardMap,d.forwardMap),Object.assign(A.config.forwardFnMap,d.forwardFnMap),Object.assign(A.resolvedForwardMap,s),Object.assign(A.routeCustomFields,c),w}export{A as cloneRouter,y as getDependenciesApi,R as getLifecycleApi,w as getRoutesApi};//# sourceMappingURL=api.mjs.map
+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-C_k70gHi.mjs";import{c as l,t as u}from"./RouterError-D0RlQE_5.mjs";import{r as d}from"./internals-CCymabFj.mjs";import{n as f,t as p}from"./getPluginApi-D0bBPuLp.mjs";import{logger as m}from"@real-router/logger";function h(e,t,n){if(t){let n=t===e,r=t.startsWith(`${e}.`);if(n||r){let r=n?``:` (current: "${t}")`;return m.warn(`router.removeRoute`,`Cannot remove route "${e}" — it is currently active${r}. Navigate away first.`),!1}}return n&&m.warn(`router.removeRoute`,`Route "${e}" removed while navigation is in progress. This may cause unexpected behavior.`),!0}function g(e){return e?(m.error(`router.clearRoutes`,`Cannot clear routes while navigation is in progress. Wait for navigation to complete.`),!1):!0}function _(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 _(r.children,t,e)}}function v(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 y(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 b(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=>b(e,`${t}.${e.name}`,n,r))),i}function x(e,r,i){if(i){let t=_(e.definitions,i);t.children??=[];for(let e of r)t.children.push(n(e))}else for(let t of r)e.definitions.push(n(t));t(r,e.config,e.routeCustomFields,e.pendingCanActivate,e.pendingCanDeactivate,e.depsStore,i??``),e.treeOperations.commitTreeChanges(e)}function S(e,i,a,o){r(e),e.lifecycleNamespace.clearDefinitionGuards();for(let t of i)e.definitions.push(n(t));if(t(i,e.config,e.routeCustomFields,e.pendingCanActivate,e.pendingCanDeactivate,e.depsStore,``),e.treeOperations.commitTreeChanges(e),o!==void 0){let e=a.matchPath(o,a.getOptions());e?a.setState(e):a.clearState()}}function C(t,n){return e(t.definitions,n)?(v(n,t.config,t.routeCustomFields,t.lifecycleNamespace),t.treeOperations.commitTreeChanges(t),!0):!1}function w(e,t,n){if(n.forwardTo!==void 0&&(e.resolvedForwardMap=y(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 T(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 b(i,t,e.config,a)}function E(e){let t=d(e),n=t.routeGetStore();return{add:(e,r)=>{f(t.isDisposed);let i=Array.isArray(e)?e:[e],a=r?.parent;c(i,t.validator),a!==void 0&&t.validator?.routes.validateParentOption(a,n.tree),t.validator?.routes.throwIfInternalRouteInArray(i,`addRoute`),t.validator?.routes.validateAddRouteArgs(i),t.validator?.routes.validateRoutes(i,n),x(n,i,a)},remove:e=>{f(t.isDisposed),t.validator?.routes.validateRemoveRouteArgs(e),t.validator?.routes.throwIfInternalRoute(e,`removeRoute`),h(e,t.getStateName(),t.isTransitioning())&&(C(n,e)||m.warn(`router.removeRoute`,`Route "${e}" not found. No changes made.`))},update:(e,r)=>{f(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()&&m.error(`router.updateRoute`,`Updating route "${e}" while navigation is in progress. This may cause unexpected behavior.`),t.validator?.routes.validateUpdateRoute(e,r,n),w(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:()=>{f(t.isDisposed),g(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`),T(n,e)),replace:r=>{f(t.isDisposed);let i=Array.isArray(r)?r:[r];if(!g(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;S(n,i,t,a)}}}function D(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 O(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 k(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)=>{f(t.isDisposed),t.validator?.dependencies.validateSetDependencyArgs(e,n,`setDependency`),D(t.dependenciesGetStore(),e,n,t.validator)},setAll:e=>{f(t.isDisposed);let n=t.dependenciesGetStore();t.validator?.dependencies.validateDependenciesObject(e,`setDependencies`),t.validator?.dependencies.validateDependencyLimit(n,n.limits),O(n,e,t.validator)},remove:e=>{f(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:()=>{f(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 A(e){let t=d(e),n=t.routeGetStore().lifecycleNamespace;return{addActivateGuard(e,r){f(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){f(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){f(t.isDisposed),t.validator?.routes.validateRouteName(e,`removeActivateGuard`),n.clearCanActivate(e)},removeDeactivateGuard(e){f(t.isDisposed),t.validator?.routes.validateRouteName(e,`removeDeactivateGuard`),n.clearCanDeactivate(e)}}}function j(e,t){let n=d(e);if(n.isDisposed())throw new u(l.ROUTER_DISPOSED);n.validator?.dependencies.validateCloneArgs(t);let r=n.routeGetStore(),a=i(r.tree),o=r.config,c=r.resolvedForwardMap,f=r.routeCustomFields,p=n.cloneOptions(),m=n.cloneDependencies(),[h,g]=n.getLifecycleFactories(),_=n.getPluginFactories(),v=new s(a,p,{...m,...t}),y=A(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{j as cloneRouter,k as getDependenciesApi,A as getLifecycleApi,p as getPluginApi,E as getRoutesApi};
+//# sourceMappingURL=api.mjs.map

package/dist/esm/api.mjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/namespaces/RoutesNamespace/routeGuards.ts","../../src/api/getRoutesApi.ts","../../src/api/getDependenciesApi.ts","../../src/api/getLifecycleApi.ts","../../src/api/cloneRouter.ts"],"names":["logger"],"mappings":"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","file":"api.mjs","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"]}
+{"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":"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"}

package/dist/esm/getPluginApi-D0bBPuLp.mjs

@@ -0,0 +1,2 @@
+import{c as e,t}from"./RouterError-D0RlQE_5.mjs";import{r as n}from"./internals-CCymabFj.mjs";function r(n){if(n())throw new t(e.ROUTER_DISPOSED)}function i(i){let a=n(i);return{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())),setRootPath:e=>{r(a.isDisposed),a.validator?.routes.validateSetRootPathArgs(e),a.setRootPath(e)},getRootPath:a.getRootPath,addEventListener:(e,t)=>(r(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)=>{r(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=>{r(a.isDisposed);let o=Object.keys(n);for(let n of o)if(n in i)throw new t(e.PLUGIN_CONFLICT,{message:`Cannot extend router: property "${n}" already exists`});for(let e of o)i[e]=n[e];let s={keys:o};a.routerExtensions.push(s);let c=!1;return()=>{if(c)return;c=!0;for(let e of s.keys)delete i[e];let e=a.routerExtensions.indexOf(s);e!==-1&&a.routerExtensions.splice(e,1)}}}}export{r as n,i as t};
+//# sourceMappingURL=getPluginApi-D0bBPuLp.mjs.map

package/dist/esm/getPluginApi-D0bBPuLp.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"getPluginApi-D0bBPuLp.mjs","names":[],"sources":["../../src/api/helpers.ts","../../src/api/getPluginApi.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","import { throwIfDisposed } from \"./helpers\";\nimport { errorCodes } from \"../constants\";\nimport { getInternals } from \"../internals\";\nimport { RouterError } from \"../RouterError\";\n\nimport type { PluginApi } from \"./types\";\nimport type { DefaultDependencies, Params, Router } from \"@real-router/types\";\n\nexport function getPluginApi<\n  Dependencies extends DefaultDependencies = DefaultDependencies,\n>(router: Router<Dependencies>): PluginApi {\n  const ctx = getInternals(router);\n\n  return {\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\">>\n          | 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    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      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        if (idx !== -1) {\n          ctx.routerExtensions.splice(idx, 1);\n        }\n      };\n    },\n  };\n}\n"],"mappings":"8FAKA,SAAgB,EAAgB,EAAiC,CAC/D,GAAI,GAAY,CACd,MAAM,IAAI,EAAY,EAAW,gBAAgB,CCCrD,SAAgB,EAEd,EAAyC,CACzC,IAAM,EAAM,EAAa,EAAO,CAEhC,MAAO,CACL,WAAY,EAAM,EAAQ,EAAM,KAC9B,EAAI,WAAW,MAAM,sBAAsB,EAAM,EAAQ,EAAK,CAEvD,EAAI,UACT,EACA,EACA,EACA,GAAM,OAGP,EAEH,YAAa,EAAW,IAAgB,CACtC,EAAI,WAAW,OAAO,yBACpB,EACA,EACA,aACD,CAED,GAAM,CAAE,OAAM,UAAW,EAAI,aAAa,EAAW,EAAY,CAEjE,OAAO,EAAI,mBAAmB,EAAM,EAAO,EAE7C,cACE,EACA,KAEA,EAAI,WAAW,OAAO,yBACpB,EACA,EACA,eACD,CAEM,EAAI,aAAa,EAAW,EAAY,EAEjD,UAAY,IACV,EAAI,WAAW,OAAO,sBAAsB,EAAK,CAE1C,EAAI,UAAU,EAAM,EAAI,YAAY,CAAC,EAE9C,YAAc,GAAa,CACzB,EAAgB,EAAI,WAAW,CAE/B,EAAI,WAAW,OAAO,wBAAwB,EAAS,CAEvD,EAAI,YAAY,EAAS,EAE3B,YAAa,EAAI,YACjB,kBAAmB,EAAW,KAC5B,EAAgB,EAAI,WAAW,CAE/B,EAAI,WAAW,SAAS,qBAAqB,EAAW,EAAG,CAEpD,EAAI,iBAAiB,EAAW,EAAG,EAE5C,sBAAuB,EAAM,EAAS,EAAE,GAAK,CAC3C,EAAI,WAAW,OAAO,yBACpB,EACA,EACA,uBACD,CAED,GAAM,CAAE,KAAM,EAAc,OAAQ,GAAmB,EAAI,aACzD,EACA,EACD,CACK,EAAY,EAAI,mBAAmB,EAAc,EAAe,CAEjE,KAIL,OAAO,EAAI,UACT,EAAU,KACV,EAAU,OACV,EAAI,UAAU,EAAU,KAAM,EAAU,OAAO,CAC/C,EAAU,KACX,EAEH,WAAY,EAAI,WAChB,QAAS,EAAI,QACb,gBAAiB,EAAQ,IAAO,CAC9B,EAAgB,EAAI,WAAW,CAC/B,EAAI,WAAW,QAAQ,2BAA2B,EAAQ,EAAG,CAC7D,IAAI,EAAO,EAAI,aAAa,IAAI,EAAO,CASvC,OAPK,IACH,EAAO,EAAE,CACT,EAAI,aAAa,IAAI,EAAQ,EAAK,EAGpC,EAAK,KAAK,EAAG,KAEA,CACX,IAAM,EAAQ,EAAK,QAAQ,EAAG,CAE1B,IAAU,IACZ,EAAK,OAAO,EAAO,EAAE,GAI3B,eAAiB,GAAS,CACxB,IAAM,EAAQ,EAAI,eAAe,CAE5B,KAAM,QAAQ,SAAS,EAAK,CAIjC,OAAO,EAAM,kBAAkB,IAEjC,aAAe,GAAwC,CACrD,EAAgB,EAAI,WAAW,CAE/B,IAAM,EAAO,OAAO,KAAK,EAAW,CAEpC,IAAK,IAAM,KAAO,EAChB,GAAI,KAAO,EACT,MAAM,IAAI,EAAY,EAAW,gBAAiB,CAChD,QAAS,mCAAmC,EAAI,kBACjD,CAAC,CAIN,IAAK,IAAM,KAAO,EACf,EAAmC,GAAO,EAAW,GAGxD,IAAM,EAAkB,CAAE,OAAM,CAEhC,EAAI,iBAAiB,KAAK,EAAgB,CAE1C,IAAI,EAAU,GAEd,UAAa,CACX,GAAI,EACF,OAGF,EAAU,GAEV,IAAK,IAAM,KAAO,EAAgB,KAChC,OAAQ,EAAmC,GAG7C,IAAM,EAAM,EAAI,iBAAiB,QAAQ,EAAgB,CAErD,IAAQ,IACV,EAAI,iBAAiB,OAAO,EAAK,EAAE,GAI1C"}