ag-grid-url-sync 0.2.1 → 0.2.3

package/LICENSE

@@ -0,0 +1,7 @@
+Copyright 2025 NearForm
+
+Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

package/README.md

@@ -2,11 +2,13 @@
 
 # AG Grid URL Sync
 
-A lightweight TypeScript library for synchronizing AG Grid text filters with URL parameters, enabling shareable filter states through clean, human-readable URLs.
+A lightweight TypeScript library for synchronizing AG Grid text and number filters with URL parameters, enabling shareable filter states through clean, human-readable URLs.
 
 ## Features
 
 - 🔍 **Complete text filter support** - All 8 AG Grid text operations (contains, equals, not contains, not equal, starts with, ends with, blank, not blank)
+- 🔢 **Complete number filter support** - All 9 AG Grid number operations (equals, not equal, greater than, greater than or equal, less than, less than or equal, in range, blank, not blank)
+- 🔢 **Complete date filter support** - All 9 AG Grid date operations (equals, not equal, before, before or equal, after, after or equal, in range, blank, not blank) with strict ISO date validation (YYYY-MM-DD)
 - 🔗 Manual URL generation for sharing filter states
 - ↔️ Bidirectional sync between grid and URL
 - 🛠️ Framework agnostic - works with any AG Grid setup
@@ -21,7 +23,9 @@ A lightweight TypeScript library for synchronizing AG Grid text filters with URL
 
 ## Supported Filter Types
 
-Supports **all AG Grid text filter operations** (8 total) with clean, human-readable URL parameters:
+Supports **all AG Grid text, number, and date filter operations** (26 total) with clean, human-readable URL parameters:
+
+### Text Filters (8 operations)
 
 | Filter Type | Operation    | URL Format                   | Example                    | Description                 |
 | ----------- | ------------ | ---------------------------- | -------------------------- | --------------------------- |
@@ -34,41 +38,96 @@ Supports **all AG Grid text filter operations** (8 total) with clean, human-read
 | **Text**    | Blank        | `f_column_blank=true`        | `f_optional_blank=true`    | Field is empty/null         |
 | **Text**    | Not Blank    | `f_column_notBlank=true`     | `f_required_notBlank=true` | Field has any value         |
 
-> **💡 Naming Convention Note**: URL parameters use short, clean names for better readability (`eq` for equals, `neq` for not equal). These are automatically converted to the proper AG Grid operation names (`equals`, `notEqual`) internally. This design keeps URLs concise while maintaining full compatibility with AG Grid's filter API.
+### Number Filters (9 operations)
+
+| Filter Type | Operation             | URL Format               | Example                  | Description                   |
+| ----------- | --------------------- | ------------------------ | ------------------------ | ----------------------------- |
+| **Number**  | Equals                | `f_column_eq=value`      | `f_age_eq=30`            | Number equals value exactly   |
+| **Number**  | Not Equal             | `f_column_neq=value`     | `f_salary_neq=50000`     | Number does not equal value   |
+| **Number**  | Greater Than          | `f_column_gt=value`      | `f_experience_gt=5`      | Number is greater than value  |
+| **Number**  | Greater Than or Equal | `f_column_gte=value`     | `f_score_gte=85`         | Number is ≥ value             |
+| **Number**  | Less Than             | `f_column_lt=value`      | `f_budget_lt=10000`      | Number is less than value     |
+| **Number**  | Less Than or Equal    | `f_column_lte=value`     | `f_hours_lte=40`         | Number is ≤ value             |
+| **Number**  | In Range              | `f_column_range=min,max` | `f_age_range=25,45`      | Number is between min and max |
+| **Number**  | Blank                 | `f_column_blank=true`    | `f_bonus_blank=true`     | Field is empty/null           |
+| **Number**  | Not Blank             | `f_column_notBlank=true` | `f_salary_notBlank=true` | Field has any numeric value   |
+
+### Date Filters (9 operations)
+
+| Filter Type | Operation       | URL Format                     | Example                                    | Description                               |
+| ----------- | --------------- | ------------------------------ | ------------------------------------------ | ----------------------------------------- |
+| **Date**    | Equals          | `f_column_eq=YYYY-MM-DD`       | `f_created_eq=2024-01-15`                  | Date equals value exactly                 |
+| **Date**    | Not Equal       | `f_column_neq=YYYY-MM-DD`      | `f_deadline_neq=2024-12-31`                | Date does not equal value                 |
+| **Date**    | Before          | `f_column_before=YYYY-MM-DD`   | `f_deadline_before=2024-12-31`             | Date is before value                      |
+| **Date**    | Before or Equal | `f_column_beforeEq=YYYY-MM-DD` | `f_archived_beforeEq=2024-12-31`           | Date is before or equal to value          |
+| **Date**    | After           | `f_column_after=YYYY-MM-DD`    | `f_created_after=2024-01-01`               | Date is after value                       |
+| **Date**    | After or Equal  | `f_column_afterEq=YYYY-MM-DD`  | `f_updated_afterEq=2024-06-01`             | Date is after or equal to value           |
+| **Date**    | In Range        | `f_column_daterange=start,end` | `f_period_daterange=2024-01-01,2024-12-31` | Date is between start and end (inclusive) |
+| **Date**    | Blank           | `f_column_blank=true`          | `f_deadline_blank=true`                    | Date field is empty/null                  |
+| **Date**    | Not Blank       | `f_column_notBlank=true`       | `f_created_notBlank=true`                  | Date field has any value                  |
+
+> **🗓️ Date Format Note**: Date filters require strict ISO format (`YYYY-MM-DD`). All date values are validated for real calendar dates, including leap years and month boundaries. Invalid or non-ISO dates will be rejected.
 
 ### Filter Detection
 
 The library automatically works with:
 
-- Columns configured with `filter: 'agTextColumnFilter'`
+- **Text columns** configured with `filter: 'agTextColumnFilter'`
+- **Number columns** configured with `filter: 'agNumberColumnFilter'`
+- **Auto-detection** based on `cellDataType: 'number'` configuration
 - Columns with `filter: true` (AG Grid's default text filter)
-- Any column where users apply text-based filters
-- All AG Grid text filter operations through the filter menu
+- Any column where users apply text, number, or date-based filters
+- All AG Grid text, number, and date filter operations through the filter menu
+- **Mixed filter types** - combine text, number, and date filters in the same URL
 
 ### URL Examples
 
-**Simple filter:**
+**Simple text filter:**
 
 ```
 https://app.com/data?f_name_contains=john
 ```
 
-**Multiple operations:**
+**Simple number filter:**
+
+```
+https://app.com/data?f_salary_gt=75000
+```
+
+**Simple date filter:**
+
+```
+https://app.com/data?f_created_eq=2024-01-15
+```
+
+**Date range filter:**
 
 ```
-https://app.com/data?f_name_contains=john&f_department_eq=Engineering&f_email_startsWith=admin&f_status_neq=inactive
+https://app.com/data?f_period_daterange=2024-01-01,2024-12-31
 ```
 
-**Complex filtering with all operations:**
+**Date before/after filter:**
 
 ```
-https://app.com/data?f_name_contains=john&f_email_startsWith=admin&f_status_neq=inactive&f_description_endsWith=test&f_optional_blank=true&f_required_notBlank=true&f_tags_notContains=spam&f_title_eq=manager
+https://app.com/data?f_deadline_before=2024-12-31&f_created_after=2024-01-01
 ```
 
-**Blank operations:**
+**Mixed text, number, and date filters:**
 
 ```
-https://app.com/data?f_comments_blank=true&f_name_notBlank=true
+https://app.com/data?f_name_contains=john&f_department_eq=Engineering&f_salary_gte=80000&f_age_range=25,45&f_created_after=2024-01-01
+```
+
+**All date operations:**
+
+```
+https://app.com/data?f_created_eq=2024-01-15&f_deadline_neq=2024-12-31&f_start_after=2024-01-01&f_end_before=2024-12-31&f_updated_afterEq=2024-06-01&f_archived_beforeEq=2024-12-31&f_period_daterange=2024-01-01,2024-12-31&f_optional_blank=true&f_required_notBlank=true
+```
+
+**Blank operations (text, number, and date):**
+
+```
+https://app.com/data?f_comments_blank=true&f_bonus_blank=true&f_name_notBlank=true&f_salary_notBlank=true&f_deadline_blank=true&f_created_notBlank=true
 ```
 
 ## Installation
@@ -177,13 +236,23 @@ import { createUrlSync } from 'ag-grid-url-sync'
 // Initialize with AG Grid API
 const urlSync = createUrlSync(gridApi)
 
-// Generate shareable URL with current filters
+// Generate shareable URL with current filters (text and number)
 const shareableUrl = urlSync.generateUrl()
+// Result: https://app.com/data?f_name_contains=john&f_salary_gte=80000&f_age_range=25,45
 
-// Apply filters from URL
-urlSync.applyFromUrl()
+// Apply filters from URL (automatically detects text vs number columns)
+urlSync.applyFromUrl(
+  'https://app.com/data?f_name_contains=manager&f_salary_gt=75000'
+)
 
-// Clear all text filters
+// Apply specific filter programmatically
+urlSync.applyFilters({
+  name: { filterType: 'text', type: 'contains', filter: 'john' },
+  salary: { filterType: 'number', type: 'greaterThan', filter: 75000 },
+  age: { filterType: 'number', type: 'inRange', filter: 25, filterTo: 45 }
+})
+
+// Clear all text and number filters
 urlSync.clearFilters()
 ```
 
@@ -241,10 +310,32 @@ function GridComponent() {
         <AgGridReact
           onGridReady={params => setGridApi(params.api)}
           rowData={rowData}
-          columnDefs={columnDefs}
+          columnDefs={[
+            {
+              field: 'name',
+              filter: 'agTextColumnFilter',
+              floatingFilter: true
+            },
+            {
+              field: 'email',
+              filter: 'agTextColumnFilter',
+              floatingFilter: true
+            },
+            {
+              field: 'salary',
+              filter: 'agNumberColumnFilter',
+              floatingFilter: true
+            },
+            {
+              field: 'age',
+              filter: 'agNumberColumnFilter',
+              floatingFilter: true
+            }
+          ]}
           defaultColDef={{
-            filter: 'agTextColumnFilter',
-            floatingFilter: true
+            flex: 1,
+            sortable: true,
+            resizable: true
           }}
         />
       </div>
@@ -253,65 +344,6 @@ function GridComponent() {
 }
 ```
 
-### React Router Integration
-
-For single-page applications using React Router, you can sync filters with the browser URL:
-
-```tsx
-import React, { useState } from 'react'
-import { useNavigate, useLocation } from 'react-router-dom'
-import { useAGGridUrlSync } from 'ag-grid-url-sync/react'
-
-function RouterGridComponent() {
-  const [gridApi, setGridApi] = useState(null)
-  const navigate = useNavigate()
-  const location = useLocation()
-
-  const { shareUrl, clearFilters, hasFilters, isReady } = useAGGridUrlSync(
-    gridApi,
-    {
-      autoApplyOnMount: true, // Automatically apply filters from URL on mount
-      paramPrefix: 'f_'
-    }
-  )
-
-  // Update browser URL with current filters
-  const updateUrlWithFilters = () => {
-    const url = shareUrl()
-    const urlParams = new URL(url).searchParams
-    const currentParams = new URLSearchParams(location.search)
-
-    // Clear existing filter params
-    for (const [key] of currentParams) {
-      if (key.startsWith('f_')) {
-        currentParams.delete(key)
-      }
-    }
-
-    // Add current filter params
-    for (const [key, value] of urlParams) {
-      currentParams.set(key, value)
-    }
-
-    navigate(`${location.pathname}?${currentParams.toString()}`, {
-      replace: true
-    })
-  }
-
-  return (
-    <div>
-      <button onClick={updateUrlWithFilters} disabled={!isReady}>
-        Update URL with Filters
-      </button>
-      <button onClick={clearFilters} disabled={!hasFilters}>
-        Clear All Filters
-      </button>
-      {/* Grid component */}
-    </div>
-  )
-}
-```
-
 ### React Hook API
 
 #### `useAGGridUrlSync(gridApi, options?)`
@@ -449,16 +481,21 @@ The library generates clean, human-readable URLs:
 
 ```
 Base URL: https://app.com/page
-With filters: https://app.com/page?f_name_contains=john&f_status_eq=active
+With text filters: https://app.com/page?f_name_contains=john&f_status_eq=active
+With number filters: https://app.com/page?f_salary_gte=75000&f_age_range=25,45
+Mixed filters: https://app.com/page?f_name_contains=john&f_salary_gte=75000&f_age_lt=50
 ```
 
 Parameter structure:
 
 - Prefix: `f_` (configurable - useful for multi-grid scenarios)
 - Format: `f_{columnName}_{operation}={value}`
-- Operations: `contains`, `eq` (equals)
+- **Text Operations**: `contains`, `eq`, `neq`, `startsWith`, `endsWith`, `notContains`, `blank`, `notBlank`
+- **Number Operations**: `eq`, `neq`, `gt`, `gte`, `lt`, `lte`, `range`, `blank`, `notBlank`
+- **Date Operations**: `eq`, `neq`, `before`, `beforeEq`, `after`, `afterEq`, `daterange`, `blank`, `notBlank`
+- **Range Format**: `f_column_range=min,max` (comma-separated values)
 - Standard URL encoding for special characters
-- Supports column names with underscores (e.g., `user_id`, `created_date`)
+- Supports column names with underscores (e.g., `user_id`, `salary_base`, `created_date`)
 
 ## API Reference
 
@@ -568,32 +605,37 @@ Check out the [examples](./examples) directory for comprehensive working demos:
 Comprehensive demonstration showcasing all features:
 
 - **Complete text filter support** - All 8 AG Grid text operations (contains, equals, not contains, not equal, starts with, ends with, blank, not blank)
-- **Filter scenarios** - Pre-configured examples (Sales team, Engineering, Executive view, etc.)
-- **New operation demos** - Dedicated buttons for startsWith, endsWith, and notContains filters
+- **Complete number filter support** - All 9 AG Grid number operations (equals, not equal, greater than, greater than or equal, less than, less than or equal, in range, blank, not blank)
+- **Complete date filter support** - All 9 AG Grid date operations (equals, not equal, before, before or equal, after, after or equal, in range, blank, not blank)
+- **Mixed filter scenarios** - Text, number, and date filters working together (Sales team + salary filters, Engineering + experience, Executive view with high salaries)
+- **Number operation demos** - Dedicated buttons for salary ranges, age filtering, experience thresholds, and blank number fields
 - **URL sharing workflow** - Copy to clipboard, email, and Slack integration
-- **Performance monitoring** - Real-time benchmarks and stress testing
-- **Error handling** - Malformed URL and invalid filter testing
-- **Complete API showcase** - Generate URLs, apply filters, clear filters
+- **Performance monitoring** - Real-time benchmarks and stress testing with mixed filter types
+- **Error handling** - Malformed URL and invalid filter testing for both text, number, and date
+- **Complete API showcase** - Generate URLs, apply filters, clear filters with comprehensive examples
 
 ### ⚛️ [React Integration](./examples/react-basic/basic-grid.tsx)
 
 Clean React component showing the `useAGGridUrlSync` hook:
 
-- React hook integration with AG Grid
-- Automatic filter state management
+- React hook integration with AG Grid for text, number, and date filters
+- Automatic filter state management for mixed filter types
 - Share button with clipboard functionality
 - Filter status indicators and controls
-- Auto-apply filters on component mount
-- Full TypeScript support
+- Auto-apply filters on component mount with all filter types
+- Enhanced employee data with salary, age, and experience columns
+- Full TypeScript support with comprehensive type coverage
 
 ### 📊 [Shared Data](./examples/shared-data.js)
 
 Common data and column definitions used across examples:
 
-- Employee data with realistic company information
-- Project data with status and priority fields
-- Column definitions with complete text filter support
-- All 8 text filter operations enabled by default
+- Enhanced employee data with salary, age, and experience number fields
+- Project data with budget and numeric fields for comprehensive testing
+- Column definitions with complete text, number, and date filter support
+- All 8 text filter operations, 9 number filter operations, and 9 date filter operations enabled
+- Realistic data ranges for demonstrating number and date filters (salaries $58K-$95K, ages 26-42, experience 3-15 years)
+- Includes null values for demonstrating blank/notBlank operations
 
 All examples work out-of-the-box and demonstrate the complete functionality. The HTML demo can be opened directly in your browser, while the React example shows clean integration patterns.
 
@@ -607,6 +649,6 @@ All examples work out-of-the-box and demonstrate the complete functionality. The
 
 ## License
 
-This project is licensed under the ISC License - see the [LICENSE](LICENSE) file for details.
+This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.
 
 [![banner](https://raw.githubusercontent.com/nearform/.github/refs/heads/master/assets/os-banner-green.svg)](https://www.nearform.com/contact/?utm_source=open-source&utm_medium=banner&utm_campaign=os-project-pages)

package/dist/core/grid-integration.d.ts

@@ -1,4 +1,9 @@
 import type { FilterState, InternalConfig } from './types.js';
+import type { GridApi } from 'ag-grid-community';
+/**
+ * Detects the expected filter type for a column based on AG Grid configuration
+ */
+export declare function detectColumnFilterType(gridApi: GridApi, columnId: string): 'text' | 'number' | 'date';
 /**
  * Gets the current filter model from AG Grid
  */

package/dist/core/grid-integration.js

@@ -1,4 +1,63 @@
-import { AG_GRID_OPERATION_NAMES, REVERSE_AG_GRID_OPERATION_NAMES } from './types.js';
+import { AG_GRID_OPERATION_NAMES, REVERSE_AG_GRID_OPERATION_NAMES, TEXT_FILTER_OPERATIONS, NUMBER_FILTER_OPERATIONS, DATE_FILTER_OPERATIONS } from './types.js';
+/**
+ * Converts a date string to ISO format (YYYY-MM-DD)
+ * Handles both date strings and undefined values
+ * Returns an empty string if the input is undefined or invalid
+ */
+function toIsoDateString(val) {
+    if (!val)
+        return '';
+    const match = val.match(/^(\d{4}-\d{2}-\d{2})/);
+    return match?.[1] ? match[1] : val || '';
+}
+/**
+ * Type predicate to check if an operation is a valid text filter operation
+ */
+function isTextFilterOperation(operation) {
+    return TEXT_FILTER_OPERATIONS.includes(operation);
+}
+/**
+ * Type predicate to check if an operation is a valid number filter operation
+ */
+function isNumberFilterOperation(operation) {
+    return NUMBER_FILTER_OPERATIONS.includes(operation);
+}
+/**
+ * Type predicate to check if an operation is a valid date filter operation
+ */
+function isDateFilterOperation(operation) {
+    return DATE_FILTER_OPERATIONS.includes(operation);
+}
+/**
+ * Detects the expected filter type for a column based on AG Grid configuration
+ */
+export function detectColumnFilterType(gridApi, columnId) {
+    try {
+        const column = gridApi.getColumn(columnId);
+        if (!column)
+            return 'text'; // Default to text for unknown columns
+        const colDef = column.getColDef();
+        // 1. Explicit filter configuration takes priority
+        if (colDef.filter === 'agDateColumnFilter')
+            return 'date';
+        if (colDef.filter === 'agNumberColumnFilter')
+            return 'number';
+        if (colDef.filter === 'agTextColumnFilter')
+            return 'text';
+        // 2. Cell data type configuration
+        if (colDef.cellDataType === 'date')
+            return 'date';
+        if (colDef.cellDataType === 'number')
+            return 'number';
+        if (colDef.cellDataType === 'text')
+            return 'text';
+        // 3. Default to text for backward compatibility
+        return 'text';
+    }
+    catch {
+        return 'text'; // Safe fallback
+    }
+}
 /**
  * Gets the current filter model from AG Grid
  */
@@ -12,17 +71,71 @@ export function getFilterModel(config) {
         for (const [column, filter] of Object.entries(model)) {
             if (!filter || typeof filter !== 'object')
                 continue;
-            const { filterType, type, filter: value } = filter;
-            if (filterType !== 'text')
-                continue;
-            // Map AG Grid operations back to our internal operations using centralized mapping
-            const internalOperation = REVERSE_AG_GRID_OPERATION_NAMES[type];
-            if (internalOperation) {
-                filterState[column] = {
-                    filterType: 'text',
-                    type: internalOperation,
-                    filter: value || ''
+            const { filterType, type, filter: value, filterTo, dateFrom, dateTo } = filter;
+            // Handle text filters
+            if (filterType === 'text') {
+                // Map AG Grid operations back to our internal operations using centralized mapping
+                const internalOperation = REVERSE_AG_GRID_OPERATION_NAMES[type];
+                // Use type predicate to validate and narrow the type
+                if (internalOperation && isTextFilterOperation(internalOperation)) {
+                    filterState[column] = {
+                        filterType: 'text',
+                        type: internalOperation, // Now properly typed as TextFilterOperation
+                        filter: String(value || '')
+                    };
+                }
+            }
+            // Handle number filters
+            else if (filterType === 'number') {
+                // Map AG Grid number operations back to our internal operations
+                const internalOperation = REVERSE_AG_GRID_OPERATION_NAMES[type];
+                // Use type predicate to validate and narrow the type
+                if (internalOperation && isNumberFilterOperation(internalOperation)) {
+                    const numberFilter = {
+                        filterType: 'number',
+                        type: internalOperation, // Now properly typed as NumberFilterOperation
+                        filter: typeof value === 'number' ? value : 0
+                    };
+                    // Handle range operations
+                    if (internalOperation === 'inRange' && typeof filterTo === 'number') {
+                        ;
+                        numberFilter.filterTo = filterTo;
+                    }
+                    filterState[column] = numberFilter;
+                }
+            }
+            // Handle date filters
+            else if (filterType === 'date') {
+                // Map AG Grid date operations back to our internal operations
+                const internalOperation = REVERSE_AG_GRID_OPERATION_NAMES[type];
+                // For date operations, we need to handle the special case where AG Grid uses
+                // generic operation names but we have date-specific internal names
+                let mappedOperation = internalOperation;
+                // Map AG Grid generic date operations to our date-specific operations
+                const AG_GRID_TO_DATE_OPERATION_MAP = {
+                    lessThan: 'dateBefore',
+                    lessThanOrEqual: 'dateBeforeOrEqual',
+                    greaterThan: 'dateAfter',
+                    greaterThanOrEqual: 'dateAfterOrEqual',
+                    inRange: 'dateRange'
                 };
+                mappedOperation = type
+                    ? AG_GRID_TO_DATE_OPERATION_MAP[type] || internalOperation
+                    : internalOperation;
+                // Use type predicate to validate and narrow the type
+                if (mappedOperation && isDateFilterOperation(mappedOperation)) {
+                    const dateFilter = {
+                        filterType: 'date',
+                        type: mappedOperation,
+                        filter: toIsoDateString(dateFrom || String(value || ''))
+                    };
+                    // Handle date range operations (AG Grid uses dateFrom/dateTo)
+                    if (mappedOperation === 'dateRange' && dateTo) {
+                        ;
+                        dateFilter.filterTo = toIsoDateString(dateTo);
+                    }
+                    filterState[column] = dateFilter;
+                }
             }
         }
         return filterState;
@@ -34,6 +147,72 @@ export function getFilterModel(config) {
         return {};
     }
 }
+/**
+ * Converts internal filter to AG Grid filter format
+ */
+function convertToAGGridFilter(filter) {
+    if (filter.filterType === 'date') {
+        // Handle date range operations
+        if (filter.type === 'dateRange') {
+            return {
+                filterType: 'date',
+                type: 'inRange', // AG Grid uses 'inRange' for date ranges
+                dateFrom: filter.filter,
+                dateTo: filter.filterTo || null
+            };
+        }
+        // Handle blank operations for dates
+        if (filter.type === 'blank' || filter.type === 'notBlank') {
+            return {
+                filterType: 'date',
+                type: filter.type,
+                dateFrom: null,
+                dateTo: null
+            };
+        }
+        // Map date-specific operations to AG Grid generic operations
+        const dateOperationMapping = {
+            dateBefore: 'lessThan',
+            dateBeforeOrEqual: 'lessThanOrEqual',
+            dateAfter: 'greaterThan',
+            dateAfterOrEqual: 'greaterThanOrEqual'
+        };
+        const agOperation = dateOperationMapping[filter.type] ||
+            AG_GRID_OPERATION_NAMES[filter.type];
+        return {
+            filterType: 'date',
+            type: agOperation,
+            dateFrom: filter.filter,
+            dateTo: null
+        };
+    }
+    if (filter.filterType === 'number') {
+        const agGridOperation = AG_GRID_OPERATION_NAMES[filter.type];
+        if (filter.type === 'inRange') {
+            const baseFilter = {
+                filterType: 'number',
+                type: agGridOperation,
+                filter: filter.filter
+            };
+            // Only include filterTo if it's defined
+            return filter.filterTo !== undefined
+                ? { ...baseFilter, filterTo: filter.filterTo }
+                : baseFilter;
+        }
+        return {
+            filterType: 'number',
+            type: agGridOperation,
+            filter: filter.filter
+        };
+    }
+    // Text filter handling
+    const agGridOperation = AG_GRID_OPERATION_NAMES[filter.type];
+    return {
+        filterType: 'text',
+        type: agGridOperation,
+        filter: filter.filter
+    };
+}
 /**
  * Applies a filter state to AG Grid
  */
@@ -41,20 +220,26 @@ export function applyFilterModel(filterState, config) {
     try {
         const model = {};
         for (const [column, filter] of Object.entries(filterState)) {
-            if (filter &&
-                typeof filter === 'object' &&
-                filter.filterType === 'text') {
-                // Convert our internal operation to AG Grid operation using centralized mapping
-                const agGridOperation = AG_GRID_OPERATION_NAMES[filter.type];
-                if (agGridOperation) {
-                    model[column] = {
-                        filterType: filter.filterType,
-                        type: agGridOperation,
-                        filter: filter.filter
-                    };
-                }
+            if (!filter || typeof filter !== 'object')
+                continue;
+            // Detect expected filter type for this column
+            const expectedType = detectColumnFilterType(config.gridApi, column);
+            // Validate filter type compatibility
+            if (filter.filterType === 'date' && expectedType !== 'date') {
+                console.warn(`Column '${column}' expects a ${expectedType} filter but received a date filter. This may indicate a configuration mismatch in the column definition or filter application.`);
+                continue;
+            }
+            if (filter.filterType === 'number' && expectedType !== 'number') {
+                console.warn(`Column '${column}' expects a ${expectedType} filter but received a number filter. This may indicate a configuration mismatch in the column definition or filter application.`);
+                continue;
+            }
+            // Convert to AG Grid filter model
+            const agGridFilter = convertToAGGridFilter(filter);
+            if (agGridFilter) {
+                model[column] = agGridFilter;
             }
         }
+        // Apply the filter model to AG Grid
         config.gridApi.setFilterModel(model);
     }
     catch (error) {

package/dist/core/grid-integration.js.map

@@ -1 +1 @@
-{"version":3,"file":"grid-integration.js","sourceRoot":"","sources":["../../src/core/grid-integration.ts"],"names":[],"mappings":"AACA,OAAO,EACL,uBAAuB,EACvB,+BAA+B,EAChC,MAAM,YAAY,CAAA;AAEnB;;GAEG;AACH,MAAM,UAAU,cAAc,CAAC,MAAsB;IACnD,IAAI,CAAC;QACH,MAAM,KAAK,GAAG,MAAM,CAAC,OAAO,CAAC,cAAc,EAAE,CAAA;QAC7C,MAAM,WAAW,GAAgB,EAAE,CAAA;QAEnC,IAAI,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;YACxC,OAAO,WAAW,CAAA;QACpB,CAAC;QAED,KAAK,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;YACrD,IAAI,CAAC,MAAM,IAAI,OAAO,MAAM,KAAK,QAAQ;gBAAE,SAAQ;YAEnD,MAAM,EAAE,UAAU,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,MAAa,CAAA;YACzD,IAAI,UAAU,KAAK,MAAM;gBAAE,SAAQ;YAEnC,mFAAmF;YACnF,MAAM,iBAAiB,GACrB,+BAA+B,CAC7B,IAAoD,CACrD,CAAA;YAEH,IAAI,iBAAiB,EAAE,CAAC;gBACtB,WAAW,CAAC,MAAM,CAAC,GAAG;oBACpB,UAAU,EAAE,MAAM;oBAClB,IAAI,EAAE,iBAAoC;oBAC1C,MAAM,EAAE,KAAK,IAAI,EAAE;iBACpB,CAAA;YACH,CAAC;QACH,CAAC;QAED,OAAO,WAAW,CAAA;IACpB,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,MAAM,CAAC,YAAY,EAAE,CAAC;YACxB,MAAM,CAAC,YAAY,CAAC,KAAc,CAAC,CAAA;QACrC,CAAC;QACD,OAAO,EAAE,CAAA;IACX,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,gBAAgB,CAC9B,WAAwB,EACxB,MAAsB;IAEtB,IAAI,CAAC;QACH,MAAM,KAAK,GAAQ,EAAE,CAAA;QAErB,KAAK,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,WAAW,CAAC,EAAE,CAAC;YAC3D,IACE,MAAM;gBACN,OAAO,MAAM,KAAK,QAAQ;gBAC1B,MAAM,CAAC,UAAU,KAAK,MAAM,EAC5B,CAAC;gBACD,gFAAgF;gBAChF,MAAM,eAAe,GACnB,uBAAuB,CACrB,MAAM,CAAC,IAA4C,CACpD,CAAA;gBACH,IAAI,eAAe,EAAE,CAAC;oBACpB,KAAK,CAAC,MAAM,CAAC,GAAG;wBACd,UAAU,EAAE,MAAM,CAAC,UAAU;wBAC7B,IAAI,EAAE,eAAe;wBACrB,MAAM,EAAE,MAAM,CAAC,MAAM;qBACtB,CAAA;gBACH,CAAC;YACH,CAAC;QACH,CAAC;QAED,MAAM,CAAC,OAAO,CAAC,cAAc,CAAC,KAAK,CAAC,CAAA;IACtC,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,MAAM,CAAC,YAAY,EAAE,CAAC;YACxB,MAAM,CAAC,YAAY,CAAC,KAAc,CAAC,CAAA;QACrC,CAAC;IACH,CAAC;AACH,CAAC"}
+{"version":3,"file":"grid-integration.js","sourceRoot":"","sources":["../../src/core/grid-integration.ts"],"names":[],"mappings":"AAYA,OAAO,EACL,uBAAuB,EACvB,+BAA+B,EAC/B,sBAAsB,EACtB,wBAAwB,EACxB,sBAAsB,EACvB,MAAM,YAAY,CAAA;AAGnB;;;;GAIG;AACH,SAAS,eAAe,CAAC,GAAuB;IAC9C,IAAI,CAAC,GAAG;QAAE,OAAO,EAAE,CAAA;IACnB,MAAM,KAAK,GAAG,GAAG,CAAC,KAAK,CAAC,sBAAsB,CAAC,CAAA;IAC/C,OAAO,KAAK,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,IAAI,EAAE,CAAA;AAC1C,CAAC;AAED;;GAEG;AACH,SAAS,qBAAqB,CAC5B,SAA0B;IAE1B,OAAO,sBAAsB,CAAC,QAAQ,CAAC,SAAgC,CAAC,CAAA;AAC1E,CAAC;AAED;;GAEG;AACH,SAAS,uBAAuB,CAC9B,SAA0B;IAE1B,OAAO,wBAAwB,CAAC,QAAQ,CAAC,SAAkC,CAAC,CAAA;AAC9E,CAAC;AAED;;GAEG;AACH,SAAS,qBAAqB,CAC5B,SAA0B;IAE1B,OAAO,sBAAsB,CAAC,QAAQ,CAAC,SAAgC,CAAC,CAAA;AAC1E,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,sBAAsB,CACpC,OAAgB,EAChB,QAAgB;IAEhB,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,OAAO,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAA;QAC1C,IAAI,CAAC,MAAM;YAAE,OAAO,MAAM,CAAA,CAAC,sCAAsC;QAEjE,MAAM,MAAM,GAAG,MAAM,CAAC,SAAS,EAAE,CAAA;QAEjC,kDAAkD;QAClD,IAAI,MAAM,CAAC,MAAM,KAAK,oBAAoB;YAAE,OAAO,MAAM,CAAA;QACzD,IAAI,MAAM,CAAC,MAAM,KAAK,sBAAsB;YAAE,OAAO,QAAQ,CAAA;QAC7D,IAAI,MAAM,CAAC,MAAM,KAAK,oBAAoB;YAAE,OAAO,MAAM,CAAA;QAEzD,kCAAkC;QAClC,IAAI,MAAM,CAAC,YAAY,KAAK,MAAM;YAAE,OAAO,MAAM,CAAA;QACjD,IAAI,MAAM,CAAC,YAAY,KAAK,QAAQ;YAAE,OAAO,QAAQ,CAAA;QACrD,IAAI,MAAM,CAAC,YAAY,KAAK,MAAM;YAAE,OAAO,MAAM,CAAA;QAEjD,gDAAgD;QAChD,OAAO,MAAM,CAAA;IACf,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,MAAM,CAAA,CAAC,gBAAgB;IAChC,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,cAAc,CAAC,MAAsB;IACnD,IAAI,CAAC;QACH,MAAM,KAAK,GAAG,MAAM,CAAC,OAAO,CAAC,cAAc,EAAE,CAAA;QAC7C,MAAM,WAAW,GAAgB,EAAE,CAAA;QAEnC,IAAI,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;YACxC,OAAO,WAAW,CAAA;QACpB,CAAC;QAED,KAAK,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;YACrD,IAAI,CAAC,MAAM,IAAI,OAAO,MAAM,KAAK,QAAQ;gBAAE,SAAQ;YAEnD,MAAM,EACJ,UAAU,EACV,IAAI,EACJ,MAAM,EAAE,KAAK,EACb,QAAQ,EACR,QAAQ,EACR,MAAM,EACP,GAAG,MAAyB,CAAA;YAE7B,sBAAsB;YACtB,IAAI,UAAU,KAAK,MAAM,EAAE,CAAC;gBAC1B,mFAAmF;gBACnF,MAAM,iBAAiB,GACrB,+BAA+B,CAC7B,IAAoD,CACrD,CAAA;gBAEH,qDAAqD;gBACrD,IAAI,iBAAiB,IAAI,qBAAqB,CAAC,iBAAiB,CAAC,EAAE,CAAC;oBAClE,WAAW,CAAC,MAAM,CAAC,GAAG;wBACpB,UAAU,EAAE,MAAM;wBAClB,IAAI,EAAE,iBAAiB,EAAE,4CAA4C;wBACrE,MAAM,EAAE,MAAM,CAAC,KAAK,IAAI,EAAE,CAAC;qBAC5B,CAAA;gBACH,CAAC;YACH,CAAC;YACD,wBAAwB;iBACnB,IAAI,UAAU,KAAK,QAAQ,EAAE,CAAC;gBACjC,gEAAgE;gBAChE,MAAM,iBAAiB,GACrB,+BAA+B,CAC7B,IAAoD,CACrD,CAAA;gBAEH,qDAAqD;gBACrD,IAAI,iBAAiB,IAAI,uBAAuB,CAAC,iBAAiB,CAAC,EAAE,CAAC;oBACpE,MAAM,YAAY,GAAiB;wBACjC,UAAU,EAAE,QAAQ;wBACpB,IAAI,EAAE,iBAAiB,EAAE,8CAA8C;wBACvE,MAAM,EAAE,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;qBAC9C,CAAA;oBAED,0BAA0B;oBAC1B,IAAI,iBAAiB,KAAK,SAAS,IAAI,OAAO,QAAQ,KAAK,QAAQ,EAAE,CAAC;wBACpE,CAAC;wBAAC,YAAoB,CAAC,QAAQ,GAAG,QAAQ,CAAA;oBAC5C,CAAC;oBAED,WAAW,CAAC,MAAM,CAAC,GAAG,YAAY,CAAA;gBACpC,CAAC;YACH,CAAC;YACD,sBAAsB;iBACjB,IAAI,UAAU,KAAK,MAAM,EAAE,CAAC;gBAC/B,8DAA8D;gBAC9D,MAAM,iBAAiB,GACrB,+BAA+B,CAC7B,IAAoD,CACrD,CAAA;gBAEH,6EAA6E;gBAC7E,mEAAmE;gBACnE,IAAI,eAAe,GAAG,iBAAiB,CAAA;gBAEvC,sEAAsE;gBACtE,MAAM,6BAA6B,GAG/B;oBACF,QAAQ,EAAE,YAAY;oBACtB,eAAe,EAAE,mBAAmB;oBACpC,WAAW,EAAE,WAAW;oBACxB,kBAAkB,EAAE,kBAAkB;oBACtC,OAAO,EAAE,WAAW;iBACZ,CAAA;gBAEV,eAAe,GAAG,IAAI;oBACpB,CAAC,CAAC,6BAA6B,CAAC,IAAI,CAAC,IAAI,iBAAiB;oBAC1D,CAAC,CAAC,iBAAiB,CAAA;gBAErB,qDAAqD;gBACrD,IAAI,eAAe,IAAI,qBAAqB,CAAC,eAAe,CAAC,EAAE,CAAC;oBAC9D,MAAM,UAAU,GAAiB;wBAC/B,UAAU,EAAE,MAAM;wBAClB,IAAI,EAAE,eAAe;wBACrB,MAAM,EAAE,eAAe,CAAC,QAAQ,IAAI,MAAM,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC;qBACzD,CAAA;oBAED,8DAA8D;oBAC9D,IAAI,eAAe,KAAK,WAAW,IAAI,MAAM,EAAE,CAAC;wBAC9C,CAAC;wBAAC,UAAkB,CAAC,QAAQ,GAAG,eAAe,CAAC,MAAM,CAAC,CAAA;oBACzD,CAAC;oBAED,WAAW,CAAC,MAAM,CAAC,GAAG,UAAU,CAAA;gBAClC,CAAC;YACH,CAAC;QACH,CAAC;QAED,OAAO,WAAW,CAAA;IACpB,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,MAAM,CAAC,YAAY,EAAE,CAAC;YACxB,MAAM,CAAC,YAAY,CAAC,KAAc,CAAC,CAAA;QACrC,CAAC;QACD,OAAO,EAAE,CAAA;IACX,CAAC;AACH,CAAC;AAED;;GAEG;AACH,SAAS,qBAAqB,CAAC,MAAoB;IACjD,IAAI,MAAM,CAAC,UAAU,KAAK,MAAM,EAAE,CAAC;QACjC,+BAA+B;QAC/B,IAAI,MAAM,CAAC,IAAI,KAAK,WAAW,EAAE,CAAC;YAChC,OAAO;gBACL,UAAU,EAAE,MAAM;gBAClB,IAAI,EAAE,SAAmC,EAAE,yCAAyC;gBACpF,QAAQ,EAAE,MAAM,CAAC,MAAM;gBACvB,MAAM,EAAE,MAAM,CAAC,QAAQ,IAAI,IAAI;aAChC,CAAA;QACH,CAAC;QAED,oCAAoC;QACpC,IAAI,MAAM,CAAC,IAAI,KAAK,OAAO,IAAI,MAAM,CAAC,IAAI,KAAK,UAAU,EAAE,CAAC;YAC1D,OAAO;gBACL,UAAU,EAAE,MAAM;gBAClB,IAAI,EAAE,MAAM,CAAC,IAA8B;gBAC3C,QAAQ,EAAE,IAAI;gBACd,MAAM,EAAE,IAAI;aACb,CAAA;QACH,CAAC;QAED,6DAA6D;QAC7D,MAAM,oBAAoB,GAA2B;YACnD,UAAU,EAAE,UAAU;YACtB,iBAAiB,EAAE,iBAAiB;YACpC,SAAS,EAAE,aAAa;YACxB,gBAAgB,EAAE,oBAAoB;SACvC,CAAA;QAED,MAAM,WAAW,GACf,oBAAoB,CAAC,MAAM,CAAC,IAAI,CAAC;YAChC,uBAAuB,CACtB,MAAM,CAAC,IAA4C,CACzB,CAAA;QAE9B,OAAO;YACL,UAAU,EAAE,MAAM;YAClB,IAAI,EAAE,WAAqC;YAC3C,QAAQ,EAAE,MAAM,CAAC,MAAM;YACvB,MAAM,EAAE,IAAI;SACb,CAAA;IACH,CAAC;IAED,IAAI,MAAM,CAAC,UAAU,KAAK,QAAQ,EAAE,CAAC;QACnC,MAAM,eAAe,GAAG,uBAAuB,CAC7C,MAAM,CAAC,IAA4C,CAC1B,CAAA;QAE3B,IAAI,MAAM,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;YAC9B,MAAM,UAAU,GAAG;gBACjB,UAAU,EAAE,QAAQ;gBACpB,IAAI,EAAE,eAAe;gBACrB,MAAM,EAAE,MAAM,CAAC,MAAM;aACb,CAAA;YAEV,wCAAwC;YACxC,OAAO,MAAM,CAAC,QAAQ,KAAK,SAAS;gBAClC,CAAC,CAAC,EAAE,GAAG,UAAU,EAAE,QAAQ,EAAE,MAAM,CAAC,QAAQ,EAAE;gBAC9C,CAAC,CAAC,UAAU,CAAA;QAChB,CAAC;QAED,OAAO;YACL,UAAU,EAAE,QAAQ;YACpB,IAAI,EAAE,eAAe;YACrB,MAAM,EAAE,MAAM,CAAC,MAAM;SACtB,CAAA;IACH,CAAC;IAED,uBAAuB;IACvB,MAAM,eAAe,GAAG,uBAAuB,CAC7C,MAAM,CAAC,IAA4C,CAC1B,CAAA;IAC3B,OAAO;QACL,UAAU,EAAE,MAAM;QAClB,IAAI,EAAE,eAAe;QACrB,MAAM,EAAE,MAAM,CAAC,MAAM;KACtB,CAAA;AACH,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,gBAAgB,CAC9B,WAAwB,EACxB,MAAsB;IAEtB,IAAI,CAAC;QACH,MAAM,KAAK,GAAQ,EAAE,CAAA;QAErB,KAAK,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,WAAW,CAAC,EAAE,CAAC;YAC3D,IAAI,CAAC,MAAM,IAAI,OAAO,MAAM,KAAK,QAAQ;gBAAE,SAAQ;YAEnD,8CAA8C;YAC9C,MAAM,YAAY,GAAG,sBAAsB,CAAC,MAAM,CAAC,OAAO,EAAE,MAAM,CAAC,CAAA;YAEnE,qCAAqC;YACrC,IAAI,MAAM,CAAC,UAAU,KAAK,MAAM,IAAI,YAAY,KAAK,MAAM,EAAE,CAAC;gBAC5D,OAAO,CAAC,IAAI,CACV,WAAW,MAAM,eAAe,YAAY,gIAAgI,CAC7K,CAAA;gBACD,SAAQ;YACV,CAAC;YAED,IAAI,MAAM,CAAC,UAAU,KAAK,QAAQ,IAAI,YAAY,KAAK,QAAQ,EAAE,CAAC;gBAChE,OAAO,CAAC,IAAI,CACV,WAAW,MAAM,eAAe,YAAY,kIAAkI,CAC/K,CAAA;gBACD,SAAQ;YACV,CAAC;YAED,kCAAkC;YAClC,MAAM,YAAY,GAAG,qBAAqB,CAAC,MAAM,CAAC,CAAA;YAClD,IAAI,YAAY,EAAE,CAAC;gBACjB,KAAK,CAAC,MAAM,CAAC,GAAG,YAAY,CAAA;YAC9B,CAAC;QACH,CAAC;QAED,oCAAoC;QACpC,MAAM,CAAC,OAAO,CAAC,cAAc,CAAC,KAAK,CAAC,CAAA;IACtC,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,MAAM,CAAC,YAAY,EAAE,CAAC;YACxB,MAAM,CAAC,YAAY,CAAC,KAAc,CAAC,CAAA;QACrC,CAAC;IACH,CAAC;AACH,CAAC"}