@lionad/cx-comps-tanstack-charts 0.1.0-alpha.6

package/dist/index.mjs

@@ -0,0 +1,2095 @@
+import { define } from "@lionad/cx-definition";
+import { Fragment, computed, createBlock, createCommentVNode, createElementBlock, createElementVNode, createVNode, defineComponent, mergeProps, normalizeClass, normalizeStyle, onBeforeUnmount, onMounted, openBlock, renderList, unref, useAttrs } from "vue";
+import { Chart } from "@tanstack/charts/vue";
+import { useCxBEM } from "@lionad/cx-vue";
+import { areaX, areaY, arrow, bandX, bandY, barX, barY, binX, binXY, binY, boxRows, boxX, boxY, cell, colorGradientLegend, colorLegend, cumulative, d3Curve, defaultChartTheme, defineChart, delta, deviation, differenceX, differenceY, dodgeX, dodgeY, dot, first, fold, frame, group, groupBy, hexagon, last, lineX, lineY, linearRegressionRowsX, linearRegressionRowsY, linearRegressionX, linearRegressionY, link, median, mosaicX, mosaicY, normalize, quantile, rank, ratio, rect, ridgelineX, ridgelineY, rollingWindow, ruleX, ruleY, select, stack, stackRowsX, stackRowsY, text, tickX, tickY, variance, vector, violinX, violinY, waffleX, waffleY, waterfall } from "@tanstack/charts";
+import { d3AreaXCurve } from "@tanstack/charts/d3/area-x";
+import { curveBasis, curveCatmullRom, curveLinear, curveLinearClosed, curveMonotoneX, curveNatural, curveStep, curveStepAfter, curveStepBefore } from "d3-shape";
+import { scaleLinear } from "@tanstack/charts/scales/linear";
+import { scaleOrdinal } from "@tanstack/charts/scales/ordinal";
+import { scalePoint } from "@tanstack/charts/scales/point";
+import { scaleBand } from "@tanstack/charts/scales/band";
+import { scaleLog, scalePow, scaleSqrt, scaleSymlog, scaleTime, scaleUtc } from "d3-scale";
+import { contour } from "@tanstack/charts/spatial/contour";
+import { delaunayLink } from "@tanstack/charts/spatial/delaunay";
+import { densityContour } from "@tanstack/charts/spatial/density";
+import { hexbin } from "@tanstack/charts/spatial/hexbin";
+import { voronoi } from "@tanstack/charts/spatial/voronoi";
+import { angleGrid, pie, polar, radialArc, radialArea, radialBarAngle, radialBarRadius, radialDot, radialGrid, radialLine, radialRule, radialText } from "@tanstack/charts/polar";
+import { facet } from "@tanstack/charts/facet";
+import { geoShape } from "@tanstack/charts/geo";
+import { sunburst } from "@tanstack/charts/hierarchy/sunburst";
+import { treeLayout } from "@tanstack/charts/hierarchy/tree";
+import { treemap } from "@tanstack/charts/hierarchy/treemap";
+import { forceLayout } from "@tanstack/charts/network/force";
+import { sankeyDiagram } from "@tanstack/charts/network/sankey";
+import { geoAlbersUsa, geoEqualEarth, geoIdentity, geoMercator, geoNaturalEarth1, geoOrthographic } from "d3-geo";
+import { compileTrigger, createTriggerRegistry } from "@lionad/cx-stream";
+//#region src/shared/chart-skeleton.vue
+const _sfc_main$6 = /*@__PURE__*/ defineComponent({
+	__name: "chart-skeleton",
+	props: { height: { default: 320 } },
+	setup(__props) {
+		const props = __props;
+		const ns = useCxBEM("tanstack-charts-chart-skeleton");
+		const normalizedHeight = computed(() => Number.isFinite(props.height) && props.height > 0 ? props.height : 320);
+		const HEIGHTS = [
+			"42%",
+			"68%",
+			"55%",
+			"82%",
+			"61%"
+		];
+		const barHeights = computed(() => HEIGHTS);
+		const shellStyle = computed(() => ({
+			display: "flex",
+			flexDirection: "column",
+			justifyContent: "flex-end",
+			width: "100%",
+			boxSizing: "border-box",
+			height: `${normalizedHeight.value}px`,
+			padding: "1rem 1rem 0",
+			border: "1px solid rgba(148, 163, 184, 0.25)",
+			borderRadius: "0.75rem"
+		}));
+		const plotStyle = {
+			display: "flex",
+			alignItems: "flex-end",
+			justifyContent: "space-evenly",
+			gap: "8%",
+			flex: "1",
+			minHeight: "0"
+		};
+		const barStyle = {
+			flex: "1",
+			maxWidth: "3rem",
+			borderRadius: "0.375rem 0.375rem 0 0",
+			background: "linear-gradient(180deg, rgba(148, 163, 184, 0.32) 0%, rgba(148, 163, 184, 0.18) 100%)"
+		};
+		const baselineStyle = {
+			height: "2px",
+			borderRadius: "1px",
+			background: "rgba(148, 163, 184, 0.35)"
+		};
+		const bars = [];
+		const animations = [];
+		function setBarRef(el, i) {
+			bars[i] = el instanceof Element ? el : el?.$el ?? null;
+		}
+		onMounted(() => {
+			bars.forEach((bar, i) => {
+				if (!bar || typeof bar.animate !== "function") return;
+				animations.push(bar.animate([
+					{ opacity: .55 },
+					{ opacity: 1 },
+					{ opacity: .55 }
+				], {
+					duration: 1400,
+					iterations: Infinity,
+					delay: i * 150,
+					easing: "ease-in-out"
+				}));
+			});
+		});
+		onBeforeUnmount(() => {
+			for (const animation of animations) animation.cancel();
+			animations.length = 0;
+			bars.length = 0;
+		});
+		return (_ctx, _cache) => {
+			return openBlock(), createElementBlock(Fragment, null, [createCommentVNode(" 图表流式骨架：definition 未闭合期间替换 Chart 占位，柱条错落脉冲暗示图表生长。\n       全 inline style + WAAPI 脉冲：保持包零 css 分发契约（样式不经 style.css 装配） "), createElementVNode("div", {
+				class: normalizeClass(unref(ns).b()),
+				style: normalizeStyle(shellStyle.value),
+				"data-testid": "cx-tanstack-charts-chart-skeleton",
+				"aria-hidden": "true"
+			}, [createElementVNode("div", { style: plotStyle }, [(openBlock(true), createElementBlock(Fragment, null, renderList(barHeights.value, (height, i) => {
+				return openBlock(), createElementBlock("div", {
+					key: i,
+					ref_for: true,
+					ref: (el) => setBarRef(el, i),
+					style: normalizeStyle({
+						...barStyle,
+						height
+					})
+				}, null, 4);
+			}), 128))]), createElementVNode("div", { style: baselineStyle })], 6)], 2112);
+		};
+	}
+});
+//#endregion
+//#region src/shared/streaming.ts
+/**
+* 读取 trigger 注入的流式骨架标记（_cx_streaming，下划线前缀键不会透传物料）。
+* 标记列出未闭合的 skeleton 顶层字段；包装层据此在主体未闭合期间渲染骨架。
+*/
+function streamingFields(attrs) {
+	const fields = attrs._cx_streaming;
+	return Array.isArray(fields) ? fields : [];
+}
+//#endregion
+//#region src/shared/use-chart-props.ts
+/** <Chart> 宿主标量 props 白名单（回调 function props v1 不暴露：JSON 不可表达） */
+const HOST_PROP_KEYS = [
+	"ariaDescription",
+	"height",
+	"width",
+	"aspectRatio",
+	"tabIndex",
+	"idPrefix",
+	"className"
+];
+/**
+* 命名数据集白名单（GenUI 数据顶层化契约）：
+* rows 恒为主数据集（流式 trigger arrayKey），nodes/links 承载关系型图双数据集；
+* 物料 data 顶层与 definition 平级的这三个数组字段分馏进 datasets 表，
+* 供 marks 内字符串引用解析。非数组值静默忽略（流式半值防御）。
+*/
+const DATASET_KEYS = [
+	"rows",
+	"nodes",
+	"links"
+];
+/**
+* 分馏 <Chart> 宿主 props：标量白名单 + class/style + ariaLabel 回退。
+*
+* 剥离 cx 内部键（comp 运行时节点、data-* 编辑标记、_ 前缀编辑器键），与 vtu/EP 桥接同形。
+* class/style 保留进 hostProps（cx 编辑器样式类落到 Chart 根宿主 div）。
+* ariaLabel 是 Chart 必填 prop，缺省回退物料中文名；它与 hostProps 分开返回，
+* 由包装层显式绑定，否则模板类型检查把 v-bind 的 Record 当作 required 键缺席。
+* 预设物料与通用 chart 共用本函数——差异只在 spec 来源（definition 键 vs 通道组装）。
+*/
+function useChartHostProps(attrs) {
+	return {
+		hostProps: computed(() => {
+			const result = {};
+			for (const key of HOST_PROP_KEYS) if (attrs[key] !== void 0) result[key] = attrs[key];
+			if (attrs.class !== void 0) result.class = attrs.class;
+			if (attrs.style !== void 0) result.style = attrs.style;
+			return result;
+		}),
+		ariaLabel: computed(() => attrs.ariaLabel || "图表")
+	};
+}
+/**
+* 通用 chart 物料的分馏：definition 键 → spec，外加宿主 props。
+*
+* definition 键从透传集中分馏——Chart 组件的 definition prop 只接受运行时产物，
+* 物料侧的 JSON spec 须经翻译层组装后由包装层显式绑定，不能随 v-bind 原样透传。
+* 返回独立 computed 而非整体 ref：包装层分别绑定，避免解构丢响应性。
+*/
+function useChartProps(attrs) {
+	const { hostProps, ariaLabel } = useChartHostProps(attrs);
+	return {
+		spec: computed(() => attrs.definition ?? { marks: [] }),
+		datasets: computed(() => {
+			const table = {};
+			for (const key of DATASET_KEYS) {
+				const value = attrs[key];
+				if (Array.isArray(value)) table[key] = value;
+			}
+			return table;
+		}),
+		hostProps,
+		ariaLabel
+	};
+}
+//#endregion
+//#region src/shared/translate/curve.ts
+const CURVE_FACTORIES = {
+	linear: curveLinear,
+	linearClosed: curveLinearClosed,
+	monotoneX: curveMonotoneX,
+	step: curveStep,
+	stepAfter: curveStepAfter,
+	stepBefore: curveStepBefore,
+	basis: curveBasis,
+	natural: curveNatural,
+	catmullRom: curveCatmullRom
+};
+/** curve 枚举白名单：预设物料组装 spec 前的运行时校验（JSON 输入不受 TS 约束） */
+const CX_CHART_CURVE_NAMES = Object.keys(CURVE_FACTORIES);
+function resolveCurveFactory(name) {
+	const factory = CURVE_FACTORIES[name];
+	if (!factory) throw new Error(`translateCurve: 未知 curve 枚举 "${String(name)}"`);
+	return factory;
+}
+/** curve 枚举 → ChartCurve（line+area 函数对）；未知枚举显式抛错（JSON 输入不受 TS 约束，运行时防御） */
+function translateCurve(name) {
+	return d3Curve(resolveCurveFactory(name));
+}
+/**
+* curve 枚举 → AreaXCurve：violinY 等水平展开面积 mark 的专用包装
+* （ViolinYCurve = AreaXCurve，d3Curve 产物不提供 areaX 生成器）。
+*/
+function translateAreaXCurve(name) {
+	return d3AreaXCurve(resolveCurveFactory(name));
+}
+/**
+* curve 枚举 → 原生 d3 CurveFactory：polar radial 系（radialLine/radialArea）
+* 的 curve 参数直接消费 d3 工厂而非 ChartCurve 包装（库签名实证 CurveFactory）。
+*/
+function translateRadialCurve(name) {
+	return resolveCurveFactory(name);
+}
+//#endregion
+//#region src/shared/translate/scale.ts
+/**
+* scale 声明式 → ChartScaleInput。
+* 无 domain 时返回工厂形态（库从 marks channel 推断 domain）；
+* 有 domain 时返回实例（保留配置，库不再推断）。
+* 时间系（utc/time）domain 为 ISO 8601 字符串，翻译为 Date 实例（JSON 不可表达 Date）。
+*/
+function translateScale(spec) {
+	switch (spec.kind) {
+		case "linear": return spec.domain ? scaleLinear().domain(spec.domain) : scaleLinear;
+		case "utc":
+		case "time": {
+			const factory = spec.kind === "utc" ? scaleUtc : scaleTime;
+			if (!spec.domain) return factory;
+			const domain = [new Date(spec.domain[0]), new Date(spec.domain[1])];
+			return factory().domain(domain);
+		}
+		case "log": return spec.domain ? scaleLog().domain(spec.domain) : scaleLog;
+		case "sqrt": return spec.domain ? scaleSqrt().domain(spec.domain) : scaleSqrt;
+		case "symlog": return spec.domain ? scaleSymlog().domain(spec.domain) : scaleSymlog;
+		case "pow": {
+			const create = () => {
+				const instance = scalePow();
+				return spec.exponent === void 0 ? instance : instance.exponent(spec.exponent);
+			};
+			if (!spec.domain) return create;
+			return create().domain(spec.domain);
+		}
+		case "point":
+			if (spec.domain) {
+				const instance = scalePoint().domain(spec.domain);
+				return spec.padding === void 0 ? instance : instance.padding(spec.padding);
+			}
+			return () => spec.padding === void 0 ? scalePoint() : scalePoint().padding(spec.padding);
+		case "band":
+			if (spec.domain) {
+				const instance = scaleBand().domain(spec.domain);
+				return spec.padding === void 0 ? instance : instance.padding(spec.padding);
+			}
+			return () => spec.padding === void 0 ? scaleBand() : scaleBand().padding(spec.padding);
+		case "ordinal": return spec.domain ? scaleOrdinal().domain(spec.domain) : scaleOrdinal;
+		default: throw new Error(`translateScale: 未知 scale kind "${String(spec.kind)}"`);
+	}
+}
+//#endregion
+//#region src/shared/translate/axis.ts
+function translateAxisPresentation(axis) {
+	if (axis === false) return false;
+	const presentation = {};
+	if (axis.label !== void 0) presentation.label = axis.label;
+	if (axis.ticks !== void 0) {
+		const ticks = {};
+		if (axis.ticks.count !== void 0) ticks.count = axis.ticks.count;
+		if (axis.ticks.size !== void 0) ticks.size = axis.ticks.size;
+		if (axis.ticks.padding !== void 0) ticks.padding = axis.ticks.padding;
+		if (axis.ticks.values !== void 0) ticks.values = axis.ticks.values;
+		presentation.ticks = ticks;
+	}
+	if (axis.tickLabels !== void 0) presentation.tickLabels = axis.tickLabels;
+	return presentation;
+}
+/**
+* axis 声明式 → ChartAxisOptions；scale 缺省按轴位回退（x→point、y→linear）。
+* undefined（含流式中间态：definition 开容器后 x/y 字段尚未传到）注入缺省 axis——
+* 库对「mark 物化 channel 但 axis 无 scale 配置」抛错，缺席不等于无轴。
+* null 原样保留（polar 等 scale 值为 never 的 definition 显式无轴）。
+*/
+function translateAxis(spec, fallbackKind) {
+	if (spec === null) return null;
+	const axis = { scale: spec?.scale ? translateScale(spec.scale) : fallbackKind === "point" ? () => scalePoint() : scaleLinear };
+	if (spec?.nice !== void 0) axis.nice = spec.nice;
+	if (spec?.reverse !== void 0) axis.reverse = spec.reverse;
+	if (spec?.grid !== void 0) axis.grid = spec.grid;
+	if (spec?.axis !== void 0) axis.axis = translateAxisPresentation(spec.axis);
+	return axis;
+}
+//#endregion
+//#region src/shared/translate/transforms.ts
+/**
+* 数据预处理管道翻译：spec 顶层 transforms 按序执行，产物以 name 注册进数据集表。
+* 纯函数翻译（同一输入恒同输出），流式中间态 rows 部分到达时按当时行集重算——
+* 逐行生长语义在派生数据集上同样成立。
+*
+* 断言桥：transform 函数泛型按 datum 类型参数化，JSON 翻译层 datum 恒为 unknown——
+* 运行时字段名字符串 accessor 由库内部解析（TransformValue 支持字符串），TS 泛型
+* 对 unknown 不协变，统一经 call 桥接（与 translateChartSpec 的 defineChart 断言同性质）。
+*/
+const call = (fn) => (source, options) => fn(source, options);
+/** reduce 声明式 → 库归约器；字符串枚举 count/sum/mean/min/max 原样透传，其余映射函数引用 */
+function translateReduce(reduce) {
+	if (typeof reduce === "object" && reduce !== null) return quantile(reduce.quantile);
+	switch (reduce) {
+		case "count":
+		case "sum":
+		case "mean":
+		case "min":
+		case "max": return reduce;
+		case "median": return median;
+		case "first": return first;
+		case "last": return last;
+		case "variance": return variance;
+		case "deviation": return deviation;
+		case "delta": return delta;
+		case "ratio": return ratio;
+		default: throw new Error(`translateReduce: 未知 reduce "${String(reduce)}"`);
+	}
+}
+function translateOutputs(outputs) {
+	const result = {};
+	for (const [name, spec] of Object.entries(outputs)) result[name] = {
+		value: spec.value,
+		reduce: translateReduce(spec.reduce)
+	};
+	return result;
+}
+/** 单步 transform → 行数组；源数据经 data 名查 datasets 表（缺省 rows，未命中回退空数组） */
+function translateTransform(spec, datasets) {
+	const source = datasets[spec.data ?? "rows"] ?? [];
+	const rest = spec;
+	const pick = (...keys) => {
+		const out = {};
+		for (const k of keys) if (rest[k] !== void 0) out[k] = rest[k];
+		return out;
+	};
+	switch (spec.kind) {
+		case "groupBy": return call(groupBy)(source, {
+			by: spec.by,
+			outputs: translateOutputs(spec.outputs)
+		});
+		case "binX": return call(binX)(source, {
+			value: spec.value,
+			...pick("by", "thresholds", "domain"),
+			...spec.outputs !== void 0 ? { outputs: translateOutputs(spec.outputs) } : {}
+		});
+		case "binY": return call(binY)(source, {
+			value: spec.value,
+			...pick("by", "thresholds", "domain"),
+			...spec.outputs !== void 0 ? { outputs: translateOutputs(spec.outputs) } : {}
+		});
+		case "binXY": return call(binXY)(source, {
+			x: spec.x,
+			y: spec.y,
+			...pick("by", "xThresholds", "yThresholds", "xDomain", "yDomain"),
+			...spec.outputs !== void 0 ? { outputs: translateOutputs(spec.outputs) } : {}
+		});
+		case "rollingWindow": return call(rollingWindow)(source, {
+			size: spec.size,
+			outputs: translateOutputs(spec.outputs),
+			...pick("by", "anchor", "partial", "orderBy", "order")
+		});
+		case "normalize": return call(normalize)(source, {
+			value: spec.value,
+			...pick("by", "as", "basis")
+		});
+		case "cumulative": return call(cumulative)(source, {
+			outputs: translateOutputs(spec.outputs),
+			...pick("by", "orderBy", "order")
+		});
+		case "fold": return call(fold)(source, {
+			fields: spec.fields,
+			...pick("as")
+		});
+		case "rank": return call(rank)(source, {
+			value: spec.value,
+			...pick("by", "order", "ties", "as")
+		});
+		case "select": return call(select)(source, {
+			select: spec.select,
+			...pick("by", "value")
+		});
+		case "stackRowsY": return call(stackRowsY)(source, {
+			x: spec.x,
+			y: spec.y,
+			...pick("z", "order", "offset", "reverse", "anchor")
+		});
+		case "stackRowsX": return call(stackRowsX)(source, {
+			x: spec.x,
+			y: spec.y,
+			...pick("z", "order", "offset", "reverse", "anchor")
+		});
+		case "waterfall": return call(waterfall)(source, {
+			value: spec.value,
+			...pick("by", "total", "orderBy", "order")
+		});
+		case "mosaicY": return call(mosaicY)(source, {
+			x: spec.x,
+			y: spec.y,
+			value: spec.value,
+			...pick("xOrder", "yOrder")
+		});
+		case "mosaicX": return call(mosaicX)(source, {
+			x: spec.x,
+			y: spec.y,
+			value: spec.value,
+			...pick("xOrder", "yOrder")
+		});
+		case "linearRegressionRowsY": return call(linearRegressionRowsY)(source, {
+			x: spec.x,
+			y: spec.y,
+			...pick("z", "ci", "samples")
+		});
+		case "linearRegressionRowsX": return call(linearRegressionRowsX)(source, {
+			x: spec.x,
+			y: spec.y,
+			...pick("z", "ci", "samples")
+		});
+		case "boxRows": return call(boxRows)(source, {
+			category: spec.category,
+			value: spec.value
+		});
+		case "pie": return call(pie)(source, {
+			value: spec.value,
+			...spec.padAngle !== void 0 ? { gapAngle: spec.padAngle } : {},
+			...pick("startAngle", "endAngle")
+		});
+		default: throw new Error(`translateTransform: 未知 transform kind "${String(spec.kind)}"`);
+	}
+}
+/**
+* 执行 transforms 管道：产物以 name 注册进 datasets 副本（不污染调用方表；
+* 源数据集引用未命中时回退空数组——与 resolveMarkData 同一容错语义）。
+*/
+function applyTransforms(transforms, datasets) {
+	const table = { ...datasets };
+	for (const spec of transforms) table[spec.name] = translateTransform(spec, table);
+	return table;
+}
+//#endregion
+//#region src/shared/translate/mark.ts
+/** 字段名 channel 白名单（运行时校验只接受字符串；accessor 函数 JSON 不可表达） */
+const CHANNEL_KEYS = [
+	"x",
+	"y",
+	"x1",
+	"x2",
+	"y1",
+	"y2",
+	"z",
+	"color",
+	"key",
+	"text"
+];
+/** 弹性 channel（字段名字符串或数值常量：radial 的 angle/radius、violin 的 width 等） */
+const CHANNEL_FLEX_KEYS = [
+	"r",
+	"angle",
+	"radius",
+	"width",
+	"height",
+	"length",
+	"rotate"
+];
+/** 通用样式键（原样透传，多余键对 mark 工厂无害——按名读取） */
+const STYLE_KEYS = [
+	"stroke",
+	"strokeWidth",
+	"strokeOpacity",
+	"strokeDasharray",
+	"fill",
+	"fillOpacity",
+	"fontSize",
+	"fontWeight",
+	"dx",
+	"dy",
+	"points",
+	"opacity"
+];
+/** mark 专有标量选项（原样透传；枚举合法性由库运行时与生成期校验门双重兜底） */
+const SCALAR_KEYS = [
+	"span",
+	"overlap",
+	"unit",
+	"round",
+	"gap",
+	"columns",
+	"headLength",
+	"headAngle",
+	"lineCap",
+	"anchor",
+	"ci",
+	"samples",
+	"positiveFill",
+	"negativeFill",
+	"positiveFillOpacity",
+	"negativeFillOpacity",
+	"comparisonStroke",
+	"cornerRadius",
+	"padAngle",
+	"radiusOffset",
+	"baseline",
+	"inset"
+];
+const MARK_FACTORIES = {
+	lineY,
+	lineX,
+	areaY,
+	areaX,
+	barY,
+	barX,
+	ruleY,
+	ruleX,
+	dot,
+	text,
+	tickX,
+	tickY,
+	bandY,
+	bandX,
+	rect,
+	cell,
+	link,
+	arrow,
+	vector,
+	hexagon,
+	boxY,
+	boxX,
+	violinY,
+	violinX,
+	ridgelineY,
+	ridgelineX,
+	waffleY,
+	waffleX,
+	differenceY,
+	differenceX,
+	linearRegressionY,
+	linearRegressionX
+};
+/**
+* spatial 系 mark 工厂（子路径导入，签名与主入口 mark 同构：(source, options)）。
+* contour 是网格数据等值线（无 x/y channel，width/height 为网格行列数）；
+* densityContour 是散点 KDE 等值线（x/y channel + bandwidth/cellSize/thresholds）。
+*/
+const SPATIAL_FACTORIES = {
+	voronoi,
+	hexbin,
+	contour,
+	delaunayLink,
+	density: densityContour
+};
+/** frame 无数据形态（纯装饰 mark）：签名无 source 参数，特判不走数据解析 */
+function translateFrame(spec) {
+	const options = {};
+	for (const key of [
+		"fill",
+		"stroke",
+		"fillOpacity",
+		"strokeOpacity",
+		"strokeWidth",
+		"inset",
+		"radius"
+	]) if (spec[key] !== void 0) options[key] = spec[key];
+	return frame(options);
+}
+/** channel 运行时校验：只接受字段名字符串（accessor 函数 JSON 不可表达） */
+function assertChannels(spec) {
+	const constantKeys = spec.type === "ruleX" ? /* @__PURE__ */ new Set(["x"]) : spec.type === "ruleY" ? /* @__PURE__ */ new Set(["y"]) : void 0;
+	for (const key of CHANNEL_KEYS) {
+		const value = spec[key];
+		if (value !== void 0 && typeof value !== "string") {
+			if (constantKeys?.has(key) && typeof value === "number") continue;
+			throw new Error(`translateMark: channel "${key}" 只支持字段名字符串，收到 ${typeof value}（mark type=${spec.type}）`);
+		}
+	}
+	for (const key of CHANNEL_FLEX_KEYS) {
+		const value = spec[key];
+		if (value !== void 0 && typeof value !== "string" && typeof value !== "number") throw new Error(`translateMark: channel "${key}" 只支持字段名或数值，收到 ${typeof value}`);
+	}
+}
+/**
+* mark data 解析：字符串 → datasets 查表；数组原样透传。
+* 未命中一律回退空数组——流式中间态（definition 先闭合、数据集在途；多数据集
+* 部分到达）与 LLM 笔误在运行时不可区分，渲染层容错优先（与「渲染链路不过 zod，
+* fallback 从简」契约一致）；笔误显式化归生成期校验（spec 渲染断言门）。
+*/
+function resolveMarkData(data, datasets) {
+	if (data === void 0) return [];
+	if (typeof data !== "string") return data;
+	return datasets?.[data] ?? [];
+}
+/** layout 声明式 → mark layout 工厂（stack/group/dodge 挂 mark.layout 字段） */
+function translateLayout(spec) {
+	switch (spec.kind) {
+		case "stack": {
+			const options = {};
+			if (spec.order !== void 0) options.order = spec.order;
+			if (spec.offset !== void 0) options.offset = spec.offset;
+			if (spec.reverse !== void 0) options.reverse = spec.reverse;
+			if (spec.anchor !== void 0) options.anchor = spec.anchor;
+			return stack(options);
+		}
+		case "group": return group(spec.padding === void 0 ? void 0 : { padding: spec.padding });
+		case "dodgeX": {
+			const options = {};
+			if (spec.anchor !== void 0) options.anchor = spec.anchor;
+			if (spec.padding !== void 0) options.padding = spec.padding;
+			return dodgeX(options);
+		}
+		case "dodgeY": {
+			const options = {};
+			if (spec.anchor !== void 0) options.anchor = spec.anchor;
+			if (spec.padding !== void 0) options.padding = spec.padding;
+			return dodgeY(options);
+		}
+		default: throw new Error(`translateLayout: 未知 layout kind "${String(spec.kind)}"`);
+	}
+}
+/** spatial 专有标量（hexbin 的 binWidth/outputs、contour 的 thresholds/smooth）按存在性透传 */
+function translateSpatialMark(spec, datasets) {
+	const factory = SPATIAL_FACTORIES[spec.type];
+	if (!factory) throw new Error(`translateSpatialMark: 未知 spatial mark type "${String(spec.type)}"`);
+	assertChannels(spec);
+	const options = {};
+	for (const key of CHANNEL_KEYS) if (spec[key] !== void 0) options[key] = spec[key];
+	for (const key of CHANNEL_FLEX_KEYS) if (spec[key] !== void 0) options[key] = spec[key];
+	for (const key of STYLE_KEYS) if (spec[key] !== void 0) options[key] = spec[key];
+	if (spec.id !== void 0) options.id = spec.id;
+	if (spec.value !== void 0) options.value = spec.value;
+	if (spec.binWidth !== void 0) options.binWidth = spec.binWidth;
+	if (spec.thresholds !== void 0) options.thresholds = spec.thresholds;
+	if (spec.smooth !== void 0) options.smooth = spec.smooth;
+	if (spec.bandwidth !== void 0) options.bandwidth = spec.bandwidth;
+	if (spec.cellSize !== void 0) options.cellSize = spec.cellSize;
+	if (spec.outputs !== void 0) options.outputs = translateOutputs(spec.outputs);
+	return factory(resolveMarkData(spec.data, datasets), options);
+}
+/**
+* 单 mark 声明式 → ChartMark；多余样式键对 mark 工厂无害（按名读取）。
+* polar/pie/sankey 等容器与复合 type 不在此处（polar.ts / composite.ts 分支处理）。
+*/
+function translateMark(spec, datasets) {
+	if (spec.type === "frame") return translateFrame(spec);
+	if (spec.type in SPATIAL_FACTORIES) return translateSpatialMark(spec, datasets);
+	const factory = MARK_FACTORIES[spec.type];
+	if (!factory) throw new Error(`translateMark: 未知 mark type "${String(spec.type)}"`);
+	assertChannels(spec);
+	const options = {};
+	for (const key of CHANNEL_KEYS) if (spec[key] !== void 0) options[key] = spec[key];
+	for (const key of CHANNEL_FLEX_KEYS) if (spec[key] !== void 0) options[key] = spec[key];
+	for (const key of STYLE_KEYS) if (spec[key] !== void 0) options[key] = spec[key];
+	for (const key of SCALAR_KEYS) if (spec[key] !== void 0) options[key] = spec[key];
+	if (spec.id !== void 0) options.id = spec.id;
+	if (spec.curve !== void 0) options.curve = spec.type === "violinY" ? translateAreaXCurve(spec.curve) : translateCurve(spec.curve);
+	if (spec.layout !== void 0) options.layout = translateLayout(spec.layout);
+	return factory(resolveMarkData(spec.data, datasets), options);
+}
+//#endregion
+//#region src/shared/translate/polar.ts
+/**
+* polar 嵌套 mark 翻译：polar 是 marks 数组内的容器（非 definition 顶层字段），
+* 子 mark 为 radial 系；官方 PolarLength 的函数形态（({radius}) => radius * r）在
+* JSON 中以 *Ratio 数值表达，翻译层转函数。
+*/
+const RADIAL_FACTORIES = {
+	radialArc,
+	radialBarRadius,
+	radialBarAngle,
+	radialLine,
+	radialArea,
+	radialDot,
+	radialText,
+	radialRule
+};
+/** 比例数值 → PolarLength 函数；undefined 缺省不传（库缺省回退） */
+function ratioToLength(ratio) {
+	if (ratio === void 0) return void 0;
+	return ({ radius }) => radius * ratio;
+}
+/** radial 子 mark 声明式 → PolarMark（channel：angle/radius 弹性，样式透传） */
+function translateRadialMark(spec, datasets) {
+	const factory = RADIAL_FACTORIES[spec.type];
+	if (!factory) throw new Error(`translatePolar: 未知 radial mark type "${String(spec.type)}"`);
+	const options = {};
+	for (const key of [
+		"angle",
+		"angle1",
+		"angle2",
+		"radius",
+		"radius1",
+		"radius2",
+		"key",
+		"z",
+		"color",
+		"text",
+		"startAngle",
+		"endAngle",
+		"padAngle"
+	]) if (spec[key] !== void 0) options[key] = spec[key];
+	for (const key of [
+		"stroke",
+		"strokeWidth",
+		"strokeOpacity",
+		"strokeDasharray",
+		"fill",
+		"fillOpacity",
+		"fontSize",
+		"fontWeight",
+		"opacity",
+		"cornerRadius",
+		"points",
+		"r",
+		"dx",
+		"dy",
+		"anchor",
+		"baseline",
+		"rotate",
+		"radiusOffset"
+	]) if (spec[key] !== void 0) options[key] = spec[key];
+	if (spec.id !== void 0) options.id = spec.id;
+	if (spec.curve !== void 0) options.curve = translateRadialCurve(spec.curve);
+	if (spec.innerRadiusRatio !== void 0) options.innerRadius = ratioToLength(spec.innerRadiusRatio);
+	if (spec.outerRadiusRatio !== void 0) options.outerRadius = ratioToLength(spec.outerRadiusRatio);
+	return factory(resolveMarkData(spec.data, datasets), options);
+}
+/** polar guides 声明式 → PolarGuide */
+function translatePolarGuide(spec) {
+	const factory = spec.kind === "radialGrid" ? radialGrid : angleGrid;
+	const options = {};
+	for (const key of [
+		"values",
+		"ticks",
+		"shape",
+		"labels",
+		"labelAngle",
+		"labelOffset"
+	]) if (spec[key] !== void 0) options[key] = spec[key];
+	return factory(options);
+}
+/** polar axis 声明式（复用 scale 枚举；wrap 仅 angle 轴）→ PolarAngleOptions/PolarRadiusOptions */
+function translatePolarAxis(spec) {
+	if (!spec) return void 0;
+	const axis = {};
+	if (spec.scale) axis.scale = translateScale(spec.scale);
+	if (spec.nice !== void 0) axis.nice = spec.nice;
+	return axis;
+}
+/**
+* polar 容器：{ type:'polar', marks:[radialXxx...], angleAxis, radiusAxis, radiusRatio,
+* startAngle, endAngle, inset, polarGuides } → polar({...})。
+* extraMarks：调用方预组装的 PolarMark（sunburst 等自包含层级 mark 不走 radial 直译）。
+*/
+function translatePolar(spec, datasets, extraMarks = []) {
+	const options = { marks: [...(spec.marks ?? []).map((m) => translateRadialMark(m, datasets)), ...extraMarks] };
+	if (spec.radiusRatio !== void 0) options.radiusRatio = spec.radiusRatio;
+	if (spec.startAngle !== void 0) options.startAngle = spec.startAngle;
+	if (spec.endAngle !== void 0) options.endAngle = spec.endAngle;
+	if (spec.inset !== void 0) options.inset = spec.inset;
+	if (spec.id !== void 0) options.id = spec.id;
+	const angle = translatePolarAxis(spec.angleAxis);
+	const radius = translatePolarAxis(spec.radiusAxis);
+	const hasRadialBarRadius = (spec.marks ?? []).some((m) => m.type === "radialBarRadius");
+	const hasRadialBarAngle = (spec.marks ?? []).some((m) => m.type === "radialBarAngle");
+	options.angle = angle ?? { scale: () => hasRadialBarRadius ? scaleBand() : scalePoint() };
+	options.radius = radius ?? { scale: hasRadialBarAngle ? () => scaleBand() : scaleLinear };
+	if (spec.polarGuides?.length) options.guides = spec.polarGuides.map(translatePolarGuide);
+	return polar(options);
+}
+/**
+* pie 命名复合：{ type:'pie', data, value, key, color, innerRadiusRatio, ... } →
+* pie() 角度分配预处理 + polar(radialArc) 一体展开（donut = innerRadiusRatio > 0）。
+* startAngle/endAngle/padAngle 并入 transform options（transform 侧字段名 gapAngle；
+* 容器层同名字段只作用于 angle scale 映射，radialArc 直接读 datum 弧度——
+* 不传 transform 则声明静默失效）。返回 polar 容器 mark，definition 层按 polar 族
+* 约定处理无轴（见 definition.ts）。
+*/
+function translatePie(spec, datasets) {
+	const rows = resolveMarkData(spec.data, datasets);
+	if (!spec.value) throw new Error("translatePie: pie 复合 mark 必须有 value 字段");
+	const transformOptions = { value: spec.value };
+	if (spec.padAngle !== void 0) transformOptions.gapAngle = spec.padAngle;
+	if (spec.startAngle !== void 0) transformOptions.startAngle = spec.startAngle;
+	if (spec.endAngle !== void 0) transformOptions.endAngle = spec.endAngle;
+	return translatePolar({
+		type: "polar",
+		marks: [{
+			type: "radialArc",
+			data: pie(rows, transformOptions),
+			key: spec.key,
+			color: spec.color,
+			cornerRadius: spec.cornerRadius,
+			innerRadiusRatio: spec.innerRadiusRatio,
+			outerRadiusRatio: spec.outerRadiusRatio,
+			stroke: spec.stroke,
+			strokeWidth: spec.strokeWidth,
+			fillOpacity: spec.fillOpacity,
+			opacity: spec.opacity
+		}],
+		radiusRatio: spec.radiusRatio,
+		inset: spec.inset,
+		polarGuides: spec.polarGuides
+	}, datasets);
+}
+/** polar 族 type 判定（definition 组装层据此应用无轴约定） */
+const POLAR_FAMILY_TYPES = /* @__PURE__ */ new Set([
+	"polar",
+	"pie",
+	"sunburst"
+]);
+//#endregion
+//#region src/shared/translate/composite.ts
+const looseLink = link;
+const looseRect = rect;
+const looseDot = dot;
+/**
+* 层级数据源声明：path 模式（delimiter 拆分）或 nodeId/parentId 平铺模式。
+* idKey：库内命名不一致——treeLayout 平铺模式键名是 id，sunburst/treemap 是 nodeId。
+*/
+function hierarchyOptions(spec, idKey) {
+	if (spec.path) {
+		const options = { path: spec.path };
+		if (spec.delimiter !== void 0) options.delimiter = spec.delimiter;
+		return options;
+	}
+	if (spec.nodeId && spec.parentId) return {
+		[idKey]: spec.nodeId,
+		parentId: spec.parentId
+	};
+	throw new Error(`translateComposite: ${spec.type} 层级数据源必须声明 path 或 nodeId+parentId`);
+}
+/** sankey：固化 marks 回调 = link(布局连线) + rect(布局节点)，样式取自声明 */
+function translateSankey(spec, datasets) {
+	const nodes = resolveMarkData(spec.nodes, datasets);
+	const links = resolveMarkData(spec.links, datasets);
+	if (!spec.nodeKey || !spec.source || !spec.target || !spec.value) throw new Error("translateSankey: sankey 必须声明 nodeKey/source/target/value");
+	const options = {
+		nodes,
+		links,
+		nodeKey: spec.nodeKey,
+		source: spec.source,
+		target: spec.target,
+		value: spec.value,
+		marks: (context) => [looseLink(context.links, {
+			x1: "x1",
+			y1: "y1",
+			x2: "x2",
+			y2: "y2",
+			key: "key",
+			strokeWidth: "width",
+			lineCap: "butt",
+			stroke: spec.stroke ?? void 0,
+			strokeOpacity: spec.strokeOpacity ?? .55
+		}), looseRect(context.nodes, {
+			x1: "x0",
+			x2: "x1",
+			y1: "y0",
+			y2: "y1",
+			key: "key",
+			color: spec.color ?? "key",
+			fillOpacity: spec.fillOpacity ?? void 0
+		})]
+	};
+	if (spec.id !== void 0) options.id = spec.id;
+	if (spec.align !== void 0) options.align = spec.align;
+	if (spec.linkKey !== void 0) options.linkKey = spec.linkKey;
+	if (spec.nodeWidth !== void 0) options.nodeWidth = spec.nodeWidth;
+	if (spec.nodePadding !== void 0) options.nodePadding = spec.nodePadding;
+	if (spec.iterations !== void 0) options.iterations = spec.iterations;
+	if (spec.inset !== void 0) options.inset = spec.inset;
+	return sankeyDiagram(options);
+}
+/** sunburst：返回 PolarMark，按 polar 族约定包一层 polar 容器（与 pie 同模式） */
+function translateSunburst(spec, datasets) {
+	const rows = resolveMarkData(spec.data, datasets);
+	if (!spec.value) throw new Error("translateSunburst: sunburst 必须有 value 字段");
+	const options = {
+		...hierarchyOptions(spec, "nodeId"),
+		value: spec.value
+	};
+	if (spec.id !== void 0) options.id = spec.id;
+	if (spec.color !== void 0) options.color = spec.color;
+	if (spec.z !== void 0) options.z = spec.z;
+	if (spec.visibleDepth !== void 0) options.visibleDepth = spec.visibleDepth;
+	if (spec.ringPadding !== void 0) options.ringPadding = spec.ringPadding;
+	for (const key of [
+		"stroke",
+		"strokeWidth",
+		"strokeOpacity",
+		"fillOpacity",
+		"opacity"
+	]) if (spec[key] !== void 0) options[key] = spec[key];
+	const mark = sunburst(rows, options);
+	return translatePolar({
+		type: "polar",
+		marks: [],
+		radiusRatio: spec.radiusRatio,
+		startAngle: spec.startAngle,
+		endAngle: spec.endAngle,
+		inset: spec.inset,
+		polarGuides: spec.polarGuides
+	}, datasets, [mark]);
+}
+/** treemap：自包含 mark，直接返回 ChartMark */
+function translateTreemap(spec, datasets) {
+	const rows = resolveMarkData(spec.data, datasets);
+	if (!spec.value) throw new Error("translateTreemap: treemap 必须有 value 字段");
+	const options = {
+		...hierarchyOptions(spec, "nodeId"),
+		value: spec.value
+	};
+	if (spec.id !== void 0) options.id = spec.id;
+	if (spec.color !== void 0) options.color = spec.color;
+	if (spec.method !== void 0) options.method = spec.method;
+	if (spec.ratio !== void 0) options.ratio = spec.ratio;
+	if (spec.round !== void 0) options.round = spec.round;
+	if (spec.paddingInner !== void 0) options.paddingInner = spec.paddingInner;
+	if (spec.paddingOuter !== void 0) options.paddingOuter = spec.paddingOuter;
+	if (typeof spec.label === "string") options.label = spec.label;
+	if (spec.labelPadding !== void 0) options.labelPadding = spec.labelPadding;
+	if (spec.labelFontSize !== void 0) options.labelFontSize = spec.labelFontSize;
+	if (spec.labelFontWeight !== void 0) options.labelFontWeight = spec.labelFontWeight;
+	if (spec.inset !== void 0) options.inset = spec.inset;
+	for (const key of [
+		"fillOpacity",
+		"stroke",
+		"strokeOpacity",
+		"strokeWidth"
+	]) if (spec[key] !== void 0) options[key] = spec[key];
+	return treemap(rows, options);
+}
+/** tree：treeLayout 纯布局 + 固化 link(连接线)+dot(节点) 双 mark 组合 */
+function translateTree(spec, datasets) {
+	const rows = resolveMarkData(spec.data, datasets);
+	const options = { ...hierarchyOptions(spec, "id") };
+	if (spec.orientation !== void 0) options.orientation = spec.orientation;
+	if (spec.nodeSize !== void 0) options.nodeSize = spec.nodeSize;
+	const layout = treeLayout(rows, options);
+	return [looseLink(layout.links, {
+		x1: "x1",
+		y1: "y1",
+		x2: "x2",
+		y2: "y2",
+		key: "id",
+		stroke: spec.stroke ?? void 0,
+		strokeOpacity: spec.strokeOpacity ?? .55,
+		strokeWidth: spec.strokeWidth ?? void 0
+	}), looseDot(layout.nodes, {
+		x: "x",
+		y: "y",
+		key: "id",
+		r: spec.r ?? 4.5,
+		color: spec.color ?? void 0,
+		strokeWidth: 1.5
+	})];
+}
+/** 缺省力集：官方示例常规四力的常量形态（函数 accessor 不可 JSON，由库缺省接管） */
+const DEFAULT_FORCES = [
+	{ type: "link" },
+	{ type: "manyBody" },
+	{
+		type: "center",
+		x: 0,
+		y: 0
+	},
+	{ type: "collide" }
+];
+function translateForce(spec) {
+	const options = { type: spec.type };
+	const rest = spec;
+	for (const key of [
+		"distance",
+		"strength",
+		"x",
+		"y",
+		"radius"
+	]) if (rest[key] !== void 0) options[key] = rest[key];
+	return options;
+}
+/** forceGraph：forceLayout 仿真 + 固化 link(连线)+dot(节点)；轴域从布局结果推导回传 */
+function translateForceGraph(spec, datasets) {
+	const nodes = resolveMarkData(spec.nodes, datasets);
+	const links = resolveMarkData(spec.links, datasets);
+	if (!spec.nodeKey || !spec.source || !spec.target) throw new Error("translateForceGraph: forceGraph 必须声明 nodeKey/source/target");
+	const options = {
+		nodeKey: spec.nodeKey,
+		source: spec.source,
+		target: spec.target,
+		forces: (spec.forces ?? DEFAULT_FORCES).map(translateForce)
+	};
+	if (spec.iterations !== void 0) options.iterations = spec.iterations;
+	if (spec.domainPadding !== void 0) options.domainPadding = spec.domainPadding;
+	const graph = forceLayout(nodes, links, options);
+	return {
+		marks: [looseLink(graph.links, {
+			x1: "x1",
+			y1: "y1",
+			x2: "x2",
+			y2: "y2",
+			stroke: spec.stroke ?? void 0,
+			strokeOpacity: spec.strokeOpacity ?? .6,
+			strokeWidth: spec.strokeWidth ?? void 0
+		}), looseDot(graph.nodes, {
+			x: "x",
+			y: "y",
+			key: spec.nodeKey,
+			color: spec.color ?? void 0,
+			r: spec.r ?? 5,
+			strokeWidth: 1.5
+		})],
+		xDomain: [graph.xDomain[0], graph.xDomain[1]],
+		yDomain: [graph.yDomain[0], graph.yDomain[1]]
+	};
+}
+/** d3-geo 投影名称枚举 → 工厂（descriptor.type 形态：() => projection） */
+const GEO_PROJECTION_FACTORIES = {
+	mercator: geoMercator,
+	orthographic: geoOrthographic,
+	naturalEarth1: geoNaturalEarth1,
+	albersUsa: geoAlbersUsa,
+	equalEarth: geoEqualEarth,
+	identity: geoIdentity
+};
+/** geoShape：projection 名称枚举 → descriptor {type, fit, inset}；fit:'data' 由库拟合数据本体 */
+function translateGeoShape(spec, datasets) {
+	const rows = resolveMarkData(spec.data, datasets);
+	const projectionName = spec.projection ?? "mercator";
+	const factory = GEO_PROJECTION_FACTORIES[projectionName];
+	if (!factory) throw new Error(`translateGeoShape: 未知投影 "${String(projectionName)}"`);
+	const options = { projection: {
+		type: factory,
+		fit: spec.fit ?? "data",
+		...spec.inset !== void 0 ? { inset: spec.inset } : {}
+	} };
+	if (spec.id !== void 0) options.id = spec.id;
+	if (spec.key !== void 0) options.key = spec.key;
+	if (spec.color !== void 0) options.color = spec.color;
+	if (spec.r !== void 0) options.r = spec.r;
+	for (const key of [
+		"fill",
+		"fillOpacity",
+		"stroke",
+		"strokeOpacity",
+		"strokeWidth",
+		"strokeDasharray",
+		"opacity"
+	]) if (spec[key] !== void 0) options[key] = spec[key];
+	return geoShape(rows, options);
+}
+/**
+* facet：chart 回调固化为递归子 spec 翻译——translateChild 由 definition.ts 注入
+* （子 spec 翻译与顶层同路径，仅数据集换为 facet 分组行；规避 composite ↔ definition 循环 import）。
+* label 语义：true 显示分组 key 标签（库的函数形态不可 JSON，布尔即可覆盖声明式场景）。
+*/
+function translateFacet(spec, datasets, translateChild) {
+	const rows = resolveMarkData(spec.data, datasets);
+	if (!spec.by) throw new Error("translateFacet: facet 必须声明 by 分组字段");
+	if (!spec.chart) throw new Error("translateFacet: facet 必须声明 chart 子 spec 模板");
+	const childTemplate = spec.chart;
+	const options = {
+		by: spec.by,
+		chart: (facetRows) => translateChild(childTemplate, facetRows)
+	};
+	if (spec.id !== void 0) options.id = spec.id;
+	if (spec.columns !== void 0) options.columns = spec.columns;
+	if (spec.minWidth !== void 0) options.minWidth = spec.minWidth;
+	if (spec.gap !== void 0) options.gap = spec.gap;
+	if (typeof spec.label === "boolean") options.label = spec.label;
+	if (spec.axes !== void 0) options.axes = spec.axes;
+	return facet(rows, options);
+}
+/** 复合 type 守卫（definition 组装层据此分流；sunburst 虽属 polar 族约定，分发仍走此处） */
+const COMPOSITE_TYPES = /* @__PURE__ */ new Set([
+	"sankey",
+	"sunburst",
+	"treemap",
+	"tree",
+	"forceGraph",
+	"geoShape",
+	"facet"
+]);
+/**
+* 复合 mark 分发。tree/forceGraph 展开为多 mark；forceGraph 额外回传轴域推导结果。
+* translateChild 仅 facet 需要。
+*/
+function translateCompositeMark(spec, datasets, translateChild) {
+	switch (spec.type) {
+		case "sankey": return { marks: [translateSankey(spec, datasets)] };
+		case "sunburst": return { marks: [translateSunburst(spec, datasets)] };
+		case "treemap": return { marks: [translateTreemap(spec, datasets)] };
+		case "tree": return { marks: translateTree(spec, datasets) };
+		case "forceGraph": return translateForceGraph(spec, datasets);
+		case "geoShape": return { marks: [translateGeoShape(spec, datasets)] };
+		case "facet": return { marks: [translateFacet(spec, datasets, translateChild)] };
+		default: throw new Error(`translateCompositeMark: 未知复合 mark type "${String(spec.type)}"`);
+	}
+}
+//#endregion
+//#region src/shared/translate/definition.ts
+/**
+* definition 组装：声明式 spec → DomChartDefinition（可直接喂给 <Chart>）。
+*
+* 组装约定：
+* - transforms 管道先于 marks 执行，产物注册进数据集表副本（marks 字符串引用在此解析）
+* - polar 族（polar/pie/sunburst 全为 polar 容器且无直角 channel）未显式声明 x/y 时
+*   置 null 显式无轴（库对 polar mark 的 scale 类型为 never，缺省 axis 注入会抛错）
+* - tree/forceGraph 展开为多 mark；forceGraph 回传的轴域在 x/y 未显式声明时注入
+*   linear scale 实例（仿真坐标以 0 为中心，缺省推断 domain 不包含负半轴余量）
+*/
+/** color.legend 声明 → 图例实例；true 等价 { kind:'color' } 缺省配置 */
+function translateLegend(legend) {
+	const { kind, label, placement, itemWidth, steps, width } = legend === true ? {} : legend;
+	if (kind === "gradient") {
+		const gradient = {};
+		if (label !== void 0) gradient.label = label;
+		if (placement !== void 0) gradient.placement = placement;
+		if (steps !== void 0) gradient.steps = steps;
+		if (width !== void 0) gradient.width = width;
+		return colorGradientLegend(gradient);
+	}
+	const items = {};
+	if (label !== void 0) items.label = label;
+	if (placement !== void 0) items.placement = placement;
+	if (itemWidth !== void 0) items.itemWidth = itemWidth;
+	if (width !== void 0) items.width = width;
+	return colorLegend(items);
+}
+/** tooltip 声明：true→缺省开启（undefined），false→关闭，对象→标量子集原样透传 */
+function translateTooltip(tooltip) {
+	if (tooltip === true) return void 0;
+	if (tooltip === false) return false;
+	const options = {};
+	for (const key of [
+		"placement",
+		"offset",
+		"sticky",
+		"visibility",
+		"anchor",
+		"sort",
+		"items"
+	]) if (tooltip[key] !== void 0) options[key] = tooltip[key];
+	return options;
+}
+/**
+* 时间轴 channel 纠偏：utc/time scale 要求 channel 值为 Date 实例，而 JSON spec 只能
+* 携带 ISO 字符串——翻译层按轴 scale 声明收集绑定字段，把数据集行映射为 Date 副本
+* （不改写调用方行对象）。null 原样保留（nullable channel 缺口语义）。
+*/
+function coerceTemporalChannels(spec, table) {
+	const temporal = (axis) => axis != null && (axis.scale?.kind === "utc" || axis.scale?.kind === "time");
+	const xTemporal = temporal(spec.x);
+	const yTemporal = temporal(spec.y);
+	if (!xTemporal && !yTemporal) return table;
+	const fieldsByDataset = /* @__PURE__ */ new Map();
+	const bind = (dataRef, field) => {
+		const name = typeof dataRef === "string" ? dataRef : "rows";
+		if (typeof field !== "string") return;
+		let set = fieldsByDataset.get(name);
+		if (!set) fieldsByDataset.set(name, set = /* @__PURE__ */ new Set());
+		set.add(field);
+	};
+	for (const mark of spec.marks) {
+		if (xTemporal) for (const f of [
+			"x",
+			"x1",
+			"x2"
+		]) bind(mark.data, mark[f]);
+		if (yTemporal) for (const f of [
+			"y",
+			"y1",
+			"y2"
+		]) bind(mark.data, mark[f]);
+	}
+	let changed = false;
+	const next = { ...table };
+	for (const [name, fields] of fieldsByDataset) {
+		const rows = table[name];
+		if (!rows?.length) continue;
+		changed = true;
+		next[name] = rows.map((row) => {
+			if (row == null || typeof row !== "object") return row;
+			const source = row;
+			const copy = { ...source };
+			for (const field of fields) {
+				const value = source[field];
+				if (typeof value === "string") copy[field] = new Date(value);
+			}
+			return copy;
+		});
+	}
+	return changed ? next : table;
+}
+/**
+* 单 spec → definition 核心（facet 子 spec 复用）：返回原始 spec 对象而非
+* defineChart 产物——facet chart 回调要求返回 ChartSpec 字面量形态。
+* rowsOverride：facet 分组行注入（子 spec marks 未声明 data 时绑定分组行）。
+*/
+function buildDefinition(spec, datasets, rowsOverride) {
+	const base = { ...datasets };
+	if (rowsOverride !== void 0) base.rows = rowsOverride;
+	const table = coerceTemporalChannels(spec, spec.transforms?.length ? applyTransforms(spec.transforms, base) : base);
+	const marks = [];
+	let derivedXDomain;
+	let derivedYDomain;
+	let polarOnly = spec.marks.length > 0;
+	for (const mark of spec.marks) {
+		const bound = rowsOverride !== void 0 && mark.data === void 0 ? {
+			...mark,
+			data: "rows"
+		} : mark;
+		if (!POLAR_FAMILY_TYPES.has(bound.type)) polarOnly = false;
+		if (bound.type === "polar") marks.push(translatePolar(bound, table));
+		else if (bound.type === "pie") marks.push(translatePie(bound, table));
+		else if (COMPOSITE_TYPES.has(bound.type)) {
+			const result = translateCompositeMark(bound, table, (child, rows) => buildDefinition(child, void 0, rows));
+			marks.push(...result.marks);
+			if (result.xDomain) derivedXDomain = result.xDomain;
+			if (result.yDomain) derivedYDomain = result.yDomain;
+		} else marks.push(translateMark(bound, table));
+	}
+	const definition = {
+		marks,
+		theme: {
+			...defaultChartTheme,
+			...spec.theme
+		}
+	};
+	const xSpec = spec.x === void 0 && polarOnly ? null : spec.x;
+	const ySpec = spec.y === void 0 && polarOnly ? null : spec.y;
+	const x = translateAxis(xSpec ?? void 0, "point");
+	const y = translateAxis(ySpec ?? void 0, "linear");
+	if (xSpec !== null && x) definition.x = x;
+	if (xSpec === null) definition.x = null;
+	if (ySpec !== null && y) definition.y = y;
+	if (ySpec === null) definition.y = null;
+	if (derivedXDomain && spec.x?.scale?.domain === void 0) definition.x = {
+		...definition.x,
+		scale: scaleLinear().domain(derivedXDomain)
+	};
+	if (derivedYDomain && spec.y?.scale?.domain === void 0) definition.y = {
+		...definition.y,
+		scale: scaleLinear().domain(derivedYDomain)
+	};
+	if (spec.margin !== void 0) definition.margin = spec.margin;
+	if (spec.guides !== void 0) definition.guides = spec.guides;
+	else if (polarOnly) definition.guides = false;
+	if (spec.clip !== void 0) definition.clip = spec.clip;
+	if (spec.color !== void 0) {
+		const color = {};
+		if (spec.color.domain !== void 0) color.domain = spec.color.domain;
+		if (spec.color.range !== void 0) color.range = spec.color.range;
+		if (spec.color.legend !== void 0) color.legend = translateLegend(spec.color.legend);
+		definition.color = color;
+	}
+	if (spec.pointer !== void 0) definition.pointer = spec.pointer;
+	if (spec.keyboard !== void 0) definition.keyboard = spec.keyboard;
+	if (spec.focusRing !== void 0) definition.focusRing = spec.focusRing;
+	if (spec.focus !== void 0) definition.focus = spec.focus;
+	if (spec.tooltip !== void 0) {
+		const tooltip = translateTooltip(spec.tooltip);
+		if (tooltip !== void 0) definition.tooltip = tooltip;
+	}
+	return definition;
+}
+/**
+* 声明式 spec → DomChartDefinition（物料渲染入口）。
+* datasets：命名数据集表（数据顶层化契约），marks 内字符串引用在此解析。
+*/
+function translateChartSpec(spec, datasets) {
+	return defineChart(buildDefinition(spec, datasets));
+}
+//#endregion
+//#region src/chart/src/index.vue
+const _sfc_main$5 = /*@__PURE__*/ defineComponent({
+	name: "CxTanstackChartsChart",
+	inheritAttrs: false,
+	__name: "index",
+	setup(__props) {
+		const ns = useCxBEM("tanstack-charts-chart");
+		const attrs = useAttrs();
+		const { spec, datasets, hostProps, ariaLabel } = useChartProps(attrs);
+		const definition = computed(() => translateChartSpec(spec.value, datasets.value));
+		const isStreaming = computed(() => streamingFields(attrs).includes("definition"));
+		const skeletonHeight = computed(() => {
+			const h = Number(attrs.height);
+			return Number.isFinite(h) && h > 0 ? h : 320;
+		});
+		return (_ctx, _cache) => {
+			return openBlock(), createElementBlock(Fragment, null, [createCommentVNode(" 库根元素 inheritAttrs:false 且多根（host + tooltip Teleport），testid/BEM 类须由本层 wrapper 承担 "), createElementVNode("div", {
+				class: normalizeClass(unref(ns).b()),
+				"data-testid": "cx-tanstack-charts-chart"
+			}, [createCommentVNode(" definition 未闭合期间骨架占位：空壳帧的空 marks 只渲染不可见空 svg，无反馈等同未渲染 "), isStreaming.value ? (openBlock(), createBlock(_sfc_main$6, {
+				key: 0,
+				height: skeletonHeight.value
+			}, null, 8, ["height"])) : (openBlock(), createBlock(unref(Chart), mergeProps({ key: 1 }, unref(hostProps), {
+				definition: definition.value,
+				"aria-label": unref(ariaLabel)
+			}), null, 16, ["definition", "aria-label"]))], 2)], 2112);
+		};
+	}
+});
+//#endregion
+//#region src/chart/index.ts
+/** 验收页 initial 样本：月度折线（lineY + point/linear 轴 + 网格），示范数据顶层化契约——
+*  rows 顶层数据集 + marks 字符串引用，流式回放可逐行生长 */
+const initialDefinition = () => ({
+	marks: [{
+		type: "lineY",
+		data: "rows",
+		x: "month",
+		y: "value",
+		stroke: "#2563eb",
+		strokeWidth: 2.5,
+		curve: "monotoneX",
+		points: true
+	}, {
+		type: "ruleY",
+		data: [70],
+		stroke: "#e06e49",
+		strokeWidth: 2,
+		strokeDasharray: "6 6"
+	}],
+	x: { scale: { kind: "point" } },
+	y: {
+		scale: { kind: "linear" },
+		grid: true,
+		nice: true
+	}
+});
+const initialRows = () => [
+	{
+		month: "Jan",
+		value: 40
+	},
+	{
+		month: "Feb",
+		value: 62
+	},
+	{
+		month: "Mar",
+		value: 55
+	},
+	{
+		month: "Apr",
+		value: 78
+	},
+	{
+		month: "May",
+		value: 70
+	},
+	{
+		month: "Jun",
+		value: 92
+	}
+];
+var chart_default = define({
+	name: "图表",
+	description: "TanStack Charts 通用图表（cx-chart）：definition 为纯 JSON 声明式投影（marks/x/y/theme/tooltip 标量子集），数据顶层化——rows/nodes/links 命名数据集与 definition 平级、marks 内字符串引用，经翻译层组装渲染；scale/curve 以枚举声明，channel 为字段名。",
+	key: "cx-chart",
+	icon: "i-tabler-chart-line",
+	component: _sfc_main$5,
+	props: {
+		definition: {
+			name: "图表定义",
+			type: "json",
+			initial: initialDefinition
+		},
+		rows: {
+			name: "数据集",
+			type: "json",
+			initial: initialRows
+		},
+		height: {
+			name: "高度",
+			type: "number",
+			initial: 320
+		},
+		ariaLabel: {
+			name: "无障碍标签",
+			type: "short",
+			initial: "月度趋势图"
+		}
+	}
+});
+//#endregion
+//#region src/shared/use-preset-chart.ts
+/**
+* 预设物料的 spec 组装：把扁平通道 props（data 行数组 + x/y 字段名 + curve 枚举）
+* 投影为单 mark 的 CxChartSpec，与通用 chart 物料共用翻译层与宿主 props 分馏。
+*
+* 通道缺席回退固定字段名（x→'x'、y→'y'）而非省略：translateMark 对非字符串 channel
+* 显式抛错，流式中间态/编辑器清空场景下回退保证规格恒可翻译；data 缺席回退空数组
+* （mark 渲染为空而非抛错）。meta.props 的 initial 三元组（data 行键/x 值/y 值）
+* 必须自洽——initial 不参与运行时校验，漂移无任何报错（vtu 既有教训）。
+*/
+function usePresetChart(attrs, options) {
+	const { hostProps, ariaLabel } = useChartHostProps(attrs);
+	return {
+		spec: computed(() => {
+			const mark = {
+				type: options.markType,
+				data: Array.isArray(attrs.data) ? attrs.data : [],
+				x: typeof attrs.x === "string" && attrs.x ? attrs.x : "x",
+				y: typeof attrs.y === "string" && attrs.y ? attrs.y : "y"
+			};
+			if (options.withCurve && typeof attrs.curve === "string" && CX_CHART_CURVE_NAMES.includes(attrs.curve)) mark.curve = attrs.curve;
+			return {
+				marks: [mark],
+				x: { scale: { kind: options.xScale } },
+				y: {
+					scale: { kind: "linear" },
+					grid: true
+				}
+			};
+		}),
+		hostProps,
+		ariaLabel
+	};
+}
+//#endregion
+//#region src/line/src/index.vue
+const _sfc_main$4 = /*@__PURE__*/ defineComponent({
+	name: "CxTanstackChartsLine",
+	inheritAttrs: false,
+	__name: "index",
+	setup(__props) {
+		const ns = useCxBEM("tanstack-charts-line");
+		const { spec, hostProps, ariaLabel } = usePresetChart(useAttrs(), {
+			markType: "lineY",
+			xScale: "point",
+			withCurve: true
+		});
+		const definition = computed(() => translateChartSpec(spec.value));
+		return (_ctx, _cache) => {
+			return openBlock(), createElementBlock(Fragment, null, [createCommentVNode(" 库根元素 inheritAttrs:false 且多根，testid/BEM 类由本层 wrapper 承担 "), createElementVNode("div", {
+				class: normalizeClass(unref(ns).b()),
+				"data-testid": "cx-tanstack-charts-line"
+			}, [createVNode(unref(Chart), mergeProps(unref(hostProps), {
+				definition: definition.value,
+				"aria-label": unref(ariaLabel)
+			}), null, 16, ["definition", "aria-label"])], 2)], 2112);
+		};
+	}
+});
+//#endregion
+//#region src/shared/curve-options.ts
+/**
+* curve select 的 options 在 line/area 两个预设间共享：
+* 抽常量防双侧漂移——选项值集须与翻译层 CURVE_FACTORIES 枚举保持一致，
+* 一致性由 presets 测试的「curve select 值集与翻译层曲线枚举一致」锁定。
+*/
+const CURVE_SELECT_OPTIONS = [
+	{
+		label: "单调平滑",
+		value: "monotoneX"
+	},
+	{
+		label: "直线",
+		value: "linear"
+	},
+	{
+		label: "阶梯",
+		value: "step"
+	},
+	{
+		label: "先横后纵",
+		value: "stepAfter"
+	},
+	{
+		label: "先纵后横",
+		value: "stepBefore"
+	},
+	{
+		label: "B 样条",
+		value: "basis"
+	},
+	{
+		label: "自然样条",
+		value: "natural"
+	}
+];
+//#endregion
+//#region src/line/index.ts
+/** 验收页 initial 样本：月度访问趋势；x/y 字段名与 data 行键严格自洽 */
+const initialData$4 = () => [
+	{
+		month: "1月",
+		visits: 3200
+	},
+	{
+		month: "2月",
+		visits: 4100
+	},
+	{
+		month: "3月",
+		visits: 3800
+	},
+	{
+		month: "4月",
+		visits: 5200
+	},
+	{
+		month: "5月",
+		visits: 4900
+	},
+	{
+		month: "6月",
+		visits: 6300
+	},
+	{
+		month: "7月",
+		visits: 7100
+	},
+	{
+		month: "8月",
+		visits: 6800
+	}
+];
+var line_default = define({
+	name: "折线图",
+	description: "TanStack Charts 折线图预设：data 行数组 + x/y 字段名 + curve 枚举，单 mark（lineY）规格经翻译层组装渲染。",
+	key: "cx-tanstack-charts-line",
+	icon: "i-tabler-chart-line",
+	component: _sfc_main$4,
+	props: {
+		x: {
+			name: "X 字段",
+			type: "short",
+			initial: "month"
+		},
+		y: {
+			name: "Y 字段",
+			type: "short",
+			initial: "visits"
+		},
+		curve: {
+			name: "曲线插值",
+			type: "select",
+			initial: "monotoneX",
+			options: CURVE_SELECT_OPTIONS
+		},
+		data: {
+			name: "数据",
+			type: "json",
+			initial: initialData$4
+		},
+		height: {
+			name: "高度",
+			type: "number",
+			initial: 320
+		},
+		ariaLabel: {
+			name: "无障碍标签",
+			type: "short",
+			initial: "折线图"
+		}
+	}
+});
+//#endregion
+//#region src/bar/src/index.vue
+const _sfc_main$3 = /*@__PURE__*/ defineComponent({
+	name: "CxTanstackChartsBar",
+	inheritAttrs: false,
+	__name: "index",
+	setup(__props) {
+		const ns = useCxBEM("tanstack-charts-bar");
+		const { spec, hostProps, ariaLabel } = usePresetChart(useAttrs(), {
+			markType: "barY",
+			xScale: "band"
+		});
+		const definition = computed(() => translateChartSpec(spec.value));
+		return (_ctx, _cache) => {
+			return openBlock(), createElementBlock(Fragment, null, [createCommentVNode(" 库根元素 inheritAttrs:false 且多根，testid/BEM 类由本层 wrapper 承担 "), createElementVNode("div", {
+				class: normalizeClass(unref(ns).b()),
+				"data-testid": "cx-tanstack-charts-bar"
+			}, [createVNode(unref(Chart), mergeProps(unref(hostProps), {
+				definition: definition.value,
+				"aria-label": unref(ariaLabel)
+			}), null, 16, ["definition", "aria-label"])], 2)], 2112);
+		};
+	}
+});
+//#endregion
+//#region src/bar/index.ts
+/** 验收页 initial 样本：类目销量对比；x/y 字段名与 data 行键严格自洽 */
+const initialData$3 = () => [
+	{
+		product: "手机",
+		sales: 860
+	},
+	{
+		product: "平板",
+		sales: 520
+	},
+	{
+		product: "笔记本",
+		sales: 640
+	},
+	{
+		product: "耳机",
+		sales: 430
+	},
+	{
+		product: "手表",
+		sales: 280
+	}
+];
+var bar_default = define({
+	name: "柱状图",
+	description: "TanStack Charts 柱状图预设：data 行数组 + x/y 字段名，单 mark（barY + band 轴）规格经翻译层组装渲染。",
+	key: "cx-tanstack-charts-bar",
+	icon: "i-tabler-chart-bar",
+	component: _sfc_main$3,
+	props: {
+		x: {
+			name: "X 字段",
+			type: "short",
+			initial: "product"
+		},
+		y: {
+			name: "Y 字段",
+			type: "short",
+			initial: "sales"
+		},
+		data: {
+			name: "数据",
+			type: "json",
+			initial: initialData$3
+		},
+		height: {
+			name: "高度",
+			type: "number",
+			initial: 320
+		},
+		ariaLabel: {
+			name: "无障碍标签",
+			type: "short",
+			initial: "柱状图"
+		}
+	}
+});
+//#endregion
+//#region src/area/src/index.vue
+const _sfc_main$2 = /*@__PURE__*/ defineComponent({
+	name: "CxTanstackChartsArea",
+	inheritAttrs: false,
+	__name: "index",
+	setup(__props) {
+		const ns = useCxBEM("tanstack-charts-area");
+		const { spec, hostProps, ariaLabel } = usePresetChart(useAttrs(), {
+			markType: "areaY",
+			xScale: "point",
+			withCurve: true
+		});
+		const definition = computed(() => translateChartSpec(spec.value));
+		return (_ctx, _cache) => {
+			return openBlock(), createElementBlock(Fragment, null, [createCommentVNode(" 库根元素 inheritAttrs:false 且多根，testid/BEM 类由本层 wrapper 承担 "), createElementVNode("div", {
+				class: normalizeClass(unref(ns).b()),
+				"data-testid": "cx-tanstack-charts-area"
+			}, [createVNode(unref(Chart), mergeProps(unref(hostProps), {
+				definition: definition.value,
+				"aria-label": unref(ariaLabel)
+			}), null, 16, ["definition", "aria-label"])], 2)], 2112);
+		};
+	}
+});
+//#endregion
+//#region src/area/index.ts
+/** 验收页 initial 样本：周活跃趋势；x/y 字段名与 data 行键严格自洽 */
+const initialData$2 = () => [
+	{
+		week: "W1",
+		active: 1200
+	},
+	{
+		week: "W2",
+		active: 1800
+	},
+	{
+		week: "W3",
+		active: 1500
+	},
+	{
+		week: "W4",
+		active: 2400
+	},
+	{
+		week: "W5",
+		active: 2100
+	},
+	{
+		week: "W6",
+		active: 2900
+	},
+	{
+		week: "W7",
+		active: 3300
+	},
+	{
+		week: "W8",
+		active: 3100
+	}
+];
+var area_default = define({
+	name: "面积图",
+	description: "TanStack Charts 面积图预设：data 行数组 + x/y 字段名 + curve 枚举，单 mark（areaY）规格经翻译层组装渲染。",
+	key: "cx-tanstack-charts-area",
+	icon: "i-tabler-chart-area",
+	component: _sfc_main$2,
+	props: {
+		x: {
+			name: "X 字段",
+			type: "short",
+			initial: "week"
+		},
+		y: {
+			name: "Y 字段",
+			type: "short",
+			initial: "active"
+		},
+		curve: {
+			name: "曲线插值",
+			type: "select",
+			initial: "monotoneX",
+			options: CURVE_SELECT_OPTIONS
+		},
+		data: {
+			name: "数据",
+			type: "json",
+			initial: initialData$2
+		},
+		height: {
+			name: "高度",
+			type: "number",
+			initial: 320
+		},
+		ariaLabel: {
+			name: "无障碍标签",
+			type: "short",
+			initial: "面积图"
+		}
+	}
+});
+//#endregion
+//#region src/dot/src/index.vue
+const _sfc_main$1 = /*@__PURE__*/ defineComponent({
+	name: "CxTanstackChartsDot",
+	inheritAttrs: false,
+	__name: "index",
+	setup(__props) {
+		const ns = useCxBEM("tanstack-charts-dot");
+		const { spec, hostProps, ariaLabel } = usePresetChart(useAttrs(), {
+			markType: "dot",
+			xScale: "linear"
+		});
+		const definition = computed(() => translateChartSpec(spec.value));
+		return (_ctx, _cache) => {
+			return openBlock(), createElementBlock(Fragment, null, [createCommentVNode(" 库根元素 inheritAttrs:false 且多根，testid/BEM 类由本层 wrapper 承担 "), createElementVNode("div", {
+				class: normalizeClass(unref(ns).b()),
+				"data-testid": "cx-tanstack-charts-dot"
+			}, [createVNode(unref(Chart), mergeProps(unref(hostProps), {
+				definition: definition.value,
+				"aria-label": unref(ariaLabel)
+			}), null, 16, ["definition", "aria-label"])], 2)], 2112);
+		};
+	}
+});
+//#endregion
+//#region src/dot/index.ts
+/** 验收页 initial 样本：身高体重数值散点；x/y 字段名与 data 行键严格自洽 */
+const initialData$1 = () => [
+	{
+		height: 162,
+		weight: 55
+	},
+	{
+		height: 165,
+		weight: 58
+	},
+	{
+		height: 168,
+		weight: 62
+	},
+	{
+		height: 170,
+		weight: 60
+	},
+	{
+		height: 172,
+		weight: 68
+	},
+	{
+		height: 175,
+		weight: 72
+	},
+	{
+		height: 178,
+		weight: 70
+	},
+	{
+		height: 180,
+		weight: 78
+	},
+	{
+		height: 183,
+		weight: 82
+	},
+	{
+		height: 185,
+		weight: 80
+	}
+];
+var dot_default = define({
+	name: "散点图",
+	description: "TanStack Charts 散点图预设：data 行数组 + x/y 数值字段名，单 mark（dot + 双 linear 轴）规格经翻译层组装渲染。",
+	key: "cx-tanstack-charts-dot",
+	icon: "i-tabler-chart-dots",
+	component: _sfc_main$1,
+	props: {
+		x: {
+			name: "X 字段",
+			type: "short",
+			initial: "height"
+		},
+		y: {
+			name: "Y 字段",
+			type: "short",
+			initial: "weight"
+		},
+		data: {
+			name: "数据",
+			type: "json",
+			initial: initialData$1
+		},
+		height: {
+			name: "高度",
+			type: "number",
+			initial: 320
+		},
+		ariaLabel: {
+			name: "无障碍标签",
+			type: "short",
+			initial: "散点图"
+		}
+	}
+});
+//#endregion
+//#region src/shared/use-pie-chart.ts
+/**
+* 饼图物料的 definition 组装：扁平通道 props（data/name/value/innerRadiusRatio）
+* → pie() 角度分配 → polar(radialArc) 扇区弧。
+*
+* 与笛卡尔预设的翻译层路径不同：pie 涉及运行时函数（pie 变换、innerRadius 比例函数），
+* 属 JSON 不可表达值的物料侧桥接，故在物料内直接组装、不经 CxChartSpec 声明式投影。
+*
+* 鲁棒性（JSON 输入不受 TS 约束）：
+* - 负值/非数值行在 pie 前过滤——pie 对负值显式抛 TypeError，不过滤会炸整棵渲染树；
+* - innerRadiusRatio 钳制 [0, 0.95]——1.0 完全空心渲染不可见，属无效配置而非有效极端；
+* - name/value 字段缺席回退 'name'/'value'（与笛卡尔预设的回退策略同形）。
+*/
+function usePieChart(attrs) {
+	const { hostProps, ariaLabel } = useChartHostProps(attrs);
+	return {
+		definition: computed(() => {
+			const rows = Array.isArray(attrs.data) ? attrs.data : [];
+			const nameField = typeof attrs.name === "string" && attrs.name ? attrs.name : "name";
+			const valueField = typeof attrs.value === "string" && attrs.value ? attrs.value : "value";
+			const clean = rows.filter((row) => row !== null && typeof row === "object" && Number.isFinite(Number(row[valueField])) && Number(row[valueField]) >= 0);
+			const slices = pie(clean, { value: (datum) => Number(datum[valueField]) });
+			const ratio = typeof attrs.innerRadiusRatio === "number" && Number.isFinite(attrs.innerRadiusRatio) ? Math.min(Math.max(attrs.innerRadiusRatio, 0), .95) : 0;
+			return defineChart({ marks: [polar({
+				inset: 8,
+				marks: [radialArc(slices, {
+					color: (datum) => String(datum[nameField]),
+					key: (datum) => String(datum[nameField]),
+					innerRadius: ratio > 0 ? ({ radius }) => radius * ratio : 0,
+					cornerRadius: 2
+				})]
+			})] });
+		}),
+		hostProps,
+		ariaLabel
+	};
+}
+//#endregion
+//#region src/pie/src/index.vue
+const _sfc_main = /*@__PURE__*/ defineComponent({
+	name: "CxTanstackChartsPie",
+	inheritAttrs: false,
+	__name: "index",
+	setup(__props) {
+		const ns = useCxBEM("tanstack-charts-pie");
+		const { definition, hostProps, ariaLabel } = usePieChart(useAttrs());
+		return (_ctx, _cache) => {
+			return openBlock(), createElementBlock(Fragment, null, [createCommentVNode(" 库根元素 inheritAttrs:false 且多根，testid/BEM 类由本层 wrapper 承担 "), createElementVNode("div", {
+				class: normalizeClass(unref(ns).b()),
+				"data-testid": "cx-tanstack-charts-pie"
+			}, [createVNode(unref(Chart), mergeProps(unref(hostProps), {
+				definition: unref(definition),
+				"aria-label": unref(ariaLabel)
+			}), null, 16, ["definition", "aria-label"])], 2)], 2112);
+		};
+	}
+});
+//#endregion
+//#region src/pie/index.ts
+/** 验收页 initial 样本：流量来源占比；name/value 字段名与 data 行键严格自洽 */
+const initialData = () => [
+	{
+		name: "搜索",
+		value: 62
+	},
+	{
+		name: "社交",
+		value: 18
+	},
+	{
+		name: "电商",
+		value: 12
+	},
+	{
+		name: "视频",
+		value: 8
+	}
+];
+var pie_default = define({
+	name: "饼图",
+	description: "TanStack Charts 饼图预设：data 行数组 + name/value 字段名，pie 变换 + polar(radialArc) 物料级组装；innerRadiusRatio > 0 呈环形。",
+	key: "cx-tanstack-charts-pie",
+	icon: "i-tabler-chart-pie",
+	component: _sfc_main,
+	props: {
+		name: {
+			name: "类目字段",
+			type: "short",
+			initial: "name"
+		},
+		value: {
+			name: "数值字段",
+			type: "short",
+			initial: "value"
+		},
+		innerRadiusRatio: {
+			name: "空心比",
+			type: "number",
+			initial: 0
+		},
+		data: {
+			name: "数据",
+			type: "json",
+			initial: initialData
+		},
+		height: {
+			name: "高度",
+			type: "number",
+			initial: 320
+		},
+		ariaLabel: {
+			name: "无障碍标签",
+			type: "short",
+			initial: "占比饼图"
+		}
+	}
+});
+//#endregion
+//#region src/stream-triggers.ts
+/**
+* TanStack Charts 物料流式增量配置：6 件全适用——数组增长型 5 件 + 标量主体 1 件。
+*
+* 形态判定（6 件全 array）：
+* - array 5 件：line/bar/area/dot/pie 预设的 data 是行数组（答复内容主体），
+*   截断点落在行边界逐项揭示（折线逐点生长、饼图逐扇区生长）。
+*   arrayKey 恒为 'data'（单层字段名契约）；props 声明序通道字段（x/y/curve/
+*   name/value/innerRadiusRatio）前置、data 殿后——回放剧本序列化序使增量帧
+*   首行起即携带通道配置，尾随标量（height/ariaLabel）不入增量帧由终帧兜底。
+* - array 1 件：通用 chart 走数据顶层化契约，主数组是顶层 rows（逐行生长）；
+*   definition 序列化在 rows 前，rows 首行闭合时 definition 必然完整——图表
+*   以完整坐标系挂载、数据逐行生长（三段式：骨架→空坐标→行生长）。
+* - 不适用 0 件。计数校验：6 array + 0 scalar + 0 不适用（差集派生兜底）。
+*
+* produced 语义（增量提取器对中间态与终态走同一 buildPartial，实证
+* packages/stream/src/core/incremental.ts Step 5）：
+* - 出帧只由主数组匹配驱动；extraScanPaths（nodes/links）仅提供元素边界
+*   切分点，不驱动出帧——GenUI 契约据此锁死 rows 恒为主数据集在场
+*   （关系型图表 rows=节点行表、links 为边次数据集），无 rows 的 spec 永不
+*   出帧属契约外形态，由生成期校验门拦截。
+* - emptyPassthrough：rows=[] 空数组终态透传节点，由组件空态渲染接管，
+*   防流结束后 pending 永驻。
+*
+* 骨架裁决：不设 skeletonFields——rows 首行闭合即出帧逐行生长，天然有实时
+* 反馈；首行前的 pending 期由渲染管线承担（与预设物料同语义），物料内骨架
+* 判定保留兼容上游 _cx_streaming 注入。
+*
+* fallback 从简：渲染链路不过 zod，包装层无模板直访（useAttrs 平铺 +
+* composable 全回退，缺席不 TypeError）；rows 缺席的中间态经翻译层
+* resolveMarkData 回退空数组，translateChartSpec 组装不抛错（增量帧翻译
+* 实证进包内测试）。
+*
+* key 取自物料 meta 原值（keyOf 查询，定义缺失即显式抛错）。
+*/
+const ALL_MATERIALS = [
+	chart_default,
+	line_default,
+	bar_default,
+	area_default,
+	dot_default,
+	pie_default
+];
+function keyOf(key) {
+	const comp = ALL_MATERIALS.find((c) => c._cx_meta?.key === key);
+	if (!comp) throw new Error(`tanstack-charts 物料定义缺失: ${key}`);
+	return comp._cx_meta.key;
+}
+const TANSTACK_CHARTS_STREAM_TRIGGERS = [{
+	key: keyOf("cx-chart"),
+	sections: [{
+		kind: "array",
+		arrayKey: "rows",
+		extraScanPaths: [[
+			"data",
+			"nodes",
+			"*"
+		], [
+			"data",
+			"links",
+			"*"
+		]]
+	}],
+	stateBranch: { emptyPassthrough: true },
+	frameStride: 10
+}, ...[
+	"cx-tanstack-charts-line",
+	"cx-tanstack-charts-bar",
+	"cx-tanstack-charts-area",
+	"cx-tanstack-charts-dot",
+	"cx-tanstack-charts-pie"
+].map((key) => ({
+	key: keyOf(key),
+	sections: [{
+		kind: "array",
+		arrayKey: "data"
+	}],
+	frameStride: 10
+}))];
+/** 装配 TanStack Charts 物料的 trigger 注册表（size 恒 6） */
+function createTanstackChartsTriggerRegistry() {
+	const registry = createTriggerRegistry();
+	for (const config of TANSTACK_CHARTS_STREAM_TRIGGERS) registry.register(config.key, compileTrigger(config));
+	return registry;
+}
+/** 增量节点的主数组（回放计数展示用）；非数组增长型物料或数组缺席时返回 null */
+function mainArrayOf(node) {
+	const section = TANSTACK_CHARTS_STREAM_TRIGGERS.find((c) => c.key === node.key)?.sections.find((s) => s.kind === "array");
+	if (!section || section.kind !== "array") return null;
+	const arr = node.data?.[section.arrayKey];
+	return Array.isArray(arr) ? arr : null;
+}
+//#endregion
+//#region src/index.ts
+/** TanStack Charts 物料数组：通用 chart + 笛卡尔预设（line/bar/area/dot）+ 饼图 */
+const CxTanstackCharts = [
+	chart_default,
+	line_default,
+	bar_default,
+	area_default,
+	dot_default,
+	pie_default
+];
+/** TanStack Charts 物料 bundle：自描述单元，供装配方（cx-nuxt 等）按 bundle 装配 */
+const CxTanstackChartsBundle = {
+	name: "tanstack-charts",
+	materials: [...CxTanstackCharts]
+};
+//#endregion
+export { COMPOSITE_TYPES, CX_CHART_CURVE_NAMES, CxTanstackCharts, area_default as CxTanstackChartsArea, bar_default as CxTanstackChartsBar, CxTanstackChartsBundle, chart_default as CxTanstackChartsChart, dot_default as CxTanstackChartsDot, line_default as CxTanstackChartsLine, pie_default as CxTanstackChartsPie, POLAR_FAMILY_TYPES, TANSTACK_CHARTS_STREAM_TRIGGERS, applyTransforms, createTanstackChartsTriggerRegistry, mainArrayOf, resolveMarkData, translateAxis, translateChartSpec, translateCompositeMark, translateCurve, translateMark, translateOutputs, translatePie, translatePolar, translateReduce, translateScale, translateTransform };