@bpmnkit/feel 0.0.8

package/README.md

@@ -0,0 +1,112 @@
+<div align="center">
+  <img src="https://raw.githubusercontent.com/bpmn-sdk/monorepo/main/doc/logos/logo-2-gateway.svg" width="72" height="72" alt="BPMN Kit logo">
+  <h1>@bpmnkit/feel</h1>
+  <p>Complete FEEL (Friendly Enough Expression Language) implementation — parser, evaluator, and highlighter</p>
+
+  [![npm](https://img.shields.io/npm/v/@bpmnkit/feel?style=flat-square&color=6244d7)](https://www.npmjs.com/package/@bpmnkit/feel)
+  [![license](https://img.shields.io/npm/l/@bpmnkit/feel?style=flat-square)](https://github.com/bpmnkit/monorepo/blob/main/LICENSE)
+  [![typescript](https://img.shields.io/badge/TypeScript-strict-6244d7?style=flat-square&logo=typescript&logoColor=white)](https://github.com/bpmnkit/monorepo)
+
+  [Documentation](https://bpmn-sdk-docs.pages.dev) · [GitHub](https://github.com/bpmnkit/monorepo) · [Changelog](https://github.com/bpmnkit/monorepo/blob/main/packages/feel/CHANGELOG.md)
+</div>
+
+---
+
+## Overview
+
+`@bpmnkit/feel` is a complete implementation of the FEEL expression language used in DMN decision tables and BPMN condition expressions. It includes a tokenizer, recursive-descent parser, AST evaluator, formatter, and syntax highlighter.
+
+## Features
+
+- **Full FEEL grammar** — arithmetic, comparisons, logic, function calls, paths, filters
+- **Temporal types** — date, time, datetime, duration (ISO 8601, full spec compliance)
+- **Unary tests** — DMN input expression syntax (`> 5`, `"gold", "silver"`, `[1..10]`)
+- **Built-in functions** — 50+ standard FEEL functions (string, list, numeric, date, context)
+- **Range expressions** — `[1..10]`, `(0..1)`, `[today..end]`
+- **Context literals** — `{ key: value, nested: { x: 1 } }`
+- **Syntax highlighting** — semantic token classification for editors
+- **Zero dependencies**
+
+## Installation
+
+```sh
+npm install @bpmnkit/feel
+```
+
+## Quick Start
+
+### Evaluate an expression
+
+```typescript
+import { parseExpression, evaluate } from "@bpmnkit/feel"
+
+const parsed = parseExpression("amount * 1.2 + fee")
+if (!parsed.errors.length) {
+  const result = evaluate(parsed.ast!, { amount: 100, fee: 5 })
+  console.log(result) // 125
+}
+```
+
+### Evaluate unary tests (DMN input expressions)
+
+```typescript
+import { parseUnaryTests, evaluateUnaryTests } from "@bpmnkit/feel"
+
+// Does input value match any listed condition?
+const parsed = parseUnaryTests('"gold","silver"')
+const matches = evaluateUnaryTests(parsed.ast!, "gold", { /* context */ })
+console.log(matches) // true
+```
+
+### Syntax highlighting
+
+```typescript
+import { highlightFeel } from "@bpmnkit/feel"
+
+const tokens = highlightFeel('if x > 10 then "high" else "low"')
+for (const token of tokens) {
+  console.log(token.type, token.value) // keyword, number, string, ...
+}
+```
+
+## API Reference
+
+| Export | Description |
+|--------|-------------|
+| `parseExpression(src)` | Parse a FEEL expression → `ParseResult` |
+| `parseUnaryTests(src)` | Parse unary tests → `ParseResult` |
+| `evaluate(ast, ctx)` | Evaluate a parsed expression |
+| `evaluateUnaryTests(ast, input, ctx)` | Test input against unary tests |
+| `formatFeel(src)` | Pretty-print a FEEL expression |
+| `highlightFeel(src)` | Tokenize with semantic types for highlighting |
+| `tokenize(src)` | Raw token stream |
+| `annotate(src)` | Full AST with position metadata |
+
+### ParseResult
+
+```typescript
+interface ParseResult {
+  ast: FeelNode | null
+  errors: ParseError[]   // { message, position }
+}
+```
+
+---
+
+## Related Packages
+
+| Package | Description |
+|---------|-------------|
+| [`@bpmnkit/core`](https://www.npmjs.com/package/@bpmnkit/core) | BPMN/DMN/Form parser, builder, layout engine |
+| [`@bpmnkit/canvas`](https://www.npmjs.com/package/@bpmnkit/canvas) | Zero-dependency SVG BPMN viewer |
+| [`@bpmnkit/editor`](https://www.npmjs.com/package/@bpmnkit/editor) | Full-featured interactive BPMN editor |
+| [`@bpmnkit/engine`](https://www.npmjs.com/package/@bpmnkit/engine) | Lightweight BPMN process execution engine |
+| [`@bpmnkit/plugins`](https://www.npmjs.com/package/@bpmnkit/plugins) | 22 composable canvas plugins |
+| [`@bpmnkit/api`](https://www.npmjs.com/package/@bpmnkit/api) | Camunda 8 REST API TypeScript client |
+| [`@bpmnkit/ascii`](https://www.npmjs.com/package/@bpmnkit/ascii) | Render BPMN diagrams as Unicode ASCII art |
+| [`@bpmnkit/profiles`](https://www.npmjs.com/package/@bpmnkit/profiles) | Shared auth, profile storage, and client factories for CLI & proxy |
+| [`@bpmnkit/operate`](https://www.npmjs.com/package/@bpmnkit/operate) | Monitoring & operations frontend for Camunda clusters |
+
+## License
+
+[MIT](https://github.com/bpmnkit/monorepo/blob/main/LICENSE) © bpmn-sdk

package/dist/ast.d.ts

@@ -0,0 +1,111 @@
+export type BinaryOp = "+" | "-" | "*" | "/" | "**" | "=" | "!=" | "<" | "<=" | ">" | ">=" | "and" | "or";
+export type FeelNode = {
+    start: number;
+    end: number;
+} & FeelNodeKind;
+type FeelNodeKind = {
+    kind: "number";
+    value: number;
+} | {
+    kind: "string";
+    value: string;
+} | {
+    kind: "boolean";
+    value: boolean;
+} | {
+    kind: "null";
+} | {
+    kind: "temporal";
+    raw: string;
+} | {
+    kind: "name";
+    name: string;
+} | {
+    kind: "list";
+    items: FeelNode[];
+} | {
+    kind: "context";
+    entries: Array<{
+        key: string;
+        value: FeelNode;
+    }>;
+} | {
+    kind: "range";
+    startIncluded: boolean;
+    low: FeelNode;
+    high: FeelNode;
+    endIncluded: boolean;
+} | {
+    kind: "unary-minus";
+    operand: FeelNode;
+} | {
+    kind: "binary";
+    op: BinaryOp;
+    left: FeelNode;
+    right: FeelNode;
+} | {
+    kind: "path";
+    base: FeelNode;
+    key: string;
+} | {
+    kind: "filter";
+    base: FeelNode;
+    condition: FeelNode;
+} | {
+    kind: "call";
+    callee: string;
+    args: FeelNode[];
+} | {
+    kind: "call-named";
+    callee: string;
+    args: Array<{
+        name: string;
+        value: FeelNode;
+    }>;
+} | {
+    kind: "if";
+    condition: FeelNode;
+    then: FeelNode;
+    else: FeelNode;
+} | {
+    kind: "for";
+    bindings: Array<{
+        name: string;
+        domain: FeelNode;
+    }>;
+    body: FeelNode;
+} | {
+    kind: "some" | "every";
+    bindings: Array<{
+        name: string;
+        domain: FeelNode;
+    }>;
+    satisfies: FeelNode;
+} | {
+    kind: "between";
+    value: FeelNode;
+    low: FeelNode;
+    high: FeelNode;
+} | {
+    kind: "in-test";
+    value: FeelNode;
+    test: FeelNode;
+} | {
+    kind: "instance-of";
+    value: FeelNode;
+    typeName: string;
+} | {
+    kind: "function-def";
+    params: string[];
+    body: FeelNode;
+} | {
+    kind: "unary-test-list";
+    tests: FeelNode[];
+} | {
+    kind: "unary-not";
+    tests: FeelNode[];
+} | {
+    kind: "any-input";
+};
+export {};
+//# sourceMappingURL=ast.d.ts.map

package/dist/ast.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=ast.js.map

package/dist/builtins.d.ts

@@ -0,0 +1,10 @@
+import type { FeelFunction, FeelValue } from "./types.js";
+declare function parseTemporal(raw: string): FeelValue;
+declare function compareValues(a: FeelValue, b: FeelValue): number | null;
+/** Look up a built-in function by name. Returns undefined if not found. */
+export declare function getBuiltin(name: string): FeelFunction | undefined;
+/** All built-in names. */
+export declare function builtinNames(): string[];
+/** Parse a @"..." temporal literal to a FeelValue. */
+export { parseTemporal, compareValues };
+//# sourceMappingURL=builtins.d.ts.map