@depup/angular__cli 21.2.1-depup.1

package/src/command-builder/schematics-command-module.js

@@ -0,0 +1,408 @@
+"use strict";
+/**
+ * @license
+ * Copyright Google LLC All Rights Reserved.
+ *
+ * Use of this source code is governed by an MIT-style license that can be
+ * found in the LICENSE file at https://angular.dev/license
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __runInitializers = (this && this.__runInitializers) || function (thisArg, initializers, value) {
+    var useValue = arguments.length > 2;
+    for (var i = 0; i < initializers.length; i++) {
+        value = useValue ? initializers[i].call(thisArg, value) : initializers[i].call(thisArg);
+    }
+    return useValue ? value : void 0;
+};
+var __esDecorate = (this && this.__esDecorate) || function (ctor, descriptorIn, decorators, contextIn, initializers, extraInitializers) {
+    function accept(f) { if (f !== void 0 && typeof f !== "function") throw new TypeError("Function expected"); return f; }
+    var kind = contextIn.kind, key = kind === "getter" ? "get" : kind === "setter" ? "set" : "value";
+    var target = !descriptorIn && ctor ? contextIn["static"] ? ctor : ctor.prototype : null;
+    var descriptor = descriptorIn || (target ? Object.getOwnPropertyDescriptor(target, contextIn.name) : {});
+    var _, done = false;
+    for (var i = decorators.length - 1; i >= 0; i--) {
+        var context = {};
+        for (var p in contextIn) context[p] = p === "access" ? {} : contextIn[p];
+        for (var p in contextIn.access) context.access[p] = contextIn.access[p];
+        context.addInitializer = function (f) { if (done) throw new TypeError("Cannot add initializers after decoration has completed"); extraInitializers.push(accept(f || null)); };
+        var result = (0, decorators[i])(kind === "accessor" ? { get: descriptor.get, set: descriptor.set } : descriptor[key], context);
+        if (kind === "accessor") {
+            if (result === void 0) continue;
+            if (result === null || typeof result !== "object") throw new TypeError("Object expected");
+            if (_ = accept(result.get)) descriptor.get = _;
+            if (_ = accept(result.set)) descriptor.set = _;
+            if (_ = accept(result.init)) initializers.unshift(_);
+        }
+        else if (_ = accept(result)) {
+            if (kind === "field") initializers.unshift(_);
+            else descriptor[key] = _;
+        }
+    }
+    if (target) Object.defineProperty(target, contextIn.name, descriptor);
+    done = true;
+};
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SchematicsCommandModule = exports.DEFAULT_SCHEMATICS_COLLECTION = void 0;
+const core_1 = require("@angular-devkit/core");
+const schematics_1 = require("@angular-devkit/schematics");
+const tools_1 = require("@angular-devkit/schematics/tools");
+const node_path_1 = require("node:path");
+const analytics_1 = require("../analytics/analytics");
+const analytics_parameters_1 = require("../analytics/analytics-parameters");
+const config_1 = require("../utilities/config");
+const error_1 = require("../utilities/error");
+const memoize_1 = require("../utilities/memoize");
+const prettier_1 = require("../utilities/prettier");
+const tty_1 = require("../utilities/tty");
+const command_module_1 = require("./command-module");
+const json_schema_1 = require("./utilities/json-schema");
+const schematic_engine_host_1 = require("./utilities/schematic-engine-host");
+const schematic_workflow_1 = require("./utilities/schematic-workflow");
+exports.DEFAULT_SCHEMATICS_COLLECTION = '@schematics/angular';
+let SchematicsCommandModule = (() => {
+    let _classSuper = command_module_1.CommandModule;
+    let _instanceExtraInitializers = [];
+    let _getOrCreateWorkflowForBuilder_decorators;
+    let _getOrCreateWorkflowForExecution_decorators;
+    let _getSchematicCollections_decorators;
+    return class SchematicsCommandModule extends _classSuper {
+        static {
+            const _metadata = typeof Symbol === "function" && Symbol.metadata ? Object.create(_classSuper[Symbol.metadata] ?? null) : void 0;
+            _getOrCreateWorkflowForBuilder_decorators = [memoize_1.memoize];
+            _getOrCreateWorkflowForExecution_decorators = [memoize_1.memoize];
+            _getSchematicCollections_decorators = [memoize_1.memoize];
+            __esDecorate(this, null, _getOrCreateWorkflowForBuilder_decorators, { kind: "method", name: "getOrCreateWorkflowForBuilder", static: false, private: false, access: { has: obj => "getOrCreateWorkflowForBuilder" in obj, get: obj => obj.getOrCreateWorkflowForBuilder }, metadata: _metadata }, null, _instanceExtraInitializers);
+            __esDecorate(this, null, _getOrCreateWorkflowForExecution_decorators, { kind: "method", name: "getOrCreateWorkflowForExecution", static: false, private: false, access: { has: obj => "getOrCreateWorkflowForExecution" in obj, get: obj => obj.getOrCreateWorkflowForExecution }, metadata: _metadata }, null, _instanceExtraInitializers);
+            __esDecorate(this, null, _getSchematicCollections_decorators, { kind: "method", name: "getSchematicCollections", static: false, private: false, access: { has: obj => "getSchematicCollections" in obj, get: obj => obj.getSchematicCollections }, metadata: _metadata }, null, _instanceExtraInitializers);
+            if (_metadata) Object.defineProperty(this, Symbol.metadata, { enumerable: true, configurable: true, writable: true, value: _metadata });
+        }
+        scope = (__runInitializers(this, _instanceExtraInitializers), command_module_1.CommandScope.In);
+        allowPrivateSchematics = false;
+        async builder(argv) {
+            return argv
+                .option('interactive', {
+                describe: 'Enable interactive input prompts.',
+                type: 'boolean',
+                default: true,
+            })
+                .option('dry-run', {
+                describe: 'Run through and reports activity without writing out results.',
+                type: 'boolean',
+                alias: ['d'],
+                default: false,
+            })
+                .option('defaults', {
+                describe: 'Disable interactive input prompts for options with a default.',
+                type: 'boolean',
+                default: false,
+            })
+                .option('force', {
+                describe: 'Force overwriting of existing files.',
+                type: 'boolean',
+                default: false,
+            })
+                .strict();
+        }
+        /** Get schematic schema options.*/
+        async getSchematicOptions(collection, schematicName, workflow) {
+            const schematic = collection.createSchematic(schematicName, true);
+            const { schemaJson } = schematic.description;
+            if (!schemaJson) {
+                return [];
+            }
+            return (0, json_schema_1.parseJsonSchemaToOptions)(workflow.registry, schemaJson);
+        }
+        getOrCreateWorkflowForBuilder(collectionName) {
+            return new tools_1.NodeWorkflow(this.context.root, {
+                resolvePaths: this.getResolvePaths(collectionName),
+                engineHostCreator: (options) => new schematic_engine_host_1.SchematicEngineHost(options.resolvePaths),
+            });
+        }
+        async getOrCreateWorkflowForExecution(collectionName, options) {
+            const { logger, root, packageManager } = this.context;
+            const { force, dryRun, packageRegistry } = options;
+            const workflow = new tools_1.NodeWorkflow(root, {
+                force,
+                dryRun,
+                packageManager: packageManager.name,
+                // A schema registry is required to allow customizing addUndefinedDefaults
+                registry: new core_1.schema.CoreSchemaRegistry(schematics_1.formats.standardFormats),
+                packageRegistry,
+                resolvePaths: this.getResolvePaths(collectionName),
+                schemaValidation: true,
+                optionTransforms: [
+                    // Add configuration file defaults
+                    async (schematic, current) => {
+                        const projectName = typeof current?.project === 'string' ? current.project : this.getProjectName();
+                        return {
+                            ...(await (0, config_1.getSchematicDefaults)(schematic.collection.name, schematic.name, projectName)),
+                            ...current,
+                        };
+                    },
+                ],
+                engineHostCreator: (options) => new schematic_engine_host_1.SchematicEngineHost(options.resolvePaths),
+            });
+            workflow.registry.addPostTransform(core_1.schema.transforms.addUndefinedDefaults);
+            workflow.registry.useXDeprecatedProvider((msg) => logger.warn(msg));
+            workflow.registry.addSmartDefaultProvider('projectName', () => this.getProjectName());
+            const workingDir = (0, core_1.normalize)((0, node_path_1.relative)(this.context.root, process.cwd()));
+            workflow.registry.addSmartDefaultProvider('workingDirectory', () => workingDir === '' ? undefined : workingDir);
+            workflow.engineHost.registerOptionsTransform(async (schematic, options) => {
+                const { collection: { name: collectionName }, name: schematicName, } = schematic;
+                const analytics = (0, analytics_1.isPackageNameSafeForAnalytics)(collectionName)
+                    ? await this.getAnalytics()
+                    : undefined;
+                analytics?.reportSchematicRunEvent({
+                    [analytics_parameters_1.EventCustomDimension.SchematicCollectionName]: collectionName,
+                    [analytics_parameters_1.EventCustomDimension.SchematicName]: schematicName,
+                    ...this.getAnalyticsParameters(options),
+                });
+                return options;
+            });
+            if (options.interactive !== false && (0, tty_1.isTTY)()) {
+                workflow.registry.usePromptProvider(async (definitions) => {
+                    let prompts;
+                    const answers = {};
+                    for (const definition of definitions) {
+                        if (options.defaults && definition.default !== undefined) {
+                            continue;
+                        }
+                        // Only load prompt package if needed
+                        prompts ??= await Promise.resolve().then(() => __importStar(require('@inquirer/prompts')));
+                        switch (definition.type) {
+                            case 'confirmation':
+                                answers[definition.id] = await prompts.confirm({
+                                    message: definition.message,
+                                    default: definition.default,
+                                });
+                                break;
+                            case 'list':
+                                if (!definition.items?.length) {
+                                    continue;
+                                }
+                                answers[definition.id] = await (definition.multiselect ? prompts.checkbox : prompts.select)({
+                                    message: definition.message,
+                                    validate: (values) => {
+                                        if (!definition.validator) {
+                                            return true;
+                                        }
+                                        return definition.validator(Object.values(values).map(({ value }) => value));
+                                    },
+                                    default: definition.multiselect ? undefined : definition.default,
+                                    choices: definition.items?.map((item) => typeof item == 'string'
+                                        ? {
+                                            name: item,
+                                            value: item,
+                                            checked: definition.multiselect && Array.isArray(definition.default)
+                                                ? definition.default?.includes(item)
+                                                : item === definition.default,
+                                        }
+                                        : {
+                                            ...item,
+                                            name: item.label,
+                                            value: item.value,
+                                            checked: definition.multiselect && Array.isArray(definition.default)
+                                                ? // eslint-disable-next-line @typescript-eslint/no-explicit-any
+                                                    definition.default?.includes(item.value)
+                                                : item.value === definition.default,
+                                        }),
+                                });
+                                break;
+                            case 'input': {
+                                let finalValue;
+                                answers[definition.id] = await prompts.input({
+                                    message: definition.message,
+                                    default: definition.default,
+                                    async validate(value) {
+                                        if (definition.validator === undefined) {
+                                            return true;
+                                        }
+                                        let lastValidation = false;
+                                        for (const type of definition.propertyTypes) {
+                                            let potential;
+                                            switch (type) {
+                                                case 'string':
+                                                    potential = String(value);
+                                                    break;
+                                                case 'integer':
+                                                case 'number':
+                                                    potential = Number(value);
+                                                    break;
+                                                default:
+                                                    potential = value;
+                                                    break;
+                                            }
+                                            lastValidation = await definition.validator(potential);
+                                            // Can be a string if validation fails
+                                            if (lastValidation === true) {
+                                                finalValue = potential;
+                                                return true;
+                                            }
+                                        }
+                                        return lastValidation;
+                                    },
+                                });
+                                // Use validated value if present.
+                                // This ensures the correct type is inserted into the final schema options.
+                                if (finalValue !== undefined) {
+                                    answers[definition.id] = finalValue;
+                                }
+                                break;
+                            }
+                        }
+                    }
+                    return answers;
+                });
+            }
+            return workflow;
+        }
+        async getSchematicCollections() {
+            const getSchematicCollections = (configSection) => {
+                if (!configSection) {
+                    return undefined;
+                }
+                const { schematicCollections } = configSection;
+                if (Array.isArray(schematicCollections)) {
+                    return new Set(schematicCollections);
+                }
+                return undefined;
+            };
+            const { workspace, globalConfiguration } = this.context;
+            if (workspace) {
+                const project = (0, config_1.getProjectByCwd)(workspace);
+                if (project) {
+                    const value = getSchematicCollections(workspace.getProjectCli(project));
+                    if (value) {
+                        return value;
+                    }
+                }
+            }
+            const value = getSchematicCollections(workspace?.getCli()) ??
+                getSchematicCollections(globalConfiguration.getCli());
+            if (value) {
+                return value;
+            }
+            return new Set([exports.DEFAULT_SCHEMATICS_COLLECTION]);
+        }
+        parseSchematicInfo(schematic) {
+            if (schematic?.includes(':')) {
+                const [collectionName, schematicName] = schematic.split(':', 2);
+                return [collectionName, schematicName];
+            }
+            return [undefined, schematic];
+        }
+        async runSchematic(options) {
+            const { logger } = this.context;
+            const { schematicOptions, executionOptions, collectionName, schematicName } = options;
+            const workflow = await this.getOrCreateWorkflowForExecution(collectionName, executionOptions);
+            if (!schematicName) {
+                throw new Error('schematicName cannot be undefined.');
+            }
+            const { unsubscribe, files } = (0, schematic_workflow_1.subscribeToWorkflow)(workflow, logger);
+            try {
+                await workflow
+                    .execute({
+                    collection: collectionName,
+                    schematic: schematicName,
+                    options: schematicOptions,
+                    logger,
+                    allowPrivate: this.allowPrivateSchematics,
+                })
+                    .toPromise();
+                if (!files.size) {
+                    logger.info('Nothing to be done.');
+                }
+                if (executionOptions.dryRun) {
+                    logger.warn(`\nNOTE: The "--dry-run" option means no changes were made.`);
+                    return 0;
+                }
+                if (files.size) {
+                    // Note: we could use a task executor to format the files but this is simpler.
+                    try {
+                        await (0, prettier_1.formatFiles)(this.context.root, files);
+                    }
+                    catch (error) {
+                        (0, error_1.assertIsError)(error);
+                        logger.warn(`WARNING: Formatting of files failed with the following error: ${error.message}`);
+                    }
+                }
+                return 0;
+            }
+            catch (err) {
+                // In case the workflow was not successful, show an appropriate error message.
+                if (err instanceof schematics_1.UnsuccessfulWorkflowExecution) {
+                    // "See above" because we already printed the error.
+                    logger.fatal('The Schematic workflow failed. See above.');
+                }
+                else {
+                    (0, error_1.assertIsError)(err);
+                    logger.fatal(err.message);
+                }
+                return 1;
+            }
+            finally {
+                unsubscribe();
+            }
+        }
+        getProjectName() {
+            const { workspace } = this.context;
+            if (!workspace) {
+                return undefined;
+            }
+            const projectName = (0, config_1.getProjectByCwd)(workspace);
+            if (projectName) {
+                return projectName;
+            }
+            return undefined;
+        }
+        getResolvePaths(collectionName) {
+            const { workspace, root } = this.context;
+            if (collectionName[0] === '.') {
+                // Resolve relative collections from the location of `angular.json`
+                return [root];
+            }
+            return workspace
+                ? // Workspace
+                    collectionName === exports.DEFAULT_SCHEMATICS_COLLECTION
+                        ? // Favor __dirname for @schematics/angular to use the build-in version
+                            [__dirname, process.cwd(), root]
+                        : [process.cwd(), root, __dirname]
+                : // Global
+                    [__dirname, process.cwd()];
+        }
+    };
+})();
+exports.SchematicsCommandModule = SchematicsCommandModule;
+//# sourceMappingURL=schematics-command-module.js.map

package/src/command-builder/schematics-command-module.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schematics-command-module.js","sourceRoot":"","sources":["schematics-command-module.ts"],"names":[],"mappings":"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"}

package/src/command-builder/utilities/command.d.ts

@@ -0,0 +1,13 @@
+/**
+ * @license
+ * Copyright Google LLC All Rights Reserved.
+ *
+ * Use of this source code is governed by an MIT-style license that can be
+ * found in the LICENSE file at https://angular.dev/license
+ */
+import { CommandContext, CommandModule, CommandModuleImplementation } from '../command-module';
+export declare const demandCommandFailureMessage = "You need to specify a command before moving on. Use '--help' to view the available commands.";
+export type CommandModuleConstructor = Partial<CommandModuleImplementation> & {
+    new (context: CommandContext): Partial<CommandModuleImplementation> & CommandModule;
+};
+export declare function addCommandModuleToYargs<U extends CommandModuleConstructor>(commandModule: U, context: CommandContext): void;

package/src/command-builder/utilities/command.js

@@ -0,0 +1,39 @@
+"use strict";
+/**
+ * @license
+ * Copyright Google LLC All Rights Reserved.
+ *
+ * Use of this source code is governed by an MIT-style license that can be
+ * found in the LICENSE file at https://angular.dev/license
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.demandCommandFailureMessage = void 0;
+exports.addCommandModuleToYargs = addCommandModuleToYargs;
+const command_module_1 = require("../command-module");
+exports.demandCommandFailureMessage = `You need to specify a command before moving on. Use '--help' to view the available commands.`;
+function addCommandModuleToYargs(commandModule, context) {
+    const cmd = new commandModule(context);
+    const { args: { options: { jsonHelp }, }, workspace, } = context;
+    const describe = jsonHelp ? cmd.fullDescribe : cmd.describe;
+    context.yargsInstance.command({
+        command: cmd.command,
+        aliases: cmd.aliases,
+        describe: 
+        // We cannot add custom fields in help, such as long command description which is used in AIO.
+        // Therefore, we get around this by adding a complex object as a string which we later parse when generating the help files.
+        typeof describe === 'object' ? JSON.stringify(describe) : describe,
+        deprecated: cmd.deprecated,
+        builder: (argv) => {
+            // Skip scope validation when running with '--json-help' since it's easier to generate the output for all commands this way.
+            const isInvalidScope = !jsonHelp &&
+                ((cmd.scope === command_module_1.CommandScope.In && !workspace) ||
+                    (cmd.scope === command_module_1.CommandScope.Out && workspace));
+            if (isInvalidScope) {
+                throw new command_module_1.CommandModuleError(`This command is not available when running the Angular CLI ${workspace ? 'inside' : 'outside'} a workspace.`);
+            }
+            return cmd.builder(argv);
+        },
+        handler: (args) => cmd.handler(args),
+    });
+}
+//# sourceMappingURL=command.js.map

package/src/command-builder/utilities/command.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"command.js","sourceRoot":"","sources":["command.ts"],"names":[],"mappings":";AAAA;;;;;;GAMG;;;AAgBH,0DAyCC;AAtDD,sDAM2B;AAEd,QAAA,2BAA2B,GAAG,8FAA8F,CAAC;AAK1I,SAAgB,uBAAuB,CACrC,aAAgB,EAChB,OAAuB;IAEvB,MAAM,GAAG,GAAG,IAAI,aAAa,CAAC,OAAO,CAAC,CAAC;IACvC,MAAM,EACJ,IAAI,EAAE,EACJ,OAAO,EAAE,EAAE,QAAQ,EAAE,GACtB,EACD,SAAS,GACV,GAAG,OAAO,CAAC;IAEZ,MAAM,QAAQ,GAAG,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC,CAAC,GAAG,CAAC,QAAQ,CAAC;IAE5D,OAAO,CAAC,aAAa,CAAC,OAAO,CAAC;QAC5B,OAAO,EAAE,GAAG,CAAC,OAAO;QACpB,OAAO,EAAE,GAAG,CAAC,OAAO;QACpB,QAAQ;QACN,8FAA8F;QAC9F,4HAA4H;QAC5H,OAAO,QAAQ,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,QAAQ;QACpE,UAAU,EAAE,GAAG,CAAC,UAAU;QAC1B,OAAO,EAAE,CAAC,IAAI,EAAE,EAAE;YAChB,4HAA4H;YAC5H,MAAM,cAAc,GAClB,CAAC,QAAQ;gBACT,CAAC,CAAC,GAAG,CAAC,KAAK,KAAK,6BAAY,CAAC,EAAE,IAAI,CAAC,SAAS,CAAC;oBAC5C,CAAC,GAAG,CAAC,KAAK,KAAK,6BAAY,CAAC,GAAG,IAAI,SAAS,CAAC,CAAC,CAAC;YAEnD,IAAI,cAAc,EAAE,CAAC;gBACnB,MAAM,IAAI,mCAAkB,CAC1B,8DACE,SAAS,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,SACzB,eAAe,CAChB,CAAC;YACJ,CAAC;YAED,OAAO,GAAG,CAAC,OAAO,CAAC,IAAI,CAAS,CAAC;QACnC,CAAC;QACD,OAAO,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC;KACrC,CAAC,CAAC;AACL,CAAC"}

package/src/command-builder/utilities/json-help.d.ts

@@ -0,0 +1,37 @@
+/**
+ * @license
+ * Copyright Google LLC All Rights Reserved.
+ *
+ * Use of this source code is governed by an MIT-style license that can be
+ * found in the LICENSE file at https://angular.dev/license
+ */
+import { Argv } from 'yargs';
+interface JsonHelpOption {
+    name: string;
+    type?: string;
+    deprecated: boolean | string;
+    aliases?: string[];
+    default?: string;
+    required?: boolean;
+    positional?: number;
+    enum?: string[];
+    description?: string;
+}
+interface JsonHelpDescription {
+    shortDescription?: string;
+    longDescription?: string;
+    longDescriptionRelativePath?: string;
+}
+interface JsonHelpSubcommand extends JsonHelpDescription {
+    name: string;
+    aliases: string[];
+    deprecated: string | boolean;
+}
+export interface JsonHelp extends JsonHelpDescription {
+    name: string;
+    command: string;
+    options: JsonHelpOption[];
+    subcommands?: JsonHelpSubcommand[];
+}
+export declare function jsonHelpUsage(localYargs: Argv): string;
+export {};

package/src/command-builder/utilities/json-help.js

@@ -0,0 +1,92 @@
+"use strict";
+/**
+ * @license
+ * Copyright Google LLC All Rights Reserved.
+ *
+ * Use of this source code is governed by an MIT-style license that can be
+ * found in the LICENSE file at https://angular.dev/license
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.jsonHelpUsage = jsonHelpUsage;
+const yargsDefaultCommandRegExp = /^\$0|\*/;
+function jsonHelpUsage(localYargs) {
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    const localYargsInstance = localYargs;
+    const { deprecatedOptions, alias: aliases, array, string, boolean, number, choices, demandedOptions, default: defaultVal, hiddenOptions = [], } = localYargsInstance.getOptions();
+    const internalMethods = localYargsInstance.getInternalMethods();
+    const usageInstance = internalMethods.getUsageInstance();
+    const context = internalMethods.getContext();
+    const descriptions = usageInstance.getDescriptions();
+    const groups = localYargsInstance.getGroups();
+    const positional = groups[usageInstance.getPositionalGroupName()];
+    const seen = new Set();
+    const hidden = new Set(hiddenOptions);
+    const normalizeOptions = [];
+    const allAliases = new Set([...Object.values(aliases).flat()]);
+    // Reverted order of https://github.com/yargs/yargs/blob/971e351705f0fbc5566c6ed1dfd707fa65e11c0d/lib/usage.ts#L419-L424
+    for (const [names, type] of [
+        [number, 'number'],
+        [array, 'array'],
+        [string, 'string'],
+        [boolean, 'boolean'],
+    ]) {
+        for (const name of names) {
+            if (allAliases.has(name) || hidden.has(name) || seen.has(name)) {
+                // Ignore hidden, aliases and already visited option.
+                continue;
+            }
+            seen.add(name);
+            const positionalIndex = positional?.indexOf(name) ?? -1;
+            const alias = aliases[name];
+            normalizeOptions.push({
+                name,
+                type,
+                deprecated: deprecatedOptions[name],
+                aliases: alias?.length > 0 ? alias : undefined,
+                default: defaultVal[name],
+                required: demandedOptions[name],
+                enum: choices[name],
+                description: descriptions[name]?.replace('__yargsString__:', ''),
+                positional: positionalIndex >= 0 ? positionalIndex : undefined,
+            });
+        }
+    }
+    // https://github.com/yargs/yargs/blob/00e4ebbe3acd438e73fdb101e75b4f879eb6d345/lib/usage.ts#L124
+    const subcommands = usageInstance.getCommands()
+        .map(([name, rawDescription, isDefault, aliases, deprecated]) => ({
+        name: name.split(' ', 1)[0].replace(yargsDefaultCommandRegExp, ''),
+        command: name.replace(yargsDefaultCommandRegExp, ''),
+        default: isDefault || undefined,
+        ...parseDescription(rawDescription),
+        aliases,
+        deprecated,
+    }))
+        .sort((a, b) => a.name.localeCompare(b.name));
+    const [command, rawDescription] = usageInstance.getUsage()[0] ?? [];
+    const defaultSubCommand = subcommands.find((x) => x.default)?.command ?? '';
+    const otherSubcommands = subcommands.filter((s) => !s.default);
+    const output = {
+        name: [...context.commands].pop(),
+        command: `${command?.replace(yargsDefaultCommandRegExp, localYargsInstance['$0'])}${defaultSubCommand}`,
+        ...parseDescription(rawDescription),
+        options: normalizeOptions.sort((a, b) => a.name.localeCompare(b.name)),
+        subcommands: otherSubcommands.length ? otherSubcommands : undefined,
+    };
+    return JSON.stringify(output, undefined, 2);
+}
+function parseDescription(rawDescription) {
+    try {
+        const { longDescription, describe: shortDescription, longDescriptionRelativePath, } = JSON.parse(rawDescription);
+        return {
+            shortDescription,
+            longDescriptionRelativePath,
+            longDescription,
+        };
+    }
+    catch {
+        return {
+            shortDescription: rawDescription,
+        };
+    }
+}
+//# sourceMappingURL=json-help.js.map

package/src/command-builder/utilities/json-help.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"json-help.js","sourceRoot":"","sources":["json-help.ts"],"names":[],"mappings":"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"}