@xmachines/docs 1.0.0-beta.9 → 1.0.0

package/api/@xmachines/play-react/classes/PlayErrorBoundary.md

@@ -1,8 +1,8 @@
-[Documentation](../../../README.md) / [@xmachines/play-react](../README.md) / PlayErrorBoundary
+[API](../../../README.md) / [@xmachines/play-react](../README.md) / PlayErrorBoundary
 
 # Class: PlayErrorBoundary
 
-Defined in: [packages/play-react/src/PlayErrorBoundary.tsx:49](https://gitlab.com/xmachin-es/xmachines-js/-/blob/00a28432ed57807112288436d1ae4387d9f06919/packages/play-react/src/PlayErrorBoundary.tsx#L49)
+Defined in: [packages/play-react/src/PlayErrorBoundary.tsx:53](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0/packages/play-react/src/PlayErrorBoundary.tsx#L53)
 
 React class component error boundary for catching catalog component render errors.
 
@@ -10,6 +10,10 @@ Wraps catalog component renders so failures are caught and forwarded to standard
 React error boundary protocol. Consumers can attach the `onError` prop to forward
 errors to production observability tools (Sentry, Datadog, etc.).
 
+**React 19 safety (Phase 29):** `componentDidCatch` calls `onError` for observability
+but does NOT re-throw. `getDerivedStateFromError` already sets the fallback state —
+re-throwing from `componentDidCatch` can unmount the entire React 19 root.
+
 Per CONS-14: Class component pattern works with all React versions (18 and 19).
 
 ## Example
@@ -32,7 +36,7 @@ Per CONS-14: Class component pattern works with all React versions (18 and 19).
 new PlayErrorBoundary(props): PlayErrorBoundary;
 ```
 
-Defined in: [packages/play-react/src/PlayErrorBoundary.tsx:53](https://gitlab.com/xmachin-es/xmachines-js/-/blob/00a28432ed57807112288436d1ae4387d9f06919/packages/play-react/src/PlayErrorBoundary.tsx#L53)
+Defined in: [packages/play-react/src/PlayErrorBoundary.tsx:57](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0/packages/play-react/src/PlayErrorBoundary.tsx#L57)
 
 #### Parameters
 
@@ -55,13 +59,13 @@ React.Component<
 
 ## Properties
 
-| Property                                         | Modifier   | Type               | Description                                                                                                                                                                                                                                                                                                                                                                                                                                                                                | Inherited from                | Defined in                               |
-| ------------------------------------------------ | ---------- | ------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ----------------------------- | ---------------------------------------- |
-| <a id="property-context"></a> `context`          | `public`   | `unknown`          | If using React Context, re-declare this in your class to be the `React.ContextType` of your `static contextType`. Should be used with type annotation or static contextType. **Example** `static contextType = MyContext // For TS pre-3.7: context!: React.ContextType<typeof MyContext> // For TS 3.7 and above: declare context: React.ContextType<typeof MyContext>` **See** [React Docs](https://react.dev/reference/react/Component#context)                                         | `React.Component.context`     | node_modules/@types/react/index.d.ts:955 |
-| <a id="property-props"></a> `props`              | `readonly` | `Readonly`\<`P`\>  | -                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          | `React.Component.props`       | node_modules/@types/react/index.d.ts:979 |
-| <a id="property-state"></a> `state`              | `public`   | `Readonly`\<`S`\>  | -                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          | `React.Component.state`       | node_modules/@types/react/index.d.ts:980 |
-| <a id="property-contexttype"></a> `contextType?` | `static`   | `Context`\<`any`\> | If set, `this.context` will be set at runtime to the current value of the given Context. **Example** `type MyContext = number const Ctx = React.createContext<MyContext>(0) class Foo extends React.Component { static contextType = Ctx context!: React.ContextType<typeof Ctx> render () { return <>My context's value: {this.context}</>; } }` **See** [https://react.dev/reference/react/Component#static-contexttype](https://react.dev/reference/react/Component#static-contexttype) | `React.Component.contextType` | node_modules/@types/react/index.d.ts:931 |
-| <a id="property-proptypes"></a> ~~`propTypes?`~~ | `static`   | `any`              | Ignored by React. **Deprecated** Only kept in types for backwards compatibility. Will be removed in a future major release.                                                                                                                                                                                                                                                                                                                                                                | `React.Component.propTypes`   | node_modules/@types/react/index.d.ts:937 |
+| Property                                         | Modifier   | Type               | Description                                                                                                                                                                                                                                                                                                                                                                                                                                                                                | Inherited from                | Defined in |
+| ------------------------------------------------ | ---------- | ------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ----------------------------- | ---------- |
+| <a id="property-context"></a> `context`          | `public`   | `unknown`          | If using React Context, re-declare this in your class to be the `React.ContextType` of your `static contextType`. Should be used with type annotation or static contextType. **Example** `static contextType = MyContext // For TS pre-3.7: context!: React.ContextType<typeof MyContext> // For TS 3.7 and above: declare context: React.ContextType<typeof MyContext>` **See** [React Docs](https://react.dev/reference/react/Component#context)                                         | `React.Component.context`     | -          |
+| <a id="property-props"></a> `props`              | `readonly` | `Readonly`\<`P`\>  | -                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          | `React.Component.props`       | -          |
+| <a id="property-state"></a> `state`              | `public`   | `Readonly`\<`S`\>  | -                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          | `React.Component.state`       | -          |
+| <a id="property-contexttype"></a> `contextType?` | `static`   | `Context`\<`any`\> | If set, `this.context` will be set at runtime to the current value of the given Context. **Example** `type MyContext = number const Ctx = React.createContext<MyContext>(0) class Foo extends React.Component { static contextType = Ctx context!: React.ContextType<typeof Ctx> render () { return <>My context's value: {this.context}</>; } }` **See** [https://react.dev/reference/react/Component#static-contexttype](https://react.dev/reference/react/Component#static-contexttype) | `React.Component.contextType` | -          |
+| <a id="property-proptypes"></a> ~~`propTypes?`~~ | `static`   | `any`              | Ignored by React. **Deprecated** Only kept in types for backwards compatibility. Will be removed in a future major release.                                                                                                                                                                                                                                                                                                                                                                | `React.Component.propTypes`   | -          |
 
 ## Methods
 
@@ -71,7 +75,7 @@ React.Component<
 componentDidCatch(error, info): void;
 ```
 
-Defined in: [packages/play-react/src/PlayErrorBoundary.tsx:62](https://gitlab.com/xmachin-es/xmachines-js/-/blob/00a28432ed57807112288436d1ae4387d9f06919/packages/play-react/src/PlayErrorBoundary.tsx#L62)
+Defined in: [packages/play-react/src/PlayErrorBoundary.tsx:66](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0/packages/play-react/src/PlayErrorBoundary.tsx#L66)
 
 Catches exceptions generated in descendant components. Unhandled exceptions will cause
 the entire component tree to unmount.
@@ -101,7 +105,7 @@ React.Component.componentDidCatch;
 optional componentDidMount(): void;
 ```
 
-Defined in: node_modules/@types/react/index.d.ts:1198
+Defined in: `@types/react`
 
 Called immediately after a component is mounted. Setting state here will trigger re-rendering.
 
@@ -126,7 +130,7 @@ optional componentDidUpdate(
    snapshot?): void;
 ```
 
-Defined in: node_modules/@types/react/index.d.ts:1261
+Defined in: `@types/react`
 
 Called immediately after updating occurs. Not called for the initial render.
 
@@ -158,13 +162,13 @@ React.Component.componentDidUpdate;
 optional componentWillMount(): void;
 ```
 
-Defined in: node_modules/@types/react/index.d.ts:1277
+Defined in: `@types/react`
 
-Called immediately before mounting occurs, and before Component.render.
+Called immediately before mounting occurs, and before [Component.render](https://www.jsdocs.io/package/@types/react#Component.render).
 Avoid introducing any side-effects or subscriptions in this method.
 
 Note: the presence of [getSnapshotBeforeUpdate](#getsnapshotbeforeupdate)
-or StaticLifecycle.getDerivedStateFromProps getDerivedStateFromProps prevents
+or [getDerivedStateFromProps](https://www.jsdocs.io/package/@types/react#StaticLifecycle.getDerivedStateFromProps) prevents
 this from being invoked.
 
 #### Returns
@@ -194,7 +198,7 @@ React.Component.componentWillMount;
 optional componentWillReceiveProps(nextProps, nextContext): void;
 ```
 
-Defined in: node_modules/@types/react/index.d.ts:1308
+Defined in: `@types/react`
 
 Called when the component may be receiving new props.
 React may call this even if props have not changed, so be sure to compare new and existing
@@ -203,7 +207,7 @@ props if you only want to handle changes.
 Calling [Component.setState](#setstate) generally does not trigger this method.
 
 Note: the presence of [getSnapshotBeforeUpdate](#getsnapshotbeforeupdate)
-or StaticLifecycle.getDerivedStateFromProps getDerivedStateFromProps prevents
+or [getDerivedStateFromProps](https://www.jsdocs.io/package/@types/react#StaticLifecycle.getDerivedStateFromProps) prevents
 this from being invoked.
 
 #### Parameters
@@ -219,7 +223,7 @@ this from being invoked.
 
 #### Deprecated
 
-16.3, use static StaticLifecycle.getDerivedStateFromProps getDerivedStateFromProps instead; will stop working in React 17
+16.3, use static [getDerivedStateFromProps](https://www.jsdocs.io/package/@types/react#StaticLifecycle.getDerivedStateFromProps) instead; will stop working in React 17
 
 #### See
 
@@ -240,7 +244,7 @@ React.Component.componentWillReceiveProps;
 optional componentWillUnmount(): void;
 ```
 
-Defined in: node_modules/@types/react/index.d.ts:1214
+Defined in: `@types/react`
 
 Called immediately before a component is destroyed. Perform any necessary cleanup in this method, such as
 cancelled network requests, or cleaning up any DOM elements created in `componentDidMount`.
@@ -266,14 +270,14 @@ optional componentWillUpdate(
    nextContext): void;
 ```
 
-Defined in: node_modules/@types/react/index.d.ts:1340
+Defined in: `@types/react`
 
 Called immediately before rendering when new props or state is received. Not called for the initial render.
 
 Note: You cannot call [Component.setState](#setstate) here.
 
 Note: the presence of [getSnapshotBeforeUpdate](#getsnapshotbeforeupdate)
-or StaticLifecycle.getDerivedStateFromProps getDerivedStateFromProps prevents
+or [getDerivedStateFromProps](https://www.jsdocs.io/package/@types/react#StaticLifecycle.getDerivedStateFromProps) prevents
 this from being invoked.
 
 #### Parameters
@@ -311,7 +315,7 @@ React.Component.componentWillUpdate;
 forceUpdate(callback?): void;
 ```
 
-Defined in: node_modules/@types/react/index.d.ts:976
+Defined in: `@types/react`
 
 #### Parameters
 
@@ -337,11 +341,11 @@ React.Component.forceUpdate;
 optional getSnapshotBeforeUpdate(prevProps, prevState): any;
 ```
 
-Defined in: node_modules/@types/react/index.d.ts:1255
+Defined in: `@types/react`
 
-Runs before React applies the result of Component.render render to the document, and
+Runs before React applies the result of [render](https://www.jsdocs.io/package/@types/react#Component.render) to the document, and
 returns an object to be given to [componentDidUpdate](#componentdidupdate). Useful for saving
-things such as scroll position before Component.render render causes changes to it.
+things such as scroll position before [render](https://www.jsdocs.io/package/@types/react#Component.render) causes changes to it.
 
 Note: the presence of this method prevents any of the deprecated
 lifecycle events from running.
@@ -371,7 +375,7 @@ React.Component.getSnapshotBeforeUpdate;
 render(): ReactNode;
 ```
 
-Defined in: [packages/play-react/src/PlayErrorBoundary.tsx:67](https://gitlab.com/xmachin-es/xmachines-js/-/blob/00a28432ed57807112288436d1ae4387d9f06919/packages/play-react/src/PlayErrorBoundary.tsx#L67)
+Defined in: [packages/play-react/src/PlayErrorBoundary.tsx:70](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0/packages/play-react/src/PlayErrorBoundary.tsx#L70)
 
 #### Returns
 
@@ -391,7 +395,7 @@ React.Component.render;
 setState<K>(state, callback?): void;
 ```
 
-Defined in: node_modules/@types/react/index.d.ts:971
+Defined in: `@types/react`
 
 #### Type Parameters
 
@@ -427,7 +431,7 @@ optional shouldComponentUpdate(
    nextContext): boolean;
 ```
 
-Defined in: node_modules/@types/react/index.d.ts:1209
+Defined in: `@types/react`
 
 Called to determine whether the change in props and state should trigger a re-render.
 
@@ -435,7 +439,7 @@ Called to determine whether the change in props and state should trigger a re-re
 `PureComponent` implements a shallow comparison on props and state and returns true if any
 props or states have changed.
 
-If false is returned, Component.render, `componentWillUpdate`
+If false is returned, [Component.render](https://www.jsdocs.io/package/@types/react#Component.render), `componentWillUpdate`
 and `componentDidUpdate` will not be called.
 
 #### Parameters
@@ -458,21 +462,21 @@ React.Component.shouldComponentUpdate;
 
 ---
 
-### ~~UNSAFE_componentWillMount()?~~
+### ~~UNSAFE\_componentWillMount()?~~
 
 ```ts
 optional UNSAFE_componentWillMount(): void;
 ```
 
-Defined in: node_modules/@types/react/index.d.ts:1292
+Defined in: `@types/react`
 
-Called immediately before mounting occurs, and before Component.render.
+Called immediately before mounting occurs, and before [Component.render](https://www.jsdocs.io/package/@types/react#Component.render).
 Avoid introducing any side-effects or subscriptions in this method.
 
 This method will not stop working in React 17.
 
 Note: the presence of [getSnapshotBeforeUpdate](#getsnapshotbeforeupdate)
-or StaticLifecycle.getDerivedStateFromProps getDerivedStateFromProps prevents
+or [getDerivedStateFromProps](https://www.jsdocs.io/package/@types/react#StaticLifecycle.getDerivedStateFromProps) prevents
 this from being invoked.
 
 #### Returns
@@ -496,13 +500,13 @@ React.Component.UNSAFE_componentWillMount;
 
 ---
 
-### ~~UNSAFE_componentWillReceiveProps()?~~
+### ~~UNSAFE\_componentWillReceiveProps()?~~
 
 ```ts
 optional UNSAFE_componentWillReceiveProps(nextProps, nextContext): void;
 ```
 
-Defined in: node_modules/@types/react/index.d.ts:1326
+Defined in: `@types/react`
 
 Called when the component may be receiving new props.
 React may call this even if props have not changed, so be sure to compare new and existing
@@ -513,7 +517,7 @@ Calling [Component.setState](#setstate) generally does not trigger this method.
 This method will not stop working in React 17.
 
 Note: the presence of [getSnapshotBeforeUpdate](#getsnapshotbeforeupdate)
-or StaticLifecycle.getDerivedStateFromProps getDerivedStateFromProps prevents
+or [getDerivedStateFromProps](https://www.jsdocs.io/package/@types/react#StaticLifecycle.getDerivedStateFromProps) prevents
 this from being invoked.
 
 #### Parameters
@@ -529,7 +533,7 @@ this from being invoked.
 
 #### Deprecated
 
-16.3, use static StaticLifecycle.getDerivedStateFromProps getDerivedStateFromProps instead
+16.3, use static [getDerivedStateFromProps](https://www.jsdocs.io/package/@types/react#StaticLifecycle.getDerivedStateFromProps) instead
 
 #### See
 
@@ -544,7 +548,7 @@ React.Component.UNSAFE_componentWillReceiveProps;
 
 ---
 
-### ~~UNSAFE_componentWillUpdate()?~~
+### ~~UNSAFE\_componentWillUpdate()?~~
 
 ```ts
 optional UNSAFE_componentWillUpdate(
@@ -553,7 +557,7 @@ optional UNSAFE_componentWillUpdate(
    nextContext): void;
 ```
 
-Defined in: node_modules/@types/react/index.d.ts:1356
+Defined in: `@types/react`
 
 Called immediately before rendering when new props or state is received. Not called for the initial render.
 
@@ -562,7 +566,7 @@ Note: You cannot call [Component.setState](#setstate) here.
 This method will not stop working in React 17.
 
 Note: the presence of [getSnapshotBeforeUpdate](#getsnapshotbeforeupdate)
-or StaticLifecycle.getDerivedStateFromProps getDerivedStateFromProps prevents
+or [getDerivedStateFromProps](https://www.jsdocs.io/package/@types/react#StaticLifecycle.getDerivedStateFromProps) prevents
 this from being invoked.
 
 #### Parameters
@@ -600,7 +604,7 @@ React.Component.UNSAFE_componentWillUpdate;
 static getDerivedStateFromError(error): PlayErrorBoundaryState;
 ```
 
-Defined in: [packages/play-react/src/PlayErrorBoundary.tsx:58](https://gitlab.com/xmachin-es/xmachines-js/-/blob/00a28432ed57807112288436d1ae4387d9f06919/packages/play-react/src/PlayErrorBoundary.tsx#L58)
+Defined in: [packages/play-react/src/PlayErrorBoundary.tsx:62](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0/packages/play-react/src/PlayErrorBoundary.tsx#L62)
 
 #### Parameters
 

package/api/@xmachines/play-react/functions/ActionProvider.md

@@ -0,0 +1,21 @@
+[API](../../../README.md) / [@xmachines/play-react](../README.md) / ActionProvider
+
+# Function: ActionProvider()
+
+```ts
+function ActionProvider(__namedParameters): Element;
+```
+
+Defined in: `@xmachines/json-render-react`
+
+Provider for action execution
+
+## Parameters
+
+| Parameter           | Type                                                          |
+| ------------------- | ------------------------------------------------------------- |
+| `__namedParameters` | [`ActionProviderProps`](../interfaces/ActionProviderProps.md) |
+
+## Returns
+
+`Element`

package/api/@xmachines/play-react/functions/JSONUIProvider.md

@@ -0,0 +1,21 @@
+[API](../../../README.md) / [@xmachines/play-react](../README.md) / JSONUIProvider
+
+# Function: JSONUIProvider()
+
+```ts
+function JSONUIProvider(__namedParameters): Element;
+```
+
+Defined in: `@xmachines/json-render-react`
+
+Combined provider for all JSONUI contexts
+
+## Parameters
+
+| Parameter           | Type                                                          |
+| ------------------- | ------------------------------------------------------------- |
+| `__namedParameters` | [`JSONUIProviderProps`](../interfaces/JSONUIProviderProps.md) |
+
+## Returns
+
+`Element`

package/api/@xmachines/play-react/functions/Renderer.md

@@ -0,0 +1,21 @@
+[API](../../../README.md) / [@xmachines/play-react](../README.md) / Renderer
+
+# Function: Renderer()
+
+```ts
+function Renderer(__namedParameters): Element | null;
+```
+
+Defined in: `@xmachines/json-render-react`
+
+Main renderer component
+
+## Parameters
+
+| Parameter           | Type                                              |
+| ------------------- | ------------------------------------------------- |
+| `__namedParameters` | [`RendererProps`](../interfaces/RendererProps.md) |
+
+## Returns
+
+`Element` \| `null`

package/api/@xmachines/play-react/functions/StateProvider.md

@@ -0,0 +1,27 @@
+[API](../../../README.md) / [@xmachines/play-react](../README.md) / StateProvider
+
+# Function: StateProvider()
+
+```ts
+function StateProvider(__namedParameters): Element;
+```
+
+Defined in: `@xmachines/json-render-react`
+
+Provider for state model context.
+
+Supports two modes:
+
+- **Controlled**: pass a `store` prop (e.g. backed by Redux / Zustand).
+- **Uncontrolled** (default): omit `store` and optionally pass
+  `initialState` / `onStateChange`.
+
+## Parameters
+
+| Parameter           | Type                                                        |
+| ------------------- | ----------------------------------------------------------- |
+| `__namedParameters` | [`StateProviderProps`](../interfaces/StateProviderProps.md) |
+
+## Returns
+
+`Element`

package/api/@xmachines/play-react/functions/ValidationProvider.md

@@ -0,0 +1,21 @@
+[API](../../../README.md) / [@xmachines/play-react](../README.md) / ValidationProvider
+
+# Function: ValidationProvider()
+
+```ts
+function ValidationProvider(__namedParameters): Element;
+```
+
+Defined in: `@xmachines/json-render-react`
+
+Provider for validation
+
+## Parameters
+
+| Parameter           | Type                                                                  |
+| ------------------- | --------------------------------------------------------------------- |
+| `__namedParameters` | [`ValidationProviderProps`](../interfaces/ValidationProviderProps.md) |
+
+## Returns
+
+`Element`

package/api/@xmachines/play-react/functions/VisibilityProvider.md

@@ -0,0 +1,21 @@
+[API](../../../README.md) / [@xmachines/play-react](../README.md) / VisibilityProvider
+
+# Function: VisibilityProvider()
+
+```ts
+function VisibilityProvider(__namedParameters): Element;
+```
+
+Defined in: `@xmachines/json-render-react`
+
+Provider for visibility evaluation
+
+## Parameters
+
+| Parameter           | Type                                                                  |
+| ------------------- | --------------------------------------------------------------------- |
+| `__namedParameters` | [`VisibilityProviderProps`](../interfaces/VisibilityProviderProps.md) |
+
+## Returns
+
+`Element`

package/api/@xmachines/play-react/functions/defineRegistry.md

@@ -0,0 +1,49 @@
+[API](../../../README.md) / [@xmachines/play-react](../README.md) / defineRegistry
+
+# Function: defineRegistry()
+
+```ts
+function defineRegistry<C>(_catalog, options): DefineRegistryResult;
+```
+
+Defined in: `@xmachines/json-render-react`
+
+Create a registry from a catalog with components and/or actions.
+
+When the catalog declares actions, the `actions` field is required.
+
+## Type Parameters
+
+| Type Parameter                                                                                                                       |
+| ------------------------------------------------------------------------------------------------------------------------------------ |
+| `C` _extends_ `Catalog`\<`SchemaDefinition`\<`SchemaType`\<`string`, `unknown`\>, `SchemaType`\<`string`, `unknown`\>\>, `unknown`\> |
+
+## Parameters
+
+| Parameter  | Type                           |
+| ---------- | ------------------------------ |
+| `_catalog` | `C`                            |
+| `options`  | `DefineRegistryOptions`\<`C`\> |
+
+## Returns
+
+`DefineRegistryResult`
+
+## Example
+
+```tsx
+// Components only (catalog has no actions)
+const { registry } = defineRegistry(catalog, {
+  components: {
+    Card: ({ props, children }) => (
+      <div className="card">{props.title}{children}</div>
+    ),
+  },
+});
+
+// Both (catalog declares actions)
+const { registry, handlers, executeAction } = defineRegistry(catalog, {
+  components: { ... },
+  actions: { ... },
+});
+```

package/api/@xmachines/play-react/functions/useActor.md

@@ -0,0 +1,13 @@
+[API](../../../README.md) / [@xmachines/play-react](../README.md) / useActor
+
+# Function: useActor()
+
+```ts
+function useActor(): AnyPlayActor;
+```
+
+Defined in: [packages/play-react/src/useActor.ts:32](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0/packages/play-react/src/useActor.ts#L32)
+
+## Returns
+
+[`AnyPlayActor`](../type-aliases/AnyPlayActor.md)

package/api/@xmachines/play-react/functions/useBoundProp.md

@@ -0,0 +1,45 @@
+[API](../../../README.md) / [@xmachines/play-react](../README.md) / useBoundProp
+
+# Function: useBoundProp()
+
+```ts
+function useBoundProp<T>(propValue, bindingPath): [T | undefined, (value) => void];
+```
+
+Defined in: `@xmachines/json-render-react`
+
+Hook for two-way bound props. Returns `[value, setValue]` where:
+
+- `value` is the already-resolved prop value (passed through from render props)
+- `setValue` writes back to the bound state path (no-op if not bound)
+
+Designed to work with the `bindings` map that the renderer provides when
+a prop uses `{ $bindState: "/path" }` or `{ $bindItem: "field" }`.
+
+## Type Parameters
+
+| Type Parameter |
+| -------------- |
+| `T`            |
+
+## Parameters
+
+| Parameter     | Type                    |
+| ------------- | ----------------------- |
+| `propValue`   | `T` \| `undefined`      |
+| `bindingPath` | `string` \| `undefined` |
+
+## Returns
+
+\[`T` \| `undefined`, (`value`) => `void`\]
+
+## Example
+
+```tsx
+import { useBoundProp } from "@xmachines/json-render-react";
+
+const Input: ComponentRenderer = ({ props, bindings }) => {
+	const [value, setValue] = useBoundProp<string>(props.value, bindings?.value);
+	return <input value={value ?? ""} onChange={(e) => setValue(e.target.value)} />;
+};
+```

package/api/@xmachines/play-react/functions/usePlayView.md

@@ -0,0 +1,32 @@
+[API](../../../README.md) / [@xmachines/play-react](../README.md) / usePlayView
+
+# Function: usePlayView()
+
+```ts
+function usePlayView(): ViewContextValue;
+```
+
+Defined in: [packages/play-react/src/ActorProvider.tsx:82](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0/packages/play-react/src/ActorProvider.tsx#L82)
+
+Hook to access the current view spec, handlers, and registry.
+
+Must be called inside <ActorProvider> or <PlayUIProvider>.
+
+## Returns
+
+[`ViewContextValue`](../interfaces/ViewContextValue.md)
+
+## Throws
+
+If called outside an ActorProvider/PlayUIProvider tree
+
+## Example
+
+```typescript
+import { usePlayView } from "@xmachines/play-react";
+
+function MyRenderer() {
+  const view = usePlayView();
+  return <Renderer spec={view.spec} registry={view.registry} />;
+}
+```