fixes

vue
add dynamic forms support: computed values, watchers, cross-field validation (#156 )
2026-10-03 04:18:15 +08:00 · 2026-02-25 00:59:21 -06:00 · 2026-02-25 00:04:12 -06:00 · 2026-02-24 23:04:48 -06:00 · 2026-02-24 22:09:42 -06:00 · 2026-02-24 22:01:33 -06:00
232 changed files with 19387 additions and 1193 deletions
@@ -10,7 +10,10 @@
      "@json-render/shadcn",
      "@json-render/react-native",
      "@json-render/remotion",
-      "@json-render/codegen"
+      "@json-render/codegen",
+      "@json-render/zustand",
+      "@json-render/redux",
+      "@json-render/jotai"
    ]
  ],
  "linked": [],
@@ -18,7 +21,7 @@
  "baseBranch": "main",
  "updateInternalDependencies": "patch",
  "privatePackages": {
-    "version": false,
+    "version": true,
    "tag": false
  }
 }
@@ -6,11 +6,8 @@ node_modules
 .pnp.js

 # Local env files
-.env
-.env.local
-.env.development.local
-.env.test.local
-.env.production.local
+.env*
+!.env.example

 # Testing
 coverage
@@ -26,6 +23,8 @@ coverage

 # Build Outputs
 .next/
+.nuxt/
+.output/
 out/
 build
 dist
@@ -44,10 +43,6 @@ yarn-error.log*
 # opensrc - source code for packages
 opensrc/

-# json-studio (separate repo)
-json-studio/
-.env*.local
-
 # Stripe apps (generated from template + build artifacts)
 examples/stripe-app/*/stripe-app.json
 examples/stripe-app/*/.build
@@ -27,12 +27,48 @@ This ensures we don't install outdated versions that may have incompatible types
 - Do not use emojis in code or UI
 - Use shadcn CLI to add shadcn/ui components: `pnpm dlx shadcn@latest add <component>`

+## AI SDK / AI Gateway
+
+When using the Vercel AI SDK (`ai` package) with AI Gateway, pass the model as a plain string identifier -- do not import a provider constructor:
+
+```ts
+import { streamText } from "ai";
+
+const result = streamText({
+  model: "anthropic/claude-haiku-4.5",
+  prompt: "...",
+});
+```
+
+This requires `AI_GATEWAY_API_KEY` to be set in the environment. See `tests/e2e/` for examples.
+
+## Dev Servers
+
+All apps and examples with dev servers use [portless](https://github.com/vercel-labs/portless) to avoid hardcoded ports. Portless assigns random ports and exposes each app via `.localhost` URLs.
+
+Naming convention:
+- Main web app: `json-render` → `json-render.localhost:1355`
+- Examples: `[name]-demo.json-render` → `[name]-demo.json-render.localhost:1355`
+
+When adding a new example that runs a dev server, wrap its `dev` script with `portless <name>`:
+
+```json
+{
+  "scripts": {
+    "dev": "portless my-example-demo.json-render next dev --turbopack"
+  }
+}
+```
+
+Do **not** add `--port` flags -- portless handles port assignment automatically. Do **not** add portless as a project dependency; it must be installed globally.
+
 ## Workflow

 - Run `pnpm type-check` after each turn to ensure type safety
 - When making user-facing changes (new packages, API changes, new features, renamed exports, changed behavior), update the relevant documentation:
  - Package `README.md` files in `packages/*/README.md`
  - Root `README.md` (if packages table, install commands, or examples are affected)
+  - Web app docs in `apps/web/` (if guides, API references, or examples need updating)
  - Skills in `skills/*/SKILL.md` (if the package has a corresponding skill)
  - `AGENTS.md` (if workflow or conventions change)

@@ -32,7 +32,7 @@ json-render is a **Generative UI** framework: AI generates interfaces from natur

 ```typescript
 import { defineCatalog } from "@json-render/core";
-import { schema } from "@json-render/react";
+import { schema } from "@json-render/react/schema";
 import { z } from "zod";

 const catalog = defineCatalog(schema, {
@@ -114,6 +114,10 @@ function Dashboard({ spec }) {
 | `@json-render/react-native` | React Native renderer with standard mobile components |
 | `@json-render/remotion` | Remotion video renderer, timeline schema |
 | `@json-render/react-pdf` | React PDF renderer for generating PDF documents from specs |
+| `@json-render/redux` | Redux / Redux Toolkit adapter for `StateStore` |
+| `@json-render/zustand` | Zustand adapter for `StateStore` |
+| `@json-render/jotai` | Jotai adapter for `StateStore` |
+| `@json-render/xstate-store` | XState Store (atom) adapter for `StateStore` |

 ## Renderers

@@ -121,7 +125,7 @@ function Dashboard({ spec }) {

 ```tsx
 import { defineRegistry, Renderer } from "@json-render/react";
-import { schema } from "@json-render/react";
+import { schema } from "@json-render/react/schema";

 // Flat spec format (root key + elements map)
 const spec = {
@@ -149,7 +153,8 @@ const { registry } = defineRegistry(catalog, { components });

 ```tsx
 import { defineCatalog } from "@json-render/core";
-import { schema, defineRegistry, Renderer } from "@json-render/react";
+import { schema } from "@json-render/react/schema";
+import { defineRegistry, Renderer } from "@json-render/react";
 import { shadcnComponentDefinitions } from "@json-render/shadcn/catalog";
 import { shadcnComponents } from "@json-render/shadcn";

@@ -343,9 +348,9 @@ pnpm install
 pnpm dev
 ```

- http://localhost:3000 - Docs & Playground
- http://localhost:3001 - Example Dashboard
- http://localhost:3002 - Remotion Video Example
+- http://json-render.localhost:1355 - Docs & Playground
+- http://dashboard-demo.json-render.localhost:1355 - Example Dashboard
+- http://remotion-demo.json-render.localhost:1355 - Remotion Video Example
 - Chat Example: run `pnpm dev` in `examples/chat`
 - React Native example: run `npx expo start` in `examples/react-native`

@@ -0,0 +1,19 @@
+# web
+
+## 0.1.2
+
+### Patch Changes
+
+- Updated dependencies [b103676]
+  - @json-render/react@0.9.1
+  - @json-render/core@0.9.1
+  - @json-render/codegen@0.9.1
+
+## 0.1.1
+
+### Patch Changes
+
+- Updated dependencies [1d755c1]
+  - @json-render/core@0.9.0
+  - @json-render/react@0.9.0
+  - @json-render/codegen@0.9.0
@@ -14,7 +14,7 @@ pnpm dev
 bun dev
 ```

-Open [http://localhost:3000](http://localhost:3000) with your browser to see the result.
+Open [http://json-render.localhost:1355](http://json-render.localhost:1355) with your browser to see the result.

 You can start editing the page by modifying `app/page.tsx`. The page auto-updates as you edit the file.

@@ -1,4 +1,5 @@
-export const metadata = { title: "A2UI Integration" }
+import { pageMetadata } from "@/lib/page-metadata"
+export const metadata = pageMetadata("docs/a2ui")

 # A2UI Integration

@@ -66,7 +67,7 @@ A2UI uses an adjacency list model - a flat list of components with ID references

 ```typescript
 import { defineCatalog } from '@json-render/core';
-import { schema } from '@json-render/react';
+import { schema } from '@json-render/react/schema';
 import { z } from 'zod';

 // A2UI BoundValue schema
@@ -1,4 +1,5 @@
-export const metadata = { title: "Adaptive Cards Integration" }
+import { pageMetadata } from "@/lib/page-metadata"
+export const metadata = pageMetadata("docs/adaptive-cards")

 # Adaptive Cards Integration

@@ -89,7 +90,7 @@ Define a catalog matching the Adaptive Cards element types:

 ```typescript
 import { defineCatalog } from '@json-render/core';
-import { schema } from '@json-render/react';
+import { schema } from '@json-render/react/schema';
 import { z } from 'zod';

 // Common Adaptive Cards properties
@@ -1,4 +1,5 @@
-export const metadata = { title: "AG-UI Integration" }
+import { pageMetadata } from "@/lib/page-metadata"
+export const metadata = pageMetadata("docs/ag-ui")

 # AG-UI Integration

@@ -150,7 +151,7 @@ Create a catalog for UI components that agents can render:

 ```typescript
 import { defineCatalog } from '@json-render/core';
-import { schema } from '@json-render/react';
+import { schema } from '@json-render/react/schema';
 import { z } from 'zod';

 export const aguiCatalog = defineCatalog(schema, {
@@ -1,4 +1,5 @@
-export const metadata = { title: "AI SDK Integration" }
+import { pageMetadata } from "@/lib/page-metadata"
+export const metadata = pageMetadata("docs/ai-sdk")

 # AI SDK Integration

@@ -1,4 +1,5 @@
-export const metadata = { title: "@json-render/codegen API" }
+import { pageMetadata } from "@/lib/page-metadata"
+export const metadata = pageMetadata("docs/api/codegen")

 # @json-render/codegen

@@ -1,4 +1,5 @@
-export const metadata = { title: "@json-render/core API" }
+import { pageMetadata } from "@/lib/page-metadata"
+export const metadata = pageMetadata("docs/api/core")

 # @json-render/core

@@ -10,7 +11,7 @@ Creates a type-safe catalog definition with schema validation.

 ```typescript
 import { defineCatalog } from '@json-render/core';
-import { schema } from '@json-render/react';
+import { schema } from '@json-render/react/schema';

 function defineCatalog<T extends ZodType>(
  s: T,
@@ -118,7 +119,7 @@ The schema for flat UI element trees. This is exported from @json-render/react.

 ```typescript
 import { defineCatalog } from '@json-render/core';
-import { schema } from '@json-render/react';
+import { schema } from '@json-render/react/schema';

 // schema defines:
 // - Spec shape: { root: string, elements: Record<string, UIElement> }
@@ -1,4 +1,5 @@
-export const metadata = { title: "@json-render/react-native API" }
+import { pageMetadata } from "@/lib/page-metadata"
+export const metadata = pageMetadata("docs/api/react-native")

 # @json-render/react-native

@@ -62,11 +63,36 @@ React Native renderer with standard components, providers, and hooks.
 ### StateProvider

 ```tsx
-<StateProvider initialState={object}>
+<StateProvider initialState={object} onStateChange={fn}>
  {children}
 </StateProvider>
 ```

+| Prop | Type | Description |
+|------|------|-------------|
+| `store` | `StateStore` | External store (controlled mode). When provided, `initialState` and `onStateChange` are ignored. |
+| `initialState` | `Record<string, unknown>` | Initial state model (uncontrolled mode). |
+| `onStateChange` | `(changes: Array<{ path: string; value: unknown }>) => void` | Callback when state changes (uncontrolled mode). Called once per `set` or `update` with all changed entries. |
+
+#### External Store (Controlled Mode)
+
+Pass a `StateStore` to bypass the internal state and wire json-render to any state management library:
+
+```tsx
+import { createStateStore, type StateStore } from "@json-render/react-native";
+
+const store = createStateStore({ count: 0 });
+
+<StateProvider store={store}>
+  {children}
+</StateProvider>
+
+// Mutate from anywhere — components re-render automatically:
+store.set("/count", 1);
+```
+
+The `store` prop is also available on `JSONUIProvider` and `createRenderer`.
+
 ### ActionProvider

 ```tsx
@@ -0,0 +1,439 @@
+import { pageMetadata } from "@/lib/page-metadata"
+export const metadata = pageMetadata("docs/api/react-pdf")
+
+# @json-render/react-pdf
+
+PDF document renderer. Turn JSON specs into PDFs using `@react-pdf/renderer`.
+
+## Install
+
+```bash
+npm install @json-render/core @json-render/react-pdf
+```
+
+See the [React PDF example](https://github.com/vercel-labs/json-render/tree/main/examples/react-pdf) for a full working example.
+
+## schema
+
+The PDF element schema for document specs. Use with `defineCatalog` from core.
+
+```typescript
+import { defineCatalog } from '@json-render/core';
+import { schema, standardComponentDefinitions } from '@json-render/react-pdf';
+
+const catalog = defineCatalog(schema, {
+  components: standardComponentDefinitions,
+});
+```
+
+## Render Functions
+
+Server-side functions for producing PDF output. All accept a spec and optional `RenderOptions`.
+
+```typescript
+import { renderToBuffer, renderToStream, renderToFile } from '@json-render/react-pdf';
+
+const buffer = await renderToBuffer(spec);
+
+const stream = await renderToStream(spec);
+stream.pipe(res);
+
+await renderToFile(spec, './output.pdf');
+```
+
+### RenderOptions
+
+```typescript
+interface RenderOptions {
+  registry?: ComponentRegistry;
+  includeStandard?: boolean;  // default: true
+  state?: Record<string, unknown>;
+}
+```
+
+<table>
+  <thead>
+    <tr>
+      <th>Option</th>
+      <th>Description</th>
+    </tr>
+  </thead>
+  <tbody>
+    <tr>
+      <td><code>registry</code></td>
+      <td>Custom component map (merged with standard components)</td>
+    </tr>
+    <tr>
+      <td><code>includeStandard</code></td>
+      <td>Include built-in standard components (default: <code>true</code>)</td>
+    </tr>
+    <tr>
+      <td><code>state</code></td>
+      <td>Initial state for <code>$state</code> / <code>$cond</code> dynamic prop resolution</td>
+    </tr>
+  </tbody>
+</table>
+
+## defineRegistry
+
+Create a type-safe component registry from a catalog. Components receive `{ props, children, emit, bindings, loading }`.
+
+```tsx
+import { defineRegistry } from '@json-render/react-pdf';
+import { View, Text } from '@react-pdf/renderer';
+
+const { registry } = defineRegistry(catalog, {
+  components: {
+    Badge: ({ props }) => (
+      <View style={{ backgroundColor: props.color ?? '#e5e7eb', padding: 4, borderRadius: 4 }}>
+        <Text style={{ fontSize: 10 }}>{props.label}</Text>
+      </View>
+    ),
+  },
+});
+
+const buffer = await renderToBuffer(spec, { registry });
+```
+
+## createRenderer
+
+Create a standalone renderer component wired to state, actions, and validation.
+
+```typescript
+import { createRenderer } from '@json-render/react-pdf';
+
+const PDFRenderer = createRenderer(catalog, components);
+```
+
+```typescript
+interface CreateRendererProps {
+  spec: Spec | null;
+  store?: StateStore;
+  state?: Record<string, unknown>;
+  onAction?: (actionName: string, params?: Record<string, unknown>) => void;
+  onStateChange?: (changes: Array<{ path: string; value: unknown }>) => void;
+  loading?: boolean;
+  fallback?: ComponentRenderer;
+}
+```
+
+When `store` is provided, `state` and `onStateChange` are ignored (controlled mode).
+
+## Renderer
+
+The main component that renders a spec to `@react-pdf/renderer` elements.
+
+```typescript
+interface RendererProps {
+  spec: Spec | null;
+  registry?: ComponentRegistry;
+  includeStandard?: boolean;  // default: true
+  loading?: boolean;
+  fallback?: ComponentRenderer;
+}
+```
+
+## Standard Components
+
+### Document Structure
+
+#### Document
+
+Top-level PDF wrapper. Must be the root element. Children must be `Page` components.
+
+```typescript
+{
+  title: string | null;
+  author: string | null;
+  subject: string | null;
+}
+```
+
+#### Page
+
+A page in the document with configurable size, orientation, and margins.
+
+```typescript
+{
+  size: "A4" | "A3" | "A5" | "LETTER" | "LEGAL" | "TABLOID" | null;
+  orientation: "portrait" | "landscape" | null;
+  marginTop: number | null;
+  marginBottom: number | null;
+  marginLeft: number | null;
+  marginRight: number | null;
+  backgroundColor: string | null;
+}
+```
+
+### Layout
+
+#### View
+
+Generic container with padding, margin, background, border, and flex alignment.
+
+```typescript
+{
+  padding: number | null;
+  paddingTop: number | null;
+  paddingBottom: number | null;
+  paddingLeft: number | null;
+  paddingRight: number | null;
+  margin: number | null;
+  backgroundColor: string | null;
+  borderWidth: number | null;
+  borderColor: string | null;
+  borderRadius: number | null;
+  flex: number | null;
+  alignItems: "flex-start" | "center" | "flex-end" | "stretch" | null;
+  justifyContent: "flex-start" | "center" | "flex-end" | "space-between" | "space-around" | null;
+}
+```
+
+#### Row
+
+Horizontal flex layout with optional wrapping.
+
+```typescript
+{
+  gap: number | null;
+  alignItems: "flex-start" | "center" | "flex-end" | "stretch" | null;
+  justifyContent: "flex-start" | "center" | "flex-end" | "space-between" | "space-around" | null;
+  padding: number | null;
+  flex: number | null;
+  wrap: boolean | null;
+}
+```
+
+#### Column
+
+Vertical flex layout.
+
+```typescript
+{
+  gap: number | null;
+  alignItems: "flex-start" | "center" | "flex-end" | "stretch" | null;
+  justifyContent: "flex-start" | "center" | "flex-end" | "space-between" | "space-around" | null;
+  padding: number | null;
+  flex: number | null;
+}
+```
+
+### Content
+
+#### Heading
+
+h1-h4 heading text with configurable color and alignment.
+
+```typescript
+{
+  text: string;
+  level: "h1" | "h2" | "h3" | "h4" | null;
+  color: string | null;
+  align: "left" | "center" | "right" | null;
+}
+```
+
+#### Text
+
+Body text with full styling control.
+
+```typescript
+{
+  text: string;
+  fontSize: number | null;
+  color: string | null;
+  align: "left" | "center" | "right" | null;
+  fontWeight: "normal" | "bold" | null;
+  fontStyle: "normal" | "italic" | null;
+  lineHeight: number | null;
+}
+```
+
+#### Image
+
+Image from a URL with optional dimensions and fit.
+
+```typescript
+{
+  src: string;
+  width: number | null;
+  height: number | null;
+  objectFit: "contain" | "cover" | "fill" | "none" | null;
+}
+```
+
+#### Link
+
+Hyperlink with visible text.
+
+```typescript
+{
+  text: string;
+  href: string;
+  fontSize: number | null;
+  color: string | null;
+}
+```
+
+### Data
+
+#### Table
+
+Data table with typed columns and string rows. Supports header styling and striped rows.
+
+```typescript
+{
+  columns: { header: string; width?: string; align?: "left" | "center" | "right" }[];
+  rows: string[][];
+  headerBackgroundColor: string | null;
+  headerTextColor: string | null;
+  borderColor: string | null;
+  fontSize: number | null;
+  striped: boolean | null;
+}
+```
+
+#### List
+
+Ordered or unordered list.
+
+```typescript
+{
+  items: string[];
+  ordered: boolean | null;
+  fontSize: number | null;
+  color: string | null;
+  spacing: number | null;
+}
+```
+
+### Decorative
+
+#### Divider
+
+Horizontal line separator.
+
+```typescript
+{
+  color: string | null;
+  thickness: number | null;
+  marginTop: number | null;
+  marginBottom: number | null;
+}
+```
+
+#### Spacer
+
+Empty vertical space.
+
+```typescript
+{
+  height: number | null;
+}
+```
+
+### Page-Level
+
+#### PageNumber
+
+Renders current page number and total pages. Format uses `{pageNumber}` and `{totalPages}` placeholders.
+
+```typescript
+{
+  format: string | null;    // default: "{pageNumber} / {totalPages}"
+  fontSize: number | null;
+  color: string | null;
+  align: "left" | "center" | "right" | null;
+}
+```
+
+## External Store (Controlled Mode)
+
+Pass a `StateStore` to `StateProvider`, `JSONUIProvider`, or `createRenderer` for full control over state:
+
+```tsx
+import { createStateStore, type StateStore } from "@json-render/react-pdf";
+
+const store = createStateStore({ invoice: { total: 100 } });
+store.set("/invoice/total", 200);
+```
+
+When `store` is provided, `initialState` / `state` and `onStateChange` are ignored.
+
+## Server-Safe Import
+
+Import schema and catalog definitions without pulling in React or `@react-pdf/renderer`:
+
+```typescript
+import { schema, standardComponentDefinitions } from '@json-render/react-pdf/server';
+```
+
+## Sub-path Exports
+
+<table>
+  <thead>
+    <tr>
+      <th>Export</th>
+      <th>Description</th>
+    </tr>
+  </thead>
+  <tbody>
+    <tr>
+      <td><code>@json-render/react-pdf</code></td>
+      <td>Full package: schema, renderer, components, render functions</td>
+    </tr>
+    <tr>
+      <td><code>@json-render/react-pdf/server</code></td>
+      <td>Schema and catalog definitions only (no React)</td>
+    </tr>
+    <tr>
+      <td><code>@json-render/react-pdf/catalog</code></td>
+      <td>Standard component definitions and types</td>
+    </tr>
+    <tr>
+      <td><code>@json-render/react-pdf/render</code></td>
+      <td>Server-side render functions only</td>
+    </tr>
+  </tbody>
+</table>
+
+## Types
+
+<table>
+  <thead>
+    <tr>
+      <th>Export</th>
+      <th>Description</th>
+    </tr>
+  </thead>
+  <tbody>
+    <tr>
+      <td><code>ReactPdfSchema</code></td>
+      <td>Schema type for PDF specs</td>
+    </tr>
+    <tr>
+      <td><code>ReactPdfSpec</code></td>
+      <td>Spec type for PDF documents</td>
+    </tr>
+    <tr>
+      <td><code>RenderOptions</code></td>
+      <td>Options for render functions</td>
+    </tr>
+    <tr>
+      <td><code>ComponentContext</code></td>
+      <td>Typed component render function context</td>
+    </tr>
+    <tr>
+      <td><code>ComponentFn</code></td>
+      <td>Component render function type</td>
+    </tr>
+    <tr>
+      <td><code>StandardComponentDefinitions</code></td>
+      <td>Type of the standard component definitions object</td>
+    </tr>
+    <tr>
+      <td><code>StandardComponentProps&lt;K&gt;</code></td>
+      <td>Inferred props type for a standard component by name</td>
+    </tr>
+  </tbody>
+</table>
@@ -1,4 +1,5 @@
-export const metadata = { title: "@json-render/react API" }
+import { pageMetadata } from "@/lib/page-metadata"
+export const metadata = pageMetadata("docs/api/react")

 # @json-render/react

@@ -9,11 +10,36 @@ React components, providers, and hooks.
 ### StateProvider

 ```tsx
-<StateProvider initialState={object}>
+<StateProvider initialState={object} onStateChange={fn}>
  {children}
 </StateProvider>
 ```

+| Prop | Type | Description |
+|------|------|-------------|
+| `store` | `StateStore` | External store (controlled mode). When provided, `initialState` and `onStateChange` are ignored. |
+| `initialState` | `Record<string, unknown>` | Initial state model (uncontrolled mode). |
+| `onStateChange` | `(changes: Array<{ path: string; value: unknown }>) => void` | Callback when state changes (uncontrolled mode). Called once per `set` or `update` with all changed entries. |
+
+#### External Store (Controlled Mode)
+
+Pass a `StateStore` to bypass the internal state and wire json-render to any state management library:
+
+```tsx
+import { createStateStore, type StateStore } from "@json-render/react";
+
+const store = createStateStore({ count: 0 });
+
+<StateProvider store={store}>
+  {children}
+</StateProvider>
+
+// Mutate from anywhere — React re-renders automatically:
+store.set("/count", 1);
+```
+
+The `store` prop is also available on `JSONUIProvider` and `createRenderer`.
+
 ### ActionProvider

 ```tsx
@@ -1,4 +1,5 @@
-export const metadata = { title: "@json-render/remotion API" }
+import { pageMetadata } from "@/lib/page-metadata"
+export const metadata = pageMetadata("docs/api/remotion")

 # @json-render/remotion

@@ -1,4 +1,5 @@
-export const metadata = { title: "@json-render/shadcn API" }
+import { pageMetadata } from "@/lib/page-metadata"
+export const metadata = pageMetadata("docs/api/shadcn")

 # @json-render/shadcn

@@ -1,4 +1,5 @@
-export const metadata = { title: "Catalog" }
+import { pageMetadata } from "@/lib/page-metadata"
+export const metadata = pageMetadata("docs/catalog")

 # Catalog

@@ -18,7 +19,7 @@ A catalog is the vocabulary for your UI. While the [schema](/docs/schemas) defin

 ```typescript
 import { defineCatalog } from '@json-render/core';
-import { schema } from '@json-render/react'; // or '@json-render/react-native'
+import { schema } from '@json-render/react/schema'; // or '@json-render/react-native/schema'
 import { z } from 'zod';

 const catalog = defineCatalog(schema, {
@@ -1,9 +1,74 @@
-export const metadata = { title: "Changelog" }
+import { pageMetadata } from "@/lib/page-metadata"
+export const metadata = pageMetadata("docs/changelog")

 # Changelog

 Notable changes and updates to json-render.

+## v0.9.1
+
+February 2026
+
+### Fixed: Install failure due to private dependency
+
+`@json-render/react`, `@json-render/react-pdf`, and `@json-render/react-native` v0.9.0 failed to install because `@internal/react-state` (a private workspace package) was published as a dependency. The internal package is now bundled into each renderer at build time, so it no longer needs to be resolved from npm.
+
+---
+
+## v0.9.0
+
+February 2026
+
+### New: External State Store
+
+The `StateStore` interface lets you plug in your own state management (Redux, Zustand, Jotai, XState, etc.) instead of the built-in internal store. Pass a `store` prop to `StateProvider`, `JSONUIProvider`, or `createRenderer` for controlled mode.
+
+- Added `StateStore` interface and `createStateStore()` factory to `@json-render/core`
+- `StateProvider`, `JSONUIProvider`, and `createRenderer` now accept an optional `store` prop
+- When `store` is provided, it becomes the single source of truth (`initialState`/`onStateChange` are ignored)
+- When `store` is omitted, everything works exactly as before (fully backward compatible)
+- Applied across all platform packages: react, react-native, react-pdf
+- Store utilities (`createStoreAdapter`, `immutableSetByPath`, `flattenToPointers`) available via `@json-render/core/store-utils` for building custom adapters
+
+New adapter packages: `@json-render/redux`, `@json-render/zustand`, `@json-render/jotai`.
+
+See the [Data Binding](/docs/data-binding#external-store-controlled-mode) guide for usage.
+
+### Changed: `onStateChange` signature updated (breaking)
+
+The `onStateChange` callback now receives a single array of changed entries instead of being called once per path. This makes batch updates via `update()` easier to handle:
+
+```ts
+// Before
+onStateChange?: (path: string, value: unknown) => void
+
+// After
+onStateChange?: (changes: Array<{ path: string; value: unknown }>) => void
+```
+
+The callback is only called when a `set()` or `update()` call actually changes the state. A `set()` call produces a single-element array; an `update()` call produces one array with all changed paths.
+
+### Fixed: Server-safe schema import
+
+`@json-render/react` barrel-imports React contexts that call `createContext`, which crashes in Next.js App Router API routes (RSC runtime strips `createContext`). All docs, examples, and skills now import `schema` from `@json-render/react/schema` instead of `@json-render/react`.
+
+For combined imports, split into separate `schema` (subpath) and client API (main entry) lines:
+
+```ts
+import { schema } from "@json-render/react/schema";
+import { defineRegistry, Renderer } from "@json-render/react";
+```
+
+### Fixed: Chaining actions
+
+Fixed an issue where chaining multiple actions on the same event (e.g. `setState` followed by a custom action) did not execute all actions. Affected `@json-render/react`, `@json-render/react-native`, and `@json-render/react-pdf`.
+
+### Fixed: Zod array inner type resolution
+
+Fixed safely resolving the inner type for Zod arrays in schema introspection, preventing errors when catalog component props use `z.array()`.
+
+---
+
 ## v0.8.0

 February 2026
@@ -1,4 +1,5 @@
-export const metadata = { title: "Code Export" }
+import { pageMetadata } from "@/lib/page-metadata"
+export const metadata = pageMetadata("docs/code-export")

 # Code Export

@@ -134,6 +135,6 @@ Run the dashboard example and click "Export Project" to see code generation in a
 ```bash
 cd examples/dashboard
 pnpm dev
-# Open http://localhost:3001
+# Open http://dashboard-demo.json-render.localhost:1355
 # Generate a widget, then click "Export Project"
 ```
@@ -0,0 +1,119 @@
+import { pageMetadata } from "@/lib/page-metadata"
+export const metadata = pageMetadata("docs/computed-values")
+
+# Computed Values
+
+Derive dynamic prop values using registered functions or string templates.
+
+## `$template` — String Interpolation
+
+Use `{ "$template": "..." }` to embed state values into a string. References use `${/path}` syntax where the path is a JSON Pointer:
+
+```json
+{
+  "type": "Text",
+  "props": {
+    "text": { "$template": "Hello, ${/user/name}! You have ${/inbox/count} messages." }
+  },
+  "children": []
+}
+```
+
+If state is `{ "user": { "name": "Alice" }, "inbox": { "count": 3 } }`, the text renders as "Hello, Alice! You have 3 messages."
+
+Missing paths resolve to an empty string.
+
+## `$computed` — Registered Functions
+
+Use `{ "$computed": "<name>", "args": { ... } }` to call a named function registered in your catalog. Each arg can be a literal value or any prop expression (`$state`, `$item`, `$cond`, etc.):
+
+```json
+{
+  "type": "Text",
+  "props": {
+    "text": {
+      "$computed": "fullName",
+      "args": {
+        "first": { "$state": "/form/firstName" },
+        "last": { "$state": "/form/lastName" }
+      }
+    }
+  },
+  "children": []
+}
+```
+
+### Registering Functions
+
+Functions are registered in the catalog and provided at runtime.
+
+**Catalog definition (for AI prompt generation):**
+
+```typescript
+import { defineCatalog } from '@json-render/core';
+import { schema } from '@json-render/react/schema';
+
+const catalog = defineCatalog(schema, {
+  components: { /* ... */ },
+  functions: {
+    fullName: {
+      description: 'Combines first and last name into a full name',
+    },
+    formatCurrency: {
+      description: 'Formats a number as currency',
+    },
+  },
+});
+```
+
+**Runtime implementation:**
+
+```tsx
+import { JSONUIProvider } from '@json-render/react';
+
+const functions = {
+  fullName: (args) => `${args.first ?? ''} ${args.last ?? ''}`.trim(),
+  formatCurrency: (args) => {
+    const value = Number(args.value ?? 0);
+    return new Intl.NumberFormat('en-US', {
+      style: 'currency',
+      currency: (args.currency as string) ?? 'USD',
+    }).format(value);
+  },
+};
+
+<JSONUIProvider registry={registry} functions={functions}>
+  <Renderer spec={spec} registry={registry} />
+</JSONUIProvider>
+```
+
+### Using with `createRenderer`
+
+```tsx
+const MyRenderer = createRenderer(catalog, components);
+
+<MyRenderer
+  spec={spec}
+  functions={functions}
+/>
+```
+
+## Combining Expressions
+
+`$computed` args can use any expression type. This example computes a total from repeat item fields:
+
+```json
+{
+  "$computed": "lineTotal",
+  "args": {
+    "price": { "$item": "price" },
+    "quantity": { "$item": "quantity" }
+  }
+}
+```
+
+## Next
+
+- [Watchers](/docs/watchers) — react to state changes with cascading actions
+- [Data Binding](/docs/data-binding) — all expression types
+- [Validation](/docs/validation) — validate form inputs
@@ -1,4 +1,5 @@
-export const metadata = { title: "Custom Schema & Renderer" }
+import { pageMetadata } from "@/lib/page-metadata"
+export const metadata = pageMetadata("docs/custom-schema")

 # Custom Schema & Renderer

@@ -1,4 +1,5 @@
-export const metadata = { title: "Data Binding" }
+import { pageMetadata } from "@/lib/page-metadata"
+export const metadata = pageMetadata("docs/data-binding")

 # Data Binding

@@ -212,6 +213,22 @@ Use `$cond` / `$then` / `$else` to pick a prop value based on a condition:

 The condition uses the same [visibility](/docs/visibility) expression format.

+## Template Strings
+
+Use `{ "$template": "..." }` to interpolate state values into a string using `${/path}` syntax:
+
+```json
+{
+  "type": "Text",
+  "props": {
+    "text": { "$template": "Welcome back, ${/user/name}!" }
+  },
+  "children": []
+}
+```
+
+See [Computed Values](/docs/computed-values) for details on `$template` and `$computed` expressions.
+
 ## Quick Reference

 <div className="my-6 overflow-x-auto">
@@ -254,10 +271,39 @@ The condition uses the same [visibility](/docs/visibility) expression format.
        <td><code>{'{ "$bindItem": "field" }'}</code></td>
        <td>Form components inside repeat</td>
      </tr>
+      <tr>
+        <td><code>{"$template"}</code></td>
+        <td><code>{'{ "$template": "Hello, ${/name}!" }'}</code></td>
+        <td>Anywhere (string props)</td>
+      </tr>
+      <tr>
+        <td><code>{"$computed"}</code></td>
+        <td><code>{'{ "$computed": "fn", "args": { ... } }'}</code></td>
+        <td>Anywhere (requires registered function)</td>
+      </tr>
    </tbody>
  </table>
 </div>

+## External Store (Controlled Mode)
+
+For advanced use cases, you can pass a `StateStore` to `StateProvider` to use your own state management (Redux, Zustand, XState, etc.) instead of the built-in internal store:
+
+```tsx
+import { createStateStore, type StateStore } from "@json-render/react";
+
+const store = createStateStore({ user: { name: "Alice" } });
+
+<StateProvider store={store}>
+  {children}
+</StateProvider>
+
+// Mutate from anywhere — React re-renders automatically:
+store.set("/user/name", "Bob");
+```
+
+When `store` is provided, `initialState` and `onStateChange` are ignored. The store is the single source of truth. See the [React API reference](/docs/api/react#external-store-controlled-mode) for the full `StateStore` interface.
+
 ## Next

 - [Visibility](/docs/visibility) — conditionally show or hide elements
@@ -1,4 +1,5 @@
-export const metadata = { title: "Generation Modes" }
+import { pageMetadata } from "@/lib/page-metadata"
+export const metadata = pageMetadata("docs/generation-modes")

 # Generation Modes

@@ -1,4 +1,5 @@
-export const metadata = { title: "Installation" }
+import { pageMetadata } from "@/lib/page-metadata"
+export const metadata = pageMetadata("docs/installation")

 # Installation

@@ -24,6 +25,18 @@ Requires Tailwind CSS in your project. See the [@json-render/shadcn API referenc

 <PackageInstall packages="@json-render/core @json-render/remotion remotion @remotion/player" />

+## For External State Management (Optional)
+
+If you want to wire json-render to an existing state management library instead of the built-in store, install the adapter for your library:
+
+<PackageInstall packages="@json-render/zustand" />
+
+<PackageInstall packages="@json-render/redux" />
+
+<PackageInstall packages="@json-render/jotai" />
+
+See the [Data Binding](/docs/data-binding#external-store-controlled-mode) guide for usage.
+
 ## Peer Dependencies

 json-render requires the following peer dependencies:
@@ -1,4 +1,5 @@
-export const metadata = { title: "Migration Guide" }
+import { pageMetadata } from "@/lib/page-metadata"
+export const metadata = pageMetadata("docs/migration")

 # Migration Guide

@@ -1,4 +1,5 @@
-export const metadata = { title: "OpenAPI Integration" }
+import { pageMetadata } from "@/lib/page-metadata"
+export const metadata = pageMetadata("docs/openapi")

 # OpenAPI Integration

@@ -99,7 +100,7 @@ Create components that map to OpenAPI data types:

 ```typescript
 import { defineCatalog } from '@json-render/core';
-import { schema } from '@json-render/react';
+import { schema } from '@json-render/react/schema';
 import { z } from 'zod';

 export const openapiCatalog = defineCatalog(schema, {
@@ -1,4 +1,5 @@
-export const metadata = { title: "Introduction" }
+import { pageMetadata } from "@/lib/page-metadata"
+export const metadata = pageMetadata("docs")

 # Introduction

@@ -22,7 +23,7 @@ A catalog declares what AI can use: components with typed props, actions with ty

 ```typescript
 import { defineCatalog } from '@json-render/core';
-import { schema } from '@json-render/react';
+import { schema } from '@json-render/react/schema';
 import { z } from 'zod';

 export const catalog = defineCatalog(schema, {
@@ -1,4 +1,5 @@
-export const metadata = { title: "Quick Start" }
+import { pageMetadata } from "@/lib/page-metadata"
+export const metadata = pageMetadata("docs/quick-start")

 # Quick Start

@@ -11,7 +12,7 @@ Create a catalog that defines what components AI can use:
 ```typescript
 // lib/catalog.ts
 import { defineCatalog } from '@json-render/core';
-import { schema } from '@json-render/react';
+import { schema } from '@json-render/react/schema';
 import { z } from 'zod';

 export const catalog = defineCatalog(schema, {
@@ -1,4 +1,5 @@
-export const metadata = { title: "Registry" }
+import { pageMetadata } from "@/lib/page-metadata"
+export const metadata = pageMetadata("docs/registry")

 # Registry

@@ -132,7 +133,7 @@ Actions are declared in your [catalog](/docs/catalog). The `@json-render/react`

 ```typescript
 import { defineCatalog } from '@json-render/core';
-import { schema } from '@json-render/react';
+import { schema } from '@json-render/react/schema';
 import { z } from 'zod';

 const catalog = defineCatalog(schema, {
@@ -1,4 +1,5 @@
-export const metadata = { title: "Schemas" }
+import { pageMetadata } from "@/lib/page-metadata"
+export const metadata = pageMetadata("docs/schemas")

 # Schemas

@@ -1,4 +1,5 @@
-export const metadata = { title: "Specs" }
+import { pageMetadata } from "@/lib/page-metadata"
+export const metadata = pageMetadata("docs/specs")

 # Specs

@@ -1,4 +1,5 @@
-export const metadata = { title: "Streaming" }
+import { pageMetadata } from "@/lib/page-metadata"
+export const metadata = pageMetadata("docs/streaming")

 # Streaming

@@ -1,4 +1,5 @@
-export const metadata = { title: "Validation" }
+import { pageMetadata } from "@/lib/page-metadata"
+export const metadata = pageMetadata("docs/validation")

 # Validation

@@ -10,11 +11,18 @@ json-render includes common validation functions:

 - `required` — Value must be non-empty
 - `email` — Valid email format
- `minLength` — Minimum string length
- `maxLength` — Maximum string length
- `pattern` — Match a regex pattern
- `min` — Minimum numeric value
- `max` — Maximum numeric value
+- `minLength` — Minimum string length (args: `{ "min": N }`)
+- `maxLength` — Maximum string length (args: `{ "max": N }`)
+- `pattern` — Match a regex pattern (args: `{ "pattern": "regex" }`)
+- `min` — Minimum numeric value (args: `{ "min": N }`)
+- `max` — Maximum numeric value (args: `{ "max": N }`)
+- `numeric` — Value must be a number
+- `url` — Valid URL format
+- `matches` — Must equal another field (args: `{ "other": { "$state": "/path" } }`)
+- `equalTo` — Alias for matches (args: `{ "other": { "$state": "/path" } }`)
+- `lessThan` — Value must be less than another field (args: `{ "other": { "$state": "/path" } }`)
+- `greaterThan` — Value must be greater than another field (args: `{ "other": { "$state": "/path" } }`)
+- `requiredIf` — Required only when another field is truthy (args: `{ "field": { "$state": "/path" } }`)

 ## Using Validation in JSON

@@ -66,7 +74,7 @@ Define custom validators in your catalog's `functions` field. The catalog itself

 ```typescript
 import { defineCatalog } from '@json-render/core';
-import { schema } from '@json-render/react'; // or '@json-render/react-native'
+import { schema } from '@json-render/react/schema'; // or '@json-render/react-native/schema'
 import { z } from 'zod';

 const catalog = defineCatalog(schema, {
@@ -142,14 +150,114 @@ function TextField({ props, bindings }) {

 See the [@json-render/react API reference](/docs/api/react) for full `ValidationProvider` and `useFieldValidation` documentation.

+## Cross-Field Validation
+
+Validation args support `{ "$state": "/path" }` references to compare against other fields. This enables cross-field rules like "confirm password must match password":
+
+```json
+{
+  "type": "Input",
+  "props": {
+    "label": "Confirm Password",
+    "value": { "$bindState": "/form/confirmPassword" },
+    "checks": [
+      { "type": "required", "message": "Please confirm your password" },
+      {
+        "type": "matches",
+        "args": { "other": { "$state": "/form/password" } },
+        "message": "Passwords must match"
+      }
+    ]
+  }
+}
+```
+
+Other cross-field examples:
+
+```json
+{
+  "checks": [
+    {
+      "type": "greaterThan",
+      "args": { "other": { "$state": "/form/startDate" } },
+      "message": "End date must be after start date"
+    }
+  ]
+}
+```
+
+```json
+{
+  "checks": [
+    {
+      "type": "requiredIf",
+      "args": { "field": { "$state": "/form/enableNotifications" } },
+      "message": "Email is required when notifications are enabled"
+    }
+  ]
+}
+```
+
+## Conditional Validation
+
+Use the `enabled` field in the validation config to only run checks when a condition is met:
+
+```json
+{
+  "type": "Input",
+  "props": {
+    "label": "Company Name",
+    "value": { "$bindState": "/form/company" },
+    "checks": [
+      { "type": "required", "message": "Company name is required" }
+    ]
+  }
+}
+```
+
+In the component implementation, you can pass `enabled` to `useFieldValidation`:
+
+```typescript
+useFieldValidation(bindings?.value ?? "", {
+  checks: props.checks ?? [],
+  enabled: { "$state": "/form/accountType", eq: "business" },
+});
+```
+
+This only validates the company name when the account type is "business".
+
 ## Validation Timing

 Control when validation runs with `validateOn`:

 - `change` — Validate on every input change
- `blur` — Validate when field loses focus
+- `blur` — Validate when field loses focus (default for Input, Textarea)
 - `submit` — Validate only on form submission

+## Form-Level Validation
+
+Use the built-in `validateForm` action to validate all registered fields at once. This is useful for a "Submit" button that should validate the entire form before proceeding:
+
+```json
+{
+  "type": "Button",
+  "props": { "label": "Submit" },
+  "on": {
+    "press": [
+      { "action": "validateForm", "params": { "statePath": "/formResult" } },
+      { "action": "submitForm" }
+    ]
+  },
+  "children": []
+}
+```
+
+The `validateForm` action runs `validateAll()` and writes `{ valid: boolean }` to the specified state path (defaults to `/formValidation`). Your submit handler can then check `{ "$state": "/formResult/valid" }` to decide whether to proceed.
+
+> **Note:** Actions in a list execute sequentially, but `submitForm` does not automatically gate on validation. Guard submission with a `$cond` visibility condition on the button or check `{ "$state": "/formResult/valid" }` inside your action handler to skip submission when the form is invalid.
+
 ## Next

-Learn about [generation modes](/docs/generation-modes).
+- [Computed Values](/docs/computed-values) — derive dynamic prop values
+- [Watchers](/docs/watchers) — react to state changes
+- [Generation Modes](/docs/generation-modes) — how AI generates specs
@@ -1,4 +1,5 @@
-export const metadata = { title: "Visibility" }
+import { pageMetadata } from "@/lib/page-metadata"
+export const metadata = pageMetadata("docs/visibility")

 # Visibility

@@ -0,0 +1,150 @@
+import { pageMetadata } from "@/lib/page-metadata"
+export const metadata = pageMetadata("docs/watchers")
+
+# Watchers
+
+React to state changes by triggering actions when watched paths update.
+
+## The `watch` Field
+
+Elements can have an optional `watch` field that maps state paths to action bindings. When the value at a watched path changes, the bound actions fire automatically.
+
+`watch` is a **top-level field** on the element (sibling of `type`, `props`, `children`) — not inside `props`.
+
+```json
+{
+  "type": "Select",
+  "props": {
+    "label": "Country",
+    "value": { "$bindState": "/form/country" },
+    "options": ["US", "Canada", "UK"]
+  },
+  "watch": {
+    "/form/country": {
+      "action": "loadCities",
+      "params": { "country": { "$state": "/form/country" } }
+    }
+  },
+  "children": []
+}
+```
+
+When the user selects a different country, the `loadCities` action fires with the new country value. The action handler can fetch city data and update state, causing a dependent city Select to re-render with new options.
+
+## Cascading Selects
+
+A common pattern is cascading dropdowns where selecting a value in one field loads options for another:
+
+```json
+{
+  "root": "form",
+  "elements": {
+    "form": {
+      "type": "Stack",
+      "props": { "direction": "vertical", "gap": "md" },
+      "children": ["country-select", "city-select"]
+    },
+    "country-select": {
+      "type": "Select",
+      "props": {
+        "label": "Country",
+        "value": { "$bindState": "/form/country" },
+        "options": ["US", "Canada", "UK"]
+      },
+      "watch": {
+        "/form/country": [
+          { "action": "loadCities", "params": { "country": { "$state": "/form/country" } } },
+          { "action": "setState", "params": { "statePath": "/form/city", "value": "" } }
+        ]
+      },
+      "children": []
+    },
+    "city-select": {
+      "type": "Select",
+      "props": {
+        "label": "City",
+        "value": { "$bindState": "/form/city" },
+        "options": { "$state": "/availableCities" },
+        "placeholder": "Select a city"
+      },
+      "children": []
+    }
+  },
+  "state": {
+    "form": { "country": "", "city": "" },
+    "availableCities": []
+  }
+}
+```
+
+The watcher on `country-select` fires two actions when the country changes:
+1. `loadCities` — fetches and writes city options to `/availableCities`
+2. `setState` — resets the city selection
+
+The city Select reads its options from `{ "$state": "/availableCities" }`, so it automatically updates when the data is loaded.
+
+### Action Handler
+
+```typescript
+const handlers = {
+  loadCities: async (params) => {
+    const cities = await fetchCities(params.country);
+    // setState is called by the runtime to write the result
+    return cities;
+  },
+};
+```
+
+Or with `defineRegistry`:
+
+```typescript
+const { registry, handlers } = defineRegistry(catalog, {
+  components: { /* ... */ },
+  actions: {
+    loadCities: async (params, setState) => {
+      const response = await fetch(`/api/cities?country=${params.country}`);
+      const cities = await response.json();
+      setState('/availableCities', cities);
+    },
+  },
+});
+```
+
+## Multiple Watchers
+
+An element can watch multiple state paths. Each path maps to one or more action bindings:
+
+```json
+{
+  "watch": {
+    "/form/startDate": { "action": "validateDateRange" },
+    "/form/endDate": { "action": "validateDateRange" },
+    "/form/quantity": [
+      { "action": "recalculateTotal" },
+      { "action": "checkInventory", "params": { "qty": { "$state": "/form/quantity" } } }
+    ]
+  }
+}
+```
+
+## Behavior
+
+- Watchers only fire on **value changes**, not on the initial render
+- Comparison is by reference (`===`), not deep equality
+- Action params support the same expressions as event bindings (`$state`, `$item`, `$index`)
+- Multiple action bindings on the same path execute sequentially
+
+## When to Use `watch` vs `on`
+
+| Mechanism | Trigger | Use Case |
+|-----------|---------|----------|
+| `on` | User interaction (press, change, blur) | Button clicks, input changes, form submissions |
+| `watch` | State value change (any source) | Cascading data, derived state, cross-field sync |
+
+Use `on` when reacting to direct user actions. Use `watch` when a state change (from any source — user input, action handler, or external store update) should trigger side effects.
+
+## Next
+
+- [Data Binding](/docs/data-binding) — connect elements to state
+- [Computed Values](/docs/computed-values) — derive prop values
+- [Visibility](/docs/visibility) — conditionally show or hide elements
@@ -154,23 +154,34 @@ button {
  margin-bottom: 0.5em;
 }

-/* MDX table styles — fallback for GFM-generated tables */
+/* MDX table styles — applies to both GFM pipe tables and raw HTML tables */
 .mdx-table th,
-.mdx-table td {
+.mdx-table td,
+article table th,
+article table td {
  border: 1px solid var(--border);
  padding: 0.75rem 1rem;
  text-align: left;
 }

-.mdx-table th {
+.mdx-table th,
+article table th {
  font-weight: 600;
  background-color: var(--muted);
 }

-.mdx-table td {
+.mdx-table td,
+article table td {
  color: var(--muted-foreground);
 }

+article table {
+  width: 100%;
+  font-size: 0.875rem;
+  border-collapse: collapse;
+  margin: 1.5rem 0;
+}
+
 /* Shiki dual theme support */
 .shiki,
 .shiki span {
@@ -1,5 +1,6 @@
 import type { Metadata } from "next";
 import localFont from "next/font/local";
+import { GeistPixelSquare } from "geist/font/pixel";
 import "./globals.css";
 import { ThemeProvider } from "@/components/theme-provider";
 import { DocsChat } from "@/components/docs-chat";
@@ -61,7 +62,6 @@ export const metadata: Metadata = {
    description:
      "The Generative UI framework. Generate dashboards, widgets, and apps from prompts — safely constrained to components you define.",
    images: ["/og"],
-    creator: "@verabornnot",
  },
  robots: {
    index: true,
@@ -92,7 +92,9 @@ export default async function RootLayout({
          />
        )}
      </head>
-      <body className={`${geistSans.variable} ${geistMono.variable}`}>
+      <body
+        className={`${geistSans.variable} ${geistMono.variable} ${GeistPixelSquare.variable}`}
+      >
        <ThemeProvider>
          {children}
          <DocsChat defaultOpen={chatOpen} defaultWidth={chatWidth} />
@@ -5,19 +5,20 @@ import { join } from "node:path";
 export { getPageTitle } from "@/lib/page-titles";

 // Cache font data in memory after first load
-let fontCache: { geistRegular: Buffer } | null = null;
+let fontCache: { geistRegular: Buffer; geistPixelSquare: Buffer } | null = null;

 async function loadFonts() {
  if (fontCache) return fontCache;
-  const geistRegular = await readFile(
-    join(process.cwd(), "public/Geist-Regular.ttf"),
-  );
-  fontCache = { geistRegular };
+  const [geistRegular, geistPixelSquare] = await Promise.all([
+    readFile(join(process.cwd(), "public/Geist-Regular.ttf")),
+    readFile(join(process.cwd(), "public/GeistPixel-Square.ttf")),
+  ]);
+  fontCache = { geistRegular, geistPixelSquare };
  return fontCache;
 }

 export async function renderOgImage(title: string) {
-  const { geistRegular } = await loadFonts();
+  const { geistRegular, geistPixelSquare } = await loadFonts();

  return new ImageResponse(
    <div
@@ -53,8 +54,8 @@ export async function renderOgImage(title: string) {
        <span
          style={{
            fontSize: 36,
-            fontFamily: "Geist",
-            fontWeight: 400,
+            fontFamily: "Geist Pixel Square",
+            fontWeight: 500,
            color: "white",
          }}
        >
@@ -99,6 +100,12 @@ export async function renderOgImage(title: string) {
          style: "normal",
          weight: 400,
        },
+        {
+          name: "Geist Pixel Square",
+          data: geistPixelSquare.buffer as ArrayBuffer,
+          style: "normal",
+          weight: 500,
+        },
      ],
    },
  );
@@ -1,10 +1,7 @@
 import { Playground } from "@/components/playground";
+import { pageMetadata } from "@/lib/page-metadata";

-import { PAGE_TITLES } from "@/lib/page-titles";
-
-export const metadata = {
-  title: PAGE_TITLES["playground"],
-};
+export const metadata = pageMetadata("playground");

 export default function PlaygroundPage() {
  return <Playground />;
@@ -57,7 +57,7 @@ export function Header() {
            </svg>
          </span>
          <Link href="/">
-            <span className="font-medium tracking-tight text-lg">
+            <span className="font-medium tracking-tight text-lg font-(family-name:--font-geist-pixel-square)">
              json-render
            </span>
          </Link>
@@ -16,17 +16,20 @@ import { CopyButton } from "./copy-button";
 import { Toaster } from "./ui/sonner";
 import { Header } from "./header";
 import { Sheet, SheetContent, SheetTitle } from "./ui/sheet";
+import { JsonEditor } from "@visual-json/react";
+import type { JsonValue } from "@visual-json/react";
 import { PlaygroundRenderer } from "@/lib/render/renderer";
 import { playgroundCatalog } from "@/lib/render/catalog";
 import { buildCatalogDisplayData } from "@/lib/render/catalog-display";

-type Tab = "json" | "nested" | "stream" | "catalog";
+type Tab = "json" | "nested" | "stream" | "catalog" | "visual";
 type RenderView = "preview" | "code";
 type MobileView =
  | "json"
  | "nested"
  | "stream"
  | "catalog"
+  | "visual"
  | "preview"
  | "generated-code";

@@ -233,6 +236,20 @@ export function Playground() {
    [handleSubmit],
  );

+  const handleVisualChange = useCallback(
+    (value: JsonValue) => {
+      if (!selectedVersionId || isStreaming) return;
+      setVersions((prev) =>
+        prev.map((v) =>
+          v.id === selectedVersionId
+            ? { ...v, tree: value as unknown as Spec }
+            : v,
+        ),
+      );
+    },
+    [selectedVersionId, isStreaming],
+  );
+
  const jsonCode = currentTree
    ? JSON.stringify(currentTree, null, 2)
    : "// waiting...";
@@ -479,31 +496,69 @@ ${jsx}
        ? jsonCode
        : activeTab === "nested"
          ? nestedCode
-          : "";
+          : activeTab === "visual"
+            ? jsonCode
+            : "";

  const codePane = (
    <div className="h-full flex flex-col border-t border-border">
      <div className="border-b border-border px-3 h-9 flex items-center gap-3">
-        {(["json", "nested", "stream", "catalog"] as const).map((tab) => (
-          <button
-            key={tab}
-            onClick={() => setActiveTab(tab)}
-            className={`text-xs font-mono transition-colors ${
-              activeTab === tab
-                ? "text-foreground"
-                : "text-muted-foreground hover:text-foreground"
-            }`}
-          >
-            {tab}
-          </button>
-        ))}
+        {(["json", "visual", "nested", "stream", "catalog"] as const).map(
+          (tab) => (
+            <button
+              key={tab}
+              onClick={() => setActiveTab(tab)}
+              className={`text-xs font-mono transition-colors ${
+                activeTab === tab
+                  ? "text-foreground"
+                  : "text-muted-foreground hover:text-foreground"
+              }`}
+            >
+              {tab}
+            </button>
+          ),
+        )}
        <div className="flex-1" />
-        {activeTab !== "catalog" && (
+        {activeTab !== "catalog" && activeTab !== "visual" && (
          <CopyButton text={copyText} className="text-muted-foreground" />
        )}
      </div>
      <div className="flex-1 overflow-auto">
-        {activeTab === "catalog" ? (
+        {activeTab === "visual" ? (
+          currentTree ? (
+            <JsonEditor
+              value={currentTree as unknown as JsonValue}
+              onChange={handleVisualChange}
+              readOnly={isStreaming}
+              sidebarOpen={false}
+              height="100%"
+              className="h-full"
+              style={
+                {
+                  "--vj-bg": "var(--background)",
+                  "--vj-bg-panel": "var(--background)",
+                  "--vj-bg-hover": "var(--muted)",
+                  "--vj-bg-selected": "var(--primary)",
+                  "--vj-bg-selected-muted": "var(--muted)",
+                  "--vj-text": "var(--foreground)",
+                  "--vj-text-selected": "var(--primary-foreground)",
+                  "--vj-text-muted": "var(--muted-foreground)",
+                  "--vj-text-dim": "var(--muted-foreground)",
+                  "--vj-border": "var(--border)",
+                  "--vj-border-subtle": "var(--border)",
+                  "--vj-accent": "var(--primary)",
+                  "--vj-accent-muted": "var(--muted)",
+                  "--vj-input-bg": "var(--secondary)",
+                  "--vj-input-border": "var(--border)",
+                } as React.CSSProperties
+              }
+            />
+          ) : (
+            <div className="text-muted-foreground/50 p-3 text-sm font-mono">
+              {"// generate a spec to edit visually"}
+            </div>
+          )
+        ) : activeTab === "catalog" ? (
          <div className="h-full flex flex-col text-sm">
            <div className="flex items-center gap-3 px-3 h-9 border-b border-border">
              {(
@@ -735,19 +790,21 @@ ${jsx}
              : 0}
          </button>
          {/* Code tabs */}
-          {(["json", "nested", "stream", "catalog"] as const).map((tab) => (
-            <button
-              key={tab}
-              onClick={() => setMobileView(tab)}
-              className={`text-xs font-mono transition-colors shrink-0 ${
-                mobileView === tab
-                  ? "text-foreground"
-                  : "text-muted-foreground hover:text-foreground"
-              }`}
-            >
-              {tab}
-            </button>
-          ))}
+          {(["json", "visual", "nested", "stream", "catalog"] as const).map(
+            (tab) => (
+              <button
+                key={tab}
+                onClick={() => setMobileView(tab)}
+                className={`text-xs font-mono transition-colors shrink-0 ${
+                  mobileView === tab
+                    ? "text-foreground"
+                    : "text-muted-foreground hover:text-foreground"
+                }`}
+              >
+                {tab}
+              </button>
+            ),
+          )}
          <div className="flex-1" />
          {/* Preview / code toggle */}
          {[
@@ -770,7 +827,41 @@ ${jsx}

        {/* Main content area */}
        <div className="flex-1 min-h-0 overflow-auto">
-          {mobileView === "catalog" ? (
+          {mobileView === "visual" ? (
+            currentTree ? (
+              <JsonEditor
+                value={currentTree as unknown as JsonValue}
+                onChange={handleVisualChange}
+                readOnly={isStreaming}
+                sidebarOpen={false}
+                height="100%"
+                className="h-full"
+                style={
+                  {
+                    "--vj-bg": "var(--background)",
+                    "--vj-bg-panel": "var(--background)",
+                    "--vj-bg-hover": "var(--muted)",
+                    "--vj-bg-selected": "var(--primary)",
+                    "--vj-bg-selected-muted": "var(--muted)",
+                    "--vj-text": "var(--foreground)",
+                    "--vj-text-selected": "var(--primary-foreground)",
+                    "--vj-text-muted": "var(--muted-foreground)",
+                    "--vj-text-dim": "var(--muted-foreground)",
+                    "--vj-border": "var(--border)",
+                    "--vj-border-subtle": "var(--border)",
+                    "--vj-accent": "var(--primary)",
+                    "--vj-accent-muted": "var(--muted)",
+                    "--vj-input-bg": "var(--secondary)",
+                    "--vj-input-border": "var(--border)",
+                  } as React.CSSProperties
+                }
+              />
+            ) : (
+              <div className="text-muted-foreground/50 p-3 text-sm font-mono">
+                {"// generate a spec to edit visually"}
+              </div>
+            )
+          ) : mobileView === "catalog" ? (
            <div className="h-full flex flex-col text-sm">
              <div className="flex items-center gap-3 px-3 h-9 border-b border-border">
                {(
@@ -1,4 +1,4 @@
-import { nextJsConfig } from "@repo/eslint-config/next-js";
+import { nextJsConfig } from "@internal/eslint-config/next-js";

 /** @type {import("eslint").Linter.Config[]} */
 export default [
@@ -27,7 +27,9 @@ export const docsNavigation: NavSection[] = [
      { title: "Schemas", href: "/docs/schemas" },
      { title: "Catalog", href: "/docs/catalog" },
      { title: "Data Binding", href: "/docs/data-binding" },
+      { title: "Computed Values", href: "/docs/computed-values" },
      { title: "Visibility", href: "/docs/visibility" },
+      { title: "Watchers", href: "/docs/watchers" },
      { title: "Validation", href: "/docs/validation" },
    ],
  },
@@ -57,6 +59,11 @@ export const docsNavigation: NavSection[] = [
        href: "https://github.com/vercel-labs/json-render/tree/main/examples/react-native",
        external: true,
      },
+      {
+        title: "React PDF",
+        href: "https://github.com/vercel-labs/json-render/tree/main/examples/react-pdf",
+        external: true,
+      },
      {
        title: "Remotion",
        href: "https://github.com/vercel-labs/json-render/tree/main/examples/remotion",
@@ -86,6 +93,7 @@ export const docsNavigation: NavSection[] = [
    items: [
      { title: "@json-render/core", href: "/docs/api/core" },
      { title: "@json-render/react", href: "/docs/api/react" },
+      { title: "@json-render/react-pdf", href: "/docs/api/react-pdf" },
      { title: "@json-render/shadcn", href: "/docs/api/shadcn" },
      { title: "@json-render/react-native", href: "/docs/api/react-native" },
      { title: "@json-render/remotion", href: "/docs/api/remotion" },
@@ -0,0 +1,39 @@
+import type { Metadata } from "next";
+import { PAGE_TITLES } from "./page-titles";
+
+const DESCRIPTION =
+  "The Generative UI framework. Generate dashboards, widgets, and apps from prompts — safely constrained to components you define.";
+
+export function pageMetadata(slug: string): Metadata {
+  const title = PAGE_TITLES[slug];
+  if (!title) return {};
+
+  const displayTitle = title.replace(/\n/g, " ");
+  const fullTitle = `${displayTitle} | json-render`;
+  const ogImageUrl = slug ? `/og/${slug}` : "/og";
+
+  return {
+    title: displayTitle,
+    openGraph: {
+      type: "website",
+      locale: "en_US",
+      siteName: "json-render",
+      title: fullTitle,
+      description: DESCRIPTION,
+      images: [
+        {
+          url: ogImageUrl,
+          width: 1200,
+          height: 630,
+          alt: `${displayTitle} - json-render`,
+        },
+      ],
+    },
+    twitter: {
+      card: "summary_large_image",
+      title: fullTitle,
+      description: DESCRIPTION,
+      images: [ogImageUrl],
+    },
+  };
+}
@@ -38,9 +38,11 @@ export const PAGE_TITLES: Record<string, string> = {
  // API references
  "docs/api/core": "@json-render/core API",
  "docs/api/react": "@json-render/react API",
+  "docs/api/react-pdf": "@json-render/react-pdf API",
  "docs/api/react-native": "@json-render/react-native API",
  "docs/api/codegen": "@json-render/codegen API",
  "docs/api/remotion": "@json-render/remotion API",
+  "docs/api/shadcn": "@json-render/shadcn API",
 };

 /**
@@ -1,11 +1,11 @@
 {
  "name": "web",
-  "version": "0.1.0",
+  "version": "0.1.2",
  "type": "module",
  "private": true,
  "license": "Apache-2.0",
  "scripts": {
-    "dev": "next dev --turbopack",
+    "dev": "portless json-render next dev --turbopack",
    "build": "next build",
    "start": "next start",
    "lint": "eslint --max-warnings 0",
@@ -28,11 +28,13 @@
    "@upstash/redis": "^1.36.1",
    "@vercel/analytics": "^1.6.1",
    "@vercel/speed-insights": "^1.3.1",
+    "@visual-json/react": "0.1.1",
    "ai": "^6.0.33",
    "bash-tool": "1.3.14",
    "class-variance-authority": "^0.7.1",
    "clsx": "^2.1.1",
    "embla-carousel-react": "^8.6.0",
+    "geist": "1.7.0",
    "just-bash": "2.9.6",
    "lucide-react": "^0.562.0",
    "next": "16.1.1",
@@ -51,8 +53,8 @@
    "zod": "^4.0.0"
  },
  "devDependencies": {
-    "@repo/eslint-config": "workspace:*",
-    "@repo/typescript-config": "workspace:*",
+    "@internal/eslint-config": "workspace:*",
+    "@internal/typescript-config": "workspace:*",
    "@tailwindcss/postcss": "^4.1.18",
    "@types/mdx": "^2.0.13",
    "@types/node": "^22.15.3",
@@ -1,5 +1,5 @@
 {
-  "extends": "@repo/typescript-config/nextjs.json",
+  "extends": "@internal/typescript-config/nextjs.json",
  "compilerOptions": {
    "plugins": [
      {
@@ -0,0 +1,19 @@
+# example-chat
+
+## 0.1.2
+
+### Patch Changes
+
+- Updated dependencies [b103676]
+  - @json-render/react@0.9.1
+  - @json-render/shadcn@0.9.1
+  - @json-render/core@0.9.1
+
+## 0.1.1
+
+### Patch Changes
+
+- Updated dependencies [1d755c1]
+  - @json-render/core@0.9.0
+  - @json-render/react@0.9.0
+  - @json-render/shadcn@0.9.0
@@ -1,4 +1,4 @@
-import { nextJsConfig } from "@repo/eslint-config/next-js";
+import { nextJsConfig } from "@internal/eslint-config/next-js";

 /** @type {import("eslint").Linter.Config[]} */
 export default [
@@ -1,6 +1,6 @@
 /// <reference types="next" />
 /// <reference types="next/image-types/global" />
-import "./.next/types/routes.d.ts";
+import "./.next/dev/types/routes.d.ts";

 // NOTE: This file should not be edited
 // see https://nextjs.org/docs/app/api-reference/config/typescript for more information.
@@ -1,10 +1,10 @@
 {
  "name": "example-chat",
-  "version": "0.1.0",
+  "version": "0.1.2",
  "type": "module",
  "private": true,
  "scripts": {
-    "dev": "next dev --turbopack",
+    "dev": "portless chat-demo.json-render next dev --turbopack",
    "build": "next build",
    "start": "next start",
    "lint": "eslint --max-warnings 0",
@@ -36,7 +36,7 @@
    "zod": "4.3.5"
  },
  "devDependencies": {
-    "@repo/eslint-config": "workspace:*",
+    "@internal/eslint-config": "workspace:*",
    "@tailwindcss/postcss": "^4.1.18",
    "@types/node": "^22.10.0",
    "@types/react": "19.2.3",
@@ -0,0 +1,19 @@
+# example-dashboard
+
+## 0.1.2
+
+### Patch Changes
+
+- Updated dependencies [b103676]
+  - @json-render/react@0.9.1
+  - @json-render/core@0.9.1
+  - @json-render/codegen@0.9.1
+
+## 0.1.1
+
+### Patch Changes
+
+- Updated dependencies [1d755c1]
+  - @json-render/core@0.9.0
+  - @json-render/react@0.9.0
+  - @json-render/codegen@0.9.0
@@ -196,24 +196,28 @@ export function Widget({
    onDeleted?.();
  }, [widgetId, onDeleted]);

-  const handleStateChange = useCallback((path: string, value: unknown) => {
-    setState((prev) => {
-      const next = { ...prev };
-      // Convert path like "customerForm/name" to nested object
-      const parts = path.split("/");
-      let current: Record<string, unknown> = next;
-      for (let i = 0; i < parts.length - 1; i++) {
-        const part = parts[i]!;
-        if (!(part in current) || typeof current[part] !== "object") {
-          current[part] = {};
+  const handleStateChange = useCallback(
+    (changes: Array<{ path: string; value: unknown }>) => {
+      setState((prev) => {
+        const next = { ...prev };
+        for (const { path, value } of changes) {
+          const parts = path.split("/");
+          let current: Record<string, unknown> = next;
+          for (let i = 0; i < parts.length - 1; i++) {
+            const part = parts[i]!;
+            if (!(part in current) || typeof current[part] !== "object") {
+              current[part] = {};
+            }
+            current = current[part] as Record<string, unknown>;
+          }
+          const lastPart = parts[parts.length - 1]!;
+          current[lastPart] = value;
        }
-        current = current[part] as Record<string, unknown>;
-      }
-      const lastPart = parts[parts.length - 1]!;
-      current[lastPart] = value;
-      return next;
-    });
-  }, []);
+        return next;
+      });
+    },
+    [],
+  );

  // Use spec from stream, or initial spec for saved widgets
  const currentSpec = spec || initialSpec;
@@ -1,4 +1,4 @@
-import { nextJsConfig } from "@repo/eslint-config/next-js";
+import { nextJsConfig } from "@internal/eslint-config/next-js";

 /** @type {import("eslint").Linter.Config[]} */
 export default [
@@ -24,7 +24,7 @@ interface DashboardRendererProps {
  spec: Spec | null;
  state?: Record<string, unknown>;
  setState?: SetState;
-  onStateChange?: (path: string, value: unknown) => void;
+  onStateChange?: (changes: Array<{ path: string; value: unknown }>) => void;
  loading?: boolean;
 }

@@ -1,6 +1,6 @@
 /// <reference types="next" />
 /// <reference types="next/image-types/global" />
-import "./.next/types/routes.d.ts";
+import "./.next/dev/types/routes.d.ts";

 // NOTE: This file should not be edited
 // see https://nextjs.org/docs/app/api-reference/config/typescript for more information.
@@ -1,10 +1,10 @@
 {
  "name": "example-dashboard",
-  "version": "0.1.0",
+  "version": "0.1.2",
  "type": "module",
  "private": true,
  "scripts": {
-    "dev": "next dev --turbopack",
+    "dev": "portless dashboard-demo.json-render next dev --turbopack",
    "build": "next build",
    "start": "next start",
    "lint": "eslint --max-warnings 0",
@@ -42,7 +42,7 @@
    "zod": "^4.0.0"
  },
  "devDependencies": {
-    "@repo/eslint-config": "workspace:*",
+    "@internal/eslint-config": "workspace:*",
    "@tailwindcss/postcss": "^4.1.18",
    "@types/node": "^22.10.0",
    "@types/react": "19.2.3",
@@ -0,0 +1,19 @@
+# example-no-ai
+
+## 0.1.2
+
+### Patch Changes
+
+- Updated dependencies [b103676]
+  - @json-render/react@0.9.1
+  - @json-render/shadcn@0.9.1
+  - @json-render/core@0.9.1
+
+## 0.1.1
+
+### Patch Changes
+
+- Updated dependencies [1d755c1]
+  - @json-render/core@0.9.0
+  - @json-render/react@0.9.0
+  - @json-render/shadcn@0.9.0
@@ -2,33 +2,31 @@

 import { useState, useEffect, useCallback, type ReactNode } from "react";
 import ConfettiExplosion from "react-confetti-explosion";
-import {
-  Renderer,
-  StateProvider,
-  VisibilityProvider,
-  ActionProvider,
-  ValidationProvider,
-} from "@json-render/react";
+import { JSONUIProvider, Renderer } from "@json-render/react";
 import type { Spec } from "@json-render/core";
-import { registry, actionHandlers, onConfetti } from "@/lib/render/registry";
+import {
+  registry,
+  actionHandlers,
+  computedFunctions,
+  onConfetti,
+} from "@/lib/render/registry";
 import { examples } from "@/lib/examples";

 function SpecRenderer({ spec }: { spec: Spec }): ReactNode {
  return (
-    <StateProvider initialState={spec.state ?? {}}>
-      <VisibilityProvider>
-        <ActionProvider handlers={actionHandlers}>
-          <ValidationProvider>
-            <Renderer spec={spec} registry={registry} />
-          </ValidationProvider>
-        </ActionProvider>
-      </VisibilityProvider>
-    </StateProvider>
+    <JSONUIProvider
+      registry={registry}
+      initialState={spec.state ?? {}}
+      handlers={actionHandlers}
+      functions={computedFunctions}
+    >
+      <Renderer spec={spec} registry={registry} />
+    </JSONUIProvider>
  );
 }

 export default function Page() {
-  const [selectedIndex] = useState(0);
+  const [selectedIndex, setSelectedIndex] = useState(0);
  const selected = examples[selectedIndex]!;
  const [confettiKey, setConfettiKey] = useState(0);
  const [confettiActive, setConfettiActive] = useState(false);
@@ -41,30 +39,50 @@ export default function Page() {
  useEffect(() => onConfetti(fireConfetti), [fireConfetti]);

  return (
-    <div className="h-screen flex items-center justify-center bg-muted/30">
-      <div
-        className="relative bg-background border rounded-lg shadow-sm"
-        style={{ width: 960, height: 1080 }}
-      >
-        {confettiActive && (
-          <div className="absolute inset-0 flex items-center justify-center pointer-events-none">
-            <ConfettiExplosion
-              key={confettiKey}
-              portal={false}
-              force={0.8}
-              duration={3500}
-              particleCount={400}
-              particleSize={8}
-              colors={["#00F0FF", "#7B61FF", "#FF3DFF", "#00FF94", "#FFE14D"]}
-              width={1600}
-              height="200vh"
-              zIndex={1}
-              onComplete={() => setConfettiActive(false)}
-            />
+    <div className="h-screen flex flex-col bg-muted/30">
+      {/* Example selector */}
+      <nav className="flex gap-1 p-3 overflow-x-auto border-b bg-background shrink-0">
+        {examples.map((ex, i) => (
+          <button
+            key={ex.name}
+            onClick={() => setSelectedIndex(i)}
+            className={`px-3 py-1.5 text-sm rounded-md whitespace-nowrap transition-colors ${
+              i === selectedIndex
+                ? "bg-primary text-primary-foreground"
+                : "hover:bg-muted"
+            }`}
+          >
+            {ex.name}
+          </button>
+        ))}
+      </nav>
+
+      {/* Render area */}
+      <div className="flex-1 flex items-start justify-center overflow-auto p-6">
+        <div className="relative bg-background border rounded-lg shadow-sm w-full max-w-[960px]">
+          {confettiActive && (
+            <div className="absolute inset-0 flex items-center justify-center pointer-events-none">
+              <ConfettiExplosion
+                key={confettiKey}
+                portal={false}
+                force={0.8}
+                duration={3500}
+                particleCount={400}
+                particleSize={8}
+                colors={["#00F0FF", "#7B61FF", "#FF3DFF", "#00FF94", "#FFE14D"]}
+                width={1600}
+                height="200vh"
+                zIndex={1}
+                onComplete={() => setConfettiActive(false)}
+              />
+            </div>
+          )}
+          <div className="p-6 relative z-10">
+            <p className="text-xs text-muted-foreground mb-4">
+              {selected.description}
+            </p>
+            <SpecRenderer key={selectedIndex} spec={selected.spec} />
          </div>
-        )}
-        <div className="h-full overflow-auto p-6 flex items-center justify-center relative z-10">
-          <SpecRenderer key={selectedIndex} spec={selected.spec} />
        </div>
      </div>
    </div>
@@ -1,4 +1,4 @@
-import { nextJsConfig } from "@repo/eslint-config/next-js";
+import { nextJsConfig } from "@internal/eslint-config/next-js";

 /** @type {import("eslint").Linter.Config[]} */
 export default [
@@ -508,4 +508,353 @@ export const examples: Example[] = [
      },
    },
  },
+
+  // =========================================================================
+  // Advanced: Registration form with cross-field validation & $template
+  // =========================================================================
+  {
+    name: "Registration Form",
+    description:
+      "Cross-field validation, $template preview, and validateForm action",
+    spec: {
+      root: "card",
+      state: {
+        form: {
+          name: "",
+          email: "",
+          password: "",
+          confirmPassword: "",
+          accountType: "personal",
+          company: "",
+        },
+        result: null,
+      },
+      elements: {
+        card: {
+          type: "Card",
+          props: {
+            title: "Create Account",
+            description: "Fill out the form below to register",
+            maxWidth: "md",
+            centered: null,
+          },
+          children: ["formStack"],
+        },
+        formStack: {
+          type: "Stack",
+          props: {
+            direction: "vertical",
+            gap: "md",
+            align: null,
+            justify: null,
+          },
+          children: [
+            "preview",
+            "sep0",
+            "nameInput",
+            "emailInput",
+            "passwordInput",
+            "confirmInput",
+            "sep1",
+            "accountTypeRadio",
+            "companyInput",
+            "sep2",
+            "actions",
+            "statusText",
+          ],
+        },
+
+        // $template live preview
+        preview: {
+          type: "Text",
+          props: {
+            text: {
+              $template: "Welcome, ${/form/name}! Your email: ${/form/email}",
+            },
+            variant: "muted",
+          },
+          visible: { $state: "/form/name", neq: "" },
+          children: [],
+        },
+        sep0: { type: "Separator", props: { orientation: null }, children: [] },
+
+        nameInput: {
+          type: "Input",
+          props: {
+            label: "Full Name",
+            name: "name",
+            type: "text",
+            placeholder: "Jane Doe",
+            value: { $bindState: "/form/name" },
+            checks: [
+              { type: "required", message: "Name is required" },
+              {
+                type: "minLength",
+                args: { min: 2 },
+                message: "Name must be at least 2 characters",
+              },
+            ],
+            validateOn: "blur",
+          },
+          children: [],
+        },
+        emailInput: {
+          type: "Input",
+          props: {
+            label: "Email",
+            name: "email",
+            type: "email",
+            placeholder: "jane@example.com",
+            value: { $bindState: "/form/email" },
+            checks: [
+              { type: "required", message: "Email is required" },
+              { type: "email", message: "Enter a valid email address" },
+            ],
+            validateOn: "blur",
+          },
+          children: [],
+        },
+        passwordInput: {
+          type: "Input",
+          props: {
+            label: "Password",
+            name: "password",
+            type: "password",
+            placeholder: "At least 8 characters",
+            value: { $bindState: "/form/password" },
+            checks: [
+              { type: "required", message: "Password is required" },
+              {
+                type: "minLength",
+                args: { min: 8 },
+                message: "Password must be at least 8 characters",
+              },
+            ],
+            validateOn: "blur",
+          },
+          children: [],
+        },
+        confirmInput: {
+          type: "Input",
+          props: {
+            label: "Confirm Password",
+            name: "confirmPassword",
+            type: "password",
+            placeholder: "Re-enter your password",
+            value: { $bindState: "/form/confirmPassword" },
+            checks: [
+              { type: "required", message: "Please confirm your password" },
+              {
+                type: "matches",
+                args: { other: { $state: "/form/password" } },
+                message: "Passwords must match",
+              },
+            ],
+            validateOn: "blur",
+          },
+          children: [],
+        },
+        sep1: { type: "Separator", props: { orientation: null }, children: [] },
+
+        accountTypeRadio: {
+          type: "Radio",
+          props: {
+            label: "Account Type",
+            name: "accountType",
+            options: ["personal", "business"],
+            value: { $bindState: "/form/accountType" },
+            checks: null,
+            validateOn: null,
+          },
+          children: [],
+        },
+        companyInput: {
+          type: "Input",
+          props: {
+            label: "Company Name",
+            name: "company",
+            type: "text",
+            placeholder: "Acme Inc.",
+            value: { $bindState: "/form/company" },
+            checks: [
+              {
+                type: "requiredIf",
+                args: { field: { $state: "/form/accountType" } },
+                message: "Company name is required for business accounts",
+              },
+            ],
+            validateOn: "blur",
+          },
+          visible: { $state: "/form/accountType", eq: "business" },
+          children: [],
+        },
+        sep2: { type: "Separator", props: { orientation: null }, children: [] },
+
+        actions: {
+          type: "Stack",
+          props: {
+            direction: "horizontal",
+            gap: "sm",
+            align: null,
+            justify: "end",
+          },
+          children: ["submitBtn"],
+        },
+        submitBtn: {
+          type: "Button",
+          props: { label: "Register", variant: "primary", disabled: null },
+          on: {
+            press: [
+              {
+                action: "validateForm",
+                params: { statePath: "/result" },
+              },
+            ],
+          },
+          children: [],
+        },
+
+        // Validation result
+        statusText: {
+          type: "Alert",
+          props: {
+            title: "Validation Result",
+            message: {
+              $cond: { $state: "/result/valid", eq: true },
+              $then: "All fields are valid -- ready to submit!",
+              $else: "Please fix the errors above before submitting.",
+            },
+            type: {
+              $cond: { $state: "/result/valid", eq: true },
+              $then: "success",
+              $else: "error",
+            },
+          },
+          visible: { $state: "/result", neq: null },
+          children: [],
+        },
+      },
+    },
+  },
+
+  // =========================================================================
+  // Advanced: Cascading selects with watchers & $computed
+  // =========================================================================
+  {
+    name: "Cascading Selects",
+    description:
+      "Watchers reset dependent fields, $computed derives display values",
+    spec: {
+      root: "card",
+      state: {
+        form: { country: "", city: "" },
+        availableCities: [],
+      },
+      elements: {
+        card: {
+          type: "Card",
+          props: {
+            title: "Shipping Address",
+            description: "Select your country to load available cities",
+            maxWidth: "md",
+            centered: null,
+          },
+          children: ["formStack"],
+        },
+        formStack: {
+          type: "Stack",
+          props: {
+            direction: "vertical",
+            gap: "md",
+            align: null,
+            justify: null,
+          },
+          children: [
+            "countrySelect",
+            "citySelect",
+            "sep",
+            "addressPreview",
+            "templatePreview",
+          ],
+        },
+
+        countrySelect: {
+          type: "Select",
+          props: {
+            label: "Country",
+            name: "country",
+            options: ["US", "Canada", "UK", "Germany", "Japan"],
+            placeholder: "Choose a country",
+            value: { $bindState: "/form/country" },
+            checks: [{ type: "required", message: "Country is required" }],
+            validateOn: "change",
+          },
+          watch: {
+            "/form/country": [
+              {
+                action: "setState",
+                params: {
+                  statePath: "/availableCities",
+                  value: {
+                    $computed: "citiesForCountry",
+                    args: { country: { $state: "/form/country" } },
+                  },
+                },
+              },
+              {
+                action: "setState",
+                params: { statePath: "/form/city", value: "" },
+              },
+            ],
+          },
+          children: [],
+        },
+
+        citySelect: {
+          type: "Select",
+          props: {
+            label: "City",
+            name: "city",
+            options: { $state: "/availableCities" },
+            placeholder: "Select a city",
+            value: { $bindState: "/form/city" },
+            checks: [{ type: "required", message: "City is required" }],
+            validateOn: "change",
+          },
+          children: [],
+        },
+        sep: { type: "Separator", props: { orientation: null }, children: [] },
+
+        // $computed formatted address
+        addressPreview: {
+          type: "Heading",
+          props: {
+            text: {
+              $computed: "formatAddress",
+              args: {
+                city: { $state: "/form/city" },
+                country: { $state: "/form/country" },
+              },
+            },
+            level: "h3",
+          },
+          children: [],
+        },
+
+        // $template string interpolation
+        templatePreview: {
+          type: "Text",
+          props: {
+            text: {
+              $template:
+                "Shipping to: ${/form/city} in ${/form/country}. Cities available: ${/availableCities}",
+            },
+            variant: "muted",
+          },
+          visible: { $state: "/form/country", neq: "" },
+          children: [],
+        },
+      },
+    },
+  },
 ];
@@ -13,4 +13,13 @@ export const catalog = defineCatalog(schema, {
      description: "Fire confetti",
    },
  },
+  functions: {
+    formatAddress: {
+      description:
+        "Formats country and city into a single address string like 'City, Country'",
+    },
+    citiesForCountry: {
+      description: "Returns an array of city names for the given country code",
+    },
+  },
 });
@@ -1,6 +1,7 @@
 "use client";

 import { defineRegistry } from "@json-render/react";
+import type { ComputedFunction } from "@json-render/core";
 import { shadcnComponents } from "@json-render/shadcn";
 import { catalog } from "./catalog";

@@ -13,6 +14,14 @@ export function onConfetti(cb: () => void) {
  };
 }

+const cityData: Record<string, string[]> = {
+  US: ["New York", "Los Angeles", "Chicago", "Houston", "Phoenix"],
+  Canada: ["Toronto", "Vancouver", "Montreal", "Calgary", "Ottawa"],
+  UK: ["London", "Manchester", "Birmingham", "Edinburgh", "Bristol"],
+  Germany: ["Berlin", "Munich", "Hamburg", "Frankfurt", "Cologne"],
+  Japan: ["Tokyo", "Osaka", "Kyoto", "Yokohama", "Sapporo"],
+};
+
 export const { registry } = defineRegistry(catalog, {
  components: {
    ...shadcnComponents,
@@ -24,6 +33,23 @@ export const { registry } = defineRegistry(catalog, {
  },
 });

-export const actionHandlers: Record<string, () => void> = {
+export const actionHandlers: Record<
+  string,
+  (params: Record<string, unknown>) => void
+> = {
  confetti: () => confettiListener?.(),
 };
+
+export const computedFunctions: Record<string, ComputedFunction> = {
+  formatAddress: (args) => {
+    const city = (args.city as string) ?? "";
+    const country = (args.country as string) ?? "";
+    if (!city && !country) return "No location selected";
+    if (!city) return country;
+    return `${city}, ${country}`;
+  },
+  citiesForCountry: (args) => {
+    const country = (args.country as string) ?? "";
+    return cityData[country] ?? [];
+  },
+};
@@ -1,6 +1,6 @@
 /// <reference types="next" />
 /// <reference types="next/image-types/global" />
-import "./.next/types/routes.d.ts";
+import "./.next/dev/types/routes.d.ts";

 // NOTE: This file should not be edited
 // see https://nextjs.org/docs/app/api-reference/config/typescript for more information.
@@ -1,10 +1,10 @@
 {
  "name": "example-no-ai",
-  "version": "0.1.0",
+  "version": "0.1.2",
  "type": "module",
  "private": true,
  "scripts": {
-    "dev": "next dev --turbopack --port 3003",
+    "dev": "portless no-ai-demo.json-render next dev --turbopack",
    "build": "next build",
    "start": "next start",
    "lint": "eslint --max-warnings 0",
@@ -26,7 +26,7 @@
    "zod": "4.3.5"
  },
  "devDependencies": {
-    "@repo/eslint-config": "workspace:*",
+    "@internal/eslint-config": "workspace:*",
    "@tailwindcss/postcss": "^4.1.18",
    "@types/node": "^22.10.0",
    "@types/react": "19.2.3",
@@ -0,0 +1,5 @@
+<template>
+  <div id="app">
+    <NuxtPage />
+  </div>
+</template>
@@ -0,0 +1 @@
+@import "tailwindcss";
@@ -0,0 +1,399 @@
+import type { Spec } from "@json-render/core";
+
+export interface Example {
+  name: string;
+  description: string;
+  spec: Spec;
+}
+
+export const examples: Example[] = [
+  {
+    name: "User Profile Card",
+    description: "A card with user info, badges, and a progress bar",
+    spec: {
+      root: "card",
+      elements: {
+        card: {
+          type: "Card",
+          props: {
+            title: "User Profile",
+            description: null,
+            maxWidth: "md",
+            centered: null,
+          },
+          children: ["stack"],
+        },
+        stack: {
+          type: "Stack",
+          props: {
+            direction: "vertical",
+            gap: "md",
+            align: null,
+            justify: null,
+          },
+          children: ["heading", "text", "badges", "sep", "progress"],
+        },
+        heading: {
+          type: "Heading",
+          props: { text: "Jane Cooper", level: "h2" },
+        },
+        text: {
+          type: "Text",
+          props: {
+            text: "Senior software engineer based in San Francisco. Passionate about building accessible, high-performance web applications.",
+            variant: "muted",
+          },
+        },
+        badges: {
+          type: "Stack",
+          props: {
+            direction: "horizontal",
+            gap: "sm",
+            align: null,
+            justify: null,
+          },
+          children: ["b1", "b2", "b3"],
+        },
+        b1: {
+          type: "Badge",
+          props: { text: "TypeScript", variant: "default" },
+        },
+        b2: { type: "Badge", props: { text: "Vue", variant: "secondary" } },
+        b3: { type: "Badge", props: { text: "Node.js", variant: "outline" } },
+        sep: { type: "Separator", props: { orientation: null } },
+        progress: {
+          type: "Progress",
+          props: { value: 72, max: 100, label: "Profile completion" },
+        },
+      },
+    },
+  },
+
+  {
+    name: "Settings Form",
+    description: "A form with inputs, selects, and switches",
+    spec: {
+      root: "card",
+      state: {
+        name: "Ada Lovelace",
+        email: "ada@example.com",
+        role: "Engineer",
+        notifications: true,
+        darkMode: false,
+      },
+      elements: {
+        card: {
+          type: "Card",
+          props: {
+            title: "Account Settings",
+            description: "Manage your preferences",
+            maxWidth: "md",
+            centered: null,
+          },
+          children: ["form"],
+        },
+        form: {
+          type: "Stack",
+          props: {
+            direction: "vertical",
+            gap: "md",
+            align: null,
+            justify: null,
+          },
+          children: [
+            "nameInput",
+            "emailInput",
+            "roleSelect",
+            "sep",
+            "notifSwitch",
+            "darkSwitch",
+            "sep2",
+            "actions",
+          ],
+        },
+        nameInput: {
+          type: "Input",
+          props: {
+            label: "Full Name",
+            name: "name",
+            type: "text",
+            placeholder: "Your name",
+            value: { $bindState: "/name" },
+            checks: null,
+          },
+        },
+        emailInput: {
+          type: "Input",
+          props: {
+            label: "Email",
+            name: "email",
+            type: "email",
+            placeholder: "you@example.com",
+            value: { $bindState: "/email" },
+            checks: null,
+          },
+        },
+        roleSelect: {
+          type: "Select",
+          props: {
+            label: "Role",
+            name: "role",
+            options: [
+              "Engineer",
+              "Designer",
+              "Product Manager",
+              "Data Scientist",
+            ],
+            placeholder: "Choose a role",
+            value: { $bindState: "/role" },
+            checks: null,
+          },
+        },
+        sep: { type: "Separator", props: { orientation: null } },
+        notifSwitch: {
+          type: "Switch",
+          props: {
+            label: "Email notifications",
+            name: "notifications",
+            checked: { $bindState: "/notifications" },
+          },
+        },
+        darkSwitch: {
+          type: "Switch",
+          props: {
+            label: "Dark mode",
+            name: "darkMode",
+            checked: { $bindState: "/darkMode" },
+          },
+        },
+        sep2: { type: "Separator", props: { orientation: null } },
+        actions: {
+          type: "Stack",
+          props: {
+            direction: "horizontal",
+            gap: "sm",
+            align: null,
+            justify: "end",
+          },
+          children: ["cancelBtn", "saveBtn"],
+        },
+        cancelBtn: {
+          type: "Button",
+          props: { label: "Cancel", variant: "secondary", disabled: null },
+        },
+        saveBtn: {
+          type: "Button",
+          props: { label: "Save Changes", variant: "primary", disabled: null },
+        },
+      },
+    },
+  },
+
+  {
+    name: "Pricing Table",
+    description: "A grid of pricing cards with feature lists",
+    spec: {
+      root: "outer",
+      elements: {
+        outer: {
+          type: "Stack",
+          props: {
+            direction: "vertical",
+            gap: "lg",
+            align: null,
+            justify: null,
+          },
+          children: ["header", "grid"],
+        },
+        header: {
+          type: "Stack",
+          props: {
+            direction: "vertical",
+            gap: "sm",
+            align: "center",
+            justify: null,
+          },
+          children: ["title", "subtitle"],
+        },
+        title: {
+          type: "Heading",
+          props: { text: "Simple, transparent pricing", level: "h1" },
+        },
+        subtitle: {
+          type: "Text",
+          props: {
+            text: "Choose the plan that fits your needs. Upgrade or downgrade at any time.",
+            variant: "muted",
+          },
+        },
+        grid: {
+          type: "Grid",
+          props: { columns: 3, gap: "md" },
+          children: ["free", "pro", "enterprise"],
+        },
+        free: {
+          type: "Card",
+          props: { title: "Free", description: "$0/month" },
+          children: ["freeContent"],
+        },
+        freeContent: {
+          type: "Stack",
+          props: { direction: "vertical", gap: "sm" },
+          children: ["f1", "f2", "f3", "freeBtn"],
+        },
+        f1: {
+          type: "Text",
+          props: { text: "Up to 3 projects", variant: "body" },
+        },
+        f2: { type: "Text", props: { text: "1 GB storage", variant: "body" } },
+        f3: {
+          type: "Text",
+          props: { text: "Community support", variant: "body" },
+        },
+        freeBtn: {
+          type: "Button",
+          props: { label: "Get Started", variant: "secondary" },
+        },
+        pro: {
+          type: "Card",
+          props: { title: "Pro", description: "$19/month" },
+          children: ["proContent"],
+        },
+        proContent: {
+          type: "Stack",
+          props: { direction: "vertical", gap: "sm" },
+          children: ["p1", "p2", "p3", "p4", "proBtn"],
+        },
+        p1: {
+          type: "Text",
+          props: { text: "Unlimited projects", variant: "body" },
+        },
+        p2: { type: "Text", props: { text: "50 GB storage", variant: "body" } },
+        p3: {
+          type: "Text",
+          props: { text: "Priority support", variant: "body" },
+        },
+        p4: {
+          type: "Text",
+          props: { text: "Custom domains", variant: "body" },
+        },
+        proBtn: {
+          type: "Button",
+          props: { label: "Upgrade to Pro", variant: "primary" },
+        },
+        enterprise: {
+          type: "Card",
+          props: { title: "Enterprise", description: "Custom pricing" },
+          children: ["entContent"],
+        },
+        entContent: {
+          type: "Stack",
+          props: { direction: "vertical", gap: "sm" },
+          children: ["e1", "e2", "e3", "e4", "entBtn"],
+        },
+        e1: {
+          type: "Text",
+          props: { text: "Everything in Pro", variant: "body" },
+        },
+        e2: {
+          type: "Text",
+          props: { text: "Unlimited storage", variant: "body" },
+        },
+        e3: {
+          type: "Text",
+          props: { text: "Dedicated support", variant: "body" },
+        },
+        e4: {
+          type: "Text",
+          props: { text: "SLA guarantees", variant: "body" },
+        },
+        entBtn: {
+          type: "Button",
+          props: { label: "Contact Sales", variant: "secondary" },
+        },
+      },
+    },
+  },
+
+  {
+    name: "Status Dashboard",
+    description: "System status with alerts, a table, and an accordion",
+    spec: {
+      root: "root",
+      elements: {
+        root: {
+          type: "Stack",
+          props: { direction: "vertical", gap: "lg" },
+          children: [
+            "heading",
+            "alertOk",
+            "alertWarn",
+            "sep",
+            "table",
+            "sep2",
+            "accordion",
+          ],
+        },
+        heading: {
+          type: "Heading",
+          props: { text: "System Status", level: "h1" },
+        },
+        alertOk: {
+          type: "Alert",
+          props: {
+            title: "API",
+            message: "All systems operational -- 99.98% uptime this month",
+            type: "success",
+          },
+        },
+        alertWarn: {
+          type: "Alert",
+          props: {
+            title: "Database",
+            message: "Elevated latency detected in us-east-1 region",
+            type: "warning",
+          },
+        },
+        sep: { type: "Separator", props: { orientation: null } },
+        table: {
+          type: "Table",
+          props: {
+            columns: ["Service", "Status", "Latency", "Uptime"],
+            rows: [
+              ["API Gateway", "Operational", "12ms", "99.99%"],
+              ["Auth Service", "Operational", "8ms", "99.98%"],
+              ["Database", "Degraded", "145ms", "99.85%"],
+              ["CDN", "Operational", "3ms", "100%"],
+              ["Workers", "Operational", "22ms", "99.97%"],
+            ],
+            caption: "Last updated 2 minutes ago",
+          },
+        },
+        sep2: { type: "Separator", props: { orientation: null } },
+        accordion: {
+          type: "Accordion",
+          props: {
+            items: [
+              {
+                title: "What does 'Degraded' mean?",
+                content:
+                  "The service is still operational but experiencing slower response times than normal. We are actively investigating.",
+              },
+              {
+                title: "How is uptime calculated?",
+                content:
+                  "Uptime is measured over the current calendar month based on successful health-check pings every 30 seconds.",
+              },
+              {
+                title: "How do I subscribe to updates?",
+                content:
+                  "You can subscribe to incident notifications via email or webhook on the Settings page.",
+              },
+            ],
+            type: "single",
+          },
+        },
+      },
+    },
+  },
+];
@@ -0,0 +1,173 @@
+import { defineCatalog } from "@json-render/core";
+import { schema } from "@json-render/vue/schema";
+import { z } from "zod";
+
+export const catalog = defineCatalog(schema, {
+  components: {
+    Card: {
+      props: z.object({
+        title: z.string().optional(),
+        description: z.string().nullable().optional(),
+        maxWidth: z.enum(["sm", "md", "lg", "xl"]).nullable().optional(),
+        centered: z.boolean().nullable().optional(),
+      }),
+      slots: ["default"],
+      description: "A card container with optional title and description",
+    },
+    Stack: {
+      props: z.object({
+        direction: z.enum(["horizontal", "vertical"]).optional(),
+        gap: z.enum(["sm", "md", "lg"]).optional(),
+        align: z
+          .enum(["start", "center", "end", "stretch"])
+          .nullable()
+          .optional(),
+        justify: z
+          .enum(["start", "center", "end", "between", "around"])
+          .nullable()
+          .optional(),
+      }),
+      slots: ["default"],
+      description:
+        "Flex container for laying out children horizontally or vertically",
+    },
+    Grid: {
+      props: z.object({
+        columns: z.number().optional(),
+        gap: z.enum(["sm", "md", "lg"]).optional(),
+      }),
+      slots: ["default"],
+      description: "Grid layout container",
+    },
+    Heading: {
+      props: z.object({
+        text: z.string(),
+        level: z.enum(["h1", "h2", "h3", "h4"]).optional(),
+      }),
+      slots: [],
+      description: "Heading text element",
+    },
+    Text: {
+      props: z.object({
+        text: z.string(),
+        variant: z.enum(["body", "muted", "bold"]).optional(),
+      }),
+      slots: [],
+      description: "Text paragraph element",
+    },
+    Button: {
+      props: z.object({
+        label: z.string(),
+        variant: z
+          .enum(["primary", "secondary", "outline", "danger"])
+          .optional(),
+        disabled: z.boolean().nullable().optional(),
+      }),
+      slots: [],
+      description: "Clickable button. Emits 'press' event.",
+    },
+    Input: {
+      props: z.object({
+        label: z.string().optional(),
+        name: z.string(),
+        type: z.enum(["text", "email", "password", "number"]).optional(),
+        placeholder: z.string().optional(),
+        value: z.string().optional(),
+        checks: z.any().nullable().optional(),
+        validateOn: z.string().nullable().optional(),
+      }),
+      slots: [],
+      description:
+        "Text input field with optional label. Emits 'change' event.",
+    },
+    Select: {
+      props: z.object({
+        label: z.string().optional(),
+        name: z.string(),
+        options: z.array(z.string()),
+        placeholder: z.string().optional(),
+        value: z.string().optional(),
+        checks: z.any().nullable().optional(),
+        validateOn: z.string().nullable().optional(),
+      }),
+      slots: [],
+      description: "Dropdown select field. Emits 'change' event.",
+    },
+    Switch: {
+      props: z.object({
+        label: z.string(),
+        name: z.string(),
+        checked: z.boolean().optional(),
+      }),
+      slots: [],
+      description: "Toggle switch. Emits 'change' event.",
+    },
+    Badge: {
+      props: z.object({
+        text: z.string(),
+        variant: z
+          .enum(["default", "secondary", "outline", "destructive"])
+          .optional(),
+      }),
+      slots: [],
+      description: "Small status badge label",
+    },
+    Separator: {
+      props: z.object({
+        orientation: z.enum(["horizontal", "vertical"]).nullable().optional(),
+      }),
+      slots: [],
+      description: "Visual separator line",
+    },
+    Progress: {
+      props: z.object({
+        value: z.number(),
+        max: z.number().optional(),
+        label: z.string().optional(),
+      }),
+      slots: [],
+      description: "Progress bar",
+    },
+    Alert: {
+      props: z.object({
+        title: z.string(),
+        message: z.string(),
+        type: z.enum(["info", "success", "warning", "error"]).optional(),
+      }),
+      slots: [],
+      description: "Alert / notification banner",
+    },
+    Table: {
+      props: z.object({
+        columns: z.array(z.string()),
+        rows: z.array(z.array(z.string())),
+        caption: z.string().optional(),
+      }),
+      slots: [],
+      description: "Data table with columns and rows",
+    },
+    Accordion: {
+      props: z.object({
+        items: z.array(z.object({ title: z.string(), content: z.string() })),
+        type: z.enum(["single", "multiple"]).optional(),
+      }),
+      slots: [],
+      description: "Collapsible accordion sections",
+    },
+    Radio: {
+      props: z.object({
+        label: z.string().optional(),
+        name: z.string(),
+        options: z.array(z.string()),
+        value: z.string().optional(),
+        checks: z.any().nullable().optional(),
+        validateOn: z.string().nullable().optional(),
+      }),
+      slots: [],
+      description: "Radio button group. Emits 'change' event.",
+    },
+  },
+  actions: {},
+  // Cast needed: zod schema types don't align with the inferred catalog input
+  // type from defineCatalog's generics when no actions are defined.
+} as any);
@@ -0,0 +1,593 @@
+import { h, ref, defineComponent, type VNode, type PropType } from "vue";
+import {
+  defineRegistry,
+  useBoundProp,
+  useFieldValidation,
+  type BaseComponentProps,
+} from "@json-render/vue";
+import { catalog } from "./catalog";
+
+type Ctx<P = Record<string, unknown>> = BaseComponentProps<P>;
+
+export const { registry } = defineRegistry(catalog, {
+  components: {
+    Card: ({
+      props,
+      children,
+    }: Ctx<{
+      title?: string;
+      description?: string | null;
+      maxWidth?: "sm" | "md" | "lg" | "xl" | null;
+      centered?: boolean | null;
+    }>) => {
+      const maxWidthClass =
+        props.maxWidth === "sm"
+          ? "max-w-sm"
+          : props.maxWidth === "md"
+            ? "max-w-md"
+            : props.maxWidth === "lg"
+              ? "max-w-lg"
+              : props.maxWidth === "xl"
+                ? "max-w-xl"
+                : "";
+      return h(
+        "div",
+        {
+          class: [
+            "rounded-lg border bg-white shadow-sm p-6",
+            maxWidthClass,
+            props.centered ? "mx-auto" : "",
+          ]
+            .filter(Boolean)
+            .join(" "),
+        },
+        [
+          props.title &&
+            h("h3", { class: "text-lg font-semibold" }, props.title),
+          props.description &&
+            h("p", { class: "text-sm text-gray-500 mt-1" }, props.description),
+          (props.title || props.description) &&
+            h("div", { class: "mt-4" }, children),
+          !(props.title || props.description) && children,
+        ].filter(Boolean) as VNode[],
+      );
+    },
+
+    Stack: ({
+      props,
+      children,
+    }: Ctx<{
+      direction?: "horizontal" | "vertical";
+      gap?: "sm" | "md" | "lg";
+      align?: "start" | "center" | "end" | "stretch" | null;
+      justify?: "start" | "center" | "end" | "between" | "around" | null;
+    }>) => {
+      const gapClass =
+        props.gap === "sm" ? "gap-2" : props.gap === "lg" ? "gap-6" : "gap-4";
+      const dirClass =
+        props.direction === "horizontal" ? "flex-row" : "flex-col";
+      const alignMap: Record<string, string> = {
+        start: "items-start",
+        center: "items-center",
+        end: "items-end",
+        stretch: "items-stretch",
+      };
+      const justifyMap: Record<string, string> = {
+        start: "justify-start",
+        center: "justify-center",
+        end: "justify-end",
+        between: "justify-between",
+        around: "justify-around",
+      };
+      const alignClass = props.align ? (alignMap[props.align] ?? "") : "";
+      const justifyClass = props.justify
+        ? (justifyMap[props.justify] ?? "")
+        : "";
+      return h(
+        "div",
+        {
+          class: ["flex", dirClass, gapClass, alignClass, justifyClass]
+            .filter(Boolean)
+            .join(" "),
+        },
+        children,
+      );
+    },
+
+    Grid: ({
+      props,
+      children,
+    }: Ctx<{ columns?: number; gap?: "sm" | "md" | "lg" }>) => {
+      const cols = props.columns ?? 3;
+      const gapClass =
+        props.gap === "sm" ? "gap-2" : props.gap === "lg" ? "gap-6" : "gap-4";
+      const colClass =
+        cols === 1
+          ? "grid-cols-1"
+          : cols === 2
+            ? "grid-cols-2"
+            : cols === 3
+              ? "grid-cols-3"
+              : cols === 4
+                ? "grid-cols-4"
+                : `grid-cols-${cols}`;
+      return h("div", { class: `grid ${colClass} ${gapClass}` }, children);
+    },
+
+    Heading: ({
+      props,
+    }: Ctx<{ text: string; level?: "h1" | "h2" | "h3" | "h4" }>) => {
+      const tag = props.level ?? "h2";
+      const sizeClass =
+        tag === "h1"
+          ? "text-3xl font-bold"
+          : tag === "h2"
+            ? "text-2xl font-semibold"
+            : tag === "h3"
+              ? "text-xl font-semibold"
+              : "text-lg font-medium";
+      return h(tag, { class: sizeClass }, props.text);
+    },
+
+    Text: ({
+      props,
+    }: Ctx<{ text: string; variant?: "body" | "muted" | "bold" }>) => {
+      const variantClass =
+        props.variant === "muted"
+          ? "text-gray-500"
+          : props.variant === "bold"
+            ? "font-semibold"
+            : "";
+      return h("p", { class: variantClass }, props.text);
+    },
+
+    Button: ({
+      props,
+      emit,
+    }: Ctx<{
+      label: string;
+      variant?: "primary" | "secondary" | "outline" | "danger";
+      disabled?: boolean | null;
+    }>) => {
+      const baseClass =
+        "inline-flex items-center justify-center rounded-md px-4 py-2 text-sm font-medium transition-colors focus:outline-none focus:ring-2 focus:ring-offset-2 disabled:opacity-50 disabled:pointer-events-none";
+      const variantClass =
+        props.variant === "primary"
+          ? "bg-blue-600 text-white hover:bg-blue-700 focus:ring-blue-500"
+          : props.variant === "danger"
+            ? "bg-red-600 text-white hover:bg-red-700 focus:ring-red-500"
+            : props.variant === "outline"
+              ? "border border-gray-300 bg-white text-gray-700 hover:bg-gray-50"
+              : "bg-gray-100 text-gray-900 hover:bg-gray-200 focus:ring-gray-500";
+      return h(
+        "button",
+        {
+          class: `${baseClass} ${variantClass}`,
+          disabled: props.disabled ?? false,
+          onClick: () => emit("press"),
+        },
+        props.label,
+      );
+    },
+
+    Input: ({
+      props,
+      bindings,
+      emit,
+    }: Ctx<{
+      label?: string;
+      name: string;
+      type?: string;
+      placeholder?: string;
+      value?: string;
+      checks?: unknown;
+      validateOn?: string | null;
+    }>) => {
+      const [value, setValue] = useBoundProp<string>(
+        props.value,
+        bindings?.value,
+      );
+      const validation = props.checks
+        ? useFieldValidation(`/${props.name}`, {
+            checks: props.checks as any[],
+            validateOn: (props.validateOn as "blur" | "change") ?? undefined,
+          })
+        : null;
+
+      return h(
+        "div",
+        { class: "flex flex-col gap-1.5" },
+        [
+          props.label &&
+            h(
+              "label",
+              { class: "text-sm font-medium text-gray-700" },
+              props.label,
+            ),
+          h("input", {
+            type: props.type ?? "text",
+            placeholder: props.placeholder,
+            value: value ?? "",
+            class:
+              "rounded-md border border-gray-300 px-3 py-2 text-sm shadow-sm focus:border-blue-500 focus:outline-none focus:ring-1 focus:ring-blue-500",
+            onInput: (e: Event) => {
+              const val = (e.target as HTMLInputElement).value;
+              setValue(val);
+              emit("change");
+              if (validation && props.validateOn === "change") {
+                validation.validate();
+              }
+            },
+            onBlur: () => {
+              if (validation && props.validateOn === "blur") {
+                validation.touch();
+                validation.validate();
+              }
+            },
+          }),
+          validation &&
+            validation.errors.value.length > 0 &&
+            h(
+              "p",
+              { class: "text-xs text-red-500" },
+              validation.errors.value[0],
+            ),
+        ].filter(Boolean) as VNode[],
+      );
+    },
+
+    Select: ({
+      props,
+      bindings,
+      emit,
+    }: Ctx<{
+      label?: string;
+      name: string;
+      options: string[];
+      placeholder?: string;
+      value?: string;
+      checks?: unknown;
+      validateOn?: string | null;
+    }>) => {
+      const [value, setValue] = useBoundProp<string>(
+        props.value,
+        bindings?.value,
+      );
+      const options = props.options ?? [];
+      const validation = props.checks
+        ? useFieldValidation(`/${props.name}`, {
+            checks: props.checks as any[],
+            validateOn: (props.validateOn as "blur" | "change") ?? undefined,
+          })
+        : null;
+
+      return h(
+        "div",
+        { class: "flex flex-col gap-1.5" },
+        [
+          props.label &&
+            h(
+              "label",
+              { class: "text-sm font-medium text-gray-700" },
+              props.label,
+            ),
+          h(
+            "select",
+            {
+              value: value ?? "",
+              class:
+                "rounded-md border border-gray-300 px-3 py-2 text-sm shadow-sm focus:border-blue-500 focus:outline-none focus:ring-1 focus:ring-blue-500",
+              onChange: (e: Event) => {
+                const val = (e.target as HTMLSelectElement).value;
+                setValue(val);
+                emit("change");
+                if (validation && props.validateOn === "change") {
+                  validation.validate();
+                }
+              },
+            },
+            [
+              props.placeholder &&
+                h("option", { value: "", disabled: true }, props.placeholder),
+              ...options.map((opt: string) =>
+                h("option", { value: opt, key: opt }, opt),
+              ),
+            ].filter(Boolean) as VNode[],
+          ),
+          validation &&
+            validation.errors.value.length > 0 &&
+            h(
+              "p",
+              { class: "text-xs text-red-500" },
+              validation.errors.value[0],
+            ),
+        ].filter(Boolean) as VNode[],
+      );
+    },
+
+    Switch: ({
+      props,
+      bindings,
+      emit,
+    }: Ctx<{ label: string; name: string; checked?: boolean }>) => {
+      const [checked, setChecked] = useBoundProp<boolean>(
+        props.checked,
+        bindings?.checked,
+      );
+      const isOn = checked ?? false;
+      return h("label", { class: "flex items-center gap-3 cursor-pointer" }, [
+        h(
+          "button",
+          {
+            role: "switch",
+            "aria-checked": isOn,
+            class: [
+              "relative inline-flex h-6 w-11 items-center rounded-full transition-colors",
+              isOn ? "bg-blue-600" : "bg-gray-200",
+            ].join(" "),
+            onClick: () => {
+              setChecked(!isOn);
+              emit("change");
+            },
+          },
+          h("span", {
+            class: [
+              "inline-block h-4 w-4 transform rounded-full bg-white transition-transform",
+              isOn ? "translate-x-6" : "translate-x-1",
+            ].join(" "),
+          }),
+        ),
+        h("span", { class: "text-sm" }, props.label),
+      ]);
+    },
+
+    Badge: ({
+      props,
+    }: Ctx<{
+      text: string;
+      variant?: "default" | "secondary" | "outline" | "destructive";
+    }>) => {
+      const variantClass =
+        props.variant === "secondary"
+          ? "bg-gray-100 text-gray-800"
+          : props.variant === "outline"
+            ? "border border-gray-300 text-gray-700"
+            : props.variant === "destructive"
+              ? "bg-red-100 text-red-800"
+              : "bg-blue-100 text-blue-800";
+      return h(
+        "span",
+        {
+          class: `inline-flex items-center rounded-full px-2.5 py-0.5 text-xs font-medium ${variantClass}`,
+        },
+        props.text,
+      );
+    },
+
+    Separator: () => {
+      return h("hr", { class: "border-gray-200" });
+    },
+
+    Progress: ({
+      props,
+    }: Ctx<{ value: number; max?: number; label?: string }>) => {
+      const pct = Math.min(
+        100,
+        Math.round((props.value / (props.max ?? 100)) * 100),
+      );
+      return h(
+        "div",
+        { class: "flex flex-col gap-1.5" },
+        [
+          props.label &&
+            h("div", { class: "flex justify-between text-sm" }, [
+              h("span", { class: "text-gray-600" }, props.label),
+              h("span", { class: "font-medium" }, `${pct}%`),
+            ]),
+          h(
+            "div",
+            {
+              class: "h-2 w-full rounded-full bg-gray-200 overflow-hidden",
+            },
+            h("div", {
+              class: "h-full rounded-full bg-blue-600 transition-all",
+              style: { width: `${pct}%` },
+            }),
+          ),
+        ].filter(Boolean) as VNode[],
+      );
+    },
+
+    Alert: ({
+      props,
+    }: Ctx<{
+      title: string;
+      message: string;
+      type?: "info" | "success" | "warning" | "error";
+    }>) => {
+      const typeClasses: Record<string, string> = {
+        success: "bg-green-50 border-green-200 text-green-800",
+        warning: "bg-yellow-50 border-yellow-200 text-yellow-800",
+        error: "bg-red-50 border-red-200 text-red-800",
+        info: "bg-blue-50 border-blue-200 text-blue-800",
+      };
+      const cls = typeClasses[props.type ?? "info"] ?? typeClasses.info;
+      return h("div", { class: `rounded-md border p-4 ${cls}` }, [
+        h("p", { class: "text-sm font-medium" }, props.title),
+        h("p", { class: "text-sm mt-1 opacity-80" }, props.message),
+      ]);
+    },
+
+    Table: ({
+      props,
+    }: Ctx<{
+      columns: string[];
+      rows: string[][];
+      caption?: string;
+    }>) => {
+      return h(
+        "div",
+        { class: "overflow-x-auto" },
+        [
+          h("table", { class: "min-w-full text-sm" }, [
+            h(
+              "thead",
+              null,
+              h(
+                "tr",
+                { class: "border-b" },
+                props.columns.map((col: string) =>
+                  h(
+                    "th",
+                    {
+                      key: col,
+                      class: "px-4 py-2 text-left font-medium text-gray-500",
+                    },
+                    col,
+                  ),
+                ),
+              ),
+            ),
+            h(
+              "tbody",
+              null,
+              props.rows.map((row: string[], i: number) =>
+                h(
+                  "tr",
+                  { key: i, class: "border-b last:border-0" },
+                  row.map((cell: string, j: number) =>
+                    h("td", { key: j, class: "px-4 py-2 text-gray-700" }, cell),
+                  ),
+                ),
+              ),
+            ),
+          ]),
+          props.caption &&
+            h("p", { class: "text-xs text-gray-400 mt-2 px-4" }, props.caption),
+        ].filter(Boolean) as VNode[],
+      );
+    },
+
+    // Uses defineComponent instead of a plain render function because it
+    // needs local reactive state (openItems ref) to track expanded items.
+    Accordion: defineComponent({
+      props: {
+        props: {
+          type: Object as PropType<{
+            items: Array<{ title: string; content: string }>;
+            type?: "single" | "multiple";
+          }>,
+          required: true,
+        },
+      },
+      setup(compProps) {
+        const openItems = ref<Set<number>>(new Set());
+
+        const toggle = (idx: number) => {
+          const next = new Set(openItems.value);
+          if (next.has(idx)) {
+            next.delete(idx);
+          } else {
+            if (compProps.props.type === "single") next.clear();
+            next.add(idx);
+          }
+          openItems.value = next;
+        };
+
+        return () =>
+          h(
+            "div",
+            { class: "divide-y border rounded-md" },
+            compProps.props.items.map(
+              (item: { title: string; content: string }, i: number) =>
+                h("div", { key: i }, [
+                  h(
+                    "button",
+                    {
+                      class:
+                        "flex w-full items-center justify-between px-4 py-3 text-sm font-medium text-left hover:bg-gray-50 transition-colors",
+                      onClick: () => toggle(i),
+                    },
+                    [
+                      h("span", null, item.title),
+                      h(
+                        "span",
+                        {
+                          class: [
+                            "transform transition-transform text-gray-400",
+                            openItems.value.has(i) ? "rotate-180" : "",
+                          ].join(" "),
+                        },
+                        "\u25BE",
+                      ),
+                    ],
+                  ),
+                  openItems.value.has(i) &&
+                    h(
+                      "div",
+                      { class: "px-4 pb-3 text-sm text-gray-600" },
+                      item.content,
+                    ),
+                ]),
+            ),
+          );
+      },
+    }) as any,
+
+    Radio: ({
+      props,
+      bindings,
+      emit,
+    }: Ctx<{
+      label?: string;
+      name: string;
+      options: string[];
+      value?: string;
+    }>) => {
+      const [value, setValue] = useBoundProp<string>(
+        props.value,
+        bindings?.value,
+      );
+
+      return h(
+        "div",
+        { class: "flex flex-col gap-1.5" },
+        [
+          props.label &&
+            h(
+              "label",
+              { class: "text-sm font-medium text-gray-700" },
+              props.label,
+            ),
+          h(
+            "div",
+            { class: "flex gap-4" },
+            (props.options ?? []).map((opt: string) =>
+              h(
+                "label",
+                {
+                  key: opt,
+                  class: "flex items-center gap-2 cursor-pointer",
+                },
+                [
+                  h("input", {
+                    type: "radio",
+                    name: props.name,
+                    value: opt,
+                    checked: value === opt,
+                    class: "accent-blue-600",
+                    onChange: () => {
+                      setValue(opt);
+                      emit("change");
+                    },
+                  }),
+                  h("span", { class: "text-sm" }, opt),
+                ],
+              ),
+            ),
+          ),
+        ].filter(Boolean) as VNode[],
+      );
+    },
+  },
+});
@@ -0,0 +1,10 @@
+import tailwindcss from "@tailwindcss/vite";
+
+export default defineNuxtConfig({
+  compatibilityDate: "2025-11-01",
+  css: ["~/assets/css/main.css"],
+  vite: {
+    // Tailwind's Vite plugin types don't align with Nuxt's plugin types
+    plugins: [tailwindcss() as any],
+  },
+});
@@ -0,0 +1,25 @@
+{
+  "name": "example-nuxt",
+  "version": "0.1.0",
+  "type": "module",
+  "private": true,
+  "scripts": {
+    "dev": "portless nuxt-demo.json-render nuxt dev",
+    "build": "nuxt build",
+    "generate": "nuxt generate",
+    "preview": "nuxt preview",
+    "check-types": "nuxt typecheck"
+  },
+  "dependencies": {
+    "@json-render/core": "workspace:*",
+    "@json-render/vue": "workspace:*",
+    "nuxt": "^4.3.1",
+    "vue": "^3.5.29",
+    "zod": "^4.3.6"
+  },
+  "devDependencies": {
+    "@tailwindcss/vite": "^4.2.1",
+    "tailwindcss": "^4.2.1",
+    "typescript": "^5.7.2"
+  }
+}
@@ -0,0 +1,47 @@
+<script setup lang="ts">
+import { JSONUIProvider, Renderer } from "@json-render/vue";
+import { registry } from "~/lib/render/registry";
+import { examples } from "~/lib/examples";
+
+const selectedIndex = ref(0);
+const selected = computed(() => examples[selectedIndex.value]!);
+</script>
+
+<template>
+  <div class="min-h-screen flex flex-col bg-gray-50">
+    <!-- Example selector -->
+    <nav class="flex gap-1 p-3 overflow-x-auto border-b bg-white shrink-0">
+      <button
+        v-for="(ex, i) in examples"
+        :key="ex.name"
+        class="px-3 py-1.5 text-sm rounded-md whitespace-nowrap transition-colors"
+        :class="
+          i === selectedIndex
+            ? 'bg-blue-600 text-white'
+            : 'hover:bg-gray-100 text-gray-700'
+        "
+        @click="selectedIndex = i"
+      >
+        {{ ex.name }}
+      </button>
+    </nav>
+
+    <!-- Render area -->
+    <div class="flex-1 flex items-start justify-center overflow-auto p-6">
+      <div
+        class="bg-white border rounded-lg shadow-sm w-full max-w-[960px] p-6"
+      >
+        <p class="text-xs text-gray-400 mb-4">
+          {{ selected.description }}
+        </p>
+        <JSONUIProvider
+          :key="selectedIndex"
+          :registry="registry"
+          :initial-state="selected.spec.state ?? {}"
+        >
+          <Renderer :spec="selected.spec" :registry="registry" />
+        </JSONUIProvider>
+      </div>
+    </div>
+  </div>
+</template>
@@ -0,0 +1,3 @@
+{
+  "extends": "./.nuxt/tsconfig.json"
+}
@@ -0,0 +1,17 @@
+# example-react-native
+
+## 0.1.2
+
+### Patch Changes
+
+- Updated dependencies [b103676]
+  - @json-render/react-native@0.9.1
+  - @json-render/core@0.9.1
+
+## 0.1.1
+
+### Patch Changes
+
+- Updated dependencies [1d755c1]
+  - @json-render/core@0.9.0
+  - @json-render/react-native@0.9.0
@@ -1,6 +1,6 @@
 {
  "name": "example-react-native",
-  "version": "0.1.0",
+  "version": "0.1.2",
  "private": true,
  "main": "expo-router/entry",
  "scripts": {
@@ -0,0 +1,17 @@
+# example-react-pdf
+
+## 0.1.2
+
+### Patch Changes
+
+- Updated dependencies [b103676]
+  - @json-render/react-pdf@0.9.1
+  - @json-render/core@0.9.1
+
+## 0.1.1
+
+### Patch Changes
+
+- Updated dependencies [1d755c1]
+  - @json-render/core@0.9.0
+  - @json-render/react-pdf@0.9.0
@@ -1,6 +1,6 @@
 /// <reference types="next" />
 /// <reference types="next/image-types/global" />
-import "./.next/types/routes.d.ts";
+import "./.next/dev/types/routes.d.ts";

 // NOTE: This file should not be edited
 // see https://nextjs.org/docs/app/api-reference/config/typescript for more information.
@@ -1,10 +1,10 @@
 {
  "name": "example-react-pdf",
-  "version": "0.1.0",
+  "version": "0.1.2",
  "type": "module",
  "private": true,
  "scripts": {
-    "dev": "next dev --turbopack --port 3005",
+    "dev": "portless react-pdf-demo.json-render next dev --turbopack",
    "build": "next build",
    "start": "next start",
    "check-types": "tsc --noEmit"
@@ -28,7 +28,7 @@
    "zod": "4.3.5"
  },
  "devDependencies": {
-    "@repo/typescript-config": "workspace:*",
+    "@internal/typescript-config": "workspace:*",
    "@types/node": "^22.10.0",
    "@types/react": "19.2.3",
    "@types/react-dom": "19.2.3",
@@ -0,0 +1,16 @@
+# example-remotion
+
+## 0.1.2
+
+### Patch Changes
+
+- @json-render/core@0.9.1
+- @json-render/remotion@0.9.1
+
+## 0.1.1
+
+### Patch Changes
+
+- Updated dependencies [1d755c1]
+  - @json-render/core@0.9.0
+  - @json-render/remotion@0.9.0
@@ -1,6 +1,6 @@
 /// <reference types="next" />
 /// <reference types="next/image-types/global" />
-import "./.next/types/routes.d.ts";
+import "./.next/dev/types/routes.d.ts";

 // NOTE: This file should not be edited
 // see https://nextjs.org/docs/app/api-reference/config/typescript for more information.
@@ -1,10 +1,10 @@
 {
  "name": "example-remotion",
-  "version": "0.1.0",
+  "version": "0.1.2",
  "type": "module",
  "private": true,
  "scripts": {
-    "dev": "next dev --turbopack --port 3002",
+    "dev": "portless remotion-demo.json-render next dev --turbopack",
    "build": "next build",
    "start": "next start",
    "check-types": "tsc --noEmit"
@@ -29,7 +29,7 @@
    "zod": "^4.0.0"
  },
  "devDependencies": {
-    "@repo/eslint-config": "workspace:*",
+    "@internal/eslint-config": "workspace:*",
    "@tailwindcss/postcss": "^4.1.18",
    "@types/node": "^22.10.0",
    "@types/react": "19.2.3",
@@ -1,6 +1,6 @@
 /// <reference types="next" />
 /// <reference types="next/image-types/global" />
-import "./.next/types/routes.d.ts";
+import "./.next/dev/types/routes.d.ts";

 // NOTE: This file should not be edited
 // see https://nextjs.org/docs/app/api-reference/config/typescript for more information.
@@ -4,7 +4,7 @@
  "private": true,
  "type": "module",
  "scripts": {
-    "dev": "next dev --port 3001",
+    "dev": "portless stripe-api-demo.json-render next dev",
    "build": "next build",
    "start": "next start --port 3001"
  },
@@ -0,0 +1,17 @@
+# com.example.json-render-demo
+
+## 0.0.3
+
+### Patch Changes
+
+- Updated dependencies [b103676]
+  - @json-render/react@0.9.1
+  - @json-render/core@0.9.1
+
+## 0.0.2
+
+### Patch Changes
+
+- Updated dependencies [1d755c1]
+  - @json-render/core@0.9.0
+  - @json-render/react@0.9.0
@@ -1,4 +1,4 @@
-import { config as reactConfig } from "@repo/eslint-config/react-internal";
+import { config as reactConfig } from "@internal/eslint-config/react-internal";

 /** @type {import("eslint").Linter.Config[]} */
 export default [
@@ -1,6 +1,6 @@
 {
  "name": "com.example.json-render-demo",
-  "version": "0.0.1",
+  "version": "0.0.3",
  "description": "Test",
  "private": true,
  "license": "~~proprietary~~",
@@ -21,7 +21,7 @@
    "test": "jest"
  },
  "devDependencies": {
-    "@repo/eslint-config": "workspace:*",
+    "@internal/eslint-config": "workspace:*",
    "@stripe/ui-extension-tools": "^0.0.1",
    "eslint": "^9.39.0"
  }
@@ -1 +1,2 @@
-export const API_GENERATE_URL = "http://localhost:3001/api/generate";
+export const API_GENERATE_URL =
+  "http://stripe-api-demo.json-render.localhost:1355/api/generate";
@@ -1,5 +1,5 @@
 import { defineCatalog } from "@json-render/core";
-import { schema } from "@json-render/react";
+import { schema } from "@json-render/react/schema";
 import { z } from "zod";

 /**
@@ -27,7 +27,7 @@ export interface StripeRendererProps {
  /** Function to update data */
  setData?: SetState;
  /** Callback when data changes */
-  onStateChange?: (path: string, value: unknown) => void;
+  onStateChange?: (changes: Array<{ path: string; value: unknown }>) => void;
  /** Whether the spec is currently loading/streaming */
  loading?: boolean;
 }
@@ -0,0 +1,17 @@
+# com.example.json-render-fullpage-demo
+
+## 0.0.3
+
+### Patch Changes
+
+- Updated dependencies [b103676]
+  - @json-render/react@0.9.1
+  - @json-render/core@0.9.1
+
+## 0.0.2
+
+### Patch Changes
+
+- Updated dependencies [1d755c1]
+  - @json-render/core@0.9.0
+  - @json-render/react@0.9.0
@@ -1,4 +1,4 @@
-import { config as reactConfig } from "@repo/eslint-config/react-internal";
+import { config as reactConfig } from "@internal/eslint-config/react-internal";

 /** @type {import("eslint").Linter.Config[]} */
 export default [
@@ -1,6 +1,6 @@
 {
  "name": "com.example.json-render-fullpage-demo",
-  "version": "0.0.1",
+  "version": "0.0.3",
  "description": "Full-page Stripe App example (alpha)",
  "private": true,
  "license": "~~proprietary~~",
@@ -21,7 +21,7 @@
    "test": "jest"
  },
  "devDependencies": {
-    "@repo/eslint-config": "workspace:*",
+    "@internal/eslint-config": "workspace:*",
    "@stripe/ui-extension-tools": "^0.0.1",
    "eslint": "^9.39.0"
  }
@@ -1 +1,2 @@
-export const API_GENERATE_URL = "http://localhost:3001/api/generate";
+export const API_GENERATE_URL =
+  "http://stripe-api-demo.json-render.localhost:1355/api/generate";
@@ -1,5 +1,5 @@
 import { defineCatalog } from "@json-render/core";
-import { schema } from "@json-render/react";
+import { schema } from "@json-render/react/schema";
 import { z } from "zod";

 /**
@@ -27,7 +27,7 @@ export interface StripeRendererProps {
  /** Function to update data */
  setData?: SetState;
  /** Callback when data changes */
-  onStateChange?: (path: string, value: unknown) => void;
+  onStateChange?: (changes: Array<{ path: string; value: unknown }>) => void;
  /** Whether the spec is currently loading/streaming */
  loading?: boolean;
 }
@@ -12,7 +12,7 @@
  },
  "scripts": {
    "build": "turbo run build",
-    "dev": "turbo run dev --concurrency 15",
+    "dev": "turbo run dev --concurrency 20",
    "lint": "turbo run lint",
    "format": "prettier --write \"**/*.{ts,tsx}\"",
    "type-check": "turbo run check-types",
@@ -20,6 +20,7 @@
    "test": "vitest run",
    "test:watch": "vitest",
    "test:coverage": "vitest run --coverage",
+    "test:e2e": "pnpm --filter e2e-tests test",
    "prepare": "husky",
    "changeset": "changeset",
    "ci:version": "changeset version && pnpm install --no-frozen-lockfile",
@@ -29,6 +30,7 @@
    "@changesets/cli": "2.29.8",
    "@testing-library/dom": "^10.4.1",
    "@testing-library/react": "^16.3.1",
+    "@testing-library/vue": "^8.1.0",
    "@types/react": "^19.2.3",
    "husky": "^9.1.7",
    "jsdom": "^27.4.0",
@@ -38,6 +40,7 @@
    "react-dom": "^19.2.4",
    "turbo": "^2.7.4",
    "typescript": "5.9.2",
+    "vue": "^3.5.29",
    "vitest": "^4.0.17"
  },
  "packageManager": "pnpm@10.29.3",
@@ -1,5 +1,54 @@
 # @json-render/codegen

+## 0.9.1
+
+### Patch Changes
+
+- @json-render/core@0.9.1
+
+## 0.9.0
+
+### Minor Changes
+
+- 1d755c1: External state store, store adapters, and bug fixes.
+
+  ### New: External State Store
+
+  The `StateStore` interface lets you plug in your own state management (Redux, Zustand, Jotai, XState, etc.) instead of the built-in internal store. Pass a `store` prop to `StateProvider`, `JSONUIProvider`, or `createRenderer` for controlled mode.
+  - Added `StateStore` interface and `createStateStore()` factory to `@json-render/core`
+  - `StateProvider`, `JSONUIProvider`, and `createRenderer` now accept an optional `store` prop for controlled mode
+  - When `store` is provided, it becomes the single source of truth (`initialState`/`onStateChange` are ignored)
+  - When `store` is omitted, everything works exactly as before (fully backward compatible)
+  - Applied across all platform packages: react, react-native, react-pdf
+  - Store utilities (`createStoreAdapter`, `immutableSetByPath`, `flattenToPointers`) available via `@json-render/core/store-utils` for building custom adapters
+
+  ### New: Store Adapter Packages
+  - `@json-render/zustand` — Zustand adapter for `StateStore`
+  - `@json-render/redux` — Redux / Redux Toolkit adapter for `StateStore`
+  - `@json-render/jotai` — Jotai adapter for `StateStore`
+
+  ### Changed: `onStateChange` signature updated (breaking)
+
+  The `onStateChange` callback now receives a single array of changed entries instead of being called once per path:
+
+  ```ts
+  // Before
+  onStateChange?: (path: string, value: unknown) => void
+
+  // After
+  onStateChange?: (changes: Array<{ path: string; value: unknown }>) => void
+  ```
+
+  ### Fixed
+  - Fix schema import to use server-safe `@json-render/react/schema` subpath, avoiding `createContext` crashes in Next.js App Router API routes
+  - Fix chaining actions in `@json-render/react`, `@json-render/react-native`, and `@json-render/react-pdf`
+  - Fix safely resolving inner type for Zod arrays in core schema
+
+### Patch Changes
+
+- Updated dependencies [1d755c1]
+  - @json-render/core@0.9.0
+
 ## 0.8.0

 ### Patch Changes
--- a/Show More
+++ b/Show More
Author	SHA1	Message	Date
Chris Tate	dc38be8efe	fixes	2026-02-25 00:59:21 -06:00
Chris Tate	aa7eef1aea	vue	2026-02-25 00:04:12 -06:00
Chris Tate	ea47b66dfc	add dynamic forms support: computed values, watchers, cross-field validation (#156 ) * add dynamic forms support: computed values, watchers, cross-field validation - `$computed` and `$template` prop expressions for derived values and string interpolation - Element-level `watch` field for cascading state dependencies - Cross-field validators (`lessThan`, `greaterThan`, `equalTo`, `requiredIf`) with deep arg resolution - `validateForm` built-in action for form-level validation * fixes * fixes * fixes * fixes * fixes * fixes * fixes * tests * fixes * update turbo * tests * fixes * fixes * fixes	2026-02-24 23:04:48 -06:00
Chris Tate	cd82f969c8	xstate doc/test updates (#160 )	2026-02-24 22:09:42 -06:00
David KhourshidandClaude Opus 4.6	6bcaaad57d	feat: Add `@xstate/store` (atom) support (#157 ) * feat: add @xstate/store integration using atoms Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com> * docs: add README for @json-render/xstate-store Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com> * refactor: rename xstateStoreStateStore to xstateStore Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com> * README updates * Keep naming convention --------- Co-authored-by: Claude Opus 4.6 <noreply@anthropic.com>	2026-02-24 22:01:33 -06:00
github-actions[bot]	0b7d767cdd	chore: version packages (#154 ) Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com>	2026-02-24 06:29:45 -06:00
Chris Tate	b1036763d2	fixed: Install failure due to private dependency (#153 ) * fix @internal/react-state import * add changeset for @internal/react-state install fix * docs: add v0.9.1 changelog entry	2026-02-24 06:25:34 -06:00
github-actions[bot]	c502d5517e	chore: version packages (#149 ) Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com>	2026-02-24 01:36:59 -06:00
Chris Tate	8740deb018	Update config.json (#148 )	2026-02-24 01:34:16 -06:00
Chris Tate	1d755c104a	prepare v0.9.0 (#147 )	2026-02-24 01:21:02 -06:00
Chris Tate	d904d45150	fix schema import to use server-safe subpath (#146 ) - `@json-render/react` barrel-imports React contexts that call `createContext`, which crashes in Next.js App Router API routes (RSC runtime strips `createContext`) - Updated all docs, READMEs, examples, and skills to import `schema` from `@json-render/react/schema` instead of `@json-render/react` - For combined imports, split into separate `schema` (subpath) and client API (main entry) lines Fixes #123	2026-02-24 00:55:33 -06:00
Chris Tate	a110c6e0ea	fix chaining actions (#144 ) * fix chaining actions * improvements	2026-02-24 00:40:40 -06:00
Juzisuan965	7de08ccdf7	fix: safely resolve inner type for Zod arrays (#140 )	2026-02-24 00:02:04 -06:00
Chris Tate	3201854481	external store adapter for state management (#139 ) * external store adapter for state management Introduces a `StateStore` interface that lets users plug in their own state management (Redux, Zustand, XState, etc.) instead of being locked into the internal `useState`-based store. - Added `StateStore` interface and `createStateStore()` factory to `@json-render/core` - `StateProvider`, `JSONUIProvider`, and `createRenderer` now accept an optional `store` prop for controlled mode - When `store` is provided, it becomes the single source of truth (`initialState`/`onStateChange` are ignored) - When `store` is omitted, everything works exactly as before (fully backward compatible) - Applied across all platform packages: react, react-native, react-pdf * improvements * update docs * improvements * fixes * fix CI * add store adapters * fixes * fixes * fixes * fixes * e2e tests * improvements * fixes * fixes * fixes * fixes * update lockfile for widened react peer deps * fix dashboard build	2026-02-23 23:12:57 -06:00
Chris Tate	64c889221e	fix playground og (#138 )	2026-02-22 16:10:31 -06:00
Chris Tate	49838fa353	update og font (#137 )	2026-02-22 16:02:07 -06:00
Chris Tate	fa47b08869	update header font (#136 )	2026-02-22 15:51:54 -06:00
Chris Tate	5ccb109c08	use visual-json (#135 ) * use visual-json * fix lint	2026-02-22 15:42:29 -06:00
Chris Tate	62932f6516	fix gitignore (#134 )	2026-02-22 15:20:33 -06:00
Chris Tate	ee28d548c1	use portless (#133 )	2026-02-22 15:15:17 -06:00
Chris Tate	0e6f2afc6c	fix og (#128 )	2026-02-20 02:41:16 -06:00
Chris Tate	bccedc2459	add docs (#127 )	2026-02-20 02:30:33 -06:00