@stackone/malachite 0.54.1 → 0.55.1

package/dist/index.d.ts

@@ -1480,7 +1480,7 @@ export declare interface TabItem {
     disabled?: boolean;
 }
 
-export declare const Table: <T = Record<string, unknown>>({ columns, data, loading, error, errorTitle, errorSubTitle, bordered, showHeader, rowKey, scrollHeight, size, layout, headerVariant, rowClassName, rowVariant, onRow, onClickRow, rowSelection, pagination, className, style, stickyHeaderTop, scrollX, rowSection, renderSectionDivider, }: TableProps<T>) => JSX_2.Element;
+export declare const Table: <T = Record<string, unknown>>({ columns, data, loading, error, errorTitle, errorSubTitle, bordered, showHeader, rowKey, scrollHeight, size, layout, headerVariant, rowClassName, rowVariant, onRow, onClickRow, rowSelection, pagination, className, style, stickyHeaderTop, scrollX, rowSection, renderSectionDivider, virtual, virtualRowHeightEstimate, virtualScrollElement, }: TableProps<T>) => JSX_2.Element;
 
 export declare type TableColumnDefinition<T = Record<string, unknown>> = {
     title: string | default_2.ReactNode;
@@ -1549,6 +1549,19 @@ declare type TableProps<T = Record<string, unknown>> = {
     scrollX?: boolean;
     rowSection?: (record: T) => string;
     renderSectionDivider?: (sectionKey: string, records: T[]) => default_2.ReactNode;
+    /** Windowed rendering for large datasets (detached variant only), powered by
+     *  TanStack Virtual: only rows near the viewport stay mounted; spacers keep the
+     *  scrollbar reflecting the full list. The table body becomes the scroll
+     *  container, so give it a bounded height via `scrollHeight`. Row heights are
+     *  measured per row (non-uniform rows are fine). */
+    virtual?: boolean;
+    /** Estimated row height (px) used by `virtual` before rows are measured. */
+    virtualRowHeightEstimate?: number;
+    /** With `virtual`: virtualize against this ancestor scroll container instead of
+     *  the table body (e.g. a page-level scroller so content above the table can
+     *  scroll away). Pass the element from state (not a ref) so it arrives after
+     *  mount. The table body stops scrolling when this is set. */
+    virtualScrollElement?: HTMLElement | null;
 };
 
 declare type TableRowActions<T = Record<string, unknown>> = {
@@ -1745,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>;