@aiao/rxdb-model-angular 0.0.17

package/types/aiao-rxdb-model-angular.d.ts

@@ -0,0 +1,1063 @@
+import * as packages_rxdb_dist_entity_metadata_interface from 'packages/rxdb/dist/entity/metadata.interface';
+import * as _angular_core from '@angular/core';
+import { AfterViewInit, WritableSignal, TemplateRef, InjectionToken, OnDestroy, ElementRef, Signal, OnInit, ViewContainerRef, Type, Provider } from '@angular/core';
+import { EntityMetadata, RelationKind } from '@aiao/rxdb';
+import * as _aiao_rxdb_model from '@aiao/rxdb-model';
+import { FormFieldConfig, EntityFormData, FormMode, RelatedEntityProvider, FormFieldChangeEvent, FormValidationResult, DetailTab, DetailTableTab, RelatedEntityItem, EntityTableRecord, FieldMetadata, ValidationResult, CellChangeEvent, BatchChangeItem, EntityTableConfig, UIRule, ValidationError, SchemaInfo, QueryBuilderRuleGroup, FieldTreeNode } from '@aiao/rxdb-model';
+export * from '@aiao/rxdb-model';
+import * as i1 from '@angular/cdk/drag-drop';
+import * as lucide_angular from 'lucide-angular';
+import { ChevronDownIcon } from 'lucide-angular';
+import * as VTable from '@visactor/vtable';
+import { ColumnsDefine, ListTableConstructorOptions, ListTable } from '@visactor/vtable';
+import * as _aiao_rxdb_model_angular from '@aiao/rxdb-model-angular';
+import { Highlightable } from '@angular/cdk/a11y';
+
+type EntityInstance$1 = {
+    [key: string]: unknown;
+    readonly id: string;
+    save(): Promise<void>;
+    remove(): Promise<void>;
+};
+/** CDK Dialog 传入的数据结构 */
+interface EntityDetailDialogData {
+    metadata: EntityMetadata;
+    formFields: FormFieldConfig[];
+    formData: EntityFormData;
+    formMode: FormMode;
+    relatedEntityProvider?: RelatedEntityProvider;
+    /** 预填充的外键数据（不可编辑），用于级联新增场景 */
+    fixedFormData?: EntityFormData;
+    /** 委托保存：不创建草稿实体，仅 emit formSubmitted 让调用方处理 */
+    delegateSave?: boolean;
+    /** 创建链路中的实体类型（namespace:name），用于阻断循环创建 */
+    creationChain?: string[];
+}
+declare class EntityDetailComponent {
+    #private;
+    readonly namespace: _angular_core.InputSignal<string | undefined>;
+    readonly name: _angular_core.InputSignal<string | undefined>;
+    readonly entityId: _angular_core.InputSignal<string | undefined>;
+    /** 唯一的 radio group name，避免多个 EntityDetailComponent 实例之间的 radio 冲突 */
+    readonly tabGroupName: string;
+    readonly metadata: _angular_core.InputSignal<Readonly<packages_rxdb_dist_entity_metadata_interface.EntityMetadataType> | undefined>;
+    readonly formFields: _angular_core.InputSignal<FormFieldConfig[] | undefined>;
+    readonly formData: _angular_core.InputSignal<EntityFormData | undefined>;
+    readonly formMode: _angular_core.InputSignal<FormMode | undefined>;
+    readonly relatedEntityProvider: _angular_core.InputSignal<RelatedEntityProvider | undefined>;
+    readonly formSubmitted: _angular_core.OutputEmitterRef<EntityFormData>;
+    readonly formCancelled: _angular_core.OutputEmitterRef<void>;
+    readonly fieldChanged: _angular_core.OutputEmitterRef<FormFieldChangeEvent>;
+    readonly validationErrors: _angular_core.OutputEmitterRef<FormValidationResult>;
+    /** 是否使用外部保存模式（create 模式下，保存/取消按钮在 tabs 下面，而非 form 内） */
+    readonly isCreateMode: _angular_core.Signal<boolean>;
+    /** 当前表单编辑数据（create 模式下跟踪用户输入） */
+    readonly draftFormData: _angular_core.WritableSignal<EntityFormData>;
+    /** 暴露草稿实体给模板（关系 tab 的 entity-list 需要） */
+    readonly draftEntitySignal: _angular_core.WritableSignal<EntityInstance$1 | null>;
+    /** 父实体（草稿或已保存实例），用于关系 tab 的 entity-list */
+    readonly parentEntityForRelation: _angular_core.Signal<EntityInstance$1 | null>;
+    /** 弹框标题 */
+    readonly dialogTitle: _angular_core.Signal<string>;
+    /** 创建链路：当前实体 + 祖先链路，传递给子 entity-list 以阻断循环创建 */
+    readonly creationChain: _angular_core.Signal<string[]>;
+    /** 当前活动关系 tab 的 relationName（用于子实体注册关系） */
+    readonly activeRelationName: _angular_core.Signal<string | undefined>;
+    readonly tabs: _angular_core.Signal<DetailTab[]>;
+    readonly activeTabKey: _angular_core.WritableSignal<string>;
+    readonly activeTab: _angular_core.Signal<DetailTab | undefined>;
+    get metadataValue(): EntityMetadata;
+    get formFieldsValue(): FormFieldConfig[];
+    get formDataValue(): EntityFormData;
+    get formModeValue(): FormMode;
+    get relatedEntityProviderValue(): RelatedEntityProvider | undefined;
+    constructor();
+    selectTab(key: string): void;
+    onFormDataChanged(data: EntityFormData): void;
+    onFormSubmitted(data: EntityFormData): void;
+    onFormCancelled(): void;
+    onFieldChanged(event: FormFieldChangeEvent): void;
+    onValidationErrors(result: FormValidationResult): void;
+    /** 外部保存按钮（create 模式） */
+    onSave(): void;
+    onCancel(): void;
+    buildFixedQuery(tab: DetailTableTab): {
+        combinator: 'and';
+        rules: unknown[];
+    } | undefined;
+    buildFixedFormData(tab: DetailTableTab): EntityFormData | undefined;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<EntityDetailComponent, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<EntityDetailComponent, "rxdb-entity-detail", never, { "namespace": { "alias": "namespace"; "required": false; "isSignal": true; }; "name": { "alias": "name"; "required": false; "isSignal": true; }; "entityId": { "alias": "entityId"; "required": false; "isSignal": true; }; "metadata": { "alias": "metadata"; "required": false; "isSignal": true; }; "formFields": { "alias": "formFields"; "required": false; "isSignal": true; }; "formData": { "alias": "formData"; "required": false; "isSignal": true; }; "formMode": { "alias": "formMode"; "required": false; "isSignal": true; }; "relatedEntityProvider": { "alias": "relatedEntityProvider"; "required": false; "isSignal": true; }; }, { "formSubmitted": "formSubmitted"; "formCancelled": "formCancelled"; "fieldChanged": "fieldChanged"; "validationErrors": "validationErrors"; }, never, never, true, never>;
+}
+
+declare class EntityDialogComponent implements AfterViewInit {
+    #private;
+    readonly title: _angular_core.InputSignal<string>;
+    readonly closeRequested: _angular_core.OutputEmitterRef<void>;
+    readonly isFullscreen: _angular_core.WritableSignal<boolean>;
+    readonly isInDialog: boolean;
+    constructor();
+    ngAfterViewInit(): void;
+    close(): void;
+    toggleFullscreen(): void;
+    startResize(e: MouseEvent, dir: string): void;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<EntityDialogComponent, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<EntityDialogComponent, "rxdb-entity-dialog", never, { "title": { "alias": "title"; "required": true; "isSignal": true; }; }, { "closeRequested": "closeRequested"; }, never, ["*"], true, [{ directive: typeof i1.CdkDrag; inputs: { "cdkDragBoundary": "cdkDragBoundary"; }; outputs: {}; }]>;
+}
+
+declare class EntityFormComponent {
+    readonly fields: _angular_core.InputSignal<FormFieldConfig[]>;
+    readonly data: _angular_core.InputSignal<EntityFormData>;
+    readonly mode: _angular_core.InputSignal<FormMode>;
+    readonly relatedEntityProvider: _angular_core.InputSignal<RelatedEntityProvider | undefined>;
+    readonly showActions: _angular_core.InputSignal<boolean>;
+    readonly fieldChanged: _angular_core.OutputEmitterRef<FormFieldChangeEvent>;
+    readonly formSubmitted: _angular_core.OutputEmitterRef<EntityFormData>;
+    readonly formCancelled: _angular_core.OutputEmitterRef<void>;
+    readonly validationErrors: _angular_core.OutputEmitterRef<FormValidationResult>;
+    readonly formData: _angular_core.WritableSignal<{
+        [field: string]: unknown;
+    }>;
+    readonly editableFields: _angular_core.Signal<FormFieldConfig[]>;
+    readonly isReadonly: _angular_core.Signal<boolean>;
+    readonly relatedItemsMap: _angular_core.Signal<Map<string, RelatedEntityItem[]>>;
+    readonly displayValueMap: _angular_core.Signal<Map<string, string>>;
+    onFieldChange(field: FormFieldConfig, rawValue: unknown): void;
+    onSubmit(): void;
+    onCancel(): void;
+    isFieldReadonly(field: FormFieldConfig): boolean;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<EntityFormComponent, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<EntityFormComponent, "rxdb-entity-form", never, { "fields": { "alias": "fields"; "required": true; "isSignal": true; }; "data": { "alias": "data"; "required": true; "isSignal": true; }; "mode": { "alias": "mode"; "required": false; "isSignal": true; }; "relatedEntityProvider": { "alias": "relatedEntityProvider"; "required": false; "isSignal": true; }; "showActions": { "alias": "showActions"; "required": false; "isSignal": true; }; }, { "fieldChanged": "fieldChanged"; "formSubmitted": "formSubmitted"; "formCancelled": "formCancelled"; "validationErrors": "validationErrors"; }, never, never, true, never>;
+}
+
+/** RxDB 实体实例（用于 CRUD 操作） */
+type EntityInstance = {
+    [key: string]: unknown;
+    readonly id: string;
+    save(): Promise<void>;
+    remove(): Promise<void>;
+};
+type FilterQuery = {
+    combinator: 'and' | 'or';
+    rules: unknown[];
+};
+/**
+ * 实体列表组件
+ *
+ * 封装了实体列表的完整 UI：工具栏（显示名称、筛选、撤销/重做、新增）+ 数据表格。
+ * 通过 `namespace` 和 `name` 输入定位 RxDB 实体，实现懒加载分页和 CRUD 操作。
+ *
+ * @example
+ * ```html
+ * <rxdb-entity-list [namespace]="namespace()" [name]="name()" />
+ * ```
+ */
+declare class EntityListComponent {
+    #private;
+    protected readonly Undo2: lucide_angular.LucideIconData;
+    protected readonly Redo2: lucide_angular.LucideIconData;
+    protected readonly Funnel: lucide_angular.LucideIconData;
+    /** CDK Overlay 定位策略：优先下方右对齐，其次上方右对齐 */
+    protected readonly overlayPositions: ({
+        originX: "end";
+        originY: "bottom";
+        overlayX: "end";
+        overlayY: "top";
+        offsetY: number;
+    } | {
+        originX: "end";
+        originY: "top";
+        overlayX: "end";
+        overlayY: "bottom";
+        offsetY: number;
+    })[];
+    protected readonly loadMore: _angular_core.Signal<(() => void) | undefined>;
+    readonly namespace: _angular_core.InputSignal<string>;
+    readonly name: _angular_core.InputSignal<string>;
+    /** 固定查询条件，与用户筛选条件做 AND 合并（用于关系属性过滤，如 ownerId = currentId） */
+    readonly fixedQuery: _angular_core.InputSignal<FilterQuery | undefined>;
+    /** 预填充的外键数据（级联新增时传递给子实体对话框） */
+    readonly fixedFormData: _angular_core.InputSignal<EntityFormData | undefined>;
+    /** 草稿父实体（用于级联新增场景，子实体通过关系API注册到父实体） */
+    readonly draftParentEntity: _angular_core.InputSignal<EntityInstance | null>;
+    /** 父实体上关系属性名（如 'children'），用于调用 parent.children$.add(child) */
+    readonly parentRelationName: _angular_core.InputSignal<string | undefined>;
+    /** 创建链路中的实体类型（namespace:name），用于阻断循环创建 */
+    readonly creationChain: _angular_core.InputSignal<string[]>;
+    /** 关系类型（MANY_TO_MANY 时启用选择模式） */
+    readonly relationKind: _angular_core.InputSignal<RelationKind | undefined>;
+    /** 父实体实例（用于 M2M 关系操作，包含 draft 和已保存实体） */
+    readonly parentEntity: _angular_core.InputSignal<EntityInstance | null>;
+    /** 列表模式：default=普通列表, select=选择模式（带 checkbox 列） */
+    readonly mode: _angular_core.InputSignal<"select" | "default">;
+    /** 已关联的实体 ID 集合（选择模式下过滤掉，不再展示） */
+    readonly alreadyLinkedIds: _angular_core.InputSignal<Set<string>>;
+    /** 点击「查看」按钮时触发，携带对应行记录 */
+    readonly viewEntity: _angular_core.OutputEmitterRef<EntityTableRecord>;
+    /** 选择模式：确认选择时触发，携带选中的实体实例 */
+    readonly selectionConfirmed: _angular_core.OutputEmitterRef<EntityInstance[]>;
+    /** 选择模式：取消选择时触发 */
+    readonly selectionCancelled: _angular_core.OutputEmitterRef<void>;
+    readonly filterQuery: WritableSignal<FilterQuery>;
+    readonly $isFilterQuery: _angular_core.Signal<boolean>;
+    readonly showFilterPopover: WritableSignal<boolean>;
+    readonly pendingQuery: WritableSignal<FilterQuery>;
+    readonly pendingQueryValid: WritableSignal<boolean>;
+    readonly isBrowser: boolean;
+    readonly displayName: _angular_core.Signal<string>;
+    /** 当前实体是否存在于祖先创建链路中（循环创建检测） */
+    readonly isCreateBlocked: _angular_core.Signal<boolean>;
+    readonly isQueryActive: _angular_core.Signal<boolean>;
+    readonly filteredCount: _angular_core.Signal<number>;
+    readonly isInitialLoading: _angular_core.Signal<boolean>;
+    readonly isLoadingMore: _angular_core.Signal<boolean>;
+    readonly undoCount: _angular_core.Signal<number>;
+    readonly redoCount: _angular_core.Signal<number>;
+    readonly canUndo: _angular_core.Signal<boolean>;
+    readonly canRedo: _angular_core.Signal<boolean>;
+    readonly queryBuilderFields: _angular_core.Signal<FieldMetadata[]>;
+    readonly tableRecords: _angular_core.Signal<EntityTableRecord[]>;
+    readonly tableColumns: _angular_core.Signal<ColumnsDefine>;
+    readonly createFormFieldConfigs: _angular_core.Signal<FormFieldConfig[]>;
+    readonly isSelectMode: _angular_core.Signal<boolean>;
+    readonly isM2m: _angular_core.Signal<boolean>;
+    readonly m2mSelectTpl: _angular_core.Signal<TemplateRef<void> | undefined>;
+    readonly selectedIds: WritableSignal<Set<string>>;
+    readonly selectedCount: _angular_core.Signal<number>;
+    readonly m2mAlreadyLinkedIds: _angular_core.Signal<Set<string>>;
+    constructor();
+    toggleFilterPopover(): void;
+    applyFilter(): void;
+    resetFilter(): void;
+    onKeydown(e: KeyboardEvent): void;
+    onQueryChange(query: {
+        combinator: 'and' | 'or';
+        rules: unknown[];
+    } | undefined): void;
+    onValidationChange(result: ValidationResult): void;
+    onCellChanged(event: CellChangeEvent): void;
+    undo(): void;
+    redo(): void;
+    onIconClicked(event: {
+        name: string;
+        record: EntityTableRecord;
+    }): Promise<void>;
+    onRowDeleted(event: EntityTableRecord): Promise<void>;
+    onBatchUpdated(mutations: BatchChangeItem[]): void;
+    openCreateDialog(): void;
+    openM2mSelectDialog(): void;
+    onM2mSelectionConfirmed(entities: EntityInstance[]): void;
+    m2mCancelSelection(): void;
+    confirmSelection(): void;
+    cancelSelection(): void;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<EntityListComponent, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<EntityListComponent, "rxdb-entity-list", never, { "namespace": { "alias": "namespace"; "required": true; "isSignal": true; }; "name": { "alias": "name"; "required": true; "isSignal": true; }; "fixedQuery": { "alias": "fixedQuery"; "required": false; "isSignal": true; }; "fixedFormData": { "alias": "fixedFormData"; "required": false; "isSignal": true; }; "draftParentEntity": { "alias": "draftParentEntity"; "required": false; "isSignal": true; }; "parentRelationName": { "alias": "parentRelationName"; "required": false; "isSignal": true; }; "creationChain": { "alias": "creationChain"; "required": false; "isSignal": true; }; "relationKind": { "alias": "relationKind"; "required": false; "isSignal": true; }; "parentEntity": { "alias": "parentEntity"; "required": false; "isSignal": true; }; "mode": { "alias": "mode"; "required": false; "isSignal": true; }; "alreadyLinkedIds": { "alias": "alreadyLinkedIds"; "required": false; "isSignal": true; }; }, { "viewEntity": "viewEntity"; "selectionConfirmed": "selectionConfirmed"; "selectionCancelled": "selectionCancelled"; }, never, never, true, never>;
+}
+
+declare const ENTITY_TABLE_CONFIG: InjectionToken<EntityTableConfig>;
+
+/**
+ * 通用实体数据表格组件
+ *
+ * 基于 VTable 提供高性能表格渲染，支持：
+ * - 单元格编辑（文本、开关、复选框、下拉）
+ * - 剪贴板操作（Ctrl+C/V，TSV 格式）
+ * - 拖拽排序
+ * - 键盘导航（Enter 切换开关，Delete 清空单元格）
+ * - 主题系统（daisyUI CSS 变量）
+ * - 校验错误 tooltip
+ */
+declare class EntityTableComponent implements OnDestroy {
+    #private;
+    readonly tableContainer: _angular_core.Signal<ElementRef<HTMLDivElement> | undefined>;
+    readonly records: _angular_core.InputSignal<EntityTableRecord[]>;
+    readonly columns: _angular_core.InputSignal<VTable.TYPES.ColumnsDefine | undefined>;
+    readonly isDarkMode: _angular_core.InputSignal<boolean>;
+    readonly idField: _angular_core.InputSignal<string>;
+    readonly nonClearableFields: _angular_core.InputSignal<ReadonlySet<string>>;
+    readonly tableOptions: _angular_core.InputSignal<Partial<ListTableConstructorOptions> | undefined>;
+    readonly cellErrorDetector: _angular_core.InputSignal<((record: EntityTableRecord, field: string) => string | null) | undefined>;
+    readonly loading: _angular_core.InputSignal<boolean>;
+    /** 业务层回调判断单元格是否可清空（返回 false 跳过），替代领域特定的硬编码逻辑 */
+    readonly cellClearable: _angular_core.InputSignal<((record: Record<string, unknown>, field: string) => boolean) | undefined>;
+    /** 触底时加载更多数据的回调，由表格内部在滚动到底部时调用 */
+    readonly loadMore: _angular_core.InputSignal<(() => void) | undefined>;
+    /** 加载更多中状态（已有数据，底部小 spinner，不拦截滚动） */
+    readonly loadingMore: _angular_core.InputSignal<boolean>;
+    readonly cellChanged: _angular_core.OutputEmitterRef<CellChangeEvent>;
+    readonly rowDeleted: _angular_core.OutputEmitterRef<EntityTableRecord>;
+    readonly iconClicked: _angular_core.OutputEmitterRef<{
+        name: string;
+        record: EntityTableRecord;
+    }>;
+    readonly batchUpdated: _angular_core.OutputEmitterRef<BatchChangeItem[]>;
+    readonly rowReordered: _angular_core.OutputEmitterRef<string[]>;
+    readonly scrollNearBottom: _angular_core.OutputEmitterRef<void>;
+    readonly cellTooltip: _angular_core.WritableSignal<{
+        x: number;
+        y: number;
+        content: string;
+    } | null>;
+    readonly headerHeight: _angular_core.WritableSignal<number>;
+    get tableInstance(): VTable.ListTable | null;
+    constructor();
+    /**
+     * 从业务层回滚单元格值（校验失败时恢复原值）。
+     * 避免外部直接访问 tableInstance。
+     */
+    changeCellValue(col: number, row: number, value: unknown): void;
+    redrawTheme(): void;
+    ngOnDestroy(): void;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<EntityTableComponent, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<EntityTableComponent, "rxdb-entity-table", never, { "records": { "alias": "records"; "required": true; "isSignal": true; }; "columns": { "alias": "columns"; "required": true; "isSignal": true; }; "isDarkMode": { "alias": "isDarkMode"; "required": false; "isSignal": true; }; "idField": { "alias": "idField"; "required": false; "isSignal": true; }; "nonClearableFields": { "alias": "nonClearableFields"; "required": false; "isSignal": true; }; "tableOptions": { "alias": "tableOptions"; "required": false; "isSignal": true; }; "cellErrorDetector": { "alias": "cellErrorDetector"; "required": false; "isSignal": true; }; "loading": { "alias": "loading"; "required": false; "isSignal": true; }; "cellClearable": { "alias": "cellClearable"; "required": false; "isSignal": true; }; "loadMore": { "alias": "loadMore"; "required": false; "isSignal": true; }; "loadingMore": { "alias": "loadingMore"; "required": false; "isSignal": true; }; }, { "cellChanged": "cellChanged"; "rowDeleted": "rowDeleted"; "iconClicked": "iconClicked"; "batchUpdated": "batchUpdated"; "rowReordered": "rowReordered"; "scrollNearBottom": "scrollNearBottom"; }, never, ["[emptyState]"], true, never>;
+}
+
+/**
+ * 集成查询构建器的实体表格组件
+ *
+ * 在实体表格上方提供筛选区域位置（通过内容投影），
+ * 将 rxdb-query-builder 的查询结果传递给底层 EntityTableComponent。
+ *
+ * 使用方式：
+ * ```html
+ * <rxdb-query-table [records]="filteredRecords()" [columns]="columns">
+ *   <div filterBar>
+ *     <rxdb-query-builder [fields]="fields" (queryChange)="onQueryChange($event)" />
+ *   </div>
+ *   <div emptyState>暂无数据</div>
+ * </rxdb-query-table>
+ * ```
+ */
+declare class QueryTableComponent {
+    readonly records: _angular_core.InputSignal<EntityTableRecord[]>;
+    readonly columns: _angular_core.InputSignal<VTable.ColumnsDefine | undefined>;
+    readonly idField: _angular_core.InputSignal<string>;
+    readonly nonClearableFields: _angular_core.InputSignal<ReadonlySet<string>>;
+    readonly tableOptions: _angular_core.InputSignal<Partial<ListTableConstructorOptions> | undefined>;
+    readonly cellErrorDetector: _angular_core.InputSignal<((record: EntityTableRecord, field: string) => string | null) | undefined>;
+    readonly isDarkMode: _angular_core.InputSignal<boolean>;
+    /** 业务层回调判断单元格是否可清空 */
+    readonly cellClearable: _angular_core.InputSignal<((record: Record<string, unknown>, field: string) => boolean) | undefined>;
+    /** 查询条件是否激活（显示筛选状态标签） */
+    readonly queryActive: _angular_core.InputSignal<boolean>;
+    /** 结果总数（显示在筛选状态栏中） */
+    readonly totalCount: _angular_core.InputSignal<number | undefined>;
+    /** 筛选后结果数 */
+    readonly filteredCount: _angular_core.InputSignal<number | undefined>;
+    /** 是否显示加载状态 */
+    readonly loading: _angular_core.InputSignal<boolean>;
+    /** 加载更多中（已有数据，底部小 spinner，不拦截滚动） */
+    readonly loadingMore: _angular_core.InputSignal<boolean>;
+    /** 触底时加载更多数据的回调，透传给 EntityTableComponent */
+    readonly loadMore: _angular_core.InputSignal<(() => void) | undefined>;
+    readonly cellChanged: _angular_core.OutputEmitterRef<CellChangeEvent>;
+    readonly rowDeleted: _angular_core.OutputEmitterRef<EntityTableRecord>;
+    readonly iconClicked: _angular_core.OutputEmitterRef<{
+        name: string;
+        record: EntityTableRecord;
+    }>;
+    readonly batchUpdated: _angular_core.OutputEmitterRef<BatchChangeItem[]>;
+    readonly rowReordered: _angular_core.OutputEmitterRef<string[]>;
+    readonly scrollNearBottom: _angular_core.OutputEmitterRef<void>;
+    readonly entityTable: _angular_core.Signal<EntityTableComponent | undefined>;
+    readonly statusText: _angular_core.Signal<string>;
+    get tableInstance(): ListTable | null;
+    changeCellValue(col: number, row: number, value: unknown): void;
+    redrawTheme(): void;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<QueryTableComponent, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<QueryTableComponent, "rxdb-query-table", never, { "records": { "alias": "records"; "required": true; "isSignal": true; }; "columns": { "alias": "columns"; "required": true; "isSignal": true; }; "idField": { "alias": "idField"; "required": false; "isSignal": true; }; "nonClearableFields": { "alias": "nonClearableFields"; "required": false; "isSignal": true; }; "tableOptions": { "alias": "tableOptions"; "required": false; "isSignal": true; }; "cellErrorDetector": { "alias": "cellErrorDetector"; "required": false; "isSignal": true; }; "isDarkMode": { "alias": "isDarkMode"; "required": false; "isSignal": true; }; "cellClearable": { "alias": "cellClearable"; "required": false; "isSignal": true; }; "queryActive": { "alias": "queryActive"; "required": false; "isSignal": true; }; "totalCount": { "alias": "totalCount"; "required": false; "isSignal": true; }; "filteredCount": { "alias": "filteredCount"; "required": false; "isSignal": true; }; "loading": { "alias": "loading"; "required": false; "isSignal": true; }; "loadingMore": { "alias": "loadingMore"; "required": false; "isSignal": true; }; "loadMore": { "alias": "loadMore"; "required": false; "isSignal": true; }; }, { "cellChanged": "cellChanged"; "rowDeleted": "rowDeleted"; "iconClicked": "iconClicked"; "batchUpdated": "batchUpdated"; "rowReordered": "rowReordered"; "scrollNearBottom": "scrollNearBottom"; }, never, ["[filterBar]", "[emptyState]"], true, never>;
+}
+
+/**
+ * UI 规则组（宽松类型）
+ */
+interface UIRuleGroup {
+    id: string;
+    combinator: 'and' | 'or';
+    rules: Array<UIRule | UIRuleGroup>;
+}
+type QueryDropMode = 'before' | 'after' | 'into';
+interface QueryDragDropState {
+    draggedItemId: string | null;
+    targetItemId: string | null;
+    dropMode: QueryDropMode | null;
+    isValidTarget: boolean;
+    depth?: number;
+}
+declare class QueryDragDropHandler {
+    private readonly moveItemFn;
+    readonly state: _angular_core.WritableSignal<QueryDragDropState>;
+    constructor(moveItemFn: (itemId: string, targetGroupId: string, targetIndex: number) => void);
+    start(itemId: string): void;
+    over(targetItemId: string, dropMode: QueryDropMode, isValid: boolean, depth: number): void;
+    leave(): void;
+    drop(itemId: string, targetGroupId: string, targetIndex: number): void;
+    end(): void;
+    private reset;
+}
+/**
+ * 查询规则组组件（递归）
+ *
+ * @description
+ * 显示一组查询规则，支持：
+ * - AND/OR 切换（Teable 风格：行内 conjunction 前缀）
+ * - 添加规则/子组
+ * - 删除组
+ * - 递归嵌套显示
+ */
+declare class QueryGroupComponent {
+    readonly group: _angular_core.InputSignal<UIRuleGroup>;
+    readonly fields: _angular_core.InputSignal<FieldMetadata[]>;
+    readonly errors: _angular_core.InputSignal<ValidationError[]>;
+    readonly depth: _angular_core.InputSignal<number>;
+    readonly maxDepth: _angular_core.InputSignal<number>;
+    readonly dragDropHandler: _angular_core.InputSignal<QueryDragDropHandler | undefined>;
+    /** 是否允许展开/收起组（默认开启） */
+    readonly allowCollapse: _angular_core.InputSignal<boolean>;
+    readonly addRule: _angular_core.OutputEmitterRef<{
+        parentId: string;
+        rule: Omit<UIRule, "id">;
+    }>;
+    readonly addGroup: _angular_core.OutputEmitterRef<string>;
+    readonly removeItem: _angular_core.OutputEmitterRef<string>;
+    readonly updateRule: _angular_core.OutputEmitterRef<{
+        id: string;
+        updates: Partial<UIRule>;
+    }>;
+    readonly updateCombinator: _angular_core.OutputEmitterRef<{
+        id: string;
+        combinator: "and" | "or";
+    }>;
+    /** 当前组是否已折叠 */
+    readonly collapsed: _angular_core.WritableSignal<boolean>;
+    /** 是否可以添加子组（未达到最大深度） */
+    readonly canAddGroup: _angular_core.Signal<boolean>;
+    /** 切换折叠状态 */
+    toggleCollapse(): void;
+    /** 切换组合器 */
+    toggleCombinator(combinator: 'and' | 'or'): void;
+    /** 添加规则 */
+    onAddRule(): void;
+    /** 添加子组 */
+    onAddGroup(): void;
+    /** 删除此组 */
+    onRemove(): void;
+    /** 规则更新 */
+    onRuleUpdate(event: {
+        id: string;
+        updates: Partial<UIRule>;
+    }): void;
+    /** 删除规则 */
+    onRuleRemove(id: string): void;
+    /** 类型守卫：是否为规则组 */
+    isRuleGroup(item: UIRuleGroup | UIRule): item is UIRuleGroup;
+    /** 类型转换：转为规则组 */
+    asRuleGroup(item: UIRuleGroup | UIRule): UIRuleGroup;
+    /** 类型转换：转为规则 */
+    asRule(item: UIRuleGroup | UIRule): UIRule;
+    /** 追踪函数 */
+    trackByItem(item: UIRuleGroup | UIRule): string;
+    isDragging(itemId: string): boolean;
+    isDropTarget(itemId: string, mode: QueryDropMode): boolean;
+    isDropInvalid(itemId: string): boolean;
+    onItemDragStart(event: DragEvent, item: UIRule | UIRuleGroup): void;
+    onItemDragOver(event: DragEvent, item: UIRule | UIRuleGroup, index: number, isGroup: boolean): void;
+    onItemDragLeave(event: DragEvent): void;
+    onItemDrop(event: DragEvent, targetItem: UIRule | UIRuleGroup, targetIndex: number, isGroup: boolean): void;
+    onItemDragEnd(): void;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<QueryGroupComponent, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<QueryGroupComponent, "rxdb-query-group", never, { "group": { "alias": "group"; "required": true; "isSignal": true; }; "fields": { "alias": "fields"; "required": true; "isSignal": true; }; "errors": { "alias": "errors"; "required": false; "isSignal": true; }; "depth": { "alias": "depth"; "required": false; "isSignal": true; }; "maxDepth": { "alias": "maxDepth"; "required": false; "isSignal": true; }; "dragDropHandler": { "alias": "dragDropHandler"; "required": false; "isSignal": true; }; "allowCollapse": { "alias": "allowCollapse"; "required": false; "isSignal": true; }; }, { "addRule": "addRule"; "addGroup": "addGroup"; "removeItem": "removeItem"; "updateRule": "updateRule"; "updateCombinator": "updateCombinator"; }, never, never, true, never>;
+}
+
+/**
+ * RxDB 查询输出格式
+ */
+interface RxDBQueryOutput<T> {
+    combinator: 'and' | 'or';
+    rules: Array<RxDBQueryOutput<T> | {
+        field: keyof T & string;
+        operator: string;
+        value: unknown;
+    }>;
+}
+/**
+ * Angular Query Builder 主组件
+ *
+ * @description
+ * 提供可视化的查询条件构建界面，支持：
+ * - 传入 SchemaInfo 或 FieldMetadata[] 定义可用字段
+ * - 拖拽重排规则和分组
+ * - 嵌套分组（最大 5 层）
+ * - 实时验证
+ *
+ * @example
+ * ```html
+ * <rxdb-query-builder
+ *   [schema]="schema"
+ *   (queryChange)="onQueryChange($event)"
+ * />
+ * ```
+ */
+declare class QueryBuilderComponent<T extends object> implements OnDestroy {
+    private readonly service;
+    /** 上次应用的 initialQuery 引用，用于检测是否有新查询需要加载 */
+    private lastAppliedInitialQuery;
+    private readonly scrollContainer;
+    /** 根规则组 Signal */
+    private readonly rootGroupSignal;
+    /** 验证 Signal */
+    private readonly validationSignal;
+    /**
+     * Schema 信息，包含字段定义
+     */
+    readonly schema: _angular_core.InputSignal<SchemaInfo | undefined>;
+    /**
+     * 字段列表（直接传入，优先于 schema）
+     */
+    readonly fields: _angular_core.InputSignal<FieldMetadata[]>;
+    /**
+     * 初始查询条件（可选）
+     */
+    readonly initialQuery: _angular_core.InputSignal<RxDBQueryOutput<T> | undefined>;
+    /**
+     * 最大嵌套层级（默认 5）
+     */
+    readonly maxDepth: _angular_core.InputSignal<number>;
+    /**
+     * 内容区域最大高度（超出后滚动），支持任意 CSS 长度值，如 `'400px'`、`'50vh'`
+     */
+    readonly height: _angular_core.InputSignal<string>;
+    /**
+     * 是否开启拖拽排序功能（默认开启）
+     */
+    readonly enableDrag: _angular_core.InputSignal<boolean>;
+    /**
+     * 是否开启分组展开/收起功能（默认开启）
+     */
+    readonly enableCollapse: _angular_core.InputSignal<boolean>;
+    readonly dragDropHandler: QueryDragDropHandler;
+    /**
+     * 查询条件变更事件
+     */
+    readonly queryChange: _angular_core.OutputEmitterRef<RxDBQueryOutput<T>>;
+    /**
+     * 验证状态变更事件
+     */
+    readonly validationChange: _angular_core.OutputEmitterRef<ValidationResult>;
+    /** 计算后的字段列表 */
+    readonly fieldsComputed: Signal<FieldMetadata[]>;
+    /** 根规则组 */
+    readonly rootGroup: Signal<UIRuleGroup | undefined>;
+    /** 验证错误列表 */
+    readonly validationErrors: Signal<_aiao_rxdb_model.ValidationError[]>;
+    /** 是否有规则 */
+    readonly hasRules: Signal<boolean | undefined>;
+    constructor();
+    /** 销毁服务 */
+    ngOnDestroy(): void;
+    /** 添加第一个规则 */
+    addFirstRule(): void;
+    /** 清空所有规则 */
+    clearAll(): void;
+    /** 添加规则到指定组 */
+    onAddRule(event: {
+        parentId: string;
+        rule: Omit<UIRule, 'id'>;
+    }): void;
+    /** 添加子组到指定组 */
+    onAddGroup(parentId: string): void;
+    /** 删除规则或组 */
+    onRemoveItem(id: string): void;
+    /** 更新规则 */
+    onUpdateRule(event: {
+        id: string;
+        updates: Partial<UIRule>;
+    }): void;
+    /** 更新组合器 */
+    onUpdateCombinator(event: {
+        id: string;
+        combinator: 'and' | 'or';
+    }): void;
+    /** 键盘快捷键处理 */
+    onKeyDown(event: KeyboardEvent): void;
+    private scrollToBottom;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<QueryBuilderComponent<any>, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<QueryBuilderComponent<any>, "rxdb-query-builder", never, { "schema": { "alias": "schema"; "required": false; "isSignal": true; }; "fields": { "alias": "fields"; "required": false; "isSignal": true; }; "initialQuery": { "alias": "initialQuery"; "required": false; "isSignal": true; }; "maxDepth": { "alias": "maxDepth"; "required": false; "isSignal": true; }; "height": { "alias": "height"; "required": false; "isSignal": true; }; "enableDrag": { "alias": "enableDrag"; "required": false; "isSignal": true; }; "enableCollapse": { "alias": "enableCollapse"; "required": false; "isSignal": true; }; }, { "queryChange": "queryChange"; "validationChange": "validationChange"; }, never, never, true, never>;
+}
+
+/**
+ * 字段选择器组件
+ *
+ * @description
+ * 使用 Popover API 展示树形字段结构，支持过滤和嵌套关系字段的展开/折叠。
+ * 基于 CDK `ActiveDescendantKeyManager` 提供完整键盘导航和无障碍支持。
+ * 不依赖任何第三方 UI 库。
+ *
+ * 支持两种使用方式：
+ * 1. 直接模板使用：监听 `(fieldChange)` output 事件
+ * 2. 通过 NgComponentOutlet 注入：传入 `fieldChangeFn` 回调 input
+ */
+declare class FieldSelectorComponent {
+    readonly fields: _angular_core.InputSignal<FieldMetadata[]>;
+    readonly selectedField: _angular_core.InputSignal<string>;
+    readonly placeholder: _angular_core.InputSignal<string>;
+    /** 通过 NgComponentOutlet 注入时使用的回调 input */
+    readonly fieldChangeFn: _angular_core.InputSignal<((field: string) => void) | undefined>;
+    /** 直接模板使用时的 output 事件 */
+    readonly fieldChange: _angular_core.OutputEmitterRef<string>;
+    readonly fieldTree: _angular_core.Signal<_aiao_rxdb_model.FieldTreeNode[]>;
+    onSelect(field: string): void;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<FieldSelectorComponent, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<FieldSelectorComponent, "rxdb-field-selector", never, { "fields": { "alias": "fields"; "required": true; "isSignal": true; }; "selectedField": { "alias": "selectedField"; "required": false; "isSignal": true; }; "placeholder": { "alias": "placeholder"; "required": false; "isSignal": true; }; "fieldChangeFn": { "alias": "fieldChangeFn"; "required": false; "isSignal": true; }; }, { "fieldChange": "fieldChange"; }, never, never, true, never>;
+}
+
+/**
+ * 操作符选择器组件
+ *
+ * @description
+ * 基于 {@link PopoverSelectComponent} 提供操作符选择功能，
+ * 自动根据字段类型或元数据筛选可用操作符。
+ * 支持搜索过滤和键盘导航。
+ *
+ * 支持两种使用方式：
+ * 1. 直接模板使用：监听 `(operatorChange)` output 事件
+ * 2. 通过 NgComponentOutlet 注入：传入 `operatorChangeFn` 回调 input
+ */
+declare class OperatorSelectorComponent {
+    private readonly registry;
+    readonly operatorOptions: _angular_core.Signal<{
+        value: OperatorName;
+        label: string;
+    }[]>;
+    readonly fieldMetadata: _angular_core.InputSignal<FieldMetadata | undefined>;
+    readonly fieldType: _angular_core.InputSignal<string>;
+    readonly selectedOperator: _angular_core.InputSignal<string>;
+    /** 通过 NgComponentOutlet 注入时使用的回调 input */
+    readonly operatorChangeFn: _angular_core.InputSignal<((op: string) => void) | undefined>;
+    /** 直接模板使用时的 output 事件 */
+    readonly operatorChange: _angular_core.OutputEmitterRef<string>;
+    onOperatorChange(op: string): void;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<OperatorSelectorComponent, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<OperatorSelectorComponent, "rxdb-operator-selector", never, { "fieldMetadata": { "alias": "fieldMetadata"; "required": false; "isSignal": true; }; "fieldType": { "alias": "fieldType"; "required": false; "isSignal": true; }; "selectedOperator": { "alias": "selectedOperator"; "required": false; "isSignal": true; }; "operatorChangeFn": { "alias": "operatorChangeFn"; "required": false; "isSignal": true; }; }, { "operatorChange": "operatorChange"; }, never, never, true, never>;
+}
+
+/**
+ * 基于 Popover API 的下拉选择组件
+ *
+ * @description
+ * 使用浏览器原生 Popover API 渲染选项列表，在 top layer 渲染，
+ * 确保在 `overflow: auto/hidden` 容器内也不会被裁剪。
+ * 支持关键字过滤、键盘导航（↑↓ 移动、Enter 选中、Escape 关闭）。
+ * 打开弹框自动高亮第一项，搜索后也自动高亮第一条结果。
+ */
+declare class PopoverSelectComponent {
+    private readonly trigger;
+    private readonly popoverEl;
+    private readonly filterInput;
+    protected readonly uid: string;
+    protected readonly listId: string;
+    protected readonly filterText: _angular_core.WritableSignal<string>;
+    protected readonly activeIndex: _angular_core.WritableSignal<number>;
+    readonly options: _angular_core.InputSignal<readonly {
+        value: string;
+        label: string;
+    }[]>;
+    readonly selected: _angular_core.InputSignal<string>;
+    readonly placeholder: _angular_core.InputSignal<string>;
+    readonly minWidth: _angular_core.InputSignal<string>;
+    readonly selectChange: _angular_core.OutputEmitterRef<string>;
+    readonly currentLabel: _angular_core.Signal<string>;
+    readonly filteredOptions: _angular_core.Signal<readonly {
+        value: string;
+        label: string;
+    }[]>;
+    readonly activeItemId: _angular_core.Signal<string | null>;
+    constructor();
+    onBeforeToggle(event: Event): void;
+    onToggle(event: Event): void;
+    onKeydown(event: KeyboardEvent): void;
+    onSelect(value: string): void;
+    private scrollActiveIntoView;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<PopoverSelectComponent, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<PopoverSelectComponent, "rxdb-popover-select", never, { "options": { "alias": "options"; "required": true; "isSignal": true; }; "selected": { "alias": "selected"; "required": false; "isSignal": true; }; "placeholder": { "alias": "placeholder"; "required": false; "isSignal": true; }; "minWidth": { "alias": "minWidth"; "required": false; "isSignal": true; }; }, { "selectChange": "selectChange"; }, never, never, true, never>;
+}
+
+/**
+ * 带 where 子查询的规则类型
+ */
+type UIRuleWithWhere = UIRule & {
+    where?: QueryBuilderRuleGroup<Record<string, unknown>>;
+};
+/**
+ * 单条查询规则组件
+ *
+ * @description
+ * 显示一条查询规则的编辑界面：
+ * - 字段选择器
+ * - 操作符选择器
+ * - 值输入框
+ * - 删除按钮
+ */
+declare class QueryRuleComponent {
+    private readonly existsOperators;
+    private readonly noValueOperators;
+    /** 注入的主题（回退到默认主题） */
+    protected readonly theme: _aiao_rxdb_model_angular.QueryBuilderTheme;
+    readonly rule: _angular_core.InputSignal<UIRuleWithWhere>;
+    readonly fields: _angular_core.InputSignal<FieldMetadata[]>;
+    readonly errors: _angular_core.InputSignal<ValidationError[]>;
+    readonly update: _angular_core.OutputEmitterRef<{
+        id: string;
+        updates: Partial<UIRuleWithWhere>;
+    }>;
+    readonly remove: _angular_core.OutputEmitterRef<void>;
+    readonly fieldAsString: _angular_core.Signal<string>;
+    readonly ruleErrors: _angular_core.Signal<ValidationError[]>;
+    readonly errorTooltip: _angular_core.Signal<string>;
+    readonly isExistsOperator: _angular_core.Signal<boolean>;
+    readonly isNoValueOperator: _angular_core.Signal<boolean>;
+    /** 子查询面板是否展开（已有 where 规则时自动展开） */
+    readonly showSubquery: _angular_core.WritableSignal<boolean>;
+    /**
+     * 当规则的 where 已有内容时自动展开。
+     * 使用 computed 包装监听 rule().where，在显示按钮前检查。
+     */
+    readonly subqueryVisible: _angular_core.Signal<boolean>;
+    readonly currentField: _angular_core.Signal<FieldMetadata | undefined>;
+    readonly currentFieldType: _angular_core.Signal<_aiao_rxdb_model.PropertyType>;
+    readonly currentEnumOptions: _angular_core.Signal<unknown[]>;
+    /** 当前字段的关系目标实体字段列表 */
+    readonly currentRelationFields: _angular_core.Signal<FieldMetadata[]>;
+    /** 规则的 where 子查询 */
+    readonly ruleWhere: _angular_core.Signal<QueryBuilderRuleGroup<Record<string, unknown>> | undefined>;
+    /** NgComponentOutlet inputs：字段选择器（fieldChangeCb 是 lazy 引用，声明顺序不影响运行时）*/
+    readonly fieldSelectorInputs: _angular_core.Signal<{
+        fields: FieldMetadata[];
+        selectedField: string;
+        fieldChangeFn: (field: string) => void;
+    }>;
+    /** NgComponentOutlet inputs：操作符选择器 */
+    readonly operatorSelectorInputs: _angular_core.Signal<{
+        fieldMetadata: FieldMetadata | undefined;
+        fieldType: _aiao_rxdb_model.PropertyType;
+        selectedOperator: string;
+        operatorChangeFn: (op: string) => void;
+    }>;
+    /** NgComponentOutlet inputs：值输入 */
+    readonly valueInputInputs: _angular_core.Signal<{
+        fieldType: _aiao_rxdb_model.PropertyType;
+        operator: string;
+        value: unknown;
+        enumOptions: unknown[];
+        relationFields: FieldMetadata[];
+        where: QueryBuilderRuleGroup<Record<string, unknown>> | undefined;
+        errorMessage: string;
+        valueChangeFn: (value: unknown) => void;
+        whereChangeFn: (where: QueryBuilderRuleGroup<Record<string, unknown>> | undefined) => void;
+    }>;
+    /** 子条件清空/全部删除时自动收起面板并恢复 +子条件 按钮 */
+    constructor();
+    /** 字段变更 */
+    onFieldChange(fieldName: string): void;
+    /** 添加子条件：展开面板并创建一条默认子规则 */
+    onAddSubcondition(): void;
+    /** 操作符变更 */
+    onOperatorChange(operator: string): void;
+    /** 值变更 */
+    onValueChange(value: unknown): void;
+    /** 子查询条件变更 */
+    onWhereChange(where: QueryBuilderRuleGroup<Record<string, unknown>> | undefined): void;
+    /** 删除规则 */
+    onRemove(): void;
+    private readonly fieldChangeCb;
+    private readonly operatorChangeCb;
+    private readonly valueChangeCb;
+    private readonly whereChangeCb;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<QueryRuleComponent, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<QueryRuleComponent, "rxdb-query-rule", never, { "rule": { "alias": "rule"; "required": true; "isSignal": true; }; "fields": { "alias": "fields"; "required": true; "isSignal": true; }; "errors": { "alias": "errors"; "required": false; "isSignal": true; }; }, { "update": "update"; "remove": "remove"; }, never, never, true, never>;
+}
+
+/**
+ * 子查询构建器组件
+ *
+ * @description
+ * 用于 EXISTS/NOT EXISTS 操作符的嵌套查询条件。
+ * 支持：
+ * - 添加子条件
+ * - 嵌套规则组
+ * - 清空子条件
+ */
+declare class SubqueryBuilderComponent implements OnDestroy {
+    private readonly service;
+    /** initialQuery 是否已应用（只应用一次） */
+    private initialQueryApplied;
+    /** 根规则组 Signal */
+    private readonly rootGroupSignal;
+    /** 验证 Signal */
+    private readonly validationSignal;
+    /** 字段列表 */
+    readonly fields: _angular_core.InputSignal<FieldMetadata[]>;
+    /** 初始查询 */
+    readonly initialQuery: _angular_core.InputSignal<QueryBuilderRuleGroup<Record<string, unknown>> | undefined>;
+    /** 最大嵌套层级 */
+    readonly maxDepth: _angular_core.InputSignal<number>;
+    /** 查询变更事件 */
+    readonly queryChange: _angular_core.OutputEmitterRef<{
+        combinator: "and" | "or";
+        rules: unknown[];
+    } | undefined>;
+    /** 验证变更事件 */
+    readonly validationChange: _angular_core.OutputEmitterRef<ValidationResult>;
+    /** 根规则组 */
+    readonly rootGroup: Signal<UIRuleGroup | undefined>;
+    /** 是否有规则 */
+    readonly hasRules: Signal<boolean | undefined>;
+    constructor();
+    /** 销毁服务 */
+    ngOnDestroy(): void;
+    /** 添加第一条规则 */
+    handleAddFirstRule(): void;
+    /** 清空所有规则 */
+    handleClear(): void;
+    /** 添加规则到指定组 */
+    onAddRule(event: {
+        parentId: string;
+        rule: Omit<UIRule, 'id'>;
+    }): void;
+    /** 添加子组到指定组 */
+    onAddGroup(parentId: string): void;
+    /** 删除规则或组 */
+    onRemoveItem(id: string): void;
+    /** 更新规则 */
+    onUpdateRule(event: {
+        id: string;
+        updates: Partial<UIRule>;
+    }): void;
+    /** 更新组合器 */
+    onUpdateCombinator(event: {
+        id: string;
+        combinator: 'and' | 'or';
+    }): void;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<SubqueryBuilderComponent, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<SubqueryBuilderComponent, "rxdb-subquery-builder", never, { "fields": { "alias": "fields"; "required": true; "isSignal": true; }; "initialQuery": { "alias": "initialQuery"; "required": false; "isSignal": true; }; "maxDepth": { "alias": "maxDepth"; "required": false; "isSignal": true; }; }, { "queryChange": "queryChange"; "validationChange": "validationChange"; }, never, never, true, never>;
+}
+
+/** 扁平化的可见树节点（用于渲染和键盘导航） */
+interface FlatItem {
+    node: FieldTreeNode;
+    depth: number;
+    isExpandable: boolean;
+    isExpanded: boolean;
+}
+/**
+ * 树节点 Directive，实现 CDK {@link Highlightable} 接口
+ *
+ * 用于 {@link ActiveDescendantKeyManager} 管理键盘导航时的激活样式。
+ * `exportAs: 'rxdbTreeItem'` 允许模板中通过 `#ref="rxdbTreeItem"` 访问实例。
+ */
+declare class TreeItemDirective implements Highlightable {
+    private readonly _active;
+    readonly isActive: _angular_core.Signal<boolean>;
+    setActiveStyles(): void;
+    setInactiveStyles(): void;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<TreeItemDirective, never>;
+    static ɵdir: _angular_core.ɵɵDirectiveDeclaration<TreeItemDirective, "[rxdbTreeItem]", ["rxdbTreeItem"], {}, {}, never, never, true, never>;
+}
+/**
+ * 树形下拉选择组件
+ *
+ * @description
+ * 基于 Popover API 和 `@angular/cdk/a11y` 的树形字段选择器：
+ * - 使用原生 Popover API，在 `overflow` 容器中不被裁剪
+ * - 支持关键字过滤（自动展开匹配路径）
+ * - 支持展开/折叠关系节点
+ * - 键盘导航：↑↓ 移动、→ 展开、← 折叠、Enter 选中、Escape 关闭
+ * - 使用 CDK `ActiveDescendantKeyManager` + `aria-activedescendant` 满足 WAI-ARIA 无障碍规范
+ *
+ * @example
+ * ```html
+ * <rxdb-tree-select
+ *   [nodes]="fieldTree()"
+ *   [selected]="selectedField()"
+ *   placeholder="选择字段"
+ *   (selectChange)="onFieldSelect($event)"
+ * />
+ * ```
+ */
+declare class TreeSelectComponent {
+    private readonly trigger;
+    private readonly popoverEl;
+    private readonly filterInput;
+    private readonly treeItemDirs;
+    private readonly expandedPaths;
+    private readonly keyManager;
+    private readonly _activeIdx;
+    protected readonly uid: string;
+    protected readonly listId: string;
+    protected readonly filterText: _angular_core.WritableSignal<string>;
+    protected readonly ChevronDownIcon: lucide_angular.LucideIconData;
+    protected readonly ChevronRightIcon: lucide_angular.LucideIconData;
+    protected readonly typeIconMap: Partial<Record<string, typeof ChevronDownIcon>>;
+    protected readonly typeColorMap: Partial<Record<string, string>>;
+    protected readonly defaultTypeIcon: lucide_angular.LucideIconData;
+    protected readonly defaultTypeColor = "text-base-content/40";
+    readonly nodes: _angular_core.InputSignal<FieldTreeNode[]>;
+    readonly selected: _angular_core.InputSignal<string>;
+    readonly placeholder: _angular_core.InputSignal<string>;
+    readonly minWidth: _angular_core.InputSignal<string>;
+    readonly selectChange: _angular_core.OutputEmitterRef<string>;
+    readonly displayValue: _angular_core.Signal<string>;
+    readonly selectedNode: _angular_core.Signal<FieldTreeNode | null | undefined>;
+    readonly visibleItems: _angular_core.Signal<FlatItem[]>;
+    readonly activeItemId: _angular_core.Signal<string | null>;
+    constructor();
+    onBeforeToggle(event: Event): void;
+    onToggle(event: Event): void;
+    onKeydown(event: KeyboardEvent): void;
+    onItemClick(item: FlatItem): void;
+    /** 追踪函数：使用 value + isExistsOption 避免重复 key */
+    protected trackItem(item: FlatItem): string;
+    private scrollActiveIntoView;
+    private toggleExpand;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<TreeSelectComponent, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<TreeSelectComponent, "rxdb-tree-select", never, { "nodes": { "alias": "nodes"; "required": true; "isSignal": true; }; "selected": { "alias": "selected"; "required": false; "isSignal": true; }; "placeholder": { "alias": "placeholder"; "required": false; "isSignal": true; }; "minWidth": { "alias": "minWidth"; "required": false; "isSignal": true; }; }, { "selectChange": "selectChange"; }, never, never, true, never>;
+}
+
+/**
+ * 值输入组件
+ *
+ * @description
+ * 根据字段类型和操作符显示合适的输入控件：
+ * - string: 文本输入框
+ * - number: 数字输入框
+ * - boolean: 切换开关
+ * - date: 日期选择器
+ * - enum: 下拉选择器
+ * - array: 逗号分隔的文本输入
+ * - range: 范围输入（双输入框或范围选择器）
+ * - null/notNull 操作符: 无输入
+ * - exists/notExists 操作符: 子查询构建器
+ */
+declare class ValueInputComponent implements OnInit, OnDestroy {
+    private previousInputType;
+    private subqueryComponentRef?;
+    private subquerySubscription?;
+    private subqueryLoading;
+    private readonly injector;
+    /** UUID 格式校验错误（基于 currentValue 派生，inputType 不是 uuid 时自动为空） */
+    readonly uuidError: _angular_core.Signal<"" | "请输入合法的 UUID 格式">;
+    subqueryContainer?: ViewContainerRef;
+    readonly fieldType: _angular_core.InputSignal<string>;
+    readonly operator: _angular_core.InputSignal<string>;
+    readonly value: _angular_core.InputSignal<unknown>;
+    readonly enumOptions: _angular_core.InputSignal<unknown[]>;
+    readonly relationFields: _angular_core.InputSignal<FieldMetadata[]>;
+    readonly where: _angular_core.InputSignal<QueryBuilderRuleGroup<Record<string, unknown>> | undefined>;
+    readonly valueChange: _angular_core.OutputEmitterRef<unknown>;
+    readonly whereChange: _angular_core.OutputEmitterRef<QueryBuilderRuleGroup<Record<string, unknown>> | undefined>;
+    readonly errorMessage: _angular_core.InputSignal<string>;
+    readonly hasError: _angular_core.Signal<boolean>;
+    readonly valueChangeFn: _angular_core.InputSignal<((value: unknown) => void) | undefined>;
+    readonly whereChangeFn: _angular_core.InputSignal<((where: QueryBuilderRuleGroup<Record<string, unknown>> | undefined) => void) | undefined>;
+    /** 信号状态 —— 替代原先的可变类属性 */
+    readonly currentValue: _angular_core.WritableSignal<any>;
+    readonly rangeMin: _angular_core.WritableSignal<any>;
+    readonly rangeMax: _angular_core.WritableSignal<any>;
+    readonly arrayInputValue: _angular_core.WritableSignal<string>;
+    readonly currentDateStr: _angular_core.WritableSignal<string>;
+    readonly dateRangeStart: _angular_core.WritableSignal<string>;
+    readonly dateRangeEnd: _angular_core.WritableSignal<string>;
+    readonly inputType: _angular_core.Signal<string>;
+    readonly enumSelectOptions: _angular_core.Signal<{
+        value: string;
+        label: string;
+    }[]>;
+    constructor();
+    ngOnDestroy(): void;
+    ngOnInit(): void;
+    /** 通用值变更（string / boolean…） */
+    onValueChange(value: unknown): void;
+    /** UUID 值变更（带格式校验） */
+    onUuidChange(value: string): void;
+    /** 数字输入变更 */
+    onNumberInputChange(value: string): void;
+    /** 枚举多选变更 */
+    onEnumArrayChange(event: Event): void;
+    /** 枚举选项是否选中 */
+    isEnumSelected(opt: unknown): boolean;
+    /** 枚举值选中（来自 PopoverSelectComponent） */
+    onEnumSelect(value: string): void;
+    /** 原生日期输入变更 */
+    onNativeDateChange(value: string): void;
+    /** 日期范围起始变更 */
+    onDateRangeStartChange(value: string): void;
+    /** 日期范围结束变更 */
+    onDateRangeEndChange(value: string): void;
+    onDateRangePartChange(): void;
+    /** 范围最小值变更 */
+    onRangeMinChange(value: string): void;
+    /** 范围最大值变更 */
+    onRangeMaxChange(value: string): void;
+    onRangeChange(): void;
+    /** 数组输入值变更（逗号分隔字符串） */
+    onArrayInputChange(value: string): void;
+    handleWhereChange(where: {
+        combinator: 'and' | 'or';
+        rules: unknown[];
+    } | undefined): void;
+    private loadSubqueryComponent;
+    private destroySubqueryComponent;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<ValueInputComponent, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<ValueInputComponent, "rxdb-value-input", never, { "fieldType": { "alias": "fieldType"; "required": false; "isSignal": true; }; "operator": { "alias": "operator"; "required": false; "isSignal": true; }; "value": { "alias": "value"; "required": false; "isSignal": true; }; "enumOptions": { "alias": "enumOptions"; "required": false; "isSignal": true; }; "relationFields": { "alias": "relationFields"; "required": false; "isSignal": true; }; "where": { "alias": "where"; "required": false; "isSignal": true; }; "errorMessage": { "alias": "errorMessage"; "required": false; "isSignal": true; }; "valueChangeFn": { "alias": "valueChangeFn"; "required": false; "isSignal": true; }; "whereChangeFn": { "alias": "whereChangeFn"; "required": false; "isSignal": true; }; }, { "valueChange": "valueChange"; "whereChange": "whereChange"; }, never, never, true, never>;
+}
+
+/**
+ * QueryBuilder 主题接口
+ *
+ * @description
+ * 定义各 UI 插槽的组件类型，允许替换为不同的 UI 库实现
+ *
+ * 主题组件需遵循以下约定：
+ * - 接受标准 signal inputs（字段、操作符、值等）
+ * - 同时支持 output() 事件和可选的 onXxx 回调 input（供 NgComponentOutlet 使用）
+ */
+interface QueryBuilderTheme {
+    /** 字段选择器组件 */
+    fieldSelector: Type<unknown>;
+    /** 操作符选择器组件 */
+    operatorSelector: Type<unknown>;
+    /** 值输入组件 */
+    valueInput: Type<unknown>;
+}
+/**
+ * QueryBuilder 主题注入 Token
+ *
+ * @example
+ * ```typescript
+ * // 在应用根模块提供自定义主题
+ * providers: [provideQueryBuilderTheme(QUERY_BUILDER_XXX_THEME)]
+ * ```
+ */
+declare const QUERY_BUILDER_THEME: InjectionToken<QueryBuilderTheme>;
+/**
+ * 提供自定义主题
+ */
+declare function provideQueryBuilderTheme(theme: QueryBuilderTheme): Provider;
+
+/**
+ * 默认主题（原生 HTML 实现）
+ *
+ * @description
+ * 不依赖任何第三方 UI 库，使用标准 HTML 表单元素。
+ * 适合轻量级场景或作为自定义主题的参考实现。
+ *
+ * @example
+ * ```typescript
+ * // 默认主题无需额外配置，开箱即用
+ * imports: [QueryBuilderComponent]
+ * ```
+ */
+declare const DEFAULT_QUERY_BUILDER_THEME: QueryBuilderTheme;
+
+export { DEFAULT_QUERY_BUILDER_THEME, ENTITY_TABLE_CONFIG, EntityDetailComponent, EntityDialogComponent, EntityFormComponent, EntityListComponent, EntityTableComponent, FieldSelectorComponent, OperatorSelectorComponent, PopoverSelectComponent, QUERY_BUILDER_THEME, QueryBuilderComponent, QueryGroupComponent, QueryRuleComponent, QueryTableComponent, SubqueryBuilderComponent, TreeItemDirective, TreeSelectComponent, ValueInputComponent, provideQueryBuilderTheme };
+export type { EntityDetailDialogData, QueryBuilderTheme };