@zengrid/core 1.0.1

package/dist/src/features/copy-paste/clipboard-manager.d.ts

@@ -0,0 +1,116 @@
+import type { CellRange } from '../../types';
+import type { EventEmitter } from '../../events/event-emitter';
+import type { GridEvents } from '../../events/grid-events';
+/**
+ * Clipboard manager options
+ */
+export interface ClipboardManagerOptions {
+    /**
+     * Event emitter for grid events
+     */
+    events?: EventEmitter<GridEvents>;
+    /**
+     * Callback to get cell value
+     */
+    getValue: (row: number, col: number) => any;
+    /**
+     * Callback to set cell value
+     */
+    setValue: (row: number, col: number, value: any) => void;
+    /**
+     * Callback to delete cell value
+     */
+    deleteValue?: (row: number, col: number) => void;
+    /**
+     * Include headers in copy
+     * @default false
+     */
+    includeHeaders?: boolean;
+    /**
+     * Callback to get column header
+     */
+    getColumnHeader?: (col: number) => string;
+}
+/**
+ * ClipboardManager - Handles copy/cut/paste operations
+ *
+ * Supports multiple formats:
+ * - text/plain: TSV (tab-separated values)
+ * - text/html: HTML table format
+ *
+ * Compatible with Excel and Google Sheets.
+ *
+ * @example
+ * ```typescript
+ * const clipboard = new ClipboardManager({
+ *   getValue: (row, col) => data[row][col],
+ *   setValue: (row, col, value) => { data[row][col] = value; },
+ * });
+ *
+ * // Copy selection
+ * await clipboard.copy([
+ *   { startRow: 0, startCol: 0, endRow: 2, endCol: 2 },
+ * ]);
+ *
+ * // Paste at location
+ * await clipboard.paste(5, 0);
+ * ```
+ */
+export declare class ClipboardManager {
+    private events?;
+    private getValue;
+    private setValue;
+    private deleteValue?;
+    private includeHeaders;
+    private getColumnHeader?;
+    constructor(options: ClipboardManagerOptions);
+    /**
+     * Copy selected ranges to clipboard
+     * @param ranges - Ranges to copy
+     */
+    copy(ranges: CellRange[]): Promise<void>;
+    /**
+     * Cut selected ranges to clipboard (copy + delete)
+     * @param ranges - Ranges to cut
+     */
+    cut(ranges: CellRange[]): Promise<void>;
+    /**
+     * Paste from clipboard at target location
+     * @param targetRow - Target row
+     * @param targetCol - Target column
+     */
+    paste(targetRow: number, targetCol: number): Promise<void>;
+    /**
+     * Extract data from a range
+     */
+    private extractRangeData;
+    /**
+     * Convert data to TSV format
+     */
+    private toTSV;
+    /**
+     * Format cell value for TSV
+     */
+    private formatCellForTSV;
+    /**
+     * Convert data to HTML table format
+     */
+    private toHTML;
+    /**
+     * Escape HTML special characters
+     */
+    private escapeHTML;
+    /**
+     * Parse TSV text to 2D array
+     */
+    private parseTSV;
+    /**
+     * Parse HTML table to 2D array
+     */
+    private parseHTML;
+    /**
+     * Paste data at target location
+     */
+    private pasteData;
+}
+//# sourceMappingURL=clipboard-manager.d.ts.map

package/dist/src/features/copy-paste/clipboard-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"clipboard-manager.d.ts","sourceRoot":"","sources":["../../../../../../packages/core/src/features/copy-paste/clipboard-manager.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAC/D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AAE3D;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC;;OAEG;IACH,MAAM,CAAC,EAAE,YAAY,CAAC,UAAU,CAAC,CAAC;IAElC;;OAEG;IACH,QAAQ,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,KAAK,GAAG,CAAC;IAE5C;;OAEG;IACH,QAAQ,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,KAAK,IAAI,CAAC;IAEzD;;OAEG;IACH,WAAW,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;IAEjD;;;OAGG;IACH,cAAc,CAAC,EAAE,OAAO,CAAC;IAEzB;;OAEG;IACH,eAAe,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,MAAM,CAAC;CAC3C;AAED;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,MAAM,CAAC,CAA2B;IAC1C,OAAO,CAAC,QAAQ,CAAoC;IACpD,OAAO,CAAC,QAAQ,CAAiD;IACjE,OAAO,CAAC,WAAW,CAAC,CAAqC;IACzD,OAAO,CAAC,cAAc,CAAU;IAChC,OAAO,CAAC,eAAe,CAAC,CAA0B;gBAEtC,OAAO,EAAE,uBAAuB;IAS5C;;;OAGG;IACG,IAAI,CAAC,MAAM,EAAE,SAAS,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAuC9C;;;OAGG;IACG,GAAG,CAAC,MAAM,EAAE,SAAS,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IA4B7C;;;;OAIG;IACG,KAAK,CAAC,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAsChE;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAwBxB;;OAEG;IACH,OAAO,CAAC,KAAK;IAMb;;OAEG;IACH,OAAO,CAAC,gBAAgB;IASxB;;OAEG;IACH,OAAO,CAAC,MAAM;IAkBd;;OAEG;IACH,OAAO,CAAC,UAAU;IASlB;;OAEG;IACH,OAAO,CAAC,QAAQ;IAKhB;;OAEG;IACH,OAAO,CAAC,SAAS;IA6BjB;;OAEG;IACH,OAAO,CAAC,SAAS;CAiBlB"}

package/dist/src/features/copy-paste/index.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Copy/Paste functionality for ZenGrid
+ */
+export { ClipboardManager } from './clipboard-manager';
+export type { ClipboardManagerOptions } from './clipboard-manager';
+//# sourceMappingURL=index.d.ts.map

package/dist/src/features/copy-paste/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../packages/core/src/features/copy-paste/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AACvD,YAAY,EAAE,uBAAuB,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/src/features/filtering/adapters/adapter.interface.d.ts

@@ -0,0 +1,100 @@
+/**
+ * Filter Adapter Interface
+ *
+ * Base interface for all filter export adapters.
+ * Adapters transform field-based filter state into specific output formats.
+ */
+import type { FieldFilterState, CustomOperator } from '../types';
+/**
+ * Base configuration for all adapters
+ */
+export interface AdapterConfig {
+    /**
+     * Custom operator definitions
+     * Extends built-in operators with domain-specific ones
+     */
+    customOperators?: CustomOperator[];
+    /**
+     * Field name transformation function
+     * Useful for converting between naming conventions
+     *
+     * @example camelCase to snake_case
+     * ```typescript
+     * fieldTransform: (field) => field.replace(/[A-Z]/g, m => `_${m.toLowerCase()}`)
+     * ```
+     *
+     * @example Add table prefix
+     * ```typescript
+     * fieldTransform: (field) => `users.${field}`
+     * ```
+     */
+    fieldTransform?: (field: string) => string;
+    /**
+     * Value serialization function
+     * Transforms filter values before export
+     *
+     * @example Date to ISO string
+     * ```typescript
+     * valueSerializer: (value) => value instanceof Date ? value.toISOString() : value
+     * ```
+     */
+    valueSerializer?: (value: any) => any;
+}
+/**
+ * Filter Adapter Interface
+ *
+ * All adapters must implement this interface to transform
+ * filter state into their specific output format.
+ *
+ * @template TOutput - The output type of this adapter
+ *
+ * @example
+ * ```typescript
+ * class CustomAdapter implements FilterAdapter<MyCustomFormat> {
+ *   readonly name = 'custom';
+ *
+ *   transform(state: FieldFilterState, options?: any): MyCustomFormat {
+ *     // Transform logic here
+ *     return customFormat;
+ *   }
+ *
+ *   parse(input: MyCustomFormat): FieldFilterState {
+ *     // Reverse parse logic (optional)
+ *     return fieldState;
+ *   }
+ * }
+ * ```
+ */
+export interface FilterAdapter<TOutput> {
+    /**
+     * Adapter name (unique identifier)
+     * @example 'rest', 'graphql', 'sql'
+     */
+    readonly name: string;
+    /**
+     * Transform field-based filter state to output format
+     *
+     * @param state - Field-based filter state
+     * @param options - Adapter-specific options (optional)
+     * @returns Transformed output in adapter's format
+     */
+    transform(state: FieldFilterState, options?: any): TOutput;
+    /**
+     * Parse output format back to field-based filter state (optional)
+     *
+     * Enables bidirectional transformation for use cases like:
+     * - URL-based filter state hydration
+     * - Storing/loading filter presets
+     * - Syncing filter state across tabs
+     *
+     * @param input - Output format to parse
+     * @returns Field-based filter state
+     */
+    parse?(input: TOutput): FieldFilterState;
+}
+/**
+ * Adapter registry type
+ * Maps adapter names to adapter instances
+ */
+export type AdapterRegistry = Map<string, FilterAdapter<any>>;
+//# sourceMappingURL=adapter.interface.d.ts.map

package/dist/src/features/filtering/adapters/adapter.interface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapter.interface.d.ts","sourceRoot":"","sources":["../../../../../../../packages/core/src/features/filtering/adapters/adapter.interface.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAEjE;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B;;;OAGG;IACH,eAAe,CAAC,EAAE,cAAc,EAAE,CAAC;IAEnC;;;;;;;;;;;;;OAaG;IACH,cAAc,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,MAAM,CAAC;IAE3C;;;;;;;;OAQG;IACH,eAAe,CAAC,EAAE,CAAC,KAAK,EAAE,GAAG,KAAK,GAAG,CAAC;CACvC;AAED;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,MAAM,WAAW,aAAa,CAAC,OAAO;IACpC;;;OAGG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAEtB;;;;;;OAMG;IACH,SAAS,CAAC,KAAK,EAAE,gBAAgB,EAAE,OAAO,CAAC,EAAE,GAAG,GAAG,OAAO,CAAC;IAE3D;;;;;;;;;;OAUG;IACH,KAAK,CAAC,CAAC,KAAK,EAAE,OAAO,GAAG,gBAAgB,CAAC;CAC1C;AAED;;;GAGG;AACH,MAAM,MAAM,eAAe,GAAG,GAAG,CAAC,MAAM,EAAE,aAAa,CAAC,GAAG,CAAC,CAAC,CAAC"}

package/dist/src/features/filtering/adapters/graphql-adapter.d.ts

@@ -0,0 +1,124 @@
+/**
+ * GraphQL Filter Adapter
+ *
+ * Transforms field-based filters into GraphQL where clauses.
+ * Supports Prisma, Hasura, and Apollo/custom schemas.
+ */
+import type { FilterAdapter, AdapterConfig } from './adapter.interface';
+import type { GraphQLFilterExport } from './types';
+import type { FieldFilterState, FieldFilterCondition } from '../types';
+/**
+ * GraphQL schema styles
+ */
+export type GraphQLStyle = 'prisma' | 'hasura' | 'apollo' | 'custom';
+/**
+ * GraphQL adapter configuration
+ */
+export interface GraphQLAdapterOptions extends AdapterConfig {
+    /**
+     * GraphQL schema style
+     * - prisma:  { age: { gt: 18 }, status: { equals: "active" } }
+     * - hasura:  { age: { _gt: 18 }, status: { _eq: "active" } }
+     * - apollo:  Similar to Prisma but with different conventions
+     * - custom:  Use customWhereBuilder
+     *
+     * @default 'prisma'
+     */
+    style?: GraphQLStyle;
+    /**
+     * Custom where clause builder
+     * Only used when style is 'custom'
+     */
+    customWhereBuilder?: (conditions: FieldFilterCondition[]) => Record<string, any>;
+    /**
+     * Generate GraphQL variables instead of inline values
+     * Recommended for security and performance
+     *
+     * @default true
+     */
+    useVariables?: boolean;
+}
+/**
+ * GraphQL Filter Adapter
+ *
+ * @example Prisma style
+ * ```typescript
+ * const adapter = new GraphQLFilterAdapter({ style: 'prisma' });
+ * const result = adapter.transform(filterState);
+ * // result.where: {
+ * //   age: { gt: 18 },
+ * //   status: { equals: "active" }
+ * // }
+ * ```
+ *
+ * @example Hasura style
+ * ```typescript
+ * const adapter = new GraphQLFilterAdapter({ style: 'hasura' });
+ * const result = adapter.transform(filterState);
+ * // result.where: {
+ * //   age: { _gt: 18 },
+ * //   status: { _eq: "active" }
+ * // }
+ * ```
+ *
+ * @example With variables
+ * ```typescript
+ * const adapter = new GraphQLFilterAdapter({
+ *   style: 'prisma',
+ *   useVariables: true
+ * });
+ * const result = adapter.transform(filterState);
+ * // result.where: { age: { gt: $age }, status: { equals: $status } }
+ * // result.variables: { age: 18, status: "active" }
+ * // result.variablesTypeDef: "$age: Int, $status: String"
+ * ```
+ */
+export declare class GraphQLFilterAdapter implements FilterAdapter<GraphQLFilterExport> {
+    readonly name = "graphql";
+    private options;
+    private variables;
+    private variableCounter;
+    constructor(options?: GraphQLAdapterOptions);
+    /**
+     * Transform field-based filter state to GraphQL format
+     */
+    transform(state: FieldFilterState): GraphQLFilterExport;
+    /**
+     * Process a filter group
+     */
+    private processGroup;
+    /**
+     * Build where clause for a single condition
+     */
+    private buildConditionWhere;
+    /**
+     * Build operator object { op: value } or { op: $variable }
+     */
+    private buildOperatorObject;
+    /**
+     * Map standard operator to GraphQL operator
+     */
+    private mapOperatorToGraphQL;
+    /**
+     * Map to Prisma style operators
+     */
+    private mapToPrisma;
+    /**
+     * Map to Hasura style operators (with underscore prefix)
+     */
+    private mapToHasura;
+    /**
+     * Create a GraphQL variable and return its name
+     */
+    private createVariable;
+    /**
+     * Build GraphQL variables type definition
+     * @example "$var1: Int, $var2: String"
+     */
+    private buildVariablesTypeDef;
+    /**
+     * Infer GraphQL type from JavaScript value
+     */
+    private inferGraphQLType;
+}
+//# sourceMappingURL=graphql-adapter.d.ts.map

package/dist/src/features/filtering/adapters/graphql-adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"graphql-adapter.d.ts","sourceRoot":"","sources":["../../../../../../../packages/core/src/features/filtering/adapters/graphql-adapter.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACxE,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,SAAS,CAAC;AACnD,OAAO,KAAK,EAAE,gBAAgB,EAAoB,oBAAoB,EAA0B,MAAM,UAAU,CAAC;AAEjH;;GAEG;AACH,MAAM,MAAM,YAAY,GAAG,QAAQ,GAAG,QAAQ,GAAG,QAAQ,GAAG,QAAQ,CAAC;AAErE;;GAEG;AACH,MAAM,WAAW,qBAAsB,SAAQ,aAAa;IAC1D;;;;;;;;OAQG;IACH,KAAK,CAAC,EAAE,YAAY,CAAC;IAErB;;;OAGG;IACH,kBAAkB,CAAC,EAAE,CAAC,UAAU,EAAE,oBAAoB,EAAE,KAAK,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAEjF;;;;;OAKG;IACH,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AACH,qBAAa,oBAAqB,YAAW,aAAa,CAAC,mBAAmB,CAAC;IAC7E,QAAQ,CAAC,IAAI,aAAa;IAE1B,OAAO,CAAC,OAAO,CAAkH;IACjI,OAAO,CAAC,SAAS,CAA2B;IAC5C,OAAO,CAAC,eAAe,CAAK;gBAEhB,OAAO,GAAE,qBAA0B;IAW/C;;OAEG;IACH,SAAS,CAAC,KAAK,EAAE,gBAAgB,GAAG,mBAAmB;IAgCvD;;OAEG;IACH,OAAO,CAAC,YAAY;IA2BpB;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAyD3B;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAS3B;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAW5B;;OAEG;IACH,OAAO,CAAC,WAAW;IAuBnB;;OAEG;IACH,OAAO,CAAC,WAAW;IAuBnB;;OAEG;IACH,OAAO,CAAC,cAAc;IAOtB;;;OAGG;IACH,OAAO,CAAC,qBAAqB;IAW7B;;OAEG;IACH,OAAO,CAAC,gBAAgB;CAwBzB"}

package/dist/src/features/filtering/adapters/index.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Filter Adapters
+ *
+ * Export all filter adapters and related types
+ */
+export * from './types';
+export * from './adapter.interface';
+export * from './rest-adapter';
+export * from './graphql-adapter';
+export * from './sql-adapter';
+//# sourceMappingURL=index.d.ts.map

package/dist/src/features/filtering/adapters/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../../packages/core/src/features/filtering/adapters/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,cAAc,SAAS,CAAC;AACxB,cAAc,qBAAqB,CAAC;AAGpC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,mBAAmB,CAAC;AAClC,cAAc,eAAe,CAAC"}

package/dist/src/features/filtering/adapters/rest-adapter.d.ts

@@ -0,0 +1,108 @@
+/**
+ * REST Filter Adapter
+ *
+ * Transforms field-based filters into REST API query parameters.
+ * Supports three query string styles: brackets, dots, and flat.
+ */
+import type { FilterAdapter, AdapterConfig } from './adapter.interface';
+import type { RESTFilterExport } from './types';
+import type { FieldFilterState } from '../types';
+/**
+ * REST adapter configuration
+ */
+export interface RESTAdapterOptions extends AdapterConfig {
+    /**
+     * Query string style
+     * - brackets: ?filter[age][gt]=18
+     * - dots:     ?filter.age.gt=18
+     * - flat:     ?age_gt=18
+     *
+     * @default 'brackets'
+     */
+    style?: 'brackets' | 'dots' | 'flat';
+    /**
+     * Array format for 'in' operator
+     * - brackets: ?status[]=active&status[]=pending
+     * - comma:    ?status=active,pending
+     * - repeat:   ?status=active&status=pending
+     *
+     * @default 'brackets'
+     */
+    arrayFormat?: 'brackets' | 'comma' | 'repeat';
+    /**
+     * URL-encode parameter values
+     * @default true
+     */
+    encode?: boolean;
+    /**
+     * Prefix for filter parameters (used in brackets/dots styles)
+     * @default 'filter'
+     */
+    prefix?: string;
+}
+/**
+ * REST Filter Adapter
+ *
+ * @example Brackets style (default)
+ * ```typescript
+ * const adapter = new RESTFilterAdapter({ style: 'brackets' });
+ * const result = adapter.transform(filterState);
+ * // result.queryString: "?filter[age][gt]=18&filter[status][eq]=active"
+ * ```
+ *
+ * @example Dots style
+ * ```typescript
+ * const adapter = new RESTFilterAdapter({ style: 'dots' });
+ * const result = adapter.transform(filterState);
+ * // result.queryString: "?filter.age.gt=18&filter.status.eq=active"
+ * ```
+ *
+ * @example Flat style
+ * ```typescript
+ * const adapter = new RESTFilterAdapter({ style: 'flat' });
+ * const result = adapter.transform(filterState);
+ * // result.queryString: "?age_gt=18&status_eq=active"
+ * ```
+ */
+export declare class RESTFilterAdapter implements FilterAdapter<RESTFilterExport> {
+    readonly name = "rest";
+    private options;
+    constructor(options?: RESTAdapterOptions);
+    /**
+     * Transform field-based filter state to REST format
+     */
+    transform(state: FieldFilterState): RESTFilterExport;
+    /**
+     * Process a filter group and add parameters
+     */
+    private processGroup;
+    /**
+     * Add a single condition to params
+     */
+    private addConditionToParams;
+    /**
+     * Build parameter key based on style
+     */
+    private buildParamKey;
+    /**
+     * Add array parameter based on arrayFormat
+     */
+    private addArrayParam;
+    /**
+     * Serialize value to string
+     */
+    private serializeValue;
+    /**
+     * Build query string from params
+     */
+    private buildQueryString;
+    /**
+     * Encode a key-value pair
+     */
+    private encodePair;
+    /**
+     * Parse REST query string back to field-based filter state (optional)
+     */
+    parse(input: RESTFilterExport): FieldFilterState;
+}
+//# sourceMappingURL=rest-adapter.d.ts.map

package/dist/src/features/filtering/adapters/rest-adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rest-adapter.d.ts","sourceRoot":"","sources":["../../../../../../../packages/core/src/features/filtering/adapters/rest-adapter.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACxE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAC;AAChD,OAAO,KAAK,EAAE,gBAAgB,EAAkE,MAAM,UAAU,CAAC;AAEjH;;GAEG;AACH,MAAM,WAAW,kBAAmB,SAAQ,aAAa;IACvD;;;;;;;OAOG;IACH,KAAK,CAAC,EAAE,UAAU,GAAG,MAAM,GAAG,MAAM,CAAC;IAErC;;;;;;;OAOG;IACH,WAAW,CAAC,EAAE,UAAU,GAAG,OAAO,GAAG,QAAQ,CAAC;IAE9C;;;OAGG;IACH,MAAM,CAAC,EAAE,OAAO,CAAC;IAEjB;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,qBAAa,iBAAkB,YAAW,aAAa,CAAC,gBAAgB,CAAC;IACvE,QAAQ,CAAC,IAAI,UAAU;IAEvB,OAAO,CAAC,OAAO,CAA+B;gBAElC,OAAO,GAAE,kBAAuB;IAY5C;;OAEG;IACH,SAAS,CAAC,KAAK,EAAE,gBAAgB,GAAG,gBAAgB;IAqBpD;;OAEG;IACH,OAAO,CAAC,YAAY;IAcpB;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAyC5B;;OAEG;IACH,OAAO,CAAC,aAAa;IAarB;;OAEG;IACH,OAAO,CAAC,aAAa;IAoCrB;;OAEG;IACH,OAAO,CAAC,cAAc;IActB;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAkBxB;;OAEG;IACH,OAAO,CAAC,UAAU;IAOlB;;OAEG;IACH,KAAK,CAAC,KAAK,EAAE,gBAAgB,GAAG,gBAAgB;CASjD"}

package/dist/src/features/filtering/adapters/sql-adapter.d.ts

@@ -0,0 +1,123 @@
+/**
+ * SQL Filter Adapter
+ *
+ * Transforms field-based filters into parameterized SQL WHERE clauses.
+ * Supports positional (?), named (:name), and dollar ($1) parameter styles.
+ */
+import type { FilterAdapter, AdapterConfig } from './adapter.interface';
+import type { SQLFilterExport } from './types';
+import type { FieldFilterState } from '../types';
+/**
+ * SQL parameter styles
+ */
+export type SQLParamStyle = 'positional' | 'named' | 'dollar';
+/**
+ * SQL adapter configuration
+ */
+export interface SQLAdapterOptions extends AdapterConfig {
+    /**
+     * Parameter style
+     * - positional: WHERE age > ? AND status = ?
+     * - named:      WHERE age > :age AND status = :status
+     * - dollar:     WHERE age > $1 AND status = $2 (PostgreSQL)
+     *
+     * @default 'positional'
+     */
+    paramStyle?: SQLParamStyle;
+    /**
+     * Named parameter prefix
+     * Only used when paramStyle is 'named'
+     *
+     * @default ':'
+     */
+    namedPrefix?: string;
+    /**
+     * Quote identifiers (field names)
+     * - true: "age" (double quotes)
+     * - false: age (no quotes)
+     *
+     * @default false
+     */
+    quoteIdentifiers?: boolean;
+    /**
+     * Identifier quote character
+     * - '"' for PostgreSQL, SQL Server
+     * - '`' for MySQL, MariaDB
+     * - '[' for SQL Server (uses ]' for closing)
+     *
+     * @default '"'
+     */
+    identifierQuote?: string;
+    /**
+     * Case sensitivity for string operations
+     * - true: Use LOWER() for case-insensitive comparisons
+     * - false: Use operators as-is
+     *
+     * @default false
+     */
+    caseInsensitive?: boolean;
+}
+/**
+ * SQL Filter Adapter
+ *
+ * @example Positional parameters (default)
+ * ```typescript
+ * const adapter = new SQLFilterAdapter({ paramStyle: 'positional' });
+ * const result = adapter.transform(filterState);
+ * // result.whereClause: "age > ? AND status = ?"
+ * // result.positionalParams: [18, "active"]
+ * ```
+ *
+ * @example Named parameters
+ * ```typescript
+ * const adapter = new SQLFilterAdapter({ paramStyle: 'named' });
+ * const result = adapter.transform(filterState);
+ * // result.namedSql: "age > :age AND status = :status"
+ * // result.namedParams: { age: 18, status: "active" }
+ * ```
+ *
+ * @example Dollar parameters (PostgreSQL)
+ * ```typescript
+ * const adapter = new SQLFilterAdapter({ paramStyle: 'dollar' });
+ * const result = adapter.transform(filterState);
+ * // result.whereClause: "age > $1 AND status = $2"
+ * // result.positionalParams: [18, "active"]
+ * ```
+ */
+export declare class SQLFilterAdapter implements FilterAdapter<SQLFilterExport> {
+    readonly name = "sql";
+    private options;
+    private positionalParams;
+    private namedParams;
+    private paramCounter;
+    constructor(options?: SQLAdapterOptions);
+    /**
+     * Transform field-based filter state to SQL format
+     */
+    transform(state: FieldFilterState): SQLFilterExport;
+    /**
+     * Process a filter group
+     */
+    private processGroup;
+    /**
+     * Build SQL clause for a single condition
+     */
+    private buildConditionClause;
+    /**
+     * Map standard operator to SQL operator
+     */
+    private mapOperatorToSQL;
+    /**
+     * Add parameter and return placeholder
+     */
+    private addParam;
+    /**
+     * Quote field identifier
+     */
+    private quoteField;
+    /**
+     * Build named SQL version
+     */
+    private buildNamedSQL;
+}
+//# sourceMappingURL=sql-adapter.d.ts.map

package/dist/src/features/filtering/adapters/sql-adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sql-adapter.d.ts","sourceRoot":"","sources":["../../../../../../../packages/core/src/features/filtering/adapters/sql-adapter.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACxE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAC/C,OAAO,KAAK,EAAE,gBAAgB,EAAkE,MAAM,UAAU,CAAC;AAEjH;;GAEG;AACH,MAAM,MAAM,aAAa,GAAG,YAAY,GAAG,OAAO,GAAG,QAAQ,CAAC;AAE9D;;GAEG;AACH,MAAM,WAAW,iBAAkB,SAAQ,aAAa;IACtD;;;;;;;OAOG;IACH,UAAU,CAAC,EAAE,aAAa,CAAC;IAE3B;;;;;OAKG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB;;;;;;OAMG;IACH,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAE3B;;;;;;;OAOG;IACH,eAAe,CAAC,EAAE,MAAM,CAAC;IAEzB;;;;;;OAMG;IACH,eAAe,CAAC,EAAE,OAAO,CAAC;CAC3B;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,qBAAa,gBAAiB,YAAW,aAAa,CAAC,eAAe,CAAC;IACrE,QAAQ,CAAC,IAAI,SAAS;IAEtB,OAAO,CAAC,OAAO,CAA8B;IAC7C,OAAO,CAAC,gBAAgB,CAAa;IACrC,OAAO,CAAC,WAAW,CAA2B;IAC9C,OAAO,CAAC,YAAY,CAAK;gBAEb,OAAO,GAAE,iBAAsB;IAa3C;;OAEG;IACH,SAAS,CAAC,KAAK,EAAE,gBAAgB,GAAG,eAAe;IA4BnD;;OAEG;IACH,OAAO,CAAC,YAAY;IA2BpB;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAqD5B;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAuBxB;;OAEG;IACH,OAAO,CAAC,QAAQ;IAqChB;;OAEG;IACH,OAAO,CAAC,UAAU;IAWlB;;OAEG;IACH,OAAO,CAAC,aAAa;CAiBtB"}