@portnet/ui 6.0.1 → 6.0.3

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

@@ -1,10 +1,72 @@
 export { default as useFocusTrap } from "./useFocusTrap";
+/**
+ * Raccourcis clavier de page — l'autre moitié de `KeyboardShortcutsHelp`
+ * (gap G-48).
+ *
+ * La library possédait les DEUX BOUTS et pas l'écouteur entre eux : le
+ * dialogue « ? » qui LISTE les raccourcis, et l'attribut
+ * `data-v2-overlay-open` qu'elle POSE sur le `body` et que les raccourcis
+ * doivent respecter.
+ *
+ * Un hôte qui les câblait devait donc lire cet attribut lui-même — un module
+ * dépendant d'un détail d'implémentation du composant qu'il rend, et qui
+ * casserait EN SILENCE s'il était renommé : les raccourcis se mettraient à
+ * tirer derrière les modales ouvertes, ce que rien ne teste.
+ *
+ * Relevé depuis `addm-fe` (Area 14), dont les listings portaient un
+ * `searchInputRef` déclaré et transmis POUR le raccourci « / » — un câblage
+ * qui attendait un écouteur jamais écrit.
+ */
+export { default as useKeyboardShortcuts } from "./useKeyboardShortcuts";
 export { default as useTabLoading, PERCEPTION_THRESHOLD_MS } from "./useTabLoading";
 export { default as useDelayedFlag } from "./useDelayedFlag";
+/**
+ * Defers a CALL until the input settles — the companion `useDelayedFlag` is
+ * not: that one flips a boolean after a delay. Gap G-39; see the file header
+ * for the three defects the `lodash.debounce` era produced in every host.
+ */
+export { default as useDebouncedCallback } from "./useDebouncedCallback";
+/**
+ * Tracks the criteria ACTUALLY applied to a listing (gap G-43), so chips
+ * cannot announce a filter that is only being typed. Companion to
+ * `buildFilterChips`. Promoted from `refonte-frontend` (Area 5).
+ */
+export { default as useAppliedFilters } from "./useAppliedFilters";
+/**
+ * Runtime read of `prefers-reduced-motion` (gap G-49), for animation the
+ * library does not own — charts, canvases, imperative scroll, third-party
+ * widgets configured in JS. CSS cannot answer those, so every host wrote the
+ * same one-line snapshot helper, which never subscribed: turning the
+ * preference on left the animations running. See the file header.
+ */
+export { default as usePrefersReducedMotion } from "./usePrefersReducedMotion";
+export { PREFERS_REDUCED_MOTION_QUERY } from "./usePrefersReducedMotion";
 export { default as useDensity } from "./useDensity";
 export { default as useResolvedDensity } from "./useResolvedDensity";
 export { default as useSortedRows } from "./useSortedRows";
 export { default as useFormAutoSave } from "./useFormAutoSave";
 export { default as useFormCompletionProgress } from "./useFormCompletionProgress";
 export { default as useFocusFirstError, focusFieldByName } from "./useFocusFirstError";
+/**
+ * Déplace le focus sur le landmark principal à chaque changement de PAGE
+ * (gap G-60).
+ *
+ * Dans une application à page unique, naviguer ne déplace PAS le focus — le
+ * navigateur ne le fait qu'au chargement d'un vrai document. Le focus reste
+ * donc sur ce qui a été cliqué, ou tombe sur `document.body` quand cet élément
+ * est démonté par la navigation qu'il vient de déclencher. Depuis `body`, le
+ * Tab suivant repart du haut du NAVIGATEUR : l'utilisateur au clavier retraverse
+ * la barre d'adresse à chaque écran, et le lecteur d'écran n'annonce rien.
+ *
+ * Agnostique du routeur : l'hôte passe la clé qu'il veut surveiller — et doit
+ * passer le CHEMIN, pas `location.key`, sinon un changement de filtre dans la
+ * query string vole le focus au champ en cours de saisie.
+ *
+ * La library est le bon endroit même sans connaître de routeur : `AppMain` est
+ * la cible, et c'est lui qui porte le `tabIndex={-1}` qui rend la région
+ * focalisable. Relevé depuis `autorisation-admis-pour-conforme-fe` (Area 10),
+ * où archiver un dossier ferme un dialogue et navigue en arrière — le piège de
+ * focus restituant alors le focus à un bouton qui n'existe plus.
+ */
+export { default as useFocusOnRouteChange } from "./useFocusOnRouteChange";
 //# sourceMappingURL=index.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":["default","useFocusTrap","useTabLoading","PERCEPTION_THRESHOLD_MS","useDelayedFlag","useDensity","useResolvedDensity","useSortedRows","useFormAutoSave","useFormCompletionProgress","useFocusFirstError","focusFieldByName"],"sources":["../../../../src/lib/v2/hooks/index.ts"],"sourcesContent":["export { default as useFocusTrap } from \"./useFocusTrap\";\r\nexport {\r\n  default as useTabLoading,\r\n  PERCEPTION_THRESHOLD_MS,\r\n} from \"./useTabLoading\";\r\nexport { default as useDelayedFlag } from \"./useDelayedFlag\";\r\nexport { default as useDensity } from \"./useDensity\";\r\nexport { default as useResolvedDensity } from \"./useResolvedDensity\";\r\nexport { default as useSortedRows } from \"./useSortedRows\";\r\nexport { default as useFormAutoSave } from \"./useFormAutoSave\";\r\nexport { default as useFormCompletionProgress } from \"./useFormCompletionProgress\";\r\nexport {\r\n  default as useFocusFirstError,\r\n  focusFieldByName,\r\n} from \"./useFocusFirstError\";\r\nexport type {\r\n  FocusFieldOptions,\r\n  UseFocusFirstErrorOptions,\r\n} from \"./useFocusFirstError\";\r\n"],"mappings":"AAAA,SAASA,OAAO,IAAIC,YAAY,QAAQ,gBAAgB;AACxD,SACED,OAAO,IAAIE,aAAa,EACxBC,uBAAuB,QAClB,iBAAiB;AACxB,SAASH,OAAO,IAAII,cAAc,QAAQ,kBAAkB;AAC5D,SAASJ,OAAO,IAAIK,UAAU,QAAQ,cAAc;AACpD,SAASL,OAAO,IAAIM,kBAAkB,QAAQ,sBAAsB;AACpE,SAASN,OAAO,IAAIO,aAAa,QAAQ,iBAAiB;AAC1D,SAASP,OAAO,IAAIQ,eAAe,QAAQ,mBAAmB;AAC9D,SAASR,OAAO,IAAIS,yBAAyB,QAAQ,6BAA6B;AAClF,SACET,OAAO,IAAIU,kBAAkB,EAC7BC,gBAAgB,QACX,sBAAsB","ignoreList":[]}
+{"version":3,"file":"index.js","names":["default","useFocusTrap","useKeyboardShortcuts","useTabLoading","PERCEPTION_THRESHOLD_MS","useDelayedFlag","useDebouncedCallback","useAppliedFilters","usePrefersReducedMotion","PREFERS_REDUCED_MOTION_QUERY","useDensity","useResolvedDensity","useSortedRows","useFormAutoSave","useFormCompletionProgress","useFocusFirstError","focusFieldByName","useFocusOnRouteChange"],"sources":["../../../../src/lib/v2/hooks/index.ts"],"sourcesContent":["export { default as useFocusTrap } from \"./useFocusTrap\";\r\n/**\r\n * Raccourcis clavier de page — l'autre moitié de `KeyboardShortcutsHelp`\r\n * (gap G-48).\r\n *\r\n * La library possédait les DEUX BOUTS et pas l'écouteur entre eux : le\r\n * dialogue « ? » qui LISTE les raccourcis, et l'attribut\r\n * `data-v2-overlay-open` qu'elle POSE sur le `body` et que les raccourcis\r\n * doivent respecter.\r\n *\r\n * Un hôte qui les câblait devait donc lire cet attribut lui-même — un module\r\n * dépendant d'un détail d'implémentation du composant qu'il rend, et qui\r\n * casserait EN SILENCE s'il était renommé : les raccourcis se mettraient à\r\n * tirer derrière les modales ouvertes, ce que rien ne teste.\r\n *\r\n * Relevé depuis `addm-fe` (Area 14), dont les listings portaient un\r\n * `searchInputRef` déclaré et transmis POUR le raccourci « / » — un câblage\r\n * qui attendait un écouteur jamais écrit.\r\n */\r\nexport { default as useKeyboardShortcuts } from \"./useKeyboardShortcuts\";\r\nexport type {\r\n  KeyboardShortcut,\r\n  UseKeyboardShortcutsOptions,\r\n} from \"./useKeyboardShortcuts\";\r\nexport {\r\n  default as useTabLoading,\r\n  PERCEPTION_THRESHOLD_MS,\r\n} from \"./useTabLoading\";\r\nexport { default as useDelayedFlag } from \"./useDelayedFlag\";\r\n/**\r\n * Defers a CALL until the input settles — the companion `useDelayedFlag` is\r\n * not: that one flips a boolean after a delay. Gap G-39; see the file header\r\n * for the three defects the `lodash.debounce` era produced in every host.\r\n */\r\nexport { default as useDebouncedCallback } from \"./useDebouncedCallback\";\r\n/**\r\n * Tracks the criteria ACTUALLY applied to a listing (gap G-43), so chips\r\n * cannot announce a filter that is only being typed. Companion to\r\n * `buildFilterChips`. Promoted from `refonte-frontend` (Area 5).\r\n */\r\nexport {\r\n  default as useAppliedFilters,\r\n} from \"./useAppliedFilters\";\r\nexport type {\r\n  AppliedFiltersForm,\r\n  UseAppliedFiltersOptions,\r\n  UseAppliedFiltersResult,\r\n} from \"./useAppliedFilters\";\r\n/**\r\n * Runtime read of `prefers-reduced-motion` (gap G-49), for animation the\r\n * library does not own — charts, canvases, imperative scroll, third-party\r\n * widgets configured in JS. CSS cannot answer those, so every host wrote the\r\n * same one-line snapshot helper, which never subscribed: turning the\r\n * preference on left the animations running. See the file header.\r\n */\r\nexport { default as usePrefersReducedMotion } from \"./usePrefersReducedMotion\";\r\nexport { PREFERS_REDUCED_MOTION_QUERY } from \"./usePrefersReducedMotion\";\r\nexport { default as useDensity } from \"./useDensity\";\r\nexport { default as useResolvedDensity } from \"./useResolvedDensity\";\r\nexport { default as useSortedRows } from \"./useSortedRows\";\r\nexport { default as useFormAutoSave } from \"./useFormAutoSave\";\r\nexport { default as useFormCompletionProgress } from \"./useFormCompletionProgress\";\r\nexport {\r\n  default as useFocusFirstError,\r\n  focusFieldByName,\r\n} from \"./useFocusFirstError\";\r\nexport type {\r\n  FocusFieldOptions,\r\n  UseFocusFirstErrorOptions,\r\n} from \"./useFocusFirstError\";\r\n/**\r\n * Déplace le focus sur le landmark principal à chaque changement de PAGE\r\n * (gap G-60).\r\n *\r\n * Dans une application à page unique, naviguer ne déplace PAS le focus — le\r\n * navigateur ne le fait qu'au chargement d'un vrai document. Le focus reste\r\n * donc sur ce qui a été cliqué, ou tombe sur `document.body` quand cet élément\r\n * est démonté par la navigation qu'il vient de déclencher. Depuis `body`, le\r\n * Tab suivant repart du haut du NAVIGATEUR : l'utilisateur au clavier retraverse\r\n * la barre d'adresse à chaque écran, et le lecteur d'écran n'annonce rien.\r\n *\r\n * Agnostique du routeur : l'hôte passe la clé qu'il veut surveiller — et doit\r\n * passer le CHEMIN, pas `location.key`, sinon un changement de filtre dans la\r\n * query string vole le focus au champ en cours de saisie.\r\n *\r\n * La library est le bon endroit même sans connaître de routeur : `AppMain` est\r\n * la cible, et c'est lui qui porte le `tabIndex={-1}` qui rend la région\r\n * focalisable. Relevé depuis `autorisation-admis-pour-conforme-fe` (Area 10),\r\n * où archiver un dossier ferme un dialogue et navigue en arrière — le piège de\r\n * focus restituant alors le focus à un bouton qui n'existe plus.\r\n */\r\nexport { default as useFocusOnRouteChange } from \"./useFocusOnRouteChange\";\r\nexport type { UseFocusOnRouteChangeOptions } from \"./useFocusOnRouteChange\";\r\n"],"mappings":"AAAA,SAASA,OAAO,IAAIC,YAAY,QAAQ,gBAAgB;AACxD;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,SAASD,OAAO,IAAIE,oBAAoB,QAAQ,wBAAwB;AAKxE,SACEF,OAAO,IAAIG,aAAa,EACxBC,uBAAuB,QAClB,iBAAiB;AACxB,SAASJ,OAAO,IAAIK,cAAc,QAAQ,kBAAkB;AAC5D;AACA;AACA;AACA;AACA;AACA,SAASL,OAAO,IAAIM,oBAAoB,QAAQ,wBAAwB;AACxE;AACA;AACA;AACA;AACA;AACA,SACEN,OAAO,IAAIO,iBAAiB,QACvB,qBAAqB;AAM5B;AACA;AACA;AACA;AACA;AACA;AACA;AACA,SAASP,OAAO,IAAIQ,uBAAuB,QAAQ,2BAA2B;AAC9E,SAASC,4BAA4B,QAAQ,2BAA2B;AACxE,SAAST,OAAO,IAAIU,UAAU,QAAQ,cAAc;AACpD,SAASV,OAAO,IAAIW,kBAAkB,QAAQ,sBAAsB;AACpE,SAASX,OAAO,IAAIY,aAAa,QAAQ,iBAAiB;AAC1D,SAASZ,OAAO,IAAIa,eAAe,QAAQ,mBAAmB;AAC9D,SAASb,OAAO,IAAIc,yBAAyB,QAAQ,6BAA6B;AAClF,SACEd,OAAO,IAAIe,kBAAkB,EAC7BC,gBAAgB,QACX,sBAAsB;AAK7B;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,SAAShB,OAAO,IAAIiB,qBAAqB,QAAQ,yBAAyB","ignoreList":[]}

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

@@ -0,0 +1,112 @@
+import { useState } from "react";
+
+/**
+ * useAppliedFilters — tracks the criteria ACTUALLY applied to a listing
+ * (capability gap G-43).
+ *
+ * Companion to `buildFilterChips`: that one builds the chips, this one decides
+ * what they are allowed to show.
+ *
+ * ─────────────────────────────────────────────────────────────────────────────
+ * THE DEFECT IT PREVENTS — AND IT WAS SHIPPED TWICE BEFORE BEING UNDERSTOOD
+ *
+ * Chips CANNOT be built from live form values. `DataGridToolbar`'s search input
+ * writes into them ON EVERY KEYSTROKE, so a chip "Référence : ABC" appears
+ * while the user is still typing — announcing an active criterion that filters
+ * nothing. Active criteria are the ones filtering the DISPLAYED list.
+ *
+ * Two distinct states are therefore required, and the split is counter-intuitive
+ * enough that it was got wrong twice: form values track TYPING, this snapshot
+ * tracks APPLICATION.
+ *
+ * The mirror-image defect is just as real: a snapshot left full after a "clear
+ * criteria" shows chips for criteria that no longer filter anything. Both
+ * failures are one forgotten line away, in opposite directions — which is the
+ * argument for one hook rather than three lines per screen.
+ * ─────────────────────────────────────────────────────────────────────────────
+ *
+ * IT BUILDS NO PAYLOAD. Every screen has its own — key names, scope flags, page
+ * value — and `onRemove` hands the turn back with the REMAINING criteria. This
+ * hook knows only the cycle typing → application → removal.
+ *
+ * `setApplied`: THE THREE PATHS THAT BYPASS `apply()`. The snapshot is not only
+ * filled by a click on "Search". Three other gestures change what actually
+ * filters the list, and each one used to leave the chips lying:
+ *
+ *   1. RESTORING A SAVED FILTER. `SavedFiltersMenu` re-injects values and
+ *      payload: the list is filtered, the snapshot stays empty, so NO chip
+ *      appears. Observed on a real screen before this existed.
+ *   2. CLICKING A STATUS CHIP. Screens with `FilterTab` write the payload
+ *      directly — on purpose, to avoid the async `setFieldValue` followed by a
+ *      submit that reads the previous render's values. Without updating the
+ *      snapshot, a later chip removal rebuilds the payload from a stale
+ *      snapshot and LOSES the active status.
+ *   3. Any other direct payload write by the screen.
+ *
+ * Hence a function that SETS the snapshot, distinct from the one that freezes it
+ * from the form. The screen alone knows when what-filters has changed; the hook
+ * cannot guess it.
+ *
+ * Promoted from `refonte-frontend` (Area 5), where three listings consumed it.
+ *
+ * WHAT WAS NOT PROMOTED WITH IT. The original exported a ready-made
+ * `videAvecMiroirsNumeriques` helper — "id mirrors clear to `0`, everything
+ * else to `""`" — and a measurement of its call sites found NONE: the three
+ * hosts each passed their own inline strategy, and they disagree (`0` / `null`
+ * / `""`, per field). Codifying one of the three as the library's convention
+ * would have blessed a rule no host follows, and the disagreement is exactly
+ * why `emptyValueFor` is a parameter rather than a constant.
+ */
+
+/** What a search form must expose to this hook — Formik satisfies it. */
+
+/**
+ * Explicit return type: §Hooks requires it ("Every hook must expose explicit
+ * return types"), and inference left this surface implicit while four screens
+ * consumed it.
+ */
+
+export default function useAppliedFilters(form, options) {
+  const [appliedFilters, setAppliedFilters] = useState({});
+  const empty = options.emptyValueFor ?? (() => null);
+  return {
+    appliedFilters,
+    apply: () => {
+      setAppliedFilters({
+        ...form.values
+      });
+      options.onApply();
+    },
+    resetAll: () => {
+      setAppliedFilters({});
+      options.onReset();
+    },
+    /**
+     * Clears the fields and the snapshot, then hands the turn back so the
+     * screen can rebuild its payload.
+     *
+     * The payload is rebuilt from the AMPUTATED SNAPSHOT, never re-read from
+     * the form afterwards: `setFieldValue` is asynchronous, so reading values
+     * back would give the criteria as they were BEFORE the removal.
+     */
+    removeCriteria: keys => {
+      keys.forEach(key => {
+        void form.setFieldValue(key, empty(key));
+      });
+      const remaining = {
+        ...appliedFilters
+      };
+      keys.forEach(key => {
+        remaining[key] = empty(key);
+      });
+      setAppliedFilters(remaining);
+      options.onRemove(remaining);
+    },
+    setApplied: values => {
+      setAppliedFilters({
+        ...values
+      });
+    }
+  };
+}
+//# sourceMappingURL=useAppliedFilters.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"useAppliedFilters.js","names":["useState","useAppliedFilters","form","options","appliedFilters","setAppliedFilters","empty","emptyValueFor","apply","values","onApply","resetAll","onReset","removeCriteria","keys","forEach","key","setFieldValue","remaining","onRemove","setApplied"],"sources":["../../../../src/lib/v2/hooks/useAppliedFilters.ts"],"sourcesContent":["import { useState } from \"react\";\r\n\r\n/**\r\n * useAppliedFilters — tracks the criteria ACTUALLY applied to a listing\r\n * (capability gap G-43).\r\n *\r\n * Companion to `buildFilterChips`: that one builds the chips, this one decides\r\n * what they are allowed to show.\r\n *\r\n * ─────────────────────────────────────────────────────────────────────────────\r\n * THE DEFECT IT PREVENTS — AND IT WAS SHIPPED TWICE BEFORE BEING UNDERSTOOD\r\n *\r\n * Chips CANNOT be built from live form values. `DataGridToolbar`'s search input\r\n * writes into them ON EVERY KEYSTROKE, so a chip \"Référence : ABC\" appears\r\n * while the user is still typing — announcing an active criterion that filters\r\n * nothing. Active criteria are the ones filtering the DISPLAYED list.\r\n *\r\n * Two distinct states are therefore required, and the split is counter-intuitive\r\n * enough that it was got wrong twice: form values track TYPING, this snapshot\r\n * tracks APPLICATION.\r\n *\r\n * The mirror-image defect is just as real: a snapshot left full after a \"clear\r\n * criteria\" shows chips for criteria that no longer filter anything. Both\r\n * failures are one forgotten line away, in opposite directions — which is the\r\n * argument for one hook rather than three lines per screen.\r\n * ─────────────────────────────────────────────────────────────────────────────\r\n *\r\n * IT BUILDS NO PAYLOAD. Every screen has its own — key names, scope flags, page\r\n * value — and `onRemove` hands the turn back with the REMAINING criteria. This\r\n * hook knows only the cycle typing → application → removal.\r\n *\r\n * `setApplied`: THE THREE PATHS THAT BYPASS `apply()`. The snapshot is not only\r\n * filled by a click on \"Search\". Three other gestures change what actually\r\n * filters the list, and each one used to leave the chips lying:\r\n *\r\n *   1. RESTORING A SAVED FILTER. `SavedFiltersMenu` re-injects values and\r\n *      payload: the list is filtered, the snapshot stays empty, so NO chip\r\n *      appears. Observed on a real screen before this existed.\r\n *   2. CLICKING A STATUS CHIP. Screens with `FilterTab` write the payload\r\n *      directly — on purpose, to avoid the async `setFieldValue` followed by a\r\n *      submit that reads the previous render's values. Without updating the\r\n *      snapshot, a later chip removal rebuilds the payload from a stale\r\n *      snapshot and LOSES the active status.\r\n *   3. Any other direct payload write by the screen.\r\n *\r\n * Hence a function that SETS the snapshot, distinct from the one that freezes it\r\n * from the form. The screen alone knows when what-filters has changed; the hook\r\n * cannot guess it.\r\n *\r\n * Promoted from `refonte-frontend` (Area 5), where three listings consumed it.\r\n *\r\n * WHAT WAS NOT PROMOTED WITH IT. The original exported a ready-made\r\n * `videAvecMiroirsNumeriques` helper — \"id mirrors clear to `0`, everything\r\n * else to `\"\"`\" — and a measurement of its call sites found NONE: the three\r\n * hosts each passed their own inline strategy, and they disagree (`0` / `null`\r\n * / `\"\"`, per field). Codifying one of the three as the library's convention\r\n * would have blessed a rule no host follows, and the disagreement is exactly\r\n * why `emptyValueFor` is a parameter rather than a constant.\r\n */\r\n\r\n/** What a search form must expose to this hook — Formik satisfies it. */\r\nexport interface AppliedFiltersForm {\r\n  values: Record<string, unknown>;\r\n  setFieldValue: (\r\n    field: string,\r\n    value: unknown,\r\n    shouldValidate?: boolean\r\n  ) => unknown;\r\n}\r\n\r\nexport interface UseAppliedFiltersOptions {\r\n  /** Applies the current search (the screen's existing function). */\r\n  onApply: () => void;\r\n  /** Resets the search (the screen's existing function). */\r\n  onReset: () => void;\r\n  /**\r\n   * Rebuilds and re-runs the payload after a removal, from the REMAINING\r\n   * criteria. Only the screen knows the shape of its payload.\r\n   */\r\n  onRemove: (remaining: Record<string, unknown>) => void;\r\n  /**\r\n   * The value that means \"empty\" for a given field. Hosts disagree, and the\r\n   * disagreement is legitimate: some clear to `null`, others to `\"\"`, and\r\n   * reference-id mirrors to `0`. A convention imposed here would have broken\r\n   * half the payloads. @default `null`\r\n   */\r\n  emptyValueFor?: ((key: string) => unknown) | undefined;\r\n}\r\n\r\n/**\r\n * Explicit return type: §Hooks requires it (\"Every hook must expose explicit\r\n * return types\"), and inference left this surface implicit while four screens\r\n * consumed it.\r\n */\r\nexport interface UseAppliedFiltersResult {\r\n  /** Criteria ACTUALLY applied to the displayed list. */\r\n  appliedFilters: Record<string, unknown>;\r\n  /** Freezes the snapshot from the form, then runs the screen's search. */\r\n  apply: () => void;\r\n  /** Clears the snapshot, then resets the screen. */\r\n  resetAll: () => void;\r\n  /** Removes one or more criteria and hands the turn back to `onRemove`. */\r\n  removeCriteria: (keys: string[]) => void;\r\n  /**\r\n   * Sets the snapshot from values SUPPLIED by the screen, for the three paths\r\n   * that bypass `apply` — see the note above.\r\n   */\r\n  setApplied: (values: Record<string, unknown>) => void;\r\n}\r\n\r\nexport default function useAppliedFilters(\r\n  form: AppliedFiltersForm,\r\n  options: UseAppliedFiltersOptions\r\n): UseAppliedFiltersResult {\r\n  const [appliedFilters, setAppliedFilters] = useState<Record<string, unknown>>(\r\n    {}\r\n  );\r\n\r\n  const empty = options.emptyValueFor ?? (() => null);\r\n\r\n  return {\r\n    appliedFilters,\r\n\r\n    apply: () => {\r\n      setAppliedFilters({ ...form.values });\r\n      options.onApply();\r\n    },\r\n\r\n    resetAll: () => {\r\n      setAppliedFilters({});\r\n      options.onReset();\r\n    },\r\n\r\n    /**\r\n     * Clears the fields and the snapshot, then hands the turn back so the\r\n     * screen can rebuild its payload.\r\n     *\r\n     * The payload is rebuilt from the AMPUTATED SNAPSHOT, never re-read from\r\n     * the form afterwards: `setFieldValue` is asynchronous, so reading values\r\n     * back would give the criteria as they were BEFORE the removal.\r\n     */\r\n    removeCriteria: (keys: string[]) => {\r\n      keys.forEach((key) => {\r\n        void form.setFieldValue(key, empty(key));\r\n      });\r\n      const remaining: Record<string, unknown> = { ...appliedFilters };\r\n      keys.forEach((key) => {\r\n        remaining[key] = empty(key);\r\n      });\r\n      setAppliedFilters(remaining);\r\n      options.onRemove(remaining);\r\n    },\r\n\r\n    setApplied: (values: Record<string, unknown>) => {\r\n      setAppliedFilters({ ...values });\r\n    },\r\n  };\r\n}\r\n"],"mappings":"AAAA,SAASA,QAAQ,QAAQ,OAAO;;AAEhC;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAEA;;AA6BA;AACA;AACA;AACA;AACA;;AAiBA,eAAe,SAASC,iBAAiBA,CACvCC,IAAwB,EACxBC,OAAiC,EACR;EACzB,MAAM,CAACC,cAAc,EAAEC,iBAAiB,CAAC,GAAGL,QAAQ,CAClD,CAAC,CACH,CAAC;EAED,MAAMM,KAAK,GAAGH,OAAO,CAACI,aAAa,KAAK,MAAM,IAAI,CAAC;EAEnD,OAAO;IACLH,cAAc;IAEdI,KAAK,EAAEA,CAAA,KAAM;MACXH,iBAAiB,CAAC;QAAE,GAAGH,IAAI,CAACO;MAAO,CAAC,CAAC;MACrCN,OAAO,CAACO,OAAO,CAAC,CAAC;IACnB,CAAC;IAEDC,QAAQ,EAAEA,CAAA,KAAM;MACdN,iBAAiB,CAAC,CAAC,CAAC,CAAC;MACrBF,OAAO,CAACS,OAAO,CAAC,CAAC;IACnB,CAAC;IAED;AACJ;AACA;AACA;AACA;AACA;AACA;AACA;IACIC,cAAc,EAAGC,IAAc,IAAK;MAClCA,IAAI,CAACC,OAAO,CAAEC,GAAG,IAAK;QACpB,KAAKd,IAAI,CAACe,aAAa,CAACD,GAAG,EAAEV,KAAK,CAACU,GAAG,CAAC,CAAC;MAC1C,CAAC,CAAC;MACF,MAAME,SAAkC,GAAG;QAAE,GAAGd;MAAe,CAAC;MAChEU,IAAI,CAACC,OAAO,CAAEC,GAAG,IAAK;QACpBE,SAAS,CAACF,GAAG,CAAC,GAAGV,KAAK,CAACU,GAAG,CAAC;MAC7B,CAAC,CAAC;MACFX,iBAAiB,CAACa,SAAS,CAAC;MAC5Bf,OAAO,CAACgB,QAAQ,CAACD,SAAS,CAAC;IAC7B,CAAC;IAEDE,UAAU,EAAGX,MAA+B,IAAK;MAC/CJ,iBAAiB,CAAC;QAAE,GAAGI;MAAO,CAAC,CAAC;IAClC;EACF,CAAC;AACH","ignoreList":[]}

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

@@ -0,0 +1,82 @@
+import { useCallback, useEffect, useRef } from "react";
+
+/**
+ * useDebouncedCallback — defer a call until the input settles
+ * (capability gap G-39).
+ *
+ * ─────────────────────────────────────────────────────────────────────────────
+ * WHY THIS BELONGS IN THE LIBRARY
+ *
+ * §Search of the Platform Mandatory UX Patterns makes "instant filtering" a
+ * MUST on every listing, and R-Pp/§Performance forbid paying for it with a
+ * request per keystroke. Between those two rules sits a debounce — needed by
+ * every search field, every referential lookup, every quick-filter in the
+ * fleet — and the library shipped `useDelayedFlag` (a boolean that turns on
+ * after a delay) and `useTabLoading`, neither of which defers a CALL.
+ *
+ * So each host reached for `lodash.debounce`, and the three defects that
+ * followed were the same everywhere. Promoted from `refonte-frontend` (Area 5),
+ * where its own header recorded them:
+ *
+ *   1. NO TYPES on the package (TS7016), whose two usual workarounds are both
+ *      forbidden here — an extra dependency for ten lines, or a
+ *      `declare module` that makes the import `any`.
+ *   2. THE DEBOUNCE DID NOT DEBOUNCE. `debounce(...)` was called in the render
+ *      body, so every keystroke built a NEW instance with its own timer; the
+ *      previous one was orphaned but still fired. The result was not
+ *      coalescing — it was a delay applied to every character, i.e. one
+ *      request per keystroke, arriving late.
+ *   3. NOTHING CANCELLED THE TIMER ON UNMOUNT, so switching tab produced a
+ *      `setState` on an unmounted component.
+ *
+ * >>> DEFECT 2 IS WHY THIS IS A LIBRARY CONCERN AND NOT A SNIPPET. It is
+ * >>> invisible in review — the call site reads exactly like a correct one —
+ * >>> and invisible in use, because the feature still works. Only the network
+ * >>> panel shows it. A hook cannot be misused that way: the identity below is
+ * >>> stable by construction, so there is no per-render instance to orphan. <<<
+ * ─────────────────────────────────────────────────────────────────────────────
+ *
+ * WHY `action` GOES THROUGH A REF. Callers naturally pass an inline arrow
+ * (`(v) => { setPage(0); setSearch(v); }`), so its identity is new on every
+ * render. Holding it in a ref keeps the returned trigger STABLE — without
+ * which the trigger would change every render and defect 2 would be back, one
+ * level up — while still invoking the LATEST action rather than a stale
+ * closure.
+ *
+ * Only `delay` is a dependency of the returned callback. Changing it mid-flight
+ * does not reschedule a pending call; the next trigger uses the new delay.
+ *
+ * Usage:
+ *
+ *   const onSearchChange = useDebouncedCallback<string>((value) => {
+ *     setPage(0);
+ *     dispatch(search(value));
+ *   });
+ *   <Input onChange={(e) => onSearchChange(e.target.value)} />
+ *
+ * @param action what to do once the input has settled
+ * @param delay  milliseconds. Defaults to 500 — the value the promoted
+ *               implementation already shipped, kept deliberately: every
+ *               existing call site relies on the default, and lowering it here
+ *               would silently increase the request rate of nine listings
+ *               while looking like a tidy-up. R-1.1's 100 ms feedback promise
+ *               is met by the field's own visual state, not by this call.
+ */
+export default function useDebouncedCallback(action, delay = 500) {
+  const actionRef = useRef(action);
+  const timer = useRef(null);
+  useEffect(() => {
+    actionRef.current = action;
+  }, [action]);
+  useEffect(() => () => {
+    if (timer.current !== null) clearTimeout(timer.current);
+  }, []);
+  return useCallback(value => {
+    if (timer.current !== null) clearTimeout(timer.current);
+    timer.current = setTimeout(() => {
+      timer.current = null;
+      actionRef.current(value);
+    }, delay);
+  }, [delay]);
+}
+//# sourceMappingURL=useDebouncedCallback.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"useDebouncedCallback.js","names":["useCallback","useEffect","useRef","useDebouncedCallback","action","delay","actionRef","timer","current","clearTimeout","value","setTimeout"],"sources":["../../../../src/lib/v2/hooks/useDebouncedCallback.ts"],"sourcesContent":["import { useCallback, useEffect, useRef } from \"react\";\r\n\r\n/**\r\n * useDebouncedCallback — defer a call until the input settles\r\n * (capability gap G-39).\r\n *\r\n * ─────────────────────────────────────────────────────────────────────────────\r\n * WHY THIS BELONGS IN THE LIBRARY\r\n *\r\n * §Search of the Platform Mandatory UX Patterns makes \"instant filtering\" a\r\n * MUST on every listing, and R-Pp/§Performance forbid paying for it with a\r\n * request per keystroke. Between those two rules sits a debounce — needed by\r\n * every search field, every referential lookup, every quick-filter in the\r\n * fleet — and the library shipped `useDelayedFlag` (a boolean that turns on\r\n * after a delay) and `useTabLoading`, neither of which defers a CALL.\r\n *\r\n * So each host reached for `lodash.debounce`, and the three defects that\r\n * followed were the same everywhere. Promoted from `refonte-frontend` (Area 5),\r\n * where its own header recorded them:\r\n *\r\n *   1. NO TYPES on the package (TS7016), whose two usual workarounds are both\r\n *      forbidden here — an extra dependency for ten lines, or a\r\n *      `declare module` that makes the import `any`.\r\n *   2. THE DEBOUNCE DID NOT DEBOUNCE. `debounce(...)` was called in the render\r\n *      body, so every keystroke built a NEW instance with its own timer; the\r\n *      previous one was orphaned but still fired. The result was not\r\n *      coalescing — it was a delay applied to every character, i.e. one\r\n *      request per keystroke, arriving late.\r\n *   3. NOTHING CANCELLED THE TIMER ON UNMOUNT, so switching tab produced a\r\n *      `setState` on an unmounted component.\r\n *\r\n * >>> DEFECT 2 IS WHY THIS IS A LIBRARY CONCERN AND NOT A SNIPPET. It is\r\n * >>> invisible in review — the call site reads exactly like a correct one —\r\n * >>> and invisible in use, because the feature still works. Only the network\r\n * >>> panel shows it. A hook cannot be misused that way: the identity below is\r\n * >>> stable by construction, so there is no per-render instance to orphan. <<<\r\n * ─────────────────────────────────────────────────────────────────────────────\r\n *\r\n * WHY `action` GOES THROUGH A REF. Callers naturally pass an inline arrow\r\n * (`(v) => { setPage(0); setSearch(v); }`), so its identity is new on every\r\n * render. Holding it in a ref keeps the returned trigger STABLE — without\r\n * which the trigger would change every render and defect 2 would be back, one\r\n * level up — while still invoking the LATEST action rather than a stale\r\n * closure.\r\n *\r\n * Only `delay` is a dependency of the returned callback. Changing it mid-flight\r\n * does not reschedule a pending call; the next trigger uses the new delay.\r\n *\r\n * Usage:\r\n *\r\n *   const onSearchChange = useDebouncedCallback<string>((value) => {\r\n *     setPage(0);\r\n *     dispatch(search(value));\r\n *   });\r\n *   <Input onChange={(e) => onSearchChange(e.target.value)} />\r\n *\r\n * @param action what to do once the input has settled\r\n * @param delay  milliseconds. Defaults to 500 — the value the promoted\r\n *               implementation already shipped, kept deliberately: every\r\n *               existing call site relies on the default, and lowering it here\r\n *               would silently increase the request rate of nine listings\r\n *               while looking like a tidy-up. R-1.1's 100 ms feedback promise\r\n *               is met by the field's own visual state, not by this call.\r\n */\r\nexport default function useDebouncedCallback<T>(\r\n  action: (value: T) => void,\r\n  delay = 500\r\n): (value: T) => void {\r\n  const actionRef = useRef(action);\r\n  const timer = useRef<ReturnType<typeof setTimeout> | null>(null);\r\n\r\n  useEffect(() => {\r\n    actionRef.current = action;\r\n  }, [action]);\r\n\r\n  useEffect(\r\n    () => () => {\r\n      if (timer.current !== null) clearTimeout(timer.current);\r\n    },\r\n    []\r\n  );\r\n\r\n  return useCallback(\r\n    (value: T) => {\r\n      if (timer.current !== null) clearTimeout(timer.current);\r\n      timer.current = setTimeout(() => {\r\n        timer.current = null;\r\n        actionRef.current(value);\r\n      }, delay);\r\n    },\r\n    [delay]\r\n  );\r\n}\r\n"],"mappings":"AAAA,SAASA,WAAW,EAAEC,SAAS,EAAEC,MAAM,QAAQ,OAAO;;AAEtD;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,eAAe,SAASC,oBAAoBA,CAC1CC,MAA0B,EAC1BC,KAAK,GAAG,GAAG,EACS;EACpB,MAAMC,SAAS,GAAGJ,MAAM,CAACE,MAAM,CAAC;EAChC,MAAMG,KAAK,GAAGL,MAAM,CAAuC,IAAI,CAAC;EAEhED,SAAS,CAAC,MAAM;IACdK,SAAS,CAACE,OAAO,GAAGJ,MAAM;EAC5B,CAAC,EAAE,CAACA,MAAM,CAAC,CAAC;EAEZH,SAAS,CACP,MAAM,MAAM;IACV,IAAIM,KAAK,CAACC,OAAO,KAAK,IAAI,EAAEC,YAAY,CAACF,KAAK,CAACC,OAAO,CAAC;EACzD,CAAC,EACD,EACF,CAAC;EAED,OAAOR,WAAW,CACfU,KAAQ,IAAK;IACZ,IAAIH,KAAK,CAACC,OAAO,KAAK,IAAI,EAAEC,YAAY,CAACF,KAAK,CAACC,OAAO,CAAC;IACvDD,KAAK,CAACC,OAAO,GAAGG,UAAU,CAAC,MAAM;MAC/BJ,KAAK,CAACC,OAAO,GAAG,IAAI;MACpBF,SAAS,CAACE,OAAO,CAACE,KAAK,CAAC;IAC1B,CAAC,EAAEL,KAAK,CAAC;EACX,CAAC,EACD,CAACA,KAAK,CACR,CAAC;AACH","ignoreList":[]}

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

@@ -1,9 +1,3 @@
-function _slicedToArray(arr, i) { return _arrayWithHoles(arr) || _iterableToArrayLimit(arr, i) || _unsupportedIterableToArray(arr, i) || _nonIterableRest(); }
-function _nonIterableRest() { throw new TypeError("Invalid attempt to destructure non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method."); }
-function _unsupportedIterableToArray(o, minLen) { if (!o) return; if (typeof o === "string") return _arrayLikeToArray(o, minLen); var n = Object.prototype.toString.call(o).slice(8, -1); if (n === "Object" && o.constructor) n = o.constructor.name; if (n === "Map" || n === "Set") return Array.from(o); if (n === "Arguments" || /^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(n)) return _arrayLikeToArray(o, minLen); }
-function _arrayLikeToArray(arr, len) { if (len == null || len > arr.length) len = arr.length; for (var i = 0, arr2 = new Array(len); i < len; i++) { arr2[i] = arr[i]; } return arr2; }
-function _iterableToArrayLimit(arr, i) { var _i = null == arr ? null : "undefined" != typeof Symbol && arr[Symbol.iterator] || arr["@@iterator"]; if (null != _i) { var _s, _e, _x, _r, _arr = [], _n = !0, _d = !1; try { if (_x = (_i = _i.call(arr)).next, 0 === i) { if (Object(_i) !== _i) return; _n = !1; } else for (; !(_n = (_s = _x.call(_i)).done) && (_arr.push(_s.value), _arr.length !== i); _n = !0) { ; } } catch (err) { _d = !0, _e = err; } finally { try { if (!_n && null != _i["return"] && (_r = _i["return"](), Object(_r) !== _r)) return; } finally { if (_d) throw _e; } } return _arr; } }
-function _arrayWithHoles(arr) { if (Array.isArray(arr)) return arr; }
 import { useState, useEffect } from "react";
 import { PERCEPTION_THRESHOLD_MS } from "./useTabLoading";
 
@@ -27,13 +21,9 @@ import { PERCEPTION_THRESHOLD_MS } from "./useTabLoading";
  *     (preserves across tab swap to avoid flicker between two
  *     consecutive skeletons), use `useTabLoading`.
  */
-export default function useDelayedFlag(active) {
-  var delayMs = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : PERCEPTION_THRESHOLD_MS;
-  var _useState = useState(false),
-    _useState2 = _slicedToArray(_useState, 2),
-    delayed = _useState2[0],
-    setDelayed = _useState2[1];
-  useEffect(function () {
+export default function useDelayedFlag(active, delayMs = PERCEPTION_THRESHOLD_MS) {
+  const [delayed, setDelayed] = useState(false);
+  useEffect(() => {
     if (!active) {
       // Inactive — drop any in-flight delayed flag immediately so
       // the consumer can render the success path without waiting.
@@ -43,12 +33,8 @@ export default function useDelayedFlag(active) {
     // Schedule the flag flip. If `active` resolves false before the
     // timer fires, cleanup clears the timer and the flag never goes
     // true (the perception-threshold contract).
-    var t = setTimeout(function () {
-      return setDelayed(true);
-    }, delayMs);
-    return function () {
-      return clearTimeout(t);
-    };
+    const t = setTimeout(() => setDelayed(true), delayMs);
+    return () => clearTimeout(t);
   }, [active, delayMs]);
   return delayed;
 }

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

@@ -1 +1 @@
-{"version":3,"file":"useDelayedFlag.js","names":["useState","useEffect","PERCEPTION_THRESHOLD_MS","useDelayedFlag","active","delayMs","arguments","length","undefined","_useState","_useState2","_slicedToArray","delayed","setDelayed","t","setTimeout","clearTimeout"],"sources":["../../../../src/lib/v2/hooks/useDelayedFlag.ts"],"sourcesContent":["import { useState, useEffect } from \"react\";\r\nimport { PERCEPTION_THRESHOLD_MS } from \"./useTabLoading\";\r\n\r\n/**\r\n * useDelayedFlag — Portnet UI v2\r\n *\r\n * Returns `true` only when `active` has been continuously true for\r\n * at least `delayMs` ms. Resets to `false` the moment `active` flips\r\n * back to false. Charter R-Sk.1 — perception threshold.\r\n *\r\n *   const showSkeleton = useDelayedFlag(loading);\r\n *   if (showSkeleton) return <Skeleton />;\r\n *   if (loading)     return null;        // sub-threshold, render nothing\r\n *   return <Data rows={rows} />;\r\n *\r\n * Use when:\r\n *   - You want to delay showing a loading affordance (skeleton,\r\n *     spinner overlay, \"Loading…\" text) until the user actually\r\n *     perceives the wait.\r\n *   - The flag has no tab/key semantics. For tab-aware loading\r\n *     (preserves across tab swap to avoid flicker between two\r\n *     consecutive skeletons), use `useTabLoading`.\r\n */\r\nexport default function useDelayedFlag(\r\n  active: boolean,\r\n  delayMs: number = PERCEPTION_THRESHOLD_MS\r\n): boolean {\r\n  const [delayed, setDelayed] = useState(false);\r\n\r\n  useEffect(() => {\r\n    if (!active) {\r\n      // Inactive — drop any in-flight delayed flag immediately so\r\n      // the consumer can render the success path without waiting.\r\n      setDelayed(false);\r\n      return undefined;\r\n    }\r\n    // Schedule the flag flip. If `active` resolves false before the\r\n    // timer fires, cleanup clears the timer and the flag never goes\r\n    // true (the perception-threshold contract).\r\n    const t = setTimeout(() => setDelayed(true), delayMs);\r\n    return () => clearTimeout(t);\r\n  }, [active, delayMs]);\r\n\r\n  return delayed;\r\n}\r\n"],"mappings":";;;;;;AAAA,SAASA,QAAQ,EAAEC,SAAS,QAAQ,OAAO;AAC3C,SAASC,uBAAuB,QAAQ,iBAAiB;;AAEzD;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,eAAe,SAASC,cAAcA,CACpCC,MAAe,EAEN;EAAA,IADTC,OAAe,GAAAC,SAAA,CAAAC,MAAA,QAAAD,SAAA,QAAAE,SAAA,GAAAF,SAAA,MAAGJ,uBAAuB;EAEzC,IAAAO,SAAA,GAA8BT,QAAQ,CAAC,KAAK,CAAC;IAAAU,UAAA,GAAAC,cAAA,CAAAF,SAAA;IAAtCG,OAAO,GAAAF,UAAA;IAAEG,UAAU,GAAAH,UAAA;EAE1BT,SAAS,CAAC,YAAM;IACd,IAAI,CAACG,MAAM,EAAE;MACX;MACA;MACAS,UAAU,CAAC,KAAK,CAAC;MACjB,OAAOL,SAAS;IAClB;IACA;IACA;IACA;IACA,IAAMM,CAAC,GAAGC,UAAU,CAAC;MAAA,OAAMF,UAAU,CAAC,IAAI,CAAC;IAAA,GAAER,OAAO,CAAC;IACrD,OAAO;MAAA,OAAMW,YAAY,CAACF,CAAC,CAAC;IAAA;EAC9B,CAAC,EAAE,CAACV,MAAM,EAAEC,OAAO,CAAC,CAAC;EAErB,OAAOO,OAAO;AAChB","ignoreList":[]}
+{"version":3,"file":"useDelayedFlag.js","names":["useState","useEffect","PERCEPTION_THRESHOLD_MS","useDelayedFlag","active","delayMs","delayed","setDelayed","undefined","t","setTimeout","clearTimeout"],"sources":["../../../../src/lib/v2/hooks/useDelayedFlag.ts"],"sourcesContent":["import { useState, useEffect } from \"react\";\r\nimport { PERCEPTION_THRESHOLD_MS } from \"./useTabLoading\";\r\n\r\n/**\r\n * useDelayedFlag — Portnet UI v2\r\n *\r\n * Returns `true` only when `active` has been continuously true for\r\n * at least `delayMs` ms. Resets to `false` the moment `active` flips\r\n * back to false. Charter R-Sk.1 — perception threshold.\r\n *\r\n *   const showSkeleton = useDelayedFlag(loading);\r\n *   if (showSkeleton) return <Skeleton />;\r\n *   if (loading)     return null;        // sub-threshold, render nothing\r\n *   return <Data rows={rows} />;\r\n *\r\n * Use when:\r\n *   - You want to delay showing a loading affordance (skeleton,\r\n *     spinner overlay, \"Loading…\" text) until the user actually\r\n *     perceives the wait.\r\n *   - The flag has no tab/key semantics. For tab-aware loading\r\n *     (preserves across tab swap to avoid flicker between two\r\n *     consecutive skeletons), use `useTabLoading`.\r\n */\r\nexport default function useDelayedFlag(\r\n  active: boolean,\r\n  delayMs: number = PERCEPTION_THRESHOLD_MS\r\n): boolean {\r\n  const [delayed, setDelayed] = useState(false);\r\n\r\n  useEffect(() => {\r\n    if (!active) {\r\n      // Inactive — drop any in-flight delayed flag immediately so\r\n      // the consumer can render the success path without waiting.\r\n      setDelayed(false);\r\n      return undefined;\r\n    }\r\n    // Schedule the flag flip. If `active` resolves false before the\r\n    // timer fires, cleanup clears the timer and the flag never goes\r\n    // true (the perception-threshold contract).\r\n    const t = setTimeout(() => setDelayed(true), delayMs);\r\n    return () => clearTimeout(t);\r\n  }, [active, delayMs]);\r\n\r\n  return delayed;\r\n}\r\n"],"mappings":"AAAA,SAASA,QAAQ,EAAEC,SAAS,QAAQ,OAAO;AAC3C,SAASC,uBAAuB,QAAQ,iBAAiB;;AAEzD;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,eAAe,SAASC,cAAcA,CACpCC,MAAe,EACfC,OAAe,GAAGH,uBAAuB,EAChC;EACT,MAAM,CAACI,OAAO,EAAEC,UAAU,CAAC,GAAGP,QAAQ,CAAC,KAAK,CAAC;EAE7CC,SAAS,CAAC,MAAM;IACd,IAAI,CAACG,MAAM,EAAE;MACX;MACA;MACAG,UAAU,CAAC,KAAK,CAAC;MACjB,OAAOC,SAAS;IAClB;IACA;IACA;IACA;IACA,MAAMC,CAAC,GAAGC,UAAU,CAAC,MAAMH,UAAU,CAAC,IAAI,CAAC,EAAEF,OAAO,CAAC;IACrD,OAAO,MAAMM,YAAY,CAACF,CAAC,CAAC;EAC9B,CAAC,EAAE,CAACL,MAAM,EAAEC,OAAO,CAAC,CAAC;EAErB,OAAOC,OAAO;AAChB","ignoreList":[]}

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

@@ -20,10 +20,10 @@ import { useSyncExternalStore } from "react";
  *     storage interactions are guarded.
  */
 
-var STORAGE_KEY = "portnet-ui-density";
-var DEFAULT = "comfortable";
-var VALID = Object.freeze(["comfortable", "compact"]);
-var VALID_SET = new Set(VALID);
+const STORAGE_KEY = "portnet-ui-density";
+const DEFAULT = "comfortable";
+const VALID = Object.freeze(["comfortable", "compact"]);
+const VALID_SET = new Set(VALID);
 function isDensityPref(v) {
   return typeof v === "string" && VALID_SET.has(v);
 }
@@ -31,16 +31,16 @@ function isDensityPref(v) {
 /* ── Module-level store ───────────────────────────────── */
 
 /** Source of truth. Lazy-read from storage at module load on the client. */
-var memoryValue = readInitialValue();
+let memoryValue = readInitialValue();
 
 /** Active hook subscribers — notified on every value change. */
-var subscribers = new Set();
+const subscribers = new Set();
 function readInitialValue() {
   if (typeof window === "undefined") return DEFAULT;
   try {
-    var raw = window.localStorage.getItem(STORAGE_KEY);
+    const raw = window.localStorage.getItem(STORAGE_KEY);
     return isDensityPref(raw) ? raw : DEFAULT;
-  } catch (_unused) {
+  } catch {
     return DEFAULT;
   }
 }
@@ -55,7 +55,7 @@ applyToDom(memoryValue);
 /* Cross-tab sync. The `storage` event fires in OTHER tabs only —
  * the writing tab is informed via the in-memory subscribers path. */
 if (typeof window !== "undefined") {
-  window.addEventListener("storage", function (e) {
+  window.addEventListener("storage", e => {
     if (e.key !== STORAGE_KEY) return;
     if (!isDensityPref(e.newValue)) return;
     if (e.newValue === memoryValue) return;
@@ -68,16 +68,11 @@ if (typeof window !== "undefined") {
 function notify() {
   // Iterate a snapshot — a subscriber that unmounts during notify
   // would otherwise mutate the Set under iteration.
-  for (var _i = 0, _Array$from = Array.from(subscribers); _i < _Array$from.length; _i++) {
-    var cb = _Array$from[_i];
-    cb();
-  }
+  for (const cb of Array.from(subscribers)) cb();
 }
 function subscribe(callback) {
   subscribers.add(callback);
-  return function () {
-    return subscribers["delete"](callback);
-  };
+  return () => subscribers.delete(callback);
 }
 function getSnapshot() {
   return memoryValue;
@@ -104,6 +99,7 @@ function setDensityValue(value) {
     } catch (err) {
       // Quota, private mode, or sandboxed iframe — preference is
       // applied for this session but won't persist. Surface in dev.
+      // eslint-disable-next-line no-console
       if (typeof console !== "undefined" && console.warn) {
         // eslint-disable-next-line no-console
         console.warn("[@portnet/ui v2] useDensity: localStorage write failed", err);
@@ -113,7 +109,7 @@ function setDensityValue(value) {
   notify();
 }
 export default function useDensity() {
-  var density = useSyncExternalStore(subscribe, getSnapshot, getServerSnapshot);
+  const density = useSyncExternalStore(subscribe, getSnapshot, getServerSnapshot);
   return [density, setDensityValue];
 }
 //# sourceMappingURL=useDensity.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"useDensity.js","names":["useSyncExternalStore","STORAGE_KEY","DEFAULT","VALID","Object","freeze","VALID_SET","Set","isDensityPref","v","has","memoryValue","readInitialValue","subscribers","window","raw","localStorage","getItem","_unused","applyToDom","value","document","documentElement","dataset","addEventListener","e","key","newValue","notify","_i","_Array$from","Array","from","length","cb","subscribe","callback","add","getSnapshot","getServerSnapshot","setDensityValue","setItem","err","console","warn","useDensity","density"],"sources":["../../../../src/lib/v2/hooks/useDensity.ts"],"sourcesContent":["import { useSyncExternalStore } from \"react\";\r\n\r\n/**\r\n * useDensity — Portnet UI v2\r\n *\r\n * Reads / writes the user's density preference (charter R-DG.11).\r\n * Applies it as `data-density` on <html> so all density-aware\r\n * tokens cascade.\r\n *\r\n *   const [density, setDensity] = useDensity();\r\n *   <button onClick={() => setDensity(density === \"compact\" ? \"comfortable\" : \"compact\")} />\r\n *\r\n * Synchronisation guarantees\r\n *   - Multi-instance same-tab: every useDensity() consumer sees\r\n *     the same value at all times. Implemented via a module-level\r\n *     subscriber set fed by useSyncExternalStore.\r\n *   - Cross-tab: a `storage` event listener at module load\r\n *     propagates updates from sibling tabs sharing the origin.\r\n *   - SSR-safe: server snapshot returns the DEFAULT; all DOM and\r\n *     storage interactions are guarded.\r\n */\r\n\r\ntype DensityPref = \"comfortable\" | \"compact\";\r\n\r\nconst STORAGE_KEY = \"portnet-ui-density\";\r\nconst DEFAULT: DensityPref = \"comfortable\";\r\nconst VALID = Object.freeze([\"comfortable\", \"compact\"]);\r\nconst VALID_SET = new Set<string>(VALID);\r\n\r\nfunction isDensityPref(v: unknown): v is DensityPref {\r\n  return typeof v === \"string\" && VALID_SET.has(v);\r\n}\r\n\r\n/* ── Module-level store ───────────────────────────────── */\r\n\r\n/** Source of truth. Lazy-read from storage at module load on the client. */\r\nlet memoryValue: DensityPref = readInitialValue();\r\n\r\n/** Active hook subscribers — notified on every value change. */\r\nconst subscribers = new Set<() => void>();\r\n\r\nfunction readInitialValue(): DensityPref {\r\n  if (typeof window === \"undefined\") return DEFAULT;\r\n  try {\r\n    const raw = window.localStorage.getItem(STORAGE_KEY);\r\n    return isDensityPref(raw) ? raw : DEFAULT;\r\n  } catch {\r\n    return DEFAULT;\r\n  }\r\n}\r\n\r\nfunction applyToDom(value: DensityPref): void {\r\n  if (typeof document === \"undefined\") return;\r\n  document.documentElement.dataset[\"density\"] = value;\r\n}\r\n\r\n/** Apply the initial value to the DOM at module load (client-side). */\r\napplyToDom(memoryValue);\r\n\r\n/* Cross-tab sync. The `storage` event fires in OTHER tabs only —\r\n * the writing tab is informed via the in-memory subscribers path. */\r\nif (typeof window !== \"undefined\") {\r\n  window.addEventListener(\"storage\", (e) => {\r\n    if (e.key !== STORAGE_KEY) return;\r\n    if (!isDensityPref(e.newValue)) return;\r\n    if (e.newValue === memoryValue) return;\r\n    memoryValue = e.newValue;\r\n    applyToDom(memoryValue);\r\n    // No storage write here — the originating tab already wrote.\r\n    notify();\r\n  });\r\n}\r\n\r\nfunction notify(): void {\r\n  // Iterate a snapshot — a subscriber that unmounts during notify\r\n  // would otherwise mutate the Set under iteration.\r\n  for (const cb of Array.from(subscribers)) cb();\r\n}\r\n\r\nfunction subscribe(callback: () => void): () => void {\r\n  subscribers.add(callback);\r\n  return () => subscribers.delete(callback);\r\n}\r\n\r\nfunction getSnapshot(): DensityPref {\r\n  return memoryValue;\r\n}\r\n\r\nfunction getServerSnapshot(): DensityPref {\r\n  return DEFAULT;\r\n}\r\n\r\n/* ── Setter (module-level so identity is stable across renders) ── */\r\n\r\n/**\r\n * Set the density preference. Ignores invalid values silently\r\n * (consumer-supplied data sanitation is not this hook's job) and\r\n * short-circuits when the value is unchanged.\r\n */\r\nfunction setDensityValue(value: DensityPref): void {\r\n  if (!VALID_SET.has(value)) return;\r\n  if (value === memoryValue) return;\r\n  memoryValue = value;\r\n  applyToDom(value);\r\n  if (typeof window !== \"undefined\") {\r\n    try {\r\n      window.localStorage.setItem(STORAGE_KEY, value);\r\n    } catch (err) {\r\n      // Quota, private mode, or sandboxed iframe — preference is\r\n      // applied for this session but won't persist. Surface in dev.\r\n      if (typeof console !== \"undefined\" && console.warn) {\r\n        // eslint-disable-next-line no-console\r\n        console.warn(\"[@portnet/ui v2] useDensity: localStorage write failed\", err);\r\n      }\r\n    }\r\n  }\r\n  notify();\r\n}\r\n\r\nexport default function useDensity(): [DensityPref, (value: DensityPref) => void] {\r\n  const density = useSyncExternalStore(subscribe, getSnapshot, getServerSnapshot);\r\n  return [density, setDensityValue];\r\n}\r\n"],"mappings":"AAAA,SAASA,oBAAoB,QAAQ,OAAO;;AAE5C;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAIA,IAAMC,WAAW,GAAG,oBAAoB;AACxC,IAAMC,OAAoB,GAAG,aAAa;AAC1C,IAAMC,KAAK,GAAGC,MAAM,CAACC,MAAM,CAAC,CAAC,aAAa,EAAE,SAAS,CAAC,CAAC;AACvD,IAAMC,SAAS,GAAG,IAAIC,GAAG,CAASJ,KAAK,CAAC;AAExC,SAASK,aAAaA,CAACC,CAAU,EAAoB;EACnD,OAAO,OAAOA,CAAC,KAAK,QAAQ,IAAIH,SAAS,CAACI,GAAG,CAACD,CAAC,CAAC;AAClD;;AAEA;;AAEA;AACA,IAAIE,WAAwB,GAAGC,gBAAgB,CAAC,CAAC;;AAEjD;AACA,IAAMC,WAAW,GAAG,IAAIN,GAAG,CAAa,CAAC;AAEzC,SAASK,gBAAgBA,CAAA,EAAgB;EACvC,IAAI,OAAOE,MAAM,KAAK,WAAW,EAAE,OAAOZ,OAAO;EACjD,IAAI;IACF,IAAMa,GAAG,GAAGD,MAAM,CAACE,YAAY,CAACC,OAAO,CAAChB,WAAW,CAAC;IACpD,OAAOO,aAAa,CAACO,GAAG,CAAC,GAAGA,GAAG,GAAGb,OAAO;EAC3C,CAAC,CAAC,OAAAgB,OAAA,EAAM;IACN,OAAOhB,OAAO;EAChB;AACF;AAEA,SAASiB,UAAUA,CAACC,KAAkB,EAAQ;EAC5C,IAAI,OAAOC,QAAQ,KAAK,WAAW,EAAE;EACrCA,QAAQ,CAACC,eAAe,CAACC,OAAO,CAAC,SAAS,CAAC,GAAGH,KAAK;AACrD;;AAEA;AACAD,UAAU,CAACR,WAAW,CAAC;;AAEvB;AACA;AACA,IAAI,OAAOG,MAAM,KAAK,WAAW,EAAE;EACjCA,MAAM,CAACU,gBAAgB,CAAC,SAAS,EAAE,UAACC,CAAC,EAAK;IACxC,IAAIA,CAAC,CAACC,GAAG,KAAKzB,WAAW,EAAE;IAC3B,IAAI,CAACO,aAAa,CAACiB,CAAC,CAACE,QAAQ,CAAC,EAAE;IAChC,IAAIF,CAAC,CAACE,QAAQ,KAAKhB,WAAW,EAAE;IAChCA,WAAW,GAAGc,CAAC,CAACE,QAAQ;IACxBR,UAAU,CAACR,WAAW,CAAC;IACvB;IACAiB,MAAM,CAAC,CAAC;EACV,CAAC,CAAC;AACJ;AAEA,SAASA,MAAMA,CAAA,EAAS;EACtB;EACA;EACA,SAAAC,EAAA,MAAAC,WAAA,GAAiBC,KAAK,CAACC,IAAI,CAACnB,WAAW,CAAC,EAAAgB,EAAA,GAAAC,WAAA,CAAAG,MAAA,EAAAJ,EAAA;IAAnC,IAAMK,EAAE,GAAAJ,WAAA,CAAAD,EAAA;IAA6BK,EAAE,CAAC,CAAC;EAAC;AACjD;AAEA,SAASC,SAASA,CAACC,QAAoB,EAAc;EACnDvB,WAAW,CAACwB,GAAG,CAACD,QAAQ,CAAC;EACzB,OAAO;IAAA,OAAMvB,WAAW,UAAO,CAACuB,QAAQ,CAAC;EAAA;AAC3C;AAEA,SAASE,WAAWA,CAAA,EAAgB;EAClC,OAAO3B,WAAW;AACpB;AAEA,SAAS4B,iBAAiBA,CAAA,EAAgB;EACxC,OAAOrC,OAAO;AAChB;;AAEA;;AAEA;AACA;AACA;AACA;AACA;AACA,SAASsC,eAAeA,CAACpB,KAAkB,EAAQ;EACjD,IAAI,CAACd,SAAS,CAACI,GAAG,CAACU,KAAK,CAAC,EAAE;EAC3B,IAAIA,KAAK,KAAKT,WAAW,EAAE;EAC3BA,WAAW,GAAGS,KAAK;EACnBD,UAAU,CAACC,KAAK,CAAC;EACjB,IAAI,OAAON,MAAM,KAAK,WAAW,EAAE;IACjC,IAAI;MACFA,MAAM,CAACE,YAAY,CAACyB,OAAO,CAACxC,WAAW,EAAEmB,KAAK,CAAC;IACjD,CAAC,CAAC,OAAOsB,GAAG,EAAE;MACZ;MACA;MACA,IAAI,OAAOC,OAAO,KAAK,WAAW,IAAIA,OAAO,CAACC,IAAI,EAAE;QAClD;QACAD,OAAO,CAACC,IAAI,CAAC,wDAAwD,EAAEF,GAAG,CAAC;MAC7E;IACF;EACF;EACAd,MAAM,CAAC,CAAC;AACV;AAEA,eAAe,SAASiB,UAAUA,CAAA,EAAgD;EAChF,IAAMC,OAAO,GAAG9C,oBAAoB,CAACmC,SAAS,EAAEG,WAAW,EAAEC,iBAAiB,CAAC;EAC/E,OAAO,CAACO,OAAO,EAAEN,eAAe,CAAC;AACnC","ignoreList":[]}
+{"version":3,"file":"useDensity.js","names":["useSyncExternalStore","STORAGE_KEY","DEFAULT","VALID","Object","freeze","VALID_SET","Set","isDensityPref","v","has","memoryValue","readInitialValue","subscribers","window","raw","localStorage","getItem","applyToDom","value","document","documentElement","dataset","addEventListener","e","key","newValue","notify","cb","Array","from","subscribe","callback","add","delete","getSnapshot","getServerSnapshot","setDensityValue","setItem","err","console","warn","useDensity","density"],"sources":["../../../../src/lib/v2/hooks/useDensity.ts"],"sourcesContent":["import { useSyncExternalStore } from \"react\";\r\n\r\n/**\r\n * useDensity — Portnet UI v2\r\n *\r\n * Reads / writes the user's density preference (charter R-DG.11).\r\n * Applies it as `data-density` on <html> so all density-aware\r\n * tokens cascade.\r\n *\r\n *   const [density, setDensity] = useDensity();\r\n *   <button onClick={() => setDensity(density === \"compact\" ? \"comfortable\" : \"compact\")} />\r\n *\r\n * Synchronisation guarantees\r\n *   - Multi-instance same-tab: every useDensity() consumer sees\r\n *     the same value at all times. Implemented via a module-level\r\n *     subscriber set fed by useSyncExternalStore.\r\n *   - Cross-tab: a `storage` event listener at module load\r\n *     propagates updates from sibling tabs sharing the origin.\r\n *   - SSR-safe: server snapshot returns the DEFAULT; all DOM and\r\n *     storage interactions are guarded.\r\n */\r\n\r\ntype DensityPref = \"comfortable\" | \"compact\";\r\n\r\nconst STORAGE_KEY = \"portnet-ui-density\";\r\nconst DEFAULT: DensityPref = \"comfortable\";\r\nconst VALID = Object.freeze([\"comfortable\", \"compact\"]);\r\nconst VALID_SET = new Set<string>(VALID);\r\n\r\nfunction isDensityPref(v: unknown): v is DensityPref {\r\n  return typeof v === \"string\" && VALID_SET.has(v);\r\n}\r\n\r\n/* ── Module-level store ───────────────────────────────── */\r\n\r\n/** Source of truth. Lazy-read from storage at module load on the client. */\r\nlet memoryValue: DensityPref = readInitialValue();\r\n\r\n/** Active hook subscribers — notified on every value change. */\r\nconst subscribers = new Set<() => void>();\r\n\r\nfunction readInitialValue(): DensityPref {\r\n  if (typeof window === \"undefined\") return DEFAULT;\r\n  try {\r\n    const raw = window.localStorage.getItem(STORAGE_KEY);\r\n    return isDensityPref(raw) ? raw : DEFAULT;\r\n  } catch {\r\n    return DEFAULT;\r\n  }\r\n}\r\n\r\nfunction applyToDom(value: DensityPref): void {\r\n  if (typeof document === \"undefined\") return;\r\n  document.documentElement.dataset[\"density\"] = value;\r\n}\r\n\r\n/** Apply the initial value to the DOM at module load (client-side). */\r\napplyToDom(memoryValue);\r\n\r\n/* Cross-tab sync. The `storage` event fires in OTHER tabs only —\r\n * the writing tab is informed via the in-memory subscribers path. */\r\nif (typeof window !== \"undefined\") {\r\n  window.addEventListener(\"storage\", (e) => {\r\n    if (e.key !== STORAGE_KEY) return;\r\n    if (!isDensityPref(e.newValue)) return;\r\n    if (e.newValue === memoryValue) return;\r\n    memoryValue = e.newValue;\r\n    applyToDom(memoryValue);\r\n    // No storage write here — the originating tab already wrote.\r\n    notify();\r\n  });\r\n}\r\n\r\nfunction notify(): void {\r\n  // Iterate a snapshot — a subscriber that unmounts during notify\r\n  // would otherwise mutate the Set under iteration.\r\n  for (const cb of Array.from(subscribers)) cb();\r\n}\r\n\r\nfunction subscribe(callback: () => void): () => void {\r\n  subscribers.add(callback);\r\n  return () => subscribers.delete(callback);\r\n}\r\n\r\nfunction getSnapshot(): DensityPref {\r\n  return memoryValue;\r\n}\r\n\r\nfunction getServerSnapshot(): DensityPref {\r\n  return DEFAULT;\r\n}\r\n\r\n/* ── Setter (module-level so identity is stable across renders) ── */\r\n\r\n/**\r\n * Set the density preference. Ignores invalid values silently\r\n * (consumer-supplied data sanitation is not this hook's job) and\r\n * short-circuits when the value is unchanged.\r\n */\r\nfunction setDensityValue(value: DensityPref): void {\r\n  if (!VALID_SET.has(value)) return;\r\n  if (value === memoryValue) return;\r\n  memoryValue = value;\r\n  applyToDom(value);\r\n  if (typeof window !== \"undefined\") {\r\n    try {\r\n      window.localStorage.setItem(STORAGE_KEY, value);\r\n    } catch (err) {\r\n      // Quota, private mode, or sandboxed iframe — preference is\r\n      // applied for this session but won't persist. Surface in dev.\r\n      // eslint-disable-next-line no-console\r\n      if (typeof console !== \"undefined\" && console.warn) {\r\n        // eslint-disable-next-line no-console\r\n        console.warn(\"[@portnet/ui v2] useDensity: localStorage write failed\", err);\r\n      }\r\n    }\r\n  }\r\n  notify();\r\n}\r\n\r\nexport default function useDensity(): [DensityPref, (value: DensityPref) => void] {\r\n  const density = useSyncExternalStore(subscribe, getSnapshot, getServerSnapshot);\r\n  return [density, setDensityValue];\r\n}\r\n"],"mappings":"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","ignoreList":[]}

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

@@ -63,7 +63,7 @@ import { useEffect, useRef } from "react";
  * programmatically focusable but deliberately out of the tab order — landing
  * there would put the user somewhere Tab cannot return to.
  */
-var FOCUSABLE_WITHIN = 'input,select,textarea,button,[href],[tabindex]:not([tabindex="-1"])';
+const FOCUSABLE_WITHIN = 'input,select,textarea,button,[href],[tabindex]:not([tabindex="-1"])';
 
 /**
  * Escape a value for use inside an attribute selector.
@@ -104,26 +104,24 @@ function isFocusableNow(el) {
  *          caller should keep its inline error and, ideally, render
  *          FormErrorSummary so the field is still reachable.
  */
-export function focusFieldByName(name) {
-  var options = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : {};
+export function focusFieldByName(name, options = {}) {
   if (typeof document === "undefined") return false;
   if (!name) return false;
-  var escaped = escapeAttributeValue(name);
+  const escaped = escapeAttributeValue(name);
 
   /* Order matters — see the `[id=]` note in the module docstring. */
-  var selectors = ["[id=\"".concat(escaped, "\"]"), "[name=\"".concat(escaped, "\"]"), "[data-field=\"".concat(escaped, "\"]")];
-  for (var _i = 0, _selectors = selectors; _i < _selectors.length; _i++) {
-    var selector = _selectors[_i];
-    var host = null;
+  const selectors = [`[id="${escaped}"]`, `[name="${escaped}"]`, `[data-field="${escaped}"]`];
+  for (const selector of selectors) {
+    let host = null;
     try {
       host = document.querySelector(selector);
-    } catch (_unused) {
+    } catch {
       /* Malformed selector — try the next shape rather than throwing into
          the caller's validation branch. */
       host = null;
     }
     if (host === null) continue;
-    var target = isFocusableNow(host) ? host : host.querySelector(FOCUSABLE_WITHIN);
+    const target = isFocusableNow(host) ? host : host.querySelector(FOCUSABLE_WITHIN);
     if (!isFocusableNow(target)) continue;
     if (options.scroll !== false) {
       try {
@@ -131,7 +129,7 @@ export function focusFieldByName(name) {
           block: "center",
           behavior: "auto"
         });
-      } catch (_unused2) {
+      } catch {
         /* jsdom and older Safari lack the options overload. Focus below
            still scrolls the control into view natively. */
       }
@@ -152,25 +150,21 @@ export function focusFieldByName(name) {
  * error is actually found lets the effect re-run when the errors land,
  * without re-firing for the same attempt afterwards.
  */
-export default function useFocusFirstError(_ref) {
-  var errors = _ref.errors,
-    order = _ref.order,
-    _ref$submitCount = _ref.submitCount,
-    submitCount = _ref$submitCount === void 0 ? 0 : _ref$submitCount,
-    _ref$enabled = _ref.enabled,
-    enabled = _ref$enabled === void 0 ? true : _ref$enabled,
-    _ref$scroll = _ref.scroll,
-    scroll = _ref$scroll === void 0 ? true : _ref$scroll;
+export default function useFocusFirstError({
+  errors,
+  order,
+  submitCount = 0,
+  enabled = true,
+  scroll = true
+}) {
   /** Highest submitCount already acted on. */
-  var handledRef = useRef(0);
-  useEffect(function () {
+  const handledRef = useRef(0);
+  useEffect(() => {
     if (!enabled) return undefined;
     if (submitCount <= handledRef.current) return undefined;
     if (!errors) return undefined;
-    var names = order !== undefined && order.length > 0 ? order : Object.keys(errors);
-    var first = names.find(function (name) {
-      return Boolean(errors[name]);
-    });
+    const names = order !== undefined && order.length > 0 ? order : Object.keys(errors);
+    const first = names.find(name => Boolean(errors[name]));
 
     /* No error yet: either validation is still in flight for this attempt,
        or it passed. Leave handledRef alone so a later errors update for the
@@ -180,18 +174,16 @@ export default function useFocusFirstError(_ref) {
 
     /* One frame, so the inline errors have rendered and the target exists
        and is measurable before it is focused and scrolled to. */
-    var frame = requestAnimationFrame(function () {
-      var focused = focusFieldByName(first, {
-        scroll: scroll
+    const frame = requestAnimationFrame(() => {
+      const focused = focusFieldByName(first, {
+        scroll
       });
       if (!focused && process.env["NODE_ENV"] !== "production") {
         // eslint-disable-next-line no-console
-        console.warn("[v2.useFocusFirstError] Could not focus \"".concat(first, "\" \u2014 no visible, ") + "enabled control matched [id], [name] or [data-field]. Either the " + "field is in a collapsed section, or its control does not publish " + "the field name (a hand-rolled control that skips Field). R-F.3 is " + "NOT satisfied for this field; render FormErrorSummary (R-FV.2) so " + "it stays reachable.");
+        console.warn(`[v2.useFocusFirstError] Could not focus "${first}" — no visible, ` + "enabled control matched [id], [name] or [data-field]. Either the " + "field is in a collapsed section, or its control does not publish " + "the field name (a hand-rolled control that skips Field). R-F.3 is " + "NOT satisfied for this field; render FormErrorSummary (R-FV.2) so " + "it stays reachable.");
       }
     });
-    return function () {
-      return cancelAnimationFrame(frame);
-    };
+    return () => cancelAnimationFrame(frame);
   }, [errors, order, submitCount, enabled, scroll]);
 }
 //# sourceMappingURL=useFocusFirstError.js.map