@nocobase/client 2.1.0-alpha.1 → 2.1.0-alpha.2

package/.dumirc.ts

@@ -156,6 +156,10 @@ export default defineConfig({
               title: '生命周期',
               link: '/examples/flow-models/lifecycle',
             },
+            {
+              title: 'scheduleModelOperation',
+              link: '/examples/flow-models/schedule-model-operation',
+            },
             {
               title: 'hidden 属性演示',
               link: '/examples/flow-model-hidden',
@@ -398,6 +402,10 @@ export default defineConfig({
               title: 'ctx.exit()',
               link: '/examples/flow-context/exit',
             },
+            {
+              title: 'ctx.customRepository',
+              link: '/examples/flow-context/custom-repository',
+            },
           ],
         },
         {

package/es/ai/ai-manager.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.
+ */
+import { Application } from '../application';
+import { ToolsManager } from './tools-manager';
+export declare class AIManager {
+    protected readonly app: Application;
+    toolsManager: ToolsManager;
+    constructor(app: Application);
+}

package/es/ai/index.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.
+ */
+export * from './ai-manager';
+export * from './tools-manager';
+export * from './utils';

package/es/ai/tools-manager/hooks/context.d.ts

@@ -0,0 +1,17 @@
+/**
+ * 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 { ToolsEntry } from '../types';
+export interface ToolsContextValue {
+    tools: ToolsEntry[];
+    loading: boolean;
+    error: Error | null;
+    refresh: () => Promise<void>;
+}
+export declare const ToolsContext: React.Context<ToolsContextValue>;

package/es/ai/tools-manager/hooks/index.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.
+ */
+export declare const useTools: () => import("./context").ToolsContextValue;
+export * from './context';
+export * from './provider';

package/es/ai/tools-manager/hooks/provider.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 React, { ReactNode } from 'react';
+import { ToolsManager } from '../types';
+interface ToolsProviderProps {
+    toolsManager: ToolsManager;
+    children: ReactNode;
+}
+export declare const ToolsProvider: React.FC<ToolsProviderProps>;
+export {};

package/es/ai/tools-manager/index.d.ts

@@ -0,0 +1,21 @@
+/**
+ * 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 { Registry } from '@nocobase/utils/client';
+import { FrontendTools, ToolsEntry, ToolsFilter, ToolsManager, ToolsOptions } from './types';
+import { Application } from '../../application';
+export declare class DefaultToolsManager implements ToolsManager {
+    protected readonly app: Application;
+    private readonly tools;
+    constructor(app: Application, tools?: any);
+    listTools(filter?: ToolsFilter): Promise<ToolsEntry[]>;
+    useTools(): Registry<FrontendTools>;
+    registerTools(name: string, options: ToolsOptions): void;
+}
+export * from './types';
+export * from './hooks';

package/es/ai/tools-manager/types.d.ts

@@ -0,0 +1,80 @@
+/**
+ * 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 { ComponentType } from 'react';
+import type { Application } from '../../application';
+import { Registry } from '@nocobase/utils/client';
+export interface ToolsManager extends ToolsRegistration {
+    listTools(filter?: ToolsFilter): Promise<ToolsEntry[]>;
+    useTools(): Registry<FrontendTools>;
+}
+export interface ToolsRegistration {
+    registerTools(name: string, options: ToolsOptions): void;
+}
+export type ToolsOptions = {
+    ui?: {
+        card?: ComponentType<ToolsUIProperties>;
+        modal?: {
+            title?: string;
+            okText?: string;
+            useOnOk?: (decisions: ToolsUIProperties['decisions'], adjustArgs: Record<string, any>) => {
+                onOk: () => void | Promise<void>;
+            };
+            Component?: ComponentType<{
+                tool: ToolCall;
+                saveToolArgs?: (args: unknown) => Promise<void>;
+            }>;
+        };
+    };
+    invoke?: (ctx: Application, params: any) => any | Promise<any>;
+    useHooks?: () => ToolsOptions;
+};
+export type ToolCall<T = unknown> = {
+    id: string;
+    type: string;
+    name: string;
+    status?: 'success' | 'error';
+    invokeStatus: 'init' | 'interrupted' | 'waiting' | 'pending' | 'done' | 'confirmed';
+    auto: boolean;
+    args: T;
+    [key: string]: any;
+};
+export type FrontendTools = ToolsOptions;
+export type BackendTools = {
+    scope: Scope;
+    defaultPermission?: Permission;
+    silence?: boolean;
+    introduction?: {
+        title: string;
+        about: string;
+    };
+    definition: {
+        name: string;
+        description: string;
+        schema?: any;
+    };
+};
+export type ToolsEntry = BackendTools & FrontendTools;
+export type ToolsUIProperties<ToolCallArgs = unknown> = {
+    messageId: string;
+    tools: ToolsEntry;
+    toolCall: ToolCall<ToolCallArgs>;
+    decisions: DecisionActions;
+};
+export type DecisionActions = {
+    approve: () => Promise<void>;
+    edit: (args: any) => Promise<void>;
+    reject: (message: string) => Promise<void>;
+};
+export type ToolsFilter = {
+    scope?: Scope;
+    defaultPermission?: Permission;
+    silence?: boolean;
+};
+export type Scope = 'SPECIFIED' | 'GENERAL' | 'CUSTOM';
+export type Permission = 'ASK' | 'ALLOW';

package/es/ai/utils.d.ts

@@ -0,0 +1,10 @@
+/**
+ * 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 { ToolsEntry } from './tools-manager';
+export declare const toToolsMap: (tools: ToolsEntry[]) => Map<string, ToolsEntry>;

package/es/api-client/APIClient.d.ts

@@ -16,6 +16,7 @@ export declare class APIClient extends APIClientSDK {
     /** 该值会在 AntdAppProvider 中被重新赋值 */
     notification: any;
     cloneInstance(): APIClient;
+    getHostname(): string;
     getHeaders(): {};
     service(uid: string): Result<any, any>;
     interceptors(): void;

package/es/application/Application.d.ts

@@ -22,6 +22,7 @@ import { FlowEngine, FlowEngineContext } from '@nocobase/flow-engine';
 import type { CollectionFieldInterfaceFactory } from '../data-source';
 import type { Plugin } from './Plugin';
 import type { RequireJS } from './utils/requirejs';
+import { AIManager } from '../ai';
 type JsonLogic = {
     addOperation: (name: string, fn?: any) => void;
     rmOperation: (name: string) => void;
@@ -82,6 +83,7 @@ interface Variable {
 export declare class Application {
     protected options: ApplicationOptions;
     eventBus: EventTarget;
+    aiManager: AIManager;
     providers: ComponentAndProps[];
     router: RouterManager;
     scopes: Record<string, any>;

package/es/application/Plugin.d.ts

@@ -19,6 +19,7 @@ export declare class Plugin<T = any> {
     };
     get flowEngine(): import("@nocobase/flow-engine").FlowEngine;
     get engine(): import("@nocobase/flow-engine").FlowEngine;
+    get ai(): import("..").AIManager;
     get pm(): import("./PluginManager").PluginManager;
     get router(): import("./RouterManager").RouterManager;
     get pluginSettingsManager(): import("./PluginSettingsManager").PluginSettingsManager;

package/es/application/RouteRepository.d.ts

@@ -0,0 +1,23 @@
+/**
+ * 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.
+ */
+type RouteOptions = {
+    id: string;
+    schemaUid: string;
+    children?: RouteOptions[];
+};
+export declare class RouteRepository {
+    protected ctx: any;
+    routes: Array<RouteOptions>;
+    constructor(ctx: any);
+    setRoutes(routes: Array<any>): void;
+    listAccessible(): RouteOptions[];
+    getRouteBySchemaUid(schemaUid: string): RouteOptions | undefined;
+    private findRoute;
+}
+export {};

package/es/application/globalOperators.d.ts

@@ -0,0 +1,11 @@
+export function getOperators(): {
+    is_logic(logic: any): boolean;
+    truthy(value: any): boolean;
+    getOperator(logic: any): string;
+    getValues(logic: any): any;
+    apply(logic: any, data: any): any;
+    uses_data(logic: any): any[];
+    addOperation(name: any, code: any): void;
+    rmOperation(name: any): void;
+    rule_like(rule: any, pattern: any): any;
+};

package/es/block-provider/TableUidContext.d.ts

@@ -0,0 +1,10 @@
+/**
+ * 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.
+ */
+/// <reference types="react" />
+export declare const TableUidContext: import("react").Context<string>;

package/es/data-source/collection/utils.d.ts

@@ -12,7 +12,7 @@ import type { CollectionOptions } from './Collection';
  * @internal
  */
 export declare const collectionTransform: (collection: CollectionOptions, app: Application) => {
-    title: string;
+    title: any;
     rawTitle: any;
     fields: {
         name?: any;
@@ -28,9 +28,7 @@ export declare const collectionTransform: (collection: CollectionOptions, app: A
         with?: string | string[];
         delayRestore?: any;
     };
-    tableName?: string; /**
-     * @internal
-     */
+    tableName?: string;
     inherits?: string | string[];
     inherit?: string;
     key?: string;

package/es/flow/actions/aclCheckRefresh.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 const aclCheckRefresh: import("@nocobase/flow-engine").ActionDefinition<import("@nocobase/flow-engine").FlowModel<import("@nocobase/flow-engine").DefaultStructure>, import("@nocobase/flow-engine").FlowContext>;

package/es/flow/actions/blockHeight.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 const blockHeight: import("@nocobase/flow-engine").ActionDefinition<import("@nocobase/flow-engine").FlowModel<import("@nocobase/flow-engine").DefaultStructure>, import("@nocobase/flow-engine").FlowContext>;

package/es/flow/actions/filterFormDefaultValues.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 const filterFormDefaultValues: import("@nocobase/flow-engine").ActionDefinition<import("@nocobase/flow-engine").FlowModel<import("@nocobase/flow-engine").DefaultStructure>, import("@nocobase/flow-engine").FlowContext>;

package/es/flow/actions/formAssignRules.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 const formAssignRules: import("@nocobase/flow-engine").ActionDefinition<import("@nocobase/flow-engine").FlowModel<import("@nocobase/flow-engine").DefaultStructure>, import("@nocobase/flow-engine").FlowContext>;

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

@@ -25,9 +25,15 @@ export * from './layout';
 export * from './required';
 export * from './fieldComponent';
 export * from './aclCheck';
+export * from './aclCheckRefresh';
 export * from './pattern';
 export * from './validation';
 export * from './columnFixed';
+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 { displayFieldComponent } from './displayFieldComponent';
 export * from './overflowMode';
+export * from './numberFormat';

package/es/flow/actions/linkageRulesRefresh.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 const linkageRulesRefresh: import("@nocobase/flow-engine").ActionDefinition<import("@nocobase/flow-engine").FlowModel<import("@nocobase/flow-engine").DefaultStructure>, import("@nocobase/flow-engine").FlowContext>;

package/es/flow/actions/numberFormat.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 const numberFormat: import("@nocobase/flow-engine").ActionDefinition<import("@nocobase/flow-engine").FlowModel<import("@nocobase/flow-engine").DefaultStructure>, import("@nocobase/flow-engine").FlowContext>;

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

@@ -12,4 +12,5 @@ export declare const BlockItemCard: React.ForwardRefExoticComponent<CardProps &
     beforeContent?: React.ReactNode;
     afterContent?: React.ReactNode;
     description?: any;
+    heightMode?: string;
 } & React.RefAttributes<unknown>>;

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

@@ -6,10 +6,12 @@
  * 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';
 import { FilterGroupType } from '@nocobase/utils/client';
 export declare const ConditionBuilder: React.MemoExoticComponent<import("@formily/reactive-react").ReactFC<{
     value: FilterGroupType;
     onChange: (value: FilterGroupType) => void;
+    extraMetaTree?: MetaTreeNode[];
 }>>;
 export declare const commonConditionHandler: (ctx: any, params: any) => void;

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

@@ -14,6 +14,7 @@ interface Props {
     onChange: (value: any) => void;
     metaTree: MetaTreeNode[] | (() => Promise<MetaTreeNode[]>);
     model: FieldModel;
+    flags?: Record<string, any>;
 }
 export declare const DefaultValue: React.ForwardRefExoticComponent<Partial<Props> & React.RefAttributes<unknown>>;
 export {};

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

@@ -0,0 +1,32 @@
+/**
+ * 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 FieldAssignEditorProps {
+    t: (key: string) => string;
+    fieldOptions: Array<{
+        label: string;
+        value: string;
+    }>;
+    /** 赋值目标路径（例如 `title` / `user.name`） */
+    field?: string;
+    onFieldChange: (targetPath?: string) => void;
+    value: any;
+    onValueChange: (value: any) => void;
+    fieldLabel?: React.ReactNode;
+    valueLabel?: React.ReactNode;
+    showValueEditorWhenNoField?: boolean;
+}
+/**
+ * 通用“字段赋值”编辑器：
+ * - 选择字段
+ * - 编辑赋值（支持变量引用 + 常量）
+ *
+ * 可在“表单赋值配置”和“联动规则赋值动作”等场景复用。
+ */
+export declare const FieldAssignEditor: React.FC<FieldAssignEditorProps>;

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

@@ -0,0 +1,23 @@
+/**
+ * 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 { dayjs } from '@nocobase/utils/client';
+export type ExactDatePickerMode = 'year' | 'quarter' | 'month' | 'date';
+export type ExactDatePickerValue = dayjs.Dayjs | [dayjs.Dayjs, dayjs.Dayjs] | null;
+export interface FieldAssignExactDatePickerProps {
+    picker?: ExactDatePickerMode;
+    format?: string;
+    showTime?: boolean;
+    timeFormat?: string;
+    value?: unknown;
+    isRange?: boolean;
+    onChange?: (value: ExactDatePickerValue) => void;
+    style?: React.CSSProperties;
+}
+export declare const FieldAssignExactDatePicker: React.FC<FieldAssignExactDatePickerProps>;

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

@@ -0,0 +1,70 @@
+/**
+ * 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 { FilterGroupType } from '@nocobase/utils/client';
+import React from 'react';
+import { FieldAssignValueInput } from './FieldAssignValueInput';
+import type { FieldAssignCascaderOption } from './fieldAssignOptions';
+export type AssignMode = 'default' | 'assign';
+type CollectionFieldLike = {
+    name?: unknown;
+    title?: unknown;
+    type?: unknown;
+    interface?: unknown;
+    targetKey?: unknown;
+    targetCollectionTitleFieldName?: unknown;
+    targetCollection?: any;
+    isAssociationField?: () => boolean;
+};
+export type SyncAssociationTitleFieldParams = {
+    ruleItem: FieldAssignRuleItem;
+    ruleIndex: number;
+    targetPath?: string;
+    associationField: CollectionFieldLike;
+    targetCollection: any;
+    titleField: string;
+};
+export interface FieldAssignRuleItem {
+    key: string;
+    enable?: boolean;
+    /** 赋值目标路径，例如 `title` / `users.nickname` / `user.name` */
+    targetPath?: string;
+    /** 仅当前规则生效的 title field 覆盖（不改 collection 全局配置） */
+    valueTitleField?: string;
+    mode?: AssignMode;
+    condition?: FilterGroupType;
+    value?: any;
+}
+export interface FieldAssignRulesEditorProps {
+    t: (key: string) => string;
+    fieldOptions: FieldAssignCascaderOption[] | any[];
+    /** 根集合（用于构建“上级对象/属性”变量树） */
+    rootCollection?: any;
+    value?: FieldAssignRuleItem[];
+    onChange?: (value: FieldAssignRuleItem[]) => void;
+    /** 默认 mode（新建条目时使用） */
+    defaultMode?: AssignMode;
+    /** 固定 mode：用于“仅默认值/仅赋值”的场景 */
+    fixedMode?: AssignMode;
+    /** 是否显示 condition */
+    showCondition?: boolean;
+    /** 是否显示 enable 开关 */
+    showEnable?: boolean;
+    /** 未选字段时也展示 Value 编辑器（用于表单设置里的占位体验） */
+    showValueEditorWhenNoField?: boolean;
+    /** 为 Value 编辑器补充额外 props（例如按筛选操作符适配输入组件） */
+    getValueInputProps?: (item: FieldAssignRuleItem, index: number) => Partial<React.ComponentProps<typeof FieldAssignValueInput>>;
+    /** 可选：用于筛选关系集合中可作为 Title field 的候选字段 */
+    isTitleFieldCandidate?: (field: any, targetCollection: any) => boolean;
+    /** 可选：点击同步按钮后，将选中的 title field 持久化到关系集合 */
+    onSyncAssociationTitleField?: (params: SyncAssociationTitleFieldParams) => Promise<void> | void;
+    /** 在日期字段下启用“日期变量替换 Constant 位”。 */
+    enableDateVariableAsConstant?: boolean;
+}
+export declare const FieldAssignRulesEditor: React.FC<FieldAssignRulesEditorProps>;
+export {};

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

@@ -7,12 +7,53 @@
  * For more information, please refer to: https://www.nocobase.com/agreement.
  */
 import React from 'react';
+import { dayjs } from '@nocobase/utils/client';
+import { type MetaTreeNode } from '@nocobase/flow-engine';
+import { type ExactDatePickerMode } from './FieldAssignExactDatePicker';
+export type DateVariableExactNormalizeMode = 'none' | 'date' | 'datetimeNoTz' | 'iso';
+export declare function toExactPickerDisplayValue(rawValue: unknown, options: {
+    format: string;
+    isRange: boolean;
+}): dayjs.Dayjs | [dayjs.Dayjs, dayjs.Dayjs] | null;
+export declare function normalizeDateVariableExactValue(rawValue: any, options: {
+    exactNormalizeMode: DateVariableExactNormalizeMode;
+    format: string;
+    showTime: boolean;
+}): any;
+type DateVariableComponentProps = {
+    picker: ExactDatePickerMode;
+    showTime: boolean;
+    timeFormat: string;
+    format: string;
+    exactNormalizeMode: DateVariableExactNormalizeMode;
+};
+export declare function normalizeDateVariableOutput(rawValue: any, options: DateVariableComponentProps): any;
 interface Props {
-    fieldUid: string;
+    /** 赋值目标路径，例如 `title` / `users.nickname` / `user.name` */
+    targetPath: string;
     value: any;
     onChange: (value: any) => void;
     placeholder?: string;
+    /** 额外变量树（置于 Constant/Null/RunJS 与 base metaTree 之间） */
+    extraMetaTree?: MetaTreeNode[];
+    /** 可选：当前字段的筛选操作符，用于在默认值/赋值编辑器中按 operator schema 适配输入组件 */
+    operator?: string;
+    /** 可选：操作符元数据列表（通常来自 collectionField.filterable.operators） */
+    operatorMetaList?: Array<any>;
+    /** 可选：当字段已存在于表单时，优先复用表单字段的模型（用于筛选表单默认值等场景） */
+    preferFormItemFieldModel?: boolean;
+    /** 可选：关系字段显示映射覆盖（用于值编辑器内预览 title field） */
+    associationFieldNamesOverride?: {
+        label?: string;
+        value?: string;
+    };
+    /**
+     * 在日期字段场景下，用日期变量编辑器替换 Constant 位。
+     * 默认 false，保持历史行为。
+     */
+    enableDateVariableAsConstant?: boolean;
 }
+export declare function mergeItemMetaTreeForAssignValue(baseTree: MetaTreeNode[], extraTree: MetaTreeNode[]): MetaTreeNode[];
 /**
  * 根据所选字段渲染对应的赋值编辑器：
  * - 使用临时的 VariableFieldFormModel 包裹字段模型，确保常量编辑为真实字段组件

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

@@ -0,0 +1,19 @@
+/**
+ * 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 RunJSValue } from '@nocobase/flow-engine';
+export interface RunJSValueEditorProps {
+    t?: (key: string) => string;
+    value: unknown;
+    onChange?: (value: RunJSValue) => void;
+    height?: string;
+    scene?: string;
+    containerStyle?: React.CSSProperties;
+}
+export declare const RunJSValueEditor: React.FC<RunJSValueEditorProps>;

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

@@ -20,6 +20,7 @@ export interface TextAreaWithContextSelectorProps {
     onChange?: (v: string) => void;
     placeholder?: string;
     rows?: number;
+    maxRows?: number;
     style?: React.CSSProperties;
 }
 /**