@12-apps/ui 6.39.10 → 6.39.12

package/dist/{chunk-SXYIXCUB.js → chunk-VNWZWQF3.js}

@@ -1,5 +1,9 @@
 // src/components/data-display/HoverCard/HoverCard.hooks.ts
 import React from "react";
+var clearPending = (ref) => {
+  if (ref.current !== void 0) window.clearTimeout(ref.current);
+  ref.current = void 0;
+};
 var useHoverHandlers = ({
   isTouchDevice,
   touchEnabled,
@@ -25,7 +29,7 @@ var useHoverHandlers = ({
   const triggerHandlers = {
     onMouseEnter: (event) => {
       if (hoverIgnored) return;
-      openCard(event);
+      openCard(event.currentTarget);
     },
     onMouseLeave: () => {
       if (hoverIgnored) return;
@@ -34,16 +38,15 @@ var useHoverHandlers = ({
     onTouchStart: (event) => {
       if (!touchEnabled) return;
       if (touchTimeout) window.clearTimeout(touchTimeout);
-      setTouchTimeout(window.setTimeout(() => openCard(event), enterDelay));
+      const trigger = event.currentTarget;
+      setTouchTimeout(window.setTimeout(() => openCard(trigger), enterDelay));
     },
     // End and cancel do the same thing: the press did not become a long press.
     onTouchEnd: cancelTouch,
     onTouchCancel: cancelTouch
   };
   const cardHandlers = {
-    onMouseEnter: () => {
-      if (exitTimeoutRef.current) window.clearTimeout(exitTimeoutRef.current);
-    },
+    onMouseEnter: () => clearPending(exitTimeoutRef),
     onMouseLeave: closeCard
   };
   return { triggerHandlers, cardHandlers };
@@ -58,6 +61,25 @@ var useEscapeKey = (active, onEscape) => {
     return () => document.removeEventListener("keydown", handleEscape);
   }, [active, onEscape]);
 };
+var useClickAway = (active, inside, onAway) => {
+  React.useEffect(() => {
+    if (!active) return;
+    const handlePointerDown = (event) => {
+      const target = event.target;
+      if (target && inside().some((el) => el?.contains(target))) return;
+      onAway();
+    };
+    document.addEventListener("pointerdown", handlePointerDown, true);
+    return () => document.removeEventListener("pointerdown", handlePointerDown, true);
+  }, [active, inside, onAway]);
+};
+var useClearOnUnmount = (...refs) => {
+  React.useEffect(
+    () => () => refs.forEach(clearPending),
+    // The refs are stable objects: a mount/unmount pair, as before.
+    []
+  );
+};
 var useHoverCard = ({
   disabled,
   touchEnabled,
@@ -71,18 +93,17 @@ var useHoverCard = ({
   const [isTouchDevice, setIsTouchDevice] = React.useState(false);
   const enterTimeoutRef = React.useRef(void 0);
   const exitTimeoutRef = React.useRef(void 0);
+  const contentRef = React.useRef(null);
   React.useEffect(() => {
     setIsTouchDevice("ontouchstart" in window);
   }, []);
   const openCard = React.useCallback(
-    (event) => {
+    (trigger) => {
       if (disabled) return;
-      if (exitTimeoutRef.current) {
-        window.clearTimeout(exitTimeoutRef.current);
-      }
-      const target = event.currentTarget;
+      clearPending(exitTimeoutRef);
+      clearPending(enterTimeoutRef);
       enterTimeoutRef.current = window.setTimeout(() => {
-        setAnchorEl(target);
+        setAnchorEl(trigger);
         setIsOpen(true);
         onOpen?.();
       }, enterDelay);
@@ -90,9 +111,8 @@ var useHoverCard = ({
     [disabled, enterDelay, onOpen]
   );
   const closeCard = React.useCallback(() => {
-    if (enterTimeoutRef.current) {
-      window.clearTimeout(enterTimeoutRef.current);
-    }
+    clearPending(enterTimeoutRef);
+    clearPending(exitTimeoutRef);
     exitTimeoutRef.current = window.setTimeout(() => {
       setIsOpen(false);
       setAnchorEl(null);
@@ -100,6 +120,8 @@ var useHoverCard = ({
     }, exitDelay);
   }, [exitDelay, onClose]);
   const handleClose = React.useCallback(() => {
+    clearPending(enterTimeoutRef);
+    clearPending(exitTimeoutRef);
     setIsOpen(false);
     setAnchorEl(null);
     onClose?.();
@@ -112,18 +134,14 @@ var useHoverCard = ({
     closeCard,
     exitTimeoutRef
   });
+  const insideCard = React.useCallback(() => [anchorEl, contentRef.current], [anchorEl]);
   useEscapeKey(isOpen, handleClose);
-  React.useEffect(
-    () => () => {
-      if (enterTimeoutRef.current) window.clearTimeout(enterTimeoutRef.current);
-      if (exitTimeoutRef.current) window.clearTimeout(exitTimeoutRef.current);
-    },
-    []
-  );
-  return { anchorEl, isOpen, handleClose, triggerHandlers, cardHandlers };
+  useClickAway(isOpen, insideCard, handleClose);
+  useClearOnUnmount(enterTimeoutRef, exitTimeoutRef);
+  return { anchorEl, isOpen, handleClose, triggerHandlers, cardHandlers, contentRef };
 };
 
 export {
   useHoverCard
 };
-//# sourceMappingURL=chunk-SXYIXCUB.js.map
+//# sourceMappingURL=chunk-VNWZWQF3.js.map

package/dist/chunk-VNWZWQF3.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/components/data-display/HoverCard/HoverCard.hooks.ts"],"sourcesContent":["import React from 'react';\n\ntype TimerRef = React.MutableRefObject<number | undefined>;\n\n/**\n * Cancel the timer a ref holds, and forget it. Every place that schedules\n * or dismisses goes through this, so no timer outlives the ref that could\n * cancel it (FUT-2619: an overwritten enter timer reopened a dismissed card).\n */\nconst clearPending = (ref: TimerRef) => {\n  if (ref.current !== undefined) window.clearTimeout(ref.current);\n  ref.current = undefined;\n};\n\ninterface HandlerInput {\n  isTouchDevice: boolean;\n  touchEnabled: boolean;\n  enterDelay: number;\n  openCard: (trigger: HTMLElement) => void;\n  closeCard: () => void;\n  exitTimeoutRef: TimerRef;\n}\n\n/**\n * The pointer and touch handlers, over the open/close pair. Touch gets a\n * long-press because there is no hover to respond to; the card's own handlers\n * keep it open while the pointer is travelling onto it.\n */\nconst useHoverHandlers = ({\n  isTouchDevice,\n  touchEnabled,\n  enterDelay,\n  openCard,\n  closeCard,\n  exitTimeoutRef,\n}: HandlerInput) => {\n  const [touchTimeout, setTouchTimeout] = React.useState<number>();\n\n  /** A touch device with touch disabled has no hover to respond to. */\n  const hoverIgnored = isTouchDevice && !touchEnabled;\n\n  const cancelTouch = React.useCallback(() => {\n    if (touchTimeout) {\n      window.clearTimeout(touchTimeout);\n      setTouchTimeout(undefined);\n    }\n  }, [touchTimeout]);\n\n  React.useEffect(\n    () => () => {\n      if (touchTimeout) window.clearTimeout(touchTimeout);\n    },\n    [touchTimeout],\n  );\n\n  const triggerHandlers = {\n    onMouseEnter: (event: React.MouseEvent<HTMLElement>) => {\n      if (hoverIgnored) return;\n      openCard(event.currentTarget);\n    },\n    onMouseLeave: () => {\n      if (hoverIgnored) return;\n      closeCard();\n    },\n    onTouchStart: (event: React.TouchEvent<HTMLElement>) => {\n      if (!touchEnabled) return;\n      if (touchTimeout) window.clearTimeout(touchTimeout);\n      // Read NOW: React nulls `currentTarget` once the handler returns, so\n      // the long-press timer used to open the card with no anchor at all.\n      const trigger = event.currentTarget;\n      setTouchTimeout(window.setTimeout(() => openCard(trigger), enterDelay));\n    },\n    // End and cancel do the same thing: the press did not become a long press.\n    onTouchEnd: cancelTouch,\n    onTouchCancel: cancelTouch,\n  };\n\n  /** Moving onto the card keeps it open; leaving it starts the exit delay. */\n  const cardHandlers = {\n    onMouseEnter: () => clearPending(exitTimeoutRef),\n    onMouseLeave: closeCard,\n  };\n\n  return { triggerHandlers, cardHandlers };\n};\n\n/** Escape dismisses the card while it is open. */\nconst useEscapeKey = (active: boolean, onEscape: () => void) => {\n  React.useEffect(() => {\n    if (!active) return;\n\n    const handleEscape = (event: globalThis.KeyboardEvent) => {\n      if (event.key === 'Escape') onEscape();\n    };\n\n    document.addEventListener('keydown', handleEscape);\n    return () => document.removeEventListener('keydown', handleEscape);\n  }, [active, onEscape]);\n};\n\n/**\n * A press anywhere outside the trigger and the card dismisses it.\n *\n * Touch has no mouse-leave, and MUI's own click-away was the popover's\n * backdrop, which `pointer-events: none` on the popover root (so the page\n * under an open card stays usable) takes out of play. So this listens on the\n * document itself, in the CAPTURE phase, where a `stopPropagation` further in\n * cannot swallow it. It only observes: no `preventDefault`, so the tap or\n * click still reaches whatever it landed on. Attached while open, removed on\n * close and on unmount.\n */\nconst useClickAway = (\n  active: boolean,\n  inside: () => ReadonlyArray<Element | null>,\n  onAway: () => void,\n) => {\n  React.useEffect(() => {\n    if (!active) return;\n\n    const handlePointerDown = (event: globalThis.PointerEvent) => {\n      const target = event.target as Node | null;\n      if (target && inside().some((el) => el?.contains(target))) return;\n      onAway();\n    };\n\n    document.addEventListener('pointerdown', handlePointerDown, true);\n    return () => document.removeEventListener('pointerdown', handlePointerDown, true);\n  }, [active, inside, onAway]);\n};\n\n/** Whatever is still pending when the card unmounts is cancelled with it. */\nconst useClearOnUnmount = (...refs: TimerRef[]) => {\n  React.useEffect(\n    () => () => refs.forEach(clearPending),\n    // The refs are stable objects: a mount/unmount pair, as before.\n    [],\n  );\n};\n\ninterface HoverCardTimingInput {\n  disabled: boolean;\n  touchEnabled: boolean;\n  enterDelay: number;\n  exitDelay: number;\n  onOpen?: () => void;\n  onClose?: () => void;\n}\n\n/**\n * When the card is open, and the delays that decide it.\n *\n * Three timers are in play: the enter delay before opening, the exit delay\n * before closing (so the pointer can travel from the trigger onto the card\n * without dismissing it), and the long-press timer on touch. Each cancels the\n * others' pending work, which is why they live together.\n */\nexport const useHoverCard = ({\n  disabled,\n  touchEnabled,\n  enterDelay,\n  exitDelay,\n  onOpen,\n  onClose,\n}: HoverCardTimingInput) => {\n  const [anchorEl, setAnchorEl] = React.useState<HTMLElement | null>(null);\n  const [isOpen, setIsOpen] = React.useState(false);\n  const [isTouchDevice, setIsTouchDevice] = React.useState(false);\n  const enterTimeoutRef = React.useRef<number | undefined>(undefined);\n  const exitTimeoutRef = React.useRef<number | undefined>(undefined);\n  /** The card's own box, inside the popover paper: a press here is not \"away\". */\n  const contentRef = React.useRef<HTMLDivElement | null>(null);\n\n  // Probed in an effect, not during render, so SSR and hydration stay intact.\n  React.useEffect(() => {\n    setIsTouchDevice('ontouchstart' in window);\n  }, []);\n\n  const openCard = React.useCallback(\n    (trigger: HTMLElement) => {\n      if (disabled) return;\n\n      clearPending(exitTimeoutRef);\n      // A second enter before the delay ran out (a click and then a hover, or\n      // the pointer jittering across the edge) must REPLACE the pending open,\n      // not add one: an overwritten timer can no longer be cancelled, and it\n      // reopened the card after Escape had closed it.\n      clearPending(enterTimeoutRef);\n\n      enterTimeoutRef.current = window.setTimeout(() => {\n        setAnchorEl(trigger);\n        setIsOpen(true);\n        onOpen?.();\n      }, enterDelay);\n    },\n    [disabled, enterDelay, onOpen],\n  );\n\n  const closeCard = React.useCallback(() => {\n    clearPending(enterTimeoutRef);\n    clearPending(exitTimeoutRef);\n\n    exitTimeoutRef.current = window.setTimeout(() => {\n      setIsOpen(false);\n      setAnchorEl(null);\n      onClose?.();\n    }, exitDelay);\n  }, [exitDelay, onClose]);\n\n  // Escape and the popover's own close are FINAL: nothing still pending may\n  // reopen the card behind them. It opens again on the next enter.\n  const handleClose = React.useCallback(() => {\n    clearPending(enterTimeoutRef);\n    clearPending(exitTimeoutRef);\n    setIsOpen(false);\n    setAnchorEl(null);\n    onClose?.();\n  }, [onClose]);\n\n  const { triggerHandlers, cardHandlers } = useHoverHandlers({\n    isTouchDevice,\n    touchEnabled,\n    enterDelay,\n    openCard,\n    closeCard,\n    exitTimeoutRef,\n  });\n\n  const insideCard = React.useCallback(() => [anchorEl, contentRef.current], [anchorEl]);\n\n  useEscapeKey(isOpen, handleClose);\n  useClickAway(isOpen, insideCard, handleClose);\n  useClearOnUnmount(enterTimeoutRef, exitTimeoutRef);\n\n  return { anchorEl, isOpen, handleClose, triggerHandlers, cardHandlers, contentRef };\n};\n"],"mappings":"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","names":[]}

package/dist/{chunk-SSS64KYB.js → chunk-Z43N7ASP.js}

@@ -3,7 +3,7 @@ import {
 } from "./chunk-4XK6JQ4D.js";
 import {
   Input
-} from "./chunk-VURQZBFH.js";
+} from "./chunk-JRJCBDGN.js";
 import {
   FormControl,
   FormLabel,
@@ -38,4 +38,4 @@ function TextField({ name, label, type = "text", placeholder }) {
 export {
   TextField
 };
-//# sourceMappingURL=chunk-SSS64KYB.js.map
+//# sourceMappingURL=chunk-Z43N7ASP.js.map

package/dist/{chunk-6MFMLQ72.js → chunk-ZNDDILNQ.js}

@@ -10,7 +10,7 @@ import {
 import {
   ViewDialogs,
   ViewMutationErrorAlert
-} from "./chunk-A5B7B4HT.js";
+} from "./chunk-INMKA5SF.js";
 import {
   useSavedViewsController
 } from "./chunk-HR7YTBR7.js";
@@ -178,4 +178,4 @@ function renderViewDialogs(ctl, fields, columns, views, testIdPrefix, onSaved) {
 export {
   DataViewsTableBase
 };
-//# sourceMappingURL=chunk-6MFMLQ72.js.map
+//# sourceMappingURL=chunk-ZNDDILNQ.js.map

package/dist/data-display/DataViews.js

@@ -3,7 +3,7 @@ import {
 } from "../chunk-I5T5PQQW.js";
 import {
   DataViewsTableBase
-} from "../chunk-6MFMLQ72.js";
+} from "../chunk-ZNDDILNQ.js";
 import "../chunk-3333KCAW.js";
 import {
   DataViewsGrid
@@ -68,8 +68,8 @@ import {
   cardScaleForZoom
 } from "../chunk-XZJM6EPC.js";
 import "../chunk-M4KVKQRN.js";
-import "../chunk-A5B7B4HT.js";
-import "../chunk-VJG7NMGL.js";
+import "../chunk-INMKA5SF.js";
+import "../chunk-IYF246UA.js";
 import "../chunk-ECIHOZPK.js";
 import "../chunk-5M4TYFR3.js";
 import "../chunk-HR7YTBR7.js";
@@ -151,7 +151,7 @@ import "../chunk-LXT3X33C.js";
 import "../chunk-DMNZD3Q7.js";
 import "../chunk-JC22FNFA.js";
 import "../chunk-QYKDY4EI.js";
-import "../chunk-VURQZBFH.js";
+import "../chunk-JRJCBDGN.js";
 import "../chunk-SL6454K7.js";
 import "../chunk-THMT3G3L.js";
 import "../chunk-RNIU447I.js";

package/dist/data-display/HoverCard.js

@@ -1,9 +1,9 @@
 import "../chunk-6OS4AKWT.js";
 import {
   HoverCard
-} from "../chunk-DAHYLPK7.js";
+} from "../chunk-CMV6BRQ3.js";
 import "../chunk-BSYPPO2I.js";
-import "../chunk-SXYIXCUB.js";
+import "../chunk-VNWZWQF3.js";
 import "../chunk-NRIV2CQ2.js";
 import "../chunk-ZHV7TCAC.js";
 import "../chunk-HPK33ACY.js";

package/dist/form/CepField.js

@@ -1,9 +1,9 @@
 import "../chunk-6XLMTOJ3.js";
 import {
   CepField
-} from "../chunk-F6D6HXZU.js";
+} from "../chunk-7X7ZHJHM.js";
 import "../chunk-QYKDY4EI.js";
-import "../chunk-VURQZBFH.js";
+import "../chunk-JRJCBDGN.js";
 import "../chunk-SL6454K7.js";
 import "../chunk-THMT3G3L.js";
 import "../chunk-RNIU447I.js";

package/dist/form/Input.js

@@ -1,7 +1,7 @@
 import "../chunk-QYKDY4EI.js";
 import {
   Input
-} from "../chunk-VURQZBFH.js";
+} from "../chunk-JRJCBDGN.js";
 import "../chunk-SL6454K7.js";
 import "../chunk-THMT3G3L.js";
 import "../chunk-RNIU447I.js";

package/dist/form/RichTextEditor.js

@@ -1,8 +1,8 @@
 import "../chunk-WMY276HD.js";
 import {
   RichTextEditor
-} from "../chunk-7EM4THID.js";
-import "../chunk-774B27QA.js";
+} from "../chunk-RTEY5COP.js";
+import "../chunk-EUACQR6N.js";
 import "../chunk-UZOG6HNN.js";
 import "../chunk-33LAPBYB.js";
 import "../chunk-WVZBYTIK.js";

package/dist/form/total-form.js

@@ -9,15 +9,15 @@ import {
 } from "../chunk-CPAJYJUD.js";
 import {
   Fields_exports
-} from "../chunk-YS67XMOP.js";
+} from "../chunk-I5ZVCY2N.js";
 import "../chunk-FNG33MKA.js";
 import {
   TextField
-} from "../chunk-SSS64KYB.js";
+} from "../chunk-Z43N7ASP.js";
 import {
   SelectField
 } from "../chunk-PWZHCBG3.js";
-import "../chunk-2XX45PC5.js";
+import "../chunk-TGXCG62P.js";
 import {
   CategoryField
 } from "../chunk-T6EKPFKZ.js";
@@ -33,7 +33,7 @@ import "../chunk-W5TI46QN.js";
 import "../chunk-JD5BVIM7.js";
 import "../chunk-VQYR64QB.js";
 import "../chunk-6XLMTOJ3.js";
-import "../chunk-F6D6HXZU.js";
+import "../chunk-7X7ZHJHM.js";
 import "../chunk-N5ZWC6CB.js";
 import "../chunk-BKASAYQL.js";
 import "../chunk-2JNHWKQK.js";
@@ -52,7 +52,7 @@ import "../chunk-LXT3X33C.js";
 import "../chunk-DMNZD3Q7.js";
 import "../chunk-JC22FNFA.js";
 import "../chunk-QYKDY4EI.js";
-import "../chunk-VURQZBFH.js";
+import "../chunk-JRJCBDGN.js";
 import "../chunk-SL6454K7.js";
 import "../chunk-THMT3G3L.js";
 import "../chunk-RNIU447I.js";

package/dist/types/components/data-display/HoverCard/HoverCard.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"HoverCard.d.ts","sourceRoot":"","sources":["../../../../../src/components/data-display/HoverCard/HoverCard.tsx"],"names":[],"mappings":"AAKA,OAAO,KAAK,MAAM,OAAO,CAAC;AAS1B,OAAO,KAAK,EAA0C,cAAc,EAAE,MAAM,mBAAmB,CAAC;AA6DhG,eAAO,MAAM,SAAS,oGA8EpB,CAAC"}
+{"version":3,"file":"HoverCard.d.ts","sourceRoot":"","sources":["../../../../../src/components/data-display/HoverCard/HoverCard.tsx"],"names":[],"mappings":"AAKA,OAAO,KAAK,MAAM,OAAO,CAAC;AAS1B,OAAO,KAAK,EAA0C,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAsEhG,eAAO,MAAM,SAAS,oGA8EpB,CAAC"}

package/dist/types/components/data-display/HoverCard/HoverCard.hooks.d.ts

@@ -30,6 +30,7 @@ export declare const useHoverCard: ({ disabled, touchEnabled, enterDelay, exitDe
         onMouseEnter: () => void;
         onMouseLeave: () => void;
     };
+    contentRef: React.RefObject<HTMLDivElement | null>;
 };
 export {};
 //# sourceMappingURL=HoverCard.hooks.d.ts.map

package/dist/types/components/data-display/HoverCard/HoverCard.hooks.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"HoverCard.hooks.d.ts","sourceRoot":"","sources":["../../../../../src/components/data-display/HoverCard/HoverCard.hooks.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAuF1B,UAAU,oBAAoB;IAC5B,QAAQ,EAAE,OAAO,CAAC;IAClB,YAAY,EAAE,OAAO,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,IAAI,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,IAAI,CAAC;CACtB;AAED;;;;;;;GAOG;AACH,eAAO,MAAM,YAAY,GAAI,qEAO1B,oBAAoB;;;;;8BAnEG,KAAK,CAAC,UAAU,CAAC,WAAW,CAAC;;8BAQ7B,KAAK,CAAC,UAAU,CAAC,WAAW,CAAC;;;;;;4BA7CpC,IAAI;;CA4KtB,CAAC"}
+{"version":3,"file":"HoverCard.hooks.d.ts","sourceRoot":"","sources":["../../../../../src/components/data-display/HoverCard/HoverCard.hooks.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AA2I1B,UAAU,oBAAoB;IAC5B,QAAQ,EAAE,OAAO,CAAC;IAClB,YAAY,EAAE,OAAO,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,IAAI,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,IAAI,CAAC;CACtB;AAED;;;;;;;GAOG;AACH,eAAO,MAAM,YAAY,GAAI,qEAO1B,oBAAoB;;;;;8BA3GG,KAAK,CAAC,UAAU,CAAC,WAAW,CAAC;;8BAQ7B,KAAK,CAAC,UAAU,CAAC,WAAW,CAAC;;;;;;4BA7CpC,IAAI;;;CAuNtB,CAAC"}

package/dist/types/components/form/Input/Input.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Input.d.ts","sourceRoot":"","sources":["../../../../../src/components/form/Input/Input.tsx"],"names":[],"mappings":"AAGA,OAAO,KAAK,MAAM,OAAO,CAAC;AAgB1B,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAwEhD,eAAO,MAAM,KAAK,qFAgEjB,CAAC"}
+{"version":3,"file":"Input.d.ts","sourceRoot":"","sources":["../../../../../src/components/form/Input/Input.tsx"],"names":[],"mappings":"AAGA,OAAO,KAAK,MAAM,OAAO,CAAC;AAgB1B,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAyGhD,eAAO,MAAM,KAAK,qFAsEjB,CAAC"}

package/dist/types/components/form/RichTextEditor/RichTextEditor.hooks.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"RichTextEditor.hooks.d.ts","sourceRoot":"","sources":["../../../../../src/components/form/RichTextEditor/RichTextEditor.hooks.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAwE/B,eAAO,MAAM,iBAAiB,GAAI,sEAQ/B;IACD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IACnC,OAAO,CAAC,EAAE,MAAM,IAAI,CAAC;IACrB,MAAM,CAAC,EAAE,MAAM,IAAI,CAAC;IACpB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;;;;;;;8BAWgB,MAAM,gBAAgB,MAAM;CAyC5C,CAAC"}
+{"version":3,"file":"RichTextEditor.hooks.d.ts","sourceRoot":"","sources":["../../../../../src/components/form/RichTextEditor/RichTextEditor.hooks.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAyF/B,eAAO,MAAM,iBAAiB,GAAI,sEAQ/B;IACD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IACnC,OAAO,CAAC,EAAE,MAAM,IAAI,CAAC;IACrB,MAAM,CAAC,EAAE,MAAM,IAAI,CAAC;IACpB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;;;;;;;8BAWgB,MAAM,gBAAgB,MAAM;CAyC5C,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@12-apps/ui",
-  "version": "6.39.10",
+  "version": "6.39.12",
   "license": "MIT",
   "packageManager": "pnpm@10.34.5",
   "type": "module",

package/src/components/data-display/HoverCard/HoverCard.hooks.ts

@@ -1,12 +1,24 @@
 import React from 'react';
 
+type TimerRef = React.MutableRefObject<number | undefined>;
+
+/**
+ * Cancel the timer a ref holds, and forget it. Every place that schedules
+ * or dismisses goes through this, so no timer outlives the ref that could
+ * cancel it (FUT-2619: an overwritten enter timer reopened a dismissed card).
+ */
+const clearPending = (ref: TimerRef) => {
+  if (ref.current !== undefined) window.clearTimeout(ref.current);
+  ref.current = undefined;
+};
+
 interface HandlerInput {
   isTouchDevice: boolean;
   touchEnabled: boolean;
   enterDelay: number;
-  openCard: (event: React.MouseEvent<HTMLElement> | React.TouchEvent<HTMLElement>) => void;
+  openCard: (trigger: HTMLElement) => void;
   closeCard: () => void;
-  exitTimeoutRef: React.MutableRefObject<number | undefined>;
+  exitTimeoutRef: TimerRef;
 }
 
 /**
@@ -44,7 +56,7 @@ const useHoverHandlers = ({
   const triggerHandlers = {
     onMouseEnter: (event: React.MouseEvent<HTMLElement>) => {
       if (hoverIgnored) return;
-      openCard(event);
+      openCard(event.currentTarget);
     },
     onMouseLeave: () => {
       if (hoverIgnored) return;
@@ -53,7 +65,10 @@ const useHoverHandlers = ({
     onTouchStart: (event: React.TouchEvent<HTMLElement>) => {
       if (!touchEnabled) return;
       if (touchTimeout) window.clearTimeout(touchTimeout);
-      setTouchTimeout(window.setTimeout(() => openCard(event), enterDelay));
+      // Read NOW: React nulls `currentTarget` once the handler returns, so
+      // the long-press timer used to open the card with no anchor at all.
+      const trigger = event.currentTarget;
+      setTouchTimeout(window.setTimeout(() => openCard(trigger), enterDelay));
     },
     // End and cancel do the same thing: the press did not become a long press.
     onTouchEnd: cancelTouch,
@@ -62,9 +77,7 @@ const useHoverHandlers = ({
 
   /** Moving onto the card keeps it open; leaving it starts the exit delay. */
   const cardHandlers = {
-    onMouseEnter: () => {
-      if (exitTimeoutRef.current) window.clearTimeout(exitTimeoutRef.current);
-    },
+    onMouseEnter: () => clearPending(exitTimeoutRef),
     onMouseLeave: closeCard,
   };
 
@@ -85,6 +98,45 @@ const useEscapeKey = (active: boolean, onEscape: () => void) => {
   }, [active, onEscape]);
 };
 
+/**
+ * A press anywhere outside the trigger and the card dismisses it.
+ *
+ * Touch has no mouse-leave, and MUI's own click-away was the popover's
+ * backdrop, which `pointer-events: none` on the popover root (so the page
+ * under an open card stays usable) takes out of play. So this listens on the
+ * document itself, in the CAPTURE phase, where a `stopPropagation` further in
+ * cannot swallow it. It only observes: no `preventDefault`, so the tap or
+ * click still reaches whatever it landed on. Attached while open, removed on
+ * close and on unmount.
+ */
+const useClickAway = (
+  active: boolean,
+  inside: () => ReadonlyArray<Element | null>,
+  onAway: () => void,
+) => {
+  React.useEffect(() => {
+    if (!active) return;
+
+    const handlePointerDown = (event: globalThis.PointerEvent) => {
+      const target = event.target as Node | null;
+      if (target && inside().some((el) => el?.contains(target))) return;
+      onAway();
+    };
+
+    document.addEventListener('pointerdown', handlePointerDown, true);
+    return () => document.removeEventListener('pointerdown', handlePointerDown, true);
+  }, [active, inside, onAway]);
+};
+
+/** Whatever is still pending when the card unmounts is cancelled with it. */
+const useClearOnUnmount = (...refs: TimerRef[]) => {
+  React.useEffect(
+    () => () => refs.forEach(clearPending),
+    // The refs are stable objects: a mount/unmount pair, as before.
+    [],
+  );
+};
+
 interface HoverCardTimingInput {
   disabled: boolean;
   touchEnabled: boolean;
@@ -115,6 +167,8 @@ export const useHoverCard = ({
   const [isTouchDevice, setIsTouchDevice] = React.useState(false);
   const enterTimeoutRef = React.useRef<number | undefined>(undefined);
   const exitTimeoutRef = React.useRef<number | undefined>(undefined);
+  /** The card's own box, inside the popover paper: a press here is not "away". */
+  const contentRef = React.useRef<HTMLDivElement | null>(null);
 
   // Probed in an effect, not during render, so SSR and hydration stay intact.
   React.useEffect(() => {
@@ -122,16 +176,18 @@ export const useHoverCard = ({
   }, []);
 
   const openCard = React.useCallback(
-    (event: React.MouseEvent<HTMLElement> | React.TouchEvent<HTMLElement>) => {
+    (trigger: HTMLElement) => {
       if (disabled) return;
 
-      if (exitTimeoutRef.current) {
-        window.clearTimeout(exitTimeoutRef.current);
-      }
+      clearPending(exitTimeoutRef);
+      // A second enter before the delay ran out (a click and then a hover, or
+      // the pointer jittering across the edge) must REPLACE the pending open,
+      // not add one: an overwritten timer can no longer be cancelled, and it
+      // reopened the card after Escape had closed it.
+      clearPending(enterTimeoutRef);
 
-      const target = event.currentTarget;
       enterTimeoutRef.current = window.setTimeout(() => {
-        setAnchorEl(target);
+        setAnchorEl(trigger);
         setIsOpen(true);
         onOpen?.();
       }, enterDelay);
@@ -140,9 +196,8 @@ export const useHoverCard = ({
   );
 
   const closeCard = React.useCallback(() => {
-    if (enterTimeoutRef.current) {
-      window.clearTimeout(enterTimeoutRef.current);
-    }
+    clearPending(enterTimeoutRef);
+    clearPending(exitTimeoutRef);
 
     exitTimeoutRef.current = window.setTimeout(() => {
       setIsOpen(false);
@@ -151,7 +206,11 @@ export const useHoverCard = ({
     }, exitDelay);
   }, [exitDelay, onClose]);
 
+  // Escape and the popover's own close are FINAL: nothing still pending may
+  // reopen the card behind them. It opens again on the next enter.
   const handleClose = React.useCallback(() => {
+    clearPending(enterTimeoutRef);
+    clearPending(exitTimeoutRef);
     setIsOpen(false);
     setAnchorEl(null);
     onClose?.();
@@ -166,15 +225,11 @@ export const useHoverCard = ({
     exitTimeoutRef,
   });
 
-  useEscapeKey(isOpen, handleClose);
+  const insideCard = React.useCallback(() => [anchorEl, contentRef.current], [anchorEl]);
 
-  React.useEffect(
-    () => () => {
-      if (enterTimeoutRef.current) window.clearTimeout(enterTimeoutRef.current);
-      if (exitTimeoutRef.current) window.clearTimeout(exitTimeoutRef.current);
-    },
-    [],
-  );
+  useEscapeKey(isOpen, handleClose);
+  useClickAway(isOpen, insideCard, handleClose);
+  useClearOnUnmount(enterTimeoutRef, exitTimeoutRef);
 
-  return { anchorEl, isOpen, handleClose, triggerHandlers, cardHandlers };
+  return { anchorEl, isOpen, handleClose, triggerHandlers, cardHandlers, contentRef };
 };

package/src/components/data-display/HoverCard/HoverCard.md

@@ -107,6 +107,7 @@ The HoverCard component displays additional information in a card-style popup wh
 ## Accessibility Notes
 
 - The component supports keyboard navigation (Escape key to close)
+- The card is dismissed by moving the pointer off the trigger and the card (after `exitDelay`), by Escape, or by a tap or click anywhere outside them. The outside press still reaches what it landed on: the page under an open card stays usable
 - Proper ARIA attributes are applied to the popover
 - Focus management is handled automatically
 - Touch support for mobile devices can be enabled/disabled

package/src/components/data-display/HoverCard/HoverCard.tsx

@@ -26,6 +26,15 @@ const StyledCard = styled(Card, {
 const StyledPopover = styled(Popover, {
   shouldForwardProp: (prop) => prop !== 'customAnimation',
 })<{ customAnimation?: HoverCardAnimation }>(({ customAnimation }) => ({
+  // Only the card takes the pointer (its paper sets `pointer-events: auto`).
+  // MUI's popover root and its invisible backdrop cover the whole viewport, so
+  // while a card was open the pointer was "on the card" wherever it went: the
+  // backdrop's mouseover reached the card's onMouseEnter and cancelled the
+  // close the trigger's mouseleave had just scheduled. A card left by moving
+  // the mouse away stayed open, and the page's next click hit the backdrop
+  // instead of its target (FUT-2619). The backdrop was also the only
+  // click-away; `useClickAway` in the hooks replaces it.
+  pointerEvents: 'none',
   // The popover only positions; StyledCard draws the surface.
   '& .MuiPopover-paper': {
     backgroundColor: 'transparent',
@@ -81,7 +90,7 @@ export const HoverCard = React.forwardRef<HTMLDivElement, HoverCardProps>((props
     ...rest
   } = withDefaults(props, DEFAULTS) as ResolvedProps;
 
-  const { anchorEl, isOpen, handleClose, triggerHandlers, cardHandlers } = useHoverCard({
+  const { anchorEl, isOpen, handleClose, triggerHandlers, cardHandlers, contentRef } = useHoverCard({
     disabled,
     touchEnabled,
     enterDelay,
@@ -124,7 +133,7 @@ export const HoverCard = React.forwardRef<HTMLDivElement, HoverCardProps>((props
         slotProps={{ paper: { style: { pointerEvents: 'auto' } } }}
         {...rest}
       >
-        <Box sx={{ position: 'relative' }}>
+        <Box ref={contentRef} sx={{ position: 'relative' }}>
           {showArrow && <ArrowContainer placement={placement} offset={offset} />}
           <StyledCard
             customVariant={variant}

package/src/components/form/Input/Input.tsx

@@ -89,6 +89,39 @@ const interactionProps = (
   onClick: loading ? undefined : onClick,
 });
 
+/**
+ * The ARIA that describes the field has to sit on the `<input>`: the text
+ * field puts every attribute it does not recognise on its root `FormControl`,
+ * a `<div>` with no role, where a screen reader never reads it.
+ *
+ * `aria-label` has ridden `inputProps` since FUT-755. `aria-describedby` and
+ * `aria-busy` fell through to the div until FUT-2619, so CepField's input
+ * pointed at nothing while its lookup status lived in a live region beside it.
+ *
+ * `inputProps` are spread onto the `<input>` AFTER the `aria-describedby` MUI
+ * writes for helper text, so a caller's ids REPLACE the helper text's: MUI's
+ * `TextField` on its own keeps only one of the two. This joins both, helper
+ * text first. The helper id is MUI's `<id>-helper-text` (the parity test pins
+ * that spelling), which is why the field's id is fixed here rather than left
+ * to the text field.
+ */
+function inputAriaOf(a: {
+  id: string;
+  helperText: React.ReactNode;
+  label?: string;
+  describedBy?: string;
+  busy?: InputProps['aria-busy'];
+}): Record<string, unknown> {
+  const describedBy = [a.helperText ? `${a.id}-helper-text` : undefined, a.describedBy]
+    .filter(Boolean)
+    .join(' ');
+  return {
+    ...(a.label === undefined ? {} : { 'aria-label': a.label }),
+    ...(a.describedBy === undefined ? {} : { 'aria-describedby': describedBy }),
+    ...(a.busy === undefined ? {} : { 'aria-busy': a.busy }),
+  };
+}
+
 export const Input = React.forwardRef<HTMLInputElement, InputProps>(
   (
     {
@@ -108,11 +141,15 @@ export const Input = React.forwardRef<HTMLInputElement, InputProps>(
       onFocus,
       onBlur,
       'aria-label': ariaLabel,
+      'aria-describedby': ariaDescribedBy,
+      'aria-busy': ariaBusy,
       ...rest
     },
     ref,
   ) => {
     const { testId: dataTestId, rest: props } = splitTestId(rest);
+    const generatedId = React.useId();
+    const id = props.id ?? generatedId;
     return (
       <StyledTextField
         ref={ref}
@@ -137,10 +174,11 @@ export const Input = React.forwardRef<HTMLInputElement, InputProps>(
          * no accessible name, and a source grep saying "this input is labelled"
          * disagreed with the DOM. The reports search box and the block-title
          * inputs were both named in source and anonymous to a screen reader.
+         * `aria-describedby` and `aria-busy` are the same case: `inputAriaOf`.
          */
         inputProps={{
           'data-testid': dataTestId,
-          ...(ariaLabel === undefined ? {} : { 'aria-label': ariaLabel }),
+          ...inputAriaOf({ id, helperText, label: ariaLabel, describedBy: ariaDescribedBy, busy: ariaBusy }),
         }}
         InputProps={{
           startAdornment: startAdornment && (
@@ -150,6 +188,7 @@ export const Input = React.forwardRef<HTMLInputElement, InputProps>(
         }}
         {...SIZE_MAP[size]}
         {...props}
+        id={id}
       />
     );
   },