@portnet/ui 5.0.27 → 6.0.0

package/dist/v2/patterns/FormSection.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"FormSection.js","names":["React","_interopRequireWildcard","require","_Box","_interopRequireDefault","_Typography","_FormGrid","_jsxRuntime","obj","__esModule","_getRequireWildcardCache","nodeInterop","WeakMap","cacheBabelInterop","cacheNodeInterop","_typeof","cache","has","get","newObj","hasPropertyDescriptor","Object","defineProperty","getOwnPropertyDescriptor","key","prototype","hasOwnProperty","call","desc","set","Symbol","iterator","constructor","ownKeys","object","enumerableOnly","keys","getOwnPropertySymbols","symbols","filter","sym","enumerable","push","apply","_objectSpread","target","i","arguments","length","source","forEach","_defineProperty","getOwnPropertyDescriptors","defineProperties","value","_toPropertyKey","configurable","writable","arg","_toPrimitive","String","input","hint","prim","toPrimitive","undefined","res","TypeError","Number","DEFAULT_SR_LABEL","n","concat","resolveGridProps","cols","minColumnWidth","columns","FormSection","_ref","number","title","description","actions","_ref$srLabel","srLabel","_ref$headingLevel","headingLevel","_ref$cols","children","sx","HeadingTag","gridProps","jsxs","background","border","borderRadius","marginBottom","padding","borderBottom","display","alignItems","justifyContent","gap","flex","minWidth","jsx","flexShrink","width","height","color","placeItems","fontSize","fontWeight","component","lineHeight","margin","className","marginTop","_default","exports"],"sources":["../../../src/lib/v2/patterns/FormSection.tsx"],"sourcesContent":["import * as React from \"react\";\r\nimport Box from \"@mui/material/Box\";\r\nimport Typography from \"@mui/material/Typography\";\r\nimport type { SxProps, Theme } from \"@mui/material/styles\";\r\nimport type { SystemStyleObject } from \"@mui/system\";\r\nimport FormGrid from \"../components/FormGrid\";\r\n\r\n/**\r\n * FormSection - Portnet UI v2 (pattern)\r\n *\r\n * Charter R-3.1 — groups form fields into named, numbered sections.\r\n * Charter R-3.2 — 3-column grid is the standard for form sections.\r\n *\r\n * cols (default 3):\r\n *   3       — three equal columns (DEFAULT — standard form layout)\r\n *   2       — two equal columns (narrow forms, few fields, wide labels)\r\n *   1       — single column (textareas, file uploads, notes)\r\n *   \"auto\"  — auto-fill tracks min 220px\r\n *   \"none\"  — no grid wrapper — children manage their own layout.\r\n *             Use for: KVGrid, DataGrid, nested FormGrid.\r\n *\r\n * Full-width items within a 3-col section:\r\n *   <FormGrid.Full><FormikTextarea name=\"obs\" /></FormGrid.Full>\r\n *\r\n * Usage:\r\n *   // Standard form section — 3 cols (no need to specify)\r\n *   <FormSection number={1} title=\"Identification\">\r\n *     <FormikInput name=\"nom\" label=\"Nom\" />\r\n *     <FormikInput name=\"prenom\" label=\"Prénom\" />\r\n *     <FormikInput name=\"code\" label=\"Code\" />\r\n *   </FormSection>\r\n *\r\n *   // Read-only section — self-managed layout\r\n *   <FormSection title=\"Importateur\" cols=\"none\">\r\n *     <KVGrid minColumnWidth={180}>...</KVGrid>\r\n *   </FormSection>\r\n */\r\n\r\nexport interface FormSectionProps {\r\n  number?: number | string;\r\n  title: React.ReactNode;\r\n  description?: React.ReactNode;\r\n  actions?: React.ReactNode;\r\n  srLabel?: (n: number | string) => React.ReactNode;\r\n  headingLevel?: 2 | 3 | 4 | 5 | 6;\r\n  /**\r\n   * cols — Charter R-3.2 field layout.\r\n   *   3 (DEFAULT) : 3 equal columns — standard form layout.\r\n   *   2 | 1       : fewer columns for narrow/simple forms.\r\n   *   \"auto\"      : auto-fill tracks min 220px.\r\n   *   \"none\"      : no grid wrapper — children manage own layout.\r\n   */\r\n  cols?: number | \"auto\" | \"none\";\r\n  children: React.ReactNode;\r\n  sx?: SxProps<Theme>;\r\n}\r\n\r\nconst DEFAULT_SR_LABEL = (n: number | string): string => `Section ${n} : `;\r\n\r\nfunction resolveGridProps(\r\n  cols: number | \"auto\" | \"none\" | undefined\r\n): { minColumnWidth: number } | { columns: number } | null {\r\n  if (!cols || cols === \"none\") return null;\r\n  if (cols === \"auto\") return { minColumnWidth: 220 };\r\n  if (typeof cols === \"number\") return { columns: cols };\r\n  return null;\r\n}\r\n\r\nfunction FormSection({\r\n  number,\r\n  title,\r\n  description,\r\n  actions,\r\n  srLabel = DEFAULT_SR_LABEL,\r\n  headingLevel = 2,\r\n  cols = 3,\r\n  children,\r\n  sx,\r\n}: FormSectionProps) {\r\n  const HeadingTag = `h${headingLevel}` as const;\r\n  const gridProps = resolveGridProps(cols);\r\n\r\n  return (\r\n    <Box\r\n      sx={{\r\n        background: \"var(--surface)\",\r\n        border: \"1px solid var(--border)\",\r\n        borderRadius: \"var(--r-lg)\",\r\n        marginBottom: 3,\r\n        ...(sx as SystemStyleObject<Theme>),\r\n      }}\r\n    >\r\n      {/* Section header */}\r\n      <Box\r\n        sx={{\r\n          padding: \"var(--s-4) var(--s-5)\",\r\n          borderBottom: \"1px solid var(--border)\",\r\n          display: \"flex\",\r\n          alignItems: \"flex-start\",\r\n          justifyContent: \"space-between\",\r\n          gap: 2,\r\n        }}\r\n      >\r\n        <Box\r\n          sx={{\r\n            display: \"flex\",\r\n            gap: 2,\r\n            alignItems: \"flex-start\",\r\n            flex: 1,\r\n            minWidth: 0,\r\n          }}\r\n        >\r\n          {number != null && (\r\n            <Box\r\n              aria-hidden=\"true\"\r\n              sx={{\r\n                flexShrink: 0,\r\n                width: 28,\r\n                height: 28,\r\n                borderRadius: \"var(--r-full)\",\r\n                background: \"var(--accent-soft)\",\r\n                color: \"var(--accent)\",\r\n                display: \"grid\",\r\n                placeItems: \"center\",\r\n                fontSize: \"var(--text-sm)\",\r\n                fontWeight: \"var(--fw-bold)\",\r\n              }}\r\n            >\r\n              {number}\r\n            </Box>\r\n          )}\r\n          <Box sx={{ minWidth: 0 }}>\r\n            <Typography\r\n              component={HeadingTag}\r\n              sx={{\r\n                /* R-2.3 / R-AI.1 MUST — was a bare `15`, a magic font-size no\r\n                 * token can express (the type scale is 12/13/14/16/20/26).\r\n                 * The Charter's own typography table assigns --text-h3 (16px)\r\n                 * to \"Card / form group\" titles, which is exactly what a\r\n                 * FormSection header is. Fleet-wide 15→16px on section\r\n                 * headers — needs visual confirmation, but 15 could not\r\n                 * remain: it is unrepresentable in the token system. */\r\n                fontSize: \"var(--text-h3)\",\r\n                fontWeight: \"var(--fw-bold)\",\r\n                color: \"var(--fg)\",\r\n                lineHeight: \"var(--lh-snug)\",\r\n                margin: 0,\r\n              }}\r\n            >\r\n              {number != null && (\r\n                <span className=\"pui-sr-only\">{srLabel(number)}</span>\r\n              )}\r\n              {title}\r\n            </Typography>\r\n            {description && (\r\n              <Typography\r\n                sx={{\r\n                  fontSize: \"var(--text-xs)\",\r\n                  color: \"var(--fg-muted)\",\r\n                  marginTop: 0.25,\r\n                }}\r\n              >\r\n                {description}\r\n              </Typography>\r\n            )}\r\n          </Box>\r\n        </Box>\r\n        {actions}\r\n      </Box>\r\n\r\n      {/* Section body */}\r\n      <Box sx={{ padding: \"var(--s-5)\" }}>\r\n        {gridProps ? <FormGrid {...gridProps}>{children}</FormGrid> : children}\r\n      </Box>\r\n    </Box>\r\n  );\r\n}\r\n\r\nexport default FormSection;\r\n"],"mappings":"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","ignoreList":[]}

package/dist/v2/patterns/FormikCheckboxGroup.d.ts

@@ -0,0 +1,51 @@
+/**
+ * FormikCheckboxGroup — bridge between Formik state and
+ * v2.Field + v2.CheckboxGroup.
+ *
+ * The v2 CheckboxGroup uses composition slots — children must be
+ * <Checkbox> elements, each with their own checked/onChange. This
+ * bridge wraps that contract behind an ergonomic
+ * `options=[{value, label}]` prop and manages the add/remove of
+ * values in the Formik-held array.
+ *
+ * `field.value` holds an array of selected values, defaulting to []
+ * when unset.
+ *
+ * Usage:
+ *
+ *   import { FormikCheckboxGroup } from "@portnet/ui/lib/v2";
+ *
+ *   <FormikCheckboxGroup
+ *     name="departements"
+ *     label="Départements"
+ *     required
+ *     options={departements.content.map((d) => ({
+ *       value: String(d.id),
+ *       label: d.description,
+ *     }))}
+ *   />
+ *
+ * A11y (CC-6): the wrapping Field is put in `group` mode so the label names the
+ * CheckboxGroup via aria-labelledby (a native <label htmlFor> cannot name an
+ * ARIA group). CheckboxGroup renders role="group" and forwards the injected
+ * aria-labelledby / aria-describedby / aria-invalid onto that element.
+ *
+ * Charter R-Sel.4. Peer dependency: formik >= 2.x.
+ */
+import * as React from "react";
+export interface FormikCheckboxOption {
+    value: string | number;
+    label: React.ReactNode;
+}
+export interface FormikCheckboxGroupProps {
+    name: string;
+    label?: React.ReactNode;
+    required?: boolean;
+    options?: FormikCheckboxOption[];
+    hint?: React.ReactNode;
+    disabled?: boolean;
+    row?: boolean;
+}
+declare const FormikCheckboxGroup: ({ name, label, required, options, hint, disabled, row, }: FormikCheckboxGroupProps) => React.JSX.Element;
+export default FormikCheckboxGroup;
+//# sourceMappingURL=FormikCheckboxGroup.d.ts.map

package/dist/v2/patterns/FormikCheckboxGroup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FormikCheckboxGroup.d.ts","sourceRoot":"","sources":["../../../src/lib/v2/patterns/FormikCheckboxGroup.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AAEH,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAK/B,MAAM,WAAW,oBAAoB;IACnC,KAAK,EAAE,MAAM,GAAG,MAAM,CAAC;IACvB,KAAK,EAAE,KAAK,CAAC,SAAS,CAAC;CACxB;AAED,MAAM,WAAW,wBAAwB;IACvC,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IACxB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,OAAO,CAAC,EAAE,oBAAoB,EAAE,CAAC;IACjC,IAAI,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IACvB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,GAAG,CAAC,EAAE,OAAO,CAAC;CACf;AAED,QAAA,MAAM,mBAAmB,GAAI,0DAQ1B,wBAAwB,sBAwC1B,CAAC;AAEF,eAAe,mBAAmB,CAAC"}

package/dist/v2/patterns/FormikCheckboxGroup.js

@@ -0,0 +1,117 @@
+"use strict";
+
+function _typeof(obj) { "@babel/helpers - typeof"; return _typeof = "function" == typeof Symbol && "symbol" == typeof Symbol.iterator ? function (obj) { return typeof obj; } : function (obj) { return obj && "function" == typeof Symbol && obj.constructor === Symbol && obj !== Symbol.prototype ? "symbol" : typeof obj; }, _typeof(obj); }
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports["default"] = void 0;
+var React = _interopRequireWildcard(require("react"));
+var _formik = require("formik");
+var _Field = _interopRequireDefault(require("../components/Field"));
+var _Checkbox = require("../components/Checkbox");
+var _jsxRuntime = require("react/jsx-runtime");
+function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { "default": obj }; }
+function _getRequireWildcardCache(nodeInterop) { if (typeof WeakMap !== "function") return null; var cacheBabelInterop = new WeakMap(); var cacheNodeInterop = new WeakMap(); return (_getRequireWildcardCache = function _getRequireWildcardCache(nodeInterop) { return nodeInterop ? cacheNodeInterop : cacheBabelInterop; })(nodeInterop); }
+function _interopRequireWildcard(obj, nodeInterop) { if (!nodeInterop && obj && obj.__esModule) { return obj; } if (obj === null || _typeof(obj) !== "object" && typeof obj !== "function") { return { "default": obj }; } var cache = _getRequireWildcardCache(nodeInterop); if (cache && cache.has(obj)) { return cache.get(obj); } var newObj = {}; var hasPropertyDescriptor = Object.defineProperty && Object.getOwnPropertyDescriptor; for (var key in obj) { if (key !== "default" && Object.prototype.hasOwnProperty.call(obj, key)) { var desc = hasPropertyDescriptor ? Object.getOwnPropertyDescriptor(obj, key) : null; if (desc && (desc.get || desc.set)) { Object.defineProperty(newObj, key, desc); } else { newObj[key] = obj[key]; } } } newObj["default"] = obj; if (cache) { cache.set(obj, newObj); } return newObj; }
+function ownKeys(object, enumerableOnly) { var keys = Object.keys(object); if (Object.getOwnPropertySymbols) { var symbols = Object.getOwnPropertySymbols(object); enumerableOnly && (symbols = symbols.filter(function (sym) { return Object.getOwnPropertyDescriptor(object, sym).enumerable; })), keys.push.apply(keys, symbols); } return keys; }
+function _objectSpread(target) { for (var i = 1; i < arguments.length; i++) { var source = null != arguments[i] ? arguments[i] : {}; i % 2 ? ownKeys(Object(source), !0).forEach(function (key) { _defineProperty(target, key, source[key]); }) : Object.getOwnPropertyDescriptors ? Object.defineProperties(target, Object.getOwnPropertyDescriptors(source)) : ownKeys(Object(source)).forEach(function (key) { Object.defineProperty(target, key, Object.getOwnPropertyDescriptor(source, key)); }); } return target; }
+function _defineProperty(obj, key, value) { key = _toPropertyKey(key); if (key in obj) { Object.defineProperty(obj, key, { value: value, enumerable: true, configurable: true, writable: true }); } else { obj[key] = value; } return obj; }
+function _toPropertyKey(arg) { var key = _toPrimitive(arg, "string"); return _typeof(key) === "symbol" ? key : String(key); }
+function _toPrimitive(input, hint) { if (_typeof(input) !== "object" || input === null) return input; var prim = input[Symbol.toPrimitive]; if (prim !== undefined) { var res = prim.call(input, hint || "default"); if (_typeof(res) !== "object") return res; throw new TypeError("@@toPrimitive must return a primitive value."); } return (hint === "string" ? String : Number)(input); }
+function _toConsumableArray(arr) { return _arrayWithoutHoles(arr) || _iterableToArray(arr) || _unsupportedIterableToArray(arr) || _nonIterableSpread(); }
+function _nonIterableSpread() { throw new TypeError("Invalid attempt to spread non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method."); }
+function _iterableToArray(iter) { if (typeof Symbol !== "undefined" && iter[Symbol.iterator] != null || iter["@@iterator"] != null) return Array.from(iter); }
+function _arrayWithoutHoles(arr) { if (Array.isArray(arr)) return _arrayLikeToArray(arr); }
+function _slicedToArray(arr, i) { return _arrayWithHoles(arr) || _iterableToArrayLimit(arr, i) || _unsupportedIterableToArray(arr, i) || _nonIterableRest(); }
+function _nonIterableRest() { throw new TypeError("Invalid attempt to destructure non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method."); }
+function _unsupportedIterableToArray(o, minLen) { if (!o) return; if (typeof o === "string") return _arrayLikeToArray(o, minLen); var n = Object.prototype.toString.call(o).slice(8, -1); if (n === "Object" && o.constructor) n = o.constructor.name; if (n === "Map" || n === "Set") return Array.from(o); if (n === "Arguments" || /^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(n)) return _arrayLikeToArray(o, minLen); }
+function _arrayLikeToArray(arr, len) { if (len == null || len > arr.length) len = arr.length; for (var i = 0, arr2 = new Array(len); i < len; i++) { arr2[i] = arr[i]; } return arr2; }
+function _iterableToArrayLimit(arr, i) { var _i = null == arr ? null : "undefined" != typeof Symbol && arr[Symbol.iterator] || arr["@@iterator"]; if (null != _i) { var _s, _e, _x, _r, _arr = [], _n = !0, _d = !1; try { if (_x = (_i = _i.call(arr)).next, 0 === i) { if (Object(_i) !== _i) return; _n = !1; } else for (; !(_n = (_s = _x.call(_i)).done) && (_arr.push(_s.value), _arr.length !== i); _n = !0) { ; } } catch (err) { _d = !0, _e = err; } finally { try { if (!_n && null != _i["return"] && (_r = _i["return"](), Object(_r) !== _r)) return; } finally { if (_d) throw _e; } } return _arr; } }
+function _arrayWithHoles(arr) { if (Array.isArray(arr)) return arr; } /**
+ * FormikCheckboxGroup — bridge between Formik state and
+ * v2.Field + v2.CheckboxGroup.
+ *
+ * The v2 CheckboxGroup uses composition slots — children must be
+ * <Checkbox> elements, each with their own checked/onChange. This
+ * bridge wraps that contract behind an ergonomic
+ * `options=[{value, label}]` prop and manages the add/remove of
+ * values in the Formik-held array.
+ *
+ * `field.value` holds an array of selected values, defaulting to []
+ * when unset.
+ *
+ * Usage:
+ *
+ *   import { FormikCheckboxGroup } from "@portnet/ui/lib/v2";
+ *
+ *   <FormikCheckboxGroup
+ *     name="departements"
+ *     label="Départements"
+ *     required
+ *     options={departements.content.map((d) => ({
+ *       value: String(d.id),
+ *       label: d.description,
+ *     }))}
+ *   />
+ *
+ * A11y (CC-6): the wrapping Field is put in `group` mode so the label names the
+ * CheckboxGroup via aria-labelledby (a native <label htmlFor> cannot name an
+ * ARIA group). CheckboxGroup renders role="group" and forwards the injected
+ * aria-labelledby / aria-describedby / aria-invalid onto that element.
+ *
+ * Charter R-Sel.4. Peer dependency: formik >= 2.x.
+ */
+var FormikCheckboxGroup = function FormikCheckboxGroup(_ref) {
+  var name = _ref.name,
+    label = _ref.label,
+    required = _ref.required,
+    _ref$options = _ref.options,
+    options = _ref$options === void 0 ? [] : _ref$options,
+    hint = _ref.hint,
+    disabled = _ref.disabled,
+    _ref$row = _ref.row,
+    row = _ref$row === void 0 ? false : _ref$row;
+  var _useField = (0, _formik.useField)(name),
+    _useField2 = _slicedToArray(_useField, 2),
+    field = _useField2[0],
+    meta = _useField2[1];
+  var _useFormikContext = (0, _formik.useFormikContext)(),
+    setFieldValue = _useFormikContext.setFieldValue,
+    setFieldTouched = _useFormikContext.setFieldTouched;
+  var hasError = Boolean(meta.touched && meta.error);
+  var selected = Array.isArray(field.value) ? field.value : [];
+  var toggle = function toggle(optValue) {
+    return function (event) {
+      var checked = event.target.checked;
+      var next = checked ? [].concat(_toConsumableArray(selected), [optValue]) : selected.filter(function (v) {
+        return v !== optValue;
+      });
+      setFieldValue(name, next);
+      setFieldTouched(name, true, false);
+    };
+  };
+  return /*#__PURE__*/(0, _jsxRuntime.jsx)(_Field["default"], _objectSpread(_objectSpread(_objectSpread({
+    label: label,
+    error: hasError ? meta.error : null,
+    hint: !hasError ? hint : undefined,
+    group: true
+  }, required !== undefined ? {
+    required: required
+  } : {}), disabled !== undefined ? {
+    disabled: disabled
+  } : {}), {}, {
+    children: /*#__PURE__*/(0, _jsxRuntime.jsx)(_Checkbox.CheckboxGroup, {
+      row: row,
+      children: options.map(function (opt) {
+        return /*#__PURE__*/(0, _jsxRuntime.jsx)(_Checkbox.Checkbox, {
+          label: opt.label,
+          checked: selected.includes(opt.value),
+          onChange: toggle(opt.value),
+          disabled: disabled
+        }, opt.value);
+      })
+    })
+  }));
+};
+var _default = exports["default"] = FormikCheckboxGroup;
+//# sourceMappingURL=FormikCheckboxGroup.js.map

package/dist/v2/patterns/FormikCheckboxGroup.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"FormikCheckboxGroup.js","names":["React","_interopRequireWildcard","require","_formik","_Field","_interopRequireDefault","_Checkbox","_jsxRuntime","obj","__esModule","_getRequireWildcardCache","nodeInterop","WeakMap","cacheBabelInterop","cacheNodeInterop","_typeof","cache","has","get","newObj","hasPropertyDescriptor","Object","defineProperty","getOwnPropertyDescriptor","key","prototype","hasOwnProperty","call","desc","set","ownKeys","object","enumerableOnly","keys","getOwnPropertySymbols","symbols","filter","sym","enumerable","push","apply","_objectSpread","target","i","arguments","length","source","forEach","_defineProperty","getOwnPropertyDescriptors","defineProperties","value","_toPropertyKey","configurable","writable","arg","_toPrimitive","String","input","hint","prim","Symbol","toPrimitive","undefined","res","TypeError","Number","_toConsumableArray","arr","_arrayWithoutHoles","_iterableToArray","_unsupportedIterableToArray","_nonIterableSpread","iter","iterator","Array","from","isArray","_arrayLikeToArray","_slicedToArray","_arrayWithHoles","_iterableToArrayLimit","_nonIterableRest","o","minLen","n","toString","slice","constructor","name","test","len","arr2","_i","_s","_e","_x","_r","_arr","_n","_d","next","done","err","FormikCheckboxGroup","_ref","label","required","_ref$options","options","disabled","_ref$row","row","_useField","useField","_useField2","field","meta","_useFormikContext","useFormikContext","setFieldValue","setFieldTouched","hasError","Boolean","touched","error","selected","toggle","optValue","event","checked","concat","v","jsx","group","children","CheckboxGroup","map","opt","Checkbox","includes","onChange","_default","exports"],"sources":["../../../src/lib/v2/patterns/FormikCheckboxGroup.tsx"],"sourcesContent":["/**\r\n * FormikCheckboxGroup — bridge between Formik state and\r\n * v2.Field + v2.CheckboxGroup.\r\n *\r\n * The v2 CheckboxGroup uses composition slots — children must be\r\n * <Checkbox> elements, each with their own checked/onChange. This\r\n * bridge wraps that contract behind an ergonomic\r\n * `options=[{value, label}]` prop and manages the add/remove of\r\n * values in the Formik-held array.\r\n *\r\n * `field.value` holds an array of selected values, defaulting to []\r\n * when unset.\r\n *\r\n * Usage:\r\n *\r\n *   import { FormikCheckboxGroup } from \"@portnet/ui/lib/v2\";\r\n *\r\n *   <FormikCheckboxGroup\r\n *     name=\"departements\"\r\n *     label=\"Départements\"\r\n *     required\r\n *     options={departements.content.map((d) => ({\r\n *       value: String(d.id),\r\n *       label: d.description,\r\n *     }))}\r\n *   />\r\n *\r\n * A11y (CC-6): the wrapping Field is put in `group` mode so the label names the\r\n * CheckboxGroup via aria-labelledby (a native <label htmlFor> cannot name an\r\n * ARIA group). CheckboxGroup renders role=\"group\" and forwards the injected\r\n * aria-labelledby / aria-describedby / aria-invalid onto that element.\r\n *\r\n * Charter R-Sel.4. Peer dependency: formik >= 2.x.\r\n */\r\n\r\nimport * as React from \"react\";\r\nimport { useField, useFormikContext } from \"formik\";\r\nimport Field from \"../components/Field\";\r\nimport { Checkbox, CheckboxGroup } from \"../components/Checkbox\";\r\n\r\nexport interface FormikCheckboxOption {\r\n  value: string | number;\r\n  label: React.ReactNode;\r\n}\r\n\r\nexport interface FormikCheckboxGroupProps {\r\n  name: string;\r\n  label?: React.ReactNode;\r\n  required?: boolean;\r\n  options?: FormikCheckboxOption[];\r\n  hint?: React.ReactNode;\r\n  disabled?: boolean;\r\n  row?: boolean;\r\n}\r\n\r\nconst FormikCheckboxGroup = ({\r\n  name,\r\n  label,\r\n  required,\r\n  options = [],\r\n  hint,\r\n  disabled,\r\n  row = false,\r\n}: FormikCheckboxGroupProps) => {\r\n  const [field, meta] = useField<Array<string | number>>(name);\r\n  const { setFieldValue, setFieldTouched } = useFormikContext();\r\n  const hasError = Boolean(meta.touched && meta.error);\r\n\r\n  const selected = Array.isArray(field.value) ? field.value : [];\r\n\r\n  const toggle =\r\n    (optValue: string | number) =>\r\n    (event: React.ChangeEvent<HTMLInputElement>) => {\r\n      const checked = event.target.checked;\r\n      const next = checked\r\n        ? [...selected, optValue]\r\n        : selected.filter((v) => v !== optValue);\r\n      setFieldValue(name, next);\r\n      setFieldTouched(name, true, false);\r\n    };\r\n\r\n  return (\r\n    <Field\r\n      label={label}\r\n      error={hasError ? meta.error : null}\r\n      hint={!hasError ? hint : undefined}\r\n      group\r\n      {...(required !== undefined ? { required } : {})}\r\n      {...(disabled !== undefined ? { disabled } : {})}\r\n    >\r\n      <CheckboxGroup row={row}>\r\n        {options.map((opt) => (\r\n          <Checkbox\r\n            key={opt.value}\r\n            label={opt.label}\r\n            checked={selected.includes(opt.value)}\r\n            onChange={toggle(opt.value)}\r\n            disabled={disabled}\r\n          />\r\n        ))}\r\n      </CheckboxGroup>\r\n    </Field>\r\n  );\r\n};\r\n\r\nexport default FormikCheckboxGroup;\r\n"],"mappings":"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","ignoreList":[]}

package/dist/v2/patterns/FormikCombobox.d.ts

@@ -0,0 +1,43 @@
+/**
+ * FormikCombobox — bridge between Formik state and v2.Field +
+ * v2.Combobox.
+ *
+ * Maps caller-supplied raw options to v2.Combobox's {value, label,
+ * helper} shape and exposes onSelectionChange(rawOption) for
+ * consumers that need cross-field side effects on pick.
+ *
+ * Charter R-Sel.1 → R-Sel.4. Peer dependency: formik >= 2.x.
+ *
+ * Hardening notes:
+ *   - B7: defensive String() cast on the resolved label so a
+ *     consumer-supplied getOptionLabel that returns a React node
+ *     never crashes Autocomplete with the cryptic "Objects are
+ *     not valid as a React child" error.
+ *   - B10: `descriptionField` alias mirrors the legacy
+ *     AppFormikSelect API — surfaces option[descriptionField] as
+ *     the helper line under each Combobox row.
+ */
+import type { ReactNode } from "react";
+import type { ComboboxProps, ComboboxOptionValue } from "../components/Combobox";
+export interface FormikComboboxProps<TOption = unknown> extends Omit<ComboboxProps, "value" | "onChange" | "options" | "loading" | "disabled" | "getOptionLabel"> {
+    name: string;
+    label?: ReactNode;
+    required?: boolean;
+    options?: readonly TOption[];
+    loading?: boolean;
+    disabled?: boolean;
+    htmlFor?: string;
+    hint?: ReactNode;
+    getOptionLabel?: (opt: TOption) => ReactNode;
+    getOptionValue?: (opt: TOption) => ComboboxOptionValue;
+    /**
+     * Key on each raw option whose value should appear as a helper
+     * line beneath the main label in the dropdown. Equivalent to
+     * the legacy `descriptionField` prop on AppFormikSelect.
+     */
+    descriptionField?: string;
+    onSelectionChange?: (raw: TOption | null) => void;
+}
+declare function FormikCombobox<TOption = unknown>({ name, label, required, options, loading, disabled, htmlFor, hint, getOptionLabel, getOptionValue, descriptionField, onSelectionChange, ...rest }: FormikComboboxProps<TOption>): import("react").JSX.Element;
+export default FormikCombobox;
+//# sourceMappingURL=FormikCombobox.d.ts.map

package/dist/v2/patterns/FormikCombobox.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FormikCombobox.d.ts","sourceRoot":"","sources":["../../../src/lib/v2/patterns/FormikCombobox.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAIvC,OAAO,KAAK,EACV,aAAa,EAEb,mBAAmB,EAEpB,MAAM,wBAAwB,CAAC;AAEhC,MAAM,WAAW,mBAAmB,CAAC,OAAO,GAAG,OAAO,CACpD,SAAQ,IAAI,CACV,aAAa,EACb,OAAO,GAAG,UAAU,GAAG,SAAS,GAAG,SAAS,GAAG,UAAU,GAAG,gBAAgB,CAC7E;IACD,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,SAAS,CAAC;IAClB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,OAAO,CAAC,EAAE,SAAS,OAAO,EAAE,CAAC;IAC7B,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,SAAS,CAAC;IACjB,cAAc,CAAC,EAAE,CAAC,GAAG,EAAE,OAAO,KAAK,SAAS,CAAC;IAC7C,cAAc,CAAC,EAAE,CAAC,GAAG,EAAE,OAAO,KAAK,mBAAmB,CAAC;IACvD;;;;OAIG;IACH,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,iBAAiB,CAAC,EAAE,CAAC,GAAG,EAAE,OAAO,GAAG,IAAI,KAAK,IAAI,CAAC;CACnD;AAED,iBAAS,cAAc,CAAC,OAAO,GAAG,OAAO,EAAE,EACzC,IAAI,EACJ,KAAK,EACL,QAAQ,EACR,OAAY,EACZ,OAAO,EACP,QAAQ,EACR,OAAO,EACP,IAAI,EACJ,cAAc,EACd,cAAc,EACd,gBAAgB,EAChB,iBAAiB,EACjB,GAAG,IAAI,EACR,EAAE,mBAAmB,CAAC,OAAO,CAAC,+BAkE9B;AAED,eAAe,cAAc,CAAC"}

package/dist/v2/patterns/FormikCombobox.js

@@ -0,0 +1,121 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports["default"] = void 0;
+var _formik = require("formik");
+var _Field = _interopRequireDefault(require("../components/Field"));
+var _Combobox = _interopRequireDefault(require("../components/Combobox"));
+var _jsxRuntime = require("react/jsx-runtime");
+var _excluded = ["name", "label", "required", "options", "loading", "disabled", "htmlFor", "hint", "getOptionLabel", "getOptionValue", "descriptionField", "onSelectionChange"];
+/**
+ * FormikCombobox — bridge between Formik state and v2.Field +
+ * v2.Combobox.
+ *
+ * Maps caller-supplied raw options to v2.Combobox's {value, label,
+ * helper} shape and exposes onSelectionChange(rawOption) for
+ * consumers that need cross-field side effects on pick.
+ *
+ * Charter R-Sel.1 → R-Sel.4. Peer dependency: formik >= 2.x.
+ *
+ * Hardening notes:
+ *   - B7: defensive String() cast on the resolved label so a
+ *     consumer-supplied getOptionLabel that returns a React node
+ *     never crashes Autocomplete with the cryptic "Objects are
+ *     not valid as a React child" error.
+ *   - B10: `descriptionField` alias mirrors the legacy
+ *     AppFormikSelect API — surfaces option[descriptionField] as
+ *     the helper line under each Combobox row.
+ */
+function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { "default": obj }; }
+function ownKeys(object, enumerableOnly) { var keys = Object.keys(object); if (Object.getOwnPropertySymbols) { var symbols = Object.getOwnPropertySymbols(object); enumerableOnly && (symbols = symbols.filter(function (sym) { return Object.getOwnPropertyDescriptor(object, sym).enumerable; })), keys.push.apply(keys, symbols); } return keys; }
+function _objectSpread(target) { for (var i = 1; i < arguments.length; i++) { var source = null != arguments[i] ? arguments[i] : {}; i % 2 ? ownKeys(Object(source), !0).forEach(function (key) { _defineProperty(target, key, source[key]); }) : Object.getOwnPropertyDescriptors ? Object.defineProperties(target, Object.getOwnPropertyDescriptors(source)) : ownKeys(Object(source)).forEach(function (key) { Object.defineProperty(target, key, Object.getOwnPropertyDescriptor(source, key)); }); } return target; }
+function _defineProperty(obj, key, value) { key = _toPropertyKey(key); if (key in obj) { Object.defineProperty(obj, key, { value: value, enumerable: true, configurable: true, writable: true }); } else { obj[key] = value; } return obj; }
+function _toPropertyKey(arg) { var key = _toPrimitive(arg, "string"); return _typeof(key) === "symbol" ? key : String(key); }
+function _toPrimitive(input, hint) { if (_typeof(input) !== "object" || input === null) return input; var prim = input[Symbol.toPrimitive]; if (prim !== undefined) { var res = prim.call(input, hint || "default"); if (_typeof(res) !== "object") return res; throw new TypeError("@@toPrimitive must return a primitive value."); } return (hint === "string" ? String : Number)(input); }
+function _typeof(obj) { "@babel/helpers - typeof"; return _typeof = "function" == typeof Symbol && "symbol" == typeof Symbol.iterator ? function (obj) { return typeof obj; } : function (obj) { return obj && "function" == typeof Symbol && obj.constructor === Symbol && obj !== Symbol.prototype ? "symbol" : typeof obj; }, _typeof(obj); }
+function _slicedToArray(arr, i) { return _arrayWithHoles(arr) || _iterableToArrayLimit(arr, i) || _unsupportedIterableToArray(arr, i) || _nonIterableRest(); }
+function _nonIterableRest() { throw new TypeError("Invalid attempt to destructure non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method."); }
+function _unsupportedIterableToArray(o, minLen) { if (!o) return; if (typeof o === "string") return _arrayLikeToArray(o, minLen); var n = Object.prototype.toString.call(o).slice(8, -1); if (n === "Object" && o.constructor) n = o.constructor.name; if (n === "Map" || n === "Set") return Array.from(o); if (n === "Arguments" || /^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(n)) return _arrayLikeToArray(o, minLen); }
+function _arrayLikeToArray(arr, len) { if (len == null || len > arr.length) len = arr.length; for (var i = 0, arr2 = new Array(len); i < len; i++) { arr2[i] = arr[i]; } return arr2; }
+function _iterableToArrayLimit(arr, i) { var _i = null == arr ? null : "undefined" != typeof Symbol && arr[Symbol.iterator] || arr["@@iterator"]; if (null != _i) { var _s, _e, _x, _r, _arr = [], _n = !0, _d = !1; try { if (_x = (_i = _i.call(arr)).next, 0 === i) { if (Object(_i) !== _i) return; _n = !1; } else for (; !(_n = (_s = _x.call(_i)).done) && (_arr.push(_s.value), _arr.length !== i); _n = !0) { ; } } catch (err) { _d = !0, _e = err; } finally { try { if (!_n && null != _i["return"] && (_r = _i["return"](), Object(_r) !== _r)) return; } finally { if (_d) throw _e; } } return _arr; } }
+function _arrayWithHoles(arr) { if (Array.isArray(arr)) return arr; }
+function _objectWithoutProperties(source, excluded) { if (source == null) return {}; var target = _objectWithoutPropertiesLoose(source, excluded); var key, i; if (Object.getOwnPropertySymbols) { var sourceSymbolKeys = Object.getOwnPropertySymbols(source); for (i = 0; i < sourceSymbolKeys.length; i++) { key = sourceSymbolKeys[i]; if (excluded.indexOf(key) >= 0) continue; if (!Object.prototype.propertyIsEnumerable.call(source, key)) continue; target[key] = source[key]; } } return target; }
+function _objectWithoutPropertiesLoose(source, excluded) { if (source == null) return {}; var target = {}; var sourceKeys = Object.keys(source); var key, i; for (i = 0; i < sourceKeys.length; i++) { key = sourceKeys[i]; if (excluded.indexOf(key) >= 0) continue; target[key] = source[key]; } return target; }
+function FormikCombobox(_ref) {
+  var _field$value;
+  var name = _ref.name,
+    label = _ref.label,
+    required = _ref.required,
+    _ref$options = _ref.options,
+    options = _ref$options === void 0 ? [] : _ref$options,
+    loading = _ref.loading,
+    disabled = _ref.disabled,
+    htmlFor = _ref.htmlFor,
+    hint = _ref.hint,
+    getOptionLabel = _ref.getOptionLabel,
+    getOptionValue = _ref.getOptionValue,
+    descriptionField = _ref.descriptionField,
+    onSelectionChange = _ref.onSelectionChange,
+    rest = _objectWithoutProperties(_ref, _excluded);
+  var _useField = (0, _formik.useField)(name),
+    _useField2 = _slicedToArray(_useField, 2),
+    field = _useField2[0],
+    meta = _useField2[1];
+  var _useFormikContext = (0, _formik.useFormikContext)(),
+    setFieldValue = _useFormikContext.setFieldValue,
+    setFieldTouched = _useFormikContext.setFieldTouched;
+  var hasError = Boolean(meta.touched && meta.error);
+  var v2Options = options.map(function (opt) {
+    var _ref2, _ref3;
+    if (opt == null || _typeof(opt) !== "object") return opt;
+    var rec = opt;
+    var rawLabel = typeof getOptionLabel === "function" ? getOptionLabel(opt) : rec["label"];
+    // B7: harden against getOptionLabel returning a React node.
+    // v2.Combobox feeds the label back through its internal
+    // labelOf when computing the displayed value, and that path
+    // assumes string. Always coerce defensively.
+    var safeLabel = typeof rawLabel === "string" || rawLabel == null ? rawLabel : String(rawLabel);
+    // B10: descriptionField alias → helper. Falls back to the
+    // canonical `helper`/`summary` fields if neither is set.
+    var helper = (_ref2 = (_ref3 = descriptionField && rec[descriptionField]) !== null && _ref3 !== void 0 ? _ref3 : rec["helper"]) !== null && _ref2 !== void 0 ? _ref2 : rec["summary"];
+    return {
+      value: typeof getOptionValue === "function" ? getOptionValue(opt) : opt,
+      label: safeLabel,
+      helper: helper,
+      __raw: opt
+    };
+  });
+  var handleChange = function handleChange(next) {
+    setFieldValue(name, next);
+    setFieldTouched(name, true, false);
+    if (typeof onSelectionChange === "function") {
+      var _raw, _v2Options$find;
+      var picked = (_raw = (_v2Options$find = v2Options.find(function (o) {
+        return o != null && _typeof(o) === "object" && "value" in o && o.value === next;
+      })) === null || _v2Options$find === void 0 ? void 0 : _v2Options$find.__raw) !== null && _raw !== void 0 ? _raw : null;
+      onSelectionChange(picked);
+    }
+  };
+  return /*#__PURE__*/(0, _jsxRuntime.jsx)(_Field["default"], _objectSpread(_objectSpread(_objectSpread({
+    label: label,
+    error: hasError ? meta.error : null,
+    hint: !hasError ? hint : undefined,
+    htmlFor: htmlFor || name
+  }, required !== undefined ? {
+    required: required
+  } : {}), disabled !== undefined ? {
+    disabled: disabled
+  } : {}), {}, {
+    children: /*#__PURE__*/(0, _jsxRuntime.jsx)(_Combobox["default"], _objectSpread(_objectSpread({
+      value: (_field$value = field.value) !== null && _field$value !== void 0 ? _field$value : null,
+      options: v2Options,
+      onChange: handleChange
+    }, rest), loading !== undefined ? {
+      loading: loading
+    } : {}))
+  }));
+}
+var _default = exports["default"] = FormikCombobox;
+//# sourceMappingURL=FormikCombobox.js.map

package/dist/v2/patterns/FormikCombobox.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"FormikCombobox.js","names":["_formik","require","_Field","_interopRequireDefault","_Combobox","_jsxRuntime","_excluded","obj","__esModule","ownKeys","object","enumerableOnly","keys","Object","getOwnPropertySymbols","symbols","filter","sym","getOwnPropertyDescriptor","enumerable","push","apply","_objectSpread","target","i","arguments","length","source","forEach","key","_defineProperty","getOwnPropertyDescriptors","defineProperties","defineProperty","value","_toPropertyKey","configurable","writable","arg","_toPrimitive","_typeof","String","input","hint","prim","Symbol","toPrimitive","undefined","res","call","TypeError","Number","iterator","constructor","prototype","_slicedToArray","arr","_arrayWithHoles","_iterableToArrayLimit","_unsupportedIterableToArray","_nonIterableRest","o","minLen","_arrayLikeToArray","n","toString","slice","name","Array","from","test","len","arr2","_i","_s","_e","_x","_r","_arr","_n","_d","next","done","err","isArray","_objectWithoutProperties","excluded","_objectWithoutPropertiesLoose","sourceSymbolKeys","indexOf","propertyIsEnumerable","sourceKeys","FormikCombobox","_ref","_field$value","label","required","_ref$options","options","loading","disabled","htmlFor","getOptionLabel","getOptionValue","descriptionField","onSelectionChange","rest","_useField","useField","_useField2","field","meta","_useFormikContext","useFormikContext","setFieldValue","setFieldTouched","hasError","Boolean","touched","error","v2Options","map","opt","_ref2","_ref3","rec","rawLabel","safeLabel","helper","__raw","handleChange","_raw","_v2Options$find","picked","find","jsx","children","onChange","_default","exports"],"sources":["../../../src/lib/v2/patterns/FormikCombobox.tsx"],"sourcesContent":["/**\r\n * FormikCombobox — bridge between Formik state and v2.Field +\r\n * v2.Combobox.\r\n *\r\n * Maps caller-supplied raw options to v2.Combobox's {value, label,\r\n * helper} shape and exposes onSelectionChange(rawOption) for\r\n * consumers that need cross-field side effects on pick.\r\n *\r\n * Charter R-Sel.1 → R-Sel.4. Peer dependency: formik >= 2.x.\r\n *\r\n * Hardening notes:\r\n *   - B7: defensive String() cast on the resolved label so a\r\n *     consumer-supplied getOptionLabel that returns a React node\r\n *     never crashes Autocomplete with the cryptic \"Objects are\r\n *     not valid as a React child\" error.\r\n *   - B10: `descriptionField` alias mirrors the legacy\r\n *     AppFormikSelect API — surfaces option[descriptionField] as\r\n *     the helper line under each Combobox row.\r\n */\r\n\r\nimport type { ReactNode } from \"react\";\r\nimport { useField, useFormikContext } from \"formik\";\r\nimport Field from \"../components/Field\";\r\nimport Combobox from \"../components/Combobox\";\r\nimport type {\r\n  ComboboxProps,\r\n  ComboboxOption,\r\n  ComboboxOptionValue,\r\n  ComboboxValue,\r\n} from \"../components/Combobox\";\r\n\r\nexport interface FormikComboboxProps<TOption = unknown>\r\n  extends Omit<\r\n    ComboboxProps,\r\n    \"value\" | \"onChange\" | \"options\" | \"loading\" | \"disabled\" | \"getOptionLabel\"\r\n  > {\r\n  name: string;\r\n  label?: ReactNode;\r\n  required?: boolean;\r\n  options?: readonly TOption[];\r\n  loading?: boolean;\r\n  disabled?: boolean;\r\n  htmlFor?: string;\r\n  hint?: ReactNode;\r\n  getOptionLabel?: (opt: TOption) => ReactNode;\r\n  getOptionValue?: (opt: TOption) => ComboboxOptionValue;\r\n  /**\r\n   * Key on each raw option whose value should appear as a helper\r\n   * line beneath the main label in the dropdown. Equivalent to\r\n   * the legacy `descriptionField` prop on AppFormikSelect.\r\n   */\r\n  descriptionField?: string;\r\n  onSelectionChange?: (raw: TOption | null) => void;\r\n}\r\n\r\nfunction FormikCombobox<TOption = unknown>({\r\n  name,\r\n  label,\r\n  required,\r\n  options = [],\r\n  loading,\r\n  disabled,\r\n  htmlFor,\r\n  hint,\r\n  getOptionLabel,\r\n  getOptionValue,\r\n  descriptionField,\r\n  onSelectionChange,\r\n  ...rest\r\n}: FormikComboboxProps<TOption>) {\r\n  const [field, meta] = useField(name);\r\n  const { setFieldValue, setFieldTouched } = useFormikContext();\r\n  const hasError = Boolean(meta.touched && meta.error);\r\n\r\n  const v2Options = options.map((opt) => {\r\n    if (opt == null || typeof opt !== \"object\") return opt;\r\n    const rec = opt as Record<string, unknown>;\r\n    const rawLabel =\r\n      typeof getOptionLabel === \"function\" ? getOptionLabel(opt) : rec[\"label\"];\r\n    // B7: harden against getOptionLabel returning a React node.\r\n    // v2.Combobox feeds the label back through its internal\r\n    // labelOf when computing the displayed value, and that path\r\n    // assumes string. Always coerce defensively.\r\n    const safeLabel =\r\n      typeof rawLabel === \"string\" || rawLabel == null\r\n        ? rawLabel\r\n        : String(rawLabel);\r\n    // B10: descriptionField alias → helper. Falls back to the\r\n    // canonical `helper`/`summary` fields if neither is set.\r\n    const helper =\r\n      ((descriptionField && rec[descriptionField]) ?? rec[\"helper\"] ?? rec[\"summary\"]) as ReactNode;\r\n    return {\r\n      value:  typeof getOptionValue === \"function\" ? getOptionValue(opt) : opt,\r\n      label:  safeLabel,\r\n      helper,\r\n      __raw:  opt,\r\n    };\r\n  });\r\n\r\n  const handleChange = (next: ComboboxValue): void => {\r\n    setFieldValue(name, next);\r\n    setFieldTouched(name, true, false);\r\n    if (typeof onSelectionChange === \"function\") {\r\n      const picked =\r\n        (\r\n          v2Options.find(\r\n            (o) =>\r\n              o != null &&\r\n              typeof o === \"object\" &&\r\n              \"value\" in o &&\r\n              (o as { value?: unknown }).value === next\r\n          ) as { __raw?: unknown } | undefined\r\n        )?.__raw ?? null;\r\n      onSelectionChange(picked as TOption | null);\r\n    }\r\n  };\r\n\r\n  return (\r\n    <Field\r\n      label={label}\r\n      error={hasError ? meta.error : null}\r\n      hint={!hasError ? hint : undefined}\r\n      htmlFor={htmlFor || name}\r\n      {...(required !== undefined ? { required } : {})}\r\n      {...(disabled !== undefined ? { disabled } : {})}\r\n    >\r\n      <Combobox\r\n        value={field.value ?? null}\r\n        options={v2Options as Array<string | ComboboxOption>}\r\n        onChange={handleChange}\r\n        {...rest}\r\n        {...(loading !== undefined ? { loading } : {})}\r\n      />\r\n    </Field>\r\n  );\r\n}\r\n\r\nexport default FormikCombobox;\r\n"],"mappings":"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","ignoreList":[]}

package/dist/v2/patterns/FormikDatePicker.d.ts

@@ -0,0 +1,87 @@
+/**
+ * FormikDatePicker — bridge between Formik state and v2.Field +
+ * v2.DatePicker.
+ *
+ * v2.DatePicker emits Date | null. Formik state may carry Date,
+ * ISO string, or moment instance — this bridge normalises inbound
+ * values to Date for the picker.
+ *
+ * outputFormat prop (Charter R-I.*):
+ *   By default, onChange writes a Date | null back to Formik, which
+ *   is fine for Yup.date() schemas. If your schema uses Yup.string()
+ *   with a format test (e.g. "DD-MM-YYYY"), pass the matching moment
+ *   format string:
+ *
+ *     <FormikDatePicker name="dateNaissance" outputFormat="DD-MM-YYYY" />
+ *
+ *   The field then stores "03-05-2026" instead of a Date object.
+ *   Pass outputFormat="iso" to store an ISO 8601 string instead.
+ *   Default (undefined) = Date | null (backward-compatible).
+ *
+ * ── outputFormat MUST ROUND-TRIP — and now does (S-03) ────────────────
+ *
+ * This bridge used to serialise OUT through moment but read BACK through
+ * `new Date(raw)`, ignoring outputFormat. The asymmetry silently corrupted any
+ * non-ISO format:
+ *
+ *   new Date("31-12-2026")  -> month 31 invalid -> Invalid Date -> null
+ *                              -> the field rendered EMPTY when re-populated
+ *   new Date("05-03-2026")  -> V8 reads MM-DD -> 3 May, not 5 March
+ *                              -> saving untouched wrote back "03-05-2026"
+ *
+ * The write path worked, so a form filled in and submitted immediately behaved
+ * correctly; the damage only surfaced on RE-POPULATE, i.e. an edit flow — the
+ * path a smoke test is least likely to exercise. `procuration-portnet-fe` shipped
+ * it for seven batches under a clean strict typecheck.
+ *
+ * `coerceToDate` now parses with the SAME format it was written with, in moment's
+ * STRICT mode, so a malformed stored value yields null instead of a plausible
+ * wrong date. A missing date is recoverable; a date quietly off by two months is
+ * not.
+ *
+ * BEHAVIOURAL NOTE for existing non-ISO callers: they were mis-parsing before.
+ * This changes their result from wrong to right — which is the point, but it is a
+ * change. Callers passing nothing, or "iso", are on the identical code path.
+ *
+ * Audit: this is the ONLY Formik date bridge in the library. DateTimePicker,
+ * TimePicker and DateRangePicker are exposed as bare components exchanging Date
+ * objects, so they have no serialisation step and no equivalent asymmetry;
+ * _pickerShared carries only Date<->Moment converters, not string parsing.
+ *
+ * Modal / Drawer usage (MUI X v9):
+ *   When rendered inside a v2.Drawer or a MUI Modal, the DatePicker
+ *   calendar popup may render behind the modal surface (both default
+ *   to zIndex 1300). In MUI X v9, the popper slot is forwarded via
+ *   slotProps.popper (the legacy `PopperProps` was removed). Pass:
+ *
+ *     <FormikDatePicker
+ *       slotProps={{ popper: { sx: { zIndex: 1400 } } }}
+ *     />
+ *
+ *   Slot props forward through ...rest to v2.DatePicker and on to
+ *   MuiDatePicker, where they merge with the textField slot bag
+ *   already wired by v2.DatePicker.
+ *
+ * Charter R-I.*.
+ */
+import * as React from "react";
+import type { DatePickerProps } from "../components/DatePicker";
+export interface FormikDatePickerProps extends Omit<DatePickerProps, "value" | "onChange" | "disabled" | "error" | "label"> {
+    name: string;
+    label?: React.ReactNode;
+    required?: boolean;
+    disabled?: boolean;
+    htmlFor?: string;
+    hint?: React.ReactNode;
+    /**
+     * outputFormat — when provided, the Formik field stores a formatted
+     * string instead of a Date object. Use when your Yup schema uses
+     * Yup.string() with a format-specific test (e.g. "DD-MM-YYYY").
+     * Pass "iso" for ISO 8601, or any moment format token string.
+     * Defaults to undefined (Date | null — backward-compatible).
+     */
+    outputFormat?: string;
+}
+declare const FormikDatePicker: ({ name, label, required, disabled, htmlFor, hint, outputFormat, ...rest }: FormikDatePickerProps) => React.JSX.Element;
+export default FormikDatePicker;
+//# sourceMappingURL=FormikDatePicker.d.ts.map

package/dist/v2/patterns/FormikDatePicker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FormikDatePicker.d.ts","sourceRoot":"","sources":["../../../src/lib/v2/patterns/FormikDatePicker.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiEG;AAEH,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAK/B,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAC;AAkDhE,MAAM,WAAW,qBACf,SAAQ,IAAI,CAAC,eAAe,EAAE,OAAO,GAAG,UAAU,GAAG,UAAU,GAAG,OAAO,GAAG,OAAO,CAAC;IACpF,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IACxB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IACvB;;;;;;OAMG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,QAAA,MAAM,gBAAgB,GAAI,2EASvB,qBAAqB,sBAwBvB,CAAC;AAEF,eAAe,gBAAgB,CAAC"}