@dynamic-field-kit/react 1.5.1 → 1.7.0

package/dist/index.mjs

@@ -111,6 +111,9 @@ layoutRegistry.register("responsive", ({ children, config }) => {
 });
 
 // src/components/DynamicInput.tsx
+import {
+  makeErrorId
+} from "@dynamic-field-kit/core";
 import React3, { useMemo } from "react";
 
 // src/defaultRenderers.tsx
@@ -435,59 +438,45 @@ function useFieldRegistry() {
 }
 
 // src/components/DynamicInput.tsx
-import { jsxs as jsxs3 } from "react/jsx-runtime";
+import { Fragment as Fragment2, jsx as jsx5, jsxs as jsxs3 } from "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 = useMemo(
-    () => registry.get(type) || getDefaultRenderer(type),
-    [registry, type]
-  );
+  const { Renderer, isDefault } = useMemo(() => {
+    const registered = registry.get(type);
+    return {
+      Renderer: registered ?? getDefaultRenderer(type),
+      isDefault: !registered
+    };
+  }, [registry, type]);
   if (!Renderer) {
     return /* @__PURE__ */ jsxs3("div", { children: [
       "Unknown field type: ",
       type
     ] });
   }
-  return React3.createElement(Renderer, {
+  const { error, id } = rendererProps;
+  const control = React3.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__ */ jsxs3(Fragment2, { children: [
+    control,
+    /* @__PURE__ */ jsx5("div", { id: makeErrorId(id), className: "dfk-field-error", role: "alert", children: firstError })
+  ] });
 };
 var DynamicInput = /* @__PURE__ */ React3.memo(
   DynamicInputInner
@@ -496,34 +485,38 @@ var DynamicInput_default = DynamicInput;
 
 // src/components/FieldInput.tsx
 import {
-  resolveDisabled,
-  resolveOptions,
-  resolveReadOnly,
-  validateField
+  buildFieldRendererProps,
+  createOptionsLoader,
+  isAsyncOptions,
+  makeFieldId
 } from "@dynamic-field-kit/core";
-import React6, { useCallback as useCallback3 } from "react";
+import React6, { useCallback as useCallback3, useEffect as useEffect3, useRef as useRef2, useState as useState3 } from "react";
 
 // src/components/FieldGroupInput.tsx
 import {
   canAddGroupItem,
   canRemoveGroupItem,
-  createGroupItem
+  createGroupItem,
+  indexGroupPathMap
 } from "@dynamic-field-kit/core";
-import { useCallback as useCallback2 } from "react";
+import { useCallback as useCallback2, useMemo as useMemo3 } from "react";
 
 // src/components/MultiFieldInput.tsx
 import {
   applyComputedValues,
+  isFieldGroup,
   validateFields
 } from "@dynamic-field-kit/core";
-import {
+import React4, {
   useCallback,
   useEffect as useEffect2,
+  useId,
+  useImperativeHandle,
   useMemo as useMemo2,
   useRef,
   useState as useState2
 } from "react";
-import { jsx as jsx5 } from "react/jsx-runtime";
+import { jsx as jsx6 } from "react/jsx-runtime";
 function resolveLayout(layout) {
   if (!layout) {
     return { type: "column", config: {} };
@@ -533,25 +526,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] = useState2({});
-  const [touchedFields, setTouchedFields] = useState2(
-    {}
+  const [internalTouched, setInternalTouched] = useState2({});
+  const fallbackBaselineRef = useRef(
+    effectiveProperties
   );
-  const initialPropertiesRef = useRef(properties ?? {});
+  if (fallbackBaselineRef.current === void 0) {
+    fallbackBaselineRef.current = effectiveProperties;
+  }
+  const baseline = initialProperties ?? form?.baselineValues ?? fallbackBaselineRef.current ?? {};
+  const autoId = useId().replace(/[^a-zA-Z0-9]/g, "");
+  const effectiveIdPrefix = idPrefix ?? `dfk-${autoId}`;
+  const isTouchedControlled = controlledTouched !== void 0;
+  const effectiveTouched = controlledTouched ?? internalTouched;
   useEffect2(() => {
-    if (properties) {
-      setData(applyComputedValues(fieldDescriptions, properties, rootData));
+    if (effectiveProperties) {
+      setData(
+        applyComputedValues(fieldDescriptions, effectiveProperties, rootData)
+      );
     }
-  }, [properties]);
+  }, [effectiveProperties]);
   const effectiveRoot = rootData ?? data;
   const visibleFields = useMemo2(
     () => fieldDescriptions.filter(
@@ -561,16 +575,22 @@ var MultiFieldInput = ({
   );
   const dataRef = useRef(data);
   dataRef.current = data;
-  const onChangeRef = useRef(onChange);
-  onChangeRef.current = onChange;
+  const onChangeRef = useRef(effectiveOnChange);
+  onChangeRef.current = effectiveOnChange;
   const fieldDescriptionsRef = useRef(fieldDescriptions);
   fieldDescriptionsRef.current = fieldDescriptions;
   const rootDataRef = useRef(rootData);
   rootDataRef.current = rootData;
   const onValidityChangeRef = useRef(onValidityChange);
   onValidityChangeRef.current = onValidityChange;
-  const onBlurFieldRef = useRef(onBlurField);
-  onBlurFieldRef.current = onBlurField;
+  const onBlurFieldRef = useRef(effectiveOnBlurField);
+  onBlurFieldRef.current = effectiveOnBlurField;
+  const onTouchedChangeRef = useRef(onTouchedChange);
+  onTouchedChangeRef.current = onTouchedChange;
+  const isTouchedControlledRef = useRef(isTouchedControlled);
+  isTouchedControlledRef.current = isTouchedControlled;
+  const effectiveTouchedRef = useRef(effectiveTouched);
+  effectiveTouchedRef.current = effectiveTouched;
   useEffect2(() => {
     onValidityChangeRef.current?.(
       validateFields(fieldDescriptions, data, rootData)
@@ -587,37 +607,75 @@ var MultiFieldInput = ({
     setData(next);
     onChangeRef.current?.(next);
   }, []);
-  const handleBlurField = useCallback((key) => {
-    setTouchedFields((prev) => prev[key] ? prev : { ...prev, [key]: true });
-    onBlurFieldRef.current?.(key);
+  const markTouched = 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 = useCallback(
+    (key) => {
+      markTouched(key, true);
+      onBlurFieldRef.current?.(key);
+    },
+    [markTouched]
+  );
+  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) {
     throw new Error(`Unknown layout: ${type}`);
   }
-  return /* @__PURE__ */ jsx5(Layout, { config, children: visibleFields.map((f) => /* @__PURE__ */ jsx5(
+  return /* @__PURE__ */ jsx6(Layout, { config, children: visibleFields.map((f) => /* @__PURE__ */ jsx6(
     FieldInput_default,
     {
       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: 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__ */ React4.forwardRef(MultiFieldInputInner);
+MultiFieldInput.displayName = "MultiFieldInput";
 var MultiFieldInput_default = MultiFieldInput;
 
 // src/components/FieldGroupInput.tsx
-import { jsx as jsx6, jsxs as jsxs4 } from "react/jsx-runtime";
+import { jsx as jsx7, jsxs as jsxs4 } from "react/jsx-runtime";
+var EMPTY_TOUCHED = Object.freeze({});
 var FieldGroupInput = ({
   fieldDescription,
   items,
   rootData,
+  errors,
+  touched,
+  onBlurField,
   onChange
 }) => {
   const {
@@ -631,6 +689,14 @@ var FieldGroupInput = ({
   const addText = addLabel ?? "Add";
   const removeText = removeLabel ?? "Remove";
   const groupName = label ?? fieldDescription.name;
+  const errorsByItem = useMemo3(
+    () => indexGroupPathMap(errors, fieldDescription.name),
+    [errors, fieldDescription.name]
+  );
+  const touchedByItem = useMemo3(
+    () => indexGroupPathMap(touched, fieldDescription.name),
+    [touched, fieldDescription.name]
+  );
   const handleItemChange = useCallback2(
     (index, next) => {
       const nextItems = items.slice();
@@ -655,22 +721,25 @@ var FieldGroupInput = ({
     [fieldDescription, items, onChange]
   );
   return /* @__PURE__ */ jsxs4("div", { className: fieldDescription.className, children: [
-    label && /* @__PURE__ */ jsx6("div", { children: label }),
+    label && /* @__PURE__ */ jsx7("div", { children: label }),
     items.map((item, index) => /* @__PURE__ */ jsxs4(
       "div",
       {
         style: { display: "flex", alignItems: "flex-start", gap: 8 },
         children: [
-          /* @__PURE__ */ jsx6("div", { style: { flex: 1 }, children: /* @__PURE__ */ jsx6(
+          /* @__PURE__ */ jsx7("div", { style: { flex: 1 }, children: /* @__PURE__ */ jsx7(
             MultiFieldInput_default,
             {
               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)
             }
           ) }),
-          /* @__PURE__ */ jsx6(
+          /* @__PURE__ */ jsx7(
             "button",
             {
               type: "button",
@@ -684,7 +753,7 @@ var FieldGroupInput = ({
       },
       itemKey(item, index)
     )),
-    /* @__PURE__ */ jsx6(
+    /* @__PURE__ */ jsx7(
       "button",
       {
         type: "button",
@@ -699,17 +768,55 @@ var FieldGroupInput = ({
 var FieldGroupInput_default = FieldGroupInput;
 
 // src/components/FieldInput.tsx
-import { jsx as jsx7 } from "react/jsx-runtime";
+import { jsx as jsx8 } from "react/jsx-runtime";
 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 = isAsyncOptions(fieldDescription);
+  const [optionsState, setOptionsState] = useState3(
+    isAsync ? { status: "idle" } : void 0
+  );
+  const loaderRef = useRef2(void 0);
+  const fieldRef = useRef2(fieldDescription);
+  fieldRef.current = fieldDescription;
+  const ensureLoader = useCallback3(() => {
+    if (!isAsyncOptions(fieldRef.current)) {
+      return void 0;
+    }
+    if (!loaderRef.current) {
+      loaderRef.current = createOptionsLoader(
+        fieldRef.current,
+        setOptionsState
+      );
+    }
+    return loaderRef.current;
+  }, []);
+  useEffect3(
+    () => () => {
+      loaderRef.current?.dispose();
+      loaderRef.current = void 0;
+    },
+    []
+  );
+  useEffect3(() => {
+    ensureLoader()?.update(renderInfos, rootData);
+  });
+  const handleOptionsQuery = useCallback3(
+    (query) => {
+      ensureLoader()?.setQuery(query);
+    },
+    [ensureLoader]
+  );
   const handleChange = useCallback3(
     (v) => onValueChangeField(v, name),
     [onValueChangeField, name]
@@ -720,63 +827,52 @@ var FieldInputInner = ({
   );
   if (fields) {
     const items = Array.isArray(renderInfos[name]) ? renderInfos[name] : [];
-    return /* @__PURE__ */ jsx7(
+    return /* @__PURE__ */ jsx8(
       FieldGroupInput_default,
       {
         fieldDescription,
         items,
         rootData,
+        errors,
+        touched: touchedMap,
+        onBlurField,
         onChange: handleChange
       }
     );
   }
-  const effectiveDisabled = resolveDisabled(
+  const rendererProps = buildFieldRendererProps({
     fieldDescription,
-    renderInfos,
-    rootData
-  );
-  const readOnly = resolveReadOnly(fieldDescription, renderInfos, rootData);
-  const resolvedOptionsList = resolveOptions(
-    fieldDescription,
-    renderInfos,
-    rootData
-  );
-  const errors = effectiveDisabled ? [] : validateField(fieldDescription, renderInfos[name], renderInfos, rootData);
-  const error = errors.length > 0 ? errors : void 0;
-  const fieldId = `dfk-field-${name}`;
-  return /* @__PURE__ */ jsx7(
+    data: renderInfos,
+    rootData,
+    id: makeFieldId(fieldDescription, idPrefix),
+    touched,
+    dirty,
+    validationErrors: errors === void 0 ? void 0 : errors[name] ?? [],
+    optionsState
+  });
+  return /* @__PURE__ */ jsx8(
     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__ */ React6.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 (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;
 
 // src/components/DynamicFormDevTools.tsx
-import { useState as useState3 } from "react";
-import { jsx as jsx8, jsxs as jsxs5 } from "react/jsx-runtime";
+import { useState as useState4 } from "react";
+import { jsx as jsx9, jsxs as jsxs5 } from "react/jsx-runtime";
 var DynamicFormDevTools = ({
   data,
   errors = {},
@@ -785,8 +881,8 @@ var DynamicFormDevTools = ({
   fields = [],
   position = "bottom-right"
 }) => {
-  const [isOpen, setIsOpen] = useState3(false);
-  const [activeTab, setActiveTab] = useState3("data");
+  const [isOpen, setIsOpen] = useState4(false);
+  const [activeTab, setActiveTab] = useState4("data");
   const errorCount = Object.keys(errors).length;
   const posStyle = position === "bottom-left" ? { left: "16px", bottom: "16px" } : { right: "16px", bottom: "16px" };
   if (!isOpen) {
@@ -813,8 +909,8 @@ var DynamicFormDevTools = ({
           gap: "6px"
         },
         children: [
-          /* @__PURE__ */ jsx8("span", { children: "\u{1F50D} DevTools" }),
-          errorCount > 0 && /* @__PURE__ */ jsx8(
+          /* @__PURE__ */ jsx9("span", { children: "\u{1F50D} DevTools" }),
+          errorCount > 0 && /* @__PURE__ */ jsx9(
             "span",
             {
               style: {
@@ -864,8 +960,8 @@ var DynamicFormDevTools = ({
               borderBottom: "1px solid #334155"
             },
             children: [
-              /* @__PURE__ */ jsx8("span", { style: { fontWeight: "bold", color: "#38bdf8" }, children: "\u{1F6E0}\uFE0F Form DevTools" }),
-              /* @__PURE__ */ jsx8(
+              /* @__PURE__ */ jsx9("span", { style: { fontWeight: "bold", color: "#38bdf8" }, children: "\u{1F6E0}\uFE0F Form DevTools" }),
+              /* @__PURE__ */ jsx9(
                 "button",
                 {
                   type: "button",
@@ -883,7 +979,7 @@ var DynamicFormDevTools = ({
             ]
           }
         ),
-        /* @__PURE__ */ jsx8(
+        /* @__PURE__ */ jsx9(
           "div",
           {
             style: {
@@ -918,7 +1014,7 @@ var DynamicFormDevTools = ({
           }
         ),
         /* @__PURE__ */ jsxs5("div", { style: { padding: "12px", overflowY: "auto", flex: 1 }, children: [
-          activeTab === "data" && /* @__PURE__ */ jsx8(
+          activeTab === "data" && /* @__PURE__ */ jsx9(
             "pre",
             {
               style: {
@@ -930,24 +1026,24 @@ var DynamicFormDevTools = ({
               children: JSON.stringify(data, null, 2)
             }
           ),
-          activeTab === "errors" && /* @__PURE__ */ jsx8("div", { children: Object.keys(errors).length === 0 ? /* @__PURE__ */ jsx8("span", { style: { color: "#4ade80" }, children: "\u2713 No validation errors" }) : Object.entries(errors).map(([field, msgs]) => /* @__PURE__ */ jsxs5("div", { style: { marginBottom: "8px" }, children: [
+          activeTab === "errors" && /* @__PURE__ */ jsx9("div", { children: Object.keys(errors).length === 0 ? /* @__PURE__ */ jsx9("span", { style: { color: "#4ade80" }, children: "\u2713 No validation errors" }) : Object.entries(errors).map(([field, msgs]) => /* @__PURE__ */ jsxs5("div", { style: { marginBottom: "8px" }, children: [
             /* @__PURE__ */ jsxs5("span", { style: { color: "#f87171", fontWeight: "bold" }, children: [
               field,
               ":"
             ] }),
-            /* @__PURE__ */ jsx8("ul", { style: { margin: "4px 0 0 16px", padding: 0 }, children: msgs.map((m, i) => /* @__PURE__ */ jsx8("li", { style: { color: "#fca5a5" }, children: m }, i)) })
+            /* @__PURE__ */ jsx9("ul", { style: { margin: "4px 0 0 16px", padding: 0 }, children: msgs.map((m, i) => /* @__PURE__ */ jsx9("li", { style: { color: "#fca5a5" }, children: m }, i)) })
           ] }, field)) }),
           activeTab === "meta" && /* @__PURE__ */ jsxs5("div", { children: [
             /* @__PURE__ */ jsxs5("div", { style: { marginBottom: "6px" }, children: [
-              /* @__PURE__ */ jsx8("span", { style: { color: "#94a3b8" }, children: "isDirty: " }),
-              /* @__PURE__ */ jsx8("span", { style: { color: isDirty ? "#facc15" : "#4ade80" }, children: String(isDirty) })
+              /* @__PURE__ */ jsx9("span", { style: { color: "#94a3b8" }, children: "isDirty: " }),
+              /* @__PURE__ */ jsx9("span", { style: { color: isDirty ? "#facc15" : "#4ade80" }, children: String(isDirty) })
             ] }),
             /* @__PURE__ */ jsxs5("div", { children: [
-              /* @__PURE__ */ jsx8("span", { style: { color: "#94a3b8" }, children: "Touched Fields:" }),
-              /* @__PURE__ */ jsx8("pre", { style: { margin: "4px 0 0 0", color: "#cbd5e1" }, children: JSON.stringify(touched, null, 2) })
+              /* @__PURE__ */ jsx9("span", { style: { color: "#94a3b8" }, children: "Touched Fields:" }),
+              /* @__PURE__ */ jsx9("pre", { style: { margin: "4px 0 0 0", color: "#cbd5e1" }, children: JSON.stringify(touched, null, 2) })
             ] })
           ] }),
-          activeTab === "fields" && /* @__PURE__ */ jsx8("div", { children: fields.length === 0 ? /* @__PURE__ */ jsx8("span", { style: { color: "#94a3b8" }, children: "No field descriptions passed" }) : fields.map((f) => /* @__PURE__ */ jsxs5(
+          activeTab === "fields" && /* @__PURE__ */ jsx9("div", { children: fields.length === 0 ? /* @__PURE__ */ jsx9("span", { style: { color: "#94a3b8" }, children: "No field descriptions passed" }) : fields.map((f) => /* @__PURE__ */ jsxs5(
             "div",
             {
               style: {
@@ -957,7 +1053,7 @@ var DynamicFormDevTools = ({
                 borderRadius: "4px"
               },
               children: [
-                /* @__PURE__ */ jsx8("div", { style: { color: "#38bdf8", fontWeight: "bold" }, children: f.name }),
+                /* @__PURE__ */ jsx9("div", { style: { color: "#38bdf8", fontWeight: "bold" }, children: f.name }),
                 /* @__PURE__ */ jsxs5("div", { style: { color: "#94a3b8", fontSize: "10px" }, children: [
                   "type: ",
                   f.type,
@@ -977,39 +1073,138 @@ var DynamicFormDevTools = ({
 // src/useDynamicForm.ts
 import {
   applyComputedValues as applyComputedValues2,
-  validateFields as validateFields2
+  collectFieldPaths,
+  createMessageResolver,
+  validateFields as validateFields2,
+  validateFieldsAsync
 } from "@dynamic-field-kit/core";
-import { useCallback as useCallback4, useState as useState4 } from "react";
+import { useCallback as useCallback4, useEffect as useEffect4, useRef as useRef3, useState as useState5 } from "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 [data, setData] = useState4(
+  const validationContextRef = useRef3({
+    t: createMessageResolver(messages)
+  });
+  validationContextRef.current.t = createMessageResolver(messages);
+  const [data, setData] = useState5(
     () => applyComputedValues2(fields, initialValues)
   );
-  const [errors, setErrors] = useState4({});
-  const [isDirty, setIsDirty] = useState4(false);
-  const [touched, setTouched] = useState4({});
-  const [isSubmitting, setIsSubmitting] = useState4(false);
-  const [isSubmitted, setIsSubmitted] = useState4(false);
+  const [errors, setErrors] = useState5({});
+  const [isDirty, setIsDirty] = useState5(false);
+  const [touched, setTouched] = useState5({});
+  const [isSubmitting, setIsSubmitting] = useState5(false);
+  const [isSubmitted, setIsSubmitted] = useState5(false);
+  const [validationResult, setValidationResult] = useState5(
+    () => validateFields2(fields, data, void 0, validationContextRef.current)
+  );
+  const [isValidating, setIsValidating] = useState5(false);
+  const validationRunRef = useRef3(0);
+  const validationAbortRef = useRef3(void 0);
+  const submitRunRef = useRef3(0);
+  const submitAbortRef = useRef3(void 0);
+  const dataRef = useRef3(data);
+  dataRef.current = data;
+  const baselineRef = useRef3(dataRef.current);
+  const [baselineValues, setBaselineValues] = useState5(
+    () => baselineRef.current
+  );
+  const commitSyncResult = useCallback4((res) => {
+    setValidationResult(
+      (previous) => sameValidationResult(previous, res) ? previous : res
+    );
+    return res.valid;
+  }, []);
+  const lastValidatedRef = useRef3(void 0);
+  const fieldsRef = useRef3(fields);
+  if (fieldsRef.current !== fields) {
+    fieldsRef.current = fields;
+    lastValidatedRef.current = void 0;
+  }
+  useEffect4(() => {
+    if (lastValidatedRef.current === data) {
+      return;
+    }
+    lastValidatedRef.current = data;
+    commitSyncResult(
+      validateFields2(fields, data, void 0, validationContextRef.current)
+    );
+  }, [fields, data, commitSyncResult]);
+  useEffect4(
+    () => () => {
+      validationAbortRef.current?.abort();
+      submitAbortRef.current?.abort();
+    },
+    []
+  );
   const validate = useCallback4(() => {
-    const res = validateFields2(fields, data);
+    const res = validateFields2(
+      fields,
+      data,
+      void 0,
+      validationContextRef.current
+    );
     setErrors(res.errors);
-    return res.valid;
+    return commitSyncResult(res);
+  }, [fields, data, commitSyncResult]);
+  const validateAsync = useCallback4(async () => {
+    const run = ++validationRunRef.current;
+    validationAbortRef.current?.abort();
+    const controller = new AbortController();
+    validationAbortRef.current = controller;
+    const snapshot = data;
+    setIsValidating(true);
+    try {
+      const res = await 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 = useCallback4(
     (newData) => {
       const next = applyComputedValues2(fields, newData);
       setData(next);
+      dataRef.current = next;
       setIsDirty(true);
+      validationAbortRef.current?.abort();
+      validationRunRef.current += 1;
+      setIsValidating(false);
+      lastValidatedRef.current = next;
+      const res = validateFields2(
+        fields,
+        next,
+        void 0,
+        validationContextRef.current
+      );
+      commitSyncResult(res);
       if (validateOnChange) {
-        const res = validateFields2(fields, next);
         setErrors(res.errors);
       }
     },
-    [fields, validateOnChange]
+    [fields, validateOnChange, commitSyncResult]
   );
   const setFieldValue = useCallback4(
     (name, value) => {
@@ -1020,26 +1215,57 @@ function useDynamicForm({
   const setFieldTouched = useCallback4((name, isTouched = true) => {
     setTouched((prev) => ({ ...prev, [name]: isTouched }));
   }, []);
+  const touchAll = useCallback4(() => {
+    setTouched(
+      Object.fromEntries(
+        collectFieldPaths(fields, data).map((path) => [path, true])
+      )
+    );
+  }, [fields, data]);
+  const resetTouched = useCallback4(() => setTouched({}), []);
+  const getDirtyValues = useCallback4(() => {
+    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 = useCallback4(
     (fieldName) => {
       setFieldTouched(fieldName, true);
       if (validateOnBlur) {
-        const res = validateFields2(fields, data);
+        const res = validateFields2(
+          fields,
+          data,
+          void 0,
+          validationContextRef.current
+        );
         setErrors(res.errors);
+        commitSyncResult(res);
       }
     },
-    [fields, data, validateOnBlur, setFieldTouched]
+    [fields, data, validateOnBlur, setFieldTouched, commitSyncResult]
   );
   const reset = useCallback4(
     (newValues) => {
       const seed = newValues ?? initialValues;
       const next = applyComputedValues2(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]
   );
@@ -1049,37 +1275,77 @@ function useDynamicForm({
         e.preventDefault();
       }
       setIsSubmitting(true);
+      const submitRun = ++submitRunRef.current;
       try {
-        const res = validateFields2(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 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 = validateFields2(
+            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
   };
 }
@@ -1087,34 +1353,48 @@ function useDynamicForm({
 // src/index.ts
 import { FieldRegistry } from "@dynamic-field-kit/core";
 import {
-  validateField as validateField2,
+  buildFieldRendererProps as buildFieldRendererProps2,
+  makeFieldId as makeFieldId2,
+  makeErrorId as makeErrorId2,
+  FIELD_RENDERER_PROP_KEYS
+} from "@dynamic-field-kit/core";
+import {
+  validateField,
   validateFieldAsync,
   validateFields as validateFields3,
-  validateFieldsAsync,
-  resolveDisabled as resolveDisabled2,
-  resolveReadOnly as resolveReadOnly2,
-  resolveOptions as resolveOptions2,
+  validateFieldsAsync as validateFieldsAsync2,
+  collectFieldPaths as collectFieldPaths2,
+  indexGroupPathMap as indexGroupPathMap2,
+  resolveDisabled,
+  resolveReadOnly,
+  resolveOptions,
   validators
 } from "@dynamic-field-kit/core";
 export {
   DynamicFormDevTools,
   DynamicInput_default as DynamicInput,
+  FIELD_RENDERER_PROP_KEYS,
   FieldInput_default as FieldInput,
   FieldRegistry,
   FieldRegistryProvider,
   MultiFieldInput_default as MultiFieldInput,
+  buildFieldRendererProps2 as buildFieldRendererProps,
+  collectFieldPaths2 as collectFieldPaths,
   defaultRenderersMap,
   fieldRegistry,
   getDefaultRenderer,
+  indexGroupPathMap2 as indexGroupPathMap,
   layoutRegistry,
-  resolveDisabled2 as resolveDisabled,
-  resolveOptions2 as resolveOptions,
-  resolveReadOnly2 as resolveReadOnly,
+  makeErrorId2 as makeErrorId,
+  makeFieldId2 as makeFieldId,
+  resolveDisabled,
+  resolveOptions,
+  resolveReadOnly,
   useDynamicForm,
   useFieldRegistry,
-  validateField2 as validateField,
+  validateField,
   validateFieldAsync,
   validateFields3 as validateFields,
-  validateFieldsAsync,
+  validateFieldsAsync2 as validateFieldsAsync,
   validators
 };