@fundar/data-chart-telling 1.17.0 → 1.19.0

package/dist/plots/ranking/dumbbell/Plot.svelte

@@ -1,5 +1,5 @@
 <script lang="ts" generics="TData extends Record<string, unknown>">
-	import Plot from '../../../layout/plot/Plot.svelte';
+	import AbstractPlot from '../../../layout/plot/AbstractPlot.svelte';
 	import { buildDumbbellDefaults } from './defaults';
 	import type {
 		DumbbellPlotProps,
@@ -28,7 +28,7 @@
 	}: DumbbellPlotProps<TData> = $props();
 </script>
 
-<Plot
+<AbstractPlot
 	core={core as DumbbellPlotCoreProps<TData>}
 	defaults={buildDumbbellDefaults}
 	bind:margins

package/dist/plots/ranking/dumbbell/Plot.svelte.d.ts

@@ -1,4 +1,3 @@
-import Plot from '../../../layout/plot/Plot.svelte';
 import type { DumbbellPlotProps } from '../../../types/plots/ranking/dumbbell/props';
 declare function $$render<TData extends Record<string, unknown>>(): {
     props: DumbbellPlotProps<TData>;

package/dist/plots/ranking/dumbbell/defaults.d.ts

@@ -1,9 +1,9 @@
 import type { AxisPlotDefaults } from '../../../types/phases';
-import type { DumbbellPlotState, DumbbellPlotCtx } from '../../../types/plots/ranking/dumbbell/state';
+import type { DumbbellPlotState, DumbbellPlotEnv } from '../../../types/plots/ranking/dumbbell/state';
 /**
  * DumbbellPlot on the shared pipeline: a ClevelandPlot of exactly two series,
  * so every category is two dots joined by a connector - the change, or the gap,
  * between them. It warns when it has another number of series, which
  * `LollipopPlot` (one) and `ClevelandPlot` (any) are for.
  */
-export declare function buildDumbbellDefaults<TData extends Record<string, unknown>>(): AxisPlotDefaults<DumbbellPlotState<TData>, DumbbellPlotCtx>;
+export declare function buildDumbbellDefaults<TData extends Record<string, unknown>>(): AxisPlotDefaults<DumbbellPlotState<TData>, DumbbellPlotEnv>;

package/dist/plots/ranking/forest/Plot.svelte

@@ -1,5 +1,5 @@
 <script lang="ts" generics="TData extends Record<string, unknown>">
-	import Plot from '../../../layout/plot/Plot.svelte';
+	import AbstractPlot from '../../../layout/plot/AbstractPlot.svelte';
 	import { buildForestDefaults } from './defaults';
 	import type { ForestPlotProps, ForestPlotCoreProps } from '../../../types/plots/ranking/forest/props';
 
@@ -25,7 +25,7 @@
 	}: ForestPlotProps<TData> = $props();
 </script>
 
-<Plot
+<AbstractPlot
 	core={core as ForestPlotCoreProps<TData>}
 	defaults={buildForestDefaults}
 	bind:margins

package/dist/plots/ranking/forest/Plot.svelte.d.ts

@@ -1,4 +1,3 @@
-import Plot from '../../../layout/plot/Plot.svelte';
 import type { ForestPlotProps } from '../../../types/plots/ranking/forest/props';
 declare function $$render<TData extends Record<string, unknown>>(): {
     props: ForestPlotProps<TData>;

package/dist/plots/ranking/forest/defaults.d.ts

@@ -1,5 +1,5 @@
 import type { AxisPlotDefaults } from '../../../types/phases';
-import type { ForestPlotState, ForestPlotCtx } from '../../../types/plots/ranking/forest/state';
+import type { ForestPlotState, ForestPlotEnv } from '../../../types/plots/ranking/forest/state';
 /**
  * ForestPlot on the shared pipeline: a ClevelandPlot whose dot is an estimate
  * and whose stem is its interval - each row's `lower` and `upper`, or `error`
@@ -8,4 +8,4 @@ import type { ForestPlotState, ForestPlotCtx } from '../../../types/plots/rankin
  * for - or `facet`, to compare the series side by side. The value axis fits the
  * intervals' ends.
  */
-export declare function buildForestDefaults<TData extends Record<string, unknown>>(): AxisPlotDefaults<ForestPlotState<TData>, ForestPlotCtx>;
+export declare function buildForestDefaults<TData extends Record<string, unknown>>(): AxisPlotDefaults<ForestPlotState<TData>, ForestPlotEnv>;

package/dist/plots/ranking/lollipop/Plot.svelte

@@ -1,5 +1,5 @@
 <script lang="ts" generics="TData extends Record<string, unknown>">
-	import Plot from '../../../layout/plot/Plot.svelte';
+	import AbstractPlot from '../../../layout/plot/AbstractPlot.svelte';
 	import { buildLollipopDefaults } from './defaults';
 	import type {
 		LollipopPlotProps,
@@ -28,7 +28,7 @@
 	}: LollipopPlotProps<TData> = $props();
 </script>
 
-<Plot
+<AbstractPlot
 	core={core as LollipopPlotCoreProps<TData>}
 	defaults={buildLollipopDefaults}
 	bind:margins

package/dist/plots/ranking/lollipop/Plot.svelte.d.ts

@@ -1,4 +1,3 @@
-import Plot from '../../../layout/plot/Plot.svelte';
 import type { LollipopPlotProps } from '../../../types/plots/ranking/lollipop/props';
 declare function $$render<TData extends Record<string, unknown>>(): {
     props: LollipopPlotProps<TData>;

package/dist/plots/ranking/lollipop/defaults.d.ts

@@ -1,9 +1,9 @@
 import type { AxisPlotDefaults } from '../../../types/phases';
-import type { LollipopPlotState, LollipopPlotCtx } from '../../../types/plots/ranking/lollipop/state';
+import type { LollipopPlotState, LollipopPlotEnv } from '../../../types/plots/ranking/lollipop/state';
 /**
  * LollipopPlot on the shared pipeline: a ClevelandPlot of one value per
  * category, whose stem rises from the baseline - zero, or the nearest end of a
  * pinned value domain - to the dot. It warns when a category has values in
  * several series, which `DumbbellPlot` and `ClevelandPlot` are for.
  */
-export declare function buildLollipopDefaults<TData extends Record<string, unknown>>(): AxisPlotDefaults<LollipopPlotState<TData>, LollipopPlotCtx>;
+export declare function buildLollipopDefaults<TData extends Record<string, unknown>>(): AxisPlotDefaults<LollipopPlotState<TData>, LollipopPlotEnv>;

package/dist/types/configuration/styling.d.ts

@@ -243,6 +243,8 @@ export type PlotStylesConfig = {
         dot: DotStyle;
         font: FontStyle;
         area: AreaStyle;
+        /** How a hovered shape looks on a plot whose hover only restyles its shapes (a treemap's tile, a heatmap's cell). */
+        active: StrokeStyle;
     };
     facet: {
         /** Position badge shown in `carousel`/`paginated` facet modes. */
@@ -379,6 +381,8 @@ export type PlotStylesConfig = {
         /** Gap, in px, between a connector and its label when it is written beside it. */
         labelGap: number;
     };
+    /** The `band` marker's style, under its own `styles`. */
+    band: AreaStyle;
     /** The `delta` marker's label offset and anchor, per axis the delta is taken on. A marker's own `text` wins. */
     delta: {
         text: Record<'x' | 'y', {

package/dist/types/layout/context.d.ts

@@ -0,0 +1,23 @@
+/**
+ * What a plot knows of one of the rows it draws: the series it is drawn in, where it sits, and the value it shows
+ * - the dataset's own, or the one the plot works out for it (a density's estimate, a bin's count). It is worked
+ * out once per row, as the plot reads its data, and every place that writes about a row reads it: a tooltip's
+ * `format`, a hover's points and labels, the value labels, and an author's own markers (see `RowContext.of`).
+ * A plot kind that works out more about a row gives a type that extends this one.
+ */
+export type PlotRowContext<TRow = Record<string, unknown>> = {
+    /** The name of the series the row is drawn in, on the plots that have series. */
+    series?: string;
+    /** The row's value on `x`: its own (not a stack's running total), else where the plot's transforms put it. */
+    x?: unknown;
+    /** The row's value on `y`, as `x`. */
+    y?: unknown;
+    /** The value the row shows, on the plot's value axis, when it is a number. */
+    value?: number;
+    /** The row itself, as the plot drew it: the data's fields, plus whatever its transforms added. */
+    row?: TRow;
+    /** Which of the row's values a label writes, on a plot whose rows have several (`styles.values.parts`). */
+    part?: string;
+};
+/** A plot kind's own context of a row: the shared one, with what the kind works out for it. */
+export type KindRowContext<TExtra extends object, TRow = Record<string, unknown>> = PlotRowContext<TRow> & TExtra;

package/dist/types/layout/context.js

@@ -0,0 +1 @@
+export {};

package/dist/types/layout/hover.d.ts

@@ -1,3 +1,4 @@
+import type { PlotRowContext } from './context';
 import type { AxisValue } from './mapping';
 /**
  * How the hover highlight finds related points within a facet.
@@ -41,6 +42,8 @@ export type HoverDisplayPoint = {
     color?: string;
     /** A 'grouped' series' own slice of the category band, as start/end fractions (0-1) of the whole band. `undefined` means the whole band. */
     areaInset?: BandSlice;
+    /** What the plot knows of the point's row: its series, where it sits, its value and whatever its kind works out - see {@link PlotRowContext}. */
+    context?: PlotRowContext;
 };
 /** A candidate point for hover matching/highlighting - also carries its source row. */
 export type HoverPoint<T> = HoverDisplayPoint & {

package/dist/types/layout/styles/bullet.d.ts

@@ -1,7 +1,10 @@
+import type { WithValues, BarValueLabel } from './values';
 import type { GapsAwarePlotStylesConfig } from './gaps';
 import type { BarSegmentStyle } from '../../plots/segments/common';
+/** The values of a bullet's row its value labels can write: its bar's, its target, its ranges' bounds. */
+export type BulletValuePart = 'value' | 'target' | 'ranges';
 /** `BulletPlot`'s `styles`: a bar plot's, with the look of its ranges and its target. Each field falls back to `bullet` in the configuration. */
-export type BulletStylesConfig = GapsAwarePlotStylesConfig<BarSegmentStyle> & {
+export type BulletStylesConfig = WithValues<GapsAwarePlotStylesConfig<BarSegmentStyle>, BarValueLabel, BulletValuePart> & {
     /** The bar that shows the value. */
     bar?: {
         /** Its thickness across the category band, in px. */

package/dist/types/layout/styles/values.d.ts

@@ -1,6 +1,10 @@
-import type { ValueAnchor } from '../../plots/constants';
+import type { MarkerLabelConfig } from '../../markers/labels/common';
+import type { BoxLabelConfig } from '../../markers/labels/box';
+import type { PointLabelConfig } from '../../markers/labels/point';
+import type { AreaEdgeLabelConfig, PageEdge, PathLabelConfig, RimLabelConfig, StrokeLabelConfig, ValueEdge } from '../../markers/labels/path';
 import type { FontStyle, StrokeStyle } from '../../plots/styling';
 import type { NumberDisplay } from '../numbers';
+import type { PlotRowContext } from '../context';
 /**
  * Which of a group's rows get a value label: its first or last, or the one
  * with the lowest or highest value (read on the plot's value axis). The group
@@ -13,17 +17,42 @@ export type ValueSelect = 'first' | 'last' | 'min' | 'max';
  * marker over the rows the plot itself draws (after its own `transforms`):
  * one at the end of each series on a line or area plot, one per bar on a bar,
  * pyramid or histogram plot, one per point on a scatter plot and one per cell
- * on a heatmap. The high-level `anchor` sets sensible defaults for placement;
- * `fontStyle` (`dx`, `dy`, `textAnchor`, `lineAnchor`, `lineHeight`, `rotate`,
- * `class`, `textClass`, `fill`, …) overrides those defaults field-by-field when
- * provided - mirrors {@link DeltaConfig}'s `fontStyle`/`strokeStyle` split, so
- * label text and connector-line styling never mix into one flat bag of props.
+ * on a heatmap. `layout` and its options place them as a marker's `label` would (each
+ * plot kind takes the layouts its shapes do, with defaults of its own for each);
+ * `fontStyle` (`fill`, `fontSize`, `lineHeight`, `rotate`, `class`, …) styles
+ * the text, never where it sits - mirrors {@link DeltaConfig}'s
+ * `fontStyle`/`strokeStyle` split, so label text and connector-line styling
+ * never mix into one flat bag of props.
  */
-export type ValuesStyle = NumberDisplay & {
-    /** Whether the labels are drawn. Off by default, except on a heatmap. */
+/** The options of a label that place it, as `styles.values` takes them: its `layout` optional, the kind's by default. */
+type LayoutKey = 'anchor' | 'edge' | 'side' | 'offset' | 'gap';
+export type ValueLayoutOf<TLabel> = TLabel extends {
+    layout?: infer TLayout;
+} ? Pick<TLabel, Extract<keyof TLabel, LayoutKey>> & {
+    layout?: TLayout;
+} : never;
+/**
+ * `TStyles` with its `values` taking only the labels of `TLabel` - the layouts a plot kind's shapes write - and, on a
+ * kind whose rows have several values, the `TPart`s it can label.
+ */
+export type WithValues<TStyles, TLabel extends MarkerLabelConfig, TPart extends string = 'value'> = Omit<TStyles, 'values'> & {
+    values?: ValuesStyle<TLabel, TPart>;
+};
+export type ValuesStyle<TLabel extends MarkerLabelConfig = MarkerLabelConfig, TPart extends string = string> = ValuesOptions & ValueLayoutOf<TLabel> & {
+    parts?: ValueParts<TPart, TLabel>;
+};
+/** What a part's own label sets, over the plot's: where it sits and its text. */
+export type ValuePartOptions<TLabel = MarkerLabelConfig> = Omit<ValueLayoutOf<TLabel>, 'layout'> & Pick<ValuesOptions, 'format'>;
+/**
+ * The parts of each row a plot kind with several values per row labels - a box's `median`, a bullet's `target`: a
+ * list of them, or a record turning each on (`true`) or setting its own options.
+ */
+export type ValueParts<TPart extends string, TLabel = MarkerLabelConfig> = TPart[] | Partial<Record<TPart, boolean | ValuePartOptions<TLabel>>>;
+/** A value label's text style, without what places it: the layout's options do that. */
+export type ValuesFontStyle = Omit<FontStyle, 'textAnchor' | 'lineAnchor' | 'dx' | 'dy'>;
+type ValuesOptions = NumberDisplay & {
+    /** Whether the labels are drawn. Setting any other option of them turns them on; off by default, except on a heatmap. */
     show?: boolean;
-    /** Where each label sits on its mark - see {@link ValueAnchor}. */
-    anchor?: ValueAnchor;
     /**
      * Which rows of each group are labelled: one selector, or a list of them (a
      * row picked by any is labelled) - see {@link ValueSelect}. Each plot has its
@@ -38,11 +67,28 @@ export type ValuesStyle = NumberDisplay & {
      * CSS color writes them all in it. `fontStyle.fill` wins when it is set.
      */
     color?: 'series' | (string & {});
-    /** A label's text, in place of the value as `decimals`, `prefix`, `suffix` and `signDisplay` write it, from its row's own value (a histogram bin's count) and its series - and, on the plots that label one row each, that row, for the other fields of the data. */
-    format?: (value: number, seriesName: string, row?: Record<string, unknown>, number?: (value: number) => string) => string;
+    /**
+     * A label's text, in place of the value as `decimals`, `prefix`, `suffix` and `signDisplay` write it: from the
+     * value it shows (a histogram bin's count, a tile's share), `number`, which writes a value as those fields ask,
+     * and `context`, what the plot knows of the labelled row - its `series`, `x`, `y`, whatever its kind works out
+     * and, where the label has one, the `row` itself, for the other fields of the data (see {@link PlotRowContext}).
+     */
+    format?: (value: number, number: (value: number) => string, context: PlotRowContext) => string;
     /** Hovering a label dims every other series, like toggling them off in the legend. */
     hoverIsolate?: boolean;
-    fontStyle?: FontStyle;
+    /** The text's look; where it sits is the layout's (`side`, `gap`, `offset`...). */
+    fontStyle?: ValuesFontStyle;
     /** The connectors a line or area plot routes back from labels that had to move apart. */
     strokeStyle?: StrokeStyle;
 };
+/** The labels a plot of bars writes on them: in each, along an edge (its `tip` too) or beside a point of it. */
+export type BarValueLabel = BoxLabelConfig | PathLabelConfig<PageEdge | ValueEdge> | PointLabelConfig;
+/** The labels a plot of boxes with no value direction (a heatmap's cells, a histogram's bins) writes on them. */
+export type CellValueLabel = BoxLabelConfig | PathLabelConfig<PageEdge> | PointLabelConfig;
+/** The labels a plot of lines writes: beside its points, or along its lines. */
+export type LineValueLabel = PointLabelConfig | StrokeLabelConfig;
+/** The labels a plot of areas writes: beside its points, or along their top or bottom edge. */
+export type AreaValueLabel = PointLabelConfig | AreaEdgeLabelConfig;
+/** The labels a plot of dots writes: beside them, or around their rim. */
+export type DotValueLabel = PointLabelConfig | RimLabelConfig;
+export {};

package/dist/types/layout/tooltip.d.ts

@@ -1,6 +1,7 @@
 import type { Snippet } from 'svelte';
 import type { HoverStrategy } from './hover';
 import type { NumberDisplay } from './numbers';
+import type { PlotRowContext } from './context';
 /**
  * Preferred horizontal placement of the tooltip beside the cursor; it moves
  * to the other side when it would overflow. Defaults to `'right'`.
@@ -12,15 +13,8 @@ export type TooltipAnchorY = 'top' | 'middle' | 'bottom';
 export type TooltipRow<TRow> = TRow & {
     seriesColor?: string;
 };
-/**
- * What a plot knows of a hovered row beyond its own fields, the third argument of a tooltip's `format`:
- * the series it is drawn in, on the plots that have series. A plot kind that works out more about a row
- * gives a type that extends this one.
- */
-export type TooltipContext = {
-    /** The name of the series the row is drawn in. */
-    series?: string;
-};
+/** What a plot knows of a hovered row, the third argument of a tooltip's `format` - see {@link PlotRowContext}. */
+export type TooltipContext = PlotRowContext;
 /**
  * Author-facing tooltip option on the chart kinds. `true` = enable with defaults. `decimals`, `prefix`,
  * `suffix` and `signDisplay` write the value the default text shows - the one on the plot's value axis (the
@@ -33,7 +27,8 @@ export type TooltipOptions<TRow extends Record<string, unknown>, TContext extend
     sync?: boolean;
     /**
      * Custom tooltip text for a row (supports `\n`). Defaults per chart kind. `number` writes a value as the display
-     * fields above ask, and `context` is what the plot knows of the row - see {@link TooltipContext}.
+     * fields above ask, and `context` is what the plot knows of the row: its series, `x`, `y`, the value it shows and
+     * whatever its kind works out (a tile's share, a box's quartiles) - see {@link PlotRowContext}.
      */
     format?: (row: TRow, number: (value: number) => string, context: TContext) => string;
     /** Named subset of crossing series to include. Omitted = all matched. */

package/dist/types/markers/axis/area.d.ts

@@ -1,3 +1,7 @@
+import type { AreaEdgeLabelConfig } from '../labels/path';
+import type { CommonMarkerConfigWithOrientation } from '../channels/commonMarkerConfigWithOrientation';
+import type { PointLabelConfig } from '../labels/point';
+import type { CommonMarkerConfigWithLabel } from '../channels/commonMarkerConfigWithLabel';
 import type { AreaStyle } from '../../plots/styling';
 import type { CommonMarkerConfigWithArea } from '../channels/commonMarkerConfigWithArea';
 import type { CommonMarkerConfigWithColor } from '../channels/commonMarkerConfigWithColor';
@@ -9,4 +13,4 @@ export type AreaMarkerConfig = {
     curve?: CurveName;
     tension?: number;
     styles?: AreaStyle;
-} & CommonMarkerConfigWithArea & CommonMarkerConfigWithColor & CommonMarkerConfigWithInterval;
+} & CommonMarkerConfigWithOrientation & CommonMarkerConfigWithArea & CommonMarkerConfigWithColor & CommonMarkerConfigWithInterval & CommonMarkerConfigWithLabel<AreaEdgeLabelConfig | PointLabelConfig>;

package/dist/types/markers/axis/axisBasedMarkersConfig.d.ts

@@ -23,8 +23,9 @@ import type { TrailMarkerConfig } from './trail';
 import type { WaffleMarkerConfig } from './waffle';
 import type { ViolinMarkerConfig } from './violin';
 import type { RuleMarkerConfig } from './rule';
+import type { BandMarkerConfig } from './band';
 import type { HoverMarkerConfig } from './hover';
 import type { CustomComponentMarkerConfig } from './component';
 import type { DeltaMarkerConfig } from './delta';
 /** Every marker kind an axis-based plot can render. */
-export type AxisBasedMarkersConfig = BasicMarkersConfig | LineMarkerConfig | BarMarkerConfig | CellMarkerConfig | RectMarkerConfig | RegressionMarkerConfig | BollingerMarkerConfig | AreaMarkerConfig | DensityMarkerConfig | BoxMarkerConfig | HullMarkerConfig | DifferenceMarkerConfig | ArrowMarkerConfig | BrushMarkerConfig | DelaunayLinkMarkerConfig | DelaunayMeshMarkerConfig | VoronoiMarkerConfig | VoronoiMeshMarkerConfig | ImageMarkerConfig | RasterMarkerConfig | TickMarkerConfig | TrailMarkerConfig | WaffleMarkerConfig | ViolinMarkerConfig | RuleMarkerConfig | HoverMarkerConfig | CustomComponentMarkerConfig | DeltaMarkerConfig;
+export type AxisBasedMarkersConfig = BasicMarkersConfig | LineMarkerConfig | BarMarkerConfig | CellMarkerConfig | RectMarkerConfig | RegressionMarkerConfig | BollingerMarkerConfig | AreaMarkerConfig | DensityMarkerConfig | BoxMarkerConfig | HullMarkerConfig | DifferenceMarkerConfig | ArrowMarkerConfig | BrushMarkerConfig | DelaunayLinkMarkerConfig | DelaunayMeshMarkerConfig | VoronoiMarkerConfig | VoronoiMeshMarkerConfig | ImageMarkerConfig | RasterMarkerConfig | TickMarkerConfig | TrailMarkerConfig | WaffleMarkerConfig | ViolinMarkerConfig | RuleMarkerConfig | BandMarkerConfig | HoverMarkerConfig | CustomComponentMarkerConfig | DeltaMarkerConfig;

package/dist/types/markers/axis/band.d.ts

@@ -0,0 +1,24 @@
+import type { AxisValue } from '../../layout/mapping';
+import type { BandSlice } from '../../layout/hover';
+import type { AreaStyle, PerRow } from '../../plots/styling';
+import type { CommonMarkerConfig } from '../channels/commonMarkerConfig';
+/**
+ * The band of a category on a band axis, across the whole of the other axis: one per category, however many rows
+ * name it. On an axis that is not a band scale it draws nothing.
+ */
+export type BandMarkerConfig = {
+    type: 'band';
+    axis: 'x' | 'y';
+    /**
+     * Which band. A list draws one at each category (without `data`); with `data`, a field key or a function of the
+     * row gives each row's own.
+     */
+    value: AxisValue | string | (AxisValue | string)[] | ((d: any) => AxisValue);
+    /**
+     * The part of the band it fills, as the fractions of its width left out at its start and its end (a grouped
+     * bar's series' slice). A function of the row gives each row's own; a band several rows share fills what all of
+     * them do. Unset, the whole band.
+     */
+    slice?: BandSlice | ((d: any) => BandSlice | undefined);
+    styles?: PerRow<AreaStyle>;
+} & Omit<CommonMarkerConfig, 'x' | 'y'>;

package/dist/types/markers/axis/band.js

@@ -0,0 +1 @@
+export {};

package/dist/types/markers/axis/bar.d.ts

@@ -1,14 +1,17 @@
+import type { PathLabelConfig, PageEdge, ValueEdge } from '../labels/path';
+import type { BoxLabelConfig } from '../labels/box';
+import type { PointLabelConfig } from '../labels/point';
+import type { CommonMarkerConfigWithOrientation } from '../channels/commonMarkerConfigWithOrientation';
 import type { AxisValue } from '../../layout/mapping';
 import type { AreaStyle, PerRow, InsetStyle } from '../../plots/styling';
 import type { CommonMarkerConfigWithLabel } from '../channels/commonMarkerConfigWithLabel';
 import type { CommonMarkerConfigWithColor } from '../channels/commonMarkerConfigWithColor';
 import type { CommonMarkerConfigWithInterval } from '../channels/commonMarkerConfigWithInterval';
-/** A bar mark; `role` tells a visible segment from the hover hit area and highlight. */
+/** A bar mark; `role` tells a visible segment from the hover hit area. */
 export type BarMarkerConfig = {
     type: 'bar';
-    role: 'segment' | 'hitArea' | 'highlight';
-    isHorizontal: boolean;
+    role: 'segment' | 'hitArea';
     thickness?: number;
     styles?: PerRow<AreaStyle> & InsetStyle;
     category?: AxisValue;
-} & CommonMarkerConfigWithColor & CommonMarkerConfigWithInterval & CommonMarkerConfigWithLabel;
+} & CommonMarkerConfigWithOrientation & CommonMarkerConfigWithColor & CommonMarkerConfigWithInterval & CommonMarkerConfigWithLabel<BoxLabelConfig | PathLabelConfig<PageEdge | ValueEdge> | PointLabelConfig>;

package/dist/types/markers/axis/bollinger.d.ts

@@ -1,6 +1,7 @@
+import type { CommonMarkerConfigWithOrientation } from '../channels/commonMarkerConfigWithOrientation';
 import type { BollingerStatisticOptions } from '../../layout/statistics';
 import type { CommonMarkerConfig } from '../channels/commonMarkerConfig';
 /** A moving-average band (svelteplot's `BollingerX`/`BollingerY`). */
 export type BollingerMarkerConfig = {
     type: 'bollinger';
-} & BollingerStatisticOptions & CommonMarkerConfig;
+} & CommonMarkerConfigWithOrientation & BollingerStatisticOptions & CommonMarkerConfig;

package/dist/types/markers/axis/box.d.ts

@@ -1,3 +1,4 @@
+import type { CommonMarkerConfigWithOrientation } from '../channels/commonMarkerConfigWithOrientation';
 import type { CommonMarkerConfig } from '../channels/commonMarkerConfig';
 /**
  * A box plot (svelteplot's `BoxX`/`BoxY`). Styled per sub-mark through `bar`,
@@ -16,4 +17,4 @@ export type BoxMarkerConfig = {
         index: number;
         count: number;
     };
-} & CommonMarkerConfig;
+} & CommonMarkerConfigWithOrientation & CommonMarkerConfig;

package/dist/types/markers/axis/cell.d.ts

@@ -1,3 +1,6 @@
+import type { PathLabelConfig, PageEdge } from '../labels/path';
+import type { BoxLabelConfig } from '../labels/box';
+import type { PointLabelConfig } from '../labels/point';
 import type { AreaStyle, PerRow, InsetStyle } from '../../plots/styling';
 import type { CommonMarkerConfigWithArea } from '../channels/commonMarkerConfigWithArea';
 import type { CommonMarkerConfigWithLabel } from '../channels/commonMarkerConfigWithLabel';
@@ -6,4 +9,4 @@ import type { CommonMarkerConfigWithColor } from '../channels/commonMarkerConfig
 export type CellMarkerConfig = {
     type: 'cell';
     styles?: PerRow<AreaStyle & Pick<InsetStyle, 'inset'>>;
-} & CommonMarkerConfigWithColor & CommonMarkerConfigWithArea & CommonMarkerConfigWithLabel;
+} & CommonMarkerConfigWithColor & CommonMarkerConfigWithArea & CommonMarkerConfigWithLabel<BoxLabelConfig | PathLabelConfig<PageEdge> | PointLabelConfig>;

package/dist/types/markers/axis/hover.d.ts

@@ -1,10 +1,54 @@
-import type { AreaStyle, DotStyle, FontStyle, StrokeStyle } from '../../plots/styling';
+import type { AxisBasedMarkersConfig } from './axisBasedMarkersConfig';
 import type { HoverDisplayPoint, HoverStrategy } from '../../layout/hover';
 import type { NumberDisplay } from '../../layout/numbers';
+import type { LineStyle } from '../../plots/constants';
+/** A style value: the same for every shape, or a function of the row a shape draws. */
+type ShapeStyleValue<T> = T | ((row: any) => T);
 /**
- * In-SVG hover highlight: crosshair, dot and label. The label is the hovered value as `decimals`, `prefix`,
- * `suffix` and `signDisplay` write it - as the plot writes it while none of them (nor `numbers.decimals`) is set -
- * unless `format` writes it.
+ * How the shapes of a marker linked to the hover (`hover: true` or `'style'`) look while the hover is on: the
+ * hovered ones under `active`, the rest under `others`. Each value replaces the shape's own, and may be a
+ * function of its row.
+ */
+export type HoverShapeStyle = {
+    fill?: ShapeStyleValue<string>;
+    fillOpacity?: ShapeStyleValue<number>;
+    stroke?: ShapeStyleValue<string>;
+    strokeWidth?: ShapeStyleValue<number>;
+    strokeOpacity?: ShapeStyleValue<number>;
+    strokeDasharray?: string | LineStyle;
+};
+/** `T` with its `K` fields left to be set. */
+type Optional<T, K extends keyof T> = Omit<T, K> & Partial<Pick<T, K>>;
+/** A marker as the hover takes it: a `rule`'s and a `band`'s `value` and a `text`'s `text` default to the point's. */
+type InHover<T> = T extends {
+    type: 'rule' | 'band';
+} ? Optional<T, 'value' & keyof T> : T extends {
+    type: 'text';
+} ? Optional<T, 'text' & keyof T> : T;
+/**
+ * A marker the hover draws: any marker but another hover, over the hovered points. Without `data` of its own its
+ * rows are the points - each its `x`, `y`, `label` (written as the hover marker's number fields ask), `series`,
+ * `color` (its series'), `areaInset` (its slice of the band) and `row` (the row it stands for) - and its `x` and
+ * `y` default to the point's. What it leaves unset comes from the hover: a `rule` sits at each point along its
+ * `axis`, a `band` around it (in its series' slice), a `text` writes its label; each in the configuration's `hover`
+ * look (a `rect` in its `area`), and a `dot` and a `text` in the point's series color.
+ */
+export type HoverLayerMarker = InHover<Exclude<AxisBasedMarkersConfig, {
+    type: 'hover';
+}>> & {
+    /**
+     * Which points it draws: every one the hover matches (the default), only the one under the pointer, or those a
+     * function of the point keeps.
+     */
+    points?: 'all' | 'active' | ((point: HoverDisplayPoint) => boolean);
+};
+/**
+ * The plot's hover, inside the plot: how the hovered shapes look (`active`) and the rest (`others`), and the
+ * markers it draws behind the plot's shapes (`back`) and in front of them (`front`) - a rule, a band, a dot, a
+ * label, a component. Each plot kind has a hover of its own that this one is laid over: `active` and `others`
+ * field by field, `back` and `front` replacing the kind's lists when set (`back: []` draws nothing behind).
+ * The points' label is the hovered value as `decimals`, `prefix`, `suffix` and `signDisplay` write it - as the
+ * plot writes it while none of them (nor `numbers.decimals`) is set - unless `format` writes it.
  */
 export type HoverMarkerConfig = NumberDisplay & {
     type: 'hover';
@@ -12,16 +56,17 @@ export type HoverMarkerConfig = NumberDisplay & {
     scope?: 'series' | 'segment';
     strategy?: HoverStrategy;
     sync?: boolean;
-    ruleX?: boolean;
-    ruleY?: boolean;
-    /** A thickened highlight area in place of a thin crosshair; meaningful on band scales only. */
-    areaX?: boolean;
-    areaY?: boolean;
-    showLabels?: boolean;
-    /** The label's text for a point, in place of the value. `number` writes a value as the display fields above ask. */
+    /** How the hovered shapes of every marker linked to the hover look - the plot's own tiles, bars and cells among them. */
+    active?: HoverShapeStyle;
+    /** How the shapes the hover does not reach look, while it is on. */
+    others?: HoverShapeStyle;
+    /** The markers drawn behind every other one of the plot, over the hovered points. */
+    back?: HoverLayerMarker[];
+    /** The markers drawn in front of the plot's shapes, over the hovered points. */
+    front?: HoverLayerMarker[];
+    /** A point's label, in place of its value. `number` writes a value as the display fields above ask. */
     format?: (point: HoverDisplayPoint, number: (value: number) => string) => string;
-    rule?: StrokeStyle;
-    area?: AreaStyle;
-    dot?: DotStyle;
-    text?: FontStyle;
 };
+/** What a plot kind's own hover is made of, which an author's `hover` marker is laid over. */
+export type HoverLook = Pick<HoverMarkerConfig, 'active' | 'others' | 'back' | 'front'>;
+export {};

package/dist/types/markers/axis/line.d.ts

@@ -1,3 +1,6 @@
+import type { StrokeLabelConfig } from '../labels/path';
+import type { PointLabelConfig } from '../labels/point';
+import type { CommonMarkerConfigWithLabel } from '../channels/commonMarkerConfigWithLabel';
 import type { StrokeStyle } from '../../plots/styling';
 import type { CurveName } from '../../layout/styles/curve';
 import type { CommonMarkerConfigWithColor } from '../channels/commonMarkerConfigWithColor';
@@ -6,4 +9,4 @@ export type LineMarkerConfig = {
     type: 'line';
     curve?: CurveName;
     styles?: StrokeStyle;
-} & CommonMarkerConfigWithColor;
+} & CommonMarkerConfigWithColor & CommonMarkerConfigWithLabel<StrokeLabelConfig | PointLabelConfig>;

package/dist/types/markers/axis/rect.d.ts

@@ -1,3 +1,6 @@
+import type { PathLabelConfig, PageEdge } from '../labels/path';
+import type { BoxLabelConfig } from '../labels/box';
+import type { PointLabelConfig } from '../labels/point';
 import type { AreaStyle, PerRow, InsetStyle } from '../../plots/styling';
 import type { CommonMarkerConfigWithArea } from '../channels/commonMarkerConfigWithArea';
 import type { CommonMarkerConfigWithColor } from '../channels/commonMarkerConfigWithColor';
@@ -8,4 +11,4 @@ export type RectMarkerConfig = {
     type: 'rect';
     interval?: number | string;
     styles?: PerRow<AreaStyle & InsetStyle>;
-} & CommonMarkerConfigWithArea & CommonMarkerConfigWithColor & CommonMarkerConfigWithInterval & CommonMarkerConfigWithLabel;
+} & CommonMarkerConfigWithArea & CommonMarkerConfigWithColor & CommonMarkerConfigWithInterval & CommonMarkerConfigWithLabel<BoxLabelConfig | PathLabelConfig<PageEdge> | PointLabelConfig>;

package/dist/types/markers/axis/regression.d.ts

@@ -1,6 +1,7 @@
+import type { CommonMarkerConfigWithOrientation } from '../channels/commonMarkerConfigWithOrientation';
 import type { RegressionStatisticOptions } from '../../layout/statistics';
 import type { CommonMarkerConfig } from '../channels/commonMarkerConfig';
 /** A fitted regression curve (svelteplot's `RegressionX`/`RegressionY`). */
 export type RegressionMarkerConfig = {
     type: 'regression';
-} & RegressionStatisticOptions & CommonMarkerConfig;
+} & CommonMarkerConfigWithOrientation & RegressionStatisticOptions & CommonMarkerConfig;

package/dist/types/markers/axis/tick.d.ts

@@ -1,3 +1,4 @@
+import type { CommonMarkerConfigWithOrientation } from '../channels/commonMarkerConfigWithOrientation';
 import type { StrokeStyle, PerRow } from '../../plots/styling';
 import type { CommonMarkerConfigWithColor } from '../channels/commonMarkerConfigWithColor';
 /** A short tick per row along one axis (svelteplot's `TickX`/`TickY`). */
@@ -5,4 +6,4 @@ export type TickMarkerConfig = {
     type: 'tick';
     tickLength?: number | ((d: any) => number);
     styles?: PerRow<StrokeStyle>;
-} & CommonMarkerConfigWithColor;
+} & CommonMarkerConfigWithOrientation & CommonMarkerConfigWithColor;

package/dist/types/markers/axis/trail.d.ts

@@ -1,3 +1,6 @@
+import type { StrokeLabelConfig } from '../labels/path';
+import type { PointLabelConfig } from '../labels/point';
+import type { CommonMarkerConfigWithLabel } from '../channels/commonMarkerConfigWithLabel';
 import type { AreaStyle } from '../../plots/styling';
 import type { CommonMarkerConfigWithColor } from '../channels/commonMarkerConfigWithColor';
 import type { CommonMarkerConfigWithRadius } from '../channels/commonMarkerConfigWithRadius';
@@ -10,4 +13,4 @@ export type TrailMarkerConfig = {
     cap?: 'butt' | 'round';
     resolution?: number | 'auto';
     styles?: Pick<AreaStyle, 'fill' | 'fillOpacity'>;
-} & CommonMarkerConfigWithRadius & CommonMarkerConfigWithColor;
+} & CommonMarkerConfigWithRadius & CommonMarkerConfigWithColor & CommonMarkerConfigWithLabel<StrokeLabelConfig | PointLabelConfig>;

package/dist/types/markers/axis/violin.d.ts

@@ -1,3 +1,4 @@
+import type { CommonMarkerConfigWithOrientation } from '../channels/commonMarkerConfigWithOrientation';
 import type { AreaStyle } from '../../plots/styling';
 import type { DensityKernel } from '../../transforms/density';
 import type { CommonMarkerConfig } from '../channels/commonMarkerConfig';
@@ -22,4 +23,4 @@ export type ViolinMarkerConfig = {
         count: number;
     };
     styles?: AreaStyle;
-} & CommonMarkerConfig;
+} & CommonMarkerConfigWithOrientation & CommonMarkerConfig;

package/dist/types/markers/axis/waffle.d.ts

@@ -1,3 +1,7 @@
+import type { PathLabelConfig, PageEdge, ValueEdge } from '../labels/path';
+import type { BoxLabelConfig } from '../labels/box';
+import type { PointLabelConfig } from '../labels/point';
+import type { CommonMarkerConfigWithOrientation } from '../channels/commonMarkerConfigWithOrientation';
 import type { AreaStyle, PerRow } from '../../plots/styling';
 import type { CommonMarkerConfigWithLabel } from '../channels/commonMarkerConfigWithLabel';
 import type { CommonMarkerConfigWithColor } from '../channels/commonMarkerConfigWithColor';
@@ -11,4 +15,4 @@ export type WaffleMarkerConfig = {
     gap?: number;
     round?: boolean;
     styles?: PerRow<AreaStyle>;
-} & CommonMarkerConfigWithColor & CommonMarkerConfigWithInterval & CommonMarkerConfigWithLabel;
+} & CommonMarkerConfigWithOrientation & CommonMarkerConfigWithColor & CommonMarkerConfigWithInterval & CommonMarkerConfigWithLabel<BoxLabelConfig | PathLabelConfig<PageEdge | ValueEdge> | PointLabelConfig>;