@stackone/malachite 0.55.0 → 0.55.1

package/dist/index.d.ts

@@ -1758,13 +1758,22 @@ declare interface TooltipProps {
     fill?: boolean;
     /** Max width of tooltip. Default: 320px */
     maxWidth?: number | string;
+    /** Called synchronously when the trigger is hovered/focused; return false to
+     *  suppress the tooltip for this interaction. Lets wrappers defer expensive
+     *  checks (e.g. truncation measurement) to interaction time instead of mount. */
+    shouldShow?: () => boolean;
 }
 
 /**
  * TruncatedTooltip renders its children in a single-line truncating container
- * (overflow:hidden + text-overflow:ellipsis + white-space:nowrap). It measures
- * the rendered content via ResizeObserver and only surfaces the malachite
- * Tooltip when the content is actually being cut off.
+ * (overflow:hidden + text-overflow:ellipsis + white-space:nowrap) and surfaces
+ * the malachite Tooltip only when the content is actually being cut off.
+ *
+ * Truncation is checked at interaction time (Tooltip's `shouldShow`), not at
+ * mount: a mount-time measurement forces a synchronous layout per instance,
+ * and in large tables those reads interleave with other components' DOM writes
+ * — hundreds of full layout passes per mounted batch (the Safari row-mount
+ * stalls of ENG-1168). The ellipsis itself is pure CSS and needs no JS.
  */
 export declare const TruncatedTooltip: default_2.FC<TruncatedTooltipProps>;