@uniform-ts/core 0.0.7 → 0.0.9

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 DeepKeysIndexed, k as FormMethods, l as DeepKeys, m as FieldDependencyResult, n as DeepFieldValue, o as ConditionValues, P as PersistStorage, R as ResolvedLayoutSlots, p as FormClassNames, q as CoercionMap$1, V as ValidationMessages, r as FormLabels } from './field-Cogi7eQc.js';
+export { s as ArrayButtonSlots, t as FieldCondition, u as FieldMeta, v as FieldOverride, w as FieldType, x as FormWrapperProps, L as LayoutSlots, y as ResolvedArrayButtonSlots, S as SectionConfig, z as SectionWrapperProps, B as SelectOption, E as SubmitButtonProps } from './field-Cogi7eQc.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
@@ -226,22 +227,26 @@ declare class UniForm<TSchema extends z.$ZodObject, TRegistered extends string =
      * Replaces any previously registered handler for that field — only one
      * handler per field is kept. This prevents accidental handler accumulation
      * when called inside a React render cycle.
+     *
+     * Supports both generic array paths (`"tasks.priority"` — fires for all rows)
+     * and indexed paths (`"tasks.0.priority"` — fires only for row 0).
+     *
      * Returns `this` for fluent chaining.
      */
-    setOnChange<K extends Exclude<DeepKeys<z.infer<TSchema>>, TRegistered>>(field: K, handler: Handler<TSchema, DeepFieldValue<z.infer<TSchema>, K>>): UniForm<TSchema, TRegistered | K>;
+    setOnChange<K extends Exclude<DeepKeysIndexed<z.infer<TSchema>>, TRegistered>>(field: K, handler: Handler<TSchema, DeepFieldValue<z.infer<TSchema>, K>>): UniForm<TSchema, TRegistered | K>;
     /**
      * Attach a typed condition for a specific field.
      * The field is shown when the predicate returns `true`, hidden when `false`.
      * 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 +283,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 +332,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 +379,9 @@ type AutoFormContextValue = {
     messages?: ValidationMessages;
     labels: FormLabels;
     formMethods: FormMethods;
+    control: Control;
+    setDynamicMeta: React.Dispatch<React.SetStateAction<Record<string, Partial<FieldDependencyResult>>>>;
 };
 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 };