@eclipse-glsp/server 1.1.0-next.3d7585d.42 → 1.1.0-next.44aae0c.44

package/lib/common/command/command-stack.d.ts

@@ -1,37 +1,68 @@
+import { MaybePromise } from '..';
+import { Logger } from '../utils/logger';
 import { Command } from './command';
 export declare const CommandStack: unique symbol;
 /**
- * A basic implementation of an undoable stack of commands.
- * See {@link Command} for more details about the command methods that this implementation uses.
+ * A command stack keeps track of {@link Command commands} that have been executed.
+ * Executed commands can be undone in the reverse order of their original execution.
+ * Unless a new command has been executed after an undo operation, commands can be
+ * redone in the original order of their execution.
+ *
  */
 export interface CommandStack {
     /**
-     * Clears any redoable commands not yet redone, adds the command, and then executes the command.
+     * Clears any redoable commands not yet redone, adds the command to the stack and then invokes {@link Command.execute}.
      * @param command the command to execute.
      */
-    execute(command: Command): void;
+    execute(command: Command): MaybePromise<void>;
     /**
-     * Moves the top of the stack down, undoing what was formerly the top command.
+     * Removes the topmost (i.e. last executed) command from the stack and invokes {@link Command.undo}.
      */
-    undo(): void;
+    undo(): MaybePromise<void>;
     /**
-     * Moves the top of the stack up, redoing the new top command.
+     * Returns `true` if the top command on the stack can be undone.
      */
-    redo(): void;
+    canUndo(): boolean;
     /**
-     * The command stack has currently unsaved changes.
+     * Re-adds the last undo command on top of the stack and invokes {@link Command.redo}
      */
-    isDirty(): boolean;
+    redo(): MaybePromise<void>;
+    /**
+     * Returns `true` if there are  redoable commands in the stack.
+     */
+    canRedo(): boolean;
     /**
      * Called after a save has been successfully performed.
      */
     saveIsDone(): void;
+    /**
+     * Indicates wether the command stack has unsaved changes.
+     */
+    readonly isDirty: boolean;
+    /**
+     * Disposes all the commands in the stack.
+     */
+    flush(): void;
 }
 export declare class DefaultCommandStack implements CommandStack {
-    execute(command: Command): void;
-    undo(): void;
-    redo(): void;
-    isDirty(): boolean;
+    protected logger: Logger;
+    protected commands: Command[];
+    /**
+     * The current position within the command list from which the next execute, undo, or redo, will be performed.
+     */
+    protected top: number;
+    /**
+     * The current position within the command list when {@link DefaultCommandStack.saveIsDone} is called.
+     */
+    protected saveIndex: number;
+    execute(command: Command): Promise<void>;
+    undo(): Promise<void>;
+    canUndo(): boolean;
+    redo(): Promise<void>;
+    canRedo(): boolean;
+    get isDirty(): boolean;
     saveIsDone(): void;
+    flush(): void;
+    protected handleError(error: any): never;
 }
 //# sourceMappingURL=command-stack.d.ts.map

package/lib/common/command/command-stack.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"command-stack.d.ts","sourceRoot":"","sources":["../../../src/common/command/command-stack.ts"],"names":[],"mappings":"AAgBA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEpC,eAAO,MAAM,YAAY,eAAyB,CAAC;AAEnD;;;GAGG;AACH,MAAM,WAAW,YAAY;IACzB;;;OAGG;IACH,OAAO,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAAC;IAEhC;;OAEG;IACH,IAAI,IAAI,IAAI,CAAC;IAEb;;OAEG;IACH,IAAI,IAAI,IAAI,CAAC;IAEb;;OAEG;IACH,OAAO,IAAI,OAAO,CAAC;IAEnB;;OAEG;IACH,UAAU,IAAI,IAAI,CAAC;CACtB;AAED,qBACa,mBAAoB,YAAW,YAAY;IACpD,OAAO,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI;IAI/B,IAAI,IAAI,IAAI;IAIZ,IAAI,IAAI,IAAI;IAIZ,OAAO,IAAI,OAAO;IAIlB,UAAU,IAAI,IAAI;CAGrB"}
+{"version":3,"file":"command-stack.d.ts","sourceRoot":"","sources":["../../../src/common/command/command-stack.ts"],"names":[],"mappings":"AAgBA,OAAO,EAAE,YAAY,EAAE,MAAM,IAAI,CAAC;AAClC,OAAO,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAC;AACzC,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEpC,eAAO,MAAM,YAAY,eAAyB,CAAC;AAEnD;;;;;;GAMG;AACH,MAAM,WAAW,YAAY;IACzB;;;OAGG;IACH,OAAO,CAAC,OAAO,EAAE,OAAO,GAAG,YAAY,CAAC,IAAI,CAAC,CAAC;IAE9C;;OAEG;IACH,IAAI,IAAI,YAAY,CAAC,IAAI,CAAC,CAAC;IAE3B;;OAEG;IACH,OAAO,IAAI,OAAO,CAAC;IAEnB;;OAEG;IACH,IAAI,IAAI,YAAY,CAAC,IAAI,CAAC,CAAC;IAE3B;;OAEG;IACH,OAAO,IAAI,OAAO,CAAC;IAEnB;;OAEG;IACH,UAAU,IAAI,IAAI,CAAC;IAEnB;;OAEG;IACH,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAE1B;;OAEG;IACH,KAAK,IAAI,IAAI,CAAC;CACjB;AAED,qBACa,mBAAoB,YAAW,YAAY;IAEpD,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC;IAEzB,SAAS,CAAC,QAAQ,EAAE,OAAO,EAAE,CAAM;IAEnC;;OAEG;IACH,SAAS,CAAC,GAAG,SAAM;IAEnB;;OAEG;IACH,SAAS,CAAC,SAAS,SAAM;IAEnB,OAAO,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;IAkBxC,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAW3B,OAAO,IAAI,OAAO;IAMZ,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAW3B,OAAO,IAAI,OAAO;IAIlB,IAAI,OAAO,IAAI,OAAO,CAErB;IAED,UAAU,IAAI,IAAI;IAIlB,KAAK,IAAI,IAAI;IAMb,SAAS,CAAC,WAAW,CAAC,KAAK,EAAE,GAAG,GAAG,KAAK;CAM3C"}

package/lib/common/command/command-stack.js

@@ -5,6 +5,9 @@ var __decorate = (this && this.__decorate) || function (decorators, target, key,
     else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
     return c > 3 && r && Object.defineProperty(target, key, r), r;
 };
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.DefaultCommandStack = exports.CommandStack = void 0;
 /********************************************************************************
@@ -23,24 +26,90 @@ exports.DefaultCommandStack = exports.CommandStack = void 0;
  * SPDX-License-Identifier: EPL-2.0 OR GPL-2.0 WITH Classpath-exception-2.0
  ********************************************************************************/
 const inversify_1 = require("inversify");
+const logger_1 = require("../utils/logger");
+const command_1 = require("./command");
 exports.CommandStack = Symbol('CommandStack');
 let DefaultCommandStack = class DefaultCommandStack {
-    execute(command) {
-        // no-op
+    constructor() {
+        this.commands = [];
+        /**
+         * The current position within the command list from which the next execute, undo, or redo, will be performed.
+         */
+        this.top = -1;
+        /**
+         * The current position within the command list when {@link DefaultCommandStack.saveIsDone} is called.
+         */
+        this.saveIndex = -1;
+    }
+    async execute(command) {
+        try {
+            await command.execute();
+        }
+        catch (error) {
+            this.handleError(error);
+        }
+        // Clear the command list past the top (i.e. the old redo list)
+        this.commands = this.commands.slice(0, this.top + 1);
+        this.commands.push(command);
+        ++this.top;
+        // if the saveIndex points to the old redo list we can never reach a state again
+        // where save is not necessary. => ensure that `isDirty` always returns true
+        if (this.saveIndex >= this.top) {
+            this.saveIndex = -2;
+        }
+    }
+    async undo() {
+        if (this.canUndo()) {
+            const command = this.commands[this.top--];
+            try {
+                await command.undo();
+            }
+            catch (error) {
+                this.handleError(error);
+            }
+        }
     }
-    undo() {
-        // no-op
+    canUndo() {
+        return this.top !== -1 //
+            ? command_1.Command.canUndo(this.commands[this.top])
+            : false;
     }
-    redo() {
-        // no-op
+    async redo() {
+        if (this.canRedo()) {
+            const command = this.commands[++this.top];
+            try {
+                await command.redo();
+            }
+            catch (error) {
+                this.handleError(error);
+            }
+        }
     }
-    isDirty() {
-        return false;
+    canRedo() {
+        return this.top < this.commands.length - 1;
+    }
+    get isDirty() {
+        return this.saveIndex !== this.top;
     }
     saveIsDone() {
-        // no-op
+        this.saveIndex = this.top;
+    }
+    flush() {
+        this.commands = [];
+        this.top = -1;
+        this.saveIndex = -1;
+    }
+    handleError(error) {
+        // if an error occurred during the command execution the stack might be in an erroneous state => we have to flush the command stack
+        this.flush();
+        this.logger.error('An error occurred during command execution. CommandStack will be flushed!', error);
+        throw error;
     }
 };
+__decorate([
+    (0, inversify_1.inject)(logger_1.Logger),
+    __metadata("design:type", logger_1.Logger)
+], DefaultCommandStack.prototype, "logger", void 0);
 DefaultCommandStack = __decorate([
     (0, inversify_1.injectable)()
 ], DefaultCommandStack);

package/lib/common/command/command-stack.js.map

@@ -1 +1 @@
-{"version":3,"file":"command-stack.js","sourceRoot":"","sources":["../../../src/common/command/command-stack.ts"],"names":[],"mappings":";;;;;;;;;AAAA;;;;;;;;;;;;;;kFAckF;AAClF,yCAAuC;AAG1B,QAAA,YAAY,GAAG,MAAM,CAAC,cAAc,CAAC,CAAC;AAmC5C,IAAM,mBAAmB,GAAzB,MAAM,mBAAmB;IAC5B,OAAO,CAAC,OAAgB;QACpB,QAAQ;IACZ,CAAC;IAED,IAAI;QACA,QAAQ;IACZ,CAAC;IAED,IAAI;QACA,QAAQ;IACZ,CAAC;IAED,OAAO;QACH,OAAO,KAAK,CAAC;IACjB,CAAC;IAED,UAAU;QACN,QAAQ;IACZ,CAAC;CACJ,CAAA;AApBY,mBAAmB;IAD/B,IAAA,sBAAU,GAAE;GACA,mBAAmB,CAoB/B;AApBY,kDAAmB"}
+{"version":3,"file":"command-stack.js","sourceRoot":"","sources":["../../../src/common/command/command-stack.ts"],"names":[],"mappings":"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"}

package/lib/common/command/command-stack.spec.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=command-stack.spec.d.ts.map

package/lib/common/command/command-stack.spec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"command-stack.spec.d.ts","sourceRoot":"","sources":["../../../src/common/command/command-stack.spec.ts"],"names":[],"mappings":""}

package/lib/common/command/command-stack.spec.js

@@ -0,0 +1,207 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+/********************************************************************************
+ * Copyright (c) 2023 EclipseSource 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 WITH Classpath-exception-2.0
+ ********************************************************************************/
+const chai_1 = require("chai");
+const inversify_1 = require("inversify");
+const sinon = require("sinon");
+const mock_util_1 = require("../test/mock-util");
+const logger_1 = require("../utils/logger");
+const command_stack_1 = require("./command-stack");
+describe('test DefaultCommandStack', () => {
+    const sandbox = sinon.createSandbox();
+    const container = new inversify_1.Container();
+    const command1 = sandbox.stub(new mock_util_1.StubCommand());
+    const command2 = sandbox.stub(new mock_util_1.StubCommand());
+    let commandStack;
+    container.load(new inversify_1.ContainerModule(bind => {
+        bind(logger_1.Logger).toConstantValue(new mock_util_1.StubLogger());
+    }));
+    commandStack = container.resolve(command_stack_1.DefaultCommandStack);
+    afterEach(() => {
+        sandbox.reset();
+        commandStack = container.resolve(command_stack_1.DefaultCommandStack);
+    });
+    describe('execute', () => {
+        it('should execute the given command and become dirty', async () => {
+            (0, chai_1.expect)(commandStack.isDirty).to.be.false;
+            await commandStack.execute(command1);
+            (0, chai_1.expect)(command1.execute.calledOnce).to.be.true;
+            (0, chai_1.expect)(commandStack.isDirty).to.be.true;
+        });
+        it('should execute the given commands in order and become dirty', async () => {
+            (0, chai_1.expect)(commandStack.isDirty).to.be.false;
+            await commandStack.execute(command1);
+            await commandStack.execute(command2);
+            (0, chai_1.expect)(command1.execute.calledOnce).to.be.true;
+            (0, chai_1.expect)(command2.execute.calledOnce).to.be.true;
+            (0, chai_1.expect)(command2.execute.calledAfter(command1.execute)).to.be.true;
+            (0, chai_1.expect)(commandStack.isDirty).to.be.true;
+        });
+        it('should be able to undo after execute', async () => {
+            (0, chai_1.expect)(commandStack.canUndo()).to.be.false;
+            await commandStack.execute(command1);
+            (0, chai_1.expect)(commandStack.canUndo()).to.be.true;
+        });
+        it('should clear the redo stack after execution', async () => {
+            commandStack['commands'].push(command2);
+            commandStack['top'] = -1;
+            (0, chai_1.expect)(commandStack.canRedo()).to.be.true;
+            await commandStack.execute(command1);
+            (0, chai_1.expect)(commandStack.canRedo()).to.be.false;
+        });
+        it('should flush the stack in case of an execution error', async () => {
+            command2.execute.throwsException();
+            const flushSpy = sandbox.spy(commandStack, 'flush');
+            await (0, mock_util_1.expectToThrowAsync)(() => commandStack.execute(command2));
+            (0, chai_1.expect)(command2.execute.calledOnce).to.be.true;
+            (0, chai_1.expect)(flushSpy.calledOnce).to.be.true;
+        });
+    });
+    describe('undo', () => {
+        it('should do nothing if the command stack is empty', async () => {
+            (0, chai_1.expect)(commandStack.isDirty).to.be.false;
+            await commandStack.undo();
+            (0, chai_1.expect)(commandStack.canUndo()).to.be.false;
+            (0, chai_1.expect)(commandStack.canRedo()).to.be.false;
+            (0, chai_1.expect)(commandStack.isDirty).to.be.false;
+        });
+        it('should undo the command and become non-dirty again', async () => {
+            commandStack['commands'].push(command1);
+            commandStack['top'] = 0;
+            (0, chai_1.expect)(commandStack.isDirty).to.be.true;
+            (0, chai_1.expect)(commandStack.canUndo()).to.be.true;
+            (0, chai_1.expect)(commandStack.canRedo()).to.be.false;
+            await commandStack.undo();
+            (0, chai_1.expect)(command1.undo.calledOnce).to.be.true;
+            (0, chai_1.expect)(commandStack.isDirty).to.be.false;
+            (0, chai_1.expect)(commandStack.canRedo()).to.be.true;
+            (0, chai_1.expect)(commandStack.canUndo()).to.be.false;
+        });
+        it('should undo multiple command and become non-dirty again', async () => {
+            commandStack['commands'].push(command1, command2);
+            commandStack['top'] = 1;
+            (0, chai_1.expect)(commandStack.isDirty).to.be.true;
+            (0, chai_1.expect)(commandStack.canUndo()).to.be.true;
+            (0, chai_1.expect)(commandStack.canRedo()).to.be.false;
+            await commandStack.undo();
+            (0, chai_1.expect)(command2.undo.calledOnce).to.be.true;
+            (0, chai_1.expect)(commandStack.canRedo()).to.be.true;
+            (0, chai_1.expect)(commandStack.canUndo()).to.be.true;
+            (0, chai_1.expect)(commandStack.isDirty).to.be.true;
+            await commandStack.undo();
+            (0, chai_1.expect)(command1.undo.calledOnce).to.be.true;
+            (0, chai_1.expect)(command1.undo.calledAfter(command2.undo)).to.be.true;
+            (0, chai_1.expect)(commandStack.isDirty).to.be.false;
+            (0, chai_1.expect)(commandStack.canRedo()).to.be.true;
+            (0, chai_1.expect)(commandStack.canUndo()).to.be.false;
+        });
+        it('should flush the stack in case of an execution error', async () => {
+            command2.undo.throwsException();
+            const flushSpy = sandbox.spy(commandStack, 'flush');
+            commandStack['commands'].push(command2);
+            commandStack['top'] = 0;
+            await (0, mock_util_1.expectToThrowAsync)(() => commandStack.undo());
+            (0, chai_1.expect)(command2.undo.calledOnce).to.be.true;
+            (0, chai_1.expect)(flushSpy.calledOnce).to.be.true;
+        });
+    });
+    describe('redo', () => {
+        it('should do nothing if the command stack is empty', async () => {
+            (0, chai_1.expect)(commandStack.isDirty).to.be.false;
+            await commandStack.redo();
+            (0, chai_1.expect)(commandStack.canUndo()).to.be.false;
+            (0, chai_1.expect)(commandStack.canRedo()).to.be.false;
+            (0, chai_1.expect)(commandStack.isDirty).to.be.false;
+        });
+        it('should redo the command and become dirty again', async () => {
+            commandStack['commands'].push(command1);
+            commandStack['top'] = -1;
+            (0, chai_1.expect)(commandStack.isDirty).to.be.false;
+            (0, chai_1.expect)(commandStack.canUndo()).to.be.false;
+            (0, chai_1.expect)(commandStack.canRedo()).to.be.true;
+            await commandStack.redo();
+            (0, chai_1.expect)(command1.redo.calledOnce).to.be.true;
+            (0, chai_1.expect)(commandStack.isDirty).to.be.true;
+            (0, chai_1.expect)(commandStack.canRedo()).to.be.false;
+            (0, chai_1.expect)(commandStack.canUndo()).to.be.true;
+        });
+        it('should undo multiple command and become non-dirty again', async () => {
+            commandStack['commands'].push(command2, command1);
+            commandStack['top'] = -1;
+            commandStack['saveIndex'] = -1;
+            (0, chai_1.expect)(commandStack.isDirty).to.be.false;
+            (0, chai_1.expect)(commandStack.canUndo()).to.be.false;
+            (0, chai_1.expect)(commandStack.canRedo()).to.be.true;
+            await commandStack.redo();
+            (0, chai_1.expect)(command2.redo.calledOnce).to.be.true;
+            (0, chai_1.expect)(commandStack.canRedo()).to.be.true;
+            (0, chai_1.expect)(commandStack.canUndo()).to.be.true;
+            (0, chai_1.expect)(commandStack.isDirty).to.be.true;
+            await commandStack.redo();
+            (0, chai_1.expect)(command1.redo.calledOnce).to.be.true;
+            (0, chai_1.expect)(command1.redo.calledAfter(command2.redo)).to.be.true;
+            (0, chai_1.expect)(commandStack.isDirty).to.be.true;
+            (0, chai_1.expect)(commandStack.canRedo()).to.be.false;
+            (0, chai_1.expect)(commandStack.canUndo()).to.be.true;
+        });
+        it('should flush the stack in case of an execution error', async () => {
+            command2.redo.throwsException();
+            const flushSpy = sandbox.spy(commandStack, 'flush');
+            commandStack['commands'].push(command2);
+            commandStack['top'] = -1;
+            await (0, mock_util_1.expectToThrowAsync)(() => commandStack.redo());
+            (0, chai_1.expect)(command2.redo.calledOnce).to.be.true;
+            (0, chai_1.expect)(flushSpy.calledOnce).to.be.true;
+        });
+        it('should be able to undo after redo', async () => {
+            commandStack['commands'].push(command1);
+            commandStack['top'] = -1;
+            (0, chai_1.expect)(commandStack.canUndo()).to.be.false;
+            await commandStack.redo();
+            (0, chai_1.expect)(commandStack.canUndo()).to.be.true;
+        });
+    });
+    describe('flush', () => {
+        it('should reset the internal state of the command stack', () => {
+            commandStack['commands'].push(command1, command1);
+            commandStack['top'] = 0;
+            commandStack.flush();
+            (0, chai_1.expect)(commandStack.isDirty).to.be.false;
+            (0, chai_1.expect)(commandStack.canUndo()).to.be.false;
+            (0, chai_1.expect)(commandStack.canRedo()).to.be.false;
+        });
+    });
+    describe('isSaveDone', () => {
+        it('should become non-dirty after execution', () => {
+            commandStack['commands'].push(command1);
+            commandStack['top'] = 0;
+            (0, chai_1.expect)(commandStack.isDirty).to.be.true;
+            commandStack.saveIsDone();
+            (0, chai_1.expect)(commandStack.isDirty).to.be.false;
+        });
+        it('should maintain undo/redo history after execution', () => {
+            commandStack['commands'].push(command1, command2);
+            commandStack['top'] = 0;
+            (0, chai_1.expect)(commandStack.canUndo()).to.be.true;
+            (0, chai_1.expect)(commandStack.canRedo()).to.be.true;
+            commandStack.saveIsDone();
+            (0, chai_1.expect)(commandStack.canUndo()).to.be.true;
+            (0, chai_1.expect)(commandStack.canRedo()).to.be.true;
+        });
+    });
+});
+//# sourceMappingURL=command-stack.spec.js.map

package/lib/common/command/command-stack.spec.js.map

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

package/lib/common/command/command.d.ts

@@ -13,25 +13,52 @@
  *
  * SPDX-License-Identifier: EPL-2.0 OR GPL-2.0 WITH Classpath-exception-2.0
  ********************************************************************************/
+import { MaybePromise } from '@eclipse-glsp/protocol';
 /**
- * An interface that every command is expected to support.
- * A command can be executed, it can be undone, and can then be redone.
+ * A command implements a specific modification of the source model, which can be applied by invoking `execute()`.
+ * Commands may also provide implementations to `undo()` and `redo()` the effect they had.
+ * To maintain an order in which commands can be undone and redone, they are managed in the context of a {@link CommandStack}.
+ *
+ * Each command is self contained and stores all the information it needs to execute, undo or redo itself.
+ *
+ * In theory commands can be used to execute arbitrary activities and not only modify the source model.
+ * However, it is mostly used to record and manage changes made to the source model via GLSP operations.
  */
 export interface Command {
     /**
-     * Performs the command activity required for the effect.
+     * Performs the command activity required for the effect (e.g. source model change).
      */
-    execute(): void;
+    execute(): MaybePromise<void>;
     /**
      * Performs the command activity required to `undo` the effects of a preceding `execute` (or `redo`).
      * The effect, if any, of calling `undo` before `execute` or `redo` have been called, is undefined.
      */
-    undo(): void;
+    undo(): MaybePromise<void>;
     /**
      * Performs the command activity required to `redo` the effect after undoing the effect.
      * The effect, if any, of calling `redo` before `undo` is called is undefined.
-     * Note that if you implement `redo` to call `execute` then any derived class will be restricted by that decision also.
      */
-    redo(): void;
+    redo(): MaybePromise<void>;
+    /**
+     * Returns whether the command can be undone.
+     * This function is optional. If not implemented, it is assumed that the command can be undone.
+     * @returns whether the command can be undone
+     */
+    canUndo?(): boolean;
+}
+export declare namespace Command {
+    function canUndo(command: Command): boolean;
+}
+/**
+ * A command that comprises a sequence of subcommands.
+ */
+export declare class CompoundCommand implements Command {
+    protected readonly commands: Command[];
+    constructor(commands: Command[]);
+    constructor(...commands: Command[]);
+    execute(): Promise<void>;
+    undo(): Promise<void>;
+    redo(): Promise<void>;
+    canUndo(): boolean;
 }
 //# sourceMappingURL=command.d.ts.map

package/lib/common/command/command.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"command.d.ts","sourceRoot":"","sources":["../../../src/common/command/command.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;kFAckF;AAElF;;;GAGG;AACH,MAAM,WAAW,OAAO;IACpB;;OAEG;IACH,OAAO,IAAI,IAAI,CAAC;IAEhB;;;OAGG;IACH,IAAI,IAAI,IAAI,CAAC;IAEb;;;;OAIG;IACH,IAAI,IAAI,IAAI,CAAC;CAChB"}
+{"version":3,"file":"command.d.ts","sourceRoot":"","sources":["../../../src/common/command/command.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;kFAckF;AAElF,OAAO,EAAwB,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAE5E;;;;;;;;;GASG;AACH,MAAM,WAAW,OAAO;IACpB;;OAEG;IACH,OAAO,IAAI,YAAY,CAAC,IAAI,CAAC,CAAC;IAE9B;;;OAGG;IACH,IAAI,IAAI,YAAY,CAAC,IAAI,CAAC,CAAC;IAE3B;;;OAGG;IACH,IAAI,IAAI,YAAY,CAAC,IAAI,CAAC,CAAC;IAE3B;;;;OAIG;IACH,OAAO,CAAC,IAAI,OAAO,CAAC;CACvB;AAED,yBAAiB,OAAO,CAAC;IACrB,SAAgB,OAAO,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAEjD;CACJ;AAED;;GAEG;AACH,qBAAa,eAAgB,YAAW,OAAO;IAC3C,SAAS,CAAC,QAAQ,CAAC,QAAQ,EAAE,OAAO,EAAE,CAAC;gBAE3B,QAAQ,EAAE,OAAO,EAAE;gBACnB,GAAG,QAAQ,EAAE,OAAO,EAAE;IAM5B,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAoBxB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAerB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAgB3B,OAAO,IAAI,OAAO;CAGrB"}

package/lib/common/command/command.js

@@ -15,4 +15,77 @@
  * SPDX-License-Identifier: EPL-2.0 OR GPL-2.0 WITH Classpath-exception-2.0
  ********************************************************************************/
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.CompoundCommand = exports.Command = void 0;
+const protocol_1 = require("@eclipse-glsp/protocol");
+var Command;
+(function (Command) {
+    function canUndo(command) {
+        var _a, _b;
+        return (_b = (_a = command.canUndo) === null || _a === void 0 ? void 0 : _a.call(command)) !== null && _b !== void 0 ? _b : true;
+    }
+    Command.canUndo = canUndo;
+})(Command = exports.Command || (exports.Command = {}));
+/**
+ * A command that comprises a sequence of subcommands.
+ */
+class CompoundCommand {
+    constructor(...commands) {
+        this.commands = [];
+        (0, protocol_1.flatPush)(this.commands, commands);
+    }
+    async execute() {
+        const alreadyExecuted = [];
+        try {
+            for (const command of this.commands) {
+                await command.execute();
+                alreadyExecuted.unshift(command);
+            }
+        }
+        catch (err) {
+            for (const command of alreadyExecuted) {
+                if (Command.canUndo(command)) {
+                    await command.undo();
+                }
+                else {
+                    break;
+                }
+            }
+            throw err;
+        }
+    }
+    async undo() {
+        const alreadyUndone = [];
+        try {
+            for (const command of [...this.commands].reverse()) {
+                await command.undo();
+                alreadyUndone.unshift(command);
+            }
+        }
+        catch (err) {
+            for (const command of alreadyUndone) {
+                await command.redo();
+            }
+            throw err;
+        }
+    }
+    async redo() {
+        const alreadyRedone = [];
+        try {
+            for (const command of this.commands) {
+                await command.redo();
+                alreadyRedone.unshift(command);
+            }
+        }
+        catch (err) {
+            for (const command of alreadyRedone) {
+                await command.undo();
+            }
+            throw err;
+        }
+    }
+    canUndo() {
+        return this.commands.every(Command.canUndo);
+    }
+}
+exports.CompoundCommand = CompoundCommand;
 //# sourceMappingURL=command.js.map

package/lib/common/command/command.js.map

@@ -1 +1 @@
-{"version":3,"file":"command.js","sourceRoot":"","sources":["../../../src/common/command/command.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;kFAckF"}
+{"version":3,"file":"command.js","sourceRoot":"","sources":["../../../src/common/command/command.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;kFAckF;;;AAElF,qDAA4E;AAsC5E,IAAiB,OAAO,CAIvB;AAJD,WAAiB,OAAO;IACpB,SAAgB,OAAO,CAAC,OAAgB;;QACpC,OAAO,MAAA,MAAA,OAAO,CAAC,OAAO,uDAAI,mCAAI,IAAI,CAAC;IACvC,CAAC;IAFe,eAAO,UAEtB,CAAA;AACL,CAAC,EAJgB,OAAO,GAAP,eAAO,KAAP,eAAO,QAIvB;AAED;;GAEG;AACH,MAAa,eAAe;IAKxB,YAAY,GAAG,QAA+B;QAC1C,IAAI,CAAC,QAAQ,GAAG,EAAE,CAAC;QACnB,IAAA,mBAAQ,EAAC,IAAI,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;IACtC,CAAC;IAED,KAAK,CAAC,OAAO;QACT,MAAM,eAAe,GAAc,EAAE,CAAC;QAEtC,IAAI;YACA,KAAK,MAAM,OAAO,IAAI,IAAI,CAAC,QAAQ,EAAE;gBACjC,MAAM,OAAO,CAAC,OAAO,EAAE,CAAC;gBACxB,eAAe,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;aACpC;SACJ;QAAC,OAAO,GAAG,EAAE;YACV,KAAK,MAAM,OAAO,IAAI,eAAe,EAAE;gBACnC,IAAI,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE;oBAC1B,MAAM,OAAO,CAAC,IAAI,EAAE,CAAC;iBACxB;qBAAM;oBACH,MAAM;iBACT;aACJ;YACD,MAAM,GAAG,CAAC;SACb;IACL,CAAC;IAED,KAAK,CAAC,IAAI;QACN,MAAM,aAAa,GAAc,EAAE,CAAC;QACpC,IAAI;YACA,KAAK,MAAM,OAAO,IAAI,CAAC,GAAG,IAAI,CAAC,QAAQ,CAAC,CAAC,OAAO,EAAE,EAAE;gBAChD,MAAM,OAAO,CAAC,IAAI,EAAE,CAAC;gBACrB,aAAa,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;aAClC;SACJ;QAAC,OAAO,GAAG,EAAE;YACV,KAAK,MAAM,OAAO,IAAI,aAAa,EAAE;gBACjC,MAAM,OAAO,CAAC,IAAI,EAAE,CAAC;aACxB;YACD,MAAM,GAAG,CAAC;SACb;IACL,CAAC;IAED,KAAK,CAAC,IAAI;QACN,MAAM,aAAa,GAAc,EAAE,CAAC;QAEpC,IAAI;YACA,KAAK,MAAM,OAAO,IAAI,IAAI,CAAC,QAAQ,EAAE;gBACjC,MAAM,OAAO,CAAC,IAAI,EAAE,CAAC;gBACrB,aAAa,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;aAClC;SACJ;QAAC,OAAO,GAAG,EAAE;YACV,KAAK,MAAM,OAAO,IAAI,aAAa,EAAE;gBACjC,MAAM,OAAO,CAAC,IAAI,EAAE,CAAC;aACxB;YACD,MAAM,GAAG,CAAC;SACb;IACL,CAAC;IAED,OAAO;QACH,OAAO,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;IAChD,CAAC;CACJ;AAhED,0CAgEC"}

package/lib/common/command/command.spec.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=command.spec.d.ts.map

package/lib/common/command/command.spec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"command.spec.d.ts","sourceRoot":"","sources":["../../../src/common/command/command.spec.ts"],"names":[],"mappings":""}