@opendata-ai/openchart-core 6.24.2 → 6.25.1

package/dist/index.d.ts

@@ -13,12 +13,18 @@
  */
 /** Responsive breakpoint based on container width. */
 type Breakpoint = 'compact' | 'medium' | 'full';
+/** Breakpoint thresholds in pixels. */
+declare const BREAKPOINT_COMPACT_MAX = 400;
+declare const BREAKPOINT_MEDIUM_MAX = 700;
 /**
  * Determine the breakpoint for a given container width.
  */
 declare function getBreakpoint(width: number): Breakpoint;
 /** Height classification based on container height. */
 type HeightClass = 'cramped' | 'short' | 'normal';
+/** Height class thresholds in pixels. */
+declare const HEIGHT_CRAMPED_MAX = 200;
+declare const HEIGHT_SHORT_MAX = 350;
 /**
  * Determine the height class for a given container height.
  */
@@ -320,6 +326,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 {
@@ -1805,6 +1813,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.
@@ -1846,6 +1856,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.
@@ -1883,6 +1895,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.
@@ -1947,6 +1961,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.
@@ -1980,6 +1996,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.
@@ -2009,6 +2027,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.
@@ -2036,6 +2056,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;
@@ -2189,6 +2211,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[];
@@ -2583,6 +2607,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 {
@@ -2829,6 +2855,68 @@ declare const COMPACT_WIDTH = 420;
  */
 declare function wrapText(text: string, fontSize: number, fontWeight: number, maxWidth: number, measureText?: MeasureTextFn): string[];
 
+/**
+ * Pixel-level responsive metrics for chart layout.
+ *
+ * These are the numeric tuning values that correspond to the semantic decisions
+ * in LayoutStrategy. Centralizing them here ensures the engine and renderer
+ * always agree on the same thresholds and offsets without duplicating raw numbers.
+ *
+ * LayoutStrategy is semantic (what to show), this module is metric (how much space).
+ */
+/** Distance from the chart edge to the rotated y-axis title center (compact viewports). */
+declare const AXIS_TITLE_OFFSET_COMPACT = 35;
+/** Distance from the chart edge to the rotated y-axis title center (standard viewports). */
+declare const AXIS_TITLE_OFFSET_DEFAULT = 45;
+/** Returns the y-axis title offset appropriate for the given container width. */
+declare function getAxisTitleOffset(width: number): number;
+/**
+ * On compact viewports axis titles and tick labels tolerate closer container edges
+ * than chrome text (title, subtitle). Reduce horizontal padding to reclaim space.
+ */
+declare const HPAD_COMPACT_FRACTION = 0.5;
+/** Minimum horizontal padding regardless of scaling. */
+declare const HPAD_COMPACT_MIN = 4;
+/**
+ * Horizontal gap between the chart edge and the near edge of y-axis tick labels.
+ * The engine uses this to reserve right-axis margin; the renderer uses it to position labels.
+ * Both must agree on this value — do not change one without the other.
+ */
+declare const TICK_LABEL_OFFSET = 6;
+/**
+ * Extra padding beyond half-glyph height added to the rotated axis title margin on
+ * standard (non-compact) viewports. Omitted on compact viewports to save space.
+ */
+declare const AXIS_TITLE_TRAILING_PAD = 4;
+/**
+ * Width below which "narrow" adjustments apply: extra iOS Safari top padding and
+ * tighter category label gaps. Sits between compact (< 400) and medium (400–700).
+ * Not a semantic breakpoint — a layout heuristic for narrow-but-not-compact containers.
+ */
+declare const NARROW_VIEWPORT_MAX = 500;
+/** Extra top padding added below NARROW_VIEWPORT_MAX to clear iOS Safari browser chrome. */
+declare const TOP_PAD_EXTRA_NARROW = 10;
+/** @deprecated Use NARROW_VIEWPORT_MAX instead. */
+declare const TOP_PAD_NARROW_MAX = 500;
+/** Gap between category label text and chart edge on narrow viewports (< NARROW_VIEWPORT_MAX). */
+declare const LABEL_GAP_COMPACT = 8;
+/** Gap between category label text and chart edge on standard viewports. */
+declare const LABEL_GAP_DEFAULT = 12;
+/** @deprecated Use NARROW_VIEWPORT_MAX instead. */
+declare const LABEL_GAP_NARROW_MAX = 500;
+/**
+ * Width threshold for the medium left-label fraction cap.
+ * Sits between medium (400-700) and full (> 700) to prevent wide category labels
+ * from consuming too much horizontal space at mid-range widths.
+ */
+declare const MAX_LEFT_LABEL_FRACTION_MEDIUM_MAX = 600;
+/** Max fraction of container width reservable for left category labels (compact). */
+declare const MAX_LEFT_LABEL_FRACTION_COMPACT = 0.45;
+/** Max fraction of container width reservable for left category labels (mid-range). */
+declare const MAX_LEFT_LABEL_FRACTION_MEDIUM = 0.55;
+/** Max fraction of container width reservable for left category labels (standard). */
+declare const MAX_LEFT_LABEL_FRACTION_DEFAULT = 1;
+
 /**
  * Label collision detection and resolution.
  *
@@ -3151,4 +3239,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, 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 };
+export { type A11yMetadata, AXIS_TITLE_OFFSET_COMPACT, AXIS_TITLE_OFFSET_DEFAULT, AXIS_TITLE_TRAILING_PAD, 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, BREAKPOINT_COMPACT_MAX, BREAKPOINT_MEDIUM_MAX, 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, HEIGHT_CRAMPED_MAX, HEIGHT_SHORT_MAX, HPAD_COMPACT_FRACTION, HPAD_COMPACT_MIN, type HeatmapColumnConfig, type HeatmapTableCell, type HeightClass, type ImageColumnConfig, type ImageTableCell, LABEL_GAP_COMPACT, LABEL_GAP_DEFAULT, LABEL_GAP_NARROW_MAX, 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, MAX_LEFT_LABEL_FRACTION_COMPACT, MAX_LEFT_LABEL_FRACTION_DEFAULT, MAX_LEFT_LABEL_FRACTION_MEDIUM, MAX_LEFT_LABEL_FRACTION_MEDIUM_MAX, type Margins, type Mark, type MarkAria, type MarkDef, type MarkEvent, type MarkType, type MeasureTextFn, NARROW_VIEWPORT_MAX, 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, TICK_LABEL_OFFSET, TOP_PAD_EXTRA_NARROW, TOP_PAD_NARROW_MAX, 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, getAxisTitleOffset, 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

@@ -1395,6 +1395,27 @@ function getLayoutStrategy(breakpoint, heightClass = "normal") {
   return applyHeightConstraints(base, heightClass);
 }
 
+// src/responsive/metrics.ts
+var AXIS_TITLE_OFFSET_COMPACT = 35;
+var AXIS_TITLE_OFFSET_DEFAULT = 45;
+function getAxisTitleOffset(width) {
+  return width < BREAKPOINT_COMPACT_MAX ? AXIS_TITLE_OFFSET_COMPACT : AXIS_TITLE_OFFSET_DEFAULT;
+}
+var HPAD_COMPACT_FRACTION = 0.5;
+var HPAD_COMPACT_MIN = 4;
+var TICK_LABEL_OFFSET = 6;
+var AXIS_TITLE_TRAILING_PAD = 4;
+var NARROW_VIEWPORT_MAX = 500;
+var TOP_PAD_EXTRA_NARROW = 10;
+var TOP_PAD_NARROW_MAX = NARROW_VIEWPORT_MAX;
+var LABEL_GAP_COMPACT = 8;
+var LABEL_GAP_DEFAULT = 12;
+var LABEL_GAP_NARROW_MAX = NARROW_VIEWPORT_MAX;
+var MAX_LEFT_LABEL_FRACTION_MEDIUM_MAX = 600;
+var MAX_LEFT_LABEL_FRACTION_COMPACT = 0.45;
+var MAX_LEFT_LABEL_FRACTION_MEDIUM = 0.55;
+var MAX_LEFT_LABEL_FRACTION_DEFAULT = 1;
+
 // src/labels/collision.ts
 var PRIORITY_ORDER = {
   data: 0,
@@ -2836,9 +2857,14 @@ function dataTable(data, options) {
   return spec;
 }
 export {
+  AXIS_TITLE_OFFSET_COMPACT,
+  AXIS_TITLE_OFFSET_DEFAULT,
+  AXIS_TITLE_TRAILING_PAD,
   BRAND_FONT_SIZE,
   BRAND_MIN_WIDTH,
   BRAND_RESERVE_WIDTH,
+  BREAKPOINT_COMPACT_MAX,
+  BREAKPOINT_MEDIUM_MAX,
   CATEGORICAL_PALETTE,
   CHART_ENCODING_RULES,
   CHART_TYPES,
@@ -2847,11 +2873,26 @@ export {
   DIVERGING_PALETTES,
   EXTENDED_OFFSET_STRATEGIES,
   GRAPH_ENCODING_RULES,
+  HEIGHT_CRAMPED_MAX,
+  HEIGHT_SHORT_MAX,
+  HPAD_COMPACT_FRACTION,
+  HPAD_COMPACT_MIN,
+  LABEL_GAP_COMPACT,
+  LABEL_GAP_DEFAULT,
+  LABEL_GAP_NARROW_MAX,
   MARK_DISPLAY_NAMES,
   MARK_ENCODING_RULES,
   MARK_TYPES,
+  MAX_LEFT_LABEL_FRACTION_COMPACT,
+  MAX_LEFT_LABEL_FRACTION_DEFAULT,
+  MAX_LEFT_LABEL_FRACTION_MEDIUM,
+  MAX_LEFT_LABEL_FRACTION_MEDIUM_MAX,
+  NARROW_VIEWPORT_MAX,
   OFFSET_STRATEGIES,
   SEQUENTIAL_PALETTES,
+  TICK_LABEL_OFFSET,
+  TOP_PAD_EXTRA_NARROW,
+  TOP_PAD_NARROW_MAX,
   abbreviateNumber,
   adaptColorForDarkMode,
   adaptTheme,
@@ -2876,6 +2917,7 @@ export {
   generateAltText,
   generateAriaLabels,
   generateDataTable,
+  getAxisTitleOffset,
   getBreakpoint,
   getHeightClass,
   getLayoutStrategy,