@wil-works/evoke-charts 0.5.0 → 0.7.0

package/dist/schema-CM4hKlpc.js

@@ -0,0 +1,1102 @@
+//#region src/types.js
+var UP_COLOR = "#dc2626";
+var DOWN_COLOR = "#16a34a";
+var VOLUME_SERIES_NAME = "成交量";
+var DEFAULT_I18N_ZH$1 = {
+	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$1(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$1 = {
+	/**
+	* 主色板 — 品牌蓝锚定的成套数据色板（与语义状态色解耦）：
+	* 色相按取色顺序相邻差 ≥ 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/3d/core/color.js
+/**
+* 颜色工具 — 解析 / 明度调整 / 插值 / 面着色 / 设计令牌读取
+*
+* 面着色走 HSL 明度缩放而非「向白色混合」：混合白色会同时拉低饱和度，
+* 同一根柱子的顶面与侧面容易糊成一片灰；只动明度则色相与饱和度守恒，
+* 深色系色板上也能保住辨识度。
+*/
+/** 解析 #rgb / #rrggbb / #rrggbbaa / rgb() / rgba() / hsl() 为通道对象；失败返回 null */
+function parseColor(color) {
+	if (typeof color !== "string") return null;
+	const s = color.trim();
+	if (!s) return null;
+	if (s.charCodeAt(0) === 35) {
+		const hex = s.slice(1);
+		if (hex.length === 3 || hex.length === 4) {
+			const r = parseInt(hex[0] + hex[0], 16);
+			const g = parseInt(hex[1] + hex[1], 16);
+			const b = parseInt(hex[2] + hex[2], 16);
+			const a = hex.length === 4 ? parseInt(hex[3] + hex[3], 16) / 255 : 1;
+			if ([
+				r,
+				g,
+				b
+			].some(Number.isNaN)) return null;
+			return {
+				r,
+				g,
+				b,
+				a
+			};
+		}
+		if (hex.length === 6 || hex.length === 8) {
+			const r = parseInt(hex.slice(0, 2), 16);
+			const g = parseInt(hex.slice(2, 4), 16);
+			const b = parseInt(hex.slice(4, 6), 16);
+			const a = hex.length === 8 ? parseInt(hex.slice(6, 8), 16) / 255 : 1;
+			if ([
+				r,
+				g,
+				b
+			].some(Number.isNaN)) return null;
+			return {
+				r,
+				g,
+				b,
+				a
+			};
+		}
+		return null;
+	}
+	const fn = s.match(/^(rgba?|hsla?)\(([^)]+)\)$/i);
+	if (!fn) return null;
+	const parts = fn[2].split(/[,\s/]+/).filter(Boolean);
+	if (parts.length < 3) return null;
+	const nums = parts.map((p) => p.endsWith("%") ? parseFloat(p) / 100 : parseFloat(p));
+	if (nums.slice(0, 3).some((n) => !Number.isFinite(n))) return null;
+	const alpha = parts.length > 3 ? clamp01(Number.isFinite(nums[3]) ? nums[3] : 1) : 1;
+	if (fn[1].toLowerCase().startsWith("hsl")) return {
+		...hslToRgb(nums[0], clamp01(nums[1]), clamp01(nums[2])),
+		a: alpha
+	};
+	return {
+		r: clampByte(nums[0]),
+		g: clampByte(nums[1]),
+		b: clampByte(nums[2]),
+		a: alpha
+	};
+}
+function clampByte(v) {
+	if (!Number.isFinite(v)) return 0;
+	return Math.max(0, Math.min(255, Math.round(v)));
+}
+function clamp01(v) {
+	if (!Number.isFinite(v)) return 0;
+	return v < 0 ? 0 : v > 1 ? 1 : v;
+}
+function rgbToHex(r, g, b) {
+	const to = (v) => clampByte(v).toString(16).padStart(2, "0");
+	return `#${to(r)}${to(g)}${to(b)}`;
+}
+/** 转为带透明度的 rgba() 字符串；无法解析时原样返回，避免画布拿到非法 fillStyle */
+function toRgba(color, alpha = 1) {
+	const c = parseColor(color);
+	if (!c) return color;
+	return `rgba(${c.r},${c.g},${c.b},${clamp01(alpha) * c.a})`;
+}
+function rgbToHsl(r, g, b) {
+	const rn = clampByte(r) / 255;
+	const gn = clampByte(g) / 255;
+	const bn = clampByte(b) / 255;
+	const max = Math.max(rn, gn, bn);
+	const min = Math.min(rn, gn, bn);
+	const l = (max + min) / 2;
+	const d = max - min;
+	if (d < 1e-9) return {
+		h: 0,
+		s: 0,
+		l
+	};
+	const s = l > .5 ? d / (2 - max - min) : d / (max + min);
+	let h;
+	if (max === rn) h = ((gn - bn) / d + (gn < bn ? 6 : 0)) / 6;
+	else if (max === gn) h = ((bn - rn) / d + 2) / 6;
+	else h = ((rn - gn) / d + 4) / 6;
+	return {
+		h: h * 360,
+		s,
+		l
+	};
+}
+function hslToRgb(h, s, l) {
+	const hh = (h % 360 + 360) % 360 / 360;
+	const ss = clamp01(s);
+	const ll = clamp01(l);
+	if (ss < 1e-9) {
+		const v = clampByte(ll * 255);
+		return {
+			r: v,
+			g: v,
+			b: v
+		};
+	}
+	const q = ll < .5 ? ll * (1 + ss) : ll + ss - ll * ss;
+	const p = 2 * ll - q;
+	const channel = (t) => {
+		let tt = t;
+		if (tt < 0) tt += 1;
+		if (tt > 1) tt -= 1;
+		if (tt < 1 / 6) return p + (q - p) * 6 * tt;
+		if (tt < 1 / 2) return q;
+		if (tt < 2 / 3) return p + (q - p) * (2 / 3 - tt) * 6;
+		return p;
+	};
+	return {
+		r: clampByte(channel(hh + 1 / 3) * 255),
+		g: clampByte(channel(hh) * 255),
+		b: clampByte(channel(hh - 1 / 3) * 255)
+	};
+}
+/**
+* 明度缩放：factor > 1 提亮、< 1 压暗，色相与饱和度守恒
+* 结果明度钳制在 [0.06, 0.94]，防止出现纯黑面或纯白面导致形体感丢失
+*/
+function adjustLightness(color, factor) {
+	const c = parseColor(color);
+	if (!c) return color;
+	const { h, s, l } = rgbToHsl(c.r, c.g, c.b);
+	const rgb = hslToRgb(h, s, Math.max(.06, Math.min(.94, l * (Number.isFinite(factor) ? factor : 1))));
+	if (c.a < 1) return toRgba(rgbToHex(rgb.r, rgb.g, rgb.b), c.a);
+	return rgbToHex(rgb.r, rgb.g, rgb.b);
+}
+/** 线性混合：t=0 取 a，t=1 取 b */
+function mixColor(a, b, t) {
+	const ca = parseColor(a);
+	const cb = parseColor(b);
+	if (!ca) return b;
+	if (!cb) return a;
+	const k = clamp01(t);
+	return rgbToHex(ca.r + (cb.r - ca.r) * k, ca.g + (cb.g - ca.g) * k, ca.b + (cb.b - ca.b) * k);
+}
+/**
+* 向目标色混色相但保留自身透明度 — 雾化专用：
+* 墙面这类半透明薄纱只换色相，不会因为混入不透明的背景色而变实。
+*/
+function mixHue(color, target, t) {
+	const c = parseColor(color);
+	const g = parseColor(target);
+	if (!c || !g) return color;
+	const k = clamp01(t);
+	const hex = rgbToHex(c.r + (g.r - c.r) * k, c.g + (g.g - c.g) * k, c.b + (g.b - c.b) * k);
+	return c.a < 1 ? toRgba(hex, c.a) : hex;
+}
+function lighten(color, amount) {
+	return adjustLightness(color, 1 + clamp01(amount));
+}
+function darken(color, amount) {
+	return adjustLightness(color, 1 - clamp01(amount));
+}
+/**
+* 面着色 — 兰伯特余弦驱动明度缩放
+* lambert 为法线与光线的点积（已由调用方归一）。
+* ambient 是暗面下限，intensity 是明暗落差；两者共同决定形体的立体感强度。
+*/
+function shadeColor(color, lambert, options = {}) {
+	return adjustLightness(color, (Number.isFinite(options.ambient) ? options.ambient : .58) + (Number.isFinite(options.intensity) ? options.intensity : .82) * clamp01((lambert + 1) / 2));
+}
+/** 多色阶取样：colors 为色带、t ∈ [0,1]，用于曲面高度映射 */
+function gradientAt(colors, t) {
+	if (!Array.isArray(colors) || !colors.length) return "#888888";
+	if (colors.length === 1) return colors[0];
+	const pos = clamp01(t) * (colors.length - 1);
+	const i = Math.min(colors.length - 2, Math.floor(pos));
+	return mixColor(colors[i], colors[i + 1], pos - i);
+}
+/**
+* 读取设计令牌 — 与 evoke 生态共用 --ev-* 命名空间，换肤自动跟随
+* 无 DOM（SSR / 无头测试）时直接回落，绝不抛错
+*/
+function readToken(name, fallback) {
+	try {
+		if (typeof document === "undefined" || !document.documentElement) return fallback;
+		return getComputedStyle(document.documentElement).getPropertyValue(name).trim() || fallback;
+	} catch {
+		return fallback;
+	}
+}
+/** 判断当前是否暗色主题 — 与 evoke 生态一致，以 html.dark 为准 */
+function isDarkMode() {
+	try {
+		if (typeof document === "undefined" || !document.documentElement) return false;
+		return document.documentElement.classList.contains("dark");
+	} catch {
+		return false;
+	}
+}
+//#endregion
+//#region src/3d/types.js
+/**
+* 主题与常量 — 内置明暗结构色、i18n
+*
+* 系列色与令牌读取直接复用 evoke-charts 主体系的实现（../types.js）：
+* 同一套 --ev-color-series-N 槽位、同一套静态兜底色板，二维与三维必然同色。
+* 本文件只补三维独有部分：结构色（墙面/网格）与三维图型清单。
+*/
+/** 结构色（非数据元素）——明暗两套，与缺省色板同源 */
+var STRUCTURE_LIGHT = {
+	backgroundColor: "transparent",
+	/** 雾化基准色：背景透明时远景向它混合（空气透视的目标色） */
+	backdropColor: "#ffffff",
+	textColor: "#1f2937",
+	textColorSecondary: "#6b7280",
+	gridColor: "rgba(31, 41, 55, 0.10)",
+	wallColor: "rgba(31, 41, 55, 0.035)",
+	borderColor: "rgba(31, 41, 55, 0.16)",
+	highlightColor: "rgba(23, 93, 255, 0.16)"
+};
+var STRUCTURE_DARK = {
+	backgroundColor: "transparent",
+	backdropColor: "#1f2937",
+	textColor: "#e5e7eb",
+	textColorSecondary: "#9ca3af",
+	gridColor: "rgba(229, 231, 235, 0.12)",
+	wallColor: "rgba(229, 231, 235, 0.05)",
+	borderColor: "rgba(229, 231, 235, 0.20)",
+	highlightColor: "rgba(77, 139, 255, 0.24)"
+};
+/** 共享主体系的色板与槽位读取（兼容别名，三维内部引用不动） */
+var CHART_COLORS = CHART_COLORS$1;
+function getSeriesColors(fallbackColors) {
+	return getSeriesColors$1(fallbackColors);
+}
+var DEFAULT_I18N_ZH = {
+	tooltip: {
+		x: "X",
+		y: "Y",
+		z: "Z",
+		value: "数值",
+		total: "总计",
+		percent: "占比"
+	},
+	legend: {
+		show: "显示",
+		hide: "隐藏"
+	},
+	noData: "暂无数据"
+};
+var DEFAULT_I18N_EN = {
+	tooltip: {
+		x: "X",
+		y: "Y",
+		z: "Z",
+		value: "Value",
+		total: "Total",
+		percent: "Share"
+	},
+	legend: {
+		show: "Show",
+		hide: "Hide"
+	},
+	noData: "No Data"
+};
+function resolveI18n(options, isDark) {
+	const i18n = options && typeof options.i18n === "object" ? options.i18n : null;
+	const base = options && options.lang === "en" ? DEFAULT_I18N_EN : DEFAULT_I18N_ZH;
+	if (!i18n) return base;
+	return {
+		...base,
+		...i18n,
+		tooltip: {
+			...base.tooltip,
+			...i18n.tooltip || {}
+		},
+		legend: {
+			...base.legend,
+			...i18n.legend || {}
+		}
+	};
+}
+/** 支持的图型清单 — schema 枚举与运行时分发的唯一事实源 */
+var CHART3D_TYPES = [
+	"bar3d",
+	"line3d",
+	"scatter3d",
+	"surface3d",
+	"pie3d"
+];
+/** 进场/补间缓动 — 与 evoke-charts 的 easings 同名同义 */
+var easings = {
+	linear: (t) => t,
+	easeIn: (t) => t * t,
+	easeOut: (t) => 1 - (1 - t) * (1 - t),
+	easeInOut: (t) => t < .5 ? 2 * t * t : 1 - (-2 * t + 2) ** 2 / 2,
+	easeOutBack: (t) => {
+		return 1 + 2.70158 * (t - 1) ** 3 + 1.70158 * (t - 1) ** 2;
+	},
+	easeOutExpo: (t) => t >= 1 ? 1 : 1 - 2 ** (-10 * t)
+};
+function resolveEasing(name) {
+	return easings[name] || easings.easeOut;
+}
+/**
+* 组装主题
+* 优先级与 evoke-charts 一致：customTheme > options.palette > --ev-* 令牌 > 内置
+* （colors 字段单独裁定：customTheme.colors > paletteColors > 令牌槽位 > 内置色板）
+*/
+function getTheme(options = {}, customTheme = null, paletteColors = null) {
+	const isDark = isDarkMode();
+	const structure = isDark ? STRUCTURE_DARK : STRUCTURE_LIGHT;
+	let colors;
+	if (customTheme && Array.isArray(customTheme.colors) && customTheme.colors.length) colors = customTheme.colors;
+	else if (Array.isArray(paletteColors) && paletteColors.length) colors = paletteColors;
+	else colors = getSeriesColors(isDark ? CHART_COLORS.dark : CHART_COLORS.primary);
+	const bgRaw = readToken("--ev-bg-color", structure.backgroundColor);
+	const bgParsed = parseColor(bgRaw);
+	const backdropColor = bgParsed && bgParsed.a >= .9 ? bgRaw : readToken("--ev-bg-color-overlay", structure.backdropColor);
+	const theme = {
+		isDark,
+		...structure,
+		backgroundColor: bgRaw,
+		backdropColor,
+		textColor: readToken("--ev-text-color-primary", structure.textColor),
+		textColorSecondary: readToken("--ev-text-color-secondary", structure.textColorSecondary),
+		gridColor: readToken("--ev-border-color-lighter", structure.gridColor),
+		borderColor: readToken("--ev-border-color", structure.borderColor),
+		highlightColor: structure.highlightColor,
+		fontFamily: readToken("--ev-font-family", "'Helvetica Neue', Helvetica, 'PingFang SC', 'Microsoft YaHei', sans-serif"),
+		colors
+	};
+	if (customTheme) {
+		for (const [k, v] of Object.entries(customTheme)) if (v !== void 0) theme[k] = v;
+	}
+	return theme;
+}
+//#endregion
+//#region src/3d/palette.js
+/**
+* 三维色带注册表 — 曲面 / 色标散点的高度映射色带
+*
+* 系列色系（7 套）直接复用 evoke-charts 主体系的注册表（../palettes.js）：
+* 同 id 同色值、同一处维护，二维与三维并排必然一致。本文件只保留三维独有的
+* 连续色带（低→高）与解析函数。
+*/
+/** 系列色系 = 主体系注册表（别名导出，三维内部引用不动） */
+var CHART3D_PALETTES = CHART_PALETTES;
+var CHART3D_PALETTE_IDS = CHART_PALETTES.map((p) => p.id);
+/** 曲面高度映射色带 — 每套色系配一条低→高的连续色带，供 surface3d 取样 */
+var CHART3D_RAMPS = {
+	classic: {
+		light: [
+			"#e8f0ff",
+			"#8ab0ff",
+			"#4d86ff",
+			"#175DFF",
+			"#00329b"
+		],
+		dark: [
+			"#12244d",
+			"#26417f",
+			"#4d8bff",
+			"#9ec2ff",
+			"#e5eeff"
+		]
+	},
+	aurora: {
+		light: [
+			"#dbeafe",
+			"#93c5fd",
+			"#38bdf8",
+			"#10b981",
+			"#047857"
+		],
+		dark: [
+			"#0b2545",
+			"#155e75",
+			"#0ea5e9",
+			"#34d399",
+			"#d1fae5"
+		]
+	},
+	sunset: {
+		light: [
+			"#fff7ed",
+			"#fdba74",
+			"#f97316",
+			"#e11d48",
+			"#881337"
+		],
+		dark: [
+			"#3b1109",
+			"#9a3412",
+			"#f97316",
+			"#fb7185",
+			"#ffe4e6"
+		]
+	},
+	viridis: {
+		light: [
+			"#440154",
+			"#31688e",
+			"#35b779",
+			"#fde725"
+		],
+		dark: [
+			"#440154",
+			"#31688e",
+			"#35b779",
+			"#fde725"
+		]
+	},
+	heat: {
+		light: [
+			"#fff5eb",
+			"#fdd0a2",
+			"#fd8d3c",
+			"#d94801",
+			"#7f2704"
+		],
+		dark: [
+			"#2b0f00",
+			"#8c2d04",
+			"#d94801",
+			"#fdd0a2",
+			"#fff5eb"
+		]
+	},
+	mono: {
+		light: [
+			"#f3f4f6",
+			"#9ca3af",
+			"#4b5563",
+			"#111827"
+		],
+		dark: [
+			"#111827",
+			"#4b5563",
+			"#9ca3af",
+			"#f3f4f6"
+		]
+	}
+};
+/** 按 id 取曲面色带；未指定时随色系联动，未知 id 返回 null */
+function resolveChartRamp(id, isDark) {
+	const ramp = CHART3D_RAMPS[id];
+	if (!ramp) return null;
+	return (isDark ? ramp.dark : ramp.light).slice();
+}
+//#endregion
+//#region src/3d/schema.js
+/**
+* Options 校验 — 手写 JSON-Schema 子集（与 evoke-charts 同一套实现思路）
+*
+* 校验只告警不阻断：dev 模式下组件把警告打印到控制台，生产渲染永不受影响。
+* 好处是图型能力可以先行，契约滞后一步不会炸掉用户的页面。
+*/
+var seriesSchema = {
+	type: "object",
+	properties: {
+		name: { type: "string" },
+		data: { type: "array" },
+		color: { type: "string" }
+	}
+};
+var pieItemSchema = {
+	type: "object",
+	properties: {
+		name: { type: "string" },
+		value: { type: "number" },
+		color: { type: "string" }
+	}
+};
+var axisSchema = {
+	type: "object",
+	properties: {
+		show: { type: "boolean" },
+		labels: { type: "boolean" },
+		grid: { type: "boolean" },
+		line: { type: "boolean" },
+		title: { type: "boolean" },
+		name: { type: "string" },
+		type: {
+			type: "string",
+			enum: ["category", "value"]
+		},
+		min: { type: "number" },
+		max: { type: "number" },
+		ticks: { type: "number" },
+		maxTicks: { type: "number" },
+		padding: { type: "number" },
+		headroom: { type: "number" },
+		formatter: { type: "function" }
+	}
+};
+var chart3dOptionsSchema = {
+	type: "object",
+	required: ["type"],
+	properties: {
+		type: {
+			type: "string",
+			enum: CHART3D_TYPES
+		},
+		labels: { type: "array" },
+		series: {
+			type: "array",
+			items: seriesSchema
+		},
+		pieData: {
+			type: "array",
+			items: pieItemSchema
+		},
+		scatterData: { type: "array" },
+		surfaceData: {
+			type: "object",
+			properties: {
+				x: { type: "array" },
+				y: { type: "array" },
+				z: {
+					type: "array",
+					items: { type: "array" }
+				}
+			}
+		},
+		matrix: {
+			type: "array",
+			items: { type: "array" }
+		},
+		palette: {
+			type: "string",
+			enum: CHART3D_PALETTE_IDS
+		},
+		theme: { type: "object" },
+		colors: { type: "array" },
+		camera: {
+			type: "object",
+			properties: {
+				yaw: { type: "number" },
+				pitch: { type: "number" },
+				distance: { type: "number" },
+				fov: { type: "number" },
+				target: { type: "array" },
+				minPitch: { type: "number" },
+				maxPitch: { type: "number" },
+				minDistance: { type: "number" },
+				maxDistance: { type: "number" },
+				autoRotate: { type: "boolean" },
+				autoRotateSpeed: { type: "number" },
+				damping: { type: "number" }
+			}
+		},
+		xAxis: axisSchema,
+		yAxis: axisSchema,
+		zAxis: axisSchema,
+		grid: {
+			type: "object",
+			properties: { show: { type: "boolean" } }
+		},
+		box: {
+			type: "object",
+			properties: {
+				show: { type: "boolean" },
+				walls: {
+					type: ["string", "boolean"],
+					enum: [
+						"all",
+						"back",
+						"side",
+						"none",
+						true,
+						false
+					]
+				},
+				frame: { type: "boolean" }
+			}
+		},
+		lighting: {
+			type: "object",
+			properties: {
+				ambient: { type: "number" },
+				intensity: { type: "number" },
+				follow: { type: "boolean" },
+				direction: { type: "array" },
+				flat: { type: "boolean" }
+			}
+		},
+		depth: {
+			type: "object",
+			properties: {
+				haze: { type: "number" },
+				edge: { type: "number" },
+				gradient: { type: "number" }
+			}
+		},
+		bar: {
+			type: "object",
+			properties: {
+				width: { type: "number" },
+				depth: { type: "number" },
+				shadow: { type: "boolean" },
+				shadowStrength: { type: "number" },
+				shadowOffset: { type: "array" }
+			}
+		},
+		line: {
+			type: "object",
+			properties: {
+				area: { type: "boolean" },
+				dropLines: { type: "boolean" },
+				width: { type: "number" },
+				points: { type: "boolean" },
+				pointRadius: { type: "number" }
+			}
+		},
+		scatter: {
+			type: "object",
+			properties: {
+				size: { type: "number" },
+				dropLines: { type: "boolean" },
+				colorScale: { type: ["boolean", "string"] },
+				depthScale: { type: "boolean" }
+			}
+		},
+		surface: {
+			type: "object",
+			properties: {
+				wireframe: { type: "boolean" },
+				opacity: { type: "number" },
+				ramp: { type: "string" }
+			}
+		},
+		pie: {
+			type: "object",
+			properties: {
+				radius: { type: "number" },
+				innerRadius: { type: "number" },
+				thickness: { type: "number" },
+				startAngle: { type: "number" },
+				padAngle: { type: "number" },
+				shadow: { type: "boolean" },
+				shadowStrength: { type: "number" }
+			}
+		},
+		legend: {
+			type: "object",
+			properties: {
+				show: { type: "boolean" },
+				position: {
+					type: "string",
+					enum: ["top", "bottom"]
+				},
+				align: {
+					type: "string",
+					enum: [
+						"start",
+						"center",
+						"end"
+					]
+				},
+				formatter: { type: "function" },
+				itemGap: { type: "number" }
+			}
+		},
+		tooltip: {
+			type: "object",
+			properties: {
+				show: { type: "boolean" },
+				trigger: {
+					type: "string",
+					enum: ["hover", "click"]
+				},
+				formatter: { type: "function" },
+				valueFormatter: { type: "function" }
+			}
+		},
+		label: {
+			type: "object",
+			properties: { show: { type: "boolean" } }
+		},
+		title: {
+			type: ["string", "object"],
+			properties: {
+				text: { type: "string" },
+				subtitle: { type: "string" },
+				show: { type: "boolean" },
+				left: { type: "number" }
+			}
+		},
+		animation: {
+			type: "object",
+			properties: {
+				enabled: { type: "boolean" },
+				duration: { type: "number" },
+				easing: {
+					type: "string",
+					enum: [
+						"linear",
+						"easeIn",
+						"easeOut",
+						"easeInOut",
+						"easeOutBack",
+						"easeOutExpo"
+					]
+				}
+			}
+		},
+		ariaLabel: { type: "string" },
+		lang: {
+			type: "string",
+			enum: ["zh", "en"]
+		},
+		i18n: { type: "object" }
+	}
+};
+var TYPE_CHECKS = {
+	object: (v) => v !== null && typeof v === "object" && !Array.isArray(v),
+	array: (v) => Array.isArray(v),
+	string: (v) => typeof v === "string",
+	number: (v) => typeof v === "number" && Number.isFinite(v),
+	boolean: (v) => typeof v === "boolean",
+	function: (v) => typeof v === "function"
+};
+function typeMatches(node, value) {
+	return (Array.isArray(node.type) ? node.type : [node.type]).some((t) => {
+		const check = TYPE_CHECKS[t];
+		return check ? check(value) : true;
+	});
+}
+function typeName(value) {
+	if (value === null) return "null";
+	if (Array.isArray(value)) return "array";
+	return typeof value;
+}
+function validateNode(node, value, path, warnings) {
+	if (!node || typeof node !== "object") return;
+	if (node.type && !typeMatches(node, value)) {
+		warnings.push({
+			path,
+			message: Array.isArray(node.type) ? `类型不匹配（应为 ${node.type.join(" / ")} 之一）` : `应为 ${node.type}，实际为 ${typeName(value)}`
+		});
+		return;
+	}
+	if (node.enum && !node.enum.includes(value)) {
+		warnings.push({
+			path,
+			message: `应为 ${node.enum.map((e) => String(e)).join(" / ")} 之一，实际为 ${String(value)}`
+		});
+		return;
+	}
+	if (node.type === "object" && TYPE_CHECKS.object(value)) {
+		for (const key of node.required || []) if (!(key in value)) warnings.push({
+			path: `${path}.${key}`,
+			message: "缺少必填字段"
+		});
+		if (node.properties) {
+			for (const [key, sub] of Object.entries(node.properties)) if (key in value && value[key] !== void 0 && value[key] !== null) validateNode(sub, value[key], `${path}.${key}`, warnings);
+		}
+	}
+	if (node.type === "array" && Array.isArray(value)) {
+		if (node.items) value.forEach((item, i) => validateNode(node.items, item, `${path}[${i}]`, warnings));
+	}
+}
+/**
+* 校验 options
+* @returns {{ok: boolean, warnings: Array<{path:string, message:string}>}}
+*/
+function validateOptions3d(options) {
+	const warnings = [];
+	if (options === null || typeof options !== "object" || Array.isArray(options)) return {
+		ok: false,
+		warnings: [{
+			path: "options",
+			message: "应为对象"
+		}]
+	};
+	validateNode(chart3dOptionsSchema, options, "options", warnings);
+	return {
+		ok: warnings.length === 0,
+		warnings
+	};
+}
+//#endregion
+export { DOWN_COLOR as C, getSeriesColors$1 as D, formatValue as E, readChartToken as O, DEFAULT_I18N_ZH$1 as S, VOLUME_SERIES_NAME as T, shadeColor as _, CHART3D_RAMPS as a, resolveChartPalette as b, CHART_COLORS as c, resolveEasing as d, resolveI18n as f, mixHue as g, lighten as h, CHART3D_PALETTE_IDS as i, easings as l, gradientAt as m, validateOptions3d as n, resolveChartRamp as o, darken as p, CHART3D_PALETTES as r, CHART3D_TYPES as s, chart3dOptionsSchema as t, getTheme as u, toRgba as v, UP_COLOR as w, CHART_COLORS$1 as x, CHART_PALETTES as y };