@nocobase/client-v2 2.2.0-beta.1 → 2.2.0-beta.10

package/es/BaseApplication.d.ts

@@ -12,6 +12,7 @@ import type { i18n as i18next } from 'i18next';
 import React, { ReactElement, ReactNode } from 'react';
 import type { AppListProps } from '@ant-design/pro-layout/es/components/AppsLogoComponents/types';
 import { AIManager } from './ai';
+import { EntryActionManager } from './entry-actions';
 import { SystemSettingsSource } from './flow/system-settings';
 import { LayoutManager } from './layout-manager/LayoutManager';
 import type { PluginClass, PluginManager, PluginType } from './PluginManager';
@@ -75,6 +76,7 @@ export declare abstract class BaseApplication<TOptions extends BaseApplicationOp
     pluginManager: TPluginManager;
     pluginSettingsManager: TPluginSettingsManager;
     layoutManager: LayoutManager<this>;
+    entryActionManager: EntryActionManager;
     aiManager: AIManager;
     devDynamicImport?: DevDynamicImport;
     requirejs: RequireJS;
@@ -141,6 +143,7 @@ export declare abstract class BaseApplication<TOptions extends BaseApplicationOp
     setMaintaining(maintaining: boolean): void;
     getOptions(): TOptions;
     getName(): string;
+    getCdnUrl(): any;
     getPublicPath(): string;
     getApiUrl(pathname?: string): string;
     getRouteUrl(pathname: string): string;

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 上下文刷新。
      *
@@ -116,9 +124,24 @@ export declare class RouteRepository {
      * @returns 匹配到的路由节点
      */
     getRouteBySchemaUid(schemaUid: string): NocoBaseDesktopRoute | undefined;
+    /**
+     * 通过路由 id 反查对应路由节点。
+     *
+     * @param routeId 桌面路由主键
+     * @returns 匹配到的路由节点
+     */
+    getRouteById(routeId: string | number): 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;
+    private findRouteById;
 }
 export {};

package/es/RouterManager.d.ts

@@ -40,9 +40,18 @@ export type RenderComponentType = (Component: ComponentTypeAndString, props?: an
 export type RouterComponentType = React.FC<{
     BaseLayout?: ComponentType;
 }>;
+type AdminRouteNavigationTarget = {
+    currentPathname?: string;
+    targetPathname: unknown;
+    basePath?: string;
+    adminRoutePath?: string;
+    replace?: boolean;
+};
+export declare function shouldOpenAdminRouteInNewWindow(options: AdminRouteNavigationTarget): boolean;
 export declare class RouterManager<TApp extends BaseApplication<any> = BaseApplication<any>> {
     protected routes: Record<string, RouteType>;
     protected options: RouterOptions;
+    private routerNavigate?;
     app: TApp;
     router: Router;
     get basename(): string;
@@ -52,6 +61,11 @@ export declare class RouterManager<TApp extends BaseApplication<any> = BaseAppli
         (to: import("react-router").To, opts?: import("@remix-run/router").RouterNavigateOptions): Promise<void>;
     };
     constructor(options: RouterOptions, app: TApp);
+    private navigateWithPortalPolicy;
+    private shouldOpenAdminRouteInNewWindow;
+    private getRuntimeBasePath;
+    private getAdminRoutePath;
+    private getAdminRouteNavigationHref;
     protected resolveLoadedComponent(moduleOrComponent: ComponentLoaderResult): ComponentTypeAndString | undefined;
     protected createRouteLazyComponent(componentLoader: ComponentLoader): ComponentType;
     /**
@@ -73,3 +87,4 @@ export declare class RouterManager<TApp extends BaseApplication<any> = BaseAppli
     has(name: string): boolean;
     remove(name: string): void;
 }
+export {};

package/es/authRedirect.d.ts

@@ -31,6 +31,7 @@ export declare function getModernClientPrefix(): string;
 export declare function stripModernClientPrefix(publicPath?: string): string;
 export declare function getV2EffectiveBasePath(app: AppLike): string;
 declare function getDefaultV2AdminRedirectPath(app: AppLike): string;
+export declare function normalizeV2RedirectPath(app: AppLike, target?: string | null, fallbackPath?: string): string;
 /**
  * 将当前 v2 页面地址转换为根相对 redirect 路径。
  *

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/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/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/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

@@ -11,6 +11,7 @@ export * from './BlankComponent';
 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/entry-actions/EntryActionManager.d.ts

@@ -0,0 +1,24 @@
+/**
+ * This file is part of the NocoBase (R) project.
+ * Copyright (c) 2020-2024 NocoBase Co., Ltd.
+ * Authors: NocoBase Team.
+ *
+ * This project is dual-licensed under AGPL-3.0 and NocoBase Commercial License.
+ * For more information, please refer to: https://www.nocobase.com/agreement.
+ */
+import { type FlowModelContext, type SubModelItem, type SubModelItemsType } from '@nocobase/flow-engine';
+export type EntryActionScope = 'action-panel' | 'app-switcher' | string;
+export type EntryActionProvider = (ctx: FlowModelContext) => SubModelItem[] | Promise<SubModelItem[]>;
+export declare class EntryActionManager {
+    private readonly providers;
+    revision: number;
+    constructor();
+    register(name: string, options: {
+        scope: EntryActionScope;
+        provider: EntryActionProvider;
+        sort?: number;
+    }): void;
+    unregister(name: string): void;
+    invalidate(): void;
+    getItems(scope: EntryActionScope): SubModelItemsType;
+}

package/es/entry-actions/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 './EntryActionManager';

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

@@ -41,6 +41,7 @@ export interface LayoutRouteLike {
     id?: string;
     name?: string;
     pathname?: string;
+    state?: unknown;
     params?: Record<string, string | undefined>;
     layoutRouteName?: string;
     layoutBasePathname?: string;
@@ -56,6 +57,7 @@ export declare class BaseLayoutModel<TStructure extends BaseLayoutStructure = Ba
     currentLayoutRoute: LayoutRouteMatch | null;
     protected routeCoordinator?: BaseLayoutRouteCoordinator;
     private activePageUid;
+    private currentRouteState?;
     private layoutContentElement;
     private readonly routePageMetaMap;
     private contextBindingsActive;
@@ -82,6 +84,10 @@ export declare class BaseLayoutModel<TStructure extends BaseLayoutStructure = Ba
     private teardownRuntime;
     private getCurrentRouteByActivePage;
     private getCurrentCoordinatorRouteLike;
+    private restoreCurrentLayoutRouteFromRouterContext;
+    private shouldIgnoreStaleLayoutRouteCleanup;
+    private getRouterContextRouteLike;
+    private isRouteLikeOwnedByCurrentLayout;
 }
 /**
  * 按固定 UID 获取或创建 Layout host model。

package/es/flow/admin-shell/BaseLayoutRouteCoordinator.d.ts

@@ -25,6 +25,7 @@ interface RouteLike {
         name?: string;
     };
     pathname?: string;
+    state?: unknown;
     pageUid?: string;
     layoutBasePathname?: string;
     layoutRoute?: {
@@ -46,6 +47,7 @@ export declare class BaseLayoutRouteCoordinator {
     private basePathname;
     private readonly runtimes;
     private layoutContentElement;
+    private lastNonNullLayoutContentElement;
     constructor(flowEngine: FlowEngine, options?: BaseLayoutRouteCoordinatorOptions);
     setLayoutContentElement(element: HTMLElement | null): void;
     registerPage(pageUid: string, meta: RoutePageMeta): RouteModel<import("@nocobase/flow-engine").DefaultStructure>;
@@ -62,6 +64,11 @@ export declare class BaseLayoutRouteCoordinator {
     private shouldStepNavigate;
     private scheduleInitialDeepLinkReplay;
     private stepNavigate;
+    private replayActiveRuntimeViewsAfterLayoutContentElementChange;
+    private invalidatePendingRuntimeViewOpens;
+    private resetRuntimeViewStateForLayoutContentElementChange;
+    private markPendingOpenViews;
+    private clearPendingOpenViews;
     private handleOpenViews;
     private openViews;
     private ensureRouteModelContext;

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

@@ -8,4 +8,5 @@
  */
 import type { AppListProps } from '@ant-design/pro-layout/es/components/AppsLogoComponents/types';
 import React from 'react';
-export declare function useAppListRender(): (appList: AppListProps) => React.JSX.Element;
+import type { AppSwitcherActionPanelModel } from './AppSwitcherActionPanelModel';
+export declare function useAppListRender(appSwitcherModel?: AppSwitcherActionPanelModel): (appList: AppListProps) => React.JSX.Element;

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

@@ -0,0 +1,24 @@
+/**
+ * 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 { ActionModel } from '../../models/base';
+import { FlowModel, type SubModelItemsType } from '@nocobase/flow-engine';
+import React from 'react';
+type AppSwitcherActionPanelStructure = {
+    subModels: {
+        actions?: ActionModel[];
+    };
+};
+export declare class AppSwitcherActionPanelModel extends FlowModel<AppSwitcherActionPanelStructure> {
+    getConfigureActionsItems(): SubModelItemsType;
+    renderConfigureActions(): React.JSX.Element;
+    private getRenderableActions;
+    hasActions(): boolean;
+    renderContent(): React.JSX.Element;
+}
+export {};

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

@@ -8,6 +8,7 @@
  */
 export * from './AdminLayoutComponent';
 export * from './AdminLayoutModel';
+export * from './AppSwitcherActionPanelModel';
 export * from '../BaseLayoutModel';
 export * from '../BaseLayoutRouteCoordinator';
 export * from './AdminLayoutSlotModels';

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/admin-shell/admin-layout/useApplications.d.ts

@@ -6,8 +6,13 @@
  * 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 { AppListProps } from '@ant-design/pro-layout/es/components/AppsLogoComponents/types';
 import React from 'react';
-export declare const useApplications: () => {
+import type { AdminLayoutModel } from './AdminLayoutModel';
+import type { AppSwitcherActionPanelModel } from './AppSwitcherActionPanelModel';
+export declare const APP_SWITCHER_ACTION_PANEL_MODEL_UID: string;
+export declare const useApplications: (adminLayoutModel?: AdminLayoutModel) => {
     Component: React.JSXElementConstructor<any> | React.ExoticComponent<any>;
-    appList: any[];
+    appList: AppListProps;
+    appSwitcherModel: AppSwitcherActionPanelModel;
 };

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

@@ -30,6 +30,7 @@ export declare class ActionModel<T extends DefaultStructure = DefaultStructure>
     enableEditTooltip: boolean;
     enableEditTitle: boolean;
     enableEditIcon: boolean;
+    enableEditIconOnly: boolean;
     enableEditType: boolean;
     enableEditDanger: boolean;
     enableEditColor: boolean;
@@ -44,6 +45,7 @@ export declare class ActionModel<T extends DefaultStructure = DefaultStructure>
     getInputArgs(): Record<string, any>;
     onClick(event: any): void;
     getTitle(): string;
+    getTitleFieldDescription(): any;
     getIcon(): React.ReactNode;
     renderButton(): React.JSX.Element;
     render(): React.JSX.Element;

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;