@opendata-ai/openchart-core 6.24.1 → 6.25.0

package/dist/index.d.ts

@@ -320,6 +320,8 @@ interface AxisConfig {
     titlePadding?: number;
     /** Padding between tick labels and axis. */
     labelPadding?: number;
+    /** Color override for axis tick labels and title. Useful in dual-axis charts to match axis color to its series. */
+    labelColor?: string;
 }
 /** Scale configuration for an encoding channel. */
 interface ScaleConfig {
@@ -606,6 +608,8 @@ interface TextAnnotation extends AnnotationBase {
     };
     /** Background color behind the text. Useful for readability over chart lines. */
     background?: string;
+    /** Whether to show the paint-order stroke halo behind text. Default true. Set false for white text on colored backgrounds. */
+    halo?: boolean;
 }
 /**
  * Range annotation highlighting a region of the chart.
@@ -1803,6 +1807,8 @@ interface LineMark {
     aria: MarkAria;
     /** Index for stagger animation ordering. */
     animationIndex?: number;
+    /** Which y-scale produced this mark ('y' = left, 'y2' = right). */
+    yScale?: 'y' | 'y2';
 }
 /**
  * Area mark: a filled region bounded by a top line and a baseline.
@@ -1844,6 +1850,8 @@ interface AreaMark {
     aria: MarkAria;
     /** Index for stagger animation ordering. */
     animationIndex?: number;
+    /** Which y-scale produced this mark ('y' = left, 'y2' = right). */
+    yScale?: 'y' | 'y2';
 }
 /**
  * Rect mark: a rectangle.
@@ -1881,6 +1889,8 @@ interface RectMark {
     stackGroup?: string;
     /** Position of this segment within its stack group (0, 1, 2...). Set by engine for stacked bars. */
     stackPos?: number;
+    /** Which y-scale produced this mark ('y' = left, 'y2' = right). */
+    yScale?: 'y' | 'y2';
 }
 /**
  * Arc mark: a pie/donut slice.
@@ -1945,6 +1955,8 @@ interface PointMark {
     aria: MarkAria;
     /** Index for stagger animation ordering. */
     animationIndex?: number;
+    /** Which y-scale produced this mark ('y' = left, 'y2' = right). */
+    yScale?: 'y' | 'y2';
 }
 /**
  * Text mark: data-positioned text label.
@@ -1978,6 +1990,8 @@ interface TextMarkLayout {
     aria: MarkAria;
     /** Index for stagger animation ordering. */
     animationIndex?: number;
+    /** Which y-scale produced this mark ('y' = left, 'y2' = right). */
+    yScale?: 'y' | 'y2';
 }
 /**
  * Rule mark: a line segment between two points.
@@ -2007,6 +2021,8 @@ interface RuleMarkLayout {
     aria: MarkAria;
     /** Index for stagger animation ordering. */
     animationIndex?: number;
+    /** Which y-scale produced this mark ('y' = left, 'y2' = right). */
+    yScale?: 'y' | 'y2';
 }
 /**
  * Tick mark: a short line segment at a data coordinate.
@@ -2034,6 +2050,8 @@ interface TickMarkLayout {
     aria: MarkAria;
     /** Index for stagger animation ordering. */
     animationIndex?: number;
+    /** Which y-scale produced this mark ('y' = left, 'y2' = right). */
+    yScale?: 'y' | 'y2';
 }
 /** Discriminated union of all mark types. */
 type Mark = LineMark | AreaMark | RectMark | ArcMark | PointMark | TextMarkLayout | RuleMarkLayout | TickMarkLayout;
@@ -2067,6 +2085,8 @@ interface ResolvedLabel {
     };
     /** Background color behind the label text. */
     background?: string;
+    /** Whether to show the paint-order stroke halo. Default true. */
+    halo?: boolean;
 }
 /** A resolved annotation with computed pixel positions. */
 interface ResolvedAnnotation {
@@ -2185,6 +2205,8 @@ interface ChartLayout {
     axes: {
         x?: AxisLayout;
         y?: AxisLayout;
+        /** Right-side y-axis for independent-scale layers (dual-axis charts). */
+        y2?: AxisLayout;
     };
     /** Data marks: the visual representation of data points. */
     marks: Mark[];
@@ -2579,6 +2601,8 @@ interface CompileOptions {
      * If not provided, the engine falls back to heuristic estimation.
      */
     measureText?: MeasureTextFn;
+    /** Extra pixels to reserve on the right margin for a secondary y-axis. Set by compileLayer when resolve.scale.y is 'independent'. */
+    rightAxisReserve?: number;
 }
 /** Extended compile options for table visualizations. */
 interface CompileTableOptions extends CompileOptions {