@grafana/create-plugin 6.3.0-canary.2320.19632510616.0 → 6.3.0

package/CHANGELOG.md

@@ -1,3 +1,15 @@
+# v6.3.0 (Tue Nov 25 2025)
+
+#### 🚀 Enhancement
+
+- Playwright: Bumping deploy-reports action [#2319](https://github.com/grafana/plugin-tools/pull/2319) ([@sunker](https://github.com/sunker))
+
+#### Authors: 1
+
+- Erik Sundell ([@sunker](https://github.com/sunker))
+
+---
+
 # v6.2.2 (Fri Nov 21 2025)
 
 #### 🐛 Bug Fix

package/dist/codemods/additions/additions.js

@@ -3,11 +3,6 @@ var defaultAdditions = [
     name: "example-addition",
     description: "Adds an example addition to the plugin",
     scriptPath: import.meta.resolve("./scripts/example-addition.js")
-  },
-  {
-    name: "i18n",
-    description: "Adds internationalization (i18n) support to the plugin",
-    scriptPath: import.meta.resolve("./scripts/i18n/index.js")
   }
 ];
 

package/dist/codemods/utils.js

@@ -205,6 +205,6 @@ function sortObjectByKeys(obj) {
   return Object.keys(obj).sort().reduce((acc, key) => ({ ...acc, [key]: obj[key] }), {});
 }
 const migrationsDebug = debug.extend("migrations");
-const additionsDebug = debug.extend("additions");
+debug.extend("additions");
 
-export { addDependenciesToPackageJson, additionsDebug, flushChanges, formatFiles, installNPMDependencies, isVersionGreater, migrationsDebug, printChanges, readJsonFile, removeDependenciesFromPackageJson };
+export { addDependenciesToPackageJson, flushChanges, formatFiles, installNPMDependencies, isVersionGreater, migrationsDebug, printChanges, readJsonFile, removeDependenciesFromPackageJson };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@grafana/create-plugin",
-  "version": "6.3.0-canary.2320.19632510616.0",
+  "version": "6.3.0",
   "repository": {
     "directory": "packages/create-plugin",
     "url": "https://github.com/grafana/plugin-tools"
@@ -53,13 +53,8 @@
     "@types/which": "^3.0.4",
     "tmp": "^0.2.5"
   },
-  "overrides": {
-    "@types/marked-terminal": {
-      "marked": "^16.0.0"
-    }
-  },
   "engines": {
     "node": ">=20"
   },
-  "gitHead": "c7cb4f185084d2406d507ff7abeb4ac01b65c6fa"
+  "gitHead": "23a20ea2878fc6000aae009020288f5c5b368dfd"
 }

package/src/codemods/AGENTS.md

@@ -5,24 +5,17 @@ This guide provides specific instructions for working with migrations and additi
 ## Agent Behavior
 
 - Refer to current migrations and additions typescript files found in @./additions/scripts and @./migrations/scripts
+- When creating a new migration add it to the exported migrations object in @./migrations/migrations.ts
 - Always refer to @./context.ts to know what methods are available on the context class
 - Always check for file existence using the @./context.ts class before attempting to do anything with it
 - Never write files with any 3rd party npm library. Use the context for all file operations
-- Always return the context for the next migration/addition
+- Always return the context for the next migration
 - Test thoroughly using the provided utils in @./test-utils.ts where necessary
-- Never attempt to read or write files outside the current working directory
-
-## Migrations
-
-Migrations are automatically run during `create-plugin update` to keep plugins compatible with newer versions of the tooling. They are forced upon developers to ensure compatibility and are versioned based on the create-plugin version. Migrations primarily target configuration files or files that are scaffolded by create-plugin.
-
-### Migration Behavior
-
-- When creating a new migration add it to the exported migrations object in @./migrations/migrations.ts
 - Each migration must be idempotent and must include a test case that uses the `.toBeIdempotent` custom matcher found in @../../vitest.setup.ts
 - Keep migrations focused on one task
+- Never attempt to read or write files outside the current working directory
 
-### Migration Naming Conventions
+## Naming Conventions
 
 - Each migration lives under @./migrations/scripts
 - Migration filenames follow the format: `NNN-migration-title` where migration-title is, at the most, a three word summary of what the migration does and NNN is the next number in sequence based on the current file name in @./migrations/scripts
@@ -30,16 +23,3 @@ Migrations are automatically run during `create-plugin update` to keep plugins c
   - `NNN-migration-title.ts` - main migration logic
   - `NNN-migration-title.test.ts` - migration logic tests
 - Each migration should export a default function named "migrate"
-
-## Additions
-
-Additions are optional features that developers choose to add via `create-plugin add`. They are not versioned and can be run at any time to enhance a plugin with new capabilities.
-
-### Addition Behavior
-
-- Additions add new features or capabilities to a plugin (e.g., i18n support, testing frameworks, etc.)
-- Each addition must be idempotent - it should be safe to run multiple times
-- Always use defensive programming: check if features already exist before adding them
-- Use `additionsDebug()` for logging to help with troubleshooting
-- If the addition accepts user input, export a `schema` object using `valibot` for input validation
-- Each addition should export a default function that takes `(context: Context, options?: T)` and returns `Context`

package/src/codemods/additions/additions.ts

@@ -6,9 +6,4 @@ export default [
     description: 'Adds an example addition to the plugin',
     scriptPath: import.meta.resolve('./scripts/example-addition.js'),
   },
-  {
-    name: 'i18n',
-    description: 'Adds internationalization (i18n) support to the plugin',
-    scriptPath: import.meta.resolve('./scripts/i18n/index.js'),
-  },
 ] satisfies Codemod[];

package/templates/github/workflows/ci.yml

@@ -247,7 +247,7 @@ jobs:
           # required for playwright-gh-pages
           persist-credentials: true
       - name: Publish report
-        uses: grafana/plugin-actions/playwright-gh-pages/deploy-report-pages@deploy-report-pages/v1.0.1
+        uses: grafana/plugin-actions/playwright-gh-pages/deploy-report-pages@deploy-report-pages/v1.1.0
         with:
           github-token: $\{{ secrets.GITHUB_TOKEN }}
 

package/dist/codemods/additions/scripts/i18n/code-generation.js

@@ -1,122 +0,0 @@
-import * as recast from 'recast';
-import * as babelParser from 'recast/parsers/babel-ts.js';
-import { additionsDebug } from '../../../utils.js';
-
-const { builders } = recast.types;
-function addI18nInitialization(context, needsBackwardCompatibility) {
-  const moduleTsPath = context.doesFileExist("src/module.ts") ? "src/module.ts" : context.doesFileExist("src/module.tsx") ? "src/module.tsx" : null;
-  if (!moduleTsPath) {
-    additionsDebug("No module.ts or module.tsx found, skipping i18n initialization");
-    return;
-  }
-  const moduleContent = context.getFile(moduleTsPath);
-  if (!moduleContent) {
-    return;
-  }
-  if (moduleContent.includes("initPluginTranslations")) {
-    additionsDebug("i18n already initialized in module file");
-    return;
-  }
-  try {
-    const ast = recast.parse(moduleContent, {
-      parser: babelParser
-    });
-    const imports = [];
-    imports.push(
-      builders.importDeclaration(
-        [builders.importSpecifier(builders.identifier("initPluginTranslations"))],
-        builders.literal("@grafana/i18n")
-      )
-    );
-    imports.push(
-      builders.importDeclaration(
-        [builders.importDefaultSpecifier(builders.identifier("pluginJson"))],
-        builders.literal("plugin.json")
-      )
-    );
-    if (needsBackwardCompatibility) {
-      imports.push(
-        builders.importDeclaration(
-          [builders.importSpecifier(builders.identifier("config"))],
-          builders.literal("@grafana/runtime")
-        )
-      );
-      imports.push(
-        builders.importDeclaration(
-          [builders.importDefaultSpecifier(builders.identifier("semver"))],
-          builders.literal("semver")
-        )
-      );
-      imports.push(
-        builders.importDeclaration(
-          [builders.importSpecifier(builders.identifier("loadResources"))],
-          builders.literal("./loadResources")
-        )
-      );
-    }
-    const firstImportIndex = ast.program.body.findIndex((node) => node.type === "ImportDeclaration");
-    if (firstImportIndex !== -1) {
-      ast.program.body.splice(firstImportIndex + 1, 0, ...imports);
-    } else {
-      ast.program.body.unshift(...imports);
-    }
-    const i18nInitCode = needsBackwardCompatibility ? `// Before Grafana version 12.1.0 the plugin is responsible for loading translation resources
-// In Grafana version 12.1.0 and later Grafana is responsible for loading translation resources
-const loaders = semver.lt(config?.buildInfo?.version, '12.1.0') ? [loadResources] : [];
-
-await initPluginTranslations(pluginJson.id, loaders);` : `await initPluginTranslations(pluginJson.id);`;
-    const initAst = recast.parse(i18nInitCode, {
-      parser: babelParser
-    });
-    const lastImportIndex = ast.program.body.findLastIndex((node) => node.type === "ImportDeclaration");
-    if (lastImportIndex !== -1) {
-      ast.program.body.splice(lastImportIndex + 1, 0, ...initAst.program.body);
-    } else {
-      ast.program.body.unshift(...initAst.program.body);
-    }
-    const output = recast.print(ast, {
-      tabWidth: 2,
-      trailingComma: true,
-      lineTerminator: "\n"
-    }).code;
-    context.updateFile(moduleTsPath, output);
-    additionsDebug(`Updated ${moduleTsPath} with i18n initialization`);
-  } catch (error) {
-    additionsDebug("Error updating module file:", error);
-  }
-}
-function createLoadResourcesFile(context) {
-  const loadResourcesPath = "src/loadResources.ts";
-  if (context.doesFileExist(loadResourcesPath)) {
-    additionsDebug("loadResources.ts already exists, skipping");
-    return;
-  }
-  const pluginJsonRaw = context.getFile("src/plugin.json");
-  if (!pluginJsonRaw) {
-    additionsDebug("Cannot create loadResources.ts without plugin.json");
-    return;
-  }
-  const loadResourcesContent = `import { LANGUAGES, ResourceLoader, Resources } from '@grafana/i18n';
-import pluginJson from 'plugin.json';
-
-const resources = LANGUAGES.reduce<Record<string, () => Promise<{ default: Resources }>>>((acc, lang) => {
-  acc[lang.code] = async () => await import(\`./locales/\${lang.code}/\${pluginJson.id}.json\`);
-  return acc;
-}, {});
-
-export const loadResources: ResourceLoader = async (resolvedLanguage: string) => {
-  try {
-    const translation = await resources[resolvedLanguage]();
-    return translation.default;
-  } catch (error) {
-    // This makes sure that the plugin doesn't crash when the resolved language in Grafana isn't supported by the plugin
-    console.error(\`The plugin '\${pluginJson.id}' doesn't support the language '\${resolvedLanguage}'\`, error);
-    return {};
-  }
-};
-`;
-  context.addFile(loadResourcesPath, loadResourcesContent);
-  additionsDebug("Created src/loadResources.ts for backward compatibility");
-}
-
-export { addI18nInitialization, createLoadResourcesFile };

package/dist/codemods/additions/scripts/i18n/config-updates.js

@@ -1,113 +0,0 @@
-import { coerce, gte } from 'semver';
-import { parseDocument, stringify } from 'yaml';
-import { additionsDebug } from '../../../utils.js';
-
-function updateDockerCompose(context) {
-  if (!context.doesFileExist("docker-compose.yaml")) {
-    additionsDebug("docker-compose.yaml not found, skipping");
-    return;
-  }
-  const composeContent = context.getFile("docker-compose.yaml");
-  if (!composeContent) {
-    return;
-  }
-  try {
-    const composeDoc = parseDocument(composeContent);
-    const currentEnv = composeDoc.getIn(["services", "grafana", "environment"]);
-    if (!currentEnv) {
-      additionsDebug("No environment section found in docker-compose.yaml, skipping");
-      return;
-    }
-    if (typeof currentEnv === "object") {
-      const envMap = currentEnv;
-      const toggleValue = envMap.get("GF_FEATURE_TOGGLES_ENABLE");
-      if (toggleValue) {
-        const toggleStr = toggleValue.toString();
-        if (toggleStr.includes("localizationForPlugins")) {
-          additionsDebug("localizationForPlugins already in GF_FEATURE_TOGGLES_ENABLE");
-          return;
-        }
-        composeDoc.setIn(
-          ["services", "grafana", "environment", "GF_FEATURE_TOGGLES_ENABLE"],
-          `${toggleStr},localizationForPlugins`
-        );
-      } else {
-        composeDoc.setIn(["services", "grafana", "environment", "GF_FEATURE_TOGGLES_ENABLE"], "localizationForPlugins");
-      }
-      context.updateFile("docker-compose.yaml", stringify(composeDoc));
-      additionsDebug("Updated docker-compose.yaml with localizationForPlugins feature toggle");
-    }
-  } catch (error) {
-    additionsDebug("Error updating docker-compose.yaml:", error);
-  }
-}
-function updatePluginJson(context, locales, needsBackwardCompatibility) {
-  if (!context.doesFileExist("src/plugin.json")) {
-    additionsDebug("src/plugin.json not found, skipping");
-    return;
-  }
-  const pluginJsonRaw = context.getFile("src/plugin.json");
-  if (!pluginJsonRaw) {
-    return;
-  }
-  try {
-    const pluginJson = JSON.parse(pluginJsonRaw);
-    const existingLanguages = Array.isArray(pluginJson.languages) ? pluginJson.languages : [];
-    const mergedLanguages = [.../* @__PURE__ */ new Set([...existingLanguages, ...locales])];
-    pluginJson.languages = mergedLanguages;
-    if (!pluginJson.dependencies) {
-      pluginJson.dependencies = {};
-    }
-    const currentGrafanaDep = pluginJson.dependencies.grafanaDependency || ">=11.0.0";
-    const targetVersion = needsBackwardCompatibility ? "11.0.0" : "12.1.0";
-    const minVersion = coerce(targetVersion);
-    const currentVersion = coerce(currentGrafanaDep.replace(/^[><=]+/, ""));
-    if (!currentVersion || !minVersion || !gte(currentVersion, minVersion)) {
-      pluginJson.dependencies.grafanaDependency = `>=${targetVersion}`;
-      additionsDebug(`Updated grafanaDependency to >=${targetVersion}`);
-    }
-    context.updateFile("src/plugin.json", JSON.stringify(pluginJson, null, 2));
-    additionsDebug("Updated src/plugin.json with languages:", locales);
-  } catch (error) {
-    additionsDebug("Error updating src/plugin.json:", error);
-  }
-}
-function createI18nextConfig(context) {
-  if (context.doesFileExist("i18next.config.ts")) {
-    additionsDebug("i18next.config.ts already exists, skipping");
-    return;
-  }
-  const pluginJsonRaw = context.getFile("src/plugin.json");
-  if (!pluginJsonRaw) {
-    additionsDebug("Cannot create i18next.config.ts without plugin.json");
-    return;
-  }
-  try {
-    const pluginJson = JSON.parse(pluginJsonRaw);
-    const pluginId = pluginJson.id;
-    if (!pluginId) {
-      additionsDebug("No plugin ID found in plugin.json");
-      return;
-    }
-    const i18nextConfig = `import { defineConfig } from 'i18next-cli';
-import pluginJson from './src/plugin.json';
-
-export default defineConfig({
-  locales: pluginJson.languages,
-  extract: {
-    input: ['src/**/*.{tsx,ts}'],
-    output: 'src/locales/{{language}}/{{namespace}}.json',
-    defaultNS: pluginJson.id,
-    functions: ['t', '*.t'],
-    transComponents: ['Trans'],
-  },
-});
-`;
-    context.addFile("i18next.config.ts", i18nextConfig);
-    additionsDebug("Created i18next.config.ts");
-  } catch (error) {
-    additionsDebug("Error creating i18next.config.ts:", error);
-  }
-}
-
-export { createI18nextConfig, updateDockerCompose, updatePluginJson };

package/dist/codemods/additions/scripts/i18n/index.js

@@ -1,49 +0,0 @@
-import * as v from 'valibot';
-import { additionsDebug } from '../../../utils.js';
-import { updateDockerCompose, updatePluginJson, createI18nextConfig } from './config-updates.js';
-import { addI18nInitialization, createLoadResourcesFile } from './code-generation.js';
-import { addI18nDependency, addSemverDependency, updateEslintConfig, addI18nextCli } from './tooling.js';
-import { checkNeedsBackwardCompatibility, createLocaleFiles } from './utils.js';
-
-const schema = v.object(
-  {
-    locales: v.pipe(
-      v.union([v.string(), v.array(v.string())]),
-      v.transform((input) => {
-        return typeof input === "string" ? input.split(",").map((s) => s.trim()) : input;
-      }),
-      v.array(
-        v.pipe(
-          v.string(),
-          v.regex(/^[a-z]{2}-[A-Z]{2}$/, "Locale must be in format xx-XX (e.g., en-US, es-ES, sv-SE)")
-        ),
-        'Please provide a comma-separated list of all supported locales, e.g., "en-US,es-ES,sv-SE"'
-      ),
-      v.minLength(1, 'Please provide a comma-separated list of all supported locales, e.g., "en-US,es-ES,sv-SE"')
-    )
-  },
-  'Please provide a comma-separated list of all supported locales, e.g., "en-US,es-ES,sv-SE"'
-);
-function i18nAddition(context, options) {
-  const { locales } = options;
-  additionsDebug("Adding i18n support with locales:", locales);
-  const needsBackwardCompatibility = checkNeedsBackwardCompatibility(context);
-  additionsDebug("Needs backward compatibility:", needsBackwardCompatibility);
-  updateDockerCompose(context);
-  updatePluginJson(context, locales, needsBackwardCompatibility);
-  createLocaleFiles(context, locales);
-  addI18nDependency(context);
-  if (needsBackwardCompatibility) {
-    addSemverDependency(context);
-  }
-  updateEslintConfig(context);
-  addI18nInitialization(context, needsBackwardCompatibility);
-  if (needsBackwardCompatibility) {
-    createLoadResourcesFile(context);
-  }
-  addI18nextCli(context);
-  createI18nextConfig(context);
-  return context;
-}
-
-export { i18nAddition as default, schema };

package/dist/codemods/additions/scripts/i18n/tooling.js

@@ -1,119 +0,0 @@
-import * as recast from 'recast';
-import * as babelParser from 'recast/parsers/babel-ts.js';
-import { addDependenciesToPackageJson, additionsDebug } from '../../../utils.js';
-
-const { builders } = recast.types;
-function addI18nDependency(context) {
-  addDependenciesToPackageJson(context, { "@grafana/i18n": "^12.2.2" }, {});
-  additionsDebug("Added @grafana/i18n dependency version ^12.2.2");
-}
-function addSemverDependency(context) {
-  addDependenciesToPackageJson(context, { semver: "^7.6.0" }, { "@types/semver": "^7.5.0" });
-  additionsDebug("Added semver dependency");
-}
-function addI18nextCli(context) {
-  addDependenciesToPackageJson(context, {}, { "i18next-cli": "^1.1.1" });
-  const packageJsonRaw = context.getFile("package.json");
-  if (!packageJsonRaw) {
-    return;
-  }
-  try {
-    const packageJson = JSON.parse(packageJsonRaw);
-    if (!packageJson.scripts) {
-      packageJson.scripts = {};
-    }
-    if (!packageJson.scripts["i18n-extract"]) {
-      packageJson.scripts["i18n-extract"] = "i18next-cli extract --sync-primary";
-      context.updateFile("package.json", JSON.stringify(packageJson, null, 2));
-      additionsDebug("Added i18n-extract script to package.json");
-    } else {
-      additionsDebug("i18n-extract script already exists, skipping");
-    }
-  } catch (error) {
-    additionsDebug("Error adding i18n-extract script:", error);
-  }
-}
-function updateEslintConfig(context) {
-  if (!context.doesFileExist("eslint.config.mjs")) {
-    additionsDebug("eslint.config.mjs not found, skipping");
-    return;
-  }
-  const eslintConfigRaw = context.getFile("eslint.config.mjs");
-  if (!eslintConfigRaw) {
-    return;
-  }
-  if (eslintConfigRaw.includes("@grafana/i18n/eslint-plugin")) {
-    additionsDebug("ESLint i18n rule already configured");
-    return;
-  }
-  try {
-    const ast = recast.parse(eslintConfigRaw, {
-      parser: babelParser
-    });
-    const imports = ast.program.body.filter((node) => node.type === "ImportDeclaration");
-    const lastImport = imports[imports.length - 1];
-    if (lastImport) {
-      const pluginImport = builders.importDeclaration(
-        [builders.importDefaultSpecifier(builders.identifier("grafanaI18nPlugin"))],
-        builders.literal("@grafana/i18n/eslint-plugin")
-      );
-      const lastImportIndex = ast.program.body.indexOf(lastImport);
-      ast.program.body.splice(lastImportIndex + 1, 0, pluginImport);
-    }
-    recast.visit(ast, {
-      visitCallExpression(path) {
-        if (path.node.callee.name === "defineConfig" && path.node.arguments[0]?.type === "ArrayExpression") {
-          const configArray = path.node.arguments[0];
-          const i18nConfig = builders.objectExpression([
-            builders.property("init", builders.identifier("name"), builders.literal("grafana/i18n-rules")),
-            builders.property(
-              "init",
-              builders.identifier("plugins"),
-              builders.objectExpression([
-                builders.property("init", builders.literal("@grafana/i18n"), builders.identifier("grafanaI18nPlugin"))
-              ])
-            ),
-            builders.property(
-              "init",
-              builders.identifier("rules"),
-              builders.objectExpression([
-                builders.property(
-                  "init",
-                  builders.literal("@grafana/i18n/no-untranslated-strings"),
-                  builders.arrayExpression([
-                    builders.literal("error"),
-                    builders.objectExpression([
-                      builders.property(
-                        "init",
-                        builders.identifier("calleesToIgnore"),
-                        builders.arrayExpression([builders.literal("^css$"), builders.literal("use[A-Z].*")])
-                      )
-                    ])
-                  ])
-                ),
-                builders.property(
-                  "init",
-                  builders.literal("@grafana/i18n/no-translation-top-level"),
-                  builders.literal("error")
-                )
-              ])
-            )
-          ]);
-          configArray.elements.push(i18nConfig);
-        }
-        this.traverse(path);
-      }
-    });
-    const output = recast.print(ast, {
-      tabWidth: 2,
-      trailingComma: true,
-      lineTerminator: "\n"
-    }).code;
-    context.updateFile("eslint.config.mjs", output);
-    additionsDebug("Updated eslint.config.mjs with i18n linting rules");
-  } catch (error) {
-    additionsDebug("Error updating eslint.config.mjs:", error);
-  }
-}
-
-export { addI18nDependency, addI18nextCli, addSemverDependency, updateEslintConfig };

package/dist/codemods/additions/scripts/i18n/utils.js

@@ -1,50 +0,0 @@
-import { coerce, gte } from 'semver';
-import { additionsDebug } from '../../../utils.js';
-
-function checkNeedsBackwardCompatibility(context) {
-  const pluginJsonRaw = context.getFile("src/plugin.json");
-  if (!pluginJsonRaw) {
-    return false;
-  }
-  try {
-    const pluginJson = JSON.parse(pluginJsonRaw);
-    const currentGrafanaDep = pluginJson.dependencies?.grafanaDependency || ">=11.0.0";
-    const minVersion = coerce("12.1.0");
-    const currentVersion = coerce(currentGrafanaDep.replace(/^[><=]+/, ""));
-    if (currentVersion && minVersion && gte(currentVersion, minVersion)) {
-      return false;
-    }
-    return true;
-  } catch (error) {
-    additionsDebug("Error checking backward compatibility:", error);
-    return true;
-  }
-}
-function createLocaleFiles(context, locales) {
-  const pluginJsonRaw = context.getFile("src/plugin.json");
-  if (!pluginJsonRaw) {
-    additionsDebug("Cannot create locale files without plugin.json");
-    return;
-  }
-  try {
-    const pluginJson = JSON.parse(pluginJsonRaw);
-    const pluginId = pluginJson.id;
-    if (!pluginId) {
-      additionsDebug("No plugin ID found in plugin.json");
-      return;
-    }
-    for (const locale of locales) {
-      const localePath = `src/locales/${locale}/${pluginId}.json`;
-      if (!context.doesFileExist(localePath)) {
-        context.addFile(localePath, JSON.stringify({}, null, 2));
-        additionsDebug(`Created ${localePath}`);
-      } else {
-        additionsDebug(`${localePath} already exists, skipping`);
-      }
-    }
-  } catch (error) {
-    additionsDebug("Error creating locale files:", error);
-  }
-}
-
-export { checkNeedsBackwardCompatibility, createLocaleFiles };