@opendata-ai/openchart-engine 6.28.5 → 7.0.0

package/README.md

@@ -38,6 +38,7 @@ const layout = compileChart(chartSpec, { width: 600, height: 400 });
 // layout.marks: positioned line paths, bar rects, arc segments, etc.
 // layout.axes: tick positions, labels, format strings
 // layout.legend: entries, position, dimensions
+// layout.endpointLabels: per-series chip+swatch labels at the trailing point (line/area), driven by `layout.endpointLabels: EndpointLabelsLayout` on the spec
 // layout.annotations: pixel-positioned annotation elements
 // layout.theme: fully resolved theme with all defaults filled
 ```

package/dist/index.d.ts

@@ -118,17 +118,6 @@ interface GraphCompilation {
  * @throws Error if spec is invalid or not a chart type.
  */
 declare function compileChart(spec: unknown, options: CompileOptions): ChartLayout;
-/**
- * Compile a LayerSpec into a single ChartLayout.
- *
- * Flattens nested layers, merges inherited data/encoding/transforms,
- * compiles each leaf layer independently, unions scale domains (shared
- * by default), and concatenates marks in layer order.
- *
- * @param spec - A LayerSpec with child layers.
- * @param options - Compile options (width, height, theme, darkMode).
- * @returns A single ChartLayout with combined marks from all layers.
- */
 declare function compileLayer(spec: LayerSpec, options: CompileOptions): ChartLayout;
 /**
  * Compile a table spec into a TableLayout.
@@ -258,11 +247,13 @@ interface NormalizedTileMapSpec {
 
 /** Chrome with all string values normalized to ChromeText objects. */
 interface NormalizedChrome {
+    eyebrow?: ChromeText;
     title?: ChromeText;
     subtitle?: ChromeText;
     source?: ChromeText;
     byline?: ChromeText;
     footer?: ChromeText;
+    brand?: ChromeText;
 }
 /**
  * Tracks which top-level fields the user explicitly set in their input spec.
@@ -279,6 +270,8 @@ interface UserExplicit {
     chrome: boolean;
     /** True if user wrote `legend`. */
     legend: boolean;
+    /** True if user wrote `endpointLabels`. */
+    endpointLabels: boolean;
     /** True if user wrote `encoding.x.axis`. */
     xAxis: boolean;
     /** True if user wrote `encoding.y.axis`. */
@@ -301,11 +294,15 @@ interface NormalizedChartSpec {
     data: DataRow[];
     encoding: Encoding;
     chrome: NormalizedChrome;
+    /** Optional KPI metric cells, passed through unchanged. */
+    metrics?: _opendata_ai_openchart_core.Metric[];
     annotations: Annotation[];
     /** Normalized label configuration with defaults applied. density, format, and prefix are always set; offsets and color stay optional. */
     labels: Required<Pick<LabelConfig, 'density' | 'format' | 'prefix'>> & Pick<LabelConfig, 'offsets' | 'color'>;
     /** Legend configuration (position override). */
     legend?: LegendConfig;
+    /** Right-side endpoint labels column config (multi-series line/area only). */
+    endpointLabels?: boolean | _opendata_ai_openchart_core.EndpointLabelsConfig;
     responsive: boolean;
     theme: ThemeConfig;
     darkMode: DarkMode;