simple-table-core 3.9.2 → 3.9.3

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/headerWidthUtils.d.ts

@@ -71,35 +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;
+    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;
-}) => number;
+    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/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

@@ -350,6 +350,22 @@ export declare const HorizontalScrollbarShowsWhenHeaderOverflowsEmptyState: {
         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;