@difizen/libro-common 0.3.4 → 1.0.0

package/es/core/application/default-window-service.js

@@ -0,0 +1,83 @@
+function _typeof(o) { "@babel/helpers - typeof"; return _typeof = "function" == typeof Symbol && "symbol" == typeof Symbol.iterator ? function (o) { return typeof o; } : function (o) { return o && "function" == typeof Symbol && o.constructor === Symbol && o !== Symbol.prototype ? "symbol" : typeof o; }, _typeof(o); }
+var _dec, _class;
+function _classCallCheck(instance, Constructor) { if (!(instance instanceof Constructor)) { throw new TypeError("Cannot call a class as a function"); } }
+function _defineProperties(target, props) { for (var i = 0; i < props.length; i++) { var descriptor = props[i]; descriptor.enumerable = descriptor.enumerable || false; descriptor.configurable = true; if ("value" in descriptor) descriptor.writable = true; Object.defineProperty(target, _toPropertyKey(descriptor.key), descriptor); } }
+function _createClass(Constructor, protoProps, staticProps) { if (protoProps) _defineProperties(Constructor.prototype, protoProps); if (staticProps) _defineProperties(Constructor, staticProps); Object.defineProperty(Constructor, "prototype", { writable: false }); return Constructor; }
+function _toPropertyKey(t) { var i = _toPrimitive(t, "string"); return "symbol" == _typeof(i) ? i : String(i); }
+function _toPrimitive(t, r) { if ("object" != _typeof(t) || !t) return t; var e = t[Symbol.toPrimitive]; if (void 0 !== e) { var i = e.call(t, r || "default"); if ("object" != _typeof(i)) return i; throw new TypeError("@@toPrimitive must return a primitive value."); } return ("string" === r ? String : Number)(t); }
+import { Emitter } from "../../common/index.js";
+import { singleton } from "../../ioc/index.js";
+import { ApplicationContribution } from "./application";
+import { WindowService } from "./application-protocol";
+export var DefaultWindowService = (_dec = singleton({
+  contrib: [WindowService, ApplicationContribution]
+}), _dec(_class = /*#__PURE__*/function () {
+  function DefaultWindowService() {
+    _classCallCheck(this, DefaultWindowService);
+    this.onUnloadEmitter = new Emitter();
+  }
+  _createClass(DefaultWindowService, [{
+    key: "onUnload",
+    get: function get() {
+      return this.onUnloadEmitter.event;
+    }
+  }, {
+    key: "onStart",
+    value: function onStart(app) {
+      this.frontendApplication = app;
+      this.registerUnloadListeners();
+    }
+  }, {
+    key: "canUnload",
+    value: function canUnload() {
+      var _this$frontendApplica;
+      // eslint-disable-next-line prefer-const
+      var confirmExit = 'never';
+      // TODO: core preferrence application.confirmExit
+
+      var preventUnload = (_this$frontendApplica = this.frontendApplication) === null || _this$frontendApplica === void 0 ? void 0 : _this$frontendApplica.onWillStop();
+      preventUnload = confirmExit === 'always' || preventUnload;
+      return confirmExit === 'never' || !preventUnload;
+    }
+
+    /**
+     * Implement the mechanism to detect unloading of the page.
+     */
+  }, {
+    key: "registerUnloadListeners",
+    value: function registerUnloadListeners() {
+      var _this = this;
+      window.addEventListener('beforeunload', function (event) {
+        if (!_this.canUnload()) {
+          return _this.preventUnload(event);
+        }
+        return undefined;
+      });
+      // In a browser, `unload` is correctly fired when the page unloads, unlike Electron.
+      // If `beforeunload` is cancelled, the user will be prompted to leave or stay.
+      // If the user stays, the page won't be unloaded, so `unload` is not fired.
+      // If the user leaves, the page will be unloaded, so `unload` is fired.
+      window.addEventListener('unload', function () {
+        return _this.onUnloadEmitter.fire();
+      });
+    }
+
+    /**
+     * Notify the browser that we do not want to unload.
+     *
+     * Notes:
+     *  - Shows a confirmation popup in browsers.
+     *  - Prevents the window from closing without confirmation in electron.
+     *
+     * @param event The beforeunload event
+     */
+  }, {
+    key: "preventUnload",
+    value: function preventUnload(event) {
+      event.returnValue = '';
+      event.preventDefault();
+      return '';
+    }
+  }]);
+  return DefaultWindowService;
+}()) || _class);

package/es/core/application/index.d.ts

@@ -0,0 +1,5 @@
+import { ManaModule } from '../module';
+export * from './application';
+export * from './application-state';
+export declare const ApplicationModule: ManaModule;
+//# sourceMappingURL=index.d.ts.map

package/es/core/application/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/core/application/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAMvC,cAAc,eAAe,CAAC;AAC9B,cAAc,qBAAqB,CAAC;AAEpC,eAAO,MAAM,iBAAiB,YAEyC,CAAC"}

package/es/core/application/index.js

@@ -0,0 +1,7 @@
+import { ManaModule } from "../module";
+import { Application, ApplicationContribution } from "./application";
+import { ApplicationStateService } from "./application-state";
+import { DefaultWindowService } from "./default-window-service";
+export * from "./application";
+export * from "./application-state";
+export var ApplicationModule = ManaModule.create().contribution(ApplicationContribution).register(ApplicationStateService, Application, DefaultWindowService);

package/es/core/application/mock-window-service.d.ts

@@ -0,0 +1,8 @@
+import { Event } from '../../common/index.js';
+import type { WindowService } from './application-protocol';
+export declare class MockWindowService implements WindowService {
+    openNewWindow(): undefined;
+    canUnload(): boolean;
+    get onUnload(): Event<void>;
+}
+//# sourceMappingURL=mock-window-service.d.ts.map

package/es/core/application/mock-window-service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mock-window-service.d.ts","sourceRoot":"","sources":["../../../src/core/application/mock-window-service.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,uBAAuB,CAAC;AAG9C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAE5D,qBACa,iBAAkB,YAAW,aAAa;IACrD,aAAa,IAAI,SAAS;IAG1B,SAAS,IAAI,OAAO;IAGpB,IAAI,QAAQ,IAAI,KAAK,CAAC,IAAI,CAAC,CAE1B;CACF"}

package/es/core/application/mock-window-service.js

@@ -0,0 +1,31 @@
+function _typeof(o) { "@babel/helpers - typeof"; return _typeof = "function" == typeof Symbol && "symbol" == typeof Symbol.iterator ? function (o) { return typeof o; } : function (o) { return o && "function" == typeof Symbol && o.constructor === Symbol && o !== Symbol.prototype ? "symbol" : typeof o; }, _typeof(o); }
+var _dec, _class;
+function _classCallCheck(instance, Constructor) { if (!(instance instanceof Constructor)) { throw new TypeError("Cannot call a class as a function"); } }
+function _defineProperties(target, props) { for (var i = 0; i < props.length; i++) { var descriptor = props[i]; descriptor.enumerable = descriptor.enumerable || false; descriptor.configurable = true; if ("value" in descriptor) descriptor.writable = true; Object.defineProperty(target, _toPropertyKey(descriptor.key), descriptor); } }
+function _createClass(Constructor, protoProps, staticProps) { if (protoProps) _defineProperties(Constructor.prototype, protoProps); if (staticProps) _defineProperties(Constructor, staticProps); Object.defineProperty(Constructor, "prototype", { writable: false }); return Constructor; }
+function _toPropertyKey(t) { var i = _toPrimitive(t, "string"); return "symbol" == _typeof(i) ? i : String(i); }
+function _toPrimitive(t, r) { if ("object" != _typeof(t) || !t) return t; var e = t[Symbol.toPrimitive]; if (void 0 !== e) { var i = e.call(t, r || "default"); if ("object" != _typeof(i)) return i; throw new TypeError("@@toPrimitive must return a primitive value."); } return ("string" === r ? String : Number)(t); }
+import { Event } from "../../common/index.js";
+import { singleton } from "../../ioc/index.js";
+export var MockWindowService = (_dec = singleton(), _dec(_class = /*#__PURE__*/function () {
+  function MockWindowService() {
+    _classCallCheck(this, MockWindowService);
+  }
+  _createClass(MockWindowService, [{
+    key: "openNewWindow",
+    value: function openNewWindow() {
+      return undefined;
+    }
+  }, {
+    key: "canUnload",
+    value: function canUnload() {
+      return true;
+    }
+  }, {
+    key: "onUnload",
+    get: function get() {
+      return Event.None;
+    }
+  }]);
+  return MockWindowService;
+}()) || _class);

package/es/core/browser.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Resolves after the next animation frame if no parameter is given,
+ * or after the given number of animation frames.
+ */
+export declare function animationFrame(n?: number): Promise<void>;
+/**
+ * Parse a magnitude value (e.g. width, height, left, top) from a CSS attribute value.
+ * Returns the given default value (or undefined) if the value cannot be determined,
+ * e.g. because it is a relative value like `50%` or `auto`.
+ */
+export declare function parseCssMagnitude(value: string | null, defaultValue: number): number;
+/**
+ * Parse the number of milliseconds from a CSS time value.
+ * Returns the given default value (or undefined) if the value cannot be determined.
+ */
+export declare function parseCssTime(time: string | null, defaultValue: number): number;
+/**
+ * Prevent browser back/forward navigation of a mouse wheel event.
+ */
+export declare function preventNavigation(event: WheelEvent): void;
+//# sourceMappingURL=browser.d.ts.map

package/es/core/browser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"browser.d.ts","sourceRoot":"","sources":["../../src/core/browser.ts"],"names":[],"mappings":"AAKA;;;GAGG;AACH,wBAAgB,cAAc,CAAC,CAAC,SAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAYnD;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,EAAE,YAAY,EAAE,MAAM,GAAG,MAAM,CAAC;AAmBtF;;;GAGG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,EAAE,YAAY,EAAE,MAAM,GAAG,MAAM,CAAC;AAiDhF;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,UAAU,GAAG,IAAI,CAwCzD"}

package/es/core/browser.js

@@ -0,0 +1,118 @@
+/*---------------------------------------------------------------------------------------------
+ *  Copyright (c) Microsoft Corporation. All rights reserved.
+ *  Licensed under the MIT License. See License.txt in the project root for license information.
+ *--------------------------------------------------------------------------------------------*/
+
+/**
+ * Resolves after the next animation frame if no parameter is given,
+ * or after the given number of animation frames.
+ */
+export function animationFrame() {
+  var n = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : 1;
+  return new Promise(function (resolve) {
+    function frameFunc() {
+      if (n <= 0) {
+        resolve();
+      } else {
+        n -= 1;
+        requestAnimationFrame(frameFunc);
+      }
+    }
+    frameFunc();
+  });
+}
+
+/**
+ * Parse a magnitude value (e.g. width, height, left, top) from a CSS attribute value.
+ * Returns the given default value (or undefined) if the value cannot be determined,
+ * e.g. because it is a relative value like `50%` or `auto`.
+ */
+
+export function parseCssMagnitude(value, defaultValue) {
+  if (value) {
+    var parsed;
+    if (value.endsWith('px')) {
+      parsed = parseFloat(value.substring(0, value.length - 2));
+    } else {
+      parsed = parseFloat(value);
+    }
+    if (!Number.isNaN(parsed)) {
+      return parsed;
+    }
+  }
+  return defaultValue;
+}
+
+/**
+ * Parse the number of milliseconds from a CSS time value.
+ * Returns the given default value (or undefined) if the value cannot be determined.
+ */
+
+export function parseCssTime(time, defaultValue) {
+  if (time) {
+    var parsed;
+    if (time.endsWith('ms')) {
+      parsed = parseFloat(time.substring(0, time.length - 2));
+    } else if (time.endsWith('s')) {
+      parsed = parseFloat(time.substring(0, time.length - 1)) * 1000;
+    } else {
+      parsed = parseFloat(time);
+    }
+    if (!Number.isNaN(parsed)) {
+      return parsed;
+    }
+  }
+  return defaultValue;
+}
+function getMonacoEditorScroll(elem) {
+  var linesContent = elem.querySelector('.lines-content');
+  var viewLines = elem.querySelector('.view-lines');
+  if (linesContent === null || viewLines === null) {
+    return undefined;
+  }
+  var linesContentStyle = linesContent.style;
+  var elemStyle = elem.style;
+  var viewLinesStyle = viewLines.style;
+  return {
+    left: -parseCssMagnitude(linesContentStyle.left, 0),
+    top: -parseCssMagnitude(linesContentStyle.top, 0),
+    maxLeft: parseCssMagnitude(viewLinesStyle.width, 0) - parseCssMagnitude(elemStyle.width, 0),
+    maxTop: parseCssMagnitude(viewLinesStyle.height, 0) - parseCssMagnitude(elemStyle.height, 0)
+  };
+}
+
+/**
+ * Prevent browser back/forward navigation of a mouse wheel event.
+ */
+export function preventNavigation(event) {
+  var currentTarget = event.currentTarget,
+    deltaX = event.deltaX,
+    deltaY = event.deltaY;
+  var absDeltaX = Math.abs(deltaX);
+  var absDeltaY = Math.abs(deltaY);
+  var elem = event.target;
+  while (elem && elem !== currentTarget) {
+    var scroll = void 0;
+    if (elem.classList.contains('monaco-scrollable-element')) {
+      scroll = getMonacoEditorScroll(elem);
+    } else {
+      scroll = {
+        left: elem.scrollLeft,
+        top: elem.scrollTop,
+        maxLeft: elem.scrollWidth - elem.clientWidth,
+        maxTop: elem.scrollHeight - elem.clientHeight
+      };
+    }
+    if (scroll) {
+      var scrollH = scroll.maxLeft > 0 && (deltaX < 0 && scroll.left > 0 || deltaX > 0 && scroll.left < scroll.maxLeft);
+      var scrollV = scroll.maxTop > 0 && (deltaY < 0 && scroll.top > 0 || deltaY > 0 && scroll.top < scroll.maxTop);
+      if (scrollH && scrollV || scrollH && absDeltaX > absDeltaY || scrollV && absDeltaY > absDeltaX) {
+        // The event is consumed by the scrollable child element
+        return;
+      }
+    }
+    elem = elem.parentElement;
+  }
+  event.preventDefault();
+  event.stopPropagation();
+}

package/es/core/command/command-protocol.d.ts

@@ -0,0 +1,124 @@
+import type { Event, WaitUntilEvent } from '../../common/index.js';
+import type React from 'react';
+/**
+ * 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 type Command = {
+    /**
+     * A unique identifier of this command.
+     */
+    id: string;
+    /**
+     * A label of this command.
+     */
+    label?: string;
+    /**
+     * An icon class of this command.
+     */
+    icon?: React.ReactNode | React.FC;
+    /**
+     * A category of this command.
+     */
+    category?: string;
+};
+export declare namespace Command {
+    function is(arg: Command | any): arg is Command;
+    /** Comparator function for when sorting commands */
+    function compareCommands(a: Command, b: Command): number;
+    /**
+     * Determine if two commands are equal.
+     *
+     * @param a the first command for comparison.
+     * @param b the second command for comparison.
+     */
+    function equals(a: Command, b: Command): boolean;
+}
+export type ExecuteHandler = {
+    execute?: ((...args: any[]) => any) | undefined;
+};
+export type EnabledHandler = {
+    /**
+     * Test whether this handler is enabled (active).
+     */
+    isEnabled?: ((...args: any[]) => boolean) | undefined;
+};
+export type VisibleHandler = {
+    /**
+     * Test whether menu items for this handler should be visible.
+     */
+    isVisible?: ((...args: any[]) => boolean) | undefined;
+};
+export type ActiveHandler = {
+    /**
+     * Test whether menu items for this handler should be active.
+     */
+    isActive?: ((...args: any[]) => boolean) | undefined;
+};
+/**
+ * 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 type CommandHandler = {
+    /**
+     * Execute this handler.
+     */
+    execute: (...args: any[]) => any;
+} & EnabledHandler & ActiveHandler & VisibleHandler;
+/**
+ * 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 type CommandHandlerWithContext<T = any> = {
+    /**
+     * Execute this handler.
+     */
+    execute: (ctx: T, ...args: any[]) => any;
+    /**
+     * Test whether this handler is enabled (active).
+     */
+    isEnabled?: (ctx: T, ...args: any[]) => boolean;
+    /**
+     * Test whether menu items for this handler should be visible.
+     */
+    isVisible?: (ctx: T, ...args: any[]) => boolean;
+    /**
+     * Test whether menu items for this handler should be active.
+     */
+    isActive?: (ctx: T, ...args: any[]) => boolean;
+};
+export type CommandEvent = {
+    commandId: string;
+    args: any[];
+};
+export type WillExecuteCommandEvent = Record<any, any> & WaitUntilEvent & CommandEvent;
+export declare const CommandService: unique symbol;
+/**
+ * The command service should be used to execute commands.
+ */
+export type CommandService = {
+    /**
+     * Execute the active handler for the given command and arguments.
+     *
+     * Reject if a command cannot be executed.
+     */
+    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>;
+};
+//# sourceMappingURL=command-protocol.d.ts.map

package/es/core/command/command-protocol.d.ts.map

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

package/es/core/command/command-protocol.js

@@ -0,0 +1,44 @@
+/* eslint-disable @typescript-eslint/no-explicit-any */
+/**
+ * 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 var Command;
+(function (_Command) {
+  function is(arg) {
+    return !!arg && arg === Object(arg) && 'id' in arg;
+  }
+  _Command.is = is;
+  function compareCommands(a, b) {
+    if (a.label && b.label) {
+      var aCommand = (a.category ? "".concat(a.category, ": ").concat(a.label) : a.label).toLowerCase();
+      var bCommand = (b.category ? "".concat(b.category, ": ").concat(b.label) : b.label).toLowerCase();
+      return aCommand.localeCompare(bCommand);
+    }
+    return 0;
+  }
+  _Command.compareCommands = compareCommands;
+  function equals(a, b) {
+    return a.id === b.id && a.label === b.label && a.category === b.category;
+  }
+  _Command.equals = equals;
+})(Command || (Command = {}));
+/**
+ * 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.
+ */
+/**
+ * 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 var CommandService = Symbol('CommandService');
+/**
+ * The command service should be used to execute commands.
+ */

package/es/core/command/command-registry.d.ts

@@ -0,0 +1,144 @@
+import { Emitter, Disposable } from '../../common/index.js';
+import type { Contribution } from '../../ioc/index.js';
+import { Syringe } from '../../ioc/index.js';
+import { ApplicationContribution } from '../application/application';
+import type { CommandEvent, CommandHandler, CommandHandlerWithContext, ActiveHandler, EnabledHandler, VisibleHandler, WillExecuteCommandEvent, ExecuteHandler } from './command-protocol';
+import { Command, CommandService } from './command-protocol';
+export declare const CommandContribution: Syringe.DefinedToken;
+/**
+ * The command contribution should be implemented to register custom commands and handler.
+ */
+export type CommandContribution = {
+    /**
+     * Register commands and handlers.
+     */
+    registerCommands: (commands: CommandRegistry) => void;
+};
+/**
+ * The command registry manages commands and handlers.
+ */
+export declare class CommandRegistry implements CommandService, ApplicationContribution {
+    readonly commandMap: Record<string, Command>;
+    readonly ctxMap: Record<string, any>;
+    protected readonly _handlers: Record<string, CommandHandler[]>;
+    protected readonly toUnregisterCommands: Map<string, Disposable>;
+    protected recent: Command[];
+    protected readonly onWillExecuteCommandEmitter: Emitter<WillExecuteCommandEvent>;
+    readonly onWillExecuteCommand: import("../../common/event.js").Event<WillExecuteCommandEvent>;
+    protected readonly onDidExecuteCommandEmitter: Emitter<CommandEvent>;
+    readonly onDidExecuteCommand: import("../../common/event.js").Event<CommandEvent>;
+    protected readonly contributionProvider: Contribution.Provider<CommandContribution>;
+    constructor(contributionProvider: Contribution.Provider<CommandContribution>);
+    onStart(): void;
+    /**
+     * 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;
+    /**
+     * Register the given command with context, and handler if present.
+     *
+     * Throw if a command is already registered for the given command identifier.
+     */
+    registerCommandWithContext<T = any>(command: Command, ctx: T, handler?: CommandHandlerWithContext<T>): Disposable;
+    protected doRegisterCommandCtx(command: Command, ctx: any): Disposable;
+    protected doRegisterCommand(command: Command): Disposable;
+    /**
+     * Unregister command from the registry
+     *
+     * @param command
+     */
+    unregisterCommand(command: Command): void;
+    /**
+     * Unregister command from the registry
+     *
+     * @param id
+     */
+    unregisterCommand(id: string): void;
+    /**
+     * 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;
+    /**
+     * Test whether there is an active handler for the given command.
+     */
+    isEnabled(command: string, ...args: any[]): boolean;
+    /**
+     * Test whether there is a visible handler for the given command.
+     */
+    isVisible(command: string, ...args: any[]): boolean;
+    /**
+     * Test whether there is a active handler for the given command.
+     */
+    isActive(command: string, ...args: any[]): boolean;
+    toContextArgs(commandId: string, ...args: any[]): any[];
+    /**
+     * Test whether there is an active handler for the given command.
+     */
+    isEnabledByHandler(handler: EnabledHandler, command: string, ...args: any[]): boolean;
+    /**
+     * Test whether there is a visible handler for the given command.
+     */
+    isVisibleByHandler(handler: VisibleHandler, command: string, ...args: any[]): boolean;
+    /**
+     * Test whether there is a active handler for the given command.
+     */
+    isActiveByHandler(handler: ActiveHandler, command: string, ...args: any[]): boolean;
+    /**
+     * Execute the given handler for the given command and arguments.
+     */
+    executeCommandByHandler<T>(handler: ExecuteHandler, command: string, ...args: any[]): Promise<T | undefined>;
+    /**
+     * Execute the active handler for the given command and arguments.
+     *
+     * Reject if a command cannot be executed.
+     */
+    executeCommand<T>(commandId: string, ...args: any[]): Promise<T | undefined>;
+    protected fireWillExecuteCommand(commandId: string, args?: any[]): Promise<void>;
+    /**
+     * Get a visible handler for the given command or `undefined`.
+     */
+    getVisibleHandler(commandId: string, ...args: any[]): CommandHandler | undefined;
+    /**
+     * Get an enable handler for the given command or `undefined`.
+     */
+    getEnableHandler(commandId: string, ...args: any[]): CommandHandler | undefined;
+    /**
+     * Get an active handler for the given command or `undefined`.
+     */
+    getActiveHandler(commandId: string, ...args: any[]): CommandHandler | 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[];
+    /**
+     * Get all registered commands.
+     */
+    get commands(): Command[];
+    /**
+     * Get a command for the given command identifier.
+     */
+    getCommand(id: string): Command | undefined;
+    /**
+     * Get all registered commands identifiers.
+     */
+    get commandIds(): string[];
+    /**
+     * 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;
+    /**
+     * Clear the list of recently used commands.
+     */
+    clearCommandHistory(): void;
+}
+//# sourceMappingURL=command-registry.d.ts.map

package/es/core/command/command-registry.d.ts.map

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