Skip to content

The open alternative to Salesforce, designed for AI.

Measure table cell tooltips in the hover overlay instead of in every cell (#27956)

Charles Bochet3c7e1d5bc5bc
diff --git a/packages/twenty-docs/snippets/ui/generated/typography/overflowing-text-tooltip-mode-provider.mdx b/packages/twenty-docs/snippets/ui/generated/typography/overflowing-text-tooltip-mode-provider.mdx
new file mode 100644
index 00000000000..356ec1bbcf6
--- /dev/null
+++ b/packages/twenty-docs/snippets/ui/generated/typography/overflowing-text-tooltip-mode-provider.mdx
@@ -0,0 +1,20 @@
+{/*
+ * _____ _
+ *|_ _|_ _____ _ __ | |_ _ _
+ * | | \ \ /\ / / _ \ '_ \| __| | | | Auto-generated file
+ * | | \ V V / __/ | | | |_| |_| | DO NOT EDIT - changes will be overwritten
+ * |_| \_/\_/ \___|_| |_|\__|\__, | Generated by: npx nx generate:ui twenty-docs
+ * |___/
+ *
+ * This file is generated from the documentation data in packages/twenty-ui/generated.
+ * To update it, edit the component prop types or design tokens in twenty-ui and run:
+ * npx nx generate:ui twenty-docs
+ */}
+
+<ParamField body="children" type="ReactNode" required>
+ Content whose OverflowingTextWithTooltip instances use the mode.
+</ParamField>
+
+<ParamField body="mode" type="&quot;disabled&quot; | &quot;measure-on-hover&quot; | &quot;measure-on-open&quot;" required>
+ `measure-on-hover` checks truncation on pointer entry and focus. `measure-on-open` checks it when the tooltip tries to open. `disabled` renders only the text.
+</ParamField>
diff --git a/packages/twenty-docs/ui/primitives/typography/overflowing-text-tooltip-mode-provider.mdx b/packages/twenty-docs/ui/primitives/typography/overflowing-text-tooltip-mode-provider.mdx
new file mode 100644
index 00000000000..30b03b865b8
--- /dev/null
+++ b/packages/twenty-docs/ui/primitives/typography/overflowing-text-tooltip-mode-provider.mdx
@@ -0,0 +1,35 @@
+---
+title: OverflowingTextTooltipModeProvider
+description: Choose when OverflowingTextWithTooltip checks truncation for a subtree.
+---
+
+import OverflowingTextTooltipModeProviderReference from '/snippets/ui/generated/typography/overflowing-text-tooltip-mode-provider.mdx';
+
+`OverflowingTextTooltipModeProvider` sets how every [OverflowingTextWithTooltip](/ui/primitives/typography/overflowing-text-with-tooltip) inside it handles its tooltip. It renders no DOM element.
+
+## Usage
+
+```tsx
+import {
+ OverflowingTextTooltipModeProvider,
+ OverflowingTextWithTooltip,
+} from 'twenty-ui/primitives/typography';
+
+export const RecordCell = ({ name }: { name: string }) => (
+ <OverflowingTextTooltipModeProvider mode="disabled">
+ <OverflowingTextWithTooltip text={name} />
+ </OverflowingTextTooltipModeProvider>
+);
+```
+
+## Modes
+
+- `measure-on-hover`, the default without a provider, checks truncation on pointer entry and focus. A label that fits stays out of the way of a parent tooltip.
+- `measure-on-open` checks truncation when the tooltip tries to open. Use it for labels that mount under the pointer, such as a hover overlay, where no pointer entry happens.
+- `disabled` renders only the text, without any tooltip parts. Use it for many labels that a user cannot hover, such as content covered by an overlay.
+
+Nested providers override the mode for their subtree.
+
+## Props
+
+<OverflowingTextTooltipModeProviderReference />
diff --git a/packages/twenty-docs/ui/primitives/typography/overflowing-text-with-tooltip.mdx b/packages/twenty-docs/ui/primitives/typography/overflowing-text-with-tooltip.mdx
index 6168f558d40..e010e96ef9c 100644
--- a/packages/twenty-docs/ui/primitives/typography/overflowing-text-with-tooltip.mdx
+++ b/packages/twenty-docs/ui/primitives/typography/overflowing-text-with-tooltip.mdx
@@ -7,7 +7,7 @@ import { StoryEmbed } from '/snippets/ui/StoryEmbed.mdx';
import OverflowingTextWithTooltipReference from '/snippets/ui/generated/typography/overflowing-text-with-tooltip.mdx';
-`OverflowingTextWithTooltip` truncates content within the available width. It checks for overflow on pointer entry and focus, then shows a tooltip only when needed. It manages tooltip visibility internally and exposes no controlled or uncontrolled open-state props.
+`OverflowingTextWithTooltip` truncates content within the available width. It checks for overflow on pointer entry and focus, then shows a tooltip only when needed. It manages tooltip visibility internally and exposes no controlled or uncontrolled open-state props. Use [OverflowingTextTooltipModeProvider](/ui/primitives/typography/overflowing-text-tooltip-mode-provider) to change when a subtree checks truncation or to turn the tooltip off.
<StoryEmbed
storyId="ui-surfaces-overflowingtextwithtooltip--single-line-overflowing-documentation"
diff --git a/packages/twenty-front/src/modules/object-record/record-table/record-table-cell/components/RecordTableCell.tsx b/packages/twenty-front/src/modules/object-record/record-table/record-table-cell/components/RecordTableCell.tsx
index b46c2e2ab01..bb383877ae8 100644
--- a/packages/twenty-front/src/modules/object-record/record-table/record-table-cell/components/RecordTableCell.tsx
+++ b/packages/twenty-front/src/modules/object-record/record-table/record-table-cell/components/RecordTableCell.tsx
@@ -1,3 +1,5 @@
+import { OverflowingTextTooltipModeProvider } from 'twenty-ui/primitives/typography';
+
import { FieldDisplay } from '@/object-record/record-field/ui/components/FieldDisplay';
import { FieldFocusStaticUnfocusedProvider } from '@/object-record/record-field/ui/contexts/FieldFocusContextProvider';
import { RecordTableCellBaseContainer } from '@/object-record/record-table/record-table-cell/components/RecordTableCellBaseContainer';
@@ -6,11 +8,13 @@ import { RecordTableCellDisplayMode } from '@/object-record/record-table/record-
export const RecordTableCell = () => {
return (
<FieldFocusStaticUnfocusedProvider>
- <RecordTableCellBaseContainer>
- <RecordTableCellDisplayMode>
- <FieldDisplay />
- </RecordTableCellDisplayMode>
- </RecordTableCellBaseContainer>
+ <OverflowingTextTooltipModeProvider mode="disabled">
+ <RecordTableCellBaseContainer>
+ <RecordTableCellDisplayMode>
+ <FieldDisplay />
+ </RecordTableCellDisplayMode>
+ </RecordTableCellBaseContainer>
+ </OverflowingTextTooltipModeProvider>
</FieldFocusStaticUnfocusedProvider>
);
};
diff --git a/packages/twenty-front/src/modules/object-record/record-table/record-table-cell/components/RecordTableCellPortalContexts.tsx b/packages/twenty-front/src/modules/object-record/record-table/record-table-cell/components/RecordTableCellPortalContexts.tsx
index 699c8b342b6..40c1bb87834 100644
--- a/packages/twenty-front/src/modules/object-record/record-table/record-table-cell/components/RecordTableCellPortalContexts.tsx
+++ b/packages/twenty-front/src/modules/object-record/record-table/record-table-cell/components/RecordTableCellPortalContexts.tsx
@@ -9,6 +9,7 @@ import { RecordTableCellFieldContextWrapper } from '@/object-record/record-table
import { type TableCellPosition } from '@/object-record/record-table/types/TableCellPosition';
import { useAtomComponentSelectorValue } from '@/ui/utilities/state/jotai/hooks/useAtomComponentSelectorValue';
import { isDefined } from 'twenty-shared/utils';
+import { OverflowingTextTooltipModeProvider } from 'twenty-ui/primitives/typography';
export const RecordTableCellPortalContexts = ({
position,
@@ -65,7 +66,9 @@ export const RecordTableCellPortalContexts = ({
}}
>
<RecordTableCellFieldContextWrapper recordField={recordField}>
- {children}
+ <OverflowingTextTooltipModeProvider mode="measure-on-open">
+ {children}
+ </OverflowingTextTooltipModeProvider>
</RecordTableCellFieldContextWrapper>
</RecordTableCellContext.Provider>
</RecordTableRowContextProvider>
diff --git a/packages/twenty-ui/docs/components.ts b/packages/twenty-ui/docs/components.ts
index 392d8f9771c..fe4ae3e9a4f 100644
--- a/packages/twenty-ui/docs/components.ts
+++ b/packages/twenty-ui/docs/components.ts
@@ -66,6 +66,7 @@ import { LIGHT_BUTTON_PROP_DESCRIPTIONS } from './lightButtonPropDescriptions';
import { LIGHT_ICON_BUTTON_PROP_DESCRIPTIONS } from './lightIconButtonPropDescriptions';
import { LOADER_PROP_DESCRIPTIONS } from './loaderPropDescriptions';
import { SKELETON_PROP_DESCRIPTIONS } from './skeletonPropDescriptions';
+import { OVERFLOWING_TEXT_TOOLTIP_MODE_PROVIDER_PROP_DESCRIPTIONS } from './overflowingTextTooltipModeProviderPropDescriptions';
import { OVERFLOWING_TEXT_WITH_TOOLTIP_PROP_DESCRIPTIONS } from './overflowingTextWithTooltipPropDescriptions';
import { BADGE_PROP_DESCRIPTIONS } from './badgePropDescriptions';
import { PROGRESS_BAR_PROP_DESCRIPTIONS } from './progressBarPropDescriptions';
@@ -261,6 +262,14 @@ export const DOCUMENTED_COMPONENTS = [
slug: 'typography/overflowing-text-with-tooltip',
propDescriptions: OVERFLOWING_TEXT_WITH_TOOLTIP_PROP_DESCRIPTIONS,
},
+ {
+ name: 'OverflowingTextTooltipModeProvider',
+ source:
+ 'primitives/typography/OverflowingTextWithTooltip/OverflowingTextTooltipModeProvider.tsx',
+ entryPoint: 'twenty-ui/primitives/typography',
+ slug: 'typography/overflowing-text-tooltip-mode-provider',
+ propDescriptions: OVERFLOWING_TEXT_TOOLTIP_MODE_PROVIDER_PROP_DESCRIPTIONS,
+ },
{
name: 'LightIconButton',
source: 'components/input/LightIconButton/LightIconButton.tsx',
diff --git a/packages/twenty-ui/docs/module-ownership.json b/packages/twenty-ui/docs/module-ownership.json
index 2ebde7890b9..6962498af02 100644
--- a/packages/twenty-ui/docs/module-ownership.json
+++ b/packages/twenty-ui/docs/module-ownership.json
@@ -22,6 +22,7 @@
"ListItem",
"Loader",
"NumberField",
+ "OverflowingTextTooltipModeProvider",
"OverflowingTextWithTooltip",
"Popover",
"Progress",
diff --git a/packages/twenty-ui/docs/overflowingTextTooltipModeProviderPropDescriptions.ts b/packages/twenty-ui/docs/overflowingTextTooltipModeProviderPropDescriptions.ts
new file mode 100644
index 00000000000..133c23fa61e
--- /dev/null
+++ b/packages/twenty-ui/docs/overflowingTextTooltipModeProviderPropDescriptions.ts
@@ -0,0 +1,13 @@
+import { type ComponentProps } from 'react';
+
+import { type OverflowingTextTooltipModeProvider } from '../src/primitives/typography/OverflowingTextWithTooltip/OverflowingTextTooltipModeProvider';
+
+export const OVERFLOWING_TEXT_TOOLTIP_MODE_PROVIDER_PROP_DESCRIPTIONS = {
+ children: 'Content whose OverflowingTextWithTooltip instances use the mode.',
+ mode: '`measure-on-hover` checks truncation on pointer entry and focus. `measure-on-open` checks it when the tooltip tries to open. `disabled` renders only the text.',
+} satisfies Partial<
+ Record<
+ keyof ComponentProps<typeof OverflowingTextTooltipModeProvider>,
+ string
+ >
+>;
diff --git a/packages/twenty-ui/docs/public-exports.json b/packages/twenty-ui/docs/public-exports.json
index f3582104425..bf59259088f 100644
--- a/packages/twenty-ui/docs/public-exports.json
+++ b/packages/twenty-ui/docs/public-exports.json
@@ -1156,12 +1156,14 @@
"values": {
"formatShortcut": "primitives/typography/Shortcut/formatShortcut",
"Heading": "primitives/typography/Heading/Heading",
+ "OverflowingTextTooltipModeProvider": "primitives/typography/OverflowingTextWithTooltip/OverflowingTextTooltipModeProvider",
"OverflowingTextWithTooltip": "primitives/typography/OverflowingTextWithTooltip/OverflowingTextWithTooltip",
"Shortcut": "primitives/typography/Shortcut/Shortcut",
"Text": "primitives/typography/Text/Text"
},
"types": {
"HeadingProps": "primitives/typography/Heading/types/HeadingProps",
+ "OverflowingTextTooltipMode": "primitives/typography/OverflowingTextWithTooltip/types/OverflowingTextTooltipMode",
"OverflowingTextWithTooltipProps": "primitives/typography/OverflowingTextWithTooltip/types/OverflowingTextWithTooltipProps",
"ShortcutDefinition": "primitives/typography/Shortcut/types/ShortcutDefinition",
"ShortcutFormatOptions": "primitives/typography/Shortcut/types/ShortcutFormatOptions",
diff --git a/packages/twenty-ui/generated/components.docs.json b/packages/twenty-ui/generated/components.docs.json
index 597507eab7e..e9c9bf31f4e 100644
--- a/packages/twenty-ui/generated/components.docs.json
+++ b/packages/twenty-ui/generated/components.docs.json
@@ -1914,6 +1914,27 @@
}
]
},
+ {
+ "name": "OverflowingTextTooltipModeProvider",
+ "entryPoint": "twenty-ui/primitives/typography",
+ "slug": "typography/overflowing-text-tooltip-mode-provider",
+ "props": [
+ {
+ "name": "children",
+ "type": "ReactNode",
+ "required": true,
+ "defaultValue": null,
+ "description": "Content whose OverflowingTextWithTooltip instances use the mode."
+ },
+ {
+ "name": "mode",
+ "type": "\"disabled\" | \"measure-on-hover\" | \"measure-on-open\"",
+ "required": true,
+ "defaultValue": null,
+ "description": "`measure-on-hover` checks truncation on pointer entry and focus. `measure-on-open` checks it when the tooltip tries to open. `disabled` renders only the text."
+ }
+ ]
+ },
{
"name": "LightIconButton",
"entryPoint": "twenty-ui/components/input",
diff --git a/packages/twenty-ui/src/primitives/typography/OverflowingTextWithTooltip/OverflowingTextTooltipModeProvider.tsx b/packages/twenty-ui/src/primitives/typography/OverflowingTextWithTooltip/OverflowingTextTooltipModeProvider.tsx
new file mode 100644
index 00000000000..ed16042da9a
--- /dev/null
+++ b/packages/twenty-ui/src/primitives/typography/OverflowingTextWithTooltip/OverflowingTextTooltipModeProvider.tsx
@@ -0,0 +1,16 @@
+import { type ReactNode } from 'react';
+
+import { OverflowingTextTooltipModeContext } from './internal/OverflowingTextTooltipModeContext';
+import { type OverflowingTextTooltipMode } from './types/OverflowingTextTooltipMode';
+
+export const OverflowingTextTooltipModeProvider = ({
+ mode,
+ children,
+}: {
+ mode: OverflowingTextTooltipMode;
+ children: ReactNode;
+}) => (
+ <OverflowingTextTooltipModeContext.Provider value={mode}>
+ {children}
+ </OverflowingTextTooltipModeContext.Provider>
+);
diff --git a/packages/twenty-ui/src/primitives/typography/OverflowingTextWithTooltip/OverflowingTextWithTooltip.tsx b/packages/twenty-ui/src/primitives/typography/OverflowingTextWithTooltip/OverflowingTextWithTooltip.tsx
index dab6e6833f1..86489d66852 100644
--- a/packages/twenty-ui/src/primitives/typography/OverflowingTextWithTooltip/OverflowingTextWithTooltip.tsx
+++ b/packages/twenty-ui/src/primitives/typography/OverflowingTextWithTooltip/OverflowingTextWithTooltip.tsx
@@ -1,11 +1,13 @@
import { mergeProps } from '@base-ui/react/merge-props';
import { useMergedRefs } from '@base-ui/utils/useMergedRefs';
-import { memo, useRef, useState, type MouseEvent } from 'react';
+import { memo, useContext, useRef, useState, type MouseEvent } from 'react';
import { isNonEmptyString } from '@sniptt/guards';
import { Tooltip } from '@ui/primitives/surfaces/Tooltip/Tooltip';
import { TooltipBody } from '@ui/primitives/surfaces/Tooltip/internal/TooltipBody';
import { Text } from '@ui/primitives/typography/Text/Text';
+import { isElementOverflowing } from './internal/isElementOverflowing';
+import { OverflowingTextTooltipModeContext } from './internal/OverflowingTextTooltipModeContext';
import { type OverflowingTextWithTooltipProps } from './types/OverflowingTextWithTooltipProps';
import { isDefined } from '@ui/utilities/utils/isDefined';
import { clsx } from 'clsx';
@@ -28,18 +30,17 @@ export const OverflowingTextWithTooltip = memo(
className,
...props
}: OverflowingTextWithTooltipProps) {
+ const tooltipMode = useContext(OverflowingTextTooltipModeContext);
+ const areTooltipsDisabled = tooltipMode === 'disabled';
const textRef = useRef<HTMLDivElement>(null);
- const mergedRef = useMergedRefs(textRef, ref);
const [isTitleOverflowing, setIsTitleOverflowing] = useState(false);
const [isTooltipOpen, setIsTooltipOpen] = useState(false);
+ const mergedRef = useMergedRefs(textRef, ref);
+
const updateOverflowState = () => {
- const textElement = textRef.current;
- const isOverflowing =
- isDefined(textElement) &&
- (textElement.scrollHeight > textElement.clientHeight ||
- textElement.scrollWidth > textElement.clientWidth);
+ const isOverflowing = isElementOverflowing(textRef.current);
setIsTitleOverflowing(isOverflowing);
@@ -71,6 +72,40 @@ export const OverflowingTextWithTooltip = memo(
const isMultiline = isDefined(lineClamp);
+ const textElement = (
+ <Text
+ {...(isMultiline ? { lineClamp } : { truncate: truncate ?? true })}
+ dir="auto"
+ data-content-overflowing={isTitleOverflowing ? '' : undefined}
+ className={clsx(
+ isMultiline
+ ? styles.overflowingMultilineText
+ : styles.overflowingText,
+ className,
+ )}
+ render={render}
+ ref={mergedRef}
+ {...mergeProps<'div'>(
+ {
+ tabIndex: isFocusable ? 0 : undefined,
+ ...(areTooltipsDisabled
+ ? {}
+ : {
+ onPointerEnter: updateOverflowState,
+ onFocus: () => handleOpenChange(true),
+ }),
+ },
+ props,
+ )}
+ >
+ {text}
+ </Text>
+ );
+
+ if (areTooltipsDisabled) {
+ return textElement;
+ }
+
return (
<Tooltip.Root
open={isTooltipOpen && isDefined(tooltipText)}
@@ -90,39 +125,16 @@ export const OverflowingTextWithTooltip = memo(
handleOpenChange(open);
}}
disabled={
- !isDefined(tooltipText) || (!isTitleOverflowing && !alwaysShowTooltip)
+ !isDefined(tooltipText) ||
+ (tooltipMode === 'measure-on-hover' &&
+ !isTitleOverflowing &&
+ !alwaysShowTooltip)
}
>
<Tooltip.Trigger
delay={tooltipDelay}
closeOnClick={false}
- render={
- <Text
- {...(isMultiline
- ? { lineClamp }
- : { truncate: truncate ?? true })}
- dir="auto"
- data-content-overflowing={isTitleOverflowing ? '' : undefined}
- className={clsx(
- isMultiline
- ? styles.overflowingMultilineText
- : styles.overflowingText,
- className,
- )}
- render={render}
- ref={mergedRef}
- {...mergeProps<'div'>(
- {
- tabIndex: isFocusable ? 0 : undefined,
- onPointerEnter: updateOverflowState,
- onFocus: () => handleOpenChange(true),
- },
- props,
- )}
- >
- {text}
- </Text>
- }
+ render={textElement}
/>
<Tooltip.Portal>
<Tooltip.Positioner
diff --git a/packages/twenty-ui/src/primitives/typography/OverflowingTextWithTooltip/__tests__/OverflowingTextWithTooltip.test.tsx b/packages/twenty-ui/src/primitives/typography/OverflowingTextWithTooltip/__tests__/OverflowingTextWithTooltip.test.tsx
index 0dcdae6ad59..9a7a2dc9405 100644
--- a/packages/twenty-ui/src/primitives/typography/OverflowingTextWithTooltip/__tests__/OverflowingTextWithTooltip.test.tsx
+++ b/packages/twenty-ui/src/primitives/typography/OverflowingTextWithTooltip/__tests__/OverflowingTextWithTooltip.test.tsx
@@ -1,4 +1,4 @@
-import { render, screen, waitFor } from '@testing-library/react';
+import { fireEvent, render, screen, waitFor } from '@testing-library/react';
import userEvent from '@testing-library/user-event';
import { describe, expect, it, vi } from 'vitest';
import { createRef } from 'react';
@@ -7,6 +7,7 @@ import styles from '../OverflowingTextWithTooltip.module.scss';
import { Tooltip } from '@ui/primitives/surfaces/Tooltip/Tooltip';
+import { OverflowingTextTooltipModeProvider } from '../OverflowingTextTooltipModeProvider';
import { OverflowingTextWithTooltip } from '../OverflowingTextWithTooltip';
const setTextDimensions = ({
@@ -287,4 +288,87 @@ describe('OverflowingTextWithTooltip', () => {
);
expect(screen.getByText('הטמעת CRM לאקמה')).toHaveAttribute('dir', 'auto');
});
+
+ it('renders only the text when the tooltip mode is disabled', async () => {
+ const user = userEvent.setup();
+ const ref = createRef<HTMLDivElement>();
+ render(
+ <OverflowingTextTooltipModeProvider mode="disabled">
+ <OverflowingTextWithTooltip
+ text="Truncated label"
+ ref={ref}
+ alwaysShowTooltip
+ isFocusable
+ tooltipDelay={0}
+ />
+ </OverflowingTextTooltipModeProvider>,
+ );
+
+ const text = screen.getByText('Truncated label');
+ expect(ref.current).toBe(text);
+
+ await user.hover(text);
+ await user.tab();
+
+ expect(text).toHaveFocus();
+ expect(screen.queryByRole('tooltip')).not.toBeInTheDocument();
+ });
+
+ it('opens for a truncated label entered without a pointerenter when measured on open', async () => {
+ render(
+ <OverflowingTextTooltipModeProvider mode="measure-on-open">
+ <OverflowingTextWithTooltip text="Truncated label" tooltipDelay={0} />
+ </OverflowingTextTooltipModeProvider>,
+ );
+
+ const text = screen.getByText('Truncated label');
+ setTextDimensions({ element: text, clientWidth: 80, scrollWidth: 160 });
+
+ fireEvent.mouseEnter(text);
+ fireEvent.mouseMove(text);
+
+ expect(await screen.findByRole('tooltip')).toHaveTextContent(
+ 'Truncated label',
+ );
+ });
+
+ it('stays closed for a label that fits when measured on open', async () => {
+ const user = userEvent.setup();
+ render(
+ <OverflowingTextTooltipModeProvider mode="measure-on-open">
+ <OverflowingTextWithTooltip text="Short label" tooltipDelay={0} />
+ </OverflowingTextTooltipModeProvider>,
+ );
+
+ await user.hover(screen.getByText('Short label'));
+
+ expect(screen.queryByRole('tooltip')).not.toBeInTheDocument();
+ });
+
+ it('measures a label that becomes truncated after mount when opening', async () => {
+ const user = userEvent.setup();
+ const { rerender } = render(
+ <OverflowingTextTooltipModeProvider mode="measure-on-open">
+ <OverflowingTextWithTooltip text="Label" tooltipDelay={0} />
+ </OverflowingTextTooltipModeProvider>,
+ );
+
+ rerender(
+ <OverflowingTextTooltipModeProvider mode="measure-on-open">
+ <OverflowingTextWithTooltip
+ text="A much longer label"
+ tooltipDelay={0}
+ />
+ </OverflowingTextTooltipModeProvider>,
+ );
+
+ const text = screen.getByText('A much longer label');
+ setTextDimensions({ element: text, clientWidth: 80, scrollWidth: 160 });
+
+ await user.hover(text);
+
+ expect(await screen.findByRole('tooltip')).toHaveTextContent(
+ 'A much longer label',
+ );
+ });
});
diff --git a/packages/twenty-ui/src/primitives/typography/OverflowingTextWithTooltip/internal/OverflowingTextTooltipModeContext.ts b/packages/twenty-ui/src/primitives/typography/OverflowingTextWithTooltip/internal/OverflowingTextTooltipModeContext.ts
new file mode 100644
index 00000000000..28094345aa2
--- /dev/null
+++ b/packages/twenty-ui/src/primitives/typography/OverflowingTextWithTooltip/internal/OverflowingTextTooltipModeContext.ts
@@ -0,0 +1,6 @@
+import { createContext } from 'react';
+
+import { type OverflowingTextTooltipMode } from '../types/OverflowingTextTooltipMode';
+
+export const OverflowingTextTooltipModeContext =
+ createContext<OverflowingTextTooltipMode>('measure-on-hover');
diff --git a/packages/twenty-ui/src/primitives/typography/OverflowingTextWithTooltip/internal/isElementOverflowing.ts b/packages/twenty-ui/src/primitives/typography/OverflowingTextWithTooltip/internal/isElementOverflowing.ts
new file mode 100644
index 00000000000..cd0cc04fba1
--- /dev/null
+++ b/packages/twenty-ui/src/primitives/typography/OverflowingTextWithTooltip/internal/isElementOverflowing.ts
@@ -0,0 +1,6 @@
+import { isDefined } from '@ui/utilities/utils/isDefined';
+
+export const isElementOverflowing = (element: HTMLElement | null) =>
+ isDefined(element) &&
+ (element.scrollHeight > element.clientHeight ||
+ element.scrollWidth > element.clientWidth);
diff --git a/packages/twenty-ui/src/primitives/typography/OverflowingTextWithTooltip/types/OverflowingTextTooltipMode.ts b/packages/twenty-ui/src/primitives/typography/OverflowingTextWithTooltip/types/OverflowingTextTooltipMode.ts
new file mode 100644
index 00000000000..ca850bbd88b
--- /dev/null
+++ b/packages/twenty-ui/src/primitives/typography/OverflowingTextWithTooltip/types/OverflowingTextTooltipMode.ts
@@ -0,0 +1,4 @@
+export type OverflowingTextTooltipMode =
+ | 'measure-on-hover'
+ | 'measure-on-open'
+ | 'disabled';
diff --git a/packages/twenty-ui/src/primitives/typography/index.ts b/packages/twenty-ui/src/primitives/typography/index.ts
index 5951202c013..d07e35dc46d 100644
--- a/packages/twenty-ui/src/primitives/typography/index.ts
+++ b/packages/twenty-ui/src/primitives/typography/index.ts
@@ -9,7 +9,9 @@
export { Heading } from './Heading/Heading';
export type { HeadingProps } from './Heading/types/HeadingProps';
+export { OverflowingTextTooltipModeProvider } from './OverflowingTextWithTooltip/OverflowingTextTooltipModeProvider';
export { OverflowingTextWithTooltip } from './OverflowingTextWithTooltip/OverflowingTextWithTooltip';
+export type { OverflowingTextTooltipMode } from './OverflowingTextWithTooltip/types/OverflowingTextTooltipMode';
export type { OverflowingTextWithTooltipProps } from './OverflowingTextWithTooltip/types/OverflowingTextWithTooltipProps';
export { formatShortcut } from './Shortcut/formatShortcut';
export { Shortcut } from './Shortcut/Shortcut';