@nocobase/client-v2 2.1.0-alpha.34 → 2.1.0-alpha.35

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

@@ -13,6 +13,7 @@ export interface LegacyValueExtractor {
 export interface LegacyClearer {
     (model: any): void;
 }
+export declare function hasPersistedAssignRulesValue(model: any, flowKey: string, stepKey: string): boolean;
 export declare function createLegacyValueExtractor(flowKeys: string[]): LegacyValueExtractor;
 export declare function createLegacyClearer(flowKeys: string[]): LegacyClearer;
 export declare function collectLegacyDefaultValueRules(formModel: any, extractor: LegacyValueExtractor): FieldAssignRuleItem[];

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

@@ -10,5 +10,11 @@ import React from 'react';
 import { ClickableFieldModel } from './ClickableFieldModel';
 export declare class DisplayEnumFieldModel extends ClickableFieldModel {
     isEmpty(value: any): boolean;
+    private isEmptyEnumValue;
     renderComponent(value: any): React.JSX.Element[];
+    /**
+     * Keep array values for multipleSelect/checkboxGroup.
+     * ClickableFieldModel will normalize arrays to joined strings, which breaks option label mapping.
+     */
+    renderInDisplayStyle(value: any, record?: any, isToMany?: any, wrap?: any): React.JSX.Element;
 }

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;