@difizen/libro-common 0.3.4 → 1.0.0

package/src/core/keyboard/layouts/tr-Turkish_Q-mac.json

@@ -0,0 +1 @@
+{"info":{"id":"com.apple.keylayout.Turkish-QWERTY-PC","lang":"tr"},"mapping":{"KeyA":{"value":"a","withShift":"A","withAltGr":"æ","withShiftAltGr":"Æ"},"KeyB":{"value":"b","withShift":"B","withAltGr":"∫","withShiftAltGr":"ß"},"KeyC":{"value":"c","withShift":"C","withAltGr":"ç","withShiftAltGr":"Ç"},"KeyD":{"value":"d","withShift":"D","withAltGr":"∂","withShiftAltGr":"Î"},"KeyE":{"value":"e","withShift":"E","withAltGr":"€","withShiftAltGr":"‰"},"KeyF":{"value":"f","withShift":"F","withAltGr":"ƒ","withShiftAltGr":"Ï"},"KeyG":{"value":"g","withShift":"G","withAltGr":"ğ","withShiftAltGr":"Ğ"},"KeyH":{"value":"h","withShift":"H","withAltGr":"^","withShiftAltGr":"Ó"},"KeyI":{"value":"ı","withShift":"I","withAltGr":"i","withShiftAltGr":"İ"},"KeyJ":{"value":"j","withShift":"J","withAltGr":"∆","withShiftAltGr":"Ô"},"KeyK":{"value":"k","withShift":"K","withAltGr":"¨","withShiftAltGr":""},"KeyL":{"value":"l","withShift":"L","withAltGr":"¬","withShiftAltGr":"Ò"},"KeyM":{"value":"m","withShift":"M","withAltGr":"µ","withShiftAltGr":"˜"},"KeyN":{"value":"n","withShift":"N","withAltGr":"~","withShiftAltGr":"ˆ"},"KeyO":{"value":"o","withShift":"O","withAltGr":"ö","withShiftAltGr":"Ö"},"KeyP":{"value":"p","withShift":"P","withAltGr":"π","withShiftAltGr":"∏"},"KeyQ":{"value":"q","withShift":"Q","withAltGr":"@","withShiftAltGr":"Œ"},"KeyR":{"value":"r","withShift":"R","withAltGr":"®","withShiftAltGr":"Â"},"KeyS":{"value":"s","withShift":"S","withAltGr":"ß","withShiftAltGr":"Ş"},"KeyT":{"value":"t","withShift":"T","withAltGr":"₺","withShiftAltGr":"Ê"},"KeyU":{"value":"u","withShift":"U","withAltGr":"ü","withShiftAltGr":"Ü"},"KeyV":{"value":"v","withShift":"V","withAltGr":"√","withShiftAltGr":"◊"},"KeyW":{"value":"w","withShift":"W","withAltGr":"∑","withShiftAltGr":"„"},"KeyX":{"value":"x","withShift":"X","withAltGr":"≈","withShiftAltGr":"Ù"},"KeyY":{"value":"y","withShift":"Y","withAltGr":"¥","withShiftAltGr":"Á"},"KeyZ":{"value":"z","withShift":"Z","withAltGr":"Ω","withShiftAltGr":"Û"},"Digit1":{"value":"1","withShift":"!","withAltGr":">","withShiftAltGr":"·"},"Digit2":{"value":"2","withShift":"'","withAltGr":"£","withShiftAltGr":"€"},"Digit3":{"value":"3","withShift":"^","withAltGr":"#","withShiftAltGr":"©"},"Digit4":{"value":"4","withShift":"+","withAltGr":"$","withShiftAltGr":"‚"},"Digit5":{"value":"5","withShift":"%","withAltGr":"½","withShiftAltGr":"˚"},"Digit6":{"value":"6","withShift":"&","withAltGr":"§","withShiftAltGr":"˙"},"Digit7":{"value":"7","withShift":"/","withAltGr":"{","withShiftAltGr":"‡"},"Digit8":{"value":"8","withShift":"(","withAltGr":"[","withShiftAltGr":"°"},"Digit9":{"value":"9","withShift":")","withAltGr":"]","withShiftAltGr":"Ø"},"Digit0":{"value":"0","withShift":"=","withAltGr":"}","withShiftAltGr":"ø"},"Minus":{"value":"*","withShift":"?","withAltGr":"\\","withShiftAltGr":"—"},"Equal":{"value":"-","withShift":"_","withAltGr":"|","withShiftAltGr":"±"},"BracketLeft":{"value":"ğ","withShift":"Ğ","withAltGr":"¨","withShiftAltGr":"”"},"BracketRight":{"value":"ü","withShift":"Ü","withAltGr":"~","withShiftAltGr":"’"},"Backslash":{"value":",","withShift":";","withAltGr":"`","withShiftAltGr":"»"},"Semicolon":{"value":"ş","withShift":"Ş","withAltGr":"´","withShiftAltGr":"Ú"},"Quote":{"value":"i","withShift":"İ","withAltGr":"æ","withShiftAltGr":"Æ"},"Backquote":{"value":"<","withShift":">","withAltGr":"|","withShiftAltGr":"Ÿ"},"Comma":{"value":"ö","withShift":"Ö","withAltGr":"≤","withShiftAltGr":"¯"},"Period":{"value":"ç","withShift":"Ç","withAltGr":"≥","withShiftAltGr":"˘"},"Slash":{"value":".","withShift":":","withAltGr":"÷","withShiftAltGr":"¿"},"IntlBackslash":{"value":"\"","withShift":"é","withAltGr":"<"}}}

package/src/core/keyboard/layouts/tr-Turkish_Q-mac.ts

@@ -0,0 +1,53 @@
+export default {
+  "info": { "id": "com.apple.keylayout.Turkish-QWERTY-PC", "lang": "tr" },
+  "mapping": {
+    "KeyA": { "value": "a", "withShift": "A", "withAltGr": "æ", "withShiftAltGr": "Æ" },
+    "KeyB": { "value": "b", "withShift": "B", "withAltGr": "∫", "withShiftAltGr": "ß" },
+    "KeyC": { "value": "c", "withShift": "C", "withAltGr": "ç", "withShiftAltGr": "Ç" },
+    "KeyD": { "value": "d", "withShift": "D", "withAltGr": "∂", "withShiftAltGr": "Î" },
+    "KeyE": { "value": "e", "withShift": "E", "withAltGr": "€", "withShiftAltGr": "‰" },
+    "KeyF": { "value": "f", "withShift": "F", "withAltGr": "ƒ", "withShiftAltGr": "Ï" },
+    "KeyG": { "value": "g", "withShift": "G", "withAltGr": "ğ", "withShiftAltGr": "Ğ" },
+    "KeyH": { "value": "h", "withShift": "H", "withAltGr": "^", "withShiftAltGr": "Ó" },
+    "KeyI": { "value": "ı", "withShift": "I", "withAltGr": "i", "withShiftAltGr": "İ" },
+    "KeyJ": { "value": "j", "withShift": "J", "withAltGr": "∆", "withShiftAltGr": "Ô" },
+    "KeyK": { "value": "k", "withShift": "K", "withAltGr": "¨", "withShiftAltGr": "" },
+    "KeyL": { "value": "l", "withShift": "L", "withAltGr": "¬", "withShiftAltGr": "Ò" },
+    "KeyM": { "value": "m", "withShift": "M", "withAltGr": "µ", "withShiftAltGr": "˜" },
+    "KeyN": { "value": "n", "withShift": "N", "withAltGr": "~", "withShiftAltGr": "ˆ" },
+    "KeyO": { "value": "o", "withShift": "O", "withAltGr": "ö", "withShiftAltGr": "Ö" },
+    "KeyP": { "value": "p", "withShift": "P", "withAltGr": "π", "withShiftAltGr": "∏" },
+    "KeyQ": { "value": "q", "withShift": "Q", "withAltGr": "@", "withShiftAltGr": "Œ" },
+    "KeyR": { "value": "r", "withShift": "R", "withAltGr": "®", "withShiftAltGr": "Â" },
+    "KeyS": { "value": "s", "withShift": "S", "withAltGr": "ß", "withShiftAltGr": "Ş" },
+    "KeyT": { "value": "t", "withShift": "T", "withAltGr": "₺", "withShiftAltGr": "Ê" },
+    "KeyU": { "value": "u", "withShift": "U", "withAltGr": "ü", "withShiftAltGr": "Ü" },
+    "KeyV": { "value": "v", "withShift": "V", "withAltGr": "√", "withShiftAltGr": "◊" },
+    "KeyW": { "value": "w", "withShift": "W", "withAltGr": "∑", "withShiftAltGr": "„" },
+    "KeyX": { "value": "x", "withShift": "X", "withAltGr": "≈", "withShiftAltGr": "Ù" },
+    "KeyY": { "value": "y", "withShift": "Y", "withAltGr": "¥", "withShiftAltGr": "Á" },
+    "KeyZ": { "value": "z", "withShift": "Z", "withAltGr": "Ω", "withShiftAltGr": "Û" },
+    "Digit1": { "value": "1", "withShift": "!", "withAltGr": ">", "withShiftAltGr": "·" },
+    "Digit2": { "value": "2", "withShift": "'", "withAltGr": "£", "withShiftAltGr": "€" },
+    "Digit3": { "value": "3", "withShift": "^", "withAltGr": "#", "withShiftAltGr": "©" },
+    "Digit4": { "value": "4", "withShift": "+", "withAltGr": "$", "withShiftAltGr": "‚" },
+    "Digit5": { "value": "5", "withShift": "%", "withAltGr": "½", "withShiftAltGr": "˚" },
+    "Digit6": { "value": "6", "withShift": "&", "withAltGr": "§", "withShiftAltGr": "˙" },
+    "Digit7": { "value": "7", "withShift": "/", "withAltGr": "{", "withShiftAltGr": "‡" },
+    "Digit8": { "value": "8", "withShift": "(", "withAltGr": "[", "withShiftAltGr": "°" },
+    "Digit9": { "value": "9", "withShift": ")", "withAltGr": "]", "withShiftAltGr": "Ø" },
+    "Digit0": { "value": "0", "withShift": "=", "withAltGr": "}", "withShiftAltGr": "ø" },
+    "Minus": { "value": "*", "withShift": "?", "withAltGr": "\\", "withShiftAltGr": "—" },
+    "Equal": { "value": "-", "withShift": "_", "withAltGr": "|", "withShiftAltGr": "±" },
+    "BracketLeft": { "value": "ğ", "withShift": "Ğ", "withAltGr": "¨", "withShiftAltGr": "”" },
+    "BracketRight": { "value": "ü", "withShift": "Ü", "withAltGr": "~", "withShiftAltGr": "’" },
+    "Backslash": { "value": ",", "withShift": ";", "withAltGr": "`", "withShiftAltGr": "»" },
+    "Semicolon": { "value": "ş", "withShift": "Ş", "withAltGr": "´", "withShiftAltGr": "Ú" },
+    "Quote": { "value": "i", "withShift": "İ", "withAltGr": "æ", "withShiftAltGr": "Æ" },
+    "Backquote": { "value": "<", "withShift": ">", "withAltGr": "|", "withShiftAltGr": "Ÿ" },
+    "Comma": { "value": "ö", "withShift": "Ö", "withAltGr": "≤", "withShiftAltGr": "¯" },
+    "Period": { "value": "ç", "withShift": "Ç", "withAltGr": "≥", "withShiftAltGr": "˘" },
+    "Slash": { "value": ".", "withShift": ":", "withAltGr": "÷", "withShiftAltGr": "¿" },
+    "IntlBackslash": { "value": "\"", "withShift": "é", "withAltGr": "<" }
+  }
+}

package/src/core/keyboard/layouts/tr-Turkish_Q-pc.json

@@ -0,0 +1 @@
+{"info":{"name":"0000041F","id":"","text":"Turkish Q"},"mapping":{"KeyA":{"vkey":"VK_A","value":"a","withShift":"A","withAltGr":"æ","withShiftAltGr":"Æ"},"KeyB":{"vkey":"VK_B","value":"b","withShift":"B"},"KeyC":{"vkey":"VK_C","value":"c","withShift":"C"},"KeyD":{"vkey":"VK_D","value":"d","withShift":"D"},"KeyE":{"vkey":"VK_E","value":"e","withShift":"E","withAltGr":"€"},"KeyF":{"vkey":"VK_F","value":"f","withShift":"F"},"KeyG":{"vkey":"VK_G","value":"g","withShift":"G"},"KeyH":{"vkey":"VK_H","value":"h","withShift":"H"},"KeyI":{"vkey":"VK_I","value":"ı","withShift":"I","withAltGr":"i","withShiftAltGr":"İ"},"KeyJ":{"vkey":"VK_J","value":"j","withShift":"J"},"KeyK":{"vkey":"VK_K","value":"k","withShift":"K"},"KeyL":{"vkey":"VK_L","value":"l","withShift":"L"},"KeyM":{"vkey":"VK_M","value":"m","withShift":"M"},"KeyN":{"vkey":"VK_N","value":"n","withShift":"N"},"KeyO":{"vkey":"VK_O","value":"o","withShift":"O"},"KeyP":{"vkey":"VK_P","value":"p","withShift":"P"},"KeyQ":{"vkey":"VK_Q","value":"q","withShift":"Q","withAltGr":"@"},"KeyR":{"vkey":"VK_R","value":"r","withShift":"R"},"KeyS":{"vkey":"VK_S","value":"s","withShift":"S","withAltGr":"ß"},"KeyT":{"vkey":"VK_T","value":"t","withShift":"T","withAltGr":"₺"},"KeyU":{"vkey":"VK_U","value":"u","withShift":"U"},"KeyV":{"vkey":"VK_V","value":"v","withShift":"V"},"KeyW":{"vkey":"VK_W","value":"w","withShift":"W"},"KeyX":{"vkey":"VK_X","value":"x","withShift":"X"},"KeyY":{"vkey":"VK_Y","value":"y","withShift":"Y"},"KeyZ":{"vkey":"VK_Z","value":"z","withShift":"Z"},"Digit1":{"vkey":"VK_1","value":"1","withShift":"!","withAltGr":">"},"Digit2":{"vkey":"VK_2","value":"2","withShift":"'","withAltGr":"£"},"Digit3":{"vkey":"VK_3","value":"3","withShift":"^","withAltGr":"#"},"Digit4":{"vkey":"VK_4","value":"4","withShift":"+","withAltGr":"$"},"Digit5":{"vkey":"VK_5","value":"5","withShift":"%","withAltGr":"½"},"Digit6":{"vkey":"VK_6","value":"6","withShift":"&"},"Digit7":{"vkey":"VK_7","value":"7","withShift":"/","withAltGr":"{"},"Digit8":{"vkey":"VK_8","value":"8","withShift":"(","withAltGr":"["},"Digit9":{"vkey":"VK_9","value":"9","withShift":")","withAltGr":"]"},"Digit0":{"vkey":"VK_0","value":"0","withShift":"=","withAltGr":"}"},"Minus":{"vkey":"VK_OEM_8","value":"*","withShift":"?","withAltGr":"\\"},"Equal":{"vkey":"VK_OEM_MINUS","value":"-","withShift":"_","withAltGr":"|"},"BracketLeft":{"vkey":"VK_OEM_4","value":"ğ","withShift":"Ğ","withAltGr":"¨"},"BracketRight":{"vkey":"VK_OEM_6","value":"ü","withShift":"Ü","withAltGr":"~"},"Backslash":{"vkey":"VK_OEM_COMMA","value":",","withShift":";","withAltGr":"`"},"Semicolon":{"vkey":"VK_OEM_1","value":"ş","withShift":"Ş","withAltGr":"´"},"Quote":{"vkey":"VK_OEM_7","value":"i","withShift":"İ"},"Backquote":{"vkey":"VK_OEM_3","value":"\"","withShift":"é","withAltGr":"<"},"Comma":{"vkey":"VK_OEM_2","value":"ö","withShift":"Ö"},"Period":{"vkey":"VK_OEM_5","value":"ç","withShift":"Ç"},"Slash":{"vkey":"VK_OEM_PERIOD","value":".","withShift":":"},"IntlBackslash":{"vkey":"VK_OEM_102","value":"<","withShift":">","withAltGr":"|"},"IntlRo":{"vkey":"VK_ABNT_C1"},"IntlYen":{"vkey":"VK_UNKNOWN"}}}

package/src/core/keyboard/layouts/tr-Turkish_Q-pc.ts

@@ -0,0 +1,67 @@
+export default {
+  "info": { "name": "0000041F", "id": "", "text": "Turkish Q" },
+  "mapping": {
+    "KeyA": {
+      "vkey": "VK_A",
+      "value": "a",
+      "withShift": "A",
+      "withAltGr": "æ",
+      "withShiftAltGr": "Æ"
+    },
+    "KeyB": { "vkey": "VK_B", "value": "b", "withShift": "B" },
+    "KeyC": { "vkey": "VK_C", "value": "c", "withShift": "C" },
+    "KeyD": { "vkey": "VK_D", "value": "d", "withShift": "D" },
+    "KeyE": { "vkey": "VK_E", "value": "e", "withShift": "E", "withAltGr": "€" },
+    "KeyF": { "vkey": "VK_F", "value": "f", "withShift": "F" },
+    "KeyG": { "vkey": "VK_G", "value": "g", "withShift": "G" },
+    "KeyH": { "vkey": "VK_H", "value": "h", "withShift": "H" },
+    "KeyI": {
+      "vkey": "VK_I",
+      "value": "ı",
+      "withShift": "I",
+      "withAltGr": "i",
+      "withShiftAltGr": "İ"
+    },
+    "KeyJ": { "vkey": "VK_J", "value": "j", "withShift": "J" },
+    "KeyK": { "vkey": "VK_K", "value": "k", "withShift": "K" },
+    "KeyL": { "vkey": "VK_L", "value": "l", "withShift": "L" },
+    "KeyM": { "vkey": "VK_M", "value": "m", "withShift": "M" },
+    "KeyN": { "vkey": "VK_N", "value": "n", "withShift": "N" },
+    "KeyO": { "vkey": "VK_O", "value": "o", "withShift": "O" },
+    "KeyP": { "vkey": "VK_P", "value": "p", "withShift": "P" },
+    "KeyQ": { "vkey": "VK_Q", "value": "q", "withShift": "Q", "withAltGr": "@" },
+    "KeyR": { "vkey": "VK_R", "value": "r", "withShift": "R" },
+    "KeyS": { "vkey": "VK_S", "value": "s", "withShift": "S", "withAltGr": "ß" },
+    "KeyT": { "vkey": "VK_T", "value": "t", "withShift": "T", "withAltGr": "₺" },
+    "KeyU": { "vkey": "VK_U", "value": "u", "withShift": "U" },
+    "KeyV": { "vkey": "VK_V", "value": "v", "withShift": "V" },
+    "KeyW": { "vkey": "VK_W", "value": "w", "withShift": "W" },
+    "KeyX": { "vkey": "VK_X", "value": "x", "withShift": "X" },
+    "KeyY": { "vkey": "VK_Y", "value": "y", "withShift": "Y" },
+    "KeyZ": { "vkey": "VK_Z", "value": "z", "withShift": "Z" },
+    "Digit1": { "vkey": "VK_1", "value": "1", "withShift": "!", "withAltGr": ">" },
+    "Digit2": { "vkey": "VK_2", "value": "2", "withShift": "'", "withAltGr": "£" },
+    "Digit3": { "vkey": "VK_3", "value": "3", "withShift": "^", "withAltGr": "#" },
+    "Digit4": { "vkey": "VK_4", "value": "4", "withShift": "+", "withAltGr": "$" },
+    "Digit5": { "vkey": "VK_5", "value": "5", "withShift": "%", "withAltGr": "½" },
+    "Digit6": { "vkey": "VK_6", "value": "6", "withShift": "&" },
+    "Digit7": { "vkey": "VK_7", "value": "7", "withShift": "/", "withAltGr": "{" },
+    "Digit8": { "vkey": "VK_8", "value": "8", "withShift": "(", "withAltGr": "[" },
+    "Digit9": { "vkey": "VK_9", "value": "9", "withShift": ")", "withAltGr": "]" },
+    "Digit0": { "vkey": "VK_0", "value": "0", "withShift": "=", "withAltGr": "}" },
+    "Minus": { "vkey": "VK_OEM_8", "value": "*", "withShift": "?", "withAltGr": "\\" },
+    "Equal": { "vkey": "VK_OEM_MINUS", "value": "-", "withShift": "_", "withAltGr": "|" },
+    "BracketLeft": { "vkey": "VK_OEM_4", "value": "ğ", "withShift": "Ğ", "withAltGr": "¨" },
+    "BracketRight": { "vkey": "VK_OEM_6", "value": "ü", "withShift": "Ü", "withAltGr": "~" },
+    "Backslash": { "vkey": "VK_OEM_COMMA", "value": ",", "withShift": ";", "withAltGr": "`" },
+    "Semicolon": { "vkey": "VK_OEM_1", "value": "ş", "withShift": "Ş", "withAltGr": "´" },
+    "Quote": { "vkey": "VK_OEM_7", "value": "i", "withShift": "İ" },
+    "Backquote": { "vkey": "VK_OEM_3", "value": "\"", "withShift": "é", "withAltGr": "<" },
+    "Comma": { "vkey": "VK_OEM_2", "value": "ö", "withShift": "Ö" },
+    "Period": { "vkey": "VK_OEM_5", "value": "ç", "withShift": "Ç" },
+    "Slash": { "vkey": "VK_OEM_PERIOD", "value": ".", "withShift": ":" },
+    "IntlBackslash": { "vkey": "VK_OEM_102", "value": "<", "withShift": ">", "withAltGr": "|" },
+    "IntlRo": { "vkey": "VK_ABNT_C1" },
+    "IntlYen": { "vkey": "VK_UNKNOWN" }
+  }
+}

package/src/core/menu/default-menu-node.ts

@@ -0,0 +1,210 @@
+/* eslint-disable @typescript-eslint/no-unused-vars */
+import type { Disposable, Event } from '../../common/index.js';
+import { Emitter } from '../../common/index.js';
+import { getOrigin, prop } from '../../observable/index.js';
+import { inject, transient } from '../../ioc/index.js';
+
+import { CommandRegistry } from '../command/command-registry';
+import { renderNode } from '../view/utils';
+
+import { CommandMenuNode, ExecutableMenuNode, MenuSymbol } from './menu-protocol';
+import type { MenuItem, MenuPath, ActionMenuNode, MenuNode } from './menu-protocol';
+
+/**
+ * Node representing a (sub)menu in the menu tree structure.
+ */
+@transient()
+export class DefaultActionMenuItem implements MenuNode, Disposable {
+  readonly id: string;
+  readonly key: string;
+
+  disposed?: boolean | undefined;
+
+  @prop()
+  readonly order?: string | undefined;
+
+  /**
+   * Optional label for the item.
+   */
+  label?: React.ReactNode | React.FC;
+
+  /**
+   * Optional icon for the item.
+   */
+  readonly icon?: React.ReactNode | React.FC;
+
+  readonly command?: string;
+
+  execute?: (...args: any[]) => any;
+
+  isEnabled?: ((...args: any[]) => boolean) | undefined;
+
+  isVisible?: ((...args: any[]) => boolean) | undefined;
+
+  isActive?: ((...args: any[]) => boolean) | undefined;
+
+  protected disposedEventEmitter: Emitter<void> = new Emitter();
+
+  protected readonly commands: CommandRegistry;
+  protected readonly node: ActionMenuNode;
+  protected readonly parentPath: MenuPath;
+
+  onDisposed: Event<void> = this.disposedEventEmitter.event;
+  constructor(
+    @inject(CommandRegistry) commands: CommandRegistry,
+    @inject(MenuSymbol.ActionMenuNodeSymbol) node: ActionMenuNode,
+    @inject(MenuSymbol.ParentPathSymbol) parentPath: MenuPath,
+  ) {
+    this.commands = commands;
+    this.node = node;
+    this.parentPath = parentPath;
+    this.order = node.order;
+    this.label = node.label;
+    this.icon = node.icon;
+    this.id = node.id;
+    this.key = parentPath.join('/') + '/' + this.id;
+    if (CommandMenuNode.is(node)) {
+      this.command = node.command;
+      this.execute = this.doCommandExecute;
+    }
+    if (ExecutableMenuNode.is(node)) {
+      this.execute = node.execute;
+      this.isEnabled = node.isEnabled;
+      this.isVisible = node.isVisible;
+      this.isActive = node.isActive;
+    }
+  }
+
+  protected doCommandExecute = (...args: any[]): any => {
+    if (this.command) {
+      return this.commands.executeCommand(this.command, ...args);
+    }
+  };
+
+  dispose() {
+    this.disposedEventEmitter.fire();
+    this.disposed = true;
+  }
+
+  renderTitle = () => {
+    let label = this.label;
+    if (!label && this.command) {
+      label = this.commands.getCommand(this.command)?.label;
+    }
+    return renderNode(label);
+  };
+  renderIcon = () => {
+    let icon = this.icon;
+    if (!icon && this.command) {
+      icon = this.commands.getCommand(this.command)?.icon;
+    }
+    return renderNode(icon);
+  };
+}
+
+/**
+ * Node representing a (sub)menu in the menu tree structure.
+ */
+@transient()
+export class DefaultGeneralMenuItem implements MenuNode, Disposable {
+  readonly id: string;
+  readonly key: string;
+  readonly path: MenuPath;
+
+  get isSubmenu(): boolean {
+    return !!this.label;
+  }
+
+  @prop()
+  readonly children: (MenuItem | DefaultActionMenuItem)[] = [];
+
+  disposed?: boolean | undefined;
+
+  @prop()
+  order?: string | undefined;
+
+  /**
+   * Optional label for the item.
+   */
+  @prop()
+  label?: React.ReactNode | React.FC;
+
+  /**
+   * Optional icon for the item.
+   */
+  @prop()
+  icon?: React.ReactNode | React.FC;
+
+  execute?: (...args: any[]) => any;
+
+  isEnabled?: (...args: any[]) => boolean;
+
+  isVisible?: (...args: any[]) => boolean;
+
+  protected disposedEventEmitter: Emitter<void> = new Emitter();
+
+  protected readonly commands: CommandRegistry;
+  protected readonly node: MenuNode;
+  protected readonly parentPath: MenuPath;
+
+  onDisposed: Event<void> = this.disposedEventEmitter.event;
+  constructor(
+    @inject(CommandRegistry) commands: CommandRegistry,
+    @inject(MenuSymbol.MenuNodeSymbol) node: MenuNode,
+    @inject(MenuSymbol.ParentPathSymbol) parentPath: MenuPath,
+  ) {
+    this.commands = commands;
+    this.node = node;
+    this.parentPath = parentPath;
+    this.order = node.order;
+    this.label = node.label;
+    this.icon = node.icon;
+    this.id = node.id;
+    this.key = parentPath.join('/') + '/' + this.id;
+    this.path = [...parentPath, this.id];
+  }
+
+  /**
+   * Inserts the given node at the position indicated by `sortString`.
+   *
+   * @returns a disposable which, when called, will remove the given node again.
+   */
+  public addNode = (item: MenuItem): MenuItem => {
+    this.children.push(item);
+    const remove = () => {
+      const idx = this.children.indexOf(getOrigin(item));
+      if (idx >= 0) {
+        this.children.splice(idx, 1);
+      }
+    };
+    item.onDisposed(remove);
+    return item;
+  };
+
+  /**
+   * Removes the first node with the given id.
+   *
+   * @param id node id.
+   */
+  public removeNode(id: string): void {
+    const node = this.children.find((n) => n.id === id);
+    if (node) {
+      const idx = this.children.indexOf(node);
+      if (idx >= 0) {
+        this.children.splice(idx, 1);
+      }
+    }
+  }
+
+  dispose() {
+    this.disposedEventEmitter.fire();
+    this.disposed = true;
+  }
+
+  renderTitle = () => {
+    return renderNode(this.label);
+  };
+  renderIcon = () => {
+    return renderNode(this.icon);
+  };
+}

package/src/core/menu/index.ts

@@ -0,0 +1,39 @@
+import { ManaModule } from '../module';
+
+import { DefaultActionMenuItem, DefaultGeneralMenuItem } from './default-menu-node';
+import type { MenuNode, MenuPath } from './menu-protocol';
+import {
+  MenuSymbol,
+  ActionMenuItemFactory,
+  GeneralMenuItemFactory,
+} from './menu-protocol';
+import { MenuRegistry, MenuContribution } from './menu-registry';
+
+export * from './menu-registry';
+export * from './menu-protocol';
+
+export const CoreMenuModule = ManaModule.create()
+  .contribution(MenuContribution)
+  .register(MenuRegistry, DefaultGeneralMenuItem, DefaultActionMenuItem)
+  .register({
+    token: GeneralMenuItemFactory,
+    useDynamic: (ctx) => {
+      return (item: MenuNode, parent: MenuPath) => {
+        const child = ctx.container.createChild();
+        child.register({ token: MenuSymbol.MenuNodeSymbol, useValue: item });
+        child.register({ token: MenuSymbol.ParentPathSymbol, useValue: parent });
+        return child.get(DefaultGeneralMenuItem);
+      };
+    },
+  })
+  .register({
+    token: ActionMenuItemFactory,
+    useDynamic: (ctx) => {
+      return (item: MenuNode, parent: MenuPath) => {
+        const child = ctx.container.createChild();
+        child.register({ token: MenuSymbol.ActionMenuNodeSymbol, useValue: item });
+        child.register({ token: MenuSymbol.ParentPathSymbol, useValue: parent });
+        return child.get(DefaultActionMenuItem);
+      };
+    },
+  });

package/src/core/menu/menu-protocol.ts

@@ -0,0 +1,142 @@
+import type { CommandHandler } from '../command/command-protocol';
+
+import type {
+  DefaultActionMenuItem,
+  DefaultGeneralMenuItem,
+} from './default-menu-node';
+
+export type ActionMenuItem = DefaultActionMenuItem;
+export type GeneralMenuItem = DefaultGeneralMenuItem;
+
+export type MenuPath = string[];
+
+export namespace MenuSymbol {
+  export const MenuNodeSymbol = Symbol('MenuNodeSymbol');
+  export const ActionMenuNodeSymbol = Symbol('ActionMenuNodeSymbol');
+  export const ParentPathSymbol = Symbol('ParentPathSymbol');
+}
+
+/**
+ * Factory for instantiating menu item.
+ */
+export const GeneralMenuItemFactory = Symbol('GeneralMenuItemFactory');
+export interface GeneralMenuItemFactory {
+  (item: MenuNode, menuPath: MenuPath): GeneralMenuItem;
+}
+/**
+ * Factory for instantiating menu item.
+ */
+export const ActionMenuItemFactory = Symbol('ActionMenuItemFactory');
+export interface ActionMenuItemFactory {
+  (item: ActionMenuNode, menuPath: MenuPath): ActionMenuItem;
+}
+/**
+ * Base interface of the nodes used in the menu tree structure.
+ */
+export interface MenuNode {
+  /**
+   * The unique ID of the menu node.
+   */
+  label?: React.ReactNode | React.FC;
+  /**
+   * technical identifier.
+   */
+  readonly id: string;
+  /**
+   * The order to display menu node.
+   */
+  order?: string;
+  /**
+   * Optional icon for the menu item
+   */
+  icon?: React.ReactNode | React.FC;
+}
+export namespace MenuNode {
+  export function is(arg: any): arg is MenuNode {
+    return !!arg && typeof arg === 'object' && 'id' in arg;
+  }
+}
+
+export interface CommandMenuNode extends MenuNode {
+  /**
+   * The command to execute.
+   */
+  command: string;
+  /**
+   * In addition to the mandatory command property, an alternative command can be defined.
+   * It will be shown and invoked when pressing Alt while opening a menu.
+   */
+  alt?: string;
+}
+
+export namespace CommandMenuNode {
+  /* Determine whether object is a MenuAction */
+  // eslint-disable-next-line @typescript-eslint/no-explicit-any
+  export function is(arg: any): arg is CommandMenuNode {
+    return MenuNode.is(arg) && 'command' in arg;
+  }
+}
+
+export interface ExecutableMenuNode extends MenuNode, CommandHandler {
+  command?: string;
+  /**
+   * In addition to the mandatory command property, an alternative command can be defined.
+   * It will be shown and invoked when pressing Alt while opening a menu.
+   */
+  alt?: string;
+}
+export namespace ExecutableMenuNode {
+  /* Determine whether object is a MenuAction */
+  // eslint-disable-next-line @typescript-eslint/no-explicit-any
+  export function is(arg: any): arg is ExecutableMenuNode {
+    return MenuNode.is(arg) && 'execute' in arg;
+  }
+}
+
+export type ActionMenuNode = CommandMenuNode | ExecutableMenuNode;
+export namespace ActionMenuNode {
+  /* Determine whether object is a MenuAction */
+  // eslint-disable-next-line @typescript-eslint/no-explicit-any
+  export function is(arg: any): arg is ActionMenuNode {
+    return CommandMenuNode.is(arg) || ExecutableMenuNode.is(arg);
+  }
+}
+
+export type MenuOptions = Omit<MenuNode, 'id'>;
+
+export namespace MenuItem {
+  /* Determine whether object is a MenuAction */
+  export function isGeneralMenuItem(arg: any): arg is GeneralMenuItem {
+    return (
+      MenuNode.is(arg) && 'children' in arg && ('addNode' in arg || 'removeNode' in arg)
+    );
+  }
+  /* Determine whether object is a MenuAction */
+  export function isActionMenuItem(arg: any): arg is ActionMenuItem {
+    return ActionMenuNode.is(arg) && 'command' in arg && 'onDisposed' in arg;
+  }
+}
+
+export namespace ActionMenuItem {
+  /**
+   * @deprecated use MenuItem.isActionMenuItem instead
+   * @param arg
+   * @returns arg is ActionMenuItem
+   */
+  export function is(arg: any): arg is ActionMenuItem {
+    return MenuItem.isActionMenuItem(arg);
+  }
+}
+
+export namespace GeneralMenuItem {
+  /**
+   * @deprecated use MenuItem.isGeneralMenuItem instead
+   * @param arg
+   * @returns arg is GeneralMenuItem
+   */
+  export function is(arg: any): arg is GeneralMenuItem {
+    return MenuItem.isGeneralMenuItem(arg);
+  }
+}
+
+export type MenuItem = ActionMenuItem | GeneralMenuItem;