feat: formula evaluator v1.1

Author: fit2cloudwxx

frontend/packages/web/src/components/business/crm-formula-editor/config.ts

@@ -132,6 +132,9 @@ export const allFunctionSource: (FormCreateField & { isFunction: boolean })[] =
   },
 ];
 
+// 允许空值的函数
+export const AllowEmptyArgsFunctionList = ['NOW', 'TODAY'];
+
 export const FormulaErrorCode = {
   EMPTY_ARGS: 'EMPTY_ARGS', // 参数个数为空
   ARG_COUNT_ERROR: 'ARG_COUNT_ERROR', // 参数个数错误

frontend/packages/web/src/components/business/crm-formula-editor/diagnose/diagnoseArgs.ts

@@ -1,6 +1,6 @@
 import { useI18n } from '@lib/shared/hooks/useI18n';
 
-import { FormulaErrorCode } from '../config';
+import { AllowEmptyArgsFunctionList, FormulaErrorCode } from '../config';
 import { ASTNode, FormulaDiagnostic, FunctionNode, Token } from '../types';
 
 const { t } = useI18n();
@@ -22,7 +22,7 @@ export default function diagnoseArgs(fnNode: FunctionNode, args: ASTNode[], toke
   // 所有逗号 token
   const commaTokens = innerTokens.filter((item) => item.type === 'comma');
 
-  if (args?.length === 0) {
+  if (args?.length === 0 && !AllowEmptyArgsFunctionList.includes(fnNode.name)) {
     diagnostics.push({
       type: 'warning',
       functionName: fnNode.name,

frontend/packages/web/src/components/business/crm-formula-editor/diagnose/rules/and.rule.ts

@@ -0,0 +1,50 @@
+import { useI18n } from '@lib/shared/hooks/useI18n';
+
+import { FormulaErrorCode } from '../../config';
+import { FormulaDiagnostic, FormulaFunctionRule } from '../../types';
+import { isLogicalNode } from './rule-utils';
+
+const { t } = useI18n();
+
+export const AND_RULE: FormulaFunctionRule = {
+  name: 'AND',
+
+  diagnose({ fnNode, args }) {
+    const diagnostics: FormulaDiagnostic[] = [];
+
+    // 1. 至少一个参数
+    if (args.length < 1) {
+      diagnostics.push({
+        type: 'error',
+        code: FormulaErrorCode.ARG_COUNT_ERROR,
+        functionName: fnNode.name,
+        message: t('formulaEditor.diagnostics.argCountError'),
+        highlight: {
+          tokenRange: [fnNode.startTokenIndex, fnNode.endTokenIndex],
+        },
+      });
+      return diagnostics;
+    }
+
+    // 2. 所有参数必须为逻辑值
+    args.forEach((arg, index) => {
+      if (!isLogicalNode(arg)) {
+        diagnostics.push({
+          type: 'error',
+          code: FormulaErrorCode.INVALID_FUNCTION_CALL,
+          functionName: fnNode.name,
+          message: t('formulaEditor.diagnostics.invalidConditionTypeOfAND', {
+            index: index + 1,
+          }),
+          highlight: {
+            tokenRange: [arg.startTokenIndex, arg.endTokenIndex],
+          },
+        });
+      }
+    });
+
+    return diagnostics;
+  },
+};
+
+export default AND_RULE;

frontend/packages/web/src/components/business/crm-formula-editor/diagnose/rules/concatenate.rule.ts

@@ -1,11 +1,48 @@
+import { useI18n } from '@lib/shared/hooks/useI18n';
+
+import { FormulaErrorCode } from '../../config';
 import { FormulaDiagnostic, FormulaFunctionRule } from '../../types';
+import { isTextNumberDateNode } from './rule-utils';
+
+const { t } = useI18n();
 
-const CONCATENATE_RULE: FormulaFunctionRule = {
+export const CONCATENATE_RULE: FormulaFunctionRule = {
   name: 'CONCATENATE',
 
   diagnose({ fnNode, args }) {
     const diagnostics: FormulaDiagnostic[] = [];
-    // 后边CONCATENATE的其他规则可扩展在这里
+
+    // 1. 至少一个参数
+    if (args.length < 1) {
+      diagnostics.push({
+        type: 'error',
+        code: FormulaErrorCode.ARG_COUNT_ERROR,
+        functionName: fnNode.name,
+        message: t('formulaEditor.diagnostics.argCountError'),
+        highlight: {
+          tokenRange: [fnNode.startTokenIndex, fnNode.endTokenIndex],
+        },
+      });
+      return diagnostics;
+    }
+
+    // 2. 参数类型限制：文本、数字、日期
+    args.forEach((arg, index) => {
+      if (!isTextNumberDateNode(arg)) {
+        diagnostics.push({
+          type: 'error',
+          code: FormulaErrorCode.INVALID_FUNCTION_CALL,
+          functionName: fnNode.name,
+          message: t('formulaEditor.diagnostics.invalidArgTypeOfCONCATENATE', {
+            index: index + 1,
+          }),
+          highlight: {
+            tokenRange: [arg.startTokenIndex, arg.endTokenIndex],
+          },
+        });
+      }
+    });
+
     return diagnostics;
   },
 };

frontend/packages/web/src/components/business/crm-formula-editor/diagnose/rules/days.rule.ts

@@ -2,13 +2,10 @@ import { useI18n } from '@lib/shared/hooks/useI18n';
 
 import { FormulaErrorCode } from '../../config';
 import { ASTNode, FormulaDiagnostic, FormulaFunctionRule } from '../../types';
+import { isColumnField } from './rule-utils';
 
 const { t } = useI18n();
 
-function isColumnField(fieldId: string) {
-  return fieldId.includes('.');
-}
-
 export const DAYS_RULE: FormulaFunctionRule = {
   name: 'DAYS',
 

frontend/packages/web/src/components/business/crm-formula-editor/diagnose/rules/if.rule.ts

@@ -0,0 +1,30 @@
+import { useI18n } from '@lib/shared/hooks/useI18n';
+
+import { FormulaErrorCode } from '../../config';
+import { FormulaDiagnostic, FormulaFunctionRule } from '../../types';
+
+const { t } = useI18n();
+
+export const IF_RULE: FormulaFunctionRule = {
+  name: 'IF',
+
+  diagnose({ fnNode, args }) {
+    const diagnostics: FormulaDiagnostic[] = [];
+
+    if (args.length < 2 || args.length > 3) {
+      diagnostics.push({
+        type: 'error',
+        code: FormulaErrorCode.ARG_COUNT_ERROR,
+        functionName: fnNode.name,
+        message: t('formulaEditor.diagnostics.argCountErrorOfIF'),
+        highlight: {
+          tokenRange: [fnNode.startTokenIndex, fnNode.endTokenIndex],
+        },
+      });
+    }
+
+    return diagnostics;
+  },
+};
+
+export default IF_RULE;

frontend/packages/web/src/components/business/crm-formula-editor/diagnose/rules/ifs.rule.ts

@@ -0,0 +1,66 @@
+import { useI18n } from '@lib/shared/hooks/useI18n';
+
+import { FormulaErrorCode } from '../../config';
+import { FormulaDiagnostic, FormulaFunctionRule } from '../../types';
+import { isLogicalNode, isTextNumberDateNode } from './rule-utils';
+
+const { t } = useI18n();
+
+export const IFS_RULE: FormulaFunctionRule = {
+  name: 'IFS',
+
+  diagnose({ fnNode, args }) {
+    const diagnostics: FormulaDiagnostic[] = [];
+
+    // 1. 参数个数必须为偶数，且至少 2 个
+    if (args.length < 2 || args.length % 2 !== 0) {
+      diagnostics.push({
+        type: 'error',
+        code: FormulaErrorCode.ARG_COUNT_ERROR,
+        functionName: fnNode.name,
+        message: t('formulaEditor.diagnostics.argCountErrorOfIFS'),
+        highlight: {
+          tokenRange: [fnNode.startTokenIndex, fnNode.endTokenIndex],
+        },
+      });
+      return diagnostics;
+    }
+
+    // 2. 条件 - 结果 成对校验
+    args.forEach((arg, index) => {
+      const isCondition = index % 2 === 0;
+
+      if (isCondition) {
+        if (!isLogicalNode(arg)) {
+          diagnostics.push({
+            type: 'error',
+            code: FormulaErrorCode.INVALID_FUNCTION_CALL,
+            functionName: fnNode.name,
+            message: t('formulaEditor.diagnostics.invalidConditionTypeOfIFS', {
+              index: index + 1,
+            }),
+            highlight: {
+              tokenRange: [arg.startTokenIndex, arg.endTokenIndex],
+            },
+          });
+        }
+      } else if (!isTextNumberDateNode(arg)) {
+        diagnostics.push({
+          type: 'error',
+          code: FormulaErrorCode.INVALID_FUNCTION_CALL,
+          functionName: fnNode.name,
+          message: t('formulaEditor.diagnostics.invalidResultTypeOfIFS', {
+            index: index + 1,
+          }),
+          highlight: {
+            tokenRange: [arg.startTokenIndex, arg.endTokenIndex],
+          },
+        });
+      }
+    });
+
+    return diagnostics;
+  },
+};
+
+export default IFS_RULE;

frontend/packages/web/src/components/business/crm-formula-editor/diagnose/rules/index.ts

@@ -1,13 +1,25 @@
 // index.ts 诊断函数配置总入口
 import { FormulaFunctionRule } from '../../types';
+import AND from './and.rule';
 import CONCATENATE from './concatenate.rule';
 import DAYS from './days.rule';
+import IF from './if.rule';
+import IFS from './ifs.rule';
+import NOW from './now.rule';
 import SUM from './sum.rule';
+import TEXT from './text.rule';
+import TODAY from './today.rule';
 
 const FUNCTION_RULES: Record<string, FormulaFunctionRule> = {
   SUM,
   DAYS,
   CONCATENATE,
+  AND,
+  IF,
+  IFS,
+  NOW,
+  TEXT,
+  TODAY,
 };
 
 export default FUNCTION_RULES;

frontend/packages/web/src/components/business/crm-formula-editor/diagnose/rules/now.rule.ts

@@ -0,0 +1,32 @@
+import { useI18n } from '@lib/shared/hooks/useI18n';
+
+import { FormulaErrorCode } from '../../config';
+import { FormulaDiagnostic, FormulaFunctionRule } from '../../types';
+
+const { t } = useI18n();
+
+export const NOW_RULE: FormulaFunctionRule = {
+  name: 'NOW',
+
+  diagnose({ fnNode, args }) {
+    const diagnostics: FormulaDiagnostic[] = [];
+
+    if (args?.length !== 0) {
+      diagnostics.push({
+        type: 'error',
+        code: FormulaErrorCode.ARG_COUNT_ERROR,
+        functionName: fnNode.name,
+        message: t('formulaEditor.diagnostics.nowNotAcceptParams', {
+          name: fnNode.name,
+        }),
+        highlight: {
+          tokenRange: [fnNode.startTokenIndex, fnNode.endTokenIndex],
+        },
+      });
+    }
+
+    return diagnostics;
+  },
+};
+
+export default NOW_RULE;

frontend/packages/web/src/components/business/crm-formula-editor/diagnose/rules/rule-utils.ts

@@ -0,0 +1,48 @@
+import { FieldTypeEnum } from '@lib/shared/enums/formDesignEnum';
+
+import { ASTNode } from '../../types';
+
+export function isColumnField(fieldId: string) {
+  return fieldId.includes('.');
+}
+
+export function isLogicalNode(node: ASTNode): boolean {
+  if (!node) return false;
+
+  if (node.type === 'compare') return true;
+
+  if (node.type === 'literal' && node.valueType === 'boolean') return true;
+
+  if (node.type === 'function') {
+    return ['AND'].includes(node.name);
+  }
+
+  return false;
+}
+
+export function isTextNumberDateNode(node: ASTNode): boolean {
+  if (!node) return false;
+
+  if (node.type === 'literal') {
+    return ['string', 'number'].includes(node.valueType);
+  }
+
+  if (node.type === 'field') {
+    if (node.fieldType === FieldTypeEnum.DATE_TIME) return true;
+    if (node.fieldType === FieldTypeEnum.INPUT_NUMBER) return true;
+
+    // 其他字段类型按“文本”处理
+    return true;
+  }
+
+  if (node.type === 'function') {
+    // 当前版本这些函数返回文本 / 数字 / 日期
+    return ['TEXT', 'TODAY', 'NOW', 'SUM', 'DAYS', 'CONCATENATE'].includes(node.name);
+  }
+
+  return false;
+}
+
+export function isTextNumberDateOrLogicalNode(node: ASTNode): boolean {
+  return isTextNumberDateNode(node) || isLogicalNode(node);
+}