@nocobase/client-v2 2.1.0-alpha.40 → 2.1.0-alpha.46

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

@@ -0,0 +1,96 @@
+/**
+ * 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 { Collection } from '@nocobase/flow-engine';
+import { FilterOption, UseFilterOptionsArgs } from '../../../flow/components/filter/useFilterOptions';
+import { CollectionFilterItemValue, createCollectionFilterItem } from './CollectionFilterItem';
+/** A single condition row (`{ path, operator, value }`) or a nested group. */
+export type FilterGroupItem = CollectionFilterItemValue | FilterGroupValue;
+/**
+ * Reactive shape consumed by `FilterContainer` / `FilterGroup`. `logic` is the join (`$and` / `$or`) and `items` is a heterogeneous list of leaf conditions and nested groups.
+ */
+export type FilterGroupValue = {
+    logic: '$and' | '$or';
+    items: FilterGroupItem[];
+};
+/** Compiled filter param accepted by NocoBase resource `list`. */
+export type CompiledFilter = Record<string, unknown> | undefined;
+interface FilterCtxModel {
+    translate: (key: string) => string;
+    dispatchEvent: (event: 'submit' | 'reset' | (string & {})) => void;
+}
+export interface FilterCtx {
+    model: FilterCtxModel;
+}
+/**
+ * Compile a reactive filter group into the `{ $and: [{ path: { op: val } }] }` envelope accepted by NocoBase's resource `list` filter param. Returns `undefined` when the group is empty so callers can drop the param.
+ *
+ * Mirrors v1's `removeNullCondition` + filter compile path, but works on the v2 `{ logic, items }` group structure rather than v1's Formily-bracketed `$and.0.path.$eq` shape:
+ *
+ * - Rows missing `path` or `operator` are dropped (still mid-edit).
+ * - Rows whose `value` is empty (`undefined`, `''`, `[]`, `{}`) are dropped — matches v1, which sends `filter={}` for a row with only a field/operator picked. Sending `{lockedTs:{}}` would 500.
+ * - Dotted association paths (`user.createdBy.password`) are expanded into nested objects — matches v1's payload shape, which the server resolves along the association chain rather than treating the dotted string as a single key.
+ * - Empty groups (after pruning) propagate as `undefined` so the outermost caller can drop the whole `filter` param.
+ */
+export declare function compileFilterGroup(group: FilterGroupValue | undefined): CompiledFilter;
+/** Which footer button triggered the apply — useful for closing a popover on Submit but keeping it open on Reset. */
+export type FilterApplyAction = 'submit' | 'reset';
+export interface UseFilterActionPropsArgs extends UseFilterOptionsArgs {
+    /** Collection whose fields populate the filter row's field picker. */
+    collection: Collection | undefined;
+    /**
+     * 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(); }`.
+     */
+    onApply: (filter: CompiledFilter, action: FilterApplyAction) => void;
+}
+export interface UseFilterActionPropsResult {
+    /**
+     * Reactive filter group state. Pass directly to `<FilterContent value={...}>`. Stable across renders.
+     */
+    value: FilterGroupValue;
+    /** Field-option tree (for inspection or custom badges). */
+    options: FilterOption[];
+    /** Bound `FilterItem` component to plug into `<FilterContent FilterItem={...}>`. */
+    FilterItem: ReturnType<typeof createCollectionFilterItem> | undefined;
+    /**
+     * Ready-to-use `ctx` for `<FilterContent ctx={...}>`. Wires Submit / Reset buttons to `onSubmit` / `onReset` below.
+     */
+    ctx: FilterCtx;
+    /** Imperative trigger — submit current group as a compiled filter. */
+    onSubmit: () => void;
+    /** Imperative trigger — clear the group and emit an empty filter. */
+    onReset: () => void;
+    /**
+     * Count of top-level condition rows. Useful for showing a badge like `Filter (3)` on the trigger button — matches v1's `field.title = t('{{count}} filter items', { count })`.
+     */
+    conditionCount: number;
+}
+/**
+ * v2 equivalent of v1's `useFilterActionProps` for non-schema surfaces (settings pages, panels, side drawers). Bundles three things v1's hook returned implicitly through schema:
+ *
+ * - A reactive `{ logic, items }` group state that `<FilterContent>` reads.
+ * - A bound `FilterItem` component (driven by `createCollectionFilterItem`).
+ * - A `ctx` object that turns `<FilterContent>`'s `dispatchEvent('submit' | 'reset')` into a compiled filter param passed to `onApply`.
+ *
+ * Pair with antd `Popover` to recreate the legacy `Filter.Action` UX:
+ *
+ * ```tsx
+ * const { value, ctx, FilterItem, onSubmit, conditionCount } = useFilterActionProps({
+ *   collection,
+ *   onApply: (filter) => listRequest.run(filter),
+ *   t,
+ * });
+ * return (
+ *   <Popover content={<FilterContent value={value} ctx={ctx} FilterItem={FilterItem} />}>
+ *     <Button>{t('Filter')}{conditionCount ? ` (${conditionCount})` : ''}</Button>
+ *   </Popover>
+ * );
+ * ```
+ */
+export declare function useFilterActionProps(args: UseFilterActionPropsArgs): UseFilterActionPropsResult;
+export {};

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

@@ -7,6 +7,7 @@
  * For more information, please refer to: https://www.nocobase.com/agreement.
  */
 export * from './createFormRegistry';
+export * from './filter';
 export * from './DialogFormLayout';
 export * from './DrawerFormLayout';
 export * from './EnvVariableInput';
@@ -14,4 +15,5 @@ export * from './FileSizeInput';
 export * from './JsonTextArea';
 export * from './PasswordInput';
 export * from './RemoteSelect';
+export * from './TypedVariableInput';
 export * from './VariableInput';

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

@@ -0,0 +1,50 @@
+/**
+ * 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 { CollectionOptions } from '@nocobase/flow-engine';
+import { FC, ReactNode } from 'react';
+export interface ExtendCollectionsProviderProps {
+    /** Data source key to extend. Defaults to `'main'`. */
+    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 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.
+ *
+ * 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/data-source/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 './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/AdminLayoutMenuModels.d.ts

@@ -45,6 +45,7 @@ export declare class AdminLayoutMenuItemModel extends FlowModel<AdminLayoutMenuI
      * @returns {boolean} 是否需要走 FlowModel 默认保存链路
      */
     hasPersistableInstanceFlows(): boolean;
+    serialize(): ReturnType<FlowModel['serialize']>;
     setHidden(value: boolean): void;
     protected renderHiddenInConfig(): React.ReactNode | undefined;
     createMenuRoute(route: NocoBaseDesktopRoute, options?: {

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

@@ -0,0 +1,11 @@
+/**
+ * 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 { AppListProps } from '@ant-design/pro-layout/es/components/AppsLogoComponents/types';
+import React from 'react';
+export declare function useAppListRender(): (appList: AppListProps) => 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';
@@ -15,5 +17,6 @@ export * from './resolveAdminRouteRuntimeTarget';
 export * from './constants';
 export * from './ResetThemeTokenAndKeepAlgorithm';
 export * from './useApplications';
+export * from './AppListRender';
 export * from './PinnedPluginListLite';
 export * from './mobile-layout';

package/es/flow/admin-shell/admin-layout/useApplications.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.
  */
-/// <reference types="react" />
+import React from 'react';
 export declare const useApplications: () => {
-    Component: import("react").JSXElementConstructor<any> | import("react").ExoticComponent<any>;
+    Component: React.JSXElementConstructor<any> | React.ExoticComponent<any>;
+    appList: any[];
 };

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

@@ -13,5 +13,6 @@ export declare const ConditionBuilder: React.MemoExoticComponent<import("@formil
     value: FilterGroupType;
     onChange: (value: FilterGroupType) => void;
     extraMetaTree?: MetaTreeNode[];
+    maxAssociationFieldDepth?: number;
 }>>;
 export declare const commonConditionHandler: (ctx: any, params: any) => void;