diff --git a/.changeset/config.json b/.changeset/config.json
index 67eba4b98a..60a8f22d4f 100644
--- a/.changeset/config.json
+++ b/.changeset/config.json
@@ -8,9 +8,12 @@
   "fixed": [
     [
       "@skillsoft/gamut-agent-tools",
+      "@skillsoft/gamut-codemods",
       "@skillsoft/gamut-icons",
+      "@skillsoft/gamut-illustrations",
       "@skillsoft/gamut-patterns",
       "@skillsoft/gamut-styles",
+      "@skillsoft/gamut-tests",
       "@skillsoft/gamut",
       "@skillsoft/variance"
     ]
diff --git a/.changeset/consumer-friendly-deps.md b/.changeset/consumer-friendly-deps.md
new file mode 100644
index 0000000000..9056e72ff8
--- /dev/null
+++ b/.changeset/consumer-friendly-deps.md
@@ -0,0 +1,17 @@
+---
+'@skillsoft/gamut': patch
+'@skillsoft/gamut-styles': patch
+'@skillsoft/gamut-icons': patch
+'@skillsoft/gamut-illustrations': patch
+'@skillsoft/gamut-patterns': patch
+'@skillsoft/gamut-tests': patch
+'@skillsoft/variance': patch
+---
+
+Fewer packages to install by hand. `@skillsoft/gamut` now needs only `react`, `react-dom`, `@emotion/react`, and `@emotion/styled` alongside it.
+
+- `@skillsoft/gamut-styles`: `stylis`, `lodash`, and `@emotion/cache` are now regular dependencies instead of peer dependencies.
+- `@skillsoft/gamut-icons`: dropped an unused `lodash` peer dependency.
+- `@skillsoft/variance`: the `typescript` peer dependency is now optional.
+- `@skillsoft/*` packages depend on each other with `^` ranges instead of exact versions, so installs share one copy of `gamut-styles` and `variance`.
+- `@skillsoft/gamut-tests`: `component-test-setup` is now `^0.3.1` instead of `*`.
diff --git a/.changeset/eslint-plugin-gamut-config-types.md b/.changeset/eslint-plugin-gamut-config-types.md
new file mode 100644
index 0000000000..56f5c0aee0
--- /dev/null
+++ b/.changeset/eslint-plugin-gamut-config-types.md
@@ -0,0 +1,5 @@
+---
+'@skillsoft/eslint-plugin-gamut': patch
+---
+
+`configs.recommended` uses literal `'error'` severities, so the plugin type-checks as an ESLint `Plugin` in a typed flat config (`plugins: { gamut }`).
diff --git a/.changeset/gamut-codemods-markdown-video-overrides.md b/.changeset/gamut-codemods-markdown-video-overrides.md
new file mode 100644
index 0000000000..3583e418f8
--- /dev/null
+++ b/.changeset/gamut-codemods-markdown-video-overrides.md
@@ -0,0 +1,5 @@
+---
+'@skillsoft/gamut-codemods': minor
+---
+
+`scope-swap` now covers the Markdown video changes. `<Markdown>` no longer renders `<iframe>` and `<video>` through `Video` by default, and `skipDefaultOverrides.iframe` / `.video` are gone. The new `markdown-video-overrides` migration adds `iframeOverride` / `videoOverride` (with `Iframe` and `MarkdownVideo` imported from `/Video`) to each `<Markdown>` that didn't opt out, so rendering is unchanged. Where a skip was `true`, it writes `iframeOverride={undefined}` so a second run stays a no-op. Video moves also print a checklist item for the `@vidstack/react` and `react-player` peer dependencies.
diff --git a/.changeset/gamut-codemods-scope-swap.md b/.changeset/gamut-codemods-scope-swap.md
new file mode 100644
index 0000000000..f7d48bf20d
--- /dev/null
+++ b/.changeset/gamut-codemods-scope-swap.md
@@ -0,0 +1,5 @@
+---
+'@skillsoft/gamut-codemods': minor
+---
+
+Add `@skillsoft/gamut-codemods` with a `scope-swap` preset for moving a repo from `@codecademy/gamut*` to `@skillsoft/gamut*`. Run `npx @skillsoft/gamut-codemods scope-swap .` from a clean working tree. It renames imports, mocks, and dependencies, moves `Video` imports to `@skillsoft/gamut/Video`, rewrites `/dist/` deep imports, replaces `@codecademy/gamut-kit`, and finishes with a list of what's left to fix by hand.
diff --git a/.changeset/gamut-form-field-styles.md b/.changeset/gamut-form-field-styles.md
new file mode 100644
index 0000000000..d75fa130a5
--- /dev/null
+++ b/.changeset/gamut-form-field-styles.md
@@ -0,0 +1,5 @@
+---
+'@skillsoft/gamut': minor
+---
+
+Export `formFieldStyles`, `formFieldPaddingStyles`, and `conditionalStyles` from the package root, for custom inputs that should look like `Input`, such as third-party hosted payment fields. The rest of `Form/styles` stays internal. Coming from `@codecademy/gamut/dist/Form/styles`, `npx @skillsoft/gamut-codemods scope-swap .` rewrites imports of these three.
diff --git a/.changeset/gamut-menu-selectdropdown-renames.md b/.changeset/gamut-menu-selectdropdown-renames.md
new file mode 100644
index 0000000000..84bcef371e
--- /dev/null
+++ b/.changeset/gamut-menu-selectdropdown-renames.md
@@ -0,0 +1,15 @@
+---
+'@skillsoft/gamut': minor
+---
+
+**Breaking:** export Menu's list elements and SelectDropdown's option component from the package root, under new names that don't collide with the public `List` component and `IconOption` type.
+
+| Old (`dist/Menu/elements`, `dist/Form/SelectDropdown/elements`) | New (`@skillsoft/gamut`)            |
+| --------------------------------------------------------------- | ----------------------------------- |
+| `List`, `ListProps`                                             | `MenuList`, `MenuListProps`         |
+| `ListItem`, `ListItemProps`                                     | `MenuListItem`, `MenuListItemProps` |
+| `ListLink`, `ListLinkProps`                                     | `MenuListLink`, `MenuListLinkProps` |
+| `ListButton`                                                    | `MenuListButton`                    |
+| `IconOption` (the component)                                    | `IconOptionComponent`               |
+
+`MenuToolTipWrapper` is now exported from the root too. The `IconOption` type is unchanged. Coming from `@codecademy/gamut`, `npx @skillsoft/gamut-codemods scope-swap .` rewrites these imports for you.
diff --git a/.changeset/gamut-scope-swap-skill.md b/.changeset/gamut-scope-swap-skill.md
new file mode 100644
index 0000000000..6b3f020472
--- /dev/null
+++ b/.changeset/gamut-scope-swap-skill.md
@@ -0,0 +1,6 @@
+---
+'@skillsoft/gamut-agent-tools': minor
+'@skillsoft/gamut-codemods': patch
+---
+
+Add the `gamut-scope-swap` agent skill. It helps with the `@codecademy/gamut*` to `@skillsoft/gamut*` move alongside the `scope-swap` codemod: it reads the warnings and leftovers, and fixes what the codemod can't rewrite. The codemod README now points to it.
diff --git a/.changeset/gamut-styles-csstype.md b/.changeset/gamut-styles-csstype.md
new file mode 100644
index 0000000000..04e9fc169c
--- /dev/null
+++ b/.changeset/gamut-styles-csstype.md
@@ -0,0 +1,5 @@
+---
+'@skillsoft/gamut-styles': patch
+---
+
+Add `csstype` as a dependency. The published types import from it, and it only resolved before because `@skillsoft/variance` depends on it.
diff --git a/.changeset/gamut-video-node10-and-types.md b/.changeset/gamut-video-node10-and-types.md
new file mode 100644
index 0000000000..2fdaa4c386
--- /dev/null
+++ b/.changeset/gamut-video-node10-and-types.md
@@ -0,0 +1,6 @@
+---
+'@skillsoft/gamut': patch
+---
+
+- `@skillsoft/gamut/Video` now resolves under TypeScript's `moduleResolution: "node"` (node10) and in bundlers that ignore `package.json#exports`, through a `Video/package.json` stub.
+- Export the `HTMLToReactNode` and `ButtonBaseProps` types from the package root.
diff --git a/.changeset/nice-peaches-hear.md b/.changeset/nice-peaches-hear.md
new file mode 100644
index 0000000000..2bdfb62ff3
--- /dev/null
+++ b/.changeset/nice-peaches-hear.md
@@ -0,0 +1,12 @@
+---
+'@skillsoft/eslint-plugin-gamut': patch
+'@skillsoft/gamut': patch
+'@skillsoft/gamut-icons': patch
+'@skillsoft/gamut-illustrations': patch
+'@skillsoft/gamut-patterns': patch
+'@skillsoft/gamut-styles': patch
+'@skillsoft/gamut-tests': patch
+'@skillsoft/variance': patch
+---
+
+Swap Emotion's transform to swc/plugin and explicit type exporting
diff --git a/.eslintignore b/.eslintignore
index 790b3f75f1..3b8050a6ca 100644
--- a/.eslintignore
+++ b/.eslintignore
@@ -12,3 +12,4 @@ packages/gamut-patterns/src/patterns
 packages/code-connect
 .nx
 packages/gamut-agent-tools/skills/*-workspace
+packages/gamut-codemods/**/__testfixtures__
diff --git a/.github/workflows/preview.yml b/.github/workflows/preview.yml
index 441f68ea96..d1caef6201 100644
--- a/.github/workflows/preview.yml
+++ b/.github/workflows/preview.yml
@@ -16,7 +16,10 @@ name: Preview
 
 on:
   pull_request:
-    branches: [main]
+    # TEMPORARY: cass-gmt-1795 is here so PRs stacked on it (the
+    # @skillsoft/gamut-codemods PR) publish previews. Revert this before
+    # either branch ships to main.
+    branches: [main, cass-gmt-1795]
 
 env:
   NODE_OPTIONS: '--max_old_space_size=8196'
diff --git a/.prettierignore b/.prettierignore
index 104cb1cfe7..17524c399a 100644
--- a/.prettierignore
+++ b/.prettierignore
@@ -7,6 +7,8 @@ packages/gamut-patterns/src/patterns
 packages/gamut-styles/**/*.d.ts
 packages/styleguide/stories/Core/Atoms/Markdown/*.md
 packages/code-connect/**/*
+# Codemod fixtures are exact expected output, formatting included.
+packages/gamut-codemods/**/__testfixtures__
 
 /.nx/cache
 /.nx/workspace-data
diff --git a/packages/eslint-plugin-gamut/src/recommended.ts b/packages/eslint-plugin-gamut/src/recommended.ts
index 276967936a..c90fadd436 100644
--- a/packages/eslint-plugin-gamut/src/recommended.ts
+++ b/packages/eslint-plugin-gamut/src/recommended.ts
@@ -6,4 +6,8 @@ export default {
     '@skillsoft/gamut/import-paths': 'error',
     '@skillsoft/gamut/require-styled-target-for-selector': 'error',
   },
-};
+  /*
+    Literal severities, so the export fits ESLint's Plugin type. As `string`,
+    `plugins: { gamut }` in a typed flat config doesn't type-check.
+  */
+} as const;
diff --git a/packages/gamut-agent-tools/README.md b/packages/gamut-agent-tools/README.md
index 3071fb9c49..fe17ea9ce2 100644
--- a/packages/gamut-agent-tools/README.md
+++ b/packages/gamut-agent-tools/README.md
@@ -31,6 +31,12 @@ The first time you run `gamut plugin install` or `update`, it installs `@skillso
 
 Before large PRs, or when onboarding an existing codebase, run the `gamut-review` skill to audit for Gamut usage — dependencies, setup, import patterns, `styled()` wrapping that bypasses system props, hardcoded colors, bespoke component duplication, and test conventions.
 
+### Moving from `@codecademy/gamut`
+
+If your app still depends on `@codecademy/gamut*`, the `gamut-scope-swap` skill helps with the move to `@skillsoft/gamut*`. It works alongside the [`@skillsoft/gamut-codemods`](../gamut-codemods/README.md) `scope-swap` preset. The codemod does the mechanical rewrite. The skill reads what it reports, including warnings, leftovers, and next steps, and helps with the parts it can't rewrite: deep imports, `Video`, renamed Menu exports, tsconfig `dom`, jest mocks, ESLint plugin keys, Module Federation config, and preview builds. It doesn't run the codemod unless you ask it to.
+
+Install the plugin after the swap. The `gamut` CLI comes from `@skillsoft/gamut`, so that package has to be in the app first.
+
 ## The CLI lives here, not in `@skillsoft/gamut`
 
 `@skillsoft/gamut`'s `bin/gamut.mjs` is a thin bootstrap shim: it only knows how to check whether `@skillsoft/gamut-agent-tools` is installed, auto-install it if not (for `install`/`update`), and print help. Once that's resolved, it dynamically imports the actual `install`/`update`/`list`/`remove` command bodies from `cli/commands/plugin/` in *this* package and hands off execution to them.
diff --git a/packages/gamut-agent-tools/skills/gamut-scope-swap/BREAKING_CHANGES.md b/packages/gamut-agent-tools/skills/gamut-scope-swap/BREAKING_CHANGES.md
new file mode 100644
index 0000000000..21e37313db
--- /dev/null
+++ b/packages/gamut-agent-tools/skills/gamut-scope-swap/BREAKING_CHANGES.md
@@ -0,0 +1,29 @@
+# Breaking changes: `@codecademy/gamut*` → `@skillsoft/gamut*`
+
+Short list of what changed. The codemod handles most of these. Entries marked **manual** need a person. Source: `packages/gamut-codemods/src/presets/scope-swap/manifest.ts`.
+
+## Packages
+
+- Every `@codecademy/*` Gamut package is now `@skillsoft/*`: `gamut`, `gamut-styles`, `gamut-icons`, `gamut-illustrations`, `gamut-patterns`, `gamut-tests`, and `variance`.
+- `eslint-plugin-gamut` is now `@skillsoft/eslint-plugin-gamut`.
+- `@codecademy/gamut-kit` is removed, with no replacement. Depend on the individual packages it bundled.
+
+## Imports
+
+- `Video` and `VideoProps` moved off the root. Import them from `@skillsoft/gamut/Video`. **Manual** for namespace imports and `export *`.
+- Menu's `List`, `ListProps`, `ListItem`, `ListItemProps`, `ListLink`, `ListLinkProps`, and `ListButton` are renamed `MenuList*` and `MenuListButton`. The codemod keeps local names with an alias, e.g. `MenuList as List`.
+- SelectDropdown's `IconOption` is renamed `IconOptionComponent`.
+- `ButtonBase` is not public. Use `FillButton`, `StrokeButton`, `TextButton`, `IconButton`, or `CTAButton`. **Manual.**
+- From `Form/styles`, only `formFieldStyles`, `formFieldPaddingStyles`, and `conditionalStyles` are public. Anything else there is internal. **Manual.**
+- Deep `/dist/` imports for these are promoted to the package root: form and select types, `Box`, `Tip`, `Button`, `Markdown` overrides, `AssetProvider`, the icon `types` and `props`, and the variance config types. Any `dist` path not on that list is unmapped. **Manual.**
+
+## Runtime
+
+- Gamut is now a real singleton. Module Federation host and remotes must share the same version, so update each remote's `shared` config and deploy them together. **Manual.**
+- Next.js apps that set `experimental.esmExternals: false` can fail to build or prerender on `@emotion/*` or `react-select` default imports. Remove `esmExternals: false` and any `@emotion/*` aliases. If you can't yet, see `NEXT_EMOTION_INTEROP.md` for the fallback. **Manual.**
+
+## Build and tooling
+
+- `Video` used to bring DOM types in through the root import. Add `"dom"` to a tsconfig's `lib` if type-checking fails after the move. **Manual.**
+- ESLint rule prefix `gamut/` becomes `@skillsoft/gamut/` in directives and legacy configs. Rule names don't change. Flat configs need the plugin registered under the matching key. **Manual** for flat configs.
+- Jest mocks of the root package that stub `Video` should mock `@skillsoft/gamut/Video`. **Manual.**
diff --git a/packages/gamut-agent-tools/skills/gamut-scope-swap/NEXT_EMOTION_INTEROP.md b/packages/gamut-agent-tools/skills/gamut-scope-swap/NEXT_EMOTION_INTEROP.md
new file mode 100644
index 0000000000..736e0e62e9
--- /dev/null
+++ b/packages/gamut-agent-tools/skills/gamut-scope-swap/NEXT_EMOTION_INTEROP.md
@@ -0,0 +1,49 @@
+# Next.js and Emotion default imports
+
+Use this if a Next.js app fails after moving to `@skillsoft/gamut*`.
+
+## Symptoms
+
+- Production build or prerender fails with `Element type is invalid: expected a string ... but got: object`. This often comes from `SelectDropdown`, which uses `react-select`.
+- The server fails in `_app` with `c(...) is not a function`.
+
+## Cause
+
+With `experimental.esmExternals: false`, Next `require()`s every server external package. `@skillsoft/gamut` and `@skillsoft/gamut-styles` ship strict ESM `.mjs` files. A default import of a CJS package that sets `__esModule` (`react-select`, `@emotion/styled`, `@emotion/cache`, `@emotion/is-prop-valid`) gets the whole module object instead of the default export.
+
+## Fix: use native ESM externals
+
+1. Remove `experimental.esmExternals: false` from `next.config.js`.
+2. Remove any `resolve.alias` entries for `@emotion/is-prop-valid`, `@emotion/styled`, or `@emotion/cache`.
+3. Remove `@emotion/*` and `react-select` from `transpilePackages`. Keep `@skillsoft/*` packages there if they ship CSS imports.
+
+Next then loads externals with `import()`, so Node resolves each package's `import` entry and default imports work. To confirm, check that the server bundle emits `import("react-select")` instead of `require("react-select")`.
+
+## Fallback: keep `esmExternals: false`
+
+If the app can't drop `esmExternals: false` yet, point the Emotion packages at their ESM builds and transpile them:
+
+```js
+const path = require('path');
+
+const emotionEsm = (pkg, file) =>
+  path.join(path.dirname(require.resolve(`${pkg}/package.json`)), 'dist', file);
+
+// Inside webpack(config, { isServer }), merge into resolve.alias:
+'@emotion/is-prop-valid$': emotionEsm(
+  '@emotion/is-prop-valid',
+  'emotion-is-prop-valid.esm.js'
+),
+'@emotion/styled$': emotionEsm(
+  '@emotion/styled',
+  isServer ? 'emotion-styled.esm.js' : 'emotion-styled.browser.esm.js'
+),
+'@emotion/cache$': emotionEsm(
+  '@emotion/cache',
+  isServer ? 'emotion-cache.esm.js' : 'emotion-cache.browser.esm.js'
+),
+```
+
+Add `@emotion/is-prop-valid`, `@emotion/styled`, `@emotion/cache`, and `react-select` to `transpilePackages`.
+
+Plan to remove this fallback. It only exists to work around the `esmExternals` setting.
diff --git a/packages/gamut-agent-tools/skills/gamut-scope-swap/SKILL.md b/packages/gamut-agent-tools/skills/gamut-scope-swap/SKILL.md
new file mode 100644
index 0000000000..b9e9ed9ed7
--- /dev/null
+++ b/packages/gamut-agent-tools/skills/gamut-scope-swap/SKILL.md
@@ -0,0 +1,120 @@
+---
+name: gamut-scope-swap
+description: Use this skill when moving an app from @codecademy/gamut* packages to @skillsoft/gamut* — running or re-running the scope-swap codemod (@skillsoft/gamut-codemods), triaging its warnings and leftovers, and fixing what it can't rewrite, such as deep imports, Video, renamed Menu exports, tsconfig dom, jest mocks, ESLint plugin keys, Module Federation shared config, the removed gamut-kit, and preview builds. Not for day-to-day Gamut usage after the move (see gamut-review) or for building new UI.
+---
+
+# Gamut Scope Swap
+
+Help an app move from `@codecademy/gamut*` to `@skillsoft/gamut*`. The codemod does the mechanical rewrite. This skill covers what the codemod reports, what it leaves for a person, and how to check the result.
+
+For a short overview of every breaking change, read [BREAKING_CHANGES.md](BREAKING_CHANGES.md). Load it only when you need the full list. The sections below cover triage.
+
+Sources of truth, in order:
+
+1. The codemod's README in `@skillsoft/gamut-codemods`, and `npx @skillsoft/gamut-codemods list` for the migrations in each preset.
+2. The installed `@skillsoft/gamut` type declarations in `node_modules`. Before you suggest an import, confirm the symbol is actually exported there. Don't invent replacements.
+3. The rest of the Gamut skills in this plugin, for choosing a replacement component or style API.
+
+## Workflow
+
+1. **Check the starting state.** Run `git status`. The codemod refuses to write into uncommitted changes unless it gets `--force`. If the tree is dirty, ask the user to commit or stash first. Don't add `--force` on your own.
+2. **Preview.** Run `npx @skillsoft/gamut-codemods scope-swap . --dry`. It prints every file it would change and its warnings, and writes nothing. Run this before a real run.
+3. **Run it,** once the user confirms: `npx @skillsoft/gamut-codemods scope-swap .`. Options:
+   - `--only=deep-imports,scope-rename` runs a subset of migrations.
+   - `--no-report` skips the leftovers report.
+   - To undo a run, `git checkout .`. That only restores the original state if the tree was clean before the run.
+4. **Triage the output in this order.** Warnings first, because some change runtime behavior. Then leftovers. Then next steps.
+5. **Verify.** Reinstall with `yarn`, run the formatter, then type-check, lint, test, and build. If the app uses Module Federation, test the host and its remotes together.
+
+If the codemod has already run, ask the user to paste the warnings and the leftovers list. If they can't, find the old names yourself. Exclude lockfiles and build output:
+
+```sh
+grep -rn "@codecademy/gamut" --exclude-dir=node_modules --exclude-dir=dist --exclude=yarn.lock .
+```
+
+## Warnings
+
+Each warning starts with `[migration-name] file:line`. The migration name tells you what to check. A skipped migration prints `[migration-name] skipped: <reason>` before the run. `eslint-comments` skips itself when the repo has a flat ESLint config (see Leftovers).
+
+| Migration                  | Warning starts with                                                             | What to do                                                                                                                                                                                                                                                        |
+| -------------------------- | ------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `deep-imports`             | `unmapped deep import '…'`                                                      | The codemod has no mapping for this path. Find the symbol in the installed `@skillsoft/gamut` types. If it's exported from the root, import it from there. If it isn't public, don't deep-import the `dist` path. Ask the Gamut team.                             |
+| `deep-imports`             | `… has no public replacement`                                                   | `ButtonBase` is deliberately private. Use `FillButton`, `StrokeButton`, `TextButton`, `IconButton`, or `CTAButton`. See the `gamut-buttons` skill for which one.                                                                                                  |
+| `deep-imports`             | `… is only partly public`                                                       | Only some names from this path are public. Inline the styles, or use system props or `css()`. See `gamut-style-utilities` and `gamut-system-props`.                                                                                                               |
+| `deep-imports`             | `deep import … in a mock or require() needs a manual rewrite`                   | Rewrite the mock or `require()` path by hand.                                                                                                                                                                                                                     |
+| `deep-imports`             | `rewrote … in a mock or require(). That now covers the whole package`           | `jest.mock` of a deep path now mocks the whole package. Check the test still mocks what it needs. If the rename list applies, update renamed names too.                                                                                                           |
+| `moved-exports`            | `namespace import uses …`                                                       | `import * as Gamut` can't be rewritten safely. Replace it with named imports. `Video` and `VideoProps` come from `@skillsoft/gamut/Video`.                                                                                                                        |
+| `moved-exports`            | `'export *' from … no longer re-exports …`                                      | Add an explicit re-export from `@skillsoft/gamut/Video` if other code depends on it.                                                                                                                                                                              |
+| `moved-exports`            | `mock of … stubs Video/VideoProps`                                              | Mock `@skillsoft/gamut/Video` instead of the root package.                                                                                                                                                                                                        |
+| `markdown-video-overrides` | `skipDefaultOverrides is not an object literal` or `… is not a boolean literal` | The codemod couldn't tell whether this `<Markdown>` opted out of iframes or videos. Pass `iframeOverride={Iframe}` and `videoOverride={MarkdownVideo}` (both from `@skillsoft/gamut/Video`) unless it skipped them.                                               |
+| `markdown-video-overrides` | `a different import already uses the name Iframe or MarkdownVideo`              | Import the overrides under another local name and pass them by hand.                                                                                                                                                                                              |
+| `scope-rename`             | `'@codecademy/gamut-kit' has no replacement package`                            | `gamut-kit` is removed, with no `@skillsoft` replacement. Depend on the individual packages it bundled.                                                                                                                                                           |
+| `scope-rename`             | `renamed N package-name string(s) outside imports. Check the diff.`             | Review those lines in the diff. They're usually config or log strings, and a few may not be package names at all.                                                                                                                                                 |
+| `package-json`             | `…: replaced '@codecademy/gamut-kit' with its individual packages`              | The individual packages are written at the release range (`^<version>`), not at the kit's old version. They all land in the field `gamut-kit` was in, so `@skillsoft/gamut-tests` may end up in `dependencies`. Move it to `devDependencies` if it belongs there. |
+| `package-json`             | `… is newer than …, the last release … matches`                                 | The app was on a newer upstream release than `@skillsoft` has synced. Expect type errors where the code uses what that release added. Check the upstream CHANGELOG, and ask the Gamut team before working around it.                                              |
+| `mf-shared`                | `replaced … in Module Federation shared config`                                 | This is a runtime change. Gamut is now actually shared as a singleton, so host and remotes must agree. Update each remote's shared config to match and deploy them together.                                                                                      |
+| `next-config`              | `` `experimental.esmExternals: false` makes Next require() … ``                 | A runtime change. Builds can fail when Next collects page data. See [NEXT_EMOTION_INTEROP.md](NEXT_EMOTION_INTEROP.md), then rebuild every Next app the warning names.                                                                                            |
+| `tsconfig-dom`             | `"lib" has no "dom"`                                                            | The root import used to bring in DOM types through `Video`. Add `"dom"` to that tsconfig's `lib` only if type-checking now fails on `document`, `HTMLElement`, `ResizeObserver`, and similar.                                                                     |
+
+## Leftovers
+
+The leftovers list shows every line that still names an old package. The codemod doesn't rewrite these, and the regex can produce false positives. Go through them one by one:
+
+- **Jest `moduleNameMapper` regexes and tsconfig `paths`.** Update them to the `@skillsoft/*` names. A stale mapper makes tests fail to resolve modules.
+- **Flat ESLint configs (`eslint.config.*`) and `.eslintrc.js`.** The codemod doesn't rewrite these. Only the package import changes (`import gamut from '@skillsoft/eslint-plugin-gamut'`). The rule prefix and directive prefix must match the key the plugin is registered under, or ESLint reports rules it can't find:
+  - Flat config: the prefix is the `plugins` key. With `plugins: { gamut }`, rules and directives stay `gamut/<rule>`. When the repo has a flat config, `eslint-comments` leaves directives alone.
+  - Legacy `.eslintrc` / `.eslintrc.json`: `eslint-config` and `eslint-comments` move everything to `plugin:@skillsoft/gamut/...` and `@skillsoft/gamut/<rule>`.
+  - To rename the flat-config key, rename the key, every rule key, and every directive together.
+- **Scripts and CI that read `@codecademy/gamut-kit`.** Version-sync scripts like `sync-gamut-deps` read the kit's `package.json` from `node_modules` and exit when it's missing, which fails CI. Delete them, or make them check that every `@skillsoft` Gamut package uses the same version (they're released together). Update the docs that point to them.
+- **Storybook config, docs, and comments.** Update them or leave them, but know they still say the old name.
+- **Code samples in `.mdx`.** Fenced code blocks are left alone on purpose. Update them by hand if they matter.
+- **Files the parser skipped.** Every file is parsed as `tsx`, so Flow-typed JavaScript is skipped. Fix any old names left in those files by hand.
+
+Don't edit `yarn.lock` by hand. Reinstalling updates it.
+
+## Runs from an older codemod build
+
+Migrations match the old `@codecademy` names, so running a newer build over a repo that's already been swapped does nothing for code that has already been renamed. If the first run used an older build (a pkg.pr.new preview, say), check by hand what newer builds handle:
+
+- **Directives under a flat config.** Older builds rewrote `gamut/` directives to `@skillsoft/gamut/` even when the flat config registers the plugin as `gamut`. Change them back. Lint doesn't always flag this, because a directive that names an unknown rule just stops suppressing anything. Current builds list these in the leftovers, with a note, unless a config registers the plugin as `'@skillsoft/gamut'`.
+- **Duplicate imports.** Older `deep-imports` builds added a second `import … from '@skillsoft/gamut'` next to the existing one. `eslint --fix` merges them (`import/no-duplicates`).
+- **`<Markdown>` iframes and videos.** Current builds skip `markdown-video-overrides` when the repo is already on upstream 74.0.0 or newer, because those apps already pass the overrides where they want them. On an older upstream release, add them as described under `markdown-video-overrides` above.
+- **`esmExternals: false` and newer-than-source versions.** Run `npx @skillsoft/gamut-codemods scope-swap . --dry` with the current build. Report-only migrations like `next-config`, `tsconfig-dom`, and `package-json` still warn.
+
+## Next steps
+
+After the migrations finish:
+
+1. Reinstall with `yarn`.
+2. Run the formatter and lint autofix (`prettier --write`, then `eslint --fix`). Split imports from `moved-exports` come out in recast's style, and `@skillsoft` sorts differently from `@codecademy`, so import-order rules like `simple-import-sort` fail until you do.
+3. Type-check, run tests, and build.
+4. If the app uses Module Federation, run the host and every remote together.
+5. If the app depends on preview builds, point every `@skillsoft/*` package at the same preview (including `@skillsoft/eslint-plugin-gamut`) and pin them all with `resolutions`. The codemod README has the exact JSON. Published releases don't need it.
+
+## Common failures
+
+| Symptom                                                                                      | Likely cause                                                                                                                        | Fix                                                                                                                                                                         |
+| -------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `Module '"@skillsoft/gamut"' has no exported member 'Video'`                                 | `Video` was imported from the root                                                                                                  | Import from `@skillsoft/gamut/Video`.                                                                                                                                       |
+| `Cannot find name 'document'`, `HTMLElement`, or `ResizeObserver`                            | The affected tsconfig's `lib` has no `"dom"`                                                                                        | Add `"dom"` to that tsconfig's `compilerOptions.lib`.                                                                                                                       |
+| Components render unstyled, or theme values don't apply                                      | Two copies of `@skillsoft/gamut-styles` or `@skillsoft/variance` are installed                                                      | Run `yarn why @skillsoft/gamut-styles`. Make every `@skillsoft/*` package resolve to one version. Pin previews with `resolutions`.                                          |
+| `MenuList`, `MenuListItem`, or `IconOptionComponent` is not exported                         | Menu's `List*` and SelectDropdown's `IconOption` were renamed on the way to the root                                                | Import the new name. Keep the local alias if the code relies on it, e.g. `import { MenuList as List }`.                                                                     |
+| Jest can't resolve `@skillsoft/...` modules, or a mock doesn't apply                         | A stale `moduleNameMapper` regex, or a mock still points at the root package                                                        | Update the mapper. Mock `@skillsoft/gamut/Video` for `Video`.                                                                                                               |
+| `Cannot find module '@skillsoft/gamut/Video'`, or `MenuList` is missing, right after install | The installed `@skillsoft/gamut` is older than the codemod. A range like `^0.0.1` can resolve to a release cut before these changes | Check `node_modules/@skillsoft/gamut/package.json` and its `exports`. Point at a build that has them (a newer release, or the matching preview), not at the old deep paths. |
+| A preview fix doesn't show up after a push, even after `yarn up` | Yarn treats a `@<pr>.tgz` URL as fixed. The lockfile entry and the global cache keep the first build it fetched | Delete the `@skillsoft/*` preview entries from `yarn.lock`, the matching `@skillsoft-*-https-*` zips in the Yarn cache (`yarn config get cacheFolder`), and `node_modules/@skillsoft`, then run `yarn`. Check a file you know changed before you trust the type-check. |
+| `import/no-duplicates` on `@skillsoft/gamut`, or hundreds of `simple-import-sort` errors     | Rewritten imports weren't merged or re-sorted                                                                                       | Run `eslint --fix`.                                                                                                                                                         |
+| `Cannot find module '@codecademy/gamut/dist/...'` after the run                              | The file was skipped by the parser, or the path is in a code sample                                                                 | Rewrite the import by hand, following the rules above.                                                                                                                      |
+| ESLint: `Definition for rule '…' was not found`, or a disable comment does nothing           | The plugin key doesn't match the rewritten directives                                                                               | Make the plugin key match the directive prefix (see Leftovers).                                                                                                             |
+| Remotes load a second copy of Gamut at runtime                                               | Module Federation `shared` still lists old names on a remote                                                                        | Update that remote's `shared` config and deploy it with the host.                                                                                                           |
+
+## What not to do
+
+- Don't re-add `@codecademy/gamut-kit`, and don't create `@skillsoft/gamut-kit`.`@codecademy/gamut-kit` is deprecated and `@skillsoft/gamut-kit` never existed. Depend on the individual packages it bundled.
+- Don't fix a warning by deep-importing a `dist` path. Find a public export, or ask the Gamut team.
+- Don't silence a warning or leftover by removing the `@skillsoft` entry it points at.
+- Don't bump any `@skillsoft/*` package outside the group's shared version. The packages move together.
+- Don't run the codemod on a dirty tree, and don't pass `--force` to get past the check.
+
+## Reporting back
+
+Say what the codemod changed, which warnings and leftovers are still open, which ones you fixed, and what the user should verify by hand. If you haven't seen the codemod output, ask for it before you start guessing at fixes.
diff --git a/packages/gamut-codemods/.gitignore b/packages/gamut-codemods/.gitignore
new file mode 100644
index 0000000000..1521c8b765
--- /dev/null
+++ b/packages/gamut-codemods/.gitignore
@@ -0,0 +1 @@
+dist
diff --git a/packages/gamut-codemods/README.md b/packages/gamut-codemods/README.md
new file mode 100644
index 0000000000..cdf99869e4
--- /dev/null
+++ b/packages/gamut-codemods/README.md
@@ -0,0 +1,147 @@
+# @skillsoft/gamut-codemods
+
+Codemods for moving a repo onto `@skillsoft/gamut` and between its releases.
+
+## Presets
+
+Each preset is one upgrade. Run them in order if you're more than one behind.
+
+| Preset       | What it's for                                           |
+| ------------ | ------------------------------------------------------- |
+| `scope-swap` | Moving from `@codecademy/gamut*` to `@skillsoft/gamut*` |
+
+`npx @skillsoft/gamut-codemods list` shows every preset and the migrations inside it.
+
+## Running scope-swap
+
+Start from a clean working tree. The codemod won't write into uncommitted changes (pass `--force` to override), so `git checkout .` always undoes a run.
+
+```sh
+# Preview without writing anything
+npx @skillsoft/gamut-codemods scope-swap . --dry
+
+# Run it
+npx @skillsoft/gamut-codemods scope-swap .
+
+# Run only some migrations
+npx @skillsoft/gamut-codemods scope-swap . --only=moved-exports,scope-rename
+```
+
+A run ends with three things:
+
+1. **Warnings**, prefixed with the migration name, e.g. `[moved-exports] src/Player.test.tsx:12 mock of '@codecademy/gamut' stubs Video/VideoProps`. Each one says what to do.
+2. **Leftovers**: every line that still names an old package. These are for you to fix: jest `moduleNameMapper` regexes, tsconfig `paths`, flat ESLint configs, comments, and docs.
+3. **Next steps**, built from what actually happened in the run.
+
+### Getting help from an AI agent
+
+The `gamut-scope-swap` skill, in [`@skillsoft/gamut-agent-tools`](../gamut-agent-tools/README.md), knows what this codemod does and what it leaves behind. It can go through the warnings and leftovers with you and help fix what the codemod can't rewrite. Install it from the app repo once `@skillsoft/gamut` is in place:
+
+```sh
+# Cursor
+gamut plugin install cursor
+
+# Claude Code
+gamut plugin install claude
+```
+
+Then ask the agent to work through the output. Paste the warnings and leftovers, or let it grep for old names. The skill won't run the codemod unless you ask it to.
+
+### Trying it against a preview build
+
+Every skillsoft-gamut pull request publishes installable previews through pkg.pr.new. To test a migration against one:
+
+1. Add the `@skillsoft/*` packages to your root `package.json` first, pointed at the preview URLs. The codemod keeps any `@skillsoft/*` entry that's already there.
+2. Preview packages point at each other through commit-pinned URLs, so without help yarn installs a second copy of `gamut-styles`, `variance`, and so on under `@skillsoft/gamut/node_modules`. Pin every `@skillsoft/*` package you use with `resolutions`:
+
+   ```json
+   "resolutions": {
+     "@skillsoft/gamut": "https://pkg.pr.new/@skillsoft/gamut@<pr>",
+     "@skillsoft/gamut-styles": "https://pkg.pr.new/@skillsoft/gamut-styles@<pr>",
+     "@skillsoft/variance": "https://pkg.pr.new/@skillsoft/variance@<pr>"
+   }
+   ```
+
+   Published releases don't need this. The packages share one version through the changesets `fixed` group, so their dependencies on each other line up.
+
+3. Commit, then run the codemod (or pass `--force`).
+
+### What scope-swap changes
+
+| Migration                  | What it does                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
+| -------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
+| `deep-imports`             | `@codecademy/gamut/dist/PopoverContainer/types` → `@codecademy/gamut`, and the rest of the promoted deep imports. Menu's `List*` and SelectDropdown's `IconOption` component were renamed on the way to the root (`MenuList*`, `IconOptionComponent`); local names are kept, so `import { List }` becomes `import { MenuList as List }`. `Form/styles` is only partly public (`formFieldStyles`, `formFieldPaddingStyles`, `conditionalStyles`), so imports of anything else from it are left alone with a warning. A rewritten import is merged into an existing named import from the same package. Also warns on deep imports with no public replacement (`ButtonBase/ButtonBase`) and on ones it doesn't know. |
+| `moved-exports`            | Moves `Video` and `VideoProps` off the root import onto `/Video`. Warns on namespace imports, `export *`, and mocks that stub `Video`.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |
+| `markdown-video-overrides` | Markdown no longer renders `<iframe>` and `<video>` through `Video` by default. Adds `iframeOverride` / `videoOverride` to each `<Markdown>` that didn't skip them, importing `Iframe` and `MarkdownVideo` from `/Video`. Drops the removed `skipDefaultOverrides.iframe` / `.video` keys, writing `iframeOverride={undefined}` where they were `true`. Warns on a `skipDefaultOverrides` it can't read. Skipped when every `@codecademy/gamut` range in the repo is already 74.0.0 or newer, since that release made the change upstream.                                                                                                                                                                         |
+| `mf-shared`                | Replaces `@codecademy/gamut-kit` in Module Federation `shared` config with the packages it bundled. Gamut becomes a real singleton, so test the host and remotes together.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
+| `eslint-comments`          | `// eslint-disable-next-line gamut/x` → `@skillsoft/gamut/x`.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
+| `scope-rename`             | Every `@codecademy/gamut*` module string becomes `@skillsoft/gamut*`: imports, exports, `require`, `import()`, `jest.mock`/`vi.mock`, `declare module`, and `import('x').T`. Also exact package-name strings elsewhere, like `transpilePackages`, with one warning per file, and package names in comments (`/dist` paths and removed packages are left for the leftovers).                                                                                                                                                                                                                                                                                                                                        |
+| `package-json`             | Renames dependencies and sets their versions. A new package that's already listed keeps its value (a preview URL, say), and a `*` peer range stays `*`. Replaces `@codecademy/gamut-kit` with the individual packages.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |
+| `eslint-config`            | `.eslintrc` / `.eslintrc.json`: plugin name, `plugin:` extends, and rule keys.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
+| `mdx-imports`              | Runs the migrations above over `import`/`export` statements in `.mdx` files. Fenced code blocks are left alone.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
+| `yarnrc`                   | `.yarnrc.yml` list items, like `npmPreapprovedPackages`: renames old package names, or drops them if a glob like `'@skillsoft/*'` already covers the new one.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
+| `tsconfig-dom`             | Report only. Warns about `tsconfig` files whose `lib` has no `"dom"`, since Video used to supply the DOM types through the root import.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
+
+### Known limits
+
+- Every file is parsed with the `tsx` parser, so Flow-typed JS won't parse.
+- Flat ESLint configs (`eslint.config.*`) and `.eslintrc.js` aren't rewritten. In a flat config the rule prefix is whatever key you register the plugin under, so renaming rule keys blindly would break it. They show up in the leftovers.
+- The leftovers report uses regex, not an AST, so expect some false positives.
+- The codemod doesn't change how Gamut loads at runtime. Next.js apps with `experimental.esmExternals: false` can fail at build or prerender on `@emotion/*` or `react-select` default imports, with errors like `Element type is invalid ... got: object` or `c(...) is not a function`. See [NEXT_EMOTION_INTEROP.md](../gamut-agent-tools/skills/gamut-scope-swap/NEXT_EMOTION_INTEROP.md) for the fix.
+
+## Contributing
+
+### How it's put together
+
+```
+src/
+  presets/
+    index.ts                 # every preset the CLI can run
+    <preset>/
+      index.ts               # ordered migrations + next-steps checklist
+      manifest.ts            # the data: what changed in this release
+  migrations/<name>/
+    index.ts                 # a reusable migration
+    __testfixtures__/        # <case>.input.<ext>, .output.<ext>, optional .warnings.json
+  lib/                       # shared types, module-string finder, leftovers, git guard
+  transform.ts               # jscodeshift entry point
+  cli.ts, bin.ts
+```
+
+Two rules hold it together:
+
+- **Manifests hold the data; migrations hold the code.** Most Gamut changes need a manifest row and a fixture, not a new migration.
+- **Manifests use the old package names.** In `scope-swap`, `scope-rename` runs last and swaps the scope, so nothing before it needs to know the new one.
+
+### Three kinds of migration
+
+- **`splice`** (the default choice): uses the AST to find ranges, then edits the original text by offset. Use it for anything that swaps one string for another. recast never prints the file, so nothing else in it moves.
+- **`ast`**: mutates the AST, and recast prints the file. Only for structural rewrites like splitting an import. recast can reprint more than you changed: mutating one string literal in a semicolon-less file added semicolons and changed JSX text whitespace in neighbouring statements. Presets must list every `ast` migration before any `splice` one, and `validatePreset` enforces it.
+- **`file`**: gets raw text for files its `match()` accepts (package.json, .eslintrc).
+
+### Changing a preset's manifest
+
+1. Add the row to `src/presets/<preset>/manifest.ts`.
+2. Add a fixture pair under the migration that handles it, e.g. `src/migrations/moved-exports/__testfixtures__/my-case.input.tsx` and `.output.tsx`.
+3. If it should warn, add `my-case.warnings.json`: a list of substrings that must appear in the warnings.
+4. `yarn nx test gamut-codemods`.
+
+`manifest.test.ts` type-checks every export a manifest points at against the built packages, so a row can't promise an export that doesn't exist.
+
+### Adding a migration
+
+1. Create `src/migrations/<name>/index.ts` exporting an `AstMigration`, `SpliceMigration`, or `FileMigration` (see `src/lib/types.ts`).
+2. Add it to the presets that need it. In `scope-swap`, put it before `scope-rename` if it matches on old names.
+3. Add fixtures. They're picked up automatically, and every source migration is also checked for idempotence.
+4. If you find a new place a module name can appear, teach `lib/module-strings.ts` rather than special-casing it.
+5. If it leaves follow-up work, call `note('<key>')` and add the key to the preset's `conditionalChecklist`.
+
+### Adding a preset
+
+Create `src/presets/<name>/` with a manifest and an `index.ts`, register it in `src/presets/index.ts`, and reuse migrations from `src/migrations`.
+
+### recast gotchas already hit
+
+- Rebuild specifiers instead of mutating them. Changing `imported` on `import { List }` drops the alias, because `imported` and `local` share one source range.
+- Clone nodes before moving them into a new declaration, or recast's patcher can crash.
+- `insertAfter` and `replace(a, b)` copy the gap after the original node, which can leave a stray blank line. `moved-exports.postPrint` closes that specific gap.
diff --git a/packages/gamut-codemods/jest.config.ts b/packages/gamut-codemods/jest.config.ts
new file mode 100644
index 0000000000..dc5f1ad9f1
--- /dev/null
+++ b/packages/gamut-codemods/jest.config.ts
@@ -0,0 +1,19 @@
+/** @jest-config-loader ts-node */
+/* eslint-disable */
+import base from '../../jest.config.base';
+
+export default base('gamut-codemods', {
+  testEnvironment: 'node',
+  transform: {
+    '^.+\\.ts$': [
+      'ts-jest',
+      {
+        tsconfig: '<rootDir>/tsconfig.spec.json',
+      },
+    ],
+  },
+  /* Fixtures are inputs, not tests, and may be deliberately odd code. */
+  testPathIgnorePatterns: ['node_modules', 'dist', '__testfixtures__'],
+  setupFiles: [],
+  setupFilesAfterEnv: [],
+});
diff --git a/packages/gamut-codemods/package.json b/packages/gamut-codemods/package.json
new file mode 100644
index 0000000000..6acbecb748
--- /dev/null
+++ b/packages/gamut-codemods/package.json
@@ -0,0 +1,38 @@
+{
+  "name": "@skillsoft/gamut-codemods",
+  "description": "Codemods for upgrading to and between @skillsoft/gamut releases",
+  "version": "0.0.1",
+  "author": "Skillsoft Engineering <dev@codecademy.com>",
+  "bin": "./dist/bin.js",
+  "dependencies": {
+    "jscodeshift": "^17.3.0"
+  },
+  "devDependencies": {
+    "@skillsoft/gamut": "workspace:*",
+    "@types/jscodeshift": "^17.3.0"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "files": [
+    "dist"
+  ],
+  "keywords": [
+    "codemod",
+    "gamut",
+    "jscodeshift",
+    "migration"
+  ],
+  "license": "MIT",
+  "main": "./dist/cli.js",
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": "Codecademy/skillsoft-gamut.git",
+  "scripts": {
+    "build": "nx build gamut-codemods",
+    "verify": "tsc --noEmit -p tsconfig.lib.json && tsc --noEmit -p tsconfig.spec.json"
+  },
+  "types": "./dist/cli.d.ts",
+  "type": "commonjs"
+}
diff --git a/packages/gamut-codemods/project.json b/packages/gamut-codemods/project.json
new file mode 100644
index 0000000000..91d962dcc2
--- /dev/null
+++ b/packages/gamut-codemods/project.json
@@ -0,0 +1,46 @@
+{
+  "name": "gamut-codemods",
+  "$schema": "../../node_modules/nx/schemas/project-schema.json",
+  "sourceRoot": "packages/gamut-codemods/src",
+  "projectType": "library",
+  "tags": [],
+  "targets": {
+    "build": {
+      "executor": "nx:run-commands",
+      "options": {
+        "cwd": "packages/gamut-codemods",
+        "commands": [
+          "rm -rf ./dist",
+          "tsc -p tsconfig.lib.json",
+          "chmod +x ./dist/bin.js"
+        ],
+        "parallel": false
+      }
+    },
+    "test": {
+      "executor": "@nx/jest:jest",
+      "dependsOn": ["^build"],
+      "outputs": ["{workspaceRoot}/coverage/packages/gamut-codemods"],
+      "options": {
+        "jestConfig": "packages/gamut-codemods/jest.config.ts"
+      }
+    },
+    "verify-package": {
+      "executor": "nx:run-commands",
+      "dependsOn": ["build"],
+      "options": {
+        "cwd": "{projectRoot}",
+        "commands": ["publint ."],
+        "parallel": false
+      }
+    },
+    "publish-build": {
+      "executor": "nx:run-commands",
+      "dependsOn": ["build"],
+      "options": {
+        "commands": [],
+        "parallel": false
+      }
+    }
+  }
+}
diff --git a/packages/gamut-codemods/src/__tests__/__testfixtures__/end-to-end.input.tsx b/packages/gamut-codemods/src/__tests__/__testfixtures__/end-to-end.input.tsx
new file mode 100644
index 0000000000..32a4d06d2e
--- /dev/null
+++ b/packages/gamut-codemods/src/__tests__/__testfixtures__/end-to-end.input.tsx
@@ -0,0 +1,7 @@
+import { Box, Video } from '@codecademy/gamut';
+import { PopoverContainerProps } from '@codecademy/gamut/dist/PopoverContainer/types';
+import { theme } from '@codecademy/gamut-styles';
+
+// eslint-disable-next-line gamut/no-inline-style
+export const Thing = (p: PopoverContainerProps) => <Box style={{}}><Video videoUrl="x" /></Box>;
+export const shared = { '@codecademy/gamut-kit': { singleton: true } };
diff --git a/packages/gamut-codemods/src/__tests__/__testfixtures__/end-to-end.output.tsx b/packages/gamut-codemods/src/__tests__/__testfixtures__/end-to-end.output.tsx
new file mode 100644
index 0000000000..5513af46b5
--- /dev/null
+++ b/packages/gamut-codemods/src/__tests__/__testfixtures__/end-to-end.output.tsx
@@ -0,0 +1,7 @@
+import { Box, PopoverContainerProps } from '@skillsoft/gamut';
+import { Video } from '@skillsoft/gamut/Video';
+import { theme } from '@skillsoft/gamut-styles';
+
+// eslint-disable-next-line @skillsoft/gamut/no-inline-style
+export const Thing = (p: PopoverContainerProps) => <Box style={{}}><Video videoUrl="x" /></Box>;
+export const shared = { '@skillsoft/gamut': { singleton: true }, '@skillsoft/gamut-icons': { singleton: true }, '@skillsoft/gamut-illustrations': { singleton: true }, '@skillsoft/gamut-patterns': { singleton: true }, '@skillsoft/gamut-styles': { singleton: true }, '@skillsoft/variance': { singleton: true } };
diff --git a/packages/gamut-codemods/src/__tests__/cli.test.ts b/packages/gamut-codemods/src/__tests__/cli.test.ts
new file mode 100644
index 0000000000..c8b872fdb8
--- /dev/null
+++ b/packages/gamut-codemods/src/__tests__/cli.test.ts
@@ -0,0 +1,241 @@
+import { execFileSync } from 'node:child_process';
+import fs from 'node:fs';
+import os from 'node:os';
+import path from 'node:path';
+
+import type { API, FileInfo } from 'jscodeshift';
+import jscodeshift from 'jscodeshift';
+
+import { main } from '../cli';
+import transform, { type TransformOptions } from '../transform';
+
+/*
+  Drives the real CLI. jscodeshift's Runner normally spawns workers that
+  load a built transform.js; here it's replaced with an in-process loop
+  over the same transform, so these tests run against source and count
+  toward coverage. The factory only builds a wrapper, so the mock reference
+  is resolved at call time.
+*/
+const mockRun = jest.fn();
+jest.mock('jscodeshift/src/Runner', () => ({
+  run: (...args: unknown[]) => mockRun(...args),
+}));
+
+const SOURCE_EXT = /\.(m?[jt]sx?|c[jt]s)$/;
+
+const listSources = (target: string): string[] =>
+  fs.statSync(target).isDirectory()
+    ? fs
+        .readdirSync(target)
+        .filter((name) => name !== 'node_modules')
+        .flatMap((name) => listSources(path.join(target, name)))
+    : SOURCE_EXT.test(target)
+    ? [target]
+    : [];
+
+const simulateRunner = async (
+  _transformFile: string,
+  paths: string[],
+  options: Record<string, unknown>
+) => {
+  const api = {
+    jscodeshift: jscodeshift.withParser('tsx'),
+    report: (message: string) => console.log(message),
+    stats: () => {},
+  };
+  for (const file of paths.flatMap(listSources)) {
+    const source = fs.readFileSync(file, 'utf8');
+    const out = transform(
+      { path: file, source } as FileInfo,
+      api as unknown as API,
+      options as TransformOptions
+    );
+    if (out && !options.dry) fs.writeFileSync(file, out);
+  }
+  return { error: 0 };
+};
+
+const project = (files: Record<string, string>) => {
+  const dir = fs.mkdtempSync(path.join(os.tmpdir(), 'gamut-cli-test-'));
+  for (const [name, text] of Object.entries(files)) {
+    const file = path.join(dir, name);
+    fs.mkdirSync(path.dirname(file), { recursive: true });
+    fs.writeFileSync(file, text);
+  }
+  return dir;
+};
+
+const read = (dir: string, name: string) =>
+  fs.readFileSync(path.join(dir, name), 'utf8');
+
+const POST = `import { Box, Markdown, Video } from '@codecademy/gamut';
+
+export const Post = ({ text, url }: { text: string; url: string }) => (
+  <Box>
+    <Markdown text={text} />
+    <Video videoUrl={url} />
+  </Box>
+);
+`;
+
+let logs: string[];
+let errors: string[];
+
+beforeEach(() => {
+  logs = [];
+  errors = [];
+  jest.spyOn(console, 'log').mockImplementation((...args) => {
+    logs.push(args.join(' '));
+  });
+  jest.spyOn(console, 'error').mockImplementation((...args) => {
+    errors.push(args.join(' '));
+  });
+  mockRun.mockReset();
+  mockRun.mockImplementation(simulateRunner);
+});
+
+afterEach(() => {
+  jest.restoreAllMocks();
+});
+
+const output = () => logs.join('\n');
+
+describe('main: no-op paths', () => {
+  it('lists presets and their migrations', async () => {
+    expect(await main(['list'])).toBe(0);
+    expect(output()).toMatch(/scope-swap/);
+    expect(output()).toMatch(/markdown-video-overrides/);
+  });
+
+  it('prints usage for --help and for a missing path', async () => {
+    expect(await main(['--help'])).toBe(0);
+    expect(output()).toMatch(/Usage: gamut-codemods/);
+
+    logs = [];
+    expect(await main(['scope-swap'])).toBe(1);
+    expect(output()).toMatch(/Usage: gamut-codemods/);
+  });
+
+  it('rejects an unknown preset', async () => {
+    await expect(main(['no-such-preset', '/tmp'])).rejects.toThrow(
+      /unknown preset 'no-such-preset'/
+    );
+  });
+});
+
+describe('main: refusing to write', () => {
+  it('refuses a target outside git without --force', async () => {
+    const dir = project({ 'package.json': '{}' });
+    expect(await main(['scope-swap', dir])).toBe(1);
+    expect(errors.join('\n')).toMatch(/not inside a git repository/);
+    expect(errors.join('\n')).toMatch(/--force/);
+    expect(mockRun).not.toHaveBeenCalled();
+  });
+
+  it('refuses a dirty git tree without --force', async () => {
+    const dir = project({ 'src/a.ts': 'export {};\n' });
+    const git = (...args: string[]) =>
+      execFileSync('git', args, { cwd: dir, stdio: 'ignore' });
+    git('init', '-q');
+    expect(await main(['scope-swap', dir])).toBe(1);
+    expect(errors.join('\n')).toMatch(/uncommitted changes/);
+  });
+});
+
+describe('main: full run', () => {
+  it('rewrites sources, manifests, docs, and configs, then prints the checklist', async () => {
+    const dir = project({
+      'src/Post.tsx': POST,
+      'src/index.ts': "export * from '@codecademy/gamut';\n",
+      'docs/story.mdx': "import { Box } from '@codecademy/gamut';\n\n# Hi\n",
+      'docs/reexport.mdx': "export * from '@codecademy/gamut';\n",
+      'package.json': JSON.stringify({
+        name: 'app',
+        dependencies: {
+          '@codecademy/gamut': '^73.0.0',
+          '@codecademy/gamut-kit': '^73.0.0',
+        },
+      }),
+      'tsconfig.json': JSON.stringify({ compilerOptions: { lib: ['es2020'] } }),
+      'next.config.js':
+        'module.exports = { experimental: { esmExternals: false } };\n',
+      'jest.config.js':
+        "module.exports = { moduleNameMapper: { '^@codecademy/gamut/(.*)$': '<rootDir>/x/$1' } };\n",
+    });
+
+    expect(await main(['scope-swap', dir, '--force'])).toBe(0);
+
+    const post = read(dir, 'src/Post.tsx');
+    expect(post).toContain("from '@skillsoft/gamut/Video'");
+    expect(post).toContain('iframeOverride');
+    expect(read(dir, 'docs/story.mdx')).toContain("'@skillsoft/gamut'");
+    expect(read(dir, 'package.json')).toContain('"@skillsoft/gamut"');
+    expect(read(dir, 'package.json')).not.toContain('gamut-kit');
+
+    const out = output();
+    expect(out).toMatch(/file\(s\) changed/);
+    expect(out).toMatch(/leftovers \(\d+\)/);
+    expect(out).toMatch(/jest\.config\.js:1/);
+    expect(out).toMatch(/next steps/);
+    expect(out).toMatch(/Video needs two peer dependencies/);
+    expect(out).toMatch(/gamut-kit is gone/);
+    expect(out).toMatch(/Some tsconfig files set "lib"/);
+    expect(out).toMatch(/Some next\.config files set/);
+    expect(out).toMatch(/Reinstall \(yarn\)/);
+    expect(out).toMatch(
+      /\[moved-exports\] .*src\/index\.ts:1 .*no longer re-exports Video/
+    );
+    expect(out).toMatch(
+      /\[moved-exports\] .*reexport\.mdx .*no longer re-exports Video/
+    );
+  });
+
+  it('writes nothing under --dry and skips the checklist and leftovers', async () => {
+    const pkg = JSON.stringify({
+      dependencies: { '@codecademy/gamut': '^73.0.0' },
+    });
+    const dir = project({ 'src/Post.tsx': POST, 'package.json': pkg });
+    expect(await main(['scope-swap', dir, '--dry'])).toBe(0);
+    expect(read(dir, 'src/Post.tsx')).toBe(POST);
+    expect(read(dir, 'package.json')).toBe(pkg);
+    expect(output()).toMatch(/would update .*package\.json/);
+    expect(output()).toMatch(/skipped in --dry/);
+    expect(output()).not.toMatch(/next steps/);
+  });
+
+  it('skips the leftovers report with --no-report', async () => {
+    const dir = project({ 'src/Post.tsx': POST });
+    expect(await main(['scope-swap', dir, '--force', '--no-report'])).toBe(0);
+    expect(output()).not.toMatch(/leftovers \(/);
+    expect(output()).not.toMatch(/leftovers skipped/);
+  });
+
+  it('runs only the named migrations with --only', async () => {
+    const dir = project({
+      'src/Post.tsx': POST,
+      'package.json': JSON.stringify({
+        dependencies: { '@codecademy/gamut': '^73.0.0' },
+      }),
+    });
+    expect(
+      await main(['scope-swap', dir, '--force', '--only=package-json'])
+    ).toBe(0);
+    expect(read(dir, 'src/Post.tsx')).toBe(POST);
+    expect(read(dir, 'package.json')).toContain('"@skillsoft/gamut"');
+  });
+
+  it('reports a migration skipped by its skipReason', async () => {
+    const dir = project({
+      'eslint.config.js': 'export default [];\n',
+      'src/Post.tsx': POST,
+    });
+    expect(await main(['scope-swap', dir, '--force'])).toBe(0);
+    expect(output()).toMatch(/\[eslint-comments\] skipped: found flat ESLint/);
+  });
+
+  it('returns 1 when the source runner reports errors', async () => {
+    mockRun.mockResolvedValueOnce({ error: 1 });
+    const dir = project({ 'src/Post.tsx': POST });
+    expect(await main(['scope-swap', dir, '--force'])).toBe(1);
+  });
+});
diff --git a/packages/gamut-codemods/src/__tests__/fixtures.test.ts b/packages/gamut-codemods/src/__tests__/fixtures.test.ts
new file mode 100644
index 0000000000..cc5f0f2d48
--- /dev/null
+++ b/packages/gamut-codemods/src/__tests__/fixtures.test.ts
@@ -0,0 +1,113 @@
+import fs from 'node:fs';
+import path from 'node:path';
+
+import { applyTransform } from 'jscodeshift/src/testUtils';
+
+import { presets } from '../presets';
+import * as transform from '../transform';
+
+/*
+  Fixture-driven. Every `<case>.input.<ext>` in a migration's
+  __testfixtures__ runs through that migration alone and must match
+  `<case>.output.<ext>`. An optional `<case>.warnings.json` lists substrings
+  that must each appear in some warning. `{{version}}` in an output stands
+  for this package's version. Adding a case means adding files, not code.
+*/
+
+const { version } = JSON.parse(
+  fs.readFileSync(path.join(__dirname, '../../package.json'), 'utf8')
+) as { version: string };
+
+interface Case {
+  name: string;
+  ext: string;
+  input: string;
+  output: string;
+  warnings: string[];
+}
+
+const readCases = (dir: string): Case[] => {
+  if (!fs.existsSync(dir)) return [];
+  const read = (f: string) => fs.readFileSync(path.join(dir, f), 'utf8');
+  return fs
+    .readdirSync(dir)
+    .filter((f) => f.includes('.input.'))
+    .map((input) => {
+      const [name, ext] = input.split('.input.');
+      const warnings = `${name}.warnings.json`;
+      return {
+        name,
+        ext,
+        input: read(input),
+        output: read(`${name}.output.${ext}`).replace(/{{version}}/g, version),
+        warnings: fs.existsSync(path.join(dir, warnings))
+          ? (JSON.parse(read(warnings)) as string[])
+          : [],
+      };
+    });
+};
+
+const fixtureDir = (migration: string) =>
+  path.join(__dirname, '../migrations', migration, '__testfixtures__');
+
+const expectWarnings = (actual: string[], expected: string[]) => {
+  for (const needle of expected) {
+    expect(actual.join('\n')).toContain(needle);
+  }
+};
+
+const runSource = (preset: string, source: string, only?: string) => {
+  const warnings: string[] = [];
+  const out = applyTransform(
+    transform,
+    { preset, only, onWarn: (w: string) => warnings.push(w) },
+    { source, path: 'fixture.tsx' },
+    { parser: 'tsx' }
+  );
+  return { out: out || source, warnings };
+};
+
+describe.each(Object.values(presets))('preset $name', (preset) => {
+  for (const migration of preset.migrations) {
+    const cases = readCases(fixtureDir(migration.name));
+    if (cases.length === 0) continue;
+
+    describe(migration.name, () => {
+      it.each(cases)('$name', (c) => {
+        if (migration.kind === 'file') {
+          const warnings: string[] = [];
+          const out = migration.run({
+            source: c.input,
+            manifest: preset.manifest,
+            warn: (w) => warnings.push(w),
+            note: () => {},
+            transformSource: (code) => runSource(preset.name, code).out,
+          });
+          expect((out ?? c.input).trim()).toBe(c.output.trim());
+          expectWarnings(warnings, c.warnings);
+          return;
+        }
+
+        const { out, warnings } = runSource(
+          preset.name,
+          c.input,
+          migration.name
+        );
+        expect(out.trim()).toBe(c.output.trim());
+        expectWarnings(warnings, c.warnings);
+
+        /* Idempotent: a second run over the output changes nothing. */
+        expect(
+          runSource(preset.name, c.output, migration.name).out.trim()
+        ).toBe(c.output.trim());
+      });
+    });
+  }
+
+  const endToEnd = readCases(path.join(__dirname, '__testfixtures__'));
+  if (endToEnd.length > 0) {
+    it.each(endToEnd)('every migration: $name', (c) => {
+      expect(runSource(preset.name, c.input).out.trim()).toBe(c.output.trim());
+    });
+  }
+});
diff --git a/packages/gamut-codemods/src/__tests__/lib.test.ts b/packages/gamut-codemods/src/__tests__/lib.test.ts
new file mode 100644
index 0000000000..f8e129ebf1
--- /dev/null
+++ b/packages/gamut-codemods/src/__tests__/lib.test.ts
@@ -0,0 +1,290 @@
+import { execFileSync } from 'node:child_process';
+import fs from 'node:fs';
+import os from 'node:os';
+import path from 'node:path';
+
+import { parseArgs } from '../cli';
+import { findFlatEslintConfig } from '../lib/eslint';
+import { dirtyTreeReason } from '../lib/git';
+import { findLeftovers } from '../lib/leftovers';
+import { isAtLeast, isNewerThan, minVersion } from '../lib/manifest';
+import { eslintComments } from '../migrations/eslint-comments';
+import { markdownVideoOverrides } from '../migrations/markdown-video-overrides';
+import { validatePreset } from '../presets';
+import { scopeSwap } from '../presets/scope-swap';
+import { manifest } from '../presets/scope-swap/manifest';
+
+const tmp = () =>
+  fs.mkdtempSync(path.join(os.tmpdir(), 'gamut-codemods-test-'));
+
+describe('validatePreset', () => {
+  it('accepts scope-swap', () => {
+    expect(() => validatePreset(scopeSwap)).not.toThrow();
+  });
+
+  it('rejects an ast migration listed after a splice one', () => {
+    const [deep, moved, mf] = [
+      'deep-imports',
+      'moved-exports',
+      'mf-shared',
+    ].map((name) => scopeSwap.migrations.find((m) => m.name === name)!);
+    expect(() =>
+      validatePreset({ ...scopeSwap, migrations: [deep, mf, moved] })
+    ).toThrow(/moved-exports/);
+  });
+});
+
+describe('parseArgs', () => {
+  it('reads a preset, paths, and flags', () => {
+    expect(
+      parseArgs(['scope-swap', 'a', '--dry', '--only=scope-rename'])
+    ).toEqual(
+      expect.objectContaining({
+        preset: 'scope-swap',
+        paths: [path.resolve('a')],
+        dry: true,
+        force: false,
+        only: 'scope-rename',
+      })
+    );
+  });
+
+  it('rejects unknown flags', () => {
+    expect(() => parseArgs(['scope-swap', 'a', '--drry'])).toThrow(/--drry/);
+  });
+});
+
+describe('dirtyTreeReason', () => {
+  const git = (cwd: string, ...args: string[]) =>
+    execFileSync('git', args, { cwd, stdio: 'ignore' });
+
+  it('refuses outside a git repo, and on uncommitted changes', () => {
+    const dir = tmp();
+    expect(dirtyTreeReason(dir)).toMatch(/not inside a git repository/);
+
+    git(dir, 'init', '-q');
+    fs.writeFileSync(path.join(dir, 'a.ts'), '');
+    expect(dirtyTreeReason(dir)).toMatch(/uncommitted changes/);
+
+    git(dir, 'add', '-A');
+    git(dir, '-c', 'user.email=t@t', '-c', 'user.name=t', 'commit', '-qm', 'x');
+    expect(dirtyTreeReason(dir)).toBeNull();
+  });
+});
+
+describe('findLeftovers', () => {
+  it('finds old names but not new names that contain them', () => {
+    const dir = tmp();
+    fs.writeFileSync(
+      path.join(dir, 'a.js'),
+      [
+        "moduleNameMapper: { '^@codecademy/gamut(.*)$': 'x' }",
+        "'@skillsoft/eslint-plugin-gamut'",
+        "'@skillsoft/gamut-styles'",
+        "'@codecademy/gamut-kit'",
+      ].join('\n')
+    );
+    expect(findLeftovers([dir], manifest).map((h) => h.line)).toEqual([1, 4]);
+  });
+
+  it('tags every old package the manifest replaces, including gamut-kit', () => {
+    const dir = tmp();
+    const old = [
+      ...Object.keys(manifest.packages),
+      ...Object.keys(manifest.removedPackages),
+    ];
+    fs.writeFileSync(
+      path.join(dir, 'README.md'),
+      old.map((name) => `import x from '${name}/dist/x';`).join('\n')
+    );
+    expect(findLeftovers([dir], manifest).map((h) => h.line)).toEqual(
+      old.map((_, i) => i + 1)
+    );
+  });
+
+  it('flags /dist paths into published packages only', () => {
+    const dir = tmp();
+    fs.writeFileSync(
+      path.join(dir, 'README.md'),
+      [
+        "import { X } from '@codecademy/gamut-styles/dist/AssetProvider';",
+        "import { Y } from '@codecademy/gamut-foo/dist/bar';",
+        "import { Z } from '@skillsoft/gamut-styles/dist/bar';",
+      ].join('\n')
+    );
+    expect(findLeftovers([dir], manifest).map((h) => h.line)).toEqual([1]);
+  });
+
+  it('reads editor config and extensionless scripts', () => {
+    const dir = tmp();
+    const line = "require('@codecademy/gamut-kit/package.json');";
+    fs.writeFileSync(
+      path.join(dir, 'sync-deps'),
+      `#!/usr/bin/env node\n${line}`
+    );
+    fs.writeFileSync(path.join(dir, 'LICENSE'), line);
+    fs.writeFileSync(path.join(dir, 'rules.mdc'), line);
+    fs.writeFileSync(path.join(dir, 'react.code-snippets'), line);
+    expect(
+      findLeftovers([dir], manifest)
+        .map((h) => path.basename(h.file))
+        .sort()
+    ).toEqual(['react.code-snippets', 'rules.mdc', 'sync-deps']);
+  });
+
+  it('skips quoted rule keys when told the repo uses a flat config', () => {
+    const dir = tmp();
+    fs.writeFileSync(
+      path.join(dir, 'eslint.config.ts'),
+      [
+        "rules: { 'gamut/no-inline-style': 'error' },",
+        "import gamut from '@codecademy/eslint-plugin-gamut';",
+        "import gamut from 'eslint-plugin-gamut';",
+      ].join('\n')
+    );
+    expect(findLeftovers([dir], manifest).map((h) => h.line)).toEqual([1, 3]);
+    expect(
+      findLeftovers([dir], manifest, { eslintRuleKeys: false }).map(
+        (h) => h.line
+      )
+    ).toEqual([3]);
+  });
+});
+
+describe('eslint-comments skipReason', () => {
+  it('runs for legacy .eslintrc repos', () => {
+    const dir = tmp();
+    fs.writeFileSync(path.join(dir, '.eslintrc.json'), '{}');
+    expect(eslintComments.skipReason?.([dir], manifest)).toBeNull();
+  });
+
+  it('skips when a flat config is inside the target', () => {
+    const dir = tmp();
+    fs.mkdirSync(path.join(dir, 'libs', 'a'), { recursive: true });
+    fs.writeFileSync(path.join(dir, 'libs', 'a', 'eslint.config.mjs'), '');
+    expect(findFlatEslintConfig([dir])).toBe(
+      path.join(dir, 'libs', 'a', 'eslint.config.mjs')
+    );
+    expect(eslintComments.skipReason?.([dir], manifest)).toMatch(
+      /flat ESLint config/
+    );
+  });
+
+  it('skips when the target is under a flat-config repo', () => {
+    const dir = tmp();
+    fs.writeFileSync(path.join(dir, 'eslint.config.ts'), '');
+    fs.mkdirSync(path.join(dir, 'src'));
+    fs.writeFileSync(path.join(dir, 'src', 'a.tsx'), '');
+    expect(findFlatEslintConfig([path.join(dir, 'src')])).toBe(
+      path.join(dir, 'eslint.config.ts')
+    );
+    expect(findFlatEslintConfig([path.join(dir, 'src', 'a.tsx')])).toBe(
+      path.join(dir, 'eslint.config.ts')
+    );
+  });
+});
+
+describe('isNewerThan', () => {
+  it.each([
+    ['74.0.0', '73.6.1', true],
+    ['^73.7.0', '73.6.1', true],
+    ['~73.6.2', '73.6.1', true],
+    ['npm:@codecademy/gamut@74.0.0', '73.6.1', true],
+    ['73.6.1', '73.6.1', false],
+    ['^73.0.0', '73.6.1', false],
+    ['74.0.0-alpha.1', '74.0.0', false],
+    ['*', '73.6.1', false],
+    ['workspace:*', '73.6.1', false],
+    ['https://example.com/gamut.tgz', '73.6.1', false],
+  ])('%s vs %s -> %s', (range, version, expected) => {
+    expect(isNewerThan(range, version)).toBe(expected);
+  });
+
+  it('reads the lowest version a range allows', () => {
+    expect(minVersion('>= 1.2.3')).toEqual([1, 2, 3]);
+    expect(minVersion('latest')).toBeNull();
+  });
+});
+
+describe('isAtLeast', () => {
+  it.each([
+    ['74.0.0', true],
+    ['^74.1.0', true],
+    ['~75.0.0', true],
+    ['73.6.3', false],
+    ['^73.6.1', false],
+    ['*', false],
+  ])('%s >= 74.0.0 is %s', (range, expected) => {
+    expect(isAtLeast(range, '74.0.0')).toBe(expected);
+  });
+});
+
+describe('markdown-video-overrides skipReason', () => {
+  const repo = (deps: Record<string, string>[]) => {
+    const dir = tmp();
+    deps.forEach((dependencies, i) => {
+      const pkgDir = i === 0 ? dir : path.join(dir, 'libs', String(i));
+      fs.mkdirSync(pkgDir, { recursive: true });
+      fs.writeFileSync(
+        path.join(pkgDir, 'package.json'),
+        JSON.stringify({ dependencies })
+      );
+    });
+    return dir;
+  };
+
+  it('skips when every pinned @codecademy/gamut is 74.0.0 or newer', () => {
+    const dir = repo([
+      { '@codecademy/gamut': '74.0.0' },
+      { '@codecademy/gamut': '*' },
+    ]);
+    expect(markdownVideoOverrides.skipReason?.([dir], manifest)).toMatch(
+      /already at 74\.0\.0/
+    );
+  });
+
+  it('runs when any package is older than 74.0.0', () => {
+    const dir = repo([
+      { '@codecademy/gamut': '74.0.0' },
+      { '@codecademy/gamut': '^73.6.1' },
+    ]);
+    expect(markdownVideoOverrides.skipReason?.([dir], manifest)).toBeNull();
+  });
+
+  it('runs when no version can be read', () => {
+    const dir = repo([{ '@codecademy/gamut': '*' }]);
+    expect(markdownVideoOverrides.skipReason?.([dir], manifest)).toBeNull();
+  });
+});
+
+describe('findLeftovers: scoped directives under a flat config', () => {
+  const directive =
+    '// eslint-disable-next-line @skillsoft/gamut/no-inline-style';
+
+  it('lists them when no file registers the scoped plugin key', () => {
+    const dir = tmp();
+    fs.writeFileSync(path.join(dir, 'eslint.config.ts'), 'plugins: { gamut }');
+    fs.writeFileSync(path.join(dir, 'a.tsx'), directive);
+    const hits = findLeftovers([dir], manifest, { eslintRuleKeys: false });
+    expect(hits).toHaveLength(1);
+    expect(hits[0].note).toMatch(/plugins key/);
+  });
+
+  it('leaves them alone when the plugin is registered under that key', () => {
+    const dir = tmp();
+    fs.writeFileSync(
+      path.join(dir, 'eslint.config.ts'),
+      "plugins: { '@skillsoft/gamut': gamut }"
+    );
+    fs.writeFileSync(path.join(dir, 'a.tsx'), directive);
+    expect(findLeftovers([dir], manifest, { eslintRuleKeys: false })).toEqual(
+      []
+    );
+  });
+
+  it('is not checked for legacy configs', () => {
+    const dir = tmp();
+    fs.writeFileSync(path.join(dir, 'a.tsx'), directive);
+    expect(findLeftovers([dir], manifest)).toEqual([]);
+  });
+});
diff --git a/packages/gamut-codemods/src/__tests__/manifest.test.ts b/packages/gamut-codemods/src/__tests__/manifest.test.ts
new file mode 100644
index 0000000000..f48b665496
--- /dev/null
+++ b/packages/gamut-codemods/src/__tests__/manifest.test.ts
@@ -0,0 +1,196 @@
+import fs from 'node:fs';
+import path from 'node:path';
+
+import ts from 'typescript';
+
+import { renameSpecifier } from '../lib/manifest';
+import { presets } from '../presets';
+import { manifest } from '../presets/scope-swap/manifest';
+
+/*
+  Guards against a manifest that promises something the packages don't
+  deliver. Runs against the built dist, so `^build` has to run first
+  (project.json wires that up).
+*/
+
+const REPO = path.join(__dirname, '../../../..');
+const readJson = (file: string) =>
+  JSON.parse(fs.readFileSync(path.join(REPO, file), 'utf8'));
+
+/*
+  Every name a manifest claims is importable from a new entry point:
+  moved exports at their destination, and renamed deep-import exports at
+  theirs. Written as one virtual file so tsc resolves it the way a
+  consumer's bundler would, through the exports map.
+*/
+const importsToCheck = () => {
+  const byModule = new Map<string, Set<string>>();
+  const add = (spec: string | null, names: string[]) => {
+    if (!spec) return;
+    const set = byModule.get(spec) ?? new Set<string>();
+    names.forEach((name) => set.add(name));
+    byModule.set(spec, set);
+  };
+  for (const preset of Object.values(presets)) {
+    const m = preset.manifest;
+    for (const rule of m.movedExports) {
+      add(renameSpecifier(m, rule.to), rule.names);
+    }
+    for (const row of m.deepImports) {
+      if (!row.to) continue;
+      const to = renameSpecifier(m, row.to);
+      if (row.onlyNames) {
+        add(
+          to,
+          row.onlyNames.map((name) => row.renames?.[name] ?? name)
+        );
+      }
+      if (row.renames) add(to, Object.values(row.renames));
+    }
+  }
+  return [...byModule]
+    .map(
+      ([spec, names]) =>
+        `import type { ${[...names].join(', ')} } from '${spec}';`
+    )
+    .join('\n');
+};
+
+/* `@codecademy/gamut/dist/Form/styles` -> packages/gamut/src/Form/styles(.ts|/index.tsx|...) */
+const sourceModuleFor = (deepPath: string) => {
+  const match = /^@codecademy\/([\w-]+)\/dist\/(.+)$/.exec(deepPath);
+  if (!match) return null;
+  const base = path.join(REPO, 'packages', match[1], 'src', match[2]);
+  return (
+    ['.ts', '.tsx', '/index.ts', '/index.tsx']
+      .map((ext) => base + ext)
+      .find((file) => fs.existsSync(file)) ?? null
+  );
+};
+
+/* Export names of each module specifier, resolved like a bundler would. */
+const exportsOf = (specifiers: string[]) => {
+  const file = path.join(REPO, 'packages/gamut-codemods/__exports-check__.ts');
+  const source = specifiers
+    .map((spec, i) => `import * as m${i} from '${spec}';`)
+    .join('\n');
+  const host = ts.createCompilerHost({});
+  const readFile = host.readFile.bind(host);
+  host.readFile = (f) => (f === file ? source : readFile(f));
+  const fileExists = host.fileExists.bind(host);
+  host.fileExists = (f) => f === file || fileExists(f);
+  const program = ts.createProgram(
+    [file],
+    {
+      noEmit: true,
+      skipLibCheck: true,
+      jsx: ts.JsxEmit.ReactJSX,
+      module: ts.ModuleKind.ESNext,
+      moduleResolution: ts.ModuleResolutionKind.Bundler,
+      types: [],
+    },
+    host
+  );
+  const checker = program.getTypeChecker();
+  const imports = program
+    .getSourceFile(file)!
+    .statements.filter(ts.isImportDeclaration);
+  return specifiers.map((_, i) => {
+    const symbol = checker.getSymbolAtLocation(imports[i].moduleSpecifier);
+    return new Set(
+      symbol ? checker.getExportsOfModule(symbol).map((s) => s.name) : []
+    );
+  });
+};
+
+describe('manifests', () => {
+  /*
+    A deep-import row sends every name imported from `from` to `to`, so
+    everything `from` exports has to be available there: directly, via
+    `renames`, or be left out on purpose by listing what is public in
+    `onlyNames`. Otherwise the codemod writes imports that don't compile.
+  */
+  it('only rewrite deep imports whose names all exist at the target', () => {
+    const rows = manifest.deepImports.filter((row) => row.to && !row.onlyNames);
+    const sources = rows.map((row) => sourceModuleFor(row.from));
+    const targets = rows.map((row) => renameSpecifier(manifest, row.to!)!);
+    const found = exportsOf([
+      ...sources.map((s) => s ?? 'missing'),
+      ...targets,
+    ]);
+
+    const problems = rows.flatMap((row, i) => {
+      if (!sources[i]) return [`${row.from}: no source module found`];
+      const available = found[rows.length + i];
+      const missing = [...found[i]]
+        .map((name) => row.renames?.[name] ?? name)
+        .filter((name) => !available.has(name));
+      return missing.length
+        ? [`${row.from} -> ${targets[i]}: missing ${missing.join(', ')}`]
+        : [];
+    });
+
+    expect(problems).toEqual([]);
+  });
+
+  it('only point at exports that exist in the built packages', () => {
+    const file = path.join(
+      REPO,
+      'packages/gamut-codemods/__manifest-check__.ts'
+    );
+    const host = ts.createCompilerHost({});
+    const source = importsToCheck();
+    const readFile = host.readFile.bind(host);
+    host.readFile = (f) => (f === file ? source : readFile(f));
+    const fileExists = host.fileExists.bind(host);
+    host.fileExists = (f) => f === file || fileExists(f);
+
+    const program = ts.createProgram(
+      [file],
+      {
+        noEmit: true,
+        skipLibCheck: true,
+        module: ts.ModuleKind.ESNext,
+        moduleResolution: ts.ModuleResolutionKind.Bundler,
+        types: [],
+      },
+      host
+    );
+    const errors = ts
+      .getPreEmitDiagnostics(program)
+      .map((d) => ts.flattenDiagnosticMessageText(d.messageText, '\n'));
+
+    expect(errors).toEqual([]);
+  });
+
+  it('rename every package to one that exists in this repo', () => {
+    const published = new Set(
+      fs
+        .readdirSync(path.join(REPO, 'packages'))
+        .map((dir) => path.join(REPO, 'packages', dir, 'package.json'))
+        .filter((file) => fs.existsSync(file))
+        .map((file) => JSON.parse(fs.readFileSync(file, 'utf8')).name)
+    );
+    for (const { to } of Object.values(manifest.packages)) {
+      expect(published).toContain(to);
+    }
+  });
+
+  it('keep scope-swap target versions in step with the packages', () => {
+    const { fixed } = readJson('.changeset/config.json') as {
+      fixed: string[][];
+    };
+    const group =
+      fixed.find((g) => g.includes('@skillsoft/gamut-codemods')) ?? [];
+    const eslintPlugin = readJson('packages/eslint-plugin-gamut/package.json');
+
+    for (const [pkg, range] of Object.entries(manifest.targetVersions)) {
+      if (pkg === eslintPlugin.name) {
+        expect(range).toBe(`^${eslintPlugin.version}`);
+      } else {
+        /* Versioned by the fixed group, which is what makes GROUP_RANGE right. */
+        expect(group).toContain(pkg);
+      }
+    }
+  });
+});
diff --git a/packages/gamut-codemods/src/__tests__/module-strings.test.ts b/packages/gamut-codemods/src/__tests__/module-strings.test.ts
new file mode 100644
index 0000000000..758534a63c
--- /dev/null
+++ b/packages/gamut-codemods/src/__tests__/module-strings.test.ts
@@ -0,0 +1,21 @@
+import jscodeshift from 'jscodeshift';
+
+import { findModuleStrings } from '../lib/module-strings';
+
+/*
+  Calls that aren't require(), import(), or a known module API must not be
+  taken for module strings, even when their argument looks like a package.
+*/
+describe('findModuleStrings', () => {
+  it('finds module strings in require and require.resolve, and skips other calls', () => {
+    const j = jscodeshift.withParser('tsx');
+    const root = j(`
+      require('@codecademy/gamut/a');
+      require.resolve('@codecademy/gamut/b');
+      getModule()('@codecademy/gamut/c');
+      (0, load)('@codecademy/gamut/d');
+    `);
+    const values = findModuleStrings(j, root).map((node) => node.value);
+    expect(values).toEqual(['@codecademy/gamut/a', '@codecademy/gamut/b']);
+  });
+});
diff --git a/packages/gamut-codemods/src/bin.ts b/packages/gamut-codemods/src/bin.ts
new file mode 100644
index 0000000000..1d6eb0af32
--- /dev/null
+++ b/packages/gamut-codemods/src/bin.ts
@@ -0,0 +1,13 @@
+#!/usr/bin/env node
+import { main } from './cli';
+
+main(process.argv.slice(2)).then(
+  (code) => {
+    process.exitCode = code;
+  },
+  (err: unknown) => {
+    // eslint-disable-next-line no-console
+    console.error(err instanceof Error ? err.message : err);
+    process.exitCode = 1;
+  }
+);
diff --git a/packages/gamut-codemods/src/cli.ts b/packages/gamut-codemods/src/cli.ts
new file mode 100644
index 0000000000..1774af75a3
--- /dev/null
+++ b/packages/gamut-codemods/src/cli.ts
@@ -0,0 +1,235 @@
+/* eslint-disable no-console -- it's a CLI; stdout is the interface. */
+import fs from 'node:fs';
+import os from 'node:os';
+import path from 'node:path';
+
+import jscodeshift from 'jscodeshift';
+
+import { findFlatEslintConfig } from './lib/eslint';
+import { dirtyTreeReason } from './lib/git';
+import { findLeftovers, walk } from './lib/leftovers';
+import {
+  activeSourceMigrations,
+  mentionsOldNames,
+  runSourceMigrations,
+} from './lib/run-source';
+import type { FileMigration, Preset } from './lib/types';
+import { getPreset, presets } from './presets';
+
+/* No published types for the Runner; it's jscodeshift's programmatic API. */
+// eslint-disable-next-line @typescript-eslint/no-var-requires
+const Runner = require('jscodeshift/src/Runner') as {
+  run(
+    transformFile: string,
+    paths: string[],
+    options: Record<string, unknown>
+  ): Promise<{ error: number }>;
+};
+
+const USAGE = `Usage: gamut-codemods <preset> <path...> [options]
+       gamut-codemods list
+
+Options:
+  --dry         Don't write anything; show what would change
+  --force       Run even if the target has uncommitted changes
+  --only=a,b    Run only these migrations
+  --no-report   Skip the leftovers report`;
+
+interface Options {
+  preset?: string;
+  paths: string[];
+  dry: boolean;
+  force: boolean;
+  only?: string;
+  /* Filled in by the CLI from each migration's skipReason, not a flag. */
+  skip?: string;
+  report: boolean;
+}
+
+export const parseArgs = (argv: string[]): Options | 'help' | 'list' => {
+  const [command, ...rest] = argv;
+  if (!command || command === '-h' || command === '--help') return 'help';
+  if (command === 'list') return 'list';
+
+  const opts: Options = {
+    preset: command,
+    paths: [],
+    dry: false,
+    force: false,
+    report: true,
+  };
+  for (const arg of rest) {
+    if (arg === '--dry') opts.dry = true;
+    else if (arg === '--force') opts.force = true;
+    else if (arg === '--no-report') opts.report = false;
+    else if (arg.startsWith('--only=')) opts.only = arg.slice('--only='.length);
+    else if (arg.startsWith('--')) throw new Error(`unknown option ${arg}`);
+    else opts.paths.push(path.resolve(arg));
+  }
+  return opts;
+};
+
+const heading = (text: string) => console.log(`\n— ${text} —`);
+
+const runFileMigrations = (
+  preset: Preset,
+  opts: Options,
+  note: (key: string) => void
+) => {
+  const only = opts.only ? new Set(opts.only.split(',')) : null;
+  const skip = new Set(opts.skip ? opts.skip.split(',') : []);
+  const active = preset.migrations.filter(
+    (m): m is FileMigration =>
+      m.kind === 'file' && (!only || only.has(m.name)) && !skip.has(m.name)
+  );
+  let changed = 0;
+
+  for (const root of opts.paths) {
+    const files = fs.statSync(root).isDirectory() ? walk(root) : [root];
+    for (const file of files) {
+      for (const migration of active) {
+        if (!migration.match(file)) continue;
+        const source = fs.readFileSync(file, 'utf8');
+        const warn = (msg: string) =>
+          console.log(`[${migration.name}] ${file} ${msg}`);
+        const transformSource = (code: string) =>
+          mentionsOldNames(preset.manifest, code)
+            ? runSourceMigrations({
+                j: jscodeshift.withParser('tsx'),
+                source: code,
+                migrations: activeSourceMigrations(
+                  preset.migrations,
+                  opts.only,
+                  opts.skip
+                ),
+                manifest: preset.manifest,
+                warnFor: (name) => (_node, message) =>
+                  console.log(`[${name}] ${file} ${message}`),
+                note,
+              })
+            : code;
+        const next = migration.run({
+          source,
+          manifest: preset.manifest,
+          warn,
+          note,
+          transformSource,
+        });
+        if (next === null) continue;
+        changed += 1;
+        console.log(`${opts.dry ? 'would update' : 'updated'} ${file}`);
+        if (!opts.dry) fs.writeFileSync(file, next);
+      }
+    }
+  }
+  return changed;
+};
+
+const printChecklist = (preset: Preset, notes: Set<string>) => {
+  heading('next steps');
+  const items = [
+    ...Object.entries(preset.conditionalChecklist)
+      .filter(([key]) => notes.has(key))
+      .map(([, text]) => text),
+    ...preset.checklist,
+  ];
+  items.forEach((item, i) => console.log(`${i + 1}. ${item}`));
+};
+
+export const main = async (argv: string[]) => {
+  const opts = parseArgs(argv);
+
+  if (opts === 'help') {
+    console.log(USAGE);
+    return 0;
+  }
+  if (opts === 'list') {
+    for (const preset of Object.values(presets)) {
+      console.log(`${preset.name}  ${preset.description}`);
+      for (const m of preset.migrations) {
+        console.log(`  ${m.name.padEnd(18)} ${m.description}`);
+      }
+    }
+    return 0;
+  }
+
+  const preset = getPreset(opts.preset!);
+  if (opts.paths.length === 0) {
+    console.log(USAGE);
+    return 1;
+  }
+
+  if (!opts.dry && !opts.force) {
+    const reasons = opts.paths.map(dirtyTreeReason).filter(Boolean);
+    if (reasons.length > 0) {
+      reasons.forEach((reason) => console.error(reason));
+      console.error(
+        'Re-run with --force to write anyway, or --dry to preview.'
+      );
+      return 1;
+    }
+  }
+
+  const notes = new Set<string>();
+  const skipped = preset.migrations.flatMap((m) => {
+    const reason = m.skipReason?.(opts.paths, preset.manifest);
+    if (!reason) return [];
+    console.log(`[${m.name}] skipped: ${reason}`);
+    notes.add(`skipped:${m.name}`);
+    return [m.name];
+  });
+  opts.skip = skipped.join(',') || undefined;
+
+  const notesDir = fs.mkdtempSync(path.join(os.tmpdir(), 'gamut-codemods-'));
+  try {
+    heading('source files');
+    const result = await Runner.run(
+      path.join(__dirname, 'transform.js'),
+      opts.paths,
+      {
+        preset: preset.name,
+        only: opts.only,
+        skip: opts.skip,
+        notesDir,
+        dry: opts.dry,
+        extensions: 'ts,tsx,js,jsx,mjs,cjs,mts,cts',
+        /* .d.ts stays in: Emotion theme augmentations import gamut-styles. */
+        ignorePattern: ['**/node_modules/**', '**/dist/**', '**/build/**'],
+        parser: 'tsx',
+        babel: false,
+        verbose: 0,
+      }
+    );
+
+    fs.readdirSync(notesDir).forEach((key) =>
+      notes.add(decodeURIComponent(key))
+    );
+
+    heading('package.json and .eslintrc');
+    const changed = runFileMigrations(preset, opts, (key) => notes.add(key));
+    console.log(`${changed} file(s) ${opts.dry ? 'would change' : 'changed'}`);
+
+    if (opts.report && opts.dry) {
+      heading(
+        'leftovers skipped in --dry (nothing was written, so everything would show up)'
+      );
+    } else if (opts.report) {
+      const hits = findLeftovers(opts.paths, preset.manifest, {
+        eslintRuleKeys: !findFlatEslintConfig(opts.paths),
+      });
+      heading(`leftovers (${hits.length})`);
+      hits.forEach((hit) =>
+        console.log(
+          `${hit.file}:${hit.line}  ${hit.text}${
+            hit.note ? `  (${hit.note})` : ''
+          }`
+        )
+      );
+    }
+
+    if (!opts.dry) printChecklist(preset, notes);
+    return result.error > 0 ? 1 : 0;
+  } finally {
+    fs.rmSync(notesDir, { recursive: true, force: true });
+  }
+};
diff --git a/packages/gamut-codemods/src/lib/eslint.ts b/packages/gamut-codemods/src/lib/eslint.ts
new file mode 100644
index 0000000000..c2b11adf1c
--- /dev/null
+++ b/packages/gamut-codemods/src/lib/eslint.ts
@@ -0,0 +1,39 @@
+import fs from 'node:fs';
+import path from 'node:path';
+
+import { walk } from './leftovers';
+
+const FLAT_CONFIG = /(^|\/)eslint\.config\.[cm]?[jt]s$/;
+
+const flatConfigIn = (dir: string) =>
+  fs
+    .readdirSync(dir)
+    .map((name) => path.join(dir, name))
+    .find((file) => FLAT_CONFIG.test(file));
+
+/*
+  The first flat ESLint config that applies to any root, or null: one
+  inside it, or one in a parent directory up to the git root (running on
+  a subfolder of a repo still uses the repo's config). In a flat config the rule prefix is
+  the key the plugin is registered under (`plugins: { gamut }`), not the
+  package name, so renaming the package doesn't change it.
+*/
+export const findFlatEslintConfig = (roots: string[]) => {
+  for (const root of roots) {
+    const isDir = fs.statSync(root).isDirectory();
+    for (
+      let dir = isDir ? root : path.dirname(root);
+      dir !== path.dirname(dir);
+      dir = path.dirname(dir)
+    ) {
+      const found = flatConfigIn(dir);
+      if (found) return found;
+      if (fs.existsSync(path.join(dir, '.git'))) break;
+    }
+    if (!isDir) continue;
+    for (const file of walk(root)) {
+      if (FLAT_CONFIG.test(file)) return file;
+    }
+  }
+  return null;
+};
diff --git a/packages/gamut-codemods/src/lib/git.ts b/packages/gamut-codemods/src/lib/git.ts
new file mode 100644
index 0000000000..6929f0f277
--- /dev/null
+++ b/packages/gamut-codemods/src/lib/git.ts
@@ -0,0 +1,27 @@
+import { execFileSync } from 'node:child_process';
+import fs from 'node:fs';
+import path from 'node:path';
+
+/*
+  The CLI refuses to write into a dirty tree, so `git checkout .` always
+  undoes a run completely and the codemod's diff never mixes with work in
+  progress. Returns a reason to refuse, or null if it's safe.
+*/
+export const dirtyTreeReason = (target: string) => {
+  const cwd = fs.statSync(target).isDirectory() ? target : path.dirname(target);
+  let status: string;
+  try {
+    /* execFileSync with an argument array: no shell, so paths can't inject. */
+    status = execFileSync('git', ['status', '--porcelain', '--', '.'], {
+      cwd,
+      encoding: 'utf8',
+      stdio: ['ignore', 'pipe', 'ignore'],
+    });
+  } catch {
+    return `${target} is not inside a git repository, so a run couldn't be undone.`;
+  }
+  if (status.trim()) {
+    return `${target} has uncommitted changes. Commit or stash them first, so the codemod's diff stands on its own.`;
+  }
+  return null;
+};
diff --git a/packages/gamut-codemods/src/lib/leftovers.ts b/packages/gamut-codemods/src/lib/leftovers.ts
new file mode 100644
index 0000000000..45220b8a60
--- /dev/null
+++ b/packages/gamut-codemods/src/lib/leftovers.ts
@@ -0,0 +1,138 @@
+import fs from 'node:fs';
+import path from 'node:path';
+
+import type { Manifest } from './manifest';
+
+/*
+  After the migrations run, anything still naming an old package is for a
+  person: jest moduleNameMapper regexes, tsconfig paths, flat ESLint
+  configs, comments, docs. This lists them as file:line.
+*/
+
+export const SKIP_DIRS = new Set([
+  'node_modules',
+  'dist',
+  'build',
+  'coverage',
+  '.git',
+  '.next',
+  '.nx',
+  'tmp',
+]);
+const SKIP_FILES =
+  /(^|\/)(yarn\.lock|package-lock\.json|pnpm-lock\.yaml|CHANGELOG\.md)$/;
+/* .mdc is Cursor rules; .code-snippets is VS Code snippets (JSONC). */
+const TEXT_EXT =
+  /\.(m?[jt]sx?|c[jt]s|json|ya?ml|md|mdx|mdc|html|scss|css|code-snippets)$|(^|\/)\.eslintrc$/;
+
+/* Extensionless executables, like tools/script/sync-gamut-deps. */
+const isScript = (file: string) => {
+  if (path.basename(file).includes('.')) return false;
+  const fd = fs.openSync(file, 'r');
+  try {
+    const head = Buffer.alloc(2);
+    fs.readSync(fd, head, 0, 2, 0);
+    return head.toString() === '#!';
+  } finally {
+    fs.closeSync(fd);
+  }
+};
+
+const escape = (s: string) => s.replace(/[.*+?^${}()|[\]\\/]/g, '\\$&');
+
+/*
+  Old names, not already followed by a longer package name, and not the
+  tail of a new one (`@skillsoft/eslint-plugin-gamut` contains
+  `eslint-plugin-gamut`).
+
+  A `/dist` path into one of the packages this repo publishes also counts,
+  even outside files the parser reads (docs, JSON, Flow). Only the packages
+  in manifest.packages are checked. Removed and unrelated `@codecademy`
+  packages aren't ours to rewrite.
+
+  Quoted `gamut/` rule keys and `plugin:gamut/` only count when
+  eslintRuleKeys is set. In a flat config they're correct as written.
+*/
+const oldNamesPattern = (manifest: Manifest, eslintRuleKeys: boolean) => {
+  const published = Object.keys(manifest.packages);
+  const names = [...published, ...Object.keys(manifest.removedPackages)]
+    .sort((a, b) => b.length - a.length)
+    .map(escape);
+  const dist = published.map(escape).join('|');
+  const prefix = escape(manifest.eslintPlugin.from);
+  const ruleKeys = eslintRuleKeys ? `|plugin:${prefix}/|["'\`]${prefix}/` : '';
+  return new RegExp(
+    `(?<![\\w@/-])(?:${names.join(
+      '|'
+    )})(?![\\w-])${ruleKeys}|(?<![\\w@/-])(?:${dist})/dist(?![\\w-])`
+  );
+};
+
+export function* walk(dir: string): Generator<string> {
+  for (const entry of fs.readdirSync(dir, { withFileTypes: true })) {
+    if (entry.isDirectory()) {
+      if (!SKIP_DIRS.has(entry.name)) yield* walk(path.join(dir, entry.name));
+    } else {
+      yield path.join(dir, entry.name);
+    }
+  }
+}
+
+export interface Leftover {
+  file: string;
+  line: number;
+  text: string;
+  /* Why the line is listed, when the old name alone doesn't explain it. */
+  note?: string;
+}
+
+/*
+  Under a flat config the directive prefix is the plugins key. Older builds
+  of this codemod rewrote `gamut/` directives to `@skillsoft/gamut/` anyway.
+  Unless some file registers the plugin under that key, those directives
+  name a rule that doesn't exist and stop suppressing the real one.
+*/
+const scopedDirectivePattern = (manifest: Manifest) =>
+  new RegExp(
+    `eslint-(?:disable|enable)\\S*\\s.*(?<![\\w-])${escape(
+      manifest.eslintPlugin.to
+    )}/`
+  );
+const registersScopedKey = (manifest: Manifest) =>
+  new RegExp(`["'\`]${escape(manifest.eslintPlugin.to)}["'\`]\\s*:`);
+
+export const findLeftovers = (
+  roots: string[],
+  manifest: Manifest,
+  { eslintRuleKeys = true }: { eslintRuleKeys?: boolean } = {}
+) => {
+  const pattern = oldNamesPattern(manifest, eslintRuleKeys);
+  const scopedDirective = scopedDirectivePattern(manifest);
+  const registersKey = registersScopedKey(manifest);
+  const hits: Leftover[] = [];
+  const directives: Leftover[] = [];
+  let keyRegistered = false;
+  for (const root of roots) {
+    const files = fs.statSync(root).isDirectory() ? walk(root) : [root];
+    for (const file of files) {
+      if (SKIP_FILES.test(file)) continue;
+      if (!TEXT_EXT.test(file) && !isScript(file)) continue;
+      fs.readFileSync(file, 'utf8')
+        .split('\n')
+        .forEach((text, i) => {
+          if (pattern.test(text))
+            hits.push({ file, line: i + 1, text: text.trim() });
+          if (eslintRuleKeys) return;
+          if (registersKey.test(text)) keyRegistered = true;
+          if (scopedDirective.test(text))
+            directives.push({
+              file,
+              line: i + 1,
+              text: text.trim(),
+              note: `no flat config registers the plugin as '${manifest.eslintPlugin.to}'; use its plugins key, e.g. ${manifest.eslintPlugin.from}/`,
+            });
+        });
+    }
+  }
+  return keyRegistered ? hits : [...hits, ...directives];
+};
diff --git a/packages/gamut-codemods/src/lib/manifest.ts b/packages/gamut-codemods/src/lib/manifest.ts
new file mode 100644
index 0000000000..bd5976333e
--- /dev/null
+++ b/packages/gamut-codemods/src/lib/manifest.ts
@@ -0,0 +1,124 @@
+/*
+  The shape of a preset's manifest: the data describing what changed. Most
+  contributions should only add rows to a preset's manifest.ts plus a
+  fixture; migrations read from here and never hardcode package or export
+  names.
+*/
+
+export interface PackageRename {
+  to: string;
+}
+
+export interface RemovedPackage {
+  /* Old package names to depend on instead, in package.json. */
+  expandTo: string[];
+  /* Old package names to share as singletons in Module Federation config. */
+  mfSharedAs: string[];
+  note: string;
+}
+
+export interface MovedExport {
+  from: string;
+  to: string;
+  names: string[];
+  note: string;
+  /* Checklist key (see the preset) to print when this rule moves anything. */
+  checklist?: string;
+}
+
+export interface DeepImport {
+  from: string;
+  /* null when there's no public replacement; the migration warns instead. */
+  to: string | null;
+  /* Old imported name -> new exported name. Local bindings are kept. */
+  renames?: Record<string, string>;
+  /*
+    When only some of the old module went public: the old names that work
+    from `to` (after `renames`). A declaration importing anything else is
+    left alone with a warning. manifest.test.ts fails if a row sends names
+    to `to` that it doesn't export, so partial rows must list these.
+  */
+  onlyNames?: string[];
+  note?: string;
+}
+
+export interface Manifest {
+  /* Old package -> new package. */
+  packages: Record<string, PackageRename>;
+  /* Packages with no replacement under the new name. */
+  removedPackages: Record<string, RemovedPackage>;
+  /* Version range written to package.json, keyed by NEW package name. */
+  targetVersions: Record<string, string>;
+  /*
+    Newest release of each OLD package the new one is known to match,
+    keyed by OLD name. A consumer already on something newer may use APIs
+    the new package doesn't have yet; package-json warns.
+  */
+  sourceVersions: Record<string, string>;
+  movedExports: MovedExport[];
+  deepImports: DeepImport[];
+  /* ESLint plugin prefix, for rule keys, `plugin:` extends, and comments. */
+  eslintPlugin: { from: string; to: string };
+}
+
+/*
+  Match a specifier against a package name, exact or with a subpath.
+  '@codecademy/gamut' matches '@codecademy/gamut/Video' but not
+  '@codecademy/gamut-styles'. Returns the subpath ('' or '/Video') or null.
+*/
+export const matchPackage = (specifier: string, pkg: string) => {
+  if (specifier === pkg) return '';
+  if (specifier.startsWith(`${pkg}/`)) return specifier.slice(pkg.length);
+  return null;
+};
+
+/*
+  The lowest x.y.z a package.json range allows, or null for anything that
+  isn't a plain version, `^`/`~`/`>=` range, or `npm:` alias (`*`, URLs,
+  `workspace:`). Prerelease tags are ignored.
+*/
+export const minVersion = (range: string) => {
+  const match =
+    /^(?:npm:(?:@[^/]+\/)?[^@]+@)?(?:\^|~|>=)?\s*v?(\d+)\.(\d+)\.(\d+)/.exec(
+      range.trim()
+    );
+  return match ? match.slice(1, 4).map(Number) : null;
+};
+
+const parseVersion = (version: string) => version.split('.').map(Number);
+
+/* True when `range` can't be satisfied by `version` or anything older. */
+export const isNewerThan = (range: string, version: string) => {
+  const min = minVersion(range);
+  if (!min) return false;
+  const max = parseVersion(version);
+  for (let i = 0; i < 3; i += 1) {
+    if (min[i] !== max[i]) return min[i] > max[i];
+  }
+  return false;
+};
+
+/* True when every version `range` allows is `version` or newer. */
+export const isAtLeast = (range: string, version: string) => {
+  const min = minVersion(range);
+  if (!min) return false;
+  const floor = parseVersion(version);
+  for (let i = 0; i < 3; i += 1) {
+    if (min[i] !== floor[i]) return min[i] > floor[i];
+  }
+  return true;
+};
+
+/* The new name for an old specifier, keeping any subpath. */
+export const renameSpecifier = (manifest: Manifest, value: string) => {
+  for (const [from, { to }] of Object.entries(manifest.packages)) {
+    const subpath = matchPackage(value, from);
+    if (subpath !== null) return to + subpath;
+  }
+  return null;
+};
+
+export const removedPackageFor = (manifest: Manifest, value: string) =>
+  Object.keys(manifest.removedPackages).find(
+    (pkg) => matchPackage(value, pkg) !== null
+  );
diff --git a/packages/gamut-codemods/src/lib/module-strings.ts b/packages/gamut-codemods/src/lib/module-strings.ts
new file mode 100644
index 0000000000..50b7a5f484
--- /dev/null
+++ b/packages/gamut-codemods/src/lib/module-strings.ts
@@ -0,0 +1,81 @@
+import type { Collection, JSCodeshift, StringLiteral } from 'jscodeshift';
+
+/*
+  Finds every string in a file that names a module: import and export
+  sources, require(), dynamic import(), jest/vi mocks, `import('x').T` types,
+  and `declare module 'x'` augmentations. Migrations that rewrite a specifier
+  should go through here, so a new place a module name can appear only has
+  to be taught once.
+*/
+
+const CALLEE_OBJECTS = new Set(['jest', 'vi']);
+const CALLEE_METHODS = new Set([
+  'mock',
+  'doMock',
+  'unmock',
+  'dontMock',
+  'requireActual',
+  'requireMock',
+  'importActual',
+  'importMock',
+  'setMock',
+]);
+
+/*
+  The tsx parser produces StringLiteral; the babel/estree ones produce
+  Literal. Both carry babel's start/end offsets, which splice edits rely on.
+*/
+export type StringNode = StringLiteral & { start: number; end: number };
+
+export const isStringLiteral = (node: unknown): node is StringNode => {
+  const n = node as { type?: string; value?: unknown } | null;
+  return (
+    !!n &&
+    (n.type === 'StringLiteral' ||
+      (n.type === 'Literal' && typeof n.value === 'string'))
+  );
+};
+
+/*
+  Identifier-ish nodes (Identifier, JSXIdentifier, TSTypeParameter) all
+  carry a string `name`, but the jscodeshift types don't share one shape.
+*/
+export const nameOf = (node: unknown) => {
+  const name = (node as { name?: unknown } | null | undefined)?.name;
+  return typeof name === 'string' ? name : '';
+};
+
+const isModuleCall = (callee: any): boolean => {
+  if (callee.type === 'Import') return true;
+  if (callee.type === 'Identifier') return callee.name === 'require';
+  if (callee.type === 'MemberExpression' && !callee.computed) {
+    const { object, property } = callee;
+    if (object.type !== 'Identifier') return false;
+    if (object.name === 'require') return property.name === 'resolve';
+    return CALLEE_OBJECTS.has(object.name) && CALLEE_METHODS.has(property.name);
+  }
+  return false;
+};
+
+/* The string literal nodes that name a module, in source order. */
+export const findModuleStrings = (j: JSCodeshift, root: Collection) => {
+  const found: StringNode[] = [];
+  const push = (node: unknown) => {
+    if (isStringLiteral(node)) found.push(node);
+  };
+
+  root.find(j.ImportDeclaration).forEach((p) => push(p.node.source));
+  root.find(j.ExportNamedDeclaration).forEach((p) => push(p.node.source));
+  root.find(j.ExportAllDeclaration).forEach((p) => push(p.node.source));
+  root.find(j.CallExpression).forEach((p) => {
+    if (isModuleCall(p.node.callee)) push(p.node.arguments[0]);
+  });
+  root.find(j.ImportExpression).forEach((p) => push(p.node.source));
+  root.find(j.TSImportType).forEach((p) => push(p.node.argument));
+  root.find(j.TSModuleDeclaration).forEach((p) => push(p.node.id));
+  root
+    .find(j.TSExternalModuleReference)
+    .forEach((p) => push(p.node.expression));
+
+  return found;
+};
diff --git a/packages/gamut-codemods/src/lib/package-ranges.ts b/packages/gamut-codemods/src/lib/package-ranges.ts
new file mode 100644
index 0000000000..77a9ba1fff
--- /dev/null
+++ b/packages/gamut-codemods/src/lib/package-ranges.ts
@@ -0,0 +1,52 @@
+import fs from 'node:fs';
+import path from 'node:path';
+
+import { walk } from './leftovers';
+
+const FIELDS = [
+  'dependencies',
+  'devDependencies',
+  'peerDependencies',
+  'optionalDependencies',
+];
+
+const rangesIn = (file: string, pkg: string) => {
+  try {
+    const json = JSON.parse(fs.readFileSync(file, 'utf8')) as Record<
+      string,
+      Record<string, string> | undefined
+    >;
+    return FIELDS.flatMap((field) => json[field]?.[pkg] ?? []);
+  } catch {
+    return [];
+  }
+};
+
+/*
+  Every range `pkg` is listed at in the package.json files under the roots,
+  plus the nearest one above each root up to the git root (running on a
+  subfolder of a monorepo still depends on the root package.json).
+*/
+export const findPackageRanges = (roots: string[], pkg: string) => {
+  const files = new Set<string>();
+  for (const root of roots) {
+    const isDir = fs.statSync(root).isDirectory();
+    for (
+      let dir = isDir ? root : path.dirname(root);
+      dir !== path.dirname(dir);
+      dir = path.dirname(dir)
+    ) {
+      const file = path.join(dir, 'package.json');
+      if (fs.existsSync(file)) {
+        files.add(file);
+        break;
+      }
+      if (fs.existsSync(path.join(dir, '.git'))) break;
+    }
+    if (!isDir) continue;
+    for (const file of walk(root)) {
+      if (path.basename(file) === 'package.json') files.add(file);
+    }
+  }
+  return [...files].flatMap((file) => rangesIn(file, pkg));
+};
diff --git a/packages/gamut-codemods/src/lib/run-source.ts b/packages/gamut-codemods/src/lib/run-source.ts
new file mode 100644
index 0000000000..42eb019392
--- /dev/null
+++ b/packages/gamut-codemods/src/lib/run-source.ts
@@ -0,0 +1,112 @@
+import type { JSCodeshift } from 'jscodeshift';
+
+import type { Manifest } from './manifest';
+import type {
+  AstMigration,
+  Edit,
+  Locatable,
+  Note,
+  SourceMigration,
+  SpliceMigration,
+} from './types';
+
+/*
+  Runs source migrations over one piece of source text. Two phases:
+
+  1. AST migrations share one parse and mutate it. If any changed
+     something, recast prints the text once and `postPrint` hooks run.
+  2. Splice migrations run in order, each against a fresh parse of the
+     current text, returning `{ start, end, text }` edits applied back to
+     front. The re-parse means a later splice sees an earlier one's output
+     (mf-shared writes @codecademy keys that scope-rename then renames).
+
+  Shared by the jscodeshift transform (whole files) and file migrations
+  that embed code, like MDX's ESM blocks.
+*/
+
+export interface RunSourceOptions {
+  j: JSCodeshift;
+  source: string;
+  migrations: SourceMigration[];
+  manifest: Manifest;
+  warnFor: (migration: string) => (node: Locatable, message: string) => void;
+  note: Note;
+}
+
+const applyEdits = (source: string, edits: Edit[]) =>
+  [...edits]
+    .sort((a, b) => b.start - a.start)
+    .reduce(
+      (out, { start, end, text }) =>
+        out.slice(0, start) + text + out.slice(end),
+      source
+    );
+
+export const runSourceMigrations = ({
+  j,
+  source: original,
+  migrations,
+  manifest,
+  warnFor,
+  note,
+}: RunSourceOptions) => {
+  let source = original;
+
+  const astMigrations = migrations.filter(
+    (m): m is AstMigration => m.kind === 'ast'
+  );
+  if (astMigrations.length > 0) {
+    const root = j(source);
+    let changed = false;
+    for (const m of astMigrations) {
+      changed =
+        m.run({ j, root, source, manifest, warn: warnFor(m.name), note }) ||
+        changed;
+    }
+    if (changed) {
+      source = astMigrations.reduce(
+        (out, m) => (m.postPrint ? m.postPrint(out, { manifest }) : out),
+        root.toSource({ quote: 'single' })
+      );
+    }
+  }
+
+  for (const m of migrations.filter(
+    (x): x is SpliceMigration => x.kind === 'splice'
+  )) {
+    const root = j(source);
+    const edits = m.edits({
+      j,
+      root,
+      source,
+      manifest,
+      warn: warnFor(m.name),
+      note,
+    });
+    if (edits.length > 0) source = applyEdits(source, edits);
+  }
+
+  return source;
+};
+
+/* The pre-filter every caller uses so big repos don't parse every file. */
+export const mentionsOldNames = (manifest: Manifest, source: string) =>
+  [
+    ...Object.keys(manifest.packages),
+    ...Object.keys(manifest.removedPackages),
+    `${manifest.eslintPlugin.from}/`,
+  ].some((name) => source.includes(name));
+
+/* `only` and `skip` are comma-separated migration names. */
+export const activeSourceMigrations = (
+  migrations: { kind: string; name: string }[],
+  only?: string,
+  skip?: string
+) => {
+  const names = only ? new Set(only.split(',')) : null;
+  const skipped = new Set(skip ? skip.split(',') : []);
+  return migrations.filter(
+    (m) =>
+      m.kind !== 'file' && (!names || names.has(m.name)) && !skipped.has(m.name)
+  ) as SourceMigration[];
+};
diff --git a/packages/gamut-codemods/src/lib/types.ts b/packages/gamut-codemods/src/lib/types.ts
new file mode 100644
index 0000000000..76064080ca
--- /dev/null
+++ b/packages/gamut-codemods/src/lib/types.ts
@@ -0,0 +1,96 @@
+import type { Collection, JSCodeshift } from 'jscodeshift';
+
+import type { Manifest } from './manifest';
+
+/* Anything with a source location, so warnings can point at a line. */
+export type Locatable =
+  | { loc?: { start: { line: number } } | null }
+  | null
+  | undefined;
+
+export type Warn = (node: Locatable, message: string) => void;
+
+/*
+  Records that a checklist item applies to this run. Keys are defined by the
+  preset; the CLI prints the matching items once every file is done.
+*/
+export type Note = (checklistKey: string) => void;
+
+export interface SourceContext {
+  j: JSCodeshift;
+  root: Collection;
+  source: string;
+  manifest: Manifest;
+  warn: Warn;
+  note: Note;
+}
+
+export interface Edit {
+  start: number;
+  end: number;
+  text: string;
+}
+
+interface MigrationBase {
+  name: string;
+  description: string;
+  /*
+    Checked once per run, before any file is touched. Return a reason to
+    skip this migration for the whole run (the CLI prints it and notes
+    `skipped:<name>`), or null to run it.
+  */
+  skipReason?(roots: string[], manifest: Manifest): string | null;
+}
+
+/*
+  Mutates the shared AST. Use for structural rewrites only: recast reprints
+  whatever it thinks changed, and in semicolon-less files that has spread to
+  neighbouring statements. Return true if anything changed.
+*/
+export interface AstMigration extends MigrationBase {
+  kind: 'ast';
+  run(ctx: SourceContext): boolean;
+  /* Formatting fixes on the printed output that the AST can't express. */
+  postPrint?(source: string, ctx: { manifest: Manifest }): string;
+}
+
+/*
+  Uses the AST to find ranges, then edits the original text by offset. The
+  default for anything that swaps one string for another.
+*/
+export interface SpliceMigration extends MigrationBase {
+  kind: 'splice';
+  edits(ctx: SourceContext): Edit[];
+}
+
+/* Gets raw text for non-source files (package.json, .eslintrc, .mdx). */
+export interface FileMigration extends MigrationBase {
+  kind: 'file';
+  match(path: string): boolean;
+  run(ctx: {
+    source: string;
+    manifest: Manifest;
+    warn: (message: string) => void;
+    note: Note;
+    /*
+      Runs the preset's source migrations (respecting --only) over a
+      snippet of JS/TS, for files that embed code, like MDX's ESM blocks.
+    */
+    transformSource: (code: string) => string;
+  }): string | null;
+}
+
+export type SourceMigration = AstMigration | SpliceMigration;
+export type Migration = SourceMigration | FileMigration;
+
+export interface Preset {
+  name: string;
+  description: string;
+  manifest: Manifest;
+  /* Run in order. All `ast` migrations must come before any `splice` one. */
+  migrations: Migration[];
+  /* Printed at the end of every run. */
+  checklist: string[];
+  /* Printed only when a migration calls note(key). */
+  conditionalChecklist: Record<string, string>;
+}
diff --git a/packages/gamut-codemods/src/migrations/deep-imports/__testfixtures__/export-namespace.input.tsx b/packages/gamut-codemods/src/migrations/deep-imports/__testfixtures__/export-namespace.input.tsx
new file mode 100644
index 0000000000..ea78e5f00c
--- /dev/null
+++ b/packages/gamut-codemods/src/migrations/deep-imports/__testfixtures__/export-namespace.input.tsx
@@ -0,0 +1 @@
+export * as Menu from '@codecademy/gamut/dist/Menu/elements';
diff --git a/packages/gamut-codemods/src/migrations/deep-imports/__testfixtures__/export-namespace.output.tsx b/packages/gamut-codemods/src/migrations/deep-imports/__testfixtures__/export-namespace.output.tsx
new file mode 100644
index 0000000000..ee558bb537
--- /dev/null
+++ b/packages/gamut-codemods/src/migrations/deep-imports/__testfixtures__/export-namespace.output.tsx
@@ -0,0 +1 @@
+export * as Menu from '@codecademy/gamut';
diff --git a/packages/gamut-codemods/src/migrations/deep-imports/__testfixtures__/export-unrenamed.input.tsx b/packages/gamut-codemods/src/migrations/deep-imports/__testfixtures__/export-unrenamed.input.tsx
new file mode 100644
index 0000000000..be42f12b6d
--- /dev/null
+++ b/packages/gamut-codemods/src/migrations/deep-imports/__testfixtures__/export-unrenamed.input.tsx
@@ -0,0 +1 @@
+export { MenuIcon, ListItem } from '@codecademy/gamut/dist/Menu/elements';
diff --git a/packages/gamut-codemods/src/migrations/deep-imports/__testfixtures__/export-unrenamed.output.tsx b/packages/gamut-codemods/src/migrations/deep-imports/__testfixtures__/export-unrenamed.output.tsx
new file mode 100644
index 0000000000..00eb532465
--- /dev/null
+++ b/packages/gamut-codemods/src/migrations/deep-imports/__testfixtures__/export-unrenamed.output.tsx
@@ -0,0 +1 @@
+export { MenuIcon, MenuListItem as ListItem } from '@codecademy/gamut';
diff --git a/packages/gamut-codemods/src/migrations/deep-imports/__testfixtures__/form-styles.input.tsx b/packages/gamut-codemods/src/migrations/deep-imports/__testfixtures__/form-styles.input.tsx
new file mode 100644
index 0000000000..11737f72e1
--- /dev/null
+++ b/packages/gamut-codemods/src/migrations/deep-imports/__testfixtures__/form-styles.input.tsx
@@ -0,0 +1,4 @@
+import { conditionalStyles, formFieldStyles } from '@codecademy/gamut/dist/Form/styles';
+import { formFieldPaddingStyles as padding } from '@codecademy/gamut/dist/Form/styles';
+import { formFieldStyles as f, checkboxLabel } from '@codecademy/gamut/dist/Form/styles';
+import * as formStyles from '@codecademy/gamut/dist/Form/styles';
diff --git a/packages/gamut-codemods/src/migrations/deep-imports/__testfixtures__/form-styles.output.tsx b/packages/gamut-codemods/src/migrations/deep-imports/__testfixtures__/form-styles.output.tsx
new file mode 100644
index 0000000000..4bc7534bda
--- /dev/null
+++ b/packages/gamut-codemods/src/migrations/deep-imports/__testfixtures__/form-styles.output.tsx
@@ -0,0 +1,3 @@
+import { conditionalStyles, formFieldStyles, formFieldPaddingStyles as padding } from '@codecademy/gamut';
+import { formFieldStyles as f, checkboxLabel } from '@codecademy/gamut/dist/Form/styles';
+import * as formStyles from '@codecademy/gamut/dist/Form/styles';
diff --git a/packages/gamut-codemods/src/migrations/deep-imports/__testfixtures__/form-styles.warnings.json b/packages/gamut-codemods/src/migrations/deep-imports/__testfixtures__/form-styles.warnings.json
new file mode 100644
index 0000000000..e127ff61a0
--- /dev/null
+++ b/packages/gamut-codemods/src/migrations/deep-imports/__testfixtures__/form-styles.warnings.json
@@ -0,0 +1 @@
+["checkboxLabel isn't exported from '@codecademy/gamut'", "* isn't exported from '@codecademy/gamut'"]
diff --git a/packages/gamut-codemods/src/migrations/deep-imports/__testfixtures__/merge.input.tsx b/packages/gamut-codemods/src/migrations/deep-imports/__testfixtures__/merge.input.tsx
new file mode 100644
index 0000000000..50ad1aeb75
--- /dev/null
+++ b/packages/gamut-codemods/src/migrations/deep-imports/__testfixtures__/merge.input.tsx
@@ -0,0 +1,8 @@
+import { Box, FlexBox, List, Text } from '@codecademy/gamut';
+import { ListItem } from '@codecademy/gamut/dist/Menu/elements';
+import type { BoxProps } from '@codecademy/gamut';
+import type { PopoverContainerProps } from '@codecademy/gamut/dist/PopoverContainer/types';
+import { Box as Again } from '@codecademy/gamut/dist/Box/props';
+import * as Gamut from '@codecademy/gamut';
+import { variance } from '@codecademy/variance';
+import { Prop } from '@codecademy/variance/dist/types/config';
diff --git a/packages/gamut-codemods/src/migrations/deep-imports/__testfixtures__/merge.output.tsx b/packages/gamut-codemods/src/migrations/deep-imports/__testfixtures__/merge.output.tsx
new file mode 100644
index 0000000000..3ed5ef37eb
--- /dev/null
+++ b/packages/gamut-codemods/src/migrations/deep-imports/__testfixtures__/merge.output.tsx
@@ -0,0 +1,5 @@
+import { Box, FlexBox, List, Text, MenuListItem as ListItem } from '@codecademy/gamut';
+import type { BoxProps, PopoverContainerProps } from '@codecademy/gamut';
+import { Box as Again } from '@codecademy/gamut/dist/Box/props';
+import * as Gamut from '@codecademy/gamut';
+import { variance, Prop } from '@codecademy/variance';
diff --git a/packages/gamut-codemods/src/migrations/deep-imports/__testfixtures__/merge.warnings.json b/packages/gamut-codemods/src/migrations/deep-imports/__testfixtures__/merge.warnings.json
new file mode 100644
index 0000000000..e75a27f408
--- /dev/null
+++ b/packages/gamut-codemods/src/migrations/deep-imports/__testfixtures__/merge.warnings.json
@@ -0,0 +1 @@
+["is only partly public"]
diff --git a/packages/gamut-codemods/src/migrations/deep-imports/__testfixtures__/mocks-unmapped.input.tsx b/packages/gamut-codemods/src/migrations/deep-imports/__testfixtures__/mocks-unmapped.input.tsx
new file mode 100644
index 0000000000..e812781efe
--- /dev/null
+++ b/packages/gamut-codemods/src/migrations/deep-imports/__testfixtures__/mocks-unmapped.input.tsx
@@ -0,0 +1,5 @@
+import { Box } from '@codecademy/gamut/dist/Box';
+
+jest.mock('@codecademy/gamut/dist/Nope/thing', () => ({}));
+const button = require('@codecademy/gamut/dist/ButtonBase/ButtonBase');
+export const B = [Box, button];
diff --git a/packages/gamut-codemods/src/migrations/deep-imports/__testfixtures__/mocks-unmapped.output.tsx b/packages/gamut-codemods/src/migrations/deep-imports/__testfixtures__/mocks-unmapped.output.tsx
new file mode 100644
index 0000000000..e812781efe
--- /dev/null
+++ b/packages/gamut-codemods/src/migrations/deep-imports/__testfixtures__/mocks-unmapped.output.tsx
@@ -0,0 +1,5 @@
+import { Box } from '@codecademy/gamut/dist/Box';
+
+jest.mock('@codecademy/gamut/dist/Nope/thing', () => ({}));
+const button = require('@codecademy/gamut/dist/ButtonBase/ButtonBase');
+export const B = [Box, button];
diff --git a/packages/gamut-codemods/src/migrations/deep-imports/__testfixtures__/mocks-unmapped.warnings.json b/packages/gamut-codemods/src/migrations/deep-imports/__testfixtures__/mocks-unmapped.warnings.json
new file mode 100644
index 0000000000..a953128956
--- /dev/null
+++ b/packages/gamut-codemods/src/migrations/deep-imports/__testfixtures__/mocks-unmapped.warnings.json
@@ -0,0 +1,4 @@
+[
+  "'@codecademy/gamut/dist/Nope/thing' in a mock or require() needs a manual rewrite",
+  "'@codecademy/gamut/dist/ButtonBase/ButtonBase' in a mock or require() needs a manual rewrite"
+]
diff --git a/packages/gamut-codemods/src/migrations/deep-imports/__testfixtures__/renames.input.tsx b/packages/gamut-codemods/src/migrations/deep-imports/__testfixtures__/renames.input.tsx
new file mode 100644
index 0000000000..32ee05b6fa
--- /dev/null
+++ b/packages/gamut-codemods/src/migrations/deep-imports/__testfixtures__/renames.input.tsx
@@ -0,0 +1,6 @@
+import { List, ListItem as Item, type ListProps } from '@codecademy/gamut/dist/Menu/elements';
+import { IconOption } from '@codecademy/gamut/dist/Form/SelectDropdown/elements';
+
+export { ListButton } from '@codecademy/gamut/dist/Menu/elements';
+
+jest.mock('@codecademy/gamut/dist/Menu/elements', () => ({ List: () => null }));
diff --git a/packages/gamut-codemods/src/migrations/deep-imports/__testfixtures__/renames.output.tsx b/packages/gamut-codemods/src/migrations/deep-imports/__testfixtures__/renames.output.tsx
new file mode 100644
index 0000000000..10ed954ccc
--- /dev/null
+++ b/packages/gamut-codemods/src/migrations/deep-imports/__testfixtures__/renames.output.tsx
@@ -0,0 +1,10 @@
+import {
+  MenuList as List,
+  MenuListItem as Item,
+  type MenuListProps as ListProps,
+  IconOptionComponent as IconOption,
+} from '@codecademy/gamut';
+
+export { MenuListButton as ListButton } from '@codecademy/gamut';
+
+jest.mock('@codecademy/gamut', () => ({ List: () => null }));
diff --git a/packages/gamut-codemods/src/migrations/deep-imports/__testfixtures__/renames.warnings.json b/packages/gamut-codemods/src/migrations/deep-imports/__testfixtures__/renames.warnings.json
new file mode 100644
index 0000000000..6b61771448
--- /dev/null
+++ b/packages/gamut-codemods/src/migrations/deep-imports/__testfixtures__/renames.warnings.json
@@ -0,0 +1 @@
+["That now covers the whole package, and some exports were renamed. Check it by hand."]
diff --git a/packages/gamut-codemods/src/migrations/deep-imports/__testfixtures__/rewrites.input.tsx b/packages/gamut-codemods/src/migrations/deep-imports/__testfixtures__/rewrites.input.tsx
new file mode 100644
index 0000000000..3fad9f3b4b
--- /dev/null
+++ b/packages/gamut-codemods/src/migrations/deep-imports/__testfixtures__/rewrites.input.tsx
@@ -0,0 +1,7 @@
+import { PopoverContainerProps } from '@codecademy/gamut/dist/PopoverContainer/types';
+import type { Prop } from '@codecademy/variance/dist/types/config';
+import { formStyles } from '@codecademy/gamut/dist/Form/styles';
+import { ButtonBase } from '@codecademy/gamut/dist/ButtonBase/ButtonBase';
+import { Mystery } from '@codecademy/gamut/dist/Nope';
+
+jest.mock('@codecademy/gamut/dist/Box/props');
diff --git a/packages/gamut-codemods/src/migrations/deep-imports/__testfixtures__/rewrites.output.tsx b/packages/gamut-codemods/src/migrations/deep-imports/__testfixtures__/rewrites.output.tsx
new file mode 100644
index 0000000000..d882b3d9f0
--- /dev/null
+++ b/packages/gamut-codemods/src/migrations/deep-imports/__testfixtures__/rewrites.output.tsx
@@ -0,0 +1,7 @@
+import { PopoverContainerProps } from '@codecademy/gamut';
+import type { Prop } from '@codecademy/variance';
+import { formStyles } from '@codecademy/gamut/dist/Form/styles';
+import { ButtonBase } from '@codecademy/gamut/dist/ButtonBase/ButtonBase';
+import { Mystery } from '@codecademy/gamut/dist/Nope';
+
+jest.mock('@codecademy/gamut');
diff --git a/packages/gamut-codemods/src/migrations/deep-imports/__testfixtures__/rewrites.warnings.json b/packages/gamut-codemods/src/migrations/deep-imports/__testfixtures__/rewrites.warnings.json
new file mode 100644
index 0000000000..99cf5b0f92
--- /dev/null
+++ b/packages/gamut-codemods/src/migrations/deep-imports/__testfixtures__/rewrites.warnings.json
@@ -0,0 +1 @@
+["'@codecademy/gamut/dist/Form/styles' is only partly public. formStyles isn't exported from '@codecademy/gamut'", "'@codecademy/gamut/dist/ButtonBase/ButtonBase' has no public replacement", "unmapped deep import '@codecademy/gamut/dist/Nope'", "rewrote '@codecademy/gamut/dist/Box/props' to '@codecademy/gamut' in a mock or require(). That now covers the whole package."]
diff --git a/packages/gamut-codemods/src/migrations/deep-imports/index.ts b/packages/gamut-codemods/src/migrations/deep-imports/index.ts
new file mode 100644
index 0000000000..0f4ac866d2
--- /dev/null
+++ b/packages/gamut-codemods/src/migrations/deep-imports/index.ts
@@ -0,0 +1,218 @@
+import type {
+  Collection,
+  ExportSpecifier,
+  ImportDeclaration,
+  ImportSpecifier,
+  JSCodeshift,
+} from 'jscodeshift';
+
+import { findModuleStrings, nameOf } from '../../lib/module-strings';
+import type { AstMigration } from '../../lib/types';
+
+/*
+  `@codecademy/gamut/dist/...` -> the public entry point from
+  manifest.deepImports. Renamed exports keep their local name so call sites
+  don't change: `import { List }` becomes `import { MenuList as List }`.
+*/
+
+const DIST = /^(@codecademy\/[\w-]+|eslint-plugin-gamut)\/dist(\/|$)/;
+
+type Specifier = ImportSpecifier | ExportSpecifier | { type: string };
+
+/*
+  Specifiers are rebuilt rather than mutated. `import { List }` has imported
+  and local sharing one source range, so recast's patcher drops the alias if
+  you only swap `imported`.
+*/
+const renameSpecifiers = (
+  j: JSCodeshift,
+  specifiers: Specifier[],
+  renames: Record<string, string>
+) =>
+  specifiers.map((spec) => {
+    if (spec.type === 'ImportSpecifier') {
+      const { imported, local, importKind } = spec as ImportSpecifier & {
+        importKind?: string;
+      };
+      const next = renames[nameOf(imported)];
+      if (!next) return spec;
+      const renamed = j.importSpecifier(
+        j.identifier(next),
+        j.identifier(nameOf(local ?? imported))
+      );
+      Object.assign(renamed, { importKind });
+      return renamed;
+    }
+    if (spec.type === 'ExportSpecifier') {
+      const { local, exported } = spec as ExportSpecifier;
+      const next = renames[nameOf(local)];
+      if (!next) return spec;
+      return j.exportSpecifier.from({
+        local: j.identifier(next),
+        exported: j.identifier(nameOf(exported ?? local)),
+      });
+    }
+    return spec;
+  });
+
+/* Only plain `{ a, b as c }` imports can be merged; defaults and `* as` can't. */
+const namedOnly = (node: ImportDeclaration) =>
+  (node.specifiers ?? []).every((spec) => spec.type === 'ImportSpecifier');
+
+const mergeKey = (node: ImportDeclaration) =>
+  `${String(node.source.value)}\0${node.importKind ?? 'value'}`;
+
+type NamedSpecifier = ImportSpecifier & { importKind?: string };
+
+const specifierKey = (spec: NamedSpecifier) =>
+  `${spec.importKind ?? 'value'} ${nameOf(spec.imported)} ${nameOf(
+    spec.local ?? spec.imported
+  )}`;
+
+/*
+  A rewritten deep import often lands on a package the file already
+  imports from, and two declarations from one source trip
+  import/no-duplicates. Fold each rewritten declaration into the first
+  plain named import of the same source and kind. Declarations the file
+  already had are never merged with each other.
+*/
+const mergeRewritten = (
+  j: JSCodeshift,
+  root: Collection,
+  rewritten: Set<unknown>
+) => {
+  const targets = new Map<string, ImportDeclaration>();
+  root.find(j.ImportDeclaration).forEach((p) => {
+    const { node } = p;
+    if (!namedOnly(node)) return;
+    const key = mergeKey(node);
+    const target = targets.get(key);
+    if (!target) {
+      targets.set(key, node);
+      return;
+    }
+    if (!rewritten.has(node)) return;
+
+    const existing = new Set(
+      (target.specifiers as NamedSpecifier[]).map(specifierKey)
+    );
+    /* Clone into the target; recast's patcher can crash on moved nodes. */
+    const moved = (node.specifiers as NamedSpecifier[])
+      .filter((spec) => !existing.has(specifierKey(spec)))
+      .map((spec) =>
+        Object.assign(
+          j.importSpecifier(
+            j.identifier(nameOf(spec.imported)),
+            j.identifier(nameOf(spec.local ?? spec.imported))
+          ),
+          { importKind: spec.importKind }
+        )
+      );
+    target.specifiers = [...(target.specifiers ?? []), ...moved];
+    j(p).remove();
+  });
+};
+
+export const deepImports: AstMigration = {
+  name: 'deep-imports',
+  kind: 'ast',
+  description: 'Rewrite /dist/ deep imports to public entry points.',
+  run({ j, root, manifest, warn }) {
+    const byPath = new Map(manifest.deepImports.map((row) => [row.from, row]));
+    let changed = false;
+
+    /* Declarations first, so renames can be applied to their specifiers. */
+    const declarations = [
+      ...root.find(j.ImportDeclaration).nodes(),
+      ...root.find(j.ExportNamedDeclaration).nodes(),
+      ...root.find(j.ExportAllDeclaration).nodes(),
+    ];
+    const handled = new Set<unknown>();
+    const rewritten = new Set<unknown>();
+
+    for (const node of declarations) {
+      const source = node.source as { value?: unknown } | null | undefined;
+      if (typeof source?.value !== 'string' || !DIST.test(source.value)) {
+        continue;
+      }
+      handled.add(source);
+      const row = byPath.get(source.value);
+      if (!row) {
+        warn(
+          node,
+          `unmapped deep import '${source.value}'. Add it to the preset manifest's deepImports.`
+        );
+        continue;
+      }
+      if (!row.to) {
+        warn(
+          node,
+          `'${row.from}' has no public replacement. ${row.note ?? ''}`
+        );
+        continue;
+      }
+      if (row.onlyNames) {
+        const allowed = new Set(row.onlyNames);
+        const specifiers =
+          'specifiers' in node ? ((node.specifiers ?? []) as Specifier[]) : [];
+        const blocked = specifiers
+          .map((spec) =>
+            spec.type === 'ImportSpecifier'
+              ? nameOf((spec as ImportSpecifier).imported)
+              : spec.type === 'ExportSpecifier'
+              ? nameOf((spec as ExportSpecifier).local)
+              : '*'
+          )
+          .filter((name) => !allowed.has(name));
+        if (node.type === 'ExportAllDeclaration') blocked.push('*');
+        if (blocked.length > 0) {
+          warn(
+            node,
+            `'${row.from}' is only partly public. ${blocked.join(
+              ', '
+            )} isn't exported from '${row.to}'. ${row.note ?? ''}`
+          );
+          continue;
+        }
+      }
+      if (row.renames && 'specifiers' in node && node.specifiers) {
+        node.specifiers = renameSpecifiers(
+          j,
+          node.specifiers,
+          row.renames
+        ) as typeof node.specifiers;
+      }
+      node.source = j.stringLiteral(row.to);
+      if (node.type === 'ImportDeclaration') rewritten.add(node);
+      changed = true;
+    }
+
+    if (rewritten.size > 0) mergeRewritten(j, root, rewritten);
+
+    /* Then mocks, require(), import(): only the string can change here. */
+    for (const literal of findModuleStrings(j, root)) {
+      if (handled.has(literal) || !DIST.test(literal.value)) continue;
+      const row = byPath.get(literal.value);
+      if (!row?.to) {
+        warn(
+          literal,
+          `deep import '${literal.value}' in a mock or require() needs a manual rewrite.`
+        );
+        continue;
+      }
+      /* jest.mock of a deep path now mocks the whole package. */
+      warn(
+        literal,
+        `rewrote '${literal.value}' to '${
+          row.to
+        }' in a mock or require(). That now covers the whole package${
+          row.renames ? ', and some exports were renamed' : ''
+        }. Check it by hand.`
+      );
+      literal.value = row.to;
+      changed = true;
+    }
+
+    return changed;
+  },
+};
diff --git a/packages/gamut-codemods/src/migrations/eslint-comments/__testfixtures__/directives.input.tsx b/packages/gamut-codemods/src/migrations/eslint-comments/__testfixtures__/directives.input.tsx
new file mode 100644
index 0000000000..61b977827c
--- /dev/null
+++ b/packages/gamut-codemods/src/migrations/eslint-comments/__testfixtures__/directives.input.tsx
@@ -0,0 +1,6 @@
+// eslint-disable-next-line gamut/no-inline-style
+const a = 1;
+/* eslint-disable gamut/prefer-themed, react/no-danger */
+// eslint-disable-next-line @skillsoft/gamut/no-css-standalone
+const b = 2;
+// talking about gamut/no-inline-style in prose stays put
diff --git a/packages/gamut-codemods/src/migrations/eslint-comments/__testfixtures__/directives.output.tsx b/packages/gamut-codemods/src/migrations/eslint-comments/__testfixtures__/directives.output.tsx
new file mode 100644
index 0000000000..6902386e06
--- /dev/null
+++ b/packages/gamut-codemods/src/migrations/eslint-comments/__testfixtures__/directives.output.tsx
@@ -0,0 +1,6 @@
+// eslint-disable-next-line @skillsoft/gamut/no-inline-style
+const a = 1;
+/* eslint-disable @skillsoft/gamut/prefer-themed, react/no-danger */
+// eslint-disable-next-line @skillsoft/gamut/no-css-standalone
+const b = 2;
+// talking about gamut/no-inline-style in prose stays put
diff --git a/packages/gamut-codemods/src/migrations/eslint-comments/index.ts b/packages/gamut-codemods/src/migrations/eslint-comments/index.ts
new file mode 100644
index 0000000000..0444cf1cb7
--- /dev/null
+++ b/packages/gamut-codemods/src/migrations/eslint-comments/index.ts
@@ -0,0 +1,61 @@
+import { findFlatEslintConfig } from '../../lib/eslint';
+import type { Edit, SpliceMigration } from '../../lib/types';
+
+/*
+  `// eslint-disable-next-line gamut/no-inline-style` ->
+  `// eslint-disable-next-line @skillsoft/gamut/no-inline-style`.
+  Rule names are unchanged; only the plugin prefix moves.
+
+  Legacy .eslintrc only, to match eslint-config. With a flat config the
+  prefix stays whatever key the plugin is registered under, so renamed
+  directives would name a rule that doesn't exist ("Definition for rule
+  ... was not found") and stop suppressing the real one.
+*/
+
+const DIRECTIVE = /^\s*(eslint-disable|eslint-enable|eslint\s)/;
+
+interface CommentNode {
+  type: string;
+  value: string;
+  start: number;
+  end: number;
+}
+
+const isBlock = (comment: CommentNode) =>
+  comment.type === 'CommentBlock' || comment.type === 'Block';
+
+export const eslintComments: SpliceMigration = {
+  name: 'eslint-comments',
+  kind: 'splice',
+  description:
+    'Update ESLint directive comments to the new plugin rule prefix.',
+  skipReason(roots) {
+    const config = findFlatEslintConfig(roots);
+    return config
+      ? `found flat ESLint config ${config}; directive prefixes follow its plugins key, so they're left as is.`
+      : null;
+  },
+  edits({ j, root, manifest }) {
+    const { from, to } = manifest.eslintPlugin;
+    /* The prefix at the start of a rule name, not one already scoped. */
+    const prefix = new RegExp(`(^|[\\s,])${from}/`, 'g');
+    const edits: Edit[] = [];
+    const seen = new Set<number>();
+
+    /* j.Comment paths point at the owning node, so walk node.comments. */
+    root.find(j.Node).forEach((p) => {
+      const comments = (p.node as { comments?: CommentNode[] }).comments ?? [];
+      for (const comment of comments) {
+        if (seen.has(comment.start)) continue;
+        seen.add(comment.start);
+        if (!DIRECTIVE.test(comment.value)) continue;
+        const value = comment.value.replace(prefix, `$1${to}/`);
+        if (value === comment.value) continue;
+        const text = isBlock(comment) ? `/*${value}*/` : `//${value}`;
+        edits.push({ start: comment.start, end: comment.end, text });
+      }
+    });
+
+    return edits;
+  },
+};
diff --git a/packages/gamut-codemods/src/migrations/eslint-config/__testfixtures__/legacy.input.json b/packages/gamut-codemods/src/migrations/eslint-config/__testfixtures__/legacy.input.json
new file mode 100644
index 0000000000..8fc62bdc2b
--- /dev/null
+++ b/packages/gamut-codemods/src/migrations/eslint-config/__testfixtures__/legacy.input.json
@@ -0,0 +1,9 @@
+{
+  "plugins": ["gamut"],
+  "extends": ["plugin:gamut/recommended"],
+  "rules": {
+    // keep these on
+    "gamut/no-css-standalone": "error",
+    "gamut/no-inline-style": "error"
+  }
+}
diff --git a/packages/gamut-codemods/src/migrations/eslint-config/__testfixtures__/legacy.output.json b/packages/gamut-codemods/src/migrations/eslint-config/__testfixtures__/legacy.output.json
new file mode 100644
index 0000000000..cfb581e347
--- /dev/null
+++ b/packages/gamut-codemods/src/migrations/eslint-config/__testfixtures__/legacy.output.json
@@ -0,0 +1,9 @@
+{
+  "plugins": ["@skillsoft/gamut"],
+  "extends": ["plugin:@skillsoft/gamut/recommended"],
+  "rules": {
+    // keep these on
+    "@skillsoft/gamut/no-css-standalone": "error",
+    "@skillsoft/gamut/no-inline-style": "error"
+  }
+}
diff --git a/packages/gamut-codemods/src/migrations/eslint-config/index.ts b/packages/gamut-codemods/src/migrations/eslint-config/index.ts
new file mode 100644
index 0000000000..34f50ed381
--- /dev/null
+++ b/packages/gamut-codemods/src/migrations/eslint-config/index.ts
@@ -0,0 +1,28 @@
+import type { FileMigration } from '../../lib/types';
+
+/*
+  Legacy .eslintrc / .eslintrc.json only. These are often JSONC (mono's
+  have comments), so this is a targeted text rewrite rather than
+  JSON.parse. JS and flat configs are left alone: in a flat config the rule
+  prefix is whatever key the plugin is registered under, so blindly
+  renaming rule keys would break it. The leftovers report lists them.
+*/
+
+const escape = (s: string) => s.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+
+export const eslintConfig: FileMigration = {
+  name: 'eslint-config',
+  kind: 'file',
+  description:
+    'Update the plugin name, `plugin:` extends, and rule prefix in .eslintrc(.json).',
+  match: (file) => /(^|\/)\.eslintrc(\.json)?$/.test(file),
+  run({ source, manifest }) {
+    const { from, to } = manifest.eslintPlugin;
+    const old = escape(from);
+    const next = source
+      .replace(new RegExp(`"plugin:${old}/`, 'g'), `"plugin:${to}/`)
+      .replace(new RegExp(`"${old}/`, 'g'), `"${to}/`)
+      .replace(new RegExp(`"(eslint-plugin-)?${old}"`, 'g'), `"${to}"`);
+    return next === source ? null : next;
+  },
+};
diff --git a/packages/gamut-codemods/src/migrations/markdown-video-overrides/__testfixtures__/clash.input.tsx b/packages/gamut-codemods/src/migrations/markdown-video-overrides/__testfixtures__/clash.input.tsx
new file mode 100644
index 0000000000..07823f1b32
--- /dev/null
+++ b/packages/gamut-codemods/src/migrations/markdown-video-overrides/__testfixtures__/clash.input.tsx
@@ -0,0 +1,4 @@
+import { Markdown } from '@codecademy/gamut';
+import { Iframe } from './local/Iframe';
+
+export const Post = ({ text }: { text: string }) => <Markdown text={text} />;
diff --git a/packages/gamut-codemods/src/migrations/markdown-video-overrides/__testfixtures__/clash.output.tsx b/packages/gamut-codemods/src/migrations/markdown-video-overrides/__testfixtures__/clash.output.tsx
new file mode 100644
index 0000000000..07823f1b32
--- /dev/null
+++ b/packages/gamut-codemods/src/migrations/markdown-video-overrides/__testfixtures__/clash.output.tsx
@@ -0,0 +1,4 @@
+import { Markdown } from '@codecademy/gamut';
+import { Iframe } from './local/Iframe';
+
+export const Post = ({ text }: { text: string }) => <Markdown text={text} />;
diff --git a/packages/gamut-codemods/src/migrations/markdown-video-overrides/__testfixtures__/clash.warnings.json b/packages/gamut-codemods/src/migrations/markdown-video-overrides/__testfixtures__/clash.warnings.json
new file mode 100644
index 0000000000..eddb29a154
--- /dev/null
+++ b/packages/gamut-codemods/src/migrations/markdown-video-overrides/__testfixtures__/clash.warnings.json
@@ -0,0 +1,3 @@
+[
+  "a different import already uses the name Iframe or MarkdownVideo"
+]
diff --git a/packages/gamut-codemods/src/migrations/markdown-video-overrides/__testfixtures__/default.input.tsx b/packages/gamut-codemods/src/migrations/markdown-video-overrides/__testfixtures__/default.input.tsx
new file mode 100644
index 0000000000..5e6f484ce0
--- /dev/null
+++ b/packages/gamut-codemods/src/migrations/markdown-video-overrides/__testfixtures__/default.input.tsx
@@ -0,0 +1,3 @@
+import { Markdown } from '@codecademy/gamut';
+
+export const Post = ({ text }: { text: string }) => <Markdown text={text} />;
diff --git a/packages/gamut-codemods/src/migrations/markdown-video-overrides/__testfixtures__/default.output.tsx b/packages/gamut-codemods/src/migrations/markdown-video-overrides/__testfixtures__/default.output.tsx
new file mode 100644
index 0000000000..22a1ab06d4
--- /dev/null
+++ b/packages/gamut-codemods/src/migrations/markdown-video-overrides/__testfixtures__/default.output.tsx
@@ -0,0 +1,11 @@
+import { Markdown } from '@codecademy/gamut';
+import { Iframe, MarkdownVideo } from '@codecademy/gamut/Video';
+
+export const Post = ({ text }: { text: string }) => <Markdown
+  text={text}
+  iframeOverride={{
+    component: Iframe
+  }}
+  videoOverride={{
+    component: MarkdownVideo
+  }} />;
diff --git a/packages/gamut-codemods/src/migrations/markdown-video-overrides/__testfixtures__/merge-existing.input.tsx b/packages/gamut-codemods/src/migrations/markdown-video-overrides/__testfixtures__/merge-existing.input.tsx
new file mode 100644
index 0000000000..8f754cdafc
--- /dev/null
+++ b/packages/gamut-codemods/src/migrations/markdown-video-overrides/__testfixtures__/merge-existing.input.tsx
@@ -0,0 +1,5 @@
+import { Markdown } from '@codecademy/gamut';
+import { Video } from '@codecademy/gamut/Video';
+
+export const Player = () => <Video videoUrl={url} />;
+export const Post = ({ text }: { text: string }) => <Markdown text={text} />;
diff --git a/packages/gamut-codemods/src/migrations/markdown-video-overrides/__testfixtures__/merge-existing.output.tsx b/packages/gamut-codemods/src/migrations/markdown-video-overrides/__testfixtures__/merge-existing.output.tsx
new file mode 100644
index 0000000000..ef63b215ae
--- /dev/null
+++ b/packages/gamut-codemods/src/migrations/markdown-video-overrides/__testfixtures__/merge-existing.output.tsx
@@ -0,0 +1,12 @@
+import { Markdown } from '@codecademy/gamut';
+import { Video, Iframe, MarkdownVideo } from '@codecademy/gamut/Video';
+
+export const Player = () => <Video videoUrl={url} />;
+export const Post = ({ text }: { text: string }) => <Markdown
+  text={text}
+  iframeOverride={{
+    component: Iframe
+  }}
+  videoOverride={{
+    component: MarkdownVideo
+  }} />;
diff --git a/packages/gamut-codemods/src/migrations/markdown-video-overrides/__testfixtures__/skip-flags.input.tsx b/packages/gamut-codemods/src/migrations/markdown-video-overrides/__testfixtures__/skip-flags.input.tsx
new file mode 100644
index 0000000000..161e37c53c
--- /dev/null
+++ b/packages/gamut-codemods/src/migrations/markdown-video-overrides/__testfixtures__/skip-flags.input.tsx
@@ -0,0 +1,5 @@
+import { Markdown } from '@codecademy/gamut';
+
+export const Off = <Markdown text={t} skipDefaultOverrides={{ iframe: true, video: true }} />;
+
+export const Partial = <Markdown text={t} skipDefaultOverrides={{ a: true, iframe: false }} />;
diff --git a/packages/gamut-codemods/src/migrations/markdown-video-overrides/__testfixtures__/skip-flags.output.tsx b/packages/gamut-codemods/src/migrations/markdown-video-overrides/__testfixtures__/skip-flags.output.tsx
new file mode 100644
index 0000000000..91f36e3a13
--- /dev/null
+++ b/packages/gamut-codemods/src/migrations/markdown-video-overrides/__testfixtures__/skip-flags.output.tsx
@@ -0,0 +1,16 @@
+import { Markdown } from '@codecademy/gamut';
+import { Iframe, MarkdownVideo } from '@codecademy/gamut/Video';
+
+export const Off = <Markdown text={t} iframeOverride={undefined} videoOverride={undefined} />;
+
+export const Partial = <Markdown
+  text={t}
+  skipDefaultOverrides={{
+    a: true
+  }}
+  iframeOverride={{
+    component: Iframe
+  }}
+  videoOverride={{
+    component: MarkdownVideo
+  }} />;
diff --git a/packages/gamut-codemods/src/migrations/markdown-video-overrides/__testfixtures__/unreadable.input.tsx b/packages/gamut-codemods/src/migrations/markdown-video-overrides/__testfixtures__/unreadable.input.tsx
new file mode 100644
index 0000000000..3f5c516c50
--- /dev/null
+++ b/packages/gamut-codemods/src/migrations/markdown-video-overrides/__testfixtures__/unreadable.input.tsx
@@ -0,0 +1,5 @@
+import { Markdown } from '@codecademy/gamut';
+
+export const Dynamic = <Markdown text={t} skipDefaultOverrides={options} />;
+
+export const Flagged = <Markdown text={t} skipDefaultOverrides={{ iframe: flag }} />;
diff --git a/packages/gamut-codemods/src/migrations/markdown-video-overrides/__testfixtures__/unreadable.output.tsx b/packages/gamut-codemods/src/migrations/markdown-video-overrides/__testfixtures__/unreadable.output.tsx
new file mode 100644
index 0000000000..0c31ca12d1
--- /dev/null
+++ b/packages/gamut-codemods/src/migrations/markdown-video-overrides/__testfixtures__/unreadable.output.tsx
@@ -0,0 +1,11 @@
+import { Markdown } from '@codecademy/gamut';
+import { MarkdownVideo } from '@codecademy/gamut/Video';
+
+export const Dynamic = <Markdown text={t} skipDefaultOverrides={options} />;
+
+export const Flagged = <Markdown
+  text={t}
+  skipDefaultOverrides={{ iframe: flag }}
+  videoOverride={{
+    component: MarkdownVideo
+  }} />;
diff --git a/packages/gamut-codemods/src/migrations/markdown-video-overrides/__testfixtures__/unreadable.warnings.json b/packages/gamut-codemods/src/migrations/markdown-video-overrides/__testfixtures__/unreadable.warnings.json
new file mode 100644
index 0000000000..677c75c3e5
--- /dev/null
+++ b/packages/gamut-codemods/src/migrations/markdown-video-overrides/__testfixtures__/unreadable.warnings.json
@@ -0,0 +1,4 @@
+[
+  "skipDefaultOverrides is not an object literal",
+  "skipDefaultOverrides.iframe is not a boolean literal"
+]
diff --git a/packages/gamut-codemods/src/migrations/markdown-video-overrides/index.ts b/packages/gamut-codemods/src/migrations/markdown-video-overrides/index.ts
new file mode 100644
index 0000000000..ec39e76ad3
--- /dev/null
+++ b/packages/gamut-codemods/src/migrations/markdown-video-overrides/index.ts
@@ -0,0 +1,288 @@
+import type { ASTPath, JSXAttribute, JSXOpeningElement } from 'jscodeshift';
+
+import { isAtLeast, minVersion } from '../../lib/manifest';
+import { nameOf } from '../../lib/module-strings';
+import { findPackageRanges } from '../../lib/package-ranges';
+import type { AstMigration, Warn } from '../../lib/types';
+
+/*
+  Markdown used to render <iframe> and <video> tags through Video by default.
+  Now they render as plain tags unless the override is passed. So each
+  <Markdown> that didn't opt out gets iframeOverride / videoOverride added,
+  with Iframe and MarkdownVideo imported from the Video subpath. That keeps
+  what it rendered before.
+
+  skipDefaultOverrides.iframe and .video were removed, so those keys go. A
+  skip of `true` turned the override off, so it becomes `iframeOverride={undefined}`.
+  That's the same as the new default, but written out. Without it a second
+  run would read the bare element as a legacy one and turn the override back
+  on, and the migration has to be safe to run twice.
+
+  Anything it can't follow (a skipDefaultOverrides that isn't an object
+  literal, or a non-literal iframe / video value) is left alone with a
+  warning.
+
+  Written against the old @codecademy names, like the rest of the presets:
+  scope-rename runs last and moves the Video import to @skillsoft.
+*/
+
+const MARKDOWN_MODULE = '@codecademy/gamut';
+/*
+  The upstream release that made this change. A repo already on it has
+  either passed the overrides or left them out on purpose, so adding them
+  would turn iframes and videos back on where they were meant to be off.
+*/
+const UPSTREAM_SINCE = '74.0.0';
+const VIDEO_MODULE = '@codecademy/gamut/Video';
+
+const OVERRIDES = [
+  { skip: 'iframe', prop: 'iframeOverride', component: 'Iframe' },
+  { skip: 'video', prop: 'videoOverride', component: 'MarkdownVideo' },
+] as const;
+
+type Override = (typeof OVERRIDES)[number];
+
+type Add = Override & { off: boolean };
+
+type Plan = { path: ASTPath<JSXOpeningElement>; adds: Add[] };
+
+/* Reads an object key as a string, whether it's `iframe` or `'iframe'`. */
+const keyOf = (key: { type: string; name?: string; value?: unknown }) =>
+  typeof key.value === 'string' ? key.value : nameOf(key);
+
+/* Reads a `true` / `false` literal, or undefined for anything else. */
+const boolOf = (value: { type: string; value?: unknown }) =>
+  typeof value.value === 'boolean' ? value.value : undefined;
+
+/*
+  Strips the skip keys this migration owns out of the skipDefaultOverrides
+  object. Returns what they were set to, and the keys it couldn't read.
+*/
+const readSkips = (
+  el: JSXOpeningElement,
+  skipAttr: JSXAttribute,
+  warn: Warn
+) => {
+  const skips = new Map<string, boolean>();
+  const unreadable = new Set<string>();
+  const value = skipAttr.value;
+
+  if (
+    value?.type !== 'JSXExpressionContainer' ||
+    value.expression.type !== 'ObjectExpression'
+  ) {
+    warn(
+      el,
+      'skipDefaultOverrides is not an object literal, so iframe and video were not checked. Add iframeOverride / videoOverride by hand.'
+    );
+    return { skips, unreadable: new Set(['iframe', 'video']), removed: false };
+  }
+
+  const object = value.expression;
+  const before = object.properties.length;
+  object.properties = object.properties.filter((prop) => {
+    if (prop.type !== 'ObjectProperty' && prop.type !== 'Property') return true;
+    const key = keyOf(prop.key as { type: string; name?: string });
+    if (key !== 'iframe' && key !== 'video') return true;
+
+    const literal = boolOf(prop.value as { type: string; value?: unknown });
+    if (literal === undefined) {
+      warn(
+        el,
+        `skipDefaultOverrides.${key} is not a boolean literal, so the ${key} override was not added. Check it by hand.`
+      );
+      unreadable.add(key);
+      return true;
+    }
+    skips.set(key, literal);
+    return false;
+  });
+
+  return {
+    skips,
+    unreadable,
+    removed: object.properties.length !== before,
+  };
+};
+
+export const markdownVideoOverrides: AstMigration = {
+  name: 'markdown-video-overrides',
+  kind: 'ast',
+  description:
+    'Pass iframeOverride / videoOverride to <Markdown> so iframes and videos still render through Video, and drop the removed skipDefaultOverrides.iframe / .video keys.',
+  skipReason(roots) {
+    /* `*` peers, URLs, and workspace: ranges say nothing about the version. */
+    const ranges = findPackageRanges(roots, MARKDOWN_MODULE).filter(
+      (range) => minVersion(range) !== null
+    );
+    return ranges.length > 0 &&
+      ranges.every((range) => isAtLeast(range, UPSTREAM_SINCE))
+      ? `${MARKDOWN_MODULE} is already at ${UPSTREAM_SINCE} or newer, which made this change upstream.`
+      : null;
+  },
+  run({ j, root, warn, note }) {
+    const markdownImports = root.find(j.ImportDeclaration, {
+      source: { value: MARKDOWN_MODULE },
+    });
+    const markdownLocals = new Set<string>();
+    markdownImports.forEach((p) => {
+      for (const spec of p.node.specifiers ?? []) {
+        if (
+          spec.type === 'ImportSpecifier' &&
+          nameOf(spec.imported) === 'Markdown'
+        ) {
+          markdownLocals.add(nameOf(spec.local ?? spec.imported));
+        }
+      }
+    });
+    if (markdownLocals.size === 0) return false;
+
+    const elements = root
+      .find(j.JSXOpeningElement)
+      .filter((p) => markdownLocals.has(nameOf(p.node.name)));
+    if (elements.size() === 0) return false;
+
+    /* Video imports the file already has, by exported name -> local name. */
+    const bound = new Map<string, string>();
+    root
+      .find(j.ImportDeclaration, { source: { value: VIDEO_MODULE } })
+      .forEach((p) => {
+        for (const spec of p.node.specifiers ?? []) {
+          if (spec.type !== 'ImportSpecifier') continue;
+          bound.set(nameOf(spec.imported), nameOf(spec.local ?? spec.imported));
+        }
+      });
+
+    /*
+      A different import already called Iframe or MarkdownVideo. Adding ours
+      would shadow it, so stop and leave the file for a hand rewrite.
+    */
+    const clash = root.find(j.ImportSpecifier).filter((p) => {
+      const local = nameOf(p.node.local ?? p.node.imported);
+      return OVERRIDES.some(
+        ({ component }) => local === component && bound.get(component) !== local
+      );
+    });
+    if (clash.size() > 0) {
+      warn(
+        clash.nodes()[0],
+        'a different import already uses the name Iframe or MarkdownVideo, so the <Markdown> overrides were not added. Rewrite them by hand.'
+      );
+      return false;
+    }
+
+    let changed = false;
+    const plans: Plan[] = [];
+    elements.forEach((path) => {
+      const el = path.node;
+      const attrs = el.attributes ?? [];
+      const skipAttr = attrs.find(
+        (a): a is JSXAttribute =>
+          a.type === 'JSXAttribute' && nameOf(a.name) === 'skipDefaultOverrides'
+      );
+
+      let skips = new Map<string, boolean>();
+      let unreadable = new Set<string>();
+      if (skipAttr) {
+        const read = readSkips(el, skipAttr, warn);
+        ({ skips, unreadable } = read);
+        if (read.removed) changed = true;
+
+        const value = skipAttr.value;
+        if (
+          value?.type === 'JSXExpressionContainer' &&
+          value.expression.type === 'ObjectExpression' &&
+          value.expression.properties.length === 0
+        ) {
+          el.attributes = attrs.filter((a) => a !== skipAttr);
+          changed = true;
+        }
+      }
+
+      const present = new Set(
+        (el.attributes ?? []).map((a) =>
+          a.type === 'JSXAttribute' ? nameOf(a.name) : ''
+        )
+      );
+      const adds = OVERRIDES.filter(
+        ({ skip, prop }) => !unreadable.has(skip) && !present.has(prop)
+      ).map((o) => ({ ...o, off: skips.get(o.skip) === true }));
+      if (adds.length > 0) plans.push({ path, adds });
+    });
+
+    if (plans.length > 0) {
+      const names = new Set(
+        plans.flatMap((p) =>
+          p.adds.filter((o) => !o.off).map((o) => o.component)
+        )
+      );
+      const local = new Map<string, string>();
+      const missing: string[] = [];
+      for (const name of names) {
+        if (bound.has(name)) local.set(name, bound.get(name) as string);
+        else {
+          local.set(name, name);
+          missing.push(name);
+        }
+      }
+
+      if (missing.length > 0) {
+        const specifiers = missing.map((name) =>
+          j.importSpecifier(j.identifier(name))
+        );
+        const existing = root
+          .find(j.ImportDeclaration, { source: { value: VIDEO_MODULE } })
+          .nodes()
+          .find(
+            (n) =>
+              (n.importKind ?? 'value') === 'value' &&
+              (n.specifiers ?? []).every((s) => s.type === 'ImportSpecifier')
+          );
+        if (existing) {
+          (existing.specifiers as unknown[]).push(...specifiers);
+        } else {
+          markdownImports
+            .paths()[0]
+            .insertAfter(
+              j.importDeclaration(specifiers, j.stringLiteral(VIDEO_MODULE))
+            );
+        }
+      }
+
+      for (const { path, adds } of plans) {
+        for (const { prop, component, off } of adds) {
+          const value = off
+            ? j.identifier('undefined')
+            : j.objectExpression([
+                j.property(
+                  'init',
+                  j.identifier('component'),
+                  j.identifier(local.get(component) as string)
+                ),
+              ]);
+          path.node.attributes = [
+            ...(path.node.attributes ?? []),
+            j.jsxAttribute(
+              j.jsxIdentifier(prop),
+              j.jsxExpressionContainer(value)
+            ),
+          ];
+        }
+      }
+      if (names.size > 0) note('video-peers');
+      changed = true;
+    }
+
+    return changed;
+  },
+  /*
+    Same recast gap as moved-exports: the blank line after the Markdown import
+    gets copied onto the new Video import. Close only that gap.
+  */
+  postPrint(source) {
+    return source.replace(
+      /(from '@codecademy\/gamut';?)\n\n(import [^\n]*from '@codecademy\/gamut\/Video';?)/g,
+      '$1\n$2'
+    );
+  },
+};
diff --git a/packages/gamut-codemods/src/migrations/mdx-imports/__testfixtures__/story.input.mdx b/packages/gamut-codemods/src/migrations/mdx-imports/__testfixtures__/story.input.mdx
new file mode 100644
index 0000000000..513edb7e2b
--- /dev/null
+++ b/packages/gamut-codemods/src/migrations/mdx-imports/__testfixtures__/story.input.mdx
@@ -0,0 +1,18 @@
+import { Canvas, Meta } from '@storybook/blocks';
+import { Box, Video } from '@codecademy/gamut';
+import {
+  PopoverContainerProps,
+} from '@codecademy/gamut/dist/PopoverContainer/types';
+import * as Stories from './Card.stories';
+
+<Meta of={Stories} />
+
+# Card
+
+Built on `@codecademy/gamut`'s Box.
+
+```tsx
+import { Card } from '@codecademy/gamut';
+```
+
+<Canvas of={Stories.Default} />
diff --git a/packages/gamut-codemods/src/migrations/mdx-imports/__testfixtures__/story.output.mdx b/packages/gamut-codemods/src/migrations/mdx-imports/__testfixtures__/story.output.mdx
new file mode 100644
index 0000000000..4acaac1535
--- /dev/null
+++ b/packages/gamut-codemods/src/migrations/mdx-imports/__testfixtures__/story.output.mdx
@@ -0,0 +1,19 @@
+import { Canvas, Meta } from '@storybook/blocks';
+import { Box } from '@skillsoft/gamut';
+import { Video } from '@skillsoft/gamut/Video';
+import {
+  PopoverContainerProps,
+} from '@skillsoft/gamut';
+import * as Stories from './Card.stories';
+
+<Meta of={Stories} />
+
+# Card
+
+Built on `@codecademy/gamut`'s Box.
+
+```tsx
+import { Card } from '@codecademy/gamut';
+```
+
+<Canvas of={Stories.Default} />
diff --git a/packages/gamut-codemods/src/migrations/mdx-imports/__testfixtures__/unterminated.input.mdx b/packages/gamut-codemods/src/migrations/mdx-imports/__testfixtures__/unterminated.input.mdx
new file mode 100644
index 0000000000..db0db1b105
--- /dev/null
+++ b/packages/gamut-codemods/src/migrations/mdx-imports/__testfixtures__/unterminated.input.mdx
@@ -0,0 +1,4 @@
+import {
+  Text,
+
+Some prose that never closes the import.
diff --git a/packages/gamut-codemods/src/migrations/mdx-imports/__testfixtures__/unterminated.output.mdx b/packages/gamut-codemods/src/migrations/mdx-imports/__testfixtures__/unterminated.output.mdx
new file mode 100644
index 0000000000..db0db1b105
--- /dev/null
+++ b/packages/gamut-codemods/src/migrations/mdx-imports/__testfixtures__/unterminated.output.mdx
@@ -0,0 +1,4 @@
+import {
+  Text,
+
+Some prose that never closes the import.
diff --git a/packages/gamut-codemods/src/migrations/mdx-imports/index.ts b/packages/gamut-codemods/src/migrations/mdx-imports/index.ts
new file mode 100644
index 0000000000..f98acf3d56
--- /dev/null
+++ b/packages/gamut-codemods/src/migrations/mdx-imports/index.ts
@@ -0,0 +1,63 @@
+import type { FileMigration } from '../../lib/types';
+
+/*
+  MDX files (Storybook docs, mostly) import from Gamut like any module, but
+  jscodeshift can't parse MDX. This pulls out the top-level ESM statements
+  (`import ... from '...'`, `export ... from '...'`) and runs each one
+  through the preset's source migrations, so stories get the same scope
+  rename, Video split, and deep-import rewrites as .tsx files.
+
+  Fenced code blocks are left alone. They're documentation, and a code
+  sample that still says @codecademy is the leftovers report's job.
+*/
+
+const FENCE = /^\s*(```|~~~)/;
+const STATEMENT_START = /^(import\s|export\s+(\*|\{|type\s+\{))/;
+const STATEMENT_END =
+  /(from\s*(['"])[^'"\n]*\2|^import\s*(['"])[^'"\n]*\3)\s*;?\s*$/;
+/* A statement that runs longer than this isn't one we understand. */
+const MAX_STATEMENT_LINES = 50;
+
+export const mdxImports: FileMigration = {
+  name: 'mdx-imports',
+  kind: 'file',
+  description:
+    'Run the source migrations over import/export statements in .mdx files.',
+  match: (file) => file.endsWith('.mdx'),
+  run({ source, transformSource }) {
+    const lines = source.split('\n');
+    const out: string[] = [];
+    let inFence = false;
+    let changed = false;
+
+    for (let i = 0; i < lines.length; i += 1) {
+      const line = lines[i];
+      if (FENCE.test(line)) inFence = !inFence;
+      if (inFence || !STATEMENT_START.test(line)) {
+        out.push(line);
+        continue;
+      }
+
+      let end = i;
+      while (
+        end < lines.length - 1 &&
+        end - i < MAX_STATEMENT_LINES &&
+        !STATEMENT_END.test(lines.slice(i, end + 1).join('\n'))
+      ) {
+        end += 1;
+      }
+      const statement = lines.slice(i, end + 1).join('\n');
+      if (!STATEMENT_END.test(statement)) {
+        out.push(line);
+        continue;
+      }
+
+      const next = transformSource(statement);
+      if (next !== statement) changed = true;
+      out.push(next);
+      i = end;
+    }
+
+    return changed ? out.join('\n') : null;
+  },
+};
diff --git a/packages/gamut-codemods/src/migrations/mf-shared/__testfixtures__/already-shared.input.ts b/packages/gamut-codemods/src/migrations/mf-shared/__testfixtures__/already-shared.input.ts
new file mode 100644
index 0000000000..04847f011a
--- /dev/null
+++ b/packages/gamut-codemods/src/migrations/mf-shared/__testfixtures__/already-shared.input.ts
@@ -0,0 +1,11 @@
+const shared = {
+  '@codecademy/gamut': { singleton: true, requiredVersion: '^73.0.0' },
+  '@codecademy/gamut-kit': { singleton: true },
+};
+export const config = { shared };
+export const inline = {
+  shared: {
+    '@codecademy/gamut-kit': { eager: true },
+    '@codecademy/gamut': { singleton: true },
+  },
+};
diff --git a/packages/gamut-codemods/src/migrations/mf-shared/__testfixtures__/already-shared.output.ts b/packages/gamut-codemods/src/migrations/mf-shared/__testfixtures__/already-shared.output.ts
new file mode 100644
index 0000000000..e3154ac7d5
--- /dev/null
+++ b/packages/gamut-codemods/src/migrations/mf-shared/__testfixtures__/already-shared.output.ts
@@ -0,0 +1,19 @@
+const shared = {
+  '@codecademy/gamut': { singleton: true, requiredVersion: '^73.0.0' },
+  '@codecademy/gamut-icons': { singleton: true },
+  '@codecademy/gamut-illustrations': { singleton: true },
+  '@codecademy/gamut-patterns': { singleton: true },
+  '@codecademy/gamut-styles': { singleton: true },
+  '@codecademy/variance': { singleton: true },
+};
+export const config = { shared };
+export const inline = {
+  shared: {
+    '@codecademy/gamut-icons': { eager: true },
+    '@codecademy/gamut-illustrations': { eager: true },
+    '@codecademy/gamut-patterns': { eager: true },
+    '@codecademy/gamut-styles': { eager: true },
+    '@codecademy/variance': { eager: true },
+    '@codecademy/gamut': { singleton: true },
+  },
+};
diff --git a/packages/gamut-codemods/src/migrations/mf-shared/__testfixtures__/computed-key.input.ts b/packages/gamut-codemods/src/migrations/mf-shared/__testfixtures__/computed-key.input.ts
new file mode 100644
index 0000000000..0d890b8874
--- /dev/null
+++ b/packages/gamut-codemods/src/migrations/mf-shared/__testfixtures__/computed-key.input.ts
@@ -0,0 +1,5 @@
+const key = '@codecademy/gamut';
+export const shared = {
+  [key]: { singleton: true },
+  123: { singleton: true },
+};
diff --git a/packages/gamut-codemods/src/migrations/mf-shared/__testfixtures__/computed-key.output.ts b/packages/gamut-codemods/src/migrations/mf-shared/__testfixtures__/computed-key.output.ts
new file mode 100644
index 0000000000..0d890b8874
--- /dev/null
+++ b/packages/gamut-codemods/src/migrations/mf-shared/__testfixtures__/computed-key.output.ts
@@ -0,0 +1,5 @@
+const key = '@codecademy/gamut';
+export const shared = {
+  [key]: { singleton: true },
+  123: { singleton: true },
+};
diff --git a/packages/gamut-codemods/src/migrations/mf-shared/__testfixtures__/kit.input.ts b/packages/gamut-codemods/src/migrations/mf-shared/__testfixtures__/kit.input.ts
new file mode 100644
index 0000000000..caf4b09e6d
--- /dev/null
+++ b/packages/gamut-codemods/src/migrations/mf-shared/__testfixtures__/kit.input.ts
@@ -0,0 +1,11 @@
+export default {
+  plugins: [
+    new ModuleFederationPlugin({
+      shared: {
+        react: { singleton: true },
+        '@codecademy/gamut-kit': { singleton: true },
+        '@emotion/react': { singleton: true },
+      },
+    }),
+  ],
+};
diff --git a/packages/gamut-codemods/src/migrations/mf-shared/__testfixtures__/kit.output.ts b/packages/gamut-codemods/src/migrations/mf-shared/__testfixtures__/kit.output.ts
new file mode 100644
index 0000000000..4c70a53c17
--- /dev/null
+++ b/packages/gamut-codemods/src/migrations/mf-shared/__testfixtures__/kit.output.ts
@@ -0,0 +1,16 @@
+export default {
+  plugins: [
+    new ModuleFederationPlugin({
+      shared: {
+        react: { singleton: true },
+        '@codecademy/gamut': { singleton: true },
+        '@codecademy/gamut-icons': { singleton: true },
+        '@codecademy/gamut-illustrations': { singleton: true },
+        '@codecademy/gamut-patterns': { singleton: true },
+        '@codecademy/gamut-styles': { singleton: true },
+        '@codecademy/variance': { singleton: true },
+        '@emotion/react': { singleton: true },
+      },
+    }),
+  ],
+};
diff --git a/packages/gamut-codemods/src/migrations/mf-shared/__testfixtures__/kit.warnings.json b/packages/gamut-codemods/src/migrations/mf-shared/__testfixtures__/kit.warnings.json
new file mode 100644
index 0000000000..cc4b2bc076
--- /dev/null
+++ b/packages/gamut-codemods/src/migrations/mf-shared/__testfixtures__/kit.warnings.json
@@ -0,0 +1 @@
+["replaced '@codecademy/gamut-kit' in Module Federation shared config"]
diff --git a/packages/gamut-codemods/src/migrations/mf-shared/index.ts b/packages/gamut-codemods/src/migrations/mf-shared/index.ts
new file mode 100644
index 0000000000..9d3e677821
--- /dev/null
+++ b/packages/gamut-codemods/src/migrations/mf-shared/index.ts
@@ -0,0 +1,112 @@
+import { isStringLiteral } from '../../lib/module-strings';
+import type { Edit, SpliceMigration } from '../../lib/types';
+
+/*
+  Module Federation `shared` config that names a removed package:
+
+    shared: { '@codecademy/gamut-kit': { singleton: true } }
+  becomes
+    shared: {
+      '@codecademy/gamut': { singleton: true },
+      '@codecademy/gamut-styles': { singleton: true },
+      ...
+    }
+
+  Handles `const shared = { ... }` the same way.
+
+  MF matches shared entries by import name, and code imports the individual
+  packages, not the kit. So the old entry never deduped anything, and after
+  this Gamut really is a singleton across host and remotes. That's a runtime
+  change, hence the warning and checklist item. scope-rename runs after this
+  and swaps the scope on the new keys.
+*/
+
+const keyName = (key: any): string | null => {
+  if (!key) return null;
+  if (key.type === 'Identifier') return key.name;
+  if (isStringLiteral(key)) return key.value;
+  return null;
+};
+
+/*
+  The object in `shared: { ... }` (inline plugin options) or
+  `const shared = { ... }` (declared, then passed in).
+*/
+const sharedObject = (node: any) => {
+  if (
+    (node.type === 'ObjectProperty' || node.type === 'Property') &&
+    keyName(node.key) === 'shared' &&
+    node.value?.type === 'ObjectExpression'
+  ) {
+    return node.value;
+  }
+  if (
+    node.type === 'VariableDeclarator' &&
+    keyName(node.id) === 'shared' &&
+    node.init?.type === 'ObjectExpression'
+  ) {
+    return node.init;
+  }
+  return null;
+};
+
+export const mfShared: SpliceMigration = {
+  name: 'mf-shared',
+  kind: 'splice',
+  description:
+    'Replace removed packages in Module Federation `shared` config with the packages they bundled.',
+  edits({ j, root, source, manifest, warn, note }) {
+    const edits: Edit[] = [];
+
+    root
+      .find(j.Node)
+      .filter((p) => sharedObject(p.node) !== null)
+      .forEach((p) => {
+        const shared = sharedObject(p.node);
+        const existing = new Set(
+          shared.properties.map((prop: any) => keyName(prop.key))
+        );
+
+        for (const prop of shared.properties) {
+          const removed = manifest.removedPackages[keyName(prop.key) ?? ''];
+          if (!removed) continue;
+
+          const lineStart = source.lastIndexOf('\n', prop.start) + 1;
+          const before = source.slice(lineStart, prop.start);
+          /* One entry per line if the old one had its own line, else inline. */
+          const ownLine = /^\s*$/.test(before);
+          const separator = ownLine ? `,\n${before}` : ', ';
+          const value = source.slice(prop.value.start, prop.value.end);
+          const additions = removed.mfSharedAs.filter(
+            (pkg) => !existing.has(pkg)
+          );
+          const text = additions
+            .map((pkg) => `'${pkg}': ${value}`)
+            .join(separator);
+
+          /* Nothing to add: drop the entry and the comma that follows it. */
+          const end =
+            text || source[prop.end] !== ','
+              ? prop.end
+              : prop.end +
+                1 +
+                (source.slice(prop.end + 1).match(/^\s*/)?.[0].length ?? 0);
+          edits.push({
+            start: text || !ownLine ? prop.start : lineStart,
+            end,
+            text,
+          });
+
+          warn(
+            prop,
+            `replaced '${keyName(
+              prop.key
+            )}' in Module Federation shared config. Gamut is now actually shared as a singleton; test the host and remotes together.`
+          );
+          note('mf-shared');
+        }
+      });
+
+    return edits;
+  },
+};
diff --git a/packages/gamut-codemods/src/migrations/moved-exports/__testfixtures__/merge-existing.input.tsx b/packages/gamut-codemods/src/migrations/moved-exports/__testfixtures__/merge-existing.input.tsx
new file mode 100644
index 0000000000..811c580c56
--- /dev/null
+++ b/packages/gamut-codemods/src/migrations/moved-exports/__testfixtures__/merge-existing.input.tsx
@@ -0,0 +1,5 @@
+import { Text, Video } from '@codecademy/gamut';
+import { VideoProps } from '@codecademy/gamut/Video';
+
+export const x: VideoProps = { videoUrl: '' };
+export const y = [Text, Video];
diff --git a/packages/gamut-codemods/src/migrations/moved-exports/__testfixtures__/merge-existing.output.tsx b/packages/gamut-codemods/src/migrations/moved-exports/__testfixtures__/merge-existing.output.tsx
new file mode 100644
index 0000000000..2342b88e7d
--- /dev/null
+++ b/packages/gamut-codemods/src/migrations/moved-exports/__testfixtures__/merge-existing.output.tsx
@@ -0,0 +1,5 @@
+import { Text } from '@codecademy/gamut';
+import { VideoProps, Video } from '@codecademy/gamut/Video';
+
+export const x: VideoProps = { videoUrl: '' };
+export const y = [Text, Video];
diff --git a/packages/gamut-codemods/src/migrations/moved-exports/__testfixtures__/mixed-import.input.tsx b/packages/gamut-codemods/src/migrations/moved-exports/__testfixtures__/mixed-import.input.tsx
new file mode 100644
index 0000000000..98db12ff86
--- /dev/null
+++ b/packages/gamut-codemods/src/migrations/moved-exports/__testfixtures__/mixed-import.input.tsx
@@ -0,0 +1,7 @@
+import { Box, Video, type VideoProps } from '@codecademy/gamut';
+
+export const Player = (props: VideoProps) => (
+  <Box>
+    <Video {...props} />
+  </Box>
+);
diff --git a/packages/gamut-codemods/src/migrations/moved-exports/__testfixtures__/mixed-import.output.tsx b/packages/gamut-codemods/src/migrations/moved-exports/__testfixtures__/mixed-import.output.tsx
new file mode 100644
index 0000000000..a2058bdebb
--- /dev/null
+++ b/packages/gamut-codemods/src/migrations/moved-exports/__testfixtures__/mixed-import.output.tsx
@@ -0,0 +1,8 @@
+import { Box } from '@codecademy/gamut';
+import { Video, type VideoProps } from '@codecademy/gamut/Video';
+
+export const Player = (props: VideoProps) => (
+  <Box>
+    <Video {...props} />
+  </Box>
+);
diff --git a/packages/gamut-codemods/src/migrations/moved-exports/__testfixtures__/namespace.input.tsx b/packages/gamut-codemods/src/migrations/moved-exports/__testfixtures__/namespace.input.tsx
new file mode 100644
index 0000000000..e30f43e305
--- /dev/null
+++ b/packages/gamut-codemods/src/migrations/moved-exports/__testfixtures__/namespace.input.tsx
@@ -0,0 +1,4 @@
+import * as Gamut from '@codecademy/gamut';
+
+export const Player = Gamut.Video;
+export type Props = Gamut.VideoProps;
diff --git a/packages/gamut-codemods/src/migrations/moved-exports/__testfixtures__/namespace.output.tsx b/packages/gamut-codemods/src/migrations/moved-exports/__testfixtures__/namespace.output.tsx
new file mode 100644
index 0000000000..e30f43e305
--- /dev/null
+++ b/packages/gamut-codemods/src/migrations/moved-exports/__testfixtures__/namespace.output.tsx
@@ -0,0 +1,4 @@
+import * as Gamut from '@codecademy/gamut';
+
+export const Player = Gamut.Video;
+export type Props = Gamut.VideoProps;
diff --git a/packages/gamut-codemods/src/migrations/moved-exports/__testfixtures__/namespace.warnings.json b/packages/gamut-codemods/src/migrations/moved-exports/__testfixtures__/namespace.warnings.json
new file mode 100644
index 0000000000..82426731c6
--- /dev/null
+++ b/packages/gamut-codemods/src/migrations/moved-exports/__testfixtures__/namespace.warnings.json
@@ -0,0 +1,3 @@
+[
+  "namespace import uses Video/VideoProps, which moved to '@codecademy/gamut/Video'"
+]
diff --git a/packages/gamut-codemods/src/migrations/moved-exports/__testfixtures__/re-export.input.ts b/packages/gamut-codemods/src/migrations/moved-exports/__testfixtures__/re-export.input.ts
new file mode 100644
index 0000000000..d12c1f8c44
--- /dev/null
+++ b/packages/gamut-codemods/src/migrations/moved-exports/__testfixtures__/re-export.input.ts
@@ -0,0 +1 @@
+export { Box, Video } from '@codecademy/gamut';
diff --git a/packages/gamut-codemods/src/migrations/moved-exports/__testfixtures__/re-export.output.ts b/packages/gamut-codemods/src/migrations/moved-exports/__testfixtures__/re-export.output.ts
new file mode 100644
index 0000000000..efcc9aafd3
--- /dev/null
+++ b/packages/gamut-codemods/src/migrations/moved-exports/__testfixtures__/re-export.output.ts
@@ -0,0 +1,2 @@
+export { Box } from '@codecademy/gamut';
+export { Video } from '@codecademy/gamut/Video';
diff --git a/packages/gamut-codemods/src/migrations/moved-exports/__testfixtures__/unsafe-shapes.input.tsx b/packages/gamut-codemods/src/migrations/moved-exports/__testfixtures__/unsafe-shapes.input.tsx
new file mode 100644
index 0000000000..1d2a688be7
--- /dev/null
+++ b/packages/gamut-codemods/src/migrations/moved-exports/__testfixtures__/unsafe-shapes.input.tsx
@@ -0,0 +1,10 @@
+import * as Gamut from '@codecademy/gamut';
+
+export * from '@codecademy/gamut';
+
+jest.mock('@codecademy/gamut', () => ({
+  ...jest.requireActual('@codecademy/gamut'),
+  Video: () => null,
+}));
+
+export const V = Gamut.Video;
diff --git a/packages/gamut-codemods/src/migrations/moved-exports/__testfixtures__/unsafe-shapes.output.tsx b/packages/gamut-codemods/src/migrations/moved-exports/__testfixtures__/unsafe-shapes.output.tsx
new file mode 100644
index 0000000000..1d2a688be7
--- /dev/null
+++ b/packages/gamut-codemods/src/migrations/moved-exports/__testfixtures__/unsafe-shapes.output.tsx
@@ -0,0 +1,10 @@
+import * as Gamut from '@codecademy/gamut';
+
+export * from '@codecademy/gamut';
+
+jest.mock('@codecademy/gamut', () => ({
+  ...jest.requireActual('@codecademy/gamut'),
+  Video: () => null,
+}));
+
+export const V = Gamut.Video;
diff --git a/packages/gamut-codemods/src/migrations/moved-exports/__testfixtures__/unsafe-shapes.warnings.json b/packages/gamut-codemods/src/migrations/moved-exports/__testfixtures__/unsafe-shapes.warnings.json
new file mode 100644
index 0000000000..ba02d37ffd
--- /dev/null
+++ b/packages/gamut-codemods/src/migrations/moved-exports/__testfixtures__/unsafe-shapes.warnings.json
@@ -0,0 +1 @@
+["namespace import uses Video", "'export *' from '@codecademy/gamut'", "mock of '@codecademy/gamut' stubs Video"]
diff --git a/packages/gamut-codemods/src/migrations/moved-exports/__testfixtures__/video-only.input.tsx b/packages/gamut-codemods/src/migrations/moved-exports/__testfixtures__/video-only.input.tsx
new file mode 100644
index 0000000000..690bc76dad
--- /dev/null
+++ b/packages/gamut-codemods/src/migrations/moved-exports/__testfixtures__/video-only.input.tsx
@@ -0,0 +1,6 @@
+// the player
+import { Video } from '@codecademy/gamut';
+import type { VideoProps } from '@codecademy/gamut';
+
+export type P = VideoProps;
+export const V = Video;
diff --git a/packages/gamut-codemods/src/migrations/moved-exports/__testfixtures__/video-only.output.tsx b/packages/gamut-codemods/src/migrations/moved-exports/__testfixtures__/video-only.output.tsx
new file mode 100644
index 0000000000..968c84aef1
--- /dev/null
+++ b/packages/gamut-codemods/src/migrations/moved-exports/__testfixtures__/video-only.output.tsx
@@ -0,0 +1,6 @@
+// the player
+import { Video } from '@codecademy/gamut/Video';
+import type { VideoProps } from '@codecademy/gamut/Video';
+
+export type P = VideoProps;
+export const V = Video;
diff --git a/packages/gamut-codemods/src/migrations/moved-exports/index.ts b/packages/gamut-codemods/src/migrations/moved-exports/index.ts
new file mode 100644
index 0000000000..3837375b5d
--- /dev/null
+++ b/packages/gamut-codemods/src/migrations/moved-exports/index.ts
@@ -0,0 +1,249 @@
+import type {
+  ASTPath,
+  Collection,
+  ExportNamedDeclaration,
+  ExportSpecifier,
+  ImportDeclaration,
+  ImportSpecifier,
+  JSCodeshift,
+} from 'jscodeshift';
+
+import type { Manifest, MovedExport } from '../../lib/manifest';
+import { nameOf } from '../../lib/module-strings';
+import type { AstMigration, Warn } from '../../lib/types';
+
+/*
+  Moves named exports that left a package root onto their new subpath, per
+  manifest.movedExports. For scope-swap that's Video and VideoProps:
+
+    import { Box, Video } from '@codecademy/gamut';
+  becomes
+    import { Box } from '@codecademy/gamut';
+    import { Video } from '@codecademy/gamut/Video';
+
+  Shapes it can't rewrite safely (namespace imports, `export *`, mock
+  factories) get a warning instead.
+*/
+
+type Declaration = ImportDeclaration | ExportNamedDeclaration;
+type NamedSpecifier = ImportSpecifier | ExportSpecifier;
+
+const isNamed = (spec: { type: string }): spec is NamedSpecifier =>
+  spec.type === 'ImportSpecifier' || spec.type === 'ExportSpecifier';
+
+const specName = (spec: NamedSpecifier) =>
+  nameOf(spec.type === 'ImportSpecifier' ? spec.imported : spec.local);
+
+const kindOf = (node: Declaration) =>
+  (node as { importKind?: string; exportKind?: string }).importKind ??
+  (node as { exportKind?: string }).exportKind ??
+  'value';
+
+/*
+  Fresh copies, not the original nodes. Reparenting nodes that still carry
+  their source location trips recast's patcher when the file has other edits.
+*/
+const cloneSpecifier = (j: JSCodeshift, spec: NamedSpecifier) => {
+  if (spec.type === 'ExportSpecifier') {
+    return j.exportSpecifier.from({
+      local: j.identifier(nameOf(spec.local)),
+      exported: j.identifier(nameOf(spec.exported ?? spec.local)),
+    });
+  }
+  const copy = j.importSpecifier(
+    j.identifier(nameOf(spec.imported)),
+    j.identifier(nameOf(spec.local ?? spec.imported))
+  );
+  Object.assign(copy, {
+    importKind: (spec as { importKind?: string }).importKind,
+  });
+  return copy;
+};
+
+/* An existing all-named declaration of the same kind we can merge into. */
+const findTarget = (
+  j: JSCodeshift,
+  root: Collection,
+  node: Declaration,
+  to: string,
+  kind: string
+): Declaration | undefined => {
+  const matches = (candidate: Declaration) =>
+    kindOf(candidate) === kind &&
+    (candidate.specifiers ?? []).every((s) => isNamed(s));
+  return node.type === 'ImportDeclaration'
+    ? root
+        .find(j.ImportDeclaration, { source: { value: to } })
+        .nodes()
+        .find(matches)
+    : root
+        .find(j.ExportNamedDeclaration, { source: { value: to } })
+        .nodes()
+        .find(matches);
+};
+
+const moveSpecifiers = (
+  j: JSCodeshift,
+  root: Collection,
+  path: ASTPath<Declaration>,
+  rule: MovedExport
+) => {
+  const { node } = path;
+  const names = new Set(rule.names);
+  const specifiers = (node.specifiers ?? []) as { type: string }[];
+  const matched = specifiers.filter(
+    (s): s is NamedSpecifier => isNamed(s) && names.has(specName(s))
+  );
+  if (matched.length === 0) return false;
+
+  const moving = matched.map((s) => cloneSpecifier(j, s));
+  const staying = specifiers.filter(
+    (s) => !matched.includes(s as NamedSpecifier)
+  );
+  const kind = kindOf(node);
+  const existing = findTarget(j, root, node, rule.to, kind);
+
+  if (existing) {
+    (existing.specifiers as unknown[]).push(...moving);
+    if (staying.length === 0) path.prune();
+    else node.specifiers = staying as typeof node.specifiers;
+    return true;
+  }
+
+  if (staying.length === 0) {
+    /* Whole declaration moves. Keep the node so its comments stay put. */
+    node.source = j.stringLiteral(rule.to);
+    return true;
+  }
+
+  const created =
+    node.type === 'ImportDeclaration'
+      ? j.importDeclaration(
+          moving as ImportSpecifier[],
+          j.stringLiteral(rule.to)
+        )
+      : j.exportNamedDeclaration(
+          null,
+          moving as ExportSpecifier[],
+          j.stringLiteral(rule.to)
+        );
+  Object.assign(
+    created,
+    node.type === 'ImportDeclaration'
+      ? { importKind: kind }
+      : { exportKind: kind }
+  );
+  node.specifiers = staying as typeof node.specifiers;
+  path.replace(node, created);
+  return true;
+};
+
+const warnAboutUnsafeShapes = (
+  j: JSCodeshift,
+  root: Collection,
+  rule: MovedExport,
+  warn: Warn
+) => {
+  const list = rule.names.join('/');
+
+  root
+    .find(j.ImportDeclaration, { source: { value: rule.from } })
+    .forEach((p) => {
+      for (const spec of p.node.specifiers ?? []) {
+        if (spec.type !== 'ImportNamespaceSpecifier') continue;
+        const ns = nameOf(spec.local);
+        const member = root
+          .find(j.MemberExpression, { object: { name: ns } })
+          .filter((m) => rule.names.includes(nameOf(m.node.property)));
+        const qualified = root
+          .find(j.TSQualifiedName, { left: { name: ns } })
+          .filter((q) => rule.names.includes(nameOf(q.node.right)));
+        if (member.size() + qualified.size() > 0) {
+          warn(
+            p.node,
+            `namespace import uses ${list}, which moved to '${rule.to}'. Rewrite by hand.`
+          );
+        }
+      }
+    });
+
+  root
+    .find(j.ExportAllDeclaration, { source: { value: rule.from } })
+    .forEach((p) => {
+      warn(
+        p.node,
+        `'export *' from '${rule.from}' no longer re-exports ${list}. Add an export from '${rule.to}' if you need them.`
+      );
+    });
+
+  root
+    .find(j.CallExpression, { arguments: [{ value: rule.from }] })
+    .filter((p) => p.node.arguments.length > 1)
+    .forEach((p) => {
+      const mentions = j(p.get('arguments', 1))
+        .find(j.Identifier)
+        .filter((id) => rule.names.includes(id.node.name));
+      if (mentions.size() > 0) {
+        warn(
+          p.node,
+          `mock of '${rule.from}' stubs ${list}. Mock '${rule.to}' instead.`
+        );
+      }
+    });
+};
+
+const escape = (s: string) => s.replace(/[.*+?^${}()|[\]\\/]/g, '\\$&');
+
+/* An old specifier and its renamed form, since scope-rename may have run. */
+const bothScopes = (manifest: Manifest, spec: string) => {
+  const pkg = Object.keys(manifest.packages).find(
+    (p) => spec === p || spec.startsWith(`${p}/`)
+  );
+  return pkg
+    ? [spec, manifest.packages[pkg].to + spec.slice(pkg.length)]
+    : [spec];
+};
+
+export const movedExports: AstMigration = {
+  name: 'moved-exports',
+  kind: 'ast',
+  description:
+    'Move exports that left a package root (e.g. Video) to their new subpath.',
+  run({ j, root, manifest, warn, note }) {
+    let changed = false;
+    for (const rule of manifest.movedExports) {
+      const paths = [
+        ...root
+          .find(j.ImportDeclaration, { source: { value: rule.from } })
+          .paths(),
+        ...root
+          .find(j.ExportNamedDeclaration, { source: { value: rule.from } })
+          .paths(),
+      ] as ASTPath<Declaration>[];
+      let moved = false;
+      for (const p of paths) {
+        moved = moveSpecifiers(j, root, p, rule) || moved;
+      }
+      if (moved && rule.checklist) note(rule.checklist);
+      changed = moved || changed;
+      warnAboutUnsafeShapes(j, root, rule, warn);
+    }
+    return changed;
+  },
+  /*
+    recast copies the gap that followed the original declaration onto the
+    new one, so a split can leave a blank line between the two halves.
+    Close exactly that gap and nothing else.
+  */
+  postPrint(source, { manifest }) {
+    return manifest.movedExports.reduce((out, rule) => {
+      const from = bothScopes(manifest, rule.from).map(escape).join('|');
+      const to = bothScopes(manifest, rule.to).map(escape).join('|');
+      const split = new RegExp(
+        `(from '(?:${from})';?)\\n\\n((?:import|export)[^\\n]*from '(?:${to})';?)`,
+        'g'
+      );
+      return out.replace(split, '$1\n$2');
+    }, source);
+  },
+};
diff --git a/packages/gamut-codemods/src/migrations/next-config/__testfixtures__/esm-externals-default.input.js b/packages/gamut-codemods/src/migrations/next-config/__testfixtures__/esm-externals-default.input.js
new file mode 100644
index 0000000000..fda7e8b92c
--- /dev/null
+++ b/packages/gamut-codemods/src/migrations/next-config/__testfixtures__/esm-externals-default.input.js
@@ -0,0 +1,3 @@
+module.exports = {
+  transpilePackages: ['@codecademy/gamut'],
+};
diff --git a/packages/gamut-codemods/src/migrations/next-config/__testfixtures__/esm-externals-default.output.js b/packages/gamut-codemods/src/migrations/next-config/__testfixtures__/esm-externals-default.output.js
new file mode 100644
index 0000000000..fda7e8b92c
--- /dev/null
+++ b/packages/gamut-codemods/src/migrations/next-config/__testfixtures__/esm-externals-default.output.js
@@ -0,0 +1,3 @@
+module.exports = {
+  transpilePackages: ['@codecademy/gamut'],
+};
diff --git a/packages/gamut-codemods/src/migrations/next-config/__testfixtures__/esm-externals-off.input.js b/packages/gamut-codemods/src/migrations/next-config/__testfixtures__/esm-externals-off.input.js
new file mode 100644
index 0000000000..4ba07898f4
--- /dev/null
+++ b/packages/gamut-codemods/src/migrations/next-config/__testfixtures__/esm-externals-off.input.js
@@ -0,0 +1,6 @@
+module.exports = {
+  experimental: {
+    esmExternals: false,
+  },
+  transpilePackages: ['@codecademy/gamut'],
+};
diff --git a/packages/gamut-codemods/src/migrations/next-config/__testfixtures__/esm-externals-off.output.js b/packages/gamut-codemods/src/migrations/next-config/__testfixtures__/esm-externals-off.output.js
new file mode 100644
index 0000000000..4ba07898f4
--- /dev/null
+++ b/packages/gamut-codemods/src/migrations/next-config/__testfixtures__/esm-externals-off.output.js
@@ -0,0 +1,6 @@
+module.exports = {
+  experimental: {
+    esmExternals: false,
+  },
+  transpilePackages: ['@codecademy/gamut'],
+};
diff --git a/packages/gamut-codemods/src/migrations/next-config/__testfixtures__/esm-externals-off.warnings.json b/packages/gamut-codemods/src/migrations/next-config/__testfixtures__/esm-externals-off.warnings.json
new file mode 100644
index 0000000000..7b74c689b9
--- /dev/null
+++ b/packages/gamut-codemods/src/migrations/next-config/__testfixtures__/esm-externals-off.warnings.json
@@ -0,0 +1 @@
+["`experimental.esmExternals: false`"]
diff --git a/packages/gamut-codemods/src/migrations/next-config/index.ts b/packages/gamut-codemods/src/migrations/next-config/index.ts
new file mode 100644
index 0000000000..3c88ca56d3
--- /dev/null
+++ b/packages/gamut-codemods/src/migrations/next-config/index.ts
@@ -0,0 +1,31 @@
+import type { FileMigration } from '../../lib/types';
+
+/*
+  Report-only. @skillsoft/gamut ships strict-ESM `.mjs`. With
+  `experimental.esmExternals: false`, Next require()s every server
+  external, and webpack gives a default import from `.mjs` the whole
+  CommonJS module object, `__esModule` or not. `styled('div')` from
+  @emotion/styled then throws "is not a function" while Next collects page
+  data, and react-select defaults render as "Element type is invalid".
+  Dropping the flag can take other config with it (aliases that worked
+  around the same thing), so this warns rather than rewriting.
+*/
+
+const ESM_EXTERNALS_OFF = /\besmExternals\s*:\s*false\b/;
+
+export const nextConfig: FileMigration = {
+  name: 'next-config',
+  kind: 'file',
+  description:
+    "Warn about `esmExternals: false` in next.config, which breaks default imports from gamut's .mjs files.",
+  match: (file) => /(^|\/)next\.config\.[cm]?[jt]s$/.test(file),
+  run({ source, warn, note }) {
+    if (ESM_EXTERNALS_OFF.test(source)) {
+      warn(
+        '`experimental.esmExternals: false` makes Next require() server externals, so default imports in gamut\'s .mjs files get a module object and pages fail with "is not a function". Remove it.'
+      );
+      note('next-esm-externals');
+    }
+    return null;
+  },
+};
diff --git a/packages/gamut-codemods/src/migrations/package-json/__testfixtures__/already-renamed.input.json b/packages/gamut-codemods/src/migrations/package-json/__testfixtures__/already-renamed.input.json
new file mode 100644
index 0000000000..a332e52190
--- /dev/null
+++ b/packages/gamut-codemods/src/migrations/package-json/__testfixtures__/already-renamed.input.json
@@ -0,0 +1,9 @@
+{
+  "name": "app",
+  "dependencies": {
+    "@codecademy/gamut-kit": "3.0.25",
+    "@skillsoft/gamut": "https://pkg.pr.new/@skillsoft/gamut@28",
+    "@skillsoft/gamut-icons": "https://pkg.pr.new/@skillsoft/gamut-icons@28",
+    "@codecademy/gamut-styles": "21.2.0"
+  }
+}
diff --git a/packages/gamut-codemods/src/migrations/package-json/__testfixtures__/already-renamed.output.json b/packages/gamut-codemods/src/migrations/package-json/__testfixtures__/already-renamed.output.json
new file mode 100644
index 0000000000..e51edd4454
--- /dev/null
+++ b/packages/gamut-codemods/src/migrations/package-json/__testfixtures__/already-renamed.output.json
@@ -0,0 +1,12 @@
+{
+  "name": "app",
+  "dependencies": {
+    "@skillsoft/gamut": "https://pkg.pr.new/@skillsoft/gamut@28",
+    "@skillsoft/gamut-icons": "https://pkg.pr.new/@skillsoft/gamut-icons@28",
+    "@skillsoft/gamut-illustrations": "^{{version}}",
+    "@skillsoft/gamut-patterns": "^{{version}}",
+    "@skillsoft/gamut-styles": "^{{version}}",
+    "@skillsoft/gamut-tests": "^{{version}}",
+    "@skillsoft/variance": "^{{version}}"
+  }
+}
diff --git a/packages/gamut-codemods/src/migrations/package-json/__testfixtures__/kit.input.json b/packages/gamut-codemods/src/migrations/package-json/__testfixtures__/kit.input.json
new file mode 100644
index 0000000000..1ad0d5bf74
--- /dev/null
+++ b/packages/gamut-codemods/src/migrations/package-json/__testfixtures__/kit.input.json
@@ -0,0 +1,11 @@
+{
+  "name": "app",
+  "dependencies": {
+    "@codecademy/gamut": "73.6.1",
+    "@codecademy/gamut-kit": "3.0.24",
+    "react": "^19.0.0"
+  },
+  "devDependencies": {
+    "eslint-plugin-gamut": "3.1.0"
+  }
+}
diff --git a/packages/gamut-codemods/src/migrations/package-json/__testfixtures__/kit.output.json b/packages/gamut-codemods/src/migrations/package-json/__testfixtures__/kit.output.json
new file mode 100644
index 0000000000..779450d73c
--- /dev/null
+++ b/packages/gamut-codemods/src/migrations/package-json/__testfixtures__/kit.output.json
@@ -0,0 +1,16 @@
+{
+  "name": "app",
+  "dependencies": {
+    "@skillsoft/gamut": "^{{version}}",
+    "@skillsoft/gamut-icons": "^{{version}}",
+    "@skillsoft/gamut-illustrations": "^{{version}}",
+    "@skillsoft/gamut-patterns": "^{{version}}",
+    "@skillsoft/gamut-styles": "^{{version}}",
+    "@skillsoft/gamut-tests": "^{{version}}",
+    "@skillsoft/variance": "^{{version}}",
+    "react": "^19.0.0"
+  },
+  "devDependencies": {
+    "@skillsoft/eslint-plugin-gamut": "^0.0.1"
+  }
+}
diff --git a/packages/gamut-codemods/src/migrations/package-json/__testfixtures__/kit.warnings.json b/packages/gamut-codemods/src/migrations/package-json/__testfixtures__/kit.warnings.json
new file mode 100644
index 0000000000..47a5eebf34
--- /dev/null
+++ b/packages/gamut-codemods/src/migrations/package-json/__testfixtures__/kit.warnings.json
@@ -0,0 +1 @@
+["replaced '@codecademy/gamut-kit'"]
diff --git a/packages/gamut-codemods/src/migrations/package-json/__testfixtures__/newer-than-source.input.json b/packages/gamut-codemods/src/migrations/package-json/__testfixtures__/newer-than-source.input.json
new file mode 100644
index 0000000000..23e11d6c43
--- /dev/null
+++ b/packages/gamut-codemods/src/migrations/package-json/__testfixtures__/newer-than-source.input.json
@@ -0,0 +1,7 @@
+{
+  "name": "app",
+  "dependencies": {
+    "@codecademy/gamut": "74.0.0",
+    "@codecademy/gamut-styles": "^21.2.0"
+  }
+}
diff --git a/packages/gamut-codemods/src/migrations/package-json/__testfixtures__/newer-than-source.output.json b/packages/gamut-codemods/src/migrations/package-json/__testfixtures__/newer-than-source.output.json
new file mode 100644
index 0000000000..780d3a617b
--- /dev/null
+++ b/packages/gamut-codemods/src/migrations/package-json/__testfixtures__/newer-than-source.output.json
@@ -0,0 +1,7 @@
+{
+  "name": "app",
+  "dependencies": {
+    "@skillsoft/gamut": "^{{version}}",
+    "@skillsoft/gamut-styles": "^{{version}}"
+  }
+}
diff --git a/packages/gamut-codemods/src/migrations/package-json/__testfixtures__/newer-than-source.warnings.json b/packages/gamut-codemods/src/migrations/package-json/__testfixtures__/newer-than-source.warnings.json
new file mode 100644
index 0000000000..9fe9ebdcc7
--- /dev/null
+++ b/packages/gamut-codemods/src/migrations/package-json/__testfixtures__/newer-than-source.warnings.json
@@ -0,0 +1 @@
+["'@codecademy/gamut@74.0.0' is newer than 73.6.1"]
diff --git a/packages/gamut-codemods/src/migrations/package-json/__testfixtures__/peers.input.json b/packages/gamut-codemods/src/migrations/package-json/__testfixtures__/peers.input.json
new file mode 100644
index 0000000000..27dbc10c94
--- /dev/null
+++ b/packages/gamut-codemods/src/migrations/package-json/__testfixtures__/peers.input.json
@@ -0,0 +1,7 @@
+{
+  "name": "lib",
+  "peerDependencies": {
+    "@codecademy/gamut": "*",
+    "@codecademy/gamut-styles": "^21.0.0"
+  }
+}
diff --git a/packages/gamut-codemods/src/migrations/package-json/__testfixtures__/peers.output.json b/packages/gamut-codemods/src/migrations/package-json/__testfixtures__/peers.output.json
new file mode 100644
index 0000000000..e4ecfdfaf1
--- /dev/null
+++ b/packages/gamut-codemods/src/migrations/package-json/__testfixtures__/peers.output.json
@@ -0,0 +1,7 @@
+{
+  "name": "lib",
+  "peerDependencies": {
+    "@skillsoft/gamut": "*",
+    "@skillsoft/gamut-styles": "^{{version}}"
+  }
+}
diff --git a/packages/gamut-codemods/src/migrations/package-json/index.ts b/packages/gamut-codemods/src/migrations/package-json/index.ts
new file mode 100644
index 0000000000..24c14cb656
--- /dev/null
+++ b/packages/gamut-codemods/src/migrations/package-json/index.ts
@@ -0,0 +1,95 @@
+import { isNewerThan } from '../../lib/manifest';
+import type { FileMigration } from '../../lib/types';
+
+/*
+  Renames dependencies in package.json and pins them to
+  manifest.targetVersions. Removed packages are replaced by the packages
+  they bundled. Only touched fields are re-sorted; indentation and the
+  trailing newline are kept.
+
+  A new package that's already listed keeps its value. People add the new
+  names by hand before running this, often pointed at a preview tarball,
+  and overwriting that with a range that isn't published yet breaks
+  install. A `*` peer range stays `*`: it means "whatever the host has",
+  and narrowing it is a decision for the package owner.
+
+  A range newer than manifest.sourceVersions gets a warning: the code may
+  already use APIs that only exist upstream, which no rename can fix.
+*/
+
+const FIELDS = [
+  'dependencies',
+  'devDependencies',
+  'peerDependencies',
+  'optionalDependencies',
+] as const;
+
+const sortKeys = (obj: Record<string, string>) =>
+  Object.fromEntries(
+    Object.entries(obj).sort(([a], [b]) => a.localeCompare(b))
+  );
+
+const detectIndent = (text: string) =>
+  (text.match(/^[ \t]+(?=")/m) ?? ['  '])[0];
+
+export const packageJson: FileMigration = {
+  name: 'package-json',
+  kind: 'file',
+  description: 'Rename dependencies in package.json.',
+  match: (file) => /(^|\/)package\.json$/.test(file),
+  run({ source, manifest, warn, note }) {
+    const pkg = JSON.parse(source) as Record<string, unknown>;
+    let changed = false;
+
+    for (const field of FIELDS) {
+      const deps = pkg[field] as Record<string, string> | undefined;
+      if (!deps) continue;
+      const next = { ...deps };
+      let touched = false;
+
+      for (const [removed, { expandTo, note: why }] of Object.entries(
+        manifest.removedPackages
+      )) {
+        if (!(removed in next)) continue;
+        delete next[removed];
+        for (const old of expandTo) {
+          const renamed = manifest.packages[old]?.to;
+          if (!(old in next) && !(renamed && renamed in next)) next[old] = '*';
+        }
+        warn(
+          `${field}: replaced '${removed}' with its individual packages. ${why}`
+        );
+        note(`removed:${removed}`);
+        touched = true;
+      }
+
+      for (const [from, { to }] of Object.entries(manifest.packages)) {
+        if (!(from in next)) continue;
+        const range = next[from];
+        const covered = manifest.sourceVersions[from];
+        if (covered && isNewerThan(range, covered)) {
+          warn(
+            `${field}: '${from}@${range}' is newer than ${covered}, the last release ${to} matches. Code written against the newer release may not type-check until ${to} catches up.`
+          );
+          note('newer-than-source');
+        }
+        delete next[from];
+        touched = true;
+        if (to in next) continue;
+        next[to] =
+          field === 'peerDependencies' && range === '*'
+            ? '*'
+            : manifest.targetVersions[to];
+      }
+
+      if (touched) {
+        pkg[field] = sortKeys(next);
+        changed = true;
+      }
+    }
+
+    if (!changed) return null;
+    const trailing = source.endsWith('\n') ? '\n' : '';
+    return JSON.stringify(pkg, null, detectIndent(source)) + trailing;
+  },
+};
diff --git a/packages/gamut-codemods/src/migrations/scope-rename/__testfixtures__/comments.input.tsx b/packages/gamut-codemods/src/migrations/scope-rename/__testfixtures__/comments.input.tsx
new file mode 100644
index 0000000000..bc44b7f3c0
--- /dev/null
+++ b/packages/gamut-codemods/src/migrations/scope-rename/__testfixtures__/comments.input.tsx
@@ -0,0 +1,12 @@
+/**
+ * @deprecated
+ * @see `Disclosure` and `List` from `@codecademy/gamut`
+ * @example
+ * import { FillButton } from '@codecademy/gamut';
+ * import { theme } from '@codecademy/gamut-styles';
+ */
+export const Old = () => null;
+
+// Built on @codecademy/gamut-kit and @codecademy/gamut/dist/Box/props, see eslint-plugin-gamut.
+// Already moved: @skillsoft/gamut and @skillsoft/eslint-plugin-gamut.
+export const el = <div>{/* from @codecademy/variance */}</div>;
diff --git a/packages/gamut-codemods/src/migrations/scope-rename/__testfixtures__/comments.output.tsx b/packages/gamut-codemods/src/migrations/scope-rename/__testfixtures__/comments.output.tsx
new file mode 100644
index 0000000000..d1f4e01a73
--- /dev/null
+++ b/packages/gamut-codemods/src/migrations/scope-rename/__testfixtures__/comments.output.tsx
@@ -0,0 +1,12 @@
+/**
+ * @deprecated
+ * @see `Disclosure` and `List` from `@skillsoft/gamut`
+ * @example
+ * import { FillButton } from '@skillsoft/gamut';
+ * import { theme } from '@skillsoft/gamut-styles';
+ */
+export const Old = () => null;
+
+// Built on @codecademy/gamut-kit and @codecademy/gamut/dist/Box/props, see @skillsoft/eslint-plugin-gamut.
+// Already moved: @skillsoft/gamut and @skillsoft/eslint-plugin-gamut.
+export const el = <div>{/* from @skillsoft/variance */}</div>;
diff --git a/packages/gamut-codemods/src/migrations/scope-rename/__testfixtures__/everywhere.input.tsx b/packages/gamut-codemods/src/migrations/scope-rename/__testfixtures__/everywhere.input.tsx
new file mode 100644
index 0000000000..db77a7d96b
--- /dev/null
+++ b/packages/gamut-codemods/src/migrations/scope-rename/__testfixtures__/everywhere.input.tsx
@@ -0,0 +1,20 @@
+import { Box } from '@codecademy/gamut';
+import { theme } from '@codecademy/gamut-styles';
+import { Video } from '@codecademy/gamut/Video';
+import { setupRtl } from '@codecademy/gamut-tests';
+import type { CoreTheme } from '@codecademy/gamut-styles';
+import { Kit } from '@codecademy/gamut-kit';
+import { Other } from '@codecademy/gamut-extra-thing';
+
+export * from '@codecademy/gamut-icons';
+
+declare module '@codecademy/gamut-styles' {
+  interface Theme extends CoreTheme {}
+}
+
+jest.mock('@codecademy/variance');
+const lazy = () => import('@codecademy/gamut-patterns');
+const req = require('@codecademy/gamut-illustrations');
+type T = import('@codecademy/gamut').BoxProps;
+
+export const transpilePackages = ['@codecademy/gamut'];
diff --git a/packages/gamut-codemods/src/migrations/scope-rename/__testfixtures__/everywhere.output.tsx b/packages/gamut-codemods/src/migrations/scope-rename/__testfixtures__/everywhere.output.tsx
new file mode 100644
index 0000000000..dca4d84c5d
--- /dev/null
+++ b/packages/gamut-codemods/src/migrations/scope-rename/__testfixtures__/everywhere.output.tsx
@@ -0,0 +1,20 @@
+import { Box } from '@skillsoft/gamut';
+import { theme } from '@skillsoft/gamut-styles';
+import { Video } from '@skillsoft/gamut/Video';
+import { setupRtl } from '@skillsoft/gamut-tests';
+import type { CoreTheme } from '@skillsoft/gamut-styles';
+import { Kit } from '@codecademy/gamut-kit';
+import { Other } from '@codecademy/gamut-extra-thing';
+
+export * from '@skillsoft/gamut-icons';
+
+declare module '@skillsoft/gamut-styles' {
+  interface Theme extends CoreTheme {}
+}
+
+jest.mock('@skillsoft/variance');
+const lazy = () => import('@skillsoft/gamut-patterns');
+const req = require('@skillsoft/gamut-illustrations');
+type T = import('@skillsoft/gamut').BoxProps;
+
+export const transpilePackages = ['@skillsoft/gamut'];
diff --git a/packages/gamut-codemods/src/migrations/scope-rename/__testfixtures__/everywhere.warnings.json b/packages/gamut-codemods/src/migrations/scope-rename/__testfixtures__/everywhere.warnings.json
new file mode 100644
index 0000000000..158b86d60b
--- /dev/null
+++ b/packages/gamut-codemods/src/migrations/scope-rename/__testfixtures__/everywhere.warnings.json
@@ -0,0 +1 @@
+["'@codecademy/gamut-kit' has no replacement package", "renamed 1 package-name string(s) outside imports (@codecademy/gamut)"]
diff --git a/packages/gamut-codemods/src/migrations/scope-rename/__testfixtures__/no-semicolons.input.tsx b/packages/gamut-codemods/src/migrations/scope-rename/__testfixtures__/no-semicolons.input.tsx
new file mode 100644
index 0000000000..5570545ab3
--- /dev/null
+++ b/packages/gamut-codemods/src/migrations/scope-rename/__testfixtures__/no-semicolons.input.tsx
@@ -0,0 +1,13 @@
+import { Box } from '@codecademy/gamut'
+
+jest.mock('./Card', () => {
+  return ({ title, description }: any) => (
+    <div>
+      {title} - {description}
+    </div>
+  )
+})
+
+jest.mock("@codecademy/gamut-icons", () => ({
+  AiEditSparkIcon: () => <div>AI Icon</div>,
+}))
diff --git a/packages/gamut-codemods/src/migrations/scope-rename/__testfixtures__/no-semicolons.output.tsx b/packages/gamut-codemods/src/migrations/scope-rename/__testfixtures__/no-semicolons.output.tsx
new file mode 100644
index 0000000000..fac3c38590
--- /dev/null
+++ b/packages/gamut-codemods/src/migrations/scope-rename/__testfixtures__/no-semicolons.output.tsx
@@ -0,0 +1,13 @@
+import { Box } from '@skillsoft/gamut'
+
+jest.mock('./Card', () => {
+  return ({ title, description }: any) => (
+    <div>
+      {title} - {description}
+    </div>
+  )
+})
+
+jest.mock("@skillsoft/gamut-icons", () => ({
+  AiEditSparkIcon: () => <div>AI Icon</div>,
+}))
diff --git a/packages/gamut-codemods/src/migrations/scope-rename/__testfixtures__/require-forms.input.ts b/packages/gamut-codemods/src/migrations/scope-rename/__testfixtures__/require-forms.input.ts
new file mode 100644
index 0000000000..e3383b9181
--- /dev/null
+++ b/packages/gamut-codemods/src/migrations/scope-rename/__testfixtures__/require-forms.input.ts
@@ -0,0 +1,3 @@
+import gamut = require('@codecademy/gamut');
+export const resolved = require.resolve('@codecademy/gamut/Video');
+export { gamut };
diff --git a/packages/gamut-codemods/src/migrations/scope-rename/__testfixtures__/require-forms.output.ts b/packages/gamut-codemods/src/migrations/scope-rename/__testfixtures__/require-forms.output.ts
new file mode 100644
index 0000000000..885aecb532
--- /dev/null
+++ b/packages/gamut-codemods/src/migrations/scope-rename/__testfixtures__/require-forms.output.ts
@@ -0,0 +1,3 @@
+import gamut = require('@skillsoft/gamut');
+export const resolved = require.resolve('@skillsoft/gamut/Video');
+export { gamut };
diff --git a/packages/gamut-codemods/src/migrations/scope-rename/index.ts b/packages/gamut-codemods/src/migrations/scope-rename/index.ts
new file mode 100644
index 0000000000..0c29583d10
--- /dev/null
+++ b/packages/gamut-codemods/src/migrations/scope-rename/index.ts
@@ -0,0 +1,109 @@
+import { removedPackageFor, renameSpecifier } from '../../lib/manifest';
+import type { StringNode } from '../../lib/module-strings';
+import { findModuleStrings, isStringLiteral } from '../../lib/module-strings';
+import type { Edit, SpliceMigration } from '../../lib/types';
+
+/*
+  Swaps old package names for new ones in every module position: imports,
+  exports, require, mocks, `declare module`, import types. Runs last, since
+  every other migration is written against the old names.
+
+  Any other string that exactly names an old package (Next's
+  transpilePackages, Module Federation shared keys, lint ignore lists) is
+  rewritten too. Across mono, platform, front, and talent-intelligence every
+  one of those was a correct rename, so they get one warning per file
+  asking for a look at the diff, not one per string.
+
+  This is a splice migration: it edits the text inside the quotes and never
+  asks recast to print. Mutating even one literal's value made recast
+  reprint neighbouring statements in semicolon-less files, including JSX
+  text whitespace.
+
+  Package names in comments (JSDoc `@see`, usage examples) are renamed as
+  well. `/dist` paths and removed packages are left for the leftovers
+  report, since there's no name that's right for them.
+*/
+
+interface CommentNode {
+  value: string;
+  start: number;
+  end: number;
+}
+
+const escape = (s: string) => s.replace(/[.*+?^${}()|[\]\\/]/g, '\\$&');
+
+/* Old names, not part of a longer name and not followed by `/dist`. */
+const commentPattern = (from: string[]) =>
+  new RegExp(
+    `(?<![\\w@/-])(?:${from
+      .sort((a, b) => b.length - a.length)
+      .map(escape)
+      .join('|')})(?![\\w-])(?!/dist(?![\\w-]))`,
+    'g'
+  );
+
+export const scopeRename: SpliceMigration = {
+  name: 'scope-rename',
+  kind: 'splice',
+  description: 'Swap old package specifiers for their new names.',
+  edits({ j, root, manifest, warn }) {
+    const edits: Edit[] = [];
+    const moduleStrings = new Set(findModuleStrings(j, root));
+    const outsideImports: string[] = [];
+
+    const visit = (literal: StringNode, inModulePosition: boolean) => {
+      const removed = removedPackageFor(manifest, literal.value);
+      if (removed) {
+        warn(
+          literal,
+          `'${removed}' has no replacement package. ${manifest.removedPackages[removed].note}`
+        );
+        return;
+      }
+      const next = renameSpecifier(manifest, literal.value);
+      if (!next) return;
+      if (!inModulePosition) outsideImports.push(literal.value);
+      /* Inside the quotes only, so the file's quote style survives. */
+      edits.push({
+        start: literal.start + 1,
+        end: literal.end - 1,
+        text: next,
+      });
+    };
+
+    for (const literal of moduleStrings) visit(literal, true);
+
+    root
+      .find(j.Node)
+      .filter((p) => isStringLiteral(p.node) && !moduleStrings.has(p.node))
+      .forEach((p) => visit(p.node as StringNode, false));
+
+    const pattern = commentPattern(Object.keys(manifest.packages));
+    const seen = new Set<number>();
+    /* j.Comment paths point at the owning node, so walk node.comments. */
+    root.find(j.Node).forEach((p) => {
+      const comments = (p.node as { comments?: CommentNode[] }).comments ?? [];
+      for (const comment of comments) {
+        if (seen.has(comment.start)) continue;
+        seen.add(comment.start);
+        for (const match of comment.value.matchAll(pattern)) {
+          const next = manifest.packages[match[0]]?.to;
+          if (!next) continue;
+          /* +2 skips the `//` or `/*` that `value` leaves out. */
+          const start = comment.start + 2 + (match.index ?? 0);
+          edits.push({ start, end: start + match[0].length, text: next });
+        }
+      }
+    });
+
+    if (outsideImports.length > 0) {
+      const names = [...new Set(outsideImports)].join(', ');
+      warn(
+        null,
+        `renamed ${outsideImports.length} package-name string(s) outside imports (${names}). Check the diff.`
+      );
+    }
+
+    return edits;
+  },
+};
diff --git a/packages/gamut-codemods/src/migrations/tsconfig-dom/__testfixtures__/has-dom.input.json b/packages/gamut-codemods/src/migrations/tsconfig-dom/__testfixtures__/has-dom.input.json
new file mode 100644
index 0000000000..38cca72cc6
--- /dev/null
+++ b/packages/gamut-codemods/src/migrations/tsconfig-dom/__testfixtures__/has-dom.input.json
@@ -0,0 +1 @@
+{ "compilerOptions": { "lib": ["es2022", "DOM", "dom.iterable"] } }
diff --git a/packages/gamut-codemods/src/migrations/tsconfig-dom/__testfixtures__/has-dom.output.json b/packages/gamut-codemods/src/migrations/tsconfig-dom/__testfixtures__/has-dom.output.json
new file mode 100644
index 0000000000..38cca72cc6
--- /dev/null
+++ b/packages/gamut-codemods/src/migrations/tsconfig-dom/__testfixtures__/has-dom.output.json
@@ -0,0 +1 @@
+{ "compilerOptions": { "lib": ["es2022", "DOM", "dom.iterable"] } }
diff --git a/packages/gamut-codemods/src/migrations/tsconfig-dom/__testfixtures__/no-dom.input.json b/packages/gamut-codemods/src/migrations/tsconfig-dom/__testfixtures__/no-dom.input.json
new file mode 100644
index 0000000000..3a90a0ce69
--- /dev/null
+++ b/packages/gamut-codemods/src/migrations/tsconfig-dom/__testfixtures__/no-dom.input.json
@@ -0,0 +1,4 @@
+{
+  // server code
+  "compilerOptions": { "lib": ["es2022"] }
+}
diff --git a/packages/gamut-codemods/src/migrations/tsconfig-dom/__testfixtures__/no-dom.output.json b/packages/gamut-codemods/src/migrations/tsconfig-dom/__testfixtures__/no-dom.output.json
new file mode 100644
index 0000000000..3a90a0ce69
--- /dev/null
+++ b/packages/gamut-codemods/src/migrations/tsconfig-dom/__testfixtures__/no-dom.output.json
@@ -0,0 +1,4 @@
+{
+  // server code
+  "compilerOptions": { "lib": ["es2022"] }
+}
diff --git a/packages/gamut-codemods/src/migrations/tsconfig-dom/__testfixtures__/no-dom.warnings.json b/packages/gamut-codemods/src/migrations/tsconfig-dom/__testfixtures__/no-dom.warnings.json
new file mode 100644
index 0000000000..f83a4ee348
--- /dev/null
+++ b/packages/gamut-codemods/src/migrations/tsconfig-dom/__testfixtures__/no-dom.warnings.json
@@ -0,0 +1 @@
+["\"lib\" has no \"dom\""]
diff --git a/packages/gamut-codemods/src/migrations/tsconfig-dom/index.ts b/packages/gamut-codemods/src/migrations/tsconfig-dom/index.ts
new file mode 100644
index 0000000000..86e7f69b7d
--- /dev/null
+++ b/packages/gamut-codemods/src/migrations/tsconfig-dom/index.ts
@@ -0,0 +1,30 @@
+import type { FileMigration } from '../../lib/types';
+
+/*
+  Report-only. Before scope-swap, the gamut root re-exported Video, which
+  pulled @vidstack/react's DOM types into every program that imported
+  gamut. A tsconfig with an explicit `lib` and no "dom" got DOM globals
+  anyway. Once Video moves to its subpath they're gone, and `document`,
+  `HTMLInputElement`, `ResizeObserver` and friends stop type-checking.
+  Adding "dom" is the owner's call, so this warns rather than rewriting.
+*/
+
+const LIB = /"lib"\s*:\s*\[([^\]]*)\]/;
+
+export const tsconfigDom: FileMigration = {
+  name: 'tsconfig-dom',
+  kind: 'file',
+  description:
+    'Warn about tsconfig `lib` settings without "dom", which Video used to supply.',
+  match: (file) => /(^|\/)tsconfig[\w.-]*\.json$/.test(file),
+  run({ source, warn, note }) {
+    const lib = LIB.exec(source);
+    if (lib && !/["']dom["']/i.test(lib[1])) {
+      warn(
+        `"lib" has no "dom". Gamut's root import used to bring DOM types in through Video; add "dom" if type-checking now fails on document, HTMLElement, and so on.`
+      );
+      note('tsconfig-no-dom');
+    }
+    return null;
+  },
+};
diff --git a/packages/gamut-codemods/src/migrations/yarnrc/__testfixtures__/no-glob.input.yml b/packages/gamut-codemods/src/migrations/yarnrc/__testfixtures__/no-glob.input.yml
new file mode 100644
index 0000000000..6452a33ad1
--- /dev/null
+++ b/packages/gamut-codemods/src/migrations/yarnrc/__testfixtures__/no-glob.input.yml
@@ -0,0 +1,2 @@
+npmPreapprovedPackages:
+  - eslint-plugin-gamut # lint rules
diff --git a/packages/gamut-codemods/src/migrations/yarnrc/__testfixtures__/no-glob.output.yml b/packages/gamut-codemods/src/migrations/yarnrc/__testfixtures__/no-glob.output.yml
new file mode 100644
index 0000000000..7a6d8c80bf
--- /dev/null
+++ b/packages/gamut-codemods/src/migrations/yarnrc/__testfixtures__/no-glob.output.yml
@@ -0,0 +1,2 @@
+npmPreapprovedPackages:
+  - '@skillsoft/eslint-plugin-gamut' # lint rules
diff --git a/packages/gamut-codemods/src/migrations/yarnrc/__testfixtures__/preapproved.input.yml b/packages/gamut-codemods/src/migrations/yarnrc/__testfixtures__/preapproved.input.yml
new file mode 100644
index 0000000000..8c251e0841
--- /dev/null
+++ b/packages/gamut-codemods/src/migrations/yarnrc/__testfixtures__/preapproved.input.yml
@@ -0,0 +1,10 @@
+npmPreapprovedPackages:
+  - '@skillsoft/*'
+  - 'eslint-plugin-gamut'
+  - "@codecademy/gamut-kit"
+  - react
+
+packageExtensions:
+  '@codecademy/gamut@*':
+    peerDependencies:
+      react: '*'
diff --git a/packages/gamut-codemods/src/migrations/yarnrc/__testfixtures__/preapproved.output.yml b/packages/gamut-codemods/src/migrations/yarnrc/__testfixtures__/preapproved.output.yml
new file mode 100644
index 0000000000..0d09a98e03
--- /dev/null
+++ b/packages/gamut-codemods/src/migrations/yarnrc/__testfixtures__/preapproved.output.yml
@@ -0,0 +1,9 @@
+npmPreapprovedPackages:
+  - '@skillsoft/*'
+  - "@codecademy/gamut-kit"
+  - react
+
+packageExtensions:
+  '@codecademy/gamut@*':
+    peerDependencies:
+      react: '*'
diff --git a/packages/gamut-codemods/src/migrations/yarnrc/index.ts b/packages/gamut-codemods/src/migrations/yarnrc/index.ts
new file mode 100644
index 0000000000..34074ee969
--- /dev/null
+++ b/packages/gamut-codemods/src/migrations/yarnrc/index.ts
@@ -0,0 +1,45 @@
+import { renameSpecifier } from '../../lib/manifest';
+import type { FileMigration } from '../../lib/types';
+
+/*
+  Package names listed in .yarnrc.yml, like npmPreapprovedPackages:
+
+    npmPreapprovedPackages:
+      - '@skillsoft/*'
+      - 'eslint-plugin-gamut'
+
+  An old name is renamed, or dropped if a scope glob in the same file
+  (`'@skillsoft/*'`) already covers the new one. Only exact list items are
+  touched; anything more involved shows up in the leftovers report.
+*/
+
+const LIST_ITEM = /^(\s*-\s*)(['"]?)([^'"\s#]+)\2(\s*(#.*)?)$/;
+
+export const yarnrc: FileMigration = {
+  name: 'yarnrc',
+  kind: 'file',
+  description: 'Rename or drop old package names in .yarnrc.yml lists.',
+  match: (file) => /(^|\/)\.yarnrc\.yml$/.test(file),
+  run({ source, manifest }) {
+    const lines = source.split('\n');
+    const globs = lines
+      .map((line) => LIST_ITEM.exec(line)?.[3])
+      .filter((value): value is string => !!value?.endsWith('/*'))
+      .map((glob) => glob.slice(0, -1));
+
+    let changed = false;
+    const out = lines.flatMap((line) => {
+      const match = LIST_ITEM.exec(line);
+      const next = match && renameSpecifier(manifest, match[3]);
+      if (!match || !next) return [line];
+      changed = true;
+      if (globs.some((prefix) => next.startsWith(prefix))) return [];
+      const [, lead, quote, , trail] = match;
+      /* `@` is reserved in YAML, so a plain scalar can't start with it. */
+      const q = quote || (next.startsWith('@') ? "'" : '');
+      return [`${lead}${q}${next}${q}${trail}`];
+    });
+
+    return changed ? out.join('\n') : null;
+  },
+};
diff --git a/packages/gamut-codemods/src/presets/index.ts b/packages/gamut-codemods/src/presets/index.ts
new file mode 100644
index 0000000000..2ff0c9294a
--- /dev/null
+++ b/packages/gamut-codemods/src/presets/index.ts
@@ -0,0 +1,43 @@
+import type { Preset } from '../lib/types';
+import { scopeSwap } from './scope-swap';
+
+/*
+  Every preset the CLI can run. A preset is one upgrade: its own manifest,
+  an ordered list of migrations, and the checklist to print afterwards.
+  Later presets are named for the release they target and can reuse
+  migrations from src/migrations with a different manifest.
+*/
+export const presets: Record<string, Preset> = {
+  [scopeSwap.name]: scopeSwap,
+};
+
+/*
+  AST migrations print through recast once, then splice migrations edit that
+  output by offset. Interleaving them would need a print and re-parse per
+  switch, so presets have to list every `ast` migration before any
+  `splice` one.
+*/
+export const validatePreset = (preset: Preset) => {
+  const source = preset.migrations.filter((m) => m.kind !== 'file');
+  const firstSplice = source.findIndex((m) => m.kind === 'splice');
+  const lateAst =
+    firstSplice === -1
+      ? undefined
+      : source.slice(firstSplice).find((m) => m.kind === 'ast');
+  if (lateAst) {
+    throw new Error(
+      `preset '${preset.name}': ast migration '${lateAst.name}' is listed after a splice migration. List every ast migration first.`
+    );
+  }
+  return preset;
+};
+
+export const getPreset = (name: string) => {
+  const preset = presets[name];
+  if (!preset) {
+    throw new Error(
+      `unknown preset '${name}'. Available: ${Object.keys(presets).join(', ')}`
+    );
+  }
+  return validatePreset(preset);
+};
diff --git a/packages/gamut-codemods/src/presets/scope-swap/index.ts b/packages/gamut-codemods/src/presets/scope-swap/index.ts
new file mode 100644
index 0000000000..c14083348b
--- /dev/null
+++ b/packages/gamut-codemods/src/presets/scope-swap/index.ts
@@ -0,0 +1,56 @@
+import type { Preset } from '../../lib/types';
+import { deepImports } from '../../migrations/deep-imports';
+import { eslintComments } from '../../migrations/eslint-comments';
+import { eslintConfig } from '../../migrations/eslint-config';
+import { mdxImports } from '../../migrations/mdx-imports';
+import { mfShared } from '../../migrations/mf-shared';
+import { markdownVideoOverrides } from '../../migrations/markdown-video-overrides';
+import { movedExports } from '../../migrations/moved-exports';
+import { nextConfig } from '../../migrations/next-config';
+import { packageJson } from '../../migrations/package-json';
+import { scopeRename } from '../../migrations/scope-rename';
+import { tsconfigDom } from '../../migrations/tsconfig-dom';
+import { yarnrc } from '../../migrations/yarnrc';
+import { manifest } from './manifest';
+
+export const scopeSwap: Preset = {
+  name: 'scope-swap',
+  description: 'Move from @codecademy/gamut* to @skillsoft/gamut*.',
+  manifest,
+  migrations: [
+    deepImports,
+    movedExports,
+    markdownVideoOverrides,
+    mfShared,
+    eslintComments,
+    /* Last: everything above matches on @codecademy names. */
+    scopeRename,
+    packageJson,
+    eslintConfig,
+    mdxImports,
+    yarnrc,
+    tsconfigDom,
+    nextConfig,
+  ],
+  checklist: [
+    'Run your formatter and lint autofix (prettier --write, then eslint --fix). Split imports come out in recast style, `@skillsoft` sorts differently from `@codecademy` for import-order rules like simple-import-sort, and the shorter scope lets some wrapped imports fit on one line.',
+    'Reinstall (yarn), then type-check and run your tests.',
+    'Work through the warnings above and the leftovers list.',
+  ],
+  conditionalChecklist: {
+    'removed:@codecademy/gamut-kit':
+      "gamut-kit is gone. Delete anything that reads it for versions, such as a sync-gamut-deps script. @skillsoft/gamut-styles has @emotion/cache and stylis peer dependencies, so add them if yarn warns that they aren't provided.",
+    'video-peers':
+      'Video needs two peer dependencies that Gamut no longer installs for you: `@vidstack/react` and `react-player`. Gamut supports @vidstack/react 1.12.x only (its npm `latest` tag is 0.6.x). Install them: `yarn add @vidstack/react@~1.12.12 react-player@^3.4.0`.',
+    'tsconfig-no-dom':
+      'Some tsconfig files set "lib" without "dom" (see the tsconfig-dom warnings). Video no longer loads with the root import, and it was supplying the DOM types. Add "dom" to those files if type-checking fails on document, HTMLElement, ResizeObserver, and so on.',
+    'newer-than-source':
+      'Some @codecademy packages were on a newer release than @skillsoft has caught up to (see the package-json warnings). Expect type errors wherever the code uses what that release added, and check the upstream CHANGELOG for it.',
+    'skipped:eslint-comments':
+      "ESLint directive comments were left as is because the repo uses a flat config, where the rule prefix is the key the plugin is registered under (for example `plugins: { gamut }`). Keep that key, or rename it and every 'gamut/' rule and directive together.",
+    'next-esm-externals':
+      'Some next.config files set `experimental.esmExternals: false` (see the next-config warnings). Remove it, and any @emotion/* resolve.alias or transpilePackages entries that were working around default-import interop, then rebuild: the failure only shows up when Next collects page data.',
+    'mf-shared':
+      "Module Federation shared config changed. Gamut is now a real singleton: run the host and every remote together, and update the remotes' shared config to match.",
+  },
+};
diff --git a/packages/gamut-codemods/src/presets/scope-swap/manifest.ts b/packages/gamut-codemods/src/presets/scope-swap/manifest.ts
new file mode 100644
index 0000000000..c32ba819db
--- /dev/null
+++ b/packages/gamut-codemods/src/presets/scope-swap/manifest.ts
@@ -0,0 +1,204 @@
+import fs from 'node:fs';
+import path from 'node:path';
+
+import type { Manifest } from '../../lib/manifest';
+
+/*
+  What changed between @codecademy/gamut* and @skillsoft/gamut*. Every entry
+  uses the OLD (@codecademy) names; scope-rename runs last and swaps the
+  scope, so no other migration needs to know the new one.
+
+  manifest.test.ts type-checks every export this file points at against the
+  built packages, so a row can't reference an export that doesn't exist.
+*/
+
+/*
+  This package is in the changesets `fixed` group with the packages it
+  migrates to, so its own version is theirs.
+*/
+const { version } = JSON.parse(
+  fs.readFileSync(path.join(__dirname, '../../../package.json'), 'utf8')
+) as { version: string };
+
+const GROUP_RANGE = `^${version}`;
+
+export const manifest: Manifest = {
+  packages: {
+    '@codecademy/gamut': { to: '@skillsoft/gamut' },
+    '@codecademy/gamut-styles': { to: '@skillsoft/gamut-styles' },
+    '@codecademy/gamut-icons': { to: '@skillsoft/gamut-icons' },
+    '@codecademy/gamut-illustrations': { to: '@skillsoft/gamut-illustrations' },
+    '@codecademy/gamut-patterns': { to: '@skillsoft/gamut-patterns' },
+    '@codecademy/gamut-tests': { to: '@skillsoft/gamut-tests' },
+    '@codecademy/variance': { to: '@skillsoft/variance' },
+    'eslint-plugin-gamut': { to: '@skillsoft/eslint-plugin-gamut' },
+  },
+
+  removedPackages: {
+    '@codecademy/gamut-kit': {
+      expandTo: [
+        '@codecademy/gamut',
+        '@codecademy/gamut-icons',
+        '@codecademy/gamut-illustrations',
+        '@codecademy/gamut-patterns',
+        '@codecademy/gamut-styles',
+        '@codecademy/gamut-tests',
+        '@codecademy/variance',
+      ],
+      /* gamut-tests is test-only, so it has no business in a runtime share. */
+      mfSharedAs: [
+        '@codecademy/gamut',
+        '@codecademy/gamut-icons',
+        '@codecademy/gamut-illustrations',
+        '@codecademy/gamut-patterns',
+        '@codecademy/gamut-styles',
+        '@codecademy/variance',
+      ],
+      note: 'gamut-kit is not published under @skillsoft. Depend on the individual packages instead.',
+    },
+  },
+
+  targetVersions: {
+    '@skillsoft/gamut': GROUP_RANGE,
+    '@skillsoft/gamut-styles': GROUP_RANGE,
+    '@skillsoft/gamut-icons': GROUP_RANGE,
+    '@skillsoft/gamut-illustrations': GROUP_RANGE,
+    '@skillsoft/gamut-patterns': GROUP_RANGE,
+    '@skillsoft/gamut-tests': GROUP_RANGE,
+    '@skillsoft/variance': GROUP_RANGE,
+    /*
+      Versioned outside the fixed group. manifest.test.ts fails if this
+      falls behind packages/eslint-plugin-gamut/package.json.
+    */
+    '@skillsoft/eslint-plugin-gamut': '^0.0.1',
+  },
+
+  /*
+    The upstream @codecademy release each package was forked from (the top
+    of its CHANGELOG.md before any @skillsoft entries). Bump these when
+    upstream changes are synced in.
+  */
+  sourceVersions: {
+    '@codecademy/gamut': '73.6.1',
+    '@codecademy/gamut-styles': '21.2.0',
+    '@codecademy/gamut-icons': '10.2.0',
+    '@codecademy/gamut-illustrations': '1.1.0',
+    '@codecademy/gamut-patterns': '1.1.0',
+    '@codecademy/gamut-tests': '7.1.0',
+    '@codecademy/variance': '1.1.0',
+    'eslint-plugin-gamut': '3.1.0',
+  },
+
+  movedExports: [
+    {
+      from: '@codecademy/gamut',
+      to: '@codecademy/gamut/Video',
+      names: ['Video', 'VideoProps'],
+      note: 'Video is no longer on the root barrel. See packages/gamut/src/index.tsx.',
+      checklist: 'video-peers',
+    },
+  ],
+
+  /*
+    From the GMT-1740 deep-import inventory. Rows are only added once the
+    target is really exported; manifest.test.ts checks.
+  */
+  deepImports: [
+    {
+      from: '@codecademy/gamut/dist/PopoverContainer/types',
+      to: '@codecademy/gamut',
+    },
+    {
+      from: '@codecademy/gamut/dist/Form/SelectDropdown/types',
+      to: '@codecademy/gamut',
+    },
+    { from: '@codecademy/gamut/dist/Form/types', to: '@codecademy/gamut' },
+    {
+      from: '@codecademy/gamut/dist/Box/props',
+      to: '@codecademy/gamut',
+      onlyNames: ['BoxProps', 'FlexBoxProps', 'GridBoxProps'],
+    },
+    {
+      from: '@codecademy/gamut/dist/Tip/shared/types',
+      to: '@codecademy/gamut',
+    },
+    {
+      from: '@codecademy/gamut/dist/Button/shared',
+      to: '@codecademy/gamut',
+      onlyNames: ['ButtonBaseProps', 'ButtonProps', 'buttonProps'],
+    },
+    {
+      from: '@codecademy/gamut/dist/Markdown/libs/overrides',
+      to: '@codecademy/gamut',
+      onlyNames: [
+        'HTMLToReactNode',
+        'MarkdownOverrideSetting',
+        'MarkdownOverrideSettings',
+        'createCodeBlockOverride',
+        'createInputOverride',
+        'createTagOverride',
+        'createVideoOverride',
+        'standardOverrides',
+      ],
+    },
+    /*
+      Renamed on the way to the root: `List` and `IconOption` collided with
+      the public List component and IconOption type. This is the rename
+      upstream GMT-1740 held back (upstream 009aa43f6); skillsoft-gamut
+      ships it.
+    */
+    {
+      from: '@codecademy/gamut/dist/Menu/elements',
+      to: '@codecademy/gamut',
+      renames: {
+        List: 'MenuList',
+        ListProps: 'MenuListProps',
+        ListItem: 'MenuListItem',
+        ListItemProps: 'MenuListItemProps',
+        ListLink: 'MenuListLink',
+        ListLinkProps: 'MenuListLinkProps',
+        ListButton: 'MenuListButton',
+      },
+    },
+    {
+      from: '@codecademy/gamut/dist/Form/SelectDropdown/elements',
+      to: '@codecademy/gamut',
+      renames: { IconOption: 'IconOptionComponent' },
+      onlyNames: ['IconOption'],
+    },
+    {
+      from: '@codecademy/gamut/dist/ButtonBase/ButtonBase',
+      to: null,
+      note: 'ButtonBase is deliberately not public. Use FillButton, StrokeButton, TextButton, IconButton, or CTAButton.',
+    },
+    {
+      from: '@codecademy/gamut/dist/Form/styles',
+      to: '@codecademy/gamut',
+      onlyNames: [
+        'conditionalStyles',
+        'formFieldPaddingStyles',
+        'formFieldStyles',
+      ],
+      note: 'The rest of Form/styles is internal. Inline the styles, or use system props / css().',
+    },
+    {
+      from: '@codecademy/gamut-styles/dist/AssetProvider',
+      to: '@codecademy/gamut-styles',
+    },
+    {
+      from: '@codecademy/gamut-icons/dist/types',
+      to: '@codecademy/gamut-icons',
+    },
+    {
+      from: '@codecademy/gamut-icons/dist/props',
+      to: '@codecademy/gamut-icons',
+      onlyNames: ['GamutIconProps', 'IconStyleProps'],
+    },
+    {
+      from: '@codecademy/variance/dist/types/config',
+      to: '@codecademy/variance',
+    },
+  ],
+
+  eslintPlugin: { from: 'gamut', to: '@skillsoft/gamut' },
+};
diff --git a/packages/gamut-codemods/src/transform.ts b/packages/gamut-codemods/src/transform.ts
new file mode 100644
index 0000000000..e1e60939f0
--- /dev/null
+++ b/packages/gamut-codemods/src/transform.ts
@@ -0,0 +1,77 @@
+import fs from 'node:fs';
+import path from 'node:path';
+
+import type { API, FileInfo } from 'jscodeshift';
+
+import {
+  activeSourceMigrations,
+  mentionsOldNames,
+  runSourceMigrations,
+} from './lib/run-source';
+import type { Locatable } from './lib/types';
+import { getPreset } from './presets';
+
+/*
+  jscodeshift entry point: runs a preset's source migrations over one file
+  (see lib/run-source.ts for the two phases).
+
+  Options:
+    preset:   preset name (default: scope-swap)
+    only:     comma-separated migration names to run (default: all)
+    skip:     comma-separated migration names the CLI ruled out for this
+              run (see Migration.skipReason)
+    notesDir: directory the CLI reads checklist notes back from. jscodeshift
+              only aggregates api.stats in --dry runs, so workers leave an
+              empty marker file per note key instead.
+    onWarn:   (message) => void, for tests; otherwise warnings go to api.report
+*/
+
+export interface TransformOptions {
+  preset?: string;
+  only?: string;
+  skip?: string;
+  notesDir?: string;
+  onWarn?: (message: string) => void;
+}
+
+export default function transform(
+  file: FileInfo,
+  api: API,
+  options: TransformOptions = {}
+) {
+  const preset = getPreset(options.preset ?? 'scope-swap');
+  const { manifest } = preset;
+  if (!mentionsOldNames(manifest, file.source)) return undefined;
+
+  const note = (key: string) => {
+    if (options.notesDir) {
+      fs.writeFileSync(
+        path.join(options.notesDir, encodeURIComponent(key)),
+        ''
+      );
+    }
+  };
+  const warnFor = (name: string) => (node: Locatable, message: string) => {
+    const line = node?.loc ? `:${node.loc.start.line}` : '';
+    const text = `[${name}] ${file.path}${line} ${message}`;
+    if (options.onWarn) options.onWarn(text);
+    else api.report(text);
+  };
+
+  const source = runSourceMigrations({
+    j: api.jscodeshift,
+    source: file.source,
+    migrations: activeSourceMigrations(
+      preset.migrations,
+      options.only,
+      options.skip
+    ),
+    manifest,
+    warnFor,
+    note,
+  });
+
+  return source === file.source ? undefined : source;
+}
+
+export const parser = 'tsx';
diff --git a/packages/gamut-codemods/tsconfig.json b/packages/gamut-codemods/tsconfig.json
new file mode 100644
index 0000000000..62ebbd9464
--- /dev/null
+++ b/packages/gamut-codemods/tsconfig.json
@@ -0,0 +1,13 @@
+{
+  "extends": "../../tsconfig.base.json",
+  "files": [],
+  "include": [],
+  "references": [
+    {
+      "path": "./tsconfig.lib.json"
+    },
+    {
+      "path": "./tsconfig.spec.json"
+    }
+  ]
+}
diff --git a/packages/gamut-codemods/tsconfig.lib.json b/packages/gamut-codemods/tsconfig.lib.json
new file mode 100644
index 0000000000..8c51e7c29d
--- /dev/null
+++ b/packages/gamut-codemods/tsconfig.lib.json
@@ -0,0 +1,13 @@
+{
+  "extends": "./tsconfig.json",
+  "compilerOptions": {
+    "declaration": true,
+    "module": "CommonJS",
+    "outDir": "./dist",
+    "rootDir": "./src",
+    "lib": ["es2022"],
+    "types": ["node"]
+  },
+  "exclude": ["jest.config.ts", "**/*.test.ts", "**/__testfixtures__/**"],
+  "include": ["./src/**/*.ts"]
+}
diff --git a/packages/gamut-codemods/tsconfig.spec.json b/packages/gamut-codemods/tsconfig.spec.json
new file mode 100644
index 0000000000..38a15e287a
--- /dev/null
+++ b/packages/gamut-codemods/tsconfig.spec.json
@@ -0,0 +1,11 @@
+{
+  "extends": "./tsconfig.json",
+  "compilerOptions": {
+    "module": "commonjs",
+    "outDir": "./dist",
+    "lib": ["es2022"],
+    "types": ["jest", "node"]
+  },
+  "exclude": ["**/__testfixtures__/**"],
+  "include": ["jest.config.ts", "**/*.test.ts", "**/*.d.ts"]
+}
diff --git a/packages/gamut-docs/src/content/docs/components/media-and-assets/video.mdx b/packages/gamut-docs/src/content/docs/components/media-and-assets/video.mdx
index a6cc99cee1..3fdadb5f7f 100644
--- a/packages/gamut-docs/src/content/docs/components/media-and-assets/video.mdx
+++ b/packages/gamut-docs/src/content/docs/components/media-and-assets/video.mdx
@@ -23,6 +23,12 @@ Use `Video` to play a direct video file or stream (MP4, HLS, DASH) or embed a Yo
 
 - **Markdown content that already links to a video** — [Markdown](/components/data-display/markdown/)'s own `<video>` and YouTube/Vimeo `<iframe>` overrides render into `Video` automatically; don't wrap it a second time.
 
+## Requirements
+
+`Video` imports a stylesheet (`vidstack-styles.css`) directly, so it needs a bundler that can handle CSS imports, such as webpack, Vite, or Next.js. It won't load with native ESM in Node or in a browser with no bundler, and fails with `Unknown file extension ".css"`.
+
+Video is imported from `@skillsoft/gamut/Video`, not the root package. Apps that don't use Video don't load the stylesheet.
+
 ## Usage examples
 
 ### Embedding YouTube or Vimeo
diff --git a/packages/gamut-icons/package.json b/packages/gamut-icons/package.json
index 7b1e72c985..19adbe5907 100644
--- a/packages/gamut-icons/package.json
+++ b/packages/gamut-icons/package.json
@@ -4,8 +4,8 @@
   "version": "0.0.1",
   "author": "Skillsoft Engineering <dev@codecademy.com>",
   "dependencies": {
-    "@skillsoft/gamut-styles": "0.0.1",
-    "@skillsoft/variance": "0.0.1"
+    "@skillsoft/gamut-styles": "^0.0.1",
+    "@skillsoft/variance": "^0.0.1"
   },
   "exports": {
     "./package.json": "./package.json",
@@ -24,7 +24,6 @@
   "peerDependencies": {
     "@emotion/react": "^11.4.0",
     "@emotion/styled": "^11.3.0",
-    "lodash": "^4.17.23",
     "react": "^17.0.2 || ^18.3.0 || ^19.0.0"
   },
   "publishConfig": {
diff --git a/packages/gamut-illustrations/package.json b/packages/gamut-illustrations/package.json
index b2e3f118e0..6dc03baed4 100644
--- a/packages/gamut-illustrations/package.json
+++ b/packages/gamut-illustrations/package.json
@@ -5,7 +5,7 @@
   "author": "Skillsoft Engineering <dev@codecademy.com>",
   "bugs": "https://github.com/Codecademy/skillsoft-gamut/issues",
   "dependencies": {
-    "@skillsoft/gamut-styles": "0.0.1",
+    "@skillsoft/gamut-styles": "^0.0.1",
     "classnames": "^2.2.5"
   },
   "exports": {
diff --git a/packages/gamut-patterns/package.json b/packages/gamut-patterns/package.json
index 5bcd8a2d6e..62c4677fd8 100644
--- a/packages/gamut-patterns/package.json
+++ b/packages/gamut-patterns/package.json
@@ -5,8 +5,8 @@
   "author": "Skillsoft Engineering <dev@codecademy.com>",
   "bugs": "https://github.com/Codecademy/skillsoft-gamut/issues",
   "dependencies": {
-    "@skillsoft/gamut-styles": "0.0.1",
-    "@skillsoft/variance": "0.0.1",
+    "@skillsoft/gamut-styles": "^0.0.1",
+    "@skillsoft/variance": "^0.0.1",
     "classnames": "^2.2.5"
   },
   "exports": {
diff --git a/packages/gamut-styles/package.json b/packages/gamut-styles/package.json
index e43eceef59..c1540e8e88 100644
--- a/packages/gamut-styles/package.json
+++ b/packages/gamut-styles/package.json
@@ -5,9 +5,11 @@
   "author": "Skillsoft Engineering <dev@codecademy.com>",
   "dependencies": {
     "@emotion/is-prop-valid": "^1.1.0",
-    "@skillsoft/variance": "0.0.1",
+    "@skillsoft/variance": "^0.0.1",
+    "csstype": "^3.0.7",
     "framer-motion": "^12.0.0",
     "get-nonce": "^1.0.0",
+    "lodash": "^4.17.23",
     "polished": "^4.1.2"
   },
   "exports": {
@@ -29,7 +31,6 @@
     "@emotion/cache": "^11.4.0",
     "@emotion/react": "^11.4.0",
     "@emotion/styled": "^11.3.0",
-    "lodash": "^4.17.23",
     "react": "^17.0.2 || ^18.3.0 || ^19.0.0",
     "stylis": "^4.0.7"
   },
diff --git a/packages/gamut-tests/package.json b/packages/gamut-tests/package.json
index d8fbf72a64..62e2bb15fb 100644
--- a/packages/gamut-tests/package.json
+++ b/packages/gamut-tests/package.json
@@ -4,8 +4,8 @@
   "version": "0.0.1",
   "author": "Skillsoft Engineering <dev@codecademy.com>",
   "dependencies": {
-    "@skillsoft/gamut-styles": "0.0.1",
-    "component-test-setup": "*",
+    "@skillsoft/gamut-styles": "^0.0.1",
+    "component-test-setup": "^0.3.1",
     "lodash": "^4.17.23"
   },
   "exports": {
diff --git a/packages/gamut/Video/package.json b/packages/gamut/Video/package.json
new file mode 100644
index 0000000000..9a1490663a
--- /dev/null
+++ b/packages/gamut/Video/package.json
@@ -0,0 +1,5 @@
+{
+  "main": "../dist/Video/index.js",
+  "module": "../dist/Video/index.mjs",
+  "types": "../dist/Video/index.d.ts"
+}
diff --git a/packages/gamut/__tests__/__snapshots__/gamut.test.ts.snap b/packages/gamut/__tests__/__snapshots__/gamut.test.ts.snap
index 30593dae53..c04b2fbe56 100644
--- a/packages/gamut/__tests__/__snapshots__/gamut.test.ts.snap
+++ b/packages/gamut/__tests__/__snapshots__/gamut.test.ts.snap
@@ -16,6 +16,7 @@ exports[`Gamut Exported Keys 1`] = `
   "Checkbox",
   "Coachmark",
   "Column",
+  "conditionalStyles",
   "ConnectedCheckbox",
   "ConnectedForm",
   "ConnectedFormGroup",
@@ -54,6 +55,8 @@ exports[`Gamut Exported Keys 1`] = `
   "focusVisibleStyle",
   "Form",
   "FormError",
+  "formFieldPaddingStyles",
+  "formFieldStyles",
   "FormGroup",
   "FormGroupDescription",
   "FormGroupLabel",
@@ -65,6 +68,7 @@ exports[`Gamut Exported Keys 1`] = `
   "GridForm",
   "GridFormContent",
   "IconButton",
+  "IconOptionComponent",
   "iFrameWrapper",
   "InfoTip",
   "Input",
@@ -78,7 +82,12 @@ exports[`Gamut Exported Keys 1`] = `
   "matchDisabledDates",
   "Menu",
   "MenuItem",
+  "MenuList",
+  "MenuListButton",
+  "MenuListItem",
+  "MenuListLink",
   "MenuSeparator",
+  "MenuToolTipWrapper",
   "Modal",
   "omitProps",
   "Overlay",
diff --git a/packages/gamut/package.json b/packages/gamut/package.json
index 4ac900d4cf..155d78532c 100644
--- a/packages/gamut/package.json
+++ b/packages/gamut/package.json
@@ -7,11 +7,11 @@
   "dependencies": {
     "@formatjs/intl-locale": "5.3.1",
     "@react-aria/interactions": "3.25.0",
-    "@skillsoft/gamut-icons": "0.0.1",
-    "@skillsoft/gamut-illustrations": "0.0.1",
-    "@skillsoft/gamut-patterns": "0.0.1",
-    "@skillsoft/gamut-styles": "0.0.1",
-    "@skillsoft/variance": "0.0.1",
+    "@skillsoft/gamut-icons": "^0.0.1",
+    "@skillsoft/gamut-illustrations": "^0.0.1",
+    "@skillsoft/gamut-patterns": "^0.0.1",
+    "@skillsoft/gamut-styles": "^0.0.1",
+    "@skillsoft/variance": "^0.0.1",
     "@types/marked": "^4.0.8",
     "classnames": "^2.2.5",
     "framer-motion": "^12.0.0",
@@ -47,7 +47,8 @@
   },
   "files": [
     "dist",
-    "bin"
+    "bin",
+    "Video"
   ],
   "license": "MIT",
   "main": "./dist/index.js",
diff --git a/packages/gamut/project.json b/packages/gamut/project.json
index 5a12ae3d78..ce38f314a7 100644
--- a/packages/gamut/project.json
+++ b/packages/gamut/project.json
@@ -42,10 +42,7 @@
       "dependsOn": ["build"],
       "options": {
         "cwd": "{projectRoot}",
-        "commands": [
-          "publint .",
-          "attw --pack . --ignore-rules false-cjs no-resolution"
-        ],
+        "commands": ["publint .", "attw --pack . --ignore-rules false-cjs"],
         "parallel": false
       }
     },
diff --git a/packages/gamut/src/Button/index.ts b/packages/gamut/src/Button/index.ts
index dae5e26ff3..dd02cffb1d 100644
--- a/packages/gamut/src/Button/index.ts
+++ b/packages/gamut/src/Button/index.ts
@@ -1,4 +1,4 @@
-export type { ButtonProps } from './shared';
+export type { ButtonBaseProps, ButtonProps } from './shared';
 export { buttonProps } from './shared';
 export * from './CTAButton';
 export * from './FillButton';
diff --git a/packages/gamut/src/Form/SelectDropdown/core/constants.ts b/packages/gamut/src/Form/SelectDropdown/core/constants.ts
index a5629613a2..50c1009384 100644
--- a/packages/gamut/src/Form/SelectDropdown/core/constants.ts
+++ b/packages/gamut/src/Form/SelectDropdown/core/constants.ts
@@ -6,7 +6,7 @@ import {
   CustomInput,
   CustomValueContainer,
   DropdownButton,
-  IconOption,
+  IconOptionComponent,
   MultiValueRemoveButton,
   MultiValueWithColorMode,
   RemoveAllButton,
@@ -20,7 +20,7 @@ const baseDefaultComponents = {
   ValueContainer: CustomValueContainer,
   MultiValue: MultiValueWithColorMode,
   MultiValueRemove: MultiValueRemoveButton,
-  Option: IconOption,
+  Option: IconOptionComponent,
   SingleValue: AbbreviatedSingleValue,
   Input: CustomInput,
 };
diff --git a/packages/gamut/src/Form/SelectDropdown/elements/index.ts b/packages/gamut/src/Form/SelectDropdown/elements/index.ts
index 5a67d3619b..9ab1c6655e 100644
--- a/packages/gamut/src/Form/SelectDropdown/elements/index.ts
+++ b/packages/gamut/src/Form/SelectDropdown/elements/index.ts
@@ -18,7 +18,7 @@ export {
 } from './containers';
 
 export {
-  IconOption,
+  IconOptionComponent,
   AbbreviatedSingleValue,
   formatOptionLabel,
   formatGroupLabel,
diff --git a/packages/gamut/src/Form/SelectDropdown/elements/options.tsx b/packages/gamut/src/Form/SelectDropdown/elements/options.tsx
index e91b25178a..17b011b7d4 100644
--- a/packages/gamut/src/Form/SelectDropdown/elements/options.tsx
+++ b/packages/gamut/src/Form/SelectDropdown/elements/options.tsx
@@ -46,7 +46,7 @@ const IconOptionLabel: React.FC<
  * Also manages ARIA attributes for accessibility.
  * Skips the check icon for react-select/creatable's "Add" row (__isNew__).
  */
-export const IconOption = ({
+export const IconOptionComponent = ({
   children,
   ...rest
 }: CustomSelectComponentProps<typeof SelectDropdownElements.Option>) => {
diff --git a/packages/gamut/src/Form/SelectDropdown/index.tsx b/packages/gamut/src/Form/SelectDropdown/index.tsx
index fd0cb718f8..f6d233827e 100644
--- a/packages/gamut/src/Form/SelectDropdown/index.tsx
+++ b/packages/gamut/src/Form/SelectDropdown/index.tsx
@@ -1,3 +1,4 @@
 export type { SelectDropdownTranslations } from './core/translations';
 export * from './types';
+export { IconOptionComponent } from './elements';
 export * from './SelectDropdown';
diff --git a/packages/gamut/src/Form/index.tsx b/packages/gamut/src/Form/index.tsx
index f59e8507d7..7301e9103c 100644
--- a/packages/gamut/src/Form/index.tsx
+++ b/packages/gamut/src/Form/index.tsx
@@ -13,3 +13,12 @@ export * from './inputs/Radio';
 export * from './inputs/RadioGroup';
 export * from './inputs/types';
 export * from './types';
+/*
+  For custom inputs that should look like Input, such as third-party hosted
+  payment fields. The rest of ./styles is internal.
+*/
+export {
+  conditionalStyles,
+  formFieldPaddingStyles,
+  formFieldStyles,
+} from './styles';
diff --git a/packages/gamut/src/Markdown/__tests__/Markdown.test.tsx b/packages/gamut/src/Markdown/__tests__/Markdown.test.tsx
index 38cbf343fb..ef6609c453 100644
--- a/packages/gamut/src/Markdown/__tests__/Markdown.test.tsx
+++ b/packages/gamut/src/Markdown/__tests__/Markdown.test.tsx
@@ -163,6 +163,27 @@ describe('<Markdown />', () => {
     expect(document.querySelectorAll('video').length).toEqual(1);
     expect(screen.queryByTitle(mockTitle)).not.toBeInTheDocument();
   });
+
+  it('Does not wrap a single-line video override in a paragraph', () => {
+    renderView({
+      text: `<video src="https://example.com/clip.mp4" controls></video>`,
+      videoOverride: { component: MarkdownVideo },
+    });
+    expect(document.querySelector('p div')).toBeNull();
+  });
+
+  it('Passes undefined width and height to Video when the video has none', () => {
+    // React only warns about NaN styles once per value, so check the props directly
+    const element = MarkdownVideo({
+      src: 'https://example.com/clip.mp4',
+    } as Parameters<typeof MarkdownVideo>[0]) as React.ReactElement<{
+      width?: number;
+      height?: number;
+    }>;
+    expect(element.props.width).toBeUndefined();
+    expect(element.props.height).toBeUndefined();
+  });
+
   it('Wraps the markdown in a div by default (block)', () => {
     renderView({ text: basicMarkdown });
     expect(
diff --git a/packages/gamut/src/Markdown/index.tsx b/packages/gamut/src/Markdown/index.tsx
index 544bc6bc5e..b613382f83 100644
--- a/packages/gamut/src/Markdown/index.tsx
+++ b/packages/gamut/src/Markdown/index.tsx
@@ -34,6 +34,20 @@ const preprocessingInstructions = createPreprocessingInstructions();
 
 const isValidNode = () => true;
 
+/**
+ * Puts each <video> block on its own lines so marked emits an HTML block.
+ * A single-line <video>...</video> is parsed as paragraph text, which wraps
+ * the video's block-level output in a <p>.
+ */
+const normalizeVideoBlocks = (text: string) =>
+  text.replace(
+    /(<video\b[^>]*>)([\s\S]*?)(<\/video>)/gi,
+    (_match, open: string, inner: string, close: string) => {
+      const body = inner.trim();
+      return `\n\n${open}\n${body ? `${body}\n` : ''}${close}\n\n`;
+    }
+  );
+
 const MarkdownWrapper = styled.div<{ spacing: 'loose' | 'tight' | 'none' }>`
   ${({ theme, spacing }) => {
     const spacingStyleFunction = markdownStyles[spacing];
@@ -152,7 +166,7 @@ export class Markdown extends PureComponent<MarkdownProps> {
     // Render markdown to html
     const rawHtml = inline
       ? marked.parseInline(text, markedOptions)
-      : marked(text, markedOptions);
+      : marked(normalizeVideoBlocks(text), markedOptions);
 
     const sanitizationConfig = {
       ...defaultSanitizationConfig,
@@ -197,6 +211,7 @@ export class Markdown extends PureComponent<MarkdownProps> {
 }
 
 export type {
+  HTMLToReactNode,
   MarkdownOverrideSetting,
   MarkdownOverrideSettings,
 } from './libs/overrides';
diff --git a/packages/gamut/src/Markdown/libs/overrides/Video/index.tsx b/packages/gamut/src/Markdown/libs/overrides/Video/index.tsx
index 75cf568422..dee1221d9c 100644
--- a/packages/gamut/src/Markdown/libs/overrides/Video/index.tsx
+++ b/packages/gamut/src/Markdown/libs/overrides/Video/index.tsx
@@ -19,12 +19,12 @@ export const MarkdownVideo: React.FC<MarkdownVideoProps> = (props) => {
     const videoProps = {
       autoplay: props?.autoPlay,
       controls: props?.controls,
-      height: Number(props?.height),
+      height: props?.height ? Number(props.height) : undefined,
       loop: props?.loop,
       muted: props?.muted,
       videoTitle: props?.title,
       videoUrl: props?.src,
-      width: Number(props?.width),
+      width: props?.width ? Number(props.width) : undefined,
       textTracks: props?.textTracks,
       showPlayerEmbed: props?.showPlayerEmbed,
     };
diff --git a/packages/gamut/src/Menu/Menu.tsx b/packages/gamut/src/Menu/Menu.tsx
index 83b6bd328d..10d647f08e 100644
--- a/packages/gamut/src/Menu/Menu.tsx
+++ b/packages/gamut/src/Menu/Menu.tsx
@@ -1,12 +1,12 @@
 import type { ComponentProps } from 'react';
 import { forwardRef } from 'react';
 
-import { List } from './elements';
+import { MenuList } from './elements';
 import { MenuProvider, useMenu } from './MenuContext';
 
 export const Menu = forwardRef<
   HTMLUListElement | HTMLOListElement,
-  Omit<ComponentProps<typeof List>, 'root'>
+  Omit<ComponentProps<typeof MenuList>, 'root'>
 >(
   (
     { children, variant = 'popover', spacing = 'normal', role, ...rest },
@@ -15,9 +15,9 @@ export const Menu = forwardRef<
     const currentContext = useMenu({ variant, role, spacing });
 
     return (
-      <List {...rest} {...currentContext} ref={ref}>
+      <MenuList {...rest} {...currentContext} ref={ref}>
         <MenuProvider value={currentContext}>{children}</MenuProvider>
-      </List>
+      </MenuList>
     );
   }
 );
diff --git a/packages/gamut/src/Menu/MenuItem.tsx b/packages/gamut/src/Menu/MenuItem.tsx
index 04ca7efb7c..3288ab987a 100644
--- a/packages/gamut/src/Menu/MenuItem.tsx
+++ b/packages/gamut/src/Menu/MenuItem.tsx
@@ -6,8 +6,13 @@ import { forwardRef, useId } from 'react';
 import { FlexBox } from '../Box';
 import type { ToolTipProps } from '../Tip/ToolTip';
 import { Text } from '../Typography';
-import type { ListItemProps, ListLinkProps } from './elements';
-import { ListButton, ListItem, ListLink, MenuToolTipWrapper } from './elements';
+import type { MenuListItemProps, MenuListLinkProps } from './elements';
+import {
+  MenuListButton,
+  MenuListItem,
+  MenuListLink,
+  MenuToolTipWrapper,
+} from './elements';
 import { useMenuContext } from './MenuContext';
 
 const getListItemType = (href: boolean, onClick: boolean) =>
@@ -26,7 +31,7 @@ const currentItemText = {
 
 type HTMLProps = Partial<Pick<HTMLAnchorElement, 'href' | 'target' | 'rel'>>;
 type ForwardListItemProps = Omit<
-  ComponentProps<typeof ListItem>,
+  ComponentProps<typeof MenuListItem>,
   'variant' | 'selected' | 'active-navlink' | 'children'
 >;
 
@@ -97,7 +102,7 @@ export const MenuItem = forwardRef<
       role: listItemRole,
       height,
       width,
-    } as ListItemProps;
+    } as MenuListItemProps;
 
     const ariaLabel = label
       ? typeof label === 'string'
@@ -139,18 +144,18 @@ export const MenuItem = forwardRef<
 
     if (listItemType === 'link' && !disabled) {
       return (
-        <ListItem {...listItemProps}>
+        <MenuListItem {...listItemProps}>
           <MenuToolTipWrapper label={label} tipId={tipId}>
-            <ListLink
-              {...(computed as ListLinkProps)}
+            <MenuListLink
+              {...(computed as MenuListLinkProps)}
               href={href}
               ref={narrowMenuItemRef<HTMLAnchorElement>(ref)}
               target={target}
             >
               {content}
-            </ListLink>
+            </MenuListLink>
           </MenuToolTipWrapper>
-        </ListItem>
+        </MenuListItem>
       );
     }
 
@@ -160,32 +165,32 @@ export const MenuItem = forwardRef<
         : (props.onClick as any as MouseEventHandler<HTMLButtonElement>);
 
       return (
-        <ListItem {...listItemProps}>
+        <MenuListItem {...listItemProps}>
           <MenuToolTipWrapper
             closeOnClick={closeOnClick}
             label={label}
             tipId={tipId}
           >
-            <ListButton
-              {...(computed as ListLinkProps)}
+            <MenuListButton
+              {...(computed as MenuListLinkProps)}
               ref={narrowMenuItemRef<HTMLButtonElement>(ref)}
               onClick={handleClick}
             >
               {content}
-            </ListButton>
+            </MenuListButton>
           </MenuToolTipWrapper>
-        </ListItem>
+        </MenuListItem>
       );
     }
 
     return (
       // These are non-interactive and will never have tooltips (nor should they).
-      <ListItem
-        {...(computed as ListItemProps)}
+      <MenuListItem
+        {...(computed as MenuListItemProps)}
         ref={narrowMenuItemRef<HTMLLIElement>(ref)}
       >
         {content}
-      </ListItem>
+      </MenuListItem>
     );
   }
 );
diff --git a/packages/gamut/src/Menu/elements.tsx b/packages/gamut/src/Menu/elements.tsx
index d0f63d75cc..6ce6501958 100644
--- a/packages/gamut/src/Menu/elements.tsx
+++ b/packages/gamut/src/Menu/elements.tsx
@@ -34,7 +34,7 @@ const listProps = variance.compose(
   system.color
 );
 
-export interface ListProps extends ListStyleProps, StyleStateProps {
+export interface MenuListProps extends ListStyleProps, StyleStateProps {
   /** How offset spacing should be */
   spacing?: 'normal' | 'condensed';
   /** Menu variants for specific use cases and styles */
@@ -46,7 +46,7 @@ export interface ListProps extends ListStyleProps, StyleStateProps {
   showBorder?: boolean;
 }
 
-const StyledList = styled('ul', styledOptions<'ul'>())<ListProps>(
+const StyledList = styled('ul', styledOptions<'ul'>())<MenuListProps>(
   system.css({
     listStyle: 'none',
     width: 1,
@@ -70,7 +70,7 @@ const StyledList = styled('ul', styledOptions<'ul'>())<ListProps>(
   listProps
 );
 
-export const List = forwardRef<
+export const MenuList = forwardRef<
   HTMLUListElement,
   ComponentProps<typeof StyledList>
 >(({ context = true, m = 0, root = true, variant, ...rest }, ref) => (
@@ -195,14 +195,17 @@ const sizeVariants = system.variant({
   },
 });
 
-export interface ListItemProps
+export interface MenuListItemProps
   extends ListStyleProps,
     StyleStateProps,
     StyleProps<typeof interactiveVariants>,
     StyleProps<typeof activeStates>,
     StyleProps<typeof sizeVariants> {}
 
-export const ListItem = styled('li', styledOptions<'li'>())<ListItemProps>(
+export const MenuListItem = styled(
+  'li',
+  styledOptions<'li'>()
+)<MenuListItemProps>(
   interactiveVariants,
   activeStates,
   sizeVariants,
@@ -210,12 +213,12 @@ export const ListItem = styled('li', styledOptions<'li'>())<ListItemProps>(
   listProps
 );
 
-export interface ListLinkProps extends ListItemProps {
+export interface MenuListLinkProps extends MenuListItemProps {
   active?: boolean;
   navlink?: boolean;
 }
 
-const StyledListLink = styled('a', styledOptions<'a'>())<ListLinkProps>(
+const StyledListLink = styled('a', styledOptions<'a'>())<MenuListLinkProps>(
   resetStyles,
   interactiveVariants,
   activeStates,
@@ -224,17 +227,17 @@ const StyledListLink = styled('a', styledOptions<'a'>())<ListLinkProps>(
   listProps
 );
 
-export const ListLink = forwardRef<
+export const MenuListLink = forwardRef<
   HTMLAnchorElement,
   ComponentProps<typeof StyledListLink>
 >(({ zIndex = 1, ...rest }, ref) => (
   <StyledListLink ref={ref} zIndex={zIndex} {...rest} />
 ));
 
-export const ListButton = styled(
+export const MenuListButton = styled(
   'button',
   styledOptions<'button'>()
-)<ListLinkProps>(
+)<MenuListLinkProps>(
   resetStyles,
   interactiveVariants,
   activeStates,
diff --git a/packages/gamut/src/Menu/index.tsx b/packages/gamut/src/Menu/index.tsx
index 65077f603d..54f17e7928 100644
--- a/packages/gamut/src/Menu/index.tsx
+++ b/packages/gamut/src/Menu/index.tsx
@@ -1,3 +1,4 @@
+export * from './elements';
 export * from './Menu';
 export * from './MenuItem';
 export * from './MenuSeparator';
diff --git a/packages/variance/package.json b/packages/variance/package.json
index 9625a1bcc1..a750678e6a 100644
--- a/packages/variance/package.json
+++ b/packages/variance/package.json
@@ -40,5 +40,10 @@
     "build": "nx build variance"
   },
   "sideEffects": false,
-  "types": "dist/index.d.ts"
+  "types": "dist/index.d.ts",
+  "peerDependenciesMeta": {
+    "typescript": {
+      "optional": true
+    }
+  }
 }
diff --git a/yarn.lock b/yarn.lock
index a9ef908690..e4f70f5fea 100644
--- a/yarn.lock
+++ b/yarn.lock
@@ -400,7 +400,7 @@ __metadata:
   languageName: node
   linkType: hard
 
-"@babel/core@npm:^7.12.3, @babel/core@npm:^7.21.3, @babel/core@npm:^7.23.2, @babel/core@npm:^7.23.9, @babel/core@npm:^7.27.4, @babel/core@npm:^7.28.0, @babel/core@npm:^7.29.0":
+"@babel/core@npm:^7.12.3, @babel/core@npm:^7.21.3, @babel/core@npm:^7.23.2, @babel/core@npm:^7.23.9, @babel/core@npm:^7.24.7, @babel/core@npm:^7.27.4, @babel/core@npm:^7.28.0, @babel/core@npm:^7.29.0":
   version: 7.29.7
   resolution: "@babel/core@npm:7.29.7"
   dependencies:
@@ -436,12 +436,12 @@ __metadata:
   languageName: node
   linkType: hard
 
-"@babel/helper-annotate-as-pure@npm:^7.25.9":
-  version: 7.25.9
-  resolution: "@babel/helper-annotate-as-pure@npm:7.25.9"
+"@babel/helper-annotate-as-pure@npm:^7.25.9, @babel/helper-annotate-as-pure@npm:^7.29.7":
+  version: 7.29.7
+  resolution: "@babel/helper-annotate-as-pure@npm:7.29.7"
   dependencies:
-    "@babel/types": "npm:^7.25.9"
-  checksum: 10c0/095b6ba50489d797733abebc4596a81918316a99e3632755c9f02508882912b00c2ae5e468532a25a5c2108d109ddbe9b7da78333ee7cc13817fc50c00cf06fe
+    "@babel/types": "npm:^7.29.7"
+  checksum: 10c0/c56536b52d17632d89d49db2063ed6102f0e3bbadf6a0ccb74e6599d6a77173b644c7fe8c3ef17c7a162709d55b75ee5145ef6db917d16ba7f375fbffcf2e942
   languageName: node
   linkType: hard
 
@@ -468,20 +468,20 @@ __metadata:
   languageName: node
   linkType: hard
 
-"@babel/helper-create-class-features-plugin@npm:^7.25.9":
-  version: 7.25.9
-  resolution: "@babel/helper-create-class-features-plugin@npm:7.25.9"
+"@babel/helper-create-class-features-plugin@npm:^7.25.9, @babel/helper-create-class-features-plugin@npm:^7.29.7":
+  version: 7.29.7
+  resolution: "@babel/helper-create-class-features-plugin@npm:7.29.7"
   dependencies:
-    "@babel/helper-annotate-as-pure": "npm:^7.25.9"
-    "@babel/helper-member-expression-to-functions": "npm:^7.25.9"
-    "@babel/helper-optimise-call-expression": "npm:^7.25.9"
-    "@babel/helper-replace-supers": "npm:^7.25.9"
-    "@babel/helper-skip-transparent-expression-wrappers": "npm:^7.25.9"
-    "@babel/traverse": "npm:^7.25.9"
+    "@babel/helper-annotate-as-pure": "npm:^7.29.7"
+    "@babel/helper-member-expression-to-functions": "npm:^7.29.7"
+    "@babel/helper-optimise-call-expression": "npm:^7.29.7"
+    "@babel/helper-replace-supers": "npm:^7.29.7"
+    "@babel/helper-skip-transparent-expression-wrappers": "npm:^7.29.7"
+    "@babel/traverse": "npm:^7.29.7"
     semver: "npm:^6.3.1"
   peerDependencies:
     "@babel/core": ^7.0.0
-  checksum: 10c0/b2bdd39f38056a76b9ba00ec5b209dd84f5c5ebd998d0f4033cf0e73d5f2c357fbb49d1ce52db77a2709fb29ee22321f84a5734dc9914849bdfee9ad12ce8caf
+  checksum: 10c0/75f34905b5e708b473f1e9b33e07b2fcc8f4c60676df8bc74541bb91c77f387c32a948dd04d5071e469ba454d72d0a872e3ace40fbb1d1e7aaa8569efcf09ed4
   languageName: node
   linkType: hard
 
@@ -520,13 +520,13 @@ __metadata:
   languageName: node
   linkType: hard
 
-"@babel/helper-member-expression-to-functions@npm:^7.25.9":
-  version: 7.25.9
-  resolution: "@babel/helper-member-expression-to-functions@npm:7.25.9"
+"@babel/helper-member-expression-to-functions@npm:^7.29.7":
+  version: 7.29.7
+  resolution: "@babel/helper-member-expression-to-functions@npm:7.29.7"
   dependencies:
-    "@babel/traverse": "npm:^7.25.9"
-    "@babel/types": "npm:^7.25.9"
-  checksum: 10c0/e08c7616f111e1fb56f398365e78858e26e466d4ac46dff25921adc5ccae9b232f66e952a2f4162bbe336627ba336c7fd9eca4835b6548935973d3380d77eaff
+    "@babel/traverse": "npm:^7.29.7"
+    "@babel/types": "npm:^7.29.7"
+  checksum: 10c0/eef7940ce0797208854a5af1049a98fee9abbffb5c619640c69ff5a555f8e3552295bb18756490b02bc6af7df8c1babcb83f12203aac2deb9dfecfc78846e12d
   languageName: node
   linkType: hard
 
@@ -553,12 +553,12 @@ __metadata:
   languageName: node
   linkType: hard
 
-"@babel/helper-optimise-call-expression@npm:^7.25.9":
-  version: 7.25.9
-  resolution: "@babel/helper-optimise-call-expression@npm:7.25.9"
+"@babel/helper-optimise-call-expression@npm:^7.29.7":
+  version: 7.29.7
+  resolution: "@babel/helper-optimise-call-expression@npm:7.29.7"
   dependencies:
-    "@babel/types": "npm:^7.25.9"
-  checksum: 10c0/90203e6607edeadd2a154940803fd616c0ed92c1013d6774c4b8eb491f1a5a3448b68faae6268141caa5c456e55e3ee49a4ed2bd7ddaf2365daea321c435914c
+    "@babel/types": "npm:^7.29.7"
+  checksum: 10c0/fd0244b9bfbb487db02d59aa2703c6991d654ea5f3f39d912682842bdca2e87b5ae8643b0ce8069bf5fbee39d1aa9db7abefeb5e6ba1aa650dca12777cf5b7e2
   languageName: node
   linkType: hard
 
@@ -582,36 +582,26 @@ __metadata:
   languageName: node
   linkType: hard
 
-"@babel/helper-replace-supers@npm:^7.25.9":
-  version: 7.25.9
-  resolution: "@babel/helper-replace-supers@npm:7.25.9"
+"@babel/helper-replace-supers@npm:^7.25.9, @babel/helper-replace-supers@npm:^7.29.7":
+  version: 7.29.7
+  resolution: "@babel/helper-replace-supers@npm:7.29.7"
   dependencies:
-    "@babel/helper-member-expression-to-functions": "npm:^7.25.9"
-    "@babel/helper-optimise-call-expression": "npm:^7.25.9"
-    "@babel/traverse": "npm:^7.25.9"
+    "@babel/helper-member-expression-to-functions": "npm:^7.29.7"
+    "@babel/helper-optimise-call-expression": "npm:^7.29.7"
+    "@babel/traverse": "npm:^7.29.7"
   peerDependencies:
     "@babel/core": ^7.0.0
-  checksum: 10c0/0b40d7d2925bd3ba4223b3519e2e4d2456d471ad69aa458f1c1d1783c80b522c61f8237d3a52afc9e47c7174129bbba650df06393a6787d5722f2ec7f223c3f4
+  checksum: 10c0/1c7ae37797f226e965ab85f6affa53d25a10c169c604a4daeb36f9df09e673471e6522f631c13761cf9fbafeca2ea14c241dea8d723a51039d561beb01d86ac4
   languageName: node
   linkType: hard
 
-"@babel/helper-simple-access@npm:^7.25.9":
-  version: 7.25.9
-  resolution: "@babel/helper-simple-access@npm:7.25.9"
-  dependencies:
-    "@babel/traverse": "npm:^7.25.9"
-    "@babel/types": "npm:^7.25.9"
-  checksum: 10c0/3f1bcdb88ee3883ccf86959869a867f6bbf8c4737cd44fb9f799c38e54f67474590bc66802500ae9fe18161792875b2cfb7ec15673f48ed6c8663f6d09686ca8
-  languageName: node
-  linkType: hard
-
-"@babel/helper-skip-transparent-expression-wrappers@npm:^7.25.9":
-  version: 7.25.9
-  resolution: "@babel/helper-skip-transparent-expression-wrappers@npm:7.25.9"
+"@babel/helper-skip-transparent-expression-wrappers@npm:^7.25.9, @babel/helper-skip-transparent-expression-wrappers@npm:^7.29.7":
+  version: 7.29.7
+  resolution: "@babel/helper-skip-transparent-expression-wrappers@npm:7.29.7"
   dependencies:
-    "@babel/traverse": "npm:^7.25.9"
-    "@babel/types": "npm:^7.25.9"
-  checksum: 10c0/09ace0c6156961624ac9524329ce7f45350bab94bbe24335cbe0da7dfaa1448e658771831983cb83fe91cf6635b15d0a3cab57c03b92657480bfb49fb56dd184
+    "@babel/traverse": "npm:^7.29.7"
+    "@babel/types": "npm:^7.29.7"
+  checksum: 10c0/8c59493621487fc491f27adfc200af82a6aca3b9a5511e4e6050f8716593b4b243472cb56c8d2016e828b7ae12d605a819205aa8600ca08ee291dcd58d65c832
   languageName: node
   linkType: hard
 
@@ -804,6 +794,17 @@ __metadata:
   languageName: node
   linkType: hard
 
+"@babel/plugin-syntax-flow@npm:^7.29.7":
+  version: 7.29.7
+  resolution: "@babel/plugin-syntax-flow@npm:7.29.7"
+  dependencies:
+    "@babel/helper-plugin-utils": "npm:^7.29.7"
+  peerDependencies:
+    "@babel/core": ^7.0.0-0
+  checksum: 10c0/b2e330dd0dc535c7364937ce2b29a06065e60b1d523db75f36ab4fb89e4ba664e2230cbb1937b35712c9a0ebafc3358f323d6e6b22247d5ebad12fdd3e1f6e98
+  languageName: node
+  linkType: hard
+
 "@babel/plugin-syntax-import-assertions@npm:^7.26.0":
   version: 7.26.0
   resolution: "@babel/plugin-syntax-import-assertions@npm:7.26.0"
@@ -1029,15 +1030,15 @@ __metadata:
   languageName: node
   linkType: hard
 
-"@babel/plugin-transform-class-properties@npm:^7.22.5, @babel/plugin-transform-class-properties@npm:^7.25.9":
-  version: 7.25.9
-  resolution: "@babel/plugin-transform-class-properties@npm:7.25.9"
+"@babel/plugin-transform-class-properties@npm:^7.22.5, @babel/plugin-transform-class-properties@npm:^7.24.7, @babel/plugin-transform-class-properties@npm:^7.25.9":
+  version: 7.29.7
+  resolution: "@babel/plugin-transform-class-properties@npm:7.29.7"
   dependencies:
-    "@babel/helper-create-class-features-plugin": "npm:^7.25.9"
-    "@babel/helper-plugin-utils": "npm:^7.25.9"
+    "@babel/helper-create-class-features-plugin": "npm:^7.29.7"
+    "@babel/helper-plugin-utils": "npm:^7.29.7"
   peerDependencies:
     "@babel/core": ^7.0.0-0
-  checksum: 10c0/f0603b6bd34d8ba62c03fc0572cb8bbc75874d097ac20cc7c5379e001081210a84dba1749e7123fca43b978382f605bb9973c99caf2c5b4c492d5c0a4a441150
+  checksum: 10c0/c370700423439aa9f0c1f8c4b97f2ef7c2dc46a1b04ec3b10e83e6bae5e4e2159f56d8e4376c9d669b3cf827650cc3740170a36e3924e3e9970d27fd85f4e48a
   languageName: node
   linkType: hard
 
@@ -1161,6 +1162,18 @@ __metadata:
   languageName: node
   linkType: hard
 
+"@babel/plugin-transform-flow-strip-types@npm:^7.29.7":
+  version: 7.29.7
+  resolution: "@babel/plugin-transform-flow-strip-types@npm:7.29.7"
+  dependencies:
+    "@babel/helper-plugin-utils": "npm:^7.29.7"
+    "@babel/plugin-syntax-flow": "npm:^7.29.7"
+  peerDependencies:
+    "@babel/core": ^7.0.0-0
+  checksum: 10c0/083e864a60927cde7bd75822bdf5c6c72de200ee955e48f6ff5923f0d2b0744ab8f1b64c45e74b88ae3796f03721489afffdb0536f25c54d0dd58508a8904f40
+  languageName: node
+  linkType: hard
+
 "@babel/plugin-transform-for-of@npm:^7.25.9":
   version: 7.25.9
   resolution: "@babel/plugin-transform-for-of@npm:7.25.9"
@@ -1242,16 +1255,15 @@ __metadata:
   languageName: node
   linkType: hard
 
-"@babel/plugin-transform-modules-commonjs@npm:^7.25.9":
-  version: 7.25.9
-  resolution: "@babel/plugin-transform-modules-commonjs@npm:7.25.9"
+"@babel/plugin-transform-modules-commonjs@npm:^7.24.7, @babel/plugin-transform-modules-commonjs@npm:^7.25.9":
+  version: 7.29.7
+  resolution: "@babel/plugin-transform-modules-commonjs@npm:7.29.7"
   dependencies:
-    "@babel/helper-module-transforms": "npm:^7.25.9"
-    "@babel/helper-plugin-utils": "npm:^7.25.9"
-    "@babel/helper-simple-access": "npm:^7.25.9"
+    "@babel/helper-module-transforms": "npm:^7.29.7"
+    "@babel/helper-plugin-utils": "npm:^7.29.7"
   peerDependencies:
     "@babel/core": ^7.0.0-0
-  checksum: 10c0/6ce771fb04d4810257fc8900374fece877dacaed74b05eaa16ad9224b390f43795c4d046cbe9ae304e1eb5aad035d37383895e3c64496d647c2128d183916e74
+  checksum: 10c0/9791cb524438b2a8ba6cb8715788fa1e202fbecd4e76b3ccab0af0819fd69212b40ae30d72ac377012f7149889f7792ed8bf91e97bbe9113ca9641f8ad3bf332
   languageName: node
   linkType: hard
 
@@ -1304,14 +1316,14 @@ __metadata:
   languageName: node
   linkType: hard
 
-"@babel/plugin-transform-nullish-coalescing-operator@npm:^7.25.9":
-  version: 7.25.9
-  resolution: "@babel/plugin-transform-nullish-coalescing-operator@npm:7.25.9"
+"@babel/plugin-transform-nullish-coalescing-operator@npm:^7.24.7, @babel/plugin-transform-nullish-coalescing-operator@npm:^7.25.9":
+  version: 7.29.7
+  resolution: "@babel/plugin-transform-nullish-coalescing-operator@npm:7.29.7"
   dependencies:
-    "@babel/helper-plugin-utils": "npm:^7.25.9"
+    "@babel/helper-plugin-utils": "npm:^7.29.7"
   peerDependencies:
     "@babel/core": ^7.0.0-0
-  checksum: 10c0/eb623db5be078a1c974afe7c7797b0309ba2ea9e9237c0b6831ade0f56d8248bb4ab3432ab34495ff8c877ec2fe412ff779d1e9b3c2b8139da18e1753d950bc3
+  checksum: 10c0/b0c186fe38bc66830e1be76f06fabbae8a655d3896a841ba5ffa12d6c40bb9c8a6ecd38a7e2196034b1d7470653109b1ceac1ef5e46a5fdc9291d14afa56e0d0
   languageName: node
   linkType: hard
 
@@ -1362,15 +1374,15 @@ __metadata:
   languageName: node
   linkType: hard
 
-"@babel/plugin-transform-optional-chaining@npm:^7.25.9":
-  version: 7.25.9
-  resolution: "@babel/plugin-transform-optional-chaining@npm:7.25.9"
+"@babel/plugin-transform-optional-chaining@npm:^7.24.7, @babel/plugin-transform-optional-chaining@npm:^7.25.9":
+  version: 7.29.7
+  resolution: "@babel/plugin-transform-optional-chaining@npm:7.29.7"
   dependencies:
-    "@babel/helper-plugin-utils": "npm:^7.25.9"
-    "@babel/helper-skip-transparent-expression-wrappers": "npm:^7.25.9"
+    "@babel/helper-plugin-utils": "npm:^7.29.7"
+    "@babel/helper-skip-transparent-expression-wrappers": "npm:^7.29.7"
   peerDependencies:
     "@babel/core": ^7.0.0-0
-  checksum: 10c0/041ad2beae5affb8e68a0bcb6882a2dadb758db3c629a0e012f57488ab43a822ac1ea17a29db8ef36560a28262a5dfa4dbbbf06ed6e431db55abe024b7cd3961
+  checksum: 10c0/71feacf9a7083030f4c69bf4e91db75f2fceae28e58c58b63db040006d908e15bc1e85a464f24ad659f17702e91a64eabbff9f1dd555ba33d78bb1af8a1d697a
   languageName: node
   linkType: hard
 
@@ -1385,15 +1397,15 @@ __metadata:
   languageName: node
   linkType: hard
 
-"@babel/plugin-transform-private-methods@npm:^7.25.9":
-  version: 7.25.9
-  resolution: "@babel/plugin-transform-private-methods@npm:7.25.9"
+"@babel/plugin-transform-private-methods@npm:^7.24.7, @babel/plugin-transform-private-methods@npm:^7.25.9":
+  version: 7.29.7
+  resolution: "@babel/plugin-transform-private-methods@npm:7.29.7"
   dependencies:
-    "@babel/helper-create-class-features-plugin": "npm:^7.25.9"
-    "@babel/helper-plugin-utils": "npm:^7.25.9"
+    "@babel/helper-create-class-features-plugin": "npm:^7.29.7"
+    "@babel/helper-plugin-utils": "npm:^7.29.7"
   peerDependencies:
     "@babel/core": ^7.0.0-0
-  checksum: 10c0/64bd71de93d39daefa3e6c878d6f2fd238ed7d4ecfb13b0e771ddbbc131487def3ceb405b62b534a5cbb5043046b504e1b189b0a45229cc75af979a9fbcaa7bd
+  checksum: 10c0/d0dc12fa478d05e346dfb02fad2ed99b308d9a7324bada71530a62dc1ccbf07b4c2581ac677b7196b3994f191ef1922199e2c8f33957b726e2019ce07b4ced0f
   languageName: node
   linkType: hard
 
@@ -1751,6 +1763,19 @@ __metadata:
   languageName: node
   linkType: hard
 
+"@babel/preset-flow@npm:^7.24.7":
+  version: 7.29.7
+  resolution: "@babel/preset-flow@npm:7.29.7"
+  dependencies:
+    "@babel/helper-plugin-utils": "npm:^7.29.7"
+    "@babel/helper-validator-option": "npm:^7.29.7"
+    "@babel/plugin-transform-flow-strip-types": "npm:^7.29.7"
+  peerDependencies:
+    "@babel/core": ^7.0.0-0
+  checksum: 10c0/17bb0f3c320fadb631ab64951ec0f6e05a62b15418c7864c181645b3205cabd3a8541dd3f497bf06cb1d0e04a3806f6cffee7675c97a87d4aaa04961f334cdcb
+  languageName: node
+  linkType: hard
+
 "@babel/preset-modules@npm:0.1.6-no-external-plugins":
   version: 0.1.6-no-external-plugins
   resolution: "@babel/preset-modules@npm:0.1.6-no-external-plugins"
@@ -1795,6 +1820,21 @@ __metadata:
   languageName: node
   linkType: hard
 
+"@babel/register@npm:^7.24.6":
+  version: 7.29.7
+  resolution: "@babel/register@npm:7.29.7"
+  dependencies:
+    clone-deep: "npm:^4.0.1"
+    find-cache-dir: "npm:^2.0.0"
+    make-dir: "npm:^2.1.0"
+    pirates: "npm:^4.0.6"
+    source-map-support: "npm:^0.5.16"
+  peerDependencies:
+    "@babel/core": ^7.0.0-0
+  checksum: 10c0/154dc72cc354a3d2b7b69d10738f02278774bbf53d3b365f7897035c9f26ad6433b24e81ad277c0fbf33139e08230e0cab3913e91d9325308af532da854765f2
+  languageName: node
+  linkType: hard
+
 "@babel/runtime@npm:^7.0.0, @babel/runtime@npm:^7.1.2, @babel/runtime@npm:^7.12.0, @babel/runtime@npm:^7.12.13, @babel/runtime@npm:^7.12.5, @babel/runtime@npm:^7.17.8, @babel/runtime@npm:^7.18.3, @babel/runtime@npm:^7.22.6, @babel/runtime@npm:^7.5.5, @babel/runtime@npm:^7.8.4, @babel/runtime@npm:^7.8.7":
   version: 7.28.2
   resolution: "@babel/runtime@npm:7.28.2"
@@ -7631,6 +7671,18 @@ __metadata:
   languageName: unknown
   linkType: soft
 
+"@skillsoft/gamut-codemods@workspace:packages/gamut-codemods":
+  version: 0.0.0-use.local
+  resolution: "@skillsoft/gamut-codemods@workspace:packages/gamut-codemods"
+  dependencies:
+    "@skillsoft/gamut": "workspace:*"
+    "@types/jscodeshift": "npm:^17.3.0"
+    jscodeshift: "npm:^17.3.0"
+  bin:
+    gamut-codemods: ./dist/bin.js
+  languageName: unknown
+  linkType: soft
+
 "@skillsoft/gamut-docs@workspace:packages/gamut-docs":
   version: 0.0.0-use.local
   resolution: "@skillsoft/gamut-docs@workspace:packages/gamut-docs"
@@ -7653,25 +7705,24 @@ __metadata:
   languageName: unknown
   linkType: soft
 
-"@skillsoft/gamut-icons@npm:0.0.1, @skillsoft/gamut-icons@workspace:*, @skillsoft/gamut-icons@workspace:packages/gamut-icons":
+"@skillsoft/gamut-icons@npm:^0.0.1, @skillsoft/gamut-icons@workspace:*, @skillsoft/gamut-icons@workspace:packages/gamut-icons":
   version: 0.0.0-use.local
   resolution: "@skillsoft/gamut-icons@workspace:packages/gamut-icons"
   dependencies:
-    "@skillsoft/gamut-styles": "npm:0.0.1"
-    "@skillsoft/variance": "npm:0.0.1"
+    "@skillsoft/gamut-styles": "npm:^0.0.1"
+    "@skillsoft/variance": "npm:^0.0.1"
   peerDependencies:
     "@emotion/react": ^11.4.0
     "@emotion/styled": ^11.3.0
-    lodash: ^4.17.23
     react: ^17.0.2 || ^18.3.0 || ^19.0.0
   languageName: unknown
   linkType: soft
 
-"@skillsoft/gamut-illustrations@npm:0.0.1, @skillsoft/gamut-illustrations@workspace:packages/gamut-illustrations":
+"@skillsoft/gamut-illustrations@npm:^0.0.1, @skillsoft/gamut-illustrations@workspace:packages/gamut-illustrations":
   version: 0.0.0-use.local
   resolution: "@skillsoft/gamut-illustrations@workspace:packages/gamut-illustrations"
   dependencies:
-    "@skillsoft/gamut-styles": "npm:0.0.1"
+    "@skillsoft/gamut-styles": "npm:^0.0.1"
     classnames: "npm:^2.2.5"
   peerDependencies:
     "@emotion/react": ^11.4.0
@@ -7681,12 +7732,12 @@ __metadata:
   languageName: unknown
   linkType: soft
 
-"@skillsoft/gamut-patterns@npm:0.0.1, @skillsoft/gamut-patterns@workspace:packages/gamut-patterns":
+"@skillsoft/gamut-patterns@npm:^0.0.1, @skillsoft/gamut-patterns@workspace:packages/gamut-patterns":
   version: 0.0.0-use.local
   resolution: "@skillsoft/gamut-patterns@workspace:packages/gamut-patterns"
   dependencies:
-    "@skillsoft/gamut-styles": "npm:0.0.1"
-    "@skillsoft/variance": "npm:0.0.1"
+    "@skillsoft/gamut-styles": "npm:^0.0.1"
+    "@skillsoft/variance": "npm:^0.0.1"
     classnames: "npm:^2.2.5"
   peerDependencies:
     "@emotion/react": ^11.4.0
@@ -7696,20 +7747,21 @@ __metadata:
   languageName: unknown
   linkType: soft
 
-"@skillsoft/gamut-styles@npm:0.0.1, @skillsoft/gamut-styles@workspace:*, @skillsoft/gamut-styles@workspace:packages/gamut-styles":
+"@skillsoft/gamut-styles@npm:^0.0.1, @skillsoft/gamut-styles@workspace:*, @skillsoft/gamut-styles@workspace:packages/gamut-styles":
   version: 0.0.0-use.local
   resolution: "@skillsoft/gamut-styles@workspace:packages/gamut-styles"
   dependencies:
     "@emotion/is-prop-valid": "npm:^1.1.0"
-    "@skillsoft/variance": "npm:0.0.1"
+    "@skillsoft/variance": "npm:^0.0.1"
+    csstype: "npm:^3.0.7"
     framer-motion: "npm:^12.0.0"
     get-nonce: "npm:^1.0.0"
+    lodash: "npm:^4.17.23"
     polished: "npm:^4.1.2"
   peerDependencies:
     "@emotion/cache": ^11.4.0
     "@emotion/react": ^11.4.0
     "@emotion/styled": ^11.3.0
-    lodash: ^4.17.23
     react: ^17.0.2 || ^18.3.0 || ^19.0.0
     stylis: ^4.0.7
   languageName: unknown
@@ -7719,8 +7771,8 @@ __metadata:
   version: 0.0.0-use.local
   resolution: "@skillsoft/gamut-tests@workspace:packages/gamut-tests"
   dependencies:
-    "@skillsoft/gamut-styles": "npm:0.0.1"
-    component-test-setup: "npm:*"
+    "@skillsoft/gamut-styles": "npm:^0.0.1"
+    component-test-setup: "npm:^0.3.1"
     lodash: "npm:^4.17.23"
   peerDependencies:
     react: ^17.0.2 || ^18.3.0 || ^19.0.0
@@ -7733,11 +7785,11 @@ __metadata:
   dependencies:
     "@formatjs/intl-locale": "npm:5.3.1"
     "@react-aria/interactions": "npm:3.25.0"
-    "@skillsoft/gamut-icons": "npm:0.0.1"
-    "@skillsoft/gamut-illustrations": "npm:0.0.1"
-    "@skillsoft/gamut-patterns": "npm:0.0.1"
-    "@skillsoft/gamut-styles": "npm:0.0.1"
-    "@skillsoft/variance": "npm:0.0.1"
+    "@skillsoft/gamut-icons": "npm:^0.0.1"
+    "@skillsoft/gamut-illustrations": "npm:^0.0.1"
+    "@skillsoft/gamut-patterns": "npm:^0.0.1"
+    "@skillsoft/gamut-styles": "npm:^0.0.1"
+    "@skillsoft/variance": "npm:^0.0.1"
     "@types/marked": "npm:^4.0.8"
     "@vidstack/react": "npm:~1.12.12"
     classnames: "npm:^2.2.5"
@@ -7785,7 +7837,7 @@ __metadata:
   languageName: unknown
   linkType: soft
 
-"@skillsoft/variance@npm:0.0.1, @skillsoft/variance@workspace:packages/variance":
+"@skillsoft/variance@npm:^0.0.1, @skillsoft/variance@workspace:packages/variance":
   version: 0.0.0-use.local
   resolution: "@skillsoft/variance@workspace:packages/variance"
   dependencies:
@@ -7794,6 +7846,9 @@ __metadata:
   peerDependencies:
     "@emotion/react": "*"
     typescript: ">=4.3.5"
+  peerDependenciesMeta:
+    typescript:
+      optional: true
   languageName: unknown
   linkType: soft
 
@@ -8962,6 +9017,16 @@ __metadata:
   languageName: node
   linkType: hard
 
+"@types/jscodeshift@npm:^17.3.0":
+  version: 17.3.0
+  resolution: "@types/jscodeshift@npm:17.3.0"
+  dependencies:
+    ast-types: "npm:^0.16.1"
+    recast: "npm:^0.23.11"
+  checksum: 10c0/56b889b290f12322b43d74c7434b69cef3e1ca8444e37891e08585f716b1c23f44596f650fb92220a8c6e5776d3dbc7d8ece67e950b6f9e733eee8e712128c73
+  languageName: node
+  linkType: hard
+
 "@types/jsdom@npm:^21.1.7":
   version: 21.1.7
   resolution: "@types/jsdom@npm:21.1.7"
@@ -11542,6 +11607,17 @@ __metadata:
   languageName: node
   linkType: hard
 
+"clone-deep@npm:^4.0.1":
+  version: 4.0.1
+  resolution: "clone-deep@npm:4.0.1"
+  dependencies:
+    is-plain-object: "npm:^2.0.4"
+    kind-of: "npm:^6.0.2"
+    shallow-clone: "npm:^3.0.0"
+  checksum: 10c0/637753615aa24adf0f2d505947a1bb75e63964309034a1cf56ba4b1f30af155201edd38d26ffe26911adaae267a3c138b344a4947d39f5fc1b6d6108125aa758
+  languageName: node
+  linkType: hard
+
 "clone@npm:^1.0.2":
   version: 1.0.4
   resolution: "clone@npm:1.0.4"
@@ -11730,7 +11806,7 @@ __metadata:
   languageName: node
   linkType: hard
 
-"component-test-setup@npm:*, component-test-setup@npm:^0.3.1":
+"component-test-setup@npm:^0.3.1":
   version: 0.3.3
   resolution: "component-test-setup@npm:0.3.3"
   checksum: 10c0/f85ee9a5bf5f65b8440cd6fe03a626e1222b1bba2f29798a4de1c1d7fdbf87397a5ad11e19b0ed20030033c7bede66d2ae6c5bfba426e00b9383adbe0dd0a584
@@ -14115,6 +14191,17 @@ __metadata:
   languageName: node
   linkType: hard
 
+"find-cache-dir@npm:^2.0.0":
+  version: 2.1.0
+  resolution: "find-cache-dir@npm:2.1.0"
+  dependencies:
+    commondir: "npm:^1.0.1"
+    make-dir: "npm:^2.0.0"
+    pkg-dir: "npm:^3.0.0"
+  checksum: 10c0/556117fd0af14eb88fb69250f4bba9e905e7c355c6136dff0e161b9cbd1f5285f761b778565a278da73a130f42eccc723d7ad4c002ae547ed1d698d39779dabb
+  languageName: node
+  linkType: hard
+
 "find-cache-dir@npm:^3.3.1, find-cache-dir@npm:^3.3.2":
   version: 3.3.2
   resolution: "find-cache-dir@npm:3.3.2"
@@ -14164,6 +14251,15 @@ __metadata:
   languageName: node
   linkType: hard
 
+"find-up@npm:^3.0.0":
+  version: 3.0.0
+  resolution: "find-up@npm:3.0.0"
+  dependencies:
+    locate-path: "npm:^3.0.0"
+  checksum: 10c0/2c2e7d0a26db858e2f624f39038c74739e38306dee42b45f404f770db357947be9d0d587f1cac72d20c114deb38aa57316e879eb0a78b17b46da7dab0a3bd6e3
+  languageName: node
+  linkType: hard
+
 "find-up@npm:^4.0.0, find-up@npm:^4.1.0":
   version: 4.1.0
   resolution: "find-up@npm:4.1.0"
@@ -14218,6 +14314,22 @@ __metadata:
   languageName: node
   linkType: hard
 
+"flow-estree@npm:0.331.0":
+  version: 0.331.0
+  resolution: "flow-estree@npm:0.331.0"
+  checksum: 10c0/3e967611d5e4f83a4fde886d90cffe48078702b51258eddcc2f6c2e5d8bca37986df5d890b9f787b0760bb35886bcc3aecd7db6f7db1fff0f9f2ef7b216cd281
+  languageName: node
+  linkType: hard
+
+"flow-parser@npm:0.*":
+  version: 0.331.0
+  resolution: "flow-parser@npm:0.331.0"
+  dependencies:
+    flow-estree: "npm:0.331.0"
+  checksum: 10c0/bfeb7652a3f82c6689b7290ec2e40973c0a665990a199fd160e16854f6f163449e348c296df218cebe303f5e547665a32131e4598a4eeba821ac72fd415e7134
+  languageName: node
+  linkType: hard
+
 "focus-lock@npm:^1.3.6":
   version: 1.3.6
   resolution: "focus-lock@npm:1.3.6"
@@ -16048,6 +16160,15 @@ __metadata:
   languageName: node
   linkType: hard
 
+"is-plain-object@npm:^2.0.4":
+  version: 2.0.4
+  resolution: "is-plain-object@npm:2.0.4"
+  dependencies:
+    isobject: "npm:^3.0.1"
+  checksum: 10c0/f050fdd5203d9c81e8c4df1b3ff461c4bc64e8b5ca383bcdde46131361d0a678e80bcf00b5257646f6c636197629644d53bd8e2375aea633de09a82d57e942f4
+  languageName: node
+  linkType: hard
+
 "is-plain-object@npm:^5.0.0":
   version: 5.0.0
   resolution: "is-plain-object@npm:5.0.0"
@@ -16215,6 +16336,13 @@ __metadata:
   languageName: node
   linkType: hard
 
+"isobject@npm:^3.0.1":
+  version: 3.0.1
+  resolution: "isobject@npm:3.0.1"
+  checksum: 10c0/03344f5064a82f099a0cd1a8a407f4c0d20b7b8485e8e816c39f249e9416b06c322e8dec5b842b6bb8a06de0af9cb48e7bc1b5352f0fadc2f0abac033db3d4db
+  languageName: node
+  linkType: hard
+
 "isomorphic-ws@npm:5.0.0":
   version: 5.0.0
   resolution: "isomorphic-ws@npm:5.0.0"
@@ -16854,6 +16982,39 @@ __metadata:
   languageName: node
   linkType: hard
 
+"jscodeshift@npm:^17.3.0":
+  version: 17.4.0
+  resolution: "jscodeshift@npm:17.4.0"
+  dependencies:
+    "@babel/core": "npm:^7.24.7"
+    "@babel/parser": "npm:^7.24.7"
+    "@babel/plugin-transform-class-properties": "npm:^7.24.7"
+    "@babel/plugin-transform-modules-commonjs": "npm:^7.24.7"
+    "@babel/plugin-transform-nullish-coalescing-operator": "npm:^7.24.7"
+    "@babel/plugin-transform-optional-chaining": "npm:^7.24.7"
+    "@babel/plugin-transform-private-methods": "npm:^7.24.7"
+    "@babel/preset-flow": "npm:^7.24.7"
+    "@babel/preset-typescript": "npm:^7.24.7"
+    "@babel/register": "npm:^7.24.6"
+    flow-parser: "npm:0.*"
+    graceful-fs: "npm:^4.2.4"
+    neo-async: "npm:^2.5.0"
+    picocolors: "npm:^1.0.1"
+    picomatch: "npm:^4.0.2"
+    recast: "npm:^0.23.11"
+    tmp: "npm:^0.2.3"
+    write-file-atomic: "npm:^5.0.1"
+  peerDependencies:
+    "@babel/preset-env": ^7.1.6
+  peerDependenciesMeta:
+    "@babel/preset-env":
+      optional: true
+  bin:
+    jscodeshift: bin/jscodeshift.js
+  checksum: 10c0/ef7b71c22f211cbba8ae96ffd2d3e8af28450d8f703d32050ff9f6cb29042bc163ce7d8239798b672b543bb12203adea20fb4d2c0034acc5440d26cb17c7a42f
+  languageName: node
+  linkType: hard
+
 "jsdom@npm:^26.1.0":
   version: 26.1.0
   resolution: "jsdom@npm:26.1.0"
@@ -17025,7 +17186,7 @@ __metadata:
   languageName: node
   linkType: hard
 
-"kind-of@npm:^6.0.3":
+"kind-of@npm:^6.0.2, kind-of@npm:^6.0.3":
   version: 6.0.3
   resolution: "kind-of@npm:6.0.3"
   checksum: 10c0/61cdff9623dabf3568b6445e93e31376bee1cdb93f8ba7033d86022c2a9b1791a1d9510e026e6465ebd701a6dd2f7b0808483ad8838341ac52f003f512e0b4c4
@@ -17311,6 +17472,16 @@ __metadata:
   languageName: node
   linkType: hard
 
+"locate-path@npm:^3.0.0":
+  version: 3.0.0
+  resolution: "locate-path@npm:3.0.0"
+  dependencies:
+    p-locate: "npm:^3.0.0"
+    path-exists: "npm:^3.0.0"
+  checksum: 10c0/3db394b7829a7fe2f4fbdd25d3c4689b85f003c318c5da4052c7e56eed697da8f1bce5294f685c69ff76e32cba7a33629d94396976f6d05fb7f4c755c5e2ae8b
+  languageName: node
+  linkType: hard
+
 "locate-path@npm:^5.0.0":
   version: 5.0.0
   resolution: "locate-path@npm:5.0.0"
@@ -17539,6 +17710,16 @@ __metadata:
   languageName: node
   linkType: hard
 
+"make-dir@npm:^2.0.0, make-dir@npm:^2.1.0":
+  version: 2.1.0
+  resolution: "make-dir@npm:2.1.0"
+  dependencies:
+    pify: "npm:^4.0.1"
+    semver: "npm:^5.6.0"
+  checksum: 10c0/ada869944d866229819735bee5548944caef560d7a8536ecbc6536edca28c72add47cc4f6fc39c54fb25d06b58da1f8994cf7d9df7dadea047064749efc085d8
+  languageName: node
+  linkType: hard
+
 "make-dir@npm:^3.0.0, make-dir@npm:^3.0.2":
   version: 3.1.0
   resolution: "make-dir@npm:3.1.0"
@@ -18876,7 +19057,7 @@ __metadata:
   languageName: node
   linkType: hard
 
-"neo-async@npm:^2.6.2":
+"neo-async@npm:^2.5.0, neo-async@npm:^2.6.2":
   version: 2.6.2
   resolution: "neo-async@npm:2.6.2"
   checksum: 10c0/c2f5a604a54a8ec5438a342e1f356dff4bc33ccccdb6dc668d94fe8e5eccfc9d2c2eea6064b0967a767ba63b33763f51ccf2cd2441b461a7322656c1f06b3f5d
@@ -19637,7 +19818,7 @@ __metadata:
   languageName: node
   linkType: hard
 
-"p-limit@npm:^2.2.0":
+"p-limit@npm:^2.0.0, p-limit@npm:^2.2.0":
   version: 2.3.0
   resolution: "p-limit@npm:2.3.0"
   dependencies:
@@ -19664,6 +19845,15 @@ __metadata:
   languageName: node
   linkType: hard
 
+"p-locate@npm:^3.0.0":
+  version: 3.0.0
+  resolution: "p-locate@npm:3.0.0"
+  dependencies:
+    p-limit: "npm:^2.0.0"
+  checksum: 10c0/7b7f06f718f19e989ce6280ed4396fb3c34dabdee0df948376483032f9d5ec22fdf7077ec942143a75827bb85b11da72016497fc10dac1106c837ed593969ee8
+  languageName: node
+  linkType: hard
+
 "p-locate@npm:^4.1.0":
   version: 4.1.0
   resolution: "p-locate@npm:4.1.0"
@@ -19893,6 +20083,13 @@ __metadata:
   languageName: node
   linkType: hard
 
+"path-exists@npm:^3.0.0":
+  version: 3.0.0
+  resolution: "path-exists@npm:3.0.0"
+  checksum: 10c0/17d6a5664bc0a11d48e2b2127d28a0e58822c6740bde30403f08013da599182289c56518bec89407e3f31d3c2b6b296a4220bc3f867f0911fee6952208b04167
+  languageName: node
+  linkType: hard
+
 "path-exists@npm:^4.0.0":
   version: 4.0.0
   resolution: "path-exists@npm:4.0.0"
@@ -20011,6 +20208,13 @@ __metadata:
   languageName: node
   linkType: hard
 
+"pify@npm:^4.0.1":
+  version: 4.0.1
+  resolution: "pify@npm:4.0.1"
+  checksum: 10c0/6f9d404b0d47a965437403c9b90eca8bb2536407f03de165940e62e72c8c8b75adda5516c6b9b23675a5877cc0bcac6bdfb0ef0e39414cd2476d5495da40e7cf
+  languageName: node
+  linkType: hard
+
 "pinkie-promise@npm:^2.0.0":
   version: 2.0.1
   resolution: "pinkie-promise@npm:2.0.1"
@@ -20027,13 +20231,22 @@ __metadata:
   languageName: node
   linkType: hard
 
-"pirates@npm:^4.0.7":
+"pirates@npm:^4.0.6, pirates@npm:^4.0.7":
   version: 4.0.7
   resolution: "pirates@npm:4.0.7"
   checksum: 10c0/a51f108dd811beb779d58a76864bbd49e239fa40c7984cd11596c75a121a8cc789f1c8971d8bb15f0dbf9d48b76c05bb62fcbce840f89b688c0fa64b37e8478a
   languageName: node
   linkType: hard
 
+"pkg-dir@npm:^3.0.0":
+  version: 3.0.0
+  resolution: "pkg-dir@npm:3.0.0"
+  dependencies:
+    find-up: "npm:^3.0.0"
+  checksum: 10c0/902a3d0c1f8ac43b1795fa1ba6ffeb37dfd53c91469e969790f6ed5e29ff2bdc50b63ba6115dc056d2efb4a040aa2446d512b3804bdafdf302f734fb3ec21847
+  languageName: node
+  linkType: hard
+
 "pkg-dir@npm:^4.1.0, pkg-dir@npm:^4.2.0":
   version: 4.2.0
   resolution: "pkg-dir@npm:4.2.0"
@@ -21007,16 +21220,16 @@ __metadata:
   languageName: node
   linkType: hard
 
-"recast@npm:^0.23.5":
-  version: 0.23.9
-  resolution: "recast@npm:0.23.9"
+"recast@npm:^0.23.11, recast@npm:^0.23.5":
+  version: 0.23.21
+  resolution: "recast@npm:0.23.21"
   dependencies:
     ast-types: "npm:^0.16.1"
     esprima: "npm:~4.0.0"
     source-map: "npm:~0.6.1"
     tiny-invariant: "npm:^1.3.3"
     tslib: "npm:^2.0.1"
-  checksum: 10c0/65d6e780351f0180ea4fe5c9593ac18805bf2b79977f5bedbbbf26f6d9b619ed0f6992c1bf9e06dd40fca1aea727ad6d62463cfb5d3a33342ee5a6e486305fe5
+  checksum: 10c0/afee4673fda5a95b0db8199a3f75c6f675269f00328a3673f241a6088c99b5a58f7082b6cff683456a182e3302bfb57313ebb1c2073228b260724b0993ff1f9a
   languageName: node
   linkType: hard
 
@@ -22075,6 +22288,15 @@ __metadata:
   languageName: node
   linkType: hard
 
+"semver@npm:^5.6.0":
+  version: 5.7.2
+  resolution: "semver@npm:5.7.2"
+  bin:
+    semver: bin/semver
+  checksum: 10c0/e4cf10f86f168db772ae95d86ba65b3fd6c5967c94d97c708ccb463b778c2ee53b914cd7167620950fc07faf5a564e6efe903836639e512a1aa15fbc9667fa25
+  languageName: node
+  linkType: hard
+
 "semver@npm:^6.0.0, semver@npm:^6.3.1":
   version: 6.3.1
   resolution: "semver@npm:6.3.1"
@@ -22177,6 +22399,15 @@ __metadata:
   languageName: node
   linkType: hard
 
+"shallow-clone@npm:^3.0.0":
+  version: 3.0.1
+  resolution: "shallow-clone@npm:3.0.1"
+  dependencies:
+    kind-of: "npm:^6.0.2"
+  checksum: 10c0/7bab09613a1b9f480c85a9823aebec533015579fa055ba6634aa56ba1f984380670eaf33b8217502931872aa1401c9fcadaa15f9f604d631536df475b05bcf1e
+  languageName: node
+  linkType: hard
+
 "shallowequal@npm:^1.1.0":
   version: 1.1.0
   resolution: "shallowequal@npm:1.1.0"
@@ -22635,7 +22866,7 @@ __metadata:
   languageName: node
   linkType: hard
 
-"source-map-support@npm:^0.5.21, source-map-support@npm:~0.5.20":
+"source-map-support@npm:^0.5.16, source-map-support@npm:^0.5.21, source-map-support@npm:~0.5.20":
   version: 0.5.21
   resolution: "source-map-support@npm:0.5.21"
   dependencies:
@@ -23180,9 +23411,9 @@ __metadata:
   linkType: hard
 
 "stylis@npm:^4.3.0":
-  version: 4.3.4
-  resolution: "stylis@npm:4.3.4"
-  checksum: 10c0/4899c2674cd2538e314257abd1ba7ea3c2176439659ddac6593c78192cfd4a06f814a0a4fc69bc7f8fcc6b997e13d383dd9b578b71074746a0fb86045a83e42d
+  version: 4.4.0
+  resolution: "stylis@npm:4.4.0"
+  checksum: 10c0/259be096d90dfbfe903c8656dcb7591e52a421e577e950ef42ebd9ca02f387623a1165dd08761492fb6e92a7a562d62a53a694a10b0a2f6dcd7a0db107b4bf55
   languageName: node
   linkType: hard
 
@@ -23591,10 +23822,10 @@ __metadata:
   languageName: node
   linkType: hard
 
-"tmp@npm:~0.2.1":
-  version: 0.2.3
-  resolution: "tmp@npm:0.2.3"
-  checksum: 10c0/3e809d9c2f46817475b452725c2aaa5d11985cf18d32a7a970ff25b568438e2c076c2e8609224feef3b7923fa9749b74428e3e634f6b8e520c534eef2fd24125
+"tmp@npm:^0.2.3, tmp@npm:~0.2.1":
+  version: 0.2.7
+  resolution: "tmp@npm:0.2.7"
+  checksum: 10c0/59eb55584f2f07210d3231b6a1f6b5c2b9794d8a7b509c8ee867ed2acad6d2245ee2448b7937b676ffbff3155a70077edde8a69f9d7cf0f90c86a62e8910c357
   languageName: node
   linkType: hard