@opendata-ai/openchart-core 6.24.0 → 6.24.2

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@opendata-ai/openchart-core",
-  "version": "6.24.0",
+  "version": "6.24.2",
   "description": "Types, theme, colors, accessibility, and utilities for openchart",
   "license": "Apache-2.0",
   "author": "Riley Hilliard",

package/src/colors/contrast.ts

@@ -65,30 +65,42 @@ export function findAccessibleColor(baseColor: string, bg: string, targetRatio =
   if (c == null) return baseColor;
 
   const bgLum = relativeLuminance(bg);
-  // Determine direction: darken if bg is light, lighten if bg is dark.
-  const bgIsLight = bgLum > 0.5;
-
-  // Binary search for the lightness adjustment that hits the target ratio.
-  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 hex = adjusted.formatHex();
-    const ratio = contrastRatio(hex, bg);
-
-    if (ratio >= targetRatio) {
-      best = hex;
-      hi = mid; // try less adjustment
-    } else {
-      lo = mid; // need more adjustment
+  const baseLum = relativeLuminance(baseColor);
+
+  // Try both directions: prefer the one matching bg luminance, but fall back
+  // to the other if the base color is already at the extreme (e.g. white on
+  // a medium-luminance background can't be lightened, so darken instead).
+  const preferDarken = bgLum > 0.5;
+  const directions = preferDarken ? [true, false] : [false, true];
+
+  for (const darken of directions) {
+    // Skip impossible directions: can't lighten white or darken black.
+    if (!darken && baseLum > 0.95) continue;
+    if (darken && baseLum < 0.05) continue;
+
+    let lo = 0;
+    let hi = 1;
+    let best: string | null = 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 hex = adjusted.formatHex();
+      const ratio = contrastRatio(hex, bg);
+
+      if (ratio >= targetRatio) {
+        best = hex;
+        hi = mid;
+      } else {
+        lo = mid;
+      }
     }
+
+    if (best) return best;
   }
 
-  return best;
+  return baseColor;
 }

package/src/types/layout.ts

@@ -505,6 +505,8 @@ export interface ResolvedLabel {
   };
   /** Background color behind the label text. */
   background?: string;
+  /** Whether to show the paint-order stroke halo. Default true. */
+  halo?: boolean;
 }
 
 // ---------------------------------------------------------------------------

package/src/types/spec.ts

@@ -523,6 +523,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;
 }
 
 /**
@@ -561,6 +563,8 @@ export 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;
 }
 
 /**
@@ -588,13 +592,15 @@ export interface RangeAnnotation extends AnnotationBase {
  * Useful for baselines (zero), targets, or thresholds.
  */
 export 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. */
@@ -715,6 +721,8 @@ export 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[];
 }
 
 // ---------------------------------------------------------------------------
@@ -1408,7 +1416,7 @@ export function isRangeAnnotation(annotation: Annotation): annotation is RangeAn
 
 /** Check if an annotation is a RefLineAnnotation. */
 export function isRefLineAnnotation(annotation: Annotation): annotation is RefLineAnnotation {
-  return annotation.type === 'refline';
+  return annotation.type === 'refline' || annotation.type === 'rule';
 }
 
 // ---------------------------------------------------------------------------