simple-table-core 3.0.0-beta.9 → 3.0.0

package/dist/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/src/core/initialization/TableInitializer.d.ts

@@ -1,5 +1,7 @@
 import { SimpleTableConfig } from "../../types/SimpleTableConfig";
 import { CustomTheme } from "../../types/CustomTheme";
+import { ColumnEditorRowRenderer } from "../../types/ColumnEditorRowRendererProps";
+import { ColumnEditorCustomRenderer } from "../../types/ColumnEditorCustomRendererProps";
 import HeaderObject, { Accessor } from "../../types/HeaderObject";
 export interface ResolvedIcons {
     drag: string | HTMLElement | SVGSVGElement;
@@ -18,7 +20,8 @@ export interface MergedColumnEditorConfig {
     searchPlaceholder: string;
     allowColumnPinning: boolean;
     searchFunction?: (header: HeaderObject, searchText: string) => boolean;
-    rowRenderer?: any;
+    rowRenderer?: ColumnEditorRowRenderer;
+    customRenderer?: ColumnEditorCustomRenderer;
 }
 export declare class TableInitializer {
     static resolveIcons(config: SimpleTableConfig): ResolvedIcons;

package/dist/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/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/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";
@@ -31,6 +30,7 @@ import type HeaderRendererProps from "./types/HeaderRendererProps";
 import type { HeaderRenderer, HeaderRendererComponents } from "./types/HeaderRendererProps";
 import type ColumnEditorRowRendererProps from "./types/ColumnEditorRowRendererProps";
 import type { ColumnEditorRowRenderer, ColumnEditorRowRendererComponents } from "./types/ColumnEditorRowRendererProps";
+import type { ColumnEditorCustomRendererProps, ColumnEditorCustomRenderer } from "./types/ColumnEditorCustomRendererProps";
 import type HeaderDropdownProps from "./types/HeaderDropdownProps";
 import type { HeaderDropdown } from "./types/HeaderDropdownProps";
 import type { RowButtonProps } from "./types/RowButton";
@@ -45,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, 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/src/managers/DimensionManager.d.ts

@@ -22,6 +22,8 @@ export declare class DimensionManager {
     private subscribers;
     private resizeObserver;
     private rafId;
+    /** Set when applyContainerWidthSync updates state before any subscriber exists. */
+    private initialNotifyPending;
     constructor(config: DimensionManagerConfig);
     private getHeaderDepth;
     private calculateMaxHeaderDepth;
@@ -29,6 +31,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/src/managers/SelectionManager/SelectionManager.d.ts

@@ -139,6 +139,13 @@ export declare class SelectionManager {
      */
     private updateCellFlashClasses;
     private static readonly SELECTION_CLASSES;
+    private static readonly HEADER_SELECTION_CLASSES;
+    /**
+     * Keep column header highlight in sync with cell/column selection during drag.
+     * Body cells are patched here; headers normally update only on full render.
+     */
+    private syncHeaderSelectionClasses;
+    private clearHeaderSelectionHighlightClasses;
     /**
      * Apply selection classes to all currently rendered cells. Used after drag ends
      * so that the DOM (which may have been replaced during scroll) reflects selection.

package/dist/src/managers/SelectionManager/mouseUtils.d.ts

@@ -11,5 +11,6 @@ export declare function calculateNearestCell(clientX: number, clientY: number):
 export declare function getCellFromMousePosition(clientX: number, clientY: number): Cell | null;
 /**
  * Handle auto-scrolling when dragging near table edges.
+ * @param root - Table root (e.g. `.simple-table-root`); limits queries to this instance.
  */
-export declare function handleAutoScroll(clientX: number, clientY: number): void;
+export declare function handleAutoScroll(clientX: number, clientY: number, root?: Document | HTMLElement): void;

package/dist/src/managers/SelectionManager/types.d.ts

@@ -6,6 +6,12 @@ import type { CustomTheme } from "../../types/CustomTheme";
 export declare const createSetString: ({ rowIndex, colIndex, rowId }: Cell) => string;
 export interface SelectionManagerConfig {
     selectableCells: boolean;
+    /**
+     * When true, column header click selects columns (`st-header-selected` on headers).
+     * Cell-in-column header tint (`st-header-has-highlighted-cell`) also applies when `selectableCells` is true
+     * even if this is false.
+     */
+    selectableColumns?: boolean;
     headers: HeaderObject[];
     tableRows: TableRowType[];
     onCellEdit?: (props: any) => void;

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

@@ -1,5 +1,6 @@
 import HeaderObject from "./HeaderObject";
 import { ColumnEditorRowRenderer } from "./ColumnEditorRowRendererProps";
+import { ColumnEditorCustomRenderer } from "./ColumnEditorCustomRendererProps";
 /**
  * Custom search function for filtering columns in the column editor
  * @param header - The header object to check
@@ -26,7 +27,9 @@ export interface ColumnEditorConfig {
     allowColumnPinning?: boolean;
     /** Custom renderer for column editor row layout to reposition icons and labels */
     rowRenderer?: ColumnEditorRowRenderer;
+    /** Custom renderer for the entire column editor panel. Receives pre-built sections (search, list, reset) and headers. */
+    customRenderer?: ColumnEditorCustomRenderer;
 }
-export declare const DEFAULT_COLUMN_EDITOR_CONFIG: Required<Omit<ColumnEditorConfig, "searchFunction" | "rowRenderer">>;
+export declare const DEFAULT_COLUMN_EDITOR_CONFIG: Required<Omit<ColumnEditorConfig, "searchFunction" | "rowRenderer" | "customRenderer">>;
 /** Column editor config with defaults applied (text, searchEnabled, searchPlaceholder are required) */
-export type MergedColumnEditorConfig = Required<Pick<ColumnEditorConfig, "text" | "searchEnabled" | "searchPlaceholder" | "allowColumnPinning">> & Pick<ColumnEditorConfig, "searchFunction" | "rowRenderer">;
+export type MergedColumnEditorConfig = Required<Pick<ColumnEditorConfig, "text" | "searchEnabled" | "searchPlaceholder" | "allowColumnPinning">> & Pick<ColumnEditorConfig, "searchFunction" | "rowRenderer" | "customRenderer">;

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

@@ -0,0 +1,14 @@
+import type HeaderObject from "./HeaderObject";
+export interface ColumnEditorCustomRendererProps {
+    /** The current headers array */
+    headers: HeaderObject[];
+    /** Pre-built search input section, or null if search is disabled */
+    searchSection: HTMLElement | null;
+    /** Pre-built column list section with drag-and-drop, checkboxes, etc. */
+    listSection: HTMLElement;
+    /** Pre-built reset button section, or null if no default headers are configured */
+    resetSection: HTMLElement | null;
+    /** Function to reset columns to their default configuration */
+    resetColumns?: () => void;
+}
+export type ColumnEditorCustomRenderer = (props: ColumnEditorCustomRendererProps) => HTMLElement | string | null;

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

@@ -24,3 +24,5 @@ export type CustomTheme = Required<CustomThemeProps>;
  * These match the original hardcoded constants throughout the codebase
  */
 export declare const DEFAULT_CUSTOM_THEME: CustomTheme;
+/** Shallow value equality — used to skip layout work when React passes a new `customTheme` object with the same numbers. */
+export declare function areCustomThemesEqual(a: CustomTheme, b: CustomTheme): boolean;

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

@@ -10,7 +10,6 @@ export interface CreateColumnEditorOptions {
     searchPlaceholder: string;
     searchFunction?: ColumnEditorSearchFunction;
     columnEditorConfig: ColumnEditorConfig;
-    contextHeaders: HeaderObject[];
     essentialAccessors?: ReadonlySet<string>;
     resetColumns?: () => void;
     setHeaders: (headers: HeaderObject[]) => void;

package/dist/src/utils/columnEditor/createColumnEditorPopout.d.ts

@@ -8,7 +8,6 @@ export interface CreateColumnEditorPopoutOptions {
     searchPlaceholder: string;
     searchFunction?: ColumnEditorSearchFunction;
     columnEditorConfig: ColumnEditorConfig;
-    contextHeaders: HeaderObject[];
     essentialAccessors?: ReadonlySet<string>;
     setHeaders: (headers: HeaderObject[]) => void;
     onColumnVisibilityChange?: (state: ColumnVisibilityState) => void;

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

@@ -22,4 +22,7 @@ export declare const getHeaderPositionCache: (container: HTMLElement) => Map<str
 export declare const REVERT_TO_PREVIOUS_HEADERS_DELAY = 1500;
 export declare const throttle: (callback: () => void, limit: number) => void;
 export declare const addTrackedEventListener: (element: HTMLElement, event: string, handler: EventListener, options?: AddEventListenerOptions) => void;
+/** 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;

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

@@ -39,6 +39,8 @@ export interface HeaderRenderContext {
     handleApplyFilter: (filter: FilterCondition) => void;
     handleClearFilter: (accessor: Accessor) => void;
     handleSelectAll?: (checked: boolean) => void;
+    /** Live header tree from table state (avoids stale `headers` snapshot in long-lived handlers). */
+    getHeaders: () => HeaderObject[];
     headerHeight: number;
     headerRegistry?: Map<string, {
         setEditing: (editing: boolean) => void;

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

@@ -13,8 +13,8 @@ export declare const DEFAULT_TABLE_WIDTH = 800;
  * Normalize header widths so that fr and % are converted to pixels.
  * Call this as soon as headers are received so the rest of the code can assume numeric widths.
  * If totalWidth is not provided, a reasonable total is computed from fixed widths + default for fr columns.
- * If options.containerWidth is provided, the main section's fr columns are given the remaining space
- * (container width minus pinned left/right), so the flexible column fills available space.
+ * If options.containerWidth is provided, all fr/% columns are resolved against the full container width,
+ * so pinned and non-pinned fr columns share the same proportional pool.
  */
 export declare function normalizeHeaderWidths(headers: HeaderObject[], totalWidthOrOptions?: number | {
     containerWidth: number;
@@ -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/src/utils/pinnedColumnUtils.d.ts

@@ -21,5 +21,9 @@ export declare function getPinnedSectionsState(headers: HeaderObject[]): PinnedS
  * Clamps essential columns to the left within each section. Returns null if accessors don't match roots.
  */
 export declare function rebuildHeadersFromPinnedState(headers: HeaderObject[], state: PinnedSectionsState, essentialAccessors: ReadonlySet<string>): HeaderObject[] | null;
-/** Move a root column to another pin section (append within target section). */
+/**
+ * Move a root column to another pin section.
+ * Appends within left/right targets. For `main`, left-pinned columns are inserted at the
+ * start of main; right-pinned (and other) columns are inserted at the end of main.
+ */
 export declare function moveRootColumnPinSide(headers: HeaderObject[], accessor: Accessor, target: Exclude<PanelSection, "main"> | "main", essentialAccessors: ReadonlySet<string>): HeaderObject[] | null;

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

@@ -7,6 +7,10 @@ export interface CreateRowSeparatorOptions {
     heightOffsets?: HeightOffsets;
     customTheme?: CustomTheme;
     isSticky?: boolean;
+    /** Same px width as the body/sticky section (`SectionRenderer` / sticky pane); omit to use 100%. */
+    sectionWidthPx?: number;
 }
+/** Keep separator width in sync with section layout (resize, pinned width changes). */
+export declare const applyRowSeparatorSectionWidth: (separator: HTMLElement, sectionWidthPx?: number) => void;
 export declare const createRowSeparator: (options: CreateRowSeparatorOptions) => HTMLElement;
 export declare const createSpacerRow: (position: number, rowHeight: number, heightOffsets: HeightOffsets | undefined, customTheme: CustomTheme, className: string, height?: number) => HTMLElement;

package/dist/stories/SimpleTable.stories.d.ts

@@ -58,5 +58,6 @@ export declare const RowSelection: StoryObj;
 export declare const SalesExample: StoryObj;
 export declare const SelectableCells: StoryObj;
 export declare const ServerSidePagination: StoryObj;
+export declare const Spreadsheet: StoryObj;
 export declare const Theming: StoryObj;
 export declare const Tooltip: StoryObj;

package/dist/stories/examples/infrastructure/InfrastructureExample.d.ts

@@ -4,5 +4,6 @@ export declare const infrastructureExampleDefaults: {
     columnReordering: boolean;
     selectableCells: boolean;
     height: string;
+    autoExpandColumns: boolean;
 };
 export declare function renderInfrastructureExample(args?: Partial<UniversalVanillaArgs>): HTMLElement;

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

@@ -15,6 +15,7 @@ export declare const BasicRowSelection: {
     }) => Promise<void>;
 };
 export declare const SelectAllFunctionality: {
+    tags: string[];
     render: () => HTMLDivElement & {
         _table?: SimpleTableVanilla | undefined;
     };

package/dist/stories/tests/10-ColumnPinningTests.stories.d.ts

@@ -30,6 +30,15 @@ export declare const BothLeftAndRightPinned: {
         canvasElement: any;
     }) => Promise<void>;
 };
+/** Document order of pinned header/body sections: left before main before right. */
+export declare const PinnedSectionsDomOrder: {
+    play: ({ canvasElement }: {
+        canvasElement: HTMLElement;
+    }) => Promise<void>;
+    render: () => HTMLDivElement & {
+        _table?: SimpleTableVanilla | undefined;
+    };
+};
 export declare const MultipleLeftPinnedColumns: {
     render: () => HTMLDivElement & {
         _table?: SimpleTableVanilla | undefined;

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

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

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