@theia/core 1.45.1 → 1.46.0-next.72

package/lib/common/menu/menu.spec.js

@@ -1,70 +1,97 @@
-"use strict";
-// *****************************************************************************
-// 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
-// *****************************************************************************
-Object.defineProperty(exports, "__esModule", { value: true });
-const command_1 = require("../command");
-const menu_model_registry_1 = require("./menu-model-registry");
-const chai = require("chai");
-const expect = chai.expect;
-describe('menu-model-registry', () => {
-    describe('01 #register', () => {
-        it('Should allow to register menu actions.', () => {
-            const fileMenu = ['main', 'File'];
-            const fileOpenMenu = [...fileMenu, '0_open'];
-            const service = createMenuRegistry({
-                registerMenus(menuRegistry) {
-                    menuRegistry.registerSubmenu(fileMenu, 'File');
-                    menuRegistry.registerMenuAction(fileOpenMenu, {
-                        commandId: 'open'
-                    });
-                    menuRegistry.registerMenuAction(fileOpenMenu, {
-                        commandId: 'open.with'
-                    });
-                }
-            }, {
-                registerCommands(reg) {
-                    reg.registerCommand({
-                        id: 'open',
-                        label: 'A'
-                    });
-                    reg.registerCommand({
-                        id: 'open.with',
-                        label: 'B'
-                    });
-                }
-            });
-            const all = service.getMenu();
-            const main = all.children[0];
-            expect(main.children.length).equals(1);
-            expect(main.id, 'main');
-            expect(all.children.length).equals(1);
-            const file = main.children[0];
-            expect(file.children.length).equals(1);
-            expect(file.label, 'File');
-            const openGroup = file.children[0];
-            expect(openGroup.children.length).equals(2);
-            expect(openGroup.label).undefined;
-        });
-    });
-});
-function createMenuRegistry(menuContrib, commandContrib) {
-    const cmdReg = new command_1.CommandRegistry({ getContributions: () => [commandContrib] });
-    cmdReg.onStart();
-    const menuReg = new menu_model_registry_1.MenuModelRegistry({ getContributions: () => [menuContrib] }, cmdReg);
-    menuReg.onStart();
-    return menuReg;
-}
+"use strict";
+// *****************************************************************************
+// 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
+// *****************************************************************************
+Object.defineProperty(exports, "__esModule", { value: true });
+const chai = require("chai");
+const command_1 = require("../command");
+const composite_menu_node_1 = require("./composite-menu-node");
+const menu_model_registry_1 = require("./menu-model-registry");
+const expect = chai.expect;
+describe('menu-model-registry', () => {
+    describe('01 #register', () => {
+        it('Should allow to register menu actions.', () => {
+            const fileMenu = ['main', 'File'];
+            const fileOpenMenu = [...fileMenu, '0_open'];
+            const service = createMenuRegistry({
+                registerMenus(menuRegistry) {
+                    menuRegistry.registerSubmenu(fileMenu, 'File');
+                    menuRegistry.registerMenuAction(fileOpenMenu, {
+                        commandId: 'open'
+                    });
+                    menuRegistry.registerMenuAction(fileOpenMenu, {
+                        commandId: 'open.with'
+                    });
+                }
+            }, {
+                registerCommands(reg) {
+                    reg.registerCommand({
+                        id: 'open',
+                        label: 'A'
+                    });
+                    reg.registerCommand({
+                        id: 'open.with',
+                        label: 'B'
+                    });
+                }
+            });
+            const all = service.getMenu();
+            const main = all.children[0];
+            expect(main.children.length).equals(1);
+            expect(main.id, 'main');
+            expect(all.children.length).equals(1);
+            const file = main.children[0];
+            expect(file.children.length).equals(1);
+            expect(file.label, 'File');
+            const openGroup = file.children[0];
+            expect(openGroup.children.length).equals(2);
+            expect(openGroup.label).undefined;
+        });
+        it('Should not allow to register cyclic menus.', () => {
+            const fileMenu = ['main', 'File'];
+            const fileOpenMenu = [...fileMenu, '0_open'];
+            const fileCloseMenu = [...fileMenu, '1_close'];
+            const service = createMenuRegistry({
+                registerMenus(menuRegistry) {
+                    menuRegistry.registerSubmenu(fileMenu, 'File');
+                    // open menu should not be added to open menu
+                    menuRegistry.linkSubmenu(fileOpenMenu, fileOpenMenu);
+                    // close menu should be added
+                    menuRegistry.linkSubmenu(fileOpenMenu, fileCloseMenu);
+                }
+            }, {
+                registerCommands(reg) { }
+            });
+            const all = service.getMenu();
+            expect(menuStructureToString(all.children[0])).equals('File(0_open(1_close),1_close())');
+        });
+    });
+});
+function createMenuRegistry(menuContrib, commandContrib) {
+    const cmdReg = new command_1.CommandRegistry({ getContributions: () => [commandContrib] });
+    cmdReg.onStart();
+    const menuReg = new menu_model_registry_1.MenuModelRegistry({ getContributions: () => [menuContrib] }, cmdReg);
+    menuReg.onStart();
+    return menuReg;
+}
+function menuStructureToString(node) {
+    return node.children.map(c => {
+        if (c instanceof composite_menu_node_1.CompositeMenuNode) {
+            return `${c.id}(${menuStructureToString(c)})`;
+        }
+        return c.id;
+    }).join(',');
+}
 //# sourceMappingURL=menu.spec.js.map

package/lib/common/menu/menu.spec.js.map

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

package/lib/common/message-rpc/channel.d.ts

@@ -1,124 +1,124 @@
-import { Disposable, DisposableCollection } from '../disposable';
-import { Emitter, Event } from '../event';
-import { ReadBuffer, WriteBuffer } from './message-buffer';
-/**
- * A channel is a bidirectional communications channel with lifecycle and
- * error signalling. Note that creation of channels is specific to particular
- * implementations and thus not part of the protocol.
- */
-export interface Channel {
-    /**
-     * The remote side has closed the channel
-     */
-    onClose: Event<ChannelCloseEvent>;
-    /**
-     * An error has occurred while writing to or reading from the channel
-     */
-    onError: Event<unknown>;
-    /**
-     * A message has arrived and can be read  by listeners using a {@link MessageProvider}.
-     */
-    onMessage: Event<MessageProvider>;
-    /**
-     * Obtain a {@link WriteBuffer} to write a message to the channel.
-     */
-    getWriteBuffer(): WriteBuffer;
-    /**
-     * Close this channel. No {@link onClose} event should be sent
-     */
-    close(): void;
-}
-/**
- * The event that is emitted when a channel is closed from the remote side.
- */
-export interface ChannelCloseEvent {
-    reason: string;
-    code?: number;
-}
-/**
- * The `MessageProvider` is emitted when a channel receives a new message.
- * Listeners can invoke the provider to obtain a new {@link ReadBuffer} for the received message.
- * This ensures that each listener has its own isolated {@link ReadBuffer} instance.
- *
- */
-export declare type MessageProvider = () => ReadBuffer;
-/**
- *  Reusable abstract {@link Channel} implementation that sets up
- *  the basic channel event listeners and offers a generic close method.
- */
-export declare abstract class AbstractChannel implements Channel {
-    onCloseEmitter: Emitter<ChannelCloseEvent>;
-    get onClose(): Event<ChannelCloseEvent>;
-    onErrorEmitter: Emitter<unknown>;
-    get onError(): Event<unknown>;
-    onMessageEmitter: Emitter<MessageProvider>;
-    get onMessage(): Event<MessageProvider>;
-    protected toDispose: DisposableCollection;
-    constructor();
-    close(): void;
-    abstract getWriteBuffer(): WriteBuffer;
-}
-/**
- * A very basic {@link AbstractChannel} implementation which takes a function
- * for retrieving the {@link WriteBuffer} as constructor argument.
- */
-export declare class BasicChannel extends AbstractChannel {
-    protected writeBufferProvider: () => WriteBuffer;
-    constructor(writeBufferProvider: () => WriteBuffer);
-    getWriteBuffer(): WriteBuffer;
-}
-/**
- * Helper class to implement the single channels on a {@link ChannelMultiplexer}. Simply forwards write requests to
- * the given write buffer source i.e. the main channel of the {@link ChannelMultiplexer}.
- */
-export declare class ForwardingChannel extends AbstractChannel {
-    readonly id: string;
-    protected readonly closeHandler: () => void;
-    protected readonly writeBufferSource: () => WriteBuffer;
-    constructor(id: string, closeHandler: () => void, writeBufferSource: () => WriteBuffer);
-    getWriteBuffer(): WriteBuffer;
-    close(): void;
-}
-/**
- * The different message types used in the messaging protocol of the {@link ChannelMultiplexer}
- */
-export declare enum MessageTypes {
-    Open = 1,
-    Close = 2,
-    AckOpen = 3,
-    Data = 4
-}
-/**
- * The write buffers in this implementation immediately write to the underlying
- * channel, so we rely on writers to the multiplexed channels to always commit their
- * messages and always in one go.
- */
-export declare class ChannelMultiplexer implements Disposable {
-    protected readonly underlyingChannel: Channel;
-    protected pendingOpen: Map<string, (channel: ForwardingChannel) => void>;
-    protected openChannels: Map<string, ForwardingChannel>;
-    protected readonly onOpenChannelEmitter: Emitter<{
-        id: string;
-        channel: Channel;
-    }>;
-    get onDidOpenChannel(): Event<{
-        id: string;
-        channel: Channel;
-    }>;
-    protected toDispose: DisposableCollection;
-    constructor(underlyingChannel: Channel);
-    protected handleError(error: unknown): void;
-    onUnderlyingChannelClose(event?: ChannelCloseEvent): void;
-    protected handleMessage(buffer: ReadBuffer): void;
-    protected handleAckOpen(id: string): void;
-    protected handleOpen(id: string): void;
-    protected handleClose(id: string): void;
-    protected handleData(id: string, data: ReadBuffer): void;
-    protected createChannel(id: string): ForwardingChannel;
-    protected prepareWriteBuffer(id: string): WriteBuffer;
-    protected closeChannel(id: string): void;
-    open(id: string): Promise<Channel>;
-    getOpenChannel(id: string): Channel | undefined;
-    dispose(): void;
-}
+import { Disposable, DisposableCollection } from '../disposable';
+import { Emitter, Event } from '../event';
+import { ReadBuffer, WriteBuffer } from './message-buffer';
+/**
+ * A channel is a bidirectional communications channel with lifecycle and
+ * error signalling. Note that creation of channels is specific to particular
+ * implementations and thus not part of the protocol.
+ */
+export interface Channel {
+    /**
+     * The remote side has closed the channel
+     */
+    onClose: Event<ChannelCloseEvent>;
+    /**
+     * An error has occurred while writing to or reading from the channel
+     */
+    onError: Event<unknown>;
+    /**
+     * A message has arrived and can be read  by listeners using a {@link MessageProvider}.
+     */
+    onMessage: Event<MessageProvider>;
+    /**
+     * Obtain a {@link WriteBuffer} to write a message to the channel.
+     */
+    getWriteBuffer(): WriteBuffer;
+    /**
+     * Close this channel. No {@link onClose} event should be sent
+     */
+    close(): void;
+}
+/**
+ * The event that is emitted when a channel is closed from the remote side.
+ */
+export interface ChannelCloseEvent {
+    reason: string;
+    code?: number;
+}
+/**
+ * The `MessageProvider` is emitted when a channel receives a new message.
+ * Listeners can invoke the provider to obtain a new {@link ReadBuffer} for the received message.
+ * This ensures that each listener has its own isolated {@link ReadBuffer} instance.
+ *
+ */
+export declare type MessageProvider = () => ReadBuffer;
+/**
+ *  Reusable abstract {@link Channel} implementation that sets up
+ *  the basic channel event listeners and offers a generic close method.
+ */
+export declare abstract class AbstractChannel implements Channel {
+    onCloseEmitter: Emitter<ChannelCloseEvent>;
+    get onClose(): Event<ChannelCloseEvent>;
+    onErrorEmitter: Emitter<unknown>;
+    get onError(): Event<unknown>;
+    onMessageEmitter: Emitter<MessageProvider>;
+    get onMessage(): Event<MessageProvider>;
+    protected toDispose: DisposableCollection;
+    constructor();
+    close(): void;
+    abstract getWriteBuffer(): WriteBuffer;
+}
+/**
+ * A very basic {@link AbstractChannel} implementation which takes a function
+ * for retrieving the {@link WriteBuffer} as constructor argument.
+ */
+export declare class BasicChannel extends AbstractChannel {
+    protected writeBufferProvider: () => WriteBuffer;
+    constructor(writeBufferProvider: () => WriteBuffer);
+    getWriteBuffer(): WriteBuffer;
+}
+/**
+ * Helper class to implement the single channels on a {@link ChannelMultiplexer}. Simply forwards write requests to
+ * the given write buffer source i.e. the main channel of the {@link ChannelMultiplexer}.
+ */
+export declare class ForwardingChannel extends AbstractChannel {
+    readonly id: string;
+    protected readonly closeHandler: () => void;
+    protected readonly writeBufferSource: () => WriteBuffer;
+    constructor(id: string, closeHandler: () => void, writeBufferSource: () => WriteBuffer);
+    getWriteBuffer(): WriteBuffer;
+    close(): void;
+}
+/**
+ * The different message types used in the messaging protocol of the {@link ChannelMultiplexer}
+ */
+export declare enum MessageTypes {
+    Open = 1,
+    Close = 2,
+    AckOpen = 3,
+    Data = 4
+}
+/**
+ * The write buffers in this implementation immediately write to the underlying
+ * channel, so we rely on writers to the multiplexed channels to always commit their
+ * messages and always in one go.
+ */
+export declare class ChannelMultiplexer implements Disposable {
+    protected readonly underlyingChannel: Channel;
+    protected pendingOpen: Map<string, (channel: ForwardingChannel) => void>;
+    protected openChannels: Map<string, ForwardingChannel>;
+    protected readonly onOpenChannelEmitter: Emitter<{
+        id: string;
+        channel: Channel;
+    }>;
+    get onDidOpenChannel(): Event<{
+        id: string;
+        channel: Channel;
+    }>;
+    protected toDispose: DisposableCollection;
+    constructor(underlyingChannel: Channel);
+    protected handleError(error: unknown): void;
+    onUnderlyingChannelClose(event?: ChannelCloseEvent): void;
+    protected handleMessage(buffer: ReadBuffer): void;
+    protected handleAckOpen(id: string): void;
+    protected handleOpen(id: string): void;
+    protected handleClose(id: string): void;
+    protected handleData(id: string, data: ReadBuffer): void;
+    protected createChannel(id: string): ForwardingChannel;
+    protected prepareWriteBuffer(id: string): WriteBuffer;
+    protected closeChannel(id: string): void;
+    open(id: string): Promise<Channel>;
+    getOpenChannel(id: string): Channel | undefined;
+    dispose(): void;
+}
 //# sourceMappingURL=channel.d.ts.map