@form-engine-ts/react 2.1.1 → 2.3.0

package/README.md

@@ -55,7 +55,7 @@ batch-translation action.
 
 `useFormBuilder({ schema, onChange, policy, idFactory, factories })` exposes controlled field, option, page, condition,
 source-text, and localized-text actions. Core's `FormPolicy` enforces allowed field types, field/option limits, text and
-schema-byte limits, and required locales identically in browser and server code. Every mutation returns a typed
+schema-byte limits, and required/allowed/maximum locale constraints identically in browser and server code. Every mutation returns a typed
 `BuilderActionResult`; invalid, empty, or duplicate generated IDs leave the schema unchanged. `BuilderFactories` injects
 initial field, option, and page shapes. `<FormBuilder>` delegates its UI mutations to this hook and accepts the same
 options. Its completion-message editors cover both source and locale text. `translationOptions` and
@@ -67,6 +67,26 @@ Visual-builder field creation uses `defaultFieldType` when it is allowed, otherw
 per-locale/property metadata to manual edits. Automatic translation defaults to `overwrite: "missing-only"`; explicitly
 pass `{ overwrite: "all" }` to replace existing translations.
 
+Pass `readOnly` to keep the complete builder visible while disabling every mutation. The `features` prop independently
+controls `pages`, `localization`, and `conditions` authoring surfaces; each defaults to `true`. When `allowedLocales` is
+set, locale addition becomes a selector containing only unregistered allowed locales, and the action is disabled at
+`maxLocales`.
+
+Visual Builder has two independent design-system extension layers. `components` replaces normalized primitives such as
+`Button`, `TextInput`, `TextArea`, `Select`, `Checkbox`, `Section`, and `Fieldset`. `slots` replaces complete authoring
+surfaces: `toolbar`, `fieldEditor`, `optionEditor`, `pages`, `localization`, or `translationActions`. Slot props expose
+policy-aware `actions`; a custom `translationActions` slot can therefore call an application-specific AI mutation while
+the standard manual localization editors remain unchanged.
+
+```tsx
+<FormBuilder
+  schema={schema}
+  onChange={setSchema}
+  components={{ Button: MuiButtonAdapter, TextInput: MuiTextFieldAdapter }}
+  slots={{ translationActions: ArgsAiTranslationActions }}
+/>
+```
+
 `FormRenderer` can also be used without an explicit provider:
 
 ```tsx