@dynamic-field-kit/react 1.5.1 → 1.7.0

package/dist/index.js

@@ -32,24 +32,30 @@ var index_exports = {};
 __export(index_exports, {
   DynamicFormDevTools: () => DynamicFormDevTools,
   DynamicInput: () => DynamicInput_default,
+  FIELD_RENDERER_PROP_KEYS: () => import_core8.FIELD_RENDERER_PROP_KEYS,
   FieldInput: () => FieldInput_default,
-  FieldRegistry: () => import_core6.FieldRegistry,
+  FieldRegistry: () => import_core7.FieldRegistry,
   FieldRegistryProvider: () => FieldRegistryProvider,
   MultiFieldInput: () => MultiFieldInput_default,
+  buildFieldRendererProps: () => import_core8.buildFieldRendererProps,
+  collectFieldPaths: () => import_core9.collectFieldPaths,
   defaultRenderersMap: () => defaultRenderersMap,
   fieldRegistry: () => fieldRegistry,
   getDefaultRenderer: () => getDefaultRenderer,
+  indexGroupPathMap: () => import_core9.indexGroupPathMap,
   layoutRegistry: () => layoutRegistry,
-  resolveDisabled: () => import_core7.resolveDisabled,
-  resolveOptions: () => import_core7.resolveOptions,
-  resolveReadOnly: () => import_core7.resolveReadOnly,
+  makeErrorId: () => import_core8.makeErrorId,
+  makeFieldId: () => import_core8.makeFieldId,
+  resolveDisabled: () => import_core9.resolveDisabled,
+  resolveOptions: () => import_core9.resolveOptions,
+  resolveReadOnly: () => import_core9.resolveReadOnly,
   useDynamicForm: () => useDynamicForm,
   useFieldRegistry: () => useFieldRegistry,
-  validateField: () => import_core7.validateField,
-  validateFieldAsync: () => import_core7.validateFieldAsync,
-  validateFields: () => import_core7.validateFields,
-  validateFieldsAsync: () => import_core7.validateFieldsAsync,
-  validators: () => import_core7.validators
+  validateField: () => import_core9.validateField,
+  validateFieldAsync: () => import_core9.validateFieldAsync,
+  validateFields: () => import_core9.validateFields,
+  validateFieldsAsync: () => import_core9.validateFieldsAsync,
+  validators: () => import_core9.validators
 });
 module.exports = __toCommonJS(index_exports);
 
@@ -166,6 +172,7 @@ layoutRegistry.register("responsive", ({ children, config }) => {
 });
 
 // src/components/DynamicInput.tsx
+var import_core2 = require("@dynamic-field-kit/core");
 var import_react3 = __toESM(require("react"));
 
 // src/defaultRenderers.tsx
@@ -491,56 +498,42 @@ function useFieldRegistry() {
 var import_jsx_runtime5 = require("react/jsx-runtime");
 var DynamicInputInner = ({
   type,
-  value,
   onChange,
   onBlur,
-  label,
-  options,
-  className,
-  description,
-  disabled,
-  readOnly,
-  required,
-  touched,
-  dirty,
-  error,
-  id,
-  ariaInvalid,
-  ariaDescribedBy,
-  ariaRequired,
-  extraProps
+  extraProps,
+  onOptionsQuery,
+  ...rendererProps
 }) => {
   const registry = useFieldRegistry();
-  const Renderer = (0, import_react3.useMemo)(
-    () => registry.get(type) || getDefaultRenderer(type),
-    [registry, type]
-  );
+  const { Renderer, isDefault } = (0, import_react3.useMemo)(() => {
+    const registered = registry.get(type);
+    return {
+      Renderer: registered ?? getDefaultRenderer(type),
+      isDefault: !registered
+    };
+  }, [registry, type]);
   if (!Renderer) {
     return /* @__PURE__ */ (0, import_jsx_runtime5.jsxs)("div", { children: [
       "Unknown field type: ",
       type
     ] });
   }
-  return import_react3.default.createElement(Renderer, {
+  const { error, id } = rendererProps;
+  const control = import_react3.default.createElement(Renderer, {
     ...extraProps,
-    value,
+    ...rendererProps,
     onValueChange: onChange,
     onBlur,
-    label,
-    options,
-    className,
-    description,
-    disabled,
-    readOnly,
-    required,
-    touched,
-    dirty,
-    error,
-    id,
-    ariaInvalid,
-    ariaDescribedBy,
-    ariaRequired
+    onOptionsQuery
   });
+  const firstError = Array.isArray(error) ? error[0] : error;
+  if (!isDefault || !firstError || !id) {
+    return control;
+  }
+  return /* @__PURE__ */ (0, import_jsx_runtime5.jsxs)(import_jsx_runtime5.Fragment, { children: [
+    control,
+    /* @__PURE__ */ (0, import_jsx_runtime5.jsx)("div", { id: (0, import_core2.makeErrorId)(id), className: "dfk-field-error", role: "alert", children: firstError })
+  ] });
 };
 var DynamicInput = /* @__PURE__ */ import_react3.default.memo(
   DynamicInputInner
@@ -548,16 +541,16 @@ var DynamicInput = /* @__PURE__ */ import_react3.default.memo(
 var DynamicInput_default = DynamicInput;
 
 // src/components/FieldInput.tsx
-var import_core4 = require("@dynamic-field-kit/core");
+var import_core5 = require("@dynamic-field-kit/core");
 var import_react6 = __toESM(require("react"));
 
 // src/components/FieldGroupInput.tsx
-var import_core3 = require("@dynamic-field-kit/core");
+var import_core4 = require("@dynamic-field-kit/core");
 var import_react5 = require("react");
 
 // src/components/MultiFieldInput.tsx
-var import_core2 = require("@dynamic-field-kit/core");
-var import_react4 = require("react");
+var import_core3 = require("@dynamic-field-kit/core");
+var import_react4 = __toESM(require("react"));
 var import_jsx_runtime6 = require("react/jsx-runtime");
 function resolveLayout(layout) {
   if (!layout) {
@@ -568,25 +561,46 @@ function resolveLayout(layout) {
   }
   return { type: layout.type, config: layout };
 }
-var MultiFieldInput = ({
+var MultiFieldInputInner = ({
   fieldDescriptions,
   properties,
   onChange,
   layout,
+  idPrefix,
+  initialProperties,
   rootData,
   onValidityChange,
-  onBlurField
-}) => {
+  onBlurField,
+  touched: touchedProp,
+  errors: errorsProp,
+  onTouchedChange,
+  form
+}, ref) => {
+  const effectiveProperties = properties ?? form?.data;
+  const effectiveOnChange = onChange ?? form?.handleChange;
+  const effectiveOnBlurField = onBlurField ?? form?.handleBlur;
+  const controlledTouched = touchedProp ?? form?.touched;
+  const effectiveErrors = errorsProp ?? form?.errors;
   const [data, setData] = (0, import_react4.useState)({});
-  const [touchedFields, setTouchedFields] = (0, import_react4.useState)(
-    {}
+  const [internalTouched, setInternalTouched] = (0, import_react4.useState)({});
+  const fallbackBaselineRef = (0, import_react4.useRef)(
+    effectiveProperties
   );
-  const initialPropertiesRef = (0, import_react4.useRef)(properties ?? {});
+  if (fallbackBaselineRef.current === void 0) {
+    fallbackBaselineRef.current = effectiveProperties;
+  }
+  const baseline = initialProperties ?? form?.baselineValues ?? fallbackBaselineRef.current ?? {};
+  const autoId = (0, import_react4.useId)().replace(/[^a-zA-Z0-9]/g, "");
+  const effectiveIdPrefix = idPrefix ?? `dfk-${autoId}`;
+  const isTouchedControlled = controlledTouched !== void 0;
+  const effectiveTouched = controlledTouched ?? internalTouched;
   (0, import_react4.useEffect)(() => {
-    if (properties) {
-      setData((0, import_core2.applyComputedValues)(fieldDescriptions, properties, rootData));
+    if (effectiveProperties) {
+      setData(
+        (0, import_core3.applyComputedValues)(fieldDescriptions, effectiveProperties, rootData)
+      );
     }
-  }, [properties]);
+  }, [effectiveProperties]);
   const effectiveRoot = rootData ?? data;
   const visibleFields = (0, import_react4.useMemo)(
     () => fieldDescriptions.filter(
@@ -596,24 +610,30 @@ var MultiFieldInput = ({
   );
   const dataRef = (0, import_react4.useRef)(data);
   dataRef.current = data;
-  const onChangeRef = (0, import_react4.useRef)(onChange);
-  onChangeRef.current = onChange;
+  const onChangeRef = (0, import_react4.useRef)(effectiveOnChange);
+  onChangeRef.current = effectiveOnChange;
   const fieldDescriptionsRef = (0, import_react4.useRef)(fieldDescriptions);
   fieldDescriptionsRef.current = fieldDescriptions;
   const rootDataRef = (0, import_react4.useRef)(rootData);
   rootDataRef.current = rootData;
   const onValidityChangeRef = (0, import_react4.useRef)(onValidityChange);
   onValidityChangeRef.current = onValidityChange;
-  const onBlurFieldRef = (0, import_react4.useRef)(onBlurField);
-  onBlurFieldRef.current = onBlurField;
+  const onBlurFieldRef = (0, import_react4.useRef)(effectiveOnBlurField);
+  onBlurFieldRef.current = effectiveOnBlurField;
+  const onTouchedChangeRef = (0, import_react4.useRef)(onTouchedChange);
+  onTouchedChangeRef.current = onTouchedChange;
+  const isTouchedControlledRef = (0, import_react4.useRef)(isTouchedControlled);
+  isTouchedControlledRef.current = isTouchedControlled;
+  const effectiveTouchedRef = (0, import_react4.useRef)(effectiveTouched);
+  effectiveTouchedRef.current = effectiveTouched;
   (0, import_react4.useEffect)(() => {
     onValidityChangeRef.current?.(
-      (0, import_core2.validateFields)(fieldDescriptions, data, rootData)
+      (0, import_core3.validateFields)(fieldDescriptions, data, rootData)
     );
   }, [data, fieldDescriptions, rootData]);
   const handleValueChangeField = (0, import_react4.useCallback)((value, key) => {
     const merged = { ...dataRef.current, [key]: value };
-    const next = (0, import_core2.applyComputedValues)(
+    const next = (0, import_core3.applyComputedValues)(
       fieldDescriptionsRef.current,
       merged,
       rootDataRef.current
@@ -622,10 +642,39 @@ var MultiFieldInput = ({
     setData(next);
     onChangeRef.current?.(next);
   }, []);
-  const handleBlurField = (0, import_react4.useCallback)((key) => {
-    setTouchedFields((prev) => prev[key] ? prev : { ...prev, [key]: true });
-    onBlurFieldRef.current?.(key);
+  const markTouched = (0, import_react4.useCallback)((key, isTouched) => {
+    const current = effectiveTouchedRef.current;
+    if (Boolean(current[key]) === isTouched) {
+      return;
+    }
+    const next = { ...current, [key]: isTouched };
+    if (!isTouchedControlledRef.current) {
+      effectiveTouchedRef.current = next;
+      setInternalTouched(next);
+    }
+    onTouchedChangeRef.current?.(next);
   }, []);
+  const handleBlurField = (0, import_react4.useCallback)(
+    (key) => {
+      markTouched(key, true);
+      onBlurFieldRef.current?.(key);
+    },
+    [markTouched]
+  );
+  (0, import_react4.useImperativeHandle)(
+    ref,
+    () => ({
+      resetTouched: () => {
+        if (!isTouchedControlledRef.current) {
+          effectiveTouchedRef.current = {};
+        }
+        setInternalTouched({});
+      },
+      setFieldTouched: (fieldName, isTouched = true) => markTouched(fieldName, isTouched),
+      getTouched: () => effectiveTouchedRef.current
+    }),
+    [markTouched]
+  );
   const { type, config } = resolveLayout(layout);
   const Layout = layoutRegistry.get(type);
   if (!Layout) {
@@ -637,22 +686,31 @@ var MultiFieldInput = ({
       fieldDescription: f,
       renderInfos: data,
       rootData: effectiveRoot,
-      touched: Boolean(touchedFields[f.name]),
-      dirty: data[f.name] !== initialPropertiesRef.current[f.name],
+      idPrefix: effectiveIdPrefix,
+      touched: Boolean(effectiveTouched[f.name]),
+      touchedMap: (0, import_core3.isFieldGroup)(f) ? effectiveTouched : void 0,
+      errors: effectiveErrors,
+      dirty: !Object.is(data[f.name], baseline[f.name]),
       onBlurField: handleBlurField,
       onValueChangeField: handleValueChangeField
     },
     f.name
   )) });
 };
+var MultiFieldInput = /* @__PURE__ */ import_react4.default.forwardRef(MultiFieldInputInner);
+MultiFieldInput.displayName = "MultiFieldInput";
 var MultiFieldInput_default = MultiFieldInput;
 
 // src/components/FieldGroupInput.tsx
 var import_jsx_runtime7 = require("react/jsx-runtime");
+var EMPTY_TOUCHED = Object.freeze({});
 var FieldGroupInput = ({
   fieldDescription,
   items,
   rootData,
+  errors,
+  touched,
+  onBlurField,
   onChange
 }) => {
   const {
@@ -666,6 +724,14 @@ var FieldGroupInput = ({
   const addText = addLabel ?? "Add";
   const removeText = removeLabel ?? "Remove";
   const groupName = label ?? fieldDescription.name;
+  const errorsByItem = (0, import_react5.useMemo)(
+    () => (0, import_core4.indexGroupPathMap)(errors, fieldDescription.name),
+    [errors, fieldDescription.name]
+  );
+  const touchedByItem = (0, import_react5.useMemo)(
+    () => (0, import_core4.indexGroupPathMap)(touched, fieldDescription.name),
+    [touched, fieldDescription.name]
+  );
   const handleItemChange = (0, import_react5.useCallback)(
     (index, next) => {
       const nextItems = items.slice();
@@ -675,14 +741,14 @@ var FieldGroupInput = ({
     [items, onChange]
   );
   const handleAdd = (0, import_react5.useCallback)(() => {
-    if (!(0, import_core3.canAddGroupItem)(fieldDescription, items)) {
+    if (!(0, import_core4.canAddGroupItem)(fieldDescription, items)) {
       return;
     }
-    onChange([...items, (0, import_core3.createGroupItem)(fieldDescription)]);
+    onChange([...items, (0, import_core4.createGroupItem)(fieldDescription)]);
   }, [fieldDescription, items, onChange]);
   const handleRemove = (0, import_react5.useCallback)(
     (index) => {
-      if (!(0, import_core3.canRemoveGroupItem)(fieldDescription, items)) {
+      if (!(0, import_core4.canRemoveGroupItem)(fieldDescription, items)) {
         return;
       }
       onChange(items.filter((_, i) => i !== index));
@@ -702,6 +768,9 @@ var FieldGroupInput = ({
               fieldDescriptions: fields,
               properties: item,
               rootData,
+              errors: errorsByItem?.[index],
+              touched: touched === void 0 ? void 0 : touchedByItem?.[index] ?? EMPTY_TOUCHED,
+              onBlurField: (key) => onBlurField?.(`${fieldDescription.name}[${index}].${key}`),
               onChange: (next) => handleItemChange(index, next)
             }
           ) }),
@@ -711,7 +780,7 @@ var FieldGroupInput = ({
               type: "button",
               "aria-label": `${removeText} ${groupName} ${index + 1}`,
               onClick: () => handleRemove(index),
-              disabled: !(0, import_core3.canRemoveGroupItem)(fieldDescription, items),
+              disabled: !(0, import_core4.canRemoveGroupItem)(fieldDescription, items),
               children: removeText
             }
           )
@@ -725,7 +794,7 @@ var FieldGroupInput = ({
         type: "button",
         "aria-label": `${addText} ${groupName}`,
         onClick: handleAdd,
-        disabled: !(0, import_core3.canAddGroupItem)(fieldDescription, items),
+        disabled: !(0, import_core4.canAddGroupItem)(fieldDescription, items),
         children: addText
       }
     )
@@ -739,12 +808,50 @@ var FieldInputInner = ({
   fieldDescription,
   renderInfos,
   rootData,
+  idPrefix = "dfk-field",
   touched,
+  touchedMap,
   dirty,
+  errors,
   onBlurField,
   onValueChangeField
 }) => {
-  const { name, type, label, className, description, props, fields, required } = fieldDescription;
+  const { name, fields } = fieldDescription;
+  const isAsync = (0, import_core5.isAsyncOptions)(fieldDescription);
+  const [optionsState, setOptionsState] = (0, import_react6.useState)(
+    isAsync ? { status: "idle" } : void 0
+  );
+  const loaderRef = (0, import_react6.useRef)(void 0);
+  const fieldRef = (0, import_react6.useRef)(fieldDescription);
+  fieldRef.current = fieldDescription;
+  const ensureLoader = (0, import_react6.useCallback)(() => {
+    if (!(0, import_core5.isAsyncOptions)(fieldRef.current)) {
+      return void 0;
+    }
+    if (!loaderRef.current) {
+      loaderRef.current = (0, import_core5.createOptionsLoader)(
+        fieldRef.current,
+        setOptionsState
+      );
+    }
+    return loaderRef.current;
+  }, []);
+  (0, import_react6.useEffect)(
+    () => () => {
+      loaderRef.current?.dispose();
+      loaderRef.current = void 0;
+    },
+    []
+  );
+  (0, import_react6.useEffect)(() => {
+    ensureLoader()?.update(renderInfos, rootData);
+  });
+  const handleOptionsQuery = (0, import_react6.useCallback)(
+    (query) => {
+      ensureLoader()?.setQuery(query);
+    },
+    [ensureLoader]
+  );
   const handleChange = (0, import_react6.useCallback)(
     (v) => onValueChangeField(v, name),
     [onValueChangeField, name]
@@ -761,51 +868,40 @@ var FieldInputInner = ({
         fieldDescription,
         items,
         rootData,
+        errors,
+        touched: touchedMap,
+        onBlurField,
         onChange: handleChange
       }
     );
   }
-  const effectiveDisabled = (0, import_core4.resolveDisabled)(
+  const rendererProps = (0, import_core5.buildFieldRendererProps)({
     fieldDescription,
-    renderInfos,
-    rootData
-  );
-  const readOnly = (0, import_core4.resolveReadOnly)(fieldDescription, renderInfos, rootData);
-  const resolvedOptionsList = (0, import_core4.resolveOptions)(
-    fieldDescription,
-    renderInfos,
-    rootData
-  );
-  const errors = effectiveDisabled ? [] : (0, import_core4.validateField)(fieldDescription, renderInfos[name], renderInfos, rootData);
-  const error = errors.length > 0 ? errors : void 0;
-  const fieldId = `dfk-field-${name}`;
+    data: renderInfos,
+    rootData,
+    id: (0, import_core5.makeFieldId)(fieldDescription, idPrefix),
+    touched,
+    dirty,
+    validationErrors: errors === void 0 ? void 0 : errors[name] ?? [],
+    optionsState
+  });
   return /* @__PURE__ */ (0, import_jsx_runtime8.jsx)(
     DynamicInput_default,
     {
-      id: fieldId,
-      type,
-      label,
-      value: renderInfos[name],
-      options: resolvedOptionsList,
-      className,
-      description,
-      disabled: effectiveDisabled,
-      readOnly,
-      required,
-      touched,
-      dirty,
-      error,
-      ariaInvalid: Boolean(error),
-      ariaRequired: Boolean(required),
-      extraProps: props,
+      ...rendererProps,
+      description: rendererProps.description,
       onChange: handleChange,
-      onBlur: handleBlur
+      onBlur: handleBlur,
+      onOptionsQuery: isAsync ? handleOptionsQuery : void 0
     }
   );
 };
 var FieldInput = /* @__PURE__ */ import_react6.default.memo(FieldInputInner, (prev, next) => {
   const name = prev.fieldDescription.name;
-  return prev.fieldDescription === next.fieldDescription && prev.onValueChangeField === next.onValueChangeField && prev.onBlurField === next.onBlurField && prev.rootData === next.rootData && prev.touched === next.touched && prev.dirty === next.dirty && prev.renderInfos[name] === next.renderInfos[name];
+  if ((0, import_core5.isAsyncOptions)(prev.fieldDescription) && prev.renderInfos !== next.renderInfos) {
+    return false;
+  }
+  return prev.fieldDescription === next.fieldDescription && prev.onValueChangeField === next.onValueChangeField && prev.onBlurField === next.onBlurField && prev.rootData === next.rootData && prev.idPrefix === next.idPrefix && prev.touched === next.touched && prev.touchedMap === next.touchedMap && prev.dirty === next.dirty && prev.errors === next.errors && prev.renderInfos[name] === next.renderInfos[name];
 });
 var FieldInput_default = FieldInput;
 
@@ -1010,38 +1106,134 @@ var DynamicFormDevTools = ({
 };
 
 // src/useDynamicForm.ts
-var import_core5 = require("@dynamic-field-kit/core");
+var import_core6 = require("@dynamic-field-kit/core");
 var import_react8 = require("react");
+function sameStringMap(left, right) {
+  const keys = Object.keys(left);
+  return keys.length === Object.keys(right).length && keys.every(
+    (key) => left[key]?.length === right[key]?.length && left[key]?.every((value, index) => value === right[key]?.[index])
+  );
+}
+function sameValidationResult(left, right) {
+  return left.valid === right.valid && left.complete === right.complete && left.status === right.status && (left.pending ?? []).join("\0") === (right.pending ?? []).join("\0") && sameStringMap(left.errors, right.errors);
+}
 function useDynamicForm({
   fields,
   initialValues = {},
   validateOnBlur = true,
-  validateOnChange = false
+  validateOnChange = false,
+  messages
 }) {
+  const validationContextRef = (0, import_react8.useRef)({
+    t: (0, import_core6.createMessageResolver)(messages)
+  });
+  validationContextRef.current.t = (0, import_core6.createMessageResolver)(messages);
   const [data, setData] = (0, import_react8.useState)(
-    () => (0, import_core5.applyComputedValues)(fields, initialValues)
+    () => (0, import_core6.applyComputedValues)(fields, initialValues)
   );
   const [errors, setErrors] = (0, import_react8.useState)({});
   const [isDirty, setIsDirty] = (0, import_react8.useState)(false);
   const [touched, setTouched] = (0, import_react8.useState)({});
   const [isSubmitting, setIsSubmitting] = (0, import_react8.useState)(false);
   const [isSubmitted, setIsSubmitted] = (0, import_react8.useState)(false);
+  const [validationResult, setValidationResult] = (0, import_react8.useState)(
+    () => (0, import_core6.validateFields)(fields, data, void 0, validationContextRef.current)
+  );
+  const [isValidating, setIsValidating] = (0, import_react8.useState)(false);
+  const validationRunRef = (0, import_react8.useRef)(0);
+  const validationAbortRef = (0, import_react8.useRef)(void 0);
+  const submitRunRef = (0, import_react8.useRef)(0);
+  const submitAbortRef = (0, import_react8.useRef)(void 0);
+  const dataRef = (0, import_react8.useRef)(data);
+  dataRef.current = data;
+  const baselineRef = (0, import_react8.useRef)(dataRef.current);
+  const [baselineValues, setBaselineValues] = (0, import_react8.useState)(
+    () => baselineRef.current
+  );
+  const commitSyncResult = (0, import_react8.useCallback)((res) => {
+    setValidationResult(
+      (previous) => sameValidationResult(previous, res) ? previous : res
+    );
+    return res.valid;
+  }, []);
+  const lastValidatedRef = (0, import_react8.useRef)(void 0);
+  const fieldsRef = (0, import_react8.useRef)(fields);
+  if (fieldsRef.current !== fields) {
+    fieldsRef.current = fields;
+    lastValidatedRef.current = void 0;
+  }
+  (0, import_react8.useEffect)(() => {
+    if (lastValidatedRef.current === data) {
+      return;
+    }
+    lastValidatedRef.current = data;
+    commitSyncResult(
+      (0, import_core6.validateFields)(fields, data, void 0, validationContextRef.current)
+    );
+  }, [fields, data, commitSyncResult]);
+  (0, import_react8.useEffect)(
+    () => () => {
+      validationAbortRef.current?.abort();
+      submitAbortRef.current?.abort();
+    },
+    []
+  );
   const validate = (0, import_react8.useCallback)(() => {
-    const res = (0, import_core5.validateFields)(fields, data);
+    const res = (0, import_core6.validateFields)(
+      fields,
+      data,
+      void 0,
+      validationContextRef.current
+    );
     setErrors(res.errors);
-    return res.valid;
+    return commitSyncResult(res);
+  }, [fields, data, commitSyncResult]);
+  const validateAsync = (0, import_react8.useCallback)(async () => {
+    const run = ++validationRunRef.current;
+    validationAbortRef.current?.abort();
+    const controller = new AbortController();
+    validationAbortRef.current = controller;
+    const snapshot = data;
+    setIsValidating(true);
+    try {
+      const res = await (0, import_core6.validateFieldsAsync)(fields, snapshot, snapshot, {
+        ...validationContextRef.current,
+        signal: controller.signal
+      });
+      if (run !== validationRunRef.current || dataRef.current !== snapshot) {
+        return res.valid;
+      }
+      setErrors(res.errors);
+      setValidationResult(res);
+      return res.valid;
+    } finally {
+      if (run === validationRunRef.current) {
+        setIsValidating(false);
+      }
+    }
   }, [fields, data]);
   const handleChange = (0, import_react8.useCallback)(
     (newData) => {
-      const next = (0, import_core5.applyComputedValues)(fields, newData);
+      const next = (0, import_core6.applyComputedValues)(fields, newData);
       setData(next);
+      dataRef.current = next;
       setIsDirty(true);
+      validationAbortRef.current?.abort();
+      validationRunRef.current += 1;
+      setIsValidating(false);
+      lastValidatedRef.current = next;
+      const res = (0, import_core6.validateFields)(
+        fields,
+        next,
+        void 0,
+        validationContextRef.current
+      );
+      commitSyncResult(res);
       if (validateOnChange) {
-        const res = (0, import_core5.validateFields)(fields, next);
         setErrors(res.errors);
       }
     },
-    [fields, validateOnChange]
+    [fields, validateOnChange, commitSyncResult]
   );
   const setFieldValue = (0, import_react8.useCallback)(
     (name, value) => {
@@ -1052,26 +1244,57 @@ function useDynamicForm({
   const setFieldTouched = (0, import_react8.useCallback)((name, isTouched = true) => {
     setTouched((prev) => ({ ...prev, [name]: isTouched }));
   }, []);
+  const touchAll = (0, import_react8.useCallback)(() => {
+    setTouched(
+      Object.fromEntries(
+        (0, import_core6.collectFieldPaths)(fields, data).map((path) => [path, true])
+      )
+    );
+  }, [fields, data]);
+  const resetTouched = (0, import_react8.useCallback)(() => setTouched({}), []);
+  const getDirtyValues = (0, import_react8.useCallback)(() => {
+    const baseline = baselineRef.current;
+    const current = dataRef.current;
+    const dirty = {};
+    for (const key of Object.keys(current)) {
+      if (!Object.is(current[key], baseline[key])) {
+        dirty[key] = current[key];
+      }
+    }
+    return dirty;
+  }, []);
   const handleBlur = (0, import_react8.useCallback)(
     (fieldName) => {
       setFieldTouched(fieldName, true);
       if (validateOnBlur) {
-        const res = (0, import_core5.validateFields)(fields, data);
+        const res = (0, import_core6.validateFields)(
+          fields,
+          data,
+          void 0,
+          validationContextRef.current
+        );
         setErrors(res.errors);
+        commitSyncResult(res);
       }
     },
-    [fields, data, validateOnBlur, setFieldTouched]
+    [fields, data, validateOnBlur, setFieldTouched, commitSyncResult]
   );
   const reset = (0, import_react8.useCallback)(
     (newValues) => {
       const seed = newValues ?? initialValues;
-      const next = (0, import_core5.applyComputedValues)(fields, seed);
+      const next = (0, import_core6.applyComputedValues)(fields, seed);
       setData(next);
+      dataRef.current = next;
+      baselineRef.current = next;
+      setBaselineValues(next);
       setErrors({});
       setIsDirty(false);
       setTouched({});
       setIsSubmitting(false);
       setIsSubmitted(false);
+      validationAbortRef.current?.abort();
+      validationRunRef.current += 1;
+      setIsValidating(false);
     },
     [fields, initialValues]
   );
@@ -1081,56 +1304,103 @@ function useDynamicForm({
         e.preventDefault();
       }
       setIsSubmitting(true);
+      const submitRun = ++submitRunRef.current;
       try {
-        const res = (0, import_core5.validateFields)(fields, data);
-        setErrors(res.errors);
+        touchAll();
+        const run = ++validationRunRef.current;
+        validationAbortRef.current?.abort();
+        submitAbortRef.current?.abort();
+        const controller = new AbortController();
+        submitAbortRef.current = controller;
+        const snapshot = data;
+        setIsValidating(true);
+        const res = await (0, import_core6.validateFieldsAsync)(fields, snapshot, snapshot, {
+          ...validationContextRef.current,
+          signal: controller.signal
+        });
+        if (submitRun !== submitRunRef.current) {
+          return;
+        }
+        if (dataRef.current === snapshot && run === validationRunRef.current) {
+          setErrors(res.errors);
+          setValidationResult(res);
+        } else {
+          const live = (0, import_core6.validateFields)(
+            fields,
+            dataRef.current,
+            void 0,
+            validationContextRef.current
+          );
+          setErrors(live.errors);
+          commitSyncResult(live);
+        }
         setIsSubmitted(true);
         if (res.valid) {
-          await onValid(data);
+          await onValid(snapshot);
         } else if (onInvalid) {
           onInvalid(res.errors);
         }
       } finally {
+        if (submitRun === submitRunRef.current) {
+          setIsValidating(false);
+        }
         setIsSubmitting(false);
       }
     },
-    [fields, data]
+    [fields, data, touchAll, commitSyncResult]
   );
-  const isValid = Object.keys(errors).length === 0;
   return {
     data,
     errors,
-    isValid,
+    isValid: validationResult.valid,
+    isValidating,
+    // Matches Vue and Angular: a run still in flight is not complete, whatever
+    // the last finished pass concluded.
+    isValidationComplete: validationResult.complete && !isValidating,
+    validationStatus: isValidating ? "pending" : validationResult.status,
     isDirty,
+    baselineValues,
+    getDirtyValues,
     isSubmitting,
     isSubmitted,
     touched,
     setData,
     setFieldValue,
     setFieldTouched,
+    setTouched,
+    touchAll,
+    resetTouched,
     handleChange,
     handleBlur,
     reset,
     validate,
+    validateAsync,
     handleSubmit
   };
 }
 
 // src/index.ts
-var import_core6 = require("@dynamic-field-kit/core");
 var import_core7 = require("@dynamic-field-kit/core");
+var import_core8 = require("@dynamic-field-kit/core");
+var import_core9 = require("@dynamic-field-kit/core");
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   DynamicFormDevTools,
   DynamicInput,
+  FIELD_RENDERER_PROP_KEYS,
   FieldInput,
   FieldRegistry,
   FieldRegistryProvider,
   MultiFieldInput,
+  buildFieldRendererProps,
+  collectFieldPaths,
   defaultRenderersMap,
   fieldRegistry,
   getDefaultRenderer,
+  indexGroupPathMap,
   layoutRegistry,
+  makeErrorId,
+  makeFieldId,
   resolveDisabled,
   resolveOptions,
   resolveReadOnly,