@fundar/data-chart-telling 1.1.0 → 1.2.0

package/dist/plots/{scatter → correlation/scatter}/Plot.svelte

@@ -1,7 +1,10 @@
 <script lang="ts" generics="TData extends Record<string, unknown>">
-	import Plot from '../../layout/plot/Plot.svelte';
+	import Plot from '../../../layout/plot/Plot.svelte';
 	import { buildScatterDefaults } from './defaults';
-	import type { ScatterPlotProps, ScatterPlotCoreProps } from '../../types/plots/scatter/props';
+	import type {
+		ScatterPlotProps,
+		ScatterPlotCoreProps
+	} from '../../../types/plots/correlation/scatter/props';
 
 	/**
 	 * A point cloud on continuous x/y axes; `r` sizes each dot. Draws from pre-built `series` or flat `data` rows.

package/dist/plots/{scatter → correlation/scatter}/Plot.svelte.d.ts

@@ -1,5 +1,5 @@
-import Plot from '../../layout/plot/Plot.svelte';
-import type { ScatterPlotProps } from '../../types/plots/scatter/props';
+import Plot from '../../../layout/plot/Plot.svelte';
+import type { ScatterPlotProps } from '../../../types/plots/correlation/scatter/props';
 declare function $$render<TData extends Record<string, unknown>>(): {
     props: ScatterPlotProps<TData>;
     exports: {};

package/dist/plots/{scatter → correlation/scatter}/defaults.d.ts

@@ -1,4 +1,4 @@
-import type { AxisPlotDefaults } from '../../types/phases';
-import type { ScatterPlotState, ScatterPlotCtx } from '../../types/plots/scatter/state';
+import type { AxisPlotDefaults } from '../../../types/phases';
+import type { ScatterPlotState, ScatterPlotCtx } from '../../../types/plots/correlation/scatter/state';
 /** ScatterPlot on the shared pipeline: discrete dots, its own radius-padded scales, and its own markers. Its plot defaults to: hover the exact point. */
 export declare function buildScatterDefaults<TData extends Record<string, unknown>>(): AxisPlotDefaults<ScatterPlotState<TData>, ScatterPlotCtx>;

package/dist/plots/{scatter → correlation/scatter}/defaults.js

@@ -1,7 +1,7 @@
-import { ProcessedPositions } from '../../phases/transforms/ProcessedPositions';
+import { ProcessedPositions } from '../../../phases/transforms/ProcessedPositions';
 import { buildMarks, buildValueLabels } from './markers';
-import { Margins } from '../../layout/margins/Margins';
-import { MarkerAxisValues } from '../../phases/scales/MarkerAxisValues';
+import { Margins } from '../../../layout/margins/Margins';
+import { MarkerAxisValues } from '../../../phases/scales/MarkerAxisValues';
 /** Stand-in max render radius for a channel-bound `r` (svelteplot's own auto sqrt scale). */
 const AUTO_SCALED_RADIUS_ESTIMATE = 20;
 /**
@@ -53,7 +53,7 @@ function fitDomains(state, ctx) {
         const values = [...processed.data.map((d) => Number(position[axis](d))), ...extra[axis]];
         const domain = paddedDomain(values, radius, size);
         if (domain)
-            fit[axis] = { domain };
+            fit[axis] = { domain, fitted: true };
     }
     return fit;
 }

package/dist/plots/{scatter → correlation/scatter}/markers.d.ts

@@ -1,7 +1,7 @@
-import type { ScatterPlotState, ScatterPlotCtx } from '../../types/plots/scatter/state';
-import type { TextMarkerConfig } from '../../types/markers/common';
-import { ValueLabels } from '../../layout/styles/ValueLabels';
-import type { AxisBasedMarkersConfig } from '../../types/markers/common';
+import type { ScatterPlotState, ScatterPlotCtx } from '../../../types/plots/correlation/scatter/state';
+import type { TextMarkerConfig } from '../../../types/markers/common';
+import { ValueLabels } from '../../../layout/styles/ValueLabels';
+import type { AxisBasedMarkersConfig } from '../../../types/markers/common';
 /**
  * ScatterPlot's `styles.values` as one `'text'` marker over the same
  * processed rows its dots draw, each labelled with its own `y` value. A label

package/dist/plots/{scatter → correlation/scatter}/markers.js

@@ -1,6 +1,6 @@
-import { ProcessedPositions } from '../../phases/transforms/ProcessedPositions';
-import { SERIES_KEY } from '../../phases/transforms/TransformsPhase';
-import { ValueLabels } from '../../layout/styles/ValueLabels';
+import { ProcessedPositions } from '../../../phases/transforms/ProcessedPositions';
+import { SERIES_KEY } from '../../../phases/transforms/TransformsPhase';
+import { ValueLabels } from '../../../layout/styles/ValueLabels';
 /**
  * ScatterPlot's `styles.values` as one `'text'` marker over the same
  * processed rows its dots draw, each labelled with its own `y` value. A label

package/dist/plots/{box → distribution/box}/BoxSummaries.d.ts

@@ -1,5 +1,5 @@
-import type { HoverPosition } from '../../types/phases';
-import type { BoxPlotState, BoxSummaryRow } from '../../types/plots/box/state';
+import type { HoverPosition } from '../../../types/phases';
+import type { BoxPlotState, BoxSummaryRow } from '../../../types/plots/distribution/box/state';
 /**
  * The boxes a box plot draws, one summary row per series, category and facet
  * panel - the same quartiles and whiskers svelteplot's `BoxX`/`BoxY` compute,

package/dist/plots/{box → distribution/box}/BoxSummaries.js

@@ -1,10 +1,10 @@
-import { ProcessedPositions } from '../../phases/transforms/ProcessedPositions';
+import { ProcessedPositions } from '../../../phases/transforms/ProcessedPositions';
 import { quantile } from 'd3-array';
-import { SERIES_ID_KEY, SERIES_KEY } from '../../phases/transforms/TransformsPhase';
-import { PANEL_KEY } from '../../phases/facet/FacetPanels';
-import { PlotAxes } from '../../phases/data/PlotAxes';
-import { TooltipState } from '../../layout/tooltip/TooltipState.svelte';
-import { isGapValue } from '../utils/gaps';
+import { SERIES_ID_KEY, SERIES_KEY } from '../../../phases/transforms/TransformsPhase';
+import { PANEL_KEY } from '../../../phases/facet/FacetPanels';
+import { PlotAxes } from '../../../phases/data/PlotAxes';
+import { TooltipState } from '../../../layout/tooltip/TooltipState.svelte';
+import { isGapValue } from '../../utils/gaps';
 /** The whiskers reach this many interquartile ranges past the box, as svelteplot draws them. */
 const WHISKER_IQR = 1.5;
 /** A summary value as a tooltip shows it: at most two decimals. */

package/dist/plots/{box → distribution/box}/Plot.svelte

@@ -1,7 +1,7 @@
 <script lang="ts" generics="TData extends Record<string, unknown>">
-	import Plot from '../../layout/plot/Plot.svelte';
+	import Plot from '../../../layout/plot/Plot.svelte';
 	import { buildBoxDefaults } from './defaults';
-	import type { BoxPlotProps, BoxPlotCoreProps } from '../../types/plots/box/props';
+	import type { BoxPlotProps, BoxPlotCoreProps } from '../../../types/plots/distribution/box/props';
 
 	/**
 	 * A box plot: the distribution of each series' values per category - quartiles, whiskers and outliers - one box per category, upright, or sideways when the categories run along `y`. Draws from pre-built `series` or flat `data` rows.

package/dist/plots/{box → distribution/box}/Plot.svelte.d.ts

@@ -1,5 +1,5 @@
-import Plot from '../../layout/plot/Plot.svelte';
-import type { BoxPlotProps } from '../../types/plots/box/props';
+import Plot from '../../../layout/plot/Plot.svelte';
+import type { BoxPlotProps } from '../../../types/plots/distribution/box/props';
 declare function $$render<TData extends Record<string, unknown>>(): {
     props: BoxPlotProps<TData>;
     exports: {};

package/dist/plots/{box → distribution/box}/defaults.d.ts

@@ -1,5 +1,5 @@
-import type { AxisPlotDefaults } from '../../types/phases';
-import type { BoxPlotState, BoxPlotCtx } from '../../types/plots/box/state';
+import type { AxisPlotDefaults } from '../../../types/phases';
+import type { BoxPlotState, BoxPlotCtx } from '../../../types/plots/distribution/box/state';
 /**
  * BoxPlot on the shared pipeline: one box per category of each series along
  * one category axis - `x`, or `y` for horizontal boxes, as the "data" phase

package/dist/plots/{box → distribution/box}/defaults.js

@@ -1,6 +1,6 @@
 import { buildMarks } from './markers';
 import { BoxSummaries } from './BoxSummaries';
-import { TooltipState } from '../../layout/tooltip/TooltipState.svelte';
+import { TooltipState } from '../../../layout/tooltip/TooltipState.svelte';
 /**
  * BoxPlot on the shared pipeline: one box per category of each series along
  * one category axis - `x`, or `y` for horizontal boxes, as the "data" phase

package/dist/plots/{box → distribution/box}/markers.d.ts

@@ -1,5 +1,5 @@
-import type { BoxPlotState, BoxPlotCtx } from '../../types/plots/box/state';
-import type { AxisBasedMarkersConfig } from '../../types/markers/common';
+import type { BoxPlotState, BoxPlotCtx } from '../../../types/plots/distribution/box/state';
+import type { AxisBasedMarkersConfig } from '../../../types/markers/common';
 /**
  * BoxPlot's "markers" phase: one `box` per visual segment of each series,
  * one box per category of its rows, filled with its series' color (or its

package/dist/plots/distribution/density/Plot.svelte

@@ -0,0 +1,45 @@
+<script lang="ts" generics="TData extends Record<string, unknown>">
+	import Plot from '../../../layout/plot/Plot.svelte';
+	import { buildDensityDefaults } from './defaults';
+	import type {
+		DensityPlotProps,
+		DensityPlotCoreProps
+	} from '../../../types/plots/distribution/density/props';
+
+	/**
+	 * A kernel density estimate: each series smoothed along `x` - or along `y` alone, for a horizontal curve - and drawn as an area or a line. Draws from pre-built `series` or flat `data` rows.
+	 * Optional chrome (`title`, `subtitle`, `caption`, `header`, `footer`,
+	 * `legend`) frames it; `timeline` and `facet` slice its `data` rows.
+	 * `margins` is bindable: it reports the margin the plot settled on.
+	 */
+	let {
+		title,
+		subtitle,
+		caption,
+		header,
+		footer,
+		legend,
+		order,
+		timeline,
+		facet,
+		tooltip,
+		margins = $bindable(),
+		...core
+	}: DensityPlotProps<TData> = $props();
+</script>
+
+<Plot
+	core={core as DensityPlotCoreProps<TData>}
+	defaults={buildDensityDefaults}
+	bind:margins
+	{title}
+	{subtitle}
+	{caption}
+	{header}
+	{footer}
+	{legend}
+	{order}
+	{timeline}
+	{facet}
+	{tooltip}
+/>

package/dist/plots/distribution/density/Plot.svelte.d.ts

@@ -0,0 +1,26 @@
+import Plot from '../../../layout/plot/Plot.svelte';
+import type { DensityPlotProps } from '../../../types/plots/distribution/density/props';
+declare function $$render<TData extends Record<string, unknown>>(): {
+    props: DensityPlotProps<TData>;
+    exports: {};
+    bindings: "margins";
+    slots: {};
+    events: {};
+};
+declare class __sveltets_Render<TData extends Record<string, unknown>> {
+    props(): ReturnType<typeof $$render<TData>>['props'];
+    events(): ReturnType<typeof $$render<TData>>['events'];
+    slots(): ReturnType<typeof $$render<TData>>['slots'];
+    bindings(): "margins";
+    exports(): {};
+}
+interface $$IsomorphicComponent {
+    new <TData extends Record<string, unknown>>(options: import('svelte').ComponentConstructorOptions<ReturnType<__sveltets_Render<TData>['props']>>): import('svelte').SvelteComponent<ReturnType<__sveltets_Render<TData>['props']>, ReturnType<__sveltets_Render<TData>['events']>, ReturnType<__sveltets_Render<TData>['slots']>> & {
+        $$bindings?: ReturnType<__sveltets_Render<TData>['bindings']>;
+    } & ReturnType<__sveltets_Render<TData>['exports']>;
+    <TData extends Record<string, unknown>>(internal: unknown, props: ReturnType<__sveltets_Render<TData>['props']> & {}): ReturnType<__sveltets_Render<TData>['exports']>;
+    z_$$bindings?: ReturnType<__sveltets_Render<any>['bindings']>;
+}
+declare const Plot: $$IsomorphicComponent;
+type Plot<TData extends Record<string, unknown>> = InstanceType<typeof Plot<TData>>;
+export default Plot;

package/dist/plots/distribution/density/defaults.d.ts

@@ -0,0 +1,9 @@
+import type { AxisPlotDefaults } from '../../../types/phases';
+import type { DensityPlotState, DensityPlotCtx } from '../../../types/plots/distribution/density/state';
+/**
+ * DensityPlot on the shared pipeline: series read one position channel - `x`,
+ * or `y` for a horizontal curve - estimated by the plot's transforms merged
+ * over the default density of that axis, drawn from a zero baseline as an area
+ * or a line, and its own markers. Its plot defaults to: hover along the estimated axis.
+ */
+export declare function buildDensityDefaults<TData extends Record<string, unknown>>(): AxisPlotDefaults<DensityPlotState<TData>, DensityPlotCtx>;

package/dist/plots/distribution/density/defaults.js

@@ -0,0 +1,29 @@
+import { buildMarks } from './markers';
+/**
+ * The plot's own density along its axis merged over the default one, the
+ * author's props winning, and every other transform kept after it in order. A
+ * density plot estimates once, so several entries fold into one.
+ */
+function mergeDensity(own, horizontal) {
+    const base = { type: horizontal ? 'densityY' : 'densityX' };
+    const densities = own.filter((t) => t.type === base.type);
+    const others = own.filter((t) => t.type !== base.type);
+    const density = densities.reduce((merged, t) => ({ ...merged, ...t }), base);
+    return [density, ...others];
+}
+/**
+ * DensityPlot on the shared pipeline: series read one position channel - `x`,
+ * or `y` for a horizontal curve - estimated by the plot's transforms merged
+ * over the default density of that axis, drawn from a zero baseline as an area
+ * or a line, and its own markers. Its plot defaults to: hover along the estimated axis.
+ */
+export function buildDensityDefaults() {
+    return {
+        data: { segments: { color: (style) => style?.fill, connect: false } },
+        transforms: {
+            transforms: (state) => mergeDensity(state.transforms ?? [], state.axes?.isHorizontal ?? false)
+        },
+        scales: { zero: ['value'] },
+        markers: { marks: buildMarks }
+    };
+}

package/dist/plots/distribution/density/markers.d.ts

@@ -0,0 +1,9 @@
+import type { DensityPlotState, DensityPlotCtx } from '../../../types/plots/distribution/density/state';
+import type { AxisBasedMarkersConfig } from '../../../types/markers/common';
+/**
+ * DensityPlot's "markers" phase: one `area` - or `line`, by `styles.mark` - per
+ * visual segment of each series, drawing that segment's estimate, dimmed with
+ * its series. The markers the "statistics" phase already put in `state.markers`
+ * come after.
+ */
+export declare function buildMarks<TData extends Record<string, unknown>>(state: DensityPlotState<TData>, ctx: DensityPlotCtx): AxisBasedMarkersConfig[];

package/dist/plots/distribution/density/markers.js

@@ -0,0 +1,42 @@
+import { Transforms } from '../../../phases/transforms/Transforms';
+/**
+ * DensityPlot's "markers" phase: one `area` - or `line`, by `styles.mark` - per
+ * visual segment of each series, drawing that segment's estimate, dimmed with
+ * its series. The markers the "statistics" phase already put in `state.markers`
+ * come after.
+ */
+export function buildMarks(state, ctx) {
+    const { channels, options, transforms } = state.processedData;
+    const { cfg } = ctx;
+    const styles = state.styles;
+    const asLine = styles?.mark === 'line';
+    return (state.processedGroups ?? []).flatMap((group) => {
+        const name = group.series.name;
+        const disabledFill = ctx.interaction?.fillFor(name);
+        const disabledStroke = ctx.interaction?.strokeFor(name);
+        return group.visualSegments.map((seg) => {
+            const color = seg.styles.fill ?? state.colorForSeries(name);
+            const style = asLine
+                ? {
+                    stroke: disabledStroke?.stroke ?? seg.styles.stroke ?? color,
+                    strokeWidth: disabledStroke?.strokeWidth ?? seg.styles.strokeWidth ?? cfg.density.strokeWidth,
+                    strokeOpacity: disabledStroke?.strokeOpacity ?? seg.styles.strokeOpacity,
+                    strokeDasharray: disabledStroke?.strokeDasharray ?? seg.styles.strokeDasharray
+                }
+                : {
+                    ...seg.styles,
+                    fill: disabledFill?.fill ?? color,
+                    fillOpacity: disabledFill?.fillOpacity ?? seg.styles.fillOpacity ?? cfg.density.fillOpacity
+                };
+            return Transforms.finish({
+                type: asLine ? 'line' : 'area',
+                series: name,
+                data: seg.data,
+                ...channels,
+                ...options,
+                curve: styles?.curve,
+                styles: style
+            }, transforms);
+        });
+    });
+}

package/dist/plots/{histogram → distribution/histogram}/Plot.svelte

@@ -1,10 +1,10 @@
 <script lang="ts" generics="TData extends Record<string, unknown>">
-	import Plot from '../../layout/plot/Plot.svelte';
+	import Plot from '../../../layout/plot/Plot.svelte';
 	import { buildHistogramDefaults } from './defaults';
 	import type {
 		HistogramPlotProps,
 		HistogramPlotCoreProps
-	} from '../../types/plots/histogram/props';
+	} from '../../../types/plots/distribution/histogram/props';
 
 	/**
 	 * A histogram: each series binned on `x` - or on `y` alone, for horizontal bars - one bar per bin. Draws from pre-built `series` or flat `data` rows.

package/dist/plots/{histogram → distribution/histogram}/Plot.svelte.d.ts

@@ -1,5 +1,5 @@
-import Plot from '../../layout/plot/Plot.svelte';
-import type { HistogramPlotProps } from '../../types/plots/histogram/props';
+import Plot from '../../../layout/plot/Plot.svelte';
+import type { HistogramPlotProps } from '../../../types/plots/distribution/histogram/props';
 declare function $$render<TData extends Record<string, unknown>>(): {
     props: HistogramPlotProps<TData>;
     exports: {};

package/dist/plots/{histogram → distribution/histogram}/defaults.d.ts

@@ -1,5 +1,5 @@
-import type { AxisPlotDefaults } from '../../types/phases';
-import type { HistogramPlotState, HistogramPlotCtx } from '../../types/plots/histogram/state';
+import type { AxisPlotDefaults } from '../../../types/phases';
+import type { HistogramPlotState, HistogramPlotCtx } from '../../../types/plots/distribution/histogram/state';
 /**
  * HistogramPlot on the shared pipeline: series read one position channel -
  * `x`, or `y` for a horizontal histogram - binned by the plot's transforms

package/dist/plots/{histogram → distribution/histogram}/defaults.js

@@ -1,7 +1,7 @@
 import { buildMarks, buildValueLabels } from './markers';
-import { SERIES_KEY } from '../../phases/transforms/TransformsPhase';
-import { resolveAccessor } from '../utils/accessors';
-import { PlotAxes } from '../../phases/data/PlotAxes';
+import { SERIES_KEY } from '../../../phases/transforms/TransformsPhase';
+import { resolveAccessor } from '../../../utils/accessors';
+import { PlotAxes } from '../../../phases/data/PlotAxes';
 /** One processed channel's value on a row - `undefined` for a channel the transforms didn't set. */
 function readChannel(channel) {
     return channel === undefined

package/dist/plots/{histogram → distribution/histogram}/markers.d.ts

@@ -1,6 +1,6 @@
-import type { HistogramPlotState, HistogramPlotCtx } from '../../types/plots/histogram/state';
-import type { AxisBasedMarkersConfig, TextMarkerConfig } from '../../types/markers/common';
-import type { ValueLabels } from '../../layout/styles/ValueLabels';
+import type { HistogramPlotState, HistogramPlotCtx } from '../../../types/plots/distribution/histogram/state';
+import type { AxisBasedMarkersConfig, TextMarkerConfig } from '../../../types/markers/common';
+import type { ValueLabels } from '../../../layout/styles/ValueLabels';
 /**
  * HistogramPlot's `styles.values` as one `'text'` marker over its non-empty
  * bins (a `filter` on the count), each labelled with its count by `format`.

package/dist/plots/{histogram → distribution/histogram}/markers.js

@@ -1,8 +1,8 @@
-import { ProcessedPositions } from '../../phases/transforms/ProcessedPositions';
-import { SERIES_KEY } from '../../phases/transforms/TransformsPhase';
-import { Transforms } from '../../phases/transforms/Transforms';
-import { resolveAccessor } from '../utils/accessors';
-import { PlotAxes } from '../../phases/data/PlotAxes';
+import { ProcessedPositions } from '../../../phases/transforms/ProcessedPositions';
+import { SERIES_KEY } from '../../../phases/transforms/TransformsPhase';
+import { Transforms } from '../../../phases/transforms/Transforms';
+import { resolveAccessor } from '../../../utils/accessors';
+import { PlotAxes } from '../../../phases/data/PlotAxes';
 /**
  * HistogramPlot's `styles.values` as one `'text'` marker over its non-empty
  * bins (a `filter` on the count), each labelled with its count by `format`.

package/dist/plots/{pyramid → distribution/pyramid}/Plot.svelte

@@ -1,7 +1,10 @@
 <script lang="ts" generics="TData extends Record<string, unknown>">
-	import Plot from '../../layout/plot/Plot.svelte';
+	import Plot from '../../../layout/plot/Plot.svelte';
 	import { buildPyramidDefaults } from './defaults';
-	import type { PyramidPlotProps, PyramidPlotCoreProps } from '../../types/plots/pyramid/props';
+	import type {
+		PyramidPlotProps,
+		PyramidPlotCoreProps
+	} from '../../../types/plots/distribution/pyramid/props';
 
 	/**
 	 * A population-pyramid-style diverging bar plot: horizontal when its categories run along `y`, vertical when they run along `x`. Draws from pre-built `series` or flat `data` rows.

package/dist/plots/{pyramid → distribution/pyramid}/Plot.svelte.d.ts

@@ -1,5 +1,5 @@
-import Plot from '../../layout/plot/Plot.svelte';
-import type { PyramidPlotProps } from '../../types/plots/pyramid/props';
+import Plot from '../../../layout/plot/Plot.svelte';
+import type { PyramidPlotProps } from '../../../types/plots/distribution/pyramid/props';
 declare function $$render<TData extends Record<string, unknown>>(): {
     props: PyramidPlotProps<TData>;
     exports: {};

package/dist/plots/{pyramid → distribution/pyramid}/defaults.d.ts

@@ -1,5 +1,5 @@
-import type { AxisPlotDefaults } from '../../types/phases';
-import type { PyramidPlotState, PyramidPlotCtx } from '../../types/plots/pyramid/state';
+import type { AxisPlotDefaults } from '../../../types/phases';
+import type { PyramidPlotState, PyramidPlotCtx } from '../../../types/plots/distribution/pyramid/state';
 /**
  * PyramidPlot on the shared pipeline. Its `x`/`y` are the visual axes: the one
  * holding categories (read off the values by the "data" phase) runs the bars,

package/dist/plots/{pyramid → distribution/pyramid}/defaults.js

@@ -1,10 +1,10 @@
-import { ProcessedPositions } from '../../phases/transforms/ProcessedPositions';
-import { PlotAxes } from '../../phases/data/PlotAxes';
+import { ProcessedPositions } from '../../../phases/transforms/ProcessedPositions';
+import { PlotAxes } from '../../../phases/data/PlotAxes';
 import { buildMarks, buildValueLabels } from './markers';
-import { ValueLabels } from '../../layout/styles/ValueLabels';
-import { seriesIdOf } from '../../utils/grouping';
-import { isGapValue } from '../utils/gaps';
-import { SERIES_ID_KEY } from '../../phases/transforms/TransformsPhase';
+import { ValueLabels } from '../../../layout/styles/ValueLabels';
+import { seriesIdOf } from '../../../utils/grouping';
+import { isGapValue } from '../../utils/gaps';
+import { SERIES_ID_KEY } from '../../../phases/transforms/TransformsPhase';
 const byName = (a, b) => a.name.localeCompare(b.name);
 /**
  * PyramidPlot on the shared pipeline. Its `x`/`y` are the visual axes: the one

package/dist/plots/{pyramid → distribution/pyramid}/markers.d.ts

@@ -1,7 +1,7 @@
-import type { TextMarkerConfig } from '../../types/markers/common';
-import type { PyramidPlotState, PyramidPlotCtx } from '../../types/plots/pyramid/state';
-import type { ValueLabels } from '../../layout/styles/ValueLabels';
-import type { AxisBasedMarkersConfig } from '../../types/markers/common';
+import type { TextMarkerConfig } from '../../../types/markers/common';
+import type { PyramidPlotState, PyramidPlotCtx } from '../../../types/plots/distribution/pyramid/state';
+import type { ValueLabels } from '../../../layout/styles/ValueLabels';
+import type { AxisBasedMarkersConfig } from '../../../types/markers/common';
 /**
  * PyramidPlot's `styles.values` as one `'text'` marker per series, over the
  * same processed rows its bars draw (gap rows never get a label), mirrored to

package/dist/plots/{pyramid → distribution/pyramid}/markers.js

@@ -1,9 +1,9 @@
-import { resolveAccessor } from '../utils/accessors';
-import { SERIES_ID_KEY } from '../../phases/transforms/TransformsPhase';
-import { seriesIdOf } from '../../utils/grouping';
-import { PlotAxes } from '../../phases/data/PlotAxes';
-import { getConfiguration } from '../../configuration/config.svelte';
-import { isGapValue, resolveGapAreaStyle } from '../utils/gaps';
+import { resolveAccessor } from '../../../utils/accessors';
+import { SERIES_ID_KEY } from '../../../phases/transforms/TransformsPhase';
+import { seriesIdOf } from '../../../utils/grouping';
+import { PlotAxes } from '../../../phases/data/PlotAxes';
+import { getConfiguration } from '../../../configuration/config.svelte';
+import { isGapValue, resolveGapAreaStyle } from '../../utils/gaps';
 const GAP_KINDS = ['start', 'middle', 'end'];
 function signFor(s, magnitude) {
     return s.side === 'left' ? -magnitude : magnitude;

package/dist/plots/distribution/violin/Plot.svelte

@@ -0,0 +1,45 @@
+<script lang="ts" generics="TData extends Record<string, unknown>">
+	import Plot from '../../../layout/plot/Plot.svelte';
+	import { buildViolinDefaults } from './defaults';
+	import type {
+		ViolinPlotProps,
+		ViolinPlotCoreProps
+	} from '../../../types/plots/distribution/violin/props';
+
+	/**
+	 * A violin per category: the mirrored density estimate of each category's values, with a box inside. Draws from pre-built `series` or flat `data` rows.
+	 * Optional chrome (`title`, `subtitle`, `caption`, `header`, `footer`,
+	 * `legend`) frames it; `timeline` and `facet` slice its `data` rows.
+	 * `margins` is bindable: it reports the margin the plot settled on.
+	 */
+	let {
+		title,
+		subtitle,
+		caption,
+		header,
+		footer,
+		legend,
+		order,
+		timeline,
+		facet,
+		tooltip,
+		margins = $bindable(),
+		...core
+	}: ViolinPlotProps<TData> = $props();
+</script>
+
+<Plot
+	core={core as ViolinPlotCoreProps<TData>}
+	defaults={buildViolinDefaults}
+	bind:margins
+	{title}
+	{subtitle}
+	{caption}
+	{header}
+	{footer}
+	{legend}
+	{order}
+	{timeline}
+	{facet}
+	{tooltip}
+/>

package/dist/plots/distribution/violin/Plot.svelte.d.ts

@@ -0,0 +1,26 @@
+import Plot from '../../../layout/plot/Plot.svelte';
+import type { ViolinPlotProps } from '../../../types/plots/distribution/violin/props';
+declare function $$render<TData extends Record<string, unknown>>(): {
+    props: ViolinPlotProps<TData>;
+    exports: {};
+    bindings: "margins";
+    slots: {};
+    events: {};
+};
+declare class __sveltets_Render<TData extends Record<string, unknown>> {
+    props(): ReturnType<typeof $$render<TData>>['props'];
+    events(): ReturnType<typeof $$render<TData>>['events'];
+    slots(): ReturnType<typeof $$render<TData>>['slots'];
+    bindings(): "margins";
+    exports(): {};
+}
+interface $$IsomorphicComponent {
+    new <TData extends Record<string, unknown>>(options: import('svelte').ComponentConstructorOptions<ReturnType<__sveltets_Render<TData>['props']>>): import('svelte').SvelteComponent<ReturnType<__sveltets_Render<TData>['props']>, ReturnType<__sveltets_Render<TData>['events']>, ReturnType<__sveltets_Render<TData>['slots']>> & {
+        $$bindings?: ReturnType<__sveltets_Render<TData>['bindings']>;
+    } & ReturnType<__sveltets_Render<TData>['exports']>;
+    <TData extends Record<string, unknown>>(internal: unknown, props: ReturnType<__sveltets_Render<TData>['props']> & {}): ReturnType<__sveltets_Render<TData>['exports']>;
+    z_$$bindings?: ReturnType<__sveltets_Render<any>['bindings']>;
+}
+declare const Plot: $$IsomorphicComponent;
+type Plot<TData extends Record<string, unknown>> = InstanceType<typeof Plot<TData>>;
+export default Plot;

package/dist/plots/distribution/violin/defaults.d.ts

@@ -0,0 +1,10 @@
+import type { AxisPlotDefaults } from '../../../types/phases';
+import type { ViolinPlotState, ViolinPlotCtx } from '../../../types/plots/distribution/violin/state';
+/**
+ * ViolinPlot on the shared pipeline: one violin per category of each series
+ * along one category axis - `x`, or `y` for horizontal violins - in the order
+ * the data gives them, with its own band padding and markers. The value axis
+ * fits the values, without reaching for zero. Its plot defaults to: hover
+ * along the category axis, over one summary per violin, read as a box plot's.
+ */
+export declare function buildViolinDefaults<TData extends Record<string, unknown>>(): AxisPlotDefaults<ViolinPlotState<TData>, ViolinPlotCtx>;

package/dist/plots/distribution/violin/defaults.js

@@ -0,0 +1,58 @@
+import { buildMarks } from './markers';
+import { BoxSummaries } from '../box/BoxSummaries';
+import { PlotAxes } from '../../../phases/data/PlotAxes';
+import { ProcessedPositions } from '../../../phases/transforms/ProcessedPositions';
+import { NiceTicks } from '../../../layout/scales/NiceTicks';
+import { TooltipState } from '../../../layout/tooltip/TooltipState.svelte';
+/**
+ * The value axis fit to the values the violins are drawn from, when the author leaves it unpinned: no svelteplot mark reads them, so nothing else sets its domain.
+ */
+function fitValueDomain(state) {
+    const axis = PlotAxes.valueOf(state);
+    const scale = state.scales[axis];
+    if (scale?.domain != null || scale?.ticks != null || typeof scale?.nice === 'boolean')
+        return {};
+    const values = ProcessedPositions.values(state.processedData, axis)
+        .map(Number)
+        .filter(Number.isFinite);
+    const lo = Math.min(...values);
+    const hi = Math.max(...values);
+    if (!(hi > lo))
+        return {};
+    return {
+        [axis]: { domain: NiceTicks.fit(state, axis, lo, hi, NiceTicks.toleranceOf(scale?.nice)) }
+    };
+}
+/**
+ * ViolinPlot on the shared pipeline: one violin per category of each series
+ * along one category axis - `x`, or `y` for horizontal violins - in the order
+ * the data gives them, with its own band padding and markers. The value axis
+ * fits the values, without reaching for zero. Its plot defaults to: hover
+ * along the category axis, over one summary per violin, read as a box plot's.
+ */
+export function buildViolinDefaults() {
+    return {
+        data: {
+            discreteAxes: 1,
+            segments: { color: (style) => style?.fill, connect: false }
+        },
+        scales: {
+            bandOrder: 'data',
+            fit: (state) => fitValueDomain(state),
+            defaults: (_state, ctx) => ({
+                category: {
+                    paddingInner: ctx.cfg.violin.paddingInner,
+                    paddingOuter: ctx.cfg.violin.paddingOuter
+                }
+            })
+        },
+        markers: { marks: buildMarks },
+        hover: {
+            rows: BoxSummaries.of,
+            position: BoxSummaries.position,
+            label: () => ((row) => String(row.median)),
+            format: (state) => BoxSummaries.format(state),
+            sort: () => TooltipState.descending((row) => row.median)
+        }
+    };
+}