@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,189 @@
1
+ import { __exportAll } from "../_virtual/_rolldown/runtime.js";
2
+ import { createContext } from "../core/context.js";
3
+ import { compactTemporal, formatPercent, isEnglish, makeFormatters, tickTexts } from "../core/format.js";
4
+ import { extent, niceScale } from "../core/scale.js";
5
+ import { fieldReader } from "./fields.js";
6
+ // src/chart/context.js
7
+ var context_exports = /* @__PURE__ */ __exportAll({
8
+ dataTable: () => dataTable,
9
+ makeContext: () => makeContext
10
+ });
11
+ function dateCategories(values, type, fit) {
12
+ const unique = [...new Set(values)];
13
+ if (type !== "date" && type !== "month") return unique;
14
+ if (!unique.every((value) => typeof value === "string" && (type === "date" ? /^\d{4}-\d{2}-\d{2}$/.test(value) : /^\d{4}-\d{2}$/.test(value))) || !unique.length) return unique;
15
+ const toDay = (s) => {
16
+ const d = /* @__PURE__ */ new Date(0);
17
+ d.setUTCHours(0, 0, 0, 0);
18
+ d.setUTCFullYear(+s.slice(0, 4), +s.slice(5, 7) - 1, type === "date" ? +s.slice(8, 10) : 1);
19
+ return d.getTime();
20
+ };
21
+ const fromDay = (n) => {
22
+ const d = new Date(n);
23
+ return type === "date" ? d.toISOString().slice(0, 10) : d.toISOString().slice(0, 7);
24
+ };
25
+ const lo = Math.min(...unique.map(toDay)), hi = Math.max(...unique.map(toDay));
26
+ const first = new Date(lo), last = new Date(hi);
27
+ if ((type === "date" ? Math.floor((hi - lo) / 864e5) + 1 : (last.getUTCFullYear() - first.getUTCFullYear()) * 12 + last.getUTCMonth() - first.getUTCMonth() + 1) > 1e4) fit("时间分类跨度过大,无法安全补档", "缩小时间范围后重试");
28
+ const out = [];
29
+ for (let t = lo; t <= hi;) {
30
+ out.push(fromDay(t));
31
+ const d = new Date(t);
32
+ type === "date" ? d.setUTCDate(d.getUTCDate() + 1) : d.setUTCMonth(d.getUTCMonth() + 1);
33
+ t = d.getTime();
34
+ }
35
+ return out;
36
+ }
37
+ function makeContext(options = {}) {
38
+ const ctx = createContext(options);
39
+ const sourceSpec = options.spec || {};
40
+ const { field, format } = fieldReader(sourceSpec, ctx.lang);
41
+ ctx.field = field;
42
+ ctx.format = format;
43
+ ctx.compactTemporal = (labels) => compactTemporal(labels, ctx.lang);
44
+ ctx.ticks = (values, fieldName, { zero = false, count = 4, intervals = null, length = null, size = 12, padding = 0, adjacent = false, percentSymbol = true } = {}) => {
45
+ const meta = ctx.field(fieldName);
46
+ if (meta.scale === "log") throw new Error("Logarithmic ticks must be calculated by the chart layout");
47
+ const annotations = (sourceSpec.annotations || []).filter((a) => a.field === fieldName && ["rule", "band"].includes(a.kind)).flatMap((a) => a.kind === "rule" ? [a.value] : [a.from, a.to]);
48
+ const domain = Array.isArray(meta.domain) && meta.domain.length === 2 ? meta.domain : [];
49
+ let [min, max] = extent([
50
+ ...values || [],
51
+ ...domain,
52
+ ...annotations
53
+ ]);
54
+ if (padding > 0) {
55
+ if (zero) {
56
+ min = Math.min(0, min);
57
+ max = Math.max(0, max);
58
+ }
59
+ const extra = (max - min || Math.abs(max) || 1) * padding;
60
+ min = zero && min === 0 ? 0 : min >= 0 ? Math.max(0, min - extra) : min - extra;
61
+ max = zero && max === 0 ? 0 : max <= 0 ? Math.min(0, max + extra) : max + extra;
62
+ }
63
+ const percent = meta.format === "percent";
64
+ const scaleOf = (n) => {
65
+ const result = niceScale(min, max, {
66
+ zero,
67
+ count: n,
68
+ intervals
69
+ });
70
+ const f = makeFormatters(ctx.lang);
71
+ f.decimals = meta.decimals ?? 0;
72
+ const displayTicks = percent ? result.ticks.map((tick) => tick * 100) : result.ticks;
73
+ const step = percent ? result.step * 100 : result.step;
74
+ const labels = tickTexts(displayTicks, step, f, percent ? "%" : meta.unit, { percentSymbol });
75
+ return {
76
+ ...result,
77
+ labels
78
+ };
79
+ };
80
+ const fits = ({ ticks, labels }) => {
81
+ if (ticks.length < 2) return true;
82
+ const widths = labels.map((label) => ctx.measure(label, size, 400));
83
+ const spacing = length / (ticks.length - 1);
84
+ return adjacent ? widths.every((width, i) => i === 0 || (widths[i - 1] + width) / 2 + 8 <= spacing) : Math.max(...widths) + 8 <= spacing;
85
+ };
86
+ let result = scaleOf(count);
87
+ if (Number(length) > 0 && intervals == null) for (let n = count - 1; n >= 1 && !fits(result); n -= 1) result = scaleOf(n);
88
+ return result;
89
+ };
90
+ ctx.percent = (ratio, decimals = 1) => {
91
+ if (!Number.isFinite(ratio)) return "—";
92
+ const f = makeFormatters(ctx.lang);
93
+ return formatPercent(ratio * 100, f, decimals);
94
+ };
95
+ ctx.table = (input = sourceSpec) => table(input, ctx);
96
+ return ctx;
97
+ }
98
+ function table(spec, ctx) {
99
+ const rows = Array.isArray(spec?.data) ? spec.data : Array.isArray(spec?.rows) ? spec.rows : [];
100
+ const enc = spec?.encode || {};
101
+ const categoryField = enc.category || enc.time || enc.date || enc.month || null;
102
+ const valueRole = enc.value ?? enc.values ?? null;
103
+ const valueFields = Array.isArray(valueRole) ? valueRole : valueRole ? [valueRole] : [];
104
+ const seriesField = enc.series || null, categoryMeta = categoryField ? ctx.field(categoryField) : {};
105
+ const hasDomain = Array.isArray(categoryMeta.domain);
106
+ let categories = categoryField ? hasDomain ? [...categoryMeta.domain] : dateCategories(rows.map((row) => row?.[categoryField]), categoryMeta.type, ctx.fit) : [];
107
+ const temporal = [
108
+ "date",
109
+ "month",
110
+ "datetime"
111
+ ].includes(categoryMeta.type), sort = spec?.sort;
112
+ if (!hasDomain && categories.length && (temporal || sort)) {
113
+ const original = new Map(categories.map((category, index) => [category, index]));
114
+ const sortValue = (category) => !sort || sort.field === categoryField ? category : rows.find((row) => row?.[categoryField] === category)?.[sort.field] ?? null;
115
+ const compare = (a, b) => {
116
+ if (!sort && temporal || sort?.field === categoryField && temporal) {
117
+ const aTime = Date.parse(a), bTime = Date.parse(b);
118
+ if (Number.isFinite(aTime) && Number.isFinite(bTime)) return aTime - bTime;
119
+ }
120
+ if (typeof a === "number" && typeof b === "number") return a - b;
121
+ const left = String(a), right = String(b);
122
+ return left < right ? -1 : left > right ? 1 : 0;
123
+ };
124
+ categories.sort((a, b) => {
125
+ const left = sortValue(a), right = sortValue(b);
126
+ if (sort && sort.field !== categoryField && (left == null || right == null)) return left == null ? right == null ? original.get(a) - original.get(b) : 1 : -1;
127
+ const result = compare(left, right);
128
+ return (sort?.direction === "desc" ? -result : result) || original.get(a) - original.get(b);
129
+ });
130
+ }
131
+ const series = [];
132
+ if (seriesField && valueFields.length === 1) {
133
+ const ids = [...new Set(rows.map((row) => row?.[seriesField]))];
134
+ for (const id of ids) {
135
+ const values = categories.map((category) => {
136
+ const value = rows.find((r) => r?.[categoryField] === category && r?.[seriesField] === id)?.[valueFields[0]];
137
+ return typeof value === "number" && Number.isFinite(value) ? value : null;
138
+ });
139
+ series.push({
140
+ id: String(id),
141
+ label: String(id),
142
+ field: valueFields[0],
143
+ values
144
+ });
145
+ }
146
+ } else for (const name of valueFields) series.push({
147
+ id: String(name),
148
+ label: ctx.field(name).label,
149
+ field: name,
150
+ values: categories.map((category) => {
151
+ const value = rows.find((r) => r?.[categoryField] === category)?.[name];
152
+ return typeof value === "number" && Number.isFinite(value) ? value : null;
153
+ })
154
+ });
155
+ return {
156
+ rows,
157
+ categoryField,
158
+ valueFields,
159
+ series,
160
+ categories
161
+ };
162
+ }
163
+ function dataTable(spec, options = {}) {
164
+ const rows = Array.isArray(spec?.data) ? spec.data : Array.isArray(spec?.data?.rows) ? spec.data.rows : null;
165
+ if (!rows?.length || !rows.every((row) => row && typeof row === "object" && !Array.isArray(row))) return null;
166
+ const keys = [...new Set(rows.flatMap((row) => Object.keys(row)))], ctx = makeContext({
167
+ ...options,
168
+ spec
169
+ });
170
+ const columns = keys.map((key) => {
171
+ const field = ctx.field(key), unit = field.unit || (field.format === "percent" ? "%" : ""), label = spec.fields?.[key]?.label;
172
+ const suffix = unit ? isEnglish(options.lang) ? ` (${unit})` : `(${unit})` : "";
173
+ return {
174
+ key,
175
+ label: label ? `${label}${suffix}` : key
176
+ };
177
+ });
178
+ return {
179
+ columns,
180
+ rows: rows.map((row) => columns.map(({ key }) => {
181
+ const value = row[key];
182
+ return {
183
+ text: value == null ? "—" : typeof value === "number" ? ctx.format(value, key) : typeof value === "object" ? JSON.stringify(value) : String(value),
184
+ value
185
+ };
186
+ }))
187
+ };
188
+ }
189
+ export { context_exports, dataTable, makeContext };
@@ -0,0 +1,442 @@
1
+ import { __exportAll } from "../_virtual/_rolldown/runtime.js";
2
+ import { register } from "./registry.js";
3
+ // src/chart/distribution.js
4
+ var distribution_exports = /* @__PURE__ */ __exportAll({ install: () => install });
5
+ var RIGHT = 24;
6
+ var PLOT_TOP = 48;
7
+ var PLOT_HEIGHT = 270;
8
+ var range = (ctx, values, field, zero = false) => ctx.ticks(values, field, {
9
+ zero,
10
+ count: 4
11
+ });
12
+ var field = (spec, role) => spec.encode[role];
13
+ var numericAnnotationValues = (spec, fields) => (spec.annotations || []).filter((item) => fields.has(item.field) && ["rule", "band"].includes(item.kind)).flatMap((item) => item.kind === "rule" ? [item.value] : [item.from, item.to]);
14
+ function chartFrame(spec, ctx, values, valueField, zero = false, valueFields = [valueField], { thin = false } = {}) {
15
+ const scale = range(ctx, [...values, ...numericAnnotationValues(spec, new Set(valueFields))], valueField, zero);
16
+ const axisWidth = Math.max(0, ...scale.labels.map((label) => ctx.measure(label, 12, 400)));
17
+ const categoryValues = ctx.table(spec).categories;
18
+ const categoryCount = Math.max(1, categoryValues.length);
19
+ const tokenWidth = Math.max(0, ...categoryValues.map((value) => Math.max(...String(value).trim().split(/\s+/).map((token) => ctx.measure(token, 12, 400)))));
20
+ const slotWidth = thin ? 28 : Math.max(28, Math.min(160, tokenWidth + 8));
21
+ const left = Math.max(40, Math.ceil(axisWidth + 18));
22
+ const width = Math.max(ctx.width, left + categoryCount * slotWidth + RIGHT);
23
+ const plot = {
24
+ x: left,
25
+ y: PLOT_TOP,
26
+ w: width - left - RIGHT,
27
+ h: PLOT_HEIGHT
28
+ };
29
+ if (plot.w < 100) ctx.fit("可用绘图区过窄", "增加图表宽度");
30
+ const y = ctx.linear(scale.min, scale.max, plot.y + plot.h, plot.y);
31
+ const children = [];
32
+ for (let i = 0; i < scale.ticks.length; i += 1) {
33
+ const yy = y(scale.ticks[i]);
34
+ children.push(ctx.line(plot.x, yy, plot.x + plot.w, yy, {
35
+ stroke: ctx.color("grid"),
36
+ "stroke-width": .7
37
+ }));
38
+ children.push(ctx.text(plot.x - 9, yy + 4, scale.labels[i], {
39
+ anchor: "end",
40
+ size: 12,
41
+ fill: ctx.color("muted")
42
+ }));
43
+ }
44
+ children.push(ctx.line(plot.x, plot.y, plot.x, plot.y + plot.h, {
45
+ stroke: ctx.color("axis"),
46
+ "stroke-width": .8
47
+ }));
48
+ children.push(ctx.line(plot.x, plot.y + plot.h, plot.x + plot.w, plot.y + plot.h, {
49
+ stroke: ctx.color("axis"),
50
+ "stroke-width": .8
51
+ }));
52
+ const meta = ctx.field(valueField), unit = meta.format === "percent" ? "" : String(meta.unit || "").trim();
53
+ if (unit) children.push(ctx.text(8, 18, unit, {
54
+ anchor: "start",
55
+ size: 12,
56
+ fill: ctx.color("muted"),
57
+ meta: {
58
+ kind: "axis-unit",
59
+ label: unit
60
+ }
61
+ }));
62
+ return {
63
+ plot,
64
+ scale,
65
+ y,
66
+ children,
67
+ width
68
+ };
69
+ }
70
+ function categories(spec, ctx, plot, children, { thin = false } = {}) {
71
+ const category = field(spec, "category");
72
+ const values = ctx.table(spec).categories;
73
+ const slot = plot.w / Math.max(1, values.length);
74
+ const positions = new Map(values.map((value, i) => [value, plot.x + slot * (i + .5)]));
75
+ const pieces = (value) => String(value).split(/(?<=[\s\-/])/).map((piece) => piece.trim()).filter(Boolean);
76
+ const thinned = thin && values.some((value) => pieces(value).some((piece) => ctx.measure(piece, 12, 400) > slot - 8));
77
+ const wrapped = values.map((value) => thinned ? [String(value)] : ctx.wrap(String(value), Math.max(24, slot - 8), 12, 400));
78
+ const shown = wrapped.map(() => true);
79
+ if (thinned) {
80
+ const widthOf = (index) => ctx.measure(wrapped[index][0], 12, 400);
81
+ const fits = (a, b) => positions.get(values[b]) - positions.get(values[a]) >= (widthOf(a) + widthOf(b)) / 2 + 8;
82
+ let previous = 0;
83
+ for (let i = 1; i < values.length; i += 1) {
84
+ shown[i] = fits(previous, i);
85
+ if (shown[i]) previous = i;
86
+ }
87
+ const last = values.length - 1;
88
+ if (last > 0 && !shown[last]) {
89
+ while (previous > 0 && !fits(previous, last)) {
90
+ shown[previous] = false;
91
+ do
92
+ previous -= 1;
93
+ while (previous > 0 && !shown[previous]);
94
+ }
95
+ shown[last] = fits(previous, last);
96
+ }
97
+ }
98
+ for (let i = 0; i < values.length; i += 1) {
99
+ if (!shown[i]) continue;
100
+ children.push(ctx.textLines(positions.get(values[i]), plot.y + plot.h + 20, wrapped[i], {
101
+ anchor: "middle",
102
+ size: 12,
103
+ fill: ctx.color("muted")
104
+ }));
105
+ }
106
+ const visibleLines = wrapped.filter((_, index) => shown[index]);
107
+ return {
108
+ values,
109
+ slot,
110
+ positions,
111
+ category,
112
+ maxLabelLines: Math.max(1, ...visibleLines.map((lines) => lines.length))
113
+ };
114
+ }
115
+ function annotations(spec, ctx, plot, y, children, roles) {
116
+ for (const item of spec.annotations || []) {
117
+ if (item.kind === "note") {
118
+ const idField = field(spec, "id");
119
+ const index = spec.data.findIndex((row) => row[idField] === item.record);
120
+ if (index < 0 || !roles.has(item.field)) continue;
121
+ const row = spec.data[index];
122
+ const x = plot.x + plot.w * ((ctx.table(spec).categories.indexOf(row[field(spec, "category")]) + .5) / Math.max(1, ctx.table(spec).categories.length));
123
+ const lines = ctx.wrap(item.text, Math.max(48, plot.x + plot.w - x - 12), 12, 400);
124
+ const note = {
125
+ size: 12,
126
+ fill: ctx.color("fg"),
127
+ meta: {
128
+ kind: "annotation-note",
129
+ record: index,
130
+ id: item.record,
131
+ field: item.field
132
+ }
133
+ };
134
+ if (lines.length === 1) children.push(ctx.text(x + 7, y(row[item.field]) - 7, lines[0], note));
135
+ else children.push(ctx.textLines(x + 7, y(row[item.field]) - 7 - (lines.length - 1) * 16, lines, note));
136
+ continue;
137
+ }
138
+ if (!roles.has(item.field)) continue;
139
+ if (item.kind === "band") {
140
+ const y1 = y(item.from), y2 = y(item.to);
141
+ children.push(ctx.rect(plot.x, Math.min(y1, y2), plot.w, Math.max(1, Math.abs(y2 - y1)), {
142
+ fill: ctx.color("tone3"),
143
+ "fill-opacity": .12
144
+ }));
145
+ } else if (item.kind === "rule") {
146
+ const yy = y(item.value);
147
+ children.push(ctx.line(plot.x, yy, plot.x + plot.w, yy, {
148
+ stroke: ctx.color("tone3"),
149
+ "stroke-width": 1,
150
+ "stroke-dasharray": "4 3"
151
+ }));
152
+ } else continue;
153
+ if (item.label) {
154
+ const lines = ctx.wrap(item.label, Math.max(48, Math.min(plot.w - 8, 220)), 12, 400);
155
+ const py = y(item.value ?? item.to) - 4 - (lines.length - 1) * 16;
156
+ children.push(ctx.textLines(plot.x + plot.w - 3, py, lines, {
157
+ anchor: "end",
158
+ size: 12,
159
+ fill: ctx.textColor("tone3")
160
+ }));
161
+ }
162
+ }
163
+ }
164
+ function finish(ctx, children, plot, cat, width, footer = []) {
165
+ let y = plot.y + plot.h + 40 + (cat.maxLabelLines - 1) * 16;
166
+ const readouts = [];
167
+ for (const item of footer) {
168
+ const lines = ctx.wrap(item.text, width - plot.x - RIGHT, 12, 400);
169
+ readouts.push(ctx.textLines(plot.x, y, lines, {
170
+ size: 12,
171
+ fill: ctx.color("muted"),
172
+ meta: item.meta
173
+ }));
174
+ y += lines.length * 16 + 3;
175
+ }
176
+ if (readouts.length) children.push(ctx.el("g", { opacity: .68 }, readouts));
177
+ return {
178
+ ...ctx.scene(Math.max(plot.y + plot.h + 48 + (cat.maxLabelLines - 1) * 16, y + (footer.length ? 8 : 0)), children),
179
+ width
180
+ };
181
+ }
182
+ function interval(spec, ctx) {
183
+ const low = field(spec, "low"), high = field(spec, "high"), estimate = field(spec, "value");
184
+ const nums = spec.data.flatMap((row) => [
185
+ row[low],
186
+ row[high],
187
+ estimate ? row[estimate] : null
188
+ ]);
189
+ const roles = /* @__PURE__ */ new Set([
190
+ low,
191
+ high,
192
+ estimate
193
+ ]);
194
+ const f = chartFrame(spec, ctx, nums, low, false, [...roles]);
195
+ const cat = categories(spec, ctx, f.plot, f.children);
196
+ annotations(spec, ctx, f.plot, f.y, f.children, roles);
197
+ const footer = [];
198
+ for (let i = 0; i < spec.data.length; i += 1) {
199
+ const row = spec.data[i], x = cat.positions.get(row[cat.category]);
200
+ if (x === void 0) continue;
201
+ const y1 = f.y(row[low]), y2 = f.y(row[high]);
202
+ const meta = {
203
+ kind: "interval",
204
+ record: i,
205
+ id: row[field(spec, "id")] ?? String(i),
206
+ value: [row[low], row[high]]
207
+ };
208
+ f.children.push(ctx.line(x, y1, x, y2, {
209
+ stroke: ctx.color("ink"),
210
+ "stroke-width": 1.2,
211
+ meta
212
+ }));
213
+ const cap = Math.min(8, cat.slot * .16);
214
+ f.children.push(ctx.line(x - cap, y1, x + cap, y1, {
215
+ stroke: ctx.color("ink"),
216
+ "stroke-width": 1.2
217
+ }));
218
+ f.children.push(ctx.line(x - cap, y2, x + cap, y2, {
219
+ stroke: ctx.color("ink"),
220
+ "stroke-width": 1.2
221
+ }));
222
+ if (estimate) f.children.push(ctx.circle(x, f.y(row[estimate]), 3.2, {
223
+ fill: ctx.color("accent"),
224
+ stroke: ctx.color("bg"),
225
+ "stroke-width": 1,
226
+ meta: {
227
+ kind: "estimate",
228
+ record: i,
229
+ id: meta.id,
230
+ value: row[estimate]
231
+ }
232
+ }));
233
+ footer.push({
234
+ text: `${String(row[cat.category])}: ${ctx.format(row[low], low)} – ${ctx.format(row[high], high)}${estimate ? ` · ${ctx.format(row[estimate], estimate)}` : ""}`,
235
+ meta: {
236
+ kind: "interval-readout",
237
+ record: i,
238
+ id: meta.id,
239
+ value: {
240
+ low: row[low],
241
+ high: row[high],
242
+ estimate: estimate ? row[estimate] : null
243
+ }
244
+ }
245
+ });
246
+ }
247
+ return finish(ctx, f.children, f.plot, cat, f.width, footer);
248
+ }
249
+ function candlestick(spec, ctx) {
250
+ const open = field(spec, "open"), close = field(spec, "close"), low = field(spec, "low"), high = field(spec, "high");
251
+ const values = spec.data.flatMap((row) => [
252
+ row[open],
253
+ row[close],
254
+ row[low],
255
+ row[high]
256
+ ]);
257
+ const fields = [
258
+ open,
259
+ close,
260
+ low,
261
+ high
262
+ ];
263
+ const f = chartFrame(spec, ctx, values, low, false, fields, { thin: true });
264
+ const cat = categories(spec, ctx, f.plot, f.children, { thin: true });
265
+ annotations(spec, ctx, f.plot, f.y, f.children, new Set(fields));
266
+ for (let i = 0; i < spec.data.length; i += 1) {
267
+ const row = spec.data[i], x = cat.positions.get(row[field(spec, "category")]);
268
+ if (x === void 0) continue;
269
+ const rising = row[close] >= row[open];
270
+ const top = f.y(Math.max(row[open], row[close]));
271
+ const bottom = f.y(Math.min(row[open], row[close]));
272
+ const bodyW = Math.max(3, Math.min(16, cat.slot * .46));
273
+ const id = row[field(spec, "id")] ?? String(i);
274
+ const meta = {
275
+ kind: "candlestick",
276
+ record: i,
277
+ id,
278
+ value: {
279
+ open: row[open],
280
+ close: row[close],
281
+ low: row[low],
282
+ high: row[high],
283
+ direction: rising ? "up" : "down"
284
+ }
285
+ };
286
+ f.children.push(ctx.line(x, f.y(row[high]), x, f.y(row[low]), {
287
+ stroke: ctx.color("ink"),
288
+ "stroke-width": 1,
289
+ meta: {
290
+ kind: "candle-wick",
291
+ record: i,
292
+ id
293
+ }
294
+ }));
295
+ if (row[open] === row[close]) f.children.push(ctx.line(x - bodyW / 2, top, x + bodyW / 2, top, {
296
+ stroke: ctx.color("ink"),
297
+ "stroke-width": 1.5,
298
+ meta
299
+ }));
300
+ else f.children.push(ctx.rect(x - bodyW / 2, top, bodyW, bottom - top, {
301
+ fill: rising ? ctx.color("bg") : ctx.color("ink"),
302
+ stroke: ctx.color("ink"),
303
+ "stroke-width": 1.1,
304
+ meta
305
+ }));
306
+ }
307
+ const directions = new Set(spec.data.map((row) => row[close] > row[open] ? "up" : row[close] < row[open] ? "down" : "flat"));
308
+ const english = /^en(?:-|$)/i.test(ctx.lang);
309
+ const legendItems = [
310
+ ...directions.has("up") ? [{
311
+ label: english ? "Rising · hollow" : "上涨 · 空心",
312
+ color: ctx.color("ink"),
313
+ mark: "hollow"
314
+ }] : [],
315
+ ...directions.has("down") ? [{
316
+ label: english ? "Falling · filled" : "下跌 · 实心",
317
+ color: ctx.color("ink"),
318
+ mark: "filled"
319
+ }] : [],
320
+ ...directions.has("flat") ? [{
321
+ label: english ? "Unchanged · line" : "持平 · 横线",
322
+ color: ctx.color("ink"),
323
+ mark: "line"
324
+ }] : []
325
+ ];
326
+ const legend = ctx.legend(legendItems, f.plot.w);
327
+ legend.children.forEach((group, i) => {
328
+ const swatch = group.children.find((child) => child.tag === "rect");
329
+ const { mark } = legendItems[i];
330
+ if (!swatch || mark === "filled") return;
331
+ if (mark === "hollow") Object.assign(swatch.attrs, {
332
+ fill: ctx.color("bg"),
333
+ stroke: ctx.color("ink"),
334
+ "stroke-width": 1.1
335
+ });
336
+ else group.children[group.children.indexOf(swatch)] = ctx.line(swatch.attrs.x, swatch.attrs.y + 5, swatch.attrs.x + 10, swatch.attrs.y + 5, {
337
+ stroke: ctx.color("ink"),
338
+ "stroke-width": 1.5
339
+ });
340
+ });
341
+ f.children.push(ctx.el("g", { transform: `translate(${f.plot.x},${f.plot.y - 20})` }, legend.children));
342
+ return finish(ctx, f.children, f.plot, cat, f.width);
343
+ }
344
+ function strip(spec, ctx) {
345
+ const value = field(spec, "value");
346
+ const f = chartFrame(spec, ctx, spec.data.map((row) => row[value]), value);
347
+ const cat = categories(spec, ctx, f.plot, f.children);
348
+ annotations(spec, ctx, f.plot, f.y, f.children, /* @__PURE__ */ new Set([value]));
349
+ const byCategory = /* @__PURE__ */ new Map();
350
+ spec.data.forEach((row, index) => {
351
+ const category = row[cat.category];
352
+ if (!byCategory.has(category)) byCategory.set(category, []);
353
+ byCategory.get(category).push({
354
+ row,
355
+ index,
356
+ y: f.y(row[value])
357
+ });
358
+ });
359
+ for (const [category, points] of byCategory) {
360
+ const center = cat.positions.get(category);
361
+ if (center === void 0) continue;
362
+ const placed = [], maxOffset = Math.max(0, cat.slot / 2 - 3);
363
+ points.sort((a, b) => a.y - b.y || a.index - b.index);
364
+ for (const point of points) {
365
+ const candidates = [0, ...Array.from({ length: Math.ceil(maxOffset / 6) }, (_, i) => (i + 1) * 6).flatMap((offset) => [-offset, offset])];
366
+ const safeOffset = candidates.find((candidate) => Math.abs(candidate) <= maxOffset && placed.every((other) => {
367
+ const dx = candidate - other.offset, dy = point.y - other.y;
368
+ return dx * dx + dy * dy >= 36;
369
+ })) ?? Math.max(-maxOffset, Math.min(maxOffset, candidates.at(-1)));
370
+ placed.push({
371
+ y: point.y,
372
+ offset: safeOffset
373
+ });
374
+ const id = point.row[field(spec, "id")] ?? String(point.index);
375
+ f.children.push(ctx.circle(center + safeOffset, point.y, 3, {
376
+ fill: ctx.color("ink"),
377
+ "fill-opacity": .78,
378
+ meta: {
379
+ kind: "strip",
380
+ record: point.index,
381
+ id,
382
+ value: point.row[value]
383
+ }
384
+ }));
385
+ }
386
+ }
387
+ return finish(ctx, f.children, f.plot, cat, f.width);
388
+ }
389
+ function violin(spec, ctx) {
390
+ const category = field(spec, "category"), density = field(spec, "density"), median = field(spec, "median");
391
+ const f = chartFrame(spec, ctx, spec.data.flatMap((row) => row[density].map((point) => point[0]).concat(row[median])), median);
392
+ const cat = categories(spec, ctx, f.plot, f.children);
393
+ const maxDensity = Math.max(...spec.data.flatMap((row) => row[density].map((point) => point[1])));
394
+ annotations(spec, ctx, f.plot, f.y, f.children, /* @__PURE__ */ new Set([median]));
395
+ for (let i = 0; i < spec.data.length; i += 1) {
396
+ const row = spec.data[i], x = cat.positions.get(row[category]);
397
+ if (x === void 0) continue;
398
+ const half = Math.min(28, cat.slot * .38);
399
+ const left = row[density].map(([v, d]) => `${x - half * d / maxDensity},${f.y(v)}`);
400
+ const right = [...row[density]].reverse().map(([v, d]) => `${x + half * d / maxDensity},${f.y(v)}`);
401
+ const id = row[field(spec, "id")] ?? String(i);
402
+ const shape = ctx.el("polygon", {
403
+ points: [...left, ...right].join(" "),
404
+ fill: ctx.color("bg"),
405
+ "fill-opacity": .72,
406
+ stroke: ctx.color("ink"),
407
+ "stroke-width": 1
408
+ });
409
+ shape.meta = {
410
+ kind: "violin",
411
+ record: i,
412
+ id
413
+ };
414
+ f.children.push(shape);
415
+ f.children.push(ctx.line(x - half * .48, f.y(row[median]), x + half * .48, f.y(row[median]), {
416
+ stroke: ctx.color("ink"),
417
+ "stroke-width": 1.6,
418
+ meta: {
419
+ kind: "median",
420
+ record: i,
421
+ id,
422
+ value: row[median]
423
+ }
424
+ }));
425
+ }
426
+ return finish(ctx, f.children, f.plot, cat, f.width);
427
+ }
428
+ function install({ register }) {
429
+ register([
430
+ "interval",
431
+ "candlestick",
432
+ "strip",
433
+ "violin"
434
+ ], (spec, ctx) => {
435
+ if (spec.chart === "interval") return interval(spec, ctx);
436
+ if (spec.chart === "candlestick") return candlestick(spec, ctx);
437
+ if (spec.chart === "strip") return strip(spec, ctx);
438
+ return violin(spec, ctx);
439
+ });
440
+ }
441
+ install({ register });
442
+ export { distribution_exports, install };
@@ -0,0 +1,67 @@
1
+ import { __exportAll } from "../_virtual/_rolldown/runtime.js";
2
+ import { formatValue, makeFormatters } from "../core/format.js";
3
+ // src/chart/fields.js
4
+ var fields_exports = /* @__PURE__ */ __exportAll({ fieldReader: () => fieldReader });
5
+ var valueRoles = [
6
+ "value",
7
+ "lower",
8
+ "upper",
9
+ "low",
10
+ "high",
11
+ "q1",
12
+ "median",
13
+ "q3",
14
+ "actual",
15
+ "target",
16
+ "before",
17
+ "after",
18
+ "delta",
19
+ "start",
20
+ "end"
21
+ ];
22
+ function fieldReader(spec = {}, lang) {
23
+ const encoding = spec.encode || {};
24
+ const formatter = makeFormatters(lang);
25
+ function rootUnitFor(name) {
26
+ if (!spec.unit || !name) return void 0;
27
+ if ([
28
+ "tree",
29
+ "mindmap",
30
+ "treemap",
31
+ "sunburst"
32
+ ].includes(spec.chart) && name === "value") return spec.unit;
33
+ if (spec.chart === "sankey" && name === "edge.value" || spec.chart === "threads" && name === "path.value") return spec.unit;
34
+ if (spec.chart === "histogram") return [encoding.lower, encoding.upper].includes(name) ? spec.unit : void 0;
35
+ if (spec.chart === "violin" && encoding.density === name) return `${spec.unit}⁻¹`;
36
+ if (valueRoles.some((role) => [encoding[role]].flat().includes(name))) return spec.unit;
37
+ }
38
+ function field(name) {
39
+ const meta = { ...spec.fields?.[name] || {} };
40
+ if (meta.unit == null) meta.unit = rootUnitFor(name);
41
+ return {
42
+ label: meta.label || name,
43
+ ...meta
44
+ };
45
+ }
46
+ function format(value, fieldName, withUnit = true) {
47
+ const meta = field(fieldName);
48
+ if (!Number.isFinite(value)) return "—";
49
+ if (meta.format === "percent") {
50
+ const decimals = meta.decimals ?? 1;
51
+ formatter.decimals = decimals;
52
+ return formatValue(value * 100, withUnit ? "%" : null, formatter, decimals);
53
+ }
54
+ const decimals = meta.decimals ?? naturalDecimals(value);
55
+ formatter.decimals = decimals;
56
+ return formatValue(value, withUnit ? meta.unit : null, formatter, meta.decimals ?? (decimals > 4 ? decimals : null));
57
+ }
58
+ return {
59
+ field,
60
+ format
61
+ };
62
+ }
63
+ function naturalDecimals(value) {
64
+ const [mantissa, exponent = "0"] = String(Number(Math.abs(value).toPrecision(12))).toLowerCase().split("e");
65
+ return Math.max(0, Math.min(6, (mantissa.split(".")[1]?.length || 0) - Number(exponent)));
66
+ }
67
+ export { fieldReader, fields_exports };