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

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

@@ -14,3 +14,5 @@ export { VariableFilterItem } from './VariableFilterItem';
 export type { VariableFilterItemProps, VariableFilterItemValue } from './VariableFilterItem';
 export { LinkageFilterItem } from './LinkageFilterItem';
 export type { LinkageFilterItemProps, LinkageFilterItemValue } from './LinkageFilterItem';
+export { useFilterOptions } from './useFilterOptions';
+export type { FilterOption, UseFilterOptionsArgs } from './useFilterOptions';

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

@@ -0,0 +1,66 @@
+/**
+ * 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 { Collection } from '@nocobase/flow-engine';
+/**
+ * One operator entry on a `FilterOption`. Mirrors v1's interface-defined operator shape so the v2 filter value renderer can pick up the same per-operator value-side schema (e.g. datetime operators wanting the smart date picker, array/enum operators wanting a tag-mode Select).
+ */
+export type FilterOperator = {
+    value: string;
+    label: string;
+    /**
+     * Per-operator override for the value-side renderer. Wins over the field's own `uiSchema` when set. The `x-component` string is looked up against the v2 filter component registry.
+     */
+    schema?: {
+        'x-component'?: string;
+        'x-component-props'?: Record<string, any>;
+    } & Record<string, any>;
+    /** Operator takes no right-hand value (e.g. `$empty`, `$notEmpty`). */
+    noValue?: boolean;
+    [key: string]: any;
+};
+/** Single field-tree node returned by `useFilterOptions`. */
+export type FilterOption = {
+    name: string;
+    type?: string;
+    target?: string;
+    title: string;
+    schema?: Record<string, any>;
+    operators?: FilterOperator[];
+    children?: FilterOption[];
+};
+export interface UseFilterOptionsArgs {
+    /**
+     * **Preferred way to restrict fields**, alongside `nonfilterableFieldNames`.
+     *
+     * Whitelist of root-level field names to expose. Empty/undefined means "all filterable fields". The whitelist applies only at depth 1 — nested fields under an allowed association field are always included, matching the legacy v1 `Filter.Action` behaviour.
+     */
+    filterableFieldNames?: string[];
+    /**
+     * **Preferred way to restrict fields**, alongside `filterableFieldNames`.
+     *
+     * Blacklist of root-level field names to drop. Mirrors v1's `nonfilterable: [...]` schema prop on `Filter.Action`. Applies at depth 1 only, same as the whitelist. When both `filterableFieldNames` and `nonfilterableFieldNames` are provided, both apply: the final field set is `(whitelist or all) minus blacklist`.
+     */
+    nonfilterableFieldNames?: string[];
+    /**
+     * Bypass the `filterableFieldNames` whitelist (mirrors v1 `noIgnore`).
+     *
+     * Legacy escape hatch from v1 schemas — prefer adjusting `filterableFieldNames` / `nonfilterableFieldNames` instead. Kept only for parity with existing v1 schemas that already set `noIgnore`.
+     */
+    noIgnore?: boolean;
+    /** Translator used for field/operator labels. Defaults to identity. */
+    t?: (key: string) => string;
+}
+/**
+ * v2 equivalent of v1's `useFilterOptions`/`useFilterFieldOptions`. Walks a `Collection`'s fields and returns the nested option tree consumed by antd `Cascader` in `CollectionFilterItem` (and any other v2 filter surface that wants the same field picker).
+ *
+ * Mirrors v1 in two ways that matter:
+ * - association fields (belongsTo / hasMany / m2m / etc.) are kept and recursed into via `fieldsToOptions`'s `nested` branch — so picking `user.username` is a first-class action, just like the legacy cascader.
+ * - the whitelist applies at depth 1 only, so capping the root field list (e.g. to `['lockedTs', 'unlockTs', 'user']`) doesn't accidentally hide the nested `user.username` / `user.nickname` leaves.
+ */
+export declare function useFilterOptions(collection: Collection | undefined, args?: UseFilterOptionsArgs): FilterOption[];

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: