@grafana/create-plugin 6.2.0-canary.2233.19133609453.0 → 6.2.0-canary.2283.19225164741.0

package/CHANGELOG.md

@@ -1,3 +1,26 @@
+# v6.1.8 (Fri Nov 07 2025)
+
+### Release Notes
+
+#### chore(deps): update grafana patch dependencies ([#2217](https://github.com/grafana/plugin-tools/pull/2217))
+
+<details>
+<summary>grafana/grafana (@&#8203;grafana/data)</summary>
+
+---
+
+#### 🐛 Bug Fix
+
+- Create plugin: fix permissions issue in cp-update workflow [#2281](https://github.com/grafana/plugin-tools/pull/2281) ([@jackw](https://github.com/jackw))
+- chore(deps): update grafana patch dependencies [#2217](https://github.com/grafana/plugin-tools/pull/2217) ([@renovate-sh-app[bot]](https://github.com/renovate-sh-app[bot]))
+
+#### Authors: 2
+
+- [@renovate-sh-app[bot]](https://github.com/renovate-sh-app[bot])
+- Jack Westbrook ([@jackw](https://github.com/jackw))
+
+---
+
 # v6.1.7 (Mon Nov 03 2025)
 
 :tada: This release contains work from a new contributor! :tada:

package/CONTRIBUTING.md

@@ -222,6 +222,9 @@ describe('Migration - append profile to webpack', () => {
 });
 ```
 
+> [!TIP]
+> A lot of the code used by migrations has debug messaging. You can output this in tests to help debugging by using `DEBUG="create-plugin:migrations" npm run test -w @grafana/create-plugin`
+
 #### How to test a migration locally
 
 To test a migration locally you'll need a plugin to test on.

package/dist/bin/run.js

@@ -4,7 +4,6 @@ import { update } from '../commands/update.command.js';
 import { migrate } from '../commands/migrate.command.js';
 import { version } from '../commands/version.command.js';
 import { provisioning } from '../commands/provisioning.command.js';
-import { add } from '../commands/add.command.js';
 import { isUnsupportedPlatform } from '../utils/utils.os.js';
 import { argv, commandName } from '../utils/utils.cli.js';
 import { output } from '../utils/utils.console.js';
@@ -22,8 +21,7 @@ const commands = {
   generate,
   update,
   version,
-  provisioning,
-  add
+  provisioning
 };
 const command = commands[commandName] || "generate";
 command(argv);

package/dist/commands/update.command.js

@@ -1,4 +1,4 @@
-import { getMigrationsToRun, runMigrations } from '../codemods/migrations/manager.js';
+import { getMigrationsToRun, runMigrations } from '../migrations/manager.js';
 import { getPackageManagerWithFallback, getPackageManagerExecCmd, getPackageManagerSilentInstallCmd } from '../utils/utils.packageManager.js';
 import { lt, gte } from 'semver';
 import { isGitDirectory, isGitDirectoryClean } from '../utils/utils.git.js';

package/dist/{codemods → migrations}/context.js

@@ -1,11 +1,10 @@
 import { accessSync, constants, readFileSync, readdirSync } from 'node:fs';
 import { join, dirname, normalize, relative } from 'node:path';
-import { debug } from '../utils/utils.cli.js';
+import { migrationsDebug } from './utils.js';
 
 var __defProp = Object.defineProperty;
 var __defNormalProp = (obj, key, value) => key in obj ? __defProp(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
 var __publicField = (obj, key, value) => __defNormalProp(obj, typeof key !== "symbol" ? key + "" : key, value);
-const codemodsDebug = debug.extend("codemods");
 class Context {
   constructor(basePath) {
     __publicField(this, "files", {});
@@ -42,7 +41,7 @@ class Context {
     if (originalContent !== content) {
       this.files[path] = { content, changeType: "update" };
     } else {
-      codemodsDebug(`Context.updateFile() - no updates for ${filePath}`);
+      migrationsDebug(`Context.updateFile() - no updates for ${filePath}`);
     }
   }
   doesFileExist(filePath) {

package/dist/{codemods/migrations → migrations}/manager.js

@@ -1,12 +1,11 @@
-import defaultMigrations from './migrations.js';
-import { formatFiles, flushChanges, installNPMDependencies } from '../utils.js';
 import { gte, satisfies } from 'semver';
-import { migrationsDebug, printChanges } from './utils.js';
-import { CURRENT_APP_VERSION } from '../../utils/utils.version.js';
-import { Context } from '../context.js';
-import { gitCommitNoVerify } from '../../utils/utils.git.js';
-import { output } from '../../utils/utils.console.js';
-import { setRootConfig } from '../../utils/utils.config.js';
+import { Context } from './context.js';
+import defaultMigrations from './migrations.js';
+import { migrationsDebug, formatFiles, flushChanges, printChanges, installNPMDependencies } from './utils.js';
+import { gitCommitNoVerify } from '../utils/utils.git.js';
+import { setRootConfig } from '../utils/utils.config.js';
+import { output } from '../utils/utils.console.js';
+import { CURRENT_APP_VERSION } from '../utils/utils.version.js';
 
 function getMigrationsToRun(fromVersion, toVersion, migrations = defaultMigrations.migrations) {
   const semverRange = `${fromVersion} - ${toVersion}`;

package/dist/{codemods/migrations → migrations}/migrations.js

@@ -1,4 +1,4 @@
-import { LEGACY_UPDATE_CUTOFF_VERSION } from '../../constants.js';
+import { LEGACY_UPDATE_CUTOFF_VERSION } from '../constants.js';
 
 var defaultMigrations = {
   migrations: {
@@ -21,9 +21,12 @@ var defaultMigrations = {
       version: LEGACY_UPDATE_CUTOFF_VERSION,
       description: "Migrate eslint config to flat config format and update devDependencies to latest versions.",
       migrationScript: "./scripts/004-eslint9-flat-config.js"
+    },
+    "005-react-18-3": {
+      version: "6.1.7-beta.1",
+      description: "Update React and ReactDOM 18.x versions to ^18.3.0 to surface React 19 compatibility issues.",
+      migrationScript: "./scripts/005-react-18-3.js"
     }
-    // Do not use LEGACY_UPDATE_CUTOFF_VERSION for new migrations. It is only used above to force migrations to run
-    // for those written before the switch to updates as migrations.
   }
 };
 

package/dist/{codemods/migrations → migrations}/scripts/003-update-eslint-deprecation-rule.js

@@ -1,4 +1,4 @@
-import { addDependenciesToPackageJson, removeDependenciesFromPackageJson } from '../../utils.js';
+import { addDependenciesToPackageJson, removeDependenciesFromPackageJson } from '../utils.js';
 
 function migrate(context) {
   if (context.doesFileExist(".config/.eslintrc") && context.doesFileExist("package.json")) {

package/dist/{codemods/migrations → migrations}/scripts/004-eslint9-flat-config.js

@@ -4,8 +4,7 @@ import { parse } from 'jsonc-parser';
 import minimist from 'minimist';
 import { resolve, dirname, relative } from 'node:path';
 import * as recast from 'recast';
-import { addDependenciesToPackageJson } from '../../utils.js';
-import { migrationsDebug } from '../utils.js';
+import { addDependenciesToPackageJson, migrationsDebug } from '../utils.js';
 
 const { builders } = recast.types;
 const legacyKeysToCopy = ["rules", "settings"];

package/dist/migrations/scripts/005-react-18-3.js

@@ -0,0 +1,20 @@
+import { isVersionGreater, addDependenciesToPackageJson } from '../utils.js';
+
+function migrate(context) {
+  if (context.doesFileExist("package.json")) {
+    const packageJson = JSON.parse(context.getFile("package.json") || "{}");
+    if (packageJson.dependencies?.react) {
+      if (isVersionGreater(packageJson.dependencies.react, "18.0.0", true)) {
+        addDependenciesToPackageJson(context, { react: "^18.3.0" }, { "@types/react": "^18.3.0" });
+      }
+    }
+    if (packageJson.dependencies?.["react-dom"]) {
+      if (isVersionGreater(packageJson.dependencies["react-dom"], "18.0.0", true)) {
+        addDependenciesToPackageJson(context, { "react-dom": "^18.3.0" }, { "@types/react-dom": "^18.3.0" });
+      }
+    }
+  }
+  return context;
+}
+
+export { migrate as default };

package/dist/{codemods → migrations}/utils.js

@@ -1,13 +1,14 @@
 import { join, dirname } from 'node:path';
 import { createRequire } from 'node:module';
 import { mkdirSync, writeFileSync, rmSync } from 'node:fs';
+import { debug } from '../utils/utils.cli.js';
 import chalk from 'chalk';
 import { output } from '../utils/utils.console.js';
 import { getPackageManagerWithFallback, getPackageManagerSilentInstallCmd } from '../utils/utils.packageManager.js';
 import { execSync } from 'node:child_process';
-import { gt, clean, coerce } from 'semver';
+import { gte, gt, clean, coerce } from 'semver';
 
-function printChanges(context, key, meta) {
+function printChanges(context, key, migration) {
   const changes = context.listChanges();
   const lines = [];
   for (const [filePath, { changeType }] of Object.entries(changes)) {
@@ -20,7 +21,7 @@ function printChanges(context, key, meta) {
     }
   }
   output.addHorizontalLine("gray");
-  output.logSingleLine(`${key} (${meta.description})`);
+  output.logSingleLine(`${key} (${migration.description})`);
   if (lines.length === 0) {
     output.logSingleLine("No changes were made");
   } else {
@@ -42,6 +43,7 @@ function flushChanges(context) {
     }
   }
 }
+const migrationsDebug = debug.extend("migrations");
 async function formatFiles(context) {
   let prettier;
   const require = createRequire(import.meta.url);
@@ -118,10 +120,14 @@ function addDependenciesToPackageJson(context, dependencies, devDependencies = {
     if (currentDeps[dep]) {
       if (isVersionGreater(newVersion, currentDeps[dep])) {
         currentDeps[dep] = newVersion;
+      } else {
+        migrationsDebug("would downgrade dependency %s to %s", dep, newVersion);
       }
     } else if (currentDevDeps[dep]) {
       if (isVersionGreater(newVersion, currentDevDeps[dep])) {
         currentDevDeps[dep] = newVersion;
+      } else {
+        migrationsDebug("would downgrade devDependency %s to %s", dep, newVersion);
       }
     } else {
       currentDeps[dep] = newVersion;
@@ -131,10 +137,14 @@ function addDependenciesToPackageJson(context, dependencies, devDependencies = {
     if (currentDeps[dep]) {
       if (isVersionGreater(newVersion, currentDeps[dep])) {
         currentDeps[dep] = newVersion;
+      } else {
+        migrationsDebug("would downgrade dependency %s to %s", dep, newVersion);
       }
     } else if (currentDevDeps[dep]) {
       if (isVersionGreater(newVersion, currentDevDeps[dep])) {
         currentDevDeps[dep] = newVersion;
+      } else {
+        migrationsDebug("would downgrade devDependency %s to %s", dep, newVersion);
       }
     } else {
       currentDevDeps[dep] = newVersion;
@@ -151,6 +161,7 @@ function addDependenciesToPackageJson(context, dependencies, devDependencies = {
     ...Object.keys(sortedDeps).length > 0 && { dependencies: sortedDeps },
     ...Object.keys(sortedDevDeps).length > 0 && { devDependencies: sortedDevDeps }
   };
+  migrationsDebug("updated package.json", updatedPackageJson);
   context.updateFile(packageJsonPath, JSON.stringify(updatedPackageJson, null, 2));
 }
 function removeDependenciesFromPackageJson(context, dependencies, devDependencies = [], packageJsonPath = "package.json") {
@@ -159,18 +170,21 @@ function removeDependenciesFromPackageJson(context, dependencies, devDependencie
   for (const dep of dependencies) {
     if (currentPackageJson.dependencies?.[dep]) {
       delete currentPackageJson.dependencies[dep];
+      migrationsDebug("removed dependency %s", dep);
       hasChanges = true;
     }
   }
   for (const dep of devDependencies) {
     if (currentPackageJson.devDependencies?.[dep]) {
       delete currentPackageJson.devDependencies[dep];
+      migrationsDebug("removed devDependency %s", dep);
       hasChanges = true;
     }
   }
   if (!hasChanges) {
     return;
   }
+  migrationsDebug("updated package.json", currentPackageJson);
   context.updateFile(packageJsonPath, JSON.stringify(currentPackageJson, null, 2));
 }
 const DIST_TAGS = {
@@ -178,7 +192,7 @@ const DIST_TAGS = {
   next: 1,
   latest: 0
 };
-function isVersionGreater(incomingVersion, existingVersion) {
+function isVersionGreater(incomingVersion, existingVersion, orEqualTo = false) {
   const incomingIsDistTag = incomingVersion in DIST_TAGS;
   const existingIsDistTag = existingVersion in DIST_TAGS;
   if (incomingIsDistTag && existingIsDistTag) {
@@ -192,6 +206,9 @@ function isVersionGreater(incomingVersion, existingVersion) {
   if (!incomingSemver || !existingSemver) {
     return true;
   }
+  if (orEqualTo) {
+    return gte(incomingSemver, existingSemver);
+  }
   return gt(incomingSemver, existingSemver);
 }
 function cleanSemver(version) {
@@ -201,4 +218,4 @@ function sortObjectByKeys(obj) {
   return Object.keys(obj).sort().reduce((acc, key) => ({ ...acc, [key]: obj[key] }), {});
 }
 
-export { addDependenciesToPackageJson, flushChanges, formatFiles, installNPMDependencies, isVersionGreater, printChanges, readJsonFile, removeDependenciesFromPackageJson };
+export { addDependenciesToPackageJson, flushChanges, formatFiles, installNPMDependencies, isVersionGreater, migrationsDebug, printChanges, readJsonFile, removeDependenciesFromPackageJson };

package/dist/utils/utils.config.js

@@ -8,9 +8,6 @@ import path from 'node:path';
 import { writeFile } from 'node:fs/promises';
 import { EOL } from 'node:os';
 
-function isFeatureEnabled(features, featureName) {
-  return features[featureName] === true;
-}
 let hasShownConfigWarnings = false;
 function getConfig(workDir = process.cwd()) {
   const rootConfig = getRootConfig(workDir);
@@ -95,17 +92,5 @@ async function setRootConfig(configOverride = {}) {
   await writeFile(rootConfigPath, JSON.stringify(updatedConfig, null, 2) + EOL);
   return updatedConfig;
 }
-async function setFeatureFlag(featureName, enabled = true) {
-  const userConfig = getUserConfig() || { features: {} };
-  const userConfigPath = path.resolve(process.cwd(), ".cprc.json");
-  const updatedConfig = {
-    ...userConfig,
-    features: {
-      ...userConfig.features,
-      [featureName]: enabled
-    }
-  };
-  await writeFile(userConfigPath, JSON.stringify(updatedConfig, null, 2) + EOL);
-}
 
-export { getConfig, isFeatureEnabled, setFeatureFlag, setRootConfig };
+export { getConfig, setRootConfig };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@grafana/create-plugin",
-  "version": "6.2.0-canary.2233.19133609453.0",
+  "version": "6.2.0-canary.2283.19225164741.0",
   "repository": {
     "directory": "packages/create-plugin",
     "url": "https://github.com/grafana/plugin-tools"
@@ -59,5 +59,5 @@
   "engines": {
     "node": ">=20"
   },
-  "gitHead": "d84f5bcb2be40efa1f28ad4a86b52a8a1566e85c"
+  "gitHead": "2771e041152fce899b6ecbbf3a37dce085a4a563"
 }

package/src/bin/run.ts

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 
 import minimist from 'minimist';
-import { add, generate, update, migrate, version, provisioning } from '../commands/index.js';
+import { generate, update, migrate, version, provisioning } from '../commands/index.js';
 import { isUnsupportedPlatform } from '../utils/utils.os.js';
 import { argv, commandName } from '../utils/utils.cli.js';
 import { output } from '../utils/utils.console.js';
@@ -23,7 +23,6 @@ const commands: Record<string, (argv: minimist.ParsedArgs) => void> = {
   update,
   version,
   provisioning,
-  add,
 };
 const command = commands[commandName] || 'generate';
 

package/src/commands/index.ts

@@ -3,4 +3,3 @@ export * from './update.command.js';
 export * from './migrate.command.js';
 export * from './version.command.js';
 export * from './provisioning.command.js';
-export * from './add.command.js';

package/src/commands/update.command.ts

@@ -1,4 +1,4 @@
-import { getMigrationsToRun, runMigrations } from '../codemods/migrations/manager.js';
+import { getMigrationsToRun, runMigrations } from '../migrations/manager.js';
 import {
   getPackageManagerExecCmd,
   getPackageManagerSilentInstallCmd,

package/src/{codemods → migrations}/context.test.ts

@@ -3,7 +3,7 @@ import { Context } from './context.js';
 describe('Context', () => {
   describe('getFile', () => {
     it('should read a file from the file system', () => {
-      const context = new Context(`${__dirname}/migrations/fixtures`);
+      const context = new Context(`${__dirname}/fixtures`);
       const content = context.getFile('foo/bar.ts');
       expect(content).toEqual("console.log('foo/bar.ts');\n");
     });
@@ -16,14 +16,14 @@ describe('Context', () => {
     });
 
     it('should get a file that was updated in the current context', () => {
-      const context = new Context(`${__dirname}/migrations/fixtures`);
+      const context = new Context(`${__dirname}/fixtures`);
       context.updateFile('foo/bar.ts', 'content');
       const content = context.getFile('foo/bar.ts');
       expect(content).toEqual('content');
     });
 
     it('should not return a file that was marked for deletion', () => {
-      const context = new Context(`${__dirname}/migrations/fixtures`);
+      const context = new Context(`${__dirname}/fixtures`);
       context.deleteFile('foo/bar.ts');
       const content = context.getFile('foo/bar.ts');
       expect(content).toEqual(undefined);
@@ -77,7 +77,7 @@ describe('Context', () => {
 
   describe('renameFile', () => {
     it('should rename a file', () => {
-      const context = new Context(`${__dirname}/migrations/fixtures`);
+      const context = new Context(`${__dirname}/fixtures`);
       context.renameFile('foo/bar.ts', 'new-file.txt');
       expect(context.listChanges()).toEqual({
         'new-file.txt': { content: "console.log('foo/bar.ts');\n", changeType: 'add' },
@@ -102,20 +102,20 @@ describe('Context', () => {
 
   describe('readDir', () => {
     it('should read the directory', () => {
-      const context = new Context(`${__dirname}/migrations/fixtures`);
+      const context = new Context(`${__dirname}/fixtures`);
       const files = context.readDir('foo');
       expect(files).toEqual(['foo/bar.ts', 'foo/baz.ts']);
     });
 
     it('should filter out deleted files', () => {
-      const context = new Context(`${__dirname}/migrations/fixtures`);
+      const context = new Context(`${__dirname}/fixtures`);
       context.deleteFile('foo/bar.ts');
       const files = context.readDir('foo');
       expect(files).toEqual(['foo/baz.ts']);
     });
 
     it('should include files that are only added to the context', () => {
-      const context = new Context(`${__dirname}/migrations/fixtures`);
+      const context = new Context(`${__dirname}/fixtures`);
       context.addFile('foo/foo.txt', '');
       const files = context.readDir('foo');
       expect(files).toEqual(['foo/bar.ts', 'foo/baz.ts', 'foo/foo.txt']);
@@ -124,7 +124,7 @@ describe('Context', () => {
 
   describe('normalisePath', () => {
     it('should normalise the path', () => {
-      const context = new Context(`${__dirname}/migrations/fixtures`);
+      const context = new Context(`${__dirname}/fixtures`);
       expect(context.normalisePath('foo/bar.ts')).toEqual('foo/bar.ts');
       expect(context.normalisePath('./foo/bar.ts')).toEqual('foo/bar.ts');
       expect(context.normalisePath('/foo/bar.ts')).toEqual('foo/bar.ts');
@@ -133,12 +133,12 @@ describe('Context', () => {
 
   describe('hasChanges', () => {
     it('should return FALSE if the context has no changes', () => {
-      const context = new Context(`${__dirname}/migrations/fixtures`);
+      const context = new Context(`${__dirname}/fixtures`);
       expect(context.hasChanges()).toEqual(false);
     });
 
     it('should return TRUE if the context has changes', () => {
-      const context = new Context(`${__dirname}/migrations/fixtures`);
+      const context = new Context(`${__dirname}/fixtures`);
 
       context.addFile('foo.ts', '');
 

package/src/{codemods → migrations}/context.ts

@@ -1,8 +1,6 @@
 import { constants, accessSync, readFileSync, readdirSync } from 'node:fs';
 import { relative, normalize, join, dirname } from 'node:path';
-import { debug } from '../utils/utils.cli.js';
-
-const codemodsDebug = debug.extend('codemods');
+import { migrationsDebug } from './utils.js';
 
 export type ContextFile = Record<
   string,
@@ -60,7 +58,7 @@ export class Context {
     if (originalContent !== content) {
       this.files[path] = { content, changeType: 'update' };
     } else {
-      codemodsDebug(`Context.updateFile() - no updates for ${filePath}`);
+      migrationsDebug(`Context.updateFile() - no updates for ${filePath}`);
     }
   }
 

package/src/{codemods/migrations → migrations}/manager.test.ts

@@ -1,27 +1,22 @@
-import { flushChanges, formatFiles } from '../utils.js';
+import { vi } from 'vitest';
 import { getMigrationsToRun, runMigration, runMigrations } from './manager.js';
-
-import { Context } from '../context.js';
-import { MigrationMeta } from './migrations.js';
-import { gitCommitNoVerify } from '../../utils/utils.git.js';
 import migrationFixtures from './fixtures/migrations.js';
-import { printChanges } from './utils.js';
-import { setRootConfig } from '../../utils/utils.config.js';
-import { vi } from 'vitest';
+import { Context } from './context.js';
+import { gitCommitNoVerify } from '../utils/utils.git.js';
+import { flushChanges, printChanges, formatFiles } from './utils.js';
+import { setRootConfig } from '../utils/utils.config.js';
+import { MigrationMeta } from './migrations.js';
 
 vi.mock('./utils.js', () => ({
+  flushChanges: vi.fn(),
   printChanges: vi.fn(),
   migrationsDebug: vi.fn(),
-}));
-
-vi.mock('../utils.js', () => ({
-  flushChanges: vi.fn(),
   formatFiles: vi.fn(),
   installNPMDependencies: vi.fn(),
 }));
 
 // Silence terminal output during tests.
-vi.mock('../../utils/utils.console.js', () => ({
+vi.mock('../utils/utils.console.js', () => ({
   output: {
     log: vi.fn(),
     addHorizontalLine: vi.fn(),
@@ -30,10 +25,10 @@ vi.mock('../../utils/utils.console.js', () => ({
   },
 }));
 
-vi.mock('../../utils/utils.config.js', () => ({
+vi.mock('../utils/utils.config.js', () => ({
   setRootConfig: vi.fn(),
 }));
-vi.mock('../../utils/utils.git.js', () => ({
+vi.mock('../utils/utils.git.js', () => ({
   gitCommitNoVerify: vi.fn(),
 }));
 
@@ -122,14 +117,14 @@ describe('Migrations', () => {
       const mockContext = new Context('/virtual');
       const migrationFn = vi.fn().mockResolvedValue(mockContext);
 
-      vi.doMock('./test-migration.js', () => ({
+      vi.doMock('virtual-test-migration.js', () => ({
         default: migrationFn,
       }));
 
       const migration: MigrationMeta = {
         version: '1.0.0',
         description: 'test migration',
-        migrationScript: './test-migration.js',
+        migrationScript: 'virtual-test-migration.js',
       };
 
       const result = await runMigration(migration, mockContext);
@@ -144,10 +139,10 @@ describe('Migrations', () => {
     const migrationTwoFn = vi.fn();
     const consoleMock = vi.spyOn(console, 'log').mockImplementation(() => undefined);
 
-    vi.doMock('./migration-one.js', () => ({
+    vi.doMock('virtual-test-migration.js', async () => ({
       default: migrationOneFn,
     }));
-    vi.doMock('./migration-two.js', () => ({
+    vi.doMock('virtual-test-migration2.js', async () => ({
       default: migrationTwoFn,
     }));
 
@@ -155,12 +150,12 @@ describe('Migrations', () => {
       'migration-one': {
         version: '1.0.0',
         description: '...',
-        migrationScript: './migration-one.js',
+        migrationScript: 'virtual-test-migration.js',
       },
       'migration-two': {
         version: '1.2.0',
         description: '...',
-        migrationScript: './migration-two.js',
+        migrationScript: 'virtual-test-migration2.js',
       },
     };
 
@@ -208,7 +203,7 @@ describe('Migrations', () => {
     it('should commit the changes for each migration if the CLI arg is present', async () => {
       await runMigrations(migrations, { commitEachMigration: true });
 
-      expect(gitCommitNoVerify).toHaveBeenCalledTimes(3);
+      expect(gitCommitNoVerify).toHaveBeenCalledTimes(2);
     });
 
     it('should not create a commit for a migration that has no changes', async () => {
@@ -216,7 +211,7 @@ describe('Migrations', () => {
 
       await runMigrations(migrations, { commitEachMigration: true });
 
-      expect(gitCommitNoVerify).toHaveBeenCalledTimes(2);
+      expect(gitCommitNoVerify).toHaveBeenCalledTimes(1);
     });
 
     it('should update version in ".config/.cprc.json" on a successful update', async () => {

package/src/{codemods/migrations → migrations}/manager.ts

@@ -1,14 +1,13 @@
+import { satisfies, gte } from 'semver';
+import { Context } from './context.js';
 import defaultMigrations, { MigrationMeta } from './migrations.js';
-import { flushChanges, formatFiles, installNPMDependencies } from '../utils.js';
-import { gte, satisfies } from 'semver';
-import { migrationsDebug, printChanges } from './utils.js';
+import { flushChanges, printChanges, migrationsDebug, formatFiles, installNPMDependencies } from './utils.js';
+import { gitCommitNoVerify } from '../utils/utils.git.js';
+import { setRootConfig } from '../utils/utils.config.js';
+import { output } from '../utils/utils.console.js';
+import { CURRENT_APP_VERSION } from '../utils/utils.version.js';
 
-import { CURRENT_APP_VERSION } from '../../utils/utils.version.js';
-import { Context } from '../context.js';
-import type { MigrationModule } from '../types.js';
-import { gitCommitNoVerify } from '../../utils/utils.git.js';
-import { output } from '../../utils/utils.console.js';
-import { setRootConfig } from '../../utils/utils.config.js';
+export type MigrationFn = (context: Context) => Context | Promise<Context>;
 
 export function getMigrationsToRun(
   fromVersion: string,
@@ -77,7 +76,7 @@ export async function runMigrations(migrations: Record<string, MigrationMeta>, o
 }
 
 export async function runMigration(migration: MigrationMeta, context: Context): Promise<Context> {
-  const module = (await import(migration.migrationScript)) as MigrationModule;
+  const module: { default: MigrationFn } = await import(migration.migrationScript);
 
   return module.default(context);
 }

package/src/migrations/migrations.test.ts

@@ -0,0 +1,16 @@
+import { existsSync } from 'node:fs';
+import { join } from 'node:path';
+import defaultMigrations from './migrations.js';
+
+describe('migrations json', () => {
+  // As migration scripts are imported dynamically when update is run we assert the path is valid
+  // Vitest 4 reimplemented it's workers which caused the previous dynamic import tests to fail.
+  // This test now only asserts that the source file exists.
+  Object.entries(defaultMigrations.migrations).forEach(([key, migration]) => {
+    it(`should have a valid migration script path for ${key}`, () => {
+      const migrationPathString = migration.migrationScript.replace('.js', '.ts');
+      const path = join(__dirname, migrationPathString);
+      expect(existsSync(path)).toBe(true);
+    });
+  });
+});

package/src/{codemods/migrations → migrations}/migrations.ts

@@ -1,4 +1,4 @@
-import { LEGACY_UPDATE_CUTOFF_VERSION } from '../../constants.js';
+import { LEGACY_UPDATE_CUTOFF_VERSION } from '../constants.js';
 
 export type MigrationMeta = {
   version: string;
@@ -10,6 +10,8 @@ type Migrations = {
   migrations: Record<string, MigrationMeta>;
 };
 
+// Do not use LEGACY_UPDATE_CUTOFF_VERSION for new migrations. It was used to force migrations to run
+// for those written before the switch to updates as migrations.
 export default {
   migrations: {
     '001-update-grafana-compose-extend': {
@@ -33,7 +35,10 @@ export default {
       description: 'Migrate eslint config to flat config format and update devDependencies to latest versions.',
       migrationScript: './scripts/004-eslint9-flat-config.js',
     },
-    // Do not use LEGACY_UPDATE_CUTOFF_VERSION for new migrations. It is only used above to force migrations to run
-    // for those written before the switch to updates as migrations.
+    '005-react-18-3': {
+      version: '6.1.7-beta.1',
+      description: 'Update React and ReactDOM 18.x versions to ^18.3.0 to surface React 19 compatibility issues.',
+      migrationScript: './scripts/005-react-18-3.js',
+    },
   },
 } as Migrations;