simple-table-core 3.9.2 → 3.9.6

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

@@ -0,0 +1,147 @@
+/**
+ * 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;
+        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;
+        };
+        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/stories/examples/AlignmentExample.d.ts

@@ -3,7 +3,6 @@ export declare const alignmentExampleDefaults: {
     columnResizing: boolean;
     columnReordering: boolean;
     selectableCells: boolean;
-    selectableColumns: boolean;
     editColumns: boolean;
     height: string;
 };

package/dist/stories/examples/CellHighlighting.d.ts

@@ -2,6 +2,5 @@ import { type UniversalVanillaArgs } from "../vanillaStoryConfig";
 export declare const cellHighlightingExampleDefaults: {
     height: string;
     selectableCells: boolean;
-    selectableColumns: boolean;
 };
 export declare function renderCellHighlightingExample(args?: Partial<UniversalVanillaArgs>): HTMLElement;

package/dist/stories/examples/Pagination.d.ts

@@ -5,7 +5,6 @@ export declare const paginationExampleDefaults: {
     columnReordering: boolean;
     columnResizing: boolean;
     selectableCells: boolean;
-    selectableColumns: boolean;
     theme: "modern-dark";
     height: string;
 };

package/dist/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/stories/examples/RowSelectionExample.d.ts

@@ -5,6 +5,7 @@ export declare const rowSelectionExampleDefaults: {
     selectableCells: boolean;
     columnReordering: boolean;
     enableRowSelection: boolean;
+    selectRowOnClick: boolean;
     height: string;
 };
 export declare function renderRowSelectionExample(args?: Partial<UniversalVanillaArgs>): HTMLElement;

package/dist/stories/examples/SelectableCells.d.ts

@@ -2,7 +2,6 @@ import { type UniversalVanillaArgs } from "../vanillaStoryConfig";
 export declare const selectableCellsExampleDefaults: {
     rowGrouping: readonly ["stores"];
     selectableCells: boolean;
-    selectableColumns: boolean;
     columnResizing: boolean;
     columnReordering: boolean;
     height: string;

package/dist/stories/examples/Theming.d.ts

@@ -4,7 +4,6 @@ export declare const themingExampleDefaults: {
     columnReordering: boolean;
     editColumns: boolean;
     selectableCells: boolean;
-    selectableColumns: boolean;
     shouldPaginate: boolean;
     rowsPerPage: number;
     height: string;

package/dist/stories/examples/pinned-columns/PinnedColumns.d.ts

@@ -4,7 +4,6 @@ export declare const pinnedColumnsExampleDefaults: {
     rowGrouping: readonly ["stores"];
     columnReordering: boolean;
     selectableCells: boolean;
-    selectableColumns: boolean;
     editColumns: boolean;
     height: string;
     enableStickyParents: boolean;

package/dist/stories/tests/07-RowSelectionTests.stories.d.ts

@@ -67,3 +67,35 @@ export declare const SelectionPersistsThroughFilter: {
         canvasElement: HTMLElement;
     }) => Promise<void>;
 };
+export declare const SingleSelectionMode: {
+    render: () => HTMLDivElement & {
+        _table?: SimpleTableVanilla | undefined;
+    };
+    play: ({ canvasElement }: {
+        canvasElement: HTMLElement;
+    }) => Promise<void>;
+};
+export declare const ClickToSelectWithoutCheckboxColumn: {
+    render: () => HTMLDivElement & {
+        _table?: SimpleTableVanilla | undefined;
+    };
+    play: ({ canvasElement }: {
+        canvasElement: HTMLElement;
+    }) => Promise<void>;
+};
+export declare const KeyboardRowSelection: {
+    render: () => HTMLDivElement & {
+        _table?: SimpleTableVanilla | undefined;
+    };
+    play: ({ canvasElement }: {
+        canvasElement: HTMLElement;
+    }) => Promise<void>;
+};
+export declare const TableAPIRowSelection: {
+    render: () => HTMLDivElement & {
+        _table?: SimpleTableVanilla | undefined;
+    };
+    play: ({ canvasElement }: {
+        canvasElement: HTMLElement;
+    }) => Promise<void>;
+};

package/dist/stories/tests/12-CellSelectionTests.stories.d.ts

@@ -74,7 +74,7 @@ export declare const OutsideClickClearsSelection: {
     }) => Promise<void>;
 };
 /**
- * Edge case: when selectableColumns is true, clicking a column header should clear
+ * Edge case: when selectableCells is true, clicking a column header should clear
  * any existing cell selection (and initial focused cell) so that column selection takes over.
  */
 export declare const ColumnHeaderClickClearsCellSelection: {
@@ -154,6 +154,46 @@ export declare const ShiftArrowExtendsSelection: {
         canvasElement: HTMLElement;
     }) => Promise<void>;
 };
+/**
+ * Spreadsheet-style Shift+Arrow: expand a range, then contract it back toward the
+ * anchor. Shift+ArrowUp after expanding downward must shrink the selection (not
+ * jump/expand the opposite edge).
+ */
+export declare const ShiftArrowContractsSelection: {
+    tags: string[];
+    render: () => HTMLDivElement & {
+        _table?: import("../../src/index").SimpleTableVanilla | undefined;
+    };
+    play: ({ canvasElement }: {
+        canvasElement: HTMLElement;
+    }) => Promise<void>;
+};
+/**
+ * After a mouse-drag range, Shift+Arrow must continue from the drag endpoint
+ * (spreadsheet active cell), contracting/expanding that free end — not restart
+ * from the mousedown anchor and collapse the range.
+ */
+export declare const ShiftArrowContractsAfterMouseDrag: {
+    tags: string[];
+    render: () => HTMLDivElement & {
+        _table?: import("../../src/index").SimpleTableVanilla | undefined;
+    };
+    play: ({ canvasElement }: {
+        canvasElement: HTMLElement;
+    }) => Promise<void>;
+};
+/**
+ * Horizontal Shift+Arrow expand then contract toward the column anchor.
+ */
+export declare const ShiftArrowContractsHorizontalSelection: {
+    tags: string[];
+    render: () => HTMLDivElement & {
+        _table?: import("../../src/index").SimpleTableVanilla | undefined;
+    };
+    play: ({ canvasElement }: {
+        canvasElement: HTMLElement;
+    }) => Promise<void>;
+};
 export declare const CtrlASelectsAllCells: {
     render: () => HTMLDivElement & {
         _table?: import("../../src/index").SimpleTableVanilla | undefined;

package/dist/stories/tests/15-ColumnVisibilityTests.stories.d.ts

@@ -133,3 +133,11 @@ export declare const ColumnEditorRowRenderer: {
         canvasElement: HTMLElement;
     }) => Promise<void>;
 };
+export declare const ColumnEditorConfigShowToggleFalse: {
+    render: () => HTMLDivElement & {
+        _table?: import("../../src/index").SimpleTableVanilla | undefined;
+    };
+    play: ({ canvasElement }: {
+        canvasElement: HTMLElement;
+    }) => Promise<void>;
+};

package/dist/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/stories/tests/21-ColumnSelectionTests.stories.d.ts

@@ -1,6 +1,6 @@
 /**
  * COLUMN SELECTION TESTS
- * Tests for selectableColumns and onColumnSelect callback.
+ * Tests for selectableCells (column selection mode) and onColumnSelect callback.
  */
 import type { Meta } from "@storybook/html";
 declare const meta: Meta;

package/dist/stories/tests/22-LoadingStateTests.stories.d.ts

@@ -53,3 +53,35 @@ export declare const LoadingToLoadedRemovesStaleCells: {
         canvasElement: HTMLElement;
     }) => Promise<void>;
 };
+/**
+ * Repro: `updateBodyCellElement` skips content rebuilds for expandable cells
+ * so the expand-icon DOM node survives for CSS transitions. That bypass also
+ * skips loading-skeleton swaps, so toggling `isLoading` on already-rendered
+ * row-grouped rows leaves the expandable column out of sync with every other
+ * column.
+ *
+ * Entering loading: non-expandable columns show skeletons; expandable columns
+ * keep their stale expand icon + value.
+ */
+export declare const ExpandableCellsShowSkeletonWhenEnteringLoading: {
+    render: () => HTMLDivElement & {
+        _table?: SimpleTableVanilla | undefined;
+    };
+    play: ({ canvasElement }: {
+        canvasElement: HTMLElement;
+    }) => Promise<void>;
+};
+/**
+ * Repro (exit path): expandable cells created while `isLoading` is true render
+ * as skeletons. When loading ends, content updates are still skipped for
+ * expandable cells, so they stay stuck on the skeleton instead of restoring
+ * the expand icon + value.
+ */
+export declare const ExpandableCellsRestoreContentWhenLeavingLoading: {
+    render: () => HTMLDivElement & {
+        _table?: SimpleTableVanilla | undefined;
+    };
+    play: ({ canvasElement }: {
+        canvasElement: HTMLElement;
+    }) => Promise<void>;
+};

package/dist/stories/tests/32-ThemesTests.stories.d.ts

@@ -53,6 +53,12 @@ export declare const UseHoverRowBackground: {
         canvasElement: HTMLElement;
     }) => Promise<void>;
 };
+export declare const UseHoverRowBackgroundIsolatedAcrossTables: {
+    render: () => HTMLDivElement;
+    play: ({ canvasElement }: {
+        canvasElement: HTMLElement;
+    }) => Promise<void>;
+};
 export declare const UseOddEvenRowBackground: {
     tags: string[];
     render: () => HTMLDivElement & {

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

@@ -233,6 +233,17 @@ export declare const AutoSizeRefitsOnDataChange: {
         canvasElement: HTMLElement;
     }) => Promise<void>;
 };
+export declare const AutoSizeRefitsAfterLoadingWithMultilineRenderer: {
+    parameters: {
+        tags: string[];
+    };
+    render: () => HTMLDivElement & {
+        _table?: SimpleTableVanilla | undefined;
+    };
+    play: ({ canvasElement }: {
+        canvasElement: HTMLElement;
+    }) => Promise<void>;
+};
 export declare const AutoSizeStableAcrossSort: {
     parameters: {
         tags: string[];

package/dist/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;

package/dist/stories/vanillaStoryConfig.d.ts

@@ -18,7 +18,6 @@ export interface UniversalVanillaArgs {
     hideFooter?: boolean;
     rowsPerPage?: number;
     selectableCells?: boolean;
-    selectableColumns?: boolean;
     shouldPaginate?: boolean;
     theme?: Theme;
     useHoverRowBackground?: boolean;
@@ -112,12 +111,6 @@ export declare const vanillaArgTypes: {
         };
         description: string;
     };
-    selectableColumns: {
-        control: {
-            type: "boolean";
-        };
-        description: string;
-    };
     shouldPaginate: {
         control: {
             type: "boolean";