@portnet/ui 6.0.1 → 6.0.3

package/dist/v2/patterns/_useColumnResize.js

@@ -1,24 +1,11 @@
 "use strict";
 
-function _typeof(obj) { "@babel/helpers - typeof"; return _typeof = "function" == typeof Symbol && "symbol" == typeof Symbol.iterator ? function (obj) { return typeof obj; } : function (obj) { return obj && "function" == typeof Symbol && obj.constructor === Symbol && obj !== Symbol.prototype ? "symbol" : typeof obj; }, _typeof(obj); }
 Object.defineProperty(exports, "__esModule", {
   value: true
 });
-exports["default"] = useColumnResize;
+exports.default = useColumnResize;
 var React = _interopRequireWildcard(require("react"));
-function _getRequireWildcardCache(nodeInterop) { if (typeof WeakMap !== "function") return null; var cacheBabelInterop = new WeakMap(); var cacheNodeInterop = new WeakMap(); return (_getRequireWildcardCache = function _getRequireWildcardCache(nodeInterop) { return nodeInterop ? cacheNodeInterop : cacheBabelInterop; })(nodeInterop); }
-function _interopRequireWildcard(obj, nodeInterop) { if (!nodeInterop && obj && obj.__esModule) { return obj; } if (obj === null || _typeof(obj) !== "object" && typeof obj !== "function") { return { "default": obj }; } var cache = _getRequireWildcardCache(nodeInterop); if (cache && cache.has(obj)) { return cache.get(obj); } var newObj = {}; var hasPropertyDescriptor = Object.defineProperty && Object.getOwnPropertyDescriptor; for (var key in obj) { if (key !== "default" && Object.prototype.hasOwnProperty.call(obj, key)) { var desc = hasPropertyDescriptor ? Object.getOwnPropertyDescriptor(obj, key) : null; if (desc && (desc.get || desc.set)) { Object.defineProperty(newObj, key, desc); } else { newObj[key] = obj[key]; } } } newObj["default"] = obj; if (cache) { cache.set(obj, newObj); } return newObj; }
-function ownKeys(object, enumerableOnly) { var keys = Object.keys(object); if (Object.getOwnPropertySymbols) { var symbols = Object.getOwnPropertySymbols(object); enumerableOnly && (symbols = symbols.filter(function (sym) { return Object.getOwnPropertyDescriptor(object, sym).enumerable; })), keys.push.apply(keys, symbols); } return keys; }
-function _objectSpread(target) { for (var i = 1; i < arguments.length; i++) { var source = null != arguments[i] ? arguments[i] : {}; i % 2 ? ownKeys(Object(source), !0).forEach(function (key) { _defineProperty(target, key, source[key]); }) : Object.getOwnPropertyDescriptors ? Object.defineProperties(target, Object.getOwnPropertyDescriptors(source)) : ownKeys(Object(source)).forEach(function (key) { Object.defineProperty(target, key, Object.getOwnPropertyDescriptor(source, key)); }); } return target; }
-function _defineProperty(obj, key, value) { key = _toPropertyKey(key); if (key in obj) { Object.defineProperty(obj, key, { value: value, enumerable: true, configurable: true, writable: true }); } else { obj[key] = value; } return obj; }
-function _toPropertyKey(arg) { var key = _toPrimitive(arg, "string"); return _typeof(key) === "symbol" ? key : String(key); }
-function _toPrimitive(input, hint) { if (_typeof(input) !== "object" || input === null) return input; var prim = input[Symbol.toPrimitive]; if (prim !== undefined) { var res = prim.call(input, hint || "default"); if (_typeof(res) !== "object") return res; throw new TypeError("@@toPrimitive must return a primitive value."); } return (hint === "string" ? String : Number)(input); }
-function _slicedToArray(arr, i) { return _arrayWithHoles(arr) || _iterableToArrayLimit(arr, i) || _unsupportedIterableToArray(arr, i) || _nonIterableRest(); }
-function _nonIterableRest() { throw new TypeError("Invalid attempt to destructure non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method."); }
-function _unsupportedIterableToArray(o, minLen) { if (!o) return; if (typeof o === "string") return _arrayLikeToArray(o, minLen); var n = Object.prototype.toString.call(o).slice(8, -1); if (n === "Object" && o.constructor) n = o.constructor.name; if (n === "Map" || n === "Set") return Array.from(o); if (n === "Arguments" || /^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(n)) return _arrayLikeToArray(o, minLen); }
-function _arrayLikeToArray(arr, len) { if (len == null || len > arr.length) len = arr.length; for (var i = 0, arr2 = new Array(len); i < len; i++) { arr2[i] = arr[i]; } return arr2; }
-function _iterableToArrayLimit(arr, i) { var _i = null == arr ? null : "undefined" != typeof Symbol && arr[Symbol.iterator] || arr["@@iterator"]; if (null != _i) { var _s, _e, _x, _r, _arr = [], _n = !0, _d = !1; try { if (_x = (_i = _i.call(arr)).next, 0 === i) { if (Object(_i) !== _i) return; _n = !1; } else for (; !(_n = (_s = _x.call(_i)).done) && (_arr.push(_s.value), _arr.length !== i); _n = !0) { ; } } catch (err) { _d = !0, _e = err; } finally { try { if (!_n && null != _i["return"] && (_r = _i["return"](), Object(_r) !== _r)) return; } finally { if (_d) throw _e; } } return _arr; } }
-function _arrayWithHoles(arr) { if (Array.isArray(arr)) return arr; }
+function _interopRequireWildcard(e, t) { if ("function" == typeof WeakMap) var r = new WeakMap(), n = new WeakMap(); return (_interopRequireWildcard = function (e, t) { if (!t && e && e.__esModule) return e; var o, i, f = { __proto__: null, default: e }; if (null === e || "object" != typeof e && "function" != typeof e) return f; if (o = t ? n : r) { if (o.has(e)) return o.get(e); o.set(e, f); } for (const t in e) "default" !== t && {}.hasOwnProperty.call(e, t) && ((i = (o = Object.defineProperty) && Object.getOwnPropertyDescriptor(e, t)) && (i.get || i.set) ? o(f, t, i) : f[t] = e[t]); return f; })(e, t); }
 /**
  * useColumnResize — Portnet UI v2 (private)
  *
@@ -56,113 +43,104 @@ function _arrayWithHoles(arr) { if (Array.isArray(arr)) return arr; }
  */
 
 /** Width delta (px) applied per Arrow key press in keyboard resize. */
-var KEYBOARD_STEP = 16;
-function useColumnResize(columnWidths, onColumnWidthsChange) {
-  var _options$minWidth;
-  var options = arguments.length > 2 && arguments[2] !== undefined ? arguments[2] : {};
-  var minWidth = (_options$minWidth = options.minWidth) !== null && _options$minWidth !== void 0 ? _options$minWidth : 50;
+const KEYBOARD_STEP = 16;
+function useColumnResize(columnWidths, onColumnWidthsChange, options = {}) {
+  const minWidth = options.minWidth ?? 50;
 
   // React state for "draggingKey" + "liveWidth" drives the rendered
   // width during drag. Refs carry the latest values across the
   // mouseup closure (avoids the stale-closure bug).
-  var _React$useState = React.useState(null),
-    _React$useState2 = _slicedToArray(_React$useState, 2),
-    draggingKey = _React$useState2[0],
-    setDraggingKey = _React$useState2[1];
-  var _React$useState3 = React.useState(null),
-    _React$useState4 = _slicedToArray(_React$useState3, 2),
-    liveWidth = _React$useState4[0],
-    setLiveWidth = _React$useState4[1];
-  var liveWidthRef = React.useRef(null);
-  var dragStateRef = React.useRef(null);
+  const [draggingKey, setDraggingKey] = React.useState(null);
+  const [liveWidth, setLiveWidth] = React.useState(null);
+  const liveWidthRef = React.useRef(null);
+  const dragStateRef = React.useRef(null);
 
   // Keep the latest columnWidths reference reachable from the
   // mouseup closure without re-binding listeners on every prop
   // change. Avoids tearing down + re-adding the window listeners
   // on each parent re-render that ships a fresh widths object.
-  var columnWidthsRef = React.useRef(columnWidths);
-  React.useEffect(function () {
+  const columnWidthsRef = React.useRef(columnWidths);
+  React.useEffect(() => {
     columnWidthsRef.current = columnWidths;
   }, [columnWidths]);
 
   // Shared RTL probe for a grip's owning <th>: -1 in RTL, 1 otherwise.
-  var cellDirection = function cellDirection(grip) {
-    var cell = grip.closest("th");
+  const cellDirection = grip => {
+    const cell = grip.closest("th");
     return cell && typeof window !== "undefined" && typeof window.getComputedStyle === "function" && window.getComputedStyle(cell).direction === "rtl" ? -1 : 1;
   };
-  var handleMouseDown = React.useCallback(function (key) {
-    return function (e) {
-      var _ref;
-      // Block native browser drag (text selection, image drag, the
-      // ancestor `<th draggable>` if reorder is also on) and the
-      // sortable-header click that lives next door in the same `<th>`.
-      e.preventDefault();
-      e.stopPropagation();
-      var grip = e.currentTarget;
-      var cell = grip.closest("th");
-      if (!cell) return;
+  const handleMouseDown = React.useCallback(key => e => {
+    // Block native browser drag (text selection, image drag, the
+    // ancestor `<th draggable>` if reorder is also on) and the
+    // sortable-header click that lives next door in the same `<th>`.
+    e.preventDefault();
+    e.stopPropagation();
+    const grip = e.currentTarget;
+    const cell = grip.closest("th");
+    if (!cell) return;
 
-      // RTL detection at the cell level — most accurate (a `dir`
-      // attribute may be set anywhere up the ancestor chain).
-      var direction = cellDirection(grip);
+    // RTL detection at the cell level — most accurate (a `dir`
+    // attribute may be set anywhere up the ancestor chain).
+    const direction = cellDirection(grip);
 
-      // Starting width: prefer the host-controlled value, fall back to
-      // the rendered offsetWidth for a column the host hasn't sized.
-      var currentWidth = (_ref = columnWidthsRef.current && columnWidthsRef.current[key]) !== null && _ref !== void 0 ? _ref : cell.offsetWidth;
-      dragStateRef.current = {
-        x: e.clientX,
-        width: currentWidth,
-        key: key,
-        direction: direction
-      };
-      liveWidthRef.current = currentWidth;
-      setLiveWidth(currentWidth);
-      setDraggingKey(key);
+    // Starting width: prefer the host-controlled value, fall back to
+    // the rendered offsetWidth for a column the host hasn't sized.
+    const currentWidth = (columnWidthsRef.current && columnWidthsRef.current[key]) ?? cell.offsetWidth;
+    dragStateRef.current = {
+      x: e.clientX,
+      width: currentWidth,
+      key,
+      direction
     };
+    liveWidthRef.current = currentWidth;
+    setLiveWidth(currentWidth);
+    setDraggingKey(key);
   }, []);
 
   // DG-2 — keyboard resize on the focusable grip. Commits immediately;
   // no drag session / window listeners involved.
-  var handleKeyDown = React.useCallback(function (key) {
-    return function (e) {
-      var _ref2;
-      var isLeft = e.key === "ArrowLeft";
-      var isRight = e.key === "ArrowRight";
-      var isHome = e.key === "Home";
-      if (!isLeft && !isRight && !isHome) return;
-      e.preventDefault();
-      e.stopPropagation();
-      var grip = e.currentTarget;
-      var cell = grip.closest("th");
-      var direction = cellDirection(grip);
-      var current = (_ref2 = columnWidthsRef.current && columnWidthsRef.current[key]) !== null && _ref2 !== void 0 ? _ref2 : cell ? cell.offsetWidth : minWidth;
+  const handleKeyDown = React.useCallback(key => e => {
+    const isLeft = e.key === "ArrowLeft";
+    const isRight = e.key === "ArrowRight";
+    const isHome = e.key === "Home";
+    if (!isLeft && !isRight && !isHome) return;
+    e.preventDefault();
+    e.stopPropagation();
+    const grip = e.currentTarget;
+    const cell = grip.closest("th");
+    const direction = cellDirection(grip);
+    const current = (columnWidthsRef.current && columnWidthsRef.current[key]) ?? (cell ? cell.offsetWidth : minWidth);
 
-      // RTL-aware so ArrowRight matches a rightward drag (which grows the
-      // column in LTR and shrinks it in RTL, the grip being on the
-      // inline-end edge).
-      var next = isHome ? minWidth : current + (isRight ? 1 : -1) * KEYBOARD_STEP * direction;
-      var clamped = Math.max(minWidth, Math.round(next));
-      if (onColumnWidthsChange) {
-        onColumnWidthsChange(_objectSpread(_objectSpread({}, columnWidthsRef.current || {}), {}, _defineProperty({}, key, clamped)));
-      }
-    };
+    // RTL-aware so ArrowRight matches a rightward drag (which grows the
+    // column in LTR and shrinks it in RTL, the grip being on the
+    // inline-end edge).
+    const next = isHome ? minWidth : current + (isRight ? 1 : -1) * KEYBOARD_STEP * direction;
+    const clamped = Math.max(minWidth, Math.round(next));
+    if (onColumnWidthsChange) {
+      onColumnWidthsChange({
+        ...(columnWidthsRef.current || {}),
+        [key]: clamped
+      });
+    }
   }, [minWidth, onColumnWidthsChange]);
-  React.useEffect(function () {
+  React.useEffect(() => {
     if (!draggingKey) return undefined;
-    var onMove = function onMove(e) {
-      var start = dragStateRef.current;
+    const onMove = e => {
+      const start = dragStateRef.current;
       if (!start) return;
-      var delta = (e.clientX - start.x) * start.direction;
-      var next = Math.max(minWidth, start.width + delta);
+      const delta = (e.clientX - start.x) * start.direction;
+      const next = Math.max(minWidth, start.width + delta);
       liveWidthRef.current = next;
       setLiveWidth(next);
     };
-    var onUp = function onUp() {
-      var _liveWidthRef$current;
-      var start = dragStateRef.current;
-      var finalWidth = (_liveWidthRef$current = liveWidthRef.current) !== null && _liveWidthRef$current !== void 0 ? _liveWidthRef$current : start ? start.width : null;
+    const onUp = () => {
+      const start = dragStateRef.current;
+      const finalWidth = liveWidthRef.current ?? (start ? start.width : null);
       if (start && finalWidth != null && onColumnWidthsChange) {
-        onColumnWidthsChange(_objectSpread(_objectSpread({}, columnWidthsRef.current || {}), {}, _defineProperty({}, start.key, finalWidth)));
+        onColumnWidthsChange({
+          ...(columnWidthsRef.current || {}),
+          [start.key]: finalWidth
+        });
       }
       dragStateRef.current = null;
       liveWidthRef.current = null;
@@ -171,7 +149,7 @@ function useColumnResize(columnWidths, onColumnWidthsChange) {
     };
     window.addEventListener("mousemove", onMove);
     window.addEventListener("mouseup", onUp);
-    return function () {
+    return () => {
       window.removeEventListener("mousemove", onMove);
       window.removeEventListener("mouseup", onUp);
     };
@@ -183,16 +161,19 @@ function useColumnResize(columnWidths, onColumnWidthsChange) {
   // Live widths map = host columnWidths with the in-flight drag value
   // patched in. Memoised on [draggingKey, liveWidth, columnWidths] so
   // the reference is stable when nothing is dragging.
-  var liveWidths = React.useMemo(function () {
+  const liveWidths = React.useMemo(() => {
     if (!draggingKey || liveWidth == null) return columnWidths;
-    return _objectSpread(_objectSpread({}, columnWidths || {}), {}, _defineProperty({}, draggingKey, liveWidth));
+    return {
+      ...(columnWidths || {}),
+      [draggingKey]: liveWidth
+    };
   }, [draggingKey, liveWidth, columnWidths]);
   return {
-    handleMouseDown: handleMouseDown,
-    handleKeyDown: handleKeyDown,
-    liveWidths: liveWidths,
+    handleMouseDown,
+    handleKeyDown,
+    liveWidths,
     isResizing: draggingKey != null,
-    minWidth: minWidth
+    minWidth
   };
 }
 //# sourceMappingURL=_useColumnResize.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"_useColumnResize.js","names":["React","_interopRequireWildcard","require","_getRequireWildcardCache","nodeInterop","WeakMap","cacheBabelInterop","cacheNodeInterop","obj","__esModule","_typeof","cache","has","get","newObj","hasPropertyDescriptor","Object","defineProperty","getOwnPropertyDescriptor","key","prototype","hasOwnProperty","call","desc","set","ownKeys","object","enumerableOnly","keys","getOwnPropertySymbols","symbols","filter","sym","enumerable","push","apply","_objectSpread","target","i","arguments","length","source","forEach","_defineProperty","getOwnPropertyDescriptors","defineProperties","value","_toPropertyKey","configurable","writable","arg","_toPrimitive","String","input","hint","prim","Symbol","toPrimitive","undefined","res","TypeError","Number","_slicedToArray","arr","_arrayWithHoles","_iterableToArrayLimit","_unsupportedIterableToArray","_nonIterableRest","o","minLen","_arrayLikeToArray","n","toString","slice","constructor","name","Array","from","test","len","arr2","_i","iterator","_s","_e","_x","_r","_arr","_n","_d","next","done","err","isArray","KEYBOARD_STEP","useColumnResize","columnWidths","onColumnWidthsChange","_options$minWidth","options","minWidth","_React$useState","useState","_React$useState2","draggingKey","setDraggingKey","_React$useState3","_React$useState4","liveWidth","setLiveWidth","liveWidthRef","useRef","dragStateRef","columnWidthsRef","useEffect","current","cellDirection","grip","cell","closest","window","getComputedStyle","direction","handleMouseDown","useCallback","e","_ref","preventDefault","stopPropagation","currentTarget","currentWidth","offsetWidth","x","clientX","width","handleKeyDown","_ref2","isLeft","isRight","isHome","clamped","Math","max","round","onMove","start","delta","onUp","_liveWidthRef$current","finalWidth","addEventListener","removeEventListener","liveWidths","useMemo","isResizing"],"sources":["../../../src/lib/v2/patterns/_useColumnResize.ts"],"sourcesContent":["import * as React from \"react\";\r\n\r\n/**\r\n * useColumnResize — Portnet UI v2 (private)\r\n *\r\n * Internal hook for the DataGrid + DataGridVirtualized resize\r\n * feature. NOT exported from the patterns barrel; underscore filename\r\n * prefix is the convention.\r\n *\r\n *   const { handleMouseDown, handleKeyDown, liveWidths, isResizing, minWidth } =\r\n *     useColumnResize(\r\n *       columnWidths,            // controlled\r\n *       onColumnWidthsChange,    // controlled\r\n *       { minWidth: 50 }\r\n *     );\r\n *\r\n * Behaviour (pointer):\r\n *   - handleMouseDown(key) returns an onMouseDown handler. Attach to\r\n *     the grip element on each `<th>` border.\r\n *   - On mousedown: captures starting clientX + current width + the\r\n *     direction of the cell's writing mode (LTR vs RTL). Sets\r\n *     `isResizing = true` so callers (e.g. the reorder hook) can\r\n *     short-circuit.\r\n *   - On mousemove (window-bound): computes the resize delta\r\n *     respecting RTL and updates a local \"live\" width via state.\r\n *     Floors at `minWidth`.\r\n *   - On mouseup (window-bound): commits the live width to the host\r\n *     via `onColumnWidthsChange`. Clears all internal state.\r\n *\r\n * Behaviour (keyboard, DG-2 / WCAG 2.1.1):\r\n *   - handleKeyDown(key) returns an onKeyDown handler for the SAME grip\r\n *     (the grip is a focusable role=\"separator\"). ArrowRight / ArrowLeft\r\n *     nudge the width by KEYBOARD_STEP px, RTL-aware so the direction\r\n *     matches a rightward drag; Home resets to `minWidth`. Each press\r\n *     commits immediately via `onColumnWidthsChange` (no drag session).\r\n *   - `minWidth` is returned so the separator can advertise aria-valuemin.\r\n */\r\n\r\nexport type ColumnWidths = Record<string, number>;\r\n\r\n/** Width delta (px) applied per Arrow key press in keyboard resize. */\r\nconst KEYBOARD_STEP = 16;\r\n\r\nexport interface UseColumnResizeOptions {\r\n  minWidth?: number | undefined;\r\n}\r\n\r\nexport interface UseColumnResizeResult {\r\n  handleMouseDown: (key: string) => (e: React.MouseEvent) => void;\r\n  handleKeyDown: (key: string) => (e: React.KeyboardEvent) => void;\r\n  liveWidths: ColumnWidths | undefined;\r\n  isResizing: boolean;\r\n  minWidth: number;\r\n}\r\n\r\ninterface DragState {\r\n  x: number;\r\n  width: number;\r\n  key: string;\r\n  direction: 1 | -1;\r\n}\r\n\r\nexport default function useColumnResize(\r\n  columnWidths: ColumnWidths | undefined,\r\n  onColumnWidthsChange: ((widths: ColumnWidths) => void) | undefined,\r\n  options: UseColumnResizeOptions = {}\r\n): UseColumnResizeResult {\r\n  const minWidth = options.minWidth ?? 50;\r\n\r\n  // React state for \"draggingKey\" + \"liveWidth\" drives the rendered\r\n  // width during drag. Refs carry the latest values across the\r\n  // mouseup closure (avoids the stale-closure bug).\r\n  const [draggingKey, setDraggingKey] = React.useState<string | null>(null);\r\n  const [liveWidth, setLiveWidth] = React.useState<number | null>(null);\r\n  const liveWidthRef = React.useRef<number | null>(null);\r\n  const dragStateRef = React.useRef<DragState | null>(null);\r\n\r\n  // Keep the latest columnWidths reference reachable from the\r\n  // mouseup closure without re-binding listeners on every prop\r\n  // change. Avoids tearing down + re-adding the window listeners\r\n  // on each parent re-render that ships a fresh widths object.\r\n  const columnWidthsRef = React.useRef<ColumnWidths | undefined>(columnWidths);\r\n  React.useEffect(() => {\r\n    columnWidthsRef.current = columnWidths;\r\n  }, [columnWidths]);\r\n\r\n  // Shared RTL probe for a grip's owning <th>: -1 in RTL, 1 otherwise.\r\n  const cellDirection = (grip: HTMLElement): 1 | -1 => {\r\n    const cell = grip.closest(\"th\");\r\n    return cell &&\r\n      typeof window !== \"undefined\" &&\r\n      typeof window.getComputedStyle === \"function\" &&\r\n      window.getComputedStyle(cell).direction === \"rtl\"\r\n      ? -1\r\n      : 1;\r\n  };\r\n\r\n  const handleMouseDown = React.useCallback((key: string) => (e: React.MouseEvent) => {\r\n    // Block native browser drag (text selection, image drag, the\r\n    // ancestor `<th draggable>` if reorder is also on) and the\r\n    // sortable-header click that lives next door in the same `<th>`.\r\n    e.preventDefault();\r\n    e.stopPropagation();\r\n\r\n    const grip = e.currentTarget as HTMLElement;\r\n    const cell = grip.closest(\"th\");\r\n    if (!cell) return;\r\n\r\n    // RTL detection at the cell level — most accurate (a `dir`\r\n    // attribute may be set anywhere up the ancestor chain).\r\n    const direction = cellDirection(grip);\r\n\r\n    // Starting width: prefer the host-controlled value, fall back to\r\n    // the rendered offsetWidth for a column the host hasn't sized.\r\n    const currentWidth =\r\n      (columnWidthsRef.current && columnWidthsRef.current[key]) ??\r\n      cell.offsetWidth;\r\n\r\n    dragStateRef.current = {\r\n      x: e.clientX,\r\n      width: currentWidth,\r\n      key,\r\n      direction,\r\n    };\r\n\r\n    liveWidthRef.current = currentWidth;\r\n    setLiveWidth(currentWidth);\r\n    setDraggingKey(key);\r\n  }, []);\r\n\r\n  // DG-2 — keyboard resize on the focusable grip. Commits immediately;\r\n  // no drag session / window listeners involved.\r\n  const handleKeyDown = React.useCallback(\r\n    (key: string) => (e: React.KeyboardEvent) => {\r\n      const isLeft = e.key === \"ArrowLeft\";\r\n      const isRight = e.key === \"ArrowRight\";\r\n      const isHome = e.key === \"Home\";\r\n      if (!isLeft && !isRight && !isHome) return;\r\n      e.preventDefault();\r\n      e.stopPropagation();\r\n\r\n      const grip = e.currentTarget as HTMLElement;\r\n      const cell = grip.closest(\"th\");\r\n      const direction = cellDirection(grip);\r\n\r\n      const current =\r\n        (columnWidthsRef.current && columnWidthsRef.current[key]) ??\r\n        (cell ? cell.offsetWidth : minWidth);\r\n\r\n      // RTL-aware so ArrowRight matches a rightward drag (which grows the\r\n      // column in LTR and shrinks it in RTL, the grip being on the\r\n      // inline-end edge).\r\n      const next = isHome\r\n        ? minWidth\r\n        : current + (isRight ? 1 : -1) * KEYBOARD_STEP * direction;\r\n\r\n      const clamped = Math.max(minWidth, Math.round(next));\r\n      if (onColumnWidthsChange) {\r\n        onColumnWidthsChange({ ...(columnWidthsRef.current || {}), [key]: clamped });\r\n      }\r\n    },\r\n    [minWidth, onColumnWidthsChange]\r\n  );\r\n\r\n  React.useEffect(() => {\r\n    if (!draggingKey) return undefined;\r\n\r\n    const onMove = (e: MouseEvent) => {\r\n      const start = dragStateRef.current;\r\n      if (!start) return;\r\n      const delta = (e.clientX - start.x) * start.direction;\r\n      const next = Math.max(minWidth, start.width + delta);\r\n      liveWidthRef.current = next;\r\n      setLiveWidth(next);\r\n    };\r\n\r\n    const onUp = () => {\r\n      const start = dragStateRef.current;\r\n      const finalWidth = liveWidthRef.current ?? (start ? start.width : null);\r\n      if (start && finalWidth != null && onColumnWidthsChange) {\r\n        onColumnWidthsChange({\r\n          ...(columnWidthsRef.current || {}),\r\n          [start.key]: finalWidth,\r\n        });\r\n      }\r\n      dragStateRef.current = null;\r\n      liveWidthRef.current = null;\r\n      setLiveWidth(null);\r\n      setDraggingKey(null);\r\n    };\r\n\r\n    window.addEventListener(\"mousemove\", onMove);\r\n    window.addEventListener(\"mouseup\", onUp);\r\n    return () => {\r\n      window.removeEventListener(\"mousemove\", onMove);\r\n      window.removeEventListener(\"mouseup\", onUp);\r\n    };\r\n    // onColumnWidthsChange is intentionally listed — re-creates the\r\n    // mouseup closure with the latest setter ref. minWidth is rare\r\n    // to change but listed for correctness.\r\n  }, [draggingKey, onColumnWidthsChange, minWidth]);\r\n\r\n  // Live widths map = host columnWidths with the in-flight drag value\r\n  // patched in. Memoised on [draggingKey, liveWidth, columnWidths] so\r\n  // the reference is stable when nothing is dragging.\r\n  const liveWidths = React.useMemo(() => {\r\n    if (!draggingKey || liveWidth == null) return columnWidths;\r\n    return { ...(columnWidths || {}), [draggingKey]: liveWidth };\r\n  }, [draggingKey, liveWidth, columnWidths]);\r\n\r\n  return {\r\n    handleMouseDown,\r\n    handleKeyDown,\r\n    liveWidths,\r\n    isResizing: draggingKey != null,\r\n    minWidth,\r\n  };\r\n}\r\n"],"mappings":"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","ignoreList":[]}
+{"version":3,"file":"_useColumnResize.js","names":["React","_interopRequireWildcard","require","e","t","WeakMap","r","n","__esModule","o","i","f","__proto__","default","has","get","set","hasOwnProperty","call","Object","defineProperty","getOwnPropertyDescriptor","KEYBOARD_STEP","useColumnResize","columnWidths","onColumnWidthsChange","options","minWidth","draggingKey","setDraggingKey","useState","liveWidth","setLiveWidth","liveWidthRef","useRef","dragStateRef","columnWidthsRef","useEffect","current","cellDirection","grip","cell","closest","window","getComputedStyle","direction","handleMouseDown","useCallback","key","preventDefault","stopPropagation","currentTarget","currentWidth","offsetWidth","x","clientX","width","handleKeyDown","isLeft","isRight","isHome","next","clamped","Math","max","round","undefined","onMove","start","delta","onUp","finalWidth","addEventListener","removeEventListener","liveWidths","useMemo","isResizing"],"sources":["../../../src/lib/v2/patterns/_useColumnResize.ts"],"sourcesContent":["import * as React from \"react\";\r\n\r\n/**\r\n * useColumnResize — Portnet UI v2 (private)\r\n *\r\n * Internal hook for the DataGrid + DataGridVirtualized resize\r\n * feature. NOT exported from the patterns barrel; underscore filename\r\n * prefix is the convention.\r\n *\r\n *   const { handleMouseDown, handleKeyDown, liveWidths, isResizing, minWidth } =\r\n *     useColumnResize(\r\n *       columnWidths,            // controlled\r\n *       onColumnWidthsChange,    // controlled\r\n *       { minWidth: 50 }\r\n *     );\r\n *\r\n * Behaviour (pointer):\r\n *   - handleMouseDown(key) returns an onMouseDown handler. Attach to\r\n *     the grip element on each `<th>` border.\r\n *   - On mousedown: captures starting clientX + current width + the\r\n *     direction of the cell's writing mode (LTR vs RTL). Sets\r\n *     `isResizing = true` so callers (e.g. the reorder hook) can\r\n *     short-circuit.\r\n *   - On mousemove (window-bound): computes the resize delta\r\n *     respecting RTL and updates a local \"live\" width via state.\r\n *     Floors at `minWidth`.\r\n *   - On mouseup (window-bound): commits the live width to the host\r\n *     via `onColumnWidthsChange`. Clears all internal state.\r\n *\r\n * Behaviour (keyboard, DG-2 / WCAG 2.1.1):\r\n *   - handleKeyDown(key) returns an onKeyDown handler for the SAME grip\r\n *     (the grip is a focusable role=\"separator\"). ArrowRight / ArrowLeft\r\n *     nudge the width by KEYBOARD_STEP px, RTL-aware so the direction\r\n *     matches a rightward drag; Home resets to `minWidth`. Each press\r\n *     commits immediately via `onColumnWidthsChange` (no drag session).\r\n *   - `minWidth` is returned so the separator can advertise aria-valuemin.\r\n */\r\n\r\nexport type ColumnWidths = Record<string, number>;\r\n\r\n/** Width delta (px) applied per Arrow key press in keyboard resize. */\r\nconst KEYBOARD_STEP = 16;\r\n\r\nexport interface UseColumnResizeOptions {\r\n  minWidth?: number | undefined;\r\n}\r\n\r\nexport interface UseColumnResizeResult {\r\n  handleMouseDown: (key: string) => (e: React.MouseEvent) => void;\r\n  handleKeyDown: (key: string) => (e: React.KeyboardEvent) => void;\r\n  liveWidths: ColumnWidths | undefined;\r\n  isResizing: boolean;\r\n  minWidth: number;\r\n}\r\n\r\ninterface DragState {\r\n  x: number;\r\n  width: number;\r\n  key: string;\r\n  direction: 1 | -1;\r\n}\r\n\r\nexport default function useColumnResize(\r\n  columnWidths: ColumnWidths | undefined,\r\n  onColumnWidthsChange: ((widths: ColumnWidths) => void) | undefined,\r\n  options: UseColumnResizeOptions = {}\r\n): UseColumnResizeResult {\r\n  const minWidth = options.minWidth ?? 50;\r\n\r\n  // React state for \"draggingKey\" + \"liveWidth\" drives the rendered\r\n  // width during drag. Refs carry the latest values across the\r\n  // mouseup closure (avoids the stale-closure bug).\r\n  const [draggingKey, setDraggingKey] = React.useState<string | null>(null);\r\n  const [liveWidth, setLiveWidth] = React.useState<number | null>(null);\r\n  const liveWidthRef = React.useRef<number | null>(null);\r\n  const dragStateRef = React.useRef<DragState | null>(null);\r\n\r\n  // Keep the latest columnWidths reference reachable from the\r\n  // mouseup closure without re-binding listeners on every prop\r\n  // change. Avoids tearing down + re-adding the window listeners\r\n  // on each parent re-render that ships a fresh widths object.\r\n  const columnWidthsRef = React.useRef<ColumnWidths | undefined>(columnWidths);\r\n  React.useEffect(() => {\r\n    columnWidthsRef.current = columnWidths;\r\n  }, [columnWidths]);\r\n\r\n  // Shared RTL probe for a grip's owning <th>: -1 in RTL, 1 otherwise.\r\n  const cellDirection = (grip: HTMLElement): 1 | -1 => {\r\n    const cell = grip.closest(\"th\");\r\n    return cell &&\r\n      typeof window !== \"undefined\" &&\r\n      typeof window.getComputedStyle === \"function\" &&\r\n      window.getComputedStyle(cell).direction === \"rtl\"\r\n      ? -1\r\n      : 1;\r\n  };\r\n\r\n  const handleMouseDown = React.useCallback((key: string) => (e: React.MouseEvent) => {\r\n    // Block native browser drag (text selection, image drag, the\r\n    // ancestor `<th draggable>` if reorder is also on) and the\r\n    // sortable-header click that lives next door in the same `<th>`.\r\n    e.preventDefault();\r\n    e.stopPropagation();\r\n\r\n    const grip = e.currentTarget as HTMLElement;\r\n    const cell = grip.closest(\"th\");\r\n    if (!cell) return;\r\n\r\n    // RTL detection at the cell level — most accurate (a `dir`\r\n    // attribute may be set anywhere up the ancestor chain).\r\n    const direction = cellDirection(grip);\r\n\r\n    // Starting width: prefer the host-controlled value, fall back to\r\n    // the rendered offsetWidth for a column the host hasn't sized.\r\n    const currentWidth =\r\n      (columnWidthsRef.current && columnWidthsRef.current[key]) ??\r\n      cell.offsetWidth;\r\n\r\n    dragStateRef.current = {\r\n      x: e.clientX,\r\n      width: currentWidth,\r\n      key,\r\n      direction,\r\n    };\r\n\r\n    liveWidthRef.current = currentWidth;\r\n    setLiveWidth(currentWidth);\r\n    setDraggingKey(key);\r\n  }, []);\r\n\r\n  // DG-2 — keyboard resize on the focusable grip. Commits immediately;\r\n  // no drag session / window listeners involved.\r\n  const handleKeyDown = React.useCallback(\r\n    (key: string) => (e: React.KeyboardEvent) => {\r\n      const isLeft = e.key === \"ArrowLeft\";\r\n      const isRight = e.key === \"ArrowRight\";\r\n      const isHome = e.key === \"Home\";\r\n      if (!isLeft && !isRight && !isHome) return;\r\n      e.preventDefault();\r\n      e.stopPropagation();\r\n\r\n      const grip = e.currentTarget as HTMLElement;\r\n      const cell = grip.closest(\"th\");\r\n      const direction = cellDirection(grip);\r\n\r\n      const current =\r\n        (columnWidthsRef.current && columnWidthsRef.current[key]) ??\r\n        (cell ? cell.offsetWidth : minWidth);\r\n\r\n      // RTL-aware so ArrowRight matches a rightward drag (which grows the\r\n      // column in LTR and shrinks it in RTL, the grip being on the\r\n      // inline-end edge).\r\n      const next = isHome\r\n        ? minWidth\r\n        : current + (isRight ? 1 : -1) * KEYBOARD_STEP * direction;\r\n\r\n      const clamped = Math.max(minWidth, Math.round(next));\r\n      if (onColumnWidthsChange) {\r\n        onColumnWidthsChange({ ...(columnWidthsRef.current || {}), [key]: clamped });\r\n      }\r\n    },\r\n    [minWidth, onColumnWidthsChange]\r\n  );\r\n\r\n  React.useEffect(() => {\r\n    if (!draggingKey) return undefined;\r\n\r\n    const onMove = (e: MouseEvent) => {\r\n      const start = dragStateRef.current;\r\n      if (!start) return;\r\n      const delta = (e.clientX - start.x) * start.direction;\r\n      const next = Math.max(minWidth, start.width + delta);\r\n      liveWidthRef.current = next;\r\n      setLiveWidth(next);\r\n    };\r\n\r\n    const onUp = () => {\r\n      const start = dragStateRef.current;\r\n      const finalWidth = liveWidthRef.current ?? (start ? start.width : null);\r\n      if (start && finalWidth != null && onColumnWidthsChange) {\r\n        onColumnWidthsChange({\r\n          ...(columnWidthsRef.current || {}),\r\n          [start.key]: finalWidth,\r\n        });\r\n      }\r\n      dragStateRef.current = null;\r\n      liveWidthRef.current = null;\r\n      setLiveWidth(null);\r\n      setDraggingKey(null);\r\n    };\r\n\r\n    window.addEventListener(\"mousemove\", onMove);\r\n    window.addEventListener(\"mouseup\", onUp);\r\n    return () => {\r\n      window.removeEventListener(\"mousemove\", onMove);\r\n      window.removeEventListener(\"mouseup\", onUp);\r\n    };\r\n    // onColumnWidthsChange is intentionally listed — re-creates the\r\n    // mouseup closure with the latest setter ref. minWidth is rare\r\n    // to change but listed for correctness.\r\n  }, [draggingKey, onColumnWidthsChange, minWidth]);\r\n\r\n  // Live widths map = host columnWidths with the in-flight drag value\r\n  // patched in. Memoised on [draggingKey, liveWidth, columnWidths] so\r\n  // the reference is stable when nothing is dragging.\r\n  const liveWidths = React.useMemo(() => {\r\n    if (!draggingKey || liveWidth == null) return columnWidths;\r\n    return { ...(columnWidths || {}), [draggingKey]: liveWidth };\r\n  }, [draggingKey, liveWidth, columnWidths]);\r\n\r\n  return {\r\n    handleMouseDown,\r\n    handleKeyDown,\r\n    liveWidths,\r\n    isResizing: draggingKey != null,\r\n    minWidth,\r\n  };\r\n}\r\n"],"mappings":"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","ignoreList":[]}

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

@@ -0,0 +1,78 @@
+import type { DataGridToolbarFilterChip } from "./DataGridToolbar";
+/**
+ * filterCriteria — active search criteria as removable chips
+ * (capability gap G-42).
+ *
+ * ─────────────────────────────────────────────────────────────────────────────
+ * WHY THIS BELONGS IN THE LIBRARY
+ *
+ * The library owns HALF of this already, and the half it owns is the rendering:
+ * `DataGridToolbar.filterChips` draws one removable chip per criterion, and
+ * `DataGridToolbarFilterChip` describes an entry. That type's own docstring
+ * records where the request came from — `refonte-frontend`, whose ten listings
+ * each had to build the array — and that §Filters and §Search make removable
+ * active criteria a MUST.
+ *
+ * What was missing is the BUILDER. Ten local copies would have drifted on the
+ * two things that are not obvious:
+ *
+ *   1. WHAT COUNTS AS SET. `0` is the "unset" value of a reference mirror on
+ *      some hosts (`villeEntreeId: 0`), `""` on others, `null` elsewhere. A
+ *      chip that appears for `0` announces a filter nobody chose.
+ *   2. WHAT A REMOVAL MUST CLEAR. Reference criteria are held as PAIRS — a
+ *      scalar mirror for the payload and an object for display
+ *      (`importateurCode` / `importateurId`). Clearing only the displayed key
+ *      removes the chip from the screen while the criterion STAYS IN THE
+ *      PAYLOAD: the worst of both worlds, an invisible filter that still
+ *      filters. Hence `linkedKeys`.
+ *
+ * >>> THIS BUILDER DOES NOT RE-RUN THE SEARCH, and that is deliberate. `onRemove`
+ * >>> hands the host the keys to clear and gives the turn back: only the host
+ * >>> knows whether to clear Formik fields, rebuild its payload and redispatch —
+ * >>> and on server-paginated listings a removal is a REQUEST, not a local
+ * >>> filtering pass. A builder that dispatched would be wrong on every screen
+ * >>> whose payload it cannot know. <<<
+ * ─────────────────────────────────────────────────────────────────────────────
+ *
+ * Promoted from `refonte-frontend` (Area 5), where it served ten listings.
+ * Pair it with `useAppliedFilters`: this builds the chips, that decides which
+ * criteria they may show — chips built from live form values announce a filter
+ * that is being typed and filters nothing.
+ */
+/** A filterable criterion, as the screen describes it. */
+export interface FilterCriterion {
+    /** Form field holding the displayed value. */
+    key: string;
+    /** Label the user reads on the chip. */
+    label: string;
+    /**
+     * Fields to clear IN ADDITION to `key` — scalar mirrors, ids. See the note
+     * on pairs above: omitting them leaves the criterion in the payload.
+     */
+    linkedKeys?: string[] | undefined;
+    /**
+     * Renders the value on the chip. Defaults to the description of a reference
+     * object, otherwise the value as-is.
+     */
+    format?: ((value: unknown) => string) | undefined;
+}
+/**
+ * `true` if a criterion is SET — exactly the rule the chips use.
+ *
+ * Exported so a "Filters" button counter can count the same criteria the chips
+ * render. Screens used to count non-empty `formik.values`, which counts every
+ * reference criterion TWICE — the pair again — so picking one category showed
+ * "2 filters".
+ */
+export declare function isCriterionSet(value: unknown): boolean;
+/** Every key of every descriptor — for a "clear all". */
+export declare function filterCriteriaKeys(criteria: readonly FilterCriterion[]): string[];
+/**
+ * Builds the chips of the criteria that are SET.
+ *
+ * @param values   current values of the search form (or the applied snapshot)
+ * @param criteria criteria to watch, in display order
+ * @param onRemove called with every key to clear for that criterion
+ */
+export declare function buildFilterChips(values: Record<string, unknown>, criteria: readonly FilterCriterion[], onRemove: (keys: string[]) => void): DataGridToolbarFilterChip[];
+//# sourceMappingURL=filterCriteria.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"filterCriteria.d.ts","sourceRoot":"","sources":["../../../src/lib/v2/patterns/filterCriteria.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,mBAAmB,CAAC;AAEnE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuCG;AAEH,0DAA0D;AAC1D,MAAM,WAAW,eAAe;IAC9B,8CAA8C;IAC9C,GAAG,EAAE,MAAM,CAAC;IACZ,wCAAwC;IACxC,KAAK,EAAE,MAAM,CAAC;IACd;;;OAGG;IACH,UAAU,CAAC,EAAE,MAAM,EAAE,GAAG,SAAS,CAAC;IAClC;;;OAGG;IACH,MAAM,CAAC,EAAE,CAAC,CAAC,KAAK,EAAE,OAAO,KAAK,MAAM,CAAC,GAAG,SAAS,CAAC;CACnD;AAyBD;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAEtD;AAED,yDAAyD;AACzD,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,SAAS,eAAe,EAAE,GAAG,MAAM,EAAE,CAEjF;AAED;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAC9B,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,QAAQ,EAAE,SAAS,eAAe,EAAE,EACpC,QAAQ,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,IAAI,GACjC,yBAAyB,EAAE,CAc7B"}

package/dist/v2/patterns/filterCriteria.js

@@ -0,0 +1,110 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.buildFilterChips = buildFilterChips;
+exports.filterCriteriaKeys = filterCriteriaKeys;
+exports.isCriterionSet = isCriterionSet;
+/**
+ * filterCriteria — active search criteria as removable chips
+ * (capability gap G-42).
+ *
+ * ─────────────────────────────────────────────────────────────────────────────
+ * WHY THIS BELONGS IN THE LIBRARY
+ *
+ * The library owns HALF of this already, and the half it owns is the rendering:
+ * `DataGridToolbar.filterChips` draws one removable chip per criterion, and
+ * `DataGridToolbarFilterChip` describes an entry. That type's own docstring
+ * records where the request came from — `refonte-frontend`, whose ten listings
+ * each had to build the array — and that §Filters and §Search make removable
+ * active criteria a MUST.
+ *
+ * What was missing is the BUILDER. Ten local copies would have drifted on the
+ * two things that are not obvious:
+ *
+ *   1. WHAT COUNTS AS SET. `0` is the "unset" value of a reference mirror on
+ *      some hosts (`villeEntreeId: 0`), `""` on others, `null` elsewhere. A
+ *      chip that appears for `0` announces a filter nobody chose.
+ *   2. WHAT A REMOVAL MUST CLEAR. Reference criteria are held as PAIRS — a
+ *      scalar mirror for the payload and an object for display
+ *      (`importateurCode` / `importateurId`). Clearing only the displayed key
+ *      removes the chip from the screen while the criterion STAYS IN THE
+ *      PAYLOAD: the worst of both worlds, an invisible filter that still
+ *      filters. Hence `linkedKeys`.
+ *
+ * >>> THIS BUILDER DOES NOT RE-RUN THE SEARCH, and that is deliberate. `onRemove`
+ * >>> hands the host the keys to clear and gives the turn back: only the host
+ * >>> knows whether to clear Formik fields, rebuild its payload and redispatch —
+ * >>> and on server-paginated listings a removal is a REQUEST, not a local
+ * >>> filtering pass. A builder that dispatched would be wrong on every screen
+ * >>> whose payload it cannot know. <<<
+ * ─────────────────────────────────────────────────────────────────────────────
+ *
+ * Promoted from `refonte-frontend` (Area 5), where it served ten listings.
+ * Pair it with `useAppliedFilters`: this builds the chips, that decides which
+ * criteria they may show — chips built from live form values announce a filter
+ * that is being typed and filters nothing.
+ */
+
+/** A filterable criterion, as the screen describes it. */
+
+/** Values that mean "not set" — see point 1 of the note above. */
+function isEmpty(value) {
+  if (value === null || value === undefined || value === "") return true;
+  /* `0` is the "unset" value of reference mirrors on several hosts
+   * (`villeEntreeId: 0`, `importateurId: 0`). A chip for `0` would announce a
+   * criterion nobody chose. */
+  if (value === 0) return true;
+  if (Array.isArray(value) && value.length === 0) return true;
+  return false;
+}
+
+/** Default rendering: a reference object's description, or the value. */
+function formatDefault(value) {
+  if (value !== null && typeof value === "object") {
+    const object = value;
+    const readable = object["description"] ?? object["libelle"] ?? object["label"] ?? object["code"] ?? object["id"];
+    return readable === undefined ? "" : String(readable);
+  }
+  return String(value);
+}
+
+/**
+ * `true` if a criterion is SET — exactly the rule the chips use.
+ *
+ * Exported so a "Filters" button counter can count the same criteria the chips
+ * render. Screens used to count non-empty `formik.values`, which counts every
+ * reference criterion TWICE — the pair again — so picking one category showed
+ * "2 filters".
+ */
+function isCriterionSet(value) {
+  return !isEmpty(value);
+}
+
+/** Every key of every descriptor — for a "clear all". */
+function filterCriteriaKeys(criteria) {
+  return criteria.flatMap(c => [c.key, ...(c.linkedKeys ?? [])]);
+}
+
+/**
+ * Builds the chips of the criteria that are SET.
+ *
+ * @param values   current values of the search form (or the applied snapshot)
+ * @param criteria criteria to watch, in display order
+ * @param onRemove called with every key to clear for that criterion
+ */
+function buildFilterChips(values, criteria, onRemove) {
+  return criteria.filter(criterion => !isEmpty(values[criterion.key])).map(criterion => {
+    const render = criterion.format ?? formatDefault;
+    const value = render(values[criterion.key]);
+    return {
+      key: criterion.key,
+      /* "Label: value" rather than the value alone: "AFFECTE" does not say
+       * WHICH criterion it is when three chips sit side by side. */
+      label: value ? `${criterion.label} : ${value}` : criterion.label,
+      onRemove: () => onRemove([criterion.key, ...(criterion.linkedKeys ?? [])])
+    };
+  });
+}
+//# sourceMappingURL=filterCriteria.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"filterCriteria.js","names":["isEmpty","value","undefined","Array","isArray","length","formatDefault","object","readable","String","isCriterionSet","filterCriteriaKeys","criteria","flatMap","c","key","linkedKeys","buildFilterChips","values","onRemove","filter","criterion","map","render","format","label"],"sources":["../../../src/lib/v2/patterns/filterCriteria.ts"],"sourcesContent":["import type { DataGridToolbarFilterChip } from \"./DataGridToolbar\";\r\n\r\n/**\r\n * filterCriteria — active search criteria as removable chips\r\n * (capability gap G-42).\r\n *\r\n * ─────────────────────────────────────────────────────────────────────────────\r\n * WHY THIS BELONGS IN THE LIBRARY\r\n *\r\n * The library owns HALF of this already, and the half it owns is the rendering:\r\n * `DataGridToolbar.filterChips` draws one removable chip per criterion, and\r\n * `DataGridToolbarFilterChip` describes an entry. That type's own docstring\r\n * records where the request came from — `refonte-frontend`, whose ten listings\r\n * each had to build the array — and that §Filters and §Search make removable\r\n * active criteria a MUST.\r\n *\r\n * What was missing is the BUILDER. Ten local copies would have drifted on the\r\n * two things that are not obvious:\r\n *\r\n *   1. WHAT COUNTS AS SET. `0` is the \"unset\" value of a reference mirror on\r\n *      some hosts (`villeEntreeId: 0`), `\"\"` on others, `null` elsewhere. A\r\n *      chip that appears for `0` announces a filter nobody chose.\r\n *   2. WHAT A REMOVAL MUST CLEAR. Reference criteria are held as PAIRS — a\r\n *      scalar mirror for the payload and an object for display\r\n *      (`importateurCode` / `importateurId`). Clearing only the displayed key\r\n *      removes the chip from the screen while the criterion STAYS IN THE\r\n *      PAYLOAD: the worst of both worlds, an invisible filter that still\r\n *      filters. Hence `linkedKeys`.\r\n *\r\n * >>> THIS BUILDER DOES NOT RE-RUN THE SEARCH, and that is deliberate. `onRemove`\r\n * >>> hands the host the keys to clear and gives the turn back: only the host\r\n * >>> knows whether to clear Formik fields, rebuild its payload and redispatch —\r\n * >>> and on server-paginated listings a removal is a REQUEST, not a local\r\n * >>> filtering pass. A builder that dispatched would be wrong on every screen\r\n * >>> whose payload it cannot know. <<<\r\n * ─────────────────────────────────────────────────────────────────────────────\r\n *\r\n * Promoted from `refonte-frontend` (Area 5), where it served ten listings.\r\n * Pair it with `useAppliedFilters`: this builds the chips, that decides which\r\n * criteria they may show — chips built from live form values announce a filter\r\n * that is being typed and filters nothing.\r\n */\r\n\r\n/** A filterable criterion, as the screen describes it. */\r\nexport interface FilterCriterion {\r\n  /** Form field holding the displayed value. */\r\n  key: string;\r\n  /** Label the user reads on the chip. */\r\n  label: string;\r\n  /**\r\n   * Fields to clear IN ADDITION to `key` — scalar mirrors, ids. See the note\r\n   * on pairs above: omitting them leaves the criterion in the payload.\r\n   */\r\n  linkedKeys?: string[] | undefined;\r\n  /**\r\n   * Renders the value on the chip. Defaults to the description of a reference\r\n   * object, otherwise the value as-is.\r\n   */\r\n  format?: ((value: unknown) => string) | undefined;\r\n}\r\n\r\n/** Values that mean \"not set\" — see point 1 of the note above. */\r\nfunction isEmpty(value: unknown): boolean {\r\n  if (value === null || value === undefined || value === \"\") return true;\r\n  /* `0` is the \"unset\" value of reference mirrors on several hosts\r\n   * (`villeEntreeId: 0`, `importateurId: 0`). A chip for `0` would announce a\r\n   * criterion nobody chose. */\r\n  if (value === 0) return true;\r\n  if (Array.isArray(value) && value.length === 0) return true;\r\n  return false;\r\n}\r\n\r\n/** Default rendering: a reference object's description, or the value. */\r\nfunction formatDefault(value: unknown): string {\r\n  if (value !== null && typeof value === \"object\") {\r\n    const object = value as Record<string, unknown>;\r\n    const readable =\r\n      object[\"description\"] ?? object[\"libelle\"] ?? object[\"label\"] ??\r\n      object[\"code\"] ?? object[\"id\"];\r\n    return readable === undefined ? \"\" : String(readable);\r\n  }\r\n  return String(value);\r\n}\r\n\r\n/**\r\n * `true` if a criterion is SET — exactly the rule the chips use.\r\n *\r\n * Exported so a \"Filters\" button counter can count the same criteria the chips\r\n * render. Screens used to count non-empty `formik.values`, which counts every\r\n * reference criterion TWICE — the pair again — so picking one category showed\r\n * \"2 filters\".\r\n */\r\nexport function isCriterionSet(value: unknown): boolean {\r\n  return !isEmpty(value);\r\n}\r\n\r\n/** Every key of every descriptor — for a \"clear all\". */\r\nexport function filterCriteriaKeys(criteria: readonly FilterCriterion[]): string[] {\r\n  return criteria.flatMap((c) => [c.key, ...(c.linkedKeys ?? [])]);\r\n}\r\n\r\n/**\r\n * Builds the chips of the criteria that are SET.\r\n *\r\n * @param values   current values of the search form (or the applied snapshot)\r\n * @param criteria criteria to watch, in display order\r\n * @param onRemove called with every key to clear for that criterion\r\n */\r\nexport function buildFilterChips(\r\n  values: Record<string, unknown>,\r\n  criteria: readonly FilterCriterion[],\r\n  onRemove: (keys: string[]) => void\r\n): DataGridToolbarFilterChip[] {\r\n  return criteria\r\n    .filter((criterion) => !isEmpty(values[criterion.key]))\r\n    .map((criterion) => {\r\n      const render = criterion.format ?? formatDefault;\r\n      const value = render(values[criterion.key]);\r\n      return {\r\n        key: criterion.key,\r\n        /* \"Label: value\" rather than the value alone: \"AFFECTE\" does not say\r\n         * WHICH criterion it is when three chips sit side by side. */\r\n        label: value ? `${criterion.label} : ${value}` : criterion.label,\r\n        onRemove: () => onRemove([criterion.key, ...(criterion.linkedKeys ?? [])]),\r\n      };\r\n    });\r\n}\r\n"],"mappings":";;;;;;;;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAEA;;AAkBA;AACA,SAASA,OAAOA,CAACC,KAAc,EAAW;EACxC,IAAIA,KAAK,KAAK,IAAI,IAAIA,KAAK,KAAKC,SAAS,IAAID,KAAK,KAAK,EAAE,EAAE,OAAO,IAAI;EACtE;AACF;AACA;EACE,IAAIA,KAAK,KAAK,CAAC,EAAE,OAAO,IAAI;EAC5B,IAAIE,KAAK,CAACC,OAAO,CAACH,KAAK,CAAC,IAAIA,KAAK,CAACI,MAAM,KAAK,CAAC,EAAE,OAAO,IAAI;EAC3D,OAAO,KAAK;AACd;;AAEA;AACA,SAASC,aAAaA,CAACL,KAAc,EAAU;EAC7C,IAAIA,KAAK,KAAK,IAAI,IAAI,OAAOA,KAAK,KAAK,QAAQ,EAAE;IAC/C,MAAMM,MAAM,GAAGN,KAAgC;IAC/C,MAAMO,QAAQ,GACZD,MAAM,CAAC,aAAa,CAAC,IAAIA,MAAM,CAAC,SAAS,CAAC,IAAIA,MAAM,CAAC,OAAO,CAAC,IAC7DA,MAAM,CAAC,MAAM,CAAC,IAAIA,MAAM,CAAC,IAAI,CAAC;IAChC,OAAOC,QAAQ,KAAKN,SAAS,GAAG,EAAE,GAAGO,MAAM,CAACD,QAAQ,CAAC;EACvD;EACA,OAAOC,MAAM,CAACR,KAAK,CAAC;AACtB;;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACO,SAASS,cAAcA,CAACT,KAAc,EAAW;EACtD,OAAO,CAACD,OAAO,CAACC,KAAK,CAAC;AACxB;;AAEA;AACO,SAASU,kBAAkBA,CAACC,QAAoC,EAAY;EACjF,OAAOA,QAAQ,CAACC,OAAO,CAAEC,CAAC,IAAK,CAACA,CAAC,CAACC,GAAG,EAAE,IAAID,CAAC,CAACE,UAAU,IAAI,EAAE,CAAC,CAAC,CAAC;AAClE;;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACO,SAASC,gBAAgBA,CAC9BC,MAA+B,EAC/BN,QAAoC,EACpCO,QAAkC,EACL;EAC7B,OAAOP,QAAQ,CACZQ,MAAM,CAAEC,SAAS,IAAK,CAACrB,OAAO,CAACkB,MAAM,CAACG,SAAS,CAACN,GAAG,CAAC,CAAC,CAAC,CACtDO,GAAG,CAAED,SAAS,IAAK;IAClB,MAAME,MAAM,GAAGF,SAAS,CAACG,MAAM,IAAIlB,aAAa;IAChD,MAAML,KAAK,GAAGsB,MAAM,CAACL,MAAM,CAACG,SAAS,CAACN,GAAG,CAAC,CAAC;IAC3C,OAAO;MACLA,GAAG,EAAEM,SAAS,CAACN,GAAG;MAClB;AACR;MACQU,KAAK,EAAExB,KAAK,GAAG,GAAGoB,SAAS,CAACI,KAAK,MAAMxB,KAAK,EAAE,GAAGoB,SAAS,CAACI,KAAK;MAChEN,QAAQ,EAAEA,CAAA,KAAMA,QAAQ,CAAC,CAACE,SAAS,CAACN,GAAG,EAAE,IAAIM,SAAS,CAACL,UAAU,IAAI,EAAE,CAAC,CAAC;IAC3E,CAAC;EACH,CAAC,CAAC;AACN","ignoreList":[]}