@bgx4k3p/huly-mcp-server 2.2.4 → 2.2.5

package/node_modules/prosemirror-menu/dist/index.cjs

@@ -26,8 +26,9 @@ function hashPath(path) {
 }
 function getIcon(root, icon) {
   var doc = (root.nodeType == 9 ? root : root.ownerDocument) || document;
-  var node = doc.createElement("div");
+  var node = doc.createElement("button");
   node.className = prefix$2;
+  node.type = "button";
   if (icon.path) {
     var path = icon.path,
       width = icon.width,
@@ -77,7 +78,9 @@ var MenuItem = function () {
     key: "render",
     value: function render(view) {
       var spec = this.spec;
-      var dom = spec.render ? spec.render(view) : spec.icon ? getIcon(view.root, spec.icon) : spec.label ? crel("div", null, translate(view, spec.label)) : null;
+      var dom = spec.render ? spec.render(view) : spec.icon ? getIcon(view.root, spec.icon) : spec.label ? crel("button", {
+        type: "button"
+      }, translate(view, spec.label)) : null;
       if (!dom) throw new RangeError("MenuItem without icon or label property");
       if (spec.title) {
         var title = typeof spec.title === "function" ? spec.title(view.state) : spec.title;
@@ -85,9 +88,15 @@ var MenuItem = function () {
       }
       if (spec["class"]) dom.classList.add(spec["class"]);
       if (spec.css) dom.style.cssText += spec.css;
+      dom.addEventListener("click", function (e) {
+        if (!dom.classList.contains(prefix$1 + "-disabled")) {
+          var setFocus = document.activeElement == dom || document.activeElement == view.dom;
+          spec.run(view.state, view.dispatch, view, e);
+          if (setFocus && document.activeElement == dom) view.focus();
+        }
+      });
       dom.addEventListener("mousedown", function (e) {
-        e.preventDefault();
-        if (!dom.classList.contains(prefix$1 + "-disabled")) spec.run(view.state, view.dispatch, view, e);
+        return e.preventDefault();
       });
       function update(state) {
         if (spec.select) {
@@ -99,10 +108,12 @@ var MenuItem = function () {
         if (spec.enable) {
           enabled = spec.enable(state) || false;
           setClass(dom, prefix$1 + "-disabled", !enabled);
+          dom.setAttribute("aria-disabled", (!enabled).toString());
         }
         if (spec.active) {
           var active = enabled && spec.active(state) || false;
           setClass(dom, prefix$1 + "-active", active);
+          dom.setAttribute("aria-pressed", active.toString());
         }
         return true;
       }
@@ -133,6 +144,9 @@ var Dropdown = function () {
     var options = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : {};
     _classCallCheck(this, Dropdown);
     this.options = options;
+    this.focusables = [];
+    this.focusIndex = 0;
+    this.focusTimeout = -1;
     this.options = options || {};
     this.content = Array.isArray(content) ? content : [content];
   }
@@ -141,35 +155,61 @@ var Dropdown = function () {
     value: function render(view) {
       var _this = this;
       var content = renderDropdownItems(this.content, view);
+      this.focusables = content.focusables;
       var win = view.dom.ownerDocument.defaultView || window;
-      var label = crel("div", {
+      var btn = crel("button", {
+        type: "button",
         "class": prefix$1 + "-dropdown " + (this.options["class"] || ""),
-        style: this.options.css
+        style: this.options.css,
+        "aria-haspopup": "menu",
+        "aria-expanded": "false"
       }, translate(view, this.options.label || ""));
-      if (this.options.title) label.setAttribute("title", translate(view, this.options.title));
+      if (this.options.title) btn.setAttribute("title", translate(view, this.options.title));
       var wrap = crel("div", {
         "class": prefix$1 + "-dropdown-wrap"
-      }, label);
+      }, btn);
       var open = null;
       var listeningOnClose = null;
       var close = function close() {
         if (open && open.close()) {
           open = null;
-          win.removeEventListener("mousedown", listeningOnClose);
+          win.removeEventListener("click", listeningOnClose);
         }
       };
-      label.addEventListener("mousedown", function (e) {
-        e.preventDefault();
+      btn.addEventListener("click", function (e) {
         markMenuEvent(e);
         if (open) {
           close();
         } else {
-          open = _this.expand(wrap, content.dom);
-          win.addEventListener("mousedown", listeningOnClose = function listeningOnClose() {
+          open = _this.expand(wrap, content.dom, btn);
+          win.addEventListener("click", listeningOnClose = function listeningOnClose() {
             if (!isMenuEvent(wrap)) close();
           });
+          if (e.detail === 0) {
+            var focusIndex = findFocusableIndex(_this.focusables, -1, 1);
+            if (focusIndex != null) _this.setFocusIndex(focusIndex);
+          }
+          open.node.addEventListener("keydown", function (event) {
+            markMenuEvent(event);
+            if (keyboardMoveFocus(_this, event, "vertical")) ;else if (event.key === "Escape") {
+              event.preventDefault();
+              event.stopPropagation();
+              btn.focus();
+              close();
+            }
+          });
+          open.node.addEventListener("focusout", function () {
+            clearTimeout(_this.focusTimeout);
+            _this.focusTimeout = setTimeout(function () {
+              var active = win.document.activeElement;
+              if (active && open && !open.node.contains(active)) close();
+            }, 20);
+          });
         }
       });
+      btn.addEventListener("mousedown", function (e) {
+        return e.preventDefault();
+      });
       function update(state) {
         var inner = content.update(state);
         wrap.style.display = inner ? "" : "none";
@@ -177,12 +217,13 @@ var Dropdown = function () {
       }
       return {
         dom: wrap,
-        update: update
+        update: update,
+        focusable: btn
       };
     }
   }, {
     key: "expand",
-    value: function expand(dom, items) {
+    value: function expand(dom, items, trigger) {
       var menuDOM = crel("div", {
         "class": prefix$1 + "-dropdown-menu " + (this.options["class"] || "")
       }, items);
@@ -191,32 +232,83 @@ var Dropdown = function () {
         if (done) return false;
         done = true;
         dom.removeChild(menuDOM);
+        trigger.ariaControlsElements = [];
+        trigger.setAttribute("aria-expanded", "false");
         return true;
       }
       dom.appendChild(menuDOM);
+      trigger.ariaControlsElements = [items];
+      trigger.setAttribute("aria-expanded", "true");
       return {
         close: close,
         node: menuDOM
       };
     }
+  }, {
+    key: "setFocusIndex",
+    value: function setFocusIndex(index) {
+      if (this.focusables.length <= 1) return;
+      this.focusables[this.focusIndex].setAttribute("tabindex", "-1");
+      this.focusIndex = index;
+      var nextFocusItem = this.focusables[index];
+      nextFocusItem.setAttribute("tabindex", "0");
+      nextFocusItem.focus();
+    }
   }]);
   return Dropdown;
 }();
+function findFocusableIndex(focusables, startIndex, delta) {
+  var length = focusables.length;
+  for (var i = 0, index = startIndex + delta;; index += delta, i++) {
+    var normIndex = (index + length) % length;
+    if (focusables[normIndex].style.display != "none") return normIndex;
+    if (i == length) return null;
+  }
+}
+function keyboardMoveFocus(control, event, orientation) {
+  var focusables = control.focusables,
+    focusIndex = control.focusIndex;
+  var move = event.key == (orientation == "vertical" ? "ArrowDown" : "ArrowRight") ? findFocusableIndex(focusables, focusIndex, 1) : event.key == (orientation == "vertical" ? "ArrowUp" : "ArrowLeft") ? findFocusableIndex(focusables, focusIndex, -1) : event.key == "Home" ? findFocusableIndex(focusables, -1, 1) : event.key == "End" ? findFocusableIndex(focusables, focusables.length, -1) : null;
+  if (move == null) return false;
+  event.preventDefault();
+  event.stopPropagation();
+  control.setFocusIndex(move);
+  return true;
+}
 function renderDropdownItems(items, view) {
-  var rendered = [],
+  var elts = [],
+    focusables = [],
     updates = [];
   for (var i = 0; i < items.length; i++) {
-    var _items$i$render = items[i].render(view),
-      dom = _items$i$render.dom,
-      update = _items$i$render.update;
-    rendered.push(crel("div", {
-      "class": prefix$1 + "-dropdown-item"
+    var item = items[i];
+    var _item$render = item.render(view),
+      dom = _item$render.dom,
+      _update = _item$render.update,
+      focusable = _item$render.focusable;
+    elts.push(crel("li", {
+      "class": "".concat(prefix$1, "-dropdown-item"),
+      role: "menuitem",
+      "tabindex": "-1"
     }, dom));
-    updates.push(update);
+    focusables.push(focusable || dom);
+    updates.push(_update);
+  }
+  function update(state) {
+    var something = false;
+    for (var _i = 0; _i < elts.length; _i++) {
+      var _dom = elts[_i],
+        up = updates[_i](state);
+      if (up) something = true;
+      _dom.style.display = up ? "" : "none";
+    }
+    return something;
   }
   return {
-    dom: rendered,
-    update: combineUpdates(updates, rendered)
+    dom: crel("ul", {
+      role: "menu"
+    }, elts),
+    update: update,
+    focusables: focusables
   };
 }
 function combineUpdates(updates, nodes) {
@@ -235,33 +327,67 @@ var DropdownSubmenu = function () {
     var options = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : {};
     _classCallCheck(this, DropdownSubmenu);
     this.options = options;
+    this.focusables = [];
+    this.focusIndex = 0;
+    this.focusTimeout = -1;
     this.content = Array.isArray(content) ? content : [content];
   }
   _createClass(DropdownSubmenu, [{
     key: "render",
     value: function render(view) {
+      var _this2 = this;
       var items = renderDropdownItems(this.content, view);
+      this.focusables = items.focusables;
       var win = view.dom.ownerDocument.defaultView || window;
-      var label = crel("div", {
+      var btn = crel("button", {
+        type: "button",
         "class": prefix$1 + "-submenu-label"
       }, translate(view, this.options.label || ""));
       var wrap = crel("div", {
         "class": prefix$1 + "-submenu-wrap"
-      }, label, crel("div", {
+      }, btn, crel("div", {
         "class": prefix$1 + "-submenu"
       }, items.dom));
       var _listeningOnClose = null;
-      label.addEventListener("mousedown", function (e) {
+      var openSubmenu = function openSubmenu(e) {
         e.preventDefault();
+        e.stopPropagation();
         markMenuEvent(e);
-        setClass(wrap, prefix$1 + "-submenu-wrap-active", false);
-        if (!_listeningOnClose) win.addEventListener("mousedown", _listeningOnClose = function listeningOnClose() {
+        setClass(wrap, prefix$1 + "-submenu-wrap-active", true);
+        if (!_listeningOnClose) win.addEventListener("click", _listeningOnClose = function listeningOnClose() {
           if (!isMenuEvent(wrap)) {
             wrap.classList.remove(prefix$1 + "-submenu-wrap-active");
-            win.removeEventListener("mousedown", _listeningOnClose);
+            win.removeEventListener("click", _listeningOnClose);
             _listeningOnClose = null;
           }
         });
+        if (!(e.type == "click" && e.detail)) {
+          var focusIndex = findFocusableIndex(_this2.focusables, -1, 1);
+          if (focusIndex != null) _this2.setFocusIndex(focusIndex);
+        }
+      };
+      btn.addEventListener("click", openSubmenu);
+      btn.addEventListener("keydown", function (e) {
+        if (e.key === "ArrowRight") openSubmenu(e);
+      });
+      btn.addEventListener("mousedown", function (e) {
+        return e.preventDefault();
+      });
+      items.dom.addEventListener("keydown", function (event) {
+        markMenuEvent(event);
+        if (keyboardMoveFocus(_this2, event, "vertical")) ;else if (event.key === "Escape" || event.key === "ArrowLeft") {
+          event.preventDefault();
+          event.stopPropagation();
+          setClass(wrap, prefix$1 + "-submenu-wrap-active", false);
+          btn.focus();
+        }
+      });
+      items.dom.addEventListener("focusout", function () {
+        clearTimeout(_this2.focusTimeout);
+        _this2.focusTimeout = setTimeout(function () {
+          var active = win.document.activeElement;
+          if (active && !items.dom.contains(active)) wrap.classList.remove(prefix$1 + "-submenu-wrap-active");
+        }, 20);
       });
       function update(state) {
         var inner = items.update(state);
@@ -270,15 +396,27 @@ var DropdownSubmenu = function () {
       }
       return {
         dom: wrap,
-        update: update
+        update: update,
+        focusable: btn
       };
     }
+  }, {
+    key: "setFocusIndex",
+    value: function setFocusIndex(index) {
+      if (this.focusables.length <= 1) return;
+      this.focusables[this.focusIndex].setAttribute("tabindex", "-1");
+      this.focusIndex = index;
+      var nextFocusItem = this.focusables[index];
+      nextFocusItem.setAttribute("tabindex", "0");
+      nextFocusItem.focus();
+    }
   }]);
   return DropdownSubmenu;
 }();
 function renderGrouped(view, content) {
   var result = document.createDocumentFragment();
   var updates = [],
+    focusables = [],
     separators = [];
   for (var i = 0; i < content.length; i++) {
     var items = content[i],
@@ -287,13 +425,15 @@ function renderGrouped(view, content) {
     for (var j = 0; j < items.length; j++) {
       var _items$j$render = items[j].render(view),
         dom = _items$j$render.dom,
-        _update = _items$j$render.update;
+        _update2 = _items$j$render.update,
+        focusable = _items$j$render.focusable;
+      focusables.push(focusable || dom);
       var span = crel("span", {
         "class": prefix$1 + "item"
       }, dom);
       result.appendChild(span);
       localNodes.push(span);
-      localUpdates.push(_update);
+      localUpdates.push(_update2);
     }
     if (localUpdates.length) {
       updates.push(combineUpdates(localUpdates, localNodes));
@@ -303,9 +443,9 @@ function renderGrouped(view, content) {
   function update(state) {
     var something = false,
       needSep = false;
-    for (var _i = 0; _i < updates.length; _i++) {
-      var hasContent = updates[_i](state);
-      if (_i) separators[_i - 1].style.display = needSep && hasContent ? "" : "none";
+    for (var _i2 = 0; _i2 < updates.length; _i2++) {
+      var hasContent = updates[_i2](state);
+      if (_i2) separators[_i2 - 1].style.display = needSep && hasContent ? "" : "none";
       needSep = hasContent;
       if (hasContent) something = true;
     }
@@ -313,12 +453,14 @@ function renderGrouped(view, content) {
   }
   return {
     dom: result,
-    update: update
+    update: update,
+    focusables: focusables
   };
 }
 function separator() {
   return crel("span", {
-    "class": prefix$1 + "separator"
+    "class": prefix$1 + "separator",
+    role: "separator"
   });
 }
 var icons = {
@@ -471,10 +613,12 @@ function menuBar(options) {
 }
 var MenuBarView = function () {
   function MenuBarView(editorView, options) {
-    var _this2 = this;
+    var _this3 = this;
     _classCallCheck(this, MenuBarView);
     this.editorView = editorView;
     this.options = options;
+    this.focusables = [];
+    this.focusIndex = 0;
     this.spacer = null;
     this.maxHeight = 0;
     this.widthForMaxHeight = 0;
@@ -485,32 +629,67 @@ var MenuBarView = function () {
       "class": prefix + "-wrapper"
     });
     this.menu = this.wrapper.appendChild(crel("div", {
-      "class": prefix
+      "class": prefix,
+      role: "toolbar"
     }));
     this.menu.className = prefix;
+    this.menu.ariaControlsElements = [editorView.dom];
     if (editorView.dom.parentNode) editorView.dom.parentNode.replaceChild(this.wrapper, editorView.dom);
-    this.wrapper.appendChild(editorView.dom);
+    if (options.position === "after") {
+      this.wrapper.insertBefore(editorView.dom, this.wrapper.firstChild);
+    } else {
+      this.wrapper.appendChild(editorView.dom);
+    }
     var _renderGrouped = renderGrouped(this.editorView, this.options.content),
       dom = _renderGrouped.dom,
-      update = _renderGrouped.update;
+      update = _renderGrouped.update,
+      focusables = _renderGrouped.focusables;
     this.contentUpdate = update;
+    this.focusables = focusables;
     this.menu.appendChild(dom);
-    this.update();
     if (options.floating && !isIOS()) {
       this.updateFloat();
       var potentialScrollers = getAllWrapping(this.wrapper);
       this.scrollHandler = function (e) {
-        var root = _this2.editorView.root;
-        if (!(root.body || root).contains(_this2.wrapper)) potentialScrollers.forEach(function (el) {
-          return el.removeEventListener("scroll", _this2.scrollHandler);
-        });else _this2.updateFloat(e.target.getBoundingClientRect ? e.target : undefined);
+        var root = _this3.editorView.root;
+        if (!(root.body || root).contains(_this3.wrapper)) potentialScrollers.forEach(function (el) {
+          return el.removeEventListener("scroll", _this3.scrollHandler);
+        });else _this3.updateFloat(e.target.getBoundingClientRect ? e.target : undefined);
       };
       potentialScrollers.forEach(function (el) {
-        return el.addEventListener('scroll', _this2.scrollHandler);
+        return el.addEventListener('scroll', _this3.scrollHandler);
       });
     }
+    var _loop = function _loop(i) {
+      var focusable = focusables[i];
+      if (i) focusable.setAttribute("tabindex", "-1");
+      focusable.addEventListener("focus", function () {
+        if (_this3.focusIndex === i) return;
+        var prevFocusItem = _this3.focusables[_this3.focusIndex];
+        prevFocusItem.setAttribute("tabindex", "-1");
+        focusable.setAttribute("tabindex", "0");
+        _this3.focusIndex = i;
+      });
+    };
+    for (var i = 0; i < focusables.length; i++) {
+      _loop(i);
+    }
+    this.menu.addEventListener("keydown", function (event) {
+      keyboardMoveFocus(_this3, event, "horizontal");
+    });
+    this.update();
   }
   _createClass(MenuBarView, [{
+    key: "setFocusIndex",
+    value: function setFocusIndex(index) {
+      if (this.focusables.length <= 1) return;
+      this.focusables[this.focusIndex].setAttribute("tabindex", "-1");
+      this.focusIndex = index;
+      var nextFocusItem = this.focusables[index];
+      nextFocusItem.setAttribute("tabindex", "0");
+      nextFocusItem.focus();
+    }
+  }, {
     key: "update",
     value: function update() {
       if (this.editorView.root != this.root) {
@@ -521,7 +700,12 @@ var MenuBarView = function () {
         this.menu.replaceChild(dom, this.menu.firstChild);
         this.root = this.editorView.root;
       }
+      var active = this.editorView.dom.ownerDocument.activeElement == this.focusables[this.focusIndex];
       this.contentUpdate(this.editorView.state);
+      if (active && this.focusables[this.focusIndex].style.display == "none") {
+        var next = findFocusableIndex(this.focusables, this.focusIndex, 1);
+        if (next != null) this.setFocusIndex(next);
+      }
       if (this.floating) {
         this.updateScrollCursor();
       } else {

package/node_modules/prosemirror-menu/dist/index.d.cts

@@ -12,21 +12,24 @@ interface MenuElement {
     Render the element for display in the menu. Must return a DOM
     element and a function that can be used to update the element to
     a new state. The `update` function must return false if the
-    update hid the entire element.
+    update hid the entire element. May also return a `focusable`
+    DOM node, which is the node that should receive focus when this
+    element is focused. If not provided, the `dom` element will be used.
     */
     render(pm: EditorView): {
         dom: HTMLElement;
         update: (state: EditorState) => boolean;
+        focusable?: HTMLElement;
     };
 }
 /**
 An icon or label that, when clicked, executes a command.
 */
-declare class MenuItem implements MenuElement {
+declare class MenuItem<E extends HTMLElement = HTMLButtonElement> implements MenuElement {
     /**
     The spec used to create this item.
     */
-    readonly spec: MenuItemSpec;
+    readonly spec: MenuItemSpec<E>;
     /**
     Create a menu item.
     */
@@ -34,14 +37,14 @@ declare class MenuItem implements MenuElement {
     /**
     The spec used to create this item.
     */
-    spec: MenuItemSpec);
+    spec: MenuItemSpec<E>);
     /**
     Renders the icon according to its [display
     spec](https://prosemirror.net/docs/ref/#menu.MenuItemSpec.display), and adds an event handler which
     executes the command when the representation is clicked.
     */
     render(view: EditorView): {
-        dom: HTMLElement;
+        dom: HTMLButtonElement | E;
         update: (state: EditorState) => boolean;
     };
 }
@@ -68,7 +71,7 @@ type IconSpec = {
 /**
 The configuration object passed to the `MenuItem` constructor.
 */
-interface MenuItemSpec {
+interface MenuItemSpec<E extends HTMLElement = HTMLButtonElement> {
     /**
     The function to execute when the menu item is activated.
     */
@@ -94,7 +97,7 @@ interface MenuItemSpec {
     A function that renders the item. You must provide either this,
     [`icon`](https://prosemirror.net/docs/ref/#menu.MenuItemSpec.icon), or [`label`](https://prosemirror.net/docs/ref/#MenuItemSpec.label).
     */
-    render?: (view: EditorView) => HTMLElement;
+    render?: (view: EditorView) => E;
     /**
     Describes an icon to show for this item.
     */
@@ -124,6 +127,7 @@ A drop-down menu, displayed as a label with a downwards-pointing
 triangle to the right of it.
 */
 declare class Dropdown implements MenuElement {
+    private focusTimeout;
     /**
     Create a dropdown wrapping the elements.
     */
@@ -157,13 +161,16 @@ declare class Dropdown implements MenuElement {
     render(view: EditorView): {
         dom: HTMLElement;
         update: (state: EditorState) => boolean;
+        focusable: HTMLElement;
     };
+    setFocusIndex(index: number): void;
 }
 /**
 Represents a submenu wrapping a group of elements that start
 hidden and expand to the right when hovered over or tapped.
 */
 declare class DropdownSubmenu implements MenuElement {
+    private focusTimeout;
     /**
     Creates a submenu for the given group of menu elements. The
     following options are recognized:
@@ -184,7 +191,9 @@ declare class DropdownSubmenu implements MenuElement {
     render(view: EditorView): {
         dom: HTMLElement;
         update: (state: EditorState) => boolean;
+        focusable: HTMLElement;
     };
+    setFocusIndex(index: number): void;
 }
 /**
 Render the given, possibly nested, array of menu elements into a
@@ -195,6 +204,7 @@ be empty).
 declare function renderGrouped(view: EditorView, content: readonly (readonly MenuElement[])[]): {
     dom: DocumentFragment;
     update: (state: EditorState) => boolean;
+    focusables: HTMLElement[];
 };
 /**
 A set of basic editor-related icons. Contains the properties
@@ -209,23 +219,23 @@ declare const icons: {
 /**
 Menu item for the `joinUp` command.
 */
-declare const joinUpItem: MenuItem;
+declare const joinUpItem: MenuItem<HTMLButtonElement>;
 /**
 Menu item for the `lift` command.
 */
-declare const liftItem: MenuItem;
+declare const liftItem: MenuItem<HTMLButtonElement>;
 /**
 Menu item for the `selectParentNode` command.
 */
-declare const selectParentNodeItem: MenuItem;
+declare const selectParentNodeItem: MenuItem<HTMLButtonElement>;
 /**
 Menu item for the `undo` command.
 */
-declare let undoItem: MenuItem;
+declare let undoItem: MenuItem<HTMLButtonElement>;
 /**
 Menu item for the `redo` command.
 */
-declare let redoItem: MenuItem;
+declare let redoItem: MenuItem<HTMLButtonElement>;
 /**
 Build a menu item for wrapping the selection in a given node type.
 Adds `run` and `select` properties to the ones present in
@@ -234,7 +244,7 @@ attributes for the wrapping node.
 */
 declare function wrapItem(nodeType: NodeType, options: Partial<MenuItemSpec> & {
     attrs?: Attrs | null;
-}): MenuItem;
+}): MenuItem<HTMLButtonElement>;
 /**
 Build a menu item for changing the type of the textblock around the
 selection to the given type. Provides `run`, `active`, and `select`
@@ -243,7 +253,7 @@ be an object to provide the attributes for the textblock node.
 */
 declare function blockTypeItem(nodeType: NodeType, options: Partial<MenuItemSpec> & {
     attrs?: Attrs | null;
-}): MenuItem;
+}): MenuItem<HTMLButtonElement>;
 
 /**
 A plugin that will place a menu bar above the editor. Note that
@@ -256,6 +266,11 @@ declare function menuBar(options: {
     */
     content: readonly (readonly MenuElement[])[];
     /**
+    Determines whether the menu is placed before or after the editor in the DOM.
+    The default is "before".
+    */
+    position?: "before" | "after";
+    /**
     Determines whether the menu floats, i.e. whether it sticks to
     the top of the viewport when the editor is partially scrolled
     out of view.