@opendata-ai/openchart-engine 7.10.0 → 7.11.0

package/dist/index.d.ts

@@ -658,6 +658,25 @@ declare function getChartRenderer(type: string): ChartRenderer | undefined;
  */
 declare function clearRenderers(): void;
 
+/**
+ * Legend row-wrap geometry.
+ *
+ * Shared helper for measuring how legend entries flow across horizontal rows
+ * when wrapped at a max width. Both the main legend compute and the sankey
+ * legend compile use this to size their legends — the main legend uses
+ * `fittingCount` for truncation decisions, while sankey uses `rowCount` to
+ * reserve vertical height.
+ *
+ * The geometry matches the existing layout exactly: each entry occupies
+ * SWATCH_SIZE + SWATCH_GAP + labelWidth + ENTRY_GAP pixels, a new row is
+ * started when the accumulated row width plus the next entry would exceed
+ * maxWidth (and the current row is non-empty), and rowWidths captures the
+ * in-row accumulated width at the point of wrapping.
+ */
+
+/** Gap between legend and chart area, responsive to container width. */
+declare function legendGap(width: number): number;
+
 /**
  * Bin transform: discretizes a continuous field into bins.
  *
@@ -792,4 +811,4 @@ declare function runTimeUnit(data: DataRow[], transform: TimeUnitTransform): Dat
  */
 declare function runTransforms(data: DataRow[], transforms: Transform[]): DataRow[];
 
-export { type AnnotationContext, type AnnotationMeasureTextFn, type ChartRenderer, type CompileResult, type CompiledGraphEdge, type CompiledGraphNode, ENTER_DEFAULTS, EXIT_DEFAULTS, type GraphCompilation, type NormalizedBarListSpec, type NormalizedChartSpec, type NormalizedChrome, type NormalizedGraphSpec, type NormalizedSankeySpec, type NormalizedSpec, type NormalizedTableSpec, type NormalizedTileMapSpec, type ObstacleKind, type PlacementObstacle, type SimulationConfig, UPDATE_DEFAULTS, type ValidationError, type ValidationErrorCode, type ValidationResult, buildAreaPath, buildLinePath, clampStaggerDelay, clearRenderers, compile, compileBarList, compileChart, compileGraph, compileLayer, compileSankey, compileTable, compileTileMap, dedupeKeys, evaluatePredicate, getChartRenderer, heuristicMeasure, isConditionalValueDef, normalizeSpec, registerChartRenderer, resolveAnimation, resolveConditionalValue, runBin, runCalculate, runFilter, runTimeUnit, runTransforms, serializeKeyValue, validateSpec };
+export { type AnnotationContext, type AnnotationMeasureTextFn, type ChartRenderer, type CompileResult, type CompiledGraphEdge, type CompiledGraphNode, ENTER_DEFAULTS, EXIT_DEFAULTS, type GraphCompilation, type NormalizedBarListSpec, type NormalizedChartSpec, type NormalizedChrome, type NormalizedGraphSpec, type NormalizedSankeySpec, type NormalizedSpec, type NormalizedTableSpec, type NormalizedTileMapSpec, type ObstacleKind, type PlacementObstacle, type SimulationConfig, UPDATE_DEFAULTS, type ValidationError, type ValidationErrorCode, type ValidationResult, buildAreaPath, buildLinePath, clampStaggerDelay, clearRenderers, compile, compileBarList, compileChart, compileGraph, compileLayer, compileSankey, compileTable, compileTileMap, dedupeKeys, evaluatePredicate, getChartRenderer, heuristicMeasure, isConditionalValueDef, legendGap, normalizeSpec, registerChartRenderer, resolveAnimation, resolveConditionalValue, runBin, runCalculate, runFilter, runTimeUnit, runTransforms, serializeKeyValue, validateSpec };

package/dist/index.js

@@ -10153,6 +10153,7 @@ var SWATCH_GAP = 6;
 var ENTRY_GAP = 16;
 var ENTRY_GAP_COMPACT = 10;
 var LEGEND_GAP = 8;
+var TOP_LEGEND_GAP_ABOVE = 6;
 function legendGap(width) {
   return width < COMPACT_WIDTH ? 0 : LEGEND_GAP;
 }
@@ -10449,7 +10450,7 @@ function computeLegendContent(spec, strategy, theme, availableWidth, availableHe
     rowHeight
   };
 }
-function placeLegend(content, chartArea, containerWidth, _theme, xAxisHeight) {
+function placeLegend(content, chartArea, containerWidth, _theme, xAxisHeight, axisGapBelowLegend = 0) {
   const { position, entries, labelStyle, legendWidth, height, offset } = content;
   if (entries.length === 0) {
     return {
@@ -10477,7 +10478,7 @@ function placeLegend(content, chartArea, containerWidth, _theme, xAxisHeight) {
     boundsY = chartArea.y + chartArea.height + xAxisHeight + gap + offsetDy;
   } else {
     boundsX = chartArea.x + offsetDx;
-    boundsY = chartArea.y - gap - height + offsetDy;
+    boundsY = chartArea.y - axisGapBelowLegend - gap - height + offsetDy;
   }
   const bounds = { x: boundsX, y: boundsY, width: legendWidth, height };
   const entryPositions = resolveEntryPositions(content.relativePositions, bounds);
@@ -11815,7 +11816,7 @@ function resolveLayoutPlan(chartSpec, renderSpec, options, theme, strategy, wate
     const topAxisGap = axisMargin + inlineTickOverhang;
     const effectiveTopAxisGap = hasTopLegend ? inlineTickOverhang : topAxisGap;
     let topMargin = topPad + chrome.topHeight;
-    if (hasTopLegend) topMargin += legendContent.height + gap;
+    if (hasTopLegend) topMargin += TOP_LEGEND_GAP_ABOVE + legendContent.height + gap;
     topMargin += effectiveTopAxisGap;
     const bMargin = bottomMargin(chrome.bottomHeight, padding, xAxisExtent);
     const chartHeight = Math.max(0, height - topMargin - bMargin);
@@ -12969,7 +12970,15 @@ function computeDimensions(spec, options, legendLayout, theme, strategy, waterma
       width: Math.max(0, width - margins2.left - margins2.right),
       height: Math.max(0, height - margins2.top - margins2.bottom)
     };
-    return { total: total2, chrome, chartArea: chartArea2, margins: margins2, theme, xAxisHeight: xAxisSpace };
+    return {
+      total: total2,
+      chrome,
+      chartArea: chartArea2,
+      margins: margins2,
+      theme,
+      xAxisHeight: xAxisSpace,
+      effectiveAxisGap: 0
+    };
   }
   const total = { x: 0, y: 0, width, height };
   const isRadial = spec.markType === "arc";
@@ -13205,10 +13214,11 @@ function computeDimensions(spec, options, legendLayout, theme, strategy, waterma
     if (legendPos === "right" || legendPos === "bottom-right") {
       margins.right += legendBoundsWidth + 8;
     } else if (legendPos === "top") {
-      margins.top += legendHeight + gap;
+      margins.top += TOP_LEGEND_GAP_ABOVE + legendHeight + gap;
     }
   }
-  margins.top += hasTopLegend ? inlineTickOverhang : topAxisGap;
+  const effectiveAxisGap = hasTopLegend ? inlineTickOverhang : topAxisGap;
+  margins.top += effectiveAxisGap;
   let chartArea = {
     x: margins.left,
     y: margins.top,
@@ -13236,7 +13246,7 @@ function computeDimensions(spec, options, legendLayout, theme, strategy, waterma
     const bottomDelta = margins.bottom - newBottom;
     if (topDelta > 0 || bottomDelta > 0) {
       const gap = legendGap(width);
-      margins.top = newTop + (hasTopLegend ? legendHeight + gap : 0) + fallbackEffectiveAxisGap;
+      margins.top = newTop + (hasTopLegend ? TOP_LEGEND_GAP_ABOVE + legendHeight + gap : 0) + fallbackEffectiveAxisGap;
       margins.bottom = newBottom;
       chartArea = {
         x: margins.left,
@@ -13269,7 +13279,8 @@ function computeDimensions(spec, options, legendLayout, theme, strategy, waterma
         margins,
         theme,
         metrics: fallbackMetrics,
-        xAxisHeight
+        xAxisHeight,
+        effectiveAxisGap: fallbackEffectiveAxisGap
       };
     }
   }
@@ -13291,7 +13302,8 @@ function computeDimensions(spec, options, legendLayout, theme, strategy, waterma
     margins,
     theme,
     metrics: resolvedMetrics,
-    xAxisHeight
+    xAxisHeight,
+    effectiveAxisGap
   };
 }
 function resolveMetrics(spec, metricsTopY, metricsArea, remainingChartHeight, measureText, theme) {
@@ -16466,7 +16478,8 @@ function compileChart(spec, options) {
     chartArea,
     options.width,
     theme,
-    plan.xAxisExtent
+    plan.xAxisExtent,
+    dims.effectiveAxisGap
   );
   let scaleArea = chartArea;
   if (plan.inlineYLabelInset > 0 && plan.inlineYLabelInset < chartArea.width) {
@@ -16640,7 +16653,8 @@ function compileFaceted(chartSpec, renderSpec, facetChannel, options, theme, str
     chartArea,
     options.width,
     theme,
-    plan.xAxisExtent
+    plan.xAxisExtent,
+    dims.effectiveAxisGap
   );
   const leftReservation = plan.leftGutter;
   const bottomReservation = plan.xAxisExtent;
@@ -16839,6 +16853,7 @@ export {
   getChartRenderer,
   heuristicMeasure,
   isConditionalValueDef,
+  legendGap,
   normalizeSpec,
   registerChartRenderer,
   resolveAnimation,