@stackone/malachite 0.55.0 → 0.56.0

package/dist/index.d.ts

@@ -456,10 +456,12 @@ export declare interface DropdownItem {
     id: string;
     label: string;
     icon?: default_2.ReactNode;
-    /** Alternate label shown in the trigger when selected (falls back to `label`). */
+    /** Alternate label shown in the closed trigger when selected (falls back to `label`). */
     triggerLabel?: string;
     /** Items sharing a `group` render under a section header, in first-seen order. */
     group?: string;
+    /** Descriptive blurb rendered after the label in the open menu only —
+     *  the closed trigger never shows it. */
     subtitle?: string;
     rightSideText?: string;
     rightSideTextVariant?: 'muted' | 'primary';
@@ -1484,6 +1486,8 @@ export declare const Table: <T = Record<string, unknown>>({ columns, data, loadi
 
 export declare type TableColumnDefinition<T = Record<string, unknown>> = {
     title: string | default_2.ReactNode;
+    /** Explanatory text shown in a tooltip behind an info icon next to the title. */
+    info?: string;
     dataIndex: keyof T | (string & {});
     key: string;
     width?: string | number;
@@ -1758,13 +1762,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>;