WORK-195
ID:WORK-195Status:ready

Update TintTokens / TintDefinition types

Replace TintTokenSet with TintTokens, rename five field names to match the token contract (background → bg, primary → text, secondary → muted, accent → primary, surface unchanged), and replace the three-valued mode field on TintDefinition with lockMode?: 'light' | 'dark'. Add extends?: string for tint variants. Pure type-surface work; downstream items wire up the merge logic, engine emit, and CSS bridge.

Priority:highComplexity:smallMilestone:v0.14.0Source:SPEC-053
claude/spec-053-tint-authoring-notes View source

Criteria completion

Criteria completion: 0 of 7 (0%) checked; tracking started on May 18, no incremental history yet0%25%50%75%100%May 18Jun 15

Tracking started May 18 — check back for trends.

Relationships

Implements 1
Related 5
Branches 2
claude/spec-053-tint-authoring-notes current ready
main doneclaude/v0.14.0-spec-053-tint-vocab done
History 1
  1. 8df92a3
    Created (ready)by bjornolofandersson

Acceptance Criteria

  • TintTokens interface exported from packages/transform/src/types.ts with the six aligned field names (bg, surface, text, muted, primary, border)
  • TintTokenSet removed; downstream imports updated
  • TintDefinition updated: mode removed, lockMode?: 'light' | 'dark' added, extends?: string added
  • SiteConfig.tints in packages/types/src/theme.ts typed as Record<string, TintDefinition> (no more Record<string, unknown>)
  • RefraktConfig.tints (the deprecated flat-shape field) removed entirely — per SPEC-053 decision
  • JSDoc on every renamed field clearly states the target --rf-color-* token
  • Build passes; downstream packages that read TintTokenSet get clear migration errors (since this lands before WORK-198 migrates the actual configs)

Approach

Single type-rename PR. Mechanical change to packages/transform/src/types.ts and the corresponding import in packages/types/src/theme.ts.

Build will break immediately in packages/lumina/src/config.ts and any plugin that defines tints — that's expected and gets fixed in WORK-198. Order matters: this type-only PR lands first, then the engine/CSS/config updates land together.

Dependencies

None (or minimal — does not require SPEC-048 to be implemented). Independent of the rest of the SPEC-048 chain; can start in parallel.

References

  • SPEC-053 — full rationale for each rename and the mode → lockMode simplification
  • packages/transform/src/types.ts — file being edited
  • packages/types/src/theme.ts — file being edited