@m4l/components 9.5.2 → 9.5.3-beta-feature-671-shared-reports-viewer-mf.0

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

@@ -1,36 +1,64 @@
 import { jsx as g } from "@emotion/react/jsx-runtime";
-import { getPropertyByString as y } from "@m4l/core";
-import { RHFAutocomplete as A } from "../../../../../hook-form/RHFAutocomplete/RHFAutocomplete.js";
-import { createIsOptionEqualToValue as b } from "../../../createIsOptionEqualToValue/createIsOptionEqualToValue.js";
-function r(o) {
-  if (o?.resource)
-    return () => ({ resource: o.resource, type: o.type });
-}
-const P = {
+import { createAutocompleteAsyncOnChangeFilterParms as V } from "./createAutocompleteAsyncOnChangeFilterParms.js";
+import { normalizeAutocompletePropsFromBackend as q } from "./normalizeAutocompletePropsFromBackend.js";
+import { RHFAutocompleteAsync as S } from "../../../../../hook-form/RHFAutocompleteAsync/RHFAutocompleteAsync.js";
+import { RHFAutocomplete as T } from "../../../../../hook-form/RHFAutocomplete/RHFAutocomplete.js";
+const j = {
   componentIds: ["RHFAutoComplete"],
   /** Renders the RHFAutocomplete component for the given field and context. */
-  render(o) {
-    const { field: t, props: p, selectOptions: l } = o, { size: s = "medium", disabled: a, readOnly: i } = p, { name: m, placeholder: d } = t, e = t.fieldType.rhfComponentProps ?? {}, c = e?.isOptionEqualToValue ?? "id", u = b(c), O = r(e?.getOptionStartAdornment), f = r(e?.getOptionEndAdornment);
+  render(v) {
+    const { field: e, props: F } = v, { size: s = "medium", disabled: p, readOnly: a, getLabel: h, hostApiRemote: y } = F, { name: d, placeholder: m, isRequired: c, helperText: u } = e, { endpoint: l, endpointParams: E } = e, f = q(e, h, y), {
+      isMultiple: i,
+      resolvedLabel: A,
+      resolvedOptions: L,
+      resolvedGetOptionLabel: R,
+      resolvedIsOptionEqualToValue: P,
+      resolvedOptionStartAdornment: t,
+      resolvedOptionEndAdornment: n
+    } = f, O = R ?? ((o) => o.label), b = P ?? ((o, r) => o === r);
+    if (typeof l == "string" && l.trim() !== "") {
+      const o = e.endpointFilterFieldLabel !== void 0 || e.endpointFilterFieldValueString !== void 0 || e.endpointFilterFieldValueNumber !== void 0, r = !i && o ? V(e) : void 0;
+      return /* @__PURE__ */ g(
+        S,
+        {
+          name: d,
+          size: s,
+          label: A,
+          mandatory: c,
+          helperMessage: u || "",
+          disabled: p || a,
+          placeholder: m ?? void 0,
+          multiple: i,
+          endPoint: l,
+          parms: E,
+          getOptionLabel: O,
+          isOptionEqualToValue: b,
+          ...t ? { getOptionStartAdornment: t } : {},
+          ...n ? { getOptionEndAdornment: n } : {},
+          onChangeFilterParms: r
+        }
+      );
+    }
     return /* @__PURE__ */ g(
-      A,
+      T,
       {
-        name: m,
+        name: d,
         size: s,
-        label: t.name,
-        mandatory: t.isRequired,
-        helperMessage: t.helperText || "",
-        disabled: a || i,
-        placeholder: d ?? void 0,
-        options: l,
-        multiple: e?.isMultiple ?? !1,
-        getOptionLabel: e?.getOptionLabel ? (n) => y(n, e.getOptionLabel ?? "") : (n) => n.label,
-        isOptionEqualToValue: u,
-        getOptionStartAdornment: O,
-        getOptionEndAdornment: f
+        label: A,
+        mandatory: c,
+        helperMessage: u || "",
+        disabled: p || a,
+        placeholder: m ?? void 0,
+        options: L,
+        multiple: i,
+        getOptionLabel: O,
+        isOptionEqualToValue: b,
+        ...t ? { getOptionStartAdornment: t } : {},
+        ...n ? { getOptionEndAdornment: n } : {}
       }
     );
   }
 };
 export {
-  P as autocompleteStrategy
+  j as autocompleteStrategy
 };

package/components/DynamicForm/helpers/resolveFieldComponent/strategies/autocompleteStrategy/createAutocompleteAsyncOnChangeFilterParms.d.ts

@@ -0,0 +1,8 @@
+import { OnChangeFilterParms } from '../../../../../extended/mui/AutocompleteAsync/types';
+import { Field } from '../../../../types';
+/**
+ * Builds `onChangeFilterParms` for DynamicForm + RHFAutocompleteAsync when `field.endpoint` is set.
+ * Sends `f: [{ n, o: 'c', o1 }]` for search-as-you-type (single selection only).
+ */
+export declare function createAutocompleteAsyncOnChangeFilterParms(field: Field): OnChangeFilterParms;
+//# sourceMappingURL=createAutocompleteAsyncOnChangeFilterParms.d.ts.map

package/components/DynamicForm/helpers/resolveFieldComponent/strategies/autocompleteStrategy/createAutocompleteAsyncOnChangeFilterParms.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"createAutocompleteAsyncOnChangeFilterParms.d.ts","sourceRoot":"","sources":["../../../../../../../../../../packages/components/src/components/DynamicForm/helpers/resolveFieldComponent/strategies/autocompleteStrategy/createAutocompleteAsyncOnChangeFilterParms.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,qDAAqD,CAAC;AAC/F,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAC;AAkC/C;;;GAGG;AACH,wBAAgB,0CAA0C,CACxD,KAAK,EAAE,KAAK,GACX,mBAAmB,CAgBrB"}

package/components/DynamicForm/helpers/resolveFieldComponent/strategies/autocompleteStrategy/createAutocompleteAsyncOnChangeFilterParms.js

@@ -0,0 +1,22 @@
+const l = /^-?\d+(\.\d+)?$/;
+function u(n, t) {
+  const e = t.trim(), i = n.endpointFilterFieldLabel, o = n.endpointFilterFieldValueString, r = n.endpointFilterFieldValueNumber;
+  return r && e !== "" && l.test(e) ? { n: r, o1: Number(e) } : i ? { n: i, o1: e } : o ? { n: o, o1: e } : r ? { n: r, o1: e } : null;
+}
+function c(n) {
+  return (t) => {
+    const e = u(n, t);
+    return e ? {
+      f: [
+        {
+          n: e.n,
+          o: "c",
+          o1: e.o1
+        }
+      ]
+    } : {};
+  };
+}
+export {
+  c as createAutocompleteAsyncOnChangeFilterParms
+};

package/components/DynamicForm/helpers/resolveFieldComponent/strategies/autocompleteStrategy/normalizeAutocompletePropsFromBackend.d.ts

@@ -0,0 +1,29 @@
+import { GetLabelType } from '@m4l/core';
+import { ResourceType } from '../../../../../extended/mui/Autocomplete/types';
+import { Field, RHFAutocompleteRHFComponentPropsFromBackend } from '../../../../types';
+/**
+ * `getOptionStartAdornment` / `getOptionEndAdornment`: per-option resource derived from backend path
+ * expressions and joined with `hostApiRemote` when the value is relative.
+ */
+type OptionAdornmentGetter = (option: unknown) => ResourceType;
+export type NormalizedAutocompletePropsFromBackend<T = unknown> = Partial<RHFAutocompleteRHFComponentPropsFromBackend> & {
+    resolvedLabel?: string;
+    /** `field.options` when it is an array; otherwise `[]` (runtime-safe). */
+    resolvedOptions: T[];
+    resolvedGetOptionLabel?: (option: any) => string;
+    resolvedIsOptionEqualToValue?: (option: any, value: any) => boolean;
+    resolvedOptionStartAdornment?: OptionAdornmentGetter;
+    resolvedOptionEndAdornment?: OptionAdornmentGetter;
+};
+/**
+ * Reads `field.fieldType.rhfComponentProps` and returns only values supported by
+ * RHFAutocomplete/RHFAutocompleteAsync. Unknown keys or invalid value types are ignored.
+ * Always resolves runtime-ready props for `autocompleteStrategy` (`resolvedLabel`, option label
+ * resolver, equality resolver, adornments).
+ * @param hostApiRemote - Optional `host_api_remote` from environment; used to resolve relative paths read
+ * from each option via `option*Adornment*Path` expressions.
+ * @template T Option row type for `RHFAutocomplete<T>` (defaults to `unknown` when not specified at the call site).
+ */
+export declare function normalizeAutocompletePropsFromBackend<T = unknown>(field: Field, getLabel: GetLabelType, hostApiRemote?: string): NormalizedAutocompletePropsFromBackend<T>;
+export {};
+//# sourceMappingURL=normalizeAutocompletePropsFromBackend.d.ts.map

package/components/DynamicForm/helpers/resolveFieldComponent/strategies/autocompleteStrategy/normalizeAutocompletePropsFromBackend.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"normalizeAutocompletePropsFromBackend.d.ts","sourceRoot":"","sources":["../../../../../../../../../../packages/components/src/components/DynamicForm/helpers/resolveFieldComponent/strategies/autocompleteStrategy/normalizeAutocompletePropsFromBackend.ts"],"names":[],"mappings":"AAAA,OAAO,EAAuB,YAAY,EAAE,MAAM,WAAW,CAAC;AAC9D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,gDAAgD,CAAC;AACnF,OAAO,KAAK,EAAE,KAAK,EAAE,2CAA2C,EAAE,MAAM,mBAAmB,CAAC;AAQ5F;;;GAGG;AACH,KAAK,qBAAqB,GAAG,CAAC,MAAM,EAAE,OAAO,KAAK,YAAY,CAAC;AAa/D,MAAM,MAAM,sCAAsC,CAAC,CAAC,GAAG,OAAO,IAAI,OAAO,CAAC,2CAA2C,CAAC,GAAG;IACvH,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,0EAA0E;IAC1E,eAAe,EAAE,CAAC,EAAE,CAAC;IACrB,sBAAsB,CAAC,EAAE,CAAC,MAAM,EAAE,GAAG,KAAK,MAAM,CAAC;IACjD,4BAA4B,CAAC,EAAE,CAAC,MAAM,EAAE,GAAG,EAAE,KAAK,EAAE,GAAG,KAAK,OAAO,CAAC;IACpE,4BAA4B,CAAC,EAAE,qBAAqB,CAAC;IACrD,0BAA0B,CAAC,EAAE,qBAAqB,CAAC;CACpD,CAAC;AAiDF;;;;;;;;GAQG;AACH,wBAAgB,qCAAqC,CAAC,CAAC,GAAG,OAAO,EAC/D,KAAK,EAAE,KAAK,EACZ,QAAQ,EAAE,YAAY,EACtB,aAAa,CAAC,EAAE,MAAM,GACrB,sCAAsC,CAAC,CAAC,CAAC,CA2D3C"}

package/components/DynamicForm/helpers/resolveFieldComponent/strategies/autocompleteStrategy/normalizeAutocompletePropsFromBackend.js

@@ -0,0 +1,52 @@
+import { getPropertyByString as d } from "@m4l/core";
+import { isRecord as l } from "../../../isRecord.js";
+import { resolveRemoteOrAbsoluteAssetSrc as s } from "../../helpers/resolveRemoteOrAbsoluteAssetSrc.js";
+import { resolveFieldInputLabel as c } from "../../../resolveFieldInputLabel/resolveFieldInputLabel.js";
+import { createIsOptionEqualToValue as f } from "../../../createIsOptionEqualToValue/createIsOptionEqualToValue.js";
+const e = { resource: "" };
+function P(n) {
+  return Array.isArray(n) ? n : [];
+}
+function u(n, i, a) {
+  if (n && n.trim() !== "") {
+    const m = n.trim();
+    return (o) => {
+      if (!l(o))
+        return e;
+      const t = d(o, m);
+      if (typeof t != "string" || t.trim() === "")
+        return e;
+      const r = s(a, t);
+      return r ? { resource: r, type: "icon" } : e;
+    };
+  }
+  if (i && i.trim() !== "") {
+    const m = i.trim();
+    return (o) => {
+      if (!l(o))
+        return e;
+      const t = d(o, m);
+      if (typeof t != "string" || t.trim() === "")
+        return e;
+      const r = s(a, t);
+      return r ? { resource: r, type: "image" } : e;
+    };
+  }
+}
+function S(n, i, a) {
+  const m = P(n.options), o = n.fieldType.rhfComponentProps, t = { resolvedOptions: m };
+  l(o) && (typeof o.optionLabelPath == "string" && o.optionLabelPath.trim() !== "" && (t.optionLabelPath = o.optionLabelPath), typeof o.equalToValuePath == "string" && o.equalToValuePath.trim() !== "" && (t.equalToValuePath = o.equalToValuePath), typeof o.isMultiple == "boolean" && (t.isMultiple = o.isMultiple), typeof o.optionEndAdornmentIconPath == "string" && o.optionEndAdornmentIconPath.trim() !== "" && (t.optionEndAdornmentIconPath = o.optionEndAdornmentIconPath), typeof o.optionEndAdornmentImagePath == "string" && o.optionEndAdornmentImagePath.trim() !== "" && (t.optionEndAdornmentImagePath = o.optionEndAdornmentImagePath), typeof o.optionStartAdornmentIconPath == "string" && o.optionStartAdornmentIconPath.trim() !== "" && (t.optionStartAdornmentIconPath = o.optionStartAdornmentIconPath), typeof o.optionStartAdornmentImagePath == "string" && o.optionStartAdornmentImagePath.trim() !== "" && (t.optionStartAdornmentImagePath = o.optionStartAdornmentImagePath));
+  const r = t.equalToValuePath ?? "id";
+  return t.resolvedLabel = c(n, i), t.resolvedIsOptionEqualToValue = f(r), t.resolvedGetOptionLabel = t.optionLabelPath ? (p) => d(p, t.optionLabelPath ?? "") : (p) => p.label, t.resolvedOptionStartAdornment = u(
+    t.optionStartAdornmentIconPath,
+    t.optionStartAdornmentImagePath,
+    a
+  ), t.resolvedOptionEndAdornment = u(
+    t.optionEndAdornmentIconPath,
+    t.optionEndAdornmentImagePath,
+    a
+  ), t;
+}
+export {
+  S as normalizeAutocompletePropsFromBackend
+};

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

@@ -1 +1 @@
-{"version":3,"file":"checkableListStrategy.d.ts","sourceRoot":"","sources":["../../../../../../../../../../packages/components/src/components/DynamicForm/helpers/resolveFieldComponent/strategies/checkableListStrategy/checkableListStrategy.tsx"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,sBAAsB,EAAiC,MAAM,UAAU,CAAC;AAEtF;;;GAGG;AACH,eAAO,MAAM,qBAAqB,EAAE,sBAmCnC,CAAC"}
+{"version":3,"file":"checkableListStrategy.d.ts","sourceRoot":"","sources":["../../../../../../../../../../packages/components/src/components/DynamicForm/helpers/resolveFieldComponent/strategies/checkableListStrategy/checkableListStrategy.tsx"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,sBAAsB,EAAiC,MAAM,UAAU,CAAC;AAGtF;;;GAGG;AACH,eAAO,MAAM,qBAAqB,EAAE,sBAkCnC,CAAC"}

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

@@ -1,28 +1,36 @@
-import { jsx as t } from "@emotion/react/jsx-runtime";
-import { DynamicFormCheckableListWrapperStyled as u } from "../../../../slots/DynamicFormSlots.js";
-import { RHFCheckableList as g } from "../../../../../hook-form/RHFCheckableList/RHFCheckableList.js";
-const k = {
+import { jsx as o } from "@emotion/react/jsx-runtime";
+import { normalizeCheckableListPropsFromBackend as u } from "./normalizeCheckableListPropsFromBackend.js";
+import { DynamicFormCheckableListWrapperStyled as g } from "../../../../slots/DynamicFormSlots.js";
+import { RHFCheckableList as v } from "../../../../../hook-form/RHFCheckableList/RHFCheckableList.js";
+const x = {
   componentIds: ["RHFCheckableList"],
   /** Renders the RHFCheckableList component for the given field and context. */
-  render(a) {
-    const { field: e, props: p, checkableListItems: n } = a, { size: i = "medium", disabled: l, readOnly: c } = p, { name: m } = e, r = e.fieldType.rhfComponentProps ?? {}, o = r?.groups !== void 0 && Array.isArray(r.groups) && r.groups.length > 0, { groups: d, searchable: s, ...h } = r, b = s != null ? !!s : o;
-    return /* @__PURE__ */ t(u, { children: /* @__PURE__ */ t(
-      g,
+  render(s) {
+    const { field: e, props: a } = s, { size: t = "medium", disabled: l, readOnly: i, getLabel: m } = a, { name: d, isRequired: c, helperText: n } = e, p = u(e, m), {
+      groups: b,
+      resolvedLabel: h,
+      hasGroups: r,
+      resolvedSearchable: L,
+      resolvedCheckableListItems: k,
+      ...f
+    } = p;
+    return /* @__PURE__ */ o(g, { children: /* @__PURE__ */ o(
+      v,
       {
-        name: m,
-        size: i,
-        label: e.name,
-        mandatory: e.isRequired,
-        items: o ? void 0 : n,
-        groups: o ? d : void 0,
-        helperMessage: e.helperText || "",
-        disabled: l || c,
-        searchable: b,
-        ...h
+        name: d,
+        size: t,
+        label: h ?? "",
+        mandatory: c,
+        items: r ? void 0 : k,
+        groups: r ? b : void 0,
+        helperMessage: n || "",
+        disabled: l || i,
+        searchable: L ?? !1,
+        ...f
       }
     ) });
   }
 };
 export {
-  k as checkableListStrategy
+  x as checkableListStrategy
 };

package/components/DynamicForm/helpers/resolveFieldComponent/strategies/checkableListStrategy/helpers/fieldPropsNormalizers/fieldPropNormalizers.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Accepts only `select-all` or `indicate-some` for `indeterminateBehavior`.
+ * @param value - Raw value from the API.
+ * @returns A valid literal, or `undefined`.
+ */
+export declare function normalizeIndeterminateBehavior(value: unknown): 'select-all' | 'indicate-some' | undefined;
+/**
+ * Accepts only `small` or `medium` for `checkboxSize`.
+ * @param value - Raw value from the API.
+ * @returns A valid size literal, or `undefined`.
+ */
+export declare function normalizeCheckboxSize(value: unknown): 'small' | 'medium' | undefined;
+//# sourceMappingURL=fieldPropNormalizers.d.ts.map

package/components/DynamicForm/helpers/resolveFieldComponent/strategies/checkableListStrategy/helpers/fieldPropsNormalizers/fieldPropNormalizers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fieldPropNormalizers.d.ts","sourceRoot":"","sources":["../../../../../../../../../../../../packages/components/src/components/DynamicForm/helpers/resolveFieldComponent/strategies/checkableListStrategy/helpers/fieldPropsNormalizers/fieldPropNormalizers.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,wBAAgB,8BAA8B,CAAC,KAAK,EAAE,OAAO,GAAG,YAAY,GAAG,eAAe,GAAG,SAAS,CAKzG;AACD;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,GAAG,QAAQ,GAAG,SAAS,CAKpF"}

package/components/DynamicForm/helpers/resolveFieldComponent/strategies/checkableListStrategy/helpers/fieldPropsNormalizers/fieldPropNormalizers.js

@@ -0,0 +1,12 @@
+function i(e) {
+  if (e === "select-all" || e === "indicate-some")
+    return e;
+}
+function n(e) {
+  if (e === "small" || e === "medium")
+    return e;
+}
+export {
+  n as normalizeCheckboxSize,
+  i as normalizeIndeterminateBehavior
+};

package/components/DynamicForm/helpers/resolveFieldComponent/strategies/checkableListStrategy/helpers/groupNormalization/groupNormalization.d.ts

@@ -0,0 +1,20 @@
+import { CheckableListGroup, CheckableListItem } from '../../../../../../../CheckableList/types';
+/**
+ * Builds a {@link CheckableListItem} from an unknown API object; drops invalid entries.
+ * @param raw - One element from `groups[].items` or similar.
+ * @returns A valid item, or `null`.
+ */
+export declare function normalizeCheckableListItem(raw: unknown): CheckableListItem | null;
+/**
+ * Builds a {@link CheckableListGroup} from an unknown API object; requires at least one valid item.
+ * @param raw - One element from `groups`.
+ * @returns A valid group, or `null`.
+ */
+export declare function normalizeCheckableListGroup(raw: unknown): CheckableListGroup | null;
+/**
+ * Normalizes the `groups` array from the API; returns `undefined` if empty or all entries invalid.
+ * @param value - Raw `groups` value.
+ * @returns Valid groups, or `undefined`.
+ */
+export declare function normalizeGroups(value: unknown): CheckableListGroup[] | undefined;
+//# sourceMappingURL=groupNormalization.d.ts.map

package/components/DynamicForm/helpers/resolveFieldComponent/strategies/checkableListStrategy/helpers/groupNormalization/groupNormalization.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"groupNormalization.d.ts","sourceRoot":"","sources":["../../../../../../../../../../../../packages/components/src/components/DynamicForm/helpers/resolveFieldComponent/strategies/checkableListStrategy/helpers/groupNormalization/groupNormalization.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,MAAM,0CAA0C,CAAC;AAWtG;;;;GAIG;AACH,wBAAgB,0BAA0B,CAAC,GAAG,EAAE,OAAO,GAAG,iBAAiB,GAAG,IAAI,CAyBjF;AAED;;;;GAIG;AACH,wBAAgB,2BAA2B,CAAC,GAAG,EAAE,OAAO,GAAG,kBAAkB,GAAG,IAAI,CA6CnF;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,GAAG,kBAAkB,EAAE,GAAG,SAAS,CAYhF"}

package/components/DynamicForm/helpers/resolveFieldComponent/strategies/checkableListStrategy/helpers/groupNormalization/groupNormalization.js

@@ -0,0 +1,49 @@
+import { coerceId as u, coerceBoolean as l, coerceFiniteNumber as m } from "../guards/guards.js";
+import { isRecord as d } from "../../../../../isRecord.js";
+const a = /^#([0-9A-Fa-f]{3}|[0-9A-Fa-f]{6})$/;
+function b(e) {
+  if (!d(e))
+    return null;
+  const o = u(e.id), n = typeof e.label == "string" ? e.label : void 0;
+  if (o === void 0 || n === void 0)
+    return null;
+  const i = { id: o, label: n }, t = l(e.disabled);
+  t !== void 0 && (i.disabled = t), typeof e.description == "string" && (i.description = e.description);
+  const s = m(e.rowHeight);
+  return s !== void 0 && (i.rowHeight = s), d(e.metadata) && (i.metadata = e.metadata), i;
+}
+function g(e) {
+  if (!d(e))
+    return null;
+  const o = u(e.id), n = typeof e.label == "string" ? e.label : void 0;
+  if (o === void 0 || n === void 0 || !Array.isArray(e.items))
+    return null;
+  const i = [];
+  for (const p of e.items) {
+    const f = b(p);
+    f && i.push(f);
+  }
+  if (i.length === 0)
+    return null;
+  const t = { id: o, label: n, items: i }, s = l(e.disabled);
+  s !== void 0 && (t.disabled = s);
+  const c = l(e.collapsed);
+  c !== void 0 && (t.collapsed = c), typeof e.description == "string" && (t.description = e.description), typeof e.color == "string" && a.test(e.color) && (t.color = e.color);
+  const r = l(e.selected);
+  return r !== void 0 && (t.selected = r), d(e.metadata) && (t.metadata = e.metadata), t;
+}
+function y(e) {
+  if (!Array.isArray(e) || e.length === 0)
+    return;
+  const o = [];
+  for (const n of e) {
+    const i = g(n);
+    i && o.push(i);
+  }
+  return o.length > 0 ? o : void 0;
+}
+export {
+  g as normalizeCheckableListGroup,
+  b as normalizeCheckableListItem,
+  y as normalizeGroups
+};

package/components/DynamicForm/helpers/resolveFieldComponent/strategies/checkableListStrategy/helpers/guards/guards.d.ts

@@ -0,0 +1,32 @@
+export { isRecord } from '../../../../../isRecord';
+/**
+ * Parses a boolean from API values: booleans or the strings `"true"` / `"false"`.
+ * @param value - Raw value from the API.
+ * @returns A boolean, or `undefined` if not coercible.
+ */
+export declare function coerceBoolean(value: unknown): boolean | undefined;
+/**
+ * Parses a finite number from a number or numeric string.
+ * @param value - Raw value from the API.
+ * @returns A finite number, or `undefined` if not coercible.
+ */
+export declare function coerceFiniteNumber(value: unknown): number | undefined;
+/**
+ * Parses an item or group id: finite number or non-empty trimmed string.
+ * @param value - Raw `id` from the API.
+ * @returns A string or number id, or `undefined` if invalid.
+ */
+export declare function coerceId(value: unknown): string | number | undefined;
+/**
+ * Returns a trimmed non-empty string, or `undefined`.
+ * @param value - Raw value from the API.
+ * @returns Trimmed string, or `undefined` if not a non-empty string.
+ */
+export declare function normalizeNonEmptyString(value: unknown): string | undefined;
+/**
+ * Accepts a finite number or a non-empty string (e.g. width or skeleton width).
+ * @param value - Raw value from the API.
+ * @returns A finite number, trimmed string, or `undefined`.
+ */
+export declare function normalizeFiniteNumberOrString(value: unknown): number | string | undefined;
+//# sourceMappingURL=guards.d.ts.map

package/components/DynamicForm/helpers/resolveFieldComponent/strategies/checkableListStrategy/helpers/guards/guards.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"guards.d.ts","sourceRoot":"","sources":["../../../../../../../../../../../../packages/components/src/components/DynamicForm/helpers/resolveFieldComponent/strategies/checkableListStrategy/helpers/guards/guards.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAC;AAEnD;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,GAAG,SAAS,CAWjE;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,CAWrE;AAED;;;;GAIG;AACH,wBAAgB,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,SAAS,CAQpE;AAED;;;;GAIG;AACH,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,CAM1E;AAED;;;;GAIG;AACH,wBAAgB,6BAA6B,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,SAAS,CAKzF"}

package/components/DynamicForm/helpers/resolveFieldComponent/strategies/checkableListStrategy/helpers/guards/guards.js

@@ -0,0 +1,39 @@
+function n(r) {
+  if (typeof r == "boolean")
+    return r;
+  if (r === "true")
+    return !0;
+  if (r === "false")
+    return !1;
+}
+function e(r) {
+  if (typeof r == "number" && Number.isFinite(r))
+    return r;
+  if (typeof r == "string" && r.trim() !== "") {
+    const i = Number(r);
+    if (Number.isFinite(i))
+      return i;
+  }
+}
+function o(r) {
+  if (typeof r == "number" && Number.isFinite(r))
+    return r;
+  if (typeof r == "string" && r.trim() !== "")
+    return r.trim();
+}
+function t(r) {
+  if (typeof r != "string")
+    return;
+  const i = r.trim();
+  return i !== "" ? i : void 0;
+}
+function f(r) {
+  return typeof r == "number" && Number.isFinite(r) ? r : t(r);
+}
+export {
+  n as coerceBoolean,
+  e as coerceFiniteNumber,
+  o as coerceId,
+  f as normalizeFiniteNumberOrString,
+  t as normalizeNonEmptyString
+};

package/components/DynamicForm/helpers/resolveFieldComponent/strategies/checkableListStrategy/helpers/whitelist/propertyNormalizers.d.ts

@@ -0,0 +1,18 @@
+import { NormalizedRHFCheckableListPropsFromBackend } from '../../../../../../types';
+import { PropertyNormalizerMap } from '../../types';
+/**
+ * Maps each allowed `rhfComponentProps` key to a normalizer reading from the backend record.
+ */
+export declare const PROPERTY_NORMALIZERS: PropertyNormalizerMap;
+/**
+ * Assigns `target[key] = value` only when `value` is not `undefined`.
+ * @param target - Output object being built.
+ * @param key - Property key on the normalized output type.
+ * @param value - Normalized value or `undefined` to skip.
+ */
+export declare function setIfDefined<K extends keyof Partial<NormalizedRHFCheckableListPropsFromBackend>>(target: Partial<NormalizedRHFCheckableListPropsFromBackend>, key: K, value: Partial<NormalizedRHFCheckableListPropsFromBackend>[K] | undefined): void;
+/**
+ * Whitelist-only normalization (no `field` / `getLabel`).
+ */
+export declare function normalizeCheckableListRhfPropsWhitelist(value: unknown): Partial<NormalizedRHFCheckableListPropsFromBackend>;
+//# sourceMappingURL=propertyNormalizers.d.ts.map

package/components/DynamicForm/helpers/resolveFieldComponent/strategies/checkableListStrategy/helpers/whitelist/propertyNormalizers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"propertyNormalizers.d.ts","sourceRoot":"","sources":["../../../../../../../../../../../../packages/components/src/components/DynamicForm/helpers/resolveFieldComponent/strategies/checkableListStrategy/helpers/whitelist/propertyNormalizers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,0CAA0C,EAAE,MAAM,yBAAyB,CAAC;AAI1F,OAAO,KAAK,EAAiB,qBAAqB,EAAE,MAAM,aAAa,CAAC;AAExE;;GAEG;AACH,eAAO,MAAM,oBAAoB,EAAE,qBAalC,CAAC;AAEF;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,CAAC,SAAS,MAAM,OAAO,CAAC,0CAA0C,CAAC,EAC9F,MAAM,EAAE,OAAO,CAAC,0CAA0C,CAAC,EAC3D,GAAG,EAAE,CAAC,EACN,KAAK,EAAE,OAAO,CAAC,0CAA0C,CAAC,CAAC,CAAC,CAAC,GAAG,SAAS,GACxE,IAAI,CAIN;AAED;;GAEG;AACH,wBAAgB,uCAAuC,CACrD,KAAK,EAAE,OAAO,GACb,OAAO,CAAC,0CAA0C,CAAC,CAmBrD"}

package/components/DynamicForm/helpers/resolveFieldComponent/strategies/checkableListStrategy/helpers/whitelist/propertyNormalizers.js

@@ -0,0 +1,39 @@
+import { coerceBoolean as o, normalizeFiniteNumberOrString as a, coerceFiniteNumber as c } from "../guards/guards.js";
+import { normalizeIndeterminateBehavior as p, normalizeCheckboxSize as h } from "../fieldPropsNormalizers/fieldPropNormalizers.js";
+import { normalizeGroups as u } from "../groupNormalization/groupNormalization.js";
+import { isRecord as f } from "../../../../../isRecord.js";
+const l = {
+  groups: (e) => u(e.groups),
+  searchable: (e) => o(e.searchable),
+  multiple: (e) => o(e.multiple),
+  selectAll: (e) => o(e.selectAll),
+  groupable: (e) => o(e.groupable),
+  expandAllGroups: (e) => o(e.expandAllGroups),
+  itemRowHeight: (e) => c(e.itemRowHeight),
+  groupRowHeight: (e) => c(e.groupRowHeight),
+  width: (e) => a(e.width),
+  checkboxSize: (e) => h(e.checkboxSize),
+  showCheckboxOnGroup: (e) => o(e.showCheckboxOnGroup),
+  indeterminateBehavior: (e) => p(e.indeterminateBehavior)
+};
+function b(e, r, i) {
+  i !== void 0 && (e[r] = i);
+}
+function k(e) {
+  if (!f(e))
+    return {};
+  const r = e, i = {}, s = Object.keys(l);
+  for (const t of s) {
+    const n = l[t];
+    if (!n)
+      continue;
+    const m = n(r);
+    b(i, t, m);
+  }
+  return i;
+}
+export {
+  l as PROPERTY_NORMALIZERS,
+  k as normalizeCheckableListRhfPropsWhitelist,
+  b as setIfDefined
+};

package/components/DynamicForm/helpers/resolveFieldComponent/strategies/checkableListStrategy/normalizeCheckableListPropsFromBackend.d.ts

@@ -0,0 +1,17 @@
+import { GetLabelType } from '@m4l/core';
+import { Field } from '../../../../types';
+import { NormalizedCheckableListPropsFromBackendResult } from './types';
+/**
+ * Reads `field.fieldType.rhfComponentProps`, keeps only values supported by `RHFCheckableList` /
+ * `CheckableList`, and resolves `resolvedLabel` via {@link resolveFieldInputLabel}, `hasGroups`,
+ * `resolvedSearchable`, and `resolvedCheckableListItems` from {@link normalizeFieldOptionsForCheckableList}
+ * (`field.options`). Unknown keys, invalid types, and non-serializable values (e.g. React nodes) are
+ * ignored. Raw `items` and `size` in `rhfComponentProps` are omitted (whitelist); flat options come only
+ * from `field.options`. Root UI keys (`variant`, `loading`, `ariaLabel`, `ariaLabelledBy`, `className`,
+ * `dataTestId`, `id`) are not accepted from the API payload.
+ * @param field - Dynamic form field (backend props come from `field.fieldType.rhfComponentProps`).
+ * @param getLabel - Dictionary label resolver for `resolveFieldInputLabel` fallback.
+ * @returns A safe subset typed as {@link NormalizedCheckableListPropsFromBackendResult}.
+ */
+export declare function normalizeCheckableListPropsFromBackend(field: Field, getLabel: GetLabelType): NormalizedCheckableListPropsFromBackendResult;
+//# sourceMappingURL=normalizeCheckableListPropsFromBackend.d.ts.map

package/components/DynamicForm/helpers/resolveFieldComponent/strategies/checkableListStrategy/normalizeCheckableListPropsFromBackend.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"normalizeCheckableListPropsFromBackend.d.ts","sourceRoot":"","sources":["../../../../../../../../../../packages/components/src/components/DynamicForm/helpers/resolveFieldComponent/strategies/checkableListStrategy/normalizeCheckableListPropsFromBackend.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AAC9C,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAC;AAC/C,OAAO,KAAK,EAAE,6CAA6C,EAAE,MAAM,SAAS,CAAC;AAK7E;;;;;;;;;;;GAWG;AACH,wBAAgB,sCAAsC,CACpD,KAAK,EAAE,KAAK,EACZ,QAAQ,EAAE,YAAY,GACrB,6CAA6C,CAoB/C"}

package/components/DynamicForm/helpers/resolveFieldComponent/strategies/checkableListStrategy/normalizeCheckableListPropsFromBackend.js

@@ -0,0 +1,16 @@
+import { normalizeCheckableListRhfPropsWhitelist as i } from "./helpers/whitelist/propertyNormalizers.js";
+import { normalizeFieldOptionsForCheckableList as c } from "./normalizeFieldOptionsForCheckableList.js";
+import { resolveFieldInputLabel as p } from "../../../resolveFieldInputLabel/resolveFieldInputLabel.js";
+function u(e, t) {
+  const l = e.fieldType.rhfComponentProps, o = i(l), s = o.groups !== void 0 && o.groups.length > 0, r = o.searchable, n = r != null ? !!r : s, a = c(e.options);
+  return {
+    ...o,
+    resolvedLabel: p(e, t),
+    hasGroups: s,
+    resolvedSearchable: n,
+    resolvedCheckableListItems: a
+  };
+}
+export {
+  u as normalizeCheckableListPropsFromBackend
+};

package/components/DynamicForm/helpers/resolveFieldComponent/strategies/checkableListStrategy/normalizeFieldOptionsForCheckableList.d.ts

@@ -0,0 +1,7 @@
+import { CheckableListItem } from '../../../../../CheckableList/types';
+/**
+ * Builds a safe `items` list for {@link RHFCheckableList} from `Field.options` (`unknown[]` at the API boundary).
+ * Used together with {@link normalizeCheckableListPropsFromBackend} when `hasGroups` is false (flat list).
+ */
+export declare function normalizeFieldOptionsForCheckableList(options: unknown): CheckableListItem[];
+//# sourceMappingURL=normalizeFieldOptionsForCheckableList.d.ts.map

package/components/DynamicForm/helpers/resolveFieldComponent/strategies/checkableListStrategy/normalizeFieldOptionsForCheckableList.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"normalizeFieldOptionsForCheckableList.d.ts","sourceRoot":"","sources":["../../../../../../../../../../packages/components/src/components/DynamicForm/helpers/resolveFieldComponent/strategies/checkableListStrategy/normalizeFieldOptionsForCheckableList.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,oCAAoC,CAAC;AAkD5E;;;GAGG;AACH,wBAAgB,qCAAqC,CAAC,OAAO,EAAE,OAAO,GAAG,iBAAiB,EAAE,CAY3F"}

package/components/DynamicForm/helpers/resolveFieldComponent/strategies/checkableListStrategy/normalizeFieldOptionsForCheckableList.js

@@ -0,0 +1,29 @@
+import { isRecord as l } from "../../../isRecord.js";
+import { coerceId as r, coerceBoolean as s } from "./helpers/guards/guards.js";
+function f(e) {
+  if (!l(e))
+    return null;
+  const o = r(e.id);
+  if (o === void 0)
+    return null;
+  let i;
+  if (typeof e.label == "string" && e.label.trim() !== "" ? i = e.label : typeof e.name == "string" && e.name.trim() !== "" ? i = e.name : typeof e.value == "string" && e.value.trim() !== "" && (i = e.value), i === void 0)
+    return null;
+  const t = { id: o, label: i };
+  typeof e.value == "string" && (t.value = e.value);
+  const n = s(e.disabled);
+  return n !== void 0 && (t.disabled = n), typeof e.description == "string" && (t.description = e.description), t;
+}
+function c(e) {
+  if (!Array.isArray(e))
+    return [];
+  const o = [];
+  for (const i of e) {
+    const t = f(i);
+    t && o.push(t);
+  }
+  return o;
+}
+export {
+  c as normalizeFieldOptionsForCheckableList
+};