@portnet/ui 6.0.2 → 6.0.3

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

@@ -0,0 +1 @@
+{"version":3,"file":"useAppliedFilters.js","names":["_react","require","useAppliedFilters","form","options","appliedFilters","setAppliedFilters","useState","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,IAAAA,MAAA,GAAAC,OAAA;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAEA;;AA6BA;AACA;AACA;AACA;AACA;;AAiBe,SAASC,iBAAiBA,CACvCC,IAAwB,EACxBC,OAAiC,EACR;EACzB,MAAM,CAACC,cAAc,EAAEC,iBAAiB,CAAC,GAAG,IAAAC,eAAQ,EAClD,CAAC,CACH,CAAC;EAED,MAAMC,KAAK,GAAGJ,OAAO,CAACK,aAAa,KAAK,MAAM,IAAI,CAAC;EAEnD,OAAO;IACLJ,cAAc;IAEdK,KAAK,EAAEA,CAAA,KAAM;MACXJ,iBAAiB,CAAC;QAAE,GAAGH,IAAI,CAACQ;MAAO,CAAC,CAAC;MACrCP,OAAO,CAACQ,OAAO,CAAC,CAAC;IACnB,CAAC;IAEDC,QAAQ,EAAEA,CAAA,KAAM;MACdP,iBAAiB,CAAC,CAAC,CAAC,CAAC;MACrBF,OAAO,CAACU,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,KAAKf,IAAI,CAACgB,aAAa,CAACD,GAAG,EAAEV,KAAK,CAACU,GAAG,CAAC,CAAC;MAC1C,CAAC,CAAC;MACF,MAAME,SAAkC,GAAG;QAAE,GAAGf;MAAe,CAAC;MAChEW,IAAI,CAACC,OAAO,CAAEC,GAAG,IAAK;QACpBE,SAAS,CAACF,GAAG,CAAC,GAAGV,KAAK,CAACU,GAAG,CAAC;MAC7B,CAAC,CAAC;MACFZ,iBAAiB,CAACc,SAAS,CAAC;MAC5BhB,OAAO,CAACiB,QAAQ,CAACD,SAAS,CAAC;IAC7B,CAAC;IAEDE,UAAU,EAAGX,MAA+B,IAAK;MAC/CL,iBAAiB,CAAC;QAAE,GAAGK;MAAO,CAAC,CAAC;IAClC;EACF,CAAC;AACH","ignoreList":[]}

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

@@ -0,0 +1,64 @@
+/**
+ * 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<T>(action: (value: T) => void, delay?: number): (value: T) => void;
+//# sourceMappingURL=useDebouncedCallback.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"useDebouncedCallback.d.ts","sourceRoot":"","sources":["../../../src/lib/v2/hooks/useDebouncedCallback.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6DG;AACH,MAAM,CAAC,OAAO,UAAU,oBAAoB,CAAC,CAAC,EAC5C,MAAM,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,IAAI,EAC1B,KAAK,SAAM,GACV,CAAC,KAAK,EAAE,CAAC,KAAK,IAAI,CAyBpB"}

package/dist/v2/hooks/useDebouncedCallback.js

@@ -0,0 +1,87 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.default = useDebouncedCallback;
+var _react = require("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.
+ */
+function useDebouncedCallback(action, delay = 500) {
+  const actionRef = (0, _react.useRef)(action);
+  const timer = (0, _react.useRef)(null);
+  (0, _react.useEffect)(() => {
+    actionRef.current = action;
+  }, [action]);
+  (0, _react.useEffect)(() => () => {
+    if (timer.current !== null) clearTimeout(timer.current);
+  }, []);
+  return (0, _react.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/v2/hooks/useDebouncedCallback.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useDebouncedCallback.js","names":["_react","require","useDebouncedCallback","action","delay","actionRef","useRef","timer","useEffect","current","clearTimeout","useCallback","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,IAAAA,MAAA,GAAAC,OAAA;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACe,SAASC,oBAAoBA,CAC1CC,MAA0B,EAC1BC,KAAK,GAAG,GAAG,EACS;EACpB,MAAMC,SAAS,GAAG,IAAAC,aAAM,EAACH,MAAM,CAAC;EAChC,MAAMI,KAAK,GAAG,IAAAD,aAAM,EAAuC,IAAI,CAAC;EAEhE,IAAAE,gBAAS,EAAC,MAAM;IACdH,SAAS,CAACI,OAAO,GAAGN,MAAM;EAC5B,CAAC,EAAE,CAACA,MAAM,CAAC,CAAC;EAEZ,IAAAK,gBAAS,EACP,MAAM,MAAM;IACV,IAAID,KAAK,CAACE,OAAO,KAAK,IAAI,EAAEC,YAAY,CAACH,KAAK,CAACE,OAAO,CAAC;EACzD,CAAC,EACD,EACF,CAAC;EAED,OAAO,IAAAE,kBAAW,EACfC,KAAQ,IAAK;IACZ,IAAIL,KAAK,CAACE,OAAO,KAAK,IAAI,EAAEC,YAAY,CAACH,KAAK,CAACE,OAAO,CAAC;IACvDF,KAAK,CAACE,OAAO,GAAGI,UAAU,CAAC,MAAM;MAC/BN,KAAK,CAACE,OAAO,GAAG,IAAI;MACpBJ,SAAS,CAACI,OAAO,CAACG,KAAK,CAAC;IAC1B,CAAC,EAAER,KAAK,CAAC;EACX,CAAC,EACD,CAACA,KAAK,CACR,CAAC;AACH","ignoreList":[]}

package/dist/v2/hooks/useDelayedFlag.js

@@ -3,15 +3,9 @@
 Object.defineProperty(exports, "__esModule", {
   value: true
 });
-exports["default"] = useDelayedFlag;
+exports.default = useDelayedFlag;
 var _react = require("react");
 var _useTabLoading = require("./useTabLoading");
-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; }
 /**
  * useDelayedFlag — Portnet UI v2
  *
@@ -32,13 +26,9 @@ function _arrayWithHoles(arr) { if (Array.isArray(arr)) return arr; }
  *     (preserves across tab swap to avoid flicker between two
  *     consecutive skeletons), use `useTabLoading`.
  */
-function useDelayedFlag(active) {
-  var delayMs = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : _useTabLoading.PERCEPTION_THRESHOLD_MS;
-  var _useState = (0, _react.useState)(false),
-    _useState2 = _slicedToArray(_useState, 2),
-    delayed = _useState2[0],
-    setDelayed = _useState2[1];
-  (0, _react.useEffect)(function () {
+function useDelayedFlag(active, delayMs = _useTabLoading.PERCEPTION_THRESHOLD_MS) {
+  const [delayed, setDelayed] = (0, _react.useState)(false);
+  (0, _react.useEffect)(() => {
     if (!active) {
       // Inactive — drop any in-flight delayed flag immediately so
       // the consumer can render the success path without waiting.
@@ -48,12 +38,8 @@ 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/v2/hooks/useDelayedFlag.js.map

@@ -1 +1 @@
-{"version":3,"file":"useDelayedFlag.js","names":["_react","require","_useTabLoading","_slicedToArray","arr","i","_arrayWithHoles","_iterableToArrayLimit","_unsupportedIterableToArray","_nonIterableRest","TypeError","o","minLen","_arrayLikeToArray","n","Object","prototype","toString","call","slice","constructor","name","Array","from","test","len","length","arr2","_i","Symbol","iterator","_s","_e","_x","_r","_arr","_n","_d","next","done","push","value","err","isArray","useDelayedFlag","active","delayMs","arguments","undefined","PERCEPTION_THRESHOLD_MS","_useState","useState","_useState2","delayed","setDelayed","useEffect","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":"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","ignoreList":[]}
+{"version":3,"file":"useDelayedFlag.js","names":["_react","require","_useTabLoading","useDelayedFlag","active","delayMs","PERCEPTION_THRESHOLD_MS","delayed","setDelayed","useState","useEffect","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,IAAAA,MAAA,GAAAC,OAAA;AACA,IAAAC,cAAA,GAAAD,OAAA;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACe,SAASE,cAAcA,CACpCC,MAAe,EACfC,OAAe,GAAGC,sCAAuB,EAChC;EACT,MAAM,CAACC,OAAO,EAAEC,UAAU,CAAC,GAAG,IAAAC,eAAQ,EAAC,KAAK,CAAC;EAE7C,IAAAC,gBAAS,EAAC,MAAM;IACd,IAAI,CAACN,MAAM,EAAE;MACX;MACA;MACAI,UAAU,CAAC,KAAK,CAAC;MACjB,OAAOG,SAAS;IAClB;IACA;IACA;IACA;IACA,MAAMC,CAAC,GAAGC,UAAU,CAAC,MAAML,UAAU,CAAC,IAAI,CAAC,EAAEH,OAAO,CAAC;IACrD,OAAO,MAAMS,YAAY,CAACF,CAAC,CAAC;EAC9B,CAAC,EAAE,CAACR,MAAM,EAAEC,OAAO,CAAC,CAAC;EAErB,OAAOE,OAAO;AAChB","ignoreList":[]}

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

@@ -1 +1 @@
-{"version":3,"file":"useDensity.d.ts","sourceRoot":"","sources":["../../../src/lib/v2/hooks/useDensity.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,KAAK,WAAW,GAAG,aAAa,GAAG,SAAS,CAAC;AAiG7C,MAAM,CAAC,OAAO,UAAU,UAAU,IAAI,CAAC,WAAW,EAAE,CAAC,KAAK,EAAE,WAAW,KAAK,IAAI,CAAC,CAGhF"}
+{"version":3,"file":"useDensity.d.ts","sourceRoot":"","sources":["../../../src/lib/v2/hooks/useDensity.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,KAAK,WAAW,GAAG,aAAa,GAAG,SAAS,CAAC;AAkG7C,MAAM,CAAC,OAAO,UAAU,UAAU,IAAI,CAAC,WAAW,EAAE,CAAC,KAAK,EAAE,WAAW,KAAK,IAAI,CAAC,CAGhF"}

package/dist/v2/hooks/useDensity.js

@@ -3,7 +3,7 @@
 Object.defineProperty(exports, "__esModule", {
   value: true
 });
-exports["default"] = useDensity;
+exports.default = useDensity;
 var _react = require("react");
 /**
  * useDensity — Portnet UI v2
@@ -25,10 +25,10 @@ var _react = require("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);
 }
@@ -36,16 +36,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;
   }
 }
@@ -60,7 +60,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;
@@ -73,16 +73,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;
@@ -109,6 +104,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);
@@ -118,7 +114,7 @@ function setDensityValue(value) {
   notify();
 }
 function useDensity() {
-  var density = (0, _react.useSyncExternalStore)(subscribe, getSnapshot, getServerSnapshot);
+  const density = (0, _react.useSyncExternalStore)(subscribe, getSnapshot, getServerSnapshot);
   return [density, setDensityValue];
 }
 //# sourceMappingURL=useDensity.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"useDensity.js","names":["_react","require","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","useSyncExternalStore"],"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":"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","ignoreList":[]}
+{"version":3,"file":"useDensity.js","names":["_react","require","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","useSyncExternalStore"],"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/v2/hooks/useFocusFirstError.js

@@ -3,7 +3,7 @@
 Object.defineProperty(exports, "__esModule", {
   value: true
 });
-exports["default"] = useFocusFirstError;
+exports.default = useFocusFirstError;
 exports.focusFieldByName = focusFieldByName;
 var _react = require("react");
 /**
@@ -69,7 +69,7 @@ var _react = require("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.
@@ -110,26 +110,24 @@ function isFocusableNow(el) {
  *          caller should keep its inline error and, ideally, render
  *          FormErrorSummary so the field is still reachable.
  */
-function focusFieldByName(name) {
-  var options = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : {};
+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 {
@@ -137,7 +135,7 @@ 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. */
       }
@@ -158,25 +156,21 @@ function focusFieldByName(name) {
  * error is actually found lets the effect re-run when the errors land,
  * without re-firing for the same attempt afterwards.
  */
-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;
+function useFocusFirstError({
+  errors,
+  order,
+  submitCount = 0,
+  enabled = true,
+  scroll = true
+}) {
   /** Highest submitCount already acted on. */
-  var handledRef = (0, _react.useRef)(0);
-  (0, _react.useEffect)(function () {
+  const handledRef = (0, _react.useRef)(0);
+  (0, _react.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
@@ -186,18 +180,16 @@ 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

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

@@ -1 +1 @@
-{"version":3,"file":"useFocusFirstError.js","names":["_react","require","FOCUSABLE_WITHIN","escapeAttributeValue","value","window","CSS","escape","replace","isFocusableNow","el","HTMLElement","hasAttribute","getAttribute","getClientRects","length","focusFieldByName","name","options","arguments","undefined","document","escaped","selectors","concat","_i","_selectors","selector","host","querySelector","_unused","target","scroll","scrollIntoView","block","behavior","_unused2","focus","useFocusFirstError","_ref","errors","order","_ref$submitCount","submitCount","_ref$enabled","enabled","_ref$scroll","handledRef","useRef","useEffect","current","names","Object","keys","first","find","Boolean","frame","requestAnimationFrame","focused","process","env","console","warn","cancelAnimationFrame"],"sources":["../../../src/lib/v2/hooks/useFocusFirstError.ts"],"sourcesContent":["import { useEffect, useRef } from \"react\";\r\n\r\n/**\r\n * useFocusFirstError — Portnet UI v2\r\n *\r\n * Charter §05.3 R-F.3 MUST — \"Submit form échoué → focus sur premier champ\r\n * en erreur\". Charter §04.1 R-FV.3 MUST — \"Scroll auto vers premier champ\r\n * en erreur + focus\". Both are the same behaviour; this is it, once.\r\n *\r\n * Formik-FREE on purpose, exactly like useFormAutoSave: the caller passes\r\n * `errors`, `submitCount` and the rendered field order as plain values.\r\n * Formik coupling belongs in patterns/ — use <FormikErrorFocus /> when the\r\n * form is a Formik form and this hook directly when it is not (a manual\r\n * \"Ajouter\" guard, a non-Formik dropzone section, a reducer-driven form).\r\n *\r\n *   // Formik form — prefer the pattern, which wires this for you:\r\n *   <FormikErrorFocus order={[\"numeroFacture\", \"fournisseur\", \"dateFacture\"]} />\r\n *\r\n *   // Manual guard — call the imperative helper directly:\r\n *   const missing = requiredFields.filter((f) => !f.value);\r\n *   if (missing.length > 0) {\r\n *     missing.forEach((f) => setFieldError(f.name, REQUIRED));\r\n *     focusFieldByName(missing[0].name);\r\n *     return;\r\n *   }\r\n *\r\n * ── WHY THE `[id=]` LOOKUP COMES FIRST ──────────────────────────────\r\n *\r\n * Hosts have consistently written `[name=\"<field>\"]`, which is wrong for\r\n * most v2 fields. The Formik bridges wrap their control in Field, which\r\n * does `htmlFor={htmlFor || name}` and then\r\n * `cloneElement(child, { id: inputId })` — so the field NAME is published\r\n * as the control's `id`, and whether it also appears as `name` depends\r\n * entirely on which primitive is underneath. It does for Input/Textarea.\r\n * It does not for Select, Combobox, DatePicker or ReferentielField.\r\n *\r\n * A `[name=]`-only selector therefore fails precisely on the compound\r\n * fields, silently — the call runs, matches nothing, and the form reads as\r\n * compliant. `[id=]` is guaranteed by the Field contract for every bridge,\r\n * so it is tried first; `[name=]` and `[data-field=]` remain as fallbacks\r\n * for hand-rolled controls that never went through Field.\r\n *\r\n * ── WHAT THIS DELIBERATELY DOES NOT DO ──────────────────────────────\r\n *\r\n * It does not focus a control it cannot see. A field inside a collapsed\r\n * <details> (Accordion.Item) or a display:none branch has no client rects,\r\n * and focusing it would scroll the page to an invisible target and strand\r\n * the user with no visible focus ring. `focusFieldByName` returns false in\r\n * that case and dev-warns rather than guessing — the inline error\r\n * (role=\"alert\" via Field) still carries the message, and R-FV.2's summary\r\n * banner (FormErrorSummary) is the right affordance for reaching a field\r\n * in a closed section.\r\n *\r\n * It also does not announce anything. Field already renders its error with\r\n * role=\"alert\"; a second live region would double-announce.\r\n */\r\n\r\n/** Options for the imperative helper. */\r\nexport type FocusFieldOptions = {\r\n  /**\r\n   * Scroll the resolved control into view before focusing.\r\n   *\r\n   * `behavior: \"auto\"` always — never \"smooth\". R-Tg.2 caps animation at\r\n   * 0.01 ms under prefers-reduced-motion, and a smooth scroll triggered by\r\n   * a failed submit is exactly the motion that rule exists to suppress.\r\n   *\r\n   * @default true\r\n   */\r\n  scroll?: boolean | undefined;\r\n};\r\n\r\nexport type UseFocusFirstErrorOptions = {\r\n  /**\r\n   * Field name -> error. Formik's `errors` satisfies this directly.\r\n   *\r\n   * Only truthiness is read, so any error shape works (string, node,\r\n   * nested object).\r\n   */\r\n  errors?: Readonly<Record<string, unknown>> | undefined;\r\n  /**\r\n   * Field names in RENDERED order — top-to-bottom as the user sees them.\r\n   *\r\n   * SUPPLY THIS. Without it the order falls back to `Object.keys(errors)`,\r\n   * which is the order the validator happened to write its keys in and has\r\n   * no relationship to the layout; \"first field in error\" then means\r\n   * \"whichever field Yup reached first\", which can be the last one on\r\n   * screen.\r\n   */\r\n  order?: readonly string[] | undefined;\r\n  /**\r\n   * Submit attempt counter. Formik's `submitCount`.\r\n   *\r\n   * This is the TRIGGER: focus moves when it increases, never on an\r\n   * ordinary re-render. Without it a persisting error would re-steal focus\r\n   * every time the component re-rendered, which is worse than not moving\r\n   * focus at all.\r\n   */\r\n  submitCount?: number | undefined;\r\n  /** @default true */\r\n  enabled?: boolean | undefined;\r\n  /** @default true */\r\n  scroll?: boolean | undefined;\r\n};\r\n\r\n/**\r\n * Focusable descendants, for the case where the resolved element is a\r\n * wrapper rather than the control itself. Excludes tabindex=\"-1\", which is\r\n * programmatically focusable but deliberately out of the tab order — landing\r\n * there would put the user somewhere Tab cannot return to.\r\n */\r\nconst FOCUSABLE_WITHIN =\r\n  'input,select,textarea,button,[href],[tabindex]:not([tabindex=\"-1\"])';\r\n\r\n/**\r\n * Escape a value for use inside an attribute selector.\r\n *\r\n * CSS.escape where available, with a manual quote/backslash escape as the\r\n * fallback — same guard shape DataGrid uses for its reorder-grip lookup.\r\n * Field names are developer-authored, so this is robustness rather than a\r\n * sanitisation boundary.\r\n */\r\nfunction escapeAttributeValue(value: string): string {\r\n  if (\r\n    typeof window !== \"undefined\" &&\r\n    window.CSS &&\r\n    typeof window.CSS.escape === \"function\"\r\n  ) {\r\n    return window.CSS.escape(value);\r\n  }\r\n  return value.replace(/[\"\\\\]/g, \"\\\\$&\");\r\n}\r\n\r\n/**\r\n * Is this element something a user can actually be sent to?\r\n *\r\n * `getClientRects().length === 0` is what excludes a field inside a\r\n * collapsed <details> or a display:none branch. offsetParent alone is not\r\n * enough — it is also null for position:fixed elements, which are visible.\r\n */\r\nfunction isFocusableNow(el: Element | null): el is HTMLElement {\r\n  if (!(el instanceof HTMLElement)) return false;\r\n  if (el.hasAttribute(\"disabled\")) return false;\r\n  if (el.getAttribute(\"aria-hidden\") === \"true\") return false;\r\n  if (el.getClientRects().length === 0) return false;\r\n  return true;\r\n}\r\n\r\n/**\r\n * Focus the control registered under `name`, resolving it the way the v2\r\n * Field contract publishes it.\r\n *\r\n * @returns true when a visible, enabled control was focused. False means\r\n *          nothing matched, or the match was hidden or disabled — the\r\n *          caller should keep its inline error and, ideally, render\r\n *          FormErrorSummary so the field is still reachable.\r\n */\r\nexport function focusFieldByName(\r\n  name: string,\r\n  options: FocusFieldOptions = {}\r\n): boolean {\r\n  if (typeof document === \"undefined\") return false;\r\n  if (!name) return false;\r\n\r\n  const escaped = escapeAttributeValue(name);\r\n\r\n  /* Order matters — see the `[id=]` note in the module docstring. */\r\n  const selectors = [\r\n    `[id=\"${escaped}\"]`,\r\n    `[name=\"${escaped}\"]`,\r\n    `[data-field=\"${escaped}\"]`,\r\n  ];\r\n\r\n  for (const selector of selectors) {\r\n    let host: Element | null = null;\r\n    try {\r\n      host = document.querySelector(selector);\r\n    } catch {\r\n      /* Malformed selector — try the next shape rather than throwing into\r\n         the caller's validation branch. */\r\n      host = null;\r\n    }\r\n    if (host === null) continue;\r\n\r\n    const target = isFocusableNow(host)\r\n      ? host\r\n      : host.querySelector(FOCUSABLE_WITHIN);\r\n\r\n    if (!isFocusableNow(target)) continue;\r\n\r\n    if (options.scroll !== false) {\r\n      try {\r\n        target.scrollIntoView({ block: \"center\", behavior: \"auto\" });\r\n      } catch {\r\n        /* jsdom and older Safari lack the options overload. Focus below\r\n           still scrolls the control into view natively. */\r\n      }\r\n    }\r\n\r\n    target.focus();\r\n    return true;\r\n  }\r\n\r\n  return false;\r\n}\r\n\r\n/**\r\n * Move focus to the first field in error after each failed submit.\r\n *\r\n * Fires when `submitCount` increases AND an error is present. The two\r\n * conditions are separate on purpose: Formik increments submitCount before\r\n * async validation resolves, so on the render where the counter changes\r\n * `errors` can still be empty. Marking the attempt handled only once an\r\n * error is actually found lets the effect re-run when the errors land,\r\n * without re-firing for the same attempt afterwards.\r\n */\r\nexport default function useFocusFirstError({\r\n  errors,\r\n  order,\r\n  submitCount = 0,\r\n  enabled = true,\r\n  scroll = true,\r\n}: UseFocusFirstErrorOptions): void {\r\n  /** Highest submitCount already acted on. */\r\n  const handledRef = useRef(0);\r\n\r\n  useEffect(() => {\r\n    if (!enabled) return undefined;\r\n    if (submitCount <= handledRef.current) return undefined;\r\n    if (!errors) return undefined;\r\n\r\n    const names =\r\n      order !== undefined && order.length > 0 ? order : Object.keys(errors);\r\n\r\n    const first = names.find((name) => Boolean(errors[name]));\r\n\r\n    /* No error yet: either validation is still in flight for this attempt,\r\n       or it passed. Leave handledRef alone so a later errors update for the\r\n       SAME attempt is still honoured. */\r\n    if (first === undefined) return undefined;\r\n\r\n    handledRef.current = submitCount;\r\n\r\n    /* One frame, so the inline errors have rendered and the target exists\r\n       and is measurable before it is focused and scrolled to. */\r\n    const frame = requestAnimationFrame(() => {\r\n      const focused = focusFieldByName(first, { scroll });\r\n\r\n      if (!focused && process.env[\"NODE_ENV\"] !== \"production\") {\r\n        // eslint-disable-next-line no-console\r\n        console.warn(\r\n          `[v2.useFocusFirstError] Could not focus \"${first}\" — no visible, ` +\r\n            \"enabled control matched [id], [name] or [data-field]. Either the \" +\r\n            \"field is in a collapsed section, or its control does not publish \" +\r\n            \"the field name (a hand-rolled control that skips Field). R-F.3 is \" +\r\n            \"NOT satisfied for this field; render FormErrorSummary (R-FV.2) so \" +\r\n            \"it stays reachable.\"\r\n        );\r\n      }\r\n    });\r\n\r\n    return () => cancelAnimationFrame(frame);\r\n  }, [errors, order, submitCount, enabled, scroll]);\r\n}\r\n"],"mappings":";;;;;;;AAAA,IAAAA,MAAA,GAAAC,OAAA;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAEA;;AA+CA;AACA;AACA;AACA;AACA;AACA;AACA,IAAMC,gBAAgB,GACpB,qEAAqE;;AAEvE;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,SAASC,oBAAoBA,CAACC,KAAa,EAAU;EACnD,IACE,OAAOC,MAAM,KAAK,WAAW,IAC7BA,MAAM,CAACC,GAAG,IACV,OAAOD,MAAM,CAACC,GAAG,CAACC,MAAM,KAAK,UAAU,EACvC;IACA,OAAOF,MAAM,CAACC,GAAG,CAACC,MAAM,CAACH,KAAK,CAAC;EACjC;EACA,OAAOA,KAAK,CAACI,OAAO,CAAC,QAAQ,EAAE,MAAM,CAAC;AACxC;;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,SAASC,cAAcA,CAACC,EAAkB,EAAqB;EAC7D,IAAI,EAAEA,EAAE,YAAYC,WAAW,CAAC,EAAE,OAAO,KAAK;EAC9C,IAAID,EAAE,CAACE,YAAY,CAAC,UAAU,CAAC,EAAE,OAAO,KAAK;EAC7C,IAAIF,EAAE,CAACG,YAAY,CAAC,aAAa,CAAC,KAAK,MAAM,EAAE,OAAO,KAAK;EAC3D,IAAIH,EAAE,CAACI,cAAc,CAAC,CAAC,CAACC,MAAM,KAAK,CAAC,EAAE,OAAO,KAAK;EAClD,OAAO,IAAI;AACb;;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACO,SAASC,gBAAgBA,CAC9BC,IAAY,EAEH;EAAA,IADTC,OAA0B,GAAAC,SAAA,CAAAJ,MAAA,QAAAI,SAAA,QAAAC,SAAA,GAAAD,SAAA,MAAG,CAAC,CAAC;EAE/B,IAA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","ignoreList":[]}
+{"version":3,"file":"useFocusFirstError.js","names":["_react","require","FOCUSABLE_WITHIN","escapeAttributeValue","value","window","CSS","escape","replace","isFocusableNow","el","HTMLElement","hasAttribute","getAttribute","getClientRects","length","focusFieldByName","name","options","document","escaped","selectors","selector","host","querySelector","target","scroll","scrollIntoView","block","behavior","focus","useFocusFirstError","errors","order","submitCount","enabled","handledRef","useRef","useEffect","undefined","current","names","Object","keys","first","find","Boolean","frame","requestAnimationFrame","focused","process","env","console","warn","cancelAnimationFrame"],"sources":["../../../src/lib/v2/hooks/useFocusFirstError.ts"],"sourcesContent":["import { useEffect, useRef } from \"react\";\r\n\r\n/**\r\n * useFocusFirstError — Portnet UI v2\r\n *\r\n * Charter §05.3 R-F.3 MUST — \"Submit form échoué → focus sur premier champ\r\n * en erreur\". Charter §04.1 R-FV.3 MUST — \"Scroll auto vers premier champ\r\n * en erreur + focus\". Both are the same behaviour; this is it, once.\r\n *\r\n * Formik-FREE on purpose, exactly like useFormAutoSave: the caller passes\r\n * `errors`, `submitCount` and the rendered field order as plain values.\r\n * Formik coupling belongs in patterns/ — use <FormikErrorFocus /> when the\r\n * form is a Formik form and this hook directly when it is not (a manual\r\n * \"Ajouter\" guard, a non-Formik dropzone section, a reducer-driven form).\r\n *\r\n *   // Formik form — prefer the pattern, which wires this for you:\r\n *   <FormikErrorFocus order={[\"numeroFacture\", \"fournisseur\", \"dateFacture\"]} />\r\n *\r\n *   // Manual guard — call the imperative helper directly:\r\n *   const missing = requiredFields.filter((f) => !f.value);\r\n *   if (missing.length > 0) {\r\n *     missing.forEach((f) => setFieldError(f.name, REQUIRED));\r\n *     focusFieldByName(missing[0].name);\r\n *     return;\r\n *   }\r\n *\r\n * ── WHY THE `[id=]` LOOKUP COMES FIRST ──────────────────────────────\r\n *\r\n * Hosts have consistently written `[name=\"<field>\"]`, which is wrong for\r\n * most v2 fields. The Formik bridges wrap their control in Field, which\r\n * does `htmlFor={htmlFor || name}` and then\r\n * `cloneElement(child, { id: inputId })` — so the field NAME is published\r\n * as the control's `id`, and whether it also appears as `name` depends\r\n * entirely on which primitive is underneath. It does for Input/Textarea.\r\n * It does not for Select, Combobox, DatePicker or ReferentielField.\r\n *\r\n * A `[name=]`-only selector therefore fails precisely on the compound\r\n * fields, silently — the call runs, matches nothing, and the form reads as\r\n * compliant. `[id=]` is guaranteed by the Field contract for every bridge,\r\n * so it is tried first; `[name=]` and `[data-field=]` remain as fallbacks\r\n * for hand-rolled controls that never went through Field.\r\n *\r\n * ── WHAT THIS DELIBERATELY DOES NOT DO ──────────────────────────────\r\n *\r\n * It does not focus a control it cannot see. A field inside a collapsed\r\n * <details> (Accordion.Item) or a display:none branch has no client rects,\r\n * and focusing it would scroll the page to an invisible target and strand\r\n * the user with no visible focus ring. `focusFieldByName` returns false in\r\n * that case and dev-warns rather than guessing — the inline error\r\n * (role=\"alert\" via Field) still carries the message, and R-FV.2's summary\r\n * banner (FormErrorSummary) is the right affordance for reaching a field\r\n * in a closed section.\r\n *\r\n * It also does not announce anything. Field already renders its error with\r\n * role=\"alert\"; a second live region would double-announce.\r\n */\r\n\r\n/** Options for the imperative helper. */\r\nexport type FocusFieldOptions = {\r\n  /**\r\n   * Scroll the resolved control into view before focusing.\r\n   *\r\n   * `behavior: \"auto\"` always — never \"smooth\". R-Tg.2 caps animation at\r\n   * 0.01 ms under prefers-reduced-motion, and a smooth scroll triggered by\r\n   * a failed submit is exactly the motion that rule exists to suppress.\r\n   *\r\n   * @default true\r\n   */\r\n  scroll?: boolean | undefined;\r\n};\r\n\r\nexport type UseFocusFirstErrorOptions = {\r\n  /**\r\n   * Field name -> error. Formik's `errors` satisfies this directly.\r\n   *\r\n   * Only truthiness is read, so any error shape works (string, node,\r\n   * nested object).\r\n   */\r\n  errors?: Readonly<Record<string, unknown>> | undefined;\r\n  /**\r\n   * Field names in RENDERED order — top-to-bottom as the user sees them.\r\n   *\r\n   * SUPPLY THIS. Without it the order falls back to `Object.keys(errors)`,\r\n   * which is the order the validator happened to write its keys in and has\r\n   * no relationship to the layout; \"first field in error\" then means\r\n   * \"whichever field Yup reached first\", which can be the last one on\r\n   * screen.\r\n   */\r\n  order?: readonly string[] | undefined;\r\n  /**\r\n   * Submit attempt counter. Formik's `submitCount`.\r\n   *\r\n   * This is the TRIGGER: focus moves when it increases, never on an\r\n   * ordinary re-render. Without it a persisting error would re-steal focus\r\n   * every time the component re-rendered, which is worse than not moving\r\n   * focus at all.\r\n   */\r\n  submitCount?: number | undefined;\r\n  /** @default true */\r\n  enabled?: boolean | undefined;\r\n  /** @default true */\r\n  scroll?: boolean | undefined;\r\n};\r\n\r\n/**\r\n * Focusable descendants, for the case where the resolved element is a\r\n * wrapper rather than the control itself. Excludes tabindex=\"-1\", which is\r\n * programmatically focusable but deliberately out of the tab order — landing\r\n * there would put the user somewhere Tab cannot return to.\r\n */\r\nconst FOCUSABLE_WITHIN =\r\n  'input,select,textarea,button,[href],[tabindex]:not([tabindex=\"-1\"])';\r\n\r\n/**\r\n * Escape a value for use inside an attribute selector.\r\n *\r\n * CSS.escape where available, with a manual quote/backslash escape as the\r\n * fallback — same guard shape DataGrid uses for its reorder-grip lookup.\r\n * Field names are developer-authored, so this is robustness rather than a\r\n * sanitisation boundary.\r\n */\r\nfunction escapeAttributeValue(value: string): string {\r\n  if (\r\n    typeof window !== \"undefined\" &&\r\n    window.CSS &&\r\n    typeof window.CSS.escape === \"function\"\r\n  ) {\r\n    return window.CSS.escape(value);\r\n  }\r\n  return value.replace(/[\"\\\\]/g, \"\\\\$&\");\r\n}\r\n\r\n/**\r\n * Is this element something a user can actually be sent to?\r\n *\r\n * `getClientRects().length === 0` is what excludes a field inside a\r\n * collapsed <details> or a display:none branch. offsetParent alone is not\r\n * enough — it is also null for position:fixed elements, which are visible.\r\n */\r\nfunction isFocusableNow(el: Element | null): el is HTMLElement {\r\n  if (!(el instanceof HTMLElement)) return false;\r\n  if (el.hasAttribute(\"disabled\")) return false;\r\n  if (el.getAttribute(\"aria-hidden\") === \"true\") return false;\r\n  if (el.getClientRects().length === 0) return false;\r\n  return true;\r\n}\r\n\r\n/**\r\n * Focus the control registered under `name`, resolving it the way the v2\r\n * Field contract publishes it.\r\n *\r\n * @returns true when a visible, enabled control was focused. False means\r\n *          nothing matched, or the match was hidden or disabled — the\r\n *          caller should keep its inline error and, ideally, render\r\n *          FormErrorSummary so the field is still reachable.\r\n */\r\nexport function focusFieldByName(\r\n  name: string,\r\n  options: FocusFieldOptions = {}\r\n): boolean {\r\n  if (typeof document === \"undefined\") return false;\r\n  if (!name) return false;\r\n\r\n  const escaped = escapeAttributeValue(name);\r\n\r\n  /* Order matters — see the `[id=]` note in the module docstring. */\r\n  const selectors = [\r\n    `[id=\"${escaped}\"]`,\r\n    `[name=\"${escaped}\"]`,\r\n    `[data-field=\"${escaped}\"]`,\r\n  ];\r\n\r\n  for (const selector of selectors) {\r\n    let host: Element | null = null;\r\n    try {\r\n      host = document.querySelector(selector);\r\n    } catch {\r\n      /* Malformed selector — try the next shape rather than throwing into\r\n         the caller's validation branch. */\r\n      host = null;\r\n    }\r\n    if (host === null) continue;\r\n\r\n    const target = isFocusableNow(host)\r\n      ? host\r\n      : host.querySelector(FOCUSABLE_WITHIN);\r\n\r\n    if (!isFocusableNow(target)) continue;\r\n\r\n    if (options.scroll !== false) {\r\n      try {\r\n        target.scrollIntoView({ block: \"center\", behavior: \"auto\" });\r\n      } catch {\r\n        /* jsdom and older Safari lack the options overload. Focus below\r\n           still scrolls the control into view natively. */\r\n      }\r\n    }\r\n\r\n    target.focus();\r\n    return true;\r\n  }\r\n\r\n  return false;\r\n}\r\n\r\n/**\r\n * Move focus to the first field in error after each failed submit.\r\n *\r\n * Fires when `submitCount` increases AND an error is present. The two\r\n * conditions are separate on purpose: Formik increments submitCount before\r\n * async validation resolves, so on the render where the counter changes\r\n * `errors` can still be empty. Marking the attempt handled only once an\r\n * error is actually found lets the effect re-run when the errors land,\r\n * without re-firing for the same attempt afterwards.\r\n */\r\nexport default function useFocusFirstError({\r\n  errors,\r\n  order,\r\n  submitCount = 0,\r\n  enabled = true,\r\n  scroll = true,\r\n}: UseFocusFirstErrorOptions): void {\r\n  /** Highest submitCount already acted on. */\r\n  const handledRef = useRef(0);\r\n\r\n  useEffect(() => {\r\n    if (!enabled) return undefined;\r\n    if (submitCount <= handledRef.current) return undefined;\r\n    if (!errors) return undefined;\r\n\r\n    const names =\r\n      order !== undefined && order.length > 0 ? order : Object.keys(errors);\r\n\r\n    const first = names.find((name) => Boolean(errors[name]));\r\n\r\n    /* No error yet: either validation is still in flight for this attempt,\r\n       or it passed. Leave handledRef alone so a later errors update for the\r\n       SAME attempt is still honoured. */\r\n    if (first === undefined) return undefined;\r\n\r\n    handledRef.current = submitCount;\r\n\r\n    /* One frame, so the inline errors have rendered and the target exists\r\n       and is measurable before it is focused and scrolled to. */\r\n    const frame = requestAnimationFrame(() => {\r\n      const focused = focusFieldByName(first, { scroll });\r\n\r\n      if (!focused && process.env[\"NODE_ENV\"] !== \"production\") {\r\n        // eslint-disable-next-line no-console\r\n        console.warn(\r\n          `[v2.useFocusFirstError] Could not focus \"${first}\" — no visible, ` +\r\n            \"enabled control matched [id], [name] or [data-field]. Either the \" +\r\n            \"field is in a collapsed section, or its control does not publish \" +\r\n            \"the field name (a hand-rolled control that skips Field). R-F.3 is \" +\r\n            \"NOT satisfied for this field; render FormErrorSummary (R-FV.2) so \" +\r\n            \"it stays reachable.\"\r\n        );\r\n      }\r\n    });\r\n\r\n    return () => cancelAnimationFrame(frame);\r\n  }, [errors, order, submitCount, enabled, scroll]);\r\n}\r\n"],"mappings":";;;;;;;AAAA,IAAAA,MAAA,GAAAC,OAAA;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAEA;;AA+CA;AACA;AACA;AACA;AACA;AACA;AACA,MAAMC,gBAAgB,GACpB,qEAAqE;;AAEvE;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,SAASC,oBAAoBA,CAACC,KAAa,EAAU;EACnD,IACE,OAAOC,MAAM,KAAK,WAAW,IAC7BA,MAAM,CAACC,GAAG,IACV,OAAOD,MAAM,CAACC,GAAG,CAACC,MAAM,KAAK,UAAU,EACvC;IACA,OAAOF,MAAM,CAACC,GAAG,CAACC,MAAM,CAACH,KAAK,CAAC;EACjC;EACA,OAAOA,KAAK,CAACI,OAAO,CAAC,QAAQ,EAAE,MAAM,CAAC;AACxC;;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,SAASC,cAAcA,CAACC,EAAkB,EAAqB;EAC7D,IAAI,EAAEA,EAAE,YAAYC,WAAW,CAAC,EAAE,OAAO,KAAK;EAC9C,IAAID,EAAE,CAACE,YAAY,CAAC,UAAU,CAAC,EAAE,OAAO,KAAK;EAC7C,IAAIF,EAAE,CAACG,YAAY,CAAC,aAAa,CAAC,KAAK,MAAM,EAAE,OAAO,KAAK;EAC3D,IAAIH,EAAE,CAACI,cAAc,CAAC,CAAC,CAACC,MAAM,KAAK,CAAC,EAAE,OAAO,KAAK;EAClD,OAAO,IAAI;AACb;;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACO,SAASC,gBAAgBA,CAC9BC,IAAY,EACZC,OAA0B,GAAG,CAAC,CAAC,EACtB;EACT,IAAI,OAAOC,QAAQ,KAAK,WAAW,EAAE,OAAO,KAAK;EACjD,IAAI,CAACF,IAAI,EAAE,OAAO,KAAK;EAEvB,MAAMG,OAAO,GAAGjB,oBAAoB,CAACc,IAAI,CAAC;;EAE1C;EACA,MAAMI,SAAS,GAAG,CAChB,QAAQD,OAAO,IAAI,EACnB,UAAUA,OAAO,IAAI,EACrB,gBAAgBA,OAAO,IAAI,CAC5B;EAED,KAAK,MAAME,QAAQ,IAAID,SAAS,EAAE;IAChC,IAAIE,IAAoB,GAAG,IAAI;IAC/B,IAAI;MACFA,IAAI,GAAGJ,QAAQ,CAACK,aAAa,CAACF,QAAQ,CAAC;IACzC,CAAC,CAAC,MAAM;MACN;AACN;MACMC,IAAI,GAAG,IAAI;IACb;IACA,IAAIA,IAAI,KAAK,IAAI,EAAE;IAEnB,MAAME,MAAM,GAAGhB,cAAc,CAACc,IAAI,CAAC,GAC/BA,IAAI,GACJA,IAAI,CAACC,aAAa,CAACtB,gBAAgB,CAAC;IAExC,IAAI,CAACO,cAAc,CAACgB,MAAM,CAAC,EAAE;IAE7B,IAAIP,OAAO,CAACQ,MAAM,KAAK,KAAK,EAAE;MAC5B,IAAI;QACFD,MAAM,CAACE,cAAc,CAAC;UAAEC,KAAK,EAAE,QAAQ;UAAEC,QAAQ,EAAE;QAAO,CAAC,CAAC;MAC9D,CAAC,CAAC,MAAM;QACN;AACR;MADQ;IAGJ;IAEAJ,MAAM,CAACK,KAAK,CAAC,CAAC;IACd,OAAO,IAAI;EACb;EAEA,OAAO,KAAK;AACd;;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACe,SAASC,kBAAkBA,CAAC;EACzCC,MAAM;EACNC,KAAK;EACLC,WAAW,GAAG,CAAC;EACfC,OAAO,GAAG,IAAI;EACdT,MAAM,GAAG;AACgB,CAAC,EAAQ;EAClC;EACA,MAAMU,UAAU,GAAG,IAAAC,aAAM,EAAC,CAAC,CAAC;EAE5B,IAAAC,gBAAS,EAAC,MAAM;IACd,IAAI,CAACH,OAAO,EAAE,OAAOI,SAAS;IAC9B,IAAIL,WAAW,IAAIE,UAAU,CAACI,OAAO,EAAE,OAAOD,SAAS;IACvD,IAAI,CAACP,MAAM,EAAE,OAAOO,SAAS;IAE7B,MAAME,KAAK,GACTR,KAAK,KAAKM,SAAS,IAAIN,KAAK,CAAClB,MAAM,GAAG,CAAC,GAAGkB,KAAK,GAAGS,MAAM,CAACC,IAAI,CAACX,MAAM,CAAC;IAEvE,MAAMY,KAAK,GAAGH,KAAK,CAACI,IAAI,CAAE5B,IAAI,IAAK6B,OAAO,CAACd,MAAM,CAACf,IAAI,CAAC,CAAC,CAAC;;IAEzD;AACJ;AACA;IACI,IAAI2B,KAAK,KAAKL,SAAS,EAAE,OAAOA,SAAS;IAEzCH,UAAU,CAACI,OAAO,GAAGN,WAAW;;IAEhC;AACJ;IACI,MAAMa,KAAK,GAAGC,qBAAqB,CAAC,MAAM;MACxC,MAAMC,OAAO,GAAGjC,gBAAgB,CAAC4B,KAAK,EAAE;QAAElB;MAAO,CAAC,CAAC;MAEnD,IAAI,CAACuB,OAAO,IAAIC,OAAO,CAACC,GAAG,CAAC,UAAU,CAAC,KAAK,YAAY,EAAE;QACxD;QACAC,OAAO,CAACC,IAAI,CACV,4CAA4CT,KAAK,kBAAkB,GACjE,mEAAmE,GACnE,mEAAmE,GACnE,oEAAoE,GACpE,oEAAoE,GACpE,qBACJ,CAAC;MACH;IACF,CAAC,CAAC;IAEF,OAAO,MAAMU,oBAAoB,CAACP,KAAK,CAAC;EAC1C,CAAC,EAAE,CAACf,MAAM,EAAEC,KAAK,EAAEC,WAAW,EAAEC,OAAO,EAAET,MAAM,CAAC,CAAC;AACnD","ignoreList":[]}