@portnet/ui 6.0.1 → 6.0.3

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

@@ -1 +1 @@
-{"version":3,"file":"useFocusFirstError.js","names":["useEffect","useRef","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","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,SAASA,SAAS,EAAEC,MAAM,QAAQ,OAAO;;AAEzC;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;AACA,OAAO,SAASC,gBAAgBA,CAC9BC,IAAY,EAEH;EAAA,IADTC,OAA0B,GAAAC,SAAA,CAAAJ,MAAA,QAAAI,SAAA,QAAAC,SAAA,GAAAD,SAAA,MAAG,CAAC,CAAC;EAE/B,IAAI,OAAOE,QAAQ,KAAK,WAAW,EAAE,OAAO,KAAK;EACjD,IAAI,CAACJ,IAAI,EAAE,OAAO,KAAK;EAEvB,IAAMK,OAAO,GAAGnB,oBAAoB,CAACc,IAAI,CAAC;;EAE1C;EACA,IAAMM,SAAS,GAAG,UAAAC,MAAA,CACRF,OAAO,qBAAAE,MAAA,CACLF,OAAO,2BAAAE,MAAA,CACDF,OAAO,SACxB;EAED,SAAAG,EAAA,MAAAC,UAAA,GAAuBH,SAAS,EAAAE,EAAA,GAAAC,UAAA,CAAAX,MAAA,EAAAU,EAAA,IAAE;IAA7B,IAAME,QAAQ,GAAAD,UAAA,CAAAD,EAAA;IACjB,IAAIG,IAAoB,GAAG,IAAI;IAC/B,IAAI;MACFA,IAAI,GAAGP,QAAQ,CAACQ,aAAa,CAACF,QAAQ,CAAC;IACzC,CAAC,CAAC,OAAAG,OAAA,EAAM;MACN;AACN;MACMF,IAAI,GAAG,IAAI;IACb;IACA,IAAIA,IAAI,KAAK,IAAI,EAAE;IAEnB,IAAMG,MAAM,GAAGtB,cAAc,CAACmB,IAAI,CAAC,GAC/BA,IAAI,GACJA,IAAI,CAACC,aAAa,CAAC3B,gBAAgB,CAAC;IAExC,IAAI,CAACO,cAAc,CAACsB,MAAM,CAAC,EAAE;IAE7B,IAAIb,OAAO,CAACc,MAAM,KAAK,KAAK,EAAE;MAC5B,IAAI;QACFD,MAAM,CAACE,cAAc,CAAC;UAAEC,KAAK,EAAE,QAAQ;UAAEC,QAAQ,EAAE;QAAO,CAAC,CAAC;MAC9D,CAAC,CAAC,OAAAC,QAAA,EAAM;QACN;AACR;MADQ;IAGJ;IAEAL,MAAM,CAACM,KAAK,CAAC,CAAC;IACd,OAAO,IAAI;EACb;EAEA,OAAO,KAAK;AACd;;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,eAAe,SAASC,kBAAkBA,CAAAC,IAAA,EAMN;EAAA,IALlCC,MAAM,GAAAD,IAAA,CAANC,MAAM;IACNC,KAAK,GAAAF,IAAA,CAALE,KAAK;IAAAC,gBAAA,GAAAH,IAAA,CACLI,WAAW;IAAXA,WAAW,GAAAD,gBAAA,cAAG,CAAC,GAAAA,gBAAA;IAAAE,YAAA,GAAAL,IAAA,CACfM,OAAO;IAAPA,OAAO,GAAAD,YAAA,cAAG,IAAI,GAAAA,YAAA;IAAAE,WAAA,GAAAP,IAAA,CACdP,MAAM;IAANA,MAAM,GAAAc,WAAA,cAAG,IAAI,GAAAA,WAAA;EAEb;EACA,IAAMC,UAAU,GAAG9C,MAAM,CAAC,CAAC,CAAC;EAE5BD,SAAS,CAAC,YAAM;IACd,IAAI,CAAC6C,OAAO,EAAE,OAAOzB,SAAS;IAC9B,IAAIuB,WAAW,IAAII,UAAU,CAACC,OAAO,EAAE,OAAO5B,SAAS;IACvD,IAAI,CAACoB,MAAM,EAAE,OAAOpB,SAAS;IAE7B,IAAM6B,KAAK,GACTR,KAAK,KAAKrB,SAAS,IAAIqB,KAAK,CAAC1B,MAAM,GAAG,CAAC,GAAG0B,KAAK,GAAGS,MAAM,CAACC,IAAI,CAACX,MAAM,CAAC;IAEvE,IAAMY,KAAK,GAAGH,KAAK,CAACI,IAAI,CAAC,UAACpC,IAAI;MAAA,OAAKqC,OAAO,CAACd,MAAM,CAACvB,IAAI,CAAC,CAAC;IAAA,EAAC;;IAEzD;AACJ;AACA;IACI,IAAImC,KAAK,KAAKhC,SAAS,EAAE,OAAOA,SAAS;IAEzC2B,UAAU,CAACC,OAAO,GAAGL,WAAW;;IAEhC;AACJ;IACI,IAAMY,KAAK,GAAGC,qBAAqB,CAAC,YAAM;MACxC,IAAMC,OAAO,GAAGzC,gBAAgB,CAACoC,KAAK,EAAE;QAAEpB,MAAM,EAANA;MAAO,CAAC,CAAC;MAEnD,IAAI,CAACyB,OAAO,IAAIC,OAAO,CAACC,GAAG,CAAC,UAAU,CAAC,KAAK,YAAY,EAAE;QACxD;QACAC,OAAO,CAACC,IAAI,CACV,6CAAArC,MAAA,CAA4C4B,KAAK,8BAC/C,mEAAmE,GACnE,mEAAmE,GACnE,oEAAoE,GACpE,oEAAoE,GACpE,qBACJ,CAAC;MACH;IACF,CAAC,CAAC;IAEF,OAAO;MAAA,OAAMU,oBAAoB,CAACP,KAAK,CAAC;IAAA;EAC1C,CAAC,EAAE,CAACf,MAAM,EAAEC,KAAK,EAAEE,WAAW,EAAEE,OAAO,EAAEb,MAAM,CAAC,CAAC;AACnD","ignoreList":[]}
+{"version":3,"file":"useFocusFirstError.js","names":["useEffect","useRef","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","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,SAASA,SAAS,EAAEC,MAAM,QAAQ,OAAO;;AAEzC;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;AACA,OAAO,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;AACA,eAAe,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,GAAGnC,MAAM,CAAC,CAAC,CAAC;EAE5BD,SAAS,CAAC,MAAM;IACd,IAAI,CAACmC,OAAO,EAAE,OAAOE,SAAS;IAC9B,IAAIH,WAAW,IAAIE,UAAU,CAACE,OAAO,EAAE,OAAOD,SAAS;IACvD,IAAI,CAACL,MAAM,EAAE,OAAOK,SAAS;IAE7B,MAAME,KAAK,GACTN,KAAK,KAAKI,SAAS,IAAIJ,KAAK,CAAClB,MAAM,GAAG,CAAC,GAAGkB,KAAK,GAAGO,MAAM,CAACC,IAAI,CAACT,MAAM,CAAC;IAEvE,MAAMU,KAAK,GAAGH,KAAK,CAACI,IAAI,CAAE1B,IAAI,IAAK2B,OAAO,CAACZ,MAAM,CAACf,IAAI,CAAC,CAAC,CAAC;;IAEzD;AACJ;AACA;IACI,IAAIyB,KAAK,KAAKL,SAAS,EAAE,OAAOA,SAAS;IAEzCD,UAAU,CAACE,OAAO,GAAGJ,WAAW;;IAEhC;AACJ;IACI,MAAMW,KAAK,GAAGC,qBAAqB,CAAC,MAAM;MACxC,MAAMC,OAAO,GAAG/B,gBAAgB,CAAC0B,KAAK,EAAE;QAAEhB;MAAO,CAAC,CAAC;MAEnD,IAAI,CAACqB,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,CAACb,MAAM,EAAEC,KAAK,EAAEC,WAAW,EAAEC,OAAO,EAAET,MAAM,CAAC,CAAC;AACnD","ignoreList":[]}

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

@@ -0,0 +1,81 @@
+import * as React from "react";
+
+/**
+ * useFocusOnRouteChange — move focus to the main landmark when the page changes
+ *
+ * ─────────────────────────────────────────────────────────────────────────────
+ * WHY THIS EXISTS (capability gap G-60)
+ *
+ * In a single-page application, navigating does NOT move focus. The browser
+ * only does that on a real document load. So after a route change the focus
+ * stays on whatever was clicked — or, when that element is unmounted by the
+ * very navigation it triggered, falls to `document.body`.
+ *
+ * From `document.body`, a keyboard user's next Tab starts at the top of the
+ * BROWSER, not of the page: they walk the address bar and the toolbar again on
+ * every screen. A screen-reader user gets no announcement at all — the new page
+ * simply exists, silently, and they must go looking for it. WCAG 2.4.3 (Focus
+ * Order) is what this fails, and nothing on screen shows it: the pixels are
+ * perfect.
+ *
+ * The failure is at its worst where a navigation follows an ACTION, because the
+ * trigger is gone by the time focus would return to it. Observed in
+ * `autorisation-admis-pour-conforme-fe` (Area 10): archiving a dossier closes a
+ * confirmation dialog and navigates back, so the dialog's focus trap restores
+ * focus to a button that no longer exists.
+ *
+ * The library is the right home even though it knows nothing about routers:
+ * `AppMain` — the landmark this hook targets — is the library's, and it is
+ * `AppMain` that carries the `tabIndex={-1}` making the region focusable at
+ * all. A host wiring this by hand would be reimplementing the pairing that
+ * `SkipLink` + `AppMain` already own.
+ * ─────────────────────────────────────────────────────────────────────────────
+ *
+ * ROUTER-AGNOSTIC BY CONSTRUCTION. No router is imported; the host passes the
+ * key it wants to watch:
+ *
+ *   const { pathname } = useLocation();
+ *   useFocusOnRouteChange(pathname);
+ *
+ * PASS THE PATHNAME, NOT `location.key` NOR THE FULL URL. A list screen writes
+ * its filters, its page number and its sort into the query string, and each of
+ * those is a new `key`: watching it would steal focus from the input the user
+ * is typing in, mid-search. What deserves a focus move is a change of PAGE, not
+ * a change of page state.
+ *
+ * THE FIRST RENDER IS SKIPPED. On initial load the browser has already placed
+ * focus at the start of the document, which is where a user expects it —
+ * moving it then would fight the browser and, worse, scroll a deep-linked page
+ * away from its anchor.
+ */
+
+export function useFocusOnRouteChange(routeKey, options = {}) {
+  const {
+    targetId = "main-content",
+    enabled = true
+  } = options;
+
+  /* The previous key, NOT a boolean "has mounted": comparing keys is what lets
+     the effect run once per actual change, and skip the first render without a
+     second piece of state. */
+  const previousKeyRef = React.useRef(routeKey);
+  React.useEffect(() => {
+    if (!enabled) return;
+    if (previousKeyRef.current === routeKey) return;
+    previousKeyRef.current = routeKey;
+    const target = document.getElementById(targetId);
+    /* Silently doing nothing is deliberate: a host may render this hook on a
+       shell that mounts BEFORE its landmark (a pre-auth screen, an error
+       boundary). Throwing there would replace a missing focus move with a
+       crash. */
+    if (target === null) return;
+
+    /* `preventScroll` is NOT set: bringing the top of the region into view is
+       part of what the user expects from a page change, and suppressing it
+       would leave a long list scrolled where the previous page had left it
+       while the focus ring sits off-screen. */
+    target.focus();
+  }, [routeKey, targetId, enabled]);
+}
+export default useFocusOnRouteChange;
+//# sourceMappingURL=useFocusOnRouteChange.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"useFocusOnRouteChange.js","names":["React","useFocusOnRouteChange","routeKey","options","targetId","enabled","previousKeyRef","useRef","useEffect","current","target","document","getElementById","focus"],"sources":["../../../../src/lib/v2/hooks/useFocusOnRouteChange.ts"],"sourcesContent":["import * as React from \"react\";\r\n\r\n/**\r\n * useFocusOnRouteChange — move focus to the main landmark when the page changes\r\n *\r\n * ─────────────────────────────────────────────────────────────────────────────\r\n * WHY THIS EXISTS (capability gap G-60)\r\n *\r\n * In a single-page application, navigating does NOT move focus. The browser\r\n * only does that on a real document load. So after a route change the focus\r\n * stays on whatever was clicked — or, when that element is unmounted by the\r\n * very navigation it triggered, falls to `document.body`.\r\n *\r\n * From `document.body`, a keyboard user's next Tab starts at the top of the\r\n * BROWSER, not of the page: they walk the address bar and the toolbar again on\r\n * every screen. A screen-reader user gets no announcement at all — the new page\r\n * simply exists, silently, and they must go looking for it. WCAG 2.4.3 (Focus\r\n * Order) is what this fails, and nothing on screen shows it: the pixels are\r\n * perfect.\r\n *\r\n * The failure is at its worst where a navigation follows an ACTION, because the\r\n * trigger is gone by the time focus would return to it. Observed in\r\n * `autorisation-admis-pour-conforme-fe` (Area 10): archiving a dossier closes a\r\n * confirmation dialog and navigates back, so the dialog's focus trap restores\r\n * focus to a button that no longer exists.\r\n *\r\n * The library is the right home even though it knows nothing about routers:\r\n * `AppMain` — the landmark this hook targets — is the library's, and it is\r\n * `AppMain` that carries the `tabIndex={-1}` making the region focusable at\r\n * all. A host wiring this by hand would be reimplementing the pairing that\r\n * `SkipLink` + `AppMain` already own.\r\n * ─────────────────────────────────────────────────────────────────────────────\r\n *\r\n * ROUTER-AGNOSTIC BY CONSTRUCTION. No router is imported; the host passes the\r\n * key it wants to watch:\r\n *\r\n *   const { pathname } = useLocation();\r\n *   useFocusOnRouteChange(pathname);\r\n *\r\n * PASS THE PATHNAME, NOT `location.key` NOR THE FULL URL. A list screen writes\r\n * its filters, its page number and its sort into the query string, and each of\r\n * those is a new `key`: watching it would steal focus from the input the user\r\n * is typing in, mid-search. What deserves a focus move is a change of PAGE, not\r\n * a change of page state.\r\n *\r\n * THE FIRST RENDER IS SKIPPED. On initial load the browser has already placed\r\n * focus at the start of the document, which is where a user expects it —\r\n * moving it then would fight the browser and, worse, scroll a deep-linked page\r\n * away from its anchor.\r\n */\r\n\r\nexport interface UseFocusOnRouteChangeOptions {\r\n  /**\r\n   * Id of the element to focus. Defaults to `\"main-content\"` — `AppMain`'s\r\n   * default id, which is also `SkipLink`'s default target. Change all three\r\n   * together or none.\r\n   */\r\n  targetId?: string | undefined;\r\n  /**\r\n   * Set to `false` to suspend the behaviour. Exists for the host that owns a\r\n   * screen where a deliberate focus placement must survive a route change\r\n   * (an embedded wizard step, say) — not as a global off switch.\r\n   */\r\n  enabled?: boolean | undefined;\r\n}\r\n\r\nexport function useFocusOnRouteChange(\r\n  routeKey: string | undefined,\r\n  options: UseFocusOnRouteChangeOptions = {}\r\n): void {\r\n  const { targetId = \"main-content\", enabled = true } = options;\r\n\r\n  /* The previous key, NOT a boolean \"has mounted\": comparing keys is what lets\r\n     the effect run once per actual change, and skip the first render without a\r\n     second piece of state. */\r\n  const previousKeyRef = React.useRef<string | undefined>(routeKey);\r\n\r\n  React.useEffect(() => {\r\n    if (!enabled) return;\r\n    if (previousKeyRef.current === routeKey) return;\r\n    previousKeyRef.current = routeKey;\r\n\r\n    const target = document.getElementById(targetId);\r\n    /* Silently doing nothing is deliberate: a host may render this hook on a\r\n       shell that mounts BEFORE its landmark (a pre-auth screen, an error\r\n       boundary). Throwing there would replace a missing focus move with a\r\n       crash. */\r\n    if (target === null) return;\r\n\r\n    /* `preventScroll` is NOT set: bringing the top of the region into view is\r\n       part of what the user expects from a page change, and suppressing it\r\n       would leave a long list scrolled where the previous page had left it\r\n       while the focus ring sits off-screen. */\r\n    target.focus();\r\n  }, [routeKey, targetId, enabled]);\r\n}\r\n\r\nexport default useFocusOnRouteChange;\r\n"],"mappings":"AAAA,OAAO,KAAKA,KAAK,MAAM,OAAO;;AAE9B;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;;AAiBA,OAAO,SAASC,qBAAqBA,CACnCC,QAA4B,EAC5BC,OAAqC,GAAG,CAAC,CAAC,EACpC;EACN,MAAM;IAAEC,QAAQ,GAAG,cAAc;IAAEC,OAAO,GAAG;EAAK,CAAC,GAAGF,OAAO;;EAE7D;AACF;AACA;EACE,MAAMG,cAAc,GAAGN,KAAK,CAACO,MAAM,CAAqBL,QAAQ,CAAC;EAEjEF,KAAK,CAACQ,SAAS,CAAC,MAAM;IACpB,IAAI,CAACH,OAAO,EAAE;IACd,IAAIC,cAAc,CAACG,OAAO,KAAKP,QAAQ,EAAE;IACzCI,cAAc,CAACG,OAAO,GAAGP,QAAQ;IAEjC,MAAMQ,MAAM,GAAGC,QAAQ,CAACC,cAAc,CAACR,QAAQ,CAAC;IAChD;AACJ;AACA;AACA;IACI,IAAIM,MAAM,KAAK,IAAI,EAAE;;IAErB;AACJ;AACA;AACA;IACIA,MAAM,CAACG,KAAK,CAAC,CAAC;EAChB,CAAC,EAAE,CAACX,QAAQ,EAAEE,QAAQ,EAAEC,OAAO,CAAC,CAAC;AACnC;AAEA,eAAeJ,qBAAqB","ignoreList":[]}

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

@@ -57,8 +57,8 @@ import { useEffect } from "react";
  * @param isActive Whether the trap is currently on.
  */
 
-var FOCUSABLE_SELECTORS = ["a[href]", "button:not(:disabled)", "input:not(:disabled)", "select:not(:disabled)", "textarea:not(:disabled)", '[tabindex]:not([tabindex="-1"])', '[contenteditable]:not([contenteditable="false"])', "audio[controls]", "video[controls]"].join(", ");
-var AUTOFOCUS_SELECTORS = "[autofocus], [data-autofocus]";
+const FOCUSABLE_SELECTORS = ["a[href]", "button:not(:disabled)", "input:not(:disabled)", "select:not(:disabled)", "textarea:not(:disabled)", '[tabindex]:not([tabindex="-1"])', '[contenteditable]:not([contenteditable="false"])', "audio[controls]", "video[controls]"].join(", ");
+const AUTOFOCUS_SELECTORS = "[autofocus], [data-autofocus]";
 
 /**
  * Module-level stack of active trap containers. Only the LAST entry
@@ -66,7 +66,7 @@ var AUTOFOCUS_SELECTORS = "[autofocus], [data-autofocus]";
  * pass-through. Cleanup pops by reference to tolerate out-of-order
  * unmount sequences (portal teardown, hot-replace).
  */
-var trapStack = [];
+const trapStack = [];
 
 /**
  * Is `container` the INNERMOST active trap?
@@ -89,9 +89,7 @@ var trapStack = [];
  * the inner trap pops, the outer contains nothing and resumes duty.
  */
 function isInnermostTrap(container) {
-  return !trapStack.some(function (other) {
-    return other !== container && container.contains(other);
-  });
+  return !trapStack.some(other => other !== container && container.contains(other));
 }
 
 /**
@@ -111,7 +109,7 @@ function isVisuallyFocusable(el) {
     return false;
   }
   // Walk ancestors for hidden / aria-hidden / inert.
-  var node = el;
+  let node = el;
   while (node && node !== document.body) {
     if (node.hasAttribute && (node.hasAttribute("inert") || node.hasAttribute("hidden") || node.getAttribute("aria-hidden") === "true")) {
       return false;
@@ -121,19 +119,17 @@ function isVisuallyFocusable(el) {
   return true;
 }
 export default function useFocusTrap(ref, isActive) {
-  useEffect(function () {
+  useEffect(() => {
     if (!isActive || !ref.current) return undefined;
-    var container = ref.current;
+    const container = ref.current;
     trapStack.push(container);
-    var getFocusable = function getFocusable() {
-      return Array.from(container.querySelectorAll(FOCUSABLE_SELECTORS)).filter(isVisuallyFocusable);
-    };
-    var trigger = document.activeElement;
+    const getFocusable = () => Array.from(container.querySelectorAll(FOCUSABLE_SELECTORS)).filter(isVisuallyFocusable);
+    const trigger = document.activeElement;
 
     // Initial focus, deferred to next frame so React has finished
     // painting any conditional content. Cancellation handle stored
     // so unmount-within-same-frame cannot leak a stale .focus() call.
-    var rafId = requestAnimationFrame(function () {
+    const rafId = requestAnimationFrame(() => {
       /* Only the innermost trap claims initial focus — same predicate as `trap()`
        * below, so keyboard duty and initial focus can never disagree.
        *
@@ -141,26 +137,26 @@ export default function useFocusTrap(ref, isActive) {
        * activation regardless of nesting, so on simultaneous mount the outer
        * trap's rAF fired last and overwrote the inner trap's focus. */
       if (!isInnermostTrap(container)) return;
-      var explicit = container.querySelector(AUTOFOCUS_SELECTORS);
-      var target = explicit && isVisuallyFocusable(explicit) ? explicit : getFocusable()[0];
+      const explicit = container.querySelector(AUTOFOCUS_SELECTORS);
+      const target = explicit && isVisuallyFocusable(explicit) ? explicit : getFocusable()[0];
       if (target && typeof target.focus === "function") target.focus();
     });
-    var trap = function trap(e) {
+    const trap = e => {
       if (e.key !== "Tab") return;
       // Only the innermost trap acts. Outer traps stay registered and defer.
       // Containment, NOT stack position — see isInnermostTrap.
       if (!isInnermostTrap(container)) return;
-      var els = getFocusable();
+      const els = getFocusable();
       if (!els.length) {
         // Pathological case (no focusable inside): swallow Tab so
         // focus cannot escape into the page behind the trap.
         e.preventDefault();
         return;
       }
-      var first = els[0];
-      var last = els[els.length - 1];
+      const first = els[0];
+      const last = els[els.length - 1];
       if (!first || !last) return;
-      var active = document.activeElement;
+      const active = document.activeElement;
 
       // Recovery: if focus is currently OUTSIDE the container, warp it
       // back to the first focusable. Without this, an escaped focus
@@ -180,12 +176,12 @@ export default function useFocusTrap(ref, isActive) {
       }
     };
     document.addEventListener("keydown", trap, true);
-    return function () {
+    return () => {
       cancelAnimationFrame(rafId);
 
       // Pop by reference (NOT by index) — tolerates out-of-order
       // unmount sequences during portal teardown or hot-replace.
-      var idx = trapStack.lastIndexOf(container);
+      const idx = trapStack.lastIndexOf(container);
       if (idx >= 0) trapStack.splice(idx, 1);
       document.removeEventListener("keydown", trap, true);
 

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

@@ -1 +1 @@
-{"version":3,"file":"useFocusTrap.js","names":["useEffect","FOCUSABLE_SELECTORS","join","AUTOFOCUS_SELECTORS","trapStack","isInnermostTrap","container","some","other","contains","isVisuallyFocusable","el","disabled","getAttribute","getClientRects","length","node","document","body","hasAttribute","parentElement","useFocusTrap","ref","isActive","current","undefined","push","getFocusable","Array","from","querySelectorAll","filter","trigger","activeElement","rafId","requestAnimationFrame","explicit","querySelector","target","focus","trap","e","key","els","preventDefault","first","last","active","shiftKey","addEventListener","cancelAnimationFrame","idx","lastIndexOf","splice","removeEventListener"],"sources":["../../../../src/lib/v2/hooks/useFocusTrap.ts"],"sourcesContent":["import { useEffect, type RefObject } from \"react\";\r\n\r\n/**\r\n * useFocusTrap — Portnet UI v2\r\n *\r\n * Traps Tab / Shift+Tab inside `ref` while `isActive`.\r\n * On activation, focuses the first `[autofocus]` / `[data-autofocus]`\r\n * descendant if present, otherwise the first focusable child.\r\n * On deactivation, restores focus to the element that previously held\r\n * it (only if still in the DOM).\r\n *\r\n * WCAG 2.4.3, charter R-F.2.\r\n *\r\n * Implementation notes\r\n *   - Keydown listener attached to `document` in capture phase. If\r\n *     focus has somehow escaped the container, the next Tab is caught\r\n *     and warped back inside.\r\n *   - NESTED TRAPS — only the topmost trap on `trapStack` intercepts\r\n *     Tab. Outer traps stay registered and resume duty when the inner\r\n *     trap unmounts. This makes ConfirmDialog-in-Drawer-in-Modal\r\n *     flows behave correctly.\r\n *   - Focusable elements are filtered to exclude those inside\r\n *     aria-hidden / inert / hidden / display:none subtrees, even\r\n *     though querySelectorAll happily returns them.\r\n *   - BOUNDARY SCOPE — Tab is intercepted only at the cycle edges\r\n *     (Tab on `last`, Shift+Tab on `first`) plus the escaped-focus\r\n *     recovery path. Mid-cycle moves are deliberately left to the\r\n *     browser's native tab order.\r\n *\r\n *     Consequence worth knowing: the filter above decides what counts\r\n *     as `first` / `last`, so the trap never DELIVERS focus into a\r\n *     filtered element — but it cannot stop the browser tabbing into\r\n *     one mid-cycle. `hidden` and `inert` are unaffected (both remove\r\n *     an element from the native tab order); `aria-hidden` is NOT, as\r\n *     per spec it annotates only the accessibility tree. So a\r\n *     focusable control inside `aria-hidden=\"true\"` IS still reachable\r\n *     by Tab — that is a content defect (axe `aria-hidden-focus`), and\r\n *     the fix is `inert` on the subtree, not more interception here.\r\n *\r\n *     Full per-Tab interception would close that gap, at the cost of\r\n *     taking over native traversal for every Modal / Drawer /\r\n *     ConfirmDialog in the fleet — which also breaks radio-group\r\n *     roving tabindex and any positive `tabindex` ordering. Not done\r\n *     without a browser-level test bed. See the aria-hidden case in\r\n *     __tests__/useFocusTrap.test.tsx.\r\n *   - Cleanup never calls focus() on an unmounted or detached\r\n *     trigger and cancels the initial-focus rAF.\r\n *\r\n * Escape handling is INTENTIONALLY OUT OF SCOPE — the consumer (Modal,\r\n * Drawer, ConfirmDialog) is responsible for closing on Escape per\r\n * R-F.1. Mixing concerns here would force every trap user to opt out.\r\n *\r\n * @param ref      The container ref to trap focus inside. Accepts a\r\n *                 nullable `current` (`RefObject<T | null>`) so callers\r\n *                 can pass `useRef<HTMLElement>(null)` directly without a\r\n *                 cast — the effect no-ops until `current` is populated.\r\n * @param isActive Whether the trap is currently on.\r\n */\r\n\r\nconst FOCUSABLE_SELECTORS = [\r\n  \"a[href]\",\r\n  \"button:not(:disabled)\",\r\n  \"input:not(:disabled)\",\r\n  \"select:not(:disabled)\",\r\n  \"textarea:not(:disabled)\",\r\n  '[tabindex]:not([tabindex=\"-1\"])',\r\n  '[contenteditable]:not([contenteditable=\"false\"])',\r\n  \"audio[controls]\",\r\n  \"video[controls]\",\r\n].join(\", \");\r\n\r\nconst AUTOFOCUS_SELECTORS = \"[autofocus], [data-autofocus]\";\r\n\r\n/**\r\n * Module-level stack of active trap containers. Only the LAST entry\r\n * (innermost trap) intercepts Tab; outer traps stay registered but\r\n * pass-through. Cleanup pops by reference to tolerate out-of-order\r\n * unmount sequences (portal teardown, hot-replace).\r\n */\r\nconst trapStack: HTMLElement[] = [];\r\n\r\n/**\r\n * Is `container` the INNERMOST active trap?\r\n *\r\n * ⚠ DO NOT REPLACE THIS WITH `trapStack[trapStack.length - 1] === container`.\r\n *\r\n * Stack POSITION does not track nesting depth. React runs CHILD effects before\r\n * PARENT effects, so when an outer and an inner trap mount in the SAME commit\r\n * (Modal rendering a ConfirmDialog, Drawer with a nested trap) the INNER trap is\r\n * pushed FIRST and the OUTER one LAST — making the last entry the OUTERMOST trap,\r\n * the exact opposite of the intent.\r\n *\r\n * Push order only happens to match nesting when the traps mount at different\r\n * times, which is the common case and why the bug stayed hidden. The\r\n * simultaneous-mount path gave Tab duty to the trap BEHIND the dialog the user\r\n * was looking at (R-M.2 / R-F.2).\r\n *\r\n * Containment is order-independent: a trap is innermost when no other active\r\n * trap lives inside it. Correct for both mount orderings, and for unmount — once\r\n * the inner trap pops, the outer contains nothing and resumes duty.\r\n */\r\nfunction isInnermostTrap(container: HTMLElement): boolean {\r\n  return !trapStack.some(\r\n    (other) => other !== container && container.contains(other)\r\n  );\r\n}\r\n\r\n/**\r\n * True iff the element is rendered AND not inside an aria-hidden /\r\n * inert / hidden / display:none ancestor. querySelectorAll picks\r\n * those up indiscriminately, so re-filter at use time.\r\n */\r\nfunction isVisuallyFocusable(el: Element | null): el is HTMLElement {\r\n  if (!el) return false;\r\n  if (\"disabled\" in el && el.disabled) return false;\r\n  if (el.getAttribute && el.getAttribute(\"aria-disabled\") === \"true\") return false;\r\n  // Cheap visibility test — covers display:none and visibility:hidden.\r\n  // Note: elements with `display: contents` may report 0 rects but have\r\n  // focusable descendants; the descendants themselves still match if\r\n  // they have their own boxes, so this filter is a reasonable trade-off.\r\n  if (typeof el.getClientRects === \"function\" && el.getClientRects().length === 0) {\r\n    return false;\r\n  }\r\n  // Walk ancestors for hidden / aria-hidden / inert.\r\n  let node: Element | null = el;\r\n  while (node && node !== document.body) {\r\n    if (node.hasAttribute && (\r\n      node.hasAttribute(\"inert\") ||\r\n      node.hasAttribute(\"hidden\") ||\r\n      node.getAttribute(\"aria-hidden\") === \"true\"\r\n    )) {\r\n      return false;\r\n    }\r\n    node = node.parentElement;\r\n  }\r\n  return true;\r\n}\r\n\r\nexport default function useFocusTrap<T extends HTMLElement = HTMLElement>(\r\n  ref: RefObject<T | null>,\r\n  isActive: boolean\r\n): void {\r\n  useEffect(() => {\r\n    if (!isActive || !ref.current) return undefined;\r\n\r\n    const container = ref.current;\r\n    trapStack.push(container);\r\n\r\n    const getFocusable = (): HTMLElement[] =>\r\n      Array.from(container.querySelectorAll(FOCUSABLE_SELECTORS)).filter(isVisuallyFocusable);\r\n\r\n    const trigger = document.activeElement;\r\n\r\n    // Initial focus, deferred to next frame so React has finished\r\n    // painting any conditional content. Cancellation handle stored\r\n    // so unmount-within-same-frame cannot leak a stale .focus() call.\r\n    const rafId = requestAnimationFrame(() => {\r\n      /* Only the innermost trap claims initial focus — same predicate as `trap()`\r\n       * below, so keyboard duty and initial focus can never disagree.\r\n       *\r\n       * Initial focus was previously unguarded: every trap focused on\r\n       * activation regardless of nesting, so on simultaneous mount the outer\r\n       * trap's rAF fired last and overwrote the inner trap's focus. */\r\n      if (!isInnermostTrap(container)) return;\r\n\r\n      const explicit = container.querySelector(AUTOFOCUS_SELECTORS);\r\n      const target = (explicit && isVisuallyFocusable(explicit))\r\n        ? explicit\r\n        : getFocusable()[0];\r\n      if (target && typeof target.focus === \"function\") target.focus();\r\n    });\r\n\r\n    const trap = (e: KeyboardEvent): void => {\r\n      if (e.key !== \"Tab\") return;\r\n      // Only the innermost trap acts. Outer traps stay registered and defer.\r\n      // Containment, NOT stack position — see isInnermostTrap.\r\n      if (!isInnermostTrap(container)) return;\r\n\r\n      const els = getFocusable();\r\n      if (!els.length) {\r\n        // Pathological case (no focusable inside): swallow Tab so\r\n        // focus cannot escape into the page behind the trap.\r\n        e.preventDefault();\r\n        return;\r\n      }\r\n      const first = els[0];\r\n      const last = els[els.length - 1];\r\n      if (!first || !last) return;\r\n      const active = document.activeElement;\r\n\r\n      // Recovery: if focus is currently OUTSIDE the container, warp it\r\n      // back to the first focusable. Without this, an escaped focus\r\n      // (mount race, programmatic blur, SR virtual cursor) leaks Tab\r\n      // navigation to the page behind the trap.\r\n      if (!container.contains(active)) {\r\n        e.preventDefault();\r\n        first.focus();\r\n        return;\r\n      }\r\n\r\n      if (e.shiftKey && active === first) {\r\n        e.preventDefault();\r\n        last.focus();\r\n      } else if (!e.shiftKey && active === last) {\r\n        e.preventDefault();\r\n        first.focus();\r\n      }\r\n    };\r\n\r\n    document.addEventListener(\"keydown\", trap, true);\r\n\r\n    return () => {\r\n      cancelAnimationFrame(rafId);\r\n\r\n      // Pop by reference (NOT by index) — tolerates out-of-order\r\n      // unmount sequences during portal teardown or hot-replace.\r\n      const idx = trapStack.lastIndexOf(container);\r\n      if (idx >= 0) trapStack.splice(idx, 1);\r\n\r\n      document.removeEventListener(\"keydown\", trap, true);\r\n\r\n      // Restore focus only if the trigger is still mounted, focusable,\r\n      // and not currently disabled. Calling .focus() on a detached or\r\n      // disabled node silently leaves focus on <body> with no visible\r\n      // indicator — actively user-hostile.\r\n      if (\r\n        trigger &&\r\n        trigger !== document.body &&\r\n        \"focus\" in trigger &&\r\n        typeof trigger.focus === \"function\" &&\r\n        document.body.contains(trigger) &&\r\n        !(\"disabled\" in trigger && trigger.disabled)\r\n      ) {\r\n        trigger.focus();\r\n      }\r\n    };\r\n  }, [isActive, ref]);\r\n}\r\n"],"mappings":"AAAA,SAASA,SAAS,QAAwB,OAAO;;AAEjD;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,IAAMC,mBAAmB,GAAG,CAC1B,SAAS,EACT,uBAAuB,EACvB,sBAAsB,EACtB,uBAAuB,EACvB,yBAAyB,EACzB,iCAAiC,EACjC,kDAAkD,EAClD,iBAAiB,EACjB,iBAAiB,CAClB,CAACC,IAAI,CAAC,IAAI,CAAC;AAEZ,IAAMC,mBAAmB,GAAG,+BAA+B;;AAE3D;AACA;AACA;AACA;AACA;AACA;AACA,IAAMC,SAAwB,GAAG,EAAE;;AAEnC;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,SAASC,eAAeA,CAACC,SAAsB,EAAW;EACxD,OAAO,CAACF,SAAS,CAACG,IAAI,CACpB,UAACC,KAAK;IAAA,OAAKA,KAAK,KAAKF,SAAS,IAAIA,SAAS,CAACG,QAAQ,CAACD,KAAK,CAAC;EAAA,CAC7D,CAAC;AACH;;AAEA;AACA;AACA;AACA;AACA;AACA,SAASE,mBAAmBA,CAACC,EAAkB,EAAqB;EAClE,IAAI,CAACA,EAAE,EAAE,OAAO,KAAK;EACrB,IAAI,UAAU,IAAIA,EAAE,IAAIA,EAAE,CAACC,QAAQ,EAAE,OAAO,KAAK;EACjD,IAAID,EAAE,CAACE,YAAY,IAAIF,EAAE,CAACE,YAAY,CAAC,eAAe,CAAC,KAAK,MAAM,EAAE,OAAO,KAAK;EAChF;EACA;EACA;EACA;EACA,IAAI,OAAOF,EAAE,CAACG,cAAc,KAAK,UAAU,IAAIH,EAAE,CAACG,cAAc,CAAC,CAAC,CAACC,MAAM,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","ignoreList":[]}
+{"version":3,"file":"useFocusTrap.js","names":["useEffect","FOCUSABLE_SELECTORS","join","AUTOFOCUS_SELECTORS","trapStack","isInnermostTrap","container","some","other","contains","isVisuallyFocusable","el","disabled","getAttribute","getClientRects","length","node","document","body","hasAttribute","parentElement","useFocusTrap","ref","isActive","current","undefined","push","getFocusable","Array","from","querySelectorAll","filter","trigger","activeElement","rafId","requestAnimationFrame","explicit","querySelector","target","focus","trap","e","key","els","preventDefault","first","last","active","shiftKey","addEventListener","cancelAnimationFrame","idx","lastIndexOf","splice","removeEventListener"],"sources":["../../../../src/lib/v2/hooks/useFocusTrap.ts"],"sourcesContent":["import { useEffect, type RefObject } from \"react\";\r\n\r\n/**\r\n * useFocusTrap — Portnet UI v2\r\n *\r\n * Traps Tab / Shift+Tab inside `ref` while `isActive`.\r\n * On activation, focuses the first `[autofocus]` / `[data-autofocus]`\r\n * descendant if present, otherwise the first focusable child.\r\n * On deactivation, restores focus to the element that previously held\r\n * it (only if still in the DOM).\r\n *\r\n * WCAG 2.4.3, charter R-F.2.\r\n *\r\n * Implementation notes\r\n *   - Keydown listener attached to `document` in capture phase. If\r\n *     focus has somehow escaped the container, the next Tab is caught\r\n *     and warped back inside.\r\n *   - NESTED TRAPS — only the topmost trap on `trapStack` intercepts\r\n *     Tab. Outer traps stay registered and resume duty when the inner\r\n *     trap unmounts. This makes ConfirmDialog-in-Drawer-in-Modal\r\n *     flows behave correctly.\r\n *   - Focusable elements are filtered to exclude those inside\r\n *     aria-hidden / inert / hidden / display:none subtrees, even\r\n *     though querySelectorAll happily returns them.\r\n *   - BOUNDARY SCOPE — Tab is intercepted only at the cycle edges\r\n *     (Tab on `last`, Shift+Tab on `first`) plus the escaped-focus\r\n *     recovery path. Mid-cycle moves are deliberately left to the\r\n *     browser's native tab order.\r\n *\r\n *     Consequence worth knowing: the filter above decides what counts\r\n *     as `first` / `last`, so the trap never DELIVERS focus into a\r\n *     filtered element — but it cannot stop the browser tabbing into\r\n *     one mid-cycle. `hidden` and `inert` are unaffected (both remove\r\n *     an element from the native tab order); `aria-hidden` is NOT, as\r\n *     per spec it annotates only the accessibility tree. So a\r\n *     focusable control inside `aria-hidden=\"true\"` IS still reachable\r\n *     by Tab — that is a content defect (axe `aria-hidden-focus`), and\r\n *     the fix is `inert` on the subtree, not more interception here.\r\n *\r\n *     Full per-Tab interception would close that gap, at the cost of\r\n *     taking over native traversal for every Modal / Drawer /\r\n *     ConfirmDialog in the fleet — which also breaks radio-group\r\n *     roving tabindex and any positive `tabindex` ordering. Not done\r\n *     without a browser-level test bed. See the aria-hidden case in\r\n *     __tests__/useFocusTrap.test.tsx.\r\n *   - Cleanup never calls focus() on an unmounted or detached\r\n *     trigger and cancels the initial-focus rAF.\r\n *\r\n * Escape handling is INTENTIONALLY OUT OF SCOPE — the consumer (Modal,\r\n * Drawer, ConfirmDialog) is responsible for closing on Escape per\r\n * R-F.1. Mixing concerns here would force every trap user to opt out.\r\n *\r\n * @param ref      The container ref to trap focus inside. Accepts a\r\n *                 nullable `current` (`RefObject<T | null>`) so callers\r\n *                 can pass `useRef<HTMLElement>(null)` directly without a\r\n *                 cast — the effect no-ops until `current` is populated.\r\n * @param isActive Whether the trap is currently on.\r\n */\r\n\r\nconst FOCUSABLE_SELECTORS = [\r\n  \"a[href]\",\r\n  \"button:not(:disabled)\",\r\n  \"input:not(:disabled)\",\r\n  \"select:not(:disabled)\",\r\n  \"textarea:not(:disabled)\",\r\n  '[tabindex]:not([tabindex=\"-1\"])',\r\n  '[contenteditable]:not([contenteditable=\"false\"])',\r\n  \"audio[controls]\",\r\n  \"video[controls]\",\r\n].join(\", \");\r\n\r\nconst AUTOFOCUS_SELECTORS = \"[autofocus], [data-autofocus]\";\r\n\r\n/**\r\n * Module-level stack of active trap containers. Only the LAST entry\r\n * (innermost trap) intercepts Tab; outer traps stay registered but\r\n * pass-through. Cleanup pops by reference to tolerate out-of-order\r\n * unmount sequences (portal teardown, hot-replace).\r\n */\r\nconst trapStack: HTMLElement[] = [];\r\n\r\n/**\r\n * Is `container` the INNERMOST active trap?\r\n *\r\n * ⚠ DO NOT REPLACE THIS WITH `trapStack[trapStack.length - 1] === container`.\r\n *\r\n * Stack POSITION does not track nesting depth. React runs CHILD effects before\r\n * PARENT effects, so when an outer and an inner trap mount in the SAME commit\r\n * (Modal rendering a ConfirmDialog, Drawer with a nested trap) the INNER trap is\r\n * pushed FIRST and the OUTER one LAST — making the last entry the OUTERMOST trap,\r\n * the exact opposite of the intent.\r\n *\r\n * Push order only happens to match nesting when the traps mount at different\r\n * times, which is the common case and why the bug stayed hidden. The\r\n * simultaneous-mount path gave Tab duty to the trap BEHIND the dialog the user\r\n * was looking at (R-M.2 / R-F.2).\r\n *\r\n * Containment is order-independent: a trap is innermost when no other active\r\n * trap lives inside it. Correct for both mount orderings, and for unmount — once\r\n * the inner trap pops, the outer contains nothing and resumes duty.\r\n */\r\nfunction isInnermostTrap(container: HTMLElement): boolean {\r\n  return !trapStack.some(\r\n    (other) => other !== container && container.contains(other)\r\n  );\r\n}\r\n\r\n/**\r\n * True iff the element is rendered AND not inside an aria-hidden /\r\n * inert / hidden / display:none ancestor. querySelectorAll picks\r\n * those up indiscriminately, so re-filter at use time.\r\n */\r\nfunction isVisuallyFocusable(el: Element | null): el is HTMLElement {\r\n  if (!el) return false;\r\n  if (\"disabled\" in el && el.disabled) return false;\r\n  if (el.getAttribute && el.getAttribute(\"aria-disabled\") === \"true\") return false;\r\n  // Cheap visibility test — covers display:none and visibility:hidden.\r\n  // Note: elements with `display: contents` may report 0 rects but have\r\n  // focusable descendants; the descendants themselves still match if\r\n  // they have their own boxes, so this filter is a reasonable trade-off.\r\n  if (typeof el.getClientRects === \"function\" && el.getClientRects().length === 0) {\r\n    return false;\r\n  }\r\n  // Walk ancestors for hidden / aria-hidden / inert.\r\n  let node: Element | null = el;\r\n  while (node && node !== document.body) {\r\n    if (node.hasAttribute && (\r\n      node.hasAttribute(\"inert\") ||\r\n      node.hasAttribute(\"hidden\") ||\r\n      node.getAttribute(\"aria-hidden\") === \"true\"\r\n    )) {\r\n      return false;\r\n    }\r\n    node = node.parentElement;\r\n  }\r\n  return true;\r\n}\r\n\r\nexport default function useFocusTrap<T extends HTMLElement = HTMLElement>(\r\n  ref: RefObject<T | null>,\r\n  isActive: boolean\r\n): void {\r\n  useEffect(() => {\r\n    if (!isActive || !ref.current) return undefined;\r\n\r\n    const container = ref.current;\r\n    trapStack.push(container);\r\n\r\n    const getFocusable = (): HTMLElement[] =>\r\n      Array.from(container.querySelectorAll(FOCUSABLE_SELECTORS)).filter(isVisuallyFocusable);\r\n\r\n    const trigger = document.activeElement;\r\n\r\n    // Initial focus, deferred to next frame so React has finished\r\n    // painting any conditional content. Cancellation handle stored\r\n    // so unmount-within-same-frame cannot leak a stale .focus() call.\r\n    const rafId = requestAnimationFrame(() => {\r\n      /* Only the innermost trap claims initial focus — same predicate as `trap()`\r\n       * below, so keyboard duty and initial focus can never disagree.\r\n       *\r\n       * Initial focus was previously unguarded: every trap focused on\r\n       * activation regardless of nesting, so on simultaneous mount the outer\r\n       * trap's rAF fired last and overwrote the inner trap's focus. */\r\n      if (!isInnermostTrap(container)) return;\r\n\r\n      const explicit = container.querySelector(AUTOFOCUS_SELECTORS);\r\n      const target = (explicit && isVisuallyFocusable(explicit))\r\n        ? explicit\r\n        : getFocusable()[0];\r\n      if (target && typeof target.focus === \"function\") target.focus();\r\n    });\r\n\r\n    const trap = (e: KeyboardEvent): void => {\r\n      if (e.key !== \"Tab\") return;\r\n      // Only the innermost trap acts. Outer traps stay registered and defer.\r\n      // Containment, NOT stack position — see isInnermostTrap.\r\n      if (!isInnermostTrap(container)) return;\r\n\r\n      const els = getFocusable();\r\n      if (!els.length) {\r\n        // Pathological case (no focusable inside): swallow Tab so\r\n        // focus cannot escape into the page behind the trap.\r\n        e.preventDefault();\r\n        return;\r\n      }\r\n      const first = els[0];\r\n      const last = els[els.length - 1];\r\n      if (!first || !last) return;\r\n      const active = document.activeElement;\r\n\r\n      // Recovery: if focus is currently OUTSIDE the container, warp it\r\n      // back to the first focusable. Without this, an escaped focus\r\n      // (mount race, programmatic blur, SR virtual cursor) leaks Tab\r\n      // navigation to the page behind the trap.\r\n      if (!container.contains(active)) {\r\n        e.preventDefault();\r\n        first.focus();\r\n        return;\r\n      }\r\n\r\n      if (e.shiftKey && active === first) {\r\n        e.preventDefault();\r\n        last.focus();\r\n      } else if (!e.shiftKey && active === last) {\r\n        e.preventDefault();\r\n        first.focus();\r\n      }\r\n    };\r\n\r\n    document.addEventListener(\"keydown\", trap, true);\r\n\r\n    return () => {\r\n      cancelAnimationFrame(rafId);\r\n\r\n      // Pop by reference (NOT by index) — tolerates out-of-order\r\n      // unmount sequences during portal teardown or hot-replace.\r\n      const idx = trapStack.lastIndexOf(container);\r\n      if (idx >= 0) trapStack.splice(idx, 1);\r\n\r\n      document.removeEventListener(\"keydown\", trap, true);\r\n\r\n      // Restore focus only if the trigger is still mounted, focusable,\r\n      // and not currently disabled. Calling .focus() on a detached or\r\n      // disabled node silently leaves focus on <body> with no visible\r\n      // indicator — actively user-hostile.\r\n      if (\r\n        trigger &&\r\n        trigger !== document.body &&\r\n        \"focus\" in trigger &&\r\n        typeof trigger.focus === \"function\" &&\r\n        document.body.contains(trigger) &&\r\n        !(\"disabled\" in trigger && trigger.disabled)\r\n      ) {\r\n        trigger.focus();\r\n      }\r\n    };\r\n  }, [isActive, ref]);\r\n}\r\n"],"mappings":"AAAA,SAASA,SAAS,QAAwB,OAAO;;AAEjD;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,MAAMC,mBAAmB,GAAG,CAC1B,SAAS,EACT,uBAAuB,EACvB,sBAAsB,EACtB,uBAAuB,EACvB,yBAAyB,EACzB,iCAAiC,EACjC,kDAAkD,EAClD,iBAAiB,EACjB,iBAAiB,CAClB,CAACC,IAAI,CAAC,IAAI,CAAC;AAEZ,MAAMC,mBAAmB,GAAG,+BAA+B;;AAE3D;AACA;AACA;AACA;AACA;AACA;AACA,MAAMC,SAAwB,GAAG,EAAE;;AAEnC;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,SAASC,eAAeA,CAACC,SAAsB,EAAW;EACxD,OAAO,CAACF,SAAS,CAACG,IAAI,CACnBC,KAAK,IAAKA,KAAK,KAAKF,SAAS,IAAIA,SAAS,CAACG,QAAQ,CAACD,KAAK,CAC5D,CAAC;AACH;;AAEA;AACA;AACA;AACA;AACA;AACA,SAASE,mBAAmBA,CAACC,EAAkB,EAAqB;EAClE,IAAI,CAACA,EAAE,EAAE,OAAO,KAAK;EACrB,IAAI,UAAU,IAAIA,EAAE,IAAIA,EAAE,CAACC,QAAQ,EAAE,OAAO,KAAK;EACjD,IAAID,EAAE,CAACE,YAAY,IAAIF,EAAE,CAACE,YAAY,CAAC,eAAe,CAAC,KAAK,MAAM,EAAE,OAAO,KAAK;EAChF;EACA;EACA;EACA;EACA,IAAI,OAAOF,EAAE,CAACG,cAAc,KAAK,UAAU,IAAIH,EAAE,CAACG,cAAc,CAAC,CAAC,CAACC,MAAM,KAAK,CAAC,EAAE;IAC/E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","ignoreList":[]}

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

@@ -1,10 +1,3 @@
-function _typeof(obj) { "@babel/helpers - typeof"; return _typeof = "function" == typeof Symbol && "symbol" == typeof Symbol.iterator ? function (obj) { return typeof obj; } : function (obj) { return obj && "function" == typeof Symbol && obj.constructor === Symbol && obj !== Symbol.prototype ? "symbol" : typeof obj; }, _typeof(obj); }
-function _slicedToArray(arr, i) { return _arrayWithHoles(arr) || _iterableToArrayLimit(arr, i) || _unsupportedIterableToArray(arr, i) || _nonIterableRest(); }
-function _nonIterableRest() { throw new TypeError("Invalid attempt to destructure non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method."); }
-function _unsupportedIterableToArray(o, minLen) { if (!o) return; if (typeof o === "string") return _arrayLikeToArray(o, minLen); var n = Object.prototype.toString.call(o).slice(8, -1); if (n === "Object" && o.constructor) n = o.constructor.name; if (n === "Map" || n === "Set") return Array.from(o); if (n === "Arguments" || /^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(n)) return _arrayLikeToArray(o, minLen); }
-function _arrayLikeToArray(arr, len) { if (len == null || len > arr.length) len = arr.length; for (var i = 0, arr2 = new Array(len); i < len; i++) { arr2[i] = arr[i]; } return arr2; }
-function _iterableToArrayLimit(arr, i) { var _i = null == arr ? null : "undefined" != typeof Symbol && arr[Symbol.iterator] || arr["@@iterator"]; if (null != _i) { var _s, _e, _x, _r, _arr = [], _n = !0, _d = !1; try { if (_x = (_i = _i.call(arr)).next, 0 === i) { if (Object(_i) !== _i) return; _n = !1; } else for (; !(_n = (_s = _x.call(_i)).done) && (_arr.push(_s.value), _arr.length !== i); _n = !0) { ; } } catch (err) { _d = !0, _e = err; } finally { try { if (!_n && null != _i["return"] && (_r = _i["return"](), Object(_r) !== _r)) return; } finally { if (_d) throw _e; } } return _arr; } }
-function _arrayWithHoles(arr) { if (Array.isArray(arr)) return arr; }
 import { useCallback, useEffect, useRef, useState } from "react";
 
 /**
@@ -32,49 +25,41 @@ import { useCallback, useEffect, useRef, useState } from "react";
  *     with empty initial values before the user decides to restore/ignore.
  */
 
-export default function useFormAutoSave(_ref) {
-  var storageKey = _ref.storageKey,
-    values = _ref.values,
-    setValues = _ref.setValues,
-    _ref$enabled = _ref.enabled,
-    enabled = _ref$enabled === void 0 ? true : _ref$enabled,
-    _ref$debounceMs = _ref.debounceMs,
-    debounceMs = _ref$debounceMs === void 0 ? 800 : _ref$debounceMs,
-    _ref$initialEmptyChec = _ref.initialEmptyCheck,
-    initialEmptyCheck = _ref$initialEmptyChec === void 0 ? defaultEmptyCheck : _ref$initialEmptyChec;
-  var _useState = useState(false),
-    _useState2 = _slicedToArray(_useState, 2),
-    hasDraft = _useState2[0],
-    setHasDraft = _useState2[1];
-  var _useState3 = useState(null),
-    _useState4 = _slicedToArray(_useState3, 2),
-    lastSavedAt = _useState4[0],
-    setLastSavedAt = _useState4[1];
-  var debounceTimerRef = useRef(null);
-  var mountedRef = useRef(false);
+export default function useFormAutoSave({
+  storageKey,
+  values,
+  setValues,
+  enabled = true,
+  debounceMs = 800,
+  initialEmptyCheck = defaultEmptyCheck
+}) {
+  const [hasDraft, setHasDraft] = useState(false);
+  const [lastSavedAt, setLastSavedAt] = useState(null);
+  const debounceTimerRef = useRef(null);
+  const mountedRef = useRef(false);
 
   /* ── Mount-time draft detection ────────────────── */
-  useEffect(function () {
+  useEffect(() => {
     if (!enabled) return;
     if (mountedRef.current) return;
     mountedRef.current = true;
     try {
-      var raw = localStorage.getItem(storageKey);
+      const raw = localStorage.getItem(storageKey);
       if (!raw) return;
-      var parsed = JSON.parse(raw);
-      if (parsed && _typeof(parsed) === "object" && "values" in parsed && parsed.values && _typeof(parsed.values) === "object") {
+      const parsed = JSON.parse(raw);
+      if (parsed && typeof parsed === "object" && "values" in parsed && parsed.values && typeof parsed.values === "object") {
         setHasDraft(true);
         if ("savedAt" in parsed && typeof parsed.savedAt === "string") {
-          var d = new Date(parsed.savedAt);
+          const d = new Date(parsed.savedAt);
           if (!Number.isNaN(d.getTime())) setLastSavedAt(d);
         }
       } else {
         localStorage.removeItem(storageKey);
       }
-    } catch (_unused) {
+    } catch {
       try {
         localStorage.removeItem(storageKey);
-      } catch (_unused2) {
+      } catch {
         /* ignore */
       }
     }
@@ -95,26 +80,26 @@ export default function useFormAutoSave(_ref) {
    *   - clearDraft()   is called (user chose to ignore)
    *   - No draft existed on mount (hasDraft was never set to true)
    */
-  useEffect(function () {
+  useEffect(() => {
     if (!enabled) return undefined;
     if (hasDraft) return undefined; // ← PAUSE: preserve existing draft
     if (initialEmptyCheck(values)) return undefined;
     if (debounceTimerRef.current) {
       clearTimeout(debounceTimerRef.current);
     }
-    debounceTimerRef.current = setTimeout(function () {
+    debounceTimerRef.current = setTimeout(() => {
       try {
-        var now = new Date();
+        const now = new Date();
         localStorage.setItem(storageKey, JSON.stringify({
-          values: values,
+          values,
           savedAt: now.toISOString()
         }));
         setLastSavedAt(now);
-      } catch (_unused3) {
+      } catch {
         // Quota full / private mode — no-op.
       }
     }, debounceMs);
-    return function () {
+    return () => {
       if (debounceTimerRef.current) {
         clearTimeout(debounceTimerRef.current);
       }
@@ -122,7 +107,7 @@ export default function useFormAutoSave(_ref) {
   }, [values, enabled, hasDraft, storageKey, debounceMs, initialEmptyCheck]);
 
   /* ── Restore draft ─────────────────────── */
-  var restoreDraft = useCallback(function () {
+  const restoreDraft = useCallback(() => {
     if (!setValues) {
       if (process.env["NODE_ENV"] !== "production") {
         // eslint-disable-next-line no-console
@@ -131,10 +116,10 @@ export default function useFormAutoSave(_ref) {
       return false;
     }
     try {
-      var raw = localStorage.getItem(storageKey);
+      const raw = localStorage.getItem(storageKey);
       if (!raw) return false;
-      var parsed = JSON.parse(raw);
-      if (!parsed || _typeof(parsed) !== "object" || !("values" in parsed) || !parsed.values) {
+      const parsed = JSON.parse(raw);
+      if (!parsed || typeof parsed !== "object" || !("values" in parsed) || !parsed.values) {
         return false;
       }
       // Persisted draft payload is the form's Values, round-tripped
@@ -142,26 +127,26 @@ export default function useFormAutoSave(_ref) {
       setValues(parsed.values);
       setHasDraft(false); // ← resumes auto-save with restored values
       return true;
-    } catch (_unused4) {
+    } catch {
       return false;
     }
   }, [storageKey, setValues]);
 
   /* ── Clear draft ─────────────────────── */
-  var clearDraft = useCallback(function () {
+  const clearDraft = useCallback(() => {
     try {
       localStorage.removeItem(storageKey);
-    } catch (_unused5) {
+    } catch {
       /* ignore */
     }
     setHasDraft(false); // ← resumes auto-save for new input
     setLastSavedAt(null);
   }, [storageKey]);
   return {
-    hasDraft: hasDraft,
-    lastSavedAt: lastSavedAt,
-    restoreDraft: restoreDraft,
-    clearDraft: clearDraft
+    hasDraft,
+    lastSavedAt,
+    restoreDraft,
+    clearDraft
   };
 }
 
@@ -171,11 +156,11 @@ function isEmptyValue(v) {
   if (v === null || v === undefined) return true;
   if (typeof v === "string") return v.trim().length === 0;
   if (Array.isArray(v)) return v.length === 0;
-  if (_typeof(v) === "object") return Object.keys(v).length === 0;
+  if (typeof v === "object") return Object.keys(v).length === 0;
   return false;
 }
 function defaultEmptyCheck(values) {
-  if (!values || _typeof(values) !== "object") return true;
+  if (!values || typeof values !== "object") return true;
   return Object.values(values).every(isEmptyValue);
 }
 //# sourceMappingURL=useFormAutoSave.js.map

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

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