[chrisschnaars]

Summary

• tailwindCompiler/TailwindStyle accept a new darkModeRootSelector option. When supplied, the generated dark: custom-variant is scoped to that root's own [darkModeDataAttribute], self or descendant, instead of matching the attribute on any ancestor.
• Omitted (the default), behavior is byte-for-byte unchanged from today.
• Mirrors when-color-mode-dark($root) (styles/mixins/when-color-mode-dark.scss, added in feat: update dark mode mixin #1596) — same rationale: a page can have two independent data-color-mode scopes (e.g. readme's SuperHub admin shell vs. the hub content it's previewing), and the current ancestor-matching selector can't tell them apart. No default root selector is provided, for the same reason when-color-mode-dark doesn't have one — see that mixin's doc comment, and the new doc comment on tailwindCompiler's darkModeRootSelector param, for the full reasoning.

Test plan

• __tests__/utils/tailwind-compiler.test.ts (new) — unit-tests the generated @custom-variant dark (...) string directly (spies on tailwindcss.compile since the real compile pipeline needs this package's production string-import loaders, which aren't wired into vitest — same reason the existing TailwindStyle.test.tsx mocks tailwindCompiler rather than exercising real output)
• __tests__/components/TailwindStyle.test.tsx — new case confirming darkModeRootSelector threads through to tailwindCompiler
• npx vitest run on both files — 9/9 passing
• npx eslint — clean
• npx tsc --noEmit — no new errors

🤖 Generated with Claude Code

[greptile-apps]

Confidence Score: 5/5

The PR appears safe to merge, with no concrete changed-code-triggered failures identified.

The documented single-root selector is propagated consistently, its generated CSS preserves the prior default behavior, and the new behavior is covered at both the compiler and component boundaries.

Important Files Changed

Filename	Overview
utils/tailwind-compiler.ts	Adds the optional root selector to dark-variant generation while retaining the previous unscoped selector when omitted.
components/TailwindStyle/index.tsx	Exposes and forwards the new selector option and recompiles when it changes.
tests/utils/tailwind-compiler.test.ts	Verifies scoped, fallback, and disabled custom-variant strings.
tests/components/TailwindStyle.test.tsx	Verifies that TailwindStyle forwards both dark-mode options to the compiler.

_{Reviews (1): Last reviewed commit: "feat: support scoping the dark: variant ..." | Re-trigger Greptile}

[rafegoldberg]

This PR was released!

🚀 Changes included in v15.4.0