@aiao/rxdb-query-builder 0.0.10

package/dist/models/config.interface.d.ts

@@ -0,0 +1,76 @@
+import { RuleGroup } from '../../packages/rxdb/src/index.ts';
+import { OperatorDefinition } from './operator.interface.js';
+import { QueryBuilderRuleGroup, SchemaInfo } from './query-builder-state.js';
+/**
+ * 查询构建器配置
+ */
+export interface QueryBuilderConfig<T = Record<string, unknown>> {
+    /**
+     * Schema 信息
+     */
+    schema?: SchemaInfo;
+    /**
+     * 初始查询
+     */
+    initialQuery?: QueryBuilderRuleGroup<T>;
+    /**
+     * 最大嵌套层级（默认 5）
+     */
+    maxNestingLevel?: number;
+    /**
+     * 是否启用历史记录（撤销/重做）
+     */
+    enableHistory?: boolean;
+    /**
+     * 历史记录最大长度（默认 50）
+     */
+    maxHistoryLength?: number;
+    /**
+     * 自定义操作符
+     */
+    customOperators?: OperatorDefinition[];
+    /**
+     * 是否只读模式
+     */
+    readonly?: boolean;
+}
+/**
+ * 查询构建器事件
+ */
+export interface QueryBuilderEvents<T = Record<string, unknown>> {
+    /**
+     * 查询变更事件
+     */
+    queryChange: {
+        query: QueryBuilderRuleGroup<T>;
+        rxdbQuery: RuleGroup<T>;
+    };
+    /**
+     * 验证错误事件
+     */
+    validationError: {
+        id: string;
+        message: string;
+    };
+    /**
+     * 规则添加事件
+     */
+    ruleAdd: {
+        groupId: string;
+        ruleId: string;
+    };
+    /**
+     * 规则删除事件
+     */
+    ruleRemove: {
+        id: string;
+    };
+    /**
+     * 组合符切换事件
+     */
+    combinatorToggle: {
+        groupId: string;
+        combinator: 'and' | 'or';
+    };
+}
+//# sourceMappingURL=config.interface.d.ts.map

package/dist/models/config.interface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.interface.d.ts","sourceRoot":"","sources":["../../src/models/config.interface.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAC5C,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAClE,OAAO,KAAK,EAAE,qBAAqB,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AAClF;;GAEG;AACH,MAAM,WAAW,kBAAkB,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAC7D;;OAEG;IACH,MAAM,CAAC,EAAE,UAAU,CAAC;IAEpB;;OAEG;IACH,YAAY,CAAC,EAAE,qBAAqB,CAAC,CAAC,CAAC,CAAC;IAExC;;OAEG;IACH,eAAe,CAAC,EAAE,MAAM,CAAC;IAEzB;;OAEG;IACH,aAAa,CAAC,EAAE,OAAO,CAAC;IAExB;;OAEG;IACH,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAE1B;;OAEG;IACH,eAAe,CAAC,EAAE,kBAAkB,EAAE,CAAC;IAEvC;;OAEG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAC7D;;OAEG;IACH,WAAW,EAAE;QACX,KAAK,EAAE,qBAAqB,CAAC,CAAC,CAAC,CAAC;QAChC,SAAS,EAAE,SAAS,CAAC,CAAC,CAAC,CAAC;KACzB,CAAC;IAEF;;OAEG;IACH,eAAe,EAAE;QACf,EAAE,EAAE,MAAM,CAAC;QACX,OAAO,EAAE,MAAM,CAAC;KACjB,CAAC;IAEF;;OAEG;IACH,OAAO,EAAE;QACP,OAAO,EAAE,MAAM,CAAC;QAChB,MAAM,EAAE,MAAM,CAAC;KAChB,CAAC;IAEF;;OAEG;IACH,UAAU,EAAE;QACV,EAAE,EAAE,MAAM,CAAC;KACZ,CAAC;IAEF;;OAEG;IACH,gBAAgB,EAAE;QAChB,OAAO,EAAE,MAAM,CAAC;QAChB,UAAU,EAAE,KAAK,GAAG,IAAI,CAAC;KAC1B,CAAC;CACH"}

package/dist/models/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * @fileoverview Models 导出
+ */
+export * from './config.interface.js';
+export * from './operator.interface.js';
+export * from './query-builder-state.js';
+export * from './validation.interface.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/models/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/models/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,cAAc,uBAAuB,CAAC;AACtC,cAAc,yBAAyB,CAAC;AACxC,cAAc,0BAA0B,CAAC;AACzC,cAAc,2BAA2B,CAAC"}

package/dist/models/operator.interface.d.ts

@@ -0,0 +1,42 @@
+import { OperatorName } from '../../packages/rxdb/src/index.ts';
+import { PropertyType } from './query-builder-state.js';
+/**
+ * 操作符定义
+ * 包含操作符的元数据和约束
+ */
+export interface OperatorDefinition {
+    /**
+     * 操作符键值（使用 RxDB 的 OperatorName）
+     */
+    key: OperatorName;
+    /**
+     * 显示标签（支持国际化）
+     */
+    label: string;
+    /**
+     * 值类型
+     * - single: 单个值 (例如 "=")
+     * - array: 值数组 (例如 "in")
+     * - range: 范围值 [min, max] (例如 "between")
+     * - none: 无需值 (例如 "null")
+     * - subquery: 子查询条件 (例如 "exists" - 可选的嵌套规则组)
+     */
+    valueType: 'single' | 'array' | 'range' | 'none' | 'subquery';
+    /**
+     * 适用的字段类型
+     */
+    applicableTypes: PropertyType[];
+}
+/**
+ * 操作符类型（直接复用 RxDB 定义）
+ */
+export type QueryBuilderOperator = OperatorName;
+/**
+ * 默认操作符定义列表
+ */
+export declare const DEFAULT_OPERATORS: OperatorDefinition[];
+/**
+ * 根据字段类型获取适用的操作符
+ */
+export declare function getOperatorsForType(type: PropertyType, operators?: OperatorDefinition[]): OperatorDefinition[];
+//# sourceMappingURL=operator.interface.d.ts.map

package/dist/models/operator.interface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"operator.interface.d.ts","sourceRoot":"","sources":["../../src/models/operator.interface.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC/C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAE7D;;;GAGG;AACH,MAAM,WAAW,kBAAkB;IACjC;;OAEG;IACH,GAAG,EAAE,YAAY,CAAC;IAElB;;OAEG;IACH,KAAK,EAAE,MAAM,CAAC;IAEd;;;;;;;OAOG;IACH,SAAS,EAAE,QAAQ,GAAG,OAAO,GAAG,OAAO,GAAG,MAAM,GAAG,UAAU,CAAC;IAE9D;;OAEG;IACH,eAAe,EAAE,YAAY,EAAE,CAAC;CACjC;AAED;;GAEG;AACH,MAAM,MAAM,oBAAoB,GAAG,YAAY,CAAC;AAEhD;;GAEG;AACH,eAAO,MAAM,iBAAiB,EAAE,kBAAkB,EAsIjD,CAAC;AAEF;;GAEG;AACH,wBAAgB,mBAAmB,CACjC,IAAI,EAAE,YAAY,EAClB,SAAS,GAAE,kBAAkB,EAAsB,GAClD,kBAAkB,EAAE,CAEtB"}

package/dist/models/query-builder-state.d.ts

@@ -0,0 +1,155 @@
+import { OperatorName, Rule, RuleGroup } from '../../packages/rxdb/src/index.ts';
+/**
+ * UI 规则（宽松类型，用于查询构建器组件内部）
+ *
+ * @description
+ * 由于 Rule<T> 是联合类型，在 UI 组件中难以处理部分更新。
+ * 此类型提供宽松的字段类型，方便 UI 组件操作。
+ */
+export interface UIRule {
+    id: string;
+    field: string;
+    operator: string;
+    value?: unknown;
+    /**
+     * EXISTS/NOT EXISTS 操作符的子查询条件
+     */
+    where?: QueryBuilderRuleGroup<Record<string, unknown>>;
+}
+/**
+ * 查询规则（复用 RxDB Rule 类型 + UI 元数据）
+ *
+ * @template T - 实体类型
+ * @template K - 字段键类型（自动推断）
+ *
+ * @example
+ * ```typescript
+ * interface User {
+ *   name: string;
+ *   age: number;
+ *   active: boolean;
+ * }
+ *
+ * const rule: QueryBuilderRule<User> = {
+ *   id: 'rule-1',
+ *   field: 'name',      // ✅ 类型安全：只能是 'name' | 'age' | 'active'
+ *   operator: 'contains',
+ *   value: 'John'       // ✅ 类型推断为 string
+ * };
+ * ```
+ */
+export type QueryBuilderRule<T = Record<string, unknown>> = Rule<T> & {
+    /**
+     * 规则唯一标识符
+     * 用于 React key, Angular trackBy, Vue :key
+     */
+    id: string;
+};
+/**
+ * 规则组（复用 RxDB RuleGroup 类型 + UI 元数据）
+ *
+ * @template T - 实体类型
+ */
+export interface QueryBuilderRuleGroup<T = Record<string, unknown>> {
+    /**
+     * 规则组唯一标识符
+     */
+    id: string;
+    /**
+     * 逻辑组合符
+     */
+    combinator: 'and' | 'or';
+    /**
+     * 子规则列表（支持嵌套）
+     */
+    rules: Array<QueryBuilderRule<T> | QueryBuilderRuleGroup<T>>;
+}
+/**
+ * 查询构建器状态（简化版本，只包含必要字段）
+ */
+export interface QueryBuilderState<T = Record<string, unknown>> {
+    /**
+     * 根规则组
+     */
+    rootGroup: QueryBuilderRuleGroup<T>;
+}
+/**
+ * Schema 信息
+ */
+export interface SchemaInfo {
+    /**
+     * 实体名称
+     */
+    entityName: string;
+    /**
+     * 字段列表
+     */
+    fields: FieldMetadata[];
+}
+/**
+ * 字段元数据
+ */
+export interface FieldMetadata {
+    /**
+     * 字段名称
+     */
+    name: string;
+    /**
+     * 显示名称
+     */
+    displayName: string;
+    /**
+     * 字段类型
+     */
+    type: PropertyType;
+    /**
+     * 字段描述
+     */
+    description?: string;
+    /**
+     * 是否必填
+     */
+    required?: boolean;
+    /**
+     * 是否可空
+     */
+    nullable?: boolean;
+    /**
+     * 枚举值（如果适用）
+     */
+    enum?: unknown[];
+    /**
+     * 正则验证（字符串类型）
+     */
+    pattern?: string;
+    /**
+     * 是否是关系字段
+     */
+    isRelation?: boolean;
+    /**
+     * 关系目标实体名称
+     */
+    relationTarget?: string;
+    /**
+     * 关系类型（1:1, 1:m, m:1, m:n）
+     */
+    relationKind?: '1:1' | '1:m' | 'm:1' | 'm:n';
+    /**
+     * 关系目标实体的字段列表（用于 EXISTS 子查询）
+     */
+    relationFields?: FieldMetadata[];
+}
+/**
+ * 属性类型
+ */
+export type PropertyType = 'string' | 'number' | 'boolean' | 'date' | 'array' | 'object' | 'relation';
+/**
+ * 类型守卫：判断是否为规则组
+ */
+export declare function isRuleGroup<T>(item: QueryBuilderRule<T> | QueryBuilderRuleGroup<T>): item is QueryBuilderRuleGroup<T>;
+/**
+ * 类型守卫：判断是否为规则
+ */
+export declare function isRule<T>(item: QueryBuilderRule<T> | QueryBuilderRuleGroup<T>): item is QueryBuilderRule<T>;
+export type { OperatorName, Rule, RuleGroup };
+//# sourceMappingURL=query-builder-state.d.ts.map

package/dist/models/query-builder-state.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"query-builder-state.d.ts","sourceRoot":"","sources":["../../src/models/query-builder-state.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAE3D;;;;;;GAMG;AACH,MAAM,WAAW,MAAM;IACrB,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB;;OAEG;IACH,KAAK,CAAC,EAAE,qBAAqB,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;CACxD;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,MAAM,MAAM,gBAAgB,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC,GAAG;IACpE;;;OAGG;IACH,EAAE,EAAE,MAAM,CAAC;CACZ,CAAC;AAEF;;;;GAIG;AACH,MAAM,WAAW,qBAAqB,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAChE;;OAEG;IACH,EAAE,EAAE,MAAM,CAAC;IAEX;;OAEG;IACH,UAAU,EAAE,KAAK,GAAG,IAAI,CAAC;IAEzB;;OAEG;IACH,KAAK,EAAE,KAAK,CAAC,gBAAgB,CAAC,CAAC,CAAC,GAAG,qBAAqB,CAAC,CAAC,CAAC,CAAC,CAAC;CAC9D;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAC5D;;OAEG;IACH,SAAS,EAAE,qBAAqB,CAAC,CAAC,CAAC,CAAC;CACrC;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB;;OAEG;IACH,UAAU,EAAE,MAAM,CAAC;IAEnB;;OAEG;IACH,MAAM,EAAE,aAAa,EAAE,CAAC;CACzB;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;IAEb;;OAEG;IACH,WAAW,EAAE,MAAM,CAAC;IAEpB;;OAEG;IACH,IAAI,EAAE,YAAY,CAAC;IAEnB;;OAEG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB;;OAEG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;IAEnB;;OAEG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;IAEnB;;OAEG;IACH,IAAI,CAAC,EAAE,OAAO,EAAE,CAAC;IAEjB;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB;;OAEG;IACH,UAAU,CAAC,EAAE,OAAO,CAAC;IAErB;;OAEG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;IAExB;;OAEG;IACH,YAAY,CAAC,EAAE,KAAK,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,CAAC;IAE7C;;OAEG;IACH,cAAc,CAAC,EAAE,aAAa,EAAE,CAAC;CAClC;AAED;;GAEG;AACH,MAAM,MAAM,YAAY,GAAG,QAAQ,GAAG,QAAQ,GAAG,SAAS,GAAG,MAAM,GAAG,OAAO,GAAG,QAAQ,GAAG,UAAU,CAAC;AAEtG;;GAEG;AACH,wBAAgB,WAAW,CAAC,CAAC,EAAE,IAAI,EAAE,gBAAgB,CAAC,CAAC,CAAC,GAAG,qBAAqB,CAAC,CAAC,CAAC,GAAG,IAAI,IAAI,qBAAqB,CAAC,CAAC,CAAC,CAErH;AAED;;GAEG;AACH,wBAAgB,MAAM,CAAC,CAAC,EAAE,IAAI,EAAE,gBAAgB,CAAC,CAAC,CAAC,GAAG,qBAAqB,CAAC,CAAC,CAAC,GAAG,IAAI,IAAI,gBAAgB,CAAC,CAAC,CAAC,CAE3G;AAED,YAAY,EAAE,YAAY,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC"}

package/dist/models/validation.interface.d.ts

@@ -0,0 +1,88 @@
+import { OperatorName } from '../../packages/rxdb/src/index.ts';
+import { PropertyType } from './query-builder-state.js';
+/**
+ * 验证规则
+ */
+export interface ValidationRule {
+    /**
+     * 规则名称
+     */
+    name: string;
+    /**
+     * 适用的字段类型（可选，undefined 表示适用于所有类型）
+     */
+    appliesTo?: PropertyType[];
+    /**
+     * 错误消息
+     */
+    message: string;
+    /**
+     * 验证函数
+     * @returns true 表示通过，false 表示失败
+     */
+    validate: (context: ValidationContext) => boolean;
+}
+/**
+ * 验证上下文
+ */
+export interface ValidationContext {
+    /**
+     * 字段类型
+     */
+    fieldType: PropertyType;
+    /**
+     * 操作符
+     */
+    operator: OperatorName;
+    /**
+     * 当前值
+     */
+    value: unknown;
+    /**
+     * 是否必填
+     */
+    required?: boolean;
+    /**
+     * 枚举值
+     */
+    enum?: unknown[];
+    /**
+     * 正则验证
+     */
+    pattern?: string;
+}
+/**
+ * 验证错误项
+ */
+export interface ValidationError {
+    /**
+     * 字段名
+     */
+    field: string;
+    /**
+     * 规则名
+     */
+    rule: string;
+    /**
+     * 错误消息
+     */
+    message: string;
+}
+/**
+ * 验证结果
+ */
+export interface ValidationResult {
+    /**
+     * 是否有效
+     */
+    valid: boolean;
+    /**
+     * 错误列表
+     */
+    errors?: ValidationError[];
+}
+/**
+ * 内置验证规则
+ */
+export declare const BUILTIN_VALIDATION_RULES: ValidationRule[];
+//# sourceMappingURL=validation.interface.d.ts.map

package/dist/models/validation.interface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.interface.d.ts","sourceRoot":"","sources":["../../src/models/validation.interface.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC/C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAE7D;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;IAEb;;OAEG;IACH,SAAS,CAAC,EAAE,YAAY,EAAE,CAAC;IAE3B;;OAEG;IACH,OAAO,EAAE,MAAM,CAAC;IAEhB;;;OAGG;IACH,QAAQ,EAAE,CAAC,OAAO,EAAE,iBAAiB,KAAK,OAAO,CAAC;CACnD;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC;;OAEG;IACH,SAAS,EAAE,YAAY,CAAC;IAExB;;OAEG;IACH,QAAQ,EAAE,YAAY,CAAC;IAEvB;;OAEG;IACH,KAAK,EAAE,OAAO,CAAC;IAEf;;OAEG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;IAEnB;;OAEG;IACH,IAAI,CAAC,EAAE,OAAO,EAAE,CAAC;IAEjB;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B;;OAEG;IACH,KAAK,EAAE,MAAM,CAAC;IAEd;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;IAEb;;OAEG;IACH,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B;;OAEG;IACH,KAAK,EAAE,OAAO,CAAC;IAEf;;OAEG;IACH,MAAM,CAAC,EAAE,eAAe,EAAE,CAAC;CAC5B;AAED;;GAEG;AACH,eAAO,MAAM,wBAAwB,EAAE,cAAc,EAoEpD,CAAC"}

package/dist/services/index.d.ts

@@ -0,0 +1,9 @@
+/**
+ * @fileoverview Services 导出
+ */
+export * from './operator-registry.service.js';
+export * from './query-builder.service.js';
+export * from './query-converter.service.js';
+export * from './schema-parser.service.js';
+export * from './validation.service.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/services/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/services/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,cAAc,gCAAgC,CAAC;AAC/C,cAAc,4BAA4B,CAAC;AAC3C,cAAc,8BAA8B,CAAC;AAC7C,cAAc,4BAA4B,CAAC;AAC3C,cAAc,yBAAyB,CAAC"}

package/dist/services/operator-registry.service.d.ts

@@ -0,0 +1,132 @@
+import { OperatorName } from '../../packages/rxdb/src/index.ts';
+import { OperatorDefinition } from '../models/operator.interface.js';
+import { FieldMetadata, PropertyType } from '../models/query-builder-state.js';
+/**
+ * 操作符注册表选项
+ */
+export interface OperatorRegistryOptions {
+    /**
+     * 初始操作符集合
+     * @default DEFAULT_OPERATORS
+     */
+    operators?: OperatorDefinition[];
+    /**
+     * 是否使用默认操作符作为基础
+     * @default true
+     */
+    useDefaultOperators?: boolean;
+}
+/**
+ * 操作符注册表服务
+ * 管理可用操作符及其元数据
+ */
+export declare class OperatorRegistry {
+    private readonly operators;
+    /**
+     * 获取操作符数量
+     */
+    get size(): number;
+    constructor(options?: OperatorRegistryOptions);
+    /**
+     * 注册新操作符
+     *
+     * @param operator - 操作符定义
+     *
+     * @example
+     * ```typescript
+     * registry.register({
+     *   key: 'contains',
+     *   label: '包含',
+     *   applicableTypes: ['string'],
+     *   valueType: 'single'
+     * });
+     * ```
+     */
+    register(operator: OperatorDefinition): void;
+    /**
+     * 批量注册操作符
+     *
+     * @param operators - 操作符定义数组
+     */
+    registerMany(operators: OperatorDefinition[]): void;
+    /**
+     * 移除操作符
+     *
+     * @param key - 操作符键值
+     * @returns 是否成功移除
+     */
+    unregister(key: OperatorName): boolean;
+    /**
+     * 获取操作符定义
+     *
+     * @param key - 操作符键值
+     * @returns 操作符定义或 undefined
+     */
+    get(key: OperatorName): OperatorDefinition | undefined;
+    /**
+     * 获取所有操作符
+     *
+     * @returns 所有操作符定义数组
+     */
+    getAll(): OperatorDefinition[];
+    /**
+     * 根据字段类型获取适用的操作符
+     *
+     * @param fieldType - 字段类型
+     * @returns 适用的操作符数组
+     *
+     * @example
+     * ```typescript
+     * const stringOperators = registry.getForType('string');
+     * // [{ key: '=', ... }, { key: 'contains', ... }, ...]
+     * ```
+     */
+    getForType(fieldType: PropertyType): OperatorDefinition[];
+    /**
+     * 根据字段元数据获取适用的操作符
+     *
+     * @param field - 字段元数据
+     * @returns 适用的操作符数组
+     */
+    getForField(field: FieldMetadata): OperatorDefinition[];
+    /**
+     * 检查操作符是否支持指定类型
+     *
+     * @param operatorKey - 操作符键值
+     * @param fieldType - 字段类型
+     * @returns 是否支持
+     */
+    isOperatorSupportedForType(operatorKey: OperatorName, fieldType: PropertyType): boolean;
+    /**
+     * 检查操作符是否支持指定字段
+     *
+     * @param operatorKey - 操作符键值
+     * @param field - 字段元数据
+     * @returns 是否支持
+     */
+    isOperatorSupportedForField(operatorKey: OperatorName, field: FieldMetadata): boolean;
+    /**
+     * 获取操作符的值类型
+     *
+     * @param operatorKey - 操作符键值
+     * @returns 值类型
+     */
+    getValueType(operatorKey: OperatorName): OperatorDefinition['valueType'] | undefined;
+    /**
+     * 清空所有操作符
+     */
+    clear(): void;
+    /**
+     * 重置为默认操作符
+     */
+    reset(): void;
+}
+/**
+ * 创建 OperatorRegistry 实例的工厂函数
+ */
+export declare function createOperatorRegistry(options?: OperatorRegistryOptions): OperatorRegistry;
+/**
+ * 获取默认操作符注册表
+ */
+export declare function getDefaultOperatorRegistry(): OperatorRegistry;
+//# sourceMappingURL=operator-registry.service.d.ts.map

package/dist/services/operator-registry.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"operator-registry.service.d.ts","sourceRoot":"","sources":["../../src/services/operator-registry.service.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC/C,OAAO,EAAqB,KAAK,kBAAkB,EAAE,MAAM,iCAAiC,CAAC;AAC7F,OAAO,KAAK,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,kCAAkC,CAAC;AAEpF;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC;;;OAGG;IACH,SAAS,CAAC,EAAE,kBAAkB,EAAE,CAAC;IAEjC;;;OAGG;IACH,mBAAmB,CAAC,EAAE,OAAO,CAAC;CAC/B;AAED;;;GAGG;AACH,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAwC;IAElE;;OAEG;IACH,IAAI,IAAI,IAAI,MAAM,CAEjB;gBAEW,OAAO,GAAE,uBAA4B;IAkBjD;;;;;;;;;;;;;;OAcG;IACH,QAAQ,CAAC,QAAQ,EAAE,kBAAkB,GAAG,IAAI;IAI5C;;;;OAIG;IACH,YAAY,CAAC,SAAS,EAAE,kBAAkB,EAAE,GAAG,IAAI;IAMnD;;;;;OAKG;IACH,UAAU,CAAC,GAAG,EAAE,YAAY,GAAG,OAAO;IAItC;;;;;OAKG;IACH,GAAG,CAAC,GAAG,EAAE,YAAY,GAAG,kBAAkB,GAAG,SAAS;IAItD;;;;OAIG;IACH,MAAM,IAAI,kBAAkB,EAAE;IAI9B;;;;;;;;;;;OAWG;IACH,UAAU,CAAC,SAAS,EAAE,YAAY,GAAG,kBAAkB,EAAE;IAIzD;;;;;OAKG;IACH,WAAW,CAAC,KAAK,EAAE,aAAa,GAAG,kBAAkB,EAAE;IAyBvD;;;;;;OAMG;IACH,0BAA0B,CAAC,WAAW,EAAE,YAAY,EAAE,SAAS,EAAE,YAAY,GAAG,OAAO;IAKvF;;;;;;OAMG;IACH,2BAA2B,CAAC,WAAW,EAAE,YAAY,EAAE,KAAK,EAAE,aAAa,GAAG,OAAO;IAarF;;;;;OAKG;IACH,YAAY,CAAC,WAAW,EAAE,YAAY,GAAG,kBAAkB,CAAC,WAAW,CAAC,GAAG,SAAS;IAKpF;;OAEG;IACH,KAAK,IAAI,IAAI;IAIb;;OAEG;IACH,KAAK,IAAI,IAAI;CAMd;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,OAAO,CAAC,EAAE,uBAAuB,GAAG,gBAAgB,CAE1F;AAOD;;GAEG;AACH,wBAAgB,0BAA0B,IAAI,gBAAgB,CAK7D"}

package/dist/services/query-builder.service.d.ts

@@ -0,0 +1,147 @@
+import { RuleGroup } from '../../packages/rxdb/src/index.ts';
+import { Observable } from 'rxjs';
+import { QueryBuilderConfig } from '../models/config.interface.js';
+import { FieldMetadata, QueryBuilderRule, QueryBuilderRuleGroup, QueryBuilderState } from '../models/query-builder-state.js';
+import { ValidationResult } from '../models/validation.interface.js';
+import { OperatorRegistry } from './operator-registry.service.js';
+import { QueryConverter } from './query-converter.service.js';
+import { ValidationService } from './validation.service.js';
+/**
+ * QueryBuilderService 选项
+ */
+export interface QueryBuilderServiceOptions<T = Record<string, unknown>> {
+    /**
+     * 初始查询状态
+     */
+    initialState?: QueryBuilderState<T>;
+    /**
+     * 初始 RxDB Query
+     */
+    initialQuery?: RuleGroup<T>;
+    /**
+     * 字段元数据
+     */
+    fields?: FieldMetadata[];
+    /**
+     * 配置选项
+     */
+    config?: QueryBuilderConfig<T>;
+    /**
+     * 自定义操作符注册表
+     */
+    operatorRegistry?: OperatorRegistry;
+    /**
+     * 自定义校验服务
+     */
+    validationService?: ValidationService;
+    /**
+     * 自定义转换器
+     */
+    queryConverter?: QueryConverter<T>;
+}
+/**
+ * QueryBuilder 核心服务
+ * 基于 RxJS 的响应式状态管理
+ */
+export declare class QueryBuilderService<T = Record<string, unknown>> {
+    private readonly stateSubject;
+    private readonly fieldsMap;
+    private readonly config;
+    private readonly operatorRegistry;
+    private readonly validationService;
+    private readonly queryConverter;
+    /**
+     * 状态变更的 Observable 流
+     */
+    readonly state$: Observable<QueryBuilderState<T>>;
+    /**
+     * 根规则组的 Observable
+     */
+    readonly rootGroup$: Observable<QueryBuilderRuleGroup<T>>;
+    /**
+     * 校验结果的 Observable
+     */
+    readonly validation$: Observable<ValidationResult>;
+    /**
+     * RxDB Query 格式的 Observable
+     */
+    readonly query$: Observable<RuleGroup<T>>;
+    constructor(options?: QueryBuilderServiceOptions<T>);
+    /**
+     * 获取当前状态快照
+     */
+    getState(): QueryBuilderState<T>;
+    /**
+     * 获取当前配置
+     */
+    getConfig(): QueryBuilderConfig<T>;
+    /**
+     * 获取最大嵌套层级
+     */
+    getMaxNestingLevel(): number;
+    /**
+     * 获取字段列表
+     */
+    getFields(): FieldMetadata[];
+    /**
+     * 设置字段列表
+     */
+    setFields(fields: FieldMetadata[]): void;
+    /**
+     * 获取操作符注册表
+     */
+    getOperatorRegistry(): OperatorRegistry;
+    /**
+     * 添加规则
+     */
+    addRule(parentGroupId?: string | null, rule?: Partial<Omit<QueryBuilderRule<T>, 'id'>>): string;
+    /**
+     * 添加规则组
+     */
+    addGroup(parentGroupId?: string | null, combinator?: 'and' | 'or'): string;
+    /**
+     * 更新规则
+     */
+    updateRule(ruleId: string, updates: Partial<Omit<QueryBuilderRule<T>, 'id'>>): void;
+    /**
+     * 更新组的组合器
+     */
+    updateGroupCombinator(groupId: string, combinator: 'and' | 'or'): void;
+    /**
+     * 删除规则或组
+     */
+    remove(itemId: string): void;
+    /**
+     * 清空所有规则
+     */
+    clear(): void;
+    /**
+     * 销毁服务
+     */
+    destroy(): void;
+    /**
+     * 获取 RxDB Query 格式
+     */
+    toRxDBQuery(): RuleGroup<T>;
+    /**
+     * 从 RxDB Query 加载
+     */
+    fromRxDBQuery(query: RuleGroup<T>): void;
+    /**
+     * 执行校验并返回结果
+     */
+    validate(): ValidationResult;
+    /**
+     * 检查当前状态是否有效
+     */
+    isValid(): boolean;
+    private addItemToGroup;
+    private updateItemInGroup;
+    private removeItemFromGroup;
+    private getGroupDepth;
+}
+/**
+ * 创建 QueryBuilderService 实例的工厂函数
+ */
+export declare function createQueryBuilderService<T = Record<string, unknown>>(options?: QueryBuilderServiceOptions<T>): QueryBuilderService<T>;
+//# sourceMappingURL=query-builder.service.d.ts.map