impact-nova 2.5.4 → 2.5.6

package/dist/form-react/hooks/useFieldVisibility.js

@@ -1,60 +1,53 @@
-import { useCallback as c, useRef as y, useEffect as I } from "react";
+import { useCallback as r, useRef as h, useEffect as y } from "react";
 import { getFieldDefaultValue as g } from "../utils/fieldDefaults.utils.js";
-import { computeIsFieldVisible as w, computeIsFieldDisabled as a } from "../../form-engine/field-dependency-graph.js";
-function R({
+import { computeIsFieldVisible as I, computeIsFieldDisabled as c } from "../../form-engine/field-dependency-graph.js";
+function E({
   form: e,
-  formConfig: u,
-  isCascadingDisabled: n
+  formConfig: d
 }) {
-  const p = c(
-    (t) => w(t, e.getValues()),
+  const f = r(
+    (i) => I(i, e.getValues()),
     [e]
-  ), D = c(
-    (t) => a(t, e.getValues(), {
-      isCascadingDisabled: n
-    }),
-    [e, n]
-  ), F = c(
-    (t) => a(t, e.getValues(), {
-      isCascadingDisabled: () => !1
-    }),
+  ), D = r(
+    (i) => c(i, e.getValues()),
     [e]
-  ), r = y(/* @__PURE__ */ new Set());
-  return I(() => {
-    const t = u.fields.filter(
-      (i) => i.disableDependency && i.disableDependency.length > 0
+  ), p = r(
+    (i) => c(i, e.getValues()),
+    [e]
+  ), u = h(/* @__PURE__ */ new Set());
+  return y(() => {
+    const i = d.fields.filter(
+      (s) => s.disableDependency && s.disableDependency.length > 0
     );
-    if (t.length === 0)
+    if (i.length === 0)
       return;
-    const o = (i) => {
-      const d = /* @__PURE__ */ new Set();
-      for (const l of t)
-        a(l, i ?? e.getValues(), {
-          isCascadingDisabled: n
-        }) && d.add(l.id);
-      return d;
+    const a = (s) => {
+      const n = /* @__PURE__ */ new Set();
+      for (const l of i)
+        c(l, s ?? e.getValues()) && n.add(l.id);
+      return n;
     };
-    r.current = o(void 0);
-    const V = e.watch((i, d) => {
-      if (!d.name)
+    u.current = a(void 0);
+    const F = e.watch((s, n) => {
+      if (!n.name)
         return;
-      const l = o(i), f = [];
-      for (const s of l)
-        r.current.has(s) || f.push(s);
-      r.current = l;
-      for (const s of f) {
-        const b = u.fields.find(
-          (h) => h.id === s
+      const l = a(s), o = [];
+      for (const t of l)
+        u.current.has(t) || o.push(t);
+      u.current = l;
+      for (const t of o) {
+        const b = d.fields.find(
+          (V) => V.id === t
         );
-        b && (e.setValue(s, g(b), {
+        b && (e.setValue(t, g(b), {
           shouldValidate: !1,
           shouldDirty: !0
-        }), e.clearErrors(s));
+        }), e.clearErrors(t));
       }
     });
-    return () => V.unsubscribe();
-  }, [e, u.fields, n]), { isFieldVisible: p, isFieldDisabled: D, isFieldDisabledForSubmitValidation: F };
+    return () => F.unsubscribe();
+  }, [e, d.fields]), { isFieldVisible: f, isFieldDisabled: D, isFieldDisabledForSubmitValidation: p };
 }
 export {
-  R as useFieldVisibility
+  E as useFieldVisibility
 };

package/dist/form-react/hooks/useFormSteps.d.ts

@@ -0,0 +1,29 @@
+import { FieldGroup } from '../../form-engine';
+import { IField } from '../types/fields.types';
+import { IFormConfig, UseReactHookFormReturn } from '../types/reactHookForm.types';
+export interface UseFormStepsReturn {
+    groups: FieldGroup[];
+    currentStep: number;
+    totalSteps: number;
+    isFirstStep: boolean;
+    isLastStep: boolean;
+    /** Whether current step has no validation errors and all required fields are filled. */
+    canProceed: boolean;
+    /** Fields belonging to the current step. */
+    currentStepFields: IField[];
+    /** Advance to the next step. Validates current step first if `validateBeforeNext` is true. Returns false if blocked. */
+    goNext: () => boolean;
+    /** Go back one step (never gated by validation). */
+    goPrev: () => void;
+    /** Jump to a specific step index. Forward jumps validate intermediate steps. */
+    goToStep: (index: number) => void;
+    /** Check if a specific step is complete. */
+    isStepComplete: (stepIndex: number) => boolean;
+    /** Check if a step has been visited. */
+    isStepVisited: (stepIndex: number) => boolean;
+}
+/**
+ * Manages multi-step / grouped form navigation.
+ * Returns `null` when `formConfig.formType` is `'default'` or absent.
+ */
+export declare function useFormSteps(formConfig: IFormConfig, formHelpers: UseReactHookFormReturn): UseFormStepsReturn | null;

package/dist/form-react/hooks/useFormSteps.js

@@ -0,0 +1,96 @@
+import { useMemo as m, useState as F, useRef as N, useCallback as u } from "react";
+import { buildFieldGroups as k, isStepComplete as P } from "../../form-engine/field-groups.js";
+function L(i, g) {
+  const { formType: d } = i, s = m(() => !d || d === "default" ? [] : k(i.fields, i.steps), [d, i.fields, i.steps]), [r, o] = F(0), [w, c] = F(
+    () => /* @__PURE__ */ new Set([0])
+  ), I = m(() => {
+    if (s.length === 0) return /* @__PURE__ */ new Map();
+    const t = new Map(i.fields.map((n) => [n.id, n])), e = /* @__PURE__ */ new Map();
+    for (const n of s)
+      e.set(
+        n.groupId,
+        n.fieldIds.map((l) => t.get(l)).filter(Boolean)
+      );
+    return e;
+  }, [s, i.fields]), a = N(g);
+  a.current = g;
+  const p = u(
+    (t) => {
+      const e = s[t];
+      if (!e) return !1;
+      const n = a.current.form;
+      return P(
+        e.fieldIds,
+        i.fields,
+        n.getValues(),
+        n.formState.errors
+      );
+    },
+    [s, i.fields]
+  ), f = u(
+    async (t) => {
+      const e = s[t];
+      if (!e) return !1;
+      const n = e.fieldIds.filter((l) => {
+        const S = i.fields.find((G) => G.id === l);
+        return S ? a.current.isFieldVisible(S) : !1;
+      });
+      return n.length === 0 ? !0 : a.current.form.trigger(n);
+    },
+    [s, i.fields]
+  ), M = u(() => {
+    const t = s[r];
+    if (!t || r >= s.length - 1) return !1;
+    if (t.validateBeforeNext)
+      return f(r).then((n) => {
+        if (n) {
+          const l = r + 1;
+          o(l), c((S) => new Set(S).add(l));
+        }
+      }), p(r);
+    const e = r + 1;
+    return o(e), c((n) => new Set(n).add(e)), !0;
+  }, [r, s, f, p]), V = u(() => {
+    r > 0 && o(r - 1);
+  }, [r]), b = u(
+    (t) => {
+      if (!(t < 0 || t >= s.length || t === r)) {
+        if (t < r) {
+          o(t), c((e) => new Set(e).add(t));
+          return;
+        }
+        (async () => {
+          for (let e = r; e < t; e++)
+            if (s[e].validateBeforeNext && !await f(e)) {
+              o(e), c((l) => new Set(l).add(e));
+              return;
+            }
+          o(t), c((e) => new Set(e).add(t));
+        })();
+      }
+    },
+    [r, s, f]
+  ), y = u(
+    (t) => w.has(t),
+    [w]
+  );
+  if (!d || d === "default") return null;
+  const v = s.length, h = s[r], B = h ? I.get(h.groupId) ?? [] : [];
+  return {
+    groups: s,
+    currentStep: r,
+    totalSteps: v,
+    isFirstStep: r === 0,
+    isLastStep: r === v - 1,
+    canProceed: p(r),
+    currentStepFields: B,
+    goNext: M,
+    goPrev: V,
+    goToStep: b,
+    isStepComplete: p,
+    isStepVisited: y
+  };
+}
+export {
+  L as useFormSteps
+};

package/dist/form-react/hooks/useReactHookForm.js

@@ -6,9 +6,9 @@ import { useFieldVisibility as Z } from "./useFieldVisibility.js";
 import { useFormFieldChangeSubscription as _ } from "./useFormFieldChangeSubscription.js";
 import { getFieldDefaultValue as m } from "../utils/fieldDefaults.utils.js";
 import { focusFirstFormValidationError as $ } from "../utils/formValidationFeedback.utils.js";
-import { getFieldTestId as k } from "../utils/fieldTestIds.js";
-import { buildEvaluateFieldValidationOptions as x } from "../utils/evaluateFieldValidation.js";
-const de = (i, u, a, f, S, v) => {
+import { getFieldTestId as g } from "../utils/fieldTestIds.js";
+import { buildEvaluateFieldValidationOptions as k } from "../utils/evaluateFieldValidation.js";
+const de = (i, u, d, f, S, v) => {
   const y = l(() => {
     const e = {};
     return i.fields.forEach((t) => {
@@ -24,14 +24,14 @@ const de = (i, u, a, f, S, v) => {
     return Object.keys(u ?? {}).filter(
       (t) => !e.has(t)
     );
-  }, [i.fields, u]), d = P(() => {
+  }, [i.fields, u]), a = P(() => {
     const e = y(), t = T();
     return { ...e, ...t };
   }, [y, T]), r = X({
-    defaultValues: d,
+    defaultValues: a,
     mode: "onTouched",
     reValidateMode: "onChange"
-  }), I = c(d), R = c(null), w = c(() => {
+  }), I = c(a), R = c(null), w = c(() => {
   }), K = l((e) => I.current[e], []), H = c(
     new Set(i.fields.map((e) => e.id))
   );
@@ -60,19 +60,18 @@ const de = (i, u, a, f, S, v) => {
     $({
       fieldErrors: r.formState.errors,
       fieldsInOrder: i.fields,
-      getFieldTestId: k
+      getFieldTestId: g
     });
   }, [r.formState.errors, i.fields]);
   b(() => {
     F && p();
   }, [F, p]);
-  const { isCascadingDisabled: W, getEarlierFieldsIds: g, setValueWithCascading: q } = Y(r, i, {
+  const { getEarlierFieldsIds: W, setValueWithCascading: q } = Y(r, i, {
     getFieldDefaultValue: m,
     resolveFieldValidationEvaluationOptions: (e) => w.current(e)
   }), { isFieldVisible: E, isFieldDisabled: B, isFieldDisabledForSubmitValidation: G } = Z({
     form: r,
-    formConfig: i,
-    isCascadingDisabled: W
+    formConfig: i
   });
   _({
     form: r,
@@ -108,28 +107,28 @@ const de = (i, u, a, f, S, v) => {
       (t) => {
         j(!1);
         const s = n(t);
-        e?.(s), a?.(s);
+        e?.(s), d?.(s);
       },
       () => {
         j(!0);
       }
     ),
-    [r, n, a]
+    [r, n, d]
   ), L = l(
     (e) => {
-      const t = e || d;
+      const t = e || a;
       r.reset(t), S?.(t);
     },
-    [r, d, S]
+    [r, a, S]
   ), Q = l(() => {
     const e = r.getValues();
     f?.(e);
   }, [r, f]), U = l(
     (e) => {
       const t = r.getValues(), s = n(t);
-      e?.(s), a?.(s);
+      e?.(s), d?.(s);
     },
-    [r, n, a]
+    [r, n, d]
   ), h = {
     formId: i.formId,
     formConfig: i,
@@ -144,7 +143,7 @@ const de = (i, u, a, f, S, v) => {
     isFieldDisabled: B,
     isFieldDisabledForSubmitValidation: G,
     submitValidatedForm: U,
-    getEarlierFieldsIds: g,
+    getEarlierFieldsIds: W,
     scrollToFirstError: p,
     setToEmptyFields: V,
     markFieldAsEmpty: N,
@@ -153,7 +152,7 @@ const de = (i, u, a, f, S, v) => {
     formContext: v
   };
   return b(() => {
-    R.current = h, w.current = (e) => x(h, e);
+    R.current = h, w.current = (e) => k(h, e);
   }), h;
 };
 export {

package/dist/form-react/hooks/useSelectOptions.d.ts

@@ -1,6 +1,6 @@
 import { Option } from '../../components/forms/select';
 import { UseSelectOptionsProps } from '../types/reactHookForm.types';
-export declare const useSelectOptions: ({ apiConfig, formHelpers, formConfig, initialOptions, id, isEnabled, getSelectOptionsName, fieldSupportedValues, }: UseSelectOptionsProps) => {
+export declare const useSelectOptions: ({ apiConfig, formHelpers, initialOptions, id, isEnabled, getSelectOptionsName, fieldSupportedValues, cascadingDependency, }: UseSelectOptionsProps) => {
     options: Option[];
     isLoading: boolean;
     error: Error | null;

package/dist/form-react/hooks/useSelectOptions.js

@@ -1,116 +1,113 @@
-import { useMemo as V, useState as v, useRef as l, useEffect as N, useCallback as P } from "react";
-import { useWatch as j } from "react-hook-form";
-import { serializeFormStateForQueryKey as q } from "../utils/serializeFormStateForQueryKey.js";
-const X = ({
-  apiConfig: t,
-  formHelpers: o,
-  formConfig: k,
+import { useMemo as m, useState as E, useRef as a, useEffect as z, useCallback as L } from "react";
+import { useWatch as W } from "react-hook-form";
+import { serializeFormStateForQueryKey as _ } from "../utils/serializeFormStateForQueryKey.js";
+const B = ({
+  apiConfig: r,
+  formHelpers: c,
   initialOptions: d = [],
-  id: r,
-  isEnabled: D,
+  id: s,
+  isEnabled: N,
   getSelectOptionsName: i,
-  fieldSupportedValues: u
+  fieldSupportedValues: l,
+  cascadingDependency: y
 }) => {
-  const h = !!(k?.isCascading || t?.isCascading), p = o?.getEarlierFieldsIds, E = o?.form.getValues, y = j({
-    control: o?.form.control,
-    name: t?.cascadeFromFields ?? [],
-    disabled: !h || !o?.form.control || !t?.cascadeFromFields?.length
-  }), f = V(() => {
-    if (!h || !p || !E)
+  const u = m(() => {
+    const e = r?.fieldsToPassInApi ?? [];
+    if (!(r?.passCascadingDependencyFields !== !1))
+      return e;
+    const o = [...y?.map((t) => t.fieldId) ?? []];
+    return e.forEach((t) => {
+      o.includes(t) || o.push(t);
+    }), o;
+  }, [
+    r?.fieldsToPassInApi,
+    r?.passCascadingDependencyFields,
+    y
+  ]), f = W({
+    control: c?.form.control,
+    name: u,
+    disabled: !c?.form.control || !u.length
+  }), p = m(() => {
+    if (!u.length)
       return {};
-    const e = {};
-    if (t?.cascadeFromFields && t.cascadeFromFields.length > 0) {
-      const c = Array.isArray(y) ? y : [];
-      return t.cascadeFromFields.forEach((s, m) => {
-        const a = c[m];
-        a != null && a !== "" && (e[s] = a);
-      }), e;
-    }
-    const n = E(), O = t?.includeOnlyMandatoryFieldsInPayload || !1;
-    return p(r, O).forEach((c) => {
-      const s = n[c];
-      s != null && s !== "" && (e[c] = s);
+    const e = {}, n = Array.isArray(f) ? f : [f];
+    return u.forEach((F, o) => {
+      const t = n[o];
+      t != null && t !== "" && (e[F] = t);
     }), e;
-  }, [
-    t,
-    h,
-    y,
-    p,
-    E,
-    r
-  ]), G = V(
-    () => q(f),
-    [f]
-  ), J = V(
-    () => u ? JSON.stringify(u) : "",
-    [u]
-  ), [S, w] = v(d), [K, x] = v(!1), [Q, I] = v(null), R = l(o), g = l(t), b = l(f), C = l(u), z = l(d), A = l(i);
-  N(() => {
-    R.current = o, g.current = t, b.current = f, C.current = u, z.current = d, A.current = i;
+  }, [u, f]), T = m(
+    () => _(p),
+    [p]
+  ), k = m(
+    () => l ? JSON.stringify(l) : "",
+    [l]
+  ), [I, O] = E(d), [G, S] = E(!1), [J, g] = E(null), v = a(c), V = a(r), w = a(p), x = a(l), C = a(d), R = a(i);
+  z(() => {
+    v.current = c, V.current = r, w.current = p, x.current = l, C.current = d, R.current = i;
   });
-  const F = P(async () => {
-    const e = R.current, n = g.current, O = b.current, L = C.current, c = z.current, s = A.current;
+  const h = L(async () => {
+    const e = v.current, n = V.current, F = w.current, o = x.current, t = C.current, P = R.current;
     if (e) {
-      const a = s ? e.formContext?.getSelectOptions?.[s] : void 0;
-      if (a)
-        return await a({
+      const b = P ? e.formContext?.getSelectOptions?.[P] : void 0;
+      if (b)
+        return await b({
           formHelpers: e,
-          fieldId: r,
-          newValue: e.form.getValues(r),
-          oldValue: e.getPreviousFieldValue(r)
+          fieldId: s,
+          newValue: e.form.getValues(s),
+          oldValue: e.getPreviousFieldValue(s)
         });
     }
     if (!n?.apiEndpoint)
-      return c;
-    const m = e?.formContext?.transport?.fetchSelectOptions;
-    return m ? m({
-      fieldId: r,
+      return t;
+    const D = e?.formContext?.transport?.fetchSelectOptions;
+    return D ? D({
+      fieldId: s,
       apiConfig: n,
-      earlierFieldsValues: O,
-      fieldSupportedValues: L
+      earlierFieldsValues: F,
+      fieldSupportedValues: o
     }) : (process.env.NODE_ENV !== "production" && console.warn(
-      `[form-react] Select field "${r}" has apiConfig but no formContext.transport.fetchSelectOptions was provided.`
-    ), c);
-  }, [r]), W = !!(i && o?.formContext?.getSelectOptions?.[i]), M = D && (W || !!t?.apiEndpoint && !!o?.formContext?.transport?.fetchSelectOptions), _ = t?.apiEndpoint;
-  N(() => {
-    if (!M)
+      `[form-react] Select field "${s}" has apiConfig but no formContext.transport.fetchSelectOptions was provided.`
+    ), t);
+  }, [s]), K = !!(i && c?.formContext?.getSelectOptions?.[i]), A = N && (K || !!r?.apiEndpoint && !!c?.formContext?.transport?.fetchSelectOptions), M = r?.apiEndpoint;
+  z(() => {
+    if (!A)
       return;
     let e = !1;
     return (async () => {
-      x(!0), I(null);
+      S(!0), g(null);
       try {
-        const n = await F();
-        e || w(n);
+        const n = await h();
+        e || O(n);
       } catch (n) {
-        e || I(
+        e || g(
           n instanceof Error ? n : new Error("Failed to fetch options")
         );
       } finally {
-        e || x(!1);
+        e || S(!1);
       }
     })(), () => {
       e = !0;
     };
   }, [
-    M,
-    F,
-    G,
-    J,
+    A,
+    h,
+    T,
+    k,
     i,
-    _,
-    r
+    M,
+    s
   ]);
-  const $ = P(async () => {
-    const e = await F();
-    return w(e), e;
-  }, [F]);
+  const Q = L(async () => {
+    const e = await h();
+    return O(e), e;
+  }, [h]);
   return {
-    options: S.length > 0 ? S : d,
-    isLoading: K,
-    error: Q,
-    refetch: $
+    options: I.length > 0 ? I : d,
+    isLoading: G,
+    error: J,
+    refetch: Q
   };
 };
 export {
-  X as useSelectOptions
+  B as useSelectOptions
 };

package/dist/form-react/index.d.ts

@@ -18,6 +18,8 @@ export { useFieldVisibility } from './hooks/useFieldVisibility';
 export type { UseFieldVisibilityReturn } from './hooks/useFieldVisibility';
 export { useCascadingForm } from './hooks/useCascadingForm';
 export type { UseCascadingFormReturn } from './hooks/useCascadingForm';
+export { useFormSteps } from './hooks/useFormSteps';
+export type { UseFormStepsReturn } from './hooks/useFormSteps';
 export { useSelectOptions } from './hooks/useSelectOptions';
 export { useFillFormByPaste } from './hooks/useFillFormByPaste';
 export { useFillFormByFileUpload } from './hooks/useFillFormByFileUpload';
@@ -34,12 +36,12 @@ export { FormFileUploadWrapper } from './components/FormFileUploadWrapper';
 export { registerFieldType, getFieldComponent, hasRegisteredFieldType, listRegisteredFieldTypes, } from './registry/fieldRegistry';
 export { registerDefaultFieldTypes } from './registry/defaultFieldRegistrations';
 export { resolveFieldComponent, renderRegisteredField } from './registry/resolveFieldComponent';
-export type { IFormConfig, FormFieldProps, FieldVisibilityBase, ReactHooksFormProps, UseSelectOptionsProps, FormContext, FormValidationMeta, FormTransport, CustomFieldTypesMap, FetchSelectOptionsParams, PastedValuesValidationResult, ValidatePastedValuesParams, ValidateUploadedFileParams, UploadedFileValidationResult, ValidateTextFieldWithBackendParams, TextFieldBackendValidationResult, SupportedValuesMap, } from './types/reactHookForm.types';
+export type { IFormConfig, FormFieldProps, FormType, FormStepConfig, FormStepStateMeta, ReactHooksFormStepActions, FieldVisibilityBase, ReactHooksFormProps, UseSelectOptionsProps, FormContext, FormValidationMeta, FormTransport, CustomFieldTypesMap, FetchSelectOptionsParams, PastedValuesValidationResult, ValidatePastedValuesParams, ValidateUploadedFileParams, UploadedFileValidationResult, ValidateTextFieldWithBackendParams, TextFieldBackendValidationResult, SupportedValuesMap, } from './types/reactHookForm.types';
 export type { IField } from './types/fields.types';
 export type * from './types/fields.types';
 export type * from './types/fieldsOutput.types';
-export { isEmptyValue, buildCascadeParentFormState, collectFieldDependencyIds, collectFormWatchFieldIds, collectFilterSidebarWatchFieldIds, collectSectionWatchFieldIds, collectVisibleFieldIds, computeIsCascadingDisabled, computeIsFieldDisabled, computeIsFieldVisible, getDependentFieldIds, hasVisibleFieldErrors, } from '../form-engine';
-export type { FieldDependency, FormValuesSnapshot, } from '../form-engine';
+export { isEmptyValue, buildCascadeParentFormState, buildFieldGroups, collectFieldDependencyIds, collectFormWatchFieldIds, collectFilterSidebarWatchFieldIds, collectSectionWatchFieldIds, collectVisibleFieldIds, computeIsFieldDisabled, computeIsFieldVisible, getDependentFieldIds, getFirstIncompleteStep, hasVisibleFieldErrors, isStepComplete, } from '../form-engine';
+export type { FieldDependency, FieldGroup, FormValuesSnapshot, } from '../form-engine';
 export { getFieldDefaultValue } from './utils/fieldDefaults.utils';
 export { batchSetFormFieldValues } from './utils/batchFormFieldUpdates';
 export { serializeFormStateForQueryKey } from './utils/serializeFormStateForQueryKey';