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

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;

package/es/RouteRepository.d.ts

@@ -124,6 +124,13 @@ 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(layoutUid?: string): void;
@@ -135,5 +142,6 @@ export declare class RouteRepository {
     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/components/form/TypedVariableInput.d.ts

@@ -33,7 +33,9 @@ export interface TypedVariableInputProps {
      * Allowed constant types. The `Constant` switcher entry always exposes a
      * typed submenu (matching v1 `Variable.Input`) so users can see what type
      * the constant is, even when only one type is permitted. Default: all four
-     * supported types.
+     * supported types. Passing `[]` switches the component into a variable-only
+     * mode: constants/null are hidden, the empty state becomes a readonly
+     * placeholder, and clearing a selected variable resets to `null`.
      */
     types?: TypedConstantSpec[];
     /**
@@ -70,6 +72,12 @@ export interface TypedVariableInputProps {
     defaultToFirstConstantTypeWhenUndefined?: boolean;
     /** Variable-token delimiters. Default `['{{', '}}']` — see `VariableInput`. */
     delimiters?: VariableDelimiters;
+    /**
+     * Hide variable choices from the switcher. In variable-only mode this hides
+     * the selector button entirely; in mixed constant/variable mode it keeps the
+     * null/constant choices but removes variable entries.
+     */
+    hideVariable?: boolean;
     disabled?: boolean;
     placeholder?: string;
     style?: React.CSSProperties;

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

@@ -15,6 +15,8 @@ export interface CollectionFilterProps {
     collection: Collection | undefined;
     /** Previously compiled filter param used to seed the editable filter group. */
     initialValue?: CompiledFilter;
+    /** Default compiled filter used both for initial empty state and Reset. */
+    defaultValue?: CompiledFilter;
     /** Called on Submit or Reset with the compiled NocoBase filter param (`undefined` when cleared). */
     onChange: (filter: CompiledFilter) => void;
     /** Translator. Defaults to identity. */

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

@@ -18,6 +18,8 @@ export interface CollectionFilterPanelProps {
     collection: Collection | undefined;
     /** Previously compiled filter param used to seed the editable filter group. */
     initialValue?: CompiledFilter;
+    /** Default compiled filter used both for initial empty state and Reset. */
+    defaultValue?: CompiledFilter;
     /** Called when the condition group structure changes or `reset()` is invoked. */
     onChange?: (filter: CompiledFilter) => void;
     /** Translator. Defaults to identity. */

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

@@ -46,6 +46,8 @@ export interface UseFilterActionPropsArgs extends UseFilterOptionsArgs {
     collection: Collection | undefined;
     /** Previously compiled filter param used to seed the editable filter group. */
     initialValue?: CompiledFilter;
+    /** Default compiled filter used both for initial empty state and Reset. */
+    defaultValue?: CompiledFilter;
     /**
      * 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(); }`.
      */

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

@@ -0,0 +1,14 @@
+/**
+ * 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 declare const ROUTE_TRANSIENT_INPUT_ARGS_KEY = "__nocobaseOpenViewInputArgs";
+export type RouteTransientInputArgsState = {
+    [ROUTE_TRANSIENT_INPUT_ARGS_KEY]?: Record<string, Record<string, unknown>>;
+    usr?: RouteTransientInputArgsState;
+};
+export declare const getRouteTransientInputArgs: (state: unknown, viewUid?: string) => Record<string, unknown>;

package/es/index.d.ts

@@ -28,6 +28,8 @@ export * from './layout-manager';
 export * from './hooks';
 export { default as languageCodes } from './locale/languageCodes';
 export * from './nocobase-buildin-plugin';
+export { getRouteRuntimeVersion } from './utils/getRouteRuntimeVersion';
+export type { RouteRuntimeVersion } from './utils/getRouteRuntimeVersion';
 export * from './collection-field-interface/CollectionFieldInterface';
 export * from './collection-field-interface/CollectionFieldInterfaceManager';
 export * from './collection-manager/field-configure';
@@ -36,7 +38,11 @@ export * from './collection-manager/filter-operators';
 export * from './collection-manager/interfaces';
 export * from './collection-manager/template-fields';
 export * from './data-source';
+export * from './entry-actions';
 export * from './flow';
+export { CodeEditorExtension } from './flow/components/code-editor/extension';
+export type { CodeEditorExtra, CodeEditorExtraRegistry, EditorRef } from './flow/components/code-editor/types';
 export { DEFAULT_DATA_SOURCE_KEY, IconPicker, isTitleField, isTitleFieldInterface, NocoBaseDesktopRouteType, } from './flow-compat';
 export type { NocoBaseDesktopRoute } from './flow-compat';
+export * from './utils/markdownSanitize';
 export { default as AntdAppProvider } from './theme/AntdAppProvider';