@grafana/create-plugin 6.3.0-canary.2314.19540598852.0 → 6.3.0-canary.2320.19631436862.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/CHANGELOG.md CHANGED
@@ -1,3 +1,15 @@
1
+ # v6.2.2 (Fri Nov 21 2025)
2
+
3
+ #### 🐛 Bug Fix
4
+
5
+ - fix(deps): update dependency glob to v11.1.0 [security] [#2308](https://github.com/grafana/plugin-tools/pull/2308) ([@renovate-sh-app[bot]](https://github.com/renovate-sh-app[bot]))
6
+
7
+ #### Authors: 1
8
+
9
+ - [@renovate-sh-app[bot]](https://github.com/renovate-sh-app[bot])
10
+
11
+ ---
12
+
1
13
  # v6.2.1 (Thu Nov 20 2025)
2
14
 
3
15
  #### 🐛 Bug Fix
@@ -3,6 +3,11 @@ var defaultAdditions = [
3
3
  name: "example-addition",
4
4
  description: "Adds an example addition to the plugin",
5
5
  scriptPath: import.meta.resolve("./scripts/example-addition.js")
6
+ },
7
+ {
8
+ name: "i18n",
9
+ description: "Adds internationalization (i18n) support to the plugin",
10
+ scriptPath: import.meta.resolve("./scripts/i18n/index.js")
6
11
  }
7
12
  ];
8
13
 
@@ -0,0 +1,122 @@
1
+ import * as recast from 'recast';
2
+ import * as babelParser from 'recast/parsers/babel-ts.js';
3
+ import { additionsDebug } from '../../../utils.js';
4
+
5
+ const { builders } = recast.types;
6
+ function addI18nInitialization(context, needsBackwardCompatibility) {
7
+ const moduleTsPath = context.doesFileExist("src/module.ts") ? "src/module.ts" : context.doesFileExist("src/module.tsx") ? "src/module.tsx" : null;
8
+ if (!moduleTsPath) {
9
+ additionsDebug("No module.ts or module.tsx found, skipping i18n initialization");
10
+ return;
11
+ }
12
+ const moduleContent = context.getFile(moduleTsPath);
13
+ if (!moduleContent) {
14
+ return;
15
+ }
16
+ if (moduleContent.includes("initPluginTranslations")) {
17
+ additionsDebug("i18n already initialized in module file");
18
+ return;
19
+ }
20
+ try {
21
+ const ast = recast.parse(moduleContent, {
22
+ parser: babelParser
23
+ });
24
+ const imports = [];
25
+ imports.push(
26
+ builders.importDeclaration(
27
+ [builders.importSpecifier(builders.identifier("initPluginTranslations"))],
28
+ builders.literal("@grafana/i18n")
29
+ )
30
+ );
31
+ imports.push(
32
+ builders.importDeclaration(
33
+ [builders.importDefaultSpecifier(builders.identifier("pluginJson"))],
34
+ builders.literal("plugin.json")
35
+ )
36
+ );
37
+ if (needsBackwardCompatibility) {
38
+ imports.push(
39
+ builders.importDeclaration(
40
+ [builders.importSpecifier(builders.identifier("config"))],
41
+ builders.literal("@grafana/runtime")
42
+ )
43
+ );
44
+ imports.push(
45
+ builders.importDeclaration(
46
+ [builders.importDefaultSpecifier(builders.identifier("semver"))],
47
+ builders.literal("semver")
48
+ )
49
+ );
50
+ imports.push(
51
+ builders.importDeclaration(
52
+ [builders.importSpecifier(builders.identifier("loadResources"))],
53
+ builders.literal("./loadResources")
54
+ )
55
+ );
56
+ }
57
+ const firstImportIndex = ast.program.body.findIndex((node) => node.type === "ImportDeclaration");
58
+ if (firstImportIndex !== -1) {
59
+ ast.program.body.splice(firstImportIndex + 1, 0, ...imports);
60
+ } else {
61
+ ast.program.body.unshift(...imports);
62
+ }
63
+ const i18nInitCode = needsBackwardCompatibility ? `// Before Grafana version 12.1.0 the plugin is responsible for loading translation resources
64
+ // In Grafana version 12.1.0 and later Grafana is responsible for loading translation resources
65
+ const loaders = semver.lt(config?.buildInfo?.version, '12.1.0') ? [loadResources] : [];
66
+
67
+ await initPluginTranslations(pluginJson.id, loaders);` : `await initPluginTranslations(pluginJson.id);`;
68
+ const initAst = recast.parse(i18nInitCode, {
69
+ parser: babelParser
70
+ });
71
+ const lastImportIndex = ast.program.body.findLastIndex((node) => node.type === "ImportDeclaration");
72
+ if (lastImportIndex !== -1) {
73
+ ast.program.body.splice(lastImportIndex + 1, 0, ...initAst.program.body);
74
+ } else {
75
+ ast.program.body.unshift(...initAst.program.body);
76
+ }
77
+ const output = recast.print(ast, {
78
+ tabWidth: 2,
79
+ trailingComma: true,
80
+ lineTerminator: "\n"
81
+ }).code;
82
+ context.updateFile(moduleTsPath, output);
83
+ additionsDebug(`Updated ${moduleTsPath} with i18n initialization`);
84
+ } catch (error) {
85
+ additionsDebug("Error updating module file:", error);
86
+ }
87
+ }
88
+ function createLoadResourcesFile(context) {
89
+ const loadResourcesPath = "src/loadResources.ts";
90
+ if (context.doesFileExist(loadResourcesPath)) {
91
+ additionsDebug("loadResources.ts already exists, skipping");
92
+ return;
93
+ }
94
+ const pluginJsonRaw = context.getFile("src/plugin.json");
95
+ if (!pluginJsonRaw) {
96
+ additionsDebug("Cannot create loadResources.ts without plugin.json");
97
+ return;
98
+ }
99
+ const loadResourcesContent = `import { LANGUAGES, ResourceLoader, Resources } from '@grafana/i18n';
100
+ import pluginJson from 'plugin.json';
101
+
102
+ const resources = LANGUAGES.reduce<Record<string, () => Promise<{ default: Resources }>>>((acc, lang) => {
103
+ acc[lang.code] = async () => await import(\`./locales/\${lang.code}/\${pluginJson.id}.json\`);
104
+ return acc;
105
+ }, {});
106
+
107
+ export const loadResources: ResourceLoader = async (resolvedLanguage: string) => {
108
+ try {
109
+ const translation = await resources[resolvedLanguage]();
110
+ return translation.default;
111
+ } catch (error) {
112
+ // This makes sure that the plugin doesn't crash when the resolved language in Grafana isn't supported by the plugin
113
+ console.error(\`The plugin '\${pluginJson.id}' doesn't support the language '\${resolvedLanguage}'\`, error);
114
+ return {};
115
+ }
116
+ };
117
+ `;
118
+ context.addFile(loadResourcesPath, loadResourcesContent);
119
+ additionsDebug("Created src/loadResources.ts for backward compatibility");
120
+ }
121
+
122
+ export { addI18nInitialization, createLoadResourcesFile };
@@ -0,0 +1,113 @@
1
+ import { coerce, gte } from 'semver';
2
+ import { parseDocument, stringify } from 'yaml';
3
+ import { additionsDebug } from '../../../utils.js';
4
+
5
+ function updateDockerCompose(context) {
6
+ if (!context.doesFileExist("docker-compose.yaml")) {
7
+ additionsDebug("docker-compose.yaml not found, skipping");
8
+ return;
9
+ }
10
+ const composeContent = context.getFile("docker-compose.yaml");
11
+ if (!composeContent) {
12
+ return;
13
+ }
14
+ try {
15
+ const composeDoc = parseDocument(composeContent);
16
+ const currentEnv = composeDoc.getIn(["services", "grafana", "environment"]);
17
+ if (!currentEnv) {
18
+ additionsDebug("No environment section found in docker-compose.yaml, skipping");
19
+ return;
20
+ }
21
+ if (typeof currentEnv === "object") {
22
+ const envMap = currentEnv;
23
+ const toggleValue = envMap.get("GF_FEATURE_TOGGLES_ENABLE");
24
+ if (toggleValue) {
25
+ const toggleStr = toggleValue.toString();
26
+ if (toggleStr.includes("localizationForPlugins")) {
27
+ additionsDebug("localizationForPlugins already in GF_FEATURE_TOGGLES_ENABLE");
28
+ return;
29
+ }
30
+ composeDoc.setIn(
31
+ ["services", "grafana", "environment", "GF_FEATURE_TOGGLES_ENABLE"],
32
+ `${toggleStr},localizationForPlugins`
33
+ );
34
+ } else {
35
+ composeDoc.setIn(["services", "grafana", "environment", "GF_FEATURE_TOGGLES_ENABLE"], "localizationForPlugins");
36
+ }
37
+ context.updateFile("docker-compose.yaml", stringify(composeDoc));
38
+ additionsDebug("Updated docker-compose.yaml with localizationForPlugins feature toggle");
39
+ }
40
+ } catch (error) {
41
+ additionsDebug("Error updating docker-compose.yaml:", error);
42
+ }
43
+ }
44
+ function updatePluginJson(context, locales, needsBackwardCompatibility) {
45
+ if (!context.doesFileExist("src/plugin.json")) {
46
+ additionsDebug("src/plugin.json not found, skipping");
47
+ return;
48
+ }
49
+ const pluginJsonRaw = context.getFile("src/plugin.json");
50
+ if (!pluginJsonRaw) {
51
+ return;
52
+ }
53
+ try {
54
+ const pluginJson = JSON.parse(pluginJsonRaw);
55
+ const existingLanguages = Array.isArray(pluginJson.languages) ? pluginJson.languages : [];
56
+ const mergedLanguages = [.../* @__PURE__ */ new Set([...existingLanguages, ...locales])];
57
+ pluginJson.languages = mergedLanguages;
58
+ if (!pluginJson.dependencies) {
59
+ pluginJson.dependencies = {};
60
+ }
61
+ const currentGrafanaDep = pluginJson.dependencies.grafanaDependency || ">=11.0.0";
62
+ const targetVersion = needsBackwardCompatibility ? "11.0.0" : "12.1.0";
63
+ const minVersion = coerce(targetVersion);
64
+ const currentVersion = coerce(currentGrafanaDep.replace(/^[><=]+/, ""));
65
+ if (!currentVersion || !minVersion || !gte(currentVersion, minVersion)) {
66
+ pluginJson.dependencies.grafanaDependency = `>=${targetVersion}`;
67
+ additionsDebug(`Updated grafanaDependency to >=${targetVersion}`);
68
+ }
69
+ context.updateFile("src/plugin.json", JSON.stringify(pluginJson, null, 2));
70
+ additionsDebug("Updated src/plugin.json with languages:", locales);
71
+ } catch (error) {
72
+ additionsDebug("Error updating src/plugin.json:", error);
73
+ }
74
+ }
75
+ function createI18nextConfig(context) {
76
+ if (context.doesFileExist("i18next.config.ts")) {
77
+ additionsDebug("i18next.config.ts already exists, skipping");
78
+ return;
79
+ }
80
+ const pluginJsonRaw = context.getFile("src/plugin.json");
81
+ if (!pluginJsonRaw) {
82
+ additionsDebug("Cannot create i18next.config.ts without plugin.json");
83
+ return;
84
+ }
85
+ try {
86
+ const pluginJson = JSON.parse(pluginJsonRaw);
87
+ const pluginId = pluginJson.id;
88
+ if (!pluginId) {
89
+ additionsDebug("No plugin ID found in plugin.json");
90
+ return;
91
+ }
92
+ const i18nextConfig = `import { defineConfig } from 'i18next-cli';
93
+ import pluginJson from './src/plugin.json';
94
+
95
+ export default defineConfig({
96
+ locales: pluginJson.languages,
97
+ extract: {
98
+ input: ['src/**/*.{tsx,ts}'],
99
+ output: 'src/locales/{{language}}/{{namespace}}.json',
100
+ defaultNS: pluginJson.id,
101
+ functions: ['t', '*.t'],
102
+ transComponents: ['Trans'],
103
+ },
104
+ });
105
+ `;
106
+ context.addFile("i18next.config.ts", i18nextConfig);
107
+ additionsDebug("Created i18next.config.ts");
108
+ } catch (error) {
109
+ additionsDebug("Error creating i18next.config.ts:", error);
110
+ }
111
+ }
112
+
113
+ export { createI18nextConfig, updateDockerCompose, updatePluginJson };
@@ -0,0 +1,49 @@
1
+ import * as v from 'valibot';
2
+ import { additionsDebug } from '../../../utils.js';
3
+ import { updateDockerCompose, updatePluginJson, createI18nextConfig } from './config-updates.js';
4
+ import { addI18nInitialization, createLoadResourcesFile } from './code-generation.js';
5
+ import { addI18nDependency, addSemverDependency, updateEslintConfig, addI18nextCli } from './tooling.js';
6
+ import { checkNeedsBackwardCompatibility, createLocaleFiles } from './utils.js';
7
+
8
+ const schema = v.object(
9
+ {
10
+ locales: v.pipe(
11
+ v.union([v.string(), v.array(v.string())]),
12
+ v.transform((input) => {
13
+ return typeof input === "string" ? input.split(",").map((s) => s.trim()) : input;
14
+ }),
15
+ v.array(
16
+ v.pipe(
17
+ v.string(),
18
+ v.regex(/^[a-z]{2}-[A-Z]{2}$/, "Locale must be in format xx-XX (e.g., en-US, es-ES, sv-SE)")
19
+ ),
20
+ 'Please provide a comma-separated list of all supported locales, e.g., "en-US,es-ES,sv-SE"'
21
+ ),
22
+ v.minLength(1, 'Please provide a comma-separated list of all supported locales, e.g., "en-US,es-ES,sv-SE"')
23
+ )
24
+ },
25
+ 'Please provide a comma-separated list of all supported locales, e.g., "en-US,es-ES,sv-SE"'
26
+ );
27
+ function i18nAddition(context, options) {
28
+ const { locales } = options;
29
+ additionsDebug("Adding i18n support with locales:", locales);
30
+ const needsBackwardCompatibility = checkNeedsBackwardCompatibility(context);
31
+ additionsDebug("Needs backward compatibility:", needsBackwardCompatibility);
32
+ updateDockerCompose(context);
33
+ updatePluginJson(context, locales, needsBackwardCompatibility);
34
+ createLocaleFiles(context, locales);
35
+ addI18nDependency(context);
36
+ if (needsBackwardCompatibility) {
37
+ addSemverDependency(context);
38
+ }
39
+ updateEslintConfig(context);
40
+ addI18nInitialization(context, needsBackwardCompatibility);
41
+ if (needsBackwardCompatibility) {
42
+ createLoadResourcesFile(context);
43
+ }
44
+ addI18nextCli(context);
45
+ createI18nextConfig(context);
46
+ return context;
47
+ }
48
+
49
+ export { i18nAddition as default, schema };
@@ -0,0 +1,119 @@
1
+ import * as recast from 'recast';
2
+ import * as babelParser from 'recast/parsers/babel-ts.js';
3
+ import { addDependenciesToPackageJson, additionsDebug } from '../../../utils.js';
4
+
5
+ const { builders } = recast.types;
6
+ function addI18nDependency(context) {
7
+ addDependenciesToPackageJson(context, { "@grafana/i18n": "12.2.2" }, {});
8
+ additionsDebug("Added @grafana/i18n dependency version 12.2.2");
9
+ }
10
+ function addSemverDependency(context) {
11
+ addDependenciesToPackageJson(context, { semver: "^7.6.0" }, { "@types/semver": "^7.5.0" });
12
+ additionsDebug("Added semver dependency");
13
+ }
14
+ function addI18nextCli(context) {
15
+ addDependenciesToPackageJson(context, {}, { "i18next-cli": "^1.1.1" });
16
+ const packageJsonRaw = context.getFile("package.json");
17
+ if (!packageJsonRaw) {
18
+ return;
19
+ }
20
+ try {
21
+ const packageJson = JSON.parse(packageJsonRaw);
22
+ if (!packageJson.scripts) {
23
+ packageJson.scripts = {};
24
+ }
25
+ if (!packageJson.scripts["i18n-extract"]) {
26
+ packageJson.scripts["i18n-extract"] = "i18next-cli extract --sync-primary";
27
+ context.updateFile("package.json", JSON.stringify(packageJson, null, 2));
28
+ additionsDebug("Added i18n-extract script to package.json");
29
+ } else {
30
+ additionsDebug("i18n-extract script already exists, skipping");
31
+ }
32
+ } catch (error) {
33
+ additionsDebug("Error adding i18n-extract script:", error);
34
+ }
35
+ }
36
+ function updateEslintConfig(context) {
37
+ if (!context.doesFileExist("eslint.config.mjs")) {
38
+ additionsDebug("eslint.config.mjs not found, skipping");
39
+ return;
40
+ }
41
+ const eslintConfigRaw = context.getFile("eslint.config.mjs");
42
+ if (!eslintConfigRaw) {
43
+ return;
44
+ }
45
+ if (eslintConfigRaw.includes("@grafana/i18n/eslint-plugin")) {
46
+ additionsDebug("ESLint i18n rule already configured");
47
+ return;
48
+ }
49
+ try {
50
+ const ast = recast.parse(eslintConfigRaw, {
51
+ parser: babelParser
52
+ });
53
+ const imports = ast.program.body.filter((node) => node.type === "ImportDeclaration");
54
+ const lastImport = imports[imports.length - 1];
55
+ if (lastImport) {
56
+ const pluginImport = builders.importDeclaration(
57
+ [builders.importDefaultSpecifier(builders.identifier("grafanaI18nPlugin"))],
58
+ builders.literal("@grafana/i18n/eslint-plugin")
59
+ );
60
+ const lastImportIndex = ast.program.body.indexOf(lastImport);
61
+ ast.program.body.splice(lastImportIndex + 1, 0, pluginImport);
62
+ }
63
+ recast.visit(ast, {
64
+ visitCallExpression(path) {
65
+ if (path.node.callee.name === "defineConfig" && path.node.arguments[0]?.type === "ArrayExpression") {
66
+ const configArray = path.node.arguments[0];
67
+ const i18nConfig = builders.objectExpression([
68
+ builders.property("init", builders.identifier("name"), builders.literal("grafana/i18n-rules")),
69
+ builders.property(
70
+ "init",
71
+ builders.identifier("plugins"),
72
+ builders.objectExpression([
73
+ builders.property("init", builders.literal("@grafana/i18n"), builders.identifier("grafanaI18nPlugin"))
74
+ ])
75
+ ),
76
+ builders.property(
77
+ "init",
78
+ builders.identifier("rules"),
79
+ builders.objectExpression([
80
+ builders.property(
81
+ "init",
82
+ builders.literal("@grafana/i18n/no-untranslated-strings"),
83
+ builders.arrayExpression([
84
+ builders.literal("error"),
85
+ builders.objectExpression([
86
+ builders.property(
87
+ "init",
88
+ builders.identifier("calleesToIgnore"),
89
+ builders.arrayExpression([builders.literal("^css$"), builders.literal("use[A-Z].*")])
90
+ )
91
+ ])
92
+ ])
93
+ ),
94
+ builders.property(
95
+ "init",
96
+ builders.literal("@grafana/i18n/no-translation-top-level"),
97
+ builders.literal("error")
98
+ )
99
+ ])
100
+ )
101
+ ]);
102
+ configArray.elements.push(i18nConfig);
103
+ }
104
+ this.traverse(path);
105
+ }
106
+ });
107
+ const output = recast.print(ast, {
108
+ tabWidth: 2,
109
+ trailingComma: true,
110
+ lineTerminator: "\n"
111
+ }).code;
112
+ context.updateFile("eslint.config.mjs", output);
113
+ additionsDebug("Updated eslint.config.mjs with i18n linting rules");
114
+ } catch (error) {
115
+ additionsDebug("Error updating eslint.config.mjs:", error);
116
+ }
117
+ }
118
+
119
+ export { addI18nDependency, addI18nextCli, addSemverDependency, updateEslintConfig };
@@ -0,0 +1,50 @@
1
+ import { coerce, gte } from 'semver';
2
+ import { additionsDebug } from '../../../utils.js';
3
+
4
+ function checkNeedsBackwardCompatibility(context) {
5
+ const pluginJsonRaw = context.getFile("src/plugin.json");
6
+ if (!pluginJsonRaw) {
7
+ return false;
8
+ }
9
+ try {
10
+ const pluginJson = JSON.parse(pluginJsonRaw);
11
+ const currentGrafanaDep = pluginJson.dependencies?.grafanaDependency || ">=11.0.0";
12
+ const minVersion = coerce("12.1.0");
13
+ const currentVersion = coerce(currentGrafanaDep.replace(/^[><=]+/, ""));
14
+ if (currentVersion && minVersion && gte(currentVersion, minVersion)) {
15
+ return false;
16
+ }
17
+ return true;
18
+ } catch (error) {
19
+ additionsDebug("Error checking backward compatibility:", error);
20
+ return true;
21
+ }
22
+ }
23
+ function createLocaleFiles(context, locales) {
24
+ const pluginJsonRaw = context.getFile("src/plugin.json");
25
+ if (!pluginJsonRaw) {
26
+ additionsDebug("Cannot create locale files without plugin.json");
27
+ return;
28
+ }
29
+ try {
30
+ const pluginJson = JSON.parse(pluginJsonRaw);
31
+ const pluginId = pluginJson.id;
32
+ if (!pluginId) {
33
+ additionsDebug("No plugin ID found in plugin.json");
34
+ return;
35
+ }
36
+ for (const locale of locales) {
37
+ const localePath = `src/locales/${locale}/${pluginId}.json`;
38
+ if (!context.doesFileExist(localePath)) {
39
+ context.addFile(localePath, JSON.stringify({}, null, 2));
40
+ additionsDebug(`Created ${localePath}`);
41
+ } else {
42
+ additionsDebug(`${localePath} already exists, skipping`);
43
+ }
44
+ }
45
+ } catch (error) {
46
+ additionsDebug("Error creating locale files:", error);
47
+ }
48
+ }
49
+
50
+ export { checkNeedsBackwardCompatibility, createLocaleFiles };
@@ -205,6 +205,6 @@ function sortObjectByKeys(obj) {
205
205
  return Object.keys(obj).sort().reduce((acc, key) => ({ ...acc, [key]: obj[key] }), {});
206
206
  }
207
207
  const migrationsDebug = debug.extend("migrations");
208
- debug.extend("additions");
208
+ const additionsDebug = debug.extend("additions");
209
209
 
210
- export { addDependenciesToPackageJson, flushChanges, formatFiles, installNPMDependencies, isVersionGreater, migrationsDebug, printChanges, readJsonFile, removeDependenciesFromPackageJson };
210
+ export { addDependenciesToPackageJson, additionsDebug, flushChanges, formatFiles, installNPMDependencies, isVersionGreater, migrationsDebug, printChanges, readJsonFile, removeDependenciesFromPackageJson };
package/dist/constants.js CHANGED
@@ -1,13 +1,13 @@
1
1
  import { fileURLToPath } from 'node:url';
2
2
  import path from 'node:path';
3
3
 
4
- const __dirname = fileURLToPath(new URL(".", import.meta.url));
4
+ const __dirname$1 = fileURLToPath(new URL(".", import.meta.url));
5
5
  const IS_DEV = process.env.CREATE_PLUGIN_DEV !== void 0;
6
6
  const EXPORT_PATH_PREFIX = process.cwd();
7
- path.join(__dirname, "dist");
8
- const TEMPLATES_DIR = path.join(__dirname, "..", "templates");
7
+ path.join(__dirname$1, "dist");
8
+ const TEMPLATES_DIR = path.join(__dirname$1, "..", "templates");
9
9
  const PARTIALS_DIR = path.join(TEMPLATES_DIR, "_partials");
10
- path.join(__dirname, "..", "fixtures");
10
+ path.join(__dirname$1, "..", "fixtures");
11
11
  const TEMPLATE_PATHS = {
12
12
  app: path.join(TEMPLATES_DIR, "app"),
13
13
  scenesapp: path.join(TEMPLATES_DIR, "scenes-app"),
@@ -2,9 +2,9 @@ import { findUpSync } from 'find-up';
2
2
  import { readFileSync } from 'node:fs';
3
3
  import { fileURLToPath } from 'node:url';
4
4
 
5
- const __dirname = fileURLToPath(new URL(".", import.meta.url));
5
+ const __dirname$1 = fileURLToPath(new URL(".", import.meta.url));
6
6
  function getVersion() {
7
- const packageJsonPath = findUpSync("package.json", { cwd: __dirname });
7
+ const packageJsonPath = findUpSync("package.json", { cwd: __dirname$1 });
8
8
  if (!packageJsonPath) {
9
9
  throw `Could not find package.json`;
10
10
  }
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@grafana/create-plugin",
3
- "version": "6.3.0-canary.2314.19540598852.0",
3
+ "version": "6.3.0-canary.2320.19631436862.0",
4
4
  "repository": {
5
5
  "directory": "packages/create-plugin",
6
6
  "url": "https://github.com/grafana/plugin-tools"
@@ -32,7 +32,7 @@
32
32
  "debug": "^4.3.4",
33
33
  "enquirer": "^2.4.1",
34
34
  "find-up": "^8.0.0",
35
- "glob": "^11.0.0",
35
+ "glob": "^11.1.0",
36
36
  "handlebars": "^4.7.8",
37
37
  "jsonc-parser": "^3.3.1",
38
38
  "minimist": "^1.2.8",
@@ -61,5 +61,5 @@
61
61
  "engines": {
62
62
  "node": ">=20"
63
63
  },
64
- "gitHead": "45cfdfb7b4869737a8f7f437da9028de3e618024"
64
+ "gitHead": "7076bccb19de370a195a80655558f600ee067d25"
65
65
  }
@@ -0,0 +1,25 @@
1
+ # Create Plugin Codemods Guide
2
+
3
+ This guide provides specific instructions for working with migrations and additions in the create-plugin package.
4
+
5
+ ## Agent Behavior
6
+
7
+ - Refer to current migrations and additions typescript files found in @./additions/scripts and @./migrations/scripts
8
+ - When creating a new migration add it to the exported migrations object in @./migrations/migrations.ts
9
+ - Always refer to @./context.ts to know what methods are available on the context class
10
+ - Always check for file existence using the @./context.ts class before attempting to do anything with it
11
+ - Never write files with any 3rd party npm library. Use the context for all file operations
12
+ - Always return the context for the next migration
13
+ - Test thoroughly using the provided utils in @./test-utils.ts where necessary
14
+ - Each migration must be idempotent and must include a test case that uses the `.toBeIdempotent` custom matcher found in @../../vitest.setup.ts
15
+ - Keep migrations focused on one task
16
+ - Never attempt to read or write files outside the current working directory
17
+
18
+ ## Naming Conventions
19
+
20
+ - Each migration lives under @./migrations/scripts
21
+ - 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
22
+ - Each migration must have:
23
+ - `NNN-migration-title.ts` - main migration logic
24
+ - `NNN-migration-title.test.ts` - migration logic tests
25
+ - Each migration should export a default function named "migrate"
@@ -6,4 +6,9 @@ export default [
6
6
  description: 'Adds an example addition to the plugin',
7
7
  scriptPath: import.meta.resolve('./scripts/example-addition.js'),
8
8
  },
9
+ {
10
+ name: 'i18n',
11
+ description: 'Adds internationalization (i18n) support to the plugin',
12
+ scriptPath: import.meta.resolve('./scripts/i18n/index.js'),
13
+ },
9
14
  ] satisfies Codemod[];