Skip to content

refactor(plantuml): replace linker with idmap-based cross-diagram linking#290

Open
AAmbuj wants to merge 1 commit into
eclipse-score:mainfrom
AAmbuj:amsh_plantuml_linker_review_refactor
Open

refactor(plantuml): replace linker with idmap-based cross-diagram linking#290
AAmbuj wants to merge 1 commit into
eclipse-score:mainfrom
AAmbuj:amsh_plantuml_linker_review_refactor

Conversation

@AAmbuj

@AAmbuj AAmbuj commented Jun 24, 2026

Copy link
Copy Markdown
Contributor

Replace the separate linker tool with idmap sidecar files emitted directly by the parser.

Key changes:

  • Add puml_idmap crate: emits *.idmap.json sidecars with defines/references roles detected from diagram structure (component children, class methods/ variables, sequence participants)
  • Extend puml_cli with --source-name and --idmap-output-dir args; use the workspace-relative path identity instead of the basename for a stable, path-unique source identifier
  • Rewrite clickable_plantuml Sphinx extension: load idmaps at builder-inited, resolve references via FQN→alias lookup with a proximity tiebreak and a tie→no-link guard; emit correct relative URLs for svg_obj mode; and percent-encode injected PlantUML URLs
  • Update architectural_design.bzl: parser now emits 3 outputs (fbs, lobster, idmap); remove linker action and _linker attr
  • Delete plantuml/linker (replaced by idmap approach)

…king

Replace the separate linker tool with idmap sidecar files emitted directly
by the parser.

Key changes:
- Add puml_idmap crate: emits *.idmap.json sidecars with defines/references
  roles detected from diagram structure (component children, class methods/
  variables, sequence participants)
- Extend puml_cli with --source-name and --idmap-output-dir args; use the
  workspace-relative path identity instead of the basename for a stable,
  path-unique source identifier
- Rewrite clickable_plantuml Sphinx extension: load idmaps at builder-inited,
  resolve references via FQN→alias lookup with a proximity tiebreak and a
  tie→no-link guard; emit correct relative URLs for svg_obj mode; and
  percent-encode injected PlantUML URLs
- Update architectural_design.bzl: parser now emits 3 outputs (fbs, lobster,
  idmap); remove linker action and _linker attr
- Delete plantuml/linker (replaced by idmap approach)
@AAmbuj AAmbuj force-pushed the amsh_plantuml_linker_review_refactor branch from 6b7cf91 to 024b9b9 Compare June 24, 2026 10:06
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

Status: No status

Development

Successfully merging this pull request may close these issues.

1 participant