@fundar/data-chart-telling 1.16.0 → 1.18.0

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

@@ -8,11 +8,11 @@ import { ViolinProfiles } from '../../../markers/violin/ViolinProfiles';
  * by side. The markers the "statistics" phase already put in `state.markers`
  * come after, so they render on top.
  */
-export function buildMarks(state, ctx) {
+export function buildMarks(state, env) {
     const processed = state.processedData;
     if (!processed)
         return [];
-    const { cfg } = ctx;
+    const { cfg } = env;
     const styles = state.styles;
     const { channels } = processed;
     const groups = state.processedGroups ?? [];
@@ -29,10 +29,10 @@ export function buildMarks(state, ctx) {
         : typeof styles?.box === 'number'
             ? styles.box
             : cfg.violin.boxWidth;
-    const ink = cfg.axis.color;
+    const ink = 'currentColor';
     const violins = groups.flatMap((group, index) => {
         const name = group.series.name;
-        const disabled = ctx.interaction?.fillFor(name);
+        const disabled = env.interaction?.fillFor(name);
         return group.visualSegments.map((seg) => ({
             type: 'violin',
             series: name,

package/dist/plots/evolution/area/defaults.d.ts

@@ -1,4 +1,4 @@
 import type { AxisPlotDefaults } from '../../../types/phases';
-import type { AreaPlotState, AreaPlotCtx } from '../../../types/plots/evolution/area/state';
+import type { AreaPlotState, AreaPlotEnv } from '../../../types/plots/evolution/area/state';
 /** AreaPlot on the shared pipeline: areas from a zero baseline, author markers taking the plot's `x`/`y`, and its own markers. Its plot defaults to: hover along x, cumulative timeline tweening `y` per series. */
-export declare function buildAreaDefaults<TData extends Record<string, unknown>>(): AxisPlotDefaults<AreaPlotState<TData>, AreaPlotCtx>;
+export declare function buildAreaDefaults<TData extends Record<string, unknown>>(): AxisPlotDefaults<AreaPlotState<TData>, AreaPlotEnv>;

package/dist/plots/evolution/area/defaults.js

@@ -12,7 +12,7 @@ export function buildAreaDefaults() {
         styles: {
             values: {
                 anchor: 'start',
-                format: (v, name, number) => `${name} - ${number(v)}`,
+                format: (v, number, context) => `${context.series} - ${number(v)}`,
                 reach: (labels, state) => labels.reachAtSeriesEnds(state)
             }
         },

package/dist/plots/evolution/area/markers.d.ts

@@ -1,4 +1,4 @@
-import type { AreaPlotState, AreaPlotCtx } from '../../../types/plots/evolution/area/state';
+import type { AreaPlotState, AreaPlotEnv } from '../../../types/plots/evolution/area/state';
 import type { AxisBasedMarkersConfig } from '../../../types/markers/common';
 /**
  * AreaPlot's "markers" phase: one `area` per visual segment of each series,
@@ -11,4 +11,4 @@ import type { AxisBasedMarkersConfig } from '../../../types/markers/common';
  * another series' value label, dims its own areas' fill to
  * `legend.disabledOpacity`, in place, so a stack keeps its full extent.
  */
-export declare function buildMarks<TData extends Record<string, unknown>>(state: AreaPlotState<TData>, ctx: AreaPlotCtx): AxisBasedMarkersConfig[];
+export declare function buildMarks<TData extends Record<string, unknown>>(state: AreaPlotState<TData>, env: AreaPlotEnv): AxisBasedMarkersConfig[];

package/dist/plots/evolution/area/markers.js

@@ -10,17 +10,17 @@ import { Transforms } from '../../../phases/transforms/Transforms';
  * another series' value label, dims its own areas' fill to
  * `legend.disabledOpacity`, in place, so a stack keeps its full extent.
  */
-export function buildMarks(state, ctx) {
+export function buildMarks(state, env) {
     const { resolvedSeries = [] } = state;
     const { channels, options, transforms } = state.processedData;
-    const { cfg } = ctx;
+    const { cfg } = env;
     // A fill opacity per series name, for the dim: a legend-off series fades to
     // the legend's disabled opacity, every other one keeps the area default.
     const fillOpacityOf = (name) => {
-        const off = ctx.interaction?.dimmed(name);
+        const off = env.interaction?.dimmed(name);
         return off ? (off.opacity ?? cfg.legend.disabledOpacity) : cfg.area.fillOpacity;
     };
-    const dimmed = resolvedSeries.some((s) => ctx.interaction?.dimmed(s.name));
+    const dimmed = resolvedSeries.some((s) => env.interaction?.dimmed(s.name));
     const opacityScale = {
         range: Object.fromEntries(resolvedSeries.map((s) => [s.name, fillOpacityOf(s.name)]))
     };

package/dist/plots/evolution/line/defaults.d.ts

@@ -1,4 +1,4 @@
 import type { AxisPlotDefaults } from '../../../types/phases';
-import type { LinePlotState, LinePlotCtx } from '../../../types/plots/evolution/line/state';
+import type { LinePlotState, LinePlotEnv } from '../../../types/plots/evolution/line/state';
 /** LinePlot on the shared pipeline: continuous segments colored by their stroke, and its own markers. Its plot defaults to: hover along x, cumulative timeline tweening `y` per series. */
-export declare function buildLineDefaults<TData extends Record<string, unknown>>(): AxisPlotDefaults<LinePlotState<TData>, LinePlotCtx>;
+export declare function buildLineDefaults<TData extends Record<string, unknown>>(): AxisPlotDefaults<LinePlotState<TData>, LinePlotEnv>;

package/dist/plots/evolution/line/defaults.js

@@ -23,7 +23,7 @@ export function buildLineDefaults() {
         styles: {
             values: {
                 anchor: 'start',
-                format: (v, name, number) => `${name} - ${number(v)}`,
+                format: (v, number, context) => `${context.series} - ${number(v)}`,
                 reach: (labels, state) => labels.reachAtSeriesEnds(state)
             }
         },

package/dist/plots/evolution/line/markers.d.ts

@@ -4,7 +4,7 @@ import type { LineSegmentStyle } from '../../../types/plots/segments/common';
 import type { VisualGroup } from '../../../types/plots/segments/config';
 import type { StrokeStyle, DotStyle } from '../../../types/plots/styling';
 import type { LineMarkerConfig, DotMarkerConfig } from '../../../types/markers/common';
-import type { LinePlotState, LinePlotCtx } from '../../../types/plots/evolution/line/state';
+import type { LinePlotState, LinePlotEnv } from '../../../types/plots/evolution/line/state';
 import type { CurveName } from '../../../types/layout/styles/curve';
 import type { AxisBasedMarkersConfig } from '../../../types/markers/common';
 /**
@@ -49,4 +49,4 @@ export declare function buildGapMarkers<TData extends Record<string, unknown>>(a
  * whatever the "statistics" phase already put in `state.markers` - and its
  * value labels on top of everything.
  */
-export declare function buildMarks<TData extends Record<string, unknown>>(state: LinePlotState<TData>, ctx: LinePlotCtx): AxisBasedMarkersConfig[];
+export declare function buildMarks<TData extends Record<string, unknown>>(state: LinePlotState<TData>, env: LinePlotEnv): AxisBasedMarkersConfig[];

package/dist/plots/evolution/line/markers.js

@@ -178,10 +178,10 @@ export function buildGapMarkers(args) {
  * whatever the "statistics" phase already put in `state.markers` - and its
  * value labels on top of everything.
  */
-export function buildMarks(state, ctx) {
+export function buildMarks(state, env) {
     const { colorForSeries, gaps } = state;
-    const disabledStrokeFor = (name) => ctx.interaction?.strokeFor(name);
-    const disabledDotsFor = (name) => ctx.interaction?.dotsFor(name);
+    const disabledStrokeFor = (name) => env.interaction?.strokeFor(name);
+    const disabledDotsFor = (name) => env.interaction?.dotsFor(name);
     const groups = state.processedGroups ?? [];
     const lineMarkers = buildLineMarkers({
         groupedSeries: groups,

package/dist/plots/evolution/slope/defaults.d.ts

@@ -1,8 +1,8 @@
 import type { AxisPlotDefaults } from '../../../types/phases';
-import type { SlopePlotState, SlopePlotCtx } from '../../../types/plots/evolution/slope/state';
+import type { SlopePlotState, SlopePlotEnv } from '../../../types/plots/evolution/slope/state';
 /**
  * SlopePlot on the shared pipeline: a LinePlot over a category axis of a few
  * positions - two, for a slope - with a dot on every point and its first and
  * last labelled, each before or after it.
  */
-export declare function buildSlopeDefaults<TData extends Record<string, unknown>>(): AxisPlotDefaults<SlopePlotState<TData>, SlopePlotCtx>;
+export declare function buildSlopeDefaults<TData extends Record<string, unknown>>(): AxisPlotDefaults<SlopePlotState<TData>, SlopePlotEnv>;

package/dist/plots/evolution/slope/defaults.js

@@ -1,4 +1,6 @@
 import { buildMarks, buildValueLabels } from './markers';
+import { PlotAxes } from '../../../phases/data/PlotAxes';
+import { HoverDefaults } from '../../../layout/hover/HoverDefaults';
 import { ValueLabels } from '../../../layout/styles/ValueLabels';
 import { buildLineDefaults } from '../line/defaults';
 /**
@@ -15,17 +17,19 @@ export function buildSlopeDefaults() {
         scales: {
             bandOrder: 'data',
             // The labels give the values, so the value axis stays out of their way.
-            defaults: (_state, ctx) => ({
-                category: { type: 'point', padding: ctx.cfg.slope.padding },
+            defaults: (_state, env) => ({
+                category: { type: 'point', padding: env.cfg.slope.padding },
                 value: { axisDisplay: 'none' }
             })
         },
         styles: {
             values: {
                 anchor: 'start',
-                format: (v, name, number) => `${name} - ${number(v)}`
+                format: (v, number, context) => `${context.series} - ${number(v)}`
             }
         },
-        markers: { marks: buildMarks, valueLabels: buildValueLabels }
+        markers: { marks: buildMarks, valueLabels: buildValueLabels },
+        // Only two positions: a rule along the value axis at the hovered point says more than one across them.
+        hover: { ...line.hover, marker: (state) => HoverDefaults.valueRule(PlotAxes.valueOf(state)) }
     };
 }

package/dist/plots/evolution/slope/markers.d.ts

@@ -1,12 +1,12 @@
 import type { ValueLabels } from '../../../layout/styles/ValueLabels';
 import type { EdgeBox } from '../../../types/layout/box';
 import type { AxisBasedMarkersConfig, TextMarkerConfig } from '../../../types/markers/common';
-import type { SlopePlotState, SlopePlotCtx } from '../../../types/plots/evolution/slope/state';
+import type { SlopePlotState, SlopePlotEnv } from '../../../types/plots/evolution/slope/state';
 /**
  * SlopePlot's "markers" phase: each series' line, with a dot on every point
  * (a slope has few), over the rows the "transforms" phase left.
  */
-export declare function buildMarks<TData extends Record<string, unknown>>(state: SlopePlotState<TData>, ctx: SlopePlotCtx): AxisBasedMarkersConfig[];
+export declare function buildMarks<TData extends Record<string, unknown>>(state: SlopePlotState<TData>, env: SlopePlotEnv): AxisBasedMarkersConfig[];
 /**
  * SlopePlot's value labels: the series' first points labelled before them and
  * its last ones after, each end spread apart where its labels would overlap.

package/dist/plots/evolution/slope/markers.js

@@ -11,7 +11,7 @@ const keyOf = (value) => (value instanceof Date ? value.getTime() : value);
  * SlopePlot's "markers" phase: each series' line, with a dot on every point
  * (a slope has few), over the rows the "transforms" phase left.
  */
-export function buildMarks(state, ctx) {
+export function buildMarks(state, env) {
     const { slope } = getConfiguration();
     const groups = (state.processedGroups ?? []).map((group) => ({
         ...group,
@@ -27,8 +27,8 @@ export function buildMarks(state, ctx) {
     return buildLineMarkers({
         groupedSeries: groups,
         colorFor: state.colorForSeries,
-        disabledStrokeFor: (name) => ctx.interaction?.strokeFor(name),
-        disabledDotsFor: (name) => ctx.interaction?.dotsFor(name),
+        disabledStrokeFor: (name) => env.interaction?.strokeFor(name),
+        disabledDotsFor: (name) => env.interaction?.dotsFor(name),
         curve: state.styles?.curve
     });
 }

package/dist/plots/evolution/sparkline/defaults.d.ts

@@ -1,7 +1,7 @@
 import type { AxisPlotDefaults } from '../../../types/phases';
-import type { SparklinePlotState, SparklinePlotCtx } from '../../../types/plots/evolution/sparkline/state';
+import type { SparklinePlotState, SparklinePlotEnv } from '../../../types/plots/evolution/sparkline/state';
 /**
  * SparklinePlot on the shared pipeline: a LinePlot with its axes left out, a
  * thin line, and a dot and value on the last point of each series.
  */
-export declare function buildSparklineDefaults<TData extends Record<string, unknown>>(): AxisPlotDefaults<SparklinePlotState<TData>, SparklinePlotCtx>;
+export declare function buildSparklineDefaults<TData extends Record<string, unknown>>(): AxisPlotDefaults<SparklinePlotState<TData>, SparklinePlotEnv>;

package/dist/plots/evolution/sparkline/defaults.js

@@ -1,4 +1,5 @@
 import { buildMarks } from './markers';
+import { HoverDefaults } from '../../../layout/hover/HoverDefaults';
 import { ValueLabels } from '../../../layout/styles/ValueLabels';
 import { buildLineDefaults } from '../line/defaults';
 /**
@@ -15,9 +16,11 @@ export function buildSparklineDefaults() {
             values: {
                 ...line.styles?.values,
                 show: true,
-                format: (value, _name, number) => number(value)
+                format: (value, number) => number(value)
             }
         },
-        markers: { marks: buildMarks, valueLabels: line.markers.valueLabels }
+        markers: { marks: buildMarks, valueLabels: line.markers.valueLabels },
+        // Small and bare: a dot on the hovered point, and nothing else.
+        hover: { ...line.hover, marker: () => ({ back: [], front: [HoverDefaults.dot()] }) }
     };
 }

package/dist/plots/evolution/sparkline/markers.d.ts

@@ -1,7 +1,7 @@
 import type { AxisBasedMarkersConfig } from '../../../types/markers/common';
-import type { SparklinePlotState, SparklinePlotCtx } from '../../../types/plots/evolution/sparkline/state';
+import type { SparklinePlotState, SparklinePlotEnv } from '../../../types/plots/evolution/sparkline/state';
 /**
  * SparklinePlot's "markers" phase: each series' line, thin, and a dot on its
  * last point with a value.
  */
-export declare function buildMarks<TData extends Record<string, unknown>>(state: SparklinePlotState<TData>, ctx: SparklinePlotCtx): AxisBasedMarkersConfig[];
+export declare function buildMarks<TData extends Record<string, unknown>>(state: SparklinePlotState<TData>, env: SparklinePlotEnv): AxisBasedMarkersConfig[];

package/dist/plots/evolution/sparkline/markers.js

@@ -6,10 +6,10 @@ import { isGapValue } from '../../utils/gaps';
  * SparklinePlot's "markers" phase: each series' line, thin, and a dot on its
  * last point with a value.
  */
-export function buildMarks(state, ctx) {
+export function buildMarks(state, env) {
     const { sparkline } = getConfiguration();
     const groups = state.processedGroups ?? [];
-    const disabledDotsFor = (name) => ctx.interaction?.dotsFor(name);
+    const disabledDotsFor = (name) => env.interaction?.dotsFor(name);
     const lines = buildLineMarkers({
         groupedSeries: groups.map((group) => ({
             ...group,
@@ -22,7 +22,7 @@ export function buildMarks(state, ctx) {
             }))
         })),
         colorFor: state.colorForSeries,
-        disabledStrokeFor: (name) => ctx.interaction?.strokeFor(name),
+        disabledStrokeFor: (name) => env.interaction?.strokeFor(name),
         disabledDotsFor,
         curve: state.styles?.curve
     });

package/dist/plots/map/geo/Core.svelte

@@ -7,7 +7,7 @@
 	import BasePlotLayout from '../../../layout/base/BasePlotLayout.svelte';
 	import type { GeoPlotCoreProps } from '../../../types/plots/map/geo/props';
 	import type { CoordinatesConfig } from '../../../types/layout/coordinates';
-	import type { GeoPlotState, GeoPlotCtx } from '../../../types/plots/map/geo/state';
+	import type { GeoPlotState, GeoPlotEnv } from '../../../types/plots/map/geo/state';
 
 	/**
 	 * A map from GeoJSON or TopoJSON. `segments` styles features by id,
@@ -76,7 +76,7 @@
 		y: { domain: [90, -90] }
 	});
 
-	const ctx = $derived<GeoPlotCtx<TProps>>({
+	const env = $derived<GeoPlotEnv<TProps>>({
 		cfg,
 		range,
 		fill: styles.fill,
@@ -103,7 +103,7 @@
 				height,
 				margins
 			},
-			ctx
+			env
 		) as GeoPlotState<TProps>
 	);
 

package/dist/plots/map/geo/defaults.d.ts

@@ -1,4 +1,4 @@
-import type { GeoPlotState, GeoPlotCtx } from '../../../types/plots/map/geo/state';
+import type { GeoPlotState, GeoPlotEnv } from '../../../types/plots/map/geo/state';
 import { Pipeline } from '../../../phases/Pipeline';
 /** GeoPlot's own pipeline (data, scales, markers, tooltip, hover), run over the state its core seeds, hovering one feature at a time. */
-export declare function buildGeoDefaults<TProps extends Record<string, unknown>>(): Pipeline<GeoPlotState<TProps>, GeoPlotCtx<TProps>>;
+export declare function buildGeoDefaults<TProps extends Record<string, unknown>>(): Pipeline<GeoPlotState<TProps>, GeoPlotEnv<TProps>>;

package/dist/plots/map/geo/phases/data.d.ts

@@ -1,6 +1,6 @@
 import type { GeoPlotState } from '../../../../types/plots/map/geo/state';
 /**
  * GeoPlot's "data" phase: every feature tagged with its resolved id/centroid,
- * then reduced by `excludeParts`. Reads no ctx.
+ * then reduced by `excludeParts`. Reads no env.
  */
 export declare function buildData<TProps extends Record<string, unknown>>(state: GeoPlotState<TProps>): GeoPlotState<TProps>;

package/dist/plots/map/geo/phases/data.js

@@ -3,7 +3,7 @@ import { GeoGeometry } from '../GeoGeometry';
 import { GeoFeatures } from '../GeoFeatures.svelte';
 /**
  * GeoPlot's "data" phase: every feature tagged with its resolved id/centroid,
- * then reduced by `excludeParts`. Reads no ctx.
+ * then reduced by `excludeParts`. Reads no env.
  */
 export function buildData(state) {
     const { rawFeatures, featureId, excludeParts } = state;

package/dist/plots/map/geo/phases/hover.d.ts

@@ -1,4 +1,4 @@
-import type { GeoPlotState, GeoPlotCtx } from '../../../../types/plots/map/geo/state';
+import type { GeoPlotState, GeoPlotEnv } from '../../../../types/plots/map/geo/state';
 /** Whether a pointer event is over an `inset` marker's panel, which has its own hover. */
 export declare function isOverInset(e: PointerEvent): boolean;
 /**
@@ -6,4 +6,4 @@ export declare function isOverInset(e: PointerEvent): boolean;
  * feature under the cursor and read as its id. A feature outside the active
  * legend range stays drawn, dimmed, but is never a candidate.
  */
-export declare function buildHover<TProps extends Record<string, unknown>>(state: GeoPlotState<TProps>, ctx: GeoPlotCtx<TProps>): GeoPlotState<TProps>;
+export declare function buildHover<TProps extends Record<string, unknown>>(state: GeoPlotState<TProps>, env: GeoPlotEnv<TProps>): GeoPlotState<TProps>;

package/dist/plots/map/geo/phases/hover.js

@@ -10,9 +10,9 @@ export function isOverInset(e) {
  * feature under the cursor and read as its id. A feature outside the active
  * legend range stays drawn, dimmed, but is never a candidate.
  */
-export function buildHover(state, ctx) {
+export function buildHover(state, env) {
     const { color, tooltip, authoredMarkers } = state;
-    const { range } = ctx;
+    const { range } = env;
     const features = state.features;
     const label = (f) => f.__id;
     const points = features
@@ -28,7 +28,7 @@ export function buildHover(state, ctx) {
             defaultStrategy: 'punctual',
             // Match the feature under the cursor, not the nearest centroid.
             pointMatching: 'contains',
-            number: NumberFormat.of(NumberFormat.displayOf(tooltip), ctx.cfg)
+            number: NumberFormat.of(NumberFormat.displayOf(tooltip), env.cfg)
         }),
         // A map has no axes for a crosshair: 'punctual' only means an exact match.
         strategy: 'punctual',

package/dist/plots/map/geo/phases/markers.d.ts

@@ -1,4 +1,4 @@
-import type { GeoPlotState, GeoPlotCtx } from '../../../../types/plots/map/geo/state';
+import type { GeoPlotState, GeoPlotEnv } from '../../../../types/plots/map/geo/state';
 /**
  * GeoPlot's "markers" phase: per-feature style resolution/grouping, the base
  * `'geo'` marker(s), and the full draw order - any authored marker with
@@ -6,4 +6,4 @@ import type { GeoPlotState, GeoPlotCtx } from '../../../../types/plots/map/geo/s
  * with any `hover` marker moved last. The base marker(s) match the pointer
  * themselves, over the features inside the legend's range.
  */
-export declare function buildMarkers<TProps extends Record<string, unknown>>(state: GeoPlotState<TProps>, ctx: GeoPlotCtx<TProps>): GeoPlotState<TProps>;
+export declare function buildMarkers<TProps extends Record<string, unknown>>(state: GeoPlotState<TProps>, env: GeoPlotEnv<TProps>): GeoPlotState<TProps>;

package/dist/plots/map/geo/phases/markers.js

@@ -1,3 +1,4 @@
+import { MarkerStyles } from '../../../../phases/markers/MarkerStyles';
 import { LegendState } from '../../../../layout/legend/LegendState.svelte';
 import { GeoSegments } from '../GeoSegments';
 import { MarkerChannels } from '../../../../markers/utils/MarkerChannels';
@@ -18,9 +19,9 @@ function isBehindMarker(marker) {
  * with any `hover` marker moved last. The base marker(s) match the pointer
  * themselves, over the features inside the legend's range.
  */
-export function buildMarkers(state, ctx) {
+export function buildMarkers(state, env) {
     const { features, segments, authoredMarkers, color, grouping, resolveColor, resolveOpacity } = state;
-    const { range, fill, fillOpacity, stroke, strokeWidth, cfg, onFeatureClick } = ctx;
+    const { range, fill, fillOpacity, stroke, strokeWidth, cfg, onFeatureClick } = env;
     const OPACITY_STEPS = 32;
     function rangeFilteredStyle(base, f) {
         if (range == null || !color)
@@ -58,7 +59,7 @@ export function buildMarkers(state, ctx) {
         data: group.data,
         fill: (d) => group.style.fill ?? resolveBaseFill(d),
         fillOpacity: group.style.fillOpacity ?? group.opacity ?? fillOpacity ?? 1,
-        stroke: group.style.stroke ?? stroke ?? cfg.axis.color,
+        stroke: group.style.stroke ?? stroke ?? 'currentColor',
         strokeWidth: group.style.strokeWidth ?? strokeWidth ?? 0.5,
         hover: hoverable,
         onclick: onFeatureClick ? (e, d) => onFeatureClick(d, e) : undefined
@@ -66,6 +67,6 @@ export function buildMarkers(state, ctx) {
     const behindMarkers = authoredMarkers.filter(isBehindMarker);
     const frontMarkers = authoredMarkers.filter((m) => !isBehindMarker(m) && m.type !== 'geo-hover');
     const hoverMarker = authoredMarkers.find((m) => m.type === 'geo-hover');
-    const markers = MarkerChannels.inheritAll([...behindMarkers, ...featureMarkers, ...frontMarkers, ...(hoverMarker ? [hoverMarker] : [])], state.scales);
+    const markers = MarkerStyles.resolveAll(MarkerChannels.inheritAll([...behindMarkers, ...featureMarkers, ...frontMarkers, ...(hoverMarker ? [hoverMarker] : [])], state.scales), { cfg: env.cfg });
     return { ...state, markers, styleGroups };
 }

package/dist/plots/map/geo/phases/scales.d.ts

@@ -1,4 +1,4 @@
-import type { GeoPlotState, GeoPlotCtx } from '../../../../types/plots/map/geo/state';
+import type { GeoPlotState, GeoPlotEnv } from '../../../../types/plots/map/geo/state';
 /**
  * GeoPlot's "scales" phase: each feature's own resolved color (mirrors
  * HeatmapPlot's own), with a per-feature override for whichever segment
@@ -7,4 +7,4 @@ import type { GeoPlotState, GeoPlotCtx } from '../../../../types/plots/map/geo/s
  * the features that share its own key, so e.g. two grouping buckets each
  * get a ramp scaled to their own value range, not the whole dataset's.
  */
-export declare function buildScales<TProps extends Record<string, unknown>>(state: GeoPlotState<TProps>, ctx: GeoPlotCtx<TProps>): GeoPlotState<TProps>;
+export declare function buildScales<TProps extends Record<string, unknown>>(state: GeoPlotState<TProps>, env: GeoPlotEnv<TProps>): GeoPlotState<TProps>;

package/dist/plots/map/geo/phases/scales.js

@@ -10,9 +10,9 @@ import { GeoSegments } from '../GeoSegments';
  * the features that share its own key, so e.g. two grouping buckets each
  * get a ramp scaled to their own value range, not the whole dataset's.
  */
-export function buildScales(state, ctx) {
+export function buildScales(state, env) {
     const { scales, features, color, grouping, opacity, segments } = state;
-    const { range, cfg } = ctx;
+    const { range, cfg } = env;
     const colorValues = color
         ? features.map((f) => color(f)).filter((v) => v != null)
         : [];

package/dist/plots/part-of-a-whole/treemap/Plot.svelte

@@ -0,0 +1,47 @@
+<script lang="ts" generics="TData extends Record<string, unknown>">
+	import Plot from '../../../layout/plot/Plot.svelte';
+	import { buildTreemapDefaults } from './defaults';
+	import type {
+		TreemapPlotProps,
+		TreemapPlotCoreProps
+	} from '../../../types/plots/part-of-a-whole/treemap/props';
+
+	/**
+	 * A part-to-whole of rectangles: each row is a tile whose area is its `value`, nested by `grouping` - a field,
+	 * or the fields of several levels joined by dots (`'sector.branch'`), outermost first, whose last names the
+	 * tile. The outermost level colors the tiles and is what the legend lists; each tile is labelled with its name
+	 * and its share of the whole, cut short or left out where it does not fit (`styles.values`). Optional chrome
+	 * (`title`, `subtitle`, `caption`, `header`, `footer`, `legend`) frames it; `timeline` and `facet` slice its
+	 * `data` rows.
+	 */
+	let {
+		title,
+		subtitle,
+		caption,
+		header,
+		footer,
+		legend,
+		order,
+		timeline,
+		facet,
+		tooltip,
+		margins = $bindable(),
+		...core
+	}: TreemapPlotProps<TData> = $props();
+</script>
+
+<Plot
+	core={core as TreemapPlotCoreProps<TData>}
+	defaults={buildTreemapDefaults}
+	bind:margins
+	{title}
+	{subtitle}
+	{caption}
+	{header}
+	{footer}
+	{legend}
+	{order}
+	{timeline}
+	{facet}
+	{tooltip}
+/>

package/dist/plots/part-of-a-whole/treemap/Plot.svelte.d.ts

@@ -0,0 +1,26 @@
+import Plot from '../../../layout/plot/Plot.svelte';
+import type { TreemapPlotProps } from '../../../types/plots/part-of-a-whole/treemap/props';
+declare function $$render<TData extends Record<string, unknown>>(): {
+    props: TreemapPlotProps<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/part-of-a-whole/treemap/defaults.d.ts

@@ -0,0 +1,10 @@
+import type { AxisPlotDefaults } from '../../../types/phases';
+import type { TreemapPlotState, TreemapPlotEnv } from '../../../types/plots/part-of-a-whole/treemap/state';
+/**
+ * TreemapPlot on the shared pipeline: its rows are the tiles of the `treemap` transform, laid out in a unit square
+ * the plot's two continuous axes span (hidden). Its series are the outermost level of its `grouping`, which colors
+ * the tiles and fills the legend. The tiles are `rect` markers, labelled by their own `label`. Hovering a tile is
+ * hovering its row: an invisible `rect` over each one drives the plot's hover, and its tooltip names the tile and
+ * gives its share.
+ */
+export declare function buildTreemapDefaults<TData extends Record<string, unknown>>(): AxisPlotDefaults<TreemapPlotState<TData>, TreemapPlotEnv>;