feat: Updates to ThemeProvider, tokens, and transform to allow Logical vs Physical prop resolution

[LinKCoding]

Overview

PR Checklist

• Related to designs:
• Related to JIRA ticket: [ABC-123]
• I have run this code to verify it works
• This PR includes unit tests for the code change
• This PR includes testing instructions tests for the code change
• The alpha package of this PR is passing end-to-end tests in all relevant Codecademy repositories

Testing Instructions

Don't make me tap the sign.

1. Go to story X
2. Do something
3. Do that something in dark mode
4. Check it with VO
5. Finish and do a celebratory dance

PR Links and Envs

Repository	PR Link
Monolith	Monolith PR
Mono	Mono PR

[nx-cloud]

View your CI Pipeline Execution ↗ for commit 182e36b

---

☁️ Nx Cloud last updated this comment at 2026-01-16 21:06:06 UTC

[nx-cloud]

🤖 Nx Cloud AI Fix Eligible

An automatically generated fix could have helped fix failing tasks for this run, but Self-healing CI is disabled for this workspace. Visit workspace settings to enable it and get automatic fixes in future runs.

_{To disable these notifications, a workspace admin can disable them in workspace settings.}

---

View your CI Pipeline Execution ↗ for commit 14d2a65

Command	Status	Duration	Result
nx run-many --target=build --all	❌ Failed	3s	View ↗

---

☁️ Nx Cloud last updated this comment at 2026-01-13 20:18:04 UTC

[codecademydev]

📬 Published Alpha Packages:

@codecademy/gamut@67.6.4-alpha.d8f776.0
@codecademy/gamut-icons@9.54.1-alpha.d8f776.0
@codecademy/gamut-illustrations@0.58.1-alpha.d8f776.0
@codecademy/gamut-kit@0.6.577-alpha.d8f776.0
@codecademy/gamut-patterns@0.10.20-alpha.d8f776.0
@codecademy/gamut-styles@17.11.1-alpha.d8f776.0
@codecademy/gamut-tests@5.2.18-alpha.d8f776.0
@codecademy/styleguide@78.5.6-alpha.d8f776.0
@codecademy/variance@0.25.1-alpha.d8f776.0

[github-actions]

🚀 Styleguide deploy preview ready!

Preview URL: https://696aa8db31a00121a37f9c47--gamut-preview.netlify.app
Deploy Logs: https://app.netlify.com/projects/gamut-preview/deploys/696aa8db31a00121a37f9c47