@uniform-ts/core 0.0.6 → 0.0.8

package/README.md

@@ -45,7 +45,9 @@ UniForm introspects the schema, renders appropriate inputs, validates with Zod,
 
 **`createAutoForm(defaults)`** — factory that bakes in your design system defaults (components, classNames, fieldWrapper) once, so you don't repeat them on every form.
 
-**`components`** — a registry mapping Zod types (`string`, `number`, `boolean`, etc.) to your own input components. Pass a component directly on a field via `fields` for one-off overrides.
+**`useArrayField(fieldName)`** — a React hook for external array controls (toolbars, section headers, sticky footers) inside the `<AutoForm>` tree. It returns `append/remove/move/...` from `useFieldArray` plus `rowCount`, `canAdd`, and `atMin` derived from the array's `minItems`/`maxItems`.
+
+**`components`** — a registry mapping Zod types (`string`, `number`, `boolean`, etc.) to your own input components. Pass a component directly on a field via `fields` for one-off overrides. For custom components, type field values precisely with `FieldProps<Value>` (for example, `FieldProps<number>` for a rating widget).
 
 **`fields`** — per-field overrides using dot-notated paths. Control labels, descriptions, ordering, sections, conditions, and custom components without touching the schema.
 
@@ -64,31 +66,32 @@ UniForm introspects the schema, renders appropriate inputs, validates with Zod,
 
 ## Core Props
 
-| Prop            | Type                                     | Description                                                            |
-| --------------- | ---------------------------------------- | ---------------------------------------------------------------------- |
-| `form`          | `UniForm<TSchema>`                       | Schema + onChange handlers from `createForm()`                         |
-| `onSubmit`      | `(values) => void \| Promise<void>`      | Called with typed values after successful validation                   |
-| `defaultValues` | `Partial<...>` or `() => Promise<...>`   | Initial values; async function shows `loadingFallback`                 |
-| `components`    | `ComponentRegistry`                      | Map Zod types to your input components                                 |
-| `fields`        | `Record<string, FieldOverride>`          | Per-field label, description, order, section, condition                |
-| `fieldWrapper`  | `React.ComponentType<FieldWrapperProps>` | Custom wrapper around every scalar field                               |
-| `layout`        | `LayoutSlots`                            | Replace form/section/object/array wrappers, submit button, array rows  |
-| `classNames`    | `FormClassNames`                         | CSS classes for form, fields, labels, errors, fieldset/legend wrappers |
-| `ref`           | `React.Ref<AutoFormHandle>`              | Imperative `reset`, `submit`, `setValues`, `getValues`                 |
-| `persistKey`    | `string`                                 | Auto-save form state to `localStorage` under this key                  |
-| `labels`        | `FormLabels`                             | Override built-in UI strings for i18n                                  |
+| Prop            | Type                                     | Description                                                                                                                              |
+| --------------- | ---------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------- |
+| `form`          | `UniForm<TSchema>`                       | Schema + onChange handlers from `createForm()`                                                                                           |
+| `onSubmit`      | `(values) => void \| Promise<void>`      | Called with typed values after successful validation                                                                                     |
+| `defaultValues` | `Partial<...>` or `() => Promise<...>`   | Initial values; async function shows `loadingFallback`                                                                                   |
+| `components`    | `ComponentRegistry`                      | Map Zod types to your input components                                                                                                   |
+| `fields`        | `Record<string, FieldOverride>`          | Per-field label, description, order, section, condition                                                                                  |
+| `fieldWrapper`  | `React.ComponentType<FieldWrapperProps>` | Custom wrapper around every scalar field                                                                                                 |
+| `layout`        | `LayoutSlots`                            | Replace form/section/object/array wrappers, submit button, array rows. Set `null` on omittable slots (submit/array buttons) to hide them |
+| `classNames`    | `FormClassNames`                         | CSS classes for form, fields, labels, errors, fieldset/legend wrappers                                                                   |
+| `ref`           | `React.Ref<AutoFormHandle>`              | Imperative `reset`, `submit`, `setValues`, `getValues`                                                                                   |
+| `persistKey`    | `string`                                 | Auto-save form state to `localStorage` under this key                                                                                    |
+| `labels`        | `FormLabels`                             | Override built-in UI strings for i18n; import a ready-made locale pack from `@uniform-ts/core/locales/{en,he,es}`                        |
 
 ## Features
 
 - **Full Zod V4 support** — scalars, enums, objects, arrays, optionals, defaults, unions, discriminated unions
 - **react-hook-form** under the hood — performant, uncontrolled forms with `zodResolver`
 - **Section grouping** — group fields into named sections via `meta.section`
-- **Conditional fields** — show/hide fields based on form values; hidden fields reset to default
-- **Array fields** — movable, duplicable, collapsible rows; `minItems`/`maxItems` from Zod schema
+- **Conditional fields** — show/hide fields based on form values; `hidden` and row-local sibling conditions work inside array rows too
+- **Array fields** — movable, duplicable, collapsible rows; `minItems`/`maxItems` from Zod schema; per-row conditional fields
+- **External array controls** — use `useArrayField('path.to.array')` to place Add/Remove controls outside the default array block while staying in sync with schema limits
 - **Programmatic control** — `reset()`, `submit()`, `setValues()`, `getValues()`, `setErrors()`, `focus()` via ref
 - **Form persistence** — auto-save to `localStorage` (or custom storage) with configurable debounce
 - **Pluggable coercion** — automatic `string → number`, `string → Date` with customizable coercion map
-- **i18n** — override every hard-coded UI string via `labels` prop
+- **i18n** — override every hard-coded UI string (including aria labels) via `labels` prop; import a ready-made locale pack and optionally spread-override individual keys
 - **Tree-shakeable** — ESM + CJS builds via tsup
 
 ## Documentation