feat(ui-codemods): add codemod to support versioned import updates

[joyenjoyer]

Summary

• Adds updateInstUIImportVersions jscodeshift codemod that rewrites @instructure/*
  import paths to a specific version subpath (e.g. @instructure/ui-buttons/v11_7)
• Handles mixed imports (versioned components alongside non-versioned utilities/types) by splitting
  them into two declarations rather than blindly rewriting everything
• Adds a generateVersionedExports script that reads the latest version summary file in
  @instructure/ui to auto-generate the list of known versioned components; wired
  into prepare-build so it stays up to date

Test Plan

• Run unit tests with pnpm run test:vitest ui-codemods
• Check the new section in the upgrade guide to learn how to use the new codemod
• Test the new commands manually

Either you test the new commands in a chosen path or I recommend using the canvas-lms project. Check out the canvas repo from this link: https://github.com/instructure/canvas-lms

Diagnose command

Diagnose — all versioned components (no files written)

• Verify output lists @instructure imports with their version ([v11_7 or v11_6] for
  already-migrated files, [oldest] for legacy unversioned JSX files)
• Verify git status shows no changes

npx jscodeshift@latest -t /instructure-ui/packages/ui-codemods/lib/updateInstUIImportVersions.ts /canvas-lms --extensions=ts,tsx --ignore-pattern="**/node_modules/**" --ignore-pattern="**/*.d.ts" --diagnose=true

Diagnose — filter to specific components:

• Verify only Button/Alert import lines appear in output

npx jscodeshift@latest -t /instructure-ui/packages/ui-codemods/lib/updateInstUIImportVersions.ts /canvas-lms --extensions=ts,tsx --ignore-pattern="**/node_modules/**" --ignore-pattern="**/*.d.ts" --diagnose=true --components=Button,Alert                                                                          

Update command

Update — all versioned components to v11.7:

• Spot-check a legacy file whether an unversioned component got updated to v11_7 (for example unversioned @instructure/ui-buttons → @instructure/ui-buttons/v11_7)

npx jscodeshift@latest -t /instructure-ui/packages/ui-codemods/lib/updateInstUIImportVersions.ts /canvas-lms --extensions=ts,tsx --ignore-pattern="**/node_modules/**" --ignore-pattern="**/*.d.ts" --versionTo=v11.7 --usePrettier=false                                                                    

Update — only imports pinned to a specific version (--versionFrom):

• There is no component imported from v11.6 yet, so change an import path manually in a canvas codebase file (for example import {View} from '@instructure/ui-view' to import {View} from '@instructure/ui-view/v11_6')
• Check whether the command updates the manually changed line so the version suffix is changed to v11_7

npx jscodeshift@latest -t /instructure-ui/packages/ui-codemods/lib/updateInstUIImportVersions.ts /canvas-lms --extensions=ts,tsx --ignore-pattern="**/node_modules/**" --ignore-pattern="**/*.d.ts" versionFrom=v11.6 --versionTo=v11.7 --usePrettier=false                                                                    

Update — specific components only (--components):

• Verify only files importing Button or Alert are rewritten; all other packages untouched

npx jscodeshift@latest -t /instructure-ui/packages/ui-codemods/lib/updateInstUIImportVersions.ts /canvas-lms --extensions=ts,tsx --ignore-pattern="**/node_modules/**" --ignore-pattern="**/*.d.ts" --versionTo=v11.7 --components=Button,Alert --usePrettier=false                                                                    

[github-actions]

PR Preview Action v1.8.1
Preview removed because the pull request was closed.
2026-04-23 08:47 UTC

[matyasf]

See my comments. Overall it looks OK

[joyenjoyer]

Linter complained about this, I removed it.

[matyasf]

looks good!