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,656 +0,0 @@
1
- import { styleFaceOf } from '../scene/style-registry.ts'
2
- import type {
3
- AxisTick,
4
- GridLine,
5
- PlotArea,
6
- PositionedBar,
7
- PositionedLine,
8
- PositionedXYChart,
9
- ResolvedXYAxisRenderConfig,
10
- ResolvedXYChartConfig,
11
- XYChart,
12
- } from './types.ts'
13
- import type { RenderOptions } from '../types.ts'
14
- import { estimateTextWidth, STROKE_WIDTHS, resolveRenderStyle } from '../styles.ts'
15
- import type { RenderStyleDefaults } from '../styles.ts'
16
- import { resolveXYChartRenderConfig } from './config.ts'
17
- import { formatTickValue, getCategoryLabels, getDataCount, getDataXValues, getPointSpacing, linearTicks } from './axis-utils.ts'
18
-
19
- // ============================================================================
20
- // XY Chart layout engine
21
- //
22
- // Layout is intentionally closer to Mermaid's own xychart builder:
23
- // total width/height are the chart box, plot space is reserved inside that box,
24
- // and axis/title elements compete for the reserved margin space.
25
- // ============================================================================
26
-
27
- const BAR_PADDING_PERCENT = 0.05
28
-
29
- /** Shared by layout (sizing) and renderer (drawing) — keep it single-sourced. */
30
- export const XY_STYLE_DEFAULTS: RenderStyleDefaults = {
31
- nodeLabelFontSize: 14,
32
- edgeLabelFontSize: 16,
33
- groupHeaderFontSize: 20,
34
- nodeLabelFontWeight: 400,
35
- edgeLabelFontWeight: 400,
36
- groupHeaderFontWeight: 500,
37
- nodePaddingX: 0,
38
- nodePaddingY: 0,
39
- nodeLineWidth: 0,
40
- edgeLineWidth: 3, // matches the drawn series stroke (CHART_FONT.lineWidth)
41
- groupCornerRadius: 0,
42
- groupPaddingX: 0,
43
- groupPaddingY: 0,
44
- groupLineWidth: STROKE_WIDTHS.outerBox,
45
- }
46
-
47
- export function layoutXYChart(
48
- chart: XYChart,
49
- options: RenderOptions = {},
50
- ): PositionedXYChart {
51
- const style = resolveRenderStyle(options, XY_STYLE_DEFAULTS)
52
- const config = resolveXYChartRenderConfig(chart.config)
53
- const face = styleFaceOf(options.style)
54
- if (face?.group?.fontSize != null || face?.text?.fontSize != null) {
55
- config.titleFontSize = style.groupHeaderFontSize
56
- }
57
- if (face?.node?.fontSize != null || face?.text?.fontSize != null) {
58
- config.xAxis.labelFontSize = style.nodeLabelFontSize
59
- config.yAxis.labelFontSize = style.nodeLabelFontSize
60
- }
61
- if (face?.edge?.fontSize != null || face?.text?.fontSize != null) {
62
- config.xAxis.titleFontSize = style.edgeLabelFontSize
63
- config.yAxis.titleFontSize = style.edgeLabelFontSize
64
- }
65
- if (face?.edge?.lineWidth != null) {
66
- config.xAxis.axisLineWidth = style.lineWidth
67
- config.yAxis.axisLineWidth = style.lineWidth
68
- config.xAxis.tickWidth = style.lineWidth
69
- config.yAxis.tickWidth = style.lineWidth
70
- }
71
- if (chart.horizontal) return layoutHorizontal(chart, config)
72
- return layoutVertical(chart, config)
73
- }
74
-
75
- function layoutVertical(chart: XYChart, config: ResolvedXYChartConfig): PositionedXYChart {
76
- const totalW = config.width
77
- const totalH = config.height
78
- const dataCount = getDataCount(chart)
79
- const categoryLabels = getCategoryLabels(chart, dataCount)
80
- const dataXValues = getDataXValues(chart, dataCount)
81
- const yRange = chart.yAxis.range!
82
- const yTickValues = linearTicks(yRange.min, yRange.max)
83
- const yTickLabels = yTickValues.map(formatTickValue)
84
- const xTickValues = chart.xAxis.range ? linearTicks(chart.xAxis.range.min, chart.xAxis.range.max) : undefined
85
- const xTickLabels = xTickValues?.map(formatTickValue) ?? categoryLabels
86
-
87
- let remainingTopBottomBudget = Math.max(0, totalH - Math.floor(totalH * config.plotReservedSpacePercent / 100))
88
- let remainingLeftBudget = Math.max(0, totalW - Math.floor(totalW * config.plotReservedSpacePercent / 100))
89
-
90
- const titleHeight = fitChartTitle(chart.title, config, remainingTopBottomBudget)
91
- remainingTopBottomBudget = Math.max(0, remainingTopBottomBudget - titleHeight)
92
-
93
- const xAxisConfig = fitHorizontalAxisConfig(config.xAxis, chart.xAxis.title, xTickLabels, remainingTopBottomBudget)
94
- remainingTopBottomBudget = Math.max(0, remainingTopBottomBudget - xAxisConfig.size)
95
-
96
- const yAxisConfig = fitVerticalAxisConfig(config.yAxis, chart.yAxis.title, yTickLabels, remainingLeftBudget)
97
- remainingLeftBudget = Math.max(0, remainingLeftBudget - yAxisConfig.size)
98
-
99
- const plotArea: PlotArea = {
100
- x: yAxisConfig.size,
101
- y: titleHeight,
102
- width: Math.max(0, totalW - yAxisConfig.size),
103
- height: Math.max(0, totalH - titleHeight - xAxisConfig.size),
104
- }
105
-
106
- const xScaleValue = chart.xAxis.range
107
- ? (value: number) => plotArea.x + ((value - chart.xAxis.range!.min) / (chart.xAxis.range!.max - chart.xAxis.range!.min || 1)) * plotArea.width
108
- : undefined
109
- const xPoint = (index: number) => xScaleValue ? xScaleValue(dataXValues[index]!) : plotArea.x + (index + 0.5) * (plotArea.width / dataCount)
110
- const xPointSpacing = xScaleValue
111
- ? getPointSpacing(dataXValues, xScaleValue, plotArea.width / Math.max(2, dataCount))
112
- : plotArea.width / Math.max(1, dataCount)
113
- const yScale = (value: number) => plotArea.y + plotArea.height - ((value - yRange.min) / (yRange.max - yRange.min || 1)) * plotArea.height
114
-
115
- const xTicks = !xAxisConfig.config.showLabel
116
- ? []
117
- : chart.xAxis.range && xTickValues && xScaleValue
118
- ? buildBottomAxisTicks(xTickValues, xTickLabels, xScaleValue, plotArea, xAxisConfig.config, totalW)
119
- : buildBottomAxisTicks(
120
- categoryLabels.map((_, index) => index),
121
- categoryLabels,
122
- xPoint,
123
- plotArea,
124
- xAxisConfig.config,
125
- totalW,
126
- )
127
- const yTicks = yAxisConfig.config.showLabel
128
- ? buildLeftAxisTicks(
129
- yTickValues,
130
- yTickLabels,
131
- yScale,
132
- plotArea,
133
- yAxisConfig.config,
134
- )
135
- : []
136
-
137
- const gridLines: GridLine[] = yTickValues.map(value => ({
138
- x1: plotArea.x,
139
- y1: yScale(value),
140
- x2: plotArea.x + plotArea.width,
141
- y2: yScale(value),
142
- }))
143
-
144
- const colorMap = chart.series.map((_, index) => index)
145
- const bars = layoutVerticalBars(chart, xPoint, xPointSpacing, yScale, yRange.min, categoryLabels, colorMap)
146
- const lines = layoutVerticalLines(chart, xPoint, yScale, categoryLabels, colorMap)
147
-
148
- return {
149
- width: totalW,
150
- height: totalH,
151
- accessibility: chart.accessibility,
152
- title: titleHeight > 0 && chart.title
153
- ? { text: chart.title, x: totalW / 2, y: config.titlePadding + config.titleFontSize }
154
- : undefined,
155
- xAxis: {
156
- ticks: xTicks,
157
- line: buildBottomAxisLine(plotArea, xAxisConfig.config),
158
- title: buildBottomAxisTitle(chart.xAxis.title, plotArea, totalH, xAxisConfig.config),
159
- config: xAxisConfig.config,
160
- },
161
- yAxis: {
162
- ticks: yTicks,
163
- line: buildLeftAxisLine(plotArea, yAxisConfig.config),
164
- title: buildLeftAxisTitle(chart.yAxis.title, plotArea, yAxisConfig.config),
165
- config: yAxisConfig.config,
166
- },
167
- plotArea,
168
- bars,
169
- lines,
170
- gridLines,
171
- legend: [],
172
- config,
173
- theme: chart.theme,
174
- }
175
- }
176
-
177
- function layoutHorizontal(chart: XYChart, config: ResolvedXYChartConfig): PositionedXYChart {
178
- const totalW = config.width
179
- const totalH = config.height
180
- const dataCount = getDataCount(chart)
181
- const categoryLabels = getCategoryLabels(chart, dataCount)
182
- const yRange = chart.yAxis.range!
183
- const valueTickValues = linearTicks(yRange.min, yRange.max)
184
- const valueTickLabels = valueTickValues.map(formatTickValue)
185
-
186
- let remainingTopBottomBudget = Math.max(0, totalH - Math.floor(totalH * config.plotReservedSpacePercent / 100))
187
- let remainingLeftBudget = Math.max(0, totalW - Math.floor(totalW * config.plotReservedSpacePercent / 100))
188
-
189
- const titleHeight = fitChartTitle(chart.title, config, remainingTopBottomBudget)
190
- remainingTopBottomBudget = Math.max(0, remainingTopBottomBudget - titleHeight)
191
-
192
- // Mermaid places the numeric value axis at the top in horizontal mode.
193
- const topAxisConfig = fitTopAxisConfig(config.yAxis, chart.yAxis.title, valueTickLabels, remainingTopBottomBudget)
194
- remainingTopBottomBudget = Math.max(0, remainingTopBottomBudget - topAxisConfig.size)
195
-
196
- const leftAxisConfig = fitVerticalAxisConfig(config.xAxis, chart.xAxis.title, categoryLabels, remainingLeftBudget)
197
- remainingLeftBudget = Math.max(0, remainingLeftBudget - leftAxisConfig.size)
198
-
199
- const plotArea: PlotArea = {
200
- x: leftAxisConfig.size,
201
- y: titleHeight + topAxisConfig.size,
202
- width: Math.max(0, totalW - leftAxisConfig.size),
203
- height: Math.max(0, totalH - titleHeight - topAxisConfig.size),
204
- }
205
-
206
- const valueScale = (value: number) => plotArea.x + ((value - yRange.min) / (yRange.max - yRange.min || 1)) * plotArea.width
207
- const categoryPoint = (index: number) => plotArea.y + (index + 0.5) * (plotArea.height / dataCount)
208
- const categorySpacing = plotArea.height / Math.max(1, dataCount)
209
-
210
- const topTicks = topAxisConfig.config.showLabel
211
- ? buildTopAxisTicks(valueTickValues, valueTickLabels, valueScale, plotArea, topAxisConfig.config)
212
- : []
213
- const leftTicks = leftAxisConfig.config.showLabel
214
- ? buildLeftAxisTicks(
215
- categoryLabels.map((_, index) => index),
216
- categoryLabels,
217
- categoryPoint,
218
- plotArea,
219
- leftAxisConfig.config,
220
- )
221
- : []
222
-
223
- const gridLines: GridLine[] = valueTickValues.map(value => ({
224
- x1: valueScale(value),
225
- y1: plotArea.y,
226
- x2: valueScale(value),
227
- y2: plotArea.y + plotArea.height,
228
- }))
229
-
230
- const colorMap = chart.series.map((_, index) => index)
231
- const bars = layoutHorizontalBars(chart, categoryPoint, categorySpacing, valueScale, yRange.min, categoryLabels, colorMap)
232
- const lines = layoutHorizontalLines(chart, categoryPoint, valueScale, categoryLabels, colorMap)
233
-
234
- return {
235
- width: totalW,
236
- height: totalH,
237
- accessibility: chart.accessibility,
238
- horizontal: true,
239
- title: titleHeight > 0 && chart.title
240
- ? { text: chart.title, x: totalW / 2, y: config.titlePadding + config.titleFontSize }
241
- : undefined,
242
- xAxis: {
243
- ticks: leftTicks,
244
- line: buildLeftAxisLine(plotArea, leftAxisConfig.config),
245
- title: buildLeftAxisTitle(chart.xAxis.title, plotArea, leftAxisConfig.config),
246
- config: leftAxisConfig.config,
247
- },
248
- yAxis: {
249
- ticks: topTicks,
250
- line: buildTopAxisLine(plotArea, topAxisConfig.config),
251
- title: buildTopAxisTitle(chart.yAxis.title, plotArea, titleHeight, topAxisConfig.config),
252
- config: topAxisConfig.config,
253
- },
254
- plotArea,
255
- bars,
256
- lines,
257
- gridLines,
258
- legend: [],
259
- config,
260
- theme: chart.theme,
261
- }
262
- }
263
-
264
- function fitChartTitle(title: string | undefined, config: ResolvedXYChartConfig, budget: number): number {
265
- if (!title || !config.showTitle) return 0
266
- const required = config.titleFontSize + config.titlePadding * 2
267
- return required <= budget ? required : 0
268
- }
269
-
270
- function fitHorizontalAxisConfig(
271
- config: ResolvedXYAxisRenderConfig,
272
- title: string | undefined,
273
- labels: string[],
274
- budget: number,
275
- ): { config: ResolvedXYAxisRenderConfig; size: number } {
276
- let remaining = budget
277
- const fitted: ResolvedXYAxisRenderConfig = { ...config, showAxisLine: false, showLabel: false, showTick: false, showTitle: false }
278
-
279
- if (config.showAxisLine && remaining > config.axisLineWidth) {
280
- fitted.showAxisLine = true
281
- remaining -= config.axisLineWidth
282
- }
283
- if (config.showLabel) {
284
- const required = config.labelFontSize + config.labelPadding * 2
285
- if (required <= remaining && labels.length > 0) {
286
- fitted.showLabel = true
287
- remaining -= required
288
- }
289
- }
290
- if (config.showTick && remaining >= config.tickLength) {
291
- fitted.showTick = true
292
- remaining -= config.tickLength
293
- }
294
- if (config.showTitle && title) {
295
- const required = config.titleFontSize + config.titlePadding * 2
296
- if (required <= remaining) {
297
- fitted.showTitle = true
298
- remaining -= required
299
- }
300
- }
301
-
302
- return { config: fitted, size: budget - remaining }
303
- }
304
-
305
- function fitTopAxisConfig(
306
- config: ResolvedXYAxisRenderConfig,
307
- title: string | undefined,
308
- labels: string[],
309
- budget: number,
310
- ): { config: ResolvedXYAxisRenderConfig; size: number } {
311
- return fitHorizontalAxisConfig(config, title, labels, budget)
312
- }
313
-
314
- function fitVerticalAxisConfig(
315
- config: ResolvedXYAxisRenderConfig,
316
- title: string | undefined,
317
- labels: string[],
318
- budget: number,
319
- ): { config: ResolvedXYAxisRenderConfig; size: number } {
320
- let remaining = budget
321
- const fitted: ResolvedXYAxisRenderConfig = { ...config, showAxisLine: false, showLabel: false, showTick: false, showTitle: false }
322
-
323
- if (config.showAxisLine && remaining > config.axisLineWidth) {
324
- fitted.showAxisLine = true
325
- remaining -= config.axisLineWidth
326
- }
327
- if (config.showLabel && labels.length > 0) {
328
- const maxLabelWidth = Math.max(...labels.map(label => estimateTextWidth(label, config.labelFontSize, 400)))
329
- const required = maxLabelWidth + config.labelPadding * 2
330
- if (required <= remaining) {
331
- fitted.showLabel = true
332
- remaining -= required
333
- }
334
- }
335
- if (config.showTick && remaining >= config.tickLength) {
336
- fitted.showTick = true
337
- remaining -= config.tickLength
338
- }
339
- if (config.showTitle && title) {
340
- const required = config.titleFontSize + config.titlePadding * 2
341
- if (required <= remaining) {
342
- fitted.showTitle = true
343
- remaining -= required
344
- }
345
- }
346
-
347
- return { config: fitted, size: budget - remaining }
348
- }
349
-
350
- function buildBottomAxisTicks<T extends string | number>(
351
- values: T[],
352
- labels: string[],
353
- scale: (value: T) => number,
354
- plotArea: PlotArea,
355
- config: ResolvedXYAxisRenderConfig,
356
- totalWidth?: number,
357
- ): AxisTick[] {
358
- const lineOffset = config.showAxisLine ? config.axisLineWidth : 0
359
- const tickOffset = config.showTick ? config.tickLength : 0
360
- const labelY = plotArea.y + plotArea.height + lineOffset + tickOffset + config.labelPadding + config.labelFontSize
361
-
362
- // Deterministic tick-label thinning: centered labels garble into each other
363
- // when the widest label plus a readability gap exceeds the tick spacing
364
- // (2026-07 overlap audit: 28% of fuzzed charts). Keep every k-th label
365
- // (tick marks stay); k is measured, not guessed, so short labels never thin.
366
- const widths = labels.map(label => estimateTextWidth(label, config.labelFontSize, 400))
367
- const maxW = widths.length ? Math.max(...widths) : 0
368
- const xs = values.map(value => scale(value))
369
- let minSpacing = Infinity
370
- for (let i = 1; i < xs.length; i++) minSpacing = Math.min(minSpacing, Math.abs(xs[i]! - xs[i - 1]!))
371
- const keepEvery = Number.isFinite(minSpacing) && minSpacing > 0 ? Math.max(1, Math.ceil((maxW + 6) / minSpacing)) : 1
372
-
373
- return values.map((value, index) => {
374
- const label = index % keepEvery === 0 ? labels[index]! : ''
375
- // Clamp the label box inside the canvas: the last tick sits AT the plot's
376
- // right edge and a centered label pokes past the right padding otherwise.
377
- let labelX = scale(value)
378
- if (totalWidth !== undefined && label) {
379
- const half = widths[index]! / 2
380
- labelX = Math.max(2 + half, Math.min(totalWidth - 2 - half, labelX))
381
- }
382
- return {
383
- label,
384
- x: scale(value),
385
- y: plotArea.y + plotArea.height + lineOffset,
386
- tx: scale(value),
387
- ty: plotArea.y + plotArea.height + lineOffset + tickOffset,
388
- labelX,
389
- labelY,
390
- textAnchor: 'middle' as const,
391
- }
392
- })
393
- }
394
-
395
- function buildTopAxisTicks(
396
- values: number[],
397
- labels: string[],
398
- scale: (value: number) => number,
399
- plotArea: PlotArea,
400
- config: ResolvedXYAxisRenderConfig,
401
- ): AxisTick[] {
402
- const lineOffset = config.showAxisLine ? config.axisLineWidth : 0
403
- const tickOffset = config.showTick ? config.tickLength : 0
404
- const labelY = plotArea.y - lineOffset - tickOffset - config.labelPadding
405
-
406
- return values.map((value, index) => ({
407
- label: labels[index]!,
408
- x: scale(value),
409
- y: plotArea.y - lineOffset,
410
- tx: scale(value),
411
- ty: plotArea.y - lineOffset - tickOffset,
412
- labelX: scale(value),
413
- labelY,
414
- textAnchor: 'middle',
415
- }))
416
- }
417
-
418
- function buildLeftAxisTicks<T extends string | number>(
419
- values: T[],
420
- labels: string[],
421
- scale: (value: T) => number,
422
- plotArea: PlotArea,
423
- config: ResolvedXYAxisRenderConfig,
424
- ): AxisTick[] {
425
- const lineOffset = config.showAxisLine ? config.axisLineWidth : 0
426
- const tickOffset = config.showTick ? config.tickLength : 0
427
- const labelX = plotArea.x - lineOffset - tickOffset - config.labelPadding
428
-
429
- return values.map((value, index) => ({
430
- label: labels[index]!,
431
- x: plotArea.x - lineOffset,
432
- y: scale(value),
433
- tx: plotArea.x - lineOffset - tickOffset,
434
- ty: scale(value),
435
- labelX,
436
- labelY: scale(value),
437
- textAnchor: 'end',
438
- }))
439
- }
440
-
441
- function buildBottomAxisLine(plotArea: PlotArea, config: ResolvedXYAxisRenderConfig) {
442
- const y = plotArea.y + plotArea.height + (config.showAxisLine ? config.axisLineWidth / 2 : 0)
443
- return { x1: plotArea.x, y1: y, x2: plotArea.x + plotArea.width, y2: y }
444
- }
445
-
446
- function buildTopAxisLine(plotArea: PlotArea, config: ResolvedXYAxisRenderConfig) {
447
- const y = plotArea.y - (config.showAxisLine ? config.axisLineWidth / 2 : 0)
448
- return { x1: plotArea.x, y1: y, x2: plotArea.x + plotArea.width, y2: y }
449
- }
450
-
451
- function buildLeftAxisLine(plotArea: PlotArea, config: ResolvedXYAxisRenderConfig) {
452
- const x = plotArea.x - (config.showAxisLine ? config.axisLineWidth / 2 : 0)
453
- return { x1: x, y1: plotArea.y, x2: x, y2: plotArea.y + plotArea.height }
454
- }
455
-
456
- function buildBottomAxisTitle(
457
- title: string | undefined,
458
- plotArea: PlotArea,
459
- totalHeight: number,
460
- config: ResolvedXYAxisRenderConfig,
461
- ) {
462
- if (!title || !config.showTitle) return undefined
463
- return {
464
- text: title,
465
- x: plotArea.x + plotArea.width / 2,
466
- y: totalHeight - config.titlePadding,
467
- }
468
- }
469
-
470
- function buildTopAxisTitle(
471
- title: string | undefined,
472
- plotArea: PlotArea,
473
- titleHeight: number,
474
- config: ResolvedXYAxisRenderConfig,
475
- ) {
476
- if (!title || !config.showTitle) return undefined
477
- return {
478
- text: title,
479
- x: plotArea.x + plotArea.width / 2,
480
- y: titleHeight + config.titlePadding + config.titleFontSize,
481
- }
482
- }
483
-
484
- function buildLeftAxisTitle(
485
- title: string | undefined,
486
- plotArea: PlotArea,
487
- config: ResolvedXYAxisRenderConfig,
488
- ) {
489
- if (!title || !config.showTitle) return undefined
490
- return {
491
- text: title,
492
- x: config.titlePadding + config.titleFontSize * 0.8,
493
- y: plotArea.y + plotArea.height / 2,
494
- rotate: -90,
495
- }
496
- }
497
-
498
- function layoutVerticalBars(
499
- chart: XYChart,
500
- xPoint: (index: number) => number,
501
- pointSpacing: number,
502
- yScale: (value: number) => number,
503
- baselineValue: number,
504
- labels: string[],
505
- colorMap: number[],
506
- ): PositionedBar[] {
507
- const barSeries = chart.series.filter(series => series.type === 'bar')
508
- const barCount = barSeries.length
509
- if (barCount === 0) return []
510
-
511
- const usableWidth = pointSpacing * (1 - BAR_PADDING_PERCENT)
512
- const barWidth = usableWidth / Math.max(1, barCount)
513
- const bars: PositionedBar[] = []
514
-
515
- let barSeriesIndex = 0
516
- let seriesArrayIndex = 0
517
- const baselineY = yScale(baselineValue)
518
-
519
- for (const series of chart.series) {
520
- if (series.type !== 'bar') {
521
- seriesArrayIndex++
522
- continue
523
- }
524
- for (let i = 0; i < series.data.length; i++) {
525
- const x = xPoint(i) - usableWidth / 2 + barSeriesIndex * barWidth
526
- const valueY = yScale(series.data[i]!)
527
- bars.push({
528
- x,
529
- y: Math.min(valueY, baselineY),
530
- width: barWidth,
531
- height: Math.abs(baselineY - valueY),
532
- value: series.data[i]!,
533
- label: labels[i]!,
534
- seriesIndex: barSeriesIndex,
535
- colorIndex: colorMap[seriesArrayIndex]!,
536
- })
537
- }
538
- barSeriesIndex++
539
- seriesArrayIndex++
540
- }
541
-
542
- return bars
543
- }
544
-
545
- function layoutHorizontalBars(
546
- chart: XYChart,
547
- yPoint: (index: number) => number,
548
- pointSpacing: number,
549
- xScale: (value: number) => number,
550
- baselineValue: number,
551
- labels: string[],
552
- colorMap: number[],
553
- ): PositionedBar[] {
554
- const barSeries = chart.series.filter(series => series.type === 'bar')
555
- const barCount = barSeries.length
556
- if (barCount === 0) return []
557
-
558
- const usableHeight = pointSpacing * (1 - BAR_PADDING_PERCENT)
559
- const barHeight = usableHeight / Math.max(1, barCount)
560
- const bars: PositionedBar[] = []
561
-
562
- let barSeriesIndex = 0
563
- let seriesArrayIndex = 0
564
- const baselineX = xScale(baselineValue)
565
-
566
- for (const series of chart.series) {
567
- if (series.type !== 'bar') {
568
- seriesArrayIndex++
569
- continue
570
- }
571
- for (let i = 0; i < series.data.length; i++) {
572
- const y = yPoint(i) - usableHeight / 2 + barSeriesIndex * barHeight
573
- const valueX = xScale(series.data[i]!)
574
- bars.push({
575
- x: Math.min(valueX, baselineX),
576
- y,
577
- width: Math.abs(valueX - baselineX),
578
- height: barHeight,
579
- value: series.data[i]!,
580
- label: labels[i]!,
581
- seriesIndex: barSeriesIndex,
582
- colorIndex: colorMap[seriesArrayIndex]!,
583
- })
584
- }
585
- barSeriesIndex++
586
- seriesArrayIndex++
587
- }
588
-
589
- return bars
590
- }
591
-
592
- function layoutVerticalLines(
593
- chart: XYChart,
594
- xPoint: (index: number) => number,
595
- yScale: (value: number) => number,
596
- labels: string[],
597
- colorMap: number[],
598
- ): PositionedLine[] {
599
- const lines: PositionedLine[] = []
600
- let lineSeriesIndex = 0
601
- let seriesArrayIndex = 0
602
-
603
- for (const series of chart.series) {
604
- if (series.type !== 'line') {
605
- seriesArrayIndex++
606
- continue
607
- }
608
- lines.push({
609
- points: series.data.map((value, index) => ({
610
- x: xPoint(index),
611
- y: yScale(value),
612
- value,
613
- label: labels[index]!,
614
- })),
615
- seriesIndex: lineSeriesIndex,
616
- colorIndex: colorMap[seriesArrayIndex]!,
617
- })
618
- lineSeriesIndex++
619
- seriesArrayIndex++
620
- }
621
-
622
- return lines
623
- }
624
-
625
- function layoutHorizontalLines(
626
- chart: XYChart,
627
- yPoint: (index: number) => number,
628
- xScale: (value: number) => number,
629
- labels: string[],
630
- colorMap: number[],
631
- ): PositionedLine[] {
632
- const lines: PositionedLine[] = []
633
- let lineSeriesIndex = 0
634
- let seriesArrayIndex = 0
635
-
636
- for (const series of chart.series) {
637
- if (series.type !== 'line') {
638
- seriesArrayIndex++
639
- continue
640
- }
641
- lines.push({
642
- points: series.data.map((value, index) => ({
643
- x: xScale(value),
644
- y: yPoint(index),
645
- value,
646
- label: labels[index]!,
647
- })),
648
- seriesIndex: lineSeriesIndex,
649
- colorIndex: colorMap[seriesArrayIndex]!,
650
- })
651
- lineSeriesIndex++
652
- seriesArrayIndex++
653
- }
654
-
655
- return lines
656
- }