@portnet/ui 5.0.28 → 6.0.0

package/dist/v2/hooks/useFormAutoSave.js

@@ -0,0 +1,186 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports["default"] = useFormAutoSave;
+var _react = require("react");
+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 _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; }
+/**
+ * useFormAutoSave — persist Formik (or any form) values to
+ * localStorage with debounced writes, and expose draft-restore
+ * affordances to the host. Pure orchestration; no UI.
+ *
+ * Usage:
+ *   import { v2 } from "@portnet/ui";
+ *   const { useFormAutoSave, Banner } = v2;
+ *
+ *   const { hasDraft, lastSavedAt, restoreDraft, clearDraft } =
+ *     useFormAutoSave({
+ *       storageKey: `addpe:autorisation:draft:${id || "new"}`,
+ *       values: formik.values,
+ *       setValues: formik.setValues,
+ *       enabled: !id, // CREATE only, not edit
+ *     });
+ *
+ * Safety:
+ *   - All localStorage access is try/catch-wrapped.
+ *   - Empty-state values are skipped so we don't produce noise entries.
+ *   - When a draft exists but hasn't been actioned (hasDraft=true),
+ *     the debounced write is PAUSED to prevent overwriting the draft
+ *     with empty initial values before the user decides to restore/ignore.
+ */
+
+function useFormAutoSave(_ref) {
+  var storageKey = _ref.storageKey,
+    values = _ref.values,
+    setValues = _ref.setValues,
+    _ref$enabled = _ref.enabled,
+    enabled = _ref$enabled === void 0 ? true : _ref$enabled,
+    _ref$debounceMs = _ref.debounceMs,
+    debounceMs = _ref$debounceMs === void 0 ? 800 : _ref$debounceMs,
+    _ref$initialEmptyChec = _ref.initialEmptyCheck,
+    initialEmptyCheck = _ref$initialEmptyChec === void 0 ? defaultEmptyCheck : _ref$initialEmptyChec;
+  var _useState = (0, _react.useState)(false),
+    _useState2 = _slicedToArray(_useState, 2),
+    hasDraft = _useState2[0],
+    setHasDraft = _useState2[1];
+  var _useState3 = (0, _react.useState)(null),
+    _useState4 = _slicedToArray(_useState3, 2),
+    lastSavedAt = _useState4[0],
+    setLastSavedAt = _useState4[1];
+  var debounceTimerRef = (0, _react.useRef)(null);
+  var mountedRef = (0, _react.useRef)(false);
+
+  /* ── Mount-time draft detection ────────────────── */
+  (0, _react.useEffect)(function () {
+    if (!enabled) return;
+    if (mountedRef.current) return;
+    mountedRef.current = true;
+    try {
+      var raw = localStorage.getItem(storageKey);
+      if (!raw) return;
+      var parsed = JSON.parse(raw);
+      if (parsed && _typeof(parsed) === "object" && "values" in parsed && parsed.values && _typeof(parsed.values) === "object") {
+        setHasDraft(true);
+        if ("savedAt" in parsed && typeof parsed.savedAt === "string") {
+          var d = new Date(parsed.savedAt);
+          if (!Number.isNaN(d.getTime())) setLastSavedAt(d);
+        }
+      } else {
+        localStorage.removeItem(storageKey);
+      }
+    } catch (_unused) {
+      try {
+        localStorage.removeItem(storageKey);
+      } catch (_unused2) {
+        /* ignore */
+      }
+    }
+  }, [enabled, storageKey]);
+
+  /* ── Debounced write on values change ──────────────────
+   *
+   * CRITICAL: do NOT write while hasDraft=true (draft not yet actioned).
+   *
+   * If we write immediately on mount, the empty initial values would
+   * overwrite the user's saved draft after `debounceMs` milliseconds.
+   * The user would see the "restore" banner, wait/hesitate, then click
+   * "Restaurer" only to find the form empty because restoreDraft() read
+   * the overwritten (empty) localStorage entry.
+   *
+   * We pause writes until hasDraft becomes false, which happens when:
+   *   - restoreDraft() is called (user chose to restore)
+   *   - clearDraft()   is called (user chose to ignore)
+   *   - No draft existed on mount (hasDraft was never set to true)
+   */
+  (0, _react.useEffect)(function () {
+    if (!enabled) return undefined;
+    if (hasDraft) return undefined; // ← PAUSE: preserve existing draft
+    if (initialEmptyCheck(values)) return undefined;
+    if (debounceTimerRef.current) {
+      clearTimeout(debounceTimerRef.current);
+    }
+    debounceTimerRef.current = setTimeout(function () {
+      try {
+        var now = new Date();
+        localStorage.setItem(storageKey, JSON.stringify({
+          values: values,
+          savedAt: now.toISOString()
+        }));
+        setLastSavedAt(now);
+      } catch (_unused3) {
+        // Quota full / private mode — no-op.
+      }
+    }, debounceMs);
+    return function () {
+      if (debounceTimerRef.current) {
+        clearTimeout(debounceTimerRef.current);
+      }
+    };
+  }, [values, enabled, hasDraft, storageKey, debounceMs, initialEmptyCheck]);
+
+  /* ── Restore draft ─────────────────────── */
+  var restoreDraft = (0, _react.useCallback)(function () {
+    if (!setValues) {
+      if (process.env["NODE_ENV"] !== "production") {
+        // eslint-disable-next-line no-console
+        console.warn("[v2.useFormAutoSave] restoreDraft called but setValues was not provided.");
+      }
+      return false;
+    }
+    try {
+      var raw = localStorage.getItem(storageKey);
+      if (!raw) return false;
+      var parsed = JSON.parse(raw);
+      if (!parsed || _typeof(parsed) !== "object" || !("values" in parsed) || !parsed.values) {
+        return false;
+      }
+      // Persisted draft payload is the form's Values, round-tripped
+      // through JSON; assert back to Values for the setter.
+      setValues(parsed.values);
+      setHasDraft(false); // ← resumes auto-save with restored values
+      return true;
+    } catch (_unused4) {
+      return false;
+    }
+  }, [storageKey, setValues]);
+
+  /* ── Clear draft ─────────────────────── */
+  var clearDraft = (0, _react.useCallback)(function () {
+    try {
+      localStorage.removeItem(storageKey);
+    } catch (_unused5) {
+      /* ignore */
+    }
+    setHasDraft(false); // ← resumes auto-save for new input
+    setLastSavedAt(null);
+  }, [storageKey]);
+  return {
+    hasDraft: hasDraft,
+    lastSavedAt: lastSavedAt,
+    restoreDraft: restoreDraft,
+    clearDraft: clearDraft
+  };
+}
+
+/* ── Helpers ───────────────────────────── */
+
+function isEmptyValue(v) {
+  if (v === null || v === undefined) return true;
+  if (typeof v === "string") return v.trim().length === 0;
+  if (Array.isArray(v)) return v.length === 0;
+  if (_typeof(v) === "object") return Object.keys(v).length === 0;
+  return false;
+}
+function defaultEmptyCheck(values) {
+  if (!values || _typeof(values) !== "object") return true;
+  return Object.values(values).every(isEmptyValue);
+}
+//# sourceMappingURL=useFormAutoSave.js.map

package/dist/v2/hooks/useFormAutoSave.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useFormAutoSave.js","names":["_react","require","_typeof","obj","Symbol","iterator","constructor","prototype","_slicedToArray","arr","i","_arrayWithHoles","_iterableToArrayLimit","_unsupportedIterableToArray","_nonIterableRest","TypeError","o","minLen","_arrayLikeToArray","n","Object","toString","call","slice","name","Array","from","test","len","length","arr2","_i","_s","_e","_x","_r","_arr","_n","_d","next","done","push","value","err","isArray","useFormAutoSave","_ref","storageKey","values","setValues","_ref$enabled","enabled","_ref$debounceMs","debounceMs","_ref$initialEmptyChec","initialEmptyCheck","defaultEmptyCheck","_useState","useState","_useState2","hasDraft","setHasDraft","_useState3","_useState4","lastSavedAt","setLastSavedAt","debounceTimerRef","useRef","mountedRef","useEffect","current","raw","localStorage","getItem","parsed","JSON","parse","savedAt","d","Date","Number","isNaN","getTime","removeItem","_unused","_unused2","undefined","clearTimeout","setTimeout","now","setItem","stringify","toISOString","_unused3","restoreDraft","useCallback","process","env","console","warn","_unused4","clearDraft","_unused5","isEmptyValue","v","trim","keys","every"],"sources":["../../../src/lib/v2/hooks/useFormAutoSave.ts"],"sourcesContent":["import { useCallback, useEffect, useRef, useState } from \"react\";\r\n\r\n/**\r\n * useFormAutoSave — persist Formik (or any form) values to\r\n * localStorage with debounced writes, and expose draft-restore\r\n * affordances to the host. Pure orchestration; no UI.\r\n *\r\n * Usage:\r\n *   import { v2 } from \"@portnet/ui\";\r\n *   const { useFormAutoSave, Banner } = v2;\r\n *\r\n *   const { hasDraft, lastSavedAt, restoreDraft, clearDraft } =\r\n *     useFormAutoSave({\r\n *       storageKey: `addpe:autorisation:draft:${id || \"new\"}`,\r\n *       values: formik.values,\r\n *       setValues: formik.setValues,\r\n *       enabled: !id, // CREATE only, not edit\r\n *     });\r\n *\r\n * Safety:\r\n *   - All localStorage access is try/catch-wrapped.\r\n *   - Empty-state values are skipped so we don't produce noise entries.\r\n *   - When a draft exists but hasn't been actioned (hasDraft=true),\r\n *     the debounced write is PAUSED to prevent overwriting the draft\r\n *     with empty initial values before the user decides to restore/ignore.\r\n */\r\n\r\ntype FormAutoSaveOptions<Values> = {\r\n  storageKey: string;\r\n  values: Values;\r\n  /** Required if you call restoreDraft(). */\r\n  setValues?: (values: Values) => void;\r\n  enabled?: boolean;\r\n  debounceMs?: number;\r\n  initialEmptyCheck?: (values: Values) => boolean;\r\n};\r\n\r\ntype FormAutoSaveResult = {\r\n  hasDraft: boolean;\r\n  lastSavedAt: Date | null;\r\n  restoreDraft: () => boolean;\r\n  clearDraft: () => void;\r\n};\r\n\r\nexport default function useFormAutoSave<Values>({\r\n  storageKey,\r\n  values,\r\n  setValues,\r\n  enabled = true,\r\n  debounceMs = 800,\r\n  initialEmptyCheck = defaultEmptyCheck,\r\n}: FormAutoSaveOptions<Values>): FormAutoSaveResult {\r\n  const [hasDraft, setHasDraft] = useState(false);\r\n  const [lastSavedAt, setLastSavedAt] = useState<Date | null>(null);\r\n  const debounceTimerRef = useRef<ReturnType<typeof setTimeout> | null>(null);\r\n  const mountedRef = useRef(false);\r\n\r\n  /* ── Mount-time draft detection ────────────────── */\r\n  useEffect(() => {\r\n    if (!enabled) return;\r\n    if (mountedRef.current) return;\r\n    mountedRef.current = true;\r\n\r\n    try {\r\n      const raw = localStorage.getItem(storageKey);\r\n      if (!raw) return;\r\n      const parsed: unknown = JSON.parse(raw);\r\n      if (\r\n        parsed &&\r\n        typeof parsed === \"object\" &&\r\n        \"values\" in parsed &&\r\n        parsed.values &&\r\n        typeof parsed.values === \"object\"\r\n      ) {\r\n        setHasDraft(true);\r\n        if (\"savedAt\" in parsed && typeof parsed.savedAt === \"string\") {\r\n          const d = new Date(parsed.savedAt);\r\n          if (!Number.isNaN(d.getTime())) setLastSavedAt(d);\r\n        }\r\n      } else {\r\n        localStorage.removeItem(storageKey);\r\n      }\r\n    } catch {\r\n      try {\r\n        localStorage.removeItem(storageKey);\r\n      } catch {\r\n        /* ignore */\r\n      }\r\n    }\r\n  }, [enabled, storageKey]);\r\n\r\n  /* ── Debounced write on values change ──────────────────\r\n   *\r\n   * CRITICAL: do NOT write while hasDraft=true (draft not yet actioned).\r\n   *\r\n   * If we write immediately on mount, the empty initial values would\r\n   * overwrite the user's saved draft after `debounceMs` milliseconds.\r\n   * The user would see the \"restore\" banner, wait/hesitate, then click\r\n   * \"Restaurer\" only to find the form empty because restoreDraft() read\r\n   * the overwritten (empty) localStorage entry.\r\n   *\r\n   * We pause writes until hasDraft becomes false, which happens when:\r\n   *   - restoreDraft() is called (user chose to restore)\r\n   *   - clearDraft()   is called (user chose to ignore)\r\n   *   - No draft existed on mount (hasDraft was never set to true)\r\n   */\r\n  useEffect(() => {\r\n    if (!enabled) return undefined;\r\n    if (hasDraft) return undefined;           // ← PAUSE: preserve existing draft\r\n    if (initialEmptyCheck(values)) return undefined;\r\n\r\n    if (debounceTimerRef.current) {\r\n      clearTimeout(debounceTimerRef.current);\r\n    }\r\n\r\n    debounceTimerRef.current = setTimeout(() => {\r\n      try {\r\n        const now = new Date();\r\n        localStorage.setItem(\r\n          storageKey,\r\n          JSON.stringify({ values, savedAt: now.toISOString() })\r\n        );\r\n        setLastSavedAt(now);\r\n      } catch {\r\n        // Quota full / private mode — no-op.\r\n      }\r\n    }, debounceMs);\r\n\r\n    return () => {\r\n      if (debounceTimerRef.current) {\r\n        clearTimeout(debounceTimerRef.current);\r\n      }\r\n    };\r\n  }, [values, enabled, hasDraft, storageKey, debounceMs, initialEmptyCheck]);\r\n\r\n  /* ── Restore draft ─────────────────────── */\r\n  const restoreDraft = useCallback((): boolean => {\r\n    if (!setValues) {\r\n      if (process.env[\"NODE_ENV\"] !== \"production\") {\r\n        // eslint-disable-next-line no-console\r\n        console.warn(\"[v2.useFormAutoSave] restoreDraft called but setValues was not provided.\");\r\n      }\r\n      return false;\r\n    }\r\n    try {\r\n      const raw = localStorage.getItem(storageKey);\r\n      if (!raw) return false;\r\n      const parsed: unknown = JSON.parse(raw);\r\n      if (\r\n        !parsed ||\r\n        typeof parsed !== \"object\" ||\r\n        !(\"values\" in parsed) ||\r\n        !parsed.values\r\n      ) {\r\n        return false;\r\n      }\r\n      // Persisted draft payload is the form's Values, round-tripped\r\n      // through JSON; assert back to Values for the setter.\r\n      setValues(parsed.values as Values);\r\n      setHasDraft(false);  // ← resumes auto-save with restored values\r\n      return true;\r\n    } catch {\r\n      return false;\r\n    }\r\n  }, [storageKey, setValues]);\r\n\r\n  /* ── Clear draft ─────────────────────── */\r\n  const clearDraft = useCallback((): void => {\r\n    try {\r\n      localStorage.removeItem(storageKey);\r\n    } catch {\r\n      /* ignore */\r\n    }\r\n    setHasDraft(false);    // ← resumes auto-save for new input\r\n    setLastSavedAt(null);\r\n  }, [storageKey]);\r\n\r\n  return { hasDraft, lastSavedAt, restoreDraft, clearDraft };\r\n}\r\n\r\n/* ── Helpers ───────────────────────────── */\r\n\r\nfunction isEmptyValue(v: unknown): boolean {\r\n  if (v === null || v === undefined) return true;\r\n  if (typeof v === \"string\") return v.trim().length === 0;\r\n  if (Array.isArray(v)) return v.length === 0;\r\n  if (typeof v === \"object\") return Object.keys(v).length === 0;\r\n  return false;\r\n}\r\n\r\nfunction defaultEmptyCheck(values: unknown): boolean {\r\n  if (!values || typeof values !== \"object\") return true;\r\n  return Object.values(values).every(isEmptyValue);\r\n}\r\n"],"mappings":"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","ignoreList":[]}

package/dist/v2/hooks/useFormCompletionProgress.d.ts

@@ -0,0 +1,52 @@
+/**
+ * useFormCompletionProgress — derive required/overall completion
+ * percentages from current form values and a declared field list.
+ * Pure useMemo computation, no side effects.
+ *
+ * Usage:
+ *   import { v2 } from "@portnet/ui";
+ *   const { useFormCompletionProgress, ProgressBar } = v2;
+ *
+ *   const REQUIRED = ["typeAutorisation", "importer.id", "dateFinValidite"];
+ *   const OPTIONAL = ["referenceLicence", "region"];
+ *
+ *   const {
+ *     requiredPct,
+ *     overallPct,
+ *     isCompleteRequired,
+ *     missingRequired,
+ *     filledRequired,
+ *     totalRequired,
+ *   } = useFormCompletionProgress({
+ *     values: formik.values,
+ *     requiredFields: REQUIRED,
+ *     optionalFields: OPTIONAL,
+ *   });
+ *
+ *   <ProgressBar value={requiredPct} />
+ *   <span>{filledRequired}/{totalRequired} requis</span>
+ *
+ * Field paths support dot notation for nested values:
+ *   "importer.id"   → values.importer.id
+ *   "articles"      → values.articles (array length checked)
+ */
+type FormCompletionProgressOptions<Values> = {
+    values: Values;
+    /** Field keys / dot-paths that are required. */
+    requiredFields: string[];
+    /** Field keys / dot-paths that are optional. */
+    optionalFields?: string[];
+};
+type FormCompletionProgress = {
+    requiredPct: number;
+    overallPct: number;
+    filledRequired: number;
+    totalRequired: number;
+    filledOptional: number;
+    totalOptional: number;
+    isCompleteRequired: boolean;
+    missingRequired: string[];
+};
+export default function useFormCompletionProgress<Values>({ values, requiredFields, optionalFields, }: FormCompletionProgressOptions<Values>): FormCompletionProgress;
+export {};
+//# sourceMappingURL=useFormCompletionProgress.d.ts.map

package/dist/v2/hooks/useFormCompletionProgress.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useFormCompletionProgress.d.ts","sourceRoot":"","sources":["../../../src/lib/v2/hooks/useFormCompletionProgress.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AAEH,KAAK,6BAA6B,CAAC,MAAM,IAAI;IAC3C,MAAM,EAAE,MAAM,CAAC;IACf,gDAAgD;IAChD,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,gDAAgD;IAChD,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;CAC3B,CAAC;AAEF,KAAK,sBAAsB,GAAG;IAC5B,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,cAAc,EAAE,MAAM,CAAC;IACvB,aAAa,EAAE,MAAM,CAAC;IACtB,cAAc,EAAE,MAAM,CAAC;IACvB,aAAa,EAAE,MAAM,CAAC;IACtB,kBAAkB,EAAE,OAAO,CAAC;IAC5B,eAAe,EAAE,MAAM,EAAE,CAAC;CAC3B,CAAC;AAEF,MAAM,CAAC,OAAO,UAAU,yBAAyB,CAAC,MAAM,EAAE,EACxD,MAAM,EACN,cAAc,EACd,cAAmB,GACpB,EAAE,6BAA6B,CAAC,MAAM,CAAC,GAAG,sBAAsB,CAwChE"}

package/dist/v2/hooks/useFormCompletionProgress.js

@@ -0,0 +1,136 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports["default"] = useFormCompletionProgress;
+var _react = require("react");
+function _createForOfIteratorHelper(o, allowArrayLike) { var it = typeof Symbol !== "undefined" && o[Symbol.iterator] || o["@@iterator"]; if (!it) { if (Array.isArray(o) || (it = _unsupportedIterableToArray(o)) || allowArrayLike && o && typeof o.length === "number") { if (it) o = it; var i = 0; var F = function F() {}; return { s: F, n: function n() { if (i >= o.length) return { done: true }; return { done: false, value: o[i++] }; }, e: function e(_e) { throw _e; }, f: F }; } throw new TypeError("Invalid attempt to iterate non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method."); } var normalCompletion = true, didErr = false, err; return { s: function s() { it = it.call(o); }, n: function n() { var step = it.next(); normalCompletion = step.done; return step; }, e: function e(_e2) { didErr = true; err = _e2; }, f: function f() { try { if (!normalCompletion && it["return"] != null) it["return"](); } finally { if (didErr) throw err; } } }; }
+function _unsupportedIterableToArray(o, minLen) { if (!o) return; if (typeof o === "string") return _arrayLikeToArray(o, minLen); var n = Object.prototype.toString.call(o).slice(8, -1); if (n === "Object" && o.constructor) n = o.constructor.name; if (n === "Map" || n === "Set") return Array.from(o); if (n === "Arguments" || /^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(n)) return _arrayLikeToArray(o, minLen); }
+function _arrayLikeToArray(arr, len) { if (len == null || len > arr.length) len = arr.length; for (var i = 0, arr2 = new Array(len); i < len; i++) { arr2[i] = arr[i]; } return arr2; }
+function _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); }
+/**
+ * useFormCompletionProgress — derive required/overall completion
+ * percentages from current form values and a declared field list.
+ * Pure useMemo computation, no side effects.
+ *
+ * Usage:
+ *   import { v2 } from "@portnet/ui";
+ *   const { useFormCompletionProgress, ProgressBar } = v2;
+ *
+ *   const REQUIRED = ["typeAutorisation", "importer.id", "dateFinValidite"];
+ *   const OPTIONAL = ["referenceLicence", "region"];
+ *
+ *   const {
+ *     requiredPct,
+ *     overallPct,
+ *     isCompleteRequired,
+ *     missingRequired,
+ *     filledRequired,
+ *     totalRequired,
+ *   } = useFormCompletionProgress({
+ *     values: formik.values,
+ *     requiredFields: REQUIRED,
+ *     optionalFields: OPTIONAL,
+ *   });
+ *
+ *   <ProgressBar value={requiredPct} />
+ *   <span>{filledRequired}/{totalRequired} requis</span>
+ *
+ * Field paths support dot notation for nested values:
+ *   "importer.id"   → values.importer.id
+ *   "articles"      → values.articles (array length checked)
+ */
+
+function useFormCompletionProgress(_ref) {
+  var values = _ref.values,
+    requiredFields = _ref.requiredFields,
+    _ref$optionalFields = _ref.optionalFields,
+    optionalFields = _ref$optionalFields === void 0 ? [] : _ref$optionalFields;
+  return (0, _react.useMemo)(function () {
+    var required = Array.isArray(requiredFields) ? requiredFields : [];
+    var optional = Array.isArray(optionalFields) ? optionalFields : [];
+    var filledRequired = required.filter(function (path) {
+      return isFilled(getFieldValue(values, path));
+    }).length;
+    var filledOptional = optional.filter(function (path) {
+      return isFilled(getFieldValue(values, path));
+    }).length;
+    var missingRequired = required.filter(function (path) {
+      return !isFilled(getFieldValue(values, path));
+    });
+    var totalRequired = required.length;
+    var totalOptional = optional.length;
+    var requiredPct = totalRequired ? Math.round(filledRequired / totalRequired * 100) : 100;
+    var overallFilled = filledRequired + filledOptional;
+    var overallTotal = totalRequired + totalOptional;
+    var overallPct = overallTotal ? Math.round(overallFilled / overallTotal * 100) : 0;
+    return {
+      requiredPct: requiredPct,
+      overallPct: overallPct,
+      filledRequired: filledRequired,
+      totalRequired: totalRequired,
+      filledOptional: filledOptional,
+      totalOptional: totalOptional,
+      isCompleteRequired: totalRequired === 0 || filledRequired === totalRequired,
+      missingRequired: missingRequired
+    };
+  }, [values, requiredFields, optionalFields]);
+}
+
+/* ── Helpers ───────────────────────────── */
+
+/**
+ * Resolves a dot-separated field path against a values object.
+ * Returns undefined on any missing intermediate.
+ *
+ *   getFieldValue({ a: { b: { c: 42 } } }, "a.b.c")    → 42
+ *   getFieldValue({ a: null }, "a.b.c")                → undefined
+ *   getFieldValue({}, "doesNotExist")                  → undefined
+ */
+function getFieldValue(obj, path) {
+  if (!obj || _typeof(obj) !== "object") return undefined;
+  if (!path) return undefined;
+  var parts = path.split(".");
+  var cur = obj;
+  var _iterator = _createForOfIteratorHelper(parts),
+    _step;
+  try {
+    for (_iterator.s(); !(_step = _iterator.n()).done;) {
+      var p = _step.value;
+      if (cur === null || cur === undefined) return undefined;
+      if (_typeof(cur) !== "object") return undefined;
+      cur = cur[p];
+    }
+  } catch (err) {
+    _iterator.e(err);
+  } finally {
+    _iterator.f();
+  }
+  return cur;
+}
+
+/**
+ * Centralised "is this value considered filled?" check.
+ *
+ * Considered EMPTY:
+ *   - null, undefined
+ *   - "" or whitespace-only string
+ *   - empty array []
+ *   - empty plain object {}
+ *
+ * Considered FILLED (intentional):
+ *   - 0, false (valid user input distinct from "unset")
+ *   - any non-empty array, object with keys, string, number
+ *   - Date instances with valid time
+ */
+function isFilled(v) {
+  if (v === null || v === undefined) return false;
+  if (typeof v === "string") return v.trim().length > 0;
+  if (Array.isArray(v)) return v.length > 0;
+  if (v instanceof Date) return !Number.isNaN(v.getTime());
+  if (_typeof(v) === "object") return Object.keys(v).length > 0;
+  // numbers, booleans
+  return true;
+}
+//# sourceMappingURL=useFormCompletionProgress.js.map

package/dist/v2/hooks/useFormCompletionProgress.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useFormCompletionProgress.js","names":["_react","require","_createForOfIteratorHelper","o","allowArrayLike","it","Symbol","iterator","Array","isArray","_unsupportedIterableToArray","length","i","F","s","n","done","value","e","_e","f","TypeError","normalCompletion","didErr","err","call","step","next","_e2","minLen","_arrayLikeToArray","Object","prototype","toString","slice","constructor","name","from","test","arr","len","arr2","_typeof","obj","useFormCompletionProgress","_ref","values","requiredFields","_ref$optionalFields","optionalFields","useMemo","required","optional","filledRequired","filter","path","isFilled","getFieldValue","filledOptional","missingRequired","totalRequired","totalOptional","requiredPct","Math","round","overallFilled","overallTotal","overallPct","isCompleteRequired","undefined","parts","split","cur","_iterator","_step","p","v","trim","Date","Number","isNaN","getTime","keys"],"sources":["../../../src/lib/v2/hooks/useFormCompletionProgress.ts"],"sourcesContent":["import { useMemo } from \"react\";\r\n\r\n/**\r\n * useFormCompletionProgress — derive required/overall completion\r\n * percentages from current form values and a declared field list.\r\n * Pure useMemo computation, no side effects.\r\n *\r\n * Usage:\r\n *   import { v2 } from \"@portnet/ui\";\r\n *   const { useFormCompletionProgress, ProgressBar } = v2;\r\n *\r\n *   const REQUIRED = [\"typeAutorisation\", \"importer.id\", \"dateFinValidite\"];\r\n *   const OPTIONAL = [\"referenceLicence\", \"region\"];\r\n *\r\n *   const {\r\n *     requiredPct,\r\n *     overallPct,\r\n *     isCompleteRequired,\r\n *     missingRequired,\r\n *     filledRequired,\r\n *     totalRequired,\r\n *   } = useFormCompletionProgress({\r\n *     values: formik.values,\r\n *     requiredFields: REQUIRED,\r\n *     optionalFields: OPTIONAL,\r\n *   });\r\n *\r\n *   <ProgressBar value={requiredPct} />\r\n *   <span>{filledRequired}/{totalRequired} requis</span>\r\n *\r\n * Field paths support dot notation for nested values:\r\n *   \"importer.id\"   → values.importer.id\r\n *   \"articles\"      → values.articles (array length checked)\r\n */\r\n\r\ntype FormCompletionProgressOptions<Values> = {\r\n  values: Values;\r\n  /** Field keys / dot-paths that are required. */\r\n  requiredFields: string[];\r\n  /** Field keys / dot-paths that are optional. */\r\n  optionalFields?: string[];\r\n};\r\n\r\ntype FormCompletionProgress = {\r\n  requiredPct: number;\r\n  overallPct: number;\r\n  filledRequired: number;\r\n  totalRequired: number;\r\n  filledOptional: number;\r\n  totalOptional: number;\r\n  isCompleteRequired: boolean;\r\n  missingRequired: string[];\r\n};\r\n\r\nexport default function useFormCompletionProgress<Values>({\r\n  values,\r\n  requiredFields,\r\n  optionalFields = [],\r\n}: FormCompletionProgressOptions<Values>): FormCompletionProgress {\r\n  return useMemo(() => {\r\n    const required = Array.isArray(requiredFields) ? requiredFields : [];\r\n    const optional = Array.isArray(optionalFields) ? optionalFields : [];\r\n\r\n    const filledRequired = required.filter((path) =>\r\n      isFilled(getFieldValue(values, path))\r\n    ).length;\r\n    const filledOptional = optional.filter((path) =>\r\n      isFilled(getFieldValue(values, path))\r\n    ).length;\r\n\r\n    const missingRequired = required.filter(\r\n      (path) => !isFilled(getFieldValue(values, path))\r\n    );\r\n\r\n    const totalRequired = required.length;\r\n    const totalOptional = optional.length;\r\n\r\n    const requiredPct = totalRequired\r\n      ? Math.round((filledRequired / totalRequired) * 100)\r\n      : 100;\r\n\r\n    const overallFilled = filledRequired + filledOptional;\r\n    const overallTotal = totalRequired + totalOptional;\r\n    const overallPct = overallTotal\r\n      ? Math.round((overallFilled / overallTotal) * 100)\r\n      : 0;\r\n\r\n    return {\r\n      requiredPct,\r\n      overallPct,\r\n      filledRequired,\r\n      totalRequired,\r\n      filledOptional,\r\n      totalOptional,\r\n      isCompleteRequired: totalRequired === 0 || filledRequired === totalRequired,\r\n      missingRequired,\r\n    };\r\n  }, [values, requiredFields, optionalFields]);\r\n}\r\n\r\n/* ── Helpers ───────────────────────────── */\r\n\r\n/**\r\n * Resolves a dot-separated field path against a values object.\r\n * Returns undefined on any missing intermediate.\r\n *\r\n *   getFieldValue({ a: { b: { c: 42 } } }, \"a.b.c\")    → 42\r\n *   getFieldValue({ a: null }, \"a.b.c\")                → undefined\r\n *   getFieldValue({}, \"doesNotExist\")                  → undefined\r\n */\r\nfunction getFieldValue(obj: unknown, path: string): unknown {\r\n  if (!obj || typeof obj !== \"object\") return undefined;\r\n  if (!path) return undefined;\r\n  const parts = path.split(\".\");\r\n  let cur: unknown = obj;\r\n  for (const p of parts) {\r\n    if (cur === null || cur === undefined) return undefined;\r\n    if (typeof cur !== \"object\") return undefined;\r\n    cur = (cur as Record<string, unknown>)[p];\r\n  }\r\n  return cur;\r\n}\r\n\r\n/**\r\n * Centralised \"is this value considered filled?\" check.\r\n *\r\n * Considered EMPTY:\r\n *   - null, undefined\r\n *   - \"\" or whitespace-only string\r\n *   - empty array []\r\n *   - empty plain object {}\r\n *\r\n * Considered FILLED (intentional):\r\n *   - 0, false (valid user input distinct from \"unset\")\r\n *   - any non-empty array, object with keys, string, number\r\n *   - Date instances with valid time\r\n */\r\nfunction isFilled(v: unknown): boolean {\r\n  if (v === null || v === undefined) return false;\r\n  if (typeof v === \"string\") return v.trim().length > 0;\r\n  if (Array.isArray(v)) return v.length > 0;\r\n  if (v instanceof Date) return !Number.isNaN(v.getTime());\r\n  if (typeof v === \"object\") return Object.keys(v).length > 0;\r\n  // numbers, booleans\r\n  return true;\r\n}\r\n"],"mappings":"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","ignoreList":[]}

package/dist/v2/hooks/useResolvedDensity.d.ts

@@ -0,0 +1,31 @@
+import useDensity from "./useDensity";
+/**
+ * useResolvedDensity — Portnet UI v2
+ *
+ * Returns the effective density for a component instance, applying
+ * the standard resolution order used across the v2 surface:
+ *
+ *   (1) explicit `propValue` from the caller (component prop)
+ *   (2) the global user preference from useDensity()
+ *   (3) fallback "comfortable"
+ *
+ * Use this in any component that wants to honour the user-level
+ * density preference BY DEFAULT but still allow a caller to force
+ * an override per instance — e.g. a picker dialog that always
+ * wants "compact" regardless of the global preference, or a key
+ * report that always wants "comfortable" for legibility.
+ *
+ * The hook always subscribes to useDensity() so the component
+ * re-renders correctly when the user toggles the global density
+ * (same tab via setter, other tab via storage event). The prop
+ * simply wins on the resolved value when it's a valid density.
+ *
+ * Charter R-9.5 / R-DG.11.
+ *
+ *   const effective = useResolvedDensity(props.density);
+ *   <DataGrid density={effective} … />
+ */
+type DensityPref = ReturnType<typeof useDensity>[0];
+export default function useResolvedDensity(propValue?: DensityPref): DensityPref;
+export {};
+//# sourceMappingURL=useResolvedDensity.d.ts.map

package/dist/v2/hooks/useResolvedDensity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useResolvedDensity.d.ts","sourceRoot":"","sources":["../../../src/lib/v2/hooks/useResolvedDensity.ts"],"names":[],"mappings":"AAAA,OAAO,UAAU,MAAM,cAAc,CAAC;AAEtC;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAEH,KAAK,WAAW,GAAG,UAAU,CAAC,OAAO,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC;AAIpD,MAAM,CAAC,OAAO,UAAU,kBAAkB,CAAC,SAAS,CAAC,EAAE,WAAW,GAAG,WAAW,CAI/E"}

package/dist/v2/hooks/useResolvedDensity.js

@@ -0,0 +1,50 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports["default"] = useResolvedDensity;
+var _useDensity3 = _interopRequireDefault(require("./useDensity"));
+function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { "default": obj }; }
+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; }
+/**
+ * useResolvedDensity — Portnet UI v2
+ *
+ * Returns the effective density for a component instance, applying
+ * the standard resolution order used across the v2 surface:
+ *
+ *   (1) explicit `propValue` from the caller (component prop)
+ *   (2) the global user preference from useDensity()
+ *   (3) fallback "comfortable"
+ *
+ * Use this in any component that wants to honour the user-level
+ * density preference BY DEFAULT but still allow a caller to force
+ * an override per instance — e.g. a picker dialog that always
+ * wants "compact" regardless of the global preference, or a key
+ * report that always wants "comfortable" for legibility.
+ *
+ * The hook always subscribes to useDensity() so the component
+ * re-renders correctly when the user toggles the global density
+ * (same tab via setter, other tab via storage event). The prop
+ * simply wins on the resolved value when it's a valid density.
+ *
+ * Charter R-9.5 / R-DG.11.
+ *
+ *   const effective = useResolvedDensity(props.density);
+ *   <DataGrid density={effective} … />
+ */
+
+var VALID = new Set(["comfortable", "compact"]);
+function useResolvedDensity(propValue) {
+  var _useDensity = (0, _useDensity3["default"])(),
+    _useDensity2 = _slicedToArray(_useDensity, 1),
+    globalDensity = _useDensity2[0];
+  if (propValue !== undefined && VALID.has(propValue)) return propValue;
+  return globalDensity;
+}
+//# sourceMappingURL=useResolvedDensity.js.map

package/dist/v2/hooks/useResolvedDensity.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useResolvedDensity.js","names":["_useDensity3","_interopRequireDefault","require","obj","__esModule","_slicedToArray","arr","i","_arrayWithHoles","_iterableToArrayLimit","_unsupportedIterableToArray","_nonIterableRest","TypeError","o","minLen","_arrayLikeToArray","n","Object","prototype","toString","call","slice","constructor","name","Array","from","test","len","length","arr2","_i","Symbol","iterator","_s","_e","_x","_r","_arr","_n","_d","next","done","push","value","err","isArray","VALID","Set","useResolvedDensity","propValue","_useDensity","useDensity","_useDensity2","globalDensity","undefined","has"],"sources":["../../../src/lib/v2/hooks/useResolvedDensity.ts"],"sourcesContent":["import useDensity from \"./useDensity\";\r\n\r\n/**\r\n * useResolvedDensity — Portnet UI v2\r\n *\r\n * Returns the effective density for a component instance, applying\r\n * the standard resolution order used across the v2 surface:\r\n *\r\n *   (1) explicit `propValue` from the caller (component prop)\r\n *   (2) the global user preference from useDensity()\r\n *   (3) fallback \"comfortable\"\r\n *\r\n * Use this in any component that wants to honour the user-level\r\n * density preference BY DEFAULT but still allow a caller to force\r\n * an override per instance — e.g. a picker dialog that always\r\n * wants \"compact\" regardless of the global preference, or a key\r\n * report that always wants \"comfortable\" for legibility.\r\n *\r\n * The hook always subscribes to useDensity() so the component\r\n * re-renders correctly when the user toggles the global density\r\n * (same tab via setter, other tab via storage event). The prop\r\n * simply wins on the resolved value when it's a valid density.\r\n *\r\n * Charter R-9.5 / R-DG.11.\r\n *\r\n *   const effective = useResolvedDensity(props.density);\r\n *   <DataGrid density={effective} … />\r\n */\r\n\r\ntype DensityPref = ReturnType<typeof useDensity>[0];\r\n\r\nconst VALID = new Set([\"comfortable\", \"compact\"]);\r\n\r\nexport default function useResolvedDensity(propValue?: DensityPref): DensityPref {\r\n  const [globalDensity] = useDensity();\r\n  if (propValue !== undefined && VALID.has(propValue)) return propValue;\r\n  return globalDensity;\r\n}\r\n"],"mappings":"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","ignoreList":[]}

package/dist/v2/hooks/useSortedRows.d.ts

@@ -0,0 +1,25 @@
+import type { SortDescriptor } from "../types/common";
+/**
+ * useSortedRows — Portnet UI v2
+ *
+ * Memoised, locale-aware sort. Wraps `applySort` (Batch 12 / C1) with a
+ * useMemo so consumers don't have to wire the dependency array themselves.
+ *
+ *   const [sort, setSort] = useState<SortDescriptor[]>([{ key: "date", dir: "desc" }]);
+ *   const sortedRows = useSortedRows(rows, sort, "fr-FR");
+ *   <DataGrid rows={sortedRows} sort={sort} onSortChange={setSort} ... />
+ *
+ * Re-runs when:
+ *   - `rows`   reference changes (host responsibility — pass a stable ref
+ *              when the data hasn't actually changed, otherwise the sort
+ *              runs every render).
+ *   - `sort`   reference changes.
+ *   - `locale` value changes (string compare).
+ *
+ * For server-side sorting, skip this hook and pass already-sorted rows
+ * straight to DataGrid.
+ *
+ * @returns A new sorted array (or the same reference when there's nothing to sort).
+ */
+export default function useSortedRows<T extends object>(rows: T[], sort: SortDescriptor[], locale?: string): T[];
+//# sourceMappingURL=useSortedRows.d.ts.map

package/dist/v2/hooks/useSortedRows.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useSortedRows.d.ts","sourceRoot":"","sources":["../../../src/lib/v2/hooks/useSortedRows.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAEtD;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,MAAM,CAAC,OAAO,UAAU,aAAa,CAAC,CAAC,SAAS,MAAM,EACpD,IAAI,EAAE,CAAC,EAAE,EACT,IAAI,EAAE,cAAc,EAAE,EACtB,MAAM,CAAC,EAAE,MAAM,GACd,CAAC,EAAE,CAKL"}

package/dist/v2/hooks/useSortedRows.js

@@ -0,0 +1,38 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports["default"] = useSortedRows;
+var _react = require("react");
+var _sort = require("../patterns/_sort");
+/**
+ * useSortedRows — Portnet UI v2
+ *
+ * Memoised, locale-aware sort. Wraps `applySort` (Batch 12 / C1) with a
+ * useMemo so consumers don't have to wire the dependency array themselves.
+ *
+ *   const [sort, setSort] = useState<SortDescriptor[]>([{ key: "date", dir: "desc" }]);
+ *   const sortedRows = useSortedRows(rows, sort, "fr-FR");
+ *   <DataGrid rows={sortedRows} sort={sort} onSortChange={setSort} ... />
+ *
+ * Re-runs when:
+ *   - `rows`   reference changes (host responsibility — pass a stable ref
+ *              when the data hasn't actually changed, otherwise the sort
+ *              runs every render).
+ *   - `sort`   reference changes.
+ *   - `locale` value changes (string compare).
+ *
+ * For server-side sorting, skip this hook and pass already-sorted rows
+ * straight to DataGrid.
+ *
+ * @returns A new sorted array (or the same reference when there's nothing to sort).
+ */
+function useSortedRows(rows, sort, locale) {
+  return (0, _react.useMemo)(function () {
+    return (0, _sort.applySort)(rows, sort, locale === undefined ? {} : {
+      locale: locale
+    });
+  }, [rows, sort, locale]);
+}
+//# sourceMappingURL=useSortedRows.js.map

package/dist/v2/hooks/useSortedRows.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useSortedRows.js","names":["_react","require","_sort","useSortedRows","rows","sort","locale","useMemo","applySort","undefined"],"sources":["../../../src/lib/v2/hooks/useSortedRows.ts"],"sourcesContent":["import { useMemo } from \"react\";\r\nimport { applySort } from \"../patterns/_sort\";\r\nimport type { SortDescriptor } from \"../types/common\";\r\n\r\n/**\r\n * useSortedRows — Portnet UI v2\r\n *\r\n * Memoised, locale-aware sort. Wraps `applySort` (Batch 12 / C1) with a\r\n * useMemo so consumers don't have to wire the dependency array themselves.\r\n *\r\n *   const [sort, setSort] = useState<SortDescriptor[]>([{ key: \"date\", dir: \"desc\" }]);\r\n *   const sortedRows = useSortedRows(rows, sort, \"fr-FR\");\r\n *   <DataGrid rows={sortedRows} sort={sort} onSortChange={setSort} ... />\r\n *\r\n * Re-runs when:\r\n *   - `rows`   reference changes (host responsibility — pass a stable ref\r\n *              when the data hasn't actually changed, otherwise the sort\r\n *              runs every render).\r\n *   - `sort`   reference changes.\r\n *   - `locale` value changes (string compare).\r\n *\r\n * For server-side sorting, skip this hook and pass already-sorted rows\r\n * straight to DataGrid.\r\n *\r\n * @returns A new sorted array (or the same reference when there's nothing to sort).\r\n */\r\nexport default function useSortedRows<T extends object>(\r\n  rows: T[],\r\n  sort: SortDescriptor[],\r\n  locale?: string,\r\n): T[] {\r\n  return useMemo(\r\n    () => applySort(rows, sort, locale === undefined ? {} : { locale }),\r\n    [rows, sort, locale],\r\n  );\r\n}\r\n"],"mappings":";;;;;;AAAA,IAAAA,MAAA,GAAAC,OAAA;AACA,IAAAC,KAAA,GAAAD,OAAA;AAGA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACe,SAASE,aAAaA,CACnCC,IAAS,EACTC,IAAsB,EACtBC,MAAe,EACV;EACL,OAAO,IAAAC,cAAO,EACZ;IAAA,OAAM,IAAAC,eAAS,EAACJ,IAAI,EAAEC,IAAI,EAAEC,MAAM,KAAKG,SAAS,GAAG,CAAC,CAAC,GAAG;MAAEH,MAAM,EAANA;IAAO,CAAC,CAAC;EAAA,GACnE,CAACF,IAAI,EAAEC,IAAI,EAAEC,MAAM,CACrB,CAAC;AACH","ignoreList":[]}