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

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -0,0 +1,8 @@
1
+ type __VLS_Props = {
2
+ height?: number;
3
+ };
4
+ declare const __VLS_export: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {
5
+ height: number;
6
+ }, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
7
+ declare const _default: typeof __VLS_export;
8
+ export default _default;
@@ -0,0 +1,32 @@
1
+ import type { CxChartDatasets, CxChartSpec } from './types';
2
+ /**
3
+ * 单数据集整体不可渲染判定:Feature 数组且全部条目几何缺失或为占位字符串。
4
+ * 混合场景(部分真实几何)不算——部分数据仍可渲染,整体空态会误杀;
5
+ * geometry: null 是 GeoJSON 合法形态,但全部条目皆 null 时渲染结果同为空壳。
6
+ */
7
+ export declare function isPlaceholderGeometryDataset(rows: readonly unknown[]): boolean;
8
+ /**
9
+ * 组件层空态判定:整图渲染必然空壳时为 true。
10
+ *
11
+ * 判定范围收敛在纯 geoShape 图(全部 marks 均为 geoShape):geoShape 无独立于数据
12
+ * 的渲染力(数据不可用即零图元),而其余 mark 类型总有独立形状;复合图只要存在
13
+ * 一个非 geoShape mark 或一个可用 geo 数据集就返回 false,防「部分可渲染却整体
14
+ * 空态」的误杀。覆盖三种不可用形态:
15
+ * - 命名数据集占位(geometry 占位字符串/全 null)
16
+ * - 命名数据集缺失(只引用不提供,resolveMarkData 回退空数组)
17
+ * - mark 内联 data 数组本身占位(不占命名数据集表的形态)
18
+ */
19
+ export declare function isPlaceholderChartRender(spec: CxChartSpec | undefined, datasets: CxChartDatasets | undefined): boolean;
20
+ /**
21
+ * 翻译期占位几何警告:数据集整体占位时 console.warn 指出空壳根因与修复方向。
22
+ * 只挂在 geoShape(占位字符串的高发地——示意 spec 的外部轮廓数据集);普通 mark
23
+ * 的数据集在途是流式常态,warn 会成噪音。WeakSet 按引用去重,数据集内容更新
24
+ * (新引用)视为新数据集重新警告。
25
+ */
26
+ export declare function warnPlaceholderGeometry(rows: readonly unknown[], datasetName: string | undefined, markType: string): void;
27
+ /**
28
+ * 翻译期数据集缺失警告:geoShape 按名引用了数据集表中不存在的键——与占位字符串
29
+ * 同为「渲染空壳无反馈」的事故形态,区别只在根因(未提供 vs 提供了占位)。
30
+ * 按名去重(缺失数据集无内容引用可作 WeakSet 键),命名数据集到达后不再命中。
31
+ */
32
+ export declare function warnMissingGeometryDataset(datasetName: string, markType: string): void;
@@ -2,13 +2,14 @@
2
2
  * 声明式 JSON → TanStack Charts 运行时定义的翻译层(桶文件)。
3
3
  * 模块分工:types(声明式契约)/ curve / scale / axis / mark(基础+spatial)/
4
4
  * transforms(数据预处理管道)/ polar(极坐标族)/ composite(七类命名复合)/
5
- * definition(translateChartSpec 组装入口)。
5
+ * view(viewGrid 多视图组合)/ definition(translateChartSpec 组装入口)。
6
6
  */
7
- export type { CxChartAxisSpec, CxChartCurveName, CxChartDatasets, CxChartForceSpec, CxChartLayoutSpec, CxChartMarkSpec, CxChartMarkType, CxChartPolarGuideSpec, CxChartReduce, CxChartScaleSpec, CxChartSpec, CxChartTransformOutputs, CxChartTransformSpec, } from './types';
7
+ export type { CxChartAxisSpec, CxChartCurveName, CxChartDatasets, CxChartForceSpec, CxChartLayoutSpec, CxChartMarkSpec, CxChartMarkType, CxChartPolarGuideSpec, CxChartReduce, CxChartScaleSpec, CxChartSpec, CxChartTransformOutputs, CxChartTransformSpec, CxChartViewGridSpec, CxChartViewItem, CxChartViewLink, CxChartViewTrack, } from './types';
8
8
  export { CX_CHART_CURVE_NAMES, translateCurve } from './curve';
9
9
  export { translateScale } from './scale';
10
10
  export { translateAxis } from './axis';
11
- export { resolveMarkData, translateMark } from './mark';
11
+ export { isPlaceholderChartRender, isPlaceholderGeometryDataset, warnMissingGeometryDataset, warnPlaceholderGeometry, } from './geometry';
12
+ export { resolveMarkData, resolveRScaleOption, translateMark } from './mark';
12
13
  export { applyTransforms, translateOutputs, translateReduce, translateTransform } from './transforms';
13
14
  export { POLAR_FAMILY_TYPES, translatePie, translatePolar } from './polar';
14
15
  export { COMPOSITE_TYPES, translateCompositeMark } from './composite';
@@ -7,6 +7,15 @@ import type { CxChartDatasets, CxChartMarkSpec } from './types';
7
7
  * fallback 从简」契约一致);笔误显式化归生成期校验(spec 渲染断言门)。
8
8
  */
9
9
  export declare function resolveMarkData(data: readonly unknown[] | string | undefined, datasets: CxChartDatasets | undefined): readonly unknown[];
10
+ /**
11
+ * rScale 注入:库缺省 rScale 是恒等映射(字段原始值直接当像素半径,大数据值
12
+ * 渲染为巨泡)——r 为字段名时缺省注入 sqrt 映射(半径∝√值 ⇒ 面积∝值,气泡图
13
+ * 感知编码约定),domain 由库从数据推断(includeZero)。数值常量 r 是显式像素
14
+ * 意图不缩放;spec.rScale.range 覆盖缺省上下界。
15
+ * 工厂形态(无 copy 的函数)让库推断 domain;实例形态库不推断(scale-input 契约)。
16
+ * 返回 undefined 表示不注入(消费方判空挂 options)。
17
+ */
18
+ export declare function resolveRScaleOption(spec: CxChartMarkSpec): unknown;
10
19
  /**
11
20
  * 单 mark 声明式 → ChartMark;多余样式键对 mark 工厂无害(按名读取)。
12
21
  * polar/pie/sankey 等容器与复合 type 不在此处(polar.ts / composite.ts 分支处理)。
@@ -4,6 +4,9 @@ import type { CxChartDatasets, CxChartMarkSpec } from './types';
4
4
  * polar 容器:{ type:'polar', marks:[radialXxx...], angleAxis, radiusAxis, radiusRatio,
5
5
  * startAngle, endAngle, inset, polarGuides } → polar({...})。
6
6
  * extraMarks:调用方预组装的 PolarMark(sunburst 等自包含层级 mark 不走 radial 直译)。
7
+ * 0.18 契约:angle/radius scale 配置收进容器级 options.scales 保留通道
8
+ * (resolvePolarLayout 读 options.scales 的 reserved angle/radius 条目),
9
+ * 不再是顶层 angle/radius 字段;definition.scales 只需 x/y null 占位。
7
10
  */
8
11
  export declare function translatePolar(spec: CxChartMarkSpec, datasets: CxChartDatasets | undefined, extraMarks?: readonly unknown[]): ChartMark<unknown, any, any>;
9
12
  /**
@@ -38,13 +38,65 @@ export type CxChartScaleSpec = {
38
38
  kind: 'ordinal';
39
39
  domain?: string[];
40
40
  };
41
+ /** 网格线/轴基线渲染中立描边样式(官方 ChartGuideLineStyle 的 JSON 投影) */
42
+ export interface CxChartGuideLineStyle {
43
+ stroke?: string;
44
+ strokeOpacity?: number;
45
+ strokeWidth?: number;
46
+ strokeDasharray?: string;
47
+ lineCap?: 'butt' | 'round' | 'square';
48
+ }
49
+ /** 渐变 stop(0–1 objectBoundingBox;offset 回退时由渲染器向前钳制) */
50
+ export interface CxChartGradientStop {
51
+ offset: number;
52
+ color: string;
53
+ opacity?: number;
54
+ }
55
+ /** 线性渐变:type 可省;坐标缺省垂直自底向上 (0,1)→(0,0) */
56
+ export interface CxChartLinearGradient {
57
+ type?: 'linear';
58
+ id: string;
59
+ stops: CxChartGradientStop[];
60
+ x1?: number;
61
+ y1?: number;
62
+ x2?: number;
63
+ y2?: number;
64
+ }
65
+ /** 径向渐变:type 必填;cx/cy/r 缺省 0.5,fx/fy 缺省继承中心 */
66
+ export interface CxChartRadialGradient {
67
+ type: 'radial';
68
+ id: string;
69
+ stops: CxChartGradientStop[];
70
+ cx?: number;
71
+ cy?: number;
72
+ r?: number;
73
+ fx?: number;
74
+ fy?: number;
75
+ }
41
76
  export interface CxChartAxisSpec {
42
77
  scale?: CxChartScaleSpec;
43
78
  nice?: boolean | number;
44
79
  reverse?: boolean;
45
- grid?: boolean;
80
+ /** true 画缺省网格;对象形态覆盖网格线描边呈现(0.18 ChartGuideLineStyle) */
81
+ grid?: boolean | CxChartGuideLineStyle;
82
+ /**
83
+ * 半径像素 range 的比例对(相对 polar 最终半径,0–1),仅 polar 容器的
84
+ * radiusAxis 消费;物化为官方 PolarLength 回调数组(resize 时随最终半径重解析)。
85
+ * 用途:rose/径向条等需要「语义零映射到内径偏移」而非物理圆心的场景。
86
+ */
87
+ range?: [number, number];
46
88
  axis?: false | {
47
- label?: string;
89
+ /** 轴标题:字符串缺省呈现;对象形态定制字号/字重/填充/偏移(0.18 ChartAxisLabelOptions) */
90
+ label?: string | {
91
+ text: string;
92
+ offset?: number | 'auto';
93
+ fontSize?: number;
94
+ fontWeight?: number;
95
+ fill?: string;
96
+ opacity?: number;
97
+ };
98
+ /** 轴基线:缺省不画;true 画缺省基线,对象形态覆盖基线描边(0.18 axis.line) */
99
+ line?: boolean | CxChartGuideLineStyle;
48
100
  ticks?: {
49
101
  count?: number;
50
102
  size?: number;
@@ -89,7 +141,8 @@ export type CxChartMarkType = 'lineY' | 'lineX' | 'areaY' | 'areaX' | 'barY' | '
89
141
  /**
90
142
  * 单 mark 声明式。平铺契约(LLM 友好):专有标量字段全部可选、按名透传,
91
143
  * 不适用的字段被对应工厂忽略;channel 只接受字段名字符串(弹性 channel
92
- * angle/radius/width/height/length/rotate/r 另接受数值常量)。
144
+ * angle/radius/width/height/length/rotate/r 另接受数值常量;x1/y1 仅在
145
+ * rect 基线场景接受数值常量——对应官方直方图零基线写法 y1:()=>0)。
93
146
  */
94
147
  export interface CxChartMarkSpec {
95
148
  type: CxChartMarkType;
@@ -101,10 +154,17 @@ export interface CxChartMarkSpec {
101
154
  */
102
155
  data?: readonly unknown[] | string;
103
156
  id?: string;
157
+ /**
158
+ * 装饰层开关:true 时经库 decorative() 包装——保留比例尺与绘制几何、剥离交互
159
+ * 所有权(tooltip 命中/焦点/条件高亮均跳过该 mark)。典型:辅助折线/参考线/标注
160
+ * 不抢数据点的 tooltip 命中。库层约束是带 focus/states 行为的 mark 不可包装
161
+ * (initialize 抛 TypeError),本 grammar 不暴露条件态声明,故恒安全。
162
+ */
163
+ decorative?: boolean;
104
164
  x?: string;
105
165
  y?: string;
106
- x1?: string;
107
- y1?: string;
166
+ x1?: string | number;
167
+ y1?: string | number;
108
168
  x2?: string;
109
169
  y2?: string;
110
170
  z?: string;
@@ -112,8 +172,23 @@ export interface CxChartMarkSpec {
112
172
  key?: string;
113
173
  text?: string;
114
174
  r?: string | number;
175
+ /**
176
+ * 半径缩放声明式(仅 r 为字段名时消费;数值常量 r 是显式像素意图,不缩放)。
177
+ * 库缺省 rScale 为恒等映射(原始值直接当像素半径),翻译层对字段名 r 缺省注入
178
+ * sqrt 面积映射(半径∝√值 ⇒ 面积∝值,气泡图感知编码约定),本字段覆盖其
179
+ * range 像素上下界;kind 不收(sqrt 是气泡半径的正确默认,线性半径会平方夸大差异)。
180
+ */
181
+ rScale?: {
182
+ range?: [number, number];
183
+ };
115
184
  angle?: string | number;
116
- radius?: string | number;
185
+ /**
186
+ * 双语义:radial 系是 radius channel(字段名/数值常量);直角 barX/barY 是圆角
187
+ * BarRadius——数值全角、[tl,tr,br,bl] 四角差异化(对象形态 {end,stack} 不收,
188
+ * 防与 channel 语义混淆)。cornerRadius 是 polar 族字段名(radialArc),直角系
189
+ * 由翻译层别名归一到本字段(显式 radius 优先)。
190
+ */
191
+ radius?: string | number | readonly [number, number, number, number];
117
192
  width?: string | number;
118
193
  height?: string | number;
119
194
  length?: string | number;
@@ -211,8 +286,12 @@ export interface CxChartMarkSpec {
211
286
  labelFontWeight?: number;
212
287
  orientation?: 'left' | 'right' | 'top' | 'bottom';
213
288
  nodeSize?: [number, number];
214
- projection?: 'mercator' | 'orthographic' | 'naturalEarth1' | 'albersUsa' | 'equalEarth' | 'identity';
215
- fit?: 'data' | 'sphere';
289
+ projection?: 'mercator' | 'orthographic' | 'naturalEarth1' | 'albersUsa' | 'equalEarth' | 'equirectangular' | 'identity' | {
290
+ $by: Record<string, 'mercator' | 'orthographic' | 'naturalEarth1' | 'albersUsa' | 'equalEarth' | 'equirectangular' | 'identity'>;
291
+ };
292
+ fit?: 'data' | 'sphere' | {
293
+ data: string;
294
+ };
216
295
  by?: string;
217
296
  axes?: 'outer' | 'cell';
218
297
  minWidth?: number;
@@ -229,6 +308,22 @@ export interface CxChartPolarGuideSpec {
229
308
  labels?: boolean;
230
309
  labelAngle?: number;
231
310
  labelOffset?: number;
311
+ id?: string;
312
+ className?: string;
313
+ labelClassName?: string;
314
+ stroke?: string;
315
+ strokeOpacity?: number;
316
+ strokeWidth?: number;
317
+ strokeDasharray?: string;
318
+ fill?: string;
319
+ fillOpacity?: number;
320
+ labelFill?: string;
321
+ labelFontSize?: number;
322
+ labelAnchor?: 'start' | 'middle' | 'end';
323
+ labelBaseline?: 'auto' | 'middle' | 'hanging';
324
+ labelDx?: number;
325
+ labelDy?: number;
326
+ labelRotate?: number;
232
327
  }
233
328
  /**
234
329
  * forceGraph 力集声明式:库 ForceDescriptor 的 JSON 子集。
@@ -414,10 +509,51 @@ export type CxChartTransformSpec = {
414
509
  startAngle?: number;
415
510
  endAngle?: number;
416
511
  };
417
- /** 命名数据集表:物料 data 顶层除 definition 外的数组字段(GenUI 契约 rows/nodes/links) */
512
+ /** 命名数据集表:物料 data 顶层除 definition 外的数组字段全量分馏(rows 恒为主数据集,其余按语义自由命名:geo 的 sphere/land、分层图 innerRows/outerRows 等) */
418
513
  export type CxChartDatasets = Record<string, readonly unknown[] | undefined>;
514
+ /** viewGrid 网格轨道:size 固定像素 / grow 按比例分配剩余空间(min/max 钳制) */
515
+ export type CxChartViewTrack = {
516
+ id: string;
517
+ size: number;
518
+ } | {
519
+ id: string;
520
+ grow: number;
521
+ min?: number;
522
+ max?: number;
523
+ };
524
+ /** viewGrid 轴链接目标:share 共享 scale(domain/序/方向/bandwidth 须一致,不一致显式失败);align 仅对齐 plot 端点、domain 各自独立 */
525
+ export interface CxChartViewLink {
526
+ x?: string;
527
+ y?: string;
528
+ }
529
+ export interface CxChartViewItem {
530
+ id: string;
531
+ /** 轨道引用:row/column 分别指向 views.rows/views.columns 的轨道 id */
532
+ row: string;
533
+ column: string;
534
+ share?: CxChartViewLink;
535
+ align?: CxChartViewLink;
536
+ /**
537
+ * 子视图 spec(marks/x/y/color/margin/guides/transforms 等归属子图);
538
+ * host 权属字段(tooltip/pointer/keyboard/focus/focusRing)归外层组合定义,
539
+ * 子视图声明即拒绝(官方 assertChildDefinition 契约);不支持嵌套 views。
540
+ */
541
+ chart: CxChartSpec;
542
+ }
543
+ /** viewGrid 多视图组合(非重叠网格;叠层/内嵌等组合形态官方 composeViews 支持、契约暂不暴露) */
544
+ export interface CxChartViewGridSpec {
545
+ rows: CxChartViewTrack[];
546
+ columns: CxChartViewTrack[];
547
+ gap?: number;
548
+ rowGap?: number;
549
+ columnGap?: number;
550
+ items: CxChartViewItem[];
551
+ }
419
552
  export interface CxChartSpec {
420
- marks: CxChartMarkSpec[];
553
+ /** viewGrid 顶层省略(views 与 marks 互斥);其余场景必填 */
554
+ marks?: CxChartMarkSpec[];
555
+ /** 多视图组合:存在时 marks 须为空,各子视图在网格单元内独立成图、共享外层 host */
556
+ views?: CxChartViewGridSpec;
421
557
  x?: CxChartAxisSpec | null;
422
558
  y?: CxChartAxisSpec | null;
423
559
  theme?: Partial<ChartTheme>;
@@ -429,6 +565,12 @@ export interface CxChartSpec {
429
565
  };
430
566
  guides?: boolean;
431
567
  clip?: boolean;
568
+ /**
569
+ * 渐变资源(0.18 ChartGradient 投影):mark 以 fill/stroke 'url(#id)' 引用。
570
+ * host 权属资源——views 子图声明即拒绝(官方 child 契约),归外层组合定义。
571
+ * 坐标与 stop offset 为 0–1 objectBoundingBox;linear 缺省垂直自底向上。
572
+ */
573
+ gradients?: (CxChartLinearGradient | CxChartRadialGradient)[];
432
574
  /** 数据预处理管道(顶层声明,marks 之前执行;产物注册进 datasets 表) */
433
575
  transforms?: CxChartTransformSpec[];
434
576
  /** color scale 声明式(domain/range 直可 JSON;legend 为图例声明) */
@@ -442,6 +584,24 @@ export interface CxChartSpec {
442
584
  itemWidth?: number;
443
585
  steps?: number;
444
586
  width?: number;
587
+ /** 条目子集定制(仅 kind:'color';物化为 colorLegendItems,0.18 契约) */
588
+ items?: {
589
+ justify?: 'start' | 'center' | 'stretch';
590
+ gap?: number;
591
+ rowGap?: number;
592
+ indicator?: {
593
+ shape?: 'dot' | 'square' | 'line' | 'line-dot';
594
+ width?: number;
595
+ height?: number;
596
+ gap?: number;
597
+ };
598
+ label?: {
599
+ fontSize?: number;
600
+ fontWeight?: number;
601
+ fill?: string;
602
+ fillOpacity?: number;
603
+ };
604
+ };
445
605
  };
446
606
  };
447
607
  tooltip?: boolean | {
@@ -454,6 +614,9 @@ export interface CxChartSpec {
454
614
  y?: 'point' | 'pointer' | 'value' | 'group-center' | 'plot-top' | 'plot-center' | 'plot-bottom';
455
615
  };
456
616
  sort?: 'visual' | 'color-domain' | 'focus';
617
+ /** 追加到 tooltip 根元素的自定义类名(`ts-chart-tooltip <className>`),
618
+ * 供物料/宿主用 CSS 分化指示器等外壳样式 */
619
+ className?: string;
457
620
  items?: ('x' | 'y' | 'group' | {
458
621
  channel: 'x' | 'y' | 'group';
459
622
  label?: string;
@@ -464,6 +627,35 @@ export interface CxChartSpec {
464
627
  };
465
628
  pointer?: boolean;
466
629
  keyboard?: boolean;
467
- focusRing?: boolean;
630
+ /** 焦点环:true/false 显隐;对象形态定制几何与描边填充(0.18 ChartFocusRingOptions) */
631
+ focusRing?: boolean | {
632
+ radius?: number;
633
+ fill?: string;
634
+ stroke?: string;
635
+ strokeWidth?: number;
636
+ };
468
637
  focus?: 'nearest' | 'nearest-x' | 'nearest-y' | 'group-x' | 'group-y';
638
+ /**
639
+ * 动效声明(可 JSON 化子集)。声明即走 motion 挂载分支:库 vue adapter 未暴露
640
+ * motion renderer 注入,cx 组件层自组装 renderer adapter。transition/delay 翻译为
641
+ * 库 definition.motion 的 chart 级默认时序;initial/resize 为 renderer 级选项。
642
+ * mark 级 per-datum motion 回调不可 JSON 化,不收。
643
+ */
644
+ motion?: {
645
+ transition?: {
646
+ type: 'tween';
647
+ duration?: number;
648
+ easing?: 'linear' | 'ease' | 'ease-in' | 'ease-out' | 'ease-in-out';
649
+ } | {
650
+ type: 'spring';
651
+ stiffness?: number;
652
+ damping?: number;
653
+ mass?: number;
654
+ restSpeed?: number;
655
+ restDelta?: number;
656
+ };
657
+ delay?: number;
658
+ initial?: boolean | 'always';
659
+ resize?: boolean;
660
+ };
469
661
  }
@@ -0,0 +1,16 @@
1
+ import type { CxChartDatasets, CxChartSpec } from './types';
2
+ /**
3
+ * viewGrid 多视图组合:spec.views → 官方 viewGrid(命名视图 + 网格轨道 + 轴链接)。
4
+ *
5
+ * 权属分界(官方 assertChildDefinition 契约):子 view 保留 marks/scales/guides/
6
+ * margin/color/clip;host 字段(tooltip/keyboard/pointer/focus/focusRing/motion/
7
+ * gradients/theme.background)只能由外层组合定义持有,子 view 携带即被库拒绝。
8
+ * 子 view 经 buildChild 以 child 模式递归构建(剥除 host 字段,见 definition.ts);
9
+ * 顶层 host 字段(theme 合并、tooltip 缺省注入)由 applyHost 施加于组合产物。
10
+ * hooks 回调注入保持依赖单向(definition.ts → view.ts,同 composite 先例)。
11
+ */
12
+ export interface CxChartViewGridHooks {
13
+ buildChild: (child: CxChartSpec, datasets: CxChartDatasets | undefined) => unknown;
14
+ applyHost: (composed: Record<string, unknown>, spec: CxChartSpec) => Record<string, unknown>;
15
+ }
16
+ export declare function translateViewGrid(spec: CxChartSpec, datasets: CxChartDatasets | undefined, hooks: CxChartViewGridHooks): Record<string, unknown>;
@@ -9,7 +9,7 @@ export interface CxChartHostPartition {
9
9
  export interface CxChartPropsPartition extends CxChartHostPartition {
10
10
  /** 物料 JSON definition(声明式 spec,待翻译层组装) */
11
11
  spec: ComputedRef<CxChartSpec>;
12
- /** 命名数据集表(rows/nodes/links 白名单分馏;marks 字符串引用在此解析) */
12
+ /** 命名数据集表(顶层数组字段全量分馏;marks 字符串引用在此解析) */
13
13
  datasets: ComputedRef<CxChartDatasets>;
14
14
  }
15
15
  /**
@@ -2,7 +2,11 @@ import type { CxSpec, StreamTriggerConfig, TriggerRegistry } from '@lionad/cx-st
2
2
  export declare const TANSTACK_CHARTS_STREAM_TRIGGERS: StreamTriggerConfig[];
3
3
  /** 装配 TanStack Charts 物料的 trigger 注册表(size 恒 6) */
4
4
  export declare function createTanstackChartsTriggerRegistry(): TriggerRegistry<CxSpec>;
5
- /** 增量节点的主数组(回放计数展示用);非数组增长型物料或数组缺席时返回 null */
5
+ /**
6
+ * 增量节点的主数组(回放计数展示用);非数组增长型物料或数组缺席时返回 null。
7
+ * 通配主数组形态(arrayKey '*')无单一主数组,取最长数组字段为主数据集
8
+ * (如桑基的 links 之于 nodes);并列时取序列化序靠前者。
9
+ */
6
10
  export declare function mainArrayOf(node: {
7
11
  key: string;
8
12
  data?: Record<string, unknown>;
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@lionad/cx-comps-tanstack-charts",
3
- "version": "0.1.0-alpha.8",
3
+ "version": "0.1.0",
4
4
  "description": "cx material components wrapping TanStack Charts (@tanstack/charts/vue)",
5
5
  "keywords": [
6
6
  "charts",
@@ -35,15 +35,15 @@
35
35
  "access": "public"
36
36
  },
37
37
  "dependencies": {
38
- "@lionad/cx-definition": "0.1.0-alpha.10",
39
- "@lionad/cx-stream": "0.1.0-alpha.10",
40
- "@lionad/cx-vue": "0.1.0-alpha.10",
38
+ "@lionad/cx-definition": "0.1.0",
39
+ "@lionad/cx-stream": "0.1.0",
40
+ "@lionad/cx-vue": "0.1.0",
41
41
  "d3-geo": "^3.1.1",
42
42
  "d3-scale": "^4.0.2",
43
43
  "d3-shape": "^3.2.0"
44
44
  },
45
45
  "devDependencies": {
46
- "@tanstack/charts": "^0.14.0",
46
+ "@tanstack/charts": "^0.18.0",
47
47
  "@types/d3-geo": "^3.1.1",
48
48
  "@types/d3-scale": "^4.0.9",
49
49
  "@types/d3-shape": "^3.1.8",
@@ -53,7 +53,7 @@
53
53
  "vue-tsc": "^3.3.7"
54
54
  },
55
55
  "peerDependencies": {
56
- "@tanstack/charts": "^0.14.0",
56
+ "@tanstack/charts": "^0.18.0",
57
57
  "@vueuse/core": "^13.0.0 || ^14.0.0",
58
58
  "vue": "^3.5.0"
59
59
  },