@portnet/ui 6.0.0 → 6.0.2

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

@@ -0,0 +1 @@
+{"version":3,"file":"FormikCombobox.js","names":["useField","useFormikContext","Field","Combobox","jsx","_jsx","FormikCombobox","_ref","_field$value","name","label","required","_ref$options","options","loading","disabled","htmlFor","hint","getOptionLabel","getOptionValue","descriptionField","width","onSelectionChange","rest","_objectWithoutProperties","_excluded","_useField","_useField2","_slicedToArray","field","meta","_useFormikContext","setFieldValue","setFieldTouched","hasError","Boolean","touched","error","v2Options","map","opt","_ref2","_ref3","_typeof","rec","rawLabel","safeLabel","String","helper","value","__raw","handleChange","next","_raw","_v2Options$find","picked","find","o","_objectSpread","undefined","children","onChange"],"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 { FieldWidth } from \"../components/Field\";\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 | undefined;\r\n  required?: boolean | undefined;\r\n  options?: readonly TOption[] | undefined;\r\n  loading?: boolean | undefined;\r\n  disabled?: boolean | undefined;\r\n  htmlFor?: string | undefined;\r\n  hint?: ReactNode | undefined;\r\n  getOptionLabel?: ((opt: TOption) => ReactNode) | undefined;\r\n  getOptionValue?: ((opt: TOption) => ComboboxOptionValue) | undefined;\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 | undefined;\r\n  /**\r\n   * Gabarit de largeur semantique (G-H). Le standard range les « complex\r\n   * search auto-completes » en `l` : c'est le cas le plus courant ici.\r\n   */\r\n  width?: FieldWidth | undefined;\r\n  onSelectionChange?: ((raw: TOption | null) => void) | undefined;\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  width,\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      {...(width !== undefined ? { width } : {})}\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/esm/v2/patterns/FormikDatePicker.js

@@ -0,0 +1,162 @@
+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); }
+var _excluded = ["name", "label", "required", "disabled", "readOnly", "readOnlyFormat", "htmlFor", "hint", "outputFormat", "width"];
+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 _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; }
+/**
+ * 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.
+ *
+ * UPDATE (gap G-E): `FormikDateTimePicker` now exists too, and the two bridges
+ * SHARE `coerceToDate` / `serialiseDate` via `./_pickerSerialisation`. Keeping
+ * a private copy in each would have re-created the very asymmetry S-03
+ * describes, in a form even harder to spot: two bridges that look alike, that
+ * nobody compares, and that each look correct on their own.
+ *
+ * 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 moment from "moment";
+import { useField, useFormikContext } from "formik";
+import Field from "../components/Field";
+import DatePicker from "../components/DatePicker";
+import FormikDisplay from "../components/FormikDisplay";
+import { coerceToDate, serialiseDate } from "./_pickerSerialisation";
+import { jsx as _jsx } from "react/jsx-runtime";
+var FormikDatePicker = function FormikDatePicker(_ref) {
+  var name = _ref.name,
+    label = _ref.label,
+    required = _ref.required,
+    disabled = _ref.disabled,
+    readOnly = _ref.readOnly,
+    _ref$readOnlyFormat = _ref.readOnlyFormat,
+    readOnlyFormat = _ref$readOnlyFormat === void 0 ? "DD/MM/YYYY" : _ref$readOnlyFormat,
+    htmlFor = _ref.htmlFor,
+    hint = _ref.hint,
+    outputFormat = _ref.outputFormat,
+    width = _ref.width,
+    rest = _objectWithoutProperties(_ref, _excluded);
+  var _useField = useField(name),
+    _useField2 = _slicedToArray(_useField, 2),
+    field = _useField2[0],
+    meta = _useField2[1];
+  var _useFormikContext = useFormikContext(),
+    setFieldValue = _useFormikContext.setFieldValue,
+    setFieldTouched = _useFormikContext.setFieldTouched;
+  var hasError = Boolean(meta.touched && meta.error);
+
+  /* Lecture seule. On repasse par `coerceToDate` avec le MÊME `outputFormat`
+   * que le champ utilise pour écrire : c'est la symétrie que S-03 a installée,
+   * et s'en écarter ici reproduirait exactement le bug qu'il a corrigé (une date
+   * "31-12-2026" relue par `new Date()` devient Invalid Date).
+   *
+   * `format` court-circuite la branche « valeur vide » de FormikDisplay, donc le
+   * marqueur « — » est reproduit ici plutôt que délégué — sans quoi un champ
+   * sans date afficherait un panneau vide. */
+  if (readOnly && !disabled) {
+    return /*#__PURE__*/_jsx(FormikDisplay, _objectSpread(_objectSpread({
+      name: name,
+      label: label
+    }, hint !== undefined ? {
+      hint: hint
+    } : {}), {}, {
+      format: function format(raw) {
+        var parsed = coerceToDate(raw, outputFormat);
+        return parsed ? moment(parsed).format(readOnlyFormat) : "\u2014";
+      }
+    }));
+  }
+  return /*#__PURE__*/_jsx(Field, _objectSpread(_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
+  } : {}), width !== undefined ? {
+    width: width
+  } : {}), {}, {
+    children: /*#__PURE__*/_jsx(DatePicker, _objectSpread({
+      value: coerceToDate(field.value, outputFormat),
+      onChange: function onChange(next) {
+        setFieldValue(name, serialiseDate(next, outputFormat));
+        setFieldTouched(name, true, false);
+      }
+    }, rest))
+  }));
+};
+export default FormikDatePicker;
+//# sourceMappingURL=FormikDatePicker.js.map

package/dist/esm/v2/patterns/FormikDatePicker.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"FormikDatePicker.js","names":["React","moment","useField","useFormikContext","Field","DatePicker","FormikDisplay","coerceToDate","serialiseDate","jsx","_jsx","FormikDatePicker","_ref","name","label","required","disabled","readOnly","_ref$readOnlyFormat","readOnlyFormat","htmlFor","hint","outputFormat","width","rest","_objectWithoutProperties","_excluded","_useField","_useField2","_slicedToArray","field","meta","_useFormikContext","setFieldValue","setFieldTouched","hasError","Boolean","touched","error","_objectSpread","undefined","format","raw","parsed","children","value","onChange","next"],"sources":["../../../../src/lib/v2/patterns/FormikDatePicker.tsx"],"sourcesContent":["/**\r\n * FormikDatePicker — bridge between Formik state and v2.Field +\r\n * v2.DatePicker.\r\n *\r\n * v2.DatePicker emits Date | null. Formik state may carry Date,\r\n * ISO string, or moment instance — this bridge normalises inbound\r\n * values to Date for the picker.\r\n *\r\n * outputFormat prop (Charter R-I.*):\r\n *   By default, onChange writes a Date | null back to Formik, which\r\n *   is fine for Yup.date() schemas. If your schema uses Yup.string()\r\n *   with a format test (e.g. \"DD-MM-YYYY\"), pass the matching moment\r\n *   format string:\r\n *\r\n *     <FormikDatePicker name=\"dateNaissance\" outputFormat=\"DD-MM-YYYY\" />\r\n *\r\n *   The field then stores \"03-05-2026\" instead of a Date object.\r\n *   Pass outputFormat=\"iso\" to store an ISO 8601 string instead.\r\n *   Default (undefined) = Date | null (backward-compatible).\r\n *\r\n * ── outputFormat MUST ROUND-TRIP — and now does (S-03) ────────────────\r\n *\r\n * This bridge used to serialise OUT through moment but read BACK through\r\n * `new Date(raw)`, ignoring outputFormat. The asymmetry silently corrupted any\r\n * non-ISO format:\r\n *\r\n *   new Date(\"31-12-2026\")  -> month 31 invalid -> Invalid Date -> null\r\n *                              -> the field rendered EMPTY when re-populated\r\n *   new Date(\"05-03-2026\")  -> V8 reads MM-DD -> 3 May, not 5 March\r\n *                              -> saving untouched wrote back \"03-05-2026\"\r\n *\r\n * The write path worked, so a form filled in and submitted immediately behaved\r\n * correctly; the damage only surfaced on RE-POPULATE, i.e. an edit flow — the\r\n * path a smoke test is least likely to exercise. `procuration-portnet-fe` shipped\r\n * it for seven batches under a clean strict typecheck.\r\n *\r\n * `coerceToDate` now parses with the SAME format it was written with, in moment's\r\n * STRICT mode, so a malformed stored value yields null instead of a plausible\r\n * wrong date. A missing date is recoverable; a date quietly off by two months is\r\n * not.\r\n *\r\n * BEHAVIOURAL NOTE for existing non-ISO callers: they were mis-parsing before.\r\n * This changes their result from wrong to right — which is the point, but it is a\r\n * change. Callers passing nothing, or \"iso\", are on the identical code path.\r\n *\r\n * Audit: this is the ONLY Formik date bridge in the library. DateTimePicker,\r\n * TimePicker and DateRangePicker are exposed as bare components exchanging Date\r\n * objects, so they have no serialisation step and no equivalent asymmetry;\r\n * _pickerShared carries only Date<->Moment converters, not string parsing.\r\n *\r\n * UPDATE (gap G-E): `FormikDateTimePicker` now exists too, and the two bridges\r\n * SHARE `coerceToDate` / `serialiseDate` via `./_pickerSerialisation`. Keeping\r\n * a private copy in each would have re-created the very asymmetry S-03\r\n * describes, in a form even harder to spot: two bridges that look alike, that\r\n * nobody compares, and that each look correct on their own.\r\n *\r\n * Modal / Drawer usage (MUI X v9):\r\n *   When rendered inside a v2.Drawer or a MUI Modal, the DatePicker\r\n *   calendar popup may render behind the modal surface (both default\r\n *   to zIndex 1300). In MUI X v9, the popper slot is forwarded via\r\n *   slotProps.popper (the legacy `PopperProps` was removed). Pass:\r\n *\r\n *     <FormikDatePicker\r\n *       slotProps={{ popper: { sx: { zIndex: 1400 } } }}\r\n *     />\r\n *\r\n *   Slot props forward through ...rest to v2.DatePicker and on to\r\n *   MuiDatePicker, where they merge with the textField slot bag\r\n *   already wired by v2.DatePicker.\r\n *\r\n * Charter R-I.*.\r\n */\r\n\r\nimport * as React from \"react\";\r\nimport moment from \"moment\";\r\nimport { useField, useFormikContext } from \"formik\";\r\nimport Field from \"../components/Field\";\r\nimport DatePicker from \"../components/DatePicker\";\r\nimport FormikDisplay from \"../components/FormikDisplay\";\r\nimport { coerceToDate, serialiseDate } from \"./_pickerSerialisation\";\r\nimport type { FieldWidth } from \"../components/Field\";\r\nimport type { DatePickerProps } from \"../components/DatePicker\";\r\n\r\nexport interface FormikDatePickerProps\r\n  extends Omit<\r\n    DatePickerProps,\r\n    \"value\" | \"onChange\" | \"disabled\" | \"error\" | \"label\" | \"readOnly\"\r\n  > {\r\n  name: string;\r\n  label?: React.ReactNode | undefined;\r\n  required?: boolean | undefined;\r\n  disabled?: boolean | undefined;\r\n  htmlFor?: string | undefined;\r\n  hint?: React.ReactNode | undefined;\r\n  /**\r\n   * outputFormat — when provided, the Formik field stores a formatted\r\n   * string instead of a Date object. Use when your Yup schema uses\r\n   * Yup.string() with a format-specific test (e.g. \"DD-MM-YYYY\").\r\n   * Pass \"iso\" for ISO 8601, or any moment format token string.\r\n   * Defaults to undefined (Date | null — backward-compatible).\r\n   */\r\n  outputFormat?: string | undefined;\r\n  /**\r\n   * Render the date as read-only text via FormikDisplay instead of a picker.\r\n   * `disabled` wins when both are passed — same rule as FormikInput.\r\n   *\r\n   * `readOnly` IS OMITTED FROM `DatePickerProps` ABOVE, for two reasons.\r\n   *\r\n   * Mechanically: MUI declares it `readOnly?: boolean` with no `| undefined`,\r\n   * so under `exactOptionalPropertyTypes` a host passing an optional\r\n   * `boolean | undefined` — which is what a `readOnly?: boolean | undefined`\r\n   * section prop is — could not satisfy the inherited signature.\r\n   *\r\n   * Semantically: this prop SUPERSEDES MUI's meaning. MUI's `readOnly` keeps the\r\n   * text field and blocks editing; this one replaces the field with text, so\r\n   * there is no input left to mark read-only and forwarding both would be\r\n   * contradictory.\r\n   *\r\n   * BEHAVIOURAL NOTE for existing callers: `readOnly` previously fell through\r\n   * `...rest` to MUI and produced a non-editable INPUT. It now produces display\r\n   * text. Any caller relying on the old rendering should switch to `disabled`.\r\n   */\r\n  readOnly?: boolean | undefined;\r\n  /**\r\n   * Display format in read-only mode. Defaults to the French convention rather\r\n   * than to `outputFormat`: what the field STORES and what a reader should SEE\r\n   * are different concerns — a field storing \"iso\" or \"YYYY-MM-DD\" should still\r\n   * read as 31/12/2026.\r\n   */\r\n  readOnlyFormat?: string | undefined;\r\n  /**\r\n   * Gabarit de largeur semantique (G-H). Le standard range explicitement les\r\n   * dates en `s` (6 a 15 caracteres). Ne s'applique pas en mode `readOnly`.\r\n   */\r\n  width?: FieldWidth | undefined;\r\n}\r\n\r\nconst FormikDatePicker = ({\r\n  name,\r\n  label,\r\n  required,\r\n  disabled,\r\n  readOnly,\r\n  readOnlyFormat = \"DD/MM/YYYY\",\r\n  htmlFor,\r\n  hint,\r\n  outputFormat,\r\n  width,\r\n  ...rest\r\n}: FormikDatePickerProps) => {\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  /* Lecture seule. On repasse par `coerceToDate` avec le MÊME `outputFormat`\r\n   * que le champ utilise pour écrire : c'est la symétrie que S-03 a installée,\r\n   * et s'en écarter ici reproduirait exactement le bug qu'il a corrigé (une date\r\n   * \"31-12-2026\" relue par `new Date()` devient Invalid Date).\r\n   *\r\n   * `format` court-circuite la branche « valeur vide » de FormikDisplay, donc le\r\n   * marqueur « — » est reproduit ici plutôt que délégué — sans quoi un champ\r\n   * sans date afficherait un panneau vide. */\r\n  if (readOnly && !disabled) {\r\n    return (\r\n      <FormikDisplay\r\n        name={name}\r\n        label={label}\r\n        {...(hint !== undefined ? { hint } : {})}\r\n        format={(raw) => {\r\n          const parsed = coerceToDate(raw, outputFormat);\r\n          return parsed ? moment(parsed).format(readOnlyFormat) : \"\\u2014\";\r\n        }}\r\n      />\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      {...(width !== undefined ? { width } : {})}\r\n    >\r\n      <DatePicker\r\n        value={coerceToDate(field.value, outputFormat)}\r\n        onChange={(next) => {\r\n          setFieldValue(name, serialiseDate(next, outputFormat));\r\n          setFieldTouched(name, true, false);\r\n        }}\r\n        {...rest}\r\n      />\r\n    </Field>\r\n  );\r\n};\r\n\r\nexport default FormikDatePicker;\r\n"],"mappings":"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","ignoreList":[]}

package/dist/esm/v2/patterns/FormikDateTimePicker.js

@@ -0,0 +1,150 @@
+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); }
+var _excluded = ["name", "label", "required", "disabled", "readOnly", "readOnlyFormat", "htmlFor", "hint", "outputFormat", "width"];
+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 _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; }
+/**
+ * FormikDateTimePicker — bridge between Formik state and v2.Field +
+ * v2.DateTimePicker.
+ *
+ * ── WHY (gap G-E) ────────────────────────────────────────────────────
+ *
+ * `FormikDatePicker` was the ONLY Formik date bridge in the library, and it is
+ * date-only. Any host with a date-AND-TIME field therefore had two options:
+ * drop the time, or hand-wire `useField` + the bare `DateTimePicker`.
+ *
+ * Dropping the time is not a styling compromise — it CHANGES WHAT THE BACKEND
+ * RECEIVES. Reported from refonte-frontend (lot 7): the physical-visit form
+ * stores a visit date carrying an hour and submits
+ * `moment(value).format("YYYY-MM-DD HH:mm")`. Routed through the date-only
+ * bridge, every visit would have been scheduled at 00:00 — silently, with no
+ * error anywhere, and only the agent showing up at the wrong time would
+ * eventually notice.
+ *
+ * Hand-wiring is the duplication R-2.1 forbids, and the shape in which
+ * validation messages go missing (see gaps G-A and G-C, same story).
+ *
+ * Usage:
+ *
+ *   <FormikDateTimePicker
+ *     name="dateVisite"
+ *     label="Date de la visite"
+ *     required
+ *   />
+ *
+ *   // Field must store a string in the charter datetime format:
+ *   <FormikDateTimePicker
+ *     name="dateVisite"
+ *     outputFormat={DATETIME_FORMAT_CHARTER}   // "YYYY-MM-DD HH:mm"
+ *   />
+ *
+ * ── SERIALISATION IS SHARED WITH FormikDatePicker, DELIBERATELY ──────
+ *
+ * `coerceToDate` / `serialiseDate` live in `./_pickerSerialisation` and are
+ * used by BOTH bridges. That is not tidiness: `FormikDatePicker`'s S-03 note
+ * documents what happens when the read and the write of a date disagree — a
+ * stored "31-12-2026" read back by `new Date()` becomes Invalid Date, a stored
+ * "05-03-2026" becomes 3 May instead of 5 March. The write path works, so the
+ * damage only appears on RE-POPULATE, i.e. in an edit flow, which is the path
+ * a smoke test is least likely to exercise. One module shipped that for seven
+ * batches under a clean strict typecheck.
+ *
+ * Two private copies of that couple would have re-created the same class of
+ * bug in a form even harder to spot.
+ *
+ * ── DEFAULT OUTPUT IS A Date, LIKE THE SIBLING ──────────────────────
+ *
+ * With no `outputFormat`, the field stores `Date | null` — which is what
+ * `Yup.date()` expects and what a host formatting at submit time already
+ * handles. Pass `"iso"` for ISO 8601, or any moment token string (typically
+ * `DATETIME_FORMAT_CHARTER`) when the schema is a `Yup.string()` with a format
+ * test. Whatever is chosen, reading back uses the SAME format.
+ *
+ * Modal / Drawer usage (MUI X v9): the picker popup may render behind a modal
+ * surface (both default to zIndex 1300). Forward
+ * `slotProps={{ popper: { sx: { zIndex: 1400 } } }}` — it reaches
+ * MuiDateTimePicker through `...rest`, exactly as on `FormikDatePicker`.
+ *
+ * Charter §03 · R-I.*. Peer dependency: formik >= 2.x.
+ */
+
+import * as React from "react";
+import moment from "moment";
+import { useField, useFormikContext } from "formik";
+import Field from "../components/Field";
+import DateTimePicker from "../components/DateTimePicker";
+import FormikDisplay from "../components/FormikDisplay";
+import { coerceToDate, serialiseDate } from "./_pickerSerialisation";
+import { jsx as _jsx } from "react/jsx-runtime";
+var FormikDateTimePicker = function FormikDateTimePicker(_ref) {
+  var name = _ref.name,
+    label = _ref.label,
+    required = _ref.required,
+    disabled = _ref.disabled,
+    readOnly = _ref.readOnly,
+    _ref$readOnlyFormat = _ref.readOnlyFormat,
+    readOnlyFormat = _ref$readOnlyFormat === void 0 ? "DD/MM/YYYY HH:mm" : _ref$readOnlyFormat,
+    htmlFor = _ref.htmlFor,
+    hint = _ref.hint,
+    outputFormat = _ref.outputFormat,
+    width = _ref.width,
+    rest = _objectWithoutProperties(_ref, _excluded);
+  var _useField = useField(name),
+    _useField2 = _slicedToArray(_useField, 2),
+    field = _useField2[0],
+    meta = _useField2[1];
+  var _useFormikContext = useFormikContext(),
+    setFieldValue = _useFormikContext.setFieldValue,
+    setFieldTouched = _useFormikContext.setFieldTouched;
+  var hasError = Boolean(meta.touched && meta.error);
+
+  /* Lecture seule. On repasse par `coerceToDate` avec le MEME `outputFormat`
+   * que le champ utilise pour ecrire : c'est la symetrie de S-03. `format`
+   * court-circuite la branche « valeur vide » de FormikDisplay, donc le
+   * marqueur est reproduit ici plutot que delegue. */
+  if (readOnly && !disabled) {
+    return /*#__PURE__*/_jsx(FormikDisplay, _objectSpread(_objectSpread({
+      name: name,
+      label: label
+    }, hint !== undefined ? {
+      hint: hint
+    } : {}), {}, {
+      format: function format(raw) {
+        var parsed = coerceToDate(raw, outputFormat);
+        return parsed ? moment(parsed).format(readOnlyFormat) : "\u2014";
+      }
+    }));
+  }
+  return /*#__PURE__*/_jsx(Field, _objectSpread(_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
+  } : {}), width !== undefined ? {
+    width: width
+  } : {}), {}, {
+    children: /*#__PURE__*/_jsx(DateTimePicker, _objectSpread({
+      value: coerceToDate(field.value, outputFormat),
+      onChange: function onChange(next) {
+        setFieldValue(name, serialiseDate(next, outputFormat));
+        setFieldTouched(name, true, false);
+      }
+    }, rest))
+  }));
+};
+export default FormikDateTimePicker;
+//# sourceMappingURL=FormikDateTimePicker.js.map

package/dist/esm/v2/patterns/FormikDateTimePicker.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"FormikDateTimePicker.js","names":["React","moment","useField","useFormikContext","Field","DateTimePicker","FormikDisplay","coerceToDate","serialiseDate","jsx","_jsx","FormikDateTimePicker","_ref","name","label","required","disabled","readOnly","_ref$readOnlyFormat","readOnlyFormat","htmlFor","hint","outputFormat","width","rest","_objectWithoutProperties","_excluded","_useField","_useField2","_slicedToArray","field","meta","_useFormikContext","setFieldValue","setFieldTouched","hasError","Boolean","touched","error","_objectSpread","undefined","format","raw","parsed","children","value","onChange","next"],"sources":["../../../../src/lib/v2/patterns/FormikDateTimePicker.tsx"],"sourcesContent":["/**\r\n * FormikDateTimePicker — bridge between Formik state and v2.Field +\r\n * v2.DateTimePicker.\r\n *\r\n * ── WHY (gap G-E) ────────────────────────────────────────────────────\r\n *\r\n * `FormikDatePicker` was the ONLY Formik date bridge in the library, and it is\r\n * date-only. Any host with a date-AND-TIME field therefore had two options:\r\n * drop the time, or hand-wire `useField` + the bare `DateTimePicker`.\r\n *\r\n * Dropping the time is not a styling compromise — it CHANGES WHAT THE BACKEND\r\n * RECEIVES. Reported from refonte-frontend (lot 7): the physical-visit form\r\n * stores a visit date carrying an hour and submits\r\n * `moment(value).format(\"YYYY-MM-DD HH:mm\")`. Routed through the date-only\r\n * bridge, every visit would have been scheduled at 00:00 — silently, with no\r\n * error anywhere, and only the agent showing up at the wrong time would\r\n * eventually notice.\r\n *\r\n * Hand-wiring is the duplication R-2.1 forbids, and the shape in which\r\n * validation messages go missing (see gaps G-A and G-C, same story).\r\n *\r\n * Usage:\r\n *\r\n *   <FormikDateTimePicker\r\n *     name=\"dateVisite\"\r\n *     label=\"Date de la visite\"\r\n *     required\r\n *   />\r\n *\r\n *   // Field must store a string in the charter datetime format:\r\n *   <FormikDateTimePicker\r\n *     name=\"dateVisite\"\r\n *     outputFormat={DATETIME_FORMAT_CHARTER}   // \"YYYY-MM-DD HH:mm\"\r\n *   />\r\n *\r\n * ── SERIALISATION IS SHARED WITH FormikDatePicker, DELIBERATELY ──────\r\n *\r\n * `coerceToDate` / `serialiseDate` live in `./_pickerSerialisation` and are\r\n * used by BOTH bridges. That is not tidiness: `FormikDatePicker`'s S-03 note\r\n * documents what happens when the read and the write of a date disagree — a\r\n * stored \"31-12-2026\" read back by `new Date()` becomes Invalid Date, a stored\r\n * \"05-03-2026\" becomes 3 May instead of 5 March. The write path works, so the\r\n * damage only appears on RE-POPULATE, i.e. in an edit flow, which is the path\r\n * a smoke test is least likely to exercise. One module shipped that for seven\r\n * batches under a clean strict typecheck.\r\n *\r\n * Two private copies of that couple would have re-created the same class of\r\n * bug in a form even harder to spot.\r\n *\r\n * ── DEFAULT OUTPUT IS A Date, LIKE THE SIBLING ──────────────────────\r\n *\r\n * With no `outputFormat`, the field stores `Date | null` — which is what\r\n * `Yup.date()` expects and what a host formatting at submit time already\r\n * handles. Pass `\"iso\"` for ISO 8601, or any moment token string (typically\r\n * `DATETIME_FORMAT_CHARTER`) when the schema is a `Yup.string()` with a format\r\n * test. Whatever is chosen, reading back uses the SAME format.\r\n *\r\n * Modal / Drawer usage (MUI X v9): the picker popup may render behind a modal\r\n * surface (both default to zIndex 1300). Forward\r\n * `slotProps={{ popper: { sx: { zIndex: 1400 } } }}` — it reaches\r\n * MuiDateTimePicker through `...rest`, exactly as on `FormikDatePicker`.\r\n *\r\n * Charter §03 · R-I.*. Peer dependency: formik >= 2.x.\r\n */\r\n\r\nimport * as React from \"react\";\r\nimport moment from \"moment\";\r\nimport { useField, useFormikContext } from \"formik\";\r\nimport Field from \"../components/Field\";\r\nimport DateTimePicker from \"../components/DateTimePicker\";\r\nimport FormikDisplay from \"../components/FormikDisplay\";\r\nimport { coerceToDate, serialiseDate } from \"./_pickerSerialisation\";\r\nimport type { FieldWidth } from \"../components/Field\";\r\nimport type { DateTimePickerProps } from \"../components/DateTimePicker\";\r\n\r\nexport interface FormikDateTimePickerProps\r\n  extends Omit<\r\n    DateTimePickerProps,\r\n    \"value\" | \"onChange\" | \"disabled\" | \"error\" | \"label\" | \"readOnly\"\r\n  > {\r\n  name: string;\r\n  label?: React.ReactNode | undefined;\r\n  required?: boolean | undefined;\r\n  disabled?: boolean | undefined;\r\n  htmlFor?: string | undefined;\r\n  hint?: React.ReactNode | undefined;\r\n  /**\r\n   * When provided, the Formik field stores a formatted STRING instead of a\r\n   * `Date`. Pass `\"iso\"` for ISO 8601, or any moment token string — typically\r\n   * `DATETIME_FORMAT_CHARTER` (\"YYYY-MM-DD HH:mm\"). Defaults to undefined\r\n   * (`Date | null`).\r\n   */\r\n  outputFormat?: string | undefined;\r\n  /**\r\n   * Render the value as read-only text via `FormikDisplay` instead of a\r\n   * picker. `disabled` wins when both are passed — same rule as\r\n   * `FormikInput` and `FormikDatePicker`.\r\n   *\r\n   * Omitted from `DateTimePickerProps` above for the same two reasons as on\r\n   * the sibling: MUI declares `readOnly?: boolean` with no `| undefined`, which\r\n   * an optional section prop cannot satisfy under\r\n   * `exactOptionalPropertyTypes`; and this prop SUPERSEDES MUI's meaning —\r\n   * MUI keeps the text field and blocks editing, this one replaces the field\r\n   * with text, so there is no input left to mark read-only.\r\n   */\r\n  readOnly?: boolean | undefined;\r\n  /**\r\n   * Display format in read-only mode. Defaults to the French convention rather\r\n   * than to `outputFormat`: what the field STORES and what a reader should SEE\r\n   * are different concerns — a field storing ISO should still read as\r\n   * 31/12/2026 14:30.\r\n   */\r\n  readOnlyFormat?: string | undefined;\r\n  /**\r\n   * Gabarit de largeur semantique (G-H). Le standard range les dates en `s`\r\n   * (6 a 15 caracteres) : une date-heure au format charte en fait 16, donc `s`\r\n   * ou `m` selon la place disponible. Ne s'applique pas en mode `readOnly`.\r\n   */\r\n  width?: FieldWidth | undefined;\r\n}\r\n\r\nconst FormikDateTimePicker = ({\r\n  name,\r\n  label,\r\n  required,\r\n  disabled,\r\n  readOnly,\r\n  readOnlyFormat = \"DD/MM/YYYY HH:mm\",\r\n  htmlFor,\r\n  hint,\r\n  outputFormat,\r\n  width,\r\n  ...rest\r\n}: FormikDateTimePickerProps) => {\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  /* Lecture seule. On repasse par `coerceToDate` avec le MEME `outputFormat`\r\n   * que le champ utilise pour ecrire : c'est la symetrie de S-03. `format`\r\n   * court-circuite la branche « valeur vide » de FormikDisplay, donc le\r\n   * marqueur est reproduit ici plutot que delegue. */\r\n  if (readOnly && !disabled) {\r\n    return (\r\n      <FormikDisplay\r\n        name={name}\r\n        label={label}\r\n        {...(hint !== undefined ? { hint } : {})}\r\n        format={(raw) => {\r\n          const parsed = coerceToDate(raw, outputFormat);\r\n          return parsed ? moment(parsed).format(readOnlyFormat) : \"\\u2014\";\r\n        }}\r\n      />\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      {...(width !== undefined ? { width } : {})}\r\n    >\r\n      <DateTimePicker\r\n        value={coerceToDate(field.value, outputFormat)}\r\n        onChange={(next) => {\r\n          setFieldValue(name, serialiseDate(next, outputFormat));\r\n          setFieldTouched(name, true, false);\r\n        }}\r\n        {...rest}\r\n      />\r\n    </Field>\r\n  );\r\n};\r\n\r\nexport default FormikDateTimePicker;\r\n"],"mappings":"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","ignoreList":[]}

package/dist/esm/v2/patterns/FormikErrorFocus.js

@@ -0,0 +1,77 @@
+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 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); }
+import { useFormikContext } from "formik";
+import useFocusFirstError from "../hooks/useFocusFirstError";
+
+/**
+ * FormikErrorFocus — Portnet UI v2 (pattern)
+ *
+ * Charter §05.3 R-F.3 / §04.1 R-FV.3. Renders NOTHING; it exists purely to
+ * move focus to the first field in error after a failed submit.
+ *
+ * The companion to FormErrorSummary: that component makes the errors
+ * visible and reachable by click, this one puts the caret in the first of
+ * them. R-FV.2 and R-FV.3 are separate MUST rules and a form needs both.
+ *
+ *   <Formik initialValues={…} validationSchema={…} onSubmit={…}>
+ *     <Form>
+ *       <FormikErrorFocus order={["numeroFacture", "fournisseur", "dateFacture"]} />
+ *       <FormikInput name="numeroFacture" label="N° de la facture" required />
+ *       <FormikInput name="fournisseur"   label="Fournisseur" required />
+ *       <FormikDatePicker name="dateFacture" label="Date de la facture" required />
+ *     </Form>
+ *   </Formik>
+ *
+ * Placement inside the form is free — it renders null, so it has no layout
+ * or tab-order effect. It MUST be a descendant of <Formik>, since it reads
+ * the context.
+ *
+ * ── WHY A COMPONENT AND NOT JUST THE HOOK ───────────────────────────
+ *
+ * The prevailing Formik shape in the modules is `<Formik><Form>…</Form>
+ * </Formik>` with STATIC children. The hosting component's body is outside
+ * the provider, so useFormikContext cannot be called there; and passing
+ * innerRef does not help, because a ref mutation does not re-render the
+ * holder when `errors` changes. A null-rendering descendant is the only
+ * place the context is both available and reactive.
+ *
+ * Where a component already sits inside the provider — a form section using
+ * useFormikContext, like the mjcc-fe publication and facture blocs — call
+ * `focusFieldByName` directly instead. Those guards run on a button click
+ * rather than a Formik submit, so there is no submitCount to react to.
+ */
+
+function FormikErrorFocus(_ref) {
+  var order = _ref.order,
+    _ref$scroll = _ref.scroll,
+    scroll = _ref$scroll === void 0 ? true : _ref$scroll,
+    _ref$enabled = _ref.enabled,
+    enabled = _ref$enabled === void 0 ? true : _ref$enabled;
+  /*
+   * Record<string, unknown> rather than the host's own values type, and
+   * rather than a cast. FormikErrors<Record<string, unknown>> resolves to
+   * an index-signature map of optional strings, which is assignable to the
+   * hook's Readonly<Record<string, unknown>> — so the two contracts meet
+   * without an assertion. useFormikContext does not check its type
+   * parameter against the provider, so this stays valid whatever the form's
+   * value shape is.
+   */
+  var _useFormikContext = useFormikContext(),
+    errors = _useFormikContext.errors,
+    submitCount = _useFormikContext.submitCount;
+  useFocusFirstError(_objectSpread({
+    errors: errors,
+    submitCount: submitCount,
+    scroll: scroll,
+    enabled: enabled
+  }, order !== undefined ? {
+    order: order
+  } : {}));
+  return null;
+}
+export default FormikErrorFocus;
+//# sourceMappingURL=FormikErrorFocus.js.map

package/dist/esm/v2/patterns/FormikErrorFocus.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"FormikErrorFocus.js","names":["useFormikContext","useFocusFirstError","FormikErrorFocus","_ref","order","_ref$scroll","scroll","_ref$enabled","enabled","_useFormikContext","errors","submitCount","_objectSpread","undefined"],"sources":["../../../../src/lib/v2/patterns/FormikErrorFocus.tsx"],"sourcesContent":["import { useFormikContext } from \"formik\";\r\nimport useFocusFirstError from \"../hooks/useFocusFirstError\";\r\n\r\n/**\r\n * FormikErrorFocus — Portnet UI v2 (pattern)\r\n *\r\n * Charter §05.3 R-F.3 / §04.1 R-FV.3. Renders NOTHING; it exists purely to\r\n * move focus to the first field in error after a failed submit.\r\n *\r\n * The companion to FormErrorSummary: that component makes the errors\r\n * visible and reachable by click, this one puts the caret in the first of\r\n * them. R-FV.2 and R-FV.3 are separate MUST rules and a form needs both.\r\n *\r\n *   <Formik initialValues={…} validationSchema={…} onSubmit={…}>\r\n *     <Form>\r\n *       <FormikErrorFocus order={[\"numeroFacture\", \"fournisseur\", \"dateFacture\"]} />\r\n *       <FormikInput name=\"numeroFacture\" label=\"N° de la facture\" required />\r\n *       <FormikInput name=\"fournisseur\"   label=\"Fournisseur\" required />\r\n *       <FormikDatePicker name=\"dateFacture\" label=\"Date de la facture\" required />\r\n *     </Form>\r\n *   </Formik>\r\n *\r\n * Placement inside the form is free — it renders null, so it has no layout\r\n * or tab-order effect. It MUST be a descendant of <Formik>, since it reads\r\n * the context.\r\n *\r\n * ── WHY A COMPONENT AND NOT JUST THE HOOK ───────────────────────────\r\n *\r\n * The prevailing Formik shape in the modules is `<Formik><Form>…</Form>\r\n * </Formik>` with STATIC children. The hosting component's body is outside\r\n * the provider, so useFormikContext cannot be called there; and passing\r\n * innerRef does not help, because a ref mutation does not re-render the\r\n * holder when `errors` changes. A null-rendering descendant is the only\r\n * place the context is both available and reactive.\r\n *\r\n * Where a component already sits inside the provider — a form section using\r\n * useFormikContext, like the mjcc-fe publication and facture blocs — call\r\n * `focusFieldByName` directly instead. Those guards run on a button click\r\n * rather than a Formik submit, so there is no submitCount to react to.\r\n */\r\n\r\nexport interface FormikErrorFocusProps {\r\n  /**\r\n   * Field names in RENDERED order, top to bottom.\r\n   *\r\n   * SUPPLY THIS. The fallback is `Object.keys(errors)` — the order the\r\n   * validator wrote its keys, which bears no relation to the layout, so\r\n   * \"first field in error\" can resolve to the last field on screen.\r\n   */\r\n  order?: readonly string[] | undefined;\r\n  /** Scroll the field into view before focusing. @default true */\r\n  scroll?: boolean | undefined;\r\n  /**\r\n   * Set false to suspend the behaviour — e.g. a read-only mode where the\r\n   * submit path is closed and moving focus would be noise.\r\n   *\r\n   * @default true\r\n   */\r\n  enabled?: boolean | undefined;\r\n}\r\n\r\nfunction FormikErrorFocus({\r\n  order,\r\n  scroll = true,\r\n  enabled = true,\r\n}: FormikErrorFocusProps) {\r\n  /*\r\n   * Record<string, unknown> rather than the host's own values type, and\r\n   * rather than a cast. FormikErrors<Record<string, unknown>> resolves to\r\n   * an index-signature map of optional strings, which is assignable to the\r\n   * hook's Readonly<Record<string, unknown>> — so the two contracts meet\r\n   * without an assertion. useFormikContext does not check its type\r\n   * parameter against the provider, so this stays valid whatever the form's\r\n   * value shape is.\r\n   */\r\n  const { errors, submitCount } = useFormikContext<Record<string, unknown>>();\r\n\r\n  useFocusFirstError({\r\n    errors,\r\n    submitCount,\r\n    scroll,\r\n    enabled,\r\n    /* Conditional spread: `order` is optional here and declared\r\n       `readonly string[] | undefined` on the hook, and the library compiles\r\n       under exactOptionalPropertyTypes, which rejects an explicitly-passed\r\n       undefined. */\r\n    ...(order !== undefined ? { order } : {}),\r\n  });\r\n\r\n  return null;\r\n}\r\n\r\nexport default FormikErrorFocus;\r\n"],"mappings":";;;;;;AAAA,SAASA,gBAAgB,QAAQ,QAAQ;AACzC,OAAOC,kBAAkB,MAAM,6BAA6B;;AAE5D;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAsBA,SAASC,gBAAgBA,CAAAC,IAAA,EAIC;EAAA,IAHxBC,KAAK,GAAAD,IAAA,CAALC,KAAK;IAAAC,WAAA,GAAAF,IAAA,CACLG,MAAM;IAANA,MAAM,GAAAD,WAAA,cAAG,IAAI,GAAAA,WAAA;IAAAE,YAAA,GAAAJ,IAAA,CACbK,OAAO;IAAPA,OAAO,GAAAD,YAAA,cAAG,IAAI,GAAAA,YAAA;EAEd;AACF;AACA;AACA;AACA;AACA;AACA;AACA;AACA;EACE,IAAAE,iBAAA,GAAgCT,gBAAgB,CAA0B,CAAC;IAAnEU,MAAM,GAAAD,iBAAA,CAANC,MAAM;IAAEC,WAAW,GAAAF,iBAAA,CAAXE,WAAW;EAE3BV,kBAAkB,CAAAW,aAAA;IAChBF,MAAM,EAANA,MAAM;IACNC,WAAW,EAAXA,WAAW;IACXL,MAAM,EAANA,MAAM;IACNE,OAAO,EAAPA;EAAO,GAKHJ,KAAK,KAAKS,SAAS,GAAG;IAAET,KAAK,EAALA;EAAM,CAAC,GAAG,CAAC,CAAC,CACzC,CAAC;EAEF,OAAO,IAAI;AACb;AAEA,eAAeF,gBAAgB","ignoreList":[]}