@opendata-ai/openchart-core 2.10.0 → 2.12.0

package/dist/index.d.ts

@@ -1834,14 +1834,6 @@ declare function resolveTheme(userTheme?: ThemeConfig, base?: Theme): ResolvedTh
  */
 declare function computeChrome(chrome: Chrome | undefined, theme: ResolvedTheme, width: number, measureText?: MeasureTextFn, chromeMode?: ChromeMode, padding?: number): ResolvedChrome;
 
-/**
- * Heuristic text measurement for environments without a DOM.
- *
- * These are intentionally approximate. Adapters can provide a real
- * measureText function via CompileOptions for higher accuracy.
- * The engine uses the real function when available, falls back to
- * these heuristics when not.
- */
 /**
  * Estimate the rendered width of a text string.
  *
@@ -1853,6 +1845,13 @@ declare function computeChrome(chrome: Chrome | undefined, theme: ResolvedTheme,
  * @param fontWeight - Font weight (100-900). Defaults to 400.
  */
 declare function estimateTextWidth(text: string, fontSize: number, fontWeight?: number): number;
+/**
+ * Width reserved for the "OpenData" brand watermark in the bottom-right corner.
+ * Accounts for ~8 chars at font size 20 with mixed 500/600 weight, plus a gap
+ * so adjacent text doesn't crowd it. Used by chrome and legend layout to avoid
+ * overlapping the brand.
+ */
+declare const BRAND_RESERVE_WIDTH = 110;
 
 /**
  * Label collision detection and resolution.
@@ -1884,6 +1883,10 @@ interface LabelCandidate {
     /** Text style to apply. */
     style: TextStyle;
 }
+/**
+ * Detect AABB (axis-aligned bounding box) overlap between two rectangles.
+ */
+declare function detectCollision(a: Rect, b: Rect): boolean;
 /**
  * Resolve label collisions using a greedy placement algorithm.
  *
@@ -1896,6 +1899,11 @@ interface LabelCandidate {
  * @returns Array of resolved labels with computed positions and visibility.
  */
 declare function resolveCollisions(labels: LabelCandidate[]): ResolvedLabel[];
+/**
+ * Compute the bounding rect of a resolved label from its position and text.
+ * Uses heuristic text measurement so it works without DOM access.
+ */
+declare function computeLabelBounds(label: ResolvedLabel): Rect;
 
 /**
  * Locale-aware number and date formatting utilities.
@@ -2144,4 +2152,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 Annotation, type AnnotationAnchor, type AnnotationOffset, type AnnotationPosition, type ArcMark, type AreaMark, type AxisConfig, type AxisLabelDensity, type AxisLayout, type AxisTick, type BarColumnConfig, type BarTableCell, type Breakpoint, CATEGORICAL_PALETTE, CHART_ENCODING_RULES, CHART_TYPES, 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, DEFAULT_THEME, DIVERGING_PALETTES, type DarkMode, type DataRow, type DateGranularity, type DivergingPalette, type ElementEdit, type Encoding, type EncodingChannel, type EncodingRule, type FieldRef, type FieldType, type FlagTableCell, GRAPH_ENCODING_RULES, 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 LayoutStrategy, type LegendConfig, type LegendEntry, type LegendLayout, type LegendPosition, type LineMark, type Margins, type Mark, type MarkAria, type MarkEvent, type MeasureTextFn, type NodeOverride, type PaginationState, type Point, type PointMark, type RangeAnnotation, type Rect, type RectMark, type RefLineAnnotation, type ResolvedAnnotation, type ResolvedChrome, type ResolvedChromeElement, type ResolvedColumn, type ResolvedLabel, type ResolvedTheme, SEQUENTIAL_PALETTES, type ScaleConfig, 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 TextStyle, type TextTableCell, type Theme, type ThemeChromeDefaults, type ThemeColors, type ThemeConfig, type ThemeFontSizes, type ThemeFontWeights, type ThemeFonts, type ThemeSpacing, type TooltipContent, type TooltipField, type VizSpec, abbreviateNumber, adaptColorForDarkMode, adaptTheme, areaChart, barChart, buildD3Formatter, checkPaletteDistinguishability, columnChart, computeChrome, contrastRatio, dataTable, donutChart, dotChart, estimateTextWidth, findAccessibleColor, formatDate, formatNumber, generateAltText, generateAriaLabels, generateDataTable, getBreakpoint, getHeightClass, getLayoutStrategy, inferFieldType, isChartSpec, isGraphSpec, isRangeAnnotation, isRefLineAnnotation, isTableSpec, isTextAnnotation, lineChart, meetsAA, pieChart, resolveCollisions, resolveTheme, scatterChart, simulateColorBlindness };
+export { type A11yMetadata, type AggregateOp, type Annotation, type AnnotationAnchor, type AnnotationOffset, type AnnotationPosition, type ArcMark, type AreaMark, type AxisConfig, type AxisLabelDensity, type AxisLayout, type AxisTick, BRAND_RESERVE_WIDTH, type BarColumnConfig, type BarTableCell, type Breakpoint, CATEGORICAL_PALETTE, CHART_ENCODING_RULES, CHART_TYPES, 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, DEFAULT_THEME, DIVERGING_PALETTES, type DarkMode, type DataRow, type DateGranularity, type DivergingPalette, type ElementEdit, type Encoding, type EncodingChannel, type EncodingRule, type FieldRef, type FieldType, type FlagTableCell, GRAPH_ENCODING_RULES, 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 LayoutStrategy, type LegendConfig, type LegendEntry, type LegendLayout, type LegendPosition, type LineMark, type Margins, type Mark, type MarkAria, type MarkEvent, type MeasureTextFn, type NodeOverride, type PaginationState, type Point, type PointMark, type RangeAnnotation, type Rect, type RectMark, type RefLineAnnotation, type ResolvedAnnotation, type ResolvedChrome, type ResolvedChromeElement, type ResolvedColumn, type ResolvedLabel, type ResolvedTheme, SEQUENTIAL_PALETTES, type ScaleConfig, 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 TextStyle, type TextTableCell, type Theme, type ThemeChromeDefaults, type ThemeColors, type ThemeConfig, type ThemeFontSizes, type ThemeFontWeights, type ThemeFonts, type ThemeSpacing, type TooltipContent, type TooltipField, type VizSpec, abbreviateNumber, adaptColorForDarkMode, adaptTheme, areaChart, barChart, buildD3Formatter, checkPaletteDistinguishability, columnChart, computeChrome, computeLabelBounds, contrastRatio, dataTable, detectCollision, donutChart, dotChart, estimateTextWidth, findAccessibleColor, formatDate, formatNumber, generateAltText, generateAriaLabels, generateDataTable, getBreakpoint, getHeightClass, getLayoutStrategy, inferFieldType, isChartSpec, isGraphSpec, isRangeAnnotation, isRefLineAnnotation, isTableSpec, isTextAnnotation, lineChart, meetsAA, pieChart, resolveCollisions, resolveTheme, scatterChart, simulateColorBlindness };

package/dist/index.js

@@ -908,10 +908,14 @@ var WEIGHT_ADJUSTMENT = {
   800: 1.1,
   900: 1.12
 };
-function estimateTextWidth(text, fontSize, fontWeight = 400) {
+function estimateCharWidth(fontSize, fontWeight = 400) {
   const weightFactor = WEIGHT_ADJUSTMENT[fontWeight] ?? 1;
-  return text.length * fontSize * AVG_CHAR_WIDTH_RATIO * weightFactor;
+  return fontSize * AVG_CHAR_WIDTH_RATIO * weightFactor;
+}
+function estimateTextWidth(text, fontSize, fontWeight = 400) {
+  return text.length * estimateCharWidth(fontSize, fontWeight);
 }
+var BRAND_RESERVE_WIDTH = 110;
 function estimateTextHeight(fontSize, lineCount = 1, lineHeight = 1.3) {
   return fontSize * lineHeight * lineCount;
 }
@@ -942,16 +946,24 @@ function buildTextStyle(defaults, fontFamily, textColor, width, overrides) {
     dominantBaseline: "hanging"
   };
 }
-function measureWidth(text, style, measureText) {
-  if (measureText) {
-    return measureText(text, style.fontSize, style.fontWeight).width;
+function estimateLineCount(text, style, maxWidth, _measureText) {
+  if (maxWidth <= 0) return 1;
+  const charWidth = estimateCharWidth(style.fontSize, style.fontWeight);
+  const maxChars = Math.floor(maxWidth / charWidth);
+  if (text.length <= maxChars) return 1;
+  const words = text.split(" ");
+  let lines = 1;
+  let current = "";
+  for (const word of words) {
+    const candidate = current ? `${current} ${word}` : word;
+    if (candidate.length > maxChars && current) {
+      lines++;
+      current = word;
+    } else {
+      current = candidate;
+    }
   }
-  return estimateTextWidth(text, style.fontSize, style.fontWeight);
-}
-function estimateLineCount(text, style, maxWidth, measureText) {
-  const fullWidth = measureWidth(text, style, measureText);
-  if (fullWidth <= maxWidth) return 1;
-  return Math.ceil(fullWidth / maxWidth);
+  return lines;
 }
 function computeChrome(chrome, theme, width, measureText, chromeMode = "full", padding) {
   if (!chrome || chromeMode === "hidden") {
@@ -1012,6 +1024,7 @@ function computeChrome(chrome, theme, width, measureText, chromeMode = "full", p
       ...topElements
     };
   }
+  const bottomMaxWidth = maxWidth - BRAND_RESERVE_WIDTH;
   const bottomElements = {};
   let bottomHeight = 0;
   const bottomItems = [];
@@ -1049,14 +1062,14 @@ function computeChrome(chrome, theme, width, measureText, chromeMode = "full", p
         width,
         item.norm.style
       );
-      const lineCount = estimateLineCount(item.norm.text, style, maxWidth, measureText);
+      const lineCount = estimateLineCount(item.norm.text, style, bottomMaxWidth, measureText);
       const height = estimateTextHeight(style.fontSize, lineCount, style.lineHeight);
       bottomElements[item.key] = {
         text: item.norm.text,
         x: pad2 + (item.norm.offset?.dx ?? 0),
         y: bottomHeight + (item.norm.offset?.dy ?? 0),
         // offset from where bottom chrome starts
-        maxWidth,
+        maxWidth: bottomMaxWidth,
         style
       };
       bottomHeight += height + chromeGap;
@@ -1224,6 +1237,19 @@ function resolveCollisions(labels) {
   }
   return results;
 }
+function computeLabelBounds(label) {
+  const fontSize = label.style.fontSize;
+  const fontWeight = label.style.fontWeight;
+  const width = estimateTextWidth(label.text, fontSize, fontWeight);
+  const height = fontSize * (label.style.lineHeight ?? 1.2);
+  let x = label.x;
+  if (label.style.textAnchor === "middle") {
+    x = label.x - width / 2;
+  } else if (label.style.textAnchor === "end") {
+    x = label.x - width;
+  }
+  return { x, y: label.y, width, height };
+}
 
 // ../../node_modules/.bun/d3-format@3.1.2/node_modules/d3-format/src/formatDecimal.js
 function formatDecimal_default(x) {
@@ -2541,6 +2567,7 @@ function dataTable(data, options) {
   return spec;
 }
 export {
+  BRAND_RESERVE_WIDTH,
   CATEGORICAL_PALETTE,
   CHART_ENCODING_RULES,
   CHART_TYPES,
@@ -2557,8 +2584,10 @@ export {
   checkPaletteDistinguishability,
   columnChart,
   computeChrome,
+  computeLabelBounds,
   contrastRatio,
   dataTable,
+  detectCollision,
   donutChart,
   dotChart,
   estimateTextWidth,