mirror of
https://github.com/gorules/zen.git
synced 2026-10-04 16:02:18 +00:00
stefan-gorules
ffdfd807d1
* feat: implement slots instead of natural language Replace the natural-language projection (`nl`) with engine-owned slot completion: for a cursor position the engine classifies the slot being edited (operand, operator, literal, member access, ...) and returns typed options, literal facts and the expected type, for policies and graphs. - zen-expression: new `slot` module (classification, literals, operators) and a lenient lexer mode for incomplete input; `nl` removed - Intellisense: typed diagnostic codes with arguments, richer inspect for hover, dedicated parser error variants (messages unchanged) - Engine: `Workspace::cursor_scope`, `slot`, `facts`; `rename_from` and `references_from`; editor spans in UTF-16 units; renames reach imported policies, `$nodes` reads, child graphs and output column heads; no `$root` completion in policies - Node bindings: `slot`, `facts`, `cursorScope`, `slotBatch` replace `nl`, `nlTokenize`, `nlEncodeString`, `nlTokenizeBatch` No change to expression evaluation: the VM, compiler, functions and the default lexer path are untouched, and parser error messages keep their text. * fix: harden slot classification, scopes and graph expectations - restore master execution order; slot scopes hide writes of the edited block and its dependents instead of relying on block ranking - token-start editing gated by slot state; operator, list and operand spans no longer splice into neighbouring tokens - interval-aware bracket pairing for half-open and reversed intervals - lenient lexer recovers from unknown characters (slots only) - graph expected type follows switch and pass-through nodes and merges compatible output schemas - sibling inference caps distinct values and analyses lazily - deterministic overload return type display * fix: order policy blocks by entity reads through closures and relationships - record reads for `#.field` in closures so entity fields read through lists become dependencies - link reads through derived lists (filter/map results) to the entity fields they carry and order the list after those fields - evaluate entity blocks on single relationships, and demand entity paths for plain reads through relationships - slot scopes keep the top-level variable when hiding written fields
36 lines
1.7 KiB
Markdown
36 lines
1.7 KiB
Markdown
# ZEN Expression Language
|
|
|
|
**The expression language of [ZEN Engine](https://crates.io/crates/zen-engine)**, the open-source [Business Rules Engine (BRE)](https://gorules.io) from [GoRules](https://gorules.io).
|
|
|
|
[](https://opensource.org/licenses/MIT)
|
|
[](https://crates.io/crates/zen-expression)
|
|
|
|
ZEN expressions are readable by business users and fast enough for hot paths: a complete language for conditions, calculations and data transformation, with lexer, parser, compiler, VM, type checking and editor completions included in this crate.
|
|
|
|
```rust
|
|
use serde_json::json;
|
|
use zen_expression::evaluate_expression;
|
|
|
|
fn main() {
|
|
let result = evaluate_expression(
|
|
"sum(items) * multiplier",
|
|
json!({ "items": [10, 20, 30], "multiplier": 2 }).into(),
|
|
)
|
|
.unwrap();
|
|
// => 120
|
|
}
|
|
```
|
|
|
|
Reusable expressions compile once via `compile_expression` and evaluate repeatedly against different contexts.
|
|
|
|
## Resources
|
|
|
|
- [ZEN Expression Language reference](https://docs.gorules.io/learn/zen-language/syntax) - syntax, [operators](https://docs.gorules.io/learn/zen-language/operators), [built-in functions](https://docs.gorules.io/learn/zen-language/functions) and [date operations](https://docs.gorules.io/learn/zen-language/dates)
|
|
- [ZEN Engine](https://github.com/gorules/zen) - the rules engine built on this language
|
|
- [GoRules](https://gorules.io) - the platform around the open-source engine
|
|
- [Online Editor](https://editor.gorules.io) - try expressions in the free editor with a built-in simulator
|
|
|
|
## License
|
|
|
|
[MIT License](https://opensource.org/licenses/MIT)
|