@opendata-ai/openchart-engine 7.9.3 → 7.11.0

package/src/legend/compute.ts

@@ -494,6 +494,11 @@ export function computeLegendContent(
  * @param containerWidth - Full container width, used for responsive legend gap.
  * @param _theme - Resolved theme (reserved for future use).
  * @param xAxisHeight - Height of the x-axis, used for bottom legend positioning.
+ * @param axisGapBelowLegend - The `effectiveAxisGap` the margin stack reserved
+ *   between a top legend and the chart area (inline y-tick labels draw in that
+ *   zone, above `chartArea.y`). The top legend is lifted above it so it
+ *   occupies its reserved slot instead of colliding with the topmost tick
+ *   label. Defaults to 0 so other callers/positions are unaffected.
  * @returns Full LegendLayout with bounds.
  */
 export function placeLegend(
@@ -502,6 +507,7 @@ export function placeLegend(
   containerWidth: number,
   _theme: ResolvedTheme,
   xAxisHeight: number,
+  axisGapBelowLegend: number = 0,
 ): LegendLayout {
   const { position, entries, labelStyle, legendWidth, height, offset } = content;
 
@@ -538,7 +544,7 @@ export function placeLegend(
   } else {
     // top
     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 };

package/src/legend/wrap.ts

@@ -34,6 +34,14 @@ export const ENTRY_GAP_COMPACT = 10;
 /** Default gap between legend bounds and chart area. Zero on narrow viewports. */
 export const LEGEND_GAP = 8;
 
+/**
+ * Minimum gap between the chrome/metrics block above and a top legend.
+ * Without it the legend sits flush against the subtitle (compact widths)
+ * or the metric bar (all widths) once the inline-tick overhang is placed
+ * below the legend where it belongs.
+ */
+export const TOP_LEGEND_GAP_ABOVE = 6;
+
 /** Gap between legend and chart area, responsive to container width. */
 export function legendGap(width: number): number {
   return width < COMPACT_WIDTH ? 0 : LEGEND_GAP;