@opendata-ai/openchart-core 6.24.0 → 6.24.2

package/dist/index.d.ts

@@ -567,6 +567,8 @@ interface AnnotationBase {
     opacity?: number;
     /** Z-index for render ordering. Higher values render on top. */
     zIndex?: number;
+    /** When false, the annotation is always shown even at compact breakpoints. Default true. */
+    responsive?: boolean;
 }
 /**
  * Text annotation positioned at a data coordinate.
@@ -604,6 +606,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.
@@ -629,13 +633,15 @@ interface RangeAnnotation extends AnnotationBase {
  * Useful for baselines (zero), targets, or thresholds.
  */
 interface RefLineAnnotation extends AnnotationBase {
-    type: 'refline';
+    type: 'refline' | 'rule';
     /** X-axis value for a vertical reference line. */
     x?: string | number;
     /** Y-axis value for a horizontal reference line. */
     y?: string | number;
     /** Line style. */
     style?: 'solid' | 'dashed' | 'dotted';
+    /** Raw SVG dash pattern override, e.g. [4, 4]. Takes precedence over style. */
+    strokeDash?: number[];
     /** Line width in pixels. */
     strokeWidth?: number;
     /** Pixel offset for the reference line label. */
@@ -736,6 +742,8 @@ interface LegendConfig {
     symbolLimit?: number;
     /** Maximum number of rows for top-positioned legends before truncation. Defaults to 2. */
     maxRows?: number;
+    /** Series names to exclude from the legend. Excluded series still render in the chart. */
+    exclude?: string[];
 }
 /** Data row: a plain object with string keys. */
 type DataRow = Record<string, unknown>;
@@ -2061,6 +2069,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 {

package/dist/index.js

@@ -219,7 +219,7 @@ function isRangeAnnotation(annotation) {
   return annotation.type === "range";
 }
 function isRefLineAnnotation(annotation) {
-  return annotation.type === "refline";
+  return annotation.type === "refline" || annotation.type === "rule";
 }
 var MARK_DISPLAY_NAMES = {
   bar: "Bar chart",
@@ -666,23 +666,30 @@ function findAccessibleColor(baseColor, bg, targetRatio = 4.5) {
   const c = rgb(baseColor);
   if (c == null) return baseColor;
   const bgLum = relativeLuminance(bg);
-  const bgIsLight = bgLum > 0.5;
-  let lo = 0;
-  let hi = 1;
-  let best = baseColor;
-  for (let i = 0; i < 20; i++) {
-    const mid = (lo + hi) / 2;
-    const adjusted = bgIsLight ? rgb(c.r * (1 - mid), c.g * (1 - mid), c.b * (1 - mid)) : rgb(c.r + (255 - c.r) * mid, c.g + (255 - c.g) * mid, c.b + (255 - c.b) * mid);
-    const hex2 = adjusted.formatHex();
-    const ratio = contrastRatio(hex2, bg);
-    if (ratio >= targetRatio) {
-      best = hex2;
-      hi = mid;
-    } else {
-      lo = mid;
+  const baseLum = relativeLuminance(baseColor);
+  const preferDarken = bgLum > 0.5;
+  const directions = preferDarken ? [true, false] : [false, true];
+  for (const darken of directions) {
+    if (!darken && baseLum > 0.95) continue;
+    if (darken && baseLum < 0.05) continue;
+    let lo = 0;
+    let hi = 1;
+    let best = null;
+    for (let i = 0; i < 20; i++) {
+      const mid = (lo + hi) / 2;
+      const adjusted = darken ? rgb(c.r * (1 - mid), c.g * (1 - mid), c.b * (1 - mid)) : rgb(c.r + (255 - c.r) * mid, c.g + (255 - c.g) * mid, c.b + (255 - c.b) * mid);
+      const hex2 = adjusted.formatHex();
+      const ratio = contrastRatio(hex2, bg);
+      if (ratio >= targetRatio) {
+        best = hex2;
+        hi = mid;
+      } else {
+        lo = mid;
+      }
     }
+    if (best) return best;
   }
-  return best;
+  return baseColor;
 }
 
 // src/colors/palettes.ts