@nocobase/client 2.1.0-beta.7 → 2.1.0-beta.9

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

@@ -54,6 +54,12 @@ interface Props {
     enableDateVariableAsConstant?: boolean;
 }
 export declare function mergeItemMetaTreeForAssignValue(baseTree: MetaTreeNode[], extraTree: MetaTreeNode[]): MetaTreeNode[];
+export declare function resolveAssignValueFieldPath(itemModel: any): string | undefined;
+export declare function resolveAssignValueFieldModelUse(options: {
+    itemModel: any;
+    fieldModelUse?: string;
+    preferFormItemFieldModel?: boolean;
+}): string | undefined;
 /**
  * 根据所选字段渲染对应的赋值编辑器：
  * - 使用临时的 VariableFieldFormModel 包裹字段模型，确保常量编辑为真实字段组件

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;
+    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/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/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/CollectionBlockModel.d.ts

@@ -22,11 +22,19 @@ export declare class CollectionBlockModel<T = DefaultStructure> extends DataBloc
     private lastSeenDirtyVersion;
     private dirtyRefreshing;
     protected onMount(): void;
+    private getDirtyTrackingVersion;
     onActive(forceRefresh?: boolean): void;
     /**
      * 子菜单过滤函数
      */
     static filterCollection(_collection: Collection): boolean;
+    /**
+     * 判断当前区块模型在 collection 选择菜单中是否应该展示指定数据表。
+     *
+     * @param collection 数据表
+     * @returns 是否显示
+     */
+    static isCollectionAvailable(collection: Collection | undefined): boolean;
     /**
      * 定义子菜单选项
      */

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

@@ -45,6 +45,7 @@ export declare class GridModel<T extends {
     mergeRowsWithItems(rows: Record<string, string[][]>): Record<string, string[][]>;
     resetRows(syncProps?: boolean): void;
     private computePointerPosition;
+    private getDragContainer;
     private updateLayoutSnapshot;
     private scheduleSnapshotRefresh;
     /**

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

@@ -14,6 +14,7 @@ export declare class ChildPageModel extends PageModel {
     tabBarExtraContent: {
         left: React.JSX.Element;
     };
+    renderBackButtonWhenTabsDisabled(): React.JSX.Element;
     createPageTabModelOptions: () => CreateModelOptions;
     handleDragEnd(event: DragEndEvent): Promise<void>;
     render(): React.JSX.Element;

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

@@ -10,6 +10,14 @@ import { DragEndEvent } from '@dnd-kit/core';
 import { PageModel } from './PageModel';
 export declare class RootPageModel extends PageModel {
     mounted: boolean;
+    /**
+     * 新建 tab 在首次保存完成前，前端 route 里可能还没有数据库 id。
+     * 拖拽前兜底触发一次保存，确保 move 接口拿到真实主键。
+     *
+     * @param model - 当前参与拖拽的 tab model
+     * @returns 可用于排序接口的 route id
+     */
+    private ensurePersistedRouteId;
     onMount(): void;
     saveStepParams(): Promise<void>;
     handleDragEnd(event: DragEndEvent): Promise<void>;

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

@@ -18,6 +18,8 @@ export declare class DetailsBlockModel extends CollectionBlockModel<{
     };
 }> {
     static scene: import("../../base").BlockSceneType;
+    private hadSingleRecordData;
+    private hasMultiRefreshDispatched;
     _defaultCustomModelClasses: {
         RecordActionGroupModel: string;
         DetailsItemModel: string;
@@ -28,7 +30,9 @@ export declare class DetailsBlockModel extends CollectionBlockModel<{
     createResource(ctx: any, params: any): SingleRecordResource<unknown> | MultiRecordResource<unknown>;
     onInit(options: any): void;
     isMultiRecordResource(): boolean;
+    hasDispatchedMultiRefresh(): boolean;
     getCurrentRecord(): any;
+    hasAvailableData(): boolean;
     handlePageChange: (page: number) => Promise<void>;
     refresh(): Promise<void>;
     renderPagination(): React.JSX.Element;

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

@@ -22,10 +22,21 @@ export declare class FilterFormGridModel extends GridModel {
         };
     };
     dragOverlayConfig: DragOverlayConfig;
-    private hiddenRows;
     readonly loading: {
         value: boolean;
     };
+    private getAssociationFilterTargetKey;
+    /**
+     * 获取筛选表单当前“完整布局”。
+     * 折叠态会临时裁剪 props.rows，因此这里优先选取行数更多的那份布局，
+     * 避免拖拽排序或重新挂载后只拿到被裁剪过的运行时 rows。
+     */
+    private getFullLayout;
+    /**
+     * 按“可视字段行数”裁剪布局，而不是只按 grid row 数裁剪。
+     * 这样即使拖拽后多个字段被排进同一个 cell，也仍然可以正确折叠。
+     */
+    private limitRowsByVisibleCount;
     toggleFormFieldsCollapse(collapse: boolean, visibleRows: number): void;
     onModelCreated(subModel: FilterFormItemModel): Promise<void>;
     renderAddSubModelButton(): React.JSX.Element;

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

@@ -11,6 +11,7 @@ import React from 'react';
 import { FormBlockModel } from './FormBlockModel';
 export declare class CreateFormModel extends FormBlockModel {
     static scene: import("../../base/BlockModel").BlockSceneType;
+    static blockCapabilityActionName: string;
     private actionFlowSettings;
     private actionExtraToolbarItems;
     createResource(ctx: any, params: any): SingleRecordResource<unknown>;

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

@@ -11,11 +11,13 @@ import React from 'react';
 import { FormBlockModel } from './FormBlockModel';
 export declare class EditFormModel extends FormBlockModel {
     static scene: import("../../base").BlockSceneType;
+    static blockCapabilityActionName: string;
     private actionFlowSettings;
     private actionExtraToolbarItems;
     createResource(_ctx: FlowModelContext, params: any): SingleRecordResource<unknown> | MultiRecordResource<unknown>;
     isMultiRecordResource(): boolean;
     getCurrentRecord(): any;
+    hasAvailableData(): boolean;
     getAclActionName(): string;
     handlePageChange: (page: number) => Promise<void>;
     submitHandler(ctx: any, params: any, cb?: (values?: any, filterByTk?: any) => void): Promise<void>;

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

@@ -6,7 +6,15 @@
  * 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 { NamePath } from './value-runtime/types';
 import type { FormBlockModel } from './FormBlockModel';
+/**
+ * 生成提交前的校验字段列表：
+ * - 在配置态下可用于绕开“联动隐藏字段”的必填校验；
+ * - 仅排除 `model.hidden=true` 的字段路径；
+ * - 返回 null 表示无法安全推断，调用方应回退到 `validateFields()` 全量校验。
+ */
+export declare function getValidationNamePathsExcludingHiddenModels(blockModel: FormBlockModel): NamePath[] | null;
 /**
  * 提交前过滤：移除当前表单 block 中被「联动规则隐藏」的字段值（`model.hidden === true`）。
  *

package/es/flow/models/fields/DisplayAssociationField/displaySubListUtils.d.ts

@@ -0,0 +1,14 @@
+/**
+ * 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 normalizeFieldIndexChain: (fieldIndex: unknown) => string[];
+export declare const buildDisplaySubListForkKey: ({ parentFieldIndex, index, blockPage, }: {
+    parentFieldIndex: string[];
+    index: number;
+    blockPage: number;
+}) => string;

package/es/flow/utils/actionCapability.d.ts

@@ -0,0 +1,60 @@
+/**
+ * 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 CapabilityCollection = {
+    options?: Record<string, any>;
+};
+type CapabilityModelClass = {
+    prototype?: {
+        getAclActionName?: () => string | null | undefined;
+    };
+    capabilityActionName?: string | null;
+    capabilityActionNames?: string[] | null;
+    blockCapabilityActionName?: string | null;
+    blockCapabilityActionNames?: string[] | null;
+};
+/**
+ * 统一动作能力名，保证 v2 与 v1 使用同一套数据源动作键。
+ *
+ * @param actionName 动作名
+ * @returns 归一化后的动作能力名
+ */
+export declare const normalizeCapabilityActionName: (actionName?: string | null) => string;
+/**
+ * 判断 collection 是否支持指定动作能力。
+ *
+ * @param collection 数据表
+ * @param capabilityName 动作能力键
+ * @returns 是否支持
+ */
+export declare const isCapabilitySupported: (collection: CapabilityCollection | null | undefined, capabilityName?: string | null) => boolean;
+/**
+ * 判断 collection 是否支持一组动作能力。
+ *
+ * @param collection 数据表
+ * @param capabilityNames 动作能力键数组
+ * @returns 是否全部支持
+ */
+export declare const areCapabilitiesSupported: (collection: CapabilityCollection | null | undefined, capabilityNames?: Array<string | null | undefined> | null) => boolean;
+/**
+ * 推导动作模型使用的数据源动作能力键。
+ * 默认会回落到 getAclActionName，但允许通过静态字段显式覆写。
+ *
+ * @param ModelClass 动作模型类
+ * @returns 动作能力键数组或 null
+ */
+export declare const getActionCapabilityNamesFromModelClass: (ModelClass: CapabilityModelClass) => string[];
+/**
+ * 推导区块模型在“选择 collection”时需要满足的数据源动作能力键。
+ * 仅对显式声明的区块生效，避免误把所有区块都套上 view/create/update 过滤。
+ *
+ * @param ModelClass 区块模型类
+ * @returns 动作能力键数组或 null
+ */
+export declare const getBlockCapabilityNamesFromModelClass: (ModelClass: CapabilityModelClass) => string[];
+export {};