simple-table-core 3.9.1 → 3.9.3

package/dist/cjs/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/cjs/src/core/rendering/SectionRenderer.d.ts

@@ -107,5 +107,13 @@ export declare class SectionRenderer {
      * currently knows about.
      */
     private captureSnapshotConfig;
+    /**
+     * Tear down all body sections and forget them so a subsequent
+     * `renderBodySection` creates fresh nodes. Used when the empty-state path
+     * takes over the body container: clearing `innerHTML` alone leaves
+     * `renderedCells` pointing at detached nodes, so rows never remount when
+     * data returns (e.g. typing `-E` mid-filter briefly matches every row).
+     */
+    releaseBodySections(): void;
     cleanup(): void;
 }

package/dist/cjs/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/cjs/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/cjs/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/cjs/src/utils/headerWidthUtils.d.ts

@@ -71,29 +71,41 @@ export declare const getAllVisibleLeafHeaders: (headers: HeaderObject[], collaps
  * @returns The optimal width in pixels
  */
 export declare const calculateHeaderContentWidth: (accessor: Accessor, options?: {
-    rows?: any[];
-    header?: HeaderObject;
-    maxWidth?: number;
+    rows?: any[] | undefined;
+    header?: HeaderObject | undefined;
+    maxWidth?: number | undefined;
     /** Leading rows always measured (default AUTO_SIZE_HEAD_SAMPLE_SIZE) */
-    headSampleSize?: number;
+    headSampleSize?: number | undefined;
     /** Rows sampled at an even stride across the rest (default AUTO_SIZE_STRIDED_SAMPLE_SIZE) */
-    stridedSampleSize?: number;
+    stridedSampleSize?: number | undefined;
     /** Back-compat: when set, used as the head sample size (strided defaults to 0) */
-    sampleSize?: number;
+    sampleSize?: number | undefined;
     /** Outlier clip percentile (default AUTO_SIZE_OUTLIER_PERCENTILE) */
-    outlierPercentile?: number;
+    outlierPercentile?: number | undefined;
     /** Outlier clip threshold fraction (default AUTO_SIZE_OUTLIER_THRESHOLD) */
-    outlierThreshold?: number;
+    outlierThreshold?: number | undefined;
     /** When "header", ignore cell content and fit the header label only */
-    autoSizeMode?: "content" | "header";
+    autoSizeMode?: "content" | "header" | undefined;
     /** Theme passed to a custom cellRenderer during measurement */
     theme?: any;
     /** Scope `.st-cell-content` font/padding sampling to this table instance */
-    styleRoot?: ParentNode | null;
+    styleRoot?: ParentNode | null | undefined;
     /**
      * The table's resolved sort icon. Used to reserve space on sortable columns
      * that are not currently sorted (the icon only exists on the active sort
      * column), so sorting later does not push the label into ellipsis.
      */
-    sortIcon?: string | HTMLElement | SVGSVGElement;
-}) => number;
+    sortIcon?: string | HTMLElement | SVGSVGElement | undefined;
+    /**
+     * 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 | undefined;
+    /**
+     * Called before a temporary measure host from `cellRenderer` is discarded.
+     * Framework adapters (React portals, Vue/Solid mounts) register on render;
+     * without this, autofit sampling leaks those registrations.
+     */
+    onRendererHostDiscard?: ((host: HTMLElement) => void) | undefined;
+} | undefined) => number;

package/dist/cjs/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/cjs/stories/docs/Examples.stories.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Docs & Examples / Examples – product-style demos (domain datasets).
+ * Stories are listed alphabetically.
+ */
+import type { Meta, StoryObj } from "@storybook/html";
+declare const meta: Meta;
+export default meta;
+export declare const Billing: StoryObj;
+export declare const Clay: StoryObj;
+export declare const Finance: StoryObj;
+export declare const Infrastructure: StoryObj;
+export declare const Leads: StoryObj;
+export declare const Manufacturing: StoryObj;
+export declare const Music: StoryObj;
+export declare const MusicWindowScroll: StoryObj;
+export declare const RadioStations: StoryObj;
+export declare const Sales: StoryObj;

package/dist/cjs/stories/{SimpleTable.stories.d.ts → docs/Features.stories.d.ts}

@@ -1,23 +1,19 @@
 /**
- * Docs & Examples – vanilla ports of React Storybook examples.
- * Each story uses SimpleTableVanilla; example logic lives in stories/examples/.
+ * Docs & Examples / Features – capability demos, listed alphabetically.
  */
 import type { Meta, StoryObj } from "@storybook/html";
 declare const meta: Meta;
 export default meta;
 export declare const AdvancedSorting: StoryObj;
-export declare const AggregateExample: StoryObj;
+export declare const Aggregate: StoryObj;
 export declare const Alignment: StoryObj;
 export declare const AutoExpandColumns: StoryObj;
-export declare const BasicExample: StoryObj;
 export declare const BasicRowGrouping: StoryObj;
-export declare const BillingExample: StoryObj;
 export declare const CSVExportFormatting: StoryObj;
 export declare const CSVExportSingleRowChildren: StoryObj;
 export declare const CellHighlighting: StoryObj;
 export declare const CellRenderer: StoryObj;
 export declare const Charts: StoryObj;
-export declare const ClayExample: StoryObj;
 export declare const ClipboardFormatting: StoryObj;
 export declare const CollapsibleColumns: StoryObj;
 export declare const ColumnVisibilityAPI: StoryObj;
@@ -32,21 +28,14 @@ export declare const EditableCells: StoryObj;
 export declare const ExpansionControl: StoryObj;
 export declare const ExternalFilter: StoryObj;
 export declare const ExternalSort: StoryObj;
-export declare const FilterExample: StoryObj;
-export declare const FinanceExample: StoryObj;
+export declare const Filter: StoryObj;
 export declare const HeaderInclusion: StoryObj;
 export declare const HiddenColumns: StoryObj;
 export declare const InfiniteScroll: StoryObj;
-export declare const WindowInfiniteScroll: StoryObj;
-export declare const InfrastructureExample: StoryObj;
-export declare const LeadsExample: StoryObj;
 export declare const LiveUpdates: StoryObj;
 export declare const LoadingState: StoryObj;
-export declare const ManufacturingExample: StoryObj;
-export declare const MusicExample: StoryObj;
-export declare const MusicWindowScroll: StoryObj;
-export declare const NestedGrid: StoryObj;
 export declare const NestedAccessor: StoryObj;
+export declare const NestedGrid: StoryObj;
 export declare const Pagination: StoryObj;
 export declare const PaginationAPI: StoryObj;
 export declare const PinnedColumns: StoryObj;
@@ -57,8 +46,8 @@ export declare const RowButtons: StoryObj;
 export declare const RowGrouping: StoryObj;
 export declare const RowHeight: StoryObj;
 export declare const RowSelection: StoryObj;
-export declare const SalesExample: StoryObj;
 export declare const SelectableCells: StoryObj;
 export declare const ServerSidePagination: StoryObj;
 export declare const Theming: StoryObj;
 export declare const Tooltip: StoryObj;
+export declare const WindowInfiniteScroll: StoryObj;

package/dist/cjs/stories/docs/GettingStarted.stories.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Docs & Examples / Getting Started
+ */
+import type { Meta, StoryObj } from "@storybook/html";
+declare const meta: Meta;
+export default meta;
+export declare const BasicExample: StoryObj;

package/dist/cjs/stories/docs/storyArgs.d.ts

@@ -0,0 +1,154 @@
+/**
+ * Shared Storybook args helper for Docs & Examples stories.
+ */
+import { type UniversalVanillaArgs } from "../vanillaStoryConfig";
+export declare const storyArgs: (exampleDefaults?: Partial<UniversalVanillaArgs>) => {
+    args: {
+        autoExpandColumns?: boolean | undefined;
+        cellUpdateFlash?: boolean | undefined;
+        columnReordering?: boolean | undefined;
+        columnResizing?: boolean | undefined;
+        customTheme?: import("../../src").CustomThemeProps | undefined;
+        editColumns?: boolean | undefined;
+        editColumnsInitOpen?: boolean | undefined;
+        expandAll?: boolean | undefined;
+        externalFilterHandling?: boolean | undefined;
+        externalSortHandling?: boolean | undefined;
+        height?: string | undefined;
+        hideFooter?: boolean | undefined;
+        rowsPerPage?: number | undefined;
+        selectableCells?: boolean | undefined;
+        selectableColumns?: boolean | undefined;
+        shouldPaginate?: boolean | undefined;
+        theme?: import("../../src/types/Theme").default | undefined;
+        useHoverRowBackground?: boolean | undefined;
+        useOddColumnBackground?: boolean | undefined;
+        useOddEvenRowBackground?: boolean | undefined;
+    };
+    argTypes: {
+        theme: {
+            control: {
+                type: "select";
+            };
+            options: string[];
+            description: string;
+        };
+        useOddColumnBackground: {
+            control: {
+                type: "boolean";
+            };
+            description: string;
+        };
+        useHoverRowBackground: {
+            control: {
+                type: "boolean";
+            };
+            description: string;
+        };
+        useOddEvenRowBackground: {
+            control: {
+                type: "boolean";
+            };
+            description: string;
+        };
+        cellUpdateFlash: {
+            control: {
+                type: "boolean";
+            };
+            description: string;
+        };
+        height: {
+            control: {
+                type: "text";
+            };
+            description: string;
+        };
+        customTheme: {
+            control: {
+                type: "object";
+            };
+            description: string;
+        };
+        autoExpandColumns: {
+            control: {
+                type: "boolean";
+            };
+            description: string;
+        };
+        expandAll: {
+            control: {
+                type: "boolean";
+            };
+            description: string;
+        };
+        columnReordering: {
+            control: {
+                type: "boolean";
+            };
+            description: string;
+        };
+        columnResizing: {
+            control: {
+                type: "boolean";
+            };
+            description: string;
+        };
+        editColumns: {
+            control: {
+                type: "boolean";
+            };
+            description: string;
+        };
+        editColumnsInitOpen: {
+            control: {
+                type: "boolean";
+            };
+            description: string;
+        };
+        selectableCells: {
+            control: {
+                type: "boolean";
+            };
+            description: string;
+        };
+        selectableColumns: {
+            control: {
+                type: "boolean";
+            };
+            description: string;
+        };
+        shouldPaginate: {
+            control: {
+                type: "boolean";
+            };
+            description: string;
+        };
+        hideFooter: {
+            control: {
+                type: "boolean";
+            };
+            description: string;
+        };
+        externalSortHandling: {
+            control: {
+                type: "boolean";
+            };
+            description: string;
+        };
+        externalFilterHandling: {
+            control: {
+                type: "boolean";
+            };
+            description: string;
+        };
+        rowsPerPage: {
+            control: {
+                type: "number";
+                min: number;
+                max: number;
+                step: number;
+            };
+            description: string;
+        };
+    };
+};

package/dist/cjs/stories/examples/RadioStationsExample.d.ts

@@ -0,0 +1,3 @@
+import { type UniversalVanillaArgs } from "../vanillaStoryConfig";
+export declare const radioStationsExampleDefaults: Partial<UniversalVanillaArgs>;
+export declare function renderRadioStationsExample(args?: Partial<UniversalVanillaArgs>): HTMLElement;

package/dist/cjs/stories/tests/18-QuickFilterTests.stories.d.ts

@@ -76,6 +76,25 @@ export declare const SmartModeQuotedPhrase: {
     }) => Promise<void>;
 };
 export declare const SmartModeNegation: {
+    parameters: {
+        tags: string[];
+    };
+    render: () => HTMLDivElement & {
+        _table?: import("../../src/index").SimpleTableVanilla | undefined;
+    };
+    play: ({ canvasElement }: {
+        canvasElement: HTMLElement;
+    }) => Promise<void>;
+};
+/**
+ * Filtering through a brief empty state (0 matching rows) and back must remount
+ * body cells. Regression for empty-state scrollport takeover that left
+ * SectionRenderer holding detached body sections.
+ */
+export declare const QuickFilterRecoversAfterEmptyState: {
+    parameters: {
+        tags: string[];
+    };
     render: () => HTMLDivElement & {
         _table?: import("../../src/index").SimpleTableVanilla | undefined;
     };

package/dist/cjs/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,53 @@ 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>;
+};
+/**
+ * Empty tables still need a real body scrollport: wheel/trackpad over the
+ * "No rows to display" area (and the horizontal scrollbar) must scroll the
+ * headers. Replacing the body with a non-scrolling empty wrapper breaks that.
+ */
+export declare const EmptyStateBodyScrollSyncsWithHeader: {
+    parameters: {
+        tags: string[];
+    };
+    render: () => HTMLDivElement & {
+        _table?: SimpleTableVanilla | undefined;
+    };
+    play: ({ canvasElement }: {
+        canvasElement: HTMLElement;
+    }) => Promise<void>;
+};
 export declare const SamplingAndOutlierHelpers: {
     parameters: {
         tags: string[];

package/dist/cjs/stories/utils.d.ts

@@ -2,9 +2,22 @@
  * Shared helpers for vanilla stories (examples and tests).
  */
 import { SimpleTableVanilla } from "../src/index";
-import type { HeaderObject, Row } from "../src/index";
+import type { HeaderObject, Row, SimpleTableConfig } from "../src/index";
 /** Instance type of the table (class is a value; use InstanceType<typeof C> for the type of instances). */
 type TableInstance = InstanceType<typeof SimpleTableVanilla>;
+/**
+ * Config passed through to {@link SimpleTableVanilla}, minus `defaultHeaders` /
+ * `rows` which are supplied as the first two arguments of
+ * {@link renderVanillaTable}.
+ *
+ * Keys are constrained to {@link SimpleTableConfig} so typos and misplaced
+ * props (e.g. top-level `rowHeight` instead of `customTheme.rowHeight`) fail
+ * at compile time. Values stay loose (`unknown`) so story callbacks that are
+ * slightly narrower than the public types still typecheck.
+ */
+export type RenderVanillaTableOptions = {
+    [K in keyof Omit<SimpleTableConfig, "defaultHeaders" | "rows">]?: unknown;
+};
 export interface RenderVanillaTableResult {
     wrapper: HTMLDivElement & {
         _table?: TableInstance;
@@ -13,7 +26,7 @@ export interface RenderVanillaTableResult {
     tableContainer: HTMLDivElement;
     table: TableInstance;
 }
-export declare function renderVanillaTable(headers: HeaderObject[], data: Row[], options?: Record<string, unknown>): RenderVanillaTableResult;
+export declare function renderVanillaTable(headers: HeaderObject[], data: Row[], options?: RenderVanillaTableOptions): RenderVanillaTableResult;
 export declare function addParagraph(wrapper: HTMLElement, text: string, beforeElement?: Element | null): HTMLParagraphElement;
 export interface ControlPanelSection {
     heading: string;