@backstage/cli 0.32.0-next.1 → 0.32.0

package/CHANGELOG.md

@@ -1,5 +1,122 @@
 # @backstage/cli
 
+## 0.32.0
+
+### 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>
+
+- 65b584c: Internal update to move the `new` and `create-github-app` to their own module.
+- c7254ae: Internal update to move the `clean`, `pre/postpack` and `fix` commands into their own separate module.
+
+### Patch Changes
+
+- 4ea76f7: Bump @module-federation/enhanced ^0.9.0 to fix GHSA-593f-38f6-jp5m
+- 87a5cb4: Fixed an issue causing the `repo lint` command to fail when the `--max-warnings` option was used.
+- 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
+- d83f3f4: Resolved a problem where the `start` command did not correctly handle multiple `--require` flags, ensuring all specified modules are now properly loaded.
+- 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.
+
+- 918c883: Included a reference to the JSX transform guide in the warning about using the default React import.
+- Updated dependencies
+  - @backstage/integration@1.16.3
+  - @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.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

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 https://backstage.io/docs/tutorials/jsx-transform-migration migration guide for details.',
+              selector:
+                "ImportDeclaration[source.value='react'][specifiers.0.type='ImportDefaultSpecifier']",
+            },
+            {
+              message:
+                'React default imports are deprecated. Follow the https://backstage.io/docs/tutorials/jsx-transform-migration 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

@@ -1,86 +1,52 @@
 'use strict';
 
-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$6 = 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$7 = require('../modules/test/index.cjs.js');
+var index$8 = require('../modules/lint/index.cjs.js');
+var index$9 = require('../modules/maintenance/index.cjs.js');
+var removed = require('../lib/removed.cjs.js');
+var index$4 = require('../modules/new/index.cjs.js');
+var index$5 = require('../modules/create-github-app/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$5.registerRepoCommands(command);
   index$6.registerRepoCommands(command);
+  index$2.registerRepoCommands(command);
+  index$7.registerRepoCommands(command);
+  index$8.registerRepoCommands(command);
+  index$9.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$5.registerPackageCommands(command);
+  index$2.registerPackageCommands(command);
+  index$7.registerPackageCommands(command);
+  index$9.registerPackageCommands(command);
+  index$8.registerPackageCommands(command);
 }
 function registerCommands(program) {
-  program.command("new").storeOptionsAsProperties(false).description(
-    "Open up an interactive guide to creating new things in your app"
-  ).option(
-    "--select <name>",
-    "Select the thing you want to be creating upfront"
-  ).option(
-    "--option <name>=<value>",
-    "Pre-fill options for the creation process",
-    (opt, arr) => [...arr, opt],
-    []
-  ).option(
-    "--skip-install",
-    `Skips running 'yarn install' and 'yarn lint --fix'`
-  ).option("--scope <scope>", "The scope to use for new packages").option(
-    "--npm-registry <URL>",
-    "The package registry to use for new packages"
-  ).option(
-    "--baseVersion <version>",
-    "The version to use for any new packages (default: 0.1.0)"
-  ).option(
-    "--license <license>",
-    "The license to use for any new packages (default: Apache-2.0)"
-  ).option("--no-private", "Do not mark new packages as private").action(lazy.lazy(() => import('./new/new.cjs.js'), "default"));
   index.registerCommands(program);
   registerRepoCommand(program);
   registerScriptCommand(program);
   index$1.registerCommands(program);
   index$2.registerCommands(program);
   index$3.registerCommands(program);
-  program.command("create-github-app <github-org>").description("Create new GitHub App in your organization.").action(lazy.lazy(() => import('./create-github-app/index.cjs.js'), "default"));
-  program.command("create").allowUnknownOption(true).action(removed("use 'backstage-cli new' instead"));
-  program.command("create-plugin").allowUnknownOption(true).action(removed("use 'backstage-cli new' instead"));
-  program.command("plugin:diff").allowUnknownOption(true).action(removed("use 'backstage-cli fix' instead"));
+  index$4.registerCommands(program);
+  index$5.registerCommands(program);
+  program.command("plugin:diff").allowUnknownOption(true).action(removed.removed("use 'backstage-cli fix' instead"));
   program.command("test").allowUnknownOption(true).action(
-    removed(
+    removed.removed(
       "use 'backstage-cli repo test' or 'backstage-cli package test' instead"
     )
   );
-  program.command("clean").allowUnknownOption(true).action(removed("use 'backstage-cli package clean' instead"));
-  program.command("versions:check").allowUnknownOption(true).action(removed("use 'yarn dedupe' or 'yarn-deduplicate' instead"));
-  program.command("install").allowUnknownOption(true).action(removed());
-  program.command("onboard").allowUnknownOption(true).action(removed());
-}
-function removed(message) {
-  return () => {
-    console.error(
-      message ? `This command has been removed, ${message}` : "This command has been removed"
-    );
-    process.exit(1);
-  };
+  program.command("clean").allowUnknownOption(true).action(removed.removed("use 'backstage-cli package clean' instead"));
+  program.command("versions:check").allowUnknownOption(true).action(removed.removed("use 'yarn dedupe' or 'yarn-deduplicate' instead"));
+  program.command("install").allowUnknownOption(true).action(removed.removed());
+  program.command("onboard").allowUnknownOption(true).action(removed.removed());
 }
 
 exports.registerCommands = registerCommands;

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/removed.cjs.js

@@ -0,0 +1,13 @@
+'use strict';
+
+function removed(message) {
+  return () => {
+    console.error(
+      message ? `This command has been removed, ${message}` : "This command has been removed"
+    );
+    process.exit(1);
+  };
+}
+
+exports.removed = removed;
+//# sourceMappingURL=removed.cjs.js.map

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/{commands → modules/create-github-app/commands}/create-github-app/index.cjs.js

@@ -6,7 +6,7 @@ var fs = require('fs-extra');
 var chalk = require('chalk');
 var yaml = require('yaml');
 var inquirer = require('inquirer');
-var paths = require('../../lib/paths.cjs.js');
+var paths = require('../../../../lib/paths.cjs.js');
 var GithubCreateAppServer = require('./GithubCreateAppServer.cjs.js');
 var openBrowser = require('react-dev-utils/openBrowser');
 

package/dist/modules/create-github-app/index.cjs.js

@@ -0,0 +1,15 @@
+'use strict';
+
+var lazy = require('../../lib/lazy.cjs.js');
+
+function registerCommands(program) {
+  program.command("create-github-app <github-org>").description("Create new GitHub App in your organization.").action(
+    lazy.lazy(
+      () => import('./commands/create-github-app/index.cjs.js'),
+      "default"
+    )
+  );
+}
+
+exports.registerCommands = registerCommands;
+//# sourceMappingURL=index.cjs.js.map

package/dist/{commands/new → modules/new/commands}/new.cjs.js

@@ -2,7 +2,7 @@
 
 Object.defineProperty(exports, '__esModule', { value: true });
 
-var createNewPackage = require('../../lib/new/createNewPackage.cjs.js');
+var createNewPackage = require('../lib/createNewPackage.cjs.js');
 
 var _new = async (opts) => {
   const {

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

@@ -0,0 +1,35 @@
+'use strict';
+
+var lazy = require('../../lib/lazy.cjs.js');
+var removed = require('../../lib/removed.cjs.js');
+
+function registerCommands(program) {
+  program.command("new").storeOptionsAsProperties(false).description(
+    "Open up an interactive guide to creating new things in your app"
+  ).option(
+    "--select <name>",
+    "Select the thing you want to be creating upfront"
+  ).option(
+    "--option <name>=<value>",
+    "Pre-fill options for the creation process",
+    (opt, arr) => [...arr, opt],
+    []
+  ).option(
+    "--skip-install",
+    `Skips running 'yarn install' and 'yarn lint --fix'`
+  ).option("--scope <scope>", "The scope to use for new packages").option(
+    "--npm-registry <URL>",
+    "The package registry to use for new packages"
+  ).option(
+    "--baseVersion <version>",
+    "The version to use for any new packages (default: 0.1.0)"
+  ).option(
+    "--license <license>",
+    "The license to use for any new packages (default: Apache-2.0)"
+  ).option("--no-private", "Do not mark new packages as private").action(lazy.lazy(() => import('./commands/new.cjs.js'), "default"));
+  program.command("create").allowUnknownOption(true).action(removed.removed("use 'backstage-cli new' instead"));
+  program.command("create-plugin").allowUnknownOption(true).action(removed.removed("use 'backstage-cli new' instead"));
+}
+
+exports.registerCommands = registerCommands;
+//# sourceMappingURL=index.cjs.js.map

package/dist/{lib/new → modules/new/lib}/execution/PortableTemplater.cjs.js

@@ -9,14 +9,14 @@ var startCase = require('lodash/startCase');
 var upperCase = require('lodash/upperCase');
 var upperFirst = require('lodash/upperFirst');
 var lowerFirst = require('lodash/lowerFirst');
-var Lockfile = require('../../versioning/Lockfile.cjs.js');
+var Lockfile = require('../../../../lib/versioning/Lockfile.cjs.js');
 require('minimatch');
 require('@manypkg/get-packages');
 require('chalk');
-require('../../yarn.cjs.js');
-require('../../run.cjs.js');
-var paths = require('../../paths.cjs.js');
-var version = require('../../version.cjs.js');
+require('../../../../lib/yarn.cjs.js');
+require('../../../../lib/run.cjs.js');
+var paths = require('../../../../lib/paths.cjs.js');
+var version = require('../../../../lib/version.cjs.js');
 
 function _interopDefaultCompat (e) { return e && typeof e === 'object' && 'default' in e ? e : { default: e }; }
 

package/dist/{lib/new → modules/new/lib}/execution/executePortableTemplate.cjs.js

@@ -1,8 +1,8 @@
 'use strict';
 
 var errors = require('@backstage/errors');
-var codeowners = require('../../codeowners/codeowners.cjs.js');
-var tasks = require('../../tasks.cjs.js');
+var codeowners = require('../../../../lib/codeowners/codeowners.cjs.js');
+var tasks = require('../../../../lib/tasks.cjs.js');
 var installNewPackage = require('./installNewPackage.cjs.js');
 var writeTemplateContents = require('./writeTemplateContents.cjs.js');
 

package/dist/{lib/new → modules/new/lib}/execution/installNewPackage.cjs.js

@@ -3,8 +3,8 @@
 var fs = require('fs-extra');
 var upperFirst = require('lodash/upperFirst');
 var camelCase = require('lodash/camelCase');
-var paths = require('../../paths.cjs.js');
-var tasks = require('../../tasks.cjs.js');
+var paths = require('../../../../lib/paths.cjs.js');
+var tasks = require('../../../../lib/tasks.cjs.js');
 
 function _interopDefaultCompat (e) { return e && typeof e === 'object' && 'default' in e ? e : { default: e }; }
 

package/dist/{lib/new → modules/new/lib}/execution/writeTemplateContents.cjs.js

@@ -2,7 +2,7 @@
 
 var fs = require('fs-extra');
 var path = require('path');
-var paths = require('../../paths.cjs.js');
+var paths = require('../../../../lib/paths.cjs.js');
 var errors = require('@backstage/errors');
 var cliNode = require('@backstage/cli-node');
 var PortableTemplater = require('./PortableTemplater.cjs.js');

package/dist/{lib/new → modules/new/lib}/preparation/collectPortableTemplateInput.cjs.js

@@ -1,8 +1,8 @@
 'use strict';
 
 var inquirer = require('inquirer');
-var codeowners = require('../../codeowners/codeowners.cjs.js');
-var paths = require('../../paths.cjs.js');
+var codeowners = require('../../../../lib/codeowners/codeowners.cjs.js');
+var paths = require('../../../../lib/paths.cjs.js');
 var resolvePackageParams = require('./resolvePackageParams.cjs.js');
 
 function _interopDefaultCompat (e) { return e && typeof e === 'object' && 'default' in e ? e : { default: e }; }

package/dist/{lib/new → modules/new/lib}/preparation/loadPortableTemplate.cjs.js

@@ -6,7 +6,7 @@ var recursiveReaddir = require('recursive-readdir');
 var path = require('path');
 var node_path = require('node:path');
 var yaml = require('yaml');
-var paths = require('../../paths.cjs.js');
+var paths = require('../../../../lib/paths.cjs.js');
 var types = require('../types.cjs.js');
 var errors = require('@backstage/errors');
 var zodValidationError = require('zod-validation-error');

package/dist/{lib/new → modules/new/lib}/preparation/loadPortableTemplateConfig.cjs.js

@@ -2,7 +2,7 @@
 
 var fs = require('fs-extra');
 var node_path = require('node:path');
-var paths = require('../../paths.cjs.js');
+var paths = require('../../../../lib/paths.cjs.js');
 var defaultTemplates = require('../defaultTemplates.cjs.js');
 var types = require('../types.cjs.js');
 var yaml = require('yaml');

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,