@api-client/ui 0.5.39 → 0.5.41

package/build/src/elements/contextual-menu/{internals/ContextualMenu.d.ts → ContextualMenu.d.ts}

@@ -1,8 +1,9 @@
-import { MenuItem } from './MenuItem.js';
-import type { CommandBase, ContextMenuCommand, CustomMenuEventDetail, MenuOptions, MenuPoint, MenuTriggerInfo } from './types.js';
-import type ContextMenuElement from './ContextualMenuElement.js';
+import { MenuItem } from './internals/MenuItem.js';
+import type { CommandBase, ContextMenuCommand, CustomMenuEventDetail, MenuOptions, MenuPoint, MenuTriggerInfo } from './internals/types.js';
+import type ContextMenuElement from './internals/ContextualMenuElement.js';
 import { Logger, ILogObj } from 'tslog';
-import '../contextual-menu.js';
+export type * from './internals/types.js';
+import './contextual-menu.js';
 /**
  * The base class for the context menu. It can be used as is but in some specific cases
  * you may want to extend this class to be able to find command target accurately.
@@ -92,11 +93,11 @@ export declare class ContextualMenu<S = unknown> extends EventTarget {
      * Register a list of commands to be rendered in the menu when triggered.
      * This overrides previously registered commands.
      */
-    registerCommands(commands: CommandBase<S>[]): void;
+    registerCommands(commands: (CommandBase<S> | ContextMenuCommand<S>)[]): void;
     /**
      * Adds a single command to the menu.
      */
-    addCommand(command: CommandBase<S>): void;
+    addCommand(command: CommandBase<S> | ContextMenuCommand<S>): void;
     /**
      * Prepares incoming commands for the internal use.
      * @param commands - The commands to process.
@@ -113,6 +114,10 @@ export declare class ContextualMenu<S = unknown> extends EventTarget {
      * @param customData Any data to set on the instance to pass to the `execute` and `enabled` functions.
      */
     build(target: HTMLElement | SVGElement, name: string, placementPoint: MenuPoint, targetPoint: MenuPoint, customData?: unknown): boolean;
+    /**
+     * A lifecycle method called before the `render()` method.
+     */
+    protected beforeRender(): void;
     /**
      * @param placementPoint The workspace position of where to place the menu.
      * @param commands The commands render

package/build/src/elements/contextual-menu/ContextualMenu.d.ts.map

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

package/build/src/elements/contextual-menu/{internals/ContextualMenu.js → ContextualMenu.js}

@@ -1,7 +1,7 @@
-import { MenuItem } from './MenuItem.js';
-import { genId } from './IdGenerator.js';
+import { MenuItem } from './internals/MenuItem.js';
+import { genId } from './internals/IdGenerator.js';
 import { Logger } from 'tslog';
-import '../contextual-menu.js';
+import './contextual-menu.js';
 function cancelEvent(e) {
     e.preventDefault();
     e.stopPropagation();
@@ -292,10 +292,32 @@ export class ContextualMenu extends EventTarget {
             customData,
             target,
         };
+        this.beforeRender();
         this.render(placementPoint, commands);
         target.setAttribute('active', '');
         return true;
     }
+    /**
+     * A lifecycle method called before the `render()` method.
+     */
+    beforeRender() {
+        const { beforeRender } = this.options;
+        if (!beforeRender) {
+            return;
+        }
+        const context = {
+            store: this.store,
+            target: this.triggerInfo?.target || this.workspace,
+            root: this.workspace,
+            customData: this.triggerInfo?.customData,
+        };
+        try {
+            beforeRender(context);
+        }
+        catch {
+            // ...
+        }
+    }
     /**
      * @param placementPoint The workspace position of where to place the menu.
      * @param commands The commands render

package/build/src/elements/contextual-menu/ContextualMenu.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ContextualMenu.js","sourceRoot":"","sources":["../../../../src/elements/contextual-menu/ContextualMenu.ts"],"names":[],"mappings":"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","sourcesContent":["import { MenuItem } from './internals/MenuItem.js'\nimport { genId } from './internals/IdGenerator.js'\nimport type {\n  CommandBase,\n  ContextMenuCommand,\n  ContextMenuExecuteDetail,\n  CustomMenuEventDetail,\n  MenuContext,\n  MenuOptions,\n  MenuPoint,\n  MenuTriggerInfo,\n} from './internals/types.js'\nimport type ContextMenuElement from './internals/ContextualMenuElement.js'\nimport { Logger, ILogObj } from 'tslog'\nexport type * from './internals/types.js'\n\nimport './contextual-menu.js'\n\nfunction cancelEvent(e: Event): void {\n  e.preventDefault()\n  e.stopPropagation()\n}\n\n/**\n * The base class for the context menu. It can be used as is but in some specific cases\n * you may want to extend this class to be able to find command target accurately.\n *\n * @template S - The definition of the store passed to commands.\n */\nexport class ContextualMenu<S = unknown> extends EventTarget {\n  #connectedValue = false\n\n  /**\n   * @returns true when the menu is connected to the `workspace`.\n   */\n  get connected(): boolean {\n    return this.#connectedValue\n  }\n\n  /**\n   * The store initialized with this context menu. Passed to the lifecycle functions.\n   */\n  store: S = {} as S\n\n  /**\n   * The root level menu commands\n   */\n  commands: MenuItem<S>[] = []\n\n  /**\n   * An information about the trigger that initialized this menu.\n   */\n  triggerInfo?: MenuTriggerInfo\n\n  /**\n   * The Menu configuration options.\n   */\n  options: MenuOptions\n\n  currentMenu?: ContextMenuElement<S>\n\n  #debug = false\n\n  get debug(): boolean {\n    return this.#debug\n  }\n\n  set debug(value: boolean) {\n    if (this.#debug === value) {\n      return\n    }\n    this.#debug = value\n    if (this.logger) {\n      this.logger.settings.minLevel = value ? 0 : 4\n    }\n  }\n\n  protected logger: Logger<ILogObj>\n\n  /**\n   * @param workspace The root element that is the click handler\n   * @param opts The Menu configuration options.\n   */\n  constructor(\n    public workspace: HTMLElement,\n    opts: MenuOptions = {}\n  ) {\n    super()\n\n    this.options = { ...opts }\n\n    this.logger = new Logger({ minLevel: this.debug ? 0 : 4, name: 'context-menu', hideLogPositionForProduction: true })\n\n    this.contextHandler = this.contextHandler.bind(this)\n    this.clickHandler = this.clickHandler.bind(this)\n    this.keydownHandler = this.keydownHandler.bind(this)\n    this.customMenuHandler = this.customMenuHandler.bind(this)\n    this.menuTriggerHandler = this.menuTriggerHandler.bind(this)\n  }\n\n  /**\n   * Starts listening on user events\n   */\n  connect(): void {\n    this.logger.debug('Connecting contextual menu...')\n    this.workspace.addEventListener('contextmenu', this.contextHandler)\n    this.workspace.addEventListener('custommenu', this.customMenuHandler as EventListener)\n    window.addEventListener('click', this.clickHandler)\n    window.addEventListener('keydown', this.keydownHandler)\n    this.#connectedValue = true\n  }\n\n  /**\n   * Cleans up the listeners\n   */\n  disconnect(): void {\n    this.logger.debug('Disconnecting contextual menu...')\n    this.workspace.removeEventListener('contextmenu', this.contextHandler)\n    this.workspace.removeEventListener('custommenu', this.customMenuHandler as EventListener)\n    window.removeEventListener('click', this.clickHandler)\n    window.removeEventListener('keydown', this.keydownHandler)\n    this.#connectedValue = false\n  }\n\n  /**\n   * Reads {x,y} point of the click from the pointer event.\n   *\n   * Override this method to customize position reading.\n   */\n  readTargetClickPosition(e: MouseEvent): MenuPoint {\n    const result: MenuPoint = {\n      x: e.clientX,\n      y: e.clientY,\n    }\n    this.logger.debug('readTargetClickPosition result:', result)\n    return result\n  }\n\n  /**\n   * Override this method to customize finding event click target.\n   * @param e Finds the click target from the event\n   */\n  findTarget(e: MouseEvent): HTMLElement | SVGElement | undefined {\n    this.logger.debug('findTarget results with \"e.target\"')\n    return e.target as HTMLElement | SVGElement | undefined\n  }\n\n  /**\n   * Maps an element to the target name used by the commands.\n   * By default it returns `root` when the click target element is the `workspace` or\n   * a combination of element name and list of all classes otherwise.\n   *\n   * Override this method to customize target name reading.\n   *\n   * @param element The context click target\n   * @returns The target name.\n   */\n  elementToTarget(element: HTMLElement | SVGElement): string | undefined {\n    if (element === this.workspace) {\n      this.logger.debug('elementToTarget result:', 'root')\n      return 'root'\n    }\n    if (!element.localName) {\n      this.logger.debug('elementToTarget result:', undefined)\n      return undefined\n    }\n    let name = element.localName\n    const cls = Array.from(element.classList).join('.')\n    if (cls) {\n      name += `.${cls}`\n    }\n    this.logger.debug('elementToTarget result:', name)\n    return name\n  }\n\n  /**\n   * Handler for the context menu event.\n   */\n  protected contextHandler(e: MouseEvent): void {\n    // if (!this.options.cancelNativeWhenHandled) {\n    //   cancelEvent(e);\n    // }\n    this.destroy()\n    const target = this.findTarget(e)\n    if (!target) {\n      return\n    }\n    const name = this.elementToTarget(target)\n    this.logger.debug('contextHandler', 'target:', target.localName, 'name:', name)\n    if (!name) {\n      return\n    }\n    // since the context menu has fixed position it doesn't matter what the context\n    // is as the menu is rendered over all elements.\n    // The `readTargetClickPosition()` is used to determine click target for the commands.\n    const clickPoint = {\n      x: e.clientX,\n      y: e.clientY,\n    }\n    const targetPoint = this.readTargetClickPosition(e)\n    const rendered = this.build(target, name, clickPoint, targetPoint)\n    if (rendered) {\n      cancelEvent(e)\n    } else if (this.options.cancelNativeWhenHandled) {\n      cancelEvent(e)\n    }\n  }\n\n  /**\n   * A handler for the `custommenu` event handler to trigger the menu without the user interaction.\n   */\n  protected customMenuHandler(e: CustomEvent<CustomMenuEventDetail>): void {\n    cancelEvent(e)\n    const { name, x = 0, y = 0, actionTarget = this.workspace, clickEvent, customData } = e.detail\n    const clickPoint = {\n      x,\n      y,\n    }\n    const targetPoint = clickEvent ? this.readTargetClickPosition(clickEvent) : clickPoint\n    this.build(actionTarget, name, clickPoint, targetPoint, customData)\n  }\n\n  /**\n   * Handles the click event on the document to close the menu is the click\n   * is outside the menu.\n   */\n  protected clickHandler(e: MouseEvent): void {\n    if (!this.currentMenu || e.defaultPrevented) {\n      return\n    }\n    const elm = e.target as Element\n    const inside = this.currentMenu.contains(elm)\n    if (!inside) {\n      this.logger.debug('Click outside the menu. Destroing...')\n      this.destroy()\n    }\n  }\n\n  /**\n   * Closes the menu when ESC is pressed\n   */\n  protected keydownHandler(e: KeyboardEvent): void {\n    if (e.key === 'Escape' && this.currentMenu) {\n      this.logger.debug('Escape key detected. Destroing the menu...')\n      this.destroy()\n    }\n  }\n\n  /**\n   * Register a list of commands to be rendered in the menu when triggered.\n   * This overrides previously registered commands.\n   */\n  registerCommands(commands: (CommandBase<S> | ContextMenuCommand<S>)[]): void {\n    if (!Array.isArray(commands) || !commands.length) {\n      this.logger.warn('registerCommands called with empty array')\n      return\n    }\n    this.commands = this.prepareCommands(commands)\n  }\n\n  /**\n   * Adds a single command to the menu.\n   */\n  addCommand(command: CommandBase<S> | ContextMenuCommand<S>): void {\n    if (!this.commands) {\n      this.commands = []\n    }\n    const item = this.prepareCommands([command])[0]\n    this.commands.push(item)\n  }\n\n  /**\n   * Prepares incoming commands for the internal use.\n   * @param commands - The commands to process.\n   */\n  protected prepareCommands(commands: CommandBase<S>[]): MenuItem<S>[] {\n    const result: MenuItem<S>[] = []\n    commands.forEach((item) => {\n      if (!item) {\n        return\n      }\n      const { type = 'normal' } = item\n      switch (type) {\n        case 'separator':\n          result.push(new MenuItem(item))\n          break\n        case 'label':\n          result.push(new MenuItem(item))\n          break\n        case 'normal':\n        case 'radio':\n          {\n            const normalized = this.normalizeMenuItem(item as ContextMenuCommand<S>)\n            result.push(new MenuItem(normalized))\n          }\n          break\n        default:\n      }\n    })\n    return result\n  }\n\n  protected normalizeMenuItem(item: ContextMenuCommand<S>): ContextMenuCommand<S> {\n    const cp = { ...item }\n    if (!cp.id) {\n      cp.id = genId()\n    }\n    if (Array.isArray(cp.children) && cp.children.length) {\n      cp.children = this.prepareCommands(cp.children)\n    } else if (cp.children) {\n      cp.children = undefined\n    }\n    return cp\n  }\n\n  /**\n   * Builds the menu for the target.\n   *\n   * @param target The element that triggered the menu\n   * @param name The `target` name declared in the commands.\n   * @param placementPoint The workspace position of where to place the menu.\n   * @param targetPoint The workspace position of the click target\n   * @param customData Any data to set on the instance to pass to the `execute` and `enabled` functions.\n   */\n  build(\n    target: HTMLElement | SVGElement,\n    name: string,\n    placementPoint: MenuPoint,\n    targetPoint: MenuPoint,\n    customData?: unknown\n  ): boolean {\n    this.triggerInfo = undefined\n    const commands = this.listCommands(name, target)\n    this.logger.debug('build', 'commands discovered', commands.length)\n    if (!commands.length) {\n      return false\n    }\n    this.triggerInfo = {\n      point: targetPoint,\n      customData,\n      target,\n    }\n    this.beforeRender()\n    this.render(placementPoint, commands)\n    target.setAttribute('active', '')\n    return true\n  }\n\n  /**\n   * A lifecycle method called before the `render()` method.\n   */\n  protected beforeRender(): void {\n    const { beforeRender } = this.options\n    if (!beforeRender) {\n      return\n    }\n    const context: MenuContext = {\n      store: this.store,\n      target: this.triggerInfo?.target || this.workspace,\n      root: this.workspace,\n      customData: this.triggerInfo?.customData,\n    }\n    try {\n      beforeRender(context)\n    } catch {\n      // ...\n    }\n  }\n\n  /**\n   * @param placementPoint The workspace position of where to place the menu.\n   * @param commands The commands render\n   */\n  render(placementPoint: MenuPoint, commands: MenuItem<S>[]): void {\n    const { workspace } = this\n    const menu = document.createElement('contextual-menu') as unknown as ContextMenuElement<S>\n    menu.store = this.store\n    menu.target = this.triggerInfo?.target\n    menu.customData = this.triggerInfo?.customData\n    menu.workspace = workspace\n    menu.classList.add('context-menu')\n    menu.commands = commands\n    menu.style.top = `${placementPoint.y}px`\n    menu.style.left = `${placementPoint.x}px`\n    menu.setAttribute('tabindex', '0')\n\n    if (workspace.shadowRoot) {\n      workspace.shadowRoot.append(menu)\n    } else {\n      this.workspace.append(menu)\n    }\n    this.currentMenu = menu\n    menu.focus()\n    menu.addEventListener('trigger', this.menuTriggerHandler as EventListener)\n  }\n\n  /**\n   * Lists all commands that matches the target.\n   *\n   * @param targetName The build target name\n   * @param targetElement The element that triggered the menu\n   */\n  listCommands(targetName: string, targetElement: HTMLElement | SVGElement): MenuItem<S>[] {\n    this.logger.debug('listCommands')\n    const { commands = [] } = this\n    const result: MenuItem<S>[] = []\n    const filter = ['all', targetName]\n    this.logger.debug('listCommands', 'filter:', filter)\n    commands.forEach((cmd) => {\n      this.logger.silly('listCommands', 'matching tharget', cmd.target)\n      if (Array.isArray(cmd.target)) {\n        const hasTarget = cmd.target.some((item) => filter.includes(item))\n        if (hasTarget) {\n          result.push(cmd)\n        }\n      } else if (filter.includes(cmd.target || '')) {\n        result.push(cmd)\n      } else {\n        try {\n          if (targetElement.matches(cmd.target || '')) {\n            result.push(cmd)\n          }\n        } catch {\n          //\n        }\n      }\n    })\n    return result\n  }\n\n  /**\n   * Removes the currently rendered menu.\n   */\n  destroy(): void {\n    if (!this.currentMenu) {\n      return\n    }\n    ;(this.triggerInfo as MenuTriggerInfo).target.removeAttribute('active')\n    this.triggerInfo = undefined\n    const { workspace } = this\n    if (workspace.shadowRoot) {\n      workspace.shadowRoot.removeChild(this.currentMenu)\n    } else {\n      workspace.removeChild(this.currentMenu)\n    }\n    this.currentMenu.removeEventListener('trigger', this.menuTriggerHandler as EventListener)\n    this.currentMenu = undefined\n  }\n\n  /**\n   * Handler for the `trigger` event dispatched by the menu\n   */\n  protected menuTriggerHandler(e: CustomEvent): void {\n    const { item, command, parent } = e.detail\n    const cmd = command as MenuItem\n    const parentCommand = parent as MenuItem\n    const { triggerInfo, workspace, store } = this\n    const { point, target, customData } = triggerInfo as MenuTriggerInfo\n    this.destroy()\n    if (parentCommand && parentCommand.execute && !cmd.execute) {\n      parentCommand.trigger(cmd, store, target, workspace, point, customData, item)\n    } else if (cmd.execute) {\n      cmd.trigger(cmd, store, target, workspace, point, customData)\n    } else {\n      const detail: ContextMenuExecuteDetail = {\n        id: cmd.id,\n        store,\n        target,\n        root: workspace,\n        clickPoint: point,\n        customData,\n        selectedSubcommand: item,\n        item: cmd,\n      }\n      this.dispatchEvent(\n        new CustomEvent('execute', {\n          detail,\n        })\n      )\n    }\n  }\n}\n"]}

package/build/src/elements/contextual-menu/internals/types.d.ts

@@ -12,16 +12,19 @@ export interface MenuOptions {
      * would render this context menu and in another system's & browser context menu.
      */
     cancelNativeWhenHandled?: boolean;
+    /**
+     * Called before the menu is rendered.
+     * Specifically, it is called right before the internal `render()` method is called.
+     * It doesn't allow you to modify the menu items, but you can perform any setup
+     * before the menu is rendered.
+     */
+    beforeRender?: (ctx: MenuContext) => void;
 }
 export interface MenuPoint {
     x: number;
     y: number;
 }
-interface LifecycleContext<S> {
-    /**
-     * The id of the command.
-     */
-    id: string;
+export interface MenuContext<S = unknown> {
     /**
      * The object store to be used to store menu item data.
      */
@@ -39,14 +42,20 @@ interface LifecycleContext<S> {
      */
     customData?: unknown;
 }
+interface LifecycleContext<S = unknown> extends MenuContext<S> {
+    /**
+     * The id of the command.
+     */
+    id: string;
+}
 export interface EnabledMenuOptions<S = unknown> extends LifecycleContext<S> {
 }
-export interface CheckedMenuOptions<S> extends LifecycleContext<S> {
+export interface CheckedMenuOptions<S = unknown> extends LifecycleContext<S> {
 }
 /**
  * Options passed to the `visible()` callback function.
  */
-export type VisibleOptions<S> = EnabledMenuOptions<S>;
+export type VisibleOptions<S = unknown> = EnabledMenuOptions<S>;
 export interface CommandExecuteOptions<S = unknown> extends LifecycleContext<S> {
     /**
      * The point of the original click.

package/build/src/elements/contextual-menu/internals/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../../src/elements/contextual-menu/internals/types.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../../src/elements/contextual-menu/internals/types.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,KAAK,CAAA;AAC5C,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAA;AAE7C,MAAM,MAAM,YAAY,GAAG,QAAQ,GAAG,WAAW,GAAG,OAAO,GAAG,OAAO,CAAA;AAErE,MAAM,WAAW,WAAW;IAC1B;;;;;;;;OAQG;IACH,uBAAuB,CAAC,EAAE,OAAO,CAAA;IACjC;;;;;OAKG;IACH,YAAY,CAAC,EAAE,CAAC,GAAG,EAAE,WAAW,KAAK,IAAI,CAAA;CAC1C;AAED,MAAM,WAAW,SAAS;IACxB,CAAC,EAAE,MAAM,CAAA;IACT,CAAC,EAAE,MAAM,CAAA;CACV;AAED,MAAM,WAAW,WAAW,CAAC,CAAC,GAAG,OAAO;IACtC;;OAEG;IACH,KAAK,EAAE,CAAC,CAAA;IACR;;OAEG;IACH,MAAM,EAAE,WAAW,GAAG,UAAU,CAAA;IAChC;;OAEG;IACH,IAAI,EAAE,WAAW,CAAA;IACjB;;OAEG;IACH,UAAU,CAAC,EAAE,OAAO,CAAA;CACrB;AAED,UAAU,gBAAgB,CAAC,CAAC,GAAG,OAAO,CAAE,SAAQ,WAAW,CAAC,CAAC,CAAC;IAC5D;;OAEG;IACH,EAAE,EAAE,MAAM,CAAA;CACX;AAED,MAAM,WAAW,kBAAkB,CAAC,CAAC,GAAG,OAAO,CAAE,SAAQ,gBAAgB,CAAC,CAAC,CAAC;CAAG;AAE/E,MAAM,WAAW,kBAAkB,CAAC,CAAC,GAAG,OAAO,CAAE,SAAQ,gBAAgB,CAAC,CAAC,CAAC;CAAG;AAE/E;;GAEG;AACH,MAAM,MAAM,cAAc,CAAC,CAAC,GAAG,OAAO,IAAI,kBAAkB,CAAC,CAAC,CAAC,CAAA;AAE/D,MAAM,WAAW,qBAAqB,CAAC,CAAC,GAAG,OAAO,CAAE,SAAQ,gBAAgB,CAAC,CAAC,CAAC;IAC7E;;OAEG;IACH,UAAU,EAAE,SAAS,CAAA;IACrB;;;;OAIG;IACH,kBAAkB,CAAC,EAAE,MAAM,CAAA;IAC3B;;OAEG;IACH,IAAI,EAAE,QAAQ,CAAC,CAAC,CAAC,CAAA;CAClB;AAED,MAAM,WAAW,mBAAmB,CAAC,CAAC,GAAG,OAAO,CAAE,SAAQ,gBAAgB,CAAC,CAAC,CAAC;IAC3E;;OAEG;IACH,IAAI,EAAE,QAAQ,CAAC,CAAC,CAAC,CAAA;CAClB;AAED,MAAM,WAAW,WAAW,CAAC,CAAC,GAAG,OAAO;IACtC;;;;OAIG;IACH,EAAE,CAAC,EAAE,MAAM,CAAA;IACX;;;;;;OAMG;IACH,IAAI,CAAC,EAAE,YAAY,CAAA;IACnB;;;;;;;;;;;OAWG;IACH,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,KAAK,GAAG,MAAM,CAAA;IAC3C;;;;OAIG;IACH,OAAO,CAAC,EAAE,OAAO,GAAG,CAAC,CAAC,IAAI,EAAE,cAAc,CAAC,CAAC,CAAC,KAAK,OAAO,CAAC,CAAA;CAC3D;AAED,MAAM,WAAW,kBAAkB,CAAC,CAAC,GAAG,OAAO,CAAE,SAAQ,WAAW,CAAC,CAAC,CAAC;IACrE;;OAEG;IACH,KAAK,CAAC,EAAE,MAAM,CAAA;IACd;;OAEG;IACH,KAAK,CAAC,EAAE,MAAM,CAAA;IACd;;;OAGG;IACH,IAAI,CAAC,EAAE,iBAAiB,CAAA;IACxB;;;;;;;OAOG;IACH,QAAQ,CAAC,EAAE,CAAC,kBAAkB,CAAC,CAAC,CAAC,GAAG,WAAW,CAAC,CAAC,CAAC,CAAC,EAAE,CAAA;IACrD;;;;OAIG;IACH,OAAO,CAAC,EAAE,OAAO,GAAG,CAAC,CAAC,IAAI,EAAE,kBAAkB,CAAC,CAAC,CAAC,KAAK,OAAO,CAAC,CAAA;IAC9D;;;;;OAKG;IACH,OAAO,CAAC,EAAE,OAAO,GAAG,CAAC,CAAC,IAAI,EAAE,kBAAkB,CAAC,CAAC,CAAC,KAAK,OAAO,CAAC,CAAA;IAC9D;;;;;OAKG;IACH,OAAO,CAAC,EAAE,CAAC,IAAI,EAAE,qBAAqB,CAAC,CAAC,CAAC,KAAK,IAAI,CAAA;IAClD;;;OAGG;IACH,YAAY,CAAC,EAAE,CAAC,GAAG,EAAE,mBAAmB,CAAC,CAAC,CAAC,KAAK,IAAI,CAAA;CACrD;AAED,MAAM,WAAW,eAAe;IAC9B;;OAEG;IACH,MAAM,EAAE,WAAW,GAAG,UAAU,CAAA;IAChC;;;OAGG;IACH,KAAK,EAAE,SAAS,CAAA;IAChB;;OAEG;IACH,UAAU,CAAC,EAAE,OAAO,CAAA;CACrB;AAED,MAAM,WAAW,qBAAqB;IACpC;;OAEG;IACH,IAAI,EAAE,MAAM,CAAA;IACZ;;OAEG;IACH,CAAC,CAAC,EAAE,MAAM,CAAA;IACV;;OAEG;IACH,CAAC,CAAC,EAAE,MAAM,CAAA;IACV;;OAEG;IACH,YAAY,CAAC,EAAE,WAAW,GAAG,UAAU,CAAA;IACvC;;OAEG;IACH,UAAU,CAAC,EAAE,YAAY,CAAA;IACzB;;OAEG;IACH,UAAU,CAAC,EAAE,OAAO,CAAA;CACrB;AAED,MAAM,WAAW,wBAAwB,CAAC,CAAC,GAAG,OAAO;IACnD;;;;OAIG;IACH,EAAE,EAAE,MAAM,CAAA;IACV;;OAEG;IACH,KAAK,EAAE,CAAC,CAAA;IACR;;OAEG;IACH,MAAM,EAAE,WAAW,GAAG,UAAU,CAAA;IAChC;;OAEG;IACH,IAAI,EAAE,WAAW,CAAA;IACjB;;OAEG;IACH,UAAU,CAAC,EAAE,OAAO,CAAA;IACpB;;OAEG;IACH,UAAU,EAAE,SAAS,CAAA;IACrB;;OAEG;IACH,kBAAkB,CAAC,EAAE,MAAM,CAAA;IAC3B;;OAEG;IACH,IAAI,EAAE,QAAQ,CAAC,CAAC,CAAC,CAAA;CAClB"}

package/build/src/elements/contextual-menu/internals/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../../src/elements/contextual-menu/internals/types.ts"],"names":[],"mappings":"","sourcesContent":["/* eslint-disable @typescript-eslint/no-empty-object-type */\nimport type { SVGTemplateResult } from 'lit'\nimport type { MenuItem } from './MenuItem.js'\n\nexport type MenuItemType = 'normal' | 'separator' | 'label' | 'radio'\n\nexport interface MenuOptions {\n  /**\n   * By default the `contextmenu` event is always cancelled by the library\n   * whether the command is actually handled or not.\n   * When this is set the event is cancelled only when the context menu can be rendered\n   * in the current context.\n   *\n   * Note, this may cause a disjoint experience to the user as in one situation the right click\n   * would render this context menu and in another system's & browser context menu.\n   */\n  cancelNativeWhenHandled?: boolean\n}\n\nexport interface MenuPoint {\n  x: number\n  y: number\n}\n\ninterface LifecycleContext<S> {\n  /**\n   * The id of the command.\n   */\n  id: string\n  /**\n   * The object store to be used to store menu item data.\n   */\n  store: S\n  /**\n   * An instance of the element that triggered the command.\n   */\n  target: HTMLElement | SVGElement\n  /**\n   * The element with which this context menu was initialized with.\n   */\n  root: HTMLElement\n  /**\n   * Any data passed to the command through a custom event.\n   */\n  customData?: unknown\n}\n\nexport interface EnabledMenuOptions<S = unknown> extends LifecycleContext<S> {}\n\nexport interface CheckedMenuOptions<S> extends LifecycleContext<S> {}\n\n/**\n * Options passed to the `visible()` callback function.\n */\nexport type VisibleOptions<S> = EnabledMenuOptions<S>\n\nexport interface CommandExecuteOptions<S = unknown> extends LifecycleContext<S> {\n  /**\n   * The point of the original click.\n   */\n  clickPoint: MenuPoint\n  /**\n   * This is only passed to the execute function when a sub-menu has triggered a menu item\n   * that has no `execute` function defined. This is the index of the command.\n   * Note, the index includes separators.\n   */\n  selectedSubcommand?: number\n  /**\n   * The menu item that triggered the selection.\n   */\n  item: MenuItem<S>\n}\n\nexport interface BeforeRenderOptions<S = unknown> extends LifecycleContext<S> {\n  /**\n   * The menu item that triggered the selection. Changing this item will affects the rendering of it.\n   */\n  menu: MenuItem<S>\n}\n\nexport interface CommandBase<S = unknown> {\n  /**\n   * The identifier of the command. Can be used to ids manually. The command is passed\n   * to the lifecycle callbacks so you can use it to identify a command.\n   * When not set the Menu generates a random value.\n   */\n  id?: string\n  /**\n   * The type of the command. By default the command is `normal`. `separator` draws a line between menu items.\n   * The `label` renders a title over other list items.\n   *\n   * The radio type renders a \"check\" mark on the right of the label instead of image (it is ignored when set).\n   * To mark the checkbox as checked use the `checked` property. Use the lifecycle methods to set the checked state.\n   */\n  type?: MenuItemType\n  /**\n   * The target object that activates this item.\n   * The `ContextMenu` class uses `findTarget(mouseEvent)` to find the event target and `elementToTarget(targetElement)`\n   * to find the target. By default the \"elementTarget\" is the event's target, and the target is the elementTarget's\n   * `localName` with list of class names (period separated).\n   * When the target is the same as the `workspace` then the target is `root`.\n   * Override this two methods to customize this behavior and support custom use cases.\n   *\n   * By default the constructed target from an element is something like this: `div.item.target-item`.\n   *\n   * This must be provided for the top level menu items only. This is ignored in sub-menus.\n   */\n  target?: string | string[] | 'all' | 'root'\n  /**\n   * Determines whether the menu item is visible in the rendered menu.\n   * The item is always inserted into the DOM but when this value is false or the result of calling the function\n   * is false then the item is hidden. You can still access the menu item via DOM apis.\n   */\n  visible?: boolean | ((args: VisibleOptions<S>) => boolean)\n}\n\nexport interface ContextMenuCommand<S = unknown> extends CommandBase<S> {\n  /**\n   * The label to render.\n   */\n  label?: string\n  /**\n   * Optional title of the element. Do not use it for elements that represent a sub-menu.\n   */\n  title?: string\n  /**\n   * The icon to render. It should be full definition of an SVG image wrapped into\n   * the svg`...` template, from the `lit-html` library.\n   */\n  icon?: SVGTemplateResult\n  /**\n   * A children of this command. When set and not empty then it renders a nested sub-menu\n   * for this entry. In this case the `execute()` lifecycle method won't be executed and a new menu is rendered\n   * positioned relative to this entry.\n   *\n   * Note, sub entries of the menu are not rendered until the user hover over the menu. When the user hover over\n   * another menu entry the child menu is destroyed.\n   */\n  children?: (ContextMenuCommand<S> | CommandBase<S>)[]\n  /**\n   * Whether the command is enabled or not.\n   * When set to a boolean value, this value is used to determine whether the item should be rendered.\n   * When set to a function, it must return a value indicating whether the command is enabled.\n   */\n  enabled?: boolean | ((args: EnabledMenuOptions<S>) => boolean)\n  /**\n   * Only used when the `type` is set to `radio` and indicated that the element is in the checked state.\n   * When this is true then the UI renders the check mark in the image are.\n   * Note, you cannot use the `image` with this property as the image is ignored and the selection state\n   * is indicated in this place.\n   */\n  checked?: boolean | ((args: CheckedMenuOptions<S>) => boolean)\n  /**\n   * The action to be executed when this command is activated.\n   * This is ignored when the command has children. When the command has no children then\n   * when this is set to a function, this function is called when a menu item is triggered.\n   * You may not set this value and use the `activate` event to listen for command activation.\n   */\n  execute?: (args: CommandExecuteOptions<S>) => void\n  /**\n   * A function that is executed before the item is rendered.\n   * This way you can customize the rendered values like the icon, label, or title.\n   */\n  beforeRender?: (ctx: BeforeRenderOptions<S>) => void\n}\n\nexport interface MenuTriggerInfo {\n  /**\n   * The element that triggered the context menu.\n   */\n  target: HTMLElement | SVGElement\n  /**\n   * The location where the click relative position is.\n   * This can be customized by overriding the `readTargetClickPosition()`.\n   */\n  point: MenuPoint\n  /**\n   * A custom data to be passed to the lifecycle methods.\n   */\n  customData?: unknown\n}\n\nexport interface CustomMenuEventDetail {\n  /**\n   * The name of the command target. It is used to render commands group. It corresponds to ContextMenuCommand.target.\n   */\n  name: string\n  /**\n   * The x coordinate of the click. Default to 0.\n   */\n  x?: number\n  /**\n   * The y coordinate of the click. Default to 0.\n   */\n  y?: number\n  /**\n   * The click target passed back to the command execute function. Default to the workspace.\n   */\n  actionTarget?: HTMLElement | SVGElement\n  /**\n   * The original click event associated with the action. Optional.\n   */\n  clickEvent?: PointerEvent\n  /**\n   * Any data to be passed to the enabled and execute function.\n   */\n  customData?: unknown\n}\n\nexport interface ContextMenuExecuteDetail<S = unknown> {\n  /**\n   * The id of the executed command.\n   * When not set by the command definition this is auto generated\n   * when registering a command.\n   */\n  id: string\n  /**\n   * The object store to be used to store menu item data.\n   */\n  store: S\n  /**\n   * An instance of the element that triggered the command.\n   */\n  target: HTMLElement | SVGElement\n  /**\n   * The element with which this context menu was initialized with.\n   */\n  root: HTMLElement\n  /**\n   * Any data passed to the command through a custom event.\n   */\n  customData?: unknown\n  /**\n   * The point of the original click.\n   */\n  clickPoint: MenuPoint\n  /**\n   * The index of the clicked subcommand\n   */\n  selectedSubcommand?: number\n  /**\n   * The selected me nu item.\n   */\n  item: MenuItem<S>\n}\n"]}
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../../src/elements/contextual-menu/internals/types.ts"],"names":[],"mappings":"","sourcesContent":["/* eslint-disable @typescript-eslint/no-empty-object-type */\nimport type { SVGTemplateResult } from 'lit'\nimport type { MenuItem } from './MenuItem.js'\n\nexport type MenuItemType = 'normal' | 'separator' | 'label' | 'radio'\n\nexport interface MenuOptions {\n  /**\n   * By default the `contextmenu` event is always cancelled by the library\n   * whether the command is actually handled or not.\n   * When this is set the event is cancelled only when the context menu can be rendered\n   * in the current context.\n   *\n   * Note, this may cause a disjoint experience to the user as in one situation the right click\n   * would render this context menu and in another system's & browser context menu.\n   */\n  cancelNativeWhenHandled?: boolean\n  /**\n   * Called before the menu is rendered.\n   * Specifically, it is called right before the internal `render()` method is called.\n   * It doesn't allow you to modify the menu items, but you can perform any setup\n   * before the menu is rendered.\n   */\n  beforeRender?: (ctx: MenuContext) => void\n}\n\nexport interface MenuPoint {\n  x: number\n  y: number\n}\n\nexport interface MenuContext<S = unknown> {\n  /**\n   * The object store to be used to store menu item data.\n   */\n  store: S\n  /**\n   * An instance of the element that triggered the command.\n   */\n  target: HTMLElement | SVGElement\n  /**\n   * The element with which this context menu was initialized with.\n   */\n  root: HTMLElement\n  /**\n   * Any data passed to the command through a custom event.\n   */\n  customData?: unknown\n}\n\ninterface LifecycleContext<S = unknown> extends MenuContext<S> {\n  /**\n   * The id of the command.\n   */\n  id: string\n}\n\nexport interface EnabledMenuOptions<S = unknown> extends LifecycleContext<S> {}\n\nexport interface CheckedMenuOptions<S = unknown> extends LifecycleContext<S> {}\n\n/**\n * Options passed to the `visible()` callback function.\n */\nexport type VisibleOptions<S = unknown> = EnabledMenuOptions<S>\n\nexport interface CommandExecuteOptions<S = unknown> extends LifecycleContext<S> {\n  /**\n   * The point of the original click.\n   */\n  clickPoint: MenuPoint\n  /**\n   * This is only passed to the execute function when a sub-menu has triggered a menu item\n   * that has no `execute` function defined. This is the index of the command.\n   * Note, the index includes separators.\n   */\n  selectedSubcommand?: number\n  /**\n   * The menu item that triggered the selection.\n   */\n  item: MenuItem<S>\n}\n\nexport interface BeforeRenderOptions<S = unknown> extends LifecycleContext<S> {\n  /**\n   * The menu item that triggered the selection. Changing this item will affects the rendering of it.\n   */\n  menu: MenuItem<S>\n}\n\nexport interface CommandBase<S = unknown> {\n  /**\n   * The identifier of the command. Can be used to ids manually. The command is passed\n   * to the lifecycle callbacks so you can use it to identify a command.\n   * When not set the Menu generates a random value.\n   */\n  id?: string\n  /**\n   * The type of the command. By default the command is `normal`. `separator` draws a line between menu items.\n   * The `label` renders a title over other list items.\n   *\n   * The radio type renders a \"check\" mark on the right of the label instead of image (it is ignored when set).\n   * To mark the checkbox as checked use the `checked` property. Use the lifecycle methods to set the checked state.\n   */\n  type?: MenuItemType\n  /**\n   * The target object that activates this item.\n   * The `ContextMenu` class uses `findTarget(mouseEvent)` to find the event target and `elementToTarget(targetElement)`\n   * to find the target. By default the \"elementTarget\" is the event's target, and the target is the elementTarget's\n   * `localName` with list of class names (period separated).\n   * When the target is the same as the `workspace` then the target is `root`.\n   * Override this two methods to customize this behavior and support custom use cases.\n   *\n   * By default the constructed target from an element is something like this: `div.item.target-item`.\n   *\n   * This must be provided for the top level menu items only. This is ignored in sub-menus.\n   */\n  target?: string | string[] | 'all' | 'root'\n  /**\n   * Determines whether the menu item is visible in the rendered menu.\n   * The item is always inserted into the DOM but when this value is false or the result of calling the function\n   * is false then the item is hidden. You can still access the menu item via DOM apis.\n   */\n  visible?: boolean | ((args: VisibleOptions<S>) => boolean)\n}\n\nexport interface ContextMenuCommand<S = unknown> extends CommandBase<S> {\n  /**\n   * The label to render.\n   */\n  label?: string\n  /**\n   * Optional title of the element. Do not use it for elements that represent a sub-menu.\n   */\n  title?: string\n  /**\n   * The icon to render. It should be full definition of an SVG image wrapped into\n   * the svg`...` template, from the `lit-html` library.\n   */\n  icon?: SVGTemplateResult\n  /**\n   * A children of this command. When set and not empty then it renders a nested sub-menu\n   * for this entry. In this case the `execute()` lifecycle method won't be executed and a new menu is rendered\n   * positioned relative to this entry.\n   *\n   * Note, sub entries of the menu are not rendered until the user hover over the menu. When the user hover over\n   * another menu entry the child menu is destroyed.\n   */\n  children?: (ContextMenuCommand<S> | CommandBase<S>)[]\n  /**\n   * Whether the command is enabled or not.\n   * When set to a boolean value, this value is used to determine whether the item should be rendered.\n   * When set to a function, it must return a value indicating whether the command is enabled.\n   */\n  enabled?: boolean | ((args: EnabledMenuOptions<S>) => boolean)\n  /**\n   * Only used when the `type` is set to `radio` and indicated that the element is in the checked state.\n   * When this is true then the UI renders the check mark in the image are.\n   * Note, you cannot use the `image` with this property as the image is ignored and the selection state\n   * is indicated in this place.\n   */\n  checked?: boolean | ((args: CheckedMenuOptions<S>) => boolean)\n  /**\n   * The action to be executed when this command is activated.\n   * This is ignored when the command has children. When the command has no children then\n   * when this is set to a function, this function is called when a menu item is triggered.\n   * You may not set this value and use the `activate` event to listen for command activation.\n   */\n  execute?: (args: CommandExecuteOptions<S>) => void\n  /**\n   * A function that is executed before the item is rendered.\n   * This way you can customize the rendered values like the icon, label, or title.\n   */\n  beforeRender?: (ctx: BeforeRenderOptions<S>) => void\n}\n\nexport interface MenuTriggerInfo {\n  /**\n   * The element that triggered the context menu.\n   */\n  target: HTMLElement | SVGElement\n  /**\n   * The location where the click relative position is.\n   * This can be customized by overriding the `readTargetClickPosition()`.\n   */\n  point: MenuPoint\n  /**\n   * A custom data to be passed to the lifecycle methods.\n   */\n  customData?: unknown\n}\n\nexport interface CustomMenuEventDetail {\n  /**\n   * The name of the command target. It is used to render commands group. It corresponds to ContextMenuCommand.target.\n   */\n  name: string\n  /**\n   * The x coordinate of the click. Default to 0.\n   */\n  x?: number\n  /**\n   * The y coordinate of the click. Default to 0.\n   */\n  y?: number\n  /**\n   * The click target passed back to the command execute function. Default to the workspace.\n   */\n  actionTarget?: HTMLElement | SVGElement\n  /**\n   * The original click event associated with the action. Optional.\n   */\n  clickEvent?: PointerEvent\n  /**\n   * Any data to be passed to the enabled and execute function.\n   */\n  customData?: unknown\n}\n\nexport interface ContextMenuExecuteDetail<S = unknown> {\n  /**\n   * The id of the executed command.\n   * When not set by the command definition this is auto generated\n   * when registering a command.\n   */\n  id: string\n  /**\n   * The object store to be used to store menu item data.\n   */\n  store: S\n  /**\n   * An instance of the element that triggered the command.\n   */\n  target: HTMLElement | SVGElement\n  /**\n   * The element with which this context menu was initialized with.\n   */\n  root: HTMLElement\n  /**\n   * Any data passed to the command through a custom event.\n   */\n  customData?: unknown\n  /**\n   * The point of the original click.\n   */\n  clickPoint: MenuPoint\n  /**\n   * The index of the clicked subcommand\n   */\n  selectedSubcommand?: number\n  /**\n   * The selected me nu item.\n   */\n  item: MenuItem<S>\n}\n"]}