@uniform-ts/core 0.0.7 → 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,27 +66,28 @@ 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; import a ready-made locale pack from `@uniform-ts/core/locales/{en,he,es}` |
+| 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

package/dist/{field-DPgaGkOL.d.mts → field-KKjnXn-d.d.mts}

@@ -35,6 +35,23 @@ type DeepKeys<T> = T extends object ? {
  * // DeepFieldValue<{ name: string; items: { qty: number }[] }, 'items.qty'> → number
  */
 type DeepFieldValue<T, K extends string> = K extends keyof T ? T[K] : K extends `${infer Head}.${infer Tail}` ? Head extends keyof T ? T[Head] extends (infer Item)[] ? DeepFieldValue<NonNullable<Item>, Tail> : DeepFieldValue<NonNullable<T[Head]>, Tail> : unknown : unknown;
+/**
+ * Resolves the values type that a `setCondition` predicate receives for a
+ * given field key `K` within form values type `TValues`.
+ *
+ * - **Array item fields** (e.g. `"tasks.note"`): the predicate receives the
+ *   array item type (`{ title, priority, note }`), enabling row-local sibling
+ *   conditions like `(row) => row.priority === 'high'`.
+ * - **All other fields**: the predicate receives the full form values type.
+ *
+ * @example
+ * // ConditionValues<{ name: string; tasks: { priority: string; note: string }[] }, 'tasks.note'>
+ * // → { priority: string; note: string }
+ *
+ * // ConditionValues<{ name: string; address: { street: string } }, 'address.street'>
+ * // → { name: string; address: { street: string } }   (full form — not an array)
+ */
+type ConditionValues<TValues, K extends string> = K extends `${infer Head}.${string}` ? Head extends keyof TValues ? TValues[Head] extends readonly (infer Item)[] ? Item : TValues : TValues : TValues;
 
 /**
  * A single option entry used in `select` / enum fields.
@@ -140,8 +157,8 @@ interface ArrayRowLayoutProps {
         moveDown: React$1.ReactNode | null;
         /** Button to duplicate the row, or `null` if at max items. */
         duplicate: React$1.ReactNode | null;
-        /** Button to remove the row. */
-        remove: React$1.ReactNode;
+        /** Button to remove the row, or `null` when omitted via layout slot. */
+        remove: React$1.ReactNode | null;
         /** Button to collapse/expand the row, or `null` if collapsing is disabled. */
         collapse: React$1.ReactNode | null;
     };
@@ -195,6 +212,7 @@ interface SubmitButtonProps {
     isSubmitting: boolean;
     label: string;
 }
+type OptionalSlotComponent<TProps> = React$1.ComponentType<TProps> | null;
 /**
  * Per-section styling overrides forwarded to the `sectionWrapper` component.
  * Keys are section titles; values control how that section wrapper is styled.
@@ -212,35 +230,35 @@ type SectionConfig = {
  * itself falls back to a plain `<button>`.
  */
 type ArrayButtonSlots = {
-    /** Used for every array button that has no specific override. */
-    base?: React$1.ComponentType<ArrayButtonProps>;
-    /** Override for the add-row button only. */
-    add?: React$1.ComponentType<ArrayButtonProps>;
-    /** Override for the remove-row button only. */
-    remove?: React$1.ComponentType<ArrayButtonProps>;
-    /** Override for the move-up button only. */
-    moveUp?: React$1.ComponentType<ArrayButtonProps>;
-    /** Override for the move-down button only. */
-    moveDown?: React$1.ComponentType<ArrayButtonProps>;
-    /** Override for the duplicate-row button only. */
-    duplicate?: React$1.ComponentType<ArrayButtonProps>;
+    /** Used for every array button that has no specific override. Set to `null` to omit all unspecified buttons. */
+    base?: OptionalSlotComponent<ArrayButtonProps>;
+    /** Override for the add-row button only. Set to `null` to omit. */
+    add?: OptionalSlotComponent<ArrayButtonProps>;
+    /** Override for the remove-row button only. Set to `null` to omit. */
+    remove?: OptionalSlotComponent<ArrayButtonProps>;
+    /** Override for the move-up button only. Set to `null` to omit. */
+    moveUp?: OptionalSlotComponent<ArrayButtonProps>;
+    /** Override for the move-down button only. Set to `null` to omit. */
+    moveDown?: OptionalSlotComponent<ArrayButtonProps>;
+    /** Override for the duplicate-row button only. Set to `null` to omit. */
+    duplicate?: OptionalSlotComponent<ArrayButtonProps>;
     /**
      * Override for the collapse/expand toggle button only.
      * Receives `isCollapsed` in addition to standard `ArrayButtonProps`.
      */
-    collapse?: React$1.ComponentType<ArrayCollapseButtonProps>;
+    collapse?: OptionalSlotComponent<ArrayCollapseButtonProps>;
 };
 /**
  * Resolved button slots where every entry is guaranteed to be defined.
  */
 type ResolvedArrayButtonSlots = {
-    base: React$1.ComponentType<ArrayButtonProps>;
-    add: React$1.ComponentType<ArrayButtonProps>;
-    remove: React$1.ComponentType<ArrayButtonProps>;
-    moveUp: React$1.ComponentType<ArrayButtonProps>;
-    moveDown: React$1.ComponentType<ArrayButtonProps>;
-    duplicate: React$1.ComponentType<ArrayButtonProps>;
-    collapse: React$1.ComponentType<ArrayCollapseButtonProps>;
+    base: OptionalSlotComponent<ArrayButtonProps>;
+    add: OptionalSlotComponent<ArrayButtonProps>;
+    remove: OptionalSlotComponent<ArrayButtonProps>;
+    moveUp: OptionalSlotComponent<ArrayButtonProps>;
+    moveDown: OptionalSlotComponent<ArrayButtonProps>;
+    duplicate: OptionalSlotComponent<ArrayButtonProps>;
+    collapse: OptionalSlotComponent<ArrayCollapseButtonProps>;
 };
 /**
  * Optional layout slot overrides for top-level structural components of the
@@ -252,8 +270,8 @@ type LayoutSlots = {
     formWrapper?: React$1.ComponentType<FormWrapperProps>;
     /** Wrapper rendered around each named field section. */
     sectionWrapper?: React$1.ComponentType<SectionWrapperProps>;
-    /** Custom submit button component. */
-    submitButton?: React$1.ComponentType<SubmitButtonProps>;
+    /** Custom submit button component. Set to `null` to omit rendering it. */
+    submitButton?: OptionalSlotComponent<SubmitButtonProps>;
     /** Custom layout component for individual rows in array fields. */
     arrayRowLayout?: React$1.ComponentType<ArrayRowLayoutProps>;
     /**
@@ -295,7 +313,7 @@ type LayoutSlots = {
 type ResolvedLayoutSlots = {
     formWrapper: React$1.ComponentType<FormWrapperProps>;
     sectionWrapper: React$1.ComponentType<SectionWrapperProps>;
-    submitButton: React$1.ComponentType<SubmitButtonProps>;
+    submitButton: OptionalSlotComponent<SubmitButtonProps>;
     arrayRowLayout: React$1.ComponentType<ArrayRowLayoutProps>;
     arrayFieldLayout: React$1.ComponentType<ArrayFieldLayoutProps>;
     objectWrapper: React$1.ComponentType<ObjectWrapperProps>;
@@ -680,13 +698,13 @@ type FieldConfig = FieldConfigBase & ({
  * value, change/blur handlers, and all resolved UI metadata needed to render
  * a single field.
  */
-interface FieldProps {
+interface FieldProps<Value = unknown> {
     /** Dot-notated field path (e.g. `"address.street"`). */
     name: string;
     /** The current field value. */
-    value: unknown;
+    value: Value;
     /** Callback to update the field value. */
-    onChange: (value: unknown) => void;
+    onChange: (value: Value) => void;
     /** Callback fired when the field loses focus. */
     onBlur: () => void;
     /** Ref callback for registering the DOM element with `react-hook-form`. */
@@ -727,4 +745,4 @@ type FieldOverride<TSchema extends z.$ZodObject = z.$ZodObject, TValue = unknown
     [key: string]: unknown;
 };
 
-export type { AutoFormProps as A, ComponentRegistry as C, DeepKeys as D, FieldMetaBase as F, LayoutSlots as L, ObjectWrapperProps as O, PersistStorage as P, ResolvedLayoutSlots as R, SectionConfig as S, ValidationMessages as V, FieldConfig as a, AutoFormHandle as b, FieldProps as c, FieldWrapperProps as d, ArrayButtonProps as e, ArrayCollapseButtonProps as f, ArrayFieldLayoutProps as g, ArrayRowLayoutProps as h, ArrayWrapperProps as i, AutoFormConfig as j, FormMethods as k, FieldDependencyResult as l, DeepFieldValue as m, FormClassNames as n, CoercionMap as o, FormLabels as p, ArrayButtonSlots as q, FieldCondition as r, FieldMeta as s, FieldOverride as t, FieldType as u, FormWrapperProps as v, ResolvedArrayButtonSlots as w, SectionWrapperProps as x, SelectOption as y, SubmitButtonProps as z };
+export type { AutoFormProps as A, SubmitButtonProps as B, ComponentRegistry as C, DeepKeys as D, FieldMetaBase as F, LayoutSlots as L, ObjectWrapperProps as O, PersistStorage as P, ResolvedLayoutSlots as R, SectionConfig as S, ValidationMessages as V, FieldConfig as a, AutoFormHandle as b, FieldProps as c, FieldWrapperProps as d, ArrayButtonProps as e, ArrayCollapseButtonProps as f, ArrayFieldLayoutProps as g, ArrayRowLayoutProps as h, ArrayWrapperProps as i, AutoFormConfig as j, FormMethods as k, FieldDependencyResult as l, DeepFieldValue as m, ConditionValues as n, FormClassNames as o, CoercionMap as p, FormLabels as q, ArrayButtonSlots as r, FieldCondition as s, FieldMeta as t, FieldOverride as u, FieldType as v, FormWrapperProps as w, ResolvedArrayButtonSlots as x, SectionWrapperProps as y, SelectOption as z };

package/dist/{field-DPgaGkOL.d.ts → field-KKjnXn-d.d.ts}

@@ -35,6 +35,23 @@ type DeepKeys<T> = T extends object ? {
  * // DeepFieldValue<{ name: string; items: { qty: number }[] }, 'items.qty'> → number
  */
 type DeepFieldValue<T, K extends string> = K extends keyof T ? T[K] : K extends `${infer Head}.${infer Tail}` ? Head extends keyof T ? T[Head] extends (infer Item)[] ? DeepFieldValue<NonNullable<Item>, Tail> : DeepFieldValue<NonNullable<T[Head]>, Tail> : unknown : unknown;
+/**
+ * Resolves the values type that a `setCondition` predicate receives for a
+ * given field key `K` within form values type `TValues`.
+ *
+ * - **Array item fields** (e.g. `"tasks.note"`): the predicate receives the
+ *   array item type (`{ title, priority, note }`), enabling row-local sibling
+ *   conditions like `(row) => row.priority === 'high'`.
+ * - **All other fields**: the predicate receives the full form values type.
+ *
+ * @example
+ * // ConditionValues<{ name: string; tasks: { priority: string; note: string }[] }, 'tasks.note'>
+ * // → { priority: string; note: string }
+ *
+ * // ConditionValues<{ name: string; address: { street: string } }, 'address.street'>
+ * // → { name: string; address: { street: string } }   (full form — not an array)
+ */
+type ConditionValues<TValues, K extends string> = K extends `${infer Head}.${string}` ? Head extends keyof TValues ? TValues[Head] extends readonly (infer Item)[] ? Item : TValues : TValues : TValues;
 
 /**
  * A single option entry used in `select` / enum fields.
@@ -140,8 +157,8 @@ interface ArrayRowLayoutProps {
         moveDown: React$1.ReactNode | null;
         /** Button to duplicate the row, or `null` if at max items. */
         duplicate: React$1.ReactNode | null;
-        /** Button to remove the row. */
-        remove: React$1.ReactNode;
+        /** Button to remove the row, or `null` when omitted via layout slot. */
+        remove: React$1.ReactNode | null;
         /** Button to collapse/expand the row, or `null` if collapsing is disabled. */
         collapse: React$1.ReactNode | null;
     };
@@ -195,6 +212,7 @@ interface SubmitButtonProps {
     isSubmitting: boolean;
     label: string;
 }
+type OptionalSlotComponent<TProps> = React$1.ComponentType<TProps> | null;
 /**
  * Per-section styling overrides forwarded to the `sectionWrapper` component.
  * Keys are section titles; values control how that section wrapper is styled.
@@ -212,35 +230,35 @@ type SectionConfig = {
  * itself falls back to a plain `<button>`.
  */
 type ArrayButtonSlots = {
-    /** Used for every array button that has no specific override. */
-    base?: React$1.ComponentType<ArrayButtonProps>;
-    /** Override for the add-row button only. */
-    add?: React$1.ComponentType<ArrayButtonProps>;
-    /** Override for the remove-row button only. */
-    remove?: React$1.ComponentType<ArrayButtonProps>;
-    /** Override for the move-up button only. */
-    moveUp?: React$1.ComponentType<ArrayButtonProps>;
-    /** Override for the move-down button only. */
-    moveDown?: React$1.ComponentType<ArrayButtonProps>;
-    /** Override for the duplicate-row button only. */
-    duplicate?: React$1.ComponentType<ArrayButtonProps>;
+    /** Used for every array button that has no specific override. Set to `null` to omit all unspecified buttons. */
+    base?: OptionalSlotComponent<ArrayButtonProps>;
+    /** Override for the add-row button only. Set to `null` to omit. */
+    add?: OptionalSlotComponent<ArrayButtonProps>;
+    /** Override for the remove-row button only. Set to `null` to omit. */
+    remove?: OptionalSlotComponent<ArrayButtonProps>;
+    /** Override for the move-up button only. Set to `null` to omit. */
+    moveUp?: OptionalSlotComponent<ArrayButtonProps>;
+    /** Override for the move-down button only. Set to `null` to omit. */
+    moveDown?: OptionalSlotComponent<ArrayButtonProps>;
+    /** Override for the duplicate-row button only. Set to `null` to omit. */
+    duplicate?: OptionalSlotComponent<ArrayButtonProps>;
     /**
      * Override for the collapse/expand toggle button only.
      * Receives `isCollapsed` in addition to standard `ArrayButtonProps`.
      */
-    collapse?: React$1.ComponentType<ArrayCollapseButtonProps>;
+    collapse?: OptionalSlotComponent<ArrayCollapseButtonProps>;
 };
 /**
  * Resolved button slots where every entry is guaranteed to be defined.
  */
 type ResolvedArrayButtonSlots = {
-    base: React$1.ComponentType<ArrayButtonProps>;
-    add: React$1.ComponentType<ArrayButtonProps>;
-    remove: React$1.ComponentType<ArrayButtonProps>;
-    moveUp: React$1.ComponentType<ArrayButtonProps>;
-    moveDown: React$1.ComponentType<ArrayButtonProps>;
-    duplicate: React$1.ComponentType<ArrayButtonProps>;
-    collapse: React$1.ComponentType<ArrayCollapseButtonProps>;
+    base: OptionalSlotComponent<ArrayButtonProps>;
+    add: OptionalSlotComponent<ArrayButtonProps>;
+    remove: OptionalSlotComponent<ArrayButtonProps>;
+    moveUp: OptionalSlotComponent<ArrayButtonProps>;
+    moveDown: OptionalSlotComponent<ArrayButtonProps>;
+    duplicate: OptionalSlotComponent<ArrayButtonProps>;
+    collapse: OptionalSlotComponent<ArrayCollapseButtonProps>;
 };
 /**
  * Optional layout slot overrides for top-level structural components of the
@@ -252,8 +270,8 @@ type LayoutSlots = {
     formWrapper?: React$1.ComponentType<FormWrapperProps>;
     /** Wrapper rendered around each named field section. */
     sectionWrapper?: React$1.ComponentType<SectionWrapperProps>;
-    /** Custom submit button component. */
-    submitButton?: React$1.ComponentType<SubmitButtonProps>;
+    /** Custom submit button component. Set to `null` to omit rendering it. */
+    submitButton?: OptionalSlotComponent<SubmitButtonProps>;
     /** Custom layout component for individual rows in array fields. */
     arrayRowLayout?: React$1.ComponentType<ArrayRowLayoutProps>;
     /**
@@ -295,7 +313,7 @@ type LayoutSlots = {
 type ResolvedLayoutSlots = {
     formWrapper: React$1.ComponentType<FormWrapperProps>;
     sectionWrapper: React$1.ComponentType<SectionWrapperProps>;
-    submitButton: React$1.ComponentType<SubmitButtonProps>;
+    submitButton: OptionalSlotComponent<SubmitButtonProps>;
     arrayRowLayout: React$1.ComponentType<ArrayRowLayoutProps>;
     arrayFieldLayout: React$1.ComponentType<ArrayFieldLayoutProps>;
     objectWrapper: React$1.ComponentType<ObjectWrapperProps>;
@@ -680,13 +698,13 @@ type FieldConfig = FieldConfigBase & ({
  * value, change/blur handlers, and all resolved UI metadata needed to render
  * a single field.
  */
-interface FieldProps {
+interface FieldProps<Value = unknown> {
     /** Dot-notated field path (e.g. `"address.street"`). */
     name: string;
     /** The current field value. */
-    value: unknown;
+    value: Value;
     /** Callback to update the field value. */
-    onChange: (value: unknown) => void;
+    onChange: (value: Value) => void;
     /** Callback fired when the field loses focus. */
     onBlur: () => void;
     /** Ref callback for registering the DOM element with `react-hook-form`. */
@@ -727,4 +745,4 @@ type FieldOverride<TSchema extends z.$ZodObject = z.$ZodObject, TValue = unknown
     [key: string]: unknown;
 };
 
-export type { AutoFormProps as A, ComponentRegistry as C, DeepKeys as D, FieldMetaBase as F, LayoutSlots as L, ObjectWrapperProps as O, PersistStorage as P, ResolvedLayoutSlots as R, SectionConfig as S, ValidationMessages as V, FieldConfig as a, AutoFormHandle as b, FieldProps as c, FieldWrapperProps as d, ArrayButtonProps as e, ArrayCollapseButtonProps as f, ArrayFieldLayoutProps as g, ArrayRowLayoutProps as h, ArrayWrapperProps as i, AutoFormConfig as j, FormMethods as k, FieldDependencyResult as l, DeepFieldValue as m, FormClassNames as n, CoercionMap as o, FormLabels as p, ArrayButtonSlots as q, FieldCondition as r, FieldMeta as s, FieldOverride as t, FieldType as u, FormWrapperProps as v, ResolvedArrayButtonSlots as w, SectionWrapperProps as x, SelectOption as y, SubmitButtonProps as z };
+export type { AutoFormProps as A, SubmitButtonProps as B, ComponentRegistry as C, DeepKeys as D, FieldMetaBase as F, LayoutSlots as L, ObjectWrapperProps as O, PersistStorage as P, ResolvedLayoutSlots as R, SectionConfig as S, ValidationMessages as V, FieldConfig as a, AutoFormHandle as b, FieldProps as c, FieldWrapperProps as d, ArrayButtonProps as e, ArrayCollapseButtonProps as f, ArrayFieldLayoutProps as g, ArrayRowLayoutProps as h, ArrayWrapperProps as i, AutoFormConfig as j, FormMethods as k, FieldDependencyResult as l, DeepFieldValue as m, ConditionValues as n, FormClassNames as o, CoercionMap as p, FormLabels as q, ArrayButtonSlots as r, FieldCondition as s, FieldMeta as t, FieldOverride as u, FieldType as v, FormWrapperProps as w, ResolvedArrayButtonSlots as x, SectionWrapperProps as y, SelectOption as z };

package/dist/index.d.mts

@@ -1,8 +1,9 @@
-import { F as FieldMetaBase, a as FieldConfig, A as AutoFormProps, b as AutoFormHandle, c as FieldProps, d as FieldWrapperProps, e as ArrayButtonProps, f as ArrayCollapseButtonProps, g as ArrayFieldLayoutProps, h as ArrayRowLayoutProps, O as ObjectWrapperProps, i as ArrayWrapperProps, C as ComponentRegistry, j as AutoFormConfig, D as DeepKeys, k as FormMethods, l as FieldDependencyResult, m as DeepFieldValue, P as PersistStorage, R as ResolvedLayoutSlots, n as FormClassNames, o as CoercionMap$1, V as ValidationMessages, p as FormLabels } from './field-DPgaGkOL.mjs';
-export { q as ArrayButtonSlots, r as FieldCondition, s as FieldMeta, t as FieldOverride, u as FieldType, v as FormWrapperProps, L as LayoutSlots, w as ResolvedArrayButtonSlots, S as SectionConfig, x as SectionWrapperProps, y as SelectOption, z as SubmitButtonProps } from './field-DPgaGkOL.mjs';
+import { F as FieldMetaBase, a as FieldConfig, A as AutoFormProps, b as AutoFormHandle, c as FieldProps, d as FieldWrapperProps, e as ArrayButtonProps, f as ArrayCollapseButtonProps, g as ArrayFieldLayoutProps, h as ArrayRowLayoutProps, O as ObjectWrapperProps, i as ArrayWrapperProps, C as ComponentRegistry, j as AutoFormConfig, D as DeepKeys, k as FormMethods, l as FieldDependencyResult, m as DeepFieldValue, n as ConditionValues, P as PersistStorage, R as ResolvedLayoutSlots, o as FormClassNames, p as CoercionMap$1, V as ValidationMessages, q as FormLabels } from './field-KKjnXn-d.mjs';
+export { r as ArrayButtonSlots, s as FieldCondition, t as FieldMeta, u as FieldOverride, v as FieldType, w as FormWrapperProps, L as LayoutSlots, x as ResolvedArrayButtonSlots, S as SectionConfig, y as SectionWrapperProps, z as SelectOption, B as SubmitButtonProps } from './field-KKjnXn-d.mjs';
 import * as z from 'zod/v4/core';
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import * as React from 'react';
+import * as react_hook_form from 'react-hook-form';
 import { Control } from 'react-hook-form';
 
 // zod@3.25+ — import from 'zod/v4'
@@ -192,7 +193,7 @@ type UniFormContext<TSchema extends z.$ZodObject = z.$ZodObject> = FormMethods<z
     setFieldMeta: <K extends DeepKeys<z.infer<TSchema>>>(field: K, meta: Partial<FieldDependencyResult>) => void;
 };
 type Handler<TSchema extends z.$ZodObject, TValue> = (value: TValue, ctx: UniFormContext<TSchema>) => void | Promise<void>;
-type Condition<TSchema extends z.$ZodObject> = (values: z.infer<TSchema>) => boolean;
+type Condition = (values: unknown) => boolean;
 /**
  * A type-safe form definition that lives outside React components.
  * Wraps a Zod schema and lets you attach typed `setOnChange` callbacks that fire
@@ -235,13 +236,13 @@ declare class UniForm<TSchema extends z.$ZodObject, TRegistered extends string =
      * Composes with any `condition` set via the `fields` prop (UniForm takes precedence).
      * Returns `this` for fluent chaining.
      */
-    setCondition<K extends DeepKeys<z.infer<TSchema>>>(field: K, predicate: Condition<TSchema>): this;
+    setCondition<K extends DeepKeys<z.infer<TSchema>>>(field: K, predicate: (values: ConditionValues<z.infer<TSchema>, K>) => boolean): this;
     /** @internal Called by AutoForm to fire the handler registered for a field. */
     _fireHandler(field: string, value: unknown, ctx: UniFormContext<TSchema>): void | Promise<void>;
     /** @internal Returns all field names that have registered onChange handlers. */
     _getWatchedFields(): string[];
     /** @internal Returns a copy of the conditions map for AutoForm to inject into field meta. */
-    _getConditions(): Map<string, Condition<TSchema>>;
+    _getConditions(): Map<string, Condition>;
 }
 /**
  * Creates a new `UniForm` instance for the given Zod object schema.
@@ -278,9 +279,12 @@ declare function createForm(schema: z.$ZodDiscriminatedUnion): UniForm<z.$ZodObj
  *
  * @param fields - The full list of field configs to filter and sort.
  * @param control - The RHF `control` object from the parent form.
+ * @param scopeName - When provided, conditions receive only the values at this
+ *   path (e.g. `"tasks.0"` for an array row) rather than the full form values.
+ *   This enables row-local sibling conditions inside arrays.
  * @returns The filtered and ordered subset of `fields`.
  */
-declare function useConditionalFields(fields: FieldConfig[], control: Control): FieldConfig[];
+declare function useConditionalFields(fields: FieldConfig[], control: Control, scopeName?: string): FieldConfig[];
 
 type SectionGroup = {
     title: string | null;
@@ -324,8 +328,44 @@ declare function useFormPersistence(options: {
     clearPersistedData: () => void;
 };
 
+/**
+ * Access the operations and reactive state of a named array field from
+ * anywhere inside an `<AutoForm>` tree.
+ *
+ * Useful for rendering action buttons (e.g. "Add Row") outside the array
+ * field's own wrapper — in a toolbar, section header, or custom form layout.
+ * `minItems` / `maxItems` are derived automatically from the Zod schema.
+ *
+ * @param fieldName - Dot-notated path to the array field (e.g. `"lineItems"`).
+ *
+ * @example
+ * function AddRowButton() {
+ *   const { append, canAdd, rowCount } = useArrayField('lineItems')
+ *   return (
+ *     <button disabled={!canAdd} onClick={() => append({})}>
+ *       Add Item ({rowCount})
+ *     </button>
+ *   )
+ * }
+ */
+declare function useArrayField(fieldName: string): {
+    rowCount: number;
+    canAdd: boolean;
+    atMin: boolean;
+    swap: react_hook_form.UseFieldArraySwap;
+    move: react_hook_form.UseFieldArrayMove;
+    prepend: react_hook_form.UseFieldArrayPrepend<react_hook_form.FieldValues, never>;
+    append: react_hook_form.UseFieldArrayAppend<react_hook_form.FieldValues, never>;
+    remove: react_hook_form.UseFieldArrayRemove;
+    insert: react_hook_form.UseFieldArrayInsert<react_hook_form.FieldValues, never>;
+    update: react_hook_form.UseFieldArrayUpdate<react_hook_form.FieldValues, never>;
+    replace: react_hook_form.UseFieldArrayReplace<react_hook_form.FieldValues, never>;
+    fields: Record<"id", string>[];
+};
+
 type AutoFormContextValue = {
     registry: ComponentRegistry;
+    fieldConfigs: FieldConfig[];
     fieldOverrides: Record<string, unknown>;
     fieldWrapper: React.ComponentType<FieldWrapperProps>;
     layout: ResolvedLayoutSlots;
@@ -335,7 +375,8 @@ type AutoFormContextValue = {
     messages?: ValidationMessages;
     labels: FormLabels;
     formMethods: FormMethods;
+    control: Control;
 };
 declare function useAutoFormContext(): AutoFormContextValue;
 
-export { ArrayButtonProps, ArrayCollapseButtonProps, ArrayFieldLayoutProps, ArrayRowLayoutProps, ArrayWrapperProps, AutoForm, AutoFormConfig, type AutoFormContextValue, AutoFormHandle, AutoFormProps, CoercionMap$1 as CoercionMap, ComponentRegistry, DefaultArrayButton, DefaultArrayCollapseButton, DefaultArrayFieldLayout, DefaultArrayRowLayout, DefaultArrayWrapper, DefaultCheckbox, DefaultFieldWrapper, DefaultInput, DefaultObjectWrapper, DefaultSelect, DefaultSubmitButton, FieldConfig, FieldDependencyResult, FieldMetaBase, FieldProps, FieldRenderer, FieldWrapperProps, FormClassNames, FormLabels, FormMethods, ObjectWrapperProps, PersistStorage, ResolvedLayoutSlots, type SectionGroup, UniForm, type UniFormContext, ValidationMessages, coerceValue, createAutoForm, createForm, defaultCoercionMap, defaultRegistry, introspectObjectSchema, introspectSchema, mergeRegistries, useAutoFormContext, useConditionalFields, useFormPersistence, useSectionGrouping };
+export { ArrayButtonProps, ArrayCollapseButtonProps, ArrayFieldLayoutProps, ArrayRowLayoutProps, ArrayWrapperProps, AutoForm, AutoFormConfig, type AutoFormContextValue, AutoFormHandle, AutoFormProps, CoercionMap$1 as CoercionMap, ComponentRegistry, DefaultArrayButton, DefaultArrayCollapseButton, DefaultArrayFieldLayout, DefaultArrayRowLayout, DefaultArrayWrapper, DefaultCheckbox, DefaultFieldWrapper, DefaultInput, DefaultObjectWrapper, DefaultSelect, DefaultSubmitButton, FieldConfig, FieldDependencyResult, FieldMetaBase, FieldProps, FieldRenderer, FieldWrapperProps, FormClassNames, FormLabels, FormMethods, ObjectWrapperProps, PersistStorage, ResolvedLayoutSlots, type SectionGroup, UniForm, type UniFormContext, ValidationMessages, coerceValue, createAutoForm, createForm, defaultCoercionMap, defaultRegistry, introspectObjectSchema, introspectSchema, mergeRegistries, useArrayField, useAutoFormContext, useConditionalFields, useFormPersistence, useSectionGrouping };

package/dist/index.d.ts

@@ -1,8 +1,9 @@
-import { F as FieldMetaBase, a as FieldConfig, A as AutoFormProps, b as AutoFormHandle, c as FieldProps, d as FieldWrapperProps, e as ArrayButtonProps, f as ArrayCollapseButtonProps, g as ArrayFieldLayoutProps, h as ArrayRowLayoutProps, O as ObjectWrapperProps, i as ArrayWrapperProps, C as ComponentRegistry, j as AutoFormConfig, D as DeepKeys, k as FormMethods, l as FieldDependencyResult, m as DeepFieldValue, P as PersistStorage, R as ResolvedLayoutSlots, n as FormClassNames, o as CoercionMap$1, V as ValidationMessages, p as FormLabels } from './field-DPgaGkOL.js';
-export { q as ArrayButtonSlots, r as FieldCondition, s as FieldMeta, t as FieldOverride, u as FieldType, v as FormWrapperProps, L as LayoutSlots, w as ResolvedArrayButtonSlots, S as SectionConfig, x as SectionWrapperProps, y as SelectOption, z as SubmitButtonProps } from './field-DPgaGkOL.js';
+import { F as FieldMetaBase, a as FieldConfig, A as AutoFormProps, b as AutoFormHandle, c as FieldProps, d as FieldWrapperProps, e as ArrayButtonProps, f as ArrayCollapseButtonProps, g as ArrayFieldLayoutProps, h as ArrayRowLayoutProps, O as ObjectWrapperProps, i as ArrayWrapperProps, C as ComponentRegistry, j as AutoFormConfig, D as DeepKeys, k as FormMethods, l as FieldDependencyResult, m as DeepFieldValue, n as ConditionValues, P as PersistStorage, R as ResolvedLayoutSlots, o as FormClassNames, p as CoercionMap$1, V as ValidationMessages, q as FormLabels } from './field-KKjnXn-d.js';
+export { r as ArrayButtonSlots, s as FieldCondition, t as FieldMeta, u as FieldOverride, v as FieldType, w as FormWrapperProps, L as LayoutSlots, x as ResolvedArrayButtonSlots, S as SectionConfig, y as SectionWrapperProps, z as SelectOption, B as SubmitButtonProps } from './field-KKjnXn-d.js';
 import * as z from 'zod/v4/core';
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import * as React from 'react';
+import * as react_hook_form from 'react-hook-form';
 import { Control } from 'react-hook-form';
 
 // zod@3.25+ — import from 'zod/v4'
@@ -192,7 +193,7 @@ type UniFormContext<TSchema extends z.$ZodObject = z.$ZodObject> = FormMethods<z
     setFieldMeta: <K extends DeepKeys<z.infer<TSchema>>>(field: K, meta: Partial<FieldDependencyResult>) => void;
 };
 type Handler<TSchema extends z.$ZodObject, TValue> = (value: TValue, ctx: UniFormContext<TSchema>) => void | Promise<void>;
-type Condition<TSchema extends z.$ZodObject> = (values: z.infer<TSchema>) => boolean;
+type Condition = (values: unknown) => boolean;
 /**
  * A type-safe form definition that lives outside React components.
  * Wraps a Zod schema and lets you attach typed `setOnChange` callbacks that fire
@@ -235,13 +236,13 @@ declare class UniForm<TSchema extends z.$ZodObject, TRegistered extends string =
      * Composes with any `condition` set via the `fields` prop (UniForm takes precedence).
      * Returns `this` for fluent chaining.
      */
-    setCondition<K extends DeepKeys<z.infer<TSchema>>>(field: K, predicate: Condition<TSchema>): this;
+    setCondition<K extends DeepKeys<z.infer<TSchema>>>(field: K, predicate: (values: ConditionValues<z.infer<TSchema>, K>) => boolean): this;
     /** @internal Called by AutoForm to fire the handler registered for a field. */
     _fireHandler(field: string, value: unknown, ctx: UniFormContext<TSchema>): void | Promise<void>;
     /** @internal Returns all field names that have registered onChange handlers. */
     _getWatchedFields(): string[];
     /** @internal Returns a copy of the conditions map for AutoForm to inject into field meta. */
-    _getConditions(): Map<string, Condition<TSchema>>;
+    _getConditions(): Map<string, Condition>;
 }
 /**
  * Creates a new `UniForm` instance for the given Zod object schema.
@@ -278,9 +279,12 @@ declare function createForm(schema: z.$ZodDiscriminatedUnion): UniForm<z.$ZodObj
  *
  * @param fields - The full list of field configs to filter and sort.
  * @param control - The RHF `control` object from the parent form.
+ * @param scopeName - When provided, conditions receive only the values at this
+ *   path (e.g. `"tasks.0"` for an array row) rather than the full form values.
+ *   This enables row-local sibling conditions inside arrays.
  * @returns The filtered and ordered subset of `fields`.
  */
-declare function useConditionalFields(fields: FieldConfig[], control: Control): FieldConfig[];
+declare function useConditionalFields(fields: FieldConfig[], control: Control, scopeName?: string): FieldConfig[];
 
 type SectionGroup = {
     title: string | null;
@@ -324,8 +328,44 @@ declare function useFormPersistence(options: {
     clearPersistedData: () => void;
 };
 
+/**
+ * Access the operations and reactive state of a named array field from
+ * anywhere inside an `<AutoForm>` tree.
+ *
+ * Useful for rendering action buttons (e.g. "Add Row") outside the array
+ * field's own wrapper — in a toolbar, section header, or custom form layout.
+ * `minItems` / `maxItems` are derived automatically from the Zod schema.
+ *
+ * @param fieldName - Dot-notated path to the array field (e.g. `"lineItems"`).
+ *
+ * @example
+ * function AddRowButton() {
+ *   const { append, canAdd, rowCount } = useArrayField('lineItems')
+ *   return (
+ *     <button disabled={!canAdd} onClick={() => append({})}>
+ *       Add Item ({rowCount})
+ *     </button>
+ *   )
+ * }
+ */
+declare function useArrayField(fieldName: string): {
+    rowCount: number;
+    canAdd: boolean;
+    atMin: boolean;
+    swap: react_hook_form.UseFieldArraySwap;
+    move: react_hook_form.UseFieldArrayMove;
+    prepend: react_hook_form.UseFieldArrayPrepend<react_hook_form.FieldValues, never>;
+    append: react_hook_form.UseFieldArrayAppend<react_hook_form.FieldValues, never>;
+    remove: react_hook_form.UseFieldArrayRemove;
+    insert: react_hook_form.UseFieldArrayInsert<react_hook_form.FieldValues, never>;
+    update: react_hook_form.UseFieldArrayUpdate<react_hook_form.FieldValues, never>;
+    replace: react_hook_form.UseFieldArrayReplace<react_hook_form.FieldValues, never>;
+    fields: Record<"id", string>[];
+};
+
 type AutoFormContextValue = {
     registry: ComponentRegistry;
+    fieldConfigs: FieldConfig[];
     fieldOverrides: Record<string, unknown>;
     fieldWrapper: React.ComponentType<FieldWrapperProps>;
     layout: ResolvedLayoutSlots;
@@ -335,7 +375,8 @@ type AutoFormContextValue = {
     messages?: ValidationMessages;
     labels: FormLabels;
     formMethods: FormMethods;
+    control: Control;
 };
 declare function useAutoFormContext(): AutoFormContextValue;
 
-export { ArrayButtonProps, ArrayCollapseButtonProps, ArrayFieldLayoutProps, ArrayRowLayoutProps, ArrayWrapperProps, AutoForm, AutoFormConfig, type AutoFormContextValue, AutoFormHandle, AutoFormProps, CoercionMap$1 as CoercionMap, ComponentRegistry, DefaultArrayButton, DefaultArrayCollapseButton, DefaultArrayFieldLayout, DefaultArrayRowLayout, DefaultArrayWrapper, DefaultCheckbox, DefaultFieldWrapper, DefaultInput, DefaultObjectWrapper, DefaultSelect, DefaultSubmitButton, FieldConfig, FieldDependencyResult, FieldMetaBase, FieldProps, FieldRenderer, FieldWrapperProps, FormClassNames, FormLabels, FormMethods, ObjectWrapperProps, PersistStorage, ResolvedLayoutSlots, type SectionGroup, UniForm, type UniFormContext, ValidationMessages, coerceValue, createAutoForm, createForm, defaultCoercionMap, defaultRegistry, introspectObjectSchema, introspectSchema, mergeRegistries, useAutoFormContext, useConditionalFields, useFormPersistence, useSectionGrouping };
+export { ArrayButtonProps, ArrayCollapseButtonProps, ArrayFieldLayoutProps, ArrayRowLayoutProps, ArrayWrapperProps, AutoForm, AutoFormConfig, type AutoFormContextValue, AutoFormHandle, AutoFormProps, CoercionMap$1 as CoercionMap, ComponentRegistry, DefaultArrayButton, DefaultArrayCollapseButton, DefaultArrayFieldLayout, DefaultArrayRowLayout, DefaultArrayWrapper, DefaultCheckbox, DefaultFieldWrapper, DefaultInput, DefaultObjectWrapper, DefaultSelect, DefaultSubmitButton, FieldConfig, FieldDependencyResult, FieldMetaBase, FieldProps, FieldRenderer, FieldWrapperProps, FormClassNames, FormLabels, FormMethods, ObjectWrapperProps, PersistStorage, ResolvedLayoutSlots, type SectionGroup, UniForm, type UniFormContext, ValidationMessages, coerceValue, createAutoForm, createForm, defaultCoercionMap, defaultRegistry, introspectObjectSchema, introspectSchema, mergeRegistries, useArrayField, useAutoFormContext, useConditionalFields, useFormPersistence, useSectionGrouping };