@zengrid/core 1.1.0 → 1.2.1

package/dist/src/types/data.d.ts

@@ -1,81 +1,31 @@
 /**
  * Data loading request/response types
  */
-import type { SortState } from './sort';
-import type { FilterModel } from './filter';
+import type { QueryState } from './query';
 /**
- * Data loading request parameters
- * Enhanced with field-based filter exports for backend convenience
+ * Data loading request parameters.
  */
 export interface DataLoadRequest {
     /**
-     * Start row index (for pagination)
+     * Start row index of the requested window.
      */
     startRow: number;
     /**
-     * End row index (for pagination)
+     * End row index of the requested window.
      */
     endRow: number;
     /**
-     * Current sort state
+     * Monotonic identifier for this request lifecycle.
      */
-    sortState?: SortState[];
+    requestId?: number;
     /**
-     * Current filter state (column-based - DEPRECATED)
-     * @deprecated Use `filter` field-based format instead
-     * Kept for backwards compatibility
+     * Abort signal for cancellation-aware backends.
      */
-    filterState?: FilterModel[];
+    signal?: AbortSignal;
     /**
-     * Field-based filter state (NEW - recommended)
-     * Uses field names instead of column indices
+     * Canonical query envelope for filter, sort, and pagination state.
      */
-    filter?: import('../features/filtering/types').FieldFilterState;
-    /**
-     * Pre-computed filter exports (NEW)
-     * Ready-to-use formats for backend queries
-     *
-     * @example REST
-     * ```typescript
-     * fetch(`/api/users?${request.filterExport.queryString}`)
-     * // => /api/users?filter[age][gt]=18
-     * ```
-     *
-     * @example GraphQL
-     * ```typescript
-     * graphqlClient.query({
-     *   query: GET_USERS,
-     *   variables: { where: request.filterExport.graphqlWhere }
-     * })
-     * ```
-     *
-     * @example SQL
-     * ```typescript
-     * db.query(
-     *   `SELECT * FROM users WHERE ${request.filterExport.sql.whereClause}`,
-     *   request.filterExport.sql.positionalParams
-     * )
-     * ```
-     */
-    filterExport?: {
-        /** REST query string (URL-encoded) */
-        queryString: string;
-        /** GraphQL where clause */
-        graphqlWhere: Record<string, any>;
-        /** SQL WHERE clause with parameters */
-        sql: import('../features/filtering/adapters/types').SQLFilterExport;
-    };
-    /**
-     * Pagination info (NEW)
-     */
-    pagination?: {
-        /** Current page (0-based) */
-        page: number;
-        /** Items per page */
-        pageSize: number;
-        /** Row offset (startRow) */
-        offset: number;
-    };
+    query: QueryState;
 }
 /**
  * Data loading response
@@ -98,4 +48,28 @@ export interface DataLoadResponse {
      */
     endRow: number;
 }
+/**
+ * Backend data request lifecycle state
+ */
+export interface DataRequestState {
+    /** Resolved data mode */
+    mode: 'frontend' | 'backend';
+    /** Current request status */
+    status: 'idle' | 'loading' | 'success' | 'empty' | 'error';
+    /** Whether a backend request is currently in flight */
+    isLoading: boolean;
+    /** Last request error, if any */
+    error: Error | null;
+    /** Last request sent to the backend */
+    lastRequest: DataLoadRequest | null;
+    /** Last successfully loaded row window */
+    lastLoadedRange: {
+        startRow: number;
+        endRow: number;
+    } | null;
+    /** Latest known total row count */
+    totalRows: number;
+    /** Whether retry is currently possible */
+    canRetry: boolean;
+}
 //# sourceMappingURL=data.d.ts.map

package/dist/src/types/data.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"data.d.ts","sourceRoot":"","sources":["../../../src/types/data.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,QAAQ,CAAC;AACxC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAE5C;;;GAGG;AACH,MAAM,WAAW,eAAe;IAC9B;;OAEG;IACH,QAAQ,EAAE,MAAM,CAAC;IAEjB;;OAEG;IACH,MAAM,EAAE,MAAM,CAAC;IAEf;;OAEG;IACH,SAAS,CAAC,EAAE,SAAS,EAAE,CAAC;IAExB;;;;OAIG;IACH,WAAW,CAAC,EAAE,WAAW,EAAE,CAAC;IAE5B;;;OAGG;IACH,MAAM,CAAC,EAAE,OAAO,6BAA6B,EAAE,gBAAgB,CAAC;IAEhE;;;;;;;;;;;;;;;;;;;;;;;;;OAyBG;IACH,YAAY,CAAC,EAAE;QACb,sCAAsC;QACtC,WAAW,EAAE,MAAM,CAAC;QACpB,2BAA2B;QAC3B,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;QAClC,uCAAuC;QACvC,GAAG,EAAE,OAAO,sCAAsC,EAAE,eAAe,CAAC;KACrE,CAAC;IAEF;;OAEG;IACH,UAAU,CAAC,EAAE;QACX,6BAA6B;QAC7B,IAAI,EAAE,MAAM,CAAC;QACb,qBAAqB;QACrB,QAAQ,EAAE,MAAM,CAAC;QACjB,4BAA4B;QAC5B,MAAM,EAAE,MAAM,CAAC;KAChB,CAAC;CACH;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B;;OAEG;IACH,IAAI,EAAE,GAAG,EAAE,EAAE,CAAC;IAEd;;OAEG;IACH,SAAS,EAAE,MAAM,CAAC;IAElB;;OAEG;IACH,QAAQ,EAAE,MAAM,CAAC;IAEjB;;OAEG;IACH,MAAM,EAAE,MAAM,CAAC;CAChB"}
+{"version":3,"file":"data.d.ts","sourceRoot":"","sources":["../../../src/types/data.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAE1C;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B;;OAEG;IACH,QAAQ,EAAE,MAAM,CAAC;IAEjB;;OAEG;IACH,MAAM,EAAE,MAAM,CAAC;IAEf;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB;;OAEG;IACH,MAAM,CAAC,EAAE,WAAW,CAAC;IAErB;;OAEG;IACH,KAAK,EAAE,UAAU,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B;;OAEG;IACH,IAAI,EAAE,GAAG,EAAE,EAAE,CAAC;IAEd;;OAEG;IACH,SAAS,EAAE,MAAM,CAAC;IAElB;;OAEG;IACH,QAAQ,EAAE,MAAM,CAAC;IAEjB;;OAEG;IACH,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,yBAAyB;IACzB,IAAI,EAAE,UAAU,GAAG,SAAS,CAAC;IAE7B,6BAA6B;IAC7B,MAAM,EAAE,MAAM,GAAG,SAAS,GAAG,SAAS,GAAG,OAAO,GAAG,OAAO,CAAC;IAE3D,uDAAuD;IACvD,SAAS,EAAE,OAAO,CAAC;IAEnB,iCAAiC;IACjC,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;IAEpB,uCAAuC;IACvC,WAAW,EAAE,eAAe,GAAG,IAAI,CAAC;IAEpC,0CAA0C;IAC1C,eAAe,EAAE;QACf,QAAQ,EAAE,MAAM,CAAC;QACjB,MAAM,EAAE,MAAM,CAAC;KAChB,GAAG,IAAI,CAAC;IAET,mCAAmC;IACnC,SAAS,EAAE,MAAM,CAAC;IAElB,0CAA0C;IAC1C,QAAQ,EAAE,OAAO,CAAC;CACnB"}

package/dist/src/types/filter.d.ts

@@ -1,6 +1,8 @@
 /**
  * Filter types
  */
+import type { FilterExportResult } from '../features/filtering/adapters/types';
+import type { FieldFilterState, StandardFilterOperator } from '../features/filtering/types';
 /**
  * Filter operator types
  */
@@ -20,66 +22,136 @@ export interface FilterModel {
     conditions: FilterCondition[];
     logic?: 'AND' | 'OR';
 }
+/**
+ * Quick filter state shared across frontend/backend request paths
+ */
+export interface FilterQuickState {
+    query: string;
+    columns: number[] | null;
+}
 /**
  * SQL-like filter query with parameterization
  * Supports cleaner syntax than FilterModel for complex queries
- *
- * @example
- * ```typescript
- * // Simple query
- * { sql: "age > 18" }
- *
- * // Parameterized query (recommended - prevents injection)
- * {
- *   sql: "age > :minAge AND status = :status",
- *   params: { minAge: 18, status: 'active' }
- * }
- *
- * // Complex query
- * {
- *   sql: "age BETWEEN :min AND :max AND (name LIKE :search OR email LIKE :search)",
- *   params: { min: 18, max: 65, search: '%john%' }
- * }
- * ```
  */
 export interface FilterQuery {
-    /**
-     * SQL-like query string
-     * Supported operators: =, !=, <, >, <=, >=, LIKE, NOT LIKE, BETWEEN, IN, IS NULL, IS NOT NULL
-     * Supported logic: AND, OR, NOT, parentheses for grouping
-     */
     sql: string;
-    /**
-     * Named parameters for the query
-     * Use :paramName in sql and provide values here
-     * Recommended for security and readability
-     */
     params?: Record<string, any>;
 }
 /**
- * Parsed filter expression (internal use)
- * Result of parsing FilterQuery or FilterModel
+ * Canonical value classification for AST predicates.
+ */
+export type FilterValueType = 'text' | 'number' | 'date' | 'boolean' | 'enum' | 'custom' | 'unknown';
+/**
+ * Shared target reference for AST predicates and search nodes.
+ *
+ * The long-term canonical key is `field`, but `column` remains available
+ * for compatibility with existing index-based APIs.
+ */
+export interface FilterAstTarget {
+    field?: string;
+    column?: number;
+    columnId?: string;
+}
+/**
+ * Base metadata shared across AST nodes.
+ */
+export interface FilterAstBaseNode {
+    source?: 'model' | 'field' | 'quickFilter' | 'sql' | 'api';
+}
+/**
+ * Group node for boolean composition.
+ */
+export interface FilterAstGroupNode extends FilterAstBaseNode {
+    kind: 'group';
+    logic: 'AND' | 'OR';
+    children: FilterAstNode[];
+}
+/**
+ * Predicate node for field/column constraints.
+ */
+export interface FilterAstPredicateNode extends FilterAstBaseNode {
+    kind: 'predicate';
+    target: FilterAstTarget;
+    operator: StandardFilterOperator | string;
+    value?: any;
+    valueTo?: any;
+    valueType?: FilterValueType;
+    sourceOperator?: FilterOperator | string;
+}
+/**
+ * Search node for global or scoped quick-filter semantics.
+ */
+export interface FilterAstSearchNode extends FilterAstBaseNode {
+    kind: 'search';
+    query: string;
+    targets?: FilterAstTarget[] | null;
+}
+/**
+ * NOT node for future advanced filtering support.
+ */
+export interface FilterAstNotNode extends FilterAstBaseNode {
+    kind: 'not';
+    child: FilterAstNode;
+}
+/**
+ * Compatibility node used while SQL-like input is still accepted.
+ */
+export interface FilterAstSqlNode extends FilterAstBaseNode {
+    kind: 'sql';
+    sql: string;
+    boundSql?: string;
+    params?: any[];
+}
+/**
+ * Filter AST node union.
+ */
+export type FilterAstNode = FilterAstGroupNode | FilterAstPredicateNode | FilterAstSearchNode | FilterAstNotNode | FilterAstSqlNode;
+/**
+ * Canonical filter AST envelope.
+ */
+export interface FilterAst {
+    version: 1;
+    root: FilterAstGroupNode | null;
+}
+/**
+ * Parsed filter expression shared by backend callbacks and backend data requests.
  */
 export interface FilterExpression {
     /**
-     * Type of filter input
+     * Canonical typed filter AST.
+     */
+    ast?: FilterAst | null;
+    /**
+     * Type of filter input.
      */
     type: 'sql' | 'model';
     /**
-     * Original SQL query (if type is 'sql')
+     * Original SQL query (if type is 'sql').
      */
     sql?: string;
     /**
-     * Bound parameters with values substituted
+     * Bound SQL converted to positional placeholders (if type is 'sql').
      */
     boundSql?: string;
     /**
-     * Parameters array for positional binding
+     * Parameters array for positional binding.
      */
     params?: any[];
     /**
-     * Parsed filter models (if type is 'model' or converted from sql)
+     * Column-based filter models.
      */
     models?: FilterModel[];
+    /**
+     * Quick filter state applied alongside column filters.
+     */
+    quickFilter?: FilterQuickState;
+    /**
+     * Field-based filter state for backend-friendly consumption.
+     */
+    fieldState?: FieldFilterState | null;
+    /**
+     * Pre-computed backend exports (REST / GraphQL / SQL).
+     */
+    filterExport?: FilterExportResult | null;
 }
 //# sourceMappingURL=filter.d.ts.map

package/dist/src/types/filter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"filter.d.ts","sourceRoot":"","sources":["../../../src/types/filter.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;GAEG;AACH,MAAM,MAAM,cAAc,GACtB,QAAQ,GACR,WAAW,GACX,UAAU,GACV,aAAa,GACb,YAAY,GACZ,UAAU,GACV,aAAa,GACb,UAAU,GACV,oBAAoB,GACpB,iBAAiB,GACjB,OAAO,GACP,UAAU,GACV,SAAS,GACT,IAAI,GACJ,OAAO,GACP,OAAO,CAAC;AAEZ;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,QAAQ,EAAE,cAAc,CAAC;IACzB,KAAK,CAAC,EAAE,GAAG,CAAC;CACb;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,eAAe,EAAE,CAAC;IAC9B,KAAK,CAAC,EAAE,KAAK,GAAG,IAAI,CAAC;CACtB;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,MAAM,WAAW,WAAW;IAC1B;;;;OAIG;IACH,GAAG,EAAE,MAAM,CAAC;IAEZ;;;;OAIG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;CAC9B;AAED;;;GAGG;AACH,MAAM,WAAW,gBAAgB;IAC/B;;OAEG;IACH,IAAI,EAAE,KAAK,GAAG,OAAO,CAAC;IAEtB;;OAEG;IACH,GAAG,CAAC,EAAE,MAAM,CAAC;IAEb;;OAEG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB;;OAEG;IACH,MAAM,CAAC,EAAE,GAAG,EAAE,CAAC;IAEf;;OAEG;IACH,MAAM,CAAC,EAAE,WAAW,EAAE,CAAC;CACxB"}
+{"version":3,"file":"filter.d.ts","sourceRoot":"","sources":["../../../src/types/filter.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,sCAAsC,CAAC;AAC/E,OAAO,KAAK,EAAE,gBAAgB,EAAE,sBAAsB,EAAE,MAAM,6BAA6B,CAAC;AAE5F;;GAEG;AACH,MAAM,MAAM,cAAc,GACtB,QAAQ,GACR,WAAW,GACX,UAAU,GACV,aAAa,GACb,YAAY,GACZ,UAAU,GACV,aAAa,GACb,UAAU,GACV,oBAAoB,GACpB,iBAAiB,GACjB,OAAO,GACP,UAAU,GACV,SAAS,GACT,IAAI,GACJ,OAAO,GACP,OAAO,CAAC;AAEZ;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,QAAQ,EAAE,cAAc,CAAC;IACzB,KAAK,CAAC,EAAE,GAAG,CAAC;CACb;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,eAAe,EAAE,CAAC;IAC9B,KAAK,CAAC,EAAE,KAAK,GAAG,IAAI,CAAC;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC;CAC1B;AAED;;;GAGG;AACH,MAAM,WAAW,WAAW;IAC1B,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;CAC9B;AAED;;GAEG;AACH,MAAM,MAAM,eAAe,GACvB,MAAM,GACN,QAAQ,GACR,MAAM,GACN,SAAS,GACT,MAAM,GACN,QAAQ,GACR,SAAS,CAAC;AAEd;;;;;GAKG;AACH,MAAM,WAAW,eAAe;IAC9B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,MAAM,CAAC,EAAE,OAAO,GAAG,OAAO,GAAG,aAAa,GAAG,KAAK,GAAG,KAAK,CAAC;CAC5D;AAED;;GAEG;AACH,MAAM,WAAW,kBAAmB,SAAQ,iBAAiB;IAC3D,IAAI,EAAE,OAAO,CAAC;IACd,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;IACpB,QAAQ,EAAE,aAAa,EAAE,CAAC;CAC3B;AAED;;GAEG;AACH,MAAM,WAAW,sBAAuB,SAAQ,iBAAiB;IAC/D,IAAI,EAAE,WAAW,CAAC;IAClB,MAAM,EAAE,eAAe,CAAC;IACxB,QAAQ,EAAE,sBAAsB,GAAG,MAAM,CAAC;IAC1C,KAAK,CAAC,EAAE,GAAG,CAAC;IACZ,OAAO,CAAC,EAAE,GAAG,CAAC;IACd,SAAS,CAAC,EAAE,eAAe,CAAC;IAC5B,cAAc,CAAC,EAAE,cAAc,GAAG,MAAM,CAAC;CAC1C;AAED;;GAEG;AACH,MAAM,WAAW,mBAAoB,SAAQ,iBAAiB;IAC5D,IAAI,EAAE,QAAQ,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,eAAe,EAAE,GAAG,IAAI,CAAC;CACpC;AAED;;GAEG;AACH,MAAM,WAAW,gBAAiB,SAAQ,iBAAiB;IACzD,IAAI,EAAE,KAAK,CAAC;IACZ,KAAK,EAAE,aAAa,CAAC;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,gBAAiB,SAAQ,iBAAiB;IACzD,IAAI,EAAE,KAAK,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC;IACZ,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,GAAG,EAAE,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,MAAM,aAAa,GACrB,kBAAkB,GAClB,sBAAsB,GACtB,mBAAmB,GACnB,gBAAgB,GAChB,gBAAgB,CAAC;AAErB;;GAEG;AACH,MAAM,WAAW,SAAS;IACxB,OAAO,EAAE,CAAC,CAAC;IACX,IAAI,EAAE,kBAAkB,GAAG,IAAI,CAAC;CACjC;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B;;OAEG;IACH,GAAG,CAAC,EAAE,SAAS,GAAG,IAAI,CAAC;IAEvB;;OAEG;IACH,IAAI,EAAE,KAAK,GAAG,OAAO,CAAC;IAEtB;;OAEG;IACH,GAAG,CAAC,EAAE,MAAM,CAAC;IAEb;;OAEG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB;;OAEG;IACH,MAAM,CAAC,EAAE,GAAG,EAAE,CAAC;IAEf;;OAEG;IACH,MAAM,CAAC,EAAE,WAAW,EAAE,CAAC;IAEvB;;OAEG;IACH,WAAW,CAAC,EAAE,gBAAgB,CAAC;IAE/B;;OAEG;IACH,UAAU,CAAC,EAAE,gBAAgB,GAAG,IAAI,CAAC;IAErC;;OAEG;IACH,YAAY,CAAC,EAAE,kBAAkB,GAAG,IAAI,CAAC;CAC1C"}

package/dist/src/types/grid.d.ts

@@ -6,10 +6,11 @@ import type { OperationMode } from '@zengrid/shared';
 import type { CellRef, CellRange } from './cell';
 import type { ColumnDef, SortIcons } from './column';
 import type { SortState } from './sort';
-import type { FilterModel, FilterExpression } from './filter';
+import type { FilterModel } from './filter';
 import type { DataLoadRequest, DataLoadResponse } from './data';
 import type { PaginationConfig } from './pagination';
 import type { LoadingConfig } from './loading';
+import type { ZenGridTheme } from '../theming/theme.interface';
 /**
  * Grid options
  */
@@ -19,6 +20,15 @@ export interface GridOptions {
     rowHeight: number | number[];
     colWidth: number | number[];
     columns?: ColumnDef[];
+    /**
+     * Theme to apply - a theme ID string (e.g. 'dark', 'material') or a full ZenGridTheme object
+     */
+    theme?: string | ZenGridTheme;
+    /**
+     * Automatically switch between light/dark themes based on prefers-color-scheme
+     * When enabled, uses 'light' theme for light mode and 'dark' theme for dark mode
+     */
+    autoTheme?: boolean;
     enableSelection?: boolean;
     enableMultiSelection?: boolean;
     /**
@@ -42,57 +52,12 @@ export interface GridOptions {
      * - 'auto': Use backend if onDataRequest provided, else frontend
      */
     dataMode?: OperationMode;
-    /**
-     * Sort mode
-     * - 'frontend': Sort in memory using IndexMap (default)
-     * - 'backend': Delegate sorting to server via onSortRequest
-     * - 'auto': Use backend if onSortRequest provided, else frontend
-     */
-    sortMode?: OperationMode;
-    /**
-     * Filter mode
-     * - 'frontend': Filter in memory (default)
-     * - 'backend': Delegate filtering to server via onFilterRequest
-     * - 'auto': Use backend if onFilterRequest provided, else frontend
-     */
-    filterMode?: OperationMode;
     /**
      * Backend data loading callback
      * Called when dataMode is 'backend' or 'auto' (with callback present)
      * Application should fetch data based on request parameters
      */
     onDataRequest?: (request: DataLoadRequest) => Promise<DataLoadResponse>;
-    /**
-     * Backend sorting callback
-     * Called when sortMode is 'backend' or 'auto' (with callback present)
-     * Application should fetch sorted data and call grid.setData()
-     */
-    onSortRequest?: (sortState: SortState[]) => Promise<void> | void;
-    /**
-     * Backend filtering callback
-     * Called when filterMode is 'backend' or 'auto' (with callback present)
-     * Application should fetch filtered data and call grid.setData()
-     *
-     * Receives FilterExpression which contains:
-     * - SQL query with parameters (if using SQL-like syntax)
-     * - Filter models (if using traditional approach)
-     *
-     * @example SQL-like filtering
-     * ```typescript
-     * onFilterRequest: async (filter) => {
-     *   if (filter.type === 'sql') {
-     *     // Backend receives: filter.sql = "age > ? AND status = ?"
-     *     // Backend receives: filter.params = [18, 'active']
-     *     const data = await api.get('/data', {
-     *       filter: filter.sql,
-     *       params: filter.params
-     *     });
-     *     grid.setData(data);
-     *   }
-     * }
-     * ```
-     */
-    onFilterRequest?: (filterExpression: FilterExpression) => Promise<void> | void;
     /**
      * Pagination configuration
      */

package/dist/src/types/grid.d.ts.map

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

package/dist/src/types/index.d.ts

@@ -6,6 +6,7 @@ export * from './cell';
 export * from './column';
 export * from './header';
 export * from './sort';
+export * from './query';
 export * from './filter';
 export * from './pagination';
 export * from './loading';

package/dist/src/types/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/types/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,cAAc,QAAQ,CAAC;AACvB,cAAc,UAAU,CAAC;AACzB,cAAc,UAAU,CAAC;AACzB,cAAc,QAAQ,CAAC;AACvB,cAAc,UAAU,CAAC;AACzB,cAAc,cAAc,CAAC;AAC7B,cAAc,WAAW,CAAC;AAC1B,cAAc,QAAQ,CAAC;AACvB,cAAc,QAAQ,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/types/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,cAAc,QAAQ,CAAC;AACvB,cAAc,UAAU,CAAC;AACzB,cAAc,UAAU,CAAC;AACzB,cAAc,QAAQ,CAAC;AACvB,cAAc,SAAS,CAAC;AACxB,cAAc,UAAU,CAAC;AACzB,cAAc,cAAc,CAAC;AAC7B,cAAc,WAAW,CAAC;AAC1B,cAAc,QAAQ,CAAC;AACvB,cAAc,QAAQ,CAAC"}

package/dist/src/types/query.d.ts

@@ -0,0 +1,64 @@
+/**
+ * Shared query-state envelope.
+ */
+import type { FilterAst } from './filter';
+import type { SortDescriptor } from './sort';
+/**
+ * Query pagination slice.
+ */
+export interface QueryPaginationState {
+    page: number;
+    pageSize: number;
+    offset: number;
+    cursor?: string | null;
+}
+/**
+ * Shared query-state contract.
+ */
+export interface QueryState {
+    version: 1;
+    filter: FilterAst | null;
+    sort: SortDescriptor[] | null;
+    pagination: QueryPaginationState | null;
+}
+/**
+ * Persistence scope for a saved filter preset.
+ */
+export type SavedFilterPresetScope = 'personal' | 'shared' | 'system';
+/**
+ * Named common-view preset backed by the canonical query envelope.
+ *
+ * Presets intentionally reuse {@link QueryState} so saved views stay aligned
+ * with backend request state without depending on legacy filter-only shapes.
+ */
+export interface SavedFilterPreset {
+    /**
+     * Stable application identifier for the preset.
+     */
+    id: string;
+    /**
+     * User-facing preset name.
+     */
+    name: string;
+    /**
+     * Optional helper text shown in preset pickers or menus.
+     */
+    description?: string;
+    /**
+     * Canonical query envelope for the common view.
+     */
+    query: QueryState;
+    /**
+     * Visibility / ownership scope for the preset.
+     */
+    scope?: SavedFilterPresetScope;
+    /**
+     * Whether the preset should be treated as the default starting view.
+     */
+    isDefault?: boolean;
+    /**
+     * Prevents end users from editing or deleting built-in presets.
+     */
+    readonly?: boolean;
+}
+//# sourceMappingURL=query.d.ts.map

package/dist/src/types/query.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"query.d.ts","sourceRoot":"","sources":["../../../src/types/query.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AAC1C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,QAAQ,CAAC;AAE7C;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACxB;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,CAAC,CAAC;IACX,MAAM,EAAE,SAAS,GAAG,IAAI,CAAC;IACzB,IAAI,EAAE,cAAc,EAAE,GAAG,IAAI,CAAC;IAC9B,UAAU,EAAE,oBAAoB,GAAG,IAAI,CAAC;CACzC;AAED;;GAEG;AACH,MAAM,MAAM,sBAAsB,GAAG,UAAU,GAAG,QAAQ,GAAG,QAAQ,CAAC;AAEtE;;;;;GAKG;AACH,MAAM,WAAW,iBAAiB;IAChC;;OAEG;IACH,EAAE,EAAE,MAAM,CAAC;IAEX;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;IAEb;;OAEG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB;;OAEG;IACH,KAAK,EAAE,UAAU,CAAC;IAElB;;OAEG;IACH,KAAK,CAAC,EAAE,sBAAsB,CAAC;IAE/B;;OAEG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC;IAEpB;;OAEG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB"}

package/dist/src/types/sort.d.ts

@@ -1,16 +1,10 @@
 /**
  * Sort types
  */
-import type { OperationMode } from '@zengrid/shared';
 /**
  * Sort direction
  */
 export type SortDirection = 'asc' | 'desc' | null;
-/**
- * Sort mode - alias for OperationMode for backward compatibility
- * @deprecated Use OperationMode from @zengrid/shared instead
- */
-export type SortMode = OperationMode;
 /**
  * Sort state for a column
  */
@@ -19,4 +13,13 @@ export interface SortState {
     direction: SortDirection;
     sortIndex?: number;
 }
+/**
+ * Backend-friendly sort descriptor derived from the grid sort state
+ */
+export interface SortDescriptor {
+    column: number;
+    field?: string;
+    direction: Exclude<SortDirection, null>;
+    sortIndex: number;
+}
 //# sourceMappingURL=sort.d.ts.map

package/dist/src/types/sort.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"sort.d.ts","sourceRoot":"","sources":["../../../src/types/sort.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAErD;;GAEG;AACH,MAAM,MAAM,aAAa,GAAG,KAAK,GAAG,MAAM,GAAG,IAAI,CAAC;AAElD;;;GAGG;AACH,MAAM,MAAM,QAAQ,GAAG,aAAa,CAAC;AAErC;;GAEG;AACH,MAAM,WAAW,SAAS;IACxB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,aAAa,CAAC;IACzB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB"}
+{"version":3,"file":"sort.d.ts","sourceRoot":"","sources":["../../../src/types/sort.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;GAEG;AACH,MAAM,MAAM,aAAa,GAAG,KAAK,GAAG,MAAM,GAAG,IAAI,CAAC;AAElD;;GAEG;AACH,MAAM,WAAW,SAAS;IACxB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,aAAa,CAAC;IACzB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,OAAO,CAAC,aAAa,EAAE,IAAI,CAAC,CAAC;IACxC,SAAS,EAAE,MAAM,CAAC;CACnB"}

package/package.json

@@ -1,15 +1,15 @@
 {
   "name": "@zengrid/core",
-  "version": "1.1.0",
+  "version": "1.2.1",
   "description": "High-performance data grid library with 14 advanced data structures and virtual scrolling",
-  "main": "./dist/index.cjs",
+  "main": "./dist/index.cjs.js",
   "module": "./dist/index.esm.js",
   "types": "./dist/index.d.ts",
   "exports": {
     ".": {
       "types": "./dist/index.d.ts",
       "import": "./dist/index.esm.js",
-      "require": "./dist/index.cjs"
+      "require": "./dist/index.cjs.js"
     },
     "./dist/styles.css": "./dist/src/styles.css",
     "./styles/*": "./dist/src/*"
@@ -42,7 +42,10 @@
   "homepage": "https://github.com/zengrid-dev/zengrid#readme",
   "dependencies": {
     "@preact/signals-core": "^1.13.0",
-    "@zengrid/shared": "^1.1.0",
+    "@zengrid/shared": "^1.2.1",
     "vanilla-calendar-pro": "^3.0.5"
+  },
+  "publishConfig": {
+    "access": "public"
   }
 }

package/dist/src/editing/date-range/calendar-manager.d.ts

@@ -1,17 +0,0 @@
-import type { DateRange, DateRangeEditorNormalizedOptions } from './types';
-/**
- * Initialize both start and end calendars
- */
-export declare function initializeCalendars(startCalendarDiv: HTMLDivElement, endCalendarDiv: HTMLDivElement, currentValue: DateRange, options: DateRangeEditorNormalizedOptions, onStartDateSelect: (date: Date) => void, onEndDateSelect: (date: Date) => void): Promise<{
-    startCalendar: any;
-    endCalendar: any;
-}>;
-/**
- * Update end calendar's minimum date after start date selection
- */
-export declare function updateEndCalendarMinDate(endCalendar: any, startDate: Date | null, endDate: Date | null): void;
-/**
- * Reinitialize calendars (for Clear button)
- */
-export declare function reinitializeCalendars(startCalendar: any, endCalendar: any, minDate: Date | string): void;
-//# sourceMappingURL=calendar-manager.d.ts.map

package/dist/src/editing/date-range/calendar-manager.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"calendar-manager.d.ts","sourceRoot":"","sources":["../../../../src/editing/date-range/calendar-manager.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,gCAAgC,EAAE,MAAM,SAAS,CAAC;AAG3E;;GAEG;AACH,wBAAsB,mBAAmB,CACvC,gBAAgB,EAAE,cAAc,EAChC,cAAc,EAAE,cAAc,EAC9B,YAAY,EAAE,SAAS,EACvB,OAAO,EAAE,gCAAgC,EACzC,iBAAiB,EAAE,CAAC,IAAI,EAAE,IAAI,KAAK,IAAI,EACvC,eAAe,EAAE,CAAC,IAAI,EAAE,IAAI,KAAK,IAAI,GACpC,OAAO,CAAC;IAAE,aAAa,EAAE,GAAG,CAAC;IAAC,WAAW,EAAE,GAAG,CAAA;CAAE,CAAC,CAwDnD;AAED;;GAEG;AACH,wBAAgB,wBAAwB,CACtC,WAAW,EAAE,GAAG,EAChB,SAAS,EAAE,IAAI,GAAG,IAAI,EACtB,OAAO,EAAE,IAAI,GAAG,IAAI,GACnB,IAAI,CAWN;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CACnC,aAAa,EAAE,GAAG,EAClB,WAAW,EAAE,GAAG,EAChB,OAAO,EAAE,IAAI,GAAG,MAAM,GACrB,IAAI,CAeN"}

package/dist/src/editing/date-range/event-handlers.d.ts

@@ -1,30 +0,0 @@
-import type { EditorParams } from '../cell-editor.interface';
-import type { DateRange, DateRangeEditorNormalizedOptions } from './types';
-/**
- * Create date selection handlers
- */
-export declare function createDateSelectionHandlers(currentValue: DateRange, _inputElement: HTMLInputElement | null, calendarWrapper: HTMLDivElement | null, endCalendar: any, _options: DateRangeEditorNormalizedOptions, updateInputDisplay: () => void): {
-    handleStartDateSelect: (date: Date) => void;
-    handleEndDateSelect: (date: Date) => void;
-};
-/**
- * Create button action handlers
- */
-export declare function createButtonHandlers(currentValue: DateRange, initialValue: DateRange, calendarWrapper: HTMLDivElement | null, startCalendar: any, endCalendar: any, options: DateRangeEditorNormalizedOptions, params: EditorParams | null, updateInputDisplay: () => void): {
-    handleClear: () => void;
-    handleCancel: () => void;
-    handleApply: () => void;
-};
-/**
- * Setup scroll handler for calendar repositioning
- */
-export declare function setupScrollHandler(calendarWrapper: HTMLDivElement | null, inputElement: HTMLInputElement | null, cellElement: HTMLElement | null, gridScrollContainer: HTMLElement | null, currentValue: DateRange, params: EditorParams | null): ((e: Event) => void) | null;
-/**
- * Setup resize handler for calendar repositioning
- */
-export declare function setupResizeHandler(calendarWrapper: HTMLDivElement | null, inputElement: HTMLInputElement | null): (() => void) | null;
-/**
- * Update input display with current value
- */
-export declare function updateInputElementDisplay(inputElement: HTMLInputElement | null, currentValue: DateRange, format: string): void;
-//# sourceMappingURL=event-handlers.d.ts.map

package/dist/src/editing/date-range/event-handlers.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"event-handlers.d.ts","sourceRoot":"","sources":["../../../../src/editing/date-range/event-handlers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAC7D,OAAO,KAAK,EAAE,SAAS,EAAE,gCAAgC,EAAE,MAAM,SAAS,CAAC;AAO3E;;GAEG;AACH,wBAAgB,2BAA2B,CACzC,YAAY,EAAE,SAAS,EACvB,aAAa,EAAE,gBAAgB,GAAG,IAAI,EACtC,eAAe,EAAE,cAAc,GAAG,IAAI,EACtC,WAAW,EAAE,GAAG,EAChB,QAAQ,EAAE,gCAAgC,EAC1C,kBAAkB,EAAE,MAAM,IAAI;kCAEO,IAAI,KAAG,IAAI;gCAYb,IAAI,KAAG,IAAI;EAS/C;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAClC,YAAY,EAAE,SAAS,EACvB,YAAY,EAAE,SAAS,EACvB,eAAe,EAAE,cAAc,GAAG,IAAI,EACtC,aAAa,EAAE,GAAG,EAClB,WAAW,EAAE,GAAG,EAChB,OAAO,EAAE,gCAAgC,EACzC,MAAM,EAAE,YAAY,GAAG,IAAI,EAC3B,kBAAkB,EAAE,MAAM,IAAI;uBAEN,IAAI;wBAUH,IAAI;uBAML,IAAI;EAO7B;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAChC,eAAe,EAAE,cAAc,GAAG,IAAI,EACtC,YAAY,EAAE,gBAAgB,GAAG,IAAI,EACrC,WAAW,EAAE,WAAW,GAAG,IAAI,EAC/B,mBAAmB,EAAE,WAAW,GAAG,IAAI,EACvC,YAAY,EAAE,SAAS,EACvB,MAAM,EAAE,YAAY,GAAG,IAAI,GAC1B,CAAC,CAAC,CAAC,EAAE,KAAK,KAAK,IAAI,CAAC,GAAG,IAAI,CAkB7B;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAChC,eAAe,EAAE,cAAc,GAAG,IAAI,EACtC,YAAY,EAAE,gBAAgB,GAAG,IAAI,GACpC,CAAC,MAAM,IAAI,CAAC,GAAG,IAAI,CASrB;AAED;;GAEG;AACH,wBAAgB,yBAAyB,CACvC,YAAY,EAAE,gBAAgB,GAAG,IAAI,EACrC,YAAY,EAAE,SAAS,EACvB,MAAM,EAAE,MAAM,GACb,IAAI,CAUN"}