Acceptance Criteria
tint is a facet owning TINT_TOKENS; step 1d is gone from engine.ts- The facet emits
data-tint, data-color-scheme, data-tint-dark, the --tinted BEM modifier, and --tint-* / --tint-dark-* custom properties, all unchanged - It claims its meta fields via
consumes; the tintMetaProps set is gone color-scheme is published as facet state (or an axis, whichever matches its emission) so the color-scheme seed entry can be dropped, and any consumer reads it via ctx.axis()- Inline token metas continue to override preset values, and
lockMode continues to resolve mode when the author sets none - All 630 pre-existing transform tests pass unmodified, including
tint-extends.test.ts and scoped-tint-stylesheet.test.ts - Unit tests cover preset resolution, inline override precedence,
lockMode, and dark-token emission npm run build, the full repo suite, and refrakt contracts --check pass
Approach
Tint is a large but self-contained block: it reads tint / tint-mode metas plus six tint-<token> and six tint-dark-<token> metas, resolves a named definition from theme.tints, and merges inline overrides on top. It has one outward coupling — data-color-scheme — which both the bg scrim and cover's foreground polarity consult.
Style ordering matters: the --tint-* declarations currently land after config.styles and before anything facet-supplied. Keep them in that relative position when they move into the resolution's styles list, and verify with a rune that sets both a tint and a config.styles entry.
References
- SPEC-124 — facet registry (the spec this work item realizes)
- SPEC-053 — tint shape alignment and the six-token vocabulary
- SPEC-052 — per-page and per-subtree tint cascade
Resolution
Completed: 2026-08-27
Branch: claude/transform-package-refactor-7mxi8a
What was done
packages/transform/src/facets/tint.ts — the SPEC-053 axis, owning TINT_TOKENS. Named-definition lookup, inline tint-<token> / tint-dark-<token> overrides, lockMode, the --tint-* custom properties, the --tinted modifier, and the data-tint / data-color-scheme / data-tint-dark markers.packages/transform/src/facets/cover.ts — now declares after: ['tint'] and reads the colour scheme through ctx.axis().packages/transform/src/engine.ts — step 1d gone, along with TINT_TOKENS, the tintMetaProps / tintDataAttrs / tintStyleParts locals and the color-scheme seed entry for the resolve pass. Down to 1805 lines from 2223 before the facet work began.packages/transform/test/facets/tint.test.ts — 19 tests covering preset resolution, inline-override precedence, lockMode, dark-token emission, the tinted-marker condition and the state channel.
Notes
Tint publishes the resolved scheme as facet state rather than an emitted axis, since the attribute is set directly and state is the channel for cross-facet reads that must not become data-*. That retires one seed entry: cover reads the scheme from tint instead of from the engine's internal tintDataAttrs bag. The background layer keeps its own seeded claim until WORK-520.
Adding after: ['tint'] to cover immediately failed cover.test.ts, whose deliberately-minimal two-facet registry did not include tint — the driver's dangling-dependency guard behaving exactly as designed. Fixed by declaring tint seeded in that registry, which is the accurate description of what the test isolates.
One benign output difference, not byte-identical. The --tinted modifier now follows --width / --spacing / --inset in the class attribute instead of preceding them, because the facet pass runs at a fixed point after those still-inline axes. Class order carries no CSS meaning (no effect on matching or specificity) and no test pinned it — checked before relying on that — but it is an output change and is recorded in the changeset rather than described as byte-identical. It resolves when those axes migrate under WORK-521.
Inline-style declaration order is preserved: tint registers first, so its --tint-* declarations still lead the style string. That one matters, because CSS duplicate declarations resolve last-wins.
All 630 pre-existing transform tests pass unmodified.