ag-grid-url-sync 0.1.1 → 0.2.2

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,14 +2,16 @@
 
 # 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
 
-- 🔍 Text filter synchronization (`contains` and `equals` operations)
+- 🔍 **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)
 - 🔗 Manual URL generation for sharing filter states
 - ↔️ Bidirectional sync between grid and URL
 - 🛠️ Framework agnostic - works with any AG Grid setup
+- ⚛️ **React hook** - dedicated `useAGGridUrlSync` with state management
 - 📝 Full TypeScript support with strict mode compliance
 - 🚦 Graceful error handling with configurable error callbacks
 - 🧹 Clean, human-readable URL format
@@ -18,6 +20,95 @@ A lightweight TypeScript library for synchronizing AG Grid text filters with URL
 - 🛡️ Robust edge case handling (special characters, malformed URLs)
 - 📦 Lightweight bundle size (~3KB gzipped)
 
+## Supported Filter Types
+
+Supports **all AG Grid text and number filter operations** (17 total) with clean, human-readable URL parameters:
+
+### Text Filters (8 operations)
+
+| Filter Type | Operation    | URL Format                   | Example                    | Description                 |
+| ----------- | ------------ | ---------------------------- | -------------------------- | --------------------------- |
+| **Text**    | Contains     | `f_column_contains=value`    | `f_name_contains=john`     | Text contains value         |
+| **Text**    | Equals       | `f_column_eq=value`          | `f_status_eq=active`       | Text equals value exactly   |
+| **Text**    | Not Contains | `f_column_notContains=value` | `f_name_notContains=spam`  | Text does not contain value |
+| **Text**    | Not Equal    | `f_column_neq=value`         | `f_status_neq=inactive`    | Text does not equal value   |
+| **Text**    | Starts With  | `f_column_startsWith=value`  | `f_email_startsWith=admin` | Text starts with value      |
+| **Text**    | Ends With    | `f_column_endsWith=value`    | `f_file_endsWith=.pdf`     | Text ends with value        |
+| **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         |
+
+### 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   |
+
+> **💡 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.
+
+### Filter Detection
+
+The library automatically works with:
+
+- **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 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
+
+### URL Examples
+
+**Simple text filter:**
+
+```
+https://app.com/data?f_name_contains=john
+```
+
+**Simple number filter:**
+
+```
+https://app.com/data?f_salary_gt=75000
+```
+
+**Mixed text and number filters:**
+
+```
+https://app.com/data?f_name_contains=john&f_department_eq=Engineering&f_salary_gte=80000&f_age_range=25,45
+```
+
+**Complex filtering with range operations:**
+
+```
+https://app.com/data?f_name_contains=manager&f_salary_range=60000,100000&f_experience_gte=5&f_status_eq=active
+```
+
+**All text operations:**
+
+```
+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
+```
+
+**All number 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
+```
+
+**Blank operations (both text and number):**
+
+```
+https://app.com/data?f_comments_blank=true&f_bonus_blank=true&f_name_notBlank=true&f_salary_notBlank=true
+```
+
 ## Installation
 
 ```bash
@@ -26,6 +117,96 @@ npm install ag-grid-url-sync
 
 ## Usage
 
+### Importing the Library
+
+The library provides two main entry points:
+
+```typescript
+// Core functionality - works with any framework
+import { createUrlSync } from 'ag-grid-url-sync'
+
+// React hook - for React applications
+import { useAGGridUrlSync } from 'ag-grid-url-sync/react'
+
+// TypeScript types (available from both imports)
+import type { FilterState, AGGridUrlSyncConfig } from 'ag-grid-url-sync'
+```
+
+### Tree-Shaking & Granular Imports
+
+For optimal bundle sizes, you can import only the specific utilities you need:
+
+```typescript
+import {
+  validateFilterValue,
+  DEFAULT_CONFIG
+} from 'ag-grid-url-sync/validation'
+
+import { parseUrlFilters, parseFilterParam } from 'ag-grid-url-sync/url-parser'
+
+import { serializeFilters, generateUrl } from 'ag-grid-url-sync/url-generator'
+
+import {
+  getFilterModel,
+  applyFilterModel
+} from 'ag-grid-url-sync/grid-integration'
+
+import type {
+  FilterState,
+  ColumnFilter,
+  FilterOperation
+} from 'ag-grid-url-sync/types'
+```
+
+#### Bundle Size Comparison
+
+| Import Pattern   | Bundle Size | Use Case               |
+| ---------------- | ----------- | ---------------------- |
+| Full library     | 5KB         | Complete functionality |
+| Core class only  | 3.2KB       | Basic URL sync         |
+| React hook only  | 7KB         | React applications     |
+| URL parsing only | 1.05KB      | Parse existing URLs    |
+| Validation only  | 318B        | Input validation       |
+| Types only       | 0B          | TypeScript types       |
+
+#### Example: Custom URL Parser
+
+```typescript
+import { parseUrlFilters } from 'ag-grid-url-sync/url-parser'
+import { DEFAULT_CONFIG } from 'ag-grid-url-sync/validation'
+import type { FilterState } from 'ag-grid-url-sync/types'
+
+function getFiltersFromUrl(url: string): FilterState {
+  const config = {
+    gridApi: null, // Not needed for parsing
+    ...DEFAULT_CONFIG,
+    onParseError: error => console.error('Parse error:', error)
+  }
+
+  return parseUrlFilters(url, config)
+}
+```
+
+#### Example: Custom URL Generator
+
+```typescript
+import { generateUrl, serializeFilters } from 'ag-grid-url-sync/url-generator'
+import type { FilterState } from 'ag-grid-url-sync/types'
+
+function createShareableUrl(filters: FilterState, baseUrl: string): string {
+  const config = {
+    gridApi: null, // Not needed for generation
+    paramPrefix: 'f_',
+    maxValueLength: 200,
+    onParseError: () => {}
+  }
+
+  return generateUrl(baseUrl, filters, config)
+}
+```
+
+**💡 Pro Tip**: Use granular imports in libraries and applications where bundle size matters. All existing import patterns remain fully supported for backward compatibility.
+
 ### Basic Example
 
 ```typescript
@@ -34,50 +215,240 @@ 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'
+)
+
+// 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 filters
+// Clear all text and number filters
 urlSync.clearFilters()
 ```
 
-### React Integration
+## React Integration
+
+For React applications, use the dedicated `useAGGridUrlSync` hook that provides a complete solution with React-specific features and state management.
+
+### Installation for React
+
+```bash
+npm install ag-grid-url-sync
+```
+
+### Basic React Usage
 
 ```tsx
-import { createUrlSync } from 'ag-grid-url-sync'
-import { useCallback, useMemo } from 'react'
+import React, { useState } from 'react'
+import { AgGridReact } from 'ag-grid-react'
+import { useAGGridUrlSync } from 'ag-grid-url-sync/react'
+
+function GridComponent() {
+  const [gridApi, setGridApi] = useState(null)
+
+  const {
+    shareUrl,
+    applyUrlFilters,
+    clearFilters,
+    hasFilters,
+    isReady,
+    currentUrl
+  } = useAGGridUrlSync(gridApi, {
+    autoApplyOnMount: true,
+    paramPrefix: 'filter_'
+  })
+
+  const handleShare = async () => {
+    const url = shareUrl()
+    await navigator.clipboard.writeText(url)
+    alert('Filter URL copied!')
+  }
 
-function useGridUrlSync(gridApi) {
-  const urlSync = useMemo(
-    () => (gridApi ? createUrlSync(gridApi) : null),
-    [gridApi]
+  return (
+    <div>
+      <div style={{ marginBottom: '10px' }}>
+        <button onClick={handleShare} disabled={!isReady}>
+          📋 Share Filters
+        </button>
+        <button onClick={clearFilters} disabled={!hasFilters}>
+          🗑️ Clear Filters
+        </button>
+        <button onClick={applyUrlFilters}>🔄 Apply URL Filters</button>
+      </div>
+
+      <div className="ag-theme-alpine" style={{ height: 400, width: '100%' }}>
+        <AgGridReact
+          onGridReady={params => setGridApi(params.api)}
+          rowData={rowData}
+          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={{
+            flex: 1,
+            sortable: true,
+            resizable: true
+          }}
+        />
+      </div>
+    </div>
   )
+}
+```
 
-  const shareUrl = useCallback(() => urlSync?.generateUrl() || '', [urlSync])
+### React Hook API
 
-  const applyUrlFilters = useCallback(() => urlSync?.applyFromUrl(), [urlSync])
+#### `useAGGridUrlSync(gridApi, options?)`
 
-  return { shareUrl, applyUrlFilters }
+```tsx
+import { useAGGridUrlSync } from 'ag-grid-url-sync/react'
+
+const {
+  shareUrl,
+  getQueryParams,
+  applyUrlFilters,
+  clearFilters,
+  isReady,
+  currentUrl,
+  hasFilters,
+  parseUrlFilters,
+  applyFilters
+} = useAGGridUrlSync(gridApi, options)
+```
+
+#### Hook Options
+
+```tsx
+interface UseAGGridUrlSyncOptions {
+  // Core options (same as createUrlSync)
+  paramPrefix?: string // Default: 'f_'
+  maxValueLength?: number // Default: 200
+  onParseError?: (error: Error) => void
+
+  // React-specific options
+  autoApplyOnMount?: boolean // Default: false
+  enabledWhenReady?: boolean // Default: true
 }
+```
 
-// In your component
-function GridComponent() {
-  const { shareUrl, applyUrlFilters } = useGridUrlSync(gridApi)
+#### Hook Return Values
+
+| Property          | Type                             | Description                                     |
+| ----------------- | -------------------------------- | ----------------------------------------------- |
+| `shareUrl`        | `(baseUrl?: string) => string`   | Generate shareable URL with current filters     |
+| `getQueryParams`  | `() => string`                   | Get filter state as query parameters            |
+| `applyUrlFilters` | `(url?: string) => void`         | Apply filters from URL to grid                  |
+| `clearFilters`    | `() => void`                     | Clear all text filters                          |
+| `isReady`         | `boolean`                        | Whether grid API is available and hook is ready |
+| `currentUrl`      | `string`                         | Current URL with filters applied                |
+| `hasFilters`      | `boolean`                        | Whether grid has any active text filters        |
+| `parseUrlFilters` | `(url: string) => FilterState`   | Parse filters from URL without applying         |
+| `applyFilters`    | `(filters: FilterState) => void` | Apply filter state object to grid               |
+
+### React Features
+
+- **🔄 Automatic State Management**: Tracks grid state and filter changes automatically
+- **⚡ Ready State**: `isReady` indicates when the grid API is available
+- **🎯 Auto-Apply**: `autoApplyOnMount` applies URL filters when component mounts
+- **🧹 Cleanup**: Automatically cleans up resources when component unmounts
+- **🛡️ Error Boundaries**: Graceful error handling with configurable callbacks
+- **📊 Filter Status**: `hasFilters` tracks whether any filters are active
+
+### Advanced React Example
+
+```tsx
+import React, { useState, useEffect } from 'react'
+import { useAGGridUrlSync } from 'ag-grid-url-sync/react'
+
+function AdvancedGridComponent() {
+  const [gridApi, setGridApi] = useState(null)
+  const [shareMessage, setShareMessage] = useState('')
+
+  const {
+    shareUrl,
+    applyUrlFilters,
+    clearFilters,
+    hasFilters,
+    isReady,
+    currentUrl,
+    parseUrlFilters
+  } = useAGGridUrlSync(gridApi, {
+    autoApplyOnMount: true,
+    paramPrefix: 'emp_',
+    maxValueLength: 100,
+    onParseError: error => {
+      console.warn('Filter parsing error:', error.message)
+      setShareMessage('Invalid filter URL detected')
+    }
+  })
+
+  // Watch for URL changes
+  useEffect(() => {
+    if (currentUrl !== window.location.href) {
+      setShareMessage('Filters have changed - URL ready to share')
+    }
+  }, [currentUrl])
+
+  const handleShareToEmail = () => {
+    const url = shareUrl()
+    const subject = 'Check out this filtered data'
+    const body = `View the filtered data here: ${url}`
+    window.open(
+      `mailto:?subject=${encodeURIComponent(subject)}&body=${encodeURIComponent(body)}`
+    )
+  }
+
+  const handlePreviewFilters = () => {
+    const url = prompt('Enter URL to preview filters:')
+    if (url) {
+      const filters = parseUrlFilters(url)
+      console.log('Parsed filters:', filters)
+      alert(`Found ${Object.keys(filters).length} filter(s)`)
+    }
+  }
 
   return (
     <div>
-      <button
-        onClick={() => {
-          const url = shareUrl()
-          navigator.clipboard.writeText(url)
-        }}
-      >
-        Share Filters
-      </button>
-      <button onClick={applyUrlFilters}>Apply URL Filters</button>
+      <div className="controls">
+        <button onClick={handleShareToEmail} disabled={!isReady}>
+          📧 Share via Email
+        </button>
+        <button onClick={handlePreviewFilters}>👁️ Preview URL Filters</button>
+        <button onClick={clearFilters} disabled={!hasFilters}>
+          Clear ({hasFilters ? 'has filters' : 'no filters'})
+        </button>
+      </div>
+
+      {shareMessage && <div className="message">{shareMessage}</div>}
+
+      {/* Grid component */}
     </div>
   )
 }
@@ -89,16 +460,20 @@ 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`
+- **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
 
@@ -203,35 +578,43 @@ interface AGGridUrlSyncConfig {
 
 Check out the [examples](./examples) directory for comprehensive working demos:
 
-### 📝 [Basic Example](./examples/basic-example.html)
+### 🚀 [Vanilla JavaScript Demo](./examples/vanilla-js/demo.html)
 
-Simple HTML/JS implementation showing core functionality:
+Comprehensive demonstration showcasing all features:
 
-- Initialize URL sync with AG Grid
-- Generate shareable URLs
-- Apply filters from URLs
-- Handle filter changes
+- **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)
+- **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
+- **Complete API showcase** - Generate URLs, apply filters, clear filters with comprehensive examples
 
-### 🚀 [Advanced Demo](./examples/advanced-demo.html)
+### ⚛️ [React Integration](./examples/react-basic/basic-grid.tsx)
 
-Feature-rich demonstration including:
+Clean React component showing the `useAGGridUrlSync` hook:
 
-- Performance monitoring and benchmarks
-- Multiple filter scenarios (Sales, Engineering, Executive views)
-- URL sharing workflow with copy/email/Slack functionality
-- Error testing with malformed URLs and invalid filters
-- Memory and stress testing capabilities
+- React hook integration with AG Grid for text and number 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
+- Enhanced employee data with salary, age, and experience columns
+- Full TypeScript support with comprehensive type coverage
 
-### 🔗 [Multi-Grid Demo](./examples/multi-grid-demo.html)
+### 📊 [Shared Data](./examples/shared-data.js)
 
-Complex example with multiple independent grids:
+Common data and column definitions used across examples:
 
-- Four separate grids (Employees, Projects, Departments, Metrics)
-- Individual URL namespacing with different prefixes
-- Combined URL generation merging all grid states
-- Independent grid controls and clearing functions
+- 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)
+- Includes null values for demonstrating blank/notBlank operations
 
-All examples work out-of-the-box by opening the HTML files in your browser.
+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.
 
 ## Contributing
 
@@ -243,6 +626,6 @@ All examples work out-of-the-box by opening the HTML files in your browser.
 
 ## 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/{ag-grid-url-sync.js → core/ag-grid-url-sync.js}

@@ -1,5 +1,7 @@
-import { DEFAULT_CONFIG } from './utils.js';
-import { parseUrlFilters, generateUrl, getFilterModel, applyFilterModel } from './utils.js';
+import { DEFAULT_CONFIG } from './validation.js';
+import { parseUrlFilters } from './url-parser.js';
+import { generateUrl } from './url-generator.js';
+import { getFilterModel, applyFilterModel } from './grid-integration.js';
 /**
  * AGGridUrlSync class for synchronizing AG Grid text filters with URL parameters
  */

package/dist/core/ag-grid-url-sync.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ag-grid-url-sync.js","sourceRoot":"","sources":["../../src/core/ag-grid-url-sync.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAA;AAChD,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAA;AACjD,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAA;AAChD,OAAO,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAA;AAExE;;GAEG;AACH,MAAM,OAAO,aAAa;IAChB,MAAM,CAAgB;IAE9B;;;;OAIG;IACH,YAAY,OAAgB,EAAE,SAA8B,EAAE;QAC5D,IAAI,CAAC,MAAM,GAAG;YACZ,OAAO;YACP,WAAW,EAAE,MAAM,CAAC,WAAW,IAAI,cAAc,CAAC,WAAW;YAC7D,cAAc,EAAE,MAAM,CAAC,cAAc,IAAI,cAAc,CAAC,cAAc;YACtE,YAAY,EAAE,MAAM,CAAC,YAAY,IAAI,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC;SAChD,CAAA;IACH,CAAC;IAED;;;;OAIG;IACH,WAAW,CAAC,OAAgB;QAC1B,MAAM,WAAW,GAAG,cAAc,CAAC,IAAI,CAAC,MAAM,CAAC,CAAA;QAC/C,MAAM,GAAG,GAAG,OAAO,IAAI,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAA;QAC3C,OAAO,WAAW,CAAC,GAAG,EAAE,WAAW,EAAE,IAAI,CAAC,MAAM,CAAC,CAAA;IACnD,CAAC;IAED;;;OAGG;IACH,cAAc;QACZ,MAAM,GAAG,GAAG,IAAI,CAAC,WAAW,EAAE,CAAA;QAC9B,MAAM,MAAM,GAAG,IAAI,GAAG,CAAC,GAAG,CAAC,CAAA;QAC3B,OAAO,MAAM,CAAC,MAAM,CAAA;IACtB,CAAC;IAED;;;OAGG;IACH,YAAY,CAAC,GAAY;QACvB,MAAM,UAAU,GAAG,GAAG,IAAI,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAA;QAC9C,MAAM,WAAW,GAAG,eAAe,CAAC,UAAU,EAAE,IAAI,CAAC,MAAM,CAAC,CAAA;QAC5D,IAAI,CAAC,YAAY,CAAC,WAAW,CAAC,CAAA;IAChC,CAAC;IAED;;;OAGG;IACH,YAAY,CAAC,WAAwB;QACnC,gBAAgB,CAAC,WAAW,EAAE,IAAI,CAAC,MAAM,CAAC,CAAA;IAC5C,CAAC;IAED;;OAEG;IACH,YAAY;QACV,IAAI,CAAC,YAAY,CAAC,EAAE,CAAC,CAAA;IACvB,CAAC;IAED;;OAEG;IACH,OAAO;QACL,2DAA2D;IAC7D,CAAC;CACF;AAED;;;;;GAKG;AACH,MAAM,UAAU,aAAa,CAC3B,OAAgB,EAChB,MAA4B;IAE5B,OAAO,IAAI,aAAa,CAAC,OAAO,EAAE,MAAM,CAAC,CAAA;AAC3C,CAAC"}

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

@@ -0,0 +1,14 @@
+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' | null;
+/**
+ * Gets the current filter model from AG Grid
+ */
+export declare function getFilterModel(config: InternalConfig): FilterState;
+/**
+ * Applies a filter state to AG Grid
+ */
+export declare function applyFilterModel(filterState: FilterState, config: InternalConfig): void;