@fengwk/kchart 0.0.0-stage → 0.1.1

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.
Files changed (201) hide show
  1. package/CHANGELOG.md +17 -0
  2. package/LICENSE +21 -0
  3. package/NOTICE.md +11 -0
  4. package/README.md +68 -2
  5. package/README.zh-CN.md +69 -0
  6. package/dist/LICENSE +21 -0
  7. package/dist/NOTICE.md +11 -0
  8. package/dist/assets/ICONS-LICENSE.txt +53 -0
  9. package/dist/assets/maps/LICENSE.md +75 -0
  10. package/dist/assets/maps/METADATA.md +9 -0
  11. package/dist/assets/maps/REGIONS.md +28 -0
  12. package/dist/assets/maps/us-states.geojson +1 -0
  13. package/dist/assets/maps/world.geojson +1 -0
  14. package/dist/esm/_virtual/_kchart-families.js +48 -0
  15. package/dist/esm/_virtual/_rolldown/runtime.js +12 -0
  16. package/dist/esm/assets/icons.js +11 -0
  17. package/dist/esm/assets/maps/us-states.js +3 -0
  18. package/dist/esm/assets/maps/world.js +3 -0
  19. package/dist/esm/assets/themes/claude.js +69 -0
  20. package/dist/esm/assets/themes/cloudmusic.js +62 -0
  21. package/dist/esm/assets/themes/kanagawa.js +67 -0
  22. package/dist/esm/assets/themes/obsidian.js +67 -0
  23. package/dist/esm/assets/themes/paper.js +61 -0
  24. package/dist/esm/assets/themes/terminal.js +60 -0
  25. package/dist/esm/assets/themes/tokyo.js +62 -0
  26. package/dist/esm/chart/basic.js +1313 -0
  27. package/dist/esm/chart/catalog.js +476 -0
  28. package/dist/esm/chart/composition.js +844 -0
  29. package/dist/esm/chart/context.js +189 -0
  30. package/dist/esm/chart/distribution.js +442 -0
  31. package/dist/esm/chart/fields.js +67 -0
  32. package/dist/esm/chart/maps.js +563 -0
  33. package/dist/esm/chart/mindmap.js +629 -0
  34. package/dist/esm/chart/multivariate.js +1229 -0
  35. package/dist/esm/chart/registry.js +108 -0
  36. package/dist/esm/chart/relations.js +949 -0
  37. package/dist/esm/chart/spec.js +1415 -0
  38. package/dist/esm/chart/stat-compare.js +302 -0
  39. package/dist/esm/chart/stat-trend.js +181 -0
  40. package/dist/esm/chart/statistics.js +1007 -0
  41. package/dist/esm/chart/unit-variants.js +645 -0
  42. package/dist/esm/chart/variants.js +552 -0
  43. package/dist/esm/core/color.js +197 -0
  44. package/dist/esm/core/context.js +256 -0
  45. package/dist/esm/core/diagnostics.js +23 -0
  46. package/dist/esm/core/format.js +167 -0
  47. package/dist/esm/core/geometry.js +130 -0
  48. package/dist/esm/core/icon-data.js +5 -0
  49. package/dist/esm/core/icons.js +173 -0
  50. package/dist/esm/core/scale.js +112 -0
  51. package/dist/esm/core/scene.js +234 -0
  52. package/dist/esm/core/svg.js +89 -0
  53. package/dist/esm/core/text.js +184 -0
  54. package/dist/esm/core/theme.js +318 -0
  55. package/dist/esm/diagram/agentflow.js +596 -0
  56. package/dist/esm/diagram/architecture.js +729 -0
  57. package/dist/esm/diagram/block.js +988 -0
  58. package/dist/esm/diagram/blocks.js +687 -0
  59. package/dist/esm/diagram/c4.js +1002 -0
  60. package/dist/esm/diagram/class.js +1158 -0
  61. package/dist/esm/diagram/cynefin.js +749 -0
  62. package/dist/esm/diagram/emphasis.js +7 -0
  63. package/dist/esm/diagram/er.js +657 -0
  64. package/dist/esm/diagram/eventmodeling.js +948 -0
  65. package/dist/esm/diagram/gantt-date.js +323 -0
  66. package/dist/esm/diagram/gantt.js +661 -0
  67. package/dist/esm/diagram/gitgraph.js +472 -0
  68. package/dist/esm/diagram/graph-layout.js +4046 -0
  69. package/dist/esm/diagram/graph-parse.js +1366 -0
  70. package/dist/esm/diagram/graph-route.js +490 -0
  71. package/dist/esm/diagram/graph.js +553 -0
  72. package/dist/esm/diagram/ishikawa.js +496 -0
  73. package/dist/esm/diagram/journey.js +512 -0
  74. package/dist/esm/diagram/kanban.js +280 -0
  75. package/dist/esm/diagram/label.js +56 -0
  76. package/dist/esm/diagram/layers.js +385 -0
  77. package/dist/esm/diagram/map-label.js +44 -0
  78. package/dist/esm/diagram/mindmap.js +277 -0
  79. package/dist/esm/diagram/numeric-composition.js +78 -0
  80. package/dist/esm/diagram/numeric-model.js +86 -0
  81. package/dist/esm/diagram/numeric-parse.js +205 -0
  82. package/dist/esm/diagram/numeric-radar.js +355 -0
  83. package/dist/esm/diagram/numeric-sankey.js +201 -0
  84. package/dist/esm/diagram/numeric-xy.js +422 -0
  85. package/dist/esm/diagram/packet.js +175 -0
  86. package/dist/esm/diagram/presentation.js +252 -0
  87. package/dist/esm/diagram/quadrant.js +297 -0
  88. package/dist/esm/diagram/railroad-parse.js +465 -0
  89. package/dist/esm/diagram/railroad.js +294 -0
  90. package/dist/esm/diagram/registry.js +296 -0
  91. package/dist/esm/diagram/relations.js +966 -0
  92. package/dist/esm/diagram/requirement.js +341 -0
  93. package/dist/esm/diagram/sequence.js +1228 -0
  94. package/dist/esm/diagram/shapes.js +366 -0
  95. package/dist/esm/diagram/source.js +538 -0
  96. package/dist/esm/diagram/support.js +153 -0
  97. package/dist/esm/diagram/swimlane-mermaid.js +140 -0
  98. package/dist/esm/diagram/swimlane.js +1186 -0
  99. package/dist/esm/diagram/time.js +748 -0
  100. package/dist/esm/diagram/timeline.js +376 -0
  101. package/dist/esm/diagram/tree-family-icon.js +22 -0
  102. package/dist/esm/diagram/treeview.js +293 -0
  103. package/dist/esm/diagram/usecase.js +852 -0
  104. package/dist/esm/diagram/venn.js +1038 -0
  105. package/dist/esm/diagram/wardley.js +838 -0
  106. package/dist/esm/index.d.ts +133 -0
  107. package/dist/esm/index.js +92 -0
  108. package/dist/esm/interaction.js +561 -0
  109. package/dist/esm/mermaid.d.ts +28 -0
  110. package/dist/esm/mermaid.js +70 -0
  111. package/dist/esm/node.d.ts +68 -0
  112. package/dist/esm/node.js +373 -0
  113. package/dist/esm/package.json +1 -0
  114. package/dist/esm/page-api.js +65 -0
  115. package/dist/esm/runtime.js +352 -0
  116. package/dist/esm/src/families.js +209 -0
  117. package/dist/page-api.js +1 -0
  118. package/dist/units/chart/basic.js +1 -0
  119. package/dist/units/chart/catalog.js +1 -0
  120. package/dist/units/chart/composition.js +1 -0
  121. package/dist/units/chart/context.js +1 -0
  122. package/dist/units/chart/distribution.js +1 -0
  123. package/dist/units/chart/fields.js +1 -0
  124. package/dist/units/chart/maps.js +1 -0
  125. package/dist/units/chart/mindmap.js +1 -0
  126. package/dist/units/chart/multivariate.js +1 -0
  127. package/dist/units/chart/registry.js +1 -0
  128. package/dist/units/chart/relations.js +1 -0
  129. package/dist/units/chart/spec.js +3 -0
  130. package/dist/units/chart/stat-compare.js +1 -0
  131. package/dist/units/chart/stat-trend.js +1 -0
  132. package/dist/units/chart/statistics.js +1 -0
  133. package/dist/units/chart/unit-variants.js +1 -0
  134. package/dist/units/chart/variants.js +1 -0
  135. package/dist/units/core/color.js +1 -0
  136. package/dist/units/core/context.js +1 -0
  137. package/dist/units/core/diagnostics.js +1 -0
  138. package/dist/units/core/format.js +1 -0
  139. package/dist/units/core/geometry.js +1 -0
  140. package/dist/units/core/icon-data.js +1 -0
  141. package/dist/units/core/icons.js +1 -0
  142. package/dist/units/core/scale.js +1 -0
  143. package/dist/units/core/scene.js +1 -0
  144. package/dist/units/core/svg.js +1 -0
  145. package/dist/units/core/text.js +2 -0
  146. package/dist/units/core/theme.js +1 -0
  147. package/dist/units/diagram/agentflow.js +12 -0
  148. package/dist/units/diagram/architecture.js +4 -0
  149. package/dist/units/diagram/block.js +2 -0
  150. package/dist/units/diagram/blocks.js +2 -0
  151. package/dist/units/diagram/c4.js +6 -0
  152. package/dist/units/diagram/class.js +5 -0
  153. package/dist/units/diagram/cynefin.js +4 -0
  154. package/dist/units/diagram/emphasis.js +1 -0
  155. package/dist/units/diagram/er.js +9 -0
  156. package/dist/units/diagram/eventmodeling.js +5 -0
  157. package/dist/units/diagram/gantt-date.js +1 -0
  158. package/dist/units/diagram/gantt.js +3 -0
  159. package/dist/units/diagram/gitgraph.js +2 -0
  160. package/dist/units/diagram/graph-layout.js +4 -0
  161. package/dist/units/diagram/graph-parse.js +9 -0
  162. package/dist/units/diagram/graph-route.js +1 -0
  163. package/dist/units/diagram/graph.js +1 -0
  164. package/dist/units/diagram/ishikawa.js +2 -0
  165. package/dist/units/diagram/journey.js +5 -0
  166. package/dist/units/diagram/kanban.js +2 -0
  167. package/dist/units/diagram/label.js +4 -0
  168. package/dist/units/diagram/layers.js +1 -0
  169. package/dist/units/diagram/map-label.js +1 -0
  170. package/dist/units/diagram/mindmap.js +2 -0
  171. package/dist/units/diagram/numeric-composition.js +1 -0
  172. package/dist/units/diagram/numeric-model.js +1 -0
  173. package/dist/units/diagram/numeric-parse.js +2 -0
  174. package/dist/units/diagram/numeric-radar.js +3 -0
  175. package/dist/units/diagram/numeric-sankey.js +2 -0
  176. package/dist/units/diagram/numeric-xy.js +2 -0
  177. package/dist/units/diagram/packet.js +2 -0
  178. package/dist/units/diagram/presentation.js +2 -0
  179. package/dist/units/diagram/quadrant.js +2 -0
  180. package/dist/units/diagram/railroad-parse.js +4 -0
  181. package/dist/units/diagram/railroad.js +1 -0
  182. package/dist/units/diagram/registry.js +2 -0
  183. package/dist/units/diagram/relations.js +3 -0
  184. package/dist/units/diagram/requirement.js +3 -0
  185. package/dist/units/diagram/sequence.js +2 -0
  186. package/dist/units/diagram/shapes.js +60 -0
  187. package/dist/units/diagram/source.js +20 -0
  188. package/dist/units/diagram/support.js +3 -0
  189. package/dist/units/diagram/swimlane-mermaid.js +3 -0
  190. package/dist/units/diagram/swimlane.js +2 -0
  191. package/dist/units/diagram/time.js +3 -0
  192. package/dist/units/diagram/timeline.js +2 -0
  193. package/dist/units/diagram/tree-family-icon.js +1 -0
  194. package/dist/units/diagram/treeview.js +2 -0
  195. package/dist/units/diagram/usecase.js +3 -0
  196. package/dist/units/diagram/venn.js +2 -0
  197. package/dist/units/diagram/wardley.js +4 -0
  198. package/dist/units/interaction.js +1 -0
  199. package/dist/units/runtime.js +1 -0
  200. package/dist/units.json +712 -0
  201. package/package.json +30 -4
@@ -0,0 +1,552 @@
1
+ import { __exportAll } from "../_virtual/_rolldown/runtime.js";
2
+ import { decorate } from "./registry.js";
3
+ import "./basic.js";
4
+ import "./statistics.js";
5
+ import { apportion, columnHeaders } from "../core/geometry.js";
6
+ // src/chart/variants.js
7
+ var variants_exports = /* @__PURE__ */ __exportAll({ install: () => install });
8
+ var tone = (ctx, i) => ctx.color(`tone${i % 6 + 1}`);
9
+ var isEnglish = (ctx) => /^en(?:-|$)/i.test(String(ctx.lang || ""));
10
+ var scene = (base, width, height, children) => ({
11
+ ...base,
12
+ width,
13
+ height,
14
+ children
15
+ });
16
+ var visit = (nodes, fn, parents = []) => {
17
+ for (let i = 0; i < nodes.length; i += 1) {
18
+ const node = nodes[i];
19
+ fn(node, nodes, i, parents);
20
+ if (node.children) visit(node.children, fn, [...parents, node]);
21
+ }
22
+ };
23
+ function lineVariant(spec, ctx, next) {
24
+ if (!spec.variant) return next();
25
+ const base = next();
26
+ const data = ctx.table(spec);
27
+ const series = data.series;
28
+ if (spec.variant === "counter") {
29
+ const rows = [];
30
+ series.forEach((item, seriesIndex) => {
31
+ let last = -1;
32
+ item.values.forEach((value, i) => {
33
+ if (value != null) last = i;
34
+ });
35
+ if (last < 0) return;
36
+ const raw = item.values[last];
37
+ const plotted = spec.stack === "absolute" ? series.slice(0, seriesIndex).reduce((sum, prior) => {
38
+ const value = prior.values[last] ?? 0;
39
+ return sum + (value === 0 || Math.sign(value) === (raw < 0 ? -1 : 1) ? value : 0);
40
+ }, raw) : raw;
41
+ const value = ctx.format(plotted, item.field);
42
+ const valueWidth = ctx.measure(value, 16, 700);
43
+ const label = `${item.label} · ${data.categories[last]}`;
44
+ const lines = ctx.wrap(label, Math.max(40, base.width - valueWidth - 40), 12);
45
+ const emphasis = spec.emphasis || {};
46
+ const selected = (emphasis.series || []).includes(item.id) || (emphasis.fields || []).includes(item.field);
47
+ const active = (emphasis.series || []).length > 0 || (emphasis.fields || []).length > 0;
48
+ const fill = selected ? ctx.color("accent") : tone(ctx, seriesIndex);
49
+ rows.push({
50
+ item,
51
+ last,
52
+ raw,
53
+ plotted,
54
+ value,
55
+ lines,
56
+ fill,
57
+ opacity: active && !selected ? .28 : 1,
58
+ height: Math.max(36, lines.length * 16 + 12)
59
+ });
60
+ });
61
+ const readoutHeight = rows.reduce((sum, row) => sum + row.height, 0);
62
+ const children = [];
63
+ let y = 0;
64
+ rows.forEach(({ item, last, raw, plotted, value, lines, fill, opacity, height }) => {
65
+ children.push(ctx.textLines(12, y + 15, lines, {
66
+ fill: ctx.color("muted"),
67
+ size: 12
68
+ }));
69
+ children.push(ctx.text(base.width - 12, y + Math.max(22, (height + 16) / 2), value, {
70
+ anchor: "end",
71
+ size: 16,
72
+ weight: 700,
73
+ fill,
74
+ "fill-opacity": opacity,
75
+ meta: {
76
+ kind: "counter",
77
+ series: item.id,
78
+ value: raw,
79
+ plotted,
80
+ label: String(data.categories[last])
81
+ }
82
+ }));
83
+ y += height;
84
+ });
85
+ children.push(ctx.el("g", { transform: `translate(0 ${readoutHeight})` }, base.children));
86
+ return scene(base, base.width, base.height + readoutHeight, children);
87
+ }
88
+ const marks = [];
89
+ visit(base.children, (node, siblings, index, parents) => {
90
+ if (node.tag === "circle" && node.meta?.kind === "record") marks.push(node);
91
+ });
92
+ const yAxis = base.children.find((node) => node.tag === "line" && node.attrs.stroke === ctx.color("axis") && Number(node.attrs.y1) === Number(node.attrs.y2));
93
+ const baseline = yAxis ? Number(yAxis.attrs.y1) : Math.max(...marks.map((node) => Number(node.attrs.cy)));
94
+ const children = [];
95
+ const cleaned = (node) => {
96
+ if (node.tag === "defs" && (node.children || []).some((child) => child.attrs?.id === "basic-line-gradient")) return null;
97
+ if (node.tag === "path" && (node.attrs.fill === "url(#basic-line-gradient)" || node.attrs.fill === "none" && node.meta?.kind === "series")) return null;
98
+ const copy = { ...node };
99
+ if (node.children) copy.children = node.children.map(cleaned).filter(Boolean);
100
+ return copy;
101
+ };
102
+ let inserted = false;
103
+ base.children.forEach((child) => {
104
+ const node = cleaned(child);
105
+ if (!node) return;
106
+ if (!inserted && child.tag === "circle" && child.meta?.kind === "record") {
107
+ marks.forEach((mark) => children.push(ctx.line(mark.attrs.cx, baseline, mark.attrs.cx, mark.attrs.cy, {
108
+ stroke: mark.attrs.fill || ctx.color("ink"),
109
+ "stroke-width": 1,
110
+ "stroke-opacity": mark.attrs["fill-opacity"] ?? 1,
111
+ meta: {
112
+ kind: "barcode",
113
+ record: mark.meta.record,
114
+ series: mark.meta.series,
115
+ value: mark.meta.value,
116
+ label: mark.meta.label
117
+ }
118
+ })));
119
+ inserted = true;
120
+ }
121
+ children.push(node);
122
+ });
123
+ if (!inserted) marks.forEach((mark) => children.push(ctx.line(mark.attrs.cx, baseline, mark.attrs.cx, mark.attrs.cy, {
124
+ stroke: mark.attrs.fill || ctx.color("ink"),
125
+ "stroke-width": 1,
126
+ meta: {
127
+ kind: "barcode",
128
+ record: mark.meta.record,
129
+ series: mark.meta.series,
130
+ value: mark.meta.value,
131
+ label: mark.meta.label
132
+ }
133
+ })));
134
+ return scene(base, base.width, base.height, children);
135
+ }
136
+ function shareTicks(spec, ctx, next) {
137
+ if (spec.variant !== "ticks") return next();
138
+ const data = ctx.table(spec), children = [], tickCount = 24, rowH = 22;
139
+ const categories = data.categories, colors = categories.map((_, i) => tone(ctx, i));
140
+ const legend = ctx.legend(categories.map((label, i) => ({
141
+ label: String(label),
142
+ color: colors[i],
143
+ meta: {
144
+ kind: "category",
145
+ label
146
+ }
147
+ })), ctx.width - 32);
148
+ children.push(...legend.children);
149
+ const labelColumn = Math.max(36, ...data.series.map((series) => {
150
+ const full = ctx.measure(String(series.label), 12, 500);
151
+ if (full <= ctx.width * .42) return full;
152
+ const lines = ctx.wrap(series.label, Math.max(36, ctx.width * .42), 12, 500);
153
+ return Math.max(...lines.map((line) => ctx.measure(line, 12, 500)));
154
+ }));
155
+ const left = labelColumn + 24;
156
+ const longestReadout = Math.max(40, ...data.series.flatMap((series) => {
157
+ const total = series.values.reduce((sum, value) => sum + (value ?? 0), 0) || 1;
158
+ const items = series.values.map((value, i) => `${categories[i]} ${ctx.percent((value ?? 0) / total)}`);
159
+ items.push(`${isEnglish(ctx) ? "total" : "合计"} ${ctx.format(series.values.reduce((sum, value) => sum + (value ?? 0), 0), series.field)}`);
160
+ return items.map((item) => ctx.measure(item, 12));
161
+ }));
162
+ const chartWidth = Math.max(ctx.width, left + Math.min(longestReadout, 220) + 20);
163
+ const right = chartWidth - 10;
164
+ let y = 8 + legend.height + (legend.height ? 8 : 0);
165
+ data.series.forEach((series) => {
166
+ const values = series.values.map((value) => value ?? 0);
167
+ const total = values.reduce((sum, value) => sum + value, 0);
168
+ if (values.some((value) => value < 0) || !(total > 0)) ctx.fit("ticks占比要求非负且总值大于0", "修正数据或使用solid占比图");
169
+ const top = y + 20;
170
+ const label = ctx.wrap(series.label, Math.max(18, labelColumn), 12, 500);
171
+ children.push(ctx.textLines(left - 12, top + rowH / 2 + 4 - (label.length - 1) * 8, label, {
172
+ anchor: "end",
173
+ fill: ctx.color("fg"),
174
+ meta: {
175
+ kind: "series",
176
+ series: series.id
177
+ }
178
+ }));
179
+ const step = (right - left - 2.2) / 23;
180
+ for (let i = 0; i < tickCount; i += 1) {
181
+ const position = (i + .5) / tickCount * total;
182
+ let cumulative = 0;
183
+ let categoryIndex = values.findIndex((value) => {
184
+ cumulative += value;
185
+ return position < cumulative;
186
+ });
187
+ if (categoryIndex < 0) categoryIndex = values.length - 1;
188
+ const x = left + 1.1 + i * step;
189
+ children.push(ctx.line(x, top, x, top + rowH, {
190
+ stroke: colors[categoryIndex],
191
+ "stroke-width": 2.2,
192
+ meta: {
193
+ kind: "tick",
194
+ series: series.id,
195
+ category: categories[categoryIndex],
196
+ numerator: values[categoryIndex],
197
+ denominator: total,
198
+ tickCount
199
+ }
200
+ }));
201
+ }
202
+ const readouts = values.map((value, i) => `${categories[i]} ${ctx.percent(value / total)}`);
203
+ readouts.push(`${isEnglish(ctx) ? "total" : "合计"} ${ctx.format(total, series.field)}`);
204
+ const lines = ctx.flow(readouts, right - left, 12);
205
+ lines.forEach((items, i) => children.push(ctx.text(left, top + rowH + 16 + i * 16, items.join(" · "), {
206
+ size: 12,
207
+ fill: ctx.color("muted"),
208
+ meta: {
209
+ kind: "readout",
210
+ series: series.id,
211
+ items
212
+ }
213
+ })));
214
+ y += Math.max(50, 28 + label.length * 16) + lines.length * 16;
215
+ });
216
+ const base = next();
217
+ return scene(base, Math.max(chartWidth, base.width, right + 10), y + 4, children);
218
+ }
219
+ function hourglass(spec, ctx, next) {
220
+ if (spec.variant !== "hourglass") return next();
221
+ const base = next(), data = ctx.table(spec), values = data.series[0].values, field = data.valueFields[0];
222
+ if (values.some((value) => value == null || value < 0) || !(values[0] > 0) || values.some((value, i) => i > 0 && value > values[i - 1])) ctx.fit("hourglass要求非负且逐级不增,首步大于0", "修正阶段数据或使用bars漏斗");
223
+ const english = isEnglish(ctx), max = values[0];
224
+ const labelLimit = Math.max(72, Math.min(160, ctx.width * .36));
225
+ const labelWidth = Math.max(48, ...data.categories.map((label) => {
226
+ const full = ctx.measure(String(label), 12, 600);
227
+ if (full + 8 <= labelLimit) return full + 8;
228
+ const lines = ctx.wrap(String(label), labelLimit, 12, 600);
229
+ return Math.max(...lines.map((line) => ctx.measure(line, 12, 600))) + 8;
230
+ }));
231
+ const rows = values.map((value, i) => {
232
+ const previous = i ? values[i - 1] : null;
233
+ return {
234
+ value,
235
+ i,
236
+ amount: ctx.format(value, field),
237
+ share: `${english ? "Of first stage" : "占首步"} ${ctx.percent(value / max)}`,
238
+ prior: i === 0 ? "" : previous === 0 ? english ? "Previous step is 0" : "上一步为0,不可计算" : `${english ? "Of previous step" : "占上一步"} ${ctx.percent(value / previous)}`,
239
+ labelLines: ctx.wrap(String(data.categories[i]), labelWidth, 12, 600)
240
+ };
241
+ });
242
+ const readoutWidth = Math.max(40, ...rows.flatMap((row) => [
243
+ ctx.measure(row.amount, 14, 700),
244
+ ctx.measure(row.share, 12),
245
+ row.prior ? ctx.measure(row.prior, 12) : 0
246
+ ]));
247
+ const requiredWidth = 8 + labelWidth + 8 + 90 + 8 + readoutWidth + 8;
248
+ const width = Math.max(ctx.width, requiredWidth);
249
+ const shapeX = 8 + labelWidth + 8;
250
+ const shapeWidth = Math.min(440, width - (32 + labelWidth + readoutWidth));
251
+ const center = shapeX + shapeWidth / 2, rightX = shapeX + shapeWidth + 8;
252
+ const children = [], top = 12, lastIndex = rows.length - 1;
253
+ let y = top;
254
+ rows.forEach((row) => {
255
+ const rowHeight = Math.max(64, row.labelLines.length * 16 + 16);
256
+ const currentWidth = shapeWidth * row.value / max;
257
+ const nextWidth = row.i < lastIndex ? shapeWidth * values[row.i + 1] / max : currentWidth;
258
+ const shapeTop = y, shapeBottom = y + rowHeight - 4;
259
+ const lowerLeft = center - nextWidth / 2, lowerRight = center + nextWidth / 2;
260
+ const upperLeft = center - currentWidth / 2, upperRight = center + currentWidth / 2;
261
+ const contour = `M ${upperLeft} ${shapeTop} C ${upperLeft} ${shapeTop + rowHeight * .42} ${lowerLeft} ${shapeTop + rowHeight * .58} ${lowerLeft} ${shapeBottom} L ${lowerRight} ${shapeBottom} C ${lowerRight} ${shapeTop + rowHeight * .58} ${upperRight} ${shapeTop + rowHeight * .42} ${upperRight} ${shapeTop} Z`;
262
+ children.push(ctx.path(contour, {
263
+ fill: ctx.mix(ctx.palette.tone1, ctx.palette.bg, .12),
264
+ stroke: ctx.color("ink"),
265
+ "stroke-width": 1,
266
+ meta: {
267
+ kind: "stage",
268
+ label: data.categories[row.i],
269
+ value: row.value,
270
+ shapeWidth
271
+ }
272
+ }));
273
+ const labelY = y + (rowHeight - (row.labelLines.length - 1) * 16) / 2 + 4;
274
+ children.push(ctx.textLines(8, labelY, row.labelLines, {
275
+ size: 12,
276
+ weight: 600,
277
+ fill: ctx.color("fg")
278
+ }));
279
+ const valueY = y + 18;
280
+ children.push(ctx.text(rightX, valueY, row.amount, {
281
+ size: 14,
282
+ weight: 700,
283
+ fill: ctx.color("fg")
284
+ }));
285
+ children.push(ctx.text(rightX, valueY + 18, row.share, {
286
+ size: 12,
287
+ fill: ctx.color("muted")
288
+ }));
289
+ if (row.prior) children.push(ctx.text(rightX, valueY + 36, row.prior, {
290
+ size: 12,
291
+ fill: ctx.color("muted")
292
+ }));
293
+ y += rowHeight;
294
+ });
295
+ return scene(base, width, y + 8, children);
296
+ }
297
+ function plumb(spec, ctx, next) {
298
+ if (spec.variant !== "plumb") return next();
299
+ const base = next();
300
+ const horizontalGrid = [];
301
+ let marks = [];
302
+ visit(base.children, (node, siblings, index) => {
303
+ if (node.tag === "line" && Number(node.attrs.y1) === Number(node.attrs.y2) && node.attrs.stroke === ctx.palette.grid) horizontalGrid.push(Number(node.attrs.y1));
304
+ if (node.tag === "circle" && Number.isFinite(Number(node.attrs.cx)) && Number.isFinite(Number(node.attrs.cy))) marks.push({
305
+ node,
306
+ siblings,
307
+ index
308
+ });
309
+ });
310
+ const bottom = horizontalGrid.length ? Math.max(...horizontalGrid) : Math.max(...marks.map((mark) => Number(mark.node.attrs.cy)));
311
+ if (!Number.isFinite(bottom)) return base;
312
+ const stems = marks.map(({ node }) => ctx.line(Number(node.attrs.cx), bottom, Number(node.attrs.cx), Number(node.attrs.cy), {
313
+ stroke: ctx.color("muted"),
314
+ "stroke-width": 1,
315
+ meta: {
316
+ kind: "plumb",
317
+ x: Number(node.attrs.cx),
318
+ y: Number(node.attrs.cy)
319
+ }
320
+ }));
321
+ let inserted = false;
322
+ const children = [];
323
+ base.children.forEach((child) => {
324
+ const containsMark = (() => {
325
+ let found = false;
326
+ visit([child], (node) => {
327
+ if (node.tag === "circle" && marks.some((mark) => mark.node === node)) found = true;
328
+ });
329
+ return found;
330
+ })();
331
+ if (!inserted && containsMark) {
332
+ children.push(...stems);
333
+ inserted = true;
334
+ }
335
+ children.push(child);
336
+ });
337
+ if (!inserted) children.unshift(...stems);
338
+ return scene(base, base.width, base.height, children);
339
+ }
340
+ function heatmap(spec, ctx, next) {
341
+ if (!["dots", "arc"].includes(spec.variant)) return next();
342
+ const base = next(), e = spec.encode, rows = spec.data;
343
+ const rowNames = ctx.field(e.row).domain || [...new Set(rows.map((row) => row[e.row]))];
344
+ const colNames = ctx.field(e.column).domain || [...new Set(rows.map((row) => row[e.column]))];
345
+ const meta = ctx.field(e.value), values = rows.map((row) => row[e.value]).filter(Number.isFinite);
346
+ const maxValue = meta.domain?.[1] ?? Math.max(1, ...values.filter((value) => value >= 0));
347
+ const maxMagnitude = Math.max(1, ...values.map(Math.abs), ...(meta.domain || []).map(Math.abs));
348
+ const rowLabelWidth = Math.min(Math.max(0, ...rowNames.map((label) => ctx.measure(String(label), 12, 400) + 8)), Math.max(72, ctx.width * .28));
349
+ const left = rowLabelWidth + 8;
350
+ const headers = columnHeaders(ctx, colNames, {
351
+ left,
352
+ right: 8
353
+ });
354
+ const cw = headers.slot;
355
+ const ringRadius = Math.max(5, Math.min(12, (cw - 4) * .34));
356
+ const years = headers.years;
357
+ const headerHeight = Math.max(1, ...headers.items.map((item) => item.lines.length || 1)) * 16;
358
+ const rowLineCount = Math.max(1, ...rowNames.map((label) => ctx.wrap(String(label), rowLabelWidth, 12).length));
359
+ const top = 20 + (years ? 16 : 0) + headerHeight, ch = Math.max(42, rowLineCount * 20 + 8), children = [];
360
+ headers.items.forEach((item, j) => {
361
+ if (item.year) children.push(ctx.text(left + j * cw, 12, item.year, {
362
+ size: 12,
363
+ fill: ctx.color("muted")
364
+ }));
365
+ if (item.lines.length) children.push(ctx.textLines(left + (j + .5) * cw, years ? 32 : 16, item.lines, {
366
+ anchor: "middle",
367
+ size: 12,
368
+ fill: ctx.color("muted")
369
+ }));
370
+ });
371
+ rowNames.forEach((label, i) => {
372
+ const y = top + i * ch;
373
+ const rowLines = ctx.wrap(String(label), rowLabelWidth, 12);
374
+ children.push(ctx.textLines(left - 8, y + (ch - (rowLines.length - 1) * 20) / 2 + 4, rowLines, {
375
+ anchor: "end",
376
+ size: 12,
377
+ fill: ctx.color("muted"),
378
+ leading: 20
379
+ }));
380
+ colNames.forEach((column, j) => {
381
+ const x = left + j * cw, row = rows.find((item) => item[e.row] === label && item[e.column] === column);
382
+ const cx = x + cw / 2, cy = y + ch / 2;
383
+ if (!row || row[e.value] == null) {
384
+ children.push(ctx.circle(cx, cy, 3, {
385
+ fill: "none",
386
+ stroke: ctx.color("axis"),
387
+ "stroke-width": 1,
388
+ meta: {
389
+ kind: "missing",
390
+ row: label,
391
+ column
392
+ }
393
+ }));
394
+ return;
395
+ }
396
+ const value = row[e.value];
397
+ const tip = `${label} · ${column}: ${ctx.format(value, e.value)}`;
398
+ if (spec.variant === "dots") {
399
+ if (value === 0) {
400
+ const dot = ctx.circle(cx, cy, 3, {
401
+ fill: "none",
402
+ stroke: ctx.color("ink"),
403
+ "stroke-width": 1.5,
404
+ meta: {
405
+ kind: "zero",
406
+ row: label,
407
+ column,
408
+ value
409
+ }
410
+ });
411
+ children.push(ctx.titled(dot, tip));
412
+ } else {
413
+ const radius = Math.sqrt(Math.abs(value) / maxMagnitude) * ringRadius;
414
+ const dot = ctx.circle(cx, cy, radius, {
415
+ fill: value < 0 ? ctx.color("accent") : ctx.color("ink"),
416
+ "fill-opacity": .82,
417
+ meta: {
418
+ kind: "cell",
419
+ row: label,
420
+ column,
421
+ value,
422
+ area: Math.abs(value)
423
+ }
424
+ });
425
+ children.push(ctx.titled(dot, tip));
426
+ }
427
+ } else {
428
+ const ratio = meta.format === "percent" ? value : value / maxValue;
429
+ const progress = Math.max(0, Math.min(1, ratio)), endX = cx + ringRadius * Math.sin(progress * Math.PI * 2), endY = cy - ringRadius * Math.cos(progress * Math.PI * 2);
430
+ children.push(ctx.circle(cx, cy, ringRadius, {
431
+ fill: "none",
432
+ stroke: ctx.color("grid"),
433
+ "stroke-width": 3,
434
+ meta: {
435
+ kind: "arc-track",
436
+ row: label,
437
+ column,
438
+ maximum: meta.format === "percent" ? 1 : maxValue
439
+ }
440
+ }));
441
+ if (progress > 0) {
442
+ const d = progress >= 1 ? `M ${cx} ${cy - ringRadius} A ${ringRadius} ${ringRadius} 0 1 1 ${cx} ${cy + ringRadius} A ${ringRadius} ${ringRadius} 0 1 1 ${cx} ${cy - ringRadius}` : `M ${cx} ${cy - ringRadius} A ${ringRadius} ${ringRadius} 0 ${progress > .5 ? 1 : 0} 1 ${endX} ${endY}`;
443
+ const arc = ctx.path(d, {
444
+ fill: "none",
445
+ stroke: ctx.color("ink"),
446
+ "stroke-width": 3,
447
+ "stroke-linecap": "round",
448
+ meta: {
449
+ kind: "cell",
450
+ row: label,
451
+ column,
452
+ value,
453
+ maximum: meta.format === "percent" ? 1 : maxValue
454
+ }
455
+ });
456
+ children.push(ctx.titled(arc, tip));
457
+ } else {
458
+ const zero = ctx.circle(cx, cy, 1.5, {
459
+ fill: "none",
460
+ stroke: ctx.color("ink"),
461
+ "stroke-width": 1,
462
+ meta: {
463
+ kind: "cell",
464
+ row: label,
465
+ column,
466
+ value,
467
+ maximum: meta.format === "percent" ? 1 : maxValue
468
+ }
469
+ });
470
+ children.push(ctx.titled(zero, tip));
471
+ }
472
+ }
473
+ });
474
+ });
475
+ const chartWidth = Math.max(ctx.width, left + colNames.length * cw + 8);
476
+ const maximumLabel = meta.format === "percent" ? isEnglish(ctx) ? "Full arc = 100%" : "整弧 = 100%" : `${isEnglish(ctx) ? "Full arc" : "整弧"} = ${ctx.format(maxValue, e.value)}`;
477
+ const missingNote = rowNames.some((row) => colNames.some((column) => {
478
+ const cell = rows.find((item) => item[e.row] === row && item[e.column] === column);
479
+ return !cell || cell[e.value] == null;
480
+ })) ? isEnglish(ctx) ? "Hollow ring = missing." : "空心环表示缺失。" : "";
481
+ const note = spec.variant === "arc" ? [isEnglish(ctx) ? `${maximumLabel}; arc fraction is measured from zero.` : `${maximumLabel};弧长按从零起的比例表示。`, missingNote].filter(Boolean).join(" ") : [isEnglish(ctx) ? "Dot area is proportional to absolute value; a hollow ring marks zero." : "点面积与绝对值成比例;空心点表示零。", missingNote].filter(Boolean).join(" ");
482
+ const noteLines = ctx.wrap(note, Math.max(40, chartWidth - left - 16), 12);
483
+ children.push(ctx.textLines(left, top + rowNames.length * ch + 20, noteLines, {
484
+ size: 12,
485
+ fill: ctx.color("muted")
486
+ }));
487
+ return scene(base, chartWidth, top + rowNames.length * ch + 32 + (noteLines.length - 1) * 16, children);
488
+ }
489
+ function waffleField(spec, ctx, next) {
490
+ if (spec.variant !== "field") return next();
491
+ const base = next(), data = ctx.table(spec), values = data.series[0].values;
492
+ const total = values.reduce((sum, value) => sum + (value ?? 0), 0);
493
+ if (values.some((value) => value == null || value < 0) || !(total > 0)) ctx.fit("waffle field要求非负且合计大于0", "修正数值或使用适合的比较图");
494
+ const counts = apportion(values, 100);
495
+ const width = Math.max(ctx.width, 260), cols = 5, pitch = 15, radius = 4, top = 24, children = [];
496
+ const categoryLabels = data.categories.map((label, i) => `${label} · ${ctx.percent(values[i] / total)}`);
497
+ const pointWidth = 64;
498
+ const labelWidth = Math.max(40, Math.min(width - 32 - pointWidth - 16, ...categoryLabels.map((label) => ctx.measure(label, 12, 600))));
499
+ const contentWidth = 80 + labelWidth;
500
+ const left = Math.max(18, (width - contentWidth) / 2), labelX = left + pointWidth + 16;
501
+ let cursorY = top;
502
+ counts.forEach((count, category) => {
503
+ const rows = Math.ceil(count / cols), pointHeight = Math.max(1, rows) * pitch;
504
+ const label = categoryLabels[category];
505
+ const labelLines = ctx.wrap(label, labelWidth, 12, 600, { bounded: true });
506
+ const groupHeight = Math.max(pointHeight, labelLines.length * 16);
507
+ const pointTop = cursorY + (groupHeight - pointHeight) / 2;
508
+ for (let index = 0; index < count; index += 1) {
509
+ const x = left + index % cols * pitch;
510
+ const y = pointTop + Math.floor(index / cols) * pitch;
511
+ children.push(ctx.circle(x, y, radius, {
512
+ fill: tone(ctx, category),
513
+ meta: {
514
+ kind: "unit",
515
+ category: data.categories[category],
516
+ percent: 1,
517
+ index
518
+ }
519
+ }));
520
+ }
521
+ children.push(ctx.textLines(labelX, cursorY + (groupHeight - labelLines.length * 16) / 2 + 12, labelLines, {
522
+ size: 12,
523
+ weight: 600,
524
+ fill: ctx.color("fg"),
525
+ meta: {
526
+ kind: "category",
527
+ label: data.categories[category],
528
+ percent: counts[category]
529
+ }
530
+ }));
531
+ cursorY += groupHeight + 10;
532
+ });
533
+ const note = isEnglish(ctx) ? "100 points; each point = 1 percentage point. Largest-remainder rounding; points are not individuals." : "共100点,每点表示1个百分点;按最大余数法舍入,不代表真实个体。";
534
+ const noteLines = ctx.wrap(note, width - 32, 12, 400, { bounded: true });
535
+ const noteY = cursorY + 4;
536
+ children.push(ctx.textLines(16, noteY, noteLines, {
537
+ size: 12,
538
+ fill: ctx.color("muted")
539
+ }));
540
+ return scene(base, width, noteY + noteLines.length * 16 + 8, children);
541
+ }
542
+ function install({ decorate }) {
543
+ const decorated = (name, fn) => decorate(name, (spec, ctx, next) => fn(spec, ctx, next));
544
+ decorated("line", lineVariant);
545
+ decorated("share", shareTicks);
546
+ decorated("funnel", hourglass);
547
+ decorated("scatter", plumb);
548
+ decorated("heatmap", heatmap);
549
+ decorated("waffle", waffleField);
550
+ }
551
+ install({ decorate });
552
+ export { install, variants_exports };