@wil-works/evoke-charts 0.2.0 → 0.3.0

package/dist/index.mjs

@@ -1,4 +1,4 @@
-import { Fragment, Transition, computed, createBlock, createCommentVNode, createElementBlock, createElementVNode, createVNode, h, inject, nextTick, normalizeClass, normalizeStyle, onMounted, onUnmounted, openBlock, provide, ref, renderList, resolveDynamicComponent, toDisplayString, watch, withCtx } from "vue";
+import { Fragment, Transition, computed, createBlock, createCommentVNode, createElementBlock, createElementVNode, createVNode, h, inject, nextTick, normalizeClass, normalizeStyle, onMounted, onUnmounted, openBlock, provide, ref, renderList, renderSlot, resolveDynamicComponent, toDisplayString, watch, withCtx } from "vue";
 //#region src/types.js
 var DEFAULT_I18N_ZH = {
 	tooltip: {
@@ -320,6 +320,15 @@ function estimateYAxisLeft(options) {
 	const axisConfig = options.yAxis || {};
 	if (axisConfig.type === "log") return 65;
 	try {
+		if (options.type === "horizontal-bar") {
+			const formatter = axisConfig.formatter;
+			const maxW = (options.labels || []).reduce((m, l) => {
+				const label = formatter ? String(formatter(l)) : String(l);
+				return Math.max(m, estimateTextWidth(label, 12));
+			}, 0);
+			if (!maxW) return 65;
+			return Math.max(40, Math.min(140, Math.round(maxW + 26)));
+		}
 		const range = calculateRange(options, /* @__PURE__ */ new Set(), false);
 		const min = axisConfig.min ?? range?.min;
 		const max = axisConfig.max ?? range?.max;
@@ -420,10 +429,12 @@ function getPadding(options, containerWidth = 600) {
 	}
 	const pad = resolveUserPadding(options);
 	const xAxisHidden = options.xAxis?.show === false;
+	const yAxisWidth = options.yAxis?.width;
+	const yAxisRightWidth = options.yAxisRight?.width;
 	let top = (pad.top ?? 18) + titleBlockHeight(options) + (legendPosition === "top" ? LEGEND_BAND + legendRowsExtra : 0);
 	let bottom = (pad.bottom ?? (xAxisHidden ? 12 : 46)) + (legendPosition === "bottom" ? LEGEND_BAND + legendRowsExtra : 0);
-	let left = pad.left ?? estimateYAxisLeft(options);
-	let right = pad.right ?? (hasYAxisRight ? 65 : 24);
+	let left = pad.left ?? (typeof yAxisWidth === "number" && yAxisWidth > 0 ? yAxisWidth : estimateYAxisLeft(options));
+	let right = pad.right ?? (typeof yAxisRightWidth === "number" && yAxisRightWidth > 0 ? yAxisRightWidth : hasYAxisRight ? 65 : 24);
 	if (legendPosition === "left") left += 80;
 	if (legendPosition === "right") right += 80;
 	if (hasXAxis && hasXAxisTitle) return {
@@ -639,12 +650,15 @@ function calculateRange(options, hiddenSeries, useRightAxis) {
 	const range = max - min || 1;
 	if (min >= 0) return {
 		min: 0,
-		max: max + range * .1
-	};
-	else return {
-		min: min - range * .1,
-		max: max + range * .1
+		max: max + Math.max(range * .1, max * .05)
 	};
+	else {
+		const pad = Math.max(range * .1, Math.max(Math.abs(max), Math.abs(min)) * .05);
+		return {
+			min: min - pad,
+			max: max + pad
+		};
+	}
 }
 function applyLogTransform(options) {
 	if (options.yAxis?.type !== "log") return options;
@@ -769,6 +783,20 @@ function truncateLabel(canvasCtx, label, maxWidth) {
 	}
 	return label.slice(0, lo) + "…";
 }
+/**
+* 抽稀刻度：保留首末两端覆盖，步长取整数倍使数量 ≤ maxCount。
+* nice 算法的 step 候选会让实际刻度数超出请求数（如 ticks:3 得到 5 档），
+* 显式 ticks 视为硬上限，超出的中间档按均匀步长抽稀（round 值不丢）。
+*/
+function thinTickValues(values, maxCount) {
+	const limit = Math.max(2, maxCount);
+	if (values.length <= limit) return values;
+	let stride = Math.ceil((values.length - 1) / (limit - 1));
+	while (stride < values.length - 1 && (values.length - 1) % stride !== 0) stride += 1;
+	const thinned = [];
+	for (let i = 0; i < values.length; i += stride) thinned.push(values[i]);
+	return thinned;
+}
 function drawAxisLine(canvasCtx, cfg, theme, x1, y1, x2, y2) {
 	if (cfg?.axisLine?.show === false) return;
 	canvasCtx.save();
@@ -795,7 +823,10 @@ function drawAxisTick(canvasCtx, cfg, theme, x, y, dx, dy) {
 function renderYAxis(ctx, side = "left", dataRange) {
 	const { ctx: canvasCtx, theme, plotArea, options, width } = ctx;
 	const axisConfig = side === "left" ? options.yAxis || {} : options.yAxisRight || {};
-	const ticks = axisConfig.ticks || 5;
+	const requestedTicks = axisConfig.ticks || 5;
+	const maxByHeight = Math.max(2, Math.floor(plotArea.height / 24) + 1);
+	const tickCap = axisConfig.ticks != null ? Math.min(requestedTicks, maxByHeight) : maxByHeight;
+	const needsThin = axisConfig.ticks != null || maxByHeight < requestedTicks;
 	const isLog = side === "left" && axisConfig.type === "log";
 	let computedMax;
 	let computedMin;
@@ -810,7 +841,8 @@ function renderYAxis(ctx, side = "left", dataRange) {
 		}
 	}
 	const max = axisConfig.max ?? computedMax;
-	const { min: actualMin, max: actualMax, tickValues } = resolveTickExtendedRange(axisConfig.min ?? computedMin, max, ticks);
+	const { min: actualMin, max: actualMax, tickValues: niceTicks } = resolveTickExtendedRange(axisConfig.min ?? computedMin, max, requestedTicks);
+	const tickValues = needsThin ? thinTickValues(niceTicks, tickCap) : niceTicks;
 	canvasCtx.save();
 	canvasCtx.strokeStyle = theme.gridColor;
 	canvasCtx.fillStyle = theme.textColorSecondary;
@@ -1041,6 +1073,10 @@ function xToCategoryIndex(options, plotArea, labels, x) {
 	return Math.round((x - plotArea.x) / step);
 }
 function renderAnnotations(ctx, yRange) {
+	renderLegacyAnnotation(ctx, yRange);
+	renderNarrativeAnnotations(ctx, yRange);
+}
+function renderLegacyAnnotation(ctx, yRange) {
 	const { ctx: canvasCtx, theme, plotArea, options } = ctx;
 	const annotation = options.annotation;
 	if (!annotation) return;
@@ -1103,6 +1139,196 @@ function renderAnnotations(ctx, yRange) {
 		canvasCtx.restore();
 	});
 }
+var ANNOTATION_ANCHORS = {
+	top: [
+		0,
+		-1,
+		"center",
+		"bottom"
+	],
+	bottom: [
+		0,
+		1,
+		"center",
+		"top"
+	],
+	left: [
+		-1,
+		0,
+		"end",
+		"middle"
+	],
+	right: [
+		1,
+		0,
+		"start",
+		"middle"
+	],
+	"top-left": [
+		-1,
+		-1,
+		"end",
+		"bottom"
+	],
+	"top-right": [
+		1,
+		-1,
+		"start",
+		"bottom"
+	],
+	"bottom-left": [
+		-1,
+		1,
+		"end",
+		"top"
+	],
+	"bottom-right": [
+		1,
+		1,
+		"start",
+		"top"
+	]
+};
+function resolveAnnotationX(ctx, x, xPx) {
+	if (typeof xPx === "number") return xPx;
+	const { plotArea, options } = ctx;
+	const labels = options.labels || [];
+	const idx = typeof x === "number" ? x : labels.indexOf(x);
+	if (idx < 0) return NaN;
+	return categoryToX(options, plotArea, labels, idx);
+}
+function resolveAnnotationY(ctx, y, yPx, yRange) {
+	if (typeof yPx === "number") return yPx;
+	if (typeof y !== "number" || !yRange) return NaN;
+	const { plotArea } = ctx;
+	return plotArea.y + plotArea.height - (y - yRange.min) / (yRange.max - yRange.min) * plotArea.height;
+}
+function annotationSeriesColor(ctx, ref) {
+	const { theme, options } = ctx;
+	const series = options.series || [];
+	if (typeof ref === "number") return series[ref]?.color || theme.colors[ref] || theme.colors[0] || "#175DFF";
+	if (typeof ref === "string") {
+		const i = series.findIndex((s) => s.name === ref);
+		if (i >= 0) return series[i].color || theme.colors[i] || theme.colors[0] || "#175DFF";
+	}
+	return theme.colors[0] || "#175DFF";
+}
+function renderNarrativeAnnotations(ctx, yRange) {
+	const { ctx: canvasCtx, theme, plotArea, options } = ctx;
+	const list = options.annotations || [];
+	if (list.length === 0) return;
+	const secondary = theme.textColorSecondary;
+	list.forEach((a) => {
+		if (!a || !a.type) return;
+		if (a.type === "region") {
+			const x1 = resolveAnnotationX(ctx, a.from);
+			const x2 = resolveAnnotationX(ctx, a.to);
+			if (!Number.isFinite(x1) || !Number.isFinite(x2)) return;
+			const labels = options.labels || [];
+			const band = labels.length > 0 ? plotArea.width / labels.length : 0;
+			const left = Math.min(x1, x2) - band / 2;
+			const width = Math.abs(x2 - x1) + band;
+			canvasCtx.save();
+			canvasCtx.globalAlpha = .06;
+			canvasCtx.fillStyle = a.color || theme.colors[0] || "#175DFF";
+			canvasCtx.fillRect(left, plotArea.y, width, plotArea.height);
+			canvasCtx.restore();
+			if (a.label) {
+				canvasCtx.save();
+				canvasCtx.fillStyle = secondary;
+				canvasCtx.font = "italic 400 11px Inter, sans-serif";
+				canvasCtx.textAlign = "left";
+				canvasCtx.textBaseline = "top";
+				canvasCtx.fillText(a.label, left + 4, plotArea.y + 6);
+				canvasCtx.restore();
+			}
+			return;
+		}
+		const px = resolveAnnotationX(ctx, a.x, a.xPx);
+		const py = resolveAnnotationY(ctx, a.y, a.yPx, yRange);
+		if (!Number.isFinite(px) || !Number.isFinite(py)) return;
+		const color = a.color || annotationSeriesColor(ctx, a.series);
+		canvasCtx.save();
+		if (a.type === "point") {
+			canvasCtx.fillStyle = color;
+			canvasCtx.beginPath();
+			canvasCtx.arc(px, py, 3, 0, Math.PI * 2);
+			canvasCtx.fill();
+			canvasCtx.globalAlpha = .85;
+			canvasCtx.strokeStyle = color;
+			canvasCtx.lineWidth = 1.5;
+			canvasCtx.beginPath();
+			canvasCtx.arc(px, py, 6, 0, Math.PI * 2);
+			canvasCtx.stroke();
+			canvasCtx.restore();
+			return;
+		}
+		if (a.type === "delta") {
+			const up = a.direction !== "down";
+			const deltaColor = a.color || (up ? options.candleUpColor || "#dc2626" : options.candleDownColor || "#16a34a");
+			const text = a.text || a.label || "";
+			canvasCtx.fillStyle = deltaColor;
+			canvasCtx.beginPath();
+			if (up) {
+				canvasCtx.moveTo(px, py - 16);
+				canvasCtx.lineTo(px - 5, py - 9);
+				canvasCtx.lineTo(px + 5, py - 9);
+			} else {
+				canvasCtx.moveTo(px, py + 16);
+				canvasCtx.lineTo(px - 5, py + 9);
+				canvasCtx.lineTo(px + 5, py + 9);
+			}
+			canvasCtx.closePath();
+			canvasCtx.fill();
+			if (text) {
+				canvasCtx.fillStyle = deltaColor;
+				canvasCtx.font = "600 11px Inter, sans-serif";
+				canvasCtx.textAlign = "center";
+				if (up) {
+					canvasCtx.textBaseline = "bottom";
+					canvasCtx.fillText(text, px, py - 20);
+				} else {
+					canvasCtx.textBaseline = "top";
+					canvasCtx.fillText(text, px, py + 20);
+				}
+			}
+			canvasCtx.restore();
+			return;
+		}
+		if (a.type === "callout") {
+			const [dx, dy, align, baseline] = ANNOTATION_ANCHORS[a.anchor] || ANNOTATION_ANCHORS["top-right"];
+			const lx = px + dx * 16 + (a.offsetX || 0);
+			const ly = py + dy * 16 + (a.offsetY || 0);
+			canvasCtx.fillStyle = color;
+			canvasCtx.strokeStyle = color;
+			canvasCtx.lineWidth = 1;
+			canvasCtx.setLineDash([3, 3]);
+			canvasCtx.beginPath();
+			canvasCtx.arc(px, py, 2, 0, Math.PI * 2);
+			canvasCtx.fill();
+			canvasCtx.beginPath();
+			canvasCtx.moveTo(px + dx * 2, py + dy * 2);
+			canvasCtx.lineTo(lx - dx * 2, ly - dy * 2);
+			canvasCtx.stroke();
+			canvasCtx.setLineDash([]);
+			if (a.label) {
+				canvasCtx.fillStyle = a.textColor || secondary;
+				canvasCtx.font = "italic 400 11px Inter, sans-serif";
+				canvasCtx.textAlign = align;
+				canvasCtx.textBaseline = baseline;
+				canvasCtx.fillText(a.label, lx + dx * 2, ly + dy * 2);
+			}
+			canvasCtx.restore();
+			return;
+		}
+		canvasCtx.fillStyle = a.color || secondary;
+		canvasCtx.font = `italic ${a.fontWeight || 400} 11px Inter, sans-serif`;
+		canvasCtx.textAlign = "center";
+		canvasCtx.textBaseline = "bottom";
+		canvasCtx.fillText(a.text || a.label || "", px + (a.offsetX || 0), py + (a.offsetY !== void 0 ? a.offsetY : -6));
+		canvasCtx.restore();
+	});
+}
 function renderHoverHighlight(ctx, points) {
 	if (ctx.hoverIndex < 0) return;
 	const { ctx: canvasCtx, theme, plotArea } = ctx;
@@ -3966,6 +4192,13 @@ function createSvgRecorder(real) {
 }
 //#endregion
 //#region src/renderer/index.js
+function runLayers(renderCtx, at) {
+	const layers = renderCtx.options.layers;
+	if (!Array.isArray(layers)) return;
+	layers.forEach((layer) => {
+		if (layer && typeof layer.draw === "function" && (layer.at || "front") === at) layer.draw(renderCtx.ctx, renderCtx);
+	});
+}
 function renderChart(canvas, params) {
 	const { options: rawOptions, ctx: externalCtx, dpr = window.devicePixelRatio || 1, progress = 1, hoverIndex = -1, hiddenSeries = /* @__PURE__ */ new Set(), mouseX = -1, mouseY = -1, showCrosshair = false, hoverAnimProgress = 1, zoomRange, brushRect, focusSeries = null, hoveredToolbox = null } = params;
 	const options = applyLogTransform(rawOptions);
@@ -4003,6 +4236,7 @@ function renderChart(canvas, params) {
 		focusSeries
 	};
 	renderTitle(renderCtx, options.subtitle ? 12 : 15);
+	runLayers(renderCtx, "back");
 	let points = [];
 	let leftRange;
 	switch (options.type) {
@@ -4146,7 +4380,8 @@ function renderChart(canvas, params) {
 			break;
 		}
 	}
-	if (leftRange && options.annotation) renderAnnotations(renderCtx, leftRange);
+	runLayers(renderCtx, "after-series");
+	if (leftRange && (options.annotation || options.annotations && options.annotations.length > 0)) renderAnnotations(renderCtx, leftRange);
 	if ((options.type === "line" || options.type === "area") && points.length > 0) renderHoverHighlight(renderCtx, points);
 	if (points.length > 0) renderCrosshair(renderCtx, points);
 	if (zoomRange) renderDataZoomSlider(renderCtx, zoomRange);
@@ -4164,6 +4399,7 @@ function renderChart(canvas, params) {
 		ctx.strokeRect(x, y, w, h);
 		ctx.restore();
 	}
+	runLayers(renderCtx, "front");
 	if (options.type !== "sparkline") renderLegend(renderCtx);
 	if (options.type !== "sparkline") renderToolbox(renderCtx, hoveredToolbox);
 	ctx.restore();
@@ -4191,6 +4427,372 @@ function broadcastConnect(group, source, apply) {
 		if (target !== source) apply(target);
 	});
 }
+var chartOptionsSchema = {
+	$schema: "http://json-schema.org/draft-07/schema#",
+	title: "EvChart Options",
+	type: "object",
+	required: ["type"],
+	properties: {
+		type: {
+			type: "string",
+			enum: [
+				"line",
+				"area",
+				"bar",
+				"stacked-bar",
+				"horizontal-bar",
+				"pie",
+				"doughnut",
+				"rose",
+				"radar",
+				"scatter",
+				"funnel",
+				"gauge",
+				"heatmap",
+				"candle",
+				"bin",
+				"bullet",
+				"treemap",
+				"sparkline",
+				"waterfall",
+				"boxplot",
+				"sunburst",
+				"mixed"
+			]
+		},
+		title: { type: "string" },
+		subtitle: { type: "string" },
+		labels: { type: "array" },
+		series: {
+			type: "array",
+			items: {
+				type: "object",
+				required: ["name", "data"],
+				properties: {
+					name: { type: "string" },
+					data: { type: "array" },
+					color: { type: "string" },
+					showSymbol: { type: "boolean" },
+					lineWidth: { type: "number" },
+					smooth: { type: "boolean" },
+					yAxis: {
+						type: "string",
+						enum: ["left", "right"]
+					},
+					type: { type: "string" },
+					area: { type: "boolean" }
+				}
+			}
+		},
+		legend: {
+			type: "object",
+			properties: {
+				show: { type: "boolean" },
+				position: {
+					type: "string",
+					enum: ["top", "bottom"]
+				},
+				interactive: { type: "boolean" },
+				hoverEmphasis: { type: "boolean" }
+			}
+		},
+		tooltip: {
+			type: "object",
+			properties: {
+				show: { type: "boolean" },
+				trigger: {
+					type: "string",
+					enum: ["hover", "click"]
+				},
+				showAllSeries: { type: "boolean" },
+				formatter: { type: "function" }
+			}
+		},
+		animation: {
+			type: "object",
+			properties: {
+				enabled: { type: "boolean" },
+				duration: { type: "number" },
+				easing: { type: "string" }
+			}
+		},
+		xAxis: {
+			type: "object",
+			properties: {
+				show: { type: "boolean" },
+				min: { type: "number" },
+				max: { type: "number" },
+				ticks: { type: "integer" },
+				grid: {
+					type: "object",
+					properties: {
+						show: { type: "boolean" },
+						style: {
+							type: "string",
+							enum: ["solid", "dashed"]
+						}
+					}
+				}
+			}
+		},
+		yAxis: {
+			type: "object",
+			properties: {
+				show: { type: "boolean" },
+				min: { type: "number" },
+				max: { type: "number" },
+				ticks: { type: "integer" },
+				width: { type: "number" },
+				grid: {
+					type: "object",
+					properties: {
+						show: { type: "boolean" },
+						style: {
+							type: "string",
+							enum: ["solid", "dashed"]
+						}
+					}
+				}
+			}
+		},
+		yAxisRight: { $ref: "#/properties/yAxis" },
+		padding: { oneOf: [{ type: "number" }, {
+			type: "object",
+			properties: {
+				top: { type: "number" },
+				right: { type: "number" },
+				bottom: { type: "number" },
+				left: { type: "number" }
+			}
+		}] },
+		dataZoom: {
+			type: "object",
+			properties: {
+				enabled: { type: "boolean" },
+				start: { type: "number" },
+				end: { type: "number" },
+				position: {
+					type: "string",
+					enum: ["bottom", "top"]
+				},
+				height: { type: "number" },
+				mouseWheel: { type: "boolean" }
+			}
+		},
+		toolbox: {
+			type: "object",
+			properties: {
+				show: { type: "boolean" },
+				filename: { type: "string" }
+			}
+		},
+		theme: { type: "object" },
+		layers: {
+			type: "array",
+			items: {
+				type: "object",
+				properties: {
+					at: {
+						type: "string",
+						enum: [
+							"back",
+							"after-series",
+							"front"
+						]
+					},
+					draw: { type: "function" }
+				}
+			}
+		},
+		emphasis: {
+			type: "object",
+			properties: {
+				series: { oneOf: [{ type: "string" }, { type: "integer" }] },
+				dimOthers: { type: "boolean" }
+			}
+		},
+		annotations: {
+			type: "array",
+			items: {
+				type: "object",
+				oneOf: [{
+					required: [
+						"type",
+						"x",
+						"y"
+					],
+					properties: { type: { enum: [
+						"text",
+						"callout",
+						"delta",
+						"point"
+					] } }
+				}, {
+					required: [
+						"type",
+						"from",
+						"to"
+					],
+					properties: { type: { enum: ["region"] } }
+				}],
+				properties: {
+					type: {
+						type: "string",
+						enum: [
+							"text",
+							"callout",
+							"region",
+							"delta",
+							"point"
+						]
+					},
+					x: {},
+					y: { type: "number" },
+					from: {},
+					to: {},
+					at: {},
+					label: { type: "string" },
+					text: { type: "string" },
+					anchor: {
+						type: "string",
+						enum: [
+							"top",
+							"bottom",
+							"left",
+							"right",
+							"top-left",
+							"top-right",
+							"bottom-left",
+							"bottom-right"
+						]
+					},
+					color: { type: "string" },
+					offsetX: { type: "number" },
+					offsetY: { type: "number" },
+					xPx: { type: "number" },
+					yPx: { type: "number" }
+				}
+			}
+		},
+		annotation: { type: "object" },
+		markLine: { type: "array" },
+		markArea: { type: "array" },
+		scenes: {
+			type: "object",
+			properties: {
+				autoplay: { type: "boolean" },
+				loop: { type: "boolean" },
+				items: {
+					type: "array",
+					items: {
+						type: "object",
+						required: ["patch"],
+						properties: {
+							patch: { type: "object" },
+							duration: { type: "number" },
+							hold: { type: "number" }
+						}
+					}
+				}
+			}
+		},
+		pieData: { type: "array" },
+		radarSeries: { type: "array" },
+		radarIndicators: { type: "array" },
+		scatterData: { type: "array" },
+		funnelData: { type: "array" },
+		gauge: { oneOf: [{ type: "number" }, { type: "object" }] },
+		heatmapData: { type: "array" },
+		candleData: { type: "array" },
+		bulletData: { type: "array" },
+		boxData: { type: "array" },
+		loading: { type: "boolean" },
+		emptyText: { type: "string" },
+		ariaLabel: { type: "string" },
+		i18n: { type: "object" },
+		connectGroup: { type: "string" },
+		brush: {
+			type: "object",
+			properties: { enabled: { type: "boolean" } }
+		},
+		logAxis: { type: "boolean" },
+		valueFormatter: { type: "function" },
+		timeAxis: { type: "boolean" }
+	}
+};
+var TYPE_CHECKS = {
+	string: (v) => typeof v === "string",
+	number: (v) => typeof v === "number" && Number.isFinite(v),
+	integer: (v) => typeof v === "number" && Number.isInteger(v),
+	boolean: (v) => typeof v === "boolean",
+	object: (v) => v !== null && typeof v === "object" && !Array.isArray(v),
+	array: (v) => Array.isArray(v),
+	function: (v) => typeof v === "function"
+};
+function typeMatches(node, value) {
+	if (Array.isArray(node.type)) return node.type.some((t) => TYPE_CHECKS[t]?.(value));
+	const check = TYPE_CHECKS[node.type];
+	return check ? check(value) : true;
+}
+function validateNode(node, value, path, warnings) {
+	if (node == null || value === void 0 || value === null) return;
+	if (node.oneOf) {
+		if (!node.oneOf.some((branch) => {
+			const before = warnings.length;
+			validateNode(branch, value, path, warnings);
+			const ok = warnings.length === before;
+			warnings.length = before;
+			return ok;
+		})) {
+			warnings.push({
+				path,
+				message: "类型不匹配（应为 oneOf 之一）"
+			});
+			return;
+		}
+	}
+	if (node.type && !typeMatches(node, value)) {
+		warnings.push({
+			path,
+			message: `应为 ${node.type}，实际为 ${Array.isArray(value) ? "array" : typeof value}`
+		});
+		return;
+	}
+	if (node.enum && !node.enum.includes(value)) {
+		warnings.push({
+			path,
+			message: `应为 ${node.enum.join(" / ")} 之一，实际为 ${String(value)}`
+		});
+		return;
+	}
+	if (node.type === "object") {
+		(node.required || []).forEach((key) => {
+			if (value[key] === void 0) warnings.push({
+				path: `${path}.${key}`,
+				message: "缺少必填字段"
+			});
+		});
+		if (node.properties) Object.entries(node.properties).forEach(([key, sub]) => {
+			if (value[key] !== void 0) validateNode(sub, value[key], `${path}.${key}`, warnings);
+		});
+	}
+	if (node.type === "array" && node.items && Array.isArray(value)) value.forEach((item, i) => validateNode(node.items, item, `${path}[${i}]`, warnings));
+}
+function validateOptions(options) {
+	const warnings = [];
+	if (options === null || typeof options !== "object" || Array.isArray(options)) return {
+		ok: false,
+		warnings: [{
+			path: "options",
+			message: "应为对象"
+		}]
+	};
+	validateNode(chartOptionsSchema, options, "options", warnings);
+	return {
+		ok: warnings.length === 0,
+		warnings
+	};
+}
 //#endregion
 //#region \0plugin-vue:export-helper
 var _plugin_vue_export_helper_default = (sfc, props) => {
@@ -4202,23 +4804,27 @@ var _plugin_vue_export_helper_default = (sfc, props) => {
 //#region src/chart.vue
 var _hoisted_1 = ["aria-label"];
 var _hoisted_2 = {
+	key: 1,
+	class: "ev-chart__overlay"
+};
+var _hoisted_3 = {
 	key: 0,
 	class: "ev-chart__empty"
 };
-var _hoisted_3 = { class: "ev-chart__empty-icon-wrap" };
-var _hoisted_4 = { class: "ev-chart__empty-text" };
-var _hoisted_5 = {
+var _hoisted_4 = { class: "ev-chart__empty-icon-wrap" };
+var _hoisted_5 = { class: "ev-chart__empty-text" };
+var _hoisted_6 = {
 	key: 0,
 	class: "ev-chart__loading"
 };
-var _hoisted_6 = { class: "ev-chart__loading-bars" };
-var _hoisted_7 = {
+var _hoisted_7 = { class: "ev-chart__loading-bars" };
+var _hoisted_8 = {
 	key: 0,
 	class: "ev-chart__error"
 };
-var _hoisted_8 = { class: "ev-chart__error-text" };
-var _hoisted_9 = ["innerHTML"];
-var _hoisted_10 = {
+var _hoisted_9 = { class: "ev-chart__error-text" };
+var _hoisted_10 = ["innerHTML"];
+var _hoisted_11 = {
 	class: "ev-chart__sr-only",
 	role: "status",
 	"aria-live": "polite"
@@ -4256,7 +4862,8 @@ var chart_default = /*#__PURE__*/ _plugin_vue_export_helper_default(/* @__PURE__
 		"animation-end",
 		"data-update",
 		"brush-select",
-		"zoom"
+		"zoom",
+		"scene-change"
 	],
 	setup(__props, { expose: __expose, emit: __emit }) {
 		const DataLine = () => h("svg", {
@@ -4326,6 +4933,12 @@ var chart_default = /*#__PURE__*/ _plugin_vue_export_helper_default(/* @__PURE__
 		let hoverAnimFrameId = null;
 		const hiddenSeries = ref(/* @__PURE__ */ new Set());
 		const focusSeries = ref(null);
+		const emphasisSeriesName = computed(() => {
+			const em = props.options.emphasis;
+			if (!em || em.series === void 0 || em.dimOthers === false) return null;
+			if (typeof em.series === "number") return props.options.series?.[em.series]?.name ?? null;
+			return em.series || null;
+		});
 		const hoveredToolbox = ref(null);
 		let mouseX = -1;
 		let mouseY = -1;
@@ -4355,33 +4968,102 @@ var chart_default = /*#__PURE__*/ _plugin_vue_export_helper_default(/* @__PURE__
 		const brushRect = ref(null);
 		let suppressClick = false;
 		let brushDragged = false;
+		const specVersion = ref(0);
+		const overlayInfo = ref({
+			plotArea: {
+				x: 0,
+				y: 0,
+				width: 0,
+				height: 0
+			},
+			theme: getTheme(false, void 0),
+			options: null
+		});
 		const effectiveOptions = computed(() => {
+			specVersion.value;
 			const opt = props.options;
-			if (!getDataZoomConfig(opt)) return opt;
+			const scene = opt.scenes?.items?.[sceneIndex.value];
+			const base = scene?.patch ? {
+				...opt,
+				...scene.patch
+			} : opt;
+			if (!getDataZoomConfig(base)) return base;
 			const range = zoomRange.value;
-			if (range.start <= 0 && range.end >= 100) return opt;
-			const sliced = { ...opt };
-			const n = (opt.labels || []).length;
+			if (range.start <= 0 && range.end >= 100) return base;
+			const sliced = { ...base };
+			const n = (base.labels || []).length;
 			if (n > 0) {
 				const { startIdx, endIdx } = zoomToSlice(range, n);
-				sliced.labels = (opt.labels || []).slice(startIdx, endIdx);
-				if (opt.series) sliced.series = opt.series.map((s) => ({
+				sliced.labels = (base.labels || []).slice(startIdx, endIdx);
+				if (base.series) sliced.series = base.series.map((s) => ({
 					...s,
 					data: s.data.slice(startIdx, endIdx)
 				}));
-				if (opt.candleData) sliced.candleData = opt.candleData.slice(startIdx, endIdx);
+				if (base.candleData) sliced.candleData = base.candleData.slice(startIdx, endIdx);
 				sliced.__sliceStart = startIdx;
-			} else if (opt.scatterData && opt.scatterData.length > 0) {
-				const xs = opt.scatterData.map((d) => d.x);
+			} else if (base.scatterData && base.scatterData.length > 0) {
+				const xs = base.scatterData.map((d) => d.x);
 				const xMin = Math.min(...xs);
 				const span = Math.max(...xs) - xMin || 1;
 				const lo = xMin + range.start / 100 * span;
 				const hi = xMin + range.end / 100 * span;
-				const filtered = opt.scatterData.filter((d) => d.x >= lo && d.x <= hi);
-				sliced.scatterData = filtered.length > 0 ? filtered : opt.scatterData;
+				const filtered = base.scatterData.filter((d) => d.x >= lo && d.x <= hi);
+				sliced.scatterData = filtered.length > 0 ? filtered : base.scatterData;
 			}
 			return sliced;
 		});
+		const sceneIndex = ref(0);
+		let sceneTimer = null;
+		let sceneAnimOverride = null;
+		function stopSceneTimer() {
+			if (sceneTimer !== null) {
+				clearTimeout(sceneTimer);
+				sceneTimer = null;
+			}
+		}
+		function applyScene(i, opts = {}) {
+			const items = props.options.scenes?.items || [];
+			if (items.length === 0) return;
+			const next = Math.max(0, Math.min(i, items.length - 1));
+			if (next === sceneIndex.value && !opts.force) return;
+			sceneIndex.value = next;
+			const item = items[next];
+			sceneAnimOverride = item?.duration ? {
+				...props.options.animation || {},
+				duration: item.duration
+			} : null;
+			emit("scene-change", {
+				index: next,
+				total: items.length
+			});
+			render(true, sceneAnimOverride);
+			scheduleSceneAdvance();
+		}
+		function scheduleSceneAdvance() {
+			stopSceneTimer();
+			const scenes = props.options.scenes;
+			if (!scenes?.autoplay) return;
+			const item = scenes.items?.[sceneIndex.value];
+			if (!item) return;
+			const wait = Math.max(0, (item.duration ?? 1200) + (item.hold ?? 0));
+			sceneTimer = setTimeout(() => {
+				const total = props.options.scenes?.items?.length ?? 0;
+				if (total === 0) return;
+				if (sceneIndex.value >= total - 1) {
+					if (props.options.scenes?.loop) applyScene(0, { force: true });
+				} else applyScene(sceneIndex.value + 1);
+			}, wait);
+		}
+		function syncScenes() {
+			const total = props.options.scenes?.items?.length ?? 0;
+			if (total === 0) {
+				stopSceneTimer();
+				if (sceneIndex.value !== 0) sceneIndex.value = 0;
+				return;
+			}
+			if (sceneIndex.value >= total) sceneIndex.value = 0;
+			scheduleSceneAdvance();
+		}
 		function sliceStartOffset() {
 			return effectiveOptions.value.__sliceStart || 0;
 		}
@@ -4427,17 +5109,24 @@ var chart_default = /*#__PURE__*/ _plugin_vue_export_helper_default(/* @__PURE__
 			const spaceBelow = containerRect.height - relY - gap;
 			const spaceAbove = relY - gap - legendBottom;
 			let top;
-			if (spaceBelow >= th) top = relY + gap;
-			else if (spaceAbove >= th) top = relY - gap - th;
-			else top = spaceBelow >= spaceAbove ? containerRect.height - th - margin : legendBottom;
+			if (th + 4 <= containerRect.height) {
+				if (spaceBelow >= th) top = relY + gap;
+				else if (spaceAbove >= th) top = relY - gap - th;
+				else top = spaceBelow >= spaceAbove ? containerRect.height - th - margin : legendBottom;
+				top = Math.max(legendBottom, Math.min(top, containerRect.height - th - margin));
+			} else {
+				const pointViewportY = containerRect.top + relY;
+				const belowInViewport = pointViewportY + gap + th <= window.innerHeight - 8;
+				const aboveInViewport = pointViewportY - gap - th >= 8;
+				top = belowInViewport || !aboveInViewport ? relY + gap : relY - gap - th;
+			}
 			left = Math.max(margin, Math.min(left, containerRect.width - tw - margin));
-			top = Math.max(legendBottom, Math.min(top, containerRect.height - th - margin));
 			tooltipPlacement.value = "top";
 			tooltipX.value = left;
 			tooltipY.value = top;
 		}
 		const canvasStyle = computed(() => ({ cursor: hoverIndex >= 0 ? "pointer" : "default" }));
-		function render(animate = true) {
+		function render(animate = true, animOverride = null) {
 			const canvas = canvasRef.value;
 			if (!canvas) return;
 			const container = containerRef.value;
@@ -4480,8 +5169,20 @@ var chart_default = /*#__PURE__*/ _plugin_vue_export_helper_default(/* @__PURE__
 				lastHeight = height;
 				canvas.width = width * dpr.value;
 				canvas.height = height * dpr.value;
-				const animEnabled = animate && props.options.animation?.enabled !== false;
-				animationState = createAnimation(props.options.animation);
+				const overlayPadding = getPadding(effectiveOptions.value, width);
+				overlayInfo.value = {
+					plotArea: {
+						x: overlayPadding.left,
+						y: overlayPadding.top,
+						width: width - overlayPadding.left - overlayPadding.right,
+						height: height - overlayPadding.top - overlayPadding.bottom
+					},
+					theme: getTheme(document.documentElement.classList.contains("dark"), effectiveOptions.value.theme),
+					options: props.options
+				};
+				const animCfg = animOverride || props.options.animation;
+				const animEnabled = animate && animCfg?.enabled !== false;
+				animationState = createAnimation(animCfg);
 				animationState.isAnimating = animEnabled;
 				if (animEnabled) {
 					isEnterAnimating = true;
@@ -5502,10 +6203,12 @@ var chart_default = /*#__PURE__*/ _plugin_vue_export_helper_default(/* @__PURE__
 				redraw();
 			}
 			const legendName = checkLegendHit(e.clientX, e.clientY);
-			const nextFocus = props.options.legend?.hoverEmphasis !== false && legendName ? legendName : null;
-			if (nextFocus !== focusSeries.value) {
-				focusSeries.value = nextFocus;
-				redraw();
+			if (emphasisSeriesName.value) {} else {
+				const nextFocus = props.options.legend?.hoverEmphasis !== false && legendName ? legendName : null;
+				if (nextFocus !== focusSeries.value) {
+					focusSeries.value = nextFocus;
+					redraw();
+				}
 			}
 			if (legendName) {
 				if (hoverIndex !== -1) {
@@ -5634,7 +6337,7 @@ var chart_default = /*#__PURE__*/ _plugin_vue_export_helper_default(/* @__PURE__
 			tooltipVisible.value = false;
 			mouseX = -1;
 			mouseY = -1;
-			if (focusSeries.value !== null) focusSeries.value = null;
+			if (focusSeries.value !== null && !emphasisSeriesName.value) focusSeries.value = null;
 			if (hoveredToolbox.value !== null) hoveredToolbox.value = null;
 			if (dragMode === "brush") {
 				brushRect.value = null;
@@ -5701,11 +6404,35 @@ var chart_default = /*#__PURE__*/ _plugin_vue_export_helper_default(/* @__PURE__
 				}))
 			};
 		}
+		function cloneSpec(value) {
+			if (value === null || typeof value !== "object") return value;
+			if (Array.isArray(value)) return value.map(cloneSpec);
+			const out = {};
+			Object.keys(value).forEach((k) => {
+				out[k] = cloneSpec(value[k]);
+			});
+			return out;
+		}
+		const IS_DEV = typeof import.meta !== "undefined" && false;
+		const devWarned = /* @__PURE__ */ new Set();
+		function runDevValidation() {
+			if (!IS_DEV) return;
+			const { warnings } = validateOptions(props.options);
+			warnings.slice(0, 8).forEach((w) => {
+				const key = `${w.path}:${w.message}`;
+				if (devWarned.has(key)) return;
+				devWarned.add(key);
+				console.warn(`[EvChart] ${w.path} ${w.message}`);
+			});
+		}
 		let prevOptionsSnapshot = null;
 		watch(() => props.options, (next) => {
 			cachedDataExtent = null;
 			cachedPlotArea = null;
 			internalError.value = null;
+			runDevValidation();
+			focusSeries.value = emphasisSeriesName.value;
+			syncScenes();
 			const zoom = getDataZoomConfig(props.options);
 			const zoomKey = zoom ? JSON.stringify({
 				e: zoom.enabled,
@@ -5759,6 +6486,7 @@ var chart_default = /*#__PURE__*/ _plugin_vue_export_helper_default(/* @__PURE__
 		let unregisterConnector = null;
 		onMounted(() => {
 			render(true);
+			syncScenes();
 			setupResizeObserver();
 			setupDarkModeObserver();
 			window.addEventListener("pointerup", onWindowPointerUp);
@@ -5778,6 +6506,7 @@ var chart_default = /*#__PURE__*/ _plugin_vue_export_helper_default(/* @__PURE__
 			stopAnimation();
 			stopHoverAnimation();
 			stopTweenAnimation();
+			stopSceneTimer();
 			if (tooltipRafId !== null) {
 				cancelAnimationFrame(tooltipRafId);
 				tooltipRafId = null;
@@ -5791,6 +6520,7 @@ var chart_default = /*#__PURE__*/ _plugin_vue_export_helper_default(/* @__PURE__
 			update(newOptions) {
 				Object.assign(props.options, newOptions);
 				cachedDataExtent = null;
+				specVersion.value++;
 				debouncedRender(true);
 			},
 			toDataURL(type = "image/png", quality = 1) {
@@ -5801,6 +6531,7 @@ var chart_default = /*#__PURE__*/ _plugin_vue_export_helper_default(/* @__PURE__
 				cleanupDarkModeObserver();
 				stopAnimation();
 				stopHoverAnimation();
+				stopSceneTimer();
 				if (tooltipRafId !== null) {
 					cancelAnimationFrame(tooltipRafId);
 					tooltipRafId = null;
@@ -5890,6 +6621,7 @@ var chart_default = /*#__PURE__*/ _plugin_vue_export_helper_default(/* @__PURE__
 					...props.options.theme,
 					...theme
 				};
+				specVersion.value++;
 				redraw();
 			},
 			exportSVG(options = {}) {
@@ -5932,6 +6664,59 @@ var chart_default = /*#__PURE__*/ _plugin_vue_export_helper_default(/* @__PURE__
 			getOption() {
 				return props.options;
 			},
+			getSpec() {
+				return cloneSpec(props.options);
+			},
+			setSpec(spec) {
+				if (spec === null || typeof spec !== "object") return;
+				const next = cloneSpec(spec);
+				Object.keys(props.options).forEach((k) => delete props.options[k]);
+				Object.assign(props.options, next);
+				hiddenSeries.value = /* @__PURE__ */ new Set();
+				focusSeries.value = null;
+				brushRect.value = null;
+				hoverIndex = -1;
+				mouseX = -1;
+				mouseY = -1;
+				stopSceneTimer();
+				sceneIndex.value = 0;
+				sceneAnimOverride = null;
+				const zoom = getDataZoomConfig(next);
+				zoomRange.value = {
+					start: zoom?.start ?? 0,
+					end: zoom?.end ?? 100
+				};
+				lastZoomKey = zoom ? JSON.stringify({
+					e: zoom.enabled,
+					s: zoom.start,
+					e2: zoom.end,
+					p: zoom.position,
+					h: zoom.height
+				}) : "";
+				cachedDataExtent = null;
+				cachedPlotArea = null;
+				specVersion.value++;
+				debouncedRender(true);
+			},
+			nextScene() {
+				applyScene(sceneIndex.value + 1);
+			},
+			prevScene() {
+				applyScene(sceneIndex.value - 1);
+			},
+			gotoScene(i) {
+				applyScene(i);
+			},
+			getSceneIndex() {
+				return sceneIndex.value;
+			},
+			getEffectiveSpec() {
+				const spec = cloneSpec(effectiveOptions.value);
+				Object.keys(spec).forEach((k) => {
+					if (k.startsWith("__")) delete spec[k];
+				});
+				return spec;
+			},
 			setDataZoomRange(start, end) {
 				if (!isZoomEnabled()) {
 					console.warn("[EvChart] setDataZoomRange: dataZoom is not enabled");
@@ -5969,12 +6754,17 @@ var chart_default = /*#__PURE__*/ _plugin_vue_export_helper_default(/* @__PURE__
 					onDblclick: handleDblClick,
 					onPointerleave: handlePointerLeave
 				}, null, 36)) : createCommentVNode("", true),
+				!isEmpty.value && !props.options.loading && !internalError.value && _ctx.$slots.overlay ? (openBlock(), createElementBlock("div", _hoisted_2, [renderSlot(_ctx.$slots, "overlay", {
+					plotArea: overlayInfo.value.plotArea,
+					theme: overlayInfo.value.theme,
+					options: props.options
+				}, void 0, true)])) : createCommentVNode("", true),
 				createVNode(Transition, { name: "ev-chart-fade" }, {
-					default: withCtx(() => [isEmpty.value && !props.options.loading && !internalError.value ? (openBlock(), createElementBlock("div", _hoisted_2, [createElementVNode("div", _hoisted_3, [(openBlock(), createBlock(resolveDynamicComponent(DataLine), { class: "ev-chart__empty-img" }))]), createElementVNode("span", _hoisted_4, toDisplayString(emptyTextI18n.value), 1)])) : createCommentVNode("", true)]),
+					default: withCtx(() => [isEmpty.value && !props.options.loading && !internalError.value ? (openBlock(), createElementBlock("div", _hoisted_3, [createElementVNode("div", _hoisted_4, [(openBlock(), createBlock(resolveDynamicComponent(DataLine), { class: "ev-chart__empty-img" }))]), createElementVNode("span", _hoisted_5, toDisplayString(emptyTextI18n.value), 1)])) : createCommentVNode("", true)]),
 					_: 1
 				}),
 				createVNode(Transition, { name: "ev-chart-fade" }, {
-					default: withCtx(() => [props.options.loading && !internalError.value ? (openBlock(), createElementBlock("div", _hoisted_5, [createElementVNode("div", _hoisted_6, [(openBlock(), createElementBlock(Fragment, null, renderList(6, (i) => {
+					default: withCtx(() => [props.options.loading && !internalError.value ? (openBlock(), createElementBlock("div", _hoisted_6, [createElementVNode("div", _hoisted_7, [(openBlock(), createElementBlock(Fragment, null, renderList(6, (i) => {
 						return createElementVNode("div", {
 							key: i,
 							class: "ev-chart__loading-bar",
@@ -5984,7 +6774,7 @@ var chart_default = /*#__PURE__*/ _plugin_vue_export_helper_default(/* @__PURE__
 					_: 1
 				}),
 				createVNode(Transition, { name: "ev-chart-fade" }, {
-					default: withCtx(() => [internalError.value ? (openBlock(), createElementBlock("div", _hoisted_7, [_cache[0] || (_cache[0] = createElementVNode("span", { class: "ev-chart__error-icon" }, [createElementVNode("svg", {
+					default: withCtx(() => [internalError.value ? (openBlock(), createElementBlock("div", _hoisted_8, [_cache[0] || (_cache[0] = createElementVNode("span", { class: "ev-chart__error-icon" }, [createElementVNode("svg", {
 						viewBox: "0 0 24 24",
 						width: "1em",
 						height: "1em",
@@ -6012,7 +6802,7 @@ var chart_default = /*#__PURE__*/ _plugin_vue_export_helper_default(/* @__PURE__
 							x2: "12",
 							y2: "16.51"
 						})
-					])], -1)), createElementVNode("span", _hoisted_8, toDisplayString(internalError.value), 1)])) : createCommentVNode("", true)]),
+					])], -1)), createElementVNode("span", _hoisted_9, toDisplayString(internalError.value), 1)])) : createCommentVNode("", true)]),
 					_: 1
 				}),
 				createVNode(Transition, { name: "ev-chart-tooltip" }, {
@@ -6024,14 +6814,14 @@ var chart_default = /*#__PURE__*/ _plugin_vue_export_helper_default(/* @__PURE__
 						style: normalizeStyle(tooltipStyle.value),
 						role: "tooltip",
 						innerHTML: tooltipContent.value
-					}, null, 14, _hoisted_9)) : createCommentVNode("", true)]),
+					}, null, 14, _hoisted_10)) : createCommentVNode("", true)]),
 					_: 1
 				}),
-				createElementVNode("div", _hoisted_10, toDisplayString(ariaLiveText.value), 1)
+				createElementVNode("div", _hoisted_11, toDisplayString(ariaLiveText.value), 1)
 			], 12, _hoisted_1);
 		};
 	}
-}), [["__scopeId", "data-v-a07b68e8"]]);
+}), [["__scopeId", "data-v-ce034a2a"]]);
 //#endregion
 //#region src/useChart.js
 var USE_CHART_KEY = /* @__PURE__ */ Symbol("ev-chart-context");
@@ -6184,6 +6974,742 @@ function clearSeriesPalette(options = {}) {
 	return true;
 }
 //#endregion
+//#region src/ai/table.js
+var NUM_CLEAN = /[,\s_]/g;
+function parseNumeric(raw) {
+	if (typeof raw === "number") return Number.isFinite(raw) ? raw : null;
+	if (typeof raw !== "string") return null;
+	let s = raw.trim();
+	if (!s) return null;
+	let sign = 1;
+	if (/^\(.*\)$/.test(s)) {
+		sign = -1;
+		s = s.slice(1, -1);
+	}
+	s = s.replace(NUM_CLEAN, "").replace(/^[￥$€£]/, "").replace(/[￥$€£]$/, "");
+	let mult = 1;
+	if (/亿$/.test(s)) {
+		mult = 1e8;
+		s = s.slice(0, -1);
+	} else if (/万$/.test(s)) {
+		mult = 1e4;
+		s = s.slice(0, -1);
+	} else if (/[Kk]$/.test(s)) {
+		mult = 1e3;
+		s = s.slice(0, -1);
+	}
+	if (/%$/.test(s)) s = s.slice(0, -1);
+	if (!/^[-+]?\d+(\.\d+)?$/.test(s)) return null;
+	return sign * parseFloat(s) * mult;
+}
+function looksLikeTime(v) {
+	if (typeof v !== "string") return false;
+	const s = v.trim();
+	if (/^\d{4}[-/年.]\d{1,2}月?(?:[-/.]\d{1,2}日?)?$/.test(s)) return true;
+	if (/^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}/.test(s)) return true;
+	if (/^\d{1,2}:\d{2}(:\d{2})?$/.test(s)) return true;
+	return false;
+}
+function splitLine(line, delim) {
+	const out = [];
+	let cur = "";
+	let inQuotes = false;
+	for (let i = 0; i < line.length; i++) {
+		const ch = line[i];
+		if (ch === "\"") {
+			if (inQuotes && line[i + 1] === "\"") {
+				cur += "\"";
+				i++;
+			} else inQuotes = !inQuotes;
+		} else if (ch === delim && !inQuotes) {
+			out.push(cur.trim());
+			cur = "";
+		} else cur += ch;
+	}
+	out.push(cur.trim());
+	return out;
+}
+function pickDelimiter(line) {
+	const candidates = [
+		"	",
+		";",
+		",",
+		"，"
+	];
+	let best = ",";
+	let bestCount = 0;
+	candidates.forEach((d) => {
+		const n = splitLine(line, d).length;
+		if (n > bestCount) {
+			bestCount = n;
+			best = d;
+		}
+	});
+	return best;
+}
+function rowToObj(headers, row) {
+	const obj = {};
+	headers.forEach((h, i) => {
+		obj[h] = row[i] === void 0 ? null : row[i];
+	});
+	return obj;
+}
+function parseDataTable(input) {
+	if (Array.isArray(input)) {
+		if (input.length === 0) return null;
+		const first = input[0];
+		if (first !== null && typeof first === "object" && !Array.isArray(first)) {
+			const headers = [];
+			input.forEach((row) => {
+				Object.keys(row).forEach((k) => {
+					if (!headers.includes(k)) headers.push(k);
+				});
+			});
+			return {
+				headers,
+				rows: input
+			};
+		}
+		if (Array.isArray(first)) {
+			if (input.length < 1) return null;
+			const width = input.reduce((m, r) => Math.max(m, r.length), 0);
+			if (width < 2) return null;
+			const head = input[0].map((v) => v === null || v === void 0 ? "" : String(v).trim());
+			if (head.filter((v) => parseNumeric(v) !== null).length === 0) return {
+				headers: head,
+				rows: input.slice(1).map((r) => rowToObj(head, r))
+			};
+			const headers = Array.from({ length: width }, (_, i) => `列${i + 1}`);
+			return {
+				headers,
+				rows: input.map((r) => rowToObj(headers, r))
+			};
+		}
+		return null;
+	}
+	if (typeof input === "string") {
+		const lines = input.split(/\r?\n/).map((l) => l.trim()).filter(Boolean);
+		if (lines.length < 2) return null;
+		const delim = pickDelimiter(lines[0]);
+		const grid = lines.map((l) => splitLine(l, delim));
+		const head = grid[0];
+		if (head.filter((v) => parseNumeric(v) !== null).length === 0 && head.length >= 2) return {
+			headers: head,
+			rows: grid.slice(1).map((r) => rowToObj(head, r))
+		};
+		const width = grid.reduce((m, r) => Math.max(m, r.length), 0);
+		const headers = Array.from({ length: width }, (_, i) => `列${i + 1}`);
+		return {
+			headers,
+			rows: grid.map((r) => rowToObj(headers, r))
+		};
+	}
+	return null;
+}
+function inferColumns(table) {
+	const { headers, rows } = table;
+	return headers.map((name) => {
+		const values = rows.map((r) => r[name] === void 0 ? null : r[name]);
+		const present = values.filter((v) => v !== null && v !== "").length;
+		const numericHits = values.filter((v) => parseNumeric(v) !== null).length;
+		if (present > 0 && numericHits / present >= .6) return {
+			name,
+			type: "number",
+			values: values.map((v) => parseNumeric(v))
+		};
+		const timeHits = values.filter((v) => looksLikeTime(v)).length;
+		if (present > 0 && timeHits / present >= .6) return {
+			name,
+			type: "time",
+			values
+		};
+		return {
+			name,
+			type: "category",
+			values
+		};
+	});
+}
+function distinctCount(values) {
+	return new Set(values.filter((v) => v !== null && v !== "")).size;
+}
+//#endregion
+//#region src/ai/spec.js
+var INTENT_KEYWORDS = {
+	trend: [
+		"趋势",
+		"走势",
+		"变化",
+		"随时间",
+		"增长",
+		"trend"
+	],
+	share: [
+		"占比",
+		"构成",
+		"份额",
+		"比例",
+		"组成",
+		"share"
+	],
+	rank: [
+		"排行",
+		"排名",
+		"前几",
+		"highest",
+		"rank"
+	],
+	compare: [
+		"对比",
+		"比较",
+		"对照",
+		"相比",
+		"compare"
+	],
+	relation: [
+		"关系",
+		"相关",
+		"散点",
+		"分布",
+		"relation",
+		"scatter"
+	],
+	stack: [
+		"叠加",
+		"堆叠",
+		"累计",
+		"stack"
+	]
+};
+function detectIntent(text) {
+	if (!text || typeof text !== "string") return null;
+	for (const intent of [
+		"trend",
+		"stack",
+		"share",
+		"rank",
+		"relation",
+		"compare"
+	]) if (INTENT_KEYWORDS[intent].some((kw) => text.includes(kw))) return intent;
+	return null;
+}
+function fmtValue(v) {
+	if (typeof v !== "number" || !Number.isFinite(v)) return String(v);
+	if (Math.abs(v) >= 1e8) return `${(v / 1e8).toFixed(1)}亿`;
+	if (Math.abs(v) >= 1e4) return `${(v / 1e4).toFixed(1)}万`;
+	return `${Math.round(v * 100) / 100}`;
+}
+function buildNarrative(spec, labels, seriesList) {
+	const annotations = [];
+	let best = null;
+	seriesList.forEach((s, si) => {
+		s.data.forEach((v, di) => {
+			if (typeof v === "number" && Number.isFinite(v) && (!best || v > best.value)) best = {
+				value: v,
+				label: labels[di],
+				series: s.name,
+				si,
+				di
+			};
+		});
+	});
+	if (best) annotations.push({
+		type: "callout",
+		x: best.label,
+		y: best.value,
+		series: best.series,
+		label: `峰值 ${fmtValue(best.value)}`,
+		anchor: "top-right"
+	});
+	const first = seriesList[0];
+	if (first && first.data.length >= 2) {
+		const prev = first.data[first.data.length - 2];
+		const last = first.data[first.data.length - 1];
+		if (typeof prev === "number" && typeof last === "number" && prev !== 0) {
+			const pct = (last - prev) / Math.abs(prev);
+			if (Math.abs(pct) >= .01) annotations.push({
+				type: "delta",
+				x: labels[labels.length - 1],
+				y: last,
+				series: first.name,
+				direction: pct >= 0 ? "up" : "down",
+				text: `环比 ${pct >= 0 ? "+" : ""}${(pct * 100).toFixed(0)}%`
+			});
+		}
+	}
+	if (annotations.length > 0) spec.annotations = annotations.slice(0, 3);
+}
+function generateChartSpec(data, hint = {}) {
+	const table = parseDataTable(data);
+	if (!table) return {
+		spec: null,
+		report: [{
+			level: "error",
+			message: "无法识别的数据格式：支持 CSV/TSV 文本、对象数组、二维数组"
+		}]
+	};
+	const cols = inferColumns(table);
+	const numbers = cols.filter((c) => c.type === "number");
+	const times = cols.filter((c) => c.type === "time");
+	const cats = cols.filter((c) => c.type === "category" && distinctCount(c.values) > 0);
+	const dimension = times[0] || cats[0] || null;
+	const labels = dimension ? dimension.values.map((v) => String(v)) : table.rows.map((_, i) => String(i + 1));
+	const intent = hint.intent || detectIntent([hint.title, hint.hint].filter(Boolean).join(" ")) || defaultIntent({
+		times: times.length,
+		numbers: numbers.length,
+		cats: cats.length,
+		labels: labels.length
+	});
+	const report = [{
+		level: "info",
+		message: `识别到 ${numbers.length} 个数值列、${times.length} 个时间列、${cats.length} 个类目列；意图「${intent}」`
+	}];
+	const spec = {};
+	if (hint.title) spec.title = hint.title;
+	if (intent === "relation" && numbers.length >= 2) {
+		const cat = cats[0];
+		spec.type = "scatter";
+		spec.scatterData = table.rows.map((_, i) => ({
+			x: numbers[0].values[i],
+			y: numbers[1].values[i],
+			label: cat ? String(cat.values[i]) : String(i + 1)
+		}));
+		report.push({
+			level: "info",
+			message: `散点图：${numbers[0].name} → x，${numbers[1].name} → y`
+		});
+		return {
+			spec,
+			report
+		};
+	}
+	if (numbers.length === 0) return {
+		spec: null,
+		report: [{
+			level: "error",
+			message: "数据中没有可用的数值列（列需 ≥60% 为可解析数字）"
+		}]
+	};
+	const seriesList = numbers.slice(0, 8).map((c) => ({
+		name: c.name,
+		data: c.values
+	}));
+	if (numbers.length > 8) report.push({
+		level: "warn",
+		message: `数值列超过 8 个，仅取前 8 列（${seriesList.map((s) => s.name).join("、")}）`
+	});
+	if (intent === "share") {
+		if (seriesList.length === 1 && labels.length <= 8) {
+			const pieData = labels.map((name, i) => ({
+				name,
+				value: seriesList[0].data[i]
+			})).filter((d) => typeof d.value === "number" && d.value > 0);
+			spec.type = "pie";
+			spec.pieData = pieData;
+			report.push({
+				level: "info",
+				message: `饼图：${seriesList[0].name} 按类目占比（${pieData.length} 项）`
+			});
+			return {
+				spec,
+				report
+			};
+		}
+		if (seriesList.length >= 2 && seriesList.length <= 8) {
+			const sums = seriesList.map((s) => s.data.reduce((acc, v) => typeof v === "number" && Number.isFinite(v) ? acc + v : acc, 0));
+			if (sums.every((v) => v > 0)) {
+				spec.type = "pie";
+				spec.pieData = seriesList.map((s, i) => ({
+					name: s.name,
+					value: sums[i]
+				}));
+				report.push({
+					level: "info",
+					message: `饼图：按度量合计占比（${sums.length} 项）`
+				});
+				return {
+					spec,
+					report
+				};
+			}
+		}
+	}
+	const labelWidth = labels.reduce((m, l) => Math.max(m, l.length), 0);
+	const wantRank = intent === "rank" || intent === "compare" && seriesList.length === 1 && labels.length >= 9;
+	if (seriesList.length === 1 && (wantRank || labels.length >= 13 || labelWidth >= 5 && labels.length >= 7)) {
+		spec.type = "horizontal-bar";
+		spec.labels = labels;
+		spec.series = seriesList;
+		report.push({
+			level: "info",
+			message: "横向条形图：单度量分类对比，类目名走纵列更易读"
+		});
+		finishCartesian(spec, hint, labels, seriesList, report);
+		return {
+			spec,
+			report
+		};
+	}
+	if (intent === "stack" && seriesList.length >= 2) {
+		spec.type = "stacked-bar";
+		report.push({
+			level: "info",
+			message: "堆叠柱状图：多度量叠加看构成"
+		});
+	} else if ((intent === "compare" || intent === "rank") && seriesList.length <= 3 && labels.length <= 12) {
+		spec.type = "bar";
+		report.push({
+			level: "info",
+			message: "柱状图：类目间量值对比"
+		});
+	} else {
+		spec.type = "line";
+		report.push({
+			level: "info",
+			message: "折线图：维度有序（时间/类目），看走势与多系列对比"
+		});
+	}
+	spec.labels = labels;
+	spec.series = seriesList;
+	if (seriesList.length > 1) spec.legend = { show: true };
+	finishCartesian(spec, hint, labels, seriesList, report);
+	return {
+		spec,
+		report
+	};
+}
+function finishCartesian(spec, hint, labels, seriesList, report) {
+	if (hint.narrative) {
+		buildNarrative(spec, labels, seriesList);
+		if (spec.annotations) report.push({
+			level: "info",
+			message: `叙述注解 ${spec.annotations.length} 处（峰值 callout / 末点环比 delta）`
+		});
+	}
+}
+function defaultIntent({ times, numbers, cats, labels }) {
+	if (times > 0 && numbers > 0) return "trend";
+	if (numbers >= 2 && cats === 0) return "relation";
+	if (numbers === 1 && (cats > 0 || labels > 0)) return "compare";
+	return "trend";
+}
+var SPEC_RULES = [
+	"type 必填，取值必须是 schema enum 中的图表类型",
+	"series[].data 长度必须与 labels 一致，缺失值用 null",
+	"叙述注解 annotations 单图不超过 3 处，emphasis 焦点最多 1 个系列",
+	"不使用 schema 之外的字段",
+	`支持的图表类型：${chartOptionsSchema.properties.type.enum.join(" / ")}`
+];
+//#endregion
+//#region src/ai/examples.js
+var SPEC_EXAMPLES = [
+	{
+		requirement: "看上半年各渠道销售额走势",
+		spec: {
+			type: "line",
+			title: "渠道月度销售额",
+			labels: [
+				"1月",
+				"2月",
+				"3月",
+				"4月",
+				"5月",
+				"6月"
+			],
+			series: [{
+				name: "线上商城",
+				data: [
+					320,
+					356,
+					401,
+					388,
+					520,
+					560
+				]
+			}, {
+				name: "线下门店",
+				data: [
+					280,
+					302,
+					346,
+					331,
+					352,
+					428
+				]
+			}],
+			legend: { show: true }
+		}
+	},
+	{
+		requirement: "各渠道销售额占比",
+		spec: {
+			type: "pie",
+			title: "渠道销售额占比",
+			pieData: [
+				{
+					name: "线上商城",
+					value: 2545
+				},
+				{
+					name: "线下门店",
+					value: 2039
+				},
+				{
+					name: "社群团购",
+					value: 844
+				}
+			]
+		}
+	},
+	{
+		requirement: "各门店销量排行",
+		spec: {
+			type: "horizontal-bar",
+			title: "门店销量排行",
+			labels: [
+				"线下体验店",
+				"线上旗舰店",
+				"社群团购点",
+				"仓储会员店",
+				"社区便利店"
+			],
+			series: [{
+				name: "销量",
+				data: [
+					120,
+					98,
+					80,
+					60,
+					52
+				]
+			}]
+		}
+	},
+	{
+		requirement: "广告投放与成交金额的关系",
+		spec: {
+			type: "scatter",
+			title: "投放-成交关系",
+			scatterData: [
+				{
+					x: 100,
+					y: 12,
+					label: "华东"
+				},
+				{
+					x: 200,
+					y: 26,
+					label: "华南"
+				},
+				{
+					x: 300,
+					y: 31,
+					label: "华北"
+				}
+			]
+		}
+	}
+];
+function formatExamples(maxCount = SPEC_EXAMPLES.length) {
+	return SPEC_EXAMPLES.slice(0, maxCount).map((e) => `需求：${e.requirement}\nSpec：${JSON.stringify(e.spec)}`).join("\n\n");
+}
+//#endregion
+//#region src/ai/prompt.js
+var PREVIEW_ROWS = 8;
+function buildChartPrompt({ data, requirement, extraRules = [], examples = true } = {}) {
+	const table = parseDataTable(data);
+	let digest;
+	if (table) digest = `${table.headers.join(" | ")}\n${table.rows.slice(0, PREVIEW_ROWS).map((r) => table.headers.map((h) => r[h] === null || r[h] === void 0 ? "" : String(r[h])).join(" | ")).join("\n")}${table.rows.length > PREVIEW_ROWS ? `\n…共 ${table.rows.length} 行` : ""}`;
+	else if (data !== void 0 && data !== null) digest = typeof data === "string" ? data : JSON.stringify(data);
+	else digest = "（未提供数据，请基于需求虚构合理示例数据）";
+	const rules = [...SPEC_RULES, ...extraRules];
+	const sections = [
+		"你是图表配置生成器。根据下面的数据与需求，产出 EvChart 的 options JSON（下称 Spec），它将被 <ev-chart :options> 直接渲染。",
+		`## Options Schema\n${JSON.stringify(chartOptionsSchema)}`,
+		`## 数据预览\n${digest}`
+	];
+	if (examples) sections.push(`## 示例\n${formatExamples()}`);
+	sections.push(requirement ? `## 需求\n${requirement}` : "## 需求\n根据数据形状自行选择最合适的图表类型，并拟一个不超过 12 字的标题。");
+	sections.push(`## 硬性规则\n${rules.map((r, i) => `${i + 1}. ${r}`).join("\n")}`);
+	return sections.join("\n\n");
+}
+//#endregion
+//#region src/ai/lint.js
+var DEFAULT_SIZE = {
+	width: 800,
+	height: 450
+};
+function checkTextOverflow(svg, width, height) {
+	const issues = [];
+	let count = 0;
+	for (const m of svg.matchAll(/<text x="([-\d.]+)" y="([-\d.]+)"/g)) {
+		const x = parseFloat(m[1]);
+		const y = parseFloat(m[2]);
+		if (x < -1 || x > width + 1 || y < 0 || y > height + 1) count++;
+	}
+	if (count > 0) issues.push({
+		level: "warn",
+		message: `${count} 处文本超出画布边界（可能被裁剪）`,
+		rule: "text-overflow"
+	});
+	return issues;
+}
+function checkTextOverlap(svg) {
+	const issues = [];
+	const texts = [];
+	for (const m of svg.matchAll(/<text x="([-\d.]+)" y="([-\d.]+)" font-size="([\d.]+)"([^>]*)>([^<]*)<\/text>/g)) {
+		const x = parseFloat(m[1]);
+		const y = parseFloat(m[2]);
+		const fs = parseFloat(m[3]);
+		const attrs = m[4];
+		const content = m[5].trim();
+		if (!content) continue;
+		const w = estimateTextWidth(content, fs);
+		let left = x;
+		if (/text-anchor="middle"/.test(attrs)) left = x - w / 2;
+		else if (/text-anchor="end"/.test(attrs)) left = x - w;
+		texts.push({
+			left,
+			right: left + w,
+			y,
+			fs
+		});
+	}
+	let count = 0;
+	for (let i = 0; i < texts.length; i++) for (let j = i + 1; j < texts.length; j++) {
+		const a = texts[i];
+		const b = texts[j];
+		if (Math.abs(a.y - b.y) >= Math.max(a.fs, b.fs) * .8) continue;
+		if (Math.min(a.right, b.right) - Math.max(a.left, b.left) > Math.min(a.right - a.left, b.right - b.left) * .3) count++;
+	}
+	if (count > 0) issues.push({
+		level: "warn",
+		message: `${count} 处文本相互重叠（标签或注解可能互相遮挡）`,
+		rule: "text-overlap"
+	});
+	return issues;
+}
+function luminance(color) {
+	let s = String(color).trim();
+	if (/^#[0-9a-fA-F]{6}$/.test(s)) s = s.slice(1);
+	else if (/^#[0-9a-fA-F]{3}$/.test(s)) s = s.slice(1).split("").map((c) => c + c).join("");
+	else return null;
+	const n = parseInt(s, 16);
+	const chan = [
+		n >> 16 & 255,
+		n >> 8 & 255,
+		n & 255
+	].map((v) => {
+		const c = v / 255;
+		return c <= .03928 ? c / 12.92 : Math.pow((c + .055) / 1.055, 2.4);
+	});
+	return .2126 * chan[0] + .7152 * chan[1] + .0722 * chan[2];
+}
+function contrastRatio(a, b) {
+	const la = luminance(a);
+	const lb = luminance(b);
+	if (la === null || lb === null) return null;
+	return (Math.max(la, lb) + .05) / (Math.min(la, lb) + .05);
+}
+function checkPaletteContrast(spec) {
+	const issues = [];
+	if (!spec.theme || !Array.isArray(spec.theme.colors)) return issues;
+	[false, true].forEach((dark) => {
+		const theme = getTheme(dark, spec.theme);
+		spec.theme.colors.forEach((c) => {
+			const ratio = contrastRatio(c, theme.backgroundColor);
+			if (ratio !== null && ratio < 3) issues.push({
+				level: "warn",
+				message: `自定义色板${dark ? "暗色" : "浅色"}模式对比度不足 3:1：${c}（${ratio.toFixed(1)}）`,
+				rule: "low-contrast"
+			});
+		});
+	});
+	return issues;
+}
+function lintChartSpec(spec, opts = {}) {
+	const issues = [];
+	const fixed = { ...spec };
+	if (!fixed || typeof fixed !== "object") return {
+		issues: [{
+			level: "error",
+			message: "Spec 必须是对象"
+		}],
+		spec: fixed
+	};
+	const { warnings } = validateOptions(fixed);
+	warnings.forEach((w) => issues.push({
+		level: "error",
+		message: `${w.path} ${w.message}`,
+		path: w.path
+	}));
+	if (issues.some((i) => i.level === "error" && i.path === "options.type")) return {
+		issues,
+		spec: fixed
+	};
+	if (Array.isArray(fixed.annotations) && fixed.annotations.length > 3) {
+		fixed.annotations = fixed.annotations.slice(0, 3);
+		issues.push({
+			level: "info",
+			message: "注解超过 3 处，已按焦点预算裁剪",
+			rule: "annotation-budget"
+		});
+	}
+	if ((fixed.type === "pie" || fixed.type === "doughnut") && Array.isArray(fixed.pieData) && fixed.pieData.length > 8) issues.push({
+		level: "warn",
+		message: `饼图 ${fixed.pieData.length} 个扇区过多（>8），建议改用横向条形图`,
+		rule: "pie-slices"
+	});
+	issues.push(...checkPaletteContrast(fixed));
+	if (fixed.type === "bar" && Array.isArray(fixed.series) && fixed.series.length === 1 && Array.isArray(fixed.labels)) {
+		const width = opts.width ?? DEFAULT_SIZE.width;
+		const labels = fixed.labels.map(String);
+		const maxLabelWidth = Math.max(...labels.map((l) => estimateTextWidth(l, 12)), 0);
+		const slots = Math.max(1, (width - 80) / Math.max(1, labels.length));
+		if (labels.length >= 7 && maxLabelWidth > slots * .9) {
+			fixed.type = "horizontal-bar";
+			issues.push({
+				level: "info",
+				message: "类目名过宽拥挤，已自动改为横向条形图",
+				rule: "bar-to-horizontal"
+			});
+		}
+	}
+	if (typeof document !== "undefined" && fixed.type) try {
+		const width = opts.width ?? DEFAULT_SIZE.width;
+		const height = opts.height ?? DEFAULT_SIZE.height;
+		const canvas = document.createElement("canvas");
+		canvas.width = width;
+		canvas.height = height;
+		const real = canvas.getContext("2d");
+		if (real) {
+			const recorder = createSvgRecorder(real);
+			renderChart(canvas, {
+				options: fixed,
+				ctx: recorder.ctx,
+				dpr: 1,
+				progress: 1,
+				hoverIndex: -1,
+				mouseX: -1,
+				mouseY: -1,
+				showCrosshair: false
+			});
+			issues.push(...checkTextOverflow(recorder.toSvg(width, height, "#ffffff"), width, height));
+			issues.push(...checkTextOverlap(recorder.toSvg(width, height, "#ffffff")));
+		}
+	} catch {
+		issues.push({
+			level: "info",
+			message: "无头渲染自检不可用，已跳过几何检查",
+			rule: "headless-skipped"
+		});
+	}
+	return {
+		issues,
+		spec: fixed
+	};
+}
+//#endregion
 //#region src/index.js
 var components = { EvChart: chart_default };
 function install(app, _options = {}) {
@@ -6192,4 +7718,4 @@ function install(app, _options = {}) {
 var EvokeCharts = { install };
 var src_default = { install };
 //#endregion
-export { chart_default as EvChart, EvokeCharts, applySeriesPalette, clearSeriesPalette, components, src_default as default, injectChartContext, install, provideChartContext, useChart };
+export { chart_default as EvChart, EvokeCharts, applySeriesPalette, buildChartPrompt, chartOptionsSchema, clearSeriesPalette, components, src_default as default, generateChartSpec, injectChartContext, install, lintChartSpec, parseDataTable, provideChartContext, useChart, validateOptions };