@depup/angular__cli 21.2.1-depup.1

package/src/command-builder/architect-base-command-module.js

@@ -0,0 +1,244 @@
+"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 __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.ArchitectBaseCommandModule = void 0;
+const architect_1 = require("@angular-devkit/architect");
+const node_1 = require("@angular-devkit/architect/node");
+const core_1 = require("@angular-devkit/core");
+const node_module_1 = require("node:module");
+const analytics_1 = require("../analytics/analytics");
+const analytics_parameters_1 = require("../analytics/analytics-parameters");
+const error_1 = require("../utilities/error");
+const prompt_1 = require("../utilities/prompt");
+const tty_1 = require("../utilities/tty");
+const command_module_1 = require("./command-module");
+const json_schema_1 = require("./utilities/json-schema");
+class ArchitectBaseCommandModule extends command_module_1.CommandModule {
+    scope = command_module_1.CommandScope.In;
+    missingTargetChoices;
+    async runSingleTarget(target, options) {
+        const architectHost = this.getArchitectHost();
+        let builderName;
+        try {
+            builderName = await architectHost.getBuilderNameForTarget(target);
+        }
+        catch (e) {
+            (0, error_1.assertIsError)(e);
+            return this.onMissingTarget(e.message);
+        }
+        const isAngularBuild = builderName.startsWith('@angular/build:');
+        const { logger } = this.context;
+        const run = await this.getArchitect(isAngularBuild).scheduleTarget(target, options, {
+            logger,
+        });
+        const analytics = (0, analytics_1.isPackageNameSafeForAnalytics)(builderName)
+            ? await this.getAnalytics()
+            : undefined;
+        let outputSubscription;
+        if (analytics) {
+            analytics.reportArchitectRunEvent({
+                [analytics_parameters_1.EventCustomDimension.BuilderTarget]: builderName,
+            });
+            let firstRun = true;
+            outputSubscription = run.output.subscribe(({ stats }) => {
+                const parameters = this.builderStatsToAnalyticsParameters(stats, builderName);
+                if (!parameters) {
+                    return;
+                }
+                if (firstRun) {
+                    firstRun = false;
+                    analytics.reportBuildRunEvent(parameters);
+                }
+                else {
+                    analytics.reportRebuildRunEvent(parameters);
+                }
+            });
+        }
+        try {
+            const { error, success } = await run.lastOutput;
+            if (error) {
+                logger.error(error);
+            }
+            return success ? 0 : 1;
+        }
+        finally {
+            await run.stop();
+            outputSubscription?.unsubscribe();
+        }
+    }
+    builderStatsToAnalyticsParameters(stats, builderName) {
+        if (!stats || typeof stats !== 'object' || !('durationInMs' in stats)) {
+            return undefined;
+        }
+        const { optimization, allChunksCount, aot, lazyChunksCount, initialChunksCount, durationInMs, changedChunksCount, cssSizeInBytes, jsSizeInBytes, ngComponentCount, } = stats;
+        return {
+            [analytics_parameters_1.EventCustomDimension.BuilderTarget]: builderName,
+            [analytics_parameters_1.EventCustomDimension.Aot]: aot,
+            [analytics_parameters_1.EventCustomDimension.Optimization]: optimization,
+            [analytics_parameters_1.EventCustomMetric.AllChunksCount]: allChunksCount,
+            [analytics_parameters_1.EventCustomMetric.LazyChunksCount]: lazyChunksCount,
+            [analytics_parameters_1.EventCustomMetric.InitialChunksCount]: initialChunksCount,
+            [analytics_parameters_1.EventCustomMetric.ChangedChunksCount]: changedChunksCount,
+            [analytics_parameters_1.EventCustomMetric.DurationInMs]: durationInMs,
+            [analytics_parameters_1.EventCustomMetric.JsSizeInBytes]: jsSizeInBytes,
+            [analytics_parameters_1.EventCustomMetric.CssSizeInBytes]: cssSizeInBytes,
+            [analytics_parameters_1.EventCustomMetric.NgComponentCount]: ngComponentCount,
+        };
+    }
+    _architectHost;
+    getArchitectHost() {
+        if (this._architectHost) {
+            return this._architectHost;
+        }
+        const workspace = this.getWorkspaceOrThrow();
+        return (this._architectHost = new node_1.WorkspaceNodeModulesArchitectHost(workspace, workspace.basePath));
+    }
+    _architect;
+    getArchitect(skipUndefinedArrayTransform) {
+        if (this._architect) {
+            return this._architect;
+        }
+        const registry = new core_1.json.schema.CoreSchemaRegistry();
+        if (skipUndefinedArrayTransform) {
+            registry.addPostTransform(core_1.json.schema.transforms.addUndefinedObjectDefaults);
+        }
+        else {
+            registry.addPostTransform(core_1.json.schema.transforms.addUndefinedDefaults);
+        }
+        registry.useXDeprecatedProvider((msg) => this.context.logger.warn(msg));
+        const architectHost = this.getArchitectHost();
+        return (this._architect = new architect_1.Architect(architectHost, registry));
+    }
+    async getArchitectTargetOptions(target) {
+        const architectHost = this.getArchitectHost();
+        let builderConf;
+        try {
+            builderConf = await architectHost.getBuilderNameForTarget(target);
+        }
+        catch {
+            return [];
+        }
+        let builderDesc;
+        try {
+            builderDesc = await architectHost.resolveBuilder(builderConf);
+        }
+        catch (e) {
+            (0, error_1.assertIsError)(e);
+            if (e.code === 'MODULE_NOT_FOUND') {
+                this.warnOnMissingNodeModules();
+                throw new command_module_1.CommandModuleError(`Could not find the '${builderConf}' builder's node package.`);
+            }
+            throw e;
+        }
+        return (0, json_schema_1.parseJsonSchemaToOptions)(new core_1.json.schema.CoreSchemaRegistry(), builderDesc.optionSchema, true);
+    }
+    warnOnMissingNodeModules() {
+        const basePath = this.context.workspace?.basePath;
+        if (!basePath) {
+            return;
+        }
+        const workspaceResolve = (0, node_module_1.createRequire)(basePath + '/').resolve;
+        try {
+            workspaceResolve('@angular/core');
+            return;
+        }
+        catch { }
+        this.context.logger.warn(`Node packages may not be installed. Try installing with '${this.context.packageManager.name} install'.`);
+    }
+    getArchitectTarget() {
+        return this.commandName;
+    }
+    async onMissingTarget(defaultMessage) {
+        const { logger } = this.context;
+        const choices = this.missingTargetChoices;
+        if (!choices?.length) {
+            logger.error(defaultMessage);
+            return 1;
+        }
+        const missingTargetMessage = `Cannot find "${this.getArchitectTarget()}" target for the specified project.\n` +
+            `You can add a package that implements these capabilities.\n\n` +
+            `For example:\n` +
+            choices.map(({ name, value }) => `  ${name}: ng add ${value}`).join('\n') +
+            '\n';
+        if ((0, tty_1.isTTY)()) {
+            // Use prompts to ask the user if they'd like to install a package.
+            logger.warn(missingTargetMessage);
+            const packageToInstall = await this.getMissingTargetPackageToInstall(choices);
+            if (packageToInstall) {
+                // Example run: `ng add angular-eslint`.
+                const AddCommandModule = (await Promise.resolve().then(() => __importStar(require('../commands/add/cli')))).default;
+                await new AddCommandModule(this.context).run({
+                    interactive: true,
+                    force: false,
+                    dryRun: false,
+                    defaults: false,
+                    collection: packageToInstall,
+                });
+            }
+        }
+        else {
+            // Non TTY display error message.
+            logger.error(missingTargetMessage);
+        }
+        return 1;
+    }
+    async getMissingTargetPackageToInstall(choices) {
+        if (choices.length === 1) {
+            // Single choice
+            const { name, value } = choices[0];
+            if (await (0, prompt_1.askConfirmation)(`Would you like to add ${name} now?`, true, false)) {
+                return value;
+            }
+            return null;
+        }
+        // Multiple choice
+        return (0, prompt_1.askQuestion)(`Would you like to add a package with "${this.getArchitectTarget()}" capabilities now?`, [
+            {
+                name: 'No',
+                value: null,
+            },
+            ...choices,
+        ], 0, null);
+    }
+}
+exports.ArchitectBaseCommandModule = ArchitectBaseCommandModule;
+//# sourceMappingURL=architect-base-command-module.js.map

package/src/command-builder/architect-base-command-module.js.map

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

package/src/command-builder/architect-command-module.d.ts

@@ -0,0 +1,28 @@
+/**
+ * @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 { Target } from '@angular-devkit/architect';
+import { workspaces } from '@angular-devkit/core';
+import { Argv } from 'yargs';
+import { ArchitectBaseCommandModule } from './architect-base-command-module';
+import { CommandModuleImplementation, Options, OtherOptions } from './command-module';
+export interface ArchitectCommandArgs {
+    configuration?: string;
+    project?: string;
+}
+export declare abstract class ArchitectCommandModule extends ArchitectBaseCommandModule<ArchitectCommandArgs> implements CommandModuleImplementation<ArchitectCommandArgs> {
+    abstract readonly multiTarget: boolean;
+    findDefaultBuilderName?(project: workspaces.ProjectDefinition, target: Target): Promise<string | undefined>;
+    builder(argv: Argv): Promise<Argv<ArchitectCommandArgs>>;
+    run(options: Options<ArchitectCommandArgs> & OtherOptions): Promise<number | void>;
+    private getArchitectProject;
+    private getProjectNamesByTarget;
+    /** @returns a sorted list of project names to be used for auto completion. */
+    private getProjectChoices;
+    /** @returns a sorted list of configuration names to be used for auto completion. */
+    private getConfigurationChoices;
+}

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

@@ -0,0 +1,218 @@
+"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 __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;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ArchitectCommandModule = void 0;
+const config_1 = require("../utilities/config");
+const memoize_1 = require("../utilities/memoize");
+const architect_base_command_module_1 = require("./architect-base-command-module");
+const command_module_1 = require("./command-module");
+let ArchitectCommandModule = (() => {
+    let _classSuper = architect_base_command_module_1.ArchitectBaseCommandModule;
+    let _instanceExtraInitializers = [];
+    let _getProjectNamesByTarget_decorators;
+    return class ArchitectCommandModule extends _classSuper {
+        static {
+            const _metadata = typeof Symbol === "function" && Symbol.metadata ? Object.create(_classSuper[Symbol.metadata] ?? null) : void 0;
+            _getProjectNamesByTarget_decorators = [memoize_1.memoize];
+            __esDecorate(this, null, _getProjectNamesByTarget_decorators, { kind: "method", name: "getProjectNamesByTarget", static: false, private: false, access: { has: obj => "getProjectNamesByTarget" in obj, get: obj => obj.getProjectNamesByTarget }, metadata: _metadata }, null, _instanceExtraInitializers);
+            if (_metadata) Object.defineProperty(this, Symbol.metadata, { enumerable: true, configurable: true, writable: true, value: _metadata });
+        }
+        async builder(argv) {
+            const target = this.getArchitectTarget();
+            // Add default builder if target is not in project and a command default is provided
+            if (this.findDefaultBuilderName && this.context.workspace) {
+                for (const [project, projectDefinition] of this.context.workspace.projects) {
+                    const targetDefinition = projectDefinition.targets.get(target);
+                    if (targetDefinition?.builder) {
+                        continue;
+                    }
+                    const defaultBuilder = await this.findDefaultBuilderName(projectDefinition, {
+                        project,
+                        target,
+                    });
+                    if (!defaultBuilder) {
+                        continue;
+                    }
+                    if (targetDefinition) {
+                        targetDefinition.builder = defaultBuilder;
+                    }
+                    else {
+                        projectDefinition.targets.set(target, {
+                            builder: defaultBuilder,
+                        });
+                    }
+                }
+            }
+            const project = this.getArchitectProject();
+            const { jsonHelp, getYargsCompletions, help } = this.context.args.options;
+            const localYargs = argv
+                .positional('project', {
+                describe: 'The name of the project to build. Can be an application or a library.',
+                type: 'string',
+                // Hide choices from JSON help so that we don't display them in AIO.
+                choices: jsonHelp ? undefined : this.getProjectChoices(),
+            })
+                .option('configuration', {
+                describe: `One or more named builder configurations as a comma-separated ` +
+                    `list as specified in the "configurations" section in angular.json.\n` +
+                    `The builder uses the named configurations to run the given target.\n` +
+                    `For more information, see https://angular.dev/reference/configs/workspace-config#alternate-build-configurations.`,
+                alias: 'c',
+                type: 'string',
+                // Show only in when using --help and auto completion because otherwise comma seperated configuration values will be invalid.
+                // Also, hide choices from JSON help so that we don't display them in AIO.
+                choices: (getYargsCompletions || help) && !jsonHelp && project
+                    ? this.getConfigurationChoices(project)
+                    : undefined,
+            })
+                .strict();
+            if (!project) {
+                return localYargs;
+            }
+            const schemaOptions = await this.getArchitectTargetOptions({
+                project,
+                target,
+            });
+            return this.addSchemaOptionsToCommand(localYargs, schemaOptions);
+        }
+        async run(options) {
+            const originalProcessTitle = process.title;
+            try {
+                const target = this.getArchitectTarget();
+                const { configuration = '', project, ...architectOptions } = options;
+                if (project) {
+                    process.title = `${originalProcessTitle} (${project})`;
+                    return await this.runSingleTarget({ configuration, target, project }, architectOptions);
+                }
+                // This runs each target sequentially.
+                // Running them in parallel would jumble the log messages.
+                let result = 0;
+                const projectNames = this.getProjectNamesByTarget(target);
+                if (!projectNames) {
+                    return this.onMissingTarget('Cannot determine project or target for command.');
+                }
+                for (const project of projectNames) {
+                    process.title = `${originalProcessTitle} (${project})`;
+                    result |= await this.runSingleTarget({ configuration, target, project }, architectOptions);
+                }
+                return result;
+            }
+            finally {
+                process.title = originalProcessTitle;
+            }
+        }
+        getArchitectProject() {
+            const { options, positional } = this.context.args;
+            const [, projectName] = positional;
+            if (projectName) {
+                return projectName;
+            }
+            // Yargs allows positional args to be used as flags.
+            if (typeof options['project'] === 'string') {
+                return options['project'];
+            }
+            const target = this.getArchitectTarget();
+            const projectFromTarget = this.getProjectNamesByTarget(target);
+            return projectFromTarget?.length ? projectFromTarget[0] : undefined;
+        }
+        getProjectNamesByTarget(target) {
+            const workspace = this.getWorkspaceOrThrow();
+            const allProjectsForTargetName = [];
+            for (const [name, project] of workspace.projects) {
+                if (project.targets.has(target)) {
+                    allProjectsForTargetName.push(name);
+                }
+            }
+            if (allProjectsForTargetName.length === 0) {
+                return undefined;
+            }
+            if (this.multiTarget) {
+                // For multi target commands, we always list all projects that have the target.
+                return allProjectsForTargetName;
+            }
+            else {
+                if (allProjectsForTargetName.length === 1) {
+                    return allProjectsForTargetName;
+                }
+                const maybeProject = (0, config_1.getProjectByCwd)(workspace);
+                if (maybeProject) {
+                    return allProjectsForTargetName.includes(maybeProject) ? [maybeProject] : undefined;
+                }
+                const { getYargsCompletions, help } = this.context.args.options;
+                if (!getYargsCompletions && !help) {
+                    // Only issue the below error when not in help / completion mode.
+                    throw new command_module_1.CommandModuleError('Cannot determine project for command.\n' +
+                        'This is a multi-project workspace and more than one project supports this command. ' +
+                        `Run "ng ${this.command}" to execute the command for a specific project or change the current ` +
+                        'working directory to a project directory.\n\n' +
+                        `Available projects are:\n${allProjectsForTargetName
+                            .sort()
+                            .map((p) => `- ${p}`)
+                            .join('\n')}`);
+                }
+            }
+            return undefined;
+        }
+        /** @returns a sorted list of project names to be used for auto completion. */
+        getProjectChoices() {
+            const { workspace } = this.context;
+            return workspace ? [...workspace.projects.keys()].sort() : undefined;
+        }
+        /** @returns a sorted list of configuration names to be used for auto completion. */
+        getConfigurationChoices(project) {
+            const projectDefinition = this.context.workspace?.projects.get(project);
+            if (!projectDefinition) {
+                return undefined;
+            }
+            const target = this.getArchitectTarget();
+            const configurations = projectDefinition.targets.get(target)?.configurations;
+            return configurations ? Object.keys(configurations).sort() : undefined;
+        }
+        constructor() {
+            super(...arguments);
+            __runInitializers(this, _instanceExtraInitializers);
+        }
+    };
+})();
+exports.ArchitectCommandModule = ArchitectCommandModule;
+//# sourceMappingURL=architect-command-module.js.map

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

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

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

@@ -0,0 +1,73 @@
+/**
+ * @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 type { ArgumentsCamelCase, Argv, CommandModule as YargsCommandModule } from 'yargs';
+import { AnalyticsCollector } from '../analytics/analytics-collector';
+import { EventCustomDimension, EventCustomMetric } from '../analytics/analytics-parameters';
+import { AngularWorkspace } from '../utilities/config';
+import { CommandContext, CommandScope, Options, OtherOptions } from './definitions';
+import { Option } from './utilities/json-schema';
+export { CommandScope };
+export type { CommandContext, Options, OtherOptions };
+export interface CommandModuleImplementation<T extends {} = {}> extends Omit<YargsCommandModule<{}, T>, 'builder' | 'handler'> {
+    /** Scope in which the command can be executed in. */
+    scope: CommandScope;
+    /** Path used to load the long description for the command in JSON help text. */
+    longDescriptionPath?: string;
+    /** Object declaring the options the command accepts, or a function accepting and returning a yargs instance. */
+    builder(argv: Argv): Promise<Argv<T>> | Argv<T>;
+    /** A function which will be passed the parsed argv. */
+    run(options: Options<T> & OtherOptions): Promise<number | void> | number | void;
+}
+export interface FullDescribe {
+    describe?: string;
+    longDescription?: string;
+    longDescriptionRelativePath?: string;
+}
+export declare abstract class CommandModule<T extends {} = {}> implements CommandModuleImplementation<T> {
+    protected readonly context: CommandContext;
+    abstract readonly command: string;
+    abstract readonly describe: string | false;
+    abstract readonly longDescriptionPath?: string;
+    protected readonly shouldReportAnalytics: boolean;
+    readonly scope: CommandScope;
+    private readonly optionsWithAnalytics;
+    constructor(context: CommandContext);
+    /**
+     * Description object which contains the long command descroption.
+     * This is used to generate JSON help wich is used in AIO.
+     *
+     * `false` will result in a hidden command.
+     */
+    get fullDescribe(): FullDescribe | false;
+    protected get commandName(): string;
+    abstract builder(argv: Argv): Promise<Argv<T>> | Argv<T>;
+    abstract run(options: Options<T> & OtherOptions): Promise<number | void> | number | void;
+    handler(args: ArgumentsCamelCase<T> & OtherOptions): Promise<void>;
+    protected getAnalytics(): Promise<AnalyticsCollector | undefined>;
+    /**
+     * Adds schema options to a command also this keeps track of options that are required for analytics.
+     * **Note:** This method should be called from the command bundler method.
+     */
+    protected addSchemaOptionsToCommand<T>(localYargs: Argv<T>, options: Option[]): Argv<T>;
+    protected getWorkspaceOrThrow(): AngularWorkspace;
+    /**
+     * Flush on an interval (if the event loop is waiting).
+     *
+     * @returns a method that when called will terminate the periodic
+     * flush and call flush one last time.
+     */
+    protected getAnalyticsParameters(options: (Options<T> & OtherOptions) | OtherOptions): Partial<Record<EventCustomDimension | EventCustomMetric, string | boolean | number>>;
+    private reportCommandRunAnalytics;
+    private reportWorkspaceInfoAnalytics;
+}
+/**
+ * Creates an known command module error.
+ * This is used so during executation we can filter between known validation error and real non handled errors.
+ */
+export declare class CommandModuleError extends Error {
+}