@backstage/cli-module-translations 0.0.0-nightly-20260317031259

package/CHANGELOG.md

@@ -0,0 +1,13 @@
+# @backstage/cli-module-translations
+
+## 0.0.0-nightly-20260317031259
+
+### Minor Changes
+
+- 329f394: Initial release of the CLI module packages. Each module provides a set of commands that can be discovered automatically by `@backstage/cli` or executed standalone.
+
+### Patch Changes
+
+- Updated dependencies
+  - @backstage/cli-node@0.0.0-nightly-20260317031259
+  - @backstage/cli-common@0.0.0-nightly-20260317031259

package/README.md

@@ -0,0 +1,15 @@
+# @backstage/cli-module-translations
+
+CLI module that provides translation management commands for the Backstage CLI.
+
+## Commands
+
+| Command               | Description                                                                           |
+| :-------------------- | :------------------------------------------------------------------------------------ |
+| `translations export` | Export translation messages from an app and all of its frontend plugins to JSON files |
+| `translations import` | Generate translation resource wiring from translated JSON files                       |
+
+## Documentation
+
+- [Backstage Readme](https://github.com/backstage/backstage/blob/master/README.md)
+- [Backstage Documentation](https://backstage.io/docs)

package/bin/backstage-cli-module-translations

@@ -0,0 +1,32 @@
+#!/usr/bin/env node
+/*
+ * Copyright 2024 The Backstage Authors
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+const path = require('node:path');
+
+/* eslint-disable-next-line no-restricted-syntax */
+const isLocal = require('node:fs').existsSync(
+  path.resolve(__dirname, '../src'),
+);
+
+if (isLocal) {
+  require('@backstage/cli-node/config/nodeTransform.cjs');
+}
+
+const { runCliModule } = require('@backstage/cli-node');
+const cliModule = require(isLocal ? '../src/index' : '..').default;
+const pkg = require('../package.json');
+runCliModule({ module: cliModule, name: pkg.name, version: pkg.version });

package/dist/commands/export.cjs.js

@@ -0,0 +1,128 @@
+'use strict';
+
+Object.defineProperty(exports, '__esModule', { value: true });
+
+var cleye = require('cleye');
+var cliCommon = require('@backstage/cli-common');
+var fs = require('fs-extra');
+var node_path = require('node:path');
+var discoverPackages = require('../lib/discoverPackages.cjs.js');
+var extractTranslations = require('../lib/extractTranslations.cjs.js');
+var messageFilePath = require('../lib/messageFilePath.cjs.js');
+
+function _interopDefaultCompat (e) { return e && typeof e === 'object' && 'default' in e ? e : { default: e }; }
+
+var fs__default = /*#__PURE__*/_interopDefaultCompat(fs);
+
+var _export = async ({ args, info }) => {
+  const {
+    flags: { output, pattern }
+  } = cleye.cli(
+    {
+      help: info,
+      booleanFlagNegation: true,
+      flags: {
+        output: {
+          type: String,
+          default: "translations",
+          description: "Output directory for exported messages and manifest"
+        },
+        pattern: {
+          type: String,
+          default: messageFilePath.DEFAULT_MESSAGE_PATTERN,
+          description: "File path pattern for message files, with {id} and {lang} placeholders"
+        }
+      }
+    },
+    void 0,
+    args
+  );
+  const options = { output, pattern };
+  messageFilePath.validatePattern(options.pattern);
+  const targetPackageJson = await discoverPackages.readTargetPackage(
+    cliCommon.targetPaths.dir,
+    cliCommon.targetPaths.rootDir
+  );
+  const outputDir = node_path.resolve(cliCommon.targetPaths.dir, options.output);
+  const manifestPath = node_path.resolve(outputDir, "manifest.json");
+  const tsconfigPath = cliCommon.targetPaths.resolveRoot("tsconfig.json");
+  if (!await fs__default.default.pathExists(tsconfigPath)) {
+    throw new Error(
+      `No tsconfig.json found at ${tsconfigPath}. The translations export command requires a tsconfig.json in the repo root.`
+    );
+  }
+  console.log(
+    `Discovering frontend dependencies of ${targetPackageJson.name}...`
+  );
+  const packages = await discoverPackages.discoverFrontendPackages(
+    targetPackageJson,
+    cliCommon.targetPaths.dir
+  );
+  console.log(`Found ${packages.length} frontend packages to scan`);
+  console.log("Creating TypeScript project...");
+  const project = extractTranslations.createTranslationProject(tsconfigPath);
+  const allRefs = [];
+  for (const pkg of packages) {
+    for (const [exportPath, filePath] of pkg.entryPoints) {
+      try {
+        const sourceFile = project.addSourceFileAtPath(filePath);
+        const refs = extractTranslations.extractTranslationRefsFromSourceFile(
+          sourceFile,
+          pkg.name,
+          exportPath
+        );
+        allRefs.push(...refs);
+      } catch (error) {
+        console.warn(
+          `  Warning: failed to process ${pkg.name} (${exportPath}): ${error}`
+        );
+      }
+    }
+  }
+  if (allRefs.length === 0) {
+    console.log("No translation refs found.");
+    return;
+  }
+  console.log(`Found ${allRefs.length} translation ref(s):`);
+  for (const ref of allRefs) {
+    const messageCount = Object.keys(ref.messages).length;
+    console.log(`  ${ref.id} (${ref.packageName}, ${messageCount} messages)`);
+  }
+  for (const ref of allRefs) {
+    const relPath = messageFilePath.formatMessagePath(
+      options.pattern,
+      ref.id,
+      messageFilePath.DEFAULT_LANGUAGE
+    );
+    const filePath = node_path.resolve(outputDir, relPath);
+    await fs__default.default.ensureDir(node_path.dirname(filePath));
+    await fs__default.default.writeJson(filePath, ref.messages, { spaces: 2 });
+  }
+  const manifest = {};
+  for (const ref of allRefs) {
+    manifest[ref.id] = {
+      package: ref.packageName,
+      exportPath: ref.exportPath,
+      exportName: ref.exportName
+    };
+  }
+  await fs__default.default.writeJson(
+    manifestPath,
+    { pattern: options.pattern, refs: manifest },
+    { spaces: 2 }
+  );
+  const examplePath = messageFilePath.formatMessagePath(
+    options.pattern,
+    "<ref-id>",
+    messageFilePath.DEFAULT_LANGUAGE
+  );
+  console.log(
+    `
+Exported ${allRefs.length} translation ref(s) to ${options.output}/`
+  );
+  console.log(`  Messages: ${options.output}/${examplePath}`);
+  console.log(`  Manifest: ${options.output}/manifest.json`);
+};
+
+exports.default = _export;
+//# sourceMappingURL=export.cjs.js.map

package/dist/commands/export.cjs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"export.cjs.js","sources":["../../src/commands/export.ts"],"sourcesContent":["/*\n * Copyright 2026 The Backstage Authors\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *     http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport { cli } from 'cleye';\nimport { targetPaths } from '@backstage/cli-common';\nimport fs from 'fs-extra';\nimport { dirname, resolve as resolvePath } from 'node:path';\nimport {\n  discoverFrontendPackages,\n  readTargetPackage,\n} from '../lib/discoverPackages';\nimport {\n  createTranslationProject,\n  extractTranslationRefsFromSourceFile,\n  TranslationRefInfo,\n} from '../lib/extractTranslations';\nimport {\n  DEFAULT_LANGUAGE,\n  DEFAULT_MESSAGE_PATTERN,\n  formatMessagePath,\n  validatePattern,\n} from '../lib/messageFilePath';\nimport type { CliCommandContext } from '@backstage/cli-node';\n\nexport default async ({ args, info }: CliCommandContext) => {\n  const {\n    flags: { output, pattern },\n  } = cli(\n    {\n      help: info,\n      booleanFlagNegation: true,\n      flags: {\n        output: {\n          type: String,\n          default: 'translations',\n          description: 'Output directory for exported messages and manifest',\n        },\n        pattern: {\n          type: String,\n          default: DEFAULT_MESSAGE_PATTERN,\n          description:\n            'File path pattern for message files, with {id} and {lang} placeholders',\n        },\n      },\n    },\n    undefined,\n    args,\n  );\n\n  const options = { output, pattern };\n\n  validatePattern(options.pattern);\n\n  const targetPackageJson = await readTargetPackage(\n    targetPaths.dir,\n    targetPaths.rootDir,\n  );\n\n  const outputDir = resolvePath(targetPaths.dir, options.output);\n  const manifestPath = resolvePath(outputDir, 'manifest.json');\n\n  const tsconfigPath = targetPaths.resolveRoot('tsconfig.json');\n  if (!(await fs.pathExists(tsconfigPath))) {\n    throw new Error(\n      `No tsconfig.json found at ${tsconfigPath}. ` +\n        'The translations export command requires a tsconfig.json in the repo root.',\n    );\n  }\n\n  console.log(\n    `Discovering frontend dependencies of ${targetPackageJson.name}...`,\n  );\n  const packages = await discoverFrontendPackages(\n    targetPackageJson,\n    targetPaths.dir,\n  );\n  console.log(`Found ${packages.length} frontend packages to scan`);\n\n  console.log('Creating TypeScript project...');\n  const project = createTranslationProject(tsconfigPath);\n\n  const allRefs: TranslationRefInfo[] = [];\n\n  for (const pkg of packages) {\n    for (const [exportPath, filePath] of pkg.entryPoints) {\n      try {\n        const sourceFile = project.addSourceFileAtPath(filePath);\n        const refs = extractTranslationRefsFromSourceFile(\n          sourceFile,\n          pkg.name,\n          exportPath,\n        );\n        allRefs.push(...refs);\n      } catch (error) {\n        console.warn(\n          `  Warning: failed to process ${pkg.name} (${exportPath}): ${error}`,\n        );\n      }\n    }\n  }\n\n  if (allRefs.length === 0) {\n    console.log('No translation refs found.');\n    return;\n  }\n\n  console.log(`Found ${allRefs.length} translation ref(s):`);\n  for (const ref of allRefs) {\n    const messageCount = Object.keys(ref.messages).length;\n    console.log(`  ${ref.id} (${ref.packageName}, ${messageCount} messages)`);\n  }\n\n  // Write message files using the configured pattern\n  for (const ref of allRefs) {\n    const relPath = formatMessagePath(\n      options.pattern,\n      ref.id,\n      DEFAULT_LANGUAGE,\n    );\n    const filePath = resolvePath(outputDir, relPath);\n    await fs.ensureDir(dirname(filePath));\n    await fs.writeJson(filePath, ref.messages, { spaces: 2 });\n  }\n\n  // Write manifest\n  const manifest: Record<string, object> = {};\n  for (const ref of allRefs) {\n    manifest[ref.id] = {\n      package: ref.packageName,\n      exportPath: ref.exportPath,\n      exportName: ref.exportName,\n    };\n  }\n  await fs.writeJson(\n    manifestPath,\n    { pattern: options.pattern, refs: manifest },\n    { spaces: 2 },\n  );\n\n  const examplePath = formatMessagePath(\n    options.pattern,\n    '<ref-id>',\n    DEFAULT_LANGUAGE,\n  );\n  console.log(\n    `\\nExported ${allRefs.length} translation ref(s) to ${options.output}/`,\n  );\n  console.log(`  Messages: ${options.output}/${examplePath}`);\n  console.log(`  Manifest: ${options.output}/manifest.json`);\n};\n"],"names":["cli","DEFAULT_MESSAGE_PATTERN","validatePattern","readTargetPackage","targetPaths","resolvePath","fs","discoverFrontendPackages","createTranslationProject","extractTranslationRefsFromSourceFile","formatMessagePath","DEFAULT_LANGUAGE","dirname"],"mappings":"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"}

package/dist/commands/import.cjs.js

@@ -0,0 +1,165 @@
+'use strict';
+
+Object.defineProperty(exports, '__esModule', { value: true });
+
+var cleye = require('cleye');
+var cliCommon = require('@backstage/cli-common');
+var fs = require('fs-extra');
+var node_path = require('node:path');
+var discoverPackages = require('../lib/discoverPackages.cjs.js');
+var messageFilePath = require('../lib/messageFilePath.cjs.js');
+
+function _interopDefaultCompat (e) { return e && typeof e === 'object' && 'default' in e ? e : { default: e }; }
+
+var fs__default = /*#__PURE__*/_interopDefaultCompat(fs);
+
+var _import = async ({ args, info }) => {
+  const {
+    flags: { input, output }
+  } = cleye.cli(
+    {
+      help: info,
+      booleanFlagNegation: true,
+      flags: {
+        input: {
+          type: String,
+          default: "translations",
+          description: "Input directory containing the manifest and translated message files"
+        },
+        output: {
+          type: String,
+          default: "src/translations/resources.ts",
+          description: "Output path for the generated wiring module"
+        }
+      }
+    },
+    void 0,
+    args
+  );
+  const options = { input, output };
+  await discoverPackages.readTargetPackage(cliCommon.targetPaths.dir, cliCommon.targetPaths.rootDir);
+  const inputDir = node_path.resolve(cliCommon.targetPaths.dir, options.input);
+  const manifestPath = node_path.resolve(inputDir, "manifest.json");
+  const outputPath = node_path.resolve(cliCommon.targetPaths.dir, options.output);
+  if (!await fs__default.default.pathExists(manifestPath)) {
+    throw new Error(
+      `No manifest.json found at ${manifestPath}. Run "backstage-cli translations export" first.`
+    );
+  }
+  const manifest = await fs__default.default.readJson(manifestPath);
+  if (!manifest.pattern) {
+    throw new Error(
+      'No pattern found in manifest.json. Re-run "backstage-cli translations export" to regenerate it.'
+    );
+  }
+  const pattern = manifest.pattern;
+  const parsePath = messageFilePath.createMessagePathParser(pattern);
+  const allFiles = (await collectJsonFiles(inputDir)).filter(
+    (f) => f !== "manifest.json"
+  );
+  const translationsByRef = /* @__PURE__ */ new Map();
+  let skipped = 0;
+  for (const relPath of allFiles) {
+    const parsed = parsePath(relPath);
+    if (!parsed) {
+      skipped++;
+      continue;
+    }
+    if (parsed.lang === messageFilePath.DEFAULT_LANGUAGE) {
+      continue;
+    }
+    if (!manifest.refs[parsed.id]) {
+      console.warn(
+        `  Warning: skipping ${relPath} - ref '${parsed.id}' not found in manifest`
+      );
+      continue;
+    }
+    const existing = translationsByRef.get(parsed.id) ?? [];
+    existing.push({ lang: parsed.lang, relPath });
+    translationsByRef.set(parsed.id, existing);
+  }
+  if (skipped > 0) {
+    console.warn(
+      `  Warning: ${skipped} file(s) did not match the pattern '${pattern}'`
+    );
+  }
+  if (translationsByRef.size === 0) {
+    console.log("No translated message files found.");
+    const example = messageFilePath.formatMessagePath(pattern, "<ref-id>", "sv");
+    console.log(
+      `Add translated files as ${example} in the translations directory.`
+    );
+    return;
+  }
+  const importLines = [];
+  const resourceLines = [];
+  importLines.push(
+    "import { createTranslationResource } from '@backstage/frontend-plugin-api';"
+  );
+  for (const [refId, entries] of [...translationsByRef.entries()].sort(
+    ([a], [b]) => a.localeCompare(b)
+  )) {
+    const refEntry = manifest.refs[refId];
+    const importPath = refEntry.exportPath === "." ? refEntry.package : `${refEntry.package}/${refEntry.exportPath.replace(/^\.\//, "")}`;
+    importLines.push(`import { ${refEntry.exportName} } from '${importPath}';`);
+    const translationEntries = entries.sort((a, b) => a.lang.localeCompare(b.lang)).map(({ lang, relPath }) => {
+      const jsonRelPath = node_path.relative(
+        node_path.resolve(outputPath, ".."),
+        node_path.resolve(inputDir, relPath)
+      ).split(node_path.sep).join("/");
+      return `    ${JSON.stringify(lang)}: () => import('./${jsonRelPath}'),`;
+    }).join("\n");
+    resourceLines.push(
+      [
+        `  createTranslationResource({`,
+        `    ref: ${refEntry.exportName},`,
+        `    translations: {`,
+        translationEntries,
+        `    },`,
+        `  }),`
+      ].join("\n")
+    );
+  }
+  const fileContent = [
+    "// This file is auto-generated by backstage-cli translations import",
+    "// Do not edit manually.",
+    "",
+    ...importLines,
+    "",
+    "export default [",
+    ...resourceLines,
+    "];",
+    ""
+  ].join("\n");
+  await fs__default.default.ensureDir(node_path.resolve(outputPath, ".."));
+  await fs__default.default.writeFile(outputPath, fileContent, "utf8");
+  const totalFiles = [...translationsByRef.values()].reduce(
+    (sum, e) => sum + e.length,
+    0
+  );
+  console.log(`Generated translation resources at ${options.output}`);
+  console.log(
+    `  ${translationsByRef.size} ref(s), ${totalFiles} translation file(s)`
+  );
+  console.log(
+    "\nImport this file in your app and pass the resources to your translation API setup."
+  );
+};
+async function collectJsonFiles(dir, prefix = "") {
+  const entries = await fs__default.default.readdir(dir, { withFileTypes: true });
+  const results = [];
+  for (const entry of entries) {
+    const relPath = prefix ? `${prefix}/${entry.name}` : entry.name;
+    if (entry.isDirectory()) {
+      results.push(
+        ...await collectJsonFiles(node_path.resolve(dir, entry.name), relPath)
+      );
+    } else if (entry.isFile() && entry.name.endsWith(".json")) {
+      results.push(relPath);
+    }
+  }
+  return results;
+}
+
+exports.default = _import;
+//# sourceMappingURL=import.cjs.js.map

package/dist/commands/import.cjs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"import.cjs.js","sources":["../../src/commands/import.ts"],"sourcesContent":["/*\n * Copyright 2026 The Backstage Authors\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *     http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport { cli } from 'cleye';\nimport { targetPaths } from '@backstage/cli-common';\nimport fs from 'fs-extra';\nimport {\n  resolve as resolvePath,\n  relative as relativePath,\n  sep,\n} from 'node:path';\nimport { readTargetPackage } from '../lib/discoverPackages';\nimport {\n  DEFAULT_LANGUAGE,\n  createMessagePathParser,\n  formatMessagePath,\n} from '../lib/messageFilePath';\nimport type { CliCommandContext } from '@backstage/cli-node';\n\ninterface ManifestRefEntry {\n  package: string;\n  exportPath: string;\n  exportName: string;\n}\n\ninterface Manifest {\n  pattern?: string;\n  refs: Record<string, ManifestRefEntry>;\n}\n\nexport default async ({ args, info }: CliCommandContext) => {\n  const {\n    flags: { input, output },\n  } = cli(\n    {\n      help: info,\n      booleanFlagNegation: true,\n      flags: {\n        input: {\n          type: String,\n          default: 'translations',\n          description:\n            'Input directory containing the manifest and translated message files',\n        },\n        output: {\n          type: String,\n          default: 'src/translations/resources.ts',\n          description: 'Output path for the generated wiring module',\n        },\n      },\n    },\n    undefined,\n    args,\n  );\n\n  const options = { input, output };\n  await readTargetPackage(targetPaths.dir, targetPaths.rootDir);\n\n  const inputDir = resolvePath(targetPaths.dir, options.input);\n  const manifestPath = resolvePath(inputDir, 'manifest.json');\n  const outputPath = resolvePath(targetPaths.dir, options.output);\n\n  if (!(await fs.pathExists(manifestPath))) {\n    throw new Error(\n      `No manifest.json found at ${manifestPath}. ` +\n        'Run \"backstage-cli translations export\" first.',\n    );\n  }\n\n  const manifest: Manifest = await fs.readJson(manifestPath);\n\n  if (!manifest.pattern) {\n    throw new Error(\n      'No pattern found in manifest.json. Re-run \"backstage-cli translations export\" to regenerate it.',\n    );\n  }\n  const pattern = manifest.pattern;\n\n  const parsePath = createMessagePathParser(pattern);\n\n  // Discover all JSON files under the translations directory\n  const allFiles = (await collectJsonFiles(inputDir)).filter(\n    f => f !== 'manifest.json',\n  );\n\n  // Parse each file to extract id + lang, filtering out default language files\n  const translationsByRef = new Map<\n    string,\n    Array<{ lang: string; relPath: string }>\n  >();\n  let skipped = 0;\n\n  for (const relPath of allFiles) {\n    const parsed = parsePath(relPath);\n    if (!parsed) {\n      skipped++;\n      continue;\n    }\n\n    if (parsed.lang === DEFAULT_LANGUAGE) {\n      continue;\n    }\n\n    if (!manifest.refs[parsed.id]) {\n      console.warn(\n        `  Warning: skipping ${relPath} - ref '${parsed.id}' not found in manifest`,\n      );\n      continue;\n    }\n\n    const existing = translationsByRef.get(parsed.id) ?? [];\n    existing.push({ lang: parsed.lang, relPath });\n    translationsByRef.set(parsed.id, existing);\n  }\n\n  if (skipped > 0) {\n    console.warn(\n      `  Warning: ${skipped} file(s) did not match the pattern '${pattern}'`,\n    );\n  }\n\n  if (translationsByRef.size === 0) {\n    console.log('No translated message files found.');\n    const example = formatMessagePath(pattern, '<ref-id>', 'sv');\n    console.log(\n      `Add translated files as ${example} in the translations directory.`,\n    );\n    return;\n  }\n\n  // Generate the wiring module\n  const importLines: string[] = [];\n  const resourceLines: string[] = [];\n\n  importLines.push(\n    \"import { createTranslationResource } from '@backstage/frontend-plugin-api';\",\n  );\n\n  for (const [refId, entries] of [...translationsByRef.entries()].sort(\n    ([a], [b]) => a.localeCompare(b),\n  )) {\n    const refEntry = manifest.refs[refId];\n    const importPath =\n      refEntry.exportPath === '.'\n        ? refEntry.package\n        : `${refEntry.package}/${refEntry.exportPath.replace(/^\\.\\//, '')}`;\n\n    importLines.push(`import { ${refEntry.exportName} } from '${importPath}';`);\n\n    const translationEntries = entries\n      .sort((a, b) => a.lang.localeCompare(b.lang))\n      .map(({ lang, relPath }) => {\n        const jsonRelPath = relativePath(\n          resolvePath(outputPath, '..'),\n          resolvePath(inputDir, relPath),\n        )\n          .split(sep)\n          .join('/');\n        return `    ${JSON.stringify(lang)}: () => import('./${jsonRelPath}'),`;\n      })\n      .join('\\n');\n\n    resourceLines.push(\n      [\n        `  createTranslationResource({`,\n        `    ref: ${refEntry.exportName},`,\n        `    translations: {`,\n        translationEntries,\n        `    },`,\n        `  }),`,\n      ].join('\\n'),\n    );\n  }\n\n  const fileContent = [\n    '// This file is auto-generated by backstage-cli translations import',\n    '// Do not edit manually.',\n    '',\n    ...importLines,\n    '',\n    'export default [',\n    ...resourceLines,\n    '];',\n    '',\n  ].join('\\n');\n\n  await fs.ensureDir(resolvePath(outputPath, '..'));\n  await fs.writeFile(outputPath, fileContent, 'utf8');\n\n  const totalFiles = [...translationsByRef.values()].reduce(\n    (sum, e) => sum + e.length,\n    0,\n  );\n  console.log(`Generated translation resources at ${options.output}`);\n  console.log(\n    `  ${translationsByRef.size} ref(s), ${totalFiles} translation file(s)`,\n  );\n  console.log(\n    '\\nImport this file in your app and pass the resources to your translation API setup.',\n  );\n};\n\n/**\n * Recursively collects all .json files under a directory, returning paths\n * relative to that directory using forward slashes.\n */\nasync function collectJsonFiles(dir: string, prefix = ''): Promise<string[]> {\n  const entries = await fs.readdir(dir, { withFileTypes: true });\n  const results: string[] = [];\n\n  for (const entry of entries) {\n    const relPath = prefix ? `${prefix}/${entry.name}` : entry.name;\n    if (entry.isDirectory()) {\n      results.push(\n        ...(await collectJsonFiles(resolvePath(dir, entry.name), relPath)),\n      );\n    } else if (entry.isFile() && entry.name.endsWith('.json')) {\n      results.push(relPath);\n    }\n  }\n\n  return results;\n}\n"],"names":["cli","readTargetPackage","targetPaths","resolvePath","fs","createMessagePathParser","DEFAULT_LANGUAGE","formatMessagePath","relativePath","sep"],"mappings":"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"}

package/dist/index.cjs.js

@@ -0,0 +1,25 @@
+'use strict';
+
+Object.defineProperty(exports, '__esModule', { value: true });
+
+var cliNode = require('@backstage/cli-node');
+var _package = require('./package.json.cjs.js');
+
+var index = cliNode.createCliModule({
+  packageJson: _package.default,
+  init: async (reg) => {
+    reg.addCommand({
+      path: ["translations", "export"],
+      description: "Export translation messages from an app and all of its frontend plugins to JSON files",
+      execute: { loader: () => import('./commands/export.cjs.js') }
+    });
+    reg.addCommand({
+      path: ["translations", "import"],
+      description: "Generate translation resource wiring from translated JSON files",
+      execute: { loader: () => import('./commands/import.cjs.js') }
+    });
+  }
+});
+
+exports.default = index;
+//# sourceMappingURL=index.cjs.js.map

package/dist/index.cjs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.cjs.js","sources":["../src/index.ts"],"sourcesContent":["/*\n * Copyright 2026 The Backstage Authors\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *     http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\nimport { createCliModule } from '@backstage/cli-node';\nimport packageJson from '../package.json';\n\nexport default createCliModule({\n  packageJson,\n  init: async reg => {\n    reg.addCommand({\n      path: ['translations', 'export'],\n      description:\n        'Export translation messages from an app and all of its frontend plugins to JSON files',\n      execute: { loader: () => import('./commands/export') },\n    });\n\n    reg.addCommand({\n      path: ['translations', 'import'],\n      description:\n        'Generate translation resource wiring from translated JSON files',\n      execute: { loader: () => import('./commands/import') },\n    });\n  },\n});\n"],"names":["createCliModule","packageJson"],"mappings":";;;;;;;AAkBA,YAAeA,uBAAA,CAAgB;AAAA,eAC7BC,gBAAA;AAAA,EACA,IAAA,EAAM,OAAM,GAAA,KAAO;AACjB,IAAA,GAAA,CAAI,UAAA,CAAW;AAAA,MACb,IAAA,EAAM,CAAC,cAAA,EAAgB,QAAQ,CAAA;AAAA,MAC/B,WAAA,EACE,uFAAA;AAAA,MACF,SAAS,EAAE,MAAA,EAAQ,MAAM,OAAO,0BAAmB,CAAA;AAAE,KACtD,CAAA;AAED,IAAA,GAAA,CAAI,UAAA,CAAW;AAAA,MACb,IAAA,EAAM,CAAC,cAAA,EAAgB,QAAQ,CAAA;AAAA,MAC/B,WAAA,EACE,iEAAA;AAAA,MACF,SAAS,EAAE,MAAA,EAAQ,MAAM,OAAO,0BAAmB,CAAA;AAAE,KACtD,CAAA;AAAA,EACH;AACF,CAAC,CAAA;;;;"}

package/dist/index.d.ts

@@ -0,0 +1,5 @@
+import * as _backstage_cli_node from '@backstage/cli-node';
+
+declare const _default: _backstage_cli_node.CliModule;
+
+export { _default as default };

package/dist/lib/discoverPackages.cjs.js

@@ -0,0 +1,121 @@
+'use strict';
+
+var cliNode = require('@backstage/cli-node');
+var node_path = require('node:path');
+var fs = require('fs-extra');
+
+function _interopDefaultCompat (e) { return e && typeof e === 'object' && 'default' in e ? e : { default: e }; }
+
+var fs__default = /*#__PURE__*/_interopDefaultCompat(fs);
+
+async function readTargetPackage(packageDir, repoRoot) {
+  const packageJsonPath = node_path.resolve(packageDir, "package.json");
+  if (!await fs__default.default.pathExists(packageJsonPath)) {
+    throw new Error(
+      "No package.json found in the current directory. The translations commands must be run from within a package directory."
+    );
+  }
+  if (node_path.resolve(packageDir) === node_path.resolve(repoRoot)) {
+    throw new Error(
+      "The translations commands must be run from within a package directory, not from the repository root. For example: cd packages/app && backstage-cli translations export"
+    );
+  }
+  return fs__default.default.readJson(packageJsonPath);
+}
+async function discoverFrontendPackages(targetPackageJson, targetDir) {
+  let workspaceByName;
+  try {
+    const workspacePackages = await cliNode.PackageGraph.listTargetPackages();
+    workspaceByName = new Map(
+      workspacePackages.map((p) => [p.packageJson.name, p])
+    );
+  } catch {
+    workspaceByName = /* @__PURE__ */ new Map();
+  }
+  const visited = /* @__PURE__ */ new Set();
+  const result = [];
+  async function visit(packageJson, pkgDir, includeDevDeps) {
+    const deps = {
+      ...packageJson.dependencies,
+      ...includeDevDeps ? packageJson.devDependencies ?? {} : {}
+    };
+    for (const depName of Object.keys(deps)) {
+      if (visited.has(depName)) {
+        continue;
+      }
+      visited.add(depName);
+      let depPkgJson;
+      let depDir;
+      let isWorkspace;
+      const workspacePkg = workspaceByName.get(depName);
+      if (workspacePkg) {
+        depPkgJson = workspacePkg.packageJson;
+        depDir = workspacePkg.dir;
+        isWorkspace = true;
+      } else {
+        try {
+          const pkgJsonPath = require.resolve(`${depName}/package.json`, {
+            paths: [pkgDir]
+          });
+          depPkgJson = await fs__default.default.readJson(pkgJsonPath);
+          depDir = node_path.dirname(pkgJsonPath);
+          isWorkspace = false;
+        } catch {
+          continue;
+        }
+      }
+      if (!depPkgJson.backstage) {
+        continue;
+      }
+      const role = depPkgJson.backstage?.role;
+      if (role && isFrontendRole(role)) {
+        const entryPoints = resolveEntryPoints(depPkgJson, depDir, isWorkspace);
+        if (entryPoints.size > 0) {
+          result.push({ name: depName, dir: depDir, entryPoints });
+        }
+      }
+      await visit(depPkgJson, depDir, false);
+    }
+  }
+  await visit(targetPackageJson, targetDir, true);
+  return result;
+}
+function resolveEntryPoints(packageJson, packageDir, isWorkspace) {
+  const entryPoints = /* @__PURE__ */ new Map();
+  const exports$1 = packageJson.exports;
+  if (exports$1) {
+    for (const [subpath, target] of Object.entries(exports$1)) {
+      if (subpath === "./package.json") {
+        continue;
+      }
+      let filePath;
+      if (typeof target === "string") {
+        filePath = target;
+      } else if (isWorkspace) {
+        filePath = target?.import ?? target?.types ?? target?.default;
+      } else {
+        filePath = target?.types ?? target?.import ?? target?.default;
+      }
+      if (typeof filePath === "string") {
+        entryPoints.set(subpath, node_path.resolve(packageDir, filePath));
+      }
+    }
+  } else {
+    const main = isWorkspace ? packageJson.main ?? packageJson.types : packageJson.types ?? packageJson.main;
+    if (main) {
+      entryPoints.set(".", node_path.resolve(packageDir, main));
+    }
+  }
+  return entryPoints;
+}
+function isFrontendRole(role) {
+  try {
+    return cliNode.PackageRoles.getRoleInfo(role).platform === "web";
+  } catch {
+    return false;
+  }
+}
+
+exports.discoverFrontendPackages = discoverFrontendPackages;
+exports.readTargetPackage = readTargetPackage;
+//# sourceMappingURL=discoverPackages.cjs.js.map

package/dist/lib/discoverPackages.cjs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"discoverPackages.cjs.js","sources":["../../src/lib/discoverPackages.ts"],"sourcesContent":["/*\n * Copyright 2026 The Backstage Authors\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *     http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport {\n  BackstagePackageJson,\n  PackageGraph,\n  PackageRoles,\n} from '@backstage/cli-node';\nimport { dirname, resolve as resolvePath } from 'node:path';\nimport fs from 'fs-extra';\n\n/** A discovered package with its entry points resolved to file paths. */\nexport interface DiscoveredPackage {\n  /** The package name, e.g. '@backstage/plugin-org' */\n  name: string;\n  /** The directory of the package */\n  dir: string;\n  /** Map of export subpath (e.g. '.', './alpha') to the resolved file path */\n  entryPoints: Map<string, string>;\n}\n\n/**\n * Reads the package.json from the given directory and validates that it\n * is a workspace package (not the repo root).\n */\nexport async function readTargetPackage(\n  packageDir: string,\n  repoRoot: string,\n): Promise<BackstagePackageJson> {\n  const packageJsonPath = resolvePath(packageDir, 'package.json');\n\n  if (!(await fs.pathExists(packageJsonPath))) {\n    throw new Error(\n      'No package.json found in the current directory. ' +\n        'The translations commands must be run from within a package directory.',\n    );\n  }\n\n  if (resolvePath(packageDir) === resolvePath(repoRoot)) {\n    throw new Error(\n      'The translations commands must be run from within a package directory, ' +\n        'not from the repository root. For example: cd packages/app && backstage-cli translations export',\n    );\n  }\n\n  return fs.readJson(packageJsonPath);\n}\n\n/**\n * Discovers frontend packages that are transitive dependencies of the given\n * target package and resolves their entry point file paths. Walks both\n * workspace packages (source) and npm-installed packages (declaration files).\n */\nexport async function discoverFrontendPackages(\n  targetPackageJson: BackstagePackageJson,\n  targetDir: string,\n): Promise<DiscoveredPackage[]> {\n  // Build a lookup of workspace packages for preferring source over dist\n  let workspaceByName: Map<\n    string,\n    { packageJson: BackstagePackageJson; dir: string }\n  >;\n  try {\n    const workspacePackages = await PackageGraph.listTargetPackages();\n    workspaceByName = new Map(\n      workspacePackages.map(p => [p.packageJson.name, p]),\n    );\n  } catch {\n    workspaceByName = new Map();\n  }\n\n  const visited = new Set<string>();\n  const result: DiscoveredPackage[] = [];\n\n  async function visit(\n    packageJson: BackstagePackageJson,\n    pkgDir: string,\n    includeDevDeps: boolean,\n  ) {\n    const deps: Record<string, string> = {\n      ...packageJson.dependencies,\n      ...(includeDevDeps ? packageJson.devDependencies ?? {} : {}),\n    };\n\n    for (const depName of Object.keys(deps)) {\n      if (visited.has(depName)) {\n        continue;\n      }\n      visited.add(depName);\n\n      let depPkgJson: BackstagePackageJson;\n      let depDir: string;\n      let isWorkspace: boolean;\n\n      // Prefer workspace package (has source files) over npm-installed\n      const workspacePkg = workspaceByName.get(depName);\n      if (workspacePkg) {\n        depPkgJson = workspacePkg.packageJson;\n        depDir = workspacePkg.dir;\n        isWorkspace = true;\n      } else {\n        try {\n          const pkgJsonPath = require.resolve(`${depName}/package.json`, {\n            paths: [pkgDir],\n          });\n          depPkgJson = await fs.readJson(pkgJsonPath);\n          depDir = dirname(pkgJsonPath);\n          isWorkspace = false;\n        } catch {\n          continue;\n        }\n      }\n\n      // Only recurse into Backstage ecosystem packages\n      if (!depPkgJson.backstage) {\n        continue;\n      }\n\n      const role = depPkgJson.backstage?.role;\n      if (role && isFrontendRole(role)) {\n        const entryPoints = resolveEntryPoints(depPkgJson, depDir, isWorkspace);\n        if (entryPoints.size > 0) {\n          result.push({ name: depName, dir: depDir, entryPoints });\n        }\n      }\n\n      // Walk this package's production dependencies for transitive refs\n      await visit(depPkgJson, depDir, false);\n    }\n  }\n\n  // Start from the target, including its devDependencies\n  await visit(targetPackageJson, targetDir, true);\n\n  return result;\n}\n\n/**\n * Resolves the entry points of a package to absolute file paths.\n * For workspace packages, prefers source entry points (import/default).\n * For npm packages, prefers type declaration entry points (.d.ts).\n */\nfunction resolveEntryPoints(\n  packageJson: BackstagePackageJson,\n  packageDir: string,\n  isWorkspace: boolean,\n): Map<string, string> {\n  const entryPoints = new Map<string, string>();\n\n  const exports = (packageJson as any).exports as\n    | Record<string, string | Record<string, string>>\n    | undefined;\n\n  if (exports) {\n    for (const [subpath, target] of Object.entries(exports)) {\n      if (subpath === './package.json') {\n        continue;\n      }\n\n      let filePath: string | undefined;\n      if (typeof target === 'string') {\n        filePath = target;\n      } else if (isWorkspace) {\n        // Workspace: exports point to source .ts files\n        filePath = target?.import ?? target?.types ?? target?.default;\n      } else {\n        // npm: prefer .d.ts for type-based extraction\n        filePath = target?.types ?? target?.import ?? target?.default;\n      }\n\n      if (typeof filePath === 'string') {\n        entryPoints.set(subpath, resolvePath(packageDir, filePath));\n      }\n    }\n  } else {\n    // Fallback: prefer types for npm, source for workspace\n    const main = isWorkspace\n      ? packageJson.main ?? packageJson.types\n      : packageJson.types ?? packageJson.main;\n    if (main) {\n      entryPoints.set('.', resolvePath(packageDir, main));\n    }\n  }\n\n  return entryPoints;\n}\n\nfunction isFrontendRole(role: string): boolean {\n  try {\n    return PackageRoles.getRoleInfo(role).platform === 'web';\n  } catch {\n    return false;\n  }\n}\n"],"names":["resolvePath","fs","PackageGraph","dirname","exports","PackageRoles"],"mappings":"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"}

package/dist/lib/extractTranslations.cjs.js

@@ -0,0 +1,71 @@
+'use strict';
+
+var tsMorph = require('ts-morph');
+
+function extractTranslationRefsFromSourceFile(sourceFile, packageName, exportPath) {
+  const results = [];
+  for (const exportSymbol of sourceFile.getExportSymbols()) {
+    const declarations = exportSymbol.getDeclarations();
+    if (declarations.length === 0) {
+      continue;
+    }
+    const declaration = declarations[0];
+    const exportType = declaration.getType();
+    const refInfo = extractTranslationRefFromType(exportType, declaration);
+    if (!refInfo) {
+      continue;
+    }
+    results.push({
+      ...refInfo,
+      packageName,
+      exportPath,
+      exportName: exportSymbol.getName()
+    });
+  }
+  return results;
+}
+function extractTranslationRefFromType(type, declaration) {
+  const resolvedType = type.getTargetType() ?? type;
+  const $$typeProperty = resolvedType.getProperties().find((p) => p.getName() === "$$type");
+  if (!$$typeProperty) {
+    return void 0;
+  }
+  const $$typeDecl = $$typeProperty.getValueDeclaration();
+  if (!$$typeDecl) {
+    return void 0;
+  }
+  if (!$$typeDecl.getText().includes("'@backstage/TranslationRef'")) {
+    return void 0;
+  }
+  const typeArgs = type.getTypeArguments();
+  if (typeArgs.length < 2) {
+    return void 0;
+  }
+  const [idType, messagesType] = typeArgs;
+  if (!idType.isStringLiteral()) {
+    return void 0;
+  }
+  const id = idType.getLiteralValueOrThrow();
+  const messages = {};
+  for (const messageProp of messagesType.getProperties()) {
+    const key = messageProp.getName();
+    const propType = messageProp.getTypeAtLocation(declaration);
+    if (propType.isStringLiteral()) {
+      messages[key] = propType.getLiteralValueOrThrow();
+    }
+  }
+  if (Object.keys(messages).length === 0) {
+    return void 0;
+  }
+  return { id, messages };
+}
+function createTranslationProject(tsconfigPath) {
+  return new tsMorph.Project({
+    tsConfigFilePath: tsconfigPath,
+    skipAddingFilesFromTsConfig: true
+  });
+}
+
+exports.createTranslationProject = createTranslationProject;
+exports.extractTranslationRefsFromSourceFile = extractTranslationRefsFromSourceFile;
+//# sourceMappingURL=extractTranslations.cjs.js.map

package/dist/lib/extractTranslations.cjs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"extractTranslations.cjs.js","sources":["../../src/lib/extractTranslations.ts"],"sourcesContent":["/*\n * Copyright 2026 The Backstage Authors\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *     http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport { Node, Project, SourceFile, Type, ts } from 'ts-morph';\n\n/** Information about a discovered translation ref. */\nexport interface TranslationRefInfo {\n  /** The ref ID, e.g. 'org' */\n  id: string;\n  /** The package name, e.g. '@backstage/plugin-org' */\n  packageName: string;\n  /** The subpath export where this ref is accessible, e.g. './alpha' or '.' */\n  exportPath: string;\n  /** The exported symbol name, e.g. 'orgTranslationRef' */\n  exportName: string;\n  /** Flattened message map: key -> default message string */\n  messages: Record<string, string>;\n}\n\n/**\n * Given a ts-morph SourceFile, finds all exported TranslationRef symbols\n * and extracts their id and messages from the type system.\n */\nexport function extractTranslationRefsFromSourceFile(\n  sourceFile: SourceFile,\n  packageName: string,\n  exportPath: string,\n): TranslationRefInfo[] {\n  const results: TranslationRefInfo[] = [];\n\n  for (const exportSymbol of sourceFile.getExportSymbols()) {\n    const declarations = exportSymbol.getDeclarations();\n    if (declarations.length === 0) {\n      continue;\n    }\n\n    const declaration = declarations[0];\n    const exportType = declaration.getType();\n\n    const refInfo = extractTranslationRefFromType(exportType, declaration);\n    if (!refInfo) {\n      continue;\n    }\n\n    results.push({\n      ...refInfo,\n      packageName,\n      exportPath,\n      exportName: exportSymbol.getName(),\n    });\n  }\n\n  return results;\n}\n\n/**\n * Checks whether a type is a TranslationRef by inspecting the $$type\n * property on the target type, then extracts the id and messages from\n * the type arguments of the generic instantiation.\n */\nfunction extractTranslationRefFromType(\n  type: Type<ts.Type>,\n  declaration: Node,\n): Pick<TranslationRefInfo, 'id' | 'messages'> | undefined {\n  // Check the $$type property on the uninstantiated (target) type\n  const resolvedType = type.getTargetType() ?? type;\n  const $$typeProperty = resolvedType\n    .getProperties()\n    .find(p => p.getName() === '$$type');\n  if (!$$typeProperty) {\n    return undefined;\n  }\n  const $$typeDecl = $$typeProperty.getValueDeclaration();\n  if (!$$typeDecl) {\n    return undefined;\n  }\n  if (!$$typeDecl.getText().includes(\"'@backstage/TranslationRef'\")) {\n    return undefined;\n  }\n\n  // The type is TranslationRef<TId, TMessages> - extract the type arguments\n  const typeArgs = type.getTypeArguments();\n  if (typeArgs.length < 2) {\n    return undefined;\n  }\n\n  const [idType, messagesType] = typeArgs;\n\n  if (!idType.isStringLiteral()) {\n    return undefined;\n  }\n  const id = idType.getLiteralValueOrThrow() as string;\n\n  // Extract messages from the TMessages type argument\n  const messages: Record<string, string> = {};\n  for (const messageProp of messagesType.getProperties()) {\n    const key = messageProp.getName();\n    // Resolve the property type in the context of the declaration\n    const propType = messageProp.getTypeAtLocation(declaration);\n    if (propType.isStringLiteral()) {\n      messages[key] = propType.getLiteralValueOrThrow() as string;\n    }\n  }\n\n  if (Object.keys(messages).length === 0) {\n    return undefined;\n  }\n\n  return { id, messages };\n}\n\n/**\n * Creates a ts-morph Project using the target repo's tsconfig.json.\n */\nexport function createTranslationProject(tsconfigPath: string): Project {\n  return new Project({\n    tsConfigFilePath: tsconfigPath,\n    skipAddingFilesFromTsConfig: true,\n  });\n}\n"],"names":["Project"],"mappings":";;;;AAoCO,SAAS,oCAAA,CACd,UAAA,EACA,WAAA,EACA,UAAA,EACsB;AACtB,EAAA,MAAM,UAAgC,EAAC;AAEvC,EAAA,KAAA,MAAW,YAAA,IAAgB,UAAA,CAAW,gBAAA,EAAiB,EAAG;AACxD,IAAA,MAAM,YAAA,GAAe,aAAa,eAAA,EAAgB;AAClD,IAAA,IAAI,YAAA,CAAa,WAAW,CAAA,EAAG;AAC7B,MAAA;AAAA,IACF;AAEA,IAAA,MAAM,WAAA,GAAc,aAAa,CAAC,CAAA;AAClC,IAAA,MAAM,UAAA,GAAa,YAAY,OAAA,EAAQ;AAEvC,IAAA,MAAM,OAAA,GAAU,6BAAA,CAA8B,UAAA,EAAY,WAAW,CAAA;AACrE,IAAA,IAAI,CAAC,OAAA,EAAS;AACZ,MAAA;AAAA,IACF;AAEA,IAAA,OAAA,CAAQ,IAAA,CAAK;AAAA,MACX,GAAG,OAAA;AAAA,MACH,WAAA;AAAA,MACA,UAAA;AAAA,MACA,UAAA,EAAY,aAAa,OAAA;AAAQ,KAClC,CAAA;AAAA,EACH;AAEA,EAAA,OAAO,OAAA;AACT;AAOA,SAAS,6BAAA,CACP,MACA,WAAA,EACyD;AAEzD,EAAA,MAAM,YAAA,GAAe,IAAA,CAAK,aAAA,EAAc,IAAK,IAAA;AAC7C,EAAA,MAAM,cAAA,GAAiB,aACpB,aAAA,EAAc,CACd,KAAK,CAAA,CAAA,KAAK,CAAA,CAAE,OAAA,EAAQ,KAAM,QAAQ,CAAA;AACrC,EAAA,IAAI,CAAC,cAAA,EAAgB;AACnB,IAAA,OAAO,MAAA;AAAA,EACT;AACA,EAAA,MAAM,UAAA,GAAa,eAAe,mBAAA,EAAoB;AACtD,EAAA,IAAI,CAAC,UAAA,EAAY;AACf,IAAA,OAAO,MAAA;AAAA,EACT;AACA,EAAA,IAAI,CAAC,UAAA,CAAW,OAAA,EAAQ,CAAE,QAAA,CAAS,6BAA6B,CAAA,EAAG;AACjE,IAAA,OAAO,MAAA;AAAA,EACT;AAGA,EAAA,MAAM,QAAA,GAAW,KAAK,gBAAA,EAAiB;AACvC,EAAA,IAAI,QAAA,CAAS,SAAS,CAAA,EAAG;AACvB,IAAA,OAAO,MAAA;AAAA,EACT;AAEA,EAAA,MAAM,CAAC,MAAA,EAAQ,YAAY,CAAA,GAAI,QAAA;AAE/B,EAAA,IAAI,CAAC,MAAA,CAAO,eAAA,EAAgB,EAAG;AAC7B,IAAA,OAAO,MAAA;AAAA,EACT;AACA,EAAA,MAAM,EAAA,GAAK,OAAO,sBAAA,EAAuB;AAGzC,EAAA,MAAM,WAAmC,EAAC;AAC1C,EAAA,KAAA,MAAW,WAAA,IAAe,YAAA,CAAa,aAAA,EAAc,EAAG;AACtD,IAAA,MAAM,GAAA,GAAM,YAAY,OAAA,EAAQ;AAEhC,IAAA,MAAM,QAAA,GAAW,WAAA,CAAY,iBAAA,CAAkB,WAAW,CAAA;AAC1D,IAAA,IAAI,QAAA,CAAS,iBAAgB,EAAG;AAC9B,MAAA,QAAA,CAAS,GAAG,CAAA,GAAI,QAAA,CAAS,sBAAA,EAAuB;AAAA,IAClD;AAAA,EACF;AAEA,EAAA,IAAI,MAAA,CAAO,IAAA,CAAK,QAAQ,CAAA,CAAE,WAAW,CAAA,EAAG;AACtC,IAAA,OAAO,MAAA;AAAA,EACT;AAEA,EAAA,OAAO,EAAE,IAAI,QAAA,EAAS;AACxB;AAKO,SAAS,yBAAyB,YAAA,EAA+B;AACtE,EAAA,OAAO,IAAIA,eAAA,CAAQ;AAAA,IACjB,gBAAA,EAAkB,YAAA;AAAA,IAClB,2BAAA,EAA6B;AAAA,GAC9B,CAAA;AACH;;;;;"}

package/dist/lib/messageFilePath.cjs.js

@@ -0,0 +1,43 @@
+'use strict';
+
+const DEFAULT_LANGUAGE = "en";
+const DEFAULT_MESSAGE_PATTERN = "messages/{id}.{lang}.json";
+function formatMessagePath(pattern, id, lang) {
+  return pattern.replace(/\{id\}/g, id).replace(/\{lang\}/g, lang);
+}
+function createMessagePathParser(pattern) {
+  validatePattern(pattern);
+  const escaped = pattern.replace(/[.*+?^${}()|[\]\\]/g, "\\$&").replace(/\\{id\\}/g, "(?<id>[^/]+)").replace(/\\{lang\\}/g, "(?<lang>[a-z]{2})");
+  const regex = new RegExp(`^${escaped}$`);
+  return (relPath) => {
+    const match = relPath.match(regex);
+    if (!match?.groups) {
+      return void 0;
+    }
+    return { id: match.groups.id, lang: match.groups.lang };
+  };
+}
+function validatePattern(pattern) {
+  if (!pattern.includes("{id}")) {
+    throw new Error(
+      `Invalid message file pattern: must contain {id} placeholder. Got: ${pattern}`
+    );
+  }
+  if (!pattern.includes("{lang}")) {
+    throw new Error(
+      `Invalid message file pattern: must contain {lang} placeholder. Got: ${pattern}`
+    );
+  }
+  if (!pattern.endsWith(".json")) {
+    throw new Error(
+      `Invalid message file pattern: must end with .json. Got: ${pattern}`
+    );
+  }
+}
+
+exports.DEFAULT_LANGUAGE = DEFAULT_LANGUAGE;
+exports.DEFAULT_MESSAGE_PATTERN = DEFAULT_MESSAGE_PATTERN;
+exports.createMessagePathParser = createMessagePathParser;
+exports.formatMessagePath = formatMessagePath;
+exports.validatePattern = validatePattern;
+//# sourceMappingURL=messageFilePath.cjs.js.map

package/dist/lib/messageFilePath.cjs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"messageFilePath.cjs.js","sources":["../../src/lib/messageFilePath.ts"],"sourcesContent":["/*\n * Copyright 2026 The Backstage Authors\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *     http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\n// The default language for exported translation messages.\nexport const DEFAULT_LANGUAGE = 'en';\n\n// Default file path pattern for translation message files relative to the\n// translations directory. Supported placeholders: {id} and {lang}.\nexport const DEFAULT_MESSAGE_PATTERN = 'messages/{id}.{lang}.json';\n\n/** Formats a message file pattern into a concrete relative path. */\nexport function formatMessagePath(\n  pattern: string,\n  id: string,\n  lang: string,\n): string {\n  return pattern.replace(/\\{id\\}/g, id).replace(/\\{lang\\}/g, lang);\n}\n\n/** Creates a parser that extracts id and lang from a relative file path. */\nexport function createMessagePathParser(\n  pattern: string,\n): (relativePath: string) => { id: string; lang: string } | undefined {\n  validatePattern(pattern);\n\n  // Build a regex from the pattern by escaping special chars and replacing\n  // {id} and {lang} with named capture groups.\n  const escaped = pattern\n    .replace(/[.*+?^${}()|[\\]\\\\]/g, '\\\\$&')\n    .replace(/\\\\{id\\\\}/g, '(?<id>[^/]+)')\n    .replace(/\\\\{lang\\\\}/g, '(?<lang>[a-z]{2})');\n\n  const regex = new RegExp(`^${escaped}$`);\n\n  return (relPath: string) => {\n    const match = relPath.match(regex);\n    if (!match?.groups) {\n      return undefined;\n    }\n    return { id: match.groups.id, lang: match.groups.lang };\n  };\n}\n\n/** Converts a message pattern into a glob string for discovering files. */\nexport function messagePatternToGlob(pattern: string): string {\n  return pattern.replace(/\\{id\\}/g, '*').replace(/\\{lang\\}/g, '*');\n}\n\n/** Returns whether the pattern produces paths with subdirectories. */\nexport function patternHasSubdirectories(pattern: string): boolean {\n  return pattern.includes('/');\n}\n\nexport function validatePattern(pattern: string) {\n  if (!pattern.includes('{id}')) {\n    throw new Error(\n      `Invalid message file pattern: must contain {id} placeholder. Got: ${pattern}`,\n    );\n  }\n  if (!pattern.includes('{lang}')) {\n    throw new Error(\n      `Invalid message file pattern: must contain {lang} placeholder. Got: ${pattern}`,\n    );\n  }\n  if (!pattern.endsWith('.json')) {\n    throw new Error(\n      `Invalid message file pattern: must end with .json. Got: ${pattern}`,\n    );\n  }\n}\n"],"names":[],"mappings":";;AAiBO,MAAM,gBAAA,GAAmB;AAIzB,MAAM,uBAAA,GAA0B;AAGhC,SAAS,iBAAA,CACd,OAAA,EACA,EAAA,EACA,IAAA,EACQ;AACR,EAAA,OAAO,QAAQ,OAAA,CAAQ,SAAA,EAAW,EAAE,CAAA,CAAE,OAAA,CAAQ,aAAa,IAAI,CAAA;AACjE;AAGO,SAAS,wBACd,OAAA,EACoE;AACpE,EAAA,eAAA,CAAgB,OAAO,CAAA;AAIvB,EAAA,MAAM,OAAA,GAAU,OAAA,CACb,OAAA,CAAQ,qBAAA,EAAuB,MAAM,CAAA,CACrC,OAAA,CAAQ,WAAA,EAAa,cAAc,CAAA,CACnC,OAAA,CAAQ,aAAA,EAAe,mBAAmB,CAAA;AAE7C,EAAA,MAAM,KAAA,GAAQ,IAAI,MAAA,CAAO,CAAA,CAAA,EAAI,OAAO,CAAA,CAAA,CAAG,CAAA;AAEvC,EAAA,OAAO,CAAC,OAAA,KAAoB;AAC1B,IAAA,MAAM,KAAA,GAAQ,OAAA,CAAQ,KAAA,CAAM,KAAK,CAAA;AACjC,IAAA,IAAI,CAAC,OAAO,MAAA,EAAQ;AAClB,MAAA,OAAO,MAAA;AAAA,IACT;AACA,IAAA,OAAO,EAAE,IAAI,KAAA,CAAM,MAAA,CAAO,IAAI,IAAA,EAAM,KAAA,CAAM,OAAO,IAAA,EAAK;AAAA,EACxD,CAAA;AACF;AAYO,SAAS,gBAAgB,OAAA,EAAiB;AAC/C,EAAA,IAAI,CAAC,OAAA,CAAQ,QAAA,CAAS,MAAM,CAAA,EAAG;AAC7B,IAAA,MAAM,IAAI,KAAA;AAAA,MACR,qEAAqE,OAAO,CAAA;AAAA,KAC9E;AAAA,EACF;AACA,EAAA,IAAI,CAAC,OAAA,CAAQ,QAAA,CAAS,QAAQ,CAAA,EAAG;AAC/B,IAAA,MAAM,IAAI,KAAA;AAAA,MACR,uEAAuE,OAAO,CAAA;AAAA,KAChF;AAAA,EACF;AACA,EAAA,IAAI,CAAC,OAAA,CAAQ,QAAA,CAAS,OAAO,CAAA,EAAG;AAC9B,IAAA,MAAM,IAAI,KAAA;AAAA,MACR,2DAA2D,OAAO,CAAA;AAAA,KACpE;AAAA,EACF;AACF;;;;;;;;"}

package/dist/package.json.cjs.js

@@ -0,0 +1,83 @@
+'use strict';
+
+Object.defineProperty(exports, '__esModule', { value: true });
+
+var name = "@backstage/cli-module-translations";
+var version = "0.0.0-nightly-20260317031259";
+var description = "CLI module for Backstage CLI";
+var backstage = {
+	role: "cli-module"
+};
+var publishConfig = {
+	access: "public",
+	main: "dist/index.cjs.js",
+	types: "dist/index.d.ts"
+};
+var homepage = "https://backstage.io";
+var repository = {
+	type: "git",
+	url: "https://github.com/backstage/backstage",
+	directory: "packages/cli-module-translations"
+};
+var license = "Apache-2.0";
+var main = "src/index.ts";
+var types = "src/index.ts";
+var files = [
+	"dist",
+	"bin"
+];
+var scripts = {
+	build: "backstage-cli package build",
+	clean: "backstage-cli package clean",
+	lint: "backstage-cli package lint",
+	prepack: "backstage-cli package prepack",
+	postpack: "backstage-cli package postpack",
+	test: "backstage-cli package test"
+};
+var dependencies = {
+	"@backstage/cli-common": "workspace:*",
+	"@backstage/cli-node": "workspace:*",
+	cleye: "^2.3.0",
+	"fs-extra": "^11.2.0",
+	"ts-morph": "^24.0.0"
+};
+var devDependencies = {
+	"@backstage/cli": "workspace:*",
+	"@types/fs-extra": "^11.0.0"
+};
+var bin = "bin/backstage-cli-module-translations";
+var packageJson = {
+	name: name,
+	version: version,
+	description: description,
+	backstage: backstage,
+	publishConfig: publishConfig,
+	homepage: homepage,
+	repository: repository,
+	license: license,
+	main: main,
+	types: types,
+	files: files,
+	scripts: scripts,
+	dependencies: dependencies,
+	devDependencies: devDependencies,
+	bin: bin
+};
+
+exports.backstage = backstage;
+exports.bin = bin;
+exports.default = packageJson;
+exports.dependencies = dependencies;
+exports.description = description;
+exports.devDependencies = devDependencies;
+exports.files = files;
+exports.homepage = homepage;
+exports.license = license;
+exports.main = main;
+exports.name = name;
+exports.publishConfig = publishConfig;
+exports.repository = repository;
+exports.scripts = scripts;
+exports.types = types;
+exports.version = version;
+//# sourceMappingURL=package.json.cjs.js.map

package/dist/package.json.cjs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"package.json.cjs.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;"}

package/package.json

@@ -0,0 +1,53 @@
+{
+  "name": "@backstage/cli-module-translations",
+  "version": "0.0.0-nightly-20260317031259",
+  "description": "CLI module for Backstage CLI",
+  "backstage": {
+    "role": "cli-module"
+  },
+  "publishConfig": {
+    "access": "public",
+    "main": "dist/index.cjs.js",
+    "types": "dist/index.d.ts"
+  },
+  "homepage": "https://backstage.io",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/backstage/backstage",
+    "directory": "packages/cli-module-translations"
+  },
+  "license": "Apache-2.0",
+  "main": "dist/index.cjs.js",
+  "types": "dist/index.d.ts",
+  "files": [
+    "dist",
+    "bin"
+  ],
+  "scripts": {
+    "build": "backstage-cli package build",
+    "clean": "backstage-cli package clean",
+    "lint": "backstage-cli package lint",
+    "prepack": "backstage-cli package prepack",
+    "postpack": "backstage-cli package postpack",
+    "test": "backstage-cli package test"
+  },
+  "dependencies": {
+    "@backstage/cli-common": "0.0.0-nightly-20260317031259",
+    "@backstage/cli-node": "0.0.0-nightly-20260317031259",
+    "cleye": "^2.3.0",
+    "fs-extra": "^11.2.0",
+    "ts-morph": "^24.0.0"
+  },
+  "devDependencies": {
+    "@backstage/cli": "0.0.0-nightly-20260317031259",
+    "@types/fs-extra": "^11.0.0"
+  },
+  "bin": "bin/backstage-cli-module-translations",
+  "typesVersions": {
+    "*": {
+      "package.json": [
+        "package.json"
+      ]
+    }
+  }
+}