Three live pages point a file-ref at a line range that no longer contains the symbol it is labelled with — and no longer exists in the file at all. This is the exact failure SPEC-131 describes as its motivating case, observed rather than predicted.
b503a01site/content/runes/file-ref.md and find the invocation on line 51: {% file-ref path="packages/types/src/theme.ts" lines="74-125" label="SiteConfig" preview="drawer" /%}SiteConfig.The drawer shows SiteConfig — the interface the label names.
Three things are wrong, compounding:
SiteConfig is not in theme.ts. It lives at packages/types/src/config.ts:42. The symbol moved files; no line range can survive that.theme.ts is 104 lines long; the invocation asks for 74–125, so 21 of the requested lines do not exist.ThemeManifest's SEO fields (defaultImage, logo), then LayoutDefinition (86–93), then the start of ComponentDefinition (95–).So a drawer captioned "SiteConfig" opens onto the back half of one interface and the whole of two others. Nothing warns; the content is real code from a real file, which is what makes it plausible enough to go unnoticed.
| File | Line |
|---|---|
site/content/runes/drawer.md | 155 |
site/content/runes/file-ref.md | 51 |
site/content/runes/file-ref.md | 75 |
All three carry lines="74-125" label="SiteConfig".
Two options, and the second is the point of SPEC-131:
packages/types/src/config.ts with a corrected range. Restores accuracy and leaves the same exposure in place.{% file-ref path="packages/types/src/config.ts" symbol="SiteConfig" preview="drawer" /%}, which makes the next move or rename a named failure instead of a wrong render.Worth doing (1) immediately rather than waiting, since the pages are live and the file-ref doc page is teaching the pattern by example.
This bug is evidence for SPEC-131's Problem section. The spec argued the failure would happen to a SiteConfig reference; it already had, in the documentation for the rune whose addressing model is at issue. Any fix should land alongside the spec's observed-exposure note rather than quietly correcting the range.