simple-table-core 4.0.8 → 4.1.0

package/dist/types/HeaderRendererProps.d.ts

@@ -1,5 +1,7 @@
 import type { Accessor } from "./ColumnDef";
 import type ColumnDef from "./ColumnDef";
+import type Row from "./Row";
+import type { RowData } from "./Row";
 import type { IconElement } from "./IconsConfig";
 export interface HeaderRendererComponents {
     sortIcon?: IconElement;
@@ -7,11 +9,11 @@ export interface HeaderRendererComponents {
     collapseIcon?: IconElement;
     labelContent?: string | HTMLElement;
 }
-interface HeaderRendererProps {
-    accessor: Accessor;
+interface HeaderRendererProps<TData extends RowData = Row> {
+    accessor: Accessor<TData>;
     colIndex: number;
-    header: ColumnDef;
+    header: ColumnDef<TData, any>;
     components?: HeaderRendererComponents;
 }
-export type HeaderRenderer = (props: HeaderRendererProps) => HTMLElement | string | null;
+export type HeaderRenderer<TData extends RowData = Row> = (props: HeaderRendererProps<TData>) => HTMLElement | string | null;
 export default HeaderRendererProps;

package/dist/types/OnRowGroupExpandProps.d.ts

@@ -1,14 +1,15 @@
 import Row from "./Row";
+import type { RowData } from "./Row";
 import { Accessor } from "./ColumnDef";
-interface OnRowGroupExpandProps {
-    row: Row;
+interface OnRowGroupExpandProps<TData extends RowData = Row> {
+    row: TData;
     depth: number;
     event: MouseEvent | KeyboardEvent;
     groupingKey?: string;
     isExpanded: boolean;
     rowIndexPath: number[];
     rowIdPath?: (string | number)[];
-    groupingKeys: Accessor[];
+    groupingKeys: Accessor<TData>[];
     setLoading: (loading: boolean) => void;
     setError: (error: string | null) => void;
     setEmpty: (isEmpty: boolean, message?: string) => void;

package/dist/types/PivotTypes.d.ts

@@ -2,18 +2,19 @@ import { Accessor } from "./ColumnDef";
 import { AggregationConfig } from "./AggregationTypes";
 import ColumnDef from "./ColumnDef";
 import Row from "./Row";
-export type PivotValueConfig = {
-    accessor: Accessor;
+import type { RowData } from "./Row";
+export type PivotValueConfig<TData extends RowData = Row> = {
+    accessor: Accessor<TData>;
     aggregation: AggregationConfig;
     label?: string;
 };
-export type PivotConfig = {
+export type PivotConfig<TData extends RowData = Row> = {
     /** Row dimension accessors (0+). Multi-level dims become an expandable tree. */
-    rows: Accessor[];
+    rows: Accessor<TData>[];
     /** Column dimension accessors (0+). Distinct values become dynamic header groups. */
-    columns: Accessor[];
+    columns: Accessor<TData>[];
     /** Value/measure configs (required, length >= 1). */
-    values: PivotValueConfig[];
+    values: PivotValueConfig<TData>[];
     /** Total column(s) aggregating across column dimensions. Default true. */
     showRowTotals?: boolean;
     /** Total row aggregating across row dimensions. Default true. */
@@ -32,6 +33,9 @@ export declare const PIVOT_BLANK_LABEL = "(blank)";
 export type PivotResult = {
     rows: Row[];
     headers: ColumnDef[];
-    /** Internal rowGrouping to use while pivot is active (undefined when flat). */
+    /**
+     * Internal rowGrouping while pivot is active (undefined when flat).
+     * Kept as open accessors — pivot injects synthetic keys.
+     */
     rowGrouping?: Accessor[];
 };

package/dist/types/QuickFilterTypes.d.ts

@@ -1,5 +1,6 @@
 import { Accessor } from "./ColumnDef";
 import Row from "./Row";
+import type { RowData } from "./Row";
 export type QuickFilterMode = "simple" | "smart";
 export interface QuickFilterConfig {
     text: string;
@@ -9,11 +10,11 @@ export interface QuickFilterConfig {
     useFormattedValue?: boolean;
     onChange?: (text: string) => void;
 }
-export interface QuickFilterGetterProps {
-    row: Row;
-    accessor: Accessor;
+export interface QuickFilterGetterProps<TData extends RowData = Row> {
+    row: TData;
+    accessor: Accessor<TData>;
 }
-export type QuickFilterGetter = (props: QuickFilterGetterProps) => string;
+export type QuickFilterGetter<TData extends RowData = Row> = (props: QuickFilterGetterProps<TData>) => string;
 export interface SmartFilterToken {
     type: "word" | "phrase" | "negation" | "columnSpecific";
     value: string;

package/dist/types/Row.d.ts

@@ -1,3 +1,9 @@
 import CellValue from "./CellValue";
 type Row = Record<string, CellValue | Row[] | Record<string, any>>;
+/**
+ * Constraint for consumer row shapes on generic table APIs.
+ * Defaults on those APIs remain {@link Row}; use a domain interface as `TData`
+ * (e.g. `ColumnDef<HREmployee>`) without requiring an index signature.
+ */
+export type RowData = unknown;
 export default Row;

package/dist/types/RowButton.d.ts

@@ -1,6 +1,7 @@
 import Row from "./Row";
-export interface RowButtonProps {
-    row: Row;
+import type { RowData } from "./Row";
+export interface RowButtonProps<TData extends RowData = Row> {
+    row: TData;
     rowIndex: number;
 }
-export type RowButton = (props: RowButtonProps) => HTMLElement | null;
+export type RowButton<TData extends RowData = Row> = (props: RowButtonProps<TData>) => HTMLElement | null;

package/dist/types/RowSelectionChangeProps.d.ts

@@ -1,6 +1,7 @@
 import Row from "./Row";
-type RowSelectionChangeProps = {
-    row: Row;
+import type { RowData } from "./Row";
+type RowSelectionChangeProps<TData extends RowData = Row> = {
+    row: TData;
     isSelected: boolean;
     selectedRows: Set<string>;
 };

package/dist/types/RowStateRendererProps.d.ts

@@ -1,18 +1,19 @@
 import type Row from "./Row";
-export interface LoadingStateRendererProps {
-    parentRow?: Row;
+import type { RowData } from "./Row";
+export interface LoadingStateRendererProps<TData extends RowData = Row> {
+    parentRow?: TData;
 }
-export interface ErrorStateRendererProps {
+export interface ErrorStateRendererProps<TData extends RowData = Row> {
     error: string;
-    parentRow?: Row;
+    parentRow?: TData;
 }
-export interface EmptyStateRendererProps {
+export interface EmptyStateRendererProps<TData extends RowData = Row> {
     message?: string;
-    parentRow?: Row;
+    parentRow?: TData;
 }
-export type VanillaLoadingStateRenderer = string | HTMLElement | ((props: LoadingStateRendererProps) => HTMLElement | string);
-export type VanillaErrorStateRenderer = string | HTMLElement | ((props: ErrorStateRendererProps) => HTMLElement | string);
-export type VanillaEmptyStateRenderer = string | HTMLElement | ((props: EmptyStateRendererProps) => HTMLElement | string);
-export type LoadingStateRenderer = VanillaLoadingStateRenderer;
-export type ErrorStateRenderer = VanillaErrorStateRenderer;
-export type EmptyStateRenderer = VanillaEmptyStateRenderer;
+export type VanillaLoadingStateRenderer<TData extends RowData = Row> = string | HTMLElement | ((props: LoadingStateRendererProps<TData>) => HTMLElement | string);
+export type VanillaErrorStateRenderer<TData extends RowData = Row> = string | HTMLElement | ((props: ErrorStateRendererProps<TData>) => HTMLElement | string);
+export type VanillaEmptyStateRenderer<TData extends RowData = Row> = string | HTMLElement | ((props: EmptyStateRendererProps<TData>) => HTMLElement | string);
+export type LoadingStateRenderer<TData extends RowData = Row> = VanillaLoadingStateRenderer<TData>;
+export type ErrorStateRenderer<TData extends RowData = Row> = VanillaErrorStateRenderer<TData>;
+export type EmptyStateRenderer<TData extends RowData = Row> = VanillaEmptyStateRenderer<TData>;

package/dist/types/SimpleTableConfig.d.ts

@@ -1,6 +1,7 @@
 import type ColumnDef from "./ColumnDef";
 import { Accessor } from "./ColumnDef";
 import Row from "./Row";
+import type { RowData } from "./Row";
 import { VanillaEmptyStateRenderer, VanillaErrorStateRenderer, VanillaLoadingStateRenderer } from "./RowStateRendererProps";
 import FooterRendererProps from "./FooterRendererProps";
 import { VanillaHeaderDropdown } from "./HeaderDropdownProps";
@@ -27,7 +28,7 @@ import type { PivotConfig } from "./PivotTypes";
  * Canonical runtime config after {@link normalizeConfig}.
  * Preferred public prop names only (no legacy aliases).
  */
-export interface SimpleTableConfig {
+export interface SimpleTableConfig<TData extends RowData = Row> {
     animations?: AnimationsConfig;
     /**
      * Expand-only fill: when the columns' natural widths (declared px, or
@@ -37,22 +38,22 @@ export interface SimpleTableConfig {
      * fit, the table scrolls horizontally instead.
      */
     autoExpandColumns?: boolean;
-    canExpandRowGroup?: (row: Row) => boolean;
+    canExpandRowGroup?: (row: TData) => boolean;
     cellUpdateFlash?: boolean;
     className?: string;
     columnBorders?: boolean;
     columnEditorConfig?: ColumnEditorConfig;
     columnReordering?: boolean;
     columnResizing?: boolean;
-    /** Column definitions. */
-    columns: ColumnDef[];
+    /** Column definitions. Mixed per-column TValue uses `any` on the column union. */
+    columns: ColumnDef<TData, any>[];
     copyHeadersToClipboard?: boolean;
     customTheme?: CustomThemeProps;
     /** Show the column editor / visibility UI. */
     enableColumnEditor?: boolean;
     /** Open the column editor when the table loads. */
     enableColumnEditorInitOpen?: boolean;
-    emptyStateRenderer?: VanillaEmptyStateRenderer;
+    emptyStateRenderer?: VanillaEmptyStateRenderer<TData>;
     enableHeaderEditing?: boolean;
     /** Enable client-side pagination. */
     enablePagination?: boolean;
@@ -66,7 +67,7 @@ export interface SimpleTableConfig {
     enableStickyParents?: boolean;
     /** @see SimpleTableProps.enableVirtualization */
     enableVirtualization?: boolean;
-    errorStateRenderer?: VanillaErrorStateRenderer;
+    errorStateRenderer?: VanillaErrorStateRenderer<TData>;
     expandAll?: boolean;
     externalFilterHandling?: boolean;
     externalSortHandling?: boolean;
@@ -90,28 +91,28 @@ export interface SimpleTableConfig {
     initialSortColumn?: string;
     initialSortDirection?: SortDirection;
     isLoading?: boolean;
-    loadingStateRenderer?: VanillaLoadingStateRenderer;
+    loadingStateRenderer?: VanillaLoadingStateRenderer<TData>;
     maxHeight?: string | number;
     /** Alternate column background. */
     oddColumnBackground?: boolean;
     /** Alternate odd/even row backgrounds. */
     oddEvenRowBackground?: boolean;
-    onCellClick?: (props: CellClickProps) => void;
-    onCellEdit?: (props: CellChangeProps) => void;
-    onColumnOrderChange?: (newHeaders: ColumnDef[]) => void;
-    onColumnSelect?: (header: ColumnDef) => void;
+    onCellClick?: (props: CellClickProps<TData>) => void;
+    onCellEdit?: (props: CellChangeProps<TData>) => void;
+    onColumnOrderChange?: (newHeaders: ColumnDef<TData, any>[]) => void;
+    onColumnSelect?: (header: ColumnDef<TData, any>) => void;
     onColumnVisibilityChange?: (visibilityState: ColumnVisibilityState) => void;
-    onColumnWidthChange?: (headers: ColumnDef[]) => void;
-    onFilterChange?: (filters: TableFilterState) => void;
+    onColumnWidthChange?: (headers: ColumnDef<TData, any>[]) => void;
+    onFilterChange?: (filters: TableFilterState<TData>) => void;
     /** Called once when the table is ready. */
     onTableReady?: () => void;
-    onHeaderEdit?: (header: ColumnDef, newLabel: string) => void;
+    onHeaderEdit?: (header: ColumnDef<TData, any>, newLabel: string) => void;
     infiniteScrollThreshold?: number;
     onLoadMore?: () => void;
     onNextPage?: OnNextPage;
     onPageChange?: (page: number) => void | Promise<void>;
-    onRowGroupExpand?: (props: OnRowGroupExpandProps) => void | Promise<void>;
-    onRowSelectionChange?: (props: RowSelectionChangeProps) => void;
+    onRowGroupExpand?: (props: OnRowGroupExpandProps<TData>) => void | Promise<void>;
+    onRowSelectionChange?: (props: RowSelectionChangeProps<TData>) => void;
     /**
      * Called by the renderer immediately BEFORE it permanently discards a host
      * element that may contain async-framework renderer output (e.g. React
@@ -124,14 +125,19 @@ export interface SimpleTableConfig {
     onRendererHostDiscard?: (host: HTMLElement) => void;
     onSortChange?: (sort: SortColumn | null) => void;
     /** @see SimpleTableProps.pivot */
-    pivot?: PivotConfig | null;
+    pivot?: PivotConfig<TData> | null;
     /** @see SimpleTableProps.onPivotChange */
-    onPivotChange?: (pivot: PivotConfig | null) => void;
+    onPivotChange?: (pivot: PivotConfig<TData> | null) => void;
     quickFilter?: QuickFilterConfig;
-    rowButtons?: RowButton[];
-    rowGrouping?: Accessor[];
-    getRowId?: GetRowId;
-    rows: Row[];
+    rowButtons?: RowButton<TData>[];
+    /**
+     * Property names that define the row grouping hierarchy.
+     * `Accessor<TData>` keeps keyof autocomplete; the `string & {}` arm still
+     * allows dynamic / heterogeneous nesting keys and pivot-injected keys.
+     */
+    rowGrouping?: Accessor<TData>[];
+    getRowId?: GetRowId<TData>;
+    rows: TData[];
     rowsPerPage?: number;
     scrollParent?: HTMLElement | "window" | (() => HTMLElement | null);
     selectableCells?: boolean;

package/dist/types/SimpleTableProps.d.ts

@@ -1,6 +1,7 @@
 import type ColumnDef from "./ColumnDef";
 import { Accessor } from "./ColumnDef";
 import Row from "./Row";
+import type { RowData } from "./Row";
 import { EmptyStateRenderer, ErrorStateRenderer, LoadingStateRenderer } from "./RowStateRendererProps";
 import FooterRendererProps from "./FooterRendererProps";
 import { HeaderDropdown } from "./HeaderDropdownProps";
@@ -23,25 +24,25 @@ import { QuickFilterConfig } from "./QuickFilterTypes";
 import { AnimationsConfig } from "./AnimationsConfig";
 import type { FooterPosition } from "./FooterPosition";
 import type { PivotConfig } from "./PivotTypes";
-export interface SimpleTableProps {
+export interface SimpleTableProps<TData extends RowData = Row> {
     animations?: AnimationsConfig;
     autoExpandColumns?: boolean;
-    canExpandRowGroup?: (row: Row) => boolean;
+    canExpandRowGroup?: (row: TData) => boolean;
     cellUpdateFlash?: boolean;
     className?: string;
     columnBorders?: boolean;
     columnEditorConfig?: ColumnEditorConfig;
     columnReordering?: boolean;
     columnResizing?: boolean;
-    /** Column definitions. */
-    columns?: ColumnDef[];
+    /** Column definitions. Mixed per-column TValue uses `any` on the column union. */
+    columns?: ColumnDef<TData, any>[];
     copyHeadersToClipboard?: boolean;
     customTheme?: CustomThemeProps;
     /** Show the column editor / visibility UI. */
     enableColumnEditor?: boolean;
     /** Open the column editor when the table loads. */
     enableColumnEditorInitOpen?: boolean;
-    emptyStateRenderer?: EmptyStateRenderer;
+    emptyStateRenderer?: EmptyStateRenderer<TData>;
     enableHeaderEditing?: boolean;
     /** Enable client-side pagination. */
     enablePagination?: boolean;
@@ -71,7 +72,7 @@ export interface SimpleTableProps {
      * Default true.
      */
     enableVirtualization?: boolean;
-    errorStateRenderer?: ErrorStateRenderer;
+    errorStateRenderer?: ErrorStateRenderer<TData>;
     expandAll?: boolean;
     externalFilterHandling?: boolean;
     externalSortHandling?: boolean;
@@ -97,41 +98,46 @@ export interface SimpleTableProps {
     initialSortColumn?: string;
     initialSortDirection?: SortDirection;
     isLoading?: boolean;
-    loadingStateRenderer?: LoadingStateRenderer;
+    loadingStateRenderer?: LoadingStateRenderer<TData>;
     maxHeight?: string | number;
     /** Alternate column background. */
     oddColumnBackground?: boolean;
     /** Alternate odd/even row backgrounds. */
     oddEvenRowBackground?: boolean;
-    onCellClick?: (props: CellClickProps) => void;
-    onCellEdit?: (props: CellChangeProps) => void;
-    onColumnOrderChange?: (newHeaders: ColumnDef[]) => void;
-    onColumnSelect?: (header: ColumnDef) => void;
+    onCellClick?: (props: CellClickProps<TData>) => void;
+    onCellEdit?: (props: CellChangeProps<TData>) => void;
+    onColumnOrderChange?: (newHeaders: ColumnDef<TData, any>[]) => void;
+    onColumnSelect?: (header: ColumnDef<TData, any>) => void;
     onColumnVisibilityChange?: (visibilityState: ColumnVisibilityState) => void;
-    onColumnWidthChange?: (headers: ColumnDef[]) => void;
-    onFilterChange?: (filters: TableFilterState) => void;
+    onColumnWidthChange?: (headers: ColumnDef<TData, any>[]) => void;
+    onFilterChange?: (filters: TableFilterState<TData>) => void;
     /** Called once when the table is ready. */
     onTableReady?: () => void;
-    onHeaderEdit?: (header: ColumnDef, newLabel: string) => void;
+    onHeaderEdit?: (header: ColumnDef<TData, any>, newLabel: string) => void;
     infiniteScrollThreshold?: number;
     onLoadMore?: () => void;
     onNextPage?: OnNextPage;
     onPageChange?: (page: number) => void | Promise<void>;
-    onRowGroupExpand?: (props: OnRowGroupExpandProps) => void | Promise<void>;
-    onRowSelectionChange?: (props: RowSelectionChangeProps) => void;
+    onRowGroupExpand?: (props: OnRowGroupExpandProps<TData>) => void | Promise<void>;
+    onRowSelectionChange?: (props: RowSelectionChangeProps<TData>) => void;
     onSortChange?: (sort: SortColumn | null) => void;
     /**
      * Declarative matrix pivot. When set, flat `rows` are reshaped into a
      * pivoted grid with dynamic columns. Ignores consumer `rowGrouping` while active.
      */
-    pivot?: PivotConfig | null;
+    pivot?: PivotConfig<TData> | null;
     /** Fired when pivot config changes via TableAPI.setPivot. */
-    onPivotChange?: (pivot: PivotConfig | null) => void;
+    onPivotChange?: (pivot: PivotConfig<TData> | null) => void;
     quickFilter?: QuickFilterConfig;
-    rowButtons?: RowButton[];
-    rowGrouping?: Accessor[];
-    getRowId?: GetRowId;
-    rows: Row[];
+    rowButtons?: RowButton<TData>[];
+    /**
+     * Property names that define the row grouping hierarchy.
+     * `Accessor<TData>` keeps keyof autocomplete; the `string & {}` arm still
+     * allows dynamic / heterogeneous nesting keys and pivot-injected keys.
+     */
+    rowGrouping?: Accessor<TData>[];
+    getRowId?: GetRowId<TData>;
+    rows: TData[];
     rowsPerPage?: number;
     scrollParent?: HTMLElement | "window" | (() => HTMLElement | null);
     selectableCells?: boolean;

package/dist/types/TableAPI.d.ts

@@ -2,6 +2,7 @@ import UpdateDataProps from "./UpdateCellProps";
 import ColumnDef, { Accessor } from "./ColumnDef";
 import TableRow from "./TableRow";
 import Row from "./Row";
+import type { RowData } from "./Row";
 import SortColumn, { SortDirection } from "./SortColumn";
 import { TableFilterState, FilterCondition } from "./FilterTypes";
 import Cell from "./Cell";
@@ -9,31 +10,31 @@ import type { PinnedSectionsState } from "./PinnedSectionsState";
 import type { PivotConfig } from "./PivotTypes";
 import type { ColumnVisibilityState } from "./ColumnVisibilityTypes";
 import type { RowId } from "./RowId";
-export interface SetHeaderRenameProps {
-    accessor: Accessor;
+export interface SetHeaderRenameProps<TData extends RowData = Row> {
+    accessor: Accessor<TData>;
 }
 export interface ExportToCSVProps {
     filename?: string;
 }
-export type TableAPI = {
-    updateData: (props: UpdateDataProps) => void;
-    setHeaderRename: (props: SetHeaderRenameProps) => void;
-    getVisibleRows: () => TableRow[];
-    getAllRows: () => TableRow[];
-    getHeaders: () => ColumnDef[];
+export type TableAPI<TData extends RowData = Row> = {
+    updateData: (props: UpdateDataProps<TData>) => void;
+    setHeaderRename: (props: SetHeaderRenameProps<TData>) => void;
+    getVisibleRows: () => TableRow<TData>[];
+    getAllRows: () => TableRow<TData>[];
+    getHeaders: () => ColumnDef<TData, any>[];
     exportToCSV: (props?: ExportToCSVProps) => void;
     getSortState: () => SortColumn | null;
     applySortState: (props?: {
-        accessor: Accessor;
+        accessor: Accessor<TData>;
         direction?: SortDirection;
     }) => Promise<void>;
     /** Ordered root accessors per pin section (left, main/unpinned, right) */
     getPinnedState: () => PinnedSectionsState;
     /** Reorder root columns and set pinned flags; lists must include every root accessor exactly once. Essential order is clamped per section. */
     applyPinnedState: (state: PinnedSectionsState) => Promise<void>;
-    getFilterState: () => TableFilterState;
-    applyFilter: (filter: FilterCondition) => Promise<void>;
-    clearFilter: (accessor: Accessor) => Promise<void>;
+    getFilterState: () => TableFilterState<TData>;
+    applyFilter: (filter: FilterCondition<TData>) => Promise<void>;
+    clearFilter: (accessor: Accessor<TData>) => Promise<void>;
     clearAllFilters: () => Promise<void>;
     getCurrentPage: () => number;
     getTotalPages: () => number;
@@ -45,8 +46,8 @@ export type TableAPI = {
     toggleDepth: (depth: number) => void;
     setExpandedDepths: (depths: Set<number>) => void;
     getExpandedDepths: () => Set<number>;
-    getGroupingProperty: (depth: number) => Accessor | undefined;
-    getGroupingDepth: (property: Accessor) => number;
+    getGroupingProperty: (depth: number) => Accessor<TData> | undefined;
+    getGroupingDepth: (property: Accessor<TData>) => number;
     toggleColumnEditor: (open?: boolean) => void;
     applyColumnVisibility: (visibility: ColumnVisibilityState) => Promise<void>;
     /**
@@ -67,19 +68,23 @@ export type TableAPI = {
      */
     getSelectedRows: () => Set<RowId>;
     /** Row data objects for currently selected rows (resolved from visible/current table rows). */
-    getSelectedRowsData: () => Row[];
+    getSelectedRowsData: () => TData[];
     /** Look up a row by row id in the current table rows. */
-    getRow: (rowId: RowId) => Row | undefined;
+    getRow: (rowId: RowId) => TData | undefined;
     selectRow: (rowId: RowId) => void;
     deselectRow: (rowId: RowId) => void;
     toggleRowSelection: (rowId: RowId) => void;
     /** Clears row selection only (does not clear cell selection). */
     clearRowSelection: () => void;
     /** Enable, update, or clear matrix pivot (`null` disables). */
-    setPivot: (config: PivotConfig | null) => void;
-    getPivot: () => PivotConfig | null;
+    setPivot: (config: PivotConfig<TData> | null) => void;
+    getPivot: () => PivotConfig<TData> | null;
     /** Generated headers while pivot is active; otherwise current headers. */
     getPivotHeaders: () => ColumnDef[];
-    /** Post-pivot rows (pre-flatten) while pivot is active; otherwise source rows. */
+    /**
+     * Post-pivot rows (pre-flatten) while pivot is active; otherwise source rows.
+     * Always {@link Row} — pivot injects synthetic keys (e.g. `__pivotChildren`)
+     * that are not part of consumer `TData`.
+     */
     getPivotedRows: () => Row[];
 };

package/dist/types/TableRow.d.ts

@@ -1,13 +1,14 @@
 import Row from "./Row";
+import type { RowData } from "./Row";
 import RowState from "./RowState";
 import ColumnDef, { Accessor } from "./ColumnDef";
-type TableRow = {
+type TableRow<TData extends RowData = Row> = {
     depth: number;
     displayPosition: number;
     groupingKey?: string;
     isLastGroupRow: boolean;
     position: number;
-    row: Row;
+    row: TData;
     rowId: (string | number)[];
     /**
      * Position-independent identity for the row, used as the basis for the
@@ -23,12 +24,12 @@ type TableRow = {
     rowIndexPath?: number[];
     stateIndicator?: {
         parentRowId: string | number;
-        parentRow: Row;
+        parentRow: TData;
         state: RowState;
     };
     isLoadingSkeleton?: boolean;
     nestedTable?: {
-        parentRow: Row;
+        parentRow: TData;
         expandableHeader: ColumnDef;
         childAccessor: Accessor;
         calculatedHeight: number;

package/dist/types/UpdateCellProps.d.ts

@@ -1,8 +1,10 @@
 import { CellValue } from "..";
 import { Accessor } from "./ColumnDef";
+import type Row from "./Row";
+import type { RowData } from "./Row";
 import type { RowId } from "./RowId";
-type UpdateDataBase = {
-    accessor: Accessor;
+type UpdateDataBase<TData extends RowData = Row> = {
+    accessor: Accessor<TData>;
     newValue: CellValue;
 };
 /**
@@ -10,7 +12,7 @@ type UpdateDataBase = {
  * When both are provided, `rowId` wins. `rowIndex` is the index into the
  * unsorted source `rows` array — not the sorted/visible position.
  */
-type UpdateDataProps = UpdateDataBase & ({
+type UpdateDataProps<TData extends RowData = Row> = UpdateDataBase<TData> & ({
     rowId: RowId;
     rowIndex?: number;
 } | {

package/dist/utils/columnEditor/columnEditorUtils.d.ts

@@ -17,6 +17,9 @@ export type HoveredSeparator = {
 } | null;
 export declare const findAndMarkParentsVisible: (headers: ColumnDef[], childAccessor: Accessor, visited?: Set<string>) => void;
 export declare const areAllChildrenHidden: (children: ColumnDef[]) => boolean;
+export declare const areAllChildrenVisible: (children: ColumnDef[]) => boolean;
+/** Recursively marks every header in the subtree as visible. */
+export declare const showAllDescendants: (children: ColumnDef[]) => void;
 export declare const updateParentHeaders: (headers: ColumnDef[]) => void;
 export declare const buildColumnVisibilityState: (headers: ColumnDef[]) => ColumnVisibilityState;
 export declare const findClosestValidSeparatorIndex: ({ flattenedHeaders, draggingRow, hoveredRowIndex, isTopHalfOfRow, }: {

package/dist/utils/columnEditor/createCheckbox.d.ts

@@ -3,19 +3,24 @@
  */
 export interface CreateCheckboxOptions {
     checked: boolean;
+    /** When true, shows a minus mark and sets aria-checked="mixed" (partial selection). */
+    indeterminate?: boolean;
     onChange: (checked: boolean) => void;
     ariaLabel?: string;
 }
 /** Shared checkmark SVG for checkbox custom visual (used by createCheckbox and update helpers). */
 export declare const createCheckmarkSVG: () => SVGSVGElement;
+/** Shared minus SVG for indeterminate checkbox custom visual. */
+export declare const createMinusSVG: () => SVGSVGElement;
 /**
  * Updates an existing checkbox DOM (created by createCheckbox) to match the given checked state.
  * Use when the checkbox element is reused (e.g. from cache) and selection state changed.
+ * Clears any indeterminate state.
  * @param container - Element that contains .st-checkbox-input and .st-checkbox-custom (the label or a parent)
  */
 export declare const updateCheckboxElement: (container: HTMLElement, checked: boolean) => void;
-export declare const createCheckbox: ({ checked, onChange, ariaLabel }: CreateCheckboxOptions) => {
+export declare const createCheckbox: ({ checked, indeterminate, onChange, ariaLabel, }: CreateCheckboxOptions) => {
     element: HTMLLabelElement;
-    update: (newChecked: boolean) => void;
+    update: (newChecked: boolean, newIndeterminate?: boolean) => void;
     destroy: () => void;
 };

package/dist/utils/normalizeConfig.d.ts

@@ -1,14 +1,17 @@
 import type ColumnDef from "../types/ColumnDef";
 import type { SimpleTableConfig } from "../types/SimpleTableConfig";
+import type Row from "../types/Row";
+import type { RowData } from "../types/Row";
 /**
  * Consumer-facing config input. Preferred prop names only — no legacy aliases.
  */
-export type SimpleTableConfigInput = SimpleTableConfig;
+export type SimpleTableConfigInput<TData extends RowData = Row> = SimpleTableConfig<TData>;
 /** Pass-through for column trees (kept for call-site stability / future transforms). */
 export declare function normalizeColumnDef(header: ColumnDef): ColumnDef;
 export declare function normalizeColumnDefs(headers: ColumnDef[]): ColumnDef[];
 /**
  * Validate and normalize config. Requires `columns`.
+ * Runtime always normalizes to the default {@link Row}-shaped config.
  */
 export declare function normalizeConfig(input: SimpleTableConfigInput): SimpleTableConfig;
 /**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "simple-table-core",
-  "version": "4.0.8",
+  "version": "4.1.0",
   "main": "dist/cjs/index.js",
   "module": "dist/index.es.js",
   "types": "dist/index.d.ts",