WORK-358
ID:WORK-358Status:done

Engine config variants: RuneConfig.variants type + axis validation

Add the variants field to RuneConfig — modifier-keyed config deltas — and validate at config load that every variant axis is a declared modifier. This is the foundational type + validation layer for engine config variants.

Priority:criticalComplexity:moderateMilestone:v0.20.0Source:SPEC-091
main View source

Criteria completion

Criteria completion: 3 of 3 (100%) checked; history from Jun 9 to Jun 90%25%50%75%100%Jun 9Jun 9

Relationships

Implements 1
Branches 2
main current done
claude/mcp-server-verify-4lnxej readyclaude/spec-091-engine-variants done
History 4
  1. b6c8084
    • ☑ `RuneConfig.variants?: Record<modifier, Record<value, Partial<RuneConfig>>>` exists in `packages/transform/src/types.ts`.
    • ☑ A `variants` axis with no matching `modifiers` entry is a config error at load.
    • ☑ A delta may override assembly/decoration fields (`layout`/`structure`/`styles`/`contentWrapper`/`staticModifiers`/`autoLabel`/`editHints`) but not identity fields (`block`/modifier axes/`sections` keys); the allow-list is enforced.
    by bjornolofandersson
  2. 4ece0ce
    Content editedby Claude
    plan: mark Batch 1 (SPEC-091 engine config variants) done
  3. 9c0545a
    Created (ready)by bjornolofandersson
  4. 1da59d6
    Content editedby Claude
    plan: add v0.20.0 milestone and break down SPEC-086..091 into work items

Acceptance Criteria

  • RuneConfig.variants?: Record<modifier, Record<value, Partial<RuneConfig>>> exists in packages/transform/src/types.ts.
  • A variants axis with no matching modifiers entry is a config error at load.
  • A delta may override assembly/decoration fields (layout/structure/styles/contentWrapper/staticModifiers/autoLabel/editHints) but not identity fields (block/modifier axes/sections keys); the allow-list is enforced.

Approach

Mirror the CVA/Tailwind-variants shape but drop the predicate DSL and defaultVariants — the axis is an existing modifier. See SPEC-091 §1, §4.

References

  • SPEC-091

Resolution

Completed: 2026-06-09

Branch: claude/spec-091-engine-variants

What was done

  • Added RuneConfig.variants?: Record<axis, Record<value, Partial<RuneConfig>>> to packages/transform/src/types.ts.
  • packages/transform/src/validate.ts: every variant axis must be a declared modifier (config error otherwise); deltas may not override identity fields (block/modifiers/sections/variants).
  • Tests in packages/transform/test/variants.test.ts cover both invariants.

Notes

  • Identity protection is enforced as a denylist of the named identity fields, matching the AC.