@aiao/rxdb-model-angular 0.0.19 → 0.0.28

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

@@ -1,146 +1,312 @@
-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>;
-};
+import { BatchChangeItem, CellChangeEvent, DetailTab, DetailTableTab, EntityFormData, EntityInstance, EntityTableConfig, EntityTableHandle, EntityTableRecord, FieldMetadata, FieldTreeNode, FilterQuery, FormFieldChangeEvent, FormFieldConfig, FormMode, FormValidationResult, QueryBuilderRuleGroup, QueryTableHandle, RelatedEntityItem, RelatedEntityProvider, RowMoveEvent, SchemaInfo, UIRule, ValidationError, ValidationResult, cn, findNodeByValue } from "@aiao/rxdb-model";
+import { EntityMetadata, RelationKind } from "@aiao/rxdb";
+import * as i0 from "@angular/core";
+import { AfterViewInit, ElementRef, InjectionToken, InputSignal, OnDestroy, OnInit, Provider, Signal, TemplateRef, Type, ViewContainerRef, WritableSignal } from "@angular/core";
+import * as i1 from "@angular/cdk/drag-drop";
+import { VersionManager } from "@aiao/rxdb-plugin-history";
+import { LucideChevronDown, LucideChevronRight, LucideFunnel, LucideIconInput, LucideRedo2, LucideType, LucideUndo2 } from "@lucide/angular";
+import * as VTable from "@visactor/vtable";
+import { ColumnsDefine, ListTable, ListTableConstructorOptions } from "@visactor/vtable";
+import { Highlightable } from "@angular/cdk/a11y";
+export * from "@aiao/rxdb-model";
 /** CDK Dialog 传入的数据结构 */
-interface EntityDetailDialogData {
-    metadata: EntityMetadata;
-    formFields: FormFieldConfig[];
-    formData: EntityFormData;
-    formMode: FormMode;
-    relatedEntityProvider?: RelatedEntityProvider;
-    /** 预填充的外键数据（不可编辑），用于级联新增场景 */
-    fixedFormData?: EntityFormData;
-    /** 委托保存：不创建草稿实体，仅 emit formSubmitted 让调用方处理 */
-    delegateSave?: boolean;
-    /** 创建链路中的实体类型（namespace:name），用于阻断循环创建 */
-    creationChain?: string[];
+export interface EntityDetailDialogData {
+  metadata: EntityMetadata;
+  formFields: FormFieldConfig[];
+  formData: EntityFormData;
+  formMode: FormMode;
+  /** 编辑模式：按 id 从 Repository 加载实体实例；缺省时表单数据为纯透传 */
+  entityId?: string;
+  /** 已打开详情对话框的记录 id 栈（含当前记录），关系 tab 列表据此阻断无限套娃 */
+  editChain?: string[];
+  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>;
+/**
+ * Tab 式实体详情组件：基础表单 Tab + 每个一对多/多对多关系一个表格 Tab；
+ * create 模式先生成内存草稿实体，校验通过并保存时才落库；
+ * edit 模式按 `entityId`（路由输入或 DIALOG_DATA）从 Repository 加载实例，保存时内部落库。
+ * 关系 Tab 内嵌的实体列表可继续打开子实体详情对话框（套娃），由 `editChain` 阻断环。
+ */
+export declare class EntityDetailComponent {
+  #private;
+  readonly namespace: InputSignal<string | undefined>;
+  readonly name: InputSignal<string | undefined>;
+  readonly entityId: InputSignal<string | undefined>;
+  /** 唯一的 radio group name，避免多个 EntityDetailComponent 实例之间的 radio 冲突 */
+  readonly tabGroupName: string;
+  readonly metadata: InputSignal<EntityMetadata | undefined>;
+  readonly formFields: InputSignal<FormFieldConfig[] | undefined>;
+  readonly formData: InputSignal<EntityFormData | undefined>;
+  readonly formMode: InputSignal<FormMode | undefined>;
+  readonly relatedEntityProvider: InputSignal<RelatedEntityProvider | undefined>;
+  /**
+   * 已打开详情对话框的记录 id 栈（含当前记录）的 input。
+   *
+   * @remarks 绑定名是 `editChain`，与 React / Vue 的同名 prop 对齐；同名类成员 `editChain`
+   * 是 input 与 DIALOG_DATA 合并后的有效值（main 起就公开），所以 input 以别名声明。
+   */
+  readonly editChainInput: InputSignal<string[] | undefined>;
+  /** 预填充的外键数据（不可编辑），用于级联新增场景 */
+  readonly fixedFormData: InputSignal<EntityFormData | undefined>;
+  /** 委托保存：不创建草稿实体，仅 emit formSubmitted 让调用方处理 */
+  readonly delegateSave: InputSignal<boolean | undefined>;
+  /**
+   * 祖先创建链路（实体类型 `namespace:name`）的 input，用于阻断循环创建。
+   *
+   * @remarks 绑定名是 `creationChain`，与 React / Vue 的同名 prop 对齐；同名类成员 `creationChain`
+   * 是追加了当前实体之后的有效链路（main 起就公开），所以 input 以别名声明。
+   */
+  readonly creationChainInput: InputSignal<string[] | undefined>;
+  readonly formSubmitted: import("@angular/core").OutputEmitterRef<EntityFormData>;
+  readonly formCancelled: import("@angular/core").OutputEmitterRef<void>;
+  readonly fieldChanged: import("@angular/core").OutputEmitterRef<FormFieldChangeEvent>;
+  readonly validationErrors: import("@angular/core").OutputEmitterRef<FormValidationResult>;
+  /** 是否使用外部保存模式（create 模式下，保存/取消按钮在 tabs 下面，而非 form 内） */
+  readonly isCreateMode: import("@angular/core").Signal<boolean>;
+  /** 当前表单编辑数据（create 模式下跟踪用户输入） */
+  readonly draftFormData: import("@angular/core").WritableSignal<EntityFormData>;
+  /** 暴露草稿实体给模板（关系 tab 的 entity-list 需要） */
+  readonly draftEntitySignal: import("@angular/core").WritableSignal<EntityInstance | null>;
+  /** 父实体（草稿或已保存实例），用于关系 tab 的 entity-list */
+  readonly parentEntityForRelation: import("@angular/core").Signal<EntityInstance | null>;
+  /** 弹框标题 */
+  readonly dialogTitle: import("@angular/core").Signal<string>;
+  /** 创建链路：当前实体 + 祖先链路，传递给子 entity-list 以阻断循环创建（祖先链路 input 优先，缺省回退 DIALOG_DATA） */
+  readonly creationChain: import("@angular/core").Signal<string[]>;
+  /** 已打开详情对话框的记录 id 栈（input 优先，缺省回退 DIALOG_DATA，含当前记录），关系 tab 列表据此阻断无限套娃 */
+  readonly editChain: import("@angular/core").Signal<string[]>;
+  /** 当前活动关系 tab 的 relationName（用于子实体注册关系） */
+  readonly activeRelationName: import("@angular/core").Signal<string | undefined>;
+  readonly tabs: import("@angular/core").Signal<DetailTab[]>;
+  readonly activeTabKey: import("@angular/core").WritableSignal<string>;
+  readonly activeTab: import("@angular/core").Signal<DetailTab | undefined>;
+  get metadataValue(): EntityMetadata;
+  get formFieldsValue(): FormFieldConfig[];
+  get formDataValue(): EntityFormData;
+  get formModeValue(): FormMode;
+  get relatedEntityProviderValue(): RelatedEntityProvider | undefined;
+  /** 预填充外键数据（input 优先，缺省回退 DIALOG_DATA） */
+  get fixedFormDataValue(): EntityFormData | undefined;
+  /** 是否委托保存（input 优先，缺省回退 DIALOG_DATA） */
+  get delegateSaveValue(): boolean;
+  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: i0.ɵɵFactoryDeclaration<EntityDetailComponent, never>;
+  static ɵcmp: i0.ɵɵ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;
+    };
+    "editChainInput": {
+      "alias": "editChain";
+      "required": false;
+      "isSignal": true;
+    };
+    "fixedFormData": {
+      "alias": "fixedFormData";
+      "required": false;
+      "isSignal": true;
+    };
+    "delegateSave": {
+      "alias": "delegateSave";
+      "required": false;
+      "isSignal": true;
+    };
+    "creationChainInput": {
+      "alias": "creationChain";
+      "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: {}; }]>;
+/**
+ * 对话框外壳组件（CDK Dialog 内使用）：支持拖拽（CdkDrag）、8 向缩放与全屏切换。
+ */
+export declare class EntityDialogComponent implements AfterViewInit {
+  #private;
+  readonly title: import("@angular/core").InputSignal<string>;
+  readonly closeRequested: import("@angular/core").OutputEmitterRef<void>;
+  readonly isFullscreen: import("@angular/core").WritableSignal<boolean>;
+  readonly isInDialog: boolean;
+  constructor();
+  ngAfterViewInit(): void;
+  close(): void;
+  toggleFullscreen(): void;
+  startResize(e: MouseEvent, dir: string): void;
+  static ɵfac: i0.ɵɵFactoryDeclaration<EntityDialogComponent, never>;
+  static ɵcmp: i0.ɵɵ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>;
+/**
+ * 元数据驱动表单组件：按字段类型渲染对应输入控件，支持 create / edit / view 三模式；
+ * 解析、格式化与校验全部委托 @aiao/rxdb-model。
+ */
+export declare class EntityFormComponent {
+  readonly fields: import("@angular/core").InputSignal<FormFieldConfig[]>;
+  readonly data: import("@angular/core").InputSignal<EntityFormData>;
+  readonly mode: import("@angular/core").InputSignal<FormMode>;
+  readonly relatedEntityProvider: import("@angular/core").InputSignal<RelatedEntityProvider | undefined>;
+  readonly showActions: import("@angular/core").InputSignal<boolean>;
+  readonly fieldChanged: import("@angular/core").OutputEmitterRef<FormFieldChangeEvent>;
+  readonly formSubmitted: import("@angular/core").OutputEmitterRef<EntityFormData>;
+  readonly formCancelled: import("@angular/core").OutputEmitterRef<void>;
+  readonly validationErrors: import("@angular/core").OutputEmitterRef<FormValidationResult>;
+  readonly initialData: import("@angular/core").WritableSignal<{
+    [field: string]: unknown;
+  }>;
+  readonly formData: import("@angular/core").WritableSignal<{
+    [field: string]: unknown;
+  }>;
+  readonly editableFields: import("@angular/core").Signal<FormFieldConfig[]>;
+  readonly isReadonly: import("@angular/core").Signal<boolean>;
+  readonly relatedItemsMap: import("@angular/core").Signal<Map<string, RelatedEntityItem[]>>;
+  readonly displayValueMap: import("@angular/core").Signal<Map<string, string>>;
+  onFieldChange(field: FormFieldConfig, rawValue: unknown): void;
+  onSubmit(): void;
+  onCancel(): void;
+  isFieldReadonly(field: FormFieldConfig): boolean;
+  /** 占据两列栅格的字段：json / keyValue / binary / 多行文本类 format / 显式 span */
+  isWideField(field: FormFieldConfig): boolean;
+  /** 多行文本类 format：渲染 textarea */
+  isTextareaFormat(field: FormFieldConfig): boolean;
+  /** dateTime format 的显示模式映射到原生输入类型 */
+  dateInputType(field: FormFieldConfig): 'date' | 'datetime-local' | 'time';
+  /** dateTime format 的显示模式映射到 DatePipe 格式 */
+  datePipeFormat(field: FormFieldConfig): string;
+  /** 数字类 format 的值域约束（min / max / step） */
+  numericBounds(field: FormFieldConfig): {
+    min?: number;
+    max?: number;
+    step?: number;
+  };
+  /** 数字类 format 的单位标注（currency 代码 / 百分号 / 时长单位） */
+  numericUnitLabel(field: FormFieldConfig): string;
+  /** enum / 多选值的展示 label（无 options 时退回原值） */
+  enumOptionLabel(field: FormFieldConfig, value: string): string;
+  /** options 中声明 disabled 的值不可选 */
+  enumOptionDisabled(field: FormFieldConfig, value: string): boolean;
+  /** 字符串 format 映射到原生输入类型 */
+  textInputType(field: FormFieldConfig): string;
+  /** 取色器回显值：非法或空值退回黑色 */
+  colorValue(field: FormFieldConfig): string;
+  /** 字节序列回显为 hex 字符串 */
+  binaryToHex(value: unknown): string;
+  /** 复选组的当前选中状态（支持数组与逗号字符串两种存储形态） */
+  multiSelected(field: FormFieldConfig, value: string): boolean;
+  /** 复选组切换：合并出新数组后走统一解析链路 */
+  onMultiSelectChange(field: FormFieldConfig, value: string, checked: boolean): void;
+  static ɵfac: i0.ɵɵFactoryDeclaration<EntityFormComponent, never>;
+  static ɵcmp: i0.ɵɵ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>;
+}
+declare module '@aiao/rxdb' {
+  interface RxDB {
+    versionManager: VersionManager;
+  }
 }
-
-/** RxDB 实体实例（用于 CRUD 操作） */
-type EntityInstance = {
-    [key: string]: unknown;
-    readonly id: string;
-    save(): Promise<void>;
-    remove(): Promise<void>;
-};
-type FilterQuery = {
-    combinator: 'and' | 'or';
-    rules: unknown[];
-};
 /**
  * 实体列表组件
  *
@@ -152,110 +318,204 @@ type FilterQuery = {
  * <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>;
+export declare class EntityListComponent {
+  #private;
+  /** 内部查询表格：拖放被拒或落库失败时恢复行序 */
+  private readonly queryTable;
+  protected readonly Undo2: typeof LucideUndo2;
+  protected readonly Redo2: typeof LucideRedo2;
+  protected readonly Funnel: typeof LucideFunnel;
+  protected readonly listTableOptions: Partial<ListTableConstructorOptions>;
+  /** 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: import("@angular/core").Signal<(() => void) | undefined>;
+  readonly namespace: import("@angular/core").InputSignal<string>;
+  readonly name: import("@angular/core").InputSignal<string>;
+  /** 固定查询条件，与用户筛选条件做 AND 合并（用于关系属性过滤，如 ownerId = currentId） */
+  readonly fixedQuery: import("@angular/core").InputSignal<FilterQuery | undefined>;
+  /** 外部导航传入的初始筛选条件（JSON 字符串），如 Query Builder「应用到实体浏览」 */
+  readonly initialFilter: import("@angular/core").InputSignal<string | undefined>;
+  /** 预填充的外键数据（级联新增时传递给子实体对话框） */
+  readonly fixedFormData: import("@angular/core").InputSignal<EntityFormData | undefined>;
+  /** 草稿父实体（用于级联新增场景，子实体通过关系API注册到父实体） */
+  readonly draftParentEntity: import("@angular/core").InputSignal<EntityInstance | null>;
+  /** 父实体上关系属性名（如 'children'），用于调用 parent.children$.add(child) */
+  readonly parentRelationName: import("@angular/core").InputSignal<string | undefined>;
+  /** 创建链路中的实体类型（namespace:name），用于阻断循环创建 */
+  readonly creationChain: import("@angular/core").InputSignal<string[]>;
+  /** 已打开详情对话框的记录 id 栈（含祖先记录），「查看」前检查以防无限套娃 */
+  readonly editChain: import("@angular/core").InputSignal<string[]>;
+  /** 关系类型（MANY_TO_MANY 时启用选择模式） */
+  readonly relationKind: import("@angular/core").InputSignal<RelationKind | undefined>;
+  /** 父实体实例（用于 M2M 关系操作，包含 draft 和已保存实体） */
+  readonly parentEntity: import("@angular/core").InputSignal<EntityInstance | null>;
+  /** 列表模式：default=普通列表, select=选择模式（带 checkbox 列） */
+  readonly mode: import("@angular/core").InputSignal<"select" | "default">;
+  /** 已关联的实体 ID 集合（选择模式下过滤掉，不再展示） */
+  readonly alreadyLinkedIds: import("@angular/core").InputSignal<Set<string>>;
+  /** 点击「查看」按钮时触发，携带对应行记录；组件同时打开内置编辑对话框（记录已在 editChain 中或为未保存草稿时仅 emit） */
+  readonly viewEntity: import("@angular/core").OutputEmitterRef<EntityTableRecord>;
+  /** 选择模式：确认选择时触发，携带选中的实体实例 */
+  readonly selectionConfirmed: import("@angular/core").OutputEmitterRef<EntityInstance[]>;
+  /** 选择模式：取消选择时触发 */
+  readonly selectionCancelled: import("@angular/core").OutputEmitterRef<void>;
+  readonly filterQuery: WritableSignal<FilterQuery>;
+  readonly $isFilterQuery: import("@angular/core").Signal<boolean>;
+  readonly showFilterPopover: WritableSignal<boolean>;
+  readonly pendingQuery: WritableSignal<FilterQuery>;
+  readonly pendingQueryValid: WritableSignal<boolean>;
+  readonly isBrowser: boolean;
+  readonly displayName: import("@angular/core").Signal<string>;
+  /** 当前实体不接受从列表新增：`create` 只许系统写，或已在祖先创建链路中（循环创建检测） */
+  readonly isCreateBlocked: import("@angular/core").Signal<boolean>;
+  readonly isQueryActive: import("@angular/core").Signal<boolean>;
+  readonly filteredCount: import("@angular/core").Signal<number>;
+  readonly isInitialLoading: import("@angular/core").Signal<boolean>;
+  readonly isLoadingMore: import("@angular/core").Signal<boolean>;
+  readonly undoCount: import("@angular/core").Signal<number>;
+  readonly redoCount: import("@angular/core").Signal<number>;
+  readonly canUndo: import("@angular/core").Signal<boolean>;
+  readonly canRedo: import("@angular/core").Signal<boolean>;
+  readonly queryBuilderFields: import("@angular/core").Signal<FieldMetadata[]>;
+  readonly tableRecords: import("@angular/core").Signal<EntityTableRecord[]>;
+  readonly tableColumns: import("@angular/core").Signal<ColumnsDefine>;
+  readonly createFormFieldConfigs: import("@angular/core").Signal<FormFieldConfig[]>;
+  readonly isSelectMode: import("@angular/core").Signal<boolean>;
+  readonly isM2m: import("@angular/core").Signal<boolean>;
+  readonly m2mSelectTpl: import("@angular/core").Signal<TemplateRef<void> | undefined>;
+  /** 最近一次拖放排序落库失败的提示；`null` 为无错误 */
+  readonly reorderError: WritableSignal<string | null>;
+  /** 当前列表是否允许拖放排序（行拖动手柄是否显示） */
+  readonly rowDragEnabled: import("@angular/core").Signal<boolean>;
+  readonly selectedIds: WritableSignal<Set<string>>;
+  readonly selectedCount: import("@angular/core").Signal<number>;
+  readonly m2mAlreadyLinkedIds: import("@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(): Promise<void>;
+  openM2mSelectDialog(): void;
+  onM2mSelectionConfirmed(entities: EntityInstance[]): void;
+  m2mCancelSelection(): void;
+  confirmSelection(): void;
+  cancelSelection(): void;
+  /**
+   * 单行拖放：允许时按界面上的邻居落库重排，不允许或失败时把表格恢复原顺序（US-028）。
+   */
+  onRowMoved(move: RowMoveEvent): void;
+  /**
+   * 列头排序点击：驱动 cursor orderBy 重查（VTable 客户端排序已禁用）。
+   */
+  onSortClicked(event: {
+    field: unknown;
+    order: unknown;
+  }): void;
+  static ɵfac: i0.ɵɵFactoryDeclaration<EntityListComponent, never>;
+  static ɵcmp: i0.ɵɵ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;
+    };
+    "initialFilter": {
+      "alias": "initialFilter";
+      "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;
+    };
+    "editChain": {
+      "alias": "editChain";
+      "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>;
-
+/**
+ * 实体表格配置注入令牌
+ * 用于在 Angular 应用中注入全局实体表格配置
+ */
+export declare const ENTITY_TABLE_CONFIG: InjectionToken<EntityTableConfig>;
 /**
  * 通用实体数据表格组件
  *
@@ -267,51 +527,131 @@ declare const ENTITY_TABLE_CONFIG: InjectionToken<EntityTableConfig>;
  * - 主题系统（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>;
+export declare class EntityTableComponent implements OnDestroy, EntityTableHandle {
+  #private;
+  readonly tableContainer: import("@angular/core").Signal<ElementRef<HTMLDivElement> | undefined>;
+  readonly records: import("@angular/core").InputSignal<EntityTableRecord[]>;
+  readonly columns: import("@angular/core").InputSignal<VTable.TYPES.ColumnsDefine | undefined>;
+  readonly isDarkMode: import("@angular/core").InputSignal<boolean | undefined>;
+  readonly idField: import("@angular/core").InputSignal<string>;
+  readonly nonClearableFields: import("@angular/core").InputSignal<ReadonlySet<string>>;
+  readonly tableOptions: import("@angular/core").InputSignal<Partial<ListTableConstructorOptions> | undefined>;
+  readonly cellErrorDetector: import("@angular/core").InputSignal<((record: EntityTableRecord, field: string) => string | null) | undefined>;
+  readonly loading: import("@angular/core").InputSignal<boolean>;
+  /** 业务层回调判断单元格是否可清空（返回 false 跳过），替代领域特定的硬编码逻辑 */
+  readonly cellClearable: import("@angular/core").InputSignal<((record: Record<string, unknown>, field: string) => boolean) | undefined>;
+  /** 触底时加载更多数据的回调，由表格内部在滚动到底部时调用 */
+  readonly loadMore: import("@angular/core").InputSignal<(() => void) | undefined>;
+  /** 加载更多中状态（已有数据，底部小 spinner，不拦截滚动） */
+  readonly loadingMore: import("@angular/core").InputSignal<boolean>;
+  /** 是否显示行拖动手柄，缺省 `true`；运行时切换即时生效（建表需开启 `rowSeriesNumber.dragOrder`） */
+  readonly rowDragEnabled: import("@angular/core").InputSignal<boolean>;
+  readonly cellChanged: import("@angular/core").OutputEmitterRef<CellChangeEvent>;
+  readonly rowDeleted: import("@angular/core").OutputEmitterRef<EntityTableRecord>;
+  readonly iconClicked: import("@angular/core").OutputEmitterRef<{
+    name: string;
+    record: EntityTableRecord;
+  }>;
+  readonly batchUpdated: import("@angular/core").OutputEmitterRef<BatchChangeItem[]>;
+  readonly rowReordered: import("@angular/core").OutputEmitterRef<string[]>;
+  /** 单行拖放：被拖行与落点前后邻居（US-028） */
+  readonly rowMoved: import("@angular/core").OutputEmitterRef<RowMoveEvent>;
+  readonly scrollNearBottom: import("@angular/core").OutputEmitterRef<void>;
+  /** 列头排序点击；业务层接管查询排序，表格不执行客户端排序 */
+  readonly sortClicked: import("@angular/core").OutputEmitterRef<{
+    field: unknown;
+    order: unknown;
+  }>;
+  readonly cellTooltip: import("@angular/core").WritableSignal<{
+    x: number;
+    y: number;
+    content: string;
+  } | null>;
+  readonly headerHeight: import("@angular/core").WritableSignal<number>;
+  get tableInstance(): VTable.ListTable | null;
+  constructor();
+  /**
+   * 从业务层回滚单元格值（校验失败时恢复原值）。
+   * 避免外部直接访问 tableInstance。
+   */
+  changeCellValue(col: number, row: number, value: unknown): void;
+  redrawTheme(): void;
+  /** 把行恢复成最近一次交给表格的顺序（拖放被拒或落库失败时调用）。 */
+  restoreRecords(): void;
+  ngOnDestroy(): void;
+  static ɵfac: i0.ɵɵFactoryDeclaration<EntityTableComponent, never>;
+  static ɵcmp: i0.ɵɵ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;
+    };
+    "rowDragEnabled": {
+      "alias": "rowDragEnabled";
+      "required": false;
+      "isSignal": true;
+    };
+  }, {
+    "cellChanged": "cellChanged";
+    "rowDeleted": "rowDeleted";
+    "iconClicked": "iconClicked";
+    "batchUpdated": "batchUpdated";
+    "rowReordered": "rowReordered";
+    "rowMoved": "rowMoved";
+    "scrollNearBottom": "scrollNearBottom";
+    "sortClicked": "sortClicked";
+  }, never, ["[emptyState]"], true, never>;
 }
-
 /**
  * 集成查询构建器的实体表格组件
  *
@@ -328,73 +668,169 @@ declare class EntityTableComponent implements OnDestroy {
  * </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>;
+export declare class QueryTableComponent implements QueryTableHandle {
+  readonly records: import("@angular/core").InputSignal<EntityTableRecord[]>;
+  readonly columns: import("@angular/core").InputSignal<import("@visactor/vtable").ColumnsDefine | undefined>;
+  readonly idField: import("@angular/core").InputSignal<string>;
+  readonly nonClearableFields: import("@angular/core").InputSignal<ReadonlySet<string>>;
+  readonly tableOptions: import("@angular/core").InputSignal<Partial<ListTableConstructorOptions> | undefined>;
+  readonly cellErrorDetector: import("@angular/core").InputSignal<((record: EntityTableRecord, field: string) => string | null) | undefined>;
+  readonly isDarkMode: import("@angular/core").InputSignal<boolean | undefined>;
+  /** 业务层回调判断单元格是否可清空 */
+  readonly cellClearable: import("@angular/core").InputSignal<((record: Record<string, unknown>, field: string) => boolean) | undefined>;
+  /** 查询条件是否激活（显示筛选状态标签） */
+  readonly queryActive: import("@angular/core").InputSignal<boolean>;
+  /** 结果总数（显示在筛选状态栏中） */
+  readonly totalCount: import("@angular/core").InputSignal<number | undefined>;
+  /** 筛选后结果数 */
+  readonly filteredCount: import("@angular/core").InputSignal<number | undefined>;
+  /** 是否显示加载状态 */
+  readonly loading: import("@angular/core").InputSignal<boolean>;
+  /** 加载更多中（已有数据，底部小 spinner，不拦截滚动） */
+  readonly loadingMore: import("@angular/core").InputSignal<boolean>;
+  /** 触底时加载更多数据的回调，透传给 EntityTableComponent */
+  readonly loadMore: import("@angular/core").InputSignal<(() => void) | undefined>;
+  /** 是否显示行拖动手柄，缺省 `true`，透传给 EntityTableComponent */
+  readonly rowDragEnabled: import("@angular/core").InputSignal<boolean>;
+  readonly cellChanged: import("@angular/core").OutputEmitterRef<CellChangeEvent>;
+  readonly rowDeleted: import("@angular/core").OutputEmitterRef<EntityTableRecord>;
+  readonly iconClicked: import("@angular/core").OutputEmitterRef<{
+    name: string;
+    record: EntityTableRecord;
+  }>;
+  readonly batchUpdated: import("@angular/core").OutputEmitterRef<BatchChangeItem[]>;
+  readonly rowReordered: import("@angular/core").OutputEmitterRef<string[]>;
+  /** 单行拖放：被拖行与落点前后邻居 */
+  readonly rowMoved: import("@angular/core").OutputEmitterRef<RowMoveEvent>;
+  readonly scrollNearBottom: import("@angular/core").OutputEmitterRef<void>;
+  readonly sortClicked: import("@angular/core").OutputEmitterRef<{
+    field: unknown;
+    order: unknown;
+  }>;
+  readonly entityTable: import("@angular/core").Signal<EntityTableComponent | undefined>;
+  readonly statusText: import("@angular/core").Signal<string>;
+  get tableInstance(): ListTable | null;
+  changeCellValue(col: number, row: number, value: unknown): void;
+  redrawTheme(): void;
+  /** 把行恢复成最近一次交给表格的顺序（委托给内部实体表格） */
+  restoreRecords(): void;
+  static ɵfac: i0.ɵɵFactoryDeclaration<QueryTableComponent, never>;
+  static ɵcmp: i0.ɵɵ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;
+    };
+    "rowDragEnabled": {
+      "alias": "rowDragEnabled";
+      "required": false;
+      "isSignal": true;
+    };
+  }, {
+    "cellChanged": "cellChanged";
+    "rowDeleted": "rowDeleted";
+    "iconClicked": "iconClicked";
+    "batchUpdated": "batchUpdated";
+    "rowReordered": "rowReordered";
+    "rowMoved": "rowMoved";
+    "scrollNearBottom": "scrollNearBottom";
+    "sortClicked": "sortClicked";
+  }, never, ["[filterBar]", "[emptyState]"], true, never>;
 }
-
 /**
  * UI 规则组（宽松类型）
  */
 interface UIRuleGroup {
-    id: string;
-    combinator: 'and' | 'or';
-    rules: Array<UIRule | 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;
+  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;
+export declare class QueryDragDropHandler {
+  private readonly moveItemFn;
+  readonly state: import("@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;
 }
+/** 按 clientY 与目标矩形计算放置模式（组模式支持 into）。 */
+export declare function calculateDropMode(clientY: number, rect: DOMRect, isGroup: boolean): QueryDropMode;
 /**
  * 查询规则组组件（递归）
  *
@@ -405,80 +841,123 @@ declare class QueryDragDropHandler {
  * - 删除组
  * - 递归嵌套显示
  */
-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>;
+export declare class QueryGroupComponent {
+  readonly group: import("@angular/core").InputSignal<UIRuleGroup>;
+  readonly fields: import("@angular/core").InputSignal<FieldMetadata[]>;
+  readonly errors: import("@angular/core").InputSignal<ValidationError[]>;
+  readonly depth: import("@angular/core").InputSignal<number>;
+  readonly maxDepth: import("@angular/core").InputSignal<number>;
+  readonly dragDropHandler: import("@angular/core").InputSignal<QueryDragDropHandler | undefined>;
+  /** 是否允许展开/收起组（默认开启） */
+  readonly allowCollapse: import("@angular/core").InputSignal<boolean>;
+  readonly addRule: import("@angular/core").OutputEmitterRef<{
+    parentId: string;
+    rule: Omit<UIRule, "id">;
+  }>;
+  readonly addGroup: import("@angular/core").OutputEmitterRef<string>;
+  readonly removeItem: import("@angular/core").OutputEmitterRef<string>;
+  readonly updateRule: import("@angular/core").OutputEmitterRef<{
+    id: string;
+    updates: Partial<UIRule>;
+  }>;
+  readonly updateCombinator: import("@angular/core").OutputEmitterRef<{
+    id: string;
+    combinator: "and" | "or";
+  }>;
+  /** 当前组是否已折叠 */
+  readonly collapsed: import("@angular/core").WritableSignal<boolean>;
+  /** 是否可以添加子组（未达到最大深度） */
+  readonly canAddGroup: import("@angular/core").Signal<boolean>;
+  /** 达到嵌套上限时展示给用户的原因（AC 要求「超过提示」，不能静默） */
+  readonly nestingLimitHint: import("@angular/core").Signal<string>;
+  /** 切换折叠状态 */
+  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: i0.ɵɵFactoryDeclaration<QueryGroupComponent, never>;
+  static ɵcmp: i0.ɵɵ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;
-    }>;
+  combinator: 'and' | 'or';
+  rules: Array<RxDBQueryOutput<T> | {
+    field: keyof T & string;
+    operator: string;
+    value: unknown;
+  }>;
 }
 /**
  * Angular Query Builder 主组件
@@ -498,93 +977,131 @@ interface RxDBQueryOutput<T> {
  * />
  * ```
  */
-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>;
+export 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: import("@angular/core").InputSignal<SchemaInfo | undefined>;
+  /**
+   * 字段列表（直接传入，优先于 schema）
+   */
+  readonly fields: import("@angular/core").InputSignal<FieldMetadata[]>;
+  /**
+   * 初始查询条件（可选）
+   */
+  readonly initialQuery: import("@angular/core").InputSignal<RxDBQueryOutput<T> | undefined>;
+  /**
+   * 最大嵌套层级（默认 5）
+   */
+  readonly maxDepth: import("@angular/core").InputSignal<number>;
+  /**
+   * 内容区域最大高度（超出后滚动），支持任意 CSS 长度值，如 `'400px'`、`'50vh'`
+   */
+  readonly height: import("@angular/core").InputSignal<string>;
+  /**
+   * 是否开启拖拽排序功能（默认开启）
+   */
+  readonly enableDrag: import("@angular/core").InputSignal<boolean>;
+  /**
+   * 是否开启分组展开/收起功能（默认开启）
+   */
+  readonly enableCollapse: import("@angular/core").InputSignal<boolean>;
+  readonly dragDropHandler: QueryDragDropHandler;
+  /**
+   * 查询条件变更事件
+   */
+  readonly queryChange: import("@angular/core").OutputEmitterRef<RxDBQueryOutput<T>>;
+  /**
+   * 验证状态变更事件
+   */
+  readonly validationChange: import("@angular/core").OutputEmitterRef<ValidationResult>;
+  /** 计算后的字段列表 */
+  readonly fieldsComputed: Signal<FieldMetadata[]>;
+  /** 根规则组 */
+  readonly rootGroup: Signal<UIRuleGroup | undefined>;
+  /** 验证错误列表 */
+  readonly validationErrors: Signal<import("@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: i0.ɵɵFactoryDeclaration<QueryBuilderComponent<any>, never>;
+  static ɵcmp: i0.ɵɵ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>;
 }
-
 /**
  * 字段选择器组件
  *
@@ -597,20 +1114,42 @@ declare class QueryBuilderComponent<T extends object> implements OnDestroy {
  * 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>;
+export declare class FieldSelectorComponent {
+  readonly fields: import("@angular/core").InputSignal<FieldMetadata[]>;
+  readonly selectedField: import("@angular/core").InputSignal<string>;
+  readonly placeholder: import("@angular/core").InputSignal<string>;
+  /** 通过 NgComponentOutlet 注入时使用的回调 input */
+  readonly fieldChangeFn: import("@angular/core").InputSignal<((field: string) => void) | undefined>;
+  /** 直接模板使用时的 output 事件 */
+  readonly fieldChange: import("@angular/core").OutputEmitterRef<string>;
+  readonly fieldTree: import("@angular/core").Signal<import("@aiao/rxdb-model").FieldTreeNode[]>;
+  onSelect(field: string): void;
+  static ɵfac: i0.ɵɵFactoryDeclaration<FieldSelectorComponent, never>;
+  static ɵcmp: i0.ɵɵ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>;
 }
-
 /**
  * 操作符选择器组件
  *
@@ -623,24 +1162,46 @@ declare class FieldSelectorComponent {
  * 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>;
+export declare class OperatorSelectorComponent {
+  private readonly registry;
+  readonly operatorOptions: import("@angular/core").Signal<{
+    value: import("@aiao/rxdb").OperatorName;
+    label: string;
+  }[]>;
+  readonly fieldMetadata: import("@angular/core").InputSignal<FieldMetadata | undefined>;
+  readonly fieldType: import("@angular/core").InputSignal<string>;
+  readonly selectedOperator: import("@angular/core").InputSignal<string>;
+  /** 通过 NgComponentOutlet 注入时使用的回调 input */
+  readonly operatorChangeFn: import("@angular/core").InputSignal<((op: string) => void) | undefined>;
+  /** 直接模板使用时的 output 事件 */
+  readonly operatorChange: import("@angular/core").OutputEmitterRef<string>;
+  onOperatorChange(op: string): void;
+  static ɵfac: i0.ɵɵFactoryDeclaration<OperatorSelectorComponent, never>;
+  static ɵcmp: i0.ɵɵ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 的下拉选择组件
  *
@@ -650,43 +1211,65 @@ declare class OperatorSelectorComponent {
  * 支持关键字过滤、键盘导航（↑↓ 移动、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>;
+export declare class PopoverSelectComponent {
+  private readonly trigger;
+  private readonly popoverEl;
+  private readonly filterInput;
+  protected readonly uid: string;
+  protected readonly listId: string;
+  protected readonly filterText: import("@angular/core").WritableSignal<string>;
+  protected readonly activeIndex: import("@angular/core").WritableSignal<number>;
+  readonly options: import("@angular/core").InputSignal<readonly {
+    value: string;
+    label: string;
+  }[]>;
+  readonly selected: import("@angular/core").InputSignal<string>;
+  readonly placeholder: import("@angular/core").InputSignal<string>;
+  readonly minWidth: import("@angular/core").InputSignal<string>;
+  readonly selectChange: import("@angular/core").OutputEmitterRef<string>;
+  readonly currentLabel: import("@angular/core").Signal<string>;
+  readonly filteredOptions: import("@angular/core").Signal<readonly {
+    value: string;
+    label: string;
+  }[]>;
+  readonly activeItemId: import("@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: i0.ɵɵFactoryDeclaration<PopoverSelectComponent, never>;
+  static ɵcmp: i0.ɵɵ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>>;
+  where?: QueryBuilderRuleGroup<Record<string, unknown>>;
 };
 /**
  * 单条查询规则组件
@@ -698,85 +1281,103 @@ type UIRuleWithWhere = UIRule & {
  * - 值输入框
  * - 删除按钮
  */
-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>;
+export declare class QueryRuleComponent {
+  private readonly existsOperators;
+  private readonly noValueOperators;
+  /** 注入的主题（回退到默认主题） */
+  protected readonly theme: import("@aiao/rxdb-model-angular").QueryBuilderTheme;
+  readonly rule: import("@angular/core").InputSignal<UIRuleWithWhere>;
+  readonly fields: import("@angular/core").InputSignal<FieldMetadata[]>;
+  readonly errors: import("@angular/core").InputSignal<ValidationError[]>;
+  readonly update: import("@angular/core").OutputEmitterRef<{
+    id: string;
+    updates: Partial<UIRuleWithWhere>;
+  }>;
+  readonly remove: import("@angular/core").OutputEmitterRef<void>;
+  readonly fieldAsString: import("@angular/core").Signal<string>;
+  readonly ruleErrors: import("@angular/core").Signal<ValidationError[]>;
+  readonly errorTooltip: import("@angular/core").Signal<string>;
+  readonly isExistsOperator: import("@angular/core").Signal<boolean>;
+  readonly isNoValueOperator: import("@angular/core").Signal<boolean>;
+  /** 子查询面板是否展开（已有 where 规则时自动展开） */
+  readonly showSubquery: import("@angular/core").WritableSignal<boolean>;
+  /**
+   * 当规则的 where 已有内容时自动展开。
+   * 使用 computed 包装监听 rule().where，在显示按钮前检查。
+   */
+  readonly subqueryVisible: import("@angular/core").Signal<boolean>;
+  readonly currentField: import("@angular/core").Signal<FieldMetadata | undefined>;
+  readonly currentFieldType: import("@angular/core").Signal<import("@aiao/rxdb-model").PropertyType>;
+  readonly currentEnumOptions: import("@angular/core").Signal<unknown[]>;
+  /** 当前字段的关系目标实体字段列表 */
+  readonly currentRelationFields: import("@angular/core").Signal<FieldMetadata[]>;
+  /** 规则的 where 子查询 */
+  readonly ruleWhere: import("@angular/core").Signal<QueryBuilderRuleGroup<Record<string, unknown>> | undefined>;
+  /** NgComponentOutlet inputs：字段选择器（fieldChangeCb 是 lazy 引用，声明顺序不影响运行时）*/
+  readonly fieldSelectorInputs: import("@angular/core").Signal<{
+    fields: FieldMetadata[];
+    selectedField: string;
+    fieldChangeFn: (field: string) => void;
+  }>;
+  /** NgComponentOutlet inputs：操作符选择器 */
+  readonly operatorSelectorInputs: import("@angular/core").Signal<{
+    fieldMetadata: FieldMetadata | undefined;
+    fieldType: import("@aiao/rxdb-model").PropertyType;
+    selectedOperator: string;
+    operatorChangeFn: (op: string) => void;
+  }>;
+  /** NgComponentOutlet inputs：值输入 */
+  readonly valueInputInputs: import("@angular/core").Signal<{
+    fieldType: import("@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: i0.ɵɵFactoryDeclaration<QueryRuleComponent, never>;
+  static ɵcmp: i0.ɵɵ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>;
 }
-
 /**
  * 子查询构建器组件
  *
@@ -787,67 +1388,85 @@ declare class QueryRuleComponent {
  * - 嵌套规则组
  * - 清空子条件
  */
-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>;
+export declare class SubqueryBuilderComponent implements OnDestroy {
+  private readonly service;
+  /** initialQuery 是否已应用（只应用一次） */
+  private initialQueryApplied;
+  /** 根规则组 Signal */
+  private readonly rootGroupSignal;
+  /** 验证 Signal */
+  private readonly validationSignal;
+  /** 字段列表 */
+  readonly fields: import("@angular/core").InputSignal<FieldMetadata[]>;
+  /** 初始查询 */
+  readonly initialQuery: import("@angular/core").InputSignal<QueryBuilderRuleGroup<Record<string, unknown>> | undefined>;
+  /** 最大嵌套层级 */
+  readonly maxDepth: import("@angular/core").InputSignal<number>;
+  /** 查询变更事件 */
+  readonly queryChange: import("@angular/core").OutputEmitterRef<{
+    combinator: "and" | "or";
+    rules: unknown[];
+  } | undefined>;
+  /** 验证变更事件 */
+  readonly validationChange: import("@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: i0.ɵɵFactoryDeclaration<SubqueryBuilderComponent, never>;
+  static ɵcmp: i0.ɵɵ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;
+  node: FieldTreeNode;
+  depth: number;
+  isExpandable: boolean;
+  isExpanded: boolean;
 }
 /**
  * 树节点 Directive，实现 CDK {@link Highlightable} 接口
@@ -855,13 +1474,13 @@ interface FlatItem {
  * 用于 {@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>;
+export declare class TreeItemDirective implements Highlightable {
+  private readonly _active;
+  readonly isActive: import("@angular/core").Signal<boolean>;
+  setActiveStyles(): void;
+  setInactiveStyles(): void;
+  static ɵfac: i0.ɵɵFactoryDeclaration<TreeItemDirective, never>;
+  static ɵdir: i0.ɵɵDirectiveDeclaration<TreeItemDirective, "[rxdbTreeItem]", ["rxdbTreeItem"], {}, {}, never, never, true, never>;
 }
 /**
  * 树形下拉选择组件
@@ -884,45 +1503,67 @@ declare class TreeItemDirective implements Highlightable {
  * />
  * ```
  */
-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>;
+export 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: import("@angular/core").WritableSignal<string>;
+  protected readonly ChevronDownIcon: typeof LucideChevronDown;
+  protected readonly ChevronRightIcon: typeof LucideChevronRight;
+  protected readonly typeIconMap: Partial<Record<string, LucideIconInput>>;
+  protected readonly typeColorMap: Partial<Record<string, string>>;
+  protected readonly defaultTypeIcon: typeof LucideType;
+  protected readonly defaultTypeColor = "text-base-content/40";
+  readonly nodes: import("@angular/core").InputSignal<FieldTreeNode[]>;
+  readonly selected: import("@angular/core").InputSignal<string>;
+  readonly placeholder: import("@angular/core").InputSignal<string>;
+  readonly minWidth: import("@angular/core").InputSignal<string>;
+  readonly selectChange: import("@angular/core").OutputEmitterRef<string>;
+  readonly displayValue: import("@angular/core").Signal<string>;
+  readonly selectedNode: import("@angular/core").Signal<FieldTreeNode | null | undefined>;
+  readonly visibleItems: import("@angular/core").Signal<FlatItem[]>;
+  readonly activeItemId: import("@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: i0.ɵɵFactoryDeclaration<TreeSelectComponent, never>;
+  static ɵcmp: i0.ɵɵ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>;
 }
-
 /**
  * 值输入组件
  *
@@ -938,79 +1579,127 @@ declare class TreeSelectComponent {
  * - 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>;
+export declare class ValueInputComponent implements OnInit, OnDestroy {
+  private previousInputType;
+  private subqueryComponentRef?;
+  private subquerySubscription?;
+  private subqueryLoading;
+  private readonly injector;
+  /** UUID 格式校验错误（基于 currentValue 派生，inputType 不是 uuid 时自动为空） */
+  readonly uuidError: import("@angular/core").Signal<"" | "请输入合法的 UUID 格式">;
+  subqueryContainer?: ViewContainerRef;
+  readonly fieldType: import("@angular/core").InputSignal<string>;
+  readonly operator: import("@angular/core").InputSignal<string>;
+  readonly value: import("@angular/core").InputSignal<unknown>;
+  readonly enumOptions: import("@angular/core").InputSignal<unknown[]>;
+  readonly relationFields: import("@angular/core").InputSignal<FieldMetadata[]>;
+  readonly where: import("@angular/core").InputSignal<QueryBuilderRuleGroup<Record<string, unknown>> | undefined>;
+  readonly valueChange: import("@angular/core").OutputEmitterRef<unknown>;
+  readonly whereChange: import("@angular/core").OutputEmitterRef<QueryBuilderRuleGroup<Record<string, unknown>> | undefined>;
+  readonly errorMessage: import("@angular/core").InputSignal<string>;
+  readonly hasError: import("@angular/core").Signal<boolean>;
+  readonly valueChangeFn: import("@angular/core").InputSignal<((value: unknown) => void) | undefined>;
+  readonly whereChangeFn: import("@angular/core").InputSignal<((where: QueryBuilderRuleGroup<Record<string, unknown>> | undefined) => void) | undefined>;
+  /** 信号状态 —— 替代原先的可变类属性 */
+  readonly currentValue: import("@angular/core").WritableSignal<unknown>;
+  readonly rangeMin: import("@angular/core").WritableSignal<unknown>;
+  readonly rangeMax: import("@angular/core").WritableSignal<unknown>;
+  readonly arrayInputValue: import("@angular/core").WritableSignal<string>;
+  readonly currentDateStr: import("@angular/core").WritableSignal<string>;
+  readonly dateRangeStart: import("@angular/core").WritableSignal<string>;
+  readonly dateRangeEnd: import("@angular/core").WritableSignal<string>;
+  readonly inputType: import("@angular/core").Signal<string>;
+  readonly enumSelectOptions: import("@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: i0.ɵɵFactoryDeclaration<ValueInputComponent, never>;
+  static ɵcmp: i0.ɵɵ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 主题接口
  *
@@ -1022,12 +1711,12 @@ declare class ValueInputComponent implements OnInit, OnDestroy {
  * - 同时支持 output() 事件和可选的 onXxx 回调 input（供 NgComponentOutlet 使用）
  */
 interface QueryBuilderTheme {
-    /** 字段选择器组件 */
-    fieldSelector: Type<unknown>;
-    /** 操作符选择器组件 */
-    operatorSelector: Type<unknown>;
-    /** 值输入组件 */
-    valueInput: Type<unknown>;
+  /** 字段选择器组件 */
+  fieldSelector: Type<unknown>;
+  /** 操作符选择器组件 */
+  operatorSelector: Type<unknown>;
+  /** 值输入组件 */
+  valueInput: Type<unknown>;
 }
 /**
  * QueryBuilder 主题注入 Token
@@ -1038,12 +1727,11 @@ interface QueryBuilderTheme {
  * providers: [provideQueryBuilderTheme(QUERY_BUILDER_XXX_THEME)]
  * ```
  */
-declare const QUERY_BUILDER_THEME: InjectionToken<QueryBuilderTheme>;
+export declare const QUERY_BUILDER_THEME: InjectionToken<QueryBuilderTheme>;
 /**
  * 提供自定义主题
  */
-declare function provideQueryBuilderTheme(theme: QueryBuilderTheme): Provider;
-
+export declare function provideQueryBuilderTheme(theme: QueryBuilderTheme): Provider;
 /**
  * 默认主题（原生 HTML 实现）
  *
@@ -1057,7 +1745,5 @@ declare function provideQueryBuilderTheme(theme: QueryBuilderTheme): Provider;
  * 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 };
+export declare const DEFAULT_QUERY_BUILDER_THEME: QueryBuilderTheme;
+export { type QueryBuilderTheme, type QueryDragDropState, type QueryDropMode, type RxDBQueryOutput, type UIRuleGroup, type UIRuleWithWhere, cn };