@xmachines/play-router 2.0.0 → 2.1.0

package/dist/find-route.js

@@ -1,26 +1,27 @@
 import { getURLPatternCtor, getCompiledPattern } from "./url-pattern-utils.js";
 import { URLPatternUnavailableError, InvalidRoutePatternError } from "./errors.js";
 /**
- * Check if a URL path matches a route pattern using URLPattern.
+ * Tells you if a URL path matches a route pattern, with URLPattern.
  *
- * For static patterns (no `:param`) falls back to a direct equality check so
- * URLPattern is never required for polyfill-free environments that only use
- * static routes.
+ * For a static pattern, which holds no `:param`, the function makes a direct
+ * equality test. Therefore an environment with static routes only needs URLPattern
+ * never, and it needs no polyfill.
  *
- * Uses the shared module-level compiled-pattern cache (`getCompiledPattern`)
- * so repeated lookups never recompile the same pattern, and hyphenated param
- * names (`:cat-id`) are normalized exactly as `RouteMap` does — the same single
- * matching engine underneath.
+ * The function uses the compiled-pattern cache of the module level
+ * (`getCompiledPattern`). A repeated lookup therefore compiles the same pattern
+ * never again. The cache also normalizes a param name with a hyphen (`:cat-id`)
+ * exactly like `RouteMap`: one match engine is below both.
  *
- * Throws `URLPatternUnavailableError` when a parameterised pattern is tested
- * and URLPattern is not available on `globalThis`.
- * Throws `InvalidRoutePatternError` when URLPattern cannot compile the pattern.
+ * The function throws a `URLPatternUnavailableError` when it tests a parameterized
+ * pattern and `globalThis` holds no URLPattern.
+ * It throws an `InvalidRoutePatternError` when URLPattern cannot compile the
+ * pattern.
  *
- * Private — not exported from the package public API.
+ * This function is private. The public API of the package does not export it.
  *
- * @param path - URL path (e.g., '/settings', '/settings/billing')
- * @param pattern - Route pattern (e.g., '/settings/:section?')
- * @returns True if path matches pattern
+ * @param path - The URL path, for example '/settings' or '/settings/billing'
+ * @param pattern - The route pattern, for example '/settings/:section?'
+ * @returns True when the path matches the pattern
  */
 function matchesPattern(path, pattern) {
     if (!pattern.includes(":"))
@@ -36,14 +37,15 @@ function matchesPattern(path, pattern) {
     }
 }
 /**
- * Find route node by state ID
+ * Finds a route node by its state ID
  *
- * Looks up route node using the state's ID property. Used to get URL path
- * from state ID for browser URL sync after play.route transitions.
+ * The function looks the route node up by the ID property of the state. It gives you
+ * the URL path of a state ID, for the update of the browser URL after a `play.route`
+ * transition.
  *
- * @param tree - Route tree from extractMachineRoutes
- * @param id - State ID (e.g., 'dashboard', 'settings.profile')
- * @returns Route node if found, undefined otherwise
+ * @param tree - The route tree, from extractMachineRoutes
+ * @param id - The state ID, for example 'dashboard' or 'settings.profile'
+ * @returns The route node, or undefined when the function finds none
  *
  * @example
  * ```typescript
@@ -58,19 +60,21 @@ export const findRouteById = (tree, id) => {
     return tree.byStateId.get(id);
 };
 /**
- * Find route node by URL path
+ * Finds a route node by its URL path
  *
- * Looks up route node using the URL path. Used to get state ID from browser
- * URL for sending play.route events on navigation.
+ * The function looks the route node up by the URL path. It gives you the state ID of
+ * a browser URL, for the `play.route` event of a navigation.
  *
- * When multiple states share the same path (e.g., root and a state both at "/"),
- * prefers routable nodes (with meta.route) over non-routable nodes.
+ * When more than one state holds the same path, for example the root and a second
+ * state both at "/", the function prefers a node with a route, which means a node
+ * with a `meta.route` field, over a node without one.
  *
- * Supports pattern matching for dynamic routes (e.g., '/settings/:section?').
+ * The function also matches a pattern of a dynamic route, for example
+ * '/settings/:section?'.
  *
- * @param tree - Route tree from extractMachineRoutes
- * @param path - URL path (e.g., '/dashboard', '/settings/profile')
- * @returns Route node if found, undefined otherwise
+ * @param tree - The route tree, from extractMachineRoutes
+ * @param path - The URL path, for example '/dashboard' or '/settings/profile'
+ * @returns The route node, or undefined when the function finds none
  *
  * @example
  * ```typescript
@@ -79,25 +83,25 @@ export const findRouteById = (tree, id) => {
  * ```
  */
 export const findRouteByPath = (tree, path) => {
-    // 1. Try exact match first (fast path for static routes)
+    // 1. Try the exact match first. This is the fast path of a static route
     const node = tree.byPath.get(path);
     if (node?.routable) {
         return node;
     }
-    // 2. If exact match not found or non-routable, try pattern matching
-    // This handles:
-    // - Routes with parameters (e.g., '/settings/:section?')
-    // - Multiple states sharing same path (prefer routable)
+    // 2. Without an exact match, and for a node without a route, try the pattern match.
+    // This handles three cases:
+    // - a route with a parameter, for example '/settings/:section?'
+    // - more than one state at the same path, where a state with a route wins
     for (const candidate of tree.byStateId.values()) {
         if (!candidate.routable) {
-            continue; // Skip non-routable nodes
+            continue; // Skip each node without a route
         }
-        // Check if path matches this node's pattern
+        // Test the path against the pattern of this node
         if (matchesPattern(path, candidate.fullPath)) {
             return candidate;
         }
     }
-    // 3. Fallback: if we had a non-routable exact match, return it
+    // 3. The fallback: return the exact match of a node without a route, when one is present
     return node;
 };
 //# sourceMappingURL=find-route.js.map

package/dist/find-route.js.map

@@ -1 +1 @@
-{"version":3,"file":"find-route.js","sourceRoot":"","sources":["../src/find-route.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAC/E,OAAO,EAAE,0BAA0B,EAAE,wBAAwB,EAAE,MAAM,aAAa,CAAC;AAEnF;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,SAAS,cAAc,CAAC,IAAY,EAAE,OAAe;IACpD,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC;QAAE,OAAO,IAAI,KAAK,OAAO,CAAC;IACpD,MAAM,IAAI,GAAG,iBAAiB,EAAE,CAAC;IACjC,IAAI,CAAC,IAAI;QAAE,MAAM,IAAI,0BAA0B,EAAE,CAAC;IAClD,IAAI,CAAC;QACJ,OAAO,kBAAkB,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC,IAAI,CAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC;IACnE,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACd,MAAM,IAAI,wBAAwB,CAAC,OAAO,EAAE,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC,CAAC;IAC7D,CAAC;AACF,CAAC;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,IAAe,EAAE,EAAU,EAAyB,EAAE;IACnF,OAAO,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;AAC/B,CAAC,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,IAAe,EAAE,IAAY,EAAyB,EAAE;IACvF,yDAAyD;IACzD,MAAM,IAAI,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAEnC,IAAI,IAAI,EAAE,QAAQ,EAAE,CAAC;QACpB,OAAO,IAAI,CAAC;IACb,CAAC;IAED,oEAAoE;IACpE,gBAAgB;IAChB,yDAAyD;IACzD,wDAAwD;IACxD,KAAK,MAAM,SAAS,IAAI,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,EAAE,CAAC;QACjD,IAAI,CAAC,SAAS,CAAC,QAAQ,EAAE,CAAC;YACzB,SAAS,CAAC,0BAA0B;QACrC,CAAC;QAED,4CAA4C;QAC5C,IAAI,cAAc,CAAC,IAAI,EAAE,SAAS,CAAC,QAAQ,CAAC,EAAE,CAAC;YAC9C,OAAO,SAAS,CAAC;QAClB,CAAC;IACF,CAAC;IAED,+DAA+D;IAC/D,OAAO,IAAI,CAAC;AACb,CAAC,CAAC"}
+{"version":3,"file":"find-route.js","sourceRoot":"","sources":["../src/find-route.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAC/E,OAAO,EAAE,0BAA0B,EAAE,wBAAwB,EAAE,MAAM,aAAa,CAAC;AAEnF;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,SAAS,cAAc,CAAC,IAAY,EAAE,OAAe;IACpD,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC;QAAE,OAAO,IAAI,KAAK,OAAO,CAAC;IACpD,MAAM,IAAI,GAAG,iBAAiB,EAAE,CAAC;IACjC,IAAI,CAAC,IAAI;QAAE,MAAM,IAAI,0BAA0B,EAAE,CAAC;IAClD,IAAI,CAAC;QACJ,OAAO,kBAAkB,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC,IAAI,CAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC;IACnE,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACd,MAAM,IAAI,wBAAwB,CAAC,OAAO,EAAE,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC,CAAC;IAC7D,CAAC;AACF,CAAC;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,IAAe,EAAE,EAAU,EAAyB,EAAE;IACnF,OAAO,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;AAC/B,CAAC,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,IAAe,EAAE,IAAY,EAAyB,EAAE;IACvF,wEAAwE;IACxE,MAAM,IAAI,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAEnC,IAAI,IAAI,EAAE,QAAQ,EAAE,CAAC;QACpB,OAAO,IAAI,CAAC;IACb,CAAC;IAED,oFAAoF;IACpF,4BAA4B;IAC5B,gEAAgE;IAChE,0EAA0E;IAC1E,KAAK,MAAM,SAAS,IAAI,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,EAAE,CAAC;QACjD,IAAI,CAAC,SAAS,CAAC,QAAQ,EAAE,CAAC;YACzB,SAAS,CAAC,iCAAiC;QAC5C,CAAC;QAED,iDAAiD;QACjD,IAAI,cAAc,CAAC,IAAI,EAAE,SAAS,CAAC,QAAQ,CAAC,EAAE,CAAC;YAC9C,OAAO,SAAS,CAAC;QAClB,CAAC;IACF,CAAC;IAED,yFAAyF;IACzF,OAAO,IAAI,CAAC;AACb,CAAC,CAAC"}

package/dist/index.d.ts

@@ -1,3 +1,4 @@
+import type { RouteMapping } from "./base-route-map.js";
 export { RouterBridgeBase } from "./router-bridge-base.js";
 export type { RouteWatcherHandle } from "./router-bridge-base.js";
 export { sanitizePathname, buildPlayRouteEvent, extractQuery, extractRouteParams, } from "./router-sync.js";
@@ -10,7 +11,11 @@ export { getNavigableRoutes, getRoutableRoutes, routeExists, getTransitionReacha
 export { machineToGraph } from "./machine-to-graph.js";
 export type { MachineGraph } from "./machine-to-graph.js";
 export type { RouteInfo, RouteNode, RouteTree, RouteObject, RouteMetadata, PlayRouteEvent, RoutableActor, PlayActor, RouterBridge, MachineNodeData, MachineEdgeData, WindowLike, LocationLike, } from "./types.js";
-export { RouteMap, type RouteMapping, type RouteMapping as BaseRouteMapping, } from "./base-route-map.js";
+export { RouteMap, type RouteMapping } from "./base-route-map.js";
+/**
+ * @deprecated Use {@link RouteMapping}. Will be removed in the next major.
+ */
+export type BaseRouteMapping = RouteMapping;
 export { createRouteMap } from "./create-route-map.js";
 export type { RouteMapOptions } from "./create-route-map.js";
 export { createRouteMapFromTree } from "./create-route-map-from-tree.js";

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAC3D,YAAY,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAGlE,OAAO,EACN,gBAAgB,EAChB,mBAAmB,EACnB,YAAY,EACZ,kBAAkB,GAClB,MAAM,kBAAkB,CAAC;AAC1B,YAAY,EAAE,UAAU,EAAE,0BAA0B,EAAE,MAAM,kBAAkB,CAAC;AAG/E,OAAO,EACN,mBAAmB,EACnB,mBAAmB,EACnB,qBAAqB,GACrB,MAAM,sBAAsB,CAAC;AAC9B,YAAY,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAC9D,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AACjD,OAAO,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAC3D,OAAO,EACN,kBAAkB,EAClB,iBAAiB,EACjB,WAAW,EACX,4BAA4B,EAC5B,gBAAgB,GAChB,MAAM,YAAY,CAAC;AAGpB,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,YAAY,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAE1D,YAAY,EACX,SAAS,EACT,SAAS,EACT,SAAS,EACT,WAAW,EACX,aAAa,EACb,cAAc,EACd,aAAa,EACb,SAAS,EACT,YAAY,EACZ,eAAe,EACf,eAAe,EACf,UAAU,EACV,YAAY,GACZ,MAAM,YAAY,CAAC;AAIpB,OAAO,EACN,QAAQ,EACR,KAAK,YAAY,EACjB,KAAK,YAAY,IAAI,gBAAgB,GACrC,MAAM,qBAAqB,CAAC;AAI7B,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,YAAY,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAC7D,OAAO,EAAE,sBAAsB,EAAE,MAAM,iCAAiC,CAAC;AAGzE,OAAO,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAGxD,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAC3D,YAAY,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAGlE,OAAO,EACN,gBAAgB,EAChB,mBAAmB,EACnB,YAAY,EACZ,kBAAkB,GAClB,MAAM,kBAAkB,CAAC;AAC1B,YAAY,EAAE,UAAU,EAAE,0BAA0B,EAAE,MAAM,kBAAkB,CAAC;AAG/E,OAAO,EACN,mBAAmB,EACnB,mBAAmB,EACnB,qBAAqB,GACrB,MAAM,sBAAsB,CAAC;AAC9B,YAAY,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAC9D,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AACjD,OAAO,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAC3D,OAAO,EACN,kBAAkB,EAClB,iBAAiB,EACjB,WAAW,EACX,4BAA4B,EAC5B,gBAAgB,GAChB,MAAM,YAAY,CAAC;AAGpB,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,YAAY,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAE1D,YAAY,EACX,SAAS,EACT,SAAS,EACT,SAAS,EACT,WAAW,EACX,aAAa,EACb,cAAc,EACd,aAAa,EACb,SAAS,EACT,YAAY,EACZ,eAAe,EACf,eAAe,EACf,UAAU,EACV,YAAY,GACZ,MAAM,YAAY,CAAC;AAKpB,OAAO,EAAE,QAAQ,EAAE,KAAK,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAElE;;GAEG;AACH,MAAM,MAAM,gBAAgB,GAAG,YAAY,CAAC;AAI5C,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,YAAY,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAC7D,OAAO,EAAE,sBAAsB,EAAE,MAAM,iCAAiC,CAAC;AAGzE,OAAO,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/index.js

@@ -1,21 +1,22 @@
-// RouterBridgeBase — public API for community adapters
+// RouterBridgeBase — the public API of an adapter of the community
 export { RouterBridgeBase } from "./router-bridge-base.js";
-// Router sync utilities — used by play-dom-router and adapters that bypass syncActorFromRouter()
+// The router sync utilities — play-dom-router uses them, and also each adapter that passes around syncActorFromRouter()
 export { sanitizePathname, buildPlayRouteEvent, extractQuery, extractRouteParams, } from "./router-sync.js";
-// Route utilities (existing)
+// The route utilities
 export { validateRouteFormat, validateStateExists, detectDuplicateRoutes, } from "./validate-routes.js";
 export { buildRouteTree } from "./build-tree.js";
 export { extractMachineRoutes } from "./extract-routes.js";
 export { getNavigableRoutes, getRoutableRoutes, routeExists, getTransitionReachableRoutes, isRouteReachable, } from "./query.js";
-// Graph adapter — converts XState machines to @statelyai/graph Graph
+// The graph adapter — it converts an XState machine into a Graph of @statelyai/graph
 export { machineToGraph } from "./machine-to-graph.js";
-// Shared bidirectional route mapping base class.
-// RouteMapping is exported directly; BaseRouteMapping kept as alias for compatibility.
-export { RouteMap, } from "./base-route-map.js";
-// Factories: create a RouteMap from a machine or a route tree.
-// All RouterBridgeBase adapters use these instead of rolling their own factories.
+// The shared base class of the route map for both directions.
+// This module exports RouteMapping directly. BaseRouteMapping stays as an alias, for
+// the compatibility.
+export { RouteMap } from "./base-route-map.js";
+// The factories: each one creates a RouteMap from a machine or from a route tree.
+// Every RouterBridgeBase adapter uses them, and it writes no factory of its own.
 export { createRouteMap } from "./create-route-map.js";
 export { createRouteMapFromTree } from "./create-route-map-from-tree.js";
-// Route lookup helpers — matchesPattern is private within find-route.ts
+// The helpers of a route lookup. matchesPattern stays private inside find-route.ts
 export { findRouteById, findRouteByPath } from "./find-route.js";
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,uDAAuD;AACvD,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAG3D,iGAAiG;AACjG,OAAO,EACN,gBAAgB,EAChB,mBAAmB,EACnB,YAAY,EACZ,kBAAkB,GAClB,MAAM,kBAAkB,CAAC;AAG1B,6BAA6B;AAC7B,OAAO,EACN,mBAAmB,EACnB,mBAAmB,EACnB,qBAAqB,GACrB,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AACjD,OAAO,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAC3D,OAAO,EACN,kBAAkB,EAClB,iBAAiB,EACjB,WAAW,EACX,4BAA4B,EAC5B,gBAAgB,GAChB,MAAM,YAAY,CAAC;AAEpB,qEAAqE;AACrE,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAmBvD,iDAAiD;AACjD,uFAAuF;AACvF,OAAO,EACN,QAAQ,GAGR,MAAM,qBAAqB,CAAC;AAE7B,+DAA+D;AAC/D,kFAAkF;AAClF,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAEvD,OAAO,EAAE,sBAAsB,EAAE,MAAM,iCAAiC,CAAC;AAEzE,wEAAwE;AACxE,OAAO,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAEA,mEAAmE;AACnE,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAG3D,wHAAwH;AACxH,OAAO,EACN,gBAAgB,EAChB,mBAAmB,EACnB,YAAY,EACZ,kBAAkB,GAClB,MAAM,kBAAkB,CAAC;AAG1B,sBAAsB;AACtB,OAAO,EACN,mBAAmB,EACnB,mBAAmB,EACnB,qBAAqB,GACrB,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AACjD,OAAO,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAC3D,OAAO,EACN,kBAAkB,EAClB,iBAAiB,EACjB,WAAW,EACX,4BAA4B,EAC5B,gBAAgB,GAChB,MAAM,YAAY,CAAC;AAEpB,qFAAqF;AACrF,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAmBvD,8DAA8D;AAC9D,qFAAqF;AACrF,qBAAqB;AACrB,OAAO,EAAE,QAAQ,EAAqB,MAAM,qBAAqB,CAAC;AAOlE,kFAAkF;AAClF,iFAAiF;AACjF,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAEvD,OAAO,EAAE,sBAAsB,EAAE,MAAM,iCAAiC,CAAC;AAEzE,mFAAmF;AACnF,OAAO,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/machine-to-graph.d.ts

@@ -2,8 +2,9 @@ import type { AnyStateMachine } from "xstate";
 import { type Graph } from "@statelyai/graph";
 import type { MachineNodeData, MachineEdgeData } from "./types.js";
 /**
- * Typed @statelyai/graph Graph representing a state machine.
- * Provides hierarchy queries, traversal algorithms, and reachability checks.
+ * The typed Graph of @statelyai/graph that represents a state machine.
+ * It gives you the queries of the hierarchy, the algorithms of a walk, and the tests
+ * of the reachability.
  *
  * @example
  * ```typescript

package/dist/machine-to-graph.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"machine-to-graph.d.ts","sourceRoot":"","sources":["../src/machine-to-graph.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,QAAQ,CAAC;AAE9C,OAAO,EAAe,KAAK,KAAK,EAAE,MAAM,kBAAkB,CAAC;AAC3D,OAAO,KAAK,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAGnE;;;;;;;;;;GAUG;AACH,MAAM,MAAM,YAAY,GAAG,KAAK,CAAC,eAAe,EAAE,eAAe,CAAC,CAAC;AAqDnE,eAAO,MAAM,cAAc,GAAI,SAAS,eAAe,KAAG,YAwEzD,CAAC"}
+{"version":3,"file":"machine-to-graph.d.ts","sourceRoot":"","sources":["../src/machine-to-graph.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,QAAQ,CAAC;AAE9C,OAAO,EAAe,KAAK,KAAK,EAAE,MAAM,kBAAkB,CAAC;AAC3D,OAAO,KAAK,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAGnE;;;;;;;;;;;GAWG;AACH,MAAM,MAAM,YAAY,GAAG,KAAK,CAAC,eAAe,EAAE,eAAe,CAAC,CAAC;AAsDnE,eAAO,MAAM,cAAc,GAAI,SAAS,eAAe,KAAG,YAwEzD,CAAC"}

package/dist/machine-to-graph.js

@@ -2,21 +2,21 @@ import { toDirectedGraph } from "xstate/graph";
 import { createGraph } from "@statelyai/graph";
 import { UnknownStateTypeError } from "./errors.js";
 /**
- * Convert an XState v5 state machine to a typed @statelyai/graph Graph.
+ * Converts an XState v5 state machine into a typed Graph of @statelyai/graph.
  *
- * The conversion pipeline is:
- * `XState Machine → toDirectedGraph() → DirectedGraphNode hierarchy → createGraph() → Graph`
+ * The pipeline of the conversion is:
+ * `XState Machine → toDirectedGraph() → the hierarchy of the DirectedGraphNode objects → createGraph() → Graph`
  *
- * The resulting graph captures:
- * - **Hierarchy**: node parentId reflects XState compound/parallel nesting
- * - **Edges**: all transitions with event types and optional guard types
- * - **Metadata**: state type, meta object, and extracted route path
+ * The graph of the result holds three things:
+ * - **The hierarchy**: the parentId of a node shows the compound nesting and the parallel nesting of XState
+ * - **The edges**: every transition, with its event types and with its optional guard types
+ * - **The metadata**: the state type, the meta object, and the route path from the extraction
  *
- * @param machine - XState v5 state machine (any shape)
- * @returns Typed directed graph with MachineNodeData on nodes and MachineEdgeData on edges
+ * @param machine - The XState v5 state machine, in each shape
+ * @returns The typed directed graph, with a MachineNodeData object on each node and a MachineEdgeData object on each edge
  *
  * @example
- * Convert a simple machine and query its routes
+ * The conversion of a simple machine, and a query of its routes
  * ```typescript
  * import { createMachine } from "xstate";
  * import { getChildren, getSuccessors } from "@statelyai/graph";
@@ -36,13 +36,14 @@ import { UnknownStateTypeError } from "./errors.js";
  * const successors = getSuccessors(graph, "app.home"); // [about]
  * ```
  *
- * @see {@link MachineNodeData} for node data shape
- * @see {@link MachineEdgeData} for edge data shape
- * @see https://github.com/statelyai/graph for @statelyai/graph API reference
+ * @see {@link MachineNodeData} for the shape of the data of a node
+ * @see {@link MachineEdgeData} for the shape of the data of an edge
+ * @see https://github.com/statelyai/graph for the API reference of @statelyai/graph
  */
 /**
- * Set of valid XState state types for runtime validation.
- * Guards against future XState changes or unexpected machine shapes.
+ * The set of the valid XState state types, for the check at run time.
+ * It guards against a later change of XState, and against a machine shape that the
+ * package does not expect.
  */
 const VALID_STATE_TYPES = new Set([
     "atomic",
@@ -53,7 +54,7 @@ const VALID_STATE_TYPES = new Set([
 ]);
 export const machineToGraph = (machine) => {
     const dg = toDirectedGraph(machine);
-    // Flatten DirectedGraphNode hierarchy into flat node/edge arrays
+    // Convert the hierarchy of the DirectedGraphNode objects into a flat array of nodes and a flat array of edges
     const nodes = [];
     const edges = [];
     let edgeCounter = 0;
@@ -66,7 +67,7 @@ export const machineToGraph = (machine) => {
             : typeof metaRoute === "object" && metaRoute !== null && "path" in metaRoute
                 ? metaRoute.path
                 : undefined;
-        // Runtime assertion: validate state type before casting
+        // An assertion at run time: check the state type before the cast
         if (!VALID_STATE_TYPES.has(sn.type)) {
             throw new UnknownStateTypeError(sn.type, sn.id, [...VALID_STATE_TYPES]);
         }
@@ -84,7 +85,7 @@ export const machineToGraph = (machine) => {
         else {
             nodes.push({ id: dgNode.id, data: nodeData });
         }
-        // Collect edges from THIS node (edges are on source node, not graph root)
+        // Collect the edges of THIS node. An edge is on its source node, and not on the root of the graph
         for (const edge of dgNode.edges) {
             const edgeData = {
                 eventType: edge.label.text,
@@ -99,7 +100,7 @@ export const machineToGraph = (machine) => {
                 data: edgeData,
             });
         }
-        // Recurse into children with current node as parent
+        // Walk into the children, with this node as their parent
         for (const child of dgNode.children) {
             walk(child, dgNode.id);
         }

package/dist/machine-to-graph.js.map

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

package/dist/query.d.ts

@@ -1,14 +1,14 @@
 import type { Graph } from "@statelyai/graph";
 import type { RouteTree, RouteNode, MachineNodeData, MachineEdgeData } from "./types.js";
 /**
- * Get all routes navigable from given state
+ * Returns every route of a navigation from the given state
  *
- * Returns child routes of the specified state. Future enhancement will
- * include sibling routes reachable via transitions.
+ * The function returns the child routes of the state. A later version also returns
+ * the sibling routes of a transition.
  *
- * @param tree - Route tree from extractMachineRoutes()
- * @param stateId - Current state ID
- * @returns Array of route nodes reachable from state
+ * @param tree - The route tree, from extractMachineRoutes()
+ * @param stateId - The ID of the current state
+ * @returns The array of the route nodes that the state can reach
  *
  * @example
  * ```typescript
@@ -19,14 +19,14 @@ import type { RouteTree, RouteNode, MachineNodeData, MachineEdgeData } from "./t
  */
 export declare const getNavigableRoutes: (tree: RouteTree, stateId: string) => RouteNode[];
 /**
- * Get all routable routes from tree as flat array
+ * Returns every route of the tree that has a route, in one flat array
  *
- * Returns all routes that have meta.route defined, excluding non-routable
- * states and the synthetic root node. Useful for dynamically generating
- * router configurations in framework adapters.
+ * The function returns each route with a `meta.route` field. It returns no state
+ * without a route, and no synthetic root node. Use it to generate a router
+ * configuration in a framework adapter dynamically.
  *
- * @param tree - Route tree from extractMachineRoutes()
- * @returns Array of routable route nodes with path and stateId
+ * @param tree - The route tree, from extractMachineRoutes()
+ * @returns The array of the route nodes with a route, with their path and their stateId
  *
  * @example
  * ```typescript
@@ -41,58 +41,60 @@ export declare const getNavigableRoutes: (tree: RouteTree, stateId: string) => R
  */
 export declare const getRoutableRoutes: (tree: RouteTree) => RouteNode[];
 /**
- * Validate route path exists in tree
+ * Tells you if a route path is in the tree
  *
- * Checks if path has corresponding state with meta.route.
+ * The function tests if the path has a state with a `meta.route` field.
  *
- * @param tree - Route tree from extractMachineRoutes()
- * @param path - Full route path (e.g., '/dashboard/settings')
- * @returns true if path exists, false otherwise
+ * @param tree - The route tree, from extractMachineRoutes()
+ * @param path - The complete route path, for example '/dashboard/settings'
+ * @returns true when the tree holds the path. In every other case, false
  */
 export declare const routeExists: (tree: RouteTree, path: string) => boolean;
 /**
- * Get routes reachable via transitions from current state
+ * Returns the routes that a transition from the current state can reach
  *
- * Uses the @statelyai/graph successor algorithm to find all states
- * directly reachable via transition edges from the given state,
- * then filters to those with defined routes.
+ * The function uses the successor algorithm of @statelyai/graph. It finds every
+ * state of a direct transition edge from the given state, then it keeps the states
+ * with a route.
  *
- * Returned values are the RAW `meta.route` strings from the machine — relative
- * routes (e.g. `"detail"`) are NOT resolved to full paths and cannot be used as
- * `tree.byPath` keys. For resolved `RouteNode`s use `getNavigableRoutes`, which
- * resolves reachable states through `tree.byStateId`.
+ * The values of the return are the RAW `meta.route` strings of the machine. The
+ * function does NOT resolve a relative route, for example `"detail"`, to a complete
+ * path, and such a value is therefore no key of `tree.byPath`. For a resolved
+ * `RouteNode`, use `getNavigableRoutes`: that function resolves each state that the
+ * transition reaches through `tree.byStateId`.
  *
- * @param graph - Machine graph from RouteTree.graph
- * @param stateId - Current state ID (e.g., "test.home")
- * @returns Array of raw route strings reachable via transitions
+ * @param graph - The machine graph, from RouteTree.graph
+ * @param stateId - The ID of the current state, for example "test.home"
+ * @returns The array of the raw route strings that a transition can reach
  *
  * @example
  * ```typescript
  * const tree = extractMachineRoutes(machine);
  * if (tree.graph) {
  *   const reachable = getTransitionReachableRoutes(tree.graph, 'auth.loggedIn');
- *   // ['/dashboard', '/settings'] — routes reachable via transitions
+ *   // ['/dashboard', '/settings'] — the routes that a transition can reach
  * }
  * ```
  */
 export declare const getTransitionReachableRoutes: (graph: Graph<MachineNodeData, MachineEdgeData>, stateId: string) => string[];
 /**
- * Check if a route is reachable from current state via transitions
+ * Tells you if a transition from the current state can reach a route
  *
- * Uses @statelyai/graph path-finding to determine if there exists
- * a chain of transition edges from the source state to the target state.
+ * The function uses the path search of @statelyai/graph. It decides if a chain of
+ * transition edges is present from the state of the origin to the state of the
+ * target.
  *
- * @param graph - Machine graph from RouteTree.graph
- * @param fromStateId - Source state ID
- * @param toStateId - Target state ID
- * @returns true if a transition path exists, false otherwise
+ * @param graph - The machine graph, from RouteTree.graph
+ * @param fromStateId - The ID of the state of the origin
+ * @param toStateId - The ID of the state of the target
+ * @returns true when a transition path is present. In every other case, false
  *
  * @example
  * ```typescript
  * const tree = extractMachineRoutes(machine);
  * if (tree.graph) {
  *   const canReach = isRouteReachable(tree.graph, 'auth.login', 'auth.dashboard');
- *   // true if login → dashboard transition path exists
+ *   // it is true when a transition path from login to dashboard is present
  * }
  * ```
  */

package/dist/query.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"query.d.ts","sourceRoot":"","sources":["../src/query.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAa,MAAM,kBAAkB,CAAC;AAEzD,OAAO,KAAK,EAAE,SAAS,EAAE,SAAS,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAqBzF;;;;;;;;;;;;;;;;GAgBG;AACH,eAAO,MAAM,kBAAkB,GAAI,MAAM,SAAS,EAAE,SAAS,MAAM,KAAG,SAAS,EAyB9E,CAAC;AAgBF;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,eAAO,MAAM,iBAAiB,GAAI,MAAM,SAAS,KAAG,SAAS,EAW5D,CAAC;AAEF;;;;;;;;GAQG;AACH,eAAO,MAAM,WAAW,GAAI,MAAM,SAAS,EAAE,MAAM,MAAM,KAAG,OAE3D,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,eAAO,MAAM,4BAA4B,GACxC,OAAO,KAAK,CAAC,eAAe,EAAE,eAAe,CAAC,EAC9C,SAAS,MAAM,KACb,MAAM,EAER,CAAC;AAEF;;;;;;;;;;;;;;;;;;;GAmBG;AACH,eAAO,MAAM,gBAAgB,GAC5B,OAAO,KAAK,CAAC,eAAe,EAAE,eAAe,CAAC,EAC9C,aAAa,MAAM,EACnB,WAAW,MAAM,KACf,OAKF,CAAC"}
+{"version":3,"file":"query.d.ts","sourceRoot":"","sources":["../src/query.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAa,MAAM,kBAAkB,CAAC;AAEzD,OAAO,KAAK,EAAE,SAAS,EAAE,SAAS,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAqBzF;;;;;;;;;;;;;;;;GAgBG;AACH,eAAO,MAAM,kBAAkB,GAAI,MAAM,SAAS,EAAE,SAAS,MAAM,KAAG,SAAS,EA0B9E,CAAC;AAkBF;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,eAAO,MAAM,iBAAiB,GAAI,MAAM,SAAS,KAAG,SAAS,EAW5D,CAAC;AAEF;;;;;;;;GAQG;AACH,eAAO,MAAM,WAAW,GAAI,MAAM,SAAS,EAAE,MAAM,MAAM,KAAG,OAE3D,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,eAAO,MAAM,4BAA4B,GACxC,OAAO,KAAK,CAAC,eAAe,EAAE,eAAe,CAAC,EAC9C,SAAS,MAAM,KACb,MAAM,EAER,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,eAAO,MAAM,gBAAgB,GAC5B,OAAO,KAAK,CAAC,eAAe,EAAE,eAAe,CAAC,EAC9C,aAAa,MAAM,EACnB,WAAW,MAAM,KACf,OAKF,CAAC"}