fix og

.changeset/config.json

@@ -6,23 +6,9 @@
     [
       "@json-render/core",
       "@json-render/react",
-      "@json-render/react-email",
-      "@json-render/react-pdf",
-      "@json-render/shadcn",
       "@json-render/react-native",
       "@json-render/remotion",
-      "@json-render/codegen",
-      "@json-render/zustand",
-      "@json-render/redux",
-      "@json-render/jotai",
-      "@json-render/vue",
-      "@json-render/xstate",
-      "@json-render/image",
-      "@json-render/mcp",
-      "@json-render/svelte",
-      "@json-render/solid",
-      "@json-render/react-three-fiber",
-      "@json-render/yaml"
+      "@json-render/codegen"
     ]
   ],
   "linked": [],
@@ -30,7 +16,7 @@
   "baseBranch": "main",
   "updateInternalDependencies": "patch",
   "privatePackages": {
-    "version": true,
+    "version": false,
     "tag": false
   }
 }

.cursor/mcp.json

@@ -1,8 +0,0 @@
-{
-  "mcpServers": {
-    "json-render": {
-      "command": "npx",
-      "args": ["tsx", "examples/mcp/server.ts", "--stdio"]
-    }
-  }
-}

.github/workflows/ci.yml

@@ -13,43 +13,36 @@ concurrency:
   cancel-in-progress: true
 
 jobs:
-  lint:
-    name: Lint
+  ci:
+    name: Lint, Type Check & Build
     runs-on: ubuntu-latest
-    steps:
-      - uses: actions/checkout@v4
-      - uses: pnpm/action-setup@v4
-      - uses: actions/setup-node@v4
-        with:
-          node-version: 20
-          cache: pnpm
-      - run: pnpm install --frozen-lockfile
-      - run: pnpm lint
 
-  test:
-    name: Test
-    runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@v4
-      - uses: pnpm/action-setup@v4
-      - uses: actions/setup-node@v4
-        with:
-          node-version: 20
-          cache: pnpm
-      - run: pnpm install --frozen-lockfile
-      - name: Build packages
-        run: pnpm turbo run build --filter='./packages/*'
-      - run: pnpm test
+      - name: Checkout repository
+        uses: actions/checkout@v4
 
-  typecheck:
-    name: Type Check
-    runs-on: ubuntu-latest
-    steps:
-      - uses: actions/checkout@v4
-      - uses: pnpm/action-setup@v4
-      - uses: actions/setup-node@v4
+      - name: Install pnpm
+        uses: pnpm/action-setup@v4
+        with:
+          version: 9.0.0
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
         with:
           node-version: 20
-          cache: pnpm
-      - run: pnpm install --frozen-lockfile
-      - run: pnpm type-check
+          cache: "pnpm"
+
+      - name: Install dependencies
+        run: pnpm install --frozen-lockfile
+
+      - name: Lint
+        run: pnpm lint
+
+      - name: Type check
+        run: pnpm type-check
+
+      - name: Test
+        run: pnpm test
+
+      - name: Build
+        run: pnpm build

.gitignore

@@ -4,11 +4,13 @@
 node_modules
 .pnp
 .pnp.js
-.pnpm-store/
 
 # Local env files
-.env*
-!.env.example
+.env
+.env.local
+.env.development.local
+.env.test.local
+.env.production.local
 
 # Testing
 coverage
@@ -28,7 +30,6 @@ out/
 build
 dist
 *.tsbuildinfo
-.svelte-kit/
 
 
 # Debug
@@ -42,8 +43,4 @@ yarn-error.log*
 
 # opensrc - source code for packages
 opensrc/
-
-# Stripe apps (generated from template + build artifacts)
-examples/stripe-app/*/stripe-app.json
-examples/stripe-app/*/.build
-examples/stripe-app/*/yarn.lock
+.env*.local

.vscode/mcp.json

@@ -1,9 +0,0 @@
-{
-  "servers": {
-    "json-render": {
-      "type": "stdio",
-      "command": "npx",
-      "args": ["tsx", "examples/mcp/server.ts", "--stdio"]
-    }
-  }
-}

AGENTS.md

@@ -25,88 +25,12 @@ This ensures we don't install outdated versions that may have incompatible types
 ## Code Style
 
 - Do not use emojis in code or UI
+- Do not use barrel files (index.ts that re-exports from other files)
 - Use shadcn CLI to add shadcn/ui components: `pnpm dlx shadcn@latest add <component>`
-- **Web app docs (`apps/web/`):** Never use Markdown table syntax (`| col | col |`). Always use HTML `<table>` with `<thead>`, `<tbody>`, `<tr>`, `<th>`, `<td>`. Markdown tables do not render correctly in the web app. Inside HTML table cells, curly braces must be escaped as JSX expressions (e.g. `<code>{'{ "$state": "/path" }'}</code>`) because MDX parses `{` as a JSX expression boundary.
-
-## 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)
-
-## Releases
-
-This monorepo uses [Changesets](https://github.com/changesets/changesets) for versioning and publishing.
-
-### Fixed version group
-
-All public `@json-render/*` packages are in a **fixed** group (see `.changeset/config.json`). A changeset that bumps any one of them bumps all of them to the same version. You only need to list the packages that actually changed in the changeset front matter — the fixed group handles the rest.
-
-### Preparing a release
-
-When asked to prepare a release (e.g. "prepare v0.12.0"):
-
-1. **Create a changeset file** at `.changeset/v0-<N>-release.md` following the existing pattern:
-   - YAML front matter listing changed packages with bump type (`minor` for feature releases, `patch` for bug-fix-only releases)
-   - A one-line summary, then `### New:` / `### Improved:` / `### Fixed:` sections describing each change
-   - Always list `@json-render/core` plus any packages with actual code changes
-2. **Do NOT bump versions** in `package.json` files — CI runs `pnpm ci:version` (which calls `changeset version`) to do that automatically
-3. **Do NOT manually write `CHANGELOG.md`** entries — `changeset version` generates them from the changeset file
-4. **Add new packages to the fixed group** in `.changeset/config.json` if they should be versioned together with the rest
-5. **Fill documentation gaps** — every public package should have:
-   - A row in the root `README.md` packages table
-   - A renderer section in the root `README.md` (if it's a renderer)
-   - An API reference page at `apps/web/app/(main)/docs/api/<name>/page.mdx`
-   - An entry in `apps/web/lib/page-titles.ts` and `apps/web/lib/docs-navigation.ts`
-   - An entry in the docs-chat system prompt (`apps/web/app/api/docs-chat/route.ts`)
-   - A skill at `skills/<name>/SKILL.md`
-   - A `packages/<name>/README.md`
-6. **Run `pnpm type-check`** after all changes to verify nothing is broken
-
-### CI scripts
-
-- `pnpm changeset` — interactively create a new changeset
-- `pnpm ci:version` — run `changeset version` + lockfile update (CI only)
-- `pnpm ci:publish` — build all packages and publish to npm (CI only)
 
 <!-- opensrc:start -->
 

README.md

@@ -1,41 +1,25 @@
 # json-render
 
-**The Generative UI framework.**
+**The framework for User-Generated Interfaces (UGI).**
 
-Generate dynamic, personalized UIs from prompts without sacrificing reliability. Predefined components and actions for safe, predictable output.
+Dynamic, personalized UIs per user without sacrificing reliability. Predefined components and actions for safe, predictable output.
 
 ```bash
-# for React
 npm install @json-render/core @json-render/react
-# for React with pre-built shadcn/ui components
-npm install @json-render/shadcn
-# or for React Native
+# or for mobile
 npm install @json-render/core @json-render/react-native
 # or for video
 npm install @json-render/core @json-render/remotion
-# or for PDF documents
-npm install @json-render/core @json-render/react-pdf
-# or for HTML email
-npm install @json-render/core @json-render/react-email @react-email/components @react-email/render
-# or for Vue
-npm install @json-render/core @json-render/vue
-# or for Svelte
-npm install @json-render/core @json-render/svelte
-# or for SolidJS
-npm install @json-render/core @json-render/solid
-# or for 3D scenes
-npm install @json-render/core @json-render/react-three-fiber @react-three/fiber @react-three/drei three
 ```
 
 ## Why json-render?
 
-json-render is a **Generative UI** framework: AI generates interfaces from natural language prompts, constrained to components you define. You set the guardrails, AI generates within them:
+json-render enables **User-Generated Interfaces**: dynamic UIs that end users create through natural language prompts, powered by Generative UI. You define the guardrails, AI generates within them:
 
 - **Guardrailed** - AI can only use components in your catalog
 - **Predictable** - JSON output matches your schema, every time
 - **Fast** - Stream and render progressively as the model responds
-- **Cross-Platform** - React, Vue, Svelte, Solid (web), React Native (mobile) from the same catalog
-- **Batteries Included** - 36 pre-built shadcn/ui components ready to use
+- **Cross-Platform** - React (web) and React Native (mobile) from the same catalog
 
 ## Quick Start
 
@@ -43,7 +27,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/schema";
+import { schema } from "@json-render/react";
 import { z } from "zod";
 
 const catalog = defineCatalog(schema, {
@@ -95,7 +79,9 @@ const { registry } = defineRegistry(catalog, {
       </div>
     ),
     Button: ({ props, emit }) => (
-      <button onClick={() => emit("press")}>{props.label}</button>
+      <button onClick={() => emit?.("press")}>
+        {props.label}
+      </button>
     ),
   },
 });
@@ -115,27 +101,12 @@ function Dashboard({ spec }) {
 
 ## Packages
 
-| Package                     | Description                                                            |
-| --------------------------- | ---------------------------------------------------------------------- |
-| `@json-render/core`         | Schemas, catalogs, AI prompts, dynamic props, SpecStream utilities     |
-| `@json-render/react`        | React renderer, contexts, hooks                                        |
-| `@json-render/vue`          | Vue 3 renderer, composables, providers                                 |
-| `@json-render/svelte`       | Svelte 5 renderer with runes-based reactivity                          |
-| `@json-render/solid`        | SolidJS renderer with fine-grained reactive contexts                   |
-| `@json-render/shadcn`       | 36 pre-built shadcn/ui components (Radix UI + Tailwind CSS)            |
-| `@json-render/react-three-fiber` | React Three Fiber renderer for 3D scenes (19 built-in components)  |
-| `@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/react-email`  | React Email renderer for HTML/plain-text emails from specs             |
-| `@json-render/image`        | Image renderer for SVG/PNG output (OG images, social cards) via Satori |
-| `@json-render/codegen`      | Utilities for generating code from json-render UI trees                |
-| `@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`       | XState Store (atom) adapter for `StateStore`                           |
-| `@json-render/mcp`          | MCP Apps integration for Claude, ChatGPT, Cursor, VS Code              |
-| `@json-render/yaml`         | YAML wire format with streaming parser, edit modes, AI SDK transform   |
+| Package | Description |
+|---------|-------------|
+| `@json-render/core` | Schemas, catalogs, AI prompts, dynamic props, SpecStream utilities |
+| `@json-render/react` | React renderer, contexts, hooks |
+| `@json-render/react-native` | React Native renderer with standard mobile components |
+| `@json-render/remotion` | Remotion video renderer, timeline schema |
 
 ## Renderers
 
@@ -143,118 +114,22 @@ function Dashboard({ spec }) {
 
 ```tsx
 import { defineRegistry, Renderer } from "@json-render/react";
-import { schema } from "@json-render/react/schema";
+import { schema } from "@json-render/react";
 
-// Flat spec format (root key + elements map)
+// Element tree spec format
 const spec = {
-  root: "card-1",
-  elements: {
-    "card-1": {
-      type: "Card",
-      props: { title: "Hello" },
-      children: ["button-1"],
-    },
-    "button-1": {
-      type: "Button",
-      props: { label: "Click me" },
-      children: [],
-    },
-  },
+  root: {
+    type: "Card",
+    props: { title: "Hello" },
+    children: [
+      { type: "Button", props: { label: "Click me" } }
+    ]
+  }
 };
 
 // defineRegistry creates a type-safe component registry
 const { registry } = defineRegistry(catalog, { components });
-<Renderer spec={spec} registry={registry} />;
-```
-
-### Vue (UI)
-
-```typescript
-import { h } from "vue";
-import { defineRegistry, Renderer } from "@json-render/vue";
-import { schema } from "@json-render/vue/schema";
-
-const { registry } = defineRegistry(catalog, {
-  components: {
-    Card: ({ props, children }) =>
-      h("div", { class: "card" }, [h("h3", null, props.title), children]),
-    Button: ({ props, emit }) =>
-      h("button", { onClick: () => emit("press") }, props.label),
-  },
-});
-
-// In your Vue component template:
-// <Renderer :spec="spec" :registry="registry" />
-```
-
-### Svelte (UI)
-
-```typescript
-import { defineRegistry, Renderer } from "@json-render/svelte";
-import { schema } from "@json-render/svelte/schema";
-
-const { registry } = defineRegistry(catalog, {
-  components: {
-    Card: ({ props, children }) => /* Svelte 5 snippet */,
-    Button: ({ props, emit }) => /* Svelte 5 snippet */,
-  },
-});
-
-// In your Svelte component:
-// <Renderer spec={spec} registry={registry} />
-```
-
-### Solid (UI)
-
-```tsx
-import { defineRegistry, Renderer } from "@json-render/solid";
-import { schema } from "@json-render/solid/schema";
-
-const { registry } = defineRegistry(catalog, {
-  components: {
-    Card: (renderProps) => <div>{renderProps.children}</div>,
-    Button: (renderProps) => (
-      <button onClick={() => renderProps.emit("press")}>
-        {renderProps.element.props.label as string}
-      </button>
-    ),
-  },
-});
-
-<Renderer spec={spec} registry={registry} />;
-```
-
-### shadcn/ui (Web)
-
-```tsx
-import { defineCatalog } from "@json-render/core";
-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";
-
-// Pick components from the 36 standard definitions
-const catalog = defineCatalog(schema, {
-  components: {
-    Card: shadcnComponentDefinitions.Card,
-    Stack: shadcnComponentDefinitions.Stack,
-    Heading: shadcnComponentDefinitions.Heading,
-    Button: shadcnComponentDefinitions.Button,
-  },
-  actions: {},
-});
-
-// Use matching implementations
-const { registry } = defineRegistry(catalog, {
-  components: {
-    Card: shadcnComponents.Card,
-    Stack: shadcnComponents.Stack,
-    Heading: shadcnComponents.Heading,
-    Button: shadcnComponents.Button,
-  },
-});
-
-<Renderer spec={spec} registry={registry} />;
+<Renderer spec={spec} registry={registry} />
 ```
 
 ### React Native (Mobile)
@@ -275,40 +150,23 @@ const catalog = defineCatalog(schema, {
 });
 
 const { registry } = defineRegistry(catalog, { components: {} });
-<Renderer spec={spec} registry={registry} />;
+<Renderer spec={spec} registry={registry} />
 ```
 
 ### Remotion (Video)
 
 ```tsx
 import { Player } from "@remotion/player";
-import {
-  Renderer,
-  schema,
-  standardComponentDefinitions,
-} from "@json-render/remotion";
+import { Renderer, schema, standardComponentDefinitions } from "@json-render/remotion";
 
 // Timeline spec format
 const spec = {
-  composition: {
-    id: "video",
-    fps: 30,
-    width: 1920,
-    height: 1080,
-    durationInFrames: 300,
-  },
+  composition: { id: "video", fps: 30, width: 1920, height: 1080, durationInFrames: 300 },
   tracks: [{ id: "main", name: "Main", type: "video", enabled: true }],
   clips: [
-    {
-      id: "clip-1",
-      trackId: "main",
-      component: "TitleCard",
-      props: { title: "Hello" },
-      from: 0,
-      durationInFrames: 90,
-    },
+    { id: "clip-1", trackId: "main", component: "TitleCard", props: { title: "Hello" }, from: 0, durationInFrames: 90 }
   ],
-  audio: { tracks: [] },
+  audio: { tracks: [] }
 };
 
 <Player
@@ -318,165 +176,7 @@ const spec = {
   fps={spec.composition.fps}
   compositionWidth={spec.composition.width}
   compositionHeight={spec.composition.height}
-/>;
-```
-
-### React PDF (Documents)
-
-```typescript
-import { renderToBuffer } from "@json-render/react-pdf";
-
-const spec = {
-  root: "doc",
-  elements: {
-    doc: {
-      type: "Document",
-      props: { title: "Invoice" },
-      children: ["page-1"],
-    },
-    "page-1": {
-      type: "Page",
-      props: { size: "A4" },
-      children: ["heading-1", "table-1"],
-    },
-    "heading-1": {
-      type: "Heading",
-      props: { text: "Invoice #1234", level: "h1" },
-      children: [],
-    },
-    "table-1": {
-      type: "Table",
-      props: {
-        columns: [
-          { header: "Item", width: "60%" },
-          { header: "Price", width: "40%", align: "right" },
-        ],
-        rows: [
-          ["Widget A", "$10.00"],
-          ["Widget B", "$25.00"],
-        ],
-      },
-      children: [],
-    },
-  },
-};
-
-// Render to buffer, stream, or file
-const buffer = await renderToBuffer(spec);
-```
-
-### React Email (Email)
-
-```typescript
-import { renderToHtml } from "@json-render/react-email";
-import { schema, standardComponentDefinitions } from "@json-render/react-email";
-import { defineCatalog } from "@json-render/core";
-
-const catalog = defineCatalog(schema, {
-  components: standardComponentDefinitions,
-});
-
-const spec = {
-  root: "html-1",
-  elements: {
-    "html-1": {
-      type: "Html",
-      props: { lang: "en", dir: "ltr" },
-      children: ["head-1", "body-1"],
-    },
-    "head-1": { type: "Head", props: {}, children: [] },
-    "body-1": {
-      type: "Body",
-      props: { style: { backgroundColor: "#f6f9fc" } },
-      children: ["container-1"],
-    },
-    "container-1": {
-      type: "Container",
-      props: {
-        style: { maxWidth: "600px", margin: "0 auto", padding: "20px" },
-      },
-      children: ["heading-1", "text-1"],
-    },
-    "heading-1": { type: "Heading", props: { text: "Welcome" }, children: [] },
-    "text-1": {
-      type: "Text",
-      props: { text: "Thanks for signing up." },
-      children: [],
-    },
-  },
-};
-
-const html = await renderToHtml(spec);
-```
-
-### Image (SVG/PNG)
-
-```typescript
-import { renderToPng } from "@json-render/image/render";
-
-const spec = {
-  root: "frame",
-  elements: {
-    frame: {
-      type: "Frame",
-      props: { width: 1200, height: 630, backgroundColor: "#1a1a2e" },
-      children: ["heading"],
-    },
-    heading: {
-      type: "Heading",
-      props: { text: "Hello World", level: "h1", color: "#ffffff" },
-      children: [],
-    },
-  },
-};
-
-// Render to PNG (requires @resvg/resvg-js)
-const png = await renderToPng(spec, { fonts });
-
-// Or render to SVG string
-import { renderToSvg } from "@json-render/image/render";
-const svg = await renderToSvg(spec, { fonts });
-```
-
-### Three.js (3D)
-
-```tsx
-import { defineCatalog } from "@json-render/core";
-import { schema, defineRegistry } from "@json-render/react";
-import {
-  threeComponentDefinitions,
-  threeComponents,
-  ThreeCanvas,
-} from "@json-render/react-three-fiber";
-
-const catalog = defineCatalog(schema, {
-  components: {
-    Box: threeComponentDefinitions.Box,
-    Sphere: threeComponentDefinitions.Sphere,
-    AmbientLight: threeComponentDefinitions.AmbientLight,
-    DirectionalLight: threeComponentDefinitions.DirectionalLight,
-    OrbitControls: threeComponentDefinitions.OrbitControls,
-  },
-  actions: {},
-});
-
-const { registry } = defineRegistry(catalog, {
-  components: {
-    Box: threeComponents.Box,
-    Sphere: threeComponents.Sphere,
-    AmbientLight: threeComponents.AmbientLight,
-    DirectionalLight: threeComponents.DirectionalLight,
-    OrbitControls: threeComponents.OrbitControls,
-  },
-});
-
-<ThreeCanvas
-  spec={spec}
-  registry={registry}
-  shadows
-  camera={{ position: [5, 5, 5], fov: 50 }}
-  style={{ width: "100%", height: "100vh" }}
-/>;
+/>
 ```
 
 ## Features
@@ -513,10 +213,12 @@ const systemPrompt = catalog.prompt();
 {
   "type": "Alert",
   "props": { "message": "Error occurred" },
-  "visible": [
-    { "$state": "/form/hasError" },
-    { "$state": "/form/errorDismissed", "not": true }
-  ]
+  "visible": {
+    "and": [
+      { "path": "/form/hasError" },
+      { "not": { "path": "/form/errorDismissed" } }
+    ]
+  }
 }
 ```
 
@@ -528,26 +230,16 @@ Any prop value can be data-driven using expressions:
 {
   "type": "Icon",
   "props": {
-    "name": {
-      "$cond": { "$state": "/activeTab", "eq": "home" },
-      "$then": "home",
-      "$else": "home-outline"
-    },
-    "color": {
-      "$cond": { "$state": "/activeTab", "eq": "home" },
-      "$then": "#007AFF",
-      "$else": "#8E8E93"
-    }
+    "name": { "$cond": { "eq": [{ "path": "/activeTab" }, "home"] }, "$then": "home", "$else": "home-outline" },
+    "color": { "$cond": { "eq": [{ "path": "/activeTab" }, "home"] }, "$then": "#007AFF", "$else": "#8E8E93" }
   }
 }
 ```
 
-Expression forms:
+Two expression forms:
 
-- **`{ "$state": "/state/key" }`** - reads a value from the state model
-- **`{ "$cond": <condition>, "$then": <value>, "$else": <value> }`** - evaluates a condition and picks a branch
-- **`{ "$template": "Hello, ${/user/name}!" }`** - interpolates state values into strings
-- **`{ "$computed": "fn", "args": { ... } }`** - calls a registered function with resolved args
+- **`{ "$path": "/state/key" }`** - reads a value from the data model
+- **`{ "$cond": <condition>, "$then": <value>, "$else": <value> }`** - evaluates a condition (same syntax as visibility conditions) and picks a branch
 
 ### Actions
 
@@ -556,38 +248,13 @@ Components can trigger actions, including the built-in `setState` action:
 ```json
 {
   "type": "Pressable",
-  "props": {
-    "action": "setState",
-    "actionParams": { "statePath": "/activeTab", "value": "home" }
-  },
+  "props": { "action": "setState", "actionParams": { "path": "/activeTab", "value": "home" } },
   "children": ["home-icon"]
 }
 ```
 
 The `setState` action updates the state model directly, which re-evaluates visibility conditions and dynamic prop expressions.
 
-### State Watchers
-
-React to state changes by triggering actions:
-
-```json
-{
-  "type": "Select",
-  "props": {
-    "value": { "$bindState": "/form/country" },
-    "options": ["US", "Canada", "UK"]
-  },
-  "watch": {
-    "/form/country": {
-      "action": "loadCities",
-      "params": { "country": { "$state": "/form/country" } }
-    }
-  }
-}
-```
-
-`watch` is a top-level field on elements (sibling of `type`/`props`/`children`). Watchers fire when the watched value changes, not on initial render.
-
 ---
 
 ## Demo
@@ -599,14 +266,9 @@ pnpm install
 pnpm dev
 ```
 
-- http://json-render.localhost:1355 - Docs & Playground
-- http://dashboard-demo.json-render.localhost:1355 - Example Dashboard
-- http://react-email-demo.json-render.localhost:1355 - React Email Example
-- http://remotion-demo.json-render.localhost:1355 - Remotion Video Example
-- Chat Example: run `pnpm dev` in `examples/chat`
-- Svelte Example: run `pnpm dev` in `examples/svelte` or `examples/svelte-chat`
-- Vue Example: run `pnpm dev` in `examples/vue`
-- Vite Renderers (React + Vue + Svelte + Solid): run `pnpm dev` in `examples/vite-renderers`
+- http://localhost:3000 - Docs & Playground
+- http://localhost:3001 - Example Dashboard
+- http://localhost:3002 - Remotion Video Example
 - React Native example: run `npx expo start` in `examples/react-native`
 
 ## How It Works
@@ -616,14 +278,14 @@ flowchart LR
     A[User Prompt] --> B[AI + Catalog]
     B --> C[JSON Spec]
     C --> D[Renderer]
-
+    
     B -.- E([guardrailed])
     C -.- F([predictable])
     D -.- G([streamed])
 ```
 
 1. **Define the guardrails** - what components, actions, and data bindings AI can use
-2. **Prompt** - describe what you want in natural language
+2. **Users generate** - end users describe what they want in natural language
 3. **AI generates JSON** - output is always predictable, constrained to your catalog
 4. **Render fast** - stream and render progressively as the model responds
 

apps/web/.env.example

@@ -12,7 +12,3 @@ AI_GATEWAY_MODEL=anthropic/claude-haiku-4.5
 # Automatically populated when you add Vercel KV to your project
 KV_REST_API_URL=
 KV_REST_API_TOKEN=
-
-# Rate Limiting
-# RATE_LIMIT_PER_MINUTE=10
-# RATE_LIMIT_PER_DAY=100

apps/web/CHANGELOG.md

@@ -1,84 +0,0 @@
-# web
-
-## 0.1.9
-
-### Patch Changes
-
-- Updated dependencies [43b7515]
-  - @json-render/core@0.14.1
-  - @json-render/codegen@0.14.1
-  - @json-render/react@0.14.1
-  - @json-render/yaml@0.14.1
-
-## 0.1.8
-
-### Patch Changes
-
-- Updated dependencies [a8afd8b]
-  - @json-render/core@0.14.0
-  - @json-render/yaml@0.14.0
-  - @json-render/codegen@0.14.0
-  - @json-render/react@0.14.0
-
-## 0.1.7
-
-### Patch Changes
-
-- Updated dependencies [5b32de8]
-  - @json-render/core@0.13.0
-  - @json-render/codegen@0.13.0
-  - @json-render/react@0.13.0
-
-## 0.1.6
-
-### Patch Changes
-
-- Updated dependencies [54a1ecf]
-  - @json-render/core@0.12.1
-  - @json-render/codegen@0.12.1
-  - @json-render/react@0.12.1
-
-## 0.1.5
-
-### Patch Changes
-
-- Updated dependencies [63c339b]
-  - @json-render/core@0.12.0
-  - @json-render/codegen@0.12.0
-  - @json-render/react@0.12.0
-
-## 0.1.4
-
-### Patch Changes
-
-- Updated dependencies [3f1e71e]
-  - @json-render/core@0.11.0
-  - @json-render/codegen@0.11.0
-  - @json-render/react@0.11.0
-
-## 0.1.3
-
-### Patch Changes
-
-- Updated dependencies [9cef4e9]
-  - @json-render/core@0.10.0
-  - @json-render/react@0.10.0
-  - @json-render/codegen@0.10.0
-
-## 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

apps/web/README.md

@@ -14,7 +14,7 @@ pnpm dev
 bun dev
 ```
 
-Open [http://json-render.localhost:1355](http://json-render.localhost:1355) with your browser to see the result.
+Open [http://localhost:3000](http://localhost:3000) 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.
 

apps/web/app/(main)/docs/a2ui/page.mdx

@@ -1,5 +1,4 @@
-import { pageMetadata } from "@/lib/page-metadata"
-export const metadata = pageMetadata("docs/a2ui")
+export const metadata = { title: "A2UI Integration" }
 
 # A2UI Integration
 
@@ -66,8 +65,7 @@ A2UI uses an adjacency list model - a flat list of components with ID references
 ## Define the A2UI Catalog
 
 ```typescript
-import { defineCatalog } from '@json-render/core';
-import { schema } from '@json-render/react/schema';
+import { createCatalog } from '@json-render/core';
 import { z } from 'zod';
 
 // A2UI BoundValue schema
@@ -85,7 +83,7 @@ const Children = z.object({
   }).optional(),
 }).refine(d => d.explicitList || d.template);
 
-export const a2uiCatalog = defineCatalog(schema, {
+export const a2uiCatalog = createCatalog({
   components: {
     Text: {
       description: 'Displays text content',

apps/web/app/(main)/docs/adaptive-cards/page.mdx

@@ -1,5 +1,4 @@
-import { pageMetadata } from "@/lib/page-metadata"
-export const metadata = pageMetadata("docs/adaptive-cards")
+export const metadata = { title: "Adaptive Cards Integration" }
 
 # Adaptive Cards Integration
 
@@ -89,8 +88,7 @@ Adaptive Cards is a JSON-based format for platform-agnostic UI snippets. Cards h
 Define a catalog matching the Adaptive Cards element types:
 
 ```typescript
-import { defineCatalog } from '@json-render/core';
-import { schema } from '@json-render/react/schema';
+import { createCatalog } from '@json-render/core';
 import { z } from 'zod';
 
 // Common Adaptive Cards properties
@@ -110,7 +108,7 @@ const BaseElement = {
   spacing: Spacing.optional(),
 };
 
-export const adaptiveCardsCatalog = defineCatalog(schema, {
+export const adaptiveCardsCatalog = createCatalog({
   components: {
     // Root card
     AdaptiveCard: {

apps/web/app/(main)/docs/ag-ui/page.mdx

@@ -1,5 +1,4 @@
-import { pageMetadata } from "@/lib/page-metadata"
-export const metadata = pageMetadata("docs/ag-ui")
+export const metadata = { title: "AG-UI Integration" }
 
 # AG-UI Integration
 
@@ -150,11 +149,10 @@ export type AGUIEvent = z.infer<typeof AGUIEvent>;
 Create a catalog for UI components that agents can render:
 
 ```typescript
-import { defineCatalog } from '@json-render/core';
-import { schema } from '@json-render/react/schema';
+import { createCatalog } from '@json-render/core';
 import { z } from 'zod';
 
-export const aguiCatalog = defineCatalog(schema, {
+export const aguiCatalog = createCatalog({
   components: {
     Container: {
       description: 'A container for grouping elements',

apps/web/app/(main)/docs/ai-sdk/page.mdx

@@ -1,39 +1,35 @@
-import { pageMetadata } from "@/lib/page-metadata"
-export const metadata = pageMetadata("docs/ai-sdk")
+export const metadata = { title: "AI SDK Integration" }
 
 # AI SDK Integration
 
-Use json-render with the [Vercel AI SDK](https://sdk.vercel.ai) for seamless streaming. json-render supports two modes: **Standalone** (standalone UI) and **Inline** (UI embedded in conversation). See [Generation Modes](/docs/generation-modes) for a detailed comparison.
+Use json-render with the Vercel AI SDK for seamless streaming.
 
 ## Installation
 
 ```bash
-npm install ai @ai-sdk/react
+npm install ai
 ```
 
-## Standalone Mode
-
-In standalone mode, the AI outputs only JSONL patches. The entire response is a UI spec with no prose. This is the default mode and is ideal for playgrounds, builders, and dashboard generators.
-
-### API Route
+## API Route Setup
 
 ```typescript
 // app/api/generate/route.ts
-import { streamText } from "ai";
-import { catalog } from "@/lib/catalog";
+import { streamText } from 'ai';
+import { catalog } from '@/lib/catalog';
 
 export async function POST(req: Request) {
   const { prompt, currentTree } = await req.json();
-
+  
+  // Generate system prompt from catalog
   const systemPrompt = catalog.prompt();
-
+  
   // Optionally include current UI state for context
-  const contextPrompt = currentTree
+  const contextPrompt = currentTree 
     ? `\n\nCurrent UI state:\n${JSON.stringify(currentTree, null, 2)}`
-    : "";
+    : '';
 
   const result = streamText({
-    model: yourModel,
+    model: 'anthropic/claude-haiku-4.5',
     system: systemPrompt + contextPrompt,
     prompt,
   });
@@ -42,198 +38,60 @@ export async function POST(req: Request) {
 }
 ```
 
-### Client
+## Client-Side Hook
 
-Use `useUIStream` on the client to compile the JSONL stream into a spec:
+Use `useUIStream` on the client:
 
 ```tsx
-"use client";
+'use client';
 
-import { useUIStream, Renderer } from "@json-render/react";
+import { useUIStream, Renderer } from '@json-render/react';
 
 function GenerativeUI() {
   const { spec, isStreaming, error, send } = useUIStream({
-    api: "/api/generate",
+    api: '/api/generate',
   });
 
   return (
     <div>
-      <button
-        onClick={() => send("Create a dashboard with metrics")}
+      <button 
+        onClick={() => send('Create a dashboard with metrics')}
         disabled={isStreaming}
       >
-        {isStreaming ? "Generating..." : "Generate"}
+        {isStreaming ? 'Generating...' : 'Generate'}
       </button>
-
+      
       {error && <p className="text-red-500">{error.message}</p>}
-
+      
       <Renderer spec={spec} registry={registry} loading={isStreaming} />
     </div>
   );
 }
 ```
 
-## Inline Mode
-
-In inline mode, the AI responds conversationally and includes JSONL patches inline. Text-only replies are allowed when no UI is needed. This is ideal for chatbots, copilots, and educational assistants.
-
-### API Route
-
-Use `pipeJsonRender` to separate text from JSONL patches in the stream. Patches are emitted as data parts that the client can pick up.
-
-```typescript
-// app/api/chat/route.ts
-import { streamText } from "ai";
-import { pipeJsonRender } from "@json-render/core";
-import {
-  createUIMessageStream,
-  createUIMessageStreamResponse,
-} from "ai";
-import { catalog } from "@/lib/catalog";
-
-export async function POST(req: Request) {
-  const { messages } = await req.json();
-
-  const result = streamText({
-    model: yourModel,
-    system: catalog.prompt({ mode: "inline" }),
-    messages,
-  });
-
-  const stream = createUIMessageStream({
-    execute: async ({ writer }) => {
-      writer.merge(pipeJsonRender(result.toUIMessageStream()));
-    },
-  });
-
-  return createUIMessageStreamResponse({ stream });
-}
-```
-
-### Client
-
-Use `useChat` from the AI SDK and `useJsonRenderMessage` from json-render to extract the spec from each message:
-
-```tsx
-"use client";
-
-import { useChat } from "@ai-sdk/react";
-import { useJsonRenderMessage, Renderer } from "@json-render/react";
-
-function Chat() {
-  const { messages, input, handleInputChange, handleSubmit } = useChat({
-    api: "/api/chat",
-  });
-
-  return (
-    <div>
-      <div>
-        {messages.map((msg) => (
-          <ChatMessage key={msg.id} message={msg} />
-        ))}
-      </div>
-
-      <form onSubmit={handleSubmit}>
-        <input
-          value={input}
-          onChange={handleInputChange}
-          placeholder="Ask something..."
-        />
-        <button type="submit">Send</button>
-      </form>
-    </div>
-  );
-}
-
-function ChatMessage({ message }: { message: { parts: Array<{ type: string; text?: string; data?: unknown }> } }) {
-  const { spec, text, hasSpec } = useJsonRenderMessage(message.parts);
-
-  return (
-    <div>
-      {text && <p>{text}</p>}
-      {hasSpec && spec && (
-        <Renderer spec={spec} registry={registry} />
-      )}
-    </div>
-  );
-}
-```
-
 ## Prompt Engineering
 
 The `catalog.prompt()` method creates an optimized system prompt that:
 
 - Lists all available components and their props
 - Describes available actions
-- Specifies the expected output format (JSONL-only or text + JSONL depending on mode)
+- Specifies the expected JSON output format
 - Includes examples for better generation
 
-### Custom Rules
+## Custom System Prompts
 
 Pass custom rules to tailor AI behavior:
 
 ```typescript
 const systemPrompt = catalog.prompt({
   customRules: [
-    "Always use Card components for grouping related content",
-    "Prefer horizontal layouts (Row) for metrics",
-    "Use consistent spacing with padding=\"md\"",
+    'Always use Card components for grouping related content',
+    'Prefer horizontal layouts (Row) for metrics',
+    'Use consistent spacing with padding="md"',
   ],
 });
 ```
 
-### Inline Mode Prompt
-
-```typescript
-const inlinePrompt = catalog.prompt({ mode: "inline" });
-```
-
-In inline mode, the prompt instructs the AI to respond conversationally first, then include JSONL patches on their own lines when UI is needed. Text-only replies are allowed.
-
-## Which Mode?
-
-<div className="my-6 overflow-x-auto">
-  <table className="mdx-table w-full text-sm border-collapse">
-    <thead>
-      <tr>
-        <th></th>
-        <th>Standalone</th>
-        <th>Inline</th>
-      </tr>
-    </thead>
-    <tbody>
-      <tr>
-        <td>Output</td>
-        <td>JSONL only</td>
-        <td>Text + JSONL</td>
-      </tr>
-      <tr>
-        <td>Text-only replies</td>
-        <td>No</td>
-        <td>Yes</td>
-      </tr>
-      <tr>
-        <td>System prompt</td>
-        <td><code>catalog.prompt()</code></td>
-        <td><code>{"catalog.prompt({ mode: \"inline\" })"}</code></td>
-      </tr>
-      <tr>
-        <td>Stream utility</td>
-        <td><code>useUIStream</code></td>
-        <td><code>pipeJsonRender</code> + <code>useJsonRenderMessage</code></td>
-      </tr>
-      <tr>
-        <td>Use case</td>
-        <td>Playgrounds, builders</td>
-        <td>Chatbots, copilots</td>
-      </tr>
-    </tbody>
-  </table>
-</div>
-
-Learn more in the [Generation Modes](/docs/generation-modes) guide.
-
 ## Next
 
-- Learn about [progressive streaming](/docs/streaming)
-- See the [chat example](https://github.com/vercel-labs/json-render/tree/main/examples/chat) for a complete implementation
+Learn about [progressive streaming](/docs/streaming).

apps/web/app/(main)/docs/api/codegen/page.mdx

@@ -1,5 +1,4 @@
-import { pageMetadata } from "@/lib/page-metadata"
-export const metadata = pageMetadata("docs/api/codegen")
+export const metadata = { title: "@json-render/codegen API" }
 
 # @json-render/codegen
 
@@ -14,12 +13,12 @@ Walk the UI spec depth-first.
 ```typescript
 function traverseSpec(
   spec: Spec,
-  visitor: TreeVisitor,
+  visitor: SpecVisitor,
   startKey?: string
 ): void
 
-interface TreeVisitor {
-  (element: UIElement, key: string, depth: number, parent: UIElement | null): void;
+interface SpecVisitor {
+  (element: UIElement, depth: number, parent: UIElement | null): void;
 }
 ```
 
@@ -37,7 +36,7 @@ const components = collectUsedComponents(spec);
 
 ### collectStatePaths
 
-Get all state paths referenced in props (statePath, bindPath, etc.).
+Get all state paths referenced in props (statePath, bindPath, valuePath, etc.).
 
 ```typescript
 function collectStatePaths(spec: Spec): Set<string>
@@ -78,8 +77,8 @@ serializePropValue("hello")
 serializePropValue(42)
 // { value: '42', needsBraces: true }
 
-serializePropValue({ $state: '/user/name' })
-// { value: '{ $state: "/user/name" }', needsBraces: true }
+serializePropValue({ path: 'user/name' })
+// { value: '{ path: "user/name" }', needsBraces: true }
 ```
 
 ### serializeProps

apps/web/app/(main)/docs/api/core/page.mdx

@@ -1,5 +1,4 @@
-import { pageMetadata } from "@/lib/page-metadata"
-export const metadata = pageMetadata("docs/api/core")
+export const metadata = { title: "@json-render/core API" }
 
 # @json-render/core
 
@@ -11,7 +10,7 @@ Creates a type-safe catalog definition with schema validation.
 
 ```typescript
 import { defineCatalog } from '@json-render/core';
-import { schema } from '@json-render/react/schema';
+import { schema } from '@json-render/react';
 
 function defineCatalog<T extends ZodType>(
   s: T,
@@ -73,10 +72,8 @@ interface Catalog {
 }
 
 interface PromptOptions {
-  system?: string;           // Custom system message intro
-  customRules?: string[];    // Additional rules to append
-  mode?: "standalone" | "inline" | "generate" | "chat"; // Output mode (default: "standalone")
-  editModes?: EditMode[];    // Edit modes to document in prompt (default: ["patch"])
+  system?: string;        // Custom system message intro
+  customRules?: string[]; // Additional rules to append
 }
 
 interface SpecValidationResult<T> {
@@ -120,7 +117,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/schema';
+import { schema } from '@json-render/react';
 
 // schema defines:
 // - Spec shape: { root: string, elements: Record<string, UIElement> }
@@ -143,25 +140,6 @@ const catalog = defineCatalog(schema, {
 });
 ```
 
-### SchemaOptions
-
-When creating schemas with `defineSchema`, you can pass options:
-
-```typescript
-interface SchemaOptions {
-  promptTemplate?: PromptTemplate;  // Custom AI prompt generator
-  defaultRules?: string[];          // Default rules injected before custom rules in prompts
-  builtInActions?: BuiltInAction[]; // Actions always available at runtime, auto-injected into prompts
-}
-
-interface BuiltInAction {
-  name: string;        // Action name (e.g. "setState")
-  description: string; // Human-readable description for the LLM
-}
-```
-
-Built-in actions are injected into prompts as `[built-in]` and are handled by the runtime (e.g. `ActionProvider`) without requiring handlers in `defineRegistry`. The React schema declares `setState`, `pushState`, and `removeState` as built-in.
-
 ### defineSchema
 
 Create custom schemas for different output formats (e.g., page-based, block-based).
@@ -225,25 +203,28 @@ Pre-built Zod schemas for common json-render types:
 
 ```typescript
 import {
-  DynamicValueSchema,    // string | number | boolean | null | { $state: string }
-  DynamicStringSchema,   // string | { $state: string }
-  DynamicNumberSchema,   // number | { $state: string }
-  DynamicBooleanSchema,  // boolean | { $state: string }
+  DynamicValueSchema,    // string | number | boolean | null | { path: string }
+  DynamicStringSchema,   // string | { path: string }
+  DynamicNumberSchema,   // number | { path: string }
+  DynamicBooleanSchema,  // boolean | { path: string }
 } from '@json-render/core';
 
-// Dynamic values can be literals or state path references
-type DynamicValue<T> = T | { $state: string };
+// Dynamic values can be literals or data path references
+type DynamicValue<T> = T | { path: string };
 
-// Example: a prop that can be a literal or bound to state
+// Example: a prop that can be a literal or bound to data
 const schema = z.object({
-  label: DynamicStringSchema,  // "Hello" or { $state: "/user/name" }
+  label: DynamicStringSchema,  // "Hello" or { path: "/user/name" }
 });
 ```
 
-### Visibility Schemas
+### Visibility & Logic Schemas
 
 ```typescript
-import { VisibilityConditionSchema } from '@json-render/core';
+import {
+  VisibilityConditionSchema,  // Full visibility condition
+  LogicExpressionSchema,      // Logic operators (and, or, not, eq, gt, etc.)
+} from '@json-render/core';
 
 // Use in component props that need conditional rendering
 const schema = z.object({
@@ -323,89 +304,6 @@ const obj = {};
 applySpecStreamPatch(obj, patch);
 ```
 
-### applySpecPatch
-
-Apply a single SpecStream patch to a Spec object (mutates in place, returns the spec):
-
-```typescript
-import { applySpecPatch } from '@json-render/core';
-
-let spec: Spec = { root: "", elements: {} };
-applySpecPatch(spec, { op: "add", path: "/root", value: "main" });
-
-// For React state updates, spread to create a new reference:
-setSpec({ ...applySpecPatch(spec, patch) });
-```
-
-### nestedToFlat
-
-Convert a nested element tree (with inline children) into the flat `Spec` format:
-
-```typescript
-import { nestedToFlat } from '@json-render/core';
-
-const flat = nestedToFlat({
-  type: "Card",
-  props: { title: "Hello" },
-  children: [
-    { type: "Text", props: { content: "World" }, children: [] }
-  ],
-});
-// { root: "el-0", elements: { "el-0": ..., "el-1": ... } }
-```
-
-### createJsonRenderTransform
-
-Low-level `TransformStream` that separates text from JSONL patches in a mixed AI stream. Lines that parse as JSONL patches are emitted as `data-spec` parts; everything else passes through as text.
-
-The transform properly splits text blocks around spec data by emitting `text-end`/`text-start` pairs, ensuring the AI SDK creates separate text parts and preserving correct interleaving of prose and UI in `message.parts`.
-
-```typescript
-import { createJsonRenderTransform } from '@json-render/core';
-
-const transform = createJsonRenderTransform();
-// Use with ReadableStream.pipeThrough(transform) for custom pipelines
-```
-
-Most users should use `pipeJsonRender()` instead, which wraps this transform for the common AI SDK use case.
-
-### createMixedStreamParser
-
-Parse a mixed stream of text and JSONL patches (used for Inline mode):
-
-```typescript
-import { createMixedStreamParser } from '@json-render/core';
-
-const parser = createMixedStreamParser({
-  onText: (text) => appendToMessage(text),
-  onPatch: (patch) => applySpecPatch(spec, patch),
-});
-
-// As chunks arrive from the stream:
-for await (const chunk of stream) {
-  parser.push(chunk);
-}
-parser.flush();
-```
-
-### pipeJsonRender
-
-Pipe an AI SDK `UIMessageStream` through the json-render transform. Lines that parse as JSONL patches are emitted as `data-spec` parts; everything else passes through as text. Used in Inline mode API routes.
-
-```typescript
-import { pipeJsonRender } from '@json-render/core';
-import { createUIMessageStream, createUIMessageStreamResponse } from 'ai';
-
-const stream = createUIMessageStream({
-  execute: async ({ writer }) => {
-    writer.merge(pipeJsonRender(result.toUIMessageStream()));
-  },
-});
-return createUIMessageStreamResponse({ stream });
-```
-
-See [Generation Modes](/docs/generation-modes) for full Inline mode setup.
-
 ### SpecStream Types
 
 Fully compliant with [RFC 6902](https://datatracker.ietf.org/doc/html/rfc6902):
@@ -424,16 +322,6 @@ interface SpecStreamCompiler<T> {
   getPatches(): SpecStreamLine[];
   reset(): void;
 }
-
-interface MixedStreamCallbacks {
-  onText: (text: string) => void;
-  onPatch: (patch: SpecStreamLine) => void;
-}
-
-interface MixedStreamParser {
-  push(chunk: string): void;
-  flush(): void;
-}
 ```
 
 ## Utility Functions
@@ -444,10 +332,10 @@ interface MixedStreamParser {
 import { getByPath, setByPath } from '@json-render/core';
 
 // Get value by JSON Pointer path
-const value = getByPath(state, '/user/name');  // "Alice"
+const value = getByPath(data, '/user/name');  // "Alice"
 
 // Set value by path (mutates object)
-setByPath(state, '/user/email', 'alice@example.com');
+setByPath(data, '/user/email', 'alice@example.com');
 ```
 
 ### resolveDynamicValue
@@ -455,9 +343,9 @@ setByPath(state, '/user/email', 'alice@example.com');
 ```typescript
 import { resolveDynamicValue } from '@json-render/core';
 
-// Resolve a dynamic value against state
-const name = resolveDynamicValue("Hello", state);        // "Hello"
-const name2 = resolveDynamicValue({ $state: "/user/name" }, state);  // "Alice"
+// Resolve a dynamic value against data
+const name = resolveDynamicValue("Hello", data);        // "Hello"
+const name2 = resolveDynamicValue({ path: "/user/name" }, data);  // "Alice"
 ```
 
 ### findFormValue
@@ -466,177 +354,32 @@ const name2 = resolveDynamicValue({ $state: "/user/name" }, state);  // "Alice"
 import { findFormValue } from '@json-render/core';
 
 // Find form values regardless of path format
-// Checks: params.name, params["form.name"], state["form.name"], state.form.name
-const value = findFormValue("name", params, state);
-```
-
-## buildUserPrompt
-
-Build structured user prompts for AI generation, with support for refinement and state context.
-
-```typescript
-import { buildUserPrompt } from '@json-render/core';
-
-function buildUserPrompt(options: UserPromptOptions): string
-
-interface UserPromptOptions {
-  prompt: string;                        // The user's text prompt
-  currentSpec?: Spec | null;             // Existing spec to refine (triggers edit mode)
-  state?: Record<string, unknown> | null; // Runtime state context to include
-  maxPromptLength?: number;              // Max length for user text (truncates before wrapping)
-  editModes?: EditMode[];                // Edit modes for refinement (default: ["patch"])
-}
-```
-
-### Fresh generation
-
-```typescript
-const userPrompt = buildUserPrompt({ prompt: "create a todo app" });
-```
-
-### Refinement (edit modes)
-
-When `currentSpec` is provided, the prompt instructs the AI to use the specified edit modes instead of recreating the entire spec. Available modes: `"patch"` (RFC 6902), `"merge"` (RFC 7396), and `"diff"` (unified diff).
-
-```typescript
-const userPrompt = buildUserPrompt({
-  prompt: "add a dark mode toggle",
-  currentSpec: existingSpec,
-  editModes: ["patch", "merge"],
-});
-```
-
-### With state context
-
-Include runtime state so the AI knows what data is available:
-
-```typescript
-const userPrompt = buildUserPrompt({
-  prompt: "show my data",
-  state: { todos: [{ text: "Buy milk" }] },
-});
-```
-
-## Edit Modes
-
-Universal edit mode utilities for modifying existing specs. Used by `buildUserPrompt` internally and available for direct use.
-
-```typescript
-import {
-  buildEditInstructions,
-  buildEditUserPrompt,
-  isNonEmptySpec,
-  type EditMode,
-  type EditConfig,
-} from '@json-render/core';
-
-type EditMode = "patch" | "merge" | "diff";
-```
-
-### buildEditInstructions
-
-Generate the prompt section describing available edit modes. Supports both JSON and YAML formats.
-
-```typescript
-function buildEditInstructions(config: EditConfig, format: "json" | "yaml"): string
-
-const instructions = buildEditInstructions({ modes: ["patch", "merge"] }, "json");
-```
-
-### buildEditUserPrompt
-
-Build a user prompt for editing an existing spec. Includes the current spec (with line numbers when diff mode is enabled) and mode-specific instructions.
-
-```typescript
-function buildEditUserPrompt(options: BuildEditUserPromptOptions): string
-
-interface BuildEditUserPromptOptions {
-  prompt: string;
-  currentSpec?: Spec | null;
-  config?: EditConfig;
-  format: "json" | "yaml";
-  maxPromptLength?: number;
-  serializer?: (spec: Spec) => string;
-}
-```
-
-### isNonEmptySpec
-
-Check whether a value is a non-empty spec (has a root string and at least one element).
-
-```typescript
-function isNonEmptySpec(spec: unknown): spec is Spec
-```
-
-## Deep Merge and Diff
-
-Format-agnostic utilities for merging and diffing spec objects.
-
-### deepMergeSpec
-
-Deep-merge with RFC 7396 semantics: `null` deletes, arrays replace, objects recurse. Neither input is mutated.
-
-```typescript
-import { deepMergeSpec } from '@json-render/core';
-
-function deepMergeSpec(
-  base: Record<string, unknown>,
-  patch: Record<string, unknown>
-): Record<string, unknown>
-
-const merged = deepMergeSpec(currentSpec, { elements: { main: { props: { title: "New" } } } });
-```
-
-### diffToPatches
-
-Generate RFC 6902 JSON Patch operations that transform one object into another. Arrays are compared shallowly and replaced atomically; plain objects recurse.
-
-```typescript
-import { diffToPatches } from '@json-render/core';
-
-function diffToPatches(
-  oldObj: Record<string, unknown>,
-  newObj: Record<string, unknown>,
-  basePath?: string
-): JsonPatch[]
-
-const patches = diffToPatches(oldSpec, newSpec);
-// [{ op: "replace", path: "/elements/main/props/title", value: "New Title" }]
+// Checks: params.name, params["form.name"], data["form.name"], data.form.name
+const value = findFormValue("name", params, data);
 ```
 
 ## evaluateVisibility
 
-Evaluates a visibility condition against the state model.
+Evaluates a visibility condition against data and auth state.
 
 ```typescript
 function evaluateVisibility(
   condition: VisibilityCondition | undefined,
-  ctx: VisibilityContext
+  data: Record<string, unknown>,
+  auth?: AuthState
 ): boolean
 
-interface VisibilityContext {
-  stateModel: StateModel;
-  repeatItem?: unknown;    // Current repeat item (inside repeat scope)
-  repeatIndex?: number;    // Current repeat array index (inside repeat scope)
-}
-
 type VisibilityCondition =
-  | { $state: string }                                    // truthiness
-  | { $state: string; not: true }                         // falsy
-  | { $state: string; eq: unknown }                       // equality
-  | { $state: string; neq: unknown }                      // inequality
-  | { $state: string; gt: number }                        // greater than
-  | { $state: string; gte: number }                       // gte
-  | { $state: string; lt: number }                        // lt
-  | { $state: string; lte: number }                       // lte
-  | { $item: string }                                     // item field (repeat scope)
-  | { $item: string; eq: unknown }                        // item field equality
-  | { $index: true }                                      // index truthiness (repeat scope)
-  | { $index: true; gt: number }                          // index comparison
-  | VisibilityCondition[]                                 // implicit AND
-  | { $and: VisibilityCondition[] }                       // explicit AND
-  | { $or: VisibilityCondition[] }                        // OR
-  | boolean;                                              // always / never
+  | { path: string }
+  | { auth: 'signedIn' | 'signedOut' | string }
+  | { and: VisibilityCondition[] }
+  | { or: VisibilityCondition[] }
+  | { not: VisibilityCondition }
+  | { eq: [DynamicValue, DynamicValue] }
+  | { gt: [DynamicValue, DynamicValue] }
+  | { gte: [DynamicValue, DynamicValue] }
+  | { lt: [DynamicValue, DynamicValue] }
+  | { lte: [DynamicValue, DynamicValue] };
 ```
 
 ## Types
@@ -645,35 +388,32 @@ type VisibilityCondition =
 
 ```typescript
 interface UIElement {
+  key: string;
   type: string;
   props: Record<string, unknown>;
   children?: string[];          // Keys of child elements
   visible?: VisibilityCondition;
-  on?: Record<string, ActionBinding | ActionBinding[]>;  // Event bindings
-  repeat?: { statePath: string; key?: string };           // Repeat for arrays
+  validation?: ValidationSchema;
 }
 ```
 
-Elements are stored in the `elements` map keyed by string IDs. The key comes from the map, not from the element itself.
-
 ### Spec (Element Tree)
 
 ```typescript
 interface Spec {
-  root: string | null;                        // Key of root element
-  elements: Record<string, UIElement>;        // Flat element map
-  state?: Record<string, unknown>;            // Initial state model
+  root: string | null;         // Key of root element
+  elements: Record<string, UIElement>;
 }
 ```
 
 Elements are stored as a flat map with string keys. The tree structure is built by following the `children` arrays.
 
-### ActionBinding
+### Action
 
 ```typescript
-interface ActionBinding {
-  action: string;
-  params?: Record<string, DynamicValue>;
+interface Action {
+  name: string;
+  params?: Record<string, unknown>;
   confirm?: {
     title: string;
     message: string;
@@ -681,7 +421,6 @@ interface ActionBinding {
   };
   onSuccess?: { set: Record<string, unknown> };
   onError?: { set: Record<string, unknown> };
-  preventDefault?: boolean;  // Prevent default browser behavior (e.g. navigation on links)
 }
 ```
 
@@ -694,7 +433,7 @@ interface ValidationSchema {
 }
 
 interface ValidationCheck {
-  type: string;
+  fn: string;
   args?: Record<string, unknown>;
   message: string;
 }

apps/web/app/(main)/docs/api/image/page.mdx

@@ -1,364 +0,0 @@
-import { pageMetadata } from "@/lib/page-metadata"
-export const metadata = pageMetadata("docs/api/image")
-
-# @json-render/image
-
-Image renderer. Turn JSON specs into SVG and PNG images using [Satori](https://github.com/vercel/satori).
-
-## Install
-
-```bash
-npm install @json-render/core @json-render/image
-```
-
-For PNG output, also install the optional peer dependency:
-
-```bash
-npm install @resvg/resvg-js
-```
-
-See the [Image example](https://github.com/vercel-labs/json-render/tree/main/examples/image) for a full working example.
-
-## schema
-
-The image element schema for image specs. Use with `defineCatalog` from core.
-
-```typescript
-import { defineCatalog } from '@json-render/core';
-import { schema, standardComponentDefinitions } from '@json-render/image';
-
-const catalog = defineCatalog(schema, {
-  components: standardComponentDefinitions,
-});
-```
-
-## Render Functions
-
-Server-side functions for producing image output. Both accept a spec and optional `RenderOptions`.
-
-```typescript
-import { renderToSvg, renderToPng } from '@json-render/image/render';
-
-const svg = await renderToSvg(spec, { fonts });
-
-const png = await renderToPng(spec, { fonts });
-await writeFile('output.png', png);
-```
-
-### RenderOptions
-
-```typescript
-interface RenderOptions {
-  registry?: ComponentRegistry;
-  includeStandard?: boolean;  // default: true
-  state?: Record<string, unknown>;
-  fonts?: SatoriOptions['fonts'];
-  width?: number;
-  height?: number;
-}
-```
-
-<table>
-  <thead>
-    <tr>
-      <th>Option</th>
-      <th>Type</th>
-      <th>Default</th>
-      <th>Description</th>
-    </tr>
-  </thead>
-  <tbody>
-    <tr>
-      <td><code>fonts</code></td>
-      <td><code>{"SatoriOptions['fonts']"}</code></td>
-      <td><code>[]</code></td>
-      <td>Font data for text rendering (required for meaningful output)</td>
-    </tr>
-    <tr>
-      <td><code>width</code></td>
-      <td><code>number</code></td>
-      <td>Frame prop</td>
-      <td>Override the output image width</td>
-    </tr>
-    <tr>
-      <td><code>height</code></td>
-      <td><code>number</code></td>
-      <td>Frame prop</td>
-      <td>Override the output image height</td>
-    </tr>
-    <tr>
-      <td><code>registry</code></td>
-      <td><code>{"Record<string, ComponentRenderer>"}</code></td>
-      <td><code>{"{}"}</code></td>
-      <td>Custom component map (merged with standard components)</td>
-    </tr>
-    <tr>
-      <td><code>includeStandard</code></td>
-      <td><code>boolean</code></td>
-      <td><code>true</code></td>
-      <td>Include built-in standard components</td>
-    </tr>
-    <tr>
-      <td><code>state</code></td>
-      <td><code>{"Record<string, unknown>"}</code></td>
-      <td><code>{"{}"}</code></td>
-      <td>Initial state for <code>$state</code> / <code>$cond</code> dynamic prop resolution</td>
-    </tr>
-  </tbody>
-</table>
-
-## Standard Components
-
-### Root
-
-#### Frame
-
-Root image container. Defines the output image dimensions and background. Must be the root element.
-
-```typescript
-{
-  width: number;
-  height: number;
-  backgroundColor: string | null;
-  padding: number | null;
-  display: "flex" | "none" | null;
-  flexDirection: "row" | "column" | null;
-  alignItems: "flex-start" | "center" | "flex-end" | "stretch" | null;
-  justifyContent: "flex-start" | "center" | "flex-end" | "space-between" | "space-around" | null;
-}
-```
-
-### Layout
-
-#### Box
-
-Generic container with padding, margin, background, border, and flex alignment. Supports absolute positioning.
-
-```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;
-  width: number | string | null;
-  height: number | string | null;
-  alignItems: "flex-start" | "center" | "flex-end" | "stretch" | null;
-  justifyContent: "flex-start" | "center" | "flex-end" | "space-between" | "space-around" | null;
-  flexDirection: "row" | "column" | null;
-  position: "relative" | "absolute" | null;
-  top: number | null;
-  left: number | null;
-  right: number | null;
-  bottom: number | null;
-  overflow: "visible" | "hidden" | 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
-
-Heading text at various levels. h1 is largest, h4 is smallest.
-
-```typescript
-{
-  text: string;
-  level: "h1" | "h2" | "h3" | "h4" | null;
-  color: string | null;
-  align: "left" | "center" | "right" | null;
-  letterSpacing: number | string | null;
-  lineHeight: number | null;
-}
-```
-
-#### Text
-
-Body text with configurable size, color, weight, and alignment.
-
-```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;
-  letterSpacing: number | string | null;
-  textDecoration: "none" | "underline" | "line-through" | null;
-}
-```
-
-#### Image
-
-Image from a URL with optional dimensions and fit.
-
-```typescript
-{
-  src: string;
-  width: number | null;
-  height: number | null;
-  borderRadius: number | null;
-  objectFit: "contain" | "cover" | "fill" | "none" | 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;
-}
-```
-
-## Catalog Definitions
-
-Pre-built definitions for creating image catalogs:
-
-```typescript
-import { standardComponentDefinitions } from '@json-render/image/catalog';
-import { defineCatalog } from '@json-render/core';
-import { schema } from '@json-render/image';
-
-const catalog = defineCatalog(schema, {
-  components: {
-    ...standardComponentDefinitions,
-    // Add custom components
-  },
-});
-```
-
-## Server-Safe Import
-
-Import schema and catalog definitions without pulling in React or Satori:
-
-```typescript
-import { schema, standardComponentDefinitions } from '@json-render/image/server';
-```
-
-## Sub-path Exports
-
-<table>
-  <thead>
-    <tr>
-      <th>Export</th>
-      <th>Description</th>
-    </tr>
-  </thead>
-  <tbody>
-    <tr>
-      <td><code>@json-render/image</code></td>
-      <td>Full package: schema, renderer, components, render functions</td>
-    </tr>
-    <tr>
-      <td><code>@json-render/image/server</code></td>
-      <td>Schema and catalog definitions only (no React or Satori)</td>
-    </tr>
-    <tr>
-      <td><code>@json-render/image/catalog</code></td>
-      <td>Standard component definitions and types</td>
-    </tr>
-    <tr>
-      <td><code>@json-render/image/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>ImageSchema</code></td>
-      <td>Schema type for image specs</td>
-    </tr>
-    <tr>
-      <td><code>ImageSpec</code></td>
-      <td>Spec type for image output</td>
-    </tr>
-    <tr>
-      <td><code>RenderOptions</code></td>
-      <td>Options for render functions</td>
-    </tr>
-    <tr>
-      <td><code>ComponentRenderProps</code></td>
-      <td>Props passed to component render functions</td>
-    </tr>
-    <tr>
-      <td><code>ComponentRenderer</code></td>
-      <td>Component render function type</td>
-    </tr>
-    <tr>
-      <td><code>ComponentRegistry</code></td>
-      <td>Map of component names to render functions</td>
-    </tr>
-    <tr>
-      <td><code>StandardComponentDefinitions</code></td>
-      <td>Type of the standard component definitions object</td>
-    </tr>
-    <tr>
-      <td><code>StandardComponentProps{'<K>'}</code></td>
-      <td>Inferred props type for a standard component by name</td>
-    </tr>
-  </tbody>
-</table>

apps/web/app/(main)/docs/api/jotai/page.mdx

@@ -1,104 +0,0 @@
-import { pageMetadata } from "@/lib/page-metadata"
-export const metadata = pageMetadata("docs/api/jotai")
-
-# @json-render/jotai
-
-Jotai adapter for json-render's `StateStore` interface.
-
-## Installation
-
-```bash
-npm install @json-render/jotai @json-render/core @json-render/react jotai
-```
-
-## jotaiStateStore
-
-Create a `StateStore` backed by a Jotai atom.
-
-```typescript
-import { jotaiStateStore } from "@json-render/jotai";
-```
-
-### Options
-
-<table>
-  <thead>
-    <tr>
-      <th>Option</th>
-      <th>Type</th>
-      <th>Required</th>
-      <th>Description</th>
-    </tr>
-  </thead>
-  <tbody>
-    <tr>
-      <td><code>atom</code></td>
-      <td><code>{'WritableAtom<StateModel, [StateModel], void>'}</code></td>
-      <td>Yes</td>
-      <td>A writable atom holding the state model.</td>
-    </tr>
-    <tr>
-      <td><code>store</code></td>
-      <td>Jotai <code>Store</code></td>
-      <td>No</td>
-      <td>The Jotai store instance. Defaults to a new store created internally. Pass your own to share state with <code>{'<Provider>'}</code>.</td>
-    </tr>
-  </tbody>
-</table>
-
-### Example
-
-```typescript
-import { atom } from "jotai";
-import { jotaiStateStore } from "@json-render/jotai";
-import { StateProvider } from "@json-render/react";
-
-const uiAtom = atom<Record<string, unknown>>({ count: 0 });
-const store = jotaiStateStore({ atom: uiAtom });
-```
-
-```tsx
-<StateProvider store={store}>
-  {/* json-render reads/writes go through Jotai */}
-</StateProvider>
-```
-
-### Shared Jotai Store
-
-If your app already uses a Jotai `<Provider>` with a custom store, pass it so both json-render and your components share the same state:
-
-```typescript
-import { atom, createStore } from "jotai";
-import { Provider as JotaiProvider } from "jotai/react";
-import { jotaiStateStore } from "@json-render/jotai";
-import { StateProvider } from "@json-render/react";
-
-const jStore = createStore();
-const uiAtom = atom<Record<string, unknown>>({ count: 0 });
-const store = jotaiStateStore({ atom: uiAtom, store: jStore });
-```
-
-```tsx
-<JotaiProvider store={jStore}>
-  <StateProvider store={store}>
-    {/* Both json-render and useAtom() see the same state */}
-  </StateProvider>
-</JotaiProvider>
-```
-
-## Re-exports
-
-<table>
-  <thead>
-    <tr>
-      <th>Export</th>
-      <th>Source</th>
-    </tr>
-  </thead>
-  <tbody>
-    <tr>
-      <td><code>StateStore</code></td>
-      <td><code>@json-render/core</code></td>
-    </tr>
-  </tbody>
-</table>

apps/web/app/(main)/docs/api/mcp/page.mdx

@@ -1,247 +0,0 @@
-import { pageMetadata } from "@/lib/page-metadata"
-export const metadata = pageMetadata("docs/api/mcp")
-
-# @json-render/mcp
-
-MCP Apps integration for json-render. Serve json-render UIs as interactive [MCP Apps](https://modelcontextprotocol.io/docs/extensions/apps) inside Claude, ChatGPT, Cursor, VS Code, and other MCP-capable clients.
-
-## Install
-
-```bash
-npm install @json-render/mcp @json-render/core @modelcontextprotocol/sdk
-```
-
-For the iframe-side React UI, also install:
-
-```bash
-npm install @json-render/react react react-dom
-```
-
-See the [MCP example](https://github.com/vercel-labs/json-render/tree/main/examples/mcp) for a full working example.
-
-## Overview
-
-MCP Apps let MCP servers return interactive HTML UIs that render directly inside chat conversations. `@json-render/mcp` bridges json-render catalogs with the MCP Apps protocol:
-
-1. Your **catalog** defines which components and actions the AI can use
-2. The **MCP server** exposes the catalog as a tool with the spec schema
-3. The **bundled HTML** renders json-render specs inside the host's sandboxed iframe
-4. The AI generates a spec, the host renders it, and users interact with the live UI
-
-## Server API
-
-### createMcpApp
-
-Create a fully-configured MCP server. This is the main entry point.
-
-```typescript
-import { createMcpApp } from "@json-render/mcp";
-import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
-import fs from "node:fs";
-
-const server = createMcpApp({
-  name: "My Dashboard",
-  version: "1.0.0",
-  catalog: myCatalog,
-  html: fs.readFileSync("dist/index.html", "utf-8"),
-});
-
-await server.connect(new StdioServerTransport());
-```
-
-#### CreateMcpAppOptions
-
-<table>
-  <thead>
-    <tr>
-      <th>Option</th>
-      <th>Type</th>
-      <th>Description</th>
-    </tr>
-  </thead>
-  <tbody>
-    <tr>
-      <td><code>name</code></td>
-      <td><code>string</code></td>
-      <td>Server name shown in client UIs</td>
-    </tr>
-    <tr>
-      <td><code>version</code></td>
-      <td><code>string</code></td>
-      <td>Server version</td>
-    </tr>
-    <tr>
-      <td><code>catalog</code></td>
-      <td><code>Catalog</code></td>
-      <td>json-render catalog defining available components</td>
-    </tr>
-    <tr>
-      <td><code>html</code></td>
-      <td><code>string</code></td>
-      <td>Self-contained HTML for the iframe UI</td>
-    </tr>
-    <tr>
-      <td><code>tool</code></td>
-      <td><code>McpToolOptions</code></td>
-      <td>Optional tool name/title/description overrides</td>
-    </tr>
-  </tbody>
-</table>
-
-### registerJsonRenderTool
-
-Register a json-render tool on an existing `McpServer`. Use this when you need to add json-render to a server that has other tools.
-
-```typescript
-import { registerJsonRenderTool } from "@json-render/mcp";
-
-registerJsonRenderTool(server, {
-  catalog,
-  name: "render-ui",
-  title: "Render UI",
-  description: "Render an interactive UI",
-  resourceUri: "ui://render-ui/view.html",
-});
-```
-
-### registerJsonRenderResource
-
-Register the UI resource that serves the bundled HTML.
-
-```typescript
-import { registerJsonRenderResource } from "@json-render/mcp";
-
-registerJsonRenderResource(server, {
-  resourceUri: "ui://render-ui/view.html",
-  html: bundledHtml,
-});
-```
-
-## Client API (`@json-render/mcp/app`)
-
-These exports run inside the sandboxed iframe rendered by the MCP host.
-
-### useJsonRenderApp
-
-React hook that connects to the MCP host, listens for tool results, and maintains the current json-render spec.
-
-```tsx
-import { useJsonRenderApp } from "@json-render/mcp/app";
-import { JSONUIProvider, Renderer } from "@json-render/react";
-
-function McpAppView({ registry }) {
-  const { spec, loading, connected, error } = useJsonRenderApp({
-    name: "my-app",
-    version: "1.0.0",
-  });
-
-  if (error) return <div>Error: {error.message}</div>;
-  if (!spec) return <div>Waiting...</div>;
-
-  return (
-    <JSONUIProvider registry={registry} initialState={spec.state ?? {}}>
-      <Renderer spec={spec} registry={registry} loading={loading} />
-    </JSONUIProvider>
-  );
-}
-```
-
-#### UseJsonRenderAppReturn
-
-<table>
-  <thead>
-    <tr>
-      <th>Field</th>
-      <th>Type</th>
-      <th>Description</th>
-    </tr>
-  </thead>
-  <tbody>
-    <tr>
-      <td><code>spec</code></td>
-      <td><code>{'Spec | null'}</code></td>
-      <td>Current json-render spec</td>
-    </tr>
-    <tr>
-      <td><code>loading</code></td>
-      <td><code>boolean</code></td>
-      <td>Whether the spec is still being received</td>
-    </tr>
-    <tr>
-      <td><code>connected</code></td>
-      <td><code>boolean</code></td>
-      <td>Whether connected to the host</td>
-    </tr>
-    <tr>
-      <td><code>connecting</code></td>
-      <td><code>boolean</code></td>
-      <td>Whether currently connecting</td>
-    </tr>
-    <tr>
-      <td><code>error</code></td>
-      <td><code>{'Error | null'}</code></td>
-      <td>Connection error, if any</td>
-    </tr>
-    <tr>
-      <td><code>app</code></td>
-      <td><code>{'App | null'}</code></td>
-      <td>The underlying MCP App instance</td>
-    </tr>
-    <tr>
-      <td><code>callServerTool</code></td>
-      <td><code>{'(name, args?) => Promise<void>'}</code></td>
-      <td>Call an MCP server tool and update spec from result</td>
-    </tr>
-  </tbody>
-</table>
-
-### buildAppHtml
-
-Generate a self-contained HTML page from bundled JavaScript and CSS.
-
-```typescript
-import { buildAppHtml } from "@json-render/mcp/app";
-import fs from "node:fs";
-
-const html = buildAppHtml({
-  title: "Dashboard",
-  js: fs.readFileSync("dist/app.js", "utf-8"),
-  css: fs.readFileSync("dist/app.css", "utf-8"),
-});
-```
-
-## Client Configuration
-
-### Cursor
-
-Add to `.cursor/mcp.json`:
-
-```json
-{
-  "mcpServers": {
-    "json-render": {
-      "command": "npx",
-      "args": ["tsx", "path/to/server.ts", "--stdio"]
-    }
-  }
-}
-```
-
-### Claude Desktop
-
-Add to `~/Library/Application Support/Claude/claude_desktop_config.json`:
-
-```json
-{
-  "mcpServers": {
-    "json-render": {
-      "command": "npx",
-      "args": ["tsx", "/absolute/path/to/server.ts", "--stdio"]
-    }
-  }
-}
-```
-
-## Supported Clients
-
-MCP Apps are supported by Claude (web and desktop), ChatGPT, VS Code (GitHub Copilot), Cursor, Goose, and Postman.

apps/web/app/(main)/docs/api/react-email/page.mdx

@@ -1,310 +0,0 @@
-import { pageMetadata } from "@/lib/page-metadata"
-export const metadata = pageMetadata("docs/api/react-email")
-
-# @json-render/react-email
-
-React Email renderer. Turn JSON specs into HTML or plain-text emails using `@react-email/components` and `@react-email/render`.
-
-## Install
-
-```bash
-npm install @json-render/core @json-render/react-email @react-email/components @react-email/render
-```
-
-See the [React Email example](https://github.com/vercel-labs/json-render/tree/main/examples/react-email) for a full working example.
-
-## schema
-
-The email element schema for specs. Use with `defineCatalog` from core.
-
-```typescript
-import { defineCatalog } from '@json-render/core';
-import { schema, standardComponentDefinitions } from '@json-render/react-email';
-
-const catalog = defineCatalog(schema, {
-  components: standardComponentDefinitions,
-});
-```
-
-## Render Functions
-
-Server-side functions for producing email output. All accept a spec and optional `RenderOptions`.
-
-```typescript
-import { renderToHtml, renderToPlainText } from '@json-render/react-email';
-
-const html = await renderToHtml(spec);
-
-const plainText = await renderToPlainText(spec);
-```
-
-### 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-email';
-import { Container, Heading, Text } from '@react-email/components';
-
-const { registry } = defineRegistry(catalog, {
-  components: {
-    Card: ({ props, children }) => (
-      <Container style={{ padding: 16, backgroundColor: '#fff' }}>
-        <Heading>{props.title}</Heading>
-        {children}
-      </Container>
-    ),
-  },
-});
-
-const html = await renderToHtml(spec, { registry });
-```
-
-## createRenderer
-
-Create a standalone renderer component wired to state, actions, and validation (for interactive previews in the browser).
-
-```typescript
-import { createRenderer } from '@json-render/react-email';
-
-const EmailRenderer = createRenderer(catalog, components);
-```
-
-## Renderer
-
-The main component that renders a spec to React Email elements. Use inside `JSONUIProvider` when you need state, actions, or visibility.
-
-```typescript
-interface RendererProps {
-  spec: Spec | null;
-  registry?: ComponentRegistry;
-  includeStandard?: boolean;  // default: true
-  loading?: boolean;
-  fallback?: ComponentRenderer;
-}
-```
-
-## Standard Components
-
-### Document structure
-
-<table>
-  <thead>
-    <tr>
-      <th>Component</th>
-      <th>Description</th>
-    </tr>
-  </thead>
-  <tbody>
-    <tr>
-      <td><code>Html</code></td>
-      <td>Top-level email wrapper. Must be the root element.</td>
-    </tr>
-    <tr>
-      <td><code>Head</code></td>
-      <td>Email head section. Place inside Html.</td>
-    </tr>
-    <tr>
-      <td><code>Body</code></td>
-      <td>Email body wrapper. Place inside Html.</td>
-    </tr>
-  </tbody>
-</table>
-
-### Layout
-
-<table>
-  <thead>
-    <tr>
-      <th>Component</th>
-      <th>Description</th>
-    </tr>
-  </thead>
-  <tbody>
-    <tr>
-      <td><code>Container</code></td>
-      <td>Constrains content width (e.g. max-width 600px).</td>
-    </tr>
-    <tr>
-      <td><code>Section</code></td>
-      <td>Groups related content.</td>
-    </tr>
-    <tr>
-      <td><code>Row</code></td>
-      <td>Horizontal layout row.</td>
-    </tr>
-    <tr>
-      <td><code>Column</code></td>
-      <td>Column within a Row.</td>
-    </tr>
-  </tbody>
-</table>
-
-### Content
-
-<table>
-  <thead>
-    <tr>
-      <th>Component</th>
-      <th>Description</th>
-    </tr>
-  </thead>
-  <tbody>
-    <tr>
-      <td><code>Heading</code></td>
-      <td>Heading text (h1-h6).</td>
-    </tr>
-    <tr>
-      <td><code>Text</code></td>
-      <td>Body text paragraph.</td>
-    </tr>
-    <tr>
-      <td><code>Link</code></td>
-      <td>Hyperlink with text and href.</td>
-    </tr>
-    <tr>
-      <td><code>Button</code></td>
-      <td>Call-to-action button (link styled as button).</td>
-    </tr>
-    <tr>
-      <td><code>Image</code></td>
-      <td>Image from URL.</td>
-    </tr>
-    <tr>
-      <td><code>Hr</code></td>
-      <td>Horizontal rule separator.</td>
-    </tr>
-  </tbody>
-</table>
-
-### Utility
-
-<table>
-  <thead>
-    <tr>
-      <th>Component</th>
-      <th>Description</th>
-    </tr>
-  </thead>
-  <tbody>
-    <tr>
-      <td><code>Preview</code></td>
-      <td>Preview text for inbox (inside Html).</td>
-    </tr>
-    <tr>
-      <td><code>Markdown</code></td>
-      <td>Renders markdown content as email-safe HTML.</td>
-    </tr>
-  </tbody>
-</table>
-
-## Server-Safe Import
-
-Import schema and catalog definitions without pulling in React or `@react-email/components`:
-
-```typescript
-import { schema, standardComponentDefinitions } from '@json-render/react-email/server';
-```
-
-## Sub-path Exports
-
-<table>
-  <thead>
-    <tr>
-      <th>Export</th>
-      <th>Description</th>
-    </tr>
-  </thead>
-  <tbody>
-    <tr>
-      <td><code>@json-render/react-email</code></td>
-      <td>Full package: schema, renderer, components, render functions</td>
-    </tr>
-    <tr>
-      <td><code>@json-render/react-email/server</code></td>
-      <td>Schema and catalog definitions only (no React)</td>
-    </tr>
-    <tr>
-      <td><code>@json-render/react-email/catalog</code></td>
-      <td>Standard component definitions and types</td>
-    </tr>
-    <tr>
-      <td><code>@json-render/react-email/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>ReactEmailSchema</code></td>
-      <td>Schema type for email specs</td>
-    </tr>
-    <tr>
-      <td><code>ReactEmailSpec</code></td>
-      <td>Spec type for email 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>

apps/web/app/(main)/docs/api/react-native/page.mdx

@@ -1,5 +1,4 @@
-import { pageMetadata } from "@/lib/page-metadata"
-export const metadata = pageMetadata("docs/api/react-native")
+export const metadata = { title: "@json-render/react-native API" }
 
 # @json-render/react-native
 
@@ -9,120 +8,65 @@ React Native renderer with standard components, providers, and hooks.
 
 ### Layout
 
-<table>
-<thead>
-<tr><th>Component</th><th>Props</th><th>Description</th></tr>
-</thead>
-<tbody>
-<tr><td><code>Container</code></td><td><code>padding</code>, <code>background</code>, <code>borderRadius</code>, <code>borderColor</code>, <code>flex</code></td><td>Basic wrapper with styling</td></tr>
-<tr><td><code>Row</code></td><td><code>gap</code>, <code>align</code>, <code>justify</code>, <code>flex</code>, <code>wrap</code></td><td>Horizontal flex layout</td></tr>
-<tr><td><code>Column</code></td><td><code>gap</code>, <code>align</code>, <code>justify</code>, <code>flex</code></td><td>Vertical flex layout</td></tr>
-<tr><td><code>ScrollContainer</code></td><td><code>direction</code></td><td>Scrollable area (vertical or horizontal)</td></tr>
-<tr><td><code>SafeArea</code></td><td><code>edges</code></td><td>Safe area insets for notch/home indicator</td></tr>
-<tr><td><code>Pressable</code></td><td><code>action</code>, <code>actionParams</code></td><td>Touchable wrapper that triggers actions</td></tr>
-<tr><td><code>Spacer</code></td><td><code>size</code>, <code>flex</code></td><td>Fixed or flexible spacing</td></tr>
-<tr><td><code>Divider</code></td><td><code>color</code>, <code>thickness</code></td><td>Thin line separator</td></tr>
-</tbody>
-</table>
+| Component | Props | Description |
+|-----------|-------|-------------|
+| `Container` | `padding`, `background`, `borderRadius`, `borderColor`, `flex` | Basic wrapper with styling |
+| `Row` | `gap`, `align`, `justify`, `flex`, `wrap` | Horizontal flex layout |
+| `Column` | `gap`, `align`, `justify`, `flex` | Vertical flex layout |
+| `ScrollContainer` | `direction` | Scrollable area (vertical or horizontal) |
+| `SafeArea` | `edges` | Safe area insets for notch/home indicator |
+| `Pressable` | `action`, `actionParams` | Touchable wrapper that triggers actions |
+| `Spacer` | `size`, `flex` | Fixed or flexible spacing |
+| `Divider` | `color`, `thickness` | Thin line separator |
 
 ### Content
 
-<table>
-<thead>
-<tr><th>Component</th><th>Props</th><th>Description</th></tr>
-</thead>
-<tbody>
-<tr><td><code>Heading</code></td><td><code>text</code>, <code>level</code>, <code>align</code>, <code>color</code></td><td>Heading text (levels 1-6)</td></tr>
-<tr><td><code>Paragraph</code></td><td><code>text</code>, <code>align</code>, <code>color</code></td><td>Body text</td></tr>
-<tr><td><code>Label</code></td><td><code>text</code>, <code>color</code>, <code>bold</code></td><td>Small label text</td></tr>
-<tr><td><code>Image</code></td><td><code>uri</code>, <code>width</code>, <code>height</code>, <code>resizeMode</code>, <code>borderRadius</code></td><td>Image display</td></tr>
-<tr><td><code>Avatar</code></td><td><code>uri</code>, <code>size</code>, <code>fallback</code></td><td>Circular avatar</td></tr>
-<tr><td><code>Badge</code></td><td><code>label</code>, <code>color</code>, <code>textColor</code></td><td>Status badge</td></tr>
-<tr><td><code>Chip</code></td><td><code>label</code>, <code>selected</code>, <code>color</code></td><td>Tag/chip</td></tr>
-</tbody>
-</table>
+| Component | Props | Description |
+|-----------|-------|-------------|
+| `Heading` | `text`, `level`, `align`, `color` | Heading text (levels 1-6) |
+| `Paragraph` | `text`, `align`, `color` | Body text |
+| `Label` | `text`, `color`, `bold` | Small label text |
+| `Image` | `uri`, `width`, `height`, `resizeMode`, `borderRadius` | Image display |
+| `Avatar` | `uri`, `size`, `fallback` | Circular avatar |
+| `Badge` | `label`, `color`, `textColor` | Status badge |
+| `Chip` | `label`, `selected`, `color` | Tag/chip |
 
 ### Input
 
-<table>
-<thead>
-<tr><th>Component</th><th>Props</th><th>Description</th></tr>
-</thead>
-<tbody>
-<tr><td><code>Button</code></td><td><code>label</code>, <code>variant</code>, <code>size</code>, <code>disabled</code>, <code>action</code>, <code>actionParams</code></td><td>Pressable button</td></tr>
-<tr><td><code>TextInput</code></td><td><code>placeholder</code>, <code>value</code> (use <code>$bindState</code>), <code>secure</code>, <code>keyboardType</code>, <code>multiline</code></td><td>Text input field</td></tr>
-<tr><td><code>Switch</code></td><td><code>checked</code> (use <code>$bindState</code>), <code>label</code></td><td>Toggle switch</td></tr>
-<tr><td><code>Checkbox</code></td><td><code>checked</code> (use <code>$bindState</code>), <code>label</code></td><td>Checkbox with label</td></tr>
-<tr><td><code>Slider</code></td><td><code>value</code> (use <code>$bindState</code>), <code>min</code>, <code>max</code>, <code>step</code></td><td>Range slider</td></tr>
-<tr><td><code>SearchBar</code></td><td><code>placeholder</code>, <code>value</code> (use <code>$bindState</code>)</td><td>Search input</td></tr>
-</tbody>
-</table>
+| Component | Props | Description |
+|-----------|-------|-------------|
+| `Button` | `label`, `variant`, `size`, `disabled`, `action`, `actionParams` | Pressable button |
+| `TextInput` | `placeholder`, `statePath`, `secure`, `keyboardType`, `multiline` | Text input field |
+| `Switch` | `statePath`, `label` | Toggle switch |
+| `Checkbox` | `statePath`, `label` | Checkbox with label |
+| `Slider` | `statePath`, `min`, `max`, `step` | Range slider |
+| `SearchBar` | `placeholder`, `statePath` | Search input |
 
 ### Feedback
 
-<table>
-<thead>
-<tr><th>Component</th><th>Props</th><th>Description</th></tr>
-</thead>
-<tbody>
-<tr><td><code>Spinner</code></td><td><code>size</code>, <code>color</code></td><td>Loading indicator</td></tr>
-<tr><td><code>ProgressBar</code></td><td><code>progress</code>, <code>color</code>, <code>trackColor</code></td><td>Progress indicator</td></tr>
-</tbody>
-</table>
+| Component | Props | Description |
+|-----------|-------|-------------|
+| `Spinner` | `size`, `color` | Loading indicator |
+| `ProgressBar` | `progress`, `color`, `trackColor` | Progress indicator |
 
 ### Composite
 
-<table>
-<thead>
-<tr><th>Component</th><th>Props</th><th>Description</th></tr>
-</thead>
-<tbody>
-<tr><td><code>Card</code></td><td><code>title</code>, <code>subtitle</code>, <code>padding</code></td><td>Card container</td></tr>
-<tr><td><code>ListItem</code></td><td><code>title</code>, <code>subtitle</code>, <code>leading</code>, <code>trailing</code>, <code>action</code>, <code>actionParams</code></td><td>List row</td></tr>
-<tr><td><code>Modal</code></td><td><code>visible</code>, <code>title</code></td><td>Bottom sheet modal</td></tr>
-</tbody>
-</table>
+| Component | Props | Description |
+|-----------|-------|-------------|
+| `Card` | `title`, `subtitle`, `padding` | Card container |
+| `ListItem` | `title`, `subtitle`, `leading`, `trailing`, `action`, `actionParams` | List row |
+| `Modal` | `visible`, `title` | Bottom sheet modal |
 
 ## Providers
 
 ### StateProvider
 
 ```tsx
-<StateProvider initialState={object} onStateChange={fn}>
+<StateProvider initialState={object}>
   {children}
 </StateProvider>
 ```
 
-<table>
-<thead>
-<tr><th>Prop</th><th>Type</th><th>Description</th></tr>
-</thead>
-<tbody>
-<tr><td><code>store</code></td><td><code>StateStore</code></td><td>External store (controlled mode). When provided, <code>initialState</code> and <code>onStateChange</code> are ignored.</td></tr>
-<tr><td><code>initialState</code></td><td><code>Record&lt;string, unknown&gt;</code></td><td>Initial state model (uncontrolled mode).</td></tr>
-<tr><td><code>onStateChange</code></td><td><code>{'(changes: Array<{ path: string; value: unknown }>) => void'}</code></td><td>Callback when state changes (uncontrolled mode). Called once per <code>set</code> or <code>update</code> with all changed entries.</td></tr>
-</tbody>
-</table>
-
-#### 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
@@ -139,8 +83,6 @@ The `store` prop is also available on `JSONUIProvider` and `createRenderer`.
 </VisibilityProvider>
 ```
 
-Conditions in specs use the `VisibilityCondition` format with `$state` paths (e.g. `{ "$state": "/path" }`, `{ "$state": "/path", "eq": value }`). See [visibility](/docs/visibility) for the full syntax.
-
 ### ValidationProvider
 
 ```tsx
@@ -193,9 +135,7 @@ const { state, get, set, update } = useStateStore();
 const value = useStateValue(path: string);
 ```
 
-### useStateBinding (deprecated)
-
-> **Deprecated.** Use `useBoundProp` with `$bindState` expressions instead.
+### useStateBinding
 
 ```typescript
 const [value, setValue] = useStateBinding(path: string);
@@ -220,13 +160,8 @@ import { standardComponentDefinitions, standardActionDefinitions } from "@json-r
 import { schema } from "@json-render/react-native/schema";
 ```
 
-<table>
-<thead>
-<tr><th>Export</th><th>Purpose</th></tr>
-</thead>
-<tbody>
-<tr><td><code>standardComponentDefinitions</code></td><td>Catalog definitions for all 25+ standard components</td></tr>
-<tr><td><code>standardActionDefinitions</code></td><td>Catalog definitions for standard actions (setState, navigate)</td></tr>
-<tr><td><code>schema</code></td><td>React Native element tree schema</td></tr>
-</tbody>
-</table>
+| Export | Purpose |
+|--------|---------|
+| `standardComponentDefinitions` | Catalog definitions for all 25+ standard components |
+| `standardActionDefinitions` | Catalog definitions for standard actions (setState, navigate) |
+| `schema` | React Native element tree schema |

apps/web/app/(main)/docs/api/react-pdf/page.mdx

@@ -1,439 +0,0 @@
-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>

apps/web/app/(main)/docs/api/react-three-fiber/page.mdx

@@ -1,416 +0,0 @@
-import { pageMetadata } from "@/lib/page-metadata"
-export const metadata = pageMetadata("docs/api/react-three-fiber")
-
-# @json-render/react-three-fiber
-
-React Three Fiber renderer for json-render. 19 built-in 3D components for meshes, lights, models, environments, text, cameras, and controls.
-
-## Installation
-
-```bash
-npm install @json-render/react-three-fiber @json-render/core @json-render/react @react-three/fiber @react-three/drei three zod
-```
-
-## Entry Points
-
-<table>
-<thead>
-<tr>
-<th>Entry Point</th>
-<th>Exports</th>
-<th>Use For</th>
-</tr>
-</thead>
-<tbody>
-<tr>
-<td><code>@json-render/react-three-fiber</code></td>
-<td><code>threeComponents</code>, <code>ThreeRenderer</code>, <code>ThreeCanvas</code>, schemas</td>
-<td>React Three Fiber implementations and renderer</td>
-</tr>
-<tr>
-<td><code>@json-render/react-three-fiber/catalog</code></td>
-<td><code>threeComponentDefinitions</code></td>
-<td>Catalog schemas (no R3F dependency, safe for server)</td>
-</tr>
-</tbody>
-</table>
-
-## Usage
-
-```tsx
-import {'{ defineCatalog }'} from "@json-render/core";
-import {'{ schema, defineRegistry }'} from "@json-render/react";
-import {'{'}
-  threeComponentDefinitions,
-  threeComponents,
-  ThreeCanvas,
-{'}'} from "@json-render/react-three-fiber";
-
-const catalog = defineCatalog(schema, {'{'}
-  components: {'{'}
-    Box: threeComponentDefinitions.Box,
-    Sphere: threeComponentDefinitions.Sphere,
-    AmbientLight: threeComponentDefinitions.AmbientLight,
-    DirectionalLight: threeComponentDefinitions.DirectionalLight,
-    OrbitControls: threeComponentDefinitions.OrbitControls,
-  {'}'},
-  actions: {'{}'},
-{'}'});
-
-const {'{ registry }'} = defineRegistry(catalog, {'{'}
-  components: {'{'}
-    Box: threeComponents.Box,
-    Sphere: threeComponents.Sphere,
-    AmbientLight: threeComponents.AmbientLight,
-    DirectionalLight: threeComponents.DirectionalLight,
-    OrbitControls: threeComponents.OrbitControls,
-  {'}'},
-{'}'});
-```
-
-### ThreeCanvas (convenience)
-
-```tsx
-<ThreeCanvas
-  spec={'{spec}'}
-  registry={'{registry}'}
-  shadows
-  camera={'{'}{'{ position: [5, 5, 5], fov: 50 }'}{'}'} 
-  style={'{'}{'{ width: "100%", height: "100vh" }'}{'}'} 
-/>
-```
-
-### Manual Canvas Setup
-
-```tsx
-import {'{ Canvas }'} from "@react-three/fiber";
-import {'{ ThreeRenderer }'} from "@json-render/react-three-fiber";
-
-<Canvas shadows>
-  <ThreeRenderer spec={'{spec}'} registry={'{registry}'} />
-</Canvas>
-```
-
-## Components
-
-### Primitives
-
-<table>
-<thead>
-<tr>
-<th>Component</th>
-<th>Description</th>
-<th>Key Props</th>
-</tr>
-</thead>
-<tbody>
-<tr>
-<td><code>Box</code></td>
-<td>Box mesh (default 1x1x1)</td>
-<td><code>width</code>, <code>height</code>, <code>depth</code>, <code>material</code></td>
-</tr>
-<tr>
-<td><code>Sphere</code></td>
-<td>Sphere mesh</td>
-<td><code>radius</code>, <code>widthSegments</code>, <code>heightSegments</code>, <code>material</code></td>
-</tr>
-<tr>
-<td><code>Cylinder</code></td>
-<td>Cylinder mesh</td>
-<td><code>radiusTop</code>, <code>radiusBottom</code>, <code>height</code>, <code>material</code></td>
-</tr>
-<tr>
-<td><code>Cone</code></td>
-<td>Cone mesh</td>
-<td><code>radius</code>, <code>height</code>, <code>material</code></td>
-</tr>
-<tr>
-<td><code>Torus</code></td>
-<td>Torus (donut) mesh</td>
-<td><code>radius</code>, <code>tube</code>, <code>material</code></td>
-</tr>
-<tr>
-<td><code>Plane</code></td>
-<td>Flat plane mesh</td>
-<td><code>width</code>, <code>height</code>, <code>material</code></td>
-</tr>
-<tr>
-<td><code>Capsule</code></td>
-<td>Capsule mesh</td>
-<td><code>radius</code>, <code>length</code>, <code>material</code></td>
-</tr>
-</tbody>
-</table>
-
-All primitives share: <code>position</code>, <code>rotation</code>, <code>scale</code>, <code>castShadow</code>, <code>receiveShadow</code>, <code>material</code>.
-
-### Material Schema
-
-<table>
-<thead>
-<tr>
-<th>Property</th>
-<th>Type</th>
-<th>Default</th>
-</tr>
-</thead>
-<tbody>
-<tr>
-<td><code>color</code></td>
-<td><code>string</code></td>
-<td><code>"#ffffff"</code></td>
-</tr>
-<tr>
-<td><code>metalness</code></td>
-<td><code>number</code></td>
-<td><code>0</code></td>
-</tr>
-<tr>
-<td><code>roughness</code></td>
-<td><code>number</code></td>
-<td><code>1</code></td>
-</tr>
-<tr>
-<td><code>emissive</code></td>
-<td><code>string</code></td>
-<td><code>"#000000"</code></td>
-</tr>
-<tr>
-<td><code>emissiveIntensity</code></td>
-<td><code>number</code></td>
-<td><code>1</code></td>
-</tr>
-<tr>
-<td><code>opacity</code></td>
-<td><code>number</code></td>
-<td><code>1</code></td>
-</tr>
-<tr>
-<td><code>transparent</code></td>
-<td><code>boolean</code></td>
-<td><code>false</code></td>
-</tr>
-<tr>
-<td><code>wireframe</code></td>
-<td><code>boolean</code></td>
-<td><code>false</code></td>
-</tr>
-</tbody>
-</table>
-
-### Lights
-
-<table>
-<thead>
-<tr>
-<th>Component</th>
-<th>Description</th>
-<th>Key Props</th>
-</tr>
-</thead>
-<tbody>
-<tr>
-<td><code>AmbientLight</code></td>
-<td>Uniform illumination</td>
-<td><code>color</code>, <code>intensity</code></td>
-</tr>
-<tr>
-<td><code>DirectionalLight</code></td>
-<td>Sunlight-style</td>
-<td><code>position</code>, <code>color</code>, <code>intensity</code>, <code>castShadow</code></td>
-</tr>
-<tr>
-<td><code>PointLight</code></td>
-<td>Radiates from a point</td>
-<td><code>position</code>, <code>color</code>, <code>intensity</code>, <code>distance</code>, <code>decay</code></td>
-</tr>
-<tr>
-<td><code>SpotLight</code></td>
-<td>Cone of light</td>
-<td><code>position</code>, <code>color</code>, <code>intensity</code>, <code>angle</code>, <code>penumbra</code></td>
-</tr>
-</tbody>
-</table>
-
-### Other Components
-
-<table>
-<thead>
-<tr>
-<th>Component</th>
-<th>Description</th>
-<th>Key Props</th>
-</tr>
-</thead>
-<tbody>
-<tr>
-<td><code>Group</code></td>
-<td>Container for children</td>
-<td><code>position</code>, <code>rotation</code>, <code>scale</code></td>
-</tr>
-<tr>
-<td><code>Model</code></td>
-<td>GLTF/GLB model loader</td>
-<td><code>url</code>, <code>position</code>, <code>rotation</code>, <code>scale</code></td>
-</tr>
-<tr>
-<td><code>Environment</code></td>
-<td>HDRI environment map</td>
-<td><code>preset</code>, <code>background</code>, <code>blur</code>, <code>intensity</code></td>
-</tr>
-<tr>
-<td><code>Fog</code></td>
-<td>Linear fog effect</td>
-<td><code>color</code>, <code>near</code>, <code>far</code></td>
-</tr>
-<tr>
-<td><code>GridHelper</code></td>
-<td>Reference grid</td>
-<td><code>size</code>, <code>divisions</code>, <code>color</code></td>
-</tr>
-<tr>
-<td><code>Text3D</code></td>
-<td>3D text (SDF)</td>
-<td><code>text</code>, <code>fontSize</code>, <code>color</code>, <code>anchorX</code>, <code>anchorY</code></td>
-</tr>
-<tr>
-<td><code>PerspectiveCamera</code></td>
-<td>Camera</td>
-<td><code>position</code>, <code>fov</code>, <code>near</code>, <code>far</code>, <code>makeDefault</code></td>
-</tr>
-<tr>
-<td><code>OrbitControls</code></td>
-<td>Camera controls</td>
-<td><code>enableDamping</code>, <code>enableZoom</code>, <code>autoRotate</code></td>
-</tr>
-</tbody>
-</table>
-
-## Shared Schemas
-
-Reusable Zod schemas for custom 3D components:
-
-```tsx
-import {'{ vector3Schema, materialSchema, transformProps, shadowProps }'} from "@json-render/react-three-fiber";
-```
-
-<table>
-<thead>
-<tr>
-<th>Export</th>
-<th>Description</th>
-</tr>
-</thead>
-<tbody>
-<tr>
-<td><code>vector3Schema</code></td>
-<td><code>z.tuple([z.number(), z.number(), z.number()])</code></td>
-</tr>
-<tr>
-<td><code>materialSchema</code></td>
-<td>Standard material props (color, metalness, roughness, etc.)</td>
-</tr>
-<tr>
-<td><code>transformProps</code></td>
-<td><code>{'{ position, rotation, scale }'}</code> schema fields</td>
-</tr>
-<tr>
-<td><code>shadowProps</code></td>
-<td><code>{'{ castShadow, receiveShadow }'}</code> schema fields</td>
-</tr>
-</tbody>
-</table>
-
-## ThreeRenderer
-
-<table>
-<thead>
-<tr>
-<th>Prop</th>
-<th>Type</th>
-<th>Description</th>
-</tr>
-</thead>
-<tbody>
-<tr>
-<td><code>spec</code></td>
-<td><code>Spec | null</code></td>
-<td>The spec to render as a 3D scene</td>
-</tr>
-<tr>
-<td><code>registry</code></td>
-<td><code>ComponentRegistry</code></td>
-<td>Component registry from <code>defineRegistry</code></td>
-</tr>
-<tr>
-<td><code>store</code></td>
-<td><code>StateStore</code></td>
-<td>External state store (controlled mode)</td>
-</tr>
-<tr>
-<td><code>initialState</code></td>
-<td><code>Record&lt;string, unknown&gt;</code></td>
-<td>Initial state (uncontrolled mode)</td>
-</tr>
-<tr>
-<td><code>handlers</code></td>
-<td><code>Record&lt;string, Function&gt;</code></td>
-<td>Action handlers</td>
-</tr>
-<tr>
-<td><code>loading</code></td>
-<td><code>boolean</code></td>
-<td>Whether the spec is streaming</td>
-</tr>
-<tr>
-<td><code>children</code></td>
-<td><code>ReactNode</code></td>
-<td>Additional R3F elements alongside the spec</td>
-</tr>
-</tbody>
-</table>
-
-## ThreeCanvas
-
-Extends <code>ThreeRendererProps</code> with Canvas options:
-
-<table>
-<thead>
-<tr>
-<th>Prop</th>
-<th>Type</th>
-<th>Description</th>
-</tr>
-</thead>
-<tbody>
-<tr>
-<td><code>shadows</code></td>
-<td><code>boolean</code></td>
-<td>Enable shadow maps</td>
-</tr>
-<tr>
-<td><code>camera</code></td>
-<td><code>object</code></td>
-<td>Default camera config (position, fov, etc.)</td>
-</tr>
-<tr>
-<td><code>className</code></td>
-<td><code>string</code></td>
-<td>CSS class for the canvas container</td>
-</tr>
-<tr>
-<td><code>style</code></td>
-<td><code>CSSProperties</code></td>
-<td>Inline styles for the canvas container</td>
-</tr>
-</tbody>
-</table>
-
-## Type Helpers
-
-```tsx
-import type {'{ ThreeProps }'} from "@json-render/react-three-fiber";
-
-type BoxProps = ThreeProps<"Box">;
-type SphereProps = ThreeProps<"Sphere">;
-```

apps/web/app/(main)/docs/api/react/page.mdx

@@ -1,5 +1,4 @@
-import { pageMetadata } from "@/lib/page-metadata"
-export const metadata = pageMetadata("docs/api/react")
+export const metadata = { title: "@json-render/react API" }
 
 # @json-render/react
 
@@ -10,57 +9,11 @@ React components, providers, and hooks.
 ### StateProvider
 
 ```tsx
-<StateProvider initialState={object} onStateChange={fn}>
+<StateProvider initialState={object}>
   {children}
 </StateProvider>
 ```
 
-<table>
-  <thead>
-    <tr>
-      <th>Prop</th>
-      <th>Type</th>
-      <th>Description</th>
-    </tr>
-  </thead>
-  <tbody>
-    <tr>
-      <td><code>store</code></td>
-      <td><code>StateStore</code></td>
-      <td>External store (controlled mode). When provided, <code>initialState</code> and <code>onStateChange</code> are ignored.</td>
-    </tr>
-    <tr>
-      <td><code>initialState</code></td>
-      <td><code>Record&lt;string, unknown&gt;</code></td>
-      <td>Initial state model (uncontrolled mode).</td>
-    </tr>
-    <tr>
-      <td><code>onStateChange</code></td>
-      <td><code>{'(changes: Array<{ path: string; value: unknown }>) => void'}</code></td>
-      <td>Callback when state changes (uncontrolled mode). Called once per <code>set</code> or <code>update</code> with all changed entries.</td>
-    </tr>
-  </tbody>
-</table>
-
-#### 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
@@ -74,28 +27,29 @@ type ActionHandler = (params: Record<string, unknown>) => void | Promise<void>;
 ### VisibilityProvider
 
 ```tsx
-<VisibilityProvider>
+<VisibilityProvider auth={AuthState}>
   {children}
 </VisibilityProvider>
-```
 
-`VisibilityProvider` reads state from the parent `StateProvider` automatically. Conditions in specs use the `VisibilityCondition` format with `$state` paths (e.g. `{ "$state": "/path" }`, `{ "$state": "/path", "eq": value }`). See [visibility](/docs/visibility) for the full syntax.
+interface AuthState {
+  isSignedIn: boolean;
+  roles?: string[];
+}
+```
 
 ### ValidationProvider
 
 ```tsx
-<ValidationProvider customFunctions={Record<string, ValidationFunction>}>
+<ValidationProvider functions={Record<string, ValidatorFn>}>
   {children}
 </ValidationProvider>
 
-type ValidationFunction = (value: unknown, args?: object) => boolean | Promise<boolean>;
+type ValidatorFn = (value: unknown, args?: object) => boolean | Promise<boolean>;
 ```
 
 ## defineRegistry
 
-Create a type-safe component registry from a catalog. Components receive `props`, `children`, `emit`, `on`, and `loading` with catalog-inferred types.
-
-When the catalog declares actions, the `actions` field is required. When the catalog has no actions (e.g. `actions: {}`), the field is optional.
+Create a type-safe component registry from a catalog. Components receive `props`, `children`, `emit`, and `loading` with catalog-inferred types.
 
 ```tsx
 import { defineRegistry } from '@json-render/react';
@@ -104,7 +58,7 @@ const { registry } = defineRegistry(catalog, {
   components: {
     Card: ({ props, children }) => <div>{props.title}{children}</div>,
     Button: ({ props, emit }) => (
-      <button onClick={() => emit("press")}>
+      <button onClick={() => emit?.("press")}>
         {props.label}
       </button>
     ),
@@ -130,88 +84,15 @@ const { registry } = defineRegistry(catalog, {
 type Registry = Record<string, React.ComponentType<ComponentRenderProps>>;
 ```
 
-### JSONUIProvider
-
-Convenience wrapper that combines `StateProvider`, `VisibilityProvider`, `ValidationProvider`, and `ActionProvider`. Accepts all their props plus:
-
-<table>
-  <thead>
-    <tr>
-      <th>Prop</th>
-      <th>Type</th>
-      <th>Description</th>
-    </tr>
-  </thead>
-  <tbody>
-    <tr>
-      <td><code>functions</code></td>
-      <td><code>Record&lt;string, ComputedFunction&gt;</code></td>
-      <td>Named functions for <code>$computed</code> expressions in props</td>
-    </tr>
-  </tbody>
-</table>
-
-```tsx
-<JSONUIProvider
-  spec={spec}
-  catalog={catalog}
-  handlers={{ submit: async () => { /* ... */ } }}
-  functions={{ fullName: (args) => `${args.first} ${args.last}` }}
->
-  <Renderer spec={spec} registry={registry} />
-</JSONUIProvider>
-```
-
-The `functions` prop is also available on `createRenderer`.
-
 ### Component Props (via defineRegistry)
 
 ```tsx
 interface ComponentContext<P> {
-  props: P;                                // Typed props from catalog
-  children?: React.ReactNode;              // Rendered children (for slot components)
-  emit: (event: string) => void;           // Emit a named event (always defined)
-  on: (event: string) => EventHandle;      // Get event handle with metadata
+  props: P;                    // Typed props from catalog
+  children?: React.ReactNode;  // Rendered children (for slot components)
+  emit?: (event: string) => void;  // Emit a named event
   loading?: boolean;
-  bindings?: Record<string, string>;       // State paths from $bindState/$bindItem expressions
 }
-
-interface EventHandle {
-  emit: () => void;              // Fire the event
-  shouldPreventDefault: boolean; // Whether any binding requested preventDefault
-  bound: boolean;                // Whether any handler is bound
-}
-```
-
-Use `emit("press")` for simple event firing. Use `on("click")` when you need to check metadata like `shouldPreventDefault`:
-
-```tsx
-Link: ({ props, on }) => {
-  const click = on("click");
-  return (
-    <a
-      href={props.href}
-      onClick={(e) => {
-        if (click.shouldPreventDefault) e.preventDefault();
-        click.emit();
-      }}
-    >
-      {props.label}
-    </a>
-  );
-},
-```
-
-### BaseComponentProps
-
-Catalog-agnostic base type for building reusable component libraries (e.g. `@json-render/shadcn`) that are not tied to a specific catalog:
-
-```typescript
-import type { BaseComponentProps } from "@json-render/react";
-
-const Card = ({ props, children }: BaseComponentProps<{ title?: string }>) => (
-  <div>{props.title}{children}</div>
-);
 ```
 
 ## Hooks
@@ -236,10 +117,10 @@ const {
 
 ```typescript
 const {
-  state,   // StateModel (Record<string, unknown>)
-  get,     // (path: string) => unknown
-  set,     // (path: string, value: unknown) => void
-  update,  // (updates: Record<string, unknown>) => void
+  data,      // Record<string, unknown>
+  setState,   // (data: object) => void
+  getValue,  // (path: string) => unknown
+  setValue,  // (path: string, value: unknown) => void
 } = useStateStore();
 ```
 
@@ -249,9 +130,7 @@ const {
 const value = useStateValue(path: string);
 ```
 
-### useStateBinding (deprecated)
-
-> **Deprecated.** Use `useBoundProp` with `$bindState` expressions instead.
+### useStateBinding
 
 ```typescript
 const [value, setValue] = useStateBinding(path: string);
@@ -260,15 +139,15 @@ const [value, setValue] = useStateBinding(path: string);
 ### useActions
 
 ```typescript
-const { execute } = useActions();
-// execute(binding: ActionBinding) => Promise<void>
+const { dispatch } = useActions();
+// dispatch(actionName: string, params: object)
 ```
 
 ### useAction
 
 ```typescript
-const { execute, isLoading } = useAction(binding: ActionBinding);
-// execute() => Promise<void>
+const submitForm = useAction('submit_form');
+// submitForm(params: object)
 ```
 
 ### useIsVisible
@@ -281,97 +160,10 @@ const isVisible = useIsVisible(condition?: VisibilityCondition);
 
 ```typescript
 const {
-  state,     // FieldValidationState
-  validate,  // () => ValidationResult
-  touch,     // () => void
-  clear,     // () => void
+  value,     // unknown
+  setValue,  // (value: unknown) => void
   errors,    // string[]
+  validate,  // () => Promise<boolean>
   isValid,   // boolean
-} = useFieldValidation(path: string, config?: ValidationConfig);
-```
-
-`ValidationConfig` is `{ checks?: ValidationCheck[], validateOn?: 'change' | 'blur' | 'submit' }`.
-
-### useOptionalValidation
-
-Non-throwing variant of `useValidation()`. Returns `null` when no `ValidationProvider` is present, instead of throwing. Useful in components that may or may not be rendered inside a validation context.
-
-```typescript
-const validation = useOptionalValidation();
-// ValidationContextValue | null
-```
-
-### useBoundProp
-
-Two-way binding helper for `$bindState` / `$bindItem` expressions. Returns `[value, setValue]` where `setValue` writes back to the bound state path.
-
-```typescript
-const [value, setValue] = useBoundProp<T>(
-  propValue: T | undefined,       // The already-resolved prop value
-  bindingPath: string | undefined  // From bindings?.value
-);
-```
-
-Use inside registry components:
-
-```tsx
-const Input: ComponentRenderer = ({ props, bindings }) => {
-  const [value, setValue] = useBoundProp<string>(props.value, bindings?.value);
-  return <input value={value ?? ""} onChange={(e) => setValue(e.target.value)} />;
-};
-```
-
-### Chat Hooks
-
-Two hooks are available for chat + GenUI, depending on your setup:
-
-- **`useChatUI`** -- Self-contained chat hook with its own message state, fetch logic, and mixed stream parsing. Use when you want a standalone chat experience without the Vercel AI SDK.
-- **`useJsonRenderMessage`** -- Extracts spec + text from an AI SDK `UIMessage.parts` array. Use with the Vercel AI SDK's `useChat` for full AI SDK integration.
-
-### useChatUI
-
-Hook for chat + GenUI experiences. Manages a multi-turn conversation where each assistant message can contain both text and a json-render UI spec.
-
-```typescript
-const {
-  messages,     // ChatMessage[] - all messages in the conversation
-  isStreaming,  // boolean - true while streaming
-  error,        // Error | null
-  send,         // (text: string) => Promise<void>
-  clear,        // () => void - reset conversation
-} = useChatUI({
-  api: string,                                   // API endpoint
-  onComplete?: (message: ChatMessage) => void,   // Called when streaming completes
-  onError?: (error: Error) => void,              // Called on error
-});
-
-interface ChatMessage {
-  id: string;
-  role: "user" | "assistant";
-  text: string;
-  spec: Spec | null;
-}
-```
-
-### useJsonRenderMessage
-
-Extract a spec and text content from an AI SDK message's `parts` array. Designed for integration with Vercel AI SDK's `useChat`.
-
-```typescript
-const { spec, text, hasSpec } = useJsonRenderMessage(parts: DataPart[]);
-
-// spec: Spec | null     - compiled from JSONL patches in data parts
-// text: string          - concatenated text parts
-// hasSpec: boolean      - true when spec is non-null
-```
-
-### buildSpecFromParts / getTextFromParts
-
-Standalone utilities for extracting spec and text from AI SDK message parts (non-hook versions):
-
-```typescript
-import { buildSpecFromParts, getTextFromParts } from '@json-render/react';
-
-const spec = buildSpecFromParts(message.parts);   // Spec | null
-const text = getTextFromParts(message.parts);      // string
+} = useFieldValidation(path: string, checks: ValidationCheck[]);
 ```

apps/web/app/(main)/docs/api/redux/page.mdx

@@ -1,104 +0,0 @@
-import { pageMetadata } from "@/lib/page-metadata"
-export const metadata = pageMetadata("docs/api/redux")
-
-# @json-render/redux
-
-Redux / Redux Toolkit adapter for json-render's `StateStore` interface.
-
-## Installation
-
-```bash
-npm install @json-render/redux @json-render/core @json-render/react redux
-# or with Redux Toolkit (recommended):
-npm install @json-render/redux @json-render/core @json-render/react @reduxjs/toolkit
-```
-
-## reduxStateStore
-
-Create a `StateStore` backed by a Redux store.
-
-```typescript
-import { reduxStateStore } from "@json-render/redux";
-```
-
-### Options
-
-<table>
-  <thead>
-    <tr>
-      <th>Option</th>
-      <th>Type</th>
-      <th>Required</th>
-      <th>Description</th>
-    </tr>
-  </thead>
-  <tbody>
-    <tr>
-      <td><code>store</code></td>
-      <td><code>Store</code></td>
-      <td>Yes</td>
-      <td>The Redux store instance.</td>
-    </tr>
-    <tr>
-      <td><code>selector</code></td>
-      <td><code>{'(state: S) => StateModel'}</code></td>
-      <td>No</td>
-      <td>Select the json-render slice from the Redux state tree. Defaults to <code>{'(state) => state'}</code>.</td>
-    </tr>
-    <tr>
-      <td><code>dispatch</code></td>
-      <td><code>{'(nextState: StateModel, store: Store) => void'}</code></td>
-      <td>Yes</td>
-      <td>Dispatch an action that replaces the selected slice with the next state.</td>
-    </tr>
-  </tbody>
-</table>
-
-### Example
-
-```typescript
-import { configureStore, createSlice } from "@reduxjs/toolkit";
-import { reduxStateStore } from "@json-render/redux";
-import { StateProvider } from "@json-render/react";
-
-const uiSlice = createSlice({
-  name: "ui",
-  initialState: { count: 0 } as Record<string, unknown>,
-  reducers: {
-    replaceUiState: (_state, action) => action.payload,
-  },
-});
-
-const reduxStore = configureStore({
-  reducer: { ui: uiSlice.reducer },
-});
-
-const store = reduxStateStore({
-  store: reduxStore,
-  selector: (state) => state.ui,
-  dispatch: (next, s) => s.dispatch(uiSlice.actions.replaceUiState(next)),
-});
-```
-
-```tsx
-<StateProvider store={store}>
-  {/* json-render reads/writes go through Redux */}
-</StateProvider>
-```
-
-## Re-exports
-
-<table>
-  <thead>
-    <tr>
-      <th>Export</th>
-      <th>Source</th>
-    </tr>
-  </thead>
-  <tbody>
-    <tr>
-      <td><code>StateStore</code></td>
-      <td><code>@json-render/core</code></td>
-    </tr>
-  </tbody>
-</table>

apps/web/app/(main)/docs/api/remotion/page.mdx

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

apps/web/app/(main)/docs/api/shadcn/page.mdx

@@ -1,349 +0,0 @@
-import { pageMetadata } from "@/lib/page-metadata"
-export const metadata = pageMetadata("docs/api/shadcn")
-
-# @json-render/shadcn
-
-Pre-built [shadcn/ui](https://ui.shadcn.com/) components for json-render. 36 components built on Radix UI + Tailwind CSS, ready to use with `defineCatalog` and `defineRegistry`.
-
-## Installation
-
-```bash
-npm install @json-render/shadcn @json-render/core @json-render/react zod
-```
-
-Your app must have Tailwind CSS configured.
-
-## Entry Points
-
-<table>
-<thead>
-<tr>
-<th>Entry Point</th>
-<th>Exports</th>
-<th>Use For</th>
-</tr>
-</thead>
-<tbody>
-<tr>
-<td><code>@json-render/shadcn</code></td>
-<td><code>shadcnComponents</code></td>
-<td>React implementations</td>
-</tr>
-<tr>
-<td><code>@json-render/shadcn/catalog</code></td>
-<td><code>shadcnComponentDefinitions</code></td>
-<td>Catalog schemas (no React dependency, safe for server)</td>
-</tr>
-</tbody>
-</table>
-
-## Usage
-
-Pick the components you need from the standard definitions:
-
-```typescript
-import { defineCatalog } from "@json-render/core";
-import { schema } from "@json-render/react/schema";
-import { shadcnComponentDefinitions } from "@json-render/shadcn/catalog";
-import { defineRegistry } from "@json-render/react";
-import { shadcnComponents } from "@json-render/shadcn";
-
-// Catalog: pick definitions
-const catalog = defineCatalog(schema, {
-  components: {
-    Card: shadcnComponentDefinitions.Card,
-    Stack: shadcnComponentDefinitions.Stack,
-    Heading: shadcnComponentDefinitions.Heading,
-    Button: shadcnComponentDefinitions.Button,
-    Input: shadcnComponentDefinitions.Input,
-  },
-  actions: {},
-});
-
-// Registry: pick matching implementations
-const { registry } = defineRegistry(catalog, {
-  components: {
-    Card: shadcnComponents.Card,
-    Stack: shadcnComponents.Stack,
-    Heading: shadcnComponents.Heading,
-    Button: shadcnComponents.Button,
-    Input: shadcnComponents.Input,
-  },
-});
-```
-
-State actions (`setState`, `pushState`, `removeState`) are built into the React schema and handled by `ActionProvider` automatically. You don't need to declare them in your catalog.
-
-## Extending with Custom Components
-
-Add custom components alongside standard ones:
-
-```typescript
-import { z } from "zod";
-
-const catalog = defineCatalog(schema, {
-  components: {
-    // Standard
-    Card: shadcnComponentDefinitions.Card,
-    Stack: shadcnComponentDefinitions.Stack,
-    Button: shadcnComponentDefinitions.Button,
-
-    // Custom
-    Metric: {
-      props: z.object({
-        label: z.string(),
-        value: z.string(),
-        trend: z.enum(["up", "down", "neutral"]).nullable(),
-      }),
-      description: "KPI metric display",
-    },
-  },
-  actions: {},
-});
-
-const { registry } = defineRegistry(catalog, {
-  components: {
-    Card: shadcnComponents.Card,
-    Stack: shadcnComponents.Stack,
-    Button: shadcnComponents.Button,
-    Metric: ({ props }) => (
-      <div>
-        <span>{props.label}</span>
-        <span>{props.value}</span>
-      </div>
-    ),
-  },
-});
-```
-
-## Available Components
-
-### Layout
-
-<table>
-<thead>
-<tr>
-<th>Component</th>
-<th>Description</th>
-</tr>
-</thead>
-<tbody>
-<tr>
-<td><code>Card</code></td>
-<td>Container card with optional title, description, maxWidth, centered</td>
-</tr>
-<tr>
-<td><code>Stack</code></td>
-<td>Flex container with direction, gap, align, justify</td>
-</tr>
-<tr>
-<td><code>Grid</code></td>
-<td>Grid layout with columns (1-6) and gap</td>
-</tr>
-<tr>
-<td><code>Separator</code></td>
-<td>Visual separator line with orientation</td>
-</tr>
-</tbody>
-</table>
-
-### Navigation
-
-<table>
-<thead>
-<tr>
-<th>Component</th>
-<th>Description</th>
-</tr>
-</thead>
-<tbody>
-<tr>
-<td><code>Tabs</code></td>
-<td>Tabbed navigation with tabs array, defaultValue, value</td>
-</tr>
-<tr>
-<td><code>Accordion</code></td>
-<td>Collapsible sections with items array and type (single/multiple)</td>
-</tr>
-<tr>
-<td><code>Collapsible</code></td>
-<td>Single collapsible section with title and defaultOpen</td>
-</tr>
-<tr>
-<td><code>Pagination</code></td>
-<td>Page navigation with totalPages and page</td>
-</tr>
-</tbody>
-</table>
-
-### Overlay
-
-<table>
-<thead>
-<tr>
-<th>Component</th>
-<th>Description</th>
-</tr>
-</thead>
-<tbody>
-<tr>
-<td><code>Dialog</code></td>
-<td>Modal dialog with title, description, openPath</td>
-</tr>
-<tr>
-<td><code>Drawer</code></td>
-<td>Bottom drawer with title, description, openPath</td>
-</tr>
-<tr>
-<td><code>Tooltip</code></td>
-<td>Hover tooltip with content and text</td>
-</tr>
-<tr>
-<td><code>Popover</code></td>
-<td>Click-triggered popover with trigger and content</td>
-</tr>
-<tr>
-<td><code>DropdownMenu</code></td>
-<td>Dropdown menu with label and items array</td>
-</tr>
-</tbody>
-</table>
-
-### Content
-
-<table>
-<thead>
-<tr>
-<th>Component</th>
-<th>Description</th>
-</tr>
-</thead>
-<tbody>
-<tr>
-<td><code>Heading</code></td>
-<td>Heading text with level (h1-h4)</td>
-</tr>
-<tr>
-<td><code>Text</code></td>
-<td>Paragraph with variant (body, caption, muted, lead, code)</td>
-</tr>
-<tr>
-<td><code>Image</code></td>
-<td>Image with alt, width, height</td>
-</tr>
-<tr>
-<td><code>Avatar</code></td>
-<td>User avatar with src, name, size</td>
-</tr>
-<tr>
-<td><code>Badge</code></td>
-<td>Status badge with text and variant</td>
-</tr>
-<tr>
-<td><code>Alert</code></td>
-<td>Alert banner with title, message, type</td>
-</tr>
-<tr>
-<td><code>Carousel</code></td>
-<td>Horizontally scrollable carousel with items</td>
-</tr>
-<tr>
-<td><code>Table</code></td>
-<td>Data table with columns and rows</td>
-</tr>
-</tbody>
-</table>
-
-### Feedback
-
-<table>
-<thead>
-<tr>
-<th>Component</th>
-<th>Description</th>
-</tr>
-</thead>
-<tbody>
-<tr>
-<td><code>Progress</code></td>
-<td>Progress bar with value, max, label</td>
-</tr>
-<tr>
-<td><code>Skeleton</code></td>
-<td>Loading placeholder with width, height, rounded</td>
-</tr>
-<tr>
-<td><code>Spinner</code></td>
-<td>Loading spinner with size and label</td>
-</tr>
-</tbody>
-</table>
-
-### Input
-
-<table>
-<thead>
-<tr>
-<th>Component</th>
-<th>Description</th>
-</tr>
-</thead>
-<tbody>
-<tr>
-<td><code>Button</code></td>
-<td>Clickable button with label, variant, disabled</td>
-</tr>
-<tr>
-<td><code>Link</code></td>
-<td>Anchor link with label and href</td>
-</tr>
-<tr>
-<td><code>Input</code></td>
-<td>Text input with label, name, type, placeholder, value, checks</td>
-</tr>
-<tr>
-<td><code>Textarea</code></td>
-<td>Multi-line text input with label, name, placeholder, rows, value, checks</td>
-</tr>
-<tr>
-<td><code>Select</code></td>
-<td>Dropdown select with label, name, options, value, checks</td>
-</tr>
-<tr>
-<td><code>Checkbox</code></td>
-<td>Checkbox with label, name, checked</td>
-</tr>
-<tr>
-<td><code>Radio</code></td>
-<td>Radio button group with label, name, options, value</td>
-</tr>
-<tr>
-<td><code>Switch</code></td>
-<td>Toggle switch with label, name, checked</td>
-</tr>
-<tr>
-<td><code>Slider</code></td>
-<td>Range slider with label, min, max, step, value</td>
-</tr>
-<tr>
-<td><code>Toggle</code></td>
-<td>Toggle button with label, pressed, variant</td>
-</tr>
-<tr>
-<td><code>ToggleGroup</code></td>
-<td>Group of toggle buttons with items, type, value</td>
-</tr>
-<tr>
-<td><code>ButtonGroup</code></td>
-<td>Group of buttons with buttons array and selected</td>
-</tr>
-</tbody>
-</table>
-
-## Notes
-
-- The `/catalog` entry point has no React dependency -- use it for server-side prompt generation
-- Components use Tailwind CSS classes -- your app must have Tailwind configured
-- Component implementations use bundled shadcn/ui primitives (not your app's `components/ui/`)
-- Form inputs support `checks` for validation (type + message pairs)
-- Events: inputs emit `change`/`submit`/`focus`/`blur`; buttons emit `press`; selects emit `change`/`select`

apps/web/app/(main)/docs/api/solid/page.mdx

@@ -1,201 +0,0 @@
-import { pageMetadata } from "@/lib/page-metadata";
-export const metadata = pageMetadata("docs/api/solid");
-
-# @json-render/solid
-
-SolidJS components, providers, and hooks for rendering json-render specs.
-
-## Installation
-
-<PackageInstall packages="@json-render/core @json-render/solid" />
-
-Peer dependencies: `solid-js ^1.9.0` and `zod ^4.0.0`.
-
-<PackageInstall packages="solid-js zod" />
-
-## Providers
-
-### StateProvider
-
-```tsx
-<StateProvider
-  initialState={{}}
-  onStateChange={(changes) => console.log(changes)}
->
-  {/* children */}
-</StateProvider>
-```
-
-<table>
-  <thead>
-    <tr>
-      <th>Prop</th>
-      <th>Type</th>
-      <th>Description</th>
-    </tr>
-  </thead>
-  <tbody>
-    <tr>
-      <td>
-        <code>store</code>
-      </td>
-      <td>
-        <code>StateStore</code>
-      </td>
-      <td>
-        External store (controlled mode). When provided,{" "}
-        <code>initialState</code> and <code>onStateChange</code> are ignored.
-      </td>
-    </tr>
-    <tr>
-      <td>
-        <code>initialState</code>
-      </td>
-      <td>
-        <code>Record&lt;string, unknown&gt;</code>
-      </td>
-      <td>Initial state model for uncontrolled mode.</td>
-    </tr>
-    <tr>
-      <td>
-        <code>onStateChange</code>
-      </td>
-      <td>
-        <code>
-          {"(changes: Array<{ path: string; value: unknown }>) => void"}
-        </code>
-      </td>
-      <td>Called for uncontrolled state updates.</td>
-    </tr>
-  </tbody>
-</table>
-
-### ActionProvider
-
-```tsx
-<ActionProvider
-  handlers={{ submit: async (params) => {} }}
-  navigate={(path) => {}}
->
-  {/* children */}
-</ActionProvider>
-```
-
-### VisibilityProvider
-
-```tsx
-<VisibilityProvider>{/* children */}</VisibilityProvider>
-```
-
-### ValidationProvider
-
-```tsx
-<ValidationProvider customFunctions={{ custom: (value) => Boolean(value) }}>
-  {/* children */}
-</ValidationProvider>
-```
-
-### JSONUIProvider
-
-Combined provider wrapper for state, visibility, validation, and actions.
-
-```tsx
-<JSONUIProvider
-  registry={registry}
-  initialState={{}}
-  handlers={handlers}
-  validationFunctions={validationFunctions}
->
-  <Renderer spec={spec} registry={registry} />
-</JSONUIProvider>
-```
-
-## defineRegistry
-
-Create a typed component registry and action helpers from a catalog.
-
-```tsx
-const { registry, handlers, executeAction } = defineRegistry(catalog, {
-  components: {
-    Card: (renderProps) => <div>{renderProps.children}</div>,
-    Button: (renderProps) => (
-      <button onClick={() => renderProps.emit("press")}>
-        {renderProps.element.props.label as string}
-      </button>
-    ),
-  },
-  actions: {
-    submit: async (params, setState, state) => {
-      // custom action logic
-    },
-  },
-});
-```
-
-## Components
-
-### Renderer
-
-```tsx
-<Renderer spec={spec} registry={registry} loading={false} />
-```
-
-Renders a `Spec` tree using your registry.
-
-### createRenderer
-
-Build an app-level renderer from catalog + components:
-
-```tsx
-const AppRenderer = createRenderer(catalog, {
-  Card: (renderProps) => <div>{renderProps.children}</div>,
-});
-
-<AppRenderer spec={spec} state={{}} onAction={(name, params) => {}} />;
-```
-
-## Hooks
-
-- `useStateStore()`
-- `useStateValue(path)` - returns an accessor
-- `useStateBinding(path)` - returns `[Accessor<T | undefined>, setValue]`
-- `useVisibility()` / `useIsVisible(condition)`
-- `useActions()` / `useAction(binding)`
-- `useValidation()` / `useOptionalValidation()`
-- `useFieldValidation(path, config)` - returns accessor-backed `state`, `errors`, and `isValid`
-- `useBoundProp(value, bindingPath)`
-- `useUIStream(options)`
-- `useChatUI(options)`
-
-## Built-in Actions
-
-`ActionProvider` handles these built-in actions:
-
-- `setState`
-- `pushState`
-- `removeState`
-- `validateForm`
-
-## Component Props
-
-Registry components receive:
-
-```ts
-interface ComponentRenderProps<P = Record<string, unknown>> {
-  element: UIElement<string, P>;
-  children?: JSX.Element;
-  emit: (event: string) => void;
-  on: (event: string) => EventHandle;
-  bindings?: Record<string, string>;
-  loading?: boolean;
-}
-```
-
-Use `emit("event")` to dispatch event bindings. Use `on("event")` to access `EventHandle` metadata (`bound`, `shouldPreventDefault`, `emit`).
-
-## Reactivity Notes
-
-- Keep changing reads in JSX expressions, `createMemo`, or `createEffect`.
-- Avoid props destructuring in component signatures when you need live updates.
-- `StateProvider` and other contexts expose getter-backed values so consumers read live signals.
-- `useStateValue`, `useStateBinding`, and `useFieldValidation` expose reactive accessors; call them as functions.

apps/web/app/(main)/docs/api/svelte/page.mdx

@@ -1,126 +0,0 @@
-import { pageMetadata } from "@/lib/page-metadata"
-export const metadata = pageMetadata("docs/api/svelte")
-
-# @json-render/svelte
-
-Svelte 5 components, providers, and helpers for rendering json-render specs.
-
-## Installation
-
-<PackageInstall packages="@json-render/core @json-render/svelte" />
-
-Peer dependencies: `svelte ^5.0.0` and `zod ^4.0.0`.
-
-<PackageInstall packages="svelte zod" />
-
-## Components
-
-### Renderer
-
-```svelte
-<Renderer
-  spec={spec}       // Spec | null
-  registry={registry}
-  loading={false}
-/>
-```
-
-Renders a spec with your component registry. If `spec` is `null`, it renders nothing.
-
-### JsonUIProvider
-
-Convenience wrapper around `StateProvider`, `VisibilityProvider`, `ValidationProvider`, and `ActionProvider`.
-
-```svelte
-<JsonUIProvider
-  initialState={{}}
-  handlers={handlers}
-  validationFunctions={validationFunctions}
->
-  <Renderer {spec} {registry} />
-</JsonUIProvider>
-```
-
-## defineRegistry
-
-Create a typed component registry and action handlers from a catalog.
-
-```typescript
-import { defineRegistry } from "@json-render/svelte";
-
-const { registry, handlers, executeAction } = defineRegistry(catalog, {
-  components: {
-    Card,
-    Button,
-  },
-  actions: {
-    submit: async (params, setState, state) => {
-      // custom action logic
-    },
-  },
-});
-```
-
-`handlers` is designed for `JsonUIProvider`/`ActionProvider`. `executeAction` is an imperative helper.
-
-## Component Props
-
-Registry components receive `BaseComponentProps<TProps>`:
-
-```typescript
-interface BaseComponentProps<TProps> {
-  props: TProps;
-  children?: Snippet;
-  emit: (event: string) => void;
-  bindings?: Record<string, string>;
-  loading?: boolean;
-}
-```
-
-Use `emit("eventName")` to trigger handlers declared in the spec `on` bindings.
-
-## Context Helpers
-
-Use these helpers inside Svelte components:
-
-- `getStateValue(path)` - read/write state via `.current`
-- `getBoundProp(() => value, () => bindingPath)` - write back resolved `$bindState` / `$bindItem` values
-- `isVisible(condition)` - evaluate visibility via `.current`
-- `getAction(name)` - read a registered action handler via `.current`
-- `getFieldValidation(ctx, path, config)` - get field validation state + actions
-
-For advanced usage, access full contexts:
-
-- `getStateContext()`
-- `getActionContext()`
-- `getVisibilityContext()`
-- `getValidationContext()`
-- `getOptionalValidationContext()`
-
-## Streaming
-
-### createUIStream
-
-```typescript
-const stream = createUIStream({
-  api: "/api/generate-ui",
-  onComplete: (spec) => console.log(spec),
-});
-
-await stream.send("Create a login form");
-
-console.log(stream.spec);
-console.log(stream.isStreaming);
-```
-
-### createChatUI
-
-```typescript
-const chat = createChatUI({ api: "/api/chat-ui" });
-await chat.send("Build a settings panel");
-console.log(chat.messages, chat.isStreaming);
-```
-
-## Schema Export
-
-Use `schema` from `@json-render/svelte` when defining catalogs for Svelte specs.

apps/web/app/(main)/docs/api/vue/page.mdx

@@ -1,337 +0,0 @@
-import { pageMetadata } from "@/lib/page-metadata"
-export const metadata = pageMetadata("docs/api/vue")
-
-# @json-render/vue
-
-Vue 3 components, providers, and composables.
-
-## Providers
-
-### StateProvider
-
-```vue
-<StateProvider :initial-state="object" :on-state-change="fn">
-  <!-- children -->
-</StateProvider>
-```
-
-<table>
-  <thead>
-    <tr>
-      <th>Prop</th>
-      <th>Type</th>
-      <th>Description</th>
-    </tr>
-  </thead>
-  <tbody>
-    <tr>
-      <td><code>store</code></td>
-      <td><code>StateStore</code></td>
-      <td>External store (controlled mode). When provided, <code>initialState</code> and <code>onStateChange</code> are ignored.</td>
-    </tr>
-    <tr>
-      <td><code>initialState</code></td>
-      <td><code>Record&lt;string, unknown&gt;</code></td>
-      <td>Initial state model (uncontrolled mode).</td>
-    </tr>
-    <tr>
-      <td><code>onStateChange</code></td>
-      <td><code>{'(changes: Array<{ path: string; value: unknown }>) => void'}</code></td>
-      <td>Callback when state changes (uncontrolled mode). Called once per <code>set</code> or <code>update</code> with all changed entries.</td>
-    </tr>
-  </tbody>
-</table>
-
-#### External Store (Controlled Mode)
-
-Pass a `StateStore` to bypass the internal state and wire json-render to any state management library:
-
-```typescript
-import { createStateStore, type StateStore } from "@json-render/vue";
-
-const store = createStateStore({ count: 0 });
-```
-
-```vue
-<StateProvider :store="store">
-  <!-- children -->
-</StateProvider>
-```
-
-```typescript
-// Mutate from anywhere — Vue re-renders automatically:
-store.set("/count", 1);
-```
-
-### ActionProvider
-
-```vue
-<ActionProvider :handlers="Record<string, ActionHandler>" :navigate="fn">
-  <!-- children -->
-</ActionProvider>
-
-// type ActionHandler = (params: Record<string, unknown>) => void | Promise<void>;
-```
-
-### VisibilityProvider
-
-```vue
-<VisibilityProvider>
-  <!-- children -->
-</VisibilityProvider>
-```
-
-`VisibilityProvider` reads state from the parent `StateProvider` automatically. Conditions in specs use the `VisibilityCondition` format with `$state` paths (e.g. `{ "$state": "/path" }`, `{ "$state": "/path", "eq": value }`). See [visibility](/docs/visibility) for the full syntax.
-
-### ValidationProvider
-
-```vue
-<ValidationProvider :custom-functions="Record<string, ValidationFunction>">
-  <!-- children -->
-</ValidationProvider>
-
-// type ValidationFunction = (value: unknown, args?: object) => boolean | Promise<boolean>;
-```
-
-## defineRegistry
-
-Create a type-safe component registry from a catalog. Components receive `props`, `children`, `emit`, `on`, and `loading` with catalog-inferred types.
-
-When the catalog declares actions, the `actions` field is required. When the catalog has no actions (e.g. `actions: {}`), the field is optional. When passing stubs, any `async () => {}` is sufficient.
-
-```typescript
-import { h } from "vue";
-import { defineRegistry } from "@json-render/vue";
-
-const { registry } = defineRegistry(catalog, {
-  components: {
-    Card: ({ props, children }) =>
-      h("div", { class: "card" }, [h("h3", null, props.title), children]),
-    Button: ({ props, emit }) =>
-      h("button", { onClick: () => emit("press") }, props.label),
-  },
-  // Required when catalog declares actions:
-  actions: {
-    submit: async (params) => { /* ... */ },
-  },
-});
-
-// Pass to <Renderer>
-// <Renderer :spec="spec" :registry="registry" />
-```
-
-## Components
-
-### Renderer
-
-```vue
-<Renderer
-  :spec="Spec"           // The UI spec to render
-  :registry="Registry"   // Component registry (from defineRegistry)
-  :loading="boolean"     // Optional loading state
-  :fallback="Component"  // Optional fallback for unknown types
-/>
-```
-
-### Component Props (via defineRegistry)
-
-```typescript
-import type { VNode } from "vue";
-
-interface ComponentContext<P> {
-  props: P;                          // Typed props from catalog
-  children?: VNode | VNode[];        // Rendered children (for container components)
-  emit: (event: string) => void;     // Emit a named event (always defined)
-  on: (event: string) => EventHandle; // Get event handle with metadata
-  loading?: boolean;
-  bindings?: Record<string, string>; // State paths from $bindState/$bindItem expressions
-}
-
-interface EventHandle {
-  emit: () => void;              // Fire the event
-  shouldPreventDefault: boolean; // Whether any binding requested preventDefault
-  bound: boolean;                // Whether any handler is bound
-}
-```
-
-Use `emit("press")` for simple event firing. Use `on("click")` when you need metadata like `shouldPreventDefault`:
-
-```typescript
-Link: ({ props, on }) => {
-  const click = on("click");
-  return h("a", {
-    href: props.href,
-    onClick: (e: MouseEvent) => {
-      if (click.shouldPreventDefault) e.preventDefault();
-      click.emit();
-    },
-  }, props.label);
-},
-```
-
-### BaseComponentProps
-
-Catalog-agnostic base type for building reusable component libraries that are not tied to a specific catalog:
-
-```typescript
-import type { BaseComponentProps } from "@json-render/vue";
-
-const Card = ({ props, children }: BaseComponentProps<{ title?: string }>) =>
-  h("div", null, [props.title, children]);
-```
-
-## Composables
-
-### useStateStore
-
-```typescript
-const {
-  state,   // ShallowRef<StateModel> — access with state.value
-  get,     // (path: string) => unknown
-  set,     // (path: string, value: unknown) => void
-  update,  // (updates: Record<string, unknown>) => void
-} = useStateStore();
-```
-
-> **Note:** `state` is a `ShallowRef<StateModel>`, not a plain object. Use `state.value` to read the current state. This differs from the React renderer.
-
-### useStateValue
-
-```typescript
-const value = useStateValue(path: string); // ComputedRef<T | undefined>
-```
-
-Returns a `ComputedRef` that automatically updates when the state at `path` changes. Use `.value` to access the current value.
-
-### useStateBinding (deprecated)
-
-> **Deprecated.** Use `$bindState` expressions with `bindings` prop instead.
-
-```typescript
-const [value, setValue] = useStateBinding(path: string);
-// value: ComputedRef<T | undefined>
-// setValue: (value: T) => void
-```
-
-### useActions
-
-```typescript
-const { execute } = useActions();
-// execute(binding: ActionBinding) => Promise<void>
-```
-
-### useAction
-
-```typescript
-const { execute, isLoading } = useAction(binding: ActionBinding);
-// execute: () => Promise<void>
-// isLoading: ComputedRef<boolean>
-```
-
-### useIsVisible
-
-```typescript
-const isVisible = useIsVisible(condition?: VisibilityCondition);
-```
-
-### useFieldValidation
-
-```typescript
-const {
-  state,     // ComputedRef<FieldValidationState>
-  validate,  // () => ValidationResult
-  touch,     // () => void
-  clear,     // () => void
-  errors,    // ComputedRef<string[]>
-  isValid,   // ComputedRef<boolean>
-} = useFieldValidation(path: string, config?: ValidationConfig);
-```
-
-`ValidationConfig` is `{ checks?: ValidationCheck[], validateOn?: 'change' | 'blur' | 'submit' }`.
-
-## Differences from `@json-render/react`
-
-<table>
-  <thead>
-    <tr>
-      <th>API</th>
-      <th>React</th>
-      <th>Vue</th>
-      <th>Note</th>
-    </tr>
-  </thead>
-  <tbody>
-    <tr>
-      <td><code>useStateStore().state</code></td>
-      <td><code>StateModel</code> (plain object)</td>
-      <td><code>ShallowRef&lt;StateModel&gt;</code></td>
-      <td>Vue reactivity; use <code>state.value</code></td>
-    </tr>
-    <tr>
-      <td><code>useStateValue()</code></td>
-      <td><code>T | undefined</code></td>
-      <td><code>ComputedRef&lt;T | undefined&gt;</code></td>
-      <td>Vue reactivity; use <code>.value</code></td>
-    </tr>
-    <tr>
-      <td><code>useStateBinding()</code></td>
-      <td><code>[T | undefined, setter]</code></td>
-      <td><code>[ComputedRef&lt;T | undefined&gt;, setter]</code></td>
-      <td>Vue reactivity; use <code>value.value</code></td>
-    </tr>
-    <tr>
-      <td><code>useAction().isLoading</code></td>
-      <td><code>boolean</code></td>
-      <td><code>ComputedRef&lt;boolean&gt;</code></td>
-      <td>Vue reactivity; use <code>.value</code></td>
-    </tr>
-    <tr>
-      <td><code>useFieldValidation().state</code></td>
-      <td><code>FieldValidationState</code></td>
-      <td><code>ComputedRef&lt;FieldValidationState&gt;</code></td>
-      <td>Vue reactivity; use <code>.value</code></td>
-    </tr>
-    <tr>
-      <td><code>useFieldValidation().errors</code></td>
-      <td><code>string[]</code></td>
-      <td><code>ComputedRef&lt;string[]&gt;</code></td>
-      <td>Vue reactivity; use <code>.value</code></td>
-    </tr>
-    <tr>
-      <td><code>useFieldValidation().isValid</code></td>
-      <td><code>boolean</code></td>
-      <td><code>ComputedRef&lt;boolean&gt;</code></td>
-      <td>Vue reactivity; use <code>.value</code></td>
-    </tr>
-    <tr>
-      <td><code>VisibilityContextValue.ctx</code></td>
-      <td><code>CoreVisibilityContext</code></td>
-      <td><code>ComputedRef&lt;CoreVisibilityContext&gt;</code></td>
-      <td>Vue reactivity; use <code>ctx.value</code></td>
-    </tr>
-    <tr>
-      <td><code>children</code> type</td>
-      <td><code>React.ReactNode</code></td>
-      <td><code>VNode | VNode[]</code></td>
-      <td>Platform-specific</td>
-    </tr>
-    <tr>
-      <td><code>useBoundProp</code></td>
-      <td>exported</td>
-      <td>exported</td>
-      <td>Same API; returns <code>[value, setValue]</code></td>
-    </tr>
-    <tr>
-      <td><code>VisibilityProviderProps</code></td>
-      <td>exported</td>
-      <td>not exported (no props)</td>
-      <td>Vue uses slot, no prop needed</td>
-    </tr>
-    <tr>
-      <td>Streaming hooks</td>
-      <td><code>useUIStream</code>, <code>useChatUI</code></td>
-      <td><code>useUIStream</code>, <code>useChatUI</code></td>
-      <td>Same API; returns Vue <code>Ref</code> values</td>
-    </tr>
-  </tbody>
-</table>

apps/web/app/(main)/docs/api/xstate/page.mdx

@@ -1,77 +0,0 @@
-import { pageMetadata } from "@/lib/page-metadata"
-export const metadata = pageMetadata("docs/api/xstate")
-
-# @json-render/xstate
-
-[XState Store](https://stately.ai/docs/xstate-store) adapter for json-render's `StateStore` interface.
-
-Requires `@xstate/store` v3+.
-
-## Installation
-
-```bash
-npm install @json-render/xstate @json-render/core @json-render/react @xstate/store
-```
-
-## xstateStoreStateStore
-
-Create a `StateStore` backed by an `@xstate/store` atom.
-
-```typescript
-import { xstateStoreStateStore } from "@json-render/xstate";
-```
-
-### Options
-
-<table>
-  <thead>
-    <tr>
-      <th>Option</th>
-      <th>Type</th>
-      <th>Required</th>
-      <th>Description</th>
-    </tr>
-  </thead>
-  <tbody>
-    <tr>
-      <td><code>atom</code></td>
-      <td><code>{'Atom<StateModel>'}</code></td>
-      <td>Yes</td>
-      <td>An <code>@xstate/store</code> atom (from <code>createAtom</code>) holding the json-render state model.</td>
-    </tr>
-  </tbody>
-</table>
-
-### Example
-
-```typescript
-import { createAtom } from "@xstate/store";
-import { xstateStoreStateStore } from "@json-render/xstate";
-import { StateProvider } from "@json-render/react";
-
-const uiAtom = createAtom({ count: 0 });
-const store = xstateStoreStateStore({ atom: uiAtom });
-```
-
-```tsx
-<StateProvider store={store}>
-  {/* json-render reads/writes go through @xstate/store */}
-</StateProvider>
-```
-
-## Re-exports
-
-<table>
-  <thead>
-    <tr>
-      <th>Export</th>
-      <th>Source</th>
-    </tr>
-  </thead>
-  <tbody>
-    <tr>
-      <td><code>StateStore</code></td>
-      <td><code>@json-render/core</code></td>
-    </tr>
-  </tbody>
-</table>

apps/web/app/(main)/docs/api/yaml/page.mdx

@@ -1,232 +0,0 @@
-import { pageMetadata } from "@/lib/page-metadata"
-export const metadata = pageMetadata("docs/api/yaml")
-
-# @json-render/yaml
-
-YAML wire format for json-render. Progressive rendering and surgical edits via streaming YAML.
-
-## Prompt Generation
-
-### yamlPrompt
-
-Generate a YAML-format system prompt from any json-render catalog. Works with catalogs from any renderer.
-
-```typescript
-function yamlPrompt(
-  catalog: Catalog,
-  options?: YamlPromptOptions
-): string
-```
-
-```typescript
-import { yamlPrompt } from "@json-render/yaml";
-
-const systemPrompt = yamlPrompt(catalog, {
-  mode: "standalone",
-  customRules: ["Always use dark theme"],
-  editModes: ["merge"],
-});
-```
-
-### YamlPromptOptions
-
-<table>
-  <thead>
-    <tr>
-      <th>Option</th>
-      <th>Type</th>
-      <th>Default</th>
-      <th>Description</th>
-    </tr>
-  </thead>
-  <tbody>
-    <tr>
-      <td><code>system</code></td>
-      <td><code>string</code></td>
-      <td><code>{'\"You are a UI generator that outputs YAML.\"'}</code></td>
-      <td>Custom system message intro</td>
-    </tr>
-    <tr>
-      <td><code>mode</code></td>
-      <td><code>{'\"standalone\" | \"inline\"'}</code></td>
-      <td><code>{'\"standalone\"'}</code></td>
-      <td>Standalone outputs only YAML; inline allows conversational responses with embedded YAML fences</td>
-    </tr>
-    <tr>
-      <td><code>customRules</code></td>
-      <td><code>{'string[]'}</code></td>
-      <td><code>{'[]'}</code></td>
-      <td>Additional rules appended to the prompt</td>
-    </tr>
-    <tr>
-      <td><code>editModes</code></td>
-      <td><code>{'EditMode[]'}</code></td>
-      <td><code>{'[\"merge\"]'}</code></td>
-      <td>Edit modes to document in the prompt (patch, merge, diff)</td>
-    </tr>
-  </tbody>
-</table>
-
-## AI SDK Transform
-
-### createYamlTransform
-
-Creates a `TransformStream` that intercepts AI SDK stream chunks and converts YAML spec/edit blocks into json-render patch data parts.
-
-```typescript
-function createYamlTransform(
-  options?: YamlTransformOptions
-): TransformStream<StreamChunk, StreamChunk>
-```
-
-Recognized fence types:
-
-- <code>{'```yaml-spec'}</code> -- Full YAML spec, parsed progressively
-- <code>{'```yaml-edit'}</code> -- Partial YAML, deep-merged with current spec
-- <code>{'```yaml-patch'}</code> -- RFC 6902 JSON Patch lines
-- <code>{'```diff'}</code> -- Unified diff against serialized spec
-
-### pipeYamlRender
-
-Convenience wrapper that pipes an AI SDK stream through the YAML transform. Drop-in replacement for `pipeJsonRender` from `@json-render/core`.
-
-```typescript
-function pipeYamlRender<T>(
-  stream: ReadableStream<T>,
-  options?: YamlTransformOptions
-): ReadableStream<T>
-```
-
-```typescript
-import { pipeYamlRender } from "@json-render/yaml";
-import { createUIMessageStream, createUIMessageStreamResponse } from "ai";
-
-const stream = createUIMessageStream({
-  execute: async ({ writer }) => {
-    writer.merge(pipeYamlRender(result.toUIMessageStream()));
-  },
-});
-return createUIMessageStreamResponse({ stream });
-```
-
-## Streaming Parser
-
-### createYamlStreamCompiler
-
-Create a streaming YAML compiler that incrementally parses YAML text and emits JSON Patch operations by diffing each successful parse against the previous snapshot.
-
-```typescript
-function createYamlStreamCompiler<T>(
-  initial?: Partial<T>
-): YamlStreamCompiler<T>
-```
-
-```typescript
-import { createYamlStreamCompiler } from "@json-render/yaml";
-
-const compiler = createYamlStreamCompiler<Spec>();
-
-compiler.push("root: main\n");
-compiler.push("elements:\n  main:\n    type: Card\n");
-
-const { result, newPatches } = compiler.flush();
-```
-
-### YamlStreamCompiler
-
-<table>
-  <thead>
-    <tr>
-      <th>Method</th>
-      <th>Returns</th>
-      <th>Description</th>
-    </tr>
-  </thead>
-  <tbody>
-    <tr>
-      <td><code>push(chunk)</code></td>
-      <td><code>{'{ result: T; newPatches: JsonPatch[] }'}</code></td>
-      <td>Push a chunk of text, returns current result and new patches</td>
-    </tr>
-    <tr>
-      <td><code>flush()</code></td>
-      <td><code>{'{ result: T; newPatches: JsonPatch[] }'}</code></td>
-      <td>Flush remaining buffer, return final result</td>
-    </tr>
-    <tr>
-      <td><code>getResult()</code></td>
-      <td><code>T</code></td>
-      <td>Get the current compiled result</td>
-    </tr>
-    <tr>
-      <td><code>getPatches()</code></td>
-      <td><code>{'JsonPatch[]'}</code></td>
-      <td>Get all patches applied so far</td>
-    </tr>
-    <tr>
-      <td><code>reset(initial?)</code></td>
-      <td><code>void</code></td>
-      <td>Reset to initial state</td>
-    </tr>
-  </tbody>
-</table>
-
-## Fence Constants
-
-Exported string constants for fence detection in custom parsers:
-
-<table>
-  <thead>
-    <tr>
-      <th>Constant</th>
-      <th>Value</th>
-    </tr>
-  </thead>
-  <tbody>
-    <tr>
-      <td><code>YAML_SPEC_FENCE</code></td>
-      <td><code>{'\"```yaml-spec\"'}</code></td>
-    </tr>
-    <tr>
-      <td><code>YAML_EDIT_FENCE</code></td>
-      <td><code>{'\"```yaml-edit\"'}</code></td>
-    </tr>
-    <tr>
-      <td><code>YAML_PATCH_FENCE</code></td>
-      <td><code>{'\"```yaml-patch\"'}</code></td>
-    </tr>
-    <tr>
-      <td><code>DIFF_FENCE</code></td>
-      <td><code>{'\"```diff\"'}</code></td>
-    </tr>
-    <tr>
-      <td><code>FENCE_CLOSE</code></td>
-      <td><code>{'\"```\"'}</code></td>
-    </tr>
-  </tbody>
-</table>
-
-## Re-exports from @json-render/core
-
-### diffToPatches
-
-Generate RFC 6902 JSON Patch operations that transform one object into another.
-
-```typescript
-function diffToPatches(
-  oldObj: Record<string, unknown>,
-  newObj: Record<string, unknown>,
-  basePath?: string
-): JsonPatch[]
-```
-
-### deepMergeSpec
-
-Deep-merge with RFC 7396 semantics: `null` deletes, arrays replace, objects recurse.
-
-```typescript
-function deepMergeSpec(
-  base: Record<string, unknown>,
-  patch: Record<string, unknown>
-): Record<string, unknown>
-```

apps/web/app/(main)/docs/api/zustand/page.mdx

@@ -1,108 +0,0 @@
-import { pageMetadata } from "@/lib/page-metadata"
-export const metadata = pageMetadata("docs/api/zustand")
-
-# @json-render/zustand
-
-Zustand adapter for json-render's `StateStore` interface.
-
-Requires Zustand v5+. Zustand v4 is not supported due to breaking API changes in the vanilla store interface.
-
-## Installation
-
-```bash
-npm install @json-render/zustand @json-render/core @json-render/react zustand
-```
-
-## zustandStateStore
-
-Create a `StateStore` backed by a Zustand vanilla store.
-
-```typescript
-import { zustandStateStore } from "@json-render/zustand";
-```
-
-### Options
-
-<table>
-  <thead>
-    <tr>
-      <th>Option</th>
-      <th>Type</th>
-      <th>Required</th>
-      <th>Description</th>
-    </tr>
-  </thead>
-  <tbody>
-    <tr>
-      <td><code>store</code></td>
-      <td><code>{'StoreApi<S>'}</code></td>
-      <td>Yes</td>
-      <td>A Zustand vanilla store (from <code>createStore</code> in <code>zustand/vanilla</code>).</td>
-    </tr>
-    <tr>
-      <td><code>selector</code></td>
-      <td><code>{'(state: S) => StateModel'}</code></td>
-      <td>No</td>
-      <td>Select the json-render slice from the store state. Defaults to the entire state.</td>
-    </tr>
-    <tr>
-      <td><code>updater</code></td>
-      <td><code>{'(nextState: StateModel, store: StoreApi<S>) => void'}</code></td>
-      <td>No</td>
-      <td>Apply a state change back to the store. Defaults to a shallow merge.</td>
-    </tr>
-  </tbody>
-</table>
-
-### Example
-
-```typescript
-import { createStore } from "zustand/vanilla";
-import { zustandStateStore } from "@json-render/zustand";
-import { StateProvider } from "@json-render/react";
-
-const bearStore = createStore(() => ({
-  count: 0,
-  name: "Bear",
-}));
-
-const store = zustandStateStore({ store: bearStore });
-```
-
-```tsx
-<StateProvider store={store}>
-  {/* json-render reads/writes go through Zustand */}
-</StateProvider>
-```
-
-### Nested Slice
-
-```typescript
-const appStore = createStore(() => ({
-  ui: { count: 0 },
-  auth: { token: null },
-}));
-
-const store = zustandStateStore({
-  store: appStore,
-  selector: (s) => s.ui,
-  updater: (next, s) => s.setState({ ui: next }),
-});
-```
-
-## Re-exports
-
-<table>
-  <thead>
-    <tr>
-      <th>Export</th>
-      <th>Source</th>
-    </tr>
-  </thead>
-  <tbody>
-    <tr>
-      <td><code>StateStore</code></td>
-      <td><code>@json-render/core</code></td>
-    </tr>
-  </tbody>
-</table>

apps/web/app/(main)/docs/catalog/page.mdx

@@ -1,5 +1,4 @@
-import { pageMetadata } from "@/lib/page-metadata"
-export const metadata = pageMetadata("docs/catalog")
+export const metadata = { title: "Catalog" }
 
 # Catalog
 
@@ -7,7 +6,7 @@ The catalog defines what AI can generate. It's your guardrail.
 
 ## What is a Catalog?
 
-A catalog is the vocabulary for your UI. While the [schema](/docs/schemas) defines the grammar (how specs are structured), the catalog defines the vocabulary (what components and actions are available). It lists:
+A catalog is a schema that defines:
 
 - **Components** — UI elements AI can create (with props and optional slots)
 - **Actions** — Operations AI can trigger
@@ -15,11 +14,9 @@ A catalog is the vocabulary for your UI. While the [schema](/docs/schemas) defin
 
 ## Creating a Catalog
 
-`defineCatalog` is from `@json-render/core`. The `schema` import comes from your platform package (`@json-render/react` or `@json-render/react-native`) and defines the element structure the catalog targets. The catalog definition itself is framework-agnostic.
-
 ```typescript
 import { defineCatalog } from '@json-render/core';
-import { schema } from '@json-render/react/schema'; // or '@json-render/react-native/schema'
+import { schema } from '@json-render/react';
 import { z } from 'zod';
 
 const catalog = defineCatalog(schema, {
@@ -38,7 +35,7 @@ const catalog = defineCatalog(schema, {
     Metric: {
       props: z.object({
         label: z.string(),
-        value: z.union([z.string(), z.number()]),
+        valuePath: z.string(), // JSON Pointer to data
         format: z.enum(['currency', 'percent', 'number']),
       }),
       description: "Display a single metric value",

apps/web/app/(main)/docs/changelog/page.mdx

@@ -1,482 +1,9 @@
-import { pageMetadata } from "@/lib/page-metadata"
-export const metadata = pageMetadata("docs/changelog")
+export const metadata = { title: "Changelog" }
 
 # Changelog
 
 Notable changes and updates to json-render.
 
-## v0.10.0
-
-February 2026
-
-### New: `@json-render/vue`
-
-Vue 3 renderer for json-render with full feature parity with `@json-render/react`. Data binding, visibility conditions, actions, validation, repeat scopes, streaming, and external store support.
-
-```bash
-npm install @json-render/core @json-render/vue
-```
-
-```typescript
-import { h } from "vue";
-import { defineRegistry, Renderer } from "@json-render/vue";
-import { schema } from "@json-render/vue/schema";
-
-const { registry } = defineRegistry(catalog, {
-  components: {
-    Card: ({ props, children }) =>
-      h("div", { class: "card" }, [h("h3", null, props.title), children]),
-    Button: ({ props, emit }) =>
-      h("button", { onClick: () => emit("press") }, props.label),
-  },
-});
-```
-
-Providers: `StateProvider`, `ActionProvider`, `VisibilityProvider`, `ValidationProvider`. Composables: `useStateStore`, `useStateValue`, `useActions`, `useAction`, `useIsVisible`, `useFieldValidation`, `useBoundProp`, `useUIStream`, `useChatUI`.
-
-See the [Vue API reference](/docs/api/vue) for details.
-
-### New: `@json-render/xstate`
-
-[XState Store](https://stately.ai/docs/xstate-store) (atom) adapter for json-render's `StateStore` interface. Wire an `@xstate/store` atom as the state backend for any renderer.
-
-```bash
-npm install @json-render/xstate @xstate/store
-```
-
-```typescript
-import { createAtom } from "@xstate/store";
-import { xstateStoreStateStore } from "@json-render/xstate";
-
-const atom = createAtom({ count: 0 });
-const store = xstateStoreStateStore({ atom });
-```
-
-Requires `@xstate/store` v3+.
-
-### New: `$computed` and `$template` Expressions
-
-Two new prop expression types for dynamic values:
-
-- **`$template`** -- interpolate state values into strings: `{ "$template": "Hello, ${/user/name}!" }`
-- **`$computed`** -- call registered functions: `{ "$computed": "fullName", "args": { "first": { "$state": "/form/firstName" } } }`
-
-Register functions via the `functions` prop on `JSONUIProvider` or `createRenderer`. See [Computed Values](/docs/computed-values) for details.
-
-### New: State Watchers
-
-Elements can declare a `watch` field to trigger actions when state values change. Useful for cascading dependencies like country/city selects.
-
-```json
-{
-  "type": "Select",
-  "props": { "value": { "$bindState": "/form/country" }, "options": ["US", "Canada"] },
-  "watch": {
-    "/form/country": { "action": "loadCities", "params": { "country": { "$state": "/form/country" } } }
-  }
-}
-```
-
-`watch` is a top-level field on elements (sibling of type/props/children), not inside props. Watchers only fire on value changes, not on initial render. See [Watchers](/docs/watchers) for details.
-
-### New: Cross-Field Validation
-
-New built-in validation functions for cross-field comparisons:
-
-- `equalTo` -- alias for `matches` with clearer semantics
-- `lessThan` -- value must be less than another field
-- `greaterThan` -- value must be greater than another field
-- `requiredIf` -- required only when a condition field is truthy
-
-Validation check args now resolve through `resolvePropValue`, so `$state` expressions work consistently.
-
-### New: `validateForm` Action
-
-Built-in action (React) that validates all registered form fields at once and writes `{ valid, errors }` to state:
-
-```json
-{
-  "on": {
-    "press": [
-      { "action": "validateForm", "params": { "statePath": "/formResult" } },
-      { "action": "submitForm" }
-    ]
-  }
-}
-```
-
-### Improved: shadcn/ui Validation
-
-All form components now support `checks` and `validateOn` props:
-- Checkbox, Radio, Switch added validation support
-- `validateOn` controls timing: `"change"` (default for Select, Checkbox, Radio, Switch), `"blur"` (default for Input, Textarea), or `"submit"`
-
-### New Examples
-
-- **Vue example** -- standalone Vue 3 app with custom components
-- **Vite Renderers** -- side-by-side React and Vue renderers with shared catalog
-
----
-
-## 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
-
-### New: `@json-render/react-pdf`
-
-PDF renderer for json-render, powered by [`@react-pdf/renderer`](https://react-pdf.org/). Define catalogs and registries the same way as `@json-render/react`, but output PDF documents instead of web UI.
-
-```bash
-npm install @json-render/core @json-render/react-pdf
-```
-
-```typescript
-import { renderToBuffer } from "@json-render/react-pdf";
-import type { Spec } from "@json-render/core";
-
-const spec: Spec = {
-  root: "doc",
-  elements: {
-    doc: { type: "Document", props: { title: "Invoice" }, children: ["page"] },
-    page: {
-      type: "Page",
-      props: { size: "A4" },
-      children: ["heading", "table"],
-    },
-    heading: {
-      type: "Heading",
-      props: { text: "Invoice #1234", level: "h1" },
-      children: [],
-    },
-    table: {
-      type: "Table",
-      props: {
-        columns: [
-          { header: "Item", width: "60%" },
-          { header: "Price", width: "40%", align: "right" },
-        ],
-        rows: [
-          ["Widget A", "$10.00"],
-          ["Widget B", "$25.00"],
-        ],
-      },
-      children: [],
-    },
-  },
-};
-
-const buffer = await renderToBuffer(spec);
-```
-
-Server-side rendering APIs:
-
-- `renderToBuffer(spec)` -- render to an in-memory PDF buffer
-- `renderToStream(spec)` -- render to a readable stream (pipe to HTTP response)
-- `renderToFile(spec, path)` -- render directly to a file
-
-15 standard components covering document structure (Document, Page), layout (View, Row, Column), content (Heading, Text, Image, Link), data (Table, List), decorative (Divider, Spacer), and page-level (PageNumber).
-
-Supports custom catalogs with `defineRegistry`, server-safe imports via `@json-render/react-pdf/server`, and full context support (state, visibility, actions, validation, repeat scopes).
-
----
-
-## v0.7.0
-
-February 2026
-
-### New: `@json-render/shadcn`
-
-Pre-built [shadcn/ui](https://ui.shadcn.com/) component library for json-render. 36 components built on Radix UI + Tailwind CSS, ready to use with `defineCatalog` and `defineRegistry`.
-
-```bash
-npm install @json-render/shadcn
-```
-
-```typescript
-import { defineCatalog } from "@json-render/core";
-import { schema } from "@json-render/react/schema";
-import { shadcnComponentDefinitions } from "@json-render/shadcn/catalog";
-import { defineRegistry } from "@json-render/react";
-import { shadcnComponents } from "@json-render/shadcn";
-
-const catalog = defineCatalog(schema, {
-  components: {
-    Card: shadcnComponentDefinitions.Card,
-    Button: shadcnComponentDefinitions.Button,
-    Input: shadcnComponentDefinitions.Input,
-  },
-  actions: {},
-});
-
-const { registry } = defineRegistry(catalog, {
-  components: {
-    Card: shadcnComponents.Card,
-    Button: shadcnComponents.Button,
-    Input: shadcnComponents.Input,
-  },
-});
-```
-
-Components include: layout (Card, Stack, Grid, Separator), navigation (Tabs, Accordion, Collapsible, Pagination), overlay (Dialog, Drawer, Tooltip, Popover, DropdownMenu), content (Heading, Text, Image, Avatar, Badge, Alert, Carousel, Table), feedback (Progress, Skeleton, Spinner), and input (Button, Link, Input, Textarea, Select, Checkbox, Radio, Switch, Slider, Toggle, ToggleGroup, ButtonGroup).
-
-See the [API reference](/docs/api/shadcn) for full details.
-
-### New: Event Handles (`on()`)
-
-Components now receive an `on(event)` function in addition to `emit(event)`. The `on()` function returns an `EventHandle` with metadata:
-
-- `emit()` -- fire the event
-- `shouldPreventDefault` -- whether any action binding requested `preventDefault`
-- `bound` -- whether any handler is bound to this event
-
-```tsx
-Link: ({ props, on }) => {
-  const click = on("click");
-  return (
-    <a href={props.href} onClick={(e) => {
-      if (click.shouldPreventDefault) e.preventDefault();
-      click.emit();
-    }}>{props.label}</a>
-  );
-},
-```
-
-### New: `BaseComponentProps`
-
-Catalog-agnostic base type for component render functions. Use when building reusable component libraries (like `@json-render/shadcn`) that are not tied to a specific catalog.
-
-```typescript
-import type { BaseComponentProps } from "@json-render/react";
-
-const Card = ({ props, children }: BaseComponentProps<{ title?: string }>) => (
-  <div>{props.title}{children}</div>
-);
-```
-
-### New: Built-in Actions in Schema
-
-Schemas can now declare `builtInActions` -- actions that are always available at runtime and automatically injected into prompts. The React schema declares `setState`, `pushState`, and `removeState` as built-in, so they appear in prompts without needing to be listed in catalog `actions`.
-
-### New: `preventDefault` on `ActionBinding`
-
-Action bindings now support a `preventDefault` boolean field, allowing the LLM to request that default browser behavior (e.g. navigation on links) be prevented.
-
-### Improved: Stream Transform Text Block Splitting
-
-`createJsonRenderTransform()` now properly splits text blocks around spec data by emitting `text-end`/`text-start` pairs. This ensures the AI SDK creates separate text parts, preserving correct interleaving of prose and UI in `message.parts`.
-
-### Improved: `defineRegistry` Actions Requirement
-
-`defineRegistry` now conditionally requires the `actions` field only when the catalog declares actions. Catalogs with no actions (e.g. `actions: {}`) no longer need to pass an empty actions object.
-
----
-
-## v0.6.0
-
-February 2026
-
-### New: Chat Mode (Inline GenUI)
-
-> **Note:** These modes were renamed in v0.12.1 — "Generate" is now "Standalone" and "Chat" is now "Inline". The old names are accepted as deprecated aliases.
-
-json-render now supports two generation modes: **Generate** (JSONL-only, the default) and **Chat** (text + JSONL inline). Chat mode lets the AI respond conversationally with embedded UI specs, ideal for chatbots and copilot experiences.
-
-```typescript
-// Generate mode (default) — AI outputs only JSONL
-const prompt = catalog.prompt();
-
-// Chat mode — AI outputs text + JSONL inline
-const chatPrompt = catalog.prompt({ mode: "chat" });
-```
-
-On the server, `pipeJsonRender()` separates text from JSONL patches in a mixed stream:
-
-```typescript
-import { pipeJsonRender } from "@json-render/core";
-import { createUIMessageStream, createUIMessageStreamResponse } from "ai";
-
-const stream = createUIMessageStream({
-  execute: async ({ writer }) => {
-    writer.merge(pipeJsonRender(result.toUIMessageStream()));
-  },
-});
-return createUIMessageStreamResponse({ stream });
-```
-
-On the client, `useJsonRenderMessage` extracts the spec and text from message parts:
-
-```tsx
-import { useJsonRenderMessage } from "@json-render/react";
-
-function ChatMessage({ message }) {
-  const { spec, text, hasSpec } = useJsonRenderMessage(message.parts);
-  return (
-    <div>
-      {text && <Markdown>{text}</Markdown>}
-      {hasSpec && <Renderer spec={spec} registry={registry} />}
-    </div>
-  );
-}
-```
-
-### New: AI SDK Integration
-
-First-class Vercel AI SDK support with typed data parts and stream utilities.
-
-- `SpecDataPart` type for `data-spec` stream parts (patch, flat, nested payloads)
-- `SPEC_DATA_PART` / `SPEC_DATA_PART_TYPE` constants for type-safe part filtering
-- `createJsonRenderTransform()` low-level TransformStream for custom pipelines
-- `createMixedStreamParser()` for parsing mixed text + JSONL streams
-
-### New: Two-Way Binding
-
-Props can now use `$bindState` and `$bindItem` expressions for two-way data binding. The renderer resolves bindings and passes a `bindings` map to components, enabling write-back to state without custom `valuePath` props.
-
-```json
-{
-  "type": "Input",
-  "props": { "label": "Email", "value": { "$bindState": "/form/email" } }
-}
-```
-
-```tsx
-import { useBoundProp } from "@json-render/react";
-
-Input: ({ props, bindings }) => {
-  const [value, setValue] = useBoundProp<string>(props.value, bindings?.value);
-  return <input value={value ?? ""} onChange={(e) => setValue(e.target.value)} />;
-}
-```
-
-### New: Expression-Based Props and Visibility
-
-All dynamic expressions now use structured `$state`, `$item`, and `$index` objects instead of string token rewriting. This is simpler, more explicit, and works for both props and visibility conditions.
-
-**Props:**
-
-```json
-{ "title": { "$state": "/user/name" } }
-{ "label": { "$item": "title" } }
-{ "position": { "$index": true } }
-```
-
-**Visibility:**
-
-```json
-{ "$state": "/isAdmin" }
-{ "$state": "/role", "eq": "admin" }
-[{ "$state": "/isAdmin" }, { "$state": "/feature" }]
-{ "$or": [{ "$state": "/roleA" }, { "$state": "/roleB" }] }
-{ "$item": "isActive" }
-{ "$index": true, "gt": 0 }
-```
-
-Comparison operators: `eq`, `neq`, `gt`, `gte`, `lt`, `lte`, `not`.
-
-### New: React Chat Hooks
-
-- `useChatUI()` — full chat hook with message history, streaming, and spec extraction
-- `useJsonRenderMessage()` — extract spec + text from a message's parts array
-- `buildSpecFromParts()` / `getTextFromParts()` — utilities for working with AI SDK message parts
-- `useBoundProp()` — two-way binding hook for `$bindState` / `$bindItem`
-
-### New: Chat Example
-
-Full-featured chat example (`examples/chat`) with AI agent, tool calls (crypto, GitHub, Hacker News, weather, search), theme toggle, and streaming inline UI generation.
-
-### Improved: Renderer Performance
-
-- `ElementRenderer` is now `React.memo`'d for better performance with repeat lists
-- `emit` is always defined (never `undefined`)
-- Repeat scope passes the actual item object, eliminating string token rewriting
-
-### Improved: Utilities
-
-- `applySpecPatch()` — typed wrapper for applying a single patch to a Spec
-- `nestedToFlat()` — convert nested tree specs to flat format
-- `resolveBindings()` / `resolveActionParam()` — resolve binding paths and action params
-
-### Breaking Changes
-
-- `{ $path }` and `{ path }` replaced by `{ $state }`, `{ $item }`, `{ $index }` in props
-- Visibility: `{ path }` -> `{ $state }`, `{ and/or/not }` -> `{ $and/$or }` with `not` as operator flag
-- `DynamicValue`: `{ path: string }` -> `{ $state: string }`
-- `repeat.path` -> `repeat.statePath`
-- Action params: `path` -> `statePath` in setState action
-- `actionHandlers` -> `handlers` on `JSONUIProvider` / `ActionProvider`
-- `AuthState` and `{ auth }` visibility conditions removed (model auth as regular state)
-- Legacy catalog API removed: `createCatalog`, `generateCatalogPrompt`, `generateSystemPrompt`
-- React exports removed: `createRendererFromCatalog`, `rewriteRepeatTokens`
-- Codegen: `traverseTree` -> `traverseSpec`
-
-See the [Migration Guide](/docs/migration) for detailed upgrade instructions.
-
----
-
 ## v0.5.0
 
 February 2026
@@ -513,7 +40,7 @@ Components now use `emit` to fire named events instead of directly dispatching a
 ```tsx
 // Component emits a named event
 Button: ({ props, emit }) => (
-  <button onClick={() => emit("press")}>{props.label}</button>
+  <button onClick={() => emit?.("press")}>{props.label}</button>
 ),
 
 // Element spec maps events to actions
@@ -526,12 +53,12 @@ Button: ({ props, emit }) => (
 
 ### New: Repeat/List Rendering
 
-Elements can now iterate over state arrays using the `repeat` field. Child elements use `{ "$item": "field" }` to read from the current item and `{ "$index": true }` for the current array index.
+Elements can now iterate over state arrays using the `repeat` field. Child elements use `$item` and `$index` tokens in `$path` expressions to reference the current item.
 
 ```json
 {
   "type": "Column",
-  "repeat": { "statePath": "/posts", "key": "id" },
+  "repeat": { "path": "/posts", "key": "id" },
   "children": ["post-card"]
 }
 ```
@@ -539,7 +66,7 @@ Elements can now iterate over state arrays using the `repeat` field. Child eleme
 ```json
 {
   "type": "Card",
-  "props": { "title": { "$item": "title" } }
+  "props": { "title": { "$path": "$item/title" } }
 }
 ```
 
@@ -567,13 +94,13 @@ Validate spec structure and auto-fix common issues:
 ```typescript
 import { validateSpec, autoFixSpec } from "@json-render/core";
 
-const { valid, issues } = validateSpec(spec);
+const { valid, issues } = validateSpec(spec, catalog);
 const fixed = autoFixSpec(spec);
 ```
 
 ### Improved: State Management
 
-`DataProvider` has been renamed to `StateProvider` with a clearer API. State is now a first-class part of specs. Elements can bind to state via `$state` expressions, and the built-in `setState` action updates state directly.
+`DataProvider` has been renamed to `StateProvider` with a clearer API. State is now a first-class part of specs. Elements can bind to state via `$path` expressions, and the built-in `setState` action updates state directly.
 
 ### Improved: AI Prompts
 

apps/web/app/(main)/docs/code-export/page.mdx

@@ -1,5 +1,4 @@
-import { pageMetadata } from "@/lib/page-metadata"
-export const metadata = pageMetadata("docs/code-export")
+export const metadata = { title: "Code Export" }
 
 # Code Export
 
@@ -71,12 +70,12 @@ The exported components are standalone with no json-render dependencies. They re
 // Generated component (standalone)
 interface MetricProps {
   label: string;
-  statePath: string;
+  valuePath: string;
   data?: Record<string, unknown>;
 }
 
-export function Metric({ label, statePath, data }: MetricProps) {
-  const value = data ? getByPath(data, statePath) : undefined;
+export function Metric({ label, valuePath, data }: MetricProps) {
+  const value = data ? getByPath(data, valuePath) : undefined;
   return (
     <div>
       <span>{label}</span>
@@ -93,8 +92,8 @@ export function Metric({ label, statePath, data }: MetricProps) {
 ```typescript
 import { traverseSpec } from '@json-render/codegen';
 
-traverseSpec(spec, (element, key, depth, parent) => {
-  console.log(' '.repeat(depth * 2) + `${key}: ${element.type}`);
+traverseSpec(spec, (element, depth, parent) => {
+  console.log(' '.repeat(depth * 2) + element.type);
 });
 ```
 
@@ -135,6 +134,6 @@ Run the dashboard example and click "Export Project" to see code generation in a
 ```bash
 cd examples/dashboard
 pnpm dev
-# Open http://dashboard-demo.json-render.localhost:1355
+# Open http://localhost:3001
 # Generate a widget, then click "Export Project"
 ```

apps/web/app/(main)/docs/computed-values/page.mdx

@@ -1,119 +0,0 @@
-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

apps/web/app/(main)/docs/custom-schema/page.mdx

@@ -1,5 +1,4 @@
-import { pageMetadata } from "@/lib/page-metadata"
-export const metadata = pageMetadata("docs/custom-schema")
+export const metadata = { title: "Custom Schema & Renderer" }
 
 # Custom Schema & Renderer
 
@@ -42,13 +41,13 @@ Start by defining the JSON structure your system will use. Here's an example of
 
 ## 2. Create the Catalog
 
-Define a catalog that describes your components and validates props using `defineCatalog` — see [Catalog](/docs/catalog).
+Define a catalog that describes your components and validates props:
 
 ```typescript
-import { defineCatalog } from '@json-render/core';
+import { createCatalog } from '@json-render/core';
 import { z } from 'zod';
 
-export const dashboardCatalog = defineCatalog(mySchema, {
+export const dashboardCatalog = createCatalog({
   components: {
     metric: {
       description: 'Displays a single metric value',
@@ -241,9 +240,11 @@ const response = await generateText({
 
 ## 6. Validate Specs
 
-Validate incoming specs against your schema. Use `catalog.validate()` to check AI output against the catalog's Zod schema:
+Validate incoming specs against your schema:
 
 ```typescript
+import { validate } from '@json-render/core';
+
 function validateDashboard(spec: unknown) {
   // Validate root structure
   const rootResult = DashboardSchema.safeParse(spec);
@@ -251,13 +252,19 @@ function validateDashboard(spec: unknown) {
     return { valid: false, errors: rootResult.error.errors };
   }
 
-  // Validate each widget's props against the catalog
-  const result = dashboardCatalog.validate(spec);
-  if (!result.success) {
-    return { valid: false, errors: result.error.errors };
+  // Validate each widget against catalog
+  const errors: string[] = [];
+  for (const widget of rootResult.data.widgets) {
+    const result = validate(
+      { type: widget.type, props: widget },
+      dashboardCatalog
+    );
+    if (!result.valid) {
+      errors.push(...result.errors.map(e => `${widget.type}: ${e}`));
+    }
   }
 
-  return { valid: true, errors: [] };
+  return { valid: errors.length === 0, errors };
 }
 ```
 

apps/web/app/(main)/docs/data-binding/page.mdx

@@ -1,311 +1,124 @@
-import { pageMetadata } from "@/lib/page-metadata"
-export const metadata = pageMetadata("docs/data-binding")
+export const metadata = { title: "Data Binding" }
 
 # Data Binding
 
-Connect UI elements to dynamic data using expressions in your JSON specs.
-
-## State Model
-
-Every spec can include a `state` object that holds the data your UI reads from:
-
-```json
-{
-  "root": "greeting",
-  "elements": {
-    "greeting": {
-      "type": "Text",
-      "props": { "content": { "$state": "/user/name" } },
-      "children": []
-    }
-  },
-  "state": {
-    "user": { "name": "Alice" }
-  }
-}
-```
-
-State can also be provided programmatically at runtime. In `@json-render/react`, this is done via `StateProvider` and hooks like `useStateStore`. See the [React API reference](/docs/api/react) for details.
+Connect UI components to your application data using JSON Pointer paths.
 
 ## JSON Pointer Paths
 
-All paths in json-render follow JSON Pointer (RFC 6901). A path is a string of `/`-separated tokens starting from the root:
+json-render uses JSON Pointer (RFC 6901) for data paths:
 
-```
-Given this state:
+```json
+// Given this data:
 {
-  "user": { "name": "Alice", "email": "alice@example.com" },
-  "todos": [
-    { "title": "Buy milk", "done": false },
-    { "title": "Walk dog", "done": true }
-  ]
+  "user": {
+    "name": "Alice",
+    "email": "alice@example.com"
+  },
+  "metrics": {
+    "revenue": 125000,
+    "growth": 0.15
+  }
 }
 
-"/user/name"      -> "Alice"
-"/user/email"     -> "alice@example.com"
-"/todos/0/title"  -> "Buy milk"
-"/todos/1/done"   -> true
+// These paths access:
+"/user/name"        -> "Alice"
+"/metrics/revenue"  -> 125000
+"/metrics/growth"   -> 0.15
 ```
 
-## Expressions
+## StateProvider
 
-Expressions are special objects you place in props to read dynamic values instead of hardcoding them. There are six expression types.
+Wrap your app with StateProvider to enable data binding:
 
-### `$state` — Read from state
+```tsx
+import { StateProvider } from '@json-render/react';
 
-Use `{ "$state": "/path" }` in any prop to read a value from the state model:
+function App() {
+  const initialState = {
+    user: { name: 'Alice' },
+    form: { email: '', message: '' },
+  };
+
+  return (
+    <StateProvider initialState={initialState}>
+      {/* Your UI */}
+    </StateProvider>
+  );
+}
+```
+
+## Reading Data
+
+Use `useStateValue` for read-only access:
+
+```tsx
+import { useStateValue } from '@json-render/react';
+
+function UserGreeting() {
+  const name = useStateValue('/user/name');
+  return <h1>Hello, {name}!</h1>;
+}
+```
+
+## Two-Way Binding
+
+Use `useStateBinding` for read-write access:
+
+```tsx
+import { useStateBinding } from '@json-render/react';
+
+function EmailInput() {
+  const [email, setEmail] = useStateBinding('/form/email');
+  
+  return (
+    <input
+      type="email"
+      value={email || ''}
+      onChange={(e) => setEmail(e.target.value)}
+    />
+  );
+}
+```
+
+## Using the State Context
+
+Access the full state context for advanced use cases:
+
+```tsx
+import { useStateStore } from '@json-render/react';
+
+function StateDebugger() {
+  const { data, setState, getValue, setValue } = useStateStore();
+  
+  // Read any path
+  const revenue = getValue('/metrics/revenue');
+  
+  // Write any path
+  const updateRevenue = () => setValue('/metrics/revenue', 150000);
+  
+  // Replace all state
+  const resetState = () => setState({ user: {}, form: {} });
+  
+  return <pre>{JSON.stringify(data, null, 2)}</pre>;
+}
+```
+
+## In JSON UI Trees
+
+AI can reference data paths in component props:
 
 ```json
 {
-  "type": "Card",
+  "type": "Metric",
   "props": {
-    "title": { "$state": "/user/name" },
-    "subtitle": { "$state": "/user/email" }
-  },
-  "children": []
-}
-```
-
-If state contains `{ "user": { "name": "Alice", "email": "alice@example.com" } }`, the Card renders with title "Alice" and subtitle "alice@example.com".
-
-### `$item` — Read from the current repeat item
-
-Use `{ "$item": "field" }` inside a [repeat](#repeat) to read a field from the current array item:
-
-```json
-{
-  "type": "Text",
-  "props": { "content": { "$item": "title" } },
-  "children": []
-}
-```
-
-Use `{ "$item": "" }` to get the entire item object.
-
-### `$index` — Current repeat index
-
-Use `{ "$index": true }` inside a [repeat](#repeat) to get the current array index (zero-based number):
-
-```json
-{
-  "type": "Text",
-  "props": { "content": { "$index": true } },
-  "children": []
-}
-```
-
-## Repeat
-
-The `repeat` field on an element renders its children once per item in a state array. It is a top-level field on the element, sibling of `type`, `props`, and `children` — not inside `props`.
-
-```json
-{
-  "root": "todo-list",
-  "elements": {
-    "todo-list": {
-      "type": "Column",
-      "props": { "gap": 8 },
-      "repeat": { "statePath": "/todos", "key": "id" },
-      "children": ["todo-item"]
-    },
-    "todo-item": {
-      "type": "Card",
-      "props": {
-        "title": { "$item": "title" },
-        "subtitle": { "$item": "description" }
-      },
-      "children": []
-    }
-  },
-  "state": {
-    "todos": [
-      { "id": "1", "title": "Buy milk", "description": "2% or whole" },
-      { "id": "2", "title": "Walk dog", "description": "Around the park" }
-    ]
+    "label": "Total Revenue",
+    "valuePath": "/metrics/revenue",
+    "format": "currency"
   }
 }
 ```
 
-- `repeat.statePath` — JSON Pointer to the state array
-- `repeat.key` — field name on each item to use as a stable key for rendering
-
-Inside `todo-item`, `{ "$item": "title" }` reads the `title` field from whichever array item is currently being rendered. `{ "$index": true }` would return `0` for the first item, `1` for the second, and so on.
-
-## Two-Way Binding with `$bindState`
-
-Form components use `{ "$bindState": "/path" }` on their natural value prop for two-way binding. The component reads from and writes to the state path.
-
-### Value prop (text inputs)
-
-```json
-{
-  "type": "TextInput",
-  "props": {
-    "value": { "$bindState": "/form/email" },
-    "placeholder": "Enter your email"
-  },
-  "children": []
-}
-```
-
-### Checked prop (switches, checkboxes)
-
-```json
-{
-  "type": "Switch",
-  "props": {
-    "label": "Enable notifications",
-    "checked": { "$bindState": "/settings/notifications" }
-  },
-  "children": []
-}
-```
-
-### Pressed prop (toggle buttons)
-
-```json
-{
-  "type": "ToggleButton",
-  "props": {
-    "label": "Bold",
-    "pressed": { "$bindState": "/editor/bold" }
-  },
-  "children": []
-}
-```
-
-## Two-Way Binding with `$bindItem`
-
-Inside a repeat scope, use `{ "$bindItem": "field" }` to bind to a field on the current item:
-
-```json
-{
-  "type": "Switch",
-  "props": {
-    "label": "Done",
-    "checked": { "$bindItem": "completed" }
-  },
-  "children": []
-}
-```
-
-Use `{ "$bindItem": "" }` to bind to the entire item.
-
-`statePath` is not used for component binding. It remains for `repeat.statePath` (array iteration path) and action params like `setState.statePath` (target path for mutations).
-
-## Conditional Props
-
-Use `$cond` / `$then` / `$else` to pick a prop value based on a condition:
-
-```json
-{
-  "type": "Badge",
-  "props": {
-    "label": {
-      "$cond": { "$state": "/user/isAdmin" },
-      "$then": "Admin",
-      "$else": "Member"
-    }
-  },
-  "children": []
-}
-```
-
-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">
-  <table className="mdx-table w-full text-sm border-collapse">
-    <thead>
-      <tr>
-        <th>Expression</th>
-        <th>Syntax</th>
-        <th>Context</th>
-      </tr>
-    </thead>
-    <tbody>
-      <tr>
-        <td><code>{"$state"}</code></td>
-        <td><code>{'{ "$state": "/path" }'}</code></td>
-        <td>Anywhere</td>
-      </tr>
-      <tr>
-        <td><code>{"$item"}</code></td>
-        <td><code>{'{ "$item": "field" }'}</code></td>
-        <td>Inside repeat only</td>
-      </tr>
-      <tr>
-        <td><code>{"$index"}</code></td>
-        <td><code>{'{ "$index": true }'}</code></td>
-        <td>Inside repeat only</td>
-      </tr>
-      <tr>
-        <td><code>{"$cond"}</code></td>
-        <td><code>{'{ "$cond": ..., "$then": ..., "$else": ... }'}</code></td>
-        <td>Anywhere</td>
-      </tr>
-      <tr>
-        <td><code>{"$bindState"}</code></td>
-        <td><code>{'{ "$bindState": "/path" }'}</code></td>
-        <td>Form components (value, checked, pressed)</td>
-      </tr>
-      <tr>
-        <td><code>{"$bindItem"}</code></td>
-        <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
-- [Action handlers](/docs/registry#action-handlers) — respond to user interactions
-- [React API reference](/docs/api/react) — React-specific hooks for programmatic state access
+Learn about [actions](/docs/actions) for user interactions.

apps/web/app/(main)/docs/generation-modes/page.mdx

@@ -1,222 +0,0 @@
-import { pageMetadata } from "@/lib/page-metadata"
-export const metadata = pageMetadata("docs/generation-modes")
-
-# Generation Modes
-
-json-render supports two modes for AI-generated UI: **Standalone mode** for standalone UI and **Inline mode** for inline UI within a conversation.
-
-The mode controls how the AI formats its output and how your app processes the stream. The underlying JSONL patch format is the same in both modes.
-
-<GenerationModesDiagram />
-
-## Standalone Mode
-
-In standalone mode, the AI outputs **only JSONL patches** — no prose, no markdown. The entire response is a UI spec.
-
-This is the default mode and is ideal for:
-
-- Playground and builder tools
-- Form generators
-- Dashboard builders
-- Any UI where the generated interface is the whole response
-
-### Setup
-
-```typescript
-import { streamText } from "ai";
-
-// Standalone mode is the default (no mode option needed)
-const systemPrompt = catalog.prompt({
-  customRules: [
-    "Use Card as root for forms and small UIs.",
-    "Use Grid for multi-column layouts.",
-  ],
-});
-
-const result = streamText({
-  model: "anthropic/claude-haiku-4.5",
-  system: systemPrompt,
-  prompt: userPrompt,
-});
-```
-
-### Client
-
-On the client, use `useUIStream` from `@json-render/react` or the lower-level `createSpecStreamCompiler` from `@json-render/core` to compile the JSONL stream into a spec:
-
-```tsx
-import { useUIStream } from "@json-render/react";
-
-function Playground() {
-  const { spec, isStreaming, send } = useUIStream({
-    api: "/api/generate",
-  });
-
-  return (
-    <Renderer
-      spec={spec}
-      registry={registry}
-      loading={isStreaming}
-    />
-  );
-}
-```
-
-### Example output
-
-The AI outputs only JSONL — one patch per line, no surrounding text:
-
-```
-{"op":"add","path":"/root","value":"card-1"}
-{"op":"add","path":"/elements/card-1","value":{"type":"Card","props":{"title":"Sign In"},"children":["email","password","submit"]}}
-{"op":"add","path":"/elements/email","value":{"type":"Input","props":{"label":"Email","name":"email","type":"email"}}}
-{"op":"add","path":"/elements/password","value":{"type":"Input","props":{"label":"Password","name":"password","type":"password"}}}
-{"op":"add","path":"/elements/submit","value":{"type":"Button","props":{"label":"Sign In"}}}
-```
-
-## Inline Mode
-
-In inline mode, the AI responds **conversationally first**, then outputs JSONL patches on their own lines. Text-only replies are allowed when no UI is needed (e.g. greetings, clarifying questions).
-
-This is ideal for:
-
-- AI chatbots with rich UI responses
-- Copilot experiences
-- Educational assistants
-- Any conversational interface where generated UI is embedded in chat messages
-
-### Setup
-
-```typescript
-import { streamText } from "ai";
-import { pipeJsonRender } from "@json-render/core";
-import { createUIMessageStream, createUIMessageStreamResponse } from "ai";
-
-// Enable inline mode
-const systemPrompt = catalog.prompt({ mode: "inline" });
-
-const result = streamText({
-  model: yourModel,
-  system: systemPrompt,
-  messages,
-});
-
-// In your API route, pipe the stream through pipeJsonRender
-// to separate text from JSONL patches
-const stream = createUIMessageStream({
-  execute: async ({ writer }) => {
-    writer.merge(pipeJsonRender(result.toUIMessageStream()));
-  },
-});
-
-return createUIMessageStreamResponse({ stream });
-```
-
-`pipeJsonRender` inspects each line of the AI's response. Lines that parse as JSONL patches are emitted as `data-spec` parts (which the renderer picks up). Everything else is passed through as text.
-
-### Client
-
-On the client, use `useJsonRenderMessage` from `@json-render/react` to extract the spec from a chat message's parts:
-
-```tsx
-import { useChat } from "@ai-sdk/react";
-import { useJsonRenderMessage } from "@json-render/react";
-
-function Chat() {
-  const { messages, input, handleInputChange, handleSubmit } = useChat();
-
-  return (
-    <div>
-      {messages.map((msg) => (
-        <ChatMessage key={msg.id} message={msg} />
-      ))}
-      {/* input form */}
-    </div>
-  );
-}
-
-function ChatMessage({ message }) {
-  const { spec } = useJsonRenderMessage(message.parts);
-
-  return (
-    <div>
-      {/* Render text parts */}
-      {message.parts
-        .filter((p) => p.type === "text")
-        .map((p, i) => <p key={i}>{p.text}</p>)}
-
-      {/* Render the generated UI inline */}
-      {spec && (
-        <Renderer
-          spec={spec}
-          registry={registry}
-        />
-      )}
-    </div>
-  );
-}
-```
-
-### Example output
-
-The AI writes a brief explanation, then JSONL patches on their own lines:
-
-```
-Here's a dashboard showing the latest crypto prices:
-
-{"op":"add","path":"/root","value":"dashboard"}
-{"op":"add","path":"/state/prices","value":[{"name":"Bitcoin","price":98450},{"name":"Ethereum","price":3120}]}
-{"op":"add","path":"/elements/dashboard","value":{"type":"Grid","props":{"columns":"2"},"children":["btc","eth"]}}
-{"op":"add","path":"/elements/btc","value":{"type":"Metric","props":{"label":"Bitcoin","value":{"$state":"/prices/0/price"}}}}
-{"op":"add","path":"/elements/eth","value":{"type":"Metric","props":{"label":"Ethereum","value":{"$state":"/prices/1/price"}}}}
-```
-
-If the user asks a simple question ("what does BTC stand for?"), the AI replies with text only — no JSONL.
-
-## Quick Comparison
-
-<div className="my-6 overflow-x-auto">
-  <table className="mdx-table w-full text-sm border-collapse">
-    <thead>
-      <tr>
-        <th />
-        <th>Standalone</th>
-        <th>Inline</th>
-      </tr>
-    </thead>
-    <tbody>
-      <tr>
-        <td>Output format</td>
-        <td>JSONL only</td>
-        <td>Text + JSONL</td>
-      </tr>
-      <tr>
-        <td>Text-only replies</td>
-        <td>No</td>
-        <td>Yes</td>
-      </tr>
-      <tr>
-        <td>System prompt</td>
-        <td><code>{"catalog.prompt()"}</code></td>
-        <td><code>{'catalog.prompt({ mode: "inline" })'}</code></td>
-      </tr>
-      <tr>
-        <td>Stream utility</td>
-        <td><code>{"useUIStream"}</code></td>
-        <td><code>{"pipeJsonRender"}</code>{" + "}<code>{"useJsonRenderMessage"}</code></td>
-      </tr>
-      <tr>
-        <td>Typical use case</td>
-        <td>Playground, builders</td>
-        <td>Chatbots, copilots</td>
-      </tr>
-    </tbody>
-  </table>
-</div>
-
-Both modes use the same JSONL patch format (RFC 6902) and the same catalog/registry system. The only difference is whether the AI is allowed to include prose alongside the patches.
-
-## Next
-
-- Learn about the [JSONL streaming format](/docs/streaming)
-- See the [AI SDK integration](/docs/ai-sdk) for setup with the Vercel AI SDK

apps/web/app/(main)/docs/installation/page.mdx

@@ -1,5 +1,4 @@
-import { pageMetadata } from "@/lib/page-metadata"
-export const metadata = pageMetadata("docs/installation")
+export const metadata = { title: "Installation" }
 
 # Installation
 
@@ -9,34 +8,6 @@ Install the core package plus your renderer of choice.
 
 <PackageInstall packages="@json-render/core @json-render/react" />
 
-Peer dependencies: `react ^19.0.0` and `zod ^4.0.0`.
-
-<PackageInstall packages="react zod" />
-
-## For Vue
-
-<PackageInstall packages="@json-render/core @json-render/vue" />
-
-Peer dependencies: `vue ^3.5.0` and `zod ^4.0.0`.
-
-<PackageInstall packages="vue zod" />
-
-## For Svelte
-
-<PackageInstall packages="@json-render/core @json-render/svelte" />
-
-Peer dependencies: `svelte ^5.0.0` and `zod ^4.0.0`.
-
-<PackageInstall packages="svelte zod" />
-
-## For React UI with shadcn/ui
-
-Pre-built components for fast prototyping and production use:
-
-<PackageInstall packages="@json-render/core @json-render/react @json-render/shadcn" />
-
-Requires Tailwind CSS in your project. See the [@json-render/shadcn API reference](/docs/api/shadcn) for usage.
-
 ## For React Native
 
 <PackageInstall packages="@json-render/core @json-render/react-native" />
@@ -45,23 +16,14 @@ 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 React Email
+## Peer Dependencies
 
-<PackageInstall packages="@json-render/core @json-render/react-email @react-email/components @react-email/render" />
+json-render requires the following peer dependencies:
 
-## For External State Management (Optional)
+- `react` ^19.0.0
+- `zod` ^4.0.0
 
-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" />
-
-<PackageInstall packages="@json-render/xstate" />
-
-See the [Data Binding](/docs/data-binding#external-store-controlled-mode) guide for usage.
+<PackageInstall packages="react zod" />
 
 ## For AI Integration
 

apps/web/app/(main)/docs/layout.tsx

@@ -1,6 +1,7 @@
 import { DocsMobileNav } from "@/components/docs-mobile-nav";
 import { DocsSidebar } from "@/components/docs-sidebar";
 import { CopyPageButton } from "@/components/copy-page-button";
+import { DocsChat } from "@/components/docs-chat";
 
 export default function DocsLayout({
   children,
@@ -24,6 +25,7 @@ export default function DocsLayout({
           <article>{children}</article>
         </div>
       </div>
+      <DocsChat />
     </>
   );
 }

apps/web/app/(main)/docs/migration/page.mdx

@@ -1,503 +0,0 @@
-import { pageMetadata } from "@/lib/page-metadata"
-export const metadata = pageMetadata("docs/migration")
-
-# Migration Guide
-
-This guide covers breaking changes introduced in v0.6.0 and how to update your code.
-
-## State Provider
-
-`DataProvider` has been renamed to `StateProvider`, and its props have changed.
-
-**Before:**
-
-```tsx
-import { DataProvider } from "@json-render/react";
-
-<DataProvider data={myData} getValue={getter} setValue={setter}>
-  {children}
-</DataProvider>
-```
-
-**After:**
-
-```tsx
-import { StateProvider } from "@json-render/react";
-
-<StateProvider initialState={myData} onStateChange={(path, value) => console.log(path, value)}>
-  {children}
-</StateProvider>
-```
-
-`StateProvider` now manages state internally. Use `useStateStore()` to access `get`, `set`, and `update`.
-
-<table>
-<thead>
-<tr>
-<th>Before</th>
-<th>After</th>
-</tr>
-</thead>
-<tbody>
-<tr><td><code>DataProvider</code></td><td><code>StateProvider</code></td></tr>
-<tr><td><code>data</code> prop</td><td><code>initialState</code> prop</td></tr>
-<tr><td><code>getValue</code> / <code>setValue</code> props</td><td>Removed (use <code>useStateStore()</code> hook for <code>get</code> / <code>set</code>)</td></tr>
-<tr><td><code>useData</code></td><td><code>useStateStore</code></td></tr>
-<tr><td><code>useDataValue</code></td><td><code>useStateValue</code></td></tr>
-<tr><td><code>useDataBinding</code></td><td><code>useStateBinding</code> (deprecated, use <code>useBoundProp</code> instead)</td></tr>
-<tr><td><code>DataModel</code> type</td><td><code>StateModel</code> type</td></tr>
-</tbody>
-</table>
-
-## Dynamic Expressions
-
-All dynamic value expressions have been renamed to use `$state`, `$item`, and `$index`.
-
-**Before:**
-
-```json
-{
-  "type": "Text",
-  "props": {
-    "label": { "$path": "/user/name" },
-    "count": { "$data": "/items/length" }
-  }
-}
-```
-
-**After:**
-
-```json
-{
-  "type": "Text",
-  "props": {
-    "label": { "$state": "/user/name" },
-    "count": { "$state": "/items/length" }
-  }
-}
-```
-
-Inside repeat scopes, use `$item` and `$index`:
-
-```json
-{
-  "type": "Card",
-  "props": {
-    "title": { "$item": "name" },
-    "subtitle": { "$index": true }
-  }
-}
-```
-
-<table>
-<thead>
-<tr>
-<th>Before</th>
-<th>After</th>
-</tr>
-</thead>
-<tbody>
-<tr><td><code>{'{ "$path": "/..." }'}</code></td><td><code>{'{ "$state": "/..." }'}</code></td></tr>
-<tr><td><code>{'{ "$data": "/..." }'}</code></td><td><code>{'{ "$state": "/..." }'}</code></td></tr>
-</tbody>
-</table>
-
-## Two-Way Binding
-
-Form components no longer use `valuePath` / `statePath` props. Instead, use `$bindState` expressions on the value prop, and `useBoundProp` in your registry.
-
-**Before (catalog):**
-
-```typescript
-Input: {
-  props: z.object({
-    label: z.string(),
-    valuePath: z.string(),
-    placeholder: z.string().optional(),
-  }),
-}
-```
-
-**Before (spec):**
-
-```json
-{
-  "type": "Input",
-  "props": { "label": "Email", "valuePath": "/form/email" }
-}
-```
-
-**Before (registry):**
-
-```tsx
-Input: ({ props }) => {
-  const [value, setValue] = useStateBinding(props.valuePath);
-  return <input value={value ?? ""} onChange={(e) => setValue(e.target.value)} />;
-}
-```
-
-**After (catalog):**
-
-```typescript
-Input: {
-  props: z.object({
-    label: z.string(),
-    value: z.string().optional(),
-    placeholder: z.string().optional(),
-  }),
-}
-```
-
-**After (spec):**
-
-```json
-{
-  "type": "Input",
-  "props": { "label": "Email", "value": { "$bindState": "/form/email" } }
-}
-```
-
-**After (registry):**
-
-```tsx
-Input: ({ props, bindings }) => {
-  const [value, setValue] = useBoundProp<string>(props.value, bindings?.value);
-  return <input value={value ?? ""} onChange={(e) => setValue(e.target.value)} />;
-}
-```
-
-`$bindState` reads from and writes to the given state path. Inside repeat scopes, use `$bindItem` to bind to a field on the current item:
-
-```json
-{
-  "type": "Checkbox",
-  "props": { "checked": { "$bindItem": "completed" } }
-}
-```
-
-## Visibility Conditions
-
-Visibility conditions have been renamed to use `$state`, `$and`, and `$or`.
-
-**Before:**
-
-```json
-{ "path": "/isAdmin" }
-{ "eq": [{ "path": "/role" }, "admin"] }
-{ "and": [{ "path": "/isAdmin" }, { "path": "/feature" }] }
-{ "or": [{ "path": "/roleA" }, { "path": "/roleB" }] }
-```
-
-**After:**
-
-```json
-{ "$state": "/isAdmin" }
-{ "$state": "/role", "eq": "admin" }
-{ "$and": [{ "$state": "/isAdmin" }, { "$state": "/feature" }] }
-{ "$or": [{ "$state": "/roleA" }, { "$state": "/roleB" }] }
-```
-
-You can also use an array as shorthand for `$and`:
-
-```json
-[{ "$state": "/isAdmin" }, { "$state": "/feature" }]
-```
-
-Inside repeat scopes, use `$item` and `$index`:
-
-```json
-{ "$item": "isActive" }
-{ "$index": true, "eq": 0 }
-```
-
-## Event System
-
-Components now use `emit` to fire named events. `onAction` has been removed.
-
-**Before:**
-
-```tsx
-Button: ({ props, onAction }) => (
-  <button onClick={() => onAction?.("press")}>{props.label}</button>
-)
-```
-
-**After:**
-
-```tsx
-Button: ({ props, emit }) => (
-  <button onClick={() => emit("press")}>{props.label}</button>
-)
-```
-
-`emit` is always defined (never `undefined`), so optional chaining is not needed.
-
-## Actions Context
-
-`dispatch` has been renamed to `execute`, and the provider prop has been renamed from `actionHandlers` to `handlers`.
-
-**Before:**
-
-```tsx
-const { dispatch } = useActions();
-dispatch({ action: "submit", params: {} });
-
-<ActionProvider actionHandlers={myHandlers}>
-```
-
-**After:**
-
-```tsx
-const { execute } = useActions();
-execute({ action: "submit", params: {} });
-
-<ActionProvider handlers={myHandlers}>
-```
-
-## Repeat / List Rendering
-
-The `repeat` field now uses `statePath` instead of `path`.
-
-**Before:**
-
-```json
-{
-  "type": "Column",
-  "repeat": { "path": "/todos", "key": "id" },
-  "children": ["todo-item"]
-}
-```
-
-**After:**
-
-```json
-{
-  "type": "Column",
-  "repeat": { "statePath": "/todos", "key": "id" },
-  "children": ["todo-item"]
-}
-```
-
-## Catalog Creation
-
-`createCatalog` and `generateSystemPrompt` have been replaced by `defineSchema` + `defineCatalog`.
-
-**Before:**
-
-```typescript
-import { createCatalog, generateSystemPrompt } from "@json-render/core";
-
-const catalog = createCatalog({
-  name: "my-app",
-  components: { /* ... */ },
-  actions: { /* ... */ },
-});
-
-const prompt = generateSystemPrompt(catalog);
-```
-
-**After:**
-
-```typescript
-import { defineCatalog } from "@json-render/core";
-import { schema } from "@json-render/react/schema";
-
-const catalog = defineCatalog(schema, {
-  components: { /* ... */ },
-  actions: { /* ... */ },
-});
-
-const prompt = catalog.prompt();
-
-// Inline mode prompt (formerly "chat")
-const inlinePrompt = catalog.prompt({ mode: "inline" });
-```
-
-## Generation Modes
-
-The generation mode values passed to `catalog.prompt()` have been renamed for clarity:
-
-- `"generate"` is now `"standalone"`
-- `"chat"` is now `"inline"`
-
-The old names are accepted as deprecated aliases, so existing code will continue to work. Update when convenient.
-
-**Before:**
-
-```typescript
-const prompt = catalog.prompt({ mode: "generate" });
-const chatPrompt = catalog.prompt({ mode: "chat" });
-```
-
-**After:**
-
-```typescript
-const prompt = catalog.prompt({ mode: "standalone" });
-const inlinePrompt = catalog.prompt({ mode: "inline" });
-```
-
-The default mode (when no `mode` option is provided) is `"standalone"`, which behaves identically to the previous `"generate"` default.
-
-## Validation
-
-`ValidationCheck` now uses `type` instead of `fn`, `ValidationProvider` uses `customFunctions` instead of `functions`, and `useFieldValidation` takes a config object instead of a checks array.
-
-**Before:**
-
-```json
-{ "fn": "required", "message": "Required" }
-{ "fn": "minLength", "args": { "length": 8 }, "message": "Too short" }
-```
-
-**After:**
-
-```json
-{ "type": "required", "message": "Required" }
-{ "type": "minLength", "args": { "min": 8 }, "message": "Too short" }
-```
-
-<table>
-<thead>
-<tr>
-<th>Before</th>
-<th>After</th>
-</tr>
-</thead>
-<tbody>
-<tr><td><code>{'{ fn: "required" }'}</code></td><td><code>{'{ type: "required" }'}</code></td></tr>
-<tr><td><code>{'ValidationProvider functions={...}'}</code></td><td><code>{'ValidationProvider customFunctions={...}'}</code></td></tr>
-<tr><td><code>useFieldValidation(path, checks)</code></td><td><code>useFieldValidation(path, config)</code> where config is <code>{'{ checks, validateOn? }'}</code></td></tr>
-</tbody>
-</table>
-
-## Visibility Provider
-
-The `auth` prop has been removed from `VisibilityProvider`. Auth state should be modeled as regular state.
-
-**Before:**
-
-```tsx
-<VisibilityProvider auth={{ isSignedIn: true, role: "admin" }}>
-```
-
-```json
-{ "auth": "signedIn" }
-```
-
-**After:**
-
-```tsx
-<StateProvider initialState={{ auth: { isSignedIn: true, role: "admin" } }}>
-  <VisibilityProvider>
-```
-
-```json
-{ "$state": "/auth/isSignedIn" }
-```
-
-## Codegen
-
-`traverseTree` has been renamed to `traverseSpec`, `SpecVisitor` to `TreeVisitor`, and the visitor callback now receives a `key` parameter.
-
-**Before:**
-
-```typescript
-import { traverseTree } from "@json-render/codegen";
-
-traverseTree(tree, (element) => {
-  // ...
-});
-```
-
-**After:**
-
-```typescript
-import { traverseSpec } from "@json-render/codegen";
-
-traverseSpec(spec, (element, key) => {
-  // ...
-});
-```
-
-## Action Params
-
-Action params in specs now use `statePath` instead of `path`.
-
-**Before:**
-
-```json
-{
-  "on": {
-    "press": { "action": "setState", "params": { "path": "/count", "value": 0 } }
-  }
-}
-```
-
-**After:**
-
-```json
-{
-  "on": {
-    "press": { "action": "setState", "params": { "statePath": "/count", "value": 0 } }
-  }
-}
-```
-
-## Removed Exports
-
-The following exports have been removed from `@json-render/core`:
-
-<table>
-  <thead>
-    <tr>
-      <th>Removed</th>
-      <th>Replacement</th>
-    </tr>
-  </thead>
-  <tbody>
-    <tr>
-      <td><code>createCatalog</code></td>
-      <td><code>defineCatalog(schema, config)</code></td>
-    </tr>
-    <tr>
-      <td><code>generateCatalogPrompt</code></td>
-      <td><code>catalog.prompt()</code></td>
-    </tr>
-    <tr>
-      <td><code>generateSystemPrompt</code></td>
-      <td><code>catalog.prompt()</code></td>
-    </tr>
-    <tr>
-      <td><code>ComponentDefinition</code></td>
-      <td>Use catalog component config directly</td>
-    </tr>
-    <tr>
-      <td><code>CatalogConfig</code></td>
-      <td>Use <code>defineCatalog</code> parameters</td>
-    </tr>
-    <tr>
-      <td><code>SystemPromptOptions</code></td>
-      <td>Use <code>PromptOptions</code></td>
-    </tr>
-    <tr>
-      <td><code>LogicExpression</code></td>
-      <td>Use <code>VisibilityCondition</code></td>
-    </tr>
-    <tr>
-      <td><code>AuthState</code></td>
-      <td>Model auth as regular state (e.g. <code>/auth/isSignedIn</code>)</td>
-    </tr>
-    <tr>
-      <td><code>evaluateLogicExpression</code></td>
-      <td>Use <code>evaluateVisibility</code></td>
-    </tr>
-    <tr>
-      <td><code>createRendererFromCatalog</code></td>
-      <td>Use <code>defineRegistry</code></td>
-    </tr>
-    <tr>
-      <td><code>traverseTree</code> (codegen)</td>
-      <td>Use <code>traverseSpec</code></td>
-    </tr>
-  </tbody>
-</table>

apps/web/app/(main)/docs/openapi/page.mdx

@@ -1,5 +1,4 @@
-import { pageMetadata } from "@/lib/page-metadata"
-export const metadata = pageMetadata("docs/openapi")
+export const metadata = { title: "OpenAPI Integration" }
 
 # OpenAPI Integration
 
@@ -99,11 +98,10 @@ A typical OpenAPI schema for a request body:
 Create components that map to OpenAPI data types:
 
 ```typescript
-import { defineCatalog } from '@json-render/core';
-import { schema } from '@json-render/react/schema';
+import { createCatalog } from '@json-render/core';
 import { z } from 'zod';
 
-export const openapiCatalog = defineCatalog(schema, {
+export const openapiCatalog = createCatalog({
   components: {
     Form: {
       description: 'API form container',

apps/web/app/(main)/docs/page.mdx

@@ -1,99 +1,36 @@
-import { pageMetadata } from "@/lib/page-metadata"
-export const metadata = pageMetadata("docs")
+export const metadata = { title: "Introduction" }
 
 # Introduction
 
-json-render is a framework for **Generative UI** — AI-generated interfaces that are safe, predictable, and render natively on any platform.
+The framework for User-Generated Interfaces (UGI). Dynamic, personalized UIs per user without sacrificing reliability.
 
-## What is Generative UI?
+## What is json-render?
 
-Most AI integrations treat the interface as fixed. Developers build layouts ahead of time, and AI fills in the data — a chatbot response, a summary, a recommendation. The UI itself never changes.
+json-render is the framework for **User-Generated Interfaces**: dynamic UIs that end users generate through natural language prompts, powered by Generative UI. You define the guardrails: what components exist, what props they take, what actions are available. AI generates JSON that matches your schema, and your components render it natively on web or mobile.
 
-**Generative UI is different.** The AI generates the interface itself: which components to show, how to arrange them, what data to bind, what actions to wire up. Every response can produce a unique, purpose-built UI tailored to the user's request.
+Every interface is unique to the user, but every interface is safe and predictable.
 
-The challenge is that unconstrained AI output is unpredictable. It can hallucinate component names, produce invalid structures, or generate unsafe code. You need a way to let AI be creative with layout and composition while keeping it within boundaries you control.
+## Why json-render?
 
-That is what json-render does. You define a **catalog** of components and actions. AI generates JSON constrained to that catalog. Your components render the result natively — on web or mobile — with full type safety and no arbitrary code execution.
+### Guardrailed
 
-## How json-render Works
+AI can only use components in your catalog. No arbitrary code generation. Predefined components and actions for safe, predictable output.
 
-### 1. Define your catalog
+### Predictable
 
-A catalog declares what AI can use: components with typed props, actions with typed params.
+JSON output matches your schema, every time. Actions are declared by name, you control what they do.
 
-```typescript
-import { defineCatalog } from '@json-render/core';
-import { schema } from '@json-render/react/schema';
-import { z } from 'zod';
+### Fast
 
-export const catalog = defineCatalog(schema, {
-  components: {
-    Card: {
-      props: z.object({ title: z.string() }),
-      slots: ["default"],
-    },
-    Metric: {
-      props: z.object({
-        label: z.string(),
-        value: z.string(),
-      }),
-    },
-  },
-});
-```
+Stream and render progressively as the model responds. No waiting for completion.
 
-### 2. AI generates a spec
+### Cross-Platform
 
-Given a prompt like "show me a revenue dashboard", AI outputs a JSON spec — a flat tree of elements constrained to your catalog:
+Render on web with React and on mobile with React Native from the same catalog and spec format.
 
-```json
-{
-  "root": "card-1",
-  "elements": {
-    "card-1": {
-      "type": "Card",
-      "props": { "title": "Revenue Dashboard" },
-      "children": ["metric-1", "metric-2"]
-    },
-    "metric-1": {
-      "type": "Metric",
-      "props": { "label": "Total Revenue", "value": "$48,200" }
-    },
-    "metric-2": {
-      "type": "Metric",
-      "props": { "label": "Growth", "value": "+12%" }
-    }
-  }
-}
-```
+## How it works
 
-### 3. Your components render it
-
-Map catalog types to real components with a registry, then render the spec:
-
-```tsx
-import { Renderer, StateProvider, VisibilityProvider } from '@json-render/react';
-
-<StateProvider initialState={{}}>
-  <VisibilityProvider>
-    <Renderer spec={spec} registry={registry} />
-  </VisibilityProvider>
-</StateProvider>
-```
-
-The result is a native UI built from your own components — not an iframe, not markdown, not generated code. The AI chose the structure; you control everything else.
-
-## Key Concepts
-
-- **[Catalog](/docs/catalog)** — Define the components, actions, and validation functions AI can use. This is the contract between your app and the AI.
-- **[Registry](/docs/registry)** — Map catalog types to platform-specific implementations. React components on web, React Native views on mobile.
-- **[Specs](/docs/specs)** — The JSON output AI generates. A flat tree of typed elements with props, children, data bindings, and visibility conditions.
-- **[Streaming](/docs/streaming)** — Render progressively as the AI responds. Each JSONL patch adds to the spec and the UI updates in real time.
-- **[Data Binding](/docs/data-binding)** — Bind props to runtime data with `$state` paths, repeat elements over arrays, and wire two-way input bindings.
-- **[Visibility](/docs/visibility)** — Show or hide elements based on state conditions. The AI can generate conditional UIs without writing logic.
-- **[Generation Modes](/docs/generation-modes)** — Standalone mode for full-page generated UI or inline mode for UI embedded in a conversation.
-
-## Next
-
-- [Installation](/docs/installation) — Add json-render to your project
-- [Quick Start](/docs/quick-start) — Build your first generative UI in 5 minutes
+1. Define the guardrails - what components, actions, and data bindings AI can use
+2. Users generate - end users describe what they want in natural language
+3. AI generates JSON - output is always predictable, constrained to your catalog
+4. Render fast - stream and render progressively as the model responds

apps/web/app/(main)/docs/quick-start/page.mdx

@@ -1,5 +1,4 @@
-import { pageMetadata } from "@/lib/page-metadata"
-export const metadata = pageMetadata("docs/quick-start")
+export const metadata = { title: "Quick Start" }
 
 # Quick Start
 
@@ -12,7 +11,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/schema';
+import { schema } from '@json-render/react';
 import { z } from 'zod';
 
 export const catalog = defineCatalog(schema, {
@@ -75,7 +74,7 @@ export const { registry } = defineRegistry(catalog, {
     Button: ({ props, emit }) => (
       <button
         className="px-4 py-2 bg-blue-500 text-white rounded"
-        onClick={() => emit("press")}
+        onClick={() => emit?.("press")}
       >
         {props.label}
       </button>
@@ -120,7 +119,7 @@ Use providers and the `Renderer` with your registry to display AI-generated UI:
 // app/page.tsx
 'use client';
 
-import { Renderer, StateProvider, ActionProvider, VisibilityProvider, ValidationProvider, useUIStream } from '@json-render/react';
+import { Renderer, StateProvider, ActionProvider, VisibilityProvider, useUIStream } from '@json-render/react';
 import { registry } from '@/lib/registry';
 
 export default function Page() {
@@ -141,22 +140,20 @@ export default function Page() {
           submit: (params) => console.log('Submit:', params),
           navigate: (params) => console.log('Navigate:', params),
         }}>
-          <ValidationProvider customFunctions={{}}>
-            <form onSubmit={handleSubmit}>
-              <input
-                name="prompt"
-                placeholder="Describe what you want..."
-                className="border p-2 rounded"
-              />
-              <button type="submit" disabled={isStreaming}>
-                Generate
-              </button>
-            </form>
+          <form onSubmit={handleSubmit}>
+            <input
+              name="prompt"
+              placeholder="Describe what you want..."
+              className="border p-2 rounded"
+            />
+            <button type="submit" disabled={isStreaming}>
+              Generate
+            </button>
+          </form>
 
-            <div className="mt-8">
-              <Renderer spec={spec} registry={registry} loading={isStreaming} />
-            </div>
-          </ValidationProvider>
+          <div className="mt-8">
+            <Renderer spec={spec} registry={registry} loading={isStreaming} />
+          </div>
         </ActionProvider>
       </VisibilityProvider>
     </StateProvider>
@@ -164,51 +161,9 @@ export default function Page() {
 }
 ```
 
-## Quick Start with shadcn/ui
-
-If you want to skip defining components from scratch, use `@json-render/shadcn` for 36 pre-built components:
-
-```typescript
-// lib/catalog.ts
-import { defineCatalog } from '@json-render/core';
-import { schema } from '@json-render/react/schema';
-import { shadcnComponentDefinitions } from '@json-render/shadcn/catalog';
-
-export const catalog = defineCatalog(schema, {
-  components: {
-    Card: shadcnComponentDefinitions.Card,
-    Stack: shadcnComponentDefinitions.Stack,
-    Heading: shadcnComponentDefinitions.Heading,
-    Button: shadcnComponentDefinitions.Button,
-    Input: shadcnComponentDefinitions.Input,
-  },
-  actions: {},
-});
-```
-
-```tsx
-// lib/registry.tsx
-import { defineRegistry } from '@json-render/react';
-import { shadcnComponents } from '@json-render/shadcn';
-import { catalog } from './catalog';
-
-export const { registry } = defineRegistry(catalog, {
-  components: {
-    Card: shadcnComponents.Card,
-    Stack: shadcnComponents.Stack,
-    Heading: shadcnComponents.Heading,
-    Button: shadcnComponents.Button,
-    Input: shadcnComponents.Input,
-  },
-});
-```
-
-See the [@json-render/shadcn API reference](/docs/api/shadcn) for the full component list.
-
 ## Next steps
 
 - Learn about [catalogs](/docs/catalog) in depth
 - Explore [data binding](/docs/data-binding) for dynamic values
-- Add [action handlers](/docs/registry#action-handlers) for interactivity
+- Add [actions](/docs/actions) for interactivity
 - Implement [conditional visibility](/docs/visibility)
-- Use [pre-built shadcn/ui components](/docs/api/shadcn) for fast prototyping

apps/web/app/(main)/docs/registry/page.mdx

@@ -1,22 +1,12 @@
-import { pageMetadata } from "@/lib/page-metadata"
-export const metadata = pageMetadata("docs/registry")
+export const metadata = { title: "Registry" }
 
 # Registry
 
-A registry maps your [catalog](/docs/catalog) definitions to platform-specific implementations. The catalog defines *what* AI can generate — the registry provides the *how*.
+Register React components and action handlers to bring your catalog to life.
 
-What a registry contains depends on the schema you use. Each package defines its own schema, which determines the shape of both the catalog and the registry.
+## defineRegistry
 
-- **`@json-render/react`** — Components (React elements) and action handlers
-- **`@json-render/react-native`** — Components (React Native elements) and action handlers
-- **`@json-render/react-email`** — Email components (React Email / HTML)
-- **`@json-render/remotion`** — Clip components, transitions, and effects
-
-## @json-render/react
-
-### defineRegistry
-
-Use `defineRegistry` to create a type-safe registry from your catalog. Pass your components, actions, or both:
+Use `defineRegistry` to create a type-safe registry from your catalog. Pass your components, actions, or both in a single call:
 
 ```tsx
 import { defineRegistry } from '@json-render/react';
@@ -32,8 +22,8 @@ export const { registry, handlers, executeAction } = defineRegistry(myCatalog, {
       </div>
     ),
 
-    Button: ({ props, emit }) => (
-      <button onClick={() => emit("press")}>
+    Button: ({ props, onAction }) => (
+      <button onClick={() => onAction?.({ name: props.action })}>
         {props.label}
       </button>
     ),
@@ -59,82 +49,36 @@ export const { registry, handlers, executeAction } = defineRegistry(myCatalog, {
 
 The returned object contains:
 
-- `registry` — component registry for `<Renderer />`
-- `handlers` — factory for ActionProvider-compatible handlers
-- `executeAction` — imperative action dispatch (for use outside the React tree)
+- `registry` - component registry for `<Renderer />`
+- `handlers` - factory for ActionProvider-compatible handlers
+- `executeAction` - imperative action dispatch (for use outside the React tree)
 
-### Component Props
+## Component Props
 
-Each component receives a `ComponentContext` object:
+Each component in the registry receives a `ComponentContext` object:
 
 ```typescript
 interface ComponentContext {
-  props: T;                                // Type-safe props from your catalog
-  children?: React.ReactNode;              // Rendered children (for slot components)
-  emit: (event: string) => void;           // Emit a named event (always defined)
-  on: (event: string) => EventHandle;      // Get event handle with metadata
-  loading?: boolean;                       // Whether the renderer is in a loading state
-  bindings?: Record<string, string>;       // State paths from $bindState/$bindItem expressions
-}
-
-interface EventHandle {
-  emit: () => void;              // Fire the event
-  shouldPreventDefault: boolean; // Whether any binding requested preventDefault
-  bound: boolean;                // Whether any handler is bound
+  props: T;                    // Type-safe props from your catalog
+  children?: React.ReactNode;  // Rendered children (for slot components)
+  onAction?: (action: ActionTrigger) => void;  // Dispatch an action
+  loading?: boolean;           // Whether the renderer is in a loading state
 }
 ```
 
 Props are automatically inferred from your catalog, so `props.title` is typed as `string` if your catalog defines it that way.
 
-Use `emit("press")` for simple event firing. Use `on("click")` when you need to inspect event metadata:
-
-```tsx
-Link: ({ props, on }) => {
-  const click = on("click");
-  return (
-    <a
-      href={props.href}
-      onClick={(e) => {
-        if (click.shouldPreventDefault) e.preventDefault();
-        click.emit();
-      }}
-    >
-      {props.label}
-    </a>
-  );
-},
-```
-
-#### Using `bindings` for two-way binding
-
-When a spec uses `{ "$bindState": "/path" }` or `{ "$bindItem": "field" }` on a prop, the renderer resolves the **value** into `props` and provides the **write-back path** in `bindings`. Use the `useBoundProp` hook to wire both together:
-
-```tsx
-import { useBoundProp, defineRegistry } from '@json-render/react';
-
-// Inside your registry:
-TextInput: ({ props, bindings }) => {
-  const [value, setValue] = useBoundProp<string>(props.value, bindings?.value);
-  return (
-    <input
-      value={value ?? ""}
-      onChange={(e) => setValue(e.target.value)}
-    />
-  );
-},
-```
-
-`useBoundProp` returns `[resolvedValue, setter]`. The setter writes to the bound state path. If no binding exists (the prop is a literal), the setter is a no-op.
-
-### Action Handlers
+## Action Handlers
 
 Instead of AI generating arbitrary code, it declares *intent* by name. Your application provides the implementation. This is a core guardrail.
 
-Actions are declared in your [catalog](/docs/catalog). The `@json-render/react` schema supports an `actions` key where you define what operations AI can trigger:
+### Defining Actions
+
+Define available actions in your catalog:
 
 ```typescript
 import { defineCatalog } from '@json-render/core';
-import { schema } from '@json-render/react/schema';
+import { schema } from '@json-render/react';
 import { z } from 'zod';
 
 const catalog = defineCatalog(schema, {
@@ -160,7 +104,9 @@ const catalog = defineCatalog(schema, {
 });
 ```
 
-Action handlers receive `(params, setState, state)` and are defined inside `defineRegistry`:
+### Implementing Action Handlers
+
+Action handlers receive `(params, setState, data)` and are defined inside `defineRegistry`:
 
 ```tsx
 export const { handlers, executeAction } = defineRegistry(catalog, {
@@ -186,35 +132,43 @@ export const { handlers, executeAction } = defineRegistry(catalog, {
 });
 ```
 
-### Data Binding
+## Using Data Binding
 
-Most data binding is handled automatically by the renderer — `$state`, `$item`, and `$index` expressions in props are resolved before your component receives them. See the [Data Binding](/docs/data-binding) guide for the full reference.
-
-For two-way binding (form inputs), use `{ "$bindState": "/path" }` on the natural value prop (or `{ "$bindItem": "field" }` inside repeat scopes). The renderer provides a `bindings` map with the state path for each bound prop. Use `useBoundProp` to get `[value, setValue]`:
+Use hooks inside your registry components to read and write data:
 
 ```tsx
-import { useBoundProp } from '@json-render/react';
+import { useStateStore } from '@json-render/react';
+import { getByPath } from '@json-render/core';
 
 // Inside defineRegistry components:
 
-Input: ({ props, bindings }) => {
-  const [value, setValue] = useBoundProp<string>(
-    props.value,
-    bindings?.value
+Metric: ({ props }) => {
+  const { data } = useStateStore();
+  const value = getByPath(data, props.valuePath);
+
+  return (
+    <div className="metric">
+      <span className="label">{props.label}</span>
+      <span className="value">{formatValue(value)}</span>
+    </div>
   );
+},
+
+TextField: ({ props }) => {
+  const { data, set } = useStateStore();
+  const value = getByPath(data, props.valuePath) as string;
+
   return (
     <input
-      value={value ?? ''}
-      onChange={(e) => setValue(e.target.value)}
+      value={value || ''}
+      onChange={(e) => set(props.valuePath, e.target.value)}
       placeholder={props.placeholder}
     />
   );
 },
 ```
 
-For read-only state access (e.g. displaying a value from state), use `$state` expressions in props — they are resolved before the component receives them. For custom logic, use `useStateStore` and `getByPath` from `@json-render/core`.
-
-### Using the Renderer
+## Using the Renderer
 
 Wire everything together with providers and the `<Renderer />` component:
 
@@ -228,19 +182,19 @@ import {
 } from '@json-render/react';
 import { registry, handlers } from './registry';
 
-function App({ spec, state, setState }) {
-  const stateRef = useRef(state);
+function App({ spec, data, setState }) {
+  const dataRef = useRef(data);
   const setStateRef = useRef(setState);
-  stateRef.current = state;
+  dataRef.current = data;
   setStateRef.current = setState;
 
   const actionHandlers = useMemo(
-    () => handlers(() => setStateRef.current, () => stateRef.current),
+    () => handlers(() => setStateRef.current, () => dataRef.current),
     [],
   );
 
   return (
-    <StateProvider initialState={state}>
+    <StateProvider initialState={data}>
       <VisibilityProvider>
         <ActionProvider handlers={actionHandlers}>
           <Renderer spec={spec} registry={registry} />
@@ -251,80 +205,6 @@ function App({ spec, state, setState }) {
 }
 ```
 
-## @json-render/react-native
-
-`@json-render/react-native` uses the same `defineRegistry` API. The only difference is that components return React Native elements instead of HTML:
-
-```tsx
-import { defineRegistry } from '@json-render/react-native';
-import { View, Text, Pressable } from 'react-native';
-
-export const { registry } = defineRegistry(catalog, {
-  components: {
-    Card: ({ props, children }) => (
-      <View style={styles.card}>
-        <Text style={styles.title}>{props.title}</Text>
-        {children}
-      </View>
-    ),
-
-    Button: ({ props, emit }) => (
-      <Pressable onPress={() => emit("press")}>
-        <Text>{props.label}</Text>
-      </Pressable>
-    ),
-  },
-});
-```
-
-See the [@json-render/react-native API reference](/docs/api/react-native) for the full API.
-
-## @json-render/react-email
-
-`@json-render/react-email` uses `defineRegistry` like React and React Native. Components render to React Email primitives (`@react-email/components`). Use `renderToHtml` or `renderToPlainText` for server-side email output:
-
-```tsx
-import { defineRegistry } from '@json-render/react-email';
-import { renderToHtml } from '@json-render/react-email';
-import { Body, Container, Heading, Text } from '@react-email/components';
-
-export const { registry } = defineRegistry(catalog, {
-  components: {
-    Card: ({ props, children }) => (
-      <Container style={{ padding: 16, backgroundColor: '#fff' }}>
-        <Heading>{props.title}</Heading>
-        {children}
-      </Container>
-    ),
-  },
-});
-
-const html = await renderToHtml(spec, { registry });
-```
-
-See the [@json-render/react-email API reference](/docs/api/react-email) for the full API.
-
-## @json-render/remotion
-
-`@json-render/remotion` takes a different approach. Instead of `defineRegistry`, it uses a plain component registry with built-in standard components for video production:
-
-```tsx
-import { Renderer, standardComponents } from '@json-render/remotion';
-
-// Use the standard components directly
-<Renderer spec={timelineSpec} components={standardComponents} />
-
-// Or extend with your own
-const components = {
-  ...standardComponents,
-  CustomSlide: ({ clip }) => <AbsoluteFill>{/* ... */}</AbsoluteFill>,
-};
-```
-
-The Remotion schema also supports `transitions` and `effects` in the catalog rather than actions.
-
-See the [@json-render/remotion API reference](/docs/api/remotion) for the full API.
-
 ## Next
 
 Learn about [data binding](/docs/data-binding) for dynamic values.

apps/web/app/(main)/docs/renderers/page.mdx

@@ -1,268 +0,0 @@
-import { pageMetadata } from "@/lib/page-metadata";
-export const metadata = pageMetadata("docs/renderers");
-
-# Renderers
-
-json-render supports multiple output targets. Each renderer takes the same core concept -- a JSON spec constrained to a catalog -- and renders it natively on a different platform or into a different format.
-
-All renderers share the same workflow:
-
-1. Define a catalog with `defineCatalog`
-2. AI generates a JSON spec
-3. The renderer turns the spec into platform-native output
-
-<table>
-  <thead>
-    <tr>
-      <th>Renderer</th>
-      <th>Package</th>
-      <th>Output</th>
-    </tr>
-  </thead>
-  <tbody>
-    <tr>
-      <td>React</td>
-      <td>
-        <code>@json-render/react</code>
-      </td>
-      <td>React component tree</td>
-    </tr>
-    <tr>
-      <td>Vue</td>
-      <td>
-        <code>@json-render/vue</code>
-      </td>
-      <td>Vue 3 component tree</td>
-    </tr>
-    <tr>
-      <td>Svelte</td>
-      <td>
-        <code>@json-render/svelte</code>
-      </td>
-      <td>Svelte 5 component tree</td>
-    </tr>
-    <tr>
-      <td>Solid</td>
-      <td>
-        <code>@json-render/solid</code>
-      </td>
-      <td>SolidJS component tree</td>
-    </tr>
-    <tr>
-      <td>shadcn/ui</td>
-      <td>
-        <code>@json-render/shadcn</code>
-      </td>
-      <td>Pre-built Radix UI + Tailwind components (uses React renderer)</td>
-    </tr>
-    <tr>
-      <td>React Native</td>
-      <td>
-        <code>@json-render/react-native</code>
-      </td>
-      <td>Native mobile views</td>
-    </tr>
-    <tr>
-      <td>Image</td>
-      <td>
-        <code>@json-render/image</code>
-      </td>
-      <td>SVG / PNG (via Satori)</td>
-    </tr>
-    <tr>
-      <td>React PDF</td>
-      <td>
-        <code>@json-render/react-pdf</code>
-      </td>
-      <td>PDF documents</td>
-    </tr>
-    <tr>
-      <td>Remotion</td>
-      <td>
-        <code>@json-render/remotion</code>
-      </td>
-      <td>Video compositions</td>
-    </tr>
-  </tbody>
-</table>
-
-## React
-
-Render specs as React component trees in the browser. Supports data binding, streaming, actions, validation, visibility, and computed values.
-
-```tsx
-import { defineRegistry, Renderer } from "@json-render/react";
-import { schema } from "@json-render/react/schema";
-
-const { registry } = defineRegistry(catalog, { components });
-<Renderer spec={spec} registry={registry} />;
-```
-
-Use `StateProvider`, `VisibilityProvider`, and `ActionProvider` for full interactivity. See the [@json-render/react API reference](/docs/api/react) for details.
-
-## Vue
-
-Vue 3 renderer with full feature parity with React: data binding, visibility, actions, validation, repeat scopes, and streaming.
-
-```typescript
-import { defineRegistry, Renderer } from "@json-render/vue";
-import { schema } from "@json-render/vue/schema";
-
-const { registry } = defineRegistry(catalog, {
-  components: {
-    Card: ({ props, children }) =>
-      h("div", { class: "card" }, [h("h3", null, props.title), children]),
-  },
-});
-```
-
-Uses composables (`useStateStore`, `useStateBinding`, `useActions`, etc.) instead of React hooks. See the [@json-render/vue API reference](/docs/api/vue) for details.
-
-## Svelte
-
-Svelte 5 renderer with runes-compatible context helpers, visibility conditions, actions, and streaming support.
-
-```typescript
-import { defineRegistry, Renderer } from "@json-render/svelte";
-import { schema } from "@json-render/svelte/schema";
-
-const { registry } = defineRegistry(catalog, {
-  components: {
-    Card: ({ props, children }) => /* Svelte snippet */,
-  },
-});
-```
-
-See the [@json-render/svelte API reference](/docs/api/svelte) for details.
-
-## Solid
-
-SolidJS renderer with fine-grained reactivity, state bindings, validation, visibility, and event-driven actions.
-
-```tsx
-import { defineRegistry, Renderer } from "@json-render/solid";
-import { schema } from "@json-render/solid/schema";
-
-const { registry } = defineRegistry(catalog, {
-  components: {
-    Card: (renderProps) => <div>{renderProps.children}</div>,
-  },
-});
-
-<Renderer spec={spec} registry={registry} />;
-```
-
-See the [@json-render/solid API reference](/docs/api/solid) for details.
-
-## shadcn/ui
-
-36 pre-built components using Radix UI and Tailwind CSS. Built on top of `@json-render/react` -- no custom renderer needed.
-
-```tsx
-import { defineCatalog } from "@json-render/core";
-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";
-
-const catalog = defineCatalog(schema, {
-  components: {
-    Card: shadcnComponentDefinitions.Card,
-    Button: shadcnComponentDefinitions.Button,
-  },
-});
-
-const { registry } = defineRegistry(catalog, {
-  components: {
-    Card: shadcnComponents.Card,
-    Button: shadcnComponents.Button,
-  },
-});
-```
-
-See the [@json-render/shadcn API reference](/docs/api/shadcn) for the full component list.
-
-## React Native
-
-Render specs as native mobile views. Includes 25+ standard components and standard action definitions.
-
-```tsx
-import { defineCatalog } from "@json-render/core";
-import { schema } from "@json-render/react-native/schema";
-import {
-  standardComponentDefinitions,
-  standardActionDefinitions,
-} from "@json-render/react-native/catalog";
-import { defineRegistry, Renderer } from "@json-render/react-native";
-
-const catalog = defineCatalog(schema, {
-  components: { ...standardComponentDefinitions },
-  actions: standardActionDefinitions,
-});
-
-const { registry } = defineRegistry(catalog, { components: {} });
-<Renderer spec={spec} registry={registry} />;
-```
-
-See the [@json-render/react-native API reference](/docs/api/react-native) for details.
-
-## Image
-
-Generate SVG and PNG images from JSON specs using Satori. Ideal for OG images, social cards, and banners.
-
-```typescript
-import { renderToSvg, renderToPng } from "@json-render/image/render";
-
-const svg = await renderToSvg(spec, { fonts });
-const png = await renderToPng(spec, { fonts });
-```
-
-Nine standard components: Frame, Box, Row, Column, Heading, Text, Image, Divider, Spacer. PNG output requires `@resvg/resvg-js` as an optional peer dependency.
-
-See the [@json-render/image API reference](/docs/api/image) for details.
-
-## React PDF
-
-Generate PDF documents from JSON specs using `@react-pdf/renderer`. Render to buffer, stream, or file.
-
-```typescript
-import {
-  renderToBuffer,
-  renderToStream,
-  renderToFile,
-} from "@json-render/react-pdf";
-
-const buffer = await renderToBuffer(spec);
-const stream = await renderToStream(spec);
-await renderToFile(spec, "./output.pdf");
-```
-
-Standard components include Document, Page, View, Row, Column, Heading, Text, Image, Table, List, Divider, Spacer, Link, and PageNumber.
-
-See the [@json-render/react-pdf API reference](/docs/api/react-pdf) for details.
-
-## Remotion
-
-Turn JSON timeline specs into video compositions with Remotion.
-
-```tsx
-import { Player } from "@remotion/player";
-import { Renderer } from "@json-render/remotion";
-
-<Player
-  component={Renderer}
-  inputProps={{ spec }}
-  durationInFrames={spec.composition.durationInFrames}
-  fps={spec.composition.fps}
-  compositionWidth={spec.composition.width}
-  compositionHeight={spec.composition.height}
-/>;
-```
-
-Uses a timeline spec format with compositions, tracks, and clips. Includes standard components (TitleCard, TypingText, ImageSlide, etc.), transitions (fade, slide, zoom, wipe), and effects.
-
-See the [@json-render/remotion API reference](/docs/api/remotion) for details.
-
-## Custom Renderers
-
-You can build your own renderer for any output target. See the [Custom Schema & Renderer](/docs/custom-schema) guide for how to define a custom schema and wire it to your own rendering logic.

apps/web/app/(main)/docs/schemas/page.mdx

@@ -1,5 +1,4 @@
-import { pageMetadata } from "@/lib/page-metadata"
-export const metadata = pageMetadata("docs/schemas")
+export const metadata = { title: "Schemas" }
 
 # Schemas
 
@@ -42,7 +41,7 @@ See the [Custom Schema guide](/docs/custom-schema) to learn how to implement sup
     },
     "text-1": {
       "type": "Text",
-      "props": { "content": { "$state": "/user/name" } },
+      "props": { "content": "Welcome, $data.user.name" },
       "children": []
     },
     "button-1": {
@@ -65,27 +64,25 @@ interface Element {
   type: string;                // Component type from catalog
   props: Record<string, any>;  // Component properties
   children: string[];          // Array of child element keys
-  visible?: VisibilityCondition;  // Conditional display
+  visible?: VisibilityRule;    // Conditional display
 }
 ```
 
 ### Data Binding Syntax
 
-Reference dynamic data using `$state` expressions in props. The value is a JSON Pointer path into the state model:
+Reference dynamic data using the `$data` prefix in props:
 
 ```json
 {
   "type": "Text",
   "props": {
-    "content": { "$state": "/user/name" },
-    "count": { "$state": "/items/count" }
+    "content": "$data.user.name",
+    "count": "$data.items.length"
   },
   "children": []
 }
 ```
 
-json-render also supports `$item` and `$index` expressions for lists, two-way binding via `$bindState` / `$bindItem`, and conditional props. See [Data Binding](/docs/data-binding) for the full reference.
-
 ### Action Format
 
 Actions are defined in the catalog and referenced from components. The renderer handles action execution:
@@ -124,7 +121,7 @@ const MyElementSchema = z.object({
 // Define your own data binding format
 const BoundValue = z.object({
   literal: z.string().optional(),
-  source: z.string().optional(),  // e.g., "/users/0/name"
+  path: z.string().optional(),  // e.g., "/users/0/name"
 });
 
 // Define your own action format

apps/web/app/(main)/docs/skills/page.mdx

@@ -1,123 +0,0 @@
-import { pageMetadata } from "@/lib/page-metadata";
-
-export const metadata = pageMetadata("docs/skills");
-
-# Skills
-
-json-render ships with skills that teach AI coding agents how to use each package. Install a skill and your agent in Cursor, Claude Code, or Codex can generate json-render UIs without manual guidance.
-
-## Available Skills
-
-- **core** — Core schemas, catalogs, and AI prompt generation.
-- **react** — React renderer that turns JSON specs into React component trees.
-- **react-pdf** — PDF renderer using `@react-pdf/renderer`.
-- **react-email** — Email renderer that produces HTML or plain-text emails.
-- **react-native** — React Native renderer for native mobile UIs.
-- **shadcn** — Pre-built shadcn/ui components (Radix UI + Tailwind).
-- **image** — Image renderer that turns JSON specs into SVG and PNG via Satori.
-- **remotion** — Remotion renderer for video generation from JSON timeline specs.
-- **vue** — Vue 3 renderer for Vue component trees.
-- **svelte** — Svelte 5 renderer for Svelte component trees.
-- **solid** — SolidJS renderer for fine-grained reactive component trees.
-- **codegen** — Code generation utilities for building custom exporters.
-- **mcp** — MCP Apps integration for Claude, ChatGPT, Cursor, and VS Code.
-- **redux** — Redux adapter for json-render's `StateStore` interface.
-- **zustand** — Zustand adapter for json-render's `StateStore` interface.
-- **jotai** — Jotai adapter for json-render's `StateStore` interface.
-- **xstate** — XState Store adapter for json-render's `StateStore` interface.
-
-## Installation
-
-```bash
-npx skills add vercel-labs/json-render --skill core
-npx skills add vercel-labs/json-render --skill react
-npx skills add vercel-labs/json-render --skill react-pdf
-npx skills add vercel-labs/json-render --skill react-email
-npx skills add vercel-labs/json-render --skill react-native
-npx skills add vercel-labs/json-render --skill shadcn
-npx skills add vercel-labs/json-render --skill image
-npx skills add vercel-labs/json-render --skill remotion
-npx skills add vercel-labs/json-render --skill vue
-npx skills add vercel-labs/json-render --skill svelte
-npx skills add vercel-labs/json-render --skill solid
-npx skills add vercel-labs/json-render --skill codegen
-npx skills add vercel-labs/json-render --skill mcp
-npx skills add vercel-labs/json-render --skill redux
-npx skills add vercel-labs/json-render --skill zustand
-npx skills add vercel-labs/json-render --skill jotai
-npx skills add vercel-labs/json-render --skill xstate
-```
-
-After installing, your AI agent will automatically activate the right skill when it encounters a matching request.
-
-## core
-
-The foundational skill. Teaches agents how to define catalogs, create schemas, build specs, and generate AI prompts. This is the starting point for any json-render project and covers `defineCatalog`, `defineSchema`, `specSchema`, `toPrompt`, and the full spec format.
-
-## react
-
-Teaches agents how to render JSON specs as React component trees using `JsonRender`, `JsonRenderClient`, and `useJsonRender`. Covers custom component registries, client-side interactivity, state management, and streaming integration.
-
-## react-pdf
-
-Teaches agents how to generate PDFs from JSON specs using `@react-pdf/renderer`. Covers the PDF-specific component registry, page layout, and styling.
-
-## react-email
-
-Teaches agents how to render JSON specs as HTML or plain-text emails using React Email components. Covers the email-specific registry and rendering pipeline.
-
-## react-native
-
-Teaches agents how to render JSON specs as native mobile UIs with React Native. Covers the native component registry and platform-specific considerations.
-
-## shadcn
-
-Teaches agents how to use the pre-built shadcn/ui component registry with json-render. Includes Radix UI primitives, Tailwind styling, and the full set of available shadcn components.
-
-## image
-
-Teaches agents how to turn JSON specs into SVG and PNG images using Satori. Covers the image-specific registry, dimensions, fonts, and rendering options.
-
-## remotion
-
-Teaches agents how to generate videos from JSON timeline specs using Remotion. Covers compositions, sequences, timeline structure, and video rendering.
-
-## vue
-
-Teaches agents how to render JSON specs as Vue 3 component trees. Covers the Vue renderer API, custom component registries, and reactivity integration.
-
-## svelte
-
-Teaches agents how to render JSON specs as Svelte 5 component trees. Covers the Svelte renderer API and component registration.
-
-## solid
-
-Teaches agents how to render JSON specs as SolidJS component trees. Covers Solid-specific reactive patterns, provider wiring, bindings, actions, and streaming.
-
-## codegen
-
-Teaches agents how to use code generation utilities to export UI specs as framework-specific source code. Covers the codegen pipeline and custom exporter creation.
-
-## mcp
-
-Teaches agents how to build MCP Apps that serve json-render UIs inside AI tools like Claude, ChatGPT, Cursor, and VS Code. Covers MCP server setup, tool definitions, and UI streaming.
-
-## redux
-
-Teaches agents how to connect a Redux store to json-render's `StateStore` interface for state-driven UIs.
-
-## zustand
-
-Teaches agents how to connect a Zustand store to json-render's `StateStore` interface for lightweight state management.
-
-## jotai
-
-Teaches agents how to connect Jotai atoms to json-render's `StateStore` interface for atomic state management.
-
-## xstate
-
-Teaches agents how to connect an XState Store to json-render's `StateStore` interface for state-machine-driven UIs.
-
-## Source
-
-All skill files are in the [`skills/`](https://github.com/vercel-labs/json-render/tree/main/skills) directory of the repository.

apps/web/app/(main)/docs/specs/page.mdx

@@ -1,5 +1,4 @@
-import { pageMetadata } from "@/lib/page-metadata"
-export const metadata = pageMetadata("docs/specs")
+export const metadata = { title: "Specs" }
 
 # Specs
 
@@ -7,7 +6,7 @@ A spec is a JSON document that describes your UI.
 
 ## What is a Spec?
 
-A spec (specification) is the actual JSON that describes a UI. It uses components from a [catalog](/docs/catalog) and can optionally follow a [schema](/docs/schemas). Specs can be:
+A spec (specification) is the actual JSON that describes a UI. It conforms to a [schema](/docs/schemas) and uses components from a [catalog](/docs/catalog). Specs can be:
 
 - Generated by AI in real-time
 - Stored in a database
@@ -33,7 +32,7 @@ A basic spec using the `@json-render/react` schema. Note the flat structure with
     },
     "text-1": {
       "type": "Text",
-      "props": { "content": { "$state": "/user/greeting" } },
+      "props": { "content": "Hello, $data.user.name!" },
       "children": []
     }
   }
@@ -60,7 +59,7 @@ A more complex spec with multiple nested elements:
     },
     "avatar-1": {
       "type": "Avatar",
-      "props": { "src": { "$state": "/user/avatar" }, "alt": { "$state": "/user/name" } },
+      "props": { "src": "$data.user.avatar", "alt": "$data.user.name" },
       "children": []
     },
     "stack-1": {
@@ -70,12 +69,12 @@ A more complex spec with multiple nested elements:
     },
     "name-text": {
       "type": "Text",
-      "props": { "content": { "$state": "/user/name" }, "variant": "heading" },
+      "props": { "content": "$data.user.name", "variant": "heading" },
       "children": []
     },
     "email-text": {
       "type": "Text",
-      "props": { "content": { "$state": "/user/email" }, "variant": "caption" },
+      "props": { "content": "$data.user.email", "variant": "caption" },
       "children": []
     },
     "button-1": {
@@ -146,11 +145,9 @@ A high-level spec using semantic blocks for page layouts:
 
 ## Spec Anatomy
 
-Specs are schema-agnostic — the JSON structure is entirely up to you. The examples below use the `root` + `elements` flat tree format from the `@json-render/react` schema, which is optimized for AI generation and streaming.
-
 ### Root and Elements
 
-In the React schema, a spec has a `root` key pointing to the entry element, and an `elements` map containing all elements:
+Every spec has a `root` key pointing to the entry element, and an `elements` map containing all elements:
 
 ```json
 {
@@ -184,22 +181,20 @@ Each element in the map has a consistent shape:
 
 ### Dynamic Data
 
-Props can reference data from the state model using `$state` expressions. The value is a JSON Pointer (RFC 6901) path into the state:
+Props can reference data using `$data` paths:
 
 ```json
 {
   "type": "Metric",
   "props": {
     "label": "Total Revenue",
-    "value": { "$state": "/metrics/revenue" },
-    "change": { "$state": "/metrics/revenueChange" }
+    "value": "$data.metrics.revenue",
+    "change": "$data.metrics.revenueChange"
   },
   "children": []
 }
 ```
 
-See [Data Binding](/docs/data-binding) for the full reference including `$item`, `$index`, repeat, and two-way binding.
-
 ### Conditional Visibility
 
 Control when elements appear using the `visible` property:
@@ -212,52 +207,46 @@ Control when elements appear using the `visible` property:
   },
   "children": [],
   "visible": {
-    "$state": "/form/isDirty",
-    "eq": true
+    "path": "$data.form.isDirty",
+    "operator": "eq",
+    "value": true
   }
 }
 ```
 
 ## Working with Specs
 
-### Validating a Spec
-
-Use `validateSpec` from `@json-render/core` to check a spec for structural issues:
-
-```typescript
-import { validateSpec } from '@json-render/core';
-
-const result = validateSpec(spec);
-
-if (!result.valid) {
-  console.error('Invalid spec:', result.issues);
-}
-```
-
-### Rendering a Spec (React)
-
-With `@json-render/react`, wrap the `Renderer` in providers to supply state and visibility:
+### Rendering a Spec
 
 ```tsx
-import { Renderer, StateProvider, VisibilityProvider } from '@json-render/react';
-import { registry } from './registry';
+import { Renderer } from '@json-render/react';
 
-function MyApp({ spec, initialState }) {
+function MyApp({ spec, data }) {
   return (
-    <StateProvider initialState={initialState}>
-      <VisibilityProvider>
-        <Renderer spec={spec} registry={registry} />
-      </VisibilityProvider>
-    </StateProvider>
+    <Renderer
+      spec={spec}
+      data={data}
+      registry={registry}
+    />
   );
 }
 ```
 
-See the [@json-render/react API reference](/docs/api/react) for full provider and hook documentation.
+### Validating a Spec
 
-### Streaming a Spec (React)
+```typescript
+import { validate } from '@json-render/core';
 
-With `@json-render/react`, use the `useUIStream` hook to stream specs incrementally:
+const result = validate(spec, catalog);
+
+if (!result.valid) {
+  console.error('Invalid spec:', result.errors);
+}
+```
+
+### Streaming Specs
+
+Specs can be streamed incrementally for progressive rendering:
 
 ```tsx
 import { useUIStream } from '@json-render/react';
@@ -277,8 +266,6 @@ function GenerativeUI() {
 }
 ```
 
-See [Streaming](/docs/streaming) for the full SpecStream format and server-side setup.
-
 ## Spec Sources
 
 Specs can come from various sources:

apps/web/app/(main)/docs/streaming/page.mdx

@@ -1,5 +1,4 @@
-import { pageMetadata } from "@/lib/page-metadata"
-export const metadata = pageMetadata("docs/streaming")
+export const metadata = { title: "Streaming" }
 
 # Streaming
 
@@ -16,6 +15,28 @@ json-render uses **SpecStream**, a JSONL-based streaming format where each line
 {"op":"add","path":"/elements/metric-2","value":{"type":"Metric","props":{"label":"Users"}}}
 ```
 
+## useUIStream Hook
+
+The hook handles parsing and state management:
+
+```tsx
+import { useUIStream } from '@json-render/react';
+
+function App() {
+  const {
+    spec,          // Current UI spec state
+    isStreaming,   // True while streaming
+    error,         // Any error that occurred
+    send,          // Function to start generation
+    clear,         // Function to reset spec and error
+  } = useUIStream({
+    api: '/api/generate',
+    onComplete: (spec) => {},  // Optional: called when streaming completes
+    onError: (error) => {},    // Optional: called when an error occurs
+  });
+}
+```
+
 ## Patch Operations (RFC 6902)
 
 SpecStream uses [RFC 6902 JSON Patch](https://datatracker.ietf.org/doc/html/rfc6902) operations:
@@ -29,13 +50,13 @@ SpecStream uses [RFC 6902 JSON Patch](https://datatracker.ietf.org/doc/html/rfc6
 
 ## Path Format
 
-Paths follow JSON Pointer (RFC 6901) into the spec object:
+Paths use a key-based format for elements:
 
 ```bash
-/root                       -> Root element key (string)
-/elements/card-1            -> Element with key "card-1"
-/elements/card-1/props      -> Props of card-1
-/elements/card-1/children   -> Children of card-1
+/root              -> Root element
+/root/children     -> Children of root
+/elements/card-1   -> Element with key "card-1"
+/elements/card-1/children -> Children of card-1
 ```
 
 ## Server-Side Setup
@@ -60,77 +81,7 @@ export async function POST(req: Request) {
 }
 ```
 
-## Low-Level SpecStream API
-
-For custom or framework-agnostic streaming implementations, use the SpecStream compiler from `@json-render/core` directly:
-
-```typescript
-import { createSpecStreamCompiler } from '@json-render/core';
-
-// Create a compiler for your spec type
-const compiler = createSpecStreamCompiler<MySpec>();
-const decoder = new TextDecoder();
-
-// Process streaming chunks from AI
-async function processStream(reader: ReadableStreamDefaultReader<Uint8Array>) {
-  while (true) {
-    const { done, value } = await reader.read();
-    if (done) break;
-
-    // Decode the Uint8Array chunk to a string
-    const chunk = decoder.decode(value, { stream: true });
-    const { result, newPatches } = compiler.push(chunk);
-    
-    if (newPatches.length > 0) {
-      // Update UI with partial result
-      setSpec(result);
-    }
-  }
-  
-  // Get final compiled result
-  return compiler.getResult();
-}
-```
-
-### One-Shot Compilation
-
-For non-streaming scenarios, compile entire SpecStream at once:
-
-```typescript
-import { compileSpecStream } from '@json-render/core';
-
-const jsonl = `{"op":"add","path":"/root","value":"card-1"}
-{"op":"add","path":"/elements/card-1","value":{"type":"Card","props":{"title":"Hello"},"children":[]}}`;
-
-const spec = compileSpecStream<Spec>(jsonl);
-// { root: "card-1", elements: { "card-1": { type: "Card", props: { title: "Hello" }, children: [] } } }
-```
-
-## Usage with React
-
-`@json-render/react` provides the `useUIStream` hook, which wraps the low-level compiler in a React-friendly API with state management, error handling, and abort support.
-
-### useUIStream Hook
-
-```tsx
-import { useUIStream } from '@json-render/react';
-
-function App() {
-  const {
-    spec,          // Current UI spec state
-    isStreaming,   // True while streaming
-    error,         // Any error that occurred
-    send,          // Function to start generation
-    clear,         // Function to reset spec and error
-  } = useUIStream({
-    api: '/api/generate',
-    onComplete: (spec) => {},  // Optional: called when streaming completes
-    onError: (error) => {},    // Optional: called when an error occurs
-  });
-}
-```
-
-### Progressive Rendering
+## Progressive Rendering
 
 The Renderer automatically updates as the spec changes:
 
@@ -147,7 +98,7 @@ function App() {
 }
 ```
 
-### Aborting Streams
+## Aborting Streams
 
 Calling `send` again automatically aborts the previous request. Use `clear` to reset the spec and error state:
 
@@ -168,4 +119,45 @@ function App() {
 }
 ```
 
-See the [@json-render/react API reference](/docs/api/react) for full `useUIStream` documentation.
+## Low-Level SpecStream API
+
+For custom streaming implementations, use the SpecStream compiler directly:
+
+```typescript
+import { createSpecStreamCompiler } from '@json-render/core';
+
+// Create a compiler for your spec type
+const compiler = createSpecStreamCompiler<MySpec>();
+
+// Process streaming chunks from AI
+async function processStream(reader: ReadableStreamDefaultReader) {
+  while (true) {
+    const { done, value } = await reader.read();
+    if (done) break;
+    
+    const { result, newPatches } = compiler.push(value);
+    
+    if (newPatches.length > 0) {
+      // Update UI with partial result
+      setSpec(result);
+    }
+  }
+  
+  // Get final compiled result
+  return compiler.getResult();
+}
+```
+
+### One-Shot Compilation
+
+For non-streaming scenarios, compile entire SpecStream at once:
+
+```typescript
+import { compileSpecStream } from '@json-render/core';
+
+const jsonl = `{"op":"add","path":"/root","value":{"type":"Card"}}
+{"op":"add","path":"/root/props","value":{"title":"Hello"}}`;
+
+const spec = compileSpecStream<MySpec>(jsonl);
+// { root: { type: "Card", props: { title: "Hello" } } }
+```

apps/web/app/(main)/docs/validation/page.mdx

@@ -1,5 +1,4 @@
-import { pageMetadata } from "@/lib/page-metadata"
-export const metadata = pageMetadata("docs/validation")
+export const metadata = { title: "Validation" }
 
 # Validation
 
@@ -11,32 +10,23 @@ json-render includes common validation functions:
 
 - `required` — Value must be non-empty
 - `email` — Valid email format
-- `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" } }`)
+- `minLength` — Minimum string length
+- `maxLength` — Maximum string length
+- `pattern` — Match a regex pattern
+- `min` — Minimum numeric value
+- `max` — Maximum numeric value
 
 ## Using Validation in JSON
 
-Use `{ "$bindState": "/path" }` on the value prop for two-way binding. Validation checks run against the value at the bound path (available as `bindings?.value` in components):
-
 ```json
 {
   "type": "TextField",
   "props": {
     "label": "Email",
-    "value": { "$bindState": "/form/email" },
+    "valuePath": "/form/email",
     "checks": [
-      { "type": "required", "message": "Email is required" },
-      { "type": "email", "message": "Invalid email format" }
+      { "fn": "required", "message": "Email is required" },
+      { "fn": "email", "message": "Invalid email format" }
     ],
     "validateOn": "blur"
   }
@@ -50,16 +40,16 @@ Use `{ "$bindState": "/path" }` on the value prop for two-way binding. Validatio
   "type": "TextField",
   "props": {
     "label": "Password",
-    "value": { "$bindState": "/form/password" },
+    "valuePath": "/form/password",
     "checks": [
-      { "type": "required", "message": "Password is required" },
+      { "fn": "required", "message": "Password is required" },
       { 
-        "type": "minLength", 
-        "args": { "min": 8 },
+        "fn": "minLength", 
+        "args": { "length": 8 },
         "message": "Password must be at least 8 characters"
       },
       {
-        "type": "pattern",
+        "fn": "pattern",
         "args": { "pattern": "[A-Z]" },
         "message": "Must contain at least one uppercase letter"
       }
@@ -70,11 +60,11 @@ Use `{ "$bindState": "/path" }` on the value prop for two-way binding. Validatio
 
 ## Custom Validation Functions
 
-Define custom validators in your catalog's `functions` field. The catalog itself is framework-agnostic — only the `schema` import varies by platform:
+Define custom validators in your catalog:
 
 ```typescript
 import { defineCatalog } from '@json-render/core';
-import { schema } from '@json-render/react/schema'; // or '@json-render/react-native/schema'
+import { schema } from '@json-render/react';
 import { z } from 'zod';
 
 const catalog = defineCatalog(schema, {
@@ -90,9 +80,7 @@ const catalog = defineCatalog(schema, {
 });
 ```
 
-## Usage with React
-
-In `@json-render/react`, use `ValidationProvider` to supply implementations for your custom validators:
+Then implement them in your ValidationProvider:
 
 ```tsx
 import { ValidationProvider } from '@json-render/react';
@@ -111,25 +99,22 @@ function App() {
   };
 
   return (
-    <ValidationProvider customFunctions={customValidators}>
+    <ValidationProvider functions={customValidators}>
       {/* Your UI */}
     </ValidationProvider>
   );
 }
 ```
 
-### Using in Components
-
-The `useFieldValidation` and `useBoundProp` hooks wire validation into your registry components. Validation uses the path from `bindings?.value` (the bound state path):
+## Using in Components
 
 ```tsx
-import { useFieldValidation, useBoundProp } from '@json-render/react';
+import { useFieldValidation } from '@json-render/react';
 
-function TextField({ props, bindings }) {
-  const [value, setValue] = useBoundProp(props.value, bindings?.value);
-  const { errors, isValid, validate, touch, clear } = useFieldValidation(
-    bindings?.value ?? null,
-    { checks: props.checks, validateOn: props.validateOn }
+function TextField({ props }) {
+  const { value, setValue, errors, validate } = useFieldValidation(
+    props.valuePath,
+    props.checks
   );
 
   return (
@@ -148,116 +133,14 @@ 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 (default for Input, Textarea)
+- `blur` — Validate when field loses focus
 - `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
 
-- [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
+Learn about [AI SDK integration](/docs/ai-sdk).

apps/web/app/(main)/docs/visibility/page.mdx

@@ -1,312 +1,15 @@
-import { pageMetadata } from "@/lib/page-metadata"
-export const metadata = pageMetadata("docs/visibility")
+export const metadata = { title: "Visibility" }
 
 # Visibility
 
-Conditionally show or hide components based on state values and logic.
+Conditionally show or hide components based on data, auth, or logic.
 
-## State-Based Visibility
+## VisibilityProvider
 
-Show/hide based on state values. Use `$state` with a JSON Pointer path:
-
-```json
-{
-  "type": "Alert",
-  "props": { "message": "Form has errors" },
-  "visible": { "$state": "/form/hasErrors" }
-}
-```
-
-Visible when `/form/hasErrors` is truthy.
-
-### Negation
-
-Use `not: true` to invert a condition:
-
-```json
-{
-  "type": "WelcomeBanner",
-  "visible": { "$state": "/user/hasSeenWelcome", "not": true }
-}
-```
-
-Visible when `/user/hasSeenWelcome` is falsy.
-
-## Auth-Based Visibility
-
-Show/hide based on authentication state. Expose your auth state in the state model (e.g. at `/auth/isSignedIn`):
-
-```json
-{
-  "type": "AdminPanel",
-  "visible": { "$state": "/auth/isSignedIn" }
-}
-```
-
-For signed-out only:
-
-```json
-{
-  "type": "LoginPrompt",
-  "visible": { "$state": "/auth/isSignedIn", "not": true }
-}
-```
-
-## Comparison Operators
-
-Compare a state value to a literal or another state path. Use **one operator per condition** -- if multiple are provided, only the first one is evaluated (precedence: `eq` > `neq` > `gt` > `gte` > `lt` > `lte`). Add `"not": true` to invert the result of any condition.
-
-```json
-// Equal
-{
-  "visible": { "$state": "/user/role", "eq": "admin" }
-}
-
-// Not equal
-{
-  "visible": { "$state": "/tab", "neq": "home" }
-}
-
-// Greater than
-{
-  "visible": { "$state": "/cart/total", "gt": 100 }
-}
-
-// Greater than or equal
-{
-  "visible": { "$state": "/cart/itemCount", "gte": 1 }
-}
-
-// Less than
-{
-  "visible": { "$state": "/cart/total", "lt": 1000 }
-}
-
-// Less than or equal
-{
-  "visible": { "$state": "/cart/itemCount", "lte": 10 }
-}
-```
-
-Comparison values can be literals or state references:
-
-```json
-{
-  "visible": { "$state": "/user/balance", "gte": { "$state": "/order/minimum" } }
-}
-```
-
-## Combining Conditions (AND)
-
-Place multiple conditions in an array for implicit AND:
-
-```json
-{
-  "type": "SubmitButton",
-  "visible": [
-    { "$state": "/form/isValid" },
-    { "$state": "/form/hasChanges" }
-  ]
-}
-```
-
-All conditions must be true for the element to be visible.
-
-## OR Conditions
-
-Use `$or` when at least one condition should be true:
-
-```json
-{
-  "type": "SpecialOffer",
-  "visible": { "$or": [
-    { "$state": "/user/isVIP" },
-    { "$state": "/cart/total", "gt": 200 }
-  ]}
-}
-```
-
-Visible when the user is VIP **or** the cart total exceeds 200. `$or` can contain any visibility conditions, including nested arrays (AND) and comparisons.
-
-## Explicit AND
-
-Use `$and` when you need to nest AND logic inside `$or`:
-
-```json
-{
-  "type": "PromoCard",
-  "visible": { "$or": [
-    { "$and": [
-      { "$state": "/user/isVIP" },
-      { "$state": "/cart/total", "gt": 50 }
-    ]},
-    { "$state": "/promo/active" }
-  ]}
-}
-```
-
-For top-level AND, the implicit array form is simpler: `[condition, condition]`. Use `$and` only when nesting inside `$or`.
-
-## Always / Never
-
-Use boolean literals for constant visibility:
-
-```json
-{
-  "type": "Footer",
-  "visible": true
-}
-```
-
-```json
-{
-  "type": "DeprecatedPanel",
-  "visible": false
-}
-```
-
-## Repeat-Scoped Conditions
-
-Inside a [repeat](/docs/data-binding#repeat), use `$item` and `$index` conditions to show/hide based on the current item:
-
-### `$item` — Condition on item field
-
-```json
-{
-  "type": "Badge",
-  "props": { "label": "Overdue" },
-  "visible": { "$item": "isOverdue" }
-}
-```
-
-With comparison:
-
-```json
-{
-  "type": "DiscountTag",
-  "visible": { "$item": "price", "gt": 100 }
-}
-```
-
-### `$index` — Condition on array index
-
-```json
-{
-  "type": "Divider",
-  "visible": { "$index": true, "gt": 0 }
-}
-```
-
-This shows the divider for every item except the first (index 0).
-
-`$item` and `$index` conditions support the same comparison operators as `$state` (`eq`, `neq`, `gt`, `gte`, `lt`, `lte`, `not`).
-
-## Complex Example
-
-```json
-{
-  "type": "RefundButton",
-  "props": { "label": "Process Refund" },
-  "visible": [
-    { "$state": "/auth/isSignedIn" },
-    { "$state": "/user/role", "eq": "support" },
-    { "$state": "/order/amount", "gt": 0 },
-    { "$state": "/order/isRefunded", "not": true }
-  ]
-}
-```
-
-## Quick Reference
-
-<div className="my-6 overflow-x-auto">
-  <table className="mdx-table w-full text-sm border-collapse">
-    <thead>
-      <tr>
-        <th>Condition</th>
-        <th>Syntax</th>
-      </tr>
-    </thead>
-    <tbody>
-      <tr>
-        <td>Truthiness</td>
-        <td><code>{'{ "$state": "/path" }'}</code></td>
-      </tr>
-      <tr>
-        <td>Falsy (not)</td>
-        <td><code>{'{ "$state": "/path", "not": true }'}</code></td>
-      </tr>
-      <tr>
-        <td>Equal</td>
-        <td><code>{'{ "$state": "/path", "eq": value }'}</code></td>
-      </tr>
-      <tr>
-        <td>Not equal</td>
-        <td><code>{'{ "$state": "/path", "neq": value }'}</code></td>
-      </tr>
-      <tr>
-        <td>Greater than</td>
-        <td><code>{'{ "$state": "/path", "gt": number }'}</code></td>
-      </tr>
-      <tr>
-        <td>Greater or equal</td>
-        <td><code>{'{ "$state": "/path", "gte": number }'}</code></td>
-      </tr>
-      <tr>
-        <td>Less than</td>
-        <td><code>{'{ "$state": "/path", "lt": number }'}</code></td>
-      </tr>
-      <tr>
-        <td>Less or equal</td>
-        <td><code>{'{ "$state": "/path", "lte": number }'}</code></td>
-      </tr>
-      <tr>
-        <td>Item field (repeat)</td>
-        <td><code>{'{ "$item": "field" }'}</code></td>
-      </tr>
-      <tr>
-        <td>Item comparison</td>
-        <td><code>{'{ "$item": "field", "eq": value }'}</code></td>
-      </tr>
-      <tr>
-        <td>Index (repeat)</td>
-        <td><code>{'{ "$index": true, "gt": 0 }'}</code></td>
-      </tr>
-      <tr>
-        <td>AND (implicit)</td>
-        <td><code>{"[ condition, condition ]"}</code></td>
-      </tr>
-      <tr>
-        <td>AND (explicit)</td>
-        <td><code>{'{ "$and": [ condition, condition ] }'}</code></td>
-      </tr>
-      <tr>
-        <td>OR</td>
-        <td><code>{'{ "$or": [ condition, condition ] }'}</code></td>
-      </tr>
-      <tr>
-        <td>Always</td>
-        <td><code>{"true"}</code></td>
-      </tr>
-      <tr>
-        <td>Never</td>
-        <td><code>{"false"}</code></td>
-      </tr>
-    </tbody>
-  </table>
-</div>
-
-Comparison values can be literals or state references for state-to-state comparisons:
-
-```json
-{ "$state": "/a", "eq": { "$state": "/b" } }
-```
-
-## Usage with React
-
-In `@json-render/react`, wrap your app with `VisibilityProvider` to enable conditional rendering. The `Renderer` handles visibility automatically — elements with unmet conditions are not rendered.
+Wrap your app with VisibilityProvider to enable conditional rendering:
 
 ```tsx
-import { VisibilityProvider, StateProvider } from '@json-render/react';
+import { VisibilityProvider } from '@json-render/react';
 
 function App() {
   return (
@@ -319,21 +22,120 @@ function App() {
 }
 ```
 
-For advanced use cases, the `useIsVisible` hook lets you evaluate visibility conditions programmatically:
+## Path-Based Visibility
+
+Show/hide based on data values:
+
+```json
+{
+  "type": "Alert",
+  "props": { "message": "Form has errors" },
+  "visible": { "path": "/form/hasErrors" }
+}
+
+// Visible when /form/hasErrors is truthy
+```
+
+## Auth-Based Visibility
+
+Show/hide based on authentication state:
+
+```json
+{
+  "type": "AdminPanel",
+  "visible": { "auth": "signedIn" }
+}
+
+// Options: "signedIn", "signedOut", "admin", etc.
+```
+
+## Logic Expressions
+
+Combine conditions with logic operators:
+
+```json
+// AND - all conditions must be true
+{
+  "type": "SubmitButton",
+  "visible": {
+    "and": [
+      { "path": "/form/isValid" },
+      { "path": "/form/hasChanges" }
+    ]
+  }
+}
+
+// OR - any condition must be true
+{
+  "type": "HelpText",
+  "visible": {
+    "or": [
+      { "path": "/user/isNew" },
+      { "path": "/settings/showHelp" }
+    ]
+  }
+}
+
+// NOT - invert a condition
+{
+  "type": "WelcomeBanner",
+  "visible": {
+    "not": { "path": "/user/hasSeenWelcome" }
+  }
+}
+```
+
+## Comparison Operators
+
+```json
+// Equal
+{
+  "visible": {
+    "eq": [{ "path": "/user/role" }, "admin"]
+  }
+}
+
+// Greater than
+{
+  "visible": {
+    "gt": [{ "path": "/cart/total" }, 100]
+  }
+}
+
+// Available: eq, ne, gt, gte, lt, lte
+```
+
+## Complex Example
+
+```json
+{
+  "type": "RefundButton",
+  "props": { "label": "Process Refund" },
+  "visible": {
+    "and": [
+      { "auth": "signedIn" },
+      { "eq": [{ "path": "/user/role" }, "support"] },
+      { "gt": [{ "path": "/order/amount" }, 0] },
+      { "not": { "path": "/order/isRefunded" } }
+    ]
+  }
+}
+```
+
+## Using in Components
 
 ```tsx
 import { useIsVisible } from '@json-render/react';
 
+// The Renderer handles visibility automatically, but you can also use the hook
 function ConditionalContent({ condition, children }) {
   const isVisible = useIsVisible(condition);
-
+  
   if (!isVisible) return null;
   return <div>{children}</div>;
 }
 ```
 
-See the [@json-render/react API reference](/docs/api/react) for full details.
-
 ## Next
 
 Learn about [form validation](/docs/validation).

apps/web/app/(main)/docs/watchers/page.mdx

@@ -1,167 +0,0 @@
-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`
-
-<table>
-<thead>
-<tr>
-<th>Mechanism</th>
-<th>Trigger</th>
-<th>Use Case</th>
-</tr>
-</thead>
-<tbody>
-<tr>
-<td><code>on</code></td>
-<td>User interaction (press, change, blur)</td>
-<td>Button clicks, input changes, form submissions</td>
-</tr>
-<tr>
-<td><code>watch</code></td>
-<td>State value change (any source)</td>
-<td>Cascading data, derived state, cross-field sync</td>
-</tr>
-</tbody>
-</table>
-
-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

apps/web/app/(main)/page.tsx

@@ -10,15 +10,14 @@ export default function Home() {
       {/* Hero */}
       <section className="max-w-5xl mx-auto px-6 pt-24 pb-16 text-center">
         <p className="text-xs sm:text-sm font-medium text-muted-foreground tracking-widest uppercase mb-4">
-          The Generative UI Framework
+          The framework for User-Generated Interfaces
         </p>
         <h1 className="text-4xl sm:text-6xl md:text-7xl font-bold tracking-tighter mb-6">
           AI → json-render → UI
         </h1>
         <p className="text-lg text-muted-foreground max-w-2xl mx-auto mb-12 leading-relaxed">
-          Generate dynamic, personalized UIs from prompts without sacrificing
-          reliability. Predefined components and actions for safe, predictable
-          output.
+          Dynamic, personalized UIs per user without sacrificing reliability.
+          Predefined components and actions for safe, predictable output.
         </p>
 
         <Demo />
@@ -69,10 +68,10 @@ export default function Home() {
               <div className="text-xs text-muted-foreground font-mono mb-3">
                 02
               </div>
-              <h3 className="text-lg font-semibold mb-2">AI Generates</h3>
+              <h3 className="text-lg font-semibold mb-2">Users Generate</h3>
               <p className="text-sm text-muted-foreground leading-relaxed">
-                Describe what you want. AI generates JSON constrained to your
-                catalog. Every interface is unique.
+                End users describe what they want. AI generates JSON constrained
+                to your catalog. Every interface is unique to the user.
               </p>
             </div>
             <div>
@@ -100,12 +99,10 @@ export default function Home() {
               <p className="text-muted-foreground mb-6">
                 Components, actions, and validation functions.
               </p>
-              <Code lang="typescript">{`import { defineSchema, defineCatalog } from '@json-render/core';
+              <Code lang="typescript">{`import { createCatalog } from '@json-render/core';
 import { z } from 'zod';
 
-const schema = defineSchema({ /* ... */ });
-
-export const catalog = defineCatalog(schema, {
+export const catalog = createCatalog({
   components: {
     Card: {
       props: z.object({
@@ -117,7 +114,7 @@ export const catalog = defineCatalog(schema, {
     Metric: {
       props: z.object({
         label: z.string(),
-        statePath: z.string(),
+        valuePath: z.string(),
         format: z.enum(['currency', 'percent']),
       }),
     },
@@ -146,7 +143,7 @@ export const catalog = defineCatalog(schema, {
       "type": "Metric",
       "props": {
         "label": "Total Revenue",
-        "statePath": "/metrics/revenue",
+        "valuePath": "/metrics/revenue",
         "format": "currency"
       }
     }
@@ -185,7 +182,7 @@ export const catalog = defineCatalog(schema, {
       "type": "Metric",
       "props": {
         "label": "Total Revenue",
-        "statePath": "analytics/revenue",
+        "valuePath": "analytics/revenue",
         "format": "currency"
       }
     },
@@ -225,7 +222,7 @@ export default function Page() {
       <Metric
         data={data}
         label="Total Revenue"
-        statePath="analytics/revenue"
+        valuePath="analytics/revenue"
         format="currency"
       />
       <Chart data={data} statePath="analytics/salesByRegion" />
@@ -251,8 +248,8 @@ export default function Page() {
           <div className="grid sm:grid-cols-2 lg:grid-cols-3 gap-8">
             {[
               {
-                title: "Generative UI",
-                desc: "Generate dynamic, personalized interfaces from prompts with AI",
+                title: "User-Generated Interfaces",
+                desc: "Dynamic, personalized UIs per user powered by Generative UI",
               },
               {
                 title: "Guardrails",
@@ -268,7 +265,7 @@ export default function Page() {
               },
               {
                 title: "Data Binding",
-                desc: "Connect props to state with $state, $item, $index, and two-way binding",
+                desc: "Two-way state binding with dynamic prop expressions",
               },
               {
                 title: "Code Export",

apps/web/app/api/docs-chat/route.ts

@@ -16,20 +16,17 @@ const SYSTEM_PROMPT = `You are a helpful documentation assistant for json-render
 
 GitHub repository: https://github.com/vercel-labs/json-render
 Documentation: https://json-render.dev/docs
-npm packages: @json-render/core, @json-render/react, @json-render/vue, @json-render/svelte, @json-render/solid, @json-render/shadcn, @json-render/react-three-fiber, @json-render/react-native, @json-render/react-email, @json-render/react-pdf, @json-render/image, @json-render/remotion, @json-render/codegen, @json-render/mcp, @json-render/redux, @json-render/zustand, @json-render/jotai, @json-render/xstate, @json-render/yaml
-Skills: json-render ships AI agent skills that teach coding agents how to use each package. Install with "npx skills add vercel-labs/json-render --skill <name>". Available skills: core, react, react-pdf, react-email, react-native, shadcn, react-three-fiber, image, remotion, vue, svelte, solid, codegen, mcp, redux, zustand, jotai, xstate, yaml. See /docs/skills for details.
+npm packages: @json-render/core, @json-render/react, @json-render/remotion, @json-render/codegen
 
-You have access to the full json-render documentation via the bash and readFile tools. The docs are available as markdown files in the /workspace/docs/ directory.
+You have access to the full json-render documentation via the bash and readFile tools. The docs are available as markdown files in the /docs/ directory.
 
 When answering questions:
-- Use the bash tool to list files (ls /workspace/docs/) or search for content (grep -r "keyword" /workspace/docs/)
-- Use the readFile tool to read specific documentation pages (e.g. readFile with path "/workspace/docs/index.md")
-- Do NOT use bash to write, create, modify, or delete files (no tee, cat >, sed -i, echo >, cp, mv, rm, mkdir, touch, etc.) — you are read-only
+- Use the bash tool to list files (ls /docs/) or search for content (grep -r "keyword" /docs/)
+- Use the readFile tool to read specific documentation pages
 - Always base your answers on the actual documentation content
 - Be concise and accurate
 - If the docs don't cover a topic, say so honestly
-- Do NOT include source references or file paths in your response
-- Do NOT use emojis in your responses`;
+- Do NOT include source references or file paths in your response`;
 
 async function loadDocsFiles(): Promise<Record<string, string>> {
   const files: Record<string, string> = {};
@@ -109,19 +106,14 @@ export async function POST(req: Request) {
   const { messages }: { messages: UIMessage[] } = await req.json();
 
   const docsFiles = await loadDocsFiles();
-  const {
-    tools: { bash, readFile },
-  } = await createBashTool({ files: docsFiles });
+  const { tools } = await createBashTool({ files: docsFiles });
 
   const result = streamText({
     model: DEFAULT_MODEL,
     system: SYSTEM_PROMPT,
     messages: await convertToModelMessages(messages),
     stopWhen: stepCountIs(5),
-    tools: {
-      bash,
-      readFile,
-    },
+    tools,
     prepareStep: ({ messages: stepMessages }) => ({
       messages: addCacheControl(stepMessages),
     }),

apps/web/app/api/generate/route.ts

@@ -1,73 +1,31 @@
 import { streamText } from "ai";
 import { headers } from "next/headers";
-import type { Spec, EditMode } from "@json-render/core";
-import {
-  buildUserPrompt,
-  buildEditUserPrompt,
-  isNonEmptySpec,
-} from "@json-render/core";
-import { yamlPrompt } from "@json-render/yaml";
-import { stringify as yamlStringify } from "yaml";
+import { buildUserPrompt } from "@json-render/core";
 import { minuteRateLimit, dailyRateLimit } from "@/lib/rate-limit";
 import { playgroundCatalog } from "@/lib/render/catalog";
 
 export const maxDuration = 30;
 
-const PLAYGROUND_RULES = [
-  "NEVER use viewport height classes (min-h-screen, h-screen) - the UI renders inside a fixed-size container.",
-  "NEVER use page background colors (bg-gray-50) - the container has its own background.",
-  "For forms or small UIs: use Card as root with maxWidth:'sm' or 'md' and centered:true.",
-  "For content-heavy UIs (blogs, dashboards, product listings): use Stack or Grid as root. Use Grid with 2-3 columns for card layouts.",
-  "Wrap each repeated item in a Card for visual separation and structure.",
-  "Use realistic, professional sample data. Include 3-5 items with varied content. Never leave state arrays empty.",
-  'For form inputs (Input, Textarea, Select), always include checks for validation (e.g. required, email, minLength). Always pair checks with a $bindState expression on the value prop (e.g. { "$bindState": "/path" }).',
-];
+const SYSTEM_PROMPT = playgroundCatalog.prompt({
+  customRules: [
+    "NEVER use viewport height classes (min-h-screen, h-screen) - the UI renders inside a fixed-size container.",
+    "NEVER use page background colors (bg-gray-50) - the container has its own background.",
+    "For forms or small UIs: use Card as root with maxWidth:'sm' or 'md' and centered:true.",
+    "For content-heavy UIs (blogs, dashboards, product listings): use Stack or Grid as root. Use Grid with 2-3 columns for card layouts.",
+    "Wrap each repeated item in a Card for visual separation and structure.",
+    "Use realistic, professional sample data. Include 3-5 items with varied content. Never leave state arrays empty.",
+  ],
+});
 
 const MAX_PROMPT_LENGTH = 500;
 const DEFAULT_MODEL = "anthropic/claude-haiku-4.5";
 
-function getSystemPrompt(isYaml: boolean, editModes?: EditMode[]): string {
-  if (isYaml) {
-    return yamlPrompt(playgroundCatalog, {
-      mode: "standalone",
-      customRules: PLAYGROUND_RULES,
-      editModes: editModes ?? ["merge"],
-    });
-  }
-  return playgroundCatalog.prompt({
-    customRules: PLAYGROUND_RULES,
-    editModes,
-  });
-}
-
-function buildYamlUserPrompt(
-  prompt: string,
-  previousSpec?: Spec | null,
-  editModes?: EditMode[],
-): string {
-  if (isNonEmptySpec(previousSpec)) {
-    return buildEditUserPrompt({
-      prompt,
-      currentSpec: previousSpec,
-      config: { modes: editModes ?? ["merge"] },
-      format: "yaml",
-      maxPromptLength: MAX_PROMPT_LENGTH,
-      serializer: (s) => yamlStringify(s, { indent: 2 }).trimEnd(),
-    });
-  }
-
-  const userText = prompt.slice(0, MAX_PROMPT_LENGTH);
-  return [
-    userText,
-    "",
-    "Output the full spec in a ```yaml-spec fence. Stream progressively — output elements one at a time.",
-  ].join("\n");
-}
-
 export async function POST(req: Request) {
+  // Get client IP for rate limiting
   const headersList = await headers();
   const ip = headersList.get("x-forwarded-for")?.split(",")[0] ?? "anonymous";
 
+  // Check rate limits (minute and daily)
   const [minuteResult, dailyResult] = await Promise.all([
     minuteRateLimit.limit(ip),
     dailyRateLimit.limit(ip),
@@ -89,34 +47,22 @@ export async function POST(req: Request) {
     );
   }
 
-  const { prompt, context, format, editModes } = await req.json();
-  const isYaml = format === "yaml";
+  const { prompt, context } = await req.json();
 
-  const systemPrompt = getSystemPrompt(isYaml, editModes);
-  const userPrompt = isYaml
-    ? buildYamlUserPrompt(prompt, context?.previousSpec, editModes)
-    : buildUserPrompt({
-        prompt,
-        currentSpec: context?.previousSpec,
-        maxPromptLength: MAX_PROMPT_LENGTH,
-        editModes,
-      });
+  const userPrompt = buildUserPrompt({
+    prompt,
+    currentSpec: context?.previousSpec,
+    maxPromptLength: MAX_PROMPT_LENGTH,
+  });
 
   const result = streamText({
     model: process.env.AI_GATEWAY_MODEL || DEFAULT_MODEL,
-    system: [
-      {
-        role: "system",
-        content: systemPrompt,
-        providerOptions: {
-          anthropic: { cacheControl: { type: "ephemeral" } },
-        },
-      },
-    ],
+    system: SYSTEM_PROMPT,
     prompt: userPrompt,
     temperature: 0.7,
   });
 
+  // Stream the text, then append token usage metadata at the end
   const encoder = new TextEncoder();
   const textStream = result.textStream;
 
@@ -125,6 +71,7 @@ export async function POST(req: Request) {
       for await (const chunk of textStream) {
         controller.enqueue(encoder.encode(chunk));
       }
+      // Append usage metadata after stream completes
       try {
         const usage = await result.usage;
         const meta = JSON.stringify({
@@ -132,12 +79,10 @@ export async function POST(req: Request) {
           promptTokens: usage.inputTokens,
           completionTokens: usage.outputTokens,
           totalTokens: usage.totalTokens,
-          cachedTokens: usage.inputTokenDetails?.cacheReadTokens ?? 0,
-          cacheWriteTokens: usage.inputTokenDetails?.cacheWriteTokens ?? 0,
         });
         controller.enqueue(encoder.encode(`\n${meta}\n`));
       } catch {
-        // Usage not available
+        // Usage not available -- skip silently
       }
       controller.close();
     },

apps/web/app/globals.css

@@ -28,7 +28,6 @@
   --border: oklch(0.85 0 0);
   --input: oklch(0.85 0 0);
   --ring: oklch(0.6 0 0);
-  --chat-bg: oklch(0.95 0 0);
 }
 
 .dark {
@@ -53,7 +52,6 @@
   --border: oklch(0.25 0 0);
   --input: oklch(0.25 0 0);
   --ring: oklch(0.4 0 0);
-  --chat-bg: oklch(0.25 0 0);
 }
 
 @theme inline {
@@ -111,77 +109,29 @@
     @apply bg-transparent p-0;
   }
 
-  /* Hide page scrollbar */
-  html {
-    scrollbar-width: none;
+  /* Custom scrollbar */
+  ::-webkit-scrollbar {
+    width: 8px;
+    height: 8px;
   }
 
-  html::-webkit-scrollbar {
-    display: none;
+  ::-webkit-scrollbar-track {
+    @apply bg-background;
   }
 
+  ::-webkit-scrollbar-thumb {
+    @apply bg-border rounded;
+  }
+
+  ::-webkit-scrollbar-thumb:hover {
+    @apply bg-muted-foreground;
+  }
 }
 
 button {
   cursor: pointer;
 }
 
-/* Tool call shimmer animation */
-@keyframes tool-shimmer {
-  0% { opacity: 0.5; }
-  50% { opacity: 1; }
-  100% { opacity: 0.5; }
-}
-
-.animate-tool-shimmer {
-  animation: tool-shimmer 1.5s ease-in-out infinite;
-}
-
-/* Fix list rendering in chat content */
-.docs-chat-content ul,
-.docs-chat-content ol {
-  list-style-position: outside;
-  padding-left: 1.25em;
-}
-
-.docs-chat-content li > p {
-  display: inline;
-  margin: 0;
-}
-
-.docs-chat-content li {
-  margin-top: 0.5em;
-  margin-bottom: 0.5em;
-}
-
-/* MDX table styles — applies to both GFM pipe tables and raw HTML tables */
-.mdx-table th,
-.mdx-table td,
-article table th,
-article table td {
-  border: 1px solid var(--border);
-  padding: 0.75rem 1rem;
-  text-align: left;
-}
-
-.mdx-table th,
-article table th {
-  font-weight: 600;
-  background-color: var(--muted);
-}
-
-.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 {
@@ -194,4 +144,3 @@ article table {
   color: var(--shiki-dark) !important;
   background-color: var(--shiki-dark-bg) !important;
 }
-

apps/web/app/layout.tsx

@@ -1,13 +1,10 @@
 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";
 import { Analytics } from "@vercel/analytics/next";
 import { SpeedInsights } from "@vercel/speed-insights/next";
 import { PAGE_TITLES } from "@/lib/page-titles";
-import { cookies } from "next/headers";
 
 const geistSans = localFont({
   src: "./fonts/GeistVF.woff",
@@ -25,12 +22,13 @@ export const metadata: Metadata = {
     template: "%s | json-render",
   },
   description:
-    "The Generative UI framework. Generate dashboards, widgets, and apps from prompts — safely constrained to components you define.",
+    "The framework for User-Generated Interfaces (UGI). Let users generate dashboards, widgets, and apps from prompts — safely constrained to components you define.",
   keywords: [
     "json-render",
-    "generative UI",
+    "UGI",
+    "User-Generated Interfaces",
     "AI UI generation",
-    "user-generated interfaces",
+    "generative UI",
     "React components",
     "React Native",
     "guardrails",
@@ -44,24 +42,25 @@ export const metadata: Metadata = {
     locale: "en_US",
     url: "https://json-render.dev",
     siteName: "json-render",
-    title: "json-render | The Generative UI Framework",
+    title: "json-render | The framework for User-Generated Interfaces",
     description:
-      "The Generative UI framework. Generate dashboards, widgets, and apps from prompts — safely constrained to components you define.",
+      "The framework for User-Generated Interfaces (UGI). Let users generate dashboards, widgets, and apps from prompts — safely constrained to components you define.",
     images: [
       {
         url: "/og",
         width: 1200,
         height: 630,
-        alt: "json-render - The Generative UI Framework",
+        alt: "json-render - The framework for User-Generated Interfaces",
       },
     ],
   },
   twitter: {
     card: "summary_large_image",
-    title: "json-render | The Generative UI Framework",
+    title: "json-render | The framework for User-Generated Interfaces",
     description:
-      "The Generative UI framework. Generate dashboards, widgets, and apps from prompts — safely constrained to components you define.",
+      "The framework for User-Generated Interfaces (UGI). Let users generate dashboards, widgets, and apps from prompts — safely constrained to components you define.",
     images: ["/og"],
+    creator: "@verabornnot",
   },
   robots: {
     index: true,
@@ -72,33 +71,15 @@ export const metadata: Metadata = {
   },
 };
 
-export default async function RootLayout({
+export default function RootLayout({
   children,
 }: Readonly<{
   children: React.ReactNode;
 }>) {
-  const cookieStore = await cookies();
-  const chatOpen = cookieStore.get("docs-chat-open")?.value === "true";
-  const chatWidth = Number(cookieStore.get("docs-chat-width")?.value) || 400;
-
   return (
     <html lang="en" suppressHydrationWarning>
-      <head>
-        {chatOpen && (
-          <style
-            dangerouslySetInnerHTML={{
-              __html: `@media(min-width:640px){body{padding-right:${chatWidth}px}}`,
-            }}
-          />
-        )}
-      </head>
-      <body
-        className={`${geistSans.variable} ${geistMono.variable} ${GeistPixelSquare.variable}`}
-      >
-        <ThemeProvider>
-          {children}
-          <DocsChat defaultOpen={chatOpen} defaultWidth={chatWidth} />
-        </ThemeProvider>
+      <body className={`${geistSans.variable} ${geistMono.variable}`}>
+        <ThemeProvider>{children}</ThemeProvider>
         <Analytics />
         <SpeedInsights />
       </body>

apps/web/app/og/og-image.tsx

@@ -5,20 +5,19 @@ import { join } from "node:path";
 export { getPageTitle } from "@/lib/page-titles";
 
 // Cache font data in memory after first load
-let fontCache: { geistRegular: Buffer; geistPixelSquare: Buffer } | null = null;
+let fontCache: { geistRegular: Buffer } | null = null;
 
 async function loadFonts() {
   if (fontCache) return fontCache;
-  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 };
+  const geistRegular = await readFile(
+    join(process.cwd(), "public/Geist-Regular.ttf"),
+  );
+  fontCache = { geistRegular };
   return fontCache;
 }
 
 export async function renderOgImage(title: string) {
-  const { geistRegular, geistPixelSquare } = await loadFonts();
+  const { geistRegular } = await loadFonts();
 
   return new ImageResponse(
     <div
@@ -54,8 +53,8 @@ export async function renderOgImage(title: string) {
         <span
           style={{
             fontSize: 36,
-            fontFamily: "Geist Pixel Square",
-            fontWeight: 500,
+            fontFamily: "Geist",
+            fontWeight: 400,
             color: "white",
           }}
         >
@@ -100,12 +99,6 @@ export async function renderOgImage(title: string) {
           style: "normal",
           weight: 400,
         },
-        {
-          name: "Geist Pixel Square",
-          data: geistPixelSquare.buffer as ArrayBuffer,
-          style: "normal",
-          weight: 500,
-        },
       ],
     },
   );

apps/web/app/playground/page.tsx

@@ -1,7 +1,10 @@
 import { Playground } from "@/components/playground";
-import { pageMetadata } from "@/lib/page-metadata";
 
-export const metadata = pageMetadata("playground");
+import { PAGE_TITLES } from "@/lib/page-titles";
+
+export const metadata = {
+  title: PAGE_TITLES["playground"],
+};
 
 export default function PlaygroundPage() {
   return <Playground />;

apps/web/components/code-block.tsx

@@ -145,7 +145,7 @@ function getHighlighter() {
   if (!highlighterPromise) {
     highlighterPromise = createHighlighter({
       themes: [vercelLightTheme, vercelDarkTheme],
-      langs: ["json", "tsx", "typescript", "yaml"],
+      langs: ["json", "tsx", "typescript"],
     });
   }
   return highlighterPromise;
@@ -158,7 +158,7 @@ if (typeof window !== "undefined") {
 
 interface CodeBlockProps {
   code: string;
-  lang: "json" | "tsx" | "typescript" | "yaml";
+  lang: "json" | "tsx" | "typescript";
   fillHeight?: boolean;
   hideCopyButton?: boolean;
 }

apps/web/components/demo.tsx

@@ -16,7 +16,6 @@ import { CopyButton } from "./copy-button";
 import { Toaster } from "./ui/sonner";
 import { PlaygroundRenderer } from "@/lib/render/renderer";
 import { playgroundCatalog } from "@/lib/render/catalog";
-import { buildCatalogDisplayData } from "@/lib/render/catalog-display";
 
 const SIMULATION_PROMPT = "Create a contact form with name, email, and message";
 
@@ -25,54 +24,10 @@ interface SimulationStage {
   stream: string;
 }
 
-// Shared state & element definitions for the progressive simulation stages.
-const FORM_STATE = { form: { name: "", email: "", message: "" } };
-
-const NAME_INPUT = {
-  type: "Input",
-  props: {
-    label: "Name",
-    name: "name",
-    statePath: "/form/name",
-    checks: [{ type: "required", message: "Name is required" }],
-  },
-} as const;
-
-const EMAIL_INPUT = {
-  type: "Input",
-  props: {
-    label: "Email",
-    name: "email",
-    type: "email",
-    statePath: "/form/email",
-    checks: [
-      { type: "required", message: "Email is required" },
-      { type: "email", message: "Please enter a valid email" },
-    ],
-  },
-} as const;
-
-const MESSAGE_INPUT = {
-  type: "Textarea",
-  props: {
-    label: "Message",
-    name: "message",
-    statePath: "/form/message",
-    checks: [{ type: "required", message: "Message is required" }],
-  },
-} as const;
-
-const SUBMIT_BUTTON = {
-  type: "Button",
-  props: { label: "Send Message", variant: "primary" },
-  on: { press: { action: "formSubmit" } },
-} as const;
-
 const SIMULATION_STAGES: SimulationStage[] = [
   {
     tree: {
       root: "card",
-      state: FORM_STATE,
       elements: {
         card: {
           type: "Card",
@@ -86,72 +41,98 @@ const SIMULATION_STAGES: SimulationStage[] = [
   {
     tree: {
       root: "card",
-      state: FORM_STATE,
       elements: {
         card: {
           type: "Card",
           props: { title: "Contact Us", maxWidth: "md" },
           children: ["name"],
         },
-        name: NAME_INPUT,
+        name: {
+          type: "Input",
+          props: { label: "Name", name: "name" },
+        },
       },
     },
     stream:
-      '{"op":"add","path":"/elements/name","value":{"type":"Input","props":{"label":"Name","name":"name","statePath":"/form/name","checks":[{"type":"required","message":"Name is required"}]}}}',
+      '{"op":"add","path":"/elements/card","value":{"type":"Card","props":{"title":"Contact Us","maxWidth":"md"},"children":["name"]}}',
   },
   {
     tree: {
       root: "card",
-      state: FORM_STATE,
       elements: {
         card: {
           type: "Card",
           props: { title: "Contact Us", maxWidth: "md" },
           children: ["name", "email"],
         },
-        name: NAME_INPUT,
-        email: EMAIL_INPUT,
+        name: {
+          type: "Input",
+          props: { label: "Name", name: "name" },
+        },
+        email: {
+          type: "Input",
+          props: { label: "Email", name: "email" },
+        },
       },
     },
     stream:
-      '{"op":"add","path":"/elements/email","value":{"type":"Input","props":{"label":"Email","name":"email","type":"email","statePath":"/form/email","checks":[{"type":"required","message":"Email is required"},{"type":"email","message":"Please enter a valid email"}]}}}',
+      '{"op":"add","path":"/elements/email","value":{"type":"Input","props":{"label":"Email","name":"email"}}}',
   },
   {
     tree: {
       root: "card",
-      state: FORM_STATE,
       elements: {
         card: {
           type: "Card",
           props: { title: "Contact Us", maxWidth: "md" },
           children: ["name", "email", "message"],
         },
-        name: NAME_INPUT,
-        email: EMAIL_INPUT,
-        message: MESSAGE_INPUT,
+        name: {
+          type: "Input",
+          props: { label: "Name", name: "name" },
+        },
+        email: {
+          type: "Input",
+          props: { label: "Email", name: "email" },
+        },
+        message: {
+          type: "Textarea",
+          props: { label: "Message", name: "message" },
+        },
       },
     },
     stream:
-      '{"op":"add","path":"/elements/message","value":{"type":"Textarea","props":{"label":"Message","name":"message","statePath":"/form/message","checks":[{"type":"required","message":"Message is required"}]}}}',
+      '{"op":"add","path":"/elements/message","value":{"type":"Textarea","props":{"label":"Message","name":"message"}}}',
   },
   {
     tree: {
       root: "card",
-      state: FORM_STATE,
       elements: {
         card: {
           type: "Card",
           props: { title: "Contact Us", maxWidth: "md" },
           children: ["name", "email", "message", "submit"],
         },
-        name: NAME_INPUT,
-        email: EMAIL_INPUT,
-        message: MESSAGE_INPUT,
-        submit: SUBMIT_BUTTON,
+        name: {
+          type: "Input",
+          props: { label: "Name", name: "name" },
+        },
+        email: {
+          type: "Input",
+          props: { label: "Email", name: "email" },
+        },
+        message: {
+          type: "Textarea",
+          props: { label: "Message", name: "message" },
+        },
+        submit: {
+          type: "Button",
+          props: { label: "Send Message", variant: "primary" },
+        },
       },
     },
     stream:
-      '{"op":"add","path":"/elements/submit","value":{"type":"Button","props":{"label":"Send Message","variant":"primary"},"on":{"press":{"action":"formSubmit"}}}}',
+      '{"op":"add","path":"/elements/submit","value":{"type":"Button","props":{"label":"Send Message","variant":"primary"}}}',
   },
 ];
 
@@ -249,10 +230,87 @@ export function Demo({
   >("components");
 
   // Catalog data for the catalog tab
-  const catalogData = useMemo(
-    () => buildCatalogDisplayData(playgroundCatalog.data),
-    [],
-  );
+  const catalogData = useMemo(() => {
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    const raw = playgroundCatalog.data as any;
+
+    function extractFields(zodObj: unknown): { name: string; type: string }[] {
+      if (!zodObj) return [];
+      try {
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        const obj = zodObj as any;
+        const shape =
+          typeof obj.shape === "object"
+            ? obj.shape
+            : typeof obj._def?.shape === "function"
+              ? obj._def.shape()
+              : typeof obj._def?.shape === "object"
+                ? obj._def.shape
+                : null;
+        if (!shape) return [];
+
+        return Object.entries(shape).map(([name, schema]) => {
+          let type = "unknown";
+          try {
+            // eslint-disable-next-line @typescript-eslint/no-explicit-any
+            const s = schema as any;
+            const typeName: string =
+              s?._zod?.def?.type ?? s?._def?.typeName ?? "";
+            if (typeName.includes("string")) type = "string";
+            else if (typeName.includes("number")) type = "number";
+            else if (typeName.includes("boolean")) type = "boolean";
+            else if (typeName.includes("array")) type = "array";
+            else if (typeName.includes("enum")) {
+              const values = s?._zod?.def?.values ?? s?._def?.values;
+              type = Array.isArray(values) ? values.join(" | ") : "enum";
+            } else if (typeName.includes("union")) type = "union";
+            else if (typeName.includes("nullable")) {
+              const inner = s?._zod?.def?.innerType ?? s?._def?.innerType;
+              const innerName: string =
+                inner?._zod?.def?.type ?? inner?._def?.typeName ?? "";
+              if (innerName.includes("string")) type = "string?";
+              else if (innerName.includes("number")) type = "number?";
+              else if (innerName.includes("boolean")) type = "boolean?";
+              else if (innerName.includes("array")) type = "array?";
+              else if (innerName.includes("enum")) {
+                const values = inner?._zod?.def?.values ?? inner?._def?.values;
+                type = Array.isArray(values)
+                  ? `(${values.join(" | ")})?`
+                  : "enum?";
+              } else type = "optional";
+            }
+          } catch {
+            // ignore
+          }
+          return { name, type };
+        });
+      } catch {
+        return [];
+      }
+    }
+
+    const components = Object.entries(raw.components ?? {})
+      // eslint-disable-next-line @typescript-eslint/no-explicit-any
+      .map(([name, def]: [string, any]) => ({
+        name,
+        description: (def.description as string) ?? "",
+        props: extractFields(def.props),
+        slots: (def.slots as string[]) ?? [],
+        events: (def.events as string[]) ?? [],
+      }))
+      .sort((a, b) => a.name.localeCompare(b.name));
+
+    const actions = Object.entries(raw.actions ?? {})
+      // eslint-disable-next-line @typescript-eslint/no-explicit-any
+      .map(([name, def]: [string, any]) => ({
+        name,
+        description: (def.description as string) ?? "",
+        params: extractFields(def.params),
+      }))
+      .sort((a, b) => a.name.localeCompare(b.name));
+
+    return { components, actions };
+  }, []);
 
   // Disable body scroll when any modal is open
   useEffect(() => {

apps/web/components/docs-chat.tsx

@@ -1,233 +1,24 @@
 "use client";
 
-import {
-  useRef,
-  useEffect,
-  useState,
-  useCallback,
-  type PointerEvent as ReactPointerEvent,
-} from "react";
+import { useRef, useEffect, useState } from "react";
 import { useChat } from "@ai-sdk/react";
 import { DefaultChatTransport } from "ai";
 import { Streamdown } from "streamdown";
-import Link from "next/link";
-import { Sheet, SheetContent, SheetTitle } from "@/components/ui/sheet";
 
 const STORAGE_KEY = "docs-chat-messages";
 const transport = new DefaultChatTransport({ api: "/api/docs-chat" });
 
-const DESKTOP_DEFAULT_WIDTH = 400;
-const DESKTOP_MIN_WIDTH = 300;
-const DESKTOP_MAX_WIDTH = 700;
-
-function setCookie(name: string, value: string) {
-  document.cookie = `${name}=${encodeURIComponent(value)};path=/;max-age=${60 * 60 * 24 * 365};samesite=lax`;
-}
-
-const TOOL_LABELS: Record<
-  string,
-  { label: string; pastLabel: string; argKey?: string }
-> = {
-  readFile: { label: "Reading", pastLabel: "Read", argKey: "path" },
-  bash: { label: "Running", pastLabel: "Ran", argKey: "command" },
-};
-
-function isToolPart(part: { type: string }): part is {
-  type: string;
-  toolCallId: string;
-  toolName?: string;
-  state: string;
-  input?: Record<string, unknown>;
-  output?: unknown;
-  errorText?: string;
-} {
-  return part.type.startsWith("tool-") || part.type === "dynamic-tool";
-}
-
-function getToolName(part: { type: string; toolName?: string }): string {
-  if (part.type === "dynamic-tool") return part.toolName ?? "tool";
-  return part.type.replace(/^tool-/, "");
-}
-
-function ToolCallDisplay({
-  part,
-}: {
-  part: {
-    type: string;
-    toolCallId: string;
-    toolName?: string;
-    state: string;
-    input?: Record<string, unknown>;
-    output?: unknown;
-    errorText?: string;
-  };
-}) {
-  const toolName = getToolName(part);
-  const config = TOOL_LABELS[toolName] ?? {
-    label: toolName,
-    pastLabel: toolName,
-  };
-  const isDone = part.state === "output-available";
-  const isError = part.state === "output-error";
-  const isRunning = !isDone && !isError;
-  const displayLabel = isRunning ? config.label : config.pastLabel;
-
-  const args = (part.input ?? {}) as Record<string, unknown>;
-  const argValue = config.argKey ? args[config.argKey] : undefined;
-  const argPreview =
-    argValue != null
-      ? String(argValue)
-          .replace(/\/workspace\//g, "/")
-          .replace(/\.md$/, "")
-          .replace(/\/index$/, "")
-      : "";
-
-  // Link to the docs page if it's a /docs/ path from readFile
-  const docsLink =
-    toolName === "readFile" &&
-    (argPreview === "/docs" || argPreview.startsWith("/docs/"))
-      ? argPreview
-      : null;
-
-  const argEl = argPreview ? (
-    docsLink ? (
-      <Link href={docsLink} className="truncate underline underline-offset-2">
-        {argPreview}
-      </Link>
-    ) : (
-      <span className="truncate">{argPreview}</span>
-    )
-  ) : null;
-
-  return (
-    <div className="text-xs py-0.5 min-w-0">
-      {isRunning ? (
-        <span className="inline-flex items-center gap-1 font-mono text-muted-foreground animate-tool-shimmer min-w-0 max-w-full">
-          <span className="shrink-0">{displayLabel}</span>
-          {argEl}
-        </span>
-      ) : (
-        <span className="inline-flex items-center gap-1 font-mono text-muted-foreground/60 min-w-0 max-w-full">
-          <span className="shrink-0">{displayLabel}</span>
-          {argEl}
-          {isError && <span className="text-destructive">failed</span>}
-        </span>
-      )}
-    </div>
-  );
-}
-
-const SUGGESTIONS = [
-  "What is json-render?",
-  "How do I install it?",
-  "How does streaming work?",
-  "What components are available?",
-  "How do I create a custom schema?",
-];
-
-export function DocsChat({
-  defaultOpen = false,
-  defaultWidth = DESKTOP_DEFAULT_WIDTH,
-}: {
-  defaultOpen?: boolean;
-  defaultWidth?: number;
-}) {
-  const [open, setOpen] = useState(defaultOpen);
+export function DocsChat() {
+  const [open, setOpen] = useState(false);
   const [input, setInput] = useState("");
-  const [isDesktop, setIsDesktop] = useState(false);
-  const [hasMounted, setHasMounted] = useState(false);
-  const [desktopWidth, setDesktopWidth] = useState(
-    Math.min(DESKTOP_MAX_WIDTH, Math.max(DESKTOP_MIN_WIDTH, defaultWidth)),
-  );
-  const messagesScrollRef = useRef<HTMLDivElement>(null);
+  const messagesEndRef = useRef<HTMLDivElement>(null);
   const inputRef = useRef<HTMLTextAreaElement>(null);
+  const containerRef = useRef<HTMLDivElement>(null);
   const restoredRef = useRef(false);
-  const isDraggingRef = useRef(false);
 
-  const { messages, sendMessage, status, setMessages, error } = useChat({
-    transport,
-  });
+  const { messages, sendMessage, status, setMessages } = useChat({ transport });
 
   const isLoading = status === "streaming" || status === "submitted";
-  const showMessages = messages.length > 0 || !!error || isLoading;
-
-  // Detect desktop vs mobile. Close sidebar on mobile if it was open from cookie.
-  useEffect(() => {
-    const mq = window.matchMedia("(min-width: 640px)");
-    setIsDesktop(mq.matches);
-    setHasMounted(true);
-    // If on mobile but sidebar was open from cookie, close it
-    if (!mq.matches && defaultOpen) {
-      setOpen(false);
-    }
-    const handler = (e: MediaQueryListEvent) => setIsDesktop(e.matches);
-    mq.addEventListener("change", handler);
-    return () => mq.removeEventListener("change", handler);
-    // eslint-disable-next-line react-hooks/exhaustive-deps
-  }, []);
-
-  // Persist open state to cookie (only after mount to avoid overwriting on mobile)
-  useEffect(() => {
-    if (hasMounted) {
-      setCookie("docs-chat-open", String(open));
-    }
-  }, [open, hasMounted]);
-
-  // Push page content on desktop when pane is open.
-  // Use padding on body so the page scrollbar stays at the viewport edge (behind the sidebar)
-  // instead of appearing right next to the sidebar's scrollbar.
-  useEffect(() => {
-    const body = document.body;
-    if (isDesktop && open) {
-      body.style.paddingRight = `${desktopWidth}px`;
-      if (!isDraggingRef.current) {
-        body.style.transition = "padding-right 150ms ease";
-      }
-    } else if (isDesktop) {
-      body.style.paddingRight = "0px";
-      body.style.transition = "padding-right 150ms ease";
-    }
-    return () => {
-      body.style.paddingRight = "0px";
-      body.style.transition = "";
-    };
-  }, [isDesktop, open, desktopWidth]);
-
-  // Resize handle drag
-  const handleResizePointerDown = useCallback(
-    (e: ReactPointerEvent<HTMLDivElement>) => {
-      e.preventDefault();
-      isDraggingRef.current = true;
-      document.documentElement.style.transition = "none";
-      const startX = e.clientX;
-      const startWidth = desktopWidth;
-
-      const onPointerMove = (ev: globalThis.PointerEvent) => {
-        const delta = startX - ev.clientX;
-        const newWidth = Math.min(
-          DESKTOP_MAX_WIDTH,
-          Math.max(DESKTOP_MIN_WIDTH, startWidth + delta),
-        );
-        setDesktopWidth(newWidth);
-      };
-
-      const onPointerUp = () => {
-        isDraggingRef.current = false;
-        document.documentElement.style.transition = "";
-        document.removeEventListener("pointermove", onPointerMove);
-        document.removeEventListener("pointerup", onPointerUp);
-      };
-
-      document.addEventListener("pointermove", onPointerMove);
-      document.addEventListener("pointerup", onPointerUp);
-    },
-    [desktopWidth],
-  );
-
-  // Persist width to cookie
-  useEffect(() => {
-    setCookie("docs-chat-width", String(desktopWidth));
-  }, [desktopWidth]);
 
   // Restore messages from sessionStorage on mount
   useEffect(() => {
@@ -261,95 +52,144 @@ export function DocsChat({
     }
   }, [messages, isLoading]);
 
-  // Cmd+K to open sidebar and focus prompt, Escape to close
+  // Auto-open when new messages arrive
+  const prevMessageCount = useRef(0);
   useEffect(() => {
-    const handleKeyDown = (e: KeyboardEvent) => {
-      if (e.key === "k" && (e.metaKey || e.ctrlKey)) {
-        e.preventDefault();
-        setOpen((prev) => {
-          if (!prev) {
-            setTimeout(() => inputRef.current?.focus(), 200);
-          }
-          return !prev;
-        });
-      }
-      if (e.key === "Escape" && open && isDesktop) {
+    if (messages.length > prevMessageCount.current) {
+      setOpen(true);
+    }
+    prevMessageCount.current = messages.length;
+  }, [messages.length]);
+
+  // Scroll to bottom when messages change
+  useEffect(() => {
+    messagesEndRef.current?.scrollIntoView({ behavior: "smooth" });
+  }, [messages]);
+
+  // Close message area when clicking outside
+  useEffect(() => {
+    if (!open) return;
+    const handleClickOutside = (e: MouseEvent) => {
+      if (
+        containerRef.current &&
+        !containerRef.current.contains(e.target as Node)
+      ) {
         setOpen(false);
       }
     };
-    document.addEventListener("keydown", handleKeyDown);
-    return () => document.removeEventListener("keydown", handleKeyDown);
-  }, [open, isDesktop]);
-
-  // Auto-focus input when opened
-  useEffect(() => {
-    if (open) {
-      const timer = setTimeout(() => inputRef.current?.focus(), 200);
-      return () => clearTimeout(timer);
-    }
+    document.addEventListener("mousedown", handleClickOutside);
+    return () => document.removeEventListener("mousedown", handleClickOutside);
   }, [open]);
 
-  // Auto-open when error occurs
-  useEffect(() => {
-    if (error) setOpen(true);
-  }, [error]);
-
-  // Scroll to bottom when messages change or error occurs
-  useEffect(() => {
-    const el = messagesScrollRef.current;
-    if (!el) return;
-    requestAnimationFrame(() => {
-      el.scrollTop = el.scrollHeight;
-    });
-  }, [messages, error]);
-
-  const handleSubmit = useCallback(
-    (e: React.FormEvent) => {
-      e.preventDefault();
-      if (!input.trim() || isLoading) return;
-      sendMessage({ text: input });
-      setInput("");
-    },
-    [input, isLoading, sendMessage],
-  );
-
-  const handleClear = useCallback(() => {
-    setMessages([]);
-    sessionStorage.removeItem(STORAGE_KEY);
-  }, [setMessages]);
-
-  const hasVisibleContent = (
-    parts: (typeof messages)[number]["parts"],
-  ): boolean => {
-    return parts.some(
-      (p) => (p.type === "text" && p.text.length > 0) || isToolPart(p),
-    );
+  const handleSubmit = (e: React.FormEvent) => {
+    e.preventDefault();
+    if (!input.trim() || isLoading) return;
+    sendMessage({ text: input });
+    setInput("");
   };
 
-  // Shared chat panel content used by both desktop and mobile
-  const chatPanel = (
-    <>
-      {/* Header */}
-      <div className="flex items-center justify-between px-4 py-3 border-b shrink-0">
-        <span className="text-sm font-medium">json-render Docs</span>
-        <div className="flex items-center gap-3">
-          {showMessages && (
-            <button
-              onClick={handleClear}
-              className="text-xs text-muted-foreground hover:text-foreground transition-colors"
-              aria-label="Clear conversation"
-            >
-              Clear
-            </button>
-          )}
+  const handleClear = () => {
+    setMessages([]);
+    sessionStorage.removeItem(STORAGE_KEY);
+    setOpen(false);
+    inputRef.current?.focus();
+  };
+
+  const getTextFromParts = (
+    parts: (typeof messages)[number]["parts"],
+  ): string => {
+    return parts
+      .filter(
+        (p): p is Extract<typeof p, { type: "text" }> => p.type === "text",
+      )
+      .map((p) => p.text)
+      .join("");
+  };
+
+  return (
+    <div className="fixed bottom-0 left-0 right-0 z-50 pointer-events-none">
+      <div
+        ref={containerRef}
+        className="max-w-xl mx-auto px-4 pb-4 [&>*]:pointer-events-auto"
+      >
+        {/* Messages panel */}
+        {open && messages.length > 0 && (
+          <div className="mb-2 bg-background border border-border rounded-lg shadow-lg max-h-[60vh] flex flex-col">
+            <div className="flex items-center justify-between px-4 py-2 border-b border-border shrink-0">
+              <span className="text-xs font-medium text-muted-foreground">
+                json-render Docs
+              </span>
+              <button
+                onClick={handleClear}
+                className="text-xs text-muted-foreground hover:text-foreground transition-colors"
+                aria-label="Clear conversation"
+              >
+                Clear
+              </button>
+            </div>
+            <div className="p-4 space-y-4 overflow-y-auto">
+              {messages.map((message) => {
+                const text = getTextFromParts(message.parts);
+                if (!text) return null;
+                return (
+                  <div key={message.id}>
+                    {message.role === "assistant" ? (
+                      <div className="text-sm text-foreground/90 leading-relaxed prose prose-sm dark:prose-invert max-w-none">
+                        <Streamdown>{text}</Streamdown>
+                      </div>
+                    ) : (
+                      <div className="text-sm text-muted-foreground whitespace-pre-wrap leading-relaxed">
+                        {text}
+                      </div>
+                    )}
+                  </div>
+                );
+              })}
+              <div ref={messagesEndRef} />
+            </div>
+          </div>
+        )}
+
+        {/* Input bar */}
+        <form
+          onSubmit={handleSubmit}
+          onClick={() => inputRef.current?.focus()}
+          className="flex items-end gap-2 bg-background border border-border rounded-lg shadow-lg px-4 py-3 cursor-text"
+        >
+          <textarea
+            ref={inputRef}
+            value={input}
+            onChange={(e) => {
+              setInput(e.target.value);
+              e.target.style.height = "auto";
+              e.target.style.height = `${e.target.scrollHeight}px`;
+            }}
+            placeholder="Ask about the docs..."
+            rows={1}
+            onFocus={() => {
+              if (messages.length > 0) setOpen(true);
+            }}
+            onKeyDown={(e) => {
+              if (e.key === "Escape") {
+                setOpen(false);
+                inputRef.current?.blur();
+              }
+              if (e.key === "Enter" && !e.shiftKey) {
+                e.preventDefault();
+                handleSubmit(e);
+              }
+            }}
+            className="flex-1 bg-transparent text-sm text-foreground placeholder:text-muted-foreground outline-none disabled:opacity-50 resize-none max-h-32 leading-relaxed"
+          />
           <button
-            onClick={() => setOpen(false)}
-            className="text-muted-foreground hover:text-foreground transition-colors"
-            aria-label="Close panel"
+            type="submit"
+            disabled={isLoading || !input.trim()}
+            className="bg-primary text-primary-foreground rounded-md p-1 hover:bg-primary/90 transition-colors disabled:opacity-30"
+            aria-label="Send message"
           >
             <svg
-              width="14"
-              height="14"
+              width="16"
+              height="16"
               viewBox="0 0 24 24"
               fill="none"
               stroke="currentColor"
@@ -357,184 +197,12 @@ export function DocsChat({
               strokeLinecap="round"
               strokeLinejoin="round"
             >
-              <line x1="18" y1="6" x2="6" y2="18" />
-              <line x1="6" y1="6" x2="18" y2="18" />
+              <line x1="12" y1="19" x2="12" y2="5" />
+              <polyline points="5 12 12 5 19 12" />
             </svg>
           </button>
-        </div>
+        </form>
       </div>
-
-      {/* Content: suggestions or messages */}
-      {showMessages ? (
-        <div
-          ref={messagesScrollRef}
-          className="flex-1 min-h-0 p-4 space-y-4 overflow-y-auto"
-        >
-          {messages.map((message) => {
-            if (!hasVisibleContent(message.parts)) return null;
-            return (
-              <div key={message.id}>
-                {message.role === "user" ? (
-                  <div className="text-sm text-muted-foreground whitespace-pre-wrap leading-relaxed">
-                    {message.parts
-                      .filter(
-                        (p): p is Extract<typeof p, { type: "text" }> =>
-                          p.type === "text",
-                      )
-                      .map((p) => p.text)
-                      .join("")}
-                  </div>
-                ) : (
-                  <div className="space-y-2">
-                    {message.parts.map((part, i) => {
-                      if (part.type === "text" && part.text) {
-                        return (
-                          <div
-                            key={i}
-                            className="docs-chat-content text-sm text-foreground/90 leading-relaxed prose prose-sm dark:prose-invert max-w-none"
-                          >
-                            <Streamdown>{part.text}</Streamdown>
-                          </div>
-                        );
-                      }
-                      if (isToolPart(part)) {
-                        return (
-                          <ToolCallDisplay key={part.toolCallId} part={part} />
-                        );
-                      }
-                      return null;
-                    })}
-                  </div>
-                )}
-              </div>
-            );
-          })}
-          {error && (
-            <div className="text-sm text-destructive/80 bg-destructive/10 rounded-md px-3 py-2">
-              {(() => {
-                try {
-                  const parsed = JSON.parse(error.message);
-                  return parsed.message || parsed.error || error.message;
-                } catch {
-                  return (
-                    error.message || "Something went wrong. Please try again."
-                  );
-                }
-              })()}
-            </div>
-          )}
-        </div>
-      ) : (
-        <div className="flex-1 min-h-0 flex flex-col">
-          <div className="flex flex-wrap gap-2 p-4">
-            {SUGGESTIONS.map((s) => (
-              <button
-                key={s}
-                type="button"
-                onClick={() => {
-                  sendMessage({ text: s });
-                }}
-                className="text-xs px-3 py-1.5 rounded-full border bg-secondary font-medium text-muted-foreground hover:text-foreground transition-colors"
-              >
-                {s}
-              </button>
-            ))}
-          </div>
-        </div>
-      )}
-
-      {/* Input bar */}
-      <form
-        onSubmit={handleSubmit}
-        className="flex items-end gap-2 px-4 py-3 border-t shrink-0"
-      >
-        <textarea
-          ref={inputRef}
-          value={input}
-          onChange={(e) => {
-            setInput(e.target.value);
-            e.target.style.height = "auto";
-            e.target.style.height = `${e.target.scrollHeight}px`;
-          }}
-          rows={1}
-          enterKeyHint="send"
-          placeholder="Ask a question..."
-          onKeyDown={(e) => {
-            if (e.key === "Enter" && !e.shiftKey) {
-              e.preventDefault();
-              handleSubmit(e);
-            }
-          }}
-          className="flex-1 bg-transparent text-base sm:text-sm text-foreground outline-none disabled:opacity-50 resize-none max-h-32 leading-relaxed placeholder:text-muted-foreground"
-        />
-        <button
-          type="submit"
-          disabled={isLoading || !input.trim()}
-          className="bg-primary text-primary-foreground rounded-full p-1.5 hover:bg-primary/90 transition-colors disabled:opacity-30 shrink-0"
-          aria-label="Send message"
-        >
-          <svg
-            width="16"
-            height="16"
-            viewBox="0 0 24 24"
-            fill="none"
-            stroke="currentColor"
-            strokeWidth="2"
-            strokeLinecap="round"
-            strokeLinejoin="round"
-          >
-            <line x1="12" y1="19" x2="12" y2="5" />
-            <polyline points="5 12 12 5 19 12" />
-          </svg>
-        </button>
-      </form>
-    </>
-  );
-
-  return (
-    <>
-      {/* Ask AI trigger button */}
-      {!open && (
-        <button
-          onClick={() => setOpen(true)}
-          className="fixed z-50 bottom-4 left-1/2 -translate-x-1/2 sm:left-auto sm:translate-x-0 sm:right-4 flex items-center gap-2 px-4 py-2 rounded-lg border bg-background text-primary shadow-lg hover:bg-primary hover:text-primary-foreground transition-colors text-sm font-medium"
-          aria-label="Ask AI"
-        >
-          Ask AI
-          <kbd className="hidden sm:inline-flex items-center gap-0.5 text-xs opacity-60 font-mono">
-            <span>&#8984;</span>K
-          </kbd>
-        </button>
-      )}
-
-      {/* Desktop: resizable side pane — always rendered, hidden on mobile via CSS */}
-      <aside
-        className={`hidden sm:flex fixed top-0 right-0 bottom-0 z-40 border-l bg-background transition-transform duration-150 ease-in-out ${open ? "translate-x-0" : "translate-x-full"}`}
-        style={{ width: desktopWidth }}
-        aria-hidden={!open}
-      >
-        {/* Resize handle */}
-        <div
-          onPointerDown={handleResizePointerDown}
-          className="absolute top-0 bottom-0 left-0 w-1.5 cursor-col-resize hover:bg-ring/30 active:bg-ring/50 transition-colors z-10"
-        />
-        <div className="flex flex-col flex-1 min-w-0">{chatPanel}</div>
-      </aside>
-
-      {/* Mobile: Sheet overlay/drawer — only after mount to avoid flash on desktop */}
-      {hasMounted && !isDesktop && (
-        <Sheet open={open} onOpenChange={setOpen}>
-          <SheetContent
-            side="right"
-            overlayClassName="!bg-background"
-            className="!inset-0 !w-full !h-full !max-w-none p-0 flex flex-col"
-            style={{ backgroundColor: "var(--background)", opacity: 1 }}
-          >
-            <SheetTitle className="sr-only">AI Chat</SheetTitle>
-            {chatPanel}
-          </SheetContent>
-        </Sheet>
-      )}
-    </>
+    </div>
   );
 }

apps/web/components/generation-modes-diagram.tsx

@@ -1,272 +0,0 @@
-"use client";
-
-function ScheduleItem({
-  time,
-  label,
-  color,
-}: {
-  time: string;
-  label: string;
-  color: string;
-}) {
-  return (
-    <div className="flex items-center gap-2 py-1.5 border-t border-border/50 first:border-t-0">
-      <span className="text-[10px] text-muted-foreground/60 w-12 shrink-0 tabular-nums">
-        {time}
-      </span>
-      <span
-        className="w-1.5 h-1.5 rounded-full shrink-0"
-        style={{ background: color }}
-      />
-      <span className="text-[11px] text-muted-foreground">{label}</span>
-    </div>
-  );
-}
-
-function InlineModeDiagram() {
-  return (
-    <div className="flex flex-col h-full">
-      <div className="text-sm font-medium text-foreground text-center mb-3">
-        Inline Mode
-      </div>
-      <div className="flex-1 border border-border rounded-2xl bg-background overflow-hidden flex flex-col">
-        <div className="flex-1 p-4 space-y-3 overflow-hidden">
-          {/* User message */}
-          <div className="flex justify-end">
-            <div className="bg-muted-foreground/20 rounded-2xl rounded-br px-3.5 py-2 max-w-[85%]">
-              <span className="text-[11px] text-foreground/80">
-                I have back-to-back meetings today
-              </span>
-            </div>
-          </div>
-
-          {/* AI response */}
-          <div className="space-y-2">
-            <p className="text-[11px] text-muted-foreground/70">
-              Packed day! Here&apos;s what you&apos;ve got:
-            </p>
-            <div className="bg-muted/40 border border-border rounded-xl p-3 w-[92%]">
-              <div className="text-[11px] font-semibold text-foreground/80 mb-2">
-                Today&apos;s Schedule
-              </div>
-              <ScheduleItem
-                time="10:00 AM"
-                label="Design Review"
-                color="#7aa2f7"
-              />
-              <ScheduleItem
-                time="1:00 PM"
-                label="Sprint Planning"
-                color="#bb9af7"
-              />
-              <ScheduleItem
-                time="3:30 PM"
-                label="Team Standup"
-                color="#9ece6a"
-              />
-              <ScheduleItem
-                time="4:30 PM"
-                label="Eng All-Hands"
-                color="#e0af68"
-              />
-            </div>
-          </div>
-        </div>
-
-        {/* Prompt input */}
-        <div className="p-2.5">
-          <div className="bg-muted/50 border border-border rounded-xl px-2.5 py-1.5 flex items-center gap-1.5">
-            <span className="text-[10px] text-muted-foreground/40 flex-1">
-              Message...
-            </span>
-            <div className="w-5 h-5 rounded-md bg-muted-foreground/20 flex items-center justify-center">
-              <svg
-                className="w-2.5 h-2.5 text-muted-foreground/50"
-                viewBox="0 0 24 24"
-                fill="currentColor"
-              >
-                <path
-                  d="M12 4l-1.41 1.41L16.17 11H4v2h12.17l-5.58 5.59L12 20l8-8z"
-                  transform="rotate(-90 12 12)"
-                />
-              </svg>
-            </div>
-          </div>
-        </div>
-      </div>
-      <div className="mt-3 flex flex-col items-center gap-2">
-        <div className="text-xs font-medium text-muted-foreground">
-          AI decides when UI beats text
-        </div>
-        <div className="flex items-center gap-1.5 text-[10px] text-muted-foreground/50">
-          <span>AI chatbots</span>
-          <span className="text-muted-foreground/30">/</span>
-          <span>Copilots</span>
-          <span className="text-muted-foreground/30">/</span>
-          <span>Assistants</span>
-        </div>
-      </div>
-    </div>
-  );
-}
-
-function LandingPage() {
-  return (
-    <div className="w-full h-full flex flex-col bg-muted/20">
-      {/* Nav */}
-      <div className="flex items-center justify-between px-3 py-2 border-b border-border/50">
-        <svg
-          width="12"
-          height="12"
-          viewBox="0 0 24 24"
-          fill="none"
-          className="shrink-0"
-        >
-          <rect
-            x="2"
-            y="14"
-            width="5"
-            height="8"
-            rx="1"
-            className="fill-muted-foreground/60"
-          />
-          <rect
-            x="9.5"
-            y="8"
-            width="5"
-            height="14"
-            rx="1"
-            className="fill-muted-foreground/60"
-          />
-          <rect
-            x="17"
-            y="2"
-            width="5"
-            height="20"
-            rx="1"
-            className="fill-muted-foreground/60"
-          />
-        </svg>
-        <div className="flex items-center gap-2">
-          <span className="text-[9px] text-muted-foreground/50">Pricing</span>
-          <span className="text-[9px] text-muted-foreground/50">Blog</span>
-          <span className="text-[8px] font-semibold bg-foreground text-background rounded-md px-1.5 py-0.5 whitespace-nowrap">
-            Get Started
-          </span>
-        </div>
-      </div>
-
-      {/* Hero */}
-      <div className="flex-1 flex flex-col items-center justify-center gap-2.5 text-center px-4">
-        <span className="text-[8px] font-medium text-green-400 bg-green-400/10 border border-green-400/15 rounded-full px-2 py-0.5">
-          Trusted by 2,000+ teams
-        </span>
-        <div className="text-sm font-bold text-foreground leading-tight">
-          Analytics that
-          <br />
-          move the needle
-        </div>
-        <div className="text-[10px] text-muted-foreground/50 leading-relaxed">
-          Ship what matters. No setup required.
-        </div>
-        <div className="flex gap-1.5 mt-1">
-          <button className="bg-foreground text-background text-[9px] font-semibold rounded-lg px-3 py-1.5 whitespace-nowrap">
-            Start Free
-          </button>
-          <button className="border border-border text-muted-foreground text-[9px] font-medium rounded-lg px-3 py-1.5 whitespace-nowrap">
-            Book Demo
-          </button>
-        </div>
-      </div>
-
-      {/* Footer */}
-      <div className="flex justify-center gap-3 py-2 border-t border-border/50">
-        <span className="text-[8px] text-muted-foreground/30">Privacy</span>
-        <span className="text-[8px] text-muted-foreground/30">Terms</span>
-        <span className="text-[8px] text-muted-foreground/30">Status</span>
-      </div>
-    </div>
-  );
-}
-
-function StandaloneModeDiagram() {
-  return (
-    <div className="flex flex-col h-full">
-      <div className="text-sm font-medium text-foreground text-center mb-3">
-        Standalone Mode
-      </div>
-      <div className="flex-1 border border-border rounded-2xl bg-background overflow-hidden flex flex-row">
-        {/* Left panel - conversation */}
-        <div className="w-[38%] border-r border-border/50 flex flex-col">
-          <div className="flex-1 p-3 space-y-2.5">
-            {/* User message */}
-            <div className="flex justify-end">
-              <div className="bg-muted-foreground/20 rounded-2xl rounded-br px-2.5 py-1.5">
-                <span className="text-[10px] text-foreground/80 block leading-relaxed">
-                  A landing page for my analytics startup
-                </span>
-              </div>
-            </div>
-            {/* AI text */}
-            <p className="text-[10px] text-muted-foreground/60 leading-relaxed">
-              Here&apos;s a clean landing page with a hero, nav, and CTAs.
-            </p>
-          </div>
-
-          {/* Prompt input */}
-          <div className="p-2.5">
-            <div className="bg-muted/50 border border-border rounded-xl px-2.5 py-1.5 flex items-center gap-1.5">
-              <span className="text-[10px] text-muted-foreground/40 flex-1">
-                Message...
-              </span>
-              <div className="w-5 h-5 rounded-md bg-muted-foreground/20 flex items-center justify-center">
-                <svg
-                  className="w-2.5 h-2.5 text-muted-foreground/50"
-                  viewBox="0 0 24 24"
-                  fill="currentColor"
-                >
-                  <path
-                    d="M12 4l-1.41 1.41L16.17 11H4v2h12.17l-5.58 5.59L12 20l8-8z"
-                    transform="rotate(-90 12 12)"
-                  />
-                </svg>
-              </div>
-            </div>
-          </div>
-        </div>
-
-        {/* Right panel - landing page */}
-        <div className="flex-1">
-          <LandingPage />
-        </div>
-      </div>
-      <div className="mt-3 flex flex-col items-center gap-2">
-        <div className="text-xs font-medium text-muted-foreground">
-          Prompt in, UI out
-        </div>
-        <div className="flex items-center gap-1.5 text-[10px] text-muted-foreground/50">
-          <span>Website builders</span>
-          <span className="text-muted-foreground/30">/</span>
-          <span>Text-to-widget</span>
-          <span className="text-muted-foreground/30">/</span>
-          <span>Dashboards</span>
-        </div>
-      </div>
-    </div>
-  );
-}
-
-export function GenerationModesDiagram() {
-  return (
-    <div className="not-prose my-8">
-      <div className="grid grid-cols-1 sm:grid-cols-2 gap-6">
-        <div className="h-[420px]">
-          <InlineModeDiagram />
-        </div>
-        <div className="h-[420px]">
-          <StandaloneModeDiagram />
-        </div>
-      </div>
-    </div>
-  );
-}

apps/web/components/header.tsx

@@ -57,7 +57,7 @@ export function Header() {
             </svg>
           </span>
           <Link href="/">
-            <span className="font-medium tracking-tight text-lg font-(family-name:--font-geist-pixel-square)">
+            <span className="font-medium tracking-tight text-lg">
               json-render
             </span>
           </Link>
@@ -100,7 +100,7 @@ export function Header() {
             >
               <path d="M8 0C3.58 0 0 3.58 0 8c0 3.54 2.29 6.53 5.47 7.59.4.07.55-.17.55-.38 0-.19-.01-.82-.01-1.49-2.01.37-2.53-.49-2.69-.94-.09-.23-.48-.94-.82-1.13-.28-.15-.68-.52-.01-.53.63-.01 1.08.58 1.23.82.72 1.21 1.87.87 2.33.66.07-.52.28-.87.51-1.07-1.78-.2-3.64-.89-3.64-3.95 0-.87.31-1.59.82-2.15-.08-.2-.36-1.02.08-2.12 0 0 .67-.21 2.2.82.64-.18 1.32-.27 2-.27.68 0 1.36.09 2 .27 1.53-1.04 2.2-.82 2.2-.82.44 1.1.16 1.92.08 2.12.51.56.82 1.27.82 2.15 0 3.07-1.87 3.75-3.65 3.95.29.25.54.73.54 1.48 0 1.07-.01 1.93-.01 2.2 0 .21.15.46.55.38A8.013 8.013 0 0016 8c0-4.42-3.58-8-8-8z" />
             </svg>
-            <span>12k</span>
+            <span>10.1k</span>
           </a>
           <ThemeToggle />
         </nav>

apps/web/components/playground.tsx

@@ -2,16 +2,10 @@
 
 import { useEffect, useState, useCallback, useRef, useMemo } from "react";
 import { flushSync } from "react-dom";
+import { useUIStream, type TokenUsage } from "@json-render/react";
 import type { Spec } from "@json-render/core";
 import { collectUsedComponents, serializeProps } from "@json-render/codegen";
 import { toast } from "sonner";
-import { stringify as yamlStringify } from "yaml";
-import type { EditMode } from "@json-render/core";
-import {
-  usePlaygroundStream,
-  type StreamFormat,
-  type TokenUsage,
-} from "@/lib/use-playground-stream";
 import {
   ResizablePanelGroup,
   ResizablePanel,
@@ -22,20 +16,16 @@ 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 = "spec" | "nested" | "stream" | "catalog" | "visual";
+type Tab = "json" | "nested" | "stream" | "catalog";
 type RenderView = "preview" | "code";
 type MobileView =
-  | "spec"
+  | "json"
   | "nested"
   | "stream"
   | "catalog"
-  | "visual"
   | "preview"
   | "generated-code";
 
@@ -46,79 +36,6 @@ interface Version {
   status: "generating" | "complete" | "error";
   usage: TokenUsage | null;
   rawLines: string[];
-  format: StreamFormat;
-}
-
-function formatTokens(n: number): string {
-  if (n >= 1000) return `${(n / 1000).toFixed(1).replace(/\.0$/, "")}k`;
-  return String(n);
-}
-
-function PlaygroundControls({
-  format,
-  setFormat,
-  editModes,
-  setEditModes,
-  showClear,
-  onClear,
-}: {
-  format: StreamFormat;
-  setFormat: (f: StreamFormat) => void;
-  editModes: EditMode[];
-  setEditModes: React.Dispatch<React.SetStateAction<EditMode[]>>;
-  showClear: boolean;
-  onClear: () => void;
-}) {
-  return (
-    <div className="flex items-center gap-2">
-      <div className="flex items-center rounded border border-border text-[10px] font-mono overflow-hidden">
-        {(["jsonl", "yaml"] as const).map((f) => (
-          <button
-            key={f}
-            onClick={() => setFormat(f)}
-            className={`px-1.5 py-0.5 transition-colors ${
-              format === f
-                ? "bg-muted text-foreground"
-                : "text-muted-foreground hover:text-foreground"
-            }`}
-          >
-            {f}
-          </button>
-        ))}
-      </div>
-      <div className="flex items-center rounded border border-border text-[10px] font-mono overflow-hidden">
-        {(["patch", "merge", "diff"] as const).map((m) => (
-          <button
-            key={m}
-            onClick={() => {
-              setEditModes((prev) =>
-                prev.includes(m)
-                  ? prev.length > 1
-                    ? prev.filter((x) => x !== m)
-                    : prev
-                  : [...prev, m],
-              );
-            }}
-            className={`px-1.5 py-0.5 transition-colors ${
-              editModes.includes(m)
-                ? "bg-muted text-foreground"
-                : "text-muted-foreground hover:text-foreground"
-            }`}
-          >
-            {m}
-          </button>
-        ))}
-      </div>
-      {showClear && (
-        <button
-          onClick={onClear}
-          className="text-xs text-muted-foreground hover:text-foreground transition-colors"
-        >
-          Clear
-        </button>
-      )}
-    </div>
-  );
 }
 
 /**
@@ -179,15 +96,13 @@ export function Playground() {
     null,
   );
   const [inputValue, setInputValue] = useState("");
-  const [activeTab, setActiveTab] = useState<Tab>("spec");
+  const [activeTab, setActiveTab] = useState<Tab>("json");
   const [catalogSection, setCatalogSection] = useState<
     "components" | "actions"
   >("components");
   const [renderView, setRenderView] = useState<RenderView>("preview");
   const [mobileView, setMobileView] = useState<MobileView>("preview");
   const [versionsSheetOpen, setVersionsSheetOpen] = useState(false);
-  const [format, setFormat] = useState<StreamFormat>("jsonl");
-  const [editModes, setEditModes] = useState<EditMode[]>(["patch"]);
   const inputRef = useRef<HTMLTextAreaElement>(null);
   const mobileInputRef = useRef<HTMLTextAreaElement>(null);
   const versionsEndRef = useRef<HTMLDivElement>(null);
@@ -205,13 +120,12 @@ export function Playground() {
     rawLines: streamRawLines,
     send,
     clear,
-  } = usePlaygroundStream({
+  } = useUIStream({
     api: "/api/generate",
-    format,
-    editModes,
     onError: (err: Error) => {
       console.error("Generation error:", err);
       toast.error(err.message || "Generation failed. Please try again.");
+      // Mark the version as errored
       if (generatingVersionIdRef.current) {
         const erroredVersionId = generatingVersionIdRef.current;
         setVersions((prev) =>
@@ -222,7 +136,7 @@ export function Playground() {
         generatingVersionIdRef.current = null;
       }
     },
-  });
+  } as Parameters<typeof useUIStream>[0]);
 
   // Get the selected version
   const selectedVersion = versions.find((v) => v.id === selectedVersionId);
@@ -297,7 +211,6 @@ export function Playground() {
       status: "generating",
       usage: null,
       rawLines: [],
-      format,
     };
 
     generatingVersionIdRef.current = newVersionId;
@@ -307,7 +220,7 @@ export function Playground() {
 
     // Pass the current tree as context so the API can iterate on it
     await send(inputValue.trim(), { previousSpec: currentTreeRef.current });
-  }, [inputValue, isStreaming, send, format]);
+  }, [inputValue, isStreaming, send]);
 
   const handleKeyDown = useCallback(
     (e: React.KeyboardEvent) => {
@@ -319,30 +232,9 @@ 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 specCode = useMemo(() => {
-    if (!currentTree)
-      return format === "yaml" ? "# waiting..." : "// waiting...";
-    if (format === "yaml") {
-      return yamlStringify(currentTree, { indent: 2 }).trimEnd();
-    }
-    return JSON.stringify(currentTree, null, 2);
-  }, [currentTree, format]);
-
-  const specLang = format === "yaml" ? "yaml" : "json";
+  const jsonCode = currentTree
+    ? JSON.stringify(currentTree, null, 2)
+    : "// waiting...";
 
   const nestedCode = useMemo(() => {
     if (!currentTree || !currentTree.root) return "// waiting...";
@@ -365,7 +257,7 @@ export function Playground() {
       const componentName = element.type;
 
       const propsObj: Record<string, unknown> = {};
-      for (const [k, v] of Object.entries(element.props ?? {})) {
+      for (const [k, v] of Object.entries(element.props)) {
         if (v !== null && v !== undefined) {
           propsObj[k] = v;
         }
@@ -411,15 +303,6 @@ ${jsx}
 }`;
   }, [currentTree]);
 
-  // Determine syntax lang for raw stream based on selected version's format
-  const streamLang = isSelectedVersionGenerating
-    ? format === "yaml"
-      ? "yaml"
-      : "json"
-    : selectedVersion?.format === "yaml"
-      ? "yaml"
-      : "json";
-
   // Chat pane content
   const chatPane = (
     <div className="h-full flex flex-col border-t border-border">
@@ -491,15 +374,9 @@ ${jsx}
                 )}
               </div>
               {version.usage && (
-                <div className="mt-1 ml-6">
+                <div className="flex items-center gap-2 mt-1 ml-6">
                   <span className="text-[10px] font-mono text-muted-foreground/60">
-                    {formatTokens(
-                      version.usage.promptTokens - version.usage.cachedTokens,
-                    )}{" "}
-                    in · {formatTokens(version.usage.completionTokens)} out
-                    {version.usage.cachedTokens > 0
-                      ? ` · ${formatTokens(version.usage.cachedTokens)} cached`
-                      : ""}
+                    {version.usage.totalTokens.toLocaleString()} tokens
                   </span>
                 </div>
               )}
@@ -530,18 +407,20 @@ ${jsx}
           autoFocus
         />
         <div className="flex justify-between items-center mt-2">
-          <PlaygroundControls
-            format={format}
-            setFormat={setFormat}
-            editModes={editModes}
-            setEditModes={setEditModes}
-            showClear={versions.length > 0}
-            onClear={() => {
-              setVersions([]);
-              setSelectedVersionId(null);
-              clear();
-            }}
-          />
+          {versions.length > 0 ? (
+            <button
+              onClick={() => {
+                setVersions([]);
+                setSelectedVersionId(null);
+                clear();
+              }}
+              className="text-xs text-muted-foreground hover:text-foreground transition-colors"
+            >
+              Clear
+            </button>
+          ) : (
+            <div />
+          )}
           {isStreaming ? (
             <button
               onClick={() => clear()}
@@ -586,82 +465,122 @@ ${jsx}
   );
 
   // Catalog data for the catalog tab
-  const catalogData = useMemo(
-    () => buildCatalogDisplayData(playgroundCatalog.data),
-    [],
-  );
+  const catalogData = useMemo(() => {
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    const raw = playgroundCatalog.data as any;
+
+    function extractFields(zodObj: unknown): { name: string; type: string }[] {
+      if (!zodObj) return [];
+      try {
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        const obj = zodObj as any;
+        // Zod v4: shape is a plain object; Zod v3: shape is via _def.shape()
+        const shape =
+          typeof obj.shape === "object"
+            ? obj.shape
+            : typeof obj._def?.shape === "function"
+              ? obj._def.shape()
+              : typeof obj._def?.shape === "object"
+                ? obj._def.shape
+                : null;
+        if (!shape) return [];
+
+        return Object.entries(shape).map(([name, schema]) => {
+          let type = "unknown";
+          try {
+            // eslint-disable-next-line @typescript-eslint/no-explicit-any
+            const s = schema as any;
+            const typeName: string =
+              s?._zod?.def?.type ?? s?._def?.typeName ?? "";
+            if (typeName.includes("string")) type = "string";
+            else if (typeName.includes("number")) type = "number";
+            else if (typeName.includes("boolean")) type = "boolean";
+            else if (typeName.includes("array")) type = "array";
+            else if (typeName.includes("enum")) {
+              const values = s?._zod?.def?.values ?? s?._def?.values;
+              type = Array.isArray(values) ? values.join(" | ") : "enum";
+            } else if (typeName.includes("union")) type = "union";
+            else if (typeName.includes("nullable")) {
+              const inner = s?._zod?.def?.innerType ?? s?._def?.innerType;
+              const innerName: string =
+                inner?._zod?.def?.type ?? inner?._def?.typeName ?? "";
+              if (innerName.includes("string")) type = "string?";
+              else if (innerName.includes("number")) type = "number?";
+              else if (innerName.includes("boolean")) type = "boolean?";
+              else if (innerName.includes("array")) type = "array?";
+              else if (innerName.includes("enum")) {
+                const values = inner?._zod?.def?.values ?? inner?._def?.values;
+                type = Array.isArray(values)
+                  ? `(${values.join(" | ")})?`
+                  : "enum?";
+              } else type = "optional";
+            }
+          } catch {
+            // ignore
+          }
+          return { name, type };
+        });
+      } catch {
+        return [];
+      }
+    }
+
+    const components = Object.entries(raw.components ?? {})
+      // eslint-disable-next-line @typescript-eslint/no-explicit-any
+      .map(([name, def]: [string, any]) => ({
+        name,
+        description: (def.description as string) ?? "",
+        props: extractFields(def.props),
+        slots: (def.slots as string[]) ?? [],
+        events: (def.events as string[]) ?? [],
+      }))
+      .sort((a, b) => a.name.localeCompare(b.name));
+
+    const actions = Object.entries(raw.actions ?? {})
+      // eslint-disable-next-line @typescript-eslint/no-explicit-any
+      .map(([name, def]: [string, any]) => ({
+        name,
+        description: (def.description as string) ?? "",
+        params: extractFields(def.params),
+      }))
+      .sort((a, b) => a.name.localeCompare(b.name));
+
+    return { components, actions };
+  }, []);
 
   // Code pane content
   const copyText =
     activeTab === "stream"
       ? currentRawLines.join("\n")
-      : activeTab === "spec"
-        ? specCode
+      : activeTab === "json"
+        ? jsonCode
         : activeTab === "nested"
           ? nestedCode
-          : activeTab === "visual"
-            ? specCode
-            : "";
+          : "";
 
   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">
-        {(["spec", "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 === "spec" ? (format === "yaml" ? "yaml" : "json") : tab}
-            </button>
-          ),
-        )}
+        {(["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>
+        ))}
         <div className="flex-1" />
-        {activeTab !== "catalog" && activeTab !== "visual" && (
+        {activeTab !== "catalog" && (
           <CopyButton text={copyText} className="text-muted-foreground" />
         )}
       </div>
       <div className="flex-1 overflow-auto">
-        {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" ? (
+        {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">
               {(
@@ -782,7 +701,7 @@ ${jsx}
           currentRawLines.length > 0 ? (
             <CodeBlock
               code={currentRawLines.join("\n")}
-              lang={streamLang}
+              lang="json"
               fillHeight
               hideCopyButton
             />
@@ -794,12 +713,7 @@ ${jsx}
         ) : activeTab === "nested" ? (
           <CodeBlock code={nestedCode} lang="json" fillHeight hideCopyButton />
         ) : (
-          <CodeBlock
-            code={specCode}
-            lang={specLang}
-            fillHeight
-            hideCopyButton
-          />
+          <CodeBlock code={jsonCode} lang="json" fillHeight hideCopyButton />
         )}
       </div>
     </div>
@@ -898,21 +812,19 @@ ${jsx}
               : 0}
           </button>
           {/* Code tabs */}
-          {(["spec", "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 === "spec" ? (format === "yaml" ? "yaml" : "json") : tab}
-              </button>
-            ),
-          )}
+          {(["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>
+          ))}
           <div className="flex-1" />
           {/* Preview / code toggle */}
           {[
@@ -935,41 +847,7 @@ ${jsx}
 
         {/* Main content area */}
         <div className="flex-1 min-h-0 overflow-auto">
-          {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" ? (
+          {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">
                 {(
@@ -1090,7 +968,7 @@ ${jsx}
             currentRawLines.length > 0 ? (
               <CodeBlock
                 code={currentRawLines.join("\n")}
-                lang={streamLang}
+                lang="json"
                 fillHeight
                 hideCopyButton
               />
@@ -1106,13 +984,8 @@ ${jsx}
               fillHeight
               hideCopyButton
             />
-          ) : mobileView === "spec" ? (
-            <CodeBlock
-              code={specCode}
-              lang={specLang}
-              fillHeight
-              hideCopyButton
-            />
+          ) : mobileView === "json" ? (
+            <CodeBlock code={jsonCode} lang="json" fillHeight hideCopyButton />
           ) : mobileView === "preview" ? (
             currentTree && currentTree.root ? (
               <div className="w-full min-h-full flex items-center justify-center p-6">
@@ -1188,18 +1061,20 @@ ${jsx}
             rows={2}
           />
           <div className="flex justify-between items-center mt-2">
-            <PlaygroundControls
-              format={format}
-              setFormat={setFormat}
-              editModes={editModes}
-              setEditModes={setEditModes}
-              showClear={versions.length > 0}
-              onClear={() => {
-                setVersions([]);
-                setSelectedVersionId(null);
-                clear();
-              }}
-            />
+            {versions.length > 0 ? (
+              <button
+                onClick={() => {
+                  setVersions([]);
+                  setSelectedVersionId(null);
+                  clear();
+                }}
+                className="text-xs text-muted-foreground hover:text-foreground transition-colors"
+              >
+                Clear
+              </button>
+            ) : (
+              <div />
+            )}
             {isStreaming ? (
               <button
                 onClick={() => clear()}
@@ -1276,16 +1151,9 @@ ${jsx}
                     )}
                   </div>
                   {version.usage && (
-                    <div className="mt-1 ml-6">
+                    <div className="flex items-center gap-2 mt-1 ml-6">
                       <span className="text-[10px] font-mono text-muted-foreground/60">
-                        {formatTokens(
-                          version.usage.promptTokens -
-                            version.usage.cachedTokens,
-                        )}{" "}
-                        in · {formatTokens(version.usage.completionTokens)} out
-                        {version.usage.cachedTokens > 0
-                          ? ` · ${formatTokens(version.usage.cachedTokens)} cached`
-                          : ""}
+                        {version.usage.totalTokens.toLocaleString()} tokens
                       </span>
                     </div>
                   )}

apps/web/components/ui/sheet.tsx

@@ -18,7 +18,7 @@ const SheetOverlay = React.forwardRef<
 >(({ className, ...props }, ref) => (
   <SheetPrimitive.Overlay
     className={cn(
-      "fixed inset-0 z-50 bg-black/75 data-[state=open]:animate-in data-[state=closed]:animate-out data-[state=closed]:fade-out-0 data-[state=open]:fade-in-0 data-[state=closed]:duration-150 data-[state=open]:duration-150",
+      "fixed inset-0 z-50 bg-black/50 data-[state=open]:animate-in data-[state=closed]:animate-out data-[state=closed]:fade-out-0 data-[state=open]:fade-in-0 data-[state=closed]:duration-150 data-[state=open]:duration-150",
       className,
     )}
     {...props}
@@ -27,26 +27,17 @@ const SheetOverlay = React.forwardRef<
 ));
 SheetOverlay.displayName = SheetPrimitive.Overlay.displayName;
 
-const sheetSideVariants = {
-  left: "inset-y-0 left-0 h-full w-3/4 max-w-xs border-r data-[state=closed]:slide-out-to-left data-[state=open]:slide-in-from-left",
-  right:
-    "inset-y-0 right-0 h-full w-3/4 max-w-xs data-[state=closed]:slide-out-to-right data-[state=open]:slide-in-from-right",
-};
-
 const SheetContent = React.forwardRef<
   React.ComponentRef<typeof SheetPrimitive.Content>,
-  React.ComponentPropsWithoutRef<typeof SheetPrimitive.Content> & {
-    side?: "left" | "right";
-    overlayClassName?: string;
-  }
->(({ className, children, side = "left", overlayClassName, ...props }, ref) => (
+  React.ComponentPropsWithoutRef<typeof SheetPrimitive.Content>
+>(({ className, children, ...props }, ref) => (
   <SheetPortal>
-    <SheetOverlay className={overlayClassName} />
+    <SheetOverlay />
     <SheetPrimitive.Content
       ref={ref}
       className={cn(
         "fixed z-50 gap-4 bg-background p-6 shadow-lg transition ease-in-out data-[state=closed]:duration-150 data-[state=open]:duration-150 data-[state=open]:animate-in data-[state=closed]:animate-out focus:outline-none",
-        sheetSideVariants[side],
+        "inset-y-0 left-0 h-full w-3/4 max-w-xs border-r data-[state=closed]:slide-out-to-left data-[state=open]:slide-in-from-left",
         className,
       )}
       {...props}

apps/web/eslint.config.js

@@ -1,4 +1,4 @@
-import { nextJsConfig } from "@internal/eslint-config/next-js";
+import { nextJsConfig } from "@repo/eslint-config/next-js";
 
 /** @type {import("eslint").Linter.Config[]} */
 export default [

apps/web/lib/docs-navigation.ts

@@ -16,41 +16,24 @@ export const docsNavigation: NavSection[] = [
       { title: "Introduction", href: "/docs" },
       { title: "Installation", href: "/docs/installation" },
       { title: "Quick Start", href: "/docs/quick-start" },
-      { title: "Skills", href: "/docs/skills" },
-      { title: "Migration Guide", href: "/docs/migration" },
       { title: "Changelog", href: "/docs/changelog" },
     ],
   },
   {
-    title: "Core",
+    title: "Core Concepts",
     items: [
       { title: "Specs", href: "/docs/specs" },
       { 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" },
-    ],
-  },
-  {
-    title: "Rendering",
-    items: [
-      { title: "Renderers", href: "/docs/renderers" },
       { title: "Registry", href: "/docs/registry" },
-      { title: "Streaming", href: "/docs/streaming" },
-      { title: "Generation Modes", href: "/docs/generation-modes" },
+      { title: "Data Binding", href: "/docs/data-binding" },
+      { title: "Visibility", href: "/docs/visibility" },
+      { title: "Validation", href: "/docs/validation" },
     ],
   },
   {
     title: "Examples",
     items: [
-      {
-        title: "Chat",
-        href: "https://github.com/vercel-labs/json-render/tree/main/examples/chat",
-        external: true,
-      },
       {
         title: "Dashboard",
         href: "https://github.com/vercel-labs/json-render/tree/main/examples/dashboard",
@@ -61,52 +44,18 @@ 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: "React Email",
-        href: "https://github.com/vercel-labs/json-render/tree/main/examples/react-email",
-        external: true,
-      },
       {
         title: "Remotion",
         href: "https://github.com/vercel-labs/json-render/tree/main/examples/remotion",
         external: true,
       },
-      {
-        title: "Image",
-        href: "https://github.com/vercel-labs/json-render/tree/main/examples/image",
-        external: true,
-      },
-      {
-        title: "Svelte",
-        href: "https://github.com/vercel-labs/json-render/tree/main/examples/svelte",
-        external: true,
-      },
-      {
-        title: "Vue",
-        href: "https://github.com/vercel-labs/json-render/tree/main/examples/vue",
-        external: true,
-      },
-      {
-        title: "Renders with Vite (Vue / React / Svelte / Solid)",
-        href: "https://github.com/vercel-labs/json-render/tree/main/examples/vite-renderers",
-        external: true,
-      },
-      {
-        title: "MCP App",
-        href: "https://github.com/vercel-labs/json-render/tree/main/examples/mcp",
-        external: true,
-      },
     ],
   },
   {
     title: "Guides",
     items: [
       { title: "Custom Schema", href: "/docs/custom-schema" },
+      { title: "Streaming", href: "/docs/streaming" },
       { title: "Code Export", href: "/docs/code-export" },
     ],
   },
@@ -125,26 +74,9 @@ 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/react-email", href: "/docs/api/react-email" },
-      { title: "@json-render/shadcn", href: "/docs/api/shadcn" },
       { title: "@json-render/react-native", href: "/docs/api/react-native" },
-      { title: "@json-render/image", href: "/docs/api/image" },
       { title: "@json-render/remotion", href: "/docs/api/remotion" },
-      { title: "@json-render/vue", href: "/docs/api/vue" },
-      { title: "@json-render/svelte", href: "/docs/api/svelte" },
-      { title: "@json-render/solid", href: "/docs/api/solid" },
-      {
-        title: "@json-render/react-three-fiber",
-        href: "/docs/api/react-three-fiber",
-      },
       { title: "@json-render/codegen", href: "/docs/api/codegen" },
-      { title: "@json-render/mcp", href: "/docs/api/mcp" },
-      { title: "@json-render/redux", href: "/docs/api/redux" },
-      { title: "@json-render/zustand", href: "/docs/api/zustand" },
-      { title: "@json-render/jotai", href: "/docs/api/jotai" },
-      { title: "@json-render/xstate", href: "/docs/api/xstate" },
-      { title: "@json-render/yaml", href: "/docs/api/yaml" },
     ],
   },
 ];

apps/web/lib/page-metadata.ts

@@ -1,39 +0,0 @@
-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],
-    },
-  };
-}

apps/web/lib/page-titles.ts

@@ -3,11 +3,11 @@
  * Used by both page metadata exports and the OG image route.
  *
  * Keys mirror the page's URL path (e.g., "docs/changelog" → /og/docs/changelog).
- * Values are display titles (without the "| json-render" suffix — the layout template adds that).
+ * Values are display titles (without the "| json-render" suffix -- the layout template adds that).
  */
 export const PAGE_TITLES: Record<string, string> = {
   // Home (no slug)
-  "": "The Generative UI\nFramework",
+  "": "The framework for\nUser-Generated Interfaces",
 
   // Top-level
   playground: "Playground",
@@ -23,11 +23,7 @@ export const PAGE_TITLES: Record<string, string> = {
   "docs/streaming": "Streaming",
   "docs/validation": "Validation",
   "docs/data-binding": "Data Binding",
-  "docs/computed-values": "Computed Values",
   "docs/visibility": "Visibility",
-  "docs/watchers": "Watchers",
-  "docs/renderers": "Renderers",
-  "docs/generation-modes": "Generation Modes",
   "docs/code-export": "Code Export",
   "docs/custom-schema": "Custom Schema & Renderer",
   "docs/ai-sdk": "AI SDK Integration",
@@ -35,30 +31,14 @@ export const PAGE_TITLES: Record<string, string> = {
   "docs/openapi": "OpenAPI Integration",
   "docs/a2ui": "A2UI Integration",
   "docs/ag-ui": "AG-UI Integration",
-  "docs/migration": "Migration Guide",
   "docs/changelog": "Changelog",
-  "docs/skills": "Skills",
 
   // API references
   "docs/api/core": "@json-render/core API",
   "docs/api/react": "@json-render/react API",
-  "docs/api/vue": "@json-render/vue API",
-  "docs/api/solid": "@json-render/solid API",
-  "docs/api/react-pdf": "@json-render/react-pdf API",
-  "docs/api/react-email": "@json-render/react-email API",
   "docs/api/react-native": "@json-render/react-native API",
-  "docs/api/svelte": "@json-render/svelte API",
   "docs/api/codegen": "@json-render/codegen API",
-  "docs/api/image": "@json-render/image API",
   "docs/api/remotion": "@json-render/remotion API",
-  "docs/api/shadcn": "@json-render/shadcn API",
-  "docs/api/mcp": "@json-render/mcp API",
-  "docs/api/redux": "@json-render/redux API",
-  "docs/api/zustand": "@json-render/zustand API",
-  "docs/api/jotai": "@json-render/jotai API",
-  "docs/api/react-three-fiber": "@json-render/react-three-fiber API",
-  "docs/api/xstate": "@json-render/xstate API",
-  "docs/api/yaml": "@json-render/yaml API",
 };
 
 /**

apps/web/lib/rate-limit.ts

@@ -21,10 +21,7 @@ const noopRateLimiter = {
   limit: async () => ({ success: true, limit: 0, remaining: 0, reset: 0 }),
 };
 
-const MINUTE_LIMIT = Number(process.env.RATE_LIMIT_PER_MINUTE) || 10;
-const DAILY_LIMIT = Number(process.env.RATE_LIMIT_PER_DAY) || 100;
-
-// Requests per minute (sliding window)
+// 10 requests per minute (sliding window)
 export const minuteRateLimit = {
   limit: async (identifier: string) => {
     if (!_minuteRateLimit) {
@@ -32,7 +29,7 @@ export const minuteRateLimit = {
       if (!redis) return noopRateLimiter.limit();
       _minuteRateLimit = new Ratelimit({
         redis,
-        limiter: Ratelimit.slidingWindow(MINUTE_LIMIT, "1 m"),
+        limiter: Ratelimit.slidingWindow(10, "1 m"),
         prefix: "ratelimit:minute",
       });
     }
@@ -40,7 +37,7 @@ export const minuteRateLimit = {
   },
 };
 
-// Requests per day (fixed window)
+// 100 requests per day (fixed window)
 export const dailyRateLimit = {
   limit: async (identifier: string) => {
     if (!_dailyRateLimit) {
@@ -48,7 +45,7 @@ export const dailyRateLimit = {
       if (!redis) return noopRateLimiter.limit();
       _dailyRateLimit = new Ratelimit({
         redis,
-        limiter: Ratelimit.fixedWindow(DAILY_LIMIT, "1 d"),
+        limiter: Ratelimit.fixedWindow(100, "1 d"),
         prefix: "ratelimit:daily",
       });
     }

apps/web/lib/render/catalog-display.ts

@@ -1,117 +0,0 @@
-/**
- * Shared utility for extracting catalog data for display in the UI.
- * Used by both the demo and playground components.
- */
-
-export interface CatalogField {
-  name: string;
-  type: string;
-}
-
-export interface CatalogComponentInfo {
-  name: string;
-  description: string;
-  props: CatalogField[];
-  slots: string[];
-  events: string[];
-}
-
-export interface CatalogActionInfo {
-  name: string;
-  description: string;
-  params: CatalogField[];
-}
-
-export interface CatalogDisplayData {
-  components: CatalogComponentInfo[];
-  actions: CatalogActionInfo[];
-}
-
-/**
- * Extract field names and types from a Zod schema object.
- * Supports both Zod v3 and v4 shape formats.
- */
-export function extractFields(zodObj: unknown): CatalogField[] {
-  if (!zodObj) return [];
-  try {
-    // eslint-disable-next-line @typescript-eslint/no-explicit-any
-    const obj = zodObj as any;
-    // Zod v4: shape is a plain object; Zod v3: shape is via _def.shape()
-    const shape =
-      typeof obj.shape === "object"
-        ? obj.shape
-        : typeof obj._def?.shape === "function"
-          ? obj._def.shape()
-          : typeof obj._def?.shape === "object"
-            ? obj._def.shape
-            : null;
-    if (!shape) return [];
-
-    return Object.entries(shape).map(([name, schema]) => {
-      let type = "unknown";
-      try {
-        // eslint-disable-next-line @typescript-eslint/no-explicit-any
-        const s = schema as any;
-        const typeName: string = s?._zod?.def?.type ?? s?._def?.typeName ?? "";
-        if (typeName.includes("string")) type = "string";
-        else if (typeName.includes("number")) type = "number";
-        else if (typeName.includes("boolean")) type = "boolean";
-        else if (typeName.includes("array")) type = "array";
-        else if (typeName.includes("enum")) {
-          const values = s?._zod?.def?.values ?? s?._def?.values;
-          type = Array.isArray(values) ? values.join(" | ") : "enum";
-        } else if (typeName.includes("union")) type = "union";
-        else if (typeName.includes("nullable")) {
-          const inner = s?._zod?.def?.innerType ?? s?._def?.innerType;
-          const innerName: string =
-            inner?._zod?.def?.type ?? inner?._def?.typeName ?? "";
-          if (innerName.includes("string")) type = "string?";
-          else if (innerName.includes("number")) type = "number?";
-          else if (innerName.includes("boolean")) type = "boolean?";
-          else if (innerName.includes("array")) type = "array?";
-          else if (innerName.includes("enum")) {
-            const values = inner?._zod?.def?.values ?? inner?._def?.values;
-            type = Array.isArray(values) ? `(${values.join(" | ")})?` : "enum?";
-          } else type = "optional";
-        }
-      } catch {
-        // ignore
-      }
-      return { name, type };
-    });
-  } catch {
-    return [];
-  }
-}
-
-/**
- * Extract display data from a catalog's raw data.
- * Parses component definitions and action definitions into a
- * structured format suitable for rendering in the UI.
- */
-export function buildCatalogDisplayData(
-  // eslint-disable-next-line @typescript-eslint/no-explicit-any
-  rawCatalogData: any,
-): CatalogDisplayData {
-  const components = Object.entries(rawCatalogData.components ?? {})
-    // eslint-disable-next-line @typescript-eslint/no-explicit-any
-    .map(([name, def]: [string, any]) => ({
-      name,
-      description: (def.description as string) ?? "",
-      props: extractFields(def.props),
-      slots: (def.slots as string[]) ?? [],
-      events: (def.events as string[]) ?? [],
-    }))
-    .sort((a, b) => a.name.localeCompare(b.name));
-
-  const actions = Object.entries(rawCatalogData.actions ?? {})
-    // eslint-disable-next-line @typescript-eslint/no-explicit-any
-    .map(([name, def]: [string, any]) => ({
-      name,
-      description: (def.description as string) ?? "",
-      params: extractFields(def.params),
-    }))
-    .sort((a, b) => a.name.localeCompare(b.name));
-
-  return { components, actions };
-}

apps/web/lib/render/catalog.ts

@@ -24,7 +24,6 @@ export const playgroundCatalog = defineCatalog(schema, {
       slots: ["default"],
       description:
         "Container card for content sections. Use for forms/content boxes, NOT for page headers.",
-      example: { title: "Overview", description: "Your account summary" },
     },
 
     Stack: {
@@ -38,7 +37,6 @@ export const playgroundCatalog = defineCatalog(schema, {
       }),
       slots: ["default"],
       description: "Flex container for layouts",
-      example: { direction: "vertical", gap: "md" },
     },
 
     Grid: {
@@ -48,7 +46,6 @@ export const playgroundCatalog = defineCatalog(schema, {
       }),
       slots: ["default"],
       description: "Grid layout (1-6 columns)",
-      example: { columns: 3, gap: "md" },
     },
 
     Separator: {
@@ -67,11 +64,11 @@ export const playgroundCatalog = defineCatalog(schema, {
           }),
         ),
         defaultValue: z.string().nullable(),
-        value: z.string().nullable(),
+        statePath: z.string().nullable(),
       }),
       events: ["change"],
       description:
-        "Tab navigation. Use { $bindState } on value for active tab binding.",
+        "Tab navigation. Use statePath to bind the active tab value.",
     },
 
     Accordion: {
@@ -140,13 +137,6 @@ export const playgroundCatalog = defineCatalog(schema, {
       }),
       description:
         'Data table. columns: header labels. rows: 2D array of cell strings, e.g. [["Alice","admin"],["Bob","user"]].',
-      example: {
-        columns: ["Name", "Role"],
-        rows: [
-          ["Alice", "Admin"],
-          ["Bob", "User"],
-        ],
-      },
     },
 
     Heading: {
@@ -155,7 +145,6 @@ export const playgroundCatalog = defineCatalog(schema, {
         level: z.enum(["h1", "h2", "h3", "h4"]).nullable(),
       }),
       description: "Heading text (h1-h4)",
-      example: { text: "Welcome", level: "h1" },
     },
 
     Text: {
@@ -166,7 +155,6 @@ export const playgroundCatalog = defineCatalog(schema, {
           .nullable(),
       }),
       description: "Paragraph text",
-      example: { text: "Hello, world!" },
     },
 
     Image: {
@@ -185,7 +173,6 @@ export const playgroundCatalog = defineCatalog(schema, {
         size: z.enum(["sm", "md", "lg"]).nullable(),
       }),
       description: "User avatar with fallback initials",
-      example: { name: "Jane Doe", size: "md" },
     },
 
     Badge: {
@@ -194,7 +181,6 @@ export const playgroundCatalog = defineCatalog(schema, {
         variant: z.enum(["default", "success", "warning", "danger"]).nullable(),
       }),
       description: "Status badge",
-      example: { text: "Active", variant: "success" },
     },
 
     Alert: {
@@ -204,11 +190,6 @@ export const playgroundCatalog = defineCatalog(schema, {
         type: z.enum(["info", "success", "warning", "error"]).nullable(),
       }),
       description: "Alert banner",
-      example: {
-        title: "Note",
-        message: "Your changes have been saved.",
-        type: "success",
-      },
     },
 
     Progress: {
@@ -218,7 +199,6 @@ export const playgroundCatalog = defineCatalog(schema, {
         label: z.string().nullable(),
       }),
       description: "Progress bar (value 0-100)",
-      example: { value: 65, max: 100, label: "Upload progress" },
     },
 
     Skeleton: {
@@ -297,26 +277,10 @@ export const playgroundCatalog = defineCatalog(schema, {
         name: z.string(),
         type: z.enum(["text", "email", "password", "number"]).nullable(),
         placeholder: z.string().nullable(),
-        value: z.string().nullable(),
-        checks: z
-          .array(
-            z.object({
-              type: z.string(),
-              message: z.string(),
-              args: z.record(z.string(), z.unknown()).optional(),
-            }),
-          )
-          .nullable(),
+        statePath: z.string().nullable(),
       }),
       events: ["submit", "focus", "blur"],
-      description:
-        "Text input field. Use { $bindState } on value for two-way binding. Use checks for validation (e.g. required, email, minLength).",
-      example: {
-        label: "Email",
-        name: "email",
-        type: "email",
-        placeholder: "you@example.com",
-      },
+      description: "Text input field. Use statePath for two-way binding.",
     },
 
     Textarea: {
@@ -325,19 +289,9 @@ export const playgroundCatalog = defineCatalog(schema, {
         name: z.string(),
         placeholder: z.string().nullable(),
         rows: z.number().nullable(),
-        value: z.string().nullable(),
-        checks: z
-          .array(
-            z.object({
-              type: z.string(),
-              message: z.string(),
-              args: z.record(z.string(), z.unknown()).optional(),
-            }),
-          )
-          .nullable(),
+        statePath: z.string().nullable(),
       }),
-      description:
-        "Multi-line text input. Use { $bindState } on value for binding. Use checks for validation.",
+      description: "Multi-line text input. Use statePath for binding.",
     },
 
     Select: {
@@ -346,20 +300,10 @@ export const playgroundCatalog = defineCatalog(schema, {
         name: z.string(),
         options: z.array(z.string()),
         placeholder: z.string().nullable(),
-        value: z.string().nullable(),
-        checks: z
-          .array(
-            z.object({
-              type: z.string(),
-              message: z.string(),
-              args: z.record(z.string(), z.unknown()).optional(),
-            }),
-          )
-          .nullable(),
+        statePath: z.string().nullable(),
       }),
       events: ["change"],
-      description:
-        "Dropdown select input. Use { $bindState } on value for binding. Use checks for validation.",
+      description: "Dropdown select input. Use statePath for binding.",
     },
 
     Checkbox: {
@@ -367,9 +311,10 @@ export const playgroundCatalog = defineCatalog(schema, {
         label: z.string(),
         name: z.string(),
         checked: z.boolean().nullable(),
+        statePath: z.string().nullable(),
       }),
       events: ["change"],
-      description: "Checkbox input. Use { $bindState } on checked for binding.",
+      description: "Checkbox input. Use statePath for binding.",
     },
 
     Radio: {
@@ -377,11 +322,10 @@ export const playgroundCatalog = defineCatalog(schema, {
         label: z.string(),
         name: z.string(),
         options: z.array(z.string()),
-        value: z.string().nullable(),
+        statePath: z.string().nullable(),
       }),
       events: ["change"],
-      description:
-        "Radio button group. Use { $bindState } on value for binding.",
+      description: "Radio button group. Use statePath for binding.",
     },
 
     Switch: {
@@ -389,9 +333,10 @@ export const playgroundCatalog = defineCatalog(schema, {
         label: z.string(),
         name: z.string(),
         checked: z.boolean().nullable(),
+        statePath: z.string().nullable(),
       }),
       events: ["change"],
-      description: "Toggle switch. Use { $bindState } on checked for binding.",
+      description: "Toggle switch. Use statePath for binding.",
     },
 
     Slider: {
@@ -400,11 +345,10 @@ export const playgroundCatalog = defineCatalog(schema, {
         min: z.number().nullable(),
         max: z.number().nullable(),
         step: z.number().nullable(),
-        value: z.number().nullable(),
+        statePath: z.string().nullable(),
       }),
       events: ["change"],
-      description:
-        "Range slider input. Use { $bindState } on value for binding.",
+      description: "Range slider input. Use statePath for binding.",
     },
 
     // ── Actions ─────────────────────────────────────────────────────────
@@ -416,7 +360,6 @@ export const playgroundCatalog = defineCatalog(schema, {
       }),
       events: ["press"],
       description: "Clickable button. Bind on.press for handler.",
-      example: { label: "Submit", variant: "primary" },
     },
 
     Link: {
@@ -446,11 +389,11 @@ export const playgroundCatalog = defineCatalog(schema, {
       props: z.object({
         label: z.string(),
         pressed: z.boolean().nullable(),
+        statePath: z.string().nullable(),
         variant: z.enum(["default", "outline"]).nullable(),
       }),
       events: ["change"],
-      description:
-        "Toggle button. Use { $bindState } on pressed for state binding.",
+      description: "Toggle button. Use statePath for pressed state binding.",
     },
 
     ToggleGroup: {
@@ -462,11 +405,11 @@ export const playgroundCatalog = defineCatalog(schema, {
           }),
         ),
         type: z.enum(["single", "multiple"]).nullable(),
-        value: z.string().nullable(),
+        statePath: z.string().nullable(),
       }),
       events: ["change"],
       description:
-        "Group of toggle buttons. Type 'single' (default) or 'multiple'. Use { $bindState } on value.",
+        "Group of toggle buttons. Type 'single' (default) or 'multiple'.",
     },
 
     ButtonGroup: {
@@ -477,46 +420,45 @@ export const playgroundCatalog = defineCatalog(schema, {
             value: z.string(),
           }),
         ),
-        selected: z.string().nullable(),
+        statePath: z.string().nullable(),
       }),
       events: ["change"],
-      description:
-        "Segmented button group. Use { $bindState } on selected for selected value.",
+      description: "Segmented button group. Use statePath for selected value.",
     },
 
     Pagination: {
       props: z.object({
         totalPages: z.number(),
-        page: z.number().nullable(),
+        statePath: z.string(),
       }),
       events: ["change"],
       description:
-        "Page navigation. Use { $bindState } on page for current page number.",
+        "Page navigation. Bind statePath to a number for current page.",
     },
   },
 
   actions: {
     setState: {
       params: z.object({
-        statePath: z.string(),
+        path: z.string(),
         value: z.unknown(),
       }),
-      description: "Update a value in the state model at the given statePath.",
+      description: "Update a value in the state model at the given path.",
     },
 
     pushState: {
       params: z.object({
-        statePath: z.string(),
+        path: z.string(),
         value: z.unknown(),
-        clearStatePath: z.string().optional(),
+        clearPath: z.string().optional(),
       }),
       description:
-        'Append an item to an array in state. Value can contain {"$state":"/statePath"} refs and "$id" for auto IDs. clearStatePath resets another path after pushing.',
+        'Append an item to an array in state. Value can contain {path:"/statePath"} refs and "$id" for auto IDs. clearPath resets another path after pushing.',
     },
 
     removeState: {
       params: z.object({
-        statePath: z.string(),
+        path: z.string(),
         index: z.number(),
       }),
       description: "Remove an item from an array in state at the given index.",

apps/web/lib/render/registry.tsx

@@ -1,12 +1,7 @@
 "use client";
 
 import { useState } from "react";
-import {
-  defineRegistry,
-  useBoundProp,
-  useStateBinding,
-  useFieldValidation,
-} from "@json-render/react";
+import { defineRegistry, useStateBinding } from "@json-render/react";
 import { toast } from "sonner";
 
 import { playgroundCatalog } from "./catalog";
@@ -215,25 +210,25 @@ export const { registry, executeAction } = defineRegistry(playgroundCatalog, {
       />
     ),
 
-    Tabs: ({ props, bindings, emit }) => {
+    Tabs: ({ props, emit }) => {
       const tabs = props.tabs ?? [];
-      const [boundValue, setBoundValue] = useBoundProp<string>(
-        props.value as string | undefined,
-        bindings?.value,
-      );
+      const [boundValue, setBoundValue] = props.statePath
+        ? useStateBinding<string>(props.statePath) // eslint-disable-line react-hooks/rules-of-hooks
+        : [undefined, undefined];
       const [localValue, setLocalValue] = useState(
         props.defaultValue ?? tabs[0]?.value ?? "",
       );
-      const isBound = !!bindings?.value;
-      const value = isBound ? (boundValue ?? tabs[0]?.value ?? "") : localValue;
-      const setValue = isBound ? setBoundValue : setLocalValue;
+      const value = props.statePath
+        ? (boundValue ?? tabs[0]?.value ?? "")
+        : localValue;
+      const setValue = props.statePath ? setBoundValue! : setLocalValue;
 
       return (
         <TabsPrimitive
           value={value}
           onValueChange={(v) => {
             setValue(v);
-            emit("change");
+            emit?.("change");
           }}
         >
           <TabsList>
@@ -770,21 +765,13 @@ export const { registry, executeAction } = defineRegistry(playgroundCatalog, {
 
     // ── Form Inputs ───────────────────────────────────────────────────
 
-    Input: ({ props, bindings, emit }) => {
-      const [boundValue, setBoundValue] = useBoundProp<string>(
-        props.value as string | undefined,
-        bindings?.value,
-      );
+    Input: ({ props, emit }) => {
+      const [boundValue, setBoundValue] = props.statePath
+        ? useStateBinding<string>(props.statePath) // eslint-disable-line react-hooks/rules-of-hooks
+        : [undefined, undefined];
       const [localValue, setLocalValue] = useState("");
-      const isBound = !!bindings?.value;
-      const value = isBound ? (boundValue ?? "") : localValue;
-      const setValue = isBound ? setBoundValue : setLocalValue;
-
-      const hasValidation = !!(bindings?.value && props.checks?.length);
-      const { errors, validate } = useFieldValidation(
-        bindings?.value ?? "",
-        hasValidation ? { checks: props.checks ?? [] } : undefined,
-      );
+      const value = props.statePath ? (boundValue ?? "") : localValue;
+      const setValue = props.statePath ? setBoundValue! : setLocalValue;
 
       return (
         <div className="space-y-2">
@@ -797,36 +784,22 @@ export const { registry, executeAction } = defineRegistry(playgroundCatalog, {
             value={value}
             onChange={(e) => setValue(e.target.value)}
             onKeyDown={(e) => {
-              if (e.key === "Enter") emit("submit");
-            }}
-            onFocus={() => emit("focus")}
-            onBlur={() => {
-              if (hasValidation) validate();
-              emit("blur");
+              if (e.key === "Enter") emit?.("submit");
             }}
+            onFocus={() => emit?.("focus")}
+            onBlur={() => emit?.("blur")}
           />
-          {errors.length > 0 && (
-            <p className="text-sm text-destructive">{errors[0]}</p>
-          )}
         </div>
       );
     },
 
-    Textarea: ({ props, bindings }) => {
-      const [boundValue, setBoundValue] = useBoundProp<string>(
-        props.value as string | undefined,
-        bindings?.value,
-      );
+    Textarea: ({ props }) => {
+      const [boundValue, setBoundValue] = props.statePath
+        ? useStateBinding<string>(props.statePath) // eslint-disable-line react-hooks/rules-of-hooks
+        : [undefined, undefined];
       const [localValue, setLocalValue] = useState("");
-      const isBound = !!bindings?.value;
-      const value = isBound ? (boundValue ?? "") : localValue;
-      const setValue = isBound ? setBoundValue : setLocalValue;
-
-      const hasValidation = !!(bindings?.value && props.checks?.length);
-      const { errors, validate } = useFieldValidation(
-        bindings?.value ?? "",
-        hasValidation ? { checks: props.checks ?? [] } : undefined,
-      );
+      const value = props.statePath ? (boundValue ?? "") : localValue;
+      const setValue = props.statePath ? setBoundValue! : setLocalValue;
 
       return (
         <div className="space-y-2">
@@ -838,38 +811,19 @@ export const { registry, executeAction } = defineRegistry(playgroundCatalog, {
             rows={props.rows ?? 3}
             value={value}
             onChange={(e) => setValue(e.target.value)}
-            onBlur={() => {
-              if (hasValidation) validate();
-            }}
           />
-          {errors.length > 0 && (
-            <p className="text-sm text-destructive">{errors[0]}</p>
-          )}
         </div>
       );
     },
 
-    Select: ({ props, bindings, emit }) => {
-      const [boundValue, setBoundValue] = useBoundProp<string>(
-        props.value as string | undefined,
-        bindings?.value,
-      );
+    Select: ({ props, emit }) => {
+      const [boundValue, setBoundValue] = props.statePath
+        ? useStateBinding<string>(props.statePath) // eslint-disable-line react-hooks/rules-of-hooks
+        : [undefined, undefined];
       const [localValue, setLocalValue] = useState<string>("");
-      const isBound = !!bindings?.value;
-      const value = isBound ? (boundValue ?? "") : localValue;
-      const setValue = isBound ? setBoundValue : setLocalValue;
-      const rawOptions = props.options ?? [];
-      // Coerce options to strings – AI may produce objects/numbers instead of
-      // plain strings which would cause duplicate `[object Object]` keys.
-      const options = rawOptions.map((opt) =>
-        typeof opt === "string" ? opt : String(opt ?? ""),
-      );
-
-      const hasValidation = !!(bindings?.value && props.checks?.length);
-      const { errors, validate } = useFieldValidation(
-        bindings?.value ?? "",
-        hasValidation ? { checks: props.checks ?? [] } : undefined,
-      );
+      const value = props.statePath ? (boundValue ?? "") : localValue;
+      const setValue = props.statePath ? setBoundValue! : setLocalValue;
+      const options = props.options ?? [];
 
       return (
         <div className="space-y-2">
@@ -878,40 +832,31 @@ export const { registry, executeAction } = defineRegistry(playgroundCatalog, {
             value={value}
             onValueChange={(v) => {
               setValue(v);
-              if (hasValidation) validate();
-              emit("change");
+              emit?.("change");
             }}
           >
             <SelectTrigger className="w-full">
               <SelectValue placeholder={props.placeholder ?? "Select..."} />
             </SelectTrigger>
             <SelectContent>
-              {options.map((opt, idx) => (
-                <SelectItem
-                  key={`${idx}-${opt}`}
-                  value={opt || `option-${idx}`}
-                >
+              {options.map((opt) => (
+                <SelectItem key={opt} value={opt}>
                   {opt}
                 </SelectItem>
               ))}
             </SelectContent>
           </Select>
-          {errors.length > 0 && (
-            <p className="text-sm text-destructive">{errors[0]}</p>
-          )}
         </div>
       );
     },
 
-    Checkbox: ({ props, bindings, emit }) => {
-      const [boundChecked, setBoundChecked] = useBoundProp<boolean>(
-        props.checked as boolean | undefined,
-        bindings?.checked,
-      );
+    Checkbox: ({ props, emit }) => {
+      const [boundValue, setBoundValue] = props.statePath
+        ? useStateBinding<boolean>(props.statePath) // eslint-disable-line react-hooks/rules-of-hooks
+        : [undefined, undefined];
       const [localChecked, setLocalChecked] = useState(!!props.checked);
-      const isBound = !!bindings?.checked;
-      const checked = isBound ? (boundChecked ?? false) : localChecked;
-      const setChecked = isBound ? setBoundChecked : setLocalChecked;
+      const checked = props.statePath ? (boundValue ?? false) : localChecked;
+      const setChecked = props.statePath ? setBoundValue! : setLocalChecked;
 
       return (
         <div className="flex items-center space-x-2">
@@ -920,7 +865,7 @@ export const { registry, executeAction } = defineRegistry(playgroundCatalog, {
             checked={checked}
             onCheckedChange={(c) => {
               setChecked(c === true);
-              emit("change");
+              emit?.("change");
             }}
           />
           <Label htmlFor={props.name} className="cursor-pointer">
@@ -930,19 +875,14 @@ export const { registry, executeAction } = defineRegistry(playgroundCatalog, {
       );
     },
 
-    Radio: ({ props, bindings, emit }) => {
-      const rawOptions = props.options ?? [];
-      const options = rawOptions.map((opt) =>
-        typeof opt === "string" ? opt : String(opt ?? ""),
-      );
-      const [boundValue, setBoundValue] = useBoundProp<string>(
-        props.value as string | undefined,
-        bindings?.value,
-      );
+    Radio: ({ props, emit }) => {
+      const options = props.options ?? [];
+      const [boundValue, setBoundValue] = props.statePath
+        ? useStateBinding<string>(props.statePath) // eslint-disable-line react-hooks/rules-of-hooks
+        : [undefined, undefined];
       const [localValue, setLocalValue] = useState(options[0] ?? "");
-      const isBound = !!bindings?.value;
-      const value = isBound ? (boundValue ?? "") : localValue;
-      const setValue = isBound ? setBoundValue : setLocalValue;
+      const value = props.statePath ? (boundValue ?? "") : localValue;
+      const setValue = props.statePath ? setBoundValue! : setLocalValue;
 
       return (
         <div className="space-y-2">
@@ -951,20 +891,14 @@ export const { registry, executeAction } = defineRegistry(playgroundCatalog, {
             value={value}
             onValueChange={(v) => {
               setValue(v);
-              emit("change");
+              emit?.("change");
             }}
           >
-            {options.map((opt, idx) => (
-              <div
-                key={`${idx}-${opt}`}
-                className="flex items-center space-x-2"
-              >
-                <RadioGroupItem
-                  value={opt || `option-${idx}`}
-                  id={`${props.name}-${idx}-${opt}`}
-                />
+            {options.map((opt) => (
+              <div key={opt} className="flex items-center space-x-2">
+                <RadioGroupItem value={opt} id={`${props.name}-${opt}`} />
                 <Label
-                  htmlFor={`${props.name}-${idx}-${opt}`}
+                  htmlFor={`${props.name}-${opt}`}
                   className="cursor-pointer"
                 >
                   {opt}
@@ -976,15 +910,13 @@ export const { registry, executeAction } = defineRegistry(playgroundCatalog, {
       );
     },
 
-    Switch: ({ props, bindings, emit }) => {
-      const [boundChecked, setBoundChecked] = useBoundProp<boolean>(
-        props.checked as boolean | undefined,
-        bindings?.checked,
-      );
+    Switch: ({ props, emit }) => {
+      const [boundValue, setBoundValue] = props.statePath
+        ? useStateBinding<boolean>(props.statePath) // eslint-disable-line react-hooks/rules-of-hooks
+        : [undefined, undefined];
       const [localChecked, setLocalChecked] = useState(!!props.checked);
-      const isBound = !!bindings?.checked;
-      const checked = isBound ? (boundChecked ?? false) : localChecked;
-      const setChecked = isBound ? setBoundChecked : setLocalChecked;
+      const checked = props.statePath ? (boundValue ?? false) : localChecked;
+      const setChecked = props.statePath ? setBoundValue! : setLocalChecked;
 
       return (
         <div className="flex items-center justify-between space-x-2">
@@ -996,22 +928,22 @@ export const { registry, executeAction } = defineRegistry(playgroundCatalog, {
             checked={checked}
             onCheckedChange={(c) => {
               setChecked(c);
-              emit("change");
+              emit?.("change");
             }}
           />
         </div>
       );
     },
 
-    Slider: ({ props, bindings, emit }) => {
-      const [boundValue, setBoundValue] = useBoundProp<number>(
-        props.value as number | undefined,
-        bindings?.value,
-      );
+    Slider: ({ props, emit }) => {
+      const [boundValue, setBoundValue] = props.statePath
+        ? useStateBinding<number>(props.statePath) // eslint-disable-line react-hooks/rules-of-hooks
+        : [undefined, undefined];
       const [localValue, setLocalValue] = useState(props.min ?? 0);
-      const isBound = !!bindings?.value;
-      const value = isBound ? (boundValue ?? props.min ?? 0) : localValue;
-      const setValue = isBound ? setBoundValue : setLocalValue;
+      const value = props.statePath
+        ? (boundValue ?? props.min ?? 0)
+        : localValue;
+      const setValue = props.statePath ? setBoundValue! : setLocalValue;
 
       return (
         <div className="space-y-2">
@@ -1028,7 +960,7 @@ export const { registry, executeAction } = defineRegistry(playgroundCatalog, {
             step={props.step ?? 1}
             onValueChange={(v) => {
               setValue(v[0] ?? 0);
-              emit("change");
+              emit?.("change");
             }}
           />
         </div>
@@ -1049,7 +981,7 @@ export const { registry, executeAction } = defineRegistry(playgroundCatalog, {
         <Button
           variant={variant}
           disabled={props.disabled ?? false}
-          onClick={() => emit("press")}
+          onClick={() => emit?.("press")}
         >
           {props.label}
         </Button>
@@ -1060,7 +992,7 @@ export const { registry, executeAction } = defineRegistry(playgroundCatalog, {
       <Button
         variant="link"
         className="h-auto p-0"
-        onClick={() => emit("press")}
+        onClick={() => emit?.("press")}
       >
         {props.label}
       </Button>
@@ -1075,7 +1007,10 @@ export const { registry, executeAction } = defineRegistry(playgroundCatalog, {
           </DropdownMenuTrigger>
           <DropdownMenuContent>
             {items.map((item) => (
-              <DropdownMenuItem key={item.value} onClick={() => emit("select")}>
+              <DropdownMenuItem
+                key={item.value}
+                onClick={() => emit?.("select")}
+              >
                 {item.label}
               </DropdownMenuItem>
             ))}
@@ -1084,15 +1019,13 @@ export const { registry, executeAction } = defineRegistry(playgroundCatalog, {
       );
     },
 
-    Toggle: ({ props, bindings, emit }) => {
-      const [boundPressed, setBoundPressed] = useBoundProp<boolean>(
-        props.pressed as boolean | undefined,
-        bindings?.pressed,
-      );
+    Toggle: ({ props, emit }) => {
+      const [boundValue, setBoundValue] = props.statePath
+        ? useStateBinding<boolean>(props.statePath) // eslint-disable-line react-hooks/rules-of-hooks
+        : [undefined, undefined];
       const [localPressed, setLocalPressed] = useState(props.pressed ?? false);
-      const isBound = !!bindings?.pressed;
-      const pressed = isBound ? (boundPressed ?? false) : localPressed;
-      const setPressed = isBound ? setBoundPressed : setLocalPressed;
+      const pressed = props.statePath ? (boundValue ?? false) : localPressed;
+      const setPressed = props.statePath ? setBoundValue! : setLocalPressed;
 
       return (
         <Toggle
@@ -1100,7 +1033,7 @@ export const { registry, executeAction } = defineRegistry(playgroundCatalog, {
           pressed={pressed}
           onPressedChange={(v) => {
             setPressed(v);
-            emit("change");
+            emit?.("change");
           }}
         >
           {props.label}
@@ -1108,17 +1041,15 @@ export const { registry, executeAction } = defineRegistry(playgroundCatalog, {
       );
     },
 
-    ToggleGroup: ({ props, bindings, emit }) => {
+    ToggleGroup: ({ props, emit }) => {
       const type = props.type ?? "single";
       const items = props.items ?? [];
-      const [boundValue, setBoundValue] = useBoundProp<string>(
-        props.value as string | undefined,
-        bindings?.value,
-      );
+      const [boundValue, setBoundValue] = props.statePath
+        ? useStateBinding<string>(props.statePath) // eslint-disable-line react-hooks/rules-of-hooks
+        : [undefined, undefined];
       const [localValue, setLocalValue] = useState(items[0]?.value ?? "");
-      const isBound = !!bindings?.value;
-      const value = isBound ? (boundValue ?? "") : localValue;
-      const setValue = isBound ? setBoundValue : setLocalValue;
+      const value = props.statePath ? (boundValue ?? "") : localValue;
+      const setValue = props.statePath ? setBoundValue! : setLocalValue;
 
       if (type === "multiple") {
         return (
@@ -1139,7 +1070,7 @@ export const { registry, executeAction } = defineRegistry(playgroundCatalog, {
           onValueChange={(v) => {
             if (v) {
               setValue(v);
-              emit("change");
+              emit?.("change");
             }
           }}
         >
@@ -1152,16 +1083,14 @@ export const { registry, executeAction } = defineRegistry(playgroundCatalog, {
       );
     },
 
-    ButtonGroup: ({ props, bindings, emit }) => {
+    ButtonGroup: ({ props, emit }) => {
       const buttons = props.buttons ?? [];
-      const [boundSelected, setBoundSelected] = useBoundProp<string>(
-        props.selected as string | undefined,
-        bindings?.selected,
-      );
+      const [boundValue, setBoundValue] = props.statePath
+        ? useStateBinding<string>(props.statePath) // eslint-disable-line react-hooks/rules-of-hooks
+        : [undefined, undefined];
       const [localValue, setLocalValue] = useState(buttons[0]?.value ?? "");
-      const isBound = !!bindings?.selected;
-      const value = isBound ? (boundSelected ?? "") : localValue;
-      const setValue = isBound ? setBoundSelected : setLocalValue;
+      const value = props.statePath ? (boundValue ?? "") : localValue;
+      const setValue = props.statePath ? setBoundValue! : setLocalValue;
 
       return (
         <div className="inline-flex rounded-md border border-border">
@@ -1177,7 +1106,7 @@ export const { registry, executeAction } = defineRegistry(playgroundCatalog, {
               } ${i === buttons.length - 1 ? "rounded-r-md" : ""}`}
               onClick={() => {
                 setValue(btn.value);
-                emit("change");
+                emit?.("change");
               }}
             >
               {btn.label}
@@ -1187,12 +1116,11 @@ export const { registry, executeAction } = defineRegistry(playgroundCatalog, {
       );
     },
 
-    Pagination: ({ props, bindings, emit }) => {
-      const [boundPage, setBoundPage] = useBoundProp<number>(
-        props.page as number | undefined,
-        bindings?.page,
+    Pagination: ({ props, emit }) => {
+      const [boundValue, setBoundValue] = useStateBinding<number>(
+        props.statePath,
       );
-      const currentPage = boundPage ?? 1;
+      const currentPage = boundValue ?? 1;
       const pages = Array.from({ length: props.totalPages }, (_, i) => i + 1);
 
       return (
@@ -1204,8 +1132,8 @@ export const { registry, executeAction } = defineRegistry(playgroundCatalog, {
                 onClick={(e) => {
                   e.preventDefault();
                   if (currentPage > 1) {
-                    setBoundPage(currentPage - 1);
-                    emit("change");
+                    setBoundValue(currentPage - 1);
+                    emit?.("change");
                   }
                 }}
               />
@@ -1217,8 +1145,8 @@ export const { registry, executeAction } = defineRegistry(playgroundCatalog, {
                   isActive={page === currentPage}
                   onClick={(e) => {
                     e.preventDefault();
-                    setBoundPage(page);
-                    emit("change");
+                    setBoundValue(page);
+                    emit?.("change");
                   }}
                 >
                   {page}
@@ -1231,8 +1159,8 @@ export const { registry, executeAction } = defineRegistry(playgroundCatalog, {
                 onClick={(e) => {
                   e.preventDefault();
                   if (currentPage < props.totalPages) {
-                    setBoundPage(currentPage + 1);
-                    emit("change");
+                    setBoundValue(currentPage + 1);
+                    emit?.("change");
                   }
                 }}
               />

apps/web/lib/render/renderer.tsx

@@ -1,6 +1,6 @@
 "use client";
 
-import { useRef, useMemo, type ReactNode } from "react";
+import type { ReactNode } from "react";
 import { toast } from "sonner";
 import {
   Renderer,
@@ -8,8 +8,6 @@ import {
   StateProvider,
   VisibilityProvider,
   ActionProvider,
-  ValidationProvider,
-  useValidation,
 } from "@json-render/react";
 
 import { registry, Fallback } from "./registry";
@@ -29,44 +27,27 @@ const fallbackRenderer = (renderProps: { element: { type: string } }) => (
 );
 
 /**
- * Inner component that sits inside ValidationProvider so it can call
- * useValidation() and wire validateAll into the formSubmit action handler.
- *
- * ActionProvider stores `handlers` in useState, so it only reads the initial
- * value. We use a ref so the handlers object is stable (created once) but
- * formSubmit always reads the latest validateAll.
+ * Action handlers for the playground preview.
+ * These are passed to ActionProvider so custom actions (buttonClick, formSubmit,
+ * linkClick) work when triggered from the rendered UI.
  */
-function ValidatedActions({ children }: { children: ReactNode }) {
-  const { validateAll } = useValidation();
-  const validateAllRef = useRef(validateAll);
-  validateAllRef.current = validateAll;
-
-  const handlers = useMemo<
-    Record<string, (params: Record<string, unknown>) => void>
-  >(
-    () => ({
-      buttonClick: (params) => {
-        const message = (params?.message as string) || "Button clicked!";
-        toast.success(message);
-      },
-      formSubmit: () => {
-        const allValid = validateAllRef.current();
-        if (!allValid) {
-          toast.error("Please fix the errors before submitting.");
-          return;
-        }
-        toast.success("Form submitted successfully!");
-      },
-      linkClick: (params) => {
-        const href = (params?.href as string) || "#";
-        toast.info(`Navigating to: ${href}`);
-      },
-    }),
-    [], // stable — ref ensures latest validateAll is always used
-  );
-
-  return <ActionProvider handlers={handlers}>{children}</ActionProvider>;
-}
+const actionHandlers: Record<
+  string,
+  (params: Record<string, unknown>) => void
+> = {
+  buttonClick: (params) => {
+    const message = (params?.message as string) || "Button clicked!";
+    toast.success(message);
+  },
+  formSubmit: (params) => {
+    const formName = (params?.formName as string) || "Form";
+    toast.success(`${formName} submitted successfully!`);
+  },
+  linkClick: (params) => {
+    const href = (params?.href as string) || "#";
+    toast.info(`Navigating to: ${href}`);
+  },
+};
 
 export function PlaygroundRenderer({
   spec,
@@ -78,16 +59,14 @@ export function PlaygroundRenderer({
   return (
     <StateProvider initialState={data ?? spec.state}>
       <VisibilityProvider>
-        <ValidationProvider>
-          <ValidatedActions>
-            <Renderer
-              spec={spec}
-              registry={registry}
-              fallback={fallbackRenderer}
-              loading={loading}
-            />
-          </ValidatedActions>
-        </ValidationProvider>
+        <ActionProvider handlers={actionHandlers}>
+          <Renderer
+            spec={spec}
+            registry={registry}
+            fallback={fallbackRenderer}
+            loading={loading}
+          />
+        </ActionProvider>
       </VisibilityProvider>
     </StateProvider>
   );

apps/web/lib/spec-patch.ts

@@ -1,155 +0,0 @@
-import type { Spec, JsonPatch } from "@json-render/core";
-import { setByPath, getByPath, removeByPath } from "@json-render/core";
-
-export function setSpecValue(
-  newSpec: Spec,
-  path: string,
-  value: unknown,
-): void {
-  if (path === "/root") {
-    newSpec.root = value as string;
-    return;
-  }
-  if (path === "/state") {
-    newSpec.state = value as Record<string, unknown>;
-    return;
-  }
-  if (path.startsWith("/state/")) {
-    if (!newSpec.state) newSpec.state = {};
-    setByPath(
-      newSpec.state as Record<string, unknown>,
-      path.slice("/state".length),
-      value,
-    );
-    return;
-  }
-  if (path.startsWith("/elements/")) {
-    const pathParts = path.slice("/elements/".length).split("/");
-    const elementKey = pathParts[0];
-    if (!elementKey) return;
-    if (pathParts.length === 1) {
-      if (value == null || typeof value !== "object") return;
-      const el = value as Record<string, unknown>;
-      newSpec.elements[elementKey] = {
-        ...el,
-        type: typeof el.type === "string" ? el.type : "",
-        props: el.props != null && typeof el.props === "object" ? el.props : {},
-        children: Array.isArray(el.children) ? el.children : [],
-      } as Spec["elements"][string];
-    } else {
-      const element = newSpec.elements[elementKey];
-      if (element) {
-        const newElement = { ...element };
-        setByPath(
-          newElement as unknown as Record<string, unknown>,
-          "/" + pathParts.slice(1).join("/"),
-          value,
-        );
-        newSpec.elements[elementKey] = newElement;
-      }
-    }
-  }
-}
-
-export function removeSpecValue(newSpec: Spec, path: string): void {
-  if (path === "/state") {
-    delete newSpec.state;
-    return;
-  }
-  if (path.startsWith("/state/") && newSpec.state) {
-    removeByPath(
-      newSpec.state as Record<string, unknown>,
-      path.slice("/state".length),
-    );
-    return;
-  }
-  if (path.startsWith("/elements/")) {
-    const pathParts = path.slice("/elements/".length).split("/");
-    const elementKey = pathParts[0];
-    if (!elementKey) return;
-    if (pathParts.length === 1) {
-      delete newSpec.elements[elementKey];
-    } else {
-      const element = newSpec.elements[elementKey];
-      if (element) {
-        const newElement = { ...element };
-        removeByPath(
-          newElement as unknown as Record<string, unknown>,
-          "/" + pathParts.slice(1).join("/"),
-        );
-        newSpec.elements[elementKey] = newElement;
-      }
-    }
-  }
-}
-
-export function getSpecValue(spec: Spec, path: string): unknown {
-  if (path === "/root") return spec.root;
-  if (path === "/state") return spec.state;
-  if (path.startsWith("/state/") && spec.state) {
-    return getByPath(
-      spec.state as Record<string, unknown>,
-      path.slice("/state".length),
-    );
-  }
-  return getByPath(spec as unknown as Record<string, unknown>, path);
-}
-
-export function normalizeSpec(spec: Spec): void {
-  if (
-    spec.state === null ||
-    (spec.state !== undefined && typeof spec.state !== "object")
-  ) {
-    spec.state = undefined;
-  }
-
-  for (const key of Object.keys(spec.elements)) {
-    const el = spec.elements[key];
-    if (!el || typeof el !== "object") {
-      delete spec.elements[key];
-      continue;
-    }
-    if (el.props == null || typeof el.props !== "object") {
-      spec.elements[key] = { ...el, props: {} } as Spec["elements"][string];
-    }
-    if (!Array.isArray(spec.elements[key]!.children)) {
-      spec.elements[key] = {
-        ...spec.elements[key]!,
-        children: [],
-      } as Spec["elements"][string];
-    }
-  }
-}
-
-export function applySpecPatch(spec: Spec, patch: JsonPatch): Spec {
-  const newSpec = {
-    ...spec,
-    elements: { ...spec.elements },
-    ...(spec.state ? { state: { ...spec.state } } : {}),
-  };
-  switch (patch.op) {
-    case "add":
-    case "replace":
-      setSpecValue(newSpec, patch.path, patch.value);
-      break;
-    case "remove":
-      removeSpecValue(newSpec, patch.path);
-      break;
-    case "move":
-      if (patch.from) {
-        const moveValue = getSpecValue(newSpec, patch.from);
-        removeSpecValue(newSpec, patch.from);
-        setSpecValue(newSpec, patch.path, moveValue);
-      }
-      break;
-    case "copy":
-      if (patch.from) {
-        setSpecValue(newSpec, patch.path, getSpecValue(newSpec, patch.from));
-      }
-      break;
-    case "test":
-      break;
-  }
-  normalizeSpec(newSpec);
-  return newSpec;
-}

apps/web/lib/use-playground-stream.ts

@@ -1,482 +0,0 @@
-"use client";
-
-import { useState, useCallback, useRef, useEffect } from "react";
-import type { Spec, JsonPatch, EditMode } from "@json-render/core";
-import { deepMergeSpec, diffToPatches } from "@json-render/core";
-import { parse as yamlParse, stringify as yamlStringify } from "yaml";
-import { applyPatch as applyUnifiedDiff } from "diff";
-import {
-  createYamlStreamCompiler,
-  YAML_SPEC_FENCE,
-  YAML_EDIT_FENCE,
-  YAML_PATCH_FENCE,
-  DIFF_FENCE,
-  FENCE_CLOSE,
-} from "@json-render/yaml";
-import { applySpecPatch } from "./spec-patch";
-
-export type StreamFormat = "jsonl" | "yaml";
-
-export interface TokenUsage {
-  promptTokens: number;
-  completionTokens: number;
-  totalTokens: number;
-  cachedTokens: number;
-  cacheWriteTokens: number;
-}
-
-export interface UsePlaygroundStreamOptions {
-  api: string;
-  format: StreamFormat;
-  editModes?: EditMode[];
-  onError?: (error: Error) => void;
-  onComplete?: (spec: Spec) => void;
-}
-
-export interface UsePlaygroundStreamReturn {
-  spec: Spec | null;
-  isStreaming: boolean;
-  error: Error | null;
-  usage: TokenUsage | null;
-  rawLines: string[];
-  send: (prompt: string, context?: Record<string, unknown>) => Promise<void>;
-  clear: () => void;
-}
-
-// ── JSONL helpers ──
-
-type ParsedLine =
-  | { type: "patch"; patch: JsonPatch }
-  | { type: "usage"; usage: TokenUsage }
-  | { type: "json-edit"; mergeObj: Record<string, unknown> }
-  | null;
-
-function parseLine(line: string): ParsedLine {
-  try {
-    const trimmed = line.trim();
-    if (!trimmed || trimmed.startsWith("//")) return null;
-    const parsed = JSON.parse(trimmed);
-    if (parsed.__meta === "usage") {
-      return {
-        type: "usage",
-        usage: {
-          promptTokens: parsed.promptTokens ?? 0,
-          completionTokens: parsed.completionTokens ?? 0,
-          totalTokens: parsed.totalTokens ?? 0,
-          cachedTokens: parsed.cachedTokens ?? 0,
-          cacheWriteTokens: parsed.cacheWriteTokens ?? 0,
-        },
-      };
-    }
-    if (parsed.__json_edit === true) {
-      const mergeObj = { ...parsed };
-      delete mergeObj.__json_edit;
-      return { type: "json-edit", mergeObj };
-    }
-    return { type: "patch", patch: parsed as JsonPatch };
-  } catch {
-    return null;
-  }
-}
-
-type FenceState = "outside" | "yaml-spec" | "yaml-edit" | "yaml-patch" | "diff";
-
-// ── Hook ──
-
-export function usePlaygroundStream({
-  api,
-  format,
-  editModes,
-  onError,
-  onComplete,
-}: UsePlaygroundStreamOptions): UsePlaygroundStreamReturn {
-  const [spec, setSpec] = useState<Spec | null>(null);
-  const [isStreaming, setIsStreaming] = useState(false);
-  const [error, setError] = useState<Error | null>(null);
-  const [usage, setUsage] = useState<TokenUsage | null>(null);
-  const [rawLines, setRawLines] = useState<string[]>([]);
-  const rawLinesRef = useRef<string[]>([]);
-  const abortControllerRef = useRef<AbortController | null>(null);
-
-  const onCompleteRef = useRef(onComplete);
-  onCompleteRef.current = onComplete;
-  const onErrorRef = useRef(onError);
-  onErrorRef.current = onError;
-  const formatRef = useRef(format);
-  formatRef.current = format;
-  const editModesRef = useRef(editModes);
-  editModesRef.current = editModes;
-
-  const clear = useCallback(() => {
-    setSpec(null);
-    setError(null);
-  }, []);
-
-  const send = useCallback(
-    async (prompt: string, context?: Record<string, unknown>) => {
-      abortControllerRef.current = new AbortController();
-
-      setIsStreaming(true);
-      setError(null);
-      setUsage(null);
-      rawLinesRef.current = [];
-      setRawLines([]);
-
-      const previousSpec = context?.previousSpec as Spec | undefined;
-      let currentSpec: Spec =
-        previousSpec && previousSpec.root
-          ? { ...previousSpec, elements: { ...previousSpec.elements } }
-          : { root: "", elements: {} };
-      setSpec(currentSpec);
-
-      try {
-        const response = await fetch(api, {
-          method: "POST",
-          headers: { "Content-Type": "application/json" },
-          body: JSON.stringify({
-            prompt,
-            context,
-            format: formatRef.current,
-            editModes: editModesRef.current,
-          }),
-          signal: abortControllerRef.current.signal,
-        });
-
-        if (!response.ok) {
-          let errorMessage = `HTTP error: ${response.status}`;
-          try {
-            const errorData = await response.json();
-            if (errorData.message) errorMessage = errorData.message;
-            else if (errorData.error) errorMessage = errorData.error;
-          } catch {
-            // use default
-          }
-          throw new Error(errorMessage);
-        }
-
-        const reader = response.body?.getReader();
-        if (!reader) throw new Error("No response body");
-
-        const decoder = new TextDecoder();
-        let buffer = "";
-
-        if (formatRef.current === "yaml") {
-          // ── YAML streaming ──
-          let fenceState: FenceState = "outside";
-          const compiler = createYamlStreamCompiler<Record<string, unknown>>();
-          let yamlEditAccumulated = "";
-          let yamlPatchAccumulated = "";
-          let diffAccumulated = "";
-
-          while (true) {
-            const { done, value } = await reader.read();
-            if (done) break;
-
-            buffer += decoder.decode(value, { stream: true });
-            const lines = buffer.split("\n");
-            buffer = lines.pop() ?? "";
-
-            for (const line of lines) {
-              const trimmed = line.trim();
-
-              // Check for usage metadata (appended after stream)
-              if (trimmed.startsWith("{") && trimmed.includes('"__meta"')) {
-                try {
-                  const parsed = JSON.parse(trimmed);
-                  if (parsed.__meta === "usage") {
-                    setUsage({
-                      promptTokens: parsed.promptTokens ?? 0,
-                      completionTokens: parsed.completionTokens ?? 0,
-                      totalTokens: parsed.totalTokens ?? 0,
-                      cachedTokens: parsed.cachedTokens ?? 0,
-                      cacheWriteTokens: parsed.cacheWriteTokens ?? 0,
-                    });
-                    continue;
-                  }
-                } catch {
-                  // not JSON
-                }
-              }
-
-              rawLinesRef.current.push(line);
-
-              if (fenceState === "outside") {
-                if (
-                  trimmed === YAML_SPEC_FENCE ||
-                  trimmed.startsWith(YAML_SPEC_FENCE + " ")
-                ) {
-                  fenceState = "yaml-spec";
-                  compiler.reset();
-                } else if (
-                  trimmed === YAML_EDIT_FENCE ||
-                  trimmed.startsWith(YAML_EDIT_FENCE + " ")
-                ) {
-                  fenceState = "yaml-edit";
-                  yamlEditAccumulated = "";
-                } else if (
-                  trimmed === YAML_PATCH_FENCE ||
-                  trimmed.startsWith(YAML_PATCH_FENCE + " ")
-                ) {
-                  fenceState = "yaml-patch";
-                  yamlPatchAccumulated = "";
-                } else if (
-                  trimmed === DIFF_FENCE ||
-                  trimmed.startsWith(DIFF_FENCE + " ")
-                ) {
-                  fenceState = "diff";
-                  diffAccumulated = "";
-                }
-              } else if (trimmed === FENCE_CLOSE || trimmed === "````") {
-                if (fenceState === "yaml-spec") {
-                  const { result, newPatches } = compiler.flush();
-                  if (result && typeof result === "object" && result.root) {
-                    for (const patch of newPatches) {
-                      currentSpec = applySpecPatch(currentSpec, patch);
-                    }
-                    setSpec({ ...currentSpec });
-                  }
-                } else if (fenceState === "yaml-edit") {
-                  try {
-                    const editObj = yamlParse(yamlEditAccumulated);
-                    if (editObj && typeof editObj === "object") {
-                      const merged = deepMergeSpec(
-                        currentSpec as unknown as Record<string, unknown>,
-                        editObj as Record<string, unknown>,
-                      );
-                      const patches = diffToPatches(
-                        currentSpec as unknown as Record<string, unknown>,
-                        merged,
-                      );
-                      for (const patch of patches) {
-                        currentSpec = applySpecPatch(currentSpec, patch);
-                      }
-                      setSpec({ ...currentSpec });
-                    }
-                  } catch {
-                    // Invalid YAML edit
-                  }
-                } else if (fenceState === "yaml-patch") {
-                  for (const patchLine of yamlPatchAccumulated.split("\n")) {
-                    const t = patchLine.trim();
-                    if (!t) continue;
-                    try {
-                      const patch = JSON.parse(t) as JsonPatch;
-                      if (patch.op) {
-                        currentSpec = applySpecPatch(currentSpec, patch);
-                      }
-                    } catch {
-                      // Skip invalid JSON lines
-                    }
-                  }
-                  setSpec({ ...currentSpec });
-                } else if (fenceState === "diff") {
-                  try {
-                    const specYaml = yamlStringify(currentSpec, { indent: 2 });
-                    const patched = applyUnifiedDiff(specYaml, diffAccumulated);
-                    if (typeof patched === "string") {
-                      const parsed = yamlParse(patched);
-                      if (parsed && typeof parsed === "object") {
-                        const patches = diffToPatches(
-                          currentSpec as unknown as Record<string, unknown>,
-                          parsed as Record<string, unknown>,
-                        );
-                        for (const patch of patches) {
-                          currentSpec = applySpecPatch(currentSpec, patch);
-                        }
-                        setSpec({ ...currentSpec });
-                      }
-                    }
-                  } catch {
-                    // Diff apply or reparse failed
-                  }
-                }
-                fenceState = "outside";
-              } else if (fenceState === "yaml-spec") {
-                const { newPatches } = compiler.push(line + "\n");
-                if (newPatches.length > 0) {
-                  for (const patch of newPatches) {
-                    currentSpec = applySpecPatch(currentSpec, patch);
-                  }
-                  setSpec({ ...currentSpec });
-                }
-              } else if (fenceState === "yaml-edit") {
-                yamlEditAccumulated += line + "\n";
-              } else if (fenceState === "yaml-patch") {
-                yamlPatchAccumulated += line + "\n";
-              } else if (fenceState === "diff") {
-                diffAccumulated += line + "\n";
-              }
-            }
-            setRawLines([...rawLinesRef.current]);
-          }
-
-          // Process remaining buffer
-          if (buffer.trim()) {
-            const trimmed = buffer.trim();
-            if (trimmed.startsWith("{") && trimmed.includes('"__meta"')) {
-              try {
-                const parsed = JSON.parse(trimmed);
-                if (parsed.__meta === "usage") {
-                  setUsage({
-                    promptTokens: parsed.promptTokens ?? 0,
-                    completionTokens: parsed.completionTokens ?? 0,
-                    totalTokens: parsed.totalTokens ?? 0,
-                    cachedTokens: parsed.cachedTokens ?? 0,
-                    cacheWriteTokens: parsed.cacheWriteTokens ?? 0,
-                  });
-                }
-              } catch {
-                // not JSON
-              }
-            } else if (fenceState === "yaml-spec") {
-              compiler.push(buffer);
-              const { result, newPatches } = compiler.flush();
-              if (result && typeof result === "object" && result.root) {
-                for (const patch of newPatches) {
-                  currentSpec = applySpecPatch(currentSpec, patch);
-                }
-                setSpec({ ...currentSpec });
-              }
-            }
-          }
-        } else {
-          // ── JSONL streaming ──
-          let jsonlDiffState: "outside" | "diff" = "outside";
-          let jsonlDiffAccumulated = "";
-
-          while (true) {
-            const { done, value } = await reader.read();
-            if (done) break;
-
-            buffer += decoder.decode(value, { stream: true });
-            const lines = buffer.split("\n");
-            buffer = lines.pop() ?? "";
-
-            for (const line of lines) {
-              const trimmed = line.trim();
-              if (!trimmed) continue;
-
-              // Diff fence detection within JSONL mode
-              if (jsonlDiffState === "outside") {
-                if (
-                  trimmed === DIFF_FENCE ||
-                  trimmed.startsWith(DIFF_FENCE + " ")
-                ) {
-                  jsonlDiffState = "diff";
-                  jsonlDiffAccumulated = "";
-                  continue;
-                }
-              } else if (
-                jsonlDiffState === "diff" &&
-                (trimmed === FENCE_CLOSE || trimmed === "````")
-              ) {
-                try {
-                  const specJson = JSON.stringify(currentSpec, null, 2);
-                  const patched = applyUnifiedDiff(
-                    specJson,
-                    jsonlDiffAccumulated,
-                  );
-                  if (typeof patched === "string") {
-                    const parsed = JSON.parse(patched);
-                    if (parsed && typeof parsed === "object") {
-                      const patches = diffToPatches(
-                        currentSpec as unknown as Record<string, unknown>,
-                        parsed as Record<string, unknown>,
-                      );
-                      for (const patch of patches) {
-                        currentSpec = applySpecPatch(currentSpec, patch);
-                      }
-                      setSpec({ ...currentSpec });
-                    }
-                  }
-                } catch {
-                  // Diff apply failed
-                }
-                jsonlDiffState = "outside";
-                continue;
-              }
-
-              if (jsonlDiffState === "diff") {
-                jsonlDiffAccumulated += line + "\n";
-                rawLinesRef.current.push(line);
-                continue;
-              }
-
-              // Standard JSONL line parsing
-              const result = parseLine(trimmed);
-              if (!result) continue;
-              if (result.type === "usage") {
-                setUsage(result.usage);
-              } else if (result.type === "json-edit") {
-                const merged = deepMergeSpec(
-                  currentSpec as unknown as Record<string, unknown>,
-                  result.mergeObj,
-                );
-                const patches = diffToPatches(
-                  currentSpec as unknown as Record<string, unknown>,
-                  merged,
-                );
-                for (const patch of patches) {
-                  currentSpec = applySpecPatch(currentSpec, patch);
-                }
-                rawLinesRef.current.push(trimmed);
-                setSpec({ ...currentSpec });
-              } else {
-                rawLinesRef.current.push(trimmed);
-                currentSpec = applySpecPatch(currentSpec, result.patch);
-                setSpec({ ...currentSpec });
-              }
-            }
-            setRawLines([...rawLinesRef.current]);
-          }
-
-          if (buffer.trim()) {
-            const trimmed = buffer.trim();
-            const result = parseLine(trimmed);
-            if (result) {
-              if (result.type === "usage") {
-                setUsage(result.usage);
-              } else if (result.type === "json-edit") {
-                const merged = deepMergeSpec(
-                  currentSpec as unknown as Record<string, unknown>,
-                  result.mergeObj,
-                );
-                const patches = diffToPatches(
-                  currentSpec as unknown as Record<string, unknown>,
-                  merged,
-                );
-                for (const patch of patches) {
-                  currentSpec = applySpecPatch(currentSpec, patch);
-                }
-                rawLinesRef.current.push(trimmed);
-                setSpec({ ...currentSpec });
-              } else {
-                rawLinesRef.current.push(trimmed);
-                currentSpec = applySpecPatch(currentSpec, result.patch);
-                setSpec({ ...currentSpec });
-              }
-            }
-          }
-        }
-
-        onCompleteRef.current?.(currentSpec);
-      } catch (err) {
-        if ((err as Error).name === "AbortError") return;
-        const error = err instanceof Error ? err : new Error(String(err));
-        setError(error);
-        onErrorRef.current?.(error);
-      } finally {
-        setIsStreaming(false);
-      }
-    },
-    [api],
-  );
-
-  useEffect(() => {
-    return () => {
-      abortControllerRef.current?.abort();
-    };
-  }, []);
-
-  return { spec, isStreaming, error, usage, rawLines, send, clear };
-}

apps/web/mdx-components.tsx

@@ -1,7 +1,6 @@
 import type { MDXComponents } from "mdx/types";
 import Link from "next/link";
 import { Code } from "@/components/code";
-import { GenerationModesDiagram } from "@/components/generation-modes-diagram";
 import { PackageInstall } from "@/components/package-install";
 
 function slugify(text: string): string {
@@ -131,9 +130,7 @@ export function useMDXComponents(components: MDXComponents): MDXComponents {
     ),
     table: ({ children }: { children?: React.ReactNode }) => (
       <div className="my-6 overflow-x-auto">
-        <table className="mdx-table w-full text-sm border-collapse">
-          {children}
-        </table>
+        <table className="w-full text-sm border-collapse">{children}</table>
       </div>
     ),
     th: ({ children }: { children?: React.ReactNode }) => (
@@ -148,7 +145,6 @@ export function useMDXComponents(components: MDXComponents): MDXComponents {
     ),
     em: ({ children }: { children?: React.ReactNode }) => <em>{children}</em>,
     // Custom components available in all MDX files
-    GenerationModesDiagram,
     PackageInstall,
   };
 }

apps/web/next.config.js

@@ -11,17 +11,10 @@ const nextConfig = {
         destination: "/docs/registry",
         permanent: true,
       },
-      {
-        source: "/docs/actions",
-        destination: "/docs/registry#action-handlers",
-        permanent: true,
-      },
     ];
   },
 };
 
 const withMDX = createMDX({});
 
-/** @type {import('next').NextConfig} */
-const config = withMDX(nextConfig);
-export default config;
+export default withMDX(nextConfig);

apps/web/package.json

@@ -1,12 +1,11 @@
 {
   "name": "web",
-  "version": "0.1.9",
+  "version": "0.1.0",
   "type": "module",
   "private": true,
   "license": "Apache-2.0",
   "scripts": {
-    "predev": "command -v portless >/dev/null 2>&1 || (echo '\\nportless is required but not installed. Run: npm i -g portless\\nSee: https://github.com/vercel-labs/portless\\n' && exit 1)",
-    "dev": "portless json-render next dev --turbopack",
+    "dev": "next dev --turbopack",
     "build": "next build",
     "start": "next start",
     "lint": "eslint --max-warnings 0",
@@ -18,7 +17,6 @@
     "@json-render/codegen": "workspace:*",
     "@json-render/core": "workspace:*",
     "@json-render/react": "workspace:*",
-    "@json-render/yaml": "workspace:*",
     "@mdx-js/loader": "^3.1.1",
     "@mdx-js/mdx": "^3.1.1",
     "@mdx-js/react": "^3.1.1",
@@ -30,14 +28,12 @@
     "@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",
-    "diff": "^8.0.3",
     "embla-carousel-react": "^8.6.0",
-    "geist": "1.7.0",
+    "just-bash": "2.9.6",
     "lucide-react": "^0.562.0",
     "next": "16.1.1",
     "next-themes": "^0.4.6",
@@ -45,19 +41,16 @@
     "react": "19.2.3",
     "react-dom": "19.2.3",
     "react-resizable-panels": "^4.4.1",
-    "remark-gfm": "4.0.1",
     "shiki": "^3.21.0",
     "sonner": "^2.0.7",
     "streamdown": "2.1.0",
     "tailwind-merge": "^3.4.0",
-    "unist-util-visit": "5.1.0",
     "vaul": "^1.1.2",
-    "yaml": "^2.8.2",
-    "zod": "^4.3.6"
+    "zod": "^4.0.0"
   },
   "devDependencies": {
-    "@internal/eslint-config": "workspace:*",
-    "@internal/typescript-config": "workspace:*",
+    "@repo/eslint-config": "workspace:*",
+    "@repo/typescript-config": "workspace:*",
     "@tailwindcss/postcss": "^4.1.18",
     "@types/mdx": "^2.0.13",
     "@types/node": "^22.15.3",

apps/web/tsconfig.json

@@ -1,5 +1,5 @@
 {
-  "extends": "@internal/typescript-config/nextjs.json",
+  "extends": "@repo/typescript-config/nextjs.json",
   "compilerOptions": {
     "plugins": [
       {

examples/chat/CHANGELOG.md

@@ -1,82 +0,0 @@
-# example-chat
-
-## 0.1.9
-
-### Patch Changes
-
-- Updated dependencies [43b7515]
-  - @json-render/core@0.14.1
-  - @json-render/react@0.14.1
-  - @json-render/shadcn@0.14.1
-
-## 0.1.8
-
-### Patch Changes
-
-- Updated dependencies [a8afd8b]
-  - @json-render/core@0.14.0
-  - @json-render/react@0.14.0
-  - @json-render/shadcn@0.14.0
-
-## 0.1.7
-
-### Patch Changes
-
-- Updated dependencies [5b32de8]
-  - @json-render/core@0.13.0
-  - @json-render/react@0.13.0
-  - @json-render/shadcn@0.13.0
-
-## 0.1.6
-
-### Patch Changes
-
-- Updated dependencies [54a1ecf]
-  - @json-render/core@0.12.1
-  - @json-render/react@0.12.1
-  - @json-render/shadcn@0.12.1
-
-## 0.1.5
-
-### Patch Changes
-
-- Updated dependencies [63c339b]
-  - @json-render/core@0.12.0
-  - @json-render/react@0.12.0
-  - @json-render/shadcn@0.12.0
-
-## 0.1.4
-
-### Patch Changes
-
-- Updated dependencies [3f1e71e]
-  - @json-render/core@0.11.0
-  - @json-render/react@0.11.0
-  - @json-render/shadcn@0.11.0
-
-## 0.1.3
-
-### Patch Changes
-
-- Updated dependencies [9cef4e9]
-  - @json-render/core@0.10.0
-  - @json-render/react@0.10.0
-  - @json-render/shadcn@0.10.0
-
-## 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

examples/chat/app/api/generate/route.ts

@@ -1,36 +0,0 @@
-import { agent } from "@/lib/agent";
-import {
-  convertToModelMessages,
-  createUIMessageStream,
-  createUIMessageStreamResponse,
-  type UIMessage,
-} from "ai";
-import { pipeJsonRender } from "@json-render/core";
-
-export const maxDuration = 60;
-
-export async function POST(req: Request) {
-  const body = await req.json();
-  const uiMessages: UIMessage[] = body.messages;
-
-  if (!uiMessages || !Array.isArray(uiMessages) || uiMessages.length === 0) {
-    return new Response(
-      JSON.stringify({ error: "messages array is required" }),
-      {
-        status: 400,
-        headers: { "Content-Type": "application/json" },
-      },
-    );
-  }
-
-  const modelMessages = await convertToModelMessages(uiMessages);
-  const result = await agent.stream({ messages: modelMessages });
-
-  const stream = createUIMessageStream({
-    execute: async ({ writer }) => {
-      writer.merge(pipeJsonRender(result.toUIMessageStream()));
-    },
-  });
-
-  return createUIMessageStreamResponse({ stream });
-}

examples/chat/app/globals.css

@@ -1,128 +0,0 @@
-@import "tailwindcss";
-@import "tw-animate-css";
-
-@source "../../../node_modules/streamdown/dist/*.js";
-
-@custom-variant dark (&:is(.dark *));
-
-@theme inline {
-  --radius-sm: calc(var(--radius) - 4px);
-  --radius-md: calc(var(--radius) - 2px);
-  --radius-lg: var(--radius);
-  --radius-xl: calc(var(--radius) + 4px);
-  --radius-2xl: calc(var(--radius) + 8px);
-  --radius-3xl: calc(var(--radius) + 12px);
-  --radius-4xl: calc(var(--radius) + 16px);
-  --color-background: var(--background);
-  --color-foreground: var(--foreground);
-  --color-card: var(--card);
-  --color-card-foreground: var(--card-foreground);
-  --color-popover: var(--popover);
-  --color-popover-foreground: var(--popover-foreground);
-  --color-primary: var(--primary);
-  --color-primary-foreground: var(--primary-foreground);
-  --color-secondary: var(--secondary);
-  --color-secondary-foreground: var(--secondary-foreground);
-  --color-muted: var(--muted);
-  --color-muted-foreground: var(--muted-foreground);
-  --color-accent: var(--accent);
-  --color-accent-foreground: var(--accent-foreground);
-  --color-destructive: var(--destructive);
-  --color-border: var(--border);
-  --color-input: var(--input);
-  --color-ring: var(--ring);
-  --color-chart-1: var(--chart-1);
-  --color-chart-2: var(--chart-2);
-  --color-chart-3: var(--chart-3);
-  --color-chart-4: var(--chart-4);
-  --color-chart-5: var(--chart-5);
-}
-
-:root {
-  --radius: 0.625rem;
-  --background: oklch(1 0 0);
-  --foreground: oklch(0.145 0 0);
-  --card: oklch(1 0 0);
-  --card-foreground: oklch(0.145 0 0);
-  --popover: oklch(1 0 0);
-  --popover-foreground: oklch(0.145 0 0);
-  --primary: oklch(0.205 0 0);
-  --primary-foreground: oklch(0.985 0 0);
-  --secondary: oklch(0.97 0 0);
-  --secondary-foreground: oklch(0.205 0 0);
-  --muted: oklch(0.97 0 0);
-  --muted-foreground: oklch(0.556 0 0);
-  --accent: oklch(0.97 0 0);
-  --accent-foreground: oklch(0.205 0 0);
-  --destructive: oklch(0.577 0.245 27.325);
-  --border: oklch(0.922 0 0);
-  --input: oklch(0.922 0 0);
-  --ring: oklch(0.708 0 0);
-  --chart-1: oklch(0.646 0.222 41.116);
-  --chart-2: oklch(0.6 0.118 184.704);
-  --chart-3: oklch(0.398 0.07 227.392);
-  --chart-4: oklch(0.828 0.189 84.429);
-  --chart-5: oklch(0.769 0.188 70.08);
-}
-
-.dark {
-  --background: oklch(0.145 0 0);
-  --foreground: oklch(0.985 0 0);
-  --card: oklch(0.205 0 0);
-  --card-foreground: oklch(0.985 0 0);
-  --popover: oklch(0.205 0 0);
-  --popover-foreground: oklch(0.985 0 0);
-  --primary: oklch(0.922 0 0);
-  --primary-foreground: oklch(0.205 0 0);
-  --secondary: oklch(0.269 0 0);
-  --secondary-foreground: oklch(0.985 0 0);
-  --muted: oklch(0.269 0 0);
-  --muted-foreground: oklch(0.708 0 0);
-  --accent: oklch(0.269 0 0);
-  --accent-foreground: oklch(0.985 0 0);
-  --destructive: oklch(0.704 0.191 22.216);
-  --border: oklch(1 0 0 / 10%);
-  --input: oklch(1 0 0 / 15%);
-  --ring: oklch(0.556 0 0);
-  --chart-1: oklch(0.488 0.243 264.376);
-  --chart-2: oklch(0.696 0.17 162.48);
-  --chart-3: oklch(0.769 0.188 70.08);
-  --chart-4: oklch(0.627 0.265 303.9);
-  --chart-5: oklch(0.645 0.246 16.439);
-}
-
-@layer base {
-  * {
-    @apply border-border outline-ring/50;
-  }
-  body {
-    @apply bg-background text-foreground;
-  }
-}
-
-button {
-  cursor: pointer;
-}
-
-@keyframes shimmer {
-  0% {
-    background-position: -200% 0;
-  }
-  100% {
-    background-position: 200% 0;
-  }
-}
-
-.animate-shimmer {
-  background: linear-gradient(
-    90deg,
-    currentColor 25%,
-    hsl(0 0% 64%) 50%,
-    currentColor 75%
-  );
-  background-size: 200% 100%;
-  -webkit-background-clip: text;
-  background-clip: text;
-  -webkit-text-fill-color: transparent;
-  animation: shimmer 2s ease-in-out infinite;
-}

examples/chat/app/layout.tsx

@@ -1,40 +0,0 @@
-import type { Metadata } from "next";
-import { Geist, Geist_Mono } from "next/font/google";
-import { Toaster } from "sonner";
-import { ThemeProvider } from "@/components/theme-provider";
-import "streamdown/styles.css";
-import "./globals.css";
-
-const geistSans = Geist({
-  variable: "--font-geist-sans",
-  subsets: ["latin"],
-});
-
-const geistMono = Geist_Mono({
-  variable: "--font-geist-mono",
-  subsets: ["latin"],
-});
-
-export const metadata: Metadata = {
-  title: "json-render Chat Example",
-  description: "AI-powered data explorer using ToolLoopAgent and json-render",
-};
-
-export default function RootLayout({
-  children,
-}: {
-  children: React.ReactNode;
-}) {
-  return (
-    <html lang="en" suppressHydrationWarning>
-      <body
-        className={`${geistSans.variable} ${geistMono.variable} font-sans antialiased`}
-      >
-        <ThemeProvider>
-          {children}
-          <Toaster />
-        </ThemeProvider>
-      </body>
-    </html>
-  );
-}

examples/chat/app/page.tsx

@@ -1,493 +0,0 @@
-"use client";
-
-import { useState, useCallback, useRef, useEffect } from "react";
-import { useChat } from "@ai-sdk/react";
-import { DefaultChatTransport, type UIMessage } from "ai";
-import {
-  SPEC_DATA_PART,
-  SPEC_DATA_PART_TYPE,
-  type SpecDataPart,
-} from "@json-render/core";
-import { useJsonRenderMessage } from "@json-render/react";
-import { ExplorerRenderer } from "@/lib/render/renderer";
-import { ThemeToggle } from "@/components/theme-toggle";
-import {
-  ArrowDown,
-  ArrowUp,
-  ChevronRight,
-  Loader2,
-  Sparkles,
-} from "lucide-react";
-import { Streamdown } from "streamdown";
-import { code } from "@streamdown/code";
-
-// =============================================================================
-// Types
-// =============================================================================
-
-type AppDataParts = { [SPEC_DATA_PART]: SpecDataPart };
-type AppMessage = UIMessage<unknown, AppDataParts>;
-
-// =============================================================================
-// Transport
-// =============================================================================
-
-const transport = new DefaultChatTransport({ api: "/api/generate" });
-
-// =============================================================================
-// Suggestions (shown in empty state)
-// =============================================================================
-
-const SUGGESTIONS = [
-  {
-    label: "Weather comparison",
-    prompt: "Compare the weather in New York, London, and Tokyo",
-  },
-  {
-    label: "GitHub repo stats",
-    prompt: "Show me stats for the vercel/next.js and vercel/ai GitHub repos",
-  },
-  {
-    label: "Crypto dashboard",
-    prompt: "Build a crypto dashboard for Bitcoin, Ethereum, and Solana",
-  },
-  {
-    label: "Hacker News top stories",
-    prompt: "Show me the top 15 Hacker News stories right now",
-  },
-];
-
-// =============================================================================
-// Tool Call Display
-// =============================================================================
-
-/** Readable labels for tool names: [loading, done] */
-const TOOL_LABELS: Record<string, [string, string]> = {
-  getWeather: ["Getting weather data", "Got weather data"],
-  getGitHubRepo: ["Fetching GitHub repo", "Fetched GitHub repo"],
-  getGitHubPullRequests: ["Fetching pull requests", "Fetched pull requests"],
-  getCryptoPrice: ["Looking up crypto price", "Looked up crypto price"],
-  getCryptoPriceHistory: ["Fetching price history", "Fetched price history"],
-  getHackerNewsTop: ["Loading Hacker News", "Loaded Hacker News"],
-  webSearch: ["Searching the web", "Searched the web"],
-};
-
-function ToolCallDisplay({
-  toolName,
-  state,
-  result,
-}: {
-  toolName: string;
-  state: string;
-  result: unknown;
-}) {
-  const [expanded, setExpanded] = useState(false);
-  const isLoading =
-    state !== "output-available" &&
-    state !== "output-error" &&
-    state !== "output-denied";
-  const labels = TOOL_LABELS[toolName];
-  const label = labels ? (isLoading ? labels[0] : labels[1]) : toolName;
-
-  return (
-    <div className="text-sm group">
-      <button
-        type="button"
-        className="flex items-center gap-1.5"
-        onClick={() => setExpanded((e) => !e)}
-      >
-        <span
-          className={`text-muted-foreground ${isLoading ? "animate-shimmer" : ""}`}
-        >
-          {label}
-        </span>
-        {!isLoading && (
-          <ChevronRight
-            className={`h-3 w-3 text-muted-foreground/0 group-hover:text-muted-foreground transition-all ${expanded ? "rotate-90" : ""}`}
-          />
-        )}
-      </button>
-      {expanded && !isLoading && result != null && (
-        <div className="mt-1 max-h-64 overflow-auto">
-          <pre className="text-xs text-muted-foreground whitespace-pre-wrap break-all">
-            {typeof result === "string"
-              ? result
-              : JSON.stringify(result, null, 2)}
-          </pre>
-        </div>
-      )}
-    </div>
-  );
-}
-
-// =============================================================================
-// Message Bubble
-// =============================================================================
-
-function MessageBubble({
-  message,
-  isLast,
-  isStreaming,
-}: {
-  message: AppMessage;
-  isLast: boolean;
-  isStreaming: boolean;
-}) {
-  const isUser = message.role === "user";
-  const { spec, text, hasSpec } = useJsonRenderMessage(message.parts);
-
-  // Build ordered segments from parts, collapsing adjacent text and adjacent tools.
-  // Spec data parts are tracked so the rendered UI appears inline where the AI
-  // placed it rather than always at the bottom.
-  const segments: Array<
-    | { kind: "text"; text: string }
-    | {
-        kind: "tools";
-        tools: Array<{
-          toolCallId: string;
-          toolName: string;
-          state: string;
-          output?: unknown;
-        }>;
-      }
-    | { kind: "spec" }
-  > = [];
-
-  let specInserted = false;
-
-  for (const part of message.parts) {
-    if (part.type === "text") {
-      if (!part.text.trim()) continue;
-      const last = segments[segments.length - 1];
-      if (last?.kind === "text") {
-        last.text += part.text;
-      } else {
-        segments.push({ kind: "text", text: part.text });
-      }
-    } else if (part.type.startsWith("tool-")) {
-      const tp = part as {
-        type: string;
-        toolCallId: string;
-        state: string;
-        output?: unknown;
-      };
-      const last = segments[segments.length - 1];
-      if (last?.kind === "tools") {
-        last.tools.push({
-          toolCallId: tp.toolCallId,
-          toolName: tp.type.replace(/^tool-/, ""),
-          state: tp.state,
-          output: tp.output,
-        });
-      } else {
-        segments.push({
-          kind: "tools",
-          tools: [
-            {
-              toolCallId: tp.toolCallId,
-              toolName: tp.type.replace(/^tool-/, ""),
-              state: tp.state,
-              output: tp.output,
-            },
-          ],
-        });
-      }
-    } else if (part.type === SPEC_DATA_PART_TYPE && !specInserted) {
-      // First spec data part — mark where the rendered UI should appear
-      segments.push({ kind: "spec" });
-      specInserted = true;
-    }
-  }
-
-  const hasAnything = segments.length > 0 || hasSpec;
-  const showLoader =
-    isLast && isStreaming && message.role === "assistant" && !hasAnything;
-
-  if (isUser) {
-    return (
-      <div className="flex justify-end">
-        {text && (
-          <div className="max-w-[85%] rounded-2xl px-4 py-2.5 text-sm leading-relaxed whitespace-pre-wrap bg-primary text-primary-foreground rounded-tr-md">
-            {text}
-          </div>
-        )}
-      </div>
-    );
-  }
-
-  // If there's a spec but no spec segment was inserted (edge case),
-  // append it so it still renders.
-  const specRenderedInline = specInserted;
-  const showSpecAtEnd = hasSpec && !specRenderedInline;
-
-  return (
-    <div className="w-full flex flex-col gap-3">
-      {segments.map((seg, i) => {
-        if (seg.kind === "text") {
-          const isLastSegment = i === segments.length - 1;
-          return (
-            <div
-              key={`text-${i}`}
-              className="text-sm leading-relaxed [&_p+p]:mt-3 [&_ul]:mt-2 [&_ol]:mt-2 [&_pre]:mt-2"
-            >
-              <Streamdown
-                plugins={{ code }}
-                animated={isLast && isStreaming && isLastSegment}
-              >
-                {seg.text}
-              </Streamdown>
-            </div>
-          );
-        }
-        if (seg.kind === "spec") {
-          if (!hasSpec) return null;
-          return (
-            <div key="spec" className="w-full">
-              <ExplorerRenderer spec={spec} loading={isLast && isStreaming} />
-            </div>
-          );
-        }
-        return (
-          <div key={`tools-${i}`} className="flex flex-col gap-1">
-            {seg.tools.map((t) => (
-              <ToolCallDisplay
-                key={t.toolCallId}
-                toolName={t.toolName}
-                state={t.state}
-                result={t.output}
-              />
-            ))}
-          </div>
-        );
-      })}
-
-      {/* Loading indicator */}
-      {showLoader && (
-        <div className="text-sm text-muted-foreground animate-shimmer">
-          Thinking...
-        </div>
-      )}
-
-      {/* Fallback: render spec at end if no inline position was found */}
-      {showSpecAtEnd && (
-        <div className="w-full">
-          <ExplorerRenderer spec={spec} loading={isLast && isStreaming} />
-        </div>
-      )}
-    </div>
-  );
-}
-
-// =============================================================================
-// Page
-// =============================================================================
-
-export default function ChatPage() {
-  const [input, setInput] = useState("");
-  const messagesEndRef = useRef<HTMLDivElement>(null);
-  const scrollContainerRef = useRef<HTMLElement>(null);
-  const [showScrollButton, setShowScrollButton] = useState(false);
-  const isStickToBottom = useRef(true);
-  const isAutoScrolling = useRef(false);
-  const inputRef = useRef<HTMLTextAreaElement>(null);
-
-  const { messages, sendMessage, setMessages, status, error } =
-    useChat<AppMessage>({ transport });
-
-  const isStreaming = status === "streaming" || status === "submitted";
-
-  // Track whether the user has scrolled away from the bottom.
-  // During programmatic scrolling, suppress button updates until we arrive.
-  useEffect(() => {
-    const container = scrollContainerRef.current;
-    if (!container) return;
-    const THRESHOLD = 80;
-    const handleScroll = () => {
-      const { scrollTop, scrollHeight, clientHeight } = container;
-      const atBottom = scrollTop + clientHeight >= scrollHeight - THRESHOLD;
-
-      if (isAutoScrolling.current) {
-        // Wait for the programmatic scroll to reach the bottom before
-        // handing control back to the user-scroll tracker.
-        if (atBottom) {
-          isAutoScrolling.current = false;
-        }
-        return;
-      }
-
-      isStickToBottom.current = atBottom;
-      setShowScrollButton(!atBottom);
-    };
-    container.addEventListener("scroll", handleScroll, { passive: true });
-    return () => container.removeEventListener("scroll", handleScroll);
-  }, []);
-
-  // Auto-scroll to bottom on new messages, unless user scrolled up.
-  // Uses instant scrollTop assignment (no smooth animation) to avoid
-  // an ongoing animation that fights user scroll input.
-  useEffect(() => {
-    const container = scrollContainerRef.current;
-    if (!container || !isStickToBottom.current) return;
-    isAutoScrolling.current = true;
-    container.scrollTop = container.scrollHeight;
-    requestAnimationFrame(() => {
-      isAutoScrolling.current = false;
-    });
-  }, [messages, isStreaming]);
-
-  const scrollToBottom = useCallback(() => {
-    const container = scrollContainerRef.current;
-    if (!container) return;
-    isStickToBottom.current = true;
-    setShowScrollButton(false);
-    isAutoScrolling.current = true;
-    container.scrollTo({ top: container.scrollHeight, behavior: "smooth" });
-    // isAutoScrolling is cleared by the scroll handler once it reaches bottom
-  }, []);
-
-  const handleSubmit = useCallback(
-    async (text?: string) => {
-      const message = text || input;
-      if (!message.trim() || isStreaming) return;
-      setInput("");
-      await sendMessage({ text: message.trim() });
-    },
-    [input, isStreaming, sendMessage],
-  );
-
-  const handleKeyDown = useCallback(
-    (e: React.KeyboardEvent) => {
-      if (e.key === "Enter" && !e.shiftKey) {
-        e.preventDefault();
-        handleSubmit();
-      }
-    },
-    [handleSubmit],
-  );
-
-  const handleClear = useCallback(() => {
-    setMessages([]);
-    setInput("");
-    inputRef.current?.focus();
-  }, [setMessages]);
-
-  const isEmpty = messages.length === 0;
-
-  return (
-    <div className="h-screen flex flex-col overflow-hidden">
-      {/* Header */}
-      <header className="border-b px-6 py-3 flex items-center justify-between flex-shrink-0">
-        <div className="flex items-center gap-3">
-          <h1 className="text-lg font-semibold">json-render Chat Example</h1>
-        </div>
-        <div className="flex items-center gap-2">
-          {messages.length > 0 && (
-            <button
-              onClick={handleClear}
-              className="px-3 py-1.5 rounded-md text-sm text-muted-foreground hover:text-foreground hover:bg-accent transition-colors"
-            >
-              Start Over
-            </button>
-          )}
-          <ThemeToggle />
-        </div>
-      </header>
-
-      {/* Messages area */}
-      <main ref={scrollContainerRef} className="flex-1 overflow-auto">
-        {isEmpty ? (
-          /* Empty state */
-          <div className="h-full flex flex-col items-center justify-center px-6 py-12">
-            <div className="max-w-2xl w-full space-y-8">
-              <div className="text-center space-y-2">
-                <h2 className="text-2xl font-semibold tracking-tight">
-                  What would you like to explore?
-                </h2>
-                <p className="text-muted-foreground">
-                  Ask about weather, GitHub repos, crypto prices, or Hacker News
-                  -- the agent will fetch real data and build a dashboard.
-                </p>
-              </div>
-
-              {/* Suggestions */}
-              <div className="flex flex-wrap gap-2 justify-center">
-                {SUGGESTIONS.map((s) => (
-                  <button
-                    key={s.label}
-                    onClick={() => handleSubmit(s.prompt)}
-                    className="inline-flex items-center gap-1.5 px-3 py-1.5 rounded-full border border-border text-sm text-muted-foreground hover:text-foreground hover:bg-accent transition-colors"
-                  >
-                    <Sparkles className="h-3 w-3" />
-                    {s.label}
-                  </button>
-                ))}
-              </div>
-            </div>
-          </div>
-        ) : (
-          /* Message thread */
-          <div className="max-w-4xl mx-auto px-10 py-6 space-y-6">
-            {messages.map((message, index) => (
-              <MessageBubble
-                key={message.id}
-                message={message}
-                isLast={index === messages.length - 1}
-                isStreaming={isStreaming}
-              />
-            ))}
-
-            {/* Error display */}
-            {error && (
-              <div className="rounded-lg border border-destructive/50 bg-destructive/10 px-4 py-3 text-sm text-destructive">
-                {error.message}
-              </div>
-            )}
-
-            <div ref={messagesEndRef} />
-          </div>
-        )}
-      </main>
-
-      {/* Input bar - always visible at bottom */}
-      <div className="px-6 pb-3 flex-shrink-0 bg-background relative">
-        {/* Scroll to bottom button */}
-        {showScrollButton && !isEmpty && (
-          <button
-            onClick={scrollToBottom}
-            className="absolute left-1/2 -translate-x-1/2 -top-10 z-10 h-8 w-8 rounded-full border border-border bg-background text-muted-foreground shadow-md flex items-center justify-center hover:text-foreground hover:bg-accent transition-colors"
-            aria-label="Scroll to bottom"
-          >
-            <ArrowDown className="h-4 w-4" />
-          </button>
-        )}
-        <div className="max-w-4xl mx-auto relative">
-          <textarea
-            ref={inputRef}
-            value={input}
-            onChange={(e) => setInput(e.target.value)}
-            onKeyDown={handleKeyDown}
-            placeholder={
-              isEmpty
-                ? "e.g., Compare weather in NYC, London, and Tokyo..."
-                : "Ask a follow-up..."
-            }
-            rows={2}
-            className="w-full resize-none rounded-xl border border-input bg-card px-4 py-3 pr-12 text-sm shadow-sm placeholder:text-muted-foreground focus-visible:outline-none focus-visible:ring-1 focus-visible:ring-ring"
-            autoFocus
-          />
-          <button
-            onClick={() => handleSubmit()}
-            disabled={!input.trim() || isStreaming}
-            className="absolute right-3 bottom-3 h-8 w-8 rounded-lg bg-primary text-primary-foreground flex items-center justify-center hover:bg-primary/90 disabled:opacity-50 disabled:cursor-not-allowed transition-colors"
-          >
-            {isStreaming ? (
-              <Loader2 className="h-4 w-4 animate-spin" />
-            ) : (
-              <ArrowUp className="h-4 w-4" />
-            )}
-          </button>
-        </div>
-      </div>
-    </div>
-  );
-}

examples/chat/components/theme-provider.tsx

@@ -1,16 +0,0 @@
-"use client";
-
-import { ThemeProvider as NextThemesProvider } from "next-themes";
-
-export function ThemeProvider({ children }: { children: React.ReactNode }) {
-  return (
-    <NextThemesProvider
-      attribute="class"
-      defaultTheme="system"
-      enableSystem
-      disableTransitionOnChange
-    >
-      {children}
-    </NextThemesProvider>
-  );
-}

examples/chat/components/theme-toggle.tsx

@@ -1,36 +0,0 @@
-"use client";
-
-import { useTheme } from "next-themes";
-import { useEffect, useState } from "react";
-import { Moon, Sun } from "lucide-react";
-
-export function ThemeToggle() {
-  const { theme, setTheme } = useTheme();
-  const [mounted, setMounted] = useState(false);
-
-  useEffect(() => {
-    setMounted(true);
-  }, []);
-
-  if (!mounted) {
-    return (
-      <button className="p-2 rounded-md border border-border bg-card">
-        <Sun className="h-4 w-4" />
-      </button>
-    );
-  }
-
-  return (
-    <button
-      onClick={() => setTheme(theme === "dark" ? "light" : "dark")}
-      className="p-2 rounded-md border border-border bg-card hover:bg-accent transition-colors"
-      aria-label="Toggle theme"
-    >
-      {theme === "dark" ? (
-        <Sun className="h-4 w-4" />
-      ) : (
-        <Moon className="h-4 w-4" />
-      )}
-    </button>
-  );
-}

examples/chat/components/ui/accordion.tsx

@@ -1,73 +0,0 @@
-"use client";
-
-import * as React from "react";
-import { Accordion as AccordionPrimitive } from "radix-ui";
-import { ChevronDownIcon } from "lucide-react";
-
-import { cn } from "@/lib/utils";
-
-function Accordion({
-  className,
-  ...props
-}: React.ComponentProps<typeof AccordionPrimitive.Root>) {
-  return (
-    <AccordionPrimitive.Root
-      data-slot="accordion"
-      className={cn("w-full", className)}
-      {...props}
-    />
-  );
-}
-
-function AccordionItem({
-  className,
-  ...props
-}: React.ComponentProps<typeof AccordionPrimitive.Item>) {
-  return (
-    <AccordionPrimitive.Item
-      data-slot="accordion-item"
-      className={cn("border-b last:border-b-0", className)}
-      {...props}
-    />
-  );
-}
-
-function AccordionTrigger({
-  className,
-  children,
-  ...props
-}: React.ComponentProps<typeof AccordionPrimitive.Trigger>) {
-  return (
-    <AccordionPrimitive.Header className="flex">
-      <AccordionPrimitive.Trigger
-        data-slot="accordion-trigger"
-        className={cn(
-          "focus-visible:border-ring focus-visible:ring-ring/50 flex flex-1 items-start justify-between gap-4 rounded-md py-4 text-left text-sm font-medium transition-all outline-none hover:underline focus-visible:ring-[3px] [&[data-state=open]>svg]:rotate-180",
-          className,
-        )}
-        {...props}
-      >
-        {children}
-        <ChevronDownIcon className="text-muted-foreground pointer-events-none size-4 shrink-0 translate-y-0.5 transition-transform duration-200" />
-      </AccordionPrimitive.Trigger>
-    </AccordionPrimitive.Header>
-  );
-}
-
-function AccordionContent({
-  className,
-  children,
-  ...props
-}: React.ComponentProps<typeof AccordionPrimitive.Content>) {
-  return (
-    <AccordionPrimitive.Content
-      data-slot="accordion-content"
-      className="data-[state=closed]:animate-accordion-up data-[state=open]:animate-accordion-down overflow-hidden text-sm"
-      {...props}
-    >
-      <div className={cn("pt-0 pb-4", className)}>{children}</div>
-    </AccordionPrimitive.Content>
-  );
-}
-
-export { Accordion, AccordionItem, AccordionTrigger, AccordionContent };

examples/chat/components/ui/alert.tsx

@@ -1,66 +0,0 @@
-import * as React from "react";
-import { cva, type VariantProps } from "class-variance-authority";
-
-import { cn } from "@/lib/utils";
-
-const alertVariants = cva(
-  "relative w-full rounded-lg border px-4 py-3 text-sm grid has-[>svg]:grid-cols-[calc(var(--spacing)*4)_1fr] grid-cols-[0_1fr] has-[>svg]:gap-x-3 gap-y-0.5 items-start [&>svg]:size-4 [&>svg]:translate-y-0.5 [&>svg]:text-current",
-  {
-    variants: {
-      variant: {
-        default: "bg-card text-card-foreground",
-        destructive:
-          "text-destructive bg-card [&>svg]:text-current *:data-[slot=alert-description]:text-destructive/90",
-      },
-    },
-    defaultVariants: {
-      variant: "default",
-    },
-  },
-);
-
-function Alert({
-  className,
-  variant,
-  ...props
-}: React.ComponentProps<"div"> & VariantProps<typeof alertVariants>) {
-  return (
-    <div
-      data-slot="alert"
-      role="alert"
-      className={cn(alertVariants({ variant }), className)}
-      {...props}
-    />
-  );
-}
-
-function AlertTitle({ className, ...props }: React.ComponentProps<"div">) {
-  return (
-    <div
-      data-slot="alert-title"
-      className={cn(
-        "col-start-2 line-clamp-1 min-h-4 font-medium tracking-tight",
-        className,
-      )}
-      {...props}
-    />
-  );
-}
-
-function AlertDescription({
-  className,
-  ...props
-}: React.ComponentProps<"div">) {
-  return (
-    <div
-      data-slot="alert-description"
-      className={cn(
-        "text-muted-foreground col-start-2 grid justify-items-start gap-1 text-sm [&_p]:leading-relaxed",
-        className,
-      )}
-      {...props}
-    />
-  );
-}
-
-export { Alert, AlertTitle, AlertDescription };

examples/chat/components/ui/badge.tsx

@@ -1,48 +0,0 @@
-import * as React from "react";
-import { cva, type VariantProps } from "class-variance-authority";
-import { Slot } from "radix-ui";
-
-import { cn } from "@/lib/utils";
-
-const badgeVariants = cva(
-  "inline-flex items-center justify-center rounded-full border border-transparent px-2 py-0.5 text-xs font-medium w-fit whitespace-nowrap shrink-0 [&>svg]:size-3 gap-1 [&>svg]:pointer-events-none focus-visible:border-ring focus-visible:ring-ring/50 focus-visible:ring-[3px] aria-invalid:ring-destructive/20 dark:aria-invalid:ring-destructive/40 aria-invalid:border-destructive transition-[color,box-shadow] overflow-hidden",
-  {
-    variants: {
-      variant: {
-        default: "bg-primary text-primary-foreground [a&]:hover:bg-primary/90",
-        secondary:
-          "bg-secondary text-secondary-foreground [a&]:hover:bg-secondary/90",
-        destructive:
-          "bg-destructive text-white [a&]:hover:bg-destructive/90 focus-visible:ring-destructive/20 dark:focus-visible:ring-destructive/40 dark:bg-destructive/60",
-        outline:
-          "border-border text-foreground [a&]:hover:bg-accent [a&]:hover:text-accent-foreground",
-        ghost: "[a&]:hover:bg-accent [a&]:hover:text-accent-foreground",
-        link: "text-primary underline-offset-4 [a&]:hover:underline",
-      },
-    },
-    defaultVariants: {
-      variant: "default",
-    },
-  },
-);
-
-function Badge({
-  className,
-  variant = "default",
-  asChild = false,
-  ...props
-}: React.ComponentProps<"span"> &
-  VariantProps<typeof badgeVariants> & { asChild?: boolean }) {
-  const Comp = asChild ? Slot.Root : "span";
-
-  return (
-    <Comp
-      data-slot="badge"
-      data-variant={variant}
-      className={cn(badgeVariants({ variant }), className)}
-      {...props}
-    />
-  );
-}
-
-export { Badge, badgeVariants };

examples/chat/components/ui/button.tsx

@@ -1,57 +0,0 @@
-import * as React from "react";
-import { cva, type VariantProps } from "class-variance-authority";
-import { Slot } from "radix-ui";
-import { cn } from "@/lib/utils";
-
-const buttonVariants = cva(
-  "inline-flex items-center justify-center gap-2 whitespace-nowrap rounded-md text-sm font-medium ring-offset-background transition-colors focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring focus-visible:ring-offset-2 disabled:pointer-events-none disabled:opacity-50 [&_svg]:pointer-events-none [&_svg]:size-4 [&_svg]:shrink-0",
-  {
-    variants: {
-      variant: {
-        default: "bg-primary text-primary-foreground hover:bg-primary/90",
-        destructive:
-          "bg-destructive text-destructive-foreground hover:bg-destructive/90",
-        outline:
-          "border border-input bg-background hover:bg-accent hover:text-accent-foreground",
-        secondary:
-          "bg-secondary text-secondary-foreground hover:bg-secondary/80",
-        ghost: "hover:bg-accent hover:text-accent-foreground",
-        link: "text-primary underline-offset-4 hover:underline",
-      },
-      size: {
-        default: "h-10 px-4 py-2",
-        sm: "h-9 rounded-md px-3",
-        lg: "h-11 rounded-md px-8",
-        icon: "h-10 w-10",
-      },
-    },
-    defaultVariants: {
-      variant: "default",
-      size: "default",
-    },
-  },
-);
-
-interface ButtonProps
-  extends
-    React.ButtonHTMLAttributes<HTMLButtonElement>,
-    VariantProps<typeof buttonVariants> {
-  asChild?: boolean;
-}
-
-const Button = React.forwardRef<HTMLButtonElement, ButtonProps>(
-  ({ className, variant, size, asChild = false, ...props }, ref) => {
-    const Comp = asChild ? Slot.Root : "button";
-    return (
-      <Comp
-        className={cn(buttonVariants({ variant, size, className }))}
-        ref={ref}
-        {...props}
-      />
-    );
-  },
-);
-Button.displayName = "Button";
-
-export { Button, buttonVariants };
-export type { ButtonProps };

examples/chat/components/ui/card.tsx

@@ -1,92 +0,0 @@
-import * as React from "react";
-
-import { cn } from "@/lib/utils";
-
-function Card({ className, ...props }: React.ComponentProps<"div">) {
-  return (
-    <div
-      data-slot="card"
-      className={cn(
-        "bg-card text-card-foreground flex flex-col gap-6 rounded-xl border py-6 shadow-sm",
-        className,
-      )}
-      {...props}
-    />
-  );
-}
-
-function CardHeader({ className, ...props }: React.ComponentProps<"div">) {
-  return (
-    <div
-      data-slot="card-header"
-      className={cn(
-        "@container/card-header grid auto-rows-min grid-rows-[auto_auto] items-start gap-2 px-6 has-data-[slot=card-action]:grid-cols-[1fr_auto] [.border-b]:pb-6",
-        className,
-      )}
-      {...props}
-    />
-  );
-}
-
-function CardTitle({ className, ...props }: React.ComponentProps<"div">) {
-  return (
-    <div
-      data-slot="card-title"
-      className={cn("leading-none font-semibold", className)}
-      {...props}
-    />
-  );
-}
-
-function CardDescription({ className, ...props }: React.ComponentProps<"div">) {
-  return (
-    <div
-      data-slot="card-description"
-      className={cn("text-muted-foreground text-sm", className)}
-      {...props}
-    />
-  );
-}
-
-function CardAction({ className, ...props }: React.ComponentProps<"div">) {
-  return (
-    <div
-      data-slot="card-action"
-      className={cn(
-        "col-start-2 row-span-2 row-start-1 self-start justify-self-end",
-        className,
-      )}
-      {...props}
-    />
-  );
-}
-
-function CardContent({ className, ...props }: React.ComponentProps<"div">) {
-  return (
-    <div
-      data-slot="card-content"
-      className={cn("px-6", className)}
-      {...props}
-    />
-  );
-}
-
-function CardFooter({ className, ...props }: React.ComponentProps<"div">) {
-  return (
-    <div
-      data-slot="card-footer"
-      className={cn("flex items-center px-6 [.border-t]:pt-6", className)}
-      {...props}
-    />
-  );
-}
-
-export {
-  Card,
-  CardHeader,
-  CardFooter,
-  CardTitle,
-  CardAction,
-  CardDescription,
-  CardContent,
-};

examples/chat/components/ui/chart.tsx

@@ -1,357 +0,0 @@
-"use client";
-
-import * as React from "react";
-import * as RechartsPrimitive from "recharts";
-
-import { cn } from "@/lib/utils";
-
-// Format: { THEME_NAME: CSS_SELECTOR }
-const THEMES = { light: "", dark: ".dark" } as const;
-
-export type ChartConfig = {
-  [k in string]: {
-    label?: React.ReactNode;
-    icon?: React.ComponentType;
-  } & (
-    | { color?: string; theme?: never }
-    | { color?: never; theme: Record<keyof typeof THEMES, string> }
-  );
-};
-
-type ChartContextProps = {
-  config: ChartConfig;
-};
-
-const ChartContext = React.createContext<ChartContextProps | null>(null);
-
-function useChart() {
-  const context = React.useContext(ChartContext);
-
-  if (!context) {
-    throw new Error("useChart must be used within a <ChartContainer />");
-  }
-
-  return context;
-}
-
-function ChartContainer({
-  id,
-  className,
-  children,
-  config,
-  ...props
-}: React.ComponentProps<"div"> & {
-  config: ChartConfig;
-  children: React.ComponentProps<
-    typeof RechartsPrimitive.ResponsiveContainer
-  >["children"];
-}) {
-  const uniqueId = React.useId();
-  const chartId = `chart-${id || uniqueId.replace(/:/g, "")}`;
-
-  return (
-    <ChartContext.Provider value={{ config }}>
-      <div
-        data-slot="chart"
-        data-chart={chartId}
-        className={cn(
-          "[&_.recharts-cartesian-axis-tick_text]:fill-muted-foreground [&_.recharts-cartesian-grid_line[stroke='#ccc']]:stroke-border/50 [&_.recharts-curve.recharts-tooltip-cursor]:stroke-border [&_.recharts-polar-grid_[stroke='#ccc']]:stroke-border [&_.recharts-radial-bar-background-sector]:fill-muted [&_.recharts-rectangle.recharts-tooltip-cursor]:fill-muted [&_.recharts-reference-line_[stroke='#ccc']]:stroke-border flex aspect-video justify-center text-xs [&_.recharts-dot[stroke='#fff']]:stroke-transparent [&_.recharts-layer]:outline-hidden [&_.recharts-sector]:outline-hidden [&_.recharts-sector[stroke='#fff']]:stroke-transparent [&_.recharts-surface]:outline-hidden",
-          className,
-        )}
-        {...props}
-      >
-        <ChartStyle id={chartId} config={config} />
-        <RechartsPrimitive.ResponsiveContainer>
-          {children}
-        </RechartsPrimitive.ResponsiveContainer>
-      </div>
-    </ChartContext.Provider>
-  );
-}
-
-const ChartStyle = ({ id, config }: { id: string; config: ChartConfig }) => {
-  const colorConfig = Object.entries(config).filter(
-    ([, config]) => config.theme || config.color,
-  );
-
-  if (!colorConfig.length) {
-    return null;
-  }
-
-  return (
-    <style
-      dangerouslySetInnerHTML={{
-        __html: Object.entries(THEMES)
-          .map(
-            ([theme, prefix]) => `
-${prefix} [data-chart=${id}] {
-${colorConfig
-  .map(([key, itemConfig]) => {
-    const color =
-      itemConfig.theme?.[theme as keyof typeof itemConfig.theme] ||
-      itemConfig.color;
-    return color ? `  --color-${key}: ${color};` : null;
-  })
-  .join("\n")}
-}
-`,
-          )
-          .join("\n"),
-      }}
-    />
-  );
-};
-
-const ChartTooltip = RechartsPrimitive.Tooltip;
-
-function ChartTooltipContent({
-  active,
-  payload,
-  className,
-  indicator = "dot",
-  hideLabel = false,
-  hideIndicator = false,
-  label,
-  labelFormatter,
-  labelClassName,
-  formatter,
-  color,
-  nameKey,
-  labelKey,
-}: React.ComponentProps<typeof RechartsPrimitive.Tooltip> &
-  React.ComponentProps<"div"> & {
-    hideLabel?: boolean;
-    hideIndicator?: boolean;
-    indicator?: "line" | "dot" | "dashed";
-    nameKey?: string;
-    labelKey?: string;
-  }) {
-  const { config } = useChart();
-
-  const tooltipLabel = React.useMemo(() => {
-    if (hideLabel || !payload?.length) {
-      return null;
-    }
-
-    const [item] = payload;
-    const key = `${labelKey || item?.dataKey || item?.name || "value"}`;
-    const itemConfig = getPayloadConfigFromPayload(config, item, key);
-    const value =
-      !labelKey && typeof label === "string"
-        ? config[label as keyof typeof config]?.label || label
-        : itemConfig?.label;
-
-    if (labelFormatter) {
-      return (
-        <div className={cn("font-medium", labelClassName)}>
-          {labelFormatter(value, payload)}
-        </div>
-      );
-    }
-
-    if (!value) {
-      return null;
-    }
-
-    return <div className={cn("font-medium", labelClassName)}>{value}</div>;
-  }, [
-    label,
-    labelFormatter,
-    payload,
-    hideLabel,
-    labelClassName,
-    config,
-    labelKey,
-  ]);
-
-  if (!active || !payload?.length) {
-    return null;
-  }
-
-  const nestLabel = payload.length === 1 && indicator !== "dot";
-
-  return (
-    <div
-      className={cn(
-        "border-border/50 bg-background grid min-w-[8rem] items-start gap-1.5 rounded-lg border px-2.5 py-1.5 text-xs shadow-xl",
-        className,
-      )}
-    >
-      {!nestLabel ? tooltipLabel : null}
-      <div className="grid gap-1.5">
-        {payload
-          .filter((item) => item.type !== "none")
-          .map((item, index) => {
-            const key = `${nameKey || item.name || item.dataKey || "value"}`;
-            const itemConfig = getPayloadConfigFromPayload(config, item, key);
-            const indicatorColor = color || item.payload.fill || item.color;
-
-            return (
-              <div
-                key={item.dataKey}
-                className={cn(
-                  "[&>svg]:text-muted-foreground flex w-full flex-wrap items-stretch gap-2 [&>svg]:h-2.5 [&>svg]:w-2.5",
-                  indicator === "dot" && "items-center",
-                )}
-              >
-                {formatter && item?.value !== undefined && item.name ? (
-                  formatter(item.value, item.name, item, index, item.payload)
-                ) : (
-                  <>
-                    {itemConfig?.icon ? (
-                      <itemConfig.icon />
-                    ) : (
-                      !hideIndicator && (
-                        <div
-                          className={cn(
-                            "shrink-0 rounded-[2px] border-(--color-border) bg-(--color-bg)",
-                            {
-                              "h-2.5 w-2.5": indicator === "dot",
-                              "w-1": indicator === "line",
-                              "w-0 border-[1.5px] border-dashed bg-transparent":
-                                indicator === "dashed",
-                              "my-0.5": nestLabel && indicator === "dashed",
-                            },
-                          )}
-                          style={
-                            {
-                              "--color-bg": indicatorColor,
-                              "--color-border": indicatorColor,
-                            } as React.CSSProperties
-                          }
-                        />
-                      )
-                    )}
-                    <div
-                      className={cn(
-                        "flex flex-1 justify-between leading-none",
-                        nestLabel ? "items-end" : "items-center",
-                      )}
-                    >
-                      <div className="grid gap-1.5">
-                        {nestLabel ? tooltipLabel : null}
-                        <span className="text-muted-foreground">
-                          {itemConfig?.label || item.name}
-                        </span>
-                      </div>
-                      {item.value && (
-                        <span className="text-foreground font-mono font-medium tabular-nums">
-                          {item.value.toLocaleString()}
-                        </span>
-                      )}
-                    </div>
-                  </>
-                )}
-              </div>
-            );
-          })}
-      </div>
-    </div>
-  );
-}
-
-const ChartLegend = RechartsPrimitive.Legend;
-
-function ChartLegendContent({
-  className,
-  hideIcon = false,
-  payload,
-  verticalAlign = "bottom",
-  nameKey,
-}: React.ComponentProps<"div"> &
-  Pick<RechartsPrimitive.LegendProps, "payload" | "verticalAlign"> & {
-    hideIcon?: boolean;
-    nameKey?: string;
-  }) {
-  const { config } = useChart();
-
-  if (!payload?.length) {
-    return null;
-  }
-
-  return (
-    <div
-      className={cn(
-        "flex items-center justify-center gap-4",
-        verticalAlign === "top" ? "pb-3" : "pt-3",
-        className,
-      )}
-    >
-      {payload
-        .filter((item) => item.type !== "none")
-        .map((item) => {
-          const key = `${nameKey || item.dataKey || "value"}`;
-          const itemConfig = getPayloadConfigFromPayload(config, item, key);
-
-          return (
-            <div
-              key={item.value}
-              className={cn(
-                "[&>svg]:text-muted-foreground flex items-center gap-1.5 [&>svg]:h-3 [&>svg]:w-3",
-              )}
-            >
-              {itemConfig?.icon && !hideIcon ? (
-                <itemConfig.icon />
-              ) : (
-                <div
-                  className="h-2 w-2 shrink-0 rounded-[2px]"
-                  style={{
-                    backgroundColor: item.color,
-                  }}
-                />
-              )}
-              {itemConfig?.label}
-            </div>
-          );
-        })}
-    </div>
-  );
-}
-
-// Helper to extract item config from a payload.
-function getPayloadConfigFromPayload(
-  config: ChartConfig,
-  payload: unknown,
-  key: string,
-) {
-  if (typeof payload !== "object" || payload === null) {
-    return undefined;
-  }
-
-  const payloadPayload =
-    "payload" in payload &&
-    typeof payload.payload === "object" &&
-    payload.payload !== null
-      ? payload.payload
-      : undefined;
-
-  let configLabelKey: string = key;
-
-  if (
-    key in payload &&
-    typeof payload[key as keyof typeof payload] === "string"
-  ) {
-    configLabelKey = payload[key as keyof typeof payload] as string;
-  } else if (
-    payloadPayload &&
-    key in payloadPayload &&
-    typeof payloadPayload[key as keyof typeof payloadPayload] === "string"
-  ) {
-    configLabelKey = payloadPayload[
-      key as keyof typeof payloadPayload
-    ] as string;
-  }
-
-  return configLabelKey in config
-    ? config[configLabelKey]
-    : config[key as keyof typeof config];
-}
-
-export {
-  ChartContainer,
-  ChartTooltip,
-  ChartTooltipContent,
-  ChartLegend,
-  ChartLegendContent,
-  ChartStyle,
-};

examples/chat/components/ui/input.tsx

@@ -1,20 +0,0 @@
-import * as React from "react";
-import { cn } from "@/lib/utils";
-
-const Input = React.forwardRef<
-  HTMLInputElement,
-  React.InputHTMLAttributes<HTMLInputElement>
->(({ className, type, ...props }, ref) => (
-  <input
-    type={type}
-    className={cn(
-      "flex h-10 w-full rounded-md border border-input bg-background px-3 py-2 text-sm ring-offset-background file:border-0 file:bg-transparent file:text-sm file:font-medium file:text-foreground placeholder:text-muted-foreground focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring focus-visible:ring-offset-2 disabled:cursor-not-allowed disabled:opacity-50",
-      className,
-    )}
-    ref={ref}
-    {...props}
-  />
-));
-Input.displayName = "Input";
-
-export { Input };

examples/chat/components/ui/label.tsx

@@ -1,22 +0,0 @@
-"use client";
-
-import * as React from "react";
-import { Label as LabelPrimitive } from "radix-ui";
-import { cn } from "@/lib/utils";
-
-const Label = React.forwardRef<
-  React.ComponentRef<typeof LabelPrimitive.Root>,
-  React.ComponentPropsWithoutRef<typeof LabelPrimitive.Root>
->(({ className, ...props }, ref) => (
-  <LabelPrimitive.Root
-    ref={ref}
-    className={cn(
-      "text-sm font-medium leading-none peer-disabled:cursor-not-allowed peer-disabled:opacity-70",
-      className,
-    )}
-    {...props}
-  />
-));
-Label.displayName = LabelPrimitive.Root.displayName;
-
-export { Label };