@xmachines/docs 1.0.0-beta.42 → 1.0.0-beta.44

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (324) hide show
  1. package/api/@xmachines/play/README.md +1 -1
  2. package/api/@xmachines/play/classes/NonNullableError.md +4 -4
  3. package/api/@xmachines/play/classes/PlayError.md +4 -4
  4. package/api/@xmachines/play/functions/assertNonNullable.md +1 -1
  5. package/api/@xmachines/play/type-aliases/PlayEvent.md +3 -3
  6. package/api/@xmachines/play-actor/README.md +2 -2
  7. package/api/@xmachines/play-actor/classes/AbstractActor.md +3 -3
  8. package/api/@xmachines/play-actor/functions/typedSpec.md +1 -1
  9. package/api/@xmachines/play-actor/interfaces/BaseActorProviderProps.md +5 -5
  10. package/api/@xmachines/play-actor/interfaces/BaseViewContextValue.md +5 -5
  11. package/api/@xmachines/play-actor/interfaces/PlaySpec.md +2 -2
  12. package/api/@xmachines/play-actor/interfaces/Routable.md +3 -3
  13. package/api/@xmachines/play-actor/interfaces/Viewable.md +2 -2
  14. package/api/@xmachines/play-dom/classes/PlayRenderer.md +4 -4
  15. package/api/@xmachines/play-dom/functions/connectRenderer.md +1 -1
  16. package/api/@xmachines/play-dom/functions/createPlayUI.md +1 -1
  17. package/api/@xmachines/play-dom/functions/createRenderer.md +1 -1
  18. package/api/@xmachines/play-dom/functions/defineRegistry.md +1 -1
  19. package/api/@xmachines/play-dom/functions/renderSpec.md +1 -1
  20. package/api/@xmachines/play-dom/interfaces/ComponentContext.md +7 -7
  21. package/api/@xmachines/play-dom/interfaces/ConnectRendererOptions.md +13 -13
  22. package/api/@xmachines/play-dom/interfaces/CreatePlayUIOptions.md +6 -6
  23. package/api/@xmachines/play-dom/interfaces/DefineRegistryResult.md +4 -4
  24. package/api/@xmachines/play-dom/interfaces/DomRenderContext.md +12 -12
  25. package/api/@xmachines/play-dom/interfaces/EventHandle.md +4 -4
  26. package/api/@xmachines/play-dom/interfaces/MountOptions.md +3 -3
  27. package/api/@xmachines/play-dom/interfaces/PlayDomOptions.md +5 -5
  28. package/api/@xmachines/play-dom/interfaces/UIProviderOptions.md +5 -5
  29. package/api/@xmachines/play-dom/type-aliases/ActionFn.md +1 -1
  30. package/api/@xmachines/play-dom/type-aliases/Actions.md +1 -1
  31. package/api/@xmachines/play-dom/type-aliases/BaseComponentProps.md +7 -7
  32. package/api/@xmachines/play-dom/type-aliases/CatalogHasActions.md +1 -1
  33. package/api/@xmachines/play-dom/type-aliases/ComponentFn.md +1 -1
  34. package/api/@xmachines/play-dom/type-aliases/ComponentRegistry.md +1 -1
  35. package/api/@xmachines/play-dom/type-aliases/DefineRegistryOptions.md +2 -2
  36. package/api/@xmachines/play-dom/type-aliases/DomComponentRenderer.md +1 -1
  37. package/api/@xmachines/play-dom/type-aliases/DomRegistry.md +1 -1
  38. package/api/@xmachines/play-dom/type-aliases/DomSchema.md +1 -1
  39. package/api/@xmachines/play-dom/type-aliases/MountFn.md +1 -1
  40. package/api/@xmachines/play-dom/type-aliases/SetState.md +1 -1
  41. package/api/@xmachines/play-dom/variables/schema.md +1 -1
  42. package/api/@xmachines/play-dom-router/README.md +1 -0
  43. package/api/@xmachines/play-dom-router/functions/connectRouter.md +1 -1
  44. package/api/@xmachines/play-dom-router/functions/createBrowserHistory.md +1 -1
  45. package/api/@xmachines/play-dom-router/functions/createRouteMap.md +8 -7
  46. package/api/@xmachines/play-dom-router/functions/createRouter.md +2 -2
  47. package/api/@xmachines/play-dom-router/interfaces/BrowserHistory.md +14 -14
  48. package/api/@xmachines/play-dom-router/interfaces/BrowserWindow.md +14 -14
  49. package/api/@xmachines/play-dom-router/interfaces/ConnectRouterOptions.md +4 -4
  50. package/api/@xmachines/play-dom-router/interfaces/PlayRouteEvent.md +7 -7
  51. package/api/@xmachines/play-dom-router/interfaces/RouteLookupContract.md +3 -3
  52. package/api/@xmachines/play-dom-router/interfaces/RouteMap.md +3 -3
  53. package/api/@xmachines/play-dom-router/interfaces/RouteMapOptions.md +13 -0
  54. package/api/@xmachines/play-dom-router/interfaces/RouteMapping.md +3 -3
  55. package/api/@xmachines/play-dom-router/interfaces/RouterBridge.md +4 -4
  56. package/api/@xmachines/play-dom-router/interfaces/VanillaRouter.md +4 -4
  57. package/api/@xmachines/play-dom-router/type-aliases/RoutableActor.md +1 -1
  58. package/api/@xmachines/play-react/README.md +1 -1
  59. package/api/@xmachines/play-react/classes/PlayErrorBoundary.md +5 -5
  60. package/api/@xmachines/play-react/functions/useActor.md +1 -1
  61. package/api/@xmachines/play-react/functions/usePlayView.md +1 -1
  62. package/api/@xmachines/play-react/functions/useSignalEffect.md +1 -1
  63. package/api/@xmachines/play-react/interfaces/ActorProviderProps.md +8 -8
  64. package/api/@xmachines/play-react/interfaces/PlayErrorBoundaryProps.md +4 -4
  65. package/api/@xmachines/play-react/interfaces/PlayErrorBoundaryState.md +3 -3
  66. package/api/@xmachines/play-react/interfaces/PlayUIProviderProps.md +8 -8
  67. package/api/@xmachines/play-react/interfaces/ViewContextValue.md +5 -5
  68. package/api/@xmachines/play-react/type-aliases/PlayActor.md +1 -1
  69. package/api/@xmachines/play-react/variables/ActorProvider.md +1 -1
  70. package/api/@xmachines/play-react/variables/PlayRenderer.md +1 -1
  71. package/api/@xmachines/play-react/variables/PlayUIProvider.md +1 -1
  72. package/api/@xmachines/play-react-router/README.md +1 -0
  73. package/api/@xmachines/play-react-router/classes/ReactRouterBridge.md +33 -29
  74. package/api/@xmachines/play-react-router/classes/RouteMap.md +4 -4
  75. package/api/@xmachines/play-react-router/functions/PlayRouterProvider.md +1 -1
  76. package/api/@xmachines/play-react-router/functions/createRouteMap.md +24 -6
  77. package/api/@xmachines/play-react-router/functions/createRouteMapFromTree.md +11 -10
  78. package/api/@xmachines/play-react-router/interfaces/PlayRouteEvent.md +7 -7
  79. package/api/@xmachines/play-react-router/interfaces/PlayRouterProviderProps.md +7 -7
  80. package/api/@xmachines/play-react-router/interfaces/RouteMapOptions.md +13 -0
  81. package/api/@xmachines/play-react-router/interfaces/RouteMapping.md +3 -3
  82. package/api/@xmachines/play-react-router/interfaces/RouterBridge.md +4 -4
  83. package/api/@xmachines/play-router/README.md +9 -8
  84. package/api/@xmachines/play-router/classes/RouteMap.md +4 -4
  85. package/api/@xmachines/play-router/classes/RouterBridgeBase.md +37 -33
  86. package/api/@xmachines/play-router/functions/buildPlayRouteEvent.md +1 -1
  87. package/api/@xmachines/play-router/functions/buildRouteTree.md +1 -1
  88. package/api/@xmachines/play-router/functions/createRouteMap.md +21 -35
  89. package/api/@xmachines/play-router/functions/createRouteMapFromTree.md +11 -10
  90. package/api/@xmachines/play-router/functions/createRouteMatcher.md +53 -0
  91. package/api/@xmachines/play-router/functions/detectDuplicateRoutes.md +1 -1
  92. package/api/@xmachines/play-router/functions/extractMachineRoutes.md +1 -1
  93. package/api/@xmachines/play-router/functions/extractQuery.md +1 -1
  94. package/api/@xmachines/play-router/functions/extractRouteParams.md +1 -1
  95. package/api/@xmachines/play-router/functions/findRouteById.md +1 -1
  96. package/api/@xmachines/play-router/functions/findRouteByPath.md +1 -1
  97. package/api/@xmachines/play-router/functions/getNavigableRoutes.md +1 -1
  98. package/api/@xmachines/play-router/functions/getRoutableRoutes.md +1 -1
  99. package/api/@xmachines/play-router/functions/getTransitionReachableRoutes.md +1 -1
  100. package/api/@xmachines/play-router/functions/isRouteReachable.md +1 -1
  101. package/api/@xmachines/play-router/functions/machineToGraph.md +1 -1
  102. package/api/@xmachines/play-router/functions/routeExists.md +1 -1
  103. package/api/@xmachines/play-router/functions/sanitizePathname.md +1 -1
  104. package/api/@xmachines/play-router/functions/validateRouteFormat.md +1 -1
  105. package/api/@xmachines/play-router/functions/validateStateExists.md +1 -1
  106. package/api/@xmachines/play-router/interfaces/BuildPlayRouteEventOptions.md +4 -4
  107. package/api/@xmachines/play-router/interfaces/LocationLike.md +3 -3
  108. package/api/@xmachines/play-router/interfaces/MachineEdgeData.md +3 -3
  109. package/api/@xmachines/play-router/interfaces/MachineNodeData.md +5 -5
  110. package/api/@xmachines/play-router/interfaces/PlayRouteEvent.md +7 -7
  111. package/api/@xmachines/play-router/interfaces/RouteInfo.md +8 -8
  112. package/api/@xmachines/play-router/interfaces/RouteMapOptions.md +13 -0
  113. package/api/@xmachines/play-router/interfaces/RouteMapping.md +3 -3
  114. package/api/@xmachines/play-router/interfaces/RouteMatch.md +3 -3
  115. package/api/@xmachines/play-router/interfaces/RouteMatcher.md +8 -8
  116. package/api/@xmachines/play-router/interfaces/RouteNode.md +12 -12
  117. package/api/@xmachines/play-router/interfaces/RouteObject.md +2 -2
  118. package/api/@xmachines/play-router/interfaces/RouteTree.md +5 -5
  119. package/api/@xmachines/play-router/interfaces/RouteWatcherHandle.md +3 -3
  120. package/api/@xmachines/play-router/interfaces/RouterBridge.md +4 -4
  121. package/api/@xmachines/play-router/interfaces/WindowLike.md +3 -3
  122. package/api/@xmachines/play-router/type-aliases/MachineGraph.md +1 -1
  123. package/api/@xmachines/play-router/type-aliases/RouteMetadata.md +1 -1
  124. package/api/@xmachines/play-signals/README.md +2 -2
  125. package/api/@xmachines/play-signals/functions/watchSignal.md +1 -1
  126. package/api/@xmachines/play-signals/interfaces/ComputedOptions.md +2 -2
  127. package/api/@xmachines/play-signals/interfaces/SignalComputed.md +2 -2
  128. package/api/@xmachines/play-signals/interfaces/SignalOptions.md +2 -2
  129. package/api/@xmachines/play-signals/interfaces/SignalState.md +3 -3
  130. package/api/@xmachines/play-signals/interfaces/SignalWatcher.md +4 -4
  131. package/api/@xmachines/play-signals/type-aliases/WatcherNotify.md +1 -1
  132. package/api/@xmachines/play-solid/README.md +1 -1
  133. package/api/@xmachines/play-solid/functions/useActor.md +1 -1
  134. package/api/@xmachines/play-solid/functions/usePlayView.md +1 -1
  135. package/api/@xmachines/play-solid/interfaces/ActorProviderProps.md +8 -8
  136. package/api/@xmachines/play-solid/interfaces/PlayUIProviderProps.md +8 -8
  137. package/api/@xmachines/play-solid/interfaces/ViewContextValue.md +5 -5
  138. package/api/@xmachines/play-solid/type-aliases/PlayActor.md +1 -1
  139. package/api/@xmachines/play-solid/variables/ActorContext.md +1 -1
  140. package/api/@xmachines/play-solid/variables/ActorProvider.md +1 -1
  141. package/api/@xmachines/play-solid/variables/PlayRenderer.md +1 -1
  142. package/api/@xmachines/play-solid/variables/PlayUIProvider.md +1 -1
  143. package/api/@xmachines/play-solid-router/README.md +2 -1
  144. package/api/@xmachines/play-solid-router/classes/RouteMap.md +4 -4
  145. package/api/@xmachines/play-solid-router/classes/SolidRouterBridge.md +34 -30
  146. package/api/@xmachines/play-solid-router/functions/PlayRouterProvider.md +1 -1
  147. package/api/@xmachines/play-solid-router/functions/createRouteMap.md +8 -7
  148. package/api/@xmachines/play-solid-router/interfaces/AbstractActor.md +3 -3
  149. package/api/@xmachines/play-solid-router/interfaces/PlayRouteEvent.md +7 -7
  150. package/api/@xmachines/play-solid-router/interfaces/PlayRouterProviderProps.md +5 -5
  151. package/api/@xmachines/play-solid-router/interfaces/RouteMapOptions.md +13 -0
  152. package/api/@xmachines/play-solid-router/interfaces/RouteMapping.md +3 -3
  153. package/api/@xmachines/play-solid-router/interfaces/RouterBridge.md +4 -4
  154. package/api/@xmachines/play-solid-router/type-aliases/RoutableActor.md +1 -1
  155. package/api/@xmachines/play-solid-router/type-aliases/SolidRouterHooks.md +4 -4
  156. package/api/@xmachines/play-svelte/README.md +1 -0
  157. package/api/@xmachines/play-svelte/functions/defineRegistry.md +1 -1
  158. package/api/@xmachines/play-svelte/functions/getActorContext.md +1 -1
  159. package/api/@xmachines/play-svelte/functions/getPlayViewContext.md +1 -1
  160. package/api/@xmachines/play-svelte/functions/setActorContext.md +1 -1
  161. package/api/@xmachines/play-svelte/interfaces/ActorProviderProps.md +12 -8
  162. package/api/@xmachines/play-svelte/interfaces/DefineRegistryOptions.md +4 -4
  163. package/api/@xmachines/play-svelte/interfaces/PlayUIProviderProps.md +43 -0
  164. package/api/@xmachines/play-svelte/interfaces/ViewContextValue.md +5 -5
  165. package/api/@xmachines/play-svelte/type-aliases/PlayActor.md +1 -1
  166. package/api/@xmachines/play-svelte-spa-router/README.md +1 -0
  167. package/api/@xmachines/play-svelte-spa-router/classes/RouteMap.md +4 -4
  168. package/api/@xmachines/play-svelte-spa-router/functions/connectRouter.md +1 -1
  169. package/api/@xmachines/play-svelte-spa-router/functions/createRouteMap.md +8 -7
  170. package/api/@xmachines/play-svelte-spa-router/interfaces/ConnectRouterOptions.md +4 -4
  171. package/api/@xmachines/play-svelte-spa-router/interfaces/PlayRouteEvent.md +7 -7
  172. package/api/@xmachines/play-svelte-spa-router/interfaces/RouteMapOptions.md +13 -0
  173. package/api/@xmachines/play-svelte-spa-router/interfaces/RouteMapping.md +3 -3
  174. package/api/@xmachines/play-svelte-spa-router/interfaces/RouterBridge.md +4 -4
  175. package/api/@xmachines/play-svelte-spa-router/interfaces/WindowLike.md +3 -3
  176. package/api/@xmachines/play-svelte-spa-router/type-aliases/RoutableActor.md +1 -1
  177. package/api/@xmachines/play-sveltekit-router/README.md +1 -0
  178. package/api/@xmachines/play-sveltekit-router/classes/RouteMap.md +4 -4
  179. package/api/@xmachines/play-sveltekit-router/functions/connectRouter.md +1 -1
  180. package/api/@xmachines/play-sveltekit-router/functions/createRouteMap.md +8 -7
  181. package/api/@xmachines/play-sveltekit-router/interfaces/ConnectRouterOptions.md +4 -4
  182. package/api/@xmachines/play-sveltekit-router/interfaces/LocationLike.md +3 -3
  183. package/api/@xmachines/play-sveltekit-router/interfaces/PlayRouteEvent.md +7 -7
  184. package/api/@xmachines/play-sveltekit-router/interfaces/RouteMapOptions.md +13 -0
  185. package/api/@xmachines/play-sveltekit-router/interfaces/RouteMapping.md +3 -3
  186. package/api/@xmachines/play-sveltekit-router/interfaces/RouterBridge.md +4 -4
  187. package/api/@xmachines/play-sveltekit-router/type-aliases/RoutableActor.md +1 -1
  188. package/api/@xmachines/play-tanstack-react-router/README.md +1 -0
  189. package/api/@xmachines/play-tanstack-react-router/classes/RouteMap.md +4 -4
  190. package/api/@xmachines/play-tanstack-react-router/classes/TanStackReactRouterBridge.md +33 -29
  191. package/api/@xmachines/play-tanstack-react-router/functions/PlayRouterProvider.md +1 -1
  192. package/api/@xmachines/play-tanstack-react-router/functions/createRouteMap.md +24 -6
  193. package/api/@xmachines/play-tanstack-react-router/functions/createRouteMapFromTree.md +11 -10
  194. package/api/@xmachines/play-tanstack-react-router/functions/extractMachineRoutes.md +1 -1
  195. package/api/@xmachines/play-tanstack-react-router/interfaces/PlayRouteEvent.md +7 -7
  196. package/api/@xmachines/play-tanstack-react-router/interfaces/PlayRouterProviderProps.md +7 -7
  197. package/api/@xmachines/play-tanstack-react-router/interfaces/RouteMapOptions.md +13 -0
  198. package/api/@xmachines/play-tanstack-react-router/interfaces/RouteMapping.md +3 -3
  199. package/api/@xmachines/play-tanstack-react-router/interfaces/RouteNavigateEvent.md +3 -3
  200. package/api/@xmachines/play-tanstack-react-router/interfaces/RouterBridge.md +4 -4
  201. package/api/@xmachines/play-tanstack-react-router/type-aliases/TanStackRouterInstance.md +1 -1
  202. package/api/@xmachines/play-tanstack-react-router/type-aliases/TanStackRouterLike.md +4 -4
  203. package/api/@xmachines/play-tanstack-solid-router/README.md +2 -1
  204. package/api/@xmachines/play-tanstack-solid-router/classes/RouteMap.md +4 -4
  205. package/api/@xmachines/play-tanstack-solid-router/classes/SolidRouterBridge.md +34 -30
  206. package/api/@xmachines/play-tanstack-solid-router/functions/PlayRouterProvider.md +1 -1
  207. package/api/@xmachines/play-tanstack-solid-router/functions/createRouteMap.md +8 -7
  208. package/api/@xmachines/play-tanstack-solid-router/interfaces/PlayRouteEvent.md +7 -7
  209. package/api/@xmachines/play-tanstack-solid-router/interfaces/PlayRouterProviderProps.md +5 -5
  210. package/api/@xmachines/play-tanstack-solid-router/interfaces/RouteMapOptions.md +13 -0
  211. package/api/@xmachines/play-tanstack-solid-router/interfaces/RouteMapping.md +3 -3
  212. package/api/@xmachines/play-tanstack-solid-router/interfaces/RouterBridge.md +4 -4
  213. package/api/@xmachines/play-tanstack-solid-router/type-aliases/RoutableActor.md +1 -1
  214. package/api/@xmachines/play-tanstack-solid-router/type-aliases/TanStackRouterInstance.md +1 -1
  215. package/api/@xmachines/play-tanstack-solid-router/type-aliases/TanStackRouterLike.md +3 -3
  216. package/api/@xmachines/play-vue/README.md +2 -1
  217. package/api/@xmachines/play-vue/functions/defineRegistry.md +1 -1
  218. package/api/@xmachines/play-vue/functions/getPlayViewContext.md +1 -1
  219. package/api/@xmachines/play-vue/functions/useActor.md +1 -1
  220. package/api/@xmachines/play-vue/interfaces/ActorProviderProps.md +5 -5
  221. package/api/@xmachines/play-vue/interfaces/PlayUIProviderProps.md +8 -8
  222. package/api/@xmachines/play-vue/interfaces/ViewContextValue.md +5 -5
  223. package/api/@xmachines/play-vue/interfaces/VisibilityProviderProps.md +5 -0
  224. package/api/@xmachines/play-vue/type-aliases/ComponentEntry.md +1 -1
  225. package/api/@xmachines/play-vue/type-aliases/ComponentsMap.md +1 -1
  226. package/api/@xmachines/play-vue/type-aliases/DefineRegistryOptions.md +2 -2
  227. package/api/@xmachines/play-vue/type-aliases/PlayActor.md +1 -1
  228. package/api/@xmachines/play-vue/variables/PlayRenderer.md +1 -1
  229. package/api/@xmachines/play-vue-router/README.md +2 -1
  230. package/api/@xmachines/play-vue-router/classes/RouteMap.md +4 -4
  231. package/api/@xmachines/play-vue-router/classes/VueRouterBridge.md +40 -30
  232. package/api/@xmachines/play-vue-router/functions/createRouteMap.md +25 -5
  233. package/api/@xmachines/play-vue-router/interfaces/PlayRouteEvent.md +7 -7
  234. package/api/@xmachines/play-vue-router/interfaces/RouteMapOptions.md +13 -0
  235. package/api/@xmachines/play-vue-router/interfaces/RouteMapping.md +3 -3
  236. package/api/@xmachines/play-vue-router/interfaces/RouterBridge.md +4 -4
  237. package/api/@xmachines/play-vue-router/type-aliases/RoutableActor.md +1 -1
  238. package/api/@xmachines/play-vue-router/variables/PlayRouterProvider.md +1 -1
  239. package/api/@xmachines/play-xstate/README.md +1 -1
  240. package/api/@xmachines/play-xstate/classes/PlayerActor.md +13 -13
  241. package/api/@xmachines/play-xstate/functions/buildRouteUrl.md +1 -1
  242. package/api/@xmachines/play-xstate/functions/composeGuards.md +1 -1
  243. package/api/@xmachines/play-xstate/functions/composeGuardsOr.md +1 -1
  244. package/api/@xmachines/play-xstate/functions/contextFieldMatches.md +4 -2
  245. package/api/@xmachines/play-xstate/functions/definePlayer.md +2 -2
  246. package/api/@xmachines/play-xstate/functions/deriveRoute.md +2 -2
  247. package/api/@xmachines/play-xstate/functions/eventMatches.md +1 -1
  248. package/api/@xmachines/play-xstate/functions/formatPlayRouteTransitions.md +1 -1
  249. package/api/@xmachines/play-xstate/functions/hasContext.md +1 -1
  250. package/api/@xmachines/play-xstate/functions/isAbsoluteRoute.md +1 -1
  251. package/api/@xmachines/play-xstate/functions/negateGuard.md +1 -1
  252. package/api/@xmachines/play-xstate/interfaces/PlayerConfig.md +3 -3
  253. package/api/@xmachines/play-xstate/interfaces/PlayerFactoryResumeOptions.md +2 -2
  254. package/api/@xmachines/play-xstate/interfaces/PlayerOptions.md +6 -6
  255. package/api/@xmachines/play-xstate/interfaces/RouteContext.md +5 -5
  256. package/api/@xmachines/play-xstate/type-aliases/ComposedGuard.md +1 -1
  257. package/api/@xmachines/play-xstate/type-aliases/Guard.md +1 -1
  258. package/api/@xmachines/play-xstate/type-aliases/GuardArray.md +1 -1
  259. package/api/@xmachines/play-xstate/type-aliases/PlayerFactory.md +1 -1
  260. package/api/@xmachines/play-xstate/type-aliases/RouteMachineConfig.md +4 -4
  261. package/api/@xmachines/play-xstate/type-aliases/RouteStateNode.md +4 -4
  262. package/api/@xmachines/shared/vite-aliases/functions/xmAliases.md +1 -1
  263. package/api/@xmachines/shared/vite-aliases/functions/xmCacheDir.md +1 -1
  264. package/api/@xmachines/shared/vite-aliases/functions/xmOptimizeDeps.md +1 -1
  265. package/api/@xmachines/shared/vite-aliases/functions/xmResolve.md +1 -1
  266. package/api/@xmachines/shared/vitest/functions/defineXmVitestConfig.md +1 -1
  267. package/api/llms.txt +2 -2
  268. package/examples/@xmachines/play-dom-demo/functions/createNavBar.md +1 -1
  269. package/examples/@xmachines/play-dom-demo/functions/initShell.md +1 -1
  270. package/examples/@xmachines/play-dom-demo/type-aliases/AuthCatalog.md +1 -1
  271. package/examples/@xmachines/play-dom-demo/variables/About.md +1 -1
  272. package/examples/@xmachines/play-dom-demo/variables/Contact.md +1 -1
  273. package/examples/@xmachines/play-dom-demo/variables/Dashboard.md +1 -1
  274. package/examples/@xmachines/play-dom-demo/variables/Home.md +1 -1
  275. package/examples/@xmachines/play-dom-demo/variables/Login.md +1 -1
  276. package/examples/@xmachines/play-dom-demo/variables/NavBarView.md +1 -1
  277. package/examples/@xmachines/play-dom-demo/variables/Navigation.md +1 -1
  278. package/examples/@xmachines/play-dom-demo/variables/Overview.md +1 -1
  279. package/examples/@xmachines/play-dom-demo/variables/Profile.md +1 -1
  280. package/examples/@xmachines/play-dom-demo/variables/Settings.md +1 -1
  281. package/examples/@xmachines/play-dom-demo/variables/Stats.md +1 -1
  282. package/examples/@xmachines/play-dom-demo/variables/authCatalog.md +1 -1
  283. package/examples/@xmachines/play-react-demo/functions/App.md +1 -1
  284. package/examples/@xmachines/play-react-demo/type-aliases/AuthCatalog.md +1 -1
  285. package/examples/@xmachines/play-react-demo/variables/About.md +1 -1
  286. package/examples/@xmachines/play-react-demo/variables/Contact.md +1 -1
  287. package/examples/@xmachines/play-react-demo/variables/Dashboard.md +1 -1
  288. package/examples/@xmachines/play-react-demo/variables/DebugPanel.md +1 -1
  289. package/examples/@xmachines/play-react-demo/variables/Home.md +1 -1
  290. package/examples/@xmachines/play-react-demo/variables/Login.md +1 -1
  291. package/examples/@xmachines/play-react-demo/variables/NavBar.md +1 -1
  292. package/examples/@xmachines/play-react-demo/variables/NavBarView.md +1 -1
  293. package/examples/@xmachines/play-react-demo/variables/Navigation.md +1 -1
  294. package/examples/@xmachines/play-react-demo/variables/Overview.md +1 -1
  295. package/examples/@xmachines/play-react-demo/variables/Profile.md +1 -1
  296. package/examples/@xmachines/play-react-demo/variables/Settings.md +1 -1
  297. package/examples/@xmachines/play-react-demo/variables/Shell.md +1 -1
  298. package/examples/@xmachines/play-react-demo/variables/Stats.md +1 -1
  299. package/examples/@xmachines/play-react-demo/variables/authCatalog.md +1 -1
  300. package/examples/@xmachines/play-solid-demo/functions/App.md +1 -1
  301. package/examples/@xmachines/play-solid-demo/type-aliases/AuthCatalog.md +1 -1
  302. package/examples/@xmachines/play-solid-demo/variables/About.md +1 -1
  303. package/examples/@xmachines/play-solid-demo/variables/Contact.md +1 -1
  304. package/examples/@xmachines/play-solid-demo/variables/Dashboard.md +1 -1
  305. package/examples/@xmachines/play-solid-demo/variables/DebugPanel.md +1 -1
  306. package/examples/@xmachines/play-solid-demo/variables/Home.md +1 -1
  307. package/examples/@xmachines/play-solid-demo/variables/Login.md +1 -1
  308. package/examples/@xmachines/play-solid-demo/variables/NavBar.md +1 -1
  309. package/examples/@xmachines/play-solid-demo/variables/NavBarView.md +1 -1
  310. package/examples/@xmachines/play-solid-demo/variables/Navigation.md +1 -1
  311. package/examples/@xmachines/play-solid-demo/variables/Overview.md +1 -1
  312. package/examples/@xmachines/play-solid-demo/variables/Profile.md +1 -1
  313. package/examples/@xmachines/play-solid-demo/variables/Settings.md +1 -1
  314. package/examples/@xmachines/play-solid-demo/variables/Shell.md +1 -1
  315. package/examples/@xmachines/play-solid-demo/variables/Stats.md +1 -1
  316. package/examples/@xmachines/play-solid-demo/variables/authCatalog.md +1 -1
  317. package/examples/@xmachines/play-svelte-demo/type-aliases/AuthCatalog.md +1 -1
  318. package/examples/@xmachines/play-svelte-demo/variables/authCatalog.md +1 -1
  319. package/examples/@xmachines/play-vue-demo/type-aliases/AuthCatalog.md +1 -1
  320. package/examples/@xmachines/play-vue-demo/variables/App.md +1 -1
  321. package/examples/@xmachines/play-vue-demo/variables/authCatalog.md +1 -1
  322. package/package.json +2 -2
  323. package/rfc/play.md +1 -1
  324. package/api/@xmachines/play-router/functions/createRouteMapFromMachine.md +0 -38
package/api/@xmachines/play-vue-router/classes/VueRouterBridge.md CHANGED
@@ -2,7 +2,7 @@
2
2
 
3
3
  # Class: VueRouterBridge
4
4
 
5
- Defined in: [play-vue-router/src/vue-router-bridge.ts:33](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.42/packages/play-vue-router/src/vue-router-bridge.ts#L33)
5
+ Defined in: [play-vue-router/src/vue-router-bridge.ts:33](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.44/packages/play-vue-router/src/vue-router-bridge.ts#L33)
6
6
 
7
7
  @xmachines/play-vue-router - Vue Router 4.x adapter for XMachines Play
8
8
 
@@ -23,7 +23,7 @@ new VueRouterBridge(
23
23
  routeMap): VueRouterBridge;
24
24
  ```
25
25
 
26
- Defined in: [play-vue-router/src/vue-router-bridge.ts:54](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.42/packages/play-vue-router/src/vue-router-bridge.ts#L54)
26
+ Defined in: [play-vue-router/src/vue-router-bridge.ts:42](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.44/packages/play-vue-router/src/vue-router-bridge.ts#L42)
27
27
 
28
28
  #### Parameters
29
29
 
@@ -43,17 +43,17 @@ Defined in: [play-vue-router/src/vue-router-bridge.ts:54](https://gitlab.com/xma
43
43
 
44
44
  ## Properties
45
45
 
46
- | Property | Modifier | Type | Default value | Description | Inherited from | Defined in |
47
- | --------------------------------------------------------------------- | ----------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------- |
48
- | <a id="property-actor"></a> `actor` | `readonly` | [`AbstractActor`](../../play-actor/classes/AbstractActor.md)\<[`AnyActorLogic`](https://www.jsdocs.io/package/xstate#AnyActorLogic), [`EventObject`](https://www.jsdocs.io/package/xstate#EventObject)\> & [`Routable`](../../play-actor/interfaces/Routable.md) | `undefined` | A `Routable` actor exposing `currentRoute` and `send`. | [`RouterBridgeBase`](../../play-router/classes/RouterBridgeBase.md).[`actor`](../../play-router/classes/RouterBridgeBase.md#property-actor) | [play-router/src/router-bridge-base.ts:104](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.42/packages/play-router/src/router-bridge-base.ts#L104) |
49
- | <a id="property-hasconnectedonce"></a> `hasConnectedOnce` | `protected` | `boolean` | `false` | - | [`RouterBridgeBase`](../../play-router/classes/RouterBridgeBase.md).[`hasConnectedOnce`](../../play-router/classes/RouterBridgeBase.md#property-hasconnectedonce) | [play-router/src/router-bridge-base.ts:92](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.42/packages/play-router/src/router-bridge-base.ts#L92) |
50
- | <a id="property-isconnected"></a> `isConnected` | `protected` | `boolean` | `false` | - | [`RouterBridgeBase`](../../play-router/classes/RouterBridgeBase.md).[`isConnected`](../../play-router/classes/RouterBridgeBase.md#property-isconnected) | [play-router/src/router-bridge-base.ts:91](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.42/packages/play-router/src/router-bridge-base.ts#L91) |
51
- | <a id="property-isprocessingnavigation"></a> `isProcessingNavigation` | `protected` | `boolean` | `false` | - | [`RouterBridgeBase`](../../play-router/classes/RouterBridgeBase.md).[`isProcessingNavigation`](../../play-router/classes/RouterBridgeBase.md#property-isprocessingnavigation) | [play-router/src/router-bridge-base.ts:94](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.42/packages/play-router/src/router-bridge-base.ts#L94) |
52
- | <a id="property-lastsyncedpath"></a> `lastSyncedPath` | `protected` | `string` \| `null` | `null` | - | [`RouterBridgeBase`](../../play-router/classes/RouterBridgeBase.md).[`lastSyncedPath`](../../play-router/classes/RouterBridgeBase.md#property-lastsyncedpath) | [play-router/src/router-bridge-base.ts:93](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.42/packages/play-router/src/router-bridge-base.ts#L93) |
53
- | <a id="property-routemap"></a> `routeMap` | `readonly` | `object` | `undefined` | Bidirectional route map for `stateId ↔ path` resolution. Provide `getStateIdByPath` and `getPathByStateId`. Framework adapters typically wrap the result of `createRouteMap()` or an equivalent. | [`RouterBridgeBase`](../../play-router/classes/RouterBridgeBase.md).[`routeMap`](../../play-router/classes/RouterBridgeBase.md#property-routemap) | [play-router/src/router-bridge-base.ts:105](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.42/packages/play-router/src/router-bridge-base.ts#L105) |
54
- | `routeMap.getPathByStateId` | `public` | `string` \| `null` \| `undefined` | `undefined` | - | - | [play-router/src/router-bridge-base.ts:107](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.42/packages/play-router/src/router-bridge-base.ts#L107) |
55
- | `routeMap.getStateIdByPath` | `public` | `string` \| `null` \| `undefined` | `undefined` | - | - | [play-router/src/router-bridge-base.ts:106](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.42/packages/play-router/src/router-bridge-base.ts#L106) |
56
- | <a id="property-routewatcher"></a> `routeWatcher` | `protected` | \| [`RouteWatcherHandle`](../../play-router/interfaces/RouteWatcherHandle.md) \| `null` | `null` | - | [`RouterBridgeBase`](../../play-router/classes/RouterBridgeBase.md).[`routeWatcher`](../../play-router/classes/RouterBridgeBase.md#property-routewatcher) | [play-router/src/router-bridge-base.ts:95](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.42/packages/play-router/src/router-bridge-base.ts#L95) |
46
+ | Property | Modifier | Type | Default value | Description | Inherited from | Defined in |
47
+ | --------------------------------------------------------------------- | ----------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------- |
48
+ | <a id="property-actor"></a> `actor` | `readonly` | [`AbstractActor`](../../play-actor/classes/AbstractActor.md)\<[`AnyActorLogic`](https://www.jsdocs.io/package/xstate#AnyActorLogic), [`EventObject`](https://www.jsdocs.io/package/xstate#EventObject)\> & [`Routable`](../../play-actor/interfaces/Routable.md) | `undefined` | A `Routable` actor exposing `currentRoute` and `send`. | [`RouterBridgeBase`](../../play-router/classes/RouterBridgeBase.md).[`actor`](../../play-router/classes/RouterBridgeBase.md#property-actor) | [play-router/src/router-bridge-base.ts:126](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.44/packages/play-router/src/router-bridge-base.ts#L126) |
49
+ | <a id="property-hasconnectedonce"></a> `hasConnectedOnce` | `protected` | `boolean` | `false` | - | [`RouterBridgeBase`](../../play-router/classes/RouterBridgeBase.md).[`hasConnectedOnce`](../../play-router/classes/RouterBridgeBase.md#property-hasconnectedonce) | [play-router/src/router-bridge-base.ts:104](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.44/packages/play-router/src/router-bridge-base.ts#L104) |
50
+ | <a id="property-isconnected"></a> `isConnected` | `protected` | `boolean` | `false` | - | [`RouterBridgeBase`](../../play-router/classes/RouterBridgeBase.md).[`isConnected`](../../play-router/classes/RouterBridgeBase.md#property-isconnected) | [play-router/src/router-bridge-base.ts:103](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.44/packages/play-router/src/router-bridge-base.ts#L103) |
51
+ | <a id="property-isprocessingnavigation"></a> `isProcessingNavigation` | `protected` | `boolean` | `false` | Guards `syncActorFromRouter` against re-entrant calls triggered by the actor's own guard redirects (router→actor send → signal fires → actor→router push → another syncActorFromRouter before the first one returns). NOT used for actor→router echo suppression — that is handled exclusively by `lastSyncedPath`, which is updated before `navigateRouter()` is called so any router callback for the same path short-circuits at the `sanitized === lastSyncedPath` check in `syncActorFromRouter`. | [`RouterBridgeBase`](../../play-router/classes/RouterBridgeBase.md).[`isProcessingNavigation`](../../play-router/classes/RouterBridgeBase.md#property-isprocessingnavigation) | [play-router/src/router-bridge-base.ts:116](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.44/packages/play-router/src/router-bridge-base.ts#L116) |
52
+ | <a id="property-lastsyncedpath"></a> `lastSyncedPath` | `protected` | `string` \| `null` | `null` | - | [`RouterBridgeBase`](../../play-router/classes/RouterBridgeBase.md).[`lastSyncedPath`](../../play-router/classes/RouterBridgeBase.md#property-lastsyncedpath) | [play-router/src/router-bridge-base.ts:105](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.44/packages/play-router/src/router-bridge-base.ts#L105) |
53
+ | <a id="property-routemap"></a> `routeMap` | `readonly` | `object` | `undefined` | Bidirectional route map for `stateId ↔ path` resolution. Provide `getStateIdByPath` and `getPathByStateId`. Framework adapters typically wrap the result of `createRouteMap(machine)` or an equivalent. | [`RouterBridgeBase`](../../play-router/classes/RouterBridgeBase.md).[`routeMap`](../../play-router/classes/RouterBridgeBase.md#property-routemap) | [play-router/src/router-bridge-base.ts:127](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.44/packages/play-router/src/router-bridge-base.ts#L127) |
54
+ | `routeMap.getPathByStateId` | `public` | `string` \| `null` \| `undefined` | `undefined` | - | - | [play-router/src/router-bridge-base.ts:129](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.44/packages/play-router/src/router-bridge-base.ts#L129) |
55
+ | `routeMap.getStateIdByPath` | `public` | `string` \| `null` \| `undefined` | `undefined` | - | - | [play-router/src/router-bridge-base.ts:128](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.44/packages/play-router/src/router-bridge-base.ts#L128) |
56
+ | <a id="property-routewatcher"></a> `routeWatcher` | `protected` | \| [`RouteWatcherHandle`](../../play-router/interfaces/RouteWatcherHandle.md) \| `null` | `null` | - | [`RouterBridgeBase`](../../play-router/classes/RouterBridgeBase.md).[`routeWatcher`](../../play-router/classes/RouterBridgeBase.md#property-routewatcher) | [play-router/src/router-bridge-base.ts:117](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.44/packages/play-router/src/router-bridge-base.ts#L117) |
57
57
 
58
58
  ## Methods
59
59
 
@@ -63,7 +63,7 @@ Defined in: [play-vue-router/src/vue-router-bridge.ts:54](https://gitlab.com/xma
63
63
  connect(): void;
64
64
  ```
65
65
 
66
- Defined in: [play-router/src/router-bridge-base.ts:131](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.42/packages/play-router/src/router-bridge-base.ts#L131)
66
+ Defined in: [play-router/src/router-bridge-base.ts:153](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.44/packages/play-router/src/router-bridge-base.ts#L153)
67
67
 
68
68
  Connect the router bridge to the Actor.
69
69
 
@@ -95,7 +95,7 @@ Adapters that need custom initial-sync behavior should override
95
95
  disconnect(): void;
96
96
  ```
97
97
 
98
- Defined in: [play-router/src/router-bridge-base.ts:218](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.42/packages/play-router/src/router-bridge-base.ts#L218)
98
+ Defined in: [play-router/src/router-bridge-base.ts:249](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.44/packages/play-router/src/router-bridge-base.ts#L249)
99
99
 
100
100
  Disconnect the router bridge from the Actor.
101
101
 
@@ -117,7 +117,7 @@ Stops signal watching and unregisters framework-specific router listener.
117
117
  dispose(): void;
118
118
  ```
119
119
 
120
- Defined in: [play-vue-router/src/vue-router-bridge.ts:213](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.42/packages/play-vue-router/src/vue-router-bridge.ts#L213)
120
+ Defined in: [play-vue-router/src/vue-router-bridge.ts:193](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.44/packages/play-vue-router/src/vue-router-bridge.ts#L193)
121
121
 
122
122
  Cleanup alias for Vue component lifecycle (`onUnmounted(() => bridge.dispose())`).
123
123
 
@@ -133,7 +133,7 @@ Cleanup alias for Vue component lifecycle (`onUnmounted(() => bridge.dispose())`
133
133
  protected extractParams(pathname, stateId): Record<string, string>;
134
134
  ```
135
135
 
136
- Defined in: [play-router/src/router-bridge-base.ts:326](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.42/packages/play-router/src/router-bridge-base.ts#L326)
136
+ Defined in: [play-router/src/router-bridge-base.ts:373](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.44/packages/play-router/src/router-bridge-base.ts#L373)
137
137
 
138
138
  Extract path parameters from URL using the URLPattern API.
139
139
 
@@ -171,7 +171,7 @@ When URLPattern is absent and the route is parameterized
171
171
  protected extractQuery(search): Record<string, string>;
172
172
  ```
173
173
 
174
- Defined in: [play-router/src/router-bridge-base.ts:363](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.42/packages/play-router/src/router-bridge-base.ts#L363)
174
+ Defined in: [play-router/src/router-bridge-base.ts:410](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.44/packages/play-router/src/router-bridge-base.ts#L410)
175
175
 
176
176
  Extract query parameters from URL search string.
177
177
 
@@ -199,7 +199,7 @@ Extracted query parameters or empty object
199
199
  protected getInitialRouterPath(): string | null;
200
200
  ```
201
201
 
202
- Defined in: [play-vue-router/src/vue-router-bridge.ts:193](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.42/packages/play-vue-router/src/vue-router-bridge.ts#L193)
202
+ Defined in: [play-vue-router/src/vue-router-bridge.ts:173](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.44/packages/play-vue-router/src/vue-router-bridge.ts#L173)
203
203
 
204
204
  Return the router's current pathname at connect() time.
205
205
 
@@ -235,7 +235,7 @@ bridges that have not yet implemented this hook.
235
235
  protected getInitialRouterSearch(): string | undefined;
236
236
  ```
237
237
 
238
- Defined in: [play-vue-router/src/vue-router-bridge.ts:205](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.42/packages/play-vue-router/src/vue-router-bridge.ts#L205)
238
+ Defined in: [play-vue-router/src/vue-router-bridge.ts:185](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.44/packages/play-vue-router/src/vue-router-bridge.ts#L185)
239
239
 
240
240
  Return the initial URL search string for query-param forwarding on `connect()`.
241
241
 
@@ -260,7 +260,7 @@ from the first `"?"`. Returns `undefined` when no query string is present so
260
260
  protected navigateRouter(path): void;
261
261
  ```
262
262
 
263
- Defined in: [play-vue-router/src/vue-router-bridge.ts:97](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.42/packages/play-vue-router/src/vue-router-bridge.ts#L97)
263
+ Defined in: [play-vue-router/src/vue-router-bridge.ts:91](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.44/packages/play-vue-router/src/vue-router-bridge.ts#L91)
264
264
 
265
265
  Navigate Vue Router to the given path.
266
266
 
@@ -268,6 +268,12 @@ Receives a raw actor route value (stateId or concrete path).
268
268
  `resolveNavigationPath` normalizes to a concrete path; parameterized patterns
269
269
  are skipped. Navigation errors are thrown as [VueRouterNavigationError](#).
270
270
 
271
+ Echo suppression — preventing the watcher from re-driving the actor with the
272
+ router's response to this push — is handled by `lastSyncedPath` in the base
273
+ class. `syncRouterFromActor` sets `lastSyncedPath = resolved` before this call,
274
+ so when the watcher fires with the same path it short-circuits at the
275
+ `sanitizedPath === lastSyncedPath` check and sends no event.
276
+
271
277
  #### Parameters
272
278
 
273
279
  | Parameter | Type |
@@ -290,7 +296,7 @@ are skipped. Navigation errors are thrown as [VueRouterNavigationError](#).
290
296
  protected resolveNavigationPath(route): string | null;
291
297
  ```
292
298
 
293
- Defined in: [play-router/src/router-bridge-base.ts:348](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.42/packages/play-router/src/router-bridge-base.ts#L348)
299
+ Defined in: [play-router/src/router-bridge-base.ts:395](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.44/packages/play-router/src/router-bridge-base.ts#L395)
294
300
 
295
301
  Resolve an actor route value to a concrete URL path for navigation.
296
302
 
@@ -329,7 +335,7 @@ Concrete URL path, or `null` if navigation should be skipped
329
335
  protected syncActorFromRouter(pathname, search?): void;
330
336
  ```
331
337
 
332
- Defined in: [play-router/src/router-bridge-base.ts:268](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.42/packages/play-router/src/router-bridge-base.ts#L268)
338
+ Defined in: [play-router/src/router-bridge-base.ts:315](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.44/packages/play-router/src/router-bridge-base.ts#L315)
333
339
 
334
340
  Sync actor state when router location changes.
335
341
 
@@ -359,16 +365,20 @@ Prevents circular updates via isProcessingNavigation flag.
359
365
  protected syncRouterFromActor(route): void;
360
366
  ```
361
367
 
362
- Defined in: [play-router/src/router-bridge-base.ts:248](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.42/packages/play-router/src/router-bridge-base.ts#L248)
368
+ Defined in: [play-router/src/router-bridge-base.ts:290](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.44/packages/play-router/src/router-bridge-base.ts#L290)
363
369
 
364
370
  Sync router location when actor route signal changes.
365
371
 
366
372
  Calls navigateRouter() for framework-specific navigation.
367
- Prevents circular updates via isProcessingNavigation flag.
368
373
 
369
- `lastSyncedPath` is updated before `navigateRouter()` and the processing flag is
370
- released in a microtask so synchronous router callbacks triggered by navigation are
371
- suppressed as circular echoes.
374
+ Echo suppression — preventing the router's own callback from re-driving the
375
+ actor — is handled entirely by `lastSyncedPath`: it is set to `route` before
376
+ `navigateRouter()` is called, so any `syncActorFromRouter` invocation for the
377
+ same path short-circuits at the `sanitized === lastSyncedPath` check and sends
378
+ no event regardless of whether the callback fires synchronously or asynchronously.
379
+
380
+ `isProcessingNavigation` is NOT set here — it is only used inside
381
+ `syncActorFromRouter` to guard against re-entrant guard-redirect loops.
372
382
 
373
383
  #### Parameters
374
384
 
@@ -392,7 +402,7 @@ suppressed as circular echoes.
392
402
  protected unwatchRouterChanges(): void;
393
403
  ```
394
404
 
395
- Defined in: [play-vue-router/src/vue-router-bridge.ts:188](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.42/packages/play-vue-router/src/vue-router-bridge.ts#L188)
405
+ Defined in: [play-vue-router/src/vue-router-bridge.ts:168](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.44/packages/play-vue-router/src/vue-router-bridge.ts#L168)
396
406
 
397
407
  Stop watching for router location changes.
398
408
 
@@ -414,7 +424,7 @@ Called by disconnect(). Should clean up the framework-specific subscription.
414
424
  protected watchRouterChanges(): void;
415
425
  ```
416
426
 
417
- Defined in: [play-vue-router/src/vue-router-bridge.ts:129](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.42/packages/play-vue-router/src/vue-router-bridge.ts#L129)
427
+ Defined in: [play-vue-router/src/vue-router-bridge.ts:118](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.44/packages/play-vue-router/src/vue-router-bridge.ts#L118)
418
428
 
419
429
  Subscribe to Vue Router changes using `watch` from `@vue/reactivity`.
420
430
 
package/api/@xmachines/play-vue-router/functions/createRouteMap.md CHANGED
@@ -3,17 +3,37 @@
3
3
  # Function: createRouteMap()
4
4
 
5
5
  ```ts
6
- function createRouteMap(machine): RouteMap;
6
+ function createRouteMap(machine, options?): RouteMap;
7
7
  ```
8
8
 
9
- Defined in: [play-vue-router/src/create-route-map.ts:4](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.42/packages/play-vue-router/src/create-route-map.ts#L4)
9
+ Defined in: [play-router/src/create-route-map.ts:45](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.44/packages/play-router/src/create-route-map.ts#L45)
10
+
11
+ Create a `RouteMap` from an XState state machine.
12
+
13
+ Extracts all routable states (those with `meta.route`) and builds a bidirectional
14
+ path ↔ stateId lookup structure. The returned map is used by `RouterBridgeBase`
15
+ subclasses to translate browser URL changes into `play.route` actor events and
16
+ vice-versa.
10
17
 
11
18
  ## Parameters
12
19
 
13
- | Parameter | Type |
14
- | --------- | ------------------------------------------------------------------------- |
15
- | `machine` | [`AnyStateMachine`](https://www.jsdocs.io/package/xstate#AnyStateMachine) |
20
+ | Parameter | Type | Description |
21
+ | ---------- | ------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------- |
22
+ | `machine` | [`AnyStateMachine`](https://www.jsdocs.io/package/xstate#AnyStateMachine) | XState v5 state machine with `meta.route` annotations on states. |
23
+ | `options?` | [`RouteMapOptions`](../interfaces/RouteMapOptions.md) | Optional configuration. Pass `{ cacheSize }` to override the default LRU cache size for parameterized path lookups. |
16
24
 
17
25
  ## Returns
18
26
 
19
27
  [`RouteMap`](../classes/RouteMap.md)
28
+
29
+ A `RouteMap` for passing to any `RouterBridgeBase`-based adapter.
30
+
31
+ ## Example
32
+
33
+ ```typescript
34
+ import { createRouteMap } from "@xmachines/play-router";
35
+ import { connectRouter } from "@xmachines/play-dom-router";
36
+
37
+ const routeMap = createRouteMap(myMachine);
38
+ const disconnect = connectRouter({ actor, router, routeMap });
39
+ ```
package/api/@xmachines/play-vue-router/interfaces/PlayRouteEvent.md CHANGED
@@ -2,7 +2,7 @@
2
2
 
3
3
  # Interface: PlayRouteEvent
4
4
 
5
- Defined in: [play-router/src/types.ts:223](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.42/packages/play-router/src/types.ts#L223)
5
+ Defined in: [play-router/src/types.ts:223](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.44/packages/play-router/src/types.ts#L223)
6
6
 
7
7
  Enhanced routing event with parameter and query support
8
8
 
@@ -94,7 +94,7 @@ actor.send(event);
94
94
 
95
95
  ## See
96
96
 
97
- [Play RFC](../../docs/rfc/play.md)
97
+ [Play RFC](../../../../rfc/play.md)
98
98
 
99
99
  ## Remarks
100
100
 
@@ -112,8 +112,8 @@ URLPatternResult for advanced use cases (debugging, pattern analysis).
112
112
 
113
113
  | Property | Modifier | Type | Defined in |
114
114
  | -------------------------------------- | ---------- | ------------------------------ | --------------------------------------------------------------------------------------------------------------------------------------- |
115
- | <a id="property-match"></a> `match?` | `readonly` | `unknown` | [play-router/src/types.ts:228](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.42/packages/play-router/src/types.ts#L228) |
116
- | <a id="property-params"></a> `params?` | `readonly` | `Record`\<`string`, `string`\> | [play-router/src/types.ts:226](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.42/packages/play-router/src/types.ts#L226) |
117
- | <a id="property-query"></a> `query?` | `readonly` | `Record`\<`string`, `string`\> | [play-router/src/types.ts:227](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.42/packages/play-router/src/types.ts#L227) |
118
- | <a id="property-to"></a> `to` | `readonly` | `string` | [play-router/src/types.ts:225](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.42/packages/play-router/src/types.ts#L225) |
119
- | <a id="property-type"></a> `type` | `readonly` | `"play.route"` | [play-router/src/types.ts:224](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.42/packages/play-router/src/types.ts#L224) |
115
+ | <a id="property-match"></a> `match?` | `readonly` | `unknown` | [play-router/src/types.ts:228](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.44/packages/play-router/src/types.ts#L228) |
116
+ | <a id="property-params"></a> `params?` | `readonly` | `Record`\<`string`, `string`\> | [play-router/src/types.ts:226](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.44/packages/play-router/src/types.ts#L226) |
117
+ | <a id="property-query"></a> `query?` | `readonly` | `Record`\<`string`, `string`\> | [play-router/src/types.ts:227](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.44/packages/play-router/src/types.ts#L227) |
118
+ | <a id="property-to"></a> `to` | `readonly` | `string` | [play-router/src/types.ts:225](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.44/packages/play-router/src/types.ts#L225) |
119
+ | <a id="property-type"></a> `type` | `readonly` | `"play.route"` | [play-router/src/types.ts:224](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.44/packages/play-router/src/types.ts#L224) |
package/api/@xmachines/play-vue-router/interfaces/RouteMapOptions.md ADDED
@@ -0,0 +1,13 @@
1
+ [Documentation](../../../README.md) / [@xmachines/play-vue-router](../README.md) / RouteMapOptions
2
+
3
+ # Interface: RouteMapOptions
4
+
5
+ Defined in: [play-router/src/create-route-map.ts:9](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.44/packages/play-router/src/create-route-map.ts#L9)
6
+
7
+ Options for `createRouteMap` and `createRouteMapFromTree`.
8
+
9
+ ## Properties
10
+
11
+ | Property | Type | Description | Defined in |
12
+ | -------------------------------------------- | -------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------- |
13
+ | <a id="property-cachesize"></a> `cacheSize?` | `number` | Maximum number of resolved parameterized path lookups to cache. `RouteMap.getStateIdByPath()` resolves parameterized patterns (e.g. `/profile/:userId`) via URLPattern on every call. Frequently visited paths are cached in an LRU so subsequent lookups are O(1). Increase this value for applications with large parameterized route sets or high navigation frequency. Default: `500`. | [play-router/src/create-route-map.ts:20](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.44/packages/play-router/src/create-route-map.ts#L20) |
package/api/@xmachines/play-vue-router/interfaces/RouteMapping.md CHANGED
@@ -2,7 +2,7 @@
2
2
 
3
3
  # Interface: RouteMapping
4
4
 
5
- Defined in: [play-router/src/base-route-map.ts:57](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.42/packages/play-router/src/base-route-map.ts#L57)
5
+ Defined in: [play-router/src/base-route-map.ts:57](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.44/packages/play-router/src/base-route-map.ts#L57)
6
6
 
7
7
  A single state ID ↔ path mapping entry.
8
8
 
@@ -23,5 +23,5 @@ const optionalMapping: RouteMapping = { stateId: "settings", path: "/settings/:s
23
23
 
24
24
  | Property | Modifier | Type | Description | Defined in |
25
25
  | --------------------------------------- | ---------- | -------- | ----------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------- |
26
- | <a id="property-path"></a> `path` | `readonly` | `string` | URL path pattern (e.g., `"/"`, `"/profile/:userId"`, `"/settings/:section?"`) | [play-router/src/base-route-map.ts:61](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.42/packages/play-router/src/base-route-map.ts#L61) |
27
- | <a id="property-stateid"></a> `stateId` | `readonly` | `string` | State machine state ID (e.g., `"home"`, `"#profile"`) | [play-router/src/base-route-map.ts:59](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.42/packages/play-router/src/base-route-map.ts#L59) |
26
+ | <a id="property-path"></a> `path` | `readonly` | `string` | URL path pattern (e.g., `"/"`, `"/profile/:userId"`, `"/settings/:section?"`) | [play-router/src/base-route-map.ts:61](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.44/packages/play-router/src/base-route-map.ts#L61) |
27
+ | <a id="property-stateid"></a> `stateId` | `readonly` | `string` | State machine state ID (e.g., `"home"`, `"#profile"`) | [play-router/src/base-route-map.ts:59](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.44/packages/play-router/src/base-route-map.ts#L59) |
package/api/@xmachines/play-vue-router/interfaces/RouterBridge.md CHANGED
@@ -2,7 +2,7 @@
2
2
 
3
3
  # Interface: RouterBridge
4
4
 
5
- Defined in: [play-router/src/types.ts:271](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.42/packages/play-router/src/types.ts#L271)
5
+ Defined in: [play-router/src/types.ts:271](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.44/packages/play-router/src/types.ts#L271)
6
6
 
7
7
  RouterBridge interface for runtime infrastructure adapters
8
8
 
@@ -44,7 +44,7 @@ class TanStackRouterBridge implements RouterBridge {
44
44
 
45
45
  ## See
46
46
 
47
- [Play RFC](../../docs/rfc/play.md) - Invariant INV-04
47
+ [Play RFC](../../../../rfc/play.md) - Invariant INV-04
48
48
 
49
49
  ## Methods
50
50
 
@@ -54,7 +54,7 @@ class TanStackRouterBridge implements RouterBridge {
54
54
  connect(): void | Promise<void>;
55
55
  ```
56
56
 
57
- Defined in: [play-router/src/types.ts:287](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.42/packages/play-router/src/types.ts#L287)
57
+ Defined in: [play-router/src/types.ts:287](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.44/packages/play-router/src/types.ts#L287)
58
58
 
59
59
  Connect the router bridge to the Actor
60
60
 
@@ -83,7 +83,7 @@ await bridge.connect();
83
83
  disconnect(): void | Promise<void>;
84
84
  ```
85
85
 
86
- Defined in: [play-router/src/types.ts:303](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.42/packages/play-router/src/types.ts#L303)
86
+ Defined in: [play-router/src/types.ts:303](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.44/packages/play-router/src/types.ts#L303)
87
87
 
88
88
  Disconnect the router bridge from the Actor
89
89
 
package/api/@xmachines/play-vue-router/type-aliases/RoutableActor.md CHANGED
@@ -6,6 +6,6 @@
6
6
  type RoutableActor = AbstractActor<AnyActorLogic> & Routable & Viewable;
7
7
  ```
8
8
 
9
- Defined in: [play-vue-router/src/play-router-provider.ts:10](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.42/packages/play-vue-router/src/play-router-provider.ts#L10)
9
+ Defined in: [play-vue-router/src/play-router-provider.ts:10](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.44/packages/play-vue-router/src/play-router-provider.ts#L10)
10
10
 
11
11
  Minimum actor shape accepted by PlayRouterProvider.
package/api/@xmachines/play-vue-router/variables/PlayRouterProvider.md CHANGED
@@ -64,7 +64,7 @@ const PlayRouterProvider: DefineComponent<
64
64
  >;
65
65
  ```
66
66
 
67
- Defined in: [play-vue-router/src/play-router-provider.ts:19](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.42/packages/play-vue-router/src/play-router-provider.ts#L19)
67
+ Defined in: [play-vue-router/src/play-router-provider.ts:19](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.44/packages/play-vue-router/src/play-router-provider.ts#L19)
68
68
 
69
69
  PlayRouterProvider — Vue convenience wrapper for VueRouterBridge.
70
70
 
package/api/@xmachines/play-xstate/README.md CHANGED
@@ -10,7 +10,7 @@ Transform declarative state machines into live actors with TC39 Signals and para
10
10
 
11
11
  `@xmachines/play-xstate` provides `definePlayer()`, the primary API for binding XState v5 state machines to the Play Architecture actor base. It enables business logic to control routing and state through guard-enforced transitions, signal lifecycle management, and XState DevTools compatibility.
12
12
 
13
- Per [Play RFC](../docs/rfc/play.md), this package implements:
13
+ Per [Play RFC](../../../rfc/play.md), this package implements:
14
14
 
15
15
  - **Actor Authority (INV-01):** State machine guards decide navigation validity
16
16
  - **Strict Separation (INV-02):** Zero React/framework imports in business logic
package/api/@xmachines/play-xstate/classes/PlayerActor.md CHANGED
@@ -2,7 +2,7 @@
2
2
 
3
3
  # Class: PlayerActor\<TMachine\>
4
4
 
5
- Defined in: [packages/play-xstate/src/player-actor.ts:342](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.42/packages/play-xstate/src/player-actor.ts#L342)
5
+ Defined in: [packages/play-xstate/src/player-actor.ts:342](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.44/packages/play-xstate/src/player-actor.ts#L342)
6
6
 
7
7
  Concrete XState actor implementing Play Architecture signal protocol
8
8
 
@@ -65,7 +65,7 @@ actor.send({ type: "play.route", to: "#about" });
65
65
 
66
66
  ## See
67
67
 
68
- - [Play RFC](../../docs/rfc/play.md)
68
+ - [Play RFC](../../../../rfc/play.md)
69
69
  - [definePlayer](../functions/definePlayer.md) for factory creation
70
70
  - [@xmachines/play-actor!AbstractActor](../../play-actor/classes/AbstractActor.md) for signal protocol
71
71
  - [@xmachines/play-actor!Routable](../../play-actor/interfaces/Routable.md) for routing capability
@@ -109,7 +109,7 @@ new PlayerActor<TMachine>(
109
109
  _cachedInitialRoute?): PlayerActor<TMachine>;
110
110
  ```
111
111
 
112
- Defined in: [packages/play-xstate/src/player-actor.ts:434](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.42/packages/play-xstate/src/player-actor.ts#L434)
112
+ Defined in: [packages/play-xstate/src/player-actor.ts:434](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.44/packages/play-xstate/src/player-actor.ts#L434)
113
113
 
114
114
  #### Parameters
115
115
 
@@ -135,16 +135,16 @@ Defined in: [packages/play-xstate/src/player-actor.ts:434](https://gitlab.com/xm
135
135
  | ------------------------------------------------- | ---------- | ----------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | -------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------- |
136
136
  | <a id="property-_parent"></a> `_parent?` | `public` | [`AnyActorRef`](https://www.jsdocs.io/package/xstate#AnyActorRef) | - | - | [`AbstractActor`](../../play-actor/classes/AbstractActor.md).[`_parent`](../../play-actor/classes/AbstractActor.md#property-_parent) | - |
137
137
  | <a id="property-clock"></a> `clock` | `public` | [`Clock`](https://www.jsdocs.io/package/xstate#Clock) | The clock that is responsible for setting and clearing timeouts, such as delayed events and transitions. | - | [`AbstractActor`](../../play-actor/classes/AbstractActor.md).[`clock`](../../play-actor/classes/AbstractActor.md#property-clock) | - |
138
- | <a id="property-currentroute"></a> `currentRoute` | `public` | [`Computed`](../../play-signals/namespaces/Signal/classes/Computed.md)\<`string` \| `null`\> | A TC39 `Signal.Computed` that derives the current URL path from the active machine state's `meta.route` template and the actor's context. Returns `null` when the current state has no `meta.route`, or when the route template cannot be fully resolved (e.g. a required parameter is absent from context). **Throws** When a required `:param` placeholder in the route template has no matching value in the actor's context. Import the class from `@xmachines/play-xstate/errors`. **Example** `// Returns "/profile/alice" when context.userId === "alice" const route = actor.currentRoute.get();` | - | - | [packages/play-xstate/src/player-actor.ts:387](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.42/packages/play-xstate/src/player-actor.ts#L387) |
139
- | <a id="property-currentview"></a> `currentView` | `public` | [`State`](../../play-signals/namespaces/Signal/classes/State.md)\<[`PlaySpec`](../../play-actor/interfaces/PlaySpec.md) \| `null`\> | Reactive signal containing the current view spec derived from the active state's `meta.view` metadata. Always emits a **fresh object reference** on every state transition (including self-transitions with `reenter: true`) so TC39 Signal equality checks reliably detect changes. The emitted `PlaySpec` has its element `props` enriched with `context.params` before emission — URL path parameters (e.g. `:section?`) flow into component props automatically. See `mergeRouteParamsIntoProps` for the merge priority rules. Returns `null` when the current state has no `meta.view` metadata. **Example** `const view = actor.currentView.get(); if (view) { console.log(view.root); // e.g. "root" console.log(view.elements); // @json-render/core Spec elements }` | - | - | [packages/play-xstate/src/player-actor.ts:432](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.42/packages/play-xstate/src/player-actor.ts#L432) |
138
+ | <a id="property-currentroute"></a> `currentRoute` | `public` | [`Computed`](../../play-signals/namespaces/Signal/classes/Computed.md)\<`string` \| `null`\> | A TC39 `Signal.Computed` that derives the current URL path from the active machine state's `meta.route` template and the actor's context. Returns `null` when the current state has no `meta.route`, or when the route template cannot be fully resolved (e.g. a required parameter is absent from context). **Throws** When a required `:param` placeholder in the route template has no matching value in the actor's context. Import the class from `@xmachines/play-xstate/errors`. **Example** `// Returns "/profile/alice" when context.userId === "alice" const route = actor.currentRoute.get();` | - | - | [packages/play-xstate/src/player-actor.ts:387](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.44/packages/play-xstate/src/player-actor.ts#L387) |
139
+ | <a id="property-currentview"></a> `currentView` | `public` | [`State`](../../play-signals/namespaces/Signal/classes/State.md)\<[`PlaySpec`](../../play-actor/interfaces/PlaySpec.md) \| `null`\> | Reactive signal containing the current view spec derived from the active state's `meta.view` metadata. Always emits a **fresh object reference** on every state transition (including self-transitions with `reenter: true`) so TC39 Signal equality checks reliably detect changes. The emitted `PlaySpec` has its element `props` enriched with `context.params` before emission — URL path parameters (e.g. `:section?`) flow into component props automatically. See `mergeRouteParamsIntoProps` for the merge priority rules. Returns `null` when the current state has no `meta.view` metadata. **Example** `const view = actor.currentView.get(); if (view) { console.log(view.root); // e.g. "root" console.log(view.elements); // @json-render/core Spec elements }` | - | - | [packages/play-xstate/src/player-actor.ts:432](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.44/packages/play-xstate/src/player-actor.ts#L432) |
140
140
  | <a id="property-id"></a> `id` | `public` | `string` | The unique identifier for this actor relative to its parent. | - | [`AbstractActor`](../../play-actor/classes/AbstractActor.md).[`id`](../../play-actor/classes/AbstractActor.md#property-id) | - |
141
- | <a id="property-initialroute"></a> `initialRoute` | `readonly` | `string` \| `null` | The route derived from the machine's initial state — fixed at construction, never changes even when the actor is restored from a snapshot. Router bridges compare this against the browser URL to distinguish a deep-link (non-initial URL → router wins) from a restore (initial URL + actor at a different restored route → actor wins). Determined by the machine's initial state node and its `meta.route` template — both are fixed at machine definition time. `definePlayer` pre-computes this value once from the machine definition and passes it to every actor it constructs, so no extra `createActor()` call is needed per construction. When `PlayerActor` is constructed directly (without `definePlayer`), the value is derived from `xstateActor.getSnapshot()` (normal path) or a transient `createActor(machine, { input })` call (restore path, to avoid using the snapshot's state instead of the machine's default). | - | - | [packages/play-xstate/src/player-actor.ts:407](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.42/packages/play-xstate/src/player-actor.ts#L407) |
141
+ | <a id="property-initialroute"></a> `initialRoute` | `readonly` | `string` \| `null` | The route derived from the machine's initial state — fixed at construction, never changes even when the actor is restored from a snapshot. Router bridges compare this against the browser URL to distinguish a deep-link (non-initial URL → router wins) from a restore (initial URL + actor at a different restored route → actor wins). Determined by the machine's initial state node and its `meta.route` template — both are fixed at machine definition time. `definePlayer` pre-computes this value once from the machine definition and passes it to every actor it constructs, so no extra `createActor()` call is needed per construction. When `PlayerActor` is constructed directly (without `definePlayer`), the value is derived from `xstateActor.getSnapshot()` (normal path) or a transient `createActor(machine, { input })` call (restore path, to avoid using the snapshot's state instead of the machine's default). | - | - | [packages/play-xstate/src/player-actor.ts:407](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.44/packages/play-xstate/src/player-actor.ts#L407) |
142
142
  | <a id="property-logic"></a> `logic` | `public` | [`AnyActorLogic`](https://www.jsdocs.io/package/xstate#AnyActorLogic) | - | - | [`AbstractActor`](../../play-actor/classes/AbstractActor.md).[`logic`](../../play-actor/classes/AbstractActor.md#property-logic) | - |
143
143
  | <a id="property-options"></a> `options` | `public` | `Readonly`\<[`ActorOptions`](https://www.jsdocs.io/package/xstate#ActorOptions)\<`TLogic`\>\> | - | - | [`AbstractActor`](../../play-actor/classes/AbstractActor.md).[`options`](../../play-actor/classes/AbstractActor.md#property-options) | - |
144
144
  | <a id="property-ref"></a> `ref` | `public` | [`ActorRef`](https://www.jsdocs.io/package/xstate#ActorRef)\<`any`, `any`, `any`\> | - | - | [`AbstractActor`](../../play-actor/classes/AbstractActor.md).[`ref`](../../play-actor/classes/AbstractActor.md#property-ref) | - |
145
145
  | <a id="property-sessionid"></a> `sessionId` | `public` | `string` | The globally unique process ID for this invocation. | - | [`AbstractActor`](../../play-actor/classes/AbstractActor.md).[`sessionId`](../../play-actor/classes/AbstractActor.md#property-sessionid) | - |
146
146
  | <a id="property-src"></a> `src` | `public` | \| `string` \| [`AnyActorLogic`](https://www.jsdocs.io/package/xstate#AnyActorLogic) | - | - | [`AbstractActor`](../../play-actor/classes/AbstractActor.md).[`src`](../../play-actor/classes/AbstractActor.md#property-src) | - |
147
- | <a id="property-state"></a> `state` | `public` | [`State`](../../play-signals/namespaces/Signal/classes/State.md)\<`ReturnType`\<`TMachine`\[`"transition"`\]\>\> | Reactive snapshot of current actor state. Infrastructure observes this signal to react to state changes without directly coupling to the actor's internal state machine implementation. | [`AbstractActor`](../../play-actor/classes/AbstractActor.md).[`state`](../../play-actor/classes/AbstractActor.md#property-state) | - | [packages/play-xstate/src/player-actor.ts:352](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.42/packages/play-xstate/src/player-actor.ts#L352) |
147
+ | <a id="property-state"></a> `state` | `public` | [`State`](../../play-signals/namespaces/Signal/classes/State.md)\<`ReturnType`\<`TMachine`\[`"transition"`\]\>\> | Reactive snapshot of current actor state. Infrastructure observes this signal to react to state changes without directly coupling to the actor's internal state machine implementation. | [`AbstractActor`](../../play-actor/classes/AbstractActor.md).[`state`](../../play-actor/classes/AbstractActor.md#property-state) | - | [packages/play-xstate/src/player-actor.ts:352](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.44/packages/play-xstate/src/player-actor.ts#L352) |
148
148
  | <a id="property-system"></a> `system` | `public` | [`AnyActorSystem`](https://www.jsdocs.io/package/xstate#AnyActorSystem) | The system to which this actor belongs. | - | [`AbstractActor`](../../play-actor/classes/AbstractActor.md).[`system`](../../play-actor/classes/AbstractActor.md#property-system) | - |
149
149
  | <a id="property-systemid"></a> `systemId` | `public` | `string` \| `undefined` | - | - | [`AbstractActor`](../../play-actor/classes/AbstractActor.md).[`systemId`](../../play-actor/classes/AbstractActor.md#property-systemid) | - |
150
150
 
@@ -174,7 +174,7 @@ Defined in: `xstate`
174
174
  can(event): boolean;
175
175
  ```
176
176
 
177
- Defined in: [packages/play-xstate/src/player-actor.ts:365](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.42/packages/play-xstate/src/player-actor.ts#L365)
177
+ Defined in: [packages/play-xstate/src/player-actor.ts:365](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.44/packages/play-xstate/src/player-actor.ts#L365)
178
178
 
179
179
  Returns whether the actor's current state can accept the given event.
180
180
 
@@ -205,7 +205,7 @@ if (actor.can({ type: "auth.logout" })) { ... }
205
205
  dispose(): void;
206
206
  ```
207
207
 
208
- Defined in: [packages/play-xstate/src/player-actor.ts:647](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.42/packages/play-xstate/src/player-actor.ts#L647)
208
+ Defined in: [packages/play-xstate/src/player-actor.ts:647](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.44/packages/play-xstate/src/player-actor.ts#L647)
209
209
 
210
210
  Convenience dispose method for cleanup
211
211
 
@@ -257,7 +257,7 @@ https://stately.ai/docs/persistence
257
257
  getSnapshot(): SnapshotFrom<TMachine>;
258
258
  ```
259
259
 
260
- Defined in: [packages/play-xstate/src/player-actor.ts:616](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.42/packages/play-xstate/src/player-actor.ts#L616)
260
+ Defined in: [packages/play-xstate/src/player-actor.ts:616](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.44/packages/play-xstate/src/player-actor.ts#L616)
261
261
 
262
262
  Get current snapshot
263
263
 
@@ -339,7 +339,7 @@ Defined in: `xstate`
339
339
  send(event): void;
340
340
  ```
341
341
 
342
- Defined in: [packages/play-xstate/src/player-actor.ts:593](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.42/packages/play-xstate/src/player-actor.ts#L593)
342
+ Defined in: [packages/play-xstate/src/player-actor.ts:593](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.44/packages/play-xstate/src/player-actor.ts#L593)
343
343
 
344
344
  Send an event to the underlying XState actor.
345
345
 
@@ -383,7 +383,7 @@ actor.send({ type: "play.route", to: "#home" });
383
383
  start(): this;
384
384
  ```
385
385
 
386
- Defined in: [packages/play-xstate/src/player-actor.ts:547](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.42/packages/play-xstate/src/player-actor.ts#L547)
386
+ Defined in: [packages/play-xstate/src/player-actor.ts:547](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.44/packages/play-xstate/src/player-actor.ts#L547)
387
387
 
388
388
  Start the actor
389
389
 
@@ -405,7 +405,7 @@ Per RESEARCH.md Pitfall 1: Always call start() after creation
405
405
  stop(): this;
406
406
  ```
407
407
 
408
- Defined in: [packages/play-xstate/src/player-actor.ts:561](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.42/packages/play-xstate/src/player-actor.ts#L561)
408
+ Defined in: [packages/play-xstate/src/player-actor.ts:561](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.44/packages/play-xstate/src/player-actor.ts#L561)
409
409
 
410
410
  Stop the actor and cleanup
411
411
 
package/api/@xmachines/play-xstate/functions/buildRouteUrl.md CHANGED
@@ -6,7 +6,7 @@
6
6
  function buildRouteUrl(routeTemplate, context?): string;
7
7
  ```
8
8
 
9
- Defined in: [packages/play-xstate/src/routing/build-url.ts:40](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.42/packages/play-xstate/src/routing/build-url.ts#L40)
9
+ Defined in: [packages/play-xstate/src/routing/build-url.ts:40](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.44/packages/play-xstate/src/routing/build-url.ts#L40)
10
10
 
11
11
  Build a full URL from a route template and the actor's context.
12
12