@toolbox-web/grid 0.0.7 → 0.1.1

package/README.md

@@ -506,7 +506,7 @@ For architecture details, rendering pipeline, and plugin development, see [ARCHI
 This grid is built and maintained by a single developer in spare time. If it saves you time or money, consider sponsoring to keep development going:
 
 [![GitHub Sponsors](https://img.shields.io/badge/Sponsor_on_GitHub-ea4aaa?style=for-the-badge&logo=github)](https://github.com/sponsors/OysteinAmundsen)
-[![Patreon](https://img.shields.io/badge/Support_on_Patreon-f96854?style=for-the-badge&logo=patreon)](https://patreon.com/user?u=40656340)
+[![Patreon](https://img.shields.io/badge/Support_on_Patreon-f96854?style=for-the-badge&logo=patreon)](https://www.patreon.com/c/OysteinAmundsen)
 
 **What sponsorship enables:**
 

package/all.d.ts

@@ -6,6 +6,12 @@ export declare interface ActivateCellDetail {
     col: number;
 }
 
+/** Available aggregation function types */
+declare type AggFunc = 'sum' | 'avg' | 'count' | 'min' | 'max' | 'first' | 'last';
+
+/** Available aggregation function types */
+declare type AggFunc_2 = 'sum' | 'avg' | 'count' | 'min' | 'max' | 'first' | 'last';
+
 /**
  * Configuration for an aggregation row (footer/header row with computed values).
  * Replaces the core FooterRowConfig functionality.
@@ -1494,8 +1500,6 @@ export declare interface ChangedRowsResetDetail<TRow = any> {
  */
 /** Configuration options for the clipboard plugin */
 declare interface ClipboardConfig {
-    /** Whether clipboard functionality is enabled (default: true) */
-    enabled?: boolean;
     /** Include column headers in copied text (default: false) */
     includeHeaders?: boolean;
     /** Column delimiter character (default: '\t' for tab) */
@@ -1751,8 +1755,6 @@ declare type ColumnViewRenderer_2<TRow = any, TValue = any> = (ctx: CellRenderCo
  */
 /** Configuration options for the column virtualization plugin */
 declare interface ColumnVirtualizationConfig {
-    /** Whether the plugin is enabled (default: true) */
-    enabled?: boolean;
     /** Auto-enable when column count exceeds threshold (default: true) */
     autoEnable?: boolean;
     /** Column count threshold for auto-enabling (default: 30) */
@@ -1816,8 +1818,6 @@ export declare class ColumnVirtualizationPlugin extends BaseGridPlugin_2<ColumnV
  * Configuration options for the context menu plugin.
  */
 declare interface ContextMenuConfig {
-    /** Whether the context menu is enabled (default: true) */
-    enabled?: boolean;
     /** Menu items - static array or function returning items */
     items?: ContextMenuItem_3[] | ((params: ContextMenuParams_3) => ContextMenuItem_3[]);
 }
@@ -1959,6 +1959,11 @@ export declare class ContextMenuPlugin extends BaseGridPlugin_2<ContextMenuConfi
     attach(grid: GridElement_2): void;
     detach(): void;
     private installGlobalHandlers;
+    /**
+     * Clean up global handlers when the last instance detaches.
+     * Uses reference counting to ensure handlers persist while any grid uses the plugin.
+     */
+    private uninstallGlobalHandlers;
     afterRender(): void;
     /**
      * Programmatically show the context menu at the specified position.
@@ -2207,23 +2212,37 @@ export declare class DataGridElement<T = any> extends HTMLElement implements Int
      * Clears all user modifications (order, width, visibility, sort).
      */
     resetColumnState(): void;
+    /**
+     * Check if the tool panel is currently open.
+     */
+    get isToolPanelOpen(): boolean;
     /**
      * Get the currently active tool panel ID, or null if none is open.
+     * @deprecated Use isToolPanelOpen and expandedToolPanelSections instead.
      */
     get activeToolPanel(): string | null;
     /**
-     * Open a tool panel by ID.
-     * Closes any currently open panel first.
+     * Get the IDs of expanded accordion sections.
+     */
+    get expandedToolPanelSections(): string[];
+    /**
+     * Open the tool panel (accordion view with all registered panels).
      */
-    openToolPanel(panelId: string): void;
+    openToolPanel(): void;
     /**
-     * Close the currently open tool panel.
+     * Close the tool panel.
      */
     closeToolPanel(): void;
     /**
-     * Toggle a tool panel open/closed.
+     * Toggle the tool panel open/closed.
+     */
+    toggleToolPanel(): void;
+    /**
+     * Toggle an accordion section expanded/collapsed.
+     * Only one section can be expanded at a time (exclusive accordion).
+     * When there's only one panel, toggling is disabled (always expanded).
      */
-    toggleToolPanel(panelId: string): void;
+    toggleToolPanelSection(sectionId: string): void;
     /**
      * Get registered tool panel definitions.
      */
@@ -2364,8 +2383,6 @@ declare interface EditorExecContext<T = any> extends CellContext<T> {
 
 /** Configuration options for the export plugin */
 declare interface ExportConfig {
-    /** Whether export is enabled (default: true) */
-    enabled?: boolean;
     /** Default file name for exports (default: 'export') */
     fileName?: string;
     /** Include column headers in export (default: true) */
@@ -2505,8 +2522,6 @@ export declare interface ExternalMountViewDetail<TRow = any> {
 
 /** Configuration options for the filtering plugin */
 export declare interface FilterConfig {
-    /** Whether filtering is enabled (default: true) */
-    enabled?: boolean;
     /** Debounce delay in ms for filter input (default: 300) */
     debounceMs?: number;
     /** Whether text filtering is case sensitive (default: false) */
@@ -2521,8 +2536,6 @@ export declare interface FilterConfig {
 
 /** Configuration options for the filtering plugin */
 declare interface FilterConfig_2 {
-    /** Whether filtering is enabled (default: true) */
-    enabled?: boolean;
     /** Debounce delay in ms for filter input (default: 300) */
     debounceMs?: number;
     /** Whether text filtering is case sensitive (default: false) */
@@ -2645,7 +2658,7 @@ export declare class FilteringPlugin extends BaseGridPlugin_2<FilterConfig_2> {
      * Apply filter state from column state.
      */
     applyColumnState(field: string, state: ColumnState_2): void;
-    readonly styles = "\n    .header-cell.filtered::before {\n      content: '';\n      position: absolute;\n      top: 4px;\n      right: 4px;\n      width: 6px;\n      height: 6px;\n      background: var(--tbw-filter-accent, var(--tbw-color-accent, #3b82f6));\n      border-radius: 50%;\n    }\n    .tbw-filter-btn {\n      display: inline-flex;\n      align-items: center;\n      justify-content: center;\n      background: transparent;\n      border: none;\n      cursor: pointer;\n      padding: 2px;\n      margin-left: 4px;\n      opacity: 0.4;\n      transition: opacity 0.15s;\n      color: inherit;\n      vertical-align: middle;\n    }\n    .tbw-filter-btn:hover,\n    .tbw-filter-btn.active {\n      opacity: 1;\n    }\n    .tbw-filter-btn.active {\n      color: var(--tbw-filter-accent, var(--tbw-color-accent, #3b82f6));\n    }\n  ";
+    readonly styles: string;
 }
 
 /** Filter model representing a single filter condition */
@@ -2795,6 +2808,15 @@ declare interface GetRowsResult_2 {
     lastRow?: number;
 }
 
+/**
+ * Get a value-based aggregator function.
+ * Used by Pivot plugin and other features that aggregate pre-extracted values.
+ *
+ * @param aggFunc - Aggregation function name ('sum', 'avg', 'count', 'min', 'max', 'first', 'last')
+ * @returns Aggregator function that takes number[] and returns number
+ */
+export declare function getValueAggregator(aggFunc: string): ValueAggregatorFn;
+
 /**
  * CSS class names used in the grid's shadow DOM.
  * Use these when adding/removing classes or querying elements.
@@ -3005,6 +3027,8 @@ export declare interface GridIcons {
     submenuArrow?: IconValue;
     /** Drag handle icon for reordering. Default: '⋮⋮' */
     dragHandle?: IconValue;
+    /** Tool panel toggle icon in toolbar. Default: '☰' */
+    toolPanel?: IconValue;
 }
 
 /**
@@ -3026,6 +3050,8 @@ declare interface GridIcons_2 {
     submenuArrow?: IconValue_2;
     /** Drag handle icon for reordering. Default: '⋮⋮' */
     dragHandle?: IconValue_2;
+    /** Tool panel toggle icon in toolbar. Default: '☰' */
+    toolPanel?: IconValue_2;
 }
 
 /**
@@ -3065,8 +3091,6 @@ declare interface GroupHeaderRenderParams {
 
 /** Configuration options for the column groups plugin */
 declare interface GroupingColumnsConfig {
-    /** Whether the plugin is enabled (default: true) */
-    enabled?: boolean;
     /** Custom group header renderer */
     groupHeaderRenderer?: (params: GroupHeaderRenderParams) => HTMLElement | string | void;
     /** Whether to show group borders (default: true) */
@@ -3117,13 +3141,11 @@ export declare class GroupingColumnsPlugin extends BaseGridPlugin_2<GroupingColu
      * Refresh column groups (recompute from current columns).
      */
     refresh(): void;
-    readonly styles = "\n    .header-group-row {\n      display: grid;\n      grid-auto-flow: column;\n      background: var(--tbw-grouping-columns-header-bg, var(--tbw-color-header-bg));\n      border-bottom: 1px solid var(--tbw-grouping-columns-border, var(--tbw-color-border));\n    }\n    .header-group-cell {\n      display: flex;\n      align-items: center;\n      justify-content: center;\n      padding: 4px 8px;\n      font-weight: 600;\n      font-size: 0.9em;\n      text-transform: uppercase;\n      letter-spacing: 0.5px;\n      border-right: 1px solid var(--tbw-grouping-columns-border, var(--tbw-color-border));\n    }\n    .header-group-cell:last-child {\n      border-right: none;\n    }\n    .header-row .cell.grouped {\n      border-top: none;\n    }\n    .header-row .cell.group-end {\n      border-right: 2px solid var(--tbw-grouping-columns-separator, var(--tbw-color-border-strong));\n    }\n  ";
+    readonly styles: string;
 }
 
 /** Configuration options for the row grouping plugin */
 export declare interface GroupingRowsConfig {
-    /** Whether the plugin is enabled (default: true) */
-    enabled?: boolean;
     /**
      * Callback to determine group path for a row.
      * Return an array of group keys, a single key, null/false to skip grouping.
@@ -3147,8 +3169,6 @@ export declare interface GroupingRowsConfig {
 
 /** Configuration options for the row grouping plugin */
 declare interface GroupingRowsConfig_2 {
-    /** Whether the plugin is enabled (default: true) */
-    enabled?: boolean;
     /**
      * Callback to determine group path for a row.
      * Return an array of group keys, a single key, null/false to skip grouping.
@@ -3269,7 +3289,7 @@ export declare class GroupingRowsPlugin extends BaseGridPlugin_2<GroupingRowsCon
      * @param fn - The groupOn function or undefined to disable
      */
     setGroupOn(fn: ((row: any) => any[] | any | null | false) | undefined): void;
-    readonly styles = "\n    .group-row {\n      background: var(--tbw-grouping-rows-bg, var(--tbw-color-panel-bg));\n      font-weight: 500;\n    }\n    .group-row:hover {\n      background: var(--tbw-grouping-rows-bg-hover, var(--tbw-color-row-hover));\n    }\n    .group-toggle {\n      cursor: pointer;\n      user-select: none;\n      display: inline-flex;\n      align-items: center;\n      justify-content: center;\n      width: 20px;\n      height: 20px;\n      margin-right: 4px;\n      font-size: 10px;\n    }\n    .group-toggle:hover {\n      background: var(--tbw-grouping-rows-toggle-hover, var(--tbw-color-row-hover));\n      border-radius: 2px;\n    }\n    .group-label {\n      display: inline-flex;\n      align-items: center;\n      gap: 8px;\n    }\n    .group-count {\n      color: var(--tbw-grouping-rows-count-color, var(--tbw-color-fg-muted));\n      font-size: 0.85em;\n      font-weight: normal;\n    }\n    [data-group-depth=\"0\"] .group-label { padding-left: 0; }\n    [data-group-depth=\"1\"] .group-label { padding-left: 20px; }\n    [data-group-depth=\"2\"] .group-label { padding-left: 40px; }\n    [data-group-depth=\"3\"] .group-label { padding-left: 60px; }\n    [data-group-depth=\"4\"] .group-label { padding-left: 80px; }\n  ";
+    readonly styles: string;
 }
 
 /** Group row model item */
@@ -3467,8 +3487,6 @@ export declare const listAggregators: () => string[];
  */
 /** Configuration options for the master-detail plugin */
 declare interface MasterDetailConfig {
-    /** Whether master-detail functionality is enabled (default: true) */
-    enabled?: boolean;
     /** Renderer function that returns detail content for a row */
     detailRenderer?: (row: any, rowIndex: number) => HTMLElement | string;
     /** Height of the detail row - number (pixels) or 'auto' (default: 'auto') */
@@ -3565,13 +3583,11 @@ export declare class MasterDetailPlugin extends BaseGridPlugin_2<MasterDetailCon
      * @returns The detail HTMLElement or undefined
      */
     getDetailElement(rowIndex: number): HTMLElement | undefined;
-    readonly styles = "\n    .master-detail-cell-wrapper {\n      display: flex;\n      align-items: center;\n      gap: 4px;\n    }\n    .master-detail-toggle {\n      cursor: pointer;\n      font-size: 10px;\n      opacity: 0.7;\n      user-select: none;\n    }\n    .master-detail-toggle:hover {\n      opacity: 1;\n    }\n    .master-detail-row {\n      grid-column: 1 / -1;\n      display: grid;\n      background: var(--tbw-master-detail-bg, var(--tbw-color-row-alt));\n      border-bottom: 1px solid var(--tbw-master-detail-border, var(--tbw-color-border));\n    }\n    .master-detail-cell {\n      padding: 16px;\n      overflow: auto;\n    }\n  ";
+    readonly styles: string;
 }
 
 /** Configuration options for the multi-sort plugin */
 export declare interface MultiSortConfig {
-    /** Whether multi-sort is enabled (default: true) */
-    enabled?: boolean;
     /** Maximum number of columns to sort by (default: 3) */
     maxSortColumns?: number;
     /** Whether to show sort order badges (1, 2, 3) on headers (default: true) */
@@ -3580,8 +3596,6 @@ export declare interface MultiSortConfig {
 
 /** Configuration options for the multi-sort plugin */
 declare interface MultiSortConfig_2 {
-    /** Whether multi-sort is enabled (default: true) */
-    enabled?: boolean;
     /** Maximum number of columns to sort by (default: 3) */
     maxSortColumns?: number;
     /** Whether to show sort order badges (1, 2, 3) on headers (default: true) */
@@ -3640,7 +3654,7 @@ export declare class MultiSortPlugin extends BaseGridPlugin_2<MultiSortConfig_2>
      * Rebuilds the sort model from all column states.
      */
     applyColumnState(field: string, state: ColumnState_2): void;
-    readonly styles = "\n    .header-cell[data-sort=\"asc\"]::after {\n      content: '\u2191';\n      margin-left: 4px;\n      opacity: 0.8;\n    }\n    .header-cell[data-sort=\"desc\"]::after {\n      content: '\u2193';\n      margin-left: 4px;\n      opacity: 0.8;\n    }\n    .sort-index {\n      font-size: 10px;\n      background: var(--tbw-multi-sort-badge-bg, var(--tbw-color-panel-bg));\n      color: var(--tbw-multi-sort-badge-color, var(--tbw-color-fg));\n      border-radius: 50%;\n      width: 14px;\n      height: 14px;\n      display: inline-flex;\n      align-items: center;\n      justify-content: center;\n      margin-left: 2px;\n      font-weight: 600;\n    }\n  ";
+    readonly styles: string;
 }
 
 /**
@@ -3650,8 +3664,6 @@ export declare class MultiSortPlugin extends BaseGridPlugin_2<MultiSortConfig_2>
  */
 /** Configuration options for the pinned columns plugin */
 declare interface PinnedColumnsConfig {
-    /** Whether the plugin is enabled (default: true) */
-    enabled?: boolean;
 }
 
 /**
@@ -3698,8 +3710,6 @@ export declare class PinnedColumnsPlugin extends BaseGridPlugin_2<PinnedColumnsC
 
 /** Configuration options for the status bar plugin */
 declare interface PinnedRowsConfig {
-    /** Whether the status bar is enabled (default: false) */
-    enabled?: boolean;
     /** Position of the info bar (default: 'bottom') */
     position?: PinnedRowsPosition;
     /** Show total row count in info bar (default: true) */
@@ -3825,28 +3835,38 @@ export declare class PinnedRowsPlugin extends BaseGridPlugin_2<PinnedRowsConfig>
      * @param id - The aggregation row ID to remove
      */
     removeAggregationRow(id: string): void;
-    readonly styles = "\n    .tbw-footer {\n      position: sticky;\n      bottom: 0;\n      z-index: var(--tbw-z-layer-pinned-rows, 20);\n      background: var(--tbw-color-panel-bg);\n    }\n\n    .tbw-pinned-rows {\n      display: flex;\n      align-items: center;\n      justify-content: space-between;\n      padding: 8px 12px;\n      background: var(--tbw-pinned-rows-bg, var(--tbw-color-panel-bg));\n      border-top: 1px solid var(--tbw-pinned-rows-border, var(--tbw-color-border));\n      font-size: 12px;\n      color: var(--tbw-pinned-rows-color, var(--tbw-color-fg-muted));\n      min-height: 32px;\n      box-sizing: border-box;\n      min-width: fit-content;\n    }\n    .tbw-pinned-rows-left,\n    .tbw-pinned-rows-center,\n    .tbw-pinned-rows-right {\n      display: flex;\n      align-items: center;\n      gap: 16px;\n    }\n    .tbw-pinned-rows-left {\n      justify-content: flex-start;\n    }\n    .tbw-pinned-rows-center {\n      justify-content: center;\n      flex: 1;\n    }\n    .tbw-pinned-rows-right {\n      justify-content: flex-end;\n    }\n    .tbw-status-panel {\n      white-space: nowrap;\n    }\n\n    .tbw-aggregation-rows {\n      min-width: fit-content;\n      background: var(--tbw-aggregation-bg, var(--tbw-color-header-bg));\n    }\n    .tbw-aggregation-rows-top {\n      border-bottom: 1px solid var(--tbw-aggregation-border, var(--tbw-color-border));\n    }\n    .tbw-aggregation-rows-bottom {\n      border-top: 1px solid var(--tbw-aggregation-border, var(--tbw-color-border));\n    }\n    .tbw-aggregation-row {\n      display: grid;\n      grid-template-columns: var(--tbw-column-template);\n      font-weight: var(--tbw-aggregation-font-weight, 600);\n    }\n    .tbw-aggregation-cell {\n      padding: var(--tbw-cell-padding, 2px 8px);\n      min-height: var(--tbw-row-height, 28px);\n      display: flex;\n      align-items: center;\n      border-right: 1px solid var(--tbw-color-border-cell);\n    }\n    .tbw-aggregation-cell:last-child {\n      border-right: 0;\n    }\n    .tbw-aggregation-cell-full {\n      grid-column: 1 / -1;\n      border-right: 0;\n    }\n  ";
+    readonly styles: string;
 }
 
 /** Position of the status bar relative to the grid */
 declare type PinnedRowsPosition = 'top' | 'bottom';
 
 export declare interface PivotConfig {
-    enabled?: boolean;
+    /** Whether pivot view is active on load (default: true when fields are configured) */
+    active?: boolean;
     rowGroupFields?: string[];
     columnGroupFields?: string[];
     valueFields?: PivotValueField[];
     showTotals?: boolean;
     showGrandTotal?: boolean;
+    /** Whether groups are expanded by default (default: true) */
+    defaultExpanded?: boolean;
+    /** Indent width per depth level in pixels (default: 20) */
+    indentWidth?: number;
 }
 
 declare interface PivotConfig_2 {
-    enabled?: boolean;
+    /** Whether pivot view is active on load (default: true when fields are configured) */
+    active?: boolean;
     rowGroupFields?: string[];
     columnGroupFields?: string[];
     valueFields?: PivotValueField_2[];
     showTotals?: boolean;
     showGrandTotal?: boolean;
+    /** Whether groups are expanded by default (default: true) */
+    defaultExpanded?: boolean;
+    /** Indent width per depth level in pixels (default: 20) */
+    indentWidth?: number;
 }
 
 declare type PivotDataRow = Record<string, unknown>;
@@ -3866,50 +3886,73 @@ declare type PivotDataRow = Record<string, unknown>;
 export declare class PivotPlugin extends BaseGridPlugin_2<PivotConfig_2> {
     readonly name = "pivot";
     readonly version = "1.0.0";
+    /** Tool panel ID for shell integration */
+    static readonly PANEL_ID = "pivot";
     protected get defaultConfig(): Partial<PivotConfig_2>;
     private isActive;
+    private hasInitialized;
     private pivotResult;
-    private columnHeaders;
-    private rowHeaders;
+    private fieldHeaderMap;
+    private expandedKeys;
+    private defaultExpanded;
+    private originalColumns;
+    private panelContainer;
+    private grandTotalFooter;
+    /**
+     * Check if the plugin has valid pivot configuration (at least value fields).
+     */
+    private hasValidPivotConfig;
     detach(): void;
+    getToolPanel(): ToolPanelDefinition_2 | undefined;
     processRows(rows: readonly unknown[]): PivotDataRow[];
     processColumns(columns: readonly ColumnConfig_2[]): ColumnConfig_2[];
+    renderRow(row: Record<string, unknown>, rowEl: HTMLElement): boolean;
     /**
-     * Enable pivot mode.
+     * Remove pivot-specific classes, attributes, and inline styles from a row element.
+     * Called when pivot mode is disabled to clean up reused DOM elements.
+     * Clears innerHTML so the grid's default renderer can rebuild the row.
      */
-    enablePivot(): void;
+    private cleanupPivotStyling;
+    afterRender(): void;
     /**
-     * Disable pivot mode and return to normal grid view.
+     * Render the grand total row as a sticky footer pinned to the bottom.
      */
-    disablePivot(): void;
+    private renderGrandTotalFooter;
     /**
-     * Check if pivot mode is currently active.
+     * Remove the grand total footer element.
      */
+    private cleanupGrandTotalFooter;
+    toggle(key: string): void;
+    expand(key: string): void;
+    collapse(key: string): void;
+    expandAll(): void;
+    collapseAll(): void;
+    isExpanded(key: string): boolean;
+    enablePivot(): void;
+    disablePivot(): void;
     isPivotActive(): boolean;
-    /**
-     * Get the current pivot result.
-     */
     getPivotResult(): PivotResult_2 | null;
-    /**
-     * Set the row group fields for pivoting.
-     * @param fields - Array of field names to group rows by
-     */
     setRowGroupFields(fields: string[]): void;
-    /**
-     * Set the column group fields for pivoting.
-     * @param fields - Array of field names to create columns from
-     */
     setColumnGroupFields(fields: string[]): void;
-    /**
-     * Set the value fields with aggregation functions.
-     * @param fields - Array of value field configurations
-     */
     setValueFields(fields: PivotValueField_2[]): void;
-    /**
-     * Refresh the pivot by clearing cached results.
-     */
     refresh(): void;
-    readonly styles = "\n    [data-pivot-depth=\"1\"] { padding-left: 20px; }\n    [data-pivot-depth=\"2\"] { padding-left: 40px; }\n    [data-pivot-depth=\"3\"] { padding-left: 60px; }\n    .pivot-group-row { font-weight: bold; background: var(--tbw-pivot-group-bg, var(--tbw-color-panel-bg)); }\n    .pivot-total-row { font-weight: bold; border-top: 2px solid var(--tbw-pivot-border, var(--tbw-color-border-strong)); }\n  ";
+    showPanel(): void;
+    hidePanel(): void;
+    togglePanel(): void;
+    isPanelVisible(): boolean;
+    private get gridColumns();
+    private buildFieldHeaderMap;
+    private getAvailableFields;
+    private captureOriginalColumns;
+    private renderPanel;
+    private refreshPanel;
+    private addFieldToZone;
+    private removeFieldFromZone;
+    private removeFromOtherZones;
+    private addValueField;
+    private removeValueField;
+    private updateValueAggFunc;
+    readonly styles: string;
 }
 
 export declare interface PivotResult {
@@ -3927,34 +3970,52 @@ declare interface PivotResult_2 {
 }
 
 declare interface PivotRow {
+    /** Unique key for this row (hierarchical path) */
     rowKey: string;
+    /** Display label for this row */
     rowLabel: string;
+    /** Depth level (0 = top level) */
     depth: number;
+    /** Aggregated values by column key */
     values: Record<string, number | null>;
+    /** Row total across all columns */
     total?: number;
+    /** Whether this row has children (is a group header) */
     isGroup: boolean;
+    /** Child rows (for hierarchical grouping) */
     children?: PivotRow[];
+    /** Number of data rows in this group */
+    rowCount?: number;
 }
 
 declare interface PivotRow_2 {
+    /** Unique key for this row (hierarchical path) */
     rowKey: string;
+    /** Display label for this row */
     rowLabel: string;
+    /** Depth level (0 = top level) */
     depth: number;
+    /** Aggregated values by column key */
     values: Record<string, number | null>;
+    /** Row total across all columns */
     total?: number;
+    /** Whether this row has children (is a group header) */
     isGroup: boolean;
+    /** Child rows (for hierarchical grouping) */
     children?: PivotRow_2[];
+    /** Number of data rows in this group */
+    rowCount?: number;
 }
 
 export declare interface PivotValueField {
     field: string;
-    aggFunc: 'sum' | 'avg' | 'count' | 'min' | 'max' | 'first' | 'last';
+    aggFunc: AggFunc_2;
     header?: string;
 }
 
 declare interface PivotValueField_2 {
     field: string;
-    aggFunc: 'sum' | 'avg' | 'count' | 'min' | 'max' | 'first' | 'last';
+    aggFunc: AggFunc;
     header?: string;
 }
 
@@ -4265,8 +4326,6 @@ declare type RenderRow = GroupRowModelItem | DataRowModelItem;
  */
 /** Configuration options for the reorder plugin */
 declare interface ReorderConfig {
-    /** Whether column reordering is enabled (default: true) */
-    enabled?: boolean;
     /** Whether to animate column movement (default: true) */
     animation?: boolean;
     /** Animation duration in milliseconds (default: 200) */
@@ -4316,7 +4375,7 @@ export declare class ReorderPlugin extends BaseGridPlugin_2<ReorderConfig> {
      * Reset column order to the original configuration order.
      */
     resetColumnOrder(): void;
-    readonly styles = "\n    .header-row > .cell[draggable=\"true\"] {\n      cursor: grab;\n      position: relative;\n    }\n    .header-row > .cell.dragging {\n      opacity: 0.5;\n      cursor: grabbing;\n    }\n    .header-row > .cell.drop-before::before {\n      content: '';\n      position: absolute;\n      left: 0;\n      top: 0;\n      bottom: 0;\n      width: 2px;\n      background: var(--tbw-reorder-indicator, var(--tbw-color-accent));\n      z-index: 1;\n    }\n    .header-row > .cell.drop-after::after {\n      content: '';\n      position: absolute;\n      right: 0;\n      top: 0;\n      bottom: 0;\n      width: 2px;\n      background: var(--tbw-reorder-indicator, var(--tbw-color-accent));\n      z-index: 1;\n    }\n  ";
+    readonly styles: string;
 }
 
 /** Controller managing drag-based column resize lifecycle. */
@@ -4378,6 +4437,15 @@ export declare interface RowGroupRenderConfig {
 
 export declare const runAggregator: (ref: AggregatorRef_2_2 | undefined, rows: any[], field: string, column?: any) => any;
 
+/**
+ * Run a value-based aggregator on a set of values.
+ *
+ * @param aggFunc - Aggregation function name
+ * @param values - Array of numbers to aggregate
+ * @returns Aggregated result
+ */
+export declare function runValueAggregator(aggFunc: string, values: number[]): number;
+
 /**
  * Scroll event
  */
@@ -4524,11 +4592,10 @@ export declare class SelectionPlugin extends BaseGridPlugin_2<SelectionConfig_2>
      * Set selected ranges programmatically.
      */
     setRanges(ranges: CellRange_2[]): void;
-    readonly styles = "\n    /* Prevent text selection during range drag */\n    :host .selecting .data-grid-row > .cell {\n      user-select: none;\n    }\n\n    /* Row selection - use accent color for row focus */\n    :host .data-grid-row.row-focus {\n      background-color: var(--tbw-focus-background, rgba(from var(--tbw-color-accent) r g b / 12%));\n    }\n\n    /* Disable cell-focus outline in row mode - row is the focus unit */\n    :host([data-selection-mode=\"row\"]) .cell-focus {\n      outline: none;\n    }\n\n    /* Selection cell styles - for range mode */\n    :host .data-grid-row > .cell.selected {\n      background-color: var(--tbw-range-selection-bg);\n    }\n    :host .data-grid-row > .cell.selected.top {\n      border-top: 2px solid var(--tbw-range-border-color);\n    }\n    :host .data-grid-row > .cell.selected.bottom {\n      border-bottom: 2px solid var(--tbw-range-border-color);\n    }\n    :host .data-grid-row > .cell.selected.first {\n      border-left: 2px solid var(--tbw-range-border-color);\n    }\n    :host .data-grid-row > .cell.selected.last {\n      border-right: 2px solid var(--tbw-range-border-color);\n    }\n  ";
+    readonly styles: string;
 }
 
 declare interface ServerSideConfig {
-    enabled?: boolean;
     pageSize?: number;
     cacheBlockSize?: number;
     maxConcurrentRequests?: number;
@@ -4716,13 +4783,13 @@ export declare interface ToolPanelConfig {
 export declare interface ToolPanelDefinition {
     /** Unique panel ID */
     id: string;
-    /** Panel title shown in header */
+    /** Panel title shown in accordion header */
     title: string;
-    /** Icon for toolbar button (SVG string or emoji) */
-    icon: string;
-    /** Toolbar button tooltip */
+    /** Icon for accordion section header (optional, emoji or SVG) */
+    icon?: string;
+    /** Tooltip for accordion section header */
     tooltip?: string;
-    /** Panel content factory - called when panel opens */
+    /** Panel content factory - called when panel section opens */
     render: (container: HTMLElement) => void | (() => void);
     /** Called when panel closes (for cleanup) */
     onClose?: () => void;
@@ -4736,13 +4803,13 @@ export declare interface ToolPanelDefinition {
 declare interface ToolPanelDefinition_2 {
     /** Unique panel ID */
     id: string;
-    /** Panel title shown in header */
+    /** Panel title shown in accordion header */
     title: string;
-    /** Icon for toolbar button (SVG string or emoji) */
-    icon: string;
-    /** Toolbar button tooltip */
+    /** Icon for accordion section header (optional, emoji or SVG) */
+    icon?: string;
+    /** Tooltip for accordion section header */
     tooltip?: string;
-    /** Panel content factory - called when panel opens */
+    /** Panel content factory - called when panel section opens */
     render: (container: HTMLElement) => void | (() => void);
     /** Called when panel closes (for cleanup) */
     onClose?: () => void;
@@ -4757,8 +4824,6 @@ declare interface ToolPanelDefinition_2 {
  */
 /** Configuration options for the tree plugin */
 export declare interface TreeConfig {
-    /** Whether tree functionality is enabled (default: true) */
-    enabled?: boolean;
     /** Field name containing child rows (default: 'children') */
     childrenField?: string;
     /** Auto-detect tree structure from data (default: true) */
@@ -4778,8 +4843,6 @@ export declare interface TreeConfig {
  */
 /** Configuration options for the tree plugin */
 declare interface TreeConfig_2 {
-    /** Whether tree functionality is enabled (default: true) */
-    enabled?: boolean;
     /** Field name containing child rows (default: 'children') */
     childrenField?: string;
     /** Auto-detect tree structure from data (default: true) */
@@ -4875,7 +4938,7 @@ export declare class TreePlugin extends BaseGridPlugin_2<TreeConfig_2> {
      * Expand all ancestors of a node to make it visible.
      */
     expandToKey(key: string): void;
-    readonly styles = "\n    .tree-toggle {\n      cursor: pointer;\n      user-select: none;\n      transition: transform 0.2s;\n    }\n    .tree-toggle:hover {\n      color: var(--tbw-tree-accent, var(--tbw-color-accent));\n    }\n  ";
+    readonly styles: string;
 }
 
 /**
@@ -4886,8 +4949,6 @@ export declare class TreePlugin extends BaseGridPlugin_2<TreeConfig_2> {
  */
 /** Configuration for the undo/redo plugin */
 declare interface UndoRedoConfig {
-    /** Whether the plugin is enabled. Default: true */
-    enabled?: boolean;
     /** Maximum number of actions to keep in history. Default: 100 */
     maxHistorySize?: number;
 }
@@ -4960,6 +5021,8 @@ export declare class UndoRedoPlugin extends BaseGridPlugin_2<UndoRedoConfig> {
 
 export declare const unregisterAggregator: (name: string) => void;
 
+export declare type ValueAggregatorFn = (values: number[]) => number;
+
 /** Virtual window bookkeeping; modified in-place as scroll position changes. */
 declare interface VirtualState {
     enabled: boolean;
@@ -4983,8 +5046,6 @@ declare interface VirtualState {
  */
 /** Configuration options for the visibility plugin */
 declare interface VisibilityConfig {
-    /** Whether visibility control is enabled (default: true) */
-    enabled?: boolean;
     /** Allow hiding all columns (default: false) */
     allowHideAll?: boolean;
 }
@@ -5107,7 +5168,7 @@ export declare class VisibilityPlugin extends BaseGridPlugin_2<VisibilityConfig>
      * On drop, emits a 'column-reorder-request' event for other plugins to handle.
      */
     private setupDragListeners;
-    readonly styles = "\n    .tbw-visibility-content {\n      display: flex;\n      flex-direction: column;\n      height: 100%;\n    }\n\n    .tbw-visibility-list {\n      flex: 1;\n      overflow-y: auto;\n      padding: 8px;\n    }\n\n    .tbw-visibility-row {\n      display: flex;\n      align-items: center;\n      gap: 8px;\n      padding: 6px 4px;\n      cursor: pointer;\n      font-size: 13px;\n      border-radius: var(--tbw-border-radius, 4px);\n      position: relative;\n    }\n    .tbw-visibility-row:hover {\n      background: var(--tbw-visibility-hover, var(--tbw-color-row-hover, #f3f4f6));\n    }\n    .tbw-visibility-row input[type=\"checkbox\"] {\n      cursor: pointer;\n    }\n    .tbw-visibility-row.locked span {\n      color: var(--tbw-color-fg-muted, #888);\n    }\n\n    /* Drag handle */\n    .tbw-visibility-handle {\n      cursor: grab;\n      color: var(--tbw-color-fg-muted, #888);\n      font-size: 10px;\n      letter-spacing: -2px;\n      user-select: none;\n      flex-shrink: 0;\n    }\n    .tbw-visibility-row.reorderable:hover .tbw-visibility-handle {\n      color: var(--tbw-color-fg, #1f2937);\n    }\n\n    /* Label wrapper for checkbox and text */\n    .tbw-visibility-label {\n      display: flex;\n      align-items: center;\n      gap: 8px;\n      flex: 1;\n      cursor: pointer;\n    }\n\n    /* Drag states */\n    .tbw-visibility-row.dragging {\n      opacity: 0.5;\n      cursor: grabbing;\n    }\n    .tbw-visibility-row.drop-before::before {\n      content: '';\n      position: absolute;\n      left: 0;\n      right: 0;\n      top: 0;\n      height: 2px;\n      background: var(--tbw-reorder-indicator, var(--tbw-color-accent, #3b82f6));\n    }\n    .tbw-visibility-row.drop-after::after {\n      content: '';\n      position: absolute;\n      left: 0;\n      right: 0;\n      bottom: 0;\n      height: 2px;\n      background: var(--tbw-reorder-indicator, var(--tbw-color-accent, #3b82f6));\n    }\n\n    .tbw-visibility-show-all {\n      margin: 8px;\n      padding: 8px 12px;\n      border: 1px solid var(--tbw-visibility-border, var(--tbw-color-border, #e5e7eb));\n      border-radius: var(--tbw-border-radius, 4px);\n      background: var(--tbw-visibility-btn-bg, var(--tbw-color-header-bg, #f9fafb));\n      color: var(--tbw-color-fg, #1f2937);\n      cursor: pointer;\n      font-size: 13px;\n    }\n    .tbw-visibility-show-all:hover {\n      background: var(--tbw-visibility-hover, var(--tbw-color-row-hover, #f3f4f6));\n    }\n  ";
+    readonly styles: string;
 }
 
 export { }