simple-table-core 3.0.0-beta.15 → 3.0.0-beta.18

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