@rippling/rippling-sdk 0.2.0-alpha.105 → 0.2.0-alpha.106

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

@@ -0,0 +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"}

package/lib/charts/describe.js

@@ -0,0 +1,64 @@
+"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");
+/**
+ * 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
+ * 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`.
+ */
+function describe(rule) {
+    if ((0, builders_1.isRulePlaceholder)(rule)) {
+        return visit(rule.$rule, 0);
+    }
+    return visit(rule, 0);
+}
+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;
+    switch (node.kind) {
+        case 'value':
+            return { role: 'ref', label: "this row's value" };
+        case 'literal': {
+            const scalar = (0, guards_1.literalValue)(node);
+            return { role: 'literal', label: String(scalar), value: scalar };
+        }
+        case 'equals':
+            return comparison('is', node.left, node.right, next);
+        case 'isNot':
+            return comparison('is not', node.left, node.right, next);
+        case 'lessThan':
+            return comparison('is under', node.left, node.right, next);
+        case 'greaterThan':
+            return comparison('is over', node.left, node.right, next);
+        case 'lessOrEqual':
+            return comparison('is at most', node.left, node.right, next);
+        case 'greaterOrEqual':
+            return comparison('is at least', node.left, node.right, next);
+        case 'ifElse':
+            return {
+                role: 'rule',
+                label: 'when',
+                parts: [visit(node.cond, next), visit(node.then, next), visit(node.else, next)],
+            };
+        default:
+            return unreachable(node);
+    }
+}
+function comparison(label, left, right, depth) {
+    return { role: 'comparison', label, parts: [visit(left, depth), visit(right, depth)] };
+}
+function unreachable(node) {
+    throw new errors_1.UnknownNodeError(node.kind);
+}
+//# sourceMappingURL=describe.js.map

package/lib/charts/describe.js.map

@@ -0,0 +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"}

package/lib/charts/describe.mjs

@@ -0,0 +1,61 @@
+import { isRulePlaceholder } from "./builders.mjs";
+import { RuleDepthError, UnknownNodeError } from "./errors.mjs";
+import { assertRuleNode, literalValue } from "./guards.mjs";
+import { MAX_RULE_DEPTH } 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
+ * 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`.
+ */
+export function describe(rule) {
+    if (isRulePlaceholder(rule)) {
+        return visit(rule.$rule, 0);
+    }
+    return visit(rule, 0);
+}
+function visit(node, depth) {
+    if (depth > MAX_RULE_DEPTH) {
+        throw new RuleDepthError(MAX_RULE_DEPTH);
+    }
+    assertRuleNode(node);
+    const next = depth + 1;
+    switch (node.kind) {
+        case 'value':
+            return { role: 'ref', label: "this row's value" };
+        case 'literal': {
+            const scalar = literalValue(node);
+            return { role: 'literal', label: String(scalar), value: scalar };
+        }
+        case 'equals':
+            return comparison('is', node.left, node.right, next);
+        case 'isNot':
+            return comparison('is not', node.left, node.right, next);
+        case 'lessThan':
+            return comparison('is under', node.left, node.right, next);
+        case 'greaterThan':
+            return comparison('is over', node.left, node.right, next);
+        case 'lessOrEqual':
+            return comparison('is at most', node.left, node.right, next);
+        case 'greaterOrEqual':
+            return comparison('is at least', node.left, node.right, next);
+        case 'ifElse':
+            return {
+                role: 'rule',
+                label: 'when',
+                parts: [visit(node.cond, next), visit(node.then, next), visit(node.else, next)],
+            };
+        default:
+            return unreachable(node);
+    }
+}
+function comparison(label, left, right, depth) {
+    return { role: 'comparison', label, parts: [visit(left, depth), visit(right, depth)] };
+}
+function unreachable(node) {
+    throw new UnknownNodeError(node.kind);
+}
+//# sourceMappingURL=describe.mjs.map

package/lib/charts/describe.mjs.map

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

package/lib/charts/errors.d.mts

@@ -0,0 +1,35 @@
+/** Base class for every error the chart-rule evaluator can throw. */
+export declare class ChartRuleError extends Error {
+}
+/**
+ * A node whose `kind` is not in the vocabulary. The caller catches this and
+ * shows the setting as "configured in code", read-only.
+ */
+export declare class UnknownNodeError extends ChartRuleError {
+    readonly kind?: string | undefined;
+    constructor(kind?: string | undefined);
+}
+/** A node evaluated to the wrong type of value (e.g. comparing non-numbers). */
+export declare class RuleTypeError extends ChartRuleError {
+    constructor(message: string);
+}
+/**
+ * A structurally invalid node in a deserialized tree: 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
+ * `ChartRuleError`, so a caller reading an untrusted rule catches it instead of
+ * a native `TypeError` (or, worse, an `undefined` slipping through silently).
+ */
+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.
+ */
+export declare class RuleDepthError extends ChartRuleError {
+    constructor(maxDepth: number);
+}
+//# sourceMappingURL=errors.d.mts.map

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

@@ -0,0 +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"}

package/lib/charts/errors.d.ts

@@ -0,0 +1,35 @@
+/** Base class for every error the chart-rule evaluator can throw. */
+export declare class ChartRuleError extends Error {
+}
+/**
+ * A node whose `kind` is not in the vocabulary. The caller catches this and
+ * shows the setting as "configured in code", read-only.
+ */
+export declare class UnknownNodeError extends ChartRuleError {
+    readonly kind?: string | undefined;
+    constructor(kind?: string | undefined);
+}
+/** A node evaluated to the wrong type of value (e.g. comparing non-numbers). */
+export declare class RuleTypeError extends ChartRuleError {
+    constructor(message: string);
+}
+/**
+ * A structurally invalid node in a deserialized tree: 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
+ * `ChartRuleError`, so a caller reading an untrusted rule catches it instead of
+ * a native `TypeError` (or, worse, an `undefined` slipping through silently).
+ */
+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.
+ */
+export declare class RuleDepthError extends ChartRuleError {
+    constructor(maxDepth: number);
+}
+//# sourceMappingURL=errors.d.ts.map

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

@@ -0,0 +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"}

package/lib/charts/errors.js

@@ -0,0 +1,55 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RuleDepthError = exports.MalformedRuleError = exports.RuleTypeError = exports.UnknownNodeError = exports.ChartRuleError = void 0;
+/** Base class for every error the chart-rule evaluator can throw. */
+class ChartRuleError extends Error {
+}
+exports.ChartRuleError = ChartRuleError;
+/**
+ * A node whose `kind` is not in the vocabulary. The caller catches this and
+ * shows the setting as "configured in code", read-only.
+ */
+class UnknownNodeError extends ChartRuleError {
+    constructor(kind) {
+        super(`Unknown chart-rule node: ${kind ?? '(missing kind)'}`);
+        this.kind = kind;
+        this.name = 'UnknownNodeError';
+    }
+}
+exports.UnknownNodeError = UnknownNodeError;
+/** A node evaluated to the wrong type of value (e.g. comparing non-numbers). */
+class RuleTypeError extends ChartRuleError {
+    constructor(message) {
+        super(message);
+        this.name = 'RuleTypeError';
+    }
+}
+exports.RuleTypeError = RuleTypeError;
+/**
+ * A structurally invalid node in a deserialized tree: 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
+ * `ChartRuleError`, so a caller reading an untrusted rule catches it instead of
+ * a native `TypeError` (or, worse, an `undefined` slipping through silently).
+ */
+class MalformedRuleError extends ChartRuleError {
+    constructor(message) {
+        super(message);
+        this.name = 'MalformedRuleError';
+    }
+}
+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.
+ */
+class RuleDepthError extends ChartRuleError {
+    constructor(maxDepth) {
+        super(`chart rule nested deeper than ${maxDepth} levels`);
+        this.name = 'RuleDepthError';
+    }
+}
+exports.RuleDepthError = RuleDepthError;
+//# sourceMappingURL=errors.js.map

package/lib/charts/errors.js.map

@@ -0,0 +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"}

package/lib/charts/errors.mjs

@@ -0,0 +1,47 @@
+/** Base class for every error the chart-rule evaluator can throw. */
+export class ChartRuleError extends Error {
+}
+/**
+ * A node whose `kind` is not in the vocabulary. The caller catches this and
+ * shows the setting as "configured in code", read-only.
+ */
+export class UnknownNodeError extends ChartRuleError {
+    constructor(kind) {
+        super(`Unknown chart-rule node: ${kind ?? '(missing kind)'}`);
+        this.kind = kind;
+        this.name = 'UnknownNodeError';
+    }
+}
+/** A node evaluated to the wrong type of value (e.g. comparing non-numbers). */
+export class RuleTypeError extends ChartRuleError {
+    constructor(message) {
+        super(message);
+        this.name = 'RuleTypeError';
+    }
+}
+/**
+ * A structurally invalid node in a deserialized tree: 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
+ * `ChartRuleError`, so a caller reading an untrusted rule catches it instead of
+ * a native `TypeError` (or, worse, an `undefined` slipping through silently).
+ */
+export class MalformedRuleError extends ChartRuleError {
+    constructor(message) {
+        super(message);
+        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.
+ */
+export class RuleDepthError extends ChartRuleError {
+    constructor(maxDepth) {
+        super(`chart rule nested deeper than ${maxDepth} levels`);
+        this.name = 'RuleDepthError';
+    }
+}
+//# sourceMappingURL=errors.mjs.map

package/lib/charts/errors.mjs.map

@@ -0,0 +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"}

package/lib/charts/evaluate.d.mts

@@ -0,0 +1,16 @@
+import { type Rule, 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
+ * 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.
+ */
+export declare function evaluate(rule: Rule, ctx: RuleContext): RuleValue;
+//# sourceMappingURL=evaluate.d.mts.map

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

@@ -0,0 +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"}

package/lib/charts/evaluate.d.ts

@@ -0,0 +1,16 @@
+import { type Rule, 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
+ * 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.
+ */
+export declare function evaluate(rule: Rule, ctx: RuleContext): RuleValue;
+//# sourceMappingURL=evaluate.d.ts.map

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

@@ -0,0 +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"}

package/lib/charts/evaluate.js

@@ -0,0 +1,99 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.evaluate = evaluate;
+const builders_1 = require("./builders.js");
+const errors_1 = require("./errors.js");
+const guards_1 = require("./guards.js");
+const types_1 = require("./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
+ * 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.
+ */
+function evaluate(rule, ctx) {
+    if ((0, builders_1.isRulePlaceholder)(rule)) {
+        return coerceForChannel(rule.channel, visit(rule.$rule, ctx, 0));
+    }
+    return visit(rule, ctx, 0);
+}
+function visit(node, ctx, 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;
+    switch (node.kind) {
+        case 'value':
+            return ctx.value;
+        case 'literal':
+            return (0, guards_1.literalValue)(node);
+        case 'equals':
+            return visit(node.left, ctx, next) === visit(node.right, ctx, next);
+        case 'isNot':
+            return visit(node.left, ctx, next) !== visit(node.right, ctx, next);
+        case 'lessThan':
+            return num(visit(node.left, ctx, next)) < num(visit(node.right, ctx, next));
+        case 'greaterThan':
+            return num(visit(node.left, ctx, next)) > num(visit(node.right, ctx, next));
+        case 'lessOrEqual':
+            return num(visit(node.left, ctx, next)) <= num(visit(node.right, ctx, next));
+        case 'greaterOrEqual':
+            return num(visit(node.left, ctx, next)) >= num(visit(node.right, ctx, next));
+        case 'ifElse':
+            return bool(visit(node.cond, ctx, next)) ? visit(node.then, ctx, next) : visit(node.else, ctx, next);
+        default:
+            return unreachable(node);
+    }
+}
+/* -------------------------------------------------------------------------- */
+/* Coercions — narrow a RuleValue, or throw a typed error.                      */
+/* -------------------------------------------------------------------------- */
+function num(value) {
+    if (typeof value === 'number') {
+        return value;
+    }
+    throw new errors_1.RuleTypeError(`expected a number, got ${typeName(value)}`);
+}
+function bool(value) {
+    if (typeof value === 'boolean') {
+        return value;
+    }
+    throw new errors_1.RuleTypeError(`expected a boolean, got ${typeName(value)}`);
+}
+/** A colour channel must resolve to a colour string, or null for "no override". */
+function asColor(value) {
+    if (value === null || typeof value === 'string') {
+        return value;
+    }
+    throw new errors_1.RuleTypeError(`a colour rule must resolve to a colour string or null, got ${typeName(value)}`);
+}
+/**
+ * Coerce a resolved value to what its channel can use. A colour rule must
+ * resolve to a colour; a future channel would add its own case here. A
+ * placeholder whose `channel` is missing or unrecognised (only possible from
+ * untrusted, deserialized input — the type and schema both pin it to `'color'`)
+ * is malformed rather than silently unchecked.
+ */
+function coerceForChannel(channel, value) {
+    switch (channel) {
+        case 'color':
+            return asColor(value);
+        default:
+            throw new errors_1.MalformedRuleError(`a rule placeholder has an unsupported channel: ${String(channel)}`);
+    }
+}
+function typeName(value) {
+    return value === null ? 'null' : typeof value;
+}
+function unreachable(node) {
+    throw new errors_1.UnknownNodeError(node.kind);
+}
+//# sourceMappingURL=evaluate.js.map

package/lib/charts/evaluate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"evaluate.js","sourceRoot":"","sources":["../../src/lib/charts/evaluate.ts"],"names":[],"mappings":";;AAyBA,4BAKC;AA9BD,4CAA+C;AAC/C,wCAA+F;AAC/F,wCAAwD;AACxD,sCAOiB;AAEjB;;;;;;;;;;;;GAYG;AACH,SAAgB,QAAQ,CAAC,IAAU,EAAE,GAAgB;IACnD,IAAI,IAAA,4BAAiB,EAAC,IAAI,CAAC,EAAE,CAAC;QAC5B,OAAO,gBAAgB,CAAC,IAAI,CAAC,OAAO,EAAE,KAAK,CAAC,IAAI,CAAC,KAAK,EAAE,GAAG,EAAE,CAAC,CAAC,CAAC,CAAC;IACnE,CAAC;IACD,OAAO,KAAK,CAAC,IAAI,EAAE,GAAG,EAAE,CAAC,CAAC,CAAC;AAC7B,CAAC;AAED,SAAS,KAAK,CAAC,IAAc,EAAE,GAAgB,EAAE,KAAa;IAC5D,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,GAAG,CAAC,KAAK,CAAC;QACnB,KAAK,SAAS;YACZ,OAAO,IAAA,qBAAY,EAAC,IAAI,CAAC,CAAC;QAE5B,KAAK,QAAQ;YACX,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,EAAE,GAAG,EAAE,IAAI,CAAC,KAAK,KAAK,CAAC,IAAI,CAAC,KAAK,EAAE,GAAG,EAAE,IAAI,CAAC,CAAC;QACtE,KAAK,OAAO;YACV,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,EAAE,GAAG,EAAE,IAAI,CAAC,KAAK,KAAK,CAAC,IAAI,CAAC,KAAK,EAAE,GAAG,EAAE,IAAI,CAAC,CAAC;QACtE,KAAK,UAAU;YACb,OAAO,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,EAAE,GAAG,EAAE,IAAI,CAAC,CAAC,GAAG,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,EAAE,GAAG,EAAE,IAAI,CAAC,CAAC,CAAC;QAC9E,KAAK,aAAa;YAChB,OAAO,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,EAAE,GAAG,EAAE,IAAI,CAAC,CAAC,GAAG,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,EAAE,GAAG,EAAE,IAAI,CAAC,CAAC,CAAC;QAC9E,KAAK,aAAa;YAChB,OAAO,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,EAAE,GAAG,EAAE,IAAI,CAAC,CAAC,IAAI,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,EAAE,GAAG,EAAE,IAAI,CAAC,CAAC,CAAC;QAC/E,KAAK,gBAAgB;YACnB,OAAO,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,EAAE,GAAG,EAAE,IAAI,CAAC,CAAC,IAAI,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,EAAE,GAAG,EAAE,IAAI,CAAC,CAAC,CAAC;QAE/E,KAAK,QAAQ;YACX,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,EAAE,GAAG,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,EAAE,GAAG,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,EAAE,GAAG,EAAE,IAAI,CAAC,CAAC;QAEvG;YACE,OAAO,WAAW,CAAC,IAAI,CAAC,CAAC;IAC7B,CAAC;AACH,CAAC;AAED,gFAAgF;AAChF,kFAAkF;AAClF,gFAAgF;AAEhF,SAAS,GAAG,CAAC,KAAgB;IAC3B,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,OAAO,KAAK,CAAC;IACf,CAAC;IACD,MAAM,IAAI,sBAAa,CAAC,0BAA0B,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;AACvE,CAAC;AAED,SAAS,IAAI,CAAC,KAAgB;IAC5B,IAAI,OAAO,KAAK,KAAK,SAAS,EAAE,CAAC;QAC/B,OAAO,KAAK,CAAC;IACf,CAAC;IACD,MAAM,IAAI,sBAAa,CAAC,2BAA2B,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;AACxE,CAAC;AAED,mFAAmF;AACnF,SAAS,OAAO,CAAC,KAAgB;IAC/B,IAAI,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAChD,OAAO,KAAK,CAAC;IACf,CAAC;IACD,MAAM,IAAI,sBAAa,CAAC,8DAA8D,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;AAC3G,CAAC;AAED;;;;;;GAMG;AACH,SAAS,gBAAgB,CAAC,OAAoB,EAAE,KAAgB;IAC9D,QAAQ,OAAO,EAAE,CAAC;QAChB,KAAK,OAAO;YACV,OAAO,OAAO,CAAC,KAAK,CAAC,CAAC;QACxB;YACE,MAAM,IAAI,2BAAkB,CAAC,kDAAkD,MAAM,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;IACtG,CAAC;AACH,CAAC;AAED,SAAS,QAAQ,CAAC,KAAgB;IAChC,OAAO,KAAK,KAAK,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,KAAK,CAAC;AAChD,CAAC;AAED,SAAS,WAAW,CAAC,IAAW;IAC9B,MAAM,IAAI,yBAAgB,CAAE,IAA0B,CAAC,IAAI,CAAC,CAAC;AAC/D,CAAC"}

package/lib/charts/evaluate.mjs

@@ -0,0 +1,96 @@
+import { isRulePlaceholder } from "./builders.mjs";
+import { MalformedRuleError, RuleDepthError, RuleTypeError, UnknownNodeError } from "./errors.mjs";
+import { assertRuleNode, literalValue } from "./guards.mjs";
+import { MAX_RULE_DEPTH, } 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
+ * 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.
+ */
+export function evaluate(rule, ctx) {
+    if (isRulePlaceholder(rule)) {
+        return coerceForChannel(rule.channel, visit(rule.$rule, ctx, 0));
+    }
+    return visit(rule, ctx, 0);
+}
+function visit(node, ctx, depth) {
+    if (depth > MAX_RULE_DEPTH) {
+        throw new RuleDepthError(MAX_RULE_DEPTH);
+    }
+    assertRuleNode(node);
+    const next = depth + 1;
+    switch (node.kind) {
+        case 'value':
+            return ctx.value;
+        case 'literal':
+            return literalValue(node);
+        case 'equals':
+            return visit(node.left, ctx, next) === visit(node.right, ctx, next);
+        case 'isNot':
+            return visit(node.left, ctx, next) !== visit(node.right, ctx, next);
+        case 'lessThan':
+            return num(visit(node.left, ctx, next)) < num(visit(node.right, ctx, next));
+        case 'greaterThan':
+            return num(visit(node.left, ctx, next)) > num(visit(node.right, ctx, next));
+        case 'lessOrEqual':
+            return num(visit(node.left, ctx, next)) <= num(visit(node.right, ctx, next));
+        case 'greaterOrEqual':
+            return num(visit(node.left, ctx, next)) >= num(visit(node.right, ctx, next));
+        case 'ifElse':
+            return bool(visit(node.cond, ctx, next)) ? visit(node.then, ctx, next) : visit(node.else, ctx, next);
+        default:
+            return unreachable(node);
+    }
+}
+/* -------------------------------------------------------------------------- */
+/* Coercions — narrow a RuleValue, or throw a typed error.                      */
+/* -------------------------------------------------------------------------- */
+function num(value) {
+    if (typeof value === 'number') {
+        return value;
+    }
+    throw new RuleTypeError(`expected a number, got ${typeName(value)}`);
+}
+function bool(value) {
+    if (typeof value === 'boolean') {
+        return value;
+    }
+    throw new RuleTypeError(`expected a boolean, got ${typeName(value)}`);
+}
+/** A colour channel must resolve to a colour string, or null for "no override". */
+function asColor(value) {
+    if (value === null || typeof value === 'string') {
+        return value;
+    }
+    throw new RuleTypeError(`a colour rule must resolve to a colour string or null, got ${typeName(value)}`);
+}
+/**
+ * Coerce a resolved value to what its channel can use. A colour rule must
+ * resolve to a colour; a future channel would add its own case here. A
+ * placeholder whose `channel` is missing or unrecognised (only possible from
+ * untrusted, deserialized input — the type and schema both pin it to `'color'`)
+ * is malformed rather than silently unchecked.
+ */
+function coerceForChannel(channel, value) {
+    switch (channel) {
+        case 'color':
+            return asColor(value);
+        default:
+            throw new MalformedRuleError(`a rule placeholder has an unsupported channel: ${String(channel)}`);
+    }
+}
+function typeName(value) {
+    return value === null ? 'null' : typeof value;
+}
+function unreachable(node) {
+    throw new UnknownNodeError(node.kind);
+}
+//# sourceMappingURL=evaluate.mjs.map

package/lib/charts/evaluate.mjs.map

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

package/lib/charts/guards.d.mts

@@ -0,0 +1,15 @@
+import { type RuleNode, type Scalar } from "./types.mjs";
+/**
+ * Assert `node` is shaped like a rule node — an object carrying a string `kind`.
+ * An unrecognised `kind` is *not* rejected here; that is the caller's `switch`
+ * default (`UnknownNodeError`), the deliberate "configured in code" signal.
+ */
+export declare function assertRuleNode(node: unknown): asserts node is RuleNode;
+/**
+ * Read a `literal` node's `value`, rejecting a missing or non-scalar one. Without
+ * this, `{ kind: 'literal' }` resolves to `undefined` and slips past the caller.
+ */
+export declare function literalValue(node: {
+    value?: unknown;
+}): Scalar;
+//# sourceMappingURL=guards.d.mts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"guards.d.mts","sourceRoot":"","sources":["../../src/lib/charts/guards.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,QAAQ,EAAE,KAAK,MAAM,EAAE,oBAAgB;AAYrD;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,IAAI,QAAQ,CAStE;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE;IAAE,KAAK,CAAC,EAAE,OAAO,CAAA;CAAE,GAAG,MAAM,CAQ9D"}

package/lib/charts/guards.d.ts

@@ -0,0 +1,15 @@
+import { type RuleNode, type Scalar } from "./types.js";
+/**
+ * Assert `node` is shaped like a rule node — an object carrying a string `kind`.
+ * An unrecognised `kind` is *not* rejected here; that is the caller's `switch`
+ * default (`UnknownNodeError`), the deliberate "configured in code" signal.
+ */
+export declare function assertRuleNode(node: unknown): asserts node is RuleNode;
+/**
+ * Read a `literal` node's `value`, rejecting a missing or non-scalar one. Without
+ * this, `{ kind: 'literal' }` resolves to `undefined` and slips past the caller.
+ */
+export declare function literalValue(node: {
+    value?: unknown;
+}): Scalar;
+//# sourceMappingURL=guards.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"guards.d.ts","sourceRoot":"","sources":["../../src/lib/charts/guards.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,QAAQ,EAAE,KAAK,MAAM,EAAE,mBAAgB;AAYrD;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,IAAI,QAAQ,CAStE;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE;IAAE,KAAK,CAAC,EAAE,OAAO,CAAA;CAAE,GAAG,MAAM,CAQ9D"}