simple-table-core 3.0.0-beta.16 → 3.0.0-beta.19

package/dist/cjs/src/core/SimpleTableVanilla.d.ts

@@ -66,6 +66,8 @@ export declare class SimpleTableVanilla {
     private getRenderState;
     private render;
     update(config: Partial<SimpleTableConfig>): void;
+    /** @deprecated Use {@link update} — same behavior. */
+    updateConfig(config: Partial<SimpleTableConfig>): void;
     destroy(): void;
     getAPI(): TableAPI;
 }

package/dist/cjs/src/core/rendering/RenderOrchestrator.d.ts

@@ -31,6 +31,7 @@ export interface RenderContext {
     getCollapsedRows: () => Map<string, number>;
     getCollapsedHeaders?: () => Set<Accessor>;
     getExpandedRows: () => Map<string, number>;
+    getHeaders: () => HeaderObject[];
     getRowStateMap: () => Map<string | number, RowState>;
     headerRegistry: Map<string, any>;
     headers: HeaderObject[];

package/dist/cjs/src/core/rendering/TableRenderer.d.ts

@@ -25,6 +25,7 @@ export interface TableRendererDeps {
     getCollapsedHeaders?: () => Set<Accessor>;
     getCollapsedRows: () => Map<string, number>;
     getExpandedRows: () => Map<string, number>;
+    getHeaders: () => HeaderObject[];
     getRowStateMap: () => Map<string | number, any>;
     headerRegistry: Map<string, any>;
     headers: HeaderObject[];

package/dist/cjs/src/index.d.ts

@@ -16,7 +16,6 @@ import type SharedTableProps from "./types/SharedTableProps";
 import type SortColumn from "./types/SortColumn";
 import type TableHeaderProps from "./types/TableHeaderProps";
 import type { TableAPI, SetHeaderRenameProps, ExportToCSVProps } from "./types/TableAPI";
-import type TableRefType from "./types/TableRefType";
 import type TableRowProps from "./types/TableRowProps";
 import type Theme from "./types/Theme";
 import type UpdateDataProps from "./types/UpdateCellProps";
@@ -46,4 +45,5 @@ import type { SimpleTableProps } from "./types/SimpleTableProps";
 import type { RowId } from "./types/RowId";
 import type { PinnedSectionsState } from "./types/PinnedSectionsState";
 export { SimpleTableVanilla };
-export type { Accessor, AggregationConfig, AggregationType, BoundingBox, Cell, CellChangeProps, CellClickProps, CellRenderer, CellRendererProps, CellValue, ChartOptions, ColumnEditorConfig, ColumnEditorCustomRenderer, ColumnEditorCustomRendererProps, ColumnEditorRowRenderer, ColumnEditorRowRendererComponents, ColumnEditorRowRendererProps, ColumnEditorSearchFunction, ColumnType, ColumnVisibilityState, Comparator, ComparatorProps, CustomTheme, CustomThemeProps, DragHandlerProps, EmptyStateRenderer, EmptyStateRendererProps, EnumOption, ErrorStateRenderer, ErrorStateRendererProps, ExportToCSVProps, ExportValueGetter, ExportValueProps, FilterCondition, FooterRendererProps, GetRowId, GetRowIdParams, IconsConfig, LoadingStateRenderer, LoadingStateRendererProps, HeaderDropdown, HeaderDropdownProps, HeaderObject, HeaderRenderer, HeaderRendererProps, HeaderRendererComponents, OnRowGroupExpandProps, OnSortProps, QuickFilterConfig, QuickFilterGetter, QuickFilterGetterProps, QuickFilterMode, Row, RowButtonProps, RowId, RowSelectionChangeProps, RowState, SetHeaderRenameProps, SharedTableProps, ShowWhen, SimpleTableConfig, SimpleTableProps, SortColumn, TableAPI, TableFilterState, TableHeaderProps, TableRefType, TableRowProps, Theme, PinnedSectionsState, UpdateDataProps, ValueFormatter, ValueFormatterProps, ValueGetter, ValueGetterProps, };
+export { asRows } from "./utils/asRows";
+export type { Accessor, AggregationConfig, AggregationType, BoundingBox, Cell, CellChangeProps, CellClickProps, CellRenderer, CellRendererProps, CellValue, ChartOptions, ColumnEditorConfig, ColumnEditorCustomRenderer, ColumnEditorCustomRendererProps, ColumnEditorRowRenderer, ColumnEditorRowRendererComponents, ColumnEditorRowRendererProps, ColumnEditorSearchFunction, ColumnType, ColumnVisibilityState, Comparator, ComparatorProps, CustomTheme, CustomThemeProps, DragHandlerProps, EmptyStateRenderer, EmptyStateRendererProps, EnumOption, ErrorStateRenderer, ErrorStateRendererProps, ExportToCSVProps, ExportValueGetter, ExportValueProps, FilterCondition, FooterRendererProps, GetRowId, GetRowIdParams, IconsConfig, LoadingStateRenderer, LoadingStateRendererProps, HeaderDropdown, HeaderDropdownProps, HeaderObject, HeaderRenderer, HeaderRendererProps, HeaderRendererComponents, OnRowGroupExpandProps, OnSortProps, QuickFilterConfig, QuickFilterGetter, QuickFilterGetterProps, QuickFilterMode, Row, RowButtonProps, RowId, RowSelectionChangeProps, RowState, SetHeaderRenameProps, SharedTableProps, ShowWhen, SimpleTableConfig, SimpleTableProps, SortColumn, TableAPI, TableFilterState, TableHeaderProps, TableRowProps, Theme, PinnedSectionsState, UpdateDataProps, ValueFormatter, ValueFormatterProps, ValueGetter, ValueGetterProps, };

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

@@ -29,6 +29,7 @@ export declare class DimensionManager {
     private convertHeightToPixels;
     private calculateContentHeight;
     private observeContainer;
+    private applyContainerWidthSync;
     updateConfig(config: Partial<DimensionManagerConfig>): void;
     subscribe(callback: StateChangeCallback): () => void;
     private notifySubscribers;

package/dist/cjs/src/types/HeaderObject.d.ts

@@ -80,7 +80,7 @@ type HeaderObject = {
     label: string;
     minWidth?: number | string;
     sortingOrder?: ("asc" | "desc" | null)[];
-    nestedTable?: Omit<SimpleTableProps, "rows" | "loadingStateRenderer" | "errorStateRenderer" | "emptyStateRenderer" | "tableEmptyStateRenderer" | "expandIcon" | "filterIcon" | "sortUpIcon" | "sortDownIcon" | "nextIcon" | "prevIcon" | "headerCollapseIcon" | "headerExpandIcon">;
+    nestedTable?: Omit<SimpleTableProps, "rows" | "loadingStateRenderer" | "errorStateRenderer" | "emptyStateRenderer" | "tableEmptyStateRenderer">;
     pinned?: Pinned;
     quickFilterable?: boolean;
     quickFilterGetter?: QuickFilterGetter;

package/dist/cjs/src/types/SimpleTableConfig.d.ts

@@ -19,14 +19,12 @@ import { ColumnEditorConfig } from "./ColumnEditorConfig";
 import { VanillaIconsConfig } from "./IconsConfig";
 import { QuickFilterConfig } from "./QuickFilterTypes";
 export interface SimpleTableConfig {
-    allowAnimations?: boolean;
     autoExpandColumns?: boolean;
     canExpandRowGroup?: (row: Row) => boolean;
     cellUpdateFlash?: boolean;
     className?: string;
     columnBorders?: boolean;
     columnEditorConfig?: ColumnEditorConfig;
-    columnEditorText?: string;
     columnReordering?: boolean;
     columnResizing?: boolean;
     copyHeadersToClipboard?: boolean;

package/dist/cjs/src/types/SimpleTableProps.d.ts

@@ -12,7 +12,6 @@ import OnNextPage from "./OnNextPage";
 import OnRowGroupExpandProps from "./OnRowGroupExpandProps";
 import RowSelectionChangeProps from "./RowSelectionChangeProps";
 import { RowButton } from "./RowButton";
-import TableRefType from "./TableRefType";
 import Theme from "./Theme";
 import { CustomThemeProps } from "./CustomTheme";
 import { GetRowId } from "./GetRowId";
@@ -26,7 +25,6 @@ export interface SimpleTableProps {
     className?: string;
     columnBorders?: boolean;
     columnEditorConfig?: ColumnEditorConfig;
-    columnEditorText?: string;
     columnReordering?: boolean;
     columnResizing?: boolean;
     copyHeadersToClipboard?: boolean;
@@ -40,14 +38,10 @@ export interface SimpleTableProps {
     enableStickyParents?: boolean;
     errorStateRenderer?: ErrorStateRenderer;
     expandAll?: boolean;
-    expandIcon?: IconsConfig["expand"];
     externalFilterHandling?: boolean;
     externalSortHandling?: boolean;
-    filterIcon?: IconsConfig["filter"];
     footerRenderer?: (props: FooterRendererProps) => HTMLElement | string | null;
-    headerCollapseIcon?: IconsConfig["headerCollapse"];
     headerDropdown?: HeaderDropdown;
-    headerExpandIcon?: IconsConfig["headerExpand"];
     height?: string | number;
     hideFooter?: boolean;
     hideHeader?: boolean;
@@ -58,7 +52,6 @@ export interface SimpleTableProps {
     isLoading?: boolean;
     loadingStateRenderer?: LoadingStateRenderer;
     maxHeight?: string | number;
-    nextIcon?: IconsConfig["next"];
     onCellClick?: (props: CellClickProps) => void;
     onCellEdit?: (props: CellChangeProps) => void;
     onColumnOrderChange?: (newHeaders: HeaderObject[]) => void;
@@ -74,7 +67,6 @@ export interface SimpleTableProps {
     onRowGroupExpand?: (props: OnRowGroupExpandProps) => void | Promise<void>;
     onRowSelectionChange?: (props: RowSelectionChangeProps) => void;
     onSortChange?: (sort: SortColumn | null) => void;
-    prevIcon?: IconsConfig["prev"];
     quickFilter?: QuickFilterConfig;
     rowButtons?: RowButton[];
     rowGrouping?: Accessor[];
@@ -85,12 +77,7 @@ export interface SimpleTableProps {
     selectableColumns?: boolean;
     serverSidePagination?: boolean;
     shouldPaginate?: boolean;
-    sortDownIcon?: IconsConfig["sortDown"];
-    sortUpIcon?: IconsConfig["sortUp"];
     tableEmptyStateRenderer?: HTMLElement | string | null;
-    tableRef?: {
-        current: TableRefType | null;
-    };
     theme?: Theme;
     totalRowCount?: number;
     useHoverRowBackground?: boolean;

package/dist/cjs/src/utils/asRows.d.ts

@@ -0,0 +1,7 @@
+import type Row from "../types/Row";
+/**
+ * Structural typing bridge: domain row interfaces often do not assign to {@link Row}[]
+ * because `Row` uses an index signature. Use when passing typed data to `rows` and
+ * similar APIs.
+ */
+export declare function asRows<T>(rows: readonly T[]): Row[];

package/dist/cjs/src/utils/bodyCell/expansion.d.ts

@@ -1,4 +1,12 @@
 import { AbsoluteBodyCell, CellRenderContext } from "./types";
 export declare const createExpandIcon: (cell: AbsoluteBodyCell, context: CellRenderContext, isExpanded: boolean) => HTMLElement;
+export type UpdateExpandIconStateOptions = {
+    /** aria-label when the group is expanded (chevron shows collapse action). */
+    ariaLabelWhenExpanded?: string;
+    /** aria-label when the group is collapsed (chevron shows expand action). */
+    ariaLabelWhenCollapsed?: string;
+    /** When true, sets aria-expanded to match isExpanded after the toggle. */
+    syncAriaExpanded?: boolean;
+};
 /** Update expand/collapse icon direction on an existing cell (e.g. after expand state changes for nested grids). */
-export declare const updateExpandIconState: (cellElement: HTMLElement, isExpanded: boolean) => void;
+export declare const updateExpandIconState: (cellElement: HTMLElement, isExpanded: boolean, options?: UpdateExpandIconStateOptions) => void;

package/dist/cjs/src/utils/columnEditor/createColumnEditorRow.d.ts

@@ -27,5 +27,12 @@ export interface CreateColumnEditorRowOptions {
     setHeaders: (headers: HeaderObject[]) => void;
     onColumnVisibilityChange?: (state: ColumnVisibilityState) => void;
     onColumnOrderChange?: (headers: HeaderObject[]) => void;
+    /** When set (e.g. after expand toggle), used with updateExpandIconState so the chevron animates like table cells. */
+    previousExpandedHeaders?: ReadonlySet<string>;
 }
-export declare const createColumnEditorRow: (options: CreateColumnEditorRowOptions) => DocumentFragment;
+export interface CreateColumnEditorRowResult {
+    fragment: DocumentFragment;
+    /** Run after the row fragment is connected to the document (e.g. listEl.appendChild). */
+    scheduleExpandIconAnimation?: () => void;
+}
+export declare const createColumnEditorRow: (options: CreateColumnEditorRowOptions) => CreateColumnEditorRowResult;

package/dist/cjs/src/utils/filters/createDropdown.d.ts

@@ -1,12 +1,29 @@
+/**
+ * Filter / filter-UI dropdown positioning (React-era parity):
+ * - Fixed: portaled under `.simple-table-root`, anchored to `anchorElement` (e.g. filter icon) so
+ *   `overflow: hidden` on `.st-header-cell` does not clip the panel. Same top/left +4px and
+ *   container-based flip as legacy React Dropdown.tsx.
+ * - Absolute: stays under caller’s parent (e.g. `.st-custom-select`); use `anchorElement` for the
+ *   trigger rect vs `position: relative` parent (React CustomSelect pattern).
+ */
 export interface CreateDropdownOptions {
     children: HTMLElement;
     containerRef?: HTMLElement;
     mainBodyRef?: HTMLElement;
+    /** Rect used for placement. Required for fixed portaling (e.g. filter icon); for absolute, pass the real trigger (button/input) when it differs from the dropdown parent. */
+    anchorElement?: HTMLElement;
     onClose: () => void;
     open: boolean;
     overflow?: "auto" | "visible" | "hidden";
     width?: number;
+    maxWidth?: number;
     positioning?: "fixed" | "absolute";
+    /**
+     * When true, this panel does not clip overflowing descendants (e.g. nested operator menus inside
+     * the filter popover). Uses overflow: visible and drops max-height on the shell — see
+     * `.st-dropdown-content--allow-descendant-overflow` in base.css.
+     */
+    allowDescendantOverflow?: boolean;
 }
 export declare const createDropdown: (options: CreateDropdownOptions) => {
     element: HTMLDivElement;

package/dist/cjs/src/utils/filters/createFilterActions.d.ts

@@ -4,6 +4,7 @@ export interface CreateFilterActionsOptions {
     canApply: boolean;
     showClear: boolean;
 }
+/** Matches React FilterActions: `st-filter-button-apply`, `st-filter-button-clear`, `st-filter-button-disabled`. */
 export declare const createFilterActions: (options: CreateFilterActionsOptions) => {
     element: HTMLDivElement;
     update: (newOptions: Partial<CreateFilterActionsOptions>) => void;

package/dist/cjs/src/utils/headerCell/collapsing.d.ts

@@ -2,5 +2,5 @@ import HeaderObject from "../../types/HeaderObject";
 import { HeaderRenderContext } from "./types";
 /** Use same icon and animation as body row expand/collapse (icons.expand + st-expand-icon-container). */
 export declare const createCollapseIcon: (header: HeaderObject, context: HeaderRenderContext) => HTMLElement | null;
-/** Update header collapse icon direction on an existing cell (same pattern as body updateExpandIconState). */
+/** Update header collapse icon direction on an existing cell (delegates to body updateExpandIconState). */
 export declare const updateHeaderCollapseIconState: (cellElement: HTMLElement, isCollapsed: boolean, label?: string) => void;

package/dist/cjs/src/utils/headerCell/resizing.d.ts

@@ -1,3 +1,3 @@
 import HeaderObject from "../../types/HeaderObject";
 import { HeaderRenderContext } from "./types";
-export declare const createResizeHandle: (header: HeaderObject, context: HeaderRenderContext, isLastHeader: boolean) => HTMLElement | null;
+export declare const createResizeHandle: (header: HeaderObject, context: HeaderRenderContext, isLastMainAutoExpandColumn: boolean) => HTMLElement | null;

package/dist/cjs/src/utils/headerCell/styling.d.ts

@@ -1,5 +1,5 @@
 import { AbsoluteCell, HeaderRenderContext } from "./types";
-export declare const calculateHeaderCellClasses: (cell: AbsoluteCell, context: HeaderRenderContext, isLastHeader: boolean) => string;
-export declare const createHeaderCellElement: (cell: AbsoluteCell, context: HeaderRenderContext, isLastHeader: boolean) => HTMLElement;
+export declare const calculateHeaderCellClasses: (cell: AbsoluteCell, context: HeaderRenderContext, isLastMainAutoExpandColumn: boolean) => string;
+export declare const createHeaderCellElement: (cell: AbsoluteCell, context: HeaderRenderContext, isLastMainAutoExpandColumn: boolean) => HTMLElement;
 export declare const getLastHeaderIndex: (absoluteCells: AbsoluteCell[]) => number;
-export declare const updateHeaderCellElement: (cellElement: HTMLElement, cell: AbsoluteCell, context: HeaderRenderContext, isLastHeader: boolean) => void;
+export declare const updateHeaderCellElement: (cellElement: HTMLElement, cell: AbsoluteCell, context: HeaderRenderContext, isLastMainAutoExpandColumn: boolean) => void;

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

@@ -53,4 +53,6 @@ export declare const calculateHeaderContentWidth: (accessor: Accessor, options?:
     header?: HeaderObject;
     maxWidth?: number;
     sampleSize?: number;
+    /** Scope `.st-cell-content` font/padding sampling to this table instance */
+    styleRoot?: ParentNode | null;
 }) => number;

package/dist/cjs/src/utils/resizeUtils/index.d.ts

@@ -1,5 +1,22 @@
+import type HeaderObject from "../../types/HeaderObject";
+import type { Accessor } from "../../types/HeaderObject";
 import type { HandleResizeStartProps } from "../../types/HandleResizeStartProps";
 /**
  * Handler for when resize dragging starts
  */
-export declare const handleResizeStart: ({ autoExpandColumns, collapsedHeaders, containerWidth, event, header, headers, onColumnWidthChange, reverse, setHeaders, setIsResizing, startWidth, }: HandleResizeStartProps) => void;
+export declare const handleResizeStart: ({ autoExpandColumns, collapsedHeaders, containerWidth, event, header, headers, mainBodyRef, onColumnWidthChange, reverse, setHeaders, setIsResizing, startWidth, }: HandleResizeStartProps) => void;
+export type ApplyColumnAutoFitWithAutoExpandParams = {
+    collapsedHeaders: Set<Accessor>;
+    containerWidth: number;
+    getTargetLeafWidth: (leafHeader: HeaderObject) => number;
+    header: HeaderObject;
+    headerCellElement: HTMLElement | null;
+    headers: HeaderObject[];
+    mainBodyRef: HandleResizeStartProps["mainBodyRef"];
+    reverse: boolean;
+};
+/**
+ * Apply a one-shot "fit to content" width for a column while preserving autoExpand
+ * compensation (same redistribution rules as dragging the resize handle).
+ */
+export declare const applyColumnAutoFitWithAutoExpand: ({ header, headers, collapsedHeaders, containerWidth, mainBodyRef, reverse, headerCellElement, getTargetLeafWidth, }: ApplyColumnAutoFitWithAutoExpandParams) => void;

package/dist/cjs/stories/examples/spreadsheet/SpreadsheetExample.d.ts

@@ -0,0 +1,4 @@
+import { type UniversalVanillaArgs } from "../../vanillaStoryConfig";
+import "./spreadsheet-demo.css";
+export declare const spreadsheetExampleDefaults: Partial<UniversalVanillaArgs>;
+export declare function renderSpreadsheetExample(args?: Partial<UniversalVanillaArgs>): HTMLElement;

package/dist/cjs/stories/tests/13-ColumnResizeTests.stories.d.ts

@@ -53,6 +53,9 @@ export declare const OnColumnWidthChangeCallbackFires: {
     }) => Promise<void>;
 };
 export declare const DoubleClickResizeHandleAutoFit: {
+    parameters: {
+        tags: string[];
+    };
     render: () => HTMLDivElement & {
         _table?: SimpleTableVanilla | undefined;
     };

package/dist/cjs/stories/tests/37-TableRefMethodsTests.stories.d.ts

@@ -1,6 +1,6 @@
 /**
  * TABLE REF METHODS TESTS
- * Tests for tableRef / getAPI() methods: getVisibleRows, getAllRows, getHeaders,
+ * Tests for TableAPI (getAPI()) methods: getVisibleRows, getAllRows, getHeaders,
  * getSortState/applySortState, getFilterState/applyFilter/clearFilter,
  * getCurrentPage/setPage, setQuickFilter, toggleColumnEditor/applyColumnVisibility,
  * expandAll/collapseAll/getExpandedDepths.

package/dist/cjs/stories/tests/39-AutoExpandColumnsTests.stories.d.ts

@@ -350,6 +350,18 @@ export declare const AutoExpandDoubleClickResizePinned: {
         canvasElement: HTMLElement;
     }) => Promise<void>;
 };
+/** Last main column under autoExpand: no resize handle; prior column still has a handle. */
+export declare const AutoExpandLastMainColumnNoResizeHandle: {
+    parameters: {
+        tags: string[];
+    };
+    render: () => HTMLDivElement & {
+        _table?: import("../../src/index").SimpleTableVanilla | undefined;
+    };
+    play: ({ canvasElement }: {
+        canvasElement: HTMLElement;
+    }) => Promise<void>;
+};
 /** Stress test: resize across pinned and main sections in sequence, growing and shrinking. */
 export declare const AutoExpandResizePinnedAndMainStress: {
     parameters: {