@nocobase/client-v2 2.2.0-beta.9 → 3.0.0-alpha.1

package/es/APIClient.d.ts

@@ -6,10 +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 { APIClient as APIClientSDK, type APIClientOptions } from '@nocobase/sdk';
+import { APIClient as APIClientSDK } from '@nocobase/sdk';
 export declare class APIClient extends APIClientSDK {
-    appName?: string;
-    constructor(options?: APIClientOptions);
     getHostname(): string;
     getHeaders(): {};
     interceptors(): void;

package/es/BaseApplication.d.ts

@@ -143,6 +143,7 @@ export declare abstract class BaseApplication<TOptions extends BaseApplicationOp
     setMaintaining(maintaining: boolean): void;
     getOptions(): TOptions;
     getName(): string;
+    getCdnUrl(): string;
     getPublicPath(): string;
     getApiUrl(pathname?: string): string;
     getRouteUrl(pathname: string): string;

package/es/acl/ACLProvider.d.ts

@@ -43,6 +43,16 @@ export declare const ACLRolesCheckProvider: FC;
  * 返回原始 ACL provider 上下文。
  */
 export declare const useACLContext: () => ACLContextValue;
+/**
+ * 读取当前角色的 snippets，且不要求调用方位于 `ACLRolesCheckProvider` 之内。
+ *
+ * 设置中心顶栏导航挂在 app 级 provider 上，位置比 `ACLRolesCheckProvider` 更外层，
+ * 这种情况下退回到 app context 上的 ACL observable store。
+ * 调用方需要用 `observer` 包裹，store 更新后才会重新渲染。
+ *
+ * @returns {string[]} 当前角色的 snippets
+ */
+export declare const useACLSnippets: () => string[];
 /**
  * 触发当前角色权限重新检查。
  */

package/es/authRedirect.d.ts

@@ -8,6 +8,11 @@
  */
 import type { BaseApplication } from './BaseApplication';
 type AppLike = Pick<BaseApplication<any>, 'getPublicPath'> & {
+    name?: string;
+    pluginSettingsManager?: {
+        getRouteName?: (name: string) => string;
+        getRoutePath?: (name: string) => string;
+    };
     router?: {
         getBasename?: () => string | undefined;
     };

package/es/collection-field-interface/CollectionFieldInterface.d.ts

@@ -98,6 +98,7 @@ export declare abstract class CollectionFieldInterface {
     titleUsable?: boolean;
     usePathOptions?(field: any): any;
     hidden?: boolean;
+    creatable?: boolean;
     addComponentOption(componentOption: CollectionFieldInterfaceComponentOption): void;
     getConfigureFormProperties(collectionInfo?: any): Record<string, ISchema>;
     getDefaultValueProperty(): {

package/es/collection-field-interface/CollectionFieldInterfaceManager.d.ts

@@ -15,6 +15,7 @@ interface FieldInterfaceLike {
     title?: ReactNode;
     group?: string;
     order?: number;
+    creatable?: boolean;
     isAssociation?: boolean;
     supportDataSourceType?: string[];
     notSupportDataSourceType?: string[];

package/es/components/AttachmentUpload.d.ts

@@ -0,0 +1,51 @@
+/**
+ * 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 type UploadedAttachment = {
+    id?: number;
+    title?: string;
+    filename?: string;
+    url?: string;
+};
+export type AttachmentStorageRules = {
+    size?: number;
+    mimetype?: string | string[];
+};
+/**
+ * 读取默认附件存储的上传限制。
+ *
+ * 校验交给存储自身的配置（大小、mimetype），而不是在每个调用点各写一套硬编码规则。
+ *
+ * @returns {AttachmentStorageRules | null} 存储规则，取不到时为 null
+ */
+export declare function useAttachmentStorageRules(): AttachmentStorageRules;
+export type AttachmentUploadProps = {
+    value?: UploadedAttachment | null;
+    onChange?: (value: UploadedAttachment | null) => void;
+    /** 卡片尺寸；`fit` 对应 CSS object-fit */
+    preview?: {
+        width?: number;
+        height?: number;
+        fit?: 'contain' | 'cover';
+    };
+    /** 在存储规则之外再收窄可选文件类型，例如只收图片 */
+    accept?: string;
+    /** 上传卡片里 `+` 下方的文字 */
+    uploadText?: string;
+    disabled?: boolean;
+};
+/**
+ * 附件上传控件。
+ *
+ * 受控组件，值就是 `attachments:create` 返回的附件对象，可直接挂在 `Form.Item` 上。
+ * 外观沿用附件字段的原生形态：一张 picture-card，删除在卡片自身的悬浮操作里，不额外摆按钮。
+ * 上传前按默认存储的规则校验大小与 mimetype，与业务表单里的附件字段保持同一套限制。
+ */
+export declare const AttachmentUpload: React.FC<AttachmentUploadProps>;
+export default AttachmentUpload;

package/es/components/category-tabs/SortableCategoryTabs.d.ts

@@ -0,0 +1,55 @@
+/**
+ * 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';
+/**
+ * A category descriptor for {@link SortableCategoryTabs}. The component is
+ * i18n-agnostic: `label` is rendered verbatim, so consumers pass an
+ * already-compiled/translated node. `color` is an antd preset color name or a
+ * hex string; `'default'` / `undefined` renders no badge color.
+ */
+export type SortableCategoryTabItem = {
+    id: string | number;
+    label: React.ReactNode;
+    color?: string;
+};
+export type SortableCategoryTabsProps = {
+    activeKey: string;
+    onChange: (key: string) => void;
+    /** Draggable category tabs (the fixed leading tab is configured via `allTab`). */
+    categories: SortableCategoryTabItem[];
+    /** The fixed, non-draggable leading tab, e.g. "All". */
+    allTab: {
+        key: string;
+        label: React.ReactNode;
+    };
+    /** Show the "+" add button and handle its click. */
+    onAdd?: () => void;
+    /** Per-category edit menu item handler; menu is hidden when omitted. */
+    onEdit?: (id: string | number) => void;
+    /** Per-category delete menu item handler; menu is hidden when omitted. */
+    onDelete?: (id: string | number) => void;
+    /** Reorder handler. Receives the dragged and dropped category ids. */
+    onSort?: (sourceId: string | number, targetId: string | number) => void | Promise<void>;
+    /** Consumer-translated labels for the per-category dropdown menu. */
+    menuLabels?: {
+        edit?: string;
+        delete?: string;
+    };
+    className?: string;
+};
+/**
+ * A draggable, editable category tab bar. Renders only the tab bar (no content
+ * panes) — the page renders its content below and reacts to `activeKey`.
+ *
+ * Shared by settings pages that group records under reorderable categories
+ * (data-source collections, workflows, …). Drag-to-reorder is powered by
+ * `@dnd-kit`; the "+" / per-tab edit-delete affordances are optional.
+ */
+export declare function SortableCategoryTabs(props: SortableCategoryTabsProps): React.JSX.Element;
+export default SortableCategoryTabs;

package/es/components/category-tabs/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 './SortableCategoryTabs';

package/es/components/form/ScanInput/useCodeScanner.d.ts

@@ -15,17 +15,18 @@ type UseCodeScannerOptions = {
     enabled: boolean;
     elementId: string;
     formatsToSupport?: CodeFormatsToSupport;
-    scanBoxSize?: ScannerSize;
     onScannerSizeChanged?: (size: ScannerSize) => void;
     onScanSuccess: (text: string) => void;
     onScanFailure?: () => void;
+    onCameraStartFailure?: (error: unknown) => void;
 };
 export declare const DEFAULT_CODE_FORMATS: CodeFormatsToSupport;
 export declare function getCodeScanBoxSize(width: number, height: number): {
     width: number;
     height: number;
 };
-export declare function useCodeScanner({ enabled, elementId, formatsToSupport, scanBoxSize, onScannerSizeChanged, onScanSuccess, onScanFailure, }: UseCodeScannerOptions): {
+export declare function scanQrVideoFrame(video: HTMLVideoElement, canvas: HTMLCanvasElement): string;
+export declare function useCodeScanner({ enabled, elementId, formatsToSupport, onScannerSizeChanged, onScanSuccess, onScanFailure, onCameraStartFailure, }: UseCodeScannerOptions): {
     startScanFile: (file: File) => Promise<void>;
 };
 export {};

package/es/components/form/TypedVariableInput.d.ts

@@ -10,11 +10,11 @@ import { type MetaTreeNode } from '@nocobase/flow-engine';
 import React from 'react';
 import { type VariableDelimiters } from './VariableInput';
 /**
- * Constant types this input can edit. Subset of v1 `Variable.Input`
- * `useTypedConstant` — drops `'object'` (no v2 JSON editor yet) and `'null'`
- * (handled by the dedicated `nullable` prop).
+ * Constant types this input can edit. Matches v1 `Variable.Input`
+ * `useTypedConstant` minus `'null'` (handled by the dedicated `nullable` prop).
+ * `'object'` renders an inline JSON editor (textarea).
  */
-export type TypedConstantType = 'string' | 'number' | 'boolean' | 'date';
+export type TypedConstantType = 'string' | 'number' | 'boolean' | 'date' | 'object';
 /**
  * One allowed constant type. Either a bare type name (`'number'`) or a
  * `[type, editorProps]` pair (`['number', { min: 1, max: 65535 }]`) where
@@ -33,25 +33,51 @@ export interface TypedVariableInputProps {
      * Allowed constant types. The `Constant` switcher entry always exposes a
      * typed submenu (matching v1 `Variable.Input`) so users can see what type
      * the constant is, even when only one type is permitted. Default: all four
-     * supported types.
+     * supported types. Passing `[]` switches the component into a variable-only
+     * mode: constants/null are hidden, the empty state becomes a readonly
+     * placeholder, and clearing a selected variable resets to `null`.
      */
     types?: TypedConstantSpec[];
     /**
      * Restrict the variable picker to specific top-level meta-tree namespaces
      * (e.g. `['$env']`). When omitted, every registered top-level property is
      * exposed — matching `VariableInput`'s default behaviour.
+     *
+     * Ignored when `metaTree` is supplied (an explicit tree wins).
      */
     namespaces?: string[];
     /** Additional leaves appended to the picker after the namespace-filtered nodes. */
     extraNodes?: MetaTreeNode[];
+    /**
+     * Provide the variable tree explicitly instead of reading the global
+     * FlowContext meta tree. When set, `namespaces`/`extraNodes` are ignored and
+     * this tree is used verbatim — use for context-scoped variable sources that
+     * are not part of the global registry (e.g. a workflow node's upstream
+     * outputs). Lazy `children` thunks are resolved on demand as the user
+     * expands the cascader.
+     */
+    metaTree?: MetaTreeNode[];
     /**
      * When true (default), the switcher exposes a `Null` option that resets the
      * value to `null`. When false, the value is constrained to one of the
      * allowed types or a variable reference.
      */
     nullable?: boolean;
+    /**
+     * Opt-in: when the incoming `value` is `undefined`, initialize the editor to
+     * the first allowed constant type instead of rendering the null-mode
+     * placeholder. `null` still keeps its explicit null semantics; only
+     * `undefined` triggers this path.
+     */
+    defaultToFirstConstantTypeWhenUndefined?: boolean;
     /** Variable-token delimiters. Default `['{{', '}}']` — see `VariableInput`. */
     delimiters?: VariableDelimiters;
+    /**
+     * Hide variable choices from the switcher. In variable-only mode this hides
+     * the selector button entirely; in mixed constant/variable mode it keeps the
+     * null/constant choices but removes variable entries.
+     */
+    hideVariable?: boolean;
     disabled?: boolean;
     placeholder?: string;
     style?: React.CSSProperties;

package/es/components/form/filter/CollectionFilter.d.ts

@@ -15,6 +15,8 @@ export interface CollectionFilterProps {
     collection: Collection | undefined;
     /** Previously compiled filter param used to seed the editable filter group. */
     initialValue?: CompiledFilter;
+    /** Default compiled filter used both for initial empty state and Reset. */
+    defaultValue?: CompiledFilter;
     /** Called on Submit or Reset with the compiled NocoBase filter param (`undefined` when cleared). */
     onChange: (filter: CompiledFilter) => void;
     /** Translator. Defaults to identity. */

package/es/components/form/filter/CollectionFilterItem.d.ts

@@ -37,6 +37,16 @@ export interface CollectionFilterItemProps {
     app?: {
         getComponent?: (name: string) => React.ComponentType<any> | undefined;
     };
+    /** Optional override for the left field picker placeholder. */
+    fieldPlaceholder?: string;
+    /** Optional override for the operator picker placeholder. */
+    operatorPlaceholder?: string;
+    /** Optional override for the value input placeholder. Pass `null` to suppress it. */
+    valuePlaceholder?: string | null;
+    /** Optional override for the left field picker width. Defaults to v2's original 200px. */
+    fieldWidth?: number;
+    /** Optional override for the operator picker min-width. Defaults to v2's original 120px. */
+    operatorMinWidth?: number;
 }
 /**
  * Filter row bound directly to a `Collection`, with no `FlowModel` dependency. Use this from settings pages or other surfaces that need a filter UI but don't have (and shouldn't synthesise) a block model just to satisfy `FilterItem`. Pair with `FilterContainer` via either an inline wrapper or `createCollectionFilterItem(collection)`.
@@ -47,7 +57,7 @@ export declare const CollectionFilterItem: FC<CollectionFilterItemProps>;
 /**
  * Convenience factory returning a `FilterContainer`-compatible `FilterItem` component bound to a specific collection. Avoids creating an inline closure on every parent render, which would otherwise reset any focused inner antd control.
  */
-export declare function createCollectionFilterItem(collection: Collection, bound?: Pick<CollectionFilterItemProps, 'filterableFieldNames' | 'nonfilterableFieldNames' | 'noIgnore' | 't' | 'app'>): React.FC<{
+export declare function createCollectionFilterItem(collection: Collection, bound?: Pick<CollectionFilterItemProps, 'filterableFieldNames' | 'nonfilterableFieldNames' | 'noIgnore' | 't' | 'app' | 'fieldPlaceholder' | 'operatorPlaceholder' | 'valuePlaceholder' | 'fieldWidth' | 'operatorMinWidth'>): React.FC<{
     value: CollectionFilterItemValue;
 }>;
 export default CollectionFilterItem;

package/es/components/form/filter/CollectionFilterPanel.d.ts

@@ -18,6 +18,8 @@ export interface CollectionFilterPanelProps {
     collection: Collection | undefined;
     /** Previously compiled filter param used to seed the editable filter group. */
     initialValue?: CompiledFilter;
+    /** Default compiled filter used both for initial empty state and Reset. */
+    defaultValue?: CompiledFilter;
     /** Called when the condition group structure changes or `reset()` is invoked. */
     onChange?: (filter: CompiledFilter) => void;
     /** Translator. Defaults to identity. */

package/es/components/form/filter/index.d.ts

@@ -9,5 +9,7 @@
 export { CollectionFilter } from './CollectionFilter';
 export type { CollectionFilterProps } from './CollectionFilter';
 export { CollectionFilterPanel } from './CollectionFilterPanel';
+export { CollectionFilterItem } from './CollectionFilterItem';
+export type { CollectionFilterItemValue } from './CollectionFilterItem';
 export type { CollectionFilterPanelProps, CollectionFilterPanelRef } from './CollectionFilterPanel';
 export type { CompiledFilter } from './useFilterActionProps';

package/es/components/form/filter/useFilterActionProps.d.ts

@@ -46,6 +46,8 @@ export interface UseFilterActionPropsArgs extends UseFilterOptionsArgs {
     collection: Collection | undefined;
     /** Previously compiled filter param used to seed the editable filter group. */
     initialValue?: CompiledFilter;
+    /** Default compiled filter used both for initial empty state and Reset. */
+    defaultValue?: CompiledFilter;
     /**
      * Called when the user submits or resets the filter popover. Receives the compiled filter param (`undefined` when cleared) and which footer button triggered the call. Typical implementation: `(filter, action) => { listRequest.run(filter); if (action === 'submit') closePopover(); }`.
      */

package/es/components/index.d.ts

@@ -7,7 +7,9 @@
  * For more information, please refer to: https://www.nocobase.com/agreement.
  */
 export * from './AppComponents';
+export * from './AttachmentUpload';
 export * from './BlankComponent';
+export * from './category-tabs';
 export * from './form/table/dnd';
 export * from './form';
 export * from './Icon';

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

@@ -35,7 +35,7 @@ export * from './formAssignRules';
 export * from './filterFormDefaultValues';
 export * from './linkageRulesRefresh';
 export * from './blockHeight';
-export { fieldLinkageRules, subFormFieldLinkageRules, detailsFieldLinkageRules, linkageSetDetailsFieldProps, actionLinkageRules, menuLinkageRules, blockLinkageRules, linkageSetBlockProps, linkageSetActionProps, linkageSetMenuItemProps, linkageSetFieldProps, subFormLinkageSetFieldProps, linkageAssignField, linkageRunjs, subFormLinkageAssignField, } from './linkageRules';
+export { fieldLinkageRules, subFormFieldLinkageRules, detailsFieldLinkageRules, linkageSetDetailsFieldProps, actionLinkageRules, menuLinkageRules, tabLinkageRules, blockLinkageRules, linkageSetBlockProps, linkageSetActionProps, linkageSetMenuItemProps, linkageSetTabProps, linkageSetFieldProps, subFormLinkageSetFieldProps, linkageAssignField, linkageRunjs, subFormLinkageAssignField, } from './linkageRules';
 export { displayFieldComponent } from './displayFieldComponent';
 export * from './overflowMode';
 export * from './numberFormat';

package/es/flow/actions/linkageRules.d.ts

@@ -7,9 +7,11 @@
  * For more information, please refer to: https://www.nocobase.com/agreement.
  */
 import { FlowContext, FlowModel } from '@nocobase/flow-engine';
+export declare function updateLinkageRules<T>(rules: T[], updater: (nextRules: T[]) => void): T[];
 export declare const linkageSetBlockProps: import("@nocobase/flow-engine").ActionDefinition<FlowModel<import("@nocobase/flow-engine").DefaultStructure>, FlowContext>;
 export declare const linkageSetActionProps: import("@nocobase/flow-engine").ActionDefinition<FlowModel<import("@nocobase/flow-engine").DefaultStructure>, FlowContext>;
 export declare const linkageSetMenuItemProps: import("@nocobase/flow-engine").ActionDefinition<FlowModel<import("@nocobase/flow-engine").DefaultStructure>, FlowContext>;
+export declare const linkageSetTabProps: import("@nocobase/flow-engine").ActionDefinition<FlowModel<import("@nocobase/flow-engine").DefaultStructure>, FlowContext>;
 export declare const linkageSetFieldProps: import("@nocobase/flow-engine").ActionDefinition<FlowModel<import("@nocobase/flow-engine").DefaultStructure>, FlowContext>;
 export declare const subFormLinkageSetFieldProps: import("@nocobase/flow-engine").ActionDefinition<FlowModel<import("@nocobase/flow-engine").DefaultStructure>, FlowContext>;
 export declare const linkageSetDetailsFieldProps: import("@nocobase/flow-engine").ActionDefinition<FlowModel<import("@nocobase/flow-engine").DefaultStructure>, FlowContext>;
@@ -20,6 +22,7 @@ export declare const linkageRunjs: import("@nocobase/flow-engine").ActionDefinit
 export declare const blockLinkageRules: import("@nocobase/flow-engine").ActionDefinition<FlowModel<import("@nocobase/flow-engine").DefaultStructure>, FlowContext>;
 export declare const actionLinkageRules: import("@nocobase/flow-engine").ActionDefinition<FlowModel<import("@nocobase/flow-engine").DefaultStructure>, FlowContext>;
 export declare const menuLinkageRules: import("@nocobase/flow-engine").ActionDefinition<FlowModel<import("@nocobase/flow-engine").DefaultStructure>, FlowContext>;
+export declare const tabLinkageRules: import("@nocobase/flow-engine").ActionDefinition<FlowModel<import("@nocobase/flow-engine").DefaultStructure>, FlowContext>;
 export declare const fieldLinkageRules: import("@nocobase/flow-engine").ActionDefinition<FlowModel<import("@nocobase/flow-engine").DefaultStructure>, FlowContext>;
 export declare const subFormFieldLinkageRules: import("@nocobase/flow-engine").ActionDefinition<FlowModel<import("@nocobase/flow-engine").DefaultStructure>, FlowContext>;
 export declare const detailsFieldLinkageRules: import("@nocobase/flow-engine").ActionDefinition<FlowModel<import("@nocobase/flow-engine").DefaultStructure>, FlowContext>;

package/es/flow/admin-shell/admin-layout/AdminLayoutMenuModels.d.ts

@@ -32,6 +32,7 @@ export declare class AdminLayoutMenuItemModel extends FlowModel<AdminLayoutMenuI
     buildRouteOptionsWithPersistedFlowFlag(hasPersistedMenuInstanceFlow: boolean): {
         [x: string]: any;
         hasPersistedMenuInstanceFlow?: boolean;
+        hasPersistedPageTabFlowModel?: boolean;
     };
     syncPersistedFlowRouteFlag(): Promise<void>;
     destroyPersistedState(): Promise<void>;

package/es/flow/admin-shell/admin-layout/NocoBaseLogo.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 NocoBaseLogo: React.MemoExoticComponent<import("@formily/reactive-react").ReactFC<unknown>>;

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

@@ -19,5 +19,6 @@ export interface FieldAssignExactDatePickerProps {
     isRange?: boolean;
     onChange?: (value: ExactDatePickerValue) => void;
     style?: React.CSSProperties;
+    disabled?: boolean;
 }
 export declare const FieldAssignExactDatePicker: React.FC<FieldAssignExactDatePickerProps>;

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

@@ -10,6 +10,11 @@ import React from 'react';
 import { dayjs } from '@nocobase/utils/client';
 import { type CollectionField, type MetaTreeNode } from '@nocobase/flow-engine';
 import { type ExactDatePickerMode } from './FieldAssignExactDatePicker';
+type VariableInputConverters = {
+    renderInputComponent?: (metaTreeNode: MetaTreeNode | null) => React.ComponentType<any> | null;
+    resolvePathFromValue?: (value: any) => string[] | undefined;
+    resolveValueFromPath?: (metaTreeNode: MetaTreeNode) => any;
+};
 export type DateVariableExactNormalizeMode = 'none' | 'date' | 'datetimeNoTz' | 'iso';
 export declare function toExactPickerDisplayValue(rawValue: unknown, options: {
     format: string;
@@ -52,7 +57,11 @@ interface Props {
      * 默认 false，保持历史行为。
      */
     enableDateVariableAsConstant?: boolean;
+    /** 是否允许在变量选择器中使用 RunJS。默认 true，保持历史行为。 */
+    allowRunJS?: boolean;
     maxAssociationFieldDepth?: number;
+    disabled?: boolean;
+    variableConverters?: VariableInputConverters;
 }
 export declare function mergeItemMetaTreeForAssignValue(baseTree: MetaTreeNode[], extraTree: MetaTreeNode[]): MetaTreeNode[];
 export declare function resolveAssignValueFieldPath(itemModel: any): string | undefined;

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

@@ -19,8 +19,8 @@ export type FlowRouteProps = {
 /**
  * 管理后台动态页面路由组件。
  *
- * 负责读取当前路由页面 UID，补充运行时设备变量，
- * 并把页面生命周期桥接到 AdminLayout host model。
+ * 负责读取当前路由页面 UID，并把页面生命周期桥接到 AdminLayout host model。
+ * 设备变量通常由 PluginFlowEngine 共享初始化提供；独立渲染时会在挂载后补充注册。
  *
  * @example
  * ```tsx

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

@@ -12,6 +12,7 @@ export interface RunJSValueEditorProps {
     t?: (key: string) => string;
     value?: unknown;
     onChange?: (value: RunJSValue) => void;
+    disabled?: boolean;
     height?: string;
     scene?: string;
     containerStyle?: React.CSSProperties;

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

@@ -25,6 +25,7 @@ interface FilterGroupProps {
     value: Record<string, any>;
     /** 自定义筛选项组件 */
     FilterItem?: React.FC<FilterItemProps>;
+    disabled?: boolean;
     closeIcon?: ReactNode;
     /** 是否显示边框 */
     showBorder?: boolean;

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

@@ -7,7 +7,7 @@
  * For more information, please refer to: https://www.nocobase.com/agreement.
  */
 import React from 'react';
-import { type MetaTreeNode, FlowModel } from '@nocobase/flow-engine';
+import { type MetaTreeNode, type Converters, FlowModel } from '@nocobase/flow-engine';
 export interface VariableFilterItemValue {
     path: string;
     operator: string;
@@ -19,6 +19,7 @@ export interface VariableFilterItemProps {
     /** 筛选条件值对象 */
     value: VariableFilterItemValue;
     model: FlowModel;
+    disabled?: boolean;
     /**
      * 是否启用右侧 VariableInput（变量或静态值二合一）。
      * 默认 false：保持原有行为，右侧仅静态输入组件。
@@ -29,6 +30,10 @@ export interface VariableFilterItemProps {
      * 默认使用整棵 ctx 的 metaTree：model.context.getPropertyMetaTree()
      */
     rightMetaTree?: MetaTreeNode[] | (() => MetaTreeNode[] | Promise<MetaTreeNode[]>);
+    /**
+     * 右侧变量的领域转换器。常量和空值仍由 VariableFilterItem 处理，未匹配的值回退到 FlowEngine 默认转换器。
+     */
+    rightVariableConverters?: Pick<Converters, 'resolvePathFromValue' | 'resolveValueFromPath'>;
     ignoreFieldNames?: string[];
     maxAssociationFieldDepth?: number;
 }

package/es/flow/index.d.ts

@@ -21,6 +21,7 @@ export * from './FlowPage';
 export * from './models';
 export * from './utils';
 export * from './actions';
+export { FieldAssignValueInput } from './components/FieldAssignValueInput';
 export * from './system-settings';
 export * from './admin-shell/admin-layout';
 export * from './admin-shell/BaseLayoutModel';

package/es/flow/internal/registerDeviceTypeContext.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 type { FlowEngine } from '@nocobase/flow-engine';
+export declare const registerDeviceTypeContext: (flowEngine: FlowEngine) => void;

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

@@ -6,7 +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 { DefaultStructure, FlowModel } from '@nocobase/flow-engine';
+import { FlowModel } from '@nocobase/flow-engine';
+import type { DefaultStructure, FlowModelOptions } from '@nocobase/flow-engine';
 import type { ButtonProps } from 'antd/es/button';
 import React from 'react';
 export declare function ActionWithoutPermission(props: any): React.JSX.Element;
@@ -41,7 +42,8 @@ export declare class ActionModel<T extends DefaultStructure = DefaultStructure>
     static _getScene(): any[];
     static _isScene(scene: ActionSceneType): boolean;
     getAclActionName(): any;
-    onInit(options: any): void;
+    onInit(options: FlowModelOptions<T>): void;
+    serialize(): Record<string, any>;
     getInputArgs(): Record<string, any>;
     onClick(event: any): void;
     getTitle(): string;

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

@@ -11,8 +11,11 @@ import React from 'react';
 import { FilterManager } from '../blocks/filter-manager/FilterManager';
 import { GridModel } from './GridModel';
 export declare class BlockGridModel extends GridModel {
+    private viewActivatedListener?;
     dragOverlayConfig: DragOverlayConfig;
     onInit(options: any): void;
+    onMount(): void;
+    protected onUnmount(): void;
     get subModelBaseClasses(): string[];
     get filterManager(): FilterManager;
     get addBlockItems(): SubModelItemsType | undefined;

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

@@ -26,11 +26,23 @@ export declare class PageModel extends FlowModel<PageModelStructure> {
     private dirtyRefreshScheduled;
     private unmounted;
     private documentTitleUpdateVersion;
+    private implicitActiveKey?;
+    private locallyCommittedTabTransition?;
     /**
      * 根页面标签页开关以路由表为准，避免 flow model 里的旧配置覆盖路由管理设置。
      */
     private getEnableTabs;
+    private getAllTabs;
+    private getUnhiddenTabs;
+    private getRequestedTabKey;
+    private resolveTabActiveState;
     private getActiveTabKey;
+    private getTabActiveKeySyncDependency;
+    private requestDocumentTitleUpdate;
+    private rememberImplicitActiveKey;
+    private commitTabActiveKey;
+    private consumeLocallyCommittedTabTransition;
+    private synchronizeTabActiveKey;
     private scheduleActiveLifecycleRefresh;
     activateCurrentTab(forceRefresh?: boolean): void;
     deactivateCurrentTab(): void;

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

@@ -0,0 +1,22 @@
+/**
+ * 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 { Tabs } from 'antd';
+import type { TabsProps } from 'antd';
+import React from 'react';
+export declare const NO_ACTIVE_PAGE_TAB_KEY = "__no_active_page_tab__";
+type RenderTabBar = NonNullable<React.ComponentProps<typeof Tabs>['renderTabBar']>;
+type PageTabItem = NonNullable<TabsProps['items']>[number];
+type FilteredPageTabBarProps = {
+    hiddenTabKeys: Set<string>;
+    hiddenActiveTabLabel?: React.ReactNode;
+    items: PageTabItem[];
+    tabBarProps: Parameters<RenderTabBar>[0];
+};
+export declare function FilteredPageTabBar({ hiddenTabKeys, hiddenActiveTabLabel, items, tabBarProps, }: FilteredPageTabBarProps): React.JSX.Element;
+export {};

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

@@ -22,9 +22,21 @@ export declare class BasePageTabModel extends FlowModel<{
     render(): React.JSX.Element;
 }
 export declare class RootPageTabModel extends BasePageTabModel {
+    private persistedLinkageRulesHydrated;
+    private persistedLinkageRulesHydrating?;
+    onInit(options: any): void;
+    private hasExplicitLinkageRulesStep;
+    private shouldHydratePersistedLinkageRules;
+    private fetchPersistedAnchor;
+    private performPersistedLinkageRulesHydrate;
+    private hydratePersistedLinkageRules;
+    openFlowSettings(options?: Parameters<FlowModel['openFlowSettings']>[0]): Promise<boolean>;
     renderChildren(): React.JSX.Element;
     saveStepParams(): Promise<void>;
     save(): Promise<void>;
+    private buildAnchorPayload;
+    private persistLinkageRulesToAnchor;
+    private syncPersistedPageTabFlowModelMarker;
     destroy(): Promise<boolean>;
 }
 export declare class ChildPageTabModel extends BasePageTabModel {