@portnet/ui 6.0.1 → 6.0.3

package/dist/v2/__tests__/DrawerTactileTargets.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"DrawerTactileTargets.test.js","names":["require","_react","_Drawer","_interopRequireDefault","_tokens","_jsxRuntime","e","__esModule","default","TACTILE_MIN","layout","tactileMin","TACTILE_FLOOR","minWidth","minHeight","describe","it","render","jsx","open","onClose","undefined","title","children","expect","screen","getByRole","name","toHaveStyle","onPrev","onNext","hasPrev","hasNext","previous","toBeDisabled"],"sources":["../../../src/lib/v2/__tests__/DrawerTactileTargets.test.tsx"],"sourcesContent":["import \"@testing-library/jest-dom\";\r\nimport { render, screen } from \"@testing-library/react\";\r\n\r\nimport Drawer from \"../components/Drawer\";\r\nimport { layout } from \"../tokens\";\r\n\r\n/**\r\n * R-7.4 / WCAG 2.5.5 — the drawer header's icon-only buttons.\r\n *\r\n * `tokens/density` states the rule this file guards, in its own words: \"Icon-\r\n * only buttons MUST set min-width/min-height to `tactileMin`\", because the\r\n * VISUAL height of a button may drop below 44px in the tighter density tiers\r\n * while the hit area may not. The drawer header's three buttons — prev, next,\r\n * close — were `IconButton size=\"small\"` with only a colour rule: about 34px,\r\n * ten short of the floor this library imposes on its hosts.\r\n *\r\n * The gap stayed invisible while item navigation was rarely wired, since a\r\n * filter panel renders the close button alone. A module that equips its\r\n * preview drawers with onPrev/onNext exposes three per drawer — which is what\r\n * surfaced it.\r\n *\r\n * ── WHY `toHaveStyle` AND NOT `element.style` ────────────────────────\r\n *\r\n * The first version of this file asserted on `element.style.minWidth` and\r\n * failed on all three cases with an empty string — correctly. `sx` compiles to\r\n * an EMOTION CLASS, never to an inline style attribute, so the inline bag is\r\n * empty by construction. `toHaveStyle` resolves the declaration through\r\n * `getComputedStyle`, which jsdom does cascade from the injected stylesheet.\r\n *\r\n * What this verifies is therefore the DECLARED floor, not a rendered box:\r\n * jsdom performs no layout, so no assertion here could prove the button\r\n * measures 44px on screen. The declaration is what the rule asks for, and it\r\n * is what a refactor of this header would silently drop.\r\n */\r\n\r\nconst TACTILE_MIN = `${layout.tactileMin}px`;\r\nconst TACTILE_FLOOR = { minWidth: TACTILE_MIN, minHeight: TACTILE_MIN };\r\n\r\ndescribe(\"Drawer — cibles tactiles de l'en-tête (R-7.4)\", () => {\r\n  it(\"plancher de 44px sur le bouton de fermeture\", () => {\r\n    render(\r\n      <Drawer open onClose={() => undefined} title=\"Filtres avancés\">\r\n        contenu\r\n      </Drawer>\r\n    );\r\n\r\n    expect(screen.getByRole(\"button\", { name: /Fermer/i })).toHaveStyle(\r\n      TACTILE_FLOOR\r\n    );\r\n  });\r\n\r\n  /* Les deux flèches ne sont rendues que si un gestionnaire est fourni\r\n     (navigation opt-in, D-A10.2) — c'est ce qui a longtemps masqué l'écart. */\r\n  it(\"plancher de 44px sur les deux flèches de navigation\", () => {\r\n    render(\r\n      <Drawer\r\n        open\r\n        onClose={() => undefined}\r\n        title=\"Dossier 2026-IM-00042\"\r\n        onPrev={() => undefined}\r\n        onNext={() => undefined}\r\n        hasPrev\r\n        hasNext\r\n      >\r\n        contenu\r\n      </Drawer>\r\n    );\r\n\r\n    expect(screen.getByRole(\"button\", { name: /Précédent/i })).toHaveStyle(\r\n      TACTILE_FLOOR\r\n    );\r\n    expect(screen.getByRole(\"button\", { name: /Suivant/i })).toHaveStyle(\r\n      TACTILE_FLOOR\r\n    );\r\n  });\r\n\r\n  /* Le plancher vaut aussi pour un bouton DÉSACTIVÉ : il reste une cible que\r\n     l'utilisateur va viser, et le rendre plus petit que les autres ferait\r\n     sauter la rangée d'un tiroir à l'autre. */\r\n  it(\"plancher maintenu quand la navigation est désactivée\", () => {\r\n    render(\r\n      <Drawer\r\n        open\r\n        onClose={() => undefined}\r\n        title=\"Dossier unique\"\r\n        onPrev={() => undefined}\r\n        onNext={() => undefined}\r\n      >\r\n        contenu\r\n      </Drawer>\r\n    );\r\n\r\n    const previous = screen.getByRole(\"button\", { name: /Précédent/i });\r\n    expect(previous).toBeDisabled();\r\n    expect(previous).toHaveStyle(TACTILE_FLOOR);\r\n  });\r\n});\r\n"],"mappings":";;AAAAA,OAAA;AACA,IAAAC,MAAA,GAAAD,OAAA;AAEA,IAAAE,OAAA,GAAAC,sBAAA,CAAAH,OAAA;AACA,IAAAI,OAAA,GAAAJ,OAAA;AAAmC,IAAAK,WAAA,GAAAL,OAAA;AAAA,SAAAG,uBAAAG,CAAA,WAAAA,CAAA,IAAAA,CAAA,CAAAC,UAAA,GAAAD,CAAA,KAAAE,OAAA,EAAAF,CAAA;AAEnC;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,GAEA,MAAMG,WAAW,GAAG,GAAGC,cAAM,CAACC,UAAU,IAAI;AAC5C,MAAMC,aAAa,GAAG;EAAEC,QAAQ,EAAEJ,WAAW;EAAEK,SAAS,EAAEL;AAAY,CAAC;AAEvEM,QAAQ,CAAC,+CAA+C,EAAE,MAAM;EAC9DC,EAAE,CAAC,6CAA6C,EAAE,MAAM;IACtD,IAAAC,aAAM,eACJ,IAAAZ,WAAA,CAAAa,GAAA,EAAChB,OAAA,CAAAM,OAAM;MAACW,IAAI;MAACC,OAAO,EAAEA,CAAA,KAAMC,SAAU;MAACC,KAAK,EAAC,oBAAiB;MAAAC,QAAA,EAAC;IAE/D,CAAQ,CACV,CAAC;IAEDC,MAAM,CAACC,aAAM,CAACC,SAAS,CAAC,QAAQ,EAAE;MAAEC,IAAI,EAAE;IAAU,CAAC,CAAC,CAAC,CAACC,WAAW,CACjEhB,aACF,CAAC;EACH,CAAC,CAAC;;EAEF;AACF;EACEI,EAAE,CAAC,qDAAqD,EAAE,MAAM;IAC9D,IAAAC,aAAM,eACJ,IAAAZ,WAAA,CAAAa,GAAA,EAAChB,OAAA,CAAAM,OAAM;MACLW,IAAI;MACJC,OAAO,EAAEA,CAAA,KAAMC,SAAU;MACzBC,KAAK,EAAC,uBAAuB;MAC7BO,MAAM,EAAEA,CAAA,KAAMR,SAAU;MACxBS,MAAM,EAAEA,CAAA,KAAMT,SAAU;MACxBU,OAAO;MACPC,OAAO;MAAAT,QAAA,EACR;IAED,CAAQ,CACV,CAAC;IAEDC,MAAM,CAACC,aAAM,CAACC,SAAS,CAAC,QAAQ,EAAE;MAAEC,IAAI,EAAE;IAAa,CAAC,CAAC,CAAC,CAACC,WAAW,CACpEhB,aACF,CAAC;IACDY,MAAM,CAACC,aAAM,CAACC,SAAS,CAAC,QAAQ,EAAE;MAAEC,IAAI,EAAE;IAAW,CAAC,CAAC,CAAC,CAACC,WAAW,CAClEhB,aACF,CAAC;EACH,CAAC,CAAC;;EAEF;AACF;AACA;EACEI,EAAE,CAAC,sDAAsD,EAAE,MAAM;IAC/D,IAAAC,aAAM,eACJ,IAAAZ,WAAA,CAAAa,GAAA,EAAChB,OAAA,CAAAM,OAAM;MACLW,IAAI;MACJC,OAAO,EAAEA,CAAA,KAAMC,SAAU;MACzBC,KAAK,EAAC,gBAAgB;MACtBO,MAAM,EAAEA,CAAA,KAAMR,SAAU;MACxBS,MAAM,EAAEA,CAAA,KAAMT,SAAU;MAAAE,QAAA,EACzB;IAED,CAAQ,CACV,CAAC;IAED,MAAMU,QAAQ,GAAGR,aAAM,CAACC,SAAS,CAAC,QAAQ,EAAE;MAAEC,IAAI,EAAE;IAAa,CAAC,CAAC;IACnEH,MAAM,CAACS,QAAQ,CAAC,CAACC,YAAY,CAAC,CAAC;IAC/BV,MAAM,CAACS,QAAQ,CAAC,CAACL,WAAW,CAAChB,aAAa,CAAC;EAC7C,CAAC,CAAC;AACJ,CAAC,CAAC","ignoreList":[]}

package/dist/v2/__tests__/FieldError.test.js

@@ -1,15 +1,11 @@
 "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); }
 require("@testing-library/jest-dom");
-var React = _interopRequireWildcard(require("react"));
-var _react2 = require("@testing-library/react");
+var _react = require("@testing-library/react");
 var _FieldError = _interopRequireDefault(require("../components/FieldError"));
 var _Field = _interopRequireDefault(require("../components/Field"));
 var _jsxRuntime = require("react/jsx-runtime");
-function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { "default": obj }; }
-function _getRequireWildcardCache(nodeInterop) { if (typeof WeakMap !== "function") return null; var cacheBabelInterop = new WeakMap(); var cacheNodeInterop = new WeakMap(); return (_getRequireWildcardCache = function _getRequireWildcardCache(nodeInterop) { return nodeInterop ? cacheNodeInterop : cacheBabelInterop; })(nodeInterop); }
-function _interopRequireWildcard(obj, nodeInterop) { if (!nodeInterop && obj && obj.__esModule) { return obj; } if (obj === null || _typeof(obj) !== "object" && typeof obj !== "function") { return { "default": obj }; } var cache = _getRequireWildcardCache(nodeInterop); if (cache && cache.has(obj)) { return cache.get(obj); } var newObj = {}; var hasPropertyDescriptor = Object.defineProperty && Object.getOwnPropertyDescriptor; for (var key in obj) { if (key !== "default" && Object.prototype.hasOwnProperty.call(obj, key)) { var desc = hasPropertyDescriptor ? Object.getOwnPropertyDescriptor(obj, key) : null; if (desc && (desc.get || desc.set)) { Object.defineProperty(newObj, key, desc); } else { newObj[key] = obj[key]; } } } newObj["default"] = obj; if (cache) { cache.set(obj, newObj); } return newObj; }
+function _interopRequireDefault(e) { return e && e.__esModule ? e : { default: e }; }
 /**
  * FieldError — contract tests, including its integration into Field.
  *
@@ -34,131 +30,164 @@ function _interopRequireWildcard(obj, nodeInterop) { if (!nodeInterop && obj &&
  * resolves neither CSS variables nor flexbox, so asserting them here would pass
  * while the message rendered black and centred. Those live in
  * FieldError.stories.tsx.
- */describe("FieldError — standalone", function () {
-  test("announces itself as an alert carrying the message", function () {
-    (0, _react2.render)(/*#__PURE__*/(0, _jsxRuntime.jsx)(_FieldError["default"], {
+ */
+
+/**
+ * Fixture : un champ minimal qui CONSOMME les props que `Field` diffuse.
+ *
+ * `Field` clone son enfant avec `error` et `fullWidth` — délibérément, parce
+ * que plusieurs entrées v2 (`NumberInput`, le `renderInput` de `Combobox`) ne
+ * sont pas de purs enfants MUI et lisent ces props directement. Un `<input />`
+ * NU les laisse donc filer jusqu'au DOM, et React émet deux avertissements à
+ * chaque rendu : « Received `true` for a non-boolean attribute `error` » et
+ * « React does not recognize the `fullWidth` prop on a DOM element ».
+ *
+ * Ce n'est PAS un défaut de `Field` : en production l'enfant est un `Input` ou
+ * un `Select` du socle, qui consomme ces props. Mais c'était six
+ * avertissements dans la sortie de la suite, au milieu desquels un vrai
+ * avertissement passe inaperçu — et un audit du socle a effectivement pris ce
+ * bruit pour une fuite de props en production avant de lire le composant.
+ *
+ * La fixture reste volontairement minimale : pas d'`Input` du socle ici, ce
+ * fichier teste le CÂBLAGE de `Field` et non l'intégration d'un composant. Elle
+ * ne fait qu'absorber les deux props destinées à un contrôle riche.
+ */function BareInput({
+  error: _error,
+  fullWidth: _fullWidth,
+  ...rest
+}) {
+  return /*#__PURE__*/(0, _jsxRuntime.jsx)("input", {
+    ...rest
+  });
+}
+describe("FieldError — standalone", () => {
+  test("announces itself as an alert carrying the message", () => {
+    (0, _react.render)(/*#__PURE__*/(0, _jsxRuntime.jsx)(_FieldError.default, {
       children: "Ajoutez au moins un article avant de soumettre."
     }));
-    expect(_react2.screen.getByRole("alert")).toHaveTextContent("Ajoutez au moins un article avant de soumettre.");
+    expect(_react.screen.getByRole("alert")).toHaveTextContent("Ajoutez au moins un article avant de soumettre.");
   });
-  test("forwards id so a host can wire its own aria-describedby", function () {
-    (0, _react2.render)(/*#__PURE__*/(0, _jsxRuntime.jsx)(_FieldError["default"], {
+  test("forwards id so a host can wire its own aria-describedby", () => {
+    (0, _react.render)(/*#__PURE__*/(0, _jsxRuntime.jsx)(_FieldError.default, {
       id: "articles-error",
       children: "Ajoutez au moins un article."
     }));
-    expect(_react2.screen.getByRole("alert")).toHaveAttribute("id", "articles-error");
+    expect(_react.screen.getByRole("alert")).toHaveAttribute("id", "articles-error");
   });
-  test("omits id when none is supplied", function () {
+  test("omits id when none is supplied", () => {
     /* The list-level case usually has nothing to bind to. Emitting an empty or
      * generated id would create a describedby target nobody references. */
-    (0, _react2.render)(/*#__PURE__*/(0, _jsxRuntime.jsx)(_FieldError["default"], {
+    (0, _react.render)(/*#__PURE__*/(0, _jsxRuntime.jsx)(_FieldError.default, {
       children: "Ajoutez au moins un article."
     }));
-    expect(_react2.screen.getByRole("alert")).not.toHaveAttribute("id");
+    expect(_react.screen.getByRole("alert")).not.toHaveAttribute("id");
   });
-  test("the icon is hidden from assistive tech", function () {
+  test("the icon is hidden from assistive tech", () => {
     /* R-Ar.2 — the message IS the announcement; an announced glyph would double
      * it. No semantic query reaches a role-less, name-less element, hence the
      * testid the component exposes for exactly this assertion. */
-    (0, _react2.render)(/*#__PURE__*/(0, _jsxRuntime.jsx)(_FieldError["default"], {
+    (0, _react.render)(/*#__PURE__*/(0, _jsxRuntime.jsx)(_FieldError.default, {
       children: "Message"
     }));
-    expect(_react2.screen.getByTestId("fielderror-icon")).toHaveAttribute("aria-hidden", "true");
+    expect(_react.screen.getByTestId("fielderror-icon")).toHaveAttribute("aria-hidden", "true");
   });
 });
-describe("FieldError — inside Field (the wiring that has no visual tell)", function () {
-  test("the error becomes the control's accessible description", function () {
-    (0, _react2.render)(/*#__PURE__*/(0, _jsxRuntime.jsx)(_Field["default"], {
+describe("FieldError — inside Field (the wiring that has no visual tell)", () => {
+  test("the error becomes the control's accessible description", () => {
+    (0, _react.render)(/*#__PURE__*/(0, _jsxRuntime.jsx)(_Field.default, {
       label: "Num\xE9ro de titre",
       error: "Le num\xE9ro est invalide. Format : AAAA-IM-NNNNN.",
-      children: /*#__PURE__*/(0, _jsxRuntime.jsx)("input", {})
+      children: /*#__PURE__*/(0, _jsxRuntime.jsx)(BareInput, {})
     }));
-    expect(_react2.screen.getByRole("textbox")).toHaveAccessibleDescription("Le numéro est invalide. Format : AAAA-IM-NNNNN.");
+    expect(_react.screen.getByRole("textbox")).toHaveAccessibleDescription("Le numéro est invalide. Format : AAAA-IM-NNNNN.");
   });
-  test("the control is marked invalid", function () {
-    (0, _react2.render)(/*#__PURE__*/(0, _jsxRuntime.jsx)(_Field["default"], {
+  test("the control is marked invalid", () => {
+    (0, _react.render)(/*#__PURE__*/(0, _jsxRuntime.jsx)(_Field.default, {
       label: "Num\xE9ro",
       error: "Invalide.",
-      children: /*#__PURE__*/(0, _jsxRuntime.jsx)("input", {})
+      children: /*#__PURE__*/(0, _jsxRuntime.jsx)(BareInput, {})
     }));
     // jest-dom's toBeInvalid reads aria-invalid — R-I.3.
-    expect(_react2.screen.getByRole("textbox")).toBeInvalid();
+    expect(_react.screen.getByRole("textbox")).toBeInvalid();
   });
-  test("a host-supplied aria-describedby is PRESERVED, not replaced", function () {
+  test("a host-supplied aria-describedby is PRESERVED, not replaced", () => {
     /* The merge is the fragile part. Overwriting instead of merging silently
      * drops a consumer's external help text, and again nothing visual changes.
      * Asserted with two order-independent regexes rather than one exact string,
      * so the test does not encode which fragment Field puts first. */
-    (0, _react2.render)(/*#__PURE__*/(0, _jsxRuntime.jsxs)(_jsxRuntime.Fragment, {
+    (0, _react.render)(/*#__PURE__*/(0, _jsxRuntime.jsxs)(_jsxRuntime.Fragment, {
       children: [/*#__PURE__*/(0, _jsxRuntime.jsx)("span", {
         id: "host-help",
         children: "Format attendu : AAAA-IM-NNNNN."
-      }), /*#__PURE__*/(0, _jsxRuntime.jsx)(_Field["default"], {
+      }), /*#__PURE__*/(0, _jsxRuntime.jsx)(_Field.default, {
         label: "Num\xE9ro",
         error: "Le num\xE9ro est incomplet.",
-        children: /*#__PURE__*/(0, _jsxRuntime.jsx)("input", {
+        children: /*#__PURE__*/(0, _jsxRuntime.jsx)(BareInput, {
           "aria-describedby": "host-help"
         })
       })]
     }));
-    var input = _react2.screen.getByRole("textbox");
+    const input = _react.screen.getByRole("textbox");
     expect(input).toHaveAccessibleDescription(/Format attendu/);
     expect(input).toHaveAccessibleDescription(/incomplet/);
   });
-  test("the hint is suppressed while an error is shown", function () {
+  test("the hint is suppressed while an error is shown", () => {
     /* Two competing descriptions under one field is worse than one. The hint
      * returns once the error clears — verified by the rerender below. */
-    var _render = (0, _react2.render)(/*#__PURE__*/(0, _jsxRuntime.jsx)(_Field["default"], {
-        label: "Num\xE9ro",
-        hint: "Format : AAAA-IM-NNNNN",
-        error: "Le num\xE9ro est incomplet.",
-        children: /*#__PURE__*/(0, _jsxRuntime.jsx)("input", {})
-      })),
-      rerender = _render.rerender;
-    expect(_react2.screen.getByRole("alert")).toHaveTextContent("Le numéro est incomplet.");
-    expect(_react2.screen.queryByText("Format : AAAA-IM-NNNNN")).not.toBeInTheDocument();
-    rerender(/*#__PURE__*/(0, _jsxRuntime.jsx)(_Field["default"], {
+    const {
+      rerender
+    } = (0, _react.render)(/*#__PURE__*/(0, _jsxRuntime.jsx)(_Field.default, {
+      label: "Num\xE9ro",
+      hint: "Format : AAAA-IM-NNNNN",
+      error: "Le num\xE9ro est incomplet.",
+      children: /*#__PURE__*/(0, _jsxRuntime.jsx)(BareInput, {})
+    }));
+    expect(_react.screen.getByRole("alert")).toHaveTextContent("Le numéro est incomplet.");
+    expect(_react.screen.queryByText("Format : AAAA-IM-NNNNN")).not.toBeInTheDocument();
+    rerender(/*#__PURE__*/(0, _jsxRuntime.jsx)(_Field.default, {
       label: "Num\xE9ro",
       hint: "Format : AAAA-IM-NNNNN",
-      children: /*#__PURE__*/(0, _jsxRuntime.jsx)("input", {})
+      children: /*#__PURE__*/(0, _jsxRuntime.jsx)(BareInput, {})
     }));
-    expect(_react2.screen.getByText("Format : AAAA-IM-NNNNN")).toBeInTheDocument();
+    expect(_react.screen.getByText("Format : AAAA-IM-NNNNN")).toBeInTheDocument();
   });
 });
-describe("FieldError — live-region mounting contract", function () {
-  test("no alert exists until an error appears", function () {
+describe("FieldError — live-region mounting contract", () => {
+  test("no alert exists until an error appears", () => {
     /* THE contract. `role=\"alert\"` announces on INSERTION: an element mounted
      * permanently with empty content announces nothing when it later fills, so
      * a well-meaning refactor that always renders the container — to \"avoid
      * layout shift\", say — silently kills the announcement while every pixel
      * and every screenshot stays identical. */
-    var _render2 = (0, _react2.render)(/*#__PURE__*/(0, _jsxRuntime.jsx)(_Field["default"], {
-        label: "Num\xE9ro",
-        children: /*#__PURE__*/(0, _jsxRuntime.jsx)("input", {})
-      })),
-      rerender = _render2.rerender;
-    expect(_react2.screen.queryByRole("alert")).not.toBeInTheDocument();
-    rerender(/*#__PURE__*/(0, _jsxRuntime.jsx)(_Field["default"], {
+    const {
+      rerender
+    } = (0, _react.render)(/*#__PURE__*/(0, _jsxRuntime.jsx)(_Field.default, {
+      label: "Num\xE9ro",
+      children: /*#__PURE__*/(0, _jsxRuntime.jsx)(BareInput, {})
+    }));
+    expect(_react.screen.queryByRole("alert")).not.toBeInTheDocument();
+    rerender(/*#__PURE__*/(0, _jsxRuntime.jsx)(_Field.default, {
       label: "Num\xE9ro",
       error: "Le num\xE9ro est incomplet.",
-      children: /*#__PURE__*/(0, _jsxRuntime.jsx)("input", {})
+      children: /*#__PURE__*/(0, _jsxRuntime.jsx)(BareInput, {})
     }));
-    expect(_react2.screen.getByRole("alert")).toBeInTheDocument();
+    expect(_react.screen.getByRole("alert")).toBeInTheDocument();
   });
-  test("the alert unmounts when the error clears", function () {
-    var _render3 = (0, _react2.render)(/*#__PURE__*/(0, _jsxRuntime.jsx)(_Field["default"], {
-        label: "Num\xE9ro",
-        error: "Le num\xE9ro est incomplet.",
-        children: /*#__PURE__*/(0, _jsxRuntime.jsx)("input", {})
-      })),
-      rerender = _render3.rerender;
-    expect(_react2.screen.getByRole("alert")).toBeInTheDocument();
-    rerender(/*#__PURE__*/(0, _jsxRuntime.jsx)(_Field["default"], {
+  test("the alert unmounts when the error clears", () => {
+    const {
+      rerender
+    } = (0, _react.render)(/*#__PURE__*/(0, _jsxRuntime.jsx)(_Field.default, {
+      label: "Num\xE9ro",
+      error: "Le num\xE9ro est incomplet.",
+      children: /*#__PURE__*/(0, _jsxRuntime.jsx)(BareInput, {})
+    }));
+    expect(_react.screen.getByRole("alert")).toBeInTheDocument();
+    rerender(/*#__PURE__*/(0, _jsxRuntime.jsx)(_Field.default, {
       label: "Num\xE9ro",
-      children: /*#__PURE__*/(0, _jsxRuntime.jsx)("input", {})
+      children: /*#__PURE__*/(0, _jsxRuntime.jsx)(BareInput, {})
     }));
-    expect(_react2.screen.queryByRole("alert")).not.toBeInTheDocument();
-    expect(_react2.screen.getByRole("textbox")).not.toBeInvalid();
+    expect(_react.screen.queryByRole("alert")).not.toBeInTheDocument();
+    expect(_react.screen.getByRole("textbox")).not.toBeInvalid();
   });
 });
 //# sourceMappingURL=FieldError.test.js.map

package/dist/v2/__tests__/FieldError.test.js.map

@@ -1 +1 @@
-{"version":3,"file":"FieldError.test.js","names":["require","React","_interopRequireWildcard","_react2","_FieldError","_interopRequireDefault","_Field","_jsxRuntime","obj","__esModule","_getRequireWildcardCache","nodeInterop","WeakMap","cacheBabelInterop","cacheNodeInterop","_typeof","cache","has","get","newObj","hasPropertyDescriptor","Object","defineProperty","getOwnPropertyDescriptor","key","prototype","hasOwnProperty","call","desc","set","describe","test","render","jsx","children","expect","screen","getByRole","toHaveTextContent","id","toHaveAttribute","not","getByTestId","label","error","toHaveAccessibleDescription","toBeInvalid","jsxs","Fragment","input","_render","hint","rerender","queryByText","toBeInTheDocument","getByText","_render2","queryByRole","_render3"],"sources":["../../../src/lib/v2/__tests__/FieldError.test.tsx"],"sourcesContent":["import \"@testing-library/jest-dom\";\r\nimport * as React from \"react\";\r\nimport { render, screen } from \"@testing-library/react\";\r\nimport FieldError from \"../components/FieldError\";\r\nimport Field from \"../components/Field\";\r\n\r\n/**\r\n * FieldError — contract tests, including its integration into Field.\r\n *\r\n * WHY THIS FILE EXISTS\r\n * --------------------\r\n * §10.3 R-G.6 MUST. But the real reason is narrower and worth stating: the\r\n * contract this component carries is INVISIBLE. `Field` supplies an id, and that\r\n * id must reach the control's `aria-describedby` so a screen reader announces\r\n * the error when focus lands on the input. Break that wiring and NOTHING\r\n * changes: same pixels, same screenshot, same visual review — only a blind user\r\n * silently stops being told why their submit failed. There is no way to catch\r\n * that except by asserting it.\r\n *\r\n * The assertions below use `toHaveAccessibleDescription`, not id comparisons, on\r\n * purpose. It resolves aria-describedby to the text a screen reader would\r\n * actually announce, so the test states the USER-FACING outcome and stays true\r\n * if the id-generation scheme ever changes.\r\n *\r\n * NOT COVERED — deliberately\r\n * R-4.1's visual half (\"sous le champ, en rouge, avec icône\") and the\r\n * first-line icon alignment on a wrapping message are layout and colour. jsdom\r\n * resolves neither CSS variables nor flexbox, so asserting them here would pass\r\n * while the message rendered black and centred. Those live in\r\n * FieldError.stories.tsx.\r\n */\r\ndescribe(\"FieldError — standalone\", () => {\r\n  test(\"announces itself as an alert carrying the message\", () => {\r\n    render(<FieldError>Ajoutez au moins un article avant de soumettre.</FieldError>);\r\n    expect(screen.getByRole(\"alert\")).toHaveTextContent(\r\n      \"Ajoutez au moins un article avant de soumettre.\"\r\n    );\r\n  });\r\n\r\n  test(\"forwards id so a host can wire its own aria-describedby\", () => {\r\n    render(<FieldError id=\"articles-error\">Ajoutez au moins un article.</FieldError>);\r\n    expect(screen.getByRole(\"alert\")).toHaveAttribute(\"id\", \"articles-error\");\r\n  });\r\n\r\n  test(\"omits id when none is supplied\", () => {\r\n    /* The list-level case usually has nothing to bind to. Emitting an empty or\r\n     * generated id would create a describedby target nobody references. */\r\n    render(<FieldError>Ajoutez au moins un article.</FieldError>);\r\n    expect(screen.getByRole(\"alert\")).not.toHaveAttribute(\"id\");\r\n  });\r\n\r\n  test(\"the icon is hidden from assistive tech\", () => {\r\n    /* R-Ar.2 — the message IS the announcement; an announced glyph would double\r\n     * it. No semantic query reaches a role-less, name-less element, hence the\r\n     * testid the component exposes for exactly this assertion. */\r\n    render(<FieldError>Message</FieldError>);\r\n    expect(screen.getByTestId(\"fielderror-icon\")).toHaveAttribute(\"aria-hidden\", \"true\");\r\n  });\r\n});\r\n\r\ndescribe(\"FieldError — inside Field (the wiring that has no visual tell)\", () => {\r\n  test(\"the error becomes the control's accessible description\", () => {\r\n    render(\r\n      <Field label=\"Numéro de titre\" error=\"Le numéro est invalide. Format : AAAA-IM-NNNNN.\">\r\n        <input />\r\n      </Field>\r\n    );\r\n\r\n    expect(screen.getByRole(\"textbox\")).toHaveAccessibleDescription(\r\n      \"Le numéro est invalide. Format : AAAA-IM-NNNNN.\"\r\n    );\r\n  });\r\n\r\n  test(\"the control is marked invalid\", () => {\r\n    render(\r\n      <Field label=\"Numéro\" error=\"Invalide.\">\r\n        <input />\r\n      </Field>\r\n    );\r\n    // jest-dom's toBeInvalid reads aria-invalid — R-I.3.\r\n    expect(screen.getByRole(\"textbox\")).toBeInvalid();\r\n  });\r\n\r\n  test(\"a host-supplied aria-describedby is PRESERVED, not replaced\", () => {\r\n    /* The merge is the fragile part. Overwriting instead of merging silently\r\n     * drops a consumer's external help text, and again nothing visual changes.\r\n     * Asserted with two order-independent regexes rather than one exact string,\r\n     * so the test does not encode which fragment Field puts first. */\r\n    render(\r\n      <>\r\n        <span id=\"host-help\">Format attendu : AAAA-IM-NNNNN.</span>\r\n        <Field label=\"Numéro\" error=\"Le numéro est incomplet.\">\r\n          <input aria-describedby=\"host-help\" />\r\n        </Field>\r\n      </>\r\n    );\r\n\r\n    const input = screen.getByRole(\"textbox\");\r\n    expect(input).toHaveAccessibleDescription(/Format attendu/);\r\n    expect(input).toHaveAccessibleDescription(/incomplet/);\r\n  });\r\n\r\n  test(\"the hint is suppressed while an error is shown\", () => {\r\n    /* Two competing descriptions under one field is worse than one. The hint\r\n     * returns once the error clears — verified by the rerender below. */\r\n    const { rerender } = render(\r\n      <Field label=\"Numéro\" hint=\"Format : AAAA-IM-NNNNN\" error=\"Le numéro est incomplet.\">\r\n        <input />\r\n      </Field>\r\n    );\r\n\r\n    expect(screen.getByRole(\"alert\")).toHaveTextContent(\"Le numéro est incomplet.\");\r\n    expect(screen.queryByText(\"Format : AAAA-IM-NNNNN\")).not.toBeInTheDocument();\r\n\r\n    rerender(\r\n      <Field label=\"Numéro\" hint=\"Format : AAAA-IM-NNNNN\">\r\n        <input />\r\n      </Field>\r\n    );\r\n    expect(screen.getByText(\"Format : AAAA-IM-NNNNN\")).toBeInTheDocument();\r\n  });\r\n});\r\n\r\ndescribe(\"FieldError — live-region mounting contract\", () => {\r\n  test(\"no alert exists until an error appears\", () => {\r\n    /* THE contract. `role=\\\"alert\\\"` announces on INSERTION: an element mounted\r\n     * permanently with empty content announces nothing when it later fills, so\r\n     * a well-meaning refactor that always renders the container — to \\\"avoid\r\n     * layout shift\\\", say — silently kills the announcement while every pixel\r\n     * and every screenshot stays identical. */\r\n    const { rerender } = render(\r\n      <Field label=\"Numéro\">\r\n        <input />\r\n      </Field>\r\n    );\r\n    expect(screen.queryByRole(\"alert\")).not.toBeInTheDocument();\r\n\r\n    rerender(\r\n      <Field label=\"Numéro\" error=\"Le numéro est incomplet.\">\r\n        <input />\r\n      </Field>\r\n    );\r\n    expect(screen.getByRole(\"alert\")).toBeInTheDocument();\r\n  });\r\n\r\n  test(\"the alert unmounts when the error clears\", () => {\r\n    const { rerender } = render(\r\n      <Field label=\"Numéro\" error=\"Le numéro est incomplet.\">\r\n        <input />\r\n      </Field>\r\n    );\r\n    expect(screen.getByRole(\"alert\")).toBeInTheDocument();\r\n\r\n    rerender(\r\n      <Field label=\"Numéro\">\r\n        <input />\r\n      </Field>\r\n    );\r\n    expect(screen.queryByRole(\"alert\")).not.toBeInTheDocument();\r\n    expect(screen.getByRole(\"textbox\")).not.toBeInvalid();\r\n  });\r\n});\r\n"],"mappings":"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","ignoreList":[]}
+{"version":3,"file":"FieldError.test.js","names":["require","_react","_FieldError","_interopRequireDefault","_Field","_jsxRuntime","e","__esModule","default","BareInput","error","_error","fullWidth","_fullWidth","rest","jsx","describe","test","render","children","expect","screen","getByRole","toHaveTextContent","id","toHaveAttribute","not","getByTestId","label","toHaveAccessibleDescription","toBeInvalid","jsxs","Fragment","input","rerender","hint","queryByText","toBeInTheDocument","getByText","queryByRole"],"sources":["../../../src/lib/v2/__tests__/FieldError.test.tsx"],"sourcesContent":["import \"@testing-library/jest-dom\";\r\nimport { render, screen } from \"@testing-library/react\";\r\nimport type { InputHTMLAttributes } from \"react\";\r\nimport FieldError from \"../components/FieldError\";\r\nimport Field from \"../components/Field\";\r\n\r\n/**\r\n * FieldError — contract tests, including its integration into Field.\r\n *\r\n * WHY THIS FILE EXISTS\r\n * --------------------\r\n * §10.3 R-G.6 MUST. But the real reason is narrower and worth stating: the\r\n * contract this component carries is INVISIBLE. `Field` supplies an id, and that\r\n * id must reach the control's `aria-describedby` so a screen reader announces\r\n * the error when focus lands on the input. Break that wiring and NOTHING\r\n * changes: same pixels, same screenshot, same visual review — only a blind user\r\n * silently stops being told why their submit failed. There is no way to catch\r\n * that except by asserting it.\r\n *\r\n * The assertions below use `toHaveAccessibleDescription`, not id comparisons, on\r\n * purpose. It resolves aria-describedby to the text a screen reader would\r\n * actually announce, so the test states the USER-FACING outcome and stays true\r\n * if the id-generation scheme ever changes.\r\n *\r\n * NOT COVERED — deliberately\r\n * R-4.1's visual half (\"sous le champ, en rouge, avec icône\") and the\r\n * first-line icon alignment on a wrapping message are layout and colour. jsdom\r\n * resolves neither CSS variables nor flexbox, so asserting them here would pass\r\n * while the message rendered black and centred. Those live in\r\n * FieldError.stories.tsx.\r\n */\r\n\r\n/**\r\n * Fixture : un champ minimal qui CONSOMME les props que `Field` diffuse.\r\n *\r\n * `Field` clone son enfant avec `error` et `fullWidth` — délibérément, parce\r\n * que plusieurs entrées v2 (`NumberInput`, le `renderInput` de `Combobox`) ne\r\n * sont pas de purs enfants MUI et lisent ces props directement. Un `<input />`\r\n * NU les laisse donc filer jusqu'au DOM, et React émet deux avertissements à\r\n * chaque rendu : « Received `true` for a non-boolean attribute `error` » et\r\n * « React does not recognize the `fullWidth` prop on a DOM element ».\r\n *\r\n * Ce n'est PAS un défaut de `Field` : en production l'enfant est un `Input` ou\r\n * un `Select` du socle, qui consomme ces props. Mais c'était six\r\n * avertissements dans la sortie de la suite, au milieu desquels un vrai\r\n * avertissement passe inaperçu — et un audit du socle a effectivement pris ce\r\n * bruit pour une fuite de props en production avant de lire le composant.\r\n *\r\n * La fixture reste volontairement minimale : pas d'`Input` du socle ici, ce\r\n * fichier teste le CÂBLAGE de `Field` et non l'intégration d'un composant. Elle\r\n * ne fait qu'absorber les deux props destinées à un contrôle riche.\r\n */\r\nfunction BareInput({\r\n  error: _error,\r\n  fullWidth: _fullWidth,\r\n  ...rest\r\n}: InputHTMLAttributes<HTMLInputElement> & {\r\n  error?: boolean | undefined;\r\n  fullWidth?: boolean | undefined;\r\n}) {\r\n  return <input {...rest} />;\r\n}\r\n\r\ndescribe(\"FieldError — standalone\", () => {\r\n  test(\"announces itself as an alert carrying the message\", () => {\r\n    render(<FieldError>Ajoutez au moins un article avant de soumettre.</FieldError>);\r\n    expect(screen.getByRole(\"alert\")).toHaveTextContent(\r\n      \"Ajoutez au moins un article avant de soumettre.\"\r\n    );\r\n  });\r\n\r\n  test(\"forwards id so a host can wire its own aria-describedby\", () => {\r\n    render(<FieldError id=\"articles-error\">Ajoutez au moins un article.</FieldError>);\r\n    expect(screen.getByRole(\"alert\")).toHaveAttribute(\"id\", \"articles-error\");\r\n  });\r\n\r\n  test(\"omits id when none is supplied\", () => {\r\n    /* The list-level case usually has nothing to bind to. Emitting an empty or\r\n     * generated id would create a describedby target nobody references. */\r\n    render(<FieldError>Ajoutez au moins un article.</FieldError>);\r\n    expect(screen.getByRole(\"alert\")).not.toHaveAttribute(\"id\");\r\n  });\r\n\r\n  test(\"the icon is hidden from assistive tech\", () => {\r\n    /* R-Ar.2 — the message IS the announcement; an announced glyph would double\r\n     * it. No semantic query reaches a role-less, name-less element, hence the\r\n     * testid the component exposes for exactly this assertion. */\r\n    render(<FieldError>Message</FieldError>);\r\n    expect(screen.getByTestId(\"fielderror-icon\")).toHaveAttribute(\"aria-hidden\", \"true\");\r\n  });\r\n});\r\n\r\ndescribe(\"FieldError — inside Field (the wiring that has no visual tell)\", () => {\r\n  test(\"the error becomes the control's accessible description\", () => {\r\n    render(\r\n      <Field label=\"Numéro de titre\" error=\"Le numéro est invalide. Format : AAAA-IM-NNNNN.\">\r\n        <BareInput />\r\n      </Field>\r\n    );\r\n\r\n    expect(screen.getByRole(\"textbox\")).toHaveAccessibleDescription(\r\n      \"Le numéro est invalide. Format : AAAA-IM-NNNNN.\"\r\n    );\r\n  });\r\n\r\n  test(\"the control is marked invalid\", () => {\r\n    render(\r\n      <Field label=\"Numéro\" error=\"Invalide.\">\r\n        <BareInput />\r\n      </Field>\r\n    );\r\n    // jest-dom's toBeInvalid reads aria-invalid — R-I.3.\r\n    expect(screen.getByRole(\"textbox\")).toBeInvalid();\r\n  });\r\n\r\n  test(\"a host-supplied aria-describedby is PRESERVED, not replaced\", () => {\r\n    /* The merge is the fragile part. Overwriting instead of merging silently\r\n     * drops a consumer's external help text, and again nothing visual changes.\r\n     * Asserted with two order-independent regexes rather than one exact string,\r\n     * so the test does not encode which fragment Field puts first. */\r\n    render(\r\n      <>\r\n        <span id=\"host-help\">Format attendu : AAAA-IM-NNNNN.</span>\r\n        <Field label=\"Numéro\" error=\"Le numéro est incomplet.\">\r\n          <BareInput aria-describedby=\"host-help\" />\r\n        </Field>\r\n      </>\r\n    );\r\n\r\n    const input = screen.getByRole(\"textbox\");\r\n    expect(input).toHaveAccessibleDescription(/Format attendu/);\r\n    expect(input).toHaveAccessibleDescription(/incomplet/);\r\n  });\r\n\r\n  test(\"the hint is suppressed while an error is shown\", () => {\r\n    /* Two competing descriptions under one field is worse than one. The hint\r\n     * returns once the error clears — verified by the rerender below. */\r\n    const { rerender } = render(\r\n      <Field label=\"Numéro\" hint=\"Format : AAAA-IM-NNNNN\" error=\"Le numéro est incomplet.\">\r\n        <BareInput />\r\n      </Field>\r\n    );\r\n\r\n    expect(screen.getByRole(\"alert\")).toHaveTextContent(\"Le numéro est incomplet.\");\r\n    expect(screen.queryByText(\"Format : AAAA-IM-NNNNN\")).not.toBeInTheDocument();\r\n\r\n    rerender(\r\n      <Field label=\"Numéro\" hint=\"Format : AAAA-IM-NNNNN\">\r\n        <BareInput />\r\n      </Field>\r\n    );\r\n    expect(screen.getByText(\"Format : AAAA-IM-NNNNN\")).toBeInTheDocument();\r\n  });\r\n});\r\n\r\ndescribe(\"FieldError — live-region mounting contract\", () => {\r\n  test(\"no alert exists until an error appears\", () => {\r\n    /* THE contract. `role=\\\"alert\\\"` announces on INSERTION: an element mounted\r\n     * permanently with empty content announces nothing when it later fills, so\r\n     * a well-meaning refactor that always renders the container — to \\\"avoid\r\n     * layout shift\\\", say — silently kills the announcement while every pixel\r\n     * and every screenshot stays identical. */\r\n    const { rerender } = render(\r\n      <Field label=\"Numéro\">\r\n        <BareInput />\r\n      </Field>\r\n    );\r\n    expect(screen.queryByRole(\"alert\")).not.toBeInTheDocument();\r\n\r\n    rerender(\r\n      <Field label=\"Numéro\" error=\"Le numéro est incomplet.\">\r\n        <BareInput />\r\n      </Field>\r\n    );\r\n    expect(screen.getByRole(\"alert\")).toBeInTheDocument();\r\n  });\r\n\r\n  test(\"the alert unmounts when the error clears\", () => {\r\n    const { rerender } = render(\r\n      <Field label=\"Numéro\" error=\"Le numéro est incomplet.\">\r\n        <BareInput />\r\n      </Field>\r\n    );\r\n    expect(screen.getByRole(\"alert\")).toBeInTheDocument();\r\n\r\n    rerender(\r\n      <Field label=\"Numéro\">\r\n        <BareInput />\r\n      </Field>\r\n    );\r\n    expect(screen.queryByRole(\"alert\")).not.toBeInTheDocument();\r\n    expect(screen.getByRole(\"textbox\")).not.toBeInvalid();\r\n  });\r\n});\r\n"],"mappings":"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","ignoreList":[]}

package/dist/v2/__tests__/FieldNaming.test.js

@@ -0,0 +1,161 @@
+"use strict";
+
+require("@testing-library/jest-dom");
+var _react = require("@testing-library/react");
+var _Field = _interopRequireDefault(require("../components/Field"));
+var _Select = _interopRequireDefault(require("../components/Select"));
+var _FieldHelp = _interopRequireDefault(require("../components/FieldHelp"));
+var _jsxRuntime = require("react/jsx-runtime");
+function _interopRequireDefault(e) { return e && e.__esModule ? e : { default: e }; }
+/**
+ * R-I.1 — the accessible NAME of a wrapped control.
+ *
+ * ── WHY THIS FILE EXISTS ─────────────────────────────────────────────
+ *
+ * `Field` associated its label through `htmlFor` / `id` only. That pair names
+ * LABELABLE elements — input, select, textarea, button, meter, output,
+ * progress — and nothing else. `Select` renders its visible surface as a
+ * `div[role="combobox"]`, so the pair resolved to NOTHING: the control had no
+ * accessible name at all, and a screen reader announced "combobox, collapsed"
+ * without ever saying which field it was.
+ *
+ * Nothing on screen showed it. The label was there, in the right place, in the
+ * right colour. Every filter drawer and every form of every module carried the
+ * defect, and it took an axe-core run in a consuming module
+ * (`autorisation-admis-pour-conforme-fe`, Area 10) to surface it as
+ * `aria-input-field-name`.
+ *
+ * The assertions below use `toHaveAccessibleName`, not attribute comparisons,
+ * on purpose: it resolves the whole name computation — `aria-labelledby`, then
+ * `aria-label`, then the `label[for]` pair — to the string a screen reader
+ * would announce. A test asserting `aria-labelledby="pui-xyz-l"` would pass
+ * even if that id pointed at an empty element.
+ *
+ * ── NOT COVERED, AND IT IS A REAL LIMITATION ────────────────────
+ *
+ * A consumer-supplied `aria-labelledby` on a NON-group child is not merged
+ * into the name. `aria-describedby` is (R-I.3), which makes the asymmetry
+ * surprising enough to state: the describedby merge happens in `Field`, while
+ * naming goes through MUI's `labelId`, and MUI does not concatenate the two.
+ * An earlier version of this file asserted the merge and failed with
+ * `Received: "Ville"` — the Field label alone.
+ *
+ * Nothing is silently lost: the field IS named, by its own label, which is the
+ * name a user should hear. A host needing an additional name should put it in
+ * `label` rather than reaching around the wrapper. Widening this would mean
+ * interpolating a token LIST into `labelId`, a prop documented as "the ID of an
+ * element" — clever, undocumented, and the kind of thing that breaks on a MUI
+ * minor.
+ */
+
+/**
+ * Fixture : un champ minimal qui CONSOMME les props diffusées par `Field`.
+ *
+ * Même raison que dans `FieldError.test.tsx` : un `<input />` nu laisse filer
+ * `error` et `fullWidth` jusqu'au DOM et produit deux avertissements React par
+ * rendu, au milieu desquels un VRAI avertissement passerait inaperçu.
+ */function BareInput({
+  error: _error,
+  fullWidth: _fullWidth,
+  ...rest
+}) {
+  return /*#__PURE__*/(0, _jsxRuntime.jsx)("input", {
+    ...rest
+  });
+}
+const noop = () => undefined;
+const OPTIONS = [{
+  value: "1",
+  label: "Casablanca"
+}, {
+  value: "2",
+  label: "Rabat"
+}];
+describe("Field — nom accessible du contrôle", () => {
+  /* The case that already worked: a native, labelable child. Asserted so the
+   * fix cannot regress it — adding `aria-labelledby` everywhere had to leave
+   * this one announcing exactly the same string. */
+  it("nomme un contrôle natif (déjà couvert par htmlFor)", () => {
+    (0, _react.render)(/*#__PURE__*/(0, _jsxRuntime.jsx)(_Field.default, {
+      label: "R\xE9f\xE9rence de la demande",
+      children: /*#__PURE__*/(0, _jsxRuntime.jsx)(BareInput, {})
+    }));
+    expect(_react.screen.getByRole("textbox")).toHaveAccessibleName("Référence de la demande");
+  });
+
+  /* THE DEFECT. A div-based control cannot be named by htmlFor/id. */
+  it("nomme un Select, dont la surface est un div[role=combobox]", () => {
+    (0, _react.render)(/*#__PURE__*/(0, _jsxRuntime.jsx)(_Field.default, {
+      label: "Ville de l'unit\xE9",
+      children: /*#__PURE__*/(0, _jsxRuntime.jsx)(_Select.default, {
+        value: "",
+        onChange: noop,
+        options: OPTIONS
+      })
+    }));
+    expect(_react.screen.getByRole("combobox")).toHaveAccessibleName("Ville de l'unité");
+  });
+
+  /* The required asterisk is `aria-hidden`, so it must not leak into the name:
+   * "Ville de l'unité *" is not what a user should hear. */
+  it("n'inclut pas l'astérisque des champs requis", () => {
+    (0, _react.render)(/*#__PURE__*/(0, _jsxRuntime.jsx)(_Field.default, {
+      label: "Ville de l'unit\xE9",
+      required: true,
+      children: /*#__PURE__*/(0, _jsxRuntime.jsx)(_Select.default, {
+        value: "",
+        onChange: noop,
+        options: OPTIONS
+      })
+    }));
+    expect(_react.screen.getByRole("combobox")).toHaveAccessibleName("Ville de l'unité");
+  });
+
+  /**
+   * The reason `labelId` sits on a span around the TEXT and not on the label
+   * element: `aria-labelledby` resolves to its target's text content, and a
+   * help button inside the label carries its own accessible name. Anchoring on
+   * the whole label would announce "Ville de l'unité Aide sur ce champ".
+   *
+   * This also fixes the `htmlFor` path, which had the same flaw.
+   */
+  it("n'inclut pas le nom du bouton d'aide du libellé", () => {
+    (0, _react.render)(/*#__PURE__*/(0, _jsxRuntime.jsx)(_Field.default, {
+      label: "Ville de l'unit\xE9",
+      helpAdornment: /*#__PURE__*/(0, _jsxRuntime.jsx)(_FieldHelp.default, {
+        ariaLabel: "Aide sur ce champ",
+        children: "Texte d'aide."
+      }),
+      children: /*#__PURE__*/(0, _jsxRuntime.jsx)(_Select.default, {
+        value: "",
+        onChange: noop,
+        options: OPTIONS
+      })
+    }));
+    expect(_react.screen.getByRole("combobox")).toHaveAccessibleName("Ville de l'unité");
+  });
+
+  /* Group mode keeps working: the label is a plain span there, and the group is
+   * named by `aria-labelledby` — which DOES reach its target, because it is the
+   * child's own root that carries `role="group"`. */
+  it("nomme un groupe ARIA", () => {
+    (0, _react.render)(/*#__PURE__*/(0, _jsxRuntime.jsx)(_Field.default, {
+      label: "Type de contr\xF4le",
+      group: true,
+      children: /*#__PURE__*/(0, _jsxRuntime.jsxs)("div", {
+        role: "group",
+        children: [/*#__PURE__*/(0, _jsxRuntime.jsx)("input", {
+          type: "radio",
+          name: "t",
+          "aria-label": "Documentaire"
+        }), /*#__PURE__*/(0, _jsxRuntime.jsx)("input", {
+          type: "radio",
+          name: "t",
+          "aria-label": "Physique"
+        })]
+      })
+    }));
+    expect(_react.screen.getByRole("group")).toHaveAccessibleName("Type de contrôle");
+  });
+});
+//# sourceMappingURL=FieldNaming.test.js.map

package/dist/v2/__tests__/FieldNaming.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"FieldNaming.test.js","names":["require","_react","_Field","_interopRequireDefault","_Select","_FieldHelp","_jsxRuntime","e","__esModule","default","BareInput","error","_error","fullWidth","_fullWidth","rest","jsx","noop","undefined","OPTIONS","value","label","describe","it","render","children","expect","screen","getByRole","toHaveAccessibleName","onChange","options","required","helpAdornment","ariaLabel","group","jsxs","role","type","name"],"sources":["../../../src/lib/v2/__tests__/FieldNaming.test.tsx"],"sourcesContent":["import \"@testing-library/jest-dom\";\r\nimport { render, screen } from \"@testing-library/react\";\r\nimport type { InputHTMLAttributes } from \"react\";\r\n\r\nimport Field from \"../components/Field\";\r\nimport Select from \"../components/Select\";\r\nimport FieldHelp from \"../components/FieldHelp\";\r\n\r\n/**\r\n * R-I.1 — the accessible NAME of a wrapped control.\r\n *\r\n * ── WHY THIS FILE EXISTS ─────────────────────────────────────────────\r\n *\r\n * `Field` associated its label through `htmlFor` / `id` only. That pair names\r\n * LABELABLE elements — input, select, textarea, button, meter, output,\r\n * progress — and nothing else. `Select` renders its visible surface as a\r\n * `div[role=\"combobox\"]`, so the pair resolved to NOTHING: the control had no\r\n * accessible name at all, and a screen reader announced \"combobox, collapsed\"\r\n * without ever saying which field it was.\r\n *\r\n * Nothing on screen showed it. The label was there, in the right place, in the\r\n * right colour. Every filter drawer and every form of every module carried the\r\n * defect, and it took an axe-core run in a consuming module\r\n * (`autorisation-admis-pour-conforme-fe`, Area 10) to surface it as\r\n * `aria-input-field-name`.\r\n *\r\n * The assertions below use `toHaveAccessibleName`, not attribute comparisons,\r\n * on purpose: it resolves the whole name computation — `aria-labelledby`, then\r\n * `aria-label`, then the `label[for]` pair — to the string a screen reader\r\n * would announce. A test asserting `aria-labelledby=\"pui-xyz-l\"` would pass\r\n * even if that id pointed at an empty element.\r\n *\r\n * ── NOT COVERED, AND IT IS A REAL LIMITATION ────────────────────\r\n *\r\n * A consumer-supplied `aria-labelledby` on a NON-group child is not merged\r\n * into the name. `aria-describedby` is (R-I.3), which makes the asymmetry\r\n * surprising enough to state: the describedby merge happens in `Field`, while\r\n * naming goes through MUI's `labelId`, and MUI does not concatenate the two.\r\n * An earlier version of this file asserted the merge and failed with\r\n * `Received: \"Ville\"` — the Field label alone.\r\n *\r\n * Nothing is silently lost: the field IS named, by its own label, which is the\r\n * name a user should hear. A host needing an additional name should put it in\r\n * `label` rather than reaching around the wrapper. Widening this would mean\r\n * interpolating a token LIST into `labelId`, a prop documented as \"the ID of an\r\n * element\" — clever, undocumented, and the kind of thing that breaks on a MUI\r\n * minor.\r\n */\r\n\r\n/**\r\n * Fixture : un champ minimal qui CONSOMME les props diffusées par `Field`.\r\n *\r\n * Même raison que dans `FieldError.test.tsx` : un `<input />` nu laisse filer\r\n * `error` et `fullWidth` jusqu'au DOM et produit deux avertissements React par\r\n * rendu, au milieu desquels un VRAI avertissement passerait inaperçu.\r\n */\r\nfunction BareInput({\r\n  error: _error,\r\n  fullWidth: _fullWidth,\r\n  ...rest\r\n}: InputHTMLAttributes<HTMLInputElement> & {\r\n  error?: boolean | undefined;\r\n  fullWidth?: boolean | undefined;\r\n}) {\r\n  return <input {...rest} />;\r\n}\r\n\r\nconst noop = () => undefined;\r\n\r\nconst OPTIONS = [\r\n  { value: \"1\", label: \"Casablanca\" },\r\n  { value: \"2\", label: \"Rabat\" },\r\n];\r\n\r\ndescribe(\"Field — nom accessible du contrôle\", () => {\r\n  /* The case that already worked: a native, labelable child. Asserted so the\r\n   * fix cannot regress it — adding `aria-labelledby` everywhere had to leave\r\n   * this one announcing exactly the same string. */\r\n  it(\"nomme un contrôle natif (déjà couvert par htmlFor)\", () => {\r\n    render(\r\n      <Field label=\"Référence de la demande\">\r\n        <BareInput />\r\n      </Field>\r\n    );\r\n\r\n    expect(screen.getByRole(\"textbox\")).toHaveAccessibleName(\r\n      \"Référence de la demande\"\r\n    );\r\n  });\r\n\r\n  /* THE DEFECT. A div-based control cannot be named by htmlFor/id. */\r\n  it(\"nomme un Select, dont la surface est un div[role=combobox]\", () => {\r\n    render(\r\n      <Field label=\"Ville de l'unité\">\r\n        <Select value=\"\" onChange={noop} options={OPTIONS} />\r\n      </Field>\r\n    );\r\n\r\n    expect(screen.getByRole(\"combobox\")).toHaveAccessibleName(\r\n      \"Ville de l'unité\"\r\n    );\r\n  });\r\n\r\n  /* The required asterisk is `aria-hidden`, so it must not leak into the name:\r\n   * \"Ville de l'unité *\" is not what a user should hear. */\r\n  it(\"n'inclut pas l'astérisque des champs requis\", () => {\r\n    render(\r\n      <Field label=\"Ville de l'unité\" required>\r\n        <Select value=\"\" onChange={noop} options={OPTIONS} />\r\n      </Field>\r\n    );\r\n\r\n    expect(screen.getByRole(\"combobox\")).toHaveAccessibleName(\r\n      \"Ville de l'unité\"\r\n    );\r\n  });\r\n\r\n  /**\r\n   * The reason `labelId` sits on a span around the TEXT and not on the label\r\n   * element: `aria-labelledby` resolves to its target's text content, and a\r\n   * help button inside the label carries its own accessible name. Anchoring on\r\n   * the whole label would announce \"Ville de l'unité Aide sur ce champ\".\r\n   *\r\n   * This also fixes the `htmlFor` path, which had the same flaw.\r\n   */\r\n  it(\"n'inclut pas le nom du bouton d'aide du libellé\", () => {\r\n    render(\r\n      <Field\r\n        label=\"Ville de l'unité\"\r\n        helpAdornment={<FieldHelp ariaLabel=\"Aide sur ce champ\">Texte d'aide.</FieldHelp>}\r\n      >\r\n        <Select value=\"\" onChange={noop} options={OPTIONS} />\r\n      </Field>\r\n    );\r\n\r\n    expect(screen.getByRole(\"combobox\")).toHaveAccessibleName(\r\n      \"Ville de l'unité\"\r\n    );\r\n  });\r\n\r\n  /* Group mode keeps working: the label is a plain span there, and the group is\r\n   * named by `aria-labelledby` — which DOES reach its target, because it is the\r\n   * child's own root that carries `role=\"group\"`. */\r\n  it(\"nomme un groupe ARIA\", () => {\r\n    render(\r\n      <Field label=\"Type de contrôle\" group>\r\n        <div role=\"group\">\r\n          <input type=\"radio\" name=\"t\" aria-label=\"Documentaire\" />\r\n          <input type=\"radio\" name=\"t\" aria-label=\"Physique\" />\r\n        </div>\r\n      </Field>\r\n    );\r\n\r\n    expect(screen.getByRole(\"group\")).toHaveAccessibleName(\"Type de contrôle\");\r\n  });\r\n});\r\n"],"mappings":";;AAAAA,OAAA;AACA,IAAAC,MAAA,GAAAD,OAAA;AAGA,IAAAE,MAAA,GAAAC,sBAAA,CAAAH,OAAA;AACA,IAAAI,OAAA,GAAAD,sBAAA,CAAAH,OAAA;AACA,IAAAK,UAAA,GAAAF,sBAAA,CAAAH,OAAA;AAAgD,IAAAM,WAAA,GAAAN,OAAA;AAAA,SAAAG,uBAAAI,CAAA,WAAAA,CAAA,IAAAA,CAAA,CAAAC,UAAA,GAAAD,CAAA,KAAAE,OAAA,EAAAF,CAAA;AAEhD;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;;AAEA;AACA;AACA;AACA;AACA;AACA;AACA,GACA,SAASG,SAASA,CAAC;EACjBC,KAAK,EAAEC,MAAM;EACbC,SAAS,EAAEC,UAAU;EACrB,GAAGC;AAIL,CAAC,EAAE;EACD,oBAAO,IAAAT,WAAA,CAAAU,GAAA;IAAA,GAAWD;EAAI,CAAG,CAAC;AAC5B;AAEA,MAAME,IAAI,GAAGA,CAAA,KAAMC,SAAS;AAE5B,MAAMC,OAAO,GAAG,CACd;EAAEC,KAAK,EAAE,GAAG;EAAEC,KAAK,EAAE;AAAa,CAAC,EACnC;EAAED,KAAK,EAAE,GAAG;EAAEC,KAAK,EAAE;AAAQ,CAAC,CAC/B;AAEDC,QAAQ,CAAC,oCAAoC,EAAE,MAAM;EACnD;AACF;AACA;EACEC,EAAE,CAAC,oDAAoD,EAAE,MAAM;IAC7D,IAAAC,aAAM,eACJ,IAAAlB,WAAA,CAAAU,GAAA,EAACd,MAAA,CAAAO,OAAK;MAACY,KAAK,EAAC,+BAAyB;MAAAI,QAAA,eACpC,IAAAnB,WAAA,CAAAU,GAAA,EAACN,SAAS,IAAE;IAAC,CACR,CACT,CAAC;IAEDgB,MAAM,CAACC,aAAM,CAACC,SAAS,CAAC,SAAS,CAAC,CAAC,CAACC,oBAAoB,CACtD,yBACF,CAAC;EACH,CAAC,CAAC;;EAEF;EACAN,EAAE,CAAC,4DAA4D,EAAE,MAAM;IACrE,IAAAC,aAAM,eACJ,IAAAlB,WAAA,CAAAU,GAAA,EAACd,MAAA,CAAAO,OAAK;MAACY,KAAK,EAAC,qBAAkB;MAAAI,QAAA,eAC7B,IAAAnB,WAAA,CAAAU,GAAA,EAACZ,OAAA,CAAAK,OAAM;QAACW,KAAK,EAAC,EAAE;QAACU,QAAQ,EAAEb,IAAK;QAACc,OAAO,EAAEZ;MAAQ,CAAE;IAAC,CAChD,CACT,CAAC;IAEDO,MAAM,CAACC,aAAM,CAACC,SAAS,CAAC,UAAU,CAAC,CAAC,CAACC,oBAAoB,CACvD,kBACF,CAAC;EACH,CAAC,CAAC;;EAEF;AACF;EACEN,EAAE,CAAC,6CAA6C,EAAE,MAAM;IACtD,IAAAC,aAAM,eACJ,IAAAlB,WAAA,CAAAU,GAAA,EAACd,MAAA,CAAAO,OAAK;MAACY,KAAK,EAAC,qBAAkB;MAACW,QAAQ;MAAAP,QAAA,eACtC,IAAAnB,WAAA,CAAAU,GAAA,EAACZ,OAAA,CAAAK,OAAM;QAACW,KAAK,EAAC,EAAE;QAACU,QAAQ,EAAEb,IAAK;QAACc,OAAO,EAAEZ;MAAQ,CAAE;IAAC,CAChD,CACT,CAAC;IAEDO,MAAM,CAACC,aAAM,CAACC,SAAS,CAAC,UAAU,CAAC,CAAC,CAACC,oBAAoB,CACvD,kBACF,CAAC;EACH,CAAC,CAAC;;EAEF;AACF;AACA;AACA;AACA;AACA;AACA;AACA;EACEN,EAAE,CAAC,iDAAiD,EAAE,MAAM;IAC1D,IAAAC,aAAM,eACJ,IAAAlB,WAAA,CAAAU,GAAA,EAACd,MAAA,CAAAO,OAAK;MACJY,KAAK,EAAC,qBAAkB;MACxBY,aAAa,eAAE,IAAA3B,WAAA,CAAAU,GAAA,EAACX,UAAA,CAAAI,OAAS;QAACyB,SAAS,EAAC,mBAAmB;QAAAT,QAAA,EAAC;MAAa,CAAW,CAAE;MAAAA,QAAA,eAElF,IAAAnB,WAAA,CAAAU,GAAA,EAACZ,OAAA,CAAAK,OAAM;QAACW,KAAK,EAAC,EAAE;QAACU,QAAQ,EAAEb,IAAK;QAACc,OAAO,EAAEZ;MAAQ,CAAE;IAAC,CAChD,CACT,CAAC;IAEDO,MAAM,CAACC,aAAM,CAACC,SAAS,CAAC,UAAU,CAAC,CAAC,CAACC,oBAAoB,CACvD,kBACF,CAAC;EACH,CAAC,CAAC;;EAEF;AACF;AACA;EACEN,EAAE,CAAC,sBAAsB,EAAE,MAAM;IAC/B,IAAAC,aAAM,eACJ,IAAAlB,WAAA,CAAAU,GAAA,EAACd,MAAA,CAAAO,OAAK;MAACY,KAAK,EAAC,qBAAkB;MAACc,KAAK;MAAAV,QAAA,eACnC,IAAAnB,WAAA,CAAA8B,IAAA;QAAKC,IAAI,EAAC,OAAO;QAAAZ,QAAA,gBACf,IAAAnB,WAAA,CAAAU,GAAA;UAAOsB,IAAI,EAAC,OAAO;UAACC,IAAI,EAAC,GAAG;UAAC,cAAW;QAAc,CAAE,CAAC,eACzD,IAAAjC,WAAA,CAAAU,GAAA;UAAOsB,IAAI,EAAC,OAAO;UAACC,IAAI,EAAC,GAAG;UAAC,cAAW;QAAU,CAAE,CAAC;MAAA,CAClD;IAAC,CACD,CACT,CAAC;IAEDb,MAAM,CAACC,aAAM,CAACC,SAAS,CAAC,OAAO,CAAC,CAAC,CAACC,oBAAoB,CAAC,kBAAkB,CAAC;EAC5E,CAAC,CAAC;AACJ,CAAC,CAAC","ignoreList":[]}