@portabletext/editor 1.55.6 → 1.55.7

package/lib/index.d.cts

@@ -960,7 +960,7 @@ export declare type EditorEmittedEvent =
     }
   | {
       /**
-       * @deprecated
+       * @deprecated Will be removed in the next major version
        */
       type: 'done loading'
     }
@@ -979,7 +979,7 @@ export declare type EditorEmittedEvent =
     }
   | {
       /**
-       * @deprecated
+       * @deprecated Will be removed in the next major version
        */
       type: 'loading'
     }
@@ -3417,7 +3417,7 @@ export declare type ListSchemaType = BaseDefinition & {
  * The editor is currently loading something
  * Could be used to show a spinner etc.
  * @beta
- * @deprecated
+ * @deprecated Will be removed in the next major version
  */
 export declare type LoadingChange = {
   type: 'loading'
@@ -3620,7 +3620,7 @@ export {PortableTextChild}
  */
 export declare const PortableTextEditable: ForwardRefExoticComponent<
   Omit<PortableTextEditableProps, 'ref'> &
-    RefAttributes<Omit<HTMLDivElement, 'onPaste' | 'onBeforeInput' | 'as'>>
+    RefAttributes<Omit<HTMLDivElement, 'as' | 'onPaste' | 'onBeforeInput'>>
 >
 
 /**
@@ -3756,9 +3756,9 @@ export declare class PortableTextEditor extends Component<
     path: Path,
   ) => [
     (
-      | PortableTextSpan
       | PortableTextObject
-      | PortableTextTextBlock<PortableTextSpan | PortableTextObject>
+      | PortableTextSpan
+      | PortableTextTextBlock<PortableTextObject | PortableTextSpan>
       | undefined
     ),
     Path | undefined,

package/lib/index.d.ts

@@ -960,7 +960,7 @@ export declare type EditorEmittedEvent =
     }
   | {
       /**
-       * @deprecated
+       * @deprecated Will be removed in the next major version
        */
       type: 'done loading'
     }
@@ -979,7 +979,7 @@ export declare type EditorEmittedEvent =
     }
   | {
       /**
-       * @deprecated
+       * @deprecated Will be removed in the next major version
        */
       type: 'loading'
     }
@@ -3417,7 +3417,7 @@ export declare type ListSchemaType = BaseDefinition & {
  * The editor is currently loading something
  * Could be used to show a spinner etc.
  * @beta
- * @deprecated
+ * @deprecated Will be removed in the next major version
  */
 export declare type LoadingChange = {
   type: 'loading'
@@ -3620,7 +3620,7 @@ export {PortableTextChild}
  */
 export declare const PortableTextEditable: ForwardRefExoticComponent<
   Omit<PortableTextEditableProps, 'ref'> &
-    RefAttributes<Omit<HTMLDivElement, 'onPaste' | 'onBeforeInput' | 'as'>>
+    RefAttributes<Omit<HTMLDivElement, 'as' | 'onPaste' | 'onBeforeInput'>>
 >
 
 /**
@@ -3756,9 +3756,9 @@ export declare class PortableTextEditor extends Component<
     path: Path,
   ) => [
     (
-      | PortableTextSpan
       | PortableTextObject
-      | PortableTextTextBlock<PortableTextSpan | PortableTextObject>
+      | PortableTextSpan
+      | PortableTextTextBlock<PortableTextObject | PortableTextSpan>
       | undefined
     ),
     Path | undefined,

package/lib/index.js

@@ -9,7 +9,7 @@ import { Element as Element$1, Text, Range, Editor, Node, Point, Transforms, Pat
 import { useSelected, useSlateSelector, useSlateStatic, withReact, ReactEditor, Slate, useSlate, Editable } from "slate-react";
 import debug$f from "debug";
 import { DOMEditor, isDOMNode } from "slate-dom";
-import { getBlockStartPoint, getBlockKeyFromSelectionPoint, getChildKeyFromSelectionPoint, isTextBlock, parseBlock, parseAnnotation, blockOffsetToSpanSelectionPoint, parseInlineObject, isKeyedSegment, isSpan$1 as isSpan, isListBlock, isTypedObject, getSelectionStartPoint, getSelectionEndPoint, getTextBlockText, parseBlocks } from "./_chunks-es/selection-point.js";
+import { getBlockStartPoint, getBlockKeyFromSelectionPoint, getChildKeyFromSelectionPoint, isTextBlock, parseBlock, parseAnnotation, blockOffsetToSpanSelectionPoint, parseInlineObject, isKeyedSegment, isSpan$1 as isSpan, isListBlock, isTypedObject, getSelectionStartPoint, getSelectionEndPoint, getTextBlockText, parseBlocks } from "./_chunks-es/util.slice-blocks.js";
 import { getBlockEndPoint, isEmptyTextBlock, isEqualSelectionPoints } from "./_chunks-es/util.is-equal-selection-points.js";
 import { isSelectionCollapsed, selectionPointToBlockOffset, sliceTextBlock } from "./_chunks-es/util.slice-text-block.js";
 import isEqual from "lodash/isEqual.js";
@@ -5380,125 +5380,211 @@ const addAnnotationOnCollapsedSelection = defineBehavior({
   })]]
 }), coreAnnotationBehaviors = {
   addAnnotationOnCollapsedSelection
-}, IS_MAC = typeof window < "u" && /Mac|iPod|iPhone|iPad/.test(window.navigator.userAgent), modifiers = {
-  alt: "altKey",
-  control: "ctrlKey",
-  meta: "metaKey",
-  shift: "shiftKey"
-}, aliases = {
-  add: "+",
-  break: "pause",
-  cmd: "meta",
-  command: "meta",
-  ctl: "control",
-  ctrl: "control",
-  del: "delete",
-  down: "arrowdown",
-  esc: "escape",
-  ins: "insert",
-  left: "arrowleft",
-  mod: IS_MAC ? "meta" : "control",
-  opt: "alt",
-  option: "alt",
-  return: "enter",
-  right: "arrowright",
-  space: " ",
-  spacebar: " ",
-  up: "arrowup",
-  win: "meta",
-  windows: "meta"
-}, keyCodes = {
-  backspace: 8,
-  tab: 9,
-  enter: 13,
-  shift: 16,
-  control: 17,
-  alt: 18,
-  pause: 19,
-  capslock: 20,
-  escape: 27,
-  " ": 32,
-  pageup: 33,
-  pagedown: 34,
-  end: 35,
-  home: 36,
-  arrowleft: 37,
-  arrowup: 38,
-  arrowright: 39,
-  arrowdown: 40,
-  insert: 45,
-  delete: 46,
-  meta: 91,
-  numlock: 144,
-  scrolllock: 145,
-  ";": 186,
-  "=": 187,
-  ",": 188,
-  "-": 189,
-  ".": 190,
-  "/": 191,
-  "`": 192,
-  "[": 219,
-  "\\": 220,
-  "]": 221,
-  "'": 222,
-  f1: 112,
-  f2: 113,
-  f3: 114,
-  f4: 115,
-  f5: 116,
-  f6: 117,
-  f7: 118,
-  f8: 119,
-  f9: 120,
-  f10: 121,
-  f11: 122,
-  f12: 123,
-  f13: 124,
-  f14: 125,
-  f15: 126,
-  f16: 127,
-  f17: 128,
-  f18: 129,
-  f19: 130,
-  f20: 131
 };
-function isHotkey(hotkey, event) {
-  return compareHotkey(parseHotkey(hotkey), event);
-}
-function parseHotkey(hotkey) {
-  const parsedHotkey = {
-    altKey: !1,
-    ctrlKey: !1,
-    metaKey: !1,
-    shiftKey: !1
-  }, hotkeySegments = hotkey.replace("++", "+add").split("+");
-  for (const rawHotkeySegment of hotkeySegments) {
-    const optional = rawHotkeySegment.endsWith("?") && rawHotkeySegment.length > 1, hotkeySegment = optional ? rawHotkeySegment.slice(0, -1) : rawHotkeySegment, keyName = toKeyName(hotkeySegment), modifier = modifiers[keyName], alias = aliases[hotkeySegment], code = keyCodes[keyName];
-    if (hotkeySegment.length > 1 && modifier === void 0 && alias === void 0 && code === void 0)
-      throw new TypeError(`Unknown modifier: "${hotkeySegment}"`);
-    (hotkeySegments.length === 1 || modifier === void 0) && (parsedHotkey.key = keyName, parsedHotkey.keyCode = toKeyCode(hotkeySegment)), modifier !== void 0 && (parsedHotkey[modifier] = optional ? null : !0);
-  }
-  return parsedHotkey;
-}
-function compareHotkey(parsedHotkey, event) {
-  return (parsedHotkey.altKey == null || parsedHotkey.altKey === event.altKey) && (parsedHotkey.ctrlKey == null || parsedHotkey.ctrlKey === event.ctrlKey) && (parsedHotkey.metaKey == null || parsedHotkey.metaKey === event.metaKey) && (parsedHotkey.shiftKey == null || parsedHotkey.shiftKey === event.shiftKey) ? parsedHotkey.keyCode !== void 0 && event.keyCode !== void 0 ? parsedHotkey.keyCode === 91 && event.keyCode === 93 ? !0 : parsedHotkey.keyCode === event.keyCode : parsedHotkey.keyCode === event.keyCode || parsedHotkey.key === event.key.toLowerCase() : !1;
-}
-function toKeyCode(name) {
-  const keyName = toKeyName(name);
-  return keyCodes[keyName] ?? keyName.toUpperCase().charCodeAt(0);
-}
-function toKeyName(name) {
-  const keyName = name.toLowerCase();
-  return aliases[keyName] ?? keyName;
-}
-const arrowDownOnLonelyBlockObject = defineBehavior({
+function isKeyboardShortcut(event, key, allowedModifiers = {}) {
+  return event.key.toLowerCase() === key.toLowerCase() && (allowedModifiers.ctrlKey === event.ctrlKey || allowedModifiers.ctrlKey === void 0) && (allowedModifiers.metaKey === event.metaKey || allowedModifiers.metaKey === void 0) && (allowedModifiers.shiftKey === event.shiftKey || allowedModifiers.shiftKey === void 0) && (allowedModifiers.altKey === event.altKey || allowedModifiers.altKey === void 0);
+}
+const IS_APPLE = typeof window < "u" && /Mac|iPod|iPhone|iPad/.test(window.navigator.userAgent);
+function createKeyboardShortcut(definition) {
+  return IS_APPLE ? definition.apple ?? definition.default : definition.default;
+}
+const defaultKeyboardShortcuts = {
+  arrowDown: createKeyboardShortcut({
+    default: {
+      guard: (event) => isKeyboardShortcut(event, "ArrowDown", {
+        ctrlKey: !1,
+        metaKey: !1,
+        shiftKey: !1,
+        altKey: !1
+      }),
+      keys: ["ArrowDown"]
+    }
+  }),
+  arrowUp: createKeyboardShortcut({
+    default: {
+      guard: (event) => isKeyboardShortcut(event, "ArrowUp", {
+        ctrlKey: !1,
+        metaKey: !1,
+        shiftKey: !1,
+        altKey: !1
+      }),
+      keys: ["ArrowUp"]
+    }
+  }),
+  break: createKeyboardShortcut({
+    default: {
+      guard: (event) => isKeyboardShortcut(event, "Enter", {
+        shiftKey: !1
+      }),
+      keys: ["Enter"]
+    }
+  }),
+  lineBreak: createKeyboardShortcut({
+    default: {
+      guard: (event) => isKeyboardShortcut(event, "Enter", {
+        shiftKey: !0
+      }),
+      keys: ["Shift", "Enter"]
+    }
+  }),
+  decorators: {
+    strong: createKeyboardShortcut({
+      default: {
+        guard: (event) => isKeyboardShortcut(event, "b", {
+          altKey: !1,
+          ctrlKey: !0,
+          metaKey: !1,
+          shiftKey: !1
+        }),
+        keys: ["Ctrl", "B"]
+      },
+      apple: {
+        guard: (event) => isKeyboardShortcut(event, "b", {
+          altKey: !1,
+          ctrlKey: !1,
+          metaKey: !0,
+          shiftKey: !1
+        }),
+        keys: ["\u2318", "B"]
+      }
+    }),
+    em: createKeyboardShortcut({
+      default: {
+        guard: (event) => isKeyboardShortcut(event, "i", {
+          altKey: !1,
+          ctrlKey: !0,
+          metaKey: !1,
+          shiftKey: !1
+        }),
+        keys: ["Ctrl", "I"]
+      },
+      apple: {
+        guard: (event) => isKeyboardShortcut(event, "i", {
+          altKey: !1,
+          ctrlKey: !1,
+          metaKey: !0,
+          shiftKey: !1
+        }),
+        keys: ["\u2318", "I"]
+      }
+    }),
+    underline: createKeyboardShortcut({
+      default: {
+        guard: (event) => isKeyboardShortcut(event, "u", {
+          altKey: !1,
+          ctrlKey: !0,
+          metaKey: !1,
+          shiftKey: !1
+        }),
+        keys: ["Ctrl", "U"]
+      },
+      apple: {
+        guard: (event) => isKeyboardShortcut(event, "u", {
+          altKey: !1,
+          ctrlKey: !1,
+          metaKey: !0,
+          shiftKey: !1
+        }),
+        keys: ["\u2318", "U"]
+      }
+    }),
+    code: createKeyboardShortcut({
+      default: {
+        guard: (event) => isKeyboardShortcut(event, "'", {
+          altKey: !1,
+          ctrlKey: !0,
+          metaKey: !1,
+          shiftKey: !1
+        }),
+        keys: ["Ctrl", "'"]
+      },
+      apple: {
+        guard: (event) => isKeyboardShortcut(event, "'", {
+          altKey: !1,
+          ctrlKey: !1,
+          metaKey: !0,
+          shiftKey: !1
+        }),
+        keys: ["\u2318", "'"]
+      }
+    })
+  },
+  history: {
+    undo: createKeyboardShortcut({
+      default: {
+        guard: (event) => isKeyboardShortcut(event, "z", {
+          altKey: !1,
+          ctrlKey: !0,
+          metaKey: !1,
+          shiftKey: !1
+        }),
+        keys: ["Ctrl", "Z"]
+      },
+      apple: {
+        guard: (event) => isKeyboardShortcut(event, "z", {
+          altKey: !1,
+          ctrlKey: !1,
+          metaKey: !0,
+          shiftKey: !1
+        }),
+        keys: ["\u2318", "Z"]
+      }
+    }),
+    redo: createKeyboardShortcut({
+      default: {
+        guard: (event) => isKeyboardShortcut(event, "y", {
+          ctrlKey: !0,
+          metaKey: !1,
+          shiftKey: !1,
+          altKey: !1
+        }) || isKeyboardShortcut(event, "z", {
+          ctrlKey: !0,
+          metaKey: !1,
+          shiftKey: !0,
+          altKey: !1
+        }),
+        keys: ["Ctrl", "Y"]
+      },
+      apple: {
+        guard: (event) => isKeyboardShortcut(event, "z", {
+          ctrlKey: !1,
+          metaKey: !0,
+          shiftKey: !0,
+          altKey: !1
+        }),
+        keys: ["\u2318", "Shift", "Z"]
+      }
+    })
+  },
+  tab: createKeyboardShortcut({
+    default: {
+      guard: (event) => isKeyboardShortcut(event, "Tab", {
+        ctrlKey: !1,
+        metaKey: !1,
+        shiftKey: !1,
+        altKey: !1
+      }),
+      keys: ["Tab"]
+    }
+  }),
+  shiftTab: createKeyboardShortcut({
+    default: {
+      guard: (event) => isKeyboardShortcut(event, "Tab", {
+        ctrlKey: !1,
+        metaKey: !1,
+        shiftKey: !0,
+        altKey: !1
+      }),
+      keys: ["Shift", "Tab"]
+    }
+  })
+}, arrowDownOnLonelyBlockObject = defineBehavior({
   on: "keyboard.keydown",
   guard: ({
     snapshot,
     event
   }) => {
-    if (!isHotkey("ArrowDown", event.originEvent) || !isSelectionCollapsed$1(snapshot))
+    if (!defaultKeyboardShortcuts.arrowDown.guard(event.originEvent) || !isSelectionCollapsed$1(snapshot))
       return !1;
     const focusBlockObject = getFocusBlockObject(snapshot), nextBlock = getNextBlock(snapshot);
     return focusBlockObject && !nextBlock;
@@ -5518,7 +5604,7 @@ const arrowDownOnLonelyBlockObject = defineBehavior({
     snapshot,
     event
   }) => {
-    if (!isHotkey("ArrowUp", event.originEvent) || !isSelectionCollapsed$1(snapshot))
+    if (!defaultKeyboardShortcuts.arrowUp.guard(event.originEvent) || !isSelectionCollapsed$1(snapshot))
       return !1;
     const focusBlockObject = getFocusBlockObject(snapshot), previousBlock = getPreviousBlock(snapshot);
     return focusBlockObject && !previousBlock;
@@ -5697,7 +5783,7 @@ const arrowDownOnLonelyBlockObject = defineBehavior({
     guard: ({
       snapshot,
       event
-    }) => isHotkey("mod+b", event.originEvent) && snapshot.context.schema.decorators.some((decorator) => decorator.name === "strong"),
+    }) => defaultKeyboardShortcuts.decorators.strong.guard(event.originEvent) && snapshot.context.schema.decorators.some((decorator) => decorator.name === "strong"),
     actions: [() => [raise({
       type: "decorator.toggle",
       decorator: "strong"
@@ -5708,7 +5794,7 @@ const arrowDownOnLonelyBlockObject = defineBehavior({
     guard: ({
       snapshot,
       event
-    }) => isHotkey("mod+i", event.originEvent) && snapshot.context.schema.decorators.some((decorator) => decorator.name === "em"),
+    }) => defaultKeyboardShortcuts.decorators.em.guard(event.originEvent) && snapshot.context.schema.decorators.some((decorator) => decorator.name === "em"),
     actions: [() => [raise({
       type: "decorator.toggle",
       decorator: "em"
@@ -5719,7 +5805,7 @@ const arrowDownOnLonelyBlockObject = defineBehavior({
     guard: ({
       snapshot,
       event
-    }) => isHotkey("mod+u", event.originEvent) && snapshot.context.schema.decorators.some((decorator) => decorator.name === "underline"),
+    }) => defaultKeyboardShortcuts.decorators.underline.guard(event.originEvent) && snapshot.context.schema.decorators.some((decorator) => decorator.name === "underline"),
     actions: [() => [raise({
       type: "decorator.toggle",
       decorator: "underline"
@@ -5730,7 +5816,7 @@ const arrowDownOnLonelyBlockObject = defineBehavior({
     guard: ({
       snapshot,
       event
-    }) => isHotkey("mod+'", event.originEvent) && snapshot.context.schema.decorators.some((decorator) => decorator.name === "code"),
+    }) => defaultKeyboardShortcuts.decorators.code.guard(event.originEvent) && snapshot.context.schema.decorators.some((decorator) => decorator.name === "code"),
     actions: [() => [raise({
       type: "decorator.toggle",
       decorator: "code"
@@ -6223,7 +6309,7 @@ const coreDndBehaviors = [
     snapshot,
     event
   }) => {
-    if (!isHotkey("Tab", event.originEvent))
+    if (!defaultKeyboardShortcuts.tab.guard(event.originEvent))
       return !1;
     const selectedBlocks = getSelectedBlocks(snapshot), selectedListBlocks = selectedBlocks.flatMap((block) => isListBlock(snapshot.context, block.node) ? [{
       node: block.node,
@@ -6248,7 +6334,7 @@ const coreDndBehaviors = [
     snapshot,
     event
   }) => {
-    if (!isHotkey("Shift+Tab", event.originEvent))
+    if (!defaultKeyboardShortcuts.shiftTab.guard(event.originEvent))
       return !1;
     const selectedBlocks = getSelectedBlocks(snapshot), selectedListBlocks = selectedBlocks.flatMap((block) => isListBlock(snapshot.context, block.node) ? [{
       node: block.node,
@@ -6621,16 +6707,17 @@ const coreDndBehaviors = [
     text: `
 `
   })]]
-})], keyIs = {
-  break: (event) => event.key === "Enter" && !event.shiftKey,
-  lineBreak: (event) => event.key === "Enter" && event.shiftKey
-}, abstractKeyboardBehaviors = [
+})], abstractKeyboardBehaviors = [
+  /**
+   * Allow raising an `insert.break` event when pressing Enter on an inline
+   * object.
+   */
   defineBehavior({
     on: "keyboard.keydown",
     guard: ({
       snapshot,
       event
-    }) => keyIs.break(event.originEvent) && isSelectionCollapsed$1(snapshot) && getFocusInlineObject(snapshot),
+    }) => defaultKeyboardShortcuts.break.guard(event.originEvent) && isSelectionCollapsed$1(snapshot) && getFocusInlineObject(snapshot),
     actions: [() => [raise({
       type: "insert.break"
     })]]
@@ -6644,10 +6731,34 @@ const coreDndBehaviors = [
     on: "keyboard.keydown",
     guard: ({
       event
-    }) => keyIs.lineBreak(event.originEvent),
+    }) => defaultKeyboardShortcuts.lineBreak.guard(event.originEvent),
     actions: [() => [raise({
       type: "insert.soft break"
     })]]
+  }),
+  /**
+   * Manual handling of undo shortcuts.
+   */
+  defineBehavior({
+    on: "keyboard.keydown",
+    guard: ({
+      event
+    }) => defaultKeyboardShortcuts.history.undo.guard(event.originEvent),
+    actions: [() => [raise({
+      type: "history.undo"
+    })]]
+  }),
+  /**
+   * Manual handling of redo shortcuts.
+   */
+  defineBehavior({
+    on: "keyboard.keydown",
+    guard: ({
+      event
+    }) => defaultKeyboardShortcuts.history.redo.guard(event.originEvent),
+    actions: [() => [raise({
+      type: "history.redo"
+    })]]
   })
 ], abstractListItemBehaviors = [defineBehavior({
   on: "list item.add",
@@ -10576,6 +10687,118 @@ function RenderText(props) {
   let t0;
   return $[0] !== props.attributes || $[1] !== props.children || $[2] !== props.text._key || $[3] !== props.text._type ? (t0 = /* @__PURE__ */ jsx("span", { ...props.attributes, "data-child-key": props.text._key, "data-child-name": props.text._type, "data-child-type": "span", children: props.children }), $[0] = props.attributes, $[1] = props.children, $[2] = props.text._key, $[3] = props.text._type, $[4] = t0) : t0 = $[4], t0;
 }
+const IS_MAC = typeof window < "u" && /Mac|iPod|iPhone|iPad/.test(window.navigator.userAgent), modifiers = {
+  alt: "altKey",
+  control: "ctrlKey",
+  meta: "metaKey",
+  shift: "shiftKey"
+}, aliases = {
+  add: "+",
+  break: "pause",
+  cmd: "meta",
+  command: "meta",
+  ctl: "control",
+  ctrl: "control",
+  del: "delete",
+  down: "arrowdown",
+  esc: "escape",
+  ins: "insert",
+  left: "arrowleft",
+  mod: IS_MAC ? "meta" : "control",
+  opt: "alt",
+  option: "alt",
+  return: "enter",
+  right: "arrowright",
+  space: " ",
+  spacebar: " ",
+  up: "arrowup",
+  win: "meta",
+  windows: "meta"
+}, keyCodes = {
+  backspace: 8,
+  tab: 9,
+  enter: 13,
+  shift: 16,
+  control: 17,
+  alt: 18,
+  pause: 19,
+  capslock: 20,
+  escape: 27,
+  " ": 32,
+  pageup: 33,
+  pagedown: 34,
+  end: 35,
+  home: 36,
+  arrowleft: 37,
+  arrowup: 38,
+  arrowright: 39,
+  arrowdown: 40,
+  insert: 45,
+  delete: 46,
+  meta: 91,
+  numlock: 144,
+  scrolllock: 145,
+  ";": 186,
+  "=": 187,
+  ",": 188,
+  "-": 189,
+  ".": 190,
+  "/": 191,
+  "`": 192,
+  "[": 219,
+  "\\": 220,
+  "]": 221,
+  "'": 222,
+  f1: 112,
+  f2: 113,
+  f3: 114,
+  f4: 115,
+  f5: 116,
+  f6: 117,
+  f7: 118,
+  f8: 119,
+  f9: 120,
+  f10: 121,
+  f11: 122,
+  f12: 123,
+  f13: 124,
+  f14: 125,
+  f15: 126,
+  f16: 127,
+  f17: 128,
+  f18: 129,
+  f19: 130,
+  f20: 131
+};
+function isHotkey(hotkey, event) {
+  return compareHotkey(parseHotkey(hotkey), event);
+}
+function parseHotkey(hotkey) {
+  const parsedHotkey = {
+    altKey: !1,
+    ctrlKey: !1,
+    metaKey: !1,
+    shiftKey: !1
+  }, hotkeySegments = hotkey.replace("++", "+add").split("+");
+  for (const rawHotkeySegment of hotkeySegments) {
+    const optional = rawHotkeySegment.endsWith("?") && rawHotkeySegment.length > 1, hotkeySegment = optional ? rawHotkeySegment.slice(0, -1) : rawHotkeySegment, keyName = toKeyName(hotkeySegment), modifier = modifiers[keyName], alias = aliases[hotkeySegment], code = keyCodes[keyName];
+    if (hotkeySegment.length > 1 && modifier === void 0 && alias === void 0 && code === void 0)
+      throw new TypeError(`Unknown modifier: "${hotkeySegment}"`);
+    (hotkeySegments.length === 1 || modifier === void 0) && (parsedHotkey.key = keyName, parsedHotkey.keyCode = toKeyCode(hotkeySegment)), modifier !== void 0 && (parsedHotkey[modifier] = optional ? null : !0);
+  }
+  return parsedHotkey;
+}
+function compareHotkey(parsedHotkey, event) {
+  return (parsedHotkey.altKey == null || parsedHotkey.altKey === event.altKey) && (parsedHotkey.ctrlKey == null || parsedHotkey.ctrlKey === event.ctrlKey) && (parsedHotkey.metaKey == null || parsedHotkey.metaKey === event.metaKey) && (parsedHotkey.shiftKey == null || parsedHotkey.shiftKey === event.shiftKey) ? parsedHotkey.keyCode !== void 0 && event.keyCode !== void 0 ? parsedHotkey.keyCode === 91 && event.keyCode === 93 ? !0 : parsedHotkey.keyCode === event.keyCode : parsedHotkey.keyCode === event.keyCode || parsedHotkey.key === event.key.toLowerCase() : !1;
+}
+function toKeyCode(name) {
+  const keyName = toKeyName(name);
+  return keyCodes[keyName] ?? keyName.toUpperCase().charCodeAt(0);
+}
+function toKeyName(name) {
+  const keyName = name.toLowerCase();
+  return aliases[keyName] ?? keyName;
+}
 const debug$1 = debugWithName("plugin:withHotKeys");
 function createWithHotkeys(editorActor, portableTextEditor, hotkeysFromOptions) {
   const reservedHotkeys = ["enter", "tab", "shift", "delete", "end"], activeHotkeys = hotkeysFromOptions ?? {};