@digitalsee-ai/rcs 0.0.14

package/dist/components/dynamic-form/types/validation.d.ts

@@ -0,0 +1,53 @@
+import { ConditionNode } from './form-schema';
+/** 基础校验规则 */
+export type ValidationRuleBase = {
+    message?: string;
+    warningOnly?: boolean;
+};
+/** 必填规则 */
+export type RequiredRule = ValidationRuleBase & {
+    type: 'required';
+};
+/** 类型校验 */
+export type TypeRule = ValidationRuleBase & {
+    type: 'type';
+    value: 'string' | 'number' | 'boolean' | 'email' | 'url' | 'integer' | 'float' | 'array' | 'object';
+};
+/** 最小值/最小长度 */
+export type MinRule = ValidationRuleBase & {
+    type: 'min';
+    value: number;
+};
+/** 最大值/最大长度 */
+export type MaxRule = ValidationRuleBase & {
+    type: 'max';
+    value: number;
+};
+/** 精确长度 */
+export type LenRule = ValidationRuleBase & {
+    type: 'len';
+    value: number;
+};
+/** 正则表达式 */
+export type PatternRule = ValidationRuleBase & {
+    type: 'pattern';
+    value: string;
+    flags?: string;
+};
+/** 枚举值 */
+export type EnumRule = ValidationRuleBase & {
+    type: 'enum';
+    value: (string | number | boolean)[];
+};
+/** 空白字符校验 */
+export type WhitespaceRule = ValidationRuleBase & {
+    type: 'whitespace';
+};
+/** 条件校验 - 复用 ConditionNode */
+export type WhenRule = {
+    type: 'when';
+    conditions: ConditionNode;
+    rules: ValidationRule[];
+};
+/** 所有校验规则联合类型 */
+export type ValidationRule = RequiredRule | TypeRule | MinRule | MaxRule | LenRule | PatternRule | EnumRule | WhitespaceRule | WhenRule;

package/dist/components/dynamic-form/utils/__tests__/path-get.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/components/dynamic-form/utils/conditions.d.ts

@@ -0,0 +1,4 @@
+import { ConditionNode } from '../types/form-schema';
+type ConditionData = Record<string, unknown>;
+export declare const evaluateCondition: (conditionObject: ConditionNode, conditionData: ConditionData) => boolean;
+export {};

package/dist/components/dynamic-form/utils/generateEvents.d.ts

@@ -0,0 +1,84 @@
+import { EventConfig } from '../types/events';
+import { FormSchema } from '../types/form-schema';
+/**
+ * 根据 FormSchema 自动生成事件配置
+ *
+ * 遍历所有字段，为有 optionsSource.deps 的字段自动生成 clearFields 事件
+ *
+ * @param schema - 表单 Schema
+ * @returns 自动生成的事件配置列表
+ *
+ * @example
+ * const schema = {
+ *   fields: [
+ *     { type: 'SELECT', name: 'department', options: [...] },
+ *     {
+ *       type: 'SELECT',
+ *       name: 'position',
+ *       optionsSource: {
+ *         kind: 'dynamic',
+ *         action: 'loadPositions',
+ *         deps: ['department']
+ *       }
+ *     },
+ *     {
+ *       type: 'SELECT',
+ *       name: 'employee',
+ *       optionsSource: {
+ *         kind: 'dynamic',
+ *         action: 'loadEmployees',
+ *         deps: ['department', 'position']
+ *       }
+ *     }
+ *   ]
+ * }
+ *
+ * const events = generateAutoEvents(schema)
+ * // 生成两个事件：
+ * // 1. department 变化 -> 清空 position
+ * // 2. department 或 position 变化 -> 清空 employee
+ */
+export declare function generateAutoEvents(schema: FormSchema): EventConfig[];
+/**
+ * 合并自动生成的事件和用户定义的事件
+ *
+ * @param schema - 表单 Schema
+ * @param userEvents - 用户定义的事件配置（可选）
+ * @param enableAutoEvents - 是否启用自动事件生成（默认 true）
+ * @returns 合并后的事件配置列表
+ *
+ * @example
+ * const schema = { fields: [...] }
+ * const userEvents = [
+ *   {
+ *     trigger: { type: 'fieldChange', field: 'userType' },
+ *     actions: [{ type: 'clearFields', targets: ['role'] }]
+ *   }
+ * ]
+ *
+ * const allEvents = mergeEvents(schema, userEvents)
+ * // 返回：自动生成的事件 + 用户定义的事件
+ */
+export declare function mergeEvents(schema: FormSchema, userEvents?: EventConfig[], enableAutoEvents?: boolean): EventConfig[];
+/**
+ * 检测事件配置中是否存在循环依赖
+ *
+ * @param events - 事件配置列表
+ * @returns 如果存在循环依赖，返回循环路径；否则返回 null
+ *
+ * @example
+ * const events = [
+ *   {
+ *     trigger: { type: 'fieldChange', field: 'a' },
+ *     actions: [{ type: 'setFieldValue', target: 'b', value: 1 }]
+ *   },
+ *   {
+ *     trigger: { type: 'fieldChange', field: 'b' },
+ *     actions: [{ type: 'setFieldValue', target: 'a', value: 2 }]
+ *   }
+ * ]
+ *
+ * const cycle = detectEventCycles(events)
+ * // 返回: ['a', 'b', 'a']
+ */
+export declare function detectEventCycles(events: EventConfig[]): string[] | null;

package/dist/components/dynamic-form/utils/path-get.d.ts

@@ -0,0 +1,21 @@
+/**
+ * 从对象中根据路径获取值
+ * 支持点号分隔 (user.name) 和数组索引 (items[0].id)
+ *
+ * @param obj - 源对象
+ * @param path - 路径字符串，支持格式：
+ *   - 'name' - 简单属性
+ *   - 'user.name' - 嵌套属性
+ *   - 'items[0]' - 数组索引
+ *   - 'items[0].id' - 数组元素的属性
+ *   - 'users[2].profile.name' - 复杂嵌套路径
+ *   - 'matrix[0][1]' - 嵌套数组
+ *
+ * @returns 路径对应的值，如果路径不存在则返回 undefined
+ *
+ * @example
+ * getByPath({ user: { name: 'John' } }, 'user.name') // 'John'
+ * getByPath({ items: [{ id: 1 }, { id: 2 }] }, 'items[0].id') // 1
+ * getByPath({ users: [{ profile: { name: 'Alice' } }] }, 'users[0].profile.name') // 'Alice'
+ */
+export declare function getByPath(obj: unknown, path: string): unknown;

package/dist/components/dynamic-form/utils/useDataLoader.d.ts

@@ -0,0 +1,47 @@
+import { UseDataLoaderOptions, UseDataLoaderResult } from '../types/data-loader';
+/**
+ * 通用数据加载 Hook
+ *
+ * 提供统一的数据加载机制，支持静态数据、动态数据、依赖追踪、缓存等功能
+ *
+ * @template T - 数据类型
+ * @param options - 加载选项
+ * @returns 加载结果
+ *
+ * @example
+ * // 基础用法 - 静态数据
+ * const { data, loading } = useDataLoader({
+ *   dataSource: {
+ *     kind: 'static',
+ *     data: [{ label: '选项1', value: '1' }]
+ *   },
+ *   values: formValues
+ * })
+ *
+ * @example
+ * // 动态数据 - 依赖追踪
+ * const { data, loading, error, reload } = useDataLoader({
+ *   dataSource: {
+ *     kind: 'dynamic',
+ *     action: 'loadUsers',
+ *     deps: ['department', 'role'],
+ *     params: { status: 'active' },
+ *     fallbackData: []
+ *   },
+ *   dataLoader: myDataLoader,
+ *   values: formValues
+ * })
+ *
+ * @example
+ * // 数据转换
+ * const { data } = useDataLoader({
+ *   dataSource: dynamicSource,
+ *   dataLoader: apiLoader,
+ *   values: formValues,
+ *   transform: (rawData) => rawData.map(item => ({
+ *     label: item.name,
+ *     value: item.id
+ *   }))
+ * })
+ */
+export declare function useDataLoader<T = unknown>(options: UseDataLoaderOptions<T>): UseDataLoaderResult<T>;

package/dist/components/dynamic-form/utils/validation.d.ts

@@ -0,0 +1,7 @@
+import { Rule } from 'antd/es/form';
+import { DynamicFormField } from '../types/form-schema';
+import { ValidationRule } from '../types/validation';
+/**
+ * 将 JSON 校验规则转换为 antd Form rules
+ */
+export declare function jsonRulesToAntdRules(jsonRules: ValidationRule[], values: Record<string, unknown>, fieldType?: DynamicFormField): Rule[];

package/dist/components/dynamic-form/utils/visible.d.ts

@@ -0,0 +1,7 @@
+import { ConditionNode, FieldDef, FormSchema, HideStrategy } from '../types/form-schema';
+type FieldValues = Record<string, unknown>;
+export declare function isFieldVisible(field: FieldDef, values: FieldValues): boolean;
+export declare function getHideStrategy(field: FieldDef): HideStrategy;
+export declare function resolveBool(v: boolean | ConditionNode | undefined, values: FieldValues, fallback?: boolean): boolean;
+export declare function pruneInvisible(schema: FormSchema, values: Record<string, unknown>, visibilityMap: Record<string, boolean>): Record<string, unknown>;
+export {};

package/dist/components/index.d.ts

@@ -0,0 +1,3 @@
+export * from './digitalsee';
+export * from './dynamic-form';
+export * from './ui';

package/dist/components/ui/index.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/index.d.ts

@@ -0,0 +1 @@
+export * from './components';