@portnet/ui 6.0.2 → 6.0.3

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

@@ -1,7 +1,3 @@
-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); }
 import { useMemo } from "react";
 
 /**
@@ -37,38 +33,32 @@ import { useMemo } from "react";
  *   "articles"      → values.articles (array length checked)
  */
 
-export default function useFormCompletionProgress(_ref) {
-  var values = _ref.values,
-    requiredFields = _ref.requiredFields,
-    _ref$optionalFields = _ref.optionalFields,
-    optionalFields = _ref$optionalFields === void 0 ? [] : _ref$optionalFields;
-  return 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;
+export default function useFormCompletionProgress({
+  values,
+  requiredFields,
+  optionalFields = []
+}) {
+  return useMemo(() => {
+    const required = Array.isArray(requiredFields) ? requiredFields : [];
+    const optional = Array.isArray(optionalFields) ? optionalFields : [];
+    const filledRequired = required.filter(path => isFilled(getFieldValue(values, path))).length;
+    const filledOptional = optional.filter(path => isFilled(getFieldValue(values, path))).length;
+    const missingRequired = required.filter(path => !isFilled(getFieldValue(values, path)));
+    const totalRequired = required.length;
+    const totalOptional = optional.length;
+    const requiredPct = totalRequired ? Math.round(filledRequired / totalRequired * 100) : 100;
+    const overallFilled = filledRequired + filledOptional;
+    const overallTotal = totalRequired + totalOptional;
+    const overallPct = overallTotal ? Math.round(overallFilled / overallTotal * 100) : 0;
     return {
-      requiredPct: requiredPct,
-      overallPct: overallPct,
-      filledRequired: filledRequired,
-      totalRequired: totalRequired,
-      filledOptional: filledOptional,
-      totalOptional: totalOptional,
+      requiredPct,
+      overallPct,
+      filledRequired,
+      totalRequired,
+      filledOptional,
+      totalOptional,
       isCompleteRequired: totalRequired === 0 || filledRequired === totalRequired,
-      missingRequired: missingRequired
+      missingRequired
     };
   }, [values, requiredFields, optionalFields]);
 }
@@ -84,23 +74,14 @@ export default function useFormCompletionProgress(_ref) {
  *   getFieldValue({}, "doesNotExist")                  → undefined
  */
 function getFieldValue(obj, path) {
-  if (!obj || _typeof(obj) !== "object") return undefined;
+  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();
+  const parts = path.split(".");
+  let cur = obj;
+  for (const p of parts) {
+    if (cur === null || cur === undefined) return undefined;
+    if (typeof cur !== "object") return undefined;
+    cur = cur[p];
   }
   return cur;
 }
@@ -124,7 +105,7 @@ function isFilled(v) {
   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;
+  if (typeof v === "object") return Object.keys(v).length > 0;
   // numbers, booleans
   return true;
 }

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

@@ -1 +1 @@
-{"version":3,"file":"useFormCompletionProgress.js","names":["useMemo","useFormCompletionProgress","_ref","values","requiredFields","_ref$optionalFields","optionalFields","required","Array","isArray","optional","filledRequired","filter","path","isFilled","getFieldValue","length","filledOptional","missingRequired","totalRequired","totalOptional","requiredPct","Math","round","overallFilled","overallTotal","overallPct","isCompleteRequired","obj","_typeof","undefined","parts","split","cur","_iterator","_createForOfIteratorHelper","_step","s","n","done","p","value","err","e","f","v","trim","Date","Number","isNaN","getTime","Object","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":[]}
+{"version":3,"file":"useFormCompletionProgress.js","names":["useMemo","useFormCompletionProgress","values","requiredFields","optionalFields","required","Array","isArray","optional","filledRequired","filter","path","isFilled","getFieldValue","length","filledOptional","missingRequired","totalRequired","totalOptional","requiredPct","Math","round","overallFilled","overallTotal","overallPct","isCompleteRequired","obj","undefined","parts","split","cur","p","v","trim","Date","Number","isNaN","getTime","Object","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[] | undefined;\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/esm/v2/hooks/useKeyboardShortcuts.js

@@ -0,0 +1,125 @@
+import * as React from "react";
+
+/**
+ * useKeyboardShortcuts — Portnet UI v2 (hook)
+ *
+ * Raccourcis clavier de page. §Keyboard / R-K.1.
+ *
+ * ─────────────────────────────────────────────────────────────────────────────
+ * WHY THIS BELONGS IN THE LIBRARY (capability gap G-48)
+ *
+ * The library already owned BOTH ENDS of page shortcuts and not the listener
+ * between them:
+ *
+ *   · `KeyboardShortcutsHelp` — the « ? » dialogue that LISTS the shortcuts;
+ *   · `data-v2-overlay-open` on `<body>` — the signal the library SETS when a
+ *     modal or drawer is open, and which shortcuts must respect.
+ *
+ * So a host wiring shortcuts had to write the middle itself, and `ms-ti-fe`
+ * did: a `keydown` effect plus `isShortcutBlockingTarget` (a set of eleven
+ * interactive ARIA roles, the tag list, `isContentEditable`, `tabIndex >= 0`)
+ * plus `isOverlayOpen` reading the library's own attribute back off the body.
+ * Forty lines of platform behaviour in a listing page.
+ *
+ * >>> THE OVERLAY GUARD IS THE REASON THIS CANNOT STAY IN A HOST. The library
+ * >>> is what SETS `data-v2-overlay-open`; a host reading it is a module
+ * >>> depending on an implementation detail of the component it renders. If
+ * >>> that attribute is ever renamed, every host that copied the guard breaks
+ * >>> SILENTLY — the shortcuts simply start firing behind open modals, which
+ * >>> nothing tests and nobody notices until a « n » keystroke inside a drawer
+ * >>> navigates the page away. Owning the listener here means the guard and
+ * >>> the signal are maintained together. <<<
+ *
+ * Raised from `addm-fe` (Area 14), whose listings carry a `searchInputRef`
+ * declared and passed to `DataGridToolbar` FOR the « / » shortcut — a wire
+ * waiting for a listener that was never written.
+ * ─────────────────────────────────────────────────────────────────────────────
+ *
+ * WHAT THE HOOK REFUSES TO FIRE ON, and why each case matters:
+ *
+ *   · A MODIFIER is held (⌘/Ctrl/Alt). « n » is a shortcut; ⌘N is the
+ *     browser's new window, and stealing it is worse than having no shortcut.
+ *   · The target is an EDITABLE element — input, textarea, select,
+ *     contenteditable. Typing « / » in a search box must insert a slash.
+ *   · The target is otherwise INTERACTIVE — a button, a link, anything with an
+ *     interactive ARIA role or a positive tabIndex. `Espace` on a focused
+ *     button activates it; a page shortcut must not pre-empt that.
+ *   · An OVERLAY is open. See the note above.
+ *
+ * `<main>` is excluded from the tabIndex test deliberately: a page shell gives
+ * `<main>` a `tabIndex` so a skip link can reach it, which would otherwise
+ * disable every shortcut for a user who just used the skip link.
+ *
+ * Usage:
+ *
+ *   useKeyboardShortcuts([
+ *     { keys: ["/"], onTrigger: () => searchRef.current?.focus() },
+ *     { keys: ["n"], onTrigger: goToCreate, enabled: canCreate },
+ *     { keys: ["1", "2", "3"], onTrigger: (key) => setBucket(BY_KEY[key]) },
+ *   ]);
+ *
+ * The host keeps its own `KeyboardShortcutsHelp` list: this hook knows which
+ * keys DO something, not how to describe them to a user (§9.2 — the business
+ * wording belongs to the host).
+ */
+
+/**
+ * Roles whose focused element handles its own keys. Kept here rather than in
+ * a host so the list is maintained once for the fleet.
+ */
+const INTERACTIVE_ROLES = new Set(["button", "link", "tab", "menuitem", "menuitemcheckbox", "menuitemradio", "option", "checkbox", "radio", "combobox", "searchbox", "textbox", "switch", "spinbutton", "slider"]);
+const EDITABLE_TAGS = new Set(["INPUT", "TEXTAREA", "SELECT"]);
+function isBlockingTarget(node) {
+  if (!node || node === document.body) return false;
+  if (!(node instanceof Element)) return false;
+  const tag = node.tagName;
+  if (EDITABLE_TAGS.has(tag)) return true;
+  if (tag === "BUTTON" || tag === "A") return true;
+  if (node instanceof HTMLElement && node.isContentEditable) return true;
+  const role = node.getAttribute("role");
+  if (role && INTERACTIVE_ROLES.has(role)) return true;
+
+  /* `MAIN` excluded — see the note in the file header on skip links. */
+  if (node instanceof HTMLElement && node.tabIndex >= 0 && tag !== "MAIN") {
+    return true;
+  }
+  return false;
+}
+
+/** Is a library overlay (modal / drawer) currently open? */
+function isOverlayOpen() {
+  if (typeof document === "undefined") return false;
+  return document.body?.getAttribute("data-v2-overlay-open") === "true";
+}
+export function useKeyboardShortcuts(shortcuts, {
+  enabled = true
+} = {}) {
+  /* The descriptor array is rebuilt on every host render (inline literal, in
+   * practice), so it is read through a ref instead of being an effect
+   * dependency — otherwise the listener detaches and reattaches on each
+   * render, and a keystroke could land between the two. */
+  const ref = React.useRef(shortcuts);
+  React.useEffect(() => {
+    ref.current = shortcuts;
+  }, [shortcuts]);
+  React.useEffect(() => {
+    if (!enabled || typeof window === "undefined") return undefined;
+    const onKeyDown = e => {
+      if (e.metaKey || e.ctrlKey || e.altKey) return;
+      if (isBlockingTarget(document.activeElement)) return;
+      if (isBlockingTarget(e.target)) return;
+      if (isOverlayOpen()) return;
+      for (const shortcut of ref.current) {
+        if (shortcut.enabled === false) continue;
+        if (!shortcut.keys.includes(e.key)) continue;
+        e.preventDefault();
+        shortcut.onTrigger(e.key);
+        return;
+      }
+    };
+    window.addEventListener("keydown", onKeyDown);
+    return () => window.removeEventListener("keydown", onKeyDown);
+  }, [enabled]);
+}
+export default useKeyboardShortcuts;
+//# sourceMappingURL=useKeyboardShortcuts.js.map

package/dist/esm/v2/hooks/useKeyboardShortcuts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useKeyboardShortcuts.js","names":["React","INTERACTIVE_ROLES","Set","EDITABLE_TAGS","isBlockingTarget","node","document","body","Element","tag","tagName","has","HTMLElement","isContentEditable","role","getAttribute","tabIndex","isOverlayOpen","useKeyboardShortcuts","shortcuts","enabled","ref","useRef","useEffect","current","window","undefined","onKeyDown","e","metaKey","ctrlKey","altKey","activeElement","target","shortcut","keys","includes","key","preventDefault","onTrigger","addEventListener","removeEventListener"],"sources":["../../../../src/lib/v2/hooks/useKeyboardShortcuts.ts"],"sourcesContent":["import * as React from \"react\";\r\n\r\n/**\r\n * useKeyboardShortcuts — Portnet UI v2 (hook)\r\n *\r\n * Raccourcis clavier de page. §Keyboard / R-K.1.\r\n *\r\n * ─────────────────────────────────────────────────────────────────────────────\r\n * WHY THIS BELONGS IN THE LIBRARY (capability gap G-48)\r\n *\r\n * The library already owned BOTH ENDS of page shortcuts and not the listener\r\n * between them:\r\n *\r\n *   · `KeyboardShortcutsHelp` — the « ? » dialogue that LISTS the shortcuts;\r\n *   · `data-v2-overlay-open` on `<body>` — the signal the library SETS when a\r\n *     modal or drawer is open, and which shortcuts must respect.\r\n *\r\n * So a host wiring shortcuts had to write the middle itself, and `ms-ti-fe`\r\n * did: a `keydown` effect plus `isShortcutBlockingTarget` (a set of eleven\r\n * interactive ARIA roles, the tag list, `isContentEditable`, `tabIndex >= 0`)\r\n * plus `isOverlayOpen` reading the library's own attribute back off the body.\r\n * Forty lines of platform behaviour in a listing page.\r\n *\r\n * >>> THE OVERLAY GUARD IS THE REASON THIS CANNOT STAY IN A HOST. The library\r\n * >>> is what SETS `data-v2-overlay-open`; a host reading it is a module\r\n * >>> depending on an implementation detail of the component it renders. If\r\n * >>> that attribute is ever renamed, every host that copied the guard breaks\r\n * >>> SILENTLY — the shortcuts simply start firing behind open modals, which\r\n * >>> nothing tests and nobody notices until a « n » keystroke inside a drawer\r\n * >>> navigates the page away. Owning the listener here means the guard and\r\n * >>> the signal are maintained together. <<<\r\n *\r\n * Raised from `addm-fe` (Area 14), whose listings carry a `searchInputRef`\r\n * declared and passed to `DataGridToolbar` FOR the « / » shortcut — a wire\r\n * waiting for a listener that was never written.\r\n * ─────────────────────────────────────────────────────────────────────────────\r\n *\r\n * WHAT THE HOOK REFUSES TO FIRE ON, and why each case matters:\r\n *\r\n *   · A MODIFIER is held (⌘/Ctrl/Alt). « n » is a shortcut; ⌘N is the\r\n *     browser's new window, and stealing it is worse than having no shortcut.\r\n *   · The target is an EDITABLE element — input, textarea, select,\r\n *     contenteditable. Typing « / » in a search box must insert a slash.\r\n *   · The target is otherwise INTERACTIVE — a button, a link, anything with an\r\n *     interactive ARIA role or a positive tabIndex. `Espace` on a focused\r\n *     button activates it; a page shortcut must not pre-empt that.\r\n *   · An OVERLAY is open. See the note above.\r\n *\r\n * `<main>` is excluded from the tabIndex test deliberately: a page shell gives\r\n * `<main>` a `tabIndex` so a skip link can reach it, which would otherwise\r\n * disable every shortcut for a user who just used the skip link.\r\n *\r\n * Usage:\r\n *\r\n *   useKeyboardShortcuts([\r\n *     { keys: [\"/\"], onTrigger: () => searchRef.current?.focus() },\r\n *     { keys: [\"n\"], onTrigger: goToCreate, enabled: canCreate },\r\n *     { keys: [\"1\", \"2\", \"3\"], onTrigger: (key) => setBucket(BY_KEY[key]) },\r\n *   ]);\r\n *\r\n * The host keeps its own `KeyboardShortcutsHelp` list: this hook knows which\r\n * keys DO something, not how to describe them to a user (§9.2 — the business\r\n * wording belongs to the host).\r\n */\r\n\r\n/**\r\n * Roles whose focused element handles its own keys. Kept here rather than in\r\n * a host so the list is maintained once for the fleet.\r\n */\r\nconst INTERACTIVE_ROLES = new Set([\r\n  \"button\",\r\n  \"link\",\r\n  \"tab\",\r\n  \"menuitem\",\r\n  \"menuitemcheckbox\",\r\n  \"menuitemradio\",\r\n  \"option\",\r\n  \"checkbox\",\r\n  \"radio\",\r\n  \"combobox\",\r\n  \"searchbox\",\r\n  \"textbox\",\r\n  \"switch\",\r\n  \"spinbutton\",\r\n  \"slider\",\r\n]);\r\n\r\nconst EDITABLE_TAGS = new Set([\"INPUT\", \"TEXTAREA\", \"SELECT\"]);\r\n\r\nfunction isBlockingTarget(node: EventTarget | null): boolean {\r\n  if (!node || node === document.body) return false;\r\n  if (!(node instanceof Element)) return false;\r\n\r\n  const tag = node.tagName;\r\n  if (EDITABLE_TAGS.has(tag)) return true;\r\n  if (tag === \"BUTTON\" || tag === \"A\") return true;\r\n\r\n  if (node instanceof HTMLElement && node.isContentEditable) return true;\r\n\r\n  const role = node.getAttribute(\"role\");\r\n  if (role && INTERACTIVE_ROLES.has(role)) return true;\r\n\r\n  /* `MAIN` excluded — see the note in the file header on skip links. */\r\n  if (node instanceof HTMLElement && node.tabIndex >= 0 && tag !== \"MAIN\") {\r\n    return true;\r\n  }\r\n\r\n  return false;\r\n}\r\n\r\n/** Is a library overlay (modal / drawer) currently open? */\r\nfunction isOverlayOpen(): boolean {\r\n  if (typeof document === \"undefined\") return false;\r\n  return document.body?.getAttribute(\"data-v2-overlay-open\") === \"true\";\r\n}\r\n\r\nexport interface KeyboardShortcut {\r\n  /**\r\n   * Keys that trigger it, as `KeyboardEvent.key` values — so `\"/\"`, `\"?\"`,\r\n   * `\"1\"`, `\"n\"`. Case matters: `\"n\"` does not match `Shift+N`.\r\n   */\r\n  keys: readonly string[];\r\n  /**\r\n   * Receives the key that matched, so one descriptor can serve a range\r\n   * (`[\"1\",\"2\",\"3\"]` → one handler that reads which was pressed).\r\n   */\r\n  onTrigger: (key: string) => void;\r\n  /**\r\n   * @default true — a shortcut gated on a permission stays DECLARED and\r\n   * inactive rather than being spliced out of the array, so the descriptor\r\n   * list keeps the same shape as the help dialogue's.\r\n   */\r\n  enabled?: boolean | undefined;\r\n}\r\n\r\nexport interface UseKeyboardShortcutsOptions {\r\n  /** Suspends every shortcut at once. @default true */\r\n  enabled?: boolean | undefined;\r\n}\r\n\r\nexport function useKeyboardShortcuts(\r\n  shortcuts: readonly KeyboardShortcut[],\r\n  { enabled = true }: UseKeyboardShortcutsOptions = {}\r\n): void {\r\n  /* The descriptor array is rebuilt on every host render (inline literal, in\r\n   * practice), so it is read through a ref instead of being an effect\r\n   * dependency — otherwise the listener detaches and reattaches on each\r\n   * render, and a keystroke could land between the two. */\r\n  const ref = React.useRef(shortcuts);\r\n  React.useEffect(() => {\r\n    ref.current = shortcuts;\r\n  }, [shortcuts]);\r\n\r\n  React.useEffect(() => {\r\n    if (!enabled || typeof window === \"undefined\") return undefined;\r\n\r\n    const onKeyDown = (e: KeyboardEvent): void => {\r\n      if (e.metaKey || e.ctrlKey || e.altKey) return;\r\n      if (isBlockingTarget(document.activeElement)) return;\r\n      if (isBlockingTarget(e.target)) return;\r\n      if (isOverlayOpen()) return;\r\n\r\n      for (const shortcut of ref.current) {\r\n        if (shortcut.enabled === false) continue;\r\n        if (!shortcut.keys.includes(e.key)) continue;\r\n        e.preventDefault();\r\n        shortcut.onTrigger(e.key);\r\n        return;\r\n      }\r\n    };\r\n\r\n    window.addEventListener(\"keydown\", onKeyDown);\r\n    return () => window.removeEventListener(\"keydown\", onKeyDown);\r\n  }, [enabled]);\r\n}\r\n\r\nexport default useKeyboardShortcuts;\r\n"],"mappings":"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","ignoreList":[]}

package/dist/esm/v2/hooks/usePrefersReducedMotion.js

@@ -0,0 +1,99 @@
+import { useSyncExternalStore } from "react";
+
+/**
+ * usePrefersReducedMotion — Portnet UI v2
+ *
+ * `true` when the user has asked the system to reduce motion.
+ *
+ *   const reduced = usePrefersReducedMotion();
+ *   const options = { chart: { animation: !reduced } };
+ *
+ * ─────────────────────────────────────────────────────────────────────────────
+ * WHY THIS BELONGS IN THE LIBRARY (capability gap G-49)
+ *
+ * R-7.5 / R-Tg.2 MUST: `prefers-reduced-motion` is respected — animations
+ * ≤ 0.01 ms or none. The library already honours the rule everywhere IT owns
+ * the animation: `motion.ts` documents it, the base stylesheet carries the
+ * media query, `Skeleton` drops its shimmer (R-Sk.4).
+ *
+ * What was missing is the RUNTIME READ. A host that animates something the
+ * library does not own — a chart, a canvas, an imperative scroll, a
+ * third-party widget configured in JS — cannot reach the preference through
+ * CSS, because the decision is a JS value handed to another library. Every
+ * such host wrote the same helper, and every copy observed so far carried the
+ * SAME TWO DEFECTS:
+ *
+ *     const prefersReducedMotion = (): boolean =>
+ *       typeof window !== "undefined" &&
+ *       typeof window.matchMedia === "function" &&
+ *       window.matchMedia("(prefers-reduced-motion: reduce)").matches;
+ *
+ *   1. IT DOES NOT SUBSCRIBE. `matchMedia(...).matches` is read once, during a
+ *      render that may never happen again. A user who turns the preference ON
+ *      — which is exactly what someone does when motion starts to hurt — keeps
+ *      the animations until something unrelated re-renders the screen. The
+ *      rule is written in the present tense; a snapshot satisfies it by luck.
+ *   2. IT IS READ DURING RENDER, so the value is not part of React's state at
+ *      all: two components on one page can disagree, and nothing reconciles
+ *      them.
+ *
+ * `useSyncExternalStore` fixes both at once, and is the primitive React
+ * publishes for precisely this shape — an external, subscribable source of
+ * truth. It also supplies a correct server snapshot instead of a
+ * `typeof window` guard copied into every call site.
+ *
+ * Relevé depuis `autorisation-admis-pour-conforme-fe` (Area 4 — détection
+ * d'infrastructure UI locale), où le helper ci-dessus existait en TROIS copies
+ * identiques, une par écran de bilan, chacune appelée depuis un `useMemo` ou
+ * depuis une fabrique d'options au niveau module.
+ * ─────────────────────────────────────────────────────────────────────────────
+ *
+ * REDUCED MOTION IS NOT AN ACCESSIBILITY CERTIFICATE. A chart that stops
+ * animating is still a chart that owes a text equivalent (WCAG 1.1.1), and a
+ * transition under 200 ms still owes R-Mi.1 its justification.
+ */
+
+/** The media query, exported so a consumer can assert on it in a test. */
+export const PREFERS_REDUCED_MOTION_QUERY = "(prefers-reduced-motion: reduce)";
+
+/**
+ * `null` in any environment without `matchMedia` — server rendering, and the
+ * older jsdom versions where the method is simply absent. Callers treat that
+ * as "no stated preference", the same default the CSS media query has.
+ */
+function getMediaQueryList() {
+  if (typeof window === "undefined") return null;
+  if (typeof window.matchMedia !== "function") return null;
+  return window.matchMedia(PREFERS_REDUCED_MOTION_QUERY);
+}
+function subscribe(onStoreChange) {
+  const mql = getMediaQueryList();
+  if (mql === null) return () => undefined;
+
+  /* Safari 13 / iOS 12 ship `addListener` but not `addEventListener` on
+   * MediaQueryList. Both paths are kept: the browserslist floor is Safari 17,
+   * but this hook is also what a host reaches for inside a webview it does not
+   * choose, and the fallback costs two lines. */
+  if (typeof mql.addEventListener === "function") {
+    mql.addEventListener("change", onStoreChange);
+    return () => mql.removeEventListener("change", onStoreChange);
+  }
+  mql.addListener(onStoreChange);
+  return () => mql.removeListener(onStoreChange);
+}
+function getSnapshot() {
+  return getMediaQueryList()?.matches ?? false;
+}
+
+/**
+ * Server snapshot — `false`, and NOT the client default in disguise: a server
+ * has no user preference to read, and hydration corrects the value before
+ * paint, so nothing animates against the user's wish.
+ */
+function getServerSnapshot() {
+  return false;
+}
+export default function usePrefersReducedMotion() {
+  return useSyncExternalStore(subscribe, getSnapshot, getServerSnapshot);
+}
+//# sourceMappingURL=usePrefersReducedMotion.js.map

package/dist/esm/v2/hooks/usePrefersReducedMotion.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"usePrefersReducedMotion.js","names":["useSyncExternalStore","PREFERS_REDUCED_MOTION_QUERY","getMediaQueryList","window","matchMedia","subscribe","onStoreChange","mql","undefined","addEventListener","removeEventListener","addListener","removeListener","getSnapshot","matches","getServerSnapshot","usePrefersReducedMotion"],"sources":["../../../../src/lib/v2/hooks/usePrefersReducedMotion.ts"],"sourcesContent":["import { useSyncExternalStore } from \"react\";\r\n\r\n/**\r\n * usePrefersReducedMotion — Portnet UI v2\r\n *\r\n * `true` when the user has asked the system to reduce motion.\r\n *\r\n *   const reduced = usePrefersReducedMotion();\r\n *   const options = { chart: { animation: !reduced } };\r\n *\r\n * ─────────────────────────────────────────────────────────────────────────────\r\n * WHY THIS BELONGS IN THE LIBRARY (capability gap G-49)\r\n *\r\n * R-7.5 / R-Tg.2 MUST: `prefers-reduced-motion` is respected — animations\r\n * ≤ 0.01 ms or none. The library already honours the rule everywhere IT owns\r\n * the animation: `motion.ts` documents it, the base stylesheet carries the\r\n * media query, `Skeleton` drops its shimmer (R-Sk.4).\r\n *\r\n * What was missing is the RUNTIME READ. A host that animates something the\r\n * library does not own — a chart, a canvas, an imperative scroll, a\r\n * third-party widget configured in JS — cannot reach the preference through\r\n * CSS, because the decision is a JS value handed to another library. Every\r\n * such host wrote the same helper, and every copy observed so far carried the\r\n * SAME TWO DEFECTS:\r\n *\r\n *     const prefersReducedMotion = (): boolean =>\r\n *       typeof window !== \"undefined\" &&\r\n *       typeof window.matchMedia === \"function\" &&\r\n *       window.matchMedia(\"(prefers-reduced-motion: reduce)\").matches;\r\n *\r\n *   1. IT DOES NOT SUBSCRIBE. `matchMedia(...).matches` is read once, during a\r\n *      render that may never happen again. A user who turns the preference ON\r\n *      — which is exactly what someone does when motion starts to hurt — keeps\r\n *      the animations until something unrelated re-renders the screen. The\r\n *      rule is written in the present tense; a snapshot satisfies it by luck.\r\n *   2. IT IS READ DURING RENDER, so the value is not part of React's state at\r\n *      all: two components on one page can disagree, and nothing reconciles\r\n *      them.\r\n *\r\n * `useSyncExternalStore` fixes both at once, and is the primitive React\r\n * publishes for precisely this shape — an external, subscribable source of\r\n * truth. It also supplies a correct server snapshot instead of a\r\n * `typeof window` guard copied into every call site.\r\n *\r\n * Relevé depuis `autorisation-admis-pour-conforme-fe` (Area 4 — détection\r\n * d'infrastructure UI locale), où le helper ci-dessus existait en TROIS copies\r\n * identiques, une par écran de bilan, chacune appelée depuis un `useMemo` ou\r\n * depuis une fabrique d'options au niveau module.\r\n * ─────────────────────────────────────────────────────────────────────────────\r\n *\r\n * REDUCED MOTION IS NOT AN ACCESSIBILITY CERTIFICATE. A chart that stops\r\n * animating is still a chart that owes a text equivalent (WCAG 1.1.1), and a\r\n * transition under 200 ms still owes R-Mi.1 its justification.\r\n */\r\n\r\n/** The media query, exported so a consumer can assert on it in a test. */\r\nexport const PREFERS_REDUCED_MOTION_QUERY = \"(prefers-reduced-motion: reduce)\";\r\n\r\n/**\r\n * `null` in any environment without `matchMedia` — server rendering, and the\r\n * older jsdom versions where the method is simply absent. Callers treat that\r\n * as \"no stated preference\", the same default the CSS media query has.\r\n */\r\nfunction getMediaQueryList(): MediaQueryList | null {\r\n  if (typeof window === \"undefined\") return null;\r\n  if (typeof window.matchMedia !== \"function\") return null;\r\n  return window.matchMedia(PREFERS_REDUCED_MOTION_QUERY);\r\n}\r\n\r\nfunction subscribe(onStoreChange: () => void): () => void {\r\n  const mql = getMediaQueryList();\r\n  if (mql === null) return () => undefined;\r\n\r\n  /* Safari 13 / iOS 12 ship `addListener` but not `addEventListener` on\r\n   * MediaQueryList. Both paths are kept: the browserslist floor is Safari 17,\r\n   * but this hook is also what a host reaches for inside a webview it does not\r\n   * choose, and the fallback costs two lines. */\r\n  if (typeof mql.addEventListener === \"function\") {\r\n    mql.addEventListener(\"change\", onStoreChange);\r\n    return () => mql.removeEventListener(\"change\", onStoreChange);\r\n  }\r\n\r\n  mql.addListener(onStoreChange);\r\n  return () => mql.removeListener(onStoreChange);\r\n}\r\n\r\nfunction getSnapshot(): boolean {\r\n  return getMediaQueryList()?.matches ?? false;\r\n}\r\n\r\n/**\r\n * Server snapshot — `false`, and NOT the client default in disguise: a server\r\n * has no user preference to read, and hydration corrects the value before\r\n * paint, so nothing animates against the user's wish.\r\n */\r\nfunction getServerSnapshot(): boolean {\r\n  return false;\r\n}\r\n\r\nexport default function usePrefersReducedMotion(): boolean {\r\n  return useSyncExternalStore(subscribe, getSnapshot, getServerSnapshot);\r\n}\r\n"],"mappings":"AAAA,SAASA,oBAAoB,QAAQ,OAAO;;AAE5C;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;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAEA;AACA,OAAO,MAAMC,4BAA4B,GAAG,kCAAkC;;AAE9E;AACA;AACA;AACA;AACA;AACA,SAASC,iBAAiBA,CAAA,EAA0B;EAClD,IAAI,OAAOC,MAAM,KAAK,WAAW,EAAE,OAAO,IAAI;EAC9C,IAAI,OAAOA,MAAM,CAACC,UAAU,KAAK,UAAU,EAAE,OAAO,IAAI;EACxD,OAAOD,MAAM,CAACC,UAAU,CAACH,4BAA4B,CAAC;AACxD;AAEA,SAASI,SAASA,CAACC,aAAyB,EAAc;EACxD,MAAMC,GAAG,GAAGL,iBAAiB,CAAC,CAAC;EAC/B,IAAIK,GAAG,KAAK,IAAI,EAAE,OAAO,MAAMC,SAAS;;EAExC;AACF;AACA;AACA;EACE,IAAI,OAAOD,GAAG,CAACE,gBAAgB,KAAK,UAAU,EAAE;IAC9CF,GAAG,CAACE,gBAAgB,CAAC,QAAQ,EAAEH,aAAa,CAAC;IAC7C,OAAO,MAAMC,GAAG,CAACG,mBAAmB,CAAC,QAAQ,EAAEJ,aAAa,CAAC;EAC/D;EAEAC,GAAG,CAACI,WAAW,CAACL,aAAa,CAAC;EAC9B,OAAO,MAAMC,GAAG,CAACK,cAAc,CAACN,aAAa,CAAC;AAChD;AAEA,SAASO,WAAWA,CAAA,EAAY;EAC9B,OAAOX,iBAAiB,CAAC,CAAC,EAAEY,OAAO,IAAI,KAAK;AAC9C;;AAEA;AACA;AACA;AACA;AACA;AACA,SAASC,iBAAiBA,CAAA,EAAY;EACpC,OAAO,KAAK;AACd;AAEA,eAAe,SAASC,uBAAuBA,CAAA,EAAY;EACzD,OAAOhB,oBAAoB,CAACK,SAAS,EAAEQ,WAAW,EAAEE,iBAAiB,CAAC;AACxE","ignoreList":[]}

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

@@ -1,9 +1,3 @@
-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 useDensity from "./useDensity";
 
 /**
@@ -33,11 +27,9 @@ import useDensity from "./useDensity";
  *   <DataGrid density={effective} … />
  */
 
-var VALID = new Set(["comfortable", "compact"]);
+const VALID = new Set(["comfortable", "compact"]);
 export default function useResolvedDensity(propValue) {
-  var _useDensity = useDensity(),
-    _useDensity2 = _slicedToArray(_useDensity, 1),
-    globalDensity = _useDensity2[0];
+  const [globalDensity] = useDensity();
   if (propValue !== undefined && VALID.has(propValue)) return propValue;
   return globalDensity;
 }

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

@@ -1 +1 @@
-{"version":3,"file":"useResolvedDensity.js","names":["useDensity","VALID","Set","useResolvedDensity","propValue","_useDensity","_useDensity2","_slicedToArray","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":";;;;;;AAAA,OAAOA,UAAU,MAAM,cAAc;;AAErC;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;;AAIA,IAAMC,KAAK,GAAG,IAAIC,GAAG,CAAC,CAAC,aAAa,EAAE,SAAS,CAAC,CAAC;AAEjD,eAAe,SAASC,kBAAkBA,CAACC,SAAuB,EAAe;EAC/E,IAAAC,WAAA,GAAwBL,UAAU,CAAC,CAAC;IAAAM,YAAA,GAAAC,cAAA,CAAAF,WAAA;IAA7BG,aAAa,GAAAF,YAAA;EACpB,IAAIF,SAAS,KAAKK,SAAS,IAAIR,KAAK,CAACS,GAAG,CAACN,SAAS,CAAC,EAAE,OAAOA,SAAS;EACrE,OAAOI,aAAa;AACtB","ignoreList":[]}
+{"version":3,"file":"useResolvedDensity.js","names":["useDensity","VALID","Set","useResolvedDensity","propValue","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":"AAAA,OAAOA,UAAU,MAAM,cAAc;;AAErC;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;;AAIA,MAAMC,KAAK,GAAG,IAAIC,GAAG,CAAC,CAAC,aAAa,EAAE,SAAS,CAAC,CAAC;AAEjD,eAAe,SAASC,kBAAkBA,CAACC,SAAuB,EAAe;EAC/E,MAAM,CAACC,aAAa,CAAC,GAAGL,UAAU,CAAC,CAAC;EACpC,IAAII,SAAS,KAAKE,SAAS,IAAIL,KAAK,CAACM,GAAG,CAACH,SAAS,CAAC,EAAE,OAAOA,SAAS;EACrE,OAAOC,aAAa;AACtB","ignoreList":[]}

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

@@ -23,10 +23,8 @@ import { applySort } from "../patterns/_sort";
  * @returns A new sorted array (or the same reference when there's nothing to sort).
  */
 export default function useSortedRows(rows, sort, locale) {
-  return useMemo(function () {
-    return applySort(rows, sort, locale === undefined ? {} : {
-      locale: locale
-    });
-  }, [rows, sort, locale]);
+  return useMemo(() => applySort(rows, sort, locale === undefined ? {} : {
+    locale
+  }), [rows, sort, locale]);
 }
 //# sourceMappingURL=useSortedRows.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"useSortedRows.js","names":["useMemo","applySort","useSortedRows","rows","sort","locale","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,SAASA,OAAO,QAAQ,OAAO;AAC/B,SAASC,SAAS,QAAQ,mBAAmB;AAG7C;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,eAAe,SAASC,aAAaA,CACnCC,IAAS,EACTC,IAAsB,EACtBC,MAAe,EACV;EACL,OAAOL,OAAO,CACZ;IAAA,OAAMC,SAAS,CAACE,IAAI,EAAEC,IAAI,EAAEC,MAAM,KAAKC,SAAS,GAAG,CAAC,CAAC,GAAG;MAAED,MAAM,EAANA;IAAO,CAAC,CAAC;EAAA,GACnE,CAACF,IAAI,EAAEC,IAAI,EAAEC,MAAM,CACrB,CAAC;AACH","ignoreList":[]}
+{"version":3,"file":"useSortedRows.js","names":["useMemo","applySort","useSortedRows","rows","sort","locale","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,SAASA,OAAO,QAAQ,OAAO;AAC/B,SAASC,SAAS,QAAQ,mBAAmB;AAG7C;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,eAAe,SAASC,aAAaA,CACnCC,IAAS,EACTC,IAAsB,EACtBC,MAAe,EACV;EACL,OAAOL,OAAO,CACZ,MAAMC,SAAS,CAACE,IAAI,EAAEC,IAAI,EAAEC,MAAM,KAAKC,SAAS,GAAG,CAAC,CAAC,GAAG;IAAED;EAAO,CAAC,CAAC,EACnE,CAACF,IAAI,EAAEC,IAAI,EAAEC,MAAM,CACrB,CAAC;AACH","ignoreList":[]}

package/dist/esm/v2/hooks/useTabLoading.js

@@ -1,9 +1,3 @@
-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 { useState, useEffect } from "react";
 
 /**
@@ -11,7 +5,7 @@ import { useState, useEffect } from "react";
  * skeleton would only flicker into view; above it, the user
  * perceives a stall and benefits from the visual cue.
  */
-export var PERCEPTION_THRESHOLD_MS = 200;
+export const PERCEPTION_THRESHOLD_MS = 200;
 
 /**
  * useTabLoading — Portnet UI v2
@@ -44,14 +38,9 @@ export var PERCEPTION_THRESHOLD_MS = 200;
  *   }, [tab]);
  *   const showSkeleton = useTabLoading(tab, PERCEPTION_THRESHOLD_MS, fetching);
  */
-export default function useTabLoading(tab) {
-  var ms = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : PERCEPTION_THRESHOLD_MS;
-  var enabled = arguments.length > 2 && arguments[2] !== undefined ? arguments[2] : false;
-  var _useState = useState(false),
-    _useState2 = _slicedToArray(_useState, 2),
-    loading = _useState2[0],
-    setLoading = _useState2[1];
-  useEffect(function () {
+export default function useTabLoading(tab, ms = PERCEPTION_THRESHOLD_MS, enabled = false) {
+  const [loading, setLoading] = useState(false);
+  useEffect(() => {
     if (!enabled) {
       // Fetch finished (or never started) — drop any in-flight skeleton.
       setLoading(false);
@@ -60,9 +49,7 @@ export default function useTabLoading(tab) {
     // R-Sk.1 — DELAY showing the skeleton until the perception threshold.
     // If the fetch resolves before then, cleanup clears the timer and
     // the skeleton never flickers in.
-    var t = setTimeout(function () {
-      return setLoading(true);
-    }, ms);
+    const t = setTimeout(() => setLoading(true), ms);
 
     // CRITICAL: cleanup ONLY clears the pending timer. We do NOT reset
     // `loading` to false here, otherwise tab changes while still
@@ -70,9 +57,7 @@ export default function useTabLoading(tab) {
     // 200 ms blank flicker between skeletons. The reset path is the
     // `!enabled` branch above, which fires precisely when loading
     // actually ends.
-    return function () {
-      return clearTimeout(t);
-    };
+    return () => clearTimeout(t);
   }, [tab, ms, enabled]);
   return loading;
 }

package/dist/esm/v2/hooks/useTabLoading.js.map

@@ -1 +1 @@
-{"version":3,"file":"useTabLoading.js","names":["useState","useEffect","PERCEPTION_THRESHOLD_MS","useTabLoading","tab","ms","arguments","length","undefined","enabled","_useState","_useState2","_slicedToArray","loading","setLoading","t","setTimeout","clearTimeout"],"sources":["../../../../src/lib/v2/hooks/useTabLoading.ts"],"sourcesContent":["import { useState, useEffect } from \"react\";\r\n\r\n/**\r\n * Charter R-Sk.1 — \"perception threshold\". Below this delay, a\r\n * skeleton would only flicker into view; above it, the user\r\n * perceives a stall and benefits from the visual cue.\r\n */\r\nexport const PERCEPTION_THRESHOLD_MS = 200;\r\n\r\n/**\r\n * useTabLoading — Portnet UI v2\r\n *\r\n * Skeleton-display gate that respects the 200 ms perception threshold.\r\n *\r\n * Charter R-Sk.1 — \"Skeleton displayed if loading > 200 ms; otherwise\r\n * nothing (perception)\". For fetches faster than 200 ms, this hook\r\n * never returns true — the user sees the data land directly with no\r\n * flicker. For fetches slower than 200 ms, the skeleton appears at\r\n * the threshold and stays until the fetch completes.\r\n *\r\n * Caller contract\r\n *   - Drive `enabled` from your real loading state (true while a\r\n *     fetch is in flight, false otherwise).\r\n *   - The hook returns true ONLY when `enabled` has been true for\r\n *     at least `ms` ms, and is reset to false the moment `enabled`\r\n *     flips back to false.\r\n *   - On tab change while still loading, the previous timer is\r\n *     cancelled and a fresh one scheduled — but the existing\r\n *     skeleton-visible state is PRESERVED (loading stays true if\r\n *     it was already true). Without this, fast tab swapping\r\n *     produced 200 ms blank flickers between consecutive skeletons.\r\n *\r\n * Example\r\n *   const [fetching, setFetching] = useState(false);\r\n *   useEffect(() => {\r\n *     setFetching(true);\r\n *     fetchTabData(tab).finally(() => setFetching(false));\r\n *   }, [tab]);\r\n *   const showSkeleton = useTabLoading(tab, PERCEPTION_THRESHOLD_MS, fetching);\r\n */\r\nexport default function useTabLoading(\r\n  tab: string | number,\r\n  ms: number = PERCEPTION_THRESHOLD_MS,\r\n  enabled: boolean = false\r\n): boolean {\r\n  const [loading, setLoading] = useState(false);\r\n\r\n  useEffect(() => {\r\n    if (!enabled) {\r\n      // Fetch finished (or never started) — drop any in-flight skeleton.\r\n      setLoading(false);\r\n      return undefined;\r\n    }\r\n    // R-Sk.1 — DELAY showing the skeleton until the perception threshold.\r\n    // If the fetch resolves before then, cleanup clears the timer and\r\n    // the skeleton never flickers in.\r\n    const t = setTimeout(() => setLoading(true), ms);\r\n\r\n    // CRITICAL: cleanup ONLY clears the pending timer. We do NOT reset\r\n    // `loading` to false here, otherwise tab changes while still\r\n    // fetching (both old and new tab loading) produced a visible\r\n    // 200 ms blank flicker between skeletons. The reset path is the\r\n    // `!enabled` branch above, which fires precisely when loading\r\n    // actually ends.\r\n    return () => clearTimeout(t);\r\n  }, [tab, ms, enabled]);\r\n\r\n  return loading;\r\n}\r\n"],"mappings":";;;;;;AAAA,SAASA,QAAQ,EAAEC,SAAS,QAAQ,OAAO;;AAE3C;AACA;AACA;AACA;AACA;AACA,OAAO,IAAMC,uBAAuB,GAAG,GAAG;;AAE1C;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,eAAe,SAASC,aAAaA,CACnCC,GAAoB,EAGX;EAAA,IAFTC,EAAU,GAAAC,SAAA,CAAAC,MAAA,QAAAD,SAAA,QAAAE,SAAA,GAAAF,SAAA,MAAGJ,uBAAuB;EAAA,IACpCO,OAAgB,GAAAH,SAAA,CAAAC,MAAA,QAAAD,SAAA,QAAAE,SAAA,GAAAF,SAAA,MAAG,KAAK;EAExB,IAAAI,SAAA,GAA8BV,QAAQ,CAAC,KAAK,CAAC;IAAAW,UAAA,GAAAC,cAAA,CAAAF,SAAA;IAAtCG,OAAO,GAAAF,UAAA;IAAEG,UAAU,GAAAH,UAAA;EAE1BV,SAAS,CAAC,YAAM;IACd,IAAI,CAACQ,OAAO,EAAE;MACZ;MACAK,UAAU,CAAC,KAAK,CAAC;MACjB,OAAON,SAAS;IAClB;IACA;IACA;IACA;IACA,IAAMO,CAAC,GAAGC,UAAU,CAAC;MAAA,OAAMF,UAAU,CAAC,IAAI,CAAC;IAAA,GAAET,EAAE,CAAC;;IAEhD;IACA;IACA;IACA;IACA;IACA;IACA,OAAO;MAAA,OAAMY,YAAY,CAACF,CAAC,CAAC;IAAA;EAC9B,CAAC,EAAE,CAACX,GAAG,EAAEC,EAAE,EAAEI,OAAO,CAAC,CAAC;EAEtB,OAAOI,OAAO;AAChB","ignoreList":[]}
+{"version":3,"file":"useTabLoading.js","names":["useState","useEffect","PERCEPTION_THRESHOLD_MS","useTabLoading","tab","ms","enabled","loading","setLoading","undefined","t","setTimeout","clearTimeout"],"sources":["../../../../src/lib/v2/hooks/useTabLoading.ts"],"sourcesContent":["import { useState, useEffect } from \"react\";\r\n\r\n/**\r\n * Charter R-Sk.1 — \"perception threshold\". Below this delay, a\r\n * skeleton would only flicker into view; above it, the user\r\n * perceives a stall and benefits from the visual cue.\r\n */\r\nexport const PERCEPTION_THRESHOLD_MS = 200;\r\n\r\n/**\r\n * useTabLoading — Portnet UI v2\r\n *\r\n * Skeleton-display gate that respects the 200 ms perception threshold.\r\n *\r\n * Charter R-Sk.1 — \"Skeleton displayed if loading > 200 ms; otherwise\r\n * nothing (perception)\". For fetches faster than 200 ms, this hook\r\n * never returns true — the user sees the data land directly with no\r\n * flicker. For fetches slower than 200 ms, the skeleton appears at\r\n * the threshold and stays until the fetch completes.\r\n *\r\n * Caller contract\r\n *   - Drive `enabled` from your real loading state (true while a\r\n *     fetch is in flight, false otherwise).\r\n *   - The hook returns true ONLY when `enabled` has been true for\r\n *     at least `ms` ms, and is reset to false the moment `enabled`\r\n *     flips back to false.\r\n *   - On tab change while still loading, the previous timer is\r\n *     cancelled and a fresh one scheduled — but the existing\r\n *     skeleton-visible state is PRESERVED (loading stays true if\r\n *     it was already true). Without this, fast tab swapping\r\n *     produced 200 ms blank flickers between consecutive skeletons.\r\n *\r\n * Example\r\n *   const [fetching, setFetching] = useState(false);\r\n *   useEffect(() => {\r\n *     setFetching(true);\r\n *     fetchTabData(tab).finally(() => setFetching(false));\r\n *   }, [tab]);\r\n *   const showSkeleton = useTabLoading(tab, PERCEPTION_THRESHOLD_MS, fetching);\r\n */\r\nexport default function useTabLoading(\r\n  tab: string | number,\r\n  ms: number = PERCEPTION_THRESHOLD_MS,\r\n  enabled: boolean = false\r\n): boolean {\r\n  const [loading, setLoading] = useState(false);\r\n\r\n  useEffect(() => {\r\n    if (!enabled) {\r\n      // Fetch finished (or never started) — drop any in-flight skeleton.\r\n      setLoading(false);\r\n      return undefined;\r\n    }\r\n    // R-Sk.1 — DELAY showing the skeleton until the perception threshold.\r\n    // If the fetch resolves before then, cleanup clears the timer and\r\n    // the skeleton never flickers in.\r\n    const t = setTimeout(() => setLoading(true), ms);\r\n\r\n    // CRITICAL: cleanup ONLY clears the pending timer. We do NOT reset\r\n    // `loading` to false here, otherwise tab changes while still\r\n    // fetching (both old and new tab loading) produced a visible\r\n    // 200 ms blank flicker between skeletons. The reset path is the\r\n    // `!enabled` branch above, which fires precisely when loading\r\n    // actually ends.\r\n    return () => clearTimeout(t);\r\n  }, [tab, ms, enabled]);\r\n\r\n  return loading;\r\n}\r\n"],"mappings":"AAAA,SAASA,QAAQ,EAAEC,SAAS,QAAQ,OAAO;;AAE3C;AACA;AACA;AACA;AACA;AACA,OAAO,MAAMC,uBAAuB,GAAG,GAAG;;AAE1C;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,eAAe,SAASC,aAAaA,CACnCC,GAAoB,EACpBC,EAAU,GAAGH,uBAAuB,EACpCI,OAAgB,GAAG,KAAK,EACf;EACT,MAAM,CAACC,OAAO,EAAEC,UAAU,CAAC,GAAGR,QAAQ,CAAC,KAAK,CAAC;EAE7CC,SAAS,CAAC,MAAM;IACd,IAAI,CAACK,OAAO,EAAE;MACZ;MACAE,UAAU,CAAC,KAAK,CAAC;MACjB,OAAOC,SAAS;IAClB;IACA;IACA;IACA;IACA,MAAMC,CAAC,GAAGC,UAAU,CAAC,MAAMH,UAAU,CAAC,IAAI,CAAC,EAAEH,EAAE,CAAC;;IAEhD;IACA;IACA;IACA;IACA;IACA;IACA,OAAO,MAAMO,YAAY,CAACF,CAAC,CAAC;EAC9B,CAAC,EAAE,CAACN,GAAG,EAAEC,EAAE,EAAEC,OAAO,CAAC,CAAC;EAEtB,OAAOC,OAAO;AAChB","ignoreList":[]}

package/dist/esm/v2/index.js

@@ -14,9 +14,8 @@
  * via babel-plugin-transform-define) to remove the manual-sync
  * footgun. Tracked as Batch 7 P3 follow-up (R19 migration backlog).
  */
-export var VERSION = "0.8.0-react19.1";
-import * as _tokens from "./tokens";
-export { _tokens as tokens };
+export const VERSION = "0.8.0-react19.1";
+export * as tokens from "./tokens";
 export { createPortnetTheme, getCssVariables, injectCssVariables, removeCssVariables } from "./theme";
 
 /**