@wil-works/evoke-charts 0.6.0 → 0.7.0

package/dist/{ai-B5Fk3lBQ.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,
@@ -97,307 +98,6 @@ function maxOf(values, ...extras) {
 	return max;
 }
 //#endregion
-//#region src/types.js
-var UP_COLOR = "#dc2626";
-var DOWN_COLOR = "#16a34a";
-var VOLUME_SERIES_NAME = "成交量";
-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;
-	}
-}
-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;
-	}
-	return prefix + formatted + suffix;
-}
-//#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"
-		]
-	}
-];
-/** 按 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);
-}
-//#endregion
 //#region src/renderer/core.js
 function estimateTextWidth(text, fontSize = 12) {
 	let width = 0;
@@ -851,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);
@@ -2510,14 +2212,15 @@ function renderHeatmapChart(ctx) {
 	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 = minOf(values);
-	const maxValue = maxOf(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];
@@ -3239,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]);
@@ -4034,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);
@@ -4519,7 +4222,10 @@ 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 = minOf(allValues);
 	const range = maxOf(allValues) - dataMin || 1;
@@ -7058,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) {
@@ -7265,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: minOf(allValues),
-					max: maxOf(allValues)
+					min: valueLo,
+					max: valueHi
 				});
 				else range = renderYAxis(renderCtx, "left", {
-					min: minOf(allValues),
-					max: maxOf(allValues)
+					min: valueLo,
+					max: valueHi
 				});
 				leftRange = range;
 				renderBoxplotChart(renderCtx, range);
@@ -7473,7 +7181,8 @@ var chartOptionsSchema = {
 			properties: {
 				enabled: { type: "boolean" },
 				duration: { type: "number" },
-				easing: { type: "string" }
+				easing: { type: "string" },
+				stagger: { type: "number" }
 			}
 		},
 		xAxis: {
@@ -8070,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: [
@@ -8202,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";
@@ -8630,22 +8544,151 @@ var SPEC_EXAMPLES = [
 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");
@@ -8754,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",
@@ -8827,4 +8887,4 @@ function lintChartSpec(spec, opts = {}) {
 	};
 }
 //#endregion
-export { resolveChartPalette as $, squarifyTreemap as A, getToolboxBounds as B, chordHitTest as C, computeSunburstGeometry as D, boxplotHitTest as E, doughnutInnerRadius as F, createAnimation as G, funnelStepColor as H, matrixFieldExtent as I, isMissingValue as J, getPadding as K, scatterGroupColors as L, computeFacetGrids as M, computeMatrixCells as N, sunburstValue as O, computePieMaxRadius as P, CHART_PALETTES as Q, scatterPointPositions as R, arcHitTest as S, vennHitTest as T, getHeatmapCategories as U, calendarHitTest as V, xToCategoryIndex as W, updateAnimation as X, resolveTickExtendedRange as Y, waterfallSteps as Z, getSliderGeometry as _, SPEC_RULES as a, INTERACTION as at, zoomToSlice as b, inferColumns as c, resolveCursor as ct, parseNumeric as d, DEFAULT_I18N_ZH as et, chartOptionsSchema as f, getDataZoomConfig as g, createSvgRecorder as h, formatExamples as i, minOf as it, buildPieSlices as j, computeBins as k, looksLikeTime as l, renderChart as m, buildChartPrompt as n, UP_COLOR as nt, detectIntent as o, applyWheelZoom as ot, validateOptions as p, getTheme as q, SPEC_EXAMPLES as r, maxOf as rt, generateChartSpec as s, pickTooltipRows as st, lintChartSpec as t, DOWN_COLOR as tt, parseDataTable as u, windowToX as v, sankeyHitTest as w, ganttHitTest as x, xToPercent as y, getLegendBounds 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 };