impact-nova 2.5.4 → 2.5.6

package/dist/form-react/index.js

@@ -1,97 +1,102 @@
 import { ReactHooksForm as r, ReactHooksForm as t } from "./ReactHooksForm.js";
-import { useReactHookForm as l } from "./hooks/useReactHookForm.js";
+import { useReactHookForm as i } from "./hooks/useReactHookForm.js";
 import { useFieldVisibility as d } from "./hooks/useFieldVisibility.js";
 import { useCascadingForm as m } from "./hooks/useCascadingForm.js";
-import { useSelectOptions as p } from "./hooks/useSelectOptions.js";
-import { useFillFormByPaste as n } from "./hooks/useFillFormByPaste.js";
-import { useFillFormByFileUpload as c } from "./hooks/useFillFormByFileUpload.js";
-import { FieldRenderer as b } from "./components/FieldRenderer.js";
-import { FormFieldRow as y } from "./components/FormFieldRow.js";
-import { ObjectFieldRenderer as g } from "./components/ObjectFieldRenderer.js";
-import { ArrayFieldRenderer as h } from "./components/ArrayFieldRenderer.js";
-import { SetToEmptyWrapper as S } from "./components/SetToEmptyWrapper.js";
-import { FormFileUploadWrapper as v } from "./components/FormFileUploadWrapper.js";
-import { getFieldComponent as E, hasRegisteredFieldType as P, listRegisteredFieldTypes as W, registerFieldType as k } from "./registry/fieldRegistry.js";
-import { registerDefaultFieldTypes as B } from "./registry/defaultFieldRegistrations.js";
-import { renderRegisteredField as K, resolveFieldComponent as M } from "./registry/resolveFieldComponent.js";
-import { isEmptyValue as w } from "../form-engine/is-empty-value.js";
-import { buildCascadeParentFormState as U, collectFieldDependencyIds as j, collectFilterSidebarWatchFieldIds as A, collectFormWatchFieldIds as L, collectSectionWatchFieldIds as N, collectVisibleFieldIds as Q, computeIsCascadingDisabled as Y, computeIsFieldDisabled as G, computeIsFieldVisible as J, getDependentFieldIds as X, hasVisibleFieldErrors as Z } from "../form-engine/field-dependency-graph.js";
-import { getFieldDefaultValue as $ } from "./utils/fieldDefaults.utils.js";
-import { batchSetFormFieldValues as oe } from "./utils/batchFormFieldUpdates.js";
-import { serializeFormStateForQueryKey as te } from "./utils/serializeFormStateForQueryKey.js";
-import { buildFormValidationToastMessage as le, focusFirstFormValidationError as ae, showFormValidationFailureFeedback as de } from "./utils/formValidationFeedback.utils.js";
-import { buildFieldValidationRules as me, isFieldValueValid as Fe } from "./utils/buildFieldValidationRules.js";
-import { buildEvaluateFieldValidationOptions as fe, evaluateFieldValidation as ne, fieldNeedsValidationRules as ue } from "./utils/evaluateFieldValidation.js";
-import { evaluateVisibleRequiredFormFields as xe, validateVisibleRequiredFormFields as be } from "./utils/validateVisibleRequiredFormFields.js";
-import { resolveFormSubmittable as ye } from "./utils/resolveFormSubmittable.js";
-import { buildParentCascadeKey as ge, buildSelectRemountKey as Ie } from "./utils/buildSelectRemountKey.js";
-import { runFieldValidation as De } from "./utils/validationUtils.js";
-import { buildFieldPath as Ce, findFieldByPath as ve, flattenFieldIds as Te } from "./utils/fieldPath.utils.js";
-import { stableSerialize as Pe } from "./utils/stableSerialize.js";
-import { toCascadedFilterValues as ke } from "./utils/select-option-filter-values.js";
-import { formatYmd as Be, toLocalDate as He } from "./utils/calendar-boundary.js";
-import { handleDateFnsFormat as Me, startOfDayDate as qe } from "./utils/date.utils.js";
-import { buildRangeIncompleteMessage as ze, isRangeIncompleteValidationMessage as Ue } from "./utils/fieldRangeValidation.utils.js";
+import { useFormSteps as p } from "./hooks/useFormSteps.js";
+import { useSelectOptions as u } from "./hooks/useSelectOptions.js";
+import { useFillFormByPaste as x } from "./hooks/useFillFormByPaste.js";
+import { useFillFormByFileUpload as b } from "./hooks/useFillFormByFileUpload.js";
+import { FieldRenderer as y } from "./components/FieldRenderer.js";
+import { FormFieldRow as g } from "./components/FormFieldRow.js";
+import { ObjectFieldRenderer as I } from "./components/ObjectFieldRenderer.js";
+import { ArrayFieldRenderer as D } from "./components/ArrayFieldRenderer.js";
+import { SetToEmptyWrapper as v } from "./components/SetToEmptyWrapper.js";
+import { FormFileUploadWrapper as E } from "./components/FormFileUploadWrapper.js";
+import { getFieldComponent as W, hasRegisteredFieldType as k, listRegisteredFieldTypes as O, registerFieldType as B } from "./registry/fieldRegistry.js";
+import { registerDefaultFieldTypes as K } from "./registry/defaultFieldRegistrations.js";
+import { renderRegisteredField as q, resolveFieldComponent as w } from "./registry/resolveFieldComponent.js";
+import { isEmptyValue as U } from "../form-engine/is-empty-value.js";
+import { buildCascadeParentFormState as A, collectFieldDependencyIds as G, collectFilterSidebarWatchFieldIds as L, collectFormWatchFieldIds as N, collectSectionWatchFieldIds as Q, collectVisibleFieldIds as Y, computeIsFieldDisabled as J, computeIsFieldVisible as X, getDependentFieldIds as Z, hasVisibleFieldErrors as _ } from "../form-engine/field-dependency-graph.js";
+import { buildFieldGroups as ee, getFirstIncompleteStep as oe, isStepComplete as re } from "../form-engine/field-groups.js";
+import { getFieldDefaultValue as le } from "./utils/fieldDefaults.utils.js";
+import { batchSetFormFieldValues as ae } from "./utils/batchFormFieldUpdates.js";
+import { serializeFormStateForQueryKey as se } from "./utils/serializeFormStateForQueryKey.js";
+import { buildFormValidationToastMessage as Fe, focusFirstFormValidationError as pe, showFormValidationFailureFeedback as fe } from "./utils/formValidationFeedback.utils.js";
+import { buildFieldValidationRules as ne, isFieldValueValid as xe } from "./utils/buildFieldValidationRules.js";
+import { buildEvaluateFieldValidationOptions as be, evaluateFieldValidation as Ve, fieldNeedsValidationRules as ye } from "./utils/evaluateFieldValidation.js";
+import { evaluateVisibleRequiredFormFields as ge, validateVisibleRequiredFormFields as Se } from "./utils/validateVisibleRequiredFormFields.js";
+import { resolveFormSubmittable as he } from "./utils/resolveFormSubmittable.js";
+import { buildParentCascadeKey as Ce, buildSelectRemountKey as ve } from "./utils/buildSelectRemountKey.js";
+import { runFieldValidation as Ee } from "./utils/validationUtils.js";
+import { buildFieldPath as We, findFieldByPath as ke, flattenFieldIds as Oe } from "./utils/fieldPath.utils.js";
+import { stableSerialize as He } from "./utils/stableSerialize.js";
+import { toCascadedFilterValues as Me } from "./utils/select-option-filter-values.js";
+import { formatYmd as we, toLocalDate as ze } from "./utils/calendar-boundary.js";
+import { handleDateFnsFormat as je, startOfDayDate as Ae } from "./utils/date.utils.js";
+import { buildRangeIncompleteMessage as Le, isRangeIncompleteValidationMessage as Ne } from "./utils/fieldRangeValidation.utils.js";
 export {
-  h as ArrayFieldRenderer,
-  b as FieldRenderer,
-  y as FormFieldRow,
-  v as FormFileUploadWrapper,
-  g as ObjectFieldRenderer,
+  D as ArrayFieldRenderer,
+  y as FieldRenderer,
+  g as FormFieldRow,
+  E as FormFileUploadWrapper,
+  I as ObjectFieldRenderer,
   r as ReactHooksForm,
-  S as SetToEmptyWrapper,
-  oe as batchSetFormFieldValues,
-  U as buildCascadeParentFormState,
-  fe as buildEvaluateFieldValidationOptions,
-  Ce as buildFieldPath,
-  me as buildFieldValidationRules,
-  le as buildFormValidationToastMessage,
-  ge as buildParentCascadeKey,
-  ze as buildRangeIncompleteMessage,
-  Ie as buildSelectRemountKey,
-  j as collectFieldDependencyIds,
-  A as collectFilterSidebarWatchFieldIds,
-  L as collectFormWatchFieldIds,
-  N as collectSectionWatchFieldIds,
-  Q as collectVisibleFieldIds,
-  Y as computeIsCascadingDisabled,
-  G as computeIsFieldDisabled,
-  J as computeIsFieldVisible,
+  v as SetToEmptyWrapper,
+  ae as batchSetFormFieldValues,
+  A as buildCascadeParentFormState,
+  be as buildEvaluateFieldValidationOptions,
+  ee as buildFieldGroups,
+  We as buildFieldPath,
+  ne as buildFieldValidationRules,
+  Fe as buildFormValidationToastMessage,
+  Ce as buildParentCascadeKey,
+  Le as buildRangeIncompleteMessage,
+  ve as buildSelectRemountKey,
+  G as collectFieldDependencyIds,
+  L as collectFilterSidebarWatchFieldIds,
+  N as collectFormWatchFieldIds,
+  Q as collectSectionWatchFieldIds,
+  Y as collectVisibleFieldIds,
+  J as computeIsFieldDisabled,
+  X as computeIsFieldVisible,
   t as default,
-  ne as evaluateFieldValidation,
-  xe as evaluateVisibleRequiredFormFields,
-  ue as fieldNeedsValidationRules,
-  ve as findFieldByPath,
-  Te as flattenFieldIds,
-  ae as focusFirstFormValidationError,
-  Be as formatYmd,
-  X as getDependentFieldIds,
-  E as getFieldComponent,
-  $ as getFieldDefaultValue,
-  Me as handleDateFnsFormat,
-  P as hasRegisteredFieldType,
-  Z as hasVisibleFieldErrors,
-  w as isEmptyValue,
-  Fe as isFieldValueValid,
-  Ue as isRangeIncompleteValidationMessage,
-  W as listRegisteredFieldTypes,
-  B as registerDefaultFieldTypes,
-  k as registerFieldType,
-  K as renderRegisteredField,
-  M as resolveFieldComponent,
-  ye as resolveFormSubmittable,
-  De as runFieldValidation,
-  te as serializeFormStateForQueryKey,
-  de as showFormValidationFailureFeedback,
-  Pe as stableSerialize,
-  qe as startOfDayDate,
-  ke as toCascadedFilterValues,
-  He as toLocalDate,
+  Ve as evaluateFieldValidation,
+  ge as evaluateVisibleRequiredFormFields,
+  ye as fieldNeedsValidationRules,
+  ke as findFieldByPath,
+  Oe as flattenFieldIds,
+  pe as focusFirstFormValidationError,
+  we as formatYmd,
+  Z as getDependentFieldIds,
+  W as getFieldComponent,
+  le as getFieldDefaultValue,
+  oe as getFirstIncompleteStep,
+  je as handleDateFnsFormat,
+  k as hasRegisteredFieldType,
+  _ as hasVisibleFieldErrors,
+  U as isEmptyValue,
+  xe as isFieldValueValid,
+  Ne as isRangeIncompleteValidationMessage,
+  re as isStepComplete,
+  O as listRegisteredFieldTypes,
+  K as registerDefaultFieldTypes,
+  B as registerFieldType,
+  q as renderRegisteredField,
+  w as resolveFieldComponent,
+  he as resolveFormSubmittable,
+  Ee as runFieldValidation,
+  se as serializeFormStateForQueryKey,
+  fe as showFormValidationFailureFeedback,
+  He as stableSerialize,
+  Ae as startOfDayDate,
+  Me as toCascadedFilterValues,
+  ze as toLocalDate,
   m as useCascadingForm,
   d as useFieldVisibility,
-  c as useFillFormByFileUpload,
-  n as useFillFormByPaste,
-  l as useReactHookForm,
-  p as useSelectOptions,
-  be as validateVisibleRequiredFormFields
+  b as useFillFormByFileUpload,
+  x as useFillFormByPaste,
+  p as useFormSteps,
+  i as useReactHookForm,
+  u as useSelectOptions,
+  Se as validateVisibleRequiredFormFields
 };

package/dist/form-react/registry/defaultFieldRegistrations.d.ts

@@ -1,2 +1,2 @@
-/** Register all 22 built-in field types. Safe to call multiple times — runs once. */
+/** Register all 23 built-in field types. Safe to call multiple times — runs once. */
 export declare function registerDefaultFieldTypes(): void;

package/dist/form-react/registry/defaultFieldRegistrations.js

@@ -13,18 +13,20 @@ import { MultiMonthPickerField as _ } from "../Fields/MultiMonthPickerField.js";
 import { FileUploadField as n } from "../Fields/FileUploadField.js";
 import { FillFormByPasteField as c } from "../Fields/FillFormByPasteField.js";
 import { FillFormByFileUploadField as u } from "../Fields/FillFormByFileUploadField.js";
-import { ChipsField as b } from "../Fields/ChipsField.js";
-import { TextFieldWithBackendValidation as h } from "../Fields/TextFieldWithBackendValidation.js";
-import { SwitchField as k } from "../Fields/SwitchField.js";
-import { CheckboxField as s } from "../Fields/CheckboxField.js";
-import { LabelField as x } from "../Fields/LabelField.js";
-import { DividerField as g } from "../Fields/DividerField.js";
+import { ChipsField as h } from "../Fields/ChipsField.js";
+import { TextFieldWithBackendValidation as b } from "../Fields/TextFieldWithBackendValidation.js";
+import { SwitchField as s } from "../Fields/SwitchField.js";
+import { CheckboxField as x } from "../Fields/CheckboxField.js";
+import { LabelField as g } from "../Fields/LabelField.js";
+import { DividerField as k } from "../Fields/DividerField.js";
 import { DividerWithLabelField as w } from "../Fields/DividerWithLabelField.js";
 import { NumericComboboxField as y } from "../Fields/NumericComboboxField.js";
+import { SliderRangeField as R } from "../Fields/SliderRangeField.js";
+import { RichTextField as T } from "../Fields/RichTextField.js";
 let i = !1;
-function K() {
-  i || (i = !0, e("divider", g), e("divider_with_label", w), e("label", x), e("select", r), e("button_group", o), e("radio", t), e("text", m), e("numeric_combobox", y), e("text_area", l), e("date", p), e("date_range", d), e("week_range", a), e("multi_week_picker", F), e("month_range", f), e("multi_month_picker", _), e("file_upload", n), e("fill_form_by_paste", c), e("fill_form_by_file_upload", u), e("chips", b), e("text_with_backend_validation", h), e("switch", k), e("checkbox", s));
+function Y() {
+  i || (i = !0, e("divider", k), e("divider_with_label", w), e("label", g), e("select", r), e("button_group", o), e("radio", t), e("text", m), e("numeric_combobox", y), e("text_area", l), e("date", p), e("date_range", d), e("week_range", a), e("multi_week_picker", F), e("month_range", f), e("multi_month_picker", _), e("file_upload", n), e("fill_form_by_paste", c), e("fill_form_by_file_upload", u), e("chips", h), e("text_with_backend_validation", b), e("switch", s), e("checkbox", x), e("slider_range", R), e("rich_text", T));
 }
 export {
-  K as registerDefaultFieldTypes
+  Y as registerDefaultFieldTypes
 };

package/dist/form-react/types/fields.types.d.ts

@@ -119,19 +119,19 @@ export type SelectField = BaseField & {
     apiConfig?: {
         apiEndpoint: string;
         method: "GET" | "POST";
-        /** When true, cascaded POSTs send `filters: []` (no parent field values). Use for independent selects (e.g. optional attributes). */
-        doNotIncludeSectionFormStateInApiRequest?: boolean;
-        includeOnlyMandatoryFieldsInPayload?: boolean;
-        /** When true, enables cascade behaviour even when `formConfig.isCascading` is false. */
-        isCascading?: boolean;
         /**
-         * Explicit list of field IDs whose values should be sent as cascade filters.
-         * When set, overrides the default positional behaviour (`getEarlierFieldsIds`) entirely —
-         * only these specific IDs are included, regardless of their array position.
-         * Use when you need precise control over which parent fields cascade into this field's options.
-         * Example: `["division_name", "l0_name"]` — only send Division and Department as filters.
+         * Explicit list of field IDs whose current values should be included in the API request payload.
+         * Combined with `cascadingDependency` field IDs when `passCascadingDependencyFields` is true (default).
+         * When `passCascadingDependencyFields` is false, only this list is sent.
+         * Example: `["division_name", "l0_name"]`.
          */
-        cascadeFromFields?: string[];
+        fieldsToPassInApi?: string[];
+        /**
+         * Controls which field values are sent with select-option API requests.
+         * - `true` (default): send `cascadingDependency` field IDs plus any `fieldsToPassInApi`
+         * - `false`: send only `fieldsToPassInApi` (ignore cascadingDependency for the payload)
+         */
+        passCascadingDependencyFields?: boolean;
     };
 };
 export type DateInputField = BaseField & {
@@ -378,6 +378,17 @@ export type ObjectFieldConfig = BaseField & {
     collapsible?: boolean;
     defaultCollapsed?: boolean;
 };
+export type SliderRangeField = BaseField & {
+    fieldType: "slider_range";
+    min?: number;
+    max?: number;
+    step?: number;
+    defaultValue?: number[];
+    /** When true, renders two thumbs (range mode). Default: single thumb. */
+    range?: boolean;
+    /** Show current value(s) next to the slider. Default: true. */
+    showValue?: boolean;
+};
 export type ArrayFieldConfig = BaseField & {
     fieldType: "array";
     /** Template fields cloned for each array item */
@@ -397,6 +408,14 @@ export type ArrayFieldConfig = BaseField & {
     /** Default values for a new item (keys match itemFields[].id) */
     defaultItemValue?: Record<string, unknown>;
 };
-export type IField = FileUploadField | ButtonsGroupField | SelectField | DateInputField | DateRangeField | WeekRangeField | MonthRangeField | MultiMonthPickerField | TextAreaField | RadioField | TextField | NumericComboboxField | CopyPasteField | FillFormByFileUploadField | TextFieldWithBackendValidation | ChipsField | DividerField | DividerWithLabelField | LabelField | SwitchField | CheckboxField | MultiWeekRangeField | ObjectFieldConfig | ArrayFieldConfig;
+export type RichTextField = BaseField & {
+    fieldType: "rich_text";
+    /** Toolbar items to show. Default: ['undo','redo','bold','italic','underline','strikethrough','heading','quote','link','bulletedList','numberedList'] */
+    toolbar?: string[];
+    defaultValue?: string;
+    /** Minimum editor height in px. Default: 150 */
+    minHeight?: number;
+};
+export type IField = FileUploadField | ButtonsGroupField | SelectField | DateInputField | DateRangeField | WeekRangeField | MonthRangeField | MultiMonthPickerField | TextAreaField | RadioField | TextField | NumericComboboxField | CopyPasteField | FillFormByFileUploadField | TextFieldWithBackendValidation | ChipsField | DividerField | DividerWithLabelField | LabelField | SwitchField | CheckboxField | MultiWeekRangeField | SliderRangeField | RichTextField | ObjectFieldConfig | ArrayFieldConfig;
 /** Discriminant string union for every built-in field type */
 export type FieldType = IField["fieldType"];

package/dist/form-react/types/fieldsOutput.types.d.ts

@@ -25,13 +25,15 @@ export type NumericComboboxFieldOutput = number | "" | null | undefined;
 export type ChipsFieldOutput = string | string[] | null | undefined;
 export type SwitchFieldOutput = boolean | null | undefined;
 export type CheckboxFieldOutput = boolean | null | undefined;
+export type SliderRangeFieldOutput = number[] | null | undefined;
+export type RichTextFieldOutput = string | null | undefined;
 /** Presentational fields do not store a value */
 export type PresentationalFieldOutput = null | undefined;
 /**
  * Union of all field output values (recursive for object / array nesting).
  * Defined independently of FieldTypeToOutputMap to avoid circular map lookups.
  */
-export type FieldOutputValue = FileUploadFieldOutput | ButtonsGroupFieldOutput | SelectFieldOutput | DateInputFieldOutput | DateRangeFieldOutput | WeekRangeFieldOutput | MultiWeekPickerFieldOutput | MonthRangeFieldOutput | MultiMonthPickerFieldOutput | TextAreaFieldOutput | RadioFieldOutput | TextFieldOutput | NumericComboboxFieldOutput | CopyPasteFieldOutput | FillFormByFileUploadFieldOutput | TextFieldWithBackendValidationOutput | ChipsFieldOutput | SwitchFieldOutput | CheckboxFieldOutput | PresentationalFieldOutput | {
+export type FieldOutputValue = FileUploadFieldOutput | ButtonsGroupFieldOutput | SelectFieldOutput | DateInputFieldOutput | DateRangeFieldOutput | WeekRangeFieldOutput | MultiWeekPickerFieldOutput | MonthRangeFieldOutput | MultiMonthPickerFieldOutput | TextAreaFieldOutput | RadioFieldOutput | TextFieldOutput | NumericComboboxFieldOutput | CopyPasteFieldOutput | FillFormByFileUploadFieldOutput | TextFieldWithBackendValidationOutput | ChipsFieldOutput | SwitchFieldOutput | CheckboxFieldOutput | SliderRangeFieldOutput | RichTextFieldOutput | PresentationalFieldOutput | {
     [key: string]: FieldOutputValue;
 } | Array<{
     [key: string]: FieldOutputValue;
@@ -59,6 +61,8 @@ export type FieldTypeToOutputMap = {
     chips: ChipsFieldOutput;
     switch: SwitchFieldOutput;
     checkbox: CheckboxFieldOutput;
+    slider_range: SliderRangeFieldOutput;
+    rich_text: RichTextFieldOutput;
     object: {
         [key: string]: FieldOutputValue;
     } | null | undefined;

package/dist/form-react/types/reactHookForm.types.d.ts

@@ -1,9 +1,11 @@
 import { ComponentType } from 'react';
 import { FieldErrors, FormState, RegisterOptions, UseFormReturn } from 'react-hook-form';
 import { Option } from '../../components/forms/select';
-import { FieldVisibilityBase } from '../../form-engine';
+import { FieldVisibilityBase, FormStepConfig } from '../../form-engine';
 import { FieldType, IField, SelectField } from './fields.types';
 export type { FieldVisibilityBase } from '../../form-engine';
+export type { FormStepConfig } from '../../form-engine';
+export type FormType = 'default' | 'stepped' | 'grouped';
 export type IFormConfig = {
     formId: string;
     fields: Array<IField>;
@@ -13,6 +15,10 @@ export type IFormConfig = {
     isCascading?: boolean;
     includeOnlyVisibleFieldsInSubmit?: boolean;
     enableFieldOrdering?: boolean;
+    /** Layout mode. `'stepped'` shows one step at a time; `'grouped'` shows all groups with section headers. */
+    formType?: FormType;
+    /** Step metadata — order, titles, validation gating. When omitted, derived from field `fieldGroup` order. */
+    steps?: FormStepConfig[];
 };
 export interface FormFieldProps {
     field: IField;
@@ -105,8 +111,17 @@ export interface FormTransport {
 }
 /** Built-in fieldType keys plus arbitrary custom string keys */
 export type CustomFieldTypesMap = Partial<Record<FieldType, ComponentType<FormFieldProps>>> & Record<string, ComponentType<FormFieldProps>>;
+export interface FormStepStateMeta {
+    currentStep: number;
+    totalSteps: number;
+    isFirstStep: boolean;
+    isLastStep: boolean;
+    canProceed: boolean;
+    completedSteps: number[];
+}
 export interface FormValidationMeta {
     isSubmittable: boolean;
+    stepState?: FormStepStateMeta;
 }
 export interface FormContextValidateFormParams {
     formValues: ReactHookFormState;
@@ -176,16 +191,28 @@ export interface ReactHooksFormProps {
     /** Consumer-injected context — validators, custom field types, lifecycle hooks */
     formContext?: FormContext;
 }
+export interface ReactHooksFormStepActions {
+    currentStep: number;
+    totalSteps: number;
+    isFirstStep: boolean;
+    isLastStep: boolean;
+    canProceed: boolean;
+    goNext: () => boolean;
+    goPrev: () => void;
+    goToStep: (index: number) => void;
+    isStepComplete: (stepIndex: number) => boolean;
+    isStepVisited: (stepIndex: number) => boolean;
+}
 export interface ReactHooksFormRef {
     submitForm: () => Promise<boolean>;
     hasErrors: boolean;
     errors: FieldErrors<ReactHookFormState>;
     isValid: boolean;
+    stepActions?: ReactHooksFormStepActions;
 }
 export interface UseSelectOptionsProps {
     apiConfig?: SelectField["apiConfig"];
     formHelpers?: UseReactHookFormReturn;
-    formConfig?: IFormConfig;
     initialOptions?: Option[];
     id: string;
     isEnabled: boolean;
@@ -193,4 +220,6 @@ export interface UseSelectOptionsProps {
     getSelectOptionsName?: string;
     /** Field-specific values to inject into API payload (e.g., viewSettings, globalFilters) */
     fieldSupportedValues?: Record<string, unknown>;
+    /** Field's cascading dependency config — used to auto-derive which parent field values to pass in API requests. */
+    cascadingDependency?: IField["cascadingDependency"];
 }

package/dist/form-react/utils/fieldDefaults.utils.js

@@ -1,21 +1,36 @@
 function u(e) {
   if (e.fieldType === "object") {
-    const a = {};
-    return e.fields.forEach((t) => {
-      a[t.id] = u(t);
-    }), a;
+    const t = {};
+    return e.fields.forEach((a) => {
+      t[a.id] = u(a);
+    }), t;
   }
   if (e.fieldType === "array") {
-    const a = e.defaultItemValue ?? {}, t = e.minItems ?? 0;
-    return t > 0 ? Array.from({ length: t }, () => ({ ...a })) : [];
+    const t = e.defaultItemValue ?? {}, a = e.minItems ?? 0;
+    return a > 0 ? Array.from({ length: a }, () => ({ ...t })) : [];
   }
-  return e.fieldType === "button_group" && e.defaultSelectedValue || e.fieldType === "radio" && e.defaultSelectedValue ? e.defaultSelectedValue || null : e.fieldType === "date_range" && e.defaultRange ? {
-    start: e.defaultRange.start || null,
-    end: e.defaultRange.end || null
-  } : e.fieldType === "month_range" && e.defaultRange ? {
-    start: e.defaultRange.start || null,
-    end: e.defaultRange.end || null
-  } : e.fieldType === "switch" || e.fieldType === "checkbox" ? e.defaultSelectedValue ?? !1 : e.fieldType === "text" || e.fieldType === "text_area" || e.fieldType === "numeric_combobox" ? e.defaultValue ?? "" : e.fieldType === "date" ? "" : e.fieldType === "select" ? [] : e.fieldType === "week_range" && e.defaultRange ? {
+  if (e.fieldType === "button_group" && e.defaultSelectedValue || e.fieldType === "radio" && e.defaultSelectedValue)
+    return e.defaultSelectedValue || null;
+  if (e.fieldType === "date_range" && e.defaultRange)
+    return {
+      start: e.defaultRange.start || null,
+      end: e.defaultRange.end || null
+    };
+  if (e.fieldType === "month_range" && e.defaultRange)
+    return {
+      start: e.defaultRange.start || null,
+      end: e.defaultRange.end || null
+    };
+  if (e.fieldType === "switch" || e.fieldType === "checkbox")
+    return e.defaultSelectedValue ?? !1;
+  if (e.fieldType === "text" || e.fieldType === "text_area" || e.fieldType === "numeric_combobox" || e.fieldType === "rich_text")
+    return e.defaultValue ?? "";
+  if (e.fieldType === "slider_range") {
+    if (e.defaultValue) return e.defaultValue;
+    const t = e.min ?? 0;
+    return e.range ? [t, e.max ?? 100] : [t];
+  }
+  return e.fieldType === "date" ? "" : e.fieldType === "select" ? [] : e.fieldType === "week_range" && e.defaultRange ? {
     start: e.defaultRange.start || null,
     end: e.defaultRange.end || null
   } : null;