agentic-mermaid 0.1.1 → 0.1.2

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 (336) hide show
  1. package/CHANGELOG.md +144 -4
  2. package/LICENSES/Apache-2.0.txt +202 -0
  3. package/README.md +25 -32
  4. package/THIRD_PARTY_NOTICES.md +29 -0
  5. package/dist/agent-core.d.ts +463 -0
  6. package/dist/agent-core.js +397 -0
  7. package/dist/agent.d.ts +73 -1868
  8. package/dist/agent.js +336 -37325
  9. package/dist/agentic-mermaid-mcp.js +7 -38399
  10. package/dist/am.js +33632 -40445
  11. package/dist/chunk-4QECACIA.js +4702 -0
  12. package/dist/chunk-CDPKJ2BQ.js +37 -0
  13. package/dist/chunk-QKDLMOJJ.js +3487 -0
  14. package/dist/chunk-WI35L7IR.js +615 -0
  15. package/dist/chunk-WN3YDOBG.js +149 -0
  16. package/dist/chunk-ZYMMKQ3I.js +62637 -0
  17. package/dist/index-D54dqSdC.d.ts +6777 -0
  18. package/dist/index.d.ts +1 -1
  19. package/dist/index.js +310 -33014
  20. package/dist/mcp-cli-SBQSTJFC.js +17 -0
  21. package/docs/README.md +14 -6
  22. package/docs/schemas/style-spec.schema.json +1221 -30
  23. package/examples/styles/catalog.json +54 -0
  24. package/examples/styles/cloudflare-workers-inspired-prototype.mmd +9 -0
  25. package/examples/styles/cloudflare-workers-inspired-prototype.style.json +110 -0
  26. package/examples/styles/cupertino-prototype.mmd +10 -0
  27. package/examples/styles/cupertino-prototype.style.json +63 -0
  28. package/examples/styles/mid-century-report.style.json +2 -2
  29. package/examples/styles/star-chart-atlas.style.json +2 -1
  30. package/examples/styles/transit-route-map.style.json +2 -2
  31. package/examples/styles/vercel-inspired-prototype.mmd +6 -0
  32. package/examples/styles/vercel-inspired-prototype.style.json +87 -0
  33. package/package.json +68 -43
  34. package/server.json +2 -2
  35. package/skills/agentic-mermaid-diagram-workflow/SKILL.md +17 -36
  36. package/skills/agentic-mermaid-diagram-workflow/references/cli.md +4 -5
  37. package/skills/agentic-mermaid-diagram-workflow/references/code-mode.md +15 -31
  38. package/skills/agentic-mermaid-diagram-workflow/references/sequence.md +10 -14
  39. package/skills/agentic-mermaid-live-editor/SKILL.md +100 -206
  40. package/AGENT_NATIVE.md +0 -607
  41. package/Instructions_for_agents.md +0 -89
  42. package/TODO.md +0 -684
  43. package/assets/hero.png +0 -0
  44. package/dist/index-wjRjbsP-.d.ts +0 -1102
  45. package/docs/agent-api-cookbook.md +0 -308
  46. package/docs/agent-mutation-policy.md +0 -104
  47. package/docs/agent-workflow-examples.md +0 -46
  48. package/docs/api.md +0 -211
  49. package/docs/ascii.md +0 -103
  50. package/docs/assets/improvements/box-start-connector.png +0 -0
  51. package/docs/assets/improvements/comment-dropped-lint.png +0 -0
  52. package/docs/assets/improvements/er-content-loss.png +0 -0
  53. package/docs/assets/improvements/fan-in-trunks.png +0 -0
  54. package/docs/assets/improvements/gantt-family.png +0 -0
  55. package/docs/assets/improvements/gantt-milestone-clamp.png +0 -0
  56. package/docs/assets/improvements/gantt-verify-seam.png +0 -0
  57. package/docs/assets/improvements/subgraph-container-edges.png +0 -0
  58. package/docs/assets/improvements/wrapper-frontmatter.png +0 -0
  59. package/docs/assets/improvements/wrapper-init-directive.png +0 -0
  60. package/docs/assets/improvements/wrapper-leading-comment.png +0 -0
  61. package/docs/assets/style-cookbook/mid-century-report.png +0 -0
  62. package/docs/assets/style-cookbook/star-chart-atlas.png +0 -0
  63. package/docs/assets/style-cookbook/transit-route-map.png +0 -0
  64. package/docs/comparison.md +0 -94
  65. package/docs/config.md +0 -105
  66. package/docs/contributing/adding-diagram-types.md +0 -144
  67. package/docs/contributing/diagram-family-citizenship.matrix.json +0 -2127
  68. package/docs/contributing/diagram-family-citizenship.md +0 -82
  69. package/docs/contributing/harvesting-upstream-tests.md +0 -126
  70. package/docs/contributing/lessons-learned.md +0 -276
  71. package/docs/contributing/releasing.md +0 -82
  72. package/docs/contributing/visual-review-evidence.md +0 -53
  73. package/docs/custom-style-cookbook.md +0 -154
  74. package/docs/design/families/README.md +0 -26
  75. package/docs/design/families/architecture-beta.md +0 -48
  76. package/docs/design/families/flowchart-parser-conformance.md +0 -22
  77. package/docs/design/families/gantt-research.md +0 -137
  78. package/docs/design/families/gantt.md +0 -329
  79. package/docs/design/families/journey-agentic-cards-before.png +0 -0
  80. package/docs/design/families/journey-experience-curve-implementation.png +0 -0
  81. package/docs/design/families/journey-mermaid-classic-implementation.png +0 -0
  82. package/docs/design/families/journey-mermaid-classic-prototype.png +0 -0
  83. package/docs/design/families/journey-mermaid-classic-prototype.svg +0 -163
  84. package/docs/design/families/journey-mermaid-classic-prototype.svg.png +0 -0
  85. package/docs/design/families/journey-migration-parity.md +0 -439
  86. package/docs/design/families/journey-section-overlap-after.png +0 -0
  87. package/docs/design/families/journey-section-overlap-before.png +0 -0
  88. package/docs/design/families/journey-usage-research.md +0 -423
  89. package/docs/design/families/journey.md +0 -153
  90. package/docs/design/families/xychart.md +0 -85
  91. package/docs/design/system/README.md +0 -45
  92. package/docs/design/system/abstraction-audit.md +0 -224
  93. package/docs/design/system/abstraction-recommendations.md +0 -655
  94. package/docs/design/system/architecture.mmd +0 -29
  95. package/docs/design/system/architecture.svg +0 -137
  96. package/docs/design/system/layout-guarantees-and-robustness.md +0 -351
  97. package/docs/design/system/layout-rubric.md +0 -138
  98. package/docs/design/system/route-contracts.md +0 -848
  99. package/docs/design/system/source-preservation-ladder.md +0 -52
  100. package/docs/design/system/styles-rollout.md +0 -216
  101. package/docs/design/system/ugly-layouts.md +0 -119
  102. package/docs/diagram-families.md +0 -193
  103. package/docs/features.md +0 -147
  104. package/docs/fork-differences.md +0 -130
  105. package/docs/getting-started.md +0 -175
  106. package/docs/issue-derived-test-cases.md +0 -156
  107. package/docs/layout-characterization/README.md +0 -245
  108. package/docs/layout-characterization/contact-sheet-families.md +0 -498
  109. package/docs/layout-characterization/contact-sheet.md +0 -638
  110. package/docs/layout-characterization/properties.md +0 -281
  111. package/docs/layout-characterization/visual-quality.md +0 -160
  112. package/docs/layout-characterization/visual-snapshots/architecture.svg +0 -79
  113. package/docs/layout-characterization/visual-snapshots/class.svg +0 -60
  114. package/docs/layout-characterization/visual-snapshots/er.svg +0 -61
  115. package/docs/layout-characterization/visual-snapshots/flowchart.svg +0 -58
  116. package/docs/layout-characterization/visual-snapshots/gantt.svg +0 -52
  117. package/docs/layout-characterization/visual-snapshots/journey.svg +0 -98
  118. package/docs/layout-characterization/visual-snapshots/pie.svg +0 -36
  119. package/docs/layout-characterization/visual-snapshots/quadrant.svg +0 -47
  120. package/docs/layout-characterization/visual-snapshots/sequence.svg +0 -59
  121. package/docs/layout-characterization/visual-snapshots/state.svg +0 -52
  122. package/docs/layout-characterization/visual-snapshots/timeline.svg +0 -64
  123. package/docs/layout-characterization/visual-snapshots/xychart.svg +0 -97
  124. package/docs/mcp-code-mode-rationale.md +0 -101
  125. package/docs/mcp-http-transport.md +0 -223
  126. package/docs/mermaid-layout-complaints.md +0 -837
  127. package/docs/mutation-testing.md +0 -206
  128. package/docs/project/divergences.md +0 -98
  129. package/docs/project/dogfooding-docs-strategy.md +0 -66
  130. package/docs/project/hosted-mcp-cloudflare-plan.md +0 -338
  131. package/docs/project/lessons-learned.md +0 -1019
  132. package/docs/project/remove-role-styling-plan.md +0 -176
  133. package/docs/quality.md +0 -215
  134. package/docs/react.md +0 -97
  135. package/docs/style-authoring.md +0 -133
  136. package/docs/testing-strategy.md +0 -335
  137. package/docs/theming.md +0 -162
  138. package/examples/agent-improve-auth-flow.ts +0 -206
  139. package/examples/agent-loop.ts +0 -53
  140. package/examples/mcp-vs-cli-complex-diagrams.ts +0 -133
  141. package/llms.txt +0 -104
  142. package/skill-evals/README.md +0 -77
  143. package/skill-evals/fixtures/architecture-cache/input.mmd +0 -5
  144. package/skill-evals/fixtures/class-payment/input.mmd +0 -4
  145. package/skill-evals/fixtures/er-orders/input.mmd +0 -10
  146. package/skill-evals/fixtures/flowchart-cache/input.mmd +0 -3
  147. package/skill-evals/fixtures/gantt-release/input.mmd +0 -7
  148. package/skill-evals/fixtures/journey-checkout/input.mmd +0 -6
  149. package/skill-evals/fixtures/pie-exports/input.mmd +0 -5
  150. package/skill-evals/fixtures/quadrant-priorities/input.mmd +0 -11
  151. package/skill-evals/fixtures/sequence-retry/input.mmd +0 -8
  152. package/skill-evals/fixtures/state-lifecycle/input.mmd +0 -5
  153. package/skill-evals/fixtures/timeline-release/input.mmd +0 -6
  154. package/skill-evals/fixtures/xychart-growth/input.mmd +0 -5
  155. package/skill-evals/shared-benchmark.json +0 -510
  156. package/src/agent/analyze.ts +0 -157
  157. package/src/agent/apply.ts +0 -146
  158. package/src/agent/architecture-body.ts +0 -458
  159. package/src/agent/certificates.ts +0 -110
  160. package/src/agent/class-body.ts +0 -319
  161. package/src/agent/core.ts +0 -207
  162. package/src/agent/create.ts +0 -106
  163. package/src/agent/describe.ts +0 -368
  164. package/src/agent/er-body.ts +0 -224
  165. package/src/agent/facts.ts +0 -360
  166. package/src/agent/families-builtin.ts +0 -920
  167. package/src/agent/families.ts +0 -232
  168. package/src/agent/family-layouts.ts +0 -832
  169. package/src/agent/flowchart-body.ts +0 -372
  170. package/src/agent/flowchart-unsupported.ts +0 -243
  171. package/src/agent/font-coverage.ts +0 -288
  172. package/src/agent/gantt-body.ts +0 -495
  173. package/src/agent/index.ts +0 -10
  174. package/src/agent/journey-body.ts +0 -374
  175. package/src/agent/label-metrics.ts +0 -28
  176. package/src/agent/layout-to-rendered.ts +0 -63
  177. package/src/agent/mutate.ts +0 -97
  178. package/src/agent/mutation-ops.ts +0 -51
  179. package/src/agent/op-schema.ts +0 -443
  180. package/src/agent/parse.ts +0 -223
  181. package/src/agent/pie-body.ts +0 -270
  182. package/src/agent/png.ts +0 -171
  183. package/src/agent/quadrant-body.ts +0 -336
  184. package/src/agent/quality.ts +0 -363
  185. package/src/agent/readability-audit.ts +0 -92
  186. package/src/agent/rendered-route-audit.ts +0 -61
  187. package/src/agent/sequence-body.ts +0 -345
  188. package/src/agent/serialize.ts +0 -214
  189. package/src/agent/state-body.ts +0 -589
  190. package/src/agent/structural-count.ts +0 -150
  191. package/src/agent/timeline-body.ts +0 -280
  192. package/src/agent/trace-log.ts +0 -43
  193. package/src/agent/types.ts +0 -995
  194. package/src/agent/verify.ts +0 -603
  195. package/src/agent/xychart-body.ts +0 -472
  196. package/src/architecture/config.ts +0 -282
  197. package/src/architecture/layout.ts +0 -496
  198. package/src/architecture/parser.ts +0 -375
  199. package/src/architecture/renderer.ts +0 -611
  200. package/src/architecture/types.ts +0 -113
  201. package/src/ascii/ansi.ts +0 -423
  202. package/src/ascii/architecture.ts +0 -210
  203. package/src/ascii/canvas.ts +0 -443
  204. package/src/ascii/class-diagram.ts +0 -697
  205. package/src/ascii/converter.ts +0 -475
  206. package/src/ascii/draw.ts +0 -1693
  207. package/src/ascii/edge-bundling.ts +0 -328
  208. package/src/ascii/edge-routing.ts +0 -330
  209. package/src/ascii/er-diagram.ts +0 -439
  210. package/src/ascii/gantt.ts +0 -276
  211. package/src/ascii/grid.ts +0 -747
  212. package/src/ascii/index.ts +0 -196
  213. package/src/ascii/journey.ts +0 -169
  214. package/src/ascii/meta.ts +0 -244
  215. package/src/ascii/multiline-utils.ts +0 -80
  216. package/src/ascii/pathfinder.ts +0 -301
  217. package/src/ascii/pie.ts +0 -67
  218. package/src/ascii/quadrant.ts +0 -158
  219. package/src/ascii/reverse.ts +0 -216
  220. package/src/ascii/sequence.ts +0 -499
  221. package/src/ascii/shapes/circle.ts +0 -27
  222. package/src/ascii/shapes/corners.ts +0 -143
  223. package/src/ascii/shapes/diamond.ts +0 -27
  224. package/src/ascii/shapes/hexagon.ts +0 -27
  225. package/src/ascii/shapes/index.ts +0 -106
  226. package/src/ascii/shapes/rectangle.ts +0 -168
  227. package/src/ascii/shapes/rounded.ts +0 -27
  228. package/src/ascii/shapes/special.ts +0 -332
  229. package/src/ascii/shapes/stadium.ts +0 -110
  230. package/src/ascii/shapes/state.ts +0 -192
  231. package/src/ascii/shapes/types.ts +0 -73
  232. package/src/ascii/timeline.ts +0 -141
  233. package/src/ascii/types.ts +0 -312
  234. package/src/ascii/validate.ts +0 -120
  235. package/src/ascii/width.ts +0 -81
  236. package/src/ascii/wrap.ts +0 -131
  237. package/src/ascii/xychart.ts +0 -919
  238. package/src/browser.ts +0 -29
  239. package/src/class/layout.ts +0 -240
  240. package/src/class/parser.ts +0 -332
  241. package/src/class/renderer.ts +0 -638
  242. package/src/class/types.ts +0 -129
  243. package/src/cli/agent-instructions.ts +0 -1
  244. package/src/cli/am-bin.ts +0 -6
  245. package/src/cli/exit-codes.ts +0 -18
  246. package/src/cli/index.ts +0 -1132
  247. package/src/cli/init-agent.ts +0 -147
  248. package/src/cli/run-entrypoint.ts +0 -10
  249. package/src/color-resolver.ts +0 -152
  250. package/src/elk-instance.ts +0 -114
  251. package/src/er/layout.ts +0 -187
  252. package/src/er/parser.ts +0 -226
  253. package/src/er/renderer.ts +0 -792
  254. package/src/er/types.ts +0 -99
  255. package/src/family-rubric.ts +0 -425
  256. package/src/font-manifest.ts +0 -31
  257. package/src/gantt/layout.ts +0 -365
  258. package/src/gantt/parser.ts +0 -282
  259. package/src/gantt/pipeline.ts +0 -27
  260. package/src/gantt/renderer.ts +0 -414
  261. package/src/gantt/schedule.ts +0 -513
  262. package/src/gantt/types.ts +0 -255
  263. package/src/index.ts +0 -368
  264. package/src/journey/layout.ts +0 -554
  265. package/src/journey/parse-core.ts +0 -251
  266. package/src/journey/parser.ts +0 -101
  267. package/src/journey/renderer.ts +0 -917
  268. package/src/journey/types.ts +0 -144
  269. package/src/layout/geometry.ts +0 -182
  270. package/src/layout/pass.ts +0 -142
  271. package/src/layout/passes/index.ts +0 -3916
  272. package/src/layout-engine.ts +0 -1565
  273. package/src/layout-rubric.ts +0 -659
  274. package/src/mcp/artifacts.ts +0 -137
  275. package/src/mcp/dynamic-harness.ts +0 -31
  276. package/src/mcp/dynamic-modules.d.ts +0 -7
  277. package/src/mcp/facade.ts +0 -608
  278. package/src/mcp/harness-runtime.ts +0 -203
  279. package/src/mcp/hosted-server.ts +0 -468
  280. package/src/mcp/mcp-bin.ts +0 -3
  281. package/src/mcp/mcp-cli.ts +0 -82
  282. package/src/mcp/protocol.ts +0 -13
  283. package/src/mcp/sandbox.ts +0 -195
  284. package/src/mcp/sdk-decl.ts +0 -391
  285. package/src/mcp/server.ts +0 -362
  286. package/src/mcp/tool-surface.ts +0 -146
  287. package/src/mermaid-source.ts +0 -655
  288. package/src/multiline-utils.ts +0 -228
  289. package/src/parser.ts +0 -1031
  290. package/src/pie/layout.ts +0 -168
  291. package/src/pie/parser.ts +0 -136
  292. package/src/pie/renderer.ts +0 -234
  293. package/src/pie/types.ts +0 -82
  294. package/src/quadrant/layout.ts +0 -191
  295. package/src/quadrant/parser.ts +0 -183
  296. package/src/quadrant/renderer.ts +0 -322
  297. package/src/quadrant/types.ts +0 -113
  298. package/src/render-family-hooks.ts +0 -244
  299. package/src/renderer.ts +0 -1099
  300. package/src/route-contracts.ts +0 -2723
  301. package/src/scene/backend.ts +0 -76
  302. package/src/scene/fidelity.ts +0 -183
  303. package/src/scene/hybrid-backend.ts +0 -174
  304. package/src/scene/ir.ts +0 -181
  305. package/src/scene/marks.ts +0 -127
  306. package/src/scene/rough-backend.ts +0 -378
  307. package/src/scene/seed.ts +0 -46
  308. package/src/scene/style-registry.ts +0 -556
  309. package/src/sequence/layout.ts +0 -456
  310. package/src/sequence/parser.ts +0 -255
  311. package/src/sequence/renderer.ts +0 -604
  312. package/src/sequence/types.ts +0 -154
  313. package/src/shape-clipping.ts +0 -351
  314. package/src/shared/accessibility-directives.ts +0 -22
  315. package/src/shared/batched.ts +0 -61
  316. package/src/shared/color-math.ts +0 -93
  317. package/src/shared/svg-a11y.ts +0 -29
  318. package/src/shared/syntax-error.ts +0 -17
  319. package/src/shared/unicode-ranges.ts +0 -135
  320. package/src/styles.ts +0 -318
  321. package/src/svg-paths.ts +0 -28
  322. package/src/text-metrics.ts +0 -248
  323. package/src/theme.ts +0 -710
  324. package/src/timeline/layout.ts +0 -381
  325. package/src/timeline/parser.ts +0 -215
  326. package/src/timeline/renderer.ts +0 -538
  327. package/src/timeline/types.ts +0 -105
  328. package/src/types.ts +0 -462
  329. package/src/website-worker-modules.d.ts +0 -18
  330. package/src/xychart/axis-utils.ts +0 -109
  331. package/src/xychart/colors.ts +0 -124
  332. package/src/xychart/config.ts +0 -88
  333. package/src/xychart/layout.ts +0 -656
  334. package/src/xychart/parser.ts +0 -504
  335. package/src/xychart/renderer.ts +0 -640
  336. package/src/xychart/types.ts +0 -282
@@ -1,640 +0,0 @@
1
- import type { PositionedBar, PositionedXYChart } from './types.ts'
2
- import type { RenderContext, RenderOptions } from '../types.ts'
3
- import { svgOpenTag, buildStyleBlock } from '../theme.ts'
4
- import { TEXT_BASELINE_SHIFT, applyTextTransform, estimateTextWidth, STROKE_WIDTHS, resolveRenderStyle } from '../styles.ts'
5
- import type { RenderStyleDefaults } from '../styles.ts'
6
- import { XY_STYLE_DEFAULTS } from './layout.ts'
7
- import { escapeXml } from '../multiline-utils.ts'
8
- import { getSeriesColor, CHART_ACCENT_FALLBACK } from './colors.ts'
9
- import type { MarkPaint, SceneDoc, SceneNode } from '../scene/ir.ts'
10
- import * as marks from '../scene/marks.ts'
11
- import { DefaultBackend } from '../scene/backend.ts'
12
-
13
- // ============================================================================
14
- // XY Chart SVG renderer
15
- //
16
- // Rendered output now tracks Mermaid's own xychart structure more closely:
17
- // fixed chart dimensions, explicit axis lines/ticks, simple grid lines,
18
- // straight line segments, and in-bar data labels for bar plots.
19
- //
20
- // The chart is lowered to the SceneGraph IR (SPEC §3.1): every visual mark
21
- // becomes a scene node carrying semantic fields (role, geometry, paint,
22
- // channels, stable id) plus its exact crisp serialization, built here from
23
- // the same inputs. renderXYChartSvg() is DefaultBackend serialization of that
24
- // scene, so the default path stays byte-identical to the historical string
25
- // renderer (corpus-gated by svg-equivalence.test.ts). Interaction-only
26
- // chrome (hover targets, tooltip groups) stays raw in this phase.
27
- // ============================================================================
28
-
29
- const CHART_FONT = {
30
- titleWeight: 500,
31
- axisTitleWeight: 400,
32
- labelWeight: 400,
33
- dotRadius: 4,
34
- lineWidth: 3,
35
- } as const
36
-
37
- const TIP = {
38
- fontSize: 15,
39
- fontWeight: 500,
40
- height: 32,
41
- padX: 14,
42
- offsetY: 12,
43
- rx: 8,
44
- minY: 4,
45
- pointerSize: 6,
46
- } as const
47
-
48
- export function renderXYChartSvg(
49
- ctx: RenderContext<PositionedXYChart>,
50
- ): string {
51
- return DefaultBackend.render(lowerXYChartScene(ctx), { seed: 0 })
52
- }
53
-
54
- /**
55
- * Lower a positioned XY chart to the SceneGraph IR. Mark order matches the
56
- * historical parts[] order exactly; DefaultBackend joins crisps with '\n'.
57
- */
58
- export function lowerXYChartScene(
59
- ctx: RenderContext<PositionedXYChart>,
60
- ): SceneDoc {
61
- const { positioned: chart, colors, options } = ctx
62
- const font = colors.font ?? 'Inter'
63
- const transparent = options.transparent ?? false
64
- const interactive = options.interactive ?? false
65
- const parts: SceneNode[] = []
66
- const style = resolveRenderStyle(options, XY_STYLE_DEFAULTS)
67
- const chartColors = resolveChartColors(chart, style)
68
-
69
- const maxColorIdx = Math.max(0, ...chart.bars.map(bar => bar.colorIndex), ...chart.lines.map(line => line.colorIndex))
70
- const svgMeta = buildSvgMetadata(chart)
71
- const svgTag = svgOpenTag(chart.width, chart.height, colors, transparent, svgMeta.openTag)
72
- .replace('<svg ', `<svg data-xychart-colors="${maxColorIdx}" `)
73
-
74
- const { style: chartStyle, defs } = chartStyles(chart, interactive, colors.accent, colors.bg, options)
75
- parts.push(marks.prelude(
76
- {
77
- id: 'prelude',
78
- width: chart.width,
79
- height: chart.height,
80
- colors,
81
- transparent,
82
- font,
83
- hasMonoFont: false,
84
- extraCss: chartStyle,
85
- },
86
- svgTag + '\n' +
87
- buildStyleBlock(font, false, colors.shadow, colors.embedFontImport) + '\n' +
88
- chartStyle,
89
- ))
90
- if (defs) parts.push(marks.raw({ id: 'defs', role: 'defs' }, defs))
91
- if (svgMeta.title) parts.push(marks.raw({ id: 'acc-title', role: 'chrome' }, svgMeta.title))
92
- if (svgMeta.description) parts.push(marks.raw({ id: 'acc-desc', role: 'chrome' }, svgMeta.description))
93
-
94
- // Grid lines are always derived from the value (y) axis tick values, in
95
- // both orientations; the tick value itself is not carried through layout,
96
- // so the stable id falls back to the tick index.
97
- const gridPaint: MarkPaint = {
98
- stroke: chartColors.gridStroke,
99
- strokeWidth: '1',
100
- ...(style.edgeStrokeColor ? { opacity: '0.25' } : {}),
101
- }
102
- chart.gridLines.forEach((gridLine, index) => {
103
- parts.push(marks.shape({
104
- id: `grid:y:${index}`,
105
- role: 'grid',
106
- geometry: { kind: 'line', x1: rn(gridLine.x1), y1: rn(gridLine.y1), x2: rn(gridLine.x2), y2: rn(gridLine.y2) },
107
- paint: gridPaint,
108
- },
109
- `<line x1="${r(gridLine.x1)}" y1="${r(gridLine.y1)}" x2="${r(gridLine.x2)}" y2="${r(gridLine.y2)}" class="xychart-grid"/>`,
110
- ))
111
- })
112
-
113
- lowerAxis(parts, chart.xAxis, 'x', chartColors.xAxisLineColor, chartColors.xAxisTickColor)
114
- lowerAxis(parts, chart.yAxis, 'y', chartColors.yAxisLineColor, chartColors.yAxisTickColor)
115
-
116
- // Normalization basis for the `value` channel: the largest absolute data
117
- // value across every series (cheap, deterministic).
118
- const maxAbsValue = Math.max(
119
- 0,
120
- ...chart.bars.map(bar => Math.abs(bar.value)),
121
- ...chart.lines.flatMap(line => line.points.map(point => Math.abs(point.value))),
122
- )
123
- const normalized = (value: number): number | undefined =>
124
- maxAbsValue > 0 ? value / maxAbsValue : undefined
125
-
126
- const barOverlay: SceneNode[] = []
127
- const barSeriesCount = new Map<number, number>()
128
- for (const bar of chart.bars) {
129
- const catIndex = barSeriesCount.get(bar.seriesIndex) ?? 0
130
- barSeriesCount.set(bar.seriesIndex, catIndex + 1)
131
- const barId = `bar:${bar.seriesIndex}:${bar.label ?? catIndex}`
132
- const dataAttrs = ` data-value="${bar.value}"${bar.label ? ` data-label="${escapeXml(bar.label)}"` : ''}`
133
- parts.push(marks.shape({
134
- id: barId,
135
- role: 'bar',
136
- geometry: { kind: 'rect', x: rn(bar.x), y: rn(bar.y), width: rn(bar.width), height: rn(bar.height) },
137
- paint: { fill: `var(--xychart-color-${bar.colorIndex})` },
138
- channels: { category: `bar-${bar.seriesIndex}`, value: normalized(bar.value) },
139
- },
140
- `<rect x="${r(bar.x)}" y="${r(bar.y)}" width="${r(bar.width)}" height="${r(bar.height)}" ` +
141
- `class="xychart-bar xychart-color-${bar.colorIndex}"${dataAttrs}/>`,
142
- ))
143
-
144
- if (interactive) {
145
- const tipText = formatTipValue(bar.value)
146
- const tipTitle = bar.label ? `${bar.label}: ${tipText}` : tipText
147
- const tipAnchorX = chart.horizontal ? bar.x + bar.width : bar.x + bar.width / 2
148
- const tipAnchorY = chart.horizontal ? bar.y + bar.height / 2 : bar.y
149
- // Pure interaction chrome (invisible hover rect + tooltip) — stays raw.
150
- barOverlay.push(marks.raw({ id: `tooltip:${barId}`, role: 'chrome' },
151
- `<g class="xychart-bar-group">` +
152
- `<rect x="${r(bar.x)}" y="${r(bar.y)}" width="${r(bar.width)}" height="${r(bar.height)}" fill="transparent"/>` +
153
- `<title>${escapeXml(tipTitle)}</title>` +
154
- tooltipAbove(tipAnchorX, tipAnchorY, tipText) +
155
- `</g>`,
156
- ))
157
- }
158
- }
159
-
160
- for (const line of chart.lines) {
161
- if (line.points.length === 0) continue
162
- const d = polylinePath(line.points)
163
- parts.push(marks.connector({
164
- id: `series:line-${line.seriesIndex}`,
165
- role: 'series',
166
- geometry: { kind: 'path', d, points: line.points },
167
- lineStyle: 'solid',
168
- paint: { stroke: `var(--xychart-color-${line.colorIndex})`, strokeWidth: String(style.lineWidth) },
169
- channels: { category: `line-${line.seriesIndex}` },
170
- },
171
- `<path d="${d}" class="xychart-line xychart-color-${line.colorIndex}"/>`,
172
- ))
173
- }
174
-
175
- const dotOverlay: SceneNode[] = []
176
- if (interactive) {
177
- for (const line of chart.lines) {
178
- line.points.forEach((point, pointIndex) => {
179
- const pointId = `point:line-${line.seriesIndex}:${point.label ?? pointIndex}`
180
- const dataAttrs = ` data-value="${point.value}"${point.label ? ` data-label="${escapeXml(point.label)}"` : ''}`
181
- const tipText = formatTipValue(point.value)
182
- const tipTitle = point.label ? `${point.label}: ${tipText}` : tipText
183
- // The visible dot is a semantic point mark; the enlarged hit circle
184
- // and the tooltip block are interaction chrome and stay raw.
185
- dotOverlay.push(marks.group({
186
- id: `point-group:line-${line.seriesIndex}:${point.label ?? pointIndex}`,
187
- role: 'chrome',
188
- open: `<g class="xychart-dot-group">`,
189
- close: `</g>`,
190
- join: '',
191
- children: [
192
- {
193
- node: marks.raw({ id: `hit:${pointId}`, role: 'chrome' },
194
- `<circle cx="${r(point.x)}" cy="${r(point.y)}" r="${CHART_FONT.dotRadius * 3}" fill="transparent" class="xychart-hit"/>`),
195
- indent: 0,
196
- },
197
- {
198
- node: marks.shape({
199
- id: pointId,
200
- role: 'point',
201
- geometry: { kind: 'circle', cx: rn(point.x), cy: rn(point.y), r: CHART_FONT.dotRadius },
202
- paint: { fill: `var(--xychart-color-${line.colorIndex})`, stroke: 'var(--bg)', strokeWidth: '2' },
203
- channels: { category: `line-${line.seriesIndex}`, value: normalized(point.value) },
204
- },
205
- `<circle cx="${r(point.x)}" cy="${r(point.y)}" r="${CHART_FONT.dotRadius}" class="xychart-dot xychart-color-${line.colorIndex}"${dataAttrs}/>`),
206
- indent: 0,
207
- },
208
- {
209
- node: marks.raw({ id: `tooltip:${pointId}`, role: 'chrome' },
210
- `<title>${escapeXml(tipTitle)}</title>` +
211
- tooltipAbove(point.x, point.y - CHART_FONT.dotRadius, tipText)),
212
- indent: 0,
213
- },
214
- ],
215
- }))
216
- })
217
- }
218
- }
219
-
220
- if (chart.config.showDataLabel) {
221
- const labelSeriesCount = new Map<number, number>()
222
- for (const label of buildBarDataLabels(chart.bars, chart.horizontal ?? false)) {
223
- const text = applyTextTransform(label.text, style.nodeTextTransform)
224
- const catIndex = labelSeriesCount.get(label.bar.seriesIndex) ?? 0
225
- labelSeriesCount.set(label.bar.seriesIndex, catIndex + 1)
226
- parts.push(marks.text({
227
- id: `label:bar:${label.bar.seriesIndex}:${label.bar.label ?? catIndex}`,
228
- role: 'label',
229
- text,
230
- x: label.x,
231
- y: label.y,
232
- fontSize: label.fontSize,
233
- anchor: label.anchor,
234
- paint: { fill: chartColors.labelColor },
235
- channels: { category: `bar-${label.bar.seriesIndex}`, value: normalized(label.bar.value) },
236
- },
237
- `<text x="${r(label.x)}" y="${r(label.y)}" text-anchor="${label.anchor}" ` +
238
- `${label.dominantBaseline ? `dominant-baseline="${label.dominantBaseline}" ` : ''}` +
239
- `font-size="${label.fontSize}" font-weight="${style.nodeLabelFontWeight}"${letterAttr(style.nodeLetterSpacing)} class="xychart-data-label">${escapeXml(text)}</text>`,
240
- ))
241
- }
242
- }
243
-
244
- lowerAxisLabels(parts, chart.xAxis.ticks, chart.xAxis.config.labelFontSize, 'x', style, chartColors.xAxisLabelColor)
245
- lowerAxisLabels(parts, chart.yAxis.ticks, chart.yAxis.config.labelFontSize, 'y', style, chartColors.yAxisLabelColor)
246
-
247
- if (chart.xAxis.title) {
248
- const title = chart.xAxis.title
249
- const text = applyTextTransform(title.text, style.edgeTextTransform)
250
- const transform = title.rotate ? ` transform="rotate(${title.rotate},${title.x},${title.y})"` : ''
251
- parts.push(marks.text({
252
- id: 'axis:x:title',
253
- role: 'axis',
254
- text,
255
- x: title.x,
256
- y: title.y,
257
- fontSize: chart.xAxis.config.titleFontSize,
258
- anchor: 'middle',
259
- paint: { fill: chartColors.xAxisTitleColor },
260
- },
261
- `<text x="${title.x}" y="${title.y}" text-anchor="middle"${transform} ` +
262
- `font-size="${chart.xAxis.config.titleFontSize}" font-weight="${style.edgeLabelFontWeight}"${letterAttr(style.edgeLetterSpacing)} ` +
263
- `dy="${TEXT_BASELINE_SHIFT}" class="xychart-axis-title xychart-x-axis-title">${escapeXml(text)}</text>`,
264
- ))
265
- }
266
-
267
- if (chart.yAxis.title) {
268
- const title = chart.yAxis.title
269
- const text = applyTextTransform(title.text, style.edgeTextTransform)
270
- const transform = title.rotate ? ` transform="rotate(${title.rotate},${title.x},${title.y})"` : ''
271
- parts.push(marks.text({
272
- id: 'axis:y:title',
273
- role: 'axis',
274
- text,
275
- x: title.x,
276
- y: title.y,
277
- fontSize: chart.yAxis.config.titleFontSize,
278
- anchor: 'middle',
279
- paint: { fill: chartColors.yAxisTitleColor },
280
- },
281
- `<text x="${title.x}" y="${title.y}" text-anchor="middle"${transform} ` +
282
- `font-size="${chart.yAxis.config.titleFontSize}" font-weight="${style.edgeLabelFontWeight}"${letterAttr(style.edgeLetterSpacing)} ` +
283
- `dy="${TEXT_BASELINE_SHIFT}" class="xychart-axis-title xychart-y-axis-title">${escapeXml(text)}</text>`,
284
- ))
285
- }
286
-
287
- if (chart.title) {
288
- const title = applyTextTransform(chart.title.text, style.groupTextTransform)
289
- parts.push(marks.text({
290
- id: 'title',
291
- role: 'title',
292
- text: title,
293
- x: chart.title.x,
294
- y: chart.title.y,
295
- fontSize: chart.config.titleFontSize,
296
- anchor: 'middle',
297
- paint: { fill: chartColors.titleColor },
298
- },
299
- `<text x="${chart.title.x}" y="${chart.title.y}" text-anchor="middle" ` +
300
- `font-size="${chart.config.titleFontSize}" font-weight="${style.groupHeaderFontWeight}"${letterAttr(style.groupLetterSpacing)} ` +
301
- `dy="${TEXT_BASELINE_SHIFT}" class="xychart-title">${escapeXml(title)}</text>`,
302
- ))
303
- }
304
-
305
- for (const group of barOverlay) parts.push(group)
306
- for (const group of dotOverlay) parts.push(group)
307
-
308
- parts.push(marks.raw({ id: 'svg-close', role: 'chrome' }, '</svg>'))
309
-
310
- return { family: 'xychart', width: chart.width, height: chart.height, colors, parts }
311
- }
312
-
313
- function lowerAxis(
314
- parts: SceneNode[],
315
- axis: PositionedXYChart['xAxis'],
316
- axisName: 'x' | 'y',
317
- lineColor: string,
318
- tickColor: string,
319
- ): void {
320
- if (axis.config.showAxisLine) {
321
- parts.push(marks.shape({
322
- id: `axis:${axisName}:line`,
323
- role: 'axis',
324
- geometry: { kind: 'line', x1: rn(axis.line.x1), y1: rn(axis.line.y1), x2: rn(axis.line.x2), y2: rn(axis.line.y2) },
325
- paint: { stroke: lineColor, strokeWidth: String(axis.config.axisLineWidth) },
326
- },
327
- `<line x1="${r(axis.line.x1)}" y1="${r(axis.line.y1)}" x2="${r(axis.line.x2)}" y2="${r(axis.line.y2)}" ` +
328
- `class="xychart-axis-line xychart-${axisName}-axis-line" stroke-width="${axis.config.axisLineWidth}"/>`,
329
- ))
330
- }
331
-
332
- if (!axis.config.showTick) return
333
- for (const tick of axis.ticks) {
334
- parts.push(marks.shape({
335
- id: `axis:${axisName}:tick:${tick.label}`,
336
- role: 'axis',
337
- geometry: { kind: 'line', x1: rn(tick.x), y1: rn(tick.y), x2: rn(tick.tx), y2: rn(tick.ty) },
338
- paint: { stroke: tickColor, strokeWidth: String(axis.config.tickWidth) },
339
- },
340
- `<line x1="${r(tick.x)}" y1="${r(tick.y)}" x2="${r(tick.tx)}" y2="${r(tick.ty)}" ` +
341
- `class="xychart-tick xychart-${axisName}-tick" stroke-width="${axis.config.tickWidth}"/>`,
342
- ))
343
- }
344
- }
345
-
346
- function lowerAxisLabels(
347
- parts: SceneNode[],
348
- ticks: PositionedXYChart['xAxis']['ticks'],
349
- fontSize: number,
350
- axisName: 'x' | 'y',
351
- style: ReturnType<typeof resolveRenderStyle>,
352
- fill: string,
353
- ): void {
354
- for (const tick of ticks) {
355
- const label = applyTextTransform(tick.label, style.edgeTextTransform)
356
- const middleBaseline = tick.textAnchor === 'end' ? ' dominant-baseline="middle"' : ''
357
- const dy = tick.textAnchor === 'end' ? '' : ` dy="${TEXT_BASELINE_SHIFT}"`
358
- parts.push(marks.text({
359
- id: `axis:${axisName}:label:${tick.label}`,
360
- role: 'axis',
361
- text: label,
362
- x: tick.labelX,
363
- y: tick.labelY,
364
- fontSize,
365
- anchor: tick.textAnchor,
366
- paint: { fill },
367
- },
368
- `<text x="${tick.labelX}" y="${tick.labelY}" text-anchor="${tick.textAnchor}"${middleBaseline} ` +
369
- `font-size="${fontSize}" font-weight="${style.nodeLabelFontWeight}"${letterAttr(style.nodeLetterSpacing)}${dy} class="xychart-label xychart-${axisName}-label">` +
370
- `${escapeXml(label)}</text>`,
371
- ))
372
- }
373
- }
374
-
375
- /** Theme/renderStyle color cascade shared by the style block and mark paints. */
376
- interface ResolvedChartColors {
377
- gridStroke: string
378
- titleColor: string
379
- labelColor: string
380
- axisTitleColor: string
381
- xAxisLabelColor: string
382
- yAxisLabelColor: string
383
- xAxisTickColor: string
384
- yAxisTickColor: string
385
- xAxisLineColor: string
386
- yAxisLineColor: string
387
- xAxisTitleColor: string
388
- yAxisTitleColor: string
389
- }
390
-
391
- function resolveChartColors(
392
- chart: PositionedXYChart,
393
- renderStyle: ReturnType<typeof resolveRenderStyle>,
394
- ): ResolvedChartColors {
395
- const themeOverrides = chart.theme
396
- return {
397
- gridStroke: renderStyle.edgeStrokeColor ?? 'color-mix(in srgb, var(--fg) 14%, transparent)',
398
- titleColor: themeOverrides.titleColor ?? renderStyle.groupTextColor ?? renderStyle.nodeTextColor ?? 'var(--_text)',
399
- labelColor: renderStyle.nodeTextColor ?? 'var(--_text)',
400
- axisTitleColor: renderStyle.edgeTextColor ?? renderStyle.nodeTextColor ?? 'var(--_text)',
401
- xAxisLabelColor: themeOverrides.xAxisLabelColor ?? renderStyle.nodeTextColor ?? 'var(--_text)',
402
- yAxisLabelColor: themeOverrides.yAxisLabelColor ?? renderStyle.nodeTextColor ?? 'var(--_text)',
403
- xAxisTickColor: themeOverrides.xAxisTickColor ?? renderStyle.groupTextColor ?? 'var(--_text-sec)',
404
- yAxisTickColor: themeOverrides.yAxisTickColor ?? renderStyle.groupTextColor ?? 'var(--_text-sec)',
405
- xAxisLineColor: themeOverrides.xAxisLineColor ?? renderStyle.edgeStrokeColor ?? 'var(--_text-sec)',
406
- yAxisLineColor: themeOverrides.yAxisLineColor ?? renderStyle.edgeStrokeColor ?? 'var(--_text-sec)',
407
- xAxisTitleColor: themeOverrides.xAxisTitleColor ?? renderStyle.edgeTextColor ?? renderStyle.nodeTextColor ?? 'var(--_text)',
408
- yAxisTitleColor: themeOverrides.yAxisTitleColor ?? renderStyle.edgeTextColor ?? renderStyle.nodeTextColor ?? 'var(--_text)',
409
- }
410
- }
411
-
412
- function chartStyles(
413
- chart: PositionedXYChart,
414
- interactive: boolean,
415
- themeAccent?: string,
416
- bgColor?: string,
417
- options: RenderOptions = {},
418
- ): { style: string; defs: string } {
419
- const renderStyle = resolveRenderStyle(options, XY_STYLE_DEFAULTS)
420
- const cc = resolveChartColors(chart, renderStyle)
421
- const accentHex = themeAccent ?? CHART_ACCENT_FALLBACK
422
- const themeOverrides = chart.theme
423
- const colorIndices = new Set<number>()
424
- for (const bar of chart.bars) colorIndices.add(bar.colorIndex)
425
- for (const line of chart.lines) colorIndices.add(line.colorIndex)
426
-
427
- const colorVarDefs: string[] = []
428
- const explicitPalette = themeOverrides.plotColorPalette
429
- for (const index of [...colorIndices].sort((a, b) => a - b)) {
430
- const value = explicitPalette && explicitPalette.length > 0
431
- ? explicitPalette[index % explicitPalette.length]!
432
- : (index === 0 ? `var(--accent, ${CHART_ACCENT_FALLBACK})` : getSeriesColor(index, accentHex, bgColor))
433
- colorVarDefs.push(` --xychart-color-${index}: ${value};`)
434
- }
435
-
436
- const seriesRules: string[] = []
437
- for (const index of [...colorIndices].sort((a, b) => a - b)) {
438
- const color = `var(--xychart-color-${index})`
439
- seriesRules.push(` .xychart-bar.xychart-color-${index} { fill: ${color}; }`)
440
- seriesRules.push(` path.xychart-color-${index}, line.xychart-color-${index} { stroke: ${color}; }`)
441
- seriesRules.push(` circle.xychart-color-${index} { fill: ${color}; }`)
442
- }
443
-
444
- const tipRules = interactive ? `
445
- .xychart-tip { opacity: 0; pointer-events: none; }
446
- .xychart-tip-bg { fill: var(--_text); }
447
- .xychart-tip-text { fill: var(--bg); font-size: ${TIP.fontSize}px; font-weight: ${TIP.fontWeight}; }
448
- .xychart-tip-ptr { fill: var(--_text); }
449
- .xychart-bar-group:hover .xychart-tip,
450
- .xychart-dot-group:hover .xychart-tip { opacity: 1; }` : ''
451
-
452
- const colorVarsBlock = colorVarDefs.length > 0 ? `\n svg {\n${colorVarDefs.join('\n')}\n }` : ''
453
-
454
- const extraThemeCss = chart.theme.themeCss ? `\n${chart.theme.themeCss}\n` : ''
455
- const style = `<style>
456
- .xychart-grid { stroke: ${cc.gridStroke}; stroke-width: 1${renderStyle.edgeStrokeColor ? '; opacity: 0.25' : ''}; }
457
- .xychart-axis-line { fill: none; }
458
- .xychart-tick { fill: none; }
459
- .xychart-x-axis-line { stroke: ${cc.xAxisLineColor}; }
460
- .xychart-y-axis-line { stroke: ${cc.yAxisLineColor}; }
461
- .xychart-x-tick { stroke: ${cc.xAxisTickColor}; }
462
- .xychart-y-tick { stroke: ${cc.yAxisTickColor}; }
463
- .xychart-bar { stroke: none; }
464
- .xychart-line { fill: none; stroke-width: ${renderStyle.lineWidth}; stroke-linecap: round; stroke-linejoin: round; }
465
- .xychart-dot { stroke: var(--bg); stroke-width: 2; }
466
- .xychart-label { fill: ${cc.labelColor}; }
467
- .xychart-x-label { fill: ${cc.xAxisLabelColor}; }
468
- .xychart-y-label { fill: ${cc.yAxisLabelColor}; }
469
- .xychart-axis-title { fill: ${cc.axisTitleColor}; }
470
- .xychart-x-axis-title { fill: ${cc.xAxisTitleColor}; }
471
- .xychart-y-axis-title { fill: ${cc.yAxisTitleColor}; }
472
- .xychart-title { fill: ${cc.titleColor}; }
473
- .xychart-data-label { fill: ${cc.labelColor}; pointer-events: none; }${colorVarsBlock}
474
- ${seriesRules.join('\n')}${tipRules}${extraThemeCss}
475
- </style>`
476
-
477
- return { style, defs: '' }
478
- }
479
-
480
- function polylinePath(points: Array<{ x: number; y: number }>): string {
481
- if (points.length === 0) return ''
482
- let path = `M${r(points[0]!.x)},${r(points[0]!.y)}`
483
- for (let i = 1; i < points.length; i++) {
484
- path += ` L${r(points[i]!.x)},${r(points[i]!.y)}`
485
- }
486
- return path
487
- }
488
-
489
- function buildBarDataLabels(
490
- bars: PositionedBar[],
491
- horizontal: boolean,
492
- ): Array<{
493
- bar: PositionedBar
494
- x: number
495
- y: number
496
- text: string
497
- anchor: 'middle' | 'end'
498
- fontSize: number
499
- dominantBaseline?: 'middle' | 'hanging'
500
- }> {
501
- const visibleBars = bars.filter(bar => bar.width > 0 && bar.height > 0)
502
- if (visibleBars.length === 0) return []
503
-
504
- const texts = visibleBars.map(bar => formatTipValue(bar.value))
505
- const candidates = visibleBars.map((bar, index) => {
506
- const text = texts[index]!
507
- if (horizontal) {
508
- const widthFit = Math.max(0, (bar.width - 12) / Math.max(1, text.length * 0.62))
509
- return Math.min(bar.height * 0.72, widthFit)
510
- }
511
- const widthFit = Math.max(0, (bar.width - 8) / Math.max(1, text.length * 0.62))
512
- const heightFit = Math.max(0, bar.height - 10)
513
- return Math.min(widthFit, heightFit)
514
- })
515
-
516
- const rawFontSize = Math.floor(Math.min(...candidates))
517
- if (!Number.isFinite(rawFontSize) || rawFontSize < 8) return []
518
- const fontSize = Math.min(16, rawFontSize)
519
-
520
- return visibleBars.map((bar, index) => horizontal
521
- ? {
522
- bar,
523
- x: bar.x + bar.width - 8,
524
- y: bar.y + bar.height / 2,
525
- text: texts[index]!,
526
- anchor: 'end',
527
- fontSize,
528
- dominantBaseline: 'middle',
529
- }
530
- : {
531
- bar,
532
- x: bar.x + bar.width / 2,
533
- y: bar.y + 8,
534
- text: texts[index]!,
535
- anchor: 'middle',
536
- fontSize,
537
- dominantBaseline: 'hanging',
538
- })
539
- }
540
-
541
- function tooltipAbove(cx: number, topY: number, text: string): string {
542
- const textW = estimateTextWidth(text, TIP.fontSize, TIP.fontWeight)
543
- const bgW = textW + TIP.padX * 2
544
- const bgX = cx - bgW / 2
545
- let bgY = topY - TIP.offsetY - TIP.height
546
- let ptrY = bgY + TIP.height
547
-
548
- if (bgY < TIP.minY) {
549
- bgY = TIP.minY
550
- ptrY = bgY + TIP.height
551
- }
552
-
553
- const textX = cx
554
- const textY = bgY + TIP.height / 2
555
- const p = TIP.pointerSize
556
- const ptrPath = `M${r(cx - p)},${r(ptrY)} L${r(cx + p)},${r(ptrY)} L${r(cx)},${r(ptrY + p)} Z`
557
-
558
- return (
559
- `<g class="xychart-tip">` +
560
- `<rect x="${r(bgX)}" y="${r(bgY)}" width="${r(bgW)}" height="${TIP.height}" rx="${TIP.rx}" class="xychart-tip xychart-tip-bg"/>` +
561
- `<path d="${ptrPath}" class="xychart-tip xychart-tip-ptr"/>` +
562
- `<text x="${r(textX)}" y="${r(textY)}" text-anchor="middle" dy="${TEXT_BASELINE_SHIFT}" class="xychart-tip xychart-tip-text">${escapeXml(text)}</text>` +
563
- `</g>`
564
- )
565
- }
566
-
567
- function formatTipValue(value: number): string {
568
- if (Number.isInteger(value)) return String(value)
569
- return value.toFixed(Math.abs(value) < 10 ? 1 : 0)
570
- }
571
-
572
- /** Round to the same 2-decimal grid the crisp serializer uses, so semantic
573
- * geometry numbers String()-equal their crisp attributes. */
574
- function rn(value: number): number {
575
- return Math.round(value * 100) / 100
576
- }
577
-
578
- function r(value: number): string {
579
- return rn(value).toString()
580
- }
581
-
582
- function letterAttr(value: number): string {
583
- return value !== 0 ? ` letter-spacing="${value}"` : ''
584
- }
585
-
586
-
587
- function buildSvgMetadata(chart: PositionedXYChart): {
588
- openTag: Parameters<typeof svgOpenTag>[4]
589
- title?: string
590
- description?: string
591
- } {
592
- const svgId = `mermaid-${hashChart(chart)}`
593
- const accTitleId = chart.accessibility?.title ? `chart-title-${svgId}` : undefined
594
- const accDescId = chart.accessibility?.description ? `chart-desc-${svgId}` : undefined
595
- const responsiveWidth = chart.config.useWidth ?? chart.width
596
- const width = chart.config.useMaxWidth ? '100%' : String(responsiveWidth)
597
- const height = chart.config.useMaxWidth
598
- ? '100%'
599
- : String(Math.round(chart.height * (responsiveWidth / Math.max(1, chart.width))))
600
- const style = chart.config.useMaxWidth ? `max-width:${responsiveWidth}px` : undefined
601
-
602
- return {
603
- openTag: {
604
- width,
605
- height,
606
- style,
607
- attrs: {
608
- id: svgId,
609
- class: 'xychart',
610
- role: (accTitleId || accDescId) ? 'img' : undefined,
611
- 'aria-roledescription': 'xychart',
612
- 'aria-labelledby': accTitleId,
613
- 'aria-describedby': accDescId,
614
- },
615
- },
616
- title: chart.accessibility?.title
617
- ? `<title id="${accTitleId}">${escapeXml(chart.accessibility.title)}</title>`
618
- : undefined,
619
- description: chart.accessibility?.description
620
- ? `<desc id="${accDescId}">${escapeXml(chart.accessibility.description)}</desc>`
621
- : undefined,
622
- }
623
- }
624
-
625
- function hashChart(chart: PositionedXYChart): string {
626
- const text = [
627
- chart.width,
628
- chart.height,
629
- chart.title?.text ?? '',
630
- chart.accessibility?.title ?? '',
631
- chart.accessibility?.description ?? '',
632
- chart.bars.length,
633
- chart.lines.length,
634
- ].join('|')
635
- let hash = 5381
636
- for (let i = 0; i < text.length; i++) {
637
- hash = ((hash << 5) + hash) ^ text.charCodeAt(i)
638
- }
639
- return Math.abs(hash >>> 0).toString(36)
640
- }