@opendata-ai/openchart-engine 6.6.0 → 6.7.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@opendata-ai/openchart-engine",
-  "version": "6.6.0",
+  "version": "6.7.0",
   "description": "Headless compiler for openchart: spec validation, data compilation, scales, and layout",
   "license": "Apache-2.0",
   "author": "Riley Hilliard",
@@ -45,7 +45,7 @@
     "typecheck": "tsc --noEmit"
   },
   "dependencies": {
-    "@opendata-ai/openchart-core": "6.6.0",
+    "@opendata-ai/openchart-core": "6.7.0",
     "d3-array": "^3.2.0",
     "d3-format": "^3.1.2",
     "d3-interpolate": "^3.0.0",

package/src/__test-fixtures__/specs.ts

@@ -70,7 +70,7 @@ export function makeLineSpec(): NormalizedChartSpec {
     responsive: true,
     theme: {},
     darkMode: 'off',
-    labels: { density: 'auto', format: '' },
+    labels: { density: 'auto', format: '', prefix: '' },
     hiddenSeries: [],
     seriesStyles: {},
   };
@@ -99,7 +99,7 @@ export function makeBarSpec(): NormalizedChartSpec {
     responsive: true,
     theme: {},
     darkMode: 'off',
-    labels: { density: 'auto', format: '' },
+    labels: { density: 'auto', format: '', prefix: '' },
     hiddenSeries: [],
     seriesStyles: {},
   };
@@ -130,7 +130,7 @@ export function makeScatterSpec(): NormalizedChartSpec {
     responsive: true,
     theme: {},
     darkMode: 'off',
-    labels: { density: 'auto', format: '' },
+    labels: { density: 'auto', format: '', prefix: '' },
     hiddenSeries: [],
     seriesStyles: {},
   };

package/src/charts/bar/index.ts

@@ -17,7 +17,13 @@ export const barRenderer: ChartRenderer = (spec, scales, chartArea, strategy, _t
   const marks = computeBarMarks(spec, scales, chartArea, strategy);
 
   // Compute and attach value labels (respects spec.labels.density)
-  const labels = computeBarLabels(marks, chartArea, spec.labels.density, spec.labels.format);
+  const labels = computeBarLabels(
+    marks,
+    chartArea,
+    spec.labels.density,
+    spec.labels.format,
+    spec.labels.prefix,
+  );
   for (let i = 0; i < marks.length && i < labels.length; i++) {
     marks[i].label = labels[i];
   }

package/src/charts/bar/labels.ts

@@ -82,6 +82,7 @@ export function computeBarLabels(
   _chartArea: { x: number; y: number; width: number; height: number },
   density: LabelDensity = 'auto',
   labelFormat?: string,
+  labelPrefix?: string,
 ): ResolvedLabel[] {
   // 'none': no labels at all
   if (density === 'none') return [];
@@ -112,6 +113,7 @@ export function computeBarLabels(
       const num = parseDisplayNumber(rawValue);
       if (!Number.isNaN(num)) valuePart = formatter(num);
     }
+    if (labelPrefix) valuePart = labelPrefix + valuePart;
 
     const textWidth = estimateTextWidth(valuePart, LABEL_FONT_SIZE, LABEL_FONT_WEIGHT);
     const textHeight = LABEL_FONT_SIZE * 1.2;

package/src/charts/column/index.ts

@@ -17,7 +17,13 @@ export const columnRenderer: ChartRenderer = (spec, scales, chartArea, strategy,
   const marks = computeColumnMarks(spec, scales, chartArea, strategy);
 
   // Compute and attach value labels (respects spec.labels.density)
-  const labels = computeColumnLabels(marks, chartArea, spec.labels.density, spec.labels.format);
+  const labels = computeColumnLabels(
+    marks,
+    chartArea,
+    spec.labels.density,
+    spec.labels.format,
+    spec.labels.prefix,
+  );
   for (let i = 0; i < marks.length && i < labels.length; i++) {
     marks[i].label = labels[i];
   }

package/src/charts/column/labels.ts

@@ -45,6 +45,7 @@ export function computeColumnLabels(
   _chartArea: { x: number; y: number; width: number; height: number },
   density: LabelDensity = 'auto',
   labelFormat?: string,
+  labelPrefix?: string,
 ): ResolvedLabel[] {
   // 'none': no labels at all
   if (density === 'none') return [];
@@ -72,6 +73,7 @@ export function computeColumnLabels(
       const num = Number(rawValue.replace(/[^0-9.-]/g, ''));
       if (!Number.isNaN(num)) valuePart = formatter(num);
     }
+    if (labelPrefix) valuePart = labelPrefix + valuePart;
 
     const numericValue = parseFloat(valuePart);
     const isNegative = Number.isFinite(numericValue) && numericValue < 0;

package/src/charts/dot/index.ts

@@ -26,7 +26,7 @@ export const dotRenderer: ChartRenderer = (spec, scales, chartArea, strategy, _t
   const pointMarks = marks.filter((m): m is PointMark => m.type === 'point');
 
   // Compute and attach labels to point marks (respects spec.labels.density)
-  const labels = computeDotLabels(pointMarks, chartArea, spec.labels.density);
+  const labels = computeDotLabels(pointMarks, chartArea, spec.labels.density, spec.labels.prefix);
   let labelIdx = 0;
   for (const mark of marks) {
     if (mark.type === 'point' && labelIdx < labels.length) {

package/src/charts/dot/labels.ts

@@ -40,6 +40,7 @@ export function computeDotLabels(
   marks: PointMark[],
   _chartArea: Rect,
   density: LabelDensity = 'auto',
+  labelPrefix?: string,
 ): ResolvedLabel[] {
   // 'none': no labels at all
   if (density === 'none') return [];
@@ -55,8 +56,9 @@ export function computeDotLabels(
     // Format is "category: value". Use the last colon to handle colons in category names.
     const ariaLabel = mark.aria.label;
     const lastColon = ariaLabel.lastIndexOf(':');
-    const valuePart = lastColon >= 0 ? ariaLabel.slice(lastColon + 1).trim() : '';
+    let valuePart = lastColon >= 0 ? ariaLabel.slice(lastColon + 1).trim() : '';
     if (!valuePart) continue;
+    if (labelPrefix) valuePart = labelPrefix + valuePart;
 
     const textWidth = estimateTextWidth(valuePart, LABEL_FONT_SIZE, LABEL_FONT_WEIGHT);
     const textHeight = LABEL_FONT_SIZE * 1.2;

package/src/compiler/__tests__/normalize.test.ts

@@ -44,7 +44,12 @@ describe('normalizeSpec', () => {
       expect(result.darkMode).toBe('off');
       expect(result.annotations).toEqual([]);
       expect(result.theme).toEqual({});
-      expect(result.labels).toEqual({ density: 'auto', format: '', offsets: undefined });
+      expect(result.labels).toEqual({
+        density: 'auto',
+        format: '',
+        prefix: '',
+        offsets: undefined,
+      });
     });
 
     it('preserves explicit values', () => {
@@ -139,7 +144,12 @@ describe('normalizeSpec', () => {
         labels: { density: 'none', format: ',.0f' },
       };
       const result = normalizeSpec(spec) as NormalizedChartSpec;
-      expect(result.labels).toEqual({ density: 'none', format: ',.0f', offsets: undefined });
+      expect(result.labels).toEqual({
+        density: 'none',
+        format: ',.0f',
+        prefix: '',
+        offsets: undefined,
+      });
     });
 
     it('fills partial label config with defaults', () => {
@@ -148,7 +158,12 @@ describe('normalizeSpec', () => {
         labels: { density: 'endpoints' },
       };
       const result = normalizeSpec(spec) as NormalizedChartSpec;
-      expect(result.labels).toEqual({ density: 'endpoints', format: '', offsets: undefined });
+      expect(result.labels).toEqual({
+        density: 'endpoints',
+        format: '',
+        prefix: '',
+        offsets: undefined,
+      });
     });
 
     it('normalizes annotations with default styles', () => {

package/src/compiler/normalize.ts

@@ -206,6 +206,7 @@ function normalizeChartSpec(spec: ChartSpec, warnings: string[]): NormalizedChar
     labels: {
       density: spec.labels?.density ?? 'auto',
       format: spec.labels?.format ?? '',
+      prefix: spec.labels?.prefix ?? '',
       offsets: spec.labels?.offsets,
     },
     legend: spec.legend,

package/src/compiler/types.ts

@@ -70,8 +70,9 @@ export interface NormalizedChartSpec {
   encoding: Encoding;
   chrome: NormalizedChrome;
   annotations: Annotation[];
-  /** Normalized label configuration with defaults applied. density and format are always set; offsets stays optional. */
-  labels: Required<Pick<LabelConfig, 'density' | 'format'>> & Pick<LabelConfig, 'offsets'>;
+  /** Normalized label configuration with defaults applied. density, format, and prefix are always set; offsets stays optional. */
+  labels: Required<Pick<LabelConfig, 'density' | 'format' | 'prefix'>> &
+    Pick<LabelConfig, 'offsets'>;
   /** Legend configuration (position override). */
   legend?: LegendConfig;
   responsive: boolean;