@xmachines/play-router 2.0.0 → 2.1.0

package/dist/url-pattern-utils.d.ts

@@ -1,20 +1,21 @@
 /**
- * Shared URLPattern utilities — internal module, NOT exported from index.ts
+ * The shared URLPattern utilities — an internal module. index.ts does not export it
  *
- * Provides the common URLPattern plumbing shared by:
+ * This module holds the common URLPattern work of four files:
  * - `create-route-map.ts`
  * - `base-route-map.ts`
  * - `find-route.ts`
  * - `router-bridge-base.ts`
  *
- * URLPattern is accessed via globalThis — consumers must load a polyfill on
- * environments without native support (Node < 24, older browsers).
+ * The module reads URLPattern from globalThis. A consumer must load a polyfill in an
+ * environment without the native API: Node < 24, and an older browser.
  *
  * @internal
  */
 /**
- * Minimal structural type for the subset of URLPattern we use.
- * Avoids a hard dependency on the full URLPattern type declaration.
+ * The minimal structural type of the part of URLPattern that this package uses.
+ * The package therefore needs no hard dependency on the complete type declaration of
+ * URLPattern.
  */
 export type URLPatternLike = {
     exec(input: {
@@ -28,39 +29,42 @@ export type URLPatternLike = {
         pathname: string;
     }): boolean;
 };
-/** Constructor type for URLPatternLike instances. */
+/** The constructor type of a URLPatternLike instance. */
 export type URLPatternCtor = new (init: {
     pathname: string;
 }) => URLPatternLike;
 /**
- * Retrieve the URLPattern constructor from `globalThis`, or `undefined` if
- * it is not available (Node < 24, older browsers without a polyfill).
+ * Returns the URLPattern constructor of `globalThis`, or `undefined` when it is
+ * absent: in Node < 24, and in an older browser without a polyfill.
  */
 export declare function getURLPatternCtor(): URLPatternCtor | undefined;
 /**
- * Check whether a route path is a parameterized pattern rather than a concrete URL.
+ * Tells you if a route path is a parameterized pattern, and not a concrete URL.
  *
- * A pattern contains `:param` segments (required or optional) and/or the `*`
- * wildcard — both require URLPattern matching and carry no concrete values, so
- * they can never be pushed to a browser URL verbatim.
+ * A pattern holds a `:param` segment, which is necessary or optional, or the `*`
+ * wildcard, or both. Each of them needs a URLPattern match, and each of them carries
+ * no concrete value. Therefore the code can push such a path to a browser URL
+ * never.
  *
- * This is THE single source of truth for "is this path a pattern?" — used by
- * `RouteMap` to decide static-map vs pattern-bucket indexing and by
- * `RouterBridgeBase.resolveNavigationPath` to skip non-navigable routes, so the
- * two checks can never drift apart.
+ * This function is THE single source of truth of the question "is this path a
+ * pattern?". `RouteMap` uses it for its decision between the static map and the
+ * index of the pattern buckets, and `RouterBridgeBase.resolveNavigationPath` uses it
+ * to skip a route of no navigation. The two tests therefore cannot move apart.
  *
- * @param path - URL path or route pattern string (e.g. `/profile/:userId`, `/docs/*`)
- * @returns `true` if the path contains `:param` or `*` pattern syntax
+ * @param path - The string of a URL path or of a route pattern, for example `/profile/:userId` or `/docs/*`
+ * @returns `true` when the path holds a `:param` or a `*` pattern syntax
  */
 export declare function isParameterizedPattern(path: string): boolean;
 /**
- * Normalize a route path so its parameter names are valid URLPattern identifiers.
+ * Normalizes a route path, so that each of its parameter names is a valid URLPattern
+ * identifier.
  *
- * URLPattern requires parameter names to be valid JS identifiers (no hyphens).
- * Hyphenated names like `:cat-id` are replaced with underscored equivalents
- * (`:cat_id`) for the URLPattern compilation step. Callers that need the captured
- * group values (not just a match test) must map the normalized group names back to
- * the original param names via {@link getNormalizedParamNameMap}.
+ * URLPattern requires a valid JS identifier as a parameter name, and such an
+ * identifier holds no hyphen. Therefore the function replaces a name with a hyphen,
+ * for example `:cat-id`, with the equivalent name with an underscore (`:cat_id`),
+ * for the compilation step of URLPattern. A caller that needs the values of the
+ * captured groups, and not a test of the match alone, must map each normalized group
+ * name back to the original param name with {@link getNormalizedParamNameMap}.
  *
  * @example
  * normalizeParamNames("/docs/:cat-id/:page-num?")
@@ -68,11 +72,11 @@ export declare function isParameterizedPattern(path: string): boolean;
  */
 export declare function normalizeParamNames(path: string): string;
 /**
- * Build a map from normalized URLPattern group names back to the original
- * (hyphenated) param names for a route pattern.
+ * Builds the map from each normalized URLPattern group name back to the original
+ * param name, which holds a hyphen, of a route pattern.
  *
- * Only params rewritten by {@link normalizeParamNames} appear in the map —
- * params that are already valid identifiers keep their own name and need no entry.
+ * The map holds only the params that {@link normalizeParamNames} rewrote. A param
+ * with a valid identifier keeps its own name, and it needs no entry.
  *
  * @example
  * getNormalizedParamNameMap("/docs/:cat-id/:plain")
@@ -80,36 +84,38 @@ export declare function normalizeParamNames(path: string): string;
  */
 export declare function getNormalizedParamNameMap(path: string): Map<string, string>;
 /**
- * Compile a route pattern to a `URLPattern`, reusing the module-level cache.
+ * Compiles a route pattern into a `URLPattern`, and it uses the cache of the module
+ * level again.
  *
- * The pattern is normalized with {@link normalizeParamNames} before compilation
- * so hyphenated param names (`:cat-id`) become valid URLPattern identifiers
- * (`:cat_id`). Callers that extract group values must map the normalized names
- * back via {@link getNormalizedParamNameMap}.
+ * {@link normalizeParamNames} normalizes the pattern before the compilation. A param
+ * name with a hyphen (`:cat-id`) therefore becomes a valid URLPattern identifier
+ * (`:cat_id`). A caller that reads the values of the groups must map each normalized
+ * name back with {@link getNormalizedParamNameMap}.
  *
- * Compilation errors from the URLPattern constructor propagate as-is — callers
- * that need a typed error wrap this in `InvalidRoutePatternError`.
+ * An error of the compilation from the URLPattern constructor goes to the caller
+ * without a change. A caller that needs a typed error wraps this function in an
+ * `InvalidRoutePatternError`.
  *
- * @param pattern - Route pattern string (e.g. `/profile/:userId`)
- * @param Ctor - URLPattern constructor retrieved via {@link getURLPatternCtor}
+ * @param pattern - The string of the route pattern, for example `/profile/:userId`
+ * @param Ctor - The URLPattern constructor, from {@link getURLPatternCtor}
  */
 export declare function getCompiledPattern(pattern: string, Ctor: URLPatternCtor): URLPatternLike;
 /**
- * Compute the bucket index key for a given path or pattern.
+ * Computes the key of the bucket index of a path or of a pattern.
  *
- * The key is the first path segment (e.g. `"settings"` for `"/settings/:id"`).
- * Parameterised first segments (`:lang`) fall into the `"*"` wildcard bucket.
- * The root path `"/"` maps to the key `"/"`.
+ * The key is the first path segment, for example `"settings"` of `"/settings/:id"`.
+ * A first segment with a parameter (`:lang`) goes into the `"*"` wildcard bucket.
+ * The root path `"/"` gives the key `"/"`.
  *
- * @param path - URL path or route pattern string
+ * @param path - The string of a URL path or of a route pattern
  */
 export declare function getIndexKey(path: string): string;
 /**
- * Merge the named-segment bucket and the wildcard bucket for a given index key,
- * preserving insertion order (by `order` field).
+ * Joins the bucket of the named segment and the wildcard bucket of one index key.
+ * The order of the insertion stays, through the `order` field.
  *
- * @param patternBuckets - Map of bucket key → ordered pattern entries
- * @param indexKey - First-segment key computed by `getIndexKey`
+ * @param patternBuckets - The map from a bucket key to its ordered pattern entries
+ * @param indexKey - The key of the first segment, from `getIndexKey`
  */
 export declare function getCandidates<T extends {
     order: number;

package/dist/url-pattern-utils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"url-pattern-utils.d.ts","sourceRoot":"","sources":["../src/url-pattern-utils.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH;;;GAGG;AACH,MAAM,MAAM,cAAc,GAAG;IAC5B,IAAI,CAAC,KAAK,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAA;KAAE,GAAG;QAClC,QAAQ,EAAE;YAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAA;SAAE,CAAC;KACzD,GAAG,IAAI,CAAC;IACT,IAAI,CAAC,KAAK,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC;CAC3C,CAAC;AAEF,qDAAqD;AACrD,MAAM,MAAM,cAAc,GAAG,KAAK,IAAI,EAAE;IAAE,QAAQ,EAAE,MAAM,CAAA;CAAE,KAAK,cAAc,CAAC;AAEhF;;;GAGG;AACH,wBAAgB,iBAAiB,IAAI,cAAc,GAAG,SAAS,CAE9D;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAE5D;AASD;;;;;;;;;;;;GAYG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAIxD;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,yBAAyB,CAAC,IAAI,EAAE,MAAM,GAAG,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAO3E;AAeD;;;;;;;;;;;;;GAaG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,cAAc,GAAG,cAAc,CAWxF;AAED;;;;;;;;GAQG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAMhD;AAED;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,CAAC,SAAS;IAAE,KAAK,EAAE,MAAM,CAAA;CAAE,EACxD,cAAc,EAAE,GAAG,CAAC,MAAM,EAAE,CAAC,EAAE,CAAC,EAChC,QAAQ,EAAE,MAAM,GACd,CAAC,EAAE,CA2BL"}
+{"version":3,"file":"url-pattern-utils.d.ts","sourceRoot":"","sources":["../src/url-pattern-utils.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH;;;;GAIG;AACH,MAAM,MAAM,cAAc,GAAG;IAC5B,IAAI,CAAC,KAAK,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAA;KAAE,GAAG;QAClC,QAAQ,EAAE;YAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAA;SAAE,CAAC;KACzD,GAAG,IAAI,CAAC;IACT,IAAI,CAAC,KAAK,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC;CAC3C,CAAC;AAEF,yDAAyD;AACzD,MAAM,MAAM,cAAc,GAAG,KAAK,IAAI,EAAE;IAAE,QAAQ,EAAE,MAAM,CAAA;CAAE,KAAK,cAAc,CAAC;AAEhF;;;GAGG;AACH,wBAAgB,iBAAiB,IAAI,cAAc,GAAG,SAAS,CAE9D;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAE5D;AASD;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAIxD;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,yBAAyB,CAAC,IAAI,EAAE,MAAM,GAAG,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAO3E;AAgBD;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,cAAc,GAAG,cAAc,CAWxF;AAED;;;;;;;;GAQG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAMhD;AAED;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,CAAC,SAAS;IAAE,KAAK,EAAE,MAAM,CAAA;CAAE,EACxD,cAAc,EAAE,GAAG,CAAC,MAAM,EAAE,CAAC,EAAE,CAAC,EAChC,QAAQ,EAAE,MAAM,GACd,CAAC,EAAE,CA2BL"}

package/dist/url-pattern-utils.js

@@ -1,56 +1,59 @@
 /**
- * Shared URLPattern utilities — internal module, NOT exported from index.ts
+ * The shared URLPattern utilities — an internal module. index.ts does not export it
  *
- * Provides the common URLPattern plumbing shared by:
+ * This module holds the common URLPattern work of four files:
  * - `create-route-map.ts`
  * - `base-route-map.ts`
  * - `find-route.ts`
  * - `router-bridge-base.ts`
  *
- * URLPattern is accessed via globalThis — consumers must load a polyfill on
- * environments without native support (Node < 24, older browsers).
+ * The module reads URLPattern from globalThis. A consumer must load a polyfill in an
+ * environment without the native API: Node < 24, and an older browser.
  *
  * @internal
  */
 /**
- * Retrieve the URLPattern constructor from `globalThis`, or `undefined` if
- * it is not available (Node < 24, older browsers without a polyfill).
+ * Returns the URLPattern constructor of `globalThis`, or `undefined` when it is
+ * absent: in Node < 24, and in an older browser without a polyfill.
  */
 export function getURLPatternCtor() {
     return globalThis["URLPattern"];
 }
 /**
- * Check whether a route path is a parameterized pattern rather than a concrete URL.
+ * Tells you if a route path is a parameterized pattern, and not a concrete URL.
  *
- * A pattern contains `:param` segments (required or optional) and/or the `*`
- * wildcard — both require URLPattern matching and carry no concrete values, so
- * they can never be pushed to a browser URL verbatim.
+ * A pattern holds a `:param` segment, which is necessary or optional, or the `*`
+ * wildcard, or both. Each of them needs a URLPattern match, and each of them carries
+ * no concrete value. Therefore the code can push such a path to a browser URL
+ * never.
  *
- * This is THE single source of truth for "is this path a pattern?" — used by
- * `RouteMap` to decide static-map vs pattern-bucket indexing and by
- * `RouterBridgeBase.resolveNavigationPath` to skip non-navigable routes, so the
- * two checks can never drift apart.
+ * This function is THE single source of truth of the question "is this path a
+ * pattern?". `RouteMap` uses it for its decision between the static map and the
+ * index of the pattern buckets, and `RouterBridgeBase.resolveNavigationPath` uses it
+ * to skip a route of no navigation. The two tests therefore cannot move apart.
  *
- * @param path - URL path or route pattern string (e.g. `/profile/:userId`, `/docs/*`)
- * @returns `true` if the path contains `:param` or `*` pattern syntax
+ * @param path - The string of a URL path or of a route pattern, for example `/profile/:userId` or `/docs/*`
+ * @returns `true` when the path holds a `:param` or a `*` pattern syntax
  */
 export function isParameterizedPattern(path) {
     return path.includes(":") || path.includes("*");
 }
 /**
- * Matches hyphenated `:param` names (e.g. `:cat-id`, `:page-num?`).
- * URLPattern requires parameter names to be valid JS identifiers, so hyphenated
- * names must be rewritten before compilation.
+ * The expression matches a `:param` name with a hyphen, for example `:cat-id` or
+ * `:page-num?`. URLPattern requires a valid JS identifier as a parameter name.
+ * Therefore the code must rewrite a name with a hyphen before the compilation.
  */
 const HYPHENATED_PARAM_RE = /:([A-Za-z][A-Za-z0-9]*(?:-[A-Za-z0-9]+)+)(\??)/g;
 /**
- * Normalize a route path so its parameter names are valid URLPattern identifiers.
+ * Normalizes a route path, so that each of its parameter names is a valid URLPattern
+ * identifier.
  *
- * URLPattern requires parameter names to be valid JS identifiers (no hyphens).
- * Hyphenated names like `:cat-id` are replaced with underscored equivalents
- * (`:cat_id`) for the URLPattern compilation step. Callers that need the captured
- * group values (not just a match test) must map the normalized group names back to
- * the original param names via {@link getNormalizedParamNameMap}.
+ * URLPattern requires a valid JS identifier as a parameter name, and such an
+ * identifier holds no hyphen. Therefore the function replaces a name with a hyphen,
+ * for example `:cat-id`, with the equivalent name with an underscore (`:cat_id`),
+ * for the compilation step of URLPattern. A caller that needs the values of the
+ * captured groups, and not a test of the match alone, must map each normalized group
+ * name back to the original param name with {@link getNormalizedParamNameMap}.
  *
  * @example
  * normalizeParamNames("/docs/:cat-id/:page-num?")
@@ -62,11 +65,11 @@ export function normalizeParamNames(path) {
     });
 }
 /**
- * Build a map from normalized URLPattern group names back to the original
- * (hyphenated) param names for a route pattern.
+ * Builds the map from each normalized URLPattern group name back to the original
+ * param name, which holds a hyphen, of a route pattern.
  *
- * Only params rewritten by {@link normalizeParamNames} appear in the map —
- * params that are already valid identifiers keep their own name and need no entry.
+ * The map holds only the params that {@link normalizeParamNames} rewrote. A param
+ * with a valid identifier keeps its own name, and it needs no entry.
  *
  * @example
  * getNormalizedParamNameMap("/docs/:cat-id/:plain")
@@ -81,30 +84,33 @@ export function getNormalizedParamNameMap(path) {
     return nameMap;
 }
 /**
- * Module-level cache of compiled URLPattern instances keyed by pattern string.
- *
- * Route patterns are compiled on every navigation-time lookup path
- * (`extractRouteParams`, `findRouteByPath`) and once per `RouteMap`
- * construction; compiling the same route pattern each time is wasted work.
- * Growth is bounded by the number of distinct route patterns in the
- * application's route maps. The cache is invalidated when the URLPattern
- * constructor changes (tests swap `globalThis.URLPattern`).
+ * The cache of the compiled URLPattern instances at the module level. The key is the
+ * string of the pattern.
+ *
+ * The code compiles a route pattern on every lookup path of a navigation
+ * (`extractRouteParams` and `findRouteByPath`), and also one time for each
+ * `RouteMap` construction. A new compilation of the same route pattern each time is
+ * lost work. The number of the different route patterns of the route maps of the
+ * application limits the growth of the cache. The cache goes away when the
+ * URLPattern constructor changes, and a test changes `globalThis.URLPattern`.
  */
 const compiledPatternCache = new Map();
 let compiledPatternCtor;
 /**
- * Compile a route pattern to a `URLPattern`, reusing the module-level cache.
+ * Compiles a route pattern into a `URLPattern`, and it uses the cache of the module
+ * level again.
  *
- * The pattern is normalized with {@link normalizeParamNames} before compilation
- * so hyphenated param names (`:cat-id`) become valid URLPattern identifiers
- * (`:cat_id`). Callers that extract group values must map the normalized names
- * back via {@link getNormalizedParamNameMap}.
+ * {@link normalizeParamNames} normalizes the pattern before the compilation. A param
+ * name with a hyphen (`:cat-id`) therefore becomes a valid URLPattern identifier
+ * (`:cat_id`). A caller that reads the values of the groups must map each normalized
+ * name back with {@link getNormalizedParamNameMap}.
  *
- * Compilation errors from the URLPattern constructor propagate as-is — callers
- * that need a typed error wrap this in `InvalidRoutePatternError`.
+ * An error of the compilation from the URLPattern constructor goes to the caller
+ * without a change. A caller that needs a typed error wraps this function in an
+ * `InvalidRoutePatternError`.
  *
- * @param pattern - Route pattern string (e.g. `/profile/:userId`)
- * @param Ctor - URLPattern constructor retrieved via {@link getURLPatternCtor}
+ * @param pattern - The string of the route pattern, for example `/profile/:userId`
+ * @param Ctor - The URLPattern constructor, from {@link getURLPatternCtor}
  */
 export function getCompiledPattern(pattern, Ctor) {
     if (Ctor !== compiledPatternCtor) {
@@ -119,13 +125,13 @@ export function getCompiledPattern(pattern, Ctor) {
     return compiled;
 }
 /**
- * Compute the bucket index key for a given path or pattern.
+ * Computes the key of the bucket index of a path or of a pattern.
  *
- * The key is the first path segment (e.g. `"settings"` for `"/settings/:id"`).
- * Parameterised first segments (`:lang`) fall into the `"*"` wildcard bucket.
- * The root path `"/"` maps to the key `"/"`.
+ * The key is the first path segment, for example `"settings"` of `"/settings/:id"`.
+ * A first segment with a parameter (`:lang`) goes into the `"*"` wildcard bucket.
+ * The root path `"/"` gives the key `"/"`.
  *
- * @param path - URL path or route pattern string
+ * @param path - The string of a URL path or of a route pattern
  */
 export function getIndexKey(path) {
     const trimmed = path.startsWith("/") ? path.slice(1) : path;
@@ -137,11 +143,11 @@ export function getIndexKey(path) {
     return segment;
 }
 /**
- * Merge the named-segment bucket and the wildcard bucket for a given index key,
- * preserving insertion order (by `order` field).
+ * Joins the bucket of the named segment and the wildcard bucket of one index key.
+ * The order of the insertion stays, through the `order` field.
  *
- * @param patternBuckets - Map of bucket key → ordered pattern entries
- * @param indexKey - First-segment key computed by `getIndexKey`
+ * @param patternBuckets - The map from a bucket key to its ordered pattern entries
+ * @param indexKey - The key of the first segment, from `getIndexKey`
  */
 export function getCandidates(patternBuckets, indexKey) {
     const bucket = patternBuckets.get(indexKey) ?? [];

package/dist/url-pattern-utils.js.map

@@ -1 +1 @@
-{"version":3,"file":"url-pattern-utils.js","sourceRoot":"","sources":["../src/url-pattern-utils.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"url-pattern-utils.js","sourceRoot":"","sources":["../src/url-pattern-utils.ts"],"names":[],"mappings":"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"}

package/dist/validate-routes.d.ts

@@ -1,57 +1,58 @@
 /**
- * A route entry with its RESOLVED full path — the path after relative routes have
- * been prefixed with their parent's full path during tree construction.
+ * A route entry with its RESOLVED complete path, which is the path after the tree
+ * construction put the path of the parent before each relative route.
  *
  * `RouteNode` satisfies this shape structurally.
  */
 export interface ResolvedRoutePath {
-    /** State identifier owning the route (e.g. `"app.dashboard.settings"`). */
+    /** The identifier of the state that owns the route, for example `"app.dashboard.settings"`. */
     stateId: string;
-    /** Resolved absolute route path (e.g. `"/dashboard/settings"`). */
+    /** The resolved absolute route path, for example `"/dashboard/settings"`. */
     fullPath: string;
 }
 /**
- * Validate route path format
+ * Checks the format of a route path
  *
- * Ensures route paths are non-empty strings. Both absolute paths ("/foo")
- * and relative paths ("foo", "child/nested") are accepted. Relative routes
- * inherit their parent state's path prefix when the tree is built.
+ * The function requires a string that is not empty. It accepts an absolute path
+ * ("/foo") and also a relative path ("foo" or "child/nested"). A relative route
+ * receives the path prefix of its parent state during the construction of the tree.
  *
- * @param routePath - Route path to validate (absolute or relative)
- * @param stateId - State identifier for error messages
- * @throws {EmptyRoutePathError} If route path is empty
+ * @param routePath - The route path to check: absolute or relative
+ * @param stateId - The identifier of the state, for the error message
+ * @throws {EmptyRoutePathError} When the route path is empty
  */
 export declare const validateRouteFormat: (routePath: string, stateId: string) => void;
 /**
- * Validate state exists in state ID set
+ * Checks that the set of the state IDs holds a state
  *
- * Ensures referenced state IDs exist in the machine graph.
- * Build-time validation prevents broken route references.
+ * The function requires each state ID of a reference in the machine graph. This
+ * check at the build time therefore stops a broken route reference.
  *
- * @param stateId - State identifier to validate
- * @param stateIds - Set of all known state IDs from the machine graph
- * @throws {InvalidStateIdError} If state ID doesn't exist in set
+ * @param stateId - The identifier of the state to check
+ * @param stateIds - The set of every known state ID of the machine graph
+ * @throws {InvalidStateIdError} When the set does not hold the state ID
  */
 export declare const validateStateExists: (stateId: string, stateIds: Set<string>) => void;
 /**
- * Detect duplicate route paths
+ * Finds each duplicate route path
  *
- * THROWS ERROR when multiple states share the same RESOLVED full path.
+ * The function THROWS AN ERROR when more than one state holds the same RESOLVED
+ * complete path.
  *
- * Detection operates on resolved full paths (after relative routes have been
- * prefixed with their parent's path in `buildRouteTree`), not on raw route
- * strings: two relative `"settings"` routes under different parents resolve to
- * distinct full paths and are valid, while a relative route and an absolute
- * route resolving to the same URL genuinely collide and must be rejected.
- * Called from `buildRouteTree` once full paths are known.
+ * The detection works on the resolved complete paths, after `buildRouteTree` put the
+ * path of each parent before its relative routes. It does not work on the raw route
+ * strings: two relative `"settings"` routes below two different parents resolve to
+ * two different complete paths, and they are valid; a relative route and an absolute
+ * route that resolve to the same URL are a real collision, and the function refuses
+ * them. `buildRouteTree` calls this function when the complete paths are known.
  *
- * Rationale: URL-based routing requires one-to-one mapping between URLs and states.
- * Multiple states at the same path creates ambiguity for browser navigation (back button,
- * direct URL access). Use different paths for different states, or single state with
- * conditional rendering.
+ * The reason: a routing on the URL requires one state for each URL. Two states at
+ * the same path make the browser navigation ambiguous, for the BACK button and for a
+ * direct URL. Use a different path for each state, or use one state with a
+ * conditional render.
  *
- * @param routes - Array of route entries with resolved full paths (e.g. `RouteNode`s)
- * @throws {DuplicateRoutePathError} If duplicate resolved route paths are detected
+ * @param routes - The array of the route entries with their resolved complete paths, for example the `RouteNode` objects
+ * @throws {DuplicateRoutePathError} When the function finds two resolved route paths that are equal
  */
 export declare const detectDuplicateRoutes: (routes: ResolvedRoutePath[]) => void;
 //# sourceMappingURL=validate-routes.d.ts.map

package/dist/validate-routes.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"validate-routes.d.ts","sourceRoot":"","sources":["../src/validate-routes.ts"],"names":[],"mappings":"AAEA;;;;;GAKG;AACH,MAAM,WAAW,iBAAiB;IACjC,2EAA2E;IAC3E,OAAO,EAAE,MAAM,CAAC;IAChB,mEAAmE;IACnE,QAAQ,EAAE,MAAM,CAAC;CACjB;AAED;;;;;;;;;;GAUG;AACH,eAAO,MAAM,mBAAmB,GAAI,WAAW,MAAM,EAAE,SAAS,MAAM,KAAG,IAIxE,CAAC;AAEF;;;;;;;;;GASG;AACH,eAAO,MAAM,mBAAmB,GAAI,SAAS,MAAM,EAAE,UAAU,GAAG,CAAC,MAAM,CAAC,KAAG,IAI5E,CAAC;AAEF;;;;;;;;;;;;;;;;;;;GAmBG;AACH,eAAO,MAAM,qBAAqB,GAAI,QAAQ,iBAAiB,EAAE,KAAG,IAqBnE,CAAC"}
+{"version":3,"file":"validate-routes.d.ts","sourceRoot":"","sources":["../src/validate-routes.ts"],"names":[],"mappings":"AAEA;;;;;GAKG;AACH,MAAM,WAAW,iBAAiB;IACjC,+FAA+F;IAC/F,OAAO,EAAE,MAAM,CAAC;IAChB,6EAA6E;IAC7E,QAAQ,EAAE,MAAM,CAAC;CACjB;AAED;;;;;;;;;;GAUG;AACH,eAAO,MAAM,mBAAmB,GAAI,WAAW,MAAM,EAAE,SAAS,MAAM,KAAG,IAIxE,CAAC;AAEF;;;;;;;;;GASG;AACH,eAAO,MAAM,mBAAmB,GAAI,SAAS,MAAM,EAAE,UAAU,GAAG,CAAC,MAAM,CAAC,KAAG,IAI5E,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,eAAO,MAAM,qBAAqB,GAAI,QAAQ,iBAAiB,EAAE,KAAG,IAqBnE,CAAC"}

package/dist/validate-routes.js

@@ -1,14 +1,14 @@
 import { EmptyRoutePathError, InvalidStateIdError, DuplicateRoutePathError } from "./errors.js";
 /**
- * Validate route path format
+ * Checks the format of a route path
  *
- * Ensures route paths are non-empty strings. Both absolute paths ("/foo")
- * and relative paths ("foo", "child/nested") are accepted. Relative routes
- * inherit their parent state's path prefix when the tree is built.
+ * The function requires a string that is not empty. It accepts an absolute path
+ * ("/foo") and also a relative path ("foo" or "child/nested"). A relative route
+ * receives the path prefix of its parent state during the construction of the tree.
  *
- * @param routePath - Route path to validate (absolute or relative)
- * @param stateId - State identifier for error messages
- * @throws {EmptyRoutePathError} If route path is empty
+ * @param routePath - The route path to check: absolute or relative
+ * @param stateId - The identifier of the state, for the error message
+ * @throws {EmptyRoutePathError} When the route path is empty
  */
 export const validateRouteFormat = (routePath, stateId) => {
     if (!routePath) {
@@ -16,14 +16,14 @@ export const validateRouteFormat = (routePath, stateId) => {
     }
 };
 /**
- * Validate state exists in state ID set
+ * Checks that the set of the state IDs holds a state
  *
- * Ensures referenced state IDs exist in the machine graph.
- * Build-time validation prevents broken route references.
+ * The function requires each state ID of a reference in the machine graph. This
+ * check at the build time therefore stops a broken route reference.
  *
- * @param stateId - State identifier to validate
- * @param stateIds - Set of all known state IDs from the machine graph
- * @throws {InvalidStateIdError} If state ID doesn't exist in set
+ * @param stateId - The identifier of the state to check
+ * @param stateIds - The set of every known state ID of the machine graph
+ * @throws {InvalidStateIdError} When the set does not hold the state ID
  */
 export const validateStateExists = (stateId, stateIds) => {
     if (!stateIds.has(stateId)) {
@@ -31,34 +31,35 @@ export const validateStateExists = (stateId, stateIds) => {
     }
 };
 /**
- * Detect duplicate route paths
+ * Finds each duplicate route path
  *
- * THROWS ERROR when multiple states share the same RESOLVED full path.
+ * The function THROWS AN ERROR when more than one state holds the same RESOLVED
+ * complete path.
  *
- * Detection operates on resolved full paths (after relative routes have been
- * prefixed with their parent's path in `buildRouteTree`), not on raw route
- * strings: two relative `"settings"` routes under different parents resolve to
- * distinct full paths and are valid, while a relative route and an absolute
- * route resolving to the same URL genuinely collide and must be rejected.
- * Called from `buildRouteTree` once full paths are known.
+ * The detection works on the resolved complete paths, after `buildRouteTree` put the
+ * path of each parent before its relative routes. It does not work on the raw route
+ * strings: two relative `"settings"` routes below two different parents resolve to
+ * two different complete paths, and they are valid; a relative route and an absolute
+ * route that resolve to the same URL are a real collision, and the function refuses
+ * them. `buildRouteTree` calls this function when the complete paths are known.
  *
- * Rationale: URL-based routing requires one-to-one mapping between URLs and states.
- * Multiple states at the same path creates ambiguity for browser navigation (back button,
- * direct URL access). Use different paths for different states, or single state with
- * conditional rendering.
+ * The reason: a routing on the URL requires one state for each URL. Two states at
+ * the same path make the browser navigation ambiguous, for the BACK button and for a
+ * direct URL. Use a different path for each state, or use one state with a
+ * conditional render.
  *
- * @param routes - Array of route entries with resolved full paths (e.g. `RouteNode`s)
- * @throws {DuplicateRoutePathError} If duplicate resolved route paths are detected
+ * @param routes - The array of the route entries with their resolved complete paths, for example the `RouteNode` objects
+ * @throws {DuplicateRoutePathError} When the function finds two resolved route paths that are equal
  */
 export const detectDuplicateRoutes = (routes) => {
     const routeMap = new Map();
-    // Build map of resolved full paths to state IDs
+    // Build the map from each resolved complete path to its state IDs
     for (const route of routes) {
         const stateIds = routeMap.get(route.fullPath) || [];
         stateIds.push(route.stateId);
         routeMap.set(route.fullPath, stateIds);
     }
-    // Check for duplicates and throw error
+    // Find each duplicate, and throw an error
     const duplicates = [];
     for (const [routePath, stateIds] of routeMap.entries()) {
         if (stateIds.length > 1) {

package/dist/validate-routes.js.map

@@ -1 +1 @@
-{"version":3,"file":"validate-routes.js","sourceRoot":"","sources":["../src/validate-routes.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,mBAAmB,EAAE,uBAAuB,EAAE,MAAM,aAAa,CAAC;AAehG;;;;;;;;;;GAUG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,SAAiB,EAAE,OAAe,EAAQ,EAAE;IAC/E,IAAI,CAAC,SAAS,EAAE,CAAC;QAChB,MAAM,IAAI,mBAAmB,CAAC,OAAO,CAAC,CAAC;IACxC,CAAC;AACF,CAAC,CAAC;AAEF;;;;;;;;;GASG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,OAAe,EAAE,QAAqB,EAAQ,EAAE;IACnF,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC;QAC5B,MAAM,IAAI,mBAAmB,CAAC,OAAO,CAAC,CAAC;IACxC,CAAC;AACF,CAAC,CAAC;AAEF;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,MAA2B,EAAQ,EAAE;IAC1E,MAAM,QAAQ,GAAG,IAAI,GAAG,EAAoB,CAAC;IAE7C,gDAAgD;IAChD,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAC5B,MAAM,QAAQ,GAAG,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC;QACpD,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QAC7B,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;IACxC,CAAC;IAED,uCAAuC;IACvC,MAAM,UAAU,GAAa,EAAE,CAAC;IAChC,KAAK,MAAM,CAAC,SAAS,EAAE,QAAQ,CAAC,IAAI,QAAQ,CAAC,OAAO,EAAE,EAAE,CAAC;QACxD,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACzB,UAAU,CAAC,IAAI,CAAC,KAAK,SAAS,MAAM,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAC7D,CAAC;IACF,CAAC;IAED,IAAI,UAAU,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC3B,MAAM,IAAI,uBAAuB,CAAC,UAAU,CAAC,CAAC;IAC/C,CAAC;AACF,CAAC,CAAC"}
+{"version":3,"file":"validate-routes.js","sourceRoot":"","sources":["../src/validate-routes.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,mBAAmB,EAAE,uBAAuB,EAAE,MAAM,aAAa,CAAC;AAehG;;;;;;;;;;GAUG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,SAAiB,EAAE,OAAe,EAAQ,EAAE;IAC/E,IAAI,CAAC,SAAS,EAAE,CAAC;QAChB,MAAM,IAAI,mBAAmB,CAAC,OAAO,CAAC,CAAC;IACxC,CAAC;AACF,CAAC,CAAC;AAEF;;;;;;;;;GASG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,OAAe,EAAE,QAAqB,EAAQ,EAAE;IACnF,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC;QAC5B,MAAM,IAAI,mBAAmB,CAAC,OAAO,CAAC,CAAC;IACxC,CAAC;AACF,CAAC,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,MAA2B,EAAQ,EAAE;IAC1E,MAAM,QAAQ,GAAG,IAAI,GAAG,EAAoB,CAAC;IAE7C,kEAAkE;IAClE,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAC5B,MAAM,QAAQ,GAAG,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC;QACpD,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QAC7B,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;IACxC,CAAC;IAED,0CAA0C;IAC1C,MAAM,UAAU,GAAa,EAAE,CAAC;IAChC,KAAK,MAAM,CAAC,SAAS,EAAE,QAAQ,CAAC,IAAI,QAAQ,CAAC,OAAO,EAAE,EAAE,CAAC;QACxD,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACzB,UAAU,CAAC,IAAI,CAAC,KAAK,SAAS,MAAM,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAC7D,CAAC;IACF,CAAC;IAED,IAAI,UAAU,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC3B,MAAM,IAAI,uBAAuB,CAAC,UAAU,CAAC,CAAC;IAC/C,CAAC;AACF,CAAC,CAAC"}