beachball 3.0.0-alpha.4 → 3.0.0-alpha.6

package/lib/options/commandDefinitions.js

@@ -0,0 +1,43 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.allCommandNames = exports.commandDefinitions = void 0;
+const changeExtra = 'Considers committed and staged changes, but not unstaged or untracked changes.';
+exports.commandDefinitions = {
+    change: {
+        desc: 'Create change file(s) for this branch if needed',
+        extraDesc: changeExtra +
+            '\n\nBy default, an interactive prompt is used to choose the type and message for each changed package. ' +
+            'Use --message and --type (and optionally --package) to skip the prompt. ' +
+            'For help choosing a change type, see https://microsoft.github.io/beachball/concepts/change-types',
+        isDefault: true,
+    },
+    check: { desc: 'Check whether change file(s) are needed for this branch', extraDesc: changeExtra },
+    publish: { desc: 'Bump, publish to npm registry, and push updates back to the target branch' },
+    bump: { desc: "Bump versions and generate changelogs, but don't commit or publish" },
+    sync: {
+        desc: 'Synchronize package versions from the registry with local package.json versions',
+    },
+    config: {
+        desc: 'Get or list config settings (requires a sub-command)',
+        subcommands: {
+            get: {
+                desc: 'Get the value of a config setting (with any overrides)',
+                args: { '<name>': 'beachball config setting name' },
+            },
+            list: { desc: 'List all config settings (with any overrides)' },
+        },
+    },
+    migrate: { desc: 'Help to migrate from beachball v2' },
+    canary: { desc: 'Publish prerelease versions of changed or all packages without committing' },
+    init: {
+        desc: 'Initialize a new beachball config file in the current directory',
+        hidden: true,
+    },
+};
+const extraCommandNames = Object.keys({
+    'config get': true,
+    'config list': true,
+});
+/** All command names including nested */
+exports.allCommandNames = [...Object.keys(exports.commandDefinitions), ...extraCommandNames];
+//# sourceMappingURL=commandDefinitions.js.map

package/lib/options/commandDefinitions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"commandDefinitions.js","sourceRoot":"","sources":["../../src/options/commandDefinitions.ts"],"names":[],"mappings":";;;AAwBA,MAAM,WAAW,GAAG,gFAAgF,CAAC;AAExF,QAAA,kBAAkB,GAA+C;IAC5E,MAAM,EAAE;QACN,IAAI,EAAE,iDAAiD;QACvD,SAAS,EACP,WAAW;YACX,yGAAyG;YACzG,0EAA0E;YAC1E,kGAAkG;QACpG,SAAS,EAAE,IAAI;KAChB;IACD,KAAK,EAAE,EAAE,IAAI,EAAE,yDAAyD,EAAE,SAAS,EAAE,WAAW,EAAE;IAClG,OAAO,EAAE,EAAE,IAAI,EAAE,2EAA2E,EAAE;IAC9F,IAAI,EAAE,EAAE,IAAI,EAAE,oEAAoE,EAAE;IACpF,IAAI,EAAE;QACJ,IAAI,EAAE,iFAAiF;KACxF;IACD,MAAM,EAAE;QACN,IAAI,EAAE,sDAAsD;QAC5D,WAAW,EAAE;YACX,GAAG,EAAE;gBACH,IAAI,EAAE,wDAAwD;gBAC9D,IAAI,EAAE,EAAE,QAAQ,EAAE,+BAA+B,EAAE;aACpD;YACD,IAAI,EAAE,EAAE,IAAI,EAAE,+CAA+C,EAAE;SAChE;KACF;IACD,OAAO,EAAE,EAAE,IAAI,EAAE,mCAAmC,EAAE;IACtD,MAAM,EAAE,EAAE,IAAI,EAAE,2EAA2E,EAAE;IAC7F,IAAI,EAAE;QACJ,IAAI,EAAE,iEAAiE;QACvE,MAAM,EAAE,IAAI;KACb;CACF,CAAC;AAEF,MAAM,iBAAiB,GAAG,MAAM,CAAC,IAAI,CAAC;IACpC,YAAY,EAAE,IAAI;IAClB,aAAa,EAAE,IAAI;CAC0C,CAAC,CAAC;AAEjE,yCAAyC;AAC5B,QAAA,eAAe,GAAG,CAAC,GAAG,MAAM,CAAC,IAAI,CAAC,0BAAkB,CAAC,EAAE,GAAG,iBAAiB,CAA2B,CAAC"}

package/lib/options/getCliOptions.d.ts

@@ -1,5 +1,6 @@
+import type { OutputConfiguration } from 'commander';
 import type { CliOptions, ParsedOptions } from '../types/BeachballOptions';
-export interface ProcessInfo {
+export interface ProgramContext {
     /** Complete argv (node and script path aren't used but elements must be present) */
     argv: string[];
     /**
@@ -16,13 +17,35 @@ export interface ProcessInfo {
     env: NodeJS.ProcessEnv | {
         NPM_TOKEN?: string;
     };
+    /** Beachball version (optional in tests) */
+    version?: string;
+    /** Output options override (mainly for testing) */
+    outputOptions?: OutputConfiguration;
 }
 /**
  * Gets CLI options. Also gets the `NPM_TOKEN` environment variable if present.
+ *
+ * In v3, parsing was migrated from `yargs-parser` to `commander`. Implementation notes:
+ * - Each beachball command is registered as a commander subcommand, but currently `cli.ts` still
+ *   handles the actual command dispatching (switch on `options.command`).
+ * - The `config` command has commander `get <name>` / `list` subcommands.
+ * - Every option is declared on both the parent command and each subcommand (so options can be
+ *   specified either before or after the command name), following yargs behavior.
+ * - Descriptions/help are handled through commander's built-in help system.
+ * - `--help` and `--version` flags are handled by commander (it will print the info and exit).
+ * - In Jest, commander is configured to throw on error rather than calling `process.exit()`,
+ *   and `outputOptions` (logging) use no-op functions by default.
+ *
+ * Some yargs-parser behaviors are preserved by custom logic in `BeachballOption`/`BeachballCommand`:
+ * - camelCase flags (e.g. `--gitTags`) in addition to dashed flags (e.g. `--git-tags`)
+ * - extra long-flag aliases (e.g. `--config` for `--config-path`)
+ * - boolean options automatically get a negated `--no-` form
+ *
+ * Other yargs-parser behaviors are NOT preserved:
+ * - arbitrary unknown options are errors
+ * - boolean options do not accept a value (e.g. `--verbose true` is an error)
  */
-export declare function getCliOptions(processInfo: ProcessInfo): ParsedOptions['cliOptions'];
-/** @deprecated Pass full process info */
-export declare function getCliOptions(argv: string[]): ParsedOptions['cliOptions'];
+export declare function getCliOptions(programContext: ProgramContext): ParsedOptions['cliOptions'];
 /**
  * Resolves `rawOptions.branch` if provided to ensure it includes the remote name.
  * If no branch is provided, returns the default branch.

package/lib/options/getCliOptions.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"getCliOptions.d.ts","sourceRoot":"","sources":["../../src/options/getCliOptions.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAI3E,MAAM,WAAW,WAAW;IAC1B,oFAAoF;IACpF,IAAI,EAAE,MAAM,EAAE,CAAC;IACf;;;;;OAKG;IACH,GAAG,EAAE,MAAM,CAAC;IACZ;;;OAGG;IACH,GAAG,EAAE,MAAM,CAAC,UAAU,GAAG;QAAE,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;CACjD;AAyGD;;GAEG;AACH,wBAAgB,aAAa,CAAC,WAAW,EAAE,WAAW,GAAG,aAAa,CAAC,YAAY,CAAC,CAAC;AACrF,yCAAyC;AACzC,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,aAAa,CAAC,YAAY,CAAC,CAAC;AAiF3E;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,UAAU,EAAE,OAAO,CAAC,IAAI,CAAC,UAAU,EAAE,QAAQ,GAAG,SAAS,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAUpH"}
+{"version":3,"file":"getCliOptions.d.ts","sourceRoot":"","sources":["../../src/options/getCliOptions.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,WAAW,CAAC;AAIrD,OAAO,KAAK,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAK3E,MAAM,WAAW,cAAc;IAC7B,oFAAoF;IACpF,IAAI,EAAE,MAAM,EAAE,CAAC;IACf;;;;;OAKG;IACH,GAAG,EAAE,MAAM,CAAC;IACZ;;;OAGG;IACH,GAAG,EAAE,MAAM,CAAC,UAAU,GAAG;QAAE,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAChD,4CAA4C;IAC5C,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,mDAAmD;IACnD,aAAa,CAAC,EAAE,mBAAmB,CAAC;CACrC;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,aAAa,CAAC,cAAc,EAAE,cAAc,GAAG,aAAa,CAAC,YAAY,CAAC,CAyDzF;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,UAAU,EAAE,OAAO,CAAC,IAAI,CAAC,UAAU,EAAE,QAAQ,GAAG,SAAS,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAUpH"}

package/lib/options/getCliOptions.js

@@ -1,171 +1,82 @@
 "use strict";
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.getCliOptions = getCliOptions;
 exports.resolveBranchOption = resolveBranchOption;
 const workspace_tools_1 = require("workspace-tools");
-const yargs_parser_1 = __importDefault(require("yargs-parser"));
 const env_1 = require("../env");
 const getRemoteBranch_1 = require("../git/getRemoteBranch");
-const tempGetDefaultRemoteBranch_1 = require("../git/tempGetDefaultRemoteBranch");
-// For camelCased options, yargs will automatically accept them with-dashes too.
-const arrayOptions = ['disallowedChangeTypes', 'package', 'scope'];
-const booleanOptions = [
-    'all',
-    'bump',
-    'bumpDeps',
-    'commit',
-    'disallowDeletedChangeFiles',
-    'fetch',
-    'forceVersions',
-    'gitTags',
-    'help',
-    'keepChangeFiles',
-    'publish',
-    'push',
-    'verbose',
-    'version',
-    'yes',
-];
-const numberOptions = ['concurrency', 'depth', 'npmReadConcurrency', 'gitTimeout', 'retries', 'timeout'];
-const stringOptions = [
-    'access',
-    'authType',
-    'branch',
-    'canaryName',
-    'changehint',
-    'changeDir',
-    'configPath',
-    'dependentChangeType',
-    'fromRef',
-    'message',
-    'packToPath',
-    'prereleasePrefix',
-    'registry',
-    'tag',
-    'token',
-    'type',
-];
-/** Type hack to verify that an array includes all keys of a type */
-const allKeysOfType = () => (
-// eslint-disable-next-line @typescript-eslint/no-explicit-any
-...x) => x;
-// Verify that all the known CLI options have types specified, to ensure correct parsing.
-//
-// NOTE: If a prop is missing, this will have a somewhat misleading error:
-//   Argument of type '"disallowedChangeTypes"' is not assignable to parameter of type '"tag" | "version"'
-//
-// To fix, add the missing names after "parameter of type" ("tag" and "version" in this example)
-// to the appropriate array above.
-const knownOptions = allKeysOfType()(...arrayOptions, ...booleanOptions, ...numberOptions, ...stringOptions, 
-// these options are filled in below, not respected from the command line
-'path', 'command', '_extraPositionalArgs');
-const parserOptions = {
-    configuration: {
-        'boolean-negation': true,
-        'camel-case-expansion': true,
-        'dot-notation': false,
-        'duplicate-arguments-array': true,
-        'flatten-duplicate-arrays': true,
-        'greedy-arrays': true, // for now; we might want to change this to false in the future
-        'parse-numbers': true,
-        'parse-positional-numbers': false,
-        'short-option-groups': false,
-        'strip-aliased': true,
-        'strip-dashed': true,
-    },
-    // spread to get rid of readonly...
-    array: [...arrayOptions],
-    boolean: [...booleanOptions],
-    number: [...numberOptions],
-    string: [...stringOptions],
-    alias: {
-        authType: ['a'],
-        branch: ['b'],
-        configPath: ['c', 'config'],
-        forceVersions: ['force'],
-        fromRef: ['since'],
-        help: ['h', '?'],
-        message: ['m'],
-        package: ['p'],
-        registry: ['r'],
-        tag: ['t'],
-        token: ['n'],
-        version: ['v'],
-        yes: ['y'],
-    },
-};
-function getCliOptions(processOrArgv) {
-    const processInfo = Array.isArray(processOrArgv)
-        ? // eslint-disable-next-line no-restricted-properties -- legacy API
-            { argv: processOrArgv, cwd: env_1.env.isJest ? '' : process.cwd(), env: process.env }
-        : processOrArgv;
-    // Be careful not to mutate the input argv
-    const trimmedArgv = processInfo.argv.slice(2);
-    const args = (0, yargs_parser_1.default)(trimmedArgv, parserOptions);
-    const { _: positionalArgs, ...options } = args;
-    let cwd = processInfo.cwd;
+const BeachballCommand_1 = require("./BeachballCommand");
+const optionDefinitions_1 = require("./optionDefinitions");
+const commandDefinitions_1 = require("./commandDefinitions");
+/**
+ * Gets CLI options. Also gets the `NPM_TOKEN` environment variable if present.
+ *
+ * In v3, parsing was migrated from `yargs-parser` to `commander`. Implementation notes:
+ * - Each beachball command is registered as a commander subcommand, but currently `cli.ts` still
+ *   handles the actual command dispatching (switch on `options.command`).
+ * - The `config` command has commander `get <name>` / `list` subcommands.
+ * - Every option is declared on both the parent command and each subcommand (so options can be
+ *   specified either before or after the command name), following yargs behavior.
+ * - Descriptions/help are handled through commander's built-in help system.
+ * - `--help` and `--version` flags are handled by commander (it will print the info and exit).
+ * - In Jest, commander is configured to throw on error rather than calling `process.exit()`,
+ *   and `outputOptions` (logging) use no-op functions by default.
+ *
+ * Some yargs-parser behaviors are preserved by custom logic in `BeachballOption`/`BeachballCommand`:
+ * - camelCase flags (e.g. `--gitTags`) in addition to dashed flags (e.g. `--git-tags`)
+ * - extra long-flag aliases (e.g. `--config` for `--config-path`)
+ * - boolean options automatically get a negated `--no-` form
+ *
+ * Other yargs-parser behaviors are NOT preserved:
+ * - arbitrary unknown options are errors
+ * - boolean options do not accept a value (e.g. `--verbose true` is an error)
+ */
+function getCliOptions(programContext) {
+    let { cwd } = programContext;
+    const program = BeachballCommand_1.BeachballCommand.initProgram({
+        name: 'beachball',
+        desc: 'the sunniest version bumping tool',
+        options: optionDefinitions_1.optionDefinitions,
+        commands: commandDefinitions_1.commandDefinitions,
+        version: programContext.version,
+        outputOptions: programContext.outputOptions,
+    });
+    // For --help or --version, this will print the info and exit
+    const { command, options, extraArgs: extraPositionalArgs } = program.beachballParse(programContext.argv);
     try {
         // If a non-empty cwd is provided, find the project root from there.
         // Empty means this is a test without a filesystem.
         if (cwd && !env_1.env.isJest) {
-            cwd = (0, workspace_tools_1.findProjectRoot)(processInfo.cwd);
+            cwd = (0, workspace_tools_1.findProjectRoot)(cwd);
         }
     }
     catch {
         // use the provided cwd
     }
-    if (positionalArgs.length > 1 && String(positionalArgs[0]) !== 'config') {
-        throw new Error(`Only one positional argument (the command) is allowed. Received: ${positionalArgs.join(' ')}`);
-    }
     const cliOptions = {
         ...options,
-        command: positionalArgs.length ? String(positionalArgs[0]) : 'change',
+        command,
         path: cwd,
     };
-    // Save extra positional args for commands that support subcommands (e.g. 'config get <name>')
-    // (yargs-parser doesn't support positional arguments directly)
-    const extraPositionalArgs = positionalArgs.length > 1 ? positionalArgs.slice(1).map(String) : undefined;
-    if (args.branch) {
-        cliOptions.branch = resolveBranchOption(args, cwd);
+    if (cliOptions.branch) {
+        cliOptions.branch = resolveBranchOption(cliOptions, cwd);
     }
     if (cliOptions.command === 'canary') {
         cliOptions.tag = cliOptions.canaryName || 'canary';
     }
     for (const key of Object.keys(cliOptions)) {
-        const value = cliOptions[key];
-        if (value === undefined) {
+        if (cliOptions[key] === undefined) {
             delete cliOptions[key];
         }
-        else if (typeof value === 'number' && isNaN(value)) {
-            throw new Error(`Non-numeric value passed for numeric option "${key}"`);
-        }
-        else if (knownOptions.includes(key)) {
-            if (Array.isArray(value) && !arrayOptions.includes(key)) {
-                throw new Error(`Option "${key}" only accepts a single value. Received: ${value.join(' ')}`);
-            }
-        }
-        else if (value === 'true') {
-            // For unknown arguments like --foo=true or --bar=false, yargs will handle the value as a string.
-            // Convert it to a boolean to avoid subtle bugs.
-            // eslint-disable-next-line
-            cliOptions[key] = true;
-        }
-        else if (value === 'false') {
-            // eslint-disable-next-line
-            cliOptions[key] = false;
-        }
     }
-    // Set extra positional args after the validation loop (it's an internal array, not from CLI parsing)
-    if (extraPositionalArgs) {
+    // Save extra positional args for commands that support subcommands (e.g. 'config get <name>').
+    if (extraPositionalArgs.length) {
         cliOptions._extraPositionalArgs = extraPositionalArgs;
     }
     // If both --token and NPM_TOKEN are provided, prefer the CLI token (could go either way, but
     // this is safer for compatibility in case anyone was already using that env name another way)
-    if (processInfo.env.NPM_TOKEN && cliOptions.token === undefined) {
-        cliOptions.token = processInfo.env.NPM_TOKEN;
+    if (programContext.env.NPM_TOKEN && cliOptions.token === undefined) {
+        cliOptions.token = programContext.env.NPM_TOKEN;
     }
     return cliOptions;
 }
@@ -174,7 +85,7 @@ function getCliOptions(processOrArgv) {
  * If no branch is provided, returns the default branch.
  */
 function resolveBranchOption(rawOptions, cwd) {
-    const branchResult = (0, tempGetDefaultRemoteBranch_1.resolveRemoteAndBranch)({
+    const branchResult = (0, workspace_tools_1.resolveRemoteAndBranch)({
         branch: rawOptions.branch,
         cwd,
         verbose: rawOptions.verbose,

package/lib/options/getCliOptions.js.map

@@ -1 +1 @@
-{"version":3,"file":"getCliOptions.js","sourceRoot":"","sources":["../../src/options/getCliOptions.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"getCliOptions.js","sourceRoot":"","sources":["../../src/options/getCliOptions.ts"],"names":[],"mappings":";;AAqDA,sCAyDC;AAMD,kDAUC;AA7HD,qDAA0E;AAC1E,gCAA6B;AAC7B,4DAA2D;AAE3D,yDAAsD;AACtD,2DAAwD;AACxD,6DAA0D;AAuB1D;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,SAAgB,aAAa,CAAC,cAA8B;IAC1D,IAAI,EAAE,GAAG,EAAE,GAAG,cAAc,CAAC;IAE7B,MAAM,OAAO,GAAG,mCAAgB,CAAC,WAAW,CAAC;QAC3C,IAAI,EAAE,WAAW;QACjB,IAAI,EAAE,mCAAmC;QACzC,OAAO,EAAE,qCAAiB;QAC1B,QAAQ,EAAE,uCAAkB;QAC5B,OAAO,EAAE,cAAc,CAAC,OAAO;QAC/B,aAAa,EAAE,cAAc,CAAC,aAAa;KAC5C,CAAC,CAAC;IAEH,6DAA6D;IAC7D,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,mBAAmB,EAAE,GAAG,OAAO,CAAC,cAAc,CAAC,cAAc,CAAC,IAAI,CAAC,CAAC;IAEzG,IAAI,CAAC;QACH,oEAAoE;QACpE,mDAAmD;QACnD,IAAI,GAAG,IAAI,CAAC,SAAG,CAAC,MAAM,EAAE,CAAC;YACvB,GAAG,GAAG,IAAA,iCAAe,EAAC,GAAG,CAAC,CAAC;QAC7B,CAAC;IACH,CAAC;IAAC,MAAM,CAAC;QACP,uBAAuB;IACzB,CAAC;IAED,MAAM,UAAU,GAAgC;QAC9C,GAAG,OAAO;QACV,OAAO;QACP,IAAI,EAAE,GAAG;KACV,CAAC;IAEF,IAAI,UAAU,CAAC,MAAM,EAAE,CAAC;QACtB,UAAU,CAAC,MAAM,GAAG,mBAAmB,CAAC,UAAU,EAAE,GAAG,CAAC,CAAC;IAC3D,CAAC;IAED,IAAI,UAAU,CAAC,OAAO,KAAK,QAAQ,EAAE,CAAC;QACpC,UAAU,CAAC,GAAG,GAAG,UAAU,CAAC,UAAU,IAAI,QAAQ,CAAC;IACrD,CAAC;IAED,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,UAAU,CAAyB,EAAE,CAAC;QAClE,IAAI,UAAU,CAAC,GAAG,CAAC,KAAK,SAAS,EAAE,CAAC;YAClC,OAAO,UAAU,CAAC,GAAG,CAAC,CAAC;QACzB,CAAC;IACH,CAAC;IAED,+FAA+F;IAC/F,IAAI,mBAAmB,CAAC,MAAM,EAAE,CAAC;QAC/B,UAAU,CAAC,oBAAoB,GAAG,mBAAmB,CAAC;IACxD,CAAC;IAED,6FAA6F;IAC7F,8FAA8F;IAC9F,IAAI,cAAc,CAAC,GAAG,CAAC,SAAS,IAAI,UAAU,CAAC,KAAK,KAAK,SAAS,EAAE,CAAC;QACnE,UAAU,CAAC,KAAK,GAAG,cAAc,CAAC,GAAG,CAAC,SAAS,CAAC;IAClD,CAAC;IAED,OAAO,UAAU,CAAC;AACpB,CAAC;AAED;;;GAGG;AACH,SAAgB,mBAAmB,CAAC,UAA2D,EAAE,GAAW;IAC1G,MAAM,YAAY,GAAG,IAAA,wCAAsB,EAAC;QAC1C,MAAM,EAAE,UAAU,CAAC,MAAM;QACzB,GAAG;QACH,OAAO,EAAE,UAAU,CAAC,OAAO;QAC3B,MAAM,EAAE,IAAI;KACb,CAAC,CAAC;IACH,IAAA,mCAAiB,EAAC,YAAY,EAAE,GAAG,CAAC,CAAC;IAErC,OAAO,GAAG,YAAY,CAAC,MAAM,IAAI,YAAY,CAAC,YAAY,EAAE,CAAC;AAC/D,CAAC"}

package/lib/options/getDefaultOptions.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"getDefaultOptions.d.ts","sourceRoot":"","sources":["../../src/options/getDefaultOptions.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AAElE;;GAEG;AACH,wBAAgB,iBAAiB,IAAI,gBAAgB,CAmCpD"}
+{"version":3,"file":"getDefaultOptions.d.ts","sourceRoot":"","sources":["../../src/options/getDefaultOptions.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AAElE;;GAEG;AACH,wBAAgB,iBAAiB,IAAI,gBAAgB,CAkCpD"}

package/lib/options/getDefaultOptions.js

@@ -37,7 +37,6 @@ function getDefaultOptions() {
         tag: '',
         timeout: undefined,
         type: null,
-        version: false,
         yes: env_1.env.isCI,
     };
 }

package/lib/options/getDefaultOptions.js.map

@@ -1 +1 @@
-{"version":3,"file":"getDefaultOptions.js","sourceRoot":"","sources":["../../src/options/getDefaultOptions.ts"],"names":[],"mappings":";;AAMA,8CAmCC;AAzCD,gCAA6B;AAG7B;;GAEG;AACH,SAAgB,iBAAiB;IAC/B,OAAO;QACL,MAAM,EAAE,YAAY;QACpB,GAAG,EAAE,KAAK;QACV,QAAQ,EAAE,WAAW;QACrB,MAAM,EAAE,eAAe;QACvB,IAAI,EAAE,IAAI;QACV,QAAQ,EAAE,IAAI;QACd,UAAU,EAAE,SAAS;QACrB,UAAU,EAAE,gDAAgD;QAC5D,SAAS,EAAE,QAAQ;QACnB,OAAO,EAAE,QAAQ;QACjB,MAAM,EAAE,IAAI;QACZ,WAAW,EAAE,CAAC;QACd,aAAa,EAAE,QAAQ;QACvB,KAAK,EAAE,SAAS;QAChB,qBAAqB,EAAE,IAAI;QAC3B,KAAK,EAAE,IAAI;QACX,iBAAiB,EAAE,IAAI;QACvB,OAAO,EAAE,IAAI;QACb,UAAU,EAAE,SAAS;QACrB,OAAO,EAAE,EAAE;QACX,kBAAkB,EAAE,SAAG,CAAC,cAAc;QACtC,IAAI,EAAE,EAAE;QACR,OAAO,EAAE,IAAI;QACb,IAAI,EAAE,IAAI;QACV,QAAQ,EAAE,6BAA6B;QACvC,OAAO,EAAE,CAAC;QACV,KAAK,EAAE,IAAI;QACX,GAAG,EAAE,EAAE;QACP,OAAO,EAAE,SAAS;QAClB,IAAI,EAAE,IAAI;QACV,OAAO,EAAE,KAAK;QACd,GAAG,EAAE,SAAG,CAAC,IAAI;KACd,CAAC;AACJ,CAAC"}
+{"version":3,"file":"getDefaultOptions.js","sourceRoot":"","sources":["../../src/options/getDefaultOptions.ts"],"names":[],"mappings":";;AAMA,8CAkCC;AAxCD,gCAA6B;AAG7B;;GAEG;AACH,SAAgB,iBAAiB;IAC/B,OAAO;QACL,MAAM,EAAE,YAAY;QACpB,GAAG,EAAE,KAAK;QACV,QAAQ,EAAE,WAAW;QACrB,MAAM,EAAE,eAAe;QACvB,IAAI,EAAE,IAAI;QACV,QAAQ,EAAE,IAAI;QACd,UAAU,EAAE,SAAS;QACrB,UAAU,EAAE,gDAAgD;QAC5D,SAAS,EAAE,QAAQ;QACnB,OAAO,EAAE,QAAQ;QACjB,MAAM,EAAE,IAAI;QACZ,WAAW,EAAE,CAAC;QACd,aAAa,EAAE,QAAQ;QACvB,KAAK,EAAE,SAAS;QAChB,qBAAqB,EAAE,IAAI;QAC3B,KAAK,EAAE,IAAI;QACX,iBAAiB,EAAE,IAAI;QACvB,OAAO,EAAE,IAAI;QACb,UAAU,EAAE,SAAS;QACrB,OAAO,EAAE,EAAE;QACX,kBAAkB,EAAE,SAAG,CAAC,cAAc;QACtC,IAAI,EAAE,EAAE;QACR,OAAO,EAAE,IAAI;QACb,IAAI,EAAE,IAAI;QACV,QAAQ,EAAE,6BAA6B;QACvC,OAAO,EAAE,CAAC;QACV,KAAK,EAAE,IAAI;QACX,GAAG,EAAE,EAAE;QACP,OAAO,EAAE,SAAS;QAClB,IAAI,EAAE,IAAI;QACV,GAAG,EAAE,SAAG,CAAC,IAAI;KACd,CAAC;AACJ,CAAC"}

package/lib/options/getOptions.d.ts

@@ -1,15 +1,10 @@
-import type { BeachballOptions, ParsedOptions, RepoOptions } from '../types/BeachballOptions';
-import { type ProcessInfo } from './getCliOptions';
-/**
- * Gets all repo level options (default + root options + cli options)
- * @deprecated Use `getParsedOptions`
- */
-export declare function getOptions(argv: string[]): BeachballOptions;
+import type { ParsedOptions, RepoOptions } from '../types/BeachballOptions';
+import { type ProgramContext } from './getCliOptions';
 /**
  * Get merged and unmerged options, for reuse by `getPackageInfos`.
  * @param testRepoOptions Repo options for testing purposes
  */
-export declare function getParsedOptions(params: ProcessInfo & {
+export declare function getOptions(params: ProgramContext & {
     testRepoOptions?: Partial<RepoOptions>;
 }): ParsedOptions;
 //# sourceMappingURL=getOptions.d.ts.map

package/lib/options/getOptions.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"getOptions.d.ts","sourceRoot":"","sources":["../../src/options/getOptions.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AAC9F,OAAO,EAAiB,KAAK,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAIlE;;;GAGG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,gBAAgB,CAO3D;AAED;;;GAGG;AAEH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,WAAW,GAAG;IAAE,eAAe,CAAC,EAAE,OAAO,CAAC,WAAW,CAAC,CAAA;CAAE,GAAG,aAAa,CAShH"}
+{"version":3,"file":"getOptions.d.ts","sourceRoot":"","sources":["../../src/options/getOptions.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAoB,aAAa,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AAC9F,OAAO,EAAiB,KAAK,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAIrE;;;GAGG;AACH,wBAAgB,UAAU,CAAC,MAAM,EAAE,cAAc,GAAG;IAAE,eAAe,CAAC,EAAE,OAAO,CAAC,WAAW,CAAC,CAAA;CAAE,GAAG,aAAa,CAS7G"}

package/lib/options/getOptions.js

@@ -1,28 +1,14 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.getOptions = getOptions;
-exports.getParsedOptions = getParsedOptions;
 const getCliOptions_1 = require("./getCliOptions");
 const getRepoOptions_1 = require("./getRepoOptions");
 const getDefaultOptions_1 = require("./getDefaultOptions");
-/**
- * Gets all repo level options (default + root options + cli options)
- * @deprecated Use `getParsedOptions`
- */
-function getOptions(argv) {
-    // eslint-disable-next-line no-restricted-properties -- deprecated API
-    const cliOptions = (0, getCliOptions_1.getCliOptions)({ argv, cwd: process.cwd(), env: process.env });
-    return mergeRepoOptions({
-        repoOptions: (0, getRepoOptions_1.getRepoOptions)(cliOptions),
-        cliOptions,
-    });
-}
 /**
  * Get merged and unmerged options, for reuse by `getPackageInfos`.
  * @param testRepoOptions Repo options for testing purposes
  */
-// TODO: rename back to getOptions in a major release
-function getParsedOptions(params) {
+function getOptions(params) {
     const { testRepoOptions, ...processInfo } = params;
     const cliOptions = (0, getCliOptions_1.getCliOptions)(processInfo);
     const repoOptions = testRepoOptions || (0, getRepoOptions_1.getRepoOptions)(cliOptions);

package/lib/options/getOptions.js.map

@@ -1 +1 @@
-{"version":3,"file":"getOptions.js","sourceRoot":"","sources":["../../src/options/getOptions.ts"],"names":[],"mappings":";;AASA,gCAOC;AAOD,4CASC;AA/BD,mDAAkE;AAClE,qDAAkD;AAClD,2DAAwD;AAExD;;;GAGG;AACH,SAAgB,UAAU,CAAC,IAAc;IACvC,sEAAsE;IACtE,MAAM,UAAU,GAAG,IAAA,6BAAa,EAAC,EAAE,IAAI,EAAE,GAAG,EAAE,OAAO,CAAC,GAAG,EAAE,EAAE,GAAG,EAAE,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC;IACjF,OAAO,gBAAgB,CAAC;QACtB,WAAW,EAAE,IAAA,+BAAc,EAAC,UAAU,CAAC;QACvC,UAAU;KACX,CAAC,CAAC;AACL,CAAC;AAED;;;GAGG;AACH,qDAAqD;AACrD,SAAgB,gBAAgB,CAAC,MAAgE;IAC/F,MAAM,EAAE,eAAe,EAAE,GAAG,WAAW,EAAE,GAAG,MAAM,CAAC;IACnD,MAAM,UAAU,GAAG,IAAA,6BAAa,EAAC,WAAW,CAAC,CAAC;IAC9C,MAAM,WAAW,GAAG,eAAe,IAAI,IAAA,+BAAc,EAAC,UAAU,CAAC,CAAC;IAClE,OAAO;QACL,UAAU;QACV,WAAW;QACX,OAAO,EAAE,gBAAgB,CAAC,EAAE,WAAW,EAAE,UAAU,EAAE,CAAC;KACvD,CAAC;AACJ,CAAC;AAED,mDAAmD;AACnD,SAAS,gBAAgB,CACvB,MAAiF;IAEjF,MAAM,EAAE,WAAW,EAAE,UAAU,EAAE,GAAG,MAAM,CAAC;IAC3C,iCAAiC;IACjC,+FAA+F;IAC/F,OAAO;QACL,GAAG,IAAA,qCAAiB,GAAE;QACtB,GAAG,WAAW;QACd,GAAG,UAAU;KACd,CAAC;AACJ,CAAC"}
+{"version":3,"file":"getOptions.js","sourceRoot":"","sources":["../../src/options/getOptions.ts"],"names":[],"mappings":";;AASA,gCASC;AAjBD,mDAAqE;AACrE,qDAAkD;AAClD,2DAAwD;AAExD;;;GAGG;AACH,SAAgB,UAAU,CAAC,MAAmE;IAC5F,MAAM,EAAE,eAAe,EAAE,GAAG,WAAW,EAAE,GAAG,MAAM,CAAC;IACnD,MAAM,UAAU,GAAG,IAAA,6BAAa,EAAC,WAAW,CAAC,CAAC;IAC9C,MAAM,WAAW,GAAG,eAAe,IAAI,IAAA,+BAAc,EAAC,UAAU,CAAC,CAAC;IAClE,OAAO;QACL,UAAU;QACV,WAAW;QACX,OAAO,EAAE,gBAAgB,CAAC,EAAE,WAAW,EAAE,UAAU,EAAE,CAAC;KACvD,CAAC;AACJ,CAAC;AAED,mDAAmD;AACnD,SAAS,gBAAgB,CACvB,MAAiF;IAEjF,MAAM,EAAE,WAAW,EAAE,UAAU,EAAE,GAAG,MAAM,CAAC;IAC3C,iCAAiC;IACjC,+FAA+F;IAC/F,OAAO;QACL,GAAG,IAAA,qCAAiB,GAAE;QACtB,GAAG,WAAW;QACd,GAAG,UAAU;KACd,CAAC;AACJ,CAAC"}

package/lib/options/getPackageInfosWithOptions.d.ts

@@ -10,6 +10,4 @@ import { type PackageInfos } from '../types/PackageInfo';
  * Use this to force adding the getter for testing its behavior.
  */
 export declare function getPackageInfosWithOptions(wsPackageInfos: WSPackageInfo[], cliOptions: Partial<CliOptions> | null, enableCombinedOptionsForTests?: boolean): PackageInfos;
-/** @deprecated Provide the pre-parsed options */
-export declare function getPackageInfosWithOptions(wsPackageInfos: WSPackageInfo[]): PackageInfos;
 //# sourceMappingURL=getPackageInfosWithOptions.d.ts.map

package/lib/options/getPackageInfosWithOptions.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"getPackageInfosWithOptions.d.ts","sourceRoot":"","sources":["../../src/options/getPackageInfosWithOptions.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,IAAI,aAAa,EAAE,MAAM,iBAAiB,CAAC;AACpE,OAAO,KAAK,EAAkB,UAAU,EAAE,MAAM,2BAA2B,CAAC;AAG5E,OAAO,EAA4C,KAAK,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAEnG;;;;;;;GAOG;AACH,wBAAgB,0BAA0B,CACxC,cAAc,EAAE,aAAa,EAAE,EAC/B,UAAU,EAAE,OAAO,CAAC,UAAU,CAAC,GAAG,IAAI,EACtC,6BAA6B,CAAC,EAAE,OAAO,GACtC,YAAY,CAAC;AAChB,iDAAiD;AACjD,wBAAgB,0BAA0B,CAAC,cAAc,EAAE,aAAa,EAAE,GAAG,YAAY,CAAC"}
+{"version":3,"file":"getPackageInfosWithOptions.d.ts","sourceRoot":"","sources":["../../src/options/getPackageInfosWithOptions.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,IAAI,aAAa,EAAE,MAAM,iBAAiB,CAAC;AACpE,OAAO,KAAK,EAAkB,UAAU,EAAE,MAAM,2BAA2B,CAAC;AAE5E,OAAO,EAA4C,KAAK,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAEnG;;;;;;;GAOG;AACH,wBAAgB,0BAA0B,CACxC,cAAc,EAAE,aAAa,EAAE,EAC/B,UAAU,EAAE,OAAO,CAAC,UAAU,CAAC,GAAG,IAAI,EACtC,6BAA6B,CAAC,EAAE,OAAO,GACtC,YAAY,CAoCd"}

package/lib/options/getPackageInfosWithOptions.js

@@ -1,15 +1,17 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.getPackageInfosWithOptions = getPackageInfosWithOptions;
-const getCliOptions_1 = require("./getCliOptions");
 const env_1 = require("../env");
 const PackageInfo_1 = require("../types/PackageInfo");
+/**
+ * Fill in options to convert `workspace-tools` `PackageInfos` to the format used in this repo,
+ * including any package-specific options merged with CLI overrides.
+ * @param cliOptions Parsed CLI options. Can be null in tests to indicate no CLI options.
+ * @param enableCombinedOptionsForTests For testing only: usually in tests, the combinedOptions
+ * getter is not added to prevent jest exceptions when checking equality of objects.
+ * Use this to force adding the getter for testing its behavior.
+ */
 function getPackageInfosWithOptions(wsPackageInfos, cliOptions, enableCombinedOptionsForTests) {
-    if (cliOptions === undefined) {
-        // Don't use options from process.argv or the beachball repo in tests
-        // eslint-disable-next-line @ms-cloudpack/no-deprecated
-        cliOptions = env_1.env.isJest ? null : (0, getCliOptions_1.getCliOptions)(process.argv);
-    }
     const packageInfos = {};
     for (const packageJson of wsPackageInfos) {
         const newPackageInfo = {

package/lib/options/getPackageInfosWithOptions.js.map

@@ -1 +1 @@
-{"version":3,"file":"getPackageInfosWithOptions.js","sourceRoot":"","sources":["../../src/options/getPackageInfosWithOptions.ts"],"names":[],"mappings":";;AAqBA,gEA8CC;AAjED,mDAAgD;AAChD,gCAA6B;AAC7B,sDAAmG;AAiBnG,SAAgB,0BAA0B,CACxC,cAA+B,EAC/B,UAAuC,EACvC,6BAAuC;IAEvC,IAAI,UAAU,KAAK,SAAS,EAAE,CAAC;QAC7B,qEAAqE;QACrE,uDAAuD;QACvD,UAAU,GAAG,SAAG,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAA,6BAAa,EAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IAC/D,CAAC;IAED,MAAM,YAAY,GAAiB,EAAE,CAAC;IAEtC,KAAK,MAAM,WAAW,IAAI,cAAc,EAAE,CAAC;QACzC,MAAM,cAAc,GAAgB;YAClC,IAAI,EAAE,WAAW,CAAC,IAAI;YACtB,OAAO,EAAE,WAAW,CAAC,OAAO;YAC5B,eAAe,EAAE,WAAW,CAAC,eAAe;SAC7C,CAAC;QACF,WAAW,CAAC,OAAO,KAAK,IAAI,IAAI,CAAC,cAAc,CAAC,OAAO,GAAG,IAAI,CAAC,CAAC;QAEhE,wFAAwF;QACxF,KAAK,MAAM,OAAO,IAAI,oCAAsB,EAAE,CAAC;YAC7C,MAAM,IAAI,GAAG,WAAW,CAAC,OAAO,CAAC,CAAC;YAClC,IAAI,IAAI,CAAC,cAAc,CAAC,OAAO,CAAC,GAAG,IAAI,CAAC,CAAC;QAC3C,CAAC;QAED,IAAI,CAAC,SAAG,CAAC,MAAM,IAAI,6BAA6B,EAAE,CAAC;YACjD,wGAAwG;YACxG,MAAM,CAAC,cAAc,CAAC,cAAc,EAAE,iBAAiB,EAAE;gBACvD,UAAU,EAAE,KAAK;gBACjB,YAAY,EAAE,KAAK;gBACnB,GAAG,EAAE,yBAAyB;aAC/B,CAAC,CAAC;QACL,CAAC;QAED,gFAAgF;QAChF,uCAAuC;QACvC,yFAAyF;QACzF,MAAM,cAAc,GAAG,mBAAmB,CAAC,WAAW,CAAC,SAAuC,EAAE,UAAU,CAAC,CAAC;QAC5G,cAAc,IAAI,CAAC,cAAc,CAAC,cAAc,GAAG,cAAc,CAAC,CAAC;QAEnE,YAAY,CAAC,WAAW,CAAC,IAAI,CAAC,GAAG,cAAc,CAAC;IAClD,CAAC;IAED,OAAO,YAAY,CAAC;AACtB,CAAC;AAED,MAAM,WAAW,GAAG,MAAM,CAAC,IAAI,CAAC;IAC9B,GAAG,EAAE,IAAI;IACT,aAAa,EAAE,IAAI;IACnB,qBAAqB,EAAE,IAAI;IAC3B,OAAO,EAAE,IAAI;IACb,aAAa,EAAE,IAAI;CACyB,CAA6B,CAAC;AAE5E;;;GAGG;AACH,SAAS,mBAAmB,CAC1B,cAA0C,EAC1C,UAAsC;IAEtC,IAAI,CAAC,cAAc;QAAE,OAAO,SAAS,CAAC;IAEtC,MAAM,aAAa,GAAG,EAAoB,CAAC;IAC3C,IAAI,UAAU,GAAG,KAAK,CAAC;IACvB,KAAK,MAAM,GAAG,IAAI,WAAW,EAAE,CAAC;QAC9B,0EAA0E;QAC1E,qDAAqD;QACrD,IAAI,cAAc,CAAC,GAAG,CAAC,KAAK,SAAS,EAAE,CAAC;YACtC,iEAAiE;YACjE,yEAAyE;YACzE,2BAA2B;YAC1B,aAAqB,CAAC,GAAG,CAAC,GAAI,UAAkB,EAAE,CAAC,GAAG,CAAC,IAAI,cAAc,CAAC,GAAG,CAAC,CAAC;YAChF,UAAU,GAAG,IAAI,CAAC;QACpB,CAAC;IACH,CAAC;IACD,OAAO,UAAU,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,SAAS,CAAC;AAChD,CAAC;AAED;;;GAGG;AACH,SAAS,yBAAyB;IAChC,MAAM,IAAI,KAAK,CACb,uEAAuE;QACrE,gFAAgF,CACnF,CAAC;AACJ,CAAC"}
+{"version":3,"file":"getPackageInfosWithOptions.js","sourceRoot":"","sources":["../../src/options/getPackageInfosWithOptions.ts"],"names":[],"mappings":";;AAaA,gEAwCC;AAnDD,gCAA6B;AAC7B,sDAAmG;AAEnG;;;;;;;GAOG;AACH,SAAgB,0BAA0B,CACxC,cAA+B,EAC/B,UAAsC,EACtC,6BAAuC;IAEvC,MAAM,YAAY,GAAiB,EAAE,CAAC;IAEtC,KAAK,MAAM,WAAW,IAAI,cAAc,EAAE,CAAC;QACzC,MAAM,cAAc,GAAgB;YAClC,IAAI,EAAE,WAAW,CAAC,IAAI;YACtB,OAAO,EAAE,WAAW,CAAC,OAAO;YAC5B,eAAe,EAAE,WAAW,CAAC,eAAe;SAC7C,CAAC;QACF,WAAW,CAAC,OAAO,KAAK,IAAI,IAAI,CAAC,cAAc,CAAC,OAAO,GAAG,IAAI,CAAC,CAAC;QAEhE,wFAAwF;QACxF,KAAK,MAAM,OAAO,IAAI,oCAAsB,EAAE,CAAC;YAC7C,MAAM,IAAI,GAAG,WAAW,CAAC,OAAO,CAAC,CAAC;YAClC,IAAI,IAAI,CAAC,cAAc,CAAC,OAAO,CAAC,GAAG,IAAI,CAAC,CAAC;QAC3C,CAAC;QAED,IAAI,CAAC,SAAG,CAAC,MAAM,IAAI,6BAA6B,EAAE,CAAC;YACjD,wGAAwG;YACxG,MAAM,CAAC,cAAc,CAAC,cAAc,EAAE,iBAAiB,EAAE;gBACvD,UAAU,EAAE,KAAK;gBACjB,YAAY,EAAE,KAAK;gBACnB,GAAG,EAAE,yBAAyB;aAC/B,CAAC,CAAC;QACL,CAAC;QAED,gFAAgF;QAChF,uCAAuC;QACvC,yFAAyF;QACzF,MAAM,cAAc,GAAG,mBAAmB,CAAC,WAAW,CAAC,SAAuC,EAAE,UAAU,CAAC,CAAC;QAC5G,cAAc,IAAI,CAAC,cAAc,CAAC,cAAc,GAAG,cAAc,CAAC,CAAC;QAEnE,YAAY,CAAC,WAAW,CAAC,IAAI,CAAC,GAAG,cAAc,CAAC;IAClD,CAAC;IAED,OAAO,YAAY,CAAC;AACtB,CAAC;AAED,MAAM,WAAW,GAAG,MAAM,CAAC,IAAI,CAAC;IAC9B,GAAG,EAAE,IAAI;IACT,aAAa,EAAE,IAAI;IACnB,qBAAqB,EAAE,IAAI;IAC3B,OAAO,EAAE,IAAI;IACb,aAAa,EAAE,IAAI;CACyB,CAA6B,CAAC;AAE5E;;;GAGG;AACH,SAAS,mBAAmB,CAC1B,cAA0C,EAC1C,UAAsC;IAEtC,IAAI,CAAC,cAAc;QAAE,OAAO,SAAS,CAAC;IAEtC,MAAM,aAAa,GAAG,EAAoB,CAAC;IAC3C,IAAI,UAAU,GAAG,KAAK,CAAC;IACvB,KAAK,MAAM,GAAG,IAAI,WAAW,EAAE,CAAC;QAC9B,0EAA0E;QAC1E,qDAAqD;QACrD,IAAI,cAAc,CAAC,GAAG,CAAC,KAAK,SAAS,EAAE,CAAC;YACtC,iEAAiE;YACjE,yEAAyE;YACzE,2BAA2B;YAC1B,aAAqB,CAAC,GAAG,CAAC,GAAI,UAAkB,EAAE,CAAC,GAAG,CAAC,IAAI,cAAc,CAAC,GAAG,CAAC,CAAC;YAChF,UAAU,GAAG,IAAI,CAAC;QACpB,CAAC;IACH,CAAC;IACD,OAAO,UAAU,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,SAAS,CAAC;AAChD,CAAC;AAED;;;GAGG;AACH,SAAS,yBAAyB;IAChC,MAAM,IAAI,KAAK,CACb,uEAAuE;QACrE,gFAAgF,CACnF,CAAC;AACJ,CAAC"}

package/lib/options/optionDefinitions.d.ts

@@ -0,0 +1,67 @@
+import type { CliOptions } from '../types/BeachballOptions';
+import type { CommandName } from './commandDefinitions';
+export type OptionDefinitions = Partial<Record<keyof CliOptions, OptionDefinition>>;
+export type OptionType = 'string' | 'number' | 'boolean' | 'array';
+/**
+ * Help group names for options (pass to `option.helpGroup()`).
+ * The order of keys determines section order in help output.
+ */
+export declare const optionGroups: {
+    /** Primary options for a command (membership is command-specific) */
+    primary: string;
+    /** Git options for detecting which packages changed */
+    detection: string;
+    /** Options for filtering/selecting which packages to operate on */
+    filtering: string;
+    /** Options controlling change file validation */
+    validation: string;
+    /** Options controlling how versions are bumped */
+    versioning: string;
+    npm: string;
+    /** Less commonly used options */
+    advanced: string;
+    /** Non-logging options shared between all/most commands */
+    common: string;
+};
+export type OptionGroup = keyof typeof optionGroups;
+/** Definition of a single CLI option, used to build its commander `Option`. */
+export interface OptionDefinition {
+    /** Option description for help */
+    desc: string | ((subcommand: string | undefined) => string);
+    /** Help group for the option (single or command-specific). */
+    group: OptionGroup | ((subcommand: string | undefined) => OptionGroup);
+    /**
+     * Only show the option in help for the specified commands.
+     * Use `defaultCommands` for options that apply to all the "full" commands.
+     */
+    commands: readonly CommandName[] | ((subcommand: string | undefined) => boolean);
+    /**  Single-character short flag (without dash), e.g. `b` for `--branch`. */
+    short?: string;
+    /**
+     * Extra long-flag alias (without dashes), e.g. `config` for the `configPath` option. When set,
+     * the alias is shown in help *instead of* the canonical dashed name, but the value is still
+     * stored under the canonical name, and the canonical name is also accepted as a CLI option.
+     */
+    alias?: string;
+    /**
+     * Value type. `'array'` is currently always a string array.
+     * `'boolean'` values get a negated `--no-` form automatically when added via `BeachballCommand`.
+     * @default 'string'
+     */
+    type?: OptionType;
+    /** Valid choices, such as for `disallowedChangeTypes` (string or array options only). */
+    choices?: readonly string[];
+    /** Conflicting option names */
+    conflicts?: readonly (keyof CliOptions)[];
+    /** Custom argument parser/validator */
+    parse?: (value: unknown, previous: unknown) => unknown;
+}
+type OptionNoCommands = Omit<OptionDefinition, 'commands'> & Partial<OptionDefinition>;
+type OptionNoCommandsGroup = Omit<OptionDefinition, 'commands' | 'group'> & Partial<OptionDefinition>;
+/** Add `group` and/or `commands` to a subset of options */
+export declare function makeOptions<K extends keyof CliOptions>(group: OptionGroup, commands: OptionDefinition['commands'], opts: Record<K, OptionNoCommandsGroup>): Record<K, OptionDefinition>;
+export declare function makeOptions<K extends keyof CliOptions>(commands: OptionDefinition['commands'], opts: Record<K, OptionNoCommands>): Record<K, OptionDefinition>;
+/** All CLI options. */
+export declare const optionDefinitions: Record<Exclude<keyof CliOptions, 'path' | 'command' | '_extraPositionalArgs'>, OptionDefinition>;
+export {};
+//# sourceMappingURL=optionDefinitions.d.ts.map

package/lib/options/optionDefinitions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"optionDefinitions.d.ts","sourceRoot":"","sources":["../../src/options/optionDefinitions.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAC;AAE5D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAExD,MAAM,MAAM,iBAAiB,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,UAAU,EAAE,gBAAgB,CAAC,CAAC,CAAC;AAEpF,MAAM,MAAM,UAAU,GAAG,QAAQ,GAAG,QAAQ,GAAG,SAAS,GAAG,OAAO,CAAC;AAEnE;;;GAGG;AACH,eAAO,MAAM,YAAY;IACvB,qEAAqE;;IAErE,uDAAuD;;IAEvD,mEAAmE;;IAEnE,iDAAiD;;IAEjD,kDAAkD;;;IAGlD,iCAAiC;;IAEjC,2DAA2D;;CAE5D,CAAC;AACF,MAAM,MAAM,WAAW,GAAG,MAAM,OAAO,YAAY,CAAC;AAEpD,+EAA+E;AAC/E,MAAM,WAAW,gBAAgB;IAC/B,kCAAkC;IAClC,IAAI,EAAE,MAAM,GAAG,CAAC,CAAC,UAAU,EAAE,MAAM,GAAG,SAAS,KAAK,MAAM,CAAC,CAAC;IAE5D,8DAA8D;IAC9D,KAAK,EAAE,WAAW,GAAG,CAAC,CAAC,UAAU,EAAE,MAAM,GAAG,SAAS,KAAK,WAAW,CAAC,CAAC;IAEvE;;;OAGG;IACH,QAAQ,EAAE,SAAS,WAAW,EAAE,GAAG,CAAC,CAAC,UAAU,EAAE,MAAM,GAAG,SAAS,KAAK,OAAO,CAAC,CAAC;IAEjF,4EAA4E;IAC5E,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;;;;OAIG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;;;;OAIG;IACH,IAAI,CAAC,EAAE,UAAU,CAAC;IAClB,yFAAyF;IACzF,OAAO,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC5B,+BAA+B;IAC/B,SAAS,CAAC,EAAE,SAAS,CAAC,MAAM,UAAU,CAAC,EAAE,CAAC;IAC1C,uCAAuC;IACvC,KAAK,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,OAAO,KAAK,OAAO,CAAC;CACxD;AAED,KAAK,gBAAgB,GAAG,IAAI,CAAC,gBAAgB,EAAE,UAAU,CAAC,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAAC;AACvF,KAAK,qBAAqB,GAAG,IAAI,CAAC,gBAAgB,EAAE,UAAU,GAAG,OAAO,CAAC,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAAC;AAEtG,2DAA2D;AAC3D,wBAAgB,WAAW,CAAC,CAAC,SAAS,MAAM,UAAU,EACpD,KAAK,EAAE,WAAW,EAClB,QAAQ,EAAE,gBAAgB,CAAC,UAAU,CAAC,EACtC,IAAI,EAAE,MAAM,CAAC,CAAC,EAAE,qBAAqB,CAAC,GACrC,MAAM,CAAC,CAAC,EAAE,gBAAgB,CAAC,CAAC;AAC/B,wBAAgB,WAAW,CAAC,CAAC,SAAS,MAAM,UAAU,EACpD,QAAQ,EAAE,gBAAgB,CAAC,UAAU,CAAC,EACtC,IAAI,EAAE,MAAM,CAAC,CAAC,EAAE,gBAAgB,CAAC,GAChC,MAAM,CAAC,CAAC,EAAE,gBAAgB,CAAC,CAAC;AAqB/B,uBAAuB;AACvB,eAAO,MAAM,iBAAiB,EAAE,MAAM,CACpC,OAAO,CAAC,MAAM,UAAU,EAAE,MAAM,GAAG,SAAS,GAAG,sBAAsB,CAAC,EACtE,gBAAgB,CAoLjB,CAAC"}