@nocobase/client-v2 2.1.0-beta.37 → 2.1.0-beta.38

package/es/Application.d.ts

@@ -28,6 +28,7 @@ export interface ApplicationOptions extends BaseApplicationOptions<PluginType> {
 }
 export declare class Application extends BaseApplication<ApplicationOptions, PluginManager, RouterManager, APIClient, PluginSettingsManager> {
     dataSourceManager: any;
+    hasLoadError: boolean;
     protected createApiClient(options: ApplicationOptions): APIClient;
     protected configureRuntimeAdapters(): void;
     protected createI18n(options: ApplicationOptions): i18next;

package/es/BaseApplication.d.ts

@@ -12,6 +12,7 @@ import type { i18n as i18next } from 'i18next';
 import React, { ReactElement, ReactNode } from 'react';
 import { AIManager } from './ai';
 import { SystemSettingsSource } from './flow/system-settings';
+import { LayoutManager } from './layout-manager/LayoutManager';
 import type { PluginClass, PluginManager, PluginType } from './PluginManager';
 import { RouteRepository } from './RouteRepository';
 import type { ComponentTypeAndString, RenderableComponentType, RouterComponentType, RouterManager, RouterOptions } from './RouterManager';
@@ -71,6 +72,7 @@ export declare abstract class BaseApplication<TOptions extends BaseApplicationOp
     components: Record<string, AnyComponent>;
     pluginManager: TPluginManager;
     pluginSettingsManager: TPluginSettingsManager;
+    layoutManager: LayoutManager<this>;
     aiManager: AIManager;
     devDynamicImport?: DevDynamicImport;
     requirejs: RequireJS;
@@ -161,6 +163,7 @@ export declare abstract class BaseApplication<TOptions extends BaseApplicationOp
     protected abstract createRouterManager(options: TOptions): TRouterManager;
     protected abstract createPluginManager(options: TOptions): TPluginManager;
     protected abstract createPluginSettingsManager(options: TOptions): TPluginSettingsManager;
+    protected createLayoutManager(_options: TOptions): LayoutManager<this>;
     protected createWebSocketClient(options: TOptions): WebSocketClient;
     protected getDefaultComponents(): Record<string, AnyComponent>;
     abstract load(): Promise<void>;

package/es/RouterManager.d.ts

@@ -34,6 +34,7 @@ export interface RouteType extends Omit<RouteObject, 'children' | 'Component'> {
     Component?: ComponentTypeAndString;
     componentLoader?: ComponentLoader;
     skipAuthCheck?: boolean;
+    authCheck?: boolean;
 }
 export type RenderComponentType = (Component: ComponentTypeAndString, props?: any) => React.ReactNode;
 export type RouterComponentType = React.FC<{

package/es/components/KeepAlive.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 React, { FC } from 'react';
+export declare const KeepAliveProvider: FC<{
+    active: boolean;
+    parentActive: boolean;
+}>;
+export declare const useKeepAlive: () => {
+    active: boolean;
+};
+interface KeepAliveProps {
+    uid: string;
+    children: (uid: string) => React.ReactNode;
+}
+export declare const KeepAlive: FC<KeepAliveProps>;
+export {};

package/es/components/RouterBridge.d.ts

@@ -7,7 +7,16 @@
  * For more information, please refer to: https://www.nocobase.com/agreement.
  */
 import { Application } from '../Application';
+type LayoutMatchLike = {
+    id: string;
+    pathname: string;
+};
+type LayoutDefinitionLike = {
+    routeName: string;
+};
+export declare function findDeepestLayoutMatch(layouts?: LayoutDefinitionLike[], matches?: LayoutMatchLike[]): LayoutMatchLike;
 export declare function useRouterSync(app: Application): void;
 export declare function RouterBridge({ app }: {
     app: any;
 }): any;
+export {};

package/es/data-source/ExtendCollectionsProvider.d.ts

@@ -13,12 +13,38 @@ export interface ExtendCollectionsProviderProps {
     dataSource?: string;
     /** Collections to surface for the lifetime of this provider's subtree. */
     collections: CollectionOptions[];
+    /**
+     * When `true`, re-sync the data source whenever the `collections` prop
+     * reference changes after mount: add entries newly present in the prop and
+     * remove entries no longer present (only those this provider registered).
+     * The diff runs in the same render as the prop change so children see the
+     * new state on their first render — at the cost of one observable mutation
+     * per change.
+     *
+     * Defaults to `false`. Most pages pass a stable (often module-level)
+     * `collections` list and don't need this; leaving it off avoids accidental
+     * re-registration when callers forget to memoize. Enable only when your
+     * collection list legitimately varies during the provider's lifetime.
+     */
+    syncOnChange?: boolean;
     children?: ReactNode;
 }
 /**
- * Mount-scoped collection injector. Adds the given `collections` to the target data source on mount and removes them on unmount. Survives mid-session reloads via `dataSource:loaded` events.
+ * Mount-scoped collection injector. Adds the given `collections` to the target
+ * data source on first render — synchronously, so children can read
+ * `getCollection(name)` on their own first render — and removes them on
+ * unmount. Survives mid-session data-source reloads via the
+ * `dataSource:loaded` event by re-registering only the names this provider
+ * owns.
  *
- * Use this for client-only collections — e.g. a `schema-only` server collection that isn't auto-published to the v2 data source, or a pure UI-side mirror — so downstream components (like `<CollectionFilter>`) can resolve the collection by name.
+ * Use this for client-only collections — e.g. a `schema-only` server
+ * collection that isn't auto-published to the v2 data source, or a pure
+ * UI-side mirror — so downstream components (like `<CollectionFilter>`) can
+ * resolve the collection by name.
+ *
+ * Default behavior is "static-at-mount": subsequent changes to the
+ * `collections` prop are ignored. Pass `syncOnChange` to opt into diffing on
+ * prop change.
  */
 export declare const ExtendCollectionsProvider: FC<ExtendCollectionsProviderProps>;
 export default ExtendCollectionsProvider;

package/es/flow/FlowPage.d.ts

@@ -6,7 +6,7 @@
  * This project is dual-licensed under AGPL-3.0 and NocoBase Commercial License.
  * For more information, please refer to: https://www.nocobase.com/agreement.
  */
-import type { FlowModel } from '@nocobase/flow-engine';
+import type { FlowModel, FlowModelRendererProps } from '@nocobase/flow-engine';
 import React from 'react';
 import FlowRoute from './components/FlowRoute';
 type FlowPageProps = {
@@ -14,6 +14,7 @@ type FlowPageProps = {
     parentId?: string;
     onModelLoaded?: (uid: string, model: FlowModel) => void;
     defaultTabTitle?: string;
+    showFlowSettings?: FlowModelRendererProps['showFlowSettings'];
 };
 export declare const FlowPage: React.MemoExoticComponent<(props: FlowPageProps & Record<string, unknown>) => React.JSX.Element>;
 export declare const RemoteFlowModelRenderer: (props: any) => React.JSX.Element;

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

@@ -6,46 +6,14 @@
  * 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 { FlowEngine, FlowModel, type ViewParam } from '@nocobase/flow-engine';
-export interface RoutePageMeta {
-    active: boolean;
-    refreshDesktopRoutes?: () => Promise<unknown>;
-    layoutContentElement?: HTMLElement | null;
-}
-interface RouteLike {
-    params?: {
-        name?: string;
-    };
-    pathname?: string;
-}
+import type { FlowEngine } from '@nocobase/flow-engine';
+import { BaseLayoutRouteCoordinator, type BaseLayoutRouteCoordinatorOptions } from './BaseLayoutRouteCoordinator';
 /**
- * 管理 admin 场景下每个 page 的 v2 视图栈编排。
- * 该协调器只负责状态机和开关视图，不直接绑定 React 生命周期。
+ * Admin Layout 路由协调器。
+ *
+ * 该类保留旧导出路径，内部复用通用 BaseLayoutRouteCoordinator。
  */
-export declare class AdminLayoutRouteCoordinator {
-    private readonly flowEngine;
-    private readonly runtimes;
-    private layoutContentElement;
-    private setRuntimeActive;
-    private getCurrentRouteByPageUid;
-    constructor(flowEngine: FlowEngine);
-    setLayoutContentElement(element: HTMLElement | null): void;
-    registerPage(pageUid: string, meta: RoutePageMeta): FlowModel<import("@nocobase/flow-engine").DefaultStructure>;
-    syncPageMeta(pageUid: string, meta: Partial<RoutePageMeta>): void;
-    unregisterPage(pageUid: string): void;
-    syncRoute(routeLike: RouteLike): void;
-    cleanupPage(pageUid: string): void;
-    destroy(): void;
-    private syncRuntimeWithPathname;
-    private shouldStepNavigate;
-    private stepNavigate;
-    private handleOpenViews;
-    private openViews;
-    private ensureRouteModelContext;
-    private getOrCreateRouteModel;
+export declare class AdminLayoutRouteCoordinator extends BaseLayoutRouteCoordinator {
+    constructor(flowEngine: FlowEngine, options?: BaseLayoutRouteCoordinatorOptions);
 }
-/**
- * 将 pathname 解析结果和 pageUid 对齐，便于测试里复用。
- */
-export declare function toViewStack(pathname: string): ViewParam[];
-export {};
+export { toViewStack, type BaseLayoutRouteCoordinatorOptions, type RoutePageMeta } from './BaseLayoutRouteCoordinator';

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

@@ -0,0 +1,89 @@
+/**
+ * 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, FlowModel, type ViewParam } from '@nocobase/flow-engine';
+import { BaseLayoutRouteCoordinator, type BaseLayoutRouteCoordinatorOptions, type RoutePageMeta } from './BaseLayoutRouteCoordinator';
+import type { LayoutDefinition } from '../../layout-manager/types';
+export type BaseLayoutStructure = {
+    subModels?: Record<string, FlowModel[]>;
+};
+export type GetLayoutModelOptions<TModel extends FlowModel = BaseLayoutModel> = {
+    required?: boolean;
+    create?: boolean;
+    props?: any;
+    use?: new (...args: any[]) => TModel;
+};
+export type LayoutRouteMatch = {
+    type: 'root';
+    pathname: string;
+    basePathname: string;
+    relativePath: string;
+} | {
+    type: 'page';
+    pathname: string;
+    basePathname: string;
+    relativePath: string;
+    pageUid: string;
+    tabUid?: string;
+    viewStack: ViewParam[];
+} | {
+    type: 'notFound';
+    pathname: string;
+    basePathname: string;
+    relativePath: string;
+};
+export interface LayoutRouteLike {
+    id?: string;
+    name?: string;
+    pathname?: string;
+    params?: Record<string, string | undefined>;
+    layoutRouteName?: string;
+    layoutBasePathname?: string;
+}
+/**
+ * 通用 Layout 运行时模型。
+ *
+ * 该模型封装页面路由桥接、弹窗路由、page tab 路由、布局容器和移动端状态，
+ * Admin、Embed 等具体 Layout 只需要继承并实现各自的渲染和专属业务能力。
+ */
+export declare class BaseLayoutModel<TStructure extends BaseLayoutStructure = BaseLayoutStructure> extends FlowModel<TStructure> {
+    isMobileLayout: boolean;
+    currentLayoutRoute: LayoutRouteMatch | null;
+    protected routeCoordinator?: BaseLayoutRouteCoordinator;
+    private activePageUid;
+    private layoutContentElement;
+    private readonly routePageMetaMap;
+    private contextBindingsActive;
+    constructor(options: any);
+    registerRoutePage(pageUid: string, meta: RoutePageMeta): import("..").RouteModel<import("@nocobase/flow-engine").DefaultStructure>;
+    updateRoutePage(pageUid: string, meta: Partial<RoutePageMeta>): void;
+    unregisterRoutePage(pageUid: string): void;
+    setLayoutContentElement(element: HTMLElement | null): void;
+    setIsMobileLayout(isMobileLayout: boolean): void;
+    getCurrentRouteByPageUid(pageUid: string): any;
+    get layout(): LayoutDefinition;
+    getCoordinator(): BaseLayoutRouteCoordinator;
+    protected createRouteCoordinator(): BaseLayoutRouteCoordinator;
+    protected getRouteCoordinatorOptions(): BaseLayoutRouteCoordinatorOptions;
+    protected getPageUidFromRoute(route: any): any;
+    isLayoutContentRoute(routeLike: LayoutRouteLike): boolean;
+    resolveLayoutRoute(routeLike: LayoutRouteLike): LayoutRouteMatch;
+    getPageUidFromLayoutRoute(match: LayoutRouteMatch | null | undefined): string;
+    syncLayoutRoute(routeLike: LayoutRouteLike): LayoutRouteMatch;
+    clearLayoutRoute(routeLike?: LayoutRouteLike): void;
+    protected onMount(): void;
+    protected onUnmount(): void;
+    private setupContextBindings;
+    private teardownRuntime;
+    private getCurrentRouteByActivePage;
+    private getCurrentCoordinatorRouteLike;
+}
+/**
+ * 按固定 UID 获取或创建 Layout host model。
+ */
+export declare function getLayoutModel<TModel extends FlowModel = BaseLayoutModel>(flowEngine: FlowEngine, uid: string, options?: GetLayoutModelOptions<TModel>): TModel;

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

@@ -0,0 +1,74 @@
+/**
+ * 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 { FlowEngine, type FlowContext, type ViewParam } from '@nocobase/flow-engine';
+import { RouteModel } from '../models/base/RouteModel';
+import type { LayoutDefinition } from '../../layout-manager/types';
+export interface RoutePageMeta {
+    active: boolean;
+    refreshDesktopRoutes?: () => Promise<unknown>;
+    layoutContentElement?: HTMLElement | null;
+}
+export interface BaseLayoutRouteCoordinatorOptions {
+    layout?: LayoutDefinition;
+    layoutContext?: FlowContext;
+    basePathname?: string;
+}
+interface RouteLike {
+    layoutRouteName?: string;
+    params?: {
+        name?: string;
+    };
+    pathname?: string;
+    pageUid?: string;
+    layoutBasePathname?: string;
+    layoutRoute?: {
+        type: string;
+        pageUid?: string;
+        basePathname?: string;
+    } | null;
+}
+/**
+ * 通用 Layout 路由协调器。
+ *
+ * 负责把当前路由路径解析为 v2 view stack，并驱动 RouteModel 上的弹窗、抽屉和 page tab 状态。
+ * Admin、Embed 等布局只需要提供当前 Layout 的基准路径，即可复用同一套 view 编排逻辑。
+ */
+export declare class BaseLayoutRouteCoordinator {
+    protected readonly flowEngine: FlowEngine;
+    protected readonly layout: LayoutDefinition | undefined;
+    private readonly layoutContext?;
+    private basePathname;
+    private readonly runtimes;
+    private layoutContentElement;
+    constructor(flowEngine: FlowEngine, options?: BaseLayoutRouteCoordinatorOptions);
+    setLayoutContentElement(element: HTMLElement | null): void;
+    registerPage(pageUid: string, meta: RoutePageMeta): RouteModel<import("@nocobase/flow-engine").DefaultStructure>;
+    syncPageMeta(pageUid: string, meta: Partial<RoutePageMeta>): void;
+    unregisterPage(pageUid: string): void;
+    syncRoute(routeLike: RouteLike): void;
+    cleanupPage(pageUid: string): void;
+    destroy(): void;
+    protected getCurrentRouteByPageUid(pageUid: string): any;
+    private setRuntimeActive;
+    private notifyRuntimeActiveChange;
+    private syncRuntimeWithPathname;
+    private syncViewListVisibility;
+    private shouldStepNavigate;
+    private scheduleInitialDeepLinkReplay;
+    private stepNavigate;
+    private handleOpenViews;
+    private openViews;
+    private ensureRouteModelContext;
+    private getOrCreateRouteModel;
+}
+/**
+ * 将 pathname 解析结果和 pageUid 对齐，便于测试里复用。
+ */
+export declare function toViewStack(pathname: string, options?: BaseLayoutRouteCoordinatorOptions): ViewParam[];
+export {};

package/es/flow/admin-shell/admin-layout/AdminLayoutEntryGuard.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.
+ */
+import React, { type FC } from 'react';
+export declare const AdminLayoutEntryGuard: FC<{
+    children: React.ReactNode;
+}>;

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

@@ -7,22 +7,18 @@
  * For more information, please refer to: https://www.nocobase.com/agreement.
  */
 import { type FlowEngine, FlowModel } from '@nocobase/flow-engine';
+import React from 'react';
 import type { NocoBaseDesktopRoute } from '../../../flow-compat';
-import { type RoutePageMeta } from '../AdminLayoutRouteCoordinator';
+import { AdminLayoutRouteCoordinator } from '../AdminLayoutRouteCoordinator';
+import { BaseLayoutModel, type BaseLayoutStructure, type GetLayoutModelOptions } from '../BaseLayoutModel';
 import { type AdminLayoutMenuItemModel } from './AdminLayoutMenuModels';
 import { type AdminLayoutMenuRouteOptions } from './AdminLayoutMenuUtils';
-import React from 'react';
-export type AdminLayoutStructure = {
+export type AdminLayoutStructure = BaseLayoutStructure & {
     subModels: {
         menuItems?: AdminLayoutMenuItemModel[];
     };
 };
-type GetAdminLayoutModelOptions<TModel extends FlowModel = AdminLayoutModel> = {
-    required?: boolean;
-    create?: boolean;
-    props?: any;
-    use?: new (...args: any[]) => TModel;
-};
+type GetAdminLayoutModelOptions<TModel extends FlowModel = AdminLayoutModel> = GetLayoutModelOptions<TModel>;
 /**
  * Admin Layout 的纯运行时 host model。
  *
@@ -35,14 +31,8 @@ type GetAdminLayoutModelOptions<TModel extends FlowModel = AdminLayoutModel> = {
  * model.syncMenuRoutes(routes);
  * ```
  */
-export declare class AdminLayoutModel extends FlowModel<AdminLayoutStructure> {
-    isMobileLayout: boolean;
+export declare class AdminLayoutModel extends BaseLayoutModel<AdminLayoutStructure> {
     menuRouteRefreshVersion: number;
-    private routeCoordinator?;
-    private routeDisposer?;
-    private activePageUid;
-    private layoutContentElement;
-    private readonly routePageMetaMap;
     constructor(options: any);
     /**
      * 通知 Layout 重新生成 ProLayout 菜单路由。
@@ -50,29 +40,6 @@ export declare class AdminLayoutModel extends FlowModel<AdminLayoutStructure> {
      * @returns {void}
      */
     refreshMenuRouteTree(): void;
-    /**
-     * 注册页面运行时信息。
-     *
-     * @param {string} pageUid 页面 UID
-     * @param {RoutePageMeta} meta 页面运行时元数据
-     * @returns {FlowModel} 对应的页面模型
-     */
-    registerRoutePage(pageUid: string, meta: RoutePageMeta): FlowModel<import("@nocobase/flow-engine").DefaultStructure>;
-    /**
-     * 更新页面运行时信息。
-     *
-     * @param {string} pageUid 页面 UID
-     * @param {Partial<RoutePageMeta>} meta 待更新的页面元数据
-     * @returns {void}
-     */
-    updateRoutePage(pageUid: string, meta: Partial<RoutePageMeta>): void;
-    /**
-     * 注销页面运行时信息。
-     *
-     * @param {string} pageUid 页面 UID
-     * @returns {void}
-     */
-    unregisterRoutePage(pageUid: string): void;
     /**
      * 使用当前可访问菜单路由刷新 Layout 菜单树。
      *
@@ -90,59 +57,7 @@ export declare class AdminLayoutModel extends FlowModel<AdminLayoutStructure> {
         path: string;
         children: import("./AdminLayoutMenuUtils").AdminLayoutMenuNode[];
     };
-    /**
-     * 设置布局内容容器元素。
-     *
-     * @param {HTMLElement | null} element 布局内容容器
-     * @returns {void}
-     */
-    setLayoutContentElement(element: HTMLElement | null): void;
-    /**
-     * 设置是否为移动端布局。
-     *
-     * @param {boolean} isMobileLayout 是否为移动端布局
-     * @returns {void}
-     */
-    setIsMobileLayout(isMobileLayout: boolean): void;
-    protected onMount(): void;
-    protected onUnmount(): void;
-    /**
-     * 安装运行时上下文属性。
-     *
-     * @returns {void}
-     */
-    private setupContextBindings;
-    /**
-     * 安装路由同步 reaction。
-     *
-     * @returns {void}
-     */
-    private setupRouteReaction;
-    /**
-     * 释放运行时状态。
-     *
-     * @returns {void}
-     */
-    private teardownRuntime;
-    /**
-     * 获取当前激活页面对应的路由对象。
-     *
-     * @returns {any} 当前激活页面对应的路由对象
-     */
-    private getCurrentRouteByActivePage;
-    /**
-     * 根据页面 UID 获取路由对象。
-     *
-     * @param {string} pageUid 页面 UID
-     * @returns {any} 路由对象
-     */
-    private getCurrentRouteByPageUid;
-    /**
-     * 懒加载页面路由协调器。
-     *
-     * @returns {AdminLayoutRouteCoordinator} 路由协调器实例
-     */
-    private getCoordinator;
+    protected createRouteCoordinator(): AdminLayoutRouteCoordinator;
     render(): React.JSX.Element;
 }
 /**

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

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

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

@@ -6,14 +6,14 @@
  * This project is dual-licensed under AGPL-3.0 and NocoBase Commercial License.
  * For more information, please refer to: https://www.nocobase.com/agreement.
  */
-/// <reference types="react" />
 import type { FlowEngine } from '@nocobase/flow-engine';
+import type { RefObject } from 'react';
 import { type AdminLayoutModel } from './admin-layout/AdminLayoutModel';
 type UseAdminLayoutRoutePageOptions = {
     flowEngine: FlowEngine;
     pageUid: string;
     refreshDesktopRoutes?: () => Promise<unknown>;
-    layoutContentRef: React.RefObject<HTMLDivElement>;
+    layoutContentRef: RefObject<HTMLDivElement>;
 };
 /**
  * 把 FlowRoute 页面的生命周期桥接到 AdminLayout host model。

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

@@ -0,0 +1,23 @@
+/**
+ * This file is part of the NocoBase (R) project.
+ * Copyright (c) 2020-2024 NocoBase Co., Ltd.
+ * Authors: NocoBase Team.
+ *
+ * This project is dual-licensed under AGPL-3.0 and NocoBase Commercial License.
+ * For more information, please refer to: https://www.nocobase.com/agreement.
+ */
+import type { FlowEngine } from '@nocobase/flow-engine';
+import { type RefObject } from 'react';
+import type { BaseLayoutModel } from './BaseLayoutModel';
+export type UseLayoutRoutePageOptions<TModel extends BaseLayoutModel = BaseLayoutModel> = {
+    flowEngine: FlowEngine;
+    pageUid: string;
+    active?: boolean;
+    refreshDesktopRoutes?: () => Promise<unknown>;
+    layoutContentRef: RefObject<HTMLElement>;
+    getLayoutModel: (flowEngine: FlowEngine) => TModel | undefined;
+};
+/**
+ * 把 FlowRoute 页面的生命周期桥接到指定 Layout host model。
+ */
+export declare function useLayoutRoutePage<TModel extends BaseLayoutModel = BaseLayoutModel>(options: UseLayoutRoutePageOptions<TModel>): TModel;

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

@@ -6,7 +6,16 @@
  * 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';
 import React from 'react';
+import { type BaseLayoutModel } from '../admin-shell/BaseLayoutModel';
+export type LegacyPageBehavior = 'redirect' | 'notFound' | 'bridge';
+export type FlowRouteProps = {
+    pageUid?: string;
+    active?: boolean;
+    getLayoutModel?: (flowEngine: FlowEngine) => BaseLayoutModel | undefined;
+    legacyPageBehavior?: LegacyPageBehavior;
+};
 /**
  * 管理后台动态页面路由组件。
  *
@@ -22,7 +31,7 @@ import React from 'react';
  * @throws {Error} 当缺少 `route.params.name` 时抛出异常
  */
 declare const FlowRoute: {
-    (): React.JSX.Element;
+    (props?: FlowRouteProps): React.JSX.Element;
     displayName: string;
 };
 export default FlowRoute;

package/es/flow/index.d.ts

@@ -23,7 +23,11 @@ export * from './utils';
 export * from './actions';
 export * from './system-settings';
 export * from './admin-shell/admin-layout';
+export * from './admin-shell/BaseLayoutModel';
+export * from './admin-shell/BaseLayoutRouteCoordinator';
 export * from './admin-shell/AdminLayoutRouteCoordinator';
+export * from './admin-shell/useLayoutRoutePage';
+export * from './admin-shell/useAdminLayoutRoutePage';
 export * from '../settings-center';
 export { openViewFlow } from './flows/openViewFlow';
 export { editMarkdownFlow } from './flows/editMarkdownFlow';

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

@@ -32,9 +32,11 @@ export declare class PageModel extends FlowModel<PageModelStructure> {
     private getEnableTabs;
     private getActiveTabKey;
     private scheduleActiveLifecycleRefresh;
+    activateCurrentTab(forceRefresh?: boolean): void;
+    deactivateCurrentTab(): void;
     onMount(): void;
     protected onUnmount(): void;
-    invokeTabModelLifecycleMethod(tabActiveKey: string, method: 'onActive' | 'onInactive', forceRefresh?: boolean): void;
+    invokeTabModelLifecycleMethod(tabActiveKey: string | undefined, method: 'onActive' | 'onInactive', forceRefresh?: boolean): void;
     /**
      * Resolve configured document title template and update browser tab title.
      * Priority:

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

@@ -10,4 +10,5 @@ import { ActionGroupModel } from '../../base/ActionGroupModel';
 import { FormActionModel } from './FormActionModel';
 export declare class FormActionGroupModel extends ActionGroupModel {
     static baseClass: typeof FormActionModel;
+    static defineChildren(ctx: any): Promise<any[]>;
 }

package/es/flow/models/blocks/table/TableBlockModel.d.ts

@@ -61,8 +61,18 @@ export declare class TableBlockModel extends CollectionBlockModel<TableBlockMode
             cell: React.MemoExoticComponent<import("@formily/reactive-react").ReactFC<Omit<any, "ref">>>;
         };
     };
+    isRowSelectionEnabled(): boolean;
+    isShowIndexEnabled(): boolean;
+    getRecordIndex(record: Record<string, unknown>, index: number): string | number;
+    getLeftAuxiliaryColumn(): {
+        key: string;
+        width: number;
+        align: "center";
+        render: (_value: unknown, record: Record<string, unknown>, index: number) => React.JSX.Element;
+    };
     renderCell: (checked: any, record: any, index: any, originNode: any) => any;
     renderConfigureActions(): React.JSX.Element;
+    shouldRenderAction(action: ActionModel, isConfigMode: boolean): boolean;
     pagination(): import("antd").PaginationProps;
     renderComponent(): React.JSX.Element;
 }

package/es/flow/models/fields/AssociationFieldModel/SubTableFieldModel/index.d.ts

@@ -8,7 +8,7 @@ export declare class SubTableFieldModel extends AssociationFieldModel {
     updateAssociation: boolean;
     setCurrentPage: any;
     currentPageSize: any;
-    getCurrentValue: () => any[];
+    getCurrentValue(): any[];
     get collection(): any;
     getColumns(): any;
     render(): React.JSX.Element;

package/es/index.d.ts

@@ -24,6 +24,7 @@ export * from './WebSocketClient';
 export * from './RouterManager';
 export * from './PluginManager';
 export * from './PluginSettingsManager';
+export * from './layout-manager';
 export * from './hooks';
 export { default as languageCodes } from './locale/languageCodes';
 export * from './nocobase-buildin-plugin';