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

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;