@m4l/components 9.63.0 → 9.64.0

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

@@ -1 +1 @@
-{"version":3,"file":"DynamicForm.d.ts","sourceRoot":"","sources":["../../../../../../packages/components/src/components/DynamicForm/DynamicForm.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAqF,MAAM,OAAO,CAAC;AAU1G,OAAO,EAEL,gBAAgB,EAChB,cAAc,EAGf,MAAM,SAAS,CAAC;AAWjB;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,eAAO,MAAM,WAAW,yFAkRtB,CAAC"}
+{"version":3,"file":"DynamicForm.d.ts","sourceRoot":"","sources":["../../../../../../packages/components/src/components/DynamicForm/DynamicForm.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAqF,MAAM,OAAO,CAAC;AAU1G,OAAO,EAEL,gBAAgB,EAChB,cAAc,EAGf,MAAM,SAAS,CAAC;AAYjB;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,eAAO,MAAM,WAAW,yFAwRtB,CAAC"}

package/components/DynamicForm/DynamicForm.js

@@ -1,72 +1,76 @@
 import { jsx as r } from "@emotion/react/jsx-runtime";
-import Q, { forwardRef as X, useMemo as S, useState as Z, useEffect as $, useImperativeHandle as tt, useCallback as I } from "react";
-import M from "clsx";
-import { useModuleSkeleton as et } from "@m4l/core";
-import { useComponentSize as ot } from "../../hooks/useComponentSize/index.js";
-import { TEST_PROP_ID as rt } from "../../test/constants_no_mock.js";
-import { LinearProgress as nt } from "../extended/mui/LinearProgress/index.js";
-import { DynamicFormContentRootStyled as it, DynamicFormFormProviderStyled as at } from "./slots/DynamicFormSlots.js";
-import { DYNAMIC_FORM_CLASSES as F, EMPTY_DATA as st } from "./constants.js";
-import { useDynamicForm as mt } from "./hooks/useDynamicForm/useDynamicForm.js";
-import { useDynamicFormData as ut } from "./hooks/useDynamicFormData/useDynamicFormData.js";
-import { DynamicFormContent as N } from "./subcomponents/DynamicFormContent/DynamicFormContent.js";
-import { useFieldsWithFetchedOptions as lt } from "./hooks/useFieldsWithFetchedOptions/useFieldsWithFetchedOptions.js";
-import { filterUnknownFieldsFromSubmit as dt } from "./helpers/filterUnknownFieldsFromSubmit/filterUnknownFieldsFromSubmit.js";
-import { mapOptionFieldValuesForSubmit as ct } from "./helpers/mapOptionFieldValuesForSubmit/mapOptionFieldValuesForSubmit.js";
-const ft = X((P, T) => {
+import X, { forwardRef as Z, useMemo as c, useState as $, useEffect as ee, useImperativeHandle as te, useCallback as M } from "react";
+import N from "clsx";
+import { useModuleSkeleton as oe } from "@m4l/core";
+import { useComponentSize as re } from "../../hooks/useComponentSize/index.js";
+import { TEST_PROP_ID as ie } from "../../test/constants_no_mock.js";
+import { LinearProgress as ne } from "../extended/mui/LinearProgress/index.js";
+import { DynamicFormContentRootStyled as se, DynamicFormFormProviderStyled as ae } from "./slots/DynamicFormSlots.js";
+import { DYNAMIC_FORM_CLASSES as b, EMPTY_DATA as me } from "./constants.js";
+import { useDynamicForm as ue } from "./hooks/useDynamicForm/useDynamicForm.js";
+import { useDynamicFormData as le } from "./hooks/useDynamicFormData/useDynamicFormData.js";
+import { DynamicFormContent as P } from "./subcomponents/DynamicFormContent/DynamicFormContent.js";
+import { useFieldsWithFetchedOptions as de } from "./hooks/useFieldsWithFetchedOptions/useFieldsWithFetchedOptions.js";
+import { filterUnknownFieldsFromSubmit as ce } from "./helpers/filterUnknownFieldsFromSubmit/filterUnknownFieldsFromSubmit.js";
+import { mapOptionFieldValuesForSubmit as fe } from "./helpers/mapOptionFieldValuesForSubmit/mapOptionFieldValuesForSubmit.js";
+import { normalizeDynamicFormFields as pe } from "./helpers/resolveFormSections/resolveFormSections.js";
+const Fe = Z((T, C) => {
   const {
-    formId: C,
-    formInstanceId: k,
+    formId: k,
+    formInstanceId: z,
     inputEndpoint: _,
-    outputEndpoint: n,
-    submitMode: i,
-    initialData: b,
+    outputEndpoint: i,
+    submitMode: n,
+    initialData: D,
     formatInputData: A,
     formatOutputData: H,
-    onSubmit: a,
-    onSubmitError: D,
+    onSubmit: s,
+    onSubmitError: y,
     size: g,
-    readOnly: s = !1,
-    suppressFormHeader: y = !0,
-    className: h,
-    dataTestId: c,
+    readOnly: a = !1,
+    suppressFormHeader: h = !0,
+    className: v,
+    dataTestId: f,
     dataMeta: m,
-    fieldWrapperClassName: v,
+    fieldWrapperClassName: E,
     fieldFlow: u = "responsiveWrap",
-    coupled: f = !1,
+    coupled: p = !1,
     actionFormIntroProps: x,
-    renderActions: z
-  } = P, { currentSize: l } = ot(g), W = et(), {
-    formData: L,
-    statusLoad: V,
-    handleSubmit: E
-  } = ut({
-    formId: C,
-    formInstanceId: k,
+    renderActions: W
+  } = T, { currentSize: l } = re(g), L = oe(), {
+    formData: V,
+    statusLoad: U,
+    handleSubmit: I
+  } = le({
+    formId: k,
+    formInstanceId: z,
     inputEndpoint: _,
-    outputEndpoint: n,
-    submitMode: i,
-    initialData: b,
+    outputEndpoint: i,
+    submitMode: n,
+    initialData: D,
     formatInputData: A,
     formatOutputData: H,
-    onSubmit: a
-  }), e = L || b, { fields: w } = lt({
-    fields: e?.fields ?? []
-  }), t = S(() => e && {
-    ...e,
+    onSubmit: s
+  }), t = V || D, F = c(
+    () => pe(t?.fields),
+    [t?.fields]
+  ), { fields: w } = de({
+    fields: F.fields
+  }), e = c(() => t && {
+    ...t,
     fields: w
-  }, [w, e]), { initialValues: U, validationSchema: Y } = mt(t || st), [p, d] = Z(null);
-  $(() => {
-    if (!p)
+  }, [w, t]), { initialValues: Y, validationSchema: j } = ue(e || me), [S, d] = $(null);
+  ee(() => {
+    if (!S)
       return;
     const o = setTimeout(() => d(null), 5e3);
     return () => clearTimeout(o);
-  }, [p]);
-  const j = S(() => ({
+  }, [S]);
+  const B = c(() => ({
     size: l,
-    readOnly: s,
+    readOnly: a,
     fieldFlow: u
-  }), [l, u, s]), O = Q.useRef(null), R = S(() => ({
+  }), [l, u, a]), O = X.useRef(null), R = c(() => ({
     formMethods: new Proxy({}, {
       get() {
         throw new Error("DynamicForm ref is not available until the form provider mounts.");
@@ -75,83 +79,85 @@ const ft = X((P, T) => {
     onSubmit: () => {
     }
   }), []);
-  tt(T, () => O.current ?? R, [R]);
-  const B = I(
+  te(C, () => O.current ?? R, [R]);
+  const q = M(
     async (o) => {
-      if (!!!(n || i === "perField" || a))
+      if (!!!(i || n === "perField" || s))
         return;
-      const G = n || i === "perField" ? E : a ?? (() => {
-      }), J = dt(
+      const J = i || n === "perField" ? I : s ?? (() => {
+      }), K = ce(
         o,
-        t?.fields ?? []
-      ), K = ct(J, t?.fields ?? []);
+        e?.fields ?? []
+      ), Q = fe(K, e?.fields ?? []);
       try {
-        await G(K), d("success");
+        await J(Q), d("success");
       } catch {
         d("error");
       }
     },
-    [E, a, n, t?.fields, i]
-  ), q = I(
+    [I, s, i, e?.fields, n]
+  ), G = M(
     (o) => {
-      d("error"), D?.(o);
+      d("error"), y?.(o);
     },
-    [D]
+    [y]
   );
-  return W ? /* @__PURE__ */ r(
-    it,
+  return L ? /* @__PURE__ */ r(
+    se,
     {
-      ownerState: j,
-      className: M(h, F.contentRoot),
+      ownerState: B,
+      className: N(v, b.contentRoot),
       ...typeof m == "string" ? { "data-meta": m } : {},
-      ...process.env.NODE_ENV !== "production" ? { [rt]: c } : {},
-      children: /* @__PURE__ */ r(nt, {})
+      ...process.env.NODE_ENV !== "production" ? { [ie]: f } : {},
+      children: /* @__PURE__ */ r(ne, {})
     }
-  ) : t ? f ? /* @__PURE__ */ r(
-    N,
+  ) : e ? p ? /* @__PURE__ */ r(
+    P,
     {
-      data: t,
+      data: e,
       currentSize: l,
-      fieldWrapperClassName: v,
-      dataTestId: c,
+      fieldWrapperClassName: E,
+      dataTestId: f,
       dataMeta: m,
-      coupled: f,
-      readOnly: s,
-      suppressFormHeader: y,
-      fieldFlow: u
+      coupled: p,
+      readOnly: a,
+      suppressFormHeader: h,
+      fieldFlow: u,
+      contractIssues: F.issues
     }
   ) : /* @__PURE__ */ r(
-    at,
+    ae,
     {
       ref: O,
-      values: U,
-      validationSchema: Y,
-      onSubmit: B,
-      onSubmitError: q,
-      statusLoad: V,
+      values: Y,
+      validationSchema: j,
+      onSubmit: q,
+      onSubmitError: G,
+      statusLoad: U,
       mode: "onSubmit",
-      className: M(h, F.contentRoot, F.formProvider),
+      className: N(v, b.contentRoot, b.formProvider),
       children: /* @__PURE__ */ r(
-        N,
+        P,
         {
-          data: t,
+          data: e,
           currentSize: l,
-          fieldWrapperClassName: v,
-          dataTestId: c,
+          fieldWrapperClassName: E,
+          dataTestId: f,
           dataMeta: m,
-          coupled: f,
-          readOnly: s,
-          suppressFormHeader: y,
+          coupled: p,
+          readOnly: a,
+          suppressFormHeader: h,
           fieldFlow: u,
+          contractIssues: F.issues,
           actionFormIntroProps: x,
-          renderActions: z,
-          submitFeedbackStatus: p
+          renderActions: W,
+          submitFeedbackStatus: S
         }
       )
     }
   ) : null;
 });
-ft.displayName = "DynamicForm";
+Fe.displayName = "DynamicForm";
 export {
-  ft as DynamicForm
+  Fe as DynamicForm
 };

package/components/DynamicForm/DynamicForm.styles.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"DynamicForm.styles.d.ts","sourceRoot":"","sources":["../../../../../../packages/components/src/components/DynamicForm/DynamicForm.styles.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAGV,iBAAiB,EAClB,MAAM,SAAS,CAAC;AAgNjB,eAAO,MAAM,eAAe,EAAE,iBA0T7B,CAAC"}
+{"version":3,"file":"DynamicForm.styles.d.ts","sourceRoot":"","sources":["../../../../../../packages/components/src/components/DynamicForm/DynamicForm.styles.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAGV,iBAAiB,EAClB,MAAM,SAAS,CAAC;AAgNjB,eAAO,MAAM,eAAe,EAAE,iBAiV7B,CAAC"}

package/components/DynamicForm/DynamicForm.styles.js

@@ -1,76 +1,77 @@
 import { CHECKABLE_LIST_DEFAULT_MIN_HEIGHT as m } from "../CheckableList/constants.js";
-import { DYNAMIC_FORM_SEMANTIC_GRID_COLUMN_BREAKPOINTS as l, DYNAMIC_FORM_SEMANTIC_GRID_MAX_COLUMNS as c, resolveSemanticGridSpanForContainerWidth as f, resolveSemanticGridSpanForColumnCount as h, resolveSemanticGridContainerWidthForSpan as x } from "./helpers/resolveAdaptiveFieldLayout/resolveAdaptiveFieldLayout.js";
-const s = "m4l-dynamic-form-content", S = {
+import { createDynamicFormSectionCardStyles as f } from "./subcomponents/DynamicFormSection/cardStyles.js";
+import { DYNAMIC_FORM_SEMANTIC_GRID_COLUMN_BREAKPOINTS as l, DYNAMIC_FORM_SEMANTIC_GRID_MAX_COLUMNS as c, resolveSemanticGridSpanForContainerWidth as x, resolveSemanticGridSpanForColumnCount as h, resolveSemanticGridContainerWidthForSpan as S } from "./helpers/resolveAdaptiveFieldLayout/resolveAdaptiveFieldLayout.js";
+const s = "m4l-dynamic-form-content", g = {
   gridColumn: "1 / -1",
   maxWidth: "100%",
   width: "100%",
   minWidth: "0",
   flex: "1 1 100%"
-}, g = l.reduce(
-  (t, i) => (t[`@container ${s} (max-width: ${i.maxContainerWidth}px)`] = {
-    gridTemplateColumns: `repeat(${i.columns}, minmax(0, 1fr))`
-  }, t),
+}, w = l.reduce(
+  (i, t) => (i[`@container ${s} (max-width: ${t.maxContainerWidth}px)`] = {
+    gridTemplateColumns: `repeat(${t.columns}, minmax(0, 1fr))`
+  }, i),
   {}
-), w = [
+), y = [
   {
     columns: c,
     minContainerWidth: (l[0]?.maxContainerWidth ?? 0) + 1
   },
   ...l.map(
-    (t, i) => ({
-      columns: t.columns,
-      maxContainerWidth: t.maxContainerWidth,
-      minContainerWidth: (l[i + 1]?.maxContainerWidth ?? -1) + 1
+    (i, t) => ({
+      columns: i.columns,
+      maxContainerWidth: i.maxContainerWidth,
+      minContainerWidth: (l[t + 1]?.maxContainerWidth ?? -1) + 1
     })
   )
 ];
-function C(t) {
-  return typeof t == "number" && Number.isFinite(t) && t > 0;
+function C(i) {
+  return typeof i == "number" && Number.isFinite(i) && i > 0;
 }
-function u(t) {
+function p(i) {
   return {
-    gridColumn: `span ${t}`
+    gridColumn: `span ${i}`
   };
 }
-function p(t, i) {
+function u(i, t) {
   const e = [];
-  return t > 0 && e.push(`(min-width: ${t}px)`), typeof i == "number" && e.push(`(max-width: ${i}px)`), `@container ${s} ${e.join(
+  return i > 0 && e.push(`(min-width: ${i}px)`), typeof t == "number" && e.push(`(max-width: ${t}px)`), `@container ${s} ${e.join(
     " and "
   )}`;
 }
-function y(t) {
-  return t.minContainerWidth > 0 ? t.minContainerWidth : t.maxContainerWidth ?? 1;
+function W(i) {
+  return i.minContainerWidth > 0 ? i.minContainerWidth : i.maxContainerWidth ?? 1;
 }
-function W(t, i, e, n) {
+function b(i, t, e, n) {
   for (let r = n - 1; r >= 1; r -= 1) {
-    const o = x(
+    const o = S(
       e,
       r,
-      i.columns
+      t.columns
     );
-    o <= i.minContainerWidth || typeof i.maxContainerWidth == "number" && o > i.maxContainerWidth || (t[p(
+    o <= t.minContainerWidth || typeof t.maxContainerWidth == "number" && o > t.maxContainerWidth || (i[u(
       o,
-      i.maxContainerWidth
-    )] = u(r));
+      t.maxContainerWidth
+    )] = p(r));
   }
 }
-function b(t, i) {
-  if (C(i)) {
+function v(i, t) {
+  if (C(t)) {
     const e = {
       justifySelf: "start",
       maxWidth: "100%",
-      width: `min(100%, ${Math.ceil(i)}px)`
+      width: `min(100%, ${Math.ceil(t)}px)`
     };
-    return w.forEach((n, r) => {
-      const o = f(
-        i,
+    return y.forEach((n, r) => {
+      const o = x(
+        t,
         n.columns,
-        y(n)
-      ), a = u(o);
-      r === 0 ? Object.assign(e, a) : e[p(0, n.maxContainerWidth)] = a, W(
+        W(n)
+      ), a = p(o);
+      r === 0 ? Object.assign(e, a) : e[u(0, n.maxContainerWidth)] = a, b(
         e,
         n,
-        i,
+        t,
         o
       );
     }), e;
@@ -78,19 +79,19 @@ function b(t, i) {
   return l.reduce(
     (e, n) => (e[`@container ${s} (max-width: ${n.maxContainerWidth}px)`] = {
       gridColumn: `span ${h(
-        t,
+        i,
         n.columns
       )}`
     }, e),
     {
       gridColumn: `span ${h(
-        t,
+        i,
         c
       )}`
     }
   );
 }
-const T = {
+const _ = {
   /**
    * Styles for the RHFormProvider wrapper.
    */
@@ -105,38 +106,38 @@ const T = {
    * Styles for the form content container (inner div).
    * Uses a vertical flex axis so growable fields can consume available height.
    */
-  contentRoot: ({ theme: t, ownerState: i }) => {
-    const e = i;
+  contentRoot: ({ theme: i, ownerState: t }) => {
+    const e = t;
     return {
       display: "flex",
       flexDirection: "column",
       alignItems: "stretch",
-      gap: t.vars.size.baseSpacings.sp4,
+      gap: i.vars.size.baseSpacings.sp4,
       width: "100%",
       height: "100%",
       minHeight: 0,
       boxSizing: "border-box",
       containerName: s,
       containerType: "inline-size",
-      padding: t.vars.size.baseSpacings.sp2,
+      padding: i.vars.size.baseSpacings.sp2,
       ...e?.fieldFlow === "verticalStack" && {
         flex: "1 1 auto"
       },
       "& .MuiLinearProgress-root": {
-        backgroundColor: t.vars.palette.primary.opacity
+        backgroundColor: i.vars.palette.primary.opacity
       }
     };
   },
   /**
    * Styles for normal-field flow segments.
    */
-  fieldsFlow: ({ theme: t, ownerState: i }) => i?.fieldFlow === "verticalStack" ? {
+  fieldsFlow: ({ theme: i, ownerState: t }) => t?.fieldFlow === "verticalStack" ? {
     display: "flex",
     flexDirection: "column",
     alignItems: "stretch",
     alignContent: "stretch",
     flexWrap: "nowrap",
-    gap: t.vars.size.baseSpacings.sp4,
+    gap: i.vars.size.baseSpacings.sp4,
     width: "100%",
     minWidth: 0,
     boxSizing: "border-box",
@@ -147,22 +148,38 @@ const T = {
     gridAutoFlow: "row",
     alignItems: "start",
     alignContent: "start",
-    gap: t.vars.size.baseSpacings.sp4,
+    gap: i.vars.size.baseSpacings.sp4,
     width: "100%",
     minWidth: 0,
     boxSizing: "border-box",
     flex: "0 0 auto",
-    ...g
+    ...w
   },
+  /** Arrange section containers without forcing narrow input columns. */
+  sectionsGrid: ({ theme: i, ownerState: t }) => ({
+    display: "grid",
+    gridTemplateColumns: t?.fieldFlow === "verticalStack" ? "minmax(0, 1fr)" : "repeat(auto-fit, minmax(min(100%, 22rem), 1fr))",
+    gap: i.vars.size.baseSpacings.sp5,
+    alignItems: "stretch",
+    width: "100%",
+    minWidth: 0,
+    boxSizing: "border-box"
+  }),
+  /** Surface for fields outside groups when at least one section is visible. */
+  ungroupedCard: ({ theme: i }) => ({
+    ...f(i),
+    containerName: s,
+    containerType: "inline-size"
+  }),
   /**
    * Styles for the optional form header rendered before the dynamic fields.
    */
-  formHeader: ({ theme: t }) => ({
+  formHeader: ({ theme: i }) => ({
     width: "100%",
     flex: "0 0 auto",
     display: "flex",
     flexDirection: "column",
-    gap: t.vars.size.baseSpacings.sp1,
+    gap: i.vars.size.baseSpacings.sp1,
     minWidth: 0
   }),
   /**
@@ -188,17 +205,17 @@ const T = {
    * `ownerState.gridColumnSpan` places adaptive fields on the semantic grid while
    * PropertyValue keeps the rendered control fixed to the backend semantic width.
    */
-  fieldWrapper: ({ theme: t, ownerState: i }) => {
-    const e = i, n = e?.fieldFlow === "verticalStack";
-    let r = S;
-    e?.isFullWidth !== !0 && typeof e?.gridColumnSpan == "number" && (r = b(
+  fieldWrapper: ({ theme: i, ownerState: t }) => {
+    const e = t, n = e?.fieldFlow === "verticalStack";
+    let r = g;
+    e?.isFullWidth !== !0 && typeof e?.gridColumnSpan == "number" && (r = v(
       e.gridColumnSpan,
       e.wrapperWidth
     ));
     const o = {
       display: "flex",
       flexDirection: "column",
-      gap: t.vars.size.baseSpacings.sp1,
+      gap: i.vars.size.baseSpacings.sp1,
       minWidth: 0
     }, a = {
       "& > *": {
@@ -310,12 +327,12 @@ const T = {
   /**
    * Styles for the section divider (for future use).
    */
-  sectionDivider: ({ theme: t }) => ({
+  sectionDivider: ({ theme: i }) => ({
     width: "100%",
-    height: t.vars.size.borderStroke.container,
-    backgroundColor: t.vars.palette.border.main,
-    marginTop: t.vars.size.baseSpacings.sp2,
-    marginBottom: t.vars.size.baseSpacings.sp2
+    height: i.vars.size.borderStroke.container,
+    backgroundColor: i.vars.palette.border.main,
+    marginTop: i.vars.size.baseSpacings.sp2,
+    marginBottom: i.vars.size.baseSpacings.sp2
   }),
   /**
    * Styles for the CheckableList wrapper inside the vertical grow field.
@@ -347,5 +364,5 @@ const T = {
   })
 };
 export {
-  T as componentStyles
+  _ as componentStyles
 };

package/components/DynamicForm/constants.d.ts

@@ -10,7 +10,7 @@ export declare const DYNAMIC_FORM_KEY_COMPONENT = "M4LDynamicForm";
 /**
  * CSS class inventory for the component.
  */
-export declare const DYNAMIC_FORM_CLASSES: Record<"label" | "helperText" | "sectionDivider" | "contentRoot" | "formProvider" | "formHeader" | "formTitle" | "formDescription" | "fieldsFlow" | "fieldWrapper" | "submitFeedback" | "actionsRow" | "checkableListWrapper" | "fallbackEndIconChip", string>;
+export declare const DYNAMIC_FORM_CLASSES: Record<"label" | "helperText" | "sectionDivider" | "contentRoot" | "formProvider" | "formHeader" | "formTitle" | "formDescription" | "fieldsFlow" | "sectionsGrid" | "ungroupedCard" | "fieldWrapper" | "submitFeedback" | "actionsRow" | "checkableListWrapper" | "fallbackEndIconChip", string>;
 /**
  * Default shortcut used by DynamicForm date-range fields when the backend omits or sends an invalid shortcut.
  */
@@ -26,14 +26,14 @@ export declare const ALWAYS_MULTIPLE_OPTION_COMPONENT_IDS: readonly ["RHFCheckab
 /**
  * Field type IDs whose RHF state is an array (multiselect variants).
  */
-export declare const ARRAY_FIELD_TYPE_IDS: Set<"fft_text" | "fft_number" | "fft_decimal_number" | "fft_email" | "fft_select_number" | "fft_select_text" | "fft_multiselect_number" | "fft_multiselect_text" | "fft_icon" | "fft_resource_dictionary" | "fft_boolean" | "fft_date_range">;
+export declare const ARRAY_FIELD_TYPE_IDS: Set<"fft_text" | "fft_number" | "fft_decimal_number" | "fft_email" | "fft_select_number" | "fft_select_text" | "fft_multiselect_number" | "fft_multiselect_text" | "fft_icon" | "fft_resource_dictionary" | "fft_boolean" | "fft_date_range" | "fft_alert" | "fft_section">;
 /**
  * Field type IDs that map to a numeric Yup schema.
  */
-export declare const NUMBER_FIELD_TYPE_IDS: Set<"fft_text" | "fft_number" | "fft_decimal_number" | "fft_email" | "fft_select_number" | "fft_select_text" | "fft_multiselect_number" | "fft_multiselect_text" | "fft_icon" | "fft_resource_dictionary" | "fft_boolean" | "fft_date_range">;
+export declare const NUMBER_FIELD_TYPE_IDS: Set<"fft_text" | "fft_number" | "fft_decimal_number" | "fft_email" | "fft_select_number" | "fft_select_text" | "fft_multiselect_number" | "fft_multiselect_text" | "fft_icon" | "fft_resource_dictionary" | "fft_boolean" | "fft_date_range" | "fft_alert" | "fft_section">;
 /**
  * Field type IDs that map to a string Yup schema via an explicit text field component.
  */
-export declare const TEXT_FIELD_TYPE_IDS: Set<"fft_text" | "fft_number" | "fft_decimal_number" | "fft_email" | "fft_select_number" | "fft_select_text" | "fft_multiselect_number" | "fft_multiselect_text" | "fft_icon" | "fft_resource_dictionary" | "fft_boolean" | "fft_date_range">;
+export declare const TEXT_FIELD_TYPE_IDS: Set<"fft_text" | "fft_number" | "fft_decimal_number" | "fft_email" | "fft_select_number" | "fft_select_text" | "fft_multiselect_number" | "fft_multiselect_text" | "fft_icon" | "fft_resource_dictionary" | "fft_boolean" | "fft_date_range" | "fft_alert" | "fft_section">;
 export declare const EMPTY_DATA: DynamicFormApiResponse;
 //# sourceMappingURL=constants.d.ts.map

package/components/DynamicForm/constants.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../../../../../packages/components/src/components/DynamicForm/constants.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,sBAAsB,EAGvB,MAAM,SAAS,CAAC;AAEjB;;;;;;GAMG;AACH,eAAO,MAAM,0BAA0B,mBAAmB,CAAC;AAE3D;;GAEG;AACH,eAAO,MAAM,oBAAoB,gQAGhC,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,wCAAwC,UAAU,CAAC;AAEhE;;GAEG;AACH,eAAO,MAAM,0BAA0B,mJAQoB,CAAC;AAE5D;;GAEG;AACH,eAAO,MAAM,oCAAoC,sDAGU,CAAC;AAE5D;;GAEG;AACH,eAAO,MAAM,oBAAoB,+OAG/B,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,qBAAqB,+OAGhC,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,mBAAmB,+OAI9B,CAAC;AAEH,eAAO,MAAM,UAAU,EAAE,sBAKxB,CAAC"}
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../../../../../packages/components/src/components/DynamicForm/constants.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,sBAAsB,EAGvB,MAAM,SAAS,CAAC;AAEjB;;;;;;GAMG;AACH,eAAO,MAAM,0BAA0B,mBAAmB,CAAC;AAE3D;;GAEG;AACH,eAAO,MAAM,oBAAoB,mSAGhC,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,wCAAwC,UAAU,CAAC;AAEhE;;GAEG;AACH,eAAO,MAAM,0BAA0B,mJAQoB,CAAC;AAE5D;;GAEG;AACH,eAAO,MAAM,oCAAoC,sDAGU,CAAC;AAE5D;;GAEG;AACH,eAAO,MAAM,oBAAoB,6QAG/B,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,qBAAqB,6QAGhC,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,mBAAmB,6QAI9B,CAAC;AAEH,eAAO,MAAM,UAAU,EAAE,sBAKxB,CAAC"}

package/components/DynamicForm/dictionary.d.ts

@@ -21,5 +21,9 @@ export declare const DYNAMIC_FORM_DICTIONARY: {
     SUBMIT_SUCCESS_MESSAGE: string;
     /** Shown when the last decoupled DynamicForm submit fails. */
     SUBMIT_ERROR_MESSAGE: string;
+    /** Shown when a section lacks its title in the backend contract. */
+    SECTION_TITLE_FALLBACK: string;
+    /** Shown once when malformed grouping metadata hides an otherwise expected element. */
+    SECTION_CONTRACT_NOTICE: string;
 };
 //# sourceMappingURL=dictionary.d.ts.map

package/components/DynamicForm/dictionary.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"dictionary.d.ts","sourceRoot":"","sources":["../../../../../../packages/components/src/components/DynamicForm/dictionary.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,2BAA2B,iBAAiB,CAAC;AAE1D,eAAO,MAAM,kCAAkC,gBAE9C,CAAC;AAEF,eAAO,MAAM,uBAAuB;IAClC,2GAA2G;;;;;;;;;;;;IAY3G,oFAAoF;;IAEpF,kFAAkF;;IAElF,+EAA+E;;IAE/E,8DAA8D;;CAE/D,CAAC"}
+{"version":3,"file":"dictionary.d.ts","sourceRoot":"","sources":["../../../../../../packages/components/src/components/DynamicForm/dictionary.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,2BAA2B,iBAAiB,CAAC;AAE1D,eAAO,MAAM,kCAAkC,gBAE9C,CAAC;AAEF,eAAO,MAAM,uBAAuB;IAClC,2GAA2G;;;;;;;;;;;;IAY3G,oFAAoF;;IAEpF,kFAAkF;;IAElF,+EAA+E;;IAE/E,8DAA8D;;IAE9D,oEAAoE;;IAEpE,uFAAuF;;CAExF,CAAC"}

package/components/DynamicForm/dictionary.js

@@ -18,7 +18,11 @@ const _ = "dynamic_form", e = () => [_], E = {
   /** Shown when the last decoupled DynamicForm submit completes successfully. */
   SUBMIT_SUCCESS_MESSAGE: `${_}.submit_success_message`,
   /** Shown when the last decoupled DynamicForm submit fails. */
-  SUBMIT_ERROR_MESSAGE: `${_}.submit_error_message`
+  SUBMIT_ERROR_MESSAGE: `${_}.submit_error_message`,
+  /** Shown when a section lacks its title in the backend contract. */
+  SECTION_TITLE_FALLBACK: `${_}.section_title_fallback`,
+  /** Shown once when malformed grouping metadata hides an otherwise expected element. */
+  SECTION_CONTRACT_NOTICE: `${_}.section_contract_notice`
 };
 export {
   E as DYNAMIC_FORM_DICTIONARY,

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

@@ -17,6 +17,8 @@ export declare const DYNAMIC_FORM_FIELD_COMPONENT_ALLOWLIST: {
     readonly fft_resource_dictionary: readonly ["RHFResourceDictionary"];
     readonly fft_boolean: readonly ["RHFCheckbox"];
     readonly fft_date_range: readonly ["RHFDateTimeRangePicker"];
+    readonly fft_alert: readonly ["Alert"];
+    readonly fft_section: readonly ["Section"];
 };
 /** Return true when the field-type id is declared in the DynamicForm backend contract. */
 export declare function isAllowedFieldTypeId(fieldTypeId: string | null | undefined): fieldTypeId is DynamicFormFieldTypeId;
@@ -58,4 +60,6 @@ export declare function isAllowedFieldCurrentValue(field: Pick<Field, 'currentVa
 export declare function isAllowedFieldOptionPaths(field: Pick<Field, 'fieldType' | 'options'>): boolean;
 /** Return true when a field can be rendered with its declared RHF component. */
 export declare function isSupportedDynamicFormField(field: Pick<Field, 'currentValue' | 'endpoint' | 'fieldType' | 'options'>): boolean;
+/** Identify a supported display-only field that should not enter form state. */
+export declare function isSupportedInformationalField(field: Pick<Field, 'currentValue' | 'endpoint' | 'fieldType' | 'options'>): boolean;
 //# sourceMappingURL=fieldContractAllowlist.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"fieldContractAllowlist.d.ts","sourceRoot":"","sources":["../../../../../../../../packages/components/src/components/DynamicForm/helpers/fieldContractAllowlist/fieldContractAllowlist.ts"],"names":[],"mappings":"AACA,OAAO,EAGL,KAAK,2BAA2B,EAChC,KAAK,sBAAsB,EAC3B,KAAK,KAAK,EACV,KAAK,SAAS,EACf,MAAM,aAAa,CAAC;AAgBrB;;;;GAIG;AACH,eAAO,MAAM,sCAAsC;;;;;;;;;;;;;CA0BlD,CAAC;AAsBF,0FAA0F;AAC1F,wBAAgB,oBAAoB,CAClC,WAAW,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GACrC,WAAW,IAAI,sBAAsB,CAEvC;AAED,yFAAyF;AACzF,wBAAgB,yBAAyB,CACvC,WAAW,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GACrC,WAAW,IAAI,2BAA2B,CAI5C;AAED,0FAA0F;AAC1F,wBAAgB,oCAAoC,CAClD,WAAW,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GACrC,SAAS,2BAA2B,EAAE,CAIxC;AA0JD,mGAAmG;AACnG,wBAAgB,sBAAsB,CACpC,SAAS,EACL,IAAI,CAAC,SAAS,EAAE,IAAI,GAAG,aAAa,GAAG,gBAAgB,CAAC,GACxD,IAAI,GACJ,SAAS,GACZ,SAAS,IAAI,IAAI,CAAC,SAAS,EAAE,IAAI,GAAG,aAAa,GAAG,gBAAgB,CAAC,GAAG;IACzE,EAAE,EAAE,sBAAsB,CAAC;IAC3B,WAAW,EAAE,2BAA2B,CAAC;CAC1C,CAYA;AAED;;;GAGG;AACH,wBAAgB,0BAA0B,CACxC,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,cAAc,GAAG,UAAU,GAAG,WAAW,CAAC,GAC5D,OAAO,CAoCT;AASD;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,yBAAyB,CACvC,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,WAAW,GAAG,SAAS,CAAC,GAC1C,OAAO,CA0GT;AAED,gFAAgF;AAChF,wBAAgB,2BAA2B,CACzC,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,cAAc,GAAG,UAAU,GAAG,WAAW,GAAG,SAAS,CAAC,GACxE,OAAO,CAOT"}
+{"version":3,"file":"fieldContractAllowlist.d.ts","sourceRoot":"","sources":["../../../../../../../../packages/components/src/components/DynamicForm/helpers/fieldContractAllowlist/fieldContractAllowlist.ts"],"names":[],"mappings":"AACA,OAAO,EAGL,KAAK,2BAA2B,EAChC,KAAK,sBAAsB,EAC3B,KAAK,KAAK,EACV,KAAK,SAAS,EACf,MAAM,aAAa,CAAC;AAgBrB;;;;GAIG;AACH,eAAO,MAAM,sCAAsC;;;;;;;;;;;;;;;CA4BlD,CAAC;AAsBF,0FAA0F;AAC1F,wBAAgB,oBAAoB,CAClC,WAAW,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GACrC,WAAW,IAAI,sBAAsB,CAEvC;AAED,yFAAyF;AACzF,wBAAgB,yBAAyB,CACvC,WAAW,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GACrC,WAAW,IAAI,2BAA2B,CAI5C;AAED,0FAA0F;AAC1F,wBAAgB,oCAAoC,CAClD,WAAW,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GACrC,SAAS,2BAA2B,EAAE,CAIxC;AA0JD,mGAAmG;AACnG,wBAAgB,sBAAsB,CACpC,SAAS,EACL,IAAI,CAAC,SAAS,EAAE,IAAI,GAAG,aAAa,GAAG,gBAAgB,CAAC,GACxD,IAAI,GACJ,SAAS,GACZ,SAAS,IAAI,IAAI,CAAC,SAAS,EAAE,IAAI,GAAG,aAAa,GAAG,gBAAgB,CAAC,GAAG;IACzE,EAAE,EAAE,sBAAsB,CAAC;IAC3B,WAAW,EAAE,2BAA2B,CAAC;CAC1C,CAYA;AAED;;;GAGG;AACH,wBAAgB,0BAA0B,CACxC,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,cAAc,GAAG,UAAU,GAAG,WAAW,CAAC,GAC5D,OAAO,CAwCT;AASD;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,yBAAyB,CACvC,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,WAAW,GAAG,SAAS,CAAC,GAC1C,OAAO,CA0GT;AAED,gFAAgF;AAChF,wBAAgB,2BAA2B,CACzC,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,cAAc,GAAG,UAAU,GAAG,WAAW,GAAG,SAAS,CAAC,GACxE,OAAO,CAOT;AAED,gFAAgF;AAChF,wBAAgB,6BAA6B,CAC3C,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,cAAc,GAAG,UAAU,GAAG,WAAW,GAAG,SAAS,CAAC,GACxE,OAAO,CAGT"}