Skip to content

Commit 1a43c13

Browse files
authored
docs: add filter RHS semantics conformance matrix (#198)
1 parent 46e102a commit 1a43c13

1 file changed

Lines changed: 13 additions & 0 deletions

File tree

docs/arco-spec.md

Lines changed: 13 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1778,6 +1778,19 @@ data generators source="data/generators.csv" {
17781778
}
17791779
```
17801780

1781+
### Conformance matrix for filter RHS semantics
1782+
1783+
| Case | Example | Interpretation |
1784+
| ------------------------------- | ------------------------------------------------------------ | ------------------------------------------------------ |
1785+
| Quoted categorical RHS | `filter { tech == "wind" }` | Compare string literal value from CSV |
1786+
| Bare categorical RHS | `filter { tech == wind }` | Compare against string literal `wind` |
1787+
| Mapped-column lhs with bare RHS | `map "tech" from="technology"` and `filter { tech == wind }` | Map applies to lhs only; rhs stays literal |
1788+
| Parent alias + filtered subset | `set candidates { in active; filter { is_candidate == 1 } }` | Alias resolution and predicate evaluation are combined |
1789+
1790+
Conformance tests for this behavior are tracked in
1791+
[`crates/arco-kdl/tests/semantic_validation.rs`](../crates/arco-kdl/tests/semantic_validation.rs),
1792+
covering §9 semantics for quoted RHS, bare RHS, mapped-column use, and alias+filter.
1793+
17811794
---
17821795

17831796
## 10. Validation requirements

0 commit comments

Comments
 (0)