@toolbox-web/grid 0.2.4 → 0.2.6

package/all.d.ts

@@ -27,10 +27,29 @@ declare interface AggregationRowConfig {
     label?: string;
     /** Static or computed cell values keyed by field */
     cells?: Record<string, unknown | string | ((rows: unknown[], field: string, column?: ColumnConfig_2) => unknown)>;
-    /** Per-field aggregator override; string maps to registered aggregator key */
-    aggregators?: Record<string, AggregatorRef_3>;
+    /**
+     * Per-field aggregator configuration.
+     * Can be a simple string ('sum', 'avg', etc.), a function, or an object with aggFunc and formatter.
+     * @example
+     * aggregators: {
+     *   quantity: 'sum',  // simple built-in
+     *   price: { aggFunc: 'sum', formatter: (v) => `$${v.toFixed(2)}` }  // with formatter
+     * }
+     */
+    aggregators?: Record<string, AggregatorDefinition>;
 }
 
+/** Full aggregator config with optional formatter */
+declare interface AggregatorConfig {
+    /** The aggregator function or built-in key ('sum', 'avg', 'min', 'max', 'count', 'first', 'last') */
+    aggFunc: AggregatorRef_3;
+    /** Optional formatter to format the computed value for display */
+    formatter?: AggregatorFormatter;
+}
+
+/** Aggregator definition - simple string/function or full config object */
+declare type AggregatorDefinition = AggregatorRef_3 | AggregatorConfig;
+
 /**
  * Aggregators Core Registry
  *
@@ -59,6 +78,12 @@ export declare type AggregatorFn = (rows: any[], field: string, column?: any) =>
  */
 declare type AggregatorFn_2 = (rows: any[], field: string, column?: any) => any;
 
+/** Aggregator function signature */
+declare type AggregatorFn_3 = (rows: unknown[], field: string, column?: ColumnConfig_2) => unknown;
+
+/** Aggregator formatter function - formats the computed value for display */
+declare type AggregatorFormatter = (value: unknown, field: string, column?: ColumnConfig_2) => string;
+
 /** Map of field names to aggregator references */
 declare type AggregatorMap = Record<string, AggregatorRef_2>;
 
@@ -71,8 +96,8 @@ declare type AggregatorRef_2 = string | AggregatorFn_2;
 
 declare type AggregatorRef_2_2 = string | AggregatorFn;
 
-/** Aggregator reference - string key for built-in or custom function */
-declare type AggregatorRef_3 = string | ((rows: unknown[], field: string, column?: ColumnConfig_2) => unknown);
+/** Simple aggregator reference - string key for built-in or custom function */
+declare type AggregatorRef_3 = string | AggregatorFn_3;
 
 /**
  * The aggregator registry singleton.
@@ -169,7 +194,7 @@ export declare abstract class BaseGridPlugin<TConfig = unknown> implements GridP
     /** Plugin configuration - merged with defaults in attach() */
     protected config: TConfig;
     /** User-provided configuration from constructor */
-    private readonly userConfig;
+    protected readonly userConfig: Partial<TConfig>;
     /**
      * Default configuration - subclasses should override this getter.
      * Note: This must be a getter (not property initializer) for proper inheritance
@@ -764,7 +789,7 @@ declare abstract class BaseGridPlugin_2<TConfig = unknown> implements GridPlugin
     /** Plugin configuration - merged with defaults in attach() */
     protected config: TConfig;
     /** User-provided configuration from constructor */
-    private readonly userConfig;
+    protected readonly userConfig: Partial<TConfig>;
     /**
      * Default configuration - subclasses should override this getter.
      * Note: This must be a getter (not property initializer) for proper inheritance
@@ -1719,6 +1744,8 @@ declare interface ColumnInternal<T = any> extends ColumnConfig<T> {
     __autoSized?: boolean;
     __userResized?: boolean;
     __renderedWidth?: number;
+    /** Original configured width (for reset on double-click) */
+    __originalWidth?: number;
     __viewTemplate?: HTMLElement;
     __editorTemplate?: HTMLElement;
     __headerTemplate?: HTMLElement;
@@ -2071,6 +2098,7 @@ export declare class DataGridElement<T = any> extends HTMLElement implements Int
     /* Excluded from this release type: getPlugin */
     /* Excluded from this release type: getPluginByName */
     /* Excluded from this release type: requestRender */
+    /* Excluded from this release type: updateTemplate */
     /* Excluded from this release type: requestAfterRender */
     connectedCallback(): void;
     disconnectedCallback(): void;
@@ -2092,6 +2120,11 @@ export declare class DataGridElement<T = any> extends HTMLElement implements Int
      * Returns true if any plugin handled the event.
      */
     _dispatchCellClick(event: MouseEvent, rowIndex: number, colIndex: number, cellEl: HTMLElement): boolean;
+    /**
+     * Dispatch a row click event to the plugin system.
+     * Returns true if any plugin handled the event.
+     */
+    _dispatchRowClick(event: MouseEvent, rowIndex: number, row: any, rowEl: HTMLElement): boolean;
     /**
      * Dispatch a header click event to the plugin system.
      * Returns true if any plugin handled the event.
@@ -2946,10 +2979,8 @@ export declare interface GridElement {
     rows: any[];
     columns: ColumnConfig[];
     gridConfig: any;
-    /** Current focused row index */
-    focusRow: number;
-    /** Current focused column index */
-    focusCol: number;
+    /* Excluded from this release type: _focusRow */
+    /* Excluded from this release type: _focusCol */
     /** AbortSignal that is aborted when the grid disconnects from the DOM */
     disconnectSignal: AbortSignal;
     requestRender(): void;
@@ -2965,10 +2996,8 @@ declare interface GridElement_2 {
     rows: any[];
     columns: ColumnConfig_2[];
     gridConfig: any;
-    /** Current focused row index */
-    focusRow: number;
-    /** Current focused column index */
-    focusCol: number;
+    /* Excluded from this release type: _focusRow */
+    /* Excluded from this release type: _focusCol */
     /** AbortSignal that is aborted when the grid disconnects from the DOM */
     disconnectSignal: AbortSignal;
     requestRender(): void;
@@ -3459,6 +3488,8 @@ declare interface InternalGrid<T = any> extends PublicGrid<T>, GridConfig<T> {
     commitActiveRowEdit?: () => void;
     /** Dispatch cell click to plugin system, returns true if handled */
     _dispatchCellClick?: (event: MouseEvent, rowIndex: number, colIndex: number, cellEl: HTMLElement) => boolean;
+    /** Dispatch row click to plugin system, returns true if handled */
+    _dispatchRowClick?: (event: MouseEvent, rowIndex: number, row: any, rowEl: HTMLElement) => boolean;
     /** Dispatch header click to plugin system, returns true if handled */
     _dispatchHeaderClick?: (event: MouseEvent, colIndex: number, headerEl: HTMLElement) => boolean;
     /** Dispatch keydown to plugin system, returns true if handled */
@@ -3873,6 +3904,8 @@ export declare interface PivotConfig {
     defaultExpanded?: boolean;
     /** Indent width per depth level in pixels (default: 20) */
     indentWidth?: number;
+    /** Whether to show the pivot configuration tool panel (default: true) */
+    showToolPanel?: boolean;
 }
 
 declare interface PivotConfig_2 {
@@ -3887,6 +3920,8 @@ declare interface PivotConfig_2 {
     defaultExpanded?: boolean;
     /** Indent width per depth level in pixels (default: 20) */
     indentWidth?: number;
+    /** Whether to show the pivot configuration tool panel (default: true) */
+    showToolPanel?: boolean;
 }
 
 declare type PivotDataRow = Record<string, unknown>;
@@ -4400,10 +4435,8 @@ declare type RenderRow = GroupRowModelItem | DataRowModelItem;
  */
 /** Configuration options for the reorder plugin */
 declare interface ReorderConfig {
-    /** Whether to animate column movement (default: true) */
-    animation?: boolean;
-    /** Animation duration in milliseconds (default: 200) */
-    animationDuration?: number;
+    /** Use View Transitions API for smooth column movement (default: true) */
+    viewTransition?: boolean;
 }
 
 /**
@@ -4411,11 +4444,7 @@ declare interface ReorderConfig {
  *
  * @example
  * ```ts
- * new ReorderPlugin({
- *   enabled: true,
- *   animation: true,
- *   animationDuration: 200,
- * })
+ * new ReorderPlugin()
  * ```
  */
 export declare class ReorderPlugin extends BaseGridPlugin_2<ReorderConfig> {
@@ -4449,12 +4478,19 @@ export declare class ReorderPlugin extends BaseGridPlugin_2<ReorderConfig> {
      * Reset column order to the original configuration order.
      */
     resetColumnOrder(): void;
+    /**
+     * Update column order with optional view transition animation.
+     * Falls back to instant update if View Transitions API is not supported.
+     */
+    private updateColumnOrder;
     readonly styles: string;
 }
 
 /** Controller managing drag-based column resize lifecycle. */
 declare interface ResizeController {
     start: (e: MouseEvent, colIndex: number, cell: HTMLElement) => void;
+    /** Reset a column to its configured width (or auto-size if none configured). */
+    resetColumn: (colIndex: number) => void;
     dispose: () => void;
     /** True while a resize drag is in progress (used to suppress header click/sort). */
     isResizing: boolean;
@@ -4618,6 +4654,8 @@ export declare class SelectionPlugin extends BaseGridPlugin_2<SelectionConfig_2>
     private activeRange;
     private cellAnchor;
     private isDragging;
+    /** Pending keyboard navigation update (processed in afterRender) */
+    private pendingKeyboardUpdate;
     /** Cell selection state (cell mode) */
     private selectedCell;
     detach(): void;