@contractspec/lib.contracts-runtime-client-react 3.7.5 → 3.7.7

package/README.md

@@ -1,156 +1,63 @@
 # @contractspec/lib.contracts-runtime-client-react
 
-React runtime adapters for rendering ContractSpec forms and feature presentations.
+**React runtime adapters for ContractSpec contracts.**
 
-Website: https://contractspec.io/
+## What It Provides
 
-## Why this package exists
-
-This package is the React client runtime layer extracted from `@contractspec/lib.contracts`.
-
-It keeps rendering concerns separate from core contract definitions, while still preserving contract-first behavior:
-
-- render presentation specs through a transform engine
-- render form specs through pluggable UI driver slots
-- keep UI toolkit choice external (shadcn, RN reusable components, custom)
-
-## Package boundary (important)
-
-Use this package for:
-
-- Rendering `PresentationSpec` targets in React workflows.
-- Rendering `FormSpec` with `react-hook-form` and Zod resolver integration.
-- Bridging contract fields to your design-system components via `DriverSlots`.
-
-Do not use this package for:
-
-- Defining contracts (use `@contractspec/lib.contracts-spec`).
-- Owning your design-system components themselves.
+- **Layer**: lib.
+- **Consumers**: design-system, presentation-runtime-react, bundles.
+- Related ContractSpec packages include `@contractspec/lib.contracts-spec`, `@contractspec/lib.schema`, `@contractspec/tool.bun`, `@contractspec/tool.typescript`.
+- Related ContractSpec packages include `@contractspec/lib.contracts-spec`, `@contractspec/lib.schema`, `@contractspec/tool.bun`, `@contractspec/tool.typescript`.
 
 ## Installation
 
-```bash
-npm install @contractspec/lib.contracts-runtime-client-react @contractspec/lib.contracts-spec
-# or
-bun add @contractspec/lib.contracts-runtime-client-react @contractspec/lib.contracts-spec
-```
-
-Required peer dependencies:
-
-- `react`
-- `react-dom`
-- `react-hook-form`
-- `@hookform/resolvers`
-- `@blocknote/core`
-
-## Export map
-
-- Presentation helpers:
-  - `createEngineWithDefaults`
-  - `renderFeaturePresentation`
-  - `createFeatureModule`
-  - `registerFeature`
-- Form helpers:
-  - `createFormRenderer`
-  - `DriverSlots` (type)
-- Driver wrappers:
-  - `shadcnDriver`
-  - `rnReusablesDriver`
-
-## Quick start
-
-### Presentation rendering
-
-```ts
-import {
-  createEngineWithDefaults,
-  renderFeaturePresentation,
-} from "@contractspec/lib.contracts-runtime-client-react";
-import type { PresentationSpec } from "@contractspec/lib.contracts-spec/presentations";
-
-declare const presentation: PresentationSpec;
-
-const engine = createEngineWithDefaults();
-
-const markdownOutput = await renderFeaturePresentation(
-  engine,
-  "markdown",
-  presentation
-);
-
-console.log(markdownOutput);
-```
-
-### Form rendering with driver slots
-
-```tsx
-import {
-  createFormRenderer,
-  shadcnDriver,
-  type DriverSlots,
-} from "@contractspec/lib.contracts-runtime-client-react";
-import type { FormSpec } from "@contractspec/lib.contracts-spec/forms";
-
-declare const slots: DriverSlots;
-declare const formSpec: FormSpec;
-
-const renderer = createFormRenderer({
-  driver: shadcnDriver(slots),
-  onSubmitOverride: async (values, actionKey) => {
-    console.log("submit", actionKey, values);
-  },
-});
-
-export function ContractForm() {
-  return renderer.render(formSpec);
-}
-```
-
-## Driver model (key concept)
-
-`createFormRenderer` is UI-library agnostic.
-
-You provide a `DriverSlots` object (Field, Input, Select, Checkbox, RadioGroup, Switch, Button, etc.), and the runtime maps form contract field kinds (`text`, `textarea`, `select`, `group`, `array`, ...) to your components.
-
-This allows:
+`npm install @contractspec/lib.contracts-runtime-client-react`
 
-- shared form contract logic
-- custom visual identity per app
-- lower coupling between schema contracts and specific UI component libraries
+or
 
-## Runtime behavior details
+`bun add @contractspec/lib.contracts-runtime-client-react`
 
-- Entry point is client-oriented (`"use client"`).
-- Form renderer integrates with `react-hook-form` + Zod resolver.
-- Supports conditional visibility/enablement and relation predicates from form specs.
-- Supports static and resolver-based options for select/radio fields.
-- Supports array fields and nested/grouped field rendering.
+## Usage
 
-## AI assistant guidance
+Import the root entrypoint from `@contractspec/lib.contracts-runtime-client-react`, or choose a documented subpath when you only need one part of the package surface.
 
-When generating code:
+## Architecture
 
-- Use this package when task asks to render contract-defined forms or presentations in React.
-- Keep `DriverSlots` in app code so generated components stay design-system aligned.
-- For non-React targets, do not use this package; use transport/runtime packages that match the target.
+- `src/drivers` is part of the package's public or composition surface.
+- `src/feature-render.ts` is part of the package's public or composition surface.
+- `src/form-render.impl.tsx` is part of the package's public or composition surface.
+- `src/form-render.ts` is part of the package's public or composition surface.
+- `src/index.ts` is the root public barrel and package entrypoint.
 
-When debugging:
+## Public Entry Points
 
-- If form fields do not render, verify driver slot coverage for the field kind.
-- If resolver options stay empty, verify `resolverKey` and dependency paths in form contract.
+- Export `.` resolves through `./src/index.ts`.
+- Export `./drivers/rn-reusables` resolves through `./src/drivers/rn-reusables.ts`.
+- Export `./drivers/shadcn` resolves through `./src/drivers/shadcn.ts`.
+- Export `./feature-render` resolves through `./src/feature-render.ts`.
+- Export `./form-render` resolves through `./src/form-render.ts`.
+- Export `./form-render.impl` resolves through `./src/form-render.impl.tsx`.
 
-## Surface-runtime slot integration
+## Local Commands
 
-When using `@contractspec/lib.surface-runtime`, feature and form renderers can fill slots (e.g. `entity-section`, `form`, `entity-field`):
+- `bun run dev` — contractspec-bun-build dev
+- `bun run build` — bun run prebuild && bun run build:bundle && bun run build:types
+- `bun run lint` — bun run lint:fix
+- `bun run lint:check` — biome check .
+- `bun run lint:fix` — biome check --write --unsafe --only=nursery/useSortedClasses . && biome check --write .
+- `bun run typecheck` — tsc --noEmit
+- `bun run publish:pkg` — bun publish --tolerate-republish --ignore-scripts --verbose
+- `bun run publish:pkg:canary` — bun publish:pkg --tag canary
+- `bun run clean` — rm -rf dist
+- `bun run build:bundle` — contractspec-bun-build transpile
+- `bun run build:types` — contractspec-bun-build types
+- `bun run prebuild` — contractspec-bun-build prebuild
 
-1. **Slot content**: Pass `FeatureRender` output or form components as `slotContent` to `BundleRenderer` for slots that `accepts` include `form` or `entity-section`.
-2. **Field renderer registry**: Register custom field renderers via `@contractspec/lib.surface-runtime/runtime/field-renderer-registry` so entity fields render correctly in surface slots.
-3. **Widget registry**: For `custom-widget` slots, wire your form or feature components through the widget registry.
+## Recent Updates
 
-Example: a slot with `accepts: ['form', 'entity-section']` can render `createFormRenderer(...).render(formSpec)` or `renderFeaturePresentation` output as its content.
+- Replace eslint+prettier by biomejs to optimize speed.
 
-## Split migration from deprecated monolith
+## Notes
 
-- `@contractspec/lib.contracts/client/react/feature-render` -> `@contractspec/lib.contracts-runtime-client-react/feature-render`
-- `@contractspec/lib.contracts/client/react/form-render` -> `@contractspec/lib.contracts-runtime-client-react/form-render`
-- `@contractspec/lib.contracts/client/react/drivers/*` -> `@contractspec/lib.contracts-runtime-client-react/drivers/*`
+- Driver interface must stay compatible with both shadcn and RN Reusables.
+- Form rendering pipeline is a critical path; test thoroughly before changing.

package/dist/browser/feature-render.js

@@ -1,10 +1,10 @@
 // src/feature-render.ts
-import React from "react";
 import {
   createDefaultTransformEngine,
   registerBasicValidation,
   registerDefaultReactRenderer
 } from "@contractspec/lib.contracts-spec/presentations/transform-engine";
+import React from "react";
 function createEngineWithDefaults() {
   return registerBasicValidation(registerDefaultReactRenderer(createDefaultTransformEngine()));
 }

package/dist/browser/form-render.impl.js

@@ -1,15 +1,15 @@
 // src/form-render.impl.tsx
+import {
+  buildZodWithRelations,
+  evalPredicate
+} from "@contractspec/lib.contracts-spec/forms";
+import { zodResolver } from "@hookform/resolvers/zod";
 import React, { useEffect, useMemo, useState } from "react";
 import {
   Controller,
   useFieldArray,
   useForm
 } from "react-hook-form";
-import { zodResolver } from "@hookform/resolvers/zod";
-import {
-  buildZodWithRelations,
-  evalPredicate
-} from "@contractspec/lib.contracts-spec/forms";
 import { jsxDEV, Fragment } from "react/jsx-dev-runtime";
 "use client";
 function toOptionsArray(src) {

package/dist/browser/form-render.js

@@ -1,15 +1,15 @@
 // src/form-render.impl.tsx
+import {
+  buildZodWithRelations,
+  evalPredicate
+} from "@contractspec/lib.contracts-spec/forms";
+import { zodResolver } from "@hookform/resolvers/zod";
 import React, { useEffect, useMemo, useState } from "react";
 import {
   Controller,
   useFieldArray,
   useForm
 } from "react-hook-form";
-import { zodResolver } from "@hookform/resolvers/zod";
-import {
-  buildZodWithRelations,
-  evalPredicate
-} from "@contractspec/lib.contracts-spec/forms";
 import { jsxDEV, Fragment } from "react/jsx-dev-runtime";
 "use client";
 function toOptionsArray(src) {

package/dist/browser/index.js

@@ -9,12 +9,12 @@ function shadcnDriver(slots) {
 }
 
 // src/feature-render.ts
-import React from "react";
 import {
   createDefaultTransformEngine,
   registerBasicValidation,
   registerDefaultReactRenderer
 } from "@contractspec/lib.contracts-spec/presentations/transform-engine";
+import React from "react";
 function createEngineWithDefaults() {
   return registerBasicValidation(registerDefaultReactRenderer(createDefaultTransformEngine()));
 }
@@ -56,17 +56,17 @@ function registerFeature(registry, feature) {
 }
 
 // src/form-render.impl.tsx
+import {
+  buildZodWithRelations,
+  evalPredicate
+} from "@contractspec/lib.contracts-spec/forms";
+import { zodResolver } from "@hookform/resolvers/zod";
 import React2, { useEffect, useMemo, useState } from "react";
 import {
   Controller,
   useFieldArray,
   useForm
 } from "react-hook-form";
-import { zodResolver } from "@hookform/resolvers/zod";
-import {
-  buildZodWithRelations,
-  evalPredicate
-} from "@contractspec/lib.contracts-spec/forms";
 import { jsxDEV, Fragment } from "react/jsx-dev-runtime";
 "use client";
 function toOptionsArray(src) {

package/dist/feature-render.d.ts

@@ -1,8 +1,8 @@
-import React from 'react';
+import type { BlockConfig } from '@blocknote/core';
+import { type FeatureModuleSpec, FeatureRegistry } from '@contractspec/lib.contracts-spec/features';
 import type { PresentationSpec, PresentationTarget } from '@contractspec/lib.contracts-spec/presentations';
 import { type ComponentMap, TransformEngine } from '@contractspec/lib.contracts-spec/presentations/transform-engine';
-import { type FeatureModuleSpec, FeatureRegistry } from '@contractspec/lib.contracts-spec/features';
-import type { BlockConfig } from '@blocknote/core';
+import React from 'react';
 export declare function createEngineWithDefaults(): TransformEngine;
 export declare function renderFeaturePresentation(engine: TransformEngine, target: PresentationTarget, desc: PresentationSpec, options?: {
     componentMap?: ComponentMap;

package/dist/feature-render.js

@@ -1,11 +1,11 @@
 // @bun
 // src/feature-render.ts
-import React from "react";
 import {
   createDefaultTransformEngine,
   registerBasicValidation,
   registerDefaultReactRenderer
 } from "@contractspec/lib.contracts-spec/presentations/transform-engine";
+import React from "react";
 function createEngineWithDefaults() {
   return registerBasicValidation(registerDefaultReactRenderer(createDefaultTransformEngine()));
 }

package/dist/form-render.impl.d.ts

@@ -1,6 +1,6 @@
-import React from 'react';
 import type { FormOption, FormSpec, FormValuesFor } from '@contractspec/lib.contracts-spec/forms';
 import type { AnySchemaModel } from '@contractspec/lib.schema';
+import React from 'react';
 export interface DriverSlots {
     Field: React.ComponentType<React.PropsWithChildren<{
         'data-invalid'?: boolean;

package/dist/form-render.impl.js

@@ -1,16 +1,16 @@
 // @bun
 // src/form-render.impl.tsx
+import {
+  buildZodWithRelations,
+  evalPredicate
+} from "@contractspec/lib.contracts-spec/forms";
+import { zodResolver } from "@hookform/resolvers/zod";
 import React, { useEffect, useMemo, useState } from "react";
 import {
   Controller,
   useFieldArray,
   useForm
 } from "react-hook-form";
-import { zodResolver } from "@hookform/resolvers/zod";
-import {
-  buildZodWithRelations,
-  evalPredicate
-} from "@contractspec/lib.contracts-spec/forms";
 import { jsxDEV, Fragment } from "react/jsx-dev-runtime";
 "use client";
 function toOptionsArray(src) {

package/dist/form-render.js

@@ -1,16 +1,16 @@
 // @bun
 // src/form-render.impl.tsx
+import {
+  buildZodWithRelations,
+  evalPredicate
+} from "@contractspec/lib.contracts-spec/forms";
+import { zodResolver } from "@hookform/resolvers/zod";
 import React, { useEffect, useMemo, useState } from "react";
 import {
   Controller,
   useFieldArray,
   useForm
 } from "react-hook-form";
-import { zodResolver } from "@hookform/resolvers/zod";
-import {
-  buildZodWithRelations,
-  evalPredicate
-} from "@contractspec/lib.contracts-spec/forms";
 import { jsxDEV, Fragment } from "react/jsx-dev-runtime";
 "use client";
 function toOptionsArray(src) {

package/dist/index.d.ts

@@ -1,4 +1,4 @@
+export * from './drivers/rn-reusables';
+export * from './drivers/shadcn';
 export * from './feature-render';
 export * from './form-render';
-export * from './drivers/shadcn';
-export * from './drivers/rn-reusables';

package/dist/index.js

@@ -10,12 +10,12 @@ function shadcnDriver(slots) {
 }
 
 // src/feature-render.ts
-import React from "react";
 import {
   createDefaultTransformEngine,
   registerBasicValidation,
   registerDefaultReactRenderer
 } from "@contractspec/lib.contracts-spec/presentations/transform-engine";
+import React from "react";
 function createEngineWithDefaults() {
   return registerBasicValidation(registerDefaultReactRenderer(createDefaultTransformEngine()));
 }
@@ -57,17 +57,17 @@ function registerFeature(registry, feature) {
 }
 
 // src/form-render.impl.tsx
+import {
+  buildZodWithRelations,
+  evalPredicate
+} from "@contractspec/lib.contracts-spec/forms";
+import { zodResolver } from "@hookform/resolvers/zod";
 import React2, { useEffect, useMemo, useState } from "react";
 import {
   Controller,
   useFieldArray,
   useForm
 } from "react-hook-form";
-import { zodResolver } from "@hookform/resolvers/zod";
-import {
-  buildZodWithRelations,
-  evalPredicate
-} from "@contractspec/lib.contracts-spec/forms";
 import { jsxDEV, Fragment } from "react/jsx-dev-runtime";
 "use client";
 function toOptionsArray(src) {

package/dist/node/feature-render.js

@@ -1,10 +1,10 @@
 // src/feature-render.ts
-import React from "react";
 import {
   createDefaultTransformEngine,
   registerBasicValidation,
   registerDefaultReactRenderer
 } from "@contractspec/lib.contracts-spec/presentations/transform-engine";
+import React from "react";
 function createEngineWithDefaults() {
   return registerBasicValidation(registerDefaultReactRenderer(createDefaultTransformEngine()));
 }

package/dist/node/form-render.impl.js

@@ -1,15 +1,15 @@
 // src/form-render.impl.tsx
+import {
+  buildZodWithRelations,
+  evalPredicate
+} from "@contractspec/lib.contracts-spec/forms";
+import { zodResolver } from "@hookform/resolvers/zod";
 import React, { useEffect, useMemo, useState } from "react";
 import {
   Controller,
   useFieldArray,
   useForm
 } from "react-hook-form";
-import { zodResolver } from "@hookform/resolvers/zod";
-import {
-  buildZodWithRelations,
-  evalPredicate
-} from "@contractspec/lib.contracts-spec/forms";
 import { jsxDEV, Fragment } from "react/jsx-dev-runtime";
 "use client";
 function toOptionsArray(src) {

package/dist/node/form-render.js

@@ -1,15 +1,15 @@
 // src/form-render.impl.tsx
+import {
+  buildZodWithRelations,
+  evalPredicate
+} from "@contractspec/lib.contracts-spec/forms";
+import { zodResolver } from "@hookform/resolvers/zod";
 import React, { useEffect, useMemo, useState } from "react";
 import {
   Controller,
   useFieldArray,
   useForm
 } from "react-hook-form";
-import { zodResolver } from "@hookform/resolvers/zod";
-import {
-  buildZodWithRelations,
-  evalPredicate
-} from "@contractspec/lib.contracts-spec/forms";
 import { jsxDEV, Fragment } from "react/jsx-dev-runtime";
 "use client";
 function toOptionsArray(src) {

package/dist/node/index.js

@@ -9,12 +9,12 @@ function shadcnDriver(slots) {
 }
 
 // src/feature-render.ts
-import React from "react";
 import {
   createDefaultTransformEngine,
   registerBasicValidation,
   registerDefaultReactRenderer
 } from "@contractspec/lib.contracts-spec/presentations/transform-engine";
+import React from "react";
 function createEngineWithDefaults() {
   return registerBasicValidation(registerDefaultReactRenderer(createDefaultTransformEngine()));
 }
@@ -56,17 +56,17 @@ function registerFeature(registry, feature) {
 }
 
 // src/form-render.impl.tsx
+import {
+  buildZodWithRelations,
+  evalPredicate
+} from "@contractspec/lib.contracts-spec/forms";
+import { zodResolver } from "@hookform/resolvers/zod";
 import React2, { useEffect, useMemo, useState } from "react";
 import {
   Controller,
   useFieldArray,
   useForm
 } from "react-hook-form";
-import { zodResolver } from "@hookform/resolvers/zod";
-import {
-  buildZodWithRelations,
-  evalPredicate
-} from "@contractspec/lib.contracts-spec/forms";
 import { jsxDEV, Fragment } from "react/jsx-dev-runtime";
 "use client";
 function toOptionsArray(src) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@contractspec/lib.contracts-runtime-client-react",
-  "version": "3.7.5",
+  "version": "3.7.7",
   "description": "React runtime adapters for ContractSpec contracts",
   "type": "module",
   "types": "./dist/index.d.ts",
@@ -9,8 +9,8 @@
     "publish:pkg:canary": "bun publish:pkg --tag canary",
     "clean": "rm -rf dist",
     "lint": "bun run lint:fix",
-    "lint:fix": "eslint src --fix",
-    "lint:check": "eslint src",
+    "lint:fix": "biome check --write --unsafe --only=nursery/useSortedClasses . && biome check --write .",
+    "lint:check": "biome check .",
     "build": "bun run prebuild && bun run build:bundle && bun run build:types",
     "build:bundle": "contractspec-bun-build transpile",
     "build:types": "contractspec-bun-build types",
@@ -31,13 +31,13 @@
     "react-hook-form": "^7.70.0"
   },
   "dependencies": {
-    "@contractspec/lib.contracts-spec": "3.7.5",
-    "@contractspec/lib.schema": "3.7.5"
+    "@contractspec/lib.contracts-spec": "4.0.0",
+    "@contractspec/lib.schema": "3.7.6"
   },
   "devDependencies": {
-    "@contractspec/tool.typescript": "3.7.5",
+    "@contractspec/tool.typescript": "3.7.6",
     "typescript": "^5.9.3",
-    "@contractspec/tool.bun": "3.7.5"
+    "@contractspec/tool.bun": "3.7.6"
   },
   "files": [
     "dist",