@nocobase/client-v2 2.2.0-alpha.1 → 2.2.0-alpha.3

package/es/PluginSettingsManager.d.ts

@@ -86,6 +86,7 @@ interface InternalPageItemRecord extends PluginSettingsPageItemOptions {
 export declare class PluginSettingsManager<TApp extends BaseApplication<any> = BaseApplication<any>> {
     protected menus: Record<string, InternalMenuItemRecord>;
     protected pages: Record<string, InternalPageItemRecord>;
+    protected pluginSettingsLinks: Record<string, string>;
     protected aclSnippets: string[];
     app: TApp;
     private cachedList;
@@ -165,6 +166,38 @@ export declare class PluginSettingsManager<TApp extends BaseApplication<any> = B
      * @returns {boolean} 是否已注册
      */
     has(name: string): boolean;
+    /**
+     * 绑定插件管理列表中的 plugin name 到实际 settings 入口。
+     *
+     * 插件管理列表使用 applicationPlugins.name 判断是否显示 Settings 入口，
+     * 但部分插件会把设置页挂到共享菜单或历史路径下。
+     *
+     * @param pluginName 插件管理列表中的插件名
+     * @param settingsName menu 或 page 名称
+     * @returns {void}
+     */
+    setPluginSettingsLink(pluginName: string, settingsName: string): void;
+    /**
+     * 获取插件管理列表中的 plugin name 对应的 settings 名称。
+     *
+     * @param pluginName 插件管理列表中的插件名
+     * @returns {string} settings 名称
+     */
+    getPluginSettingsName(pluginName: string): string;
+    /**
+     * 判断插件管理列表中的插件是否有可跳转的 settings 入口。
+     *
+     * @param pluginName 插件管理列表中的插件名
+     * @returns {boolean} 是否已注册 settings 入口
+     */
+    hasPluginSettings(pluginName: string): boolean;
+    /**
+     * 获取插件管理列表中的插件对应的 settings 路径。
+     *
+     * @param pluginName 插件管理列表中的插件名
+     * @returns {string} settings 绝对路径
+     */
+    getPluginSettingsRoutePath(pluginName: string): string;
     /**
      * 获取单个 menu 或 page 的只读快照。
      *

package/es/RouteRepository.d.ts

@@ -11,6 +11,9 @@ import type { NocoBaseDesktopRoute } from './flow-compat';
 type RouteSubscriber = () => void;
 type RouteCreateValues = Partial<NocoBaseDesktopRoute>;
 type RouteUpdateValues = Partial<NocoBaseDesktopRoute>;
+type RouteLayoutLike = {
+    uid?: unknown;
+};
 type RouteMutationOptions = {
     refreshAfterMutation?: boolean;
 };
@@ -28,18 +31,22 @@ export declare class RouteRepository {
         api?: APIClient;
     };
     routes: NocoBaseDesktopRoute[];
-    protected subscribers: Set<RouteSubscriber>;
-    protected accessibleLoaded: boolean;
-    protected accessibleLoadingPromise: Promise<NocoBaseDesktopRoute[]> | null;
+    protected subscribers: Map<RouteSubscriber, string>;
+    protected accessibleLoadingPromises: Map<string, Promise<NocoBaseDesktopRoute[]>>;
+    private layoutActivations;
+    private routeCaches;
+    private refreshRequestIds;
+    private notifiedLayoutUid;
     constructor(ctx: {
         api?: APIClient;
     });
+    activateLayout(layout?: RouteLayoutLike): () => void;
     /**
      * 同步当前可访问桌面路由，并通知订阅方刷新。
      *
      * @param routes 最新的桌面路由树
      */
-    setRoutes(routes: NocoBaseDesktopRoute[]): void;
+    setRoutes(routes: NocoBaseDesktopRoute[], layoutUid?: string): void;
     /**
      * 读取当前缓存的桌面路由树。
      *
@@ -58,12 +65,13 @@ export declare class RouteRepository {
      * @returns 最新的路由数组
      */
     refreshAccessible(): Promise<any>;
+    private refreshAccessibleByLayout;
     /**
      * 确保当前用户可访问的桌面路由至少完成一次初始化加载。
      *
      * @returns 当前可访问的路由数组
      */
-    ensureAccessibleLoaded(): Promise<NocoBaseDesktopRoute[]>;
+    ensureAccessibleLoaded(): Promise<any>;
     /**
      * 订阅路由缓存变化，用于驱动 React 上下文刷新。
      *
@@ -118,7 +126,14 @@ export declare class RouteRepository {
     getRouteBySchemaUid(schemaUid: string): NocoBaseDesktopRoute | undefined;
     protected getAPIClient(): APIClient;
     protected getResource(collectionName: string): import("@nocobase/sdk").IResource;
-    protected emitChange(): void;
+    protected emitChange(layoutUid?: string): void;
+    private getCurrentLayoutUid;
+    private normalizeLayoutUid;
+    private getReadableLayoutUid;
+    private getRouteCache;
+    private syncRoutesProperty;
+    private nextRefreshRequestId;
+    private getRefreshRequestId;
     private findRoute;
 }
 export {};

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/JsonTextArea.d.ts

@@ -7,6 +7,7 @@
  * For more information, please refer to: https://www.nocobase.com/agreement.
  */
 import type { TextAreaProps } from 'antd/es/input';
+import type { TextAreaRef } from 'antd/es/input/TextArea';
 import React from 'react';
 export interface JsonTextAreaProps extends Omit<TextAreaProps, 'value' | 'onChange'> {
     value?: unknown;
@@ -15,4 +16,4 @@ export interface JsonTextAreaProps extends Omit<TextAreaProps, 'value' | 'onChan
     json5?: boolean;
     showError?: boolean;
 }
-export declare const JsonTextArea: React.MemoExoticComponent<(props: JsonTextAreaProps) => React.JSX.Element>;
+export declare const JsonTextArea: React.MemoExoticComponent<React.ForwardRefExoticComponent<JsonTextAreaProps & React.RefAttributes<TextAreaRef>>>;

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
@@ -40,16 +40,34 @@ export interface TypedVariableInputProps {
      * 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;
     disabled?: boolean;

package/es/components/form/VariableJsonTextArea.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 { type MetaTreeNode } from '@nocobase/flow-engine';
+import React from 'react';
+import { type JsonTextAreaProps } from './JsonTextArea';
+export interface VariableJsonTextAreaProps extends JsonTextAreaProps {
+    namespaces?: string[];
+    extraNodes?: MetaTreeNode[];
+    metaTree?: MetaTreeNode[] | (() => MetaTreeNode[] | Promise<MetaTreeNode[]>);
+    formatPathToValue?: (meta: MetaTreeNode) => string | undefined;
+}
+export declare const VariableJsonTextArea: React.MemoExoticComponent<(props: VariableJsonTextAreaProps) => React.JSX.Element>;
+export declare const VariableJSON: React.MemoExoticComponent<(props: VariableJsonTextAreaProps) => React.JSX.Element>;

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/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/index.d.ts

@@ -18,3 +18,4 @@ export * from './RemoteSelect';
 export * from './ScanInput';
 export * from './TypedVariableInput';
 export * from './VariableInput';
+export * from './VariableJsonTextArea';

package/es/components/index.d.ts

@@ -8,9 +8,11 @@
  */
 export * from './AppComponents';
 export * from './BlankComponent';
+export * from './category-tabs';
 export * from './form/table/dnd';
 export * from './form';
 export * from './Icon';
+export * from './KeepAlive';
 export * from './PoweredBy';
 export * from './RouterContextCleaner';
 export * from './SwitchLanguage';

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

@@ -6,4 +6,11 @@
  * 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>;
+import { FlowContext, type FlowRuntimeContext, type MetaTreeNode } from '@nocobase/flow-engine';
+type ResponseRecordPlainStepContext = {
+    steps?: FlowRuntimeContext['steps'];
+};
+export declare function getAfterSuccessResponseRecord(ctx: FlowContext | ResponseRecordPlainStepContext): any;
+export declare function getMetaTreeWithResponseRecord(ctx: FlowRuntimeContext): MetaTreeNode[];
+export declare const afterSuccess: import("@nocobase/flow-engine").ActionDefinition<import("@nocobase/flow-engine").FlowModel<import("@nocobase/flow-engine").DefaultStructure>, FlowContext>;
+export {};

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

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

@@ -7,6 +7,8 @@
  * For more information, please refer to: https://www.nocobase.com/agreement.
  */
 import React, { type FC } from 'react';
+import type { AdminLayoutModel } from './AdminLayoutModel';
 export declare const AdminLayoutEntryGuard: FC<{
     children: React.ReactNode;
+    model?: AdminLayoutModel;
 }>;

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

@@ -9,6 +9,7 @@
 import type { FlowSettingsContext } from '@nocobase/flow-engine';
 import { type NocoBaseDesktopRoute } from '../../../flow-compat';
 import { AdminLayoutMenuCreationMeta, AdminLayoutMenuCreationParams, AdminLayoutMenuCreationType, AdminLayoutMenuInsertPosition, getAdminLayoutMenuMovePositionOptions } from './AdminLayoutMenuUtils';
+import { type AdminLayoutRoutePathLike } from './resolveAdminRouteRuntimeTarget';
 declare const buildLinkSettingSchema: (t: (title: any) => any) => {
     href: {
         title: any;
@@ -99,7 +100,7 @@ export declare const createInsertMenuStep: (options: {
 export declare const toTreeSelectItems: (routes: NocoBaseDesktopRoute[], ctx: Pick<FlowSettingsContext<any>, 'resolveJsonTemplate' | 't'>) => any;
 export declare const findPrevSiblingRoute: (routes: NocoBaseDesktopRoute[], currentRoute: NocoBaseDesktopRoute | undefined) => any;
 export declare const findNextSiblingRoute: (routes: NocoBaseDesktopRoute[], currentRoute: NocoBaseDesktopRoute | undefined) => any;
-export declare const matchesRoutePath: (route: NocoBaseDesktopRoute | undefined, pathname: string, basename?: string) => boolean;
+export declare const matchesRoutePath: (route: NocoBaseDesktopRoute | undefined, pathname: string, basename?: string, layout?: AdminLayoutRoutePathLike | null) => boolean;
 export declare const buildInsertRouteSchema: (menuType: AdminLayoutMenuCreationType, pageSchemaUid: string, tabSchemaUid: string, tabSchemaName: string) => {
     type: string;
     'x-component': string;

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

@@ -10,6 +10,7 @@ import React from 'react';
 import { FlowModel } from '@nocobase/flow-engine';
 import { type NocoBaseDesktopRoute } from '../../../flow-compat';
 import { AdminLayoutMenuCreationMeta, AdminLayoutMenuCreationParams, AdminLayoutMenuInsertPosition, AdminLayoutMenuItemStructure, AdminLayoutMenuNode, AdminLayoutMenuRouteOptions } from './AdminLayoutMenuUtils';
+import { type AdminLayoutRoutePathLike } from './resolveAdminRouteRuntimeTarget';
 export * from './AdminLayoutMenuUtils';
 export declare class AdminLayoutMenuItemModel extends FlowModel<AdminLayoutMenuItemStructure> {
     private creationPersisted;
@@ -23,6 +24,7 @@ export declare class AdminLayoutMenuItemModel extends FlowModel<AdminLayoutMenuI
     isCreationSession(): boolean;
     shouldHydratePersistedState(): boolean;
     getRouteRepository(): any;
+    getLayout(): AdminLayoutRoutePathLike | undefined;
     hasPersistedMenuInstanceFlowFlag(route?: NocoBaseDesktopRoute): boolean;
     getCurrentPersistedInstanceFlowCount(): number;
     hasPersistableMenuLinkageRules(): boolean;

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

@@ -11,6 +11,7 @@ import React, { FC } from 'react';
 import { type NavigateFunction } from 'react-router-dom';
 import { type NocoBaseDesktopRoute } from '../../../flow-compat';
 import type { AdminLayoutMenuItemModel } from './AdminLayoutMenuModels';
+import { type AdminLayoutRoutePathLike } from './resolveAdminRouteRuntimeTarget';
 export type AdminLayoutMenuRenderType = 'item' | 'group';
 export type AdminLayoutMenuRenderOptions = {
     isMobile?: boolean;
@@ -81,7 +82,7 @@ type AdminLayoutMenuItemsParent = FlowModel & {
  * @param identity 节点身份
  * @returns 唯一占位路径
  */
-export declare const getAdminLayoutMenuVirtualPath: (type: 'link' | 'designer', identity: string | number) => string;
+export declare const getAdminLayoutMenuVirtualPath: (type: 'link' | 'designer', identity: string | number, layout?: AdminLayoutRoutePathLike | null) => string;
 /**
  * 仅在模板表达式内部兼容历史菜单变量写法，避免误改普通文本。
  * @param template 原始模板字符串
@@ -159,7 +160,7 @@ export declare const AdminLayoutMenuModelRenderer: FC<{
     renderType: AdminLayoutMenuRenderType;
     options?: AdminLayoutMenuRenderOptions;
 }>;
-export declare function getAdminLayoutMenuInitializerButton(testId: string, launcherModel: FlowModel, parentRoute?: NocoBaseDesktopRoute): AdminLayoutMenuNode;
+export declare function getAdminLayoutMenuInitializerButton(testId: string, launcherModel: FlowModel, parentRoute?: NocoBaseDesktopRoute, layout?: AdminLayoutRoutePathLike | null): AdminLayoutMenuNode;
 export declare const buildMenuTitleWithIcon: (route: NocoBaseDesktopRoute, t: (title: any) => any, showIconInTitle: boolean) => {
     name: any;
     icon: React.JSX.Element;

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

@@ -7,8 +7,13 @@
  * For more information, please refer to: https://www.nocobase.com/agreement.
  */
 import { FC } from 'react';
+import { type AdminLayoutRoutePathLike } from './resolveAdminRouteRuntimeTarget';
 type AdminLayoutContentProps = {
     onContentElementChange?: (element: HTMLDivElement | null) => void;
+    layout?: (AdminLayoutRoutePathLike & {
+        routeName?: string;
+    }) | null;
+    designable?: boolean;
 };
 /**
  * AdminLayout 内部使用的内容区容器。

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

@@ -8,6 +8,7 @@
  */
 import type { BaseApplication } from '../../../BaseApplication';
 import { type NocoBaseDesktopRoute } from '../../../flow-compat';
+import type { LayoutDefinition } from '../../../layout-manager/types';
 export type AdminRouteNavigationMode = 'spa' | 'document';
 export type AdminRouteRuntimeTargetReason = 'ok' | 'missingSchemaUid' | 'unsupportedV2Runtime' | 'emptyGroup' | 'unsupportedRouteType';
 export type AdminRouteRuntimeTarget = {
@@ -21,6 +22,7 @@ type LocationLike = {
     search?: string;
     hash?: string;
 };
+export type AdminLayoutRoutePathLike = Pick<LayoutDefinition, 'routePath'>;
 type ResolveAdminRouteRuntimeTargetOptions = {
     app: Pick<BaseApplication<any>, 'getPublicPath'> & {
         router?: {
@@ -28,10 +30,14 @@ type ResolveAdminRouteRuntimeTargetOptions = {
         };
     };
     route?: NocoBaseDesktopRoute;
+    layout?: AdminLayoutRoutePathLike;
     location?: LocationLike;
     preserveLocationState?: boolean;
     log?: (message?: any, ...optionalParams: any[]) => void;
 };
+export declare const DEFAULT_ADMIN_LAYOUT_ROUTE_PATH = "/admin";
+export declare function getAdminLayoutRoutePath(layout?: AdminLayoutRoutePathLike | null): string;
+export declare function joinAdminLayoutRoutePath(layout: AdminLayoutRoutePathLike | null | undefined, pathname?: string | number | null): string;
 export declare function isV2AdminRuntime(app?: ResolveAdminRouteRuntimeTargetOptions['app']): boolean;
 export declare function toRouterNavigationPath(pathname: string, basename?: string): string;
 export declare function isV2MenuRoute(route: NocoBaseDesktopRoute | undefined): boolean;

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

@@ -10,7 +10,7 @@ import type { FilterGroupType } from '@nocobase/utils/client';
 import React from 'react';
 import { FieldAssignValueInput } from './FieldAssignValueInput';
 import { type FieldAssignCascaderOption } from './fieldAssignOptions';
-export type AssignMode = 'default' | 'assign';
+export type AssignMode = 'default' | 'assign' | 'override';
 type CollectionFieldLike = {
     name?: unknown;
     title?: unknown;
@@ -53,6 +53,8 @@ export interface FieldAssignRulesEditorProps {
     defaultMode?: AssignMode;
     /** 固定 mode：用于“仅默认值/仅赋值”的场景 */
     fixedMode?: AssignMode;
+    /** 可选 mode 列表；fixedMode 优先级更高 */
+    allowedModes?: AssignMode[];
     /** 是否显示 condition */
     showCondition?: boolean;
     /** 是否显示 enable 开关 */

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

@@ -52,6 +52,8 @@ interface Props {
      * 默认 false，保持历史行为。
      */
     enableDateVariableAsConstant?: boolean;
+    /** 是否允许在变量选择器中使用 RunJS。默认 true，保持历史行为。 */
+    allowRunJS?: boolean;
     maxAssociationFieldDepth?: number;
 }
 export declare function mergeItemMetaTreeForAssignValue(baseTree: MetaTreeNode[], extraTree: MetaTreeNode[]): MetaTreeNode[];

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/models/base/GridModel.d.ts

@@ -91,7 +91,7 @@ export declare class GridModel<T extends {
 /**
  * 将多列栅格 rows 转换为移动端单列 rows。
  * 遍历原 rows 的行与列顺序，把每个原列（过滤空白列后）变成一个新行（仅一列）。
- * 行 key 使用 uid() 生成，保持插入顺序即可。
+ * 行 key 使用原 rowId 与 columnIndex 生成，避免每次渲染产生随机 key 导致移动端滚动位置丢失。
  * @param rows 原始多列 rows
  * @returns 单列 rows
  */

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

@@ -24,6 +24,7 @@ export declare class FilterFormBlockModel extends FilterBlockModel<{
     private initialDefaultsPromise?;
     private initialRefreshHandledTargetIds;
     private lastDefaultValueByFieldName;
+    private userEditedFieldNames;
     private defaultValuesRefreshSeq;
     get form(): any;
     get title(): string;
@@ -39,6 +40,10 @@ export declare class FilterFormBlockModel extends FilterBlockModel<{
     markInitialTargetRefreshHandled(targetId: string): void;
     private ensureFilterItemsBeforeRender;
     private canApplyFormDefaultValue;
+    private canApplyFormOverrideValue;
+    private normalizeFieldValueMode;
+    private markFilterFormUserEditedFields;
+    private resetFilterFormUserEditedFields;
     private matchDefaultValueCondition;
     applyFormDefaultValues(options?: {
         force?: boolean;

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

@@ -51,6 +51,10 @@ export declare class FormBlockModel<T extends DefaultCollectionBlockModelStructu
      * @internal
      */
     resetUserModifiedFields(): void;
+    /**
+     * @internal
+     */
+    resetRuntimeUserEditedState(): 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;

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

@@ -6,4 +6,4 @@
  * 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, cb?: (values?: any, filterByTk?: any) => void): Promise<void>;
+export declare function submitHandler(ctx: any, params: any, cb?: (values?: any, filterByTk?: any) => void): Promise<unknown>;

package/es/flow/models/blocks/form/value-runtime/rules.d.ts

@@ -32,6 +32,7 @@ export type RuleEngineOptions = {
     getFormValueAtPath: (namePath: NamePath) => any;
     setFormValues: (callerCtx: any, patch: Patch, options?: SetOptions) => Promise<void>;
     findExplicitHit: (pathKey: string) => string | null;
+    findUserEditedHit: (pathKey: string) => string | null;
     lastDefaultValueByPathKey: Map<string, any>;
     lastWriteMetaByPathKey: Map<string, FormValueWriteMeta>;
     observableBindings: Map<string, ObservableBinding>;
@@ -122,6 +123,18 @@ export declare class RuleEngine {
     private resolveRunJSValue;
     private resolveTemplateValue;
     private commitRuleDeps;
+    private isScalarValueTarget;
+    private shouldSkipEmptyArrayAggregateForScalarTarget;
+    private normalizeUnresolvedToManyAggregateForScalarTarget;
+    private isArrayValueCollectionField;
+    private stringifyAggregateItem;
+    private normalizeAggregateArrayForScalarTarget;
+    private shouldSkipMultiValueAggregateForScalarTarget;
+    private getClearedAggregateValueForScalarTarget;
+    private isUserClearedToManyAggregate;
+    private isTextScalarTarget;
+    private getLatestWriteMetaForPath;
+    private getToManyAggregateSourceInfo;
     /**
      * Check if default rule value can be applied.
      * Default value can overwrite when:
@@ -130,6 +143,14 @@ export declare class RuleEngine {
      */
     private checkDefaultRuleCanApply;
     private createRuleEvaluationContext;
+    private getLocalFormValuesSnapshot;
+    private resolveLocalFormValuesPath;
+    private recordLocalFormValuesDep;
+    private extractSingleLocalFormValuesPath;
+    private stringifyTemplateReplacement;
+    private createLocalTemplateTokenStore;
+    private restoreLocalTemplateTokens;
+    private resolveLocalFormValuesTemplates;
     private buildItemChainValue;
     private getFieldIndexSignature;
     private updateRuleDeps;