ag-grid-url-sync 0.2.2 → 0.2.3

package/README.md

@@ -8,6 +8,7 @@ A lightweight TypeScript library for synchronizing AG Grid text and number filte
 
 - 🔍 **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
@@ -22,7 +23,7 @@ A lightweight TypeScript library for synchronizing AG Grid text and number filte
 
 ## Supported Filter Types
 
-Supports **all AG Grid text and number filter operations** (17 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)
 
@@ -51,7 +52,21 @@ Supports **all AG Grid text and number filter operations** (17 total) with clean
 | **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   |
 
-> **💡 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.
+### 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
 
@@ -61,9 +76,9 @@ The library automatically works with:
 - **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 or number-based filters
-- All AG Grid text and number filter operations through the filter menu
-- **Mixed filter types** - combine text and number filters in the same URL
+- 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
 
@@ -79,34 +94,40 @@ https://app.com/data?f_name_contains=john
 https://app.com/data?f_salary_gt=75000
 ```
 
-**Mixed text and number filters:**
+**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_salary_gte=80000&f_age_range=25,45
+https://app.com/data?f_period_daterange=2024-01-01,2024-12-31
 ```
 
-**Complex filtering with range operations:**
+**Date before/after filter:**
 
 ```
-https://app.com/data?f_name_contains=manager&f_salary_range=60000,100000&f_experience_gte=5&f_status_eq=active
+https://app.com/data?f_deadline_before=2024-12-31&f_created_after=2024-01-01
 ```
 
-**All text operations:**
+**Mixed text, number, and date filters:**
 
 ```
-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_name_contains=john&f_department_eq=Engineering&f_salary_gte=80000&f_age_range=25,45&f_created_after=2024-01-01
 ```
 
-**All number operations:**
+**All date operations:**
 
 ```
-https://app.com/data?f_age_eq=30&f_salary_neq=50000&f_experience_gt=5&f_score_gte=85&f_budget_lt=10000&f_hours_lte=40&f_age_range=25,45&f_bonus_blank=true&f_salary_notBlank=true
+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 (both text and number):**
+**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
+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
@@ -471,6 +492,7 @@ Parameter structure:
 - Format: `f_{columnName}_{operation}={value}`
 - **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`, `salary_base`, `created_date`)
@@ -584,22 +606,23 @@ 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)
 - **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)
-- **Mixed filter scenarios** - Text and number filters working together (Sales team + salary filters, Engineering + experience, Executive view with high salaries)
+- **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 with mixed filter types
-- **Error handling** - Malformed URL and invalid filter testing for both text and numbers
+- **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 for text and number filters
+- 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 with both text and number 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
 
@@ -609,9 +632,9 @@ Common data and column definitions used across examples:
 
 - 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 and number filter support
-- All 8 text filter operations and 9 number filter operations enabled
-- Realistic data ranges for demonstrating number filters (salaries $58K-$95K, ages 26-42, experience 3-15 years)
+- 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.

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

@@ -3,7 +3,7 @@ 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' | null;
+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,15 @@
-import { AG_GRID_OPERATION_NAMES, REVERSE_AG_GRID_OPERATION_NAMES, TEXT_FILTER_OPERATIONS, NUMBER_FILTER_OPERATIONS } 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
  */
@@ -11,6 +22,12 @@ function isTextFilterOperation(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
  */
@@ -18,14 +35,18 @@ export function detectColumnFilterType(gridApi, columnId) {
     try {
         const column = gridApi.getColumn(columnId);
         if (!column)
-            return null;
+            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')
@@ -50,8 +71,8 @@ export function getFilterModel(config) {
         for (const [column, filter] of Object.entries(model)) {
             if (!filter || typeof filter !== 'object')
                 continue;
-            const { filterType, type, filter: value, filterTo } = filter;
-            // Handle both text and number filters
+            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];
@@ -60,10 +81,11 @@ export function getFilterModel(config) {
                     filterState[column] = {
                         filterType: 'text',
                         type: internalOperation, // Now properly typed as TextFilterOperation
-                        filter: value || ''
+                        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];
@@ -82,6 +104,39 @@ export function getFilterModel(config) {
                     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;
     }
@@ -96,6 +151,41 @@ export function getFilterModel(config) {
  * 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') {
@@ -135,8 +225,12 @@ export function applyFilterModel(filterState, config) {
             // 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 text filter but received a number filter. This may indicate a configuration mismatch in the column definition or filter application.`);
+                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
@@ -145,6 +239,7 @@ export function applyFilterModel(filterState, config) {
                 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":"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"}
+{"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"}

package/dist/core/types.d.ts

@@ -1,33 +1,73 @@
-import type { GridApi as AGGridApi, TextFilterModel, NumberFilterModel } from 'ag-grid-community';
+import type { GridApi as AGGridApi, TextFilterModel, NumberFilterModel, DateFilterModel } from 'ag-grid-community';
 /**
  * Configuration options for AG Grid URL Sync
+ *
+ * @example
+ * ```typescript
+ * const config: AGGridUrlSyncConfig = {
+ *   paramPrefix: 'filter_',
+ *   maxValueLength: 500,
+ *   onParseError: (error) => console.warn('Filter parse error:', error)
+ * }
+ * ```
  */
 export interface AGGridUrlSyncConfig {
     /**
-     * Prefix for URL parameters. Default: 'f_'
+     * Prefix for URL parameters
+     * @default 'f_'
+     * @example 'filter_' results in URLs like '?filter_name_contains=john'
      */
     paramPrefix?: string;
     /**
-     * Maximum length for filter values. Default: 200
+     * Maximum length for filter values to prevent URL length issues
+     * @default 200
      */
     maxValueLength?: number;
     /**
-     * Optional error handler for parsing errors
+     * Optional error handler for parsing errors.
+     * Allows graceful error handling without breaking the application.
      */
     onParseError?: (error: Error) => void;
 }
 /**
- * Supported filter operations for both text and number filters
+ * Internal configuration with all required fields and runtime dependencies
  */
-export type FilterOperation = 'contains' | 'eq' | 'notContains' | 'notEqual' | 'startsWith' | 'endsWith' | 'blank' | 'notBlank' | 'lessThan' | 'lessThanOrEqual' | 'greaterThan' | 'greaterThanOrEqual' | 'inRange';
+export interface InternalConfig extends Required<AGGridUrlSyncConfig> {
+    /** AG Grid API instance for filter operations */
+    gridApi: AGGridApi;
+}
+/**
+ * Text-only filter operations for string-based filtering
+ */
+export declare const TEXT_ONLY_OPERATIONS: readonly ["contains", "notContains", "startsWith", "endsWith"];
+/**
+ * Number-only filter operations for numeric comparisons
+ */
+export declare const NUMBER_ONLY_OPERATIONS: readonly ["lessThan", "lessThanOrEqual", "greaterThan", "greaterThanOrEqual", "inRange"];
+/**
+ * Date-specific filter operations for temporal comparisons
+ */
+export declare const DATE_ONLY_OPERATIONS: readonly ["dateBefore", "dateBeforeOrEqual", "dateAfter", "dateAfterOrEqual", "dateRange"];
 /**
- * Valid text filter operations as const array
+ * Operations shared across multiple filter types
  */
-export declare const TEXT_FILTER_OPERATIONS: readonly ["contains", "eq", "notContains", "notEqual", "startsWith", "endsWith", "blank", "notBlank"];
+export declare const SHARED_OPERATIONS: readonly ["eq", "notEqual", "blank", "notBlank"];
 /**
- * Valid number filter operations as const array
+ * All supported filter operations across text, number, and date filters
  */
-export declare const NUMBER_FILTER_OPERATIONS: readonly ["eq", "notEqual", "lessThan", "lessThanOrEqual", "greaterThan", "greaterThanOrEqual", "inRange", "blank", "notBlank"];
+export type FilterOperation = (typeof TEXT_ONLY_OPERATIONS)[number] | (typeof NUMBER_ONLY_OPERATIONS)[number] | (typeof DATE_ONLY_OPERATIONS)[number] | (typeof SHARED_OPERATIONS)[number];
+/**
+ * Complete list of valid text filter operations
+ */
+export declare const TEXT_FILTER_OPERATIONS: readonly ["contains", "notContains", "startsWith", "endsWith", "eq", "notEqual", "blank", "notBlank"];
+/**
+ * Complete list of valid number filter operations
+ */
+export declare const NUMBER_FILTER_OPERATIONS: readonly ["lessThan", "lessThanOrEqual", "greaterThan", "greaterThanOrEqual", "inRange", "eq", "notEqual", "blank", "notBlank"];
+/**
+ * Valid date filter operations as const array
+ */
+export declare const DATE_FILTER_OPERATIONS: readonly ["dateBefore", "dateBeforeOrEqual", "dateAfter", "dateAfterOrEqual", "dateRange", "eq", "notEqual", "blank", "notBlank"];
 /**
  * Text-specific filter operations
  */
@@ -37,71 +77,169 @@ export type TextFilterOperation = (typeof TEXT_FILTER_OPERATIONS)[number];
  */
 export type NumberFilterOperation = (typeof NUMBER_FILTER_OPERATIONS)[number];
 /**
- * Base interface for column filters
+ * Date-specific filter operations
+ */
+export type DateFilterOperation = (typeof DATE_FILTER_OPERATIONS)[number];
+/**
+ * Range operations that require two values (from/to)
  */
-interface BaseColumnFilter {
-    type: FilterOperation;
+export type RangeOperation = 'inRange' | 'dateRange';
+/**
+ * Operations that don't require a filter value
+ */
+export type BlankOperation = 'blank' | 'notBlank';
+/**
+ * Supported filter types
+ */
+export type FilterType = 'text' | 'number' | 'date';
+/**
+ * Base interface for all column filters with common properties
+ */
+interface BaseColumnFilter<T extends FilterOperation = FilterOperation> {
+    /** The filter operation type */
+    type: T;
 }
 /**
- * Text filter configuration
+ * Text filter configuration for string-based filtering
  */
-export interface TextColumnFilter extends BaseColumnFilter {
+export interface TextColumnFilter extends BaseColumnFilter<TextFilterOperation> {
     filterType: 'text';
-    type: TextFilterOperation;
+    /** The text value to filter by */
     filter: string;
 }
 /**
- * Number filter configuration
+ * Number filter configuration for numeric filtering
  */
-export interface NumberColumnFilter extends BaseColumnFilter {
+export interface NumberColumnFilter extends BaseColumnFilter<NumberFilterOperation> {
     filterType: 'number';
-    type: NumberFilterOperation;
+    /** The numeric value to filter by */
     filter: number;
+    /** Optional second value for range operations */
     filterTo?: number;
 }
 /**
- * Filter state for a single column (union of text and number filters)
+ * Date filter configuration for temporal filtering.
+ * Uses ISO date format (YYYY-MM-DD) for consistency and parseability.
  */
-export type ColumnFilter = TextColumnFilter | NumberColumnFilter;
+export interface DateColumnFilter extends BaseColumnFilter<DateFilterOperation> {
+    filterType: 'date';
+    /** ISO date string (YYYY-MM-DD) */
+    filter: string;
+    /** Optional end date for range operations (ISO format) */
+    filterTo?: string;
+}
 /**
- * Complete filter state mapping
+ * Union type for all possible column filters
+ */
+export type ColumnFilter = TextColumnFilter | NumberColumnFilter | DateColumnFilter;
+/**
+ * Complete filter state mapping column IDs to their filters
  */
 export interface FilterState {
     [columnId: string]: ColumnFilter;
 }
 /**
- * Internal configuration with defaults
+ * Type guard to check if an operation is text-specific
  */
-export interface InternalConfig extends Required<AGGridUrlSyncConfig> {
-    gridApi: AGGridApi;
-}
+export declare function isTextFilterOperation(op: FilterOperation): op is TextFilterOperation;
+/**
+ * Type guard to check if an operation is number-specific
+ */
+export declare function isNumberFilterOperation(op: FilterOperation): op is NumberFilterOperation;
+/**
+ * Type guard to check if an operation is date-specific
+ */
+export declare function isDateFilterOperation(op: FilterOperation): op is DateFilterOperation;
 /**
- * Error types for URL sync operations
+ * Type guard to check if an operation requires a range (two values)
+ */
+export declare function isRangeOperation(op: FilterOperation): op is RangeOperation;
+/**
+ * Type guard to check if an operation is a blank operation
+ */
+export declare function isBlankOperation(op: FilterOperation): op is BlankOperation;
+/**
+ * Type guard to check if a filter is a text filter
+ */
+export declare function isTextFilter(filter: ColumnFilter): filter is TextColumnFilter;
+/**
+ * Type guard to check if a filter is a number filter
+ */
+export declare function isNumberFilter(filter: ColumnFilter): filter is NumberColumnFilter;
+/**
+ * Type guard to check if a filter is a date filter
+ */
+export declare function isDateFilter(filter: ColumnFilter): filter is DateColumnFilter;
+/**
+ * Base error class for all URL sync operations
  */
 export declare class URLSyncError extends Error {
-    constructor(message: string);
+    readonly cause?: Error | undefined;
+    constructor(message: string, cause?: Error | undefined);
 }
+/**
+ * Error thrown when filter validation fails
+ */
 export declare class InvalidFilterError extends URLSyncError {
-    constructor(message: string);
+    constructor(message: string, cause?: Error);
 }
+/**
+ * Error thrown when URL parsing fails
+ */
 export declare class InvalidURLError extends URLSyncError {
-    constructor(message: string);
+    constructor(message: string, cause?: Error);
+}
+/**
+ * Error thrown when date validation fails
+ */
+export declare class InvalidDateError extends InvalidFilterError {
+    constructor(message: string, cause?: Error);
 }
-export type ParsedFilterParam = {
+/**
+ * Parsed filter parameter information for internal processing
+ */
+export interface ParsedFilterParam {
     columnName: string;
     operation: FilterOperation;
-    filterType: 'text' | 'number' | 'auto';
+    filterType: FilterType | 'auto';
     value: string | number;
-    filterTo?: number;
+    filterTo?: number | string;
     action: 'apply' | 'remove';
-};
+}
+/**
+ * Re-export GridApi for convenience
+ */
 export type GridApi = AGGridApi;
 /**
  * Union type for AG Grid filters using official AG Grid types
  */
-export type AGGridFilter = TextFilterModel | NumberFilterModel;
+export type AGGridFilter = TextFilterModel | NumberFilterModel | DateFilterModel;
+/**
+ * Raw AG Grid filter object structure from getFilterModel()
+ * Used for type-safe destructuring of filter objects
+ */
+export interface RawAGGridFilter {
+    filterType?: string;
+    type?: string;
+    filter?: string | number;
+    filterTo?: string | number;
+    dateFrom?: string;
+    dateTo?: string;
+}
+/**
+ * Maps URL operation names to internal operation types
+ */
 export declare const OPERATION_MAP: Record<string, FilterOperation>;
+/**
+ * Maps internal operation types to URL operation names
+ */
 export declare const INTERNAL_TO_URL_OPERATION_MAP: Record<FilterOperation, string>;
-export declare const AG_GRID_OPERATION_NAMES: Record<FilterOperation, string>;
+/**
+ * Maps internal operation types to AG Grid operation names
+ */
+export declare const AG_GRID_OPERATION_NAMES: Record<string, string>;
+/**
+ * Maps AG Grid operation names to internal operation types
+ */
 export declare const REVERSE_AG_GRID_OPERATION_NAMES: Record<string, FilterOperation>;
 export {};