@backstage/cli 0.35.5-next.0 → 0.36.0-next.2

package/dist/modules/build/commands/package/postpack.cjs.js

@@ -0,0 +1,15 @@
+'use strict';
+
+Object.defineProperty(exports, '__esModule', { value: true });
+
+var cleye = require('cleye');
+var cliCommon = require('@backstage/cli-common');
+var productionPack = require('../../lib/packager/productionPack.cjs.js');
+
+var postpack = async ({ args, info }) => {
+  cleye.cli({ help: info, booleanFlagNegation: true }, void 0, args);
+  await productionPack.revertProductionPack(cliCommon.targetPaths.dir);
+};
+
+exports.default = postpack;
+//# sourceMappingURL=postpack.cjs.js.map

package/dist/modules/{maintenance/commands/package/pack.cjs.js → build/commands/package/prepack.cjs.js}

@@ -1,16 +1,20 @@
 'use strict';
 
-var productionPack = require('../../../build/lib/packager/productionPack.cjs.js');
-var cliCommon = require('@backstage/cli-common');
+Object.defineProperty(exports, '__esModule', { value: true });
+
+var cleye = require('cleye');
 var fs = require('fs-extra');
+var cliCommon = require('@backstage/cli-common');
+var productionPack = require('../../lib/packager/productionPack.cjs.js');
 var publishing = require('../../lib/publishing.cjs.js');
-var typeDistProject = require('../../../../lib/typeDistProject.cjs.js');
+var typeDistProject = require('../../lib/typeDistProject.cjs.js');
 
 function _interopDefaultCompat (e) { return e && typeof e === 'object' && 'default' in e ? e : { default: e }; }
 
 var fs__default = /*#__PURE__*/_interopDefaultCompat(fs);
 
-const pre = async () => {
+var prepack = async ({ args, info }) => {
+  cleye.cli({ help: info, booleanFlagNegation: true }, void 0, args);
   publishing.publishPreflightCheck({
     dir: cliCommon.targetPaths.dir,
     packageJson: await fs__default.default.readJson(cliCommon.targetPaths.resolve("package.json"))
@@ -20,10 +24,6 @@ const pre = async () => {
     featureDetectionProject: await typeDistProject.createTypeDistProject()
   });
 };
-const post = async () => {
-  await productionPack.revertProductionPack(cliCommon.targetPaths.dir);
-};
 
-exports.post = post;
-exports.pre = pre;
-//# sourceMappingURL=pack.cjs.js.map
+exports.default = prepack;
+//# sourceMappingURL=prepack.cjs.js.map

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

@@ -1,23 +1,80 @@
 'use strict';
 
+Object.defineProperty(exports, '__esModule', { value: true });
+
+var cleye = require('cleye');
 var startPackage = require('./startPackage.cjs.js');
 var resolveLinkedWorkspace = require('./resolveLinkedWorkspace.cjs.js');
 var role = require('../../../lib/role.cjs.js');
 var cliCommon = require('@backstage/cli-common');
 
-async function command(opts) {
+var command = async ({ args, info }) => {
+  const {
+    flags: {
+      config,
+      role: role$1,
+      check,
+      require: requirePath,
+      link,
+      entrypoint,
+      inspect,
+      inspectBrk
+    }
+  } = cleye.cli(
+    {
+      help: info,
+      booleanFlagNegation: true,
+      flags: {
+        config: {
+          type: [String],
+          description: "Config files to load instead of app-config.yaml",
+          default: []
+        },
+        role: {
+          type: String,
+          description: "Run the command with an explicit package role"
+        },
+        check: {
+          type: Boolean,
+          description: "Enable type checking and linting if available"
+        },
+        require: {
+          type: String,
+          description: "Add a --require argument to the node process"
+        },
+        link: {
+          type: String,
+          description: "Link an external workspace for module resolution"
+        },
+        entrypoint: {
+          type: String,
+          description: 'The entrypoint to start from, relative to the package root. Can point to either a file (without extension) or a directory (in which case the index file in that directory is used). Defaults to "dev"'
+        },
+        inspect: {
+          type: String,
+          description: "Enable the Node.js inspector, optionally at a specific host:port"
+        },
+        inspectBrk: {
+          type: String,
+          description: "Enable the Node.js inspector and break before user code starts"
+        }
+      }
+    },
+    void 0,
+    args
+  );
   await startPackage.startPackage({
-    role: await role.findRoleFromCommand(opts),
-    entrypoint: opts.entrypoint,
+    role: await role.findRoleFromCommand({ role: role$1 }),
+    entrypoint,
     targetDir: cliCommon.targetPaths.dir,
-    configPaths: opts.config,
-    checksEnabled: Boolean(opts.check),
-    linkedWorkspace: await resolveLinkedWorkspace.resolveLinkedWorkspace(opts.link),
-    inspectEnabled: opts.inspect,
-    inspectBrkEnabled: opts.inspectBrk,
-    require: opts.require
+    configPaths: config,
+    checksEnabled: Boolean(check),
+    linkedWorkspace: await resolveLinkedWorkspace.resolveLinkedWorkspace(link),
+    inspectEnabled: inspect || (inspect === "" ? true : void 0),
+    inspectBrkEnabled: inspectBrk || (inspectBrk === "" ? true : void 0),
+    require: requirePath
   });
-}
+};
 
-exports.command = command;
+exports.default = command;
 //# sourceMappingURL=command.cjs.js.map

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

@@ -1,8 +1,10 @@
 'use strict';
 
+Object.defineProperty(exports, '__esModule', { value: true });
+
 var command = require('./command.cjs.js');
 
 
 
-exports.command = command.command;
+exports.default = command.default;
 //# sourceMappingURL=index.cjs.js.map

package/dist/modules/build/commands/package/start/startFrontend.cjs.js

@@ -13,7 +13,7 @@ require('react-dev-utils/ModuleScopePlugin');
 require('@module-federation/enhanced/rspack');
 require('lodash/pickBy');
 var cliCommon = require('@backstage/cli-common');
-require('../../../../../lib/version.cjs.js');
+require('../../../../../wiring/version.cjs.js');
 var hasReactDomClient = require('../../../lib/bundler/hasReactDomClient.cjs.js');
 require('@manypkg/get-packages');
 require('chalk');

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

@@ -1,25 +1,52 @@
 'use strict';
 
+Object.defineProperty(exports, '__esModule', { value: true });
+
 var chalk = require('chalk');
+var cleye = require('cleye');
 var path = require('node:path');
 var packager = require('../../lib/builder/packager.cjs.js');
 var cliCommon = require('@backstage/cli-common');
 var cliNode = require('@backstage/cli-node');
 var buildFrontend = require('../../lib/buildFrontend.cjs.js');
 var buildBackend = require('../../lib/buildBackend.cjs.js');
-var optionsParser = require('../../../../lib/optionsParser.cjs.js');
+var optionsParser = require('../../lib/optionsParser.cjs.js');
 
 function _interopDefaultCompat (e) { return e && typeof e === 'object' && 'default' in e ? e : { default: e }; }
 
 var chalk__default = /*#__PURE__*/_interopDefaultCompat(chalk);
 
-async function command(opts, cmd) {
+var build = async ({ args, info }) => {
+  const {
+    flags: { all, since, minify }
+  } = cleye.cli(
+    {
+      help: info,
+      booleanFlagNegation: true,
+      flags: {
+        all: {
+          type: Boolean,
+          description: "Build all packages, including bundled app and backend packages."
+        },
+        since: {
+          type: String,
+          description: "Only build packages and their dev dependents that changed since the specified ref"
+        },
+        minify: {
+          type: Boolean,
+          description: "Minify the generated code. Does not apply to app package (app is minified by default)."
+        }
+      }
+    },
+    void 0,
+    args
+  );
   let packages = await cliNode.PackageGraph.listTargetPackages();
   const webpack = process.env.LEGACY_WEBPACK_BUILD ? require("webpack") : void 0;
-  if (opts.since) {
+  if (since) {
     const graph = cliNode.PackageGraph.fromPackages(packages);
     const changedPackages = await graph.listChangedPackages({
-      ref: opts.since,
+      ref: since,
       analyzeLockfile: true
     });
     const withDevDependents = graph.collectPackageNames(
@@ -30,7 +57,14 @@ async function command(opts, cmd) {
   }
   const apps = new Array();
   const backends = new Array();
-  const parseBuildScript = optionsParser.createScriptOptionsParser(cmd, ["package", "build"]);
+  const parseBuildScript = optionsParser.createScriptOptionsParser(["package", "build"], {
+    role: { type: "string" },
+    minify: { type: "boolean" },
+    "skip-build-dependencies": { type: "boolean" },
+    stats: { type: "boolean" },
+    config: { type: "string", multiple: true },
+    "module-federation": { type: "boolean" }
+  });
   const options = packages.flatMap((pkg) => {
     const role = pkg.packageJson.backstage?.role ?? cliNode.PackageRoles.detectRoleFromPackage(pkg.packageJson);
     if (!role) {
@@ -62,12 +96,12 @@ async function command(opts, cmd) {
       outputs,
       logPrefix: `${chalk__default.default.cyan(path.relative(cliCommon.targetPaths.rootDir, pkg.dir))}: `,
       workspacePackages: packages,
-      minify: opts.minify ?? buildOptions.minify
+      minify: minify ?? Boolean(buildOptions.minify)
     };
   });
   console.log("Building packages");
   await packager.buildPackages(options);
-  if (opts.all) {
+  if (all) {
     console.log("Building apps");
     await cliNode.runConcurrentTasks({
       items: apps,
@@ -80,9 +114,10 @@ async function command(opts, cmd) {
           );
           return;
         }
+        const configPaths = buildOptions.config;
         await buildFrontend.buildFrontend({
           targetDir: pkg.dir,
-          configPaths: buildOptions.config ?? [],
+          configPaths: Array.isArray(configPaths) ? configPaths : [],
           writeStats: Boolean(buildOptions.stats),
           webpack
         });
@@ -103,12 +138,12 @@ async function command(opts, cmd) {
         await buildBackend.buildBackend({
           targetDir: pkg.dir,
           skipBuildDependencies: true,
-          minify: opts.minify ?? buildOptions.minify
+          minify: minify ?? Boolean(buildOptions.minify)
         });
       }
     });
   }
-}
+};
 
-exports.command = command;
+exports.default = build;
 //# sourceMappingURL=build.cjs.js.map

package/dist/modules/{maintenance → build}/commands/repo/clean.cjs.js

@@ -1,5 +1,8 @@
 'use strict';
 
+Object.defineProperty(exports, '__esModule', { value: true });
+
+var cleye = require('cleye');
 var fs = require('fs-extra');
 var path = require('node:path');
 var cliNode = require('@backstage/cli-node');
@@ -9,7 +12,8 @@ function _interopDefaultCompat (e) { return e && typeof e === 'object' && 'defau
 
 var fs__default = /*#__PURE__*/_interopDefaultCompat(fs);
 
-async function command() {
+var clean = async ({ args, info }) => {
+  cleye.cli({ help: info, booleanFlagNegation: true }, void 0, args);
   const packages = await cliNode.PackageGraph.listTargetPackages();
   await fs__default.default.remove(cliCommon.targetPaths.resolveRoot("dist"));
   await fs__default.default.remove(cliCommon.targetPaths.resolveRoot("dist-types"));
@@ -31,7 +35,7 @@ async function command() {
       }
     })
   );
-}
+};
 
-exports.command = command;
+exports.default = clean;
 //# sourceMappingURL=clean.cjs.js.map

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

@@ -1,8 +1,11 @@
 'use strict';
 
+Object.defineProperty(exports, '__esModule', { value: true });
+
 var cliNode = require('@backstage/cli-node');
 var path = require('node:path');
 var cliCommon = require('@backstage/cli-common');
+var cleye = require('cleye');
 var resolveLinkedWorkspace = require('../package/start/resolveLinkedWorkspace.cjs.js');
 var startPackage = require('../package/start/startPackage.cjs.js');
 var node_util = require('node:util');
@@ -13,9 +16,55 @@ const ACCEPTED_PACKAGE_ROLES = [
   "frontend-plugin",
   "backend-plugin"
 ];
-async function command(namesOrPaths, options) {
-  const targetPackages = await findTargetPackages(namesOrPaths, options.plugin);
-  const packageOptions = await resolvePackageOptions(targetPackages, options);
+var start = async ({ args, info }) => {
+  const {
+    flags: { plugin, config, require: requirePath, link, inspect, inspectBrk },
+    _: namesOrPaths
+  } = cleye.cli(
+    {
+      help: { ...info, usage: `${info.usage} [packages...]` },
+      booleanFlagNegation: true,
+      parameters: ["[packages...]"],
+      flags: {
+        plugin: {
+          type: [String],
+          description: "Start the dev entry-point for any matching plugin package in the repo",
+          default: []
+        },
+        config: {
+          type: [String],
+          description: "Config files to load instead of app-config.yaml",
+          default: []
+        },
+        require: {
+          type: String,
+          description: "Add a --require argument to the node process. Applies to backend package only"
+        },
+        link: {
+          type: String,
+          description: "Link an external workspace for module resolution"
+        },
+        inspect: {
+          type: String,
+          description: "Enable the Node.js inspector, optionally at a specific host:port"
+        },
+        inspectBrk: {
+          type: String,
+          description: "Enable the Node.js inspector and break before user code starts"
+        }
+      }
+    },
+    void 0,
+    args
+  );
+  const targetPackages = await findTargetPackages(namesOrPaths, plugin);
+  const packageOptions = await resolvePackageOptions(targetPackages, {
+    config,
+    inspect: inspect || (inspect === "" ? true : void 0),
+    inspectBrk: inspectBrk || (inspectBrk === "" ? true : void 0),
+    require: requirePath,
+    link
+  });
   if (packageOptions.length === 0) {
     console.log("No packages found to start");
     return;
@@ -24,7 +73,7 @@ async function command(namesOrPaths, options) {
     `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();
@@ -145,6 +194,6 @@ async function resolvePackageOptions(targetPackages, options) {
   });
 }
 
-exports.command = command;
+exports.default = start;
 exports.findTargetPackages = findTargetPackages;
 //# sourceMappingURL=start.cjs.js.map

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

@@ -2,158 +2,67 @@
 
 Object.defineProperty(exports, '__esModule', { value: true });
 
-var commander = require('commander');
 var factory = require('../../wiring/factory.cjs.js');
-var lazy = require('../../lib/lazy.cjs.js');
-var index = require('../config/index.cjs.js');
 
-function registerPackageCommands(command) {
-  command.command("build").description("Build a package for production deployment or publishing").option("--role <name>", "Run the command with an explicit package role").option(
-    "--minify",
-    "Minify the generated code. Does not apply to app package (app is minified by default)."
-  ).option(
-    "--skip-build-dependencies",
-    "Skip the automatic building of local dependencies. Applies to backend packages only."
-  ).option(
-    "--stats",
-    "If bundle stats are available, write them to the output directory. Applies to app packages only."
-  ).option(
-    "--config <path>",
-    "Config files to load instead of app-config.yaml. Applies to app packages only.",
-    (opt, opts) => opts ? [...opts, opt] : [opt],
-    Array()
-  ).option(
-    "--module-federation",
-    "Build a package as a module federation remote. Applies to frontend plugin packages only."
-  ).action(lazy.lazy(() => import('./commands/package/build/index.cjs.js'), "command"));
-}
 const buildPlugin = factory.createCliPlugin({
   pluginId: "build",
   init: async (reg) => {
     reg.addCommand({
       path: ["package", "build"],
       description: "Build a package for production deployment or publishing",
-      execute: async ({ args }) => {
-        const command = new commander.Command();
-        const defaultCommand = command.option(
-          "--role <name>",
-          "Run the command with an explicit package role"
-        ).option(
-          "--minify",
-          "Minify the generated code. Does not apply to app package (app is minified by default)."
-        ).option(
-          "--skip-build-dependencies",
-          "Skip the automatic building of local dependencies. Applies to backend packages only."
-        ).option(
-          "--stats",
-          "If bundle stats are available, write them to the output directory. Applies to app packages only."
-        ).option(
-          "--config <path>",
-          "Config files to load instead of app-config.yaml. Applies to app packages only.",
-          (opt, opts) => opts ? [...opts, opt] : [opt],
-          Array()
-        ).option(
-          "--module-federation",
-          "Build a package as a module federation remote. Applies to frontend plugin packages only."
-        ).action(lazy.lazy(() => import('./commands/package/build/index.cjs.js'), "command"));
-        await defaultCommand.parseAsync(args, { from: "user" });
-      }
+      execute: { loader: () => import('./commands/package/build/index.cjs.js') }
     });
     reg.addCommand({
       path: ["repo", "build"],
       description: "Build packages in the project, excluding bundled app and backend packages.",
-      execute: async ({ args }) => {
-        const command = new commander.Command();
-        registerPackageCommands(command.command("package"));
-        const defaultCommand = command.option(
-          "--all",
-          "Build all packages, including bundled app and backend packages."
-        ).option(
-          "--since <ref>",
-          "Only build packages and their dev dependents that changed since the specified ref"
-        ).option(
-          "--minify",
-          "Minify the generated code. Does not apply to app package (app is minified by default)."
-        ).action(lazy.lazy(() => import('./commands/repo/build.cjs.js'), "command"));
-        await defaultCommand.parseAsync(args, { from: "user" });
-      }
+      execute: { loader: () => import('./commands/repo/build.cjs.js') }
     });
     reg.addCommand({
       path: ["package", "start"],
       description: "Start a package for local development",
-      execute: async ({ args }) => {
-        const command = new commander.Command();
-        const defaultCommand = command.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"
-        ).option(
-          "--entrypoint <path>",
-          'The entrypoint to start from, relative to the package root. Can point to either a file (without extension) or a directory (in which case the index file in that directory is used). Defaults to "dev"'
-        ).action(lazy.lazy(() => import('./commands/package/start/index.cjs.js'), "command"));
-        await defaultCommand.parseAsync(args, { from: "user" });
-      }
+      execute: { loader: () => import('./commands/package/start/index.cjs.js') }
     });
     reg.addCommand({
       path: ["repo", "start"],
       description: "Starts packages in the repo for local development",
-      execute: async ({ args }) => {
-        const command = new commander.Command();
-        const defaultCommand = command.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")
-        );
-        await defaultCommand.parseAsync(args, { from: "user" });
+      execute: { loader: () => import('./commands/repo/start.cjs.js') }
+    });
+    reg.addCommand({
+      path: ["package", "clean"],
+      description: "Delete cache directories",
+      execute: {
+        loader: () => import('./commands/package/clean.cjs.js')
+      }
+    });
+    reg.addCommand({
+      path: ["package", "prepack"],
+      description: "Prepares a package for packaging before publishing",
+      execute: {
+        loader: () => import('./commands/package/prepack.cjs.js')
+      }
+    });
+    reg.addCommand({
+      path: ["package", "postpack"],
+      description: "Restores the changes made by the prepack command",
+      execute: {
+        loader: () => import('./commands/package/postpack.cjs.js')
+      }
+    });
+    reg.addCommand({
+      path: ["repo", "clean"],
+      description: "Delete cache and output directories",
+      execute: {
+        loader: () => import('./commands/repo/clean.cjs.js')
       }
     });
     reg.addCommand({
       path: ["build-workspace"],
       description: "Builds a temporary dist workspace from the provided packages",
-      execute: async ({ args }) => {
-        const command = new commander.Command();
-        const defaultCommand = command.arguments("<workspace-dir> [packages...]").addOption(
-          new commander.Option(
-            "--alwaysYarnPack",
-            "Alias for --alwaysPack for backwards compatibility."
-          ).implies({ alwaysPack: true }).hideHelp(true)
-        ).option(
-          "--alwaysPack",
-          "Force workspace output to be a result of running `yarn pack` on each package (warning: very slow)"
-        ).action(lazy.lazy(() => import('./commands/buildWorkspace.cjs.js'), "default"));
-        await defaultCommand.parseAsync(args, { from: "user" });
-      }
+      execute: { loader: () => import('./commands/buildWorkspace.cjs.js') }
     });
   }
 });
 
 exports.buildPlugin = buildPlugin;
 exports.default = buildPlugin;
-exports.registerPackageCommands = registerPackageCommands;
 //# sourceMappingURL=index.cjs.js.map

package/dist/modules/build/lib/buildFrontend.cjs.js

@@ -9,14 +9,14 @@ require('react-dev-utils/openBrowser');
 require('@rspack/core');
 require('@rspack/dev-server');
 require('@backstage/cli-common');
-var config = require('../../config/lib/config.cjs.js');
+var config = require('./config.cjs.js');
 require('eslint-rspack-plugin');
 require('ts-checker-rspack-plugin');
 require('html-webpack-plugin');
 require('react-dev-utils/ModuleScopePlugin');
 require('@module-federation/enhanced/rspack');
 require('lodash/pickBy');
-require('../../../lib/version.cjs.js');
+require('../../../wiring/version.cjs.js');
 require('yn');
 require('@manypkg/get-packages');
 require('./bundler/packageDetection.cjs.js');

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

@@ -12,7 +12,7 @@ var optimization = require('./optimization.cjs.js');
 var pickBy = require('lodash/pickBy');
 var cliCommon = require('@backstage/cli-common');
 var transforms = require('./transforms.cjs.js');
-var version = require('../../../../lib/version.cjs.js');
+var version = require('../../../../wiring/version.cjs.js');
 var yn = require('yn');
 var hasReactDomClient = require('./hasReactDomClient.cjs.js');
 var linkWorkspaces = require('./linkWorkspaces.cjs.js');

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

@@ -1,7 +1,7 @@
 'use strict';
 
 var entryPoints = require('../entryPoints.cjs.js');
-var typeDistProject = require('../../../../lib/typeDistProject.cjs.js');
+var typeDistProject = require('../typeDistProject.cjs.js');
 var moduleFederationCommon = require('@backstage/module-federation-common');
 var path = require('node:path');
 var fs = require('fs-extra');

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

@@ -7,7 +7,7 @@ var openBrowser = require('react-dev-utils/openBrowser');
 var core = require('@rspack/core');
 var devServer = require('@rspack/dev-server');
 var cliCommon = require('@backstage/cli-common');
-var config = require('../../../config/lib/config.cjs.js');
+var config = require('../config.cjs.js');
 var config$1 = require('./config.cjs.js');
 var packageDetection = require('./packageDetection.cjs.js');
 var paths = require('./paths.cjs.js');