agentic-mermaid 0.1.1 → 0.2.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (340) hide show
  1. package/AGENT_NATIVE.md +155 -91
  2. package/CHANGELOG.md +163 -4
  3. package/Instructions_for_agents.md +10 -10
  4. package/LICENSES/Apache-2.0.txt +202 -0
  5. package/README.md +31 -38
  6. package/THIRD_PARTY_NOTICES.md +29 -0
  7. package/assets/hero.png +0 -0
  8. package/dist/agent-core.d.ts +463 -0
  9. package/dist/agent-core.js +397 -0
  10. package/dist/agent.d.ts +73 -1868
  11. package/dist/agent.js +336 -37325
  12. package/dist/agentic-mermaid-mcp.js +7 -38399
  13. package/dist/am.js +33626 -40446
  14. package/dist/chunk-2P5FKUQC.js +3485 -0
  15. package/dist/chunk-2S3VSS6I.js +149 -0
  16. package/dist/chunk-2SILJDW2.js +37 -0
  17. package/dist/chunk-BJYMBT4I.js +61963 -0
  18. package/dist/chunk-FDM43XU7.js +615 -0
  19. package/dist/chunk-MYPDVZCO.js +4702 -0
  20. package/dist/index-DWPa2MJs.d.ts +6780 -0
  21. package/dist/index.d.ts +1 -1
  22. package/dist/index.js +310 -33014
  23. package/dist/mcp-cli-5J47WEY3.js +17 -0
  24. package/docs/README.md +39 -31
  25. package/docs/agent-api-cookbook.md +44 -35
  26. package/docs/agent-mutation-policy.md +1 -1
  27. package/docs/agent-workflow-examples.md +2 -2
  28. package/docs/api.md +284 -77
  29. package/docs/ascii.md +26 -16
  30. package/docs/code-mode-impact.md +214 -0
  31. package/docs/comparison.md +23 -11
  32. package/docs/computational-aesthetics-prototype-plan.md +252 -0
  33. package/docs/config.md +26 -10
  34. package/docs/custom-fonts.md +265 -0
  35. package/docs/custom-style-cookbook.md +130 -9
  36. package/docs/diagram-families.md +48 -23
  37. package/docs/features.md +59 -52
  38. package/docs/fork-differences.md +6 -3
  39. package/docs/getting-started.md +23 -16
  40. package/docs/issue-derived-test-cases.md +29 -22
  41. package/docs/mcp-code-mode-rationale.md +13 -6
  42. package/docs/mcp-http-transport.md +20 -13
  43. package/docs/mermaid-layout-complaints.md +66 -52
  44. package/docs/mutation-testing.md +145 -66
  45. package/docs/quality.md +23 -14
  46. package/docs/react.md +2 -2
  47. package/docs/schemas/style-spec.schema.json +1221 -30
  48. package/docs/style-authoring.md +241 -38
  49. package/docs/svg-semantic-contract.md +49 -0
  50. package/docs/testing-strategy.md +166 -58
  51. package/docs/theming.md +19 -32
  52. package/examples/styles/catalog.json +54 -0
  53. package/examples/styles/cloudflare-workers-inspired-prototype.mmd +9 -0
  54. package/examples/styles/cloudflare-workers-inspired-prototype.style.json +110 -0
  55. package/examples/styles/cupertino-prototype.mmd +10 -0
  56. package/examples/styles/cupertino-prototype.style.json +63 -0
  57. package/examples/styles/mid-century-report.style.json +2 -2
  58. package/examples/styles/star-chart-atlas.style.json +2 -1
  59. package/examples/styles/transit-route-map.style.json +2 -2
  60. package/examples/styles/vercel-inspired-prototype.mmd +6 -0
  61. package/examples/styles/vercel-inspired-prototype.style.json +87 -0
  62. package/package.json +85 -45
  63. package/server.json +2 -2
  64. package/skills/agentic-mermaid-diagram-workflow/SKILL.md +17 -36
  65. package/skills/agentic-mermaid-diagram-workflow/references/cli.md +4 -5
  66. package/skills/agentic-mermaid-diagram-workflow/references/code-mode.md +15 -31
  67. package/skills/agentic-mermaid-diagram-workflow/references/sequence.md +10 -14
  68. package/skills/agentic-mermaid-live-editor/SKILL.md +100 -206
  69. package/TODO.md +0 -684
  70. package/dist/index-wjRjbsP-.d.ts +0 -1102
  71. package/docs/assets/improvements/box-start-connector.png +0 -0
  72. package/docs/assets/improvements/comment-dropped-lint.png +0 -0
  73. package/docs/assets/improvements/er-content-loss.png +0 -0
  74. package/docs/assets/improvements/fan-in-trunks.png +0 -0
  75. package/docs/assets/improvements/gantt-family.png +0 -0
  76. package/docs/assets/improvements/gantt-milestone-clamp.png +0 -0
  77. package/docs/assets/improvements/gantt-verify-seam.png +0 -0
  78. package/docs/assets/improvements/subgraph-container-edges.png +0 -0
  79. package/docs/assets/improvements/wrapper-frontmatter.png +0 -0
  80. package/docs/assets/improvements/wrapper-init-directive.png +0 -0
  81. package/docs/assets/improvements/wrapper-leading-comment.png +0 -0
  82. package/docs/assets/style-cookbook/mid-century-report.png +0 -0
  83. package/docs/assets/style-cookbook/star-chart-atlas.png +0 -0
  84. package/docs/assets/style-cookbook/transit-route-map.png +0 -0
  85. package/docs/contributing/adding-diagram-types.md +0 -144
  86. package/docs/contributing/diagram-family-citizenship.matrix.json +0 -2127
  87. package/docs/contributing/diagram-family-citizenship.md +0 -82
  88. package/docs/contributing/harvesting-upstream-tests.md +0 -126
  89. package/docs/contributing/lessons-learned.md +0 -276
  90. package/docs/contributing/releasing.md +0 -82
  91. package/docs/contributing/visual-review-evidence.md +0 -53
  92. package/docs/design/families/README.md +0 -26
  93. package/docs/design/families/architecture-beta.md +0 -48
  94. package/docs/design/families/flowchart-parser-conformance.md +0 -22
  95. package/docs/design/families/gantt-research.md +0 -137
  96. package/docs/design/families/gantt.md +0 -329
  97. package/docs/design/families/journey-agentic-cards-before.png +0 -0
  98. package/docs/design/families/journey-experience-curve-implementation.png +0 -0
  99. package/docs/design/families/journey-mermaid-classic-implementation.png +0 -0
  100. package/docs/design/families/journey-mermaid-classic-prototype.png +0 -0
  101. package/docs/design/families/journey-mermaid-classic-prototype.svg +0 -163
  102. package/docs/design/families/journey-mermaid-classic-prototype.svg.png +0 -0
  103. package/docs/design/families/journey-migration-parity.md +0 -439
  104. package/docs/design/families/journey-section-overlap-after.png +0 -0
  105. package/docs/design/families/journey-section-overlap-before.png +0 -0
  106. package/docs/design/families/journey-usage-research.md +0 -423
  107. package/docs/design/families/journey.md +0 -153
  108. package/docs/design/families/xychart.md +0 -85
  109. package/docs/design/system/README.md +0 -45
  110. package/docs/design/system/abstraction-audit.md +0 -224
  111. package/docs/design/system/abstraction-recommendations.md +0 -655
  112. package/docs/design/system/architecture.mmd +0 -29
  113. package/docs/design/system/architecture.svg +0 -137
  114. package/docs/design/system/layout-guarantees-and-robustness.md +0 -351
  115. package/docs/design/system/layout-rubric.md +0 -138
  116. package/docs/design/system/route-contracts.md +0 -848
  117. package/docs/design/system/source-preservation-ladder.md +0 -52
  118. package/docs/design/system/styles-rollout.md +0 -216
  119. package/docs/design/system/ugly-layouts.md +0 -119
  120. package/docs/layout-characterization/README.md +0 -245
  121. package/docs/layout-characterization/contact-sheet-families.md +0 -498
  122. package/docs/layout-characterization/contact-sheet.md +0 -638
  123. package/docs/layout-characterization/properties.md +0 -281
  124. package/docs/layout-characterization/visual-quality.md +0 -160
  125. package/docs/layout-characterization/visual-snapshots/architecture.svg +0 -79
  126. package/docs/layout-characterization/visual-snapshots/class.svg +0 -60
  127. package/docs/layout-characterization/visual-snapshots/er.svg +0 -61
  128. package/docs/layout-characterization/visual-snapshots/flowchart.svg +0 -58
  129. package/docs/layout-characterization/visual-snapshots/gantt.svg +0 -52
  130. package/docs/layout-characterization/visual-snapshots/journey.svg +0 -98
  131. package/docs/layout-characterization/visual-snapshots/pie.svg +0 -36
  132. package/docs/layout-characterization/visual-snapshots/quadrant.svg +0 -47
  133. package/docs/layout-characterization/visual-snapshots/sequence.svg +0 -59
  134. package/docs/layout-characterization/visual-snapshots/state.svg +0 -52
  135. package/docs/layout-characterization/visual-snapshots/timeline.svg +0 -64
  136. package/docs/layout-characterization/visual-snapshots/xychart.svg +0 -97
  137. package/docs/project/divergences.md +0 -98
  138. package/docs/project/dogfooding-docs-strategy.md +0 -66
  139. package/docs/project/hosted-mcp-cloudflare-plan.md +0 -338
  140. package/docs/project/lessons-learned.md +0 -1019
  141. package/docs/project/remove-role-styling-plan.md +0 -176
  142. package/examples/agent-improve-auth-flow.ts +0 -206
  143. package/examples/agent-loop.ts +0 -53
  144. package/examples/mcp-vs-cli-complex-diagrams.ts +0 -133
  145. package/llms.txt +0 -104
  146. package/skill-evals/README.md +0 -77
  147. package/skill-evals/fixtures/architecture-cache/input.mmd +0 -5
  148. package/skill-evals/fixtures/class-payment/input.mmd +0 -4
  149. package/skill-evals/fixtures/er-orders/input.mmd +0 -10
  150. package/skill-evals/fixtures/flowchart-cache/input.mmd +0 -3
  151. package/skill-evals/fixtures/gantt-release/input.mmd +0 -7
  152. package/skill-evals/fixtures/journey-checkout/input.mmd +0 -6
  153. package/skill-evals/fixtures/pie-exports/input.mmd +0 -5
  154. package/skill-evals/fixtures/quadrant-priorities/input.mmd +0 -11
  155. package/skill-evals/fixtures/sequence-retry/input.mmd +0 -8
  156. package/skill-evals/fixtures/state-lifecycle/input.mmd +0 -5
  157. package/skill-evals/fixtures/timeline-release/input.mmd +0 -6
  158. package/skill-evals/fixtures/xychart-growth/input.mmd +0 -5
  159. package/skill-evals/shared-benchmark.json +0 -510
  160. package/src/agent/analyze.ts +0 -157
  161. package/src/agent/apply.ts +0 -146
  162. package/src/agent/architecture-body.ts +0 -458
  163. package/src/agent/certificates.ts +0 -110
  164. package/src/agent/class-body.ts +0 -319
  165. package/src/agent/core.ts +0 -207
  166. package/src/agent/create.ts +0 -106
  167. package/src/agent/describe.ts +0 -368
  168. package/src/agent/er-body.ts +0 -224
  169. package/src/agent/facts.ts +0 -360
  170. package/src/agent/families-builtin.ts +0 -920
  171. package/src/agent/families.ts +0 -232
  172. package/src/agent/family-layouts.ts +0 -832
  173. package/src/agent/flowchart-body.ts +0 -372
  174. package/src/agent/flowchart-unsupported.ts +0 -243
  175. package/src/agent/font-coverage.ts +0 -288
  176. package/src/agent/gantt-body.ts +0 -495
  177. package/src/agent/index.ts +0 -10
  178. package/src/agent/journey-body.ts +0 -374
  179. package/src/agent/label-metrics.ts +0 -28
  180. package/src/agent/layout-to-rendered.ts +0 -63
  181. package/src/agent/mutate.ts +0 -97
  182. package/src/agent/mutation-ops.ts +0 -51
  183. package/src/agent/op-schema.ts +0 -443
  184. package/src/agent/parse.ts +0 -223
  185. package/src/agent/pie-body.ts +0 -270
  186. package/src/agent/png.ts +0 -171
  187. package/src/agent/quadrant-body.ts +0 -336
  188. package/src/agent/quality.ts +0 -363
  189. package/src/agent/readability-audit.ts +0 -92
  190. package/src/agent/rendered-route-audit.ts +0 -61
  191. package/src/agent/sequence-body.ts +0 -345
  192. package/src/agent/serialize.ts +0 -214
  193. package/src/agent/state-body.ts +0 -589
  194. package/src/agent/structural-count.ts +0 -150
  195. package/src/agent/timeline-body.ts +0 -280
  196. package/src/agent/trace-log.ts +0 -43
  197. package/src/agent/types.ts +0 -995
  198. package/src/agent/verify.ts +0 -603
  199. package/src/agent/xychart-body.ts +0 -472
  200. package/src/architecture/config.ts +0 -282
  201. package/src/architecture/layout.ts +0 -496
  202. package/src/architecture/parser.ts +0 -375
  203. package/src/architecture/renderer.ts +0 -611
  204. package/src/architecture/types.ts +0 -113
  205. package/src/ascii/ansi.ts +0 -423
  206. package/src/ascii/architecture.ts +0 -210
  207. package/src/ascii/canvas.ts +0 -443
  208. package/src/ascii/class-diagram.ts +0 -697
  209. package/src/ascii/converter.ts +0 -475
  210. package/src/ascii/draw.ts +0 -1693
  211. package/src/ascii/edge-bundling.ts +0 -328
  212. package/src/ascii/edge-routing.ts +0 -330
  213. package/src/ascii/er-diagram.ts +0 -439
  214. package/src/ascii/gantt.ts +0 -276
  215. package/src/ascii/grid.ts +0 -747
  216. package/src/ascii/index.ts +0 -196
  217. package/src/ascii/journey.ts +0 -169
  218. package/src/ascii/meta.ts +0 -244
  219. package/src/ascii/multiline-utils.ts +0 -80
  220. package/src/ascii/pathfinder.ts +0 -301
  221. package/src/ascii/pie.ts +0 -67
  222. package/src/ascii/quadrant.ts +0 -158
  223. package/src/ascii/reverse.ts +0 -216
  224. package/src/ascii/sequence.ts +0 -499
  225. package/src/ascii/shapes/circle.ts +0 -27
  226. package/src/ascii/shapes/corners.ts +0 -143
  227. package/src/ascii/shapes/diamond.ts +0 -27
  228. package/src/ascii/shapes/hexagon.ts +0 -27
  229. package/src/ascii/shapes/index.ts +0 -106
  230. package/src/ascii/shapes/rectangle.ts +0 -168
  231. package/src/ascii/shapes/rounded.ts +0 -27
  232. package/src/ascii/shapes/special.ts +0 -332
  233. package/src/ascii/shapes/stadium.ts +0 -110
  234. package/src/ascii/shapes/state.ts +0 -192
  235. package/src/ascii/shapes/types.ts +0 -73
  236. package/src/ascii/timeline.ts +0 -141
  237. package/src/ascii/types.ts +0 -312
  238. package/src/ascii/validate.ts +0 -120
  239. package/src/ascii/width.ts +0 -81
  240. package/src/ascii/wrap.ts +0 -131
  241. package/src/ascii/xychart.ts +0 -919
  242. package/src/browser.ts +0 -29
  243. package/src/class/layout.ts +0 -240
  244. package/src/class/parser.ts +0 -332
  245. package/src/class/renderer.ts +0 -638
  246. package/src/class/types.ts +0 -129
  247. package/src/cli/agent-instructions.ts +0 -1
  248. package/src/cli/am-bin.ts +0 -6
  249. package/src/cli/exit-codes.ts +0 -18
  250. package/src/cli/index.ts +0 -1132
  251. package/src/cli/init-agent.ts +0 -147
  252. package/src/cli/run-entrypoint.ts +0 -10
  253. package/src/color-resolver.ts +0 -152
  254. package/src/elk-instance.ts +0 -114
  255. package/src/er/layout.ts +0 -187
  256. package/src/er/parser.ts +0 -226
  257. package/src/er/renderer.ts +0 -792
  258. package/src/er/types.ts +0 -99
  259. package/src/family-rubric.ts +0 -425
  260. package/src/font-manifest.ts +0 -31
  261. package/src/gantt/layout.ts +0 -365
  262. package/src/gantt/parser.ts +0 -282
  263. package/src/gantt/pipeline.ts +0 -27
  264. package/src/gantt/renderer.ts +0 -414
  265. package/src/gantt/schedule.ts +0 -513
  266. package/src/gantt/types.ts +0 -255
  267. package/src/index.ts +0 -368
  268. package/src/journey/layout.ts +0 -554
  269. package/src/journey/parse-core.ts +0 -251
  270. package/src/journey/parser.ts +0 -101
  271. package/src/journey/renderer.ts +0 -917
  272. package/src/journey/types.ts +0 -144
  273. package/src/layout/geometry.ts +0 -182
  274. package/src/layout/pass.ts +0 -142
  275. package/src/layout/passes/index.ts +0 -3916
  276. package/src/layout-engine.ts +0 -1565
  277. package/src/layout-rubric.ts +0 -659
  278. package/src/mcp/artifacts.ts +0 -137
  279. package/src/mcp/dynamic-harness.ts +0 -31
  280. package/src/mcp/dynamic-modules.d.ts +0 -7
  281. package/src/mcp/facade.ts +0 -608
  282. package/src/mcp/harness-runtime.ts +0 -203
  283. package/src/mcp/hosted-server.ts +0 -468
  284. package/src/mcp/mcp-bin.ts +0 -3
  285. package/src/mcp/mcp-cli.ts +0 -82
  286. package/src/mcp/protocol.ts +0 -13
  287. package/src/mcp/sandbox.ts +0 -195
  288. package/src/mcp/sdk-decl.ts +0 -391
  289. package/src/mcp/server.ts +0 -362
  290. package/src/mcp/tool-surface.ts +0 -146
  291. package/src/mermaid-source.ts +0 -655
  292. package/src/multiline-utils.ts +0 -228
  293. package/src/parser.ts +0 -1031
  294. package/src/pie/layout.ts +0 -168
  295. package/src/pie/parser.ts +0 -136
  296. package/src/pie/renderer.ts +0 -234
  297. package/src/pie/types.ts +0 -82
  298. package/src/quadrant/layout.ts +0 -191
  299. package/src/quadrant/parser.ts +0 -183
  300. package/src/quadrant/renderer.ts +0 -322
  301. package/src/quadrant/types.ts +0 -113
  302. package/src/render-family-hooks.ts +0 -244
  303. package/src/renderer.ts +0 -1099
  304. package/src/route-contracts.ts +0 -2723
  305. package/src/scene/backend.ts +0 -76
  306. package/src/scene/fidelity.ts +0 -183
  307. package/src/scene/hybrid-backend.ts +0 -174
  308. package/src/scene/ir.ts +0 -181
  309. package/src/scene/marks.ts +0 -127
  310. package/src/scene/rough-backend.ts +0 -378
  311. package/src/scene/seed.ts +0 -46
  312. package/src/scene/style-registry.ts +0 -556
  313. package/src/sequence/layout.ts +0 -456
  314. package/src/sequence/parser.ts +0 -255
  315. package/src/sequence/renderer.ts +0 -604
  316. package/src/sequence/types.ts +0 -154
  317. package/src/shape-clipping.ts +0 -351
  318. package/src/shared/accessibility-directives.ts +0 -22
  319. package/src/shared/batched.ts +0 -61
  320. package/src/shared/color-math.ts +0 -93
  321. package/src/shared/svg-a11y.ts +0 -29
  322. package/src/shared/syntax-error.ts +0 -17
  323. package/src/shared/unicode-ranges.ts +0 -135
  324. package/src/styles.ts +0 -318
  325. package/src/svg-paths.ts +0 -28
  326. package/src/text-metrics.ts +0 -248
  327. package/src/theme.ts +0 -710
  328. package/src/timeline/layout.ts +0 -381
  329. package/src/timeline/parser.ts +0 -215
  330. package/src/timeline/renderer.ts +0 -538
  331. package/src/timeline/types.ts +0 -105
  332. package/src/types.ts +0 -462
  333. package/src/website-worker-modules.d.ts +0 -18
  334. package/src/xychart/axis-utils.ts +0 -109
  335. package/src/xychart/colors.ts +0 -124
  336. package/src/xychart/config.ts +0 -88
  337. package/src/xychart/layout.ts +0 -656
  338. package/src/xychart/parser.ts +0 -504
  339. package/src/xychart/renderer.ts +0 -640
  340. 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
- }