json-render/packages/shadcn/CHANGELOG.md

@json-render/shadcn

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:

  // 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

• Updated dependencies [09376db]
  • @json-render/core@0.8.0
  • @json-render/react@0.8.0

0.7.0

Minor Changes

• 2d70fab: New @json-render/shadcn package, event handles, built-in actions, and stream improvements.

### New: @json-render/shadcn Package

Pre-built shadcn/ui component library for json-render. 30+ components built on Radix UI + Tailwind CSS, ready to use with defineCatalog and defineRegistry.

• shadcnComponentDefinitions — Zod-based catalog definitions for all components (server-safe, no React dependency via @json-render/shadcn/catalog)
• shadcnComponents — React implementations for all components
• 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
• Input: Button, Link, Input, Textarea, Select, Checkbox, Radio, Switch, Slider, Toggle, ToggleGroup, ButtonGroup

### 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

### 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.

### 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.

Patch Changes

• Updated dependencies [2d70fab]
  • @json-render/core@0.7.0
  • @json-render/react@0.7.0