@nocobase/client-v2 2.1.0-beta.34 → 2.1.0-beta.36

package/es/BaseApplication.d.ts

@@ -28,6 +28,11 @@ type AuthTokenPayload = {
     token: string;
     authenticator: string | null;
 };
+export type JsonLogic = {
+    apply: (logic: any, data?: any) => any;
+    addOperation: (name: string, fn?: any) => void;
+    rmOperation: (name: string) => void;
+};
 export type DevDynamicImport = (packageName: string) => Promise<{
     default: PluginClass;
 }>;
@@ -73,6 +78,7 @@ export declare abstract class BaseApplication<TOptions extends BaseApplicationOp
     favicon: string;
     flowEngine: FlowEngine;
     dataSourceManager: any;
+    jsonLogic: JsonLogic;
     context: FlowEngineContext & {
         routeRepository: RouteRepository;
         appInfo: Promise<Record<string, any>>;
@@ -124,7 +130,7 @@ export declare abstract class BaseApplication<TOptions extends BaseApplicationOp
     protected addFinalProviders(): void;
     addReactRouterComponents(): void;
     addRoutes(): void;
-    updateFavicon(favicon?: string): void;
+    updateFavicon(favicon?: string | null): void;
     setWsAuthorized(authorized: boolean): void;
     setMaintaining(maintaining: boolean): void;
     getOptions(): TOptions;

package/es/PluginManager.d.ts

@@ -18,6 +18,8 @@ export type PluginData = {
     version: string;
     url: string;
     clientV2Url?: string;
+    devMode?: 'esm';
+    appDevDependencies?: string[];
     type: 'local' | 'upload' | 'npm';
 };
 export declare class PluginManager<TApp extends BaseApplication<any> = BaseApplication<any>> {

package/es/components/PoweredBy.d.ts

@@ -0,0 +1,18 @@
+/**
+ * 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';
+/**
+ * Footer brand rendered on auth pages and other layout entry points. Falls
+ * back to "Powered by NocoBase" when `@nocobase/plugin-custom-brand` is not
+ * installed; otherwise renders the plugin's HTML template with the
+ * `{{appVersion}}` placeholder substituted. The version is escaped via
+ * `getAppVersionHTML` so a malicious app version cannot inject script tags.
+ */
+export declare function PoweredBy(): React.JSX.Element;
+export default PoweredBy;

package/es/components/SwitchLanguage.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 React from 'react';
+export declare function SwitchLanguage(): React.JSX.Element;
+export default SwitchLanguage;

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

@@ -0,0 +1,75 @@
+/**
+ * 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 DialogFormLayoutProps {
+    /** Header title rendered in the dialog's title slot. */
+    title: React.ReactNode;
+    /** Form body — typically a `<Form>` wrapping `<Form.Item>` fields. */
+    children: React.ReactNode;
+    /**
+     * Called before the dialog is closed by the Cancel button or the
+     * top-right close (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 dialog is closed automatically when
+     * `onSubmit` resolves. Throw from `onSubmit` to keep the dialog 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 dialog-hosted forms — the dialog counterpart of
+ * `DrawerFormLayout`. Title sits left-aligned in the dialog's native
+ * header (no inline close icon — the dialog provides its own X in the
+ * top-right when opened with `viewer.dialog({ closable: true, ... })`),
+ * the form body fills the middle, and a Cancel + Submit footer sits
+ * at the bottom.
+ *
+ * Why not just reuse `DrawerFormLayout`? `DrawerFormLayout` injects a
+ * `<CloseOutlined>` button next to the title — that's the drawer
+ * visual contract (close lives near the title in a side panel). In a
+ * centered dialog the native top-right close button is the expected
+ * affordance, so a separate layout keeps the visual contract clean.
+ *
+ * Callers own the `<Form>` instance, validation, and the actual API
+ * call. This component only handles the chrome and close behaviour.
+ *
+ * Example:
+ *
+ * ```tsx
+ * ctx.viewer.dialog({
+ *   closable: true,                       // native top-right X
+ *   content: () => (
+ *     <DialogFormLayout
+ *       title={t('Bind verifier')}
+ *       onSubmit={handleSubmit}
+ *       submitting={submitting}
+ *       submitText={t('Bind')}
+ *     >
+ *       <Form form={form} layout="vertical">...</Form>
+ *     </DialogFormLayout>
+ *   ),
+ * });
+ * ```
+ */
+export declare function DialogFormLayout(props: DialogFormLayoutProps): React.JSX.Element;

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

@@ -8,15 +8,10 @@
  */
 import React from 'react';
 export interface DrawerFormLayoutProps {
-    /** Header title rendered next to the close (X) button. */
+    /** Header title rendered next to antd Drawer's native close (X) icon. */
     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`
@@ -38,12 +33,17 @@ export interface DrawerFormLayoutProps {
     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.
+ * Standard layout for drawer-hosted forms: a title-only header on top
+ * (caller must open the drawer with `viewer.drawer({ closable: true })`
+ * so antd Drawer renders its native left-side X next to the title),
+ * 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.
+ *
+ * To intercept close (e.g. dirty-form confirmation), use the lower-level
+ * `viewer.drawer({ preventClose, beforeClose, ... })` hooks — this
+ * layout no longer wraps a custom close handler.
  *
  * 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/PasswordInput.d.ts

@@ -0,0 +1,40 @@
+/**
+ * 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 { PasswordProps as AntdPasswordProps } from 'antd/es/input';
+import React from 'react';
+export interface PasswordInputProps extends AntdPasswordProps {
+    /**
+     * Render a visual strength bar beneath the input. Defaults to `false`. The
+     * score is computed locally — opting in does NOT add any form validation;
+     * use a separate `Form.Item.rules` entry for that (or wire the entry up to
+     * a cross-plugin password-validator extension point if your project
+     * provides one).
+     */
+    checkStrength?: boolean;
+}
+/**
+ * `Input.Password` plus an optional strength meter, ported from the v1
+ * `Password` component. The strength scoring and bar UI are identical to v1,
+ * so users who switch from a v1 page to a v2 page see the same visual signal.
+ *
+ * The component is value-shape compatible with antd `Input.Password` — drop
+ * it into any existing `Form.Item<password>` and toggle the meter with
+ * `checkStrength`.
+ *
+ * Caveats:
+ *
+ * - Strength scoring is purely a UX hint, not validation. Submitting a weak
+ *   password is still allowed unless the server (or a separately installed
+ *   password-policy plugin) rejects it.
+ * - The meter swallows the gap between `<Input.Password>` and the next form
+ *   element. If your `Form.Item` already adds vertical rhythm, the meter
+ *   inherits it; no extra spacing is added.
+ */
+export declare function PasswordInput(props: PasswordInputProps): React.JSX.Element;
+export default PasswordInput;

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

@@ -0,0 +1,79 @@
+/**
+ * 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 SelectProps } from 'antd';
+import React from 'react';
+export interface RemoteSelectFieldNames {
+    label?: string;
+    value?: string;
+}
+export interface RemoteSelectProps<RawItem = any, Resp = RawItem[], V = any> extends Omit<SelectProps<V>, 'options' | 'loading'> {
+    /**
+     * Fetch the option source. Receives no arguments; caller closes over the
+     * `ctx.api.resource(...)` (or any other source) it needs. May resolve
+     * with either an array of raw items (the common case) or an arbitrary
+     * envelope object — in the latter case, supply `selectItems` to pluck
+     * the array out.
+     */
+    request: () => Promise<Resp | undefined>;
+    /**
+     * When `request` returns an envelope (object with metadata around the
+     * list), use this to extract the array of items that drives the
+     * dropdown. Defaults to identity, i.e. `request` itself returns the
+     * array.
+     */
+    selectItems?: (response: Resp) => RawItem[] | undefined;
+    /**
+     * Names of the raw item properties that hold the display label and the
+     * persisted value. Defaults to `{ label: 'label', value: 'value' }`.
+     * Ignored when `mapOptions` is supplied.
+     */
+    fieldNames?: RemoteSelectFieldNames;
+    /**
+     * Full custom mapping from a raw item to an antd `OptionType`. When
+     * provided, overrides `fieldNames`.
+     */
+    mapOptions?: (item: RawItem, index: number) => {
+        label: React.ReactNode;
+        value: any;
+    };
+    /**
+     * Stable cache key for ahooks `useRequest` so the dropdown doesn't re-fetch
+     * on every re-mount. Pass a value tied to the request's effective inputs.
+     */
+    cacheKey?: string;
+    /**
+     * Re-run the request when any of these values changes. Forwarded to
+     * `useRequest`'s `refreshDeps`.
+     */
+    refreshDeps?: unknown[];
+    /**
+     * Skip the auto-fetch on mount when `false`. Defaults to `true`.
+     */
+    ready?: boolean;
+    /**
+     * Notified once the request resolves. Receives both the mapped item
+     * array and the raw response envelope — useful when callers need to
+     * read sibling metadata (counts, availability hints, etc.) without
+     * issuing a second request.
+     */
+    onLoaded?: (items: RawItem[], response: Resp) => void;
+}
+/**
+ * Generic settings-page Select bound to an async option source. The
+ * component itself stays framework-agnostic — it knows nothing about
+ * NocoBase resources, data sources, or Formily. Pass any async `request`
+ * that resolves with an array, and supply `fieldNames` (or `mapOptions`)
+ * to map raw items to antd option shape.
+ *
+ * Search is local-only (antd's default `optionFilterProp="label"`). For
+ * server-side search, drive `request` from external state and pass the
+ * search input via `refreshDeps`.
+ */
+export declare function RemoteSelect<RawItem = any, Resp = RawItem[], V = any>(props: RemoteSelectProps<RawItem, Resp, V>): React.JSX.Element;
+export default RemoteSelect;

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

@@ -7,8 +7,11 @@
  * For more information, please refer to: https://www.nocobase.com/agreement.
  */
 export * from './createFormRegistry';
+export * from './DialogFormLayout';
 export * from './DrawerFormLayout';
 export * from './EnvVariableInput';
 export * from './FileSizeInput';
 export * from './JsonTextArea';
+export * from './PasswordInput';
+export * from './RemoteSelect';
 export * from './VariableInput';

package/es/components/form/table/styles.d.ts

@@ -6,6 +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.
  */
+/**
+ * Restore horizontal scrolling on `.ant-table-content` so wide tables in
+ * narrow containers (drawer / settings panel) scroll their inner `<table>`
+ * instead of getting clipped or forcing the outer container to grow.
+ *
+ * `width: max-content` on the inner `<table>` lets columns size to their
+ * natural width; `min-width: 100%` keeps the table filling the viewport
+ * when total column width is smaller than the container.
+ */
+export declare const tableScrollClassName: string;
 /**
  * Reserve a `SORT_HANDLE_GUTTER`-wide gap on the left of the rowSelection
  * column so the handle's `left:0` lands inside a `position:relative` cell.

package/es/components/index.d.ts

@@ -11,5 +11,7 @@ export * from './BlankComponent';
 export * from './form/table/dnd';
 export * from './form';
 export * from './Icon';
+export * from './PoweredBy';
 export * from './RouterContextCleaner';
+export * from './SwitchLanguage';
 export * from './form/table';

package/es/flow/models/base/ActionModelCore.d.ts

@@ -20,10 +20,12 @@ export declare const ActionSceneEnum: {
 export declare class ActionModel<T extends DefaultStructure = DefaultStructure> extends FlowModel<T> {
     props: ButtonProps & {
         tooltip?: string;
+        iconOnly?: boolean;
     };
     scene: ActionSceneType;
     defaultProps: ButtonProps & {
         tooltip?: string;
+        iconOnly?: boolean;
     };
     enableEditTooltip: boolean;
     enableEditTitle: boolean;
@@ -31,6 +33,10 @@ export declare class ActionModel<T extends DefaultStructure = DefaultStructure>
     enableEditType: boolean;
     enableEditDanger: boolean;
     enableEditColor: boolean;
+    buttonTypeOptions: {
+        value: string;
+        label: string;
+    }[];
     static _getScene(): any[];
     static _isScene(scene: ActionSceneType): boolean;
     getAclActionName(): any;

package/es/flow/models/base/GridModel.d.ts

@@ -55,6 +55,7 @@ export declare class GridModel<T extends {
     private buildResizedCells;
     private getResizeRowPath;
     private getResizeContainerWidth;
+    private prunePlaceholderOnlyRows;
     private resizeGridLayout;
     onMount(): void;
     saveGridLayout(layout?: GridLayoutData | GridLayoutV2): void;
@@ -82,6 +83,7 @@ export declare class GridModel<T extends {
      * 运行态按可见 block 过滤行/列，避免“整行都是 hidden block”但依然保留行间距占位。
      * - 配置态（flowSettingsEnabled）保持原始 rows/sizes 以便拖拽和布局编辑。
      * - 运行态仅在判断为“整列/整行都不可见”时做过滤，不写回 props/stepParams，布局元数据保持不变。
+     * - 空列是拖拽缩窄后保存的布局占位，运行态需要保留其宽度，但 Grid 渲染层不会渲染其内容。
      */
     private getVisibleLayout;
     render(): React.JSX.Element;

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

@@ -6,6 +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 { PropertyMetaFactory } from '@nocobase/flow-engine';
 import React from 'react';
 import { FilterBlockModel } from '../../base/FilterBlockModel';
 export declare class FilterFormBlockModel extends FilterBlockModel<{
@@ -22,8 +23,11 @@ export declare class FilterFormBlockModel extends FilterBlockModel<{
     private removeTargetBlockListener?;
     private initialDefaultsPromise?;
     private initialRefreshHandledTargetIds;
+    private lastDefaultValueByFieldName;
+    private defaultValuesRefreshSeq;
     get form(): any;
     get title(): string;
+    protected createFormValuesMetaFactory(): PropertyMetaFactory;
     useHooksBeforeRender(): void;
     saveStepParams(): Promise<any>;
     addAppends(): void;
@@ -34,9 +38,13 @@ export declare class FilterFormBlockModel extends FilterBlockModel<{
     prepareInitialFilterValues(): Promise<boolean>;
     markInitialTargetRefreshHandled(targetId: string): void;
     private ensureFilterItemsBeforeRender;
+    private canApplyFormDefaultValue;
+    private matchDefaultValueCondition;
     applyFormDefaultValues(options?: {
         force?: boolean;
-    }): Promise<void>;
+        refreshSeq?: number;
+    }): Promise<Record<string, any>>;
+    private handleFilterFormValuesChange;
     private handleTargetBlockRemoved;
     destroy(): Promise<boolean>;
     renderComponent(): React.JSX.Element;

package/es/flow/utils/dataScopeFormValueClear.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.
+ */
+import type { FlowContext } from '@nocobase/flow-engine';
+/**
+ * When a field's dataScope filter references other form values (e.g. `{{ ctx.formValues.school.id }}`),
+ * clear current field value after the dependency changes, so users don't keep an invalid stale selection.
+ */
+export declare function ensureFormValueDrivenDataScopeClear(ctx: FlowContext, params: any): void;

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

package/es/hooks/index.d.ts

@@ -7,5 +7,7 @@
  * For more information, please refer to: https://www.nocobase.com/agreement.
  */
 export * from './useApp';
+export * from './useCurrentAppInfo';
 export * from './usePlugin';
 export * from './useRouter';
+export { escapeHTML, getAppVersionHTML } from '../utils/appVersionHTML';

package/es/hooks/useCurrentAppInfo.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 declare function useCurrentAppInfo<TAppInfo extends Record<string, any> = Record<string, any>>(): TAppInfo;