@m4l/components 9.4.36 → 9.4.37-beta-feature-dynamicform-crear-componente.0

package/components/DynamicForm/helpers/resolveInitialValue/resolveInitialValue.js

@@ -0,0 +1,64 @@
+function s(r) {
+  if (r.currentValue && r.currentValue.isVisible) {
+    const e = r.currentValue, t = r.fieldType.rhfComponent === "RHFCheckableList", a = r.fieldType.rhfComponent === "RHFDaysOfWeekPicker", i = r.fieldType.rhfComponent === "RHFAutoComplete", o = r.fieldType.rhfComponent === "RHFSelect" && r.fieldType.rhfComponentProps?.isMultiple === !0;
+    if (i)
+      return;
+    if (o)
+      return [];
+    if (t || a) {
+      if (e.valueInteger !== null && e.valueInteger !== void 0)
+        return [e.valueInteger];
+      if (e.valueString !== null && e.valueString !== void 0)
+        try {
+          const u = JSON.parse(e.valueString);
+          if (Array.isArray(u))
+            return u;
+        } catch {
+          const u = Number(e.valueString);
+          return !isNaN(u) && e.valueString.trim() !== "" ? [u] : [e.valueString];
+        }
+      if (e.value)
+        try {
+          const u = JSON.parse(e.value);
+          if (Array.isArray(u))
+            return u;
+        } catch {
+          const u = Number(e.value);
+          return !isNaN(u) && e.value.trim() !== "" ? [u] : [e.value];
+        }
+      return [];
+    }
+    if (e.valueString !== null && e.valueString !== void 0)
+      return e.valueString;
+    if (e.valueInteger !== null && e.valueInteger !== void 0)
+      return e.valueInteger;
+    if (e.valueDouble !== null && e.valueDouble !== void 0)
+      return e.valueDouble;
+    if (e.valueBoolean !== null && e.valueBoolean !== void 0)
+      return e.valueBoolean;
+    if (e.valueTimestamp !== null && e.valueTimestamp !== void 0)
+      return e.valueTimestamp;
+    if (e.value) {
+      const u = Number(e.value);
+      return !isNaN(u) && e.value.trim() !== "" ? u : e.value;
+    }
+  }
+  if (r.defaultValue !== null && r.defaultValue !== void 0) {
+    if (r.fieldType.rhfComponent === "RHFCheckableList" || r.fieldType.rhfComponent === "RHFDaysOfWeekPicker")
+      try {
+        const t = JSON.parse(r.defaultValue);
+        if (Array.isArray(t))
+          return t;
+      } catch {
+        const t = Number(r.defaultValue);
+        return !isNaN(t) && r.defaultValue.trim() !== "" ? [t] : [r.defaultValue];
+      }
+    const e = Number(r.defaultValue);
+    return !isNaN(e) && r.defaultValue.trim() !== "" ? e : r.defaultValue;
+  }
+  const n = r.fieldType.id, l = r.fieldType.rhfComponent;
+  return l === "RHFCheckableList" || l === "RHFDaysOfWeekPicker" ? [] : l === "RHFAutoComplete" ? r.fieldType.rhfComponentProps?.isMultiple === !0 ? [] : null : l === "RHFRadioGroup" ? null : n === "fft_boolean" || n === "fft_checkbox" ? !1 : null;
+}
+export {
+  s as resolveInitialValue
+};

package/components/DynamicForm/helpers/resolveInitialValue/types.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Option shape used by RHFAutoComplete in DynamicForm (same as SelectOption).
+ */
+export type AutocompleteOptionValue = {
+    id: string | number;
+    label: string;
+};
+/**
+ * Return type of resolveInitialValue: the resolved initial value for a DynamicForm field.
+ * Can be a primitive, array (e.g. for checkable list), option object (for RHFAutoComplete), or null/undefined.
+ */
+export type ResolveInitialValueResult = string | number | boolean | (string | number)[] | AutocompleteOptionValue | null | undefined;
+//# sourceMappingURL=types.d.ts.map

package/components/DynamicForm/helpers/resolveInitialValue/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../../../../../packages/components/src/components/DynamicForm/helpers/resolveInitialValue/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,MAAM,uBAAuB,GAAG;IAAE,EAAE,EAAE,MAAM,GAAG,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC;AAE7E;;;GAGG;AACH,MAAM,MAAM,yBAAyB,GACjC,MAAM,GACN,MAAM,GACN,OAAO,GACP,CAAC,MAAM,GAAG,MAAM,CAAC,EAAE,GACnB,uBAAuB,GACvB,IAAI,GACJ,SAAS,CAAC"}

package/components/DynamicForm/helpers/stringifyJsonFieldsForSubmit/index.d.ts

@@ -0,0 +1,2 @@
+export { stringifyJsonFieldsForSubmit } from './stringifyJsonFieldsForSubmit';
+//# sourceMappingURL=index.d.ts.map

package/components/DynamicForm/helpers/stringifyJsonFieldsForSubmit/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../../../packages/components/src/components/DynamicForm/helpers/stringifyJsonFieldsForSubmit/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,4BAA4B,EAAE,MAAM,gCAAgC,CAAC"}

package/components/DynamicForm/helpers/stringifyJsonFieldsForSubmit/stringifyJsonFieldsForSubmit.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Utility to serialize object/array values to JSON strings for backend payloads.
+ * Used only at submit time so form state can keep rich values (Date, objects, arrays)
+ * while the API receives JSON strings where required.
+ */
+/**
+ * Serializes object/array fields in a record to JSON strings for submit.
+ * @param data - Form payload (after formatOutputData)
+ * @param stringifyJsonFields - If `true`, stringify all values that are plain objects or arrays.
+ *   If `string[]`, stringify only those field names (values are stringified only if they are object/array).
+ * @returns New record with stringified values where applicable
+ */
+export declare function stringifyJsonFieldsForSubmit(data: Record<string, unknown>, stringifyJsonFields: true | string[]): Record<string, unknown>;
+//# sourceMappingURL=stringifyJsonFieldsForSubmit.d.ts.map

package/components/DynamicForm/helpers/stringifyJsonFieldsForSubmit/stringifyJsonFieldsForSubmit.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stringifyJsonFieldsForSubmit.d.ts","sourceRoot":"","sources":["../../../../../../../../packages/components/src/components/DynamicForm/helpers/stringifyJsonFieldsForSubmit/stringifyJsonFieldsForSubmit.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAYH;;;;;;GAMG;AACH,wBAAgB,4BAA4B,CAC1C,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,mBAAmB,EAAE,IAAI,GAAG,MAAM,EAAE,GACnC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAiBzB"}

package/components/DynamicForm/helpers/stringifyJsonFieldsForSubmit/stringifyJsonFieldsForSubmit.js

@@ -0,0 +1,16 @@
+function s(r) {
+  return r == null ? !1 : typeof r == "object" && (Array.isArray(r) || r.constructor === Object);
+}
+function c(r, e) {
+  const o = Object.keys(r), n = { ...r };
+  for (const t of o) {
+    if (!(t in n))
+      continue;
+    const i = n[t];
+    s(i) && (n[t] = JSON.stringify(i));
+  }
+  return n;
+}
+export {
+  c as stringifyJsonFieldsForSubmit
+};

package/components/DynamicForm/hooks/useDynamicForm/useDynamicForm.d.ts

@@ -0,0 +1,16 @@
+import { DynamicFormApiResponse } from '../../types';
+/**
+ * Hook that prepares dynamic form data (initial values and validation schema).
+ *
+ * Responsibilities:
+ * - Resolve initial values
+ * - Create validation schema so that when a field is visible (including when
+ *   conditional rules make it visible), it uses its full validation schema.
+ *
+ * Note: This hook does NOT create formMethods; RHFormProvider does that.
+ */
+export declare function useDynamicForm(data: DynamicFormApiResponse): {
+    initialValues: Record<string, unknown>;
+    validationSchema: import('../../..').ValidationSchema<Record<string, unknown>>;
+};
+//# sourceMappingURL=useDynamicForm.d.ts.map

package/components/DynamicForm/hooks/useDynamicForm/useDynamicForm.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useDynamicForm.d.ts","sourceRoot":"","sources":["../../../../../../../../packages/components/src/components/DynamicForm/hooks/useDynamicForm/useDynamicForm.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,sBAAsB,EAAqB,MAAM,aAAa,CAAC;AAUxE;;;;;;;;;GASG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,sBAAsB;;;EAyF1D"}

package/components/DynamicForm/hooks/useDynamicForm/useDynamicForm.js

@@ -0,0 +1,90 @@
+import { useMemo as l } from "react";
+import { resolveInitialValue as S } from "../../helpers/resolveInitialValue/resolveInitialValue.js";
+import "yup";
+import { createFieldValidationSchema as b } from "../../helpers/createFieldValidationSchema/createFieldValidationSchema.js";
+import { evaluateConditionalRule as u } from "../../helpers/evaluateConditionalRule/evaluateConditionalRule.js";
+import "../../helpers/resolveFieldComponent/strategies/registry.js";
+import "@emotion/react/jsx-runtime";
+import "../../../hook-form/RHFTextField/RHFTextField.js";
+import "clsx";
+import "../../../hook-form/RHFSelect/constants.js";
+import "../../../hook-form/RHFSelect/slots/RHFSlots.js";
+import "react-hook-form";
+import "../../../../contexts/AppearanceComponentContext/AppearanceComponentContext.js";
+import "zustand";
+import "zustand/shallow";
+import "zustand/middleware";
+import "zustand/middleware/immer";
+import "@m4l/styles";
+import "@mui/material/utils/useId";
+import { useModuleDictionary as N } from "@m4l/core";
+import "../../../Label/slots/LabelSlots.js";
+import "../../../HelperError/HelperError.js";
+import "../../../NumberInput/NumberInput.js";
+import "../../../hook-form/RHFNumberInput/slots/RHFNumberInputSlots.js";
+import "../../../hook-form/RHFCheckbox/RHFCheckbox.js";
+import "../../../hook-form/RHFCheckableList/constants.js";
+import "../../../hook-form/RHFCheckableList/slots/RHFCheckableListSlots.js";
+import "../../slots/DynamicFormSlots.js";
+import "../../../hook-form/RHFDaysOfWeekPicker/RHFDaysOfWeekPicker.js";
+import "../../../hook-form/RHFDateRangePicker/RHFDateRangePicker.js";
+import "../../../extended/mui/Autocomplete/Autocomplete.js";
+import "../../../hook-form/RHFAutocomplete/slots/RHFAutocompleteSlots.js";
+import "../../../hook-form/RHFAutocomplete/constants.js";
+import "../../../extended/mui/Radio/Radio.js";
+import "../../../hook-form/RHFRadioGroup/slots/styled.js";
+import "../../../Icon/constants.js";
+import "../../../Icon/slots/IconSlots.js";
+import "../../../hook-form/RHFRadioGroup/constants.js";
+import { createValidationPartialObject as g, createValidationSchema as w, createValidationFullObject as A } from "../../../hook-form/RHFormProvider/schema.js";
+function lo(h) {
+  const { fields: a, conditionalRules: p } = h, { getLabel: s } = N(), d = l(() => {
+    const r = {};
+    return a.forEach((o) => {
+      o.currentValue?.isVisible !== !1 && (r[o.name] = S(o));
+    }), r;
+  }, [a]), f = l(() => {
+    const r = g({});
+    return a.forEach((o) => {
+      const e = b(o, s);
+      if (!e)
+        return;
+      const V = !o.isConditional && o.currentValue?.isVisible !== !1;
+      if (o.isConditional === !1) {
+        r[o.name] = V ? e : e.optional();
+        return;
+      }
+      const c = (p || []).filter(
+        (t) => t.isActive && t.targetFieldName === o.name
+      ), m = [...new Set(c.map((t) => t.sourceFieldName))];
+      if (m.length === 0) {
+        r[o.name] = e.optional();
+        return;
+      }
+      const y = e.when(
+        m,
+        {
+          /** Returns true when the field is visible (any show rule met or any hide rule not met). */
+          is: (t) => {
+            const F = Array.isArray(t) ? t : [t], n = {};
+            return m.forEach((i, v) => {
+              n[i] = F[v];
+            }), c.some(
+              (i) => i.actionType === "show" && u(i, n[i.sourceFieldName]) || i.actionType === "hide" && !u(i, n[i.sourceFieldName])
+            );
+          },
+          then: (t) => t,
+          otherwise: (t) => t.optional()
+        }
+      );
+      r[o.name] = y;
+    }), w(A(r));
+  }, [a, p, s]);
+  return {
+    initialValues: d,
+    validationSchema: f
+  };
+}
+export {
+  lo as useDynamicForm
+};

package/components/DynamicForm/hooks/useDynamicFormConditionals/useDynamicFormConditionals.d.ts

@@ -0,0 +1,13 @@
+import { DynamicFormApiResponse } from '../../types';
+/**
+ * Hook that manages conditional rules for the dynamic form.
+ * Must be used inside RHFormProvider context.
+ *
+ * Responsibilities:
+ * - Evaluate conditional rules
+ * - Manage field visibility
+ */
+export declare function useDynamicFormConditionals(data: DynamicFormApiResponse): {
+    visibleFields: import('../../types').Field[];
+};
+//# sourceMappingURL=useDynamicFormConditionals.d.ts.map

package/components/DynamicForm/hooks/useDynamicFormConditionals/useDynamicFormConditionals.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useDynamicFormConditionals.d.ts","sourceRoot":"","sources":["../../../../../../../../packages/components/src/components/DynamicForm/hooks/useDynamicFormConditionals/useDynamicFormConditionals.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,sBAAsB,EAAsC,MAAM,aAAa,CAAC;AAGzF;;;;;;;GAOG;AACH,wBAAgB,0BAA0B,CAAC,IAAI,EAAE,sBAAsB;;EA8DtE"}

package/components/DynamicForm/hooks/useDynamicFormConditionals/useDynamicFormConditionals.js

@@ -0,0 +1,25 @@
+import { useState as f, useEffect as m, useMemo as u } from "react";
+import { useFormContext as F, useWatch as h } from "react-hook-form";
+import { evaluateConditionalRule as p } from "../../helpers/evaluateConditionalRule/evaluateConditionalRule.js";
+function v(l) {
+  const { fields: s, conditionalRules: o } = l, { control: c } = F(), [n, r] = f(() => {
+    const i = /* @__PURE__ */ new Set();
+    return s.forEach((e) => {
+      !e.isConditional && e.currentValue?.isVisible !== !1 && i.add(e.name);
+    }), i;
+  }), a = h({ control: c });
+  return m(() => {
+    const i = /* @__PURE__ */ new Set();
+    s.forEach((e) => {
+      !e.isConditional && e.currentValue?.isVisible !== !1 && i.add(e.name);
+    }), o.filter((e) => e.isActive).forEach((e) => {
+      const d = a[e.sourceFieldName], t = p(e, d);
+      t && e.actionType === "show" ? i.add(e.targetFieldName) : !t && e.actionType === "show" || t && e.actionType === "hide" || !t && e.actionType === "hide" && i.add(e.targetFieldName);
+    }), r(i);
+  }, [a, o, s]), {
+    visibleFields: u(() => s.filter((i) => n.has(i.name)).sort((i, e) => i.displayOrder - e.displayOrder), [s, n])
+  };
+}
+export {
+  v as useDynamicFormConditionals
+};

package/components/DynamicForm/hooks/useDynamicFormCoupled/index.d.ts

@@ -0,0 +1,3 @@
+export { useDynamicFormCoupled } from './useDynamicFormCoupled';
+export type { UseDynamicFormCoupledProps, UseDynamicFormCoupledReturn } from './types';
+//# sourceMappingURL=index.d.ts.map

package/components/DynamicForm/hooks/useDynamicFormCoupled/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../../../packages/components/src/components/DynamicForm/hooks/useDynamicFormCoupled/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AAChE,YAAY,EAAE,0BAA0B,EAAE,2BAA2B,EAAE,MAAM,SAAS,CAAC"}

package/components/DynamicForm/hooks/useDynamicFormCoupled/types.d.ts

@@ -0,0 +1,43 @@
+import { ObjectShape } from 'yup/lib/object';
+import { FormStatusLoad, ValidationSchema } from '../../../hook-form/RHFormProvider/types';
+import { DynamicFormApiResponse, DynamicFormValues, DynamicFormPropsCoupled } from '../../types';
+/**
+ * Props for useDynamicFormCoupled.
+ * Picked from DynamicFormPropsCoupled (fetch/send and initial data); initialData is optional
+ * and nullable since the hook can run without pre-loaded data.
+ *
+ * In coupled mode you can attach external (sibling) fields to the same form:
+ * - siblingInitialValues: initial values for those fields
+ * - siblingValidationShape: Yup shape (field name -> schema) for those fields
+ * They are merged with the dynamic form values/schema so one RHFormProvider drives both.
+ */
+export type UseDynamicFormCoupledProps = Pick<DynamicFormPropsCoupled, 'formId' | 'formInstanceId' | 'inputEndpoint' | 'outputEndpoint' | 'formatInputData' | 'formatOutputData' | 'onSubmit'> & {
+    /** Pre-loaded form data; when provided, fetch can be skipped or used as fallback. */
+    initialData?: DynamicFormApiResponse | null;
+    /** Initial values for external fields (merged with dynamic form values). Coupled only. */
+    siblingInitialValues?: Record<string, unknown>;
+    /** Validation shape for external fields (field name -> Yup schema). Merged with dynamic form schema. Coupled only. */
+    siblingValidationShape?: ObjectShape;
+};
+/**
+ * Return type of useDynamicFormCoupled.
+ * Combines data/send logic (useDynamicFormData) with schema/values (useDynamicForm)
+ * for use when DynamicForm runs in coupled mode (inside an existing RHFormProvider).
+ */
+export interface UseDynamicFormCoupledReturn {
+    /** Raw form data from fetch or initialData (null until loaded). */
+    formData: DynamicFormApiResponse | null;
+    /** Form data to use for rendering: formData ?? initialData. */
+    formDataToUse: DynamicFormApiResponse | null;
+    /** Load state for coupled UI (skeleton when not 'ready'). */
+    statusLoad: FormStatusLoad;
+    /** Submit handler (sends to outputEndpoint or calls onSubmit). */
+    handleSubmit: (data: Record<string, unknown>) => Promise<void>;
+    /** Initial values for RHFormProvider (from formDataToUse). */
+    initialValues: DynamicFormValues;
+    /** Validation schema for RHFormProvider (from formDataToUse). */
+    validationSchema: ValidationSchema<DynamicFormValues>;
+    /** True while a request is in progress. */
+    isLoading: boolean;
+}
+//# sourceMappingURL=types.d.ts.map

package/components/DynamicForm/hooks/useDynamicFormCoupled/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../../../../../packages/components/src/components/DynamicForm/hooks/useDynamicFormCoupled/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAClD,OAAO,EAAE,cAAc,EAAE,MAAM,yCAAyC,CAAC;AACzE,OAAO,EAAE,sBAAsB,EAAE,iBAAiB,EAAE,uBAAuB,EAAE,MAAM,aAAa,CAAC;AACjG,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,yCAAyC,CAAC;AAEhF;;;;;;;;;GASG;AACH,MAAM,MAAM,0BAA0B,GAAG,IAAI,CAC3C,uBAAuB,EACrB,QAAQ,GACR,gBAAgB,GAChB,eAAe,GACf,gBAAgB,GAChB,iBAAiB,GACjB,kBAAkB,GAClB,UAAU,CACb,GAAG;IACF,qFAAqF;IACrF,WAAW,CAAC,EAAE,sBAAsB,GAAG,IAAI,CAAC;IAC5C,0FAA0F;IAC1F,oBAAoB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC/C,sHAAsH;IACtH,sBAAsB,CAAC,EAAE,WAAW,CAAC;CACtC,CAAC;AAEF;;;;GAIG;AACH,MAAM,WAAW,2BAA2B;IAC1C,mEAAmE;IACnE,QAAQ,EAAE,sBAAsB,GAAG,IAAI,CAAC;IACxC,+DAA+D;IAC/D,aAAa,EAAE,sBAAsB,GAAG,IAAI,CAAC;IAC7C,6DAA6D;IAC7D,UAAU,EAAE,cAAc,CAAC;IAC3B,kEAAkE;IAClE,YAAY,EAAE,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAC/D,8DAA8D;IAC9D,aAAa,EAAE,iBAAiB,CAAC;IACjC,iEAAiE;IACjE,gBAAgB,EAAE,gBAAgB,CAAC,iBAAiB,CAAC,CAAC;IACtD,2CAA2C;IAC3C,SAAS,EAAE,OAAO,CAAC;CACpB"}

package/components/DynamicForm/hooks/useDynamicFormCoupled/useDynamicFormCoupled.d.ts

@@ -0,0 +1,54 @@
+import { UseDynamicFormCoupledProps, UseDynamicFormCoupledReturn } from './types';
+/**
+ * Hook that combines useDynamicFormData and useDynamicForm for coupled mode.
+ *
+ * In coupled mode the form is rendered inside an existing RHFormProvider (at the
+ * consumer site). This hook:
+ * 1. Fetches/sends form data (same as useDynamicFormData: formId, formInstanceId,
+ *    inputEndpoint, outputEndpoint, initialData, formatInputData, formatOutputData, onSubmit).
+ * 2. Derives initialValues and validationSchema from the form data (same as useDynamicForm).
+ *
+ * Fields with endpoint/params (RHFSelect, RHFCheckableList with empty options) have their
+ * options fetched inside DynamicFormContent via useFieldsWithFetchedOptions; no extra
+ * setup is needed when using this hook in coupled mode.
+ *
+ * The consumer uses the returned values to:
+ * - Pass formDataToUse, initialValues, validationSchema, statusLoad to DynamicForm (coupled=true)
+ *   or to their own RHFormProvider + DynamicFormContent.
+ * - Use statusLoad for loading UI (e.g. show skeleton when statusLoad !== 'ready').
+ * - Use handleSubmit when the parent form or flow triggers submit.
+ * @example
+ * ```tsx
+ * const {
+ *   formDataToUse,
+ *   initialValues,
+ *   validationSchema,
+ *   statusLoad,
+ *   handleSubmit,
+ * } = useDynamicFormCoupled({
+ *   formId,
+ *   formInstanceId,
+ *   inputEndpoint,
+ *   outputEndpoint,
+ *   initialData,
+ *   formatInputData,
+ *   formatOutputData,
+ *   onSubmit,
+ * });
+ *
+ * if (statusLoad !== 'ready' || !formDataToUse) return <Skeleton />;
+ *
+ * return (
+ *   <RHFormProvider
+ *     values={initialValues}
+ *     validationSchema={validationSchema}
+ *     onSubmit={handleSubmit}
+ *     statusLoad={statusLoad}
+ *   >
+ *     <DynamicForm coupled initialData={formDataToUse} coupledStatusLoad={statusLoad} />
+ *   </RHFormProvider>
+ * );
+ * ```
+ */
+export declare function useDynamicFormCoupled(props: UseDynamicFormCoupledProps): UseDynamicFormCoupledReturn;
+//# sourceMappingURL=useDynamicFormCoupled.d.ts.map

package/components/DynamicForm/hooks/useDynamicFormCoupled/useDynamicFormCoupled.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useDynamicFormCoupled.d.ts","sourceRoot":"","sources":["../../../../../../../../packages/components/src/components/DynamicForm/hooks/useDynamicFormCoupled/useDynamicFormCoupled.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,0BAA0B,EAAE,2BAA2B,EAAE,MAAM,SAAS,CAAC;AAEvF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkDG;AACH,wBAAgB,qBAAqB,CACnC,KAAK,EAAE,0BAA0B,GAChC,2BAA2B,CAgE7B"}

package/components/DynamicForm/hooks/useDynamicFormCoupled/useDynamicFormCoupled.js

@@ -0,0 +1,53 @@
+import { useMemo as s } from "react";
+import * as V from "yup";
+import { EMPTY_DATA as F } from "../../constants.js";
+import { useDynamicFormData as j } from "../useDynamicFormData/useDynamicFormData.js";
+import { useDynamicForm as E } from "../useDynamicForm/useDynamicForm.js";
+function M(r) {
+  const {
+    formId: u,
+    formInstanceId: c,
+    inputEndpoint: l,
+    outputEndpoint: d,
+    formatInputData: p,
+    formatOutputData: f,
+    onSubmit: b,
+    initialData: i,
+    siblingInitialValues: t,
+    siblingValidationShape: a
+  } = r, {
+    formData: n,
+    statusLoad: h,
+    handleSubmit: D,
+    isLoading: S
+  } = j({
+    formId: u,
+    formInstanceId: c,
+    inputEndpoint: l,
+    outputEndpoint: d,
+    initialData: i,
+    formatInputData: p,
+    formatOutputData: f,
+    onSubmit: b
+  }), m = s(
+    () => n ?? i ?? null,
+    [n, i]
+  ), { initialValues: o, validationSchema: e } = E(m ?? F), y = s(() => !t || Object.keys(t).length === 0 ? o : { ...o, ...t }, [o, t]), g = s(() => {
+    if (!a || Object.keys(a).length === 0)
+      return e;
+    const I = { ...e.fields ?? {}, ...a };
+    return V.object().shape(I);
+  }, [e, a]);
+  return {
+    formData: n,
+    formDataToUse: m,
+    statusLoad: h,
+    handleSubmit: D,
+    initialValues: y,
+    validationSchema: g,
+    isLoading: S
+  };
+}
+export {
+  M as useDynamicFormCoupled
+};

package/components/DynamicForm/hooks/useDynamicFormData/types.d.ts

@@ -0,0 +1,20 @@
+import { FormStatusLoad } from '../../../hook-form/RHFormProvider/types';
+import { DynamicFormApiResponse } from '../../types';
+export interface UseDynamicFormDataProps {
+    formId?: number;
+    formInstanceId?: number;
+    inputEndpoint?: string;
+    outputEndpoint?: string;
+    formatInputData?: (data: Record<string, unknown>) => Record<string, unknown>;
+    formatOutputData?: (data: Record<string, unknown>) => Record<string, unknown>;
+    onSubmit?: (data: Record<string, unknown>) => void | Promise<void>;
+    initialData?: DynamicFormApiResponse | null;
+}
+export type DynamicFormDataStatusLoad = 'initial' | 'ready' | 'error';
+export interface UseDynamicFormDataReturn {
+    formData: DynamicFormApiResponse | null;
+    statusLoad: FormStatusLoad;
+    handleSubmit: (data: Record<string, unknown>) => Promise<void>;
+    isLoading: boolean;
+}
+//# sourceMappingURL=types.d.ts.map

package/components/DynamicForm/hooks/useDynamicFormData/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../../../../../packages/components/src/components/DynamicForm/hooks/useDynamicFormData/types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,yCAAyC,CAAC;AACzE,OAAO,EAAE,sBAAsB,EAAE,MAAM,aAAa,CAAC;AAErD,MAAM,WAAW,uBAAuB;IACtC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,eAAe,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC7E,gBAAgB,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC9E,QAAQ,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACnE,WAAW,CAAC,EAAE,sBAAsB,GAAG,IAAI,CAAC;CAC7C;AAED,MAAM,MAAM,yBAAyB,GACjC,SAAS,GACT,OAAO,GACP,OAAO,CAAC;AAEZ,MAAM,WAAW,wBAAwB;IACvC,QAAQ,EAAE,sBAAsB,GAAG,IAAI,CAAC;IACxC,UAAU,EAAE,cAAc,CAAC;IAC3B,YAAY,EAAE,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAC/D,SAAS,EAAE,OAAO,CAAC;CACpB"}

package/components/DynamicForm/hooks/useDynamicFormData/useDynamicFormData.d.ts

@@ -0,0 +1,14 @@
+import { UseDynamicFormDataProps, UseDynamicFormDataReturn } from './types';
+/**
+ * Hook that manages fetching and submitting dynamic form data.
+ *
+ * Responsibilities:
+ * - Fetch data from inputEndpoint via networkOperation
+ * - Apply formatInputData when provided
+ * - Manage loading state
+ * - Send data to outputEndpoint on submit
+ * - Apply formatOutputData before sending
+ * - Serialize objects/arrays to JSON only in the payload sent to the backend (standard behavior)
+ */
+export declare function useDynamicFormData(props: UseDynamicFormDataProps): UseDynamicFormDataReturn;
+//# sourceMappingURL=useDynamicFormData.d.ts.map

package/components/DynamicForm/hooks/useDynamicFormData/useDynamicFormData.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useDynamicFormData.d.ts","sourceRoot":"","sources":["../../../../../../../../packages/components/src/components/DynamicForm/hooks/useDynamicFormData/useDynamicFormData.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,uBAAuB,EAAE,wBAAwB,EAAE,MAAM,SAAS,CAAC;AAE5E;;;;;;;;;;GAUG;AACH,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,uBAAuB,GAC7B,wBAAwB,CA2J1B"}

package/components/DynamicForm/hooks/useDynamicFormData/useDynamicFormData.js

@@ -0,0 +1,74 @@
+import { useState as S, useRef as _, useEffect as D } from "react";
+import { useNetwork as g } from "@m4l/core";
+import { stringifyJsonFieldsForSubmit as h } from "../../helpers/stringifyJsonFieldsForSubmit/stringifyJsonFieldsForSubmit.js";
+function L(v) {
+  const {
+    formId: C,
+    formInstanceId: o,
+    inputEndpoint: a,
+    outputEndpoint: m,
+    formatInputData: c,
+    formatOutputData: w,
+    onSubmit: f,
+    initialData: s
+  } = v, { networkOperation: p } = g(), [b, y] = S(s || null), [n, u] = S(
+    a ? "edit" : s ? "ready" : "new"
+  ), [T, e] = S(!1), i = _(null);
+  return D(() => {
+    let r = !0;
+    if (n === "edit" && a) {
+      i.current && i.current.abort(), i.current = new AbortController(), e(!0);
+      const t = {};
+      o !== void 0 && (t.form_instance_id = o), p({
+        method: "GET",
+        endPoint: a,
+        parms: t,
+        timeout: 6e4,
+        isRemote: !0,
+        responseToCamelCase: !0,
+        signal: i.current.signal
+      }).then((l) => {
+        if (!r)
+          return;
+        let d = l;
+        c && (d = c(d)), y(d), u("reload_values_provider"), e(!1);
+      }).catch(() => {
+        r && (u("error"), e(!1));
+      });
+    } else n === "reload_values_provider" ? (u("ready"), e(!1)) : (n === "new" || n === "ready" && b) && e(!1);
+    return () => {
+      r = !1, i.current && i.current.abort();
+    };
+  }, [n, a, C, o, c, p, b]), D(() => {
+    a || (s ? (y(s), u("ready")) : (y(null), u("new")));
+  }, [s, a]), {
+    formData: b,
+    statusLoad: n,
+    handleSubmit: async (r) => {
+      if (!m) {
+        f && await f(h(r));
+        return;
+      }
+      e(!0);
+      try {
+        let t = r;
+        w && (t = w(r)), t = h(t, !0);
+        let l = m;
+        o !== void 0 && (l = `${m}/${o}`), await p({
+          method: o !== void 0 ? "PUT" : "POST",
+          endPoint: l,
+          data: t,
+          timeout: 6e4,
+          isRemote: !0,
+          bodyToSnakeCase: !0
+        }), f && await f(t);
+      } finally {
+        e(!1);
+      }
+    },
+    isLoading: T
+  };
+}
+export {
+  L as useDynamicFormData
+};

package/components/DynamicForm/hooks/useFieldsWithFetchedOptions/index.d.ts

@@ -0,0 +1,3 @@
+export { useFieldsWithFetchedOptions } from './useFieldsWithFetchedOptions';
+export type { UseFieldsWithFetchedOptionsProps, UseFieldsWithFetchedOptionsReturn } from './types';
+//# sourceMappingURL=index.d.ts.map

package/components/DynamicForm/hooks/useFieldsWithFetchedOptions/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../../../packages/components/src/components/DynamicForm/hooks/useFieldsWithFetchedOptions/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,2BAA2B,EAAE,MAAM,+BAA+B,CAAC;AAC5E,YAAY,EAAE,gCAAgC,EAAE,iCAAiC,EAAE,MAAM,SAAS,CAAC"}

package/components/DynamicForm/hooks/useFieldsWithFetchedOptions/normalizeOptionsResponse.d.ts

@@ -0,0 +1,7 @@
+import { FieldOption } from '../../types';
+/**
+ * Normalizes API response to FieldOption[].
+ * Supports array or { data: array } and snake_case or camelCase keys.
+ */
+export declare function normalizeOptionsResponse(response: unknown): FieldOption[];
+//# sourceMappingURL=normalizeOptionsResponse.d.ts.map

package/components/DynamicForm/hooks/useFieldsWithFetchedOptions/normalizeOptionsResponse.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"normalizeOptionsResponse.d.ts","sourceRoot":"","sources":["../../../../../../../../packages/components/src/components/DynamicForm/hooks/useFieldsWithFetchedOptions/normalizeOptionsResponse.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAe1C;;;GAGG;AACH,wBAAgB,wBAAwB,CAAC,QAAQ,EAAE,OAAO,GAAG,WAAW,EAAE,CAgBzE"}

package/components/DynamicForm/hooks/useFieldsWithFetchedOptions/normalizeOptionsResponse.js

@@ -0,0 +1,20 @@
+function l(r) {
+  let d = [];
+  if (Array.isArray(r))
+    d = r;
+  else if (r && typeof r == "object" && "data" in r) {
+    const a = r.data;
+    d = Array.isArray(a) ? a : [];
+  }
+  return d.map((a, i) => ({
+    id: a.id ?? i,
+    name: a.name ?? a.value ?? null,
+    value: String(a.value ?? a.id ?? ""),
+    isDefault: a.isDefault ?? a.is_default ?? !1,
+    displayOrder: a.displayOrder ?? a.display_order ?? i,
+    nameDictionaryId: a.nameDictionaryId ?? a.name_dictionary_id ?? 0
+  }));
+}
+export {
+  l as normalizeOptionsResponse
+};

package/components/DynamicForm/hooks/useFieldsWithFetchedOptions/types.d.ts

@@ -0,0 +1,12 @@
+import { Field } from '../../types';
+export interface UseFieldsWithFetchedOptionsProps {
+    /** Visible fields from useDynamicFormConditionals. */
+    fields: Field[];
+}
+export interface UseFieldsWithFetchedOptionsReturn {
+    /** Same fields with options populated from endpoint when applicable. */
+    fields: Field[];
+    /** True while any field options are being fetched. */
+    isLoadingOptions: boolean;
+}
+//# sourceMappingURL=types.d.ts.map

package/components/DynamicForm/hooks/useFieldsWithFetchedOptions/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../../../../../packages/components/src/components/DynamicForm/hooks/useFieldsWithFetchedOptions/types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AAEpC,MAAM,WAAW,gCAAgC;IAC/C,sDAAsD;IACtD,MAAM,EAAE,KAAK,EAAE,CAAC;CACjB;AAED,MAAM,WAAW,iCAAiC;IAChD,wEAAwE;IACxE,MAAM,EAAE,KAAK,EAAE,CAAC;IAChB,sDAAsD;IACtD,gBAAgB,EAAE,OAAO,CAAC;CAC3B"}