Docs plugin migration to metaFields + zones

Phase 2 of SPEC-079. Migrates the docs plugin's meta-bearing runes (Api, Symbol) from the legacy slots + structure config shape to the new metaFields + zones + contentSlots model.

claude/spec-079-implementation View source

Criteria completion

Tracking started Jun 1 — check back for trends.

Relationships

ID:SPEC-079Status:draft

Semantic header zones + per-zone layout primitives for metadata-bearing runes

ID:WORK-305Status:done

Engine + layout primitives + composable runes + Lumina chip-universal

Priority:mediumComplexity:complexMilestone:v0.17.0

ID:WORK-306Status:done

Plan plugin migration to metaFields + zones

Priority:mediumComplexity:moderateMilestone:v0.17.0

ID:WORK-313Status:done

Remove legacy slots + structure shim from engine

Priority:lowComplexity:simpleMilestone:v0.18.0

claude/spec-079-implementation current done

changeset-release/main done main done

Jun 2, 05:39 PM2d85b5f
statusready→done
by bjornolofandersson
Jun 1, 01:36 PM81ceb3b
Content editedby bjornolofandersson
Jun 1, 01:29 PM4f945b1
Created (ready)by bjornolofandersson

Acceptance Criteria

plugins/docs/src/config.ts rewritten.
- Api: method, path, auth. Eyebrow: method (left) + path (right) — the existing HTTP-method-+-route header pattern projected via split. Metadata: auth (when condition met). The method field's sentimentMap preserved verbatim (GET: positive, POST: neutral, PUT: neutral, PATCH: caution, DELETE: negative).
- Symbol: kind, lang, since, deprecated. Eyebrow: kind + deprecated (when set, with negative sentiment from the existing sentimentMap: { true: 'negative' }). Metadata: lang + since.
Per-rune CSS updated. Selectors in plugins/docs/styles/{api,symbol}.css referencing __header-primary / __header-secondary rewritten to __eyebrow / __metadata. API method-pill coloring quirks preserved.
Changelog / SymbolGroup / SymbolMember untouched. Content containers without meta projection — stay on the existing path.
Plugin tests updated. Tests in plugins/docs/test/ that snapshot rune output reflect the new DOM shape.
Backwards-compat shim warning silent for docs.
Docs. Docs rune doc pages (site/content/runes/docs/{api,symbol}.md) — output-contract snippets updated.

Approach

Two-rune migration. Api is the more interesting case (method+path projected as split-eyebrow); Symbol is a trimmed variant. Land both on one branch.

The path field's eyebrow rendering wants monospace (it's a URL pattern) — that comes for free via metaType: 'id', which already carries the monospace typography hint.

Dependencies

WORK-305 — engine + layout primitives (done).
WORK-306 — plan plugin migration reference (done).

References

SPEC-079 — the spec being implemented.

Resolution

Completed: 2026-06-02

Superseded by WORK-318. Targeted the SPEC-079 zones model for the docs plugin (Api, Symbol); the docs package migrated straight to the SPEC-080 blocks/layout model instead (Api eyebrow bar, Symbol eyebrow + source href link + metadata def-list) on branch claude/spec-079-implementation. Same supersession as WORK-310/311/312.