@real-router/core 0.158.0 → 0.159.0

package/dist/cjs/index.d.ts

@@ -1,6 +1,6 @@
 import { RouteTree } from "./engine/builder/types.js";
 import { QueryParamsMode, QueryParamsOptions, RouteParams, RouteTreeState } from "./types/route-node-types.js";
-import { NavigationTarget, Params, ParamsSearch, SearchParamPrimitive, SearchParamValue, SearchParams, SerializedRouterState, SimpleState, State, TransitionMeta, TransitionPhase, TransitionReason, Unsubscribe } from "./types/base.js";
+import { NavigationTarget, ParamValue, Params, ParamsSearch, SearchParamPrimitive, SearchParamValue, SearchParams, SerializedRouterState, SimpleState, State, TransitionMeta, TransitionPhase, TransitionReason, Unsubscribe, UrlChannels } from "./types/base.js";
 import { LimitsConfig } from "./types/limits.js";
 import { AdoptedOrigins, AnyOptions, DefaultDependencies, DefaultParamsCallback, DefaultRouteCallback, DefaultSearchCallback, ForwardToCallback, GuardFn, GuardFnFactory, LeaveFn, LeaveState, Listener, LogCallback, LogLevel, LogLevelConfig, LoggerConfig, Navigator, Options, Plugin, PluginFactory, ReadonlyRoute, Route, RouteConfigUpdate, RouterLogger, SubscribeFn, SubscribeState, Subscription } from "./types/router.js";
 import { ErrorCodeKeys, ErrorCodeToValueMap, ErrorCodeValues, EventMethodMap, EventName, EventToNameMap, EventToPluginMap, EventsKeys, PluginMethod } from "./types/constants.js";
@@ -14,4 +14,4 @@ import { RouterError } from "./RouterError.js";
 import { createRouter } from "./createRouter.js";
 import { getNavigator } from "./getNavigator.js";
 import { resolveForwardChain } from "./namespaces/RoutesNamespace/forwardChain.js";
-export { type AdoptedOrigins, type AnyOptions, type CheckFn, type CheckPositionMap, type Constants, type ContextNamespaceClaim, type DefaultDependencies, type DefaultParamsCallback, type DefaultRouteCallback, type DefaultSearchCallback, type DependenciesApi, type DiagnosticEventMap, type ErrorCodeKeys, type ErrorCodeToValueMap, type ErrorCodeValues, type ErrorCodes, type EventMethodMap, type EventName, type EventToNameMap, type EventToPluginMap, type EventsKeys, type ForwardToCallback, type GuardFn, type GuardFnFactory, type InterceptableMethodMap, type InterceptorFn, type LeaveFn, type LeaveState, type LifecycleApi, type LimitsConfig, type Listener, type LogCallback, type LogLevel, type LogLevelConfig, type LoggerConfig, type NavigationOptions, type NavigationTarget, type Navigator, type Options, type Params, type ParamsSearch, type Plugin, type PluginApi, type PluginFactory, type PluginMethod, type QueryParamsMode, type QueryParamsOptions, type ReadonlyRoute, type Route, type RouteConfigUpdate, type RouteParams, type RouteTree, type RouteTreeState, Router, RouterError, type RouterLogger, type RouterValidator, type RoutesApi, type SearchParamPrimitive, type SearchParamValue, type SearchParams, type SerializedRouterState, type SimpleState, type State, type StateContext, type SubscribeFn, type SubscribeState, type Subscription, type TransitionMeta, type TransitionPhase, type TransitionReason, type TreeChangedAdd, type TreeChangedClear, type TreeChangedEvent, type TreeChangedRemove, type TreeChangedReplace, type TreeChangedUpdate, type TreeStructuralPatch, UNKNOWN_ROUTE, type Unsubscribe, constants, createRouter, errorCodes, events, getNavigator, resolveForwardChain };
+export { type AdoptedOrigins, type AnyOptions, type CheckFn, type CheckPositionMap, type Constants, type ContextNamespaceClaim, type DefaultDependencies, type DefaultParamsCallback, type DefaultRouteCallback, type DefaultSearchCallback, type DependenciesApi, type DiagnosticEventMap, type ErrorCodeKeys, type ErrorCodeToValueMap, type ErrorCodeValues, type ErrorCodes, type EventMethodMap, type EventName, type EventToNameMap, type EventToPluginMap, type EventsKeys, type ForwardToCallback, type GuardFn, type GuardFnFactory, type InterceptableMethodMap, type InterceptorFn, type LeaveFn, type LeaveState, type LifecycleApi, type LimitsConfig, type Listener, type LogCallback, type LogLevel, type LogLevelConfig, type LoggerConfig, type NavigationOptions, type NavigationTarget, type Navigator, type Options, type ParamValue, type Params, type ParamsSearch, type Plugin, type PluginApi, type PluginFactory, type PluginMethod, type QueryParamsMode, type QueryParamsOptions, type ReadonlyRoute, type Route, type RouteConfigUpdate, type RouteParams, type RouteTree, type RouteTreeState, Router, RouterError, type RouterLogger, type RouterValidator, type RoutesApi, type SearchParamPrimitive, type SearchParamValue, type SearchParams, type SerializedRouterState, type SimpleState, type State, type StateContext, type SubscribeFn, type SubscribeState, type Subscription, type TransitionMeta, type TransitionPhase, type TransitionReason, type TreeChangedAdd, type TreeChangedClear, type TreeChangedEvent, type TreeChangedRemove, type TreeChangedReplace, type TreeChangedUpdate, type TreeStructuralPatch, UNKNOWN_ROUTE, type Unsubscribe, type UrlChannels, constants, createRouter, errorCodes, events, getNavigator, resolveForwardChain };

package/dist/cjs/namespaces/RoutesNamespace/routesStore.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"routesStore.d.ts","names":[],"sources":["../../../../src/namespaces/RoutesNamespace/routesStore.ts"],"mappings":";;;;;iBA0FiB,YACf,qBAAqB,sBAAsB;;;;;;;;;;;;;WAclC,aAAa;WACb,QAAQ;EACjB,MAAM;EACN,SAAS;;;;;;;WAOA,gBAAgB;;;;;;;;;WAShB,kBAAkB;EAC3B,oBAAoB;;;;;;;;;;;EAYpB;;;;;;;;;;;;;;;;;;;;;;EAuBA;EACA,mBAAmB,eAAe;EAClC;WACS,gBAAgB;EACzB,WAAW,mBAAmB;EAC9B,oBAAoB,wBAAwB;WACnC,oBAAoB,YAAY,eAAe;WAC/C,sBAAsB,YAAY,eAAe"}
+{"version":3,"file":"routesStore.d.ts","names":[],"sources":["../../../../src/namespaces/RoutesNamespace/routesStore.ts"],"mappings":";;;;;iBA2FiB,YACf,qBAAqB,sBAAsB;;;;;;;;;;;;;WAclC,aAAa;WACb,QAAQ;EACjB,MAAM;EACN,SAAS;;;;;;;WAOA,gBAAgB;;;;;;;;;WAShB,kBAAkB;EAC3B,oBAAoB;;;;;;;;;;;EAYpB;;;;;;;;;;;;;;;;;;;;;;EAuBA;EACA,mBAAmB,eAAe;EAClC;WACS,gBAAgB;EACzB,WAAW,mBAAmB;EAC9B,oBAAoB,wBAAwB;WACnC,oBAAoB,YAAY,eAAe;WAC/C,sBAAsB,YAAY,eAAe"}

package/dist/cjs/namespaces/RoutesNamespace/types.d.ts

@@ -1,4 +1,4 @@
-import { Params, ParamsSearch, SearchParams, State } from "../../types/base.js";
+import { Params, ParamsSearch, SearchParams, State, UrlChannels } from "../../types/base.js";
 import { DefaultDependencies, ForwardToCallback, GuardFn, GuardFnFactory, RouterLogger } from "../../types/router.js";
 import { RouterValidator } from "../../types/RouterValidator.js";
 import { RouteResolver } from "../../pipeline/port.js";
@@ -56,7 +56,7 @@ export interface RoutesDependencies<Dependencies extends DefaultDependencies = D
  */
 export interface RouteConfig {
   /** Custom param decoders per route */
-  decoders: Record<string, (channels: ParamsSearch) => ParamsSearch>;
+  decoders: Record<string, (channels: UrlChannels) => ParamsSearch>;
   /** Custom param encoders per route */
   encoders: Record<string, (channels: ParamsSearch) => ParamsSearch>;
   /** Default params per route */

package/dist/cjs/namespaces/RoutesNamespace/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","names":[],"sources":["../../../../src/namespaces/RoutesNamespace/types.ts"],"mappings":";;;;;;;;;;iBAsBiB,mBACf,qBAAqB,sBAAsB;;EAG3C,QAAQ;;;;;;;;EASR,oBAAoB;;;;;;;;;EAUpB,MAAM;;;;;;;EAQN,mBACE,cACA,SAAS,eAAe,eACxB,gBAAgB;;EAIlB,qBACE,cACA,SAAS,eAAe,eACxB,gBAAgB;;;;;;EAQlB,eACE,SAAS,eAAe,eACxB,uBACG;;EAML,gBAAgB;;EAGhB,iBACE,QAAQ,mBACR,QAAQ,mBACR;;EAIF,gBAAgB,gBAAgB,cAAc,MAAM,MAAM,aAAa;;;;;;iBAiBxD;;EAEf,UAAU,gBAAgB,UAAU,iBAAiB;;EAGrD,UAAU,gBAAgB,UAAU,iBAAiB;;EAGrD,eAAe,eAAe;;EAG9B,eAAe,eAAe;;EAG9B,YAAY;;EAIZ,cAAc,eAAe"}
+{"version":3,"file":"types.d.ts","names":[],"sources":["../../../../src/namespaces/RoutesNamespace/types.ts"],"mappings":";;;;;;;;;;iBAuBiB,mBACf,qBAAqB,sBAAsB;;EAG3C,QAAQ;;;;;;;;EASR,oBAAoB;;;;;;;;;EAUpB,MAAM;;;;;;;EAQN,mBACE,cACA,SAAS,eAAe,eACxB,gBAAgB;;EAIlB,qBACE,cACA,SAAS,eAAe,eACxB,gBAAgB;;;;;;EAQlB,eACE,SAAS,eAAe,eACxB,uBACG;;EAML,gBAAgB;;EAGhB,iBACE,QAAQ,mBACR,QAAQ,mBACR;;EAIF,gBAAgB,gBAAgB,cAAc,MAAM,MAAM,aAAa;;;;;;iBAiBxD;;EAEf,UAAU,gBAAgB,UAAU,gBAAgB;;EAGpD,UAAU,gBAAgB,UAAU,iBAAiB;;EAGrD,eAAe,eAAe;;EAG9B,eAAe,eAAe;;EAG9B,YAAY;;EAIZ,cAAc,eAAe"}

package/dist/cjs/types/RouterValidator.d.ts

@@ -1,4 +1,4 @@
-import { ParamsSearch, State } from "./base.js";
+import { ParamsSearch, State, UrlChannels } from "./base.js";
 export interface RouterValidator {
   /**
    * Route validation methods
@@ -152,7 +152,7 @@ export interface RouterValidator {
      */
     reportCodecRoundTrip: (state: State, codec: {
       readonly encode: ((channels: ParamsSearch) => ParamsSearch) | undefined;
-      readonly decode: ((channels: ParamsSearch) => ParamsSearch) | undefined;
+      readonly decode: ((channels: UrlChannels) => ParamsSearch) | undefined;
     }, pathSlots: readonly string[]) => void;
   };
   /**

package/dist/cjs/types/RouterValidator.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"RouterValidator.d.ts","names":[],"sources":["../../../src/types/RouterValidator.ts"],"mappings":";iBAeiB;;;;EAIf;IACE,wBAAwB,gBAAgB;IACxC,wBAAwB;IACxB,4BACE,eACA,iBACA,iBACA;IAEF,+BAA+B;IAC/B,2BACE,eACA,iBACA;;;;;;;;;;;;;IAcF,oBAAoB,eAAe;IACnC,0BAA0B;;;;;EAM5B;IACE,kBAAkB,kBAAkB;;IAEpC,+BAA+B;;;;;EAMjC;IACE,yBAAyB,eAAe;IACxC,4BACE,eACA,gBACA;IAEF,6BAA6B,eAAe;;;;;;IAM5C,2BAA2B,cAAc;;;;;;;;;;IAUzC,0BACE,sBACA,yBACA;IAEF,oBAAoB;IACpB,gBAAgB,cAAc;IAC9B,qBAAqB,gBAAgB;IACrC,wBAAwB;;;;;EAM1B;IACE,sBAAsB,eAAe;IACrC,6BACE,kBACA;IAEF,qBAAqB;IACrB,0BAA0B;IAC1B,sBAAsB;IACtB,uBAAuB;;;;;EAMzB;IACE,uBAAuB,eAAe;IACtC,0BAA0B,eAAe;IACzC,gBAAgB,cAAc,cAAc;IAC5C,qBAAqB,cAAc;;;;;;IAMnC,0BACE,cACA,iBACA;;;;;;IAOF,sBAAsB,cAAc;;;;;EAMtC;IACE,gCAAgC;IAChC,8BAA8B;IAC9B,4BAA4B,kBAAkB;;;;;;;;IAQ9C,sBAAsB,iBAAiB;;;;;;;;IAQvC,iBAAiB,iBAAiB;IAClC,oBAAoB;;;;;EAMtB;IACE,wBACE,eACA,iBACA;IAEF,6BACE,aACA,aACA;;;;;;;;;;;;IAaF,wBAAwB,mBAAmB;;IAG3C,2BAA2B,mBAAmB;;;;;;;;;;;;;;IAe9C,uBACE,OAAO,OACP;eACW,UAAU,UAAU,iBAAiB;eACrC,UAAU,UAAU,iBAAiB;OAEhD;;;;;EAOJ;IACE,uBAAuB,eAAe;IACtC,0BACE,eACA,mBACA"}
+{"version":3,"file":"RouterValidator.d.ts","names":[],"sources":["../../../src/types/RouterValidator.ts"],"mappings":";iBAeiB;;;;EAIf;IACE,wBAAwB,gBAAgB;IACxC,wBAAwB;IACxB,4BACE,eACA,iBACA,iBACA;IAEF,+BAA+B;IAC/B,2BACE,eACA,iBACA;;;;;;;;;;;;;IAcF,oBAAoB,eAAe;IACnC,0BAA0B;;;;;EAM5B;IACE,kBAAkB,kBAAkB;;IAEpC,+BAA+B;;;;;EAMjC;IACE,yBAAyB,eAAe;IACxC,4BACE,eACA,gBACA;IAEF,6BAA6B,eAAe;;;;;;IAM5C,2BAA2B,cAAc;;;;;;;;;;IAUzC,0BACE,sBACA,yBACA;IAEF,oBAAoB;IACpB,gBAAgB,cAAc;IAC9B,qBAAqB,gBAAgB;IACrC,wBAAwB;;;;;EAM1B;IACE,sBAAsB,eAAe;IACrC,6BACE,kBACA;IAEF,qBAAqB;IACrB,0BAA0B;IAC1B,sBAAsB;IACtB,uBAAuB;;;;;EAMzB;IACE,uBAAuB,eAAe;IACtC,0BAA0B,eAAe;IACzC,gBAAgB,cAAc,cAAc;IAC5C,qBAAqB,cAAc;;;;;;IAMnC,0BACE,cACA,iBACA;;;;;;IAOF,sBAAsB,cAAc;;;;;EAMtC;IACE,gCAAgC;IAChC,8BAA8B;IAC9B,4BAA4B,kBAAkB;;;;;;;;IAQ9C,sBAAsB,iBAAiB;;;;;;;;IAQvC,iBAAiB,iBAAiB;IAClC,oBAAoB;;;;;EAMtB;IACE,wBACE,eACA,iBACA;IAEF,6BACE,aACA,aACA;;;;;;;;;;;;IAaF,wBAAwB,mBAAmB;;IAG3C,2BAA2B,mBAAmB;;;;;;;;;;;;;;IAe9C,uBACE,OAAO,OACP;eACW,UAAU,UAAU,iBAAiB;eACrC,UAAU,UAAU,gBAAgB;OAE/C;;;;;EAOJ;IACE,uBAAuB,eAAe;IACtC,0BACE,eACA,mBACA"}

package/dist/cjs/types/base.d.ts

@@ -103,29 +103,39 @@ export interface NavigationTarget<P extends Params = Params, S extends SearchPar
   search?: S;
 }
 /**
- * The two navigation channels a per-route codec operates on (RFC-4 M2 / #1548):
- * `params` is the path channel, `search` the query channel. Used as **both** the
- * input and the output of {@link Route.encodeParams} / {@link Route.decodeParams}
- * — a codec transforms whichever channel(s) it owns and returns the other channel
- * unchanged (it must be passed through explicitly).
+ * The two navigation channels (RFC-4 M2 / #1548): `params` is the path channel,
+ * `search` the query channel. With the default arguments it is the STATE side
+ * of a per-route codec (#2834): what {@link Route.decodeParams} returns and what
+ * {@link Route.encodeParams} receives and returns. A codec transforms the
+ * channel(s) it owns and passes the other through.
  *
- * @remarks
- * v1 ran the whole (path + query) bag through both callbacks, so a query value
- * reached `decodeParams`. This two-channel shape preserves that reach: the query
- * arrives in `search` rather than merged into `params`. Value semantics are
- * unchanged — only the storage location differs (M2 keeps query parsing/printing
- * exactly as v1).
+ * The URL side is {@link UrlChannels}, what `decodeParams` receives.
  */
 export interface ParamsSearch<P extends Params = Params, S extends SearchParams = SearchParams> {
   params: P;
   search: S;
 }
+/**
+ * The URL side of a per-route codec (#2834): what {@link Route.decodeParams}
+ * receives. Path slots are the strings the matcher captured; query values are
+ * typed by the parser.
+ *
+ * `encodeParams` returns into the URL and is still typed {@link ParamsSearch}:
+ * an encoder hands on a channel it does not own — `search` as it came, or
+ * `{ ...search }` with nothing after it — and that channel holds state values,
+ * so a URL-typed return would refuse the encoder. The wiki's Dates recipe,
+ * which `codec-state-values-2834.test.ts` type-checks, hands on `params`.
+ */
+export type UrlChannels = ParamsSearch<Record<string, string>, Record<string, SearchParamValue | undefined>>;
 /**
  * Parsed shape produced by `serializeRouterState()` (`@real-router/ssr-utils`,
  * after `JSON.parse`). Identical to {@link State} minus `transition`
  * (per-navigation `TransitionMeta` is meaningless after hydration; the client
  * builds its own on commit). Defined here, not in `ssr-utils`, because the
  * shape is core's own `State`; `ssr-utils` re-exports it.
+ *
+ * ⚠ Under the default `JSON.parse`, a `Date` in a channel comes back as its ISO
+ * string, and an Invalid Date as `null`.
  */
 export type SerializedRouterState<P extends Params = Params> = Omit<State<P>, "transition">;
 /**
@@ -145,26 +155,49 @@ export interface RouterError extends Error {
   getField: (key: string) => unknown;
   toJSON: () => Record<string, unknown>;
 }
+/**
+ * A value a state channel carries (#2834): a JSON primitive, a `Date`, a plain
+ * object of state values, an array of any of those, or `undefined`. An array
+ * holds no `undefined`, which JSON would print as `null`. It is what
+ * {@link State.params} and {@link State.search} hold, what `navigate` and route
+ * defaults take, and what a route's `decodeParams` may return.
+ *
+ * Core compares these by value — a `Date` by its time, a plain object by its
+ * JSON (`areParamValuesEqual`) — and `@real-router/sources`' `canonicalJson`
+ * builds a cache key from them and refuses any other object.
+ *
+ * A URL holds less: a path slot is a string and a query value a
+ * {@link SearchParamValue}. A route codec converts between the two; without
+ * one, a `Date` or an object does not survive the trip through the URL.
+ */
+export type ParamValue = ParamLeaf | ParamLeaf[] | undefined;
+/**
+ * A {@link ParamValue} that is neither an array nor `undefined`.
+ *
+ * ⚠ One array level, not a recursive `ParamValue[]`: the recursive form fails
+ * core's type-check with TS2589.
+ */
+type ParamLeaf = string | number | boolean | null | Date | Params;
+/** The path channel, {@link State.params}: path slots and app-level data. */
 export interface Params {
-  [key: string]: string | string[] | number | number[] | boolean | boolean[] | Params | Params[] | Record<string, string | number | boolean> | null | undefined;
+  [key: string]: ParamValue;
 }
 /**
- * Query-parameter primitive values. Mirrors the engine's `QueryParamPrimitive`
- * (`engine/search-params/types.ts`) — the value form is identical to v1's query
- * half (the union produced across `queryParamsMode` formats).
+ * A primitive query value as the URL parser types it. Mirrors the engine's
+ * `QueryParamPrimitive` (`engine/search-params/types.ts`).
  */
 export type SearchParamPrimitive = string | number | boolean | null;
 /**
- * A single query-parameter value — a primitive or an array of primitives.
+ * A single query value as the URL parser types it — a primitive or an array of
+ * primitives. It is what `decodeParams` receives ({@link UrlChannels}); the
+ * state side carries a {@link ParamValue}.
  */
 export type SearchParamValue = SearchParamPrimitive | SearchParamPrimitive[];
 /**
- * Query-parameter bag carried by {@link State.search} — the query channel,
- * split out of the former single `params` bag in M2 (RFC-4 M2 / #1548). Only
- * the storage location changes vs v1; value semantics (modes, `queryParamsMode`,
- * ternary arrays) are unchanged. Structurally matches the engine's internal
- * `SearchParams` (`engine/search-params/types.ts`), so match results flow into
- * `State.search` without conversion.
+ * The query channel, {@link State.search} (RFC-4 M2 / #1548). Its values are
+ * state values (#2834); what the URL parser produces for it is a
+ * {@link SearchParamValue}, which is one.
  */
-export type SearchParams = Record<string, SearchParamValue | undefined>;
+export type SearchParams = Record<string, ParamValue>;
+export {};
 //# sourceMappingURL=base.d.ts.map

package/dist/cjs/types/base.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"base.d.ts","names":[],"sources":["../../../src/types/base.ts"],"mappings":";;;;;;;;;;YAmBY;iBAEK,YACf,UAAU,SAAS,QACnB,UAAU,eAAe;EAEzB;EACA,QAAQ;;;;;;EAMR,QAAQ;;YAGE;YAEA;iBAEK;EACf,OAAO;EACP,QAAQ;EACR;EACA;EACA;EACA;EACA;EACA;IACE;IACA;IACA;;;iBAIa,MACf,UAAU,SAAS,QACnB,UAAU,eAAe;EAEzB;EACA,QAAQ;;;;;;EAMR,QAAQ;EACR;;;;;;;;;;;;;;;;;;;;;;EAsBA,YAAY;;;;;;;;;;;;;;;;;;;;;EAqBZ,SAAS,eAAe;;;;;;;;;;iBAWT,iBACf,UAAU,SAAS,QACnB,UAAU,eAAe;EAEzB;EACA,SAAS;EACT,SAAS;;;;;;;;;;;;;;;;iBAiBM,aACf,UAAU,SAAS,QACnB,UAAU,eAAe;EAEzB,QAAQ;EACR,QAAQ;;;;;;;;;YAUE,sBAAsB,UAAU,SAAS,UAAU,KAC7D,MAAM;;;;;;iBASS,oBAAoB;GAClC;WACQ;WACA;WACA;EACT,UAAU;EACV,mBAAmB,KAAK;EACxB,sBAAsB,QAAQ;EAC9B,WAAW;EACX,WAAW;EACX,cAAc;;iBAGC;GACd,4EAOG,SACA,WACA;;;;;;;YAUM;;;;YAKA,mBAAmB,uBAAuB;;;;;;;;;YAU1C,eAAe,eAAe"}
+{"version":3,"file":"base.d.ts","names":[],"sources":["../../../src/types/base.ts"],"mappings":";;;;;;;;;;YAmBY;iBAEK,YACf,UAAU,SAAS,QACnB,UAAU,eAAe;EAEzB;EACA,QAAQ;;;;;;EAMR,QAAQ;;YAGE;YAEA;iBAEK;EACf,OAAO;EACP,QAAQ;EACR;EACA;EACA;EACA;EACA;EACA;IACE;IACA;IACA;;;iBAIa,MACf,UAAU,SAAS,QACnB,UAAU,eAAe;EAEzB;EACA,QAAQ;;;;;;EAMR,QAAQ;EACR;;;;;;;;;;;;;;;;;;;;;;EAsBA,YAAY;;;;;;;;;;;;;;;;;;;;;EAqBZ,SAAS,eAAe;;;;;;;;;;iBAWT,iBACf,UAAU,SAAS,QACnB,UAAU,eAAe;EAEzB;EACA,SAAS;EACT,SAAS;;;;;;;;;;;iBAYM,aACf,UAAU,SAAS,QACnB,UAAU,eAAe;EAEzB,QAAQ;EACR,QAAQ;;;;;;;;;;;;;YAcE,cAAc,aACxB,wBACA,eAAe;;;;;;;;;;;YAaL,sBAAsB,UAAU,SAAS,UAAU,KAC7D,MAAM;;;;;;iBASS,oBAAoB;GAClC;WACQ;WACA;WACA;EACT,UAAU;EACV,mBAAmB,KAAK;EACxB,sBAAsB,QAAQ;EAC9B,WAAW;EACX,WAAW;EACX,cAAc;;;;;;;;;;;;;;;;;YAkBJ,aAAa,YAAY;;;;;;;KAQhC,+CAA+C,OAAO;;iBAG1C;GACd,cAAc;;;;;;YAOL;;;;;;YAOA,mBAAmB,uBAAuB;;;;;;YAO1C,eAAe,eAAe"}

package/dist/cjs/types/router.d.ts

@@ -1,5 +1,5 @@
 import { QueryParamsMode, QueryParamsOptions } from "./route-node-types.js";
-import { NavigationTarget, Params, ParamsSearch, RouterError, SearchParams, State, Unsubscribe } from "./base.js";
+import { NavigationTarget, Params, ParamsSearch, RouterError, SearchParams, State, Unsubscribe, UrlChannels } from "./base.js";
 import { LimitsConfig } from "./limits.js";
 import { NavigationOptions } from "../types.js";
 export type LogLevel = "log" | "warn" | "error";
@@ -338,17 +338,19 @@ export interface Route<Dependencies extends DefaultDependencies = DefaultDepende
   children?: Route<Dependencies>[];
   /**
    * Encodes the state channels to URL channels before path building (RFC-4 M2 /
-   * #1548). Receives `{ params, search }` and returns `{ params, search }` —
-   * transform whichever channel you own and pass the other through. The path
-   * slots are built from the returned `params`, the query string from the
-   * returned `search`.
+   * #1548). Receives `{ params, search }` holding state values and returns
+   * `{ params, search }` — transform whichever channel you own and pass the
+   * other through. The path slots are built from the returned `params`, the
+   * query string from the returned `search`.
    */
   encodeParams?: (channels: ParamsSearch) => ParamsSearch;
   /**
    * Decodes the matched URL channels to state channels (RFC-4 M2 / #1548).
-   * Receives `{ params, search }` (path params + parsed query) and returns
-   * `{ params, search }`. Runs inside `matchPath`, **before** any search-schema
-   * plugin validation — the v1 transformation order (engine codec → plugin).
+   * Receives {@link UrlChannels} — path slots as strings, query values as the
+   * parser typed them — and returns `{ params, search }` holding state values,
+   * such as a `Date` (#2834). Runs inside `matchPath`, **before** any
+   * search-schema plugin validation — the v1 transformation order (engine
+   * codec → plugin).
    *
    * Only the URL side runs it: `navigate`, `buildPath` and `makeState` take
    * params in the form it returns. So it must undo `encodeParams` and add no
@@ -358,7 +360,7 @@ export interface Route<Dependencies extends DefaultDependencies = DefaultDepende
    * `@real-router/validation-plugin` runs the pair on each state a navigation
    * commits and warns about a key that does not come back.
    */
-  decodeParams?: (channels: ParamsSearch) => ParamsSearch;
+  decodeParams?: (channels: UrlChannels) => ParamsSearch;
   /**
    * Default **path** parameters for this route (and arbitrary app-level
    * defaults). Merged into `state.params`; missing path params are filled from
@@ -442,7 +444,7 @@ export interface RouteConfigUpdate<Dependencies extends DefaultDependencies = De
   /** Set to null to remove defaultSearch (RFC-4 M2 / #1548) */
   defaultSearch?: SearchParams | null;
   /** Set to null to remove decoder */
-  decodeParams?: ((channels: ParamsSearch) => ParamsSearch) | null;
+  decodeParams?: ((channels: UrlChannels) => ParamsSearch) | null;
   /** Set to null to remove encoder */
   encodeParams?: ((channels: ParamsSearch) => ParamsSearch) | null;
   /** Set to null to remove canActivate */

package/dist/cjs/types/router.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"router.d.ts","names":[],"sources":["../../../src/types/router.ts"],"mappings":"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"}
+{"version":3,"file":"router.d.ts","names":[],"sources":["../../../src/types/router.ts"],"mappings":"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"}

package/dist/cjs/types.d.ts

@@ -1,5 +1,5 @@
 import { QueryParamsMode, QueryParamsOptions, RouteParams, RouteTreeState } from "./types/route-node-types.js";
-import { NavigationTarget, Params, ParamsSearch, RouterError, SearchParamPrimitive, SearchParamValue, SearchParams, SerializedRouterState, SimpleState, State, TransitionMeta, TransitionPhase, TransitionReason, Unsubscribe } from "./types/base.js";
+import { NavigationTarget, ParamValue, Params, ParamsSearch, RouterError, SearchParamPrimitive, SearchParamValue, SearchParams, SerializedRouterState, SimpleState, State, TransitionMeta, TransitionPhase, TransitionReason, Unsubscribe, UrlChannels } from "./types/base.js";
 import { LimitsConfig } from "./types/limits.js";
 import { AdoptedOrigins, AnyOptions, DefaultDependencies, DefaultParamsCallback, DefaultRouteCallback, DefaultSearchCallback, ForwardToCallback, GuardFn, GuardFnFactory, LeaveFn, LeaveState, Listener, LogCallback, LogLevel, LogLevelConfig, LoggerConfig, Navigator, Options, Plugin, PluginFactory, ReadonlyRoute, Route, RouteConfigUpdate, Router, RouterLogger, SubscribeFn, SubscribeState, Subscription } from "./types/router.js";
 import { ErrorCodeKeys, ErrorCodeToValueMap, ErrorCodeValues, EventMethodMap, EventName, EventToNameMap, EventToPluginMap, EventsKeys, PluginMethod } from "./types/constants.js";
@@ -239,5 +239,5 @@ export interface NavigationOptions {
    */
   signal?: AbortSignal | undefined;
 }
-export type { AdoptedOrigins, AnyOptions, CheckFn, CheckPositionMap, ContextNamespaceClaim, DefaultDependencies, DefaultParamsCallback, DefaultRouteCallback, DefaultSearchCallback, DependenciesApi, DiagnosticEventMap, ErrorCodeKeys, ErrorCodeToValueMap, ErrorCodeValues, EventMethodMap, EventName, EventToNameMap, EventToPluginMap, EventsKeys, ForwardToCallback, GuardFn, GuardFnFactory, InterceptableMethodMap, InterceptorFn, LeaveFn, LeaveState, LifecycleApi, LimitsConfig, Listener, LogCallback, LogLevel, LogLevelConfig, LoggerConfig, NavigationTarget, Navigator, Options, Params, ParamsSearch, Plugin, PluginApi, PluginFactory, PluginMethod, QueryParamsMode, QueryParamsOptions, ReadonlyRoute, Route, RouteConfigUpdate, RouteParams, RouteTreeState, Router, RouterError, RouterLogger, RoutesApi, SearchParamPrimitive, SearchParamValue, SearchParams, SerializedRouterState, SimpleState, State, SubscribeFn, SubscribeState, Subscription, TransitionMeta, TransitionPhase, TransitionReason, TreeChangedAdd, TreeChangedClear, TreeChangedEvent, TreeChangedRemove, TreeChangedReplace, TreeChangedUpdate, TreeStructuralPatch, Unsubscribe };
+export type { AdoptedOrigins, AnyOptions, CheckFn, CheckPositionMap, ContextNamespaceClaim, DefaultDependencies, DefaultParamsCallback, DefaultRouteCallback, DefaultSearchCallback, DependenciesApi, DiagnosticEventMap, ErrorCodeKeys, ErrorCodeToValueMap, ErrorCodeValues, EventMethodMap, EventName, EventToNameMap, EventToPluginMap, EventsKeys, ForwardToCallback, GuardFn, GuardFnFactory, InterceptableMethodMap, InterceptorFn, LeaveFn, LeaveState, LifecycleApi, LimitsConfig, Listener, LogCallback, LogLevel, LogLevelConfig, LoggerConfig, NavigationTarget, Navigator, Options, ParamValue, Params, ParamsSearch, Plugin, PluginApi, PluginFactory, PluginMethod, QueryParamsMode, QueryParamsOptions, ReadonlyRoute, Route, RouteConfigUpdate, RouteParams, RouteTreeState, Router, RouterError, RouterLogger, RoutesApi, SearchParamPrimitive, SearchParamValue, SearchParams, SerializedRouterState, SimpleState, State, SubscribeFn, SubscribeState, Subscription, TransitionMeta, TransitionPhase, TransitionReason, TreeChangedAdd, TreeChangedClear, TreeChangedEvent, TreeChangedRemove, TreeChangedReplace, TreeChangedUpdate, TreeStructuralPatch, Unsubscribe, UrlChannels };
 //# sourceMappingURL=types.d.ts.map

package/dist/cjs/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","names":[],"sources":["../../src/types/index.ts"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBA+DiB;;;;;;;;;;;;;;iBAeA;;;;;;;;;;;;;;;;;EAiBf;;;;;;;;;;;;;;;EAgBA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA6CA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAuCA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAkCA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAuCA;;;;;;;;;;;EAYA,SAAS"}
+{"version":3,"file":"types.d.ts","names":[],"sources":["../../src/types/index.ts"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAiEiB;;;;;;;;;;;;;;iBAeA;;;;;;;;;;;;;;;;;EAiBf;;;;;;;;;;;;;;;EAgBA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA6CA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAuCA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAkCA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAuCA;;;;;;;;;;;EAYA,SAAS"}