@nocobase/client 2.1.0-beta.2 → 2.1.0-beta.21

package/README.md

@@ -1,17 +1,24 @@
 # NocoBase
 
 <video width="100%" controls>
-      <source src="https://static-docs.nocobase.com/NocoBase0510.mp4" type="video/mp4">
+  <source src="https://github.com/user-attachments/assets/4d11a87b-00e2-48f3-9bf7-389d21072d13" type="video/mp4">
 </video>
 
+<p align="center">
+<a href="https://trendshift.io/repositories/4112" target="_blank"><img src="https://trendshift.io/api/badge/repositories/4112" alt="nocobase%2Fnocobase | Trendshift" style="width: 250px; height: 55px;" width="250" height="55"/></a>
+<a href="https://www.producthunt.com/posts/nocobase?embed=true&utm_source=badge-top-post-topic-badge&utm_medium=badge&utm_souce=badge-nocobase" target="_blank"><img src="https://api.producthunt.com/widgets/embed-image/v1/top-post-topic-badge.svg?post_id=456520&theme=light&period=weekly&topic_id=267" alt="NocoBase - Scalability&#0045;first&#0044;&#0032;open&#0045;source&#0032;no&#0045;code&#0032;platform | Product Hunt" style="width: 250px; height: 54px;" width="250" height="54" /></a>
+</p>
 
 ## What is NocoBase
 
-NocoBase is a scalability-first, open-source no-code development platform.  
-Instead of investing years of time and millions of dollars in research and development, deploy NocoBase in a few minutes and you'll have a private, controllable, and extremely scalable no-code development platform!
+NocoBase is the most extensible AI-powered no-code platform.   
+Total control. Infinite extensibility. AI collaboration.  
+Enable your team to adapt quickly and cut costs dramatically.  
+No years of development. No millions wasted.  
+Deploy NocoBase in minutes — and take control of everything.
 
 Homepage:  
-https://www.nocobase.com/
+https://www.nocobase.com/  
 
 Online Demo:  
 https://demo.nocobase.com/new
@@ -19,12 +26,74 @@ https://demo.nocobase.com/new
 Documents:  
 https://docs.nocobase.com/
 
-Commericial license & plugins:  
-https://www.nocobase.com/en/commercial
+Forum:  
+https://forum.nocobase.com/
 
-License agreement:   
-https://www.nocobase.com/en/agreement
+Use Cases:  
+https://www.nocobase.com/en/blog/tags/customer-stories
 
+## Release Notes
 
-## Contact Us:  
-hello@nocobase.com
+Our [blog](https://www.nocobase.com/en/blog/timeline) is regularly updated with release notes and provides a weekly summary.
+
+## Distinctive features
+
+### 1. Data model-driven, not form/table–driven
+
+Instead of being constrained by forms or tables, NocoBase adopts a data model–driven approach, separating data structure from user interface to unlock unlimited possibilities.
+
+- UI and data structure are fully decoupled
+- Multiple blocks and actions can be created for the same table or record in any quantity or form
+- Supports the main database, external databases, and third-party APIs as data sources
+
+![model](https://static-docs.nocobase.com/model.png)
+
+### 2. AI employees, integrated into your business systems
+Unlike standalone AI demos, NocoBase allows you to embed AI capabilities seamlessly into your interfaces, workflows, and data context, making AI truly useful in real business scenarios.
+
+- Define AI employees for roles such as translator, analyst, researcher, or assistant
+- Seamless AI–human collaboration in interfaces and workflows
+- Ensure AI usage is secure, transparent, and customizable for your business needs
+
+![AI-employee](https://static-docs.nocobase.com/ai-employee-home.png)
+
+### 3. What you see is what you get, incredibly easy to use
+
+While enabling the development of complex business systems, NocoBase keeps the experience simple and intuitive.
+
+- One-click switch between usage mode and configuration mode
+- Pages serve as a canvas to arrange blocks and actions, similar to Notion
+- Configuration mode is designed for ordinary users, not just programmers
+
+![wysiwyg](https://static-docs.nocobase.com/wysiwyg.gif)
+
+### 4. Everything is a plugin, designed for extension
+Adding more no-code features will never cover every business case. NocoBase is built for extension through its plugin-based microkernel architecture.
+
+- All functionalities are plugins, similar to WordPress
+- Plugins are ready to use upon installation
+- Pages, blocks, actions, APIs, and data sources can all be extended through custom plugins
+
+![plugins](https://static-docs.nocobase.com/plugins.png)
+
+## Installation
+
+NocoBase supports three installation methods:
+
+- <a target="_blank" href="https://docs.nocobase.com/welcome/getting-started/installation/docker-compose">Installing With Docker (👍Recommended)</a>
+
+  Suitable for no-code scenarios, no code to write. When upgrading, just download the latest image and reboot.
+
+- <a target="_blank" href="https://docs.nocobase.com/welcome/getting-started/installation/create-nocobase-app">Installing from create-nocobase-app CLI</a>
+
+  The business code of the project is completely independent and supports low-code development.
+
+- <a target="_blank" href="https://docs.nocobase.com/welcome/getting-started/installation/git-clone">Installing from Git source code</a>
+
+  If you want to experience the latest unreleased version, or want to participate in the contribution, you need to make changes and debug on the source code, it is recommended to choose this installation method, which requires a high level of development skills, and if the code has been updated, you can git pull the latest code.
+
+## How NocoBase works
+
+<video width="100%" controls>
+  <source src="https://github.com/user-attachments/assets/8d183b44-9bb5-4792-b08f-bc08fe8dfaaf" type="video/mp4">
+</video>

package/es/ai/index.d.ts

@@ -8,4 +8,5 @@
  */
 export * from './ai-manager';
 export * from './tools-manager';
+export * from './skills-manager';
 export * from './utils';

package/es/ai/skills-manager/index.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 * from './types';

package/es/ai/skills-manager/types.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 SkillsScope = 'SPECIFIED' | 'GENERAL' | 'CUSTOM';
+export type SkillsEntry = {
+    scope: SkillsScope;
+    name: string;
+    description: string;
+    content?: string;
+    tools?: string[];
+    title?: string;
+    about?: string;
+    from?: string;
+};
+export type SkillsFilter = {
+    scope?: SkillsScope;
+    name?: string;
+};

package/es/ai/tools-manager/index.d.ts

@@ -18,4 +18,3 @@ export declare class DefaultToolsManager implements ToolsManager {
     registerTools(name: string, options: ToolsOptions): void;
 }
 export * from './types';
-export * from './hooks';

package/es/ai/tools-manager/types.d.ts

@@ -7,6 +7,7 @@
  * For more information, please refer to: https://www.nocobase.com/agreement.
  */
 import type { ComponentType } from 'react';
+import type { ModalProps } from 'antd';
 import type { Application } from '../../application';
 import { Registry } from '@nocobase/utils/client';
 export interface ToolsManager extends ToolsRegistration {
@@ -16,12 +17,18 @@ export interface ToolsManager extends ToolsRegistration {
 export interface ToolsRegistration {
     registerTools(name: string, options: ToolsOptions): void;
 }
+export type ToolModalProps = Pick<ModalProps, 'width' | 'styles'>;
 export type ToolsOptions = {
     ui?: {
         card?: ComponentType<ToolsUIProperties>;
         modal?: {
             title?: string;
             okText?: string;
+            props?: ToolModalProps;
+            footer?: ComponentType<{
+                tool: ToolCall;
+            }>;
+            hideOkButton?: boolean;
             useOnOk?: (decisions: ToolsUIProperties['decisions'], adjustArgs: Record<string, any>) => {
                 onOk: () => void | Promise<void>;
             };
@@ -47,6 +54,7 @@ export type ToolCall<T = unknown> = {
 export type FrontendTools = ToolsOptions;
 export type BackendTools = {
     scope: Scope;
+    from: From;
     defaultPermission?: Permission;
     silence?: boolean;
     introduction?: {
@@ -69,12 +77,14 @@ export type ToolsUIProperties<ToolCallArgs = unknown> = {
 export type DecisionActions = {
     approve: () => Promise<void>;
     edit: (args: any) => Promise<void>;
-    reject: (message: string) => Promise<void>;
+    reject: (message?: string) => Promise<void>;
 };
 export type ToolsFilter = {
     scope?: Scope;
     defaultPermission?: Permission;
     silence?: boolean;
+    sessionId?: string;
 };
 export type Scope = 'SPECIFIED' | 'GENERAL' | 'CUSTOM';
 export type Permission = 'ASK' | 'ALLOW';
+export type From = 'loader' | 'workflow' | 'mcp';

package/es/application/Application.d.ts

@@ -18,7 +18,7 @@ import { SchemaInitializer, SchemaInitializerManager } from './schema-initialize
 import { SchemaSettings, SchemaSettingsItemType, SchemaSettingsManager } from './schema-settings';
 import { CollectionFieldInterfaceComponentOption } from '../data-source/collection-field-interface/CollectionFieldInterface';
 import { DataSourceManager, type DataSourceManagerOptions } from '../data-source/data-source/DataSourceManager';
-import { FlowEngine, FlowEngineContext } from '@nocobase/flow-engine';
+import { FlowEngine, FlowEngineContext, FlowModel } from '@nocobase/flow-engine';
 import type { CollectionFieldInterfaceFactory } from '../data-source';
 import type { Plugin } from './Plugin';
 import type { RequireJS } from './utils/requirejs';
@@ -105,6 +105,7 @@ export declare class Application {
     globalVarCtxs: Record<string, any>;
     jsonLogic: JsonLogic;
     flowEngine: FlowEngine;
+    model: ApplicationModel;
     context: FlowEngineContext & {
         pluginSettingsRouter: PluginSettingsManager;
         pluginManager: PluginManager;
@@ -203,4 +204,7 @@ export declare class Application {
         Component: ComponentType;
     }): void;
 }
+declare class ApplicationModel extends FlowModel {
+    render(): React.JSX.Element;
+}
 export {};

package/es/block-provider/BlockProvider.d.ts

@@ -102,6 +102,7 @@ export declare const BlockProvider: (props: {
  * @returns
  */
 export declare const useBlockAssociationContext: () => any;
+export declare const getFilterByTkByCollection: (collection: any, recordData: Record<string, any>) => any;
 export declare const useFilterByTk: (blockProps?: any) => any;
 /**
  * @deprecated

package/es/collection-manager/templates/view.d.ts

@@ -18,6 +18,17 @@ export declare class ViewCollectionTemplate extends CollectionTemplate {
     };
     divider: boolean;
     configurableProperties: {
+        filterTargetKey: {
+            title: string;
+            type: string;
+            description: string;
+            'x-decorator': string;
+            'x-component': string;
+            'x-component-props': {
+                multiple: boolean;
+            };
+            'x-reactions': string[];
+        };
         name: any;
         title: any;
         description: any;
@@ -125,16 +136,5 @@ export declare class ViewCollectionTemplate extends CollectionTemplate {
                 };
             };
         };
-        filterTargetKey: {
-            title: string;
-            type: string;
-            description: string;
-            'x-decorator': string;
-            'x-component': string;
-            'x-component-props': {
-                multiple: boolean;
-            };
-            'x-reactions': string[];
-        };
     };
 }

package/es/flow/actions/afterSuccess.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 const afterSuccess: import("@nocobase/flow-engine").ActionDefinition<import("@nocobase/flow-engine").FlowModel<import("@nocobase/flow-engine").DefaultStructure>, import("@nocobase/flow-engine").FlowContext>;

package/es/flow/actions/index.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.
  */
+export * from './afterSuccess';
 export * from './confirm';
 export * from './dataScope';
 export * from './openView';

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

@@ -8,7 +8,7 @@
  */
 import React from 'react';
 import { dayjs } from '@nocobase/utils/client';
-import { type MetaTreeNode } from '@nocobase/flow-engine';
+import { type CollectionField, type MetaTreeNode } from '@nocobase/flow-engine';
 import { type ExactDatePickerMode } from './FieldAssignExactDatePicker';
 export type DateVariableExactNormalizeMode = 'none' | 'date' | 'datetimeNoTz' | 'iso';
 export declare function toExactPickerDisplayValue(rawValue: unknown, options: {
@@ -54,6 +54,31 @@ interface Props {
     enableDateVariableAsConstant?: boolean;
 }
 export declare function mergeItemMetaTreeForAssignValue(baseTree: MetaTreeNode[], extraTree: MetaTreeNode[]): MetaTreeNode[];
+export declare function resolveAssignValueFieldPath(itemModel: any): string | undefined;
+type AssignValueFieldSettingsInit = {
+    dataSourceKey?: string;
+    collectionName?: string;
+    fieldPath?: string;
+};
+type AssignValueFieldSource = {
+    originFieldModel?: any;
+    originProps: Record<string, any>;
+    customFieldName?: string;
+    customFieldProps: Record<string, any>;
+    currentAllowMultiple?: boolean;
+    currentFieldModelUse?: string;
+};
+export declare function resolveAssignValueFieldModelConfig(options: {
+    itemModel: any;
+    defaultBindingUse?: string;
+    collectionField?: Pick<CollectionField, 'isAssociationField'> | null;
+    fieldSource?: AssignValueFieldSource;
+    preferFormItemFieldModel?: boolean;
+    fieldSettingsInit?: AssignValueFieldSettingsInit;
+}): {
+    use?: string;
+    stepParams: Record<string, any>;
+};
 /**
  * 根据所选字段渲染对应的赋值编辑器：
  * - 使用临时的 VariableFieldFormModel 包裹字段模型，确保常量编辑为真实字段组件

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

@@ -10,7 +10,7 @@ import React from 'react';
 import { type RunJSValue } from '@nocobase/flow-engine';
 export interface RunJSValueEditorProps {
     t?: (key: string) => string;
-    value: unknown;
+    value?: unknown;
     onChange?: (value: RunJSValue) => void;
     height?: string;
     scene?: string;

package/es/flow/components/code-editor/core/tooltipParent.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 const resolveTooltipParent: (element: HTMLElement | null) => HTMLElement;

package/es/flow/components/code-editor/resolveScenes.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.
+ */
+export declare function inferRunJSScenesFromContext(hostCtx: any, explicitScene?: string | string[]): string[];
+export declare function mergeRunJSScenes(explicitScene?: string | string[], autoScenes?: string[]): string[];

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

@@ -37,7 +37,10 @@ export type PreviewRunJSResult = {
     success: boolean;
     message: string;
 };
+export type RunJSDiagnosticsOptions = {
+    version?: 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>;
+export declare function diagnoseRunJS(code: string, ctx: FlowContext, options?: RunJSDiagnosticsOptions): Promise<DiagnoseRunJSResult>;
+export declare function previewRunJS(code: string, ctx: FlowContext, options?: RunJSDiagnosticsOptions): Promise<PreviewRunJSResult>;

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

@@ -21,8 +21,31 @@ export interface LinkageFilterItemProps {
     /** 向变量树额外注入节点（置于根部） */
     extraMetaTree?: MetaTreeNode[];
 }
+type OperatorMeta = {
+    value: string;
+    label: string | React.ReactNode;
+    noValue?: boolean;
+    schema?: any;
+    selected?: boolean;
+};
+type FilterableChild = {
+    name: string;
+    title?: string;
+    schema?: any;
+    operators?: OperatorMeta[];
+};
+type FieldInterfaceDef = {
+    filterable?: {
+        operators?: Array<OperatorMeta & {
+            visible?: (meta: MetaTreeNode) => boolean;
+        }>;
+        children?: FilterableChild[];
+    };
+};
 export declare function mergeExtraMetaTreeWithBase(baseMetaTree: MetaTreeNode[] | undefined, extraMetaTree?: MetaTreeNode[]): MetaTreeNode[];
+export declare function enhanceMetaTreeWithFilterableChildren(metaTree: MetaTreeNode[] | undefined, getFieldInterface?: (name: string) => FieldInterfaceDef | undefined): Promise<MetaTreeNode[]>;
 /**
  * LinkageFilterItem：左/右均为可变量输入，适用于联动规则等“前端逻辑”场景
  */
 export declare const LinkageFilterItem: React.FC<LinkageFilterItemProps>;
+export {};

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

@@ -13,8 +13,12 @@ export interface CollectionLike {
     dataSourceKey?: string;
     name?: string;
 }
+export declare const CUSTOM_FIELD_TARGET_PATH_PREFIX = "__custom__";
+export declare function buildCustomFieldTargetPath(customFieldName: string): string;
 export declare function isToManyAssociationField(field: unknown): boolean;
 export declare function getCollectionFromModel(model: unknown): CollectionLike | undefined;
+export declare function getFormItemFieldPathCandidates(model: unknown): string[];
+export declare function getFormItemPreferredFieldPath(model: unknown): string | 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

package/es/flow/models/actions/AddChildActionModel.d.ts

@@ -9,6 +9,7 @@
 import type { ButtonProps } from 'antd/es/button';
 import { PopupActionModel } from '../base';
 export declare class AddChildActionModel extends PopupActionModel {
+    static capabilityActionName: any;
     defaultProps: ButtonProps;
     getAclActionName(): string;
     onInit(options: any): void;

package/es/flow/models/actions/BulkDeleteActionModel.d.ts

@@ -10,6 +10,7 @@ import { ButtonProps } from 'antd';
 import { ActionModel } from '../base';
 export declare class BulkDeleteActionModel extends ActionModel {
     static scene: import("../base").ActionSceneType;
+    static capabilityActionName: string;
     defaultProps: ButtonProps;
     getAclActionName(): string;
 }

package/es/flow/models/actions/JSItemActionModel.d.ts

@@ -0,0 +1,19 @@
+/**
+ * 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 { ActionModel } from '../base';
+export declare class JSItemActionModel extends ActionModel {
+    private _offResourceRefresh?;
+    private _mountedOnce;
+    static scene: import("../base").ActionSceneType;
+    render(): React.JSX.Element;
+    renderHiddenInConfig(): React.ReactNode | undefined;
+    protected onMount(): void;
+    protected onUnmount(): void;
+}

package/es/flow/models/actions/LinkActionModel.d.ts

@@ -8,10 +8,7 @@
  */
 import type { ButtonProps } from 'antd/es/button';
 import { ActionModel } from '../base';
-export declare function joinUrlSearch(url: string, params?: {
-    name: string;
-    value: any;
-}[]): string;
+export { joinUrlSearch } from './joinUrlSearch';
 export declare class LinkActionModel extends ActionModel {
     static scene: import("../base").ActionSceneType;
     defaultProps: ButtonProps;

package/es/flow/models/actions/LinkActionUtils.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.
+ */
+export declare function completeURL(url: string, origin?: string): string;
+export declare function handleLinkNavigation(options: {
+    link: string;
+    openInNewWindow?: boolean;
+    router: {
+        navigate: (to: string, options?: {
+            replace?: boolean;
+        }) => void;
+    };
+    isExternalLink: boolean;
+    setLocationHref?: (url: string) => void;
+    openWindow?: (url?: string, target?: string) => Window | null;
+}): void;
+/**
+ * 判断 Link 导航后是否需要销毁当前视图
+ * @param options 判定参数
+ * @param options.openInNewWindow 是否新窗口打开
+ * @param options.isExternalLink 是否外部链接
+ * @param options.viewType 当前视图类型
+ * @returns 是否应销毁当前视图
+ */
+export declare function shouldDestroyViewAfterLinkNavigation(options: {
+    openInNewWindow?: boolean;
+    isExternalLink: boolean;
+    viewType?: string;
+}): boolean;

package/es/flow/models/actions/UpdateRecordActionUtils.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.
+ */
+export declare function refreshLinkageRulesAfterUpdate(ctx: any): Promise<void>;
+export declare function applyUpdateRecordAction(ctx: any, params: any, options?: {
+    settingsFlowKey?: string;
+}): Promise<void>;

package/es/flow/models/actions/index.d.ts

@@ -13,6 +13,7 @@ export * from './EditActionModel';
 export * from './FilterActionModel';
 export * from './JSActionModel';
 export * from './JSCollectionActionModel';
+export * from './JSItemActionModel';
 export * from './JSRecordActionModel';
 export * from './PopupCollectionActionModel';
 export * from './RefreshActionModel';

package/es/flow/models/actions/joinUrlSearch.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.
+ */
+export declare function joinUrlSearch(url: string, params?: {
+    name: string;
+    value: any;
+}[]): string;

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

@@ -16,6 +16,14 @@ export declare class ActionGroupModel extends FlowModel {
     static get currentModels(): Map<string, typeof ActionModel>;
     static get models(): Map<any, any>;
     static registerActionModels(models: Record<string, any>): void;
+    /**
+     * 判断动作模型在当前数据表上下文下是否应显示在 v2 的“添加动作”菜单中。
+     *
+     * @param ModelClass 动作模型类
+     * @param ctx Flow 上下文
+     * @returns 是否显示
+     */
+    static isActionModelVisible(ModelClass: typeof ActionModel, ctx: FlowModelContext): boolean;
     static defineChildren(ctx: FlowModelContext): Promise<any[]>;
 }
 export declare class CollectionActionGroupModel extends ActionGroupModel {

package/es/flow/models/base/BlockGridModel.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 { DragOverlayConfig } from '@nocobase/flow-engine';
+import { DragOverlayConfig, type SubModelItemsType } from '@nocobase/flow-engine';
 import React from 'react';
 import { FilterManager } from '../blocks/filter-manager/FilterManager';
 import { GridModel } from './GridModel';
@@ -15,6 +15,7 @@ export declare class BlockGridModel extends GridModel {
     onInit(options: any): void;
     get subModelBaseClasses(): string[];
     get filterManager(): FilterManager;
+    get addBlockItems(): SubModelItemsType | undefined;
     serialize(): Record<string, any>;
     renderAddSubModelButton(): React.JSX.Element;
     render(): React.JSX.Element;

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

@@ -18,6 +18,32 @@ export declare class BlockModel<T = DefaultStructure> extends FlowModel<T> {
     customModelClasses: any;
     collectionRequired: boolean;
     private ObservedRenderComponent;
+    /**
+     * 记录各筛选来源是否活跃（有有效筛选值）
+     * key: filterId (筛选器 uid), value: boolean (是否有有效筛选)
+     */
+    private activeFilterSources;
+    /**
+     * 设置指定筛选来源的活跃状态
+     * @param filterId 筛选器 uid
+     * @param active 是否有有效筛选值
+     */
+    setFilterActive(filterId: string, active: boolean): void;
+    /**
+     * 检查是否有任何活跃的筛选来源
+     * @returns boolean
+     */
+    hasActiveFilters(): boolean;
+    /**
+     * 移除指定筛选来源
+     * @param filterId 筛选器 uid
+     */
+    removeFilterSource(filterId: string): void;
+    /**
+     * 获取数据加载模式
+     * @returns 'auto' | 'manual'
+     */
+    getDataLoadingMode(): 'auto' | 'manual';
     static _getScene(): BlockSceneType[];
     static _isScene(scene: BlockSceneType): boolean;
     getModelClassName(className: string): any;