@theia/core 1.53.0-next.55 → 1.53.0-next.64

package/src/common/command.ts

@@ -1,489 +1,489 @@
-// *****************************************************************************
-// Copyright (C) 2017 TypeFox and others.
-//
-// This program and the accompanying materials are made available under the
-// terms of the Eclipse Public License v. 2.0 which is available at
-// http://www.eclipse.org/legal/epl-2.0.
-//
-// This Source Code may also be made available under the following Secondary
-// Licenses when the conditions for such availability set forth in the Eclipse
-// Public License v. 2.0 are satisfied: GNU General Public License, version 2
-// with the GNU Classpath Exception which is available at
-// https://www.gnu.org/software/classpath/license.html.
-//
-// SPDX-License-Identifier: EPL-2.0 OR GPL-2.0-only WITH Classpath-exception-2.0
-// *****************************************************************************
-
-import { injectable, inject, named } from 'inversify';
-import { Event, Emitter, WaitUntilEvent } from './event';
-import { Disposable, DisposableCollection } from './disposable';
-import { ContributionProvider } from './contribution-provider';
-import { nls } from './nls';
-import debounce = require('p-debounce');
-import { isObject } from './types';
-
-/**
- * A command is a unique identifier of a function
- * which can be executed by a user via a keyboard shortcut,
- * a menu action or directly.
- */
-export interface Command {
-    /**
-     * A unique identifier of this command.
-     */
-    id: string;
-    /**
-     * A label of this command.
-     */
-    label?: string;
-    originalLabel?: string;
-    /**
-     * An icon class of this command.
-     */
-    iconClass?: string;
-    /**
-     * A short title used for display in menus.
-     */
-    shortTitle?: string;
-    /**
-     * A category of this command.
-     */
-    category?: string;
-    originalCategory?: string;
-}
-
-export namespace Command {
-    /* Determine whether object is a Command */
-    export function is(arg: unknown): arg is Command {
-        return isObject(arg) && 'id' in arg;
-    }
-
-    /** Utility function to easily translate commands */
-    export function toLocalizedCommand(command: Command, nlsLabelKey: string = command.id, nlsCategoryKey?: string): Command {
-        return {
-            ...command,
-            label: command.label && nls.localize(nlsLabelKey, command.label),
-            originalLabel: command.label,
-            category: nlsCategoryKey && command.category && nls.localize(nlsCategoryKey, command.category) || command.category,
-            originalCategory: command.category,
-        };
-    }
-
-    export function toDefaultLocalizedCommand(command: Command): Command {
-        return {
-            ...command,
-            label: command.label && nls.localizeByDefault(command.label),
-            originalLabel: command.label,
-            category: command.category && nls.localizeByDefault(command.category),
-            originalCategory: command.category,
-        };
-    }
-
-    /** Comparator function for when sorting commands */
-    export function compareCommands(a: Command, b: Command): number {
-        if (a.label && b.label) {
-            const aCommand = (a.category ? `${a.category}: ${a.label}` : a.label).toLowerCase();
-            const bCommand = (b.category ? `${b.category}: ${b.label}` : b.label).toLowerCase();
-            return (aCommand).localeCompare(bCommand);
-        } else {
-            return 0;
-        }
-    }
-
-    /**
-     * Determine if two commands are equal.
-     *
-     * @param a the first command for comparison.
-     * @param b the second command for comparison.
-     */
-    export function equals(a: Command, b: Command): boolean {
-        return (
-            a.id === b.id &&
-            a.label === b.label &&
-            a.iconClass === b.iconClass &&
-            a.category === b.category
-        );
-    }
-}
-
-/**
- * A command handler is an implementation of a command.
- *
- * A command can have multiple handlers
- * but they should be active in different contexts,
- * otherwise first active will be executed.
- */
-export interface CommandHandler {
-    /**
-     * Execute this handler.
-     *
-     * Don't call it directly, use `CommandService.executeCommand` instead.
-     */
-    // eslint-disable-next-line @typescript-eslint/no-explicit-any
-    execute(...args: any[]): any;
-    /**
-     * Test whether this handler is enabled (active).
-     */
-    // eslint-disable-next-line @typescript-eslint/no-explicit-any
-    isEnabled?(...args: any[]): boolean;
-    onDidChangeEnabled?: Event<void>;
-    /**
-     * Test whether menu items for this handler should be visible.
-     */
-    // eslint-disable-next-line @typescript-eslint/no-explicit-any
-    isVisible?(...args: any[]): boolean;
-    /**
-     * Test whether menu items for this handler should be toggled.
-     */
-    // eslint-disable-next-line @typescript-eslint/no-explicit-any
-    isToggled?(...args: any[]): boolean;
-}
-
-export const CommandContribution = Symbol('CommandContribution');
-/**
- * The command contribution should be implemented to register custom commands and handler.
- */
-export interface CommandContribution {
-    /**
-     * Register commands and handlers.
-     */
-    registerCommands(commands: CommandRegistry): void;
-}
-
-export interface CommandEvent {
-    commandId: string;
-    // eslint-disable-next-line @typescript-eslint/no-explicit-any
-    args: any[]
-}
-
-export interface WillExecuteCommandEvent extends WaitUntilEvent, CommandEvent {
-}
-
-export const commandServicePath = '/services/commands';
-export const CommandService = Symbol('CommandService');
-/**
- * The command service should be used to execute commands.
- */
-export interface CommandService {
-    /**
-     * Execute the active handler for the given command and arguments.
-     *
-     * Reject if a command cannot be executed.
-     */
-    // eslint-disable-next-line @typescript-eslint/no-explicit-any
-    executeCommand<T>(command: string, ...args: any[]): Promise<T | undefined>;
-    /**
-     * An event is emitted when a command is about to be executed.
-     *
-     * It can be used to install or activate a command handler.
-     */
-    readonly onWillExecuteCommand: Event<WillExecuteCommandEvent>;
-    /**
-     * An event is emitted when a command was executed.
-     */
-    readonly onDidExecuteCommand: Event<CommandEvent>;
-}
-
-/**
- * The command registry manages commands and handlers.
- */
-@injectable()
-export class CommandRegistry implements CommandService {
-
-    protected readonly _commands: { [id: string]: Command } = {};
-    protected readonly _handlers: { [id: string]: CommandHandler[] } = {};
-
-    protected readonly toUnregisterCommands = new Map<string, Disposable>();
-
-    // List of recently used commands.
-    protected _recent: string[] = [];
-
-    protected readonly onWillExecuteCommandEmitter = new Emitter<WillExecuteCommandEvent>();
-    readonly onWillExecuteCommand = this.onWillExecuteCommandEmitter.event;
-
-    protected readonly onDidExecuteCommandEmitter = new Emitter<CommandEvent>();
-    readonly onDidExecuteCommand = this.onDidExecuteCommandEmitter.event;
-
-    protected readonly onCommandsChangedEmitter = new Emitter<void>();
-    readonly onCommandsChanged = this.onCommandsChangedEmitter.event;
-
-    constructor(
-        @inject(ContributionProvider) @named(CommandContribution)
-        protected readonly contributionProvider: ContributionProvider<CommandContribution>
-    ) { }
-
-    onStart(): void {
-        const contributions = this.contributionProvider.getContributions();
-        for (const contrib of contributions) {
-            contrib.registerCommands(this);
-        }
-    }
-
-    *getAllCommands(): IterableIterator<Readonly<Command & { handlers: CommandHandler[] }>> {
-        for (const command of Object.values(this._commands)) {
-            yield { ...command, handlers: this._handlers[command.id] ?? [] };
-        }
-    }
-
-    /**
-     * Register the given command and handler if present.
-     *
-     * Throw if a command is already registered for the given command identifier.
-     */
-    registerCommand(command: Command, handler?: CommandHandler): Disposable {
-        if (this._commands[command.id]) {
-            console.warn(`A command ${command.id} is already registered.`);
-            return Disposable.NULL;
-        }
-        const toDispose = new DisposableCollection(this.doRegisterCommand(command));
-        if (handler) {
-            toDispose.push(this.registerHandler(command.id, handler));
-        }
-        this.toUnregisterCommands.set(command.id, toDispose);
-        toDispose.push(Disposable.create(() => this.toUnregisterCommands.delete(command.id)));
-        return toDispose;
-    }
-
-    protected doRegisterCommand(command: Command): Disposable {
-        this._commands[command.id] = command;
-        return {
-            dispose: () => {
-                delete this._commands[command.id];
-            }
-        };
-    }
-
-    /**
-     * Unregister command from the registry
-     *
-     * @param command
-     */
-    unregisterCommand(command: Command): void;
-    /**
-     * Unregister command from the registry
-     *
-     * @param id
-     */
-    unregisterCommand(id: string): void;
-    unregisterCommand(commandOrId: Command | string): void {
-        const id = Command.is(commandOrId) ? commandOrId.id : commandOrId;
-        const toUnregister = this.toUnregisterCommands.get(id);
-        if (toUnregister) {
-            toUnregister.dispose();
-        }
-    }
-
-    /**
-     * Register the given handler for the given command identifier.
-     *
-     * If there is already a handler for the given command
-     * then the given handler is registered as more specific, and
-     * has higher priority during enablement, visibility and toggle state evaluations.
-     */
-    registerHandler(commandId: string, handler: CommandHandler): Disposable {
-        let handlers = this._handlers[commandId];
-        if (!handlers) {
-            this._handlers[commandId] = handlers = [];
-        }
-        handlers.unshift(handler);
-        this.fireDidChange();
-        return {
-            dispose: () => {
-                const idx = handlers.indexOf(handler);
-                if (idx >= 0) {
-                    handlers.splice(idx, 1);
-                    this.fireDidChange();
-                }
-            }
-        };
-    }
-
-    protected fireDidChange = debounce(() => this.doFireDidChange(), 0);
-
-    protected doFireDidChange(): void {
-        this.onCommandsChangedEmitter.fire();
-    }
-
-    /**
-     * Test whether there is an active handler for the given command.
-     */
-    // eslint-disable-next-line @typescript-eslint/no-explicit-any
-    isEnabled(command: string, ...args: any[]): boolean {
-        return typeof this.getActiveHandler(command, ...args) !== 'undefined';
-    }
-
-    /**
-     * Test whether there is a visible handler for the given command.
-     */
-    // eslint-disable-next-line @typescript-eslint/no-explicit-any
-    isVisible(command: string, ...args: any[]): boolean {
-        return typeof this.getVisibleHandler(command, ...args) !== 'undefined';
-    }
-
-    /**
-     * Test whether there is a toggled handler for the given command.
-     */
-    // eslint-disable-next-line @typescript-eslint/no-explicit-any
-    isToggled(command: string, ...args: any[]): boolean {
-        return typeof this.getToggledHandler(command, ...args) !== 'undefined';
-    }
-
-    /**
-     * Execute the active handler for the given command and arguments.
-     *
-     * Reject if a command cannot be executed.
-     */
-    // eslint-disable-next-line @typescript-eslint/no-explicit-any
-    async executeCommand<T>(commandId: string, ...args: any[]): Promise<T | undefined> {
-        const handler = this.getActiveHandler(commandId, ...args);
-        if (handler) {
-            await this.fireWillExecuteCommand(commandId, args);
-            const result = await handler.execute(...args);
-            this.onDidExecuteCommandEmitter.fire({ commandId, args });
-            return result;
-        }
-        throw Object.assign(new Error(`The command '${commandId}' cannot be executed. There are no active handlers available for the command.`), { code: 'NO_ACTIVE_HANDLER' });
-    }
-
-    // eslint-disable-next-line @typescript-eslint/no-explicit-any
-    protected async fireWillExecuteCommand(commandId: string, args: any[] = []): Promise<void> {
-        await WaitUntilEvent.fire(this.onWillExecuteCommandEmitter, { commandId, args }, 30000);
-    }
-
-    /**
-     * Get a visible handler for the given command or `undefined`.
-     */
-    // eslint-disable-next-line @typescript-eslint/no-explicit-any
-    getVisibleHandler(commandId: string, ...args: any[]): CommandHandler | undefined {
-        const handlers = this._handlers[commandId];
-        if (handlers) {
-            for (const handler of handlers) {
-                try {
-                    if (!handler.isVisible || handler.isVisible(...args)) {
-                        return handler;
-                    }
-                } catch (error) {
-                    console.error(error);
-                }
-            }
-        }
-        return undefined;
-    }
-
-    /**
-     * Get an active handler for the given command or `undefined`.
-     */
-    // eslint-disable-next-line @typescript-eslint/no-explicit-any
-    getActiveHandler(commandId: string, ...args: any[]): CommandHandler | undefined {
-        const handlers = this._handlers[commandId];
-        if (handlers) {
-            for (const handler of handlers) {
-                try {
-                    if (!handler.isEnabled || handler.isEnabled(...args)) {
-                        return handler;
-                    }
-                } catch (error) {
-                    console.error(error);
-                }
-            }
-        }
-        return undefined;
-    }
-
-    /**
-     * Get a toggled handler for the given command or `undefined`.
-     */
-    // eslint-disable-next-line @typescript-eslint/no-explicit-any
-    getToggledHandler(commandId: string, ...args: any[]): CommandHandler | undefined {
-        const handlers = this._handlers[commandId];
-        if (handlers) {
-            for (const handler of handlers) {
-                try {
-                    if (handler.isToggled && handler.isToggled(...args)) {
-                        return handler;
-                    }
-                } catch (error) {
-                    console.error(error);
-                }
-            }
-        }
-        return undefined;
-    }
-
-    /**
-     * Returns with all handlers for the given command. If the command does not have any handlers,
-     * or the command is not registered, returns an empty array.
-     */
-    getAllHandlers(commandId: string): CommandHandler[] {
-        const handlers = this._handlers[commandId];
-        return handlers ? handlers.slice() : [];
-    }
-
-    /**
-     * Get all registered commands.
-     */
-    get commands(): Command[] {
-        return Object.values(this._commands);
-    }
-
-    /**
-     * Get a command for the given command identifier.
-     */
-    getCommand(id: string): Command | undefined {
-        return this._commands[id];
-    }
-
-    /**
-     * Get all registered commands identifiers.
-     */
-    get commandIds(): string[] {
-        return Object.keys(this._commands);
-    }
-
-    /**
-     * Get the list of recently used commands.
-     */
-    get recent(): Command[] {
-        const commands: Command[] = [];
-        for (const recentId of this._recent) {
-            const command = this.getCommand(recentId);
-            if (command) {
-                commands.push(command);
-            }
-        }
-        return commands;
-    }
-
-    /**
-     * Set the list of recently used commands.
-     * @param commands the list of recently used commands.
-     */
-    set recent(commands: Command[]) {
-        this._recent = Array.from(new Set(commands.map(e => e.id)));
-    }
-
-    /**
-     * Adds a command to recently used list.
-     * Prioritizes commands that were recently executed to be most recent.
-     *
-     * @param recent a recent command, or array of recent commands.
-     */
-    addRecentCommand(recent: Command | Command[]): void {
-        for (const recentCommand of Array.isArray(recent) ? recent : [recent]) {
-            // Determine if the command currently exists in the recently used list.
-            const index = this._recent.findIndex(commandId => commandId === recentCommand.id);
-            // If the command exists, remove it from the array so it can later be placed at the top.
-            if (index >= 0) { this._recent.splice(index, 1); }
-            // Add the recent command to the beginning of the array (most recent).
-            this._recent.unshift(recentCommand.id);
-        }
-    }
-
-    /**
-     * Clear the list of recently used commands.
-     */
-    clearCommandHistory(): void {
-        this.recent = [];
-    }
-
-}
+// *****************************************************************************
+// Copyright (C) 2017 TypeFox and others.
+//
+// This program and the accompanying materials are made available under the
+// terms of the Eclipse Public License v. 2.0 which is available at
+// http://www.eclipse.org/legal/epl-2.0.
+//
+// This Source Code may also be made available under the following Secondary
+// Licenses when the conditions for such availability set forth in the Eclipse
+// Public License v. 2.0 are satisfied: GNU General Public License, version 2
+// with the GNU Classpath Exception which is available at
+// https://www.gnu.org/software/classpath/license.html.
+//
+// SPDX-License-Identifier: EPL-2.0 OR GPL-2.0-only WITH Classpath-exception-2.0
+// *****************************************************************************
+
+import { injectable, inject, named } from 'inversify';
+import { Event, Emitter, WaitUntilEvent } from './event';
+import { Disposable, DisposableCollection } from './disposable';
+import { ContributionProvider } from './contribution-provider';
+import { nls } from './nls';
+import debounce = require('p-debounce');
+import { isObject } from './types';
+
+/**
+ * A command is a unique identifier of a function
+ * which can be executed by a user via a keyboard shortcut,
+ * a menu action or directly.
+ */
+export interface Command {
+    /**
+     * A unique identifier of this command.
+     */
+    id: string;
+    /**
+     * A label of this command.
+     */
+    label?: string;
+    originalLabel?: string;
+    /**
+     * An icon class of this command.
+     */
+    iconClass?: string;
+    /**
+     * A short title used for display in menus.
+     */
+    shortTitle?: string;
+    /**
+     * A category of this command.
+     */
+    category?: string;
+    originalCategory?: string;
+}
+
+export namespace Command {
+    /* Determine whether object is a Command */
+    export function is(arg: unknown): arg is Command {
+        return isObject(arg) && 'id' in arg;
+    }
+
+    /** Utility function to easily translate commands */
+    export function toLocalizedCommand(command: Command, nlsLabelKey: string = command.id, nlsCategoryKey?: string): Command {
+        return {
+            ...command,
+            label: command.label && nls.localize(nlsLabelKey, command.label),
+            originalLabel: command.label,
+            category: nlsCategoryKey && command.category && nls.localize(nlsCategoryKey, command.category) || command.category,
+            originalCategory: command.category,
+        };
+    }
+
+    export function toDefaultLocalizedCommand(command: Command): Command {
+        return {
+            ...command,
+            label: command.label && nls.localizeByDefault(command.label),
+            originalLabel: command.label,
+            category: command.category && nls.localizeByDefault(command.category),
+            originalCategory: command.category,
+        };
+    }
+
+    /** Comparator function for when sorting commands */
+    export function compareCommands(a: Command, b: Command): number {
+        if (a.label && b.label) {
+            const aCommand = (a.category ? `${a.category}: ${a.label}` : a.label).toLowerCase();
+            const bCommand = (b.category ? `${b.category}: ${b.label}` : b.label).toLowerCase();
+            return (aCommand).localeCompare(bCommand);
+        } else {
+            return 0;
+        }
+    }
+
+    /**
+     * Determine if two commands are equal.
+     *
+     * @param a the first command for comparison.
+     * @param b the second command for comparison.
+     */
+    export function equals(a: Command, b: Command): boolean {
+        return (
+            a.id === b.id &&
+            a.label === b.label &&
+            a.iconClass === b.iconClass &&
+            a.category === b.category
+        );
+    }
+}
+
+/**
+ * A command handler is an implementation of a command.
+ *
+ * A command can have multiple handlers
+ * but they should be active in different contexts,
+ * otherwise first active will be executed.
+ */
+export interface CommandHandler {
+    /**
+     * Execute this handler.
+     *
+     * Don't call it directly, use `CommandService.executeCommand` instead.
+     */
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    execute(...args: any[]): any;
+    /**
+     * Test whether this handler is enabled (active).
+     */
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    isEnabled?(...args: any[]): boolean;
+    onDidChangeEnabled?: Event<void>;
+    /**
+     * Test whether menu items for this handler should be visible.
+     */
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    isVisible?(...args: any[]): boolean;
+    /**
+     * Test whether menu items for this handler should be toggled.
+     */
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    isToggled?(...args: any[]): boolean;
+}
+
+export const CommandContribution = Symbol('CommandContribution');
+/**
+ * The command contribution should be implemented to register custom commands and handler.
+ */
+export interface CommandContribution {
+    /**
+     * Register commands and handlers.
+     */
+    registerCommands(commands: CommandRegistry): void;
+}
+
+export interface CommandEvent {
+    commandId: string;
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    args: any[]
+}
+
+export interface WillExecuteCommandEvent extends WaitUntilEvent, CommandEvent {
+}
+
+export const commandServicePath = '/services/commands';
+export const CommandService = Symbol('CommandService');
+/**
+ * The command service should be used to execute commands.
+ */
+export interface CommandService {
+    /**
+     * Execute the active handler for the given command and arguments.
+     *
+     * Reject if a command cannot be executed.
+     */
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    executeCommand<T>(command: string, ...args: any[]): Promise<T | undefined>;
+    /**
+     * An event is emitted when a command is about to be executed.
+     *
+     * It can be used to install or activate a command handler.
+     */
+    readonly onWillExecuteCommand: Event<WillExecuteCommandEvent>;
+    /**
+     * An event is emitted when a command was executed.
+     */
+    readonly onDidExecuteCommand: Event<CommandEvent>;
+}
+
+/**
+ * The command registry manages commands and handlers.
+ */
+@injectable()
+export class CommandRegistry implements CommandService {
+
+    protected readonly _commands: { [id: string]: Command } = {};
+    protected readonly _handlers: { [id: string]: CommandHandler[] } = {};
+
+    protected readonly toUnregisterCommands = new Map<string, Disposable>();
+
+    // List of recently used commands.
+    protected _recent: string[] = [];
+
+    protected readonly onWillExecuteCommandEmitter = new Emitter<WillExecuteCommandEvent>();
+    readonly onWillExecuteCommand = this.onWillExecuteCommandEmitter.event;
+
+    protected readonly onDidExecuteCommandEmitter = new Emitter<CommandEvent>();
+    readonly onDidExecuteCommand = this.onDidExecuteCommandEmitter.event;
+
+    protected readonly onCommandsChangedEmitter = new Emitter<void>();
+    readonly onCommandsChanged = this.onCommandsChangedEmitter.event;
+
+    constructor(
+        @inject(ContributionProvider) @named(CommandContribution)
+        protected readonly contributionProvider: ContributionProvider<CommandContribution>
+    ) { }
+
+    onStart(): void {
+        const contributions = this.contributionProvider.getContributions();
+        for (const contrib of contributions) {
+            contrib.registerCommands(this);
+        }
+    }
+
+    *getAllCommands(): IterableIterator<Readonly<Command & { handlers: CommandHandler[] }>> {
+        for (const command of Object.values(this._commands)) {
+            yield { ...command, handlers: this._handlers[command.id] ?? [] };
+        }
+    }
+
+    /**
+     * Register the given command and handler if present.
+     *
+     * Throw if a command is already registered for the given command identifier.
+     */
+    registerCommand(command: Command, handler?: CommandHandler): Disposable {
+        if (this._commands[command.id]) {
+            console.warn(`A command ${command.id} is already registered.`);
+            return Disposable.NULL;
+        }
+        const toDispose = new DisposableCollection(this.doRegisterCommand(command));
+        if (handler) {
+            toDispose.push(this.registerHandler(command.id, handler));
+        }
+        this.toUnregisterCommands.set(command.id, toDispose);
+        toDispose.push(Disposable.create(() => this.toUnregisterCommands.delete(command.id)));
+        return toDispose;
+    }
+
+    protected doRegisterCommand(command: Command): Disposable {
+        this._commands[command.id] = command;
+        return {
+            dispose: () => {
+                delete this._commands[command.id];
+            }
+        };
+    }
+
+    /**
+     * Unregister command from the registry
+     *
+     * @param command
+     */
+    unregisterCommand(command: Command): void;
+    /**
+     * Unregister command from the registry
+     *
+     * @param id
+     */
+    unregisterCommand(id: string): void;
+    unregisterCommand(commandOrId: Command | string): void {
+        const id = Command.is(commandOrId) ? commandOrId.id : commandOrId;
+        const toUnregister = this.toUnregisterCommands.get(id);
+        if (toUnregister) {
+            toUnregister.dispose();
+        }
+    }
+
+    /**
+     * Register the given handler for the given command identifier.
+     *
+     * If there is already a handler for the given command
+     * then the given handler is registered as more specific, and
+     * has higher priority during enablement, visibility and toggle state evaluations.
+     */
+    registerHandler(commandId: string, handler: CommandHandler): Disposable {
+        let handlers = this._handlers[commandId];
+        if (!handlers) {
+            this._handlers[commandId] = handlers = [];
+        }
+        handlers.unshift(handler);
+        this.fireDidChange();
+        return {
+            dispose: () => {
+                const idx = handlers.indexOf(handler);
+                if (idx >= 0) {
+                    handlers.splice(idx, 1);
+                    this.fireDidChange();
+                }
+            }
+        };
+    }
+
+    protected fireDidChange = debounce(() => this.doFireDidChange(), 0);
+
+    protected doFireDidChange(): void {
+        this.onCommandsChangedEmitter.fire();
+    }
+
+    /**
+     * Test whether there is an active handler for the given command.
+     */
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    isEnabled(command: string, ...args: any[]): boolean {
+        return typeof this.getActiveHandler(command, ...args) !== 'undefined';
+    }
+
+    /**
+     * Test whether there is a visible handler for the given command.
+     */
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    isVisible(command: string, ...args: any[]): boolean {
+        return typeof this.getVisibleHandler(command, ...args) !== 'undefined';
+    }
+
+    /**
+     * Test whether there is a toggled handler for the given command.
+     */
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    isToggled(command: string, ...args: any[]): boolean {
+        return typeof this.getToggledHandler(command, ...args) !== 'undefined';
+    }
+
+    /**
+     * Execute the active handler for the given command and arguments.
+     *
+     * Reject if a command cannot be executed.
+     */
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    async executeCommand<T>(commandId: string, ...args: any[]): Promise<T | undefined> {
+        const handler = this.getActiveHandler(commandId, ...args);
+        if (handler) {
+            await this.fireWillExecuteCommand(commandId, args);
+            const result = await handler.execute(...args);
+            this.onDidExecuteCommandEmitter.fire({ commandId, args });
+            return result;
+        }
+        throw Object.assign(new Error(`The command '${commandId}' cannot be executed. There are no active handlers available for the command.`), { code: 'NO_ACTIVE_HANDLER' });
+    }
+
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    protected async fireWillExecuteCommand(commandId: string, args: any[] = []): Promise<void> {
+        await WaitUntilEvent.fire(this.onWillExecuteCommandEmitter, { commandId, args }, 30000);
+    }
+
+    /**
+     * Get a visible handler for the given command or `undefined`.
+     */
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    getVisibleHandler(commandId: string, ...args: any[]): CommandHandler | undefined {
+        const handlers = this._handlers[commandId];
+        if (handlers) {
+            for (const handler of handlers) {
+                try {
+                    if (!handler.isVisible || handler.isVisible(...args)) {
+                        return handler;
+                    }
+                } catch (error) {
+                    console.error(error);
+                }
+            }
+        }
+        return undefined;
+    }
+
+    /**
+     * Get an active handler for the given command or `undefined`.
+     */
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    getActiveHandler(commandId: string, ...args: any[]): CommandHandler | undefined {
+        const handlers = this._handlers[commandId];
+        if (handlers) {
+            for (const handler of handlers) {
+                try {
+                    if (!handler.isEnabled || handler.isEnabled(...args)) {
+                        return handler;
+                    }
+                } catch (error) {
+                    console.error(error);
+                }
+            }
+        }
+        return undefined;
+    }
+
+    /**
+     * Get a toggled handler for the given command or `undefined`.
+     */
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    getToggledHandler(commandId: string, ...args: any[]): CommandHandler | undefined {
+        const handlers = this._handlers[commandId];
+        if (handlers) {
+            for (const handler of handlers) {
+                try {
+                    if (handler.isToggled && handler.isToggled(...args)) {
+                        return handler;
+                    }
+                } catch (error) {
+                    console.error(error);
+                }
+            }
+        }
+        return undefined;
+    }
+
+    /**
+     * Returns with all handlers for the given command. If the command does not have any handlers,
+     * or the command is not registered, returns an empty array.
+     */
+    getAllHandlers(commandId: string): CommandHandler[] {
+        const handlers = this._handlers[commandId];
+        return handlers ? handlers.slice() : [];
+    }
+
+    /**
+     * Get all registered commands.
+     */
+    get commands(): Command[] {
+        return Object.values(this._commands);
+    }
+
+    /**
+     * Get a command for the given command identifier.
+     */
+    getCommand(id: string): Command | undefined {
+        return this._commands[id];
+    }
+
+    /**
+     * Get all registered commands identifiers.
+     */
+    get commandIds(): string[] {
+        return Object.keys(this._commands);
+    }
+
+    /**
+     * Get the list of recently used commands.
+     */
+    get recent(): Command[] {
+        const commands: Command[] = [];
+        for (const recentId of this._recent) {
+            const command = this.getCommand(recentId);
+            if (command) {
+                commands.push(command);
+            }
+        }
+        return commands;
+    }
+
+    /**
+     * Set the list of recently used commands.
+     * @param commands the list of recently used commands.
+     */
+    set recent(commands: Command[]) {
+        this._recent = Array.from(new Set(commands.map(e => e.id)));
+    }
+
+    /**
+     * Adds a command to recently used list.
+     * Prioritizes commands that were recently executed to be most recent.
+     *
+     * @param recent a recent command, or array of recent commands.
+     */
+    addRecentCommand(recent: Command | Command[]): void {
+        for (const recentCommand of Array.isArray(recent) ? recent : [recent]) {
+            // Determine if the command currently exists in the recently used list.
+            const index = this._recent.findIndex(commandId => commandId === recentCommand.id);
+            // If the command exists, remove it from the array so it can later be placed at the top.
+            if (index >= 0) { this._recent.splice(index, 1); }
+            // Add the recent command to the beginning of the array (most recent).
+            this._recent.unshift(recentCommand.id);
+        }
+    }
+
+    /**
+     * Clear the list of recently used commands.
+     */
+    clearCommandHistory(): void {
+        this.recent = [];
+    }
+
+}