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

package/lib/charts/schema.mjs

@@ -1,71 +1,191 @@
+import { boolean, finite, literal, null_, number, picklist, pipe, safeParse, strictObject, string, summarize, union, variant, } from 'valibot';
+import { MalformedRuleError, UnknownNodeError } from "./errors.mjs";
 import { CHART_RULE_CONTRACT_VERSION } from "./types.mjs";
-/** Stable identifier for the published contract, versioned by the tag. */
+import { EQUALITY_COMPARISON_KINDS, NUMERIC_COMPARISON_KINDS, RULE_CHANNELS, RULE_NODE_KINDS, } from "./vocabulary.mjs";
+const ruleNodeKinds = new Set(RULE_NODE_KINDS);
+const placeholderKeys = new Set(['$rule', 'channel']);
+const ruleFieldKeys = ['$rule', 'channel', 'kind', 'value', 'left', 'right', 'cond', 'then', 'else'];
+const scalarSchema = union([
+    pipe(number(), finite()),
+    string(),
+    boolean(),
+    null_(),
+]);
+const parsedRules = new WeakSet();
+/** @deprecated Use `CHART_RULE_CONTRACT_VERSION` to identify the executable contract. */
 export const CHART_RULE_SCHEMA_ID = `https://rippling.com/schemas/${CHART_RULE_CONTRACT_VERSION}.json`;
+function hasOwn(value, key) {
+    return Object.prototype.hasOwnProperty.call(value, key);
+}
+const refNodeSchema = strictObject({ kind: literal('value') });
+const literalNodeSchema = strictObject({ kind: literal('literal'), value: scalarSchema });
+const numericLiteralNodeSchema = strictObject({
+    kind: literal('literal'),
+    value: pipe(number(), finite()),
+});
+const requiredColorLiteralNodeSchema = strictObject({
+    kind: literal('literal'),
+    value: string(),
+});
+const optionalColorLiteralNodeSchema = strictObject({
+    kind: literal('literal'),
+    value: union([string(), null_()]),
+});
+const comparisonOperandSchema = variant('kind', [refNodeSchema, literalNodeSchema]);
+const numericOperandSchema = variant('kind', [refNodeSchema, numericLiteralNodeSchema]);
+const equalityComparisonNodeSchema = strictObject({
+    kind: picklist(EQUALITY_COMPARISON_KINDS),
+    left: comparisonOperandSchema,
+    right: comparisonOperandSchema,
+});
+const numericComparisonNodeSchema = strictObject({
+    kind: picklist(NUMERIC_COMPARISON_KINDS),
+    left: numericOperandSchema,
+    right: numericOperandSchema,
+});
+const comparisonNodeSchema = variant('kind', [equalityComparisonNodeSchema, numericComparisonNodeSchema]);
+const ifElseNodeSchema = strictObject({
+    kind: literal('ifElse'),
+    cond: comparisonNodeSchema,
+    then: requiredColorLiteralNodeSchema,
+    else: optionalColorLiteralNodeSchema,
+});
 /**
- * JSON Schema (2020-12) for the `{$rule}` placeholder and its closed node set.
+ * Executable runtime schema for a chart-rule node.
  *
- * This is the contract. A consumer that keeps its own rule evaluator (rather
- * than importing `evaluate`) can validate against this so the two never drift —
- * every kind and operand shape the builders can emit is described here.
+ * v1 is intentionally non-recursive. A comparison contains only `value` or
+ * literal operands, and a conditional contains one comparison plus two colour
+ * literals. Contract tests prove that every public builder output parses.
  */
-export const chartRuleSchema = {
-    $schema: 'https://json-schema.org/draft/2020-12/schema',
-    $id: CHART_RULE_SCHEMA_ID,
-    title: 'Chart rule placeholder',
-    description: 'A rule tree the chart agent emits into a chart option, marked with $rule.',
-    type: 'object',
-    required: ['$rule', 'channel'],
-    additionalProperties: false,
-    properties: {
-        // A colour rule's top-level tree is the conditional-value form (`when(...)`),
-        // matching what `color()` builds and accepts. A bare ref/comparison/literal
-        // resolves to a number/boolean/constant, not a colour decision.
-        $rule: { $ref: '#/$defs/ifElse' },
-        channel: { const: 'color' },
-    },
-    $defs: {
-        scalar: { type: ['number', 'string', 'boolean', 'null'] },
-        node: {
-            oneOf: [
-                { $ref: '#/$defs/ref' },
-                { $ref: '#/$defs/literal' },
-                { $ref: '#/$defs/comparison' },
-                { $ref: '#/$defs/ifElse' },
-            ],
-        },
-        ref: {
-            type: 'object',
-            required: ['kind'],
-            additionalProperties: false,
-            properties: { kind: { const: 'value' } },
-        },
-        literal: {
-            type: 'object',
-            required: ['kind', 'value'],
-            additionalProperties: false,
-            properties: { kind: { const: 'literal' }, value: { $ref: '#/$defs/scalar' } },
-        },
-        comparison: {
-            type: 'object',
-            required: ['kind', 'left', 'right'],
-            additionalProperties: false,
-            properties: {
-                kind: { enum: ['equals', 'isNot', 'lessThan', 'greaterThan', 'lessOrEqual', 'greaterOrEqual'] },
-                left: { $ref: '#/$defs/node' },
-                right: { $ref: '#/$defs/node' },
-            },
-        },
-        ifElse: {
-            type: 'object',
-            required: ['kind', 'cond', 'then', 'else'],
-            additionalProperties: false,
-            properties: {
-                kind: { const: 'ifElse' },
-                cond: { $ref: '#/$defs/node' },
-                then: { $ref: '#/$defs/node' },
-                else: { $ref: '#/$defs/node' },
-            },
-        },
-    },
-};
+const ruleNodeSchema = variant('kind', [
+    refNodeSchema,
+    literalNodeSchema,
+    equalityComparisonNodeSchema,
+    numericComparisonNodeSchema,
+    ifElseNodeSchema,
+]);
+/** Runtime schema for the `{$rule, channel}` value embedded in a chart option. */
+const rulePlaceholderSchema = strictObject({
+    $rule: ifElseNodeSchema,
+    channel: picklist(RULE_CHANNELS),
+});
+/**
+ * Runtime schema for either a bare rule node or a chart-option placeholder.
+ * Persisted and agent-authored JSON crosses this boundary as `unknown`.
+ */
+export const chartRuleSchema = union([
+    rulePlaceholderSchema,
+    ruleNodeSchema,
+]);
+/** Parse untrusted chart-rule JSON and return an immutable validated clone. */
+export function parseChartRule(input) {
+    if (isParsedRule(input)) {
+        return input;
+    }
+    preflight(input);
+    const result = safeParse(chartRuleSchema, input);
+    if (result.success) {
+        return markParsedRule(result.output);
+    }
+    throw new MalformedRuleError(summarize(result.issues));
+}
+/**
+ * Valibot's object schemas use `key in input`, which also reads inherited
+ * properties. Reject inherited rule fields before parsing so prototype data
+ * cannot supply required operands or bypass the flat v1 contract.
+ */
+function preflight(input) {
+    assertNoInheritedRuleFields(input);
+    const root = unwrapPlaceholder(input);
+    assertNoInheritedRuleFields(root);
+    assertKnownNode(root);
+    if (!isRecord(root) || !hasOwn(root, 'kind')) {
+        return;
+    }
+    if (root['kind'] === 'ifElse') {
+        inspectChildren(root, ['cond', 'then', 'else']);
+        const condition = root['cond'];
+        inspectComparison(condition);
+    }
+    else if (typeof root['kind'] === 'string' && isComparisonKind(root['kind'])) {
+        inspectComparison(root);
+    }
+}
+function inspectComparison(value) {
+    assertNoInheritedRuleFields(value);
+    assertKnownNode(value);
+    if (isRecord(value)) {
+        inspectChildren(value, ['left', 'right']);
+    }
+}
+function inspectChildren(parent, keys) {
+    for (const key of keys) {
+        if (hasOwn(parent, key)) {
+            const child = parent[key];
+            assertNoInheritedRuleFields(child);
+            assertKnownNode(child);
+        }
+    }
+}
+function assertNoInheritedRuleFields(value) {
+    if (!isRecord(value)) {
+        return;
+    }
+    for (const key of ruleFieldKeys) {
+        if (key in value && !hasOwn(value, key)) {
+            throw new MalformedRuleError(`a chart rule must not inherit the ${key} property`);
+        }
+    }
+}
+function assertKnownNode(value) {
+    if (isRecord(value) &&
+        hasOwn(value, 'kind') &&
+        typeof value['kind'] === 'string' &&
+        !ruleNodeKinds.has(value['kind'])) {
+        throw new UnknownNodeError(value['kind']);
+    }
+}
+function isComparisonKind(kind) {
+    return kind !== 'literal' && kind !== 'value' && kind !== 'ifElse' && ruleNodeKinds.has(kind);
+}
+function isRecord(value) {
+    return value !== null && typeof value === 'object' && !Array.isArray(value);
+}
+function unwrapPlaceholder(input) {
+    if (input === null || typeof input !== 'object' || Array.isArray(input) || !hasOwn(input, '$rule')) {
+        return input;
+    }
+    const unexpectedKey = Object.keys(input).find((key) => !placeholderKeys.has(key));
+    if (unexpectedKey !== undefined) {
+        throw new MalformedRuleError(`a rule placeholder has an unexpected property: ${unexpectedKey}`);
+    }
+    return input.$rule;
+}
+function isParsedRule(input) {
+    return input !== null && typeof input === 'object' && !Array.isArray(input) && parsedRules.has(input);
+}
+/**
+ * Mark the validated clone so `evaluate(parseChartRule(input), ctx)` does not
+ * reparse the full value for every datum. Freezing prevents a caller from
+ * mutating a trusted value after validation.
+ */
+function markParsedRule(rule) {
+    const stack = [rule];
+    const seen = new WeakSet();
+    while (stack.length > 0) {
+        const current = stack.pop();
+        if (!current || seen.has(current)) {
+            continue;
+        }
+        seen.add(current);
+        for (const value of Object.values(current)) {
+            if (value !== null && typeof value === 'object') {
+                stack.push(value);
+            }
+        }
+        Object.freeze(current);
+    }
+    parsedRules.add(rule);
+    return rule;
+}
 //# sourceMappingURL=schema.mjs.map

package/lib/charts/schema.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"schema.mjs","sourceRoot":"","sources":["../../src/lib/charts/schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,2BAA2B,EAAE,oBAAgB;AAEtD,0EAA0E;AAC1E,MAAM,CAAC,MAAM,oBAAoB,GAAG,gCAAgC,2BAA2B,OAAO,CAAC;AAEvG;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG;IAC7B,OAAO,EAAE,8CAA8C;IACvD,GAAG,EAAE,oBAAoB;IACzB,KAAK,EAAE,wBAAwB;IAC/B,WAAW,EAAE,2EAA2E;IACxF,IAAI,EAAE,QAAQ;IACd,QAAQ,EAAE,CAAC,OAAO,EAAE,SAAS,CAAC;IAC9B,oBAAoB,EAAE,KAAK;IAC3B,UAAU,EAAE;QACV,8EAA8E;QAC9E,4EAA4E;QAC5E,gEAAgE;QAChE,KAAK,EAAE,EAAE,IAAI,EAAE,gBAAgB,EAAE;QACjC,OAAO,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE;KAC5B;IACD,KAAK,EAAE;QACL,MAAM,EAAE,EAAE,IAAI,EAAE,CAAC,QAAQ,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,CAAC,EAAE;QACzD,IAAI,EAAE;YACJ,KAAK,EAAE;gBACL,EAAE,IAAI,EAAE,aAAa,EAAE;gBACvB,EAAE,IAAI,EAAE,iBAAiB,EAAE;gBAC3B,EAAE,IAAI,EAAE,oBAAoB,EAAE;gBAC9B,EAAE,IAAI,EAAE,gBAAgB,EAAE;aAC3B;SACF;QACD,GAAG,EAAE;YACH,IAAI,EAAE,QAAQ;YACd,QAAQ,EAAE,CAAC,MAAM,CAAC;YAClB,oBAAoB,EAAE,KAAK;YAC3B,UAAU,EAAE,EAAE,IAAI,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE;SACzC;QACD,OAAO,EAAE;YACP,IAAI,EAAE,QAAQ;YACd,QAAQ,EAAE,CAAC,MAAM,EAAE,OAAO,CAAC;YAC3B,oBAAoB,EAAE,KAAK;YAC3B,UAAU,EAAE,EAAE,IAAI,EAAE,EAAE,KAAK,EAAE,SAAS,EAAE,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,gBAAgB,EAAE,EAAE;SAC9E;QACD,UAAU,EAAE;YACV,IAAI,EAAE,QAAQ;YACd,QAAQ,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC;YACnC,oBAAoB,EAAE,KAAK;YAC3B,UAAU,EAAE;gBACV,IAAI,EAAE,EAAE,IAAI,EAAE,CAAC,QAAQ,EAAE,OAAO,EAAE,UAAU,EAAE,aAAa,EAAE,aAAa,EAAE,gBAAgB,CAAC,EAAE;gBAC/F,IAAI,EAAE,EAAE,IAAI,EAAE,cAAc,EAAE;gBAC9B,KAAK,EAAE,EAAE,IAAI,EAAE,cAAc,EAAE;aAChC;SACF;QACD,MAAM,EAAE;YACN,IAAI,EAAE,QAAQ;YACd,QAAQ,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC;YAC1C,oBAAoB,EAAE,KAAK;YAC3B,UAAU,EAAE;gBACV,IAAI,EAAE,EAAE,KAAK,EAAE,QAAQ,EAAE;gBACzB,IAAI,EAAE,EAAE,IAAI,EAAE,cAAc,EAAE;gBAC9B,IAAI,EAAE,EAAE,IAAI,EAAE,cAAc,EAAE;gBAC9B,IAAI,EAAE,EAAE,IAAI,EAAE,cAAc,EAAE;aAC/B;SACF;KACF;CACO,CAAC"}
+{"version":3,"file":"schema.mjs","sourceRoot":"","sources":["../../src/lib/charts/schema.ts"],"names":[],"mappings":"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"}

package/lib/charts/types.d.mts

@@ -1,17 +1,20 @@
 /**
  * Chart rule vocabulary — shared types.
  *
- * A rule is a small, serializable tree of nodes discriminated by `kind`. The
+ * A rule is a small, serializable value discriminated by `kind`. The
  * agent builds it with the helpers in `builders.ts`, which emit it wrapped in a
  * `{$rule}` placeholder — the same idea as the `{$fn}` placeholders a chart
  * already emits. The renderer resolves it with `evaluate`; the settings panel
  * reads it with `describe`. All three agree because a node can only ever be one
- * of the kinds defined here — the closed set the `chartRuleSchema` describes.
+ * of the kinds defined here — the closed set the executable `chartRuleSchema`
+ * validates at runtime.
  *
- * v1 is scoped to conditional formatting: compare this datum's `value` against a
- * constant, and (optionally) pick between two values. Richer pieces — aggregates,
- * logic, more refs — are the documented roadmap in the README.
+ * v1 is deliberately non-recursive: compare this datum's `value` or a literal
+ * against another literal, then choose between two colour literals. Rules may
+ * not appear inside operands or branches. Richer expressions require a future
+ * contract version.
  */
+import { COMPARISON_KINDS, RULE_CHANNELS } from "./vocabulary.mjs";
 export declare const CHART_RULE_CONTRACT_VERSION: "chart_rule.v1";
 export type ChartRuleContractVersion = typeof CHART_RULE_CONTRACT_VERSION;
 /** A leaf value a rule can carry or resolve to. */
@@ -20,53 +23,64 @@ export type Scalar = number | string | boolean | null;
 export type RefNode = {
     kind: 'value';
 };
-export interface LiteralNode {
+export interface LiteralNode<TValue extends Scalar = Scalar> {
     kind: 'literal';
-    value: Scalar;
+    value: TValue;
 }
-export type ComparisonKind = 'equals' | 'isNot' | 'lessThan' | 'greaterThan' | 'lessOrEqual' | 'greaterOrEqual';
-export interface ComparisonNode {
-    kind: ComparisonKind;
-    left: RuleNode;
-    right: RuleNode;
+export type ComparisonOperandNode = RefNode | LiteralNode;
+export type NumericOperandNode = RefNode | LiteralNode<number>;
+export type ComparisonKind = (typeof COMPARISON_KINDS)[number];
+export interface EqualityComparisonNode {
+    kind: 'equals' | 'isNot';
+    left: ComparisonOperandNode;
+    right: ComparisonOperandNode;
 }
+export interface NumericComparisonNode {
+    kind: Exclude<ComparisonKind, EqualityComparisonNode['kind']>;
+    left: NumericOperandNode;
+    right: NumericOperandNode;
+}
+export type ComparisonNode = EqualityComparisonNode | NumericComparisonNode;
+/** A node whose evaluated result is valid as a `when(...)` condition in v1. */
+export type ConditionNode = ComparisonNode;
 /** The conditional-value form produced by `when(cond, then, else)`. */
 export interface IfElseNode {
     kind: 'ifElse';
-    cond: RuleNode;
-    then: RuleNode;
-    else: RuleNode;
+    cond: ConditionNode;
+    then: LiteralNode<string>;
+    else: LiteralNode<string | null>;
 }
-/** Any node of a rule tree. */
+/** Any top-level node accepted by the v1 runtime boundary. */
 export type RuleNode = RefNode | LiteralNode | ComparisonNode | IfElseNode;
 /**
  * The chart channel a rule drives. v1 supports colour only — a rule decides the
  * colour of a series/datum. Other channels (opacity, label visibility, …) are
  * the documented roadmap and would be added here.
  */
-export type RuleChannel = 'color';
+export type RuleChannel = (typeof RULE_CHANNELS)[number];
 /**
- * What a builder returns: a rule tree, marked so the renderer can find it, and
+ * What a builder returns: a flat rule value, marked so the renderer can find it, and
  * tagged with the channel it targets. `channel: 'color'` says this resolves to a
  * colour — so a reader sees the target without inferring it from where it sits.
  */
 export interface RulePlaceholder {
-    $rule: RuleNode;
+    $rule: IfElseNode;
     channel: RuleChannel;
 }
-/** A placeholder, or the bare tree — what `evaluate` and `describe` accept. */
+/** A placeholder, or a bare node — what `evaluate` and `describe` accept. */
 export type Rule = RulePlaceholder | RuleNode;
+type DeepReadonly<T> = T extends object ? {
+    readonly [Key in keyof T]: DeepReadonly<T[Key]>;
+} : T;
+/** The deeply frozen value returned by `parseChartRule`. */
+export type ParsedRule = DeepReadonly<Rule>;
 /** What a rule is evaluated against: the current datum's value. */
 export interface RuleContext {
     value: number;
 }
 /** The result of evaluating a node. */
 export type RuleValue = Scalar;
-/**
- * The deepest a rule may nest before `evaluate`/`describe` refuse it. Real rules
- * are a handful of levels; this only stops a pathological deserialized tree from
- * overflowing the stack. Far below the JS call-stack limit.
- */
+/** @deprecated v1 is non-recursive. Retained for source compatibility. */
 export declare const MAX_RULE_DEPTH = 256;
 export type ControlRole = 'rule' | 'comparison' | 'ref' | 'literal';
 /** A node as the panel should show it: a label, its editable value, its parts. */
@@ -76,4 +90,5 @@ export interface Control {
     value?: Scalar;
     parts?: Control[];
 }
+export {};
 //# sourceMappingURL=types.d.mts.map

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

@@ -1 +1 @@
-{"version":3,"file":"types.d.mts","sourceRoot":"","sources":["../../src/lib/charts/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,eAAO,MAAM,2BAA2B,EAAG,eAAwB,CAAC;AACpE,MAAM,MAAM,wBAAwB,GAAG,OAAO,2BAA2B,CAAC;AAE1E,mDAAmD;AACnD,MAAM,MAAM,MAAM,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,CAAC;AAMtD,gFAAgF;AAChF,MAAM,MAAM,OAAO,GAAG;IAAE,IAAI,EAAE,OAAO,CAAA;CAAE,CAAC;AAExC,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,SAAS,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,MAAM,cAAc,GACtB,QAAQ,GACR,OAAO,GACP,UAAU,GACV,aAAa,GACb,aAAa,GACb,gBAAgB,CAAC;AACrB,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,cAAc,CAAC;IACrB,IAAI,EAAE,QAAQ,CAAC;IACf,KAAK,EAAE,QAAQ,CAAC;CACjB;AAED,uEAAuE;AACvE,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,QAAQ,CAAC;IACf,IAAI,EAAE,QAAQ,CAAC;IACf,IAAI,EAAE,QAAQ,CAAC;IACf,IAAI,EAAE,QAAQ,CAAC;CAChB;AAED,+BAA+B;AAC/B,MAAM,MAAM,QAAQ,GAAG,OAAO,GAAG,WAAW,GAAG,cAAc,GAAG,UAAU,CAAC;AAM3E;;;;GAIG;AACH,MAAM,MAAM,WAAW,GAAG,OAAO,CAAC;AAElC;;;;GAIG;AACH,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,QAAQ,CAAC;IAChB,OAAO,EAAE,WAAW,CAAC;CACtB;AAED,+EAA+E;AAC/E,MAAM,MAAM,IAAI,GAAG,eAAe,GAAG,QAAQ,CAAC;AAM9C,mEAAmE;AACnE,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,MAAM,CAAC;CACf;AAED,uCAAuC;AACvC,MAAM,MAAM,SAAS,GAAG,MAAM,CAAC;AAE/B;;;;GAIG;AACH,eAAO,MAAM,cAAc,MAAM,CAAC;AAMlC,MAAM,MAAM,WAAW,GAAG,MAAM,GAAG,YAAY,GAAG,KAAK,GAAG,SAAS,CAAC;AAEpE,kFAAkF;AAClF,MAAM,WAAW,OAAO;IACtB,IAAI,EAAE,WAAW,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,OAAO,EAAE,CAAC;CACnB"}
+{"version":3,"file":"types.d.mts","sourceRoot":"","sources":["../../src/lib/charts/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,EAAE,gBAAgB,EAAE,aAAa,EAAE,yBAAqB;AAE/D,eAAO,MAAM,2BAA2B,EAAG,eAAwB,CAAC;AACpE,MAAM,MAAM,wBAAwB,GAAG,OAAO,2BAA2B,CAAC;AAE1E,mDAAmD;AACnD,MAAM,MAAM,MAAM,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,CAAC;AAMtD,gFAAgF;AAChF,MAAM,MAAM,OAAO,GAAG;IAAE,IAAI,EAAE,OAAO,CAAA;CAAE,CAAC;AAExC,MAAM,WAAW,WAAW,CAAC,MAAM,SAAS,MAAM,GAAG,MAAM;IACzD,IAAI,EAAE,SAAS,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,MAAM,qBAAqB,GAAG,OAAO,GAAG,WAAW,CAAC;AAC1D,MAAM,MAAM,kBAAkB,GAAG,OAAO,GAAG,WAAW,CAAC,MAAM,CAAC,CAAC;AAE/D,MAAM,MAAM,cAAc,GAAG,CAAC,OAAO,gBAAgB,CAAC,CAAC,MAAM,CAAC,CAAC;AAC/D,MAAM,WAAW,sBAAsB;IACrC,IAAI,EAAE,QAAQ,GAAG,OAAO,CAAC;IACzB,IAAI,EAAE,qBAAqB,CAAC;IAC5B,KAAK,EAAE,qBAAqB,CAAC;CAC9B;AACD,MAAM,WAAW,qBAAqB;IACpC,IAAI,EAAE,OAAO,CAAC,cAAc,EAAE,sBAAsB,CAAC,MAAM,CAAC,CAAC,CAAC;IAC9D,IAAI,EAAE,kBAAkB,CAAC;IACzB,KAAK,EAAE,kBAAkB,CAAC;CAC3B;AACD,MAAM,MAAM,cAAc,GAAG,sBAAsB,GAAG,qBAAqB,CAAC;AAE5E,+EAA+E;AAC/E,MAAM,MAAM,aAAa,GAAG,cAAc,CAAC;AAE3C,uEAAuE;AACvE,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,QAAQ,CAAC;IACf,IAAI,EAAE,aAAa,CAAC;IACpB,IAAI,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;IAC1B,IAAI,EAAE,WAAW,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;CAClC;AAED,8DAA8D;AAC9D,MAAM,MAAM,QAAQ,GAAG,OAAO,GAAG,WAAW,GAAG,cAAc,GAAG,UAAU,CAAC;AAM3E;;;;GAIG;AACH,MAAM,MAAM,WAAW,GAAG,CAAC,OAAO,aAAa,CAAC,CAAC,MAAM,CAAC,CAAC;AAEzD;;;;GAIG;AACH,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,UAAU,CAAC;IAClB,OAAO,EAAE,WAAW,CAAC;CACtB;AAED,6EAA6E;AAC7E,MAAM,MAAM,IAAI,GAAG,eAAe,GAAG,QAAQ,CAAC;AAE9C,KAAK,YAAY,CAAC,CAAC,IAAI,CAAC,SAAS,MAAM,GAAG;IAAE,QAAQ,EAAE,GAAG,IAAI,MAAM,CAAC,GAAG,YAAY,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;CAAE,GAAG,CAAC,CAAC;AAElG,4DAA4D;AAC5D,MAAM,MAAM,UAAU,GAAG,YAAY,CAAC,IAAI,CAAC,CAAC;AAM5C,mEAAmE;AACnE,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,MAAM,CAAC;CACf;AAED,uCAAuC;AACvC,MAAM,MAAM,SAAS,GAAG,MAAM,CAAC;AAE/B,0EAA0E;AAC1E,eAAO,MAAM,cAAc,MAAM,CAAC;AAMlC,MAAM,MAAM,WAAW,GAAG,MAAM,GAAG,YAAY,GAAG,KAAK,GAAG,SAAS,CAAC;AAEpE,kFAAkF;AAClF,MAAM,WAAW,OAAO;IACtB,IAAI,EAAE,WAAW,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,OAAO,EAAE,CAAC;CACnB"}

package/lib/charts/types.d.ts

@@ -1,17 +1,20 @@
 /**
  * Chart rule vocabulary — shared types.
  *
- * A rule is a small, serializable tree of nodes discriminated by `kind`. The
+ * A rule is a small, serializable value discriminated by `kind`. The
  * agent builds it with the helpers in `builders.ts`, which emit it wrapped in a
  * `{$rule}` placeholder — the same idea as the `{$fn}` placeholders a chart
  * already emits. The renderer resolves it with `evaluate`; the settings panel
  * reads it with `describe`. All three agree because a node can only ever be one
- * of the kinds defined here — the closed set the `chartRuleSchema` describes.
+ * of the kinds defined here — the closed set the executable `chartRuleSchema`
+ * validates at runtime.
  *
- * v1 is scoped to conditional formatting: compare this datum's `value` against a
- * constant, and (optionally) pick between two values. Richer pieces — aggregates,
- * logic, more refs — are the documented roadmap in the README.
+ * v1 is deliberately non-recursive: compare this datum's `value` or a literal
+ * against another literal, then choose between two colour literals. Rules may
+ * not appear inside operands or branches. Richer expressions require a future
+ * contract version.
  */
+import { COMPARISON_KINDS, RULE_CHANNELS } from "./vocabulary.js";
 export declare const CHART_RULE_CONTRACT_VERSION: "chart_rule.v1";
 export type ChartRuleContractVersion = typeof CHART_RULE_CONTRACT_VERSION;
 /** A leaf value a rule can carry or resolve to. */
@@ -20,53 +23,64 @@ export type Scalar = number | string | boolean | null;
 export type RefNode = {
     kind: 'value';
 };
-export interface LiteralNode {
+export interface LiteralNode<TValue extends Scalar = Scalar> {
     kind: 'literal';
-    value: Scalar;
+    value: TValue;
 }
-export type ComparisonKind = 'equals' | 'isNot' | 'lessThan' | 'greaterThan' | 'lessOrEqual' | 'greaterOrEqual';
-export interface ComparisonNode {
-    kind: ComparisonKind;
-    left: RuleNode;
-    right: RuleNode;
+export type ComparisonOperandNode = RefNode | LiteralNode;
+export type NumericOperandNode = RefNode | LiteralNode<number>;
+export type ComparisonKind = (typeof COMPARISON_KINDS)[number];
+export interface EqualityComparisonNode {
+    kind: 'equals' | 'isNot';
+    left: ComparisonOperandNode;
+    right: ComparisonOperandNode;
 }
+export interface NumericComparisonNode {
+    kind: Exclude<ComparisonKind, EqualityComparisonNode['kind']>;
+    left: NumericOperandNode;
+    right: NumericOperandNode;
+}
+export type ComparisonNode = EqualityComparisonNode | NumericComparisonNode;
+/** A node whose evaluated result is valid as a `when(...)` condition in v1. */
+export type ConditionNode = ComparisonNode;
 /** The conditional-value form produced by `when(cond, then, else)`. */
 export interface IfElseNode {
     kind: 'ifElse';
-    cond: RuleNode;
-    then: RuleNode;
-    else: RuleNode;
+    cond: ConditionNode;
+    then: LiteralNode<string>;
+    else: LiteralNode<string | null>;
 }
-/** Any node of a rule tree. */
+/** Any top-level node accepted by the v1 runtime boundary. */
 export type RuleNode = RefNode | LiteralNode | ComparisonNode | IfElseNode;
 /**
  * The chart channel a rule drives. v1 supports colour only — a rule decides the
  * colour of a series/datum. Other channels (opacity, label visibility, …) are
  * the documented roadmap and would be added here.
  */
-export type RuleChannel = 'color';
+export type RuleChannel = (typeof RULE_CHANNELS)[number];
 /**
- * What a builder returns: a rule tree, marked so the renderer can find it, and
+ * What a builder returns: a flat rule value, marked so the renderer can find it, and
  * tagged with the channel it targets. `channel: 'color'` says this resolves to a
  * colour — so a reader sees the target without inferring it from where it sits.
  */
 export interface RulePlaceholder {
-    $rule: RuleNode;
+    $rule: IfElseNode;
     channel: RuleChannel;
 }
-/** A placeholder, or the bare tree — what `evaluate` and `describe` accept. */
+/** A placeholder, or a bare node — what `evaluate` and `describe` accept. */
 export type Rule = RulePlaceholder | RuleNode;
+type DeepReadonly<T> = T extends object ? {
+    readonly [Key in keyof T]: DeepReadonly<T[Key]>;
+} : T;
+/** The deeply frozen value returned by `parseChartRule`. */
+export type ParsedRule = DeepReadonly<Rule>;
 /** What a rule is evaluated against: the current datum's value. */
 export interface RuleContext {
     value: number;
 }
 /** The result of evaluating a node. */
 export type RuleValue = Scalar;
-/**
- * The deepest a rule may nest before `evaluate`/`describe` refuse it. Real rules
- * are a handful of levels; this only stops a pathological deserialized tree from
- * overflowing the stack. Far below the JS call-stack limit.
- */
+/** @deprecated v1 is non-recursive. Retained for source compatibility. */
 export declare const MAX_RULE_DEPTH = 256;
 export type ControlRole = 'rule' | 'comparison' | 'ref' | 'literal';
 /** A node as the panel should show it: a label, its editable value, its parts. */
@@ -76,4 +90,5 @@ export interface Control {
     value?: Scalar;
     parts?: Control[];
 }
+export {};
 //# sourceMappingURL=types.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/lib/charts/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,eAAO,MAAM,2BAA2B,EAAG,eAAwB,CAAC;AACpE,MAAM,MAAM,wBAAwB,GAAG,OAAO,2BAA2B,CAAC;AAE1E,mDAAmD;AACnD,MAAM,MAAM,MAAM,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,CAAC;AAMtD,gFAAgF;AAChF,MAAM,MAAM,OAAO,GAAG;IAAE,IAAI,EAAE,OAAO,CAAA;CAAE,CAAC;AAExC,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,SAAS,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,MAAM,cAAc,GACtB,QAAQ,GACR,OAAO,GACP,UAAU,GACV,aAAa,GACb,aAAa,GACb,gBAAgB,CAAC;AACrB,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,cAAc,CAAC;IACrB,IAAI,EAAE,QAAQ,CAAC;IACf,KAAK,EAAE,QAAQ,CAAC;CACjB;AAED,uEAAuE;AACvE,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,QAAQ,CAAC;IACf,IAAI,EAAE,QAAQ,CAAC;IACf,IAAI,EAAE,QAAQ,CAAC;IACf,IAAI,EAAE,QAAQ,CAAC;CAChB;AAED,+BAA+B;AAC/B,MAAM,MAAM,QAAQ,GAAG,OAAO,GAAG,WAAW,GAAG,cAAc,GAAG,UAAU,CAAC;AAM3E;;;;GAIG;AACH,MAAM,MAAM,WAAW,GAAG,OAAO,CAAC;AAElC;;;;GAIG;AACH,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,QAAQ,CAAC;IAChB,OAAO,EAAE,WAAW,CAAC;CACtB;AAED,+EAA+E;AAC/E,MAAM,MAAM,IAAI,GAAG,eAAe,GAAG,QAAQ,CAAC;AAM9C,mEAAmE;AACnE,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,MAAM,CAAC;CACf;AAED,uCAAuC;AACvC,MAAM,MAAM,SAAS,GAAG,MAAM,CAAC;AAE/B;;;;GAIG;AACH,eAAO,MAAM,cAAc,MAAM,CAAC;AAMlC,MAAM,MAAM,WAAW,GAAG,MAAM,GAAG,YAAY,GAAG,KAAK,GAAG,SAAS,CAAC;AAEpE,kFAAkF;AAClF,MAAM,WAAW,OAAO;IACtB,IAAI,EAAE,WAAW,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,OAAO,EAAE,CAAC;CACnB"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/lib/charts/types.ts"],"names":[],"mappings":"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"}

package/lib/charts/types.js

@@ -2,24 +2,22 @@
 /**
  * Chart rule vocabulary — shared types.
  *
- * A rule is a small, serializable tree of nodes discriminated by `kind`. The
+ * A rule is a small, serializable value discriminated by `kind`. The
  * agent builds it with the helpers in `builders.ts`, which emit it wrapped in a
  * `{$rule}` placeholder — the same idea as the `{$fn}` placeholders a chart
  * already emits. The renderer resolves it with `evaluate`; the settings panel
  * reads it with `describe`. All three agree because a node can only ever be one
- * of the kinds defined here — the closed set the `chartRuleSchema` describes.
+ * of the kinds defined here — the closed set the executable `chartRuleSchema`
+ * validates at runtime.
  *
- * v1 is scoped to conditional formatting: compare this datum's `value` against a
- * constant, and (optionally) pick between two values. Richer pieces — aggregates,
- * logic, more refs — are the documented roadmap in the README.
+ * v1 is deliberately non-recursive: compare this datum's `value` or a literal
+ * against another literal, then choose between two colour literals. Rules may
+ * not appear inside operands or branches. Richer expressions require a future
+ * contract version.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.MAX_RULE_DEPTH = exports.CHART_RULE_CONTRACT_VERSION = void 0;
 exports.CHART_RULE_CONTRACT_VERSION = 'chart_rule.v1';
-/**
- * The deepest a rule may nest before `evaluate`/`describe` refuse it. Real rules
- * are a handful of levels; this only stops a pathological deserialized tree from
- * overflowing the stack. Far below the JS call-stack limit.
- */
+/** @deprecated v1 is non-recursive. Retained for source compatibility. */
 exports.MAX_RULE_DEPTH = 256;
 //# sourceMappingURL=types.js.map

package/lib/charts/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/lib/charts/types.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;GAaG;;;AAEU,QAAA,2BAA2B,GAAG,eAAwB,CAAC;AA8EpE;;;;GAIG;AACU,QAAA,cAAc,GAAG,GAAG,CAAC"}
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/lib/charts/types.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;GAeG;;;AAIU,QAAA,2BAA2B,GAAG,eAAwB,CAAC;AAyFpE,0EAA0E;AAC7D,QAAA,cAAc,GAAG,GAAG,CAAC"}

package/lib/charts/types.mjs

@@ -1,22 +1,20 @@
 /**
  * Chart rule vocabulary — shared types.
  *
- * A rule is a small, serializable tree of nodes discriminated by `kind`. The
+ * A rule is a small, serializable value discriminated by `kind`. The
  * agent builds it with the helpers in `builders.ts`, which emit it wrapped in a
  * `{$rule}` placeholder — the same idea as the `{$fn}` placeholders a chart
  * already emits. The renderer resolves it with `evaluate`; the settings panel
  * reads it with `describe`. All three agree because a node can only ever be one
- * of the kinds defined here — the closed set the `chartRuleSchema` describes.
+ * of the kinds defined here — the closed set the executable `chartRuleSchema`
+ * validates at runtime.
  *
- * v1 is scoped to conditional formatting: compare this datum's `value` against a
- * constant, and (optionally) pick between two values. Richer pieces — aggregates,
- * logic, more refs — are the documented roadmap in the README.
+ * v1 is deliberately non-recursive: compare this datum's `value` or a literal
+ * against another literal, then choose between two colour literals. Rules may
+ * not appear inside operands or branches. Richer expressions require a future
+ * contract version.
  */
 export const CHART_RULE_CONTRACT_VERSION = 'chart_rule.v1';
-/**
- * The deepest a rule may nest before `evaluate`/`describe` refuse it. Real rules
- * are a handful of levels; this only stops a pathological deserialized tree from
- * overflowing the stack. Far below the JS call-stack limit.
- */
+/** @deprecated v1 is non-recursive. Retained for source compatibility. */
 export const MAX_RULE_DEPTH = 256;
 //# sourceMappingURL=types.mjs.map

package/lib/charts/types.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"types.mjs","sourceRoot":"","sources":["../../src/lib/charts/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,MAAM,CAAC,MAAM,2BAA2B,GAAG,eAAwB,CAAC;AA8EpE;;;;GAIG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,GAAG,CAAC"}
+{"version":3,"file":"types.mjs","sourceRoot":"","sources":["../../src/lib/charts/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAIH,MAAM,CAAC,MAAM,2BAA2B,GAAG,eAAwB,CAAC;AAyFpE,0EAA0E;AAC1E,MAAM,CAAC,MAAM,cAAc,GAAG,GAAG,CAAC"}