@nocobase/client 2.0.0-beta.8 → 2.0.0

package/es/flow/components/code-editor/linter.d.ts

@@ -7,5 +7,13 @@
  * For more information, please refer to: https://www.nocobase.com/agreement.
  */
 import { Diagnostic } from '@codemirror/lint';
-export declare const computeDiagnosticsFromText: (text: string) => Diagnostic[];
-export declare const createJavaScriptLinter: () => import("@codemirror/state").Extension;
+export declare const computeDiagnosticsFromText: (text: string, options?: {
+    /**
+     * When provided, treat `ctx.<name>` / `ctx.<name>()` where `<name>` is NOT in this list as a lint issue.
+     * This enables context-aware unknown ctx API detection in CodeEditor (best-effort).
+     */
+    knownCtxMemberRoots?: Iterable<string>;
+}) => Diagnostic[];
+export declare const createJavaScriptLinter: (options?: {
+    knownCtxMemberRoots?: Iterable<string>;
+}) => import("@codemirror/state").Extension;

package/es/flow/components/code-editor/runjsCompletionSource.d.ts

@@ -0,0 +1,20 @@
+/**
+ * This file is part of the NocoBase (R) project.
+ * Copyright (c) 2020-2024 NocoBase Co., Ltd.
+ * Authors: NocoBase Team.
+ *
+ * This project is dual-licensed under AGPL-3.0 and NocoBase Commercial License.
+ * For more information, please refer to: https://www.nocobase.com/agreement.
+ */
+import type { Completion, CompletionSource } from '@codemirror/autocomplete';
+type CreateRunJSCompletionSourceOptions = {
+    hostCtx: any;
+    staticOptions?: Completion[];
+    /**
+     * Roots that should use FlowContext meta tree to provide deep completions.
+     * When omitted/empty, all `ctx.*` roots are enabled.
+     */
+    metaRoots?: string[];
+};
+export declare function createRunJSCompletionSource({ hostCtx, staticOptions, metaRoots, }: CreateRunJSCompletionSourceOptions): CompletionSource;
+export {};

package/es/flow/components/code-editor/runjsDiagnostics.d.ts

@@ -0,0 +1,43 @@
+/**
+ * This file is part of the NocoBase (R) project.
+ * Copyright (c) 2020-2024 NocoBase Co., Ltd.
+ * Authors: NocoBase Team.
+ *
+ * This project is dual-licensed under AGPL-3.0 and NocoBase Commercial License.
+ * For more information, please refer to: https://www.nocobase.com/agreement.
+ */
+import { FlowContext } from '@nocobase/flow-engine';
+export type RunJSIssue = {
+    type: 'lint' | 'runtime';
+    message: string;
+    ruleId?: string;
+    location?: {
+        start?: {
+            line: number;
+            column: number;
+        };
+    };
+    stack?: string;
+};
+export type RunJSLog = {
+    level: 'log' | 'info' | 'warn' | 'error';
+    message: string;
+};
+export type DiagnoseRunJSResult = {
+    issues: RunJSIssue[];
+    logs: RunJSLog[];
+    execution?: {
+        started: boolean;
+        finished: boolean;
+        timeout: boolean;
+        durationMs?: number;
+    };
+};
+export type PreviewRunJSResult = {
+    success: boolean;
+    message: string;
+};
+export declare const MAX_MESSAGE_CHARS = 4000;
+export declare function formatRunJSPreviewMessage(result: DiagnoseRunJSResult): string;
+export declare function diagnoseRunJS(code: string, ctx: FlowContext): Promise<DiagnoseRunJSResult>;
+export declare function previewRunJS(code: string, ctx: FlowContext): Promise<PreviewRunJSResult>;

package/es/flow/components/fieldAssignOptions.d.ts

@@ -0,0 +1,23 @@
+/**
+ * This file is part of the NocoBase (R) project.
+ * Copyright (c) 2020-2024 NocoBase Co., Ltd.
+ * Authors: NocoBase Team.
+ *
+ * This project is dual-licensed under AGPL-3.0 and NocoBase Commercial License.
+ * For more information, please refer to: https://www.nocobase.com/agreement.
+ */
+export type FieldAssignCascaderOption = {
+    label: string;
+    value: string;
+    /** antd Cascader lazy-load marker */
+    isLeaf?: boolean;
+    /** antd Cascader loading marker */
+    loading?: boolean;
+    children?: FieldAssignCascaderOption[];
+};
+export declare function collectFieldAssignCascaderOptions(options: {
+    formBlockModel: any;
+    t: (key: string) => string;
+    /** 子表单模型递归深度（FormItemModel 层级）；默认不限制（只受实际配置与循环引用约束） */
+    maxFormItemDepth?: number;
+}): FieldAssignCascaderOption[];

package/es/flow/components/filter/LinkageFilterItem.d.ts

@@ -7,7 +7,7 @@
  * For more information, please refer to: https://www.nocobase.com/agreement.
  */
 import React from 'react';
-import { FlowModel } from '@nocobase/flow-engine';
+import { type MetaTreeNode, FlowModel } from '@nocobase/flow-engine';
 export interface LinkageFilterItemValue {
     path: string | null;
     operator: string;
@@ -18,7 +18,10 @@ export interface LinkageFilterItemProps {
     /** 条件值对象（响应式） */
     value: LinkageFilterItemValue;
     model: FlowModel;
+    /** 向变量树额外注入节点（置于根部） */
+    extraMetaTree?: MetaTreeNode[];
 }
+export declare function mergeExtraMetaTreeWithBase(baseMetaTree: MetaTreeNode[] | undefined, extraMetaTree?: MetaTreeNode[]): MetaTreeNode[];
 /**
  * LinkageFilterItem：左/右均为可变量输入，适用于联动规则等“前端逻辑”场景
  */

package/es/flow/components/useAssociationTitleFieldSync.d.ts

@@ -0,0 +1,13 @@
+/**
+ * This file is part of the NocoBase (R) project.
+ * Copyright (c) 2020-2024 NocoBase Co., Ltd.
+ * Authors: NocoBase Team.
+ *
+ * This project is dual-licensed under AGPL-3.0 and NocoBase Commercial License.
+ * For more information, please refer to: https://www.nocobase.com/agreement.
+ */
+import type { SyncAssociationTitleFieldParams } from './FieldAssignRulesEditor';
+export declare function useAssociationTitleFieldSync(t: (key: string) => string): {
+    isTitleFieldCandidate: (field: any) => boolean;
+    onSyncAssociationTitleField: ({ targetCollection, titleField }: SyncAssociationTitleFieldParams) => Promise<void>;
+};

package/es/flow/index.d.ts

@@ -18,6 +18,7 @@ export * from './FlowModelRepository';
 export * from './FlowPage';
 export * from './models';
 export * from './utils';
+export * from './actions';
 export { openViewFlow } from './flows/openViewFlow';
 export { editMarkdownFlow } from './flows/editMarkdownFlow';
 export { TextAreaWithContextSelector } from './components/TextAreaWithContextSelector';

package/es/flow/internal/utils/modelUtils.d.ts

@@ -0,0 +1,23 @@
+/**
+ * This file is part of the NocoBase (R) project.
+ * Copyright (c) 2020-2024 NocoBase Co., Ltd.
+ * Authors: NocoBase Team.
+ *
+ * This project is dual-licensed under AGPL-3.0 and NocoBase Commercial License.
+ * For more information, please refer to: https://www.nocobase.com/agreement.
+ */
+import { FormItemModel } from '../../models';
+export interface CollectionLike {
+    getField?: (name: string) => unknown;
+    getFields?: () => unknown[];
+    dataSourceKey?: string;
+    name?: string;
+}
+export declare function isToManyAssociationField(field: unknown): boolean;
+export declare function getCollectionFromModel(model: unknown): CollectionLike | undefined;
+/**
+ * Find a configured FormItemModel by its `fieldSettings.init.fieldPath` (or `fieldPath`) in the current form grid,
+ * including nested subform items. Also supports combined path matching when a model stores
+ * `associationPathName + fieldPath` separately (e.g. wrapper field children builders).
+ */
+export declare function findFormItemModelByFieldPath(root: unknown, targetPath: string): FormItemModel | null;

package/es/flow/internal/utils/saveStepParamsWithSubModels.d.ts

@@ -0,0 +1,11 @@
+/**
+ * This file is part of the NocoBase (R) project.
+ * Copyright (c) 2020-2024 NocoBase Co., Ltd.
+ * Authors: NocoBase Team.
+ *
+ * This project is dual-licensed under AGPL-3.0 and NocoBase Commercial License.
+ * For more information, please refer to: https://www.nocobase.com/agreement.
+ */
+export declare const SAVE_STEP_PARAMS_WITH_SUB_MODELS_FLAG: "__saveStepParamsWithSubModels";
+export declare function markSaveStepParamsWithSubModels(model: unknown): void;
+export declare function saveStepParamsWithSubModelsIfNeeded<T>(model: unknown, fallback: () => Promise<T>): Promise<T>;

package/es/flow/internal/utils/titleFieldQuickSync.d.ts

@@ -0,0 +1,35 @@
+/**
+ * This file is part of the NocoBase (R) project.
+ * Copyright (c) 2020-2024 NocoBase Co., Ltd.
+ * Authors: NocoBase Team.
+ *
+ * This project is dual-licensed under AGPL-3.0 and NocoBase Commercial License.
+ * For more information, please refer to: https://www.nocobase.com/agreement.
+ */
+import type { CollectionFieldOptions, DataSourceManager } from '../../../data-source';
+type CollectionLike = {
+    name?: unknown;
+    dataSource?: unknown;
+    dataSourceKey?: unknown;
+    setOption?: (key: string, value: any) => any;
+};
+type ApiClientLike = {
+    request?: (options: {
+        url: string;
+        method?: string;
+        params?: Record<string, any>;
+        data?: Record<string, any>;
+    }) => Promise<any>;
+};
+export declare function isTitleUsableField(dm: DataSourceManager | undefined, field: CollectionFieldOptions | undefined): boolean;
+export declare function syncCollectionTitleField(options: {
+    api: ApiClientLike;
+    dataSourceManager?: DataSourceManager;
+    targetCollection: CollectionLike | null | undefined;
+    titleField: string;
+}): Promise<{
+    dataSourceKey: string;
+    collectionName: string;
+    titleField: string;
+}>;
+export {};

package/es/flow/models/base/BlockModel.d.ts

@@ -1,6 +1,6 @@
 import { DefaultStructure, FlowModel } from '@nocobase/flow-engine';
 import React from 'react';
-export type BlockSceneType = 'new' | 'filter' | 'one' | 'many' | 'select' | BlockSceneType[];
+export type BlockSceneType = 'new' | 'filter' | 'one' | 'many' | 'select' | 'subForm' | 'bulkEditForm' | BlockSceneType[];
 export declare const BlockSceneEnum: {
     new: BlockSceneType;
     one: BlockSceneType;
@@ -8,6 +8,8 @@ export declare const BlockSceneEnum: {
     select: BlockSceneType;
     filter: BlockSceneType;
     oam: BlockSceneType;
+    subForm: BlockSceneType;
+    bulkEditForm: BlockSceneType;
 };
 export declare class BlockModel<T = DefaultStructure> extends FlowModel<T> {
     decoratorProps: Record<string, any>;

package/es/flow/models/base/CollectionBlockModel.d.ts

@@ -19,6 +19,13 @@ export declare class CollectionBlockModel<T = DefaultStructure> extends DataBloc
     isManualRefresh: boolean;
     collectionRequired: boolean;
     private previousBeforeRenderHash;
+    private lastSeenDirtyVersion;
+    private dirtyRefreshing;
+    /**
+     * 记录各筛选来源是否活跃（有有效筛选值）
+     * key: filterId (筛选器 uid), value: boolean (是否有有效筛选)
+     */
+    private activeFilterSources;
     protected onMount(): void;
     onActive(): void;
     /**
@@ -28,62 +35,7 @@ export declare class CollectionBlockModel<T = DefaultStructure> extends DataBloc
     /**
      * 定义子菜单选项
      */
-    static defineChildren(ctx: FlowModelContext): Promise<{
-        key: string;
-        label: any;
-        searchable: boolean;
-        searchPlaceholder: string;
-        children: (ctx: any) => {
-            key: string;
-            label: any;
-            useModel: string;
-            createModelOptions: any;
-        }[];
-    }[] | {
-        key: string;
-        label: any;
-        useModel: string;
-        createModelOptions: any;
-    }[] | ({
-        key: string;
-        label: string;
-        useModel: string;
-        createModelOptions: any;
-        children?: undefined;
-    } | {
-        key: string;
-        label: string;
-        children: () => {
-            key: string;
-            label: string;
-            useModel: string;
-            createModelOptions: any;
-        }[];
-        useModel?: undefined;
-        createModelOptions?: undefined;
-    } | {
-        key: string;
-        label: string;
-        children: {
-            key: string;
-            label: any;
-            searchable: boolean;
-            searchPlaceholder: string;
-            children: (ctx: any) => {
-                key: string;
-                label: any;
-                useModel: string;
-                createModelOptions: any;
-            }[];
-        }[] | {
-            key: string;
-            label: any;
-            useModel: string;
-            createModelOptions: any;
-        }[];
-        useModel?: undefined;
-        createModelOptions?: undefined;
-    })[]>;
+    static defineChildren(ctx: FlowModelContext): Promise<any[]>;
     get dataSource(): DataSource;
     get collection(): Collection;
     get resource(): BaseRecordResource;
@@ -109,6 +61,27 @@ export declare class CollectionBlockModel<T = DefaultStructure> extends DataBloc
     }[]>;
     getResourceSettingsInitParams(): ResourceSettingsInitParams;
     onInit(options: any): void;
+    /**
+     * 获取数据加载模式
+     * @returns 'auto' | 'manual'
+     */
+    getDataLoadingMode(): 'auto' | 'manual';
+    /**
+     * 设置指定筛选来源的活跃状态
+     * @param filterId 筛选器 uid
+     * @param active 是否有有效筛选值
+     */
+    setFilterActive(filterId: string, active: boolean): void;
+    /**
+     * 检查是否有任何活跃的筛选来源
+     * @returns boolean
+     */
+    hasActiveFilters(): boolean;
+    /**
+     * 移除指定筛选来源
+     * @param filterId 筛选器 uid
+     */
+    removeFilterSource(filterId: string): void;
     createResource(ctx: any, params: any): SingleRecordResource | MultiRecordResource;
     refresh(): Promise<void>;
     protected defaultBlockTitle(): string;

package/es/flow/models/base/PageModel/PageModel.d.ts

@@ -20,8 +20,24 @@ export declare class PageModel extends FlowModel<PageModelStructure> {
         left?: ReactNode;
         right?: ReactNode;
     };
+    private viewActivatedListener?;
+    private dataSourceDirtyListener?;
+    private lastSeenEmitterViewActivatedVersion;
+    private dirtyRefreshScheduled;
+    private unmounted;
+    private documentTitleUpdateVersion;
+    private getActiveTabKey;
+    private scheduleActiveLifecycleRefresh;
     onMount(): void;
+    protected onUnmount(): void;
     invokeTabModelLifecycleMethod(tabActiveKey: string, method: 'onActive' | 'onInactive'): void;
+    /**
+     * Resolve configured document title template and update browser tab title.
+     * Priority:
+     * 1) page without tabs: page.documentTitle > page title
+     * 2) page with tabs: activeTab.documentTitle > active tab name
+     */
+    updateDocumentTitle(preferredActiveTabKey?: string, retryCount?: number): Promise<void>;
     createPageTabModelOptions: () => CreateModelOptions;
     mapTabs(): {
         key: string;

package/es/flow/models/blocks/details/DetailsGridModel.d.ts

@@ -29,4 +29,5 @@ export declare class DetailsGridModel extends GridModel<{
     };
     dragOverlayConfig: DragOverlayConfig;
     renderAddSubModelButton(): React.JSX.Element;
+    render(): React.JSX.Element;
 }

package/es/flow/models/blocks/details/utils.d.ts

@@ -0,0 +1,16 @@
+/**
+ * This file is part of the NocoBase (R) project.
+ * Copyright (c) 2020-2024 NocoBase Co., Ltd.
+ * Authors: NocoBase Team.
+ *
+ * This project is dual-licensed under AGPL-3.0 and NocoBase Commercial License.
+ * For more information, please refer to: https://www.nocobase.com/agreement.
+ */
+/// <reference types="react" />
+export declare const useDetailsGridHeight: ({ heightMode, containerRef, actionsRef, paginationRef, deps, }: {
+    heightMode?: string;
+    containerRef: React.RefObject<HTMLDivElement>;
+    actionsRef: React.RefObject<HTMLDivElement>;
+    paginationRef: React.RefObject<HTMLDivElement>;
+    deps?: import("react").DependencyList;
+}) => number;

package/es/flow/models/blocks/filter-form/FieldOperatorSelect.d.ts

@@ -0,0 +1,10 @@
+/**
+ * This file is part of the NocoBase (R) project.
+ * Copyright (c) 2020-2024 NocoBase Co., Ltd.
+ * Authors: NocoBase Team.
+ *
+ * This project is dual-licensed under AGPL-3.0 and NocoBase Commercial License.
+ * For more information, please refer to: https://www.nocobase.com/agreement.
+ */
+import React from 'react';
+export declare const FieldOperatorSelect: React.MemoExoticComponent<import("@formily/react").ReactFC<Omit<any, "ref">>>;

package/es/flow/models/blocks/filter-form/FilterFormBlockModel.d.ts

@@ -23,10 +23,16 @@ export declare class FilterFormBlockModel extends FilterBlockModel<{
     get form(): any;
     get title(): string;
     useHooksBeforeRender(): void;
+    saveStepParams(): Promise<any>;
     addAppends(): void;
     onInit(options: any): void;
     onMount(): void;
     onUnmount(): void;
+    private applyDefaultsAndInitialFilter;
+    private ensureFilterItemsBeforeRender;
+    applyFormDefaultValues(options?: {
+        force?: boolean;
+    }): Promise<void>;
     private handleTargetBlockRemoved;
     destroy(): Promise<boolean>;
     renderComponent(): React.JSX.Element;

package/es/flow/models/blocks/filter-form/FilterFormItemModel.d.ts

@@ -8,6 +8,7 @@
  */
 import { FilterableItemModel, FlowModelContext } from '@nocobase/flow-engine';
 import React from 'react';
+import { FieldModel } from '../../base';
 import { FilterFormFieldModel } from './fields';
 export declare class FilterFormItemModel extends FilterableItemModel<{
     subModels: {
@@ -19,43 +20,7 @@ export declare class FilterFormItemModel extends FilterableItemModel<{
     static defineChildren(ctx: FlowModelContext): {
         key: string;
         label: React.JSX.Element;
-        children: () => Promise<{
-            key: string;
-            label: string;
-            type: "group";
-            searchable: boolean;
-            searchPlaceholder: string;
-            children: {
-                key: any;
-                label: any;
-                useModel: string;
-                refreshTargets: string[];
-                createModelOptions: () => {
-                    use: string;
-                    stepParams: {
-                        fieldSettings: {
-                            init: {
-                                dataSourceKey: any;
-                                collectionName: any;
-                                fieldPath: any;
-                            };
-                        };
-                        filterFormItemSettings: {
-                            init: {
-                                filterField: Pick<any, "name" | "title" | "type" | "interface">;
-                                defaultTargetUid: string;
-                            };
-                        };
-                    };
-                    subModels: {
-                        field: {
-                            use: string;
-                            props: any;
-                        };
-                    };
-                };
-            }[];
-        }[]>;
+        children: () => Promise<any[]>;
     }[] | {
         key: string;
         label: React.JSX.Element;
@@ -64,6 +29,8 @@ export declare class FilterFormItemModel extends FilterableItemModel<{
     operator: string;
     mounted: boolean;
     private debouncedDoFilter;
+    private lastAutoTriggerValue;
+    private autoTriggerInitialized;
     get defaultTargetUid(): string;
     private getCurrentOperatorMeta;
     onInit(options: any): void;
@@ -76,6 +43,7 @@ export declare class FilterFormItemModel extends FilterableItemModel<{
      * @returns
      */
     getFilterValue(): any;
+    normalizeAssociationFilterValue(value: any, fieldModel: FieldModel): any;
     getDefaultValue(): any;
     /**
      * 处理回车事件

package/es/flow/models/blocks/filter-form/customFieldOperators.d.ts

@@ -0,0 +1,34 @@
+/**
+ * This file is part of the NocoBase (R) project.
+ * Copyright (c) 2020-2024 NocoBase Co., Ltd.
+ * Authors: NocoBase Team.
+ *
+ * This project is dual-licensed under AGPL-3.0 and NocoBase Commercial License.
+ * For more information, please refer to: https://www.nocobase.com/agreement.
+ */
+type OperatorMeta = {
+    label: string;
+    value: string;
+    selected?: boolean;
+    noValue?: boolean;
+    schema?: Record<string, any>;
+    visible?: (meta: any) => boolean;
+    [key: string]: any;
+};
+type ResolveOperatorParams = {
+    flowEngine: any;
+    fieldModel?: string;
+    source?: string[];
+    fieldModelProps?: Record<string, any>;
+};
+export declare function resolveCustomFieldOperatorList(params: ResolveOperatorParams): OperatorMeta[];
+export declare function resolveDefaultCustomFieldOperator(params: ResolveOperatorParams): string | undefined;
+export declare function toOperatorSelectOptions(operatorList?: OperatorMeta[], translate?: (text: string) => string): {
+    label: string;
+    value: string;
+    selected?: boolean;
+    noValue?: boolean;
+    schema?: Record<string, any>;
+    visible?: (meta: any) => boolean;
+}[];
+export {};

package/es/flow/models/blocks/filter-form/fields/FilterFormCustomFieldModel.d.ts

@@ -7,12 +7,27 @@
  * For more information, please refer to: https://www.nocobase.com/agreement.
  */
 import React from 'react';
+import { CollectionField, FlowModelContext } from '@nocobase/flow-engine';
 import { FilterFormCustomItemModel } from '../FilterFormCustomItemModel';
 export declare class FilterFormCustomFieldModel extends FilterFormCustomItemModel {
     customFieldModelInstance: any;
     customFieldProps: any;
     operator: string;
     private debouncedDoFilter;
+    private lastAutoTriggerValue;
+    private autoTriggerInitialized;
+    /**
+     * Resolve or build collection field context for RecordSelect custom fields.
+     *
+     * When user creates a custom RecordSelect field, there is no real collection field.
+     * We build a lightweight CollectionField with target metadata so downstream
+     * flows can render select settings and load remote options.
+     *
+     * @param ctx - Flow context for current model
+     * @param props - Field model props from settings
+     * @returns CollectionField instance or undefined when not applicable
+     */
+    buildRecordSelectCollectionField(ctx: FlowModelContext, props: Record<string, any>): CollectionField;
     get defaultTargetUid(): string;
     onInit(options: any): void;
     onUnmount(): void;
@@ -23,6 +38,7 @@ export declare class FilterFormCustomFieldModel extends FilterFormCustomItemMode
      * @returns
      */
     getFilterValue(): any;
+    private getCurrentOperatorMeta;
     /**
      * 处理回车事件
      * 当用户在输入框中按下回车键时触发筛选

package/es/flow/models/blocks/filter-form/fields/FilterFormCustomRecordSelectFieldModel.d.ts

@@ -0,0 +1,20 @@
+/**
+ * This file is part of the NocoBase (R) project.
+ * Copyright (c) 2020-2024 NocoBase Co., Ltd.
+ * Authors: NocoBase Team.
+ *
+ * This project is dual-licensed under AGPL-3.0 and NocoBase Commercial License.
+ * For more information, please refer to: https://www.nocobase.com/agreement.
+ */
+import React from 'react';
+import { RecordSelectFieldModel } from '../../../fields/AssociationFieldModel/RecordSelectFieldModel';
+export declare class FilterFormCustomRecordSelectFieldModel extends RecordSelectFieldModel {
+    private valueOptionsSyncKey;
+    private valueOptionsSyncedKey;
+    private valueOptionsSyncTask;
+    private buildValueOptionsSyncKey;
+    private ensureValueOptionsSynced;
+    onDispatchEventStart(eventName: string): Promise<void>;
+    getFilterValue(): any;
+    render(): React.JSX.Element;
+}

package/es/flow/models/blocks/filter-form/fields/FilterFormRecordSelectFieldModel.d.ts

@@ -0,0 +1,12 @@
+/**
+ * This file is part of the NocoBase (R) project.
+ * Copyright (c) 2020-2024 NocoBase Co., Ltd.
+ * Authors: NocoBase Team.
+ *
+ * This project is dual-licensed under AGPL-3.0 and NocoBase Commercial License.
+ * For more information, please refer to: https://www.nocobase.com/agreement.
+ */
+import { RecordSelectFieldModel } from '../../../fields/AssociationFieldModel';
+export declare class FilterFormRecordSelectFieldModel extends RecordSelectFieldModel {
+    onInit(options: any): void;
+}

package/es/flow/models/blocks/filter-form/fields/index.d.ts

@@ -7,5 +7,7 @@
  * For more information, please refer to: https://www.nocobase.com/agreement.
  */
 export * from './FilterFormFieldModel';
+export * from './FilterFormRecordSelectFieldModel';
 export * from './date-time';
 export * from './FilterFormCustomFieldModel';
+export * from './FilterFormCustomRecordSelectFieldModel';

package/es/flow/models/blocks/filter-form/index.d.ts

@@ -14,6 +14,10 @@ export * from './FilterFormCollapseActionModel';
 export * from './FilterFormGridModel';
 export * from './FilterFormItemModel';
 export * from './FilterFormCustomItemModel';
+export * from './FieldModelSelect';
+export * from './FieldOperatorSelect';
+export * from './SourceCascader';
+export * from './customFieldOperators';
 export * from './FilterFormJSActionModel';
 export * from './FilterFormResetActionModel';
 export * from './FilterFormSubmitActionModel';

package/es/flow/models/blocks/filter-form/legacyDefaultValueMigration.d.ts

@@ -0,0 +1,13 @@
+/**
+ * This file is part of the NocoBase (R) project.
+ * Copyright (c) 2020-2024 NocoBase Co., Ltd.
+ * Authors: NocoBase Team.
+ *
+ * This project is dual-licensed under AGPL-3.0 and NocoBase Commercial License.
+ * For more information, please refer to: https://www.nocobase.com/agreement.
+ */
+import { mergeAssignRulesWithLegacyDefaults } from '../shared/legacyDefaultValueMigrationBase';
+import type { FieldAssignRuleItem } from '../../../components/FieldAssignRulesEditor';
+export declare function collectLegacyDefaultValueRulesFromFilterFormModel(filterFormModel: any): FieldAssignRuleItem[];
+export declare function clearLegacyDefaultValuesFromFilterFormModel(filterFormModel: any): any[];
+export { mergeAssignRulesWithLegacyDefaults };

package/es/flow/models/blocks/filter-form/valueNormalization.d.ts

@@ -0,0 +1,17 @@
+/**
+ * This file is part of the NocoBase (R) project.
+ * Copyright (c) 2020-2024 NocoBase Co., Ltd.
+ * Authors: NocoBase Team.
+ *
+ * This project is dual-licensed under AGPL-3.0 and NocoBase Commercial License.
+ * For more information, please refer to: https://www.nocobase.com/agreement.
+ */
+/**
+ * Normalize filter value based on operator expected shape.
+ *
+ * - Multi-value operators: normalize scalar -> [value]
+ * - $dateBetween: normalize scalar date -> [date, date]
+ *
+ * Note: For date variables (object with `type`), keep as-is because operators can resolve it to ranges.
+ */
+export declare function normalizeFilterValueByOperator(operator: string | undefined, rawValue: any): any;