Skip to content

[FIR-317] Align the flydocs badge neutral chip with the warm ramp - #60

Merged
mfg1986 merged 6 commits into
developfrom
feature/FIR-317_badge-neutral-warm-token
Jul 22, 2026
Merged

[FIR-317] Align the flydocs badge neutral chip with the warm ramp#60
mfg1986 merged 6 commits into
developfrom
feature/FIR-317_badge-neutral-warm-token

Conversation

@mfg1986

@mfg1986 mfg1986 commented Jul 22, 2026

Copy link
Copy Markdown
Contributor

What

Resolves the badge neutral-chip parity delta flagged by the FF-CAT-20 gate (FIR-317, from FIR-294's parity report): the flydocs playground theme now pins --ff-badge-neutral-bg (component token shipped in design-system 0.4.0 by FIR-316 — zero package changes) to Flydocs' warm neutral-chip role #f6f3ec, light mode only.

  • Dark deliberately unchanged: the source product's dark theme does not repin its neutral-chip role. The token is reset to initial in the dark block so the badge falls through to the dark neutral repin — fixes a light-into-dark leak caught by pixel-sampling during re-baselining.
  • Docs updated: token-equivalence caveat rewritten; parity report flips ff-badge ⚠️ → ✅ (new "Resolved deltas" section).
  • VR: wave-2 light darwin baseline regenerated; wave-2 linux baselines deleted (reseed via the seed_vr_baselines dispatch after merge).

How to verify

  • pnpm nx e2e playground-e2e — 15/15 (run twice, stable).
  • pnpm nx serve playground --port 4300 → /parity, flydocs theme: neutral badge reads warm in light, unchanged in dark.

Traceability

Board ticket without owning PASO: key in branch and commit subjects.

mfg1986 added 6 commits July 22, 2026 11:02
The badge's neutral-chip role in Flydocs points at the warm ramp
(#f6f3ec), not the cool neutral-100 every other themed surface
reuses. Pin `--ff-badge-neutral-bg`, the existing component token
consumed by ff-badge, in the flydocs playground fixture so the
neutral chip matches without touching any other neutral-100
consumer. Dark mode is left unset on purpose: the source product's
own dark theme doesn't repin this role either, so the badge falls
back to its already dark-repinned --ff-color-neutral-100.
Update the neutral-ramp caveat in the token equivalence doc and flip
the ff-badge parity verdict from a flagged delta to resolved, now
that the chip resolves through its own overridable component token
pinned to the warm value Flydocs' own neutral-chip role uses.
The flydocs light block is scoped to `:root[data-brand='flydocs']`
with no `data-theme` condition, so any property it sets stays in
effect under `[data-theme='dark']` unless the dark block explicitly
cancels it. `--ff-badge-neutral-bg` was missing that reset, so the
warm light pin was leaking into dark mode and washing out the
neutral badge (most visibly the tab-bar's count badge). Reset it to
`initial` in the dark block so the badge correctly falls through to
its already dark-repinned `--ff-color-neutral-100` fallback.
The badge's neutral chip now renders warm under the flydocs light
theme. Dark is byte-identical to before (the token stays unset
there), so only the light baseline needed a refresh. Verified with a
full playground-e2e run (15/15 green, no other baseline moved).
@mfg1986
mfg1986 merged commit 9702eed into develop Jul 22, 2026
5 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant