@portnet/ui 5.0.32 → 6.0.1

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,147 @@
+import "@testing-library/jest-dom";
+import * as React from "react";
+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":["React","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 * as React from \"react\";\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":[]}

package/dist/esm/v2/__tests__/locale-fallback.test.js

@@ -0,0 +1,109 @@
+import fmtMoney from "../utils/fmtMoney";
+
+/**
+ * Contract tests for fmtMoney — the canonical v2 money formatter.
+ *
+ * The graceful-display contract (returns "—" for bad input, never
+ * throws on bad locale) underpins TradeDirect dashboard cells.
+ * Removing it would let a malformed amount or a typo'd locale crash
+ * an entire row of a DataGrid.
+ */
+describe("fmtMoney — contract", function () {
+  describe("graceful empty-cell fallback", function () {
+    test("returns '—' for null", function () {
+      expect(fmtMoney(null)).toBe("—");
+    });
+    test("returns '—' for undefined", function () {
+      expect(fmtMoney(undefined)).toBe("—");
+    });
+    test("returns '—' for empty string", function () {
+      expect(fmtMoney("")).toBe("—");
+    });
+    test("returns '—' for NaN", function () {
+      expect(fmtMoney(NaN)).toBe("—");
+    });
+    test("returns '—' for Infinity", function () {
+      expect(fmtMoney(Infinity)).toBe("—");
+      expect(fmtMoney(-Infinity)).toBe("—");
+    });
+    test("returns '—' for non-numeric string", function () {
+      expect(fmtMoney("abc")).toBe("—");
+    });
+    test("coerces numeric strings to numbers", function () {
+      // "1234.5" should format identically to 1234.5
+      expect(fmtMoney("1234.5")).toBe(fmtMoney(1234.5));
+    });
+  });
+  describe("locale-aware formatting", function () {
+    test("formats with the default fr-FR locale", function () {
+      var out = fmtMoney(1234.5);
+      // FR uses comma as decimal separator. Thousand separator is a
+      // non-breaking space (U+00A0) or narrow non-breaking space
+      // (U+202F) depending on the runtime — accept either.
+      expect(out).toMatch(/1[\u00A0\u202F\s]234,5/);
+    });
+    test("formats under en-US when explicitly passed", function () {
+      var out = fmtMoney(1234.5, "USD", {
+        locale: "en-US"
+      });
+      expect(out).toContain("1,234.5");
+      expect(out).toContain("USD");
+    });
+    test("respects minimumFractionDigits", function () {
+      var out = fmtMoney(1234, "EUR", {
+        minimumFractionDigits: 2
+      });
+      // Default fr-FR locale; 2 fraction digits → trailing ",00"
+      expect(out).toMatch(/1[\u00A0\u202F\s]234,00/);
+    });
+    test("respects maximumFractionDigits", function () {
+      var out = fmtMoney(1.23456, "", {
+        maximumFractionDigits: 2
+      });
+      // Should round to 2 fraction digits in fr-FR (",23")
+      expect(out).toMatch(/1,23\b/);
+    });
+    test("appends the currency suffix when supplied", function () {
+      expect(fmtMoney(100, "EUR")).toContain("EUR");
+      expect(fmtMoney(100, "MAD")).toContain("MAD");
+      expect(fmtMoney(100, "USD")).toContain("USD");
+    });
+    test("omits the currency suffix when blank", function () {
+      var out = fmtMoney(100, "");
+      expect(out).not.toMatch(/[A-Z]{3}/);
+    });
+  });
+  describe("locale fallback (the regression-class guard)", function () {
+    test("does not throw on an invalid BCP-47 tag", function () {
+      expect(function () {
+        return fmtMoney(100, "EUR", {
+          locale: "not-a-real-locale"
+        });
+      }).not.toThrow();
+    });
+    test("falls back to fr-FR formatting on invalid locale", function () {
+      var out = fmtMoney(1234.5, "EUR", {
+        locale: "not-a-real-locale"
+      });
+      // Should produce the FR comma-decimal form, not crash and
+      // not return undefined.
+      expect(out).toMatch(/1[\u00A0\u202F\s]234,5/);
+      expect(out).toContain("EUR");
+    });
+    test("does not throw on garbage object (defensive)", function () {
+      // fmtMoney's opts.locale is typed `string | undefined`, but real hosts
+      // occasionally pass a wrong runtime value. The @ts-expect-error documents
+      // that this input is intentionally ill-typed and asserts the runtime
+      // guard (catch → fr-FR fallback) handles any value, not just RangeError.
+      expect(function () {
+        return (
+          // @ts-expect-error — intentional invalid locale type (runtime robustness)
+          fmtMoney(100, "EUR", {
+            locale: 12345
+          })
+        );
+      }).not.toThrow();
+    });
+  });
+});
+//# sourceMappingURL=locale-fallback.test.js.map

package/dist/esm/v2/__tests__/locale-fallback.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"locale-fallback.test.js","names":["fmtMoney","describe","test","expect","toBe","undefined","NaN","Infinity","out","toMatch","locale","toContain","minimumFractionDigits","maximumFractionDigits","not","toThrow"],"sources":["../../../../src/lib/v2/__tests__/locale-fallback.test.ts"],"sourcesContent":["import fmtMoney from \"../utils/fmtMoney\";\r\n\r\n/**\r\n * Contract tests for fmtMoney — the canonical v2 money formatter.\r\n *\r\n * The graceful-display contract (returns \"—\" for bad input, never\r\n * throws on bad locale) underpins TradeDirect dashboard cells.\r\n * Removing it would let a malformed amount or a typo'd locale crash\r\n * an entire row of a DataGrid.\r\n */\r\ndescribe(\"fmtMoney — contract\", () => {\r\n  describe(\"graceful empty-cell fallback\", () => {\r\n    test(\"returns '—' for null\", () => {\r\n      expect(fmtMoney(null)).toBe(\"—\");\r\n    });\r\n\r\n    test(\"returns '—' for undefined\", () => {\r\n      expect(fmtMoney(undefined)).toBe(\"—\");\r\n    });\r\n\r\n    test(\"returns '—' for empty string\", () => {\r\n      expect(fmtMoney(\"\")).toBe(\"—\");\r\n    });\r\n\r\n    test(\"returns '—' for NaN\", () => {\r\n      expect(fmtMoney(NaN)).toBe(\"—\");\r\n    });\r\n\r\n    test(\"returns '—' for Infinity\", () => {\r\n      expect(fmtMoney(Infinity)).toBe(\"—\");\r\n      expect(fmtMoney(-Infinity)).toBe(\"—\");\r\n    });\r\n\r\n    test(\"returns '—' for non-numeric string\", () => {\r\n      expect(fmtMoney(\"abc\")).toBe(\"—\");\r\n    });\r\n\r\n    test(\"coerces numeric strings to numbers\", () => {\r\n      // \"1234.5\" should format identically to 1234.5\r\n      expect(fmtMoney(\"1234.5\")).toBe(fmtMoney(1234.5));\r\n    });\r\n  });\r\n\r\n  describe(\"locale-aware formatting\", () => {\r\n    test(\"formats with the default fr-FR locale\", () => {\r\n      const out = fmtMoney(1234.5);\r\n      // FR uses comma as decimal separator. Thousand separator is a\r\n      // non-breaking space (U+00A0) or narrow non-breaking space\r\n      // (U+202F) depending on the runtime — accept either.\r\n      expect(out).toMatch(/1[\\u00A0\\u202F\\s]234,5/);\r\n    });\r\n\r\n    test(\"formats under en-US when explicitly passed\", () => {\r\n      const out = fmtMoney(1234.5, \"USD\", { locale: \"en-US\" });\r\n      expect(out).toContain(\"1,234.5\");\r\n      expect(out).toContain(\"USD\");\r\n    });\r\n\r\n    test(\"respects minimumFractionDigits\", () => {\r\n      const out = fmtMoney(1234, \"EUR\", { minimumFractionDigits: 2 });\r\n      // Default fr-FR locale; 2 fraction digits → trailing \",00\"\r\n      expect(out).toMatch(/1[\\u00A0\\u202F\\s]234,00/);\r\n    });\r\n\r\n    test(\"respects maximumFractionDigits\", () => {\r\n      const out = fmtMoney(1.23456, \"\", { maximumFractionDigits: 2 });\r\n      // Should round to 2 fraction digits in fr-FR (\",23\")\r\n      expect(out).toMatch(/1,23\\b/);\r\n    });\r\n\r\n    test(\"appends the currency suffix when supplied\", () => {\r\n      expect(fmtMoney(100, \"EUR\")).toContain(\"EUR\");\r\n      expect(fmtMoney(100, \"MAD\")).toContain(\"MAD\");\r\n      expect(fmtMoney(100, \"USD\")).toContain(\"USD\");\r\n    });\r\n\r\n    test(\"omits the currency suffix when blank\", () => {\r\n      const out = fmtMoney(100, \"\");\r\n      expect(out).not.toMatch(/[A-Z]{3}/);\r\n    });\r\n  });\r\n\r\n  describe(\"locale fallback (the regression-class guard)\", () => {\r\n    test(\"does not throw on an invalid BCP-47 tag\", () => {\r\n      expect(() =>\r\n        fmtMoney(100, \"EUR\", { locale: \"not-a-real-locale\" })\r\n      ).not.toThrow();\r\n    });\r\n\r\n    test(\"falls back to fr-FR formatting on invalid locale\", () => {\r\n      const out = fmtMoney(1234.5, \"EUR\", { locale: \"not-a-real-locale\" });\r\n      // Should produce the FR comma-decimal form, not crash and\r\n      // not return undefined.\r\n      expect(out).toMatch(/1[\\u00A0\\u202F\\s]234,5/);\r\n      expect(out).toContain(\"EUR\");\r\n    });\r\n\r\n    test(\"does not throw on garbage object (defensive)\", () => {\r\n      // fmtMoney's opts.locale is typed `string | undefined`, but real hosts\r\n      // occasionally pass a wrong runtime value. The @ts-expect-error documents\r\n      // that this input is intentionally ill-typed and asserts the runtime\r\n      // guard (catch → fr-FR fallback) handles any value, not just RangeError.\r\n      expect(() =>\r\n        // @ts-expect-error — intentional invalid locale type (runtime robustness)\r\n        fmtMoney(100, \"EUR\", { locale: 12345 })\r\n      ).not.toThrow();\r\n    });\r\n  });\r\n});\r\n"],"mappings":"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","ignoreList":[]}