@portnet/ui 6.0.0 → 6.0.1

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

@@ -0,0 +1,431 @@
+function _typeof(obj) { "@babel/helpers - typeof"; return _typeof = "function" == typeof Symbol && "symbol" == typeof Symbol.iterator ? function (obj) { return typeof obj; } : function (obj) { return obj && "function" == typeof Symbol && obj.constructor === Symbol && obj !== Symbol.prototype ? "symbol" : typeof obj; }, _typeof(obj); }
+function _createForOfIteratorHelper(o, allowArrayLike) { var it = typeof Symbol !== "undefined" && o[Symbol.iterator] || o["@@iterator"]; if (!it) { if (Array.isArray(o) || (it = _unsupportedIterableToArray(o)) || allowArrayLike && o && typeof o.length === "number") { if (it) o = it; var i = 0; var F = function F() {}; return { s: F, n: function n() { if (i >= o.length) return { done: true }; return { done: false, value: o[i++] }; }, e: function e(_e) { throw _e; }, f: F }; } throw new TypeError("Invalid attempt to iterate non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method."); } var normalCompletion = true, didErr = false, err; return { s: function s() { it = it.call(o); }, n: function n() { var step = it.next(); normalCompletion = step.done; return step; }, e: function e(_e2) { didErr = true; err = _e2; }, f: function f() { try { if (!normalCompletion && it["return"] != null) it["return"](); } finally { if (didErr) throw err; } } }; }
+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 ownKeys(object, enumerableOnly) { var keys = Object.keys(object); if (Object.getOwnPropertySymbols) { var symbols = Object.getOwnPropertySymbols(object); enumerableOnly && (symbols = symbols.filter(function (sym) { return Object.getOwnPropertyDescriptor(object, sym).enumerable; })), keys.push.apply(keys, symbols); } return keys; }
+function _objectSpread(target) { for (var i = 1; i < arguments.length; i++) { var source = null != arguments[i] ? arguments[i] : {}; i % 2 ? ownKeys(Object(source), !0).forEach(function (key) { _defineProperty(target, key, source[key]); }) : Object.getOwnPropertyDescriptors ? Object.defineProperties(target, Object.getOwnPropertyDescriptors(source)) : ownKeys(Object(source)).forEach(function (key) { Object.defineProperty(target, key, Object.getOwnPropertyDescriptor(source, key)); }); } return target; }
+function _defineProperty(obj, key, value) { key = _toPropertyKey(key); if (key in obj) { Object.defineProperty(obj, key, { value: value, enumerable: true, configurable: true, writable: true }); } else { obj[key] = value; } return obj; }
+function _toPropertyKey(arg) { var key = _toPrimitive(arg, "string"); return _typeof(key) === "symbol" ? key : String(key); }
+function _toPrimitive(input, hint) { if (_typeof(input) !== "object" || input === null) return input; var prim = input[Symbol.toPrimitive]; if (prim !== undefined) { var res = prim.call(input, hint || "default"); if (_typeof(res) !== "object") return res; throw new TypeError("@@toPrimitive must return a primitive value."); } return (hint === "string" ? String : Number)(input); }
+/**
+ * _dataGridShared — Portnet UI v2 (private)
+ */
+
+import * as React from "react";
+import Box from "@mui/material/Box";
+import IconButton from "@mui/material/IconButton";
+import KeyboardArrowLeftIcon from "@mui/icons-material/KeyboardArrowLeft";
+import KeyboardArrowRightIcon from "@mui/icons-material/KeyboardArrowRight";
+import FirstPageIcon from "@mui/icons-material/FirstPage";
+import LastPageIcon from "@mui/icons-material/LastPage";
+import Select from "@mui/material/Select";
+import MenuItem from "@mui/material/MenuItem";
+import { mergeLabels as mergeLabelDict } from "../utils/mergeLabels";
+
+/**
+ * Strips optionality AND an explicitly-declared `| undefined`.
+ *
+ * `Required<T>` is NOT sufficient here, and the difference is invisible until it
+ * bites. `-?` removes `undefined` only when it was IMPLIED by the `?` marker.
+ * Under `exactOptionalPropertyTypes` — mandatory platform-wide — the public label
+ * shapes declare `?: T | undefined` explicitly, so that `undefined` is part of
+ * the declared type and survives `Required<>`. The "fully-resolved" shapes below
+ * silently stopped being resolved, and every renderer that read them without an
+ * optional check became a type error (three of them).
+ *
+ * `Exclude<T[K], undefined>` removes it for real. Behaviour is identical to what
+ * `Required<>` produced BEFORE the optional props were widened — this restores
+ * the original intent rather than changing it.
+ */
+
+/**
+ * Fully-resolved (all-present) label shapes. The public DataGridLabels /
+ * DataGridPaginationLabels (../types/datagrid) are the OVERRIDE shapes (every
+ * field optional). After mergeLabels every field is guaranteed present, so the
+ * renderers (Pagination, DataGrid) read them without optional access.
+ */
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+export var DEFAULT_PAGE_SIZES = [25, 50, 100];
+export var DEFAULT_MAX_BODY_HEIGHT = "70vh";
+export var DEFAULT_LABELS = Object.freeze({
+  tableAria: "Tableau",
+  selectAll: "Tout sélectionner",
+  selectRow: function selectRow(id) {
+    return "S\xE9lectionner la ligne ".concat(id);
+  },
+  actionsHeader: "Actions",
+  pagination: Object.freeze({
+    loading: "Chargement…",
+    rowsPerPage: "Lignes par page",
+    firstPage: "Première page",
+    previousPage: "Page précédente",
+    nextPage: "Page suivante",
+    lastPage: "Dernière page",
+    navLabel: "Pagination",
+    rangeOf: function rangeOf(from, to, total, fmt) {
+      return "".concat(from, "\u2013").concat(to, " sur ").concat(fmt(total));
+    }
+  })
+});
+export function mergeLabels(labels) {
+  if (!labels) return DEFAULT_LABELS;
+  /*
+   * Both levels go through the shared undefined-safe merge. A spread does not skip
+   * explicit `undefined`, so the previous form — a bare object spread of the
+   * overrides over the defaults — let a consumer passing `selectRow: undefined`
+   * DELETE the default and crash the renderer. The old `|| {}` guarded the nested
+   * `pagination` object against being undefined, but not its individual VALUES —
+   * same hazard, one level down.
+   *
+   * The broken form is described rather than quoted, deliberately:
+   * scripts/fix-label-merge.mjs is a text scan, and a verbatim copy here matched it
+   * — so the codemod offered to rewrite this COMMENT. Same lesson KPICard already
+   * records for the banned-patterns guard.
+   *
+   * `pagination` is merged at its OWN level, deliberately, rather than through a
+   * recursive deep merge: two explicit levels can be read, whereas a recursive
+   * helper hides how deep it goes and raises the question of what it does to
+   * arrays. Convention for the whole library: a nested label dictionary is
+   * merged at its own level.
+   */
+  return mergeLabelDict(DEFAULT_LABELS, _objectSpread(_objectSpread({}, labels), {}, {
+    pagination: mergeLabelDict(DEFAULT_LABELS.pagination, labels.pagination)
+  }));
+}
+export function makeNumberFormatter(locale) {
+  try {
+    return new Intl.NumberFormat(locale);
+  } catch (_unused) {
+    return new Intl.NumberFormat("fr-FR");
+  }
+}
+export function applyColumnOrder(columns, columnOrder) {
+  if (!columnOrder || columnOrder.length === 0) return columns;
+  var byKey = new Map(columns.map(function (c) {
+    return [c.key, c];
+  }));
+  var ordered = [];
+  var _iterator = _createForOfIteratorHelper(columnOrder),
+    _step;
+  try {
+    for (_iterator.s(); !(_step = _iterator.n()).done;) {
+      var key = _step.value;
+      var col = byKey.get(key);
+      if (col !== undefined) {
+        ordered.push(col);
+        byKey["delete"](key);
+      }
+    }
+  } catch (err) {
+    _iterator.e(err);
+  } finally {
+    _iterator.f();
+  }
+  var _iterator2 = _createForOfIteratorHelper(byKey.values()),
+    _step2;
+  try {
+    for (_iterator2.s(); !(_step2 = _iterator2.n()).done;) {
+      var _col = _step2.value;
+      ordered.push(_col);
+    }
+  } catch (err) {
+    _iterator2.e(err);
+  } finally {
+    _iterator2.f();
+  }
+  return ordered;
+}
+function columnsSignature(columns) {
+  if (!Array.isArray(columns)) return "";
+  return columns.map(function (c) {
+    return c && _typeof(c) === "object" ? c.key : c;
+  }).join("|");
+}
+export function useColumnsStabilityWarn(columns) {
+  var prevColumnsRef = React.useRef(columns);
+  var warnedRef = React.useRef(false);
+  React.useEffect(function () {
+    if (process.env["NODE_ENV"] === "production") return;
+    if (warnedRef.current) return;
+    if (prevColumnsRef.current === columns) return;
+    var prevSig = columnsSignature(prevColumnsRef.current);
+    var nextSig = columnsSignature(columns);
+    if (prevSig && prevSig === nextSig) {
+      // eslint-disable-next-line no-console
+      console.warn("[@portnet/ui v2] DataGrid received a new `columns` reference with identical column keys. Define columns outside render or wrap in useMemo.");
+      warnedRef.current = true;
+    }
+    prevColumnsRef.current = columns;
+  });
+}
+export var PAGINATION_ICON_SX = Object.freeze({
+  transform: "scaleX(var(--pui-rtl-flip, 1))"
+});
+export var CONTAINER_SX = Object.freeze({
+  background: "transparent",
+  overflow: "hidden"
+});
+
+/*
+ * TABLE_BASE_SX — applied to the MUI <Table> via the sx prop.
+ *
+ * textTransform: "none" is INTENTIONALLY EXPLICIT here.
+ *
+ * Why not rely on the MUI theme (MuiTableCell.head.textTransform: "none")?
+ *
+ * Emotion injects sx-prop rules AFTER theme styleOverrides. Both rules
+ * target <th> with equal specificity (1 class + 1 element). The last
+ * one injected wins. sx wins over theme → the sx value is the truth.
+ *
+ * The old bug: this object had textTransform:"uppercase" which silently
+ * overrode the theme's "none". The fix: keep explicit "none" here so
+ * the correct value wins unconditionally, regardless of injection order.
+ *
+ * letterSpacing is reset to "normal" because all-caps text uses wider
+ * tracking which looks wrong on title-case column headers.
+ */
+var TABLE_BASE_SX = Object.freeze({
+  borderCollapse: "separate",
+  borderSpacing: 0,
+  "& thead th": {
+    backgroundColor: "var(--bg-subtle)",
+    color: "var(--fg-muted)",
+    fontWeight: "var(--fw-semibold)",
+    fontSize: "var(--text-xs)",
+    textTransform: "none",
+    // EXPLICIT — beats emotion injection order
+    letterSpacing: "normal",
+    // reset all-caps tracking
+    borderBottom: "1px solid var(--border)",
+    padding: "var(--s-3) var(--s-4)",
+    whiteSpace: "nowrap"
+  },
+  "& tbody td": {
+    padding: "var(--s-3) var(--s-4)",
+    borderBottom: "1px solid var(--border)"
+  }
+});
+export var TABLE_BY_DENSITY = Object.freeze({
+  comfortable: TABLE_BASE_SX,
+  compact: Object.freeze(_objectSpread(_objectSpread({}, TABLE_BASE_SX), {}, {
+    "& tbody td": _objectSpread(_objectSpread({}, TABLE_BASE_SX["& tbody td"]), {}, {
+      padding: "var(--s-2) var(--s-4)"
+    })
+  }))
+});
+var ROW_HOVER_SELECTED_SX = Object.freeze({
+  "&:nth-of-type(even)": {
+    backgroundColor: "var(--bg-subtle)"
+  },
+  "&:hover": {
+    backgroundColor: "var(--bg-hover)"
+  },
+  "&[data-selected]": {
+    backgroundColor: "var(--accent-soft)"
+  },
+  "&[data-active]": {
+    backgroundColor: "var(--accent-soft)",
+    "& > td:first-of-type": {
+      boxShadow: "inset calc(3px * var(--pui-rtl-flip, 1)) 0 0 var(--accent)"
+    }
+  }
+});
+export var ROW_CLICKABLE_SX = Object.freeze(_objectSpread(_objectSpread({}, ROW_HOVER_SELECTED_SX), {}, {
+  cursor: "pointer",
+  "&:focus-visible": {
+    outline: "2px solid var(--accent)",
+    outlineOffset: "var(--pui-outline-offset-inset)"
+  }
+}));
+export var ROW_STATIC_SX = Object.freeze(_objectSpread(_objectSpread({}, ROW_HOVER_SELECTED_SX), {}, {
+  cursor: "default"
+}));
+export var HEADER_CHECKBOX_CELL_SX = Object.freeze({
+  width: "var(--tactile-min)",
+  position: "sticky",
+  top: 0,
+  zIndex: 2
+});
+export var BODY_CHECKBOX_CELL_SX = Object.freeze({
+  width: "var(--tactile-min)"
+});
+export var HOVER_ONLY_CELL_SX = Object.freeze({
+  opacity: 0,
+  transition: "opacity var(--duration-fast, 120ms) ease",
+  "tr:hover &, tr:focus-within &": {
+    opacity: 1
+  },
+  "@media (pointer: coarse)": {
+    opacity: 1
+  }
+});
+export var ERROR_CELL_SX = Object.freeze({
+  padding: 0,
+  borderBottom: "none"
+});
+export var ERROR_INNER_SX = Object.freeze({
+  padding: "var(--s-4)"
+});
+export var FILLER_CELL_SX = Object.freeze({
+  padding: 0,
+  borderBottom: "1px solid var(--border)"
+});
+export var FILLER_HEAD_CELL_SX = Object.freeze({
+  padding: 0,
+  position: "sticky",
+  top: 0,
+  zIndex: 1,
+  background: "var(--bg-subtle)",
+  borderBottom: "1px solid var(--border)"
+});
+
+/* ── Pagination ─────────────────────────────────────────────────── */
+
+var PAGINATION_CONTAINER_SX = Object.freeze({
+  display: "flex",
+  alignItems: "center",
+  // R-RS / WCAG 1.4.10 — the control groups (range / page-size / nav)
+  // must wrap onto extra lines on narrow viewports. Their combined fixed
+  // width (~400px+) exceeds a 320–375px phone, so without flexWrap the
+  // bar overflowed its container and pushed the nav buttons off-screen.
+  // rowGap (s2) keeps wrapped rows tight; columnGap (s4) is the original
+  // inter-group spacing on a single row.
+  flexWrap: "wrap",
+  gap: "var(--s-2) var(--s-4)",
+  padding: "var(--s-2) var(--s-4)",
+  borderTop: "1px solid var(--border)",
+  background: "var(--surface)",
+  fontSize: "var(--text-xs)",
+  color: "var(--fg-muted)"
+});
+var PAGINATION_RANGE_SX = Object.freeze({
+  flex: 1,
+  fontVariantNumeric: "tabular-nums"
+});
+var PAGINATION_PAGESIZE_GROUP_SX = Object.freeze({
+  display: "flex",
+  alignItems: "center",
+  gap: "var(--s-2)"
+});
+var PAGINATION_NAV_GROUP_SX = Object.freeze({
+  display: "flex",
+  alignItems: "center",
+  gap: "var(--s-1)"
+});
+var PAGINATION_PAGE_OF_SX = Object.freeze({
+  minWidth: 56,
+  textAlign: "center",
+  fontVariantNumeric: "tabular-nums"
+});
+var PAGINATION_SELECT_SX = Object.freeze({
+  fontSize: "var(--text-xs)",
+  height: 28
+});
+export function Pagination(_ref) {
+  var page = _ref.page,
+    pageSize = _ref.pageSize,
+    total = _ref.total,
+    onPageChange = _ref.onPageChange,
+    onPageSizeChange = _ref.onPageSizeChange,
+    _ref$pageSizes = _ref.pageSizes,
+    pageSizes = _ref$pageSizes === void 0 ? DEFAULT_PAGE_SIZES : _ref$pageSizes,
+    loading = _ref.loading,
+    locale = _ref.locale,
+    labels = _ref.labels;
+  var pages = Math.max(1, Math.ceil(total / pageSize));
+  var from = total === 0 ? 0 : (page - 1) * pageSize + 1;
+  var to = Math.min(total, page * pageSize);
+  var go = function go(p) {
+    return onPageChange(Math.min(pages, Math.max(1, p)));
+  };
+  var fmt = React.useMemo(function () {
+    var nf = makeNumberFormatter(locale);
+    return function (n) {
+      return nf.format(n);
+    };
+  }, [locale]);
+  return /*#__PURE__*/_jsxs(Box, {
+    component: "nav",
+    "aria-label": labels.navLabel,
+    sx: PAGINATION_CONTAINER_SX,
+    children: [/*#__PURE__*/_jsx(Box, {
+      role: "status",
+      "aria-live": "polite",
+      "aria-atomic": "true",
+      sx: PAGINATION_RANGE_SX,
+      children: loading ? labels.loading : labels.rangeOf(from, to, total, fmt)
+    }), onPageSizeChange && /*#__PURE__*/_jsxs(Box, {
+      sx: PAGINATION_PAGESIZE_GROUP_SX,
+      children: [/*#__PURE__*/_jsx("span", {
+        children: labels.rowsPerPage
+      }), /*#__PURE__*/_jsx(Select, {
+        size: "small",
+        value: pageSize,
+        onChange: function onChange(e) {
+          return onPageSizeChange(Number(e.target.value));
+        },
+        inputProps: {
+          "aria-label": String(labels.rowsPerPage)
+        },
+        sx: PAGINATION_SELECT_SX,
+        children: pageSizes.map(function (s) {
+          return /*#__PURE__*/_jsx(MenuItem, {
+            value: s,
+            children: s
+          }, s);
+        })
+      })]
+    }), /*#__PURE__*/_jsxs(Box, {
+      sx: PAGINATION_NAV_GROUP_SX,
+      children: [/*#__PURE__*/_jsx(IconButton, {
+        size: "small",
+        onClick: function onClick() {
+          return go(1);
+        },
+        disabled: page <= 1,
+        "aria-label": labels.firstPage,
+        children: /*#__PURE__*/_jsx(FirstPageIcon, {
+          fontSize: "small",
+          sx: PAGINATION_ICON_SX
+        })
+      }), /*#__PURE__*/_jsx(IconButton, {
+        size: "small",
+        onClick: function onClick() {
+          return go(page - 1);
+        },
+        disabled: page <= 1,
+        "aria-label": labels.previousPage,
+        children: /*#__PURE__*/_jsx(KeyboardArrowLeftIcon, {
+          fontSize: "small",
+          sx: PAGINATION_ICON_SX
+        })
+      }), /*#__PURE__*/_jsxs(Box, {
+        sx: PAGINATION_PAGE_OF_SX,
+        children: [page, " / ", pages]
+      }), /*#__PURE__*/_jsx(IconButton, {
+        size: "small",
+        onClick: function onClick() {
+          return go(page + 1);
+        },
+        disabled: page >= pages,
+        "aria-label": labels.nextPage,
+        children: /*#__PURE__*/_jsx(KeyboardArrowRightIcon, {
+          fontSize: "small",
+          sx: PAGINATION_ICON_SX
+        })
+      }), /*#__PURE__*/_jsx(IconButton, {
+        size: "small",
+        onClick: function onClick() {
+          return go(pages);
+        },
+        disabled: page >= pages,
+        "aria-label": labels.lastPage,
+        children: /*#__PURE__*/_jsx(LastPageIcon, {
+          fontSize: "small",
+          sx: PAGINATION_ICON_SX
+        })
+      })]
+    })]
+  });
+}
+//# sourceMappingURL=_dataGridShared.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"_dataGridShared.js","names":["React","Box","IconButton","KeyboardArrowLeftIcon","KeyboardArrowRightIcon","FirstPageIcon","LastPageIcon","Select","MenuItem","mergeLabels","mergeLabelDict","jsx","_jsx","jsxs","_jsxs","DEFAULT_PAGE_SIZES","DEFAULT_MAX_BODY_HEIGHT","DEFAULT_LABELS","Object","freeze","tableAria","selectAll","selectRow","id","concat","actionsHeader","pagination","loading","rowsPerPage","firstPage","previousPage","nextPage","lastPage","navLabel","rangeOf","from","to","total","fmt","labels","_objectSpread","makeNumberFormatter","locale","Intl","NumberFormat","_unused","applyColumnOrder","columns","columnOrder","length","byKey","Map","map","c","key","ordered","_iterator","_createForOfIteratorHelper","_step","s","n","done","value","col","get","undefined","push","err","e","f","_iterator2","values","_step2","columnsSignature","Array","isArray","_typeof","join","useColumnsStabilityWarn","prevColumnsRef","useRef","warnedRef","useEffect","process","env","current","prevSig","nextSig","console","warn","PAGINATION_ICON_SX","transform","CONTAINER_SX","background","overflow","TABLE_BASE_SX","borderCollapse","borderSpacing","backgroundColor","color","fontWeight","fontSize","textTransform","letterSpacing","borderBottom","padding","whiteSpace","TABLE_BY_DENSITY","comfortable","compact","ROW_HOVER_SELECTED_SX","boxShadow","ROW_CLICKABLE_SX","cursor","outline","outlineOffset","ROW_STATIC_SX","HEADER_CHECKBOX_CELL_SX","width","position","top","zIndex","BODY_CHECKBOX_CELL_SX","HOVER_ONLY_CELL_SX","opacity","transition","ERROR_CELL_SX","ERROR_INNER_SX","FILLER_CELL_SX","FILLER_HEAD_CELL_SX","PAGINATION_CONTAINER_SX","display","alignItems","flexWrap","gap","borderTop","PAGINATION_RANGE_SX","flex","fontVariantNumeric","PAGINATION_PAGESIZE_GROUP_SX","PAGINATION_NAV_GROUP_SX","PAGINATION_PAGE_OF_SX","minWidth","textAlign","PAGINATION_SELECT_SX","height","Pagination","_ref","page","pageSize","onPageChange","onPageSizeChange","_ref$pageSizes","pageSizes","pages","Math","max","ceil","min","go","p","useMemo","nf","format","component","sx","children","role","size","onChange","Number","target","inputProps","String","onClick","disabled"],"sources":["../../../../src/lib/v2/patterns/_dataGridShared.tsx"],"sourcesContent":["/**\r\n * _dataGridShared — Portnet UI v2 (private)\r\n */\r\n\r\nimport * as React from \"react\";\r\nimport Box from \"@mui/material/Box\";\r\nimport IconButton from \"@mui/material/IconButton\";\r\nimport KeyboardArrowLeftIcon from \"@mui/icons-material/KeyboardArrowLeft\";\r\nimport KeyboardArrowRightIcon from \"@mui/icons-material/KeyboardArrowRight\";\r\nimport FirstPageIcon from \"@mui/icons-material/FirstPage\";\r\nimport LastPageIcon from \"@mui/icons-material/LastPage\";\r\nimport Select from \"@mui/material/Select\";\r\nimport MenuItem from \"@mui/material/MenuItem\";\r\nimport type { SxProps, Theme } from \"@mui/material/styles\";\r\nimport type { Density, RowId } from \"../types/common\";\r\nimport type { DataGridLabels, DataGridPaginationLabels } from \"../types/datagrid\";\r\nimport { mergeLabels as mergeLabelDict } from \"../utils/mergeLabels\";\r\n\r\n/**\r\n * Strips optionality AND an explicitly-declared `| undefined`.\r\n *\r\n * `Required<T>` is NOT sufficient here, and the difference is invisible until it\r\n * bites. `-?` removes `undefined` only when it was IMPLIED by the `?` marker.\r\n * Under `exactOptionalPropertyTypes` — mandatory platform-wide — the public label\r\n * shapes declare `?: T | undefined` explicitly, so that `undefined` is part of\r\n * the declared type and survives `Required<>`. The \"fully-resolved\" shapes below\r\n * silently stopped being resolved, and every renderer that read them without an\r\n * optional check became a type error (three of them).\r\n *\r\n * `Exclude<T[K], undefined>` removes it for real. Behaviour is identical to what\r\n * `Required<>` produced BEFORE the optional props were widened — this restores\r\n * the original intent rather than changing it.\r\n */\r\ntype Concrete<T> = { [K in keyof T]-?: Exclude<T[K], undefined> };\r\n\r\n/**\r\n * Fully-resolved (all-present) label shapes. The public DataGridLabels /\r\n * DataGridPaginationLabels (../types/datagrid) are the OVERRIDE shapes (every\r\n * field optional). After mergeLabels every field is guaranteed present, so the\r\n * renderers (Pagination, DataGrid) read them without optional access.\r\n */\r\nexport type ResolvedDataGridPaginationLabels = Concrete<DataGridPaginationLabels>;\r\nexport type ResolvedDataGridLabels = Concrete<Omit<DataGridLabels, \"pagination\">> & {\r\n  pagination: ResolvedDataGridPaginationLabels;\r\n};\r\n\r\nexport const DEFAULT_PAGE_SIZES = [25, 50, 100];\r\nexport const DEFAULT_MAX_BODY_HEIGHT = \"70vh\";\r\n\r\nexport const DEFAULT_LABELS: ResolvedDataGridLabels = Object.freeze({\r\n  tableAria: \"Tableau\",\r\n  selectAll: \"Tout sélectionner\",\r\n  selectRow: (id: RowId) => `Sélectionner la ligne ${id}`,\r\n  actionsHeader: \"Actions\",\r\n  pagination: Object.freeze({\r\n    loading:      \"Chargement…\",\r\n    rowsPerPage:  \"Lignes par page\",\r\n    firstPage:    \"Première page\",\r\n    previousPage: \"Page précédente\",\r\n    nextPage:     \"Page suivante\",\r\n    lastPage:     \"Dernière page\",\r\n    navLabel:     \"Pagination\",\r\n    rangeOf:      (from: number, to: number, total: number, fmt: (n: number) => string) => `${from}–${to} sur ${fmt(total)}`,\r\n  }),\r\n});\r\n\r\nexport function mergeLabels(labels?: DataGridLabels): ResolvedDataGridLabels {\r\n  if (!labels) return DEFAULT_LABELS;\r\n  /*\r\n   * Both levels go through the shared undefined-safe merge. A spread does not skip\r\n   * explicit `undefined`, so the previous form — a bare object spread of the\r\n   * overrides over the defaults — let a consumer passing `selectRow: undefined`\r\n   * DELETE the default and crash the renderer. The old `|| {}` guarded the nested\r\n   * `pagination` object against being undefined, but not its individual VALUES —\r\n   * same hazard, one level down.\r\n   *\r\n   * The broken form is described rather than quoted, deliberately:\r\n   * scripts/fix-label-merge.mjs is a text scan, and a verbatim copy here matched it\r\n   * — so the codemod offered to rewrite this COMMENT. Same lesson KPICard already\r\n   * records for the banned-patterns guard.\r\n   *\r\n   * `pagination` is merged at its OWN level, deliberately, rather than through a\r\n   * recursive deep merge: two explicit levels can be read, whereas a recursive\r\n   * helper hides how deep it goes and raises the question of what it does to\r\n   * arrays. Convention for the whole library: a nested label dictionary is\r\n   * merged at its own level.\r\n   */\r\n  return mergeLabelDict(DEFAULT_LABELS, {\r\n    ...labels,\r\n    pagination: mergeLabelDict(DEFAULT_LABELS.pagination, labels.pagination),\r\n  });\r\n}\r\n\r\nexport function makeNumberFormatter(locale?: string): Intl.NumberFormat {\r\n  try { return new Intl.NumberFormat(locale); }\r\n  catch { return new Intl.NumberFormat(\"fr-FR\"); }\r\n}\r\n\r\nexport function applyColumnOrder<C extends { key: string }>(\r\n  columns: C[],\r\n  columnOrder: string[] | null | undefined\r\n): C[] {\r\n  if (!columnOrder || columnOrder.length === 0) return columns;\r\n  const byKey = new Map<string, C>(columns.map((c): [string, C] => [c.key, c]));\r\n  const ordered: C[] = [];\r\n  for (const key of columnOrder) {\r\n    const col = byKey.get(key);\r\n    if (col !== undefined) { ordered.push(col); byKey.delete(key); }\r\n  }\r\n  for (const col of byKey.values()) ordered.push(col);\r\n  return ordered;\r\n}\r\n\r\nfunction columnsSignature(columns: unknown): string {\r\n  if (!Array.isArray(columns)) return \"\";\r\n  return (columns as unknown[])\r\n    .map((c) => (c && typeof c === \"object\" ? (c as { key?: unknown }).key : c))\r\n    .join(\"|\");\r\n}\r\n\r\nexport function useColumnsStabilityWarn(columns: unknown): void {\r\n  const prevColumnsRef = React.useRef(columns);\r\n  const warnedRef = React.useRef(false);\r\n  React.useEffect(() => {\r\n    if (process.env[\"NODE_ENV\"] === \"production\") return;\r\n    if (warnedRef.current) return;\r\n    if (prevColumnsRef.current === columns) return;\r\n    const prevSig = columnsSignature(prevColumnsRef.current);\r\n    const nextSig = columnsSignature(columns);\r\n    if (prevSig && prevSig === nextSig) {\r\n      // eslint-disable-next-line no-console\r\n      console.warn(\"[@portnet/ui v2] DataGrid received a new `columns` reference with identical column keys. Define columns outside render or wrap in useMemo.\");\r\n      warnedRef.current = true;\r\n    }\r\n    prevColumnsRef.current = columns;\r\n  });\r\n}\r\n\r\nexport const PAGINATION_ICON_SX = Object.freeze({ transform: \"scaleX(var(--pui-rtl-flip, 1))\" });\r\nexport const CONTAINER_SX = Object.freeze({ background: \"transparent\", overflow: \"hidden\" } satisfies SxProps<Theme>);\r\n\r\n/*\r\n * TABLE_BASE_SX — applied to the MUI <Table> via the sx prop.\r\n *\r\n * textTransform: \"none\" is INTENTIONALLY EXPLICIT here.\r\n *\r\n * Why not rely on the MUI theme (MuiTableCell.head.textTransform: \"none\")?\r\n *\r\n * Emotion injects sx-prop rules AFTER theme styleOverrides. Both rules\r\n * target <th> with equal specificity (1 class + 1 element). The last\r\n * one injected wins. sx wins over theme → the sx value is the truth.\r\n *\r\n * The old bug: this object had textTransform:\"uppercase\" which silently\r\n * overrode the theme's \"none\". The fix: keep explicit \"none\" here so\r\n * the correct value wins unconditionally, regardless of injection order.\r\n *\r\n * letterSpacing is reset to \"normal\" because all-caps text uses wider\r\n * tracking which looks wrong on title-case column headers.\r\n */\r\nconst TABLE_BASE_SX = Object.freeze({\r\n  borderCollapse: \"separate\",\r\n  borderSpacing: 0,\r\n  \"& thead th\": {\r\n    backgroundColor: \"var(--bg-subtle)\",\r\n    color: \"var(--fg-muted)\",\r\n    fontWeight: \"var(--fw-semibold)\",\r\n    fontSize: \"var(--text-xs)\",\r\n    textTransform: \"none\",      // EXPLICIT — beats emotion injection order\r\n    letterSpacing: \"normal\",    // reset all-caps tracking\r\n    borderBottom: \"1px solid var(--border)\",\r\n    padding: \"var(--s-3) var(--s-4)\",\r\n    whiteSpace: \"nowrap\",\r\n  },\r\n  \"& tbody td\": {\r\n    padding: \"var(--s-3) var(--s-4)\",\r\n    borderBottom: \"1px solid var(--border)\",\r\n  },\r\n} satisfies SxProps<Theme>);\r\n\r\nexport const TABLE_BY_DENSITY: Record<Density, SxProps<Theme>> = Object.freeze({\r\n  comfortable: TABLE_BASE_SX,\r\n  compact: Object.freeze({\r\n    ...TABLE_BASE_SX,\r\n    \"& tbody td\": { ...TABLE_BASE_SX[\"& tbody td\"], padding: \"var(--s-2) var(--s-4)\" },\r\n  } satisfies SxProps<Theme>),\r\n});\r\n\r\nconst ROW_HOVER_SELECTED_SX = Object.freeze({\r\n  \"&:nth-of-type(even)\": { backgroundColor: \"var(--bg-subtle)\" },\r\n  \"&:hover\":             { backgroundColor: \"var(--bg-hover)\" },\r\n  \"&[data-selected]\":    { backgroundColor: \"var(--accent-soft)\" },\r\n  \"&[data-active]\": {\r\n    backgroundColor: \"var(--accent-soft)\",\r\n    \"& > td:first-of-type\": { boxShadow: \"inset calc(3px * var(--pui-rtl-flip, 1)) 0 0 var(--accent)\" },\r\n  },\r\n});\r\n\r\nexport const ROW_CLICKABLE_SX = Object.freeze({\r\n  ...ROW_HOVER_SELECTED_SX,\r\n  cursor: \"pointer\",\r\n  \"&:focus-visible\": { outline: \"2px solid var(--accent)\", outlineOffset: \"var(--pui-outline-offset-inset)\" },\r\n} satisfies SxProps<Theme>);\r\n\r\nexport const ROW_STATIC_SX = Object.freeze({ ...ROW_HOVER_SELECTED_SX, cursor: \"default\" } satisfies SxProps<Theme>);\r\n\r\nexport const HEADER_CHECKBOX_CELL_SX = Object.freeze({ width: \"var(--tactile-min)\", position: \"sticky\", top: 0, zIndex: 2 } satisfies SxProps<Theme>);\r\nexport const BODY_CHECKBOX_CELL_SX   = Object.freeze({ width: \"var(--tactile-min)\" });\r\n\r\nexport const HOVER_ONLY_CELL_SX = Object.freeze({\r\n  opacity: 0,\r\n  transition: \"opacity var(--duration-fast, 120ms) ease\",\r\n  \"tr:hover &, tr:focus-within &\": { opacity: 1 },\r\n  \"@media (pointer: coarse)\": { opacity: 1 },\r\n});\r\n\r\nexport const ERROR_CELL_SX  = Object.freeze({ padding: 0, borderBottom: \"none\" });\r\nexport const ERROR_INNER_SX = Object.freeze({ padding: \"var(--s-4)\" });\r\n\r\nexport const FILLER_CELL_SX = Object.freeze({ padding: 0, borderBottom: \"1px solid var(--border)\" });\r\nexport const FILLER_HEAD_CELL_SX = Object.freeze({\r\n  padding: 0, position: \"sticky\", top: 0, zIndex: 1,\r\n  background: \"var(--bg-subtle)\", borderBottom: \"1px solid var(--border)\",\r\n} satisfies SxProps<Theme>);\r\n\r\n/* ── Pagination ─────────────────────────────────────────────────── */\r\n\r\nconst PAGINATION_CONTAINER_SX = Object.freeze({\r\n  display: \"flex\", alignItems: \"center\",\r\n  // R-RS / WCAG 1.4.10 — the control groups (range / page-size / nav)\r\n  // must wrap onto extra lines on narrow viewports. Their combined fixed\r\n  // width (~400px+) exceeds a 320–375px phone, so without flexWrap the\r\n  // bar overflowed its container and pushed the nav buttons off-screen.\r\n  // rowGap (s2) keeps wrapped rows tight; columnGap (s4) is the original\r\n  // inter-group spacing on a single row.\r\n  flexWrap: \"wrap\", gap: \"var(--s-2) var(--s-4)\",\r\n  padding: \"var(--s-2) var(--s-4)\", borderTop: \"1px solid var(--border)\",\r\n  background: \"var(--surface)\", fontSize: \"var(--text-xs)\", color: \"var(--fg-muted)\",\r\n} satisfies SxProps<Theme>);\r\n\r\nconst PAGINATION_RANGE_SX          = Object.freeze({ flex: 1, fontVariantNumeric: \"tabular-nums\" });\r\nconst PAGINATION_PAGESIZE_GROUP_SX = Object.freeze({ display: \"flex\", alignItems: \"center\", gap: \"var(--s-2)\" } satisfies SxProps<Theme>);\r\nconst PAGINATION_NAV_GROUP_SX      = Object.freeze({ display: \"flex\", alignItems: \"center\", gap: \"var(--s-1)\" } satisfies SxProps<Theme>);\r\nconst PAGINATION_PAGE_OF_SX        = Object.freeze({ minWidth: 56, textAlign: \"center\", fontVariantNumeric: \"tabular-nums\" } satisfies SxProps<Theme>);\r\nconst PAGINATION_SELECT_SX         = Object.freeze({ fontSize: \"var(--text-xs)\", height: 28 });\r\n\r\nexport interface PaginationProps {\r\n  page: number;\r\n  pageSize: number;\r\n  total: number;\r\n  onPageChange: (page: number) => void;\r\n  onPageSizeChange?: ((pageSize: number) => void) | undefined;\r\n  pageSizes?: number[] | undefined;\r\n  loading?: boolean | undefined;\r\n  locale?: string | undefined;\r\n  labels: ResolvedDataGridPaginationLabels;\r\n}\r\n\r\nexport function Pagination({ page, pageSize, total, onPageChange, onPageSizeChange, pageSizes = DEFAULT_PAGE_SIZES, loading, locale, labels }: PaginationProps) {\r\n  const pages = Math.max(1, Math.ceil(total / pageSize));\r\n  const from  = total === 0 ? 0 : (page - 1) * pageSize + 1;\r\n  const to    = Math.min(total, page * pageSize);\r\n  const go    = (p: number) => onPageChange(Math.min(pages, Math.max(1, p)));\r\n\r\n  const fmt = React.useMemo(() => {\r\n    const nf = makeNumberFormatter(locale);\r\n    return (n: number) => nf.format(n);\r\n  }, [locale]);\r\n\r\n  return (\r\n    <Box component=\"nav\" aria-label={labels.navLabel} sx={PAGINATION_CONTAINER_SX}>\r\n      {/* PAGE-2 — polite, atomic live region so SR users hear the position\r\n          change (\"1–25 sur 100\" → \"26–50 sur 100\") as they page. */}\r\n      <Box role=\"status\" aria-live=\"polite\" aria-atomic=\"true\" sx={PAGINATION_RANGE_SX}>{loading ? labels.loading : labels.rangeOf(from, to, total, fmt)}</Box>\r\n      {onPageSizeChange && (\r\n        <Box sx={PAGINATION_PAGESIZE_GROUP_SX}>\r\n          <span>{labels.rowsPerPage}</span>\r\n          <Select size=\"small\" value={pageSize} onChange={(e) => onPageSizeChange(Number(e.target.value))} inputProps={{ \"aria-label\": String(labels.rowsPerPage) }} sx={PAGINATION_SELECT_SX}>\r\n            {pageSizes.map((s) => <MenuItem key={s} value={s}>{s}</MenuItem>)}\r\n          </Select>\r\n        </Box>\r\n      )}\r\n      <Box sx={PAGINATION_NAV_GROUP_SX}>\r\n        <IconButton size=\"small\" onClick={() => go(1)}        disabled={page <= 1}     aria-label={labels.firstPage}><FirstPageIcon         fontSize=\"small\" sx={PAGINATION_ICON_SX} /></IconButton>\r\n        <IconButton size=\"small\" onClick={() => go(page - 1)} disabled={page <= 1}     aria-label={labels.previousPage}><KeyboardArrowLeftIcon  fontSize=\"small\" sx={PAGINATION_ICON_SX} /></IconButton>\r\n        <Box sx={PAGINATION_PAGE_OF_SX}>{page} / {pages}</Box>\r\n        <IconButton size=\"small\" onClick={() => go(page + 1)} disabled={page >= pages} aria-label={labels.nextPage}><KeyboardArrowRightIcon fontSize=\"small\" sx={PAGINATION_ICON_SX} /></IconButton>\r\n        <IconButton size=\"small\" onClick={() => go(pages)}    disabled={page >= pages} aria-label={labels.lastPage}><LastPageIcon          fontSize=\"small\" sx={PAGINATION_ICON_SX} /></IconButton>\r\n      </Box>\r\n    </Box>\r\n  );\r\n}\r\n"],"mappings":"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","ignoreList":[]}

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

@@ -0,0 +1,112 @@
+function _createForOfIteratorHelper(o, allowArrayLike) { var it = typeof Symbol !== "undefined" && o[Symbol.iterator] || o["@@iterator"]; if (!it) { if (Array.isArray(o) || (it = _unsupportedIterableToArray(o)) || allowArrayLike && o && typeof o.length === "number") { if (it) o = it; var i = 0; var F = function F() {}; return { s: F, n: function n() { if (i >= o.length) return { done: true }; return { done: false, value: o[i++] }; }, e: function e(_e) { throw _e; }, f: F }; } throw new TypeError("Invalid attempt to iterate non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method."); } var normalCompletion = true, didErr = false, err; return { s: function s() { it = it.call(o); }, n: function n() { var step = it.next(); normalCompletion = step.done; return step; }, e: function e(_e2) { didErr = true; err = _e2; }, f: function f() { try { if (!normalCompletion && it["return"] != null) it["return"](); } finally { if (didErr) throw err; } } }; }
+function _toConsumableArray(arr) { return _arrayWithoutHoles(arr) || _iterableToArray(arr) || _unsupportedIterableToArray(arr) || _nonIterableSpread(); }
+function _nonIterableSpread() { throw new TypeError("Invalid attempt to spread non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method."); }
+function _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 _iterableToArray(iter) { if (typeof Symbol !== "undefined" && iter[Symbol.iterator] != null || iter["@@iterator"] != null) return Array.from(iter); }
+function _arrayWithoutHoles(arr) { if (Array.isArray(arr)) return _arrayLikeToArray(arr); }
+function _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; }
+/**
+ * Internal: locale-correct multi-sort for DataGrid / useSortedRows.
+ *
+ * Extracted verbatim from SortableHeader (Batch 12 / C1) so the sort logic can
+ * be shared by the SortableHeader pattern (which re-exports `applySort`) and the
+ * useSortedRows hook — without a hook → component import (a .ts hook importing a
+ * still-.js component fails build:types under allowJs:false) and without
+ * duplicating the collation logic. Behaviour is unchanged.
+ *
+ * NOT part of the public surface: `applySort` is re-exported from SortableHeader
+ * (the public name / call site); getCollator + compareValues + the cache are
+ * internal implementation details that were never exported.
+ */
+
+/**
+ * Module-level cache of Intl.Collator instances keyed by locale tag.
+ * Collator construction allocates internal locale data (≈100 µs cold)
+ * — caching matters for hosts that re-sort on every render.
+ *
+ * Using "accent" sensitivity preserves the prior toLowerCase-based
+ * behaviour (case-insensitive) while honouring proper locale collation:
+ *   - FR: É sorts as if E (between Élise and Étienne, not after Z).
+ *   - AR: combining marks fold correctly.
+ *   - DE: Umlauts (ä) sort with their base letter.
+ * "numeric: true" makes "Item 10" sort AFTER "Item 2" (natural order),
+ * which the prior char-code comparison got backwards.
+ */
+var COLLATOR_CACHE = new Map();
+function getCollator(locale) {
+  var key = locale || "fr-FR";
+  var cached = COLLATOR_CACHE.get(key);
+  if (cached) return cached;
+  var collator;
+  try {
+    collator = new Intl.Collator(key, {
+      sensitivity: "accent",
+      numeric: true
+    });
+  } catch (_unused) {
+    // Invalid BCP-47 tag — fall back to fr-FR (matches the rest of v2's
+    // graceful-locale-fallback contract from Batch 2).
+    collator = new Intl.Collator("fr-FR", {
+      sensitivity: "accent",
+      numeric: true
+    });
+  }
+  COLLATOR_CACHE.set(key, collator);
+  return collator;
+}
+
+/**
+ * Compare two cell values with locale-aware semantics. Routes through
+ * the Collator only for strings or mixed types; numeric / Date pairs
+ * use native operators (faster + exact).
+ *
+ * Null / undefined / empty-string sort FIRST (preserves the prior
+ * applySort empty-string behaviour: "" < any non-empty string).
+ */
+function compareValues(av, bv, collator) {
+  var aN = av == null || av === "";
+  var bN = bv == null || bv === "";
+  if (aN && bN) return 0;
+  if (aN) return -1;
+  if (bN) return 1;
+  if (typeof av === "number" && typeof bv === "number") {
+    return av - bv;
+  }
+  if (av instanceof Date && bv instanceof Date) {
+    return av.getTime() - bv.getTime();
+  }
+  // String pair — or mixed types coerced to strings. The Collator handles
+  // both cases identically and respects `numeric: true` so digit runs
+  // inside a label compare numerically.
+  return collator.compare(String(av), String(bv));
+}
+
+/**
+ * Pure helper — applies a multi-sort state to an array of rows.
+ * Returns a NEW sorted array (input is not mutated); the original array
+ * reference is returned untouched when there is nothing to sort.
+ */
+export function applySort(rows, sort) {
+  var options = arguments.length > 2 && arguments[2] !== undefined ? arguments[2] : {};
+  if (!(sort !== null && sort !== void 0 && sort.length)) return rows;
+  var collator = getCollator(options.locale);
+  return _toConsumableArray(rows).sort(function (a, b) {
+    var _iterator = _createForOfIteratorHelper(sort),
+      _step;
+    try {
+      for (_iterator.s(); !(_step = _iterator.n()).done;) {
+        var _step$value = _step.value,
+          key = _step$value.key,
+          dir = _step$value.dir;
+        var cmp = compareValues(a[key], b[key], collator);
+        if (cmp !== 0) return dir === "asc" ? cmp : -cmp;
+      }
+    } catch (err) {
+      _iterator.e(err);
+    } finally {
+      _iterator.f();
+    }
+    return 0;
+  });
+}
+//# sourceMappingURL=_sort.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"_sort.js","names":["COLLATOR_CACHE","Map","getCollator","locale","key","cached","get","collator","Intl","Collator","sensitivity","numeric","_unused","set","compareValues","av","bv","aN","bN","Date","getTime","compare","String","applySort","rows","sort","options","arguments","length","undefined","_toConsumableArray","a","b","_iterator","_createForOfIteratorHelper","_step","s","n","done","_step$value","value","dir","cmp","err","e","f"],"sources":["../../../../src/lib/v2/patterns/_sort.ts"],"sourcesContent":["/**\r\n * Internal: locale-correct multi-sort for DataGrid / useSortedRows.\r\n *\r\n * Extracted verbatim from SortableHeader (Batch 12 / C1) so the sort logic can\r\n * be shared by the SortableHeader pattern (which re-exports `applySort`) and the\r\n * useSortedRows hook — without a hook → component import (a .ts hook importing a\r\n * still-.js component fails build:types under allowJs:false) and without\r\n * duplicating the collation logic. Behaviour is unchanged.\r\n *\r\n * NOT part of the public surface: `applySort` is re-exported from SortableHeader\r\n * (the public name / call site); getCollator + compareValues + the cache are\r\n * internal implementation details that were never exported.\r\n */\r\nimport type { SortDescriptor } from \"../types/common\";\r\nimport type { ApplySortOptions } from \"../types/datagrid\";\r\n\r\n/**\r\n * Module-level cache of Intl.Collator instances keyed by locale tag.\r\n * Collator construction allocates internal locale data (≈100 µs cold)\r\n * — caching matters for hosts that re-sort on every render.\r\n *\r\n * Using \"accent\" sensitivity preserves the prior toLowerCase-based\r\n * behaviour (case-insensitive) while honouring proper locale collation:\r\n *   - FR: É sorts as if E (between Élise and Étienne, not after Z).\r\n *   - AR: combining marks fold correctly.\r\n *   - DE: Umlauts (ä) sort with their base letter.\r\n * \"numeric: true\" makes \"Item 10\" sort AFTER \"Item 2\" (natural order),\r\n * which the prior char-code comparison got backwards.\r\n */\r\nconst COLLATOR_CACHE = new Map<string, Intl.Collator>();\r\n\r\nfunction getCollator(locale?: string): Intl.Collator {\r\n  const key = locale || \"fr-FR\";\r\n  const cached = COLLATOR_CACHE.get(key);\r\n  if (cached) return cached;\r\n  let collator: Intl.Collator;\r\n  try {\r\n    collator = new Intl.Collator(key, { sensitivity: \"accent\", numeric: true });\r\n  } catch {\r\n    // Invalid BCP-47 tag — fall back to fr-FR (matches the rest of v2's\r\n    // graceful-locale-fallback contract from Batch 2).\r\n    collator = new Intl.Collator(\"fr-FR\", { sensitivity: \"accent\", numeric: true });\r\n  }\r\n  COLLATOR_CACHE.set(key, collator);\r\n  return collator;\r\n}\r\n\r\n/**\r\n * Compare two cell values with locale-aware semantics. Routes through\r\n * the Collator only for strings or mixed types; numeric / Date pairs\r\n * use native operators (faster + exact).\r\n *\r\n * Null / undefined / empty-string sort FIRST (preserves the prior\r\n * applySort empty-string behaviour: \"\" < any non-empty string).\r\n */\r\nfunction compareValues(av: unknown, bv: unknown, collator: Intl.Collator): number {\r\n  const aN = av == null || av === \"\";\r\n  const bN = bv == null || bv === \"\";\r\n  if (aN && bN) return 0;\r\n  if (aN) return -1;\r\n  if (bN) return 1;\r\n\r\n  if (typeof av === \"number\" && typeof bv === \"number\") {\r\n    return av - bv;\r\n  }\r\n  if (av instanceof Date && bv instanceof Date) {\r\n    return av.getTime() - bv.getTime();\r\n  }\r\n  // String pair — or mixed types coerced to strings. The Collator handles\r\n  // both cases identically and respects `numeric: true` so digit runs\r\n  // inside a label compare numerically.\r\n  return collator.compare(String(av), String(bv));\r\n}\r\n\r\n/**\r\n * Pure helper — applies a multi-sort state to an array of rows.\r\n * Returns a NEW sorted array (input is not mutated); the original array\r\n * reference is returned untouched when there is nothing to sort.\r\n */\r\nexport function applySort<T extends object>(\r\n  rows: T[],\r\n  sort: readonly SortDescriptor[] | null | undefined,\r\n  options: ApplySortOptions = {},\r\n): T[] {\r\n  if (!sort?.length) return rows;\r\n  const collator = getCollator(options.locale);\r\n  return [...rows].sort((a, b) => {\r\n    for (const { key, dir } of sort) {\r\n      const cmp = compareValues(\r\n        (a as Record<string, unknown>)[key],\r\n        (b as Record<string, unknown>)[key],\r\n        collator,\r\n      );\r\n      if (cmp !== 0) return dir === \"asc\" ? cmp : -cmp;\r\n    }\r\n    return 0;\r\n  });\r\n}\r\n"],"mappings":"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","ignoreList":[]}