@bpmnkit/ feel (英语)

感觉(亲切的表达语言) 解析器、评估器、事件和亮点——94% DMN TCK 兼容性

网站 • 妇女 文档 • 妇女 GitHub 图像 • 妇女 更改日志

核心层. Semver at 1.0:没有大放送,没有突破. 见 产品级。 。 。 .

概览

@bpmnkit/feel 执行 DMN 决策表和 BPMN 条件表达式中使用的感受表达式语言,并通过 2 053 个感受中1 941个 DMN TCK 电话 (94.5%)——其余病例及其原因列于 tests/tck.test.ts它执行 Camunda 8 的扩展,也用于感觉,并匹配 Camunda 感知文件中378个可重复的例子中的375个(tests/camunda-parity.test.ts) (中文(简体) ). 它包括一个活化剂,递归-后世解析器,AST评价器,formatter,和语法亮点.

特征

• 完全感觉语法 ——算术,比较,逻辑,函数调用,路径,过滤器
• 时间类型 ——日期,时间,日期,期限(ISO 8601,全谱遵守)
• 一次性测试 —— DMN 输入表达式语法 (> 5, (中文(简体) ), "gold", "silver", (中文(简体) ), [1..10](中文(简体) )
• 内设职能 101感函数(字符串、列表、数字、日期、上下文、范围),包括 Camunda 扩展(assert, (中文(简体) ), partition, (中文(简体) ), to json, (中文(简体) ), fromAi, (...) (中文(简体) )
• 区域表达式 —— 说 [1..10], (中文(简体) ), (0..1), (中文(简体) ), [today..end]
• 上下文文字 —— 说 { key: value, nested: { x: 1 } }
• 语法突出显示 ——编辑语义符号分类
• 零依赖关系

安装

npm install @bpmnkit/feel

快速启动

评估表达式

import { parseExpression, evaluate } from "@bpmnkit/feel"

const parsed = parseExpression("amount * 1.2 + fee")
if (!parsed.errors.length) {
  // `evaluate` takes an EvalContext — variables live under `vars`.
  const result = evaluate(parsed.ast!, { vars: { amount: 100, fee: 5 } })
  console.log(result) // 125
}

评估无效测试( DMN 输入表达式)

import { parseUnaryTests, evaluateUnaryTests } from "@bpmnkit/feel"

// Does input value match any listed condition?
const parsed = parseUnaryTests('"gold","silver"')
const matches = evaluateUnaryTests(parsed.ast!, "gold", { vars: {} })
console.log(matches) // true

语法突出显示

import { annotate, highlightToHtml } from "@bpmnkit/feel"

// Classified tokens, for an editor to style itself.
annotate("x > 1")[0] // { kind: "variable", value: "x", start: 0, end: 1 }

// Or the same tokens already wrapped in <span class="feel-…"> elements.
highlightToHtml('if x > 10 then "high" else "low"')

API 参考

解析结果

interface ParseResult {
  ast: FeelNode | null
  errors: ParseError[]   // { message, start, end }
}

相关软件包

许可证

麻省理工学院 BPMN Kit—— 制片人: u11g (单位:千克)