fix dashboard build

Introduces a `StateStore` interface that lets users plug in their own state management (Redux, Zustand, XState, etc.) instead of being locked into the internal `useState`-based store.

- Added `StateStore` interface and `createStateStore()` factory to `@json-render/core`
- `StateProvider`, `JSONUIProvider`, and `createRenderer` now accept an optional `store` prop for controlled mode
- When `store` is provided, it becomes the single source of truth (`initialState`/`onStateChange` are ignored)
- When `store` is omitted, everything works exactly as before (fully backward compatible)
- Applied across all platform packages: react, react-native, react-pdf

.changeset/config.json

@@ -10,10 +10,7 @@
       "@json-render/shadcn",
       "@json-render/react-native",
       "@json-render/remotion",
-      "@json-render/codegen",
-      "@json-render/zustand",
-      "@json-render/redux",
-      "@json-render/jotai"
+      "@json-render/codegen"
     ]
   ],
   "linked": [],
@@ -21,7 +18,7 @@
   "baseBranch": "main",
   "updateInternalDependencies": "patch",
   "privatePackages": {
-    "version": true,
+    "version": false,
     "tag": false
   }
 }

README.md

@@ -32,7 +32,7 @@ json-render is a **Generative UI** framework: AI generates interfaces from natur
 
 ```typescript
 import { defineCatalog } from "@json-render/core";
-import { schema } from "@json-render/react/schema";
+import { schema } from "@json-render/react";
 import { z } from "zod";
 
 const catalog = defineCatalog(schema, {
@@ -124,7 +124,7 @@ 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)
 const spec = {
@@ -152,8 +152,7 @@ const { registry } = defineRegistry(catalog, { components });
 
 ```tsx
 import { defineCatalog } from "@json-render/core";
-import { schema } from "@json-render/react/schema";
-import { defineRegistry, Renderer } from "@json-render/react";
+import { schema, defineRegistry, Renderer } from "@json-render/react";
 import { shadcnComponentDefinitions } from "@json-render/shadcn/catalog";
 import { shadcnComponents } from "@json-render/shadcn";
 

apps/web/CHANGELOG.md

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

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

@@ -67,7 +67,7 @@ A2UI uses an adjacency list model - a flat list of components with ID references
 
 ```typescript
 import { defineCatalog } from '@json-render/core';
-import { schema } from '@json-render/react/schema';
+import { schema } from '@json-render/react';
 import { z } from 'zod';
 
 // A2UI BoundValue schema

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

@@ -90,7 +90,7 @@ Define a catalog matching the Adaptive Cards element types:
 
 ```typescript
 import { defineCatalog } from '@json-render/core';
-import { schema } from '@json-render/react/schema';
+import { schema } from '@json-render/react';
 import { z } from 'zod';
 
 // Common Adaptive Cards properties

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

@@ -151,7 +151,7 @@ Create a catalog for UI components that agents can render:
 
 ```typescript
 import { defineCatalog } from '@json-render/core';
-import { schema } from '@json-render/react/schema';
+import { schema } from '@json-render/react';
 import { z } from 'zod';
 
 export const aguiCatalog = defineCatalog(schema, {

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

@@ -11,7 +11,7 @@ Creates a type-safe catalog definition with schema validation.
 
 ```typescript
 import { defineCatalog } from '@json-render/core';
-import { schema } from '@json-render/react/schema';
+import { schema } from '@json-render/react';
 
 function defineCatalog<T extends ZodType>(
   s: T,
@@ -119,7 +119,7 @@ The schema for flat UI element trees. This is exported from @json-render/react.
 
 ```typescript
 import { defineCatalog } from '@json-render/core';
-import { schema } from '@json-render/react/schema';
+import { schema } from '@json-render/react';
 
 // schema defines:
 // - Spec shape: { root: string, elements: Record<string, UIElement> }

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

@@ -19,7 +19,7 @@ A catalog is the vocabulary for your UI. While the [schema](/docs/schemas) defin
 
 ```typescript
 import { defineCatalog } from '@json-render/core';
-import { schema } from '@json-render/react/schema'; // or '@json-render/react-native/schema'
+import { schema } from '@json-render/react'; // or '@json-render/react-native'
 import { z } from 'zod';
 
 const catalog = defineCatalog(schema, {

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

@@ -5,17 +5,7 @@ export const metadata = pageMetadata("docs/changelog")
 
 Notable changes and updates to json-render.
 
-## v0.9.1
-
-February 2026
-
-### Fixed: Install failure due to private dependency
-
-`@json-render/react`, `@json-render/react-pdf`, and `@json-render/react-native` v0.9.0 failed to install because `@internal/react-state` (a private workspace package) was published as a dependency. The internal package is now bundled into each renderer at build time, so it no longer needs to be resolved from npm.
-
----
-
-## v0.9.0
+## v0.8.0
 
 February 2026
 
@@ -23,17 +13,8 @@ February 2026
 
 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:
@@ -48,31 +29,6 @@ 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.

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

@@ -25,18 +25,6 @@ Requires Tailwind CSS in your project. See the [@json-render/shadcn API referenc
 
 <PackageInstall packages="@json-render/core @json-render/remotion remotion @remotion/player" />
 
-## For External State Management (Optional)
-
-If you want to wire json-render to an existing state management library instead of the built-in store, install the adapter for your library:
-
-<PackageInstall packages="@json-render/zustand" />
-
-<PackageInstall packages="@json-render/redux" />
-
-<PackageInstall packages="@json-render/jotai" />
-
-See the [Data Binding](/docs/data-binding#external-store-controlled-mode) guide for usage.
-
 ## Peer Dependencies
 
 json-render requires the following peer dependencies:

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

@@ -100,7 +100,7 @@ Create components that map to OpenAPI data types:
 
 ```typescript
 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 openapiCatalog = defineCatalog(schema, {

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

@@ -23,7 +23,7 @@ A catalog declares what AI can use: components with typed props, actions with ty
 
 ```typescript
 import { defineCatalog } from '@json-render/core';
-import { schema } from '@json-render/react/schema';
+import { schema } from '@json-render/react';
 import { z } from 'zod';
 
 export const catalog = defineCatalog(schema, {

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

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

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

@@ -133,7 +133,7 @@ Actions are declared in your [catalog](/docs/catalog). The `@json-render/react`
 
 ```typescript
 import { defineCatalog } from '@json-render/core';
-import { schema } from '@json-render/react/schema';
+import { schema } from '@json-render/react';
 import { z } from 'zod';
 
 const catalog = defineCatalog(schema, {

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

@@ -67,7 +67,7 @@ Define custom validators in your catalog's `functions` field. The catalog itself
 
 ```typescript
 import { defineCatalog } from '@json-render/core';
-import { schema } from '@json-render/react/schema'; // or '@json-render/react-native/schema'
+import { schema } from '@json-render/react'; // or '@json-render/react-native'
 import { z } from 'zod';
 
 const catalog = defineCatalog(schema, {

apps/web/package.json

@@ -1,6 +1,6 @@
 {
   "name": "web",
-  "version": "0.1.2",
+  "version": "0.1.0",
   "type": "module",
   "private": true,
   "license": "Apache-2.0",

examples/chat/CHANGELOG.md

@@ -1,19 +0,0 @@
-# example-chat
-
-## 0.1.2
-
-### Patch Changes
-
-- Updated dependencies [b103676]
-  - @json-render/react@0.9.1
-  - @json-render/shadcn@0.9.1
-  - @json-render/core@0.9.1
-
-## 0.1.1
-
-### Patch Changes
-
-- Updated dependencies [1d755c1]
-  - @json-render/core@0.9.0
-  - @json-render/react@0.9.0
-  - @json-render/shadcn@0.9.0

examples/chat/package.json

@@ -1,6 +1,6 @@
 {
   "name": "example-chat",
-  "version": "0.1.2",
+  "version": "0.1.0",
   "type": "module",
   "private": true,
   "scripts": {

examples/dashboard/CHANGELOG.md

@@ -1,19 +0,0 @@
-# example-dashboard
-
-## 0.1.2
-
-### Patch Changes
-
-- Updated dependencies [b103676]
-  - @json-render/react@0.9.1
-  - @json-render/core@0.9.1
-  - @json-render/codegen@0.9.1
-
-## 0.1.1
-
-### Patch Changes
-
-- Updated dependencies [1d755c1]
-  - @json-render/core@0.9.0
-  - @json-render/react@0.9.0
-  - @json-render/codegen@0.9.0

examples/dashboard/package.json

@@ -1,6 +1,6 @@
 {
   "name": "example-dashboard",
-  "version": "0.1.2",
+  "version": "0.1.0",
   "type": "module",
   "private": true,
   "scripts": {

examples/no-ai/CHANGELOG.md

@@ -1,19 +0,0 @@
-# example-no-ai
-
-## 0.1.2
-
-### Patch Changes
-
-- Updated dependencies [b103676]
-  - @json-render/react@0.9.1
-  - @json-render/shadcn@0.9.1
-  - @json-render/core@0.9.1
-
-## 0.1.1
-
-### Patch Changes
-
-- Updated dependencies [1d755c1]
-  - @json-render/core@0.9.0
-  - @json-render/react@0.9.0
-  - @json-render/shadcn@0.9.0

examples/no-ai/package.json

@@ -1,6 +1,6 @@
 {
   "name": "example-no-ai",
-  "version": "0.1.2",
+  "version": "0.1.0",
   "type": "module",
   "private": true,
   "scripts": {

examples/react-native/CHANGELOG.md

@@ -1,17 +0,0 @@
-# example-react-native
-
-## 0.1.2
-
-### Patch Changes
-
-- Updated dependencies [b103676]
-  - @json-render/react-native@0.9.1
-  - @json-render/core@0.9.1
-
-## 0.1.1
-
-### Patch Changes
-
-- Updated dependencies [1d755c1]
-  - @json-render/core@0.9.0
-  - @json-render/react-native@0.9.0

examples/react-native/package.json

@@ -1,6 +1,6 @@
 {
   "name": "example-react-native",
-  "version": "0.1.2",
+  "version": "0.1.0",
   "private": true,
   "main": "expo-router/entry",
   "scripts": {

examples/react-pdf/CHANGELOG.md

@@ -1,17 +0,0 @@
-# example-react-pdf
-
-## 0.1.2
-
-### Patch Changes
-
-- Updated dependencies [b103676]
-  - @json-render/react-pdf@0.9.1
-  - @json-render/core@0.9.1
-
-## 0.1.1
-
-### Patch Changes
-
-- Updated dependencies [1d755c1]
-  - @json-render/core@0.9.0
-  - @json-render/react-pdf@0.9.0

examples/react-pdf/package.json

@@ -1,6 +1,6 @@
 {
   "name": "example-react-pdf",
-  "version": "0.1.2",
+  "version": "0.1.0",
   "type": "module",
   "private": true,
   "scripts": {

examples/remotion/CHANGELOG.md

@@ -1,16 +0,0 @@
-# example-remotion
-
-## 0.1.2
-
-### Patch Changes
-
-- @json-render/core@0.9.1
-- @json-render/remotion@0.9.1
-
-## 0.1.1
-
-### Patch Changes
-
-- Updated dependencies [1d755c1]
-  - @json-render/core@0.9.0
-  - @json-render/remotion@0.9.0

examples/remotion/package.json

@@ -1,6 +1,6 @@
 {
   "name": "example-remotion",
-  "version": "0.1.2",
+  "version": "0.1.0",
   "type": "module",
   "private": true,
   "scripts": {

examples/stripe-app/drawer-app/CHANGELOG.md

@@ -1,17 +0,0 @@
-# com.example.json-render-demo
-
-## 0.0.3
-
-### Patch Changes
-
-- Updated dependencies [b103676]
-  - @json-render/react@0.9.1
-  - @json-render/core@0.9.1
-
-## 0.0.2
-
-### Patch Changes
-
-- Updated dependencies [1d755c1]
-  - @json-render/core@0.9.0
-  - @json-render/react@0.9.0

examples/stripe-app/drawer-app/package.json

@@ -1,6 +1,6 @@
 {
   "name": "com.example.json-render-demo",
-  "version": "0.0.3",
+  "version": "0.0.1",
   "description": "Test",
   "private": true,
   "license": "~~proprietary~~",

examples/stripe-app/drawer-app/src/lib/render/catalog.ts

@@ -1,5 +1,5 @@
 import { defineCatalog } from "@json-render/core";
-import { schema } from "@json-render/react/schema";
+import { schema } from "@json-render/react";
 import { z } from "zod";
 
 /**

examples/stripe-app/fullpage-app/CHANGELOG.md

@@ -1,17 +0,0 @@
-# com.example.json-render-fullpage-demo
-
-## 0.0.3
-
-### Patch Changes
-
-- Updated dependencies [b103676]
-  - @json-render/react@0.9.1
-  - @json-render/core@0.9.1
-
-## 0.0.2
-
-### Patch Changes
-
-- Updated dependencies [1d755c1]
-  - @json-render/core@0.9.0
-  - @json-render/react@0.9.0

examples/stripe-app/fullpage-app/package.json

@@ -1,6 +1,6 @@
 {
   "name": "com.example.json-render-fullpage-demo",
-  "version": "0.0.3",
+  "version": "0.0.1",
   "description": "Full-page Stripe App example (alpha)",
   "private": true,
   "license": "~~proprietary~~",

examples/stripe-app/fullpage-app/src/lib/render/catalog.ts

@@ -1,5 +1,5 @@
 import { defineCatalog } from "@json-render/core";
-import { schema } from "@json-render/react/schema";
+import { schema } from "@json-render/react";
 import { z } from "zod";
 
 /**

packages/codegen/CHANGELOG.md

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

packages/codegen/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@json-render/codegen",
-  "version": "0.9.1",
+  "version": "0.8.0",
   "license": "Apache-2.0",
   "description": "Utilities for generating code from json-render UI trees",
   "keywords": [

packages/core/CHANGELOG.md

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

packages/core/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@json-render/core",
-  "version": "0.9.1",
+  "version": "0.8.0",
   "license": "Apache-2.0",
   "description": "JSON becomes real things. Define your catalog, register your components, let AI generate.",
   "keywords": [

packages/core/src/schema.test.ts

@@ -169,11 +169,7 @@ describe("catalog.prompt", () => {
     const catalog = defineCatalog(testSchema, {
       components: {
         Card: {
-          props: z.object({
-            title: z.string(),
-            names: z.array(z.string()),
-            users: z.array(z.object({ name: z.string(), age: z.number() })),
-          }),
+          props: z.object({ title: z.string() }),
           description: "A card container",
           slots: ["default"],
         },
@@ -184,9 +180,6 @@ describe("catalog.prompt", () => {
     expect(prompt).toContain("AVAILABLE COMPONENTS");
     expect(prompt).toContain("Card");
     expect(prompt).toContain("A card container");
-    expect(prompt).toContain("title: string");
-    expect(prompt).toContain("names: Array<string>");
-    expect(prompt).toContain("users: Array<{ name: string, age: number }>");
   });
 
   it("includes AVAILABLE ACTIONS when present", () => {

packages/core/src/schema.ts

@@ -1188,14 +1188,7 @@ function formatZodType(schema: z.ZodType): string {
     }
     case "ZodArray":
     case "array": {
-      // safely resolve inner type for Zod arrays
-      const inner = (
-        typeof def.element === "object"
-          ? def.element
-          : typeof def.type === "object"
-            ? def.type
-            : undefined
-      ) as z.ZodType | undefined;
+      const inner = (def.type as z.ZodType) ?? (def.element as z.ZodType);
       return inner ? `Array<${formatZodType(inner)}>` : "Array<unknown>";
     }
     case "ZodObject":

packages/jotai/CHANGELOG.md

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

packages/jotai/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@json-render/jotai",
-  "version": "0.9.1",
+  "version": "0.8.0",
   "license": "Apache-2.0",
   "description": "Jotai adapter for json-render StateStore",
   "keywords": [

packages/react-native/CHANGELOG.md

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

packages/react-native/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@json-render/react-native",
-  "version": "0.9.1",
+  "version": "0.8.0",
   "license": "Apache-2.0",
   "description": "React Native renderer for @json-render/core. JSON becomes React Native components.",
   "keywords": [
@@ -56,10 +56,10 @@
     "typecheck": "tsc --noEmit"
   },
   "dependencies": {
-    "@json-render/core": "workspace:*"
+    "@json-render/core": "workspace:*",
+    "@internal/react-state": "workspace:*"
   },
   "devDependencies": {
-    "@internal/react-state": "workspace:*",
     "@internal/typescript-config": "workspace:*",
     "@types/react": "19.2.3",
     "react-native": "0.83.1",

packages/react-native/src/contexts/actions.tsx

@@ -135,7 +135,7 @@ export function ActionProvider({
   navigate,
   children,
 }: ActionProviderProps) {
-  const { get, set, getSnapshot } = useStateStore();
+  const { state, get, set } = useStateStore();
   const [handlers, setHandlers] =
     useState<Record<string, ActionHandler>>(initialHandlers);
   const [loadingActions, setLoadingActions] = useState<Set<string>>(new Set());
@@ -151,7 +151,7 @@ export function ActionProvider({
 
   const execute = useCallback(
     async (binding: ActionBinding) => {
-      const resolved = resolveAction(binding, getSnapshot());
+      const resolved = resolveAction(binding, state);
 
       // Built-in: setState updates the StateProvider state directly
       if (resolved.action === "setState" && resolved.params) {
@@ -298,7 +298,7 @@ export function ActionProvider({
         });
       }
     },
-    [handlers, get, set, getSnapshot, navigate],
+    [state, handlers, get, set, navigate],
   );
 
   const confirm = useCallback(() => {

packages/react-native/src/renderer.tsx

@@ -158,7 +158,6 @@ const ElementRenderer = React.memo(function ElementRenderer({
   const repeatScope = useRepeatScope();
   const { ctx } = useVisibility();
   const { execute } = useActions();
-  const { getSnapshot } = useStateStore();
 
   // Build context with repeat scope (used for both visibility and props)
   const fullCtx: PropResolutionContext = useMemo(
@@ -184,29 +183,25 @@ const ElementRenderer = React.memo(function ElementRenderer({
   // Must be called before any early return to satisfy Rules of Hooks.
   const onBindings = element.on;
   const emit = useCallback(
-    async (eventName: string) => {
+    (eventName: string) => {
       const binding = onBindings?.[eventName];
       if (!binding) return;
       const actionBindings = Array.isArray(binding) ? binding : [binding];
       for (const b of actionBindings) {
         if (!b.params) {
-          await execute(b);
+          execute(b);
           continue;
         }
-        // Build a fresh context with live store state so that $state
-        // references in later actions see mutations from earlier ones.
-        const liveCtx: PropResolutionContext = {
-          ...fullCtx,
-          stateModel: getSnapshot(),
-        };
+        // Resolve all action params via resolveActionParam which handles
+        // $item (→ absolute state path), $index (→ number), $state, $cond, and literals.
         const resolved: Record<string, unknown> = {};
         for (const [key, val] of Object.entries(b.params)) {
-          resolved[key] = resolveActionParam(val, liveCtx);
+          resolved[key] = resolveActionParam(val, fullCtx);
         }
-        await execute({ ...b, params: resolved });
+        execute({ ...b, params: resolved });
       }
     },
-    [onBindings, execute, fullCtx, getSnapshot],
+    [onBindings, execute, fullCtx],
   );
 
   // Don't render if not visible

packages/react-native/tsup.config.ts

@@ -3,9 +3,8 @@ import { defineConfig } from "tsup";
 export default defineConfig({
   entry: ["src/index.ts", "src/schema.ts", "src/catalog.ts"],
   format: ["cjs", "esm"],
-  dts: { resolve: ["@internal/react-state"] },
+  dts: true,
   sourcemap: true,
   clean: true,
-  noExternal: ["@internal/react-state"],
   external: ["react", "react-native", "@json-render/core", "zod"],
 });

packages/react-pdf/CHANGELOG.md

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

packages/react-pdf/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@json-render/react-pdf",
-  "version": "0.9.1",
+  "version": "0.8.0",
   "license": "Apache-2.0",
   "description": "React PDF renderer for @json-render/core. JSON becomes PDF documents.",
   "keywords": [
@@ -61,10 +61,10 @@
   },
   "dependencies": {
     "@json-render/core": "workspace:*",
+    "@internal/react-state": "workspace:*",
     "@react-pdf/renderer": "^4.3.2"
   },
   "devDependencies": {
-    "@internal/react-state": "workspace:*",
     "@internal/typescript-config": "workspace:*",
     "@types/react": "19.2.3",
     "tsup": "^8.0.2",

packages/react-pdf/src/contexts/actions.tsx

@@ -90,7 +90,7 @@ export function ActionProvider({
   navigate,
   children,
 }: ActionProviderProps) {
-  const { get, set, getSnapshot } = useStateStore();
+  const { state, get, set } = useStateStore();
   const [handlers, setHandlers] =
     useState<Record<string, ActionHandler>>(initialHandlers);
   const [loadingActions, setLoadingActions] = useState<Set<string>>(new Set());
@@ -106,7 +106,7 @@ export function ActionProvider({
 
   const execute = useCallback(
     async (binding: ActionBinding) => {
-      const resolved = resolveAction(binding, getSnapshot());
+      const resolved = resolveAction(binding, state);
 
       if (resolved.action === "setState" && resolved.params) {
         const statePath = resolved.params.statePath as string;
@@ -211,7 +211,7 @@ export function ActionProvider({
         });
       }
     },
-    [handlers, get, set, getSnapshot, navigate],
+    [state, handlers, get, set, navigate],
   );
 
   const confirm = useCallback(() => {

packages/react-pdf/src/renderer.tsx

@@ -123,7 +123,6 @@ const ElementRenderer = React.memo(function ElementRenderer({
   const repeatScope = useRepeatScope();
   const { ctx } = useVisibility();
   const { execute } = useActions();
-  const { getSnapshot } = useStateStore();
 
   const fullCtx: PropResolutionContext = useMemo(
     () =>
@@ -145,29 +144,23 @@ const ElementRenderer = React.memo(function ElementRenderer({
 
   const onBindings = element.on;
   const emit = useCallback(
-    async (eventName: string) => {
+    (eventName: string) => {
       const binding = onBindings?.[eventName];
       if (!binding) return;
       const actionBindings = Array.isArray(binding) ? binding : [binding];
       for (const b of actionBindings) {
         if (!b.params) {
-          await execute(b);
+          execute(b);
           continue;
         }
-        // Build a fresh context with live store state so that $state
-        // references in later actions see mutations from earlier ones.
-        const liveCtx: PropResolutionContext = {
-          ...fullCtx,
-          stateModel: getSnapshot(),
-        };
         const resolved: Record<string, unknown> = {};
         for (const [key, val] of Object.entries(b.params)) {
-          resolved[key] = resolveActionParam(val, liveCtx);
+          resolved[key] = resolveActionParam(val, fullCtx);
         }
-        await execute({ ...b, params: resolved });
+        execute({ ...b, params: resolved });
       }
     },
-    [onBindings, execute, fullCtx, getSnapshot],
+    [onBindings, execute, fullCtx],
   );
 
   if (!isVisible) {

packages/react-pdf/tsup.config.ts

@@ -3,9 +3,8 @@ import { defineConfig } from "tsup";
 export default defineConfig({
   entry: ["src/index.ts", "src/server.ts", "src/catalog.ts", "src/render.tsx"],
   format: ["cjs", "esm"],
-  dts: { resolve: ["@internal/react-state"] },
+  dts: true,
   sourcemap: true,
   clean: true,
-  noExternal: ["@internal/react-state"],
   external: ["react", "@json-render/core", "@react-pdf/renderer", "zod"],
 });

packages/react-state/CHANGELOG.md

@@ -1,14 +0,0 @@
-# @internal/react-state
-
-## 0.8.2
-
-### Patch Changes
-
-- @json-render/core@0.9.1
-
-## 0.8.1
-
-### Patch Changes
-
-- Updated dependencies [1d755c1]
-  - @json-render/core@0.9.0

packages/react-state/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@internal/react-state",
-  "version": "0.8.2",
+  "version": "0.8.0",
   "private": true,
   "license": "Apache-2.0",
   "description": "Shared React state context for json-render renderer packages",

packages/react-state/src/index.tsx

@@ -30,8 +30,6 @@ export interface StateContextValue {
   set: (path: string, value: unknown) => void;
   /** Update multiple values at once */
   update: (updates: Record<string, unknown>) => void;
-  /** Return the live state snapshot from the underlying store (not the React render snapshot). */
-  getSnapshot: () => StateModel;
 }
 
 const StateContext = createContext<StateContextValue | null>(null);
@@ -172,11 +170,9 @@ export function StateProvider({
 
   const get = useCallback((path: string) => storeRef.current.get(path), []);
 
-  const getSnapshot = useCallback(() => storeRef.current.getSnapshot(), []);
-
   const value = useMemo<StateContextValue>(
-    () => ({ state, get, set, update, getSnapshot }),
-    [state, get, set, update, getSnapshot],
+    () => ({ state, get, set, update }),
+    [state, get, set, update],
   );
 
   return (

packages/react/CHANGELOG.md

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

packages/react/README.md

@@ -14,7 +14,7 @@ npm install @json-render/react @json-render/core zod
 
 ```typescript
 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, {
@@ -409,8 +409,7 @@ const systemPrompt = catalog.prompt();
 
 ```tsx
 import { defineCatalog } from "@json-render/core";
-import { schema } from "@json-render/react/schema";
-import { defineRegistry, Renderer } from "@json-render/react";
+import { schema, defineRegistry, Renderer } from "@json-render/react";
 import { z } from "zod";
 
 const catalog = defineCatalog(schema, {

packages/react/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@json-render/react",
-  "version": "0.9.1",
+  "version": "0.8.0",
   "license": "Apache-2.0",
   "description": "React renderer for @json-render/core. JSON becomes React components.",
   "keywords": [
@@ -50,10 +50,10 @@
     "typecheck": "tsc --noEmit"
   },
   "dependencies": {
-    "@json-render/core": "workspace:*"
+    "@json-render/core": "workspace:*",
+    "@internal/react-state": "workspace:*"
   },
   "devDependencies": {
-    "@internal/react-state": "workspace:*",
     "@internal/typescript-config": "workspace:*",
     "@types/react": "19.2.3",
     "tsup": "^8.0.2",

packages/react/src/chained-actions.test.tsx

@@ -1,198 +0,0 @@
-import { describe, it, expect } from "vitest";
-import React from "react";
-import { render, act, fireEvent, screen } from "@testing-library/react";
-import type { Spec } from "@json-render/core";
-import {
-  JSONUIProvider,
-  Renderer,
-  type ComponentRenderProps,
-} from "./renderer";
-import { useStateStore } from "./contexts/state";
-
-/**
- * Minimal Button component that calls emit("press") on click.
- */
-function Button({ element, emit }: ComponentRenderProps<{ label: string }>) {
-  return (
-    <button data-testid="btn" onClick={() => emit("press")}>
-      {element.props.label}
-    </button>
-  );
-}
-
-/**
- * Text component that renders its `text` prop.
- */
-function Text({ element }: ComponentRenderProps<{ text: unknown }>) {
-  const value = element.props.text;
-  return (
-    <span data-testid={`text-${element.type}`}>
-      {typeof value === "string" ? value : JSON.stringify(value)}
-    </span>
-  );
-}
-
-/**
- * Helper component that reads live state and exposes it via a data attribute
- * so we can assert against the store after actions fire.
- */
-function StateProbe() {
-  const { state } = useStateStore();
-  return <pre data-testid="state-probe">{JSON.stringify(state)}</pre>;
-}
-
-const registry = {
-  Button,
-  Text,
-};
-
-describe("chained actions: live $state resolution (#141)", () => {
-  it("setState after pushState sees the post-push value via $state", async () => {
-    const spec: Spec = {
-      state: { items: ["initial"], observed: "not yet set" },
-      root: "main",
-      elements: {
-        main: {
-          type: "Button",
-          props: { label: "Add Item" },
-          on: {
-            press: [
-              {
-                action: "pushState",
-                params: { statePath: "/items", value: "new-item" },
-              },
-              {
-                action: "setState",
-                params: {
-                  statePath: "/observed",
-                  value: { $state: "/items" },
-                },
-              },
-            ],
-          },
-        },
-      },
-    };
-
-    function App() {
-      return (
-        <JSONUIProvider registry={registry} initialState={spec.state}>
-          <Renderer spec={spec} registry={registry} />
-          <StateProbe />
-        </JSONUIProvider>
-      );
-    }
-
-    render(<App />);
-
-    await act(async () => {
-      fireEvent.click(screen.getByTestId("btn"));
-    });
-
-    const probe = screen.getByTestId("state-probe");
-    const state = JSON.parse(probe.textContent!);
-
-    expect(state.items).toEqual(["initial", "new-item"]);
-    expect(state.observed).toEqual(["initial", "new-item"]);
-  });
-
-  it("multiple pushState + setState chain resolves correctly", async () => {
-    const spec: Spec = {
-      state: { items: [], snapshot: null },
-      root: "main",
-      elements: {
-        main: {
-          type: "Button",
-          props: { label: "Go" },
-          on: {
-            press: [
-              {
-                action: "pushState",
-                params: { statePath: "/items", value: "a" },
-              },
-              {
-                action: "pushState",
-                params: { statePath: "/items", value: "b" },
-              },
-              {
-                action: "setState",
-                params: {
-                  statePath: "/snapshot",
-                  value: { $state: "/items" },
-                },
-              },
-            ],
-          },
-        },
-      },
-    };
-
-    function App() {
-      return (
-        <JSONUIProvider registry={registry} initialState={spec.state}>
-          <Renderer spec={spec} registry={registry} />
-          <StateProbe />
-        </JSONUIProvider>
-      );
-    }
-
-    render(<App />);
-
-    await act(async () => {
-      fireEvent.click(screen.getByTestId("btn"));
-    });
-
-    const state = JSON.parse(screen.getByTestId("state-probe").textContent!);
-
-    expect(state.items).toEqual(["a", "b"]);
-    expect(state.snapshot).toEqual(["a", "b"]);
-  });
-
-  it("setState reading a path mutated by an earlier setState sees fresh value", async () => {
-    const spec: Spec = {
-      state: { counter: 0, counterCopy: -1 },
-      root: "main",
-      elements: {
-        main: {
-          type: "Button",
-          props: { label: "Go" },
-          on: {
-            press: [
-              {
-                action: "setState",
-                params: { statePath: "/counter", value: 42 },
-              },
-              {
-                action: "setState",
-                params: {
-                  statePath: "/counterCopy",
-                  value: { $state: "/counter" },
-                },
-              },
-            ],
-          },
-        },
-      },
-    };
-
-    function App() {
-      return (
-        <JSONUIProvider registry={registry} initialState={spec.state}>
-          <Renderer spec={spec} registry={registry} />
-          <StateProbe />
-        </JSONUIProvider>
-      );
-    }
-
-    render(<App />);
-
-    await act(async () => {
-      fireEvent.click(screen.getByTestId("btn"));
-    });
-
-    const state = JSON.parse(screen.getByTestId("state-probe").textContent!);
-
-    expect(state.counter).toBe(42);
-    expect(state.counterCopy).toBe(42);
-  });
-});

packages/react/src/contexts/actions.tsx

@@ -6,6 +6,7 @@ import React, {
   useState,
   useCallback,
   useMemo,
+  useRef,
   type ReactNode,
 } from "react";
 import {
@@ -136,7 +137,11 @@ export function ActionProvider({
   navigate,
   children,
 }: ActionProviderProps) {
-  const { get, set, getSnapshot } = useStateStore();
+  const { state, get, set } = useStateStore();
+  // Keep a ref to the latest state so `execute` doesn't change on every
+  // state update — preventing the entire action context from churning.
+  const stateRef = useRef(state);
+  stateRef.current = state;
 
   const [handlers, setHandlers] =
     useState<Record<string, ActionHandler>>(initialHandlers);
@@ -153,7 +158,7 @@ export function ActionProvider({
 
   const execute = useCallback(
     async (binding: ActionBinding) => {
-      const resolved = resolveAction(binding, getSnapshot());
+      const resolved = resolveAction(binding, stateRef.current);
 
       // Built-in: setState updates the StateProvider state directly
       if (resolved.action === "setState" && resolved.params) {
@@ -300,7 +305,7 @@ export function ActionProvider({
         });
       }
     },
-    [handlers, get, set, getSnapshot, navigate],
+    [handlers, get, set, navigate],
   );
 
   const confirm = useCallback(() => {

packages/react/src/renderer.tsx

@@ -158,7 +158,6 @@ const ElementRenderer = React.memo(function ElementRenderer({
   const repeatScope = useRepeatScope();
   const { ctx } = useVisibility();
   const { execute } = useActions();
-  const { getSnapshot } = useStateStore();
 
   // Build context with repeat scope (used for both visibility and props)
   const fullCtx: PropResolutionContext = useMemo(
@@ -184,29 +183,25 @@ const ElementRenderer = React.memo(function ElementRenderer({
   // Must be called before any early return to satisfy Rules of Hooks.
   const onBindings = element.on;
   const emit = useCallback(
-    async (eventName: string) => {
+    (eventName: string) => {
       const binding = onBindings?.[eventName];
       if (!binding) return;
       const actionBindings = Array.isArray(binding) ? binding : [binding];
       for (const b of actionBindings) {
         if (!b.params) {
-          await execute(b);
+          execute(b);
           continue;
         }
-        // Build a fresh context with live store state so that $state
-        // references in later actions see mutations from earlier ones.
-        const liveCtx: PropResolutionContext = {
-          ...fullCtx,
-          stateModel: getSnapshot(),
-        };
+        // Resolve all action params via resolveActionParam which handles
+        // $item (→ absolute state path), $index (→ number), $state, $cond, and literals.
         const resolved: Record<string, unknown> = {};
         for (const [key, val] of Object.entries(b.params)) {
-          resolved[key] = resolveActionParam(val, liveCtx);
+          resolved[key] = resolveActionParam(val, fullCtx);
         }
-        await execute({ ...b, params: resolved });
+        execute({ ...b, params: resolved });
       }
     },
-    [onBindings, execute, fullCtx, getSnapshot],
+    [onBindings, execute, fullCtx],
   );
 
   // Create on() function that returns an EventHandle with metadata for a specific event.

packages/react/tsup.config.ts

@@ -3,9 +3,8 @@ import { defineConfig } from "tsup";
 export default defineConfig({
   entry: ["src/index.ts", "src/schema.ts"],
   format: ["cjs", "esm"],
-  dts: { resolve: ["@internal/react-state"] },
+  dts: true,
   sourcemap: true,
   clean: true,
-  noExternal: ["@internal/react-state"],
   external: ["react", "react-dom", "@json-render/core"],
 });

packages/redux/CHANGELOG.md

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

packages/redux/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@json-render/redux",
-  "version": "0.9.1",
+  "version": "0.8.0",
   "license": "Apache-2.0",
   "description": "Redux adapter for json-render StateStore",
   "keywords": [

packages/remotion/CHANGELOG.md

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

packages/remotion/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@json-render/remotion",
-  "version": "0.9.1",
+  "version": "0.8.0",
   "license": "Apache-2.0",
   "description": "Remotion renderer for @json-render/core. JSON becomes video compositions.",
   "keywords": [

packages/shadcn/CHANGELOG.md

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

packages/shadcn/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@json-render/shadcn",
-  "version": "0.9.1",
+  "version": "0.8.0",
   "license": "Apache-2.0",
   "description": "shadcn/ui component library for @json-render/core. JSON becomes beautiful Tailwind-styled React components.",
   "keywords": [

packages/zustand/CHANGELOG.md

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

packages/zustand/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@json-render/zustand",
-  "version": "0.9.1",
+  "version": "0.8.0",
   "license": "Apache-2.0",
   "description": "Zustand adapter for json-render StateStore",
   "keywords": [

pnpm-lock.yaml

@@ -885,6 +885,9 @@ importers:
 
   packages/react:
     dependencies:
+      '@internal/react-state':
+        specifier: workspace:*
+        version: link:../react-state
       '@json-render/core':
         specifier: workspace:*
         version: link:../core
@@ -892,9 +895,6 @@ importers:
         specifier: ^19.2.3
         version: 19.2.3
     devDependencies:
-      '@internal/react-state':
-        specifier: workspace:*
-        version: link:../react-state
       '@internal/typescript-config':
         specifier: workspace:*
         version: link:../typescript-config
@@ -910,6 +910,9 @@ importers:
 
   packages/react-native:
     dependencies:
+      '@internal/react-state':
+        specifier: workspace:*
+        version: link:../react-state
       '@json-render/core':
         specifier: workspace:*
         version: link:../core
@@ -917,9 +920,6 @@ importers:
         specifier: ^18.0.0 || ^19.0.0
         version: 19.2.4
     devDependencies:
-      '@internal/react-state':
-        specifier: workspace:*
-        version: link:../react-state
       '@internal/typescript-config':
         specifier: workspace:*
         version: link:../typescript-config
@@ -941,6 +941,9 @@ importers:
 
   packages/react-pdf:
     dependencies:
+      '@internal/react-state':
+        specifier: workspace:*
+        version: link:../react-state
       '@json-render/core':
         specifier: workspace:*
         version: link:../core
@@ -951,9 +954,6 @@ importers:
         specifier: ^18.0.0 || ^19.0.0
         version: 19.2.4
     devDependencies:
-      '@internal/react-state':
-        specifier: workspace:*
-        version: link:../react-state
       '@internal/typescript-config':
         specifier: workspace:*
         version: link:../typescript-config
@@ -12775,6 +12775,7 @@ snapshots:
       - graphql
       - supports-color
       - utf-8-validate
+    optional: true
 
   '@expo/code-signing-certificates@0.0.6':
     dependencies:
@@ -12839,6 +12840,7 @@ snapshots:
     optionalDependencies:
       react: 19.2.4
       react-native: 0.83.1(@babel/core@7.29.0)(@types/react@19.2.3)(react@19.2.4)
+    optional: true
 
   '@expo/env@2.0.8':
     dependencies:
@@ -12908,7 +12910,7 @@ snapshots:
       postcss: 8.4.49
       resolve-from: 5.0.0
     optionalDependencies:
-      expo: 54.0.33(@babel/core@7.29.0)(@expo/metro-runtime@6.1.2)(expo-router@6.0.23)(graphql@16.12.0)(react-native@0.83.1(@babel/core@7.29.0)(@types/react@19.2.3)(react@19.2.4))(react@19.2.4)
+      expo: 54.0.33(@babel/core@7.29.0)(@expo/metro-runtime@6.1.2)(expo-router@6.0.23)(graphql@16.12.0)(react-native@0.81.4(@babel/core@7.29.0)(@types/react@19.1.17)(react@19.1.0))(react@19.1.0)
     transitivePeerDependencies:
       - bufferutil
       - supports-color
@@ -12989,7 +12991,7 @@ snapshots:
       '@expo/json-file': 10.0.8
       '@react-native/normalize-colors': 0.81.5
       debug: 4.4.3
-      expo: 54.0.33(@babel/core@7.29.0)(@expo/metro-runtime@6.1.2)(expo-router@6.0.23)(graphql@16.12.0)(react-native@0.83.1(@babel/core@7.29.0)(@types/react@19.2.3)(react@19.2.4))(react@19.2.4)
+      expo: 54.0.33(@babel/core@7.29.0)(@expo/metro-runtime@6.1.2)(expo-router@6.0.23)(graphql@16.12.0)(react-native@0.81.4(@babel/core@7.29.0)(@types/react@19.1.17)(react@19.1.0))(react@19.1.0)
       resolve-from: 5.0.0
       semver: 7.7.3
       xml2js: 0.6.0
@@ -13017,6 +13019,7 @@ snapshots:
       expo-font: 14.0.11(expo@54.0.33)(react-native@0.83.1(@babel/core@7.29.0)(@types/react@19.2.3)(react@19.2.4))(react@19.2.4)
       react: 19.2.4
       react-native: 0.83.1(@babel/core@7.29.0)(@types/react@19.2.3)(react@19.2.4)
+    optional: true
 
   '@expo/ws-tunnel@1.0.6': {}
 
@@ -17335,7 +17338,7 @@ snapshots:
       resolve-from: 5.0.0
     optionalDependencies:
       '@babel/runtime': 7.28.6
-      expo: 54.0.33(@babel/core@7.29.0)(@expo/metro-runtime@6.1.2)(expo-router@6.0.23)(graphql@16.12.0)(react-native@0.83.1(@babel/core@7.29.0)(@types/react@19.2.3)(react@19.2.4))(react@19.2.4)
+      expo: 54.0.33(@babel/core@7.29.0)(@expo/metro-runtime@6.1.2)(expo-router@6.0.23)(graphql@16.12.0)(react-native@0.81.4(@babel/core@7.29.0)(@types/react@19.1.17)(react@19.1.0))(react@19.1.0)
     transitivePeerDependencies:
       - '@babel/core'
       - supports-color
@@ -18662,6 +18665,7 @@ snapshots:
       react-native: 0.83.1(@babel/core@7.29.0)(@types/react@19.2.3)(react@19.2.4)
     transitivePeerDependencies:
       - supports-color
+    optional: true
 
   expo-clipboard@8.0.8(expo@54.0.33)(react-native@0.81.4(@babel/core@7.29.0)(@types/react@19.1.17)(react@19.1.0))(react@19.1.0):
     dependencies:
@@ -18686,6 +18690,7 @@ snapshots:
       react-native: 0.83.1(@babel/core@7.29.0)(@types/react@19.2.3)(react@19.2.4)
     transitivePeerDependencies:
       - supports-color
+    optional: true
 
   expo-file-system@19.0.21(expo@54.0.33)(react-native@0.81.4(@babel/core@7.29.0)(@types/react@19.1.17)(react@19.1.0)):
     dependencies:
@@ -18696,6 +18701,7 @@ snapshots:
     dependencies:
       expo: 54.0.33(@babel/core@7.29.0)(@expo/metro-runtime@6.1.2)(expo-router@6.0.23)(graphql@16.12.0)(react-native@0.83.1(@babel/core@7.29.0)(@types/react@19.2.3)(react@19.2.4))(react@19.2.4)
       react-native: 0.83.1(@babel/core@7.29.0)(@types/react@19.2.3)(react@19.2.4)
+    optional: true
 
   expo-font@14.0.11(expo@54.0.33)(react-native@0.81.4(@babel/core@7.29.0)(@types/react@19.1.17)(react@19.1.0))(react@19.1.0):
     dependencies:
@@ -18710,6 +18716,7 @@ snapshots:
       fontfaceobserver: 2.3.0
       react: 19.2.4
       react-native: 0.83.1(@babel/core@7.29.0)(@types/react@19.2.3)(react@19.2.4)
+    optional: true
 
   expo-keep-awake@15.0.8(expo@54.0.33)(react@19.1.0):
     dependencies:
@@ -18720,6 +18727,7 @@ snapshots:
     dependencies:
       expo: 54.0.33(@babel/core@7.29.0)(@expo/metro-runtime@6.1.2)(expo-router@6.0.23)(graphql@16.12.0)(react-native@0.83.1(@babel/core@7.29.0)(@types/react@19.2.3)(react@19.2.4))(react@19.2.4)
       react: 19.2.4
+    optional: true
 
   expo-linking@8.0.11(expo@54.0.33)(react-native@0.81.4(@babel/core@7.29.0)(@types/react@19.1.17)(react@19.1.0))(react@19.1.0):
     dependencies:
@@ -18761,6 +18769,7 @@ snapshots:
       invariant: 2.2.4
       react: 19.2.4
       react-native: 0.83.1(@babel/core@7.29.0)(@types/react@19.2.3)(react@19.2.4)
+    optional: true
 
   expo-router@6.0.23(@expo/metro-runtime@6.1.2)(@types/react-dom@19.2.3(@types/react@19.1.17))(@types/react@19.1.17)(expo-constants@18.0.13)(expo-linking@8.0.11)(expo@54.0.33)(react-dom@19.2.4(react@19.1.0))(react-native-reanimated@4.2.1(react-native-worklets@0.7.2(@babel/core@7.29.0)(react-native@0.81.4(@babel/core@7.29.0)(@types/react@19.1.17)(react@19.1.0))(react@19.1.0))(react-native@0.81.4(@babel/core@7.29.0)(@types/react@19.1.17)(react@19.1.0))(react@19.1.0))(react-native-safe-area-context@5.4.0(react-native@0.81.4(@babel/core@7.29.0)(@types/react@19.1.17)(react@19.1.0))(react@19.1.0))(react-native-screens@4.11.1(react-native@0.81.4(@babel/core@7.29.0)(@types/react@19.1.17)(react@19.1.0))(react@19.1.0))(react-native@0.81.4(@babel/core@7.29.0)(@types/react@19.1.17)(react@19.1.0))(react@19.1.0):
     dependencies:
@@ -18923,6 +18932,7 @@ snapshots:
       - graphql
       - supports-color
       - utf-8-validate
+    optional: true
 
   exponential-backoff@3.1.3: {}
 

skills/json-render-react/SKILL.md

@@ -28,8 +28,7 @@ function App({ spec }) {
 
 ```typescript
 import { defineCatalog } from "@json-render/core";
-import { schema } from "@json-render/react/schema";
-import { defineRegistry } from "@json-render/react";
+import { schema, defineRegistry } from "@json-render/react";
 import { z } from "zod";
 
 // Create catalog with props schemas