Implement YAML-LD and Markdown-LD LSP support on SWLS
Decided · 23 August 2026
Context
This ADR evaluates foundations for a generic LSP supporting JSON-LD, YAML-LD, and Markdown-LD, without assigning it to a particular consumer.
Requirements
Parse JSON-LD, YAML-LD, and Markdown-LD while preserving authored source spans.
Interpret JSON-LD contexts, including @type: @id coercion, to distinguish IRI-valued values from literals.
Expose IRI-valued values as clickable document links.
Make Go to Definition return every matching definition in the workspace when an IRI has several definitions.
Resolve relative local IRIs and support unsaved buffers.
Decision
Assessment legend. These are ADR judgments derived from the linked universe
checklists. ★★ means
Medium relative implementation difficulty; ★★★
means Hard relative implementation difficulty. ✓✓✓
means three of three expected LSP reuse; ✓✓
means two of three; ✓
means one of three; and ∅
means zero of three.
means shared upstream plus local extensions;
means a fork or extraction plus replacement pipeline; and
means locally owned new or full server layers.
Chosen