@portnet/ui 6.0.1 → 6.0.3

package/dist/v2/patterns/FormikErrorFocus.js

@@ -3,16 +3,10 @@
 Object.defineProperty(exports, "__esModule", {
   value: true
 });
-exports["default"] = void 0;
+exports.default = void 0;
 var _formik = require("formik");
 var _useFocusFirstError = _interopRequireDefault(require("../hooks/useFocusFirstError"));
-function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { "default": obj }; }
-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); }
+function _interopRequireDefault(e) { return e && e.__esModule ? e : { default: e }; }
 /**
  * FormikErrorFocus — Portnet UI v2 (pattern)
  *
@@ -51,12 +45,11 @@ function _toPrimitive(input, hint) { if (_typeof(input) !== "object" || input ==
  * 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;
+function FormikErrorFocus({
+  order,
+  scroll = true,
+  enabled = true
+}) {
   /*
    * Record<string, unknown> rather than the host's own values type, and
    * rather than a cast. FormikErrors<Record<string, unknown>> resolves to
@@ -66,18 +59,24 @@ function FormikErrorFocus(_ref) {
    * parameter against the provider, so this stays valid whatever the form's
    * value shape is.
    */
-  var _useFormikContext = (0, _formik.useFormikContext)(),
-    errors = _useFormikContext.errors,
-    submitCount = _useFormikContext.submitCount;
-  (0, _useFocusFirstError["default"])(_objectSpread({
-    errors: errors,
-    submitCount: submitCount,
-    scroll: scroll,
-    enabled: enabled
-  }, order !== undefined ? {
-    order: order
-  } : {}));
+  const {
+    errors,
+    submitCount
+  } = (0, _formik.useFormikContext)();
+  (0, _useFocusFirstError.default)({
+    errors,
+    submitCount,
+    scroll,
+    enabled,
+    /* Conditional spread: `order` is optional here and declared
+       `readonly string[] | undefined` on the hook, and the library compiles
+       under exactOptionalPropertyTypes, which rejects an explicitly-passed
+       undefined. */
+    ...(order !== undefined ? {
+      order
+    } : {})
+  });
   return null;
 }
-var _default = exports["default"] = FormikErrorFocus;
+var _default = exports.default = FormikErrorFocus;
 //# sourceMappingURL=FormikErrorFocus.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"FormikErrorFocus.js","names":["_formik","require","_useFocusFirstError","_interopRequireDefault","obj","__esModule","_typeof","Symbol","iterator","constructor","prototype","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","String","input","hint","prim","toPrimitive","undefined","res","call","TypeError","Number","FormikErrorFocus","_ref","order","_ref$scroll","scroll","_ref$enabled","enabled","_useFormikContext","useFormikContext","errors","submitCount","useFocusFirstError","_default","exports"],"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":"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","ignoreList":[]}
+{"version":3,"file":"FormikErrorFocus.js","names":["_formik","require","_useFocusFirstError","_interopRequireDefault","e","__esModule","default","FormikErrorFocus","order","scroll","enabled","errors","submitCount","useFormikContext","useFocusFirstError","undefined","_default","exports"],"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,IAAAA,OAAA,GAAAC,OAAA;AACA,IAAAC,mBAAA,GAAAC,sBAAA,CAAAF,OAAA;AAA6D,SAAAE,uBAAAC,CAAA,WAAAA,CAAA,IAAAA,CAAA,CAAAC,UAAA,GAAAD,CAAA,KAAAE,OAAA,EAAAF,CAAA;AAE7D;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,SAASG,gBAAgBA,CAAC;EACxBC,KAAK;EACLC,MAAM,GAAG,IAAI;EACbC,OAAO,GAAG;AACW,CAAC,EAAE;EACxB;AACF;AACA;AACA;AACA;AACA;AACA;AACA;AACA;EACE,MAAM;IAAEC,MAAM;IAAEC;EAAY,CAAC,GAAG,IAAAC,wBAAgB,EAA0B,CAAC;EAE3E,IAAAC,2BAAkB,EAAC;IACjBH,MAAM;IACNC,WAAW;IACXH,MAAM;IACNC,OAAO;IACP;AACJ;AACA;AACA;IACI,IAAIF,KAAK,KAAKO,SAAS,GAAG;MAAEP;IAAM,CAAC,GAAG,CAAC,CAAC;EAC1C,CAAC,CAAC;EAEF,OAAO,IAAI;AACb;AAAC,IAAAQ,QAAA,GAAAC,OAAA,CAAAX,OAAA,GAEcC,gBAAgB","ignoreList":[]}

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

@@ -0,0 +1,74 @@
+import * as React from "react";
+/**
+ * FormikErrorSummary — Portnet UI v2 (pattern)
+ *
+ * Charter §04.1 R-FV.2 / §05 R-4.2 MUST — "Submit échoué → bandeau de synthèse
+ * en haut du formulaire". The Formik bridge for `FormErrorSummary`, and the
+ * companion of `FormikErrorFocus`: that one puts the caret in the first field
+ * in error, this one lists them all with jump-links.
+ *
+ *   <Formik …>
+ *     <Form>
+ *       <FormikErrorSummary
+ *         labelByName={{ numeroFormule: "N° de formule", montant: "Montant" }}
+ *         onItemClick={focusFieldByName}
+ *       />
+ *       …fields…
+ *     </Form>
+ *   </Formik>
+ *
+ * ── WHY THIS EXISTS (ms-ti-fe, Area 11) ─────────────────────────────
+ *
+ * The library owned all three parts of the failed-submit recipe and no way to
+ * assemble them inside the prevailing form shape:
+ *
+ *   · `FormErrorSummary`   — renders the banner, takes a flat list;
+ *   · `flattenFormikErrors`— produces that list from Formik's error tree (G-38);
+ *   · `focusFieldByName`   — resolves an item's name to a control (R-FV.3).
+ *
+ * Reaching `errors` and `submitCount` requires the Formik CONTEXT, and modules
+ * overwhelmingly write `<Formik><Form>…</Form></Formik>` with STATIC children:
+ * the hosting component's body sits OUTSIDE the provider, so it cannot call
+ * `useFormikContext`, and `innerRef` does not help — mutating a ref does not
+ * re-render the holder when `errors` changes. Each host therefore had to either
+ * convert its form to a render-prop purely to reach the errors, or write a
+ * local null-rendering context reader.
+ *
+ * ms-ti-fe has ELEVEN Formik forms. ONE had the banner; wiring the other ten
+ * meant ten copies of that wrapper. `FormikErrorFocus` exists for precisely
+ * this reason on the sibling rule, which is why field adoption of the two
+ * MUSTs diverged so sharply — 1 of 11 for R-FV.2 against 0 of 11 for R-FV.3,
+ * the one with a bridge being the one nobody could apply without boilerplate.
+ *
+ * GOVERNANCE NOTE. This is a BRIDGE over an already-certified component — the
+ * thirteenth, after FormikInput / Select / Combobox / DatePicker /
+ * DateTimePicker / Textarea / File / Checkbox / CheckboxGroup / RadioGroup /
+ * ReferentielField / ErrorFocus. It renders no markup of its own, introduces no
+ * design decision, and adds no token. If the DS team holds that even a bridge
+ * takes the §10.2 component-proposal path, treat this file as the proposal.
+ */
+export interface FormikErrorSummaryProps {
+    /**
+     * Field name → human label. Without it the banner lists RAW field paths
+     * (`donneesTI.categorieTitre`), which satisfies R-FV.2's letter and fails
+     * R-4.4's intent ("messages actionnables"). Supply it.
+     */
+    labelByName?: Record<string, string> | undefined;
+    /**
+     * Jump-to-field behaviour. Pass the exported `focusFieldByName` for a
+     * single-page form. Wrap it when the target may be on an unmounted wizard
+     * step or inside a collapsed section, so the owner opens first —
+     * `focusFieldByName` deliberately refuses a control with no client rects.
+     */
+    onItemClick?: ((name: string) => void) | undefined;
+    title?: string | undefined;
+    /**
+     * Hold the banner back until the first submit attempt, so a pristine form is
+     * not pre-scolded (R-I.4 — validate on blur, never on keystroke).
+     * @default true
+     */
+    afterSubmitOnly?: boolean | undefined;
+}
+declare function FormikErrorSummary({ labelByName, onItemClick, title, afterSubmitOnly, }: FormikErrorSummaryProps): React.JSX.Element | null;
+export default FormikErrorSummary;
+//# sourceMappingURL=FormikErrorSummary.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"FormikErrorSummary.d.ts","sourceRoot":"","sources":["../../../src/lib/v2/patterns/FormikErrorSummary.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAK/B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+CG;AACH,MAAM,WAAW,uBAAuB;IACtC;;;;OAIG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,SAAS,CAAC;IACjD;;;;;OAKG;IACH,WAAW,CAAC,EAAE,CAAC,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC,GAAG,SAAS,CAAC;IACnD,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC3B;;;;OAIG;IACH,eAAe,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;CACvC;AAED,iBAAS,kBAAkB,CAAC,EAC1B,WAAW,EACX,WAAW,EACX,KAAK,EACL,eAAsB,GACvB,EAAE,uBAAuB,4BAqBzB;AAED,eAAe,kBAAkB,CAAC"}

package/dist/v2/patterns/FormikErrorSummary.js

@@ -0,0 +1,97 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.default = void 0;
+var React = _interopRequireWildcard(require("react"));
+var _formik = require("formik");
+var _FormErrorSummary = _interopRequireDefault(require("./FormErrorSummary"));
+var _formikErrors = require("../utils/formikErrors");
+var _jsxRuntime = require("react/jsx-runtime");
+function _interopRequireDefault(e) { return e && e.__esModule ? e : { default: e }; }
+function _interopRequireWildcard(e, t) { if ("function" == typeof WeakMap) var r = new WeakMap(), n = new WeakMap(); return (_interopRequireWildcard = function (e, t) { if (!t && e && e.__esModule) return e; var o, i, f = { __proto__: null, default: e }; if (null === e || "object" != typeof e && "function" != typeof e) return f; if (o = t ? n : r) { if (o.has(e)) return o.get(e); o.set(e, f); } for (const t in e) "default" !== t && {}.hasOwnProperty.call(e, t) && ((i = (o = Object.defineProperty) && Object.getOwnPropertyDescriptor(e, t)) && (i.get || i.set) ? o(f, t, i) : f[t] = e[t]); return f; })(e, t); }
+/**
+ * FormikErrorSummary — Portnet UI v2 (pattern)
+ *
+ * Charter §04.1 R-FV.2 / §05 R-4.2 MUST — "Submit échoué → bandeau de synthèse
+ * en haut du formulaire". The Formik bridge for `FormErrorSummary`, and the
+ * companion of `FormikErrorFocus`: that one puts the caret in the first field
+ * in error, this one lists them all with jump-links.
+ *
+ *   <Formik …>
+ *     <Form>
+ *       <FormikErrorSummary
+ *         labelByName={{ numeroFormule: "N° de formule", montant: "Montant" }}
+ *         onItemClick={focusFieldByName}
+ *       />
+ *       …fields…
+ *     </Form>
+ *   </Formik>
+ *
+ * ── WHY THIS EXISTS (ms-ti-fe, Area 11) ─────────────────────────────
+ *
+ * The library owned all three parts of the failed-submit recipe and no way to
+ * assemble them inside the prevailing form shape:
+ *
+ *   · `FormErrorSummary`   — renders the banner, takes a flat list;
+ *   · `flattenFormikErrors`— produces that list from Formik's error tree (G-38);
+ *   · `focusFieldByName`   — resolves an item's name to a control (R-FV.3).
+ *
+ * Reaching `errors` and `submitCount` requires the Formik CONTEXT, and modules
+ * overwhelmingly write `<Formik><Form>…</Form></Formik>` with STATIC children:
+ * the hosting component's body sits OUTSIDE the provider, so it cannot call
+ * `useFormikContext`, and `innerRef` does not help — mutating a ref does not
+ * re-render the holder when `errors` changes. Each host therefore had to either
+ * convert its form to a render-prop purely to reach the errors, or write a
+ * local null-rendering context reader.
+ *
+ * ms-ti-fe has ELEVEN Formik forms. ONE had the banner; wiring the other ten
+ * meant ten copies of that wrapper. `FormikErrorFocus` exists for precisely
+ * this reason on the sibling rule, which is why field adoption of the two
+ * MUSTs diverged so sharply — 1 of 11 for R-FV.2 against 0 of 11 for R-FV.3,
+ * the one with a bridge being the one nobody could apply without boilerplate.
+ *
+ * GOVERNANCE NOTE. This is a BRIDGE over an already-certified component — the
+ * thirteenth, after FormikInput / Select / Combobox / DatePicker /
+ * DateTimePicker / Textarea / File / Checkbox / CheckboxGroup / RadioGroup /
+ * ReferentielField / ErrorFocus. It renders no markup of its own, introduces no
+ * design decision, and adds no token. If the DS team holds that even a bridge
+ * takes the §10.2 component-proposal path, treat this file as the proposal.
+ */
+
+function FormikErrorSummary({
+  labelByName,
+  onItemClick,
+  title,
+  afterSubmitOnly = true
+}) {
+  const {
+    errors,
+    submitCount
+  } = (0, _formik.useFormikContext)();
+
+  /* Recomputed only when the tree or the attempt count changes: the recursion
+   * walks every leaf, and a form rejected on submit re-renders on every
+   * keystroke that follows while the user fixes it. */
+  const flat = React.useMemo(() => (0, _formikErrors.flattenFormikErrors)(errors), [errors]);
+  if (afterSubmitOnly && submitCount === 0) return null;
+
+  /* `FormErrorSummary` already returns null on an empty list, so mounting this
+   * unconditionally is safe and keeps the banner's appearance/disappearance in
+   * one place rather than duplicating the guard at every call site. */
+  return /*#__PURE__*/(0, _jsxRuntime.jsx)(_FormErrorSummary.default, {
+    errors: flat,
+    ...(labelByName !== undefined ? {
+      labelByName
+    } : {}),
+    ...(onItemClick !== undefined ? {
+      onItemClick
+    } : {}),
+    ...(title !== undefined ? {
+      title
+    } : {})
+  });
+}
+var _default = exports.default = FormikErrorSummary;
+//# sourceMappingURL=FormikErrorSummary.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"FormikErrorSummary.js","names":["React","_interopRequireWildcard","require","_formik","_FormErrorSummary","_interopRequireDefault","_formikErrors","_jsxRuntime","e","__esModule","default","t","WeakMap","r","n","o","i","f","__proto__","has","get","set","hasOwnProperty","call","Object","defineProperty","getOwnPropertyDescriptor","FormikErrorSummary","labelByName","onItemClick","title","afterSubmitOnly","errors","submitCount","useFormikContext","flat","useMemo","flattenFormikErrors","jsx","undefined","_default","exports"],"sources":["../../../src/lib/v2/patterns/FormikErrorSummary.tsx"],"sourcesContent":["import * as React from \"react\";\r\nimport { useFormikContext } from \"formik\";\r\nimport FormErrorSummary from \"./FormErrorSummary\";\r\nimport { flattenFormikErrors } from \"../utils/formikErrors\";\r\n\r\n/**\r\n * FormikErrorSummary — Portnet UI v2 (pattern)\r\n *\r\n * Charter §04.1 R-FV.2 / §05 R-4.2 MUST — \"Submit échoué → bandeau de synthèse\r\n * en haut du formulaire\". The Formik bridge for `FormErrorSummary`, and the\r\n * companion of `FormikErrorFocus`: that one puts the caret in the first field\r\n * in error, this one lists them all with jump-links.\r\n *\r\n *   <Formik …>\r\n *     <Form>\r\n *       <FormikErrorSummary\r\n *         labelByName={{ numeroFormule: \"N° de formule\", montant: \"Montant\" }}\r\n *         onItemClick={focusFieldByName}\r\n *       />\r\n *       …fields…\r\n *     </Form>\r\n *   </Formik>\r\n *\r\n * ── WHY THIS EXISTS (ms-ti-fe, Area 11) ─────────────────────────────\r\n *\r\n * The library owned all three parts of the failed-submit recipe and no way to\r\n * assemble them inside the prevailing form shape:\r\n *\r\n *   · `FormErrorSummary`   — renders the banner, takes a flat list;\r\n *   · `flattenFormikErrors`— produces that list from Formik's error tree (G-38);\r\n *   · `focusFieldByName`   — resolves an item's name to a control (R-FV.3).\r\n *\r\n * Reaching `errors` and `submitCount` requires the Formik CONTEXT, and modules\r\n * overwhelmingly write `<Formik><Form>…</Form></Formik>` with STATIC children:\r\n * the hosting component's body sits OUTSIDE the provider, so it cannot call\r\n * `useFormikContext`, and `innerRef` does not help — mutating a ref does not\r\n * re-render the holder when `errors` changes. Each host therefore had to either\r\n * convert its form to a render-prop purely to reach the errors, or write a\r\n * local null-rendering context reader.\r\n *\r\n * ms-ti-fe has ELEVEN Formik forms. ONE had the banner; wiring the other ten\r\n * meant ten copies of that wrapper. `FormikErrorFocus` exists for precisely\r\n * this reason on the sibling rule, which is why field adoption of the two\r\n * MUSTs diverged so sharply — 1 of 11 for R-FV.2 against 0 of 11 for R-FV.3,\r\n * the one with a bridge being the one nobody could apply without boilerplate.\r\n *\r\n * GOVERNANCE NOTE. This is a BRIDGE over an already-certified component — the\r\n * thirteenth, after FormikInput / Select / Combobox / DatePicker /\r\n * DateTimePicker / Textarea / File / Checkbox / CheckboxGroup / RadioGroup /\r\n * ReferentielField / ErrorFocus. It renders no markup of its own, introduces no\r\n * design decision, and adds no token. If the DS team holds that even a bridge\r\n * takes the §10.2 component-proposal path, treat this file as the proposal.\r\n */\r\nexport interface FormikErrorSummaryProps {\r\n  /**\r\n   * Field name → human label. Without it the banner lists RAW field paths\r\n   * (`donneesTI.categorieTitre`), which satisfies R-FV.2's letter and fails\r\n   * R-4.4's intent (\"messages actionnables\"). Supply it.\r\n   */\r\n  labelByName?: Record<string, string> | undefined;\r\n  /**\r\n   * Jump-to-field behaviour. Pass the exported `focusFieldByName` for a\r\n   * single-page form. Wrap it when the target may be on an unmounted wizard\r\n   * step or inside a collapsed section, so the owner opens first —\r\n   * `focusFieldByName` deliberately refuses a control with no client rects.\r\n   */\r\n  onItemClick?: ((name: string) => void) | undefined;\r\n  title?: string | undefined;\r\n  /**\r\n   * Hold the banner back until the first submit attempt, so a pristine form is\r\n   * not pre-scolded (R-I.4 — validate on blur, never on keystroke).\r\n   * @default true\r\n   */\r\n  afterSubmitOnly?: boolean | undefined;\r\n}\r\n\r\nfunction FormikErrorSummary({\r\n  labelByName,\r\n  onItemClick,\r\n  title,\r\n  afterSubmitOnly = true,\r\n}: FormikErrorSummaryProps) {\r\n  const { errors, submitCount } = useFormikContext<Record<string, unknown>>();\r\n\r\n  /* Recomputed only when the tree or the attempt count changes: the recursion\r\n   * walks every leaf, and a form rejected on submit re-renders on every\r\n   * keystroke that follows while the user fixes it. */\r\n  const flat = React.useMemo(() => flattenFormikErrors(errors), [errors]);\r\n\r\n  if (afterSubmitOnly && submitCount === 0) return null;\r\n\r\n  /* `FormErrorSummary` already returns null on an empty list, so mounting this\r\n   * unconditionally is safe and keeps the banner's appearance/disappearance in\r\n   * one place rather than duplicating the guard at every call site. */\r\n  return (\r\n    <FormErrorSummary\r\n      errors={flat}\r\n      {...(labelByName !== undefined ? { labelByName } : {})}\r\n      {...(onItemClick !== undefined ? { onItemClick } : {})}\r\n      {...(title !== undefined ? { title } : {})}\r\n    />\r\n  );\r\n}\r\n\r\nexport default FormikErrorSummary;\r\n"],"mappings":";;;;;;AAAA,IAAAA,KAAA,GAAAC,uBAAA,CAAAC,OAAA;AACA,IAAAC,OAAA,GAAAD,OAAA;AACA,IAAAE,iBAAA,GAAAC,sBAAA,CAAAH,OAAA;AACA,IAAAI,aAAA,GAAAJ,OAAA;AAA4D,IAAAK,WAAA,GAAAL,OAAA;AAAA,SAAAG,uBAAAG,CAAA,WAAAA,CAAA,IAAAA,CAAA,CAAAC,UAAA,GAAAD,CAAA,KAAAE,OAAA,EAAAF,CAAA;AAAA,SAAAP,wBAAAO,CAAA,EAAAG,CAAA,6BAAAC,OAAA,MAAAC,CAAA,OAAAD,OAAA,IAAAE,CAAA,OAAAF,OAAA,YAAAX,uBAAA,YAAAA,CAAAO,CAAA,EAAAG,CAAA,SAAAA,CAAA,IAAAH,CAAA,IAAAA,CAAA,CAAAC,UAAA,SAAAD,CAAA,MAAAO,CAAA,EAAAC,CAAA,EAAAC,CAAA,KAAAC,SAAA,QAAAR,OAAA,EAAAF,CAAA,iBAAAA,CAAA,uBAAAA,CAAA,yBAAAA,CAAA,SAAAS,CAAA,MAAAF,CAAA,GAAAJ,CAAA,GAAAG,CAAA,GAAAD,CAAA,QAAAE,CAAA,CAAAI,GAAA,CAAAX,CAAA,UAAAO,CAAA,CAAAK,GAAA,CAAAZ,CAAA,GAAAO,CAAA,CAAAM,GAAA,CAAAb,CAAA,EAAAS,CAAA,gBAAAN,CAAA,IAAAH,CAAA,gBAAAG,CAAA,OAAAW,cAAA,CAAAC,IAAA,CAAAf,CAAA,EAAAG,CAAA,OAAAK,CAAA,IAAAD,CAAA,GAAAS,MAAA,CAAAC,cAAA,KAAAD,MAAA,CAAAE,wBAAA,CAAAlB,CAAA,EAAAG,CAAA,OAAAK,CAAA,CAAAI,GAAA,IAAAJ,CAAA,CAAAK,GAAA,IAAAN,CAAA,CAAAE,CAAA,EAAAN,CAAA,EAAAK,CAAA,IAAAC,CAAA,CAAAN,CAAA,IAAAH,CAAA,CAAAG,CAAA,WAAAM,CAAA,KAAAT,CAAA,EAAAG,CAAA;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;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAwBA,SAASgB,kBAAkBA,CAAC;EAC1BC,WAAW;EACXC,WAAW;EACXC,KAAK;EACLC,eAAe,GAAG;AACK,CAAC,EAAE;EAC1B,MAAM;IAAEC,MAAM;IAAEC;EAAY,CAAC,GAAG,IAAAC,wBAAgB,EAA0B,CAAC;;EAE3E;AACF;AACA;EACE,MAAMC,IAAI,GAAGnC,KAAK,CAACoC,OAAO,CAAC,MAAM,IAAAC,iCAAmB,EAACL,MAAM,CAAC,EAAE,CAACA,MAAM,CAAC,CAAC;EAEvE,IAAID,eAAe,IAAIE,WAAW,KAAK,CAAC,EAAE,OAAO,IAAI;;EAErD;AACF;AACA;EACE,oBACE,IAAA1B,WAAA,CAAA+B,GAAA,EAAClC,iBAAA,CAAAM,OAAgB;IACfsB,MAAM,EAAEG,IAAK;IAAA,IACRP,WAAW,KAAKW,SAAS,GAAG;MAAEX;IAAY,CAAC,GAAG,CAAC,CAAC;IAAA,IAChDC,WAAW,KAAKU,SAAS,GAAG;MAAEV;IAAY,CAAC,GAAG,CAAC,CAAC;IAAA,IAChDC,KAAK,KAAKS,SAAS,GAAG;MAAET;IAAM,CAAC,GAAG,CAAC,CAAC;EAAA,CAC1C,CAAC;AAEN;AAAC,IAAAU,QAAA,GAAAC,OAAA,CAAA/B,OAAA,GAEciB,kBAAkB","ignoreList":[]}

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

@@ -37,7 +37,20 @@ export interface FormikFileProps extends Omit<DropzoneProps, "value" | "onAdd" |
     disabled?: boolean | undefined;
     mode?: FormikFileMode | undefined;
     companionFields?: FormikFileCompanionFields | undefined;
+    /**
+     * Id given to the control, and the target of the label's `htmlFor`.
+     * Defaults to `name` (P-2).
+     *
+     * This is what makes the field reachable by `focusFieldByName`, and so by
+     * `FormikErrorFocus` after a failed submit (R-F.3). Without it Field falls
+     * back to a `useId` value — stable, but not derivable from the field name,
+     * so [id=…] cannot be resolved and the field is silently skipped.
+     *
+     * Override only if the id must match something external, and keep it in
+     * step with FormikErrorFocus's `order`, which addresses fields by `name`.
+     */
+    htmlFor?: string | undefined;
 }
-declare const FormikFile: ({ name, label, hint, accept, maxSize, required, disabled, mode, companionFields, ...rest }: FormikFileProps) => React.JSX.Element;
+declare const FormikFile: ({ name, label, hint, accept, maxSize, required, disabled, mode, companionFields, htmlFor, ...rest }: FormikFileProps) => React.JSX.Element;
 export default FormikFile;
 //# sourceMappingURL=FormikFile.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"FormikFile.d.ts","sourceRoot":"","sources":["../../../src/lib/v2/patterns/FormikFile.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAI/B,OAAO,KAAK,EAAgB,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAE1E,MAAM,MAAM,cAAc,GAAG,QAAQ,GAAG,MAAM,CAAC;AAE/C,MAAM,WAAW,yBAAyB;IACxC,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,eACf,SAAQ,IAAI,CACV,aAAa,EACb,OAAO,GAAG,OAAO,GAAG,UAAU,GAAG,UAAU,GAAG,QAAQ,GAAG,SAAS,GAAG,MAAM,GAAG,UAAU,GAAG,OAAO,CACnG;IACD,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,KAAK,CAAC,SAAS,GAAG,SAAS,CAAC;IACpC,IAAI,CAAC,EAAE,KAAK,CAAC,SAAS,GAAG,SAAS,CAAC;IACnC,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC5B,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC7B,QAAQ,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAC/B,QAAQ,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAC/B,IAAI,CAAC,EAAE,cAAc,GAAG,SAAS,CAAC;IAClC,eAAe,CAAC,EAAE,yBAAyB,GAAG,SAAS,CAAC;CACzD;AAkBD,QAAA,MAAM,UAAU,GAAI,4FAWjB,eAAe,sBA0EjB,CAAC;AAEF,eAAe,UAAU,CAAC"}
+{"version":3,"file":"FormikFile.d.ts","sourceRoot":"","sources":["../../../src/lib/v2/patterns/FormikFile.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAI/B,OAAO,KAAK,EAAgB,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAE1E,MAAM,MAAM,cAAc,GAAG,QAAQ,GAAG,MAAM,CAAC;AAE/C,MAAM,WAAW,yBAAyB;IACxC,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,eACf,SAAQ,IAAI,CACV,aAAa,EACb,OAAO,GAAG,OAAO,GAAG,UAAU,GAAG,UAAU,GAAG,QAAQ,GAAG,SAAS,GAAG,MAAM,GAAG,UAAU,GAAG,OAAO,CACnG;IACD,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,KAAK,CAAC,SAAS,GAAG,SAAS,CAAC;IACpC,IAAI,CAAC,EAAE,KAAK,CAAC,SAAS,GAAG,SAAS,CAAC;IACnC,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC5B,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC7B,QAAQ,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAC/B,QAAQ,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAC/B,IAAI,CAAC,EAAE,cAAc,GAAG,SAAS,CAAC;IAClC,eAAe,CAAC,EAAE,yBAAyB,GAAG,SAAS,CAAC;IACxD;;;;;;;;;;;OAWG;IACH,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAC9B;AAiDD,QAAA,MAAM,UAAU,GAAI,qGAYjB,eAAe,sBAgFjB,CAAC;AAEF,eAAe,UAAU,CAAC"}

package/dist/v2/patterns/FormikFile.js

@@ -1,16 +1,16 @@
 "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;
+exports.default = void 0;
 var React = _interopRequireWildcard(require("react"));
 var _formik = require("formik");
 var _Field = _interopRequireDefault(require("../components/Field"));
 var _Dropzone = _interopRequireDefault(require("../components/Dropzone"));
 var _jsxRuntime = require("react/jsx-runtime");
-var _excluded = ["name", "label", "hint", "accept", "maxSize", "required", "disabled", "mode", "companionFields"];
+function _interopRequireDefault(e) { return e && e.__esModule ? e : { default: e }; }
+function _interopRequireWildcard(e, t) { if ("function" == typeof WeakMap) var r = new WeakMap(), n = new WeakMap(); return (_interopRequireWildcard = function (e, t) { if (!t && e && e.__esModule) return e; var o, i, f = { __proto__: null, default: e }; if (null === e || "object" != typeof e && "function" != typeof e) return f; if (o = t ? n : r) { if (o.has(e)) return o.get(e); o.set(e, f); } for (const t in e) "default" !== t && {}.hasOwnProperty.call(e, t) && ((i = (o = Object.defineProperty) && Object.getOwnPropertyDescriptor(e, t)) && (i.get || i.set) ? o(f, t, i) : f[t] = e[t]); return f; })(e, t); }
 /**
  * FormikFile — bridge between Formik state and v2.Dropzone.
  *
@@ -31,126 +31,142 @@ var _excluded = ["name", "label", "hint", "accept", "maxSize", "required", "disa
  *
  * Charter R-FU.*. Peer dep: formik >= 2.x.
  */
-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; }
-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; }
-var DEFAULT_COMPANION_FIELDS = Object.freeze({
+
+const DEFAULT_COMPANION_FIELDS = Object.freeze({
   ext: "fileExtension",
   size: "fileSize",
   type: "fileType",
   name: "nom"
 });
 
-/* v2.Dropzone displays a row per entry in `value`. We synthesise
-   the row shape from the File object held in Formik. We use
-   `file.name` as the id since File has no stable identifier of
-   its own — Dropzone passes this id back to onRemove. */
-var toDropzoneShape = function toDropzoneShape(file) {
+/* ── Surrogate file ids (defect D-2) ──────────────────────────────────
+ *
+ * A File carries no stable identifier, and this bridge previously used
+ * `file.name` as the Dropzone entry id — with `handleRemove` filtering the
+ * array by that same name. Two files called "facture.pdf" therefore shared a
+ * React key AND removing either one removed BOTH, silently.
+ *
+ * That is not an edge case: scans, exports and generated documents routinely
+ * arrive with generic names, so a user attaching two scans from different
+ * folders hits it immediately. A host could not work around it either, since
+ * the id was synthesised in here with nowhere to inject a key.
+ *
+ * A WeakMap keyed by the File OBJECT fixes all of it:
+ *   - two files with the same name are different objects → different ids;
+ *   - the same File across re-renders is the same object → the same id, so
+ *     React keys stay stable and rows do not remount while uploading;
+ *   - entries die with the File, so there is nothing to clean up.
+ *
+ * The id is opaque to Dropzone (it hands it straight back to onRemove) and is
+ * session-scoped — never persisted, never sent anywhere.
+ */
+const FILE_IDS = new WeakMap();
+let fileIdSeq = 0;
+const idFor = file => {
+  const existing = FILE_IDS.get(file);
+  if (existing !== undefined) return existing;
+  fileIdSeq += 1;
+  const id = `pui-file-${fileIdSeq}`;
+  FILE_IDS.set(file, id);
+  return id;
+};
+
+/* v2.Dropzone displays a row per entry in `value`. We synthesise the row
+   shape from the File held in Formik, with a surrogate id (see above). */
+const toDropzoneShape = file => {
   if (file == null || !(file instanceof File)) return null;
   return {
-    id: file.name,
+    id: idFor(file),
     name: file.name,
     size: file.size
   };
 };
-var FormikFile = function FormikFile(_ref) {
-  var name = _ref.name,
-    label = _ref.label,
-    hint = _ref.hint,
-    accept = _ref.accept,
-    maxSize = _ref.maxSize,
-    required = _ref.required,
-    disabled = _ref.disabled,
-    _ref$mode = _ref.mode,
-    mode = _ref$mode === void 0 ? "single" : _ref$mode,
-    _ref$companionFields = _ref.companionFields,
-    companionFields = _ref$companionFields === void 0 ? DEFAULT_COMPANION_FIELDS : _ref$companionFields,
-    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 isBulk = mode === "bulk";
-  var value = (isBulk ? (Array.isArray(field.value) ? field.value : []).map(toDropzoneShape) : field.value instanceof File ? [toDropzoneShape(field.value)] : []).filter(function (x) {
-    return x != null;
-  });
-  var writeCompanions = function writeCompanions(file) {
+const FormikFile = ({
+  name,
+  label,
+  hint,
+  accept,
+  maxSize,
+  required,
+  disabled,
+  mode = "single",
+  companionFields = DEFAULT_COMPANION_FIELDS,
+  htmlFor,
+  ...rest
+}) => {
+  const [field, meta] = (0, _formik.useField)(name);
+  const {
+    setFieldValue,
+    setFieldTouched
+  } = (0, _formik.useFormikContext)();
+  const hasError = Boolean(meta.touched && meta.error);
+  const isBulk = mode === "bulk";
+  const value = (isBulk ? (Array.isArray(field.value) ? field.value : []).map(toDropzoneShape) : field.value instanceof File ? [toDropzoneShape(field.value)] : []).filter(x => x != null);
+  const writeCompanions = file => {
     if (isBulk) return;
     setFieldValue(companionFields.ext, file ? file.name.split(".").pop() : "");
     setFieldValue(companionFields.size, file ? file.size : null);
     setFieldValue(companionFields.type, file ? file.type : "");
     setFieldValue(companionFields.name, file ? file.name : "");
   };
-  var handleAdd = function handleAdd(files) {
+  const handleAdd = files => {
     if (!files || files.length === 0) return;
     if (isBulk) {
-      var merged = [].concat(_toConsumableArray(Array.isArray(field.value) ? field.value : []), _toConsumableArray(files));
+      const merged = [...(Array.isArray(field.value) ? field.value : []), ...files];
       setFieldValue(name, merged);
       setFieldTouched(name, true, false);
     } else {
-      var file = files[0];
+      const file = files[0];
       setFieldValue(name, file);
-      writeCompanions(file !== null && file !== void 0 ? file : null);
+      writeCompanions(file ?? null);
       setFieldTouched(name, true, false);
     }
   };
 
-  /* Dropzone calls onRemove(id). In single mode the id was the
-     File's name; in bulk mode we filter by the same key. */
-  var handleRemove = function handleRemove(id) {
+  /* Dropzone calls onRemove(id) with the surrogate id issued above. In bulk
+     mode we resolve each entry through the same WeakMap so two files sharing
+     a name are distinguished; non-File entries are left untouched, preserving
+     the defensive tolerance for a malformed array. */
+  const handleRemove = id => {
     if (isBulk) {
-      var remaining = (Array.isArray(field.value) ? field.value : []).filter(function (f) {
-        return f.name !== id;
-      });
+      const remaining = (Array.isArray(field.value) ? field.value : []).filter(f => !(f instanceof File) || idFor(f) !== id);
       setFieldValue(name, remaining);
     } else {
       setFieldValue(name, null);
       writeCompanions(null);
     }
   };
-  return /*#__PURE__*/(0, _jsxRuntime.jsx)(_Field["default"], _objectSpread(_objectSpread(_objectSpread({
+  return /*#__PURE__*/(0, _jsxRuntime.jsx)(_Field.default, {
     label: label,
     error: hasError ? meta.error : null
-  }, required !== undefined ? {
-    required: required
-  } : {}), disabled !== undefined ? {
-    disabled: disabled
-  } : {}), {}, {
-    children: /*#__PURE__*/(0, _jsxRuntime.jsx)(_Dropzone["default"], _objectSpread(_objectSpread(_objectSpread(_objectSpread({
+    /* P-2 — a predictable id, so focusFieldByName can resolve [id=…] and
+       FormikErrorFocus can reach this field after a failed submit. Matches
+       FormikInput / FormikSelect / FormikCombobox. */,
+    htmlFor: htmlFor || name,
+    ...(required !== undefined ? {
+      required
+    } : {}),
+    ...(disabled !== undefined ? {
+      disabled
+    } : {}),
+    children: /*#__PURE__*/(0, _jsxRuntime.jsx)(_Dropzone.default, {
       multiple: isBulk,
       value: value,
       hint: hint,
       onAdd: handleAdd,
-      onRemove: handleRemove
-    }, rest), accept !== undefined ? {
-      accept: accept
-    } : {}), disabled !== undefined ? {
-      disabled: disabled
-    } : {}), maxSize !== undefined ? {
-      maxSize: maxSize
-    } : {}))
-  }));
+      onRemove: handleRemove,
+      ...rest,
+      ...(accept !== undefined ? {
+        accept
+      } : {}),
+      ...(disabled !== undefined ? {
+        disabled
+      } : {}),
+      ...(maxSize !== undefined ? {
+        maxSize
+      } : {})
+    })
+  });
 };
-var _default = exports["default"] = FormikFile;
+var _default = exports.default = FormikFile;
 //# sourceMappingURL=FormikFile.js.map