@nocobase/client-v2 2.1.0-beta.29 → 2.1.0-beta.32

package/es/BaseApplication.d.ts

@@ -171,6 +171,7 @@ export declare class ApplicationModel extends FlowModel {
     getRouter(): RouterComponentType;
     render(): React.JSX.Element;
     renderMaintaining(): React.ReactElement<any, string | React.JSXElementConstructor<any>>;
+    renderMaintainingDialog(): React.ReactElement<any, string | React.JSXElementConstructor<any>>;
     renderError(): React.ReactElement<any, string | React.JSXElementConstructor<any>>;
     renderContent(): React.JSX.Element;
 }

package/es/PluginManager.d.ts

@@ -17,6 +17,7 @@ export type PluginData = {
     packageName: string;
     version: string;
     url: string;
+    clientV2Url?: string;
     type: 'local' | 'upload' | 'npm';
 };
 export declare class PluginManager<TApp extends BaseApplication<any> = BaseApplication<any>> {

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

@@ -0,0 +1,49 @@
+/**
+ * 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 from 'react';
+export interface DrawerFormLayoutProps {
+    /** Header title rendered next to the close (X) button. */
+    title: React.ReactNode;
+    /** Form body — typically a `<Form>` wrapping `<Form.Item>` fields. */
+    children: React.ReactNode;
+    /**
+     * Called before the drawer is closed by either the Cancel button or the
+     * header's X icon. Use for "discard changes" confirmations.
+     */
+    onCancel?: () => void | Promise<void>;
+    /**
+     * Called when the Submit button is clicked. Caller owns validation + the
+     * actual API call; the drawer is closed automatically when `onSubmit`
+     * resolves. Throw from `onSubmit` to keep the drawer open (e.g. on a
+     * validation error).
+     */
+    onSubmit?: () => void | Promise<void>;
+    /** Drives the Submit button's loading state. */
+    submitting?: boolean;
+    /** Override the Submit button label. Defaults to "Submit". */
+    submitText?: React.ReactNode;
+    /** Override the Cancel button label. Defaults to "Cancel". */
+    cancelText?: React.ReactNode;
+    /**
+     * Full override of the footer content. When provided, the default
+     * Cancel + Submit buttons are replaced. Useful for forms that need
+     * extra actions (e.g. Preview, Save draft).
+     */
+    footer?: React.ReactNode;
+}
+/**
+ * Standard layout for drawer-hosted forms: a close-icon + title header on
+ * top, the caller-provided form body in the middle, and a Cancel + Submit
+ * footer at the bottom. Wraps `useFlowView()`'s `Header` / `Footer` slots
+ * so the drawer chrome stays consistent across plugins.
+ *
+ * Callers own the `<Form>` instance, validation, and the actual API call.
+ * This component only handles the chrome and the close behaviour.
+ */
+export declare function DrawerFormLayout(props: DrawerFormLayoutProps): React.JSX.Element;

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

@@ -0,0 +1,42 @@
+/**
+ * This file is part of the NocoBase (R) project.
+ * Copyright (c) 2020-2024 NocoBase Co., Ltd.
+ * Authors: NocoBase Team.
+ *
+ * This project is dual-licensed under AGPL-3.0 and NocoBase Commercial License.
+ * For more information, please refer to: https://www.nocobase.com/agreement.
+ */
+import { type MetaTreeNode } from '@nocobase/flow-engine';
+import React from 'react';
+/**
+ * Convert a stored value like `"{{ $env.foo.bar }}"` back into the
+ * `[$env, foo, bar]` path used by the variable picker.
+ */
+export declare function parseEnvPath(value?: string): string[] | undefined;
+/**
+ * Format a meta tree node back into a `"{{ $env.x.y }}"` server-compatible
+ * expression. Used as the `formatPathToValue` converter so the picker output
+ * survives a round trip through the API.
+ */
+export declare function formatEnvPath(meta?: MetaTreeNode): string;
+export interface EnvVariableInputProps {
+    value?: string;
+    onChange?: (value: string) => void;
+    addonBefore?: React.ReactNode;
+    disabled?: boolean;
+    /**
+     * When true, plain (non-variable) values are masked via `Input.Password`
+     * so secret credentials are not displayed verbatim. Variable expressions
+     * remain editable through the variable picker even in password mode.
+     */
+    password?: boolean;
+    placeholder?: string;
+}
+/**
+ * Generic input component for fields that accept either a literal value or a
+ * `{{ $env.X }}` reference. The `$env` namespace is wired through the
+ * environment-variables plugin's `flowEngine.context.defineProperty('$env', ...)`
+ * registration; this component is the single consumption point and degrades
+ * gracefully to a plain text input when no env variables are defined.
+ */
+export declare function EnvVariableInput(props: EnvVariableInputProps): React.JSX.Element;

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

@@ -0,0 +1,27 @@
+/**
+ * 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 from 'react';
+export interface FileSizeInputProps {
+    value?: number;
+    onChange?: (value?: number) => void;
+    disabled?: boolean;
+    /** Minimum byte size. Empty / below-min input snaps to this on blur. Defaults to 1. */
+    min?: number;
+    /** Maximum byte size. Defaults to `Number.POSITIVE_INFINITY`. */
+    max?: number;
+    /** Default byte size used to derive the initial unit shown when the field is empty. Defaults to 20 MB. */
+    defaultValue?: number;
+}
+/**
+ * Byte-valued size input paired with a unit selector (Byte / KB / MB / GB).
+ * The persisted value is always normalized to bytes; the displayed number is
+ * derived from the picked unit. Useful for fields like file-size limits or
+ * memory quotas where the natural input unit varies by magnitude.
+ */
+export declare function FileSizeInput(props: FileSizeInputProps): React.JSX.Element;

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

@@ -0,0 +1,33 @@
+/**
+ * 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 interface FormRegistryEntry {
+    name: string;
+}
+export interface FormRegistry<T extends FormRegistryEntry> {
+    readonly namespace: string;
+    register(entry: T): void;
+    unregister(name: string): boolean;
+    get(name: string): T | undefined;
+    has(name: string): boolean;
+    list(): T[];
+}
+/**
+ * Create an isolated, namespaced registry of form-like entries.
+ *
+ * Each call returns a fresh registry instance backed by its own closure-scoped
+ * `Map`, so plugins do not share state across namespaces. Plugins that need an
+ * extension point for form-shaped registrations (e.g. storage configuration
+ * forms, data-source connection forms) can build their own typed registry on
+ * top of this primitive instead of re-implementing the same boilerplate.
+ *
+ * Re-registering the same `name` overwrites the previous entry and emits a
+ * console warning. This is intentional so HMR / hot reload works without
+ * throwing, while still surfacing unintended duplicates during development.
+ */
+export declare function createFormRegistry<T extends FormRegistryEntry>(namespace: string): FormRegistry<T>;

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

@@ -0,0 +1,13 @@
+/**
+ * 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 './createFormRegistry';
+export * from './DrawerFormLayout';
+export * from './EnvVariableInput';
+export * from './FileSizeInput';
+export * from './JsonTextArea';

package/es/components/index.d.ts

@@ -8,6 +8,6 @@
  */
 export * from './AppComponents';
 export * from './BlankComponent';
+export * from './form';
 export * from './Icon';
-export * from './form/JsonTextArea';
 export * from './RouterContextCleaner';

package/es/flow/actions/index.d.ts

@@ -35,7 +35,7 @@ export * from './formAssignRules';
 export * from './filterFormDefaultValues';
 export * from './linkageRulesRefresh';
 export * from './blockHeight';
-export { fieldLinkageRules, subFormFieldLinkageRules, detailsFieldLinkageRules, linkageSetDetailsFieldProps, actionLinkageRules, blockLinkageRules, linkageSetBlockProps, linkageSetActionProps, linkageSetFieldProps, subFormLinkageSetFieldProps, linkageAssignField, linkageRunjs, subFormLinkageAssignField, } from './linkageRules';
+export { fieldLinkageRules, subFormFieldLinkageRules, detailsFieldLinkageRules, linkageSetDetailsFieldProps, actionLinkageRules, menuLinkageRules, blockLinkageRules, linkageSetBlockProps, linkageSetActionProps, linkageSetMenuItemProps, linkageSetFieldProps, subFormLinkageSetFieldProps, linkageAssignField, linkageRunjs, subFormLinkageAssignField, } from './linkageRules';
 export { displayFieldComponent } from './displayFieldComponent';
 export * from './overflowMode';
 export * from './numberFormat';

package/es/flow/actions/linkageRules.d.ts

@@ -9,6 +9,7 @@
 import { FlowContext, FlowModel } from '@nocobase/flow-engine';
 export declare const linkageSetBlockProps: import("@nocobase/flow-engine").ActionDefinition<FlowModel<import("@nocobase/flow-engine").DefaultStructure>, FlowContext>;
 export declare const linkageSetActionProps: import("@nocobase/flow-engine").ActionDefinition<FlowModel<import("@nocobase/flow-engine").DefaultStructure>, FlowContext>;
+export declare const linkageSetMenuItemProps: import("@nocobase/flow-engine").ActionDefinition<FlowModel<import("@nocobase/flow-engine").DefaultStructure>, FlowContext>;
 export declare const linkageSetFieldProps: import("@nocobase/flow-engine").ActionDefinition<FlowModel<import("@nocobase/flow-engine").DefaultStructure>, FlowContext>;
 export declare const subFormLinkageSetFieldProps: import("@nocobase/flow-engine").ActionDefinition<FlowModel<import("@nocobase/flow-engine").DefaultStructure>, FlowContext>;
 export declare const linkageSetDetailsFieldProps: import("@nocobase/flow-engine").ActionDefinition<FlowModel<import("@nocobase/flow-engine").DefaultStructure>, FlowContext>;
@@ -18,6 +19,7 @@ export declare const setFieldsDefaultValue: import("@nocobase/flow-engine").Acti
 export declare const linkageRunjs: import("@nocobase/flow-engine").ActionDefinition<FlowModel<import("@nocobase/flow-engine").DefaultStructure>, FlowContext>;
 export declare const blockLinkageRules: import("@nocobase/flow-engine").ActionDefinition<FlowModel<import("@nocobase/flow-engine").DefaultStructure>, FlowContext>;
 export declare const actionLinkageRules: import("@nocobase/flow-engine").ActionDefinition<FlowModel<import("@nocobase/flow-engine").DefaultStructure>, FlowContext>;
+export declare const menuLinkageRules: import("@nocobase/flow-engine").ActionDefinition<FlowModel<import("@nocobase/flow-engine").DefaultStructure>, FlowContext>;
 export declare const fieldLinkageRules: import("@nocobase/flow-engine").ActionDefinition<FlowModel<import("@nocobase/flow-engine").DefaultStructure>, FlowContext>;
 export declare const subFormFieldLinkageRules: import("@nocobase/flow-engine").ActionDefinition<FlowModel<import("@nocobase/flow-engine").DefaultStructure>, FlowContext>;
 export declare const detailsFieldLinkageRules: import("@nocobase/flow-engine").ActionDefinition<FlowModel<import("@nocobase/flow-engine").DefaultStructure>, FlowContext>;

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

@@ -25,6 +25,8 @@ export declare class AdminLayoutMenuItemModel extends FlowModel<AdminLayoutMenuI
     getRouteRepository(): any;
     hasPersistedMenuInstanceFlowFlag(route?: NocoBaseDesktopRoute): boolean;
     getCurrentPersistedInstanceFlowCount(): number;
+    hasPersistableMenuLinkageRules(): boolean;
+    hasCurrentPersistedMenuState(): boolean;
     buildRouteOptionsWithPersistedFlowFlag(hasPersistedMenuInstanceFlow: boolean): {
         [x: string]: any;
         hasPersistedMenuInstanceFlow?: boolean;
@@ -43,6 +45,8 @@ export declare class AdminLayoutMenuItemModel extends FlowModel<AdminLayoutMenuI
      * @returns {boolean} 是否需要走 FlowModel 默认保存链路
      */
     hasPersistableInstanceFlows(): boolean;
+    setHidden(value: boolean): void;
+    protected renderHiddenInConfig(): React.ReactNode | undefined;
     createMenuRoute(route: NocoBaseDesktopRoute, options?: {
         parentId?: string | number;
         refreshAfterMutation?: boolean;

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

@@ -37,12 +37,19 @@ type GetAdminLayoutModelOptions<TModel extends FlowModel = AdminLayoutModel> = {
  */
 export declare class AdminLayoutModel extends FlowModel<AdminLayoutStructure> {
     isMobileLayout: boolean;
+    menuRouteRefreshVersion: number;
     private routeCoordinator?;
     private routeDisposer?;
     private activePageUid;
     private layoutContentElement;
     private readonly routePageMetaMap;
     constructor(options: any);
+    /**
+     * 通知 Layout 重新生成 ProLayout 菜单路由。
+     *
+     * @returns {void}
+     */
+    refreshMenuRouteTree(): void;
     /**
      * 注册页面运行时信息。
      *

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

@@ -9,10 +9,12 @@
 import type { BaseApplication } from '../../../BaseApplication';
 import { type NocoBaseDesktopRoute } from '../../../flow-compat';
 export type AdminRouteNavigationMode = 'spa' | 'document';
+export type AdminRouteRuntimeTargetReason = 'ok' | 'missingSchemaUid' | 'unsupportedV2Runtime' | 'emptyGroup' | 'unsupportedRouteType';
 export type AdminRouteRuntimeTarget = {
     runtimePath: string | null;
     navigationMode: AdminRouteNavigationMode;
     isLegacy: boolean;
+    reason: AdminRouteRuntimeTargetReason;
 };
 type LocationLike = {
     pathname: string;
@@ -30,7 +32,10 @@ type ResolveAdminRouteRuntimeTargetOptions = {
     preserveLocationState?: boolean;
     log?: (message?: any, ...optionalParams: any[]) => void;
 };
+export declare function isV2AdminRuntime(app?: ResolveAdminRouteRuntimeTargetOptions['app']): boolean;
 export declare function toRouterNavigationPath(pathname: string, basename?: string): string;
+export declare function isV2MenuRoute(route: NocoBaseDesktopRoute | undefined): boolean;
+export declare function findFirstV2LandingRoute(routes: NocoBaseDesktopRoute[] | undefined): NocoBaseDesktopRoute | undefined;
 export declare function findFirstAccessiblePageRoute(routes: NocoBaseDesktopRoute[] | undefined): NocoBaseDesktopRoute | undefined;
 /**
  * 将 desktop route 解析为实际运行时跳转目标。

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

@@ -16,6 +16,7 @@ type CollectionFieldLike = {
     title?: unknown;
     type?: unknown;
     interface?: unknown;
+    uiSchema?: unknown;
     targetKey?: unknown;
     targetCollectionTitleFieldName?: unknown;
     targetCollection?: any;

package/es/flow/internal/utils/enumOptionsUtils.d.ts

@@ -19,5 +19,10 @@ type Option = {
 } & Record<string, any>;
 export declare function translateOptions(options: Option[], t: (s: string) => string): Option[];
 export declare function enumToOptions(uiEnum: UiSchemaEnumItem[] | undefined, t: (s: string) => string): Option[] | undefined;
+export declare function normalizeSelectRenderValue(value: unknown, props?: Record<string, any>): unknown;
+export declare function getSelectedEnumLabels(value: any, fallbackOptions?: Option[]): Array<{
+    value: any;
+    label: any;
+}>;
 export declare function ensureOptionsFromUiSchemaEnumIfAbsent(model: FlowModel, collectionField: CollectionField): boolean;
 export {};

package/es/flow/models/actions/AssociationActionUtils.d.ts

@@ -13,5 +13,10 @@ export declare const getAssociationTargetResourceSettings: (ctx: FlowModelContex
     dataSourceKey: any;
     collectionName: any;
 };
+export declare const getAssociationSelectorContextInputArgs: (ctx: FlowModelContext | any) => {
+    collectionField: any;
+    sourceId: any;
+    associatedRecords: any;
+};
 export declare const applyDisassociateAction: (ctx: FlowModelContext | any) => Promise<void>;
 export declare const applyAssociateAction: (ctx: FlowModelContext | any, selectedRows: any[]) => Promise<void>;

package/es/flow/models/blocks/filter-form/FilterFormBlockModel.d.ts

@@ -20,6 +20,8 @@ export declare class FilterFormBlockModel extends FilterBlockModel<{
      */
     autoTriggerFilter: boolean;
     private removeTargetBlockListener?;
+    private initialDefaultsPromise?;
+    private initialRefreshHandledTargetIds;
     get form(): any;
     get title(): string;
     useHooksBeforeRender(): void;
@@ -29,6 +31,8 @@ export declare class FilterFormBlockModel extends FilterBlockModel<{
     onMount(): void;
     onUnmount(): void;
     private applyDefaultsAndInitialFilter;
+    prepareInitialFilterValues(): Promise<boolean>;
+    markInitialTargetRefreshHandled(targetId: string): void;
     private ensureFilterItemsBeforeRender;
     applyFormDefaultValues(options?: {
         force?: boolean;

package/es/flow/models/blocks/filter-manager/FilterManager.d.ts

@@ -17,6 +17,9 @@ type FilterConfig = {
     /** 筛选操作符，每个条件的操作符可以不一样 */
     operator?: string;
 };
+export type RefreshTargetsByFilterOptions = {
+    excludeTargetIds?: Set<string> | string[];
+};
 export type ConnectFieldsConfig = {
     targets: {
         /** 数据区块或者图表区块的 model uid */
@@ -32,6 +35,7 @@ export declare class FilterManager {
     saveFilterConfigs(): Promise<void>;
     getFilterConfigs(): FilterConfig[];
     getConnectFieldsConfig(filterModelUid: string): ConnectFieldsConfig | undefined;
+    prepareFiltersForTarget(targetId: string): Promise<Set<any>>;
     saveConnectFieldsConfig(filterModelUid: string, config: ConnectFieldsConfig): Promise<void>;
     /**
      * 添加筛选配置
@@ -136,6 +140,6 @@ export declare class FilterManager {
      * await filterManager.refreshTargetsByFilter(['filter-1', 'filter-2']);
      * ```
      */
-    refreshTargetsByFilter(filterId: string | string[]): Promise<void>;
+    refreshTargetsByFilter(filterId: string | string[], options?: RefreshTargetsByFilterOptions): Promise<void>;
 }
 export {};

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

@@ -7,6 +7,14 @@
  * For more information, please refer to: https://www.nocobase.com/agreement.
  */
 import { TableBlockModel } from './TableBlockModel';
+export declare function getAssociationSelectForeignKeyFilter(collectionField: any): {
+    [x: number]: {
+        $is: any;
+    };
+};
+export declare function getAssociationSelectAssociatedRecordsFilter(collection: any, associatedRecords?: any[]): {
+    [x: string]: any[];
+};
 export declare class TableSelectModel extends TableBlockModel {
     static scene: import("../../base/BlockModel").BlockSceneType;
     rowSelectionProps: any;

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

@@ -11,6 +11,8 @@ import { TableColumnProps } from 'antd';
 import React from 'react';
 import { SubTableFieldModel } from '.';
 import { FieldModel } from '../../../base/FieldModel';
+export declare const SUB_TABLE_COLUMN_FIELD_COMPONENT_CONTEXT = "subTableColumn";
+export declare function isSubTableColumnFieldComponentContext(ctx: any): boolean;
 export declare function FieldWithoutPermissionPlaceholder({ targetModel }: {
     targetModel: any;
 }): React.JSX.Element;
@@ -24,6 +26,7 @@ export interface SubTableColumnModelStructure {
 }
 export declare class SubTableColumnModel<T extends SubTableColumnModelStructure = SubTableColumnModelStructure> extends EditableItemModel<T> {
     static renderMode: ModelRenderMode;
+    static fieldComponentContext: string;
     renderHiddenInConfig(): React.JSX.Element;
     static defineChildren(ctx: FlowModelContext): any;
     get collection(): any;

package/es/flow/models/fields/DisplayTitleFieldModel.d.ts

@@ -7,7 +7,7 @@
  * For more information, please refer to: https://www.nocobase.com/agreement.
  */
 import { CollectionField } from '@nocobase/flow-engine';
-import { FieldModel } from '../base/FieldModel';
+import { FieldModel } from '../base';
 export declare class DisplayTitleFieldModel extends FieldModel {
     get collectionField(): CollectionField;
     renderComponent(value: any): any;

package/es/flow/models/utils/displayValueUtils.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.
+ */
+export declare function hasDisplayValue(value: any): boolean;
+export declare function normalizeDisplayValue(value: any, options?: {
+    collectionField?: any;
+}): any;

package/es/flow-compat/passwordUtils.d.ts

@@ -6,4 +6,4 @@
  * 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 getStrength: (val: any) => 0 | 100 | 80 | 60 | 40 | 20;
+export declare const getStrength: (val: any) => 0 | 20 | 100 | 80 | 60 | 40;