@c2n/chart 0.0.7 → 0.0.9

package/dist/radar-chart.js

@@ -0,0 +1,109 @@
+import { columnValue } from "./chart-data.js";
+import { t as __decorate } from "./decorate-BkO8ArQg.js";
+import "./chart-series.js";
+import { t as EchartsChartBase } from "./echarts-chart-base-CImXMzVk.js";
+import { property } from "lit/decorators.js";
+import { customElement } from "@c2n/core/element-helper.js";
+//#region src/radar-chart.ts
+var RadarChart = class RadarChart extends EchartsChartBase {
+	constructor() {
+		super();
+		this.features = ["radar"];
+		this.min = 0;
+		this.shape = "polygon";
+		this.startAngle = 90;
+		this.splitNumber = 5;
+		this.points = "show";
+		this.xType = "category";
+		this.tooltip = "item";
+	}
+	coordinateSystem(context) {
+		const { theme } = context;
+		return { radar: {
+			indicator: this.indicators(),
+			shape: this.shape,
+			startAngle: this.startAngle,
+			splitNumber: Math.max(1, Math.trunc(this.splitNumber)),
+			radius: "68%",
+			axisName: {
+				color: theme.axisColor,
+				fontSize: theme.fontSize
+			},
+			axisLine: { lineStyle: { color: theme.gridColor } },
+			splitLine: { lineStyle: { color: theme.gridColor } },
+			splitArea: { show: false }
+		} };
+	}
+	seriesOption(index, context) {
+		const series = context.series[index] ?? { field: "" };
+		const color = this.colorOf(series, index, context.theme);
+		return {
+			type: "radar",
+			symbol: this.points === "show" ? "circle" : "none",
+			symbolSize: context.theme.pointRadius * 2,
+			lineStyle: {
+				color,
+				width: series.lineWidth ?? context.theme.lineWidth
+			},
+			itemStyle: { color },
+			areaStyle: {
+				color,
+				opacity: this.fillOpacity ?? this.areaOpacity()
+			}
+		};
+	}
+	projectData(frame, context) {
+		return context.series.map((series, seriesIndex) => {
+			const column = frame.columns[seriesIndex];
+			const values = new Array(frame.length);
+			for (let index = 0; index < frame.length; index += 1) values[index] = column ? columnValue(column, index) : null;
+			return [{
+				name: series.label ?? series.field,
+				value: values
+			}];
+		});
+	}
+	indicators() {
+		const frame = this.frame;
+		if (!frame) return [];
+		return Array.from({ length: frame.length }, (_, indicatorIndex) => ({
+			name: frame.labels?.[indicatorIndex] ?? String(indicatorIndex + 1),
+			min: this.min,
+			max: this.max ?? this.indicatorMax(frame, indicatorIndex)
+		}));
+	}
+	indicatorMax(frame, indicatorIndex) {
+		let largest = this.min;
+		for (const column of frame.columns) {
+			const value = columnValue(column, indicatorIndex);
+			if (value !== null) largest = Math.max(largest, value);
+		}
+		if (largest <= this.min) return this.min + 1;
+		const padded = largest + (largest - this.min) * .1;
+		const magnitude = 10 ** Math.floor(Math.log10(Math.abs(padded)));
+		return Math.ceil(padded / magnitude) * magnitude;
+	}
+	areaOpacity() {
+		const raw = parseFloat(getComputedStyle(this).getPropertyValue("--c2-chart__area--opacity"));
+		return Number.isFinite(raw) ? raw : .15;
+	}
+};
+__decorate([property({ type: Number })], RadarChart.prototype, "min", void 0);
+__decorate([property({ type: Number })], RadarChart.prototype, "max", void 0);
+__decorate([property({ type: String })], RadarChart.prototype, "shape", void 0);
+__decorate([property({
+	type: Number,
+	attribute: "start-angle"
+})], RadarChart.prototype, "startAngle", void 0);
+__decorate([property({
+	type: Number,
+	attribute: "split-number"
+})], RadarChart.prototype, "splitNumber", void 0);
+__decorate([property({ type: String })], RadarChart.prototype, "points", void 0);
+__decorate([property({
+	type: Number,
+	attribute: "fill-opacity"
+})], RadarChart.prototype, "fillOpacity", void 0);
+RadarChart = __decorate([customElement("c2-radar-chart")], RadarChart);
+//#endregion
+export { RadarChart };

package/dist/scatter-chart.js

@@ -0,0 +1,40 @@
+import { t as __decorate } from "./decorate-BkO8ArQg.js";
+import "./chart-series.js";
+import { t as EchartsChartBase } from "./echarts-chart-base-CImXMzVk.js";
+import { property } from "lit/decorators.js";
+import { customElement } from "@c2n/core/element-helper.js";
+//#region src/scatter-chart.ts
+var ScatterChart = class ScatterChart extends EchartsChartBase {
+	constructor() {
+		super();
+		this.features = ["scatter", "grid"];
+		this.symbolSize = 10;
+		this.symbol = "circle";
+		this.large = false;
+		this.largeThreshold = 2e3;
+		this.tooltip = "item";
+	}
+	seriesOption(index, context) {
+		return {
+			type: "scatter",
+			symbol: this.symbol,
+			symbolSize: this.symbolSize,
+			large: this.large,
+			largeThreshold: this.largeThreshold,
+			itemStyle: { color: this.colorOf(context.series[index] ?? { field: "" }, index, context.theme) }
+		};
+	}
+};
+__decorate([property({
+	type: Number,
+	attribute: "symbol-size"
+})], ScatterChart.prototype, "symbolSize", void 0);
+__decorate([property({ type: String })], ScatterChart.prototype, "symbol", void 0);
+__decorate([property({ type: Boolean })], ScatterChart.prototype, "large", void 0);
+__decorate([property({
+	type: Number,
+	attribute: "large-threshold"
+})], ScatterChart.prototype, "largeThreshold", void 0);
+ScatterChart = __decorate([customElement("c2-scatter-chart")], ScatterChart);
+//#endregion
+export { ScatterChart };

package/dist/sparkline.js

@@ -1,7 +1,7 @@
-import { n as chart_default } from "./chart-base-C4-1TyKq.js";
-import { i as __decorate } from "./chart-series-BnpHO3lm.js";
-import { t as UplotChartBase } from "./uplot-chart-base-BWr0zJE2.js";
-import { n as linePaths, r as withAlpha } from "./uplot-paths-ChKohvIX.js";
+import { n as chart_default } from "./chart-base-CEZvMKwW.js";
+import { t as __decorate } from "./decorate-BkO8ArQg.js";
+import { t as UplotChartBase } from "./uplot-chart-base-CLhgOeM_.js";
+import { n as linePaths, r as withAlpha } from "./uplot-paths-D5HCEKRV.js";
 import { property } from "lit/decorators.js";
 import { customElement } from "@c2n/core/element-helper.js";
 import { css, unsafeCSS } from "lit";

package/dist/{uplot-chart-base-BWr0zJE2.js → uplot-chart-base-CLhgOeM_.js}

@@ -1,5 +1,5 @@
-import { t as ChartBase } from "./chart-base-C4-1TyKq.js";
-import { i as __decorate } from "./chart-series-BnpHO3lm.js";
+import { t as ChartBase } from "./chart-base-CEZvMKwW.js";
+import { t as __decorate } from "./decorate-BkO8ArQg.js";
 import { property } from "lit/decorators.js";
 //#region src/engines/uplot-loader.ts
 var pending;
@@ -44,11 +44,27 @@ async function createUplotAdapter() {
 					events?.hover(null);
 					return;
 				}
+				let nearestSeriesIndex = 0;
+				let nearestDistance = Number.POSITIVE_INFINITY;
+				const cursorY = self.cursor.top ?? 0;
+				for (let engineIndex = 1; engineIndex < self.series.length; engineIndex += 1) {
+					const series = self.series[engineIndex];
+					const value = data[engineIndex]?.[index];
+					if (!series?.show || value === null || value === void 0 || !Number.isFinite(value)) continue;
+					const pointY = self.valToPos(value, series.scale ?? "y", true);
+					const distance = Math.abs(pointY - cursorY);
+					if (distance < nearestDistance) {
+						nearestDistance = distance;
+						nearestSeriesIndex = engineIndex - 1;
+					}
+				}
+				const pointer = self.cursor.event;
+				const bounds = container?.getBoundingClientRect();
 				events?.hover({
 					index,
-					seriesIndex: Math.max(1, self.cursor.idxs?.findIndex((value) => value !== null && value !== void 0) ?? 1) - 1,
-					px: self.cursor.left ?? 0,
-					py: self.cursor.top ?? 0
+					seriesIndex: nearestSeriesIndex,
+					px: pointer && bounds ? pointer.clientX - bounds.left : self.cursor.left ?? 0,
+					py: pointer && bounds ? pointer.clientY - bounds.top : self.cursor.top ?? 0
 				});
 			}],
 			setSelect: [(self) => {

package/dist/uplot-chart-base.js

@@ -1,2 +1,2 @@
-import { t as UplotChartBase } from "./uplot-chart-base-BWr0zJE2.js";
+import { t as UplotChartBase } from "./uplot-chart-base-CLhgOeM_.js";
 export { UplotChartBase };

package/dist/{uplot-paths-ChKohvIX.js → uplot-paths-D5HCEKRV.js}

@@ -1,4 +1,4 @@
-import { n as loadedUplot } from "./uplot-chart-base-BWr0zJE2.js";
+import { n as loadedUplot } from "./uplot-chart-base-CLhgOeM_.js";
 //#region src/engines/uplot-paths.ts
 var cache = /* @__PURE__ */ new Map();
 /**
@@ -45,8 +45,8 @@ var SCALE_VALUE = 1;
 * Grouping is therefore ours to do: `disp` gives uPlot an explicit left edge and width per bar — in data
 * units, which is what it reads when no `unit` is set — placing each series in its own slot of the band.
 */
-function barPaths(width, gap, index, count) {
-	const key = `${width}:${gap}:${index}:${count}`;
+function barPaths(width, gap, index, count, radius = 0) {
+	const key = `${width}:${gap}:${index}:${count}:${radius}`;
 	if (barCache.has(key)) return barCache.get(key);
 	const paths = loadedUplot()?.paths;
 	if (!paths) return void 0;
@@ -55,8 +55,10 @@ function barPaths(width, gap, index, count) {
 		Infinity,
 		1
 	];
+	const roundedEnd = [radius, 0];
 	const builder = count > 1 ? paths.bars?.({
 		size,
+		radius: roundedEnd,
 		disp: {
 			x0: {
 				unit: SCALE_VALUE,
@@ -67,7 +69,10 @@ function barPaths(width, gap, index, count) {
 				values: (self) => [layout(self, width, gap, count).barWidth]
 			}
 		}
-	}) : paths.bars?.({ size });
+	}) : paths.bars?.({
+		size,
+		radius: roundedEnd
+	});
 	barCache.set(key, builder);
 	return builder;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@c2n/chart",
-  "version": "0.0.7",
+  "version": "0.0.9",
   "type": "module",
   "main": "dist/chart.js",
   "exports": {
@@ -28,10 +28,34 @@
       "types": "./types/src/pie-chart.d.ts",
       "default": "./dist/pie-chart.js"
     },
+    "./gauge-chart.js": {
+      "types": "./types/src/gauge-chart.d.ts",
+      "default": "./dist/gauge-chart.js"
+    },
+    "./radar-chart.js": {
+      "types": "./types/src/radar-chart.d.ts",
+      "default": "./dist/radar-chart.js"
+    },
+    "./scatter-chart.js": {
+      "types": "./types/src/scatter-chart.d.ts",
+      "default": "./dist/scatter-chart.js"
+    },
+    "./candlestick-chart.js": {
+      "types": "./types/src/candlestick-chart.d.ts",
+      "default": "./dist/candlestick-chart.js"
+    },
     "./chart-series.js": {
       "types": "./types/src/chart-series.d.ts",
       "default": "./dist/chart-series.js"
     },
+    "./chart-legend.js": {
+      "types": "./types/src/chart-legend.d.ts",
+      "default": "./dist/chart-legend.js"
+    },
+    "./chart-tooltip.js": {
+      "types": "./types/src/chart-tooltip.d.ts",
+      "default": "./dist/chart-tooltip.js"
+    },
     "./chart-base.js": {
       "types": "./types/src/chart-base.d.ts",
       "default": "./dist/chart-base.js"
@@ -84,6 +108,10 @@
     "graph",
     "data visualization",
     "line chart",
+    "gauge chart",
+    "radar chart",
+    "scatter plot",
+    "candlestick chart",
     "sparkline",
     "uplot",
     "echarts",
@@ -121,7 +149,7 @@
     }
   },
   "dependencies": {
-    "@c2n/core": "0.0.7",
+    "@c2n/core": "0.0.9",
     "lit": "3.3.3"
   },
   "devDependencies": {
@@ -142,5 +170,5 @@
       "optional": true
     }
   },
-  "gitHead": "c8db398a27f7cd417d665fdf5da455fee2d4e910"
+  "gitHead": "e4768cce5e0fbd5bc3165cd493a1e8d57cf0fff4"
 }

package/react.d.ts

@@ -10,9 +10,15 @@
 import type { DetailedHTMLProps, HTMLAttributes } from 'react'
 import type { AreaChart } from '@c2n/chart/area-chart.js'
 import type { BarChart } from '@c2n/chart/bar-chart.js'
+import type { CandlestickChart } from '@c2n/chart/candlestick-chart.js'
+import type { ChartLegend } from '@c2n/chart/chart-legend.js'
 import type { ChartSeries } from '@c2n/chart/chart-series.js'
+import type { ChartTooltip } from '@c2n/chart/chart-tooltip.js'
+import type { GaugeChart } from '@c2n/chart/gauge-chart.js'
 import type { LineChart } from '@c2n/chart/line-chart.js'
 import type { PieChart } from '@c2n/chart/pie-chart.js'
+import type { RadarChart } from '@c2n/chart/radar-chart.js'
+import type { ScatterChart } from '@c2n/chart/scatter-chart.js'
 import type { Sparkline } from '@c2n/chart/sparkline.js'
 
 /** Standard React host-element attributes plus the element's own public properties. */
@@ -23,9 +29,15 @@ declare module 'react' {
     interface IntrinsicElements {
       'c2-area-chart': C2Props<AreaChart>
       'c2-bar-chart': C2Props<BarChart>
+      'c2-candlestick-chart': C2Props<CandlestickChart>
+      'c2-chart-legend': C2Props<ChartLegend>
       'c2-chart-series': C2Props<ChartSeries>
+      'c2-chart-tooltip': C2Props<ChartTooltip>
+      'c2-gauge-chart': C2Props<GaugeChart>
       'c2-line-chart': C2Props<LineChart>
       'c2-pie-chart': C2Props<PieChart>
+      'c2-radar-chart': C2Props<RadarChart>
+      'c2-scatter-chart': C2Props<ScatterChart>
       'c2-sparkline': C2Props<Sparkline>
     }
   }

package/types/src/candlestick-chart.d.ts

@@ -0,0 +1,52 @@
+import type { TypedAddEventListener, TypedRemoveEventListener } from '@c2n/core/event-helper.js';
+import { EchartsChartBase } from './echarts-chart-base.js';
+import type { ChartEventMap, ChartLegendItem } from './chart-base.js';
+import type { ChartBuildContext } from './chart-adapter.js';
+import type { EchartsOptions } from './engines/echarts-adapter.js';
+import type { EchartsFeature } from './engines/echarts-loader.js';
+import type { ChartFrame, ChartSeriesConfig } from './chart-types.js';
+import './chart-series.js';
+export interface CandlestickChart {
+    addEventListener: TypedAddEventListener<CandlestickChart, ChartEventMap>;
+    removeEventListener: TypedRemoveEventListener<CandlestickChart, ChartEventMap>;
+}
+/**
+ * An OHLC candlestick chart drawn by ECharts. With no series children it reads the `open`, `close`, `low`
+ * and `high` fields; the four `*-field` attributes rename that convention. Four explicit series children
+ * can instead supply those columns in the same order.
+ *
+ * ```html
+ * <c2-candlestick-chart label-field="date"
+ *   data='[{ "date": "Mon", "open": 182, "close": 187, "low": 180, "high": 189 }]'>
+ * </c2-candlestick-chart>
+ * ```
+ *
+ * @tag c2-candlestick-chart
+ */
+export declare class CandlestickChart extends EchartsChartBase {
+    protected readonly features: readonly EchartsFeature[];
+    /** Row field containing the opening value. */
+    openField: string;
+    /** Row field containing the closing value. */
+    closeField: string;
+    /** Row field containing the lowest value. */
+    lowField: string;
+    /** Row field containing the highest value. */
+    highField: string;
+    /** Name shown by an enabled legend for the complete OHLC series. */
+    name: string;
+    constructor();
+    protected inferredSeries(): ChartSeriesConfig[];
+    protected coordinateSystem(context: ChartBuildContext): Record<string, unknown>;
+    protected projectData(frame: ChartFrame): unknown[];
+    protected buildOptions(context: ChartBuildContext): EchartsOptions;
+    protected seriesOption(_index: number, context: ChartBuildContext): Record<string, unknown>;
+    protected legendItems(): ChartLegendItem[];
+    private xLabels;
+}
+declare global {
+    interface HTMLElementTagNameMap {
+        'c2-candlestick-chart': CandlestickChart;
+    }
+}
+//# sourceMappingURL=candlestick-chart.d.ts.map

package/types/src/candlestick-chart.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"candlestick-chart.d.ts","sourceRoot":"","sources":["../../src/candlestick-chart.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,qBAAqB,EAAE,wBAAwB,EAAE,MAAM,2BAA2B,CAAA;AAChG,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAA;AAC1D,OAAO,KAAK,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAA;AACrE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAA;AAC3D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAA;AAClE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAA;AAEjE,OAAO,KAAK,EAAE,UAAU,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAA;AACrE,OAAO,mBAAmB,CAAA;AAE1B,MAAM,WAAW,gBAAgB;IAC/B,gBAAgB,EAAE,qBAAqB,CAAC,gBAAgB,EAAE,aAAa,CAAC,CAAA;IACxE,mBAAmB,EAAE,wBAAwB,CAAC,gBAAgB,EAAE,aAAa,CAAC,CAAA;CAC/E;AAED;;;;;;;;;;;;GAYG;AACH,qBACa,gBAAiB,SAAQ,gBAAgB;IACpD,mBAA4B,QAAQ,EAAE,SAAS,cAAc,EAAE,CAA0B;IAEzF,8CAA8C;IACO,SAAS,SAAS;IAEvE,8CAA8C;IACQ,UAAU,SAAU;IAE1E,6CAA6C;IACO,QAAQ,SAAQ;IAEpE,8CAA8C;IACO,SAAS,SAAS;IAEvE,oEAAoE;IACxC,IAAI,SAAU;;cASvB,cAAc,IAAI,iBAAiB,EAAE;cASrC,gBAAgB,CAAC,OAAO,EAAE,iBAAiB,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;cAUrE,WAAW,CAAC,KAAK,EAAE,UAAU,GAAG,OAAO,EAAE;cAWzC,YAAY,CAAC,OAAO,EAAE,iBAAiB,GAAG,cAAc;cAKxD,YAAY,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,iBAAiB,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;cAYjF,WAAW,IAAI,eAAe,EAAE;IAcnD,OAAO,CAAC,OAAO;CAKhB;AAED,OAAO,CAAC,MAAM,CAAC;IACb,UAAU,qBAAqB;QAC7B,sBAAsB,EAAE,gBAAgB,CAAA;KACzC;CACF"}

package/types/src/chart-base.d.ts

@@ -14,6 +14,10 @@ export interface ChartLegendItem {
     series: ChartSeriesConfig;
     index: number;
 }
+/** Detail emitted whenever the component-owned legend model changes. */
+export interface ChartLegendChangeEventDetail {
+    items: ChartLegendItem[];
+}
 /** Events fired by every chart, keyed for `addEventListener`. */
 export interface ChartEventMap {
     'chart-ready': CustomEvent<{
@@ -24,6 +28,8 @@ export interface ChartEventMap {
     }>;
     'point-click': CustomEvent<ChartPointEventDetail>;
     'point-hover': CustomEvent<ChartPointEventDetail | null>;
+    'tooltip-change': CustomEvent<ChartTooltipContext | null>;
+    'legend-change': CustomEvent<ChartLegendChangeEventDetail>;
     'range-change': CustomEvent<ChartRangeEventDetail>;
     'series-toggle': CustomEvent<ChartSeriesToggleEventDetail>;
 }
@@ -59,7 +65,9 @@ export interface ChartBase {
  * @event {CustomEvent<{ engine: string }>} chart-ready - Fired after the engine has loaded and drawn for the first time. The host also gains `data-chart-ready`, which is what a test should wait on.
  * @event {CustomEvent<{ error: unknown }>} chart-error - Fired when the engine fails to load or to draw. `detail.error` is the underlying failure.
  * @event {CustomEvent<ChartPointEventDetail>} point-click - Fired when a datum is clicked. Does not bubble: several components fire point events, so a listener belongs on the element itself.
- * @event {CustomEvent<ChartPointEventDetail>} point-hover - Fired as the pointer moves between data points, and with a `null` detail when it leaves the plot. Does not bubble.
+ * @event {CustomEvent<ChartPointEventDetail | null>} point-hover - Fired as the pointer moves between data points, and with a `null` detail when it leaves the plot. Does not bubble.
+ * @event {CustomEvent<ChartTooltipContext | null>} tooltip-change - Fired with the complete tooltip model as the pointer moves, and with `null` when it leaves. Used by `c2-chart-tooltip`.
+ * @event {CustomEvent<ChartLegendChangeEventDetail>} legend-change - Fired when legend entries or visibility change. Used by `c2-chart-legend`.
  * @event {CustomEvent<ChartRangeEventDetail>} range-change - Fired after the user zooms or brushes. `detail.min` and `detail.max` are the new x bounds. Does not bubble.
  * @event {CustomEvent<ChartSeriesToggleEventDetail>} series-toggle - Fired when a legend entry is toggled. Does not bubble.
  *
@@ -103,6 +111,7 @@ export interface ChartBase {
  * @cssproperty {pixel} [--c2-chart__line--width=2px] - Stroke width of a line series.
  * @cssproperty {pixel} [--c2-chart__point--radius=2.5px] - Radius of a data point marker.
  * @cssproperty {opacity} [--c2-chart__area--opacity=0.15] - Opacity of the fill under an area series.
+ * @cssproperty {number} [--c2-chart__bar--border-radius=0] - Roundedness of a bar's value end, from 0 (square) to 0.5 (fully rounded).
  *
  * @cssproperty {color} [--c2-chart__axis--color=#71717a] - Colour of the axis lines and tick labels.
  * @cssproperty {font-size} [--c2-chart__axis--font-size=12px] - Font size of the tick labels.
@@ -165,9 +174,10 @@ export declare abstract class ChartBase extends LitElement {
     /** Whether the tooltip follows the whole x position or only the hovered datum. */
     tooltip: 'none' | 'item' | 'axis';
     /**
-     * Whether the engine animates entry and updates. `none` by default: a chart fed by a live source should
-     * not animate every tick. Named `animation` rather than `animate` because `HTMLElement.animate()` is a
-     * method every element already has, and shadowing it breaks the Web Animations API on the host.
+     * Whether the chart animates its initial draw. ECharts uses its native shape animation and uPlot uses a
+     * lightweight plot reveal; subsequent data updates stay immediate so a live source does not animate
+     * every tick. Named `animation` rather than `animate` because `HTMLElement.animate()` is a method every
+     * element already has, and shadowing it breaks the Web Animations API on the host.
      */
     animation: 'none' | 'auto';
     /** BCP 47 locale for the axis and tooltip formatting. Defaults to the browser locale. */
@@ -190,6 +200,8 @@ export declare abstract class ChartBase extends LitElement {
     protected hiddenSeries: Set<number>;
     protected hoverContext: ChartTooltipContext | null;
     private engineFailed;
+    private hasLinkedLegend;
+    private hasLinkedTooltip;
     protected themeController: ChartThemeController;
     protected frameBuilder: ChartFrameBuilder;
     protected frame?: ChartFrame;
@@ -202,7 +214,16 @@ export declare abstract class ChartBase extends LitElement {
     protected abstract buildOptions(context: ChartBuildContext): unknown;
     /** Projects the normalised frame into the shape this engine consumes. */
     protected abstract projectData(frame: ChartFrame, context: ChartBuildContext): unknown;
+    /** Restores interaction state after an engine instance is created or replaced. */
+    protected restoreVisibility(adapter: ChartAdapter): void;
+    /** Whether changing chart data can change the legend model. Pie charts use row labels as entries. */
+    protected get legendDependsOnData(): boolean;
     connectedCallback(): void;
+    /**
+     * Client-rendered charts connect before Lit creates their plot node. Observe it after the first render as
+     * well, so a chart whose initial layout is zero-sized still draws when its container becomes measurable.
+     */
+    protected firstUpdated(): void;
     disconnectedCallback(): void;
     /**
      * The fast path. A change confined to `data`/`revision` on a live chart is pushed into the engine here
@@ -223,6 +244,22 @@ export declare abstract class ChartBase extends LitElement {
     appendPoint(x: number, values: readonly (number | null)[]): void;
     /** Shows or hides one series, as the legend does. */
     setSeriesVisible(index: number, visible: boolean): void;
+    /** Current entries for a linked `c2-chart-legend`. */
+    getLegendItems(): ChartLegendItem[];
+    /** Current hover model for a linked `c2-chart-tooltip`. */
+    getTooltipContext(): ChartTooltipContext | null;
+    /** Plot bounds used to place a linked floating tooltip in viewport coordinates. */
+    getPlotBounds(): DOMRect;
+    /** Registers an external legend and suppresses the built-in legend until it disconnects. */
+    registerLegendPresenter(presenter: HTMLElement): void;
+    /** Removes an external legend registration. */
+    unregisterLegendPresenter(presenter: HTMLElement): void;
+    /** Registers an external tooltip and suppresses the built-in tooltip until it disconnects. */
+    registerTooltipPresenter(presenter: HTMLElement): void;
+    /** Removes an external tooltip registration. */
+    unregisterTooltipPresenter(presenter: HTMLElement): void;
+    /** Notifies linked legends after a subclass changes a data-shaped legend such as pie slices. */
+    protected notifyLegendChange(): void;
     /** The series in draw order: `c2-chart-series` children when present, otherwise the `series` property. */
     get resolvedSeries(): ChartSeriesConfig[];
     /**

package/types/src/chart-base.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"chart-base.d.ts","sourceRoot":"","sources":["../../src/chart-base.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"chart-base.d.ts","sourceRoot":"","sources":["../../src/chart-base.ts"],"names":[],"mappings":"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"}

package/types/src/chart-legend.d.ts

@@ -0,0 +1,37 @@
+import { type CSSResultGroup, type TemplateResult } from 'lit';
+import { ChartLinkedElement, type ChartLinkTarget } from './chart-link.js';
+import type { ChartLegendItem } from './chart-base.js';
+/**
+ * A legend linked to a chart by id. Place it anywhere in the document to control the legend's layout
+ * independently from the chart.
+ *
+ * @tag c2-chart-legend
+ * @slot - Replaces the generated legend. Use `renderLegend` or `renderLegendItem` for data-driven custom content.
+ * @csspart item - One interactive legend entry.
+ * @csspart marker - The colour swatch inside an entry.
+ * @cssproperty {pixel} [--c2-chart__legend--gap=12px] - Gap between legend entries.
+ * @cssproperty {padding} [--c2-chart__legend--padding=0] - Padding around the legend.
+ * @cssproperty {color} [--c2-chart__legend--color=#71717a] - Legend text colour.
+ * @cssproperty {font-size} [--c2-chart__legend--font-size=12px] - Legend font size.
+ * @cssproperty {opacity} [--c2-chart__legend__disabled--opacity=0.38] - Opacity of a disabled entry.
+ * @cssproperty {pixel} [--c2-chart__legend-marker--size=10px] - Size of the colour swatch.
+ * @cssproperty {border-radius} [--c2-chart__legend-marker--border-radius=999px] - Radius of the colour swatch.
+ */
+export declare class ChartLegend extends ChartLinkedElement {
+    #private;
+    static styles: CSSResultGroup;
+    /** Renders the complete legend. Property only. */
+    renderLegend?: (items: ChartLegendItem[]) => unknown;
+    /** Renders the content of one generated toggle button. Property only. */
+    renderLegendItem?: (item: ChartLegendItem) => unknown;
+    private items;
+    protected chartConnected(chart: ChartLinkTarget): void;
+    protected chartDisconnected(chart: ChartLinkTarget): void;
+    protected render(): TemplateResult;
+}
+declare global {
+    interface HTMLElementTagNameMap {
+        'c2-chart-legend': ChartLegend;
+    }
+}
+//# sourceMappingURL=chart-legend.d.ts.map

package/types/src/chart-legend.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chart-legend.d.ts","sourceRoot":"","sources":["../../src/chart-legend.ts"],"names":[],"mappings":"AAAA,OAAO,EAAmB,KAAK,cAAc,EAAE,KAAK,cAAc,EAAE,MAAM,KAAK,CAAA;AAG/E,OAAO,EAAE,kBAAkB,EAAE,KAAK,eAAe,EAAE,MAAM,iBAAiB,CAAA;AAC1E,OAAO,KAAK,EAAgC,eAAe,EAAE,MAAM,iBAAiB,CAAA;AAGpF;;;;;;;;;;;;;;;GAeG;AACH,qBACa,WAAY,SAAQ,kBAAkB;;IACjD,OAAgB,MAAM,EAAE,cAAc,CAAoB;IAE1D,kDAAkD;IAClB,YAAY,CAAC,EAAE,CAAC,KAAK,EAAE,eAAe,EAAE,KAAK,OAAO,CAAA;IAEpF,yEAAyE;IACzC,gBAAgB,CAAC,EAAE,CAAC,IAAI,EAAE,eAAe,KAAK,OAAO,CAAA;IAE5E,OAAO,CAAC,KAAK,CAAwB;cAM3B,cAAc,CAAC,KAAK,EAAE,eAAe,GAAG,IAAI;cAM5C,iBAAiB,CAAC,KAAK,EAAE,eAAe,GAAG,IAAI;cAM/C,MAAM,IAAI,cAAc;CAkB5C;AAED,OAAO,CAAC,MAAM,CAAC;IACb,UAAU,qBAAqB;QAC7B,iBAAiB,EAAE,WAAW,CAAA;KAC/B;CACF"}

package/types/src/chart-link.d.ts

@@ -0,0 +1,26 @@
+import { LitElement, type PropertyValues } from 'lit';
+import type { ChartLegendItem } from './chart-base.js';
+import type { ChartTooltipContext } from './chart-types.js';
+/** The small public surface companion elements consume without depending on a concrete chart type. */
+export interface ChartLinkTarget extends HTMLElement {
+    getLegendItems(): ChartLegendItem[];
+    getTooltipContext(): ChartTooltipContext | null;
+    getPlotBounds(): DOMRect;
+    registerLegendPresenter(presenter: HTMLElement): void;
+    unregisterLegendPresenter(presenter: HTMLElement): void;
+    registerTooltipPresenter(presenter: HTMLElement): void;
+    unregisterTooltipPresenter(presenter: HTMLElement): void;
+}
+/** Resolves and follows a chart by id within the companion's document or shadow root. */
+export declare abstract class ChartLinkedElement extends LitElement {
+    #private;
+    /** Id of the chart this element presents. */
+    for: string;
+    protected chart?: ChartLinkTarget;
+    connectedCallback(): void;
+    disconnectedCallback(): void;
+    protected willUpdate(changed: PropertyValues): void;
+    protected chartConnected(_chart: ChartLinkTarget): void;
+    protected chartDisconnected(_chart: ChartLinkTarget): void;
+}
+//# sourceMappingURL=chart-link.d.ts.map

package/types/src/chart-link.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chart-link.d.ts","sourceRoot":"","sources":["../../src/chart-link.ts"],"names":[],"mappings":"AAAA,OAAO,EAAY,UAAU,EAAE,KAAK,cAAc,EAAE,MAAM,KAAK,CAAA;AAE/D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAA;AACtD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAA;AAE3D,sGAAsG;AACtG,MAAM,WAAW,eAAgB,SAAQ,WAAW;IAClD,cAAc,IAAI,eAAe,EAAE,CAAA;IACnC,iBAAiB,IAAI,mBAAmB,GAAG,IAAI,CAAA;IAC/C,aAAa,IAAI,OAAO,CAAA;IACxB,uBAAuB,CAAC,SAAS,EAAE,WAAW,GAAG,IAAI,CAAA;IACrD,yBAAyB,CAAC,SAAS,EAAE,WAAW,GAAG,IAAI,CAAA;IACvD,wBAAwB,CAAC,SAAS,EAAE,WAAW,GAAG,IAAI,CAAA;IACtD,0BAA0B,CAAC,SAAS,EAAE,WAAW,GAAG,IAAI,CAAA;CACzD;AAED,yFAAyF;AACzF,8BAAsB,kBAAmB,SAAQ,UAAU;;IACzD,6CAA6C;IACF,GAAG,SAAK;IAEnD,SAAS,CAAC,KAAK,CAAC,EAAE,eAAe,CAAA;IAIxB,iBAAiB,IAAI,IAAI;IAkBzB,oBAAoB,IAAI,IAAI;cAclB,UAAU,CAAC,OAAO,EAAE,cAAc,GAAG,IAAI;IAI5D,SAAS,CAAC,cAAc,CAAC,MAAM,EAAE,eAAe,GAAG,IAAI;IAEvD,SAAS,CAAC,iBAAiB,CAAC,MAAM,EAAE,eAAe,GAAG,IAAI;CA0B3D"}

package/types/src/chart-theme.d.ts

@@ -42,6 +42,8 @@ export interface ChartTheme {
     fontSize: number;
     lineWidth: number;
     pointRadius: number;
+    /** Roundedness of a bar's value end, expressed as a 0–0.5 share of its width. */
+    barRadius: number;
 }
 /**
  * Resolves and caches the host's chart theme, and invalidates it whenever the page's colour scheme moves.

package/types/src/chart-theme.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"chart-theme.d.ts","sourceRoot":"","sources":["../../src/chart-theme.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,OAAO,EAAY,KAAK,kBAAkB,EAAE,KAAK,sBAAsB,EAAE,MAAM,KAAK,CAAA;AAEpF,mGAAmG;AACnG,KAAK,SAAS,GAAG,sBAAsB,GAAG,WAAW,GAAG;IAAE,QAAQ,CAAC,UAAU,CAAC,EAAE,UAAU,CAAA;CAAE,CAAA;AAE5F,wFAAwF;AACxF,eAAO,MAAM,YAAY,IAAI,CAAA;AAE7B;;;GAGG;AACH,eAAO,MAAM,YAAY,kOAmBf,CAAA;AAEV,gFAAgF;AAChF,MAAM,WAAW,UAAU;IACzB,yEAAyE;IACzE,OAAO,EAAE,MAAM,EAAE,CAAA;IACjB,mEAAmE;IACnE,KAAK,EAAE,MAAM,CAAA;IACb,wDAAwD;IACxD,UAAU,EAAE,MAAM,CAAA;IAClB,SAAS,EAAE,MAAM,CAAA;IACjB,SAAS,EAAE,MAAM,CAAA;IACjB,OAAO,EAAE,MAAM,CAAA;IACf,iBAAiB,EAAE,MAAM,CAAA;IACzB,YAAY,EAAE,MAAM,CAAA;IACpB,cAAc,EAAE,MAAM,CAAA;IACtB,qFAAqF;IACrF,QAAQ,EAAE,MAAM,CAAA;IAChB,QAAQ,EAAE,MAAM,CAAA;IAChB,UAAU,EAAE,MAAM,CAAA;IAClB,QAAQ,EAAE,MAAM,CAAA;IAChB,SAAS,EAAE,MAAM,CAAA;IACjB,WAAW,EAAE,MAAM,CAAA;CACpB;AAoBD;;;;;;GAMG;AACH,qBAAa,oBAAqB,YAAW,kBAAkB;;gBAOjD,IAAI,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,IAAI;IAMjD,0EAA0E;IAC1E,IAAI,KAAK,IAAI,UAAU,CAGtB;IAED,+EAA+E;IAC/E,UAAU,IAAI,IAAI;IAKlB,aAAa,IAAI,IAAI;IAarB,gBAAgB,IAAI,IAAI;CAiDzB"}
+{"version":3,"file":"chart-theme.d.ts","sourceRoot":"","sources":["../../src/chart-theme.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,OAAO,EAAY,KAAK,kBAAkB,EAAE,KAAK,sBAAsB,EAAE,MAAM,KAAK,CAAA;AAEpF,mGAAmG;AACnG,KAAK,SAAS,GAAG,sBAAsB,GAAG,WAAW,GAAG;IAAE,QAAQ,CAAC,UAAU,CAAC,EAAE,UAAU,CAAA;CAAE,CAAA;AAE5F,wFAAwF;AACxF,eAAO,MAAM,YAAY,IAAI,CAAA;AAE7B;;;GAGG;AACH,eAAO,MAAM,YAAY,kOAmBf,CAAA;AAEV,gFAAgF;AAChF,MAAM,WAAW,UAAU;IACzB,yEAAyE;IACzE,OAAO,EAAE,MAAM,EAAE,CAAA;IACjB,mEAAmE;IACnE,KAAK,EAAE,MAAM,CAAA;IACb,wDAAwD;IACxD,UAAU,EAAE,MAAM,CAAA;IAClB,SAAS,EAAE,MAAM,CAAA;IACjB,SAAS,EAAE,MAAM,CAAA;IACjB,OAAO,EAAE,MAAM,CAAA;IACf,iBAAiB,EAAE,MAAM,CAAA;IACzB,YAAY,EAAE,MAAM,CAAA;IACpB,cAAc,EAAE,MAAM,CAAA;IACtB,qFAAqF;IACrF,QAAQ,EAAE,MAAM,CAAA;IAChB,QAAQ,EAAE,MAAM,CAAA;IAChB,UAAU,EAAE,MAAM,CAAA;IAClB,QAAQ,EAAE,MAAM,CAAA;IAChB,SAAS,EAAE,MAAM,CAAA;IACjB,WAAW,EAAE,MAAM,CAAA;IACnB,iFAAiF;IACjF,SAAS,EAAE,MAAM,CAAA;CAClB;AAqBD;;;;;;GAMG;AACH,qBAAa,oBAAqB,YAAW,kBAAkB;;gBAOjD,IAAI,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,IAAI;IAMjD,0EAA0E;IAC1E,IAAI,KAAK,IAAI,UAAU,CAGtB;IAED,+EAA+E;IAC/E,UAAU,IAAI,IAAI;IAKlB,aAAa,IAAI,IAAI;IAarB,gBAAgB,IAAI,IAAI;CAkDzB"}