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

package/src/lib/charts/visualization-grammar.ts

@@ -0,0 +1,67 @@
+import { RULE_CHANNELS, RULE_NODE_KINDS } from './vocabulary';
+
+/**
+ * Machine-readable authoring surface for chart visualization primitives.
+ *
+ * The SDK build serializes this registry to `capabilities.json`. Keep the
+ * registry aligned with the public builders and the serialized-node schema;
+ * contract tests enforce both relationships.
+ */
+export const visualizationGrammarCapabilities = {
+  contractVersion: 1,
+  moduleSpecifier: 'npm:@rippling/rippling-sdk/lib/charts',
+  builders: {
+    value: {
+      kind: 'input',
+      returns: 'number',
+    },
+    literal: {
+      kind: 'literal',
+      parameters: ['scalar'],
+      returns: 'value',
+    },
+    equals: {
+      kind: 'comparison',
+      parameters: ['value', 'value'],
+      returns: 'condition',
+    },
+    isNot: {
+      kind: 'comparison',
+      parameters: ['value', 'value'],
+      returns: 'condition',
+    },
+    lessThan: {
+      kind: 'comparison',
+      parameters: ['value', 'value'],
+      returns: 'condition',
+    },
+    greaterThan: {
+      kind: 'comparison',
+      parameters: ['value', 'value'],
+      returns: 'condition',
+    },
+    lessOrEqual: {
+      kind: 'comparison',
+      parameters: ['value', 'value'],
+      returns: 'condition',
+    },
+    greaterOrEqual: {
+      kind: 'comparison',
+      parameters: ['value', 'value'],
+      returns: 'condition',
+    },
+    when: {
+      kind: 'conditional',
+      parameters: ['condition', 'color', 'color?'],
+      returns: 'conditional-color',
+    },
+    color: {
+      kind: 'channel',
+      parameters: ['conditional-color'],
+      returns: 'color-rule',
+      placeholderChannel: 'color',
+    },
+  },
+  supportedChannels: RULE_CHANNELS,
+  supportedNodeKinds: RULE_NODE_KINDS,
+} as const;

package/src/lib/charts/vocabulary.ts

@@ -0,0 +1,7 @@
+/** Runtime constants shared by the schema, capability manifest, and types. */
+export const EQUALITY_COMPARISON_KINDS = ['equals', 'isNot'] as const;
+export const NUMERIC_COMPARISON_KINDS = ['lessThan', 'greaterThan', 'lessOrEqual', 'greaterOrEqual'] as const;
+export const COMPARISON_KINDS = [...EQUALITY_COMPARISON_KINDS, ...NUMERIC_COMPARISON_KINDS] as const;
+
+export const RULE_NODE_KINDS = ['literal', 'value', ...COMPARISON_KINDS, 'ifElse'] as const;
+export const RULE_CHANNELS = ['color'] as const;

package/src/lib/charts.ts

@@ -10,11 +10,12 @@ export {
   literal,
   value,
   when,
+  type NumericOperand,
   type Operand,
 } from './charts/builders';
 export { evaluate } from './charts/evaluate';
 export { describe } from './charts/describe';
-export { chartRuleSchema, CHART_RULE_SCHEMA_ID } from './charts/schema';
+export { chartRuleSchema, CHART_RULE_SCHEMA_ID, parseChartRule } from './charts/schema';
 export {
   ChartRuleError,
   MalformedRuleError,
@@ -28,10 +29,16 @@ export {
   type ChartRuleContractVersion,
   type ComparisonKind,
   type ComparisonNode,
+  type ComparisonOperandNode,
+  type ConditionNode,
   type Control,
   type ControlRole,
+  type EqualityComparisonNode,
   type IfElseNode,
   type LiteralNode,
+  type NumericComparisonNode,
+  type NumericOperandNode,
+  type ParsedRule,
   type RefNode,
   type Rule,
   type RuleChannel,