@wil-works/evoke-charts 0.2.0 → 0.3.1

package/dist/index.mjs

@@ -1,4 +1,4 @@
-import { Fragment, Transition, computed, createBlock, createCommentVNode, createElementBlock, createElementVNode, createVNode, h, inject, nextTick, normalizeClass, normalizeStyle, onMounted, onUnmounted, openBlock, provide, ref, renderList, resolveDynamicComponent, toDisplayString, watch, withCtx } from "vue";
+import { Fragment, Transition, computed, createBlock, createCommentVNode, createElementBlock, createElementVNode, createVNode, h, inject, nextTick, normalizeClass, normalizeStyle, onMounted, onUnmounted, openBlock, provide, ref, renderList, renderSlot, resolveDynamicComponent, toDisplayString, watch, withCtx } from "vue";
 //#region src/types.js
 var DEFAULT_I18N_ZH = {
 	tooltip: {
@@ -121,19 +121,62 @@ function estimateTextWidth(text, fontSize = 12) {
 	}
 	return width;
 }
+/** 解析 `#rgb` / `#rrggbb` / `rgb()` / `rgba()` 为通道数组；无法识别返回 null */
+function parseColorChannels(color) {
+	if (typeof color !== "string") return null;
+	const text = color.trim();
+	const hex = text.replace(/^#/, "");
+	if (/^[0-9a-fA-F]{3}$/.test(hex)) return [
+		0,
+		1,
+		2
+	].map((i) => parseInt(hex[i] + hex[i], 16));
+	if (/^[0-9a-fA-F]{6}$/.test(hex)) return [
+		0,
+		2,
+		4
+	].map((i) => parseInt(hex.slice(i, i + 2), 16));
+	const rgbMatch = text.match(/^rgba?\(\s*([\d.]+)[\s,]+([\d.]+)[\s,]+([\d.]+)/i);
+	if (rgbMatch) return [
+		1,
+		2,
+		3
+	].map((i) => Math.round(parseFloat(rgbMatch[i])));
+	return null;
+}
+/** 浅色底判断（YIQ）：底色可能来自令牌、混合出的 `rgb()` 或自定义主题 */
+function isLightColor(color) {
+	const ch = parseColorChannels(color);
+	if (!ch) return true;
+	return (ch[0] * 299 + ch[1] * 587 + ch[2] * 114) / 1e3 >= 150;
+}
+function relativeLuminance(ch) {
+	const [r, g, b] = ch.map((v) => {
+		const s = v / 255;
+		return s <= .03928 ? s / 12.92 : Math.pow((s + .055) / 1.055, 2.4);
+	});
+	return .2126 * r + .7152 * g + .0722 * b;
+}
+/** 底色上的文字取反色：白字/深字谁对比度高用谁——中间调底色（如逐层提亮后的蓝）
+*  用亮度阈值会误判成白字，导致浅底白字看不清 */
 function getContrastText(bgColor) {
-	const hex = bgColor.replace("#", "");
-	let r = 0, g = 0, b = 0;
-	if (hex.length === 3) {
-		r = parseInt(hex[0] + hex[0], 16);
-		g = parseInt(hex[1] + hex[1], 16);
-		b = parseInt(hex[2] + hex[2], 16);
-	} else if (hex.length >= 6) {
-		r = parseInt(hex.slice(0, 2), 16);
-		g = parseInt(hex.slice(2, 4), 16);
-		b = parseInt(hex.slice(4, 6), 16);
-	}
-	return (r * 299 + g * 587 + b * 114) / 1e3 >= 150 ? "#111827" : "#ffffff";
+	const ch = parseColorChannels(bgColor);
+	if (!ch) return "#111827";
+	const luminance = relativeLuminance(ch);
+	const againstWhite = 1.05 / (luminance + .05);
+	return (luminance + .05) / (relativeLuminance([
+		17,
+		24,
+		39
+	]) + .05) >= againstWhite ? "#111827" : "#ffffff";
+}
+/** 颜色向 target 混合（ratio 0-1），返回 `#rrggbb`：同色系逐层提亮/压暗用 */
+function mixColor(color, ratio, target) {
+	const from = parseColorChannels(color);
+	const to = parseColorChannels(target);
+	if (!from || !to) return color;
+	const r = Math.max(0, Math.min(1, ratio));
+	return `#${from.map((v, i) => Math.round(v + (to[i] - v) * r)).map((v) => v.toString(16).padStart(2, "0")).join("")}`;
 }
 function isMissingValue(v) {
 	return v === null || v === void 0 || Number.isNaN(v);
@@ -320,6 +363,15 @@ function estimateYAxisLeft(options) {
 	const axisConfig = options.yAxis || {};
 	if (axisConfig.type === "log") return 65;
 	try {
+		if (options.type === "horizontal-bar") {
+			const formatter = axisConfig.formatter;
+			const maxW = (options.labels || []).reduce((m, l) => {
+				const label = formatter ? String(formatter(l)) : String(l);
+				return Math.max(m, estimateTextWidth(label, 12));
+			}, 0);
+			if (!maxW) return 65;
+			return Math.max(40, Math.min(140, Math.round(maxW + 26)));
+		}
 		const range = calculateRange(options, /* @__PURE__ */ new Set(), false);
 		const min = axisConfig.min ?? range?.min;
 		const max = axisConfig.max ?? range?.max;
@@ -420,10 +472,12 @@ function getPadding(options, containerWidth = 600) {
 	}
 	const pad = resolveUserPadding(options);
 	const xAxisHidden = options.xAxis?.show === false;
+	const yAxisWidth = options.yAxis?.width;
+	const yAxisRightWidth = options.yAxisRight?.width;
 	let top = (pad.top ?? 18) + titleBlockHeight(options) + (legendPosition === "top" ? LEGEND_BAND + legendRowsExtra : 0);
 	let bottom = (pad.bottom ?? (xAxisHidden ? 12 : 46)) + (legendPosition === "bottom" ? LEGEND_BAND + legendRowsExtra : 0);
-	let left = pad.left ?? estimateYAxisLeft(options);
-	let right = pad.right ?? (hasYAxisRight ? 65 : 24);
+	let left = pad.left ?? (typeof yAxisWidth === "number" && yAxisWidth > 0 ? yAxisWidth : estimateYAxisLeft(options));
+	let right = pad.right ?? (typeof yAxisRightWidth === "number" && yAxisRightWidth > 0 ? yAxisRightWidth : hasYAxisRight ? 65 : 24);
 	if (legendPosition === "left") left += 80;
 	if (legendPosition === "right") right += 80;
 	if (hasXAxis && hasXAxisTitle) return {
@@ -639,12 +693,15 @@ function calculateRange(options, hiddenSeries, useRightAxis) {
 	const range = max - min || 1;
 	if (min >= 0) return {
 		min: 0,
-		max: max + range * .1
-	};
-	else return {
-		min: min - range * .1,
-		max: max + range * .1
+		max: max + Math.max(range * .1, max * .05)
 	};
+	else {
+		const pad = Math.max(range * .1, Math.max(Math.abs(max), Math.abs(min)) * .05);
+		return {
+			min: min - pad,
+			max: max + pad
+		};
+	}
 }
 function applyLogTransform(options) {
 	if (options.yAxis?.type !== "log") return options;
@@ -769,6 +826,20 @@ function truncateLabel(canvasCtx, label, maxWidth) {
 	}
 	return label.slice(0, lo) + "…";
 }
+/**
+* 抽稀刻度：保留首末两端覆盖，步长取整数倍使数量 ≤ maxCount。
+* nice 算法的 step 候选会让实际刻度数超出请求数（如 ticks:3 得到 5 档），
+* 显式 ticks 视为硬上限，超出的中间档按均匀步长抽稀（round 值不丢）。
+*/
+function thinTickValues(values, maxCount) {
+	const limit = Math.max(2, maxCount);
+	if (values.length <= limit) return values;
+	let stride = Math.ceil((values.length - 1) / (limit - 1));
+	while (stride < values.length - 1 && (values.length - 1) % stride !== 0) stride += 1;
+	const thinned = [];
+	for (let i = 0; i < values.length; i += stride) thinned.push(values[i]);
+	return thinned;
+}
 function drawAxisLine(canvasCtx, cfg, theme, x1, y1, x2, y2) {
 	if (cfg?.axisLine?.show === false) return;
 	canvasCtx.save();
@@ -795,7 +866,10 @@ function drawAxisTick(canvasCtx, cfg, theme, x, y, dx, dy) {
 function renderYAxis(ctx, side = "left", dataRange) {
 	const { ctx: canvasCtx, theme, plotArea, options, width } = ctx;
 	const axisConfig = side === "left" ? options.yAxis || {} : options.yAxisRight || {};
-	const ticks = axisConfig.ticks || 5;
+	const requestedTicks = axisConfig.ticks || 5;
+	const maxByHeight = Math.max(2, Math.floor(plotArea.height / 24) + 1);
+	const tickCap = axisConfig.ticks != null ? Math.min(requestedTicks, maxByHeight) : maxByHeight;
+	const needsThin = axisConfig.ticks != null || maxByHeight < requestedTicks;
 	const isLog = side === "left" && axisConfig.type === "log";
 	let computedMax;
 	let computedMin;
@@ -810,7 +884,8 @@ function renderYAxis(ctx, side = "left", dataRange) {
 		}
 	}
 	const max = axisConfig.max ?? computedMax;
-	const { min: actualMin, max: actualMax, tickValues } = resolveTickExtendedRange(axisConfig.min ?? computedMin, max, ticks);
+	const { min: actualMin, max: actualMax, tickValues: niceTicks } = resolveTickExtendedRange(axisConfig.min ?? computedMin, max, requestedTicks);
+	const tickValues = needsThin ? thinTickValues(niceTicks, tickCap) : niceTicks;
 	canvasCtx.save();
 	canvasCtx.strokeStyle = theme.gridColor;
 	canvasCtx.fillStyle = theme.textColorSecondary;
@@ -1041,6 +1116,10 @@ function xToCategoryIndex(options, plotArea, labels, x) {
 	return Math.round((x - plotArea.x) / step);
 }
 function renderAnnotations(ctx, yRange) {
+	renderLegacyAnnotation(ctx, yRange);
+	renderNarrativeAnnotations(ctx, yRange);
+}
+function renderLegacyAnnotation(ctx, yRange) {
 	const { ctx: canvasCtx, theme, plotArea, options } = ctx;
 	const annotation = options.annotation;
 	if (!annotation) return;
@@ -1103,6 +1182,196 @@ function renderAnnotations(ctx, yRange) {
 		canvasCtx.restore();
 	});
 }
+var ANNOTATION_ANCHORS = {
+	top: [
+		0,
+		-1,
+		"center",
+		"bottom"
+	],
+	bottom: [
+		0,
+		1,
+		"center",
+		"top"
+	],
+	left: [
+		-1,
+		0,
+		"end",
+		"middle"
+	],
+	right: [
+		1,
+		0,
+		"start",
+		"middle"
+	],
+	"top-left": [
+		-1,
+		-1,
+		"end",
+		"bottom"
+	],
+	"top-right": [
+		1,
+		-1,
+		"start",
+		"bottom"
+	],
+	"bottom-left": [
+		-1,
+		1,
+		"end",
+		"top"
+	],
+	"bottom-right": [
+		1,
+		1,
+		"start",
+		"top"
+	]
+};
+function resolveAnnotationX(ctx, x, xPx) {
+	if (typeof xPx === "number") return xPx;
+	const { plotArea, options } = ctx;
+	const labels = options.labels || [];
+	const idx = typeof x === "number" ? x : labels.indexOf(x);
+	if (idx < 0) return NaN;
+	return categoryToX(options, plotArea, labels, idx);
+}
+function resolveAnnotationY(ctx, y, yPx, yRange) {
+	if (typeof yPx === "number") return yPx;
+	if (typeof y !== "number" || !yRange) return NaN;
+	const { plotArea } = ctx;
+	return plotArea.y + plotArea.height - (y - yRange.min) / (yRange.max - yRange.min) * plotArea.height;
+}
+function annotationSeriesColor(ctx, ref) {
+	const { theme, options } = ctx;
+	const series = options.series || [];
+	if (typeof ref === "number") return series[ref]?.color || theme.colors[ref] || theme.colors[0] || "#175DFF";
+	if (typeof ref === "string") {
+		const i = series.findIndex((s) => s.name === ref);
+		if (i >= 0) return series[i].color || theme.colors[i] || theme.colors[0] || "#175DFF";
+	}
+	return theme.colors[0] || "#175DFF";
+}
+function renderNarrativeAnnotations(ctx, yRange) {
+	const { ctx: canvasCtx, theme, plotArea, options } = ctx;
+	const list = options.annotations || [];
+	if (list.length === 0) return;
+	const secondary = theme.textColorSecondary;
+	list.forEach((a) => {
+		if (!a || !a.type) return;
+		if (a.type === "region") {
+			const x1 = resolveAnnotationX(ctx, a.from);
+			const x2 = resolveAnnotationX(ctx, a.to);
+			if (!Number.isFinite(x1) || !Number.isFinite(x2)) return;
+			const labels = options.labels || [];
+			const band = labels.length > 0 ? plotArea.width / labels.length : 0;
+			const left = Math.min(x1, x2) - band / 2;
+			const width = Math.abs(x2 - x1) + band;
+			canvasCtx.save();
+			canvasCtx.globalAlpha = .06;
+			canvasCtx.fillStyle = a.color || theme.colors[0] || "#175DFF";
+			canvasCtx.fillRect(left, plotArea.y, width, plotArea.height);
+			canvasCtx.restore();
+			if (a.label) {
+				canvasCtx.save();
+				canvasCtx.fillStyle = secondary;
+				canvasCtx.font = "italic 400 11px Inter, sans-serif";
+				canvasCtx.textAlign = "left";
+				canvasCtx.textBaseline = "top";
+				canvasCtx.fillText(a.label, left + 4, plotArea.y + 6);
+				canvasCtx.restore();
+			}
+			return;
+		}
+		const px = resolveAnnotationX(ctx, a.x, a.xPx);
+		const py = resolveAnnotationY(ctx, a.y, a.yPx, yRange);
+		if (!Number.isFinite(px) || !Number.isFinite(py)) return;
+		const color = a.color || annotationSeriesColor(ctx, a.series);
+		canvasCtx.save();
+		if (a.type === "point") {
+			canvasCtx.fillStyle = color;
+			canvasCtx.beginPath();
+			canvasCtx.arc(px, py, 3, 0, Math.PI * 2);
+			canvasCtx.fill();
+			canvasCtx.globalAlpha = .85;
+			canvasCtx.strokeStyle = color;
+			canvasCtx.lineWidth = 1.5;
+			canvasCtx.beginPath();
+			canvasCtx.arc(px, py, 6, 0, Math.PI * 2);
+			canvasCtx.stroke();
+			canvasCtx.restore();
+			return;
+		}
+		if (a.type === "delta") {
+			const up = a.direction !== "down";
+			const deltaColor = a.color || (up ? options.candleUpColor || "#dc2626" : options.candleDownColor || "#16a34a");
+			const text = a.text || a.label || "";
+			canvasCtx.fillStyle = deltaColor;
+			canvasCtx.beginPath();
+			if (up) {
+				canvasCtx.moveTo(px, py - 16);
+				canvasCtx.lineTo(px - 5, py - 9);
+				canvasCtx.lineTo(px + 5, py - 9);
+			} else {
+				canvasCtx.moveTo(px, py + 16);
+				canvasCtx.lineTo(px - 5, py + 9);
+				canvasCtx.lineTo(px + 5, py + 9);
+			}
+			canvasCtx.closePath();
+			canvasCtx.fill();
+			if (text) {
+				canvasCtx.fillStyle = deltaColor;
+				canvasCtx.font = "600 11px Inter, sans-serif";
+				canvasCtx.textAlign = "center";
+				if (up) {
+					canvasCtx.textBaseline = "bottom";
+					canvasCtx.fillText(text, px, py - 20);
+				} else {
+					canvasCtx.textBaseline = "top";
+					canvasCtx.fillText(text, px, py + 20);
+				}
+			}
+			canvasCtx.restore();
+			return;
+		}
+		if (a.type === "callout") {
+			const [dx, dy, align, baseline] = ANNOTATION_ANCHORS[a.anchor] || ANNOTATION_ANCHORS["top-right"];
+			const lx = px + dx * 16 + (a.offsetX || 0);
+			const ly = py + dy * 16 + (a.offsetY || 0);
+			canvasCtx.fillStyle = color;
+			canvasCtx.strokeStyle = color;
+			canvasCtx.lineWidth = 1;
+			canvasCtx.setLineDash([3, 3]);
+			canvasCtx.beginPath();
+			canvasCtx.arc(px, py, 2, 0, Math.PI * 2);
+			canvasCtx.fill();
+			canvasCtx.beginPath();
+			canvasCtx.moveTo(px + dx * 2, py + dy * 2);
+			canvasCtx.lineTo(lx - dx * 2, ly - dy * 2);
+			canvasCtx.stroke();
+			canvasCtx.setLineDash([]);
+			if (a.label) {
+				canvasCtx.fillStyle = a.textColor || secondary;
+				canvasCtx.font = "italic 400 11px Inter, sans-serif";
+				canvasCtx.textAlign = align;
+				canvasCtx.textBaseline = baseline;
+				canvasCtx.fillText(a.label, lx + dx * 2, ly + dy * 2);
+			}
+			canvasCtx.restore();
+			return;
+		}
+		canvasCtx.fillStyle = a.color || secondary;
+		canvasCtx.font = `italic ${a.fontWeight || 400} 11px Inter, sans-serif`;
+		canvasCtx.textAlign = "center";
+		canvasCtx.textBaseline = "bottom";
+		canvasCtx.fillText(a.text || a.label || "", px + (a.offsetX || 0), py + (a.offsetY !== void 0 ? a.offsetY : -6));
+		canvasCtx.restore();
+	});
+}
 function renderHoverHighlight(ctx, points) {
 	if (ctx.hoverIndex < 0) return;
 	const { ctx: canvasCtx, theme, plotArea } = ctx;
@@ -1267,6 +1536,12 @@ function collectLegendItems(options, theme, hiddenSeries) {
 		color: d.color || theme.colors[i % theme.colors.length],
 		hidden: hiddenSeries.has(d.label || "")
 	}));
+	if (options.type === "scatter") return (options.scatterData || []).map((d, i) => ({
+		name: d.label || `P${i + 1}`,
+		label: fmt(d.label || `P${i + 1}`),
+		color: d.color || theme.colors[i % theme.colors.length],
+		hidden: hiddenSeries.has(d.label || `P${i + 1}`)
+	}));
 	return (options.series || []).map((s, i) => ({
 		name: s.name,
 		label: fmt(s.name),
@@ -1445,12 +1720,69 @@ function renderToolbox(ctx, hoveredFeature) {
 		canvasCtx.restore();
 	});
 }
+/**
+* items: [{ angle, r, text }]（angle 扇区中角，r 引线锚点半径）
+* cfg: { canvasCtx, centerX, centerY, plotArea, theme } + 可选覆写
+*/
+function drawCalloutLabels(items, cfg) {
+	const { canvasCtx, centerX, centerY, plotArea, theme, radialLen = 14, stubLen = 12, textGap = 5, minGap = 16, maxShift = 10, font = "12px Inter, sans-serif", textColor = theme.textColor, lineColor = theme.textColorSecondary } = cfg;
+	if (!canvasCtx || items.length === 0) return;
+	const topLimit = plotArea.y + 4;
+	const bottomLimit = plotArea.y + plotArea.height - 4;
+	const layoutSide = (side, sign) => {
+		const sorted = side.map((it) => ({
+			...it,
+			y: centerY + Math.sin(it.angle) * (it.r + radialLen),
+			visible: true
+		})).sort((a, b) => a.y - b.y);
+		let lastY = -Infinity;
+		sorted.forEach((it) => {
+			let y = it.y;
+			if (y < lastY + minGap) {
+				const shifted = lastY + minGap;
+				if (shifted - it.y <= maxShift && shifted <= bottomLimit) y = shifted;
+				else {
+					it.visible = false;
+					return;
+				}
+			}
+			if (y > bottomLimit || y < topLimit) {
+				it.visible = false;
+				return;
+			}
+			it.y = y;
+			lastY = y;
+		});
+		sorted.forEach((it) => {
+			if (!it.visible) return;
+			const dirX = Math.cos(it.angle);
+			const dirY = Math.sin(it.angle);
+			const p1x = centerX + dirX * (it.r + radialLen);
+			const p1y = centerY + dirY * (it.r + radialLen);
+			const p2x = p1x + sign * stubLen;
+			canvasCtx.save();
+			canvasCtx.strokeStyle = lineColor;
+			canvasCtx.lineWidth = 1;
+			canvasCtx.beginPath();
+			canvasCtx.moveTo(centerX + dirX * it.r, centerY + dirY * it.r);
+			canvasCtx.lineTo(p1x, p1y);
+			canvasCtx.lineTo(p2x, it.y);
+			canvasCtx.stroke();
+			canvasCtx.restore();
+			canvasCtx.save();
+			canvasCtx.fillStyle = textColor;
+			canvasCtx.font = font;
+			canvasCtx.textAlign = sign === 1 ? "left" : "right";
+			canvasCtx.textBaseline = "middle";
+			canvasCtx.fillText(it.text, p2x + sign * textGap, it.y);
+			canvasCtx.restore();
+		});
+	};
+	layoutSide(items.filter((it) => Math.cos(it.angle) >= 0), 1);
+	layoutSide(items.filter((it) => Math.cos(it.angle) < 0), -1);
+}
 //#endregion
 //#region src/renderer/charts-basic.js
-var PIE_RADIAL_LEN = 14;
-var PIE_STUB_LEN = 12;
-var PIE_TEXT_GAP = 5;
-var PIE_MAX_SHIFT = 10;
 function computePieMaxRadius(pieData, options, plotArea) {
 	const total = pieData.reduce((sum, d) => sum + d.value, 0);
 	if (total <= 0) return 30;
@@ -2069,70 +2401,21 @@ function renderPieChart(ctx, isDoughnut, isRose = false) {
 		if (progress > .9) {
 			const percentage = (data.value / total * 100).toFixed(1);
 			const text = percentMode ? `${percentage}%` : `${data.label || ""} (${percentage}%)`;
-			const r = isRose ? roseRadius : maxRadius;
 			labelItems.push({
 				angle: midAngle,
-				r,
-				color,
-				text,
-				y: centerY + Math.sin(midAngle) * (r + PIE_RADIAL_LEN),
-				visible: true
+				r: isRose ? roseRadius : maxRadius,
+				text
 			});
 		}
 		startAngle = endAngle;
 	});
-	if (labelItems.length > 0 && progress > .9) {
-		const minGap = 16;
-		const topLimit = plotArea.y + 4;
-		const bottomLimit = plotArea.y + plotArea.height - 4;
-		const layoutSide = (items, sign) => {
-			const sorted = [...items].sort((a, b) => a.y - b.y);
-			let lastY = -Infinity;
-			sorted.forEach((it) => {
-				let y = it.y;
-				if (y < lastY + minGap) {
-					const shifted = lastY + minGap;
-					if (shifted - it.y <= PIE_MAX_SHIFT && shifted <= bottomLimit) y = shifted;
-					else {
-						it.visible = false;
-						return;
-					}
-				}
-				if (y > bottomLimit || y < topLimit) {
-					it.visible = false;
-					return;
-				}
-				it.y = y;
-				lastY = y;
-			});
-			sorted.forEach((it) => {
-				if (!it.visible) return;
-				const dirX = Math.cos(it.angle);
-				const dirY = Math.sin(it.angle);
-				const p1x = centerX + dirX * (it.r + PIE_RADIAL_LEN);
-				const p1y = centerY + dirY * (it.r + PIE_RADIAL_LEN);
-				const p2x = p1x + sign * PIE_STUB_LEN;
-				canvasCtx.save();
-				canvasCtx.strokeStyle = theme.textColorSecondary;
-				canvasCtx.lineWidth = 1;
-				canvasCtx.beginPath();
-				canvasCtx.moveTo(centerX + dirX * it.r, centerY + dirY * it.r);
-				canvasCtx.lineTo(p1x, p1y);
-				canvasCtx.lineTo(p2x, it.y);
-				canvasCtx.stroke();
-				canvasCtx.restore();
-				canvasCtx.save();
-				canvasCtx.fillStyle = theme.textColor;
-				canvasCtx.font = "12px Inter, sans-serif";
-				canvasCtx.textAlign = sign === 1 ? "left" : "right";
-				canvasCtx.textBaseline = "middle";
-				canvasCtx.fillText(it.text, p2x + sign * PIE_TEXT_GAP, it.y);
-				canvasCtx.restore();
-			});
-		};
-		layoutSide(labelItems.filter((it) => Math.cos(it.angle) >= 0), 1);
-		layoutSide(labelItems.filter((it) => Math.cos(it.angle) < 0), -1);
-	}
+	if (labelItems.length > 0 && progress > .9) drawCalloutLabels(labelItems, {
+		canvasCtx,
+		centerX,
+		centerY,
+		plotArea,
+		theme
+	});
 	if (isDoughnut && options.gauge?.value !== void 0) {
 		canvasCtx.save();
 		canvasCtx.fillStyle = theme.textColor;
@@ -2175,6 +2458,10 @@ function renderScatterChart(ctx, yRange) {
 	const points = [];
 	const yFactor = Math.min(ctx.progress * 1.2, 1);
 	scatterData.forEach((point, i) => {
+		if (ctx.hiddenSeries.has(point.label || `P${i + 1}`)) {
+			points.push([NaN, NaN]);
+			return;
+		}
 		const x = scale.toX(point.x);
 		const finalY = scale.toY(point.y);
 		const animatedY = plotArea.y + plotArea.height - (plotArea.y + plotArea.height - finalY) * yFactor;
@@ -2327,6 +2614,20 @@ function renderRadarChart(ctx) {
 		canvasCtx.stroke();
 	}
 	canvasCtx.restore();
+	const sharedMax = indicators[0].max;
+	const sharedMin = indicators[0].min || 0;
+	if (sharedMax != null && indicators.every((ind) => (ind.max ?? sharedMax) === sharedMax && (ind.min || 0) === sharedMin)) {
+		canvasCtx.save();
+		canvasCtx.fillStyle = theme.textColorSecondary;
+		canvasCtx.font = "10px Inter, sans-serif";
+		canvasCtx.textAlign = "left";
+		canvasCtx.textBaseline = "middle";
+		for (let level = 1; level <= 5; level++) {
+			const v = sharedMin + (sharedMax - sharedMin) * level / 5;
+			canvasCtx.fillText(Number.isInteger(sharedMax) ? String(Math.round(v)) : v.toFixed(1), centerX + 5, centerY - radius * level / 5);
+		}
+		canvasCtx.restore();
+	}
 	canvasCtx.save();
 	canvasCtx.fillStyle = theme.textColorSecondary;
 	canvasCtx.font = "12px Inter, sans-serif";
@@ -2380,7 +2681,15 @@ function renderRadarChart(ctx) {
 				else canvasCtx.lineTo(p[0], p[1]);
 			});
 			canvasCtx.closePath();
-			canvasCtx.fillStyle = color + (hoverIndex >= 0 ? "50" : "30");
+			if (/^#[0-9a-fA-F]{6}$/.test(color)) {
+				const grad = canvasCtx.createLinearGradient(0, centerY - radius, 0, centerY + radius);
+				grad.addColorStop(0, color + (hoverIndex >= 0 ? "59" : "40"));
+				grad.addColorStop(1, color + "08");
+				canvasCtx.fillStyle = grad;
+			} else {
+				canvasCtx.fillStyle = color;
+				canvasCtx.globalAlpha = alpha * .18;
+			}
 			canvasCtx.fill();
 			canvasCtx.restore();
 		}
@@ -2393,15 +2702,17 @@ function renderRadarChart(ctx) {
 		});
 		canvasCtx.closePath();
 		canvasCtx.strokeStyle = color;
-		canvasCtx.lineWidth = hoverIndex >= 0 ? 2.5 : 2;
+		canvasCtx.lineWidth = hoverIndex >= 0 ? 2.5 : 1.5;
 		canvasCtx.stroke();
 		canvasCtx.restore();
 		canvasCtx.save();
 		canvasCtx.globalAlpha = alpha;
+		const showSymbol = s.showSymbol === true;
 		points.forEach((p, i) => {
 			const isHover = i === hoverIndex;
+			if (!showSymbol && !isHover) return;
 			canvasCtx.beginPath();
-			canvasCtx.arc(p[0], p[1], isHover ? 6 : 4, 0, Math.PI * 2);
+			canvasCtx.arc(p[0], p[1], isHover ? 6 : 3, 0, Math.PI * 2);
 			canvasCtx.fillStyle = isHover ? theme.backgroundColor : color;
 			canvasCtx.fill();
 			canvasCtx.strokeStyle = color;
@@ -2436,11 +2747,14 @@ function renderFunnelChart(ctx) {
 	const stepHeight = (plotArea.y + plotArea.height - 8 - topY) / funnelData.length;
 	const maxValue = Math.max(...funnelData.map((d) => d.value));
 	const drawData = options.pyramid === true ? [...funnelData].reverse() : funnelData;
+	const labelAlpha = Math.min(1, Math.max(0, (progress - .72) / .28));
+	const outsideLabels = [];
 	drawData.forEach((data, i) => {
 		const color = data.color || theme.colors[funnelData.indexOf(data) % theme.colors.length];
 		const isHover = i === hoverIndex;
-		const currentWidth = data.value / maxValue * maxWidth * progress;
-		const nextWidth = (drawData[i + 1]?.value ?? data.value * .5) / maxValue * maxWidth * progress;
+		const easedWidth = 1 - Math.pow(1 - progress, 3);
+		const currentWidth = data.value / maxValue * maxWidth * easedWidth;
+		const nextWidth = (drawData[i + 1]?.value ?? data.value * .5) / maxValue * maxWidth * easedWidth;
 		const y = topY + i * stepHeight;
 		const yOffset = isHover ? -3 : 0;
 		canvasCtx.save();
@@ -2455,48 +2769,67 @@ function renderFunnelChart(ctx) {
 		canvasCtx.strokeStyle = theme.backgroundColor;
 		canvasCtx.lineWidth = 2;
 		canvasCtx.stroke();
-		if (progress > .8) {
-			const labelY = y + stepHeight / 2 + yOffset;
-			const percentage = (data.value / drawData[0].value * 100).toFixed(1);
-			const label = `${data.label}`;
-			const valueText = `${data.value} (${percentage}%)`;
+		canvasCtx.restore();
+		if (labelAlpha <= 0) return;
+		const labelY = y + stepHeight / 2 + yOffset;
+		const percentage = (data.value / drawData[0].value * 100).toFixed(1);
+		const label = `${data.label}`;
+		const valueText = `${data.value} (${percentage}%)`;
+		canvasCtx.save();
+		canvasCtx.font = "bold 13px Inter, sans-serif";
+		const labelWidth = canvasCtx.measureText(label).width;
+		canvasCtx.font = "11px Inter, sans-serif";
+		const valueWidth = canvasCtx.measureText(valueText).width;
+		const minTextWidth = Math.max(labelWidth, valueWidth) + 28;
+		if ((currentWidth + nextWidth) / 2 >= minTextWidth && stepHeight >= 36) {
+			canvasCtx.globalAlpha = labelAlpha;
+			canvasCtx.fillStyle = theme.backgroundColor;
 			canvasCtx.font = "bold 13px Inter, sans-serif";
-			const labelWidth = canvasCtx.measureText(label).width;
+			canvasCtx.textAlign = "center";
+			canvasCtx.textBaseline = "middle";
+			canvasCtx.fillText(label, centerX, labelY - 9);
 			canvasCtx.font = "11px Inter, sans-serif";
-			const valueWidth = canvasCtx.measureText(valueText).width;
-			const minTextWidth = Math.max(labelWidth, valueWidth) + 16;
-			if ((currentWidth + nextWidth) / 2 >= minTextWidth) {
-				canvasCtx.fillStyle = theme.backgroundColor;
-				canvasCtx.font = "bold 13px Inter, sans-serif";
-				canvasCtx.textAlign = "center";
-				canvasCtx.textBaseline = "middle";
-				canvasCtx.fillText(label, centerX, labelY - 8);
-				canvasCtx.font = "11px Inter, sans-serif";
-				canvasCtx.fillText(valueText, centerX, labelY + 8);
-			} else {
-				const lineEndX = centerX + currentWidth / 2;
-				const textX = plotArea.x + plotArea.width - 4;
-				canvasCtx.save();
-				canvasCtx.strokeStyle = theme.textColorSecondary;
-				canvasCtx.lineWidth = 1;
-				canvasCtx.setLineDash([3, 3]);
-				canvasCtx.beginPath();
-				canvasCtx.moveTo(lineEndX, labelY);
-				canvasCtx.lineTo(textX - 4, labelY);
-				canvasCtx.stroke();
-				canvasCtx.setLineDash([]);
-				canvasCtx.restore();
-				canvasCtx.fillStyle = theme.textColor;
-				canvasCtx.font = "bold 12px Inter, sans-serif";
-				canvasCtx.textAlign = "right";
-				canvasCtx.textBaseline = "bottom";
-				canvasCtx.fillText(label, textX, labelY - 1);
-				canvasCtx.font = "11px Inter, sans-serif";
-				canvasCtx.fillStyle = theme.textColorSecondary;
-				canvasCtx.textBaseline = "top";
-				canvasCtx.fillText(valueText, textX, labelY + 1);
-			}
-		}
+			canvasCtx.fillText(valueText, centerX, labelY + 9);
+		} else outsideLabels.push({
+			labelY,
+			lineEndX: centerX + currentWidth / 2,
+			label,
+			valueText,
+			labelTextWidth: Math.max(labelWidth, valueWidth)
+		});
+		canvasCtx.restore();
+	});
+	outsideLabels.sort((a, b) => a.labelY - b.labelY);
+	const textX = plotArea.x + plotArea.width - 4;
+	let lastBottom = -Infinity;
+	outsideLabels.map((o) => {
+		const top = Math.max(o.labelY - 13, lastBottom + 2);
+		lastBottom = top + 36;
+		return {
+			...o,
+			top
+		};
+	}).forEach((o) => {
+		canvasCtx.save();
+		canvasCtx.globalAlpha = labelAlpha;
+		canvasCtx.strokeStyle = theme.textColorSecondary;
+		canvasCtx.lineWidth = 1;
+		canvasCtx.setLineDash([3, 3]);
+		canvasCtx.beginPath();
+		canvasCtx.moveTo(o.lineEndX, o.labelY);
+		canvasCtx.lineTo(textX - o.labelTextWidth - 10, o.top + 12);
+		canvasCtx.stroke();
+		canvasCtx.setLineDash([]);
+		const nameY = o.top + 12;
+		canvasCtx.fillStyle = theme.textColor;
+		canvasCtx.font = "bold 12px Inter, sans-serif";
+		canvasCtx.textAlign = "right";
+		canvasCtx.textBaseline = "bottom";
+		canvasCtx.fillText(o.label, textX, nameY);
+		canvasCtx.font = "11px Inter, sans-serif";
+		canvasCtx.fillStyle = theme.textColorSecondary;
+		canvasCtx.textBaseline = "top";
+		canvasCtx.fillText(o.valueText, textX, nameY + 2);
 		canvasCtx.restore();
 	});
 }
@@ -2980,42 +3313,40 @@ function squarifyTreemap(nodes, x, y, w, h, depth, result) {
 	});
 	return result;
 }
+function isRectWithinFocus(rect, focus) {
+	return rect.depth >= focus.depth && rect.x >= focus.x - .5 && rect.y >= focus.y - .5 && rect.x + rect.w <= focus.x + focus.w + .5 && rect.y + rect.h <= focus.y + focus.h + .5;
+}
 function renderTreemapChart(ctx) {
-	const { ctx: canvasCtx, theme, plotArea, options, progress, hoverIndex, valueFormatter } = ctx;
+	const { ctx: canvasCtx, theme, plotArea, options, progress, hoverIndex, valueFormatter, hoverAnimProgress = 1 } = ctx;
 	const rootData = options.treemapData || [];
 	if (rootData.length === 0) return;
 	const rects = [];
 	squarifyTreemap(rootData, plotArea.x, plotArea.y, plotArea.width, plotArea.height, 0, rects);
 	const totalValue = rootData.reduce((s, n) => s + treemapValueOf(n), 0);
 	const scale = progress;
-	function drawRect(rect, isHover) {
+	const focus = hoverIndex >= 0 && hoverIndex < rects.length ? rects[hoverIndex] : null;
+	const dimAlpha = 1 - .75 * hoverAnimProgress;
+	function drawRect(rect, isFocusRoot) {
 		const cx = rect.x + rect.w / 2;
 		const cy = rect.y + rect.h / 2;
 		const aw = rect.w * scale;
 		const ah = rect.h * scale;
 		const ax = cx - aw / 2;
 		const ay = cy - ah / 2;
-		const color = rect.node.color || theme.colors[(rect.colorSeed + rect.depth) % theme.colors.length];
+		const base = rect.node.color || theme.colors[(rect.colorSeed + rect.depth) % theme.colors.length];
+		const color = isFocusRoot ? mixColor(base, .08, "#000000") : base;
 		canvasCtx.save();
-		canvasCtx.fillStyle = isHover ? color : color + (rect.depth === 0 ? "" : "cc");
+		canvasCtx.globalAlpha = !focus || isRectWithinFocus(rect, focus) ? 1 : dimAlpha;
+		canvasCtx.fillStyle = isFocusRoot ? color : color + (rect.depth === 0 ? "" : "cc");
 		roundRect(canvasCtx, ax, ay, Math.max(0, aw), Math.max(0, ah), 3);
 		canvasCtx.fill();
-		if (!isHover) {
-			canvasCtx.strokeStyle = theme.backgroundColor;
-			canvasCtx.lineWidth = 2;
-			canvasCtx.stroke();
-		} else {
-			canvasCtx.shadowColor = color;
-			canvasCtx.shadowBlur = 10;
-			canvasCtx.strokeStyle = theme.textColor;
-			canvasCtx.lineWidth = 2.5;
-			canvasCtx.stroke();
-			canvasCtx.shadowBlur = 0;
-			canvasCtx.stroke();
-		}
+		canvasCtx.strokeStyle = theme.backgroundColor;
+		canvasCtx.lineWidth = 2;
+		canvasCtx.stroke();
 		canvasCtx.restore();
 		if (progress > .8 && aw > 50 && ah > 24) {
 			canvasCtx.save();
+			canvasCtx.globalAlpha = !focus || isRectWithinFocus(rect, focus) ? 1 : dimAlpha;
 			canvasCtx.fillStyle = getContrastText(color);
 			if (rect.node.children && rect.node.children.length > 0) {
 				canvasCtx.font = "bold 11px Inter, sans-serif";
@@ -3036,10 +3367,7 @@ function renderTreemapChart(ctx) {
 			canvasCtx.restore();
 		}
 	}
-	rects.forEach((rect, i) => {
-		if (i !== hoverIndex) drawRect(rect, false);
-	});
-	if (hoverIndex >= 0 && hoverIndex < rects.length) drawRect(rects[hoverIndex], true);
+	rects.forEach((rect) => drawRect(rect, focus === rect));
 }
 function renderSparklineChart(ctx) {
 	const { ctx: canvasCtx, theme, plotArea, options, progress, hoverIndex } = ctx;
@@ -3319,12 +3647,26 @@ function computeSunburstDepth(nodes) {
 	});
 	return max;
 }
-function layoutSunburst(nodes, r0, ringWidth, depth, startAngle, colorOffset, result) {
-	const total = nodes.reduce((s, n) => s + n.value, 0);
+var SUNBURST_HOLE_RATIO = .22;
+var SUNBURST_LIGHT_STEP = .26;
+var SUNBURST_LIGHT_MAX = .6;
+var SUNBURST_DARK_STEP = .14;
+var SUNBURST_DARK_MAX = .34;
+/** 父节点可省略 value（由子孙汇总）；直接读 n.value 会得到 NaN，
+*  让后续兄弟分支的角度全部失效、只剩第一个分支可见 */
+function sunburstValue(node) {
+	if (typeof node.value === "number" && Number.isFinite(node.value)) return node.value;
+	if (node.children && node.children.length > 0) return node.children.reduce((s, c) => s + sunburstValue(c), 0);
+	return 0;
+}
+function layoutSunburst(nodes, r0, ringWidth, depth, startAngle, colorOffset, result, sweep = Math.PI * 2, parentIndex = -1) {
+	const total = nodes.reduce((s, n) => s + sunburstValue(n), 0);
 	if (total <= 0) return result;
 	let a = startAngle;
 	nodes.forEach((n, i) => {
-		const span = n.value / total * Math.PI * 2;
+		const slot = depth === 0 ? (colorOffset + i) % 8 : colorOffset % 8;
+		const span = sweep * sunburstValue(n) / total;
+		const selfIndex = result.length;
 		result.push({
 			startAngle: a,
 			endAngle: a + span,
@@ -3332,25 +3674,72 @@ function layoutSunburst(nodes, r0, ringWidth, depth, startAngle, colorOffset, re
 			r0,
 			r1: r0 + ringWidth,
 			node: n,
+			value: sunburstValue(n),
 			depth,
-			colorIndex: (colorOffset + i) % 8
+			colorIndex: slot,
+			parentIndex
 		});
-		if (n.children && n.children.length > 0) layoutSunburst(n.children, r0 + ringWidth, ringWidth, depth + 1, a, colorOffset + i, result);
+		if (n.children && n.children.length > 0) layoutSunburst(n.children, r0 + ringWidth, ringWidth, depth + 1, a, slot, result, span, selfIndex);
 		a += span;
 	});
 	return result;
 }
-function renderSunburstChart(ctx) {
-	const { ctx: canvasCtx, theme, plotArea, options, progress, hoverIndex, valueFormatter } = ctx;
+function isSunburstDescendant(segments, index, ancestorIndex) {
+	let cursor = index;
+	while (cursor >= 0) {
+		if (cursor === ancestorIndex) return true;
+		cursor = segments[cursor].parentIndex;
+	}
+	return false;
+}
+/** 环带颜色：同色系按深度向背景方向混合，外圈大面积不刺眼 */
+function sunburstDepthColor(base, depth, theme) {
+	if (depth <= 0) return base;
+	const darker = !isLightColor(theme.backgroundColor);
+	return mixColor(base, Math.min(darker ? SUNBURST_DARK_MAX : SUNBURST_LIGHT_MAX, depth * (darker ? SUNBURST_DARK_STEP : SUNBURST_LIGHT_STEP)), darker ? "#000000" : "#ffffff");
+}
+function sunburstNodeColor(seg, theme) {
+	const base = seg.node.color || theme.colors[seg.colorIndex % theme.colors.length];
+	if (seg.node.color && seg.depth > 0) return seg.node.color;
+	return sunburstDepthColor(base, seg.depth, theme);
+}
+/** 旭日图几何：渲染与悬浮命中共用一份口径（环厚、留白、半径预算） */
+function computeSunburstGeometry(plotArea, options, theme, valueFormatter) {
 	const data = options.sunburstData || [];
-	if (data.length === 0) return;
+	const depthCount = computeSunburstDepth(data);
+	if (data.length === 0 || depthCount === 0) return null;
 	const centerX = plotArea.x + plotArea.width / 2;
 	const centerY = plotArea.y + plotArea.height / 2;
-	const maxR = Math.max(40, Math.min(plotArea.width, plotArea.height) / 2 - 10);
-	const innerHole = Math.max(0, maxR * .18);
-	const depthCount = computeSunburstDepth(data);
-	const segments = layoutSunburst(data, innerHole, (maxR - innerHole) / depthCount, 0, -Math.PI / 2, 0, []);
+	const maxR = Math.max(40, Math.min(plotArea.width, plotArea.height) / 2 - 20);
+	const innerHole = Math.max(0, maxR * SUNBURST_HOLE_RATIO);
+	const ringWidth = (maxR - innerHole) / depthCount;
+	const segments = layoutSunburst(data, innerHole, ringWidth, 0, -Math.PI / 2, 0, []);
+	segments.forEach((seg) => {
+		seg.color = sunburstNodeColor(seg, theme);
+	});
+	return {
+		centerX,
+		centerY,
+		maxR,
+		innerHole,
+		ringWidth,
+		depthCount,
+		segments,
+		showValues: options.showValues === true,
+		valueFormatter
+	};
+}
+function renderSunburstChart(ctx) {
+	const { ctx: canvasCtx, theme, plotArea, options, progress, hoverIndex, valueFormatter, hoverAnimProgress = 1 } = ctx;
+	const geo = computeSunburstGeometry(plotArea, options, theme, valueFormatter);
+	if (!geo) return;
+	const { centerX, centerY, maxR, ringWidth, depthCount, segments, showValues } = geo;
 	const sweep = -Math.PI / 2 + Math.PI * 2 * progress;
+	const grow = .94 + .06 * progress;
+	const focusIndex = hoverIndex >= 0 && hoverIndex < segments.length ? hoverIndex : -1;
+	const dimAlpha = 1 - .75 * hoverAnimProgress;
+	const alphaAt = (i) => focusIndex < 0 || isSunburstDescendant(segments, i, focusIndex) ? 1 : dimAlpha;
+	const labels = [];
 	canvasCtx.save();
 	canvasCtx.beginPath();
 	canvasCtx.moveTo(centerX, centerY);
@@ -3358,45 +3747,58 @@ function renderSunburstChart(ctx) {
 	canvasCtx.closePath();
 	canvasCtx.clip();
 	segments.forEach((seg, i) => {
-		const color = seg.node.color || theme.colors[seg.colorIndex % theme.colors.length];
-		const isHover = i === hoverIndex;
+		const color = i === focusIndex ? mixColor(seg.color, .08, "#000000") : seg.color;
 		canvasCtx.save();
+		canvasCtx.globalAlpha = alphaAt(i);
 		canvasCtx.beginPath();
-		canvasCtx.arc(centerX, centerY, seg.r1, seg.startAngle, seg.endAngle);
-		canvasCtx.arc(centerX, centerY, seg.r0, seg.endAngle, seg.startAngle, true);
+		canvasCtx.arc(centerX, centerY, seg.r1 * grow, seg.startAngle, seg.endAngle);
+		canvasCtx.arc(centerX, centerY, seg.r0 * grow, seg.endAngle, seg.startAngle, true);
 		canvasCtx.closePath();
-		canvasCtx.fillStyle = isHover ? color : color + (seg.depth === 0 ? "" : "dd");
+		canvasCtx.fillStyle = color;
 		canvasCtx.fill();
 		canvasCtx.strokeStyle = theme.backgroundColor;
 		canvasCtx.lineWidth = 2;
 		canvasCtx.stroke();
-		if (isHover) {
-			canvasCtx.strokeStyle = theme.textColor;
-			canvasCtx.lineWidth = 2;
-			canvasCtx.stroke();
-		}
 		canvasCtx.restore();
+		if (progress <= .9) return;
+		const name = seg.node.name || "";
+		if (!name) return;
 		const span = seg.endAngle - seg.startAngle;
 		const midR = (seg.r0 + seg.r1) / 2;
 		const chord = midR * span;
-		const name = seg.node.name || "";
-		if (progress > .9 && span > .12 && chord > estimateTextWidth(name, 11) + 8 && seg.r1 - seg.r0 > 13) {
-			const lx = centerX + Math.cos(seg.midAngle) * midR;
-			const ly = centerY + Math.sin(seg.midAngle) * midR;
-			canvasCtx.save();
-			canvasCtx.fillStyle = getContrastText(color);
-			canvasCtx.font = seg.depth === 0 ? "bold 12px Inter, sans-serif" : "11px Inter, sans-serif";
-			canvasCtx.textAlign = "center";
-			canvasCtx.textBaseline = "middle";
-			canvasCtx.fillText(name, lx, ly - (options.showValues ? 6 : 0));
-			if (options.showValues && seg.r1 - seg.r0 > 26) {
-				canvasCtx.font = "10px Inter, sans-serif";
-				canvasCtx.fillText(valueFormatter(seg.node.value), lx, ly + 8);
-			}
-			canvasCtx.restore();
-		}
+		if (ringWidth < 12 || chord < 11) return;
+		const value = showValues && ringWidth >= 26 ? valueFormatter(seg.value) : null;
+		if (Math.max(estimateTextWidth(name, 11), value ? estimateTextWidth(value, 10) : 0) > ringWidth + 20) return;
+		labels.push({
+			x: centerX + Math.cos(seg.midAngle) * midR,
+			y: centerY + Math.sin(seg.midAngle) * midR,
+			midAngle: seg.midAngle,
+			name,
+			value,
+			bold: seg.depth === 0,
+			fill: getContrastText(color),
+			alpha: alphaAt(i)
+		});
 	});
 	canvasCtx.restore();
+	labels.forEach((l) => {
+		canvasCtx.save();
+		canvasCtx.globalAlpha = l.alpha;
+		canvasCtx.fillStyle = l.fill;
+		canvasCtx.font = l.bold ? "bold 11px Inter, sans-serif" : "11px Inter, sans-serif";
+		canvasCtx.textAlign = "center";
+		canvasCtx.textBaseline = "middle";
+		canvasCtx.translate(l.x, l.y);
+		let rot = l.midAngle;
+		if (rot > Math.PI / 2 || rot < -Math.PI / 2) rot += Math.PI;
+		canvasCtx.rotate(rot);
+		canvasCtx.fillText(l.name, 0, l.value ? -7 : 0);
+		if (l.value) {
+			canvasCtx.font = "10px Inter, sans-serif";
+			canvasCtx.fillText(l.value, 0, 7);
+		}
+		canvasCtx.restore();
+	});
 }
 function renderMixedChart(ctx, leftRange, rightRange) {
 	const { ctx: canvasCtx, theme, plotArea, options, progress, hoverIndex, hiddenSeries } = ctx;
@@ -3966,6 +4368,13 @@ function createSvgRecorder(real) {
 }
 //#endregion
 //#region src/renderer/index.js
+function runLayers(renderCtx, at) {
+	const layers = renderCtx.options.layers;
+	if (!Array.isArray(layers)) return;
+	layers.forEach((layer) => {
+		if (layer && typeof layer.draw === "function" && (layer.at || "front") === at) layer.draw(renderCtx.ctx, renderCtx);
+	});
+}
 function renderChart(canvas, params) {
 	const { options: rawOptions, ctx: externalCtx, dpr = window.devicePixelRatio || 1, progress = 1, hoverIndex = -1, hiddenSeries = /* @__PURE__ */ new Set(), mouseX = -1, mouseY = -1, showCrosshair = false, hoverAnimProgress = 1, zoomRange, brushRect, focusSeries = null, hoveredToolbox = null } = params;
 	const options = applyLogTransform(rawOptions);
@@ -4003,6 +4412,7 @@ function renderChart(canvas, params) {
 		focusSeries
 	};
 	renderTitle(renderCtx, options.subtitle ? 12 : 15);
+	runLayers(renderCtx, "back");
 	let points = [];
 	let leftRange;
 	switch (options.type) {
@@ -4146,7 +4556,8 @@ function renderChart(canvas, params) {
 			break;
 		}
 	}
-	if (leftRange && options.annotation) renderAnnotations(renderCtx, leftRange);
+	runLayers(renderCtx, "after-series");
+	if (leftRange && (options.annotation || options.annotations && options.annotations.length > 0)) renderAnnotations(renderCtx, leftRange);
 	if ((options.type === "line" || options.type === "area") && points.length > 0) renderHoverHighlight(renderCtx, points);
 	if (points.length > 0) renderCrosshair(renderCtx, points);
 	if (zoomRange) renderDataZoomSlider(renderCtx, zoomRange);
@@ -4164,6 +4575,7 @@ function renderChart(canvas, params) {
 		ctx.strokeRect(x, y, w, h);
 		ctx.restore();
 	}
+	runLayers(renderCtx, "front");
 	if (options.type !== "sparkline") renderLegend(renderCtx);
 	if (options.type !== "sparkline") renderToolbox(renderCtx, hoveredToolbox);
 	ctx.restore();
@@ -4191,6 +4603,376 @@ function broadcastConnect(group, source, apply) {
 		if (target !== source) apply(target);
 	});
 }
+var chartOptionsSchema = {
+	$schema: "http://json-schema.org/draft-07/schema#",
+	title: "EvChart Options",
+	type: "object",
+	required: ["type"],
+	properties: {
+		type: {
+			type: "string",
+			enum: [
+				"line",
+				"area",
+				"bar",
+				"stacked-bar",
+				"horizontal-bar",
+				"pie",
+				"doughnut",
+				"rose",
+				"radar",
+				"scatter",
+				"funnel",
+				"gauge",
+				"heatmap",
+				"candle",
+				"bin",
+				"bullet",
+				"treemap",
+				"sparkline",
+				"waterfall",
+				"boxplot",
+				"sunburst",
+				"mixed"
+			]
+		},
+		title: { type: "string" },
+		subtitle: { type: "string" },
+		labels: { type: "array" },
+		series: {
+			type: "array",
+			items: {
+				type: "object",
+				required: ["name", "data"],
+				properties: {
+					name: { type: "string" },
+					data: { type: "array" },
+					color: { type: "string" },
+					showSymbol: { type: "boolean" },
+					lineWidth: { type: "number" },
+					smooth: { type: "boolean" },
+					yAxis: {
+						type: "string",
+						enum: ["left", "right"]
+					},
+					type: { type: "string" },
+					chartType: {
+						type: "string",
+						enum: ["bar", "line"]
+					},
+					area: { type: "boolean" }
+				}
+			}
+		},
+		legend: {
+			type: "object",
+			properties: {
+				show: { type: "boolean" },
+				position: {
+					type: "string",
+					enum: ["top", "bottom"]
+				},
+				interactive: { type: "boolean" },
+				hoverEmphasis: { type: "boolean" }
+			}
+		},
+		tooltip: {
+			type: "object",
+			properties: {
+				show: { type: "boolean" },
+				trigger: {
+					type: "string",
+					enum: ["hover", "click"]
+				},
+				showAllSeries: { type: "boolean" },
+				formatter: { type: "function" }
+			}
+		},
+		animation: {
+			type: "object",
+			properties: {
+				enabled: { type: "boolean" },
+				duration: { type: "number" },
+				easing: { type: "string" }
+			}
+		},
+		xAxis: {
+			type: "object",
+			properties: {
+				show: { type: "boolean" },
+				min: { type: "number" },
+				max: { type: "number" },
+				ticks: { type: "integer" },
+				grid: {
+					type: "object",
+					properties: {
+						show: { type: "boolean" },
+						style: {
+							type: "string",
+							enum: ["solid", "dashed"]
+						}
+					}
+				}
+			}
+		},
+		yAxis: {
+			type: "object",
+			properties: {
+				show: { type: "boolean" },
+				min: { type: "number" },
+				max: { type: "number" },
+				ticks: { type: "integer" },
+				width: { type: "number" },
+				grid: {
+					type: "object",
+					properties: {
+						show: { type: "boolean" },
+						style: {
+							type: "string",
+							enum: ["solid", "dashed"]
+						}
+					}
+				}
+			}
+		},
+		yAxisRight: { $ref: "#/properties/yAxis" },
+		padding: { oneOf: [{ type: "number" }, {
+			type: "object",
+			properties: {
+				top: { type: "number" },
+				right: { type: "number" },
+				bottom: { type: "number" },
+				left: { type: "number" }
+			}
+		}] },
+		dataZoom: {
+			type: "object",
+			properties: {
+				enabled: { type: "boolean" },
+				start: { type: "number" },
+				end: { type: "number" },
+				position: {
+					type: "string",
+					enum: ["bottom", "top"]
+				},
+				height: { type: "number" },
+				mouseWheel: { type: "boolean" }
+			}
+		},
+		toolbox: {
+			type: "object",
+			properties: {
+				show: { type: "boolean" },
+				filename: { type: "string" }
+			}
+		},
+		theme: { type: "object" },
+		layers: {
+			type: "array",
+			items: {
+				type: "object",
+				properties: {
+					at: {
+						type: "string",
+						enum: [
+							"back",
+							"after-series",
+							"front"
+						]
+					},
+					draw: { type: "function" }
+				}
+			}
+		},
+		emphasis: {
+			type: "object",
+			properties: {
+				series: { oneOf: [{ type: "string" }, { type: "integer" }] },
+				dimOthers: { type: "boolean" }
+			}
+		},
+		annotations: {
+			type: "array",
+			items: {
+				type: "object",
+				oneOf: [{
+					required: [
+						"type",
+						"x",
+						"y"
+					],
+					properties: { type: { enum: [
+						"text",
+						"callout",
+						"delta",
+						"point"
+					] } }
+				}, {
+					required: [
+						"type",
+						"from",
+						"to"
+					],
+					properties: { type: { enum: ["region"] } }
+				}],
+				properties: {
+					type: {
+						type: "string",
+						enum: [
+							"text",
+							"callout",
+							"region",
+							"delta",
+							"point"
+						]
+					},
+					x: {},
+					y: { type: "number" },
+					from: {},
+					to: {},
+					at: {},
+					label: { type: "string" },
+					text: { type: "string" },
+					anchor: {
+						type: "string",
+						enum: [
+							"top",
+							"bottom",
+							"left",
+							"right",
+							"top-left",
+							"top-right",
+							"bottom-left",
+							"bottom-right"
+						]
+					},
+					color: { type: "string" },
+					offsetX: { type: "number" },
+					offsetY: { type: "number" },
+					xPx: { type: "number" },
+					yPx: { type: "number" }
+				}
+			}
+		},
+		annotation: { type: "object" },
+		markLine: { type: "array" },
+		markArea: { type: "array" },
+		scenes: {
+			type: "object",
+			properties: {
+				autoplay: { type: "boolean" },
+				loop: { type: "boolean" },
+				items: {
+					type: "array",
+					items: {
+						type: "object",
+						required: ["patch"],
+						properties: {
+							patch: { type: "object" },
+							duration: { type: "number" },
+							hold: { type: "number" }
+						}
+					}
+				}
+			}
+		},
+		pieData: { type: "array" },
+		radarSeries: { type: "array" },
+		radarIndicators: { type: "array" },
+		scatterData: { type: "array" },
+		funnelData: { type: "array" },
+		gauge: { oneOf: [{ type: "number" }, { type: "object" }] },
+		heatmapData: { type: "array" },
+		candleData: { type: "array" },
+		bulletData: { type: "array" },
+		boxData: { type: "array" },
+		loading: { type: "boolean" },
+		emptyText: { type: "string" },
+		ariaLabel: { type: "string" },
+		i18n: { type: "object" },
+		connectGroup: { type: "string" },
+		brush: {
+			type: "object",
+			properties: { enabled: { type: "boolean" } }
+		},
+		logAxis: { type: "boolean" },
+		valueFormatter: { type: "function" },
+		timeAxis: { type: "boolean" }
+	}
+};
+var TYPE_CHECKS = {
+	string: (v) => typeof v === "string",
+	number: (v) => typeof v === "number" && Number.isFinite(v),
+	integer: (v) => typeof v === "number" && Number.isInteger(v),
+	boolean: (v) => typeof v === "boolean",
+	object: (v) => v !== null && typeof v === "object" && !Array.isArray(v),
+	array: (v) => Array.isArray(v),
+	function: (v) => typeof v === "function"
+};
+function typeMatches(node, value) {
+	if (Array.isArray(node.type)) return node.type.some((t) => TYPE_CHECKS[t]?.(value));
+	const check = TYPE_CHECKS[node.type];
+	return check ? check(value) : true;
+}
+function validateNode(node, value, path, warnings) {
+	if (node == null || value === void 0 || value === null) return;
+	if (node.oneOf) {
+		if (!node.oneOf.some((branch) => {
+			const before = warnings.length;
+			validateNode(branch, value, path, warnings);
+			const ok = warnings.length === before;
+			warnings.length = before;
+			return ok;
+		})) {
+			warnings.push({
+				path,
+				message: "类型不匹配（应为 oneOf 之一）"
+			});
+			return;
+		}
+	}
+	if (node.type && !typeMatches(node, value)) {
+		warnings.push({
+			path,
+			message: `应为 ${node.type}，实际为 ${Array.isArray(value) ? "array" : typeof value}`
+		});
+		return;
+	}
+	if (node.enum && !node.enum.includes(value)) {
+		warnings.push({
+			path,
+			message: `应为 ${node.enum.join(" / ")} 之一，实际为 ${String(value)}`
+		});
+		return;
+	}
+	if (node.type === "object") {
+		(node.required || []).forEach((key) => {
+			if (value[key] === void 0) warnings.push({
+				path: `${path}.${key}`,
+				message: "缺少必填字段"
+			});
+		});
+		if (node.properties) Object.entries(node.properties).forEach(([key, sub]) => {
+			if (value[key] !== void 0) validateNode(sub, value[key], `${path}.${key}`, warnings);
+		});
+	}
+	if (node.type === "array" && node.items && Array.isArray(value)) value.forEach((item, i) => validateNode(node.items, item, `${path}[${i}]`, warnings));
+}
+function validateOptions(options) {
+	const warnings = [];
+	if (options === null || typeof options !== "object" || Array.isArray(options)) return {
+		ok: false,
+		warnings: [{
+			path: "options",
+			message: "应为对象"
+		}]
+	};
+	validateNode(chartOptionsSchema, options, "options", warnings);
+	return {
+		ok: warnings.length === 0,
+		warnings
+	};
+}
 //#endregion
 //#region \0plugin-vue:export-helper
 var _plugin_vue_export_helper_default = (sfc, props) => {
@@ -4202,23 +4984,27 @@ var _plugin_vue_export_helper_default = (sfc, props) => {
 //#region src/chart.vue
 var _hoisted_1 = ["aria-label"];
 var _hoisted_2 = {
+	key: 1,
+	class: "ev-chart__overlay"
+};
+var _hoisted_3 = {
 	key: 0,
 	class: "ev-chart__empty"
 };
-var _hoisted_3 = { class: "ev-chart__empty-icon-wrap" };
-var _hoisted_4 = { class: "ev-chart__empty-text" };
-var _hoisted_5 = {
+var _hoisted_4 = { class: "ev-chart__empty-icon-wrap" };
+var _hoisted_5 = { class: "ev-chart__empty-text" };
+var _hoisted_6 = {
 	key: 0,
 	class: "ev-chart__loading"
 };
-var _hoisted_6 = { class: "ev-chart__loading-bars" };
-var _hoisted_7 = {
+var _hoisted_7 = { class: "ev-chart__loading-bars" };
+var _hoisted_8 = {
 	key: 0,
 	class: "ev-chart__error"
 };
-var _hoisted_8 = { class: "ev-chart__error-text" };
-var _hoisted_9 = ["innerHTML"];
-var _hoisted_10 = {
+var _hoisted_9 = { class: "ev-chart__error-text" };
+var _hoisted_10 = ["innerHTML"];
+var _hoisted_11 = {
 	class: "ev-chart__sr-only",
 	role: "status",
 	"aria-live": "polite"
@@ -4256,7 +5042,8 @@ var chart_default = /*#__PURE__*/ _plugin_vue_export_helper_default(/* @__PURE__
 		"animation-end",
 		"data-update",
 		"brush-select",
-		"zoom"
+		"zoom",
+		"scene-change"
 	],
 	setup(__props, { expose: __expose, emit: __emit }) {
 		const DataLine = () => h("svg", {
@@ -4326,6 +5113,12 @@ var chart_default = /*#__PURE__*/ _plugin_vue_export_helper_default(/* @__PURE__
 		let hoverAnimFrameId = null;
 		const hiddenSeries = ref(/* @__PURE__ */ new Set());
 		const focusSeries = ref(null);
+		const emphasisSeriesName = computed(() => {
+			const em = props.options.emphasis;
+			if (!em || em.series === void 0 || em.dimOthers === false) return null;
+			if (typeof em.series === "number") return props.options.series?.[em.series]?.name ?? null;
+			return em.series || null;
+		});
 		const hoveredToolbox = ref(null);
 		let mouseX = -1;
 		let mouseY = -1;
@@ -4355,33 +5148,102 @@ var chart_default = /*#__PURE__*/ _plugin_vue_export_helper_default(/* @__PURE__
 		const brushRect = ref(null);
 		let suppressClick = false;
 		let brushDragged = false;
+		const specVersion = ref(0);
+		const overlayInfo = ref({
+			plotArea: {
+				x: 0,
+				y: 0,
+				width: 0,
+				height: 0
+			},
+			theme: getTheme(false, void 0),
+			options: null
+		});
 		const effectiveOptions = computed(() => {
+			specVersion.value;
 			const opt = props.options;
-			if (!getDataZoomConfig(opt)) return opt;
+			const scene = opt.scenes?.items?.[sceneIndex.value];
+			const base = scene?.patch ? {
+				...opt,
+				...scene.patch
+			} : opt;
+			if (!getDataZoomConfig(base)) return base;
 			const range = zoomRange.value;
-			if (range.start <= 0 && range.end >= 100) return opt;
-			const sliced = { ...opt };
-			const n = (opt.labels || []).length;
+			if (range.start <= 0 && range.end >= 100) return base;
+			const sliced = { ...base };
+			const n = (base.labels || []).length;
 			if (n > 0) {
 				const { startIdx, endIdx } = zoomToSlice(range, n);
-				sliced.labels = (opt.labels || []).slice(startIdx, endIdx);
-				if (opt.series) sliced.series = opt.series.map((s) => ({
+				sliced.labels = (base.labels || []).slice(startIdx, endIdx);
+				if (base.series) sliced.series = base.series.map((s) => ({
 					...s,
 					data: s.data.slice(startIdx, endIdx)
 				}));
-				if (opt.candleData) sliced.candleData = opt.candleData.slice(startIdx, endIdx);
+				if (base.candleData) sliced.candleData = base.candleData.slice(startIdx, endIdx);
 				sliced.__sliceStart = startIdx;
-			} else if (opt.scatterData && opt.scatterData.length > 0) {
-				const xs = opt.scatterData.map((d) => d.x);
+			} else if (base.scatterData && base.scatterData.length > 0) {
+				const xs = base.scatterData.map((d) => d.x);
 				const xMin = Math.min(...xs);
 				const span = Math.max(...xs) - xMin || 1;
 				const lo = xMin + range.start / 100 * span;
 				const hi = xMin + range.end / 100 * span;
-				const filtered = opt.scatterData.filter((d) => d.x >= lo && d.x <= hi);
-				sliced.scatterData = filtered.length > 0 ? filtered : opt.scatterData;
+				const filtered = base.scatterData.filter((d) => d.x >= lo && d.x <= hi);
+				sliced.scatterData = filtered.length > 0 ? filtered : base.scatterData;
 			}
 			return sliced;
 		});
+		const sceneIndex = ref(0);
+		let sceneTimer = null;
+		let sceneAnimOverride = null;
+		function stopSceneTimer() {
+			if (sceneTimer !== null) {
+				clearTimeout(sceneTimer);
+				sceneTimer = null;
+			}
+		}
+		function applyScene(i, opts = {}) {
+			const items = props.options.scenes?.items || [];
+			if (items.length === 0) return;
+			const next = Math.max(0, Math.min(i, items.length - 1));
+			if (next === sceneIndex.value && !opts.force) return;
+			sceneIndex.value = next;
+			const item = items[next];
+			sceneAnimOverride = item?.duration ? {
+				...props.options.animation || {},
+				duration: item.duration
+			} : null;
+			emit("scene-change", {
+				index: next,
+				total: items.length
+			});
+			render(true, sceneAnimOverride);
+			scheduleSceneAdvance();
+		}
+		function scheduleSceneAdvance() {
+			stopSceneTimer();
+			const scenes = props.options.scenes;
+			if (!scenes?.autoplay) return;
+			const item = scenes.items?.[sceneIndex.value];
+			if (!item) return;
+			const wait = Math.max(0, (item.duration ?? 1200) + (item.hold ?? 0));
+			sceneTimer = setTimeout(() => {
+				const total = props.options.scenes?.items?.length ?? 0;
+				if (total === 0) return;
+				if (sceneIndex.value >= total - 1) {
+					if (props.options.scenes?.loop) applyScene(0, { force: true });
+				} else applyScene(sceneIndex.value + 1);
+			}, wait);
+		}
+		function syncScenes() {
+			const total = props.options.scenes?.items?.length ?? 0;
+			if (total === 0) {
+				stopSceneTimer();
+				if (sceneIndex.value !== 0) sceneIndex.value = 0;
+				return;
+			}
+			if (sceneIndex.value >= total) sceneIndex.value = 0;
+			scheduleSceneAdvance();
+		}
 		function sliceStartOffset() {
 			return effectiveOptions.value.__sliceStart || 0;
 		}
@@ -4427,17 +5289,24 @@ var chart_default = /*#__PURE__*/ _plugin_vue_export_helper_default(/* @__PURE__
 			const spaceBelow = containerRect.height - relY - gap;
 			const spaceAbove = relY - gap - legendBottom;
 			let top;
-			if (spaceBelow >= th) top = relY + gap;
-			else if (spaceAbove >= th) top = relY - gap - th;
-			else top = spaceBelow >= spaceAbove ? containerRect.height - th - margin : legendBottom;
+			if (th + 4 <= containerRect.height) {
+				if (spaceBelow >= th) top = relY + gap;
+				else if (spaceAbove >= th) top = relY - gap - th;
+				else top = spaceBelow >= spaceAbove ? containerRect.height - th - margin : legendBottom;
+				top = Math.max(legendBottom, Math.min(top, containerRect.height - th - margin));
+			} else {
+				const pointViewportY = containerRect.top + relY;
+				const belowInViewport = pointViewportY + gap + th <= window.innerHeight - 8;
+				const aboveInViewport = pointViewportY - gap - th >= 8;
+				top = belowInViewport || !aboveInViewport ? relY + gap : relY - gap - th;
+			}
 			left = Math.max(margin, Math.min(left, containerRect.width - tw - margin));
-			top = Math.max(legendBottom, Math.min(top, containerRect.height - th - margin));
 			tooltipPlacement.value = "top";
 			tooltipX.value = left;
 			tooltipY.value = top;
 		}
 		const canvasStyle = computed(() => ({ cursor: hoverIndex >= 0 ? "pointer" : "default" }));
-		function render(animate = true) {
+		function render(animate = true, animOverride = null) {
 			const canvas = canvasRef.value;
 			if (!canvas) return;
 			const container = containerRef.value;
@@ -4480,8 +5349,20 @@ var chart_default = /*#__PURE__*/ _plugin_vue_export_helper_default(/* @__PURE__
 				lastHeight = height;
 				canvas.width = width * dpr.value;
 				canvas.height = height * dpr.value;
-				const animEnabled = animate && props.options.animation?.enabled !== false;
-				animationState = createAnimation(props.options.animation);
+				const overlayPadding = getPadding(effectiveOptions.value, width);
+				overlayInfo.value = {
+					plotArea: {
+						x: overlayPadding.left,
+						y: overlayPadding.top,
+						width: width - overlayPadding.left - overlayPadding.right,
+						height: height - overlayPadding.top - overlayPadding.bottom
+					},
+					theme: getTheme(document.documentElement.classList.contains("dark"), effectiveOptions.value.theme),
+					options: props.options
+				};
+				const animCfg = animOverride || props.options.animation;
+				const animEnabled = animate && animCfg?.enabled !== false;
+				animationState = createAnimation(animCfg);
 				animationState.isAnimating = animEnabled;
 				if (animEnabled) {
 					isEnterAnimating = true;
@@ -4633,9 +5514,24 @@ var chart_default = /*#__PURE__*/ _plugin_vue_export_helper_default(/* @__PURE__
 				hoverAnimFrameId = null;
 			}
 		}
-		function startHoverAnimation(dir) {
+		function usesHoverAnimation() {
 			const t = props.options.type;
-			if (t !== "pie" && t !== "doughnut" && t !== "rose") return;
+			return t === "pie" || t === "doughnut" || t === "rose" || t === "sunburst" || t === "treemap";
+		}
+		function clearHover() {
+			if (hoverIndex === -1) return false;
+			hoverIndex = -1;
+			const t = props.options.type;
+			if (t === "pie" || t === "doughnut" || t === "rose") startHoverAnimation(-1);
+			else {
+				stopHoverAnimation();
+				hoverAnimProgress = 0;
+				redraw();
+			}
+			return true;
+		}
+		function startHoverAnimation(dir) {
+			if (!usesHoverAnimation()) return;
 			if (props.options.animation?.enabled === false) {
 				hoverAnimProgress = dir > 0 ? 1 : 0;
 				redraw();
@@ -4676,7 +5572,8 @@ var chart_default = /*#__PURE__*/ _plugin_vue_export_helper_default(/* @__PURE__
 			"doughnut",
 			"rose",
 			"radar",
-			"funnel"
+			"funnel",
+			"scatter"
 		];
 		function checkLegendHit(x, y) {
 			const canvas = canvasRef.value;
@@ -4869,20 +5766,14 @@ var chart_default = /*#__PURE__*/ _plugin_vue_export_helper_default(/* @__PURE__
 				};
 			}
 			if (options.type === "sunburst") {
-				const data = options.sunburstData || [];
-				if (data.length === 0) return null;
-				const centerX = plotArea.x + plotArea.width / 2;
-				const centerY = plotArea.y + plotArea.height / 2;
-				const maxR = Math.max(40, Math.min(plotArea.width, plotArea.height) / 2 - 10);
-				const innerHole = Math.max(0, maxR * .18);
-				const depthCount = computeSunburstDepth(data);
-				const ringWidth = (maxR - innerHole) / depthCount;
+				const geo = computeSunburstGeometry(plotArea, options, theme, formatTooltipValue);
+				if (!geo) return null;
+				const { centerX, centerY, segments } = geo;
 				const dx = canvasX - centerX;
 				const dy = canvasY - centerY;
 				const distance = Math.sqrt(dx * dx + dy * dy);
 				let hoverAngle = Math.atan2(dy, dx);
 				if (hoverAngle < -Math.PI / 2) hoverAngle += Math.PI * 2;
-				const segments = layoutSunburst(data, innerHole, ringWidth, 0, -Math.PI / 2, 0, []);
 				for (let i = 0; i < segments.length; i++) {
 					const seg = segments[i];
 					if (distance >= seg.r0 && distance <= seg.r1 && hoverAngle >= seg.startAngle && hoverAngle < seg.endAngle) return {
@@ -4890,8 +5781,8 @@ var chart_default = /*#__PURE__*/ _plugin_vue_export_helper_default(/* @__PURE__
 						params: {
 							seriesName: seg.node.name,
 							name: seg.node.name,
-							value: seg.node.value,
-							color: seg.node.color || theme.colors[seg.colorIndex % theme.colors.length],
+							value: sunburstValue(seg.node),
+							color: seg.color,
 							dataIndex: i,
 							seriesIndex: 0
 						}
@@ -5502,18 +6393,15 @@ var chart_default = /*#__PURE__*/ _plugin_vue_export_helper_default(/* @__PURE__
 				redraw();
 			}
 			const legendName = checkLegendHit(e.clientX, e.clientY);
-			const nextFocus = props.options.legend?.hoverEmphasis !== false && legendName ? legendName : null;
-			if (nextFocus !== focusSeries.value) {
-				focusSeries.value = nextFocus;
-				redraw();
+			if (emphasisSeriesName.value) {} else {
+				const nextFocus = props.options.legend?.hoverEmphasis !== false && legendName ? legendName : null;
+				if (nextFocus !== focusSeries.value) {
+					focusSeries.value = nextFocus;
+					redraw();
+				}
 			}
 			if (legendName) {
-				if (hoverIndex !== -1) {
-					hoverIndex = -1;
-					const t = props.options.type;
-					if (t === "pie" || t === "doughnut" || t === "rose") startHoverAnimation(-1);
-					else redraw();
-				}
+				clearHover();
 				tooltipVisible.value = false;
 				return;
 			}
@@ -5532,6 +6420,10 @@ var chart_default = /*#__PURE__*/ _plugin_vue_export_helper_default(/* @__PURE__
 							hoverAnimProgress = .35;
 							startHoverAnimation(1);
 						}
+					} else if (usesHoverAnimation()) {
+						stopHoverAnimation();
+						hoverAnimProgress = 1;
+						redraw();
 					} else redraw();
 					if (prevIndex === -1) {
 						const emitParams = Array.isArray(result.params) ? result.params[0] : result.params;
@@ -5556,10 +6448,7 @@ var chart_default = /*#__PURE__*/ _plugin_vue_export_helper_default(/* @__PURE__
 				});
 				tooltipVisible.value = true;
 			} else {
-				if (hoverIndex !== -1) {
-					hoverIndex = -1;
-					if (isPieLike) startHoverAnimation(-1);
-					else redraw();
+				if (clearHover()) {
 					emit("unhover");
 					ariaLiveText.value = "";
 				}
@@ -5634,18 +6523,14 @@ var chart_default = /*#__PURE__*/ _plugin_vue_export_helper_default(/* @__PURE__
 			tooltipVisible.value = false;
 			mouseX = -1;
 			mouseY = -1;
-			if (focusSeries.value !== null) focusSeries.value = null;
+			if (focusSeries.value !== null && !emphasisSeriesName.value) focusSeries.value = null;
 			if (hoveredToolbox.value !== null) hoveredToolbox.value = null;
 			if (dragMode === "brush") {
 				brushRect.value = null;
 				redraw();
 			}
 			dragMode = "none";
-			if (hoverIndex !== -1) {
-				hoverIndex = -1;
-				const t = props.options.type;
-				if (t === "pie" || t === "doughnut" || t === "rose") startHoverAnimation(-1);
-				else redraw();
+			if (clearHover()) {
 				emit("unhover");
 				ariaLiveText.value = "";
 			}
@@ -5701,11 +6586,35 @@ var chart_default = /*#__PURE__*/ _plugin_vue_export_helper_default(/* @__PURE__
 				}))
 			};
 		}
+		function cloneSpec(value) {
+			if (value === null || typeof value !== "object") return value;
+			if (Array.isArray(value)) return value.map(cloneSpec);
+			const out = {};
+			Object.keys(value).forEach((k) => {
+				out[k] = cloneSpec(value[k]);
+			});
+			return out;
+		}
+		const IS_DEV = typeof import.meta !== "undefined" && false;
+		const devWarned = /* @__PURE__ */ new Set();
+		function runDevValidation() {
+			if (!IS_DEV) return;
+			const { warnings } = validateOptions(props.options);
+			warnings.slice(0, 8).forEach((w) => {
+				const key = `${w.path}:${w.message}`;
+				if (devWarned.has(key)) return;
+				devWarned.add(key);
+				console.warn(`[EvChart] ${w.path} ${w.message}`);
+			});
+		}
 		let prevOptionsSnapshot = null;
 		watch(() => props.options, (next) => {
 			cachedDataExtent = null;
 			cachedPlotArea = null;
 			internalError.value = null;
+			runDevValidation();
+			focusSeries.value = emphasisSeriesName.value;
+			syncScenes();
 			const zoom = getDataZoomConfig(props.options);
 			const zoomKey = zoom ? JSON.stringify({
 				e: zoom.enabled,
@@ -5759,6 +6668,7 @@ var chart_default = /*#__PURE__*/ _plugin_vue_export_helper_default(/* @__PURE__
 		let unregisterConnector = null;
 		onMounted(() => {
 			render(true);
+			syncScenes();
 			setupResizeObserver();
 			setupDarkModeObserver();
 			window.addEventListener("pointerup", onWindowPointerUp);
@@ -5778,6 +6688,7 @@ var chart_default = /*#__PURE__*/ _plugin_vue_export_helper_default(/* @__PURE__
 			stopAnimation();
 			stopHoverAnimation();
 			stopTweenAnimation();
+			stopSceneTimer();
 			if (tooltipRafId !== null) {
 				cancelAnimationFrame(tooltipRafId);
 				tooltipRafId = null;
@@ -5791,6 +6702,7 @@ var chart_default = /*#__PURE__*/ _plugin_vue_export_helper_default(/* @__PURE__
 			update(newOptions) {
 				Object.assign(props.options, newOptions);
 				cachedDataExtent = null;
+				specVersion.value++;
 				debouncedRender(true);
 			},
 			toDataURL(type = "image/png", quality = 1) {
@@ -5801,6 +6713,7 @@ var chart_default = /*#__PURE__*/ _plugin_vue_export_helper_default(/* @__PURE__
 				cleanupDarkModeObserver();
 				stopAnimation();
 				stopHoverAnimation();
+				stopSceneTimer();
 				if (tooltipRafId !== null) {
 					cancelAnimationFrame(tooltipRafId);
 					tooltipRafId = null;
@@ -5890,6 +6803,7 @@ var chart_default = /*#__PURE__*/ _plugin_vue_export_helper_default(/* @__PURE__
 					...props.options.theme,
 					...theme
 				};
+				specVersion.value++;
 				redraw();
 			},
 			exportSVG(options = {}) {
@@ -5932,6 +6846,59 @@ var chart_default = /*#__PURE__*/ _plugin_vue_export_helper_default(/* @__PURE__
 			getOption() {
 				return props.options;
 			},
+			getSpec() {
+				return cloneSpec(props.options);
+			},
+			setSpec(spec) {
+				if (spec === null || typeof spec !== "object") return;
+				const next = cloneSpec(spec);
+				Object.keys(props.options).forEach((k) => delete props.options[k]);
+				Object.assign(props.options, next);
+				hiddenSeries.value = /* @__PURE__ */ new Set();
+				focusSeries.value = null;
+				brushRect.value = null;
+				hoverIndex = -1;
+				mouseX = -1;
+				mouseY = -1;
+				stopSceneTimer();
+				sceneIndex.value = 0;
+				sceneAnimOverride = null;
+				const zoom = getDataZoomConfig(next);
+				zoomRange.value = {
+					start: zoom?.start ?? 0,
+					end: zoom?.end ?? 100
+				};
+				lastZoomKey = zoom ? JSON.stringify({
+					e: zoom.enabled,
+					s: zoom.start,
+					e2: zoom.end,
+					p: zoom.position,
+					h: zoom.height
+				}) : "";
+				cachedDataExtent = null;
+				cachedPlotArea = null;
+				specVersion.value++;
+				debouncedRender(true);
+			},
+			nextScene() {
+				applyScene(sceneIndex.value + 1);
+			},
+			prevScene() {
+				applyScene(sceneIndex.value - 1);
+			},
+			gotoScene(i) {
+				applyScene(i);
+			},
+			getSceneIndex() {
+				return sceneIndex.value;
+			},
+			getEffectiveSpec() {
+				const spec = cloneSpec(effectiveOptions.value);
+				Object.keys(spec).forEach((k) => {
+					if (k.startsWith("__")) delete spec[k];
+				});
+				return spec;
+			},
 			setDataZoomRange(start, end) {
 				if (!isZoomEnabled()) {
 					console.warn("[EvChart] setDataZoomRange: dataZoom is not enabled");
@@ -5969,12 +6936,17 @@ var chart_default = /*#__PURE__*/ _plugin_vue_export_helper_default(/* @__PURE__
 					onDblclick: handleDblClick,
 					onPointerleave: handlePointerLeave
 				}, null, 36)) : createCommentVNode("", true),
+				!isEmpty.value && !props.options.loading && !internalError.value && _ctx.$slots.overlay ? (openBlock(), createElementBlock("div", _hoisted_2, [renderSlot(_ctx.$slots, "overlay", {
+					plotArea: overlayInfo.value.plotArea,
+					theme: overlayInfo.value.theme,
+					options: props.options
+				}, void 0, true)])) : createCommentVNode("", true),
 				createVNode(Transition, { name: "ev-chart-fade" }, {
-					default: withCtx(() => [isEmpty.value && !props.options.loading && !internalError.value ? (openBlock(), createElementBlock("div", _hoisted_2, [createElementVNode("div", _hoisted_3, [(openBlock(), createBlock(resolveDynamicComponent(DataLine), { class: "ev-chart__empty-img" }))]), createElementVNode("span", _hoisted_4, toDisplayString(emptyTextI18n.value), 1)])) : createCommentVNode("", true)]),
+					default: withCtx(() => [isEmpty.value && !props.options.loading && !internalError.value ? (openBlock(), createElementBlock("div", _hoisted_3, [createElementVNode("div", _hoisted_4, [(openBlock(), createBlock(resolveDynamicComponent(DataLine), { class: "ev-chart__empty-img" }))]), createElementVNode("span", _hoisted_5, toDisplayString(emptyTextI18n.value), 1)])) : createCommentVNode("", true)]),
 					_: 1
 				}),
 				createVNode(Transition, { name: "ev-chart-fade" }, {
-					default: withCtx(() => [props.options.loading && !internalError.value ? (openBlock(), createElementBlock("div", _hoisted_5, [createElementVNode("div", _hoisted_6, [(openBlock(), createElementBlock(Fragment, null, renderList(6, (i) => {
+					default: withCtx(() => [props.options.loading && !internalError.value ? (openBlock(), createElementBlock("div", _hoisted_6, [createElementVNode("div", _hoisted_7, [(openBlock(), createElementBlock(Fragment, null, renderList(6, (i) => {
 						return createElementVNode("div", {
 							key: i,
 							class: "ev-chart__loading-bar",
@@ -5984,7 +6956,7 @@ var chart_default = /*#__PURE__*/ _plugin_vue_export_helper_default(/* @__PURE__
 					_: 1
 				}),
 				createVNode(Transition, { name: "ev-chart-fade" }, {
-					default: withCtx(() => [internalError.value ? (openBlock(), createElementBlock("div", _hoisted_7, [_cache[0] || (_cache[0] = createElementVNode("span", { class: "ev-chart__error-icon" }, [createElementVNode("svg", {
+					default: withCtx(() => [internalError.value ? (openBlock(), createElementBlock("div", _hoisted_8, [_cache[0] || (_cache[0] = createElementVNode("span", { class: "ev-chart__error-icon" }, [createElementVNode("svg", {
 						viewBox: "0 0 24 24",
 						width: "1em",
 						height: "1em",
@@ -6012,7 +6984,7 @@ var chart_default = /*#__PURE__*/ _plugin_vue_export_helper_default(/* @__PURE__
 							x2: "12",
 							y2: "16.51"
 						})
-					])], -1)), createElementVNode("span", _hoisted_8, toDisplayString(internalError.value), 1)])) : createCommentVNode("", true)]),
+					])], -1)), createElementVNode("span", _hoisted_9, toDisplayString(internalError.value), 1)])) : createCommentVNode("", true)]),
 					_: 1
 				}),
 				createVNode(Transition, { name: "ev-chart-tooltip" }, {
@@ -6024,14 +6996,14 @@ var chart_default = /*#__PURE__*/ _plugin_vue_export_helper_default(/* @__PURE__
 						style: normalizeStyle(tooltipStyle.value),
 						role: "tooltip",
 						innerHTML: tooltipContent.value
-					}, null, 14, _hoisted_9)) : createCommentVNode("", true)]),
+					}, null, 14, _hoisted_10)) : createCommentVNode("", true)]),
 					_: 1
 				}),
-				createElementVNode("div", _hoisted_10, toDisplayString(ariaLiveText.value), 1)
+				createElementVNode("div", _hoisted_11, toDisplayString(ariaLiveText.value), 1)
 			], 12, _hoisted_1);
 		};
 	}
-}), [["__scopeId", "data-v-a07b68e8"]]);
+}), [["__scopeId", "data-v-0c5d944e"]]);
 //#endregion
 //#region src/useChart.js
 var USE_CHART_KEY = /* @__PURE__ */ Symbol("ev-chart-context");
@@ -6184,6 +7156,742 @@ function clearSeriesPalette(options = {}) {
 	return true;
 }
 //#endregion
+//#region src/ai/table.js
+var NUM_CLEAN = /[,\s_]/g;
+function parseNumeric(raw) {
+	if (typeof raw === "number") return Number.isFinite(raw) ? raw : null;
+	if (typeof raw !== "string") return null;
+	let s = raw.trim();
+	if (!s) return null;
+	let sign = 1;
+	if (/^\(.*\)$/.test(s)) {
+		sign = -1;
+		s = s.slice(1, -1);
+	}
+	s = s.replace(NUM_CLEAN, "").replace(/^[￥$€£]/, "").replace(/[￥$€£]$/, "");
+	let mult = 1;
+	if (/亿$/.test(s)) {
+		mult = 1e8;
+		s = s.slice(0, -1);
+	} else if (/万$/.test(s)) {
+		mult = 1e4;
+		s = s.slice(0, -1);
+	} else if (/[Kk]$/.test(s)) {
+		mult = 1e3;
+		s = s.slice(0, -1);
+	}
+	if (/%$/.test(s)) s = s.slice(0, -1);
+	if (!/^[-+]?\d+(\.\d+)?$/.test(s)) return null;
+	return sign * parseFloat(s) * mult;
+}
+function looksLikeTime(v) {
+	if (typeof v !== "string") return false;
+	const s = v.trim();
+	if (/^\d{4}[-/年.]\d{1,2}月?(?:[-/.]\d{1,2}日?)?$/.test(s)) return true;
+	if (/^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}/.test(s)) return true;
+	if (/^\d{1,2}:\d{2}(:\d{2})?$/.test(s)) return true;
+	return false;
+}
+function splitLine(line, delim) {
+	const out = [];
+	let cur = "";
+	let inQuotes = false;
+	for (let i = 0; i < line.length; i++) {
+		const ch = line[i];
+		if (ch === "\"") {
+			if (inQuotes && line[i + 1] === "\"") {
+				cur += "\"";
+				i++;
+			} else inQuotes = !inQuotes;
+		} else if (ch === delim && !inQuotes) {
+			out.push(cur.trim());
+			cur = "";
+		} else cur += ch;
+	}
+	out.push(cur.trim());
+	return out;
+}
+function pickDelimiter(line) {
+	const candidates = [
+		"	",
+		";",
+		",",
+		"，"
+	];
+	let best = ",";
+	let bestCount = 0;
+	candidates.forEach((d) => {
+		const n = splitLine(line, d).length;
+		if (n > bestCount) {
+			bestCount = n;
+			best = d;
+		}
+	});
+	return best;
+}
+function rowToObj(headers, row) {
+	const obj = {};
+	headers.forEach((h, i) => {
+		obj[h] = row[i] === void 0 ? null : row[i];
+	});
+	return obj;
+}
+function parseDataTable(input) {
+	if (Array.isArray(input)) {
+		if (input.length === 0) return null;
+		const first = input[0];
+		if (first !== null && typeof first === "object" && !Array.isArray(first)) {
+			const headers = [];
+			input.forEach((row) => {
+				Object.keys(row).forEach((k) => {
+					if (!headers.includes(k)) headers.push(k);
+				});
+			});
+			return {
+				headers,
+				rows: input
+			};
+		}
+		if (Array.isArray(first)) {
+			if (input.length < 1) return null;
+			const width = input.reduce((m, r) => Math.max(m, r.length), 0);
+			if (width < 2) return null;
+			const head = input[0].map((v) => v === null || v === void 0 ? "" : String(v).trim());
+			if (head.filter((v) => parseNumeric(v) !== null).length === 0) return {
+				headers: head,
+				rows: input.slice(1).map((r) => rowToObj(head, r))
+			};
+			const headers = Array.from({ length: width }, (_, i) => `列${i + 1}`);
+			return {
+				headers,
+				rows: input.map((r) => rowToObj(headers, r))
+			};
+		}
+		return null;
+	}
+	if (typeof input === "string") {
+		const lines = input.split(/\r?\n/).map((l) => l.trim()).filter(Boolean);
+		if (lines.length < 2) return null;
+		const delim = pickDelimiter(lines[0]);
+		const grid = lines.map((l) => splitLine(l, delim));
+		const head = grid[0];
+		if (head.filter((v) => parseNumeric(v) !== null).length === 0 && head.length >= 2) return {
+			headers: head,
+			rows: grid.slice(1).map((r) => rowToObj(head, r))
+		};
+		const width = grid.reduce((m, r) => Math.max(m, r.length), 0);
+		const headers = Array.from({ length: width }, (_, i) => `列${i + 1}`);
+		return {
+			headers,
+			rows: grid.map((r) => rowToObj(headers, r))
+		};
+	}
+	return null;
+}
+function inferColumns(table) {
+	const { headers, rows } = table;
+	return headers.map((name) => {
+		const values = rows.map((r) => r[name] === void 0 ? null : r[name]);
+		const present = values.filter((v) => v !== null && v !== "").length;
+		const numericHits = values.filter((v) => parseNumeric(v) !== null).length;
+		if (present > 0 && numericHits / present >= .6) return {
+			name,
+			type: "number",
+			values: values.map((v) => parseNumeric(v))
+		};
+		const timeHits = values.filter((v) => looksLikeTime(v)).length;
+		if (present > 0 && timeHits / present >= .6) return {
+			name,
+			type: "time",
+			values
+		};
+		return {
+			name,
+			type: "category",
+			values
+		};
+	});
+}
+function distinctCount(values) {
+	return new Set(values.filter((v) => v !== null && v !== "")).size;
+}
+//#endregion
+//#region src/ai/spec.js
+var INTENT_KEYWORDS = {
+	trend: [
+		"趋势",
+		"走势",
+		"变化",
+		"随时间",
+		"增长",
+		"trend"
+	],
+	share: [
+		"占比",
+		"构成",
+		"份额",
+		"比例",
+		"组成",
+		"share"
+	],
+	rank: [
+		"排行",
+		"排名",
+		"前几",
+		"highest",
+		"rank"
+	],
+	compare: [
+		"对比",
+		"比较",
+		"对照",
+		"相比",
+		"compare"
+	],
+	relation: [
+		"关系",
+		"相关",
+		"散点",
+		"分布",
+		"relation",
+		"scatter"
+	],
+	stack: [
+		"叠加",
+		"堆叠",
+		"累计",
+		"stack"
+	]
+};
+function detectIntent(text) {
+	if (!text || typeof text !== "string") return null;
+	for (const intent of [
+		"trend",
+		"stack",
+		"share",
+		"rank",
+		"relation",
+		"compare"
+	]) if (INTENT_KEYWORDS[intent].some((kw) => text.includes(kw))) return intent;
+	return null;
+}
+function fmtValue(v) {
+	if (typeof v !== "number" || !Number.isFinite(v)) return String(v);
+	if (Math.abs(v) >= 1e8) return `${(v / 1e8).toFixed(1)}亿`;
+	if (Math.abs(v) >= 1e4) return `${(v / 1e4).toFixed(1)}万`;
+	return `${Math.round(v * 100) / 100}`;
+}
+function buildNarrative(spec, labels, seriesList) {
+	const annotations = [];
+	let best = null;
+	seriesList.forEach((s, si) => {
+		s.data.forEach((v, di) => {
+			if (typeof v === "number" && Number.isFinite(v) && (!best || v > best.value)) best = {
+				value: v,
+				label: labels[di],
+				series: s.name,
+				si,
+				di
+			};
+		});
+	});
+	if (best) annotations.push({
+		type: "callout",
+		x: best.label,
+		y: best.value,
+		series: best.series,
+		label: `峰值 ${fmtValue(best.value)}`,
+		anchor: "top-right"
+	});
+	const first = seriesList[0];
+	if (first && first.data.length >= 2) {
+		const prev = first.data[first.data.length - 2];
+		const last = first.data[first.data.length - 1];
+		if (typeof prev === "number" && typeof last === "number" && prev !== 0) {
+			const pct = (last - prev) / Math.abs(prev);
+			if (Math.abs(pct) >= .01) annotations.push({
+				type: "delta",
+				x: labels[labels.length - 1],
+				y: last,
+				series: first.name,
+				direction: pct >= 0 ? "up" : "down",
+				text: `环比 ${pct >= 0 ? "+" : ""}${(pct * 100).toFixed(0)}%`
+			});
+		}
+	}
+	if (annotations.length > 0) spec.annotations = annotations.slice(0, 3);
+}
+function generateChartSpec(data, hint = {}) {
+	const table = parseDataTable(data);
+	if (!table) return {
+		spec: null,
+		report: [{
+			level: "error",
+			message: "无法识别的数据格式：支持 CSV/TSV 文本、对象数组、二维数组"
+		}]
+	};
+	const cols = inferColumns(table);
+	const numbers = cols.filter((c) => c.type === "number");
+	const times = cols.filter((c) => c.type === "time");
+	const cats = cols.filter((c) => c.type === "category" && distinctCount(c.values) > 0);
+	const dimension = times[0] || cats[0] || null;
+	const labels = dimension ? dimension.values.map((v) => String(v)) : table.rows.map((_, i) => String(i + 1));
+	const intent = hint.intent || detectIntent([hint.title, hint.hint].filter(Boolean).join(" ")) || defaultIntent({
+		times: times.length,
+		numbers: numbers.length,
+		cats: cats.length,
+		labels: labels.length
+	});
+	const report = [{
+		level: "info",
+		message: `识别到 ${numbers.length} 个数值列、${times.length} 个时间列、${cats.length} 个类目列；意图「${intent}」`
+	}];
+	const spec = {};
+	if (hint.title) spec.title = hint.title;
+	if (intent === "relation" && numbers.length >= 2) {
+		const cat = cats[0];
+		spec.type = "scatter";
+		spec.scatterData = table.rows.map((_, i) => ({
+			x: numbers[0].values[i],
+			y: numbers[1].values[i],
+			label: cat ? String(cat.values[i]) : String(i + 1)
+		}));
+		report.push({
+			level: "info",
+			message: `散点图：${numbers[0].name} → x，${numbers[1].name} → y`
+		});
+		return {
+			spec,
+			report
+		};
+	}
+	if (numbers.length === 0) return {
+		spec: null,
+		report: [{
+			level: "error",
+			message: "数据中没有可用的数值列（列需 ≥60% 为可解析数字）"
+		}]
+	};
+	const seriesList = numbers.slice(0, 8).map((c) => ({
+		name: c.name,
+		data: c.values
+	}));
+	if (numbers.length > 8) report.push({
+		level: "warn",
+		message: `数值列超过 8 个，仅取前 8 列（${seriesList.map((s) => s.name).join("、")}）`
+	});
+	if (intent === "share") {
+		if (seriesList.length === 1 && labels.length <= 8) {
+			const pieData = labels.map((name, i) => ({
+				name,
+				value: seriesList[0].data[i]
+			})).filter((d) => typeof d.value === "number" && d.value > 0);
+			spec.type = "pie";
+			spec.pieData = pieData;
+			report.push({
+				level: "info",
+				message: `饼图：${seriesList[0].name} 按类目占比（${pieData.length} 项）`
+			});
+			return {
+				spec,
+				report
+			};
+		}
+		if (seriesList.length >= 2 && seriesList.length <= 8) {
+			const sums = seriesList.map((s) => s.data.reduce((acc, v) => typeof v === "number" && Number.isFinite(v) ? acc + v : acc, 0));
+			if (sums.every((v) => v > 0)) {
+				spec.type = "pie";
+				spec.pieData = seriesList.map((s, i) => ({
+					name: s.name,
+					value: sums[i]
+				}));
+				report.push({
+					level: "info",
+					message: `饼图：按度量合计占比（${sums.length} 项）`
+				});
+				return {
+					spec,
+					report
+				};
+			}
+		}
+	}
+	const labelWidth = labels.reduce((m, l) => Math.max(m, l.length), 0);
+	const wantRank = intent === "rank" || intent === "compare" && seriesList.length === 1 && labels.length >= 9;
+	if (seriesList.length === 1 && (wantRank || labels.length >= 13 || labelWidth >= 5 && labels.length >= 7)) {
+		spec.type = "horizontal-bar";
+		spec.labels = labels;
+		spec.series = seriesList;
+		report.push({
+			level: "info",
+			message: "横向条形图：单度量分类对比，类目名走纵列更易读"
+		});
+		finishCartesian(spec, hint, labels, seriesList, report);
+		return {
+			spec,
+			report
+		};
+	}
+	if (intent === "stack" && seriesList.length >= 2) {
+		spec.type = "stacked-bar";
+		report.push({
+			level: "info",
+			message: "堆叠柱状图：多度量叠加看构成"
+		});
+	} else if ((intent === "compare" || intent === "rank") && seriesList.length <= 3 && labels.length <= 12) {
+		spec.type = "bar";
+		report.push({
+			level: "info",
+			message: "柱状图：类目间量值对比"
+		});
+	} else {
+		spec.type = "line";
+		report.push({
+			level: "info",
+			message: "折线图：维度有序（时间/类目），看走势与多系列对比"
+		});
+	}
+	spec.labels = labels;
+	spec.series = seriesList;
+	if (seriesList.length > 1) spec.legend = { show: true };
+	finishCartesian(spec, hint, labels, seriesList, report);
+	return {
+		spec,
+		report
+	};
+}
+function finishCartesian(spec, hint, labels, seriesList, report) {
+	if (hint.narrative) {
+		buildNarrative(spec, labels, seriesList);
+		if (spec.annotations) report.push({
+			level: "info",
+			message: `叙述注解 ${spec.annotations.length} 处（峰值 callout / 末点环比 delta）`
+		});
+	}
+}
+function defaultIntent({ times, numbers, cats, labels }) {
+	if (times > 0 && numbers > 0) return "trend";
+	if (numbers >= 2 && cats === 0) return "relation";
+	if (numbers === 1 && (cats > 0 || labels > 0)) return "compare";
+	return "trend";
+}
+var SPEC_RULES = [
+	"type 必填，取值必须是 schema enum 中的图表类型",
+	"series[].data 长度必须与 labels 一致，缺失值用 null",
+	"叙述注解 annotations 单图不超过 3 处，emphasis 焦点最多 1 个系列",
+	"不使用 schema 之外的字段",
+	`支持的图表类型：${chartOptionsSchema.properties.type.enum.join(" / ")}`
+];
+//#endregion
+//#region src/ai/examples.js
+var SPEC_EXAMPLES = [
+	{
+		requirement: "看上半年各渠道销售额走势",
+		spec: {
+			type: "line",
+			title: "渠道月度销售额",
+			labels: [
+				"1月",
+				"2月",
+				"3月",
+				"4月",
+				"5月",
+				"6月"
+			],
+			series: [{
+				name: "线上商城",
+				data: [
+					320,
+					356,
+					401,
+					388,
+					520,
+					560
+				]
+			}, {
+				name: "线下门店",
+				data: [
+					280,
+					302,
+					346,
+					331,
+					352,
+					428
+				]
+			}],
+			legend: { show: true }
+		}
+	},
+	{
+		requirement: "各渠道销售额占比",
+		spec: {
+			type: "pie",
+			title: "渠道销售额占比",
+			pieData: [
+				{
+					name: "线上商城",
+					value: 2545
+				},
+				{
+					name: "线下门店",
+					value: 2039
+				},
+				{
+					name: "社群团购",
+					value: 844
+				}
+			]
+		}
+	},
+	{
+		requirement: "各门店销量排行",
+		spec: {
+			type: "horizontal-bar",
+			title: "门店销量排行",
+			labels: [
+				"线下体验店",
+				"线上旗舰店",
+				"社群团购点",
+				"仓储会员店",
+				"社区便利店"
+			],
+			series: [{
+				name: "销量",
+				data: [
+					120,
+					98,
+					80,
+					60,
+					52
+				]
+			}]
+		}
+	},
+	{
+		requirement: "广告投放与成交金额的关系",
+		spec: {
+			type: "scatter",
+			title: "投放-成交关系",
+			scatterData: [
+				{
+					x: 100,
+					y: 12,
+					label: "华东"
+				},
+				{
+					x: 200,
+					y: 26,
+					label: "华南"
+				},
+				{
+					x: 300,
+					y: 31,
+					label: "华北"
+				}
+			]
+		}
+	}
+];
+function formatExamples(maxCount = SPEC_EXAMPLES.length) {
+	return SPEC_EXAMPLES.slice(0, maxCount).map((e) => `需求：${e.requirement}\nSpec：${JSON.stringify(e.spec)}`).join("\n\n");
+}
+//#endregion
+//#region src/ai/prompt.js
+var PREVIEW_ROWS = 8;
+function buildChartPrompt({ data, requirement, extraRules = [], examples = true } = {}) {
+	const table = parseDataTable(data);
+	let digest;
+	if (table) digest = `${table.headers.join(" | ")}\n${table.rows.slice(0, PREVIEW_ROWS).map((r) => table.headers.map((h) => r[h] === null || r[h] === void 0 ? "" : String(r[h])).join(" | ")).join("\n")}${table.rows.length > PREVIEW_ROWS ? `\n…共 ${table.rows.length} 行` : ""}`;
+	else if (data !== void 0 && data !== null) digest = typeof data === "string" ? data : JSON.stringify(data);
+	else digest = "（未提供数据，请基于需求虚构合理示例数据）";
+	const rules = [...SPEC_RULES, ...extraRules];
+	const sections = [
+		"你是图表配置生成器。根据下面的数据与需求，产出 EvChart 的 options JSON（下称 Spec），它将被 <ev-chart :options> 直接渲染。",
+		`## Options Schema\n${JSON.stringify(chartOptionsSchema)}`,
+		`## 数据预览\n${digest}`
+	];
+	if (examples) sections.push(`## 示例\n${formatExamples()}`);
+	sections.push(requirement ? `## 需求\n${requirement}` : "## 需求\n根据数据形状自行选择最合适的图表类型，并拟一个不超过 12 字的标题。");
+	sections.push(`## 硬性规则\n${rules.map((r, i) => `${i + 1}. ${r}`).join("\n")}`);
+	return sections.join("\n\n");
+}
+//#endregion
+//#region src/ai/lint.js
+var DEFAULT_SIZE = {
+	width: 800,
+	height: 450
+};
+function checkTextOverflow(svg, width, height) {
+	const issues = [];
+	let count = 0;
+	for (const m of svg.matchAll(/<text x="([-\d.]+)" y="([-\d.]+)"/g)) {
+		const x = parseFloat(m[1]);
+		const y = parseFloat(m[2]);
+		if (x < -1 || x > width + 1 || y < 0 || y > height + 1) count++;
+	}
+	if (count > 0) issues.push({
+		level: "warn",
+		message: `${count} 处文本超出画布边界（可能被裁剪）`,
+		rule: "text-overflow"
+	});
+	return issues;
+}
+function checkTextOverlap(svg) {
+	const issues = [];
+	const texts = [];
+	for (const m of svg.matchAll(/<text x="([-\d.]+)" y="([-\d.]+)" font-size="([\d.]+)"([^>]*)>([^<]*)<\/text>/g)) {
+		const x = parseFloat(m[1]);
+		const y = parseFloat(m[2]);
+		const fs = parseFloat(m[3]);
+		const attrs = m[4];
+		const content = m[5].trim();
+		if (!content) continue;
+		const w = estimateTextWidth(content, fs);
+		let left = x;
+		if (/text-anchor="middle"/.test(attrs)) left = x - w / 2;
+		else if (/text-anchor="end"/.test(attrs)) left = x - w;
+		texts.push({
+			left,
+			right: left + w,
+			y,
+			fs
+		});
+	}
+	let count = 0;
+	for (let i = 0; i < texts.length; i++) for (let j = i + 1; j < texts.length; j++) {
+		const a = texts[i];
+		const b = texts[j];
+		if (Math.abs(a.y - b.y) >= Math.max(a.fs, b.fs) * .8) continue;
+		if (Math.min(a.right, b.right) - Math.max(a.left, b.left) > Math.min(a.right - a.left, b.right - b.left) * .3) count++;
+	}
+	if (count > 0) issues.push({
+		level: "warn",
+		message: `${count} 处文本相互重叠（标签或注解可能互相遮挡）`,
+		rule: "text-overlap"
+	});
+	return issues;
+}
+function luminance(color) {
+	let s = String(color).trim();
+	if (/^#[0-9a-fA-F]{6}$/.test(s)) s = s.slice(1);
+	else if (/^#[0-9a-fA-F]{3}$/.test(s)) s = s.slice(1).split("").map((c) => c + c).join("");
+	else return null;
+	const n = parseInt(s, 16);
+	const chan = [
+		n >> 16 & 255,
+		n >> 8 & 255,
+		n & 255
+	].map((v) => {
+		const c = v / 255;
+		return c <= .03928 ? c / 12.92 : Math.pow((c + .055) / 1.055, 2.4);
+	});
+	return .2126 * chan[0] + .7152 * chan[1] + .0722 * chan[2];
+}
+function contrastRatio(a, b) {
+	const la = luminance(a);
+	const lb = luminance(b);
+	if (la === null || lb === null) return null;
+	return (Math.max(la, lb) + .05) / (Math.min(la, lb) + .05);
+}
+function checkPaletteContrast(spec) {
+	const issues = [];
+	if (!spec.theme || !Array.isArray(spec.theme.colors)) return issues;
+	[false, true].forEach((dark) => {
+		const theme = getTheme(dark, spec.theme);
+		spec.theme.colors.forEach((c) => {
+			const ratio = contrastRatio(c, theme.backgroundColor);
+			if (ratio !== null && ratio < 3) issues.push({
+				level: "warn",
+				message: `自定义色板${dark ? "暗色" : "浅色"}模式对比度不足 3:1：${c}（${ratio.toFixed(1)}）`,
+				rule: "low-contrast"
+			});
+		});
+	});
+	return issues;
+}
+function lintChartSpec(spec, opts = {}) {
+	const issues = [];
+	const fixed = { ...spec };
+	if (!fixed || typeof fixed !== "object") return {
+		issues: [{
+			level: "error",
+			message: "Spec 必须是对象"
+		}],
+		spec: fixed
+	};
+	const { warnings } = validateOptions(fixed);
+	warnings.forEach((w) => issues.push({
+		level: "error",
+		message: `${w.path} ${w.message}`,
+		path: w.path
+	}));
+	if (issues.some((i) => i.level === "error" && i.path === "options.type")) return {
+		issues,
+		spec: fixed
+	};
+	if (Array.isArray(fixed.annotations) && fixed.annotations.length > 3) {
+		fixed.annotations = fixed.annotations.slice(0, 3);
+		issues.push({
+			level: "info",
+			message: "注解超过 3 处，已按焦点预算裁剪",
+			rule: "annotation-budget"
+		});
+	}
+	if ((fixed.type === "pie" || fixed.type === "doughnut") && Array.isArray(fixed.pieData) && fixed.pieData.length > 8) issues.push({
+		level: "warn",
+		message: `饼图 ${fixed.pieData.length} 个扇区过多（>8），建议改用横向条形图`,
+		rule: "pie-slices"
+	});
+	issues.push(...checkPaletteContrast(fixed));
+	if (fixed.type === "bar" && Array.isArray(fixed.series) && fixed.series.length === 1 && Array.isArray(fixed.labels)) {
+		const width = opts.width ?? DEFAULT_SIZE.width;
+		const labels = fixed.labels.map(String);
+		const maxLabelWidth = Math.max(...labels.map((l) => estimateTextWidth(l, 12)), 0);
+		const slots = Math.max(1, (width - 80) / Math.max(1, labels.length));
+		if (labels.length >= 7 && maxLabelWidth > slots * .9) {
+			fixed.type = "horizontal-bar";
+			issues.push({
+				level: "info",
+				message: "类目名过宽拥挤，已自动改为横向条形图",
+				rule: "bar-to-horizontal"
+			});
+		}
+	}
+	if (typeof document !== "undefined" && fixed.type) try {
+		const width = opts.width ?? DEFAULT_SIZE.width;
+		const height = opts.height ?? DEFAULT_SIZE.height;
+		const canvas = document.createElement("canvas");
+		canvas.width = width;
+		canvas.height = height;
+		const real = canvas.getContext("2d");
+		if (real) {
+			const recorder = createSvgRecorder(real);
+			renderChart(canvas, {
+				options: fixed,
+				ctx: recorder.ctx,
+				dpr: 1,
+				progress: 1,
+				hoverIndex: -1,
+				mouseX: -1,
+				mouseY: -1,
+				showCrosshair: false
+			});
+			issues.push(...checkTextOverflow(recorder.toSvg(width, height, "#ffffff"), width, height));
+			issues.push(...checkTextOverlap(recorder.toSvg(width, height, "#ffffff")));
+		}
+	} catch {
+		issues.push({
+			level: "info",
+			message: "无头渲染自检不可用，已跳过几何检查",
+			rule: "headless-skipped"
+		});
+	}
+	return {
+		issues,
+		spec: fixed
+	};
+}
+//#endregion
 //#region src/index.js
 var components = { EvChart: chart_default };
 function install(app, _options = {}) {
@@ -6192,4 +7900,4 @@ function install(app, _options = {}) {
 var EvokeCharts = { install };
 var src_default = { install };
 //#endregion
-export { chart_default as EvChart, EvokeCharts, applySeriesPalette, clearSeriesPalette, components, src_default as default, injectChartContext, install, provideChartContext, useChart };
+export { chart_default as EvChart, EvokeCharts, applySeriesPalette, buildChartPrompt, chartOptionsSchema, clearSeriesPalette, components, src_default as default, generateChartSpec, injectChartContext, install, lintChartSpec, parseDataTable, provideChartContext, useChart, validateOptions };