@toolbox-web/grid 0.2.8 → 0.3.1

package/lib/plugins/pinned-rows/types.d.ts

@@ -0,0 +1,95 @@
+import { ColumnConfig } from '../../core/types';
+/** Position of the status bar relative to the grid */
+export type PinnedRowsPosition = 'top' | 'bottom';
+/** Aggregator function signature */
+export type AggregatorFn = (rows: unknown[], field: string, column?: ColumnConfig) => unknown;
+/** Aggregator formatter function - formats the computed value for display */
+export type AggregatorFormatter = (value: unknown, field: string, column?: ColumnConfig) => string;
+/** Simple aggregator reference - string key for built-in or custom function */
+export type AggregatorRef = string | AggregatorFn;
+/** Full aggregator config with optional formatter */
+export interface AggregatorConfig {
+    /** The aggregator function or built-in key ('sum', 'avg', 'min', 'max', 'count', 'first', 'last') */
+    aggFunc: AggregatorRef;
+    /** Optional formatter to format the computed value for display */
+    formatter?: AggregatorFormatter;
+}
+/** Aggregator definition - simple string/function or full config object */
+export type AggregatorDefinition = AggregatorRef | AggregatorConfig;
+/**
+ * Configuration for an aggregation row (footer/header row with computed values).
+ * Replaces the core FooterRowConfig functionality.
+ */
+export interface AggregationRowConfig {
+    /** Optional identifier (useful for diffing or targeted updates) */
+    id?: string;
+    /** Position: 'top' renders above grid body, 'bottom' renders below (default: 'bottom') */
+    position?: 'top' | 'bottom';
+    /** If true, row rendered as single spanning cell with label */
+    fullWidth?: boolean;
+    /** Label when in fullWidth mode */
+    label?: string;
+    /** Static or computed cell values keyed by field */
+    cells?: Record<string, unknown | string | ((rows: unknown[], field: string, column?: ColumnConfig) => unknown)>;
+    /**
+     * 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>;
+}
+/** Configuration options for the status bar plugin */
+export interface PinnedRowsConfig {
+    /** Position of the info bar (default: 'bottom') */
+    position?: PinnedRowsPosition;
+    /** Show total row count in info bar (default: true) */
+    showRowCount?: boolean;
+    /** Show selected row count in info bar (default: true) */
+    showSelectedCount?: boolean;
+    /** Show filtered row count when filter is active (default: true) */
+    showFilteredCount?: boolean;
+    /** Custom panels to display in the info bar */
+    customPanels?: PinnedRowsPanel[];
+    /** Aggregation rows (footer/header rows with computed values) */
+    aggregationRows?: AggregationRowConfig[];
+}
+/** Custom panel definition for the status bar */
+export interface PinnedRowsPanel {
+    /** Unique identifier for the panel */
+    id: string;
+    /** Position within the status bar */
+    position: 'left' | 'center' | 'right';
+    /** Render function for the panel content */
+    render: (context: PinnedRowsContext) => HTMLElement | string;
+}
+/** Context provided to panel renderers */
+export interface PinnedRowsContext {
+    /** Total number of rows in the grid */
+    totalRows: number;
+    /** Number of rows after filtering */
+    filteredRows: number;
+    /** Number of selected rows */
+    selectedRows: number;
+    /** Current column configuration */
+    columns: ColumnConfig[];
+    /** Current row data */
+    rows: unknown[];
+    /** Reference to the grid element */
+    grid: HTMLElement;
+}
+/** Internal state managed by the status bar plugin */
+export interface PinnedRowsState {
+    /** The info bar DOM element */
+    infoBarElement: HTMLElement | null;
+    /** Top aggregation rows container */
+    topAggregationContainer: HTMLElement | null;
+    /** Bottom aggregation rows container */
+    bottomAggregationContainer: HTMLElement | null;
+    /** Footer wrapper for sticky bottom elements */
+    footerWrapper: HTMLElement | null;
+}
+//# sourceMappingURL=types.d.ts.map

package/lib/plugins/pinned-rows/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../../../libs/grid/src/lib/plugins/pinned-rows/types.ts"],"names":[],"mappings":"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"}

package/lib/plugins/pivot/PivotPlugin.d.ts

@@ -0,0 +1,94 @@
+import { BaseGridPlugin } from '../../core/plugin/base-plugin';
+import { ColumnConfig, ToolPanelDefinition } from '../../core/types';
+import { PivotDataRow } from './pivot-engine';
+import { PivotConfig, PivotResult, PivotValueField } from './types';
+/**
+ * Pivot Plugin for tbw-grid
+ *
+ * @example
+ * ```ts
+ * new PivotPlugin({
+ *   rowGroupFields: ['category'],
+ *   columnGroupFields: ['region'],
+ *   valueFields: [{ field: 'sales', aggFunc: 'sum' }]
+ * })
+ * ```
+ */
+export declare class PivotPlugin extends BaseGridPlugin<PivotConfig> {
+    readonly name = "pivot";
+    readonly version = "1.0.0";
+    /** Tool panel ID for shell integration */
+    static readonly PANEL_ID = "pivot";
+    protected get defaultConfig(): Partial<PivotConfig>;
+    private isActive;
+    private hasInitialized;
+    private pivotResult;
+    private fieldHeaderMap;
+    private expandedKeys;
+    private defaultExpanded;
+    private originalColumns;
+    private panelContainer;
+    private grandTotalFooter;
+    private previousVisibleKeys;
+    private keysToAnimate;
+    /**
+     * Check if the plugin has valid pivot configuration (at least value fields).
+     */
+    private hasValidPivotConfig;
+    /**
+     * Get animation style respecting grid-level animation mode.
+     */
+    private get animationStyle();
+    detach(): void;
+    getToolPanel(): ToolPanelDefinition | undefined;
+    processRows(rows: readonly unknown[]): PivotDataRow[];
+    processColumns(columns: readonly ColumnConfig[]): ColumnConfig[];
+    renderRow(row: Record<string, unknown>, rowEl: HTMLElement): boolean;
+    /**
+     * 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.
+     */
+    private cleanupPivotStyling;
+    afterRender(): void;
+    /**
+     * Render the grand total row as a sticky footer pinned to the bottom.
+     */
+    private renderGrandTotalFooter;
+    /**
+     * 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;
+    getPivotResult(): PivotResult | null;
+    setRowGroupFields(fields: string[]): void;
+    setColumnGroupFields(fields: string[]): void;
+    setValueFields(fields: PivotValueField[]): void;
+    refresh(): void;
+    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;
+}
+//# sourceMappingURL=PivotPlugin.d.ts.map

package/lib/plugins/pivot/PivotPlugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PivotPlugin.d.ts","sourceRoot":"","sources":["../../../../../../libs/grid/src/lib/plugins/pivot/PivotPlugin.ts"],"names":[],"mappings":"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"}

package/lib/plugins/pivot/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Pivot Plugin Entry Point
+ * Re-exports plugin class and types for tree-shakeable imports.
+ */
+export { PivotPlugin } from './PivotPlugin';
+export type { AggFunc, PivotConfig, PivotResult, PivotValueField } from './types';
+//# sourceMappingURL=index.d.ts.map

package/lib/plugins/pivot/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../libs/grid/src/lib/plugins/pivot/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,YAAY,EAAE,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC"}