@form-engine-ts/react 4.3.2 → 4.5.0

package/README.md

@@ -41,13 +41,24 @@ Use any compatible `TranslationAdapter` in place of the mock translator.
 
 ## Choice field layout
 
-Radio and checkbox questions use the flat layout by default. Set `appearance.choiceField` to `"grouped"` to render
-them as bordered, accessible `<fieldset>` groups with `<legend>` titles:
+Radio, checkbox, and multi-select questions use the flat layout by default. Set `appearance.choiceField` to `"grouped"`
+to render them as bordered, accessible `<fieldset>` groups with `<legend>` titles:
 
 ```tsx
 <FormRenderer appearance={{ choiceField: "grouped" }} />
 ```
 
+Use an object to configure each choice type independently. Unspecified types remain flat:
+
+```tsx
+<FormRenderer appearance={{ choiceField: { radio: "grouped", checkbox: "default" } }} />
+```
+
+Grouped wrappers can be replaced with `slots.renderChoiceGroup`; `slotProps.choiceGroup` accepts a class name and
+inline style for the default wrapper. The exported `ChoiceGroupSlotProps` includes the field, translated error, and
+option-list children. Group styling is controlled by the public `--fe-choice-group-*`, `--fe-choice-legend-*`, and
+`--fe-choice-options-gap` CSS custom properties.
+
 `groupedChoiceFields={true}` remains available as a deprecated compatibility alias.
 
 Define `schema.pages` to enable Back/Next navigation, page validation, conditional page skipping, and an accessible
@@ -62,6 +73,12 @@ on the next mount:
 membership controls and localization editors; pass an `AsyncTranslationAdapter` as `translationAdapter` to enable its
 batch-translation action.
 
+`useTranslationWorkspace` exposes locale management, translation slots, completion summaries, manual editing, and
+single-slot or batch translation with stale/manual status handling. The MUI package exports a ready-made
+`TranslationWorkspace` surface. For large forms, set `fieldEditorMode="single"` and use `activeFieldId` or the hook's
+`setActiveFieldId` to keep one field editor open at a time. Set `submissionSettingsOptions={{ enabled: true }}` to expose
+schema-driven pre-submit confirmation controls in the builder.
+
 ## Headless builder and renderer lifecycle
 
 `useFormBuilder({ schema, onChange, policy, idFactory, factories })` exposes controlled field, option, page, condition,