@real-router/core 0.77.3 → 0.78.0

package/dist/esm/validation.d.mts

@@ -1,10 +1,157 @@
-import { a as validateRoute, i as RouteTree, n as Matcher, r as RouteDefinition, t as CreateMatcherOptions } from "./index-raddZEYH.mjs";
-import { a as PluginFactory, i as Limits, n as EventMethodMap, r as GuardFnFactory } from "./Router-Bm2qafJA.mjs";
-import { n as RouterValidator } from "./RouterError-OKaEXSBZ.mjs";
-import { n as SerializedRouterState } from "./index-Cwd11Hun.mjs";
-import { FSM } from "@real-router/fsm";
-import { DefaultDependencies, EventName, ForwardToCallback, GuardFn, LeaveFn, NavigationOptions, Options, Params, Plugin, RouteTreeState, Router, SimpleState, State, SubscribeFn, TreeChangedEvent, Unsubscribe } from "@real-router/types";
+import { a as MatcherInputNode, i as MatchResult, n as RouteTree, o as ResolvedMatcherOptions, r as BuildPathOptions, s as SegmentMatcherOptions, t as RouteDefinition } from "./types-xg2zHVF6.mjs";
+import { $ as State, B as PluginFactory, D as ForwardToCallback, I as LoggerConfig, J as LimitsConfig, O as GuardFn, Q as SimpleState, R as Options$1, U as Router, W as RouterLogger, X as Params, Y as NavigationOptions, at as Unsubscribe, k as GuardFnFactory, lt as RouteTreeState, u as TreeChangedEvent, v as EventMethodMap, w as DefaultDependencies, y as EventName, z as Plugin } from "./index-CAnGQpnz.mjs";
+import { t as RouterValidator } from "./RouterValidator-CZ8kPkrI.mjs";
+import { n as SerializedRouterState } from "./index-DnSU6huX.mjs";
 
+//#region src/engine/search-params/types.d.ts
+/**
+ * Search Params Type Definitions.
+ *
+ * Consolidated interfaces and type aliases for the search-params module.
+ *
+ * @module search-params/types
+ */
+/**
+ * Array parameter encoding format.
+ *
+ * @remarks
+ * - `none` - repeated keys: `a=1&a=2`
+ * - `brackets` - bracket notation: `a[]=1&a[]=2`
+ * - `index` - indexed notation: `a[0]=1&a[1]=2`
+ * - `comma` - comma-separated: `a=1,2`
+ */
+type ArrayFormat = "none" | "brackets" | "index" | "comma";
+/**
+ * Boolean parameter encoding format.
+ *
+ * @remarks
+ * - `none` - no special handling
+ * - `auto` - auto-detect "true"/"false" strings as boolean values
+ * - `empty-true` - true values have no value: `?flag` instead of `?flag=true`
+ *
+ * @remarks
+ * Under `empty-true` the bare-key wire form (`?flag`) is reserved for `true`, so
+ * a `null` value with `nullFormat: "default"` (which also encodes to a bare key)
+ * is **not representable**: it round-trips back as `true`, not `null`. Both null
+ * and true collapse to the same token and only `true` decodes back. Pair
+ * `empty-true` with `nullFormat: "hidden"`, or avoid null query values.
+ */
+type BooleanFormat = "none" | "auto" | "empty-true";
+/**
+ * Null parameter encoding format.
+ *
+ * @remarks
+ * - `default` - key only: `?key` (collides with `booleanFormat: "empty-true"`,
+ *   which reserves the bare-key form for `true` — null then decodes as `true`)
+ * - `hidden` - omit from query string
+ */
+type NullFormat = "default" | "hidden";
+/**
+ * Number parameter encoding format.
+ *
+ * @remarks
+ * - `none` - no special handling
+ * - `auto` - decode canonical decimal numbers (`/^-?(0|[1-9]\d*)(\.\d+)?$/`) to
+ *   `Number()`. Recognizes negatives so the parsed type matches what
+ *   `build`/`navigate` produce; rejects leading zeros (`"007"`), exponent
+ *   notation, unsafe integers, and negative zero (`"-0"` — the grammar matches
+ *   it, but an `Object.is` guard rejects it since `build(-0)` emits `"0"`, #898)
+ *   — those keep their exact text as strings.
+ */
+type NumberFormat = "none" | "auto";
+/**
+ * Options for search-params parsing and building.
+ */
+interface Options {
+  /** Array parameter encoding format. @default "none" */
+  arrayFormat?: ArrayFormat;
+  /** Boolean parameter encoding format. @default "auto" */
+  booleanFormat?: BooleanFormat;
+  /** Null parameter encoding format. @default "default" */
+  nullFormat?: NullFormat;
+  /** Number parameter encoding format. @default "auto" */
+  numberFormat?: NumberFormat;
+}
+//#endregion
+//#region src/engine/path-matcher/SegmentMatcher.d.ts
+declare class SegmentMatcher {
+  #private;
+  get options(): ResolvedMatcherOptions;
+  constructor(options: SegmentMatcherOptions);
+  registerTree(node: MatcherInputNode): void;
+  match(path: string): MatchResult | undefined;
+  buildPath(name: string, params?: Record<string, unknown>, options?: BuildPathOptions): string;
+  getSegmentsByName(name: string): readonly MatcherInputNode[] | undefined;
+  getMetaByName(name: string): Readonly<Record<string, Record<string, "url" | "query">>> | undefined;
+  hasRoute(name: string): boolean;
+}
+//#endregion
+//#region src/engine/createMatcher.d.ts
+/**
+ * Query string formatting options.
+ *
+ * Controls how arrays, booleans, nulls, and numbers are serialized in query strings.
+ */
+type QueryParamsConfig = Readonly<Options>;
+/**
+ * Options for creating a path matcher.
+ */
+interface CreateMatcherOptions {
+  readonly caseSensitive?: boolean;
+  readonly strictTrailingSlash?: boolean;
+  readonly strictQueryParams?: boolean;
+  readonly urlParamsEncoding?: "default" | "uri" | "uriComponent" | "none";
+  readonly queryParams?: QueryParamsConfig;
+}
+/**
+ * Path matcher instance type.
+ *
+ * Opaque type — consumers use methods (match, buildPath, hasRoute, etc.)
+ * without knowing the underlying SegmentMatcher implementation.
+ */
+type Matcher = SegmentMatcher;
+//#endregion
+//#region src/engine/validation/route-batch.d.ts
+/**
+ * Validates route structure for add operations.
+ *
+ * Performs comprehensive validation including:
+ * - Type check (must be object)
+ * - Name validation
+ * - Path validation
+ * - Duplicate name detection (in tree and batch)
+ * - Duplicate path detection (in tree and batch)
+ * - Recursive children validation
+ *
+ * @param route - Route to validate
+ * @param methodName - Calling method for error context
+ * @param rootNode - Optional root node for duplicate checking
+ * @param parentName - Parent route name for building full path (used in recursion)
+ * @param seenNames - Set of names already seen in this batch
+ * @param seenPathsByParent - Map of paths by parent for path duplicate detection
+ * @throws {TypeError} If route structure is invalid
+ * @throws {Error} If route already exists (duplicate)
+ * @throws {Error} If path already defined (duplicate)
+ *
+ * @example
+ * ```typescript
+ * const seenNames = new Set<string>();
+ * const seenPaths = new Map<string, Set<string>>();
+ *
+ * // Validate routes before adding
+ * for (const route of routes) {
+ *   validateRoute(route, "add", rootNode, "", seenNames, seenPaths);
+ * }
+ * ```
+ */
+declare function validateRoute(route: unknown, methodName: string, rootNode?: RouteTree, parentName?: string, seenNames?: Set<string>, seenPathsByParent?: Map<string, Set<string>>): asserts route is RouteDefinition;
+//#endregion
+//#region src/types/internal.d.ts
+/**
+ * Immutable limits configuration type.
+ */
+type Limits = Readonly<LimitsConfig>;
+//#endregion
 //#region src/namespaces/DependenciesNamespace/dependenciesStore.d.ts
 interface DependenciesStore<Dependencies extends DefaultDependencies = DefaultDependencies> {
   dependencies: Partial<Dependencies>;
@@ -13,6 +160,8 @@ interface DependenciesStore<Dependencies extends DefaultDependencies = DefaultDe
 //#endregion
 //#region src/namespaces/RouteLifecycleNamespace/types.d.ts
 interface RouteLifecycleDependencies<Dependencies extends DefaultDependencies = DefaultDependencies> {
+  /** Per-router logger instance (from `getInternals(router).logger`) */
+  logger: RouterLogger;
   compileFactory: (factory: GuardFnFactory<Dependencies>) => GuardFn;
   /**
    * Returns the opt-in DX validator, or `null` when no validation-plugin is
@@ -199,6 +348,8 @@ declare class RouteLifecycleNamespace<Dependencies extends DefaultDependencies =
  * avoiding the need to pass the entire Router object.
  */
 interface RoutesDependencies<Dependencies extends DefaultDependencies = DefaultDependencies> {
+  /** Per-router logger instance (from `getInternals(router).logger`) */
+  logger: RouterLogger;
   /**
    * Register a canActivate handler for a route. `precompiledFn` installs an
    * already-compiled `GuardFn` (from {@link compileGuard}) without re-invoking
@@ -282,8 +433,8 @@ interface RouterInternals<D extends DefaultDependencies = DefaultDependencies> {
   readonly makeState: <P extends Params = Params>(name: string, params?: P, path?: string, meta?: Record<string, Record<string, "url" | "query">>) => State<P>;
   readonly forwardState: <P extends Params = Params>(routeName: string, routeParams: P) => SimpleState<P>;
   readonly buildStateResolved: (resolvedName: string, resolvedParams: Params) => RouteTreeState | undefined;
-  readonly matchPath: <P extends Params = Params>(path: string, options?: Options) => State<P> | undefined;
-  readonly getOptions: () => Options;
+  readonly matchPath: <P extends Params = Params>(path: string, options?: Options$1) => State<P> | undefined;
+  readonly getOptions: () => Options$1;
   readonly addEventListener: <E extends EventName>(eventName: E, cb: Plugin[EventMethodMap[E]]) => Unsubscribe;
   /**
    * Route-tree mutation channel — internal access for the `getRoutesApi`
@@ -333,11 +484,13 @@ interface RouterInternals<D extends DefaultDependencies = DefaultDependencies> {
   readonly getTree: () => RouteTree;
   readonly isDisposed: () => boolean;
   validator: RouterValidator | null;
+  readonly logger: RouterLogger;
   readonly dependenciesGetStore: () => DependenciesStore<D>;
   readonly getCloneState: () => {
-    options: Options;
+    options: Options$1;
     dependencies: Record<string, unknown>;
     pluginFactories: PluginFactory<D>[];
+    loggerConfig: LoggerConfig;
   };
   readonly routeGetStore: () => RoutesStore<D>;
   readonly getStateName: () => string | undefined;

package/dist/esm/validation.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"validation.d.mts","names":[],"sources":["../../src/namespaces/DependenciesNamespace/dependenciesStore.ts","../../src/namespaces/RouteLifecycleNamespace/types.ts","../../src/namespaces/RouteLifecycleNamespace/RouteLifecycleNamespace.ts","../../src/namespaces/RoutesNamespace/types.ts","../../src/namespaces/RoutesNamespace/routesStore.ts","../../src/internals.ts"],"mappings":"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"}
+{"version":3,"file":"validation.d.mts","names":[],"sources":["../../src/engine/search-params/types.ts","../../src/engine/path-matcher/SegmentMatcher.ts","../../src/engine/createMatcher.ts","../../src/engine/validation/route-batch.ts","../../src/types/internal.ts","../../src/namespaces/DependenciesNamespace/dependenciesStore.ts","../../src/namespaces/RouteLifecycleNamespace/types.ts","../../src/namespaces/RouteLifecycleNamespace/RouteLifecycleNamespace.ts","../../src/namespaces/RoutesNamespace/types.ts","../../src/namespaces/RoutesNamespace/routesStore.ts","../../src/internals.ts"],"mappings":";;;;;;;;;;;;AAqBA;;;;AAAuB;AAiBvB;;;;AAAyB;KAjBb,WAAA;;;;AA2BU;AActB;;;;AAAwB;AASxB;;;;;;KAjCY,aAAA;;;;;;;;;KAUA,UAAA;;;AA+BiB;;;;AClB7B;;;;;;KDCY,YAAA;;;;UASK,OAAA;ECoJH;EDlJZ,WAAA,GAAc,WAAA;ECkJH;EDhJX,aAAA,GAAgB,aAAA;;EAEhB,UAAA,GAAa,UAAA;ECfE;EDiBf,YAAA,GAAe,YAAA;AAAA;;;cClBJ,cAAA;EAAA;MACP,OAAA,IAAW,sBAAA;cA2BH,OAAA,EAAS,qBAAA;EAiBrB,YAAA,CAAa,IAAA,EAAM,gBAAA;EAiBnB,KAAA,CAAM,IAAA,WAAe,WAAA;EA6DrB,SAAA,CACE,IAAA,UACA,MAAA,GAAS,MAAA,mBACT,OAAA,GAAU,gBAAA;EAuBZ,iBAAA,CAAkB,IAAA,oBAAwB,gBAAA;EAO1C,aAAA,CACE,IAAA,WACC,QAAA,CAAS,MAAA,SAAe,MAAA;EAI3B,QAAA,CAAS,IAAA;AAAA;;;ADzLX;;;;AAAyB;AAAzB,KEdY,iBAAA,GAAoB,QAAQ,CAAC,OAAA;;;;UAKxB,oBAAA;EAAA,SACN,aAAA;EAAA,SACA,mBAAA;EAAA,SACA,iBAAA;EAAA,SACA,iBAAA;EAAA,SACA,WAAA,GAAc,iBAAiB;AAAA;;;;;;;KAS9B,OAAA,GAAU,cAAc;;;;;;AFtBb;AAiBvB;;;;AAAyB;AAUzB;;;;AAAsB;AActB;;;;AAAwB;AASxB;;;;;;;;;;;;;iBGmUgB,aAAA,CACd,KAAA,WACA,UAAA,UACA,QAAA,GAAW,SAAA,EACX,UAAA,WACA,SAAA,GAAY,GAAA,UACZ,iBAAA,GAAoB,GAAA,SAAY,GAAA,oBACvB,KAAA,IAAS,eAAA;;;;;AHlUS;KIxBjB,MAAA,GAAS,QAAQ,CAAC,YAAA;;;UClDb,iBAAA,sBACM,mBAAA,GAAsB,mBAAA;EAE3C,YAAA,EAAc,OAAA,CAAQ,YAAA;EACtB,MAAA,EAAQ,MAAA;AAAA;;;UCCO,0BAAA,sBACM,mBAAA,GAAsB,mBAAA;;EAG3C,MAAA,EAAQ,YAAA;EAER,cAAA,GAAiB,OAAA,EAAS,cAAA,CAAe,YAAA,MAAkB,OAAA;ENKjD;;;;AAAW;EMCrB,YAAA,QAAoB,eAAA;AAAA;;;;;;;ANDtB;;;;AAAuB;AAiBvB;KOCY,eAAA;;;APDa;AAUzB;;;;AAAsB;AActB;;;;AAAwB;AASxB;;;;;;;cOVa,uBAAA,sBACU,mBAAA,GAAsB,mBAAA;EAAA;EAuC3C,eAAA,CAAgB,IAAA,EAAM,0BAAA,CAA2B,YAAA;EAIjD,eAAA,CAAgB,IAAA;EP9BhB;;;;;;;AAI2B;;;;AClB7B;;;;;;;;EM0FE,qBAAA,CACE,aAAA,EAAe,QAAA,UACf,eAAA,EAAiB,QAAA,UACjB,gBAAA;ENwDwC;;;;;;;;;;;;;;;;EMe1C,cAAA,CACE,IAAA,UACA,OAAA,EAAS,cAAA,CAAe,YAAA,aACxB,gBAAA,YACA,aAAA,GAAgB,OAAA;EN1GG;;;;;EM2HrB,gBAAA,CACE,IAAA,UACA,OAAA,EAAS,cAAA,CAAe,YAAA,aACxB,gBAAA,YACA,aAAA,GAAgB,OAAA;EN/DhB;;;;;;;;;EMoFF,gBAAA,CAAiB,IAAA,UAAc,KAAA,EAAO,eAAA;ENhD7B;;AAAY;;;;ACvMvB;;;;AAAgD;AAKhD;;;;;;EKuQE,kBAAA,CAAmB,IAAA,UAAc,KAAA,EAAO,eAAA;ELnQ/B;;;;EK2QT,QAAA;ELjQU;;;;AAAwB;;;;AC+VpC;;;;;EIxEE,qBAAA;EJ8EoB;;;;;;;;;;EI/CpB,YAAA,KACE,MAAA,SAAe,cAAA,CAAe,YAAA,IAC9B,MAAA,SAAe,cAAA,CAAe,YAAA;EJ8CvB;;;AAAwB;;EInBjC,oBAAA;IACE,UAAA,GACE,MAAA,SAAe,cAAA,CAAe,YAAA,IAC9B,MAAA,SAAe,cAAA,CAAe,YAAA;IAEhC,QAAA,GACE,MAAA,SAAe,cAAA,CAAe,YAAA,IAC9B,MAAA,SAAe,cAAA,CAAe,YAAA;EAAA;EFhYnB;;;;;EEgaf,YAAA,KAAiB,GAAA,SAAY,OAAA,GAAU,GAAA,SAAY,OAAA;EAInD,aAAA,CACE,YAAA,YACA,UAAA,YACA,OAAA,EAAS,KAAA,EACT,SAAA,EAAW,KAAA;EFpaL;;;;;;;;;;;;AAAM;EEkdd,mBAAA,CACE,OAAA,EAAS,cAAA,CAAe,YAAA,aACxB,UAAA,WACC,OAAA;AAAA;;;;;;;;APzcL;UQFiB,kBAAA,sBACM,mBAAA,GAAsB,mBAAA;;EAG3C,MAAA,EAAQ,YAAA;ERFa;AAiBvB;;;;AAAyB;EQPvB,gBAAA,GACE,IAAA,UACA,OAAA,EAAS,cAAA,CAAe,YAAA,GACxB,aAAA,GAAgB,OAAA;ERcE;EQVpB,kBAAA,GACE,IAAA,UACA,OAAA,EAAS,cAAA,CAAe,YAAA,GACxB,aAAA,GAAgB,OAAA;EROE;AAAA;AActB;;;EQbE,YAAA,GACE,OAAA,EAAS,cAAA,CAAe,YAAA,GACxB,UAAA,aACG,OAAA;ERUiB;EQPtB,SAAA,aAAsB,MAAA,GAAS,MAAA,EAC7B,IAAA,UACA,MAAA,GAAS,CAAA,EACT,IAAA,WACA,IAAA,GAAO,MAAA,SAAe,MAAA,+BACnB,KAAA,CAAM,CAAA;ERWW;EQRtB,QAAA,QAAgB,KAAA;ERUF;EQPd,cAAA,GACE,MAAA,EAAQ,KAAA,cACR,MAAA,EAAQ,KAAA,cACR,iBAAA;ERQW;EQJb,aAAA,mBAAgC,YAAA,EAAc,IAAA,EAAM,CAAA,KAAM,YAAA,CAAa,CAAA;ERM5C;EQH3B,YAAA,aAAyB,MAAA,GAAS,MAAA,EAChC,IAAA,UACA,MAAA,EAAQ,CAAA,KACL,WAAA,CAAY,CAAA;AAAA;;;;;UAOF,WAAA;ERPf;EQSA,QAAA,EAAU,MAAA,UAAgB,MAAA,EAAQ,MAAA,KAAW,MAAA;ERTlB;EQY3B,QAAA,EAAU,MAAA,UAAgB,MAAA,EAAQ,MAAA,KAAW,MAAA;;EAG7C,aAAA,EAAe,MAAA,SAAe,MAAA;;EAG9B,UAAA,EAAY,MAAA;EPpCa;EOwCzB,YAAA,EAAc,MAAA,SAAe,iBAAA;AAAA;;;UC/Dd,WAAA,sBACM,mBAAA,GAAsB,mBAAA;;ATlB7C;;;;AAAuB;AAiBvB;;;;AAAyB;AAUzB;WSKW,WAAA,EAAa,eAAA;EAAA,SACb,MAAA,EAAQ,WAAA;EACjB,IAAA,EAAM,SAAA;EACN,OAAA,EAAS,OAAA;ETMC;;;;AAAY;AASxB;EATY,SSCD,cAAA,EAAgB,GAAA;EACzB,kBAAA,EAAoB,MAAA;EACpB,iBAAA,EAAmB,MAAA,SAAe,MAAA;EAClC,QAAA;EAAA,SACS,cAAA,EAAgB,oBAAA;EACzB,SAAA,EAAW,kBAAA,CAAmB,YAAA;EAC9B,kBAAA,EAAoB,uBAAA,CAAwB,YAAA;EAAA,SACnC,kBAAA,EAAoB,GAAA,SAAY,cAAA,CAAe,YAAA;EAAA,SAC/C,oBAAA,EAAsB,GAAA,SAAY,cAAA,CAAe,YAAA;AAAA;;;UC9C3C,eAAA,WACL,mBAAA,GAAsB,mBAAA;EAAA,SAEvB,SAAA,aAAsB,MAAA,GAAS,MAAA,EACtC,IAAA,UACA,MAAA,GAAS,CAAA,EACT,IAAA,WACA,IAAA,GAAO,MAAA,SAAe,MAAA,+BACnB,KAAA,CAAM,CAAA;EAAA,SAEF,YAAA,aAAyB,MAAA,GAAS,MAAA,EACzC,SAAA,UACA,WAAA,EAAa,CAAA,KACV,WAAA,CAAY,CAAA;EAAA,SAER,kBAAA,GACP,YAAA,UACA,cAAA,EAAgB,MAAA,KACb,cAAA;EAAA,SAEI,SAAA,aAAsB,MAAA,GAAS,MAAA,EACtC,IAAA,UACA,OAAA,GAAU,SAAA,KACP,KAAA,CAAM,CAAA;EAAA,SAEF,UAAA,QAAkB,SAAA;EAAA,SAElB,gBAAA,aAA6B,SAAA,EACpC,SAAA,EAAW,CAAA,EACX,EAAA,EAAI,MAAA,CAAO,cAAA,CAAe,CAAA,OACvB,WAAA;EVjBkB;AAAA;AAUzB;;;;AAAsB;EAVG,SU0Bd,WAAA;IAAA,SACE,IAAA,GAAO,KAAA,EAAO,gBAAA;IAAA,SACd,SAAA,GACP,OAAA,GAAU,KAAA,EAAO,gBAAA,cACd,WAAA;IAAA,SACI,aAAA;IVPW;AASxB;;;IATwB,SUYX,UAAA;EAAA;EAAA,SAGF,SAAA,GAAY,KAAA,UAAe,MAAA,GAAS,MAAA;EAAA,SAEpC,mBAAA,GAAsB,KAAA,EAAO,KAAA;EVAX;;;;;;EAAA,SUQlB,qBAAA,GACP,OAAA,EAAS,KAAA,EACT,SAAA,EAAW,KAAA,cACX,IAAA,GAAO,iBAAA;EVbI;;;;AAEc;;;EAFd,SUuBJ,kBAAA,GAAqB,IAAA,aAAiB,KAAA;EAAA,SAEtC,KAAA,GAAQ,IAAA,aAAiB,OAAA,CAAQ,KAAA;ETzCjB;;;;;;EAAA,SSiDhB,eAAA,GACP,KAAA,EAAO,KAAA,EACP,OAAA,GAAU,iBAAA,KACP,OAAA,CAAQ,KAAA;EAAA,SAGJ,YAAA,EAAc,GAAA,WAEnB,IAAA,MAAU,IAAA,oBAAwB,IAAA;EAAA,SAI7B,WAAA,GAAc,QAAA;EAAA,SACd,WAAA;EAAA,SAEA,OAAA,QAAe,SAAA;EAAA,SAEf,UAAA;EAET,SAAA,EAAW,eAAA;EAAA,SAQF,MAAA,EAAQ,YAAA;EAAA,SAGR,oBAAA,QAA4B,iBAAA,CAAkB,CAAA;EAAA,SAM9C,aAAA;IACP,OAAA,EAAS,SAAA;IACT,YAAA,EAAc,MAAA;IACd,eAAA,EAAiB,aAAA,CAAc,CAAA;IAK/B,YAAA,EAAc,YAAA;EAAA;EAAA,SAIP,aAAA,QAAqB,WAAA,CAAY,CAAA;EAAA,SAGjC,YAAA;EAAA,SACA,eAAA;EAAA,SACA,UAAA;EAAA,SACA,QAAA,GAAW,KAAA,EAAO,KAAA;EAAA,SAClB,gBAAA;IAAoB,IAAA;EAAA;EAAA,SACpB,mBAAA,EAAqB,GAAA;ETqBlB;;;;;;;;;ESVZ,cAAA,EAAgB,qBAAA;AAAA;AAAA,iBAMF,YAAA,WAAuB,mBAAA,EACrC,MAAA,EAAQ,MAAA,CAAgB,CAAA,IACvB,eAAA,CAAgB,CAAA"}

package/dist/esm/validation.mjs

@@ -1 +1,2 @@
-import{l as e,n as t}from"./esm-DgICGBiW.mjs";export{e as getInternals,t as validateRoute};
+import{c as e,f as t,i as n,l as r,n as i,r as a}from"./buildParamMeta-Bl0uORu6.mjs";function o(e,t){return TypeError(`[router.${e}] ${t}`)}function s(e,t,n){if(!r(e))throw o(n,`Invalid path for route "${t}": unbalanced constraint delimiter ('<' or '>') in "${e}"`);if(e.includes(`<>`))throw o(n,`Invalid path for route "${t}": empty constraint '<>' in "${e}" (a constraint body must be non-empty, e.g. '<[0-9]+>')`)}function c(e,t,n,r){let i=new Set;for(let a of e){if(i.has(a))throw o(n,`Invalid path for route "${t}": duplicate parameter name ':${a}' in "${r}" (a param name must be unique within a route — the second binding would overwrite the first)`);i.add(a)}}function l(t,n,r,i,a){let s=new Set(t);for(let t of n){if(e.test(t))throw o(i,`Invalid path for route "${r}": invalid query-param name "${t}" in "${a}" (a query-param name cannot contain '<' or '>' — a reverse-order modifier typo that leaked a constraint into the query; put the optional '?' after the constraint, ':id<...>?')`);if(s.has(t))throw o(i,`Invalid path for route "${r}": "${t}" is declared as both a path param and a query param in "${a}" — buildPath would emit its value twice (rename one)`)}}function u(e){let t=!0,n=!1,r=!1;for(let i of e){if(r){r=i!==`>`;continue}if(i===`<`){r=!0;continue}if(i===`/`){t=!0;continue}if(t&&=(n=i===`:`||i===`*`,!1),!n&&i.codePointAt(0)>=128)return!0}return!1}function d(e){for(let t=1;t<e.length;t++)if(e[t]===`?`&&e[t-1]!==`>`&&e[t+1]===`/`&&e[t+2]===`*`)return!0;return!1}function f(e,t,r,i){if(n(e))throw o(i,`Invalid path for route "${t}": two optional params directly before a splat are not supported in "${r}" — a single trie slot carries one optional→splat fork, so the omit-outer/take-inner form would silently reshape into the splat. Split into two routes, or drop the '?' on one`);if(d(e))throw o(i,`Invalid path for route "${t}": an unconstrained optional param before a splat is not supported in "${r}" — it is ambiguous (every multi-segment value has two readings). Add a constraint (e.g. ':lang<[a-z]+>?') or model it as two routes`)}function p(e,t,n){switch(e){case`name-less`:case`trailing-marker`:return`Invalid path for route "${t}": parameter marker (':' or '*') without a name in "${n}"`;case`fused-marker`:return`Invalid path for route "${t}": parameter marker (':' or '*') must begin a segment, but "${n}" fuses one to a static prefix (use a boundary marker like "/a/:b")`;case`fused-constraint-suffix`:return`Invalid path for route "${t}": text fused to a constraint '>' in "${n}" (a '<...>' must end its segment or be followed by '/' or an optional '?' — use "/:id<...>/rest", not "/:id<...>rest")`;case`constraint-in-static`:return`Invalid path for route "${t}": constraint '<...>' in a static segment in "${n}" (a '<...>' must follow a parameter marker ':' or '*' — attach it to a param like "/:id<...>", or drop it)`;case`optional-splat`:return`Invalid path for route "${t}": optional splat ('*name?') is not supported in "${n}" — a splat cannot be optional (use a required splat '*name')`;case`unbalanced-constraint`:case`empty-constraint`:return`Invalid path for route "${t}": invalid constraint in "${n}"`}}function m(e,t,n){try{return i(e)}catch(r){throw o(n,`Invalid path for route "${t}": ${(r instanceof Error?r.message:String(r)).replace(/^\[buildParamMeta] /,``)} (in "${e}")`)}}function h(e,t,n,r){if(typeof e!=`string`){let t;throw t=e===null?`null`:Array.isArray(e)?`array`:typeof e,o(n,`Route path must be a string, got ${t}`)}if(e===``)return;if(/\s/.test(e))throw o(n,`Invalid path for route "${t}": whitespace not allowed in "${e}"`);if(!/^([/?~]|[^/]+$)/.test(e))throw o(n,`Route "${t}" has invalid path format: "${e}". Path should start with '/', '~', '?' or be a relative segment.`);if(e.includes(`//`))throw o(n,`Invalid path for route "${t}": double slashes not allowed in "${e}"`);s(e,t,n);let{pathPattern:i,urlParams:d,queryParams:h}=m(e,t,n);c(d,t,n,e),l(d,h,t,n,e);let g=a(i);if(g!==void 0)throw o(n,p(g,t,e));if(f(i,t,e,n),u(i))throw o(n,`Invalid path for route "${t}": non-ASCII static segment in "${e}" — match compares static segments raw and rejects non-ASCII input, so this route would never match. Percent-encode it (e.g. '/caf%C3%A9') or use a param`);let _=r&&r.paramMeta.urlParams.length>0;if(e.startsWith(`~`)&&_)throw o(n,`Absolute path "${e}" cannot be used under parent route with URL parameters`)}const g=/^[A-Z_a-z][\w-]*$/,_=/\S/,v=1e4;function y(e){if(e===null)return`null`;if(typeof e==`object`){try{let t=e.constructor;if(typeof t==`function`&&t.name!==`Object`)return t.name||`object`}catch{}return`object`}return typeof e}function b(e){for(let t of Object.keys(e)){let n=Object.getOwnPropertyDescriptor(e,t);if(n&&(n.get||n.set))return!0}return!1}function x(e,t){if(!e||typeof e!=`object`)throw TypeError(`[router.${t}] Route must be an object, got ${y(e)}`);let n=Object.getPrototypeOf(e);if(n!==Object.prototype&&n!==null)throw TypeError(`[router.${t}] Route must be a plain object, got ${y(e)}`);if(b(e))throw TypeError(`[router.${t}] Route must not have getters or setters`)}function S(e,t){if(e.encodeParams!==void 0&&typeof e.encodeParams!=`function`)throw TypeError(`[router.${t}] Route "${String(e.name)}" encodeParams must be a function`)}function C(e,t){if(e.decodeParams!==void 0&&typeof e.decodeParams!=`function`)throw TypeError(`[router.${t}] Route "${String(e.name)}" decodeParams must be a function`)}function w(e,t){if(typeof e.name!=`string`)throw TypeError(`[router.${t}] Route name must be a string, got ${y(e.name)}`);let n=e.name;if(n===``)throw TypeError(`[router.${t}] Route name cannot be empty`);if(!_.test(n))throw TypeError(`[router.${t}] Route name cannot contain only whitespace`);if(n.length>v)throw TypeError(`[router.${t}] Route name exceeds maximum length of ${v} characters`);if(!n.startsWith(`@@`)){if(n.includes(`.`))throw TypeError(`[router.${t}] Route name "${n}" cannot contain dots. Use children array or { parent } option in addRoute() instead.`);if(!g.test(n))throw TypeError(`[router.${t}] Invalid route name "${n}". Name must start with a letter or underscore, followed by letters, numbers, underscores, or hyphens.`)}}function T(e,t){if(!t.includes(`.`))return e.children.get(t);let n=e;for(let e of t.split(`.`))if(n=n.children.get(e),!n)return;return n}function E(e,t,n){if(T(e,t))throw Error(`[router.${n}] Route "${t}" already exists`)}function D(e,t,n){if(e.has(t))throw Error(`[router.${n}] Duplicate route "${t}" in batch`);e.add(t)}function O(e,t,n,r){let i=t===``?e:T(e,t);if(i){for(let e of i.children.values())if(e.path===n)throw Error(`[router.${r}] Path "${n}" is already defined`)}}function k(e,t,n,r){let i=e.get(t);if(i?.has(n))throw Error(`[router.${r}] Path "${n}" is already defined`);i?i.add(n):e.set(t,new Set([n]))}function A(e,t,n,r=``,i,a){x(e,t);let o=e;w(o,t),h(o.path,o.name,t,n),S(o,t),C(o,t);let s=o.name,c=r?`${r}.${s}`:s;n&&c&&E(n,c,t),i&&D(i,c,t);let l=o.path,u=r;if(n&&O(n,u,l,t),a&&k(a,u,l,t),o.children!==void 0){if(!Array.isArray(o.children))throw TypeError(`[router.${t}] Route "${s}" children must be an array, got ${y(o.children)}`);for(let e of o.children)A(e,t,n,c,i,a)}}export{t as getInternals,A as validateRoute};
+//# sourceMappingURL=validation.mjs.map

package/dist/esm/validation.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.mjs","names":[],"sources":["../../src/engine/validation/routes.ts","../../src/engine/validation/route-batch.ts"],"sourcesContent":["import {\n  buildParamMeta,\n  findSegmentGrammarError,\n  hasMultipleOptionalsBeforeSplat,\n  INVALID_QUERY_NAME_RGX,\n  isConstraintBalanced,\n} from \"../path-matcher\";\n\nimport type { SegmentErrorCode } from \"../path-matcher\";\nimport type { RouteTree } from \"../types\";\n\n/**\n * Creates a TypeError with consistent router error message format.\n *\n * @param methodName - Name of the method that triggered the error\n * @param message - Error message\n * @returns TypeError with formatted message\n * @internal\n */\nfunction createRouterError(methodName: string, message: string): TypeError {\n  return new TypeError(`[router.${methodName}] ${message}`);\n}\n\n/**\n * Validates constraint-delimiter `<...>` syntax: delimiters must be balanced\n * (#749) and the body non-empty (#804). An unbalanced `<`/`>` truncates the\n * param name and leaves the constraint as a trie literal (`buildPath` then\n * throws `Missing required param`); an empty `<>` compiles to a never-matching\n * `^()$`. `isConstraintBalanced` is path-matcher's single balance predicate,\n * which also backstops both at `registerTree` — this gate adds the\n * route-contextual message. Extracted so `validateRoutePath` stays within the\n * cognitive-complexity budget.\n */\nfunction validateConstraintSyntax(\n  path: string,\n  routeName: string,\n  methodName: string,\n): void {\n  if (!isConstraintBalanced(path)) {\n    throw createRouterError(\n      methodName,\n      `Invalid path for route \"${routeName}\": unbalanced constraint delimiter ('<' or '>') in \"${path}\"`,\n    );\n  }\n\n  if (path.includes(\"<>\")) {\n    throw createRouterError(\n      methodName,\n      `Invalid path for route \"${routeName}\": empty constraint '<>' in \"${path}\" (a constraint body must be non-empty, e.g. '<[0-9]+>')`,\n    );\n  }\n}\n\n/**\n * Rejects a param name repeated within one route's own path (`/:id/:id`, a\n * param+splat clash `/:x/*x`, #1151). `buildParamMeta.urlParams` lists every\n * path-binding name — params AND splats — in order, keeping duplicates (`/:x/*x`\n * → `[\"x\", \"x\"]`), so a single pass over it catches both. The trie binds the\n * duplicates at different positions under one name, so match's later capture\n * silently overwrites the earlier and `rewritePathOnMatch` then rewrites the\n * user's URL from the single survivor. The #736 conflict guard only fires on\n * DIFFERENTLY-named params at one position, so this same-name case slips through.\n * path-matcher's `registerTree` backstop additionally catches CROSS-level dups (a\n * parent's param reused by a child), which this per-path gate cannot see.\n * Extracted so `validateRoutePath` stays within the cognitive-complexity budget.\n */\nfunction validateUniqueParamNames(\n  urlParams: readonly string[],\n  routeName: string,\n  methodName: string,\n  path: string,\n): void {\n  const seen = new Set<string>();\n\n  for (const name of urlParams) {\n    if (seen.has(name)) {\n      throw createRouterError(\n        methodName,\n        `Invalid path for route \"${routeName}\": duplicate parameter name ':${name}' in \"${path}\" (a param name must be unique within a route — the second binding would overwrite the first)`,\n      );\n    }\n\n    seen.add(name);\n  }\n}\n\n/**\n * #1242 §5.1/§5.3: rejects a malformed query-param declaration — a query name\n * carrying `<`/`>` (a constraint leaked in via a reverse-order modifier typo\n * `:id?<c>`), or one that collides with a path-param name (`/a/:tab?tab`, where\n * buildPath emits the value twice). Narrow to `<>`: a `=` in the declaration\n * (`?tab=1`, §5.2) is tolerated today and left as a separate call. path-matcher's\n * `registerTree` backstops both; this gate adds the route-contextual message.\n */\nfunction validateQueryParamDeclarations(\n  urlParams: readonly string[],\n  queryParams: readonly string[],\n  routeName: string,\n  methodName: string,\n  path: string,\n): void {\n  const urlParamSet = new Set(urlParams);\n\n  for (const name of queryParams) {\n    if (INVALID_QUERY_NAME_RGX.test(name)) {\n      throw createRouterError(\n        methodName,\n        `Invalid path for route \"${routeName}\": invalid query-param name \"${name}\" in \"${path}\" (a query-param name cannot contain '<' or '>' — a reverse-order modifier typo that leaked a constraint into the query; put the optional '?' after the constraint, ':id<...>?')`,\n      );\n    }\n\n    if (urlParamSet.has(name)) {\n      throw createRouterError(\n        methodName,\n        `Invalid path for route \"${routeName}\": \"${name}\" is declared as both a path param and a query param in \"${path}\" — buildPath would emit its value twice (rename one)`,\n      );\n    }\n  }\n}\n\n/**\n * Reports whether a path has a raw non-ASCII code point (≥ U+0080) in a STATIC\n * segment (`/café`, `/меню`, #1154). match rejects any non-ASCII input byte\n * (`#scanPath`) and compares static trie keys raw, so such a route registers but\n * is unmatchable — `buildPath` emits `/café`, which its own `match` rejects. Only\n * static text is flagged: a marker-led segment (`:café`, a non-ASCII param NAME)\n * and a constraint body (`:id<[а-я]+>`, matched against the DECODED value) are\n * skipped. A `for…of` code-point scan tracking segment start + constraint depth\n * (constraints may contain `/`, so no split).\n */\nfunction hasNonAsciiStatic(path: string): boolean {\n  let atSegmentStart = true;\n  let segmentIsMarker = false;\n  let inConstraint = false;\n\n  for (const char of path) {\n    if (inConstraint) {\n      inConstraint = char !== \">\";\n\n      continue;\n    }\n\n    if (char === \"<\") {\n      inConstraint = true;\n\n      continue;\n    }\n\n    if (char === \"/\") {\n      atSegmentStart = true;\n\n      continue;\n    }\n\n    if (atSegmentStart) {\n      segmentIsMarker = char === \":\" || char === \"*\";\n      atSegmentStart = false;\n    }\n\n    // eslint-disable-next-line @typescript-eslint/no-non-null-assertion -- non-empty code point from for-of\n    if (!segmentIsMarker && char.codePointAt(0)! >= 0x80) {\n      return true;\n    }\n  }\n\n  return false;\n}\n\n/**\n * Reports whether a path has an UNCONSTRAINED optional param directly before a\n * splat (`/:v?/*rest`, #1264). Without a constraint there is no validity signal to\n * disambiguate \"take the optional\" from \"let the splat capture\" — every\n * multi-segment value has two readings, so support would silently reshape half the\n * input space. Rejected with a hint (product decision); a CONSTRAINED\n * optional→splat (`/:v<c>?/*rest`) IS supported. path-matcher backstops at\n * `registerTree`; this gate adds the route-contextual message.\n *\n * A linear scan (constraints may contain\n * `/`, so no split/regex): an optional marker `?` whose preceding char is NOT `>`\n * (a constrained optional ends `<…>?`) and which is immediately followed by `/*`.\n * A `?` inside a constraint (`<\\d?>`) is followed by `>`, not `/*`, so it is not\n * flagged.\n */\nfunction hasUnconstrainedOptionalBeforeSplat(path: string): boolean {\n  for (let i = 1; i < path.length; i++) {\n    if (\n      path[i] === \"?\" &&\n      path[i - 1] !== \">\" &&\n      path[i + 1] === \"/\" &&\n      path[i + 2] === \"*\"\n    ) {\n      return true;\n    }\n  }\n\n  return false;\n}\n\n/**\n * Rejects an optional param placed directly before a splat, in both shapes: TWO\n * optionals (`/:a?/:b?/*rest`, #1287 — one trie slot carries a single fork) and a\n * single UNCONSTRAINED optional (`/:v?/*rest`, #1264 — no validity signal to\n * disambiguate take-vs-skip). Both silently reshape multi-segment input.\n *\n * #1287 is checked FIRST — matching the backstop, which runs\n * `hasMultipleOptionalsBeforeSplat` in `registerNode` BEFORE `markOptionalFork`'s\n * unconstrained-splat throw. A path that triggers BOTH (`/:a?/:b?/*rest`: two\n * optionals, the inner one unconstrained before the splat) therefore reports the\n * #1287 reason on the gate AND the backstop — not #1264 on the gate and #1287 on the\n * backstop (a reject-reason divergence the parity property, which checks only the\n * boolean, would miss). #1287's \"split / drop the '?'\" is the actionable fix; the\n * #1264 \"add a constraint\" hint is a dead end here — `/:a<c>?/:b<c>?/*rest` is still\n * rejected by #1287. Only `hasMultipleOptionalsBeforeSplat` is single-sourced from\n * `parseSegment.ts` (shared with the backstop, can't drift by construction);\n * `hasUnconstrainedOptionalBeforeSplat` is a gate-local char-scan backstopped\n * separately by `throwUnconstrainedOptionalSplat`. This adds the route-contextual message.\n */\nfunction validateOptionalBeforeSplat(\n  pathPattern: string,\n  routeName: string,\n  path: string,\n  methodName: string,\n): void {\n  if (hasMultipleOptionalsBeforeSplat(pathPattern)) {\n    throw createRouterError(\n      methodName,\n      `Invalid path for route \"${routeName}\": two optional params directly before a splat are not supported in \"${path}\" — a single trie slot carries one optional→splat fork, so the omit-outer/take-inner form would silently reshape into the splat. Split into two routes, or drop the '?' on one`,\n    );\n  }\n\n  if (hasUnconstrainedOptionalBeforeSplat(pathPattern)) {\n    throw createRouterError(\n      methodName,\n      `Invalid path for route \"${routeName}\": an unconstrained optional param before a splat is not supported in \"${path}\" — it is ambiguous (every multi-segment value has two readings). Add a constraint (e.g. ':lang<[a-z]+>?') or model it as two routes`,\n    );\n  }\n}\n\n/**\n * Maps a per-segment grammar error code (from `findSegmentGrammarError`) to the\n * gate's route-contextual message. The messages are the ones the removed per-check\n * scans threw, verbatim (#1324). `trailing-marker` reuses the name-less message —\n * the gate previously lumped `:y*` there via `EMPTY_PARAM_MARKER_RGX`.\n */\nfunction gateGrammarMessage(\n  code: SegmentErrorCode,\n  routeName: string,\n  path: string,\n): string {\n  switch (code) {\n    case \"name-less\":\n    case \"trailing-marker\": {\n      return `Invalid path for route \"${routeName}\": parameter marker (':' or '*') without a name in \"${path}\"`;\n    }\n    case \"fused-marker\": {\n      return `Invalid path for route \"${routeName}\": parameter marker (':' or '*') must begin a segment, but \"${path}\" fuses one to a static prefix (use a boundary marker like \"/a/:b\")`;\n    }\n    case \"fused-constraint-suffix\": {\n      return `Invalid path for route \"${routeName}\": text fused to a constraint '>' in \"${path}\" (a '<...>' must end its segment or be followed by '/' or an optional '?' — use \"/:id<...>/rest\", not \"/:id<...>rest\")`;\n    }\n    case \"constraint-in-static\": {\n      return `Invalid path for route \"${routeName}\": constraint '<...>' in a static segment in \"${path}\" (a '<...>' must follow a parameter marker ':' or '*' — attach it to a param like \"/:id<...>\", or drop it)`;\n    }\n    case \"optional-splat\": {\n      return `Invalid path for route \"${routeName}\": optional splat ('*name?') is not supported in \"${path}\" — a splat cannot be optional (use a required splat '*name')`;\n    }\n    /* v8 ignore start -- unbalanced/empty `<>` are pre-rejected by validateConstraintSyntax above; unreachable here */\n    case \"unbalanced-constraint\":\n    case \"empty-constraint\": {\n      return `Invalid path for route \"${routeName}\": invalid constraint in \"${path}\"`;\n    }\n    /* v8 ignore stop */\n  }\n}\n\n/**\n * Calls `buildParamMeta`, re-throwing ITS own errors as the gate's\n * route-contextual `TypeError`. `buildParamMeta` compiles each constraint body to\n * a `RegExp`, so an invalid body — `<*x>`, `<(>`, `<[>` (balanced and non-empty, so\n * `validateConstraintSyntax` above lets it through, but not a valid regular\n * expression, path-matcher #1324) — throws a plain `Error` (`[buildParamMeta] …`)\n * there. Without this wrapper that single malformed class would escape the gate's\n * `[router.<method>]` contract with no route context — the one input the gate\n * rejected inconsistently with every other malformed path. path-matcher backstops\n * the same body at `registerTree`; this keeps the gate's message shape uniform.\n */\nfunction safeBuildParamMeta(\n  path: string,\n  routeName: string,\n  methodName: string,\n): ReturnType<typeof buildParamMeta> {\n  try {\n    return buildParamMeta(path);\n  } catch (error) {\n    /* v8 ignore start -- `buildParamMeta` always throws an `Error`; the `String()` arm is an unreachable defensive narrow for the `unknown` catch binding */\n    const raw = error instanceof Error ? error.message : String(error);\n    /* v8 ignore stop */\n    const detail = raw.replace(/^\\[buildParamMeta] /, \"\");\n\n    throw createRouterError(\n      methodName,\n      `Invalid path for route \"${routeName}\": ${detail} (in \"${path}\")`,\n    );\n  }\n}\n\n/**\n * Validates route path format.\n * Throws a descriptive error if validation fails.\n *\n * Allows:\n * - Empty string (for grouping/root routes)\n * - Absolute paths: /path, ~path\n * - Query strings: ?query\n * - Relative segments: segment\n *\n * Prevents:\n * - Non-string values\n * - Double slashes (//)\n * - Absolute paths (~) under parameterized parent nodes\n *\n * @param path - Route path to validate\n * @param routeName - Name of route (for error messages)\n * @param methodName - Name of calling method for error messages\n * @param parentNode - Optional parent node for context validation\n * @throws {TypeError} If path is invalid\n *\n * @example\n * // Valid paths\n * validateRoutePath(\"\", \"home\", \"add\");              // ok (empty for grouping)\n * validateRoutePath(\"/users\", \"users\", \"add\");       // ok (absolute)\n * validateRoutePath(\"~dashboard\", \"dash\", \"add\");    // ok (absolute, if no parameterized parent)\n * validateRoutePath(\"?tab=1\", \"home\", \"add\");        // ok (query)\n * validateRoutePath(\"profile\", \"users.profile\", \"add\"); // ok (relative)\n *\n * @example\n * // Invalid paths (throws)\n * validateRoutePath(\"/users//list\", \"users.list\", \"add\");           // throws (double slash)\n * validateRoutePath(\"~dash\", \"dash\", \"add\", paramParent);           // throws (~ under parameterized parent)\n */\n// A format-validation gate: a flat sequence of INDEPENDENT guard clauses (type,\n// whitespace, format, double-slash, constraint syntax, name-less / fused /\n// optional-splat / unconstrained-opt-before-splat markers, absolute-under-param).\n// Each is a simple early throw; extracting them would only scatter one checklist.\n\nexport function validateRoutePath(\n  path: unknown,\n  routeName: string,\n  methodName: string,\n  parentNode?: RouteTree,\n): asserts path is string {\n  // Type check\n  if (typeof path !== \"string\") {\n    // Get type description for error message\n    let typeDesc: string;\n\n    if (path === null) {\n      typeDesc = \"null\";\n    } else if (Array.isArray(path)) {\n      typeDesc = \"array\";\n    } else {\n      typeDesc = typeof path;\n    }\n\n    throw createRouterError(\n      methodName,\n      `Route path must be a string, got ${typeDesc}`,\n    );\n  }\n\n  // Empty path is valid (for grouping/root)\n  if (path === \"\") {\n    return;\n  }\n\n  // No whitespace characters (spaces, tabs, newlines)\n  if (/\\s/.test(path)) {\n    throw createRouterError(\n      methodName,\n      `Invalid path for route \"${routeName}\": whitespace not allowed in \"${path}\"`,\n    );\n  }\n\n  // Valid path pattern\n  if (!/^([/?~]|[^/]+$)/.test(path)) {\n    throw createRouterError(\n      methodName,\n      `Route \"${routeName}\" has invalid path format: \"${path}\". Path should start with '/', '~', '?' or be a relative segment.`,\n    );\n  }\n\n  // No double slashes\n  if (path.includes(\"//\")) {\n    throw createRouterError(\n      methodName,\n      `Invalid path for route \"${routeName}\": double slashes not allowed in \"${path}\"`,\n    );\n  }\n\n  // Constraint delimiter syntax: balanced (#749) and non-empty (#804). Both\n  // desync match vs build downstream; path-matcher backstops them at\n  // `registerTree`. Extracted to a helper to keep this function within the\n  // cognitive-complexity budget.\n  validateConstraintSyntax(path, routeName, methodName);\n\n  // Both marker checks below scan only the URL-path portion: `buildParamMeta`\n  // strips the query the same way the trie does, so a `:`/`*` inside a query\n  // declaration is not falsely flagged. Wrapped so an invalid-regex constraint\n  // body (`<*x>`) — which `buildParamMeta`'s RegExp compile throws on — surfaces as\n  // this gate's route-contextual `TypeError`, not a bare `[buildParamMeta]` Error.\n  const { pathPattern, urlParams, queryParams } = safeBuildParamMeta(\n    path,\n    routeName,\n    methodName,\n  );\n\n  // Duplicate param name within this route's own path (`/:id/:id`, `/:x/*x`, #1151).\n  validateUniqueParamNames(urlParams, routeName, methodName, path);\n\n  // Malformed query-param declarations (#1242 §5.1/§5.2/§5.3): a query name with\n  // `<>=&?#/`, or one that collides with a path-param name.\n  validateQueryParamDeclarations(\n    urlParams,\n    queryParams,\n    routeName,\n    methodName,\n    path,\n  );\n\n  // Per-segment grammar rejections via the canonical `parseSegment` tokenizer\n  // (#1324): `findSegmentGrammarError` runs the same split+parse the matcher uses,\n  // so the gate cannot drift. Replaces the five per-check scans (name-less\n  // #858/#863, fused-marker #1050, fused-constraint-suffix #1150,\n  // constraint-in-static #1311, optional-splat #1149) and adds the trailing-marker\n  // case (`:y*`, previously mis-diagnosed as name-less). Unbalanced/empty `<>` are\n  // pre-rejected by validateConstraintSyntax above, so those codes never reach here.\n  const grammarError = findSegmentGrammarError(pathPattern);\n\n  if (grammarError !== undefined) {\n    throw createRouterError(\n      methodName,\n      gateGrammarMessage(grammarError, routeName, path),\n    );\n  }\n\n  // Reject an optional param placed directly before a splat — a single\n  // UNCONSTRAINED optional (#1264) or TWO optionals (#1287). Both predicates are\n  // shared verbatim with path-matcher's `registerTree` backstop.\n  validateOptionalBeforeSplat(pathPattern, routeName, path, methodName);\n\n  // Raw non-ASCII in a STATIC segment (`/café`, `/меню`, #1154). match rejects\n  // non-ASCII input and compares static keys raw, so the route registers but never\n  // matches. Reject with the percent-encode workaround (path-matcher backstops at\n  // `registerTree`); a non-ASCII param NAME or constraint body is unaffected.\n  if (hasNonAsciiStatic(pathPattern)) {\n    throw createRouterError(\n      methodName,\n      `Invalid path for route \"${routeName}\": non-ASCII static segment in \"${path}\" — match compares static segments raw and rejects non-ASCII input, so this route would never match. Percent-encode it (e.g. '/caf%C3%A9') or use a param`,\n    );\n  }\n\n  // Absolute paths under parameterized parents\n  // Check if parent has URL parameters via paramTypeMap\n  const hasUrlParams = parentNode && parentNode.paramMeta.urlParams.length > 0;\n\n  if (path.startsWith(\"~\") && hasUrlParams) {\n    throw createRouterError(\n      methodName,\n      `Absolute path \"${path}\" cannot be used under parent route with URL parameters`,\n    );\n  }\n}\n","/**\n * Batch route validation utilities.\n *\n * Provides validation for adding routes with cross-batch duplicate detection.\n * Used by router.addRoute() to ensure atomicity - all routes validated before any modification.\n */\n\nimport { validateRoutePath } from \"./routes\";\n\nimport type { RouteDefinition, RouteTree } from \"../types\";\n\n/**\n * Pattern for route name validation.\n * Each route name must start with letter/underscore, followed by alphanumeric/hyphen/underscore.\n * Dots are NOT allowed - use children array or { parent } option in addRoute() instead.\n * Rejects: names starting with numbers/hyphens, names containing dots.\n */\nconst ROUTE_NAME_PATTERN = /^[A-Z_a-z][\\w-]*$/;\n\n/**\n * Checks if string contains at least one non-whitespace character.\n */\nconst HAS_NON_WHITESPACE = /\\S/;\n\n/**\n * Maximum route name length to prevent DoS and performance issues.\n */\nconst MAX_ROUTE_NAME_LENGTH = 10_000;\n\n/**\n * Gets a human-readable description of a value's type.\n * Used for error messages to provide helpful debugging information.\n */\nfunction getTypeDescription(value: unknown): string {\n  // Handle null explicitly (typeof null === \"object\")\n  if (value === null) {\n    return \"null\";\n  }\n\n  if (typeof value === \"object\") {\n    // Read `constructor`/`.name` defensively: an adversarial own `constructor`\n    // (null, a string, a number, …) is not a real constructor and must not crash\n    // here nor yield a non-string (#903); a THROWING accessor — a `constructor`\n    // getter, a function constructor with a throwing `.name` getter, or a Proxy\n    // that throws on [[Get]] — must not crash either (#1052). Both fall back to\n    // \"object\". (Byte-identical twin of type-guards' getTypeDescription —\n    // route-tree has no type-guards dependency, so the hardening is duplicated.)\n    try {\n      const ctor: unknown = (value as { constructor?: unknown }).constructor;\n\n      // Return constructor name for class instances\n      if (typeof ctor === \"function\" && ctor.name !== \"Object\") {\n        return ctor.name || \"object\"; // empty name (anonymous class) → \"object\"\n      }\n    } catch {\n      // Throwing constructor/.name getter or Proxy [[Get]] → fall through (#1052).\n    }\n\n    // Plain object\n    return \"object\";\n  }\n\n  // Primitive types (string, number, boolean, undefined, etc.)\n  return typeof value;\n}\n\n/**\n * Checks if an object has getters or setters.\n * Used to detect potentially malicious route objects that could mutate during processing.\n *\n * @param obj - Object to check\n * @returns true if object has getters or setters\n */\nfunction hasGettersOrSetters(obj: Record<string, unknown>): boolean {\n  for (const key of Object.keys(obj)) {\n    const descriptor = Object.getOwnPropertyDescriptor(obj, key);\n\n    if (descriptor && (descriptor.get || descriptor.set)) {\n      return true;\n    }\n  }\n\n  return false;\n}\n\n/**\n * Validates that route is a plain object without getters/setters.\n * Prevents malicious objects that could mutate during processing.\n *\n * @param route - Route to validate\n * @param methodName - Calling method for error context\n * @throws {TypeError} If route is not a plain object\n */\nfunction validateRouteType(\n  route: unknown,\n  methodName: string,\n): asserts route is Record<string, unknown> {\n  if (!route || typeof route !== \"object\") {\n    throw new TypeError(\n      `[router.${methodName}] Route must be an object, got ${getTypeDescription(route)}`,\n    );\n  }\n\n  // Check for plain object (prototype must be Object.prototype or null)\n  const proto: object | null = Object.getPrototypeOf(route) as object | null;\n\n  if (proto !== Object.prototype && proto !== null) {\n    throw new TypeError(\n      `[router.${methodName}] Route must be a plain object, got ${getTypeDescription(route)}`,\n    );\n  }\n\n  // Check for getters/setters (could cause mutations during processing)\n  if (hasGettersOrSetters(route as Record<string, unknown>)) {\n    throw new TypeError(\n      `[router.${methodName}] Route must not have getters or setters`,\n    );\n  }\n}\n\n/**\n * Validates that encodeParams is a function if provided.\n *\n * @param route - Route configuration\n * @param methodName - Calling method for error context\n * @throws {TypeError} If encodeParams is not a function\n */\nfunction validateEncodeParams(\n  route: Record<string, unknown>,\n  methodName: string,\n): void {\n  if (\n    route.encodeParams !== undefined &&\n    typeof route.encodeParams !== \"function\"\n  ) {\n    throw new TypeError(\n      `[router.${methodName}] Route \"${String(route.name)}\" encodeParams must be a function`,\n    );\n  }\n}\n\n/**\n * Validates that decodeParams is a function if provided.\n *\n * @param route - Route configuration\n * @param methodName - Calling method for error context\n * @throws {TypeError} If decodeParams is not a function\n */\nfunction validateDecodeParams(\n  route: Record<string, unknown>,\n  methodName: string,\n): void {\n  if (\n    route.decodeParams !== undefined &&\n    typeof route.decodeParams !== \"function\"\n  ) {\n    throw new TypeError(\n      `[router.${methodName}] Route \"${String(route.name)}\" decodeParams must be a function`,\n    );\n  }\n}\n\n/**\n * Validates that route name is a valid string matching the expected format.\n *\n * Route name rules:\n * - Must be a string\n * - Cannot be empty or whitespace-only\n * - Cannot contain dots (use children array or { parent } option instead)\n * - Must match [a-zA-Z_][a-zA-Z0-9_-]*\n *\n * @param route - Route configuration\n * @param methodName - Calling method for error context\n * @throws {TypeError} If name is missing, not a string, or invalid format\n */\nfunction validateRouteName(\n  route: Record<string, unknown>,\n  methodName: string,\n): asserts route is Record<string, unknown> & { name: string } {\n  if (typeof route.name !== \"string\") {\n    throw new TypeError(\n      `[router.${methodName}] Route name must be a string, got ${getTypeDescription(route.name)}`,\n    );\n  }\n\n  const name = route.name;\n\n  // Empty string is not allowed for addRoute (unlike root node in type-guards)\n  if (name === \"\") {\n    throw new TypeError(`[router.${methodName}] Route name cannot be empty`);\n  }\n\n  // Whitespace-only strings are invalid\n  if (!HAS_NON_WHITESPACE.test(name)) {\n    throw new TypeError(\n      `[router.${methodName}] Route name cannot contain only whitespace`,\n    );\n  }\n\n  // Length check for technical safety\n  if (name.length > MAX_ROUTE_NAME_LENGTH) {\n    throw new TypeError(\n      `[router.${methodName}] Route name exceeds maximum length of ${MAX_ROUTE_NAME_LENGTH} characters`,\n    );\n  }\n\n  // System routes bypass pattern validation (e.g., @@router/UNKNOWN_ROUTE)\n  if (name.startsWith(\"@@\")) {\n    return;\n  }\n\n  // Dots are not allowed in route names\n  if (name.includes(\".\")) {\n    throw new TypeError(\n      `[router.${methodName}] Route name \"${name}\" cannot contain dots. ` +\n        `Use children array or { parent } option in addRoute() instead.`,\n    );\n  }\n\n  // Validate route pattern (ASCII only: letters, numbers, underscores, hyphens)\n  if (!ROUTE_NAME_PATTERN.test(name)) {\n    throw new TypeError(\n      `[router.${methodName}] Invalid route name \"${name}\". ` +\n        `Name must start with a letter or underscore, ` +\n        `followed by letters, numbers, underscores, or hyphens.`,\n    );\n  }\n}\n\n/**\n * Finds a node by its fullName in the tree.\n * Even though user-provided route names cannot contain dots,\n * fullName is computed during validation (e.g., \"parent.child\").\n *\n * @param rootNode - Root node to start from\n * @param fullName - Full route name (e.g., \"users.profile\")\n * @returns The resolved node, or undefined if not found\n */\nfunction findNodeByFullName(\n  rootNode: RouteTree,\n  fullName: string,\n): RouteTree | undefined {\n  // Fast path: single-segment names don't need splitting\n  // Stryker disable next-line ConditionalExpression,StringLiteral,BlockStatement: equivalent — the fast path is a pure optimization; for a dotless name the general path below yields the identical result (`name.split(\".\")` → `[name]`, a one-iteration `children.get(name)`). (BooleanLiteral stays live: dropping the `!` runs the fast path for a dotted name → `children.get(\"a.b\")` is undefined = killed.)\n  if (!fullName.includes(\".\")) {\n    return rootNode.children.get(fullName);\n  }\n\n  let current: RouteTree | undefined = rootNode;\n\n  for (const segment of fullName.split(\".\")) {\n    current = current.children.get(segment);\n\n    if (!current) {\n      return undefined;\n    }\n  }\n\n  return current;\n}\n\n/**\n * Checks for duplicate route name in existing tree.\n *\n * @param rootNode - Root node to search in\n * @param fullName - Full route name (dot-notation)\n * @param methodName - Calling method for error context\n * @throws {Error} If route name already exists\n */\nfunction checkTreeNameDuplicate(\n  rootNode: RouteTree,\n  fullName: string,\n  methodName: string,\n): void {\n  if (findNodeByFullName(rootNode, fullName)) {\n    throw new Error(\n      `[router.${methodName}] Route \"${fullName}\" already exists`,\n    );\n  }\n}\n\n/**\n * Checks for duplicate route name in current batch.\n *\n * @param seenNames - Set of names already seen in batch\n * @param fullName - Full route name to check\n * @param methodName - Calling method for error context\n * @throws {Error} If duplicate name in batch\n */\nfunction checkBatchNameDuplicate(\n  seenNames: Set<string>,\n  fullName: string,\n  methodName: string,\n): void {\n  if (seenNames.has(fullName)) {\n    throw new Error(\n      `[router.${methodName}] Duplicate route \"${fullName}\" in batch`,\n    );\n  }\n\n  seenNames.add(fullName);\n}\n\n/**\n * Checks for duplicate path in existing tree at same parent level.\n *\n * @param rootNode - Root node to search in\n * @param parentName - Parent route name (empty string for root level)\n * @param routePath - Path to check for duplicates\n * @throws {Error} If path already exists at this level\n */\nfunction checkTreePathDuplicate(\n  rootNode: RouteTree,\n  parentName: string,\n  routePath: string,\n  methodName: string,\n): void {\n  const parentNode =\n    parentName === \"\" ? rootNode : findNodeByFullName(rootNode, parentName);\n\n  if (!parentNode) {\n    return; // Parent doesn't exist, so no duplicate\n  }\n\n  for (const child of parentNode.children.values()) {\n    if (child.path === routePath) {\n      throw new Error(\n        `[router.${methodName}] Path \"${routePath}\" is already defined`,\n      );\n    }\n  }\n}\n\n/**\n * Checks for duplicate path in current batch at same parent level.\n *\n * @param seenPathsByParent - Map of paths by parent name\n * @param parentName - Parent route name (empty string for root level)\n * @param routePath - Path to check for duplicates\n * @throws {Error} If path already exists at this level in batch\n */\nfunction checkBatchPathDuplicate(\n  seenPathsByParent: Map<string, Set<string>>,\n  parentName: string,\n  routePath: string,\n  methodName: string,\n): void {\n  const pathsAtLevel = seenPathsByParent.get(parentName);\n\n  if (pathsAtLevel?.has(routePath)) {\n    throw new Error(\n      `[router.${methodName}] Path \"${routePath}\" is already defined`,\n    );\n  }\n\n  if (pathsAtLevel) {\n    pathsAtLevel.add(routePath);\n  } else {\n    seenPathsByParent.set(parentName, new Set([routePath]));\n  }\n}\n\n/**\n * Validates route structure for add operations.\n *\n * Performs comprehensive validation including:\n * - Type check (must be object)\n * - Name validation\n * - Path validation\n * - Duplicate name detection (in tree and batch)\n * - Duplicate path detection (in tree and batch)\n * - Recursive children validation\n *\n * @param route - Route to validate\n * @param methodName - Calling method for error context\n * @param rootNode - Optional root node for duplicate checking\n * @param parentName - Parent route name for building full path (used in recursion)\n * @param seenNames - Set of names already seen in this batch\n * @param seenPathsByParent - Map of paths by parent for path duplicate detection\n * @throws {TypeError} If route structure is invalid\n * @throws {Error} If route already exists (duplicate)\n * @throws {Error} If path already defined (duplicate)\n *\n * @example\n * ```typescript\n * const seenNames = new Set<string>();\n * const seenPaths = new Map<string, Set<string>>();\n *\n * // Validate routes before adding\n * for (const route of routes) {\n *   validateRoute(route, \"add\", rootNode, \"\", seenNames, seenPaths);\n * }\n * ```\n */\nexport function validateRoute(\n  route: unknown,\n  methodName: string,\n  rootNode?: RouteTree,\n  parentName = \"\",\n  seenNames?: Set<string>,\n  seenPathsByParent?: Map<string, Set<string>>,\n): asserts route is RouteDefinition {\n  validateRouteType(route, methodName);\n\n  const routeDef = route;\n\n  // Validate that name is a non-empty string\n  validateRouteName(routeDef, methodName);\n\n  // Validate path structure\n  validateRoutePath(routeDef.path, routeDef.name, methodName, rootNode);\n\n  // Validate optional function properties\n  validateEncodeParams(routeDef, methodName);\n  validateDecodeParams(routeDef, methodName);\n\n  const routeName = routeDef.name;\n  const fullName = parentName ? `${parentName}.${routeName}` : routeName;\n\n  // Check for duplicate name in existing tree\n  if (rootNode && fullName) {\n    checkTreeNameDuplicate(rootNode, fullName, methodName);\n  }\n\n  // Check for duplicate name in current batch\n  if (seenNames) {\n    checkBatchNameDuplicate(seenNames, fullName, methodName);\n  }\n\n  const routePath = routeDef.path;\n  const pathCheckParent = parentName;\n\n  // Check for duplicate path in existing tree\n  if (rootNode) {\n    checkTreePathDuplicate(rootNode, pathCheckParent, routePath, methodName);\n  }\n\n  // Check for duplicate path in current batch\n  if (seenPathsByParent) {\n    checkBatchPathDuplicate(\n      seenPathsByParent,\n      pathCheckParent,\n      routePath,\n      methodName,\n    );\n  }\n\n  // Validate children recursively\n  if (routeDef.children !== undefined) {\n    if (!Array.isArray(routeDef.children)) {\n      throw new TypeError(\n        `[router.${methodName}] Route \"${routeName}\" children must be an array, got ${getTypeDescription(routeDef.children)}`,\n      );\n    }\n\n    for (const child of routeDef.children) {\n      validateRoute(\n        child,\n        methodName,\n        rootNode,\n        fullName,\n        seenNames,\n        seenPathsByParent,\n      );\n    }\n  }\n}\n"],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@real-router/core",
-  "version": "0.77.3",
+  "version": "0.78.0",
   "type": "commonjs",
   "description": "A simple, powerful, view-agnostic, modular and extensible router",
   "main": "./dist/cjs/index.js",
@@ -8,6 +8,9 @@
   "types": "./dist/esm/index.d.mts",
   "typesVersions": {
     "*": {
+      "types": [
+        "./dist/cjs/types.d.ts"
+      ],
       "api": [
         "./dist/cjs/api.d.ts"
       ],
@@ -29,6 +32,15 @@
       "import": "./dist/esm/index.mjs",
       "require": "./dist/cjs/index.js"
     },
+    "./types": {
+      "@real-router/internal-source": "./src/types/index.ts",
+      "types": {
+        "import": "./dist/esm/types.d.mts",
+        "require": "./dist/cjs/types.d.ts"
+      },
+      "import": "./dist/esm/types.mjs",
+      "require": "./dist/cjs/types.js"
+    },
     "./api": {
       "@real-router/internal-source": "./src/api/index.ts",
       "types": {
@@ -85,19 +97,10 @@
   },
   "homepage": "https://github.com/greydragon888/real-router",
   "sideEffects": false,
-  "dependencies": {
-    "@real-router/logger": "^0.3.3",
-    "@real-router/fsm": "^0.6.1",
-    "@real-router/types": "^0.39.2"
-  },
-  "devDependencies": {
-    "event-emitter": "^0.1.2",
-    "route-tree": "^0.3.4"
-  },
   "scripts": {
-    "test": "vitest run functional/",
+    "test": "vitest run",
     "test:properties": "vitest run --config vitest.config.properties.mts",
-    "test:coverage": "vitest run functional/ --coverage",
+    "test:coverage": "vitest run --coverage",
     "test:stress": "vitest run --config vitest.config.stress.mts",
     "test:mutation": "stryker run",
     "test:mutation:report": "open reports/mutation-report.html",

package/dist/cjs/Router-CLGzVSB7.js

@@ -1,2 +0,0 @@
-const e=require("./esm-6qkkdCI3.js");let t=require("@real-router/logger"),n=require("@real-router/fsm");const r={maxListeners:0,warnListeners:0};var i=class{#e=new Map;#t=new Set;#n=null;#r=r;#i;#a;constructor(e){e?.limits&&(this.#r=e.limits),this.#i=e?.onListenerError??null,this.#a=e?.onListenerWarn??null}static validateCallback(e,t){if(typeof e!=`function`)throw TypeError(`Expected callback to be a function for event ${t}`)}setLimits(e){this.#r=e}on(e,t){let n=this.#e.get(e),r=n?.size??0;if(n?.has(t))throw Error(`Duplicate listener for "${e}"`);let{maxListeners:i,warnListeners:a}=this.#r;if(i!==0&&r>=i)throw Error(`Listener limit (${i}) reached for "${e}"`);a!==0&&r===a&&this.#a!==null&&(this.#n??=new Set,this.#n.has(e)||(this.#a(e,a),this.#n.add(e)));let o=n;return o===void 0&&(o=new Set,this.#e.set(e,o)),o.add(t),()=>{this.off(e,t)}}off(e,t){let n=this.#e.get(e);n&&(n.delete(t),n.size===0&&(this.#e.delete(e),this.#n?.delete(e)))}emit(e,t,n,r,i){let a=this.#e.get(e);if(!a||a.size===0||this.#t.has(e))return;let o=arguments.length-1;this.#t.add(e);try{if(a.size===1){let[s]=a;this.#o(e,s,o,t,n,r,i)}else{let s=[...a];for(let a of s)this.#o(e,a,o,t,n,r,i)}}finally{this.#t.delete(e)}}clearAll(){this.#e.clear(),this.#n=null}listenerCount(e){return this.#e.get(e)?.size??0}isDispatching(e){return this.#t.has(e)}#o(e,t,n,r,i,a,o){try{let s=this.#s(t,n,r,i,a,o);s!=null&&typeof s.then==`function`&&Promise.resolve(s).catch(t=>{this.#i?.(e,t)})}catch(t){this.#i?.(e,t)}}#s(e,t,n,r,i,a){switch(t){case 0:return e();case 1:return e(n);case 2:return e(n,r);case 3:return e(n,r,i);default:return e(n,r,i,a)}}};const a=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`,CONTEXT_NAMESPACE_ALREADY_CLAIMED:`CONTEXT_NAMESPACE_ALREADY_CLAIMED`,REENTRANT_NAVIGATION:`REENTRANT_NAVIGATION`,REENTRANT_TREE_MUTATION:`REENTRANT_TREE_MUTATION`}),o=`@@router/UNKNOWN_ROUTE`,s={UNKNOWN_ROUTE:o},c={ROUTER_START:`onStart`,ROUTER_STOP:`onStop`,TRANSITION_START:`onTransitionStart`,TRANSITION_LEAVE_APPROVE:`onTransitionLeaveApprove`,TRANSITION_CANCEL:`onTransitionCancel`,TRANSITION_SUCCESS:`onTransitionSuccess`,TRANSITION_ERROR:`onTransitionError`},l={ROUTER_START:`$start`,ROUTER_STOP:`$stop`,TRANSITION_START:`$$start`,TRANSITION_LEAVE_APPROVE:`$$leaveApprove`,TRANSITION_CANCEL:`$$cancel`,TRANSITION_SUCCESS:`$$success`,TRANSITION_ERROR:`$$error`},u={maxDependencies:100,maxPlugins:50,maxListeners:1e4,warnListeners:1e3,maxLifecycleHandlers:200},d=Object.freeze({}),f=Object.freeze({deactivated:Object.freeze([]),activated:Object.freeze([]),intersection:``}),p=Object.freeze({phase:`activating`,reason:`success`,segments:f}),m={IDLE:`IDLE`,STARTING:`STARTING`,READY:`READY`,TRANSITION_STARTED:`TRANSITION_STARTED`,LEAVE_APPROVED:`LEAVE_APPROVED`,DISPOSED:`DISPOSED`},h={START:`START`,STARTED:`STARTED`,NAVIGATE:`NAVIGATE`,LEAVE_APPROVE:`LEAVE_APPROVE`,COMPLETE:`COMPLETE`,FAIL:`FAIL`,CANCEL:`CANCEL`,STOP:`STOP`,DISPOSE:`DISPOSE`},g={initial:m.IDLE,context:null,transitions:{[m.IDLE]:{[h.START]:m.STARTING,[h.DISPOSE]:m.DISPOSED},[m.STARTING]:{[h.STARTED]:m.READY,[h.FAIL]:m.IDLE,[h.STOP]:m.IDLE,[h.DISPOSE]:m.DISPOSED},[m.READY]:{[h.NAVIGATE]:m.TRANSITION_STARTED,[h.FAIL]:m.READY,[h.STOP]:m.IDLE,[h.DISPOSE]:m.DISPOSED},[m.TRANSITION_STARTED]:{[h.NAVIGATE]:m.TRANSITION_STARTED,[h.LEAVE_APPROVE]:m.LEAVE_APPROVED,[h.CANCEL]:m.READY,[h.FAIL]:m.READY,[h.DISPOSE]:m.DISPOSED},[m.LEAVE_APPROVED]:{[h.NAVIGATE]:m.TRANSITION_STARTED,[h.COMPLETE]:m.READY,[h.CANCEL]:m.READY,[h.FAIL]:m.READY,[h.DISPOSE]:m.DISPOSED},[m.DISPOSED]:{}}};function ee(){return new n.FSM(g)}function te(e){if(!e||typeof e!=`object`||e.constructor!==Object)throw TypeError(`dependencies must be a plain object`);for(let t in e)if(Object.getOwnPropertyDescriptor(e,t)?.get)throw TypeError(`dependencies cannot contain getters: "${t}"`)}function _(e,t){for(let n of e){let e=n;if(typeof e!=`object`||!e||Array.isArray(e))throw TypeError(`route must be a non-array object`);t?.routes.guardRouteCallbacks(n),t?.routes.guardNoAsyncCallbacks(n);let r=n.children;r&&_(r,t)}}function v(e){return Object.freeze(e)}function ne(e={}){return{...u,...e}}function y(e){if(e===void 0)return e;let t;for(let n in e){if(!Object.hasOwn(e,n))continue;let r=e[n];r!==void 0&&(t??={},t[n]=r)}return t??d}function re(e={}){let t=Object.create(null);for(let n in e)e[n]!==void 0&&(t[n]=e[n]);return{dependencies:t,limits:u}}const ie={defaultRoute:``,defaultParams:{},trailingSlash:`preserve`,caseSensitive:!0,queryParamsMode:`loose`,queryParams:e.o,urlParamsEncoding:`default`,allowNotFound:!0,rewritePathOnMatch:!0};function ae(e){Object.freeze(e);for(let t of Object.values(e))t&&typeof t==`object`&&t.constructor===Object&&ae(t);return e}function oe(e,t){return typeof e==`function`?e(t):e}function se(e){if(!e||typeof e!=`object`||Array.isArray(e))throw TypeError(`[router.constructor] options must be a plain object`)}var ce=class{#e;constructor(e={}){this.#e=ae({...ie,...e})}static validateOptionsIsObject(e){se(e)}get(){return this.#e}};function b(e,t){if(e===t)return!0;if(Array.isArray(e)&&Array.isArray(t)){if(e.length!==t.length)return!1;for(let n=0;n<e.length;n++)if(!b(e[n],t[n]))return!1;return!0}return!1}const le=new WeakMap;function x(e){return le.get(e)}function S(e,t){le.set(e,t)}var ue=class{#e=void 0;#t=void 0;#n;get(){return this.#e}set(e){this.#t=this.#e,this.#e=e?v(e):void 0}getPrevious(){return this.#t}reset(){this.#e=void 0,this.#t=void 0}setDependencies(e){this.#n=e}makeState(e,t,n,r,i){let a=this.#n.getDefaultParams(),o=Object.hasOwn(a,e),s;s=o?Object.freeze({...a[e],...t}):!t||t===d?d:Object.freeze({...t});let c={name:e,params:s,path:n??this.#n.buildPath(e,t),context:{},...!i&&{transition:p}};return r&&S(c,r),i?c:v(c)}areStatesEqual(e,t,n=!0){if(!e||!t)return!!e==!!t;if(e.name!==t.name)return!1;if(n){let n=this.#n.getUrlParams(e.name);for(let r of n)if(!b(e.params[r],t.params[r]))return!1;return!0}let r=Object.keys(e.params),i=Object.keys(t.params);if(r.length!==i.length)return!1;for(let n of r)if(!(n in t.params)||!b(e.params[n],t.params[n]))return!1;return!0}};const de={[c.ROUTER_START]:l.ROUTER_START,[c.ROUTER_STOP]:l.ROUTER_STOP,[c.TRANSITION_SUCCESS]:l.TRANSITION_SUCCESS,[c.TRANSITION_START]:l.TRANSITION_START,[c.TRANSITION_LEAVE_APPROVE]:l.TRANSITION_LEAVE_APPROVE,[c.TRANSITION_ERROR]:l.TRANSITION_ERROR,[c.TRANSITION_CANCEL]:l.TRANSITION_CANCEL},fe=Object.keys(de),C=`router.usePlugin`;function pe(e){if(!(e&&typeof e==`object`)||Array.isArray(e))throw TypeError(`[router.usePlugin] Plugin factory must return an object, got ${typeof e}`);if(typeof e.then==`function`)throw TypeError(`[router.usePlugin] Async plugin factories are not supported. Factory returned a Promise instead of a plugin object.`)}var me=class e{#e=new Set;#t=new Set;#n;static validatePlugin(e){pe(e)}setDependencies(e){this.#n=e}count(){return this.#e.size}use(...e){if(this.#n.getValidator()?.plugins.validateCountThresholds(this.#e.size+e.length),e.length===1){let n=e[0],r=this.#i(n);this.#e.add(n);let i=!1,a=()=>{if(!i){i=!0,this.#e.delete(n),this.#t.delete(a);try{r()}catch(e){t.logger.error(C,`Error during cleanup:`,e)}}};return this.#t.add(a),a}let n=this.#r(e),r=[];try{for(let e of n){let t=this.#i(e);r.push({factory:e,cleanup:t})}}catch(e){for(let{cleanup:e}of r)try{e()}catch(e){t.logger.error(C,`Cleanup error:`,e)}throw e}for(let{factory:e}of r)this.#e.add(e);let i=!1,a=()=>{if(!i){i=!0,this.#t.delete(a);for(let{factory:e}of r)this.#e.delete(e);for(let{cleanup:e}of r)try{e()}catch(e){t.logger.error(C,`Error during cleanup:`,e)}}};return this.#t.add(a),a}getAll(){return[...this.#e]}has(e){return this.#e.has(e)}disposeAll(){for(let e of this.#t)e();this.#e.clear(),this.#t.clear()}#r(e){let t=new Set;for(let n of e)t.has(n)?this.#n.getValidator()?.plugins.warnBatchDuplicates(e):t.add(n);return t}#i(t){let n=this.#n.compileFactory(t);e.validatePlugin(n),this.#n.getValidator()?.plugins.validatePluginKeys(n),Object.freeze(n);let r=[];for(let e of fe)e in n&&(typeof n[e]==`function`?(r.push(this.#n.addEventListener(de[e],n[e])),e===`onStart`&&this.#n.canNavigate()&&this.#n.getValidator()?.plugins.warnPluginAfterStart(e)):this.#n.getValidator()?.plugins.warnPluginMethodType(e));return()=>{for(let e of r)e();typeof n.teardown==`function`&&n.teardown()}}};const he=()=>!0,ge=()=>!1,_e=()=>he,ve=()=>ge;function ye(e){return e?_e:ve}var be=class{#e=new Map;#t=new Map;#n=new Map;#r=new Map;#i=new Map;#a=new Map;#o=[this.#i,this.#a];#s;setDependencies(e){this.#s=e}getHandlerCount(e){let t=e===`activate`?this.#e:this.#n,n=e===`activate`?this.#t:this.#r;if(t.size===0)return n.size;if(n.size===0)return t.size;let r=new Set(t.keys());for(let e of n.keys())r.add(e);return r.size}preflightHandlerLimit(e,t,n){let r=this.#s.getValidator();if(!r)return;let i=(e,t,i)=>{let{definition:a,external:o}=this.#d(e),s=0;for(let e of t)(n?o.has(e):a.has(e)||o.has(e))||s++;if(s===0)return;let c=n?o.size:this.getHandlerCount(e);r.lifecycle.validateHandlerLimit(c+s-1,i)};i(`activate`,e,`canActivate`),i(`deactivate`,t,`canDeactivate`)}addCanActivate(e,t,n=!1,r){this.#c(`activate`,e,t,n,`canActivate`,r)}addCanDeactivate(e,t,n=!1,r){this.#c(`deactivate`,e,t,n,`canDeactivate`,r)}clearCanActivate(e,t){this.#l(`activate`,e,t)}clearCanDeactivate(e,t){this.#l(`deactivate`,e,t)}clearAll(){this.#e.clear(),this.#t.clear(),this.#n.clear(),this.#r.clear(),this.#a.clear(),this.#i.clear()}clearDefinitionGuards(){for(let e of this.#e.keys())this.#t.has(e)?this.#u(`activate`,e):this.#a.delete(e);for(let e of this.#n.keys())this.#r.has(e)?this.#u(`deactivate`,e):this.#i.delete(e);this.#e.clear(),this.#n.clear()}getFactories(){let e={},t={};for(let[t,n]of this.#n)e[t]=n;for(let[t,n]of this.#r)e[t]=n;for(let[e,n]of this.#e)t[e]=n;for(let[e,n]of this.#t)t[e]=n;return[e,t]}getFactoriesByOrigin(){let e={},t={},n={},r={};for(let[t,n]of this.#n)e[t]=n;for(let[e,n]of this.#e)t[e]=n;for(let[e,t]of this.#r)n[e]=t;for(let[e,t]of this.#t)r[e]=t;return{definition:[e,t],external:[n,r]}}getFunctions(){return this.#o}canNavigateTo(e,t,n,r){for(let t of e)if(!this.#f(this.#i,t,n,r,`canNavigateTo`))return!1;for(let e of t)if(!this.#f(this.#a,e,n,r,`canNavigateTo`))return!1;return!0}compileGuardFactory(e,t){let n=typeof e==`boolean`?ye(e):e,r=this.#s.compileFactory(n);if(typeof r!=`function`)throw TypeError(`[router.${t}] Factory must return a function, got ${typeof r}`);return r}#c(e,t,n,r,i,a){let o=this.#d(e),s=e===`activate`?this.#a:this.#i,c=r?o.definition:o.external,l=r?o.external:o.definition;if(c.has(t)||l.has(t))this.#s.getValidator()?.lifecycle.warnOverwrite(t,e,i);else{let t=this.#s.getValidator();if(t){let n=this.getHandlerCount(e);t.lifecycle.validateHandlerLimit(n,i),t.lifecycle.validateCountThresholds(n+1,i)}}let u=typeof n==`boolean`?ye(n):n,d=c.get(t);c.set(t,u);let f=r&&l.has(t);try{let e=a??this.compileGuardFactory(u,i);f||s.set(t,e)}catch(n){throw d===void 0?c.delete(t):c.set(t,d),this.#u(e,t),n}}#l(e,t,n){let{definition:r,external:i}=this.#d(e),a=n===`external`?!1:r.delete(t),o=n===`definition`?!1:i.delete(t);(a||o)&&this.#u(e,t)}#u(e,t){let n=this.#d(e),r=e===`activate`?this.#a:this.#i,i=n.external.get(t)??n.definition.get(t);if(!i){r.delete(t);return}try{let e=this.#s.compileFactory(i);if(typeof e!=`function`){r.delete(t);return}r.set(t,e)}catch{r.delete(t)}}#d(e){return e===`activate`?{definition:this.#e,external:this.#t}:{definition:this.#n,external:this.#r}}#f(e,n,r,i,a){let o=e.get(n);if(!o)return!0;try{let e=o(r,i);return typeof e==`boolean`?e:(this.#s.getValidator()?.lifecycle.warnAsyncGuardSync(n,a),!1)}catch(e){return t.logger.warn(`router.${a}`,`Guard for "${n}" threw — treated as navigation-blocking (returned false)`,e),!1}}};const xe=new Set([`name`,`path`,`children`,`canActivate`,`canDeactivate`,`forwardTo`,`encodeParams`,`decodeParams`,`defaultParams`]);function w(){return{decoders:Object.create(null),encoders:Object.create(null),defaultParams:Object.create(null),forwardMap:Object.create(null),forwardFnMap:Object.create(null)}}function Se(e,t){for(let n of Object.keys(t))Object.assign(e[n],t[n])}function Ce(e,t){for(let n in e)if(e[n]!==t[n])return!1;return!0}function we(e,t,n){for(let r in e)if(!(r in n)&&e[r]!==t[r])return!1;return!0}function Te(e,t){if(!t||!Ee(e,t))return e;let n={};for(let r in e)t[r]!==`query`&&(n[r]=e[r]);return n}function Ee(e,t){for(let n in e)if(t[n]===`query`)return!0;return!1}function T(e){let t={name:e.name,path:e.path};return e.children&&(t.children=e.children.map(e=>T(e))),t}function De(e,t,n=``){for(let r=0;r<e.length;r++){let i=e[r],a=n?`${n}.${i.name}`:i.name;if(a===t)return e.splice(r,1),!0;if(i.children&&t.startsWith(`${a}.`)&&De(i.children,t,a))return!0}return!1}function Oe(e,t){for(let n of Object.keys(e))t(n)&&delete e[n]}function ke(e,t){let n=t.search(/[?#]/),r=n===-1?t:t.slice(0,n);if(r===`/`||r.endsWith(`/`))return t;let i=e.search(/[?#]/),a=i===-1?e:e.slice(0,i);return a.length>1&&a.endsWith(`/`)?`${r}/${n===-1?``:t.slice(n)}`:t}function Ae(e,t,n=100){let r=new Set,i=[e],a=e;for(;t[a];){let e=t[a];if(r.has(e)){let t=i.indexOf(e),n=[...i.slice(t),e];throw Error(`Circular forwardTo: ${n.join(` → `)}`)}if(r.add(a),i.push(e),a=e,i.length>n)throw Error(`forwardTo chain exceeds maximum depth (${n}): ${i.join(` → `)}`)}return a}function je(t,n,r){let i=e.a(``,n,t),a=e.t(r);return a.registerTree(i),{tree:i,matcher:a}}function E(e,t=e.definitions){let n=je(t,e.rootPath,e.matcherOptions);e.tree=n.tree,e.matcher=n.matcher,e.urlParamsCache.clear()}function Me(e,t){E(e,t),e.resolvedForwardMap=D(e.config)}function Ne(e){Pe(e),E(e,[])}function Pe(e){Object.assign(e.config,w()),e.resolvedForwardMap=Object.create(null),e.routeCustomFields=Object.create(null)}function D(e){let t=Object.create(null);for(let n of Object.keys(e.forwardMap))t[n]=Ae(n,e.forwardMap);return t}function Fe(e,t){if(typeof e!=`function`)return;let n=e.constructor.name===`AsyncFunction`,r=e.toString().includes(`__awaiter`);if(n||r)throw TypeError(`forwardTo callback cannot be async for route "${t}". Async functions break matchPath/buildPath.`)}function Ie(e,n,r){if(e.canActivate){let r=typeof e.forwardTo==`string`?e.forwardTo:`[dynamic]`;t.logger.warn(`real-router`,`Route "${n}" has both forwardTo and canActivate. canActivate will be ignored because forwardTo creates a redirect (industry standard). Move canActivate to the target route "${r}".`)}if(e.canDeactivate){let r=typeof e.forwardTo==`string`?e.forwardTo:`[dynamic]`;t.logger.warn(`real-router`,`Route "${n}" has both forwardTo and canDeactivate. canDeactivate will be ignored because forwardTo creates a redirect (industry standard). Move canDeactivate to the target route "${r}".`)}Fe(e.forwardTo,n),typeof e.forwardTo==`string`?r.forwardMap[n]=e.forwardTo:r.forwardFnMap[n]=e.forwardTo}function Le(e,t,n,r,i,a){let o=Object.fromEntries(Object.entries(e).filter(([e])=>!xe.has(e)));Object.keys(o).length>0&&(r[t]=o),e.canActivate&&i.set(t,e.canActivate),e.canDeactivate&&a.set(t,e.canDeactivate),e.forwardTo&&Ie(e,t,n),e.decodeParams&&(n.decoders[t]=t=>e.decodeParams?.(t)??t),e.encodeParams&&(n.encoders[t]=t=>e.encodeParams?.(t)??t),e.defaultParams&&(n.defaultParams[t]=e.defaultParams)}function Re(e,t,n,r,i,a=``){for(let o of e){let e=a?`${a}.${o.name}`:o.name;Le(o,e,t,n,r,i),o.children&&Re(o.children,t,n,r,i,e)}}function ze(e){let t=w();return Se(t,e),t}function Be(e,t,n){if(n.length===0)return[...e,...t];let[r,...i]=n;return e.map(e=>{if(e.name!==r)return e;let n=e.children??[];return{...e,children:i.length===0?[...n,...t]:Be(n,t,i)}})}function O(e,t,n){for(let r of e){let e=t?`${t}.${r.name}`:r.name;n(e),r.children&&O(r.children,e,n)}}function k(e,t,n){let r=new Set;O(e,t,e=>{if(r.has(e))throw Error(`[router.${n}] Duplicate route "${e}" in batch`);r.add(e)})}function Ve(e,t){if(e.startsWith(`@@`))throw Error(`[router.${t}] Route name "${e}" uses the reserved "@@" prefix. Routes with this prefix are internal and cannot be modified through the public API.`)}function A(e,t){for(let n of e)Ve(n.name,t),n.children&&A(n.children,t)}function j(e,t,n){let r=new Map,i=(e,t)=>{for(let a of e){let e=r.get(t);if(e?.has(a.path))throw Error(`[router.${n}] Path "${a.path}" is already defined`);e?e.add(a.path):r.set(t,new Set([a.path])),a.children&&i(a.children,t?`${t}.${a.name}`:a.name)}};i(e,t)}function He(e,t,n){if(A(t,`addRoute`),n!==void 0&&!e.matcher.hasRoute(n))throw Error(`[router.addRoute] Parent route "${n}" does not exist`);O(t,n??``,t=>{if(e.matcher.hasRoute(t))throw Error(`[router.addRoute] Route "${t}" already exists`)}),k(t,n??``,`addRoute`),j(t,n??``,`addRoute`)}function M(e,t,n,r,i,a,o){let s=new Map,c=new Map;Re(t,n,r,s,c,i);let l=D(n),{tree:u,matcher:d}=je(e,a,o);return{config:n,routeCustomFields:r,pendingCanActivate:s,pendingCanDeactivate:c,tree:u,matcher:d,resolvedForwardMap:l}}function Ue(e,t,n){return M(Be(e.definitions,t.map(e=>T(e)),n===void 0?[]:n.split(`.`)),t,ze(e.config),Object.assign(Object.create(null),e.routeCustomFields),n??``,e.rootPath,e.matcherOptions)}function N(e,t,n){return M(e.map(e=>T(e)),e,w(),Object.create(null),``,t,n)}function P(e,t,n){let r=[];for(let[i,a]of e)r.push([i,a,t(a,n)]);return r}function F(e,t){return{activate:P(e.pendingCanActivate,t.compileGuard,`canActivate`),deactivate:P(e.pendingCanDeactivate,t.compileGuard,`canDeactivate`)}}function We(e,t,n){let r=e.depsStore,{activate:i,deactivate:a}=n??F(t,r);Object.assign(e.config,t.config),e.routeCustomFields=t.routeCustomFields,e.tree=t.tree,e.matcher=t.matcher,e.urlParamsCache.clear(),e.resolvedForwardMap=t.resolvedForwardMap;for(let[e,t,n]of i)r.addActivateGuard(e,t,n);for(let[e,t,n]of a)r.addDeactivateGuard(e,t,n)}function Ge(e,t,n,r){let{forwardTo:i,defaultParams:a,decodeParams:o,encodeParams:s,canActivate:c,canDeactivate:l}=r,u=i===void 0?void 0:Ke(n,i,e.config),d=qe(e,n,r),f=c==null?void 0:t.compileGuardFactory(c,`canActivate`),p=l==null?void 0:t.compileGuardFactory(l,`canDeactivate`);return t.preflightHandlerLimit(f===void 0?[]:[n],p===void 0?[]:[n],!1),d!==void 0&&(Object.keys(d).length>0?e.routeCustomFields[n]=d:delete e.routeCustomFields[n]),u!==void 0&&(e.config.forwardMap=u.forwardMap,e.config.forwardFnMap=u.forwardFnMap,e.resolvedForwardMap=u.resolved),Je(e,n,{defaultParams:a,decodeParams:o,encodeParams:s}),I(t,`activate`,n,c,f),I(t,`deactivate`,n,l,p),{forwardTo:i,defaultParams:a,decodeParams:o,encodeParams:s}}function Ke(e,t,n){Fe(t,e);let r=Object.assign(Object.create(null),n.forwardMap),i=Object.assign(Object.create(null),n.forwardFnMap);return t===null?(delete r[e],delete i[e]):typeof t==`string`?(delete i[e],r[e]=t):(delete r[e],i[e]=t),{forwardMap:r,forwardFnMap:i,resolved:D({...n,forwardMap:r})}}function qe(e,t,n){let r;for(let i of Object.keys(n)){if(xe.has(i))continue;let a=n[i];a!==void 0&&(r??={...e.routeCustomFields[t]},a===null?delete r[i]:r[i]=a)}return r}function Je(e,t,n){if(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 I(e,t,n,r,i){r!==void 0&&(t===`activate`?r===null?e.clearCanActivate(n,`definition`):e.addCanActivate(n,r,!0,i):r===null?e.clearCanDeactivate(n,`definition`):e.addCanDeactivate(n,r,!0,i))}function Ye(t,n){A(t,`addRoute`),k(t,``,`addRoute`);let r=N(t,``,n),i={get definitions(){return e.r(i.tree)},config:r.config,tree:r.tree,matcher:r.matcher,urlParamsCache:new Map,resolvedForwardMap:r.resolvedForwardMap,routeCustomFields:r.routeCustomFields,rootPath:``,matcherOptions:n,depsStore:void 0,lifecycleNamespace:void 0,pendingCanActivate:r.pendingCanActivate,pendingCanDeactivate:r.pendingCanDeactivate};return i}const L=[];Object.freeze(L);function Xe(e){let t=e.split(`.`),n=t.length,r=[t[0]],i=t[0].length;for(let a=1;a<n-1;a++)i+=1+t[a].length,r.push(e.slice(0,i));return r.push(e),r}const Ze=new Set([`string`,`number`,`boolean`]);function Qe(e){return Ze.has(typeof e)}function $e(e,t,n,r){let i=t[e];if(!i||typeof i!=`object`)return!0;for(let e of Object.keys(i)){let t=n.params[e],i=r.params[e];if(Qe(t)&&Qe(i)&&String(t)!==String(i))return!1}return!0}function et(e,t,n,r,i,a){for(let o=0;o<a;o++){let a=r[o];if(a!==i[o]||!$e(a,e,t,n))return o}return a}const tt=new Map;function R(e){let t=tt.get(e);if(t)return t;let n=nt(e);return Object.freeze(n),tt.set(e,n),n}function nt(e){if(!e)return[``];let t=e.indexOf(`.`);if(t===-1)return[e];let n=e.indexOf(`.`,t+1);if(n===-1)return[e.slice(0,t),e];let r=e.indexOf(`.`,n+1);return r===-1?[e.slice(0,t),e.slice(0,n),e]:e.indexOf(`.`,r+1)===-1?[e.slice(0,t),e.slice(0,n),e.slice(0,r),e]:Xe(e)}let z,B,V=null,rt,it,H=null;function at(e,t){if(!t)return{intersection:``,toActivate:R(e.name),toDeactivate:L};let n=x(e),r=x(t);if(!n&&!r)return{intersection:``,toActivate:R(e.name),toDeactivate:R(t.name)};let i=R(e.name),a=R(t.name),o=Math.min(a.length,i.length),s=et(n??r,e,t,i,a,o),c;if(s>=a.length)c=L;else if(s===0&&a.length===1)c=a;else{c=[];for(let e=a.length-1;e>=s;e--)c.push(a[e])}let l=s===0?i:i.slice(s);return{intersection:s>0?a[s-1]:``,toDeactivate:c,toActivate:l}}function U(e,t){if(V!==null&&e===z&&t===B)return V;if(H!==null&&e===rt&&t===it)return H;let n=at(e,t);return rt=z,it=B,H=V,z=e,B=t,V=n,n}function ot(e){let t=[];for(let n of e)for(let e of n.paramMeta.urlParams)t.push(e);return t}function st(e,t){return{name:t??e.segments.at(-1).fullName,params:e.params,meta:e.meta}}var ct=class{#e;#t;#n;get#r(){return this.#e.depsStore}constructor(e=[],t){this.#e=Ye(e,t)}static shouldUpdateNode(e){return(t,n)=>{if(!(t&&typeof t==`object`&&`name`in t))throw TypeError(`[router.shouldUpdateNode] toState must be valid State object`);if(t.transition.reload||e===``)return!0;let{intersection:r,toActivate:i,toDeactivate:a}=U(t,n);return e===r||i.includes(e)?!0:a.includes(e)}}setDependencies(e){this.#e.depsStore=e}flushPendingGuards(){let e=this.#r;for(let[t,n]of this.#e.pendingCanActivate)e.addActivateGuard(t,n);this.#e.pendingCanActivate.clear();for(let[t,n]of this.#e.pendingCanDeactivate)e.addDeactivateGuard(t,n);this.#e.pendingCanDeactivate.clear()}setLifecycleNamespace(e){this.#e.lifecycleNamespace=e}setRootPath(e){this.#e.rootPath=e,E(this.#e)}hasRoute(e){return this.#e.matcher.hasRoute(e)}clearRoutes(){Ne(this.#e)}buildPath(e,t,n){if(e===s.UNKNOWN_ROUTE)return typeof t?.path==`string`?t.path:``;let r=Object.hasOwn(this.#e.config.defaultParams,e)?{...this.#e.config.defaultParams[e],...t}:t??{},i=typeof this.#e.config.encoders[e]==`function`?this.#e.config.encoders[e]({...r}):r;return this.#e.matcher.buildPath(e,i,this.#a(n))}matchPath(e,t){let n=t,r=this.#e.matcher.match(e);if(!r)return;let{name:i,params:a,meta:o}=st(r),s=typeof this.#e.config.decoders[i]==`function`?this.#e.config.decoders[i](a):a,{name:c,params:l}=this.#r.forwardState(i,s),u=e;if(n.rewritePathOnMatch){let t=typeof this.#e.config.encoders[c]==`function`?this.#e.config.encoders[c]({...l}):l,r=n.trailingSlash;try{u=this.#e.matcher.buildPath(c,t,{trailingSlash:r===`never`||r===`always`?r:void 0,queryParamsMode:n.queryParamsMode}),r===`preserve`&&(u=ke(e,u))}catch{u=e}}return this.#r.makeState(c,l,u,o)}forwardState(e,t){if(Object.hasOwn(this.#e.config.forwardFnMap,e)){let n=this.#i(e,t),r=this.#e.config.forwardFnMap[e],i=this.#o(e,r,t);return{name:i,params:this.#i(i,n)}}let n=this.#e.resolvedForwardMap[e]??e;if(n!==e&&Object.hasOwn(this.#e.config.forwardFnMap,n)){let r=this.#i(e,t),i=this.#e.config.forwardFnMap[n],a=this.#o(n,i,t);return{name:a,params:this.#i(a,r)}}if(n!==e){let r=this.#i(e,t);return{name:n,params:this.#i(n,r)}}return{name:e,params:this.#i(e,t)}}buildStateResolved(e,t){let n=this.#e.matcher.getSegmentsByName(e);if(n)return st({segments:n,params:t,meta:this.#e.matcher.getMetaByName(e)},e)}isActiveRoute(e,t={},n=!1,r=!0){let i=this.#r.getState();if(!i)return!1;let a=i.name;if(a!==e&&!a.startsWith(`${e}.`)&&!e.startsWith(`${a}.`))return!1;let o=this.#e.config.defaultParams[e];if(n||a===e){let n={name:e,params:o?{...o,...t}:t,path:``,transition:p,context:{}};return this.#r.areStatesEqual(n,i,r)}if(!a.startsWith(`${e}.`))return!1;let s=i.params;return Ce(t,s)?o?we(r?Te(o,this.#e.matcher.getMetaByName(e)?.[e]):o,s,t):!0:!1}getMetaForState(e){return this.#e.matcher.hasRoute(e)?this.#e.matcher.getMetaByName(e):void 0}getUrlParams(e){let t=this.#e.urlParamsCache.get(e);if(t!==void 0)return t;let n=this.#e.matcher.getSegmentsByName(e),r=n?ot(n):[];return this.#e.urlParamsCache.set(e,r),r}getStore(){return this.#e}#i(e,t){return Object.hasOwn(this.#e.config.defaultParams,e)?{...this.#e.config.defaultParams[e],...t}:t}#a(e){if(this.#t)return e!==this.#n&&t.logger.warn(`router.buildPath`,"`options` differs from the cached source reference; router options are immutable per router instance, so the first-cached buildPath options are reused (#957)."),this.#t;this.#n=e;let n=e?.trailingSlash;return this.#t=Object.freeze({trailingSlash:n===`never`||n===`always`?n:void 0,queryParamsMode:e?.queryParamsMode}),this.#t}#o(e,t,n){let r=new Set([e]),i=t(this.#r.getDependency,n),a=0;if(typeof i!=`string`)throw TypeError(`forwardTo callback must return a string, got ${typeof i}`);for(;a<100;){if(this.#e.matcher.getSegmentsByName(i)===void 0)throw Error(`Route "${i}" does not exist`);if(r.has(i)){let e=[...r,i].join(` → `);throw Error(`Circular forwardTo: ${e}`)}if(r.add(i),Object.hasOwn(this.#e.config.forwardFnMap,i)){let e=this.#e.config.forwardFnMap[i];i=e(this.#r.getDependency,n),a++;continue}let e=this.#e.config.forwardMap[i];if(e!==void 0){i=e,a++;continue}return i}throw Error(`forwardTo exceeds maximum depth of 100`)}};const lt=new Set(Object.values(a)),ut=new Set([`code`,`segment`,`path`]),dt=new Set([`setCode`,`setErrorInstance`,`setAdditionalFields`,`hasField`,`getField`,`toJSON`]);var W=class extends Error{segment;path;code;constructor(e,{message:t,segment:n,path:r,...i}={}){super(t??e),this.name=`RouterError`,this.code=e,this.segment=n,this.path=r;for(let[e,t]of Object.entries(i)){if(ut.has(e))throw TypeError(`[RouterError] Cannot set reserved property "${e}"`);dt.has(e)||(this[e]=t)}}setCode(e){this.code=e,lt.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(ut.has(t))throw TypeError(`[RouterError.setAdditionalFields] Cannot set reserved property "${t}"`);dt.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);let t=new Set([`code`,`message`,`segment`,`path`,`stack`,`name`]);for(let n in this)Object.hasOwn(this,n)&&!t.has(n)&&(e[n]=this[n]);return e}};const ft=new W(a.ROUTER_NOT_STARTED),pt=new W(a.ROUTE_NOT_FOUND),mt=new W(a.SAME_STATES),G=Promise.reject(ft),ht=Promise.reject(pt),gt=Promise.reject(mt);G.catch(()=>{}),ht.catch(()=>{}),gt.catch(()=>{});function _t(e,t,n,r,i){Object.freeze(n),Object.freeze(r);let a={phase:`activating`,reason:`success`,segments:Object.freeze({deactivated:n,activated:r,intersection:i})};return e?.name!==void 0&&(a.from=e.name),t.reload!==void 0&&(a.reload=t.reload),t.replace!==void 0&&(a.replace=t.replace),t.redirected!==void 0&&(a.redirected=t.redirected),Object.freeze(a)}function vt({signal:e,...t}){return t}function yt(e,t){let{toState:n,fromState:r,opts:i,toDeactivate:o,toActivate:c,intersection:l}=t;if(n.name!==s.UNKNOWN_ROUTE&&!e.hasRoute(n.name)){let t=new W(a.ROUTE_NOT_FOUND,{routeName:n.name});throw e.sendTransitionFail(n,r,t),t}if(r)for(let n of o)!c.includes(n)&&t.canDeactivateFunctions.has(n)&&e.clearCanDeactivate(n);n.transition=_t(r,i,o,c,l);let u=Object.freeze(n);e.setState(u);let d=i.signal===void 0?i:vt(i);return e.sendTransitionDone(u,r,d),u}function K(e,t,n,r){let i=t;i.code===a.TRANSITION_CANCELLED||i.code===a.ROUTE_NOT_FOUND||e.sendTransitionFail(n,r,i)}function q(e,t,n){if(e instanceof DOMException&&e.name===`AbortError`)throw new W(a.TRANSITION_CANCELLED);if(e instanceof W&&e.code===a.TRANSITION_CANCELLED)throw e;bt(e,t,n)}function bt(e,t,n){throw e instanceof W?(e.setCode(t),e):new W(t,St(e,n))}const xt=new Set([`code`,`segment`,`path`,`then`]);function St(e,t){let n={segment:t};if(e instanceof Error)return{...n,message:e.message,stack:e.stack,...`cause`in e&&e.cause!==void 0&&{cause:e.cause}};if(e&&typeof e==`object`){let t={};for(let[n,r]of Object.entries(e))xt.has(n)||(t[n]=r);return{...n,...t}}return n}async function Ct(e,t,n){let r;try{r=await e}catch(e){q(e,t,n);return}if(!r)throw new W(t,{segment:n})}async function wt(e,t,n,r,i,o,s,c,l,u){await Ct(l,n,u);for(let l=c;l<t.length;l++){if(!s())throw new W(a.TRANSITION_CANCELLED);let c=t[l],u=e.get(c);if(!u)continue;let d=!1;try{d=u(r,i,o)}catch(e){q(e,n,c)}if(d instanceof Promise){await Ct(d,n,c);continue}if(!d)throw new W(n,{segment:c})}}async function Tt(e,t,n,r,i,o,s,c,l){if(await e,!c())throw new W(a.TRANSITION_CANCELLED);let u=l();if(u!==void 0&&(await u,!c()))throw new W(a.TRANSITION_CANCELLED);if(r){let e=J(t,n,a.CANNOT_ACTIVATE,i,o,s,c);if(e!==void 0&&await e,!c())throw new W(a.TRANSITION_CANCELLED)}}function Et(e,t,n,r,i,o,s,c,l,u,d){if(i){let i=J(e,n,a.CANNOT_DEACTIVATE,s,c,l,u);if(i!==void 0)return Tt(i,t,r,o,s,c,l,u,d)}if(!u())throw new W(a.TRANSITION_CANCELLED);let f=d();if(f!==void 0)return Dt(f,o?t:void 0,r,s,c,l,u);if(o)return J(t,r,a.CANNOT_ACTIVATE,s,c,l,u)}async function Dt(e,t,n,r,i,o,s){if(await e,!s())throw new W(a.TRANSITION_CANCELLED);if(t!==void 0){let e=J(t,n,a.CANNOT_ACTIVATE,r,i,o,s);if(e!==void 0&&await e,!s())throw new W(a.TRANSITION_CANCELLED)}}function J(e,t,n,r,i,o,s){for(let[c,l]of t.entries()){if(!s())throw new W(a.TRANSITION_CANCELLED);let u=e.get(l);if(!u)continue;let d=!1;try{d=u(r,i,o)}catch(e){q(e,n,l)}if(d instanceof Promise)return wt(e,t,n,r,i,o,s,c+1,d,l);if(!d)throw new W(n,{segment:l})}}const Ot=Object.freeze([s.UNKNOWN_ROUTE]),kt=Object.freeze({replace:!0});function At(e,t){return t?.name===s.UNKNOWN_ROUTE&&!e.replace?{...e,replace:!0}:e}function jt(e,t,n){return!!e&&!t.reload&&!t.force&&e.path===n.path}var Mt=class{lastSyncResolved=!1;lastSyncRejected=!1;#e;#t=null;#n=0;setDependencies(e){this.#e=e}navigate(e,t,n){this.lastSyncResolved=!1;let r=this.#e;if(!r.canNavigate())return this.lastSyncRejected=!0,G;let i;try{i=r.buildNavigateState(e,t)}catch(e){return Promise.reject(e)}return i?this.#r(i,n):(r.emitTransitionError(void 0,r.getState(),pt),this.lastSyncRejected=!0,ht)}navigateToState(e,t){this.lastSyncResolved=!1;let n=this.#e;if(!n.canNavigate())return this.lastSyncRejected=!0,G;if(e.name!==s.UNKNOWN_ROUTE&&!n.hasRoute(e.name)){let t=new W(a.ROUTE_NOT_FOUND,{routeName:e.name});return n.emitTransitionError(void 0,n.getState(),t),Promise.reject(t)}let r={name:e.name,params:e.params,path:e.path,context:{...e.context}},i=x(e);return i!==void 0&&S(r,i),this.#r(r,t)}navigateToDefault(e){this.lastSyncResolved=!1;let t=this.#e;if(!t.getOptions().defaultRoute)return Promise.reject(new W(a.ROUTE_NOT_FOUND,{routeName:`defaultRoute not configured`}));let n,r;try{({route:n,params:r}=t.resolveDefault())}catch(e){return Promise.reject(e)}return n?this.navigate(n,r,e):Promise.reject(new W(a.ROUTE_NOT_FOUND,{routeName:`defaultRoute resolved to empty`}))}navigateToNotFound(e){if(!this.#e.isActive())throw new W(a.ROUTER_DISPOSED);this.#c();let t=this.#e.getState(),n=t?R(t.name).toReversed():[];Object.freeze(n);let r={deactivated:n,activated:Ot,intersection:``};Object.freeze(r);let i={phase:`activating`,...t&&{from:t.name},reason:`success`,replace:!0,segments:r};Object.freeze(i);let o={name:s.UNKNOWN_ROUTE,params:d,path:e,transition:i,context:{}};return Object.freeze(o),this.#e.setState(o),this.#e.emitTransitionSuccess(o,t,kt),o}abortCurrentController(e){this.#t?.abort(e??new W(a.TRANSITION_CANCELLED)),this.#t=null}#r(e,t){let n=this.#e,r,i=!1,o=null;try{if(r=n.getState(),t=At(t,r),jt(r,t,e))return n.emitTransitionError(e,r,mt),this.lastSyncRejected=!0,gt;this.#c(t.signal);let c=++this.#n,l=t.signal!==void 0||n.hasLeaveListeners()||n.hasPreCommitListeners();n.startTransition(e,r),i=!0;let[u,d]=n.getLifecycleFunctions(),f=e.name===s.UNKNOWN_ROUTE,p=U(e,r),{toDeactivate:m,toActivate:h,intersection:g}=p,ee=r&&!t.forceDeactivate&&m.length>0,te=!f&&h.length>0,_=u.size>0||d.size>0,v=e;if(!_){let e=this.#o(v,r,c,t,p,u);if(e!==void 0)return e}if(_){o=new AbortController,this.#t=o;let i=()=>this.#n===c&&n.isActive(),s=o.signal,l=Et(u,d,m,h,!!ee,te,e,r,s,i,()=>{if(n.sendLeaveApprove(v,r),n.hasLeaveListeners())return n.awaitLeaveListeners(v,r,s)});if(l!==void 0)return this.#i(l,{toState:e,fromState:r,opts:t,toDeactivate:m,toActivate:h,intersection:g,canDeactivateFunctions:u},o,c);if(!i())throw new W(a.TRANSITION_CANCELLED);this.#s(o,!1)}if(l&&(!n.isActive()||t.signal?.aborted===!0))throw new W(a.TRANSITION_CANCELLED);let ne=yt(n,{toState:e,fromState:r,opts:t,toDeactivate:m,toActivate:h,intersection:g,canDeactivateFunctions:u});return this.lastSyncResolved=!0,Promise.resolve(ne)}catch(t){return this.#a(t,o,i,e,r),Promise.reject(t)}}async#i(e,t,n,r){let i=this.#e,o=()=>this.#n===r&&!n.signal.aborted&&i.isActive(),s=t.opts.signal,c,l,u=!1,d,f=new Promise(e=>{if(n.signal.aborted){e();return}l=()=>{e()},n.signal.addEventListener(`abort`,l,{once:!0})});e.catch(()=>{});try{if(s){if(s.aborted)throw new W(a.TRANSITION_CANCELLED,{reason:s.reason});c=()=>{i.cancelNavigation(s.reason)},s.addEventListener(`abort`,c,{once:!0})}if(await Promise.race([e,f]),!o())throw new W(a.TRANSITION_CANCELLED);let n=yt(i,t);return u=!0,n}catch(e){throw d=e,K(i,e,t.toState,t.fromState),e}finally{c&&s?.removeEventListener(`abort`,c),l&&n.signal.removeEventListener(`abort`,l),this.#s(n,!u,d)}}#a(e,t,n,r,i){t&&this.#s(t,!0,e),n&&r&&K(this.#e,e,r,i)}#o(e,t,n,r,i,a){let o=this.#e;if(o.sendLeaveApprove(e,t),o.hasLeaveListeners()){let s=new AbortController;this.#t=s;let c;try{c=o.awaitLeaveListeners(e,t,s.signal)}catch(e){throw this.#s(s,!0,e),e}if(c!==void 0)return this.#i(c,{toState:e,fromState:t,opts:r,toDeactivate:i.toDeactivate,toActivate:i.toActivate,intersection:i.intersection,canDeactivateFunctions:a},s,n);this.#s(s,!1);return}}#s(e,t,n){t&&e.abort(n),this.#t===e&&(this.#t=null)}#c(e){if(this.#e.isTransitioning()&&(t.logger.warn(`router.navigate`,`Concurrent navigation detected on shared router instance. For SSR, use cloneRouter() to create isolated instance per request.`),this.#e.cancelNavigation()),e?.aborted)throw new W(a.TRANSITION_CANCELLED,{reason:e.reason})}};const Nt=Object.freeze({replace:!0});var Pt=class{#e;setDependencies(e){this.#e=e}async start(e){let t=this.#e;if(t.isIdle())throw new W(a.TRANSITION_CANCELLED);let n=t.getOptions();if(typeof e!=`string`)throw TypeError(`[router.start] path must be a string, got ${typeof e}`);let r=t.matchPath(e);if(!r&&!n.allowNotFound){let n=new W(a.ROUTE_NOT_FOUND,{path:e});throw t.emitTransitionError(void 0,void 0,n),n}return t.completeStart(),r?t.navigateToState(r,Nt):t.navigateToNotFound(e)}stop(){this.#e.clearState()}};const Y=`TREE_CHANGED`;function X(e){return e instanceof Error?e:Error(String(e))}function Ft(e,t,n){return new Promise((r,i)=>{let o=()=>{let e=n.reason;i(e instanceof W&&e.code===a.TRANSITION_CANCELLED?e:new W(a.TRANSITION_CANCELLED,{reason:e}))};if(n.aborted){o();return}n.addEventListener(`abort`,o,{once:!0}),Promise.allSettled(e).then(e=>{if(n.removeEventListener(`abort`,o),n.aborted)return;if(t!==void 0){i(X(t));return}let a=e.find(e=>e.status===`rejected`);if(a!==void 0){i(X(a.reason));return}r()})})}var Z=class{#e;#t;#n;#r;#i=[];#a=0;#o;#s;#c;#l;#u;constructor(e){this.#e=e.routerFSM,this.#t=e.emitter,this.#n=e.abortController,this.#o=void 0,this.#p()}static validateSubscribeListener(e){if(typeof e!=`function`)throw TypeError(`[router.subscribe] Expected a function. For Observable pattern use observable(router) from @real-router/rx`)}static validateSubscribeLeaveListener(e){if(typeof e!=`function`)throw TypeError(`[router.subscribeLeave] Expected a function`)}emitRouterStart(){this.#t.emit(l.ROUTER_START)}emitRouterStop(){this.#t.emit(l.ROUTER_STOP)}emitTransitionStart(e,t){this.#a++;try{this.#t.emit(l.TRANSITION_START,e,t)}finally{this.#a--}}emitTransitionSuccess(e,t,n){this.#a++;try{this.#t.emit(l.TRANSITION_SUCCESS,e,t,n)}finally{this.#a--}}emitTransitionError(e,t,n){this.#a++;try{this.#t.emit(l.TRANSITION_ERROR,e,t,n)}finally{this.#a--}}emitTransitionCancel(e,t){this.#a++;try{this.#t.emit(l.TRANSITION_CANCEL,e,t)}finally{this.#a--}}emitTransitionLeaveApprove(e,t){this.#a++;try{this.#t.emit(l.TRANSITION_LEAVE_APPROVE,e,t)}finally{this.#a--}}isProcessing(){return this.#a>0}emitTreeChanged(e){this.#t.emit(Y,e)}isEmittingTreeChanged(){return this.#t.isDispatching(Y)}subscribeTreeChanged(e){if(this.isDisposed())throw new W(a.ROUTER_DISPOSED);return this.#t.on(Y,t=>{e(t)})}treeChangedListenerCount(){return this.#t.listenerCount(Y)}sendStart(){this.#e.send(h.START)}sendStop(){this.#e.send(h.STOP)}sendDispose(){this.#e.send(h.DISPOSE)}sendStarted(){this.#e.send(h.STARTED)}sendNavigate(e,t){this.#o=e,this.#e.send(h.NAVIGATE,{toState:e,fromState:t})}sendComplete(e,t,n={}){this.#e.send(h.COMPLETE,{toState:e,fromState:t,opts:n}),this.#o=void 0}sendLeaveApprove(e,t){this.#e.send(h.LEAVE_APPROVE,{toState:e,fromState:t})}sendFail(e,t,n){this.#s=e,this.#c=t,this.#l=n,this.#e.send(h.FAIL),this.#o=void 0}sendFailSafe(e,t,n){this.isReady()?this.sendFail(e,t,n):this.emitTransitionError(e,t,n)}sendCancel(e,t,n){this.#s=e,this.#c=t,this.#u=n,this.#e.send(h.CANCEL),this.#o=void 0}canBeginTransition(){return this.#e.canSend(h.NAVIGATE)}canStart(){return this.#e.canSend(h.START)}canCancel(){return this.#e.canSend(h.CANCEL)}isActive(){let e=this.#e.getState();return e!==m.IDLE&&e!==m.DISPOSED}isDisposed(){return this.#e.getState()===m.DISPOSED}isTransitioning(){let e=this.#e.getState();return e===m.TRANSITION_STARTED||e===m.LEAVE_APPROVED}isLeaveApproved(){return this.#e.getState()===m.LEAVE_APPROVED}isReady(){return this.#e.getState()===m.READY}isStarting(){return this.#e.getState()===m.STARTING}isIdle(){return this.#e.getState()===m.IDLE}addEventListener(e,t){return this.#d(e,`addEventListener`),this.#t.on(e,t)}subscribe(e){if(this.isDisposed())throw new W(a.ROUTER_DISPOSED);return this.#d(l.TRANSITION_SUCCESS,`subscribe`),this.#t.on(l.TRANSITION_SUCCESS,(t,n)=>e({route:t,previousRoute:n}))}subscribeLeave(e){if(this.isDisposed())throw new W(a.ROUTER_DISPOSED);this.#i.push(e);let t=!1;return()=>{if(t)return;t=!0;let n=this.#i.indexOf(e);n!==-1&&this.#i.splice(n,1)}}hasLeaveListeners(){return this.#i.length>0}hasPreCommitListeners(){return this.#t.listenerCount(l.TRANSITION_START)>0||this.#t.listenerCount(l.TRANSITION_LEAVE_APPROVE)>0}awaitLeaveListeners(e,t,n){if(t===void 0)return;let r=Object.freeze({route:t,nextRoute:e,signal:n}),i,a,o=[...this.#i];this.#a++;try{for(let e of o)try{let t=e(r);t!==void 0&&typeof t.then==`function`&&(i??=[],i.push(t))}catch(e){a===void 0&&(a=e)}}finally{this.#a--}if(i===void 0){if(a!==void 0)throw X(a);return}return Ft(i,a,n)}clearAll(){this.#t.clearAll(),this.#i.length=0}setLimits(e){this.#t.setLimits(e)}setValidatorAccessor(e){this.#r=e}sendCancelIfPossible(e,t){let n=this.#o;!this.canCancel()||n===void 0||this.sendCancel(n,e,t)}#d(e,t){let n=this.#r?.();n&&n.eventBus.validateCountThresholds(this.#t.listenerCount(e)+1,e,t)}#f(){this.emitTransitionError(this.#s,this.#c,this.#l),this.#s=void 0,this.#c=void 0,this.#l=void 0}#p(){let e=this.#e;e.on(m.STARTING,h.STARTED,()=>{this.emitRouterStart()}),e.on(m.READY,h.STOP,()=>{this.emitRouterStop()});let t=e=>{this.emitTransitionStart(e.toState,e.fromState)};e.on(m.READY,h.NAVIGATE,t),e.on(m.TRANSITION_STARTED,h.NAVIGATE,t),e.on(m.LEAVE_APPROVED,h.NAVIGATE,t),e.on(m.TRANSITION_STARTED,h.LEAVE_APPROVE,e=>{this.emitTransitionLeaveApprove(e.toState,e.fromState)}),e.on(m.LEAVE_APPROVED,h.COMPLETE,e=>{this.emitTransitionSuccess(e.toState,e.fromState,e.opts)});let n=()=>{let e=this.#s,t=this.#u;this.#u=void 0,this.#n(t),e!==void 0&&this.emitTransitionCancel(e,this.#c)};e.on(m.TRANSITION_STARTED,h.CANCEL,n),e.on(m.LEAVE_APPROVED,h.CANCEL,n),e.on(m.LEAVE_APPROVED,h.FAIL,()=>{this.#f()}),e.on(m.STARTING,h.FAIL,()=>{this.#f()}),e.on(m.READY,h.FAIL,()=>{this.#f()}),e.on(m.TRANSITION_STARTED,h.FAIL,()=>{this.#f()})}};const It=new W(a.ROUTER_ALREADY_STARTED),Lt=new Set([`all`,`warn-error`,`error-only`,`none`]);function Rt(e){return typeof e==`string`&&Lt.has(e)}function zt(e){return typeof e==`string`?`"${e}"`:typeof e==`object`?JSON.stringify(e):String(e)}function Bt(e){if(typeof e!=`object`)throw TypeError(`Logger config must be an object`);let t=e;for(let e of Object.keys(t))if(e!==`level`&&e!==`callback`&&e!==`callbackIgnoresLevel`)throw TypeError(`Unknown logger config property: "${e}"`);if(`level`in t&&t.level!==void 0&&!Rt(t.level))throw TypeError(`Invalid logger level: ${zt(t.level)}. Expected: "all" | "warn-error" | "error-only" | "none"`);if(`callback`in t&&t.callback!==void 0&&typeof t.callback!=`function`)throw TypeError(`Logger callback must be a function, got ${typeof t.callback}`);if(`callbackIgnoresLevel`in t&&t.callbackIgnoresLevel!==void 0&&typeof t.callbackIgnoresLevel!=`boolean`)throw TypeError(`Logger callbackIgnoresLevel must be a boolean, got ${typeof t.callbackIgnoresLevel}`)}function Vt(t){let n=Ht(t),r=()=>e.l(t.router).validator;Ut(t),Wt(t,r),Gt(t,n,r),Kt(t),qt(t,n,r),Jt(t),Yt(t),Xt(t)}function Ht(e){let{router:t,dependenciesStore:n}=e,r=e=>n.dependencies[e];return e=>e(t,r)}function Ut(e){e.dependenciesStore.limits=e.limits,e.eventBus.setLimits({maxListeners:e.limits.maxListeners,warnListeners:e.limits.warnListeners})}function Wt(e,t){e.eventBus.setValidatorAccessor(t)}function Gt(e,t,n){let r={compileFactory:t,getValidator:n};e.routeLifecycle.setDependencies(r)}function Kt(t){t.routes.setDependencies({addActivateGuard:(e,n,r)=>{t.routeLifecycle.addCanActivate(e,n,!0,r)},addDeactivateGuard:(e,n,r)=>{t.routeLifecycle.addCanDeactivate(e,n,!0,r)},compileGuard:(e,n)=>t.routeLifecycle.compileGuardFactory(e,n),makeState:(e,n,r,i)=>t.state.makeState(e,n,r,i),getState:()=>t.state.get(),areStatesEqual:(e,n,r)=>t.state.areStatesEqual(e,n,r),getDependency:e=>t.dependenciesStore.dependencies[e],forwardState:(n,r)=>{let i=e.l(t.router);return i.validator?.routes.validateStateBuilderArgs(n,r,`forwardState`),i.forwardState(n,r)}}),t.routes.setLifecycleNamespace(t.routeLifecycle)}function qt(e,t,n){let r={addEventListener:(t,n)=>e.eventBus.addEventListener(t,n),canNavigate:()=>e.eventBus.canBeginTransition(),compileFactory:t,getValidator:n};e.plugins.setDependencies(r)}function Jt(t){t.navigation.setDependencies({getOptions:()=>t.options.get(),hasRoute:e=>t.routes.hasRoute(e),getState:()=>t.state.get(),setState:e=>{t.state.set(e)},buildNavigateState:(n,r)=>{let i=e.l(t.router);i.validator?.routes.validateStateBuilderArgs(n,r,`navigate`);let a=i.forwardState(n,r),o=a.name,s=y(a.params),c=t.routes.getMetaForState(o);if(c===void 0)return;let l=i.buildPath(o,s);return t.state.makeState(o,s,l,c,!0)},resolveDefault:()=>{let n=t.options.get(),r=e.l(t.router),i=oe(n.defaultRoute,e=>t.dependenciesStore.dependencies[e]),a=oe(n.defaultParams,e=>t.dependenciesStore.dependencies[e]);return typeof n.defaultRoute==`function`&&r.validator?.options.validateResolvedDefaultRoute(i,r.routeGetStore()),{route:i,params:a}},startTransition:(e,n)=>{t.eventBus.sendNavigate(e,n)},cancelNavigation:e=>{t.eventBus.sendCancelIfPossible(t.state.get(),e)},sendTransitionDone:(e,n,r)=>{t.eventBus.sendComplete(e,n,r)},sendTransitionFail:(e,n,r)=>{t.eventBus.sendFail(e,n,r)},emitTransitionError:(e,n,r)=>{t.eventBus.sendFailSafe(e,n,r)},emitTransitionSuccess:(e,n,r)=>{t.eventBus.emitTransitionSuccess(e,n,r)},sendLeaveApprove:(e,n)=>{t.eventBus.sendLeaveApprove(e,n)},canNavigate:()=>t.eventBus.canBeginTransition(),getLifecycleFunctions:()=>t.routeLifecycle.getFunctions(),isActive:()=>t.router.isActive(),isTransitioning:()=>t.eventBus.isTransitioning(),clearCanDeactivate:e=>{t.routeLifecycle.clearCanDeactivate(e,`external`)},hasLeaveListeners:()=>t.eventBus.hasLeaveListeners(),hasPreCommitListeners:()=>t.eventBus.hasPreCommitListeners(),awaitLeaveListeners:(e,n,r)=>t.eventBus.awaitLeaveListeners(e,n,r)})}function Yt(e){e.lifecycle.setDependencies({getOptions:()=>e.options.get(),navigateToState:(t,n)=>e.navigation.navigateToState(t,n),navigateToNotFound:t=>e.navigation.navigateToNotFound(t),clearState:()=>{e.state.set(void 0)},matchPath:t=>e.routes.matchPath(t,e.options.get()),completeStart:()=>{e.eventBus.sendStarted()},isIdle:()=>e.eventBus.isIdle(),emitTransitionError:(t,n,r)=>{e.eventBus.sendFail(t,n,r)}})}function Xt(t){t.state.setDependencies({getDefaultParams:()=>t.routes.getStore().config.defaultParams,buildPath:(n,r)=>e.l(t.router).buildPath(n,r),getUrlParams:e=>t.routes.getUrlParams(e)})}const Q=Object.freeze({}),Zt=new Set([a.SAME_STATES,a.TRANSITION_CANCELLED,a.ROUTER_NOT_STARTED,a.ROUTE_NOT_FOUND,a.CANNOT_ACTIVATE,a.CANNOT_DEACTIVATE]);function Qt(e,n){t.logger.error(`Router`,`Error in listener for ${e}:`,n)}var $t=class n{#e;#t;#n;#r;#i;#a;#o;#s;#c;#l;constructor(r=[],a={},o={}){let{logger:s,...c}=a;s&&(Bt(s),t.logger.configure(s)),ce.validateOptionsIsObject(a),te(o),r.length>0&&_(r),this.#e=new ce(c),this.#t=ne(c.limits),this.#n=re(o),this.#r=new ue,this.#i=new ct(r,en(this.#e.get())),this.#a=new be,this.#o=new me,this.#s=new Mt,this.#c=new Pt;let l=ee(),u=new i({onListenerError:Qt,onListenerWarn:(e,n)=>{t.logger.warn(`router.addEventListener`,`Event "${e}" has ${n} listeners — possible memory leak`)}});this.#l=new Z({routerFSM:l,emitter:u,abortController:e=>{this.#s.abortCurrentController(e)}});let f=new Map;e.u(this,{makeState:(e,t,n,r)=>this.#r.makeState(e,t,n,r),forwardState:e.s(`forwardState`,(e,t)=>this.#i.forwardState(e,t),f),buildStateResolved:(e,t)=>this.#i.buildStateResolved(e,t),matchPath:(e,t)=>this.#i.matchPath(e,t),getOptions:()=>this.#e.get(),addEventListener:(e,t)=>this.#l.addEventListener(e,t),treeChanged:{emit:e=>{this.#l.emitTreeChanged(e)},subscribe:e=>this.#l.subscribeTreeChanged(e),listenerCount:()=>this.#l.treeChangedListenerCount(),isEmitting:()=>this.#l.isEmittingTreeChanged()},buildPath:e.s(`buildPath`,(e,t)=>this.#i.buildPath(e,t??d,this.#e.get()),f),emitTransitionError:e=>{this.#l.sendFailSafe(void 0,this.#r.get(),e)},emitTransitionSuccess:(e,t,n)=>{this.#l.emitTransitionSuccess(e,t,n)},navigateToNotFound:e=>this.#s.navigateToNotFound(e),start:e.c(`start`,e=>this.#c.start(e),f),navigateToState:(e,t)=>{this.#m();let r=this.#s.navigateToState(e,t??Q);return this.#s.lastSyncResolved?this.#s.lastSyncResolved=!1:this.#s.lastSyncRejected?this.#s.lastSyncRejected=!1:n.#p(r),r},interceptors:f,setRootPath:e=>{this.#i.setRootPath(e)},getRootPath:()=>this.#i.getStore().rootPath,getTree:()=>this.#i.getStore().tree,isDisposed:()=>this.#l.isDisposed(),validator:null,dependenciesGetStore:()=>this.#n,getCloneState:()=>({options:{...this.#e.get()},dependencies:{...this.#n.dependencies},pluginFactories:this.#o.getAll()}),routeGetStore:()=>this.#i.getStore(),getStateName:()=>this.#r.get()?.name,isTransitioning:()=>this.#l.isTransitioning(),clearState:()=>{this.#r.set(void 0)},setState:e=>{this.#r.set(e)},routerExtensions:[],contextClaimRecords:new Set,hydrationState:null}),Vt({router:this,options:this.#e,limits:this.#t,dependenciesStore:this.#n,state:this.#r,routes:this.#i,routeLifecycle:this.#a,plugins:this.#o,navigation:this.#s,lifecycle:this.#c,eventBus:this.#l}),this.isActiveRoute=this.isActiveRoute.bind(this),this.buildPath=this.buildPath.bind(this),this.getState=this.getState.bind(this),this.getPreviousState=this.getPreviousState.bind(this),this.areStatesEqual=this.areStatesEqual.bind(this),this.shouldUpdateNode=this.shouldUpdateNode.bind(this),this.isActive=this.isActive.bind(this),this.start=this.start.bind(this),this.stop=this.stop.bind(this),this.dispose=this.dispose.bind(this),this.canNavigateTo=this.canNavigateTo.bind(this),this.usePlugin=this.usePlugin.bind(this),this.navigate=this.navigate.bind(this),this.navigateToDefault=this.navigateToDefault.bind(this),this.navigateToNotFound=this.navigateToNotFound.bind(this),this.subscribe=this.subscribe.bind(this),this.subscribeLeave=this.subscribeLeave.bind(this),this.isLeaveApproved=this.isLeaveApproved.bind(this);try{this.#i.flushPendingGuards()}catch(e){throw this.dispose(),e}}isActiveRoute(n,r,i,a){return e.l(this).validator?.routes.validateIsActiveRouteArgs(n,r,i,a),e.l(this).validator?.routes.validateRouteName(n,`isActiveRoute`),n===``?(t.logger.warn(`real-router`,`isActiveRoute("") called with empty string. Root node is not considered a parent of any route.`),!1):this.#i.isActiveRoute(n,r,i,a)}buildPath(t,n){let r=e.l(this);return r.validator?.routes.validateBuildPathArgs(t),r.validator?.navigation.validateParams(n,`buildPath`),r.buildPath(t,y(n))}getState(){return this.#r.get()}getPreviousState(){return this.#r.getPrevious()}areStatesEqual(t,n,r=!0){return e.l(this).validator?.state.validateAreStatesEqualArgs(t,n,r),this.#r.areStatesEqual(t,n,r)}shouldUpdateNode(t){return e.l(this).validator?.routes.validateShouldUpdateNodeArgs(t),ct.shouldUpdateNode(t)}isActive(){return this.#l.isActive()}start(t){if(!this.#l.canStart())return Promise.reject(It);e.l(this).validator?.navigation.validateStartArgs(t),this.#l.sendStart();let r;try{let n=e.l(this).start(t);r=typeof n?.then==`function`?n:Promise.reject(TypeError("[router.start] a `start` interceptor returned without calling next(). Every start interceptor must return `next(path)`."))}catch(e){r=Promise.reject(e)}let i=r.catch(e=>this.#h(e));return n.#p(i,n.#f),i}stop(){return this.#l.sendCancelIfPossible(this.#r.get()),!this.#l.isReady()&&!this.#l.isTransitioning()&&!this.#l.isStarting()?this:(this.#c.stop(),this.#l.sendStop(),this)}dispose(){if(this.#l.isDisposed())return;this.#l.sendCancelIfPossible(this.#r.get()),(this.#l.isReady()||this.#l.isTransitioning())&&(this.#c.stop(),this.#l.sendStop()),this.#l.sendDispose(),this.#l.clearAll(),this.#o.disposeAll();let t=e.l(this);for(let e of t.routerExtensions)for(let t of e.keys)delete this[t];t.routerExtensions.length=0,t.contextClaimRecords.clear(),t.interceptors.clear(),this.#i.clearRoutes(),this.#a.clearAll(),this.#r.reset(),this.#n.dependencies=Object.create(null),this.#g()}canNavigateTo(t,n){let r=e.l(this);if(r.validator?.routes.validateRouteName(t,`canNavigateTo`),r.validator?.navigation.validateParams(n,`canNavigateTo`),!this.#i.hasRoute(t))return!1;let{name:i,params:a}=r.forwardState(t,n??{}),o;try{let e=y(a),t=this.#i.getMetaForState(i),n=r.buildPath(i,e);o=this.#r.makeState(i,e,n,t,!0)}catch{return!1}let s=this.#r.get(),{toDeactivate:c,toActivate:l}=U(o,s);return this.#a.canNavigateTo(c,l,o,s)}usePlugin(...t){if(this.#l.isDisposed())throw new W(a.ROUTER_DISPOSED);let n=t.filter(Boolean);if(n.length===0)return()=>{};let r=e.l(this);r.validator?.plugins.validatePluginLimit(this.#o.count(),this.#t);for(let e of n)r.validator?.plugins.validateNoDuplicatePlugins(e,this.#o.getAll());return this.#o.use(...n)}subscribe(e){return Z.validateSubscribeListener(e),this.#l.subscribe(e)}subscribeLeave(e){return Z.validateSubscribeLeaveListener(e),this.#l.subscribeLeave(e)}isLeaveApproved(){return this.#l.isLeaveApproved()}navigate(t,r,i){this.#m();let a=e.l(this);a.validator?.navigation.validateNavigateArgs(t),a.validator?.navigation.validateParams(r,`navigate`);let o=i??Q;a.validator?.navigation.validateNavigationOptions(o,`navigate`);let s=this.#s.navigate(t,r??d,o);return this.#s.lastSyncResolved?this.#s.lastSyncResolved=!1:this.#s.lastSyncRejected?this.#s.lastSyncRejected=!1:n.#p(s),s}navigateToDefault(t){this.#m();let r=e.l(this);r.validator?.navigation.validateNavigateToDefaultArgs(t);let i=t??Q;r.validator?.navigation.validateNavigationOptions(i,`navigateToDefault`);let a=this.#s.navigateToDefault(i);return this.#s.lastSyncResolved?this.#s.lastSyncResolved=!1:this.#s.lastSyncRejected?this.#s.lastSyncRejected=!1:n.#p(a),a}navigateToNotFound(e){if(this.#m(),!this.#l.isActive())throw new W(a.ROUTER_NOT_STARTED);if(e!==void 0&&typeof e!=`string`)throw TypeError(`[router.navigateToNotFound] path must be a string, got ${typeof e}`);if(e!==void 0)return this.#s.navigateToNotFound(e);let t=this.#r.get();if(t===void 0)throw new W(a.ROUTER_NOT_STARTED,{message:`[router.navigateToNotFound] cannot derive the path before the start navigation commits — pass an explicit path`});return this.#s.navigateToNotFound(t.path)}static#u(e){return e instanceof W&&Zt.has(e.code)}static#d=e=>{n.#u(e)||t.logger.error(`router.navigate`,`Unexpected navigation error`,e)};static#f=e=>{n.#u(e)||t.logger.error(`router.start`,`Unexpected start error`,e)};static#p(e,t=n.#d){e.catch(t)}#m(){if(this.#l.isProcessing())throw new W(a.REENTRANT_NAVIGATION)}#h(e){throw this.#l.isReady()&&this.#r.get()===void 0?(this.#c.stop(),this.#l.sendStop()):this.#l.isStarting()&&this.#l.sendFail(void 0,void 0,e),e}#g(){this.navigate=$,this.navigateToDefault=$,this.navigateToNotFound=$,this.start=$,this.stop=$,this.usePlugin=$,this.subscribe=$,this.subscribeLeave=$,this.canNavigateTo=$}};function $(){throw new W(a.ROUTER_DISPOSED)}function en(e){return{strictTrailingSlash:e.trailingSlash===`strict`,caseSensitive:e.caseSensitive,strictQueryParams:e.queryParamsMode===`strict`,urlParamsEncoding:e.urlParamsEncoding,queryParams:e.queryParams}}Object.defineProperty(exports,"C",{enumerable:!0,get:function(){return a}}),Object.defineProperty(exports,"S",{enumerable:!0,get:function(){return s}}),Object.defineProperty(exports,"_",{enumerable:!0,get:function(){return Se}}),Object.defineProperty(exports,"a",{enumerable:!0,get:function(){return He}}),Object.defineProperty(exports,"b",{enumerable:!0,get:function(){return _}}),Object.defineProperty(exports,"c",{enumerable:!0,get:function(){return A}}),Object.defineProperty(exports,"d",{enumerable:!0,get:function(){return N}}),Object.defineProperty(exports,"f",{enumerable:!0,get:function(){return Ge}}),Object.defineProperty(exports,"g",{enumerable:!0,get:function(){return Ae}}),Object.defineProperty(exports,"h",{enumerable:!0,get:function(){return Ne}}),Object.defineProperty(exports,"i",{enumerable:!0,get:function(){return We}}),Object.defineProperty(exports,"l",{enumerable:!0,get:function(){return Ve}}),Object.defineProperty(exports,"m",{enumerable:!0,get:function(){return F}}),Object.defineProperty(exports,"n",{enumerable:!0,get:function(){return W}}),Object.defineProperty(exports,"o",{enumerable:!0,get:function(){return k}}),Object.defineProperty(exports,"p",{enumerable:!0,get:function(){return Me}}),Object.defineProperty(exports,"r",{enumerable:!0,get:function(){return U}}),Object.defineProperty(exports,"s",{enumerable:!0,get:function(){return j}}),Object.defineProperty(exports,"t",{enumerable:!0,get:function(){return $t}}),Object.defineProperty(exports,"u",{enumerable:!0,get:function(){return Ue}}),Object.defineProperty(exports,"v",{enumerable:!0,get:function(){return Oe}}),Object.defineProperty(exports,"w",{enumerable:!0,get:function(){return l}}),Object.defineProperty(exports,"x",{enumerable:!0,get:function(){return o}}),Object.defineProperty(exports,"y",{enumerable:!0,get:function(){return De}});
-//# sourceMappingURL=Router-CLGzVSB7.js.map