ag-grid-url-sync 0.1.1 → 0.2.1

package/dist/core/types.d.ts

@@ -0,0 +1,112 @@
+import type { GridApi as AGGridApi } from 'ag-grid-community';
+/**
+ * Configuration options for AG Grid URL Sync
+ */
+export interface AGGridUrlSyncConfig {
+    /**
+     * Prefix for URL parameters. Default: 'f_'
+     */
+    paramPrefix?: string;
+    /**
+     * Maximum length for filter values. Default: 200
+     */
+    maxValueLength?: number;
+    /**
+     * Optional error handler for parsing errors
+     */
+    onParseError?: (error: Error) => void;
+}
+/**
+ * Supported filter operations
+ */
+export type FilterOperation = 'contains' | 'eq' | 'notContains' | 'notEqual' | 'startsWith' | 'endsWith' | 'blank' | 'notBlank';
+/**
+ * Filter state for a single column
+ */
+export interface ColumnFilter {
+    filterType: 'text';
+    type: FilterOperation;
+    filter: string;
+}
+/**
+ * Complete filter state mapping
+ */
+export interface FilterState {
+    [columnId: string]: ColumnFilter;
+}
+/**
+ * Internal configuration with defaults
+ */
+export interface InternalConfig extends Required<AGGridUrlSyncConfig> {
+    gridApi: AGGridApi;
+}
+/**
+ * Error types for URL sync operations
+ */
+export declare class URLSyncError extends Error {
+    constructor(message: string);
+}
+export declare class InvalidFilterError extends URLSyncError {
+    constructor(message: string);
+}
+export declare class InvalidURLError extends URLSyncError {
+    constructor(message: string);
+}
+export type ParsedFilterParam = {
+    columnName: string;
+    operation: FilterOperation;
+    value: string;
+    action: 'apply' | 'remove';
+};
+export type GridApi = AGGridApi;
+/**
+ * Operation Mapping Strategy:
+ *
+ * We use three different naming conventions for better user experience:
+ *
+ * 1. URL Parameters: Short, clean names for URLs (e.g., 'eq', 'neq')
+ * 2. Internal Types: Consistent naming for our FilterOperation type
+ * 3. AG Grid Operations: Exact names expected by AG Grid API (e.g., 'equals', 'notEqual')
+ *
+ * This approach keeps URLs readable while maintaining compatibility with AG Grid.
+ */
+export declare const OPERATION_MAP: {
+    readonly contains: "contains";
+    readonly eq: "eq";
+    readonly notContains: "notContains";
+    readonly neq: "notEqual";
+    readonly startsWith: "startsWith";
+    readonly endsWith: "endsWith";
+    readonly blank: "blank";
+    readonly notBlank: "notBlank";
+};
+export declare const INTERNAL_TO_URL_OPERATION_MAP: {
+    readonly contains: "contains";
+    readonly eq: "eq";
+    readonly notContains: "notContains";
+    readonly notEqual: "neq";
+    readonly startsWith: "startsWith";
+    readonly endsWith: "endsWith";
+    readonly blank: "blank";
+    readonly notBlank: "notBlank";
+};
+export declare const AG_GRID_OPERATION_NAMES: {
+    readonly contains: "contains";
+    readonly eq: "equals";
+    readonly notContains: "notContains";
+    readonly notEqual: "notEqual";
+    readonly startsWith: "startsWith";
+    readonly endsWith: "endsWith";
+    readonly blank: "blank";
+    readonly notBlank: "notBlank";
+};
+export declare const REVERSE_AG_GRID_OPERATION_NAMES: {
+    readonly contains: "contains";
+    readonly equals: "eq";
+    readonly notContains: "notContains";
+    readonly notEqual: "notEqual";
+    readonly startsWith: "startsWith";
+    readonly endsWith: "endsWith";
+    readonly blank: "blank";
+    readonly notBlank: "notBlank";
+};

package/dist/core/types.js

@@ -0,0 +1,79 @@
+/**
+ * Error types for URL sync operations
+ */
+export class URLSyncError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = 'URLSyncError';
+    }
+}
+export class InvalidFilterError extends URLSyncError {
+    constructor(message) {
+        super(message);
+        this.name = 'InvalidFilterError';
+    }
+}
+export class InvalidURLError extends URLSyncError {
+    constructor(message) {
+        super(message);
+        this.name = 'InvalidURLError';
+    }
+}
+/**
+ * Operation Mapping Strategy:
+ *
+ * We use three different naming conventions for better user experience:
+ *
+ * 1. URL Parameters: Short, clean names for URLs (e.g., 'eq', 'neq')
+ * 2. Internal Types: Consistent naming for our FilterOperation type
+ * 3. AG Grid Operations: Exact names expected by AG Grid API (e.g., 'equals', 'notEqual')
+ *
+ * This approach keeps URLs readable while maintaining compatibility with AG Grid.
+ */
+// URL parameter names to internal operation types
+// Uses short names for cleaner URLs: 'eq' instead of 'equals', 'neq' instead of 'notEqual'
+export const OPERATION_MAP = {
+    contains: 'contains',
+    eq: 'eq', // Short form for URL brevity
+    notContains: 'notContains',
+    neq: 'notEqual', // Short form: 'neq' -> 'notEqual'
+    startsWith: 'startsWith',
+    endsWith: 'endsWith',
+    blank: 'blank',
+    notBlank: 'notBlank'
+};
+// Internal operation types to URL parameter names
+export const INTERNAL_TO_URL_OPERATION_MAP = {
+    contains: 'contains',
+    eq: 'eq',
+    notContains: 'notContains',
+    notEqual: 'neq', // Internal 'notEqual' -> URL 'neq'
+    startsWith: 'startsWith',
+    endsWith: 'endsWith',
+    blank: 'blank',
+    notBlank: 'notBlank'
+};
+// Internal operation types to AG Grid operation names
+// AG Grid expects 'equals' not 'eq', 'notEqual' not 'neq'
+export const AG_GRID_OPERATION_NAMES = {
+    contains: 'contains',
+    eq: 'equals', // Internal 'eq' -> AG Grid 'equals'
+    notContains: 'notContains',
+    notEqual: 'notEqual',
+    startsWith: 'startsWith',
+    endsWith: 'endsWith',
+    blank: 'blank',
+    notBlank: 'notBlank'
+};
+// AG Grid operation names to internal operation types (reverse mapping)
+export const REVERSE_AG_GRID_OPERATION_NAMES = {
+    contains: 'contains',
+    equals: 'eq', // AG Grid 'equals' -> Internal 'eq'
+    notContains: 'notContains',
+    notEqual: 'notEqual',
+    startsWith: 'startsWith',
+    endsWith: 'endsWith',
+    blank: 'blank',
+    notBlank: 'notBlank'
+};
+//# sourceMappingURL=types.js.map

package/dist/core/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/core/types.ts"],"names":[],"mappings":"AA0DA;;GAEG;AACH,MAAM,OAAO,YAAa,SAAQ,KAAK;IACrC,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAA;QACd,IAAI,CAAC,IAAI,GAAG,cAAc,CAAA;IAC5B,CAAC;CACF;AAED,MAAM,OAAO,kBAAmB,SAAQ,YAAY;IAClD,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAA;QACd,IAAI,CAAC,IAAI,GAAG,oBAAoB,CAAA;IAClC,CAAC;CACF;AAED,MAAM,OAAO,eAAgB,SAAQ,YAAY;IAC/C,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAA;QACd,IAAI,CAAC,IAAI,GAAG,iBAAiB,CAAA;IAC/B,CAAC;CACF;AAYD;;;;;;;;;;GAUG;AAEH,kDAAkD;AAClD,2FAA2F;AAC3F,MAAM,CAAC,MAAM,aAAa,GAAG;IAC3B,QAAQ,EAAE,UAAU;IACpB,EAAE,EAAE,IAAI,EAAE,6BAA6B;IACvC,WAAW,EAAE,aAAa;IAC1B,GAAG,EAAE,UAAU,EAAE,kCAAkC;IACnD,UAAU,EAAE,YAAY;IACxB,QAAQ,EAAE,UAAU;IACpB,KAAK,EAAE,OAAO;IACd,QAAQ,EAAE,UAAU;CACZ,CAAA;AAEV,kDAAkD;AAClD,MAAM,CAAC,MAAM,6BAA6B,GAAG;IAC3C,QAAQ,EAAE,UAAU;IACpB,EAAE,EAAE,IAAI;IACR,WAAW,EAAE,aAAa;IAC1B,QAAQ,EAAE,KAAK,EAAE,mCAAmC;IACpD,UAAU,EAAE,YAAY;IACxB,QAAQ,EAAE,UAAU;IACpB,KAAK,EAAE,OAAO;IACd,QAAQ,EAAE,UAAU;CACZ,CAAA;AAEV,sDAAsD;AACtD,0DAA0D;AAC1D,MAAM,CAAC,MAAM,uBAAuB,GAAG;IACrC,QAAQ,EAAE,UAAU;IACpB,EAAE,EAAE,QAAQ,EAAE,oCAAoC;IAClD,WAAW,EAAE,aAAa;IAC1B,QAAQ,EAAE,UAAU;IACpB,UAAU,EAAE,YAAY;IACxB,QAAQ,EAAE,UAAU;IACpB,KAAK,EAAE,OAAO;IACd,QAAQ,EAAE,UAAU;CACZ,CAAA;AAEV,wEAAwE;AACxE,MAAM,CAAC,MAAM,+BAA+B,GAAG;IAC7C,QAAQ,EAAE,UAAU;IACpB,MAAM,EAAE,IAAI,EAAE,oCAAoC;IAClD,WAAW,EAAE,aAAa;IAC1B,QAAQ,EAAE,UAAU;IACpB,UAAU,EAAE,YAAY;IACxB,QAAQ,EAAE,UAAU;IACpB,KAAK,EAAE,OAAO;IACd,QAAQ,EAAE,UAAU;CACZ,CAAA"}

package/dist/core/url-generator.d.ts

@@ -0,0 +1,9 @@
+import type { FilterState, InternalConfig } from './types.js';
+/**
+ * Converts a filter state object into URL search parameters
+ */
+export declare function serializeFilters(filterState: FilterState, config: InternalConfig): URLSearchParams;
+/**
+ * Generates a URL with the current filter state
+ */
+export declare function generateUrl(baseUrl: string, filterState: FilterState, config: InternalConfig): string;

package/dist/core/url-generator.js

@@ -0,0 +1,42 @@
+import { validateFilterValue } from './validation.js';
+import { INTERNAL_TO_URL_OPERATION_MAP } from './types.js';
+/**
+ * Converts a filter state object into URL search parameters
+ */
+export function serializeFilters(filterState, config) {
+    const params = new URLSearchParams();
+    for (const [column, filter] of Object.entries(filterState)) {
+        if (filter.filterType !== 'text')
+            continue;
+        const operation = INTERNAL_TO_URL_OPERATION_MAP[filter.type];
+        if (!operation)
+            continue;
+        const paramName = `${config.paramPrefix}${column}_${operation}`;
+        // Special handling for blank operations
+        if (filter.type === 'blank' || filter.type === 'notBlank') {
+            params.append(paramName, 'true');
+        }
+        else {
+            const value = validateFilterValue(filter.filter, config, filter.type);
+            // URLSearchParams already handles encoding, so don't double-encode
+            params.append(paramName, value);
+        }
+    }
+    return params;
+}
+/**
+ * Generates a URL with the current filter state
+ */
+export function generateUrl(baseUrl, filterState, config) {
+    const url = new URL(baseUrl);
+    const filterParams = serializeFilters(filterState, config);
+    // Preserve existing non-filter parameters
+    for (const [key, value] of url.searchParams.entries()) {
+        if (!key.startsWith(config.paramPrefix)) {
+            filterParams.append(key, value);
+        }
+    }
+    url.search = filterParams.toString();
+    return url.toString();
+}
+//# sourceMappingURL=url-generator.js.map

package/dist/core/url-generator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"url-generator.js","sourceRoot":"","sources":["../../src/core/url-generator.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAA;AACrD,OAAO,EAAE,6BAA6B,EAAE,MAAM,YAAY,CAAA;AAE1D;;GAEG;AACH,MAAM,UAAU,gBAAgB,CAC9B,WAAwB,EACxB,MAAsB;IAEtB,MAAM,MAAM,GAAG,IAAI,eAAe,EAAE,CAAA;IAEpC,KAAK,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,WAAW,CAAC,EAAE,CAAC;QAC3D,IAAI,MAAM,CAAC,UAAU,KAAK,MAAM;YAAE,SAAQ;QAE1C,MAAM,SAAS,GACb,6BAA6B,CAC3B,MAAM,CAAC,IAAkD,CAC1D,CAAA;QACH,IAAI,CAAC,SAAS;YAAE,SAAQ;QAExB,MAAM,SAAS,GAAG,GAAG,MAAM,CAAC,WAAW,GAAG,MAAM,IAAI,SAAS,EAAE,CAAA;QAE/D,wCAAwC;QACxC,IAAI,MAAM,CAAC,IAAI,KAAK,OAAO,IAAI,MAAM,CAAC,IAAI,KAAK,UAAU,EAAE,CAAC;YAC1D,MAAM,CAAC,MAAM,CAAC,SAAS,EAAE,MAAM,CAAC,CAAA;QAClC,CAAC;aAAM,CAAC;YACN,MAAM,KAAK,GAAG,mBAAmB,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,IAAI,CAAC,CAAA;YACrE,mEAAmE;YACnE,MAAM,CAAC,MAAM,CAAC,SAAS,EAAE,KAAK,CAAC,CAAA;QACjC,CAAC;IACH,CAAC;IAED,OAAO,MAAM,CAAA;AACf,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,WAAW,CACzB,OAAe,EACf,WAAwB,EACxB,MAAsB;IAEtB,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,OAAO,CAAC,CAAA;IAC5B,MAAM,YAAY,GAAG,gBAAgB,CAAC,WAAW,EAAE,MAAM,CAAC,CAAA;IAE1D,0CAA0C;IAC1C,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,GAAG,CAAC,YAAY,CAAC,OAAO,EAAE,EAAE,CAAC;QACtD,IAAI,CAAC,GAAG,CAAC,UAAU,CAAC,MAAM,CAAC,WAAW,CAAC,EAAE,CAAC;YACxC,YAAY,CAAC,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,CAAA;QACjC,CAAC;IACH,CAAC;IAED,GAAG,CAAC,MAAM,GAAG,YAAY,CAAC,QAAQ,EAAE,CAAA;IACpC,OAAO,GAAG,CAAC,QAAQ,EAAE,CAAA;AACvB,CAAC"}

package/dist/core/url-parser.d.ts

@@ -0,0 +1,9 @@
+import type { FilterState, ColumnFilter, InternalConfig } from './types.js';
+/**
+ * Parses a URL parameter into a column filter
+ */
+export declare function parseFilterParam(param: string, value: string, expectedPrefix?: string): ColumnFilter;
+/**
+ * Converts URL search params into a filter state object
+ */
+export declare function parseUrlFilters(url: string, config: InternalConfig): FilterState;

package/dist/core/url-parser.js

@@ -0,0 +1,85 @@
+import { InvalidFilterError, InvalidURLError, OPERATION_MAP } from './types.js';
+import { validateFilterValue, DEFAULT_CONFIG } from './validation.js';
+/**
+ * Extracts column name and operation from a filter parameter
+ */
+function extractColumnAndOperation(param, expectedPrefix) {
+    const ensureTrailingUnderscore = (prefix) => prefix.endsWith('_') ? prefix : prefix + '_';
+    const sanitizedPrefix = expectedPrefix
+        ? ensureTrailingUnderscore(expectedPrefix)
+        : ensureTrailingUnderscore(DEFAULT_CONFIG.paramPrefix);
+    const prefixToCheck = sanitizedPrefix.slice(0, -1);
+    if (!param.startsWith(prefixToCheck + '_')) {
+        throw new InvalidFilterError(`Invalid filter prefix in parameter: ${param}`);
+    }
+    // Remove prefix and find the last underscore to separate column from operation
+    const withoutPrefix = param.substring(prefixToCheck.length + 1);
+    const lastUnderscoreIndex = withoutPrefix.lastIndexOf('_');
+    if (lastUnderscoreIndex === -1) {
+        throw new InvalidFilterError(`Invalid filter parameter format: ${param}`);
+    }
+    const column = withoutPrefix.substring(0, lastUnderscoreIndex);
+    const operation = withoutPrefix.substring(lastUnderscoreIndex + 1);
+    if (!column.trim()) {
+        throw new InvalidFilterError(`Empty column name in parameter: ${param}`);
+    }
+    return { column, operation };
+}
+/**
+ * Parses a URL parameter into a column filter
+ */
+export function parseFilterParam(param, value, expectedPrefix) {
+    const { operation } = extractColumnAndOperation(param, expectedPrefix);
+    const filterOp = OPERATION_MAP[operation];
+    if (!filterOp) {
+        throw new InvalidFilterError(`Unsupported filter operation: ${operation}`);
+    }
+    // Special handling for blank operations - they don't use the value
+    if (filterOp === 'blank' || filterOp === 'notBlank') {
+        return {
+            filterType: 'text',
+            type: filterOp,
+            filter: '' // Blank operations don't use the value
+        };
+    }
+    return {
+        filterType: 'text',
+        type: filterOp,
+        filter: value || ''
+    };
+}
+/**
+ * Converts URL search params into a filter state object
+ */
+export function parseUrlFilters(url, config) {
+    try {
+        const urlObj = new URL(url);
+        const filterState = {};
+        for (const [param, value] of urlObj.searchParams.entries()) {
+            if (!param.startsWith(config.paramPrefix))
+                continue;
+            try {
+                // Extract column name and parse the filter parameter
+                const { column: columnName } = extractColumnAndOperation(param, config.paramPrefix);
+                const filterParam = parseFilterParam(param, value, config.paramPrefix);
+                const validatedValue = validateFilterValue(value, config, filterParam.type);
+                filterState[columnName] = {
+                    ...filterParam,
+                    filter: validatedValue
+                };
+            }
+            catch (err) {
+                if (config.onParseError) {
+                    config.onParseError(err);
+                }
+                // Skip invalid filters but continue processing
+                continue;
+            }
+        }
+        return filterState;
+    }
+    catch (err) {
+        throw new InvalidURLError(`Failed to parse URL: ${err.message}`);
+    }
+}
+//# sourceMappingURL=url-parser.js.map

package/dist/core/url-parser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"url-parser.js","sourceRoot":"","sources":["../../src/core/url-parser.ts"],"names":[],"mappings":"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"}

package/dist/core/validation.d.ts

@@ -0,0 +1,18 @@
+import type { InternalConfig, FilterOperation } from './types.js';
+/**
+ * Default configuration values
+ */
+export declare const DEFAULT_CONFIG: {
+    readonly paramPrefix: "f_";
+    readonly maxValueLength: 200;
+};
+/**
+ * Validates a filter value against configuration constraints
+ *
+ * @param value - The filter value to validate
+ * @param config - Internal configuration with validation rules
+ * @param operation - Optional filter operation type. Blank operations (blank/notBlank) bypass value validation
+ * @returns The validated filter value (empty string for blank operations)
+ * @throws InvalidFilterError if value exceeds maximum length
+ */
+export declare function validateFilterValue(value: string, config: InternalConfig, operation?: FilterOperation): string;

package/dist/core/validation.js

@@ -0,0 +1,28 @@
+import { InvalidFilterError } from './types.js';
+/**
+ * Default configuration values
+ */
+export const DEFAULT_CONFIG = {
+    paramPrefix: 'f_',
+    maxValueLength: 200
+};
+/**
+ * Validates a filter value against configuration constraints
+ *
+ * @param value - The filter value to validate
+ * @param config - Internal configuration with validation rules
+ * @param operation - Optional filter operation type. Blank operations (blank/notBlank) bypass value validation
+ * @returns The validated filter value (empty string for blank operations)
+ * @throws InvalidFilterError if value exceeds maximum length
+ */
+export function validateFilterValue(value, config, operation) {
+    // Blank operations don't require value validation
+    if (operation === 'blank' || operation === 'notBlank') {
+        return '';
+    }
+    if (value.length > config.maxValueLength) {
+        throw new InvalidFilterError(`Filter value exceeds maximum length of ${config.maxValueLength} characters`);
+    }
+    return value;
+}
+//# sourceMappingURL=validation.js.map

package/dist/core/validation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.js","sourceRoot":"","sources":["../../src/core/validation.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAA;AAE/C;;GAEG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG;IAC5B,WAAW,EAAE,IAAI;IACjB,cAAc,EAAE,GAAG;CACX,CAAA;AAEV;;;;;;;;GAQG;AACH,MAAM,UAAU,mBAAmB,CACjC,KAAa,EACb,MAAsB,EACtB,SAA2B;IAE3B,kDAAkD;IAClD,IAAI,SAAS,KAAK,OAAO,IAAI,SAAS,KAAK,UAAU,EAAE,CAAC;QACtD,OAAO,EAAE,CAAA;IACX,CAAC;IAED,IAAI,KAAK,CAAC,MAAM,GAAG,MAAM,CAAC,cAAc,EAAE,CAAC;QACzC,MAAM,IAAI,kBAAkB,CAC1B,0CAA0C,MAAM,CAAC,cAAc,aAAa,CAC7E,CAAA;IACH,CAAC;IACD,OAAO,KAAK,CAAA;AACd,CAAC"}

package/dist/index.d.ts

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

package/dist/index.js

@@ -1,4 +1,12 @@
-export { AGGridUrlSync, createUrlSync } from './ag-grid-url-sync.js';
-export * from './types.js';
-export { parseUrlFilters, serializeFilters, generateUrl, getFilterModel, applyFilterModel, validateFilterValue, parseFilterParam, DEFAULT_CONFIG } from './utils.js';
+// Export core functionality (vanilla JS)
+export { AGGridUrlSync, createUrlSync } from './core/ag-grid-url-sync.js';
+export * from './core/types.js';
+// Validation utilities
+export { validateFilterValue, DEFAULT_CONFIG } from './core/validation.js';
+// URL parsing utilities
+export { parseUrlFilters, parseFilterParam } from './core/url-parser.js';
+// URL generation utilities
+export { serializeFilters, generateUrl } from './core/url-generator.js';
+// AG Grid integration utilities
+export { getFilterModel, applyFilterModel } from './core/grid-integration.js';
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAA;AAEpE,cAAc,YAAY,CAAA;AAE1B,OAAO,EACL,eAAe,EACf,gBAAgB,EAChB,WAAW,EACX,cAAc,EACd,gBAAgB,EAChB,mBAAmB,EACnB,gBAAgB,EAChB,cAAc,EACf,MAAM,YAAY,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,yCAAyC;AACzC,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAA;AAEzE,cAAc,iBAAiB,CAAA;AAE/B,uBAAuB;AACvB,OAAO,EAAE,mBAAmB,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAA;AAE1E,wBAAwB;AACxB,OAAO,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAA;AAExE,2BAA2B;AAC3B,OAAO,EAAE,gBAAgB,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAA;AAEvE,gCAAgC;AAChC,OAAO,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAA"}

package/dist/react/index.d.ts

@@ -0,0 +1,3 @@
+export { useAGGridUrlSync } from './use-ag-grid-url-sync.js';
+export type { UseAGGridUrlSyncOptions, UseAGGridUrlSyncReturn } from './types.js';
+export type { FilterState, ColumnFilter, FilterOperation, AGGridUrlSyncConfig, GridApi } from '../core/types.js';

package/dist/react/index.js

@@ -0,0 +1,2 @@
+export { useAGGridUrlSync } from './use-ag-grid-url-sync.js';
+//# sourceMappingURL=index.js.map

package/dist/react/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/react/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAA"}

package/dist/react/types.d.ts

@@ -0,0 +1,64 @@
+import type { AGGridUrlSyncConfig, FilterState } from '../core/types.js';
+/**
+ * Configuration options for the React hook
+ */
+export interface UseAGGridUrlSyncOptions extends AGGridUrlSyncConfig {
+    /**
+     * Automatically apply URL filters when the component mounts and grid API becomes ready
+     * Default: false
+     */
+    autoApplyOnMount?: boolean;
+    /**
+     * Whether the hook should be enabled when the grid API is ready
+     * Default: true
+     */
+    enabledWhenReady?: boolean;
+}
+/**
+ * Return type for the useAGGridUrlSync hook
+ */
+export interface UseAGGridUrlSyncReturn {
+    /**
+     * Generate a URL with current filter state
+     * @param baseUrl - Optional base URL (defaults to current URL)
+     * @returns URL string with filter parameters
+     */
+    shareUrl: (baseUrl?: string) => string;
+    /**
+     * Get current filter state as query parameters string
+     * @returns Query parameter string
+     */
+    getQueryParams: () => string;
+    /**
+     * Apply filters from a URL to the grid
+     * @param url - Optional URL to parse (defaults to current URL)
+     */
+    applyUrlFilters: (url?: string) => void;
+    /**
+     * Clear all text filters from the grid
+     */
+    clearFilters: () => void;
+    /**
+     * Whether the grid API is available and hook is ready
+     */
+    isReady: boolean;
+    /**
+     * Current generated URL with filters
+     */
+    currentUrl: string;
+    /**
+     * Whether the grid has any active text filters
+     */
+    hasFilters: boolean;
+    /**
+     * Parse filters from a URL without applying them
+     * @param url - URL to parse
+     * @returns Parsed filter state
+     */
+    parseUrlFilters: (url: string) => FilterState;
+    /**
+     * Apply a filter state object to the grid
+     * @param filters - Filter state to apply
+     */
+    applyFilters: (filters: FilterState) => void;
+}

package/dist/react/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/react/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/react/types.ts"],"names":[],"mappings":""}

package/dist/react/use-ag-grid-url-sync.d.ts

@@ -0,0 +1,10 @@
+import type { GridApi } from 'ag-grid-community';
+import type { UseAGGridUrlSyncOptions, UseAGGridUrlSyncReturn } from './types.js';
+/**
+ * React hook for AG Grid URL synchronization
+ *
+ * @param gridApi - AG Grid API instance (can be null during initialization)
+ * @param options - Configuration options for the hook
+ * @returns Hook API for URL synchronization
+ */
+export declare function useAGGridUrlSync(gridApi: GridApi | null, options?: UseAGGridUrlSyncOptions): UseAGGridUrlSyncReturn;