@xmachines/play-solid 1.0.0-beta.3 → 1.0.0-beta.5

package/dist/PlayRenderer.d.ts

@@ -0,0 +1,63 @@
+/**
+ * PlayRenderer - Main SolidJS renderer component for XMachines Play architecture
+ *
+ * @packageDocumentation
+ */
+import { type Component } from "solid-js";
+import type { PlayRendererProps } from "./types.js";
+/**
+ * Main renderer component that subscribes to actor signals and renders UI
+ *
+ * Architecture (per XMachines Play patterns):
+ * - Subscribes to actor.currentView signal via TC39 Signal.subtle.Watcher
+ * - Dynamically renders catalog components based on view.component string
+ * - Forwards user events to actor via actor.send()
+ * - SolidJS signal only for triggering renders, NOT business logic
+ *
+ * Invariant: Actor Authority - Actor decides all state transitions via guards.
+ * Invariant: Passive Infrastructure - Component observes signals and sends events.
+ * Invariant: Signal-Only Reactivity - Business logic state lives in actor signals.
+ *
+ * @example
+ * ```typescript
+ * import { PlayRenderer } from "@xmachines/play-solidjs";
+ * import { definePlayer } from "@xmachines/play-xstate";
+ *
+ * const actor = definePlayer({ machine, catalog })();
+ * actor.start();
+ *
+ * const components = {
+ *   Dashboard: (props) => <div>User: {props.userId}</div>,
+ *   LoginForm: (props) => (
+ *     <form onSubmit={(e) => {
+ *       e.preventDefault();
+ *       props.send({ type: "auth.login", payload: {...} });
+ *     }}>...</form>
+ *   )
+ * };
+ *
+ * <PlayRenderer actor={actor} components={components} />
+ * ```
+ *
+ * @param props - Component props
+ * @returns SolidJS element rendering current view from actor
+ *
+ * @remarks
+ * **Component lookup:** Dynamically looks up component from `components` map
+ * using `view.component` string from actor.currentView signal.
+ *
+ * **Event forwarding:** Injects `send` function as prop to components. Components
+ * call `send(event)` to forward intents to actor. Actor guards decide validity.
+ *
+ * **Error handling:** If component not found in catalog, logs error and shows
+ * fallback. This indicates missing component registration, not runtime error.
+ *
+ * **Signal bridge:** Uses one-shot re-watch pattern. TC39 Signal watchers stop
+ * watching after notification, so watcher.watch() must be called in microtask
+ * after getPending() to re-arm for next notification.
+ *
+ * **CRITICAL:** Never call actor.send() during render - only in event handlers.
+ * Calling send during render causes infinite render loops.
+ */
+export declare const PlayRenderer: Component<PlayRendererProps>;
+//# sourceMappingURL=PlayRenderer.d.ts.map

package/dist/PlayRenderer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PlayRenderer.d.ts","sourceRoot":"","sources":["../src/PlayRenderer.tsx"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAyB,KAAK,SAAS,EAAE,MAAM,UAAU,CAAC;AAGjE,OAAO,KAAK,EAAE,iBAAiB,EAAa,MAAM,YAAY,CAAC;AAE/D;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqDG;AACH,eAAO,MAAM,YAAY,EAAE,SAAS,CAAC,iBAAiB,CA2ErD,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * SolidJS renderer for XMachines Play architecture
+ *
+ * @packageDocumentation
+ */
+export { PlayRenderer } from "./PlayRenderer.js";
+export type { PlayRendererProps } from "./types.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,YAAY,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC"}

package/dist/types.d.ts

@@ -0,0 +1,28 @@
+/**
+ * TypeScript type definitions for play-solidjs
+ *
+ * @packageDocumentation
+ */
+import type { AbstractActor, Viewable } from "@xmachines/play-actor";
+import type { JSX, ValidComponent } from "solid-js";
+import type { AnyActorLogic } from "xstate";
+export type SolidView = {
+    component: string;
+    props: Record<string, unknown>;
+} | null;
+/**
+ * Props for PlayRenderer component
+ *
+ * @property actor - Actor instance with currentView signal (requires Viewable capability)
+ * @property components - Map of component names to SolidJS components
+ * @property fallback - Optional element shown when currentView is null
+ */
+export interface PlayRendererProps {
+    /** Actor instance with currentView signal (requires Viewable capability) */
+    actor: AbstractActor<AnyActorLogic> & Viewable;
+    /** Map of component names to SolidJS components */
+    components: Record<string, ValidComponent>;
+    /** Optional element shown when currentView is null */
+    fallback?: JSX.Element;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AACrE,OAAO,KAAK,EAAE,GAAG,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AACpD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,QAAQ,CAAC;AAE5C,MAAM,MAAM,SAAS,GAAG;IAAE,SAAS,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAAE,GAAG,IAAI,CAAC;AAErF;;;;;;GAMG;AACH,MAAM,WAAW,iBAAiB;IACjC,4EAA4E;IAC5E,KAAK,EAAE,aAAa,CAAC,aAAa,CAAC,GAAG,QAAQ,CAAC;IAE/C,mDAAmD;IACnD,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;IAE3C,sDAAsD;IACtD,QAAQ,CAAC,EAAE,GAAG,CAAC,OAAO,CAAC;CACvB"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@xmachines/play-solid",
-  "version": "1.0.0-beta.3",
+  "version": "1.0.0-beta.5",
   "description": "SolidJS renderer for XMachines Play architecture",
   "keywords": [
     "catalog",
@@ -37,13 +37,14 @@
     "prepublishOnly": "npm run build"
   },
   "dependencies": {
-    "@xmachines/play-actor": "1.0.0-beta.3",
-    "@xmachines/play-catalog": "1.0.0-beta.3",
-    "@xmachines/play-signals": "1.0.0-beta.3"
+    "@xmachines/play-actor": "1.0.0-beta.5",
+    "@xmachines/play-catalog": "1.0.0-beta.5",
+    "@xmachines/play-signals": "1.0.0-beta.5"
   },
   "devDependencies": {
     "@solidjs/testing-library": "^0.8.10",
     "@types/node": "^25.5.0",
+    "@xmachines/shared": "1.0.0-beta.5",
     "solid-js": "^1.9.11",
     "typescript": "^5.9.3",
     "vite": "^8.0.0",