@xmachines/docs 1.0.0-beta.33 → 1.0.0-beta.35

package/api/@xmachines/play-svelte/interfaces/PlayRendererProps.md

@@ -1,22 +0,0 @@
-[Documentation](../../../README.md) / [@xmachines/play-svelte](../README.md) / PlayRendererProps
-
-# Interface: PlayRendererProps\<TLogic\>
-
-Defined in: [packages/play-svelte/src/types.ts:13](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.33/packages/play-svelte/src/types.ts#L13)
-
-## Type Parameters
-
-| Type Parameter                                                                           | Default type                                                          |
-| ---------------------------------------------------------------------------------------- | --------------------------------------------------------------------- |
-| `TLogic` _extends_ [`AnyActorLogic`](https://www.jsdocs.io/package/xstate#AnyActorLogic) | [`AnyActorLogic`](https://www.jsdocs.io/package/xstate#AnyActorLogic) |
-
-## Properties
-
-| Property                                              | Type                                                                                                                                                                                                | Description                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              | Defined in                                                                                                                                     |
-| ----------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------- |
-| <a id="property-actor"></a> `actor`                   | [`AbstractActor`](../../play-actor/classes/AbstractActor.md)\<`TLogic`, [`EventObject`](https://www.jsdocs.io/package/xstate#EventObject)\> & [`Viewable`](../../play-actor/interfaces/Viewable.md) | -                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        | [packages/play-svelte/src/types.ts:14](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.33/packages/play-svelte/src/types.ts#L14) |
-| <a id="property-fallback"></a> `fallback?`            | `Snippet`\<\[\]\>                                                                                                                                                                                   | Svelte snippet rendered when currentView is null (no active view). Also shown when a catalog component throws during render.                                                                                                                                                                                                                                                                                                                                                                                                                                                                             | [packages/play-svelte/src/types.ts:29](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.33/packages/play-svelte/src/types.ts#L29) |
-| <a id="property-onerror"></a> `onError?`              | (`error`, `reset`) => `void`                                                                                                                                                                        | Called when a catalog component throws during render. Receives the thrown error and a `reset` function that clears the boundary and attempts to re-render. Matches Svelte 5's `<svelte:boundary onerror>` signature.                                                                                                                                                                                                                                                                                                                                                                                     | [packages/play-svelte/src/types.ts:36](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.33/packages/play-svelte/src/types.ts#L36) |
-| <a id="property-onrendererror"></a> `onRenderError?`  | [`RenderErrorHandler`](../type-aliases/RenderErrorHandler.md)                                                                                                                                       | Called when an individual catalog component throws during render. Caught by the inner `<svelte:boundary>` inside each rendered element — the failed component is silently removed from the DOM while the rest of the spec continues rendering. Unlike `onError`, this does not take a `reset` callback because the inner boundary never re-renders the failed element. When not provided, `@json-render/svelte` logs the error to `console.error`. **Example** `<PlayRenderer {actor} {registryResult} onRenderError={(error, elementType) => { console.warn(`<${elementType}> crashed:`, error); }} />` | [packages/play-svelte/src/types.ts:60](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.33/packages/play-svelte/src/types.ts#L60) |
-| <a id="property-registryresult"></a> `registryResult` | `DefineRegistryResult`                                                                                                                                                                              | Full result from defineRegistry() — contains component registry and action handlers. Action handlers are async functions that dispatch to the actor (not string-mapped event type stubs). Replaces the old `registry` + `actions` prop pair.                                                                                                                                                                                                                                                                                                                                                             | [packages/play-svelte/src/types.ts:21](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.33/packages/play-svelte/src/types.ts#L21) |
-| <a id="property-store"></a> `store?`                  | `StateStore`                                                                                                                                                                                        | -                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        | [packages/play-svelte/src/types.ts:23](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.33/packages/play-svelte/src/types.ts#L23) |

package/api/@xmachines/play-svelte/variables/getBoundProp.md

@@ -1,7 +0,0 @@
-[Documentation](../../../README.md) / [@xmachines/play-svelte](../README.md) / getBoundProp
-
-# Variable: getBoundProp
-
-```ts
-getBoundProp: any;
-```

package/api/@xmachines/play-vue/interfaces/PlayRendererProps.md

@@ -1,22 +0,0 @@
-[Documentation](../../../README.md) / [@xmachines/play-vue](../README.md) / PlayRendererProps
-
-# Interface: PlayRendererProps\<TLogic\>
-
-Defined in: [packages/play-vue/src/types.ts:23](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.33/packages/play-vue/src/types.ts#L23)
-
-Props for PlayRenderer component
-
-## Type Parameters
-
-| Type Parameter                                                                           | Default type                                                          | Description                                                                     |
-| ---------------------------------------------------------------------------------------- | --------------------------------------------------------------------- | ------------------------------------------------------------------------------- |
-| `TLogic` _extends_ [`AnyActorLogic`](https://www.jsdocs.io/package/xstate#AnyActorLogic) | [`AnyActorLogic`](https://www.jsdocs.io/package/xstate#AnyActorLogic) | The XState actor logic type. Defaults to `AnyActorLogic` for non-generic usage. |
-
-## Properties
-
-| Property                                              | Type                                                                                                                                                                                                | Description                                                                                                                                                                                                                                                                                                                                                               | Defined in                                                                                                                               |
-| ----------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------- |
-| <a id="property-actor"></a> `actor`                   | [`AbstractActor`](../../play-actor/classes/AbstractActor.md)\<`TLogic`, [`EventObject`](https://www.jsdocs.io/package/xstate#EventObject)\> & [`Viewable`](../../play-actor/interfaces/Viewable.md) | Actor instance with currentView signal (requires Viewable capability)                                                                                                                                                                                                                                                                                                     | [packages/play-vue/src/types.ts:25](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.33/packages/play-vue/src/types.ts#L25) |
-| <a id="property-onrendererror"></a> `onRenderError?`  | [`RenderErrorHandler`](../type-aliases/RenderErrorHandler.md)                                                                                                                                       | Called when an individual catalog component throws during render. Caught by the inner error boundary inside each rendered element — the failed component is silently removed while the rest of the spec continues rendering. Takes precedence over any `onRenderError` set via `defineRegistry`. When not provided, `@json-render/vue` logs the error to `console.error`. | [packages/play-vue/src/types.ts:52](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.33/packages/play-vue/src/types.ts#L52) |
-| <a id="property-registryresult"></a> `registryResult` | `DefineRegistryResult`                                                                                                                                                                              | Full result from defineRegistry() in @json-render/vue. Contains both the component registry and the action handlers factory. Action handlers are real async functions dispatching to the actor (not string-mapped event types).                                                                                                                                           | [packages/play-vue/src/types.ts:32](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.33/packages/play-vue/src/types.ts#L32) |
-| <a id="property-store"></a> `store?`                  | `StateStore`                                                                                                                                                                                        | Optional external StateStore (e.g. from `xstateStoreStateStore` in @json-render/xstate). When provided, PlayRenderer operates in controlled mode — spec.state is ignored and this store is the single source of truth for UI state (form values, etc.). When omitted, a fresh @xstate/store atom is created internally per view transition, seeded from spec.state.       | [packages/play-vue/src/types.ts:41](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.33/packages/play-vue/src/types.ts#L41) |

package/api/@xmachines/play-vue-router/classes/VueBaseRouteMap.md

@@ -1,141 +0,0 @@
-[Documentation](../../../README.md) / [@xmachines/play-vue-router](../README.md) / VueBaseRouteMap
-
-# Class: VueBaseRouteMap
-
-Defined in: [play-router/src/base-route-map.ts:100](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.33/packages/play-router/src/base-route-map.ts#L100)
-
-Shared bidirectional route map base class.
-
-All framework adapter `RouteMap` classes extend this — they add no logic of their
-own and inherit the full public API from here.
-
-**Lookup strategy:**
-
-- Static paths (no `:param`) → O(1) `Map` lookup
-- Dynamic paths → O(k) bucket-indexed scan using `URLPattern`, where `k` is the number
-  of routes sharing the same first path segment
-- Results are cached after the first match in an LRU cache (default 500 entries,
-  configurable via the `cacheSize` constructor option)
-
-**Pattern syntax** (`:param` / `:param?`):
-
-- `:param` — required segment, matches exactly one non-`/` segment
-- `:param?` — optional segment, matches zero or one non-`/` segment
-
-## Example
-
-```typescript
-import { BaseRouteMap } from "@xmachines/play-router";
-
-const map = new BaseRouteMap([
-	{ stateId: "home", path: "/" },
-	{ stateId: "profile", path: "/profile/:userId" },
-	{ stateId: "settings", path: "/settings/:section?" },
-]);
-
-map.getStateIdByPath("/"); // "home"
-map.getStateIdByPath("/profile/123"); // "profile"
-map.getStateIdByPath("/settings"); // "settings"
-map.getStateIdByPath("/unknown"); // null
-
-map.getPathByStateId("profile"); // "/profile/:userId"
-map.getPathByStateId("missing"); // null
-```
-
-## Extended by
-
-- [`RouteMap`](RouteMap.md)
-
-## Constructors
-
-### Constructor
-
-```ts
-new VueBaseRouteMap(mappings, options?): BaseRouteMap;
-```
-
-Defined in: [play-router/src/base-route-map.ts:125](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.33/packages/play-router/src/base-route-map.ts#L125)
-
-Build a route map from an array of state ID ↔ path mappings.
-
-Static paths (no `:param`) are indexed in an O(1) `Map`.
-Parameterized paths are compiled to `URLPattern` and grouped into first-segment
-buckets for efficient candidate selection.
-
-#### Parameters
-
-| Parameter            | Type                                              | Description                                                                                                                                                                                                                                                                                                                                                                                                  |
-| -------------------- | ------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
-| `mappings`           | [`RouteMapping`](../interfaces/RouteMapping.md)[] | Array of `{ stateId, path }` entries. Order determines priority when multiple patterns could match the same path.                                                                                                                                                                                                                                                                                            |
-| `options`            | \{ `cacheSize?`: `number`; \}                     | Optional configuration. `options.cacheSize`: Maximum number of resolved parameterized path lookups to cache. Defaults to `500`. Increase for applications with many unique parameterized URL values (e.g. user profile pages with thousands of distinct IDs). After eviction the path falls back to the O(k) bucket pattern scan — correct but slower. Minimum effective value is `1` (QuickLRU constraint). |
-| `options.cacheSize?` | `number`                                          | -                                                                                                                                                                                                                                                                                                                                                                                                            |
-
-#### Returns
-
-`BaseRouteMap`
-
-## Methods
-
-### getPathByStateId()
-
-```ts
-getPathByStateId(stateId): string | null;
-```
-
-Defined in: [play-router/src/base-route-map.ts:209](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.33/packages/play-router/src/base-route-map.ts#L209)
-
-Look up the path pattern registered for a state ID.
-
-#### Parameters
-
-| Parameter | Type     | Description                                               |
-| --------- | -------- | --------------------------------------------------------- |
-| `stateId` | `string` | State machine state ID (e.g., `"profile"`, `"#settings"`) |
-
-#### Returns
-
-`string` \| `null`
-
-The registered path pattern, or `null` if the state ID is unknown
-
-#### Example
-
-```typescript
-map.getPathByStateId("profile"); // "/profile/:userId"
-map.getPathByStateId("missing"); // null
-```
-
----
-
-### getStateIdByPath()
-
-```ts
-getStateIdByPath(path): string | null;
-```
-
-Defined in: [play-router/src/base-route-map.ts:174](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.33/packages/play-router/src/base-route-map.ts#L174)
-
-Resolve a URL path to its mapped state ID.
-
-Strips query strings and hash fragments before matching. Tries an O(1) exact
-lookup first, then falls back to bucket-indexed pattern matching. Results are
-cached after the first pattern match.
-
-#### Parameters
-
-| Parameter | Type     | Description                                                                    |
-| --------- | -------- | ------------------------------------------------------------------------------ |
-| `path`    | `string` | URL pathname, optionally including query/hash (e.g., `"/profile/123?ref=nav"`) |
-
-#### Returns
-
-`string` \| `null`
-
-The mapped state ID, or `null` if no route matches
-
-#### Example
-
-```typescript
-map.getStateIdByPath("/profile/123"); // "profile"
-map.getStateIdByPath("/unknown"); // null
-```

package/api/_media/README.md

@@ -1,321 +0,0 @@
-[Documentation](../../README.md) / @xmachines/play-dom
-
-# @xmachines/play-dom
-
-**Vanilla DOM renderer for XMachines**
-
-Framework-free view rendering driven by an XState v5 actor's `currentView` TC39 Signal. Implements the same catalog-typed `defineRegistry` / `ComponentFn` / `ActionFn` API surface as `@json-render/react`, `/solid`, `/vue`, and `/svelte`.
-
-## Installation
-
-```bash
-npm install @xmachines/play-dom @json-render/core zod
-```
-
-## Key Exports
-
-| Export                                              | Description                                                                                 |
-| --------------------------------------------------- | ------------------------------------------------------------------------------------------- |
-| `createRenderer(catalog, componentMap)`             | One-call factory: returns `mount(actor, container, options?) → disconnect`                  |
-| `connectRenderer(options)`                          | Functional API: connect actor → DOM with full options                                       |
-| `defineRegistry(catalog, { components, actions })`  | Build a catalog-typed `DomRegistry` with typed action handlers                              |
-| `PlayRenderer`                                      | Class-based renderer — `connect()` / `disconnect()` lifecycle                               |
-| `schema`                                            | DOM schema for `defineCatalog` (mirrors `@json-render/react/schema`)                        |
-| `ComponentFn<C, K>`                                 | Catalog-typed DOM component function type                                                   |
-| `ComponentContext<C, K>`                            | Context passed to each `ComponentFn` — `props`, `on`, `emit`, `children`, `bindings`, `ctx` |
-| `ActionFn<C, K>`                                    | `(params, setState, state) => Promise<void>` — catalog-typed action handler                 |
-| `SetState`                                          | `(updater: prev => next) => void` — write to the local state store                          |
-| `BaseComponentProps<P>`                             | Base type for catalog component prop definitions                                            |
-| `CatalogHasActions<C>`                              | Conditional type: `true` when catalog declares actions                                      |
-| `renderSpec(spec, store, registry, send, handlers)` | Pure Spec → DOM renderer (advanced use)                                                     |
-
-## Quick Start — `createRenderer`
-
-The preferred one-call pattern — mirrors all framework renderers:
-
-```typescript
-import { createRenderer, schema } from "@xmachines/play-dom";
-import { defineCatalog } from "@json-render/core";
-import { z } from "zod";
-import type { ComponentFn } from "@xmachines/play-dom";
-
-// 1. Define catalog
-const catalog = defineCatalog(schema, {
-	components: {
-		Home: { props: z.object({ title: z.string() }) },
-		Login: { props: z.object({ title: z.string(), username: z.string().optional() }) },
-	},
-	actions: {
-		login: { params: z.object({ username: z.string() }) },
-		logout: {},
-	},
-});
-type AppCatalog = typeof catalog;
-
-// 2. Implement components
-const Home: ComponentFn<AppCatalog, "Home"> = ({ props }) => {
-	const el = document.createElement("section");
-	el.textContent = props.title;
-	return el;
-};
-
-const Login: ComponentFn<AppCatalog, "Login"> = ({ props, on }) => {
-	const section = document.createElement("section");
-	const input = document.createElement("input");
-	input.value = props.username ?? "";
-	input.addEventListener("input", () => ctx.store.update((s) => ({ ...s, username: input.value })));
-
-	const button = document.createElement("button");
-	button.textContent = "Log In";
-	const submit = on("submit");
-	button.addEventListener("click", () => submit.emit());
-
-	section.append(input, button);
-	return section;
-};
-
-// 3. Create the renderer factory (once, at module level)
-const mount = createRenderer(catalog, { Home, Login });
-
-// 4. Mount when actor and container are ready
-const actor = createPlayer()();
-actor.start();
-
-const disconnect = mount(actor, document.getElementById("app")!);
-
-// Cleanup:
-disconnect();
-```
-
-## `defineRegistry` — Full Control
-
-When you need `registryResult.executeAction()` or want to share the registry with `connectRenderer`:
-
-```typescript
-import { defineRegistry, connectRenderer, schema } from "@xmachines/play-dom";
-import { defineCatalog } from "@json-render/core";
-import { z } from "zod";
-
-const catalog = defineCatalog(schema, {
-	components: {
-		Home: { props: z.object({ title: z.string() }) },
-	},
-	actions: {
-		login: { params: z.object({ username: z.string() }) },
-		logout: {},
-	},
-});
-
-// Action handlers receive (params, setState, state)
-// - params: resolved from the spec's on.submit.params (e.g. { $state: "/username" })
-// - setState: write to the local state store (e.g. to clear a form)
-// - state: current local state store snapshot
-const registryResult = defineRegistry(catalog, {
-	components: {
-		Home: ({ props }) => {
-			const el = document.createElement("section");
-			el.textContent = props.title;
-			return el;
-		},
-	},
-	actions: {
-		login: async (params, setState) => {
-			if (!params) return;
-			actor.send({ type: "auth.login", username: params.username });
-			setState((prev) => ({ ...prev, username: "" })); // clear the form
-		},
-		logout: async () => actor.send({ type: "auth.logout" }),
-	},
-});
-
-const disconnect = connectRenderer({
-	actor,
-	registry: registryResult.registry,
-	registryResult, // wires setState/state from xstate store automatically
-	container: document.getElementById("app")!,
-});
-```
-
-## Component API
-
-### `ComponentFn<C, K>` — component function signature
-
-```typescript
-const MyCard: ComponentFn<AppCatalog, "Card"> = ({
-	props, // catalog-typed props for this component
-	children, // Node[] — rendered child nodes
-	on, // (eventName) => EventHandle — get emit() for catalog-declared events
-	emit, // (eventName) => void — fire an event directly
-	bindings, // Record<string, string> — $bindState paths for two-way bindings
-	ctx, // DomRenderContext — store, send, handlers, loading, functions
-}) => {
-	const el = document.createElement("div");
-	el.append(...children);
-	return el;
-};
-```
-
-### Two-way binding with `$bindState`
-
-In the view spec:
-
-```json
-{ "username": { "$bindState": "/username" } }
-```
-
-In the component:
-
-```typescript
-const Login: ComponentFn<AppCatalog, "Login"> = ({ props, ctx }) => {
-	const input = document.createElement("input");
-	input.value = props.username ?? "";
-	// Write back to the store on user input
-	input.addEventListener("input", () => {
-		ctx.store.update((s) => ({ ...s, username: input.value }));
-	});
-	return input;
-};
-```
-
-### `on()` — event handle
-
-```typescript
-const submit = on("submit"); // EventHandle
-if (submit.bound) {
-	button.addEventListener("click", (e) => {
-		if (submit.shouldPreventDefault) e.preventDefault();
-		submit.emit(); // resolves params from store, calls action handler
-	});
-}
-```
-
-### `ActionFn` — action handler signature
-
-```typescript
-// Full signature — all three params are available
-login: async (params, setState, state) => {
-  actor.send({ type: "auth.login", username: params!.username });
-  setState(prev => ({ ...prev, username: "" }));
-  console.log("previous state was:", state);
-},
-
-// Params-only — setState/state can be omitted if unused
-logout: async () => actor.send({ type: "auth.logout" }),
-route: async (params) => actor.send({ type: "play.route", to: params!.to }),
-```
-
-## Spec Features
-
-`renderSpec` / `renderElement` supports these spec directives:
-
-| Directive                                              | Description                                                                           |
-| ------------------------------------------------------ | ------------------------------------------------------------------------------------- |
-| `visible`                                              | Boolean or `{ $state: "/path" }` — hide element when false                            |
-| `on.submit` / `on.click`                               | Action binding — `{ action: "login", params: { username: { $state: "/username" } } }` |
-| `repeat: { statePath, key? }`                          | Render children once per item in the state array at `statePath`                       |
-| `watch: { "/path": actionBinding }`                    | Fire action when store path changes after mount                                       |
-| `props.username: { $bindState: "/username" }`          | Two-way binding — read from store, write back via `ctx.store.update()`                |
-| `props.value: { $state: "/value" }`                    | Read-only store reference                                                             |
-| `props.label: { $computed: "computeFn", args: [...] }` | Computed prop via `functions` map                                                     |
-
-## `PlayRenderer` — class API
-
-```typescript
-import { PlayRenderer, defineRegistry } from "@xmachines/play-dom";
-
-const { registry, registryResult } = defineRegistry(catalog, { components, actions });
-
-const renderer = new PlayRenderer(document.getElementById("app")!, actor, registry, {
-	registryResult,
-});
-
-renderer.connect(); // starts watching actor.currentView
-renderer.disconnect(); // stops watching, clears container
-
-// double-connect is safe — connect() calls disconnect() internally if already connected
-```
-
-## Options Reference
-
-### `ConnectRendererOptions` / `PlayDomOptions`
-
-| Option           | Type                            | Description                                                                   |
-| ---------------- | ------------------------------- | ----------------------------------------------------------------------------- |
-| `actor`          | `AbstractActor & Viewable`      | Actor providing `currentView` signal                                          |
-| `registry`       | `DomRegistry`                   | Component renderer map from `defineRegistry`                                  |
-| `registryResult` | `DefineRegistryResult`          | Preferred — auto-wires `setState`/`state` from xstate store                   |
-| `handlers`       | `Record<string, ActionHandler>` | Pre-resolved handlers (legacy / advanced)                                     |
-| `container`      | `HTMLElement`                   | DOM element to render into                                                    |
-| `fallback`       | `HTMLElement \| null`           | Shown on initial mount when view is `null` (initial mount only)               |
-| `store`          | `StateStore`                    | External store — controlled mode, overrides `spec.state`                      |
-| `loading`        | `boolean`                       | Streaming mode — suppresses missing-child warnings, exposes `ctx.ctx.loading` |
-
-## Learn More
-
-- [DOM Router adapter `@xmachines/play-dom-router`](../play-dom-router/README.md)
-- [API reference](../../_media/README.md)
-- [Play RFC](../../packages/docs/rfc/play.md)
-
-@xmachines/play-dom — Vanilla DOM renderer for XMachines Play architecture.
-
-Public API split into two layers:
-
-**XMachines layer** (this package):
-
-- `createRenderer()` — one-call factory: returns `mount(actor, container, options?) → disconnect`
-- `PlayRenderer` — class-based renderer with `connect()` / `disconnect()` lifecycle
-- `connectRenderer()` — functional API (backward-compat alternative to `PlayRenderer`)
-- `ConnectRendererOptions`, `PlayDomOptions`
-
-**json-render layer** (upstreamable to @json-render/dom):
-
-- `defineRegistry` — build a catalog-typed DomRegistry
-- `renderSpec` — pure Spec → DOM renderer (uses resolveElementProps from core)
-- `ComponentFn` — catalog-typed component function type
-- `ComponentContext` — catalog-typed render context (props, emit, on, children, bindings)
-- `ComponentRegistry` — catalog-typed registry input type
-- `DomComponentRenderer` — raw element-level renderer type
-- `DomRegistry` — raw registry type
-- `DomRenderContext` — raw render context
-- `EventHandle` — event handle returned by on()
-- `SetState` — state updater function passed to ActionFn
-- `CatalogHasActions` — conditional type: true when catalog declares actions
-- `BaseComponentProps` — base props type for catalog component definitions
-
-## Classes
-
-- [PlayRenderer](classes/PlayRenderer.md)
-
-## Interfaces
-
-- [ComponentContext](interfaces/ComponentContext.md)
-- [ConnectRendererOptions](interfaces/ConnectRendererOptions.md)
-- [DefineRegistryResult](interfaces/DefineRegistryResult.md)
-- [DomRenderContext](interfaces/DomRenderContext.md)
-- [EventHandle](interfaces/EventHandle.md)
-- [PlayDomOptions](interfaces/PlayDomOptions.md)
-
-## Type Aliases
-
-- [ActionFn](type-aliases/ActionFn.md)
-- [Actions](type-aliases/Actions.md)
-- [BaseComponentProps](type-aliases/BaseComponentProps.md)
-- [CatalogHasActions](type-aliases/CatalogHasActions.md)
-- [ComponentFn](type-aliases/ComponentFn.md)
-- [ComponentRegistry](type-aliases/ComponentRegistry.md)
-- [DefineRegistryOptions](type-aliases/DefineRegistryOptions.md)
-- [DomComponentRenderer](type-aliases/DomComponentRenderer.md)
-- [DomRegistry](type-aliases/DomRegistry.md)
-- [DomSchema](type-aliases/DomSchema.md)
-- [SetState](type-aliases/SetState.md)
-
-## Variables
-
-- [schema](variables/schema.md)
-
-## Functions
-
-- [connectRenderer](functions/connectRenderer.md)
-- [createRenderer](functions/createRenderer.md)
-- [defineRegistry](functions/defineRegistry.md)
-- [renderSpec](functions/renderSpec.md)