ag-grid-url-sync 0.2.4 → 0.4.1

package/README.md

@@ -9,7 +9,8 @@ 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
+- � **Grouped serialization** - Package all filters into a single URL parameter with querystring, JSON, or base64 encoding
+- �🔗 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
@@ -17,7 +18,7 @@ A lightweight TypeScript library for synchronizing AG Grid text and number filte
 - 🚦 Graceful error handling with configurable error callbacks
 - 🧹 Clean, human-readable URL format
 - ⚡ High performance - handles 100+ filters efficiently (<20ms)
-- 🔧 Configurable URL prefixes for multi-grid scenarios
+- 🔧 Configurable URL prefixes
 - 🛡️ Robust edge case handling (special characters, malformed URLs)
 - 📦 Lightweight bundle size (~3KB gzipped)
 
@@ -256,6 +257,204 @@ urlSync.applyFilters({
 urlSync.clearFilters()
 ```
 
+## Grouped Serialization
+
+Grouped serialization provides an alternative to individual URL parameters by packaging all filters into a single URL parameter. This is particularly useful for applications with many filters or when you need more compact URLs.
+
+### Why Use Grouped Serialization?
+
+**Individual serialization** (default):
+
+```
+https://app.com/data?f_name_contains=john&f_age_gt=25&f_salary_gte=80000&f_created_after=2024-01-01
+```
+
+**Grouped serialization**:
+
+```
+https://app.com/data?grid_filters=f_name_contains%3Djohn%26f_age_gt%3D25%26f_salary_gte%3D80000%26f_created_after%3D2024-01-01
+```
+
+Benefits of grouped serialization:
+
+- **Cleaner URLs** with a single parameter instead of many
+- **Better for sharing** - easier to copy/paste and less prone to URL manipulation
+
+- **Format flexibility** - choose between querystring, JSON, or base64 encoding
+- **Future-proof** - easier to extend with additional metadata
+
+### Configuration
+
+```typescript
+interface AGGridUrlSyncConfig {
+  // Serialization mode
+  serialization?: 'individual' | 'grouped' // default: 'individual'
+
+  // Format for grouped serialization
+  format?: 'querystring' | 'json' | 'base64' // default: 'querystring'
+
+  // Parameter name for grouped mode
+  groupedParam?: string // default: 'grid_filters'
+
+  // ... other existing options
+}
+```
+
+### Format Options
+
+#### QueryString Format (Default)
+
+Filters are URL-encoded as a query string within the parameter:
+
+```typescript
+const urlSync = createUrlSync(gridApi, {
+  serialization: 'grouped',
+  format: 'querystring' // default
+})
+
+// Result: ?grid_filters=f_name_contains%3Djohn%26f_age_gt%3D25
+// Decoded: f_name_contains=john&f_age_gt=25
+```
+
+#### JSON Format
+
+Filters are JSON-encoded, ideal for complex filter states:
+
+```typescript
+const urlSync = createUrlSync(gridApi, {
+  serialization: 'grouped',
+  format: 'json'
+})
+
+// Result: ?grid_filters=%7B%22name%22%3A%7B%22filterType%22%3A%22text%22...
+// Decoded: {"name":{"filterType":"text","type":"contains","filter":"john"}...}
+```
+
+#### Base64 Format
+
+Filters are JSON-encoded then base64-encoded for maximum compactness:
+
+```typescript
+const urlSync = createUrlSync(gridApi, {
+  serialization: 'grouped',
+  format: 'base64'
+})
+
+// Result: ?grid_filters=eyJuYW1lIjp7ImZpbHRlclR5cGUiOiJ0ZXh0Ii...
+// Most compact representation, ideal for sharing
+```
+
+### Basic Usage
+
+```typescript
+import { createUrlSync } from 'ag-grid-url-sync'
+
+// Basic grouped serialization
+const urlSync = createUrlSync(gridApi, {
+  serialization: 'grouped'
+})
+
+// Generate grouped URL
+const url = urlSync.generateUrl('https://app.com/data')
+// Result: https://app.com/data?grid_filters=f_name_contains%3Djohn%26f_age_gt%3D25
+
+// Apply filters from grouped URL
+urlSync.applyFromUrl(url)
+
+// Get current serialization mode and format
+console.log(urlSync.getSerializationMode()) // 'grouped'
+console.log(urlSync.getCurrentFormat()) // 'querystring'
+```
+
+### Advanced Examples
+
+#### Format Conversion Utility
+
+```typescript
+// Convert current filters to any format
+const jsonFormat = urlSync.getFiltersAsFormat('json')
+const base64Format = urlSync.getFiltersAsFormat('base64')
+const querystringFormat = urlSync.getFiltersAsFormat('querystring')
+
+console.log('JSON:', jsonFormat)
+console.log('Base64:', base64Format)
+console.log('QueryString:', querystringFormat)
+```
+
+#### Dynamic Format Switching
+
+```typescript
+// Start with individual mode
+const urlSync = createUrlSync(gridApi, {
+  serialization: 'individual'
+})
+
+// Switch to grouped mode when needed
+const groupedSync = createUrlSync(gridApi, {
+  serialization: 'grouped',
+  format: 'base64',
+  groupedParam: 'filters'
+})
+
+// Use utility to maintain filters across mode changes
+const currentFilters = urlSync.getFiltersAsFormat('json')
+```
+
+### Granular Import: Grouped Serialization
+
+You can import grouped serialization utilities and format serializers directly for advanced use cases or custom integrations:
+
+```typescript
+import {
+  serializeGrouped,
+  deserializeGrouped
+} from 'ag-grid-url-sync/serialization'
+import {
+  QueryStringSerializer,
+  JsonSerializer,
+  Base64Serializer
+} from 'ag-grid-url-sync/serialization/formats'
+```
+
+---
+
+### Error Handling for Grouped Serialization
+
+You can provide a custom error handler to gracefully handle malformed grouped parameters or serialization errors. The library will throw an `InvalidSerializationError` for invalid formats:
+
+```typescript
+import { InvalidSerializationError } from 'ag-grid-url-sync/types'
+
+const urlSync = createUrlSync(gridApi, {
+  serialization: 'grouped',
+  format: 'json',
+  onParseError: error => {
+    if (error instanceof InvalidSerializationError) {
+      // Handle grouped serialization error
+      alert('Invalid filter data in URL!')
+    } else {
+      // Handle other errors
+      console.error(error)
+    }
+  }
+})
+```
+
+### Exports
+
+The package supports granular subpath exports for advanced usage and optimal bundle size:
+
+- `ag-grid-url-sync/serialization` – grouped serialization utilities
+- `ag-grid-url-sync/serialization/formats` – format-specific serializers
+- `ag-grid-url-sync/validation` – validation helpers
+- `ag-grid-url-sync/url-parser` – URL parsing utilities
+- `ag-grid-url-sync/url-generator` – URL generation utilities
+- `ag-grid-url-sync/grid-integration` – AG Grid integration helpers
+- `ag-grid-url-sync/view-storage` – localStorage-backed saved views
+- `ag-grid-url-sync/types` – TypeScript types
+
+Refer to the [package.json](./package.json) for the full export map.
+
 ## React Integration
 
 For React applications, use the dedicated `useAGGridUrlSync` hook that provides a complete solution with React-specific features and state management.
@@ -360,7 +559,9 @@ const {
   currentUrl,
   hasFilters,
   parseUrlFilters,
-  applyFilters
+  applyFilters,
+  getFiltersAsFormat,
+  getCurrentFormat
 } = useAGGridUrlSync(gridApi, options)
 ```
 
@@ -376,31 +577,187 @@ interface UseAGGridUrlSyncOptions {
   // React-specific options
   autoApplyOnMount?: boolean // Default: false
   enabledWhenReady?: boolean // Default: true
+  onError?: (error: Error, context: string) => void // Advanced error handling
+
+  // Saved views: setting a key enables the feature and namespaces its storage
+  storageKey?: string // Default: undefined (saved views disabled)
 }
 ```
 
 #### 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               |
+| 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               |
+| `getFiltersAsFormat` | `(format: 'querystring'          | 'json'                                          | 'base64') => string`                                       | Serialize filters to any supported format (for sharing/export) |
+| `getCurrentFormat`   | `() => 'individual'              | 'grouped'`                                      | Get the current serialization mode (individual or grouped) |
+
+Saved views (inert unless `storageKey` is set):
+
+| Property       | Type                                 | Description                                                             |
+| -------------- | ------------------------------------ | ----------------------------------------------------------------------- |
+| `views`        | `GridView[]`                         | Saved views for this grid, in save order. Empty when views are disabled |
+| `activeViewId` | `string \| null`                     | Id of the view currently applied to the grid, or `null` when none is    |
+| `saveView`     | `(name: string) => GridView \| null` | Save current filters under a name; overwrites an existing name in place |
+| `loadView`     | `(id: string \| null) => void`       | Apply a saved view, or pass `null` to reset to unfiltered               |
+| `deleteView`   | `(id: string) => void`               | Delete a saved view                                                     |
+
+> **Note:** `getFiltersAsFormat` and `getCurrentFormat` are especially useful for grouped serialization, format conversion, and advanced sharing scenarios.
+
+### Saved Views
+
+Pass a `storageKey` to let users name and revisit filter sets. The key both enables
+the feature and namespaces its storage, so two grids on the same origin must use
+different keys:
+
+```tsx
+const { views, activeViewId, saveView, loadView, deleteView } =
+  useAGGridUrlSync(gridApi, { storageKey: 'employee-grid' })
+
+// One handler each, as a user drives them: save whatever is currently filtered,
+// then apply or remove a view by id in a later interaction.
+const handleSave = () => saveView('Engineering, high salary')
+const handleLoad = (id: string) => loadView(id)
+const handleDelete = (id: string) => deleteView(id)
+const handleReset = () => loadView(null) // back to an unfiltered grid
+```
+
+Render the list from `views` and drive the buttons from it. `views[i].id` is only
+stale immediately after a mutation, not during render. If you do need the new
+view's id in the same handler that saved it, use `saveView`'s return value rather
+than reading it back out of `views`: that array is React state, so it does not
+update until the next render.
+
+Only the filter model is stored, using AG Grid's native format so set filters and
+combined conditions survive a round trip. Column order, row selection and expanded
+groups are not stored.
+
+Behaviour worth knowing:
+
+- **Names are unique.** Saving over an existing name updates that view in place,
+  keeping its id and list position, so "load, adjust, save under the same name" is
+  how you update one. Names are trimmed and must not be empty.
+- **`activeViewId` describes the live grid**, not what is persisted. A stored view
+  is only applied on mount when `autoApplyOnMount` is set, so with it off this
+  stays `null` until you call `loadView` or `saveView`.
+- **Filtering away from a view unloads it.** `activeViewId` returns to `null` as
+  soon as the grid stops showing that view, including through routes that never
+  mention views: `clearFilters`, `applyFilters`, `applyUrlFilters`, or the user
+  editing a filter in the grid's own UI. The stored pointer is cleared with it,
+  so `autoApplyOnMount` will not bring the view back on the next load. The grid
+  is compared against what it reported once the view was applied, so a view AG
+  Grid normalises (one naming a column the grid no longer has, say) stays loaded
+  and keeps its stored pointer. A write AG Grid defers, such as a restore made
+  before column data types are inferred, is recognised when it lands by the
+  event's `source: 'api'`; on AG Grid versions that do not report a source, a
+  deferred view the grid also normalises unloads when it lands. An API change
+  that filters a column the view does not, such as your own `setFilterModel`
+  over a view the grid ignored, is not taken for the view and unloads it. One
+  that filters only the view's columns cannot be told from the view landing.
+  Render the
+  active state from `activeViewId` and it follows the grid on its own. Replacing
+  `gridApi` also clears `activeViewId`, but keeps the stored pointer, so with
+  `autoApplyOnMount` the view is restored against the new grid.
+- **URL filters win on mount.** With `autoApplyOnMount` set, an incoming URL that
+  carries filters takes precedence over the stored view, so a shared link shows the
+  sender's filters rather than the recipient's saved default. It wins once per
+  grid: switching `storageKey` later restores the new namespace's stored view
+  instead of applying the link again.
+- **Deleting is conservative.** `deleteView` clears the grid only if it still shows
+  exactly that view's filters, so hand-edited filters survive.
+- **Failures are reported, not silent.** A save that cannot be persisted (quota
+  exhausted, storage blocked by policy) returns `null` and reports through
+  `onError` with context `'save-view'`. Reads degrade to an empty list instead of
+  throwing, so server rendering is safe.
+
+For non-React consumers the same store is available directly:
+
+```ts
+import { createViewStore } from 'ag-grid-url-sync/view-storage'
+
+const store = createViewStore('employee-grid')
+store.saveView('Engineering', gridApi.getFilterModel())
+```
 
 ### 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
+- **🎯 Auto-Apply**: `autoApplyOnMount` applies URL filters when component mounts.
+  It is attempted once per grid: a failure is reported through `onError` and
+  `onParseError` and is not retried on later renders
 - **🧹 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
+- **💾 Saved Views**: `storageKey` enables naming and revisiting filter sets
+
+### React with Grouped Serialization
+
+The React hook fully supports grouped serialization with all format options:
+
+```tsx
+import React, { useState } from 'react'
+import { AgGridReact } from 'ag-grid-react'
+import { useAGGridUrlSync } from 'ag-grid-url-sync/react'
+
+function AdvancedGridComponent() {
+  const [gridApi, setGridApi] = useState(null)
+
+  // Grouped serialization with base64 format
+  const { shareUrl, applyUrlFilters, clearFilters, hasFilters, isReady } =
+    useAGGridUrlSync(gridApi, {
+      serialization: 'grouped',
+      format: 'base64',
+      groupedParam: 'grid_state',
+      autoApplyOnMount: true
+    })
+
+  const handleShareCompact = async () => {
+    // Base64 format creates very compact URLs
+    const url = shareUrl()
+    await navigator.clipboard.writeText(url)
+    alert('Compact filter URL copied!')
+  }
+
+  const handleShareJSON = async () => {
+    // Get filters in JSON format for debugging
+    const jsonFilters = urlSync?.getFiltersAsFormat?.('json')
+    console.log('Current filters as JSON:', jsonFilters)
+  }
+
+  return (
+    <div>
+      <div style={{ marginBottom: '10px' }}>
+        <button onClick={handleShareCompact} disabled={!isReady}>
+          📋 Share Compact URL
+        </button>
+        <button onClick={handleShareJSON} disabled={!isReady}>
+          🔍 Debug Filters
+        </button>
+        <button onClick={clearFilters} disabled={!hasFilters}>
+          🗑️ Clear Filters
+        </button>
+      </div>
+
+      {/* Grid component */}
+      <div className="ag-theme-alpine" style={{ height: 400, width: '100%' }}>
+        <AgGridReact
+          onGridReady={params => setGridApi(params.api)}
+          // ... grid configuration
+        />
+      </div>
+    </div>
+  )
+}
+```
 
 ### Advanced React Example
 
@@ -488,7 +845,7 @@ Mixed filters: https://app.com/page?f_name_contains=john&f_salary_gte=75000&f_ag
 
 Parameter structure:
 
-- Prefix: `f_` (configurable - useful for multi-grid scenarios)
+- Prefix: `f_` (configurable)
 - 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`
@@ -583,8 +940,22 @@ urlSync.destroy()
 
 ```typescript
 interface AGGridUrlSyncConfig {
+  // Serialization mode (default: 'individual')
+  // 'individual': Each filter becomes a separate URL parameter
+  // 'grouped': All filters are packaged into a single URL parameter
+  serialization?: 'individual' | 'grouped'
+
+  // Format for grouped serialization (default: 'querystring')
+  // 'querystring': URL-encoded querystring format (most compatible)
+  // 'json': JSON-encoded format (good for complex filters)
+  // 'base64': Base64-encoded JSON (most compact)
+  format?: 'querystring' | 'json' | 'base64'
+
+  // Parameter name for grouped mode (default: 'grid_filters')
+  groupedParam?: string
+
   // Prefix for URL parameters (default: 'f_')
-  // Useful for multi-grid scenarios: 'emp_', 'proj_', etc.
+  // In grouped mode, this affects individual parameter names within the group
   paramPrefix?: string
 
   // Maximum length for filter values (default: 200)
@@ -607,12 +978,13 @@ 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)
 - **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, number, and date
-- **Complete API showcase** - Generate URLs, apply filters, clear filters with comprehensive examples
+- **Grouped serialization** - Package all filters into a single URL parameter with querystring, JSON, or base64 encoding
+- **Manual URL generation** - Generate shareable URLs with current filter states
+- **Bidirectional sync** - Automatic synchronization between AG Grid and URL
+- **Framework agnostic** - Works with any AG Grid setup, no dependencies
+- **High performance** - Efficiently handles 100+ filters with <20ms latency
+- **Robust error handling** - Graceful handling of malformed URLs and special characters
+- **Lightweight** - Minimal bundle size (~3KB gzipped), ideal for modern web applications
 
 ### ⚛️ [React Integration](./examples/react-basic/basic-grid.tsx)
 

package/dist/core/ag-grid-url-sync.d.ts

@@ -1,5 +1,5 @@
 import type { GridApi } from 'ag-grid-community';
-import type { AGGridUrlSyncConfig, FilterState } from './types.js';
+import type { AGGridUrlSyncConfig, FilterState, SerializationFormat, SerializationMode } from './types.js';
 /**
  * AGGridUrlSync class for synchronizing AG Grid text filters with URL parameters
  */
@@ -40,6 +40,21 @@ export declare class AGGridUrlSync {
      * Cleans up any resources or event listeners
      */
     destroy(): void;
+    /**
+     * Gets the current serialization mode
+     * @returns The current serialization mode
+     */
+    getSerializationMode(): SerializationMode;
+    /**
+     * Gets the current format (for grouped mode)
+     * @returns The current format
+     */
+    getCurrentFormat(): SerializationFormat; /**
+     * Gets filters in a specific format (useful for sharing/export)
+     * @param format - The format to serialize to
+     * @returns Serialized filter string
+     */
+    getFiltersAsFormat(format: SerializationFormat): string;
 }
 /**
  * Factory function to create a new AGGridUrlSync instance

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

@@ -2,78 +2,56 @@ 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
- */
+import { serializeGrouped } from './serialization/grouped.js';
 export class AGGridUrlSync {
     config;
-    /**
-     * Creates a new instance of AGGridUrlSync
-     * @param gridApi - AG Grid API instance
-     * @param config - Optional configuration options
-     */
     constructor(gridApi, config = {}) {
         this.config = {
             gridApi,
-            paramPrefix: config.paramPrefix ?? DEFAULT_CONFIG.paramPrefix,
-            maxValueLength: config.maxValueLength ?? DEFAULT_CONFIG.maxValueLength,
-            onParseError: config.onParseError ?? (() => { })
+            ...DEFAULT_CONFIG,
+            ...config
         };
     }
-    /**
-     * Generates a URL with the current filter state
-     * @param baseUrl - Optional base URL (defaults to current URL)
-     * @returns URL string with filter parameters
-     */
     generateUrl(baseUrl) {
         const filterState = getFilterModel(this.config);
         const url = baseUrl ?? window.location.href;
         return generateUrl(url, filterState, this.config);
     }
-    /**
-     * Gets the current filter state as URL query parameters
-     * @returns Query parameter string
-     */
     getQueryParams() {
         const url = this.generateUrl();
         const urlObj = new URL(url);
         return urlObj.search;
     }
-    /**
-     * Applies filters from a URL to the grid
-     * @param url - Optional URL to parse (defaults to current URL)
-     */
     applyFromUrl(url) {
         const urlToParse = url ?? window.location.href;
         const filterState = parseUrlFilters(urlToParse, this.config);
         this.applyFilters(filterState);
     }
-    /**
-     * Applies a filter state object to the grid
-     * @param filterState - Filter state to apply
-     */
     applyFilters(filterState) {
         applyFilterModel(filterState, this.config);
     }
-    /**
-     * Clears all text filters from the grid
-     */
     clearFilters() {
         this.applyFilters({});
     }
-    /**
-     * Cleans up any resources or event listeners
-     */
     destroy() {
-        // Currently no cleanup needed, but included for future use
+    }
+    getSerializationMode() {
+        return this.config.serialization;
+    }
+    getCurrentFormat() {
+        return this.config.format;
+    }
+    getFiltersAsFormat(format) {
+        const filterState = getFilterModel(this.config);
+        const tempConfig = {
+            ...this.config,
+            format,
+            serialization: 'grouped'
+        };
+        const result = serializeGrouped(filterState, tempConfig);
+        return result.value;
     }
 }
-/**
- * Factory function to create a new AGGridUrlSync instance
- * @param gridApi - AG Grid API instance
- * @param config - Optional configuration options
- * @returns AGGridUrlSync instance
- */
 export function createUrlSync(gridApi, config) {
     return new AGGridUrlSync(gridApi, config);
 }

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

@@ -1 +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"}
+{"version":3,"file":"ag-grid-url-sync.js","sourceRoot":"","sources":["../../src/core/ag-grid-url-sync.ts"],"names":[],"mappings":"AAQA,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;AACxE,OAAO,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAA;AAK7D,MAAM,OAAO,aAAa;IAChB,MAAM,CAAgB;IAO9B,YAAY,OAAgB,EAAE,MAAM,GAAwB,EAAE;QAC5D,IAAI,CAAC,MAAM,GAAG;YACZ,OAAO;YACP,GAAG,cAAc;YACjB,GAAG,MAAM;SACV,CAAA;IACH,CAAC;IAOD,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;IAMD,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;IAMD,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;IAMD,YAAY,CAAC,WAAwB;QACnC,gBAAgB,CAAC,WAAW,EAAE,IAAI,CAAC,MAAM,CAAC,CAAA;IAC5C,CAAC;IAKD,YAAY;QACV,IAAI,CAAC,YAAY,CAAC,EAAE,CAAC,CAAA;IACvB,CAAC;IAKD,OAAO;IAEP,CAAC;IAMD,oBAAoB;QAClB,OAAO,IAAI,CAAC,MAAM,CAAC,aAAa,CAAA;IAClC,CAAC;IAMD,gBAAgB;QACd,OAAO,IAAI,CAAC,MAAM,CAAC,MAAM,CAAA;IAC3B,CAAC;IAKD,kBAAkB,CAAC,MAA2B;QAC5C,MAAM,WAAW,GAAG,cAAc,CAAC,IAAI,CAAC,MAAM,CAAC,CAAA;QAG/C,MAAM,UAAU,GAAG;YACjB,GAAG,IAAI,CAAC,MAAM;YACd,MAAM;YACN,aAAa,EAAE,SAAkB;SAClC,CAAA;QAGD,MAAM,MAAM,GAAG,gBAAgB,CAAC,WAAW,EAAE,UAAU,CAAC,CAAA;QAExD,OAAO,MAAM,CAAC,KAAK,CAAA;IACrB,CAAC;CACF;AAQD,MAAM,UAAU,aAAa,CAC3B,OAAgB,EAChB,MAA4B;IAE5B,OAAO,IAAI,aAAa,CAAC,OAAO,EAAE,MAAM,CAAC,CAAA;AAC3C,CAAC"}