@portnet/ui 6.0.2 → 6.0.3

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

@@ -0,0 +1 @@
+{"version":3,"file":"usePrefersReducedMotion.js","names":["_react","require","PREFERS_REDUCED_MOTION_QUERY","exports","getMediaQueryList","window","matchMedia","subscribe","onStoreChange","mql","undefined","addEventListener","removeEventListener","addListener","removeListener","getSnapshot","matches","getServerSnapshot","usePrefersReducedMotion","useSyncExternalStore"],"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,IAAAA,MAAA,GAAAC,OAAA;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAEA;AACO,MAAMC,4BAA4B,GAAAC,OAAA,CAAAD,4BAAA,GAAG,kCAAkC;;AAE9E;AACA;AACA;AACA;AACA;AACA,SAASE,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,CAACJ,4BAA4B,CAAC;AACxD;AAEA,SAASK,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;AAEe,SAASC,uBAAuBA,CAAA,EAAY;EACzD,OAAO,IAAAC,2BAAoB,EAACZ,SAAS,EAAEQ,WAAW,EAAEE,iBAAiB,CAAC;AACxE","ignoreList":[]}

package/dist/v2/hooks/useResolvedDensity.js

@@ -3,15 +3,9 @@
 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; }
+exports.default = useResolvedDensity;
+var _useDensity = _interopRequireDefault(require("./useDensity"));
+function _interopRequireDefault(e) { return e && e.__esModule ? e : { default: e }; }
 /**
  * useResolvedDensity — Portnet UI v2
  *
@@ -39,11 +33,9 @@ function _arrayWithHoles(arr) { if (Array.isArray(arr)) return arr; }
  *   <DataGrid density={effective} … />
  */
 
-var VALID = new Set(["comfortable", "compact"]);
+const VALID = new Set(["comfortable", "compact"]);
 function useResolvedDensity(propValue) {
-  var _useDensity = (0, _useDensity3["default"])(),
-    _useDensity2 = _slicedToArray(_useDensity, 1),
-    globalDensity = _useDensity2[0];
+  const [globalDensity] = (0, _useDensity.default)();
   if (propValue !== undefined && VALID.has(propValue)) return propValue;
   return globalDensity;
 }

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

@@ -1 +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":[]}
+{"version":3,"file":"useResolvedDensity.js","names":["_useDensity","_interopRequireDefault","require","e","__esModule","default","VALID","Set","useResolvedDensity","propValue","globalDensity","useDensity","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,IAAAA,WAAA,GAAAC,sBAAA,CAAAC,OAAA;AAAsC,SAAAD,uBAAAE,CAAA,WAAAA,CAAA,IAAAA,CAAA,CAAAC,UAAA,GAAAD,CAAA,KAAAE,OAAA,EAAAF,CAAA;AAEtC;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,MAAMG,KAAK,GAAG,IAAIC,GAAG,CAAC,CAAC,aAAa,EAAE,SAAS,CAAC,CAAC;AAElC,SAASC,kBAAkBA,CAACC,SAAuB,EAAe;EAC/E,MAAM,CAACC,aAAa,CAAC,GAAG,IAAAC,mBAAU,EAAC,CAAC;EACpC,IAAIF,SAAS,KAAKG,SAAS,IAAIN,KAAK,CAACO,GAAG,CAACJ,SAAS,CAAC,EAAE,OAAOA,SAAS;EACrE,OAAOC,aAAa;AACtB","ignoreList":[]}

package/dist/v2/hooks/useSortedRows.js

@@ -3,7 +3,7 @@
 Object.defineProperty(exports, "__esModule", {
   value: true
 });
-exports["default"] = useSortedRows;
+exports.default = useSortedRows;
 var _react = require("react");
 var _sort = require("../patterns/_sort");
 /**
@@ -29,10 +29,8 @@ var _sort = require("../patterns/_sort");
  * @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]);
+  return (0, _react.useMemo)(() => (0, _sort.applySort)(rows, sort, locale === undefined ? {} : {
+    locale
+  }), [rows, sort, locale]);
 }
 //# sourceMappingURL=useSortedRows.js.map

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

@@ -1 +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":[]}
+{"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,MAAM,IAAAC,eAAS,EAACJ,IAAI,EAAEC,IAAI,EAAEC,MAAM,KAAKG,SAAS,GAAG,CAAC,CAAC,GAAG;IAAEH;EAAO,CAAC,CAAC,EACnE,CAACF,IAAI,EAAEC,IAAI,EAAEC,MAAM,CACrB,CAAC;AACH","ignoreList":[]}

package/dist/v2/hooks/useTabLoading.js

@@ -4,20 +4,14 @@ Object.defineProperty(exports, "__esModule", {
   value: true
 });
 exports.PERCEPTION_THRESHOLD_MS = void 0;
-exports["default"] = useTabLoading;
+exports.default = useTabLoading;
 var _react = require("react");
-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; }
 /**
  * Charter R-Sk.1 — "perception threshold". Below this delay, a
  * skeleton would only flicker into view; above it, the user
  * perceives a stall and benefits from the visual cue.
  */
-var PERCEPTION_THRESHOLD_MS = exports.PERCEPTION_THRESHOLD_MS = 200;
+const PERCEPTION_THRESHOLD_MS = exports.PERCEPTION_THRESHOLD_MS = 200;
 
 /**
  * useTabLoading — Portnet UI v2
@@ -50,14 +44,9 @@ var PERCEPTION_THRESHOLD_MS = exports.PERCEPTION_THRESHOLD_MS = 200;
  *   }, [tab]);
  *   const showSkeleton = useTabLoading(tab, PERCEPTION_THRESHOLD_MS, fetching);
  */
-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 = (0, _react.useState)(false),
-    _useState2 = _slicedToArray(_useState, 2),
-    loading = _useState2[0],
-    setLoading = _useState2[1];
-  (0, _react.useEffect)(function () {
+function useTabLoading(tab, ms = PERCEPTION_THRESHOLD_MS, enabled = false) {
+  const [loading, setLoading] = (0, _react.useState)(false);
+  (0, _react.useEffect)(() => {
     if (!enabled) {
       // Fetch finished (or never started) — drop any in-flight skeleton.
       setLoading(false);
@@ -66,9 +55,7 @@ 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
@@ -76,9 +63,7 @@ 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/v2/hooks/useTabLoading.js.map

@@ -1 +1 @@
-{"version":3,"file":"useTabLoading.js","names":["_react","require","_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","PERCEPTION_THRESHOLD_MS","exports","useTabLoading","tab","ms","arguments","undefined","enabled","_useState","useState","_useState2","loading","setLoading","useEffect","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":"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","ignoreList":[]}
+{"version":3,"file":"useTabLoading.js","names":["_react","require","PERCEPTION_THRESHOLD_MS","exports","useTabLoading","tab","ms","enabled","loading","setLoading","useState","useEffect","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,IAAAA,MAAA,GAAAC,OAAA;AAEA;AACA;AACA;AACA;AACA;AACO,MAAMC,uBAAuB,GAAAC,OAAA,CAAAD,uBAAA,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;AACe,SAASE,aAAaA,CACnCC,GAAoB,EACpBC,EAAU,GAAGJ,uBAAuB,EACpCK,OAAgB,GAAG,KAAK,EACf;EACT,MAAM,CAACC,OAAO,EAAEC,UAAU,CAAC,GAAG,IAAAC,eAAQ,EAAC,KAAK,CAAC;EAE7C,IAAAC,gBAAS,EAAC,MAAM;IACd,IAAI,CAACJ,OAAO,EAAE;MACZ;MACAE,UAAU,CAAC,KAAK,CAAC;MACjB,OAAOG,SAAS;IAClB;IACA;IACA;IACA;IACA,MAAMC,CAAC,GAAGC,UAAU,CAAC,MAAML,UAAU,CAAC,IAAI,CAAC,EAAEH,EAAE,CAAC;;IAEhD;IACA;IACA;IACA;IACA;IACA;IACA,OAAO,MAAMS,YAAY,CAACF,CAAC,CAAC;EAC9B,CAAC,EAAE,CAACR,GAAG,EAAEC,EAAE,EAAEC,OAAO,CAAC,CAAC;EAEtB,OAAOC,OAAO;AAChB","ignoreList":[]}