@nocobase/client 2.0.0-alpha.9 → 2.1.0-alpha.1

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

@@ -17,6 +17,10 @@ export interface ResourceSettingsInitParams {
 }
 export declare class CollectionBlockModel<T = DefaultStructure> extends DataBlockModel<T> {
     isManualRefresh: boolean;
+    collectionRequired: boolean;
+    private previousBeforeRenderHash;
+    protected onMount(): void;
+    onActive(): void;
     /**
      * 子菜单过滤函数
      */
@@ -43,38 +47,20 @@ export declare class CollectionBlockModel<T = DefaultStructure> extends DataBloc
     }[] | ({
         key: string;
         label: string;
-        children: () => {
-            key: string;
-            label: string;
-            useModel: string;
-            createModelOptions: any;
-        }[];
+        useModel: string;
+        createModelOptions: any;
+        children?: 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;
-            }[];
-        }[] | {
+        children: () => {
             key: string;
-            label: any;
+            label: string;
             useModel: string;
             createModelOptions: any;
         }[];
-    })[] | ({
-        key: string;
-        label: string;
-        useModel: string;
-        createModelOptions: any;
-        children?: undefined;
+        useModel?: undefined;
+        createModelOptions?: undefined;
     } | {
         key: string;
         label: string;
@@ -124,6 +110,7 @@ export declare class CollectionBlockModel<T = DefaultStructure> extends DataBloc
     getResourceSettingsInitParams(): ResourceSettingsInitParams;
     onInit(options: any): void;
     createResource(ctx: any, params: any): SingleRecordResource | MultiRecordResource;
+    refresh(): Promise<void>;
     protected defaultBlockTitle(): string;
     addAppends(fieldPath: string, refresh?: boolean): void;
 }

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

@@ -7,5 +7,11 @@
  * For more information, please refer to: https://www.nocobase.com/agreement.
  */
 import { DefaultStructure, FlowModel } from '@nocobase/flow-engine';
+/**
+ * 作为字段子模型的入口类，实际实例化的目标类可通过 stepParams.fieldBinding.use 指定。
+ * - 如果存在显式的 fieldBinding.use，则优先返回它；
+ * - 否则回退到自身（保持原来的 use）。
+ */
 export declare class FieldModel<T = DefaultStructure> extends FlowModel<T> {
+    static resolveUse(options: any, engine: any, parentModel: any): any;
 }

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

@@ -29,12 +29,12 @@ export declare class GridModel<T extends {
     itemSettingsMenuLevel: number;
     itemFlowSettings: Exclude<FlowModelRendererProps['showFlowSettings'], boolean>;
     dragOverlayConfig?: DragOverlayConfig;
-    private readonly itemFallback;
+    itemFallback: React.JSX.Element;
     private readonly itemExtraToolbarItems;
     private dragState?;
     private _memoItemFlowSettings?;
     private getItemFlowSettings;
-    onInit(options: any): void;
+    onMount(): void;
     saveGridLayout(layout?: GridLayoutData): void;
     mergeRowsWithItems(rows: Record<string, string[][]>): Record<string, string[][]>;
     resetRows(syncProps?: boolean): void;
@@ -52,8 +52,12 @@ export declare class GridModel<T extends {
     handleDragEnd(_event: DragEndEvent): void;
     handleDragCancel(_event: DragCancelEvent): void;
     renderAddSubModelButton(): JSX.Element;
-    getRows(): any;
-    getSizes(): any;
+    /**
+     * 运行态按可见 block 过滤行/列，避免“整行都是 hidden block”但依然保留行间距占位。
+     * - 配置态（flowSettingsEnabled）保持原始 rows/sizes 以便拖拽和布局编辑。
+     * - 运行态仅在判断为“整列/整行都不可见”时做过滤，不写回 props/stepParams，布局元数据保持不变。
+     */
+    private getVisibleLayout;
     render(): React.JSX.Element;
 }
 /**
@@ -66,4 +70,23 @@ export declare class GridModel<T extends {
 export declare function transformRowsToSingleColumn(rows: Record<string, string[][]>, options?: {
     emptyColumnUid?: string;
 }): Record<string, string[][]>;
+export declare function recalculateGridSizes({ position, direction, resizeDistance, prevMoveDistance, oldSizes, oldRows, gridContainerWidth, gutter, columnCount, }: {
+    position: {
+        rowId: string;
+        columnIndex: number;
+        itemIndex: number;
+    };
+    direction: 'left' | 'right' | 'bottom' | 'corner';
+    resizeDistance: number;
+    prevMoveDistance: number;
+    oldSizes: Record<string, number[]>;
+    oldRows: Record<string, string[][]>;
+    gridContainerWidth: number;
+    gutter?: number;
+    columnCount?: number;
+}): {
+    newRows: Record<string, string[][]>;
+    newSizes: Record<string, number[]>;
+    moveDistance: number;
+};
 export {};

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

@@ -16,4 +16,5 @@ export declare class ChildPageModel extends PageModel {
     };
     createPageTabModelOptions: () => CreateModelOptions;
     handleDragEnd(event: DragEndEvent): Promise<void>;
+    render(): React.JSX.Element;
 }

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

@@ -20,12 +20,15 @@ export declare class PageModel extends FlowModel<PageModelStructure> {
         left?: ReactNode;
         right?: ReactNode;
     };
+    onMount(): void;
+    invokeTabModelLifecycleMethod(tabActiveKey: string, method: 'onActive' | 'onInactive'): void;
     createPageTabModelOptions: () => CreateModelOptions;
     mapTabs(): {
         key: string;
         label: React.JSX.Element;
         children: any;
     }[];
+    getFirstTab(): BasePageTabModel;
     renderFirstTab(): any;
     handleDragEnd(event: DragEndEvent): Promise<void>;
     renderTabs(): React.JSX.Element;

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

@@ -14,9 +14,11 @@ export declare class BasePageTabModel extends FlowModel<{
         grid: BlockGridModel;
     };
 }> {
+    onInit(options: any): void;
     getTabTitle(defaultTitle?: string): any;
     getTabIcon(): any;
     renderChildren(): any;
+    renderHiddenInConfig(): React.JSX.Element;
     render(): React.JSX.Element;
 }
 export declare class RootPageTabModel extends BasePageTabModel {

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

@@ -9,6 +9,8 @@
 import { DragEndEvent } from '@dnd-kit/core';
 import { PageModel } from './PageModel';
 export declare class RootPageModel extends PageModel {
+    mounted: boolean;
+    onMount(): void;
     saveStepParams(): Promise<void>;
     handleDragEnd(event: DragEndEvent): Promise<void>;
 }

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

@@ -32,5 +32,6 @@ export declare class DetailsBlockModel extends CollectionBlockModel<{
     handlePageChange: (page: number) => Promise<void>;
     refresh(): Promise<void>;
     renderPagination(): React.JSX.Element;
+    renderConfigureActions(): React.JSX.Element;
     renderComponent(): React.JSX.Element;
 }

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

@@ -6,8 +6,8 @@
  * 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 { FlowModel, FlowModelContext, ModelRenderMode } from '@nocobase/flow-engine';
+import { FlowModel, FlowModelContext, ModelRenderMode, SubModelItem } from '@nocobase/flow-engine';
 export declare class DetailsCustomItemModel extends FlowModel {
     static renderMode: ModelRenderMode;
-    static defineChildren(ctx: FlowModelContext): any[];
+    static defineChildren(ctx: FlowModelContext): Promise<SubModelItem[]> | SubModelItem[];
 }

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

@@ -16,6 +16,7 @@ export declare class DetailsGridModel extends GridModel<{
         items: FieldModel[];
     };
 }> {
+    itemFallback: React.JSX.Element;
     itemSettingsMenuLevel: number;
     itemFlowSettings: {
         showBackground: boolean;

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

@@ -16,7 +16,7 @@ import { DetailsGridModel } from './DetailsGridModel';
  * @param fieldPath 字段路径 (如 "o2m_aa.oho_bb.name")
  * @param idx Form.List 的索引
  */
-export declare function getValueWithIndex(record: any, fieldPath: string, fieldIndex?: string[]): any;
+export declare function getValueWithIndex(record: any, fieldPath: string, idx?: string[]): any;
 export declare class DetailsItemModel extends DisplayItemModel<{
     parent: DetailsGridModel;
     subModels: {
@@ -49,5 +49,5 @@ export declare class DetailsItemModel extends DisplayItemModel<{
         };
     }[];
     onInit(options: any): void;
-    render(): React.JSX.Element;
+    renderItem(): React.JSX.Element;
 }

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

@@ -6,7 +6,7 @@
  * 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 { FlowModelContext } from '@nocobase/flow-engine';
+import { FlowModelContext, type SubModelItem } from '@nocobase/flow-engine';
 import { DetailsCustomItemModel } from './DetailsCustomItemModel';
 /**
  * “JavaScript 字段”菜单入口（详情）：
@@ -15,5 +15,5 @@ import { DetailsCustomItemModel } from './DetailsCustomItemModel';
  * - 点击后创建 DetailsItemModel，并将其 subModels.field 固定为 JSFieldModel。
  */
 export declare class DetailsJSFieldItemModel extends DetailsCustomItemModel {
-    static defineChildren(ctx: FlowModelContext): import("@nocobase/flow-engine").SubModelItem[];
+    static defineChildren(ctx: FlowModelContext): Promise<SubModelItem[]>;
 }

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

@@ -14,16 +14,20 @@ export declare class FilterFormBlockModel extends FilterBlockModel<{
         actions?: any[];
     };
 }> {
+    static scene: import("../../base").BlockSceneType;
     /**
      * 是否需要自动触发筛选，当字段值变更时自动执行筛选
      */
     autoTriggerFilter: boolean;
+    private removeTargetBlockListener?;
     get form(): any;
     get title(): string;
     useHooksBeforeRender(): void;
     addAppends(): void;
     onInit(options: any): void;
     onMount(): void;
+    onUnmount(): void;
+    private handleTargetBlockRemoved;
     destroy(): Promise<boolean>;
     renderComponent(): React.JSX.Element;
 }

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

@@ -11,6 +11,7 @@ import React from 'react';
 import { GridModel } from '../../base';
 import { FilterFormItemModel } from './FilterFormItemModel';
 export declare class FilterFormGridModel extends GridModel {
+    itemSettingsMenuLevel: number;
     itemFlowSettings: {
         showBackground: boolean;
         style: {

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

@@ -41,9 +41,6 @@ export declare class FilterFormItemModel extends FilterableItemModel<{
                             };
                         };
                         filterFormItemSettings: {
-                            label: {
-                                label: any;
-                            };
                             init: {
                                 filterField: Pick<any, "name" | "title" | "type" | "interface">;
                                 defaultTargetUid: string;
@@ -65,9 +62,12 @@ export declare class FilterFormItemModel extends FilterableItemModel<{
         disabled: boolean;
     }[];
     operator: string;
+    mounted: boolean;
     private debouncedDoFilter;
     get defaultTargetUid(): string;
+    private getCurrentOperatorMeta;
     onInit(options: any): void;
+    onMount(): void;
     onUnmount(): void;
     doFilter(): void;
     doReset(): void;
@@ -76,6 +76,7 @@ export declare class FilterFormItemModel extends FilterableItemModel<{
      * @returns
      */
     getFilterValue(): any;
+    getDefaultValue(): any;
     /**
      * 处理回车事件
      * 当用户在输入框中按下回车键时触发筛选
@@ -86,5 +87,5 @@ export declare class FilterFormItemModel extends FilterableItemModel<{
         onKeyDown: any;
         isRange: boolean;
     };
-    render(): React.JSX.Element;
+    renderItem(): React.JSX.Element;
 }

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

@@ -10,6 +10,6 @@ import type { ButtonProps } from 'antd/es/button';
 import { FilterFormActionModel } from './FilterFormActionModel';
 export declare class FilterFormSubmitActionModel extends FilterFormActionModel {
     defaultProps: ButtonProps;
-    onMount(): void;
+    onInit(options: any): void;
     onUnmount(): void;
 }

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

@@ -9,7 +9,8 @@
 import React from 'react';
 import { FilterFormCustomItemModel } from '../FilterFormCustomItemModel';
 export declare class FilterFormCustomFieldModel extends FilterFormCustomItemModel {
-    fieldModelInstance: any;
+    customFieldModelInstance: any;
+    customFieldProps: any;
     operator: string;
     private debouncedDoFilter;
     get defaultTargetUid(): string;

package/es/flow/models/blocks/filter-manager/flow-actions/customizeFilterRender.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 { FilterFormItemModel } from '../../filter-form/FilterFormItemModel';
+export declare const customizeFilterRender: import("@nocobase/flow-engine").ActionDefinition<FilterFormItemModel, import("@nocobase/flow-engine").FlowContext>;

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

@@ -8,3 +8,5 @@
  */
 export * from './connectFields';
 export * from './defaultOperator';
+export * from './customizeFilterRender';
+export * from './operatorComponentProps';

package/es/flow/models/blocks/filter-manager/flow-actions/operatorComponentProps.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 { FilterFormItemModel } from '../../filter-form/FilterFormItemModel';
+export declare const operatorComponentProps: import("@nocobase/flow-engine").ActionDefinition<FilterFormItemModel, import("@nocobase/flow-engine").FlowContext>;

package/es/flow/models/blocks/form/CreateFormModel.d.ts

@@ -15,5 +15,6 @@ export declare class CreateFormModel extends FormBlockModel {
     private actionExtraToolbarItems;
     createResource(ctx: any, params: any): SingleRecordResource<unknown>;
     getAclActionName(): string;
+    submit(params?: any): Promise<void>;
     renderComponent(): React.JSX.Element;
 }

package/es/flow/models/blocks/form/EditFormModel.d.ts

@@ -18,5 +18,6 @@ export declare class EditFormModel extends FormBlockModel {
     getCurrentRecord(): any;
     getAclActionName(): string;
     handlePageChange: (page: number) => Promise<void>;
+    submit(params?: any): Promise<void>;
     renderComponent(): React.JSX.Element;
 }

package/es/flow/models/blocks/form/FormBlockModel.d.ts

@@ -6,6 +6,7 @@
  * 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 { PropertyMetaFactory } from '@nocobase/flow-engine';
 import { FormInstance } from 'antd';
 import React from 'react';
 import { BlockGridModel } from '../../base/BlockGridModel';
@@ -31,9 +32,18 @@ export declare class FormBlockModel<T extends DefaultCollectionBlockModelStructu
     renderConfigureActions(): React.JSX.Element;
     setFieldsValue(values: any): void;
     setFieldValue(fieldName: string, value: any): void;
+    onDispatchEventStart(eventName: string, options?: any, inputArgs?: Record<string, any>): Promise<void>;
+    getStepParams(flowKey: string, stepKey: string): any | undefined;
+    getStepParams(flowKey: string): Record<string, any> | undefined;
+    getStepParams(): Record<string, any>;
+    setStepParams(flowKey: string, stepKey: string, params: any): void;
+    setStepParams(flowKey: string, stepParams: Record<string, any>): void;
+    setStepParams(allParams: Record<string, any>): void;
+    saveStepParams(): Promise<any>;
+    protected createFormValuesMetaFactory(): PropertyMetaFactory;
     useHooksBeforeRender(): void;
     onInit(options: any): void;
-    onMount(): void;
+    protected onMount(): void;
     getCurrentRecord(): {};
     renderComponent(): void;
 }

package/es/flow/models/blocks/form/FormGridModel.d.ts

@@ -17,6 +17,7 @@ export type DefaultFormGridStructure = {
     };
 };
 export declare class FormGridModel<T extends DefaultFormGridStructure = DefaultFormGridStructure> extends GridModel<T> {
+    itemFallback: React.JSX.Element;
     itemSettingsMenuLevel: number;
     itemFlowSettings: {
         showBackground: boolean;

package/es/flow/models/blocks/form/FormItemModel.d.ts

@@ -35,5 +35,5 @@ export declare class FormItemModel<T extends DefaultStructure = DefaultStructure
         };
     }[];
     onInit(options: any): void;
-    render(): React.JSX.Element;
+    renderItem(): React.JSX.Element;
 }

package/es/flow/models/blocks/form/FormJSFieldItemModel.d.ts

@@ -14,5 +14,5 @@ import { FlowModel, FlowModelContext } from '@nocobase/flow-engine';
  * - 点击后创建标准 FormItemModel，并将子字段设置为 JSEditableFieldModel。
  */
 export declare class FormJSFieldItemModel extends FlowModel {
-    static defineChildren(ctx: FlowModelContext): import("@nocobase/flow-engine").SubModelItem[];
+    static defineChildren(ctx: FlowModelContext): Promise<import("@nocobase/flow-engine").SubModelItem[]>;
 }

package/es/flow/models/blocks/form/submitHandler.d.ts

@@ -0,0 +1,9 @@
+/**
+ * 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 function submitHandler(ctx: any, params: any): Promise<void>;

package/es/flow/models/blocks/js-block/JSBlock.d.ts

@@ -10,6 +10,7 @@ import React from 'react';
 import { BlockModel } from '../../base';
 export declare class JSBlockModel extends BlockModel {
     private _mountedOnce;
+    renderComponent(): React.ReactNode;
     render(): React.JSX.Element;
     protected onMount(): void;
 }

package/es/flow/models/blocks/table/JSColumnModel.d.ts

@@ -13,7 +13,6 @@ export declare class JSColumnModel extends TableCustomColumnModel {
     renderHiddenInConfig(): React.JSX.Element;
     getInputArgs(): {};
     getColumnProps(): {
-        width: number;
         title: React.JSX.Element;
         render: (value: any, record: any, index: any) => React.JSX.Element;
     };

package/es/flow/models/blocks/table/TableActionsColumnModel.d.ts

@@ -11,7 +11,6 @@ import { TableCustomColumnModel } from './TableCustomColumnModel';
 export declare class TableActionsColumnModel extends TableCustomColumnModel {
     afterAddAsSubModel(): Promise<void>;
     getColumnProps(): {
-        width: number;
         title: React.JSX.Element;
         render: (value: any, record: any, index: any) => React.JSX.Element;
     };

package/es/flow/models/blocks/table/TableBlockModel.d.ts

@@ -35,7 +35,20 @@ export declare class TableBlockModel extends CollectionBlockModel<TableBlockMode
     };
     customModelClasses: CustomTableBlockModelClassesEnum;
     get resource(): MultiRecordResource<any>;
+    private readonly columns;
+    private disposeAutorun;
+    onMount(): void;
+    onUnmount(): void;
     createResource(ctx: any, params: any): MultiRecordResource<unknown>;
+    /**
+     * 高亮指定的行
+     * @param record - 要高亮的行记录
+     */
+    highlightRow(record: any): void;
+    /**
+     * 取消行高亮
+     */
+    clearHighlight(): void;
     getColumns(): any[];
     EditableRow: (props: any) => React.JSX.Element;
     EditableCell: React.MemoExoticComponent<import("@formily/reactive-react").ReactFC<Omit<any, "ref">>>;
@@ -48,7 +61,7 @@ export declare class TableBlockModel extends CollectionBlockModel<TableBlockMode
         };
     };
     renderCell: (checked: any, record: any, index: any, originNode: any) => any;
-    renderConfiguireActions(): React.JSX.Element;
+    renderConfigureActions(): React.JSX.Element;
     pagination(): {
         current: number;
         pageSize: number;

package/es/flow/models/blocks/table/TableColumnModel.d.ts

@@ -9,12 +9,19 @@
 import { DisplayItemModel, FlowModelContext, ModelRenderMode } from '@nocobase/flow-engine';
 import { TableColumnProps } from 'antd';
 import React from 'react';
+export declare function FieldDeletePlaceholder(props: any): React.JSX.Element;
+export declare const CustomWidth: ({ setOpen, t, handleChange, defaultValue }: {
+    setOpen: any;
+    t: any;
+    handleChange: any;
+    defaultValue: any;
+}) => React.JSX.Element;
 export declare class TableColumnModel extends DisplayItemModel {
     static renderMode: ModelRenderMode;
-    renderHiddenInConfig(): React.JSX.Element;
     afterAddAsSubModel(): Promise<void>;
+    renderHiddenInConfig(): React.ReactNode | undefined;
     static defineChildren(ctx: FlowModelContext): any;
     getColumnProps(): TableColumnProps;
     onInit(options: any): void;
-    render(): any;
+    renderItem(): any;
 }

package/es/flow/models/blocks/table/TableJSFieldItemModel.d.ts

@@ -6,7 +6,7 @@
  * 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 { FlowModelContext } from '@nocobase/flow-engine';
+import { FlowModelContext, type SubModelItem } from '@nocobase/flow-engine';
 import { TableCustomColumnModel } from './TableCustomColumnModel';
 /**
  * “JavaScript 字段”菜单入口（表格）：
@@ -15,5 +15,5 @@ import { TableCustomColumnModel } from './TableCustomColumnModel';
  * - 点击后创建 TableColumnModel，并将其 subModels.field 固定为 JSFieldModel。
  */
 export declare class TableJSFieldItemModel extends TableCustomColumnModel {
-    static defineChildren(ctx: FlowModelContext): import("@nocobase/flow-engine").SubModelItem[];
+    static defineChildren(ctx: FlowModelContext): Promise<SubModelItem[]>;
 }

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

@@ -8,3 +8,11 @@
  */
 export declare function extractIndex(str: any): string;
 export declare function adjustColumnOrder(columns: any): any[];
+export declare function setNestedValue(data: any, recordIndex: any, value: any): void;
+export declare function extractIds(data: any): any[];
+/**
+ * 生成表格行唯一 key
+ * @param record 当前行数据
+ * @param key string | string[] 单字段或多字段
+ */
+export declare function getRowKey(record: any, key: string | string[]): any;

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

@@ -0,0 +1,42 @@
+/**
+ * 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 FlowModelContext, type SubModelItem } from '@nocobase/flow-engine';
+export interface TransformOptions {
+    fieldUseModel: string;
+    refreshTargets: string[];
+}
+/**
+ * 递归将 SubModelItem 列表中的叶子节点 createModelOptions 重写为指定的 JS 字段模型。
+ * - 保留 children 的形态：数组或函数；
+ * - 对函数型 children 做一层包裹，确保返回结果继续被转换；
+ * - 对已有 createModelOptions（对象或函数）做二次包装并追加 subModels.field.use。
+ */
+export declare function transformChildrenToJS(items: SubModelItem[] | false | undefined, options: TransformOptions): SubModelItem[];
+/**
+ * 构造“关联字段（JS 化）”分组节点，支持懒加载 children 并在返回时完成 JS 化。
+ */
+export declare function buildAssociationJSGroup(ctx: FlowModelContext, provider: (ctx: FlowModelContext) => SubModelItem[] | Promise<SubModelItem[]>, options: TransformOptions & {
+    key?: string;
+    label?: string;
+    searchable?: boolean;
+    searchPlaceholder?: string;
+}): SubModelItem;
+export declare function buildFormAssociationChildren(ctx: FlowModelContext): SubModelItem[];
+export interface JSFieldMenuChildrenOptions {
+    useModel: string;
+    fieldUseModel: string;
+    refreshTargets: string[];
+    associationPathName?: string;
+    /**
+     * 仅在需要“关系字段”入口时传入（例如 Table / Details 区块）；
+     * 表单的 JS field 菜单默认不展示关系字段。
+     */
+    associationProvider?: (ctx: FlowModelContext) => SubModelItem[] | Promise<SubModelItem[]>;
+}
+export declare function buildJSFieldMenuChildren(ctx: FlowModelContext, opts: JSFieldMenuChildrenOptions): Promise<SubModelItem[]>;

package/es/flow/models/fields/AssociationFieldModel/AssociationFieldModel.d.ts

@@ -1,3 +1,4 @@
 import { FieldModel } from '../../base/FieldModel';
 export declare class AssociationFieldModel extends FieldModel {
+    operator: string;
 }

package/es/flow/models/fields/AssociationFieldModel/CascadeSelectFieldModel.d.ts

@@ -0,0 +1,29 @@
+/**
+ * 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 { CollectionField, MultiRecordResource } from '@nocobase/flow-engine';
+import React from 'react';
+import { AssociationFieldModel } from './AssociationFieldModel';
+export declare class CascadeSelectInnerFieldModel extends AssociationFieldModel {
+    resource: MultiRecordResource;
+    get collectionField(): CollectionField;
+    onInit(options: any): void;
+    set onPopupScroll(fn: any);
+    set onDropdownVisibleChange(fn: any);
+    set onSearch(fn: any);
+    set onLoadData(fn: any);
+    setDataSource(dataSource: any): void;
+    getDataSource(): any;
+    getFilterValue(): any;
+}
+export declare class CascadeSelectFieldModel extends CascadeSelectInnerFieldModel {
+    render(): React.JSX.Element;
+}
+export declare class CascadeSelectListFieldModel extends CascadeSelectInnerFieldModel {
+    render(): React.JSX.Element;
+}

package/es/flow/models/fields/AssociationFieldModel/RecordPickerFieldModel.d.ts

@@ -18,9 +18,11 @@ export declare class RecordPickerFieldModel extends FieldModel {
         value: any[];
     };
     _closeView: any;
+    selectBlockModel: any;
     get collectionField(): CollectionField;
     render(): React.JSX.Element;
     onInit(option: any): void;
+    protected onMount(): void;
     set onClick(fn: any);
     change(): void;
 }