@portnet/ui 6.0.0 → 6.0.1

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

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

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

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

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

@@ -0,0 +1,131 @@
+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";
+
+/**
+ * useFormCompletionProgress — derive required/overall completion
+ * percentages from current form values and a declared field list.
+ * Pure useMemo computation, no side effects.
+ *
+ * Usage:
+ *   import { v2 } from "@portnet/ui";
+ *   const { useFormCompletionProgress, ProgressBar } = v2;
+ *
+ *   const REQUIRED = ["typeAutorisation", "importer.id", "dateFinValidite"];
+ *   const OPTIONAL = ["referenceLicence", "region"];
+ *
+ *   const {
+ *     requiredPct,
+ *     overallPct,
+ *     isCompleteRequired,
+ *     missingRequired,
+ *     filledRequired,
+ *     totalRequired,
+ *   } = useFormCompletionProgress({
+ *     values: formik.values,
+ *     requiredFields: REQUIRED,
+ *     optionalFields: OPTIONAL,
+ *   });
+ *
+ *   <ProgressBar value={requiredPct} />
+ *   <span>{filledRequired}/{totalRequired} requis</span>
+ *
+ * Field paths support dot notation for nested values:
+ *   "importer.id"   → values.importer.id
+ *   "articles"      → values.articles (array length checked)
+ */
+
+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;
+    return {
+      requiredPct: requiredPct,
+      overallPct: overallPct,
+      filledRequired: filledRequired,
+      totalRequired: totalRequired,
+      filledOptional: filledOptional,
+      totalOptional: totalOptional,
+      isCompleteRequired: totalRequired === 0 || filledRequired === totalRequired,
+      missingRequired: missingRequired
+    };
+  }, [values, requiredFields, optionalFields]);
+}
+
+/* ── Helpers ───────────────────────────── */
+
+/**
+ * Resolves a dot-separated field path against a values object.
+ * Returns undefined on any missing intermediate.
+ *
+ *   getFieldValue({ a: { b: { c: 42 } } }, "a.b.c")    → 42
+ *   getFieldValue({ a: null }, "a.b.c")                → undefined
+ *   getFieldValue({}, "doesNotExist")                  → undefined
+ */
+function getFieldValue(obj, path) {
+  if (!obj || _typeof(obj) !== "object") return undefined;
+  if (!path) return undefined;
+  var parts = path.split(".");
+  var cur = obj;
+  var _iterator = _createForOfIteratorHelper(parts),
+    _step;
+  try {
+    for (_iterator.s(); !(_step = _iterator.n()).done;) {
+      var p = _step.value;
+      if (cur === null || cur === undefined) return undefined;
+      if (_typeof(cur) !== "object") return undefined;
+      cur = cur[p];
+    }
+  } catch (err) {
+    _iterator.e(err);
+  } finally {
+    _iterator.f();
+  }
+  return cur;
+}
+
+/**
+ * Centralised "is this value considered filled?" check.
+ *
+ * Considered EMPTY:
+ *   - null, undefined
+ *   - "" or whitespace-only string
+ *   - empty array []
+ *   - empty plain object {}
+ *
+ * Considered FILLED (intentional):
+ *   - 0, false (valid user input distinct from "unset")
+ *   - any non-empty array, object with keys, string, number
+ *   - Date instances with valid time
+ */
+function isFilled(v) {
+  if (v === null || v === undefined) return false;
+  if (typeof v === "string") return v.trim().length > 0;
+  if (Array.isArray(v)) return v.length > 0;
+  if (v instanceof Date) return !Number.isNaN(v.getTime());
+  if (_typeof(v) === "object") return Object.keys(v).length > 0;
+  // numbers, booleans
+  return true;
+}
+//# sourceMappingURL=useFormCompletionProgress.js.map

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

@@ -0,0 +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":[]}

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

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

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

@@ -0,0 +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":[]}

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

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

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

@@ -0,0 +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":[]}

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

@@ -0,0 +1,79 @@
+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";
+
+/**
+ * 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.
+ */
+export var PERCEPTION_THRESHOLD_MS = 200;
+
+/**
+ * useTabLoading — Portnet UI v2
+ *
+ * Skeleton-display gate that respects the 200 ms perception threshold.
+ *
+ * Charter R-Sk.1 — "Skeleton displayed if loading > 200 ms; otherwise
+ * nothing (perception)". For fetches faster than 200 ms, this hook
+ * never returns true — the user sees the data land directly with no
+ * flicker. For fetches slower than 200 ms, the skeleton appears at
+ * the threshold and stays until the fetch completes.
+ *
+ * Caller contract
+ *   - Drive `enabled` from your real loading state (true while a
+ *     fetch is in flight, false otherwise).
+ *   - The hook returns true ONLY when `enabled` has been true for
+ *     at least `ms` ms, and is reset to false the moment `enabled`
+ *     flips back to false.
+ *   - On tab change while still loading, the previous timer is
+ *     cancelled and a fresh one scheduled — but the existing
+ *     skeleton-visible state is PRESERVED (loading stays true if
+ *     it was already true). Without this, fast tab swapping
+ *     produced 200 ms blank flickers between consecutive skeletons.
+ *
+ * Example
+ *   const [fetching, setFetching] = useState(false);
+ *   useEffect(() => {
+ *     setFetching(true);
+ *     fetchTabData(tab).finally(() => setFetching(false));
+ *   }, [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 () {
+    if (!enabled) {
+      // Fetch finished (or never started) — drop any in-flight skeleton.
+      setLoading(false);
+      return undefined;
+    }
+    // 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);
+
+    // CRITICAL: cleanup ONLY clears the pending timer. We do NOT reset
+    // `loading` to false here, otherwise tab changes while still
+    // fetching (both old and new tab loading) produced a visible
+    // 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);
+    };
+  }, [tab, ms, enabled]);
+  return loading;
+}
+//# sourceMappingURL=useTabLoading.js.map

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

@@ -0,0 +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":[]}