ag-grid-url-sync 0.1.1 → 0.2.1

package/README.md

@@ -6,10 +6,11 @@ A lightweight TypeScript library for synchronizing AG Grid text filters with URL
 
 ## 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)
 - 🔗 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 +19,58 @@ 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 filter operations** (8 total) with clean, human-readable URL parameters:
+
+| 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         |
+
+> **💡 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:
+
+- Columns configured with `filter: 'agTextColumnFilter'`
+- 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
+
+### URL Examples
+
+**Simple filter:**
+
+```
+https://app.com/data?f_name_contains=john
+```
+
+**Multiple operations:**
+
+```
+https://app.com/data?f_name_contains=john&f_department_eq=Engineering&f_email_startsWith=admin&f_status_neq=inactive
+```
+
+**Complex filtering with all 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
+```
+
+**Blank operations:**
+
+```
+https://app.com/data?f_comments_blank=true&f_name_notBlank=true
+```
+
 ## Installation
 
 ```bash
@@ -26,6 +79,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
@@ -44,40 +187,257 @@ urlSync.applyFromUrl()
 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={columnDefs}
+          defaultColDef={{
+            filter: 'agTextColumnFilter',
+            floatingFilter: true
+          }}
+        />
+      </div>
+    </div>
   )
+}
+```
 
-  const shareUrl = useCallback(() => urlSync?.generateUrl() || '', [urlSync])
+### React Router Integration
 
-  const applyUrlFilters = useCallback(() => urlSync?.applyFromUrl(), [urlSync])
+For single-page applications using React Router, you can sync filters with the browser URL:
 
-  return { shareUrl, applyUrlFilters }
-}
+```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_'
+    }
+  )
 
-// In your component
-function GridComponent() {
-  const { shareUrl, applyUrlFilters } = useGridUrlSync(gridApi)
+  // 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={() => {
-          const url = shareUrl()
-          navigator.clipboard.writeText(url)
-        }}
-      >
-        Share Filters
+      <button onClick={updateUrlWithFilters} disabled={!isReady}>
+        Update URL with Filters
       </button>
-      <button onClick={applyUrlFilters}>Apply URL Filters</button>
+      <button onClick={clearFilters} disabled={!hasFilters}>
+        Clear All Filters
+      </button>
+      {/* Grid component */}
+    </div>
+  )
+}
+```
+
+### React Hook API
+
+#### `useAGGridUrlSync(gridApi, options?)`
+
+```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
+}
+```
+
+#### 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>
+      <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>
   )
 }
@@ -203,35 +563,39 @@ 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)
+- **Filter scenarios** - Pre-configured examples (Sales team, Engineering, Executive view, etc.)
+- **New operation demos** - Dedicated buttons for startsWith, endsWith, and notContains filters
+- **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
 
-### 🚀 [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
+- Automatic filter state management
+- Share button with clipboard functionality
+- Filter status indicators and controls
+- Auto-apply filters on component mount
+- Full TypeScript support
 
-### 🔗 [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
+- 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
 
-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
 

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,9 @@
+import type { FilterState, InternalConfig } from './types.js';
+/**
+ * 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;

package/dist/core/grid-integration.js

@@ -0,0 +1,66 @@
+import { AG_GRID_OPERATION_NAMES, REVERSE_AG_GRID_OPERATION_NAMES } from './types.js';
+/**
+ * Gets the current filter model from AG Grid
+ */
+export function getFilterModel(config) {
+    try {
+        const model = config.gridApi.getFilterModel();
+        const filterState = {};
+        if (!model || typeof model !== 'object') {
+            return filterState;
+        }
+        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 || ''
+                };
+            }
+        }
+        return filterState;
+    }
+    catch (error) {
+        if (config.onParseError) {
+            config.onParseError(error);
+        }
+        return {};
+    }
+}
+/**
+ * Applies a filter state to AG Grid
+ */
+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
+                    };
+                }
+            }
+        }
+        config.gridApi.setFilterModel(model);
+    }
+    catch (error) {
+        if (config.onParseError) {
+            config.onParseError(error);
+        }
+    }
+}
+//# sourceMappingURL=grid-integration.js.map

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

@@ -0,0 +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"}

package/dist/core/index.d.ts

@@ -0,0 +1,6 @@
+export { AGGridUrlSync, createUrlSync } from './ag-grid-url-sync.js';
+export * from './types.js';
+export { validateFilterValue, DEFAULT_CONFIG } from './validation.js';
+export { parseUrlFilters, parseFilterParam } from './url-parser.js';
+export { serializeFilters, generateUrl } from './url-generator.js';
+export { getFilterModel, applyFilterModel } from './grid-integration.js';

package/dist/core/index.js

@@ -0,0 +1,11 @@
+export { AGGridUrlSync, createUrlSync } from './ag-grid-url-sync.js';
+export * from './types.js';
+// Validation utilities
+export { validateFilterValue, DEFAULT_CONFIG } from './validation.js';
+// URL parsing utilities
+export { parseUrlFilters, parseFilterParam } from './url-parser.js';
+// URL generation utilities
+export { serializeFilters, generateUrl } from './url-generator.js';
+// AG Grid integration utilities
+export { getFilterModel, applyFilterModel } from './grid-integration.js';
+//# sourceMappingURL=index.js.map

package/dist/core/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/core/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAA;AAEpE,cAAc,YAAY,CAAA;AAE1B,uBAAuB;AACvB,OAAO,EAAE,mBAAmB,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAA;AAErE,wBAAwB;AACxB,OAAO,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAA;AAEnE,2BAA2B;AAC3B,OAAO,EAAE,gBAAgB,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAA;AAElE,gCAAgC;AAChC,OAAO,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAA"}