@aiao/rxdb-model 0.0.17

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

@@ -0,0 +1,72 @@
+import { RuleGroup } from '../../../packages/rxdb/src/index.ts';
+import { QueryBuilderState } from '../models/query-builder-state.js';
+/**
+ * 转换选项
+ */
+export interface QueryConverterOptions {
+    /**
+     * ID 生成器
+     * @default generateId()
+     */
+    idGenerator?: () => string;
+}
+/**
+ * Query 转换服务
+ * 负责 QueryBuilder 状态与 RxDB Query 之间的双向转换
+ */
+export declare class QueryConverter<T = Record<string, unknown>> {
+    private readonly idGenerator;
+    /** 不需要 value 字段的操作符 */
+    private readonly noValueOperators;
+    constructor(options?: QueryConverterOptions);
+    /**
+     * 将 QueryBuilder 状态转换为 RxDB Query
+     *
+     * @param state - QueryBuilder 状态
+     * @returns RxDB RuleGroup 查询对象
+     *
+     * @example
+     * ```typescript
+     * const converter = new QueryConverter<User>();
+     * const query = converter.toRxDBQuery(queryBuilderState);
+     * // { combinator: 'and', rules: [...] }
+     * ```
+     */
+    toRxDBQuery(state: QueryBuilderState<T>): RuleGroup<T>;
+    /**
+     * 将 RxDB Query 转换为 QueryBuilder 状态
+     *
+     * @param query - RxDB RuleGroup 查询对象
+     * @returns QueryBuilder 状态
+     *
+     * @example
+     * ```typescript
+     * const converter = new QueryConverter<User>();
+     * const state = converter.fromRxDBQuery(rxdbQuery);
+     * ```
+     */
+    fromRxDBQuery(query: RuleGroup<T>): QueryBuilderState<T>;
+    /**
+     * 转换单个规则组到 RxDB 格式
+     */
+    private convertGroupToRxDB;
+    /**
+     * 转换单条规则到 RxDB 格式
+     * 移除 QueryBuilder 特有的 id 字段，以及无值操作符的 value 字段
+     */
+    private convertRuleToRxDB;
+    /**
+     * 从 RxDB 格式转换规则组
+     */
+    private convertGroupFromRxDB;
+    /**
+     * 从 RxDB 格式转换单条规则
+     * 添加 QueryBuilder 需要的 id 字段
+     */
+    private convertRuleFromRxDB;
+}
+/**
+ * 创建 QueryConverter 实例的工厂函数
+ */
+export declare function createQueryConverter<T = Record<string, unknown>>(options?: QueryConverterOptions): QueryConverter<T>;
+//# sourceMappingURL=query-converter.service.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"query-converter.service.d.ts","sourceRoot":"","sources":["../../../src/query-builder/services/query-converter.service.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAQ,SAAS,EAAE,MAAM,YAAY,CAAC;AAClD,OAAO,KAAK,EAA2C,iBAAiB,EAAE,MAAM,kCAAkC,CAAC;AAInH;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC;;;OAGG;IACH,WAAW,CAAC,EAAE,MAAM,MAAM,CAAC;CAC5B;AAED;;;GAGG;AACH,qBAAa,cAAc,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IACrD,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAe;IAE3C,uBAAuB;IACvB,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAuD;gBAE5E,OAAO,GAAE,qBAA0B;IAI/C;;;;;;;;;;;;OAYG;IACH,WAAW,CAAC,KAAK,EAAE,iBAAiB,CAAC,CAAC,CAAC,GAAG,SAAS,CAAC,CAAC,CAAC;IAItD;;;;;;;;;;;OAWG;IACH,aAAa,CAAC,KAAK,EAAE,SAAS,CAAC,CAAC,CAAC,GAAG,iBAAiB,CAAC,CAAC,CAAC;IASxD;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAiB1B;;;OAGG;IACH,OAAO,CAAC,iBAAiB;IASzB;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAkB5B;;;OAGG;IACH,OAAO,CAAC,mBAAmB;CAM5B;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,CAAC,EAAE,qBAAqB,GAAG,cAAc,CAAC,CAAC,CAAC,CAEpH"}

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

@@ -0,0 +1,84 @@
+import { EntityMetadata } from '../../../packages/rxdb/src/index.ts';
+import { FieldMetadata } from '../models/query-builder-state.js';
+/**
+ * 解析器配置选项
+ */
+export interface SchemaParserOptions {
+    /**
+     * 是否包含外键字段
+     * @default false
+     */
+    includeForeignKeys?: boolean;
+    /**
+     * 是否包含计算属性
+     * @default false
+     */
+    includeComputedProperties?: boolean;
+    /**
+     * 是否包含关系字段（用于 EXISTS 操作符）
+     * @default false
+     */
+    includeRelations?: boolean;
+    /**
+     * 实体元数据映射（用于解析关系字段的目标实体字段）
+     * 键为实体名称，值为实体元数据
+     */
+    entityMetadataMap?: Map<string, EntityMetadata>;
+    /**
+     * 自定义字段过滤器
+     */
+    fieldFilter?: (field: FieldMetadata) => boolean;
+    /**
+     * 自定义显示名称生成器
+     */
+    displayNameGenerator?: (fieldName: string, metadata?: {
+        displayName?: string;
+    }) => string;
+}
+/**
+ * Schema 解析服务
+ * 负责将 RxDB EntityMetadata 转换为 QueryBuilder 可用的字段元数据
+ */
+export declare class SchemaParser {
+    private readonly options;
+    private readonly relationFieldsCache;
+    constructor(options?: SchemaParserOptions);
+    /**
+     * 从 EntityMetadata 解析字段元数据
+     *
+     * @param metadata - RxDB 实体元数据
+     * @returns 字段元数据数组
+     *
+     * @example
+     * ```typescript
+     * const parser = new SchemaParser();
+     * const fields = parser.parse(userMetadata);
+     * // [{ name: 'id', displayName: 'ID', type: 'string' }, ...]
+     * ```
+     */
+    parse(metadata: EntityMetadata): FieldMetadata[];
+    /**
+     * 从多个 EntityMetadata 批量解析
+     *
+     * @param metadataMap - 实体名称到元数据的映射
+     * @returns 实体名称到字段数组的映射
+     */
+    parseMany(metadataMap: Map<string, EntityMetadata>): Map<string, FieldMetadata[]>;
+    /**
+     * 解析单个属性
+     */
+    private parseProperty;
+    /**
+     * 将 RxDB PropertyType 映射到 QueryBuilder 类型
+     */
+    private mapPropertyType;
+    /**
+     * 解析关系字段
+     */
+    private parseRelation;
+}
+/**
+ * 创建 SchemaParser 实例的工厂函数
+ */
+export declare function createSchemaParser(options?: SchemaParserOptions): SchemaParser;
+//# sourceMappingURL=schema-parser.service.d.ts.map

package/dist/query-builder/services/schema-parser.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema-parser.service.d.ts","sourceRoot":"","sources":["../../../src/query-builder/services/schema-parser.service.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,cAAc,EAA0C,MAAM,YAAY,CAAC;AACzF,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,kCAAkC,CAAC;AAqBtE;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC;;;OAGG;IACH,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAE7B;;;OAGG;IACH,yBAAyB,CAAC,EAAE,OAAO,CAAC;IAEpC;;;OAGG;IACH,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAE3B;;;OAGG;IACH,iBAAiB,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;IAEhD;;OAEG;IACH,WAAW,CAAC,EAAE,CAAC,KAAK,EAAE,aAAa,KAAK,OAAO,CAAC;IAEhD;;OAEG;IACH,oBAAoB,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE;QAAE,WAAW,CAAC,EAAE,MAAM,CAAA;KAAE,KAAK,MAAM,CAAC;CAC3F;AA4BD;;;GAGG;AACH,qBAAa,YAAY;IACvB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAEtB;IAEF,OAAO,CAAC,QAAQ,CAAC,mBAAmB,CAAsC;gBAE9D,OAAO,GAAE,mBAAwB;IAW7C;;;;;;;;;;;;OAYG;IACH,KAAK,CAAC,QAAQ,EAAE,cAAc,GAAG,aAAa,EAAE;IAwDhD;;;;;OAKG;IACH,SAAS,CAAC,WAAW,EAAE,GAAG,CAAC,MAAM,EAAE,cAAc,CAAC,GAAG,GAAG,CAAC,MAAM,EAAE,aAAa,EAAE,CAAC;IAUjF;;OAEG;IACH,OAAO,CAAC,aAAa;IA8CrB;;OAEG;IACH,OAAO,CAAC,eAAe;IAKvB;;OAEG;IACH,OAAO,CAAC,aAAa;CAsCtB;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,CAAC,EAAE,mBAAmB,GAAG,YAAY,CAE9E"}

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

@@ -0,0 +1,67 @@
+import { FieldMetadata, QueryBuilderRule, QueryBuilderRuleGroup } from '../models/query-builder-state.js';
+import { ValidationResult, ValidationRule } from '../models/validation.interface.js';
+import { OperatorRegistry } from './operator-registry.service.js';
+/**
+ * 校验服务选项
+ */
+export interface ValidationServiceOptions {
+    /**
+     * 自定义校验规则
+     */
+    customRules?: ValidationRule[];
+    /**
+     * 操作符注册表
+     */
+    operatorRegistry?: OperatorRegistry;
+    /**
+     * 是否启用内置校验规则
+     * @default true
+     */
+    useBuiltinRules?: boolean;
+}
+/**
+ * 校验服务
+ * 负责验证 QueryBuilder 规则和值
+ */
+export declare class ValidationService {
+    private readonly rules;
+    private readonly operatorRegistry;
+    constructor(options?: ValidationServiceOptions);
+    /**
+     * 校验单条规则
+     */
+    validateRule<T>(rule: QueryBuilderRule<T>, field: FieldMetadata): ValidationResult;
+    /**
+     * 校验整个规则组
+     */
+    validateGroup<T>(group: QueryBuilderRuleGroup<T>, fields: Map<string, FieldMetadata>): ValidationResult;
+    /**
+     * 注册自定义校验规则
+     */
+    registerRule(rule: ValidationRule): void;
+    /**
+     * 移除校验规则
+     */
+    unregisterRule(name: string): boolean;
+    /**
+     * 获取所有校验规则
+     */
+    getRules(): ValidationRule[];
+    /**
+     * 校验值类型
+     */
+    private validateValueType;
+    /**
+     * 验证子查询规则的基本有效性（不依赖字段元数据）
+     *
+     * @description
+     * 子查询可能引用关系实体的字段，我们无法获取其 FieldMetadata。
+     * 因此只验证规则的基本结构和值类型，不验证字段是否存在或操作符是否匹配。
+     */
+    private validateSubqueryRules;
+}
+/**
+ * 创建 ValidationService 实例的工厂函数
+ */
+export declare function createValidationService(options?: ValidationServiceOptions): ValidationService;
+//# sourceMappingURL=validation.service.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"validation.service.d.ts","sourceRoot":"","sources":["../../../src/query-builder/services/validation.service.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,KAAK,EAAE,aAAa,EAAE,gBAAgB,EAAE,qBAAqB,EAAE,MAAM,kCAAkC,CAAC;AAE/G,OAAO,KAAK,EAGV,gBAAgB,EAChB,cAAc,EACf,MAAM,mCAAmC,CAAC;AAE3C,OAAO,EAAE,gBAAgB,EAA8B,MAAM,gCAAgC,CAAC;AAU9F;;GAEG;AACH,MAAM,WAAW,wBAAwB;IACvC;;OAEG;IACH,WAAW,CAAC,EAAE,cAAc,EAAE,CAAC;IAE/B;;OAEG;IACH,gBAAgB,CAAC,EAAE,gBAAgB,CAAC;IAEpC;;;OAGG;IACH,eAAe,CAAC,EAAE,OAAO,CAAC;CAC3B;AAiBD;;;GAGG;AACH,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,QAAQ,CAAC,KAAK,CAA8B;IACpD,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAmB;gBAExC,OAAO,GAAE,wBAA6B;IAmBlD;;OAEG;IACH,YAAY,CAAC,CAAC,EAAE,IAAI,EAAE,gBAAgB,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,aAAa,GAAG,gBAAgB;IA8FlF;;OAEG;IACH,aAAa,CAAC,CAAC,EAAE,KAAK,EAAE,qBAAqB,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,aAAa,CAAC,GAAG,gBAAgB;IAiCvG;;OAEG;IACH,YAAY,CAAC,IAAI,EAAE,cAAc,GAAG,IAAI;IAIxC;;OAEG;IACH,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAIrC;;OAEG;IACH,QAAQ,IAAI,cAAc,EAAE;IAI5B;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAoDzB;;;;;;OAMG;IACH,OAAO,CAAC,qBAAqB;CAgD9B;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,OAAO,CAAC,EAAE,wBAAwB,GAAG,iBAAiB,CAE7F"}

package/dist/query-builder/utils/date.d.ts

@@ -0,0 +1,3 @@
+export declare function formatDateToYmd(date: Date | string | null | undefined): string;
+export declare function parseYmdToLocalDate(ymd: string | null | undefined): Date | null;
+//# sourceMappingURL=date.d.ts.map

package/dist/query-builder/utils/date.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"date.d.ts","sourceRoot":"","sources":["../../../src/query-builder/utils/date.ts"],"names":[],"mappings":"AAAA,wBAAgB,eAAe,CAAC,IAAI,EAAE,IAAI,GAAG,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,MAAM,CAQ9E;AAED,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,IAAI,GAAG,IAAI,CAY/E"}

package/dist/query-builder/utils/field-tree.d.ts

@@ -0,0 +1,135 @@
+import { FieldMetadata, PropertyType } from '../models/query-builder-state.js';
+/**
+ * 字段树节点（用于 CascadeSelect）
+ *
+ * @description
+ * 将扁平的 FieldMetadata[] 转换为树形结构，
+ * 以便 CascadeSelect 组件级联展示嵌套字段。
+ */
+export interface FieldTreeNode {
+    /** 当前层的字段名 */
+    label: string;
+    /** 完整路径（作为选中值） */
+    value: string;
+    /** 显示名称 */
+    displayName: string;
+    /** 字段类型 */
+    type: PropertyType;
+    /** 是否是关系字段 */
+    isRelation: boolean;
+    /** 子节点 */
+    children?: FieldTreeNode[];
+    /** 字段描述 */
+    description?: string;
+    /** 是否必填 */
+    required?: boolean;
+    /** 枚举值 */
+    enum?: unknown[];
+    /** 关系目标实体的字段列表（用于 EXISTS 子查询） */
+    relationFields?: FieldMetadata[];
+    /** 是否是存在性检查选项（用于解决重复 key 问题） */
+    isExistsOption?: boolean;
+    /** 是否是空值检查选项（keyValue 字段的整体空值查询） */
+    isNullCheckOption?: boolean;
+}
+/**
+ * 将扁平字段列表转换为树结构
+ *
+ * @description
+ * 将 `orders.items.productName` 这样的扁平路径转换为嵌套树结构：
+ * ```
+ * orders
+ * └── items
+ *     └── productName
+ * ```
+ *
+ * @param fields 扁平的字段元数据列表
+ * @returns 树形结构的字段节点
+ *
+ * @example
+ * ```ts
+ * const fields = [
+ *   { name: 'name', displayName: '姓名', type: 'string' },
+ *   { name: 'orders', displayName: '订单', type: 'relation' },
+ *   { name: 'orders.amount', displayName: '订单.金额', type: 'number' }
+ * ];
+ * const tree = buildFieldTree(fields);
+ * // tree[0] = { label: 'name', displayName: '姓名', ... }
+ * // tree[1] = { label: 'orders', displayName: '订单', children: [...] }
+ * ```
+ */
+export declare function buildFieldTree(fields: FieldMetadata[]): FieldTreeNode[];
+/**
+ * 将字段树展平为选项列表
+ *
+ * @param nodes 字段树节点
+ * @param separator 层级分隔符（默认 ' › '）
+ * @param prefix 前缀路径（递归用）
+ * @returns 展平的选项列表
+ */
+export declare function flattenFieldTree(nodes: FieldTreeNode[], separator?: string, prefix?: string): Array<{
+    value: string;
+    label: string;
+}>;
+/**
+ * 在树中查找节点
+ *
+ * @param nodes 树节点列表
+ * @param value 要查找的值（完整路径）
+ * @returns 找到的节点或 undefined
+ *
+ * @example
+ * ```ts
+ * const node = findNodeByValue(tree, 'orders.items.productName');
+ * console.log(node?.displayName); // '商品名称'
+ * ```
+ */
+export declare function findNodeByValue(nodes: FieldTreeNode[], value: string): FieldTreeNode | undefined;
+/**
+ * 创建字段名到节点的映射
+ *
+ * @description
+ * 递归遍历树结构，创建一个 Map 用于快速查找节点。
+ * 对于需要频繁查找的场景，比直接递归更高效。
+ *
+ * @param tree 字段树
+ * @returns 字段名到节点的映射
+ *
+ * @example
+ * ```ts
+ * const nodeMap = createFieldNodeMap(tree);
+ * const node = nodeMap.get('orders.amount');
+ * ```
+ */
+export declare function createFieldNodeMap(tree: FieldTreeNode[]): Map<string, FieldTreeNode>;
+/**
+ * 获取 CascadeSelect 的 optionGroupChildren 配置
+ *
+ * @description
+ * CascadeSelect 需要知道每一层的子节点属性名。
+ * 由于我们统一使用 'children'，返回重复的 ['children', 'children', ...]
+ * 深度根据最大嵌套层级决定。
+ *
+ * @param maxDepth 最大深度，默认 10
+ * @returns children 属性名数组
+ */
+export declare function getOptionGroupChildren(maxDepth?: number): string[];
+/**
+ * 获取完整的 displayName 路径
+ *
+ * @description
+ * 给定字段路径（如 `orders.createdAt`），返回完整的显示名路径（如 `订单.创建时间`）。
+ * 通过遍历树结构，将每一级的 displayName 拼接起来。
+ *
+ * @param tree 字段树
+ * @param value 字段路径（如 `orders.createdAt`）
+ * @returns 显示名路径（如 `订单.创建时间`）
+ *
+ * @example
+ * ```ts
+ * const displayPath = getDisplayNamePath(tree, 'orders.createdAt');
+ * console.log(displayPath); // '订单.创建时间'
+ * ```
+ */
+export declare function getDisplayNamePath(tree: FieldTreeNode[], value: string): string;
+//# sourceMappingURL=field-tree.d.ts.map

package/dist/query-builder/utils/field-tree.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"field-tree.d.ts","sourceRoot":"","sources":["../../../src/query-builder/utils/field-tree.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,kCAAkC,CAAC;AAKpF;;;;;;GAMG;AACH,MAAM,WAAW,aAAa;IAC5B,cAAc;IACd,KAAK,EAAE,MAAM,CAAC;IACd,kBAAkB;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,WAAW;IACX,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW;IACX,IAAI,EAAE,YAAY,CAAC;IACnB,cAAc;IACd,UAAU,EAAE,OAAO,CAAC;IACpB,UAAU;IACV,QAAQ,CAAC,EAAE,aAAa,EAAE,CAAC;IAC3B,WAAW;IACX,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW;IACX,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,UAAU;IACV,IAAI,CAAC,EAAE,OAAO,EAAE,CAAC;IACjB,iCAAiC;IACjC,cAAc,CAAC,EAAE,aAAa,EAAE,CAAC;IACjC,gCAAgC;IAChC,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,oCAAoC;IACpC,iBAAiB,CAAC,EAAE,OAAO,CAAC;CAC7B;AAED;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,aAAa,EAAE,GAAG,aAAa,EAAE,CAkHvE;AAiED;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,aAAa,EAAE,EACtB,SAAS,SAAQ,EACjB,MAAM,SAAK,GACV,KAAK,CAAC;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC,CAWzC;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,aAAa,EAAE,EAAE,KAAK,EAAE,MAAM,GAAG,aAAa,GAAG,SAAS,CAWhG;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,aAAa,EAAE,GAAG,GAAG,CAAC,MAAM,EAAE,aAAa,CAAC,CAcpF;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,sBAAsB,CAAC,QAAQ,SAAK,GAAG,MAAM,EAAE,CAE9D;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,aAAa,EAAE,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAmB/E"}

package/dist/query-builder/utils/id.d.ts

@@ -0,0 +1,9 @@
+/**
+ * @fileoverview ID 生成工具
+ */
+/**
+ * 生成唯一 ID
+ * 用于 QueryBuilder 规则和规则组的标识
+ */
+export declare function generateId(): string;
+//# sourceMappingURL=id.d.ts.map

package/dist/query-builder/utils/id.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"id.d.ts","sourceRoot":"","sources":["../../../src/query-builder/utils/id.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH;;;GAGG;AACH,wBAAgB,UAAU,IAAI,MAAM,CAEnC"}

package/dist/query-builder/utils/index.d.ts

@@ -0,0 +1,12 @@
+/**
+ * @fileoverview Utils 导出
+ */
+export * from './date.js';
+export * from './field-tree.js';
+export * from './id.js';
+export * from './metadata-field-extractor.js';
+export * from './popover-position.js';
+export * from './schema-factory.js';
+export * from './structural-equal.js';
+export * from './value-input.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/query-builder/utils/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/query-builder/utils/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,cAAc,WAAW,CAAC;AAC1B,cAAc,iBAAiB,CAAC;AAChC,cAAc,SAAS,CAAC;AACxB,cAAc,+BAA+B,CAAC;AAC9C,cAAc,uBAAuB,CAAC;AACtC,cAAc,qBAAqB,CAAC;AACpC,cAAc,uBAAuB,CAAC;AACtC,cAAc,kBAAkB,CAAC"}

package/dist/query-builder/utils/metadata-field-extractor.d.ts

@@ -0,0 +1,149 @@
+import { EntityMetadata, EntityRelationMetadata, KeyValuePropertyMetadata, PropertyType } from '../../../packages/rxdb/src/index.ts';
+import { FieldMetadata, PropertyType as QBPropertyType } from '../models/query-builder-state.js';
+/**
+ * 模型信息接口
+ */
+export interface ModelInfo {
+    name: string;
+    displayName: string;
+    entityClass: new (...args: any[]) => unknown;
+    metadata: EntityMetadata;
+}
+/**
+ * 查询示例接口
+ */
+export interface QueryExample {
+    name: string;
+    description: string;
+    modelName: string;
+    query: unknown;
+}
+/**
+ * 字段提取器配置
+ */
+export interface FieldExtractorConfig {
+    /** 关系查询深度，默认 4 */
+    relationQueryDeep?: number;
+    /** 系统字段列表，默认 ['id', 'createdAt', 'updatedAt', 'createdBy', 'updatedBy'] */
+    systemFields?: string[];
+}
+/**
+ * 将 PropertyType 映射到 FieldMetadata 的 type
+ *
+ * @param type - RxDB 属性类型
+ * @returns QueryBuilder 属性类型
+ *
+ * @example
+ * ```typescript
+ * mapPropertyType(PropertyType.string) // 'string'
+ * mapPropertyType(PropertyType.number) // 'number'
+ * mapPropertyType(PropertyType.boolean) // 'boolean'
+ * ```
+ */
+export declare function mapPropertyType(type: PropertyType): QBPropertyType;
+/**
+ * 获取关系需要忽略的键（避免循环引用）
+ *
+ * @param relation - 实体关系元数据
+ * @returns 需要忽略的键列表
+ *
+ * @remarks
+ * 对于 ONE_TO_MANY 和 MANY_TO_MANY 关系，返回 mappedProperty（如果存在）
+ * 以避免无限递归
+ *
+ * @example
+ * ```typescript
+ * // ONE_TO_MANY: User.orders -> Order.owner
+ * getRelationIgnoreKeys(ordersRelation) // ['owner']
+ * ```
+ */
+export declare function getRelationIgnoreKeys(relation: EntityRelationMetadata): string[];
+/**
+ * 从 EntityMetadata 提取字段（支持递归关系）
+ *
+ * @param metadata - 实体元数据
+ * @param allModels - 所有模型的映射表
+ * @param config - 字段提取器配置
+ * @returns 字段元数据列表
+ *
+ * @remarks
+ * 此函数会递归提取实体的所有字段，包括：
+ * 1. 系统字段（id, createdAt, updatedAt 等）
+ * 2. 实体属性字段
+ * 3. 外键字段
+ * 4. 关系字段（递归，直到达到深度限制）
+ *
+ * @example
+ * ```typescript
+ * const fields = extractFieldsFromMetadata(
+ *   userMetadata,
+ *   modelMap,
+ *   { relationQueryDeep: 3 }
+ * );
+ * // 返回: [
+ * //   { name: 'id', displayName: 'ID', type: 'string' },
+ * //   { name: 'name', displayName: '姓名', type: 'string' },
+ * //   { name: 'orders', displayName: '订单 (ONE_TO_MANY)', type: 'relation', ... },
+ * //   { name: 'orders.id', displayName: '订单.ID', type: 'string' },
+ * //   ...
+ * // ]
+ * ```
+ */
+export declare function extractFieldsFromMetadata(metadata: EntityMetadata, allModels: Map<string, ModelInfo>, config?: FieldExtractorConfig): FieldMetadata[];
+/**
+ * 提取关系目标实体的字段（用于 EXISTS 子查询）
+ *
+ * @param metadata - 实体元数据
+ * @param config - 字段提取器配置
+ * @returns 字段元数据列表（仅一层，不递归）
+ *
+ * @remarks
+ * 此函数只提取一层字段，不递归关系。用于 EXISTS/NOT EXISTS 子查询的字段列表。
+ *
+ * @example
+ * ```typescript
+ * const fields = extractRelationTargetFields(orderMetadata);
+ * // 返回: [
+ * //   { name: 'id', displayName: 'ID', type: 'string' },
+ * //   { name: 'total', displayName: '总金额', type: 'number' },
+ * //   { name: 'ownerId', displayName: '用户ID', type: 'string' },
+ * //   ...
+ * // ]
+ * ```
+ */
+export declare function extractRelationTargetFields(metadata: EntityMetadata, config?: FieldExtractorConfig): FieldMetadata[];
+/**
+ * 从 keyValue 属性的 properties 提取子字段列表
+ */
+export declare function extractKeyValueFields(properties: KeyValuePropertyMetadata[]): FieldMetadata[];
+/**
+ * 对字段进行分组和排序
+ *
+ * @param fields - 字段元数据列表
+ * @returns 排序后的字段列表
+ *
+ * @remarks
+ * 排序规则：
+ * 1. 按层级深度排序（字段名中 '.' 的数量）
+ * 2. 同一层级按字段名字母顺序排序
+ *
+ * @example
+ * ```typescript
+ * const fields = [
+ *   { name: 'orders.id', ... },
+ *   { name: 'name', ... },
+ *   { name: 'id', ... },
+ *   { name: 'orders.total', ... }
+ * ];
+ *
+ * const sorted = organizeFields(fields);
+ * // 返回: [
+ * //   { name: 'id', ... },
+ * //   { name: 'name', ... },
+ * //   { name: 'orders.id', ... },
+ * //   { name: 'orders.total', ... }
+ * // ]
+ * ```
+ */
+export declare function organizeFields(fields: FieldMetadata[]): FieldMetadata[];
+//# sourceMappingURL=metadata-field-extractor.d.ts.map

package/dist/query-builder/utils/metadata-field-extractor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"metadata-field-extractor.d.ts","sourceRoot":"","sources":["../../../src/query-builder/utils/metadata-field-extractor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,sBAAsB,EAAE,wBAAwB,EAAE,MAAM,YAAY,CAAC;AACnG,OAAO,EAAE,YAAY,EAAgB,MAAM,YAAY,CAAC;AACxD,OAAO,KAAK,EAAE,aAAa,EAAE,YAAY,IAAI,cAAc,EAAE,MAAM,kCAAkC,CAAC;AAEtG;;GAEG;AACH,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IAEpB,WAAW,EAAE,KAAK,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,OAAO,CAAC;IAC7C,QAAQ,EAAE,cAAc,CAAC;CAC1B;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,OAAO,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,kBAAkB;IAClB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,2EAA2E;IAC3E,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;CACzB;AAYD;;;;;;;;;;;;GAYG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,YAAY,GAAG,cAAc,CAyBlE;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,sBAAsB,GAAG,MAAM,EAAE,CAKhF;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,wBAAgB,yBAAyB,CACvC,QAAQ,EAAE,cAAc,EACxB,SAAS,EAAE,GAAG,CAAC,MAAM,EAAE,SAAS,CAAC,EACjC,MAAM,GAAE,oBAAyB,GAChC,aAAa,EAAE,CAEjB;AAkJD;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,2BAA2B,CACzC,QAAQ,EAAE,cAAc,EACxB,MAAM,GAAE,oBAAyB,GAChC,aAAa,EAAE,CAgDjB;AAmBD;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,UAAU,EAAE,wBAAwB,EAAE,GAAG,aAAa,EAAE,CAQ7F;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,aAAa,EAAE,GAAG,aAAa,EAAE,CAOvE"}

package/dist/query-builder/utils/popover-position.d.ts

@@ -0,0 +1,25 @@
+/**
+ * 计算弹出层相对于触发元素的位置，优先下方展示，空间不足时向上。
+ *
+ * @param triggerRect 触发按钮的 DOMRect
+ * @param gap 触发元素与弹出层之间的间距（单位 px，默认 2）
+ * @param minSpaceBelow 判断下方空间是否充足的阈值（单位 px，默认 120）
+ */
+export declare function calcPopoverPosition(triggerRect: DOMRect, gap?: number, minSpaceBelow?: number): {
+    left: number;
+    top?: number;
+    bottom?: number;
+    minWidth: number;
+};
+/**
+ * 将 calcPopoverPosition 的结果直接应用到弹出层 DOM 元素。
+ */
+export declare function applyPopoverPosition(el: HTMLElement, triggerRect: DOMRect, gap?: number, minSpaceBelow?: number): void;
+/**
+ * 在弹出层选项列表中查找匹配项的 label。
+ */
+export declare function findOptionLabel(options: ReadonlyArray<{
+    value: string;
+    label: string;
+}>, selected: string, placeholder: string): string;
+//# sourceMappingURL=popover-position.d.ts.map

package/dist/query-builder/utils/popover-position.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"popover-position.d.ts","sourceRoot":"","sources":["../../../src/query-builder/utils/popover-position.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CACjC,WAAW,EAAE,OAAO,EACpB,GAAG,SAAI,EACP,aAAa,SAAM,GAClB;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,GAAG,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,CAMnE;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,EAAE,EAAE,WAAW,EAAE,WAAW,EAAE,OAAO,EAAE,GAAG,SAAI,EAAE,aAAa,SAAM,GAAG,IAAI,CAc9G;AAED;;GAEG;AACH,wBAAgB,eAAe,CAC7B,OAAO,EAAE,aAAa,CAAC;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC,EACxD,QAAQ,EAAE,MAAM,EAChB,WAAW,EAAE,MAAM,GAClB,MAAM,CAER"}

package/dist/query-builder/utils/schema-factory.d.ts

@@ -0,0 +1,60 @@
+import { EntityMetadata } from '../../../packages/rxdb/src/index.ts';
+import { FieldMetadata } from '../models/query-builder-state.js';
+import { SchemaParserOptions } from '../services/schema-parser.service.js';
+/**
+ * 从 EntityMetadata 创建字段元数据
+ *
+ * 这是一个便捷的工厂函数，封装了 SchemaParser 的创建和解析过程
+ *
+ * @param metadata - RxDB 实体元数据
+ * @param options - 解析器选项
+ * @returns 字段元数据数组
+ *
+ * @example
+ * ```typescript
+ * // 基础用法
+ * const fields = createSchemaFromEntity(userMetadata);
+ *
+ * // 包含外键
+ * const fieldsWithFK = createSchemaFromEntity(userMetadata, {
+ *   includeForeignKeys: true
+ * });
+ *
+ * // 包含计算属性
+ * const fieldsWithComputed = createSchemaFromEntity(userMetadata, {
+ *   includeComputedProperties: true
+ * });
+ *
+ * // 自定义过滤器
+ * const onlyStringFields = createSchemaFromEntity(userMetadata, {
+ *   fieldFilter: (field) => field.type === 'string'
+ * });
+ * ```
+ */
+export declare function createSchemaFromEntity(metadata: EntityMetadata, options?: SchemaParserOptions): FieldMetadata[];
+/**
+ * 从多个 EntityMetadata 批量创建字段元数据
+ *
+ * @param metadataMap - 实体名称到元数据的映射
+ * @param options - 解析器选项
+ * @returns 实体名称到字段数组的映射
+ *
+ * @example
+ * ```typescript
+ * const entities = new Map([
+ *   ['User', userMetadata],
+ *   ['Post', postMetadata],
+ *   ['Comment', commentMetadata]
+ * ]);
+ *
+ * const schemas = createSchemaFromEntities(entities, {
+ *   includeForeignKeys: true
+ * });
+ *
+ * // 使用结果
+ * const userFields = schemas.get('User');
+ * const postFields = schemas.get('Post');
+ * ```
+ */
+export declare function createSchemaFromEntities(metadataMap: Map<string, EntityMetadata>, options?: SchemaParserOptions): Map<string, FieldMetadata[]>;
+//# sourceMappingURL=schema-factory.d.ts.map

package/dist/query-builder/utils/schema-factory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema-factory.d.ts","sourceRoot":"","sources":["../../../src/query-builder/utils/schema-factory.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AACjD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,kCAAkC,CAAC;AACtE,OAAO,EAAsB,KAAK,mBAAmB,EAAE,MAAM,sCAAsC,CAAC;AAEpG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,wBAAgB,sBAAsB,CAAC,QAAQ,EAAE,cAAc,EAAE,OAAO,CAAC,EAAE,mBAAmB,GAAG,aAAa,EAAE,CAG/G;AAED;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAgB,wBAAwB,CACtC,WAAW,EAAE,GAAG,CAAC,MAAM,EAAE,cAAc,CAAC,EACxC,OAAO,CAAC,EAAE,mBAAmB,GAC5B,GAAG,CAAC,MAAM,EAAE,aAAa,EAAE,CAAC,CAG9B"}

package/dist/query-builder/utils/structural-equal.d.ts

@@ -0,0 +1,2 @@
+export { structuralEqual } from '../../structural-equal.js';
+//# sourceMappingURL=structural-equal.d.ts.map