@xmachines/play-vue 5.0.2 → 6.1.0

package/README.md

@@ -2,7 +2,7 @@
 
 > Vue 3 renderer for the XMachines Play Architecture. It observes the actor atoms and renders the UI through `@xmachines/json-render-vue`.
 
-[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT) [![Version](https://img.shields.io/badge/version-5.0.2-blue)](https://www.npmjs.com/package/@xmachines/play-vue)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT) [![Version](https://img.shields.io/badge/version-6.1.0-blue)](https://www.npmjs.com/package/@xmachines/play-vue)
 
 ---
 
@@ -27,7 +27,7 @@ pnpm add @xmachines/play-vue
 **Peer dependencies.** Install them with the package:
 
 ```bash
-pnpm add vue@^3.5.0 @xmachines/play @xmachines/play-atom @xstate/store@^4.2.3 @xmachines/json-render-vue@^0.20.0-xm.4 @xmachines/json-render-core@^0.20.0-xm.4 @xmachines/json-render-xstate@^0.20.0-xm.4
+pnpm add vue@^3.5.0 @xmachines/core @xmachines/play @xmachines/play-atom @xstate/store@^4.2.3 @xmachines/json-render-vue@^0.21.0-xm.2 @xmachines/json-render-core@^0.21.0-xm.2 @xmachines/json-render-xstate@^0.21.0-xm.2
 ```
 
 `@xstate/store` is the peer of [`@xmachines/play-atom`](../play-atom/README.md), and not of this
@@ -98,11 +98,11 @@ The composite provider. It wraps `<ActorProvider>` and `JSONUIProvider` in one c
 
 The provider contains an error of the **render** of a descendant — the render function, the setup function, and a lifecycle hook — so that a subtree that throws cannot take the whole application down. It calls `onError`, and it renders the `fallback` slot instead of the children. The next view emission clears the error, so a view transition retries the render. A throw of a catalog component reaches the per-element boundary of `@xmachines/json-render-vue` first, and `onRenderError` reports it; this boundary is the outer net for everything else.
 
-The boundary stops a render error, so `app.config.errorHandler` sees it no longer. Without an `onError` prop the provider therefore writes the error to `console.error`.
+The boundary stops a render error, so `app.config.errorHandler` does not see it. Without an `onError` prop the provider therefore writes the error to `console.error`.
 
 The second parameter is the **reset**, for a retry that the host starts. It renders the view that the actor holds at the moment of the call, so a retry cannot rewind the screen to the view that failed. A reset that the host calls from inside the handler does nothing, because no input changed between the two attempts, and a reset after the provider goes away does nothing. The five renderers hold the same three rules.
 
-**A handler that throws reaches no caller.** The provider contains that throw, and it writes the throw to `console.error`. The errored flag schedules a render, so a throw that left the handler would stop that render and skip the `return false` of `onErrorCaptured`: the subtree that threw stays on the screen and the error reaches `app.config.errorHandler` as well. Report a failure from `onError`. To escalate one, raise it from a task of your own — `queueMicrotask(() => { throw error; })` — which reaches the global handler of the page and leaves the containment whole. The five renderers hold this one rule.
+**A handler that throws reaches no caller.** The provider contains that throw, and it writes the throw to `console.error`. The errored flag schedules a render, so a throw that left the handler would stop that render and skip the `return false` of `onErrorCaptured`: the subtree that threw stays on the screen and the error reaches `app.config.errorHandler` as well. Report a failure from `onError`. To escalate one, raise it from a task of your own — `rethrowLater(error)` of [`@xmachines/core/utils`](../core/README.md) — which reaches the global handler of the page and leaves the containment whole. Install that package next to this one, because your code imports it and a package manager such as pnpm does not let your code import a package that it does not declare. The five renderers hold this one rule.
 
 `onErrorCaptured` of Vue also fires for an error of an **event handler** and of a **watcher callback**, which the boundaries of React, Solid, and Svelte each see never. The provider leaves such an error alone: the view stays on the screen, `onError` stays silent, and the error continues to `app.config.errorHandler` exactly as it does without this provider. A click handler that throws therefore does not replace your view with the fallback, and it reaches your global handler one time. `onError` reports a failure of the render, in every renderer.
 
@@ -195,8 +195,6 @@ const view = usePlayView();
 
 `usePlayView()` returns a **Proxy**: every property read goes to the live context of the provider.
 
-> **Note:** `usePlayView` was named `getPlayViewContext` before. That alias is gone.
-
 ---
 
 ### Re-exported from `@xmachines/json-render-vue`

package/dist/ActorProvider.js

@@ -1,13 +1,6 @@
 import "./actor-provider-context.js";
 import ActorProvider_vue_vue_type_script_lang_default from "./ActorProvider.vue_vue_type_script_lang.js";
-import { useSSRContext } from "vue";
 //#region packages/play-vue/src/ActorProvider.vue
-var _sfc_setup = ActorProvider_vue_vue_type_script_lang_default.setup;
-ActorProvider_vue_vue_type_script_lang_default.setup = (props, ctx) => {
-	const ssrContext = useSSRContext();
-	(ssrContext.modules || (ssrContext.modules = /* @__PURE__ */ new Set())).add("packages/play-vue/src/ActorProvider.vue");
-	return _sfc_setup ? _sfc_setup(props, ctx) : void 0;
-};
 var ActorProvider_default = ActorProvider_vue_vue_type_script_lang_default;
 //#endregion
 export { ActorProvider_default as default };

package/dist/PlayRenderer.js

@@ -1,12 +1,5 @@
 import PlayRenderer_vue_vue_type_script_lang_default from "./PlayRenderer.vue_vue_type_script_lang.js";
-import { useSSRContext } from "vue";
 //#region packages/play-vue/src/PlayRenderer.vue
-var _sfc_setup = PlayRenderer_vue_vue_type_script_lang_default.setup;
-PlayRenderer_vue_vue_type_script_lang_default.setup = (props, ctx) => {
-	const ssrContext = useSSRContext();
-	(ssrContext.modules || (ssrContext.modules = /* @__PURE__ */ new Set())).add("packages/play-vue/src/PlayRenderer.vue");
-	return _sfc_setup ? _sfc_setup(props, ctx) : void 0;
-};
 var PlayRenderer_default = PlayRenderer_vue_vue_type_script_lang_default;
 //#endregion
 export { PlayRenderer_default as default };

package/dist/PlayUIProvider.js

@@ -1,12 +1,5 @@
 import PlayUIProvider_vue_vue_type_script_lang_default from "./PlayUIProvider.vue_vue_type_script_lang.js";
-import { useSSRContext } from "vue";
 //#region packages/play-vue/src/PlayUIProvider.vue
-var _sfc_setup = PlayUIProvider_vue_vue_type_script_lang_default.setup;
-PlayUIProvider_vue_vue_type_script_lang_default.setup = (props, ctx) => {
-	const ssrContext = useSSRContext();
-	(ssrContext.modules || (ssrContext.modules = /* @__PURE__ */ new Set())).add("packages/play-vue/src/PlayUIProvider.vue");
-	return _sfc_setup ? _sfc_setup(props, ctx) : void 0;
-};
 var PlayUIProvider_default = PlayUIProvider_vue_vue_type_script_lang_default;
 //#endregion
 export { PlayUIProvider_default as default };

package/dist/types.d.ts

@@ -47,7 +47,7 @@ export interface ActorProviderProps extends BaseActorProviderProps<DefineRegistr
      * `currentView` changes), so a view transition retries the render.
      *
      * The boundary stops the error. Without this prop the provider therefore writes the
-     * error to `console.error`, because `app.config.errorHandler` sees it no longer.
+     * error to `console.error`, because `app.config.errorHandler` does not see it.
      *
      * Element-level catalog component throws are caught upstream by the per-element
      * boundary of @json-render, and reported through `onRenderError`. This boundary is
@@ -68,8 +68,9 @@ export interface ActorProviderProps extends BaseActorProviderProps<DefineRegistr
      * `app.config.errorHandler`.
      *
      * Report a failure from this handler. To ESCALATE one, raise it from a task of your
-     * own — `queueMicrotask(() => { throw error; })` — which reaches the global handler of
-     * the page and leaves the containment whole. The five renderers hold this one rule.
+     * own — `rethrowLater(error)` of `@xmachines/core/utils` — which reaches the global handler of
+     * the page and leaves the containment whole. The host installs `@xmachines/core` itself.
+     * The five renderers hold this one rule.
      */
     onError?: (error: unknown, reset: () => void) => void;
 }

package/dist/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,4BAA4B,CAAC;AACvE,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,sBAAsB,CAAC;AAEnE;;;;;;;;GAQG;AACH,MAAM,WAAW,kBAAmB,SAAQ,sBAAsB,CAAC,oBAAoB,CAAC;IACvF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAuDG;IACH,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,IAAI,KAAK,IAAI,CAAC;CACtD;AAED;;GAEG;AACH,YAAY,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AAErE,MAAM,WAAW,mBAAoB,SAAQ,kBAAkB;IAC9D,uGAAuG;IACvG,QAAQ,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IAClC,0EAA0E;IAC1E,mBAAmB,CAAC,EAAE,MAAM,CAC3B,MAAM,EACN,CAAC,KAAK,EAAE,OAAO,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,OAAO,CAC3D,CAAC;IACF,8DAA8D;IAC9D,SAAS,CAAC,EAAE,MAAM,CACjB,MAAM,EACN,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,OAAO,CAC5E,CAAC;CACF"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,4BAA4B,CAAC;AACvE,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,sBAAsB,CAAC;AAEnE;;;;;;;;GAQG;AACH,MAAM,WAAW,kBAAmB,SAAQ,sBAAsB,CAAC,oBAAoB,CAAC;IACvF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAwDG;IACH,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,IAAI,KAAK,IAAI,CAAC;CACtD;AAED;;GAEG;AACH,YAAY,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AAErE,MAAM,WAAW,mBAAoB,SAAQ,kBAAkB;IAC9D,uGAAuG;IACvG,QAAQ,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IAClC,0EAA0E;IAC1E,mBAAmB,CAAC,EAAE,MAAM,CAC3B,MAAM,EACN,CAAC,KAAK,EAAE,OAAO,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,OAAO,CAC3D,CAAC;IACF,8DAA8D;IAC9D,SAAS,CAAC,EAAE,MAAM,CACjB,MAAM,EACN,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,OAAO,CAC5E,CAAC;CACF"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@xmachines/play-vue",
-  "version": "5.0.2",
+  "version": "6.1.0",
   "description": "Vue renderer for XMachines Play architecture",
   "keywords": [
     "reactive",
@@ -46,8 +46,8 @@
     "test:watch": "vitest"
   },
   "dependencies": {
-    "@xmachines/play-actor": "5.0.2",
-    "@xmachines/play-view": "5.0.2"
+    "@xmachines/play-actor": "6.1.0",
+    "@xmachines/play-view": "6.1.0"
   },
   "devDependencies": {
     "@testing-library/jest-dom": "^7.0.1",
@@ -55,11 +55,11 @@
     "@vitejs/plugin-vue": "^6.0.9",
     "@vitest/browser-playwright": "^5.0.1",
     "@vue/test-utils": "^2.5.0",
-    "@xmachines/json-render-core": "^0.20.0-xm.4",
-    "@xmachines/json-render-vue": "^0.20.0-xm.4",
-    "@xmachines/json-render-xstate": "^0.20.0-xm.4",
-    "@xmachines/play": "5.0.2",
-    "@xmachines/play-atom": "5.0.2",
+    "@xmachines/json-render-core": "^0.21.0-xm.2",
+    "@xmachines/json-render-vue": "^0.21.0-xm.2",
+    "@xmachines/json-render-xstate": "^0.21.0-xm.2",
+    "@xmachines/play": "6.1.0",
+    "@xmachines/play-atom": "6.1.0",
     "oxfmt": "^0.70.0",
     "oxlint": "^1.85.0",
     "typescript": "^5.9.3 || ^6.0.3",
@@ -71,11 +71,11 @@
     "zod": "^4.6.5"
   },
   "peerDependencies": {
-    "@xmachines/json-render-core": "^0.20.0-xm.4",
-    "@xmachines/json-render-vue": "^0.20.0-xm.4",
-    "@xmachines/json-render-xstate": "^0.20.0-xm.4",
-    "@xmachines/play": "5.0.2",
-    "@xmachines/play-atom": "5.0.2",
+    "@xmachines/json-render-core": "^0.21.0-xm.2",
+    "@xmachines/json-render-vue": "^0.21.0-xm.2",
+    "@xmachines/json-render-xstate": "^0.21.0-xm.2",
+    "@xmachines/play": "6.1.0",
+    "@xmachines/play-atom": "6.1.0",
     "vue": "^3.5.0"
   },
   "engines": {