minerva-design 1.13.2 → 1.14.0

package/dist/charts/engine/scene.d.ts

@@ -86,11 +86,44 @@ export interface TooltipContent {
  * of the right axis series
  */
 export declare const tooltipContent: (model: ChartModel, event: ChartHoverEvent, yTicks: AxisTicks | null, y2Ticks?: AxisTicks | null) => TooltipContent;
+/** Side of a bar where its baseline is (its start for floating bars) */
+export type BarBase = "top" | "right" | "bottom" | "left";
+/**
+ * A hovered bar redrawn above the data (below the value labels): thicker
+ * by `grow` on both sides across its thickness, never longer (the length
+ * is the value), lifted with a shadow and a ring in a contrasting color
+ */
+export interface BarHoverMark {
+    kind: "bar";
+    /** The bar as drawn on the data layer (pixels of the stage) */
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+    seriesIndex: number;
+    index: number;
+    /** Fill (CSS), with the opacity of the bar */
+    color: string;
+    /** The fill is translucent: drawn over the plot background */
+    backdrop: boolean;
+    /**
+     * Ring inside the edge (CSS): contrasting with solid fills, the solid
+     * color of translucent ones; `null` for the parts drawn over a lifted bar
+     * (the progress of a Gantt task)
+     */
+    ring: string | null;
+    /** Corner radius, like the data layer */
+    radius: number;
+    base: BarBase;
+    /** Pixels added on both sides across the thickness (0 between grouped bars without room) */
+    grow: number;
+}
 /**
  * Shape of the hover marker of an item: a dot with a soft halo on a point,
- * a band behind the hovered bar group / candle, or the outline of a cell
+ * a band behind the hovered bar group / candle, the lifted bar, or the
+ * lifted cell of a heatmap
  */
-export type HoverMark = {
+export type HoverMark = BarHoverMark | {
     kind: "dot";
     x: number;
     y: number;
@@ -112,12 +145,14 @@ export type HoverMark = {
     width: number;
     height: number;
 } | {
-    /** The hovered cell, lifted, with a ring inside its edge */
+    /** The hovered cell, lifted, with a ring at its edge */
     kind: "cell";
     x: number;
     y: number;
     width: number;
     height: number;
+    seriesIndex: number;
+    index: number;
     /** Fill of the cell (CSS) */
     color: string;
     /** Ring color (CSS), contrasting with the fill */
@@ -128,6 +163,11 @@ export type HoverMark = {
 export declare const hoverMarks: (model: ChartModel, sc: Scales, event: ChartHoverEvent) => HoverMark[];
 /** Ring of a hovered cell: light on dark fills, dark on light ones */
 export declare const contrastRing: (fill: Rgba) => string;
+/**
+ * Rectangle of a lifted bar: thicker by `grow` on both sides across its
+ * thickness, the same length
+ */
+export declare const liftedBarRect: (mark: BarHoverMark) => Rect;
 /** A line from the end of a bar to the next bar, pixels of the stage */
 export interface ConnectorSegment {
     x0: number;