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

package/es/APIClient.d.ts

@@ -0,0 +1,16 @@
+/**
+ * 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 { APIClient as APIClientSDK, type APIClientOptions } from '@nocobase/sdk';
+export declare class APIClient extends APIClientSDK {
+    appName?: string;
+    constructor(options?: APIClientOptions);
+    getHostname(): string;
+    getHeaders(): {};
+    interceptors(): void;
+}

package/es/Application.d.ts

@@ -6,8 +6,9 @@
  * 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 { APIClient, type APIClientOptions } from '@nocobase/sdk';
+import { type APIClientOptions } from '@nocobase/sdk';
 import { type i18n as i18next } from 'i18next';
+import { APIClient } from './APIClient';
 import { BaseApplication, type BaseApplicationOptions } from './BaseApplication';
 import type { PluginType } from './PluginManager';
 import { PluginManager } from './PluginManager';

package/es/authRedirect.d.ts

@@ -17,15 +17,8 @@ type LocationLike = {
     search?: string;
     hash?: string;
 };
+export declare function getV2EffectiveBasePath(app: AppLike): string;
 declare function getDefaultV2AdminRedirectPath(app: AppLike): string;
-/**
- * 将 v2 admin 路径转换为对应的 v1 admin 根相对路径。
- *
- * @param app 当前 v2 应用实例
- * @param value 当前 v2 admin 路径或 location 对象
- * @returns 对应的 v1 admin 根相对路径；若无法安全转换则返回 null
- */
-export declare function convertV2AdminPathToLegacy(app: AppLike, value: string | LocationLike): string;
 /**
  * 将当前 v2 页面地址转换为根相对 redirect 路径。
  *
@@ -35,29 +28,29 @@ export declare function convertV2AdminPathToLegacy(app: AppLike, value: string |
  */
 export declare function getCurrentV2RedirectPath(app: AppLike, locationLike: LocationLike): string;
 /**
- * 构造跳转到 v1 登录页的完整 href。
+ * 构造跳转到 v2 登录页的完整 href。
  *
  * @param app 当前 v2 应用实例
  * @param targetPath 登录后回跳地址
- * @returns 指向 v1 登录页的 href
+ * @returns 指向 v2 登录页的 href
  */
-export declare function buildLegacySigninHref(app: AppLike, targetPath: string): string;
+export declare function buildV2SigninHref(app: AppLike, targetPath: string): string;
 /**
- * 通过整页跳转进入 v1 登录页。
+ * 通过整页跳转进入 v2 登录页。
  *
  * @param app 当前 v2 应用实例
  * @param targetPath 登录后回跳地址
  * @param options 跳转选项
  */
-export declare function redirectToLegacySignin(app: AppLike, targetPath: string, options?: {
+export declare function redirectToV2Signin(app: AppLike, targetPath: string, options?: {
     replace?: boolean;
 }): void;
 /**
- * 解析并校验服务端返回的 v1 登录页地址。
+ * 解析并校验服务端返回的 v2 登录页地址。
  *
  * @param value 服务端返回的 redirect
  * @param app 当前 v2 应用实例
- * @returns 合法时返回完整同源 URL，否则返回 null
+ * @returns 合法时返回完整同源 URL,否则返回 null
  */
-export declare function resolveLegacySigninRedirect(value: string | undefined | null, app: AppLike): string;
+export declare function resolveV2SigninRedirect(value: string | undefined | null, app: AppLike): string;
 export { getDefaultV2AdminRedirectPath };

package/es/components/form/EnvVariableInput.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 MetaTreeNode } from '@nocobase/flow-engine';
+import type { MetaTreeNode } from '@nocobase/flow-engine';
 import React from 'react';
 /**
  * Convert a stored value like `"{{ $env.foo.bar }}"` back into the
@@ -33,10 +33,12 @@ export interface EnvVariableInputProps {
     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.
+ * Convenience wrapper around `VariableInput` constrained to the `$env`
+ * namespace, with optional password-input masking for plain values. Use for
+ * fields that accept either a literal credential or a `{{ $env.X }}`
+ * reference (S3 access keys, OAuth secrets, etc.). The `$env` tree is
+ * provided by the environment-variables plugin's
+ * `flowEngine.context.defineProperty('$env', ...)`; this component degrades
+ * gracefully to an empty picker when no env variables are defined.
  */
 export declare function EnvVariableInput(props: EnvVariableInputProps): React.JSX.Element;

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

@@ -0,0 +1,73 @@
+/**
+ * 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, type VariableHybridInputConverters } from '@nocobase/flow-engine';
+import React from 'react';
+export declare function parseVariablePath(value?: string): string[] | undefined;
+export declare function formatVariablePath(meta?: MetaTreeNode): string | undefined;
+/**
+ * Resolve the meta tree the variable picker should expose. Filters the global
+ * meta tree by `namespaces` (top-level property names like `'$env'`,
+ * `'$user'`), appends `extraNodes`, and eagerly resolves any lazy `children`
+ * thunks so labels render on first paint.
+ *
+ * Returns `[]` while loading or when no nodes survive the filter, mirroring
+ * the existing EnvVariableInput behavior so the picker still opens but offers
+ * nothing.
+ */
+export declare function useFilteredMetaTree(options: {
+    namespaces?: string[];
+    extraNodes?: MetaTreeNode[];
+}): MetaTreeNode[];
+export interface VariableInputProps {
+    value?: string;
+    onChange?: (value: string) => void;
+    disabled?: boolean;
+    placeholder?: string;
+    addonBefore?: React.ReactNode;
+    /**
+     * Restrict the picker to specific top-level meta tree namespaces (e.g.
+     * `['$env', '$user']`). When omitted, every registered top-level property is
+     * exposed. Filter happens at the picker level — the underlying regex used
+     * for pill rendering still matches any `{{ ... }}` expression so pre-existing
+     * out-of-scope values stay legible.
+     */
+    namespaces?: string[];
+    /**
+     * Static leaves appended to the picker, after the namespace-filtered nodes.
+     * Use for ad-hoc local-only variables (e.g. `$resetLink`) that are not part
+     * of the global FlowContext registry.
+     */
+    extraNodes?: MetaTreeNode[];
+    /**
+     * Override the converters used by the underlying `VariableHybridInput`.
+     * Mostly useful when the caller wants to constrain `formatPathToValue` to a
+     * specific namespace (see `EnvVariableInput` for that pattern).
+     */
+    converters?: VariableHybridInputConverters;
+    className?: string;
+    style?: React.CSSProperties;
+}
+/**
+ * Inline (single-line) variable input. Renders the literal text and any
+ * `{{ ... }}` references as styled pills via `VariableHybridInput`. Use for
+ * fields like form input titles, email subject lines, or any place a single
+ * line of mixed literal+variable content is appropriate.
+ */
+export declare function VariableInput(props: VariableInputProps): React.JSX.Element;
+export interface VariableTextAreaProps extends Omit<VariableInputProps, 'converters' | 'addonBefore'> {
+    rows?: number;
+    maxRows?: number;
+}
+/**
+ * Multi-line variable input. Variables are inserted as raw `{{ ... }}` text at
+ * the caret rather than rendered as pills — use for email body templates and
+ * other free-form long-form text where literal display of variable expressions
+ * is desirable (the server expands them at render time).
+ */
+export declare function VariableTextArea(props: VariableTextAreaProps): React.JSX.Element;

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

@@ -11,3 +11,4 @@ export * from './DrawerFormLayout';
 export * from './EnvVariableInput';
 export * from './FileSizeInput';
 export * from './JsonTextArea';
+export * from './VariableInput';

package/es/components/form/table/RowOverlayPreview.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';
+import type { RowSnapshot } from './utils';
+/**
+ * Floating clone of the row being dragged, rendered inside a `<DragOverlay>`
+ * so it follows the cursor while the source row stays in place. We inject the
+ * snapshot's `outerHTML` straight into a mini `<table>` so every antd class
+ * (`ant-table-cell`, `ant-table-selection-column`, theme tokens, etc.) is
+ * preserved. A `<colgroup>` re-applies the measured cell widths so the clone
+ * lines up column-for-column with the source row; the wrapper's pinned
+ * `height` + table `height:100%` keeps vertical sizing consistent regardless
+ * of which antd table size variant the caller picked.
+ *
+ * The wrapper also carries `overlayCellStylesClassName` so the index numeric
+ * (`.nb-table-index`) is hidden while dragging — only the handle + checkbox
+ * are surfaced inside the floating clone.
+ */
+export declare function RowOverlayPreview(props: {
+    snapshot: RowSnapshot;
+}): React.JSX.Element;

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

@@ -0,0 +1,36 @@
+/**
+ * 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 SelectionCellProps {
+    /** Whether the row is currently selected — drives the index/checkbox swap. */
+    checked: boolean;
+    /** Zero-based row index (within the current page). `TableIndex` displays it as `index + 1`. */
+    index: number;
+    /** Render the drag handle on the left gutter. Mutually exclusive with `showStandaloneHandle`. */
+    showHandle: boolean;
+    /** Render the row index numeric. When `false` only the antd checkbox is shown (default antd UX). */
+    showIndex: boolean;
+    /** The original antd checkbox node produced by `rowSelection.renderCell`. */
+    originalNode: React.ReactNode;
+}
+/**
+ * The body half of the rowSelection column. Renders, in order:
+ *   1. An absolute-positioned drag handle pinned to the left gutter (only
+ *      when `showHandle` is true). The parent `<td>` must be
+ *      `position: relative` for the handle to land inside the gutter —
+ *      `selectionGutterClassName` in `styles.ts` adds that.
+ *   2. A `.nb-row-selection-cell` wrapper that contains both the row index
+ *      and the checkbox. CSS in `indexSwapClassName` swaps which one is
+ *      visible depending on hover / `checked` state.
+ *
+ * When `showIndex` is false we drop the swap entirely and render only the
+ * original antd checkbox — matches the default antd selection column UX for
+ * tables that don't want the index numeric.
+ */
+export declare function SelectionCell(props: SelectionCellProps): React.JSX.Element;

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

@@ -0,0 +1,82 @@
+/**
+ * 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 TableProps as AntdTableProps } from 'antd';
+import React from 'react';
+import { type RowKey } from './utils';
+/**
+ * Default initial page size for `Table`. Exposed so consumers can seed their
+ * controlled `pageSize` state with the same value the component would use if
+ * they relied purely on the built-in pagination defaults.
+ */
+export declare const DEFAULT_PAGE_SIZE = 50;
+/**
+ * Default `pageSizeOptions` injected into the pagination config. Matches the
+ * v1 settings-page table so users see the same choices across versions.
+ * Consumers can override by passing their own `pageSizeOptions` in
+ * `pagination`.
+ */
+export declare const PAGE_SIZE_OPTIONS: readonly number[];
+export interface TableProps<RecordType extends object = any> extends AntdTableProps<RecordType> {
+    /**
+     * Required so drag-sort, hover-swap and row identity work. Accepts the same
+     * shape as antd `Table.rowKey`. When passed as a function it gets the
+     * record + index and must return a serializable id.
+     */
+    rowKey: RowKey<RecordType>;
+    /**
+     * Show row index (1, 2, 3, …) in the rowSelection column by default; hovering
+     * a row or selecting it reveals the checkbox in the same cell. Requires
+     * `rowSelection` — the index lives in the selection column. Defaults to
+     * `true`.
+     */
+    showIndex?: boolean;
+    /**
+     * Enable vertical drag-and-drop row reordering. When true, rows show a drag
+     * handle on the left and `onSortEnd` fires after each drop. Defaults to
+     * `false`; the rest of the table behaves like a plain antd Table.
+     */
+    isDraggable?: boolean;
+    /**
+     * Called after a row is dropped onto another. Only used when `isDraggable`
+     * is true. The caller persists the move (e.g. `resource.move(...)`) and
+     * refreshes `dataSource` — this component does NOT mutate the data array.
+     */
+    onSortEnd?: (from: RecordType, to: RecordType) => void | Promise<void>;
+    /**
+     * Hide the drag handle entirely while still keeping `isDraggable` on. Useful
+     * when the caller wants to embed `<SortHandle />` inside a custom column.
+     * Defaults to `true`.
+     */
+    showSortHandle?: boolean;
+    /**
+     * Override the width of the auto-inserted handle column when `rowSelection`
+     * is absent. When `rowSelection` is provided the handle is rendered inside
+     * the selection column instead, so this prop is ignored.
+     */
+    sortHandleColumnWidth?: number;
+}
+/**
+ * Generic v2 settings-page table primitive. Built on antd's `Table` and adds:
+ *
+ * - Row-index ↔ checkbox swap inside the selection column (`showIndex`,
+ *   on by default): index visible at rest, checkbox shows on hover or when
+ *   selected. Both elements are absolutely positioned inside the cell so
+ *   they share the same center anchor and never compete for layout space.
+ * - Optional vertical drag-and-drop reordering (`isDraggable`): handle is
+ *   absolute-positioned in a 32px left gutter so the checkbox column stays
+ *   visually centered. The drag overlay renders an `outerHTML` clone of the
+ *   source `<tr>`; the index is suppressed inside the clone so the row
+ *   being moved doesn't display a stale ordinal.
+ *
+ * Use this in place of antd `Table` for any settings-page list. When
+ * `isDraggable` is false the component is a thin pass-through to antd Table
+ * plus the index swap, so it is safe as the default table on any page.
+ */
+export declare function Table<RecordType extends object = any>(props: TableProps<RecordType>): React.JSX.Element;
+export default Table;

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

@@ -0,0 +1,15 @@
+/**
+ * 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.
+ */
+/**
+ * Pixel reservation on the left side of the rowSelection column for the drag
+ * handle. Used by the runtime `selectionGutterClassName` (real table) and by
+ * the drag overlay `overlayCellStylesClassName` (floating clone) so both
+ * variants put the handle in the same gutter position.
+ */
+export declare const SORT_HANDLE_GUTTER = 32;

package/es/components/form/table/dnd/SortableRow.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 { SyntheticListenerMap } from '@dnd-kit/core/dist/hooks/utilities';
+import type { DraggableAttributes } from '@dnd-kit/core';
+import React from 'react';
+type DragSortRowContextValue = {
+    attributes?: DraggableAttributes;
+    listeners?: SyntheticListenerMap;
+    setActivatorNodeRef?: (node: HTMLElement | null) => void;
+};
+export declare const DragSortRowContext: React.Context<DragSortRowContextValue>;
+/**
+ * Activator handle that initiates a row drag. Reads `attributes` / `listeners`
+ * / `setActivatorNodeRef` from the surrounding `DragSortRowContext` provided
+ * by `SortableRow`, so the handle can sit anywhere within the row's cells
+ * (typically a dedicated first column).
+ */
+export declare const SortHandle: React.FC<{
+    id?: string | number;
+    style?: React.CSSProperties;
+}>;
+/**
+ * Drop-in replacement for antd Table's `<tr>` body row that wires `useSortable`
+ * keyed by the `data-row-key` attribute antd injects. Pass via
+ * `Table.components.body.row` and wrap the `<tbody>` with `DndContext` +
+ * `SortableContext`. The `DragSortRowContext` it provides lets `SortHandle`
+ * be placed anywhere inside the row, not just on the row itself.
+ */
+export declare const SortableRow: React.FC<{
+    rowIndex?: number;
+    className?: string;
+    [key: string]: any;
+}>;
+export {};

package/es/components/form/table/dnd/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 './SortableRow';

package/es/components/form/table/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 './Table';

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

@@ -0,0 +1,41 @@
+/**
+ * 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.
+ */
+/**
+ * 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.
+ * Padding is mirrored on both the header `<th>` and body `<td>` so the
+ * "select all" checkbox stays vertically aligned with body checkboxes.
+ *
+ * The class is a module-level constant — emotion's hash is stable across
+ * re-renders, so the caller doesn't need a `useMemo` to keep referential
+ * equality.
+ */
+export declare const selectionGutterClassName: string;
+/**
+ * Index ↔ checkbox hover swap CSS. Both `.nb-table-index` and the antd
+ * checkbox (wrapped in `.nb-origin-node`) are absolutely positioned and
+ * centered inside `.nb-row-selection-cell`, so they share the same anchor
+ * without one displacing the other. `display: none/flex` flips so they never
+ * overlap mid-transition.
+ */
+export declare const indexSwapClassName: string;
+/**
+ * Self-contained styles for the drag-overlay clone. The runtime
+ * `selectionGutterClassName` + `indexSwapClassName` are scoped to AntdTable's
+ * emotion hash, so they don't reach the cloned `<tr>` injected via
+ * `dangerouslySetInnerHTML`. This class replays the minimal subset that the
+ * clone needs:
+ *   - selection column gutter + `position: relative` so the absolute handle
+ *     lands correctly
+ *   - hide the row index inside the overlay (drag preview shouldn't carry
+ *     a stale ordinal)
+ *   - force the checkbox (`.nb-origin-node`) absolute-centered and visible
+ *     regardless of hover/checked state, so the selection cell isn't empty
+ */
+export declare const overlayCellStylesClassName: string;

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

@@ -0,0 +1,44 @@
+/**
+ * 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 React from 'react';
+/**
+ * Same shape as antd Table's `rowKey` prop — either a record key name or a
+ * function. Hoisted here so utilities and `Table.tsx` agree on the contract.
+ */
+export type RowKey<RecordType extends object> = (keyof RecordType & (string | number)) | ((record: RecordType, index?: number) => React.Key);
+/**
+ * Read a stable row id off a record. Mirrors antd Table's rowKey resolution
+ * but normalises non-primitive ids to strings so `data-row-key` attributes
+ * and `useSortable({ id })` agree on equality.
+ */
+export declare function readRowKey<RecordType extends object>(record: RecordType, rowKey: RowKey<RecordType>, index?: number): React.Key | undefined;
+/**
+ * Pixel-perfect snapshot of a rendered `<tr>` for the drag overlay clone.
+ * Contains everything needed to rebuild a visually identical floating row
+ * without re-running antd's column layout pass.
+ */
+export type RowSnapshot = {
+    /** outerHTML of the source `<tr>`, captured at drag start. */
+    html: string;
+    /** Per-cell pixel widths (in DOM order) so the clone can fix them via `<col>`. */
+    cellWidths: number[];
+    /** Total row width — used as the wrapper width so the clone matches source horizontally. */
+    totalWidth: number;
+    /** Total row height — applied to the clone so cell padding matches the source row exactly. */
+    totalHeight: number;
+};
+/**
+ * Snapshot the source `<tr>` so the drag overlay can render a pixel-accurate
+ * floating clone. We can't reliably recompute the layout from `columns` alone
+ * — antd auto-sizes columns at runtime based on content + the surrounding
+ * container — so we read the rendered widths off the DOM at drag start. The
+ * row height is captured too because antd's cell padding rules are scoped to
+ * a selector chain we strip in the clone.
+ */
+export declare function snapshotSourceRow(rowKey: string): RowSnapshot | null;

package/es/components/index.d.ts

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

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

@@ -15,6 +15,7 @@
  * 点击变量选择器后，将形如 {{ ctx.xxx.yyy }} 的变量插入到当前光标位置。
  */
 import React from 'react';
+import { type MetaTreeNode } from '@nocobase/flow-engine';
 export interface TextAreaWithContextSelectorProps {
     value?: string;
     onChange?: (v: string) => void;
@@ -22,6 +23,20 @@ export interface TextAreaWithContextSelectorProps {
     rows?: number;
     maxRows?: number;
     style?: React.CSSProperties;
+    disabled?: boolean;
+    /**
+     * Custom meta tree for the variable picker. Accepts an array, a sync getter,
+     * or an async getter — same shape as `FlowContextSelector`'s `metaTree`. If
+     * omitted, the full `ctx.getPropertyMetaTree()` is used (legacy default).
+     */
+    metaTree?: MetaTreeNode[] | (() => MetaTreeNode[] | Promise<MetaTreeNode[]>);
+    /**
+     * Format a picked meta node into the string inserted at the caret. When
+     * omitted, the FlowContextSelector default (`{{ ctx.X.Y }}`) is used.
+     * Override to match a different storage convention — e.g. NocoBase server
+     * templates use `{{$X.Y}}` without the `ctx.` prefix.
+     */
+    formatPathToValue?: (meta: MetaTreeNode) => string;
 }
 /**
  * TextArea 与变量选择器的组合，紧凑排版，边框无缝拼接。

package/es/flow/models/blocks/table/dragSort/dragSortComponents.d.ts

@@ -6,9 +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.
  */
-import React from 'react';
-export declare const SortHandle: React.FC<{
-    id: string | number;
-    style?: React.CSSProperties;
-}>;
-export declare const SortableRow: (props: any) => React.JSX.Element;
+export { DragSortRowContext, SortHandle, SortableRow } from '../../../../../components/form/table/dnd/SortableRow';

package/es/flow/models/blocks/table/dragSort/dragSortHooks.d.ts

@@ -9,5 +9,9 @@
 import React from 'react';
 import type { TableBlockModel } from '../TableBlockModel';
 export declare function useDragSortBodyWrapper(model: TableBlockModel, dataSourceRef: React.MutableRefObject<any>, getRowKeyFunc: (record: any) => string | number): (props: any) => React.JSX.Element;
-export declare function useDragSortRowComponent(dragSort: boolean): (props: any) => React.JSX.Element;
+export declare function useDragSortRowComponent(dragSort: boolean): React.FC<{
+    [key: string]: any;
+    rowIndex?: number;
+    className?: string;
+}> | ((props: any) => React.JSX.Element);
 export declare function initDragSortParams(model: TableBlockModel): 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) => 0 | 20 | 100 | 80 | 60 | 40;
+export declare const getStrength: (val: any) => 60 | 0 | 20 | 100 | 40 | 80;

package/es/index.d.ts

@@ -7,6 +7,7 @@
  * For more information, please refer to: https://www.nocobase.com/agreement.
  */
 import 'antd/dist/reset.css';
+export * from './APIClient';
 export * from './BaseApplication';
 export * from './Application';
 export * from './PinnedPluginListContext';