simple-table-core 3.9.0 → 3.9.2

package/dist/src/consts/general-consts.d.ts

@@ -19,3 +19,5 @@ export declare const AUTO_SIZE_OUTLIER_PERCENTILE = 95;
 export declare const AUTO_SIZE_OUTLIER_THRESHOLD = 0.5;
 export declare const AUTO_SIZE_MIN_SAMPLE_FOR_CLIP = 20;
 export declare const AUTO_SIZE_WIDTH_BUFFER = 2;
+/** Extra padding reserved around header icons (sort / collapse) during auto-size. */
+export declare const AUTO_SIZE_HEADER_ICON_PADDING = 4;

package/dist/src/managers/DimensionManager.d.ts

@@ -21,12 +21,20 @@ export interface DimensionManagerState {
     contentHeight: number | undefined;
 }
 type StateChangeCallback = (state: DimensionManagerState) => void;
+/**
+ * Wait this long after the last container-width ResizeObserver tick before
+ * notifying subscribers. Coalesces CSS-transition / animated layout shifts
+ * (e.g. a collapsible nav) into a single trailing update instead of one full
+ * table render per animation frame.
+ */
+export declare const CONTAINER_RESIZE_NOTIFY_DEBOUNCE_MS = 50;
 export declare class DimensionManager {
     private config;
     private state;
     private subscribers;
     private resizeObserver;
     private rafId;
+    private resizeNotifyDebounceId;
     /** Set when applyContainerWidthSync updates state before any subscriber exists. */
     private initialNotifyPending;
     constructor(config: DimensionManagerConfig);
@@ -35,6 +43,9 @@ export declare class DimensionManager {
     private calculateHeaderHeight;
     private convertHeightToPixels;
     private calculateContentHeight;
+    private cancelPendingResizeNotify;
+    /** Trailing debounce for animated / continuous container resizes. */
+    private scheduleResizeNotify;
     private observeContainer;
     private applyContainerWidthSync;
     updateConfig(config: Partial<DimensionManagerConfig>): void;

package/dist/src/types/AnimationsConfig.d.ts

@@ -3,6 +3,8 @@
  *
  * The animation coordinator runs FLIP-style transitions when cells move between
  * positions. All fields are optional; omit the prop entirely to use defaults.
+ *
+ * Row group expand/collapse never animates when `rowGrouping` is configured.
  */
 export interface AnimationsConfig {
     /** Master toggle. Defaults to `true`. When `false`, no other field has effect. */

package/dist/src/utils/bodyCell/styling.d.ts

@@ -2,6 +2,8 @@ import { AbsoluteBodyCell, CellRegistryEntry, CellRenderContext } from "./types"
 import { CellLiveRef, cellLiveRefMap } from "./cellLiveRef";
 export { cellLiveRefMap };
 export type { CellLiveRef };
+/** Drop the content memo so the next `updateBodyCellElement` rebuilds. */
+export declare const invalidateBodyCellContentMemo: (cellElement: HTMLElement) => void;
 export declare const untrackCellByRow: (rowId: string, cellElement: HTMLElement) => void;
 export declare const unregisterCellFromRegistry: (cellElement: HTMLElement, cellRegistry?: Map<string, CellRegistryEntry>) => void;
 export declare const createBodyCellElement: (cell: AbsoluteBodyCell, context: CellRenderContext) => HTMLElement;

package/dist/src/utils/headerCell/eventTracking.d.ts

@@ -25,4 +25,4 @@ export declare const addTrackedEventListener: (element: HTMLElement, event: stri
 /** Header tooltips are portaled under .simple-table-root; remove them when header DOM is torn down
  *  without pointer leave (e.g. sort/filter invalidates context cache and removes header cells). */
 export declare const removeFloatingHeaderTooltips: (fromElement: HTMLElement) => void;
-export declare const cleanupHeaderCellRendering: (container?: HTMLElement) => void;
+export declare const cleanupHeaderCellRendering: (container?: HTMLElement, onHostDiscard?: ((host: HTMLElement) => void) | undefined) => void;

package/dist/src/utils/headerCell/types.d.ts

@@ -96,5 +96,11 @@ export interface HeaderRenderContext {
      * driving the unfold animation.
      */
     animationCoordinator?: AnimationCoordinator;
+    /**
+     * Called immediately before a header host (or its label content) is permanently
+     * discarded so adapters can tear down renderer subtrees (e.g. React portals).
+     * Mirrors {@link CellRenderContext.onRendererHostDiscard}.
+     */
+    onRendererHostDiscard?: (host: HTMLElement) => void;
 }
 export {};

package/dist/src/utils/headerWidthUtils.d.ts

@@ -96,4 +96,10 @@ export declare const calculateHeaderContentWidth: (accessor: Accessor, options?:
      * column), so sorting later does not push the label into ellipsis.
      */
     sortIcon?: string | HTMLElement | SVGSVGElement;
+    /**
+     * The table's resolved expand/collapse icon. Used to reserve space on
+     * collapsible headers when the header cell is virtualized out of the
+     * horizontal band (so the icon is not in the DOM to measure directly).
+     */
+    expandIcon?: string | HTMLElement | SVGSVGElement;
 }) => number;

package/dist/src/utils/horizontalScrollbarRenderer.d.ts

@@ -9,6 +9,13 @@ export interface HorizontalScrollbarProps {
     tableBodyContainerRef: HTMLDivElement;
     editColumns: boolean;
     sectionScrollController?: SectionScrollController | null;
+    /**
+     * When true, skip the DOM scrollWidth check and always build the scrollbar.
+     * Used after the caller has already verified content overflow (e.g. empty
+     * tables where the header scrollport is sized to content and reports no
+     * DOM overflow even though columns exceed the viewport).
+     */
+    forceScrollable?: boolean;
 }
 export declare const createHorizontalScrollbar: (props: HorizontalScrollbarProps) => HTMLElement | null;
 /**

package/dist/stories/tests/43-CollapseExpandAnimationsTests.stories.d.ts

@@ -34,7 +34,7 @@ export declare const ColumnExpand_IncomingCellsStartAtZeroWidth: {
         canvasElement: HTMLElement;
     }) => Promise<void>;
 };
-export declare const RowExpand_AddsAccordionClass: {
+export declare const RowExpand_NoAccordionClass: {
     tags: string[];
     render: () => HTMLDivElement & {
         _table?: import("../../src/index").SimpleTableVanilla | undefined;
@@ -43,7 +43,7 @@ export declare const RowExpand_AddsAccordionClass: {
         canvasElement: HTMLElement;
     }) => Promise<void>;
 };
-export declare const RowExpand_IncomingCellsStartAtZeroHeight: {
+export declare const RowExpand_NoAccordionGrow: {
     tags: string[];
     render: () => HTMLDivElement & {
         _table?: import("../../src/index").SimpleTableVanilla | undefined;

package/dist/stories/tests/46-AutoSizeColumnsTests.stories.d.ts

@@ -4,7 +4,7 @@
  * Comprehensive coverage for content-fit columns (`width: "auto"`):
  * - shrink / grow, per-column `maxWidth` cap and `minWidth` floor
  * - `autoSizeMode: "header"`
- * - custom (vanilla) renderers, valueFormatter, valueGetter, chart columns
+ * - custom (vanilla) renderers, valueFormatter (incl. multi-line), valueGetter, chart columns
  * - outliers (single giant value clipped) vs. a legitimate wide minority (kept)
  * - very large datasets (50k rows) with bounded sampling
  * - re-fit on data change, sort stability, empty data, mixed/pinned layouts
@@ -117,6 +117,23 @@ export declare const AutoSizeMeasuresFormattedValue: {
         canvasElement: HTMLElement;
     }) => Promise<void>;
 };
+/**
+ * valueFormatter may return explicit multi-line text (e.g. an address). When the
+ * cell is allowed to wrap (`white-space: pre-line`), auto-size must fit the
+ * longest line — not the full string measured as one nowrap run (newlines
+ * collapse to spaces under `white-space: nowrap` measurement).
+ */
+export declare const AutoSizeMultilineFormattedValueUsesLongestLine: {
+    parameters: {
+        tags: string[];
+    };
+    render: () => HTMLDivElement & {
+        _table?: SimpleTableVanilla | undefined;
+    };
+    play: ({ canvasElement }: {
+        canvasElement: HTMLElement;
+    }) => Promise<void>;
+};
 export declare const AutoSizeMeasuresValueGetter: {
     parameters: {
         tags: string[];
@@ -302,6 +319,37 @@ export declare const AutoSizeEmptyStateAsyncHeaderRenderer: {
         canvasElement: HTMLElement;
     }) => Promise<void>;
 };
+export declare const AutoSizeCollapsibleHeaderReservesIconWidth: {
+    parameters: {
+        tags: string[];
+    };
+    render: () => HTMLDivElement & {
+        _table?: SimpleTableVanilla | undefined;
+    };
+    play: ({ canvasElement }: {
+        canvasElement: HTMLElement;
+    }) => Promise<void>;
+};
+export declare const AutoSizeLongHeaderConsistentAcrossContainerWidths: {
+    parameters: {
+        tags: string[];
+    };
+    render: () => HTMLDivElement;
+    play: ({ canvasElement }: {
+        canvasElement: HTMLElement;
+    }) => Promise<void>;
+};
+export declare const HorizontalScrollbarShowsWhenHeaderOverflowsEmptyState: {
+    parameters: {
+        tags: string[];
+    };
+    render: () => HTMLDivElement & {
+        _table?: SimpleTableVanilla | undefined;
+    };
+    play: ({ canvasElement }: {
+        canvasElement: HTMLElement;
+    }) => Promise<void>;
+};
 export declare const SamplingAndOutlierHelpers: {
     parameters: {
         tags: string[];

package/dist/stories/tests/50-ContainerResizePerformanceTests.stories.d.ts

@@ -0,0 +1,56 @@
+/**
+ * CONTAINER RESIZE PERFORMANCE REPRO
+ *
+ * Simulates a collapsible global left nav that animates width and squeezes the
+ * main content area — the layout pattern reported on Artist/Platform pages.
+ *
+ * During the CSS transition, the table container's ResizeObserver fires on
+ * successive frames. DimensionManager coalesces those ticks (trailing debounce)
+ * so subscribers / full renders fire once after the transition settles.
+ *
+ * Use the HUD while toggling the nav, or run the automated play test.
+ * The play test asserts coalesced table relayouts (header width updates), not
+ * raw container ResizeObserver ticks — the DOM still resizes every animation frame.
+ */
+import type { Meta } from "@storybook/html";
+declare const meta: Meta;
+export default meta;
+interface ContainerResizePerfSnapshot {
+    contentWidthChanges: number;
+    tableContainerWidthChanges: number;
+    /** Batched header relayout passes (one per table render), not per-cell updates. */
+    tableRelayouts: number;
+    lastContentWidth: number;
+}
+declare global {
+    interface Window {
+        __containerResizePerf?: ContainerResizePerfSnapshot;
+    }
+}
+export declare const resetContainerResizePerf: (lastContentWidth?: number) => void;
+export declare const CollapsibleNavWithTable: {
+    tags: string[];
+    render: () => HTMLDivElement;
+};
+export declare const CollapsibleNavTableNoAutoExpand: {
+    tags: string[];
+    render: () => HTMLDivElement;
+};
+export declare const CollapsibleNavBaseline: {
+    tags: string[];
+    render: () => HTMLDivElement;
+};
+export declare const NavToggleCoalescesTableRelayout: {
+    tags: string[];
+    render: () => HTMLDivElement;
+    play: ({ canvasElement }: {
+        canvasElement: HTMLElement;
+    }) => Promise<void>;
+};
+export declare const BaselineNavHasNoTableGridChurn: {
+    tags: string[];
+    render: () => HTMLDivElement;
+    play: ({ canvasElement }: {
+        canvasElement: HTMLElement;
+    }) => Promise<void>;
+};

package/dist/stories/tests/51-RowGroupReExpandTests.stories.d.ts

@@ -0,0 +1,78 @@
+/**
+ * ROW GROUP RE-EXPAND REGRESSION TESTS
+ *
+ * Reproduces bugs when a lazy-loaded grouped row is collapsed and re-expanded:
+ *
+ *   1. onRowGroupExpand receives a stale `row` snapshot (missing cached children),
+ *      so consumer guards like `if (row[groupingKey]?.length) return` fail and
+ *      every re-expand re-triggers setLoading + fetch.
+ *
+ *   2. Re-expand must not re-enter loading state or spuriously animate sibling
+ *      rows below the expanded group.
+ *
+ * Mirrors packages/react/src/__tests__/onRowGroupExpandReExpand.test.tsx.
+ * All play tests should FAIL until the stale-row fix lands.
+ */
+import type { Meta } from "@storybook/html";
+declare const meta: Meta;
+export default meta;
+interface ReExpandProbe {
+    expandSnapshots: Array<{
+        childCount: number;
+        isExpanded: boolean;
+    }>;
+    fetchCount: number;
+    loadingTrueCount: number;
+}
+declare global {
+    interface Window {
+        __rowGroupReExpandProbe?: ReExpandProbe;
+    }
+}
+export declare const ReExpand_PassesCachedRowSnapshot: {
+    tags: string[];
+    render: () => HTMLDivElement;
+    play: ({ canvasElement }: {
+        canvasElement: HTMLElement;
+    }) => Promise<void>;
+};
+export declare const ReExpand_SkipsRefetch: {
+    tags: string[];
+    render: () => HTMLDivElement;
+    play: ({ canvasElement }: {
+        canvasElement: HTMLElement;
+    }) => Promise<void>;
+};
+export declare const ReExpand_SkipsSetLoading: {
+    tags: string[];
+    render: () => HTMLDivElement;
+    play: ({ canvasElement }: {
+        canvasElement: HTMLElement;
+    }) => Promise<void>;
+};
+/** Manual QA: status panel shows fetch/loading counts while toggling Engineering. */
+export declare const ReExpand_LazyLoad_StatusPanel: {
+    tags: string[];
+    render: () => HTMLDivElement;
+};
+export declare const ReExpand_NoLoadingSkeletonOnLazyReExpand: {
+    tags: string[];
+    render: () => HTMLDivElement;
+    play: ({ canvasElement }: {
+        canvasElement: HTMLElement;
+    }) => Promise<void>;
+};
+export declare const ReExpand_SiblingRowsNoAccordionGrow: {
+    tags: string[];
+    render: () => HTMLDivElement;
+    play: ({ canvasElement }: {
+        canvasElement: HTMLElement;
+    }) => Promise<void>;
+};
+export declare const ReExpand_NoAccordionGrowOnReExpand: {
+    tags: string[];
+    render: () => HTMLDivElement;
+    play: ({ canvasElement }: {
+        canvasElement: HTMLElement;
+    }) => Promise<void>;
+};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "simple-table-core",
-  "version": "3.9.0",
+  "version": "3.9.2",
   "main": "dist/cjs/index.js",
   "module": "dist/index.es.js",
   "types": "dist/src/index.d.ts",