@wil-works/evoke-charts 0.5.0 → 0.7.0

package/dist/{ai-BmXDig6M.js → ai-cRi95pS2.js}

@@ -1,3 +1,4 @@
+import { C as DOWN_COLOR, D as getSeriesColors, E as formatValue, O as readChartToken, T as VOLUME_SERIES_NAME, b as resolveChartPalette, n as validateOptions3d, t as chart3dOptionsSchema, w as UP_COLOR, x as CHART_COLORS, y as CHART_PALETTES } from "./schema-CM4hKlpc.js";
 //#region src/interactions.js
 var INTERACTION = {
 	focusDimAlpha: .22,
@@ -67,302 +68,34 @@ function pickTooltipRows(params) {
 	});
 }
 //#endregion
-//#region src/types.js
-var DEFAULT_I18N_ZH = {
-	tooltip: {
-		open: "开",
-		close: "收",
-		high: "高",
-		low: "低",
-		total: "总计",
-		average: "平均"
-	},
-	legend: {
-		show: "显示",
-		hide: "隐藏"
-	},
-	noData: "暂无数据"
-};
-/**
-* 系列色令牌槽位 — 每槽按顺序尝试读取专用数据色令牌（--ev-color-series-N），
-* 槽 1 回退 --ev-color-primary（品牌主色跟随）；
-* 任一槽无令牌时该槽回落内置成套色板（与语义状态色解耦的数据色板）。
-* CHART_COLORS 仅作为 SSR / 无 DOM 环境的静态兜底。
-*/
-var SERIES_COLOR_SLOTS = [
-	["--ev-color-series-1", "--ev-color-primary"],
-	["--ev-color-series-2"],
-	["--ev-color-series-3"],
-	["--ev-color-series-4"],
-	["--ev-color-series-5"],
-	["--ev-color-series-6"],
-	["--ev-color-series-7"],
-	["--ev-color-series-8"]
-];
-function readChartToken(name, fallback) {
-	try {
-		if (typeof document === "undefined") return fallback;
-		return getComputedStyle(document.documentElement).getPropertyValue(name).trim() || fallback;
-	} catch (e) {
-		return fallback;
+//#region src/extent.js
+function minOf(values, ...extras) {
+	let min = Infinity;
+	for (let i = 0; i < values.length; i++) {
+		const v = values[i];
+		if (Number.isNaN(v)) return NaN;
+		if (v < min) min = v;
 	}
-}
-function getSeriesColors(fallbackColors) {
-	return SERIES_COLOR_SLOTS.map((tokens, i) => {
-		for (const t of tokens) {
-			const v = readChartToken(t, "");
-			if (v) return v;
-		}
-		return fallbackColors[i];
-	});
-}
-var CHART_COLORS = {
-	/**
-	* 主色板 — 品牌蓝锚定的成套数据色板（与语义状态色解耦）：
-	* 色相按取色顺序相邻差 ≥ 30°，明度带 44–68，青绿/金黄/天蓝/珊瑚/紫/石板
-	* 取材 AntV 经典系并经品牌蓝调协调；暗色板同色相提亮。
-	*/
-	primary: [
-		"#175DFF",
-		"#5AD8A6",
-		"#F6BD16",
-		"#6DC8EC",
-		"#E8684A",
-		"#9270CA",
-		"#FF9D4D",
-		"#5D7092"
-	],
-	/** 浅色系列 — primary 的 light-9/light-8/light-7 阶梯 */
-	light: [
-		"#e8f0ff",
-		"#d0e1ff",
-		"#b9d2ff"
-	],
-	/** 暗色模式系列 — 同色相提亮（对齐 evoke 暗色主色） */
-	dark: [
-		"#4d8bff",
-		"#5ad8a6",
-		"#f6bd16",
-		"#6dc8ec",
-		"#f08568",
-		"#a585e8",
-		"#ff9d4d",
-		"#8da3bf"
-	],
-	/** 热力图默认色阶（天亮蓝由浅到深） */
-	heatmapScale: [
-		"#f0f5ff",
-		"#c6d9ff",
-		"#8ab0ff",
-		"#4d86ff",
-		"#175DFF",
-		"#0040c2"
-	]
-};
-function formatValue(value, options) {
-	if (value === null || value === void 0 || Number.isNaN(value)) return "-";
-	const { decimals = 0, thousandSeparator = ",", prefix = "", suffix = "", abbreviate = false } = options || {};
-	let formatted;
-	if (abbreviate) {
-		const abs = Math.abs(value);
-		if (abs >= 1e8) formatted = (value / 1e8).toFixed(2) + "亿";
-		else if (abs >= 1e4) formatted = (value / 1e4).toFixed(2) + "万";
-		else if (abs >= 1e3) formatted = (value / 1e3).toFixed(2) + "K";
-		else formatted = value.toFixed(decimals);
-	} else {
-		const fixed = value.toFixed(decimals);
-		if (thousandSeparator && decimals === 0) formatted = fixed.replace(/\B(?=(\d{3})+(?!\d))/g, thousandSeparator);
-		else if (thousandSeparator) {
-			const [intPart, decPart] = fixed.split(".");
-			formatted = intPart.replace(/\B(?=(\d{3})+(?!\d))/g, thousandSeparator) + (decPart ? "." + decPart : "");
-		} else formatted = fixed;
+	for (let i = 0; i < extras.length; i++) {
+		const v = extras[i];
+		if (Number.isNaN(v)) return NaN;
+		if (v < min) min = v;
 	}
-	return prefix + formatted + suffix;
+	return min;
 }
-//#endregion
-//#region src/palettes.js
-var CHART_PALETTES = [
-	{
-		id: "classic",
-		name: "经典",
-		scene: "当前缺省色板的固化版，品牌蓝锚定；想保住默认观感不随换肤时用",
-		light: [
-			"#175DFF",
-			"#5AD8A6",
-			"#F6BD16",
-			"#6DC8EC",
-			"#E8684A",
-			"#9270CA",
-			"#FF9D4D",
-			"#5D7092"
-		],
-		dark: [
-			"#4d8bff",
-			"#5ad8a6",
-			"#f6bd16",
-			"#6dc8ec",
-			"#f08568",
-			"#a585e8",
-			"#ff9d4d",
-			"#8da3bf"
-		]
-	},
-	{
-		id: "aurora",
-		name: "极光",
-		scene: "科技 SaaS / 数据产品——冷调现代，蓝绿紫主打的仪表盘观感",
-		light: [
-			"#3B82F6",
-			"#10B981",
-			"#F59E0B",
-			"#8B5CF6",
-			"#EC4899",
-			"#06B6D4",
-			"#F97316",
-			"#64748B"
-		],
-		dark: [
-			"#60A5FA",
-			"#34D399",
-			"#FBBF24",
-			"#A78BFA",
-			"#F472B6",
-			"#22D3EE",
-			"#FB923C",
-			"#94A3B8"
-		]
-	},
-	{
-		id: "sunset",
-		name: "落日",
-		scene: "消费零售 / 生活方式 / 营销复盘——暖橙珊瑚主导，热情有温度",
-		light: [
-			"#F97316",
-			"#E11D48",
-			"#EAB308",
-			"#14B8A6",
-			"#8B5CF6",
-			"#FB7185",
-			"#0EA5E9",
-			"#A8A29E"
-		],
-		dark: [
-			"#FB923C",
-			"#FB7185",
-			"#FACC15",
-			"#2DD4BF",
-			"#A78BFA",
-			"#FDA4AF",
-			"#38BDF8",
-			"#BDB4AC"
-		]
-	},
-	{
-		id: "morandi",
-		name: "莫兰迪",
-		scene: "人文 / 咨询报告 / 印刷排版——低饱和灰调，长文配图不抢字",
-		light: [
-			"#A3AEBB",
-			"#C2A878",
-			"#B08890",
-			"#86A69D",
-			"#9A8FA8",
-			"#B7C4A0",
-			"#C98F6B",
-			"#8A8F98"
-		],
-		dark: [
-			"#B4BEC9",
-			"#D4BC8E",
-			"#C29AA3",
-			"#97B5AC",
-			"#ACA2BC",
-			"#C5D0AF",
-			"#D8A685",
-			"#9CA1A9"
-		]
-	},
-	{
-		id: "forest",
-		name: "林间",
-		scene: "健康 / 环保 / 农业供应链——自然绿主导，ESG 与可持续叙事",
-		light: [
-			"#16A34A",
-			"#0EA5E9",
-			"#CA8A04",
-			"#7C3AED",
-			"#DC2626",
-			"#0D9488",
-			"#D97706",
-			"#64748B"
-		],
-		dark: [
-			"#22C55E",
-			"#38BDF8",
-			"#EAB308",
-			"#8B5CF6",
-			"#EF4444",
-			"#14B8A6",
-			"#F59E0B",
-			"#94A3B8"
-		]
-	},
-	{
-		id: "ink",
-		name: "墨蓝",
-		scene: "金融 / 政企 / 严肃年报——克制深稳，深蓝为骨、暖色点缀",
-		light: [
-			"#1E40AF",
-			"#0F766E",
-			"#B45309",
-			"#6D28D9",
-			"#BE123C",
-			"#0369A1",
-			"#4D7C0F",
-			"#6B7280"
-		],
-		dark: [
-			"#6E9BF7",
-			"#2DD4BF",
-			"#D97706",
-			"#8B5CF6",
-			"#FB7185",
-			"#38BDF8",
-			"#84CC16",
-			"#9CA3AF"
-		]
-	},
-	{
-		id: "candy",
-		name: "糖果",
-		scene: "营销活动 / 年轻品牌 / 大屏展示——高饱和明快，视觉抓人",
-		light: [
-			"#EC4899",
-			"#8B5CF6",
-			"#F59E0B",
-			"#22C55E",
-			"#06B6D4",
-			"#EF4444",
-			"#6366F1",
-			"#9CA3AF"
-		],
-		dark: [
-			"#F472B6",
-			"#A78BFA",
-			"#FBBF24",
-			"#4ADE80",
-			"#22D3EE",
-			"#F87171",
-			"#818CF8",
-			"#A1A1AA"
-		]
+function maxOf(values, ...extras) {
+	let max = -Infinity;
+	for (let i = 0; i < values.length; i++) {
+		const v = values[i];
+		if (Number.isNaN(v)) return NaN;
+		if (v > max) max = v;
 	}
-];
-/** 按 id 取色系在指定明暗模式下的 8 槽色值；未知 id 返回 null */
-function resolveChartPalette(id, isDark) {
-	const palette = CHART_PALETTES.find((p) => p.id === id);
-	if (!palette) return null;
-	return (isDark ? palette.dark : palette.light).slice(0, 8);
+	for (let i = 0; i < extras.length; i++) {
+		const v = extras[i];
+		if (Number.isNaN(v)) return NaN;
+		if (v > max) max = v;
+	}
+	return max;
 }
 //#endregion
 //#region src/renderer/core.js
@@ -434,6 +167,89 @@ function mixColor(color, ratio, target) {
 function isMissingValue(v) {
 	return v === null || v === void 0 || Number.isNaN(v);
 }
+function truncateLabel(canvasCtx, label, maxWidth) {
+	if (canvasCtx.measureText(label).width <= maxWidth) return label;
+	let lo = 0, hi = label.length;
+	while (lo < hi) {
+		const mid = Math.ceil((lo + hi) / 2);
+		const truncated = label.slice(0, mid) + "…";
+		if (canvasCtx.measureText(truncated).width > maxWidth) hi = mid - 1;
+		else lo = mid;
+	}
+	return label.slice(0, lo) + "…";
+}
+function waterfallSteps(deltas, totalIndices) {
+	const totalIdx = new Set(totalIndices || []);
+	const steps = [];
+	let cumulative = 0;
+	(deltas || []).forEach((raw, i) => {
+		const missing = isMissingValue(raw);
+		const v = missing ? 0 : raw;
+		if (totalIdx.has(i)) {
+			steps.push({
+				value: v,
+				from: 0,
+				to: v,
+				isTotal: true,
+				missing
+			});
+			cumulative = v;
+		} else {
+			steps.push({
+				value: v,
+				from: cumulative,
+				to: cumulative + v,
+				isTotal: false,
+				missing
+			});
+			cumulative += v;
+		}
+	});
+	return steps;
+}
+function minMaxDecimatePoints(points, columns) {
+	const out = [];
+	const per = points.length / columns;
+	let pendingGap = false;
+	for (let b = 0; b < columns; b++) {
+		const start = Math.floor(b * per);
+		const end = Math.min(points.length, Math.max(start + 1, Math.floor((b + 1) * per)));
+		let first = -1;
+		let last = -1;
+		let minI = -1;
+		let maxI = -1;
+		for (let i = start; i < end; i++) {
+			const p = points[i];
+			if (!p) continue;
+			if (first < 0) first = i;
+			last = i;
+			if (minI < 0 || p[1] < points[minI][1]) minI = i;
+			if (maxI < 0 || p[1] > points[maxI][1]) maxI = i;
+		}
+		if (first < 0) {
+			if (out.length > 0) pendingGap = true;
+			continue;
+		}
+		if (pendingGap) {
+			out.push({
+				p: null,
+				i: first
+			});
+			pendingGap = false;
+		}
+		const picks = [.../* @__PURE__ */ new Set([
+			first,
+			minI,
+			maxI,
+			last
+		])].sort((a, b) => a - b);
+		for (const idx of picks) out.push({
+			p: points[idx],
+			i: idx
+		});
+	}
+	return out;
+}
 function resolveConnectNulls(options, series) {
 	return series?.connectNulls ?? options.connectNulls ?? false;
 }
@@ -710,7 +526,7 @@ function getPadding(options, containerWidth = 600) {
 	if (options.type === "gantt") {
 		const pad2 = resolveUserPadding(options);
 		const names2 = (options.ganttData || []).map((t) => t.name || "");
-		const labelW = names2.length ? Math.max(80, Math.min(180, Math.round(Math.max(...names2.map((n) => estimateTextWidth(n, 12))) + 16))) : 100;
+		const labelW = names2.length ? Math.max(80, Math.min(180, Math.round(maxOf(names2.map((n) => estimateTextWidth(n, 12))) + 16))) : 100;
 		const top2 = (pad2.top ?? 18) + titleBlockHeight(options) + (legendPosition === "top" ? LEGEND_BAND + legendRowsExtra : 0);
 		const bottom2 = (pad2.bottom ?? 46) + (legendPosition === "bottom" ? LEGEND_BAND + legendRowsExtra : 0);
 		const left2 = pad2.left ?? labelW;
@@ -735,9 +551,11 @@ function getPadding(options, containerWidth = 600) {
 			if (options.heatmap?.colorBar === true || options.heatmapColorBar === true) right2 += 44;
 		}
 		if (options.type === "bin") {
-			const allValues = [];
-			(options.series || []).forEach((s) => allValues.push(...s.data.filter((v) => !isMissingValue(v))));
-			const maxFreq = allValues.length;
+			let maxFreq = 0;
+			(options.series || []).forEach((s) => {
+				const data = s.data || [];
+				for (let i = 0; i < data.length; i++) if (!isMissingValue(data[i])) maxFreq++;
+			});
 			const tickLabelWidth = String(maxFreq).length * 7;
 			left2 = pad.left ?? Math.min(90, Math.max(36, tickLabelWidth + 16));
 			bottom2 = Math.max(bottom2, 30);
@@ -914,22 +732,14 @@ function calculateRange(options, hiddenSeries, useRightAxis) {
 	const seriesList = (options.series || []).filter((s) => !hiddenSeries.has(s.name) && (useRightAxis ? s.yAxis === "right" : s.yAxis !== "right"));
 	if (options.type === "waterfall") {
 		const wf = options.waterfall || {};
-		const totalIdx = new Set(wf.totalIndices || []);
 		const deltas = (options.series || []).filter((s) => !hiddenSeries.has(s.name))[0]?.data || [];
-		let cumulative = 0;
-		deltas.forEach((rawV, i) => {
-			const v = isMissingValue(rawV) ? 0 : rawV;
-			if (totalIdx.has(i)) {
-				if (v > max) max = v;
-				if (v < min) min = v;
-				cumulative = v;
-			} else {
-				const from = cumulative;
-				cumulative = cumulative + v;
-				if (Math.max(from, cumulative) > max) max = Math.max(from, cumulative);
-				if (Math.min(from, cumulative) < min) min = Math.min(from, cumulative);
+		for (const step of waterfallSteps(deltas, wf.totalIndices)) {
+			const points = step.isTotal ? [step.to] : [step.from, step.to];
+			for (const p of points) {
+				if (p > max) max = p;
+				if (p < min) min = p;
 			}
-		});
+		}
 	} else if (options.type === "boxplot") (options.boxData || []).forEach((b) => {
 		if (b.group && hiddenSeries.has(b.group)) return;
 		if (b.max > max) max = b.max;
@@ -1102,22 +912,11 @@ function updateAnimation(state) {
 	if (state.startTime === 0) state.startTime = Date.now();
 	const elapsed = Date.now() - state.startTime;
 	const t = Math.min(elapsed / state.duration, 1);
-	state.progress = easings[state.easing](t);
+	state.progress = (easings[state.easing] || easings.easeOut)(t);
 	return t < 1;
 }
 //#endregion
 //#region src/renderer/axes.js
-function truncateLabel(canvasCtx, label, maxWidth) {
-	if (canvasCtx.measureText(label).width <= maxWidth) return label;
-	let lo = 0, hi = label.length;
-	while (lo < hi) {
-		const mid = Math.ceil((lo + hi) / 2);
-		const truncated = label.slice(0, mid) + "…";
-		if (canvasCtx.measureText(truncated).width > maxWidth) hi = mid - 1;
-		else lo = mid;
-	}
-	return label.slice(0, lo) + "…";
-}
 /**
 * 抽稀刻度：保留首末两端覆盖，步长取整数倍使数量 ≤ maxCount。
 * nice 算法的 step 候选会让实际刻度数超出请求数（如 ticks:3 得到 5 档），
@@ -1295,8 +1094,8 @@ function renderTimeXAxis(ctx) {
 	const xAxisConfig = options.xAxis || {};
 	const valid = parseTimeLabels(options.labels || []).filter((t) => !Number.isNaN(t));
 	if (valid.length === 0) return;
-	const min = xAxisConfig.min ?? Math.min(...valid);
-	const max = xAxisConfig.max ?? Math.max(...valid);
+	const min = xAxisConfig.min ?? minOf(valid);
+	const max = xAxisConfig.max ?? maxOf(valid);
 	const span = max - min || 1;
 	const { values: tickTs, unit } = calculateTimeTicks(min, max, Math.max(3, Math.min(8, Math.floor(plotArea.width / 90))));
 	const toX = (ts) => plotArea.x + (ts - min) / span * plotArea.width;
@@ -1336,8 +1135,8 @@ function timeToX(options, plotArea, index) {
 	const timestamps = parseTimeLabels(options.labels || []);
 	const valid = timestamps.filter((t) => !Number.isNaN(t));
 	if (valid.length === 0) return plotArea.x;
-	const min = options.xAxis?.min ?? Math.min(...valid);
-	const span = (options.xAxis?.max ?? Math.max(...valid)) - min || 1;
+	const min = options.xAxis?.min ?? minOf(valid);
+	const span = (options.xAxis?.max ?? maxOf(valid)) - min || 1;
 	const ts = timestamps[index];
 	if (Number.isNaN(ts)) return plotArea.x + index / ((options.labels?.length || 1) - 1 || 1) * plotArea.width;
 	return plotArea.x + (ts - min) / span * plotArea.width;
@@ -1822,7 +1621,7 @@ function funnelStepColor(data, index, theme) {
 function computeFunnelGeometry(plotArea, options, theme) {
 	const all = options.funnelData || [];
 	const drawn = options.pyramid === true ? [...all].reverse() : all;
-	const maxValue = drawn.length ? Math.max(...drawn.map((d) => d.value)) : 0;
+	const maxValue = drawn.length ? maxOf(drawn.map((d) => d.value)) : 0;
 	const maxWidth = plotArea.width * .8;
 	const centerX = plotArea.x + plotArea.width / 2;
 	const topY = plotArea.y + 8;
@@ -1867,7 +1666,7 @@ function funnelPercent(value, maxValue) {
 	return `${Math.round(value / maxValue * 1e3) / 10}%`;
 }
 function renderFunnelChart(ctx) {
-	const { ctx: canvasCtx, theme, plotArea, options, progress, hoverIndex, hiddenSeries } = ctx;
+	const { ctx: canvasCtx, theme, plotArea, options, progress, hoverIndex, hoverAnimProgress = 1, hiddenSeries } = ctx;
 	const funnelData = (options.funnelData || []).filter((d) => !hiddenSeries.has(d.label || ""));
 	if (funnelData.length === 0) return;
 	const geo = computeFunnelGeometry(plotArea, {
@@ -1889,7 +1688,7 @@ function renderFunnelChart(ctx) {
 		canvasCtx.lineTo(centerX + bottomW / 2, y + stepHeight);
 		canvasCtx.lineTo(centerX - bottomW / 2, y + stepHeight);
 		canvasCtx.closePath();
-		canvasCtx.fillStyle = i === hoverIndex ? mixColor(step.color, .08, "#000000") : step.color;
+		canvasCtx.fillStyle = i === hoverIndex ? mixColor(step.color, .08 * hoverAnimProgress, "#000000") : step.color;
 		canvasCtx.fill();
 		canvasCtx.strokeStyle = theme.backgroundColor;
 		canvasCtx.lineWidth = 2;
@@ -1966,11 +1765,12 @@ function renderFunnelChart(ctx) {
 */
 function renderGaugeChart(ctx) {
 	const { ctx: canvasCtx, theme, plotArea, options, progress, hoverIndex } = ctx;
-	const gauge = options.gauge;
+	const rawGauge = options.gauge;
+	const gauge = typeof rawGauge === "number" ? { value: rawGauge } : rawGauge;
 	if (!gauge || typeof gauge !== "object") return;
-	const min = gauge.min || 0;
-	const max = gauge.max || 100;
-	const value = Math.max(min, Math.min(max, gauge.value));
+	const min = gauge.min ?? 0;
+	const max = gauge.max ?? 100;
+	const value = typeof gauge.value === "number" && Number.isFinite(gauge.value) ? Math.max(min, Math.min(max, gauge.value)) : min;
 	const toRad = (deg) => -deg * Math.PI / 180;
 	const startAngle = toRad(gauge.startAngle ?? 220);
 	let normalizedEnd = toRad(gauge.endAngle ?? -40);
@@ -1991,7 +1791,7 @@ function renderGaugeChart(ctx) {
 	canvasCtx.lineCap = gauge.cornerRadius === "butt" ? "butt" : "round";
 	canvasCtx.stroke();
 	canvasCtx.restore();
-	const animatedRatio = (value - min) / (max - min) * progress;
+	const animatedRatio = (max - min !== 0 ? (value - min) / (max - min) : 0) * progress;
 	const valueAngle = startAngle + (normalizedEnd - startAngle) * animatedRatio;
 	let progressColor = theme.colors[0];
 	if (Array.isArray(gauge.color)) {
@@ -2127,7 +1927,9 @@ function calendarPad(n) {
 }
 /**
 * 日历热力布局：start/end 缺省取数据极值并对齐周边界（weekStart 默认周一）；
-* 数值等宽分 4 档色阶（0/缺测为空档）；cellSize 按可用空间自适应。
+* 数值等宽分 4 档色阶（0/缺测为空档）；granularity: 'day'（列=周 行=星期，
+* 默认）/ 'week' / 'month'（聚合为单行周合计 / 月合计，求和口径）；
+* 格子为矩形，横向铺满绘图区（宽高独立自适应）。
 */
 function computeCalendarLayout(plotArea, options, theme) {
 	const data = options.calendarData || [];
@@ -2138,6 +1940,8 @@ function computeCalendarLayout(plotArea, options, theme) {
 		const t = Date.parse(v);
 		return Number.isNaN(t) ? null : calendarNoon(t);
 	};
+	const gran = cal.granularity === "week" || cal.granularity === "month" ? cal.granularity : "day";
+	const weekStart = cal.weekStart ?? 1;
 	const valueMap = /* @__PURE__ */ new Map();
 	let minTs = Infinity;
 	let maxTs = -Infinity;
@@ -2152,67 +1956,128 @@ function computeCalendarLayout(plotArea, options, theme) {
 	let startTs = toTs(cal.start) ?? minTs;
 	let endTs = toTs(cal.end) ?? maxTs;
 	if (endTs < startTs) [startTs, endTs] = [endTs, startTs];
-	const weekStart = cal.weekStart ?? 1;
-	const shift = (new Date(startTs).getDay() - weekStart + 7) % 7;
-	const firstWeek = startTs - shift * CALENDAR_DAY;
-	const tailShift = (new Date(endTs).getDay() - weekStart + 7) % 7;
-	const lastWeek = endTs + (6 - tailShift) * CALENDAR_DAY;
-	const cols = Math.round((lastWeek - firstWeek) / CALENDAR_DAY / 7);
-	if (cols <= 0) return null;
 	const ramps = cal.colors || (!isLightColor(theme.backgroundColor) ? CALENDAR_RAMP_DARK : CALENDAR_RAMP_LIGHT);
+	const todayTs = calendarNoon(cal.today !== void 0 ? toTs(cal.today) ?? Date.now() : Date.now());
+	const buckets = [];
+	const pushBucket = (label, tsList, col, row) => {
+		let value = null;
+		for (const ts of tsList) if (valueMap.has(ts)) {
+			const v = valueMap.get(ts);
+			value = typeof value === "number" ? value + v : v;
+		}
+		buckets.push({
+			label,
+			col,
+			row,
+			value: typeof value === "number" ? value : null,
+			today: tsList.includes(todayTs)
+		});
+	};
+	if (gran === "day") {
+		const shift = (new Date(startTs).getDay() - weekStart + 7) % 7;
+		const firstWeek = startTs - shift * CALENDAR_DAY;
+		const tailShift = (new Date(endTs).getDay() - weekStart + 7) % 7;
+		const lastWeek = endTs + (6 - tailShift) * CALENDAR_DAY;
+		const cols = Math.round((lastWeek - firstWeek) / CALENDAR_DAY / 7);
+		if (cols <= 0) return null;
+		let prevMonth = -1;
+		const monthLabels = [];
+		for (let col = 0; col < cols; col++) {
+			const firstDay = new Date(firstWeek + col * 7 * CALENDAR_DAY);
+			if (firstDay.getMonth() !== prevMonth) {
+				if (col > 0 || firstDay.getDate() <= 7) monthLabels.push({
+					label: `${firstDay.getMonth() + 1}月`,
+					col
+				});
+				prevMonth = firstDay.getMonth();
+			}
+			for (let row = 0; row < 7; row++) {
+				const ts = firstWeek + (col * 7 + row) * CALENDAR_DAY;
+				if (ts < startTs || ts > endTs) continue;
+				const d = new Date(ts);
+				pushBucket(`${d.getFullYear()}-${calendarPad(d.getMonth() + 1)}-${calendarPad(d.getDate())}`, [ts], col, row);
+			}
+		}
+		var bucketLabels = monthLabels;
+		var rows = 7;
+	} else {
+		const order = [];
+		const sums = /* @__PURE__ */ new Map();
+		for (let ts = startTs; ts <= endTs; ts += CALENDAR_DAY) {
+			const d = new Date(ts);
+			let key;
+			let label;
+			if (gran === "week") {
+				const shift2 = (d.getDay() - weekStart + 7) % 7;
+				const weekTs = ts - shift2 * CALENDAR_DAY;
+				key = `w${weekTs}`;
+				const wd = new Date(weekTs);
+				label = `${wd.getMonth() + 1}月${wd.getDate()}日周`;
+			} else {
+				key = `m${d.getFullYear()}-${d.getMonth()}`;
+				label = `${d.getFullYear()}-${calendarPad(d.getMonth() + 1)}`;
+			}
+			if (!sums.has(key)) {
+				sums.set(key, null);
+				order.push({
+					key,
+					label
+				});
+			}
+			const v = valueMap.get(ts);
+			if (v !== void 0) {
+				const prev = sums.get(key);
+				sums.set(key, typeof prev === "number" ? prev + v : v);
+			}
+		}
+		order.forEach((b, i) => {
+			const value = sums.get(b.key);
+			buckets.push({
+				label: b.label,
+				col: i,
+				row: 0,
+				value: typeof value === "number" ? value : null,
+				today: false
+			});
+		});
+		bucketLabels = gran === "month" ? order.map((b, i) => ({
+			label: b.label,
+			col: i
+		})) : order.map((b, i) => ({
+			label: b.label,
+			col: i,
+			month: parseInt(b.label, 10)
+		})).filter((b, i, arr) => i === 0 || b.month !== arr[i - 1].month);
+		rows = 1;
+	}
 	let vMax = 0;
-	valueMap.forEach((v) => {
-		if (typeof v === "number" && v > vMax) vMax = v;
+	buckets.forEach((b) => {
+		if (typeof b.value === "number" && b.value > vMax) vMax = b.value;
 	});
 	const levelOf = (v) => {
 		if (typeof v !== "number" || !(v > 0) || !(vMax > 0)) return 0;
 		return Math.max(1, Math.min(4, Math.ceil(v / (vMax / 4))));
 	};
 	const labelTop = 18;
-	const leftBand = 28;
+	const leftBand = gran === "day" ? 28 : 6;
 	const gap = Math.max(1, Math.min(8, cal.cellGap ?? 3));
 	const scaleH = cal.showScale === false ? 0 : 22;
+	const cols = Math.max(1, maxOf(buckets.map((b) => b.col + 1)));
 	const availW = plotArea.width - leftBand;
 	const availH = plotArea.height - labelTop - scaleH;
-	const cell = Math.max(5, Math.min((availH - gap * 6) / 7, (availW - gap * (cols - 1)) / cols));
-	const gridW = cols * cell + (cols - 1) * gap;
-	const originX = plotArea.x + leftBand + Math.max(0, (availW - gridW) / 2);
+	const cellW = Math.max(6, (availW - gap * (cols - 1)) / cols);
+	const cellH = Math.max(6, (availH - gap * (rows - 1)) / rows);
+	const originX = plotArea.x + leftBand;
 	const originY = plotArea.y + labelTop;
-	const todayTs = calendarNoon(cal.today !== void 0 ? toTs(cal.today) ?? Date.now() : Date.now());
-	const cells = [];
-	const monthLabels = [];
-	let prevMonth = -1;
-	for (let col = 0; col < cols; col++) {
-		const x = originX + col * (cell + gap);
-		const firstDay = new Date(firstWeek + col * 7 * CALENDAR_DAY);
-		if (firstDay.getMonth() !== prevMonth) {
-			if (col > 0 || firstDay.getDate() <= 7) monthLabels.push({
-				label: `${firstDay.getMonth() + 1}月`,
-				x
-			});
-			prevMonth = firstDay.getMonth();
-		}
-		for (let row = 0; row < 7; row++) {
-			const ts = firstWeek + (col * 7 + row) * CALENDAR_DAY;
-			if (ts < startTs || ts > endTs) continue;
-			const value = valueMap.get(ts);
-			const level = levelOf(value);
-			const d = new Date(ts);
-			cells.push({
-				ts,
-				col,
-				row,
-				x,
-				y: originY + row * (cell + gap),
-				size: cell,
-				value: typeof value === "number" ? value : null,
-				color: ramps[level],
-				today: ts === todayTs,
-				label: `${d.getFullYear()}-${calendarPad(d.getMonth() + 1)}-${calendarPad(d.getDate())}`,
-				index: cells.length
-			});
-		}
-	}
+	const cells = buckets.map((b, i) => ({
+		...b,
+		x: originX + b.col * (cellW + gap),
+		y: originY + b.row * (cellH + gap),
+		w: cellW,
+		h: cellH,
+		color: ramps[levelOf(b.value)],
+		index: i
+	}));
 	const weekdayLabels = cal.weekdayLabels || [
 		"日",
 		"一",
@@ -2223,20 +2088,26 @@ function computeCalendarLayout(plotArea, options, theme) {
 		"六"
 	];
 	const showRows = [];
-	for (let row = 0; row < 7; row++) {
+	if (gran === "day") for (let row = 0; row < 7; row++) {
 		const name = weekdayLabels[(weekStart + row) % 7];
 		if (name === "一" || name === "三" || name === "五" || cal.showAllWeekdays === true) showRows.push({
 			row,
 			name,
-			y: originY + row * (cell + gap) + cell / 2
+			y: originY + row * (cellH + gap) + cellH / 2
 		});
 	}
 	return {
 		cells,
 		cols,
-		cell,
+		rows,
+		cellW,
+		cellH,
 		gap,
-		monthLabels,
+		granularity: gran,
+		monthLabels: bucketLabels.map((m) => ({
+			label: m.label,
+			x: originX + m.col * (cellW + gap)
+		})),
 		showRows,
 		ramps,
 		originX,
@@ -2251,17 +2122,17 @@ function renderCalendarHeatmapChart(ctx) {
 	const cal = options.calendar || {};
 	layout.cells.forEach((c, i) => {
 		const colT = Math.max(0, Math.min(1, progress * 1.8 - c.col / Math.max(1, layout.cols) * .8));
-		const size = c.size * colT;
-		const offset = (c.size - size) / 2;
+		const w = c.w * colT;
+		const h = c.h * colT;
 		const isHover = i === hoverIndex;
 		canvasCtx.save();
-		roundRect(canvasCtx, c.x + offset, c.y + offset, size, size, Math.min(3, size / 4));
-		canvasCtx.fillStyle = isHover ? mixColor(c.color, .18, "#000000") : c.color;
+		roundRect(canvasCtx, c.x + (c.w - w) / 2, c.y + (c.h - h) / 2, w, h, Math.min(3, w / 4, h / 4));
+		canvasCtx.fillStyle = isHover ? mixColor(c.color, .18 * hoverAnimProgressOf(ctx), "#000000") : c.color;
 		canvasCtx.fill();
 		if (c.today) {
 			canvasCtx.strokeStyle = theme.colors[0];
 			canvasCtx.lineWidth = 1.5;
-			roundRect(canvasCtx, c.x - 1.5, c.y - 1.5, c.size + 3, c.size + 3, 4);
+			roundRect(canvasCtx, c.x - 1.5, c.y - 1.5, c.w + 3, c.h + 3, 4);
 			canvasCtx.stroke();
 		}
 		canvasCtx.restore();
@@ -2296,10 +2167,13 @@ function renderCalendarHeatmapChart(ctx) {
 		canvasCtx.restore();
 	}
 }
+function hoverAnimProgressOf(ctx) {
+	return ctx.hoverAnimProgress === void 0 ? 1 : ctx.hoverAnimProgress;
+}
 function calendarHitTest(canvasX, canvasY, plotArea, options, theme) {
 	const layout = computeCalendarLayout(plotArea, options, theme);
 	if (!layout) return null;
-	for (const c of layout.cells) if (canvasX >= c.x && canvasX <= c.x + c.size && canvasY >= c.y && canvasY <= c.y + c.size) return {
+	for (const c of layout.cells) if (canvasX >= c.x && canvasX <= c.x + c.w && canvasY >= c.y && canvasY <= c.y + c.h) return {
 		index: c.index,
 		params: {
 			seriesName: c.label,
@@ -2331,20 +2205,22 @@ function getHeatmapCategories(options) {
 	};
 }
 function renderHeatmapChart(ctx) {
-	const { ctx: canvasCtx, theme, plotArea, options, progress, hoverIndex } = ctx;
+	const { ctx: canvasCtx, theme, plotArea, options, progress, hoverIndex, hoverAnimProgress = 1 } = ctx;
+	const hovT = hoverAnimProgress;
 	const heatmapData = options.heatmapData || [];
 	if (heatmapData.length === 0) return;
 	const heatmapConfig = options.heatmap || {};
 	const colorScale = heatmapConfig.colorScale || [...CHART_COLORS.heatmapScale];
 	const { xCategories, yCategories } = getHeatmapCategories(options);
-	const values = heatmapData.map((d) => d.value);
-	const minValue = Math.min(...values);
-	const maxValue = Math.max(...values);
+	const values = heatmapData.map((d) => d.value).filter((v) => typeof v === "number" && Number.isFinite(v));
+	const minValue = values.length ? minOf(values) : 0;
+	const maxValue = values.length ? maxOf(values) : 1;
 	const valueRange = maxValue - minValue || 1;
 	const cellWidth = plotArea.width / xCategories.length;
 	const cellHeight = plotArea.height / yCategories.length;
 	function getColor(value, customColor) {
 		if (customColor) return customColor;
+		if (typeof value !== "number" || !Number.isFinite(value)) return colorScale[0];
 		const ratio = (value - minValue) / valueRange;
 		const index = Math.min(colorScale.length - 1, Math.floor(ratio * colorScale.length));
 		return colorScale[index];
@@ -2362,7 +2238,8 @@ function renderHeatmapChart(ctx) {
 		const padding = 1;
 		roundRect(canvasCtx, x + padding, y + padding, cellWidth - 2, cellHeight - 2, 3);
 		canvasCtx.fill();
-		if (isHover) {
+		if (isHover && hovT > .01) {
+			canvasCtx.globalAlpha = hovT;
 			canvasCtx.strokeStyle = theme.textColor;
 			canvasCtx.lineWidth = 2;
 			canvasCtx.stroke();
@@ -2446,10 +2323,10 @@ function candleVolumeLayout(plotArea, options, hiddenSeries) {
 * 量带绘制（K 线 / 折线分时共用）：flags 为每根的涨跌布尔（决定颜色），
 * baseY 为量带底、bandTop 为量带顶；不画轴（量纲从属），最高柱顶标 compact max。
 */
-function renderVolumeBand(ctx, volumeData, flags, baseY, bandTop, barWidth, slotWidth, plotWidth, plotX, theme, progress, hoverIndex, upColor = "#dc2626", downColor = "#16a34a") {
+function renderVolumeBand(ctx, volumeData, flags, baseY, bandTop, barWidth, slotWidth, plotWidth, plotX, theme, progress, hoverIndex, upColor = UP_COLOR, downColor = DOWN_COLOR) {
 	const { ctx: canvasCtx, hiddenSeries } = ctx;
 	if (hiddenSeries && hiddenSeries.has("成交量")) return;
-	const volMax = Math.max(...volumeData.filter((v) => Number.isFinite(v)), 1);
+	const volMax = maxOf(volumeData.filter((v) => Number.isFinite(v)), 1);
 	const bandHeight = Math.max(4, baseY - bandTop);
 	volumeData.forEach((vol, i) => {
 		if (!Number.isFinite(vol)) return;
@@ -2484,7 +2361,8 @@ function renderVolumeBand(ctx, volumeData, flags, baseY, bandTop, barWidth, slot
 * 带不画轴（量纲从属）。图例「成交量」点选后量带隐去、K 线回铺全高。
 */
 function renderCandleChart(ctx, yRange) {
-	const { ctx: canvasCtx, theme, plotArea, options, progress, hoverIndex, hiddenSeries } = ctx;
+	const { ctx: canvasCtx, theme, plotArea, options, progress, hoverIndex, hoverAnimProgress = 1, hiddenSeries } = ctx;
+	const hovT = hoverAnimProgress;
 	const candleData = options.candleData || [];
 	if (candleData.length === 0) return;
 	const upColor = options.candleUpColor || "#dc2626";
@@ -2513,9 +2391,10 @@ function renderCandleChart(ctx, yRange) {
 		const closeY = yFor(candle.close);
 		const bodyTop = Math.min(openY, closeY);
 		const bodyHeight = Math.max(1, Math.abs(closeY - openY));
-		canvasCtx.fillStyle = isHover ? color + "dd" : color;
+		canvasCtx.fillStyle = isHover ? mixColor(color, .12 * hovT, "#000000") : color;
 		canvasCtx.fillRect(x - candleWidth / 2, bodyTop, candleWidth, bodyHeight);
-		if (isHover) {
+		if (isHover && hovT > .01) {
+			canvasCtx.globalAlpha = hovT;
 			canvasCtx.strokeStyle = theme.textColor;
 			canvasCtx.lineWidth = 1.5;
 			canvasCtx.strokeRect(x - candleWidth / 2, bodyTop, candleWidth, bodyHeight);
@@ -2656,10 +2535,10 @@ function collectLegendItems(options, theme, hiddenSeries) {
 	if (options.type === "candle") {
 		const items = [];
 		if ((options.volumeData || []).length > 0) items.push({
-			name: "成交量",
-			label: fmt("成交量"),
+			name: VOLUME_SERIES_NAME,
+			label: fmt(VOLUME_SERIES_NAME),
 			color: theme.textColorSecondary,
-			hidden: hiddenSeries.has("成交量")
+			hidden: hiddenSeries.has(VOLUME_SERIES_NAME)
 		});
 		if (Array.isArray(options.candleMa)) options.candleMa.forEach((days, i) => {
 			const name = `MA${days}`;
@@ -2679,10 +2558,10 @@ function collectLegendItems(options, theme, hiddenSeries) {
 		hidden: hiddenSeries.has(s.name)
 	}));
 	if ((options.type === "line" || options.type === "area") && (options.volumeData || []).length > 0) items.push({
-		name: "成交量",
-		label: fmt("成交量"),
+		name: VOLUME_SERIES_NAME,
+		label: fmt(VOLUME_SERIES_NAME),
 		color: theme.textColorSecondary,
-		hidden: hiddenSeries.has("成交量")
+		hidden: hiddenSeries.has(VOLUME_SERIES_NAME)
 	});
 	return items;
 }
@@ -2746,12 +2625,7 @@ function computeLegendLayout(ctx, options, plotArea, containerWidth, containerHe
 	};
 }
 function estimateWidth(text) {
-	let width = 0;
-	for (const ch of text) {
-		const code = ch.codePointAt(0) || 0;
-		width += code >= 11904 && code <= 40959 || code >= 63744 && code <= 64255 || code >= 65280 && code <= 65376 || code >= 12288 && code <= 12351 ? 12 : 12 * .62;
-	}
-	return width;
+	return estimateTextWidth(text, 12);
 }
 function renderLegend(ctx) {
 	const { ctx: canvasCtx, theme, options, hiddenSeries, width, height, plotArea } = ctx;
@@ -2929,7 +2803,7 @@ function computePieMaxRadius(pieData, options, plotArea) {
 		const pct = (d.value / total * 100).toFixed(1);
 		return percentMode ? `${pct}%` : `${d.label || ""} (${pct}%)`;
 	});
-	const horizNeed = 31 + Math.max(40, ...texts.map((t) => estimateTextWidth(t, 12))) + 10;
+	const horizNeed = 31 + Math.max(40, maxOf(texts.map((t) => estimateTextWidth(t, 12)))) + 10;
 	return Math.max(30, Math.min(Math.min(plotArea.width, plotArea.height) / 2 - 20, plotArea.width / 2 - horizNeed));
 }
 function alphaHex(opacity) {
@@ -2993,14 +2867,22 @@ function renderLineChart(ctx, yRange, side = "left") {
 			points.push([x, y]);
 		});
 		allPoints.push(points.map((p) => p || [NaN, NaN]));
+		let drawPoints = points;
+		let drawIdxs = points.map((_, i) => i);
+		const columnBudget = Math.max(2, Math.floor(plotArea.width));
+		if (points.length > columnBudget * 2) {
+			const decimated = minMaxDecimatePoints(points, columnBudget);
+			drawPoints = decimated.map((e) => e.p);
+			drawIdxs = decimated.map((e) => e.i);
+		}
 		const connect = resolveConnectNulls(options, series);
 		const segments = [];
 		let currentPts = [];
 		let currentIdxs = [];
-		points.forEach((p, i) => {
+		drawPoints.forEach((p, k) => {
 			if (p) {
 				currentPts.push(p);
-				currentIdxs.push(i);
+				currentIdxs.push(drawIdxs[k]);
 			} else if (currentPts.length > 0 && !connect) {
 				segments.push({
 					pts: currentPts,
@@ -3060,7 +2942,7 @@ function renderLineChart(ctx, yRange, side = "left") {
 			canvasCtx.clip();
 			segments.forEach(({ pts: seg, idxs }) => {
 				canvasCtx.beginPath();
-				const baseValue = isStackedArea && filteredIndex > 0 ? stackedSeries.slice(0, filteredIndex).reduce((sum, s) => sum + (s.data[0] || 0), 0) : yRange.min;
+				const baseValue = isStackedArea && filteredIndex > 0 ? stackedSeries.slice(0, filteredIndex).reduce((sum, s) => sum + (s.data[idxs[0]] || 0), 0) : yRange.min;
 				const baseY = isStackedArea && filteredIndex > 0 ? plotArea.y + plotArea.height - (baseValue - yRange.min) * progress / (yRange.max - yRange.min) * plotArea.height : plotArea.y + plotArea.height;
 				canvasCtx.moveTo(seg[0][0], baseY);
 				canvasCtx.lineTo(seg[0][0], seg[0][1]);
@@ -3104,9 +2986,9 @@ function renderLineChart(ctx, yRange, side = "left") {
 		if (!series.area && options.type !== "area") canvasCtx.restore();
 		if (series.showSymbol === true && series.symbol !== "none") {
 			const baseR = series.symbolSize ?? 4;
-			points.forEach((p, i) => {
+			drawPoints.forEach((p, k) => {
 				if (!p) return;
-				const isHover = i === hoverIndex;
+				const isHover = drawIdxs[k] === hoverIndex;
 				const radius = isHover ? baseR + 2 : baseR;
 				canvasCtx.beginPath();
 				drawSymbol(canvasCtx, series.symbol, p[0], p[1], radius);
@@ -3141,7 +3023,7 @@ function renderLineChart(ctx, yRange, side = "left") {
 			canvasCtx.textBaseline = "bottom";
 			const rects = [];
 			const texts = [];
-			points.forEach((p, i) => {
+			drawPoints.forEach((p, k) => {
 				if (!p) {
 					rects.push({
 						x: 0,
@@ -3152,7 +3034,7 @@ function renderLineChart(ctx, yRange, side = "left") {
 					texts.push("");
 					return;
 				}
-				const text = valueFormatter(series.data[i]);
+				const text = valueFormatter(series.data[drawIdxs[k]]);
 				const w = canvasCtx.measureText(text).width;
 				rects.push({
 					x: p[0] - w / 2 - 2,
@@ -3163,8 +3045,8 @@ function renderLineChart(ctx, yRange, side = "left") {
 				texts.push(text);
 			});
 			const visible = layoutLabelsAvoidOverlap(rects);
-			points.forEach((p, i) => {
-				if (p && visible[i]) canvasCtx.fillText(texts[i], p[0], p[1] - 8);
+			drawPoints.forEach((p, k) => {
+				if (p && visible[k]) canvasCtx.fillText(texts[k], p[0], p[1] - 8);
 			});
 			canvasCtx.restore();
 		}
@@ -3173,7 +3055,8 @@ function renderLineChart(ctx, yRange, side = "left") {
 	return allPoints;
 }
 function renderBarChart(ctx, yRange, stacked = false) {
-	const { ctx: canvasCtx, theme, plotArea, options, progress, hoverIndex, hiddenSeries, valueFormatter } = ctx;
+	const { ctx: canvasCtx, theme, plotArea, options, progress, hoverIndex, hoverAnimProgress = 1, hiddenSeries, valueFormatter } = ctx;
+	const hovT = hoverAnimProgress;
 	const visibleSeries = (options.series || []).filter((s) => !hiddenSeries.has(s.name));
 	if (visibleSeries.length === 0) return;
 	const labels = options.labels || [];
@@ -3245,10 +3128,11 @@ function renderBarChart(ctx, yRange, stacked = false) {
 						canvasCtx.beginPath();
 						canvasCtx.rect(barX, seg.y, barWidth, seg.height);
 					}
-					canvasCtx.fillStyle = isHover ? seg.color + "dd" : seg.color;
+					canvasCtx.fillStyle = isHover ? mixColor(seg.color, .12 * hovT, "#000000") : seg.color;
 					canvasCtx.fill();
-					if (isHover && (seg.isTopPositive || seg.isBottomNegative)) {
-						canvasCtx.fillStyle = "rgba(255, 255, 255, 0.3)";
+					if (isHover && hovT > .01 && (seg.isTopPositive || seg.isBottomNegative)) {
+						canvasCtx.globalAlpha = seg.alpha * .3 * hovT;
+						canvasCtx.fillStyle = "#ffffff";
 						const stripY = seg.value >= 0 ? seg.y : seg.y + seg.height - Math.min(6, seg.height);
 						canvasCtx.fillRect(barX, stripY, barWidth, Math.min(6, seg.height));
 					}
@@ -3300,10 +3184,11 @@ function renderBarChart(ctx, yRange, stacked = false) {
 				canvasCtx.globalAlpha = alpha;
 				if (barHeight > .5) {
 					drawRoundedBarEnd(canvasCtx, x, barTop, barWidth, barHeight, borderRadius, value >= 0 ? "top" : "bottom");
-					canvasCtx.fillStyle = isHover ? color + "dd" : color;
+					canvasCtx.fillStyle = isHover ? mixColor(color, .12 * hovT, "#000000") : color;
 					canvasCtx.fill();
-					if (isHover) {
-						canvasCtx.fillStyle = "rgba(255, 255, 255, 0.3)";
+					if (isHover && hovT > .01) {
+						canvasCtx.globalAlpha = .3 * hovT;
+						canvasCtx.fillStyle = "#ffffff";
 						const stripY = value >= 0 ? barTop : barTop + barHeight - Math.min(10, barHeight);
 						canvasCtx.fillRect(x, stripY, barWidth, Math.min(10, barHeight));
 					}
@@ -3365,7 +3250,8 @@ function drawRoundedBarEnd(canvasCtx, x, y, width, height, radius, end) {
 	canvasCtx.closePath();
 }
 function renderHorizontalBarChart(ctx, xRange) {
-	const { ctx: canvasCtx, theme, plotArea, options, progress, hoverIndex, hiddenSeries, valueFormatter } = ctx;
+	const { ctx: canvasCtx, theme, plotArea, options, progress, hoverIndex, hoverAnimProgress = 1, hiddenSeries, valueFormatter } = ctx;
+	const hovT = hoverAnimProgress;
 	const visibleSeries = (options.series || []).filter((s) => !hiddenSeries.has(s.name));
 	if (visibleSeries.length === 0) return;
 	const seriesCount = visibleSeries.length;
@@ -3410,10 +3296,11 @@ function renderHorizontalBarChart(ctx, xRange) {
 					canvasCtx.lineTo(barLeft + barWidth, y + barHeight);
 				}
 				canvasCtx.closePath();
-				canvasCtx.fillStyle = isHover ? color + "dd" : color;
+				canvasCtx.fillStyle = isHover ? mixColor(color, .12 * hovT, "#000000") : color;
 				canvasCtx.fill();
-				if (isHover) {
-					canvasCtx.fillStyle = "rgba(255, 255, 255, 0.3)";
+				if (isHover && hovT > .01) {
+					canvasCtx.globalAlpha = .3 * hovT;
+					canvasCtx.fillStyle = "#ffffff";
 					const stripX = value >= 0 ? barLeft + barWidth - Math.min(10, barWidth) : barLeft;
 					canvasCtx.fillRect(stripX, y, Math.min(10, barWidth), barHeight);
 				}
@@ -3434,15 +3321,7 @@ function renderHorizontalBarChart(ctx, xRange) {
 	(options.labels || []).forEach((label, i) => {
 		const y = plotArea.y + plotArea.height - (i + .5) * categoryWidth;
 		let formattedLabel = options.yAxis?.formatter ? options.yAxis.formatter(label) : label;
-		if (canvasCtx.measureText(formattedLabel).width > maxCatWidth) {
-			let lo = 0, hi = formattedLabel.length;
-			while (lo < hi) {
-				const mid = Math.ceil((lo + hi) / 2);
-				if (canvasCtx.measureText(formattedLabel.slice(0, mid) + "…").width > maxCatWidth) hi = mid - 1;
-				else lo = mid;
-			}
-			formattedLabel = formattedLabel.slice(0, lo) + "…";
-		}
+		formattedLabel = truncateLabel(canvasCtx, formattedLabel, maxCatWidth);
 		canvasCtx.fillText(formattedLabel, plotArea.x - 10, y);
 	});
 	canvasCtx.restore();
@@ -3494,7 +3373,7 @@ function renderPieChart(ctx, isDoughnut, isRose = false) {
 	const centerX = plotArea.x + plotArea.width / 2;
 	const centerY = plotArea.y + plotArea.height / 2;
 	const maxRadius = computePieMaxRadius(pieData, options, plotArea);
-	const innerRadius = isDoughnut ? Math.max(0, Math.min(maxRadius - 5, maxRadius * (options.innerRadius || .6))) : 0;
+	const innerRadius = isDoughnut ? doughnutInnerRadius(maxRadius, options) : 0;
 	let startAngle = -Math.PI / 2;
 	const labelItems = [];
 	pieData.forEach((data, index) => {
@@ -3502,7 +3381,7 @@ function renderPieChart(ctx, isDoughnut, isRose = false) {
 		const sliceAngle = data.value / total * Math.PI * 2 * progress;
 		const endAngle = startAngle + sliceAngle;
 		const isHover = index === hoverIndex;
-		const roseRadius = isRose ? maxRadius * Math.sqrt(data.value / Math.max(...pieData.map((d) => d.value))) : maxRadius;
+		const roseRadius = isRose ? maxRadius * Math.sqrt(data.value / maxOf(pieData.map((d) => d.value))) : maxRadius;
 		const hoverDistance = isRose ? Math.max(10, roseRadius * .15) : 12;
 		const offset = isHover ? hoverDistance * hoverAnimProgress : 0;
 		const radius = isRose ? roseRadius * progress : maxRadius;
@@ -3569,10 +3448,13 @@ function renderPieChart(ctx, isDoughnut, isRose = false) {
 		canvasCtx.restore();
 	}
 }
+function doughnutInnerRadius(maxRadius, options) {
+	return Math.max(0, Math.min(maxRadius - 5, maxRadius * (options.innerRadius || .6)));
+}
 function createScatterScale(scatterData, yRange, plotArea) {
-	const xValues = scatterData.map((d) => d.x);
-	const xMin = Math.min(...xValues);
-	const xMax = Math.max(...xValues);
+	const xValues = scatterData.map((d) => d.x).filter((v) => typeof v === "number" && Number.isFinite(v));
+	const xMin = xValues.length ? minOf(xValues) : 0;
+	const xMax = xValues.length ? maxOf(xValues) : 1;
 	const xRange = xMax - xMin || 1;
 	const xPadding = xRange * .05;
 	const yPadding = (yRange.max - yRange.min) * .05;
@@ -3776,12 +3658,12 @@ function computeFacetGrids(scatterData, plotArea, options) {
 			const col = i % cols;
 			const row = Math.floor(i / cols);
 			const data = grouped.get(name);
-			const xs = data.map((d) => d.x);
-			const ys = data.map((d) => d.y);
-			const xMin = Math.min(...xs);
-			const xMax = Math.max(...xs);
-			const yMin = Math.min(...ys);
-			const yMax = Math.max(...ys);
+			const xs = data.map((d) => d.x).filter((v) => typeof v === "number" && Number.isFinite(v));
+			const ys = data.map((d) => d.y).filter((v) => typeof v === "number" && Number.isFinite(v));
+			const xMin = xs.length ? minOf(xs) : 0;
+			const xMax = xs.length ? maxOf(xs) : 1;
+			const yMin = ys.length ? minOf(ys) : 0;
+			const yMax = ys.length ? maxOf(ys) : 1;
 			const xPad = (xMax - xMin || 1) * .08;
 			const yPad = (yMax - yMin || 1) * .08;
 			const outer = {
@@ -3855,7 +3737,7 @@ function renderScatterFacetChart(ctx, yRange) {
 			const y = area.y + area.height - (area.y + area.height - finalY) * yFactor;
 			const globalIdx = scatterData.indexOf(point);
 			const size = (point.size || 5) * Math.min(yFactor * 1.5, 1);
-			const color = point.color || theme.colors[i % theme.colors.length];
+			const color = point.color || theme.colors[globalIdx % theme.colors.length];
 			const isHover = globalIdx === hoverIndex;
 			canvasCtx.beginPath();
 			canvasCtx.arc(x, y, isHover ? size + 2 : size, 0, Math.PI * 2);
@@ -3900,8 +3782,8 @@ function matrixFieldExtent(records, field) {
 		min: 0,
 		max: 1
 	};
-	const min = Math.min(...values);
-	const max = Math.max(...values);
+	const min = minOf(values);
+	const max = maxOf(values);
 	const pad = (max - min || 1) * .08;
 	return {
 		min: min - pad,
@@ -4134,26 +4016,11 @@ function renderRadarChart(ctx) {
 	if (options.radarRingFill === true) {
 		canvasCtx.save();
 		canvasCtx.fillStyle = theme.gridColor;
-		canvasCtx.globalAlpha = .45;
-		for (let level = 1; level <= 5; level += 2) {
-			const outer = radius * level / 5;
-			const inner = radius * (level - 1) / 5;
+		for (let level = 5; level >= 1; level--) {
+			canvasCtx.globalAlpha = level % 2 === 1 ? .5 : .22;
 			canvasCtx.beginPath();
-			for (let i = 0; i <= indicators.length; i++) {
-				const angle = i * angleStep - Math.PI / 2;
-				const x = centerX + Math.cos(angle) * outer;
-				const y = centerY + Math.sin(angle) * outer;
-				if (i === 0) canvasCtx.moveTo(x, y);
-				else canvasCtx.lineTo(x, y);
-			}
-			canvasCtx.closePath();
-			canvasCtx.moveTo(centerX + inner, centerY);
-			for (let i = indicators.length; i >= 0; i--) {
-				const angle = i * angleStep - Math.PI / 2;
-				canvasCtx.lineTo(centerX + Math.cos(angle) * inner, centerY + Math.sin(angle) * inner);
-			}
-			canvasCtx.closePath();
-			canvasCtx.fill("evenodd");
+			canvasCtx.arc(centerX, centerY, radius * level / 5, 0, Math.PI * 2);
+			canvasCtx.fill();
 		}
 		canvasCtx.restore();
 	}
@@ -4355,10 +4222,13 @@ function computeBins(options, hiddenSeries) {
 	const binConfig = options.binConfig || {};
 	const visibleSeries = (options.series || []).filter((s) => !hiddenSeries.has(s.name));
 	const allValues = [];
-	visibleSeries.forEach((s) => allValues.push(...s.data.filter((v) => !isMissingValue(v))));
+	visibleSeries.forEach((s) => {
+		const data = s.data || [];
+		for (let i = 0; i < data.length; i++) if (!isMissingValue(data[i])) allValues.push(data[i]);
+	});
 	if (allValues.length === 0) return null;
-	const dataMin = Math.min(...allValues);
-	const range = Math.max(...allValues) - dataMin || 1;
+	const dataMin = minOf(allValues);
+	const range = maxOf(allValues) - dataMin || 1;
 	let bins;
 	if (binConfig.bins && binConfig.bins.length > 1) bins = binConfig.bins;
 	else {
@@ -4388,7 +4258,7 @@ function renderBinChart(ctx) {
 	const { bins, frequencies, displayValues } = result;
 	const dataMin = bins[0];
 	const range = bins[bins.length - 1] - dataMin || 1;
-	const maxFreq = Math.max(...displayValues, 1);
+	const maxFreq = maxOf(displayValues, 1);
 	const binCount = bins.length - 1;
 	const barGap = 2;
 	const barWidth = (plotArea.width - barGap * (binCount - 1)) / binCount;
@@ -4451,8 +4321,8 @@ function renderBulletChart(ctx) {
 			allValues.push(r.from, r.to);
 		});
 	});
-	const maxVal = Math.max(...allValues, 0);
-	const minVal = Math.min(...allValues, 0);
+	const maxVal = maxOf(allValues, 0);
+	const minVal = minOf(allValues, 0);
 	const range = maxVal - minVal || 1;
 	const padMin = minVal >= 0 ? 0 : minVal - range * .1;
 	const padMax = maxVal + range * .1;
@@ -4665,8 +4535,8 @@ function renderSparklineChart(ctx) {
 		if (data.length === 0) return;
 		const valid = data.filter((v) => !isMissingValue(v));
 		if (valid.length === 0) return;
-		const min = Math.min(...valid);
-		const range = Math.max(...valid) - min || 1;
+		const min = minOf(valid);
+		const range = maxOf(valid) - min || 1;
 		const points = [];
 		const pointByIndex = [];
 		data.forEach((v, i) => {
@@ -4761,40 +4631,27 @@ function renderSparklineChart(ctx) {
 //#endregion
 //#region src/renderer/charts-extra.js
 function renderWaterfallChart(ctx, yRange) {
-	const { ctx: canvasCtx, theme, plotArea, options, progress, hoverIndex, valueFormatter, hiddenSeries } = ctx;
+	const { ctx: canvasCtx, theme, plotArea, options, progress, hoverIndex, hoverAnimProgress = 1, valueFormatter, hiddenSeries } = ctx;
+	const hovT = hoverAnimProgress;
 	const wf = options.waterfall || {};
 	const labels = options.labels || [];
 	const deltas = (options.series || []).filter((s) => !hiddenSeries.has(s.name))[0]?.data || [];
 	if (labels.length === 0 || deltas.length === 0) return;
-	const totalIdx = new Set(wf.totalIndices || []);
+	new Set(wf.totalIndices || []);
 	const increaseColor = wf.increaseColor || "#dc2626";
 	const decreaseColor = wf.decreaseColor || "#16a34a";
 	const totalColor = wf.totalColor || theme.colors[0];
 	const categoryWidth = plotArea.width / labels.length;
 	const barWidth = Math.min(categoryWidth * .6, 64);
 	const yFor = (v) => plotArea.y + plotArea.height - (v - yRange.min) / (yRange.max - yRange.min) * plotArea.height;
-	let cumulative = 0;
+	const steps = waterfallSteps(deltas, wf.totalIndices);
 	let prevEdgeX = null;
 	let prevExitY = null;
 	labels.forEach((_, i) => {
-		const raw = deltas[i];
-		if (isMissingValue(raw)) return;
-		const v = raw;
-		const isTotal = totalIdx.has(i);
-		let from;
-		let to;
-		let color;
-		if (isTotal) {
-			from = 0;
-			to = v;
-			cumulative = v;
-			color = totalColor;
-		} else {
-			from = cumulative;
-			to = cumulative + v;
-			cumulative = to;
-			color = v >= 0 ? increaseColor : decreaseColor;
-		}
+		const step = steps[i];
+		if (!step || step.missing) return;
+		const { from, to, isTotal } = step;
+		const color = isTotal ? totalColor : step.value >= 0 ? increaseColor : decreaseColor;
 		const cx = plotArea.x + (i + .5) * categoryWidth;
 		const x = cx - barWidth / 2;
 		const isHover = i === hoverIndex;
@@ -4825,12 +4682,13 @@ function renderWaterfallChart(ctx, yRange) {
 			canvasCtx.quadraticCurveTo(x + barWidth, top, x + barWidth, top + r);
 			canvasCtx.lineTo(x + barWidth, top + height);
 			canvasCtx.closePath();
-			canvasCtx.fillStyle = isHover ? color + "dd" : color;
+			canvasCtx.fillStyle = isHover ? mixColor(color, .12 * hovT, "#000000") : color;
 			canvasCtx.fill();
-		}
-		if (isHover && height > .5) {
-			canvasCtx.fillStyle = "rgba(255, 255, 255, 0.3)";
-			canvasCtx.fillRect(x, top, barWidth, Math.min(6, height));
+			if (isHover && hovT > .01) {
+				canvasCtx.globalAlpha = .3 * hovT;
+				canvasCtx.fillStyle = "#ffffff";
+				canvasCtx.fillRect(x, top, barWidth, Math.min(6, height));
+			}
 		}
 		canvasCtx.restore();
 		if (options.showValues && progress > .9 && height > .5) {
@@ -4839,11 +4697,11 @@ function renderWaterfallChart(ctx, yRange) {
 			canvasCtx.font = "11px Inter, sans-serif";
 			canvasCtx.textAlign = "center";
 			canvasCtx.textBaseline = "bottom";
-			canvasCtx.fillText(valueFormatter(v), cx, top - 4);
+			canvasCtx.fillText(valueFormatter(step.value), cx, top - 4);
 			canvasCtx.restore();
 		}
 		prevEdgeX = x + barWidth;
-		prevExitY = yFor(cumulative);
+		prevExitY = yFor(step.to);
 	});
 }
 /**
@@ -4927,7 +4785,8 @@ function computeBoxplotGeometry(plotArea, options, theme, hiddenSeries, valueRan
 	};
 }
 function renderBoxplotChart(ctx, yRange) {
-	const { ctx: canvasCtx, theme, plotArea, options, progress, hoverIndex, hiddenSeries } = ctx;
+	const { ctx: canvasCtx, theme, plotArea, options, progress, hoverIndex, hoverAnimProgress = 1, hiddenSeries } = ctx;
+	const hovT = hoverAnimProgress;
 	const geo = computeBoxplotGeometry(plotArea, options, theme, hiddenSeries, yRange);
 	if (!geo) return;
 	const { boxes, horizontal } = geo;
@@ -4935,7 +4794,9 @@ function renderBoxplotChart(ctx, yRange) {
 		box.b;
 		const isHover = box.index === hoverIndex;
 		const color = box.color;
-		const lineWidth = isHover ? 2 : 1.5;
+		const lineWidth = 1.5 + .5 * (isHover ? hovT : 0);
+		const fillAlpha = .2 + .13 * (isHover ? hovT : 0);
+		const fillHex = Math.round(fillAlpha * 255).toString(16).padStart(2, "0");
 		canvasCtx.save();
 		canvasCtx.strokeStyle = color;
 		canvasCtx.fillStyle = color;
@@ -4958,10 +4819,10 @@ function renderBoxplotChart(ctx, yRange) {
 			canvasCtx.moveTo(wHi, yMed - cap / 2);
 			canvasCtx.lineTo(wHi, yMed + cap / 2);
 			canvasCtx.stroke();
-			canvasCtx.fillStyle = color + (isHover ? "55" : "33");
+			canvasCtx.fillStyle = color + fillHex;
 			canvasCtx.fillRect(qLo, yLo, Math.max(1, qHi - qLo), box.thickness);
 			canvasCtx.strokeRect(qLo, yLo, Math.max(1, qHi - qLo), box.thickness);
-			canvasCtx.lineWidth = isHover ? 2.5 : 2;
+			canvasCtx.lineWidth = 2 + .5 * (isHover ? hovT : 0);
 			canvasCtx.beginPath();
 			canvasCtx.moveTo(box.cx + (box.med - box.cx) * progress, yLo);
 			canvasCtx.lineTo(box.cx + (box.med - box.cx) * progress, yLo + box.thickness);
@@ -4969,7 +4830,7 @@ function renderBoxplotChart(ctx, yRange) {
 			box.outliers.forEach((o) => {
 				const ox = box.cx + (o - box.cx) * progress;
 				canvasCtx.beginPath();
-				canvasCtx.arc(ox, yMed, isHover ? 3.5 : 2.5, 0, Math.PI * 2);
+				canvasCtx.arc(ox, yMed, 2.5 + (isHover ? hovT : 0), 0, Math.PI * 2);
 				canvasCtx.fillStyle = color;
 				canvasCtx.fill();
 			});
@@ -4999,10 +4860,10 @@ function renderBoxplotChart(ctx, yRange) {
 			canvasCtx.moveTo(box.cx - box.capWidth / 2, yMax);
 			canvasCtx.lineTo(box.cx + box.capWidth / 2, yMax);
 			canvasCtx.stroke();
-			canvasCtx.fillStyle = color + (isHover ? "55" : "33");
+			canvasCtx.fillStyle = color + fillHex;
 			canvasCtx.fillRect(xLo, yQ3, box.thickness, Math.max(1, yQ1 - yQ3));
 			canvasCtx.strokeRect(xLo, yQ3, box.thickness, Math.max(1, yQ1 - yQ3));
-			canvasCtx.lineWidth = isHover ? 2.5 : 2;
+			canvasCtx.lineWidth = 2 + .5 * (isHover ? hovT : 0);
 			canvasCtx.beginPath();
 			canvasCtx.moveTo(xLo, yMed);
 			canvasCtx.lineTo(xLo + box.thickness, yMed);
@@ -5010,7 +4871,7 @@ function renderBoxplotChart(ctx, yRange) {
 			box.outliers.forEach((o) => {
 				const oy = box.cy + (o - box.cy) * progress;
 				canvasCtx.beginPath();
-				canvasCtx.arc(box.cx, oy, isHover ? 3.5 : 2.5, 0, Math.PI * 2);
+				canvasCtx.arc(box.cx, oy, 2.5 + (isHover ? hovT : 0), 0, Math.PI * 2);
 				canvasCtx.fillStyle = color;
 				canvasCtx.fill();
 			});
@@ -5036,15 +4897,7 @@ function renderBoxplotChart(ctx, yRange) {
 			seen.add(box.catIndex);
 			let label = box.b.label;
 			const maxWidth = geo.categoryWidth - 8;
-			if (canvasCtx.measureText(label).width > maxWidth) {
-				let lo = 0, hi = label.length;
-				while (lo < hi) {
-					const mid = Math.ceil((lo + hi) / 2);
-					if (canvasCtx.measureText(label.slice(0, mid) + "…").width > maxWidth) hi = mid - 1;
-					else lo = mid;
-				}
-				label = label.slice(0, lo) + "…";
-			}
+			label = truncateLabel(canvasCtx, label, maxWidth);
 			const cx = plotArea.x + (box.catIndex + .5) * geo.categoryWidth;
 			canvasCtx.fillText(label, cx, plotArea.y + plotArea.height + 8);
 		});
@@ -5061,15 +4914,7 @@ function renderBoxplotChart(ctx, yRange) {
 			seen.add(box.catIndex);
 			let label = box.b.label;
 			const maxWidth = plotArea.x - 12;
-			if (canvasCtx.measureText(label).width > maxWidth) {
-				let lo = 0, hi = label.length;
-				while (lo < hi) {
-					const mid = Math.ceil((lo + hi) / 2);
-					if (canvasCtx.measureText(label.slice(0, mid) + "…").width > maxWidth) hi = mid - 1;
-					else lo = mid;
-				}
-				label = label.slice(0, lo) + "…";
-			}
+			label = truncateLabel(canvasCtx, label, maxWidth);
 			const cy = plotArea.y + plotArea.height - (box.catIndex + .5) * geo.categoryWidth;
 			canvasCtx.fillText(label, plotArea.x - 10, cy);
 		});
@@ -5202,6 +5047,10 @@ function computeSunburstGeometry(plotArea, options, theme, valueFormatter) {
 		valueFormatter
 	};
 }
+/** 能用正文色（浅色主题近黑）就用正文色，底色深到不可读才反白（用户定则） */
+function sunburstLabelColor(bg, theme) {
+	return isLightColor(bg) ? theme.textColor : getContrastText(bg);
+}
 function renderSunburstChart(ctx) {
 	const { ctx: canvasCtx, theme, plotArea, options, progress, hoverIndex, valueFormatter, hoverAnimProgress = 1 } = ctx;
 	const geo = computeSunburstGeometry(plotArea, options, theme, valueFormatter);
@@ -5249,7 +5098,7 @@ function renderSunburstChart(ctx) {
 			name,
 			value,
 			bold: seg.depth === 0,
-			fill: getContrastText(color),
+			fill: sunburstLabelColor(color, theme),
 			alpha: alphaAt(i)
 		});
 	});
@@ -5274,7 +5123,8 @@ function renderSunburstChart(ctx) {
 	});
 }
 function renderMixedChart(ctx, leftRange, rightRange) {
-	const { ctx: canvasCtx, theme, plotArea, options, progress, hoverIndex, hiddenSeries } = ctx;
+	const { ctx: canvasCtx, theme, plotArea, options, progress, hoverIndex, hoverAnimProgress = 1, hiddenSeries } = ctx;
+	const hovT = hoverAnimProgress;
 	const labels = options.labels || [];
 	const barSeries = (options.series || []).filter((s) => !hiddenSeries.has(s.name)).filter((s) => (s.chartType || "line") === "bar");
 	if (barSeries.length > 0 && labels.length > 0) {
@@ -5309,7 +5159,7 @@ function renderMixedChart(ctx, leftRange, rightRange) {
 					canvasCtx.quadraticCurveTo(x + barWidth, barTop, x + barWidth, barTop + r);
 					canvasCtx.lineTo(x + barWidth, barTop + barHeight);
 					canvasCtx.closePath();
-					canvasCtx.fillStyle = isHover ? color + "dd" : color + "cc";
+					canvasCtx.fillStyle = isHover ? mixColor(color, .12 * hovT, "#000000") + "cc" : color + "cc";
 					canvasCtx.fill();
 					canvasCtx.restore();
 				}
@@ -5356,10 +5206,7 @@ function computeSankeyLayout(plotArea, options, theme, hiddenSeries) {
 		outSum.set(l.source, (outSum.get(l.source) || 0) + l.value);
 		inSum.set(l.target, (inSum.get(l.target) || 0) + l.value);
 	});
-	allNodes.forEach((n) => {
-		if (typeof n.value === "number" && n.value > 0) return;
-		n.value = Math.max(inSum.get(n.name) || 0, outSum.get(n.name) || 0);
-	});
+	const nodeValues = new Map(allNodes.map((n) => [n.name, typeof n.value === "number" && n.value > 0 ? n.value : Math.max(inSum.get(n.name) || 0, outSum.get(n.name) || 0)]));
 	const depth = new Map(allNodes.map((n) => [n.name, 0]));
 	for (let round = 0; round < allNodes.length; round++) {
 		let changed = false;
@@ -5372,8 +5219,14 @@ function computeSankeyLayout(plotArea, options, theme, hiddenSeries) {
 		});
 		if (!changed) break;
 	}
-	const maxDepth = Math.max(...depth.values());
-	const valueMax = Math.max(1, ...allNodes.map((n) => n.value || 0), ...links.map((l) => l.value));
+	const maxDepth = maxOf([...depth.values()]);
+	if ((options.sankey?.nodeAlign ?? "justify") === "justify") {
+		const hasOut = new Set(links.map((l) => l.source));
+		allNodes.forEach((n) => {
+			if (!hasOut.has(n.name)) depth.set(n.name, maxDepth);
+		});
+	}
+	const valueMax = Math.max(1, maxOf([...nodeValues.values()]), maxOf(links.map((l) => l.value)));
 	const columnCount = maxDepth + 1;
 	const scale = (plotArea.height * .82 - NODE_GAP * Math.max(0, columnCount - 1)) / valueMax;
 	const xOfColumn = (col) => plotArea.x + col * (plotArea.width - 14) / Math.max(1, columnCount - 1);
@@ -5383,8 +5236,8 @@ function computeSankeyLayout(plotArea, options, theme, hiddenSeries) {
 		color: n.color || theme.colors[i % theme.colors.length],
 		col: depth.get(n.name) || 0,
 		x: xOfColumn(depth.get(n.name) || 0),
-		value: n.value || 0,
-		height: Math.max(2, (n.value || 0) * scale)
+		value: nodeValues.get(n.name) || 0,
+		height: Math.max(2, (nodeValues.get(n.name) || 0) * scale)
 	}));
 	const byCol = /* @__PURE__ */ new Map();
 	nodes.forEach((n) => {
@@ -5527,8 +5380,7 @@ function renderSankeyChart(ctx) {
 	});
 }
 /** 桑基命中：先节点矩形、后流带（平滑步进插值带内即命中） */
-function sankeyHitTest(canvasX, canvasY, plotArea, options, theme, hiddenSeries) {
-	const layout = computeSankeyLayout(plotArea, options, theme, hiddenSeries);
+function sankeyHitTest(canvasX, canvasY, plotArea, options, theme, hiddenSeries, layout = computeSankeyLayout(plotArea, options, theme, hiddenSeries)) {
 	if (!layout) return null;
 	const { nodes, ribbons } = layout;
 	for (let i = 0; i < nodes.length; i++) {
@@ -5575,9 +5427,10 @@ function computeVennLayout(plotArea, options, theme) {
 	})).filter((d) => d.sets.length === 1);
 	if (circles.length === 0 || circles.length > 3) return null;
 	const interRows = rows.filter((d) => d.sets && d.sets.length === 2);
-	const valueMax = Math.max(...circles.map((d) => d.value || 0));
+	const valueMax = maxOf(circles.map((d) => d.value || 0));
 	if (!(valueMax > 0)) return null;
-	const R = Math.min(plotArea.width, plotArea.height) * .38;
+	const setCount = circles.length;
+	const R = Math.min(plotArea.height * (setCount >= 3 ? .3 : .46), plotArea.width * (setCount >= 3 ? .2 : .24));
 	const k = R * R / valueMax;
 	const radiusOf = (v) => Math.sqrt((v || 0) * k / Math.PI);
 	circles.forEach((c, i) => {
@@ -5698,7 +5551,8 @@ function renderVennChart(ctx) {
 		if (progress < .9) return;
 		canvasCtx.save();
 		canvasCtx.font = "600 12px Inter, sans-serif";
-		canvasCtx.fillStyle = layout.hollow ? theme.textColor : getContrastText(c.color);
+		const labelColor = isLightColor(c.color) ? theme.textColor : getContrastText(c.color);
+		canvasCtx.fillStyle = layout.hollow ? theme.textColor : labelColor;
 		canvasCtx.textAlign = "center";
 		canvasCtx.textBaseline = "middle";
 		canvasCtx.fillText(c.name, c.x, c.y - c.r * .4);
@@ -5775,7 +5629,7 @@ function computeChordLayout(plotArea, options, theme, hiddenSeries) {
 	const cy = plotArea.y + plotArea.height / 2;
 	const R = Math.max(40, Math.min(plotArea.width, plotArea.height) / 2 - 30);
 	const mode = options.chordMode === "curve" ? "curve" : "band";
-	const valueMax = Math.max(1, ...links.map((l) => l.value));
+	const valueMax = Math.max(1, maxOf(links.map((l) => l.value)));
 	const byValue = options.chordByValue === true;
 	const nodeValue = (n) => {
 		if (byValue) {
@@ -5814,8 +5668,8 @@ function computeChordLayout(plotArea, options, theme, hiddenSeries) {
 			const src = arcByName.get(link.source);
 			const tgt = arcByName.get(link.target);
 			const angularW = link.value / valueMax * (R * .14) / R;
-			const s0 = src.startAngle + (outOffset.get(src.name) || 0);
-			const t0 = tgt.startAngle + (outOffset.get(tgt.name) || 0);
+			const s0 = mode === "curve" ? src.midAngle : src.startAngle + (outOffset.get(src.name) || 0);
+			const t0 = mode === "curve" ? tgt.midAngle : tgt.startAngle + (outOffset.get(tgt.name) || 0);
 			outOffset.set(src.name, (outOffset.get(src.name) || 0) + angularW);
 			outOffset.set(tgt.name, (outOffset.get(tgt.name) || 0) + angularW);
 			const [ax, ay] = polar(s0, R);
@@ -5998,9 +5852,11 @@ function chordHitTest(canvasX, canvasY, plotArea, options, theme, hiddenSeries)
 function computeArcLayout(plotArea, options, theme, hiddenSeries) {
 	const { nodes, links } = normalizeRelation(options.arcData, hiddenSeries);
 	if (nodes.length === 0) return null;
-	const axisY = plotArea.y + Math.max(30, (plotArea.height - 40) * .52);
+	const labelBand = 30;
+	const topGap = 24;
+	const axisY = plotArea.y + Math.max(40, plotArea.height - labelBand);
 	const step = plotArea.width / nodes.length;
-	const valueMax = Math.max(1, ...links.map((l) => l.value));
+	const valueMax = Math.max(1, maxOf(links.map((l) => l.value)));
 	const nodePts = nodes.map((n, i) => ({
 		node: n,
 		name: n.name,
@@ -6018,7 +5874,7 @@ function computeArcLayout(plotArea, options, theme, hiddenSeries) {
 			const dist = Math.abs(b.x - a.x);
 			const left = a.x <= b.x ? a : b;
 			const right = a.x <= b.x ? b : a;
-			const cy = Math.min(dist * .45, (axisY - plotArea.y - 12) / .75);
+			const cy = Math.min(dist * .45, (axisY - plotArea.y - topGap) / .75);
 			const width = 1.5 + link.value / valueMax * 4.5;
 			const samples = [];
 			const x1 = left.x;
@@ -6090,18 +5946,9 @@ function renderArcChart(ctx) {
 		canvasCtx.lineTo(n.x, axisY + 16);
 		canvasCtx.stroke();
 		if (progress >= .9) {
-			let label = n.name;
 			canvasCtx.font = "12px Inter, sans-serif";
 			const maxW = plotArea.width / nodes.length - 6;
-			if (canvasCtx.measureText(label).width > maxW) {
-				let lo = 0, hi = label.length;
-				while (lo < hi) {
-					const mid = Math.ceil((lo + hi) / 2);
-					if (canvasCtx.measureText(label.slice(0, mid) + "…").width > maxW) hi = mid - 1;
-					else lo = mid;
-				}
-				label = label.slice(0, lo) + "…";
-			}
+			const label = truncateLabel(canvasCtx, n.name, maxW);
 			canvasCtx.fillStyle = theme.textColorSecondary;
 			canvasCtx.textAlign = "center";
 			canvasCtx.textBaseline = "top";
@@ -6173,11 +6020,11 @@ function computeGanttLayout(plotArea, options, theme, hiddenSeries, valueFormatt
 		endTs: toTs(t.end)
 	})).filter((t) => t.startTs !== null && t.endTs !== null);
 	if (parsed.length === 0) return null;
-	const labelW = Math.max(LABEL_MIN, Math.min(LABEL_MAX, Math.round(Math.max(...parsed.map((t) => estimateTextWidth(t.name || "", 12))) + 16)));
+	const labelW = Math.max(LABEL_MIN, Math.min(LABEL_MAX, Math.round(maxOf(parsed.map((t) => estimateTextWidth(t.name || "", 12))) + 16)));
 	const chartX = plotArea.x;
 	const chartW = plotArea.width;
-	let tmin = Math.min(...parsed.map((t) => Math.min(t.startTs, t.endTs)));
-	let tmax = Math.max(...parsed.map((t) => Math.max(t.startTs, t.endTs)));
+	let tmin = minOf(parsed.map((t) => Math.min(t.startTs, t.endTs)));
+	let tmax = maxOf(parsed.map((t) => Math.max(t.startTs, t.endTs)));
 	if (options.ganttToday) {
 		const today = toTs(options.ganttToday);
 		if (today !== null) {
@@ -6238,7 +6085,7 @@ function computeGanttLayout(plotArea, options, theme, hiddenSeries, valueFormatt
 	};
 }
 function renderGanttChart(ctx) {
-	const { ctx: canvasCtx, theme, plotArea, options, progress, hoverIndex, hiddenSeries } = ctx;
+	const { ctx: canvasCtx, theme, plotArea, options, progress, hoverIndex, hoverAnimProgress = 1, hiddenSeries } = ctx;
 	const layout = computeGanttLayout(plotArea, options, theme, hiddenSeries);
 	if (!layout) return;
 	const { rows, deps, chartX, chartW, rowH, barH } = layout;
@@ -6253,6 +6100,7 @@ function renderGanttChart(ctx) {
 	});
 	if (hoverIndex >= 0 && hoverIndex < rows.length) {
 		canvasCtx.save();
+		canvasCtx.globalAlpha = hoverAnimProgress;
 		canvasCtx.fillStyle = theme.highlightColor;
 		canvasCtx.fillRect(chartX, plotArea.y + hoverIndex * rowH, chartW, rowH);
 		canvasCtx.restore();
@@ -6386,21 +6234,12 @@ function renderGanttChart(ctx) {
 		canvasCtx.textBaseline = "middle";
 		let label = r.name || "";
 		const maxW = layout.labelW - 16;
-		if (canvasCtx.measureText(label).width > maxW) {
-			let lo = 0, hi = label.length;
-			while (lo < hi) {
-				const mid = Math.ceil((lo + hi) / 2);
-				if (canvasCtx.measureText(label.slice(0, mid) + "…").width > maxW) hi = mid - 1;
-				else lo = mid;
-			}
-			label = label.slice(0, lo) + "…";
-		}
+		label = truncateLabel(canvasCtx, label, maxW);
 		canvasCtx.fillText(label, chartX - 10, plotArea.y + i * rowH + rowH / 2);
 		canvasCtx.restore();
 	});
 }
-function ganttHitTest(canvasX, canvasY, plotArea, options, theme, hiddenSeries) {
-	const layout = computeGanttLayout(plotArea, options, theme, hiddenSeries);
+function ganttHitTest(canvasX, canvasY, plotArea, options, theme, hiddenSeries, layout = computeGanttLayout(plotArea, options, theme, hiddenSeries)) {
 	if (!layout) return null;
 	const { rows } = layout;
 	const relY = canvasY - plotArea.y;
@@ -6469,7 +6308,7 @@ function renderDataZoomSlider(ctx, zoom) {
 	const previewSeries = (options.series || []).filter((s) => !ctx.hiddenSeries.has(s.name))[0];
 	if (previewSeries && previewSeries.data.length > 0) {
 		const data = previewSeries.data;
-		const max = Math.max(...data.map((v) => v === null || Number.isNaN(v) ? 0 : v), 1);
+		const max = maxOf(data.map((v) => v === null || Number.isNaN(v) ? 0 : v), 1);
 		const barAreaHeight = geo.height - 18;
 		const barWidth = Math.max(1, geo.width / data.length - 1);
 		data.forEach((raw, i) => {
@@ -6771,6 +6610,11 @@ function createSvgRecorder(real) {
 				"font-family": font.family,
 				"fill": typeof style.fillStyle === "string" ? style.fillStyle : "#000"
 			};
+			if (matrix[1] !== 0 || matrix[2] !== 0) {
+				attrs.x = x.toFixed(2);
+				attrs.y = y.toFixed(2);
+				attrs.transform = `matrix(${matrix.map((v) => +v.toFixed(4)).join(" ")})`;
+			}
 			if (style.textAlign === "center") attrs["text-anchor"] = "middle";
 			else if (style.textAlign === "right" || style.textAlign === "end") attrs["text-anchor"] = "end";
 			if (style.textBaseline === "middle") attrs["dominant-baseline"] = "central";
@@ -6920,7 +6764,7 @@ function createSvgRecorder(real) {
 	function gradientDefs() {
 		return gradients.map((g, i) => {
 			const stops = g.stops.map((s) => {
-				let color = s.color;
+				let color = escapeXml(String(s.color));
 				let opacity = 1;
 				const m = /^(#[0-9a-fA-F]{6})([0-9a-fA-F]{2})$/.exec(s.color);
 				if (m) {
@@ -6934,7 +6778,7 @@ function createSvgRecorder(real) {
 	}
 	function toSvg(width, height, backgroundColor) {
 		const body = elements.map((el) => {
-			const attrs = Object.entries(el.attrs).map(([k, v]) => `${k}="${v}"`).join(" ");
+			const attrs = Object.entries(el.attrs).map(([k, v]) => `${k}="${escapeXml(String(v))}"`).join(" ");
 			if (el.tag === "text") return `<text ${attrs}>${escapeXml(el.text || "")}</text>`;
 			return `<${el.tag} ${attrs}/>`;
 		}).join("\n");
@@ -6956,7 +6800,14 @@ function runLayers(renderCtx, at) {
 }
 function renderChart(canvas, params) {
 	const { options: rawOptions, ctx: externalCtx, dpr = window.devicePixelRatio || 1, progress = 1, hoverIndex = -1, hoverAnimProgress = 1, focusAnimProgress = 1, hiddenSeries = /* @__PURE__ */ new Set(), mouseX = -1, mouseY = -1, showCrosshair = false, zoomRange, brushRect, focusSeries = null, hoveredToolbox = null } = params;
-	const options = applyLogTransform(rawOptions);
+	const logApplied = applyLogTransform(rawOptions);
+	const options = (logApplied.series || []).some((s) => !s.data) ? {
+		...logApplied,
+		series: logApplied.series.map((s) => s.data ? s : {
+			...s,
+			data: []
+		})
+	} : logApplied;
 	const ctx = externalCtx || canvas.getContext("2d");
 	const width = canvas.width / dpr;
 	const height = canvas.height / dpr;
@@ -7017,10 +6868,10 @@ function renderChart(canvas, params) {
 					});
 					break;
 				}
-				const yValues = scatterData.map((d) => d.y);
+				const yValues = scatterData.map((d) => d.y).filter((v) => typeof v === "number" && Number.isFinite(v));
 				const yRange = renderYAxis(renderCtx, "left", {
-					min: Math.min(...yValues),
-					max: Math.max(...yValues)
+					min: yValues.length ? minOf(yValues) : 0,
+					max: yValues.length ? maxOf(yValues) : 1
 				});
 				renderXAxis(renderCtx);
 				points = renderScatterChart(renderCtx, yRange);
@@ -7050,8 +6901,8 @@ function renderChart(canvas, params) {
 					...renderCtx,
 					plotArea: axisArea
 				}, "left", {
-					min: Math.min(...allValues),
-					max: Math.max(...allValues)
+					min: minOf(allValues),
+					max: maxOf(allValues)
 				});
 				renderXAxis(renderCtx);
 				renderCandleChart(renderCtx, yRange);
@@ -7068,7 +6919,15 @@ function renderChart(canvas, params) {
 			renderChordChart(renderCtx);
 			break;
 		case "arc":
-			renderArcChart(renderCtx);
+			if (options.arcCircular === true) renderChordChart({
+				...renderCtx,
+				options: {
+					...options,
+					chordData: options.arcData,
+					chordMode: "curve"
+				}
+			});
+			else renderArcChart(renderCtx);
 			break;
 		case "gantt":
 			renderGanttChart(renderCtx);
@@ -7112,15 +6971,17 @@ function renderChart(canvas, params) {
 					b.min,
 					b.max,
 					...showOutliers ? b.outliers || [] : []
-				]);
+				]).filter((v) => typeof v === "number" && Number.isFinite(v));
+				const valueLo = allValues.length ? minOf(allValues) : 0;
+				const valueHi = allValues.length ? maxOf(allValues) : 1;
 				let range;
 				if (horizontal) range = renderHorizontalAxis(renderCtx, {
-					min: Math.min(...allValues),
-					max: Math.max(...allValues)
+					min: valueLo,
+					max: valueHi
 				});
 				else range = renderYAxis(renderCtx, "left", {
-					min: Math.min(...allValues),
-					max: Math.max(...allValues)
+					min: valueLo,
+					max: valueHi
 				});
 				leftRange = range;
 				renderBoxplotChart(renderCtx, range);
@@ -7292,7 +7153,12 @@ var chartOptionsSchema = {
 				show: { type: "boolean" },
 				position: {
 					type: "string",
-					enum: ["top", "bottom"]
+					enum: [
+						"top",
+						"bottom",
+						"left",
+						"right"
+					]
 				},
 				interactive: { type: "boolean" },
 				hoverEmphasis: { type: "boolean" }
@@ -7315,13 +7181,18 @@ var chartOptionsSchema = {
 			properties: {
 				enabled: { type: "boolean" },
 				duration: { type: "number" },
-				easing: { type: "string" }
+				easing: { type: "string" },
+				stagger: { type: "number" }
 			}
 		},
 		xAxis: {
 			type: "object",
 			properties: {
 				show: { type: "boolean" },
+				type: {
+					type: "string",
+					enum: ["category", "time"]
+				},
 				min: { type: "number" },
 				max: { type: "number" },
 				ticks: { type: "integer" },
@@ -7341,6 +7212,10 @@ var chartOptionsSchema = {
 			type: "object",
 			properties: {
 				show: { type: "boolean" },
+				type: {
+					type: "string",
+					enum: ["value", "log"]
+				},
 				min: { type: "number" },
 				max: { type: "number" },
 				ticks: { type: "integer" },
@@ -7481,6 +7356,8 @@ var chartOptionsSchema = {
 			}
 		},
 		annotation: { type: "object" },
+		markLines: { type: "array" },
+		markAreas: { type: "array" },
 		markLine: { type: "array" },
 		markArea: { type: "array" },
 		scenes: {
@@ -7503,20 +7380,110 @@ var chartOptionsSchema = {
 			}
 		},
 		pieData: { type: "array" },
+		piePercentMode: { type: "boolean" },
+		pieHideThreshold: { type: "number" },
+		innerRadius: { type: "number" },
 		radarSeries: { type: "array" },
 		radarIndicators: { type: "array" },
+		radarStacked: { type: "boolean" },
+		radarRingFill: { type: "boolean" },
+		radarLabelOffset: { type: "number" },
 		scatterData: { type: "array" },
+		quadrant: {
+			type: "object",
+			properties: {
+				show: { type: "boolean" },
+				xMid: { type: "number" },
+				yMid: { type: "number" },
+				labels: { type: "array" }
+			}
+		},
+		scatterTrendline: { type: "string" },
+		trendlinePerGroup: { type: "boolean" },
+		jitter: { type: "number" },
+		pointLabels: { type: "boolean" },
+		facet: { type: "boolean" },
 		funnelData: { type: "array" },
 		funnelMinRatio: { type: "number" },
+		pyramid: { type: "boolean" },
 		gauge: { oneOf: [{ type: "number" }, { type: "object" }] },
 		heatmapData: { type: "array" },
+		heatmap: {
+			type: "object",
+			properties: {
+				colorScale: { type: "array" },
+				colorBar: { type: "boolean" }
+			}
+		},
+		heatmapColorBar: { type: "boolean" },
+		heatmapSortBy: {
+			type: "string",
+			enum: ["name", "value"]
+		},
 		candleData: { type: "array" },
 		volumeData: { type: "array" },
 		candleMa: { type: "array" },
+		candleMaColors: { type: "array" },
+		candleUpColor: { type: "string" },
+		candleDownColor: { type: "string" },
 		calendarData: { type: "array" },
-		calendar: { type: "object" },
+		calendar: {
+			type: "object",
+			properties: {
+				start: { type: "string" },
+				end: { type: "string" },
+				weekStart: { type: "integer" },
+				today: { type: "string" },
+				granularity: {
+					type: "string",
+					enum: [
+						"day",
+						"week",
+						"month"
+					]
+				},
+				colors: { type: "array" },
+				cellGap: { type: "number" },
+				showScale: { type: "boolean" },
+				weekdayLabels: { type: "array" },
+				showAllWeekdays: { type: "boolean" }
+			}
+		},
 		bulletData: { type: "array" },
 		boxData: { type: "array" },
+		boxHorizontal: { type: "boolean" },
+		showOutliers: { type: "boolean" },
+		binConfig: {
+			type: "object",
+			properties: {
+				bins: { type: "array" },
+				binCount: { type: "integer" },
+				density: { type: "boolean" }
+			}
+		},
+		treemapData: { type: "array" },
+		sunburstData: { type: "array" },
+		valueFormat: {
+			type: "object",
+			properties: {
+				decimals: { type: "integer" },
+				thousandSeparator: { type: "string" },
+				prefix: { type: "string" },
+				suffix: { type: "string" },
+				abbreviate: { type: "boolean" }
+			}
+		},
+		showValues: { type: "boolean" },
+		borderRadius: { type: "number" },
+		step: { type: "boolean" },
+		smooth: { type: "boolean" },
+		stackAreas: { type: "boolean" },
+		connectNulls: { type: "boolean" },
+		crosshairUnified: { type: "boolean" },
+		waterfall: {
+			type: "object",
+			properties: { totalIndices: { type: "array" } }
+		},
 		sankeyData: {
 			type: "object",
 			properties: {
@@ -7524,6 +7491,13 @@ var chartOptionsSchema = {
 				links: { type: "array" }
 			}
 		},
+		sankey: {
+			type: "object",
+			properties: { nodeAlign: {
+				type: "string",
+				enum: ["justify", "left"]
+			} }
+		},
 		chordData: {
 			type: "object",
 			properties: {
@@ -7539,7 +7513,10 @@ var chartOptionsSchema = {
 			}
 		},
 		vennData: { type: "array" },
+		vennHollow: { type: "boolean" },
 		ganttData: { type: "array" },
+		ganttToday: { type: "string" },
+		arcCircular: { type: "boolean" },
 		matrixFields: { type: "array" },
 		matrixData: { type: "array" },
 		loading: { type: "boolean" },
@@ -7553,7 +7530,9 @@ var chartOptionsSchema = {
 		},
 		logAxis: { type: "boolean" },
 		valueFormatter: { type: "function" },
-		timeAxis: { type: "boolean" }
+		timeAxis: { type: "boolean" },
+		sparklineSmooth: { type: "boolean" },
+		sparklineArea: { type: "boolean" }
 	}
 };
 var TYPE_CHECKS = {
@@ -7800,6 +7779,192 @@ function distinctCount(values) {
 	return new Set(values.filter((v) => v !== null && v !== "")).size;
 }
 //#endregion
+//#region src/ai/threed.js
+var THREE_HINT = /三维|立体|3d/i;
+function wantsThreed(hint = {}) {
+	if (hint.intent === "threed") return true;
+	const text = [hint.title, hint.hint].filter(Boolean).join(" ");
+	return THREE_HINT.test(text);
+}
+function pivotGrid(cx, cy, cz) {
+	const rows = cx.values.length;
+	if (rows < 4) return null;
+	const xs = [...new Set(cx.values.filter(Number.isFinite))].sort((a, b) => a - b);
+	const ys = [...new Set(cy.values.filter(Number.isFinite))].sort((a, b) => a - b);
+	if (xs.length < 2 || ys.length < 2) return null;
+	if (xs.length * ys.length !== rows) return null;
+	if (xs.length > 64 || ys.length > 64) return {
+		tooLarge: true,
+		x: xs.length,
+		y: ys.length
+	};
+	const z = Array.from({ length: ys.length }, () => new Array(xs.length).fill(null));
+	const seen = /* @__PURE__ */ new Set();
+	for (let i = 0; i < rows; i++) {
+		const xi = xs.indexOf(cx.values[i]);
+		const yi = ys.indexOf(cy.values[i]);
+		if (xi < 0 || yi < 0) return null;
+		const key = yi * xs.length + xi;
+		if (seen.has(key)) return null;
+		seen.add(key);
+		z[yi][xi] = cz.values[i];
+	}
+	return {
+		x: xs,
+		y: ys,
+		z
+	};
+}
+function planThreed({ hint, intent, numbers, times, cats, table, labels }) {
+	const asked = wantsThreed(hint);
+	const natural = !asked && cats.length === 0 && times.length === 0 && numbers.length >= 3;
+	if (!asked && !natural) return null;
+	if (cats.length === 0 && times.length === 0) {
+		if (numbers.length < 3) return {
+			spec: null,
+			report: [{
+				level: "warn",
+				message: "三维散点/曲面需要至少三个数值维度，已回退二维选型"
+			}]
+		};
+		const [cx, cy, cz] = numbers;
+		const grid = pivotGrid(cx, cy, cz);
+		if (grid && !grid.tooLarge) return {
+			spec: {
+				type: "surface3d",
+				surfaceData: {
+					x: grid.x,
+					y: grid.y,
+					z: grid.z
+				},
+				xAxis: { name: cx.name },
+				yAxis: { name: cy.name },
+				zAxis: { name: cz.name }
+			},
+			report: [{
+				level: "info",
+				message: `三维曲面：${cx.name} × ${cy.name} 构成 ${grid.x.length}×${grid.y.length} 完整高度场（${cz.name}）`
+			}]
+		};
+		const report = [];
+		if (grid && grid.tooLarge) report.push({
+			level: "warn",
+			message: `数值网格 ${grid.x}×${grid.y} 过大（任一边 > 64），曲面 spec 会爆炸，已改用三维散点`
+		});
+		return {
+			spec: {
+				type: "scatter3d",
+				scatterData: table.rows.map((_, i) => ({
+					x: cx.values[i],
+					y: cy.values[i],
+					z: cz.values[i]
+				})),
+				xAxis: { name: cx.name },
+				yAxis: { name: cy.name },
+				zAxis: { name: cz.name }
+			},
+			report: [...report, {
+				level: "info",
+				message: `三维散点：${cx.name} / ${cy.name} / ${cz.name} 三轴空间（二维散点会丢一维）`
+			}]
+		};
+	}
+	if (numbers.length === 0) return null;
+	if (intent === "relation" && numbers.length >= 3) {
+		const [cx, cy, cz] = numbers;
+		const cat = cats[0];
+		return {
+			spec: {
+				type: "scatter3d",
+				scatterData: table.rows.map((_, i) => ({
+					x: cx.values[i],
+					y: cy.values[i],
+					z: cz.values[i],
+					label: cat ? String(cat.values[i]) : String(i + 1)
+				})),
+				xAxis: { name: cx.name },
+				yAxis: { name: cy.name },
+				zAxis: { name: cz.name }
+			},
+			report: [{
+				level: "info",
+				message: `三维散点：${cx.name} / ${cy.name} / ${cz.name} 三轴空间，${cat ? `「${cat.name}」作点标签` : "行号作点标签"}`
+			}]
+		};
+	}
+	const seriesList = numbers.slice(0, 8).map((c) => ({
+		name: c.name,
+		data: c.values
+	}));
+	const report = [];
+	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);
+			return {
+				spec: {
+					type: "pie3d",
+					pieData
+				},
+				report: [...report, {
+					level: "info",
+					message: `三维饼：${seriesList[0].name} 按类目占比（${pieData.length} 项）`
+				}]
+			};
+		}
+		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)) return {
+				spec: {
+					type: "pie3d",
+					pieData: seriesList.map((s, i) => ({
+						name: s.name,
+						value: sums[i]
+					}))
+				},
+				report: [...report, {
+					level: "info",
+					message: `三维饼：按度量合计占比（${sums.length} 项）`
+				}]
+			};
+		}
+	}
+	const text = [hint.title, hint.hint].filter(Boolean).join("");
+	const isTrend = !/柱|条形/.test(text) && (times.length > 0 || intent === "trend");
+	const spec = {
+		type: isTrend ? "line3d" : "bar3d",
+		labels,
+		series: seriesList
+	};
+	if (seriesList.length > 1) spec.legend = { show: true };
+	if (seriesList.length === 1) spec.zAxis = { name: seriesList[0].name };
+	report.push({
+		level: "info",
+		message: isTrend ? "三维空间折线：维度有序看走势，落地投影与面带保留空间形态" : "三维柱林：类目 × 系列的空间量值对比"
+	});
+	return {
+		spec,
+		report
+	};
+}
+var SPEC_RULES_3D = [
+	"type 必填，取值限定三维 schema enum：bar3d / line3d / scatter3d / surface3d / pie3d",
+	"bar3d / line3d 用 labels（X 类目）+ series（Y 系列，data 为标量数组），series[].data 长度必须与 labels 一致，系列建议 ≤5（过多互相遮挡）",
+	"scatter3d 用 scatterData：{ x, y, z, label? } 三元组数组，三轴均为数值",
+	"surface3d 用 surfaceData：{ x: 列值数组, y: 行值数组, z: 行×列矩阵 }，z.length 必须等于 y.length 且每行长度等于 x.length",
+	"pie3d 用 pieData：{ name, value } 数组，扇区 ≤8 项，正值才参与",
+	"渲染组件是 <ev-chart3d>（来自 @wil-works/evoke-charts/3d 子入口）；二维专属字段（annotations / dataZoom / yAxisRight / markLines 等）在三维 schema 中不存在，不要使用",
+	"相机交互默认已含拖拽环绕、滚轮缩放与双击复位，一般无需配置 camera；展厅氛围场景才设 camera.autoRotate: true",
+	"palette / theme / colors 与二维同一套：色系 id 限定三维 schema enum；theme.colors 与 palette 同时出现时以 theme.colors 为准",
+	"数值格式化用 valueFormatter（函数）或 i18n 文案对象；不使用三维 schema 之外的字段"
+];
+//#endregion
 //#region src/ai/spec.js
 var INTENT_KEYWORDS = {
 	trend: [
@@ -7932,6 +8097,25 @@ function generateChartSpec(data, hint = {}) {
 	}];
 	const spec = {};
 	if (hint.title) spec.title = hint.title;
+	const three = planThreed({
+		hint,
+		intent,
+		numbers,
+		times,
+		cats,
+		table,
+		labels
+	});
+	if (three) {
+		report.push(...three.report);
+		if (three.spec) {
+			Object.assign(spec, three.spec);
+			return {
+				spec,
+				report
+			};
+		}
+	}
 	if (intent === "relation" && numbers.length >= 2) {
 		const cat = cats[0];
 		spec.type = "scatter";
@@ -8020,9 +8204,9 @@ function generateChartSpec(data, hint = {}) {
 	if (splitIdx >= 0) {
 		spec.type = "mixed";
 		spec.yAxisRight = { show: true };
-		const peakOf = (s) => Math.max(0, ...s.data.filter((v) => typeof v === "number" && Number.isFinite(v)).map(Math.abs));
+		const peakOf = (s) => Math.max(0, maxOf(s.data.filter((v) => typeof v === "number" && Number.isFinite(v)).map(Math.abs)));
 		const peakMax = peakOf(seriesList[splitIdx]);
-		const peakMin = Math.min(...seriesList.filter((_, i) => i !== splitIdx).map(peakOf).filter((v) => v > 0));
+		const peakMin = minOf(seriesList.filter((_, i) => i !== splitIdx).map(peakOf).filter((v) => v > 0));
 		const ratioText = Number.isFinite(peakMin) && peakMin > 0 ? `（最高约为最低的 ${fmtRatio(peakMax / peakMin)} 倍）` : "";
 		report.push({
 			level: "info",
@@ -8066,8 +8250,8 @@ function planDualAxis(seriesList) {
 	const maxes = seriesList.map((s) => s.data.reduce((m, v) => typeof v === "number" && Number.isFinite(v) ? Math.max(m, Math.abs(v)) : m, 0));
 	const valid = maxes.filter((m) => m > 0);
 	if (seriesList.length < 2 || valid.length < 2) return -1;
-	const max = Math.max(...maxes);
-	return max / Math.min(...valid) >= 100 ? maxes.indexOf(max) : -1;
+	const max = maxOf(maxes);
+	return max / minOf(valid) >= 100 ? maxes.indexOf(max) : -1;
 }
 function fmtRatio(ratio) {
 	if (ratio >= 1e8) return `${(ratio / 1e8).toFixed(1)}亿`;
@@ -8094,6 +8278,16 @@ var SPEC_RULES = [
 	"series[].data 长度必须与 labels 一致，缺失值用 null",
 	"双轴：两个量纲或量级悬殊的度量用 type mixed——大量度 series 用 chartType bar 且 yAxis left，小量度 chartType line 且 yAxis right，并置顶层 yAxisRight",
 	"palette 仅在需求要求固定配色（不随宿主主题换肤）时设置，取值限定 schema enum 中的色系 id；与 theme.colors 同时出现时以 theme.colors 为准",
+	"弧长连接图关系密集或需要闭合回路视角时置 arcCircular: true，数据仍走 arcData",
+	"日历热力需要周/月聚合视角时置 calendar.granularity（day 每日 / week / month，周月为求和聚合）",
+	"数值格式化优先用 valueFormat 快捷对象（decimals/thousandSeparator/prefix/suffix/abbreviate），确需函数式定制才用 valueFormatter",
+	"散点增强：要看分布分界用 quadrant（均值十字 + 象限标签），看相关走向用 scatterTrendline: 'linear'（多组对比配 trendlinePerGroup: true），同值重叠用 jitter，需逐点标注用 pointLabels: true，多变量按 group 拆格用 facet: true",
+	"雷达增强：radarRingFill: true 画同心环带底色；多系列重叠看构成用 radarStacked: true",
+	"K 线：volumeData 与 candleData 等长即带量副图，candleMa（如 [5, 10]）叠均线并可配 candleMaColors，涨跌色用 candleUpColor / candleDownColor",
+	"桑基列对齐缺省 justify（末端贴右缘），仅按拓扑深度排布的需求才设 sankey: { nodeAlign: 'left' }",
+	"箱线横向排布用 boxHorizontal: true；直方图分箱用 binConfig（binCount 或 bins，密度视角 density）；热力排序视角用 heatmapSortBy: 'value'",
+	"折线增强：多系列面积构成用 stackAreas: true，阶梯走势用 step: true，null 断点需跨接用 connectNulls: true，逐点标值用 showValues，阈值参考线用 markLines，事件区间强调用 markAreas",
+	"瀑布图合计列用 waterfall.totalIndices 标记；漏斗尾段压缩用 funnelMinRatio；饼图环形化用 type: 'doughnut' 配 innerRadius",
 	"叙述注解 annotations 单图不超过 3 处，emphasis 焦点最多 1 个系列",
 	"不使用 schema 之外的字段",
 	`支持的图表类型：${chartOptionsSchema.properties.type.enum.join(" / ")}`
@@ -8249,27 +8443,252 @@ var SPEC_EXAMPLES = [
 			yAxisRight: { show: true },
 			legend: { show: true }
 		}
+	},
+	{
+		requirement: "按周汇总看打卡活跃度",
+		spec: {
+			type: "calendar-heatmap",
+			title: "打卡活跃度（按周聚合）",
+			calendarData: [
+				{
+					date: "2026-06-01",
+					value: 3
+				},
+				{
+					date: "2026-06-02",
+					value: 5
+				},
+				{
+					date: "2026-06-05",
+					value: 8
+				}
+			],
+			calendar: {
+				start: "2026-06-01",
+				end: "2026-08-31",
+				granularity: "week"
+			}
+		}
+	},
+	{
+		requirement: "服务间调用关系，环形布局更好看出闭环",
+		spec: {
+			type: "arc",
+			title: "服务间调用拓扑",
+			arcCircular: true,
+			arcData: {
+				nodes: [
+					{ name: "网关" },
+					{ name: "订单服务" },
+					{ name: "支付服务" },
+					{ name: "消息中心" }
+				],
+				links: [
+					{
+						source: "网关",
+						target: "订单服务",
+						value: 46
+					},
+					{
+						source: "订单服务",
+						target: "支付服务",
+						value: 38
+					},
+					{
+						source: "支付服务",
+						target: "消息中心",
+						value: 22
+					}
+				]
+			}
+		}
+	},
+	{
+		requirement: "各渠道投放费用和转化效果的关系，看分界和走向",
+		spec: {
+			type: "scatter",
+			title: "投放-转化四象限",
+			scatterData: [
+				{
+					x: 120,
+					y: 32,
+					label: "搜索"
+				},
+				{
+					x: 260,
+					y: 58,
+					label: "信息流"
+				},
+				{
+					x: 90,
+					y: 18,
+					label: "社群"
+				},
+				{
+					x: 340,
+					y: 71,
+					label: "直播"
+				}
+			],
+			quadrant: { labels: [
+				"低投高转",
+				"高投高转",
+				"低投低转",
+				"高投低转"
+			] },
+			scatterTrendline: "linear",
+			pointLabels: true
+		}
 	}
 ];
 function formatExamples(maxCount = SPEC_EXAMPLES.length) {
 	return SPEC_EXAMPLES.slice(0, maxCount).map((e) => `需求：${e.requirement}\nSpec：${JSON.stringify(e.spec)}`).join("\n\n");
 }
+var SPEC_EXAMPLES_3D = [
+	{
+		requirement: "三维看温度、湿度与设备故障率的关系",
+		spec: {
+			type: "scatter3d",
+			title: "温度-湿度-故障率空间分布",
+			scatterData: [
+				{
+					x: 22,
+					y: 40,
+					z: 1.2,
+					label: "产线 A"
+				},
+				{
+					x: 28,
+					y: 55,
+					z: 2.8,
+					label: "产线 B"
+				},
+				{
+					x: 31,
+					y: 62,
+					z: 4.5,
+					label: "产线 C"
+				},
+				{
+					x: 25,
+					y: 48,
+					z: 1.9,
+					label: "产线 D"
+				}
+			],
+			xAxis: { name: "温度（℃）" },
+			yAxis: { name: "湿度（%）" },
+			zAxis: { name: "故障率（%）" }
+		}
+	},
+	{
+		requirement: "转速和扭矩共同影响下的产出效率曲面",
+		spec: {
+			type: "surface3d",
+			title: "转速-扭矩-效率高度场",
+			surfaceData: {
+				x: [
+					800,
+					1200,
+					1600,
+					2e3
+				],
+				y: [
+					100,
+					150,
+					200
+				],
+				z: [
+					[
+						61,
+						64,
+						66,
+						63
+					],
+					[
+						67,
+						72,
+						75,
+						70
+					],
+					[
+						64,
+						69,
+						71,
+						66
+					]
+				]
+			},
+			xAxis: { name: "转速（rpm）" },
+			yAxis: { name: "扭矩（N·m）" },
+			zAxis: { name: "效率（%）" }
+		}
+	},
+	{
+		requirement: "三维柱林对比四个季度的区域销量",
+		spec: {
+			type: "bar3d",
+			title: "区域季度销量柱林",
+			labels: [
+				"一季度",
+				"二季度",
+				"三季度",
+				"四季度"
+			],
+			series: [
+				{
+					name: "华东",
+					data: [
+						320,
+						356,
+						401,
+						388
+					]
+				},
+				{
+					name: "华南",
+					data: [
+						280,
+						302,
+						346,
+						331
+					]
+				},
+				{
+					name: "华北",
+					data: [
+						240,
+						262,
+						288,
+						305
+					]
+				}
+			],
+			legend: { show: true },
+			zAxis: { name: "销量（万）" }
+		}
+	}
+];
+function formatExamples3d(maxCount = SPEC_EXAMPLES_3D.length) {
+	return SPEC_EXAMPLES_3D.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 } = {}) {
+function buildChartPrompt({ data, requirement, extraRules = [], examples = true, mode = "2d" } = {}) {
+	const is3d = mode === "3d";
 	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 rules = [...is3d ? SPEC_RULES_3D : SPEC_RULES, ...extraRules];
 	const sections = [
-		"你是图表配置生成器。根据下面的数据与需求，产出 EvChart 的 options JSON（下称 Spec），它将被 <ev-chart :options> 直接渲染。",
-		`## Options Schema\n${JSON.stringify(chartOptionsSchema)}`,
+		is3d ? "你是三维图表配置生成器。根据下面的数据与需求，产出 EvChart3d 的 options JSON（下称 Spec），它将被 <ev-chart3d :options> 直接渲染（组件来自 @wil-works/evoke-charts/3d 子入口）。" : "你是图表配置生成器。根据下面的数据与需求，产出 EvChart 的 options JSON（下称 Spec），它将被 <ev-chart :options> 直接渲染。",
+		`## Options Schema\n${JSON.stringify(is3d ? chart3dOptionsSchema : chartOptionsSchema)}`,
 		`## 数据预览\n${digest}`
 	];
-	if (examples) sections.push(`## 示例\n${formatExamples()}`);
+	if (examples) sections.push(`## 示例\n${is3d ? formatExamples3d() : 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");
@@ -8378,6 +8797,23 @@ function lintChartSpec(spec, opts = {}) {
 		}],
 		spec: fixed
 	};
+	if (typeof fixed.type === "string" && /3d$/.test(fixed.type)) {
+		const { warnings } = validateOptions3d(fixed);
+		warnings.forEach((w) => issues.push({
+			level: "error",
+			message: `${w.path} ${w.message}`,
+			path: w.path
+		}));
+		if (!issues.length) issues.push({
+			level: "info",
+			message: "三维 spec 已过 schema 校验（几何层自检仅覆盖二维图型）",
+			rule: "threed-schema-only"
+		});
+		return {
+			issues,
+			spec: fixed
+		};
+	}
 	const { warnings } = validateOptions(fixed);
 	warnings.forEach((w) => issues.push({
 		level: "error",
@@ -8405,7 +8841,7 @@ function lintChartSpec(spec, opts = {}) {
 	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 maxLabelWidth = maxOf(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";
@@ -8451,4 +8887,4 @@ function lintChartSpec(spec, opts = {}) {
 	};
 }
 //#endregion
-export { INTERACTION as $, squarifyTreemap as A, calendarHitTest as B, chordHitTest as C, computeSunburstGeometry as D, boxplotHitTest as E, matrixFieldExtent as F, getPadding as G, getHeatmapCategories as H, scatterGroupColors as I, resolveTickExtendedRange as J, getTheme as K, scatterPointPositions as L, computeFacetGrids as M, computeMatrixCells as N, sunburstValue as O, computePieMaxRadius as P, DEFAULT_I18N_ZH as Q, getLegendBounds as R, arcHitTest as S, vennHitTest as T, xToCategoryIndex as U, funnelStepColor as V, createAnimation as W, CHART_PALETTES as X, updateAnimation as Y, resolveChartPalette as Z, getSliderGeometry as _, SPEC_RULES as a, zoomToSlice as b, inferColumns as c, parseNumeric as d, applyWheelZoom as et, chartOptionsSchema as f, getDataZoomConfig as g, createSvgRecorder as h, formatExamples as i, buildPieSlices as j, computeBins as k, looksLikeTime as l, renderChart as m, buildChartPrompt as n, resolveCursor as nt, detectIntent as o, validateOptions as p, isMissingValue as q, SPEC_EXAMPLES as r, generateChartSpec as s, lintChartSpec as t, pickTooltipRows as tt, parseDataTable as u, windowToX as v, sankeyHitTest as w, ganttHitTest as x, xToPercent as y, getToolboxBounds as z };
+export { isMissingValue as $, vennHitTest as A, doughnutInnerRadius as B, windowToX as C, arcHitTest as D, ganttHitTest as E, squarifyTreemap as F, getToolboxBounds as G, scatterGroupColors as H, buildPieSlices as I, getHeatmapCategories as J, calendarHitTest as K, computeFacetGrids as L, computeSunburstGeometry as M, sunburstValue as N, chordHitTest as O, computeBins as P, getTheme as Q, computeMatrixCells as R, getSliderGeometry as S, zoomToSlice as T, scatterPointPositions as U, matrixFieldExtent as V, getLegendBounds as W, createAnimation as X, xToCategoryIndex as Y, getPadding as Z, chartOptionsSchema as _, formatExamples as a, INTERACTION as at, createSvgRecorder as b, detectIntent as c, resolveCursor as ct, planThreed as d, resolveTickExtendedRange as et, wantsThreed as f, parseNumeric as g, parseDataTable as h, SPEC_EXAMPLES_3D as i, minOf as it, boxplotHitTest as j, sankeyHitTest as k, generateChartSpec as l, looksLikeTime as m, buildChartPrompt as n, waterfallSteps as nt, formatExamples3d as o, applyWheelZoom as ot, inferColumns as p, funnelStepColor as q, SPEC_EXAMPLES as r, maxOf as rt, SPEC_RULES as s, pickTooltipRows as st, lintChartSpec as t, updateAnimation as tt, SPEC_RULES_3D as u, validateOptions as v, xToPercent as w, getDataZoomConfig as x, renderChart as y, computePieMaxRadius as z };