@portnet/ui 6.0.2 → 6.0.3

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

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

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

@@ -35,7 +35,7 @@ type FormCompletionProgressOptions<Values> = {
     /** Field keys / dot-paths that are required. */
     requiredFields: string[];
     /** Field keys / dot-paths that are optional. */
-    optionalFields?: string[];
+    optionalFields?: string[] | undefined;
 };
 type FormCompletionProgress = {
     requiredPct: number;

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

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

package/dist/v2/hooks/useFormCompletionProgress.js

@@ -3,12 +3,8 @@
 Object.defineProperty(exports, "__esModule", {
   value: true
 });
-exports["default"] = useFormCompletionProgress;
+exports.default = useFormCompletionProgress;
 var _react = require("react");
-function _createForOfIteratorHelper(o, allowArrayLike) { var it = typeof Symbol !== "undefined" && o[Symbol.iterator] || o["@@iterator"]; if (!it) { if (Array.isArray(o) || (it = _unsupportedIterableToArray(o)) || allowArrayLike && o && typeof o.length === "number") { if (it) o = it; var i = 0; var F = function F() {}; return { s: F, n: function n() { if (i >= o.length) return { done: true }; return { done: false, value: o[i++] }; }, e: function e(_e) { throw _e; }, f: F }; } throw new TypeError("Invalid attempt to iterate non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method."); } var normalCompletion = true, didErr = false, err; return { s: function s() { it = it.call(o); }, n: function n() { var step = it.next(); normalCompletion = step.done; return step; }, e: function e(_e2) { didErr = true; err = _e2; }, f: function f() { try { if (!normalCompletion && it["return"] != null) it["return"](); } finally { if (didErr) throw err; } } }; }
-function _unsupportedIterableToArray(o, minLen) { if (!o) return; if (typeof o === "string") return _arrayLikeToArray(o, minLen); var n = Object.prototype.toString.call(o).slice(8, -1); if (n === "Object" && o.constructor) n = o.constructor.name; if (n === "Map" || n === "Set") return Array.from(o); if (n === "Arguments" || /^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(n)) return _arrayLikeToArray(o, minLen); }
-function _arrayLikeToArray(arr, len) { if (len == null || len > arr.length) len = arr.length; for (var i = 0, arr2 = new Array(len); i < len; i++) { arr2[i] = arr[i]; } return arr2; }
-function _typeof(obj) { "@babel/helpers - typeof"; return _typeof = "function" == typeof Symbol && "symbol" == typeof Symbol.iterator ? function (obj) { return typeof obj; } : function (obj) { return obj && "function" == typeof Symbol && obj.constructor === Symbol && obj !== Symbol.prototype ? "symbol" : typeof obj; }, _typeof(obj); }
 /**
  * useFormCompletionProgress — derive required/overall completion
  * percentages from current form values and a declared field list.
@@ -42,38 +38,32 @@ function _typeof(obj) { "@babel/helpers - typeof"; return _typeof = "function" =
  *   "articles"      → values.articles (array length checked)
  */
 
-function useFormCompletionProgress(_ref) {
-  var values = _ref.values,
-    requiredFields = _ref.requiredFields,
-    _ref$optionalFields = _ref.optionalFields,
-    optionalFields = _ref$optionalFields === void 0 ? [] : _ref$optionalFields;
-  return (0, _react.useMemo)(function () {
-    var required = Array.isArray(requiredFields) ? requiredFields : [];
-    var optional = Array.isArray(optionalFields) ? optionalFields : [];
-    var filledRequired = required.filter(function (path) {
-      return isFilled(getFieldValue(values, path));
-    }).length;
-    var filledOptional = optional.filter(function (path) {
-      return isFilled(getFieldValue(values, path));
-    }).length;
-    var missingRequired = required.filter(function (path) {
-      return !isFilled(getFieldValue(values, path));
-    });
-    var totalRequired = required.length;
-    var totalOptional = optional.length;
-    var requiredPct = totalRequired ? Math.round(filledRequired / totalRequired * 100) : 100;
-    var overallFilled = filledRequired + filledOptional;
-    var overallTotal = totalRequired + totalOptional;
-    var overallPct = overallTotal ? Math.round(overallFilled / overallTotal * 100) : 0;
+function useFormCompletionProgress({
+  values,
+  requiredFields,
+  optionalFields = []
+}) {
+  return (0, _react.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]);
 }
@@ -89,23 +79,14 @@ 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;
 }
@@ -129,7 +110,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/v2/hooks/useFormCompletionProgress.js.map

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

@@ -0,0 +1,25 @@
+export interface KeyboardShortcut {
+    /**
+     * Keys that trigger it, as `KeyboardEvent.key` values — so `"/"`, `"?"`,
+     * `"1"`, `"n"`. Case matters: `"n"` does not match `Shift+N`.
+     */
+    keys: readonly string[];
+    /**
+     * Receives the key that matched, so one descriptor can serve a range
+     * (`["1","2","3"]` → one handler that reads which was pressed).
+     */
+    onTrigger: (key: string) => void;
+    /**
+     * @default true — a shortcut gated on a permission stays DECLARED and
+     * inactive rather than being spliced out of the array, so the descriptor
+     * list keeps the same shape as the help dialogue's.
+     */
+    enabled?: boolean | undefined;
+}
+export interface UseKeyboardShortcutsOptions {
+    /** Suspends every shortcut at once. @default true */
+    enabled?: boolean | undefined;
+}
+export declare function useKeyboardShortcuts(shortcuts: readonly KeyboardShortcut[], { enabled }?: UseKeyboardShortcutsOptions): void;
+export default useKeyboardShortcuts;
+//# sourceMappingURL=useKeyboardShortcuts.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"useKeyboardShortcuts.d.ts","sourceRoot":"","sources":["../../../src/lib/v2/hooks/useKeyboardShortcuts.ts"],"names":[],"mappings":"AAoHA,MAAM,WAAW,gBAAgB;IAC/B;;;OAGG;IACH,IAAI,EAAE,SAAS,MAAM,EAAE,CAAC;IACxB;;;OAGG;IACH,SAAS,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;IACjC;;;;OAIG;IACH,OAAO,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;CAC/B;AAED,MAAM,WAAW,2BAA2B;IAC1C,qDAAqD;IACrD,OAAO,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;CAC/B;AAED,wBAAgB,oBAAoB,CAClC,SAAS,EAAE,SAAS,gBAAgB,EAAE,EACtC,EAAE,OAAc,EAAE,GAAE,2BAAgC,GACnD,IAAI,CA+BN;AAED,eAAe,oBAAoB,CAAC"}

package/dist/v2/hooks/useKeyboardShortcuts.js

@@ -0,0 +1,132 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.default = void 0;
+exports.useKeyboardShortcuts = useKeyboardShortcuts;
+var React = _interopRequireWildcard(require("react"));
+function _interopRequireWildcard(e, t) { if ("function" == typeof WeakMap) var r = new WeakMap(), n = new WeakMap(); return (_interopRequireWildcard = function (e, t) { if (!t && e && e.__esModule) return e; var o, i, f = { __proto__: null, default: e }; if (null === e || "object" != typeof e && "function" != typeof e) return f; if (o = t ? n : r) { if (o.has(e)) return o.get(e); o.set(e, f); } for (const t in e) "default" !== t && {}.hasOwnProperty.call(e, t) && ((i = (o = Object.defineProperty) && Object.getOwnPropertyDescriptor(e, t)) && (i.get || i.set) ? o(f, t, i) : f[t] = e[t]); return f; })(e, t); }
+/**
+ * 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";
+}
+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]);
+}
+var _default = exports.default = useKeyboardShortcuts;
+//# sourceMappingURL=useKeyboardShortcuts.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"useKeyboardShortcuts.js","names":["React","_interopRequireWildcard","require","e","t","WeakMap","r","n","__esModule","o","i","f","__proto__","default","has","get","set","hasOwnProperty","call","Object","defineProperty","getOwnPropertyDescriptor","INTERACTIVE_ROLES","Set","EDITABLE_TAGS","isBlockingTarget","node","document","body","Element","tag","tagName","HTMLElement","isContentEditable","role","getAttribute","tabIndex","isOverlayOpen","useKeyboardShortcuts","shortcuts","enabled","ref","useRef","useEffect","current","window","undefined","onKeyDown","metaKey","ctrlKey","altKey","activeElement","target","shortcut","keys","includes","key","preventDefault","onTrigger","addEventListener","removeEventListener","_default","exports"],"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/v2/hooks/usePrefersReducedMotion.d.ts

@@ -0,0 +1,56 @@
+/**
+ * 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 declare const PREFERS_REDUCED_MOTION_QUERY = "(prefers-reduced-motion: reduce)";
+export default function usePrefersReducedMotion(): boolean;
+//# sourceMappingURL=usePrefersReducedMotion.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"usePrefersReducedMotion.d.ts","sourceRoot":"","sources":["../../../src/lib/v2/hooks/usePrefersReducedMotion.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmDG;AAEH,0EAA0E;AAC1E,eAAO,MAAM,4BAA4B,qCAAqC,CAAC;AA2C/E,MAAM,CAAC,OAAO,UAAU,uBAAuB,IAAI,OAAO,CAEzD"}

package/dist/v2/hooks/usePrefersReducedMotion.js

@@ -0,0 +1,105 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.PREFERS_REDUCED_MOTION_QUERY = void 0;
+exports.default = usePrefersReducedMotion;
+var _react = require("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. */
+const PREFERS_REDUCED_MOTION_QUERY = exports.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;
+}
+function usePrefersReducedMotion() {
+  return (0, _react.useSyncExternalStore)(subscribe, getSnapshot, getServerSnapshot);
+}
+//# sourceMappingURL=usePrefersReducedMotion.js.map