@rippling/rippling-sdk 0.2.0-alpha.108 → 0.2.0-alpha.109

package/lib/charts/builders.mjs

@@ -1,55 +1,64 @@
 import { ChartRuleError } from "./errors.mjs";
-function isRuleNode(operand) {
-    return typeof operand === 'object' && operand !== null && 'kind' in operand;
+function hasOwn(value, key) {
+    return Object.prototype.hasOwnProperty.call(value, key);
+}
+function isOperandNode(operand) {
+    return typeof operand === 'object' && operand !== null && hasOwn(operand, 'kind');
 }
 /** True when a value is a `{$rule}` placeholder — the marker the builders emit. */
 export function isRulePlaceholder(value) {
-    return typeof value === 'object' && value !== null && '$rule' in value;
+    return typeof value === 'object' && value !== null && hasOwn(value, '$rule');
 }
 /** Wrap a bare scalar as a literal node. */
 export function literal(value) {
+    if (typeof value === 'number' && !Number.isFinite(value)) {
+        throw new ChartRuleError('literal(value) requires a finite number');
+    }
     return { kind: 'literal', value };
 }
-function toNode(operand) {
-    if (isRulePlaceholder(operand)) {
-        return operand.$rule; // a nested rule — unwrap it, never wrap it as a literal
-    }
-    return isRuleNode(operand) ? operand : literal(operand);
+function toOperandNode(operand) {
+    return isOperandNode(operand) ? operand : literal(operand);
+}
+function toNumericOperandNode(operand) {
+    return typeof operand === 'number' ? literal(operand) : operand;
 }
 /**
  * `value` — this data point's plotted numeric value: a bar's height, a point's
  * y, a slice's amount. It is what a colour rule compares against a constant.
  */
 export const value = Object.freeze({ kind: 'value' });
-/* Comparisons — return a condition. */
-function comparison(kind) {
-    return (left, right) => ({ kind, left: toNode(left), right: toNode(right) });
+/* Comparisons — return a condition with no nested expressions. */
+function equalityComparison(kind) {
+    return (left, right) => ({ kind, left: toOperandNode(left), right: toOperandNode(right) });
+}
+function numericComparison(kind) {
+    return (left, right) => ({ kind, left: toNumericOperandNode(left), right: toNumericOperandNode(right) });
 }
-export const equals = comparison('equals');
-export const isNot = comparison('isNot');
-export const lessThan = comparison('lessThan');
-export const greaterThan = comparison('greaterThan');
-export const lessOrEqual = comparison('lessOrEqual');
-export const greaterOrEqual = comparison('greaterOrEqual');
+export const equals = equalityComparison('equals');
+export const isNot = equalityComparison('isNot');
+export const lessThan = numericComparison('lessThan');
+export const greaterThan = numericComparison('greaterThan');
+export const lessOrEqual = numericComparison('lessOrEqual');
+export const greaterOrEqual = numericComparison('greaterOrEqual');
 /**
- * A conditional value: pick `ifTrue` when the condition holds, else `ifFalse`.
- * Channel-agnostic — wrap it in a channel builder (`color`) to target something.
+ * A conditional colour: pick `ifTrue` when the condition holds, else `ifFalse`.
  *
  *   when(lessThan(value, 100), '#E24B4A', '#378ADD')
  *   // → '#E24B4A' when this point's value is under 100, '#378ADD' otherwise
  *
  * `ifFalse` is optional and defaults to `null` — for a colour, that means no
- * override (the chart's default is kept). Returns a plain node, not a placeholder.
+ * override (the chart's default is kept). Branches are colour literals only;
+ * nested rules are intentionally unsupported in v1.
  */
-export function when(condition, ifTrue, ifFalse) {
+export function when(condition, ifTrue, ifFalse = null) {
     if (ifTrue === undefined) {
         throw new ChartRuleError('when(condition, ifTrue, ifFalse?) needs a value for the true case');
     }
     return {
         kind: 'ifElse',
         cond: condition,
-        then: toNode(ifTrue),
-        else: toNode(ifFalse ?? null),
+        then: literal(ifTrue),
+        else: literal(ifFalse),
     };
 }
 /**
@@ -59,12 +68,10 @@ export function when(condition, ifTrue, ifFalse) {
  *   color(when(lessThan(value, 100), '#E24B4A', '#378ADD'))
  *   // → red when this point's value is under 100, blue otherwise
  *
- * Takes a conditional value — a `when(...)` (`IfElseNode`) or an already-wrapped
- * rule — not a bare `value` or comparison: those resolve to a number or a
- * boolean, which is not a colour. `evaluate` enforces the same at runtime for a
- * deserialized rule. Returns a `{$rule}` placeholder tagged `channel: 'color'`.
+ * Takes the flat conditional value produced by `when(...)`. Returns a `{$rule}`
+ * placeholder tagged `channel: 'color'`.
  */
 export function color(rule) {
-    return { $rule: isRulePlaceholder(rule) ? rule.$rule : rule, channel: 'color' };
+    return { $rule: rule, channel: 'color' };
 }
 //# sourceMappingURL=builders.mjs.map

package/lib/charts/builders.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"builders.mjs","sourceRoot":"","sources":["../../src/lib/charts/builders.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,qBAAiB;AAe1C,SAAS,UAAU,CAAC,OAAgB;IAClC,OAAO,OAAO,OAAO,KAAK,QAAQ,IAAI,OAAO,KAAK,IAAI,IAAI,MAAM,IAAI,OAAO,CAAC;AAC9E,CAAC;AAED,mFAAmF;AACnF,MAAM,UAAU,iBAAiB,CAAC,KAAc;IAC9C,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,OAAO,IAAI,KAAK,CAAC;AACzE,CAAC;AAED,4CAA4C;AAC5C,MAAM,UAAU,OAAO,CAAC,KAAa;IACnC,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC;AACpC,CAAC;AAED,SAAS,MAAM,CAAC,OAAgB;IAC9B,IAAI,iBAAiB,CAAC,OAAO,CAAC,EAAE,CAAC;QAC/B,OAAO,OAAO,CAAC,KAAK,CAAC,CAAC,wDAAwD;IAChF,CAAC;IACD,OAAO,UAAU,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;AAC1D,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,MAAM,KAAK,GAAY,MAAM,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC;AAE/D,uCAAuC;AACvC,SAAS,UAAU,CAAC,IAAoB;IACtC,OAAO,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;AAC/E,CAAC;AACD,MAAM,CAAC,MAAM,MAAM,GAAG,UAAU,CAAC,QAAQ,CAAC,CAAC;AAC3C,MAAM,CAAC,MAAM,KAAK,GAAG,UAAU,CAAC,OAAO,CAAC,CAAC;AACzC,MAAM,CAAC,MAAM,QAAQ,GAAG,UAAU,CAAC,UAAU,CAAC,CAAC;AAC/C,MAAM,CAAC,MAAM,WAAW,GAAG,UAAU,CAAC,aAAa,CAAC,CAAC;AACrD,MAAM,CAAC,MAAM,WAAW,GAAG,UAAU,CAAC,aAAa,CAAC,CAAC;AACrD,MAAM,CAAC,MAAM,cAAc,GAAG,UAAU,CAAC,gBAAgB,CAAC,CAAC;AAE3D;;;;;;;;;GASG;AACH,MAAM,UAAU,IAAI,CAAC,SAAmB,EAAE,MAAe,EAAE,OAAiB;IAC1E,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;QACzB,MAAM,IAAI,cAAc,CAAC,mEAAmE,CAAC,CAAC;IAChG,CAAC;IACD,OAAO;QACL,IAAI,EAAE,QAAQ;QACd,IAAI,EAAE,SAAS;QACf,IAAI,EAAE,MAAM,CAAC,MAAM,CAAC;QACpB,IAAI,EAAE,MAAM,CAAC,OAAO,IAAI,IAAI,CAAC;KAC9B,CAAC;AACJ,CAAC;AAED;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,KAAK,CAAC,IAAkC;IACtD,OAAO,EAAE,KAAK,EAAE,iBAAiB,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC;AAClF,CAAC"}
+{"version":3,"file":"builders.mjs","sourceRoot":"","sources":["../../src/lib/charts/builders.ts"],"names":[],"mappings":"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"}

package/lib/charts/describe.d.mts

@@ -1,12 +1,11 @@
-import { type Control, type Rule } from "./types.mjs";
+import { type Control } from "./types.mjs";
 /**
  * Turn a rule into the shape the settings panel renders: a label plus its
- * editable parts. Accepts a `{$rule}` placeholder or a bare tree. Walks the same
- * tree `evaluate` runs — and validates each node the same way — so a malformed or
+ * editable parts. Accepts a `{$rule}` placeholder or a bare node. Reads the same
+ * value `evaluate` runs — and validates it the same way — so a malformed or
  * unknown node throws a `ChartRuleError` here too, never a native `TypeError`.
- * The unwrap is gated on `isRulePlaceholder` (not a raw `'$rule' in rule`) so a
- * `null`/primitive rule reaches `assertRuleNode` instead of throwing on `in`.
- * A tree nested past `MAX_RULE_DEPTH` throws `RuleDepthError`.
+ * The Valibot parser rejects malformed or nested values before this flat
+ * formatter reads them.
  */
-export declare function describe(rule: Rule): Control;
+export declare function describe(rule: unknown): Control;
 //# sourceMappingURL=describe.d.mts.map

package/lib/charts/describe.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"describe.d.mts","sourceRoot":"","sources":["../../src/lib/charts/describe.ts"],"names":[],"mappings":"AAGA,OAAO,EAAkB,KAAK,OAAO,EAAE,KAAK,IAAI,EAAiB,oBAAgB;AAEjF;;;;;;;;GAQG;AACH,wBAAgB,QAAQ,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,CAK5C"}
+{"version":3,"file":"describe.d.mts","sourceRoot":"","sources":["../../src/lib/charts/describe.ts"],"names":[],"mappings":"AAEA,OAAO,EAA8B,KAAK,OAAO,EAAiB,oBAAgB;AAElF;;;;;;;GAOG;AACH,wBAAgB,QAAQ,CAAC,IAAI,EAAE,OAAO,GAAG,OAAO,CAM/C"}

package/lib/charts/describe.d.ts

@@ -1,12 +1,11 @@
-import { type Control, type Rule } from "./types.js";
+import { type Control } from "./types.js";
 /**
  * Turn a rule into the shape the settings panel renders: a label plus its
- * editable parts. Accepts a `{$rule}` placeholder or a bare tree. Walks the same
- * tree `evaluate` runs — and validates each node the same way — so a malformed or
+ * editable parts. Accepts a `{$rule}` placeholder or a bare node. Reads the same
+ * value `evaluate` runs — and validates it the same way — so a malformed or
  * unknown node throws a `ChartRuleError` here too, never a native `TypeError`.
- * The unwrap is gated on `isRulePlaceholder` (not a raw `'$rule' in rule`) so a
- * `null`/primitive rule reaches `assertRuleNode` instead of throwing on `in`.
- * A tree nested past `MAX_RULE_DEPTH` throws `RuleDepthError`.
+ * The Valibot parser rejects malformed or nested values before this flat
+ * formatter reads them.
  */
-export declare function describe(rule: Rule): Control;
+export declare function describe(rule: unknown): Control;
 //# sourceMappingURL=describe.d.ts.map

package/lib/charts/describe.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"describe.d.ts","sourceRoot":"","sources":["../../src/lib/charts/describe.ts"],"names":[],"mappings":"AAGA,OAAO,EAAkB,KAAK,OAAO,EAAE,KAAK,IAAI,EAAiB,mBAAgB;AAEjF;;;;;;;;GAQG;AACH,wBAAgB,QAAQ,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,CAK5C"}
+{"version":3,"file":"describe.d.ts","sourceRoot":"","sources":["../../src/lib/charts/describe.ts"],"names":[],"mappings":"AAEA,OAAO,EAA8B,KAAK,OAAO,EAAiB,mBAAgB;AAElF;;;;;;;GAOG;AACH,wBAAgB,QAAQ,CAAC,IAAI,EAAE,OAAO,GAAG,OAAO,CAM/C"}

package/lib/charts/describe.js

@@ -1,62 +1,61 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.describe = describe;
-const builders_1 = require("./builders.js");
 const errors_1 = require("./errors.js");
-const guards_1 = require("./guards.js");
-const types_1 = require("./types.js");
+const schema_1 = require("./schema.js");
 /**
  * Turn a rule into the shape the settings panel renders: a label plus its
- * editable parts. Accepts a `{$rule}` placeholder or a bare tree. Walks the same
- * tree `evaluate` runs — and validates each node the same way — so a malformed or
+ * editable parts. Accepts a `{$rule}` placeholder or a bare node. Reads the same
+ * value `evaluate` runs — and validates it the same way — so a malformed or
  * unknown node throws a `ChartRuleError` here too, never a native `TypeError`.
- * The unwrap is gated on `isRulePlaceholder` (not a raw `'$rule' in rule`) so a
- * `null`/primitive rule reaches `assertRuleNode` instead of throwing on `in`.
- * A tree nested past `MAX_RULE_DEPTH` throws `RuleDepthError`.
+ * The Valibot parser rejects malformed or nested values before this flat
+ * formatter reads them.
  */
 function describe(rule) {
-    if ((0, builders_1.isRulePlaceholder)(rule)) {
-        return visit(rule.$rule, 0);
+    const parsedRule = (0, schema_1.parseChartRule)(rule);
+    if ('$rule' in parsedRule) {
+        return visit(parsedRule.$rule);
     }
-    return visit(rule, 0);
+    return visit(parsedRule);
 }
-function visit(node, depth) {
-    if (depth > types_1.MAX_RULE_DEPTH) {
-        throw new errors_1.RuleDepthError(types_1.MAX_RULE_DEPTH);
-    }
-    (0, guards_1.assertRuleNode)(node);
-    const next = depth + 1;
+function visit(node) {
     switch (node.kind) {
         case 'value':
             return { role: 'ref', label: "this row's value" };
         case 'literal': {
-            const scalar = (0, guards_1.literalValue)(node);
+            const scalar = node.value;
             return { role: 'literal', label: String(scalar), value: scalar };
         }
         case 'equals':
-            return comparison('is', node.left, node.right, next);
+            return comparison('is', node.left, node.right);
         case 'isNot':
-            return comparison('is not', node.left, node.right, next);
+            return comparison('is not', node.left, node.right);
         case 'lessThan':
-            return comparison('is under', node.left, node.right, next);
+            return comparison('is under', node.left, node.right);
         case 'greaterThan':
-            return comparison('is over', node.left, node.right, next);
+            return comparison('is over', node.left, node.right);
         case 'lessOrEqual':
-            return comparison('is at most', node.left, node.right, next);
+            return comparison('is at most', node.left, node.right);
         case 'greaterOrEqual':
-            return comparison('is at least', node.left, node.right, next);
+            return comparison('is at least', node.left, node.right);
         case 'ifElse':
             return {
                 role: 'rule',
                 label: 'when',
-                parts: [visit(node.cond, next), visit(node.then, next), visit(node.else, next)],
+                parts: [visit(node.cond), literalControl(node.then.value), literalControl(node.else.value)],
             };
         default:
             return unreachable(node);
     }
 }
-function comparison(label, left, right, depth) {
-    return { role: 'comparison', label, parts: [visit(left, depth), visit(right, depth)] };
+function comparison(label, left, right) {
+    return { role: 'comparison', label, parts: [operandControl(left), operandControl(right)] };
+}
+function operandControl(node) {
+    return node.kind === 'value' ? { role: 'ref', label: "this row's value" } : literalControl(node.value);
+}
+function literalControl(value) {
+    return { role: 'literal', label: String(value), value };
 }
 function unreachable(node) {
     throw new errors_1.UnknownNodeError(node.kind);

package/lib/charts/describe.js.map

@@ -1 +1 @@
-{"version":3,"file":"describe.js","sourceRoot":"","sources":["../../src/lib/charts/describe.ts"],"names":[],"mappings":";;AAcA,4BAKC;AAnBD,4CAA+C;AAC/C,wCAA4D;AAC5D,wCAAwD;AACxD,sCAAiF;AAEjF;;;;;;;;GAQG;AACH,SAAgB,QAAQ,CAAC,IAAU;IACjC,IAAI,IAAA,4BAAiB,EAAC,IAAI,CAAC,EAAE,CAAC;QAC5B,OAAO,KAAK,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;IAC9B,CAAC;IACD,OAAO,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;AACxB,CAAC;AAED,SAAS,KAAK,CAAC,IAAc,EAAE,KAAa;IAC1C,IAAI,KAAK,GAAG,sBAAc,EAAE,CAAC;QAC3B,MAAM,IAAI,uBAAc,CAAC,sBAAc,CAAC,CAAC;IAC3C,CAAC;IACD,IAAA,uBAAc,EAAC,IAAI,CAAC,CAAC;IACrB,MAAM,IAAI,GAAG,KAAK,GAAG,CAAC,CAAC;IACvB,QAAQ,IAAI,CAAC,IAAI,EAAE,CAAC;QAClB,KAAK,OAAO;YACV,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,kBAAkB,EAAE,CAAC;QACpD,KAAK,SAAS,CAAC,CAAC,CAAC;YACf,MAAM,MAAM,GAAG,IAAA,qBAAY,EAAC,IAAI,CAAC,CAAC;YAClC,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC;QACnE,CAAC;QAED,KAAK,QAAQ;YACX,OAAO,UAAU,CAAC,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;QACvD,KAAK,OAAO;YACV,OAAO,UAAU,CAAC,QAAQ,EAAE,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;QAC3D,KAAK,UAAU;YACb,OAAO,UAAU,CAAC,UAAU,EAAE,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;QAC7D,KAAK,aAAa;YAChB,OAAO,UAAU,CAAC,SAAS,EAAE,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;QAC5D,KAAK,aAAa;YAChB,OAAO,UAAU,CAAC,YAAY,EAAE,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;QAC/D,KAAK,gBAAgB;YACnB,OAAO,UAAU,CAAC,aAAa,EAAE,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;QAEhE,KAAK,QAAQ;YACX,OAAO;gBACL,IAAI,EAAE,MAAM;gBACZ,KAAK,EAAE,MAAM;gBACb,KAAK,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,EAAE,KAAK,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,EAAE,KAAK,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;aAChF,CAAC;QAEJ;YACE,OAAO,WAAW,CAAC,IAAI,CAAC,CAAC;IAC7B,CAAC;AACH,CAAC;AAED,SAAS,UAAU,CAAC,KAAa,EAAE,IAAc,EAAE,KAAe,EAAE,KAAa;IAC/E,OAAO,EAAE,IAAI,EAAE,YAAY,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,EAAE,KAAK,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC,EAAE,CAAC;AACzF,CAAC;AAED,SAAS,WAAW,CAAC,IAAW;IAC9B,MAAM,IAAI,yBAAgB,CAAE,IAA0B,CAAC,IAAI,CAAC,CAAC;AAC/D,CAAC"}
+{"version":3,"file":"describe.js","sourceRoot":"","sources":["../../src/lib/charts/describe.ts"],"names":[],"mappings":"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"}

package/lib/charts/describe.mjs

@@ -1,59 +1,58 @@
-import { isRulePlaceholder } from "./builders.mjs";
-import { RuleDepthError, UnknownNodeError } from "./errors.mjs";
-import { assertRuleNode, literalValue } from "./guards.mjs";
-import { MAX_RULE_DEPTH } from "./types.mjs";
+import { UnknownNodeError } from "./errors.mjs";
+import { parseChartRule } from "./schema.mjs";
 /**
  * Turn a rule into the shape the settings panel renders: a label plus its
- * editable parts. Accepts a `{$rule}` placeholder or a bare tree. Walks the same
- * tree `evaluate` runs — and validates each node the same way — so a malformed or
+ * editable parts. Accepts a `{$rule}` placeholder or a bare node. Reads the same
+ * value `evaluate` runs — and validates it the same way — so a malformed or
  * unknown node throws a `ChartRuleError` here too, never a native `TypeError`.
- * The unwrap is gated on `isRulePlaceholder` (not a raw `'$rule' in rule`) so a
- * `null`/primitive rule reaches `assertRuleNode` instead of throwing on `in`.
- * A tree nested past `MAX_RULE_DEPTH` throws `RuleDepthError`.
+ * The Valibot parser rejects malformed or nested values before this flat
+ * formatter reads them.
  */
 export function describe(rule) {
-    if (isRulePlaceholder(rule)) {
-        return visit(rule.$rule, 0);
+    const parsedRule = parseChartRule(rule);
+    if ('$rule' in parsedRule) {
+        return visit(parsedRule.$rule);
     }
-    return visit(rule, 0);
+    return visit(parsedRule);
 }
-function visit(node, depth) {
-    if (depth > MAX_RULE_DEPTH) {
-        throw new RuleDepthError(MAX_RULE_DEPTH);
-    }
-    assertRuleNode(node);
-    const next = depth + 1;
+function visit(node) {
     switch (node.kind) {
         case 'value':
             return { role: 'ref', label: "this row's value" };
         case 'literal': {
-            const scalar = literalValue(node);
+            const scalar = node.value;
             return { role: 'literal', label: String(scalar), value: scalar };
         }
         case 'equals':
-            return comparison('is', node.left, node.right, next);
+            return comparison('is', node.left, node.right);
         case 'isNot':
-            return comparison('is not', node.left, node.right, next);
+            return comparison('is not', node.left, node.right);
         case 'lessThan':
-            return comparison('is under', node.left, node.right, next);
+            return comparison('is under', node.left, node.right);
         case 'greaterThan':
-            return comparison('is over', node.left, node.right, next);
+            return comparison('is over', node.left, node.right);
         case 'lessOrEqual':
-            return comparison('is at most', node.left, node.right, next);
+            return comparison('is at most', node.left, node.right);
         case 'greaterOrEqual':
-            return comparison('is at least', node.left, node.right, next);
+            return comparison('is at least', node.left, node.right);
         case 'ifElse':
             return {
                 role: 'rule',
                 label: 'when',
-                parts: [visit(node.cond, next), visit(node.then, next), visit(node.else, next)],
+                parts: [visit(node.cond), literalControl(node.then.value), literalControl(node.else.value)],
             };
         default:
             return unreachable(node);
     }
 }
-function comparison(label, left, right, depth) {
-    return { role: 'comparison', label, parts: [visit(left, depth), visit(right, depth)] };
+function comparison(label, left, right) {
+    return { role: 'comparison', label, parts: [operandControl(left), operandControl(right)] };
+}
+function operandControl(node) {
+    return node.kind === 'value' ? { role: 'ref', label: "this row's value" } : literalControl(node.value);
+}
+function literalControl(value) {
+    return { role: 'literal', label: String(value), value };
 }
 function unreachable(node) {
     throw new UnknownNodeError(node.kind);

package/lib/charts/describe.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"describe.mjs","sourceRoot":"","sources":["../../src/lib/charts/describe.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"describe.mjs","sourceRoot":"","sources":["../../src/lib/charts/describe.ts"],"names":[],"mappings":"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"}

package/lib/charts/errors.d.mts

@@ -14,7 +14,7 @@ export declare class RuleTypeError extends ChartRuleError {
     constructor(message: string);
 }
 /**
- * A structurally invalid node in a deserialized tree: not an object, no string
+ * A structurally invalid node in a deserialized value: not an object, no string
  * `kind`, or a `literal` without a scalar `value`. Distinct from
  * `UnknownNodeError` (a well-formed node whose `kind` is simply not in the
  * vocabulary — the intentional escape hatch). Like the others it is a
@@ -24,11 +24,7 @@ export declare class RuleTypeError extends ChartRuleError {
 export declare class MalformedRuleError extends ChartRuleError {
     constructor(message: string);
 }
-/**
- * A rule nested deeper than the evaluator will walk. Guards against a
- * stack-overflowing tree from untrusted, deserialized input; like the others it
- * is a `ChartRuleError`, so the caller's escape hatch catches it.
- */
+/** @deprecated v1 is non-recursive. Retained for source compatibility. */
 export declare class RuleDepthError extends ChartRuleError {
     constructor(maxDepth: number);
 }

package/lib/charts/errors.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"errors.d.mts","sourceRoot":"","sources":["../../src/lib/charts/errors.ts"],"names":[],"mappings":"AAAA,qEAAqE;AACrE,qBAAa,cAAe,SAAQ,KAAK;CAAG;AAE5C;;;GAGG;AACH,qBAAa,gBAAiB,SAAQ,cAAc;aACtB,IAAI,CAAC,EAAE,MAAM;gBAAb,IAAI,CAAC,EAAE,MAAM,YAAA;CAI1C;AAED,gFAAgF;AAChF,qBAAa,aAAc,SAAQ,cAAc;gBACnC,OAAO,EAAE,MAAM;CAI5B;AAED;;;;;;;GAOG;AACH,qBAAa,kBAAmB,SAAQ,cAAc;gBACxC,OAAO,EAAE,MAAM;CAI5B;AAED;;;;GAIG;AACH,qBAAa,cAAe,SAAQ,cAAc;gBACpC,QAAQ,EAAE,MAAM;CAI7B"}
+{"version":3,"file":"errors.d.mts","sourceRoot":"","sources":["../../src/lib/charts/errors.ts"],"names":[],"mappings":"AAAA,qEAAqE;AACrE,qBAAa,cAAe,SAAQ,KAAK;CAAG;AAE5C;;;GAGG;AACH,qBAAa,gBAAiB,SAAQ,cAAc;aACtB,IAAI,CAAC,EAAE,MAAM;gBAAb,IAAI,CAAC,EAAE,MAAM,YAAA;CAI1C;AAED,gFAAgF;AAChF,qBAAa,aAAc,SAAQ,cAAc;gBACnC,OAAO,EAAE,MAAM;CAI5B;AAED;;;;;;;GAOG;AACH,qBAAa,kBAAmB,SAAQ,cAAc;gBACxC,OAAO,EAAE,MAAM;CAI5B;AAED,0EAA0E;AAC1E,qBAAa,cAAe,SAAQ,cAAc;gBACpC,QAAQ,EAAE,MAAM;CAI7B"}

package/lib/charts/errors.d.ts

@@ -14,7 +14,7 @@ export declare class RuleTypeError extends ChartRuleError {
     constructor(message: string);
 }
 /**
- * A structurally invalid node in a deserialized tree: not an object, no string
+ * A structurally invalid node in a deserialized value: not an object, no string
  * `kind`, or a `literal` without a scalar `value`. Distinct from
  * `UnknownNodeError` (a well-formed node whose `kind` is simply not in the
  * vocabulary — the intentional escape hatch). Like the others it is a
@@ -24,11 +24,7 @@ export declare class RuleTypeError extends ChartRuleError {
 export declare class MalformedRuleError extends ChartRuleError {
     constructor(message: string);
 }
-/**
- * A rule nested deeper than the evaluator will walk. Guards against a
- * stack-overflowing tree from untrusted, deserialized input; like the others it
- * is a `ChartRuleError`, so the caller's escape hatch catches it.
- */
+/** @deprecated v1 is non-recursive. Retained for source compatibility. */
 export declare class RuleDepthError extends ChartRuleError {
     constructor(maxDepth: number);
 }

package/lib/charts/errors.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/lib/charts/errors.ts"],"names":[],"mappings":"AAAA,qEAAqE;AACrE,qBAAa,cAAe,SAAQ,KAAK;CAAG;AAE5C;;;GAGG;AACH,qBAAa,gBAAiB,SAAQ,cAAc;aACtB,IAAI,CAAC,EAAE,MAAM;gBAAb,IAAI,CAAC,EAAE,MAAM,YAAA;CAI1C;AAED,gFAAgF;AAChF,qBAAa,aAAc,SAAQ,cAAc;gBACnC,OAAO,EAAE,MAAM;CAI5B;AAED;;;;;;;GAOG;AACH,qBAAa,kBAAmB,SAAQ,cAAc;gBACxC,OAAO,EAAE,MAAM;CAI5B;AAED;;;;GAIG;AACH,qBAAa,cAAe,SAAQ,cAAc;gBACpC,QAAQ,EAAE,MAAM;CAI7B"}
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/lib/charts/errors.ts"],"names":[],"mappings":"AAAA,qEAAqE;AACrE,qBAAa,cAAe,SAAQ,KAAK;CAAG;AAE5C;;;GAGG;AACH,qBAAa,gBAAiB,SAAQ,cAAc;aACtB,IAAI,CAAC,EAAE,MAAM;gBAAb,IAAI,CAAC,EAAE,MAAM,YAAA;CAI1C;AAED,gFAAgF;AAChF,qBAAa,aAAc,SAAQ,cAAc;gBACnC,OAAO,EAAE,MAAM;CAI5B;AAED;;;;;;;GAOG;AACH,qBAAa,kBAAmB,SAAQ,cAAc;gBACxC,OAAO,EAAE,MAAM;CAI5B;AAED,0EAA0E;AAC1E,qBAAa,cAAe,SAAQ,cAAc;gBACpC,QAAQ,EAAE,MAAM;CAI7B"}

package/lib/charts/errors.js

@@ -26,7 +26,7 @@ class RuleTypeError extends ChartRuleError {
 }
 exports.RuleTypeError = RuleTypeError;
 /**
- * A structurally invalid node in a deserialized tree: not an object, no string
+ * A structurally invalid node in a deserialized value: not an object, no string
  * `kind`, or a `literal` without a scalar `value`. Distinct from
  * `UnknownNodeError` (a well-formed node whose `kind` is simply not in the
  * vocabulary — the intentional escape hatch). Like the others it is a
@@ -40,11 +40,7 @@ class MalformedRuleError extends ChartRuleError {
     }
 }
 exports.MalformedRuleError = MalformedRuleError;
-/**
- * A rule nested deeper than the evaluator will walk. Guards against a
- * stack-overflowing tree from untrusted, deserialized input; like the others it
- * is a `ChartRuleError`, so the caller's escape hatch catches it.
- */
+/** @deprecated v1 is non-recursive. Retained for source compatibility. */
 class RuleDepthError extends ChartRuleError {
     constructor(maxDepth) {
         super(`chart rule nested deeper than ${maxDepth} levels`);

package/lib/charts/errors.js.map

@@ -1 +1 @@
-{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/lib/charts/errors.ts"],"names":[],"mappings":";;;AAAA,qEAAqE;AACrE,MAAa,cAAe,SAAQ,KAAK;CAAG;AAA5C,wCAA4C;AAE5C;;;GAGG;AACH,MAAa,gBAAiB,SAAQ,cAAc;IAClD,YAA4B,IAAa;QACvC,KAAK,CAAC,4BAA4B,IAAI,IAAI,gBAAgB,EAAE,CAAC,CAAC;QADpC,SAAI,GAAJ,IAAI,CAAS;QAEvC,IAAI,CAAC,IAAI,GAAG,kBAAkB,CAAC;IACjC,CAAC;CACF;AALD,4CAKC;AAED,gFAAgF;AAChF,MAAa,aAAc,SAAQ,cAAc;IAC/C,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,eAAe,CAAC;IAC9B,CAAC;CACF;AALD,sCAKC;AAED;;;;;;;GAOG;AACH,MAAa,kBAAmB,SAAQ,cAAc;IACpD,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,oBAAoB,CAAC;IACnC,CAAC;CACF;AALD,gDAKC;AAED;;;;GAIG;AACH,MAAa,cAAe,SAAQ,cAAc;IAChD,YAAY,QAAgB;QAC1B,KAAK,CAAC,iCAAiC,QAAQ,SAAS,CAAC,CAAC;QAC1D,IAAI,CAAC,IAAI,GAAG,gBAAgB,CAAC;IAC/B,CAAC;CACF;AALD,wCAKC"}
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/lib/charts/errors.ts"],"names":[],"mappings":";;;AAAA,qEAAqE;AACrE,MAAa,cAAe,SAAQ,KAAK;CAAG;AAA5C,wCAA4C;AAE5C;;;GAGG;AACH,MAAa,gBAAiB,SAAQ,cAAc;IAClD,YAA4B,IAAa;QACvC,KAAK,CAAC,4BAA4B,IAAI,IAAI,gBAAgB,EAAE,CAAC,CAAC;QADpC,SAAI,GAAJ,IAAI,CAAS;QAEvC,IAAI,CAAC,IAAI,GAAG,kBAAkB,CAAC;IACjC,CAAC;CACF;AALD,4CAKC;AAED,gFAAgF;AAChF,MAAa,aAAc,SAAQ,cAAc;IAC/C,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,eAAe,CAAC;IAC9B,CAAC;CACF;AALD,sCAKC;AAED;;;;;;;GAOG;AACH,MAAa,kBAAmB,SAAQ,cAAc;IACpD,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,oBAAoB,CAAC;IACnC,CAAC;CACF;AALD,gDAKC;AAED,0EAA0E;AAC1E,MAAa,cAAe,SAAQ,cAAc;IAChD,YAAY,QAAgB;QAC1B,KAAK,CAAC,iCAAiC,QAAQ,SAAS,CAAC,CAAC;QAC1D,IAAI,CAAC,IAAI,GAAG,gBAAgB,CAAC;IAC/B,CAAC;CACF;AALD,wCAKC"}

package/lib/charts/errors.mjs

@@ -20,7 +20,7 @@ export class RuleTypeError extends ChartRuleError {
     }
 }
 /**
- * A structurally invalid node in a deserialized tree: not an object, no string
+ * A structurally invalid node in a deserialized value: not an object, no string
  * `kind`, or a `literal` without a scalar `value`. Distinct from
  * `UnknownNodeError` (a well-formed node whose `kind` is simply not in the
  * vocabulary — the intentional escape hatch). Like the others it is a
@@ -33,11 +33,7 @@ export class MalformedRuleError extends ChartRuleError {
         this.name = 'MalformedRuleError';
     }
 }
-/**
- * A rule nested deeper than the evaluator will walk. Guards against a
- * stack-overflowing tree from untrusted, deserialized input; like the others it
- * is a `ChartRuleError`, so the caller's escape hatch catches it.
- */
+/** @deprecated v1 is non-recursive. Retained for source compatibility. */
 export class RuleDepthError extends ChartRuleError {
     constructor(maxDepth) {
         super(`chart rule nested deeper than ${maxDepth} levels`);

package/lib/charts/errors.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"errors.mjs","sourceRoot":"","sources":["../../src/lib/charts/errors.ts"],"names":[],"mappings":"AAAA,qEAAqE;AACrE,MAAM,OAAO,cAAe,SAAQ,KAAK;CAAG;AAE5C;;;GAGG;AACH,MAAM,OAAO,gBAAiB,SAAQ,cAAc;IAClD,YAA4B,IAAa;QACvC,KAAK,CAAC,4BAA4B,IAAI,IAAI,gBAAgB,EAAE,CAAC,CAAC;QADpC,SAAI,GAAJ,IAAI,CAAS;QAEvC,IAAI,CAAC,IAAI,GAAG,kBAAkB,CAAC;IACjC,CAAC;CACF;AAED,gFAAgF;AAChF,MAAM,OAAO,aAAc,SAAQ,cAAc;IAC/C,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,eAAe,CAAC;IAC9B,CAAC;CACF;AAED;;;;;;;GAOG;AACH,MAAM,OAAO,kBAAmB,SAAQ,cAAc;IACpD,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,oBAAoB,CAAC;IACnC,CAAC;CACF;AAED;;;;GAIG;AACH,MAAM,OAAO,cAAe,SAAQ,cAAc;IAChD,YAAY,QAAgB;QAC1B,KAAK,CAAC,iCAAiC,QAAQ,SAAS,CAAC,CAAC;QAC1D,IAAI,CAAC,IAAI,GAAG,gBAAgB,CAAC;IAC/B,CAAC;CACF"}
+{"version":3,"file":"errors.mjs","sourceRoot":"","sources":["../../src/lib/charts/errors.ts"],"names":[],"mappings":"AAAA,qEAAqE;AACrE,MAAM,OAAO,cAAe,SAAQ,KAAK;CAAG;AAE5C;;;GAGG;AACH,MAAM,OAAO,gBAAiB,SAAQ,cAAc;IAClD,YAA4B,IAAa;QACvC,KAAK,CAAC,4BAA4B,IAAI,IAAI,gBAAgB,EAAE,CAAC,CAAC;QADpC,SAAI,GAAJ,IAAI,CAAS;QAEvC,IAAI,CAAC,IAAI,GAAG,kBAAkB,CAAC;IACjC,CAAC;CACF;AAED,gFAAgF;AAChF,MAAM,OAAO,aAAc,SAAQ,cAAc;IAC/C,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,eAAe,CAAC;IAC9B,CAAC;CACF;AAED;;;;;;;GAOG;AACH,MAAM,OAAO,kBAAmB,SAAQ,cAAc;IACpD,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,oBAAoB,CAAC;IACnC,CAAC;CACF;AAED,0EAA0E;AAC1E,MAAM,OAAO,cAAe,SAAQ,cAAc;IAChD,YAAY,QAAgB;QAC1B,KAAK,CAAC,iCAAiC,QAAQ,SAAS,CAAC,CAAC;QAC1D,IAAI,CAAC,IAAI,GAAG,gBAAgB,CAAC;IAC/B,CAAC;CACF"}

package/lib/charts/evaluate.d.mts

@@ -1,16 +1,14 @@
-import { type Rule, type RuleContext, type RuleValue } from "./types.mjs";
+import { type RuleContext, type RuleValue } from "./types.mjs";
 /**
  * Resolve a rule to a value against `ctx`. Accepts a `{$rule}` placeholder or a
- * bare tree. A malformed or unknown node throws a `ChartRuleError` (never a
+ * bare node. A malformed or unknown node throws a `ChartRuleError` (never a
  * native `TypeError`), so a caller reading an untrusted, deserialized rule can
  * catch every failure with one type. When the rule is a colour placeholder, the
  * result is checked to be a colour (`string | null`) — a rule that resolves to a
  * number or boolean is a `RuleTypeError`, not something the renderer paints.
  *
- * Pure: the only inputs are the node and the context. No clock, no randomness,
- * no I/O — which is what makes it safe to run on an untrusted, user-edited tree
- * and identical across the renderer, the panel readout, and a test. A tree
- * nested past `MAX_RULE_DEPTH` throws `RuleDepthError` rather than overflowing.
+ * Pure and non-recursive: the only inputs are the validated flat rule and the
+ * context. No clock, randomness, callbacks, or I/O.
  */
-export declare function evaluate(rule: Rule, ctx: RuleContext): RuleValue;
+export declare function evaluate(rule: unknown, ctx: RuleContext): RuleValue;
 //# sourceMappingURL=evaluate.d.mts.map

package/lib/charts/evaluate.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"evaluate.d.mts","sourceRoot":"","sources":["../../src/lib/charts/evaluate.ts"],"names":[],"mappings":"AAGA,OAAO,EAEL,KAAK,IAAI,EAET,KAAK,WAAW,EAEhB,KAAK,SAAS,EACf,oBAAgB;AAEjB;;;;;;;;;;;;GAYG;AACH,wBAAgB,QAAQ,CAAC,IAAI,EAAE,IAAI,EAAE,GAAG,EAAE,WAAW,GAAG,SAAS,CAKhE"}
+{"version":3,"file":"evaluate.d.mts","sourceRoot":"","sources":["../../src/lib/charts/evaluate.ts"],"names":[],"mappings":"AAEA,OAAO,EAIL,KAAK,WAAW,EAEhB,KAAK,SAAS,EACf,oBAAgB;AAEjB;;;;;;;;;;GAUG;AACH,wBAAgB,QAAQ,CAAC,IAAI,EAAE,OAAO,EAAE,GAAG,EAAE,WAAW,GAAG,SAAS,CAMnE"}

package/lib/charts/evaluate.d.ts

@@ -1,16 +1,14 @@
-import { type Rule, type RuleContext, type RuleValue } from "./types.js";
+import { type RuleContext, type RuleValue } from "./types.js";
 /**
  * Resolve a rule to a value against `ctx`. Accepts a `{$rule}` placeholder or a
- * bare tree. A malformed or unknown node throws a `ChartRuleError` (never a
+ * bare node. A malformed or unknown node throws a `ChartRuleError` (never a
  * native `TypeError`), so a caller reading an untrusted, deserialized rule can
  * catch every failure with one type. When the rule is a colour placeholder, the
  * result is checked to be a colour (`string | null`) — a rule that resolves to a
  * number or boolean is a `RuleTypeError`, not something the renderer paints.
  *
- * Pure: the only inputs are the node and the context. No clock, no randomness,
- * no I/O — which is what makes it safe to run on an untrusted, user-edited tree
- * and identical across the renderer, the panel readout, and a test. A tree
- * nested past `MAX_RULE_DEPTH` throws `RuleDepthError` rather than overflowing.
+ * Pure and non-recursive: the only inputs are the validated flat rule and the
+ * context. No clock, randomness, callbacks, or I/O.
  */
-export declare function evaluate(rule: Rule, ctx: RuleContext): RuleValue;
+export declare function evaluate(rule: unknown, ctx: RuleContext): RuleValue;
 //# sourceMappingURL=evaluate.d.ts.map

package/lib/charts/evaluate.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"evaluate.d.ts","sourceRoot":"","sources":["../../src/lib/charts/evaluate.ts"],"names":[],"mappings":"AAGA,OAAO,EAEL,KAAK,IAAI,EAET,KAAK,WAAW,EAEhB,KAAK,SAAS,EACf,mBAAgB;AAEjB;;;;;;;;;;;;GAYG;AACH,wBAAgB,QAAQ,CAAC,IAAI,EAAE,IAAI,EAAE,GAAG,EAAE,WAAW,GAAG,SAAS,CAKhE"}
+{"version":3,"file":"evaluate.d.ts","sourceRoot":"","sources":["../../src/lib/charts/evaluate.ts"],"names":[],"mappings":"AAEA,OAAO,EAIL,KAAK,WAAW,EAEhB,KAAK,SAAS,EACf,mBAAgB;AAEjB;;;;;;;;;;GAUG;AACH,wBAAgB,QAAQ,CAAC,IAAI,EAAE,OAAO,EAAE,GAAG,EAAE,WAAW,GAAG,SAAS,CAMnE"}