@fundar/data-chart-telling 0.0.49 → 0.0.51

package/dist/plots/utils/legendDisabled.js

@@ -1,3 +1,30 @@
+/** Resolves a {@link LegendDisabledAction} into the style a mark should render with — `'omit'` resolves to fully transparent. */
+export function resolveDisabledStyle(action, fallbackOpacity) {
+    if (!action)
+        return undefined;
+    if (action.mode === 'omit')
+        return { opacity: 0 };
+    return action.style ?? { opacity: fallbackOpacity };
+}
+/** Drops series toggled off with `disabled: { mode: 'omit' }` from a series list. */
+export function omitDisabledSeries(series, legendInteraction) {
+    if (!legendInteraction)
+        return series;
+    return series.filter((s) => legendInteraction.disabledSeries.get(s.name)?.mode !== 'omit');
+}
+/** Builds a per-series-name → palette index from the full series list, before {@link omitDisabledSeries} filters it. */
+export function buildSeriesColorIndex(series) {
+    const index = new Map();
+    series.forEach((s, i) => index.set(s.name, i));
+    return index;
+}
+/** Resolves the disabled style for a series by name: legend-off state, falling back to hover-isolate dim. */
+export function resolveEffectiveDisabledStyle(name, legendInteraction, disabledOpacity, hoverIsolate, hoverIsolatedSeries) {
+    return (resolveDisabledStyle(legendInteraction?.disabledSeries.get(name), disabledOpacity) ??
+        (hoverIsolate && hoverIsolatedSeries && hoverIsolatedSeries !== name
+            ? { opacity: disabledOpacity }
+            : undefined));
+}
 /**
  * The three per-mark override layers a legend "disabled" state can apply,
  * derived once from a {@link LegendDisabledStyle}. Each is `undefined` when

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

@@ -37,7 +37,7 @@ export type ChartConfig = {
         gap: string;
         /** swatch square size */
         swatchSize: string;
-        /** Fallback opacity for a legend-disabled series/value when a section doesn't set its own `disabledStyle`. */
+        /** Fallback opacity for a legend-disabled series/value when a section doesn't set its own style. */
         disabledOpacity: number;
         /** Prev/next arrows shown when a `layout: { type: 'horizontal' }` discrete section overflows `maxRows`. */
         navButton: {
@@ -144,6 +144,12 @@ export type ChartConfig = {
     bar: {
         /** Default gap-fill styling (`BarPlot`'s `styles.gaps`) — the fallback merged under whatever a gap zone's own `style` sets. */
         gap: AreaStyle;
+        /** Fallback `scales.z.seriesPadding` (0–1) for 'grouped' series layout, when a plot doesn't set its own. */
+        seriesPadding: number;
+        /** Fallback gap (0–1) *between* category groups on BarPlot's own category axis, when a plot doesn't set its own `scales.x/y.paddingInner`. */
+        paddingInner: number;
+        /** Fallback gap (0–1) before the first and after the last category group on BarPlot's own category axis, when a plot doesn't set its own `scales.x/y.paddingOuter`. */
+        paddingOuter: number;
     };
     /** Default pyramid-bar styling. */
     pyramid: {
@@ -160,7 +166,11 @@ export type ChartConfig = {
         activeColor: string;
         thickness: number;
     };
-    /** In-SVG hover highlight: crosshair rule, dot + value label, and geo feature restyle. */
+    /**
+     * In-SVG hover highlight: crosshair rule, dot + value label, and the area
+     * highlight — a restyled feature on `GeoPlot`, or an `areaX`/`areaY` band
+     * on an axis-based plot's band scale.
+     */
     hover: {
         rule: StrokeStyle;
         dot: DotStyle;

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

@@ -17,6 +17,13 @@ export type LegendDisabledStyle = {
     fill?: string;
     fillOpacity?: number;
 };
+/** What a legend toggle does to a series once it's off: `'style'` dims it in place, `'omit'` removes it from the plot entirely. */
+export type LegendDisabledAction = {
+    mode: 'style';
+    style?: LegendDisabledStyle;
+} | {
+    mode: 'omit';
+};
 export type LegendItem = {
     name: string;
     label?: string;
@@ -28,11 +35,9 @@ export type LegendItem = {
     disabled?: boolean;
 };
 /**
- * How a discrete section's items flow. `'vertical'` (the default) stacks them
- * in a `columns`-wide grid, as it always has. `'horizontal'` flows them left
- * to right, wrapping to new rows as needed — and once wrapped rows exceed
- * `maxRows` (default 1), the section paginates instead of growing taller,
- * surfacing prev/next arrows to page through the rest.
+ * How a discrete section's items flow. `'vertical'` stacks them in a
+ * `columns`-wide grid; `'horizontal'` flows them left to right, paginating
+ * past `maxRows` (default 1) with prev/next arrows.
  */
 export type LegendItemsLayout = {
     type: 'vertical';
@@ -75,8 +80,8 @@ export type DiscreteInteractiveConfig = {
     enabled?: boolean;
     /** Item look while `enabled`. Defaults to `'badge'`. */
     legendStyle?: LegendInteractiveStyle;
-    /** Style applied to a toggled-off item. Defaults to `{ opacity: cfg.legend.disabledOpacity }`. */
-    disabledStyle?: LegendDisabledStyle;
+    /** What happens to a toggled-off item. Defaults to `{ mode: 'style' }`. */
+    disabled?: LegendDisabledAction;
     /** Shows the symbol icon inside a `'badge'` pill. Defaults to `true`; ignored by `'basic'`, which always shows it. */
     showIcon?: boolean;
 };
@@ -85,7 +90,7 @@ export type DiscreteLegendSection = {
     title?: string;
     items: LegendItem[];
     columns?: number;
-    /** Item flow direction. Defaults to `{ type: 'vertical' }` (unchanged prior behaviour). */
+    /** Item flow direction. Defaults to horizontal for a lone section, vertical once there's more than one. */
     layout?: LegendItemsLayout;
     interactive?: DiscreteInteractiveConfig;
     navButton?: LegendNavSnippet;
@@ -129,8 +134,8 @@ export type LegendSection = DiscreteLegendSection | ContinuousLegendSection;
  * own private store via `createLegendInteraction`.
  */
 export type LegendInteractionStore = {
-    /** Legend item name → resolved style to apply. Presence in the map means "disabled". */
-    disabledSeries: SvelteMap<string, LegendDisabledStyle>;
+    /** Legend item name → action to apply. Presence in the map means "disabled". */
+    disabledSeries: SvelteMap<string, LegendDisabledAction>;
     /**
      * The active drag state of the (first) interactive continuous section, or
      * `null` when none is interactive or the user hasn't narrowed it yet (full

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

@@ -5,8 +5,9 @@ import type { AxisValue } from './scales';
  * - `'x'` all points sharing the hovered x (default for line / bar).
  * - `'y'` all points sharing the hovered y (default for pyramid).
  * - `'punctual'` exact XY match — one cell at a time (default for heatmap).
+ * - `'series'` all points sharing the hovered series, regardless of x/y.
  */
-export type HoverStrategy = 'x' | 'y' | 'punctual';
+export type HoverStrategy = 'x' | 'y' | 'punctual' | 'series';
 /**
  * Preferred horizontal placement of the floating tooltip relative to the
  * cursor: `'right'`/`'left'` offset it clear of the cursor (so it never

package/dist/types/markers/common.d.ts

@@ -22,9 +22,18 @@ export type HoverMarkerConfig = {
     sync?: boolean;
     ruleX?: boolean;
     ruleY?: boolean;
+    /**
+     * Thickened area in place of a thin crosshair — sized to the hovered
+     * bar/cell's own width, spanning the full opposite axis. Off by default;
+     * meaningful only on a band (categorical) scale, so it renders nothing on
+     * a line/scatter plot's continuous axis.
+     */
+    areaX?: boolean;
+    areaY?: boolean;
     showLabels?: boolean;
     format?: (point: HoverDisplayPoint) => string;
     ruleStyle?: StrokeStyle;
+    areaStyle?: AreaStyle;
     dotStyle?: DotStyle;
     fontStyle?: FontStyle;
 };
@@ -40,11 +49,14 @@ export type LineMarkerConfig = {
  * A single bar mark. `role: 'segment'` is a visible bar
  * (`x`/`y`/`x1`/`x2`/`y1`/`y2` map to svelteplot's `<BarX>`/`<BarY>` per
  * `isHorizontal`); `role: 'hitArea'` is an invisible per-category hit region
- * for hover, resolved against the live scale at render time.
+ * for hover, resolved against the live scale at render time; `role:
+ * 'highlight'` is `HoverMarkerConfig`'s `areaX`/`areaY` highlight — a
+ * visible, non-interactive rect centered on `category`, spanning the full
+ * opposite axis, sized to the category band's own width plus 2px.
  */
 export type BarMarkerConfig = {
     type: 'bar';
-    role: 'segment' | 'hitArea';
+    role: 'segment' | 'hitArea' | 'highlight';
     isHorizontal: boolean;
     data: Record<string, unknown>[];
     x?: (d: any) => AxisValue;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fundar/data-chart-telling",
-  "version": "0.0.49",
+  "version": "0.0.51",
   "type": "module",
   "files": [
     "dist"