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.
- package/AGENT_NATIVE.md +155 -91
- package/CHANGELOG.md +163 -4
- package/Instructions_for_agents.md +10 -10
- package/LICENSES/Apache-2.0.txt +202 -0
- package/README.md +31 -38
- package/THIRD_PARTY_NOTICES.md +29 -0
- package/assets/hero.png +0 -0
- package/dist/agent-core.d.ts +463 -0
- package/dist/agent-core.js +397 -0
- package/dist/agent.d.ts +73 -1868
- package/dist/agent.js +336 -37325
- package/dist/agentic-mermaid-mcp.js +7 -38399
- package/dist/am.js +33626 -40446
- package/dist/chunk-2P5FKUQC.js +3485 -0
- package/dist/chunk-2S3VSS6I.js +149 -0
- package/dist/chunk-2SILJDW2.js +37 -0
- package/dist/chunk-BJYMBT4I.js +61963 -0
- package/dist/chunk-FDM43XU7.js +615 -0
- package/dist/chunk-MYPDVZCO.js +4702 -0
- package/dist/index-DWPa2MJs.d.ts +6780 -0
- package/dist/index.d.ts +1 -1
- package/dist/index.js +310 -33014
- package/dist/mcp-cli-5J47WEY3.js +17 -0
- package/docs/README.md +39 -31
- package/docs/agent-api-cookbook.md +44 -35
- package/docs/agent-mutation-policy.md +1 -1
- package/docs/agent-workflow-examples.md +2 -2
- package/docs/api.md +284 -77
- package/docs/ascii.md +26 -16
- package/docs/code-mode-impact.md +214 -0
- package/docs/comparison.md +23 -11
- package/docs/computational-aesthetics-prototype-plan.md +252 -0
- package/docs/config.md +26 -10
- package/docs/custom-fonts.md +265 -0
- package/docs/custom-style-cookbook.md +130 -9
- package/docs/diagram-families.md +48 -23
- package/docs/features.md +59 -52
- package/docs/fork-differences.md +6 -3
- package/docs/getting-started.md +23 -16
- package/docs/issue-derived-test-cases.md +29 -22
- package/docs/mcp-code-mode-rationale.md +13 -6
- package/docs/mcp-http-transport.md +20 -13
- package/docs/mermaid-layout-complaints.md +66 -52
- package/docs/mutation-testing.md +145 -66
- package/docs/quality.md +23 -14
- package/docs/react.md +2 -2
- package/docs/schemas/style-spec.schema.json +1221 -30
- package/docs/style-authoring.md +241 -38
- package/docs/svg-semantic-contract.md +49 -0
- package/docs/testing-strategy.md +166 -58
- package/docs/theming.md +19 -32
- package/examples/styles/catalog.json +54 -0
- package/examples/styles/cloudflare-workers-inspired-prototype.mmd +9 -0
- package/examples/styles/cloudflare-workers-inspired-prototype.style.json +110 -0
- package/examples/styles/cupertino-prototype.mmd +10 -0
- package/examples/styles/cupertino-prototype.style.json +63 -0
- package/examples/styles/mid-century-report.style.json +2 -2
- package/examples/styles/star-chart-atlas.style.json +2 -1
- package/examples/styles/transit-route-map.style.json +2 -2
- package/examples/styles/vercel-inspired-prototype.mmd +6 -0
- package/examples/styles/vercel-inspired-prototype.style.json +87 -0
- package/package.json +85 -45
- package/server.json +2 -2
- package/skills/agentic-mermaid-diagram-workflow/SKILL.md +17 -36
- package/skills/agentic-mermaid-diagram-workflow/references/cli.md +4 -5
- package/skills/agentic-mermaid-diagram-workflow/references/code-mode.md +15 -31
- package/skills/agentic-mermaid-diagram-workflow/references/sequence.md +10 -14
- package/skills/agentic-mermaid-live-editor/SKILL.md +100 -206
- package/TODO.md +0 -684
- package/dist/index-wjRjbsP-.d.ts +0 -1102
- package/docs/assets/improvements/box-start-connector.png +0 -0
- package/docs/assets/improvements/comment-dropped-lint.png +0 -0
- package/docs/assets/improvements/er-content-loss.png +0 -0
- package/docs/assets/improvements/fan-in-trunks.png +0 -0
- package/docs/assets/improvements/gantt-family.png +0 -0
- package/docs/assets/improvements/gantt-milestone-clamp.png +0 -0
- package/docs/assets/improvements/gantt-verify-seam.png +0 -0
- package/docs/assets/improvements/subgraph-container-edges.png +0 -0
- package/docs/assets/improvements/wrapper-frontmatter.png +0 -0
- package/docs/assets/improvements/wrapper-init-directive.png +0 -0
- package/docs/assets/improvements/wrapper-leading-comment.png +0 -0
- package/docs/assets/style-cookbook/mid-century-report.png +0 -0
- package/docs/assets/style-cookbook/star-chart-atlas.png +0 -0
- package/docs/assets/style-cookbook/transit-route-map.png +0 -0
- package/docs/contributing/adding-diagram-types.md +0 -144
- package/docs/contributing/diagram-family-citizenship.matrix.json +0 -2127
- package/docs/contributing/diagram-family-citizenship.md +0 -82
- package/docs/contributing/harvesting-upstream-tests.md +0 -126
- package/docs/contributing/lessons-learned.md +0 -276
- package/docs/contributing/releasing.md +0 -82
- package/docs/contributing/visual-review-evidence.md +0 -53
- package/docs/design/families/README.md +0 -26
- package/docs/design/families/architecture-beta.md +0 -48
- package/docs/design/families/flowchart-parser-conformance.md +0 -22
- package/docs/design/families/gantt-research.md +0 -137
- package/docs/design/families/gantt.md +0 -329
- package/docs/design/families/journey-agentic-cards-before.png +0 -0
- package/docs/design/families/journey-experience-curve-implementation.png +0 -0
- package/docs/design/families/journey-mermaid-classic-implementation.png +0 -0
- package/docs/design/families/journey-mermaid-classic-prototype.png +0 -0
- package/docs/design/families/journey-mermaid-classic-prototype.svg +0 -163
- package/docs/design/families/journey-mermaid-classic-prototype.svg.png +0 -0
- package/docs/design/families/journey-migration-parity.md +0 -439
- package/docs/design/families/journey-section-overlap-after.png +0 -0
- package/docs/design/families/journey-section-overlap-before.png +0 -0
- package/docs/design/families/journey-usage-research.md +0 -423
- package/docs/design/families/journey.md +0 -153
- package/docs/design/families/xychart.md +0 -85
- package/docs/design/system/README.md +0 -45
- package/docs/design/system/abstraction-audit.md +0 -224
- package/docs/design/system/abstraction-recommendations.md +0 -655
- package/docs/design/system/architecture.mmd +0 -29
- package/docs/design/system/architecture.svg +0 -137
- package/docs/design/system/layout-guarantees-and-robustness.md +0 -351
- package/docs/design/system/layout-rubric.md +0 -138
- package/docs/design/system/route-contracts.md +0 -848
- package/docs/design/system/source-preservation-ladder.md +0 -52
- package/docs/design/system/styles-rollout.md +0 -216
- package/docs/design/system/ugly-layouts.md +0 -119
- package/docs/layout-characterization/README.md +0 -245
- package/docs/layout-characterization/contact-sheet-families.md +0 -498
- package/docs/layout-characterization/contact-sheet.md +0 -638
- package/docs/layout-characterization/properties.md +0 -281
- package/docs/layout-characterization/visual-quality.md +0 -160
- package/docs/layout-characterization/visual-snapshots/architecture.svg +0 -79
- package/docs/layout-characterization/visual-snapshots/class.svg +0 -60
- package/docs/layout-characterization/visual-snapshots/er.svg +0 -61
- package/docs/layout-characterization/visual-snapshots/flowchart.svg +0 -58
- package/docs/layout-characterization/visual-snapshots/gantt.svg +0 -52
- package/docs/layout-characterization/visual-snapshots/journey.svg +0 -98
- package/docs/layout-characterization/visual-snapshots/pie.svg +0 -36
- package/docs/layout-characterization/visual-snapshots/quadrant.svg +0 -47
- package/docs/layout-characterization/visual-snapshots/sequence.svg +0 -59
- package/docs/layout-characterization/visual-snapshots/state.svg +0 -52
- package/docs/layout-characterization/visual-snapshots/timeline.svg +0 -64
- package/docs/layout-characterization/visual-snapshots/xychart.svg +0 -97
- package/docs/project/divergences.md +0 -98
- package/docs/project/dogfooding-docs-strategy.md +0 -66
- package/docs/project/hosted-mcp-cloudflare-plan.md +0 -338
- package/docs/project/lessons-learned.md +0 -1019
- package/docs/project/remove-role-styling-plan.md +0 -176
- package/examples/agent-improve-auth-flow.ts +0 -206
- package/examples/agent-loop.ts +0 -53
- package/examples/mcp-vs-cli-complex-diagrams.ts +0 -133
- package/llms.txt +0 -104
- package/skill-evals/README.md +0 -77
- package/skill-evals/fixtures/architecture-cache/input.mmd +0 -5
- package/skill-evals/fixtures/class-payment/input.mmd +0 -4
- package/skill-evals/fixtures/er-orders/input.mmd +0 -10
- package/skill-evals/fixtures/flowchart-cache/input.mmd +0 -3
- package/skill-evals/fixtures/gantt-release/input.mmd +0 -7
- package/skill-evals/fixtures/journey-checkout/input.mmd +0 -6
- package/skill-evals/fixtures/pie-exports/input.mmd +0 -5
- package/skill-evals/fixtures/quadrant-priorities/input.mmd +0 -11
- package/skill-evals/fixtures/sequence-retry/input.mmd +0 -8
- package/skill-evals/fixtures/state-lifecycle/input.mmd +0 -5
- package/skill-evals/fixtures/timeline-release/input.mmd +0 -6
- package/skill-evals/fixtures/xychart-growth/input.mmd +0 -5
- package/skill-evals/shared-benchmark.json +0 -510
- package/src/agent/analyze.ts +0 -157
- package/src/agent/apply.ts +0 -146
- package/src/agent/architecture-body.ts +0 -458
- package/src/agent/certificates.ts +0 -110
- package/src/agent/class-body.ts +0 -319
- package/src/agent/core.ts +0 -207
- package/src/agent/create.ts +0 -106
- package/src/agent/describe.ts +0 -368
- package/src/agent/er-body.ts +0 -224
- package/src/agent/facts.ts +0 -360
- package/src/agent/families-builtin.ts +0 -920
- package/src/agent/families.ts +0 -232
- package/src/agent/family-layouts.ts +0 -832
- package/src/agent/flowchart-body.ts +0 -372
- package/src/agent/flowchart-unsupported.ts +0 -243
- package/src/agent/font-coverage.ts +0 -288
- package/src/agent/gantt-body.ts +0 -495
- package/src/agent/index.ts +0 -10
- package/src/agent/journey-body.ts +0 -374
- package/src/agent/label-metrics.ts +0 -28
- package/src/agent/layout-to-rendered.ts +0 -63
- package/src/agent/mutate.ts +0 -97
- package/src/agent/mutation-ops.ts +0 -51
- package/src/agent/op-schema.ts +0 -443
- package/src/agent/parse.ts +0 -223
- package/src/agent/pie-body.ts +0 -270
- package/src/agent/png.ts +0 -171
- package/src/agent/quadrant-body.ts +0 -336
- package/src/agent/quality.ts +0 -363
- package/src/agent/readability-audit.ts +0 -92
- package/src/agent/rendered-route-audit.ts +0 -61
- package/src/agent/sequence-body.ts +0 -345
- package/src/agent/serialize.ts +0 -214
- package/src/agent/state-body.ts +0 -589
- package/src/agent/structural-count.ts +0 -150
- package/src/agent/timeline-body.ts +0 -280
- package/src/agent/trace-log.ts +0 -43
- package/src/agent/types.ts +0 -995
- package/src/agent/verify.ts +0 -603
- package/src/agent/xychart-body.ts +0 -472
- package/src/architecture/config.ts +0 -282
- package/src/architecture/layout.ts +0 -496
- package/src/architecture/parser.ts +0 -375
- package/src/architecture/renderer.ts +0 -611
- package/src/architecture/types.ts +0 -113
- package/src/ascii/ansi.ts +0 -423
- package/src/ascii/architecture.ts +0 -210
- package/src/ascii/canvas.ts +0 -443
- package/src/ascii/class-diagram.ts +0 -697
- package/src/ascii/converter.ts +0 -475
- package/src/ascii/draw.ts +0 -1693
- package/src/ascii/edge-bundling.ts +0 -328
- package/src/ascii/edge-routing.ts +0 -330
- package/src/ascii/er-diagram.ts +0 -439
- package/src/ascii/gantt.ts +0 -276
- package/src/ascii/grid.ts +0 -747
- package/src/ascii/index.ts +0 -196
- package/src/ascii/journey.ts +0 -169
- package/src/ascii/meta.ts +0 -244
- package/src/ascii/multiline-utils.ts +0 -80
- package/src/ascii/pathfinder.ts +0 -301
- package/src/ascii/pie.ts +0 -67
- package/src/ascii/quadrant.ts +0 -158
- package/src/ascii/reverse.ts +0 -216
- package/src/ascii/sequence.ts +0 -499
- package/src/ascii/shapes/circle.ts +0 -27
- package/src/ascii/shapes/corners.ts +0 -143
- package/src/ascii/shapes/diamond.ts +0 -27
- package/src/ascii/shapes/hexagon.ts +0 -27
- package/src/ascii/shapes/index.ts +0 -106
- package/src/ascii/shapes/rectangle.ts +0 -168
- package/src/ascii/shapes/rounded.ts +0 -27
- package/src/ascii/shapes/special.ts +0 -332
- package/src/ascii/shapes/stadium.ts +0 -110
- package/src/ascii/shapes/state.ts +0 -192
- package/src/ascii/shapes/types.ts +0 -73
- package/src/ascii/timeline.ts +0 -141
- package/src/ascii/types.ts +0 -312
- package/src/ascii/validate.ts +0 -120
- package/src/ascii/width.ts +0 -81
- package/src/ascii/wrap.ts +0 -131
- package/src/ascii/xychart.ts +0 -919
- package/src/browser.ts +0 -29
- package/src/class/layout.ts +0 -240
- package/src/class/parser.ts +0 -332
- package/src/class/renderer.ts +0 -638
- package/src/class/types.ts +0 -129
- package/src/cli/agent-instructions.ts +0 -1
- package/src/cli/am-bin.ts +0 -6
- package/src/cli/exit-codes.ts +0 -18
- package/src/cli/index.ts +0 -1132
- package/src/cli/init-agent.ts +0 -147
- package/src/cli/run-entrypoint.ts +0 -10
- package/src/color-resolver.ts +0 -152
- package/src/elk-instance.ts +0 -114
- package/src/er/layout.ts +0 -187
- package/src/er/parser.ts +0 -226
- package/src/er/renderer.ts +0 -792
- package/src/er/types.ts +0 -99
- package/src/family-rubric.ts +0 -425
- package/src/font-manifest.ts +0 -31
- package/src/gantt/layout.ts +0 -365
- package/src/gantt/parser.ts +0 -282
- package/src/gantt/pipeline.ts +0 -27
- package/src/gantt/renderer.ts +0 -414
- package/src/gantt/schedule.ts +0 -513
- package/src/gantt/types.ts +0 -255
- package/src/index.ts +0 -368
- package/src/journey/layout.ts +0 -554
- package/src/journey/parse-core.ts +0 -251
- package/src/journey/parser.ts +0 -101
- package/src/journey/renderer.ts +0 -917
- package/src/journey/types.ts +0 -144
- package/src/layout/geometry.ts +0 -182
- package/src/layout/pass.ts +0 -142
- package/src/layout/passes/index.ts +0 -3916
- package/src/layout-engine.ts +0 -1565
- package/src/layout-rubric.ts +0 -659
- package/src/mcp/artifacts.ts +0 -137
- package/src/mcp/dynamic-harness.ts +0 -31
- package/src/mcp/dynamic-modules.d.ts +0 -7
- package/src/mcp/facade.ts +0 -608
- package/src/mcp/harness-runtime.ts +0 -203
- package/src/mcp/hosted-server.ts +0 -468
- package/src/mcp/mcp-bin.ts +0 -3
- package/src/mcp/mcp-cli.ts +0 -82
- package/src/mcp/protocol.ts +0 -13
- package/src/mcp/sandbox.ts +0 -195
- package/src/mcp/sdk-decl.ts +0 -391
- package/src/mcp/server.ts +0 -362
- package/src/mcp/tool-surface.ts +0 -146
- package/src/mermaid-source.ts +0 -655
- package/src/multiline-utils.ts +0 -228
- package/src/parser.ts +0 -1031
- package/src/pie/layout.ts +0 -168
- package/src/pie/parser.ts +0 -136
- package/src/pie/renderer.ts +0 -234
- package/src/pie/types.ts +0 -82
- package/src/quadrant/layout.ts +0 -191
- package/src/quadrant/parser.ts +0 -183
- package/src/quadrant/renderer.ts +0 -322
- package/src/quadrant/types.ts +0 -113
- package/src/render-family-hooks.ts +0 -244
- package/src/renderer.ts +0 -1099
- package/src/route-contracts.ts +0 -2723
- package/src/scene/backend.ts +0 -76
- package/src/scene/fidelity.ts +0 -183
- package/src/scene/hybrid-backend.ts +0 -174
- package/src/scene/ir.ts +0 -181
- package/src/scene/marks.ts +0 -127
- package/src/scene/rough-backend.ts +0 -378
- package/src/scene/seed.ts +0 -46
- package/src/scene/style-registry.ts +0 -556
- package/src/sequence/layout.ts +0 -456
- package/src/sequence/parser.ts +0 -255
- package/src/sequence/renderer.ts +0 -604
- package/src/sequence/types.ts +0 -154
- package/src/shape-clipping.ts +0 -351
- package/src/shared/accessibility-directives.ts +0 -22
- package/src/shared/batched.ts +0 -61
- package/src/shared/color-math.ts +0 -93
- package/src/shared/svg-a11y.ts +0 -29
- package/src/shared/syntax-error.ts +0 -17
- package/src/shared/unicode-ranges.ts +0 -135
- package/src/styles.ts +0 -318
- package/src/svg-paths.ts +0 -28
- package/src/text-metrics.ts +0 -248
- package/src/theme.ts +0 -710
- package/src/timeline/layout.ts +0 -381
- package/src/timeline/parser.ts +0 -215
- package/src/timeline/renderer.ts +0 -538
- package/src/timeline/types.ts +0 -105
- package/src/types.ts +0 -462
- package/src/website-worker-modules.d.ts +0 -18
- package/src/xychart/axis-utils.ts +0 -109
- package/src/xychart/colors.ts +0 -124
- package/src/xychart/config.ts +0 -88
- package/src/xychart/layout.ts +0 -656
- package/src/xychart/parser.ts +0 -504
- package/src/xychart/renderer.ts +0 -640
- package/src/xychart/types.ts +0 -282
package/src/class/renderer.ts
DELETED
|
@@ -1,638 +0,0 @@
|
|
|
1
|
-
import type { PositionedClassDiagram, PositionedClassNode, PositionedClassRelationship, ClassMember, RelationshipType } from './types.ts'
|
|
2
|
-
import type { RenderContext } from '../types.ts'
|
|
3
|
-
import { svgOpenTag, buildStyleBlock, buildShadowDefs } from '../theme.ts'
|
|
4
|
-
import { FONT_SIZES, FONT_WEIGHTS, STROKE_WIDTHS, TEXT_BASELINE_SHIFT, applyTextTransform, resolveRenderStyle } from '../styles.ts'
|
|
5
|
-
import type { RenderStyleDefaults, ResolvedRenderStyle } from '../styles.ts'
|
|
6
|
-
import { CLS, CLASS_STYLE_DEFAULTS } from './layout.ts'
|
|
7
|
-
import { buildAccessibilityAttrs } from '../shared/svg-a11y.ts'
|
|
8
|
-
import { renderMultilineText, escapeAttr, escapeXml as escapeXmlUtil } from '../multiline-utils.ts'
|
|
9
|
-
import { topRoundedRectPath } from '../svg-paths.ts'
|
|
10
|
-
import type { MarkerRef, SceneDoc, SceneNode } from '../scene/ir.ts'
|
|
11
|
-
import { hashId } from '../scene/seed.ts'
|
|
12
|
-
import * as marks from '../scene/marks.ts'
|
|
13
|
-
import { DefaultBackend } from '../scene/backend.ts'
|
|
14
|
-
|
|
15
|
-
// ============================================================================
|
|
16
|
-
// Class diagram SVG renderer
|
|
17
|
-
//
|
|
18
|
-
// The positioned diagram is first lowered to a SceneGraph (SPEC §3.1): every
|
|
19
|
-
// visual mark becomes a scene node carrying semantic fields (role, geometry,
|
|
20
|
-
// paint, stable id) plus its exact crisp serialization, built here from the
|
|
21
|
-
// same inputs. renderClassSvg() is DefaultBackend serialization of that scene,
|
|
22
|
-
// so the default path stays byte-identical to the historical string renderer
|
|
23
|
-
// (corpus-gated by svg-equivalence.test.ts).
|
|
24
|
-
//
|
|
25
|
-
// All colors use CSS custom properties (var(--_xxx)) from the theme system.
|
|
26
|
-
//
|
|
27
|
-
// Render order:
|
|
28
|
-
// 1. Relationship lines (behind boxes)
|
|
29
|
-
// 2. Class boxes (header + attributes + methods compartments)
|
|
30
|
-
// 3. Relationship endpoint markers (diamonds, triangles)
|
|
31
|
-
// 4. Labels and cardinality
|
|
32
|
-
// ============================================================================
|
|
33
|
-
|
|
34
|
-
|
|
35
|
-
/** Font sizes specific to class diagrams */
|
|
36
|
-
const CLS_FONT = {
|
|
37
|
-
memberSize: 11,
|
|
38
|
-
memberWeight: 400,
|
|
39
|
-
annotationSize: 10,
|
|
40
|
-
annotationWeight: 500,
|
|
41
|
-
} as const
|
|
42
|
-
|
|
43
|
-
/**
|
|
44
|
-
* Render a positioned class diagram as an SVG string.
|
|
45
|
-
*
|
|
46
|
-
* @param colors - DiagramColors with bg/fg and optional enrichment variables.
|
|
47
|
-
* @param transparent - If true, renders with transparent background.
|
|
48
|
-
*/
|
|
49
|
-
export function renderClassSvg(
|
|
50
|
-
ctx: RenderContext<PositionedClassDiagram>,
|
|
51
|
-
): string {
|
|
52
|
-
return DefaultBackend.render(lowerClassScene(ctx), { seed: 0 })
|
|
53
|
-
}
|
|
54
|
-
|
|
55
|
-
/**
|
|
56
|
-
* Lower a positioned class diagram to the SceneGraph IR. Mark order matches
|
|
57
|
-
* the historical parts[] order exactly; DefaultBackend joins crisps with '\n'.
|
|
58
|
-
*/
|
|
59
|
-
export function lowerClassScene(
|
|
60
|
-
ctx: RenderContext<PositionedClassDiagram>,
|
|
61
|
-
): SceneDoc {
|
|
62
|
-
const { positioned: diagram, colors, options } = ctx
|
|
63
|
-
const font = colors.font ?? 'Inter'
|
|
64
|
-
const transparent = options.transparent ?? false
|
|
65
|
-
const parts: SceneNode[] = []
|
|
66
|
-
const style = resolveRenderStyle(options, CLASS_STYLE_DEFAULTS)
|
|
67
|
-
const uid = `class-${hashId(diagram.width, diagram.height, diagram.classes.length, diagram.relationships.length)}`
|
|
68
|
-
const titleId = `${uid}-title`
|
|
69
|
-
const descId = `${uid}-desc`
|
|
70
|
-
const rootAttrs = buildAccessibilityAttrs(diagram.accessibilityTitle, diagram.accessibilityDescription, titleId, descId)
|
|
71
|
-
|
|
72
|
-
// SVG root with CSS variables + style block (with mono font) + defs
|
|
73
|
-
parts.push(marks.prelude(
|
|
74
|
-
{
|
|
75
|
-
id: 'prelude',
|
|
76
|
-
width: diagram.width,
|
|
77
|
-
height: diagram.height,
|
|
78
|
-
colors,
|
|
79
|
-
transparent,
|
|
80
|
-
font,
|
|
81
|
-
hasMonoFont: true,
|
|
82
|
-
},
|
|
83
|
-
svgOpenTag(diagram.width, diagram.height, colors, transparent, rootAttrs) + '\n' +
|
|
84
|
-
buildStyleBlock(font, true, colors.shadow, colors.embedFontImport),
|
|
85
|
-
))
|
|
86
|
-
const defsParts: string[] = []
|
|
87
|
-
defsParts.push('<defs>')
|
|
88
|
-
defsParts.push(relationshipMarkerDefs(style))
|
|
89
|
-
const shadowDefs = buildShadowDefs(colors)
|
|
90
|
-
if (shadowDefs) defsParts.push(shadowDefs)
|
|
91
|
-
defsParts.push('</defs>')
|
|
92
|
-
parts.push(marks.raw({ id: 'defs', role: 'defs' }, defsParts.join('\n')))
|
|
93
|
-
|
|
94
|
-
if (diagram.accessibilityTitle) {
|
|
95
|
-
parts.push(marks.raw({ id: 'title', role: 'chrome' }, `<title id="${titleId}">${escapeXml(diagram.accessibilityTitle)}</title>`))
|
|
96
|
-
}
|
|
97
|
-
if (diagram.accessibilityDescription) {
|
|
98
|
-
parts.push(marks.raw({ id: 'desc', role: 'chrome' }, `<desc id="${descId}">${escapeXml(diagram.accessibilityDescription)}</desc>`))
|
|
99
|
-
}
|
|
100
|
-
|
|
101
|
-
// 1. Relationship lines (rendered behind boxes)
|
|
102
|
-
const relOccurrence = new Map<string, number>()
|
|
103
|
-
for (const rel of diagram.relationships) {
|
|
104
|
-
const pairKey = `${rel.from}->${rel.to}`
|
|
105
|
-
const k = relOccurrence.get(pairKey) ?? 0
|
|
106
|
-
relOccurrence.set(pairKey, k + 1)
|
|
107
|
-
parts.push(renderRelationship(rel, style, `rel:${pairKey}#${k}`))
|
|
108
|
-
}
|
|
109
|
-
|
|
110
|
-
// 2. Class boxes
|
|
111
|
-
for (const cls of diagram.classes) {
|
|
112
|
-
parts.push(renderClassBox(cls, style))
|
|
113
|
-
}
|
|
114
|
-
|
|
115
|
-
// 3. Relationship labels and cardinality
|
|
116
|
-
const labelOccurrence = new Map<string, number>()
|
|
117
|
-
for (const rel of diagram.relationships) {
|
|
118
|
-
const pairKey = `${rel.from}->${rel.to}`
|
|
119
|
-
const k = labelOccurrence.get(pairKey) ?? 0
|
|
120
|
-
labelOccurrence.set(pairKey, k + 1)
|
|
121
|
-
parts.push(...renderRelationshipLabels(rel, style, `${pairKey}#${k}`))
|
|
122
|
-
}
|
|
123
|
-
|
|
124
|
-
parts.push(marks.raw({ id: 'svg-close', role: 'chrome' }, '</svg>'))
|
|
125
|
-
|
|
126
|
-
return { family: 'class', width: diagram.width, height: diagram.height, colors, parts }
|
|
127
|
-
}
|
|
128
|
-
|
|
129
|
-
// ============================================================================
|
|
130
|
-
// Marker definitions
|
|
131
|
-
// ============================================================================
|
|
132
|
-
|
|
133
|
-
/**
|
|
134
|
-
* Marker definitions for class relationship endpoints.
|
|
135
|
-
* Each relationship type has a distinct marker:
|
|
136
|
-
* - inheritance: hollow triangle
|
|
137
|
-
* - composition: filled diamond
|
|
138
|
-
* - aggregation: hollow diamond
|
|
139
|
-
* - association: open arrow (simple >)
|
|
140
|
-
* - dependency: open arrow (simple >)
|
|
141
|
-
* - realization: hollow triangle (same as inheritance)
|
|
142
|
-
*
|
|
143
|
-
* Uses var(--_arrow) for fill/stroke and var(--bg) for hollow marker fills.
|
|
144
|
-
*/
|
|
145
|
-
function relationshipMarkerDefs(style: ResolvedRenderStyle): string {
|
|
146
|
-
const edgeColor = escapeAttr(style.edgeStrokeColor ?? 'var(--_arrow)')
|
|
147
|
-
return (
|
|
148
|
-
// Hollow triangle (inheritance, realization) — points at target
|
|
149
|
-
` <marker id="cls-inherit" markerWidth="12" markerHeight="10" refX="12" refY="5" orient="auto-start-reverse">` +
|
|
150
|
-
`\n <polygon points="0 0, 12 5, 0 10" fill="var(--bg)" stroke="${edgeColor}" stroke-width="1.5" />` +
|
|
151
|
-
`\n </marker>` +
|
|
152
|
-
// Filled diamond (composition) — points at source
|
|
153
|
-
`\n <marker id="cls-composition" markerWidth="12" markerHeight="10" refX="0" refY="5" orient="auto-start-reverse">` +
|
|
154
|
-
`\n <polygon points="6 0, 12 5, 6 10, 0 5" fill="${edgeColor}" stroke="${edgeColor}" stroke-width="1" />` +
|
|
155
|
-
`\n </marker>` +
|
|
156
|
-
// Hollow diamond (aggregation) — points at source
|
|
157
|
-
`\n <marker id="cls-aggregation" markerWidth="12" markerHeight="10" refX="0" refY="5" orient="auto-start-reverse">` +
|
|
158
|
-
`\n <polygon points="6 0, 12 5, 6 10, 0 5" fill="var(--bg)" stroke="${edgeColor}" stroke-width="1.5" />` +
|
|
159
|
-
`\n </marker>` +
|
|
160
|
-
// Open arrow (association, dependency)
|
|
161
|
-
`\n <marker id="cls-arrow" markerWidth="8" markerHeight="6" refX="8" refY="3" orient="auto-start-reverse">` +
|
|
162
|
-
`\n <polyline points="0 0, 8 3, 0 6" fill="none" stroke="${edgeColor}" stroke-width="1.5" />` +
|
|
163
|
-
`\n </marker>`
|
|
164
|
-
)
|
|
165
|
-
}
|
|
166
|
-
|
|
167
|
-
// ============================================================================
|
|
168
|
-
// Class box rendering
|
|
169
|
-
// ============================================================================
|
|
170
|
-
|
|
171
|
-
/**
|
|
172
|
-
* Render a class box with 3 compartments: header, attributes, methods.
|
|
173
|
-
* Wrapped in <g class="class-node"> with semantic data attributes.
|
|
174
|
-
*/
|
|
175
|
-
function renderClassBox(cls: PositionedClassNode, style: ResolvedRenderStyle): SceneNode {
|
|
176
|
-
const { x, y, width, height, headerHeight, attrHeight } = cls
|
|
177
|
-
const children: Array<{ node: SceneNode; indent: number }> = []
|
|
178
|
-
|
|
179
|
-
// Semantic wrapper with class metadata
|
|
180
|
-
// data-id: class identifier
|
|
181
|
-
// data-label: class name
|
|
182
|
-
// data-annotation: stereotype (interface, abstract, etc.)
|
|
183
|
-
const annotationAttr = cls.annotation ? ` data-annotation="${escapeAttr(cls.annotation)}"` : ''
|
|
184
|
-
const open =
|
|
185
|
-
`<g class="class-node" data-id="${escapeAttr(cls.id)}" data-label="${escapeAttr(cls.label)}"${annotationAttr}>`
|
|
186
|
-
|
|
187
|
-
// Outer rectangle (full box)
|
|
188
|
-
const boxFill = style.nodeFillColor ?? 'var(--_node-fill)'
|
|
189
|
-
const boxStroke = style.nodeBorderColor ?? 'var(--_node-stroke)'
|
|
190
|
-
children.push({
|
|
191
|
-
indent: 2,
|
|
192
|
-
node: marks.shape({
|
|
193
|
-
id: `class:${cls.id}:box`,
|
|
194
|
-
role: 'class-box',
|
|
195
|
-
geometry: { kind: 'rect', x, y, width, height, rx: style.cornerRadius ?? 0, ry: style.cornerRadius ?? 0 },
|
|
196
|
-
paint: { fill: boxFill, stroke: boxStroke, strokeWidth: String(style.nodeLineWidth) },
|
|
197
|
-
},
|
|
198
|
-
`<rect x="${x}" y="${y}" width="${width}" height="${height}" ` +
|
|
199
|
-
`rx="${style.cornerRadius ?? 0}" ry="${style.cornerRadius ?? 0}" fill="${escapeAttr(boxFill)}" stroke="${escapeAttr(boxStroke)}" stroke-width="${style.nodeLineWidth}" />`),
|
|
200
|
-
})
|
|
201
|
-
|
|
202
|
-
// Header background
|
|
203
|
-
const headerFill = style.groupHeaderFillColor ?? 'var(--_group-hdr)'
|
|
204
|
-
const headerPath = topRoundedRectPath(x, y, width, headerHeight, style.cornerRadius ?? 0)
|
|
205
|
-
children.push({
|
|
206
|
-
indent: 2,
|
|
207
|
-
node: marks.shape({
|
|
208
|
-
id: `class:${cls.id}:header`,
|
|
209
|
-
role: 'group-header',
|
|
210
|
-
geometry: { kind: 'path', d: headerPath },
|
|
211
|
-
paint: { fill: headerFill, stroke: boxStroke, strokeWidth: String(style.nodeLineWidth) },
|
|
212
|
-
},
|
|
213
|
-
`<path d="${headerPath}" ` +
|
|
214
|
-
`fill="${escapeAttr(headerFill)}" stroke="${escapeAttr(boxStroke)}" stroke-width="${style.nodeLineWidth}" />`),
|
|
215
|
-
})
|
|
216
|
-
|
|
217
|
-
// Annotation (<<interface>>, <<abstract>>, etc.)
|
|
218
|
-
let nameY = y + headerHeight / 2
|
|
219
|
-
if (cls.annotation) {
|
|
220
|
-
const annotY = y + 12
|
|
221
|
-
const annotColor = style.nodeTextColor ?? 'var(--_text-muted)'
|
|
222
|
-
children.push({
|
|
223
|
-
indent: 2,
|
|
224
|
-
node: marks.text({
|
|
225
|
-
id: `class:${cls.id}:annotation`,
|
|
226
|
-
role: 'label',
|
|
227
|
-
text: `<<${cls.annotation}>>`,
|
|
228
|
-
x: x + width / 2,
|
|
229
|
-
y: annotY,
|
|
230
|
-
fontSize: CLS_FONT.annotationSize,
|
|
231
|
-
anchor: 'middle',
|
|
232
|
-
paint: { fill: annotColor },
|
|
233
|
-
},
|
|
234
|
-
`<text x="${x + width / 2}" y="${annotY}" text-anchor="middle" dy="${TEXT_BASELINE_SHIFT}" ` +
|
|
235
|
-
`font-size="${CLS_FONT.annotationSize}" font-weight="${CLS_FONT.annotationWeight}" ` +
|
|
236
|
-
`font-style="italic" fill="${escapeAttr(annotColor)}"><<${escapeXml(cls.annotation)}>></text>`),
|
|
237
|
-
})
|
|
238
|
-
nameY = y + headerHeight / 2 + 6
|
|
239
|
-
}
|
|
240
|
-
|
|
241
|
-
// Class name (supports multi-line via <br> tags)
|
|
242
|
-
const nameColor = style.nodeTextColor ?? 'var(--_text)'
|
|
243
|
-
const label = applyTextTransform(cls.label, style.nodeTextTransform)
|
|
244
|
-
children.push({
|
|
245
|
-
indent: 2,
|
|
246
|
-
node: marks.text({
|
|
247
|
-
id: `class:${cls.id}:name`,
|
|
248
|
-
role: 'label',
|
|
249
|
-
text: label,
|
|
250
|
-
x: x + width / 2,
|
|
251
|
-
y: nameY,
|
|
252
|
-
fontSize: style.nodeLabelFontSize,
|
|
253
|
-
anchor: 'middle',
|
|
254
|
-
paint: { fill: nameColor },
|
|
255
|
-
}, renderMultilineText(
|
|
256
|
-
label,
|
|
257
|
-
x + width / 2,
|
|
258
|
-
nameY,
|
|
259
|
-
style.nodeLabelFontSize,
|
|
260
|
-
`text-anchor="middle" font-size="${style.nodeLabelFontSize}" font-weight="${style.nodeLabelFontWeight}"${letterAttr(style.nodeLetterSpacing)} fill="${escapeAttr(nameColor)}"`
|
|
261
|
-
)),
|
|
262
|
-
})
|
|
263
|
-
|
|
264
|
-
// Divider line between header and attributes
|
|
265
|
-
const attrTop = y + headerHeight
|
|
266
|
-
children.push({ indent: 2, node: renderDivider(cls.id, 'attrs', x, attrTop, width, style) })
|
|
267
|
-
|
|
268
|
-
// Attributes
|
|
269
|
-
const memberRowH = 20
|
|
270
|
-
for (let i = 0; i < cls.attributes.length; i++) {
|
|
271
|
-
const member = cls.attributes[i]!
|
|
272
|
-
const memberY = attrTop + 4 + i * memberRowH + memberRowH / 2
|
|
273
|
-
children.push({ indent: 2, node: renderMember(member, x + style.nodePaddingX, memberY, style, `member:${cls.id}:${member.name}`) })
|
|
274
|
-
}
|
|
275
|
-
|
|
276
|
-
// Divider line between attributes and methods
|
|
277
|
-
const methodTop = attrTop + attrHeight
|
|
278
|
-
children.push({ indent: 2, node: renderDivider(cls.id, 'methods', x, methodTop, width, style) })
|
|
279
|
-
|
|
280
|
-
// Methods
|
|
281
|
-
for (let i = 0; i < cls.methods.length; i++) {
|
|
282
|
-
const member = cls.methods[i]!
|
|
283
|
-
const memberY = methodTop + 4 + i * memberRowH + memberRowH / 2
|
|
284
|
-
children.push({ indent: 2, node: renderMember(member, x + style.nodePaddingX, memberY, style, `member:${cls.id}:${member.name}`) })
|
|
285
|
-
}
|
|
286
|
-
|
|
287
|
-
return marks.group({
|
|
288
|
-
id: `class:${cls.id}`,
|
|
289
|
-
role: 'class-box',
|
|
290
|
-
open,
|
|
291
|
-
close: '</g>',
|
|
292
|
-
children,
|
|
293
|
-
})
|
|
294
|
-
}
|
|
295
|
-
|
|
296
|
-
/** Compartment divider line (header/attributes and attributes/methods). */
|
|
297
|
-
function renderDivider(clsId: string, which: 'attrs' | 'methods', x: number, lineY: number, width: number, style: ResolvedRenderStyle): SceneNode {
|
|
298
|
-
const stroke = style.nodeBorderColor ?? 'var(--_node-stroke)'
|
|
299
|
-
const strokeWidth = Math.min(style.nodeLineWidth, STROKE_WIDTHS.innerBox)
|
|
300
|
-
return marks.shape({
|
|
301
|
-
id: `class:${clsId}:divider:${which}`,
|
|
302
|
-
role: 'chrome',
|
|
303
|
-
geometry: { kind: 'line', x1: x, y1: lineY, x2: x + width, y2: lineY },
|
|
304
|
-
paint: { stroke, strokeWidth: String(strokeWidth) },
|
|
305
|
-
},
|
|
306
|
-
`<line x1="${x}" y1="${lineY}" x2="${x + width}" y2="${lineY}" ` +
|
|
307
|
-
`stroke="${escapeAttr(stroke)}" stroke-width="${strokeWidth}" />`)
|
|
308
|
-
}
|
|
309
|
-
|
|
310
|
-
/**
|
|
311
|
-
* Render a single class member with syntax highlighting.
|
|
312
|
-
* Uses <tspan> elements to color each part of the member differently:
|
|
313
|
-
* - visibility symbol (+/-/#/~) → textFaint
|
|
314
|
-
* - member name (incl. parens for methods) → textSecondary
|
|
315
|
-
* - colon separator → textFaint
|
|
316
|
-
* - type annotation → textMuted
|
|
317
|
-
*/
|
|
318
|
-
function renderMember(member: ClassMember, x: number, y: number, style: ResolvedRenderStyle, sceneId: string): SceneNode {
|
|
319
|
-
const fontStyle = member.isAbstract ? ' font-style="italic"' : ''
|
|
320
|
-
const decoration = member.isStatic ? ' text-decoration="underline"' : ''
|
|
321
|
-
|
|
322
|
-
// Build tspan parts for syntax-highlighted member text
|
|
323
|
-
const spans: string[] = []
|
|
324
|
-
|
|
325
|
-
if (member.visibility) {
|
|
326
|
-
spans.push(`<tspan fill="var(--_text-faint)">${escapeXml(member.visibility)} </tspan>`)
|
|
327
|
-
}
|
|
328
|
-
|
|
329
|
-
// Add parentheses for methods to distinguish from attributes, including parameters if present
|
|
330
|
-
const displayName = member.isMethod
|
|
331
|
-
? `${member.name}(${member.params || ''})`
|
|
332
|
-
: member.name
|
|
333
|
-
spans.push(`<tspan fill="${escapeAttr(style.nodeTextColor ?? 'var(--_text-sec)')}">${escapeXml(displayName)}</tspan>`)
|
|
334
|
-
|
|
335
|
-
if (member.type) {
|
|
336
|
-
spans.push(`<tspan fill="var(--_text-faint)">: </tspan>`)
|
|
337
|
-
spans.push(`<tspan fill="var(--_text-muted)">${escapeXml(member.type)}</tspan>`)
|
|
338
|
-
}
|
|
339
|
-
|
|
340
|
-
// Plain signature string (the tspan structure lives in the crisp)
|
|
341
|
-
const plain =
|
|
342
|
-
`${member.visibility ? `${member.visibility} ` : ''}${displayName}${member.type ? `: ${member.type}` : ''}`
|
|
343
|
-
|
|
344
|
-
return marks.text({
|
|
345
|
-
id: sceneId,
|
|
346
|
-
role: 'member',
|
|
347
|
-
text: plain,
|
|
348
|
-
x,
|
|
349
|
-
y,
|
|
350
|
-
fontSize: CLS_FONT.memberSize,
|
|
351
|
-
anchor: 'start',
|
|
352
|
-
paint: { fill: style.nodeTextColor ?? 'var(--_text-sec)' },
|
|
353
|
-
},
|
|
354
|
-
`<text x="${x}" y="${y}" class="mono" dy="${TEXT_BASELINE_SHIFT}" ` +
|
|
355
|
-
`font-size="${CLS_FONT.memberSize}" font-weight="${CLS_FONT.memberWeight}"${fontStyle}${decoration}>` +
|
|
356
|
-
`${spans.join('')}</text>`)
|
|
357
|
-
}
|
|
358
|
-
|
|
359
|
-
// ============================================================================
|
|
360
|
-
// Relationship rendering
|
|
361
|
-
// ============================================================================
|
|
362
|
-
|
|
363
|
-
/**
|
|
364
|
-
* Render a relationship line with appropriate markers and semantic attributes.
|
|
365
|
-
* Includes data-* attributes for programmatic inspection.
|
|
366
|
-
*/
|
|
367
|
-
function renderRelationship(rel: PositionedClassRelationship, style: ResolvedRenderStyle, sceneId: string): SceneNode {
|
|
368
|
-
if (rel.points.length < 2) {
|
|
369
|
-
// Degenerate relationship — draws nothing (crisp '', like the old '' part).
|
|
370
|
-
return marks.connector({
|
|
371
|
-
id: sceneId,
|
|
372
|
-
role: 'relationship',
|
|
373
|
-
geometry: { kind: 'polyline', points: rel.points },
|
|
374
|
-
lineStyle: 'invisible',
|
|
375
|
-
paint: {},
|
|
376
|
-
}, '')
|
|
377
|
-
}
|
|
378
|
-
|
|
379
|
-
const pathData = rel.points.map(p => `${p.x},${p.y}`).join(' ')
|
|
380
|
-
const isDashed = rel.type === 'dependency' || rel.type === 'realization'
|
|
381
|
-
const dashArray = isDashed ? ' stroke-dasharray="6 4"' : ''
|
|
382
|
-
const lineStyle = isDashed ? 'dashed' : 'solid'
|
|
383
|
-
|
|
384
|
-
// Determine markers based on relationship type and which end has the marker
|
|
385
|
-
const markers = getRelationshipMarkers(rel.type, rel.markerAt)
|
|
386
|
-
const markerId = getMarkerDefId(rel.type)
|
|
387
|
-
const markerRef: MarkerRef | undefined = markerId ? { id: markerId, shape: markerShapeFor(markerId) } : undefined
|
|
388
|
-
const startMarker = rel.markerAt === 'from' ? markerRef : undefined
|
|
389
|
-
const endMarker = rel.markerAt === 'to' ? markerRef : undefined
|
|
390
|
-
|
|
391
|
-
// Build semantic data attributes for relationship inspection:
|
|
392
|
-
// - class="class-relationship": CSS targeting
|
|
393
|
-
// - data-from/data-to: source and target class IDs
|
|
394
|
-
// - data-type: relationship type (inheritance, composition, etc.)
|
|
395
|
-
// - data-marker-at: which end has the marker (from/to)
|
|
396
|
-
// - data-from-cardinality/data-to-cardinality: multiplicity if present
|
|
397
|
-
// - data-label: relationship label if present
|
|
398
|
-
const dataAttrs = [
|
|
399
|
-
'class="class-relationship"',
|
|
400
|
-
`data-from="${escapeAttr(rel.from)}"`,
|
|
401
|
-
`data-to="${escapeAttr(rel.to)}"`,
|
|
402
|
-
`data-type="${rel.type}"`,
|
|
403
|
-
`data-marker-at="${rel.markerAt}"`,
|
|
404
|
-
]
|
|
405
|
-
if (rel.label) {
|
|
406
|
-
dataAttrs.push(`data-label="${escapeAttr(rel.label)}"`)
|
|
407
|
-
}
|
|
408
|
-
if (rel.fromCardinality) {
|
|
409
|
-
dataAttrs.push(`data-from-cardinality="${escapeAttr(rel.fromCardinality)}"`)
|
|
410
|
-
}
|
|
411
|
-
if (rel.toCardinality) {
|
|
412
|
-
dataAttrs.push(`data-to-cardinality="${escapeAttr(rel.toCardinality)}"`)
|
|
413
|
-
}
|
|
414
|
-
|
|
415
|
-
const strokeColor = style.edgeStrokeColor ?? 'var(--_line)'
|
|
416
|
-
const paint = {
|
|
417
|
-
stroke: strokeColor,
|
|
418
|
-
strokeWidth: String(style.lineWidth),
|
|
419
|
-
...(isDashed ? { strokeDasharray: '6 4' } : {}),
|
|
420
|
-
}
|
|
421
|
-
|
|
422
|
-
if (style.edgeBendRadius > 0 && rel.points.length > 2) {
|
|
423
|
-
const d = pointsToPathD(rel.points, style.edgeBendRadius)
|
|
424
|
-
return marks.connector({
|
|
425
|
-
id: sceneId,
|
|
426
|
-
role: 'relationship',
|
|
427
|
-
geometry: { kind: 'path', d, points: rel.points },
|
|
428
|
-
lineStyle,
|
|
429
|
-
paint,
|
|
430
|
-
startMarker,
|
|
431
|
-
endMarker,
|
|
432
|
-
},
|
|
433
|
-
`<path ${dataAttrs.join(' ')} d="${d}" fill="none" stroke="${escapeAttr(strokeColor)}" ` +
|
|
434
|
-
`stroke-width="${style.lineWidth}"${dashArray}${markers} />`)
|
|
435
|
-
}
|
|
436
|
-
|
|
437
|
-
return marks.connector({
|
|
438
|
-
id: sceneId,
|
|
439
|
-
role: 'relationship',
|
|
440
|
-
geometry: { kind: 'polyline', points: rel.points },
|
|
441
|
-
lineStyle,
|
|
442
|
-
paint,
|
|
443
|
-
startMarker,
|
|
444
|
-
endMarker,
|
|
445
|
-
},
|
|
446
|
-
`<polyline ${dataAttrs.join(' ')} points="${pathData}" fill="none" stroke="${escapeAttr(strokeColor)}" ` +
|
|
447
|
-
`stroke-width="${style.lineWidth}"${dashArray}${markers} />`)
|
|
448
|
-
}
|
|
449
|
-
|
|
450
|
-
/**
|
|
451
|
-
* Get marker-start/marker-end attributes for a relationship type.
|
|
452
|
-
* Uses `markerAt` from the parser to place the marker on the correct end:
|
|
453
|
-
* - 'from' → marker-start (prefix arrows like `<|--`, `*--`, `o--`)
|
|
454
|
-
* - 'to' → marker-end (suffix arrows like `..|>`, `-->`, `--*`)
|
|
455
|
-
*/
|
|
456
|
-
function getRelationshipMarkers(type: RelationshipType, markerAt: 'from' | 'to'): string {
|
|
457
|
-
const markerId = getMarkerDefId(type)
|
|
458
|
-
if (!markerId) return ''
|
|
459
|
-
|
|
460
|
-
if (markerAt === 'from') {
|
|
461
|
-
return ` marker-start="url(#${markerId})"`
|
|
462
|
-
} else {
|
|
463
|
-
return ` marker-end="url(#${markerId})"`
|
|
464
|
-
}
|
|
465
|
-
}
|
|
466
|
-
|
|
467
|
-
/** Map relationship type to its SVG marker definition ID */
|
|
468
|
-
function getMarkerDefId(type: RelationshipType): string | null {
|
|
469
|
-
switch (type) {
|
|
470
|
-
case 'inheritance':
|
|
471
|
-
case 'realization':
|
|
472
|
-
return 'cls-inherit'
|
|
473
|
-
case 'composition':
|
|
474
|
-
return 'cls-composition'
|
|
475
|
-
case 'aggregation':
|
|
476
|
-
return 'cls-aggregation'
|
|
477
|
-
case 'association':
|
|
478
|
-
case 'dependency':
|
|
479
|
-
return 'cls-arrow'
|
|
480
|
-
default:
|
|
481
|
-
return null
|
|
482
|
-
}
|
|
483
|
-
}
|
|
484
|
-
|
|
485
|
-
/** Map a marker def ID to its MarkerRef archetype for styled backends. */
|
|
486
|
-
function markerShapeFor(markerId: string): MarkerRef['shape'] {
|
|
487
|
-
switch (markerId) {
|
|
488
|
-
case 'cls-inherit':
|
|
489
|
-
return 'triangle'
|
|
490
|
-
case 'cls-composition':
|
|
491
|
-
return 'diamond'
|
|
492
|
-
case 'cls-aggregation':
|
|
493
|
-
return 'diamond-open'
|
|
494
|
-
default:
|
|
495
|
-
return 'open-arrow'
|
|
496
|
-
}
|
|
497
|
-
}
|
|
498
|
-
|
|
499
|
-
/** Render relationship labels and cardinality text (supports multi-line).
|
|
500
|
-
* Returns one text mark per label/cardinality; when the relationship has
|
|
501
|
-
* none, a single empty mark keeps the historical '' part (blank line). */
|
|
502
|
-
function renderRelationshipLabels(rel: PositionedClassRelationship, style: ResolvedRenderStyle, key: string): SceneNode[] {
|
|
503
|
-
if ((!rel.label && !rel.fromCardinality && !rel.toCardinality) || rel.points.length < 2) {
|
|
504
|
-
return [marks.raw({ id: `rel-labels:${key}`, role: 'chrome' }, '')]
|
|
505
|
-
}
|
|
506
|
-
|
|
507
|
-
const out: SceneNode[] = []
|
|
508
|
-
const textColor = style.edgeTextColor ?? 'var(--_text-muted)'
|
|
509
|
-
const textAttrs =
|
|
510
|
-
`font-size="${style.edgeLabelFontSize}" text-anchor="middle" font-weight="${style.edgeLabelFontWeight}"${letterAttr(style.edgeLetterSpacing)} fill="${escapeAttr(textColor)}"`
|
|
511
|
-
|
|
512
|
-
// Label — prefer layout-computed position (collision-aware), fall back to midpoint
|
|
513
|
-
if (rel.label) {
|
|
514
|
-
const pos = rel.labelPosition ?? midpoint(rel.points)
|
|
515
|
-
const label = applyTextTransform(rel.label, style.edgeTextTransform)
|
|
516
|
-
out.push(marks.text({
|
|
517
|
-
id: `rel-label:${key}`,
|
|
518
|
-
role: 'label',
|
|
519
|
-
text: label,
|
|
520
|
-
x: pos.x,
|
|
521
|
-
y: pos.y - 8,
|
|
522
|
-
fontSize: style.edgeLabelFontSize,
|
|
523
|
-
anchor: 'middle',
|
|
524
|
-
paint: { fill: textColor },
|
|
525
|
-
}, renderMultilineText(label, pos.x, pos.y - 8, style.edgeLabelFontSize, textAttrs)))
|
|
526
|
-
}
|
|
527
|
-
|
|
528
|
-
// From cardinality (near start)
|
|
529
|
-
if (rel.fromCardinality) {
|
|
530
|
-
const p = rel.points[0]!
|
|
531
|
-
const next = rel.points[1]!
|
|
532
|
-
const offset = cardinalityOffset(p, next)
|
|
533
|
-
out.push(marks.text({
|
|
534
|
-
id: `rel-card:${key}:from`,
|
|
535
|
-
role: 'cardinality',
|
|
536
|
-
text: rel.fromCardinality,
|
|
537
|
-
x: p.x + offset.x,
|
|
538
|
-
y: p.y + offset.y,
|
|
539
|
-
fontSize: style.edgeLabelFontSize,
|
|
540
|
-
anchor: 'middle',
|
|
541
|
-
paint: { fill: textColor },
|
|
542
|
-
}, renderMultilineText(rel.fromCardinality, p.x + offset.x, p.y + offset.y, style.edgeLabelFontSize, textAttrs)))
|
|
543
|
-
}
|
|
544
|
-
|
|
545
|
-
// To cardinality (near end)
|
|
546
|
-
if (rel.toCardinality) {
|
|
547
|
-
const p = rel.points[rel.points.length - 1]!
|
|
548
|
-
const prev = rel.points[rel.points.length - 2]!
|
|
549
|
-
const offset = cardinalityOffset(p, prev)
|
|
550
|
-
out.push(marks.text({
|
|
551
|
-
id: `rel-card:${key}:to`,
|
|
552
|
-
role: 'cardinality',
|
|
553
|
-
text: rel.toCardinality,
|
|
554
|
-
x: p.x + offset.x,
|
|
555
|
-
y: p.y + offset.y,
|
|
556
|
-
fontSize: style.edgeLabelFontSize,
|
|
557
|
-
anchor: 'middle',
|
|
558
|
-
paint: { fill: textColor },
|
|
559
|
-
}, renderMultilineText(rel.toCardinality, p.x + offset.x, p.y + offset.y, style.edgeLabelFontSize, textAttrs)))
|
|
560
|
-
}
|
|
561
|
-
|
|
562
|
-
return out
|
|
563
|
-
}
|
|
564
|
-
|
|
565
|
-
function pointsToPathD(points: Array<{ x: number; y: number }>, radius: number): string {
|
|
566
|
-
if (points.length === 0) return ''
|
|
567
|
-
if (points.length === 1) return `M${points[0]!.x},${points[0]!.y}`
|
|
568
|
-
const parts = [`M${points[0]!.x},${points[0]!.y}`]
|
|
569
|
-
for (let i = 1; i < points.length - 1; i++) {
|
|
570
|
-
const prev = points[i - 1]!
|
|
571
|
-
const curr = points[i]!
|
|
572
|
-
const next = points[i + 1]!
|
|
573
|
-
const prevLen = Math.abs(curr.x - prev.x) + Math.abs(curr.y - prev.y)
|
|
574
|
-
const nextLen = Math.abs(next.x - curr.x) + Math.abs(next.y - curr.y)
|
|
575
|
-
const r = Math.min(radius, prevLen / 2, nextLen / 2)
|
|
576
|
-
if (r <= 0) {
|
|
577
|
-
parts.push(`L${curr.x},${curr.y}`)
|
|
578
|
-
continue
|
|
579
|
-
}
|
|
580
|
-
const before = pointToward(curr, prev, r)
|
|
581
|
-
const after = pointToward(curr, next, r)
|
|
582
|
-
parts.push(`L${before.x},${before.y}`)
|
|
583
|
-
parts.push(`Q${curr.x},${curr.y} ${after.x},${after.y}`)
|
|
584
|
-
}
|
|
585
|
-
const last = points[points.length - 1]!
|
|
586
|
-
parts.push(`L${last.x},${last.y}`)
|
|
587
|
-
return parts.join(' ')
|
|
588
|
-
}
|
|
589
|
-
|
|
590
|
-
function pointToward(from: { x: number; y: number }, to: { x: number; y: number }, distance: number): { x: number; y: number } {
|
|
591
|
-
const total = Math.abs(to.x - from.x) + Math.abs(to.y - from.y)
|
|
592
|
-
if (total === 0) return { ...from }
|
|
593
|
-
const t = distance / total
|
|
594
|
-
return {
|
|
595
|
-
x: Math.round((from.x + (to.x - from.x) * t) * 1000) / 1000,
|
|
596
|
-
y: Math.round((from.y + (to.y - from.y) * t) * 1000) / 1000,
|
|
597
|
-
}
|
|
598
|
-
}
|
|
599
|
-
|
|
600
|
-
/** Get the midpoint of a point array */
|
|
601
|
-
function midpoint(points: Array<{ x: number; y: number }>): { x: number; y: number } {
|
|
602
|
-
if (points.length === 0) return { x: 0, y: 0 }
|
|
603
|
-
const mid = Math.floor(points.length / 2)
|
|
604
|
-
return points[mid]!
|
|
605
|
-
}
|
|
606
|
-
|
|
607
|
-
/** Calculate offset for cardinality label perpendicular to edge direction */
|
|
608
|
-
function cardinalityOffset(
|
|
609
|
-
from: { x: number; y: number },
|
|
610
|
-
to: { x: number; y: number }
|
|
611
|
-
): { x: number; y: number } {
|
|
612
|
-
const dx = to.x - from.x
|
|
613
|
-
const dy = to.y - from.y
|
|
614
|
-
// Place label perpendicular to the edge, 14px away
|
|
615
|
-
if (Math.abs(dx) > Math.abs(dy)) {
|
|
616
|
-
// Mostly horizontal — offset vertically
|
|
617
|
-
return { x: dx > 0 ? 14 : -14, y: -10 }
|
|
618
|
-
}
|
|
619
|
-
// Mostly vertical — offset horizontally
|
|
620
|
-
return { x: -14, y: dy > 0 ? 14 : -14 }
|
|
621
|
-
}
|
|
622
|
-
|
|
623
|
-
// ============================================================================
|
|
624
|
-
// Utilities
|
|
625
|
-
// ============================================================================
|
|
626
|
-
|
|
627
|
-
function letterAttr(value: number): string {
|
|
628
|
-
return value !== 0 ? ` letter-spacing="${value}"` : ''
|
|
629
|
-
}
|
|
630
|
-
|
|
631
|
-
// Use shared escapeXml from multiline-utils
|
|
632
|
-
const escapeXml = escapeXmlUtil
|
|
633
|
-
|
|
634
|
-
|
|
635
|
-
/**
|
|
636
|
-
* Escape a string for use as an XML/HTML attribute value.
|
|
637
|
-
* Escapes quotes and ampersands to prevent attribute injection.
|
|
638
|
-
*/
|