@opendata-ai/openchart-core 7.2.1 → 7.2.3

package/dist/index.d.ts

@@ -774,10 +774,24 @@ interface RangeAnnotation extends AnnotationBase {
     y1?: string | number;
     /** End of the range on the y-axis. */
     y2?: string | number;
+    /**
+     * For band/point (ordinal) x or y scales, whether the range extends from the
+     * data point's center out to the band/step edge. Default `true`: a range on a
+     * bar chart spans full columns, and a range on a line chart extends half a step
+     * past the first/last point so the band reaches the plot edge. Set `false` to
+     * anchor the range exactly at the data point centers instead — useful when you
+     * want the band inset from the axis (e.g. starting at the first data point
+     * rather than flush against the y-axis guide). No effect on linear/time scales.
+     */
+    extendToEdges?: boolean;
     /** Pixel offset for the range label. */
     labelOffset?: AnnotationOffset;
     /** Anchor direction for the range label. */
     labelAnchor?: AnnotationAnchor;
+    /** Font size override for the range label (px). Default: 11. */
+    fontSize?: number;
+    /** Font weight override for the range label. Default: 500. */
+    fontWeight?: number;
 }
 /**
  * Reference line annotation: a horizontal or vertical line at a data value.
@@ -799,6 +813,10 @@ interface RefLineAnnotation extends AnnotationBase {
     labelOffset?: AnnotationOffset;
     /** Anchor direction for the reference line label. */
     labelAnchor?: AnnotationAnchor;
+    /** Label font size in pixels. Default: 11. */
+    fontSize?: number;
+    /** Label font weight. Default: 400. */
+    fontWeight?: number;
 }
 /** Discriminated union of all annotation types. */
 type Annotation = TextAnnotation | RangeAnnotation | RefLineAnnotation;
@@ -861,6 +879,10 @@ interface ThemeConfig {
             small?: number;
             /** Axis tick labels. Default: 11. */
             axisTick?: number;
+            /** KPI metric uppercase label. Default: 10. */
+            metricLabel?: number;
+            /** KPI metric primary value. Default: 22. Delta/secondary derive from this. */
+            metricValue?: number;
         };
     };
     /** Spacing overrides in pixels. */
@@ -2208,6 +2230,11 @@ interface ThemeFontSizes {
     small: number;
     /** Axis tick label font size in pixels. */
     axisTick: number;
+    /** KPI metric uppercase label font size in pixels. */
+    metricLabel: number;
+    /** KPI metric primary value font size in pixels. The delta and secondary
+     *  values derive from this (each ~0.55x), so scaling this scales the whole cell. */
+    metricValue: number;
 }
 /** Font weight presets. */
 interface ThemeFontWeights {
@@ -3890,15 +3917,32 @@ declare const TICK_LABEL_OFFSET = 6;
  */
 declare const AXIS_TITLE_TRAILING_PAD = 4;
 /**
- * Breathing room between the widest tick label's far edge and the rotated
- * y-axis title center. The title glyph extends ~halfGlyph (ceil(bodyFontSize/2))
- * from its center toward the tick labels, so visible clearance is
- * AXIS_TITLE_GAP - halfGlyph (~7px at default body size 13).
+ * Visible breathing room between the widest tick label's far edge and the
+ * rotated y-axis title's near edge.
+ *
+ * The title is rotated -90deg and anchored at its center, so its glyph box
+ * extends half the title font size toward the tick labels. To keep the gap
+ * constant regardless of title font size, callers add that half-glyph on top
+ * of this value (see axisTitleOffset() below). At the old fixed gap of 14 the
+ * clearance silently shrank as the font grew (14 - 11 = 3px at body size 21),
+ * which let large-font titles collide with the tick labels.
  *
  * Used in both the engine (dimensions.ts margin reservation) and the renderer
- * (axes.ts title placement). Both must agree on this value.
+ * (axes.ts title placement) via axisTitleOffset(). Both must agree on this value.
+ */
+declare const AXIS_TITLE_GAP = 7;
+/**
+ * Computes the distance from the chart edge to the rotated y-axis title's center.
+ *
+ * The title center must sit far enough left that, after accounting for the
+ * widest tick label and the title's own half-glyph height, AXIS_TITLE_GAP of
+ * visible clearance remains. Falls back to the viewport-minimum offset when the
+ * dynamic value would be smaller (short tick labels on wide containers).
+ *
+ * Shared by the engine (margin reservation) and the renderer (title placement)
+ * so the reserved space always matches where the title is drawn.
  */
-declare const AXIS_TITLE_GAP = 14;
+declare function axisTitleOffset(maxTickLabelWidth: number, titleFontSize: number, width: number): number;
 /**
  * Width below which "narrow" adjustments apply: extra iOS Safari top padding and
  * tighter category label gaps. Sits between compact (< 400) and medium (400–700).
@@ -4285,4 +4329,4 @@ interface TileMapBuilderOptions {
  */
 declare function tileMap(data: Record<string, number | null> | DataRow[], options?: TileMapBuilderOptions): TileMapSpec;
 
-export { type A11yMetadata, AXIS_TITLE_GAP, 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 ArcEncoding, type ArcMark, type AreaEncoding, 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 BarEncoding, type BarListEncoding, type BarListLayout, type BarListRowMark, type BarListSpec, type BarListSpecWithoutData, type BarTableCell, type BaseLegendLayout, type BinParams, type BinTransform, type Breakpoint, CATEGORICAL_PALETTE, CHART_ENCODING_RULES, CHART_TYPES, COMPACT_WIDTH, type CalculateExpression, type CalculateTransform, type CategoricalLegendLayout, 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 CircleEncoding, type ColorBlindnessType, type ColumnConfig, type CompileOptions, type CompileTableOptions, type Condition, type ConditionalValueDef, DEFAULT_THEME, DIVERGING_PALETTES, type DarkMode, type DataRow, type DateGranularity, type Display, type DivergingPalette, EXTENDED_OFFSET_STRATEGIES, type ElementEdit, type ElementRef, type Encoding, type EncodingChannel, type EncodingRule, type EndpointLabelEntry, type EndpointLabelsConfig, type EndpointLabelsLayout, type FieldPredicate, type FieldRef, type FieldType, type FilterPredicate, type FilterTransform, type FlagTableCell, type FoldTransform, GRAPH_ENCODING_RULES, type GradientColorStop, type GradientDef, type GradientLegendLayout, 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 LabelSpec, type LayerSpec, type LayoutStrategy, type LegendConfig, type LegendEntry, type LegendLayout, type LegendPosition, type LineEncoding, type LineMark, type LinearGradient, type LogicalAnd, type LogicalNot, type LogicalOr, type LollipopEncoding, 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, type Metric, NARROW_VIEWPORT_MAX, type NodeOverride, OFFSET_STRATEGIES, type OffsetStrategy, type PaginationState, type Point, type PointEncoding, type PointMark, type RadialGradient, type RangeAnnotation, type Rect, type RectEncoding, type RectMark, type RefLineAnnotation, type RelativeTimeRef, type ResolveConfig, type ResolveMode, type ResolvedAnimation, type ResolvedAnnotation, type ResolvedChrome, type ResolvedChromeElement, type ResolvedColumn, type ResolvedLabel, type ResolvedMetricBar, type ResolvedMetricCell, 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 TextEncoding, type TextMarkLayout, type TextStyle, type TextTableCell, type Theme, type ThemeChromeDefaults, type ThemeColors, type ThemeConfig, type ThemeFontSizes, type ThemeFontWeights, type ThemeFonts, type ThemeSpacing, type TickEncoding, type TickMarkLayout, type TileMapBuilderOptions, type TileMapEncoding, type TileMapLayout, type TileMapPalette, type TileMapSpec, type TileMapSpecWithoutData, type TileMapTileMark, type TimeUnit, type TimeUnitTransform, type TooltipContent, type TooltipField, type Transform, type VizSpec, type WindowFieldDef, type WindowOp, type WindowSortField, type WindowTransform, 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, isBarListSpec, isChartSpec, isConditionalDef, isEncodingChannel, isGradientDef, isGraphSpec, isLayerSpec, isRangeAnnotation, isRefLineAnnotation, isSankeySpec, isTableSpec, isTextAnnotation, isTileMapSpec, lineChart, meetsAA, pickLabelColor, pieChart, resolveCollisions, resolveMarkDef, resolveMarkType, resolveTheme, scatterChart, simulateColorBlindness, tileMap, wrapText };
+export { type A11yMetadata, AXIS_TITLE_GAP, 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 ArcEncoding, type ArcMark, type AreaEncoding, 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 BarEncoding, type BarListEncoding, type BarListLayout, type BarListRowMark, type BarListSpec, type BarListSpecWithoutData, type BarTableCell, type BaseLegendLayout, type BinParams, type BinTransform, type Breakpoint, CATEGORICAL_PALETTE, CHART_ENCODING_RULES, CHART_TYPES, COMPACT_WIDTH, type CalculateExpression, type CalculateTransform, type CategoricalLegendLayout, 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 CircleEncoding, type ColorBlindnessType, type ColumnConfig, type CompileOptions, type CompileTableOptions, type Condition, type ConditionalValueDef, DEFAULT_THEME, DIVERGING_PALETTES, type DarkMode, type DataRow, type DateGranularity, type Display, type DivergingPalette, EXTENDED_OFFSET_STRATEGIES, type ElementEdit, type ElementRef, type Encoding, type EncodingChannel, type EncodingRule, type EndpointLabelEntry, type EndpointLabelsConfig, type EndpointLabelsLayout, type FieldPredicate, type FieldRef, type FieldType, type FilterPredicate, type FilterTransform, type FlagTableCell, type FoldTransform, GRAPH_ENCODING_RULES, type GradientColorStop, type GradientDef, type GradientLegendLayout, 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 LabelSpec, type LayerSpec, type LayoutStrategy, type LegendConfig, type LegendEntry, type LegendLayout, type LegendPosition, type LineEncoding, type LineMark, type LinearGradient, type LogicalAnd, type LogicalNot, type LogicalOr, type LollipopEncoding, 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, type Metric, NARROW_VIEWPORT_MAX, type NodeOverride, OFFSET_STRATEGIES, type OffsetStrategy, type PaginationState, type Point, type PointEncoding, type PointMark, type RadialGradient, type RangeAnnotation, type Rect, type RectEncoding, type RectMark, type RefLineAnnotation, type RelativeTimeRef, type ResolveConfig, type ResolveMode, type ResolvedAnimation, type ResolvedAnnotation, type ResolvedChrome, type ResolvedChromeElement, type ResolvedColumn, type ResolvedLabel, type ResolvedMetricBar, type ResolvedMetricCell, 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 TextEncoding, type TextMarkLayout, type TextStyle, type TextTableCell, type Theme, type ThemeChromeDefaults, type ThemeColors, type ThemeConfig, type ThemeFontSizes, type ThemeFontWeights, type ThemeFonts, type ThemeSpacing, type TickEncoding, type TickMarkLayout, type TileMapBuilderOptions, type TileMapEncoding, type TileMapLayout, type TileMapPalette, type TileMapSpec, type TileMapSpecWithoutData, type TileMapTileMark, type TimeUnit, type TimeUnitTransform, type TooltipContent, type TooltipField, type Transform, type VizSpec, type WindowFieldDef, type WindowOp, type WindowSortField, type WindowTransform, abbreviateNumber, adaptColorForDarkMode, adaptTheme, areaChart, axisTitleOffset, 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, isBarListSpec, isChartSpec, isConditionalDef, isEncodingChannel, isGradientDef, isGraphSpec, isLayerSpec, isRangeAnnotation, isRefLineAnnotation, isSankeySpec, isTableSpec, isTextAnnotation, isTileMapSpec, lineChart, meetsAA, pickLabelColor, pieChart, resolveCollisions, resolveMarkDef, resolveMarkType, resolveTheme, scatterChart, simulateColorBlindness, tileMap, wrapText };

package/dist/index.js

@@ -839,7 +839,9 @@ var DEFAULT_THEME = {
       subtitle: 14,
       body: 13,
       small: 11,
-      axisTick: 11
+      axisTick: 11,
+      metricLabel: 10,
+      metricValue: 22
     },
     weights: {
       normal: 450,
@@ -855,7 +857,10 @@ var DEFAULT_THEME = {
     chartToFooter: 8,
     axisMargin: 6,
     xAxisHeight: 26,
-    xAxisLabelPadding: 14
+    // Gap (px) between the x-axis line and the TOP of the tick labels. The
+    // renderer anchors x-tick labels at their top edge (hanging baseline), so
+    // this is a literal top gap that holds regardless of font size.
+    xAxisLabelPadding: 4
   },
   borderRadius: 2,
   chrome: {
@@ -1578,7 +1583,12 @@ var HPAD_COMPACT_FRACTION = 0.5;
 var HPAD_COMPACT_MIN = 4;
 var TICK_LABEL_OFFSET = 6;
 var AXIS_TITLE_TRAILING_PAD = 4;
-var AXIS_TITLE_GAP = 14;
+var AXIS_TITLE_GAP = 7;
+function axisTitleOffset(maxTickLabelWidth, titleFontSize, width) {
+  const halfTitleGlyph = Math.ceil(titleFontSize / 2);
+  const dynamic = TICK_LABEL_OFFSET + maxTickLabelWidth + AXIS_TITLE_GAP + halfTitleGlyph;
+  return Math.max(dynamic, getAxisTitleOffset(width));
+}
 var NARROW_VIEWPORT_MAX = 500;
 var TOP_PAD_EXTRA_NARROW = 10;
 var TOP_PAD_NARROW_MAX = NARROW_VIEWPORT_MAX;
@@ -3087,6 +3097,7 @@ export {
   adaptColorForDarkMode,
   adaptTheme,
   areaChart,
+  axisTitleOffset,
   barChart,
   buildD3Formatter,
   buildTemporalFormatter,