@digitalsee-ai/rcs 0.0.14

package/dist/components/dynamic-form/core/EventEngine.d.ts

@@ -0,0 +1,30 @@
+import { FormInstance } from 'antd';
+import { ActionContext, EventConfig, EventEngineConfig, EventEngineReturn } from '../types/events';
+import { OptionsLoader } from '../FieldRenderer';
+/**
+ * EventEngine Hook
+ * 负责事件触发、条件判断和动作执行
+ * 使用发布-订阅模式，通过主动调用 triggerFieldChange 触发事件，而非被动监听值变化
+ */
+export declare function useEventEngine(config: EventEngineConfig & {
+    form: FormInstance;
+    optionsLoader?: OptionsLoader;
+    customHandlers?: Record<string, (context: ActionContext, params?: Record<string, unknown>) => void | Promise<void>>;
+}): EventEngineReturn;
+/**
+ * EventEngine 属性
+ */
+export interface EventEngineProps {
+    events: EventConfig[];
+    form: FormInstance;
+    optionsLoader?: OptionsLoader;
+    customHandlers?: Record<string, (context: ActionContext, params?: Record<string, unknown>) => void | Promise<void>>;
+    maxExecutionDepth?: number;
+    debug?: boolean;
+    children?: React.ReactNode;
+}
+/**
+ * EventEngine 组件
+ * 可以作为独立组件使用，也可以通过 useEventEngine Hook 使用
+ */
+export declare function EventEngine(props: EventEngineProps): import("react/jsx-runtime").JSX.Element;

package/dist/components/dynamic-form/fields/base/NumberField.d.ts

@@ -0,0 +1 @@
+export declare const NumberField: import('../../types/field-component').FieldComponentDefinition<import('../../types/form-schema').FieldDef>;

package/dist/components/dynamic-form/fields/base/PasswordField.d.ts

@@ -0,0 +1 @@
+export declare const PasswordField: import('../../types/field-component').FieldComponentDefinition<import('../../types/form-schema').FieldDef>;

package/dist/components/dynamic-form/fields/base/TextField.d.ts

@@ -0,0 +1 @@
+export declare const TextField: import('../../types/field-component').FieldComponentDefinition<import('../../types/form-schema').FieldDef>;

package/dist/components/dynamic-form/fields/base/TextareaField.d.ts

@@ -0,0 +1 @@
+export declare const TextareaField: import('../../types/field-component').FieldComponentDefinition<import('../../types/form-schema').FieldDef>;

package/dist/components/dynamic-form/fields/base/index.d.ts

@@ -0,0 +1,4 @@
+export { NumberField } from './NumberField';
+export { PasswordField } from './PasswordField';
+export { TextareaField } from './TextareaField';
+export { TextField } from './TextField';

package/dist/components/dynamic-form/fields/complex/ArrayField.d.ts

@@ -0,0 +1 @@
+export declare const ArrayField: import('../../types/field-component').FieldComponentDefinition<import('../../types/form-schema').FieldDef>;

package/dist/components/dynamic-form/fields/complex/ArrayObjectField.d.ts

@@ -0,0 +1 @@
+export declare const ArrayObjectField: import('../../types/field-component').FieldComponentDefinition<import('../../types/form-schema').FieldDef>;

package/dist/components/dynamic-form/fields/complex/KeyValueField.d.ts

@@ -0,0 +1 @@
+export declare const KeyValueField: import('../../types/field-component').FieldComponentDefinition<import('../../types/form-schema').FieldDef>;

package/dist/components/dynamic-form/fields/complex/ObjectField.d.ts

@@ -0,0 +1 @@
+export declare const ObjectField: import('../../types/field-component').FieldComponentDefinition<import('../../types/form-schema').FieldDef>;

package/dist/components/dynamic-form/fields/complex/index.d.ts

@@ -0,0 +1,4 @@
+export { ArrayField } from './ArrayField';
+export { ArrayObjectField } from './ArrayObjectField';
+export { KeyValueField } from './KeyValueField';
+export { ObjectField } from './ObjectField';

package/dist/components/dynamic-form/fields/datetime/DateField.d.ts

@@ -0,0 +1 @@
+export declare const DateField: import('../../types/field-component').FieldComponentDefinition<import('../../types/form-schema').FieldDef>;

package/dist/components/dynamic-form/fields/datetime/DateRangeField.d.ts

@@ -0,0 +1 @@
+export declare const DateRangeField: import('../../types/field-component').FieldComponentDefinition<import('../../types/form-schema').FieldDef>;

package/dist/components/dynamic-form/fields/datetime/DateTimeField.d.ts

@@ -0,0 +1 @@
+export declare const DateTimeField: import('../../types/field-component').FieldComponentDefinition<import('../../types/form-schema').FieldDef>;

package/dist/components/dynamic-form/fields/datetime/TimeField.d.ts

@@ -0,0 +1 @@
+export declare const TimeField: import('../../types/field-component').FieldComponentDefinition<import('../../types/form-schema').FieldDef>;

package/dist/components/dynamic-form/fields/datetime/TimeRangeField.d.ts

@@ -0,0 +1 @@
+export declare const TimeRangeField: import('../../types/field-component').FieldComponentDefinition<import('../../types/form-schema').FieldDef>;

package/dist/components/dynamic-form/fields/datetime/index.d.ts

@@ -0,0 +1,5 @@
+export { DateField } from './DateField';
+export { DateRangeField } from './DateRangeField';
+export { DateTimeField } from './DateTimeField';
+export { TimeField } from './TimeField';
+export { TimeRangeField } from './TimeRangeField';

package/dist/components/dynamic-form/fields/display/DividerField.d.ts

@@ -0,0 +1 @@
+export declare const DividerField: import('../../types/field-component').FieldComponentDefinition<import('../../types/form-schema').FieldDef>;

package/dist/components/dynamic-form/fields/display/HiddenField.d.ts

@@ -0,0 +1 @@
+export declare const HiddenField: import('../../types/field-component').FieldComponentDefinition<import('../../types/form-schema').FieldDef>;

package/dist/components/dynamic-form/fields/display/InfoCardField.d.ts

@@ -0,0 +1 @@
+export declare const InfoCardField: import('../../types/field-component').FieldComponentDefinition<import('../../types/form-schema').FieldDef>;

package/dist/components/dynamic-form/fields/display/JsonField.d.ts

@@ -0,0 +1 @@
+export declare const JsonField: import('../../types/field-component').FieldComponentDefinition<import('../../types/form-schema').FieldDef>;

package/dist/components/dynamic-form/fields/display/LabelField.d.ts

@@ -0,0 +1 @@
+export declare const LabelField: import('../../types/field-component').FieldComponentDefinition<import('../../types/form-schema').FieldDef>;

package/dist/components/dynamic-form/fields/display/index.d.ts

@@ -0,0 +1,5 @@
+export { DividerField } from './DividerField';
+export { HiddenField } from './HiddenField';
+export { InfoCardField } from './InfoCardField';
+export { JsonField } from './JsonField';
+export { LabelField } from './LabelField';

package/dist/components/dynamic-form/fields/select/CascaderField.d.ts

@@ -0,0 +1 @@
+export declare const CascaderField: import('../../types/field-component').FieldComponentDefinition<import('../../types/form-schema').FieldDef>;

package/dist/components/dynamic-form/fields/select/CheckboxField.d.ts

@@ -0,0 +1 @@
+export declare const CheckboxField: import('../../types/field-component').FieldComponentDefinition<import('../../types/form-schema').FieldDef>;

package/dist/components/dynamic-form/fields/select/CheckboxGroupField.d.ts

@@ -0,0 +1 @@
+export declare const CheckboxGroupField: import('../../types/field-component').FieldComponentDefinition<import('../../types/form-schema').FieldDef>;

package/dist/components/dynamic-form/fields/select/RadioField.d.ts

@@ -0,0 +1 @@
+export declare const RadioField: import('../../types/field-component').FieldComponentDefinition<import('../../types/form-schema').FieldDef>;

package/dist/components/dynamic-form/fields/select/SelectField.d.ts

@@ -0,0 +1 @@
+export declare const SelectField: import('../../types/field-component').FieldComponentDefinition<import('../../types/form-schema').FieldDef>;

package/dist/components/dynamic-form/fields/select/SwitchField.d.ts

@@ -0,0 +1 @@
+export declare const SwitchField: import('../../types/field-component').FieldComponentDefinition<import('../../types/form-schema').FieldDef>;

package/dist/components/dynamic-form/fields/select/TreeSelectField.d.ts

@@ -0,0 +1 @@
+export declare const TreeSelectField: import('../../types/field-component').FieldComponentDefinition<import('../../types/form-schema').FieldDef>;

package/dist/components/dynamic-form/fields/select/index.d.ts

@@ -0,0 +1,7 @@
+export { CascaderField } from './CascaderField';
+export { CheckboxField } from './CheckboxField';
+export { CheckboxGroupField } from './CheckboxGroupField';
+export { RadioField } from './RadioField';
+export { SelectField } from './SelectField';
+export { SwitchField } from './SwitchField';
+export { TreeSelectField } from './TreeSelectField';

package/dist/components/dynamic-form/fields/special/AutoCompleteField.d.ts

@@ -0,0 +1 @@
+export declare const AutoCompleteField: import('../../types/field-component').FieldComponentDefinition<import('../../types/form-schema').FieldDef>;

package/dist/components/dynamic-form/fields/special/ColorPickerField.d.ts

@@ -0,0 +1 @@
+export declare const ColorPickerField: import('../../types/field-component').FieldComponentDefinition<import('../../types/form-schema').FieldDef>;

package/dist/components/dynamic-form/fields/special/MentionsField.d.ts

@@ -0,0 +1 @@
+export declare const MentionsField: import('../../types/field-component').FieldComponentDefinition<import('../../types/form-schema').FieldDef>;

package/dist/components/dynamic-form/fields/special/RateField.d.ts

@@ -0,0 +1 @@
+export declare const RateField: import('../../types/field-component').FieldComponentDefinition<import('../../types/form-schema').FieldDef>;

package/dist/components/dynamic-form/fields/special/SliderField.d.ts

@@ -0,0 +1 @@
+export declare const SliderField: import('../../types/field-component').FieldComponentDefinition<import('../../types/form-schema').FieldDef>;

package/dist/components/dynamic-form/fields/special/UploadField.d.ts

@@ -0,0 +1 @@
+export declare const UploadField: import('../../types/field-component').FieldComponentDefinition<import('../../types/form-schema').FieldDef>;

package/dist/components/dynamic-form/fields/special/index.d.ts

@@ -0,0 +1,6 @@
+export { AutoCompleteField } from './AutoCompleteField';
+export { ColorPickerField } from './ColorPickerField';
+export { MentionsField } from './MentionsField';
+export { RateField } from './RateField';
+export { SliderField } from './SliderField';
+export { UploadField } from './UploadField';

package/dist/components/dynamic-form/index.d.ts

@@ -0,0 +1,21 @@
+export * from './AntdProvider';
+export { AI_FILL_VALUE, AIFieldWrapper, type AIFieldWrapperProps } from './components/AIFieldWrapper';
+export { type SelectValueMode, SelectWithExpression, type SelectWithExpressionProps, } from './components/SelectWithExpression';
+export { type ValueMode, ValueModeWrapper, type ValueModeWrapperProps } from './components/ValueModeWrapper';
+export { VariableInput, type VariableInputProps } from './components/VariableInput';
+export { VariableTextarea, type VariableTextareaProps } from './components/VariableTextarea';
+export { useRegisterVariableField, useVariableSelector, useVariableSelectorOptional, type VariableInfo, type VariableSelectorContextValue, VariableSelectorProvider, type VariableSelectorProviderProps, } from './context/VariableSelectorContext';
+export * from './DynamicForm';
+export * from './DynamicFormContext';
+export * from './FieldRenderer';
+export { registerBuiltinFields } from './fields';
+export { createFieldComponent, createSimpleFieldComponent } from './registry/createFieldComponent';
+export { createFieldRegistry, defaultFieldRegistry } from './registry/FieldRegistry';
+export { type AdditionalRegistration, FieldRegistryProvider, type FieldRegistryProviderProps, useFieldRegistry, } from './registry/FieldRegistryContext';
+export * from './types';
+export type { DataLoader, DataLoaderContext, DataLoaderRegistry, DataSource, DynamicDataSource, StaticDataSource, UseDataLoaderOptions, UseDataLoaderResult, } from './types/data-loader';
+export type { FieldComponentDefinition, FieldComponentMeta, FieldComponentProps, FieldRenderContext, IFieldRegistry, RegisterFieldOptions, } from './types/field-component';
+export { evaluateCondition } from './utils/conditions';
+export { useDataLoader } from './utils/useDataLoader';
+export { jsonRulesToAntdRules } from './utils/validation';
+export { isFieldVisible, resolveBool } from './utils/visible';

package/dist/components/dynamic-form/registry/FieldRegistry.d.ts

@@ -0,0 +1,26 @@
+import { FieldComponentDefinition, IFieldRegistry, RegisterFieldOptions } from '../types/field-component';
+import { DynamicFormField } from '../types/form-schema';
+/**
+ * 字段组件注册表实现
+ * 使用 Map 管理字段类型到组件定义的映射
+ */
+declare class FieldRegistry implements IFieldRegistry {
+    private registry;
+    register(type: DynamicFormField | string, definition: FieldComponentDefinition, options?: RegisterFieldOptions): void;
+    unregister(type: DynamicFormField | string): void;
+    get(type: DynamicFormField | string): FieldComponentDefinition | undefined;
+    has(type: DynamicFormField | string): boolean;
+    getRegisteredTypes(): Array<DynamicFormField | string>;
+    clone(): IFieldRegistry;
+}
+/**
+ * 默认全局注册表实例
+ * 内置字段组件会注册到这个实例
+ */
+export declare const defaultFieldRegistry: FieldRegistry;
+/**
+ * 创建新的注册表实例
+ * 用于创建隔离的作用域注册表
+ */
+export declare function createFieldRegistry(): IFieldRegistry;
+export {};

package/dist/components/dynamic-form/registry/FieldRegistryContext.d.ts

@@ -0,0 +1,53 @@
+import { FieldComponentDefinition, IFieldRegistry } from '../types/field-component';
+import type * as React from 'react';
+/**
+ * 额外注册项配置
+ */
+export interface AdditionalRegistration {
+    type: string;
+    definition: FieldComponentDefinition;
+}
+/**
+ * FieldRegistryProvider Props
+ */
+export interface FieldRegistryProviderProps {
+    /**
+     * 自定义注册表实例
+     * 如果不提供，则基于默认注册表创建副本
+     */
+    registry?: IFieldRegistry;
+    /**
+     * 在基础注册表上追加的注册项
+     * 这些注册项会覆盖同类型的已有注册
+     */
+    additionalRegistrations?: AdditionalRegistration[];
+    children: React.ReactNode;
+}
+/**
+ * 字段注册表 Provider
+ * 用于在特定作用域内提供自定义的字段注册表
+ *
+ * @example
+ * // 覆盖特定字段类型
+ * <FieldRegistryProvider
+ *   additionalRegistrations={[
+ *     { type: 'TEXT', definition: CustomTextField }
+ *   ]}
+ * >
+ *   <DynamicForm schema={schema} />
+ * </FieldRegistryProvider>
+ *
+ * @example
+ * // 使用完全自定义的注册表
+ * const customRegistry = createFieldRegistry()
+ * customRegistry.register('MY_FIELD', myFieldDefinition)
+ *
+ * <FieldRegistryProvider registry={customRegistry}>
+ *   <DynamicForm schema={schema} />
+ * </FieldRegistryProvider>
+ */
+export declare const FieldRegistryProvider: React.FC<FieldRegistryProviderProps>;
+/**
+ * 获取当前上下文中的字段注册表
+ */
+export declare const useFieldRegistry: () => IFieldRegistry;

package/dist/components/dynamic-form/registry/createFieldComponent.d.ts

@@ -0,0 +1,56 @@
+import { FieldComponentDefinition, FieldComponentMeta, FieldComponentProps } from '../types/field-component';
+import { FieldDef } from '../types/form-schema';
+import type * as React from 'react';
+/**
+ * 创建标准字段组件定义
+ *
+ * 这是一个工厂函数，用于将原始组件包装为标准的字段组件定义。
+ * 它会根据组件的元数据自动处理 variableInsert 和 aiFillable 的包装逻辑。
+ *
+ * @param Component - 原始字段组件
+ * @param meta - 组件元数据
+ * @returns 字段组件定义
+ *
+ * @example
+ * const TextFieldControl: React.FC<FieldComponentProps> = ({ field, disabled, readOnly }) => {
+ *   return <Input disabled={disabled} readOnly={readOnly} placeholder={field.placeholder} />
+ * }
+ *
+ * export const TextField = createFieldComponent(TextFieldControl, {
+ *   supportsVariableInsert: false, // 由 HOC 处理 variableInsert
+ * })
+ *
+ * @example
+ * // 组件内部已处理 variableInsert
+ * const TextFieldControl: React.FC<FieldComponentProps> = ({ field, disabled, readOnly, context }) => {
+ *   if (field.variableInsert) {
+ *     return (
+ *       <ValueModeWrapper validateVariable={context.validateVariable} ...>
+ *         <Input />
+ *       </ValueModeWrapper>
+ *     )
+ *   }
+ *   return <Input />
+ * }
+ *
+ * export const TextField = createFieldComponent(TextFieldControl, {
+ *   supportsVariableInsert: true, // 标记组件已内部处理，HOC 不会再包装
+ * })
+ */
+export declare function createFieldComponent<T extends FieldDef = FieldDef>(Component: React.ComponentType<FieldComponentProps<T>>, meta?: FieldComponentMeta): FieldComponentDefinition;
+/**
+ * 创建简单字段组件定义（不需要 HOC 包装）
+ *
+ * 用于已经完整实现所有功能的组件，或者不需要任何包装的展示类组件
+ *
+ * @param Component - 完整实现的字段组件
+ * @param meta - 组件元数据
+ * @returns 字段组件定义
+ *
+ * @example
+ * export const DividerField = createSimpleFieldComponent(DividerControl, {
+ *   isDisplayOnly: true,
+ *   needsFormItemName: false,
+ * })
+ */
+export declare function createSimpleFieldComponent<T extends FieldDef = FieldDef>(Component: React.ComponentType<FieldComponentProps<T>>, meta?: FieldComponentMeta): FieldComponentDefinition;

package/dist/components/dynamic-form/registry/index.d.ts

@@ -0,0 +1,3 @@
+export { createFieldComponent, createSimpleFieldComponent } from './createFieldComponent';
+export { createFieldRegistry, defaultFieldRegistry } from './FieldRegistry';
+export { type AdditionalRegistration, FieldRegistryProvider, type FieldRegistryProviderProps, useFieldRegistry, } from './FieldRegistryContext';

package/dist/components/dynamic-form/types/data-loader.d.ts

@@ -0,0 +1,144 @@
+/**
+ * 动态数据加载器类型定义
+ *
+ * 这个模块提供了通用的动态数据加载机制，可用于任何需要异步加载数据的字段组件
+ */
+/**
+ * 数据源配置 - 静态数据
+ */
+export interface StaticDataSource<T = unknown> {
+    kind: 'static';
+    /** 静态数据 */
+    data: T;
+}
+/**
+ * 数据源配置 - 动态数据
+ */
+export interface DynamicDataSource<T = unknown> {
+    kind: 'dynamic' | 'async';
+    /** 依赖的表单字段路径列表 */
+    deps?: string[];
+    /** 加载动作标识（用于区分不同的加载逻辑） */
+    action: string;
+    /** 额外参数 */
+    params?: Record<string, unknown>;
+    /** 加载失败时的降级数据 */
+    fallbackData?: T;
+    /** 是否启用缓存 */
+    cache?: boolean;
+    /** 缓存键（默认使用 action + deps 生成） */
+    cacheKey?: string;
+    /** 缓存过期时间（毫秒） */
+    cacheTTL?: number;
+}
+/**
+ * 数据源配置联合类型
+ */
+export type DataSource<T = unknown> = StaticDataSource<T> | DynamicDataSource<T>;
+/**
+ * 数据加载器上下文
+ */
+export interface DataLoaderContext {
+    /** 表单当前所有值 */
+    values: Record<string, unknown>;
+    /** 节点 ID（workflow 场景） */
+    nodeId?: string;
+    /** 额外的上下文信息 */
+    extra?: Record<string, unknown>;
+}
+/**
+ * 数据加载器函数类型
+ *
+ * @template T - 返回的数据类型
+ * @param action - 加载动作标识
+ * @param params - 加载参数
+ * @param context - 加载上下文
+ * @returns Promise<T> - 加载的数据
+ *
+ * @example
+ * // 加载用户列表
+ * const userLoader: DataLoader<User[]> = async (action, params, ctx) => {
+ *   if (action === 'loadUsers') {
+ *     const response = await fetch('/api/users', {
+ *       method: 'POST',
+ *       body: JSON.stringify(params)
+ *     })
+ *     return response.json()
+ *   }
+ *   return []
+ * }
+ *
+ * @example
+ * // 加载选项数据
+ * const optionsLoader: DataLoader<Option[]> = async (action, params, ctx) => {
+ *   if (action === 'loadOptions') {
+ *     return [
+ *       { label: '选项1', value: '1' },
+ *       { label: '选项2', value: '2' },
+ *     ]
+ *   }
+ *   return []
+ * }
+ */
+export type DataLoader<T = unknown> = (action: string, params: Record<string, unknown>, context: DataLoaderContext) => Promise<T>;
+/**
+ * 数据加载器注册表
+ * 用于注册多个数据加载器
+ */
+export interface DataLoaderRegistry {
+    /**
+     * 注册数据加载器
+     * @param name - 加载器名称
+     * @param loader - 加载器函数
+     */
+    register<T = unknown>(name: string, loader: DataLoader<T>): void;
+    /**
+     * 获取数据加载器
+     * @param name - 加载器名称
+     */
+    get<T = unknown>(name: string): DataLoader<T> | undefined;
+    /**
+     * 注销数据加载器
+     * @param name - 加载器名称
+     */
+    unregister(name: string): void;
+    /**
+     * 检查加载器是否已注册
+     * @param name - 加载器名称
+     */
+    has(name: string): boolean;
+}
+/**
+ * 数据加载钩子返回值
+ */
+export interface UseDataLoaderResult<T> {
+    /** 加载的数据 */
+    data: T | undefined;
+    /** 是否正在加载 */
+    loading: boolean;
+    /** 加载错误 */
+    error: Error | undefined;
+    /** 重新加载 */
+    reload: () => void;
+    /** 手动设置数据 */
+    setData: (data: T) => void;
+}
+/**
+ * 数据加载钩子选项
+ */
+export interface UseDataLoaderOptions<T> {
+    /** 数据源配置 */
+    dataSource?: DataSource<T>;
+    /** 数据加载器 */
+    dataLoader?: DataLoader<T>;
+    /** 表单当前值 */
+    values: Record<string, unknown>;
+    /** 初始数据 */
+    initialData?: T;
+    /** 是否立即加载（默认 true） */
+    immediate?: boolean;
+    /** 加载上下文 */
+    context?: Partial<DataLoaderContext>;
+    /** 数据转换函数 */
+    transform?: (data: unknown) => T;
+}