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

package/dist/area/index.d.ts

@@ -0,0 +1,26 @@
+declare const _default: import("vue").Component & import("@lionad/cx-definition").NormalizeKey<Required<{
+    name: string;
+    getName?: (opts: {
+        cx: import("@lionad/cx-definition").CxLoaderInstance;
+        comp: import("@lionad/cx-definition").CxComponentRuntime;
+        data?: Record<string, unknown>;
+    }) => string;
+    icon: string;
+    description: string;
+    key: string;
+    aliasKeys?: string | string[];
+    component: import("vue").Component;
+    headless?: boolean;
+    async?: boolean;
+    props?: import("@lionad/cx-definition").CxComponentMetaProps;
+    emits?: import("@lionad/cx-definition").CxComponentMetaEmits;
+    exposes?: import("@lionad/cx-definition").CxComponentMetaExposes;
+    slots?: import("@lionad/cx-definition").CxComponentMetaSlots;
+    url?: string;
+    umdExportsName?: string;
+    type?: "umd" | "esm" | "local";
+    rules?: {
+        edit: Record<string, unknown>;
+    };
+}>>;
+export default _default;

package/dist/area/src/index.vue.d.ts

@@ -0,0 +1,3 @@
+declare const __VLS_export: import("vue").DefineComponent<{}, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<{}> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
+declare const _default: typeof __VLS_export;
+export default _default;

package/dist/bar/index.d.ts

@@ -0,0 +1,26 @@
+declare const _default: import("vue").Component & import("@lionad/cx-definition").NormalizeKey<Required<{
+    name: string;
+    getName?: (opts: {
+        cx: import("@lionad/cx-definition").CxLoaderInstance;
+        comp: import("@lionad/cx-definition").CxComponentRuntime;
+        data?: Record<string, unknown>;
+    }) => string;
+    icon: string;
+    description: string;
+    key: string;
+    aliasKeys?: string | string[];
+    component: import("vue").Component;
+    headless?: boolean;
+    async?: boolean;
+    props?: import("@lionad/cx-definition").CxComponentMetaProps;
+    emits?: import("@lionad/cx-definition").CxComponentMetaEmits;
+    exposes?: import("@lionad/cx-definition").CxComponentMetaExposes;
+    slots?: import("@lionad/cx-definition").CxComponentMetaSlots;
+    url?: string;
+    umdExportsName?: string;
+    type?: "umd" | "esm" | "local";
+    rules?: {
+        edit: Record<string, unknown>;
+    };
+}>>;
+export default _default;

package/dist/bar/src/index.vue.d.ts

@@ -0,0 +1,3 @@
+declare const __VLS_export: import("vue").DefineComponent<{}, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<{}> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
+declare const _default: typeof __VLS_export;
+export default _default;

package/dist/chart/index.d.ts

@@ -0,0 +1,26 @@
+declare const _default: import("vue").Component & import("@lionad/cx-definition").NormalizeKey<Required<{
+    name: string;
+    getName?: (opts: {
+        cx: import("@lionad/cx-definition").CxLoaderInstance;
+        comp: import("@lionad/cx-definition").CxComponentRuntime;
+        data?: Record<string, unknown>;
+    }) => string;
+    icon: string;
+    description: string;
+    key: string;
+    aliasKeys?: string | string[];
+    component: import("vue").Component;
+    headless?: boolean;
+    async?: boolean;
+    props?: import("@lionad/cx-definition").CxComponentMetaProps;
+    emits?: import("@lionad/cx-definition").CxComponentMetaEmits;
+    exposes?: import("@lionad/cx-definition").CxComponentMetaExposes;
+    slots?: import("@lionad/cx-definition").CxComponentMetaSlots;
+    url?: string;
+    umdExportsName?: string;
+    type?: "umd" | "esm" | "local";
+    rules?: {
+        edit: Record<string, unknown>;
+    };
+}>>;
+export default _default;

package/dist/chart/src/index.vue.d.ts

@@ -0,0 +1,3 @@
+declare const __VLS_export: import("vue").DefineComponent<{}, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<{}> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
+declare const _default: typeof __VLS_export;
+export default _default;

package/dist/dot/index.d.ts

@@ -0,0 +1,26 @@
+declare const _default: import("vue").Component & import("@lionad/cx-definition").NormalizeKey<Required<{
+    name: string;
+    getName?: (opts: {
+        cx: import("@lionad/cx-definition").CxLoaderInstance;
+        comp: import("@lionad/cx-definition").CxComponentRuntime;
+        data?: Record<string, unknown>;
+    }) => string;
+    icon: string;
+    description: string;
+    key: string;
+    aliasKeys?: string | string[];
+    component: import("vue").Component;
+    headless?: boolean;
+    async?: boolean;
+    props?: import("@lionad/cx-definition").CxComponentMetaProps;
+    emits?: import("@lionad/cx-definition").CxComponentMetaEmits;
+    exposes?: import("@lionad/cx-definition").CxComponentMetaExposes;
+    slots?: import("@lionad/cx-definition").CxComponentMetaSlots;
+    url?: string;
+    umdExportsName?: string;
+    type?: "umd" | "esm" | "local";
+    rules?: {
+        edit: Record<string, unknown>;
+    };
+}>>;
+export default _default;

package/dist/dot/src/index.vue.d.ts

@@ -0,0 +1,3 @@
+declare const __VLS_export: import("vue").DefineComponent<{}, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<{}> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
+declare const _default: typeof __VLS_export;
+export default _default;

package/dist/index.d.ts

@@ -0,0 +1,37 @@
+import type { CxMaterialBundle } from '@lionad/cx-definition';
+export { default as CxTanstackChartsChart } from './chart';
+export { default as CxTanstackChartsLine } from './line';
+export { default as CxTanstackChartsBar } from './bar';
+export { default as CxTanstackChartsArea } from './area';
+export { default as CxTanstackChartsDot } from './dot';
+export { default as CxTanstackChartsPie } from './pie';
+export * from './shared/translate';
+export { TANSTACK_CHARTS_STREAM_TRIGGERS, createTanstackChartsTriggerRegistry, mainArrayOf, } from './stream-triggers';
+/** TanStack Charts 物料数组：通用 chart + 笛卡尔预设（line/bar/area/dot）+ 饼图 */
+export declare const CxTanstackCharts: (import("vue").Component & import("@lionad/cx-definition").NormalizeKey<Required<{
+    name: string;
+    getName?: (opts: {
+        cx: import("@lionad/cx-definition").CxLoaderInstance;
+        comp: import("@lionad/cx-definition").CxComponentRuntime;
+        data?: Record<string, unknown>;
+    }) => string;
+    icon: string;
+    description: string;
+    key: string;
+    aliasKeys?: string | string[];
+    component: import("vue").Component;
+    headless?: boolean;
+    async?: boolean;
+    props?: import("@lionad/cx-definition").CxComponentMetaProps;
+    emits?: import("@lionad/cx-definition").CxComponentMetaEmits;
+    exposes?: import("@lionad/cx-definition").CxComponentMetaExposes;
+    slots?: import("@lionad/cx-definition").CxComponentMetaSlots;
+    url?: string;
+    umdExportsName?: string;
+    type?: "umd" | "esm" | "local";
+    rules?: {
+        edit: Record<string, unknown>;
+    };
+}>>)[];
+/** TanStack Charts 物料 bundle：自描述单元，供装配方（cx-nuxt 等）按 bundle 装配 */
+export declare const CxTanstackChartsBundle: CxMaterialBundle;

package/dist/index.mjs

@@ -24,6 +24,7 @@ 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 { tooltip } from "@tanstack/charts/tooltip";
 import { compileTrigger, createTriggerRegistry } from "@lionad/cx-stream";
 //#region src/shared/chart-skeleton.vue
 const _sfc_main$6 = /*@__PURE__*/ defineComponent({
@@ -1145,10 +1146,15 @@ function translateLegend(legend) {
 	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;
+/**
+* tooltip 声明：false→关闭；true→默认 DOM extension；对象→extension + 标量子集。
+* 库层没有「缺省开启」——resolveTooltipInput 对 undefined 返回 null 即关闭，
+* 开启必须显式挂 extension（裸 extension 或 { use, ...options } 两形态）；
+* 裸 options 对象会在 mount 时抛 TypeError（input.use 为 undefined）。
+*/
+function translateTooltip(tooltip$1) {
+	if (tooltip$1 === false) return false;
+	if (tooltip$1 === true) return tooltip;
 	const options = {};
 	for (const key of [
 		"placement",
@@ -1158,8 +1164,11 @@ function translateTooltip(tooltip) {
 		"anchor",
 		"sort",
 		"items"
-	]) if (tooltip[key] !== void 0) options[key] = tooltip[key];
-	return options;
+	]) if (tooltip$1[key] !== void 0) options[key] = tooltip$1[key];
+	return {
+		use: tooltip,
+		...options
+	};
 }
 /**
 * 时间轴 channel 纠偏：utc/time scale 要求 channel 值为 Date 实例，而 JSON spec 只能
@@ -1276,10 +1285,8 @@ function buildDefinition(spec, datasets, rowsOverride) {
 	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;
-	}
+	const tooltip$2 = spec.tooltip === void 0 ? tooltip : translateTooltip(spec.tooltip);
+	if (tooltip$2 !== void 0) definition.tooltip = tooltip$2;
 	return definition;
 }
 /**

package/dist/line/index.d.ts

@@ -0,0 +1,26 @@
+declare const _default: import("vue").Component & import("@lionad/cx-definition").NormalizeKey<Required<{
+    name: string;
+    getName?: (opts: {
+        cx: import("@lionad/cx-definition").CxLoaderInstance;
+        comp: import("@lionad/cx-definition").CxComponentRuntime;
+        data?: Record<string, unknown>;
+    }) => string;
+    icon: string;
+    description: string;
+    key: string;
+    aliasKeys?: string | string[];
+    component: import("vue").Component;
+    headless?: boolean;
+    async?: boolean;
+    props?: import("@lionad/cx-definition").CxComponentMetaProps;
+    emits?: import("@lionad/cx-definition").CxComponentMetaEmits;
+    exposes?: import("@lionad/cx-definition").CxComponentMetaExposes;
+    slots?: import("@lionad/cx-definition").CxComponentMetaSlots;
+    url?: string;
+    umdExportsName?: string;
+    type?: "umd" | "esm" | "local";
+    rules?: {
+        edit: Record<string, unknown>;
+    };
+}>>;
+export default _default;

package/dist/line/src/index.vue.d.ts

@@ -0,0 +1,3 @@
+declare const __VLS_export: import("vue").DefineComponent<{}, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<{}> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
+declare const _default: typeof __VLS_export;
+export default _default;

package/dist/pie/index.d.ts

@@ -0,0 +1,26 @@
+declare const _default: import("vue").Component & import("@lionad/cx-definition").NormalizeKey<Required<{
+    name: string;
+    getName?: (opts: {
+        cx: import("@lionad/cx-definition").CxLoaderInstance;
+        comp: import("@lionad/cx-definition").CxComponentRuntime;
+        data?: Record<string, unknown>;
+    }) => string;
+    icon: string;
+    description: string;
+    key: string;
+    aliasKeys?: string | string[];
+    component: import("vue").Component;
+    headless?: boolean;
+    async?: boolean;
+    props?: import("@lionad/cx-definition").CxComponentMetaProps;
+    emits?: import("@lionad/cx-definition").CxComponentMetaEmits;
+    exposes?: import("@lionad/cx-definition").CxComponentMetaExposes;
+    slots?: import("@lionad/cx-definition").CxComponentMetaSlots;
+    url?: string;
+    umdExportsName?: string;
+    type?: "umd" | "esm" | "local";
+    rules?: {
+        edit: Record<string, unknown>;
+    };
+}>>;
+export default _default;

package/dist/pie/src/index.vue.d.ts

@@ -0,0 +1,3 @@
+declare const __VLS_export: import("vue").DefineComponent<{}, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<{}> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
+declare const _default: typeof __VLS_export;
+export default _default;

package/dist/shared/chart-skeleton.vue.d.ts

@@ -0,0 +1,8 @@
+type __VLS_Props = {
+    height?: number;
+};
+declare const __VLS_export: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {
+    height: number;
+}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+declare const _default: typeof __VLS_export;
+export default _default;

package/dist/shared/curve-options.d.ts

@@ -0,0 +1,9 @@
+/**
+ * curve select 的 options 在 line/area 两个预设间共享：
+ * 抽常量防双侧漂移——选项值集须与翻译层 CURVE_FACTORIES 枚举保持一致，
+ * 一致性由 presets 测试的「curve select 值集与翻译层曲线枚举一致」锁定。
+ */
+export declare const CURVE_SELECT_OPTIONS: {
+    label: string;
+    value: string;
+}[];

package/dist/shared/streaming.d.ts

@@ -0,0 +1,5 @@
+/**
+ * 读取 trigger 注入的流式骨架标记（_cx_streaming，下划线前缀键不会透传物料）。
+ * 标记列出未闭合的 skeleton 顶层字段；包装层据此在主体未闭合期间渲染骨架。
+ */
+export declare function streamingFields(attrs: Record<string, unknown>): string[];

package/dist/shared/translate/axis.d.ts

@@ -0,0 +1,9 @@
+import type { ChartAxisOptions } from '@tanstack/charts';
+import type { CxChartAxisSpec } from './types';
+/**
+ * axis 声明式 → ChartAxisOptions；scale 缺省按轴位回退（x→point、y→linear）。
+ * undefined（含流式中间态：definition 开容器后 x/y 字段尚未传到）注入缺省 axis——
+ * 库对「mark 物化 channel 但 axis 无 scale 配置」抛错，缺席不等于无轴。
+ * null 原样保留（polar 等 scale 值为 never 的 definition 显式无轴）。
+ */
+export declare function translateAxis(spec: CxChartAxisSpec | null | undefined, fallbackKind: 'point' | 'linear'): ChartAxisOptions | null;

package/dist/shared/translate/composite.d.ts

@@ -0,0 +1,13 @@
+import type { ChartMark } from '@tanstack/charts';
+import type { CxChartDatasets, CxChartMarkSpec, CxChartSpec } from './types';
+/** 复合 type 守卫（definition 组装层据此分流；sunburst 虽属 polar 族约定，分发仍走此处） */
+export declare const COMPOSITE_TYPES: ReadonlySet<string>;
+/**
+ * 复合 mark 分发。tree/forceGraph 展开为多 mark；forceGraph 额外回传轴域推导结果。
+ * translateChild 仅 facet 需要。
+ */
+export declare function translateCompositeMark(spec: CxChartMarkSpec, datasets: CxChartDatasets | undefined, translateChild: (spec: CxChartSpec, rows: readonly unknown[]) => unknown): {
+    marks: ChartMark<unknown, any, any>[];
+    xDomain?: [number, number];
+    yDomain?: [number, number];
+};

package/dist/shared/translate/curve.d.ts

@@ -0,0 +1,18 @@
+import type { ChartCurve } from '@tanstack/charts';
+import type { AreaXCurve } from '@tanstack/charts/area-x';
+import type { CurveFactory } from 'd3-shape';
+import type { CxChartCurveName } from './types';
+/** curve 枚举白名单：预设物料组装 spec 前的运行时校验（JSON 输入不受 TS 约束） */
+export declare const CX_CHART_CURVE_NAMES: CxChartCurveName[];
+/** curve 枚举 → ChartCurve（line+area 函数对）；未知枚举显式抛错（JSON 输入不受 TS 约束，运行时防御） */
+export declare function translateCurve(name: CxChartCurveName): ChartCurve;
+/**
+ * curve 枚举 → AreaXCurve：violinY 等水平展开面积 mark 的专用包装
+ * （ViolinYCurve = AreaXCurve，d3Curve 产物不提供 areaX 生成器）。
+ */
+export declare function translateAreaXCurve(name: CxChartCurveName): AreaXCurve;
+/**
+ * curve 枚举 → 原生 d3 CurveFactory：polar radial 系（radialLine/radialArea）
+ * 的 curve 参数直接消费 d3 工厂而非 ChartCurve 包装（库签名实证 CurveFactory）。
+ */
+export declare function translateRadialCurve(name: CxChartCurveName): CurveFactory;

package/dist/shared/translate/definition.d.ts

@@ -0,0 +1,7 @@
+import type { DomChartDefinition } from '@tanstack/charts';
+import type { CxChartDatasets, CxChartSpec } from './types';
+/**
+ * 声明式 spec → DomChartDefinition（物料渲染入口）。
+ * datasets：命名数据集表（数据顶层化契约），marks 内字符串引用在此解析。
+ */
+export declare function translateChartSpec(spec: CxChartSpec, datasets?: CxChartDatasets): DomChartDefinition;

package/dist/shared/translate/index.d.ts

@@ -0,0 +1,15 @@
+/**
+ * 声明式 JSON → TanStack Charts 运行时定义的翻译层（桶文件）。
+ * 模块分工：types（声明式契约）/ curve / scale / axis / mark（基础+spatial）/
+ * transforms（数据预处理管道）/ polar（极坐标族）/ composite（七类命名复合）/
+ * definition（translateChartSpec 组装入口）。
+ */
+export type { CxChartAxisSpec, CxChartCurveName, CxChartDatasets, CxChartForceSpec, CxChartLayoutSpec, CxChartMarkSpec, CxChartMarkType, CxChartPolarGuideSpec, CxChartReduce, CxChartScaleSpec, CxChartSpec, CxChartTransformOutputs, CxChartTransformSpec, } from './types';
+export { CX_CHART_CURVE_NAMES, translateCurve } from './curve';
+export { translateScale } from './scale';
+export { translateAxis } from './axis';
+export { resolveMarkData, translateMark } from './mark';
+export { applyTransforms, translateOutputs, translateReduce, translateTransform } from './transforms';
+export { POLAR_FAMILY_TYPES, translatePie, translatePolar } from './polar';
+export { COMPOSITE_TYPES, translateCompositeMark } from './composite';
+export { translateChartSpec } from './definition';

package/dist/shared/translate/mark.d.ts

@@ -0,0 +1,14 @@
+import type { ChartMark } from '@tanstack/charts';
+import type { CxChartDatasets, CxChartMarkSpec } from './types';
+/**
+ * mark data 解析：字符串 → datasets 查表；数组原样透传。
+ * 未命中一律回退空数组——流式中间态（definition 先闭合、数据集在途；多数据集
+ * 部分到达）与 LLM 笔误在运行时不可区分，渲染层容错优先（与「渲染链路不过 zod，
+ * fallback 从简」契约一致）；笔误显式化归生成期校验（spec 渲染断言门）。
+ */
+export declare function resolveMarkData(data: readonly unknown[] | string | undefined, datasets: CxChartDatasets | undefined): readonly unknown[];
+/**
+ * 单 mark 声明式 → ChartMark；多余样式键对 mark 工厂无害（按名读取）。
+ * polar/pie/sankey 等容器与复合 type 不在此处（polar.ts / composite.ts 分支处理）。
+ */
+export declare function translateMark(spec: CxChartMarkSpec, datasets?: CxChartDatasets): ChartMark<unknown, any, any>;

package/dist/shared/translate/polar.d.ts

@@ -0,0 +1,19 @@
+import type { ChartMark } from '@tanstack/charts';
+import type { CxChartDatasets, CxChartMarkSpec } from './types';
+/**
+ * polar 容器：{ type:'polar', marks:[radialXxx...], angleAxis, radiusAxis, radiusRatio,
+ * startAngle, endAngle, inset, polarGuides } → polar({...})。
+ * extraMarks：调用方预组装的 PolarMark（sunburst 等自包含层级 mark 不走 radial 直译）。
+ */
+export declare function translatePolar(spec: CxChartMarkSpec, datasets: CxChartDatasets | undefined, extraMarks?: readonly unknown[]): ChartMark<unknown, any, any>;
+/**
+ * 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）。
+ */
+export declare function translatePie(spec: CxChartMarkSpec, datasets: CxChartDatasets | undefined): ChartMark<unknown, any, any>;
+/** polar 族 type 判定（definition 组装层据此应用无轴约定） */
+export declare const POLAR_FAMILY_TYPES: ReadonlySet<string>;

package/dist/shared/translate/scale.d.ts

@@ -0,0 +1,8 @@
+import type { CxChartScaleSpec } from './types';
+/**
+ * scale 声明式 → ChartScaleInput。
+ * 无 domain 时返回工厂形态（库从 marks channel 推断 domain）；
+ * 有 domain 时返回实例（保留配置，库不再推断）。
+ * 时间系（utc/time）domain 为 ISO 8601 字符串，翻译为 Date 实例（JSON 不可表达 Date）。
+ */
+export declare function translateScale(spec: CxChartScaleSpec): unknown;

package/dist/shared/translate/transforms.d.ts

@@ -0,0 +1,11 @@
+import type { CxChartDatasets, CxChartReduce, CxChartTransformOutputs, CxChartTransformSpec } from './types';
+/** reduce 声明式 → 库归约器；字符串枚举 count/sum/mean/min/max 原样透传，其余映射函数引用 */
+export declare function translateReduce(reduce: CxChartReduce): unknown;
+export declare function translateOutputs(outputs: CxChartTransformOutputs): Record<string, unknown>;
+/** 单步 transform → 行数组；源数据经 data 名查 datasets 表（缺省 rows，未命中回退空数组） */
+export declare function translateTransform(spec: CxChartTransformSpec, datasets: CxChartDatasets): readonly unknown[];
+/**
+ * 执行 transforms 管道：产物以 name 注册进 datasets 副本（不污染调用方表；
+ * 源数据集引用未命中时回退空数组——与 resolveMarkData 同一容错语义）。
+ */
+export declare function applyTransforms(transforms: readonly CxChartTransformSpec[], datasets: CxChartDatasets): CxChartDatasets;

package/dist/shared/translate/types.d.ts

@@ -0,0 +1,469 @@
+import type { ChartTheme } from '@tanstack/charts';
+/**
+ * 声明式 JSON 类型：物料 data 的投影形态。
+ *
+ * Why 存在：defineChart 的 definition 含三类不可 JSON 化值——scale（函数工厂/实例）、
+ * curve（ChartCurve 函数对）、回调（format/accessor/tooltip content）。cx 物料 data 必须
+ * 纯 JSON，本模块把声明式描述（kind 枚举、curve 枚举、字段名 channel、标量子集）约束为
+ * 可 JSON 化形态，由翻译层编译为运行时实例。channel 仅支持字段名字符串：低代码与
+ * LLM 生成场景不要求 accessor 函数（accessor 逻辑经数据预置烘焙降级）。
+ */
+export type CxChartCurveName = 'linear' | 'linearClosed' | 'monotoneX' | 'step' | 'stepAfter' | 'stepBefore' | 'basis' | 'natural' | 'catmullRom';
+/**
+ * scale 声明式枚举。时间系（utc/time）domain 用 ISO 8601 字符串表达
+ * （Date 实例 JSON 不可表达，翻译层负责 new Date 转换）。
+ */
+export type CxChartScaleSpec = {
+    kind: 'linear';
+    domain?: [number, number];
+} | {
+    kind: 'utc' | 'time';
+    domain?: [string, string];
+} | {
+    kind: 'log' | 'sqrt' | 'symlog';
+    domain?: [number, number];
+} | {
+    kind: 'pow';
+    exponent?: number;
+    domain?: [number, number];
+} | {
+    kind: 'point';
+    domain?: string[];
+    padding?: number;
+} | {
+    kind: 'band';
+    domain?: string[];
+    padding?: number;
+} | {
+    kind: 'ordinal';
+    domain?: string[];
+};
+export interface CxChartAxisSpec {
+    scale?: CxChartScaleSpec;
+    nice?: boolean | number;
+    reverse?: boolean;
+    grid?: boolean;
+    axis?: false | {
+        label?: string;
+        ticks?: {
+            count?: number;
+            size?: number;
+            padding?: number;
+            values?: (number | string)[];
+        };
+        tickLabels?: false | {
+            rotate?: number;
+            fontSize?: number;
+            dx?: number;
+            dy?: number;
+            anchor?: 'start' | 'middle' | 'end';
+        };
+    };
+}
+/**
+ * mark layout 声明式（stack/group/dodge 挂 mark.layout 字段；
+ * group 的 scale 函数形态不可 JSON，仅暴露 padding）。
+ */
+export type CxChartLayoutSpec = {
+    kind: 'stack';
+    order?: 'input' | 'ascending' | 'descending' | 'inside-out' | string[];
+    offset?: 'diverging' | 'normalize' | 'center' | 'wiggle';
+    reverse?: boolean;
+    anchor?: {
+        series: string;
+        fraction?: number;
+    };
+} | {
+    kind: 'group';
+    padding?: number;
+} | {
+    kind: 'dodgeX';
+    anchor?: 'left' | 'middle' | 'right';
+    padding?: number;
+} | {
+    kind: 'dodgeY';
+    anchor?: 'bottom' | 'middle' | 'top';
+    padding?: number;
+};
+export type CxChartMarkType = 'lineY' | 'lineX' | 'areaY' | 'areaX' | 'barY' | 'barX' | 'ruleY' | 'ruleX' | 'dot' | 'text' | 'tickX' | 'tickY' | 'bandY' | 'bandX' | 'rect' | 'cell' | 'link' | 'arrow' | 'vector' | 'hexagon' | 'frame' | 'boxY' | 'boxX' | 'violinY' | 'violinX' | 'ridgelineY' | 'ridgelineX' | 'waffleY' | 'waffleX' | 'differenceY' | 'differenceX' | 'linearRegressionY' | 'linearRegressionX' | 'voronoi' | 'hexbin' | 'contour' | 'delaunayLink' | 'density' | 'polar' | 'pie' | 'radialArc' | 'radialBarRadius' | 'radialBarAngle' | 'radialLine' | 'radialArea' | 'radialDot' | 'radialText' | 'radialRule' | 'sankey' | 'sunburst' | 'treemap' | 'tree' | 'forceGraph' | 'geoShape' | 'facet';
+/**
+ * 单 mark 声明式。平铺契约（LLM 友好）：专有标量字段全部可选、按名透传，
+ * 不适用的字段被对应工厂忽略；channel 只接受字段名字符串（弹性 channel
+ * angle/radius/width/height/length/rotate/r 另接受数值常量）。
+ */
+export interface CxChartMarkSpec {
+    type: CxChartMarkType;
+    /**
+     * 行数组（内嵌，常量数组亦可）或命名数据集字符串引用。
+     * 字符串引用由 translateChartSpec 的 datasets 表解析——GenUI 契约是数据顶层化
+     * （data.rows 与 definition 平级），marks 内以 "rows" 引用；未命中一律回退空数组
+     * （流式中间态与笔误运行时不可区分，渲染层容错优先，笔误显式化归生成期校验门）。
+     */
+    data?: readonly unknown[] | string;
+    id?: string;
+    x?: string;
+    y?: string;
+    x1?: string;
+    y1?: string;
+    x2?: string;
+    y2?: string;
+    z?: string;
+    color?: string;
+    key?: string;
+    text?: string;
+    r?: string | number;
+    angle?: string | number;
+    radius?: string | number;
+    width?: string | number;
+    height?: string | number;
+    length?: string | number;
+    rotate?: string | number;
+    stroke?: string;
+    strokeWidth?: number;
+    strokeOpacity?: number;
+    strokeDasharray?: string;
+    fill?: string;
+    fillOpacity?: number;
+    fontSize?: number;
+    fontWeight?: number;
+    dx?: number;
+    dy?: number;
+    points?: boolean;
+    opacity?: number;
+    curve?: CxChartCurveName;
+    layout?: CxChartLayoutSpec;
+    span?: number;
+    overlap?: number;
+    unit?: number;
+    round?: boolean;
+    gap?: number;
+    columns?: number;
+    headLength?: number;
+    headAngle?: number;
+    lineCap?: 'butt' | 'round' | 'square';
+    anchor?: 'start' | 'middle' | 'end';
+    ci?: number;
+    samples?: number;
+    positiveFill?: string;
+    negativeFill?: string;
+    positiveFillOpacity?: number;
+    negativeFillOpacity?: number;
+    comparisonStroke?: string;
+    cornerRadius?: number;
+    padAngle?: number;
+    radiusOffset?: number;
+    /** radial 系径向起止（radialRule 引导线/指针、radialBarRadius/radialArea 内径端）：字段名或数值常量 */
+    radius1?: string | number;
+    radius2?: string | number;
+    /** radialBarAngle 弧段角度起止（显式堆叠弧段）：字段名或数值常量 */
+    angle1?: string | number;
+    angle2?: string | number;
+    baseline?: 'auto' | 'middle' | 'hanging';
+    inset?: number;
+    /** hexbin 相邻 bin 中心水平像素距 */
+    binWidth?: number;
+    /** hexbin 聚合输出（reduce 枚举同 transforms） */
+    outputs?: CxChartTransformOutputs;
+    /** contour 等值线层数或精确层级（标量网格字段复用通用 value channel）；density 同字段表达密度层级 */
+    thresholds?: number | number[];
+    /** contour 线性插值平滑（缺省 true） */
+    smooth?: boolean;
+    /** density 高斯核带宽（CSS 像素，库缺省 20） */
+    bandwidth?: number;
+    /** density 密度网格单元尺寸（CSS 像素，库缺省 4） */
+    cellSize?: number;
+    marks?: CxChartMarkSpec[];
+    radiusRatio?: number;
+    startAngle?: number;
+    endAngle?: number;
+    angleAxis?: CxChartAxisSpec;
+    radiusAxis?: CxChartAxisSpec;
+    polarGuides?: CxChartPolarGuideSpec[];
+    innerRadiusRatio?: number;
+    outerRadiusRatio?: number;
+    value?: string;
+    path?: string;
+    delimiter?: string;
+    nodeId?: string;
+    parentId?: string;
+    nodes?: string;
+    links?: string;
+    nodeKey?: string;
+    source?: string;
+    target?: string;
+    /** sankey 稳定连线标识字段 */
+    linkKey?: string;
+    /** forceGraph 仿真参数与力集（缺省固化常规四力：link/manyBody/center/collide） */
+    domainPadding?: number;
+    forces?: CxChartForceSpec[];
+    align?: 'left' | 'right' | 'center' | 'justify';
+    nodeWidth?: number;
+    nodePadding?: number;
+    iterations?: number;
+    method?: 'squarify' | 'binary' | 'dice' | 'slice' | 'slice-dice';
+    ratio?: number;
+    paddingInner?: number;
+    paddingOuter?: number;
+    /** treemap 叶子标签字段名（string）；facet 分组标签开关（boolean）——按 mark type 分别消费 */
+    label?: string | boolean;
+    labelPadding?: number;
+    labelFontSize?: number;
+    labelFontWeight?: number;
+    orientation?: 'left' | 'right' | 'top' | 'bottom';
+    nodeSize?: [number, number];
+    projection?: 'mercator' | 'orthographic' | 'naturalEarth1' | 'albersUsa' | 'equalEarth' | 'identity';
+    fit?: 'data' | 'sphere';
+    by?: string;
+    axes?: 'outer' | 'cell';
+    minWidth?: number;
+    chart?: CxChartSpec;
+    visibleDepth?: number;
+    ringPadding?: number;
+}
+/** polar guides（radialGrid/angleGrid）声明式 */
+export interface CxChartPolarGuideSpec {
+    kind: 'radialGrid' | 'angleGrid';
+    values?: (number | string)[];
+    ticks?: number;
+    shape?: 'circle' | 'polygon';
+    labels?: boolean;
+    labelAngle?: number;
+    labelOffset?: number;
+}
+/**
+ * forceGraph 力集声明式：库 ForceDescriptor 的 JSON 子集。
+ * 数值参数接受字段名字符串（库 ForceNumericValue 支持 TransformValue）；
+ * custom 工厂形态不可 JSON，不收录。
+ */
+export type CxChartForceSpec = {
+    type: 'link';
+    distance?: number | string;
+    strength?: number | string;
+} | {
+    type: 'manyBody';
+    strength?: number | string;
+} | {
+    type: 'center';
+    x?: number;
+    y?: number;
+} | {
+    type: 'collide';
+    radius?: number | string;
+    strength?: number;
+} | {
+    type: 'x';
+    x?: number | string;
+    strength?: number | string;
+} | {
+    type: 'y';
+    y?: number | string;
+    strength?: number | string;
+};
+/**
+ * reduce 枚举（outputs 归约器）：字符串枚举全可 JSON；
+ * quantile 带参数用对象形态 { quantile: 0.25 }。
+ */
+export type CxChartReduce = 'count' | 'sum' | 'mean' | 'min' | 'max' | 'median' | 'first' | 'last' | 'variance' | 'deviation' | 'delta' | 'ratio' | {
+    quantile: number;
+};
+export interface CxChartTransformOutputs {
+    [name: string]: {
+        value?: string;
+        reduce: CxChartReduce;
+    };
+}
+/**
+ * 数据预处理管道：spec 顶层 transforms 数组，按序执行，
+ * 每步产物以 name 注册进数据集表（marks/transforms 后续步骤可字符串引用）。
+ * data 缺省引用 'rows'。binTime 系不收录（interval 对象 JSON 不可表达——时间分箱由
+ * 数据预置聚合降级）。
+ */
+export type CxChartTransformSpec = {
+    name: string;
+    kind: 'groupBy';
+    data?: string;
+    by: string | Record<string, string>;
+    outputs: CxChartTransformOutputs;
+} | {
+    name: string;
+    kind: 'binX' | 'binY';
+    data?: string;
+    value: string;
+    by?: string | Record<string, string>;
+    thresholds?: number | number[];
+    domain?: [number, number];
+    outputs?: CxChartTransformOutputs;
+} | {
+    name: string;
+    kind: 'binXY';
+    data?: string;
+    x: string;
+    y: string;
+    by?: string | Record<string, string>;
+    xThresholds?: number | number[];
+    yThresholds?: number | number[];
+    xDomain?: [number, number];
+    yDomain?: [number, number];
+    outputs?: CxChartTransformOutputs;
+} | {
+    name: string;
+    kind: 'rollingWindow';
+    data?: string;
+    size: number;
+    by?: string | Record<string, string>;
+    anchor?: 'start' | 'middle' | 'end';
+    partial?: boolean;
+    outputs: CxChartTransformOutputs;
+    orderBy?: string;
+    order?: 'ascending' | 'descending';
+} | {
+    name: string;
+    kind: 'normalize';
+    data?: string;
+    value: string;
+    by?: string | Record<string, string>;
+    as?: string;
+    basis?: 'sum' | 'max' | 'extent' | 'first' | 'last';
+} | {
+    name: string;
+    kind: 'cumulative';
+    data?: string;
+    by?: string | Record<string, string>;
+    outputs: CxChartTransformOutputs;
+    orderBy?: string;
+    order?: 'ascending' | 'descending';
+} | {
+    name: string;
+    kind: 'fold';
+    data?: string;
+    fields: string[];
+    as?: {
+        key: string;
+        value: string;
+    };
+} | {
+    name: string;
+    kind: 'rank';
+    data?: string;
+    value: string;
+    by?: string | Record<string, string>;
+    order?: 'ascending' | 'descending';
+    ties?: 'competition' | 'dense' | 'ordinal';
+    as?: string;
+} | {
+    name: string;
+    kind: 'select';
+    data?: string;
+    by?: string | Record<string, string>;
+    value?: string;
+    select: 'first' | 'last' | 'min' | 'max';
+} | {
+    name: string;
+    kind: 'stackRowsY' | 'stackRowsX';
+    data?: string;
+    x: string;
+    y: string;
+    z?: string;
+    order?: 'input' | 'ascending' | 'descending' | 'inside-out' | string[];
+    offset?: 'diverging' | 'normalize' | 'center' | 'wiggle';
+    reverse?: boolean;
+    anchor?: {
+        series: string;
+        fraction?: number;
+    };
+} | {
+    name: string;
+    kind: 'waterfall';
+    data?: string;
+    value: string;
+    by?: string | Record<string, string>;
+    total?: boolean;
+    orderBy?: string;
+    order?: 'ascending' | 'descending';
+} | {
+    name: string;
+    kind: 'mosaicY' | 'mosaicX';
+    data?: string;
+    x: string;
+    y: string;
+    value: string;
+    xOrder?: (string | number)[];
+    yOrder?: (string | number)[];
+} | {
+    name: string;
+    kind: 'linearRegressionRowsY' | 'linearRegressionRowsX';
+    data?: string;
+    x: string;
+    y: string;
+    z?: string;
+    ci?: number;
+    samples?: number;
+} | {
+    name: string;
+    kind: 'boxRows';
+    data?: string;
+    category: string;
+    value: string;
+} | {
+    name: string;
+    kind: 'pie';
+    data?: string;
+    value: string;
+    /** CX 统一 padAngle 命名（transform 侧字段为 gapAngle，翻译层映射） */
+    padAngle?: number;
+    startAngle?: number;
+    endAngle?: number;
+};
+/** 命名数据集表：物料 data 顶层除 definition 外的数组字段（GenUI 契约 rows/nodes/links） */
+export type CxChartDatasets = Record<string, readonly unknown[] | undefined>;
+export interface CxChartSpec {
+    marks: CxChartMarkSpec[];
+    x?: CxChartAxisSpec | null;
+    y?: CxChartAxisSpec | null;
+    theme?: Partial<ChartTheme>;
+    margin?: number | {
+        top?: number;
+        right?: number;
+        bottom?: number;
+        left?: number;
+    };
+    guides?: boolean;
+    clip?: boolean;
+    /** 数据预处理管道（顶层声明，marks 之前执行；产物注册进 datasets 表） */
+    transforms?: CxChartTransformSpec[];
+    /** color scale 声明式（domain/range 直可 JSON；legend 为图例声明） */
+    color?: {
+        domain?: (string | number)[];
+        range?: string[];
+        legend?: true | {
+            kind?: 'color' | 'gradient';
+            label?: string;
+            placement?: 'top' | 'bottom';
+            itemWidth?: number;
+            steps?: number;
+            width?: number;
+        };
+    };
+    tooltip?: boolean | {
+        placement?: 'auto' | 'top' | 'top-right' | 'right' | 'bottom-right' | 'bottom' | 'bottom-left' | 'left' | 'top-left' | ('top' | 'top-right' | 'right' | 'bottom-right' | 'bottom' | 'bottom-left' | 'left' | 'top-left')[];
+        offset?: number;
+        sticky?: boolean;
+        visibility?: 'focus' | 'pinned';
+        anchor?: 'point' | 'pointer' | 'group-center' | {
+            x?: 'point' | 'pointer' | 'value' | 'group-center' | 'plot-left' | 'plot-center' | 'plot-right';
+            y?: 'point' | 'pointer' | 'value' | 'group-center' | 'plot-top' | 'plot-center' | 'plot-bottom';
+        };
+        sort?: 'visual' | 'color-domain' | 'focus';
+        items?: ('x' | 'y' | 'group' | {
+            channel: 'x' | 'y' | 'group';
+            label?: string;
+        } | {
+            field: string;
+            label?: string;
+        })[];
+    };
+    pointer?: boolean;
+    keyboard?: boolean;
+    focusRing?: boolean;
+    focus?: 'nearest' | 'nearest-x' | 'nearest-y' | 'group-x' | 'group-y';
+}

package/dist/shared/use-chart-props.d.ts

@@ -0,0 +1,32 @@
+import type { ComputedRef } from 'vue';
+import type { CxChartDatasets, CxChartSpec } from './translate';
+export interface CxChartHostPartition {
+    /** <Chart> 宿主 props（标量白名单 + class/style） */
+    hostProps: ComputedRef<Record<string, unknown>>;
+    /** Chart 必填 ariaLabel，独立绑定（v-bind 对象无法向模板类型检查证明 required 键在场） */
+    ariaLabel: ComputedRef<string>;
+}
+export interface CxChartPropsPartition extends CxChartHostPartition {
+    /** 物料 JSON definition（声明式 spec，待翻译层组装） */
+    spec: ComputedRef<CxChartSpec>;
+    /** 命名数据集表（rows/nodes/links 白名单分馏；marks 字符串引用在此解析） */
+    datasets: ComputedRef<CxChartDatasets>;
+}
+/**
+ * 分馏 <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 通道组装）。
+ */
+export declare function useChartHostProps(attrs: Record<string, unknown>): CxChartHostPartition;
+/**
+ * 通用 chart 物料的分馏：definition 键 → spec，外加宿主 props。
+ *
+ * definition 键从透传集中分馏——Chart 组件的 definition prop 只接受运行时产物，
+ * 物料侧的 JSON spec 须经翻译层组装后由包装层显式绑定，不能随 v-bind 原样透传。
+ * 返回独立 computed 而非整体 ref：包装层分别绑定，避免解构丢响应性。
+ */
+export declare function useChartProps(attrs: Record<string, unknown>): CxChartPropsPartition;

package/dist/shared/use-pie-chart.d.ts

@@ -0,0 +1,20 @@
+import type { DomChartDefinition } from '@tanstack/charts';
+import type { ComputedRef } from 'vue';
+import type { CxChartHostPartition } from './use-chart-props';
+export interface CxPieChartPartition extends CxChartHostPartition {
+    /** pie 变换 + polar(radialArc) 组装的运行时 definition */
+    definition: ComputedRef<DomChartDefinition>;
+}
+/**
+ * 饼图物料的 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'（与笛卡尔预设的回退策略同形）。
+ */
+export declare function usePieChart(attrs: Record<string, unknown>): CxPieChartPartition;

package/dist/shared/use-preset-chart.d.ts

@@ -0,0 +1,25 @@
+import type { ComputedRef } from 'vue';
+import type { CxChartHostPartition } from './use-chart-props';
+import type { CxChartMarkType, CxChartScaleSpec, CxChartSpec } from './translate';
+export interface CxPresetChartOptions {
+    /** 预设 mark 类型（lineY/barY/areaY/dot 等笛卡尔单通道 mark） */
+    markType: CxChartMarkType;
+    /** x 轴 scale kind（序列类用 point/band，数值散点用 linear） */
+    xScale: CxChartScaleSpec['kind'];
+    /** 是否消费 curve 通道（line/area 支持，bar/dot 忽略） */
+    withCurve?: boolean;
+}
+export interface CxPresetChartPartition extends CxChartHostPartition {
+    /** 由通道 props（data/x/y/curve）组装的声明式 spec */
+    spec: ComputedRef<CxChartSpec>;
+}
+/**
+ * 预设物料的 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 既有教训）。
+ */
+export declare function usePresetChart(attrs: Record<string, unknown>, options: CxPresetChartOptions): CxPresetChartPartition;

package/dist/stream-triggers.d.ts

@@ -0,0 +1,9 @@
+import type { CxSpec, StreamTriggerConfig, TriggerRegistry } from '@lionad/cx-stream';
+export declare const TANSTACK_CHARTS_STREAM_TRIGGERS: StreamTriggerConfig[];
+/** 装配 TanStack Charts 物料的 trigger 注册表（size 恒 6） */
+export declare function createTanstackChartsTriggerRegistry(): TriggerRegistry<CxSpec>;
+/** 增量节点的主数组（回放计数展示用）；非数组增长型物料或数组缺席时返回 null */
+export declare function mainArrayOf(node: {
+    key: string;
+    data?: Record<string, unknown>;
+}): unknown[] | null;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lionad/cx-comps-tanstack-charts",
-  "version": "0.1.0-alpha.6",
+  "version": "0.1.0-alpha.8",
   "description": "cx material components wrapping TanStack Charts (@tanstack/charts/vue)",
   "keywords": [
     "charts",