@backstage/cli 0.32.0-next.0 → 0.32.0-next.2

package/CHANGELOG.md

@@ -1,5 +1,76 @@
 # @backstage/cli
 
+## 0.32.0-next.2
+
+### Minor Changes
+
+- a47fd39: Removes default React imports from template files, aligning with the requirements for the upcoming React 19 migration. Introduces a new ESLint rule to disallow `import React from 'react'` and `import * as React from 'react'`.
+
+  <https://legacy.reactjs.org/blog/2020/09/22/introducing-the-new-jsx-transform.html>
+
+### Patch Changes
+
+- 6969f79: Avoid trailing `/*` when automatically adding imports for package with multiple entry points.
+- 98b7131: Update the `to do` plugin template to stop using the deprecated catalog alpha service reference.
+  If you start seeing the `should create TODO item with catalog information` test failing, you have two options to fix this:
+  Update the test to mock the legacy alpha catalog service, or migrate the `TODO` plugin backend to use the new catalog service reference.
+  We recommend the second option, see [this](https://github.com/backstage/backstage/pull/29450/files/267115d0436009443ca68ac84e7dcc646c9c938d#diff-47e01aeb12dd55fab9e697f810be21a8d08d39c37df1b078f6d0894f9bad5a1b) pull request for an example of how to do the migration.
+- d5c4fed: make certificate strings optional for Dev environments
+- d2091c6: Added a new `repo start` command to replace the existing pattern of using `yarn dev` scripts. The `repo start` command runs the app and/or backend package in the repo by default, but will also fall back to running other individual frontend or backend packages or even plugin dev entry points if the can be uniquely selected.
+
+  The goal of this change is to reduce the number of different necessary scripts and align on `yarn start` being the only command needed for local development, similar to how `repo test` handles testing in the repo. It also opens up for more powerful options, like the `--plugin <pluginId>` flag that runs the dev entry point of the selected plugin.
+
+  The new script is installed as follows, replacing the existing `yarn start` script:
+
+  ```json
+  {
+    "scripts": {
+      "start": "backstage-cli repo start"
+    }
+  }
+  ```
+
+  In order to help users migrate in existing projects, it is recommended to add the following scripts to the root `package.json`:
+
+  ```json
+  {
+    "scripts": {
+      "dev": "echo \"Use 'yarn start' instead\"",
+      "start-backend": "echo \"Use 'yarn start backend' instead\""
+    }
+  }
+  ```
+
+  For more information, run `yarn start --help` once the new command is installed.
+
+- Updated dependencies
+  - @backstage/catalog-model@1.7.3
+  - @backstage/cli-common@0.1.15
+  - @backstage/cli-node@0.2.13
+  - @backstage/config@1.3.2
+  - @backstage/config-loader@1.10.0
+  - @backstage/errors@1.2.7
+  - @backstage/eslint-plugin@0.1.10
+  - @backstage/integration@1.16.3-next.0
+  - @backstage/release-manifests@0.0.12
+  - @backstage/types@1.2.1
+
+## 0.32.0-next.1
+
+### Patch Changes
+
+- Updated dependencies
+  - @backstage/integration@1.16.3-next.0
+  - @backstage/catalog-model@1.7.3
+  - @backstage/cli-common@0.1.15
+  - @backstage/cli-node@0.2.13
+  - @backstage/config@1.3.2
+  - @backstage/config-loader@1.10.0
+  - @backstage/errors@1.2.7
+  - @backstage/eslint-plugin@0.1.10
+  - @backstage/release-manifests@0.0.12
+  - @backstage/types@1.2.1
+
 ## 0.32.0-next.0
 
 ### Minor Changes

package/config/eslint-factory.js

@@ -243,8 +243,27 @@ function createConfigForRole(dir, role, extraConfig = {}) {
           '@mui/*/*/*',
           ...(extraConfig.restrictedImportPatterns ?? []),
         ],
+        rules: {
+          'react/react-in-jsx-scope': 'off',
+          'no-restricted-syntax': [
+            'warn',
+            {
+              message:
+                'React default imports are deprecated. Follow the x migration guide for details.',
+              selector:
+                "ImportDeclaration[source.value='react'][specifiers.0.type='ImportDefaultSpecifier']",
+            },
+            {
+              message:
+                'React default imports are deprecated. Follow the x migration guide for details. If you need a global type that collides with a React named export (such as `MouseEvent`), try using `globalThis.MouseHandler`.',
+              selector:
+                "ImportDeclaration[source.value='react'] :matches(ImportDefaultSpecifier, ImportNamespaceSpecifier)",
+            },
+          ],
+          ...extraConfig.rules,
+        },
         tsRules: {
-          'react/prop-types': 0,
+          'react/prop-types': 'off',
           ...extraConfig.tsRules,
         },
       });

package/dist/commands/index.cjs.js

@@ -3,32 +3,28 @@
 var lazy = require('../lib/lazy.cjs.js');
 var index = require('../modules/config/index.cjs.js');
 var index$2 = require('../modules/build/index.cjs.js');
+var index$4 = require('../modules/start/index.cjs.js');
 var index$3 = require('../modules/info/index.cjs.js');
 var index$1 = require('../modules/migrate/index.cjs.js');
-var index$4 = require('../modules/test/index.cjs.js');
-var index$5 = require('../modules/lint/index.cjs.js');
-var index$6 = require('../modules/maintenance/index.cjs.js');
+var index$5 = require('../modules/test/index.cjs.js');
+var index$6 = require('../modules/lint/index.cjs.js');
+var index$7 = require('../modules/maintenance/index.cjs.js');
 
 function registerRepoCommand(program) {
   const command = program.command("repo [command]").description("Command that run across an entire Backstage project");
-  index$2.registerRepoCommands(command);
   index$4.registerRepoCommands(command);
+  index$2.registerRepoCommands(command);
   index$5.registerRepoCommands(command);
   index$6.registerRepoCommands(command);
+  index$7.registerRepoCommands(command);
 }
 function registerScriptCommand(program) {
   const command = program.command("package [command]").description("Lifecycle scripts for individual packages");
-  command.command("start").description("Start a package for local development").option(...index.configOption).option("--role <name>", "Run the command with an explicit package role").option("--check", "Enable type checking and linting if available").option("--inspect [host]", "Enable debugger in Node.js environments").option(
-    "--inspect-brk [host]",
-    "Enable debugger in Node.js environments, breaking before code starts"
-  ).option(
-    "--require <path...>",
-    "Add a --require argument to the node process"
-  ).option("--link <path>", "Link an external workspace for module resolution").action(lazy.lazy(() => import('./start/index.cjs.js'), "command"));
-  index$2.registerPackageCommands(command);
   index$4.registerPackageCommands(command);
-  index$6.registerPackageCommands(command);
+  index$2.registerPackageCommands(command);
   index$5.registerPackageCommands(command);
+  index$7.registerPackageCommands(command);
+  index$6.registerPackageCommands(command);
 }
 function registerCommands(program) {
   program.command("new").storeOptionsAsProperties(false).description(

package/dist/lib/errors.cjs.js

@@ -29,7 +29,7 @@ ${chalk__default.default.red(error.message)}
     process.exit(error.code);
   } else {
     process.stderr.write(`
-${chalk__default.default.red(`${error}`)}
+${chalk__default.default.red(`${error.stack}`)}
 
 `);
     process.exit(1);

package/dist/lib/runner/runBackend.cjs.js

@@ -78,6 +78,7 @@ async function runBackend(options) {
       [...loaderArgs, ...optionArgs, options.entry, ...userArgs],
       {
         stdio: ["ignore", "inherit", "inherit", "ipc"],
+        cwd: options.targetDir,
         env: {
           ...process.env,
           BACKSTAGE_CLI_LINKED_WORKSPACE: options.linkedWorkspace,

package/dist/modules/build/lib/bundler/server.cjs.js

@@ -2,6 +2,7 @@
 
 var chalk = require('chalk');
 var fs = require('fs-extra');
+var path = require('path');
 var openBrowser = require('react-dev-utils/openBrowser');
 var webpack = require('webpack');
 var WebpackDevServer = require('webpack-dev-server');
@@ -34,7 +35,9 @@ DEPRECATION WARNING: React Router Beta is deprecated and support for it will be
     }
   }
   checkReactVersion();
-  const { name } = await fs__default.default.readJson(paths$1.paths.resolveTarget("package.json"));
+  const { name } = await fs__default.default.readJson(
+    path.resolve(options.targetDir ?? paths$1.paths.targetDir, "package.json")
+  );
   let webpackServer = void 0;
   let latestFrontendAppConfigs = [];
   const triggerReload = () => {
@@ -50,6 +53,7 @@ DEPRECATION WARNING: React Router Beta is deprecated and support for it will be
   };
   const cliConfig = await config.loadCliConfig({
     args: options.configPaths,
+    targetDir: options.targetDir,
     fromPackage: name,
     withFilteredKeys: true,
     watch(appConfigs) {
@@ -145,8 +149,10 @@ DEPRECATION WARNING: React Router Beta is deprecated and support for it will be
       server: url.protocol === "https:" ? {
         type: "https",
         options: {
-          cert: fullConfig.getString("app.https.certificate.cert"),
-          key: fullConfig.getString("app.https.certificate.key")
+          cert: fullConfig.getOptionalString(
+            "app.https.certificate.cert"
+          ),
+          key: fullConfig.getOptionalString("app.https.certificate.key")
         }
       } : {},
       host,

package/dist/modules/build/lib/packager/productionPack.cjs.js

@@ -106,8 +106,11 @@ async function rewriteEntryPoints(pkg, packageDir, featureDetectionProject) {
       if (!pkg.typesVersions) {
         pkg.typesVersions = { "*": {} };
       }
-      const mount = entryPoint.name === "index" ? "*" : entryPoint.name;
-      pkg.typesVersions["*"][mount] = [`dist/${entryPoint.name}.d.ts`];
+      if (entryPoint.name !== "index") {
+        pkg.typesVersions["*"][entryPoint.name] = [
+          `dist/${entryPoint.name}.d.ts`
+        ];
+      }
     }
     exp.default = exp.require ?? exp.import;
     if (exp.types && featureDetectionProject) {
@@ -140,10 +143,7 @@ async function rewriteEntryPoints(pkg, packageDir, featureDetectionProject) {
     }
   }
   if (pkg.typesVersions?.["*"]) {
-    const keys = Object.keys(pkg.typesVersions["*"]);
-    if (keys.length === 1 && keys[0] === "*") {
-      delete pkg.typesVersions;
-    }
+    pkg.typesVersions["*"]["package.json"] = ["package.json"];
   }
   if (pkg.exports) {
     pkg.exports = outputExports;

package/dist/modules/config/lib/config.cjs.js

@@ -5,9 +5,11 @@ var config = require('@backstage/config');
 var paths = require('../../../lib/paths.cjs.js');
 var getPackages = require('@manypkg/get-packages');
 var cliNode = require('@backstage/cli-node');
+var path = require('path');
 
 async function loadCliConfig(options) {
-  const { packages } = await getPackages.getPackages(paths.paths.targetDir);
+  const targetDir = options.targetDir ?? paths.paths.targetDir;
+  const { packages } = await getPackages.getPackages(targetDir);
   let localPackageNames;
   if (options.fromPackage) {
     if (packages.length) {
@@ -37,7 +39,7 @@ async function loadCliConfig(options) {
     substitutionFunc: options.mockEnv ? async (name) => process.env[name] || "x" : void 0,
     watch: Boolean(options.watch),
     rootDir: paths.paths.targetRoot,
-    argv: options.args.flatMap((t) => ["--config", paths.paths.resolveTarget(t)])
+    argv: options.args.flatMap((t) => ["--config", path.resolve(targetDir, t)])
   });
   const appConfigs = await new Promise((resolve, reject) => {
     async function loadConfigReaderLoop() {

package/dist/modules/start/commands/package/start/command.cjs.js

@@ -0,0 +1,22 @@
+'use strict';
+
+var startPackage = require('./startPackage.cjs.js');
+var resolveLinkedWorkspace = require('./resolveLinkedWorkspace.cjs.js');
+var role = require('../../../../../lib/role.cjs.js');
+var paths = require('../../../../../lib/paths.cjs.js');
+
+async function command(opts) {
+  await startPackage.startPackage({
+    role: await role.findRoleFromCommand(opts),
+    targetDir: paths.paths.targetDir,
+    configPaths: opts.config,
+    checksEnabled: Boolean(opts.check),
+    linkedWorkspace: await resolveLinkedWorkspace.resolveLinkedWorkspace(opts.link),
+    inspectEnabled: opts.inspect,
+    inspectBrkEnabled: opts.inspectBrk,
+    require: opts.require
+  });
+}
+
+exports.command = command;
+//# sourceMappingURL=command.cjs.js.map

package/dist/modules/start/commands/package/start/resolveLinkedWorkspace.cjs.js

@@ -0,0 +1,34 @@
+'use strict';
+
+var errors = require('@backstage/errors');
+var fs = require('fs-extra');
+var posix = require('path/posix');
+
+function _interopDefaultCompat (e) { return e && typeof e === 'object' && 'default' in e ? e : { default: e }; }
+
+var fs__default = /*#__PURE__*/_interopDefaultCompat(fs);
+
+async function resolveLinkedWorkspace(linkPath) {
+  if (!linkPath) {
+    return void 0;
+  }
+  const dir = posix.resolve(linkPath);
+  if (!fs__default.default.pathExistsSync(dir)) {
+    throw new Error(`Invalid workspace link, directory does not exist: ${dir}`);
+  }
+  const pkgJson = await fs__default.default.readJson(posix.resolve(dir, "package.json")).catch((error) => {
+    throw new errors.ForwardedError(
+      "Failed to read package.json in linked workspace",
+      error
+    );
+  });
+  if (!pkgJson.workspaces) {
+    throw new Error(
+      `Invalid workspace link, directory is not a workspace: ${dir}`
+    );
+  }
+  return dir;
+}
+
+exports.resolveLinkedWorkspace = resolveLinkedWorkspace;
+//# sourceMappingURL=resolveLinkedWorkspace.cjs.js.map

package/dist/{commands → modules/start/commands/package}/start/startBackend.cjs.js

@@ -1,8 +1,9 @@
 'use strict';
 
 var fs = require('fs-extra');
-var paths = require('../../lib/paths.cjs.js');
-var runBackend = require('../../lib/runner/runBackend.cjs.js');
+var path = require('path');
+var paths = require('../../../../../lib/paths.cjs.js');
+var runBackend = require('../../../../../lib/runner/runBackend.cjs.js');
 
 function _interopDefaultCompat (e) { return e && typeof e === 'object' && 'default' in e ? e : { default: e }; }
 
@@ -10,6 +11,7 @@ var fs__default = /*#__PURE__*/_interopDefaultCompat(fs);
 
 async function startBackend(options) {
   const waitForExit = await runBackend.runBackend({
+    targetDir: options.targetDir,
     entry: "src/index",
     inspectEnabled: options.inspectEnabled,
     inspectBrkEnabled: options.inspectBrkEnabled,
@@ -20,7 +22,7 @@ async function startBackend(options) {
 }
 async function startBackendPlugin(options) {
   const hasDevIndexEntry = await fs__default.default.pathExists(
-    paths.paths.resolveTarget("dev", "index.ts")
+    path.resolve(options.targetDir ?? paths.paths.targetDir, "dev/index.ts")
   );
   if (!hasDevIndexEntry) {
     console.warn(
@@ -29,6 +31,7 @@ async function startBackendPlugin(options) {
     return;
   }
   const waitForExit = await runBackend.runBackend({
+    targetDir: options.targetDir,
     entry: "dev/index",
     inspectEnabled: options.inspectEnabled,
     inspectBrkEnabled: options.inspectBrkEnabled,

package/dist/{commands → modules/start/commands/package}/start/startFrontend.cjs.js

@@ -13,23 +13,24 @@ require('html-webpack-plugin');
 require('@module-federation/enhanced/webpack');
 require('react-dev-utils/ModuleScopePlugin');
 require('@pmmmwh/react-refresh-webpack-plugin');
-var paths = require('../../lib/paths.cjs.js');
-require('../../modules/build/lib/bundler/optimization.cjs.js');
+var paths = require('../../../../../lib/paths.cjs.js');
+require('../../../../build/lib/bundler/optimization.cjs.js');
 require('lodash/pickBy');
-require('../../lib/run.cjs.js');
+require('../../../../../lib/run.cjs.js');
 require('mini-css-extract-plugin');
-require('../../lib/version.cjs.js');
+require('../../../../../lib/version.cjs.js');
 require('@manypkg/get-packages');
-require('../../modules/build/lib/bundler/packageDetection.cjs.js');
-var moduleFederation = require('../../modules/build/lib/bundler/moduleFederation.cjs.js');
-var server = require('../../modules/build/lib/bundler/server.cjs.js');
+require('../../../../build/lib/bundler/packageDetection.cjs.js');
+var moduleFederation = require('../../../../build/lib/bundler/moduleFederation.cjs.js');
+var server = require('../../../../build/lib/bundler/server.cjs.js');
 
 async function startFrontend(options) {
   const packageJson = await fs.readJson(
-    paths.paths.resolveTarget("package.json")
+    path.resolve(options.targetDir ?? paths.paths.targetDir, "package.json")
   );
   const waitForExit = await server.serveBundle({
     entry: options.entry,
+    targetDir: options.targetDir,
     checksEnabled: options.checksEnabled,
     configPaths: options.configPaths,
     verifyVersions: options.verifyVersions,

package/dist/modules/start/commands/package/start/startPackage.cjs.js

@@ -0,0 +1,42 @@
+'use strict';
+
+var startBackend = require('./startBackend.cjs.js');
+var startFrontend = require('./startFrontend.cjs.js');
+
+async function startPackage(options) {
+  switch (options.role) {
+    case "backend":
+      return startBackend.startBackend(options);
+    case "backend-plugin":
+    case "backend-plugin-module":
+    case "node-library":
+      return startBackend.startBackendPlugin(options);
+    case "frontend":
+      return startFrontend.startFrontend({
+        ...options,
+        entry: "src/index",
+        verifyVersions: true
+      });
+    case "web-library":
+    case "frontend-plugin":
+    case "frontend-plugin-module":
+      return startFrontend.startFrontend({
+        entry: "dev/index",
+        ...options
+      });
+    case "frontend-dynamic-container":
+      return startFrontend.startFrontend({
+        entry: "src/index",
+        ...options,
+        skipOpenBrowser: true,
+        isModuleFederationRemote: true
+      });
+    default:
+      throw new Error(
+        `Start command is not supported for package role '${options.role}'`
+      );
+  }
+}
+
+exports.startPackage = startPackage;
+//# sourceMappingURL=startPackage.cjs.js.map

package/dist/modules/start/commands/repo/start.cjs.js

@@ -0,0 +1,150 @@
+'use strict';
+
+var cliNode = require('@backstage/cli-node');
+var path = require('path');
+var paths = require('../../../../lib/paths.cjs.js');
+var resolveLinkedWorkspace = require('../package/start/resolveLinkedWorkspace.cjs.js');
+var startPackage = require('../package/start/startPackage.cjs.js');
+var util = require('util');
+
+const ACCEPTED_PACKAGE_ROLES = [
+  "frontend",
+  "backend",
+  "frontend-plugin",
+  "backend-plugin"
+];
+async function command(namesOrPaths, options) {
+  const targetPackages = await findTargetPackages(namesOrPaths, options.plugin);
+  const packageOptions = await resolvePackageOptions(targetPackages, options);
+  if (packageOptions.length === 0) {
+    console.log("No packages found to start");
+    return;
+  }
+  console.log(
+    `Starting ${packageOptions.map(({ pkg }) => pkg.packageJson.name).join(", ")}`
+  );
+  await Promise.all(packageOptions.map((entry) => startPackage.startPackage(entry.options)));
+}
+async function findTargetPackages(namesOrPaths, pluginIds) {
+  const targetPackages = new Array();
+  const packages = await cliNode.PackageGraph.listTargetPackages();
+  for (const pluginId of pluginIds) {
+    const matchingPackages = packages.filter((pkg) => {
+      return pluginId === pkg.packageJson.backstage?.pluginId && ACCEPTED_PACKAGE_ROLES.includes(pkg.packageJson.backstage.role);
+    });
+    if (matchingPackages.length === 0) {
+      throw new Error(
+        `Unable to find any plugin packages with plugin ID '${pluginId}'. Make sure backstage.pluginId is set in your package.json files by running 'yarn fix --publish'.`
+      );
+    }
+    targetPackages.push(...matchingPackages);
+  }
+  if (targetPackages.length > 0) {
+    return targetPackages;
+  }
+  for (const nameOrPath of namesOrPaths) {
+    let matchingPackage = packages.find(
+      (pkg) => nameOrPath === pkg.packageJson.name
+    );
+    if (!matchingPackage) {
+      const absPath = paths.paths.resolveTargetRoot(nameOrPath);
+      matchingPackage = packages.find(
+        (pkg) => path.relative(pkg.dir, absPath) === ""
+      );
+    }
+    if (!matchingPackage) {
+      throw new Error(`Unable to find package by name '${nameOrPath}'`);
+    }
+    targetPackages.push(matchingPackage);
+  }
+  if (targetPackages.length > 0) {
+    return targetPackages;
+  }
+  for (const role of ["frontend", "backend"]) {
+    const matchingPackages = packages.filter(
+      (pkg) => pkg.packageJson.backstage?.role === role
+    );
+    if (matchingPackages.length > 1) {
+      const expectedPath = paths.paths.resolveTargetRoot(
+        role === "frontend" ? "packages/app" : "packages/backend"
+      );
+      const matchByPath = matchingPackages.find(
+        (pkg) => path.relative(expectedPath, pkg.dir) === ""
+      );
+      if (matchByPath) {
+        targetPackages.push(matchByPath);
+        continue;
+      }
+      throw new Error(
+        `Found multiple packages with role '${role}' but none of the use the default path '${expectedPath}',choose which packages you want to run by passing the package names explicitly as arguments, for example 'yarn backstage-cli repo start my-app my-backend'.`
+      );
+    }
+    targetPackages.push(...matchingPackages);
+  }
+  if (targetPackages.length > 0) {
+    return targetPackages;
+  }
+  for (const role of ["frontend-plugin", "backend-plugin"]) {
+    const matchingPackages = packages.filter(
+      (pkg) => pkg.packageJson.backstage?.role === role
+    );
+    if (matchingPackages.length > 1) {
+      throw new Error(
+        `Found multiple packages with role '${role}', please choose which packages you want to run by passing the package names explicitly as arguments, for example 'yarn backstage-cli repo start my-plugin my-plugin-backend'.`
+      );
+    }
+    targetPackages.push(...matchingPackages);
+  }
+  if (targetPackages.length > 0) {
+    return targetPackages;
+  }
+  throw new Error(
+    `Unable to find any packages with role 'frontend', 'backend', 'frontend-plugin', or 'backend-plugin'.`
+  );
+}
+async function resolvePackageOptions(targetPackages, options) {
+  const linkedWorkspace = await resolveLinkedWorkspace.resolveLinkedWorkspace(options.link);
+  return targetPackages.flatMap((pkg) => {
+    const startScript = pkg.packageJson.scripts?.start;
+    if (!startScript) {
+      console.log(
+        `No start script found for package ${pkg.packageJson.name}, skipping...`
+      );
+      return [];
+    }
+    const { values: parsedOpts } = util.parseArgs({
+      args: startScript.split(" "),
+      strict: false,
+      options: {
+        config: {
+          type: "string",
+          multiple: true
+        },
+        require: {
+          type: "string"
+        }
+      }
+    });
+    const parsedRequire = typeof parsedOpts.require === "string" ? parsedOpts.require : void 0;
+    const parsedConfig = parsedOpts.config?.filter((c) => typeof c === "string") ?? [];
+    return [
+      {
+        pkg,
+        options: {
+          role: pkg.packageJson.backstage?.role,
+          targetDir: pkg.dir,
+          configPaths: options.config.length > 0 ? options.config : parsedConfig,
+          checksEnabled: false,
+          linkedWorkspace,
+          inspectEnabled: options.inspect,
+          inspectBrkEnabled: options.inspectBrk,
+          require: options.require ?? parsedRequire
+        }
+      }
+    ];
+  });
+}
+
+exports.command = command;
+exports.findTargetPackages = findTargetPackages;
+//# sourceMappingURL=start.cjs.js.map

package/dist/modules/start/index.cjs.js

@@ -0,0 +1,38 @@
+'use strict';
+
+var lazy = require('../../lib/lazy.cjs.js');
+var index = require('../config/index.cjs.js');
+
+function registerRepoCommands(command) {
+  command.command("start").description("Starts packages in the repo for local development").argument(
+    "[packageNameOrPath...]",
+    "Run the specified package instead of the defaults."
+  ).option(
+    "--plugin <pluginId>",
+    "Start the dev entry-point for any matching plugin package in the repo",
+    (opt, opts) => opts ? [...opts, opt] : [opt],
+    Array()
+  ).option(...index.configOption).option(
+    "--inspect [host]",
+    "Enable debugger in Node.js environments. Applies to backend package only"
+  ).option(
+    "--inspect-brk [host]",
+    "Enable debugger in Node.js environments, breaking before code starts. Applies to backend package only"
+  ).option(
+    "--require <path...>",
+    "Add a --require argument to the node process. Applies to backend package only"
+  ).option("--link <path>", "Link an external workspace for module resolution").action(lazy.lazy(() => import('./commands/repo/start.cjs.js'), "command"));
+}
+function registerPackageCommands(command) {
+  command.command("start").description("Start a package for local development").option(...index.configOption).option("--role <name>", "Run the command with an explicit package role").option("--check", "Enable type checking and linting if available").option("--inspect [host]", "Enable debugger in Node.js environments").option(
+    "--inspect-brk [host]",
+    "Enable debugger in Node.js environments, breaking before code starts"
+  ).option(
+    "--require <path...>",
+    "Add a --require argument to the node process"
+  ).option("--link <path>", "Link an external workspace for module resolution").action(lazy.lazy(() => import('./commands/package/start/index.cjs.js'), "command"));
+}
+
+exports.registerPackageCommands = registerPackageCommands;
+exports.registerRepoCommands = registerRepoCommands;
+//# sourceMappingURL=index.cjs.js.map

package/dist/packages/backend-defaults/package.json.cjs.js

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

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

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

package/dist/packages/cli/package.json.cjs.js

@@ -1,6 +1,6 @@
 'use strict';
 
-var version = "0.32.0-next.0";
+var version = "0.32.0-next.2";
 var dependencies = {
 	"@backstage/catalog-model": "workspace:^",
 	"@backstage/cli-common": "workspace:^",

package/dist/packages/core-app-api/package.json.cjs.js

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

package/dist/packages/core-components/package.json.cjs.js

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

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

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

package/dist/packages/dev-utils/package.json.cjs.js

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

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

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

package/dist/packages/theme/package.json.cjs.js

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

package/dist/plugins/auth-backend/package.json.cjs.js

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

package/dist/plugins/catalog-node/package.json.cjs.js

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

package/dist/plugins/scaffolder-node/package.json.cjs.js

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

package/dist/plugins/scaffolder-node-test-utils/package.json.cjs.js

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@backstage/cli",
-  "version": "0.32.0-next.0",
+  "version": "0.32.0-next.2",
   "description": "CLI for developing Backstage plugins and apps",
   "backstage": {
     "role": "cli"
@@ -20,7 +20,8 @@
   "license": "Apache-2.0",
   "main": "dist/index.cjs.js",
   "bin": {
-    "backstage-cli": "bin/backstage-cli"
+    "backstage-cli": "bin/backstage-cli",
+    "backstage-cli-alpha": "bin/backstage-cli-alpha"
   },
   "files": [
     "asset-types",
@@ -54,7 +55,7 @@
     "@backstage/config-loader": "1.10.0",
     "@backstage/errors": "1.2.7",
     "@backstage/eslint-plugin": "0.1.10",
-    "@backstage/integration": "1.16.2",
+    "@backstage/integration": "1.16.3-next.0",
     "@backstage/release-manifests": "0.0.12",
     "@backstage/types": "1.2.1",
     "@manypkg/get-packages": "^1.1.3",
@@ -164,21 +165,21 @@
   },
   "devDependencies": {
     "@backstage/backend-plugin-api": "1.2.1",
-    "@backstage/backend-test-utils": "1.3.2-next.0",
+    "@backstage/backend-test-utils": "1.3.2-next.2",
     "@backstage/catalog-client": "1.9.1",
     "@backstage/config": "1.3.2",
-    "@backstage/core-app-api": "1.16.0",
-    "@backstage/core-components": "0.17.0",
-    "@backstage/core-plugin-api": "1.10.5",
-    "@backstage/dev-utils": "1.1.9-next.0",
+    "@backstage/core-app-api": "1.16.1-next.0",
+    "@backstage/core-components": "0.17.1-next.1",
+    "@backstage/core-plugin-api": "1.10.6-next.0",
+    "@backstage/dev-utils": "1.1.9-next.2",
     "@backstage/errors": "1.2.7",
-    "@backstage/plugin-auth-backend": "0.24.5-next.0",
+    "@backstage/plugin-auth-backend": "0.24.5-next.2",
     "@backstage/plugin-auth-backend-module-guest-provider": "0.2.6",
-    "@backstage/plugin-catalog-node": "1.16.1",
-    "@backstage/plugin-scaffolder-node": "0.8.1-next.0",
-    "@backstage/plugin-scaffolder-node-test-utils": "0.2.1-next.0",
-    "@backstage/test-utils": "1.7.6",
-    "@backstage/theme": "0.6.4",
+    "@backstage/plugin-catalog-node": "1.16.3-next.0",
+    "@backstage/plugin-scaffolder-node": "0.8.1-next.1",
+    "@backstage/plugin-scaffolder-node-test-utils": "0.2.1-next.2",
+    "@backstage/test-utils": "1.7.7-next.0",
+    "@backstage/theme": "0.6.5-next.0",
     "@rspack/core": "^1.0.10",
     "@rspack/dev-server": "^1.0.9",
     "@rspack/plugin-react-refresh": "^1.0.0",

package/templates/backend-plugin/README.md.hbs

@@ -25,4 +25,4 @@ This plugin backend can be started in a standalone mode from directly in this
 package with `yarn start`. It is a limited setup that is most convenient when
 developing the plugin backend itself.
 
-If you want to run the entire project, including the frontend, run `yarn dev` from the root directory.
+If you want to run the entire project, including the frontend, run `yarn start` from the root directory.

package/templates/backend-plugin/src/plugin.ts.hbs

@@ -3,7 +3,7 @@ import {
   createBackendPlugin,
 } from '@backstage/backend-plugin-api';
 import { createRouter } from './router';
-import { catalogServiceRef } from '@backstage/plugin-catalog-node/alpha';
+import { catalogServiceRef } from '@backstage/plugin-catalog-node';
 import { createTodoListService } from './services/TodoListService';
 
 /**
@@ -17,15 +17,13 @@ export const {{pluginVar}} = createBackendPlugin({
     env.registerInit({
       deps: {
         logger: coreServices.logger,
-        auth: coreServices.auth,
         httpAuth: coreServices.httpAuth,
         httpRouter: coreServices.httpRouter,
         catalog: catalogServiceRef,
       },
-      async init({ logger, auth, httpAuth, httpRouter, catalog }) {
+      async init({ logger, httpAuth, httpRouter, catalog }) {
         const todoListService = await createTodoListService({
           logger,
-          auth,
           catalog,
         });
 

package/templates/backend-plugin/src/services/TodoListService/createTodoListService.ts

@@ -1,6 +1,6 @@
-import { AuthService, LoggerService } from '@backstage/backend-plugin-api';
+import { LoggerService } from '@backstage/backend-plugin-api';
 import { NotFoundError } from '@backstage/errors';
-import { catalogServiceRef } from '@backstage/plugin-catalog-node/alpha';
+import { catalogServiceRef } from '@backstage/plugin-catalog-node';
 import crypto from 'node:crypto';
 import { TodoItem, TodoListService } from './types';
 
@@ -10,11 +10,9 @@ import { TodoItem, TodoListService } from './types';
 // documentation for more information on how to do this:
 // https://backstage.io/docs/backend-system/core-services/database
 export async function createTodoListService({
-  auth,
   logger,
   catalog,
 }: {
-  auth: AuthService;
   logger: LoggerService;
   catalog: typeof catalogServiceRef.T;
 }): Promise<TodoListService> {
@@ -40,13 +38,7 @@ export async function createTodoListService({
         // If you want to make a request using the plugin backend's own identity,
         // you can access it via the `auth.getOwnServiceCredentials()` method.
         // Beware that this bypasses any user permission checks.
-        const { token } = await auth.getPluginRequestToken({
-          onBehalfOf: options.credentials,
-          targetPluginId: 'catalog',
-        });
-        const entity = await catalog.getEntityByRef(input.entityRef, {
-          token,
-        });
+        const entity = await catalog.getEntityByRef(input.entityRef, options);
         if (!entity) {
           throw new NotFoundError(
             `No entity found for ref '${input.entityRef}'`,

package/templates/frontend-plugin/dev/index.tsx.hbs

@@ -1,4 +1,3 @@
-import React from 'react';
 import { createDevApp } from '@backstage/dev-utils';
 import { {{ pluginVar }}, {{ extensionName }} } from '../src/plugin';
 

package/templates/frontend-plugin/src/components/ExampleComponent/ExampleComponent.test.tsx.hbs

@@ -1,4 +1,3 @@
-import React from 'react';
 import { ExampleComponent } from './ExampleComponent';
 import { rest } from 'msw';
 import { setupServer } from 'msw/node';

package/templates/frontend-plugin/src/components/ExampleComponent/ExampleComponent.tsx.hbs

@@ -1,4 +1,3 @@
-import React from 'react';
 import { Typography, Grid } from '@material-ui/core';
 import {
   InfoCard,

package/templates/frontend-plugin/src/components/ExampleFetchComponent/ExampleFetchComponent.test.tsx.hbs

@@ -1,4 +1,3 @@
-import React from 'react';
 import { renderInTestApp } from '@backstage/test-utils';
 import { ExampleFetchComponent } from './ExampleFetchComponent';
 

package/templates/frontend-plugin/src/components/ExampleFetchComponent/ExampleFetchComponent.tsx.hbs

@@ -1,4 +1,3 @@
-import React from 'react';
 import { makeStyles } from '@material-ui/core/styles';
 import {
   Table,

package/templates/plugin-web-library/src/components/ExampleComponent/ExampleComponent.test.tsx

@@ -1,18 +1,17 @@
-import React from 'react';
-import { screen } from '@testing-library/react';
-import { renderInTestApp } from '@backstage/test-utils';
-import { ExampleComponent } from './ExampleComponent';
-
-describe('ExampleComponent', () => {
-  it('should render', async () => {
-    await renderInTestApp(<ExampleComponent />);
-
-    expect(screen.getByText('Hello World')).toBeInTheDocument();
-  });
-
-  it('should display a custom message', async () => {
-    await renderInTestApp(<ExampleComponent message="Hello Example" />);
-
-    expect(screen.getByText('Hello Example')).toBeInTheDocument();
-  });
-});
+import { screen } from '@testing-library/react';
+import { renderInTestApp } from '@backstage/test-utils';
+import { ExampleComponent } from './ExampleComponent';
+
+describe('ExampleComponent', () => {
+  it('should render', async () => {
+    await renderInTestApp(<ExampleComponent />);
+
+    expect(screen.getByText('Hello World')).toBeInTheDocument();
+  });
+
+  it('should display a custom message', async () => {
+    await renderInTestApp(<ExampleComponent message="Hello Example" />);
+
+    expect(screen.getByText('Hello Example')).toBeInTheDocument();
+  });
+});

package/templates/plugin-web-library/src/components/ExampleComponent/ExampleComponent.tsx

@@ -1,29 +1,28 @@
-import React from 'react';
-import { Typography } from '@material-ui/core';
-
-/**
- * Props for {@link ExampleComponent}.
- *
- * @public
- */
-export interface ExampleComponentProps {
-  message?: string;
-}
-
-/**
- * Displays an example.
- *
- * @remarks
- *
- * Longer descriptions should be put after the `@remarks` tag. That way the initial summary
- * will show up in the API docs overview section, while the longer description will only be
- * displayed on the page for the specific API.
- *
- * @public
- */
-export function ExampleComponent(props: ExampleComponentProps) {
-  // By destructuring props here rather than in the signature the API docs will look nicer
-  const { message = 'Hello World' } = props;
-
-  return <Typography variant="h1">{message}</Typography>;
-}
+import { Typography } from '@material-ui/core';
+
+/**
+ * Props for {@link ExampleComponent}.
+ *
+ * @public
+ */
+export interface ExampleComponentProps {
+  message?: string;
+}
+
+/**
+ * Displays an example.
+ *
+ * @remarks
+ *
+ * Longer descriptions should be put after the `@remarks` tag. That way the initial summary
+ * will show up in the API docs overview section, while the longer description will only be
+ * displayed on the page for the specific API.
+ *
+ * @public
+ */
+export function ExampleComponent(props: ExampleComponentProps) {
+  // By destructuring props here rather than in the signature the API docs will look nicer
+  const { message = 'Hello World' } = props;
+
+  return <Typography variant="h1">{message}</Typography>;
+}

package/dist/commands/start/command.cjs.js

@@ -1,75 +0,0 @@
-'use strict';
-
-var fs = require('fs-extra');
-var node_path = require('node:path');
-var role = require('../../lib/role.cjs.js');
-var startBackend = require('./startBackend.cjs.js');
-var startFrontend = require('./startFrontend.cjs.js');
-var errors = require('@backstage/errors');
-
-function _interopDefaultCompat (e) { return e && typeof e === 'object' && 'default' in e ? e : { default: e }; }
-
-var fs__default = /*#__PURE__*/_interopDefaultCompat(fs);
-
-async function command(opts) {
-  const role$1 = await role.findRoleFromCommand(opts);
-  if (opts.link) {
-    const dir = node_path.resolve(opts.link);
-    if (!fs__default.default.pathExistsSync(dir)) {
-      throw new Error(
-        `Invalid workspace link, directory does not exist: ${dir}`
-      );
-    }
-    const pkgJson = await fs__default.default.readJson(node_path.resolve(dir, "package.json")).catch((error) => {
-      throw new errors.ForwardedError(
-        "Failed to read package.json in linked workspace",
-        error
-      );
-    });
-    if (!pkgJson.workspaces) {
-      throw new Error(
-        `Invalid workspace link, directory is not a workspace: ${dir}`
-      );
-    }
-  }
-  const options = {
-    configPaths: opts.config,
-    checksEnabled: Boolean(opts.check),
-    linkedWorkspace: opts.link,
-    inspectEnabled: opts.inspect,
-    inspectBrkEnabled: opts.inspectBrk,
-    require: opts.require
-  };
-  switch (role$1) {
-    case "backend":
-      return startBackend.startBackend(options);
-    case "backend-plugin":
-    case "backend-plugin-module":
-    case "node-library":
-      return startBackend.startBackendPlugin(options);
-    case "frontend":
-      return startFrontend.startFrontend({
-        ...options,
-        entry: "src/index",
-        verifyVersions: true
-      });
-    case "web-library":
-    case "frontend-plugin":
-    case "frontend-plugin-module":
-      return startFrontend.startFrontend({ entry: "dev/index", ...options });
-    case "frontend-dynamic-container":
-      return startFrontend.startFrontend({
-        entry: "src/index",
-        ...options,
-        skipOpenBrowser: true,
-        isModuleFederationRemote: true
-      });
-    default:
-      throw new Error(
-        `Start command is not supported for package role '${role$1}'`
-      );
-  }
-}
-
-exports.command = command;
-//# sourceMappingURL=command.cjs.js.map