@portnet/ui 6.0.2 → 6.0.3

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

@@ -1,15 +1,3 @@
-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 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; }
 import * as React from "react";
 
 /**
@@ -49,113 +37,104 @@ import * as React from "react";
  */
 
 /** Width delta (px) applied per Arrow key press in keyboard resize. */
-var KEYBOARD_STEP = 16;
-export default 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;
+export default 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;
@@ -164,7 +143,7 @@ export default function useColumnResize(columnWidths, onColumnWidthsChange) {
     };
     window.addEventListener("mousemove", onMove);
     window.addEventListener("mouseup", onUp);
-    return function () {
+    return () => {
       window.removeEventListener("mousemove", onMove);
       window.removeEventListener("mouseup", onUp);
     };
@@ -176,16 +155,19 @@ export default 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/esm/v2/patterns/_useColumnResize.js.map

@@ -1 +1 @@
-{"version":3,"file":"_useColumnResize.js","names":["React","KEYBOARD_STEP","useColumnResize","columnWidths","onColumnWidthsChange","_options$minWidth","options","arguments","length","undefined","minWidth","_React$useState","useState","_React$useState2","_slicedToArray","draggingKey","setDraggingKey","_React$useState3","_React$useState4","liveWidth","setLiveWidth","liveWidthRef","useRef","dragStateRef","columnWidthsRef","useEffect","current","cellDirection","grip","cell","closest","window","getComputedStyle","direction","handleMouseDown","useCallback","key","e","_ref","preventDefault","stopPropagation","currentTarget","currentWidth","offsetWidth","x","clientX","width","handleKeyDown","_ref2","isLeft","isRight","isHome","next","clamped","Math","max","round","_objectSpread","_defineProperty","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","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","e","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/esm/v2/patterns/filterCriteria.js

@@ -0,0 +1,102 @@
+/**
+ * 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".
+ */
+export function isCriterionSet(value) {
+  return !isEmpty(value);
+}
+
+/** Every key of every descriptor — for a "clear all". */
+export 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
+ */
+export 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/esm/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;AACA,OAAO,SAASS,cAAcA,CAACT,KAAc,EAAW;EACtD,OAAO,CAACD,OAAO,CAACC,KAAK,CAAC;AACxB;;AAEA;AACA,OAAO,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;AACA,OAAO,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":[]}

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

@@ -1,5 +1,38 @@
 export { default as ActionBar } from "./ActionBar";
+/**
+ * AppMain — the `<main>` landmark (gap G-53).
+ *
+ * The library shipped HALF of a two-part contract: `SkipLink`'s docblock
+ * prescribes `<main id="main-content">` as its target and the library never
+ * provided it, so every module wrote the landmark — with `tabIndex={-1}`
+ * (without which the skip link scrolls but does not move focus in Safari),
+ * `outline: none` (R-F.1: the ring belongs on controls, not on a whole page),
+ * and the content measure of R-L.5, a MUST nothing here honoured:
+ * `PageContent` owns the canonical padding and caps NOTHING, so a certified
+ * module still stretched its tables across a 1920 px display.
+ *
+ * Two copies existed in the portfolio (autorisation-admis-pour-conforme-fe and
+ * the reference module ms-ti-fe), which is what a gap looks like from the
+ * outside.
+ */
+export { default as AppMain } from "./AppMain";
 export { default as BulkActionBar } from "./BulkActionBar";
+/**
+ * ChartFigure — a chart, its title, and its TEXT EQUIVALENT (gap G-55).
+ *
+ * `tokens/chart` states the obligation and shipped nothing to meet it, in its
+ * own words: the palette "does not make a chart accessible. Every consumer
+ * still owes a legend with text labels, and a text equivalent of the data —
+ * 1.1.1 for the chart as a whole." A rule stated without a component to carry
+ * it is met by whoever remembers it, and the text equivalent is the part that
+ * goes missing first — the only one nobody SEES missing.
+ *
+ * Hence `caption` being REQUIRED: a chart rendered through here cannot ship
+ * without its numbers in text. The canvas is `aria-hidden` (a renderer emits
+ * dozens of unstructured SVG text nodes, which is noise worse than silence) —
+ * so no interactive control goes inside it.
+ */
+export { default as ChartFigure } from "./ChartFigure";
 export { default as ColumnsToggle } from "./ColumnsToggle";
 export { default as FormSection } from "./FormSection";
 export { default as FormPageShell } from "./FormPageShell";
@@ -7,11 +40,130 @@ export { default as FormErrorSummary } from "./FormErrorSummary";
 // R-FV.3 companion to FormErrorSummary (R-FV.2) — renders nothing, moves
 // focus to the first field in error after a failed submit. Adopt both.
 export { default as FormikErrorFocus } from "./FormikErrorFocus";
+/**
+ * FormikErrorSummary — the Formik bridge for FormErrorSummary (R-FV.2).
+ *
+ * The library owned all three parts of the failed-submit recipe and no way to
+ * assemble them inside the form shape modules actually write:
+ * `FormErrorSummary` renders the banner from a flat list,
+ * `flattenFormikErrors` (G-38) produces that list, `focusFieldByName`
+ * (R-FV.3) resolves an item back to its control.
+ *
+ * Reaching `errors` / `submitCount` needs the Formik CONTEXT, and the
+ * prevailing shape is `<Formik><Form>…</Form></Formik>` with STATIC children —
+ * the host's body sits outside the provider, and `innerRef` does not help
+ * because mutating a ref does not re-render the holder when `errors` changes.
+ * So each host had to convert its form to a render-prop purely to reach the
+ * errors, or write a local null-rendering context reader.
+ *
+ * Raised from ms-ti-fe (Area 11), where ONE of eleven Formik forms had the
+ * banner: wiring the other ten meant ten copies of that wrapper. The sibling
+ * rule HAS a bridge (`FormikErrorFocus`), which is why field adoption of the
+ * two MUSTs diverged — the one needing boilerplate is the one nobody applied.
+ */
+export { default as FormikErrorSummary } from "./FormikErrorSummary";
 export { default as PageContent } from "./PageContent";
+/**
+ * DetailSplit — content + progression rail on a consultation page (gap G-44).
+ *
+ * §Detail / Consultation Pattern makes the vertical progress rail a MUST on
+ * every consultation page, and §07 R-L.7 fixes the skeleton. The library shipped
+ * the rail (`VStepper`) and not the geometry that places it beside the record,
+ * so each host wrote the same three-value flex row by hand.
+ *
+ * Promoted from `refonte-frontend` (Area 4), where the SAME row existed twice
+ * — `DetailPage` and `TraitementDemande` — with `560` / `300` / `260` written
+ * out in both (R-2.3), and already drifting: neither `<aside>` had an
+ * accessible name. Widths now live in `tokens.layout.detail`.
+ */
+export { default as DetailSplit } from "./DetailSplit";
+/**
+ * PreviewDrawer — the listing preview, body included (gap G-40).
+ *
+ * §Row Interaction and §Preview Drawer are MUST on every listing page of the
+ * platform, and the library shipped only `Drawer`, the empty shell. Each module
+ * assembled the same summary by hand, and the copies drifted where it shows
+ * least: `ms-ti-fe` uses `KVGrid` + `KV`, `refonte-frontend` had built a local
+ * `<dl>` with its own grid — one concept, two renderings (R-2.1).
+ *
+ * Promoted from `refonte-frontend` (Area 5). Reads NO field of `row`, which is
+ * what removed the `as unknown as` assertion its single-component ancestor
+ * needed; business defaults live in a host wrapper over a concrete row type.
+ */
+export { default as PreviewDrawer } from "./PreviewDrawer";
 export { default as DataGrid, applySort } from "./DataGrid";
+/**
+ * DataGridVirtualized — la seconde table, pour les grands volumes.
+ *
+ * Sa frontière d'emploi est énoncée dans son propre en-tête : au-delà de mille
+ * lignes où la pagination paraîtrait artificielle (journaux d'audit, « tout
+ * afficher ») ; sous cent lignes, `DataGrid` est plus simple.
+ *
+ * >>> LES TYPES SONT AJOUTÉS ICI (audit lot 12, Area 13) — MÊME CLASSE
+ * >>> GAP-TS-003 QUE CE FICHIER DOCUMENTE DÉJÀ CINQ FOIS. La VALEUR était
+ * >>> exportée, les types décrivant ses props ne l'étaient pas : un hôte ne
+ * >>> pouvait donc ni écrire un adaptateur typé autour de ce composant, ni
+ * >>> nommer `DataGridVirtualizedDensity` — dont il a besoin, puisque ce
+ * >>> palier de HAUTEUR DE LIGNE compte quatre valeurs là où le `Density`
+ * >>> canonique en a deux. Le repli aurait été un jumeau local, que les
+ * >>> Platform TypeScript Guidelines interdisent.
+ * >>>
+ * >>> Relevé depuis `autorisation-admis-pour-conforme-fe` (Area 13) : ce
+ * >>> module n'utilise pas ce composant — il pagine côté serveur — mais son
+ * >>> audit RGESN a dû établir où vivait la virtualisation, et a trouvé une
+ * >>> capacité complète dont la surface type était muette.
+ * >>>
+ * >>> Additif et purement typographique : aucun changement d'exécution. <<<
+ */
 export { default as DataGridVirtualized } from "./DataGridVirtualized";
 export { default as DataGridSettingsMenu } from "./DataGridSettingsMenu";
 export { default as DataGridToolbar } from "./DataGridToolbar";
+/**
+ * rowActions — business descriptors → the row's kebab menu (gap G-41).
+ *
+ * The library shipped both halves — `OverflowMenu` renders flat actions,
+ * `DataGrid.rowActions` takes a `(row) => ReactNode` — and not the step
+ * between them, which every listing wrote for itself while carrying three
+ * Charter rules (R-3.3, R-B.6, R-K.1).
+ *
+ * `buildRowActionMenu` is exported alongside the renderer on purpose: a row
+ * appears twice, as a table row and as a `MobileRowCard` whose `actions` prop
+ * takes `OverflowMenuAction[]` rather than a node. Without it, hosts rebuilt
+ * the menu by hand for the card and the two copies drifted — the same failure
+ * the library records for `RowFavoriteToggle` (G-36).
+ *
+ * Promoted from `refonte-frontend` (Area 5), where it served twelve screens.
+ */
+export { buildRowActions, buildRowActionMenu, MAX_ROW_ACTIONS } from "./rowActions";
+/**
+ * FilterTabBar — the status-chip bar of a listing card (gap G-45).
+ *
+ * §Status Chips is a MUST on every listing, and the library shipped the PILL
+ * (`FilterTab`) without the bar that seats it — so each listing re-derived the
+ * row geometry, the card-header separator, and the split between the status
+ * group and the personalization controls.
+ *
+ * Promoted from `refonte-frontend` (Area 5), where FOUR listings carried the
+ * same `BARRE_CHIPS_STATUT` + `GROUPE_BARRE` pair — and had already drifted:
+ * one of the four omitted `justifyContent: "space-between"`, so the same
+ * listing family rendered two different layouts (R-2.1).
+ */
+export { default as FilterTabBar } from "./FilterTabBar";
+/**
+ * filterCriteria — active criteria as removable chips (gap G-42).
+ *
+ * The library owned the RENDERING (`DataGridToolbar.filterChips` and the
+ * `DataGridToolbarFilterChip` type, itself added at this module's request) and
+ * not the builder. Ten local copies would have drifted on the two things that
+ * are not obvious: what counts as SET (`0` is the unset value of a reference
+ * mirror on several hosts) and what a removal must CLEAR (reference criteria
+ * are held as pairs, so clearing only the displayed key leaves an invisible
+ * filter that still filters).
+ *
+ * Pair with `useAppliedFilters`. Promoted from `refonte-frontend` (Area 5).
+ */
+export { buildFilterChips, filterCriteriaKeys, isCriterionSet } from "./filterCriteria";
+
 /**
  * DataGridToolbar contracts — public typed surface (gap G-I).
  *