@backstage/cli 0.36.0-next.1 → 0.36.0

package/dist/modules/translations/commands/export.cjs.js

@@ -1,127 +0,0 @@
-'use strict';
-
-Object.defineProperty(exports, '__esModule', { value: true });
-
-var cleye = require('cleye');
-var cliCommon = require('@backstage/cli-common');
-var fs = require('fs-extra');
-var 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,
-      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 = path.resolve(cliCommon.targetPaths.dir, options.output);
-  const manifestPath = 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 = path.resolve(outputDir, relPath);
-    await fs__default.default.ensureDir(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/modules/translations/commands/import.cjs.js

@@ -1,164 +0,0 @@
-'use strict';
-
-Object.defineProperty(exports, '__esModule', { value: true });
-
-var cleye = require('cleye');
-var cliCommon = require('@backstage/cli-common');
-var fs = require('fs-extra');
-var 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,
-      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 = path.resolve(cliCommon.targetPaths.dir, options.input);
-  const manifestPath = path.resolve(inputDir, "manifest.json");
-  const outputPath = 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 = path.relative(
-        path.resolve(outputPath, ".."),
-        path.resolve(inputDir, relPath)
-      ).split(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(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(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/modules/translations/index.cjs.js

@@ -1,24 +0,0 @@
-'use strict';
-
-Object.defineProperty(exports, '__esModule', { value: true });
-
-var factory = require('../../wiring/factory.cjs.js');
-
-var index = factory.createCliPlugin({
-  pluginId: "translations",
-  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/modules/translations/lib/discoverPackages.cjs.js

@@ -1,121 +0,0 @@
-'use strict';
-
-var cliNode = require('@backstage/cli-node');
-var 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 = 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 (path.resolve(packageDir) === 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 = 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, path.resolve(packageDir, filePath));
-      }
-    }
-  } else {
-    const main = isWorkspace ? packageJson.main ?? packageJson.types : packageJson.types ?? packageJson.main;
-    if (main) {
-      entryPoints.set(".", 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/modules/translations/lib/extractTranslations.cjs.js

@@ -1,71 +0,0 @@
-'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/modules/translations/lib/messageFilePath.cjs.js

@@ -1,43 +0,0 @@
-'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/packages/backend-defaults/package.json.cjs.js

@@ -1,6 +0,0 @@
-'use strict';
-
-var version = "0.16.0-next.1";
-
-exports.version = version;
-//# sourceMappingURL=package.json.cjs.js.map

package/dist/packages/backend-plugin-api/package.json.cjs.js

@@ -1,6 +0,0 @@
-'use strict';
-
-var version = "1.7.1-next.0";
-
-exports.version = version;
-//# sourceMappingURL=package.json.cjs.js.map

package/dist/packages/backend-test-utils/package.json.cjs.js

@@ -1,6 +0,0 @@
-'use strict';
-
-var version = "1.11.1-next.1";
-
-exports.version = version;
-//# sourceMappingURL=package.json.cjs.js.map

package/dist/packages/catalog-client/package.json.cjs.js

@@ -1,6 +0,0 @@
-'use strict';
-
-var version = "1.14.0-next.1";
-
-exports.version = version;
-//# sourceMappingURL=package.json.cjs.js.map