@spaced-out/ui-design-system 0.6.33 → 0.6.35-beta.0

package/lib/components/Menu/useMenuTrigger.js

@@ -0,0 +1,347 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.useMenuTrigger = exports.useComboboxMenuTrigger = void 0;
+var React = _interopRequireWildcard(require("react"));
+var _Menu = require("./Menu");
+var _menuOptionId = require("./menuOptionId");
+var _useMenuKeyboardNavigation = require("./useMenuKeyboardNavigation");
+function _interopRequireWildcard(e, t) { if ("function" == typeof WeakMap) var r = new WeakMap(), n = new WeakMap(); return (_interopRequireWildcard = function (e, t) { if (!t && e && e.__esModule) return e; var o, i, f = { __proto__: null, default: e }; if (null === e || "object" != typeof e && "function" != typeof e) return f; if (o = t ? n : r) { if (o.has(e)) return o.get(e); o.set(e, f); } for (const t in e) "default" !== t && {}.hasOwnProperty.call(e, t) && ((i = (o = Object.defineProperty) && Object.getOwnPropertyDescriptor(e, t)) && (i.get || i.set) ? o(f, t, i) : f[t] = e[t]); return f; })(e, t); }
+/**
+ * Drop undefined-valued keys. The props these hooks return are spread AFTER the
+ * consumer's own `menu` props, and an own property holding `undefined` would
+ * erase a value the consumer set — `{...menu, ...{ariaLabel: undefined}}` has no
+ * label at all.
+ */
+const compact = obj => Object.fromEntries(Object.entries(obj).filter(_ref => {
+  let [, value] = _ref;
+  return value !== undefined;
+}));
+
+/**
+ * Wires a trigger to the Menu it opens.
+ *
+ * Three things have to live on the trigger rather than in Menu, because they
+ * exist while the menu does NOT: `aria-haspopup`, `aria-expanded="false"`, and
+ * the ArrowDown/ArrowUp that opens the popup in the first place. That is the
+ * floor — no Menu prop can supply them — so these hooks hand them over as props
+ * to spread instead, and own everything else: the ids, the tie between the
+ * trigger's name and the listbox, and the ref Menu focuses into on open.
+ *
+ * `useMenuTrigger` is for triggers whose popup options own focus — a button, a
+ * tab overflow chevron, an inline label — so arrows move real DOM focus.
+ * `useComboboxMenuTrigger` is for triggers that are text inputs, where focus
+ * stays put and the highlight is virtual (`aria-activedescendant`).
+ *
+ * `getTriggerProps` is a getter rather than a static object because open state
+ * belongs to the consumer's `ClickAway`, which exposes it through a render
+ * callback — where a hook cannot be called.
+ *
+ *     const menuTrigger = useMenuTrigger({id: props.id, ariaLabel: menu?.ariaLabel});
+ *     <ClickAway>
+ *       {({isOpen, onOpen, clickAway}) => (
+ *         <>
+ *           <Button {...props} {...menuTrigger.getTriggerProps({isOpen, onOpen})} />
+ *           {isOpen && <Menu {...menu} {...menuTrigger.menuProps} onTabOut={clickAway} />}
+ *         </>
+ *       )}
+ *     </ClickAway>
+ */
+
+/**
+ * Generic in the trigger element so the returned handler matches whatever it is
+ * spread onto — inferred from the trigger's own `onKeyDown` where it has one.
+ */
+
+const useMenuTrigger = function () {
+  let {
+    id,
+    menuId: consumerMenuId,
+    ariaLabel,
+    ariaLabelledBy
+  } = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : {};
+  const generatedMenuId = React.useId();
+  const generatedTriggerId = React.useId();
+  const menuId = consumerMenuId ?? generatedMenuId;
+  const triggerId = id ?? generatedTriggerId;
+  const initialFocusRef = React.useRef(null);
+  const getTriggerProps = _ref2 => {
+    let {
+      isOpen,
+      onOpen,
+      onKeyDown
+    } = _ref2;
+    return {
+      id: triggerId,
+      'aria-haspopup': 'listbox',
+      'aria-expanded': isOpen,
+      // Only while the listbox is actually rendered: an IDREF that resolves to
+      // nothing is an invalid value, not an empty one.
+      'aria-controls': isOpen ? menuId : undefined,
+      onKeyDown: event => {
+        onKeyDown?.(event);
+        // Opening on an arrow key is the trigger's job precisely because the menu
+        // does not exist yet to handle it. Leave the key alone if the trigger's
+        // own handler already claimed it.
+        if (event.defaultPrevented || isOpen) {
+          return;
+        }
+        if (event.key === 'ArrowDown' || event.key === 'ArrowUp') {
+          event.preventDefault();
+          onOpen();
+        }
+      }
+    };
+  };
+  return {
+    getTriggerProps,
+    menuProps: compact({
+      menuId,
+      // An explicit label suppresses the idref, so the two never compete.
+      ariaLabelledBy: ariaLabel ? undefined : ariaLabelledBy ?? triggerId,
+      ariaLabel,
+      initialFocusRef
+    })
+  };
+};
+
+/**
+ * Which of ARIA's two combobox patterns the trigger implements.
+ *
+ * - `select` — a read-only field standing in for a `<select>`. An option is
+ *   highlighted as soon as the list opens, Space selects it (the field has no
+ *   typing role), and Enter or Space opens the list in the first place.
+ * - `autocomplete` — an editable field that filters the list as you type.
+ *   Nothing is highlighted until the user arrows to it (APG calls this manual
+ *   selection: auto-highlighting would let Enter select something they never
+ *   chose), Space types a space, and only the arrow keys open the list.
+ */
+exports.useMenuTrigger = useMenuTrigger;
+/**
+ * Wires a COMBOBOX trigger — a text input — to the Menu it opens. Focus stays
+ * on the input and the highlight is virtual, reported through
+ * `aria-activedescendant`, because the input has to keep receiving the keys it
+ * filters with.
+ *
+ * Driving the highlight from outside Menu means owning the active option as
+ * state, and owning it means deriving the same option list, initial highlight
+ * and navigation list that Menu derives internally. Both combobox consumers had
+ * grown their own copies of all three; they come from Menu itself now.
+ *
+ * A menu that carries its own filter field (`menu.allowSearch`) inverts the
+ * model: navigation lives inside Menu, so the trigger stops driving it and
+ * hands over an `initialFocusRef` instead. Both shapes come out of this hook.
+ */
+const useComboboxMenuTrigger = _ref3 => {
+  let {
+    pattern = 'select',
+    menu,
+    options,
+    canOpen,
+    menuRef,
+    isOpen,
+    onSelectOption,
+    onClose,
+    focusTrigger,
+    triggerAriaLabelledBy,
+    triggerAriaLabel,
+    defaultAriaLabel = 'Options'
+  } = _ref3;
+  const generatedMenuId = React.useId();
+  // The consumer's own id wins: it is what their `aria-controls` elsewhere, or
+  // their tests, already point at.
+  const menuId = menu?.menuId ?? generatedMenuId;
+  const initialFocusRef = React.useRef(null);
+  const [activeOptionKey, setActiveOptionKey] = React.useState(null);
+  const isAutocomplete = pattern === 'autocomplete';
+
+  // A searchable menu drives navigation internally from its own filter field; a
+  // select-only menu is driven by this trigger instead, with focus never
+  // entering the listbox. An autocomplete trigger IS the filter field, so it
+  // always drives navigation itself.
+  const usesExternalNav = isAutocomplete || !menu?.allowSearch;
+
+  /** The options the keyboard navigates, whatever supplied them. */
+  const optionSource = React.useMemo(() => options ?? (menu ? (0, _Menu.getFlatOptions)(menu) : []), [options, menu]);
+
+  /*
+   * `listbox` is an accessible-name-required role, so the popup must be named.
+   * Best name first:
+   *   1. what the consumer said (`menu.ariaLabelledBy` / `menu.ariaLabel`),
+   *   2. whatever already labels the trigger — a field label is the most useful
+   *      name there is,
+   *   3. a literal fallback. Deliberately NOT the placeholder: echoing
+   *      "Select..." names the list after an instruction, not its contents.
+   * An explicit label suppresses the idref, since a listbox drops `aria-label`
+   * whenever `aria-labelledby` is present.
+   */
+  const menuAriaLabelledBy = menu?.ariaLabelledBy ?? (menu?.ariaLabel ? undefined : triggerAriaLabelledBy);
+  const menuAriaLabel = menu?.ariaLabel ?? (menuAriaLabelledBy ? undefined : triggerAriaLabel ?? defaultAriaLabel);
+  const selectByKey = key => {
+    const option = optionSource.find(opt => opt.key === key);
+    if (option) {
+      onSelectOption(option);
+    }
+  };
+
+  /*
+   * A virtualized menu keeps only a window of rows in the DOM, so the keyboard
+   * hook would otherwise clamp End / PageDown / wrap-around / type-ahead to that
+   * window. Hand it the real option list in that case — whichever source it came
+   * from, and flat or grouped alike, since Menu handles both — and Menu
+   * scrolls the active row into view. Plain menus stay on the DOM-driven path,
+   * which keeps grouped layouts and `resolveLabel` type-ahead working off the
+   * rendered text.
+   */
+  const resolveLabel = menu?.resolveLabel;
+  const navigationOptions = React.useMemo(() => {
+    // A wholly disabled menu has no navigable options at all.
+    if (!menu?.virtualization?.enable || menu.menuDisabled) {
+      return undefined;
+    }
+    return optionSource.filter(option => !option.disabled).map(option => {
+      // Type-ahead must match the text the user can actually read.
+      const resolved = resolveLabel?.(option);
+      return {
+        key: option.key,
+        label: typeof resolved === 'string' ? resolved : option.label ?? ''
+      };
+    });
+  }, [menu?.virtualization?.enable, menu?.menuDisabled, resolveLabel, optionSource]);
+  const {
+    onKeyDown: onComboboxKeyDown
+  } = (0, _useMenuKeyboardNavigation.useMenuKeyboardNavigation)({
+    containerRef: menuRef,
+    enabled: isOpen && usesExternalNav && !menu?.menuDisabled,
+    // An editable trigger keeps printable keys for filtering; a read-only one
+    // spends them on type-ahead.
+    mode: isAutocomplete ? 'search' : 'activedescendant',
+    activeOptionKey,
+    onSelectKey: selectByKey,
+    setActiveOptionKey,
+    options: navigationOptions
+  });
+
+  /*
+   * Seed the highlight when the menu opens, drop it when it closes, and keep it
+   * valid while the option set changes underneath it (async or cascading
+   * options). Menu skips its own re-validation under `externalKeyboardNav`, so
+   * the trigger owns it — without this, `aria-activedescendant` could point at
+   * the id of an option that no longer exists. A layout effect, so the id is in
+   * place before the browser paints the open menu.
+   */
+  const selectedKeys = menu?.selectedKeys;
+  const selectedOption = menu?.selectedOption;
+  React.useLayoutEffect(() => {
+    // A closed list has no active option, whichever pattern this is.
+    if (!isOpen) {
+      setActiveOptionKey(null);
+      return;
+    }
+    const enabledKeys = optionSource.filter(option => !option.disabled).map(option => option.key);
+    const surviving = prev => prev && enabledKeys.includes(prev) ? prev : null;
+    if (isAutocomplete) {
+      // Manual selection: never highlight anything on the user's behalf, only
+      // drop a highlight that the filtering has removed under them.
+      setActiveOptionKey(surviving);
+      return;
+    }
+    if (!usesExternalNav) {
+      setActiveOptionKey(null);
+      return;
+    }
+    setActiveOptionKey(prev => surviving(prev) ?? (0, _Menu.getInitialActiveOptionKey)({
+      options: optionSource,
+      selectedKeys,
+      selectedOption
+    }));
+  }, [isAutocomplete, isOpen, usesExternalNav, optionSource, selectedKeys, selectedOption]);
+  const getTriggerProps = _ref4 => {
+    let {
+      isOpen: triggerIsOpen,
+      isExpanded,
+      onOpen,
+      onKeyDown
+    } = _ref4;
+    const expanded = isExpanded ?? triggerIsOpen;
+    return {
+      // The one combobox for both shapes: the menu's own filter field is a
+      // `searchbox`, so nothing competes for the listbox. Keeping the role
+      // unconditional also keeps `aria-expanded` valid — it is not an allowed
+      // attribute on a plain textbox.
+      role: 'combobox',
+      'aria-haspopup': 'listbox',
+      'aria-expanded': expanded,
+      // Only reference the listbox while it is actually rendered. The hook always
+      // hands `menuId` to Menu, so the element exists whenever `expanded` says so,
+      // whichever option source was supplied.
+      'aria-controls': expanded ? menuId : undefined,
+      // 'list' whenever typing narrows the list: the autocomplete pattern, or a
+      // menu carrying its own filter field.
+      'aria-autocomplete': isAutocomplete || !usesExternalNav ? 'list' : 'none',
+      'aria-activedescendant': expanded && usesExternalNav && activeOptionKey ? (0, _menuOptionId.menuOptionId)(menuId, activeOptionKey) : undefined,
+      onKeyDown: event => {
+        onKeyDown?.(event);
+        if (event.defaultPrevented) {
+          return;
+        }
+        if (!triggerIsOpen) {
+          // Closed: the arrow keys open the list, and a read-only trigger takes
+          // Enter and Space for it too — a typed space belongs to an editable
+          // one. This is the part no Menu prop can supply: the menu does not
+          // exist yet.
+          const opensList = event.key === 'ArrowDown' || event.key === 'ArrowUp' || !isAutocomplete && (event.key === 'Enter' || event.key === ' ');
+          if (opensList && (canOpen?.() ?? true)) {
+            event.preventDefault();
+            onOpen();
+          }
+          return;
+        }
+        // Open + searchable: focus is in the menu's own filter field, which owns
+        // navigation — nothing to do here.
+        if (!usesExternalNav) {
+          return;
+        }
+        // Tab moves into the menu's footer, Shift+Tab into its header, when that
+        // region has focusable controls. With none there, the listbox closes
+        // (APG: the popup closes when the combobox loses focus) and focus moves
+        // on.
+        if (event.key === 'Tab') {
+          if ((0, _useMenuKeyboardNavigation.moveFocusToMenuChrome)(menuRef.current, event.shiftKey)) {
+            event.preventDefault();
+          } else {
+            onClose();
+          }
+          return;
+        }
+        // Space selects the active option — only where it has no typing role.
+        if (!isAutocomplete && event.key === ' ') {
+          event.preventDefault();
+          if (activeOptionKey) {
+            selectByKey(activeOptionKey);
+          }
+          return;
+        }
+        // Arrows / Home / End / Enter / type-ahead.
+        onComboboxKeyDown(event);
+      }
+    };
+  };
+  return {
+    getTriggerProps,
+    menuProps: compact({
+      menuId,
+      ariaLabelledBy: menuAriaLabelledBy,
+      ariaLabel: menuAriaLabel,
+      externalKeyboardNav: usesExternalNav,
+      activeOptionKey: usesExternalNav ? activeOptionKey : undefined,
+      onActiveOptionKeyChange: usesExternalNav ? setActiveOptionKey : undefined,
+      onReturnFocusToInput: usesExternalNav ? focusTrigger : undefined,
+      initialFocusRef: usesExternalNav ? undefined : initialFocusRef
+    }),
+    activeOptionKey
+  };
+};
+exports.useComboboxMenuTrigger = useComboboxMenuTrigger;

package/lib/components/TruncatedTextWithTooltip/TruncatedTextWithTooltip.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"TruncatedTextWithTooltip.d.ts","sourceRoot":"","sources":["../../../src/components/TruncatedTextWithTooltip/TruncatedTextWithTooltip.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAQ/B,OAAO,KAAK,EAAC,gBAAgB,EAAC,MAAM,wBAAwB,CAAC;AAM7D,KAAK,UAAU,GAAG,QAAQ,CAAC;IACzB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,CAAC,CAAC;AAEH,MAAM,WAAW,6BAA6B;IAC5C,QAAQ,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IAC3B,OAAO,CAAC,EAAE,gBAAgB,CAAC;IAC3B,UAAU,CAAC,EAAE,UAAU,CAAC;IACxB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAYD,eAAO,MAAM,wBAAwB,GAAI,uEAQtC,6BAA6B,sBAkG/B,CAAC"}
+{"version":3,"file":"TruncatedTextWithTooltip.d.ts","sourceRoot":"","sources":["../../../src/components/TruncatedTextWithTooltip/TruncatedTextWithTooltip.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAO/B,OAAO,KAAK,EAAC,gBAAgB,EAAC,MAAM,wBAAwB,CAAC;AAM7D,KAAK,UAAU,GAAG,QAAQ,CAAC;IACzB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,CAAC,CAAC;AAEH,MAAM,WAAW,6BAA6B;IAC5C,QAAQ,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IAC3B,OAAO,CAAC,EAAE,gBAAgB,CAAC;IAC3B,UAAU,CAAC,EAAE,UAAU,CAAC;IACxB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,eAAO,MAAM,wBAAwB,GAAI,uEAQtC,6BAA6B,sBAiH/B,CAAC"}

package/lib/components/TruncatedTextWithTooltip/TruncatedTextWithTooltip.js

@@ -8,16 +8,11 @@ var React = _interopRequireWildcard(require("react"));
 var _debounce = _interopRequireDefault(require("lodash/debounce"));
 var _classify = _interopRequireDefault(require("../../utils/classify"));
 var _qa = require("../../utils/qa");
-var _ConditionalWrapper = require("../ConditionalWrapper");
 var _Tooltip = require("../Tooltip");
 var _TruncatedTextWithTooltipModule = _interopRequireDefault(require("./TruncatedTextWithTooltip.module.css"));
 var _jsxRuntime = require("react/jsx-runtime");
 function _interopRequireDefault(e) { return e && e.__esModule ? e : { default: e }; }
 function _interopRequireWildcard(e, t) { if ("function" == typeof WeakMap) var r = new WeakMap(), n = new WeakMap(); return (_interopRequireWildcard = function (e, t) { if (!t && e && e.__esModule) return e; var o, i, f = { __proto__: null, default: e }; if (null === e || "object" != typeof e && "function" != typeof e) return f; if (o = t ? n : r) { if (o.has(e)) return o.get(e); o.set(e, f); } for (const t in e) "default" !== t && {}.hasOwnProperty.call(e, t) && ((i = (o = Object.defineProperty) && Object.getOwnPropertyDescriptor(e, t)) && (i.get || i.set) ? o(f, t, i) : f[t] = e[t]); return f; })(e, t); }
-// Define the expected props for the child element that can be cloned
-
-// Type for a child element that can be cloned
-
 const TruncatedTextWithTooltip = _ref => {
   let {
     classNames,
@@ -41,6 +36,15 @@ const TruncatedTextWithTooltip = _ref => {
   }), [truncatedNode, wrapText]);
   React.useEffect(() => {
     checkIfTextOverflowing();
+    // Cancel the outgoing debounce instance's pending trailing-edge call.
+    // checkIfTextOverflowing is recreated whenever truncatedNode changes
+    // (e.g. once on mount, null -> real node). Without this cancel, the
+    // stale instance's trailing call still fires ~200ms later using its
+    // frozen closure (truncatedNode as it was when THAT instance was
+    // created) and can stomp a correct value the new instance already set.
+    return () => {
+      checkIfTextOverflowing.cancel();
+    };
   }, [line, children, wrapText, checkIfTextOverflowing]);
   React.useEffect(() => {
     if (!truncatedNode) {
@@ -58,57 +62,66 @@ const TruncatedTextWithTooltip = _ref => {
     '--line-clamp': wrapText ? 'unset' : line,
     '--word-break': wordBreak
   };
-  return /*#__PURE__*/(0, _jsxRuntime.jsx)(_ConditionalWrapper.ConditionalWrapper, {
-    condition: Boolean(showMouseTip),
-    wrapper: children => {
-      const child = React.Children.only(children);
 
-      // Type guard to ensure child is a ReactElement
-      if (! /*#__PURE__*/React.isValidElement(child)) {
-        return child;
-      }
-
-      // Cast to our typed child element
-      const childElement = child;
-      const childProps = childElement.props;
+  // Always render the same <span>, always wrapped in the same <Tooltip>,
+  // toggling only Tooltip's `hidden` prop. Previously a ConditionalWrapper
+  // swapped between a bare <span> and <Tooltip><div>{span}</div></Tooltip>
+  // based on showMouseTip — changing the element type at this tree position
+  // forces React to unmount/remount the span every time showMouseTip
+  // toggles. The remounted span (now a flex child of an extra wrapper div)
+  // measures different scrollHeight/clientHeight than the bare span, so the
+  // ResizeObserver above sees its own self-inflicted resize and flips
+  // showMouseTip again — an infinite loop where the tooltip never
+  // stabilizes. Tooltip clones its trigger prop onto the same element (no
+  // wrapper element inserted), so keeping the span's identity stable here
+  // means toggling showMouseTip no longer causes a remount.
+  const truncatedSpan = /*#__PURE__*/(0, _jsxRuntime.jsx)("span", {
+    className: (0, _classify.default)(_TruncatedTextWithTooltipModule.default.truncateLineClamp, classNames?.wrapper),
+    style: styles,
+    ref: setTruncatedNode,
+    "data-testid": (0, _qa.generateTestId)({
+      base: testId,
+      slot: 'text'
+    }),
+    children: children
+  });
 
-      //Vivek: This children in tooltip body is modified to remove line clamp style
-      const modifiedChild = /*#__PURE__*/React.cloneElement(childElement, {
-        ...childProps,
-        style: {
-          ...childProps.style,
-          '--line-clamp': tooltip?.bodyMaxLines || line,
-          '--word-break': wordBreak
-        }
-      });
-      return /*#__PURE__*/(0, _jsxRuntime.jsx)(_Tooltip.Tooltip, {
-        ...tooltip,
-        body: tooltip?.body || modifiedChild,
-        elevation: tooltip?.elevation ?? 'toast',
-        testId: (0, _qa.generateTestId)({
-          base: testId,
-          slot: 'tooltip'
-        }),
-        children: /*#__PURE__*/(0, _jsxRuntime.jsx)("div", {
-          className: _TruncatedTextWithTooltipModule.default.childrenWrapper,
-          "data-testid": (0, _qa.generateTestId)({
-            base: testId,
-            slot: 'wrapper'
-          }),
-          children: children
-        })
-      });
-    },
-    children: /*#__PURE__*/(0, _jsxRuntime.jsx)("span", {
-      className: (0, _classify.default)(_TruncatedTextWithTooltipModule.default.truncateLineClamp, classNames?.wrapper),
-      style: styles,
-      ref: setTruncatedNode,
-      "data-testid": (0, _qa.generateTestId)({
-        base: testId,
-        slot: 'text'
-      }),
-      children: children
+  // `ref: null` is required here: React.cloneElement inherits the source
+  // element's ref unless explicitly overridden. Without this, this
+  // body-only clone (rendered separately inside Tooltip's floating panel,
+  // gated by `hidden`) would share the trigger span's ref. Mounting/
+  // unmounting this clone as `hidden` toggles would hijack truncatedNode
+  // away from the actual trigger, eventually losing the ref to the real
+  // trigger permanently once this clone unmounts.
+  //
+  // No className/style here (rather than trying to override --line-clamp):
+  // Tooltip already wraps body in <Truncate line={bodyMaxLines}>, which puts
+  // its own webkit-box line-clamp on the containing div. Keeping
+  // css.truncateLineClamp on this span would make it a second, nested
+  // webkit-box with its own --word-break (this component's `wordBreak` prop,
+  // meant for the single-line trigger) — since that inner box is what
+  // actually renders the text, it silently wins over the outer div's
+  // word-break even when both clamp to the same line count. Dropping the
+  // class/style lets the outer div be the only clamp in the chain.
+  const modifiedChild = /*#__PURE__*/React.cloneElement(truncatedSpan, {
+    ref: null,
+    className: undefined,
+    style: undefined,
+    'data-testid': (0, _qa.generateTestId)({
+      base: testId,
+      slot: 'body-text'
     })
   });
+  return /*#__PURE__*/(0, _jsxRuntime.jsx)(_Tooltip.Tooltip, {
+    ...tooltip,
+    hidden: tooltip?.hidden ?? !showMouseTip,
+    body: tooltip?.body || modifiedChild,
+    elevation: tooltip?.elevation ?? 'toast',
+    testId: (0, _qa.generateTestId)({
+      base: testId,
+      slot: 'tooltip'
+    }),
+    children: truncatedSpan
+  });
 };
 exports.TruncatedTextWithTooltip = TruncatedTextWithTooltip;

package/lib/components/TruncatedTextWithTooltip/TruncatedTextWithTooltip.module.css

@@ -2,6 +2,3 @@
   composes: truncate from '../../styles/typography.module.css';
   white-space: normal;
 }
-.childrenWrapper {
-  display: flex;
-}

package/lib/hooks/index.d.ts

@@ -4,6 +4,7 @@ export * from '../hooks/useDebounce';
 export * from '../hooks/useFileUpload';
 export * from '../hooks/useFilteredOptions';
 export * from '../hooks/useInfiniteScroll';
+export * from '../hooks/useInteractionModality';
 export * from '../hooks/useInputState';
 export * from '../hooks/useLockedBody';
 export * from '../hooks/useModal';

package/lib/hooks/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/hooks/index.ts"],"names":[],"mappings":"AAAA,cAAc,sCAAsC,CAAC;AACrD,cAAc,8BAA8B,CAAC;AAC7C,cAAc,uBAAuB,CAAC;AACtC,cAAc,yBAAyB,CAAC;AACxC,cAAc,8BAA8B,CAAC;AAC7C,cAAc,6BAA6B,CAAC;AAC5C,cAAc,yBAAyB,CAAC;AACxC,cAAc,yBAAyB,CAAC;AACxC,cAAc,oBAAoB,CAAC;AACnC,cAAc,8BAA8B,CAAC;AAC7C,cAAc,yBAAyB,CAAC;AACxC,cAAc,oCAAoC,CAAC;AACnD,cAAc,6BAA6B,CAAC;AAC5C,cAAc,0BAA0B,CAAC;AACzC,cAAc,qBAAqB,CAAC;AACpC,cAAc,yBAAyB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/hooks/index.ts"],"names":[],"mappings":"AAAA,cAAc,sCAAsC,CAAC;AACrD,cAAc,8BAA8B,CAAC;AAC7C,cAAc,uBAAuB,CAAC;AACtC,cAAc,yBAAyB,CAAC;AACxC,cAAc,8BAA8B,CAAC;AAC7C,cAAc,6BAA6B,CAAC;AAC5C,cAAc,kCAAkC,CAAC;AACjD,cAAc,yBAAyB,CAAC;AACxC,cAAc,yBAAyB,CAAC;AACxC,cAAc,oBAAoB,CAAC;AACnC,cAAc,8BAA8B,CAAC;AAC7C,cAAc,yBAAyB,CAAC;AACxC,cAAc,oCAAoC,CAAC;AACnD,cAAc,6BAA6B,CAAC;AAC5C,cAAc,0BAA0B,CAAC;AACzC,cAAc,qBAAqB,CAAC;AACpC,cAAc,yBAAyB,CAAC"}

package/lib/hooks/index.js

@@ -69,6 +69,17 @@ Object.keys(_useInfiniteScroll).forEach(function (key) {
     }
   });
 });
+var _useInteractionModality = require("./useInteractionModality");
+Object.keys(_useInteractionModality).forEach(function (key) {
+  if (key === "default" || key === "__esModule") return;
+  if (key in exports && exports[key] === _useInteractionModality[key]) return;
+  Object.defineProperty(exports, key, {
+    enumerable: true,
+    get: function () {
+      return _useInteractionModality[key];
+    }
+  });
+});
 var _useInputState = require("./useInputState");
 Object.keys(_useInputState).forEach(function (key) {
   if (key === "default" || key === "__esModule") return;

package/lib/hooks/useInteractionModality/index.d.ts

@@ -0,0 +1,2 @@
+export * from '../../hooks/useInteractionModality/useInteractionModality';
+//# sourceMappingURL=index.d.ts.map

package/lib/hooks/useInteractionModality/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/hooks/useInteractionModality/index.ts"],"names":[],"mappings":"AAAA,cAAc,yDAAyD,CAAC"}

package/lib/hooks/useInteractionModality/index.js

@@ -0,0 +1,16 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+var _useInteractionModality = require("./useInteractionModality");
+Object.keys(_useInteractionModality).forEach(function (key) {
+  if (key === "default" || key === "__esModule") return;
+  if (key in exports && exports[key] === _useInteractionModality[key]) return;
+  Object.defineProperty(exports, key, {
+    enumerable: true,
+    get: function () {
+      return _useInteractionModality[key];
+    }
+  });
+});

package/lib/hooks/useInteractionModality/useInteractionModality.d.ts

@@ -0,0 +1,15 @@
+export type InteractionModality = 'keyboard' | 'pointer';
+/**
+ * How the user last interacted with the page, read imperatively.
+ *
+ * Use this when the answer is needed during render or in an effect rather than
+ * as reactive state — for example a popup deciding on mount whether it was opened
+ * by keyboard, where re-rendering on later modality changes would be wrong.
+ */
+export declare const getInteractionModality: () => InteractionModality;
+/**
+ * How the user last interacted with the page, as reactive state. Re-renders the
+ * caller when the user switches between keyboard and pointer.
+ */
+export declare const useInteractionModality: () => InteractionModality;
+//# sourceMappingURL=useInteractionModality.d.ts.map

package/lib/hooks/useInteractionModality/useInteractionModality.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useInteractionModality.d.ts","sourceRoot":"","sources":["../../../src/hooks/useInteractionModality/useInteractionModality.ts"],"names":[],"mappings":"AAGA,MAAM,MAAM,mBAAmB,GAAG,UAAU,GAAG,SAAS,CAAC;AA6FzD;;;;;;GAMG;AACH,eAAO,MAAM,sBAAsB,QAAO,mBAGzC,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,sBAAsB,QAAO,mBAMzC,CAAC"}