@opendata-ai/openchart-core 6.23.1 → 6.24.1

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.
@@ -629,13 +631,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 +740,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>;
@@ -2536,6 +2542,8 @@ interface SankeyLayout {
     animation?: ResolvedAnimation;
     /** Whether the tryOpenData.ai watermark is enabled. */
     watermark: boolean;
+    /** Real text measurement function from the adapter (for accurate SVG text wrapping). */
+    measureText?: MeasureTextFn;
 }
 /** Function signature for text measurement provided by adapters. */
 type MeasureTextFn = (text: string, fontSize: number, fontWeight?: number) => {
@@ -2784,6 +2792,11 @@ declare const BRAND_RESERVE_WIDTH = 130;
 declare const BRAND_FONT_SIZE = 12;
 /** Minimum chart width to render the brand watermark (px). */
 declare const BRAND_MIN_WIDTH = 120;
+/**
+ * Width threshold below which layout tightens spacing (legend gaps, chrome
+ * padding, label gaps) to maximize data area on small screens.
+ */
+declare const COMPACT_WIDTH = 420;
 
 /**
  * Word-wrap a text string into lines that fit within a max width.
@@ -2793,8 +2806,8 @@ declare const BRAND_MIN_WIDTH = 120;
  * accurate wrapping. Otherwise falls back to a character-width
  * heuristic driven by `estimateCharWidth` from text-measure.ts.
  *
- * Callers that want heuristic-only behavior (e.g. sankey) should omit
- * the measureText argument. Do not change the signature without
+ * Non-browser callers (SSR, tests) omit the measureText argument to
+ * use the heuristic fallback. Do not change the signature without
  * re-verifying visual baselines for every caller.
  */
 
@@ -3134,4 +3147,4 @@ declare function scatterChart(data: DataRow[], x: FieldRef, y: FieldRef, options
  */
 declare function dataTable(data: DataRow[], options?: TableBuilderOptions): TableSpec;
 
-export { type A11yMetadata, type AggregateOp, type AggregateTransform, type AnimationConfig, type AnimationEase, type AnimationPhaseConfig, type AnimationSpec, type AnimationStagger, type Annotation, type AnnotationAnchor, type AnnotationOffset, type AnnotationPosition, type ArcMark, type AreaMark, type AxisConfig, type AxisLabelDensity, type AxisLayout, type AxisTick, BRAND_FONT_SIZE, BRAND_MIN_WIDTH, BRAND_RESERVE_WIDTH, type BarColumnConfig, type BarTableCell, type BinParams, type BinTransform, type Breakpoint, CATEGORICAL_PALETTE, CHART_ENCODING_RULES, CHART_TYPES, type CalculateExpression, type CalculateTransform, type CategoricalPalette, type CategoryColorsConfig, type CategoryTableCell, type CellStyle, type ChannelRule, type ChartBuilderOptions, type ChartEventHandlers, type ChartLayout, type ChartSpec, type ChartSpecOverride, type ChartSpecWithoutData, type ChartType, type Chrome, type ChromeDefaults, type ChromeKey, type ChromeMode, type ChromeText, type ChromeTextStyle, type ColorBlindnessType, type ColumnConfig, type CompileOptions, type CompileTableOptions, type Condition, type ConditionalValueDef, DEFAULT_THEME, DIVERGING_PALETTES, type DarkMode, type DataRow, type DateGranularity, type DivergingPalette, EXTENDED_OFFSET_STRATEGIES, type ElementEdit, type ElementRef, type Encoding, type EncodingChannel, type EncodingRule, type FieldPredicate, type FieldRef, type FieldType, type FilterPredicate, type FilterTransform, type FlagTableCell, type FoldTransform, GRAPH_ENCODING_RULES, type GradientDef, type GradientStop, type GraphChannelRule, type GraphEdge, type GraphEdgeLayout, type GraphEncoding, type GraphEncodingChannel, type GraphLayout, type GraphLayoutConfig, type GraphNode, type GraphNodeLayout, type GraphSpec, type GraphSpecWithoutData, type Gridline, type HeatmapColumnConfig, type HeatmapTableCell, type HeightClass, type ImageColumnConfig, type ImageTableCell, type LabelCandidate, type LabelConfig, type LabelDensity, type LabelMode, type LabelPriority, type LayerSpec, type LayoutStrategy, type LegendConfig, type LegendEntry, type LegendLayout, type LegendPosition, type LineMark, type LinearGradient, type LogicalAnd, type LogicalNot, type LogicalOr, MARK_DISPLAY_NAMES, MARK_ENCODING_RULES, MARK_TYPES, type Margins, type Mark, type MarkAria, type MarkDef, type MarkEvent, type MarkType, type MeasureTextFn, type NodeOverride, OFFSET_STRATEGIES, type OffsetStrategy, type PaginationState, type Point, type PointMark, type RadialGradient, type RangeAnnotation, type Rect, type RectMark, type RefLineAnnotation, type ResolveConfig, type ResolveMode, type ResolvedAnimation, type ResolvedAnnotation, type ResolvedChrome, type ResolvedChromeElement, type ResolvedColumn, type ResolvedLabel, type ResolvedTheme, type RuleMarkLayout, SEQUENTIAL_PALETTES, type SankeyEncoding, type SankeyLayout, type SankeyLinkColor, type SankeyLinkMark, type SankeyNodeAlign, type SankeyNodeMark, type SankeySpec, type SankeySpecWithoutData, type ScaleConfig, type ScaleType, type SequentialPalette, type SeriesStyle, type SortState, type SparklineColumnConfig, type SparklineData, type SparklineTableCell, type StoredVizSpec, type TableBuilderOptions, type TableCell, type TableCellBase, type TableLayout, type TableRow, type TableSpec, type TableSpecWithoutData, type TextAnnotation, type TextMarkLayout, type TextStyle, type TextTableCell, type Theme, type ThemeChromeDefaults, type ThemeColors, type ThemeConfig, type ThemeFontSizes, type ThemeFontWeights, type ThemeFonts, type ThemeSpacing, type TickMarkLayout, type TimeUnit, type TimeUnitTransform, type TooltipContent, type TooltipField, type Transform, type VizSpec, abbreviateNumber, adaptColorForDarkMode, adaptTheme, areaChart, barChart, buildD3Formatter, buildTemporalFormatter, checkPaletteDistinguishability, columnChart, computeChrome, computeLabelBounds, contrastRatio, dataTable, detectCollision, donutChart, dotChart, elementRef, estimateTextWidth, findAccessibleColor, formatDate, formatNumber, generateAltText, generateAriaLabels, generateDataTable, getBreakpoint, getHeightClass, getLayoutStrategy, getRepresentativeColor, inferFieldType, isChartSpec, isConditionalDef, isEncodingChannel, isGradientDef, isGraphSpec, isLayerSpec, isRangeAnnotation, isRefLineAnnotation, isSankeySpec, isTableSpec, isTextAnnotation, lineChart, meetsAA, pieChart, resolveCollisions, resolveMarkDef, resolveMarkType, resolveTheme, scatterChart, simulateColorBlindness, wrapText };
+export { type A11yMetadata, type AggregateOp, type AggregateTransform, type AnimationConfig, type AnimationEase, type AnimationPhaseConfig, type AnimationSpec, type AnimationStagger, type Annotation, type AnnotationAnchor, type AnnotationOffset, type AnnotationPosition, type ArcMark, type AreaMark, type AxisConfig, type AxisLabelDensity, type AxisLayout, type AxisTick, BRAND_FONT_SIZE, BRAND_MIN_WIDTH, BRAND_RESERVE_WIDTH, type BarColumnConfig, type BarTableCell, type BinParams, type BinTransform, type Breakpoint, CATEGORICAL_PALETTE, CHART_ENCODING_RULES, CHART_TYPES, COMPACT_WIDTH, type CalculateExpression, type CalculateTransform, type CategoricalPalette, type CategoryColorsConfig, type CategoryTableCell, type CellStyle, type ChannelRule, type ChartBuilderOptions, type ChartEventHandlers, type ChartLayout, type ChartSpec, type ChartSpecOverride, type ChartSpecWithoutData, type ChartType, type Chrome, type ChromeDefaults, type ChromeKey, type ChromeMode, type ChromeText, type ChromeTextStyle, type ColorBlindnessType, type ColumnConfig, type CompileOptions, type CompileTableOptions, type Condition, type ConditionalValueDef, DEFAULT_THEME, DIVERGING_PALETTES, type DarkMode, type DataRow, type DateGranularity, type DivergingPalette, EXTENDED_OFFSET_STRATEGIES, type ElementEdit, type ElementRef, type Encoding, type EncodingChannel, type EncodingRule, type FieldPredicate, type FieldRef, type FieldType, type FilterPredicate, type FilterTransform, type FlagTableCell, type FoldTransform, GRAPH_ENCODING_RULES, type GradientDef, type GradientStop, type GraphChannelRule, type GraphEdge, type GraphEdgeLayout, type GraphEncoding, type GraphEncodingChannel, type GraphLayout, type GraphLayoutConfig, type GraphNode, type GraphNodeLayout, type GraphSpec, type GraphSpecWithoutData, type Gridline, type HeatmapColumnConfig, type HeatmapTableCell, type HeightClass, type ImageColumnConfig, type ImageTableCell, type LabelCandidate, type LabelConfig, type LabelDensity, type LabelMode, type LabelPriority, type LayerSpec, type LayoutStrategy, type LegendConfig, type LegendEntry, type LegendLayout, type LegendPosition, type LineMark, type LinearGradient, type LogicalAnd, type LogicalNot, type LogicalOr, MARK_DISPLAY_NAMES, MARK_ENCODING_RULES, MARK_TYPES, type Margins, type Mark, type MarkAria, type MarkDef, type MarkEvent, type MarkType, type MeasureTextFn, type NodeOverride, OFFSET_STRATEGIES, type OffsetStrategy, type PaginationState, type Point, type PointMark, type RadialGradient, type RangeAnnotation, type Rect, type RectMark, type RefLineAnnotation, type ResolveConfig, type ResolveMode, type ResolvedAnimation, type ResolvedAnnotation, type ResolvedChrome, type ResolvedChromeElement, type ResolvedColumn, type ResolvedLabel, type ResolvedTheme, type RuleMarkLayout, SEQUENTIAL_PALETTES, type SankeyEncoding, type SankeyLayout, type SankeyLinkColor, type SankeyLinkMark, type SankeyNodeAlign, type SankeyNodeMark, type SankeySpec, type SankeySpecWithoutData, type ScaleConfig, type ScaleType, type SequentialPalette, type SeriesStyle, type SortState, type SparklineColumnConfig, type SparklineData, type SparklineTableCell, type StoredVizSpec, type TableBuilderOptions, type TableCell, type TableCellBase, type TableLayout, type TableRow, type TableSpec, type TableSpecWithoutData, type TextAnnotation, type TextMarkLayout, type TextStyle, type TextTableCell, type Theme, type ThemeChromeDefaults, type ThemeColors, type ThemeConfig, type ThemeFontSizes, type ThemeFontWeights, type ThemeFonts, type ThemeSpacing, type TickMarkLayout, type TimeUnit, type TimeUnitTransform, type TooltipContent, type TooltipField, type Transform, type VizSpec, abbreviateNumber, adaptColorForDarkMode, adaptTheme, areaChart, barChart, buildD3Formatter, buildTemporalFormatter, checkPaletteDistinguishability, columnChart, computeChrome, computeLabelBounds, contrastRatio, dataTable, detectCollision, donutChart, dotChart, elementRef, estimateTextWidth, findAccessibleColor, formatDate, formatNumber, generateAltText, generateAriaLabels, generateDataTable, getBreakpoint, getHeightClass, getLayoutStrategy, getRepresentativeColor, inferFieldType, isChartSpec, isConditionalDef, isEncodingChannel, isGradientDef, isGraphSpec, isLayerSpec, isRangeAnnotation, isRefLineAnnotation, isSankeySpec, isTableSpec, isTextAnnotation, lineChart, meetsAA, pieChart, resolveCollisions, resolveMarkDef, resolveMarkType, resolveTheme, scatterChart, simulateColorBlindness, wrapText };

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
@@ -1061,6 +1068,7 @@ function estimateTextWidth(text, fontSize, fontWeight = 400) {
 var BRAND_RESERVE_WIDTH = 130;
 var BRAND_FONT_SIZE = 12;
 var BRAND_MIN_WIDTH = 120;
+var COMPACT_WIDTH = 420;
 function estimateTextHeight(fontSize, lineCount = 1, lineHeight = 1.3) {
   return fontSize * lineHeight * lineCount;
 }
@@ -1186,7 +1194,8 @@ function computeChrome(chrome, theme, width, measureText, chromeMode = "full", p
     topY += estimateTextHeight(style.fontSize, lineCount, style.lineHeight) + chromeGap;
   }
   const hasTopChrome = titleNorm || subtitleNorm;
-  const topHeight = hasTopChrome ? topY - pad2 + theme.spacing.chromeToChart - chromeGap : 0;
+  const chromeToChart = width < COMPACT_WIDTH ? Math.min(theme.spacing.chromeToChart, 2) : theme.spacing.chromeToChart;
+  const topHeight = hasTopChrome ? topY - pad2 + chromeToChart - chromeGap : 0;
   if (chromeMode === "compact") {
     let compactBottom = 0;
     if (watermark && width >= BRAND_MIN_WIDTH) {
@@ -2833,6 +2842,7 @@ export {
   CATEGORICAL_PALETTE,
   CHART_ENCODING_RULES,
   CHART_TYPES,
+  COMPACT_WIDTH,
   DEFAULT_THEME,
   DIVERGING_PALETTES,
   EXTENDED_OFFSET_STRATEGIES,