@zengrid/core 1.0.1

package/dist/src/features/filtering/filter-export-manager.d.ts

@@ -0,0 +1,131 @@
+/**
+ * Filter Export Manager
+ *
+ * Manages filter state transformation and export to multiple formats.
+ * Orchestrates adapters and handles conversions between column-based and field-based filters.
+ */
+import type { ColumnDef, FilterModel } from '../../types';
+import type { FieldFilterState, CustomOperator } from './types';
+import type { FilterExportResult } from './adapters/types';
+import type { FilterAdapter } from './adapters/adapter.interface';
+import { type RESTAdapterOptions } from './adapters/rest-adapter';
+import { type GraphQLAdapterOptions } from './adapters/graphql-adapter';
+import { type SQLAdapterOptions } from './adapters/sql-adapter';
+/**
+ * FilterExportManager configuration
+ */
+export interface FilterExportManagerOptions {
+    /**
+     * Column definitions (for field mapping)
+     */
+    columns: ColumnDef[];
+    /**
+     * Adapter configurations
+     */
+    adapters?: {
+        rest?: RESTAdapterOptions;
+        graphql?: GraphQLAdapterOptions;
+        sql?: SQLAdapterOptions;
+    };
+    /**
+     * Custom operators
+     */
+    customOperators?: CustomOperator[];
+}
+/**
+ * FilterExportManager - Manages filter transformation and export
+ *
+ * @example
+ * ```typescript
+ * const exportManager = new FilterExportManager({
+ *   columns: [
+ *     { field: 'id', header: 'ID' },
+ *     { field: 'name', header: 'Name' },
+ *     { field: 'age', header: 'Age' }
+ *   ],
+ *   adapters: {
+ *     rest: { style: 'brackets' },
+ *     graphql: { style: 'prisma' },
+ *     sql: { paramStyle: 'named' }
+ *   }
+ * });
+ *
+ * // Convert internal FilterModel[] to field-based format
+ * const fieldState = exportManager.convertFromModels(filterModels);
+ *
+ * // Export to all formats
+ * const exports = exportManager.export(fieldState);
+ * console.log(exports.rest.queryString);  // ?filter[age][gt]=18
+ * console.log(exports.graphql.where);     // { age: { gt: 18 } }
+ * console.log(exports.sql.whereClause);   // age > :age
+ * ```
+ */
+export declare class FilterExportManager {
+    private columns;
+    private fieldToIndex;
+    private indexToField;
+    private adapters;
+    private customOperators;
+    constructor(options: FilterExportManagerOptions);
+    /**
+     * Build field name to index mappings
+     */
+    private buildFieldMappings;
+    /**
+     * Initialize default adapters
+     */
+    private initializeAdapters;
+    /**
+     * Register custom operators
+     */
+    private registerCustomOperators;
+    /**
+     * Convert FilterModel[] (column-based) to FieldFilterState (field-based)
+     *
+     * This enables backend-friendly exports using field names instead of indices
+     */
+    convertFromModels(models: FilterModel[]): FieldFilterState;
+    /**
+     * Convert FieldFilterState (field-based) to FilterModel[] (column-based)
+     *
+     * Reverse conversion for internal use
+     */
+    convertToModels(state: FieldFilterState): FilterModel[];
+    /**
+     * Export filter state to all registered formats
+     */
+    export(state: FieldFilterState): FilterExportResult;
+    /**
+     * Export to specific format
+     */
+    exportAs<T>(state: FieldFilterState, adapterName: string): T;
+    /**
+     * Register custom adapter
+     */
+    registerAdapter(name: string, adapter: FilterAdapter<any>): void;
+    /**
+     * Register custom operator
+     */
+    registerOperator(operator: CustomOperator): void;
+    /**
+     * Update columns (rebuild mappings)
+     */
+    setColumns(columns: ColumnDef[]): void;
+    /**
+     * Map internal operator to standard operator
+     */
+    private mapOperatorToStandard;
+    /**
+     * Map standard operator to internal operator
+     */
+    private mapOperatorToInternal;
+    /**
+     * Get all registered adapters
+     */
+    getAdapters(): string[];
+    /**
+     * Get all custom operators
+     */
+    getCustomOperators(): CustomOperator[];
+}
+//# sourceMappingURL=filter-export-manager.d.ts.map

package/dist/src/features/filtering/filter-export-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"filter-export-manager.d.ts","sourceRoot":"","sources":["../../../../../../packages/core/src/features/filtering/filter-export-manager.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,WAAW,EAAkB,MAAM,aAAa,CAAC;AAC1E,OAAO,KAAK,EAAE,gBAAgB,EAAgD,cAAc,EAAE,MAAM,SAAS,CAAC;AAC9G,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAC3D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAC;AAClE,OAAO,EAAqB,KAAK,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AACrF,OAAO,EAAwB,KAAK,qBAAqB,EAAE,MAAM,4BAA4B,CAAC;AAC9F,OAAO,EAAoB,KAAK,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAElF;;GAEG;AACH,MAAM,WAAW,0BAA0B;IACzC;;OAEG;IACH,OAAO,EAAE,SAAS,EAAE,CAAC;IAErB;;OAEG;IACH,QAAQ,CAAC,EAAE;QACT,IAAI,CAAC,EAAE,kBAAkB,CAAC;QAC1B,OAAO,CAAC,EAAE,qBAAqB,CAAC;QAChC,GAAG,CAAC,EAAE,iBAAiB,CAAC;KACzB,CAAC;IAEF;;OAEG;IACH,eAAe,CAAC,EAAE,cAAc,EAAE,CAAC;CACpC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,qBAAa,mBAAmB;IAC9B,OAAO,CAAC,OAAO,CAAc;IAC7B,OAAO,CAAC,YAAY,CAAkC;IACtD,OAAO,CAAC,YAAY,CAAkC;IACtD,OAAO,CAAC,QAAQ,CAA8C;IAC9D,OAAO,CAAC,eAAe,CAA0C;gBAErD,OAAO,EAAE,0BAA0B;IAO/C;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAY1B;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAe1B;;OAEG;IACH,OAAO,CAAC,uBAAuB;IAM/B;;;;OAIG;IACH,iBAAiB,CAAC,MAAM,EAAE,WAAW,EAAE,GAAG,gBAAgB;IAoC1D;;;;OAIG;IACH,eAAe,CAAC,KAAK,EAAE,gBAAgB,GAAG,WAAW,EAAE;IAsCvD;;OAEG;IACH,MAAM,CAAC,KAAK,EAAE,gBAAgB,GAAG,kBAAkB;IA0BnD;;OAEG;IACH,QAAQ,CAAC,CAAC,EAAE,KAAK,EAAE,gBAAgB,EAAE,WAAW,EAAE,MAAM,GAAG,CAAC;IAQ5D;;OAEG;IACH,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,aAAa,CAAC,GAAG,CAAC,GAAG,IAAI;IAIhE;;OAEG;IACH,gBAAgB,CAAC,QAAQ,EAAE,cAAc,GAAG,IAAI;IAIhD;;OAEG;IACH,UAAU,CAAC,OAAO,EAAE,SAAS,EAAE,GAAG,IAAI;IAKtC;;OAEG;IACH,OAAO,CAAC,qBAAqB;IAuB7B;;OAEG;IACH,OAAO,CAAC,qBAAqB;IAuB7B;;OAEG;IACH,WAAW,IAAI,MAAM,EAAE;IAIvB;;OAEG;IACH,kBAAkB,IAAI,cAAc,EAAE;CAGvC"}

package/dist/src/features/filtering/filter-index-manager.d.ts

@@ -0,0 +1,126 @@
+/**
+ * Filter Index Manager using ColumnStore
+ *
+ * Provides vectorized filtering operations for high-performance
+ * numeric and typed column filtering.
+ */
+import { ColumnType } from '@zengrid/shared/data-structures/column-store';
+/**
+ * Filter operation for vectorized filtering
+ */
+interface VectorizedFilterOperation {
+    /** Operation type */
+    type: 'gt' | 'gte' | 'lt' | 'lte' | 'eq' | 'neq' | 'between';
+    /** Filter value(s) */
+    value: number;
+    /** Secondary value for 'between' */
+    valueTo?: number;
+}
+/**
+ * FilterIndexManager - Vectorized filtering with ColumnStore
+ *
+ * Uses column-oriented storage for 10-100x faster numeric filtering.
+ * Particularly effective for large datasets with numeric columns.
+ *
+ * @example
+ * ```typescript
+ * const indexManager = new FilterIndexManager();
+ *
+ * // Index numeric column
+ * indexManager.indexColumn(0, rowCount, (row) => data[row].price, 'number');
+ *
+ * // Vectorized filter: price > 100
+ * const rows = indexManager.filter(0, { type: 'gt', value: 100 });
+ * // 10-100x faster than row-by-row scanning
+ * ```
+ */
+export declare class FilterIndexManager {
+    private columnIndexes;
+    private memoryUsage;
+    private maxMemoryMB;
+    constructor(options?: {
+        maxMemoryMB?: number;
+    });
+    /**
+     * Index a column for vectorized filtering
+     *
+     * @param col - Column index
+     * @param rowCount - Total row count
+     * @param getValue - Function to get value for each row
+     * @param type - Column data type
+     */
+    indexColumn(col: number, rowCount: number, getValue: (row: number) => any, type?: ColumnType): void;
+    /**
+     * Vectorized filter operation
+     *
+     * Uses typed arrays for 10-100x faster filtering on numeric columns.
+     *
+     * @param col - Column index
+     * @param operation - Filter operation
+     * @returns Array of matching row indices
+     */
+    filter(col: number, operation: VectorizedFilterOperation): number[] | null;
+    /**
+     * Get column aggregation (MIN, MAX, SUM, AVG)
+     *
+     * @param col - Column index
+     * @param operation - Aggregation operation
+     * @returns Aggregated value or null
+     */
+    aggregate(col: number, operation: 'min' | 'max' | 'sum' | 'avg' | 'count'): number | null;
+    /**
+     * Update a single row value in the index
+     *
+     * @param col - Column index
+     * @param row - Row index
+     * @param value - New value
+     */
+    updateRow(col: number, row: number, value: any): void;
+    /**
+     * Check if column is indexed
+     *
+     * @param col - Column index
+     * @returns true if column has vectorized index
+     */
+    isIndexed(col: number): boolean;
+    /**
+     * Get column type
+     *
+     * @param col - Column index
+     * @returns Column type or null
+     */
+    getColumnType(col: number): ColumnType | null;
+    /**
+     * Clear index for a column
+     *
+     * @param col - Column index
+     */
+    clearColumn(col: number): void;
+    /**
+     * Clear all indexes
+     */
+    clearAll(): void;
+    /**
+     * Get memory usage statistics
+     */
+    getMemoryStats(): {
+        usedMB: number;
+        limitMB: number;
+        utilizationPercent: number;
+        indexedColumns: number;
+    };
+    /**
+     * Get all indexed columns
+     */
+    getIndexedColumns(): number[];
+    /**
+     * Estimate memory size for a column
+     *
+     * @param rowCount - Number of rows
+     * @param type - Column type
+     * @returns Estimated size in MB
+     */
+    private estimateColumnSize;
+}
+export {};
+//# sourceMappingURL=filter-index-manager.d.ts.map

package/dist/src/features/filtering/filter-index-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"filter-index-manager.d.ts","sourceRoot":"","sources":["../../../../../../packages/core/src/features/filtering/filter-index-manager.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAEL,UAAU,EACX,MAAM,8CAA8C,CAAC;AAmBtD;;GAEG;AACH,UAAU,yBAAyB;IACjC,qBAAqB;IACrB,IAAI,EAAE,IAAI,GAAG,KAAK,GAAG,IAAI,GAAG,KAAK,GAAG,IAAI,GAAG,KAAK,GAAG,SAAS,CAAC;IAE7D,sBAAsB;IACtB,KAAK,EAAE,MAAM,CAAC;IAEd,oCAAoC;IACpC,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,aAAa,CAA4C;IACjE,OAAO,CAAC,WAAW,CAAK;IACxB,OAAO,CAAC,WAAW,CAAS;gBAEhB,OAAO,GAAE;QAAE,WAAW,CAAC,EAAE,MAAM,CAAA;KAAO;IAIlD;;;;;;;OAOG;IACH,WAAW,CACT,GAAG,EAAE,MAAM,EACX,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,GAAG,EAC9B,IAAI,GAAE,UAAsB,GAC3B,IAAI;IAqCP;;;;;;;;OAQG;IACH,MAAM,CAAC,GAAG,EAAE,MAAM,EAAE,SAAS,EAAE,yBAAyB,GAAG,MAAM,EAAE,GAAG,IAAI;IA8F1E;;;;;;OAMG;IACH,SAAS,CACP,GAAG,EAAE,MAAM,EACX,SAAS,EAAE,KAAK,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,GAAG,OAAO,GACjD,MAAM,GAAG,IAAI;IAShB;;;;;;OAMG;IACH,SAAS,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,GAAG,IAAI;IASrD;;;;;OAKG;IACH,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IAI/B;;;;;OAKG;IACH,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,UAAU,GAAG,IAAI;IAI7C;;;;OAIG;IACH,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAS9B;;OAEG;IACH,QAAQ,IAAI,IAAI;IAKhB;;OAEG;IACH,cAAc,IAAI;QAChB,MAAM,EAAE,MAAM,CAAC;QACf,OAAO,EAAE,MAAM,CAAC;QAChB,kBAAkB,EAAE,MAAM,CAAC;QAC3B,cAAc,EAAE,MAAM,CAAC;KACxB;IASD;;OAEG;IACH,iBAAiB,IAAI,MAAM,EAAE;IAM7B;;;;;;OAMG;IACH,OAAO,CAAC,kBAAkB;CAyB3B"}

package/dist/src/features/filtering/filter-manager.d.ts

@@ -0,0 +1,408 @@
+import type { FilterModel, FilterQuery, FilterExpression, ColumnDef } from '../../types';
+import type { OperationMode } from '@zengrid/shared';
+import type { EventEmitter } from '../../events/event-emitter';
+import type { GridEvents } from '../../events/grid-events';
+import { ColumnFilter } from './column-filter';
+import { type FilterExportManagerOptions } from './filter-export-manager';
+import type { FieldFilterState } from './types';
+import type { FilterExportResult } from './adapters/types';
+import type { ColumnType } from '@zengrid/shared/data-structures/column-store';
+/**
+ * Filter manager options
+ */
+export interface FilterManagerOptions {
+    /**
+     * Total column count
+     */
+    colCount: number;
+    /**
+     * Event emitter for grid events
+     */
+    events?: EventEmitter<GridEvents>;
+    /**
+     * Callback to get cell value
+     */
+    getValue: (row: number, col: number) => any;
+    /**
+     * Initial filter models
+     */
+    initialFilters?: FilterModel[];
+    /**
+     * Filter mode: frontend, backend, or auto
+     * @default 'frontend'
+     */
+    mode?: OperationMode;
+    /**
+     * Column names for SQL query field mapping
+     */
+    columnNames?: string[];
+    /**
+     * Backend filtering callback
+     * Called when mode is 'backend' or 'auto' (with callback present)
+     */
+    onFilterRequest?: (filter: FilterExpression) => Promise<void> | void;
+    /**
+     * Column definitions (for field-based filtering)
+     * Required for FilterExportManager
+     */
+    columns?: ColumnDef[];
+    /**
+     * Enable automatic export transformation
+     * @default true
+     */
+    enableExport?: boolean;
+    /**
+     * Export manager configuration
+     */
+    exportConfig?: Partial<FilterExportManagerOptions>;
+    /**
+     * Enable performance optimizations
+     * @default true
+     */
+    enableOptimizations?: boolean;
+    /**
+     * Enable result caching with LRU cache
+     * @default true
+     */
+    enableCache?: boolean;
+    /**
+     * Cache capacity (number of cached filter results)
+     * @default 100
+     */
+    cacheCapacity?: number;
+    /**
+     * Enable vectorized filtering with ColumnStore
+     * @default true
+     */
+    enableVectorization?: boolean;
+    /**
+     * Enable range query optimization with SegmentTree
+     * @default true
+     */
+    enableRangeOptimization?: boolean;
+    /**
+     * Maximum memory for indexes (in MB)
+     * @default 100
+     */
+    maxIndexMemoryMB?: number;
+    /**
+     * Data version for cache invalidation
+     * Increment this when data changes
+     * @default 0
+     */
+    dataVersion?: number;
+}
+/**
+ * FilterManager - Manages filtering across all columns
+ *
+ * Supports both frontend and backend filtering with two input formats:
+ * 1. FilterModel[] - Traditional structured filters
+ * 2. FilterQuery - SQL-like queries with parameterization
+ *
+ * @example Traditional Filtering
+ * ```typescript
+ * const filterManager = new FilterManager({
+ *   colCount: 10,
+ *   getValue: (row, col) => data[row][col],
+ *   mode: 'frontend'
+ * });
+ *
+ * // Add filter for column 0
+ * filterManager.setColumnFilter(0, [
+ *   { operator: 'greaterThan', value: 100 },
+ * ]);
+ *
+ * // Test if row passes all filters
+ * const passes = filterManager.testRow(5);
+ *
+ * // Get visible row indices
+ * const visible = filterManager.getVisibleRows(1000);
+ * ```
+ *
+ * @example SQL-like Filtering
+ * ```typescript
+ * const filterManager = new FilterManager({
+ *   colCount: 10,
+ *   getValue: (row, col) => data[row][col],
+ *   mode: 'frontend',
+ *   columnNames: ['id', 'name', 'age', 'status']
+ * });
+ *
+ * // Apply SQL-like filter
+ * await filterManager.applyFilter({
+ *   sql: "age > :minAge AND status = :status",
+ *   params: { minAge: 18, status: 'active' }
+ * });
+ * ```
+ *
+ * @example Backend Filtering
+ * ```typescript
+ * const filterManager = new FilterManager({
+ *   colCount: 10,
+ *   getValue: (row, col) => data[row][col],
+ *   mode: 'backend',
+ *   onFilterRequest: async (filter) => {
+ *     const data = await api.get('/data', {
+ *       filter: filter.sql,
+ *       params: filter.params
+ *     });
+ *     grid.setData(data);
+ *   }
+ * });
+ * ```
+ */
+export declare class FilterManager {
+    private colCount;
+    private events?;
+    private getValue;
+    private columnFilters;
+    private filterState;
+    private mode;
+    private columnNames;
+    private parser;
+    private onFilterRequest?;
+    private currentExpression;
+    private exportManager;
+    private enableExport;
+    private filterCache;
+    private indexManager;
+    private rangeOptimizer;
+    private enableOptimizations;
+    private dataVersion;
+    private filterStateHash;
+    constructor(options: FilterManagerOptions);
+    /**
+     * Set filter for a column
+     * @param column - Column index
+     * @param conditions - Filter conditions
+     * @param logic - Logic operator ('AND' or 'OR')
+     */
+    setColumnFilter(column: number, conditions: any[], logic?: 'AND' | 'OR'): void;
+    /**
+     * Set column filter from model
+     */
+    private setColumnFilterFromModel;
+    /**
+     * Clear filter for a column
+     * @param column - Column index
+     */
+    clearColumnFilter(column: number): void;
+    /**
+     * Clear all filters
+     */
+    clearAll(): void;
+    /**
+     * Test if a row passes all filters
+     * @param row - Row index
+     * @returns True if row passes all filters
+     */
+    testRow(row: number): boolean;
+    /**
+     * Get all visible row indices
+     * @param rowCount - Total row count
+     * @returns Array of visible row indices
+     */
+    getVisibleRows(rowCount: number): number[];
+    /**
+     * Get filter statistics
+     * @param rowCount - Total row count
+     */
+    getStats(rowCount: number): {
+        totalRows: number;
+        visibleRows: number;
+        hiddenRows: number;
+        activeFilters: number;
+    };
+    /**
+     * Get current filter state
+     */
+    getFilterState(): FilterModel[];
+    /**
+     * Check if any filters are active
+     */
+    hasActiveFilters(): boolean;
+    /**
+     * Get filter for specific column
+     * @param column - Column index
+     */
+    getColumnFilter(column: number): ColumnFilter | undefined;
+    /**
+     * Emit filter change event
+     */
+    private emitFilterChange;
+    /**
+     * Apply filter using SQL-like query or FilterModels
+     * Supports both frontend and backend filtering
+     *
+     * @example SQL Query (Frontend)
+     * ```typescript
+     * await filterManager.applyFilter({
+     *   sql: "age > :minAge AND status = :status",
+     *   params: { minAge: 18, status: 'active' }
+     * });
+     * ```
+     *
+     * @example SQL Query (Backend)
+     * ```typescript
+     * // With mode='backend', this will call onFilterRequest callback
+     * await filterManager.applyFilter({
+     *   sql: "price BETWEEN :min AND :max",
+     *   params: { min: 100, max: 500 }
+     * });
+     * ```
+     *
+     * @example FilterModels
+     * ```typescript
+     * await filterManager.applyFilter([
+     *   {
+     *     column: 2,
+     *     conditions: [{ operator: 'greaterThan', value: 18 }],
+     *     logic: 'AND'
+     *   }
+     * ]);
+     * ```
+     */
+    applyFilter(filter: FilterQuery | FilterModel[] | null): Promise<void>;
+    /**
+     * Parse filter input into FilterExpression
+     */
+    private parseFilterInput;
+    /**
+     * Type guard for FilterQuery
+     */
+    private isFilterQuery;
+    /**
+     * Apply frontend filtering (in-memory)
+     */
+    private applyFrontendFilter;
+    /**
+     * Apply backend filtering (delegate to server)
+     */
+    private applyBackendFilter;
+    /**
+     * Get current filter expression
+     */
+    getCurrentExpression(): FilterExpression | null;
+    /**
+     * Update column names (for SQL query mapping)
+     */
+    setColumnNames(names: string[]): void;
+    /**
+     * Get current filter state in field-based format
+     * Returns filter state using field names instead of column indices
+     *
+     * @returns Field-based filter state or null if no export manager
+     */
+    getFieldFilterState(): FieldFilterState | null;
+    /**
+     * Get filter export in all formats (REST, GraphQL, SQL)
+     * Returns ready-to-use filter formats for backend consumption
+     *
+     * @returns Filter export result with all formats
+     *
+     * @example
+     * ```typescript
+     * const exports = filterManager.getFilterExport();
+     *
+     * // REST
+     * fetch(`/api/users?${exports.rest.queryString}`);
+     *
+     * // GraphQL
+     * graphqlClient.query({ query, variables: { where: exports.graphql.where } });
+     *
+     * // SQL
+     * db.query(`SELECT * FROM users WHERE ${exports.sql.whereClause}`, exports.sql.positionalParams);
+     * ```
+     */
+    getFilterExport(): FilterExportResult | null;
+    /**
+     * Get filter export in specific format
+     *
+     * @param format - Adapter name ('rest', 'graphql', 'sql', or custom)
+     * @returns Filter export in specified format
+     *
+     * @example
+     * ```typescript
+     * const restExport = filterManager.getFilterExportAs<RESTFilterExport>('rest');
+     * fetch(`/api/users?${restExport.queryString}`);
+     * ```
+     */
+    getFilterExportAs<T>(format: string): T | null;
+    /**
+     * Set filter from field-based format
+     * Converts field-based filter state to column-based FilterModels
+     *
+     * @param state - Field-based filter state
+     *
+     * @example
+     * ```typescript
+     * filterManager.setFieldFilter({
+     *   root: {
+     *     logic: 'AND',
+     *     conditions: [
+     *       { field: 'age', operator: 'gt', value: 18 },
+     *       { field: 'status', operator: 'eq', value: 'active' }
+     *     ]
+     *   },
+     *   activeFields: ['age', 'status'],
+     *   timestamp: Date.now()
+     * });
+     * ```
+     */
+    setFieldFilter(state: FieldFilterState): void;
+    /**
+     * Update columns (for export manager)
+     */
+    setColumns(columns: ColumnDef[]): void;
+    /**
+     * Set data version (invalidates cache)
+     *
+     * @param version - New data version
+     */
+    setDataVersion(version: number): void;
+    /**
+     * Index a column for optimized filtering
+     *
+     * @param col - Column index
+     * @param rowCount - Total row count
+     * @param type - Column data type
+     */
+    indexColumn(col: number, rowCount: number, type?: ColumnType): void;
+    /**
+     * Get cache statistics
+     */
+    getCacheStats(): {
+        hitCount: number;
+        missCount: number;
+        hitRate: number;
+        size: number;
+        capacity: number;
+    } | null;
+    /**
+     * Get index memory statistics
+     */
+    getIndexMemoryStats(): {
+        usedMB: number;
+        limitMB: number;
+        utilizationPercent: number;
+        indexedColumns: number;
+    } | null;
+    /**
+     * Clear all caches and indexes
+     */
+    clearOptimizations(): void;
+    /**
+     * Destroy filter manager
+     */
+    destroy(): void;
+    /**
+     * Try optimized filtering using ColumnStore and SegmentTree
+     * Returns null if optimization not applicable
+     */
+    private tryOptimizedFilter;
+    /**
+     * Update filter state hash for caching
+     */
+    private updateFilterState;
+}
+//# sourceMappingURL=filter-manager.d.ts.map

package/dist/src/features/filtering/filter-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"filter-manager.d.ts","sourceRoot":"","sources":["../../../../../../packages/core/src/features/filtering/filter-manager.ts"],"names":[],"mappings":"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"}