@portnet/ui 6.0.0 → 6.0.2

package/dist/esm/v2/__tests__/contrast-palette.test.js

@@ -0,0 +1,224 @@
+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; }
+import { contrastRatio, passesContrast, WCAG_AA_NORMAL, WCAG_AA_UI_NON_TEXT } from "../utils/contrast";
+import { ink, surface, border, semantic, status, brand, brandSecondary, dark } from "../tokens";
+
+/**
+ * Token-palette contrast certification (Charter §05.1 / WCAG 2.1 AA).
+ *
+ * WHY THIS FILE EXISTS
+ * --------------------
+ * R-C.1 / R-C.2 / R-C.3 are MUST rules, and until now nothing verified them.
+ * `utils/contrast.ts` shipped a correct WCAG ratio implementation and had no
+ * test asserting the palette it exists to check; the ratios in `colors.ts` were
+ * hand-written COMMENTS, unenforced — exactly the class of claim that drifts
+ * silently when a hue is nudged.
+ *
+ * Contrast is one of the few a11y rules that is fully computable without a
+ * browser, so it belongs in CI rather than in a manual audit pass.
+ *
+ * Found by writing it: `fgSubtle` on `bgSubtle` is ~4.32:1 — BELOW AA. See the
+ * documented-failure block at the bottom; that is a real finding, not a test
+ * artefact.
+ */
+
+/** Every light-mode surface that body text can land on. */
+var LIGHT_SURFACES = [["surface", surface.surface], ["bgElev", surface.bgElev], ["bg", surface.bg], ["bgSubtle", surface.bgSubtle]];
+describe("Token palette — WCAG AA contrast (R-C.1 / R-C.2 / R-C.3)", function () {
+  describe("ink on light surfaces — normal text ≥ 4.5:1", function () {
+    var _loop = function _loop() {
+      var _LIGHT_SURFACES$_i = _slicedToArray(_LIGHT_SURFACES[_i], 2),
+        name = _LIGHT_SURFACES$_i[0],
+        bg = _LIGHT_SURFACES$_i[1];
+      test("fg on ".concat(name), function () {
+        expect(passesContrast(contrastRatio(ink.fg, bg), "normal")).toBe(true);
+      });
+      test("fgMuted on ".concat(name), function () {
+        expect(passesContrast(contrastRatio(ink.fgMuted, bg), "normal")).toBe(true);
+      });
+    };
+    for (var _i = 0, _LIGHT_SURFACES = LIGHT_SURFACES; _i < _LIGHT_SURFACES.length; _i++) {
+      _loop();
+    }
+    test("fgInverse on the darkest dark surface", function () {
+      expect(passesContrast(contrastRatio(ink.fgInverse, dark.bg), "normal")).toBe(true);
+    });
+  });
+  describe("semantic fg — readable on white AND on its own soft fill", function () {
+    var pairs = [["success", semantic.successFg, semantic.successSoft], ["warning", semantic.warningFg, semantic.warningSoft], ["danger", semantic.dangerFg, semantic.dangerSoft], ["info", semantic.infoFg, semantic.infoSoft]];
+    var _loop2 = function _loop2() {
+      var _pairs$_i = _slicedToArray(_pairs[_i2], 3),
+        name = _pairs$_i[0],
+        fg = _pairs$_i[1],
+        soft = _pairs$_i[2];
+      test("".concat(name, "Fg on white"), function () {
+        expect(passesContrast(contrastRatio(fg, "#FFFFFF"), "normal")).toBe(true);
+      });
+      test("".concat(name, "Fg on ").concat(name, "Soft"), function () {
+        expect(passesContrast(contrastRatio(fg, soft), "normal")).toBe(true);
+      });
+    };
+    for (var _i2 = 0, _pairs = pairs; _i2 < _pairs.length; _i2++) {
+      _loop2();
+    }
+  });
+
+  /**
+   * The Charter's promise in §02.1: "Combinaison background -soft +
+   * foreground -fg = AA garanti." This is that promise, enforced.
+   */
+  describe("status palette — every -fg on its own -soft is AA (§02.1)", function () {
+    var _loop3 = function _loop3() {
+      var key = _arr2[_i3];
+      test("status.".concat(key), function () {
+        var _status$key = status[key],
+          soft = _status$key.soft,
+          fg = _status$key.fg;
+        expect(passesContrast(contrastRatio(fg, soft), "normal")).toBe(true);
+      });
+      test("status.".concat(key, " fg on white"), function () {
+        expect(passesContrast(contrastRatio(status[key].fg, "#FFFFFF"), "normal")).toBe(true);
+      });
+    };
+    for (var _i3 = 0, _arr2 = Object.keys(status); _i3 < _arr2.length; _i3++) {
+      _loop3();
+    }
+  });
+  describe("non-text UI ≥ 3:1 (WCAG 1.4.11 / R-C.3)", function () {
+    var saturated = [["success", semantic.success], ["warning", semantic.warning], ["danger", semantic.danger], ["info", semantic.info]];
+    var _loop4 = function _loop4() {
+      var _saturated$_i = _slicedToArray(_saturated[_i4], 2),
+        name = _saturated$_i[0],
+        colour = _saturated$_i[1];
+      test("".concat(name, " (icon / border grade) on white"), function () {
+        expect(passesContrast(contrastRatio(colour, "#FFFFFF"), "ui")).toBe(true);
+      });
+    };
+    for (var _i4 = 0, _saturated = saturated; _i4 < _saturated.length; _i4++) {
+      _loop4();
+    }
+  });
+  describe("brand", function () {
+    test("accent on white is AA for normal text", function () {
+      expect(passesContrast(contrastRatio(brand.accent, "#FFFFFF"), "normal")).toBe(true);
+    });
+    test("accentFg on accent — the primary-button pair", function () {
+      expect(passesContrast(contrastRatio(brand.accentFg, brand.accent), "normal")).toBe(true);
+    });
+    test("accentHover keeps AA against accentFg (pressed state stays readable)", function () {
+      expect(passesContrast(contrastRatio(brand.accentFg, brand.accentHover), "normal")).toBe(true);
+    });
+  });
+  describe("dark mode", function () {
+    test("dark.fg on dark.surface", function () {
+      expect(passesContrast(contrastRatio(dark.fg, dark.surface), "normal")).toBe(true);
+    });
+    test("dark.fgMuted on dark.surface", function () {
+      expect(passesContrast(contrastRatio(dark.fgMuted, dark.surface), "normal")).toBe(true);
+    });
+    var _loop5 = function _loop5() {
+      var key = _arr3[_i5];
+      test("dark status.".concat(key, ".fg on dark.surface"), function () {
+        expect(passesContrast(contrastRatio(dark.status[key].fg, dark.surface), "normal")).toBe(true);
+      });
+    };
+    for (var _i5 = 0, _arr3 = Object.keys(dark.status); _i5 < _arr3.length; _i5++) {
+      _loop5();
+    }
+  });
+
+  /* ══════════════════════════════════════════════════════════════════
+   * DOCUMENTED FAILURES — asserted at their MEASURED value, not at the
+   * threshold, so the suite stays green while the breach stays visible and
+   * any drift shows up as a diff. Both need a palette decision, not a
+   * test change.
+   * ══════════════════════════════════════════════════════════════════ */
+  describe("KNOWN AA FAILURES (documented, pending decision)", function () {
+    /**
+     * A9-01 — `fgSubtle` on `bgSubtle` ≈ 4.32:1, below the 4.5 floor.
+     *
+     * `colors.ts` documents fgSubtle as "AA · 4.81:1 on white — incidental
+     * text only (WCAG 1.4.6)". On white that holds. On `bgSubtle` it does not,
+     * and the exemption does not rescue it, because fgSubtle is NOT used only
+     * for incidental text — it colours KV eyebrow labels, section captions and
+     * hero stat labels, all of which name the value beside them.
+     *
+     * LIVE BREACH: both preview drawers put `--fg-subtle` labels on a
+     * `--bg-subtle` hero panel (dfd `GestionDFDPreviewDrawer` HERO_BOX_STYLE +
+     * HERO_LABEL_STYLE, ti `GestionTIPreviewDrawer` HERO_STAT_LABEL_STYLE), at
+     * `--text-xs` (12px) — too small to qualify as large text, so the 4.5
+     * floor applies.
+     *
+     * FIX OPTIONS: darken fgSubtle (affects the muted/subtle hierarchy
+     * fleet-wide), or switch those labels to `--fg-muted` (AAA, 7.5:1 on
+     * bgSubtle) which is what every other label surface already uses.
+     */
+    test("fgSubtle on bgSubtle is BELOW AA — ~4.32:1", function () {
+      var ratio = contrastRatio(ink.fgSubtle, surface.bgSubtle);
+      expect(ratio).not.toBeNull();
+      expect(ratio).toBeLessThan(WCAG_AA_NORMAL);
+      expect(ratio).toBeGreaterThan(4.2);
+      // It DOES pass on white — the failure is surface-specific.
+      expect(passesContrast(contrastRatio(ink.fgSubtle, "#FFFFFF"), "normal")).toBe(true);
+    });
+
+    /**
+     * A9-02 — `borderStrong` ≈ 2.87:1 on white. BELOW the 3:1 non-text floor.
+     *
+     * ⚠️ The token's own comment in `colors.ts` reads:
+     *      borderStrong: "#9099AA", // WCAG 1.4.11 · ≥ 3:1 against white
+     * That claim is FALSE. This is precisely the drift this file exists to
+     * catch — an unenforced hand-written ratio that nobody re-derived.
+     *
+     * IMPACT depends on usage. `--border-strong` currently colours the
+     * scrollbar thumb (`base.css`) and the `kbd` bottom edge in
+     * KeyboardShortcutsHelp. If it is ever used for an INPUT border or any
+     * other control boundary, 1.4.11 applies and the breach is live — audit
+     * usage before deciding severity.
+     *
+     * FIX: darken to relative luminance ≤ 0.30 (currently 0.316). Roughly
+     * #868FA3 / #8A92A5; change the token and this assertion flips to the
+     * `passesContrast(..., "ui")` form.
+     */
+    test("borderStrong on white is BELOW 3:1 — ~2.87:1 (comment in colors.ts is wrong)", function () {
+      var ratio = contrastRatio(border.borderStrong, "#FFFFFF");
+      expect(ratio).not.toBeNull();
+      expect(ratio).toBeLessThan(WCAG_AA_UI_NON_TEXT);
+      expect(ratio).toBeGreaterThan(2.8);
+    });
+
+    /**
+     * A9-03 — `dark.borderStrong` ≈ 2.28:1 on `dark.surface`. Worse than the
+     * light-mode equivalent, and the same 1.4.11 floor applies in dark mode.
+     *
+     * FIX: lighten to relative luminance ≥ 0.119 (currently 0.078) — roughly
+     * #5C6478 or lighter. Note dark mode is currently UNREACHABLE in both
+     * consuming modules (neither sets `[data-theme="dark"]` on <html>), which
+     * is why nobody has seen it — see the RGESN R-9.5 note in the handover.
+     */
+    test("dark.borderStrong on dark.surface is BELOW 3:1 — ~2.28:1", function () {
+      var ratio = contrastRatio(dark.borderStrong, dark.surface);
+      expect(ratio).not.toBeNull();
+      expect(ratio).toBeLessThan(WCAG_AA_UI_NON_TEXT);
+      expect(ratio).toBeGreaterThan(2.2);
+    });
+
+    /**
+     * Already flagged in colors.ts itself: secondaryFg (#FFFFFF) on
+     * secondary (#4FB8CF) ≈ 1.96:1. The token comment restricts it to
+     * chip/badge surfaces and non-text accent fills. Asserted here so the
+     * restriction is machine-checked rather than comment-only: it fails BOTH
+     * the text floor and the 3:1 non-text floor.
+     */
+    test("brandSecondary text pair is BELOW AA and below 3:1 — fills only", function () {
+      var ratio = contrastRatio(brandSecondary.secondaryFg, brandSecondary.secondary);
+      expect(ratio).not.toBeNull();
+      expect(ratio).toBeLessThan(WCAG_AA_UI_NON_TEXT);
+    });
+  });
+});
+//# sourceMappingURL=contrast-palette.test.js.map

package/dist/esm/v2/__tests__/contrast-palette.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"contrast-palette.test.js","names":["contrastRatio","passesContrast","WCAG_AA_NORMAL","WCAG_AA_UI_NON_TEXT","ink","surface","border","semantic","status","brand","brandSecondary","dark","LIGHT_SURFACES","bgElev","bg","bgSubtle","describe","_loop","_LIGHT_SURFACES$_i","_slicedToArray","_LIGHT_SURFACES","_i","name","test","concat","expect","fg","toBe","fgMuted","length","fgInverse","pairs","successFg","successSoft","warningFg","warningSoft","dangerFg","dangerSoft","infoFg","infoSoft","_loop2","_pairs$_i","_pairs","_i2","soft","_loop3","key","_arr2","_i3","_status$key","Object","keys","saturated","success","warning","danger","info","_loop4","_saturated$_i","_saturated","_i4","colour","accent","accentFg","accentHover","_loop5","_arr3","_i5","ratio","fgSubtle","not","toBeNull","toBeLessThan","toBeGreaterThan","borderStrong","secondaryFg","secondary"],"sources":["../../../../src/lib/v2/__tests__/contrast-palette.test.ts"],"sourcesContent":["import {\r\n  contrastRatio,\r\n  passesContrast,\r\n  WCAG_AA_NORMAL,\r\n  WCAG_AA_UI_NON_TEXT,\r\n} from \"../utils/contrast\";\r\nimport { ink, surface, border, semantic, status, brand, brandSecondary, dark } from \"../tokens\";\r\n\r\n/**\r\n * Token-palette contrast certification (Charter §05.1 / WCAG 2.1 AA).\r\n *\r\n * WHY THIS FILE EXISTS\r\n * --------------------\r\n * R-C.1 / R-C.2 / R-C.3 are MUST rules, and until now nothing verified them.\r\n * `utils/contrast.ts` shipped a correct WCAG ratio implementation and had no\r\n * test asserting the palette it exists to check; the ratios in `colors.ts` were\r\n * hand-written COMMENTS, unenforced — exactly the class of claim that drifts\r\n * silently when a hue is nudged.\r\n *\r\n * Contrast is one of the few a11y rules that is fully computable without a\r\n * browser, so it belongs in CI rather than in a manual audit pass.\r\n *\r\n * Found by writing it: `fgSubtle` on `bgSubtle` is ~4.32:1 — BELOW AA. See the\r\n * documented-failure block at the bottom; that is a real finding, not a test\r\n * artefact.\r\n */\r\n\r\n/** Every light-mode surface that body text can land on. */\r\nconst LIGHT_SURFACES: Array<[string, string]> = [\r\n  [\"surface\", surface.surface],\r\n  [\"bgElev\", surface.bgElev],\r\n  [\"bg\", surface.bg],\r\n  [\"bgSubtle\", surface.bgSubtle],\r\n];\r\n\r\ndescribe(\"Token palette — WCAG AA contrast (R-C.1 / R-C.2 / R-C.3)\", () => {\r\n  describe(\"ink on light surfaces — normal text ≥ 4.5:1\", () => {\r\n    for (const [name, bg] of LIGHT_SURFACES) {\r\n      test(`fg on ${name}`, () => {\r\n        expect(passesContrast(contrastRatio(ink.fg, bg), \"normal\")).toBe(true);\r\n      });\r\n      test(`fgMuted on ${name}`, () => {\r\n        expect(passesContrast(contrastRatio(ink.fgMuted, bg), \"normal\")).toBe(true);\r\n      });\r\n    }\r\n\r\n    test(\"fgInverse on the darkest dark surface\", () => {\r\n      expect(passesContrast(contrastRatio(ink.fgInverse, dark.bg), \"normal\")).toBe(true);\r\n    });\r\n  });\r\n\r\n  describe(\"semantic fg — readable on white AND on its own soft fill\", () => {\r\n    const pairs: Array<[string, string, string]> = [\r\n      [\"success\", semantic.successFg, semantic.successSoft],\r\n      [\"warning\", semantic.warningFg, semantic.warningSoft],\r\n      [\"danger\", semantic.dangerFg, semantic.dangerSoft],\r\n      [\"info\", semantic.infoFg, semantic.infoSoft],\r\n    ];\r\n    for (const [name, fg, soft] of pairs) {\r\n      test(`${name}Fg on white`, () => {\r\n        expect(passesContrast(contrastRatio(fg, \"#FFFFFF\"), \"normal\")).toBe(true);\r\n      });\r\n      test(`${name}Fg on ${name}Soft`, () => {\r\n        expect(passesContrast(contrastRatio(fg, soft), \"normal\")).toBe(true);\r\n      });\r\n    }\r\n  });\r\n\r\n  /**\r\n   * The Charter's promise in §02.1: \"Combinaison background -soft +\r\n   * foreground -fg = AA garanti.\" This is that promise, enforced.\r\n   */\r\n  describe(\"status palette — every -fg on its own -soft is AA (§02.1)\", () => {\r\n    for (const key of Object.keys(status) as Array<keyof typeof status>) {\r\n      test(`status.${key}`, () => {\r\n        const { soft, fg } = status[key];\r\n        expect(passesContrast(contrastRatio(fg, soft), \"normal\")).toBe(true);\r\n      });\r\n      test(`status.${key} fg on white`, () => {\r\n        expect(passesContrast(contrastRatio(status[key].fg, \"#FFFFFF\"), \"normal\")).toBe(true);\r\n      });\r\n    }\r\n  });\r\n\r\n  describe(\"non-text UI ≥ 3:1 (WCAG 1.4.11 / R-C.3)\", () => {\r\n    const saturated: Array<[string, string]> = [\r\n      [\"success\", semantic.success],\r\n      [\"warning\", semantic.warning],\r\n      [\"danger\", semantic.danger],\r\n      [\"info\", semantic.info],\r\n    ];\r\n    for (const [name, colour] of saturated) {\r\n      test(`${name} (icon / border grade) on white`, () => {\r\n        expect(passesContrast(contrastRatio(colour, \"#FFFFFF\"), \"ui\")).toBe(true);\r\n      });\r\n    }\r\n  });\r\n\r\n  describe(\"brand\", () => {\r\n    test(\"accent on white is AA for normal text\", () => {\r\n      expect(passesContrast(contrastRatio(brand.accent, \"#FFFFFF\"), \"normal\")).toBe(true);\r\n    });\r\n    test(\"accentFg on accent — the primary-button pair\", () => {\r\n      expect(passesContrast(contrastRatio(brand.accentFg, brand.accent), \"normal\")).toBe(true);\r\n    });\r\n    test(\"accentHover keeps AA against accentFg (pressed state stays readable)\", () => {\r\n      expect(passesContrast(contrastRatio(brand.accentFg, brand.accentHover), \"normal\")).toBe(true);\r\n    });\r\n  });\r\n\r\n  describe(\"dark mode\", () => {\r\n    test(\"dark.fg on dark.surface\", () => {\r\n      expect(passesContrast(contrastRatio(dark.fg, dark.surface), \"normal\")).toBe(true);\r\n    });\r\n    test(\"dark.fgMuted on dark.surface\", () => {\r\n      expect(passesContrast(contrastRatio(dark.fgMuted, dark.surface), \"normal\")).toBe(true);\r\n    });\r\n    for (const key of Object.keys(dark.status) as Array<keyof typeof dark.status>) {\r\n      test(`dark status.${key}.fg on dark.surface`, () => {\r\n        expect(\r\n          passesContrast(contrastRatio(dark.status[key].fg, dark.surface), \"normal\")\r\n        ).toBe(true);\r\n      });\r\n    }\r\n  });\r\n\r\n  /* ══════════════════════════════════════════════════════════════════\r\n   * DOCUMENTED FAILURES — asserted at their MEASURED value, not at the\r\n   * threshold, so the suite stays green while the breach stays visible and\r\n   * any drift shows up as a diff. Both need a palette decision, not a\r\n   * test change.\r\n   * ══════════════════════════════════════════════════════════════════ */\r\n  describe(\"KNOWN AA FAILURES (documented, pending decision)\", () => {\r\n    /**\r\n     * A9-01 — `fgSubtle` on `bgSubtle` ≈ 4.32:1, below the 4.5 floor.\r\n     *\r\n     * `colors.ts` documents fgSubtle as \"AA · 4.81:1 on white — incidental\r\n     * text only (WCAG 1.4.6)\". On white that holds. On `bgSubtle` it does not,\r\n     * and the exemption does not rescue it, because fgSubtle is NOT used only\r\n     * for incidental text — it colours KV eyebrow labels, section captions and\r\n     * hero stat labels, all of which name the value beside them.\r\n     *\r\n     * LIVE BREACH: both preview drawers put `--fg-subtle` labels on a\r\n     * `--bg-subtle` hero panel (dfd `GestionDFDPreviewDrawer` HERO_BOX_STYLE +\r\n     * HERO_LABEL_STYLE, ti `GestionTIPreviewDrawer` HERO_STAT_LABEL_STYLE), at\r\n     * `--text-xs` (12px) — too small to qualify as large text, so the 4.5\r\n     * floor applies.\r\n     *\r\n     * FIX OPTIONS: darken fgSubtle (affects the muted/subtle hierarchy\r\n     * fleet-wide), or switch those labels to `--fg-muted` (AAA, 7.5:1 on\r\n     * bgSubtle) which is what every other label surface already uses.\r\n     */\r\n    test(\"fgSubtle on bgSubtle is BELOW AA — ~4.32:1\", () => {\r\n      const ratio = contrastRatio(ink.fgSubtle, surface.bgSubtle);\r\n      expect(ratio).not.toBeNull();\r\n      expect(ratio as number).toBeLessThan(WCAG_AA_NORMAL);\r\n      expect(ratio as number).toBeGreaterThan(4.2);\r\n      // It DOES pass on white — the failure is surface-specific.\r\n      expect(passesContrast(contrastRatio(ink.fgSubtle, \"#FFFFFF\"), \"normal\")).toBe(true);\r\n    });\r\n\r\n    /**\r\n     * A9-02 — `borderStrong` ≈ 2.87:1 on white. BELOW the 3:1 non-text floor.\r\n     *\r\n     * ⚠️ The token's own comment in `colors.ts` reads:\r\n     *      borderStrong: \"#9099AA\", // WCAG 1.4.11 · ≥ 3:1 against white\r\n     * That claim is FALSE. This is precisely the drift this file exists to\r\n     * catch — an unenforced hand-written ratio that nobody re-derived.\r\n     *\r\n     * IMPACT depends on usage. `--border-strong` currently colours the\r\n     * scrollbar thumb (`base.css`) and the `kbd` bottom edge in\r\n     * KeyboardShortcutsHelp. If it is ever used for an INPUT border or any\r\n     * other control boundary, 1.4.11 applies and the breach is live — audit\r\n     * usage before deciding severity.\r\n     *\r\n     * FIX: darken to relative luminance ≤ 0.30 (currently 0.316). Roughly\r\n     * #868FA3 / #8A92A5; change the token and this assertion flips to the\r\n     * `passesContrast(..., \"ui\")` form.\r\n     */\r\n    test(\"borderStrong on white is BELOW 3:1 — ~2.87:1 (comment in colors.ts is wrong)\", () => {\r\n      const ratio = contrastRatio(border.borderStrong, \"#FFFFFF\");\r\n      expect(ratio).not.toBeNull();\r\n      expect(ratio as number).toBeLessThan(WCAG_AA_UI_NON_TEXT);\r\n      expect(ratio as number).toBeGreaterThan(2.8);\r\n    });\r\n\r\n    /**\r\n     * A9-03 — `dark.borderStrong` ≈ 2.28:1 on `dark.surface`. Worse than the\r\n     * light-mode equivalent, and the same 1.4.11 floor applies in dark mode.\r\n     *\r\n     * FIX: lighten to relative luminance ≥ 0.119 (currently 0.078) — roughly\r\n     * #5C6478 or lighter. Note dark mode is currently UNREACHABLE in both\r\n     * consuming modules (neither sets `[data-theme=\"dark\"]` on <html>), which\r\n     * is why nobody has seen it — see the RGESN R-9.5 note in the handover.\r\n     */\r\n    test(\"dark.borderStrong on dark.surface is BELOW 3:1 — ~2.28:1\", () => {\r\n      const ratio = contrastRatio(dark.borderStrong, dark.surface);\r\n      expect(ratio).not.toBeNull();\r\n      expect(ratio as number).toBeLessThan(WCAG_AA_UI_NON_TEXT);\r\n      expect(ratio as number).toBeGreaterThan(2.2);\r\n    });\r\n\r\n    /**\r\n     * Already flagged in colors.ts itself: secondaryFg (#FFFFFF) on\r\n     * secondary (#4FB8CF) ≈ 1.96:1. The token comment restricts it to\r\n     * chip/badge surfaces and non-text accent fills. Asserted here so the\r\n     * restriction is machine-checked rather than comment-only: it fails BOTH\r\n     * the text floor and the 3:1 non-text floor.\r\n     */\r\n    test(\"brandSecondary text pair is BELOW AA and below 3:1 — fills only\", () => {\r\n      const ratio = contrastRatio(brandSecondary.secondaryFg, brandSecondary.secondary);\r\n      expect(ratio).not.toBeNull();\r\n      expect(ratio as number).toBeLessThan(WCAG_AA_UI_NON_TEXT);\r\n    });\r\n  });\r\n});\r\n"],"mappings":"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","ignoreList":[]}

package/dist/esm/v2/__tests__/cssVariables.test.js

@@ -0,0 +1,157 @@
+import { getCssVariables } from "../theme/cssVariables";
+
+/**
+ * Regression coverage for the v2 CSS variable emission.
+ *
+ * These invariants are established by Batch 1 (token refactor) and
+ * Batch 2 (cssVariables refactor). A failure here means a future
+ * change has either:
+ *   - re-introduced a deleted token (e.g. --fw-black),
+ *   - emitted an undefined value (the silent bug class that broke
+ *     KPICard and FormSection visually before Batch 6+7 caught it),
+ *   - dropped a critical variable downstream consumers rely on, or
+ *   - leaked an alias name (--md / --lg) into the global namespace.
+ */
+describe("getCssVariables() — Batch 1 + 2 invariants", function () {
+  var css;
+  beforeAll(function () {
+    css = getCssVariables();
+  });
+  test("emits a :root block", function () {
+    expect(css).toMatch(/:root\s*\{/);
+  });
+  test("never emits ': undefined' values (the ghost-token bug class)", function () {
+    // Match `--anything: undefined;` with optional whitespace.
+    // This catches the regression that produced --fw-black resolving
+    // to undefined in :root after Batch 1 removed fontWeight.black.
+    var matches = css.match(/--[\w-]+\s*:\s*undefined\b/g);
+    expect(matches).toBeNull();
+  });
+  test("does NOT emit --fw-black (Batch 1 removed fontWeight.black)", function () {
+    expect(css).not.toMatch(/--fw-black/);
+  });
+  test("emits all critical brand + ink + surface variables", function () {
+    var required = ["--accent", "--accent-soft", "--accent-hover", "--accent-fg", "--fg", "--fg-muted", "--fg-subtle", "--fg-inverse", "--bg", "--bg-elev", "--bg-subtle", "--bg-hover", "--surface", "--border", "--border-strong"];
+    for (var _i = 0, _required = required; _i < _required.length; _i++) {
+      var v = _required[_i];
+      expect(css).toContain("".concat(v, ":"));
+    }
+  });
+  test("emits all semantic + status palette variables", function () {
+    var required = ["--success", "--success-fg", "--success-soft", "--danger", "--danger-fg", "--danger-soft", "--warning", "--warning-fg", "--warning-soft", "--info", "--info-fg", "--info-soft", "--status-new-soft", "--status-new-fg", "--status-sent-soft", "--status-sent-fg", "--status-pending-soft", "--status-pending-fg", "--status-approved-soft", "--status-approved-fg", "--status-rejected-soft", "--status-rejected-fg", "--status-neutral-soft", "--status-neutral-fg"];
+    for (var _i2 = 0, _required2 = required; _i2 < _required2.length; _i2++) {
+      var v = _required2[_i2];
+      expect(css).toContain("".concat(v, ":"));
+    }
+  });
+  test("emits the typography variables", function () {
+    var required = ["--font-sans", "--font-mono", "--text-display", "--text-h2", "--text-h3", "--text-h4", "--text-body", "--text-sm", "--text-xs", "--fw-regular", "--fw-medium", "--fw-semibold", "--fw-bold", "--lh-tight", "--lh-snug", "--lh-normal", "--lh-loose",
+    // A7-02 — letter-spacing scale.
+    "--ls-tight", "--ls-normal", "--ls-wide"];
+    for (var _i3 = 0, _required3 = required; _i3 < _required3.length; _i3++) {
+      var v = _required3[_i3];
+      expect(css).toContain("".concat(v, ":"));
+    }
+  });
+
+  /**
+   * A7-02 regression guard — the PHANTOM TOKEN class.
+   *
+   * The ms-dfd-fe Area 7 audit found six token names referenced across two
+   * certified modules that this emitter never emitted: --ls-tight, --ls-wide,
+   * --border-subtle, --r-xs, --icon-sm, --icon-xl. Because every consumer wrote
+   * `var(--x, <literal>)`, the literal was the ONLY thing that ever rendered —
+   * a hard-coded magic value wearing a token's name, invisible to review and
+   * undetectable by tsc (R-2.3 / R-AI.1).
+   *
+   * The two letter-spacing names had a real platform basis and are now emitted
+   * (asserted above). The other four were local inventions with no basis in the
+   * Charter's token tables; asserting their ABSENCE here stops someone
+   * "resolving" a phantom reference by inventing the token instead of fixing the
+   * call site. Adding any of them is a Charter §02 amendment and must arrive
+   * with its table entry, not via a failing consumer.
+   */
+  test("does NOT emit the four rejected phantom tokens (A7-02)", function () {
+    for (var _i4 = 0, _arr = ["--border-subtle", "--r-xs", "--icon-sm", "--icon-xl"]; _i4 < _arr.length; _i4++) {
+      var v = _arr[_i4];
+      expect(css).not.toContain("".concat(v, ":"));
+    }
+  });
+  test("emits the spacing grid (--s-1 through --s-10)", function () {
+    for (var i = 1; i <= 10; i += 1) {
+      expect(css).toContain("--s-".concat(i, ":"));
+    }
+  });
+  test("emits the spacing aliases under --space-* prefix", function () {
+    var aliases = ["xs", "sm", "md", "lg", "xl", "xxl"];
+    for (var _i5 = 0, _aliases = aliases; _i5 < _aliases.length; _i5++) {
+      var a = _aliases[_i5];
+      expect(css).toContain("--space-".concat(a, ":"));
+    }
+  });
+  test("does NOT emit unprefixed alias names that would pollute the global CSS namespace", function () {
+    // Bare --md / --lg / --xl would collide with consumer stylesheets.
+    // Batch 2 explicitly partitioned spacing into numeric grid (--s-N)
+    // and semantic aliases (--space-X) to prevent this.
+    // Use word boundaries so we don't false-match --r-md, --space-md, etc.
+    var polluters = [/[^\w-]--xs\s*:/, /[^\w-]--sm\s*:/, /[^\w-]--md\s*:/, /[^\w-]--lg\s*:/, /[^\w-]--xl\s*:/, /[^\w-]--xxl\s*:/];
+    for (var _i6 = 0, _polluters = polluters; _i6 < _polluters.length; _i6++) {
+      var re = _polluters[_i6];
+      expect(css).not.toMatch(re);
+    }
+  });
+  test("emits radius, shadow, motion, easing, layout, density", function () {
+    var required = ["--r-sm", "--r-md", "--r-lg", "--r-xl", "--r-full", "--r-none", "--shadow-xs", "--shadow-sm", "--shadow-md", "--shadow-lg", "--shadow-focus", "--duration-fast", "--duration-base", "--duration-slow", "--easing-out", "--easing-in", "--easing-soft", "--sidebar-w", "--topbar-h", "--content-max", "--form-max", "--tactile-min", "--row-h", "--input-h", "--btn-h", "--text-fs"];
+    for (var _i7 = 0, _required4 = required; _i7 < _required4.length; _i7++) {
+      var v = _required4[_i7];
+      expect(css).toContain("".concat(v, ":"));
+    }
+  });
+  test("emits z-index variables", function () {
+    // Iterates the full zIndex object in cssVariables, so any
+    // future zIndex slot (popover, snackbar, tooltip from Batch 1)
+    // surfaces here without code change.
+    expect(css).toMatch(/--z-modal\s*:/);
+    expect(css).toMatch(/--z-sticky\s*:/);
+  });
+  test("emits the dark-mode override block with derived soft variants", function () {
+    expect(css).toContain('[data-theme="dark"]');
+    // Soft semantic fills are color-mix-derived in dark, not static hex
+    // (Batch 2 contrast fix for WCAG 1.4.11 non-text on dark surfaces).
+    expect(css).toMatch(/--success-soft:\s*color-mix/);
+    expect(css).toMatch(/--danger-soft:\s*color-mix/);
+    expect(css).toMatch(/--warning-soft:\s*color-mix/);
+    expect(css).toMatch(/--info-soft:\s*color-mix/);
+  });
+  test("emits the compact density override block", function () {
+    expect(css).toContain('[data-density="compact"]');
+    // Compact override shrinks the row/input/btn heights.
+    expect(css).toMatch(/\[data-density="compact"\][\s\S]*--btn-h:/);
+  });
+  test("emits the collapsed-sidebar override", function () {
+    expect(css).toContain('[data-nav-collapsed="true"]');
+  });
+  test("brand override propagates through resolveBrand", function () {
+    var customCss = getCssVariables({
+      brand: {
+        accent: "#FF0000"
+      }
+    });
+    expect(customCss).toContain("--accent: #FF0000;");
+    // Default also still emits its accent
+    expect(css).toMatch(/--accent:\s*#[0-9a-fA-F]{3,8}/);
+  });
+  test("brand override does NOT pollute other brand fields when omitted", function () {
+    // Partial brand override — accentSoft should fall back to default,
+    // not to undefined or an empty string.
+    var customCss = getCssVariables({
+      brand: {
+        accent: "#FF0000"
+      }
+    });
+    expect(customCss).not.toMatch(/--accent-soft:\s*undefined/);
+    expect(customCss).not.toMatch(/--accent-soft:\s*;/);
+    expect(customCss).toMatch(/--accent-soft:\s*\S+/);
+  });
+});
+//# sourceMappingURL=cssVariables.test.js.map

package/dist/esm/v2/__tests__/cssVariables.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cssVariables.test.js","names":["getCssVariables","describe","css","beforeAll","test","expect","toMatch","matches","match","toBeNull","not","required","_i","_required","length","v","toContain","concat","_i2","_required2","_i3","_required3","_i4","_arr","i","aliases","_i5","_aliases","a","polluters","_i6","_polluters","re","_i7","_required4","customCss","brand","accent"],"sources":["../../../../src/lib/v2/__tests__/cssVariables.test.ts"],"sourcesContent":["import { getCssVariables } from \"../theme/cssVariables\";\r\n\r\n/**\r\n * Regression coverage for the v2 CSS variable emission.\r\n *\r\n * These invariants are established by Batch 1 (token refactor) and\r\n * Batch 2 (cssVariables refactor). A failure here means a future\r\n * change has either:\r\n *   - re-introduced a deleted token (e.g. --fw-black),\r\n *   - emitted an undefined value (the silent bug class that broke\r\n *     KPICard and FormSection visually before Batch 6+7 caught it),\r\n *   - dropped a critical variable downstream consumers rely on, or\r\n *   - leaked an alias name (--md / --lg) into the global namespace.\r\n */\r\ndescribe(\"getCssVariables() — Batch 1 + 2 invariants\", () => {\r\n  let css: string;\r\n  beforeAll(() => {\r\n    css = getCssVariables();\r\n  });\r\n\r\n  test(\"emits a :root block\", () => {\r\n    expect(css).toMatch(/:root\\s*\\{/);\r\n  });\r\n\r\n  test(\"never emits ': undefined' values (the ghost-token bug class)\", () => {\r\n    // Match `--anything: undefined;` with optional whitespace.\r\n    // This catches the regression that produced --fw-black resolving\r\n    // to undefined in :root after Batch 1 removed fontWeight.black.\r\n    const matches = css.match(/--[\\w-]+\\s*:\\s*undefined\\b/g);\r\n    expect(matches).toBeNull();\r\n  });\r\n\r\n  test(\"does NOT emit --fw-black (Batch 1 removed fontWeight.black)\", () => {\r\n    expect(css).not.toMatch(/--fw-black/);\r\n  });\r\n\r\n  test(\"emits all critical brand + ink + surface variables\", () => {\r\n    const required = [\r\n      \"--accent\", \"--accent-soft\", \"--accent-hover\", \"--accent-fg\",\r\n      \"--fg\", \"--fg-muted\", \"--fg-subtle\", \"--fg-inverse\",\r\n      \"--bg\", \"--bg-elev\", \"--bg-subtle\", \"--bg-hover\", \"--surface\",\r\n      \"--border\", \"--border-strong\",\r\n    ];\r\n    for (const v of required) {\r\n      expect(css).toContain(`${v}:`);\r\n    }\r\n  });\r\n\r\n  test(\"emits all semantic + status palette variables\", () => {\r\n    const required = [\r\n      \"--success\", \"--success-fg\", \"--success-soft\",\r\n      \"--danger\",  \"--danger-fg\",  \"--danger-soft\",\r\n      \"--warning\", \"--warning-fg\", \"--warning-soft\",\r\n      \"--info\",    \"--info-fg\",    \"--info-soft\",\r\n      \"--status-new-soft\",      \"--status-new-fg\",\r\n      \"--status-sent-soft\",     \"--status-sent-fg\",\r\n      \"--status-pending-soft\",  \"--status-pending-fg\",\r\n      \"--status-approved-soft\", \"--status-approved-fg\",\r\n      \"--status-rejected-soft\", \"--status-rejected-fg\",\r\n      \"--status-neutral-soft\",  \"--status-neutral-fg\",\r\n    ];\r\n    for (const v of required) {\r\n      expect(css).toContain(`${v}:`);\r\n    }\r\n  });\r\n\r\n  test(\"emits the typography variables\", () => {\r\n    const required = [\r\n      \"--font-sans\", \"--font-mono\",\r\n      \"--text-display\", \"--text-h2\", \"--text-h3\", \"--text-h4\",\r\n      \"--text-body\", \"--text-sm\", \"--text-xs\",\r\n      \"--fw-regular\", \"--fw-medium\", \"--fw-semibold\", \"--fw-bold\",\r\n      \"--lh-tight\", \"--lh-snug\", \"--lh-normal\", \"--lh-loose\",\r\n      // A7-02 — letter-spacing scale.\r\n      \"--ls-tight\", \"--ls-normal\", \"--ls-wide\",\r\n    ];\r\n    for (const v of required) {\r\n      expect(css).toContain(`${v}:`);\r\n    }\r\n  });\r\n\r\n  /**\r\n   * A7-02 regression guard — the PHANTOM TOKEN class.\r\n   *\r\n   * The ms-dfd-fe Area 7 audit found six token names referenced across two\r\n   * certified modules that this emitter never emitted: --ls-tight, --ls-wide,\r\n   * --border-subtle, --r-xs, --icon-sm, --icon-xl. Because every consumer wrote\r\n   * `var(--x, <literal>)`, the literal was the ONLY thing that ever rendered —\r\n   * a hard-coded magic value wearing a token's name, invisible to review and\r\n   * undetectable by tsc (R-2.3 / R-AI.1).\r\n   *\r\n   * The two letter-spacing names had a real platform basis and are now emitted\r\n   * (asserted above). The other four were local inventions with no basis in the\r\n   * Charter's token tables; asserting their ABSENCE here stops someone\r\n   * \"resolving\" a phantom reference by inventing the token instead of fixing the\r\n   * call site. Adding any of them is a Charter §02 amendment and must arrive\r\n   * with its table entry, not via a failing consumer.\r\n   */\r\n  test(\"does NOT emit the four rejected phantom tokens (A7-02)\", () => {\r\n    for (const v of [\"--border-subtle\", \"--r-xs\", \"--icon-sm\", \"--icon-xl\"]) {\r\n      expect(css).not.toContain(`${v}:`);\r\n    }\r\n  });\r\n\r\n  test(\"emits the spacing grid (--s-1 through --s-10)\", () => {\r\n    for (let i = 1; i <= 10; i += 1) {\r\n      expect(css).toContain(`--s-${i}:`);\r\n    }\r\n  });\r\n\r\n  test(\"emits the spacing aliases under --space-* prefix\", () => {\r\n    const aliases = [\"xs\", \"sm\", \"md\", \"lg\", \"xl\", \"xxl\"];\r\n    for (const a of aliases) {\r\n      expect(css).toContain(`--space-${a}:`);\r\n    }\r\n  });\r\n\r\n  test(\"does NOT emit unprefixed alias names that would pollute the global CSS namespace\", () => {\r\n    // Bare --md / --lg / --xl would collide with consumer stylesheets.\r\n    // Batch 2 explicitly partitioned spacing into numeric grid (--s-N)\r\n    // and semantic aliases (--space-X) to prevent this.\r\n    // Use word boundaries so we don't false-match --r-md, --space-md, etc.\r\n    const polluters = [\r\n      /[^\\w-]--xs\\s*:/,\r\n      /[^\\w-]--sm\\s*:/,\r\n      /[^\\w-]--md\\s*:/,\r\n      /[^\\w-]--lg\\s*:/,\r\n      /[^\\w-]--xl\\s*:/,\r\n      /[^\\w-]--xxl\\s*:/,\r\n    ];\r\n    for (const re of polluters) {\r\n      expect(css).not.toMatch(re);\r\n    }\r\n  });\r\n\r\n  test(\"emits radius, shadow, motion, easing, layout, density\", () => {\r\n    const required = [\r\n      \"--r-sm\", \"--r-md\", \"--r-lg\", \"--r-xl\", \"--r-full\", \"--r-none\",\r\n      \"--shadow-xs\", \"--shadow-sm\", \"--shadow-md\", \"--shadow-lg\", \"--shadow-focus\",\r\n      \"--duration-fast\", \"--duration-base\", \"--duration-slow\",\r\n      \"--easing-out\", \"--easing-in\", \"--easing-soft\",\r\n      \"--sidebar-w\", \"--topbar-h\", \"--content-max\", \"--form-max\", \"--tactile-min\",\r\n      \"--row-h\", \"--input-h\", \"--btn-h\", \"--text-fs\",\r\n    ];\r\n    for (const v of required) {\r\n      expect(css).toContain(`${v}:`);\r\n    }\r\n  });\r\n\r\n  test(\"emits z-index variables\", () => {\r\n    // Iterates the full zIndex object in cssVariables, so any\r\n    // future zIndex slot (popover, snackbar, tooltip from Batch 1)\r\n    // surfaces here without code change.\r\n    expect(css).toMatch(/--z-modal\\s*:/);\r\n    expect(css).toMatch(/--z-sticky\\s*:/);\r\n  });\r\n\r\n  test(\"emits the dark-mode override block with derived soft variants\", () => {\r\n    expect(css).toContain('[data-theme=\"dark\"]');\r\n    // Soft semantic fills are color-mix-derived in dark, not static hex\r\n    // (Batch 2 contrast fix for WCAG 1.4.11 non-text on dark surfaces).\r\n    expect(css).toMatch(/--success-soft:\\s*color-mix/);\r\n    expect(css).toMatch(/--danger-soft:\\s*color-mix/);\r\n    expect(css).toMatch(/--warning-soft:\\s*color-mix/);\r\n    expect(css).toMatch(/--info-soft:\\s*color-mix/);\r\n  });\r\n\r\n  test(\"emits the compact density override block\", () => {\r\n    expect(css).toContain('[data-density=\"compact\"]');\r\n    // Compact override shrinks the row/input/btn heights.\r\n    expect(css).toMatch(/\\[data-density=\"compact\"\\][\\s\\S]*--btn-h:/);\r\n  });\r\n\r\n  test(\"emits the collapsed-sidebar override\", () => {\r\n    expect(css).toContain('[data-nav-collapsed=\"true\"]');\r\n  });\r\n\r\n  test(\"brand override propagates through resolveBrand\", () => {\r\n    const customCss = getCssVariables({ brand: { accent: \"#FF0000\" } });\r\n    expect(customCss).toContain(\"--accent: #FF0000;\");\r\n    // Default also still emits its accent\r\n    expect(css).toMatch(/--accent:\\s*#[0-9a-fA-F]{3,8}/);\r\n  });\r\n\r\n  test(\"brand override does NOT pollute other brand fields when omitted\", () => {\r\n    // Partial brand override — accentSoft should fall back to default,\r\n    // not to undefined or an empty string.\r\n    const customCss = getCssVariables({ brand: { accent: \"#FF0000\" } });\r\n    expect(customCss).not.toMatch(/--accent-soft:\\s*undefined/);\r\n    expect(customCss).not.toMatch(/--accent-soft:\\s*;/);\r\n    expect(customCss).toMatch(/--accent-soft:\\s*\\S+/);\r\n  });\r\n});\r\n"],"mappings":"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","ignoreList":[]}

package/dist/esm/v2/__tests__/labels-merge.test.js

@@ -0,0 +1,146 @@
+import "@testing-library/jest-dom";
+import { render, screen } from "@testing-library/react";
+import DataGrid from "../patterns/DataGrid";
+
+/**
+ * Verifies the deep-merge contract for the `labels` prop pattern
+ * shared by 17 components / patterns in v2 (Batches 4-7).
+ *
+ * DataGrid is the canonical test subject because it has the deepest
+ * label surface (top-level keys + nested `pagination.*`). The
+ * Object.freeze on DEFAULT_LABELS protects against accidental
+ * mutation; the mergeLabels helper must spread the nested object,
+ * not replace it.
+ */
+import { jsx as _jsx } from "react/jsx-runtime";
+describe("DataGrid — labels deep-merge contract", function () {
+  var baseRows = Array.from({
+    length: 10
+  }, function (_, i) {
+    return {
+      id: i + 1
+    };
+  });
+  test("with no labels prop, all defaults render in French", function () {
+    render(/*#__PURE__*/_jsx(DataGrid, {
+      rows: baseRows,
+      columns: [{
+        key: "id",
+        header: "ID"
+      }],
+      pagination: {
+        page: 1,
+        pageSize: 25,
+        total: 100,
+        onPageChange: function onPageChange() {}
+      }
+    }));
+
+    // Pagination FR defaults
+    expect(screen.getByLabelText("Première page")).toBeInTheDocument();
+    expect(screen.getByLabelText("Page précédente")).toBeInTheDocument();
+    expect(screen.getByLabelText("Page suivante")).toBeInTheDocument();
+    expect(screen.getByLabelText("Dernière page")).toBeInTheDocument();
+  });
+  test("partial labels.pagination merges onto FR defaults — overridden keys win", function () {
+    render(/*#__PURE__*/_jsx(DataGrid, {
+      rows: baseRows,
+      columns: [{
+        key: "id",
+        header: "ID"
+      }],
+      pagination: {
+        page: 1,
+        pageSize: 25,
+        total: 100,
+        onPageChange: function onPageChange() {}
+      },
+      labels: {
+        pagination: {
+          firstPage: "First!"
+          // lastPage, previousPage, nextPage, loading, rowsPerPage,
+          // rangeOf NOT provided — must fall back to FR defaults.
+        }
+      }
+    }));
+
+    // Custom override applied
+    expect(screen.getByLabelText("First!")).toBeInTheDocument();
+
+    // FR defaults preserved (the regression class this test guards)
+    expect(screen.getByLabelText("Page précédente")).toBeInTheDocument();
+    expect(screen.getByLabelText("Page suivante")).toBeInTheDocument();
+    expect(screen.getByLabelText("Dernière page")).toBeInTheDocument();
+  });
+  test("partial top-level labels merge onto FR defaults", function () {
+    render(/*#__PURE__*/_jsx(DataGrid, {
+      rows: baseRows,
+      columns: [{
+        key: "id",
+        header: "ID"
+      }],
+      pagination: {
+        page: 1,
+        pageSize: 25,
+        total: 100,
+        onPageChange: function onPageChange() {}
+      },
+      onSelectionChange: function onSelectionChange() {},
+      labels: {
+        tableAria: "My table"
+        // selectAll, selectRow, pagination NOT provided — defaults stand.
+      }
+    }));
+    expect(screen.getByLabelText("My table")).toBeInTheDocument();
+    // Default selectAll FR survives
+    expect(screen.getByLabelText("Tout sélectionner")).toBeInTheDocument();
+    // Default pagination FR survives
+    expect(screen.getByLabelText("Première page")).toBeInTheDocument();
+  });
+  test("legacy ariaLabel prop wins over labels.tableAria (back-compat contract)", function () {
+    render(/*#__PURE__*/_jsx(DataGrid, {
+      rows: baseRows,
+      columns: [{
+        key: "id",
+        header: "ID"
+      }],
+      pagination: {
+        page: 1,
+        pageSize: 25,
+        total: 100,
+        onPageChange: function onPageChange() {}
+      },
+      ariaLabel: "Legacy wins",
+      labels: {
+        tableAria: "New label"
+      }
+    }));
+    expect(screen.getByLabelText("Legacy wins")).toBeInTheDocument();
+    // The labels.tableAria value should NOT appear
+    expect(screen.queryByLabelText("New label")).not.toBeInTheDocument();
+  });
+  test("rangeOf custom function reaches the rendered range text", function () {
+    render(/*#__PURE__*/_jsx(DataGrid, {
+      rows: baseRows,
+      columns: [{
+        key: "id",
+        header: "ID"
+      }],
+      pagination: {
+        page: 1,
+        pageSize: 25,
+        total: 100,
+        onPageChange: function onPageChange() {}
+      },
+      labels: {
+        pagination: {
+          rangeOf: function rangeOf(from, to, total) {
+            return "Showing ".concat(from, " to ").concat(to, " of ").concat(total);
+          }
+        }
+      }
+    }));
+    expect(screen.getByText(/Showing 1 to 25 of 100/)).toBeInTheDocument();
+  });
+});
+//# sourceMappingURL=labels-merge.test.js.map

package/dist/esm/v2/__tests__/labels-merge.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"labels-merge.test.js","names":["render","screen","DataGrid","jsx","_jsx","describe","baseRows","Array","from","length","_","i","id","test","rows","columns","key","header","pagination","page","pageSize","total","onPageChange","expect","getByLabelText","toBeInTheDocument","labels","firstPage","onSelectionChange","tableAria","ariaLabel","queryByLabelText","not","rangeOf","to","concat","getByText"],"sources":["../../../../src/lib/v2/__tests__/labels-merge.test.tsx"],"sourcesContent":["import \"@testing-library/jest-dom\";\r\nimport { render, screen } from \"@testing-library/react\";\r\nimport DataGrid from \"../patterns/DataGrid\";\r\n\r\n/**\r\n * Verifies the deep-merge contract for the `labels` prop pattern\r\n * shared by 17 components / patterns in v2 (Batches 4-7).\r\n *\r\n * DataGrid is the canonical test subject because it has the deepest\r\n * label surface (top-level keys + nested `pagination.*`). The\r\n * Object.freeze on DEFAULT_LABELS protects against accidental\r\n * mutation; the mergeLabels helper must spread the nested object,\r\n * not replace it.\r\n */\r\ninterface Row {\r\n  id: number;\r\n}\r\n\r\ndescribe(\"DataGrid — labels deep-merge contract\", () => {\r\n  const baseRows: Row[] = Array.from({ length: 10 }, (_, i): Row => ({\r\n    id: i + 1,\r\n  }));\r\n\r\n  test(\"with no labels prop, all defaults render in French\", () => {\r\n    render(\r\n      <DataGrid\r\n        rows={baseRows}\r\n        columns={[{ key: \"id\", header: \"ID\" }]}\r\n        pagination={{ page: 1, pageSize: 25, total: 100, onPageChange: () => {} }}\r\n      />\r\n    );\r\n\r\n    // Pagination FR defaults\r\n    expect(screen.getByLabelText(\"Première page\")).toBeInTheDocument();\r\n    expect(screen.getByLabelText(\"Page précédente\")).toBeInTheDocument();\r\n    expect(screen.getByLabelText(\"Page suivante\")).toBeInTheDocument();\r\n    expect(screen.getByLabelText(\"Dernière page\")).toBeInTheDocument();\r\n  });\r\n\r\n  test(\"partial labels.pagination merges onto FR defaults — overridden keys win\", () => {\r\n    render(\r\n      <DataGrid\r\n        rows={baseRows}\r\n        columns={[{ key: \"id\", header: \"ID\" }]}\r\n        pagination={{ page: 1, pageSize: 25, total: 100, onPageChange: () => {} }}\r\n        labels={{\r\n          pagination: {\r\n            firstPage: \"First!\",\r\n            // lastPage, previousPage, nextPage, loading, rowsPerPage,\r\n            // rangeOf NOT provided — must fall back to FR defaults.\r\n          },\r\n        }}\r\n      />\r\n    );\r\n\r\n    // Custom override applied\r\n    expect(screen.getByLabelText(\"First!\")).toBeInTheDocument();\r\n\r\n    // FR defaults preserved (the regression class this test guards)\r\n    expect(screen.getByLabelText(\"Page précédente\")).toBeInTheDocument();\r\n    expect(screen.getByLabelText(\"Page suivante\")).toBeInTheDocument();\r\n    expect(screen.getByLabelText(\"Dernière page\")).toBeInTheDocument();\r\n  });\r\n\r\n  test(\"partial top-level labels merge onto FR defaults\", () => {\r\n    render(\r\n      <DataGrid\r\n        rows={baseRows}\r\n        columns={[{ key: \"id\", header: \"ID\" }]}\r\n        pagination={{ page: 1, pageSize: 25, total: 100, onPageChange: () => {} }}\r\n        onSelectionChange={() => {}}\r\n        labels={{\r\n          tableAria: \"My table\",\r\n          // selectAll, selectRow, pagination NOT provided — defaults stand.\r\n        }}\r\n      />\r\n    );\r\n\r\n    expect(screen.getByLabelText(\"My table\")).toBeInTheDocument();\r\n    // Default selectAll FR survives\r\n    expect(screen.getByLabelText(\"Tout sélectionner\")).toBeInTheDocument();\r\n    // Default pagination FR survives\r\n    expect(screen.getByLabelText(\"Première page\")).toBeInTheDocument();\r\n  });\r\n\r\n  test(\"legacy ariaLabel prop wins over labels.tableAria (back-compat contract)\", () => {\r\n    render(\r\n      <DataGrid\r\n        rows={baseRows}\r\n        columns={[{ key: \"id\", header: \"ID\" }]}\r\n        pagination={{ page: 1, pageSize: 25, total: 100, onPageChange: () => {} }}\r\n        ariaLabel=\"Legacy wins\"\r\n        labels={{ tableAria: \"New label\" }}\r\n      />\r\n    );\r\n\r\n    expect(screen.getByLabelText(\"Legacy wins\")).toBeInTheDocument();\r\n    // The labels.tableAria value should NOT appear\r\n    expect(screen.queryByLabelText(\"New label\")).not.toBeInTheDocument();\r\n  });\r\n\r\n  test(\"rangeOf custom function reaches the rendered range text\", () => {\r\n    render(\r\n      <DataGrid\r\n        rows={baseRows}\r\n        columns={[{ key: \"id\", header: \"ID\" }]}\r\n        pagination={{ page: 1, pageSize: 25, total: 100, onPageChange: () => {} }}\r\n        labels={{\r\n          pagination: {\r\n            rangeOf: (from, to, total) => `Showing ${from} to ${to} of ${total}`,\r\n          },\r\n        }}\r\n      />\r\n    );\r\n\r\n    expect(screen.getByText(/Showing 1 to 25 of 100/)).toBeInTheDocument();\r\n  });\r\n});\r\n"],"mappings":"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","ignoreList":[]}