json-render/packages/react-native/CHANGELOG.md

@json-render/react-native

0.14.1

Patch Changes

• Updated dependencies [43b7515]
  • @json-render/core@0.14.1

0.14.0

Patch Changes

• Updated dependencies [a8afd8b]
  • @json-render/core@0.14.0

0.13.0

Patch Changes

• Updated dependencies [5b32de8]
  • @json-render/core@0.13.0

0.12.1

Patch Changes

• Updated dependencies [54a1ecf]
  • @json-render/core@0.12.1

0.12.0

Patch Changes

• Updated dependencies [63c339b]
  • @json-render/core@0.12.0

0.11.0

Patch Changes

• Updated dependencies [3f1e71e]
  • @json-render/core@0.11.0

0.10.0

Patch Changes

• Updated dependencies [9cef4e9]
  • @json-render/core@0.10.0

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:

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

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

0.7.0

Patch Changes

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

0.6.1

Patch Changes

• @json-render/core@0.6.1

0.6.1

Patch Changes

• Updated dependencies [ea97aff]
  • @json-render/core@0.6.1

0.6.0

Minor Changes

• 06b8745: Chat mode (inline GenUI), AI SDK integration, two-way binding, and expression-based visibility/props.

### New: Chat Mode (Inline GenUI)

Two generation modes: Generate (JSONL-only, the default) and Chat (text + JSONL inline). Chat mode lets AI respond conversationally with embedded UI specs — ideal for chatbots and copilot experiences.

• catalog.prompt({ mode: "chat" }) generates a chat-aware system prompt
• pipeJsonRender() server-side transform separates text from JSONL patches in a mixed stream
• createJsonRenderTransform() low-level TransformStream for custom pipelines

### 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
• createMixedStreamParser() for parsing mixed text + JSONL streams

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

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

### New: Expression-Based Props and Visibility

Replaced string token rewriting with structured expression objects:

• Props: { $state: "/path" }, { $item: "field" }, { $index: true }
• Visibility: { $state: "/path", eq: "value" }, { $item: "active" }, { $index: true, gt: 0 }
• Logic: { $and: [...] }, { $or: [...] }, and implicit AND via arrays
• Comparison operators: eq, neq, gt, gte, lt, lte, not

### New: Utilities

• applySpecPatch() — typed convenience wrapper for applying a single patch to a Spec
• nestedToFlat() — convert nested tree specs to flat { root, elements } format
• resolveBindings() / resolveActionParam() — resolve binding paths and action params

### New: Chat Example

Full-featured chat example (examples/chat) with AI agent, tool calls (crypto, GitHub, Hacker News, weather, search), theme toggle, and streaming UI generation.

### Improved: Renderer

• ElementRenderer is now React.memo'd for better performance in repeat lists
• emit is always defined (never undefined) — no more optional chaining needed
• Action params are resolved through resolveActionParam supporting $item, $index, $state
• Repeat scope now passes the actual item object instead of requiring token rewriting

### Breaking Changes

• Expressions renamed: { $path } / { path } replaced by { $state }, { $item }, { $index }
• Visibility conditions: { path } → { $state }, { and/or/not } → { $and/$or } with not as operator flag
• DynamicValue: { path: string } → { $state: string }
• Repeat field: repeat.path → repeat.statePath
• Action params: path → statePath in setState action params
• Provider props: actionHandlers → handlers on JSONUIProvider/ActionProvider
• Auth removed: AuthState type and { auth } visibility conditions removed — model auth as regular state
• Legacy catalog removed: createCatalog, generateCatalogPrompt, generateSystemPrompt, ComponentDefinition, CatalogConfig, SystemPromptOptions removed
• React exports removed: createRendererFromCatalog, rewriteRepeatTokens
• Codegen: traverseTree → traverseSpec, SpecVisitor → TreeVisitor

Patch Changes

• Updated dependencies [06b8745]
  • @json-render/core@0.6.0

0.5.2

Patch Changes

• 429e456: Fix LLM hallucinations by dynamically generating prompt examples from the user's catalog instead of hardcoding component names. Adds optional example field to ComponentDefinition with Zod schema introspection fallback. Mentions RFC 6902 in output format section.
• Updated dependencies [429e456]
  • @json-render/core@0.5.2

0.5.1

Patch Changes

• d9a4efd: Prevent rendering errors from crashing the application. Added error boundaries to all renderers so a single bad component silently disappears instead of causing a white-screen-of-death. Fixed Select and Radio components to handle non-string option values from AI output.
  • @json-render/core@0.5.1

0.5.0

Minor Changes

• 3d2d1ad: Add @json-render/react-native package, event system (emit replaces onAction), repeat/list rendering, user prompt builder, spec validation, and rename DataProvider to StateProvider.

Patch Changes

• Updated dependencies [3d2d1ad]
  • @json-render/core@0.5.0