@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,561 @@
1
+ import { __exportAll } from "./_virtual/_rolldown/runtime.js";
2
+ import { fieldReader } from "./chart/fields.js";
3
+ // src/interaction.js
4
+ var interaction_exports = /* @__PURE__ */ __exportAll({ attach: () => attach });
5
+ var noop = () => {};
6
+ var getMeta = (el, key) => el?.getAttribute?.(`data-kc-${key}`) || "";
7
+ var all = (svg) => [svg, ...svg.querySelectorAll("*")];
8
+ var tokenList = (el) => {
9
+ try {
10
+ const value = JSON.parse(getMeta(el, "related") || "[]");
11
+ return Array.isArray(value) ? value.map(String) : [];
12
+ } catch {
13
+ return [];
14
+ }
15
+ };
16
+ var attach = (svg, spec = {}) => {
17
+ const actions = Array.isArray(spec.interaction) ? spec.interaction : [];
18
+ if (!actions.length) return noop;
19
+ if (!svg || typeof svg.addEventListener !== "function" || !svg.ownerDocument) throw new TypeError("KChart.attach requires an SVG element");
20
+ const doc = svg.ownerDocument, win = doc.defaultView;
21
+ const language = (doc.documentElement.lang || "").toLowerCase();
22
+ const chinese = language.startsWith("zh");
23
+ const { format } = fieldReader(spec, language || "zh");
24
+ const originalAttrs = new Map([
25
+ "viewBox",
26
+ "tabindex",
27
+ "role",
28
+ "aria-label"
29
+ ].map((name) => [name, svg.hasAttribute(name) ? svg.getAttribute(name) : null]));
30
+ const changed = /* @__PURE__ */ new Map(), listeners = [], controls = [], resetters = [];
31
+ const remember = (el, name) => {
32
+ if (!changed.has(el)) changed.set(el, /* @__PURE__ */ new Map());
33
+ const values = changed.get(el);
34
+ if (!values.has(name)) values.set(name, el.hasAttribute(name) ? el.getAttribute(name) : null);
35
+ };
36
+ const set = (el, name, value) => {
37
+ remember(el, name);
38
+ if (value == null) el.removeAttribute(name);
39
+ else el.setAttribute(name, value);
40
+ };
41
+ const restore = (el, name) => {
42
+ const values = changed.get(el);
43
+ if (!values?.has(name)) return;
44
+ const value = values.get(name);
45
+ if (value == null) el.removeAttribute(name);
46
+ else el.setAttribute(name, value);
47
+ values.delete(name);
48
+ if (!values.size) changed.delete(el);
49
+ };
50
+ const restoreAll = () => {
51
+ for (const [el, values] of changed) for (const [name, value] of values) if (value == null) el.removeAttribute(name);
52
+ else el.setAttribute(name, value);
53
+ changed.clear();
54
+ };
55
+ const listen = (el, name, fn, options) => {
56
+ el.addEventListener(name, fn, options);
57
+ listeners.push(() => el.removeEventListener(name, fn, options));
58
+ };
59
+ const stop = (event) => {
60
+ event.preventDefault();
61
+ event.stopPropagation();
62
+ };
63
+ const hit = (event) => event.target?.closest?.("[data-kc-kind], [data-kc-node], [data-kc-edge], [data-kc-path], [data-kc-record], [data-kc-series]");
64
+ const items = () => all(svg).filter((el) => el !== svg);
65
+ const identity = (el) => getMeta(el, "node") || getMeta(el, "path") || getMeta(el, "edge") || getMeta(el, "record") || getMeta(el, "series");
66
+ const hasAncestorIdentity = (el) => {
67
+ for (let parent = el.parentElement; parent && parent !== svg; parent = parent.parentElement) if (identity(parent)) return true;
68
+ return false;
69
+ };
70
+ const labelFor = (el) => getMeta(el, "label") || el.textContent?.trim() || getMeta(el, "record") || getMeta(el, "node") || getMeta(el, "path") || "";
71
+ let tooltip = null, readout = null, pinned = null, toolbar = null;
72
+ const showReadout = (text) => {
73
+ if (!readout) {
74
+ readout = doc.createElement("div");
75
+ readout.setAttribute("role", "status");
76
+ readout.style.cssText = "position:fixed;right:12px;bottom:12px;z-index:2147483646;padding:8px 12px;border-radius:6px;background:var(--viz-bg,var(--surface,Canvas));color:var(--viz-fg,currentColor);border:1px solid currentColor;font:12px/1.4 sans-serif";
77
+ doc.body.append(readout);
78
+ }
79
+ readout.textContent = text;
80
+ };
81
+ const describe = (el) => {
82
+ const label = labelFor(el), raw = getMeta(el, "value"), series = getMeta(el, "series");
83
+ let value = raw;
84
+ if (raw !== "" && Number.isFinite(Number(raw))) {
85
+ const chart = spec.chart;
86
+ let field = chart === "threads" ? "path.value" : chart === "tree" || chart === "mindmap" ? "value" : null;
87
+ if (chart === "network") field = getMeta(el, "edge") ? "edge.value" : "node.value";
88
+ if (chart === "sankey") field = "edge.value";
89
+ if (!field) {
90
+ const encoded = spec.encode?.value;
91
+ field = Array.isArray(encoded) ? encoded.find((name) => name === series) || encoded[0] : encoded;
92
+ const idField = spec.encode?.id;
93
+ if (idField && getMeta(el, "record")) {
94
+ const row = spec.data?.find?.((item) => String(item[idField]) === getMeta(el, "record"));
95
+ if (row && field) value = row[field];
96
+ }
97
+ }
98
+ if (field) value = format(value == null ? null : Number(value), field);
99
+ }
100
+ return [
101
+ label,
102
+ series && series !== label ? series : "",
103
+ raw !== "" ? `${chinese ? "值:" : "Value: "}${value}` : ""
104
+ ].filter(Boolean).join(" · ");
105
+ };
106
+ const showTip = (el, event) => {
107
+ const text = describe(el);
108
+ if (!text) return;
109
+ if (!tooltip) {
110
+ tooltip = doc.createElement("div");
111
+ tooltip.id = `kc-tip-${Math.random().toString(36).slice(2)}`;
112
+ tooltip.setAttribute("role", "tooltip");
113
+ tooltip.style.cssText = "position:fixed;z-index:2147483647;max-width:360px;padding:8px 10px;border-radius:6px;background:var(--viz-bg,var(--surface,Canvas));color:var(--viz-fg,currentColor);border:1px solid currentColor;font:12px/1.4 sans-serif;pointer-events:none";
114
+ doc.body.append(tooltip);
115
+ }
116
+ tooltip.textContent = text;
117
+ const x = event?.clientX ?? 8, y = event?.clientY ?? 8;
118
+ tooltip.style.left = `${Math.max(8, Math.min(x + 12, win.innerWidth - 380))}px`;
119
+ tooltip.style.top = `${Math.max(8, Math.min(y + 12, win.innerHeight - 80))}px`;
120
+ set(el, "aria-describedby", tooltip.id);
121
+ };
122
+ const hideTip = (el) => {
123
+ if (el) restore(el, "aria-describedby");
124
+ tooltip?.remove();
125
+ tooltip = null;
126
+ };
127
+ const targetsFor = (target) => {
128
+ const node = getMeta(target, "node"), path = getMeta(target, "path"), edge = getMeta(target, "edge");
129
+ const related = new Set(tokenList(target));
130
+ const threads = spec.chart === "threads" || getMeta(svg, "chart") === "threads";
131
+ const edges = spec.data?.edges || [];
132
+ const edgeForNodes = (el) => {
133
+ const source = getMeta(el, "source"), dest = getMeta(el, "target");
134
+ if (node && (source || dest)) return source === node || dest === node;
135
+ const edgeData = edges.find((item) => String(item.id ?? `${item.source}->${item.target}`) === getMeta(el, "edge"));
136
+ return !!(node && edgeData && (String(edgeData.source) === node || String(edgeData.target) === node));
137
+ };
138
+ return items().filter((el) => {
139
+ if (hasAncestorIdentity(el)) return false;
140
+ if (path) return getMeta(el, "path") === path;
141
+ if (node) return getMeta(el, "node") === node || edgeForNodes(el) || threads && getMeta(el, "path") && related.has(getMeta(el, "path"));
142
+ if (edge) return getMeta(el, "edge") === edge;
143
+ const record = getMeta(target, "record"), series = getMeta(target, "series");
144
+ if (record) return getMeta(el, "record") === record;
145
+ if (series) return getMeta(el, "series") === series;
146
+ return el === target;
147
+ });
148
+ };
149
+ const clearFocus = () => {
150
+ for (const el of items()) restore(el, "opacity");
151
+ readout?.remove();
152
+ readout = null;
153
+ };
154
+ const setFocus = (target) => {
155
+ const active = new Set(targetsFor(target));
156
+ for (const el of items()) {
157
+ if (!identity(el) || hasAncestorIdentity(el)) continue;
158
+ set(el, "opacity", active.has(el) ? "1" : ".18");
159
+ }
160
+ if (getMeta(svg, "chart") === "threads" || spec.chart === "threads") {
161
+ const paths = items().filter((el) => getMeta(el, "kind") === "path" || getMeta(el, "path"));
162
+ const selected = getMeta(target, "path") ? paths.filter((el) => getMeta(el, "path") === getMeta(target, "path")) : paths.filter((el) => tokenList(target).includes(getMeta(el, "path")) || tokenList(el).includes(getMeta(target, "node")));
163
+ const weight = selected.reduce((sum, el) => sum + (Number(getMeta(el, "value")) || 0), 0);
164
+ showReadout(chinese ? `路径 ${getMeta(target, "path") ? 1 : selected.length} 条${weight ? ` · 权重合计 ${weight}` : ""}` : `${getMeta(target, "path") ? 1 : selected.length} path(s)${weight ? ` · total weight ${weight}` : ""}`);
165
+ }
166
+ };
167
+ const clear = () => {
168
+ pinned = null;
169
+ clearFocus();
170
+ hideTip();
171
+ };
172
+ const togglePin = (el, event) => {
173
+ if (pinned === el) {
174
+ clear();
175
+ return;
176
+ }
177
+ pinned = el;
178
+ if (actions.includes("inspect")) showTip(el, event);
179
+ if (actions.includes("focus") && identity(el)) setFocus(el);
180
+ };
181
+ if (actions.some((name) => [
182
+ "inspect",
183
+ "focus",
184
+ "collapse",
185
+ "drag"
186
+ ].includes(name))) {
187
+ if (!svg.hasAttribute("tabindex")) set(svg, "tabindex", "0");
188
+ for (const el of items()) {
189
+ if (!hit({ target: el }) || hasAncestorIdentity(el)) continue;
190
+ if (!el.hasAttribute("tabindex")) set(el, "tabindex", "0");
191
+ if (!el.hasAttribute("role")) set(el, "role", "button");
192
+ const label = describe(el);
193
+ if (label && !el.hasAttribute("aria-label")) set(el, "aria-label", label);
194
+ }
195
+ }
196
+ if (actions.includes("inspect")) {
197
+ listen(svg, "pointerover", (event) => {
198
+ const el = hit(event);
199
+ if (el) showTip(el, event);
200
+ });
201
+ listen(svg, "pointerout", (event) => {
202
+ const el = hit(event);
203
+ if (el && pinned !== el && !el.contains(event.relatedTarget)) hideTip(el);
204
+ });
205
+ listen(svg, "focusin", (event) => {
206
+ const el = hit(event);
207
+ if (el) showTip(el, el.getBoundingClientRect());
208
+ });
209
+ listen(svg, "focusout", (event) => {
210
+ const el = hit(event);
211
+ if (el && pinned !== el) hideTip(el);
212
+ });
213
+ }
214
+ if (actions.includes("focus")) {
215
+ listen(svg, "pointerover", (event) => {
216
+ const el = hit(event);
217
+ if (!pinned && el && identity(el)) setFocus(el);
218
+ });
219
+ listen(svg, "pointerout", (event) => {
220
+ const el = hit(event);
221
+ if (!pinned && el && !el.contains(event.relatedTarget)) clearFocus();
222
+ });
223
+ listen(svg, "focusin", (event) => {
224
+ const el = hit(event);
225
+ if (!pinned && el && identity(el)) setFocus(el);
226
+ });
227
+ }
228
+ if (actions.includes("inspect") || actions.includes("focus")) {
229
+ listen(svg, "click", (event) => {
230
+ const el = hit(event);
231
+ if (el) togglePin(el, event);
232
+ else clear();
233
+ });
234
+ listen(svg, "keydown", (event) => {
235
+ const el = hit(event);
236
+ if ((event.key === "Enter" || event.key === " ") && el) {
237
+ stop(event);
238
+ togglePin(el, el.getBoundingClientRect());
239
+ }
240
+ });
241
+ }
242
+ const insideLegend = (el) => {
243
+ for (let parent = el.parentElement; parent && parent !== svg; parent = parent.parentElement) if (getMeta(parent, "kind") === "legend") return true;
244
+ return false;
245
+ };
246
+ if (actions.includes("legend") && !spec.stack) for (const item of items().filter((el) => getMeta(el, "kind") === "legend" && getMeta(el, "series"))) {
247
+ const series = getMeta(item, "series");
248
+ if (!item.hasAttribute("tabindex")) set(item, "tabindex", "0");
249
+ if (!item.hasAttribute("role")) set(item, "role", "button");
250
+ set(item, "aria-pressed", item.getAttribute("aria-pressed") || "false");
251
+ const toggle = () => {
252
+ const hidden = item.getAttribute("aria-pressed") === "true";
253
+ set(item, "aria-pressed", String(!hidden));
254
+ for (const el of items()) {
255
+ if (getMeta(el, "series") !== series || el === item || getMeta(el, "kind") === "legend" || insideLegend(el)) continue;
256
+ if (hidden) restore(el, "display");
257
+ else set(el, "display", "none");
258
+ }
259
+ };
260
+ listen(item, "click", toggle);
261
+ listen(item, "keydown", (event) => {
262
+ if (event.key === "Enter" || event.key === " ") {
263
+ stop(event);
264
+ toggle();
265
+ }
266
+ });
267
+ }
268
+ const initialViewBox = svg.getAttribute("viewBox") || `0 0 ${svg.viewBox.baseVal.width || Number(svg.getAttribute("width")) || 1} ${svg.viewBox.baseVal.height || Number(svg.getAttribute("height")) || 1}`;
269
+ let view = initialViewBox.trim().split(/[ ,]+/).map(Number), pan = null;
270
+ if (actions.includes("pan-zoom")) {
271
+ if (view.length !== 4 || view.some((n) => !Number.isFinite(n)) || view[2] <= 0 || view[3] <= 0) view = [
272
+ 0,
273
+ 0,
274
+ 1,
275
+ 1
276
+ ];
277
+ const writeView = () => svg.setAttribute("viewBox", view.join(" "));
278
+ const button = (label, delta) => {
279
+ const b = doc.createElement("button");
280
+ b.type = "button";
281
+ b.textContent = label;
282
+ b.setAttribute("aria-label", delta === 0 ? chinese ? "重置缩放" : "Reset zoom" : delta < 0 ? chinese ? "放大" : "Zoom in" : chinese ? "缩小" : "Zoom out");
283
+ b.style.cssText = "font:12px sans-serif;padding:3px 7px;margin:2px";
284
+ b.addEventListener("click", () => {
285
+ if (!delta) view = initialViewBox.trim().split(/[ ,]+/).map(Number);
286
+ else {
287
+ const factor = delta < 0 ? .8 : 1.25;
288
+ const cx = view[0] + view[2] / 2;
289
+ const cy = view[1] + view[3] / 2;
290
+ view[2] *= factor;
291
+ view[3] *= factor;
292
+ view[0] = cx - view[2] / 2;
293
+ view[1] = cy - view[3] / 2;
294
+ }
295
+ writeView();
296
+ });
297
+ controls.push(b);
298
+ return b;
299
+ };
300
+ toolbar = doc.createElement("div");
301
+ toolbar.setAttribute("aria-label", chinese ? "图表视图控制" : "Chart view controls");
302
+ toolbar.style.cssText = "position:fixed;right:4px;top:4px;z-index:2;display:flex";
303
+ toolbar.append(button("+", -1), button("−", 1), button("↺", 0));
304
+ doc.body.append(toolbar);
305
+ controls.push(toolbar);
306
+ listen(svg, "wheel", (e) => {
307
+ stop(e);
308
+ const factor = e.deltaY < 0 ? .9 : 1.1, r = svg.getBoundingClientRect();
309
+ if (!r.width || !r.height) return;
310
+ const x = view[0] + (e.clientX - r.left) / r.width * view[2], y = view[1] + (e.clientY - r.top) / r.height * view[3];
311
+ view[0] = x - (x - view[0]) * factor;
312
+ view[1] = y - (y - view[1]) * factor;
313
+ view[2] *= factor;
314
+ view[3] *= factor;
315
+ writeView();
316
+ }, { passive: false });
317
+ listen(svg, "pointerdown", (e) => {
318
+ if (e.target !== svg || e.button !== 0) return;
319
+ pan = {
320
+ x: e.clientX,
321
+ y: e.clientY,
322
+ view: [...view]
323
+ };
324
+ svg.setPointerCapture?.(e.pointerId);
325
+ });
326
+ listen(svg, "pointermove", (e) => {
327
+ if (!pan) return;
328
+ const r = svg.getBoundingClientRect();
329
+ if (!r.width || !r.height) return;
330
+ view[0] = pan.view[0] - (e.clientX - pan.x) / r.width * pan.view[2];
331
+ view[1] = pan.view[1] - (e.clientY - pan.y) / r.height * pan.view[3];
332
+ writeView();
333
+ });
334
+ listen(svg, "pointerup", () => {
335
+ pan = null;
336
+ });
337
+ listen(svg, "pointercancel", () => {
338
+ pan = null;
339
+ });
340
+ listen(svg, "keydown", (e) => {
341
+ if (e.key === "+" || e.key === "=") {
342
+ view[2] *= .8;
343
+ view[3] *= .8;
344
+ writeView();
345
+ } else if (e.key === "-") {
346
+ view[2] *= 1.25;
347
+ view[3] *= 1.25;
348
+ writeView();
349
+ }
350
+ });
351
+ }
352
+ if (actions.includes("collapse")) {
353
+ const collapsed = /* @__PURE__ */ new Set();
354
+ resetters.push(() => collapsed.clear());
355
+ const toggles = items().filter((el) => getMeta(el, "kind") === "node" && tokenList(el).length);
356
+ const descendants = (toggle) => {
357
+ const found = /* @__PURE__ */ new Set(), pending = [...tokenList(toggle)];
358
+ while (pending.length) {
359
+ const id = pending.pop();
360
+ if (found.has(id)) continue;
361
+ found.add(id);
362
+ const child = toggles.find((candidate) => getMeta(candidate, "node") === id);
363
+ if (child) for (const descendant of tokenList(child)) pending.push(descendant);
364
+ }
365
+ return found;
366
+ };
367
+ const labels = /* @__PURE__ */ new Map();
368
+ for (const label of items().filter((el) => getMeta(el, "kind") === "label" && getMeta(el, "node"))) {
369
+ const id = getMeta(label, "node");
370
+ if (!toggles.some((node) => getMeta(node, "node") === id)) continue;
371
+ if (!labels.has(id)) labels.set(id, []);
372
+ labels.get(id).push(label);
373
+ }
374
+ const applyCollapseVisibility = () => {
375
+ for (const el of items()) {
376
+ const nodeId = getMeta(el, "node"), pathId = getMeta(el, "path");
377
+ if ([...collapsed].some((id) => {
378
+ const toggle = toggles.find((candidate) => getMeta(candidate, "node") === id);
379
+ if (!toggle || nodeId === id) return false;
380
+ const subtree = descendants(toggle);
381
+ return subtree.has(nodeId) || subtree.has(pathId);
382
+ })) {
383
+ set(el, "display", "none");
384
+ set(el, "aria-hidden", "true");
385
+ if (doc.activeElement === el) svg.focus();
386
+ } else {
387
+ restore(el, "display");
388
+ restore(el, "aria-hidden");
389
+ }
390
+ }
391
+ };
392
+ const toggle = (node) => {
393
+ const id = getMeta(node, "node");
394
+ if (collapsed.has(id)) collapsed.delete(id);
395
+ else collapsed.add(id);
396
+ const expanded = String(!collapsed.has(id));
397
+ set(node, "aria-expanded", expanded);
398
+ for (const label of labels.get(id) || []) set(label, "aria-expanded", expanded);
399
+ applyCollapseVisibility();
400
+ };
401
+ listen(svg, "click", (e) => {
402
+ const target = e.target?.closest?.("[data-kc-node]");
403
+ const node = target && toggles.find((candidate) => getMeta(candidate, "node") === getMeta(target, "node"));
404
+ if (node) {
405
+ e.stopPropagation();
406
+ toggle(node);
407
+ }
408
+ });
409
+ for (const node of toggles) {
410
+ const id = getMeta(node, "node");
411
+ if (!node.hasAttribute("tabindex")) set(node, "tabindex", "0");
412
+ listen(node, "keydown", (e) => {
413
+ if (e.key === "Enter" || e.key === " ") {
414
+ stop(e);
415
+ toggle(node);
416
+ }
417
+ });
418
+ for (const label of labels.get(id) || []) listen(label, "keydown", (e) => {
419
+ if (e.key === "Enter" || e.key === " ") {
420
+ stop(e);
421
+ toggle(node);
422
+ }
423
+ });
424
+ }
425
+ }
426
+ const forceGeometry = actions.includes("drag") && spec.chart === "network" && spec.layout === "force" ? (() => {
427
+ const nodes = /* @__PURE__ */ new Map();
428
+ for (const el of items()) if (getMeta(el, "node")) {
429
+ const circle = el.matches("circle") ? el : el.querySelector("circle[cx][cy]");
430
+ if (!circle) continue;
431
+ const cx = Number(circle.getAttribute("cx")), cy = Number(circle.getAttribute("cy")), r = Number(circle.getAttribute("r")) || 0;
432
+ const center = svg.createSVGPoint();
433
+ center.x = cx;
434
+ center.y = cy;
435
+ const edge = svg.createSVGPoint();
436
+ edge.x = cx + r;
437
+ edge.y = cy;
438
+ const matrix = circle.getCTM();
439
+ const centerSvg = matrix ? center.matrixTransform(matrix) : center, edgeSvg = matrix ? edge.matrixTransform(matrix) : edge;
440
+ nodes.set(getMeta(el, "node"), {
441
+ el,
442
+ cx: centerSvg.x,
443
+ cy: centerSvg.y,
444
+ r: Math.hypot(edgeSvg.x - centerSvg.x, edgeSvg.y - centerSvg.y)
445
+ });
446
+ }
447
+ return {
448
+ nodes,
449
+ paths: items().filter((el) => getMeta(el, "source") && getMeta(el, "target") && el.hasAttribute("d")).map((el) => ({
450
+ el,
451
+ d: el.getAttribute("d"),
452
+ source: getMeta(el, "source"),
453
+ target: getMeta(el, "target")
454
+ }))
455
+ };
456
+ })() : null;
457
+ const pointInSvg = (event) => {
458
+ const point = svg.createSVGPoint();
459
+ point.x = event.clientX;
460
+ point.y = event.clientY;
461
+ return point.matrixTransform(svg.getScreenCTM().inverse());
462
+ };
463
+ if (actions.includes("drag")) {
464
+ let drag = null;
465
+ listen(svg, "pointerdown", (e) => {
466
+ let el = e.target?.closest?.("[data-kc-node]");
467
+ if (!el || !getMeta(el, "node") || spec.chart !== "network" || spec.layout !== "force") return;
468
+ const nodeId = getMeta(el, "node");
469
+ for (let parent = el.parentElement; parent && parent !== svg; parent = parent.parentElement) if (getMeta(parent, "node") === nodeId) el = parent;
470
+ const point = pointInSvg(e);
471
+ drag = {
472
+ el,
473
+ x: point.x,
474
+ y: point.y,
475
+ transform: el.getAttribute("transform") || ""
476
+ };
477
+ try {
478
+ el.setPointerCapture?.(e.pointerId);
479
+ } catch {}
480
+ stop(e);
481
+ });
482
+ listen(svg, "pointermove", (e) => {
483
+ if (!drag) return;
484
+ const point = pointInSvg(e), dx = point.x - drag.x, dy = point.y - drag.y;
485
+ set(drag.el, "transform", `${drag.transform} translate(${dx} ${dy})`.trim());
486
+ if (!forceGeometry) return;
487
+ const id = getMeta(drag.el, "node");
488
+ for (const path of forceGeometry.paths) {
489
+ const source = forceGeometry.nodes.get(path.source), target = forceGeometry.nodes.get(path.target);
490
+ if (!source || !target || path.source !== id && path.target !== id) continue;
491
+ const sx = path.source === id ? dx : 0, sy = path.source === id ? dy : 0, tx = path.target === id ? dx : 0, ty = path.target === id ? dy : 0;
492
+ const d = path.d;
493
+ const n = "[-+]?(?:\\d*\\.)?\\d+(?:[eE][-+]?\\d+)?";
494
+ const q = d.match(new RegExp(`^\\s*M\\s*(${n})[ ,]+(${n})\\s*Q\\s*(${n})[ ,]+(${n})[ ,]+(${n})[ ,]+(${n})\\s*$`, "i"));
495
+ const line = d.match(new RegExp(`^\\s*M\\s*(${n})[ ,]+(${n})\\s*L\\s*(${n})[ ,]+(${n})\\s*$`, "i"));
496
+ const atCircle = (x, y, node) => node.r > 0 && Math.abs(Math.hypot(x - node.cx, y - node.cy) - node.r) < Math.max(1, node.r * .2);
497
+ const sxCenter = source.cx + sx, syCenter = source.cy + sy, txCenter = target.cx + tx, tyCenter = target.cy + ty;
498
+ const angle = Math.atan2(tyCenter - syCenter, txCenter - sxCenter);
499
+ const endpoint = (x, y, node, offsetX, offsetY, centerX, centerY, direction) => atCircle(x, y, node) ? [centerX + direction * Math.cos(angle) * node.r, centerY + direction * Math.sin(angle) * node.r] : [x + offsetX, y + offsetY];
500
+ if (q) {
501
+ const start = endpoint(Number(q[1]), Number(q[2]), source, sx, sy, sxCenter, syCenter, 1);
502
+ const end = endpoint(Number(q[5]), Number(q[6]), target, tx, ty, txCenter, tyCenter, -1);
503
+ set(path.el, "d", `M ${start[0]} ${start[1]} Q ${Number(q[3]) + (sx + tx) / 2} ${Number(q[4]) + (sy + ty) / 2} ${end[0]} ${end[1]}`);
504
+ } else if (line) {
505
+ const start = endpoint(Number(line[1]), Number(line[2]), source, sx, sy, sxCenter, syCenter, 1);
506
+ const end = endpoint(Number(line[3]), Number(line[4]), target, tx, ty, txCenter, tyCenter, -1);
507
+ set(path.el, "d", `M ${start[0]} ${start[1]} L ${end[0]} ${end[1]}`);
508
+ }
509
+ }
510
+ });
511
+ resetters.push(() => {
512
+ drag = null;
513
+ });
514
+ listen(svg, "pointerup", () => {
515
+ drag = null;
516
+ });
517
+ listen(svg, "pointercancel", () => {
518
+ drag = null;
519
+ });
520
+ }
521
+ const reset = () => {
522
+ clear();
523
+ for (const resetter of resetters) resetter();
524
+ pan = null;
525
+ restoreAll();
526
+ if (actions.includes("pan-zoom")) {
527
+ view = initialViewBox.trim().split(/[ ,]+/).map(Number);
528
+ const originalViewBox = originalAttrs.get("viewBox");
529
+ if (originalViewBox == null) svg.removeAttribute("viewBox");
530
+ else svg.setAttribute("viewBox", originalViewBox);
531
+ }
532
+ };
533
+ if (actions.length) {
534
+ listen(win, "beforeprint", () => {
535
+ reset();
536
+ if (toolbar) toolbar.hidden = true;
537
+ });
538
+ listen(win, "afterprint", () => {
539
+ if (toolbar) toolbar.hidden = false;
540
+ });
541
+ }
542
+ listen(svg, "keydown", (e) => {
543
+ if (e.key === "Escape") clear();
544
+ });
545
+ listen(svg, "click", (e) => {
546
+ if (e.target === svg) clear();
547
+ });
548
+ let cleaned = false;
549
+ return () => {
550
+ if (cleaned) return;
551
+ cleaned = true;
552
+ for (const remove of listeners.splice(0)) remove();
553
+ clear();
554
+ hideTip();
555
+ controls.forEach((el) => el.remove());
556
+ restoreAll();
557
+ for (const [name, value] of originalAttrs) if (value == null) svg.removeAttribute(name);
558
+ else svg.setAttribute(name, value);
559
+ };
560
+ };
561
+ export { attach, interaction_exports };
@@ -0,0 +1,28 @@
1
+ import type { DiagramDiagnostic, RenderOptions } from './index.js';
2
+
3
+ /**
4
+ * KChart render options, plus Mermaid settings. A Mermaid setting is checked like a `config` in the diagram's front
5
+ * matter, which overrides it: supported settings such as `c4.c4ShapeInRow` apply, runtime settings such as
6
+ * `startOnLoad` pass silently, and the rest, such as `themeVariables` or the theme name `dark`, produce one
7
+ * `IGNORED_CONFIG` warning.
8
+ */
9
+ export type MermaidOptions = Omit<RenderOptions, 'assets'> & { [setting: string]: unknown };
10
+ export interface MermaidError extends Error { diagnostics: DiagramDiagnostic[] }
11
+ /** `diagnostics` holds only warnings: any error rejects instead. */
12
+ export interface MermaidParseResult { diagramType: string; diagnostics: DiagramDiagnostic[] }
13
+ export interface MermaidRenderResult extends MermaidParseResult { svg: string }
14
+
15
+ export function initialize(config?: MermaidOptions): void;
16
+ export function render(id: string, text: string, options?: MermaidOptions): Promise<MermaidRenderResult>;
17
+ export function parse(text: string, options?: { suppressErrors?: false }): Promise<MermaidParseResult>;
18
+ export function parse(text: string, options: { suppressErrors?: boolean }): Promise<MermaidParseResult | false>;
19
+ export function detectType(text: string): string;
20
+
21
+ /** The same four functions, for `import mermaid from '@fengwk/kchart/mermaid'`. */
22
+ declare const mermaid: {
23
+ initialize: typeof initialize;
24
+ render: typeof render;
25
+ parse: typeof parse;
26
+ detectType: typeof detectType;
27
+ };
28
+ export default mermaid;
@@ -0,0 +1,70 @@
1
+ import { themes } from "./core/theme.js";
2
+ import { check, diagram, diagramTypes } from "./index.js";
3
+ import { prepareSource, siteConfig } from "./diagram/source.js";
4
+ // mermaid.js
5
+ var config = {};
6
+ var RENDER_OPTIONS = /* @__PURE__ */ new Set([
7
+ "width",
8
+ "lang",
9
+ "media",
10
+ "frame",
11
+ "prefix",
12
+ "measure"
13
+ ]);
14
+ function optionsOf(settings) {
15
+ const options = { syntax: "mermaid" }, site = {};
16
+ for (const [key, value] of Object.entries(settings)) {
17
+ const kchartTheme = key === "theme" && (typeof value !== "string" || Object.hasOwn(themes, value));
18
+ if (RENDER_OPTIONS.has(key) || kchartTheme) options[key] = value;
19
+ else site[key] = value;
20
+ }
21
+ return {
22
+ ...options,
23
+ [siteConfig]: site
24
+ };
25
+ }
26
+ function initialize(options = {}) {
27
+ config = { ...options };
28
+ }
29
+ function detectType(text) {
30
+ const { kind } = prepareSource(text, { syntax: "mermaid" });
31
+ const key = kind.toLowerCase();
32
+ const type = diagramTypes.find(({ kind, aliases, syntax }) => syntax === "mermaid" && [kind, ...aliases].some((name) => name.toLowerCase() === key));
33
+ if (!type) throw new Error(`Unknown Mermaid diagram type: ${kind}`);
34
+ return type.kind;
35
+ }
36
+ var isError = (item) => item.severity !== "warning";
37
+ function invalid(diagnostics) {
38
+ return Object.assign(new Error(diagnostics.find(isError)?.message ?? "Mermaid diagram could not be rendered"), { diagnostics });
39
+ }
40
+ async function render(id, text, options = {}) {
41
+ const { svg, diagnostics } = await diagram(text, optionsOf({
42
+ ...config,
43
+ prefix: id,
44
+ ...options
45
+ }));
46
+ if (svg === null) throw invalid(diagnostics);
47
+ return {
48
+ svg,
49
+ diagramType: detectType(text),
50
+ diagnostics
51
+ };
52
+ }
53
+ async function parse(text, { suppressErrors = false } = {}) {
54
+ const diagnostics = await check(text, optionsOf(config));
55
+ if (diagnostics.some(isError)) {
56
+ if (suppressErrors) return false;
57
+ throw invalid(diagnostics);
58
+ }
59
+ return {
60
+ diagramType: detectType(text),
61
+ diagnostics
62
+ };
63
+ }
64
+ var mermaid_default = {
65
+ initialize,
66
+ render,
67
+ parse,
68
+ detectType
69
+ };
70
+ export { mermaid_default as default, detectType, initialize, parse, render };