@m4l/components 9.19.0 → 9.20.0

package/components/DynamicForm/helpers/resolveFieldComponent/strategies/selectStrategy/normalizeSelectPropsFromBackend.js

@@ -1,8 +1,9 @@
 import { isRecord as n } from "../../../isRecord.js";
-import { normalizeFieldOptionsForSelect as m } from "./normalizeFieldOptionsForSelect.js";
-import { resolveFieldInputLabel as s } from "../../../resolveFieldInputLabel/resolveFieldInputLabel.js";
-function f(r, l, p) {
-  const t = s(r, l), i = m(r.options, p), e = r.fieldType.rhfComponentProps;
+import { resolveFieldTypeComponentProps as m } from "../../../resolveFieldContractAliases.js";
+import { normalizeFieldOptionsForSelect as s } from "./normalizeFieldOptionsForSelect.js";
+import { resolveFieldInputLabel as d } from "../../../resolveFieldInputLabel/resolveFieldInputLabel.js";
+function y(r, l, p) {
+  const t = d(r, l), i = s(r.options, p), e = m(r.fieldType);
   if (!n(e))
     return { resolvedLabel: t, resolvedSelectOptions: i };
   const o = {};
@@ -13,5 +14,5 @@ function f(r, l, p) {
   };
 }
 export {
-  f as normalizeSelectPropsFromBackend
+  y as normalizeSelectPropsFromBackend
 };

package/components/DynamicForm/helpers/resolveFieldComponent/strategies/selectStrategy/selectStrategy.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"selectStrategy.d.ts","sourceRoot":"","sources":["../../../../../../../../../../packages/components/src/components/DynamicForm/helpers/resolveFieldComponent/strategies/selectStrategy/selectStrategy.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,sBAAsB,EAAiC,MAAM,UAAU,CAAC;AAGtF,0BAA0B;AAC1B,eAAO,MAAM,cAAc,EAAE,sBAwB5B,CAAC"}
+{"version":3,"file":"selectStrategy.d.ts","sourceRoot":"","sources":["../../../../../../../../../../packages/components/src/components/DynamicForm/helpers/resolveFieldComponent/strategies/selectStrategy/selectStrategy.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,sBAAsB,EAAiC,MAAM,UAAU,CAAC;AAItF,0BAA0B;AAC1B,eAAO,MAAM,cAAc,EAAE,sBAyB5B,CAAC"}

package/components/DynamicForm/helpers/resolveFieldComponent/strategies/selectStrategy/selectStrategy.js

@@ -1,28 +1,28 @@
-import { jsx as S } from "@emotion/react/jsx-runtime";
-import { normalizeSelectPropsFromBackend as z } from "./normalizeSelectPropsFromBackend.js";
-import { RHFSelect as g } from "../../../../../hook-form/RHFSelect/RHFSelect.js";
-const y = {
+import { jsx as v } from "@emotion/react/jsx-runtime";
+import { normalizeSelectPropsFromBackend as y } from "./normalizeSelectPropsFromBackend.js";
+import { resolveFieldHelperMessage as M, resolveFieldMandatory as S } from "../../../resolveFieldContractAliases.js";
+import { RHFSelect as z } from "../../../../../hook-form/RHFSelect/RHFSelect.js";
+const O = {
   componentIds: ["RHFSelect"],
   /** Renders the RHFSelect component for the given field and context. */
   render(o) {
-    const { field: e, props: t } = o, { size: r, disabled: l, readOnly: s, getLabel: n, hostApiRemote: d } = t, { name: i, placeholder: p, isRequired: a, helperText: c } = e, m = z(e, n, d), { resolvedLabel: h, multiple: b, resolvedSelectOptions: f, ...R } = m;
-    return /* @__PURE__ */ S(
-      g,
+    const { field: e, props: s } = o, { size: r, disabled: l, readOnly: t, getLabel: a, hostApiRemote: n, suppressLabel: d } = s, { name: p, placeholder: i } = e, c = M(e), m = S(e), b = y(e, a, n), { resolvedLabel: f, multiple: h, resolvedSelectOptions: F, ...g } = b;
+    return /* @__PURE__ */ v(
+      z,
       {
-        name: i,
+        name: p,
         size: r,
-        label: h,
-        mandatory: a,
-        options: f,
+        ...!d && { label: f, mandatory: m },
+        options: F,
         helperMessage: c || "",
-        disabled: l || s,
-        multiple: b,
-        placeholder: p || void 0,
-        ...R
+        disabled: l || t,
+        multiple: h,
+        placeholder: i || void 0,
+        ...g
       }
     );
   }
 };
 export {
-  y as selectStrategy
+  O as selectStrategy
 };

package/components/DynamicForm/helpers/resolveFieldComponent/strategies/textFieldStrategy/normalizeTextFieldPropsFromBackend.d.ts

@@ -2,12 +2,12 @@ import { GetLabelType } from '@m4l/core';
 import { Field } from '../../../../types';
 import { NormalizedTextFieldPropsFromBackendResult } from './types';
 /**
- * Reads `field.fieldType.rhfComponentProps`, keeps only values supported by `RHFTextField`, sets
+ * Reads `field.fieldType.componentProps`, keeps only values supported by `RHFTextField`, sets
  * `resolvedLabel` via {@link resolveFieldInputLabel}, and builds `startIcon` / `endIcon` as {@link Icon} elements
  * when legacy path aliases are present. Unknown keys or invalid value types are ignored.
  * Does not pass `InputProps` (controlled by DynamicForm or non-JSON).
  * `startAdormentPath` / `endAdormentPath` are mapped to icons using `assetBasePath` from DynamicForm context props.
- * @param field - Dynamic form field (backend props come from `field.fieldType.rhfComponentProps`).
+ * @param field - Dynamic form field (backend props come from `field.fieldType.componentProps`).
  * @param getLabel - Dictionary label resolver for `resolveFieldInputLabel` fallback.
  * @param assetBasePath - Optional prefix for static assets (trailing slashes stripped); forwarded from host context.
  */

package/components/DynamicForm/helpers/resolveFieldComponent/strategies/textFieldStrategy/normalizeTextFieldPropsFromBackend.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"normalizeTextFieldPropsFromBackend.d.ts","sourceRoot":"","sources":["../../../../../../../../../../packages/components/src/components/DynamicForm/helpers/resolveFieldComponent/strategies/textFieldStrategy/normalizeTextFieldPropsFromBackend.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AAG9C,OAAO,KAAK,EAAE,KAAK,EAA4C,MAAM,mBAAmB,CAAC;AAGzF,OAAO,KAAK,EAAE,yCAAyC,EAAE,MAAM,SAAS,CAAC;AAIzE;;;;;;;;;GASG;AACH,wBAAgB,kCAAkC,CAChD,KAAK,EAAE,KAAK,EACZ,QAAQ,EAAE,YAAY,EACtB,aAAa,CAAC,EAAE,MAAM,GACrB,yCAAyC,CAyE3C"}
+{"version":3,"file":"normalizeTextFieldPropsFromBackend.d.ts","sourceRoot":"","sources":["../../../../../../../../../../packages/components/src/components/DynamicForm/helpers/resolveFieldComponent/strategies/textFieldStrategy/normalizeTextFieldPropsFromBackend.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AAG9C,OAAO,KAAK,EAAE,KAAK,EAA4C,MAAM,mBAAmB,CAAC;AAIzF,OAAO,KAAK,EAAE,yCAAyC,EAAE,MAAM,SAAS,CAAC;AAIzE;;;;;;;;;GASG;AACH,wBAAgB,kCAAkC,CAChD,KAAK,EAAE,KAAK,EACZ,QAAQ,EAAE,YAAY,EACtB,aAAa,CAAC,EAAE,MAAM,GACrB,yCAAyC,CAyE3C"}

package/components/DynamicForm/helpers/resolveFieldComponent/strategies/textFieldStrategy/normalizeTextFieldPropsFromBackend.js

@@ -1,29 +1,30 @@
-import { createElement as l } from "react";
+import { createElement as a } from "react";
 import { isRecord as I } from "../../../isRecord.js";
+import { resolveFieldTypeComponentProps as P } from "../../../resolveFieldContractAliases.js";
 import { isPositiveInteger as r } from "../../../isPositiveInteger.js";
 import { resolveAssetSrcWithBase as c } from "../../helpers/resolveAssetSrcWithBase.js";
-import { resolveFieldInputLabel as P } from "../../../resolveFieldInputLabel/resolveFieldInputLabel.js";
-import { Icon as f } from "../../../../../Icon/Icon.js";
-function b(i, p, m) {
-  const s = P(i, p), t = i.fieldType.rhfComponentProps;
+import { resolveFieldInputLabel as u } from "../../../resolveFieldInputLabel/resolveFieldInputLabel.js";
+import { Icon as p } from "../../../../../Icon/Icon.js";
+function k(n, f, m) {
+  const s = u(n, f), t = P(n.fieldType);
   if (!I(t))
     return { resolvedLabel: s };
   const o = {};
   typeof t.id == "string" && t.id.trim() !== "" && (o.id = t.id.trim()), typeof t.htmlFor == "string" && t.htmlFor.trim() !== "" && (o.htmlFor = t.htmlFor.trim()), typeof t.placeholder == "string" && t.placeholder.trim() !== "" && (o.placeholder = t.placeholder.trim()), r(t.maxLength) && (o.maxLength = t.maxLength), typeof t.multiline == "boolean" && (o.multiline = t.multiline), r(t.rows) && (o.rows = t.rows), r(t.minRows) && (o.minRows = t.minRows), r(t.maxRows) && (o.maxRows = t.maxRows);
-  let e, n;
-  typeof t.startAdormentPath == "string" && t.startAdormentPath.trim() !== "" && (e = t.startAdormentPath), typeof t.endAdormentPath == "string" && t.endAdormentPath.trim() !== "" && (n = t.endAdormentPath);
-  const a = e ? l(f, { src: c(m, e) }) : void 0, d = n ? l(f, { src: c(m, n) }) : void 0, {
-    startIcon: u,
-    endIcon: g,
+  let e, i;
+  typeof t.startAdormentPath == "string" && t.startAdormentPath.trim() !== "" && (e = t.startAdormentPath), typeof t.endAdormentPath == "string" && t.endAdormentPath.trim() !== "" && (i = t.endAdormentPath);
+  const l = e ? a(p, { src: c(m, e) }) : void 0, d = i ? a(p, { src: c(m, i) }) : void 0, {
+    startIcon: g,
+    endIcon: v,
     ...h
   } = o;
   return {
     ...h,
     resolvedLabel: s,
-    ...a !== void 0 ? { startIcon: a } : {},
+    ...l !== void 0 ? { startIcon: l } : {},
     ...d !== void 0 ? { endIcon: d } : {}
   };
 }
 export {
-  b as normalizeTextFieldPropsFromBackend
+  k as normalizeTextFieldPropsFromBackend
 };

package/components/DynamicForm/helpers/resolveFieldComponent/strategies/textFieldStrategy/textFieldStrategy.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"textFieldStrategy.d.ts","sourceRoot":"","sources":["../../../../../../../../../../packages/components/src/components/DynamicForm/helpers/resolveFieldComponent/strategies/textFieldStrategy/textFieldStrategy.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,sBAAsB,EAAiC,MAAM,UAAU,CAAC;AAGtF,6BAA6B;AAC7B,eAAO,MAAM,iBAAiB,EAAE,sBAyB/B,CAAC"}
+{"version":3,"file":"textFieldStrategy.d.ts","sourceRoot":"","sources":["../../../../../../../../../../packages/components/src/components/DynamicForm/helpers/resolveFieldComponent/strategies/textFieldStrategy/textFieldStrategy.tsx"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,sBAAsB,EAAiC,MAAM,UAAU,CAAC;AAOtF,6BAA6B;AAC7B,eAAO,MAAM,iBAAiB,EAAE,sBAkD/B,CAAC"}

package/components/DynamicForm/helpers/resolveFieldComponent/strategies/textFieldStrategy/textFieldStrategy.js

@@ -1,28 +1,45 @@
-import { jsx as f } from "@emotion/react/jsx-runtime";
-import { normalizeTextFieldPropsFromBackend as z } from "./normalizeTextFieldPropsFromBackend.js";
-import { RHFTextField as R } from "../../../../../hook-form/RHFTextField/RHFTextField.js";
-const y = {
+import { jsx as r } from "@emotion/react/jsx-runtime";
+import { NotificationWarningFill as R } from "@m4l/icons";
+import { normalizeTextFieldPropsFromBackend as _ } from "./normalizeTextFieldPropsFromBackend.js";
+import { DYNAMIC_FORM_DICTIONARY as i } from "../../../../dictionary.js";
+import { resolveFieldHelperMessage as h, resolveFieldMandatory as S, resolveFieldSymbol as k } from "../../../resolveFieldContractAliases.js";
+import { Icon as x } from "@m4l/base";
+import { DynamicFormFallbackEndIconChipStyled as z } from "../../../../slots/DynamicFormSlots.js";
+import { RHFTextField as A } from "../../../../../hook-form/RHFTextField/RHFTextField.js";
+const G = {
   componentIds: ["RHFTextField"],
   /** Renders the RHFTextField component for the given field and context. */
-  render(o) {
-    const { field: e, props: r } = o, { size: t = "medium", disabled: d, readOnly: s, getLabel: l, assetBasePath: a } = r, { name: n, placeholder: i, isRequired: m, helperText: p } = e, c = z(e, l, a), { resolvedLabel: x, startIcon: F, endIcon: h, ...b } = c;
-    return /* @__PURE__ */ f(
-      R,
+  render(d) {
+    const { field: o, props: n, isFallback: e } = d, { size: t = "medium", disabled: a, readOnly: c, getLabel: l, assetBasePath: m, slots: p } = n, { name: F, placeholder: I } = o, f = (() => {
+      const s = h(o);
+      return e && s ? l(i.FIELD_LOAD_ERROR_MESSAGE) : s || "";
+    })(), b = S(o), E = _(o, l, m), { resolvedLabel: y, startIcon: M, endIcon: g, ...u } = E, N = /* @__PURE__ */ r(
+      z,
       {
-        name: n,
         size: t,
-        label: x,
-        mandatory: m,
-        helperMessage: p || "",
-        disabled: d || s,
-        placeholder: i || void 0,
-        ...b,
-        startIcon: F,
-        endIcon: h
+        label: l(i.UNKNOWN_COMPONENT_MESSAGE),
+        startIcon: /* @__PURE__ */ r(x, { src: /* @__PURE__ */ r(R, {}), color: "chips.warning.contained.color" }),
+        color: "warning",
+        opacity: !0
+      }
+    ), O = e ? p?.fallbackEndIcon ?? N : void 0, { suppressLabel: v } = n;
+    return /* @__PURE__ */ r(
+      A,
+      {
+        name: F,
+        size: t,
+        ...!v && { label: y, symbol: k(o), mandatory: b },
+        helperMessage: f,
+        disabled: e ? a : a || c,
+        placeholder: I || void 0,
+        ...u,
+        startIcon: M,
+        endIcon: e ? O : g,
+        InputProps: e ? { readOnly: !0 } : void 0
       }
     );
   }
 };
 export {
-  y as textFieldStrategy
+  G as textFieldStrategy
 };

package/components/DynamicForm/helpers/resolveFieldComponent/strategies/types.d.ts

@@ -9,6 +9,8 @@ export interface FieldComponentStrategyContext {
     field: Field;
     /** Layout/context props (size, disabled, readOnly). */
     props: ResolveFieldComponentProps;
+    /** When true, the strategy is being used as a fallback for an unregistered componentId. */
+    isFallback?: boolean;
 }
 /**
  * Strategy for rendering a single RHF field component type.

package/components/DynamicForm/helpers/resolveFieldComponent/strategies/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../../../../../../packages/components/src/components/DynamicForm/helpers/resolveFieldComponent/strategies/types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,OAAO,CAAC;AACrC,OAAO,EAAE,KAAK,EAAE,MAAM,gBAAgB,CAAC;AACvC,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,UAAU,CAAC;AAE3D;;;GAGG;AACH,MAAM,WAAW,6BAA6B;IAC5C,KAAK,EAAE,KAAK,CAAC;IACb,uDAAuD;IACvD,KAAK,EAAE,0BAA0B,CAAC;CACnC;AAED;;;;GAIG;AACH,MAAM,WAAW,sBAAsB;IACrC,yGAAyG;IACzG,QAAQ,CAAC,YAAY,EAAE,SAAS,MAAM,EAAE,CAAC;IAEzC;;;;OAIG;IACH,MAAM,CAAC,GAAG,EAAE,6BAA6B,GAAG,YAAY,GAAG,IAAI,CAAC;CACjE"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../../../../../../packages/components/src/components/DynamicForm/helpers/resolveFieldComponent/strategies/types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,OAAO,CAAC;AACrC,OAAO,EAAE,KAAK,EAAE,MAAM,gBAAgB,CAAC;AACvC,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,UAAU,CAAC;AAE3D;;;GAGG;AACH,MAAM,WAAW,6BAA6B;IAC5C,KAAK,EAAE,KAAK,CAAC;IACb,uDAAuD;IACvD,KAAK,EAAE,0BAA0B,CAAC;IAClC,2FAA2F;IAC3F,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB;AAED;;;;GAIG;AACH,MAAM,WAAW,sBAAsB;IACrC,yGAAyG;IACzG,QAAQ,CAAC,YAAY,EAAE,SAAS,MAAM,EAAE,CAAC;IAEzC;;;;OAIG;IACH,MAAM,CAAC,GAAG,EAAE,6BAA6B,GAAG,YAAY,GAAG,IAAI,CAAC;CACjE"}

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

@@ -1,4 +1,12 @@
 import { GetLabelType } from '@m4l/core';
+import { ReactElement } from 'react';
+/**
+ * Slot overrides for the rendered elements in resolveFieldComponent strategies.
+ */
+export interface ResolveFieldComponentSlots {
+    /** Overrides the default warning chip rendered in the endIcon position when the field is a fallback. */
+    fallbackEndIcon?: ReactElement;
+}
 /**
  * Props passed to resolveFieldComponent. Only layout/context props; the rest are taken from the field.
  */
@@ -10,7 +18,14 @@ export interface ResolveFieldComponentProps {
     assetBasePath?: string;
     /** Remote API base URL (`host_api_remote`); used to resolve relative `startAdornment` paths on select options. */
     hostApiRemote?: string;
-    /** Module dictionary resolver (required for missing `field.fieldLabel` fallback). */
+    /** Module dictionary resolver (required for missing `field.label` fallback). */
     getLabel: GetLabelType;
+    /** Slot overrides for the rendered field elements. */
+    slots?: ResolveFieldComponentSlots;
+    /**
+     * When true, strategies omit `label`, `mandatory`, and `symbol` from the rendered RHF component.
+     * Use this when the caller (e.g. DynamicFormContent via PropertyValue) provides the label externally.
+     */
+    suppressLabel?: boolean;
 }
 //# sourceMappingURL=types.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../../../../../packages/components/src/components/DynamicForm/helpers/resolveFieldComponent/types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AAEzC;;GAEG;AACH,MAAM,WAAW,0BAA0B;IACzC,IAAI,CAAC,EAAE,OAAO,GAAG,QAAQ,CAAC;IAC1B,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,oFAAoF;IACpF,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,kHAAkH;IAClH,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,qFAAqF;IACrF,QAAQ,EAAE,YAAY,CAAC;CACxB"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../../../../../packages/components/src/components/DynamicForm/helpers/resolveFieldComponent/types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,EAAE,YAAY,EAAE,MAAM,OAAO,CAAC;AAErC;;GAEG;AACH,MAAM,WAAW,0BAA0B;IACzC,wGAAwG;IACxG,eAAe,CAAC,EAAE,YAAY,CAAC;CAChC;AAED;;GAEG;AACH,MAAM,WAAW,0BAA0B;IACzC,IAAI,CAAC,EAAE,OAAO,GAAG,QAAQ,CAAC;IAC1B,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,oFAAoF;IACpF,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,kHAAkH;IAClH,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,gFAAgF;IAChF,QAAQ,EAAE,YAAY,CAAC;IACvB,sDAAsD;IACtD,KAAK,CAAC,EAAE,0BAA0B,CAAC;IACnC;;;OAGG;IACH,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB"}

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

@@ -0,0 +1,19 @@
+import { CombinedFieldComponentPropsFromBackend, Field, FieldType } from '../types';
+/**
+ * Resolve the component props payload, preferring `componentProps` over the deprecated `rhfComponentProps`.
+ * Returns an empty object when `fieldType` is missing to prevent downstream crashes.
+ */
+export declare function resolveFieldTypeComponentProps(fieldType: Pick<FieldType, 'componentProps' | 'rhfComponentProps'> | null | undefined): CombinedFieldComponentPropsFromBackend | undefined;
+export declare function resolveFieldMandatory(field: Pick<Field, 'mandatory' | 'isRequired'>): boolean;
+/**
+ * Resolve the field helper text, preferring `helperMessage` over the deprecated `helperText`.
+ */
+export declare function resolveFieldHelperMessage(field: Pick<Field, 'helperMessage' | 'helperText'>): string | null;
+export declare function resolveFieldLabelValue(field: Pick<Field, 'label' | 'fieldLabel'>): string | null;
+/**
+ * Resolve the magnitude-unit symbol shown in parentheses after the field label
+ * (e.g. `V` → `Voltage (V)`). Returns `undefined` when `magnitudeUnit` or its
+ * `symbol` is falsy (undefined, null, empty string) so the `symbol` prop is omitted.
+ */
+export declare function resolveFieldSymbol(field: Pick<Field, 'magnitudeUnit'>): string | undefined;
+//# sourceMappingURL=resolveFieldContractAliases.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"resolveFieldContractAliases.d.ts","sourceRoot":"","sources":["../../../../../../../packages/components/src/components/DynamicForm/helpers/resolveFieldContractAliases.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,sCAAsC,EACtC,KAAK,EACL,SAAS,EACV,MAAM,UAAU,CAAC;AAElB;;;GAGG;AACH,wBAAgB,8BAA8B,CAC5C,SAAS,EAAE,IAAI,CAAC,SAAS,EAAE,gBAAgB,GAAG,mBAAmB,CAAC,GAAG,IAAI,GAAG,SAAS,GACpF,sCAAsC,GAAG,SAAS,CAKpD;AAED,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,WAAW,GAAG,YAAY,CAAC,GAAG,OAAO,CAE7F;AAED;;GAEG;AACH,wBAAgB,yBAAyB,CACvC,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,eAAe,GAAG,YAAY,CAAC,GACjD,MAAM,GAAG,IAAI,CAEf;AAED,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,OAAO,GAAG,YAAY,CAAC,GAAG,MAAM,GAAG,IAAI,CAEhG;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,eAAe,CAAC,GAAG,MAAM,GAAG,SAAS,CAE1F"}

package/components/DynamicForm/helpers/resolveFieldContractAliases.js

@@ -0,0 +1,23 @@
+function n(e) {
+  if (e)
+    return e.componentProps ?? e.rhfComponentProps;
+}
+function r(e) {
+  return e.mandatory ?? e.isRequired ?? !1;
+}
+function o(e) {
+  return e.helperMessage ?? e.helperText ?? null;
+}
+function l(e) {
+  return e.label ?? e.fieldLabel ?? null;
+}
+function t(e) {
+  return e.magnitudeUnit?.symbol || void 0;
+}
+export {
+  o as resolveFieldHelperMessage,
+  l as resolveFieldLabelValue,
+  r as resolveFieldMandatory,
+  t as resolveFieldSymbol,
+  n as resolveFieldTypeComponentProps
+};

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

@@ -2,7 +2,7 @@ import { GetLabelType } from '@m4l/core';
 import { Field } from '../../types';
 /**
  * Resolves the visible label for a dynamic form field.
- * Uses `field.fieldLabel` when the API sends a non-empty string; otherwise shows
+ * Uses `field.label` when the API sends a non-empty string; otherwise shows
  * `dynamic_form.label_not_found_message` from the module dictionary with `$1` = field id.
  */
 export declare function resolveFieldInputLabel(field: Field, getLabel: GetLabelType): string;

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

@@ -1 +1 @@
-{"version":3,"file":"resolveFieldInputLabel.d.ts","sourceRoot":"","sources":["../../../../../../../../packages/components/src/components/DynamicForm/helpers/resolveFieldInputLabel/resolveFieldInputLabel.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AAEzC,OAAO,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AAEpC;;;;GAIG;AACH,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,KAAK,EAAE,QAAQ,EAAE,YAAY,GAAG,MAAM,CAMnF"}
+{"version":3,"file":"resolveFieldInputLabel.d.ts","sourceRoot":"","sources":["../../../../../../../../packages/components/src/components/DynamicForm/helpers/resolveFieldInputLabel/resolveFieldInputLabel.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AAEzC,OAAO,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AAGpC;;;;GAIG;AACH,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,KAAK,EAAE,QAAQ,EAAE,YAAY,GAAG,MAAM,CAMnF"}

package/components/DynamicForm/helpers/resolveFieldInputLabel/resolveFieldInputLabel.js

@@ -1,8 +1,9 @@
-import { DYNAMIC_FORM_DICTIONARY as o } from "../../dictionary.js";
-function n(e, t) {
-  const r = e.fieldLabel;
-  return typeof r == "string" && r.trim() !== "" ? r : t(o.LABEL_NOT_FOUND_MESSAGE, e.id);
+import { DYNAMIC_FORM_DICTIONARY as t } from "../../dictionary.js";
+import { resolveFieldLabelValue as i } from "../resolveFieldContractAliases.js";
+function m(e, o) {
+  const r = i(e);
+  return typeof r == "string" && r.trim() !== "" ? r : o(t.LABEL_NOT_FOUND_MESSAGE, e.id);
 }
 export {
-  n as resolveFieldInputLabel
+  m as resolveFieldInputLabel
 };

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

@@ -1 +1 @@
-{"version":3,"file":"resolveInitialValue.d.ts","sourceRoot":"","sources":["../../../../../../../../packages/components/src/components/DynamicForm/helpers/resolveInitialValue/resolveInitialValue.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AAMpC,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,SAAS,CAAC;AAmEzD;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,KAAK,GAAG,yBAAyB,CAgI3E"}
+{"version":3,"file":"resolveInitialValue.d.ts","sourceRoot":"","sources":["../../../../../../../../packages/components/src/components/DynamicForm/helpers/resolveInitialValue/resolveInitialValue.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AAIpC,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,SAAS,CAAC;AA8HzD;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,KAAK,GAAG,yBAAyB,CAqI3E"}

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

@@ -1,88 +1,105 @@
-import { EMPTY_DATE_TIME_RANGE_PICKER_VALUE as s } from "../../../DateTimeRangePicker/constants.js";
-import { createDateRangeValue as f } from "../../../DateRangeCalendarPicker/helpers.js";
-import { isRecord as V } from "../isRecord.js";
-import { isDynamicFormDateRangeField as R } from "../isDateRangeField.js";
-function u(e) {
-  if (e == null || e === "")
+import { getPropertyByString as A } from "@m4l/core";
+import { createDateRangeValue as s } from "../../../DateRangeCalendarPicker/helpers.js";
+import { EMPTY_DATE_TIME_RANGE_PICKER_VALUE as f } from "../../../DateTimeRangePicker/constants.js";
+import { isDynamicFormDateRangeField as D } from "../isDateRangeField.js";
+import { isRecord as l } from "../isRecord.js";
+import { resolveFieldTypeComponentProps as y } from "../resolveFieldContractAliases.js";
+function p(r, i) {
+  if (typeof r == "number" || typeof r == "boolean")
+    return r;
+  if (i === "fft_boolean" || i === "fft_checkbox") {
+    const n = r.trim().toLowerCase();
+    return n === "true" ? !0 : n === "false" ? !1 : !!r;
+  }
+  const t = Number(r);
+  return !isNaN(t) && r.trim() !== "" ? t : r;
+}
+function o(r) {
+  if (r == null || r === "")
     return null;
-  if (e instanceof Date)
-    return Number.isNaN(e.getTime()) ? null : new Date(e);
-  if (typeof e == "number" || typeof e == "string") {
-    const i = new Date(e);
+  if (r instanceof Date)
+    return Number.isNaN(r.getTime()) ? null : new Date(r);
+  if (typeof r == "number" || typeof r == "string") {
+    const i = new Date(r);
     return Number.isNaN(i.getTime()) ? null : i;
   }
   return null;
 }
-function l(e) {
-  if (Array.isArray(e))
-    return e.length !== 2 ? null : f(
-      u(e[0]),
-      u(e[1])
+function c(r) {
+  if (Array.isArray(r))
+    return r.length !== 2 ? null : s(
+      o(r[0]),
+      o(r[1])
     );
-  if (typeof e == "string")
+  if (typeof r == "string")
     try {
-      return l(JSON.parse(e));
+      return c(JSON.parse(r));
     } catch {
       return null;
     }
-  return V(e) ? "startDate" in e || "endDate" in e ? f(
-    u(e.startDate),
-    u(e.endDate)
-  ) : "start" in e || "end" in e ? f(
-    u(e.start),
-    u(e.end)
+  return l(r) ? "startDate" in r || "endDate" in r ? s(
+    o(r.startDate),
+    o(r.endDate)
+  ) : "start" in r || "end" in r ? s(
+    o(r.start),
+    o(r.end)
   ) : null : null;
 }
-function k(e) {
-  const i = R(e);
-  if (e.currentValue !== null && e.isVisible) {
-    const r = e.currentValue, n = e.fieldType.componentId === "RHFCheckableList", m = e.fieldType.componentId === "RHFDaysOfWeekPicker", y = n || m, d = e.fieldType.componentId === "RHFAutoComplete", N = e.fieldType.componentId === "RHFSelect" && e.fieldType.rhfComponentProps?.isMultiple === !0;
-    if (d)
+function m(r, i) {
+  if (!Array.isArray(r.options))
+    return null;
+  const t = y(r.fieldType), n = typeof t?.equalToValuePath == "string" && t.equalToValuePath.trim() !== "" ? t.equalToValuePath.trim() : "id", u = r.options.find((e) => l(e) ? String(A(e, n)) === String(i) : !1);
+  return l(u) ? u : null;
+}
+function S(r) {
+  if (!r.fieldType)
+    return null;
+  const i = y(r.fieldType), t = r.fieldType?.componentId, n = r.fieldType?.id, u = D(r);
+  if (r.currentValue !== null && r.isVisible !== !1) {
+    const e = r.currentValue, V = t === "RHFCheckableList" || t === "RHFDaysOfWeekPicker", g = t === "RHFAutoComplete", R = t === "RHFImageSelector", b = t === "RHFSelect" && i?.isMultiple === !0;
+    if (g)
       return;
-    if (i)
-      return l(r) ?? s;
-    if (y || N) {
-      if (Array.isArray(r))
-        return r;
-      if (typeof r == "string")
+    if (u)
+      return c(e) ?? f;
+    if (R && (typeof e == "string" || typeof e == "number"))
+      return m(r, e);
+    if (V || b) {
+      if (Array.isArray(e))
+        return e;
+      if (typeof e == "string")
         try {
-          const t = JSON.parse(r);
-          if (Array.isArray(t))
-            return t;
+          const a = JSON.parse(e);
+          if (Array.isArray(a))
+            return a;
         } catch {
-          const t = Number(r);
-          return !isNaN(t) && r.trim() !== "" ? [t] : [r];
+          const a = Number(e);
+          return !isNaN(a) && e.trim() !== "" ? [a] : [e];
         }
-      return [r];
+      return [e];
     }
-    if (typeof r == "number" || Array.isArray(r))
-      return r;
-    const c = e.fieldType.id;
-    if (c === "fft_boolean" || c === "fft_checkbox") {
-      const t = r.trim().toLowerCase();
-      return t === "true" ? !0 : t === "false" ? !1 : !!r;
-    }
-    const p = Number(r);
-    return !isNaN(p) && r.trim() !== "" ? p : r;
+    return Array.isArray(e) ? e : p(e, n);
   }
-  if (e.defaultValue !== null && e.defaultValue !== void 0) {
-    if (i)
-      return l(e.defaultValue) ?? s;
-    if (e.fieldType.componentId === "RHFCheckableList" || e.fieldType.componentId === "RHFDaysOfWeekPicker")
-      try {
-        const n = JSON.parse(e.defaultValue);
-        if (Array.isArray(n))
-          return n;
-      } catch {
-        const n = Number(e.defaultValue);
-        return !isNaN(n) && e.defaultValue.trim() !== "" ? [n] : [e.defaultValue];
-      }
-    const r = Number(e.defaultValue);
-    return !isNaN(r) && e.defaultValue.trim() !== "" ? r : e.defaultValue;
+  if (r.defaultValue !== null && r.defaultValue !== void 0) {
+    if (u)
+      return c(r.defaultValue) ?? f;
+    if (t === "RHFImageSelector" && (typeof r.defaultValue == "string" || typeof r.defaultValue == "number"))
+      return m(r, r.defaultValue);
+    if (t === "RHFCheckableList" || t === "RHFDaysOfWeekPicker") {
+      if (typeof r.defaultValue == "string")
+        try {
+          const e = JSON.parse(r.defaultValue);
+          if (Array.isArray(e))
+            return e;
+        } catch {
+          const e = Number(r.defaultValue);
+          return !isNaN(e) && r.defaultValue.trim() !== "" ? [e] : [r.defaultValue];
+        }
+      return [r.defaultValue];
+    }
+    return p(r.defaultValue, n);
   }
-  const o = e.fieldType.id, a = e.fieldType.componentId;
-  return a === "RHFCheckableList" || a === "RHFDaysOfWeekPicker" ? [] : a === "RHFAutoComplete" ? e.fieldType.rhfComponentProps?.isMultiple === !0 ? [] : null : a === "RHFRadioGroup" ? null : i ? s : o === "fft_boolean" || o === "fft_checkbox" ? !1 : null;
+  return t === "RHFCheckableList" || t === "RHFDaysOfWeekPicker" ? [] : t === "RHFAutoComplete" ? i?.isMultiple === !0 ? [] : null : t === "RHFImageSelector" || t === "RHFRadioGroup" ? null : u ? f : n === "fft_boolean" || n === "fft_checkbox" ? !1 : null;
 }
 export {
-  k as resolveInitialValue
+  S as resolveInitialValue
 };

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

@@ -6,9 +6,16 @@ export type AutocompleteOptionValue = {
     id: string | number;
     label: string;
 };
+/**
+ * Generic object option returned by field strategies that keep the full option row in form state.
+ */
+export type ObjectOptionValue = Record<string, unknown>;
 /**
  * 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.
+ * Can be a primitive, array (e.g. for checkable list), option object (for RHFAutoComplete),
+ * date-range object, or null/undefined.
+ * The array member mirrors FieldCurrentValue scalars (boolean included) because currentValue/defaultValue
+ * are wrapped as single-item arrays for array-type fields without narrowing booleans.
  */
-export type ResolveInitialValueResult = string | number | boolean | (string | number)[] | AutocompleteOptionValue | DateTimeRangePickerValue | null | undefined;
+export type ResolveInitialValueResult = string | number | boolean | (string | number | boolean)[] | AutocompleteOptionValue | DateTimeRangePickerValue | ObjectOptionValue | null | undefined;
 //# sourceMappingURL=types.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../../../../../packages/components/src/components/DynamicForm/helpers/resolveInitialValue/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,oCAAoC,CAAC;AAEnF;;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,wBAAwB,GACxB,IAAI,GACJ,SAAS,CAAC"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../../../../../packages/components/src/components/DynamicForm/helpers/resolveInitialValue/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,oCAAoC,CAAC;AAEnF;;GAEG;AACH,MAAM,MAAM,uBAAuB,GAAG;IAAE,EAAE,EAAE,MAAM,GAAG,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC;AAE7E;;GAEG;AACH,MAAM,MAAM,iBAAiB,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAExD;;;;;;GAMG;AACH,MAAM,MAAM,yBAAyB,GACjC,MAAM,GACN,MAAM,GACN,OAAO,GACP,CAAC,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,EAAE,GAC7B,uBAAuB,GACvB,wBAAwB,GACxB,iBAAiB,GACjB,IAAI,GACJ,SAAS,CAAC"}

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

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