@rcarls/rc-menu-button 0.1.0

package/README.md

@@ -0,0 +1,130 @@
+# `@rcarls/rc-menu-button`
+
+A WAI-ARIA compliant menu button component implementing the [Menu Button pattern](https://www.w3.org/WAI/ARIA/apg/patterns/menu-button/). Wraps a trigger element and an `rc-menu` popup, wiring ARIA attributes, light-dismiss, and keyboard open/close automatically. Built with [Lit 3](https://lit.dev).
+
+---
+
+## Installation
+
+```bash
+npm install @rcarls/rc-menu-button
+```
+
+## Import
+
+```js
+import '@rcarls/rc-menu-button';                         // side-effect: registers <rc-menu-button>
+import { RCMenuButton } from '@rcarls/rc-menu-button';   // named class export
+```
+
+`rc-menu-button` depends on `rc-menu`. Ensure both are installed.
+
+---
+
+## Basic usage
+
+Place a trigger element in the `trigger` slot and an `rc-menu` in the default slot.
+
+```html
+<rc-menu-button>
+  <button slot="trigger">File</button>
+
+  <rc-menu label="File">
+    <button>New</button>
+    <button>Open…</button>
+    <button>Save</button>
+  </rc-menu>
+</rc-menu-button>
+```
+
+The component automatically sets `aria-haspopup="menu"` and `aria-expanded` on the trigger, and closes the menu when the user clicks outside or selects an item.
+
+---
+
+## API
+
+### Properties / attributes
+
+| Property | Attribute | Type | Default | Description |
+|---|---|---|---|---|
+| `open` | `open` | `boolean` | `false` | Whether the menu popup is visible. Reflects to attribute. |
+| `orientation` | `orientation` | `'horizontal' \| 'vertical' \| undefined` | `undefined` | Arrow-key axis for opening the menu. When unset, inherited from a parent `rc-menubar` or `[role="menubar"]` element. Falls back to `'horizontal'`. |
+
+### CSS custom properties
+
+| Property | Default | Description |
+|---|---|---|
+| `--rc-menu-button-popup-z-index` | `1000` | `z-index` of the popup container |
+
+### CSS parts
+
+| Part | Element | Description |
+|---|---|---|
+| `root` | Outer `div` | Root wrapper |
+| `popup` | Popup `div` | Container that shows/hides around the slotted `rc-menu` |
+
+### Slots
+
+| Slot | Description |
+|---|---|
+| `trigger` | The button (or other interactive element) that toggles the menu. Receives `aria-haspopup` and `aria-expanded` automatically. |
+| *(default)* | The `rc-menu` to show as the popup. |
+
+### Events
+
+| Event | Bubbles | Cancelable | Detail | When |
+|---|---|---|---|---|
+| `rc-menu-button-toggle` | Yes (composed) | No | `{ open: boolean }` | Menu opens or closes |
+
+### Public methods
+
+```ts
+openMenu(focusTarget?: 'first' | 'last'): void
+  // Open the menu. Focuses the first or last item after render.
+
+closeMenu(returnFocus?: boolean): void
+  // Close the menu. If returnFocus is true (default), restores focus to the trigger.
+
+toggleMenu(): void
+  // Toggle open/closed.
+```
+
+---
+
+## Keyboard behaviour
+
+Keyboard handling depends on the resolved `orientation` (horizontal by default, or inherited from a parent menubar).
+
+| Key | Condition | Action |
+|---|---|---|
+| `ArrowDown` | Horizontal orientation | Open menu, focus first item |
+| `ArrowUp` | Horizontal orientation | Open menu, focus last item |
+| `ArrowRight` | Vertical orientation | Open menu, focus first item |
+| `ArrowLeft` | Vertical orientation | Open menu, focus last item |
+| `Enter` / `Space` | Menu closed | Open menu |
+| `Enter` / `Space` | Menu open | Activate focused item, close menu |
+| `Escape` | Menu open | Close menu, return focus to trigger |
+
+---
+
+## ARIA
+
+| Attribute | Where | Value |
+|---|---|---|
+| `aria-haspopup="menu"` | Trigger element | Set automatically on slot change |
+| `aria-expanded` | Trigger element | `"true"` / `"false"`, kept in sync with `open` |
+| `open` | Host element | Reflected boolean attribute when menu is open |
+
+---
+
+## Notes
+
+**Popup positioning** currently uses `position: absolute; top: 100%; left: 0` relative to the host. A future release will migrate to `AnchorController` (CSS Anchor Positioning) to support directional flipping and better viewport-aware placement.
+
+**Light dismiss** is active at all times. A capture-phase `click` listener on `document` closes the menu whenever the click falls outside the component boundary (checked via `composedPath()`).
+
+---
+
+## Browser support
+
+All modern browsers. Requires Web Components support (Chrome 67+, Firefox 63+, Safari 12.1+).

package/dist/custom-elements.json

@@ -0,0 +1,485 @@
+{
+  "schemaVersion": "1.0.0",
+  "readme": "",
+  "modules": [
+    {
+      "kind": "javascript-module",
+      "path": "src/define.ts",
+      "declarations": [],
+      "exports": [
+        {
+          "kind": "custom-element-definition",
+          "name": "rc-menu-button",
+          "declaration": {
+            "name": "RCMenuButton",
+            "module": "/src/index.js"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "*",
+          "declaration": {
+            "name": "*",
+            "module": "src/index.js"
+          }
+        }
+      ]
+    },
+    {
+      "kind": "javascript-module",
+      "path": "src/index.ts",
+      "declarations": [],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "*",
+          "declaration": {
+            "name": "*",
+            "module": "src/rc-menu-button"
+          }
+        }
+      ]
+    },
+    {
+      "kind": "javascript-module",
+      "path": "src/rc-menu-button.ts",
+      "declarations": [
+        {
+          "kind": "class",
+          "description": "A menu button component that opens/closes a menu popup",
+          "name": "RCMenuButton",
+          "cssProperties": [
+            {
+              "description": "Minimum block size of the trigger",
+              "name": "--rc-menu-button-trigger-block-size",
+              "default": "var(--rc-control-block-size)"
+            },
+            {
+              "description": "Trigger block-axis padding",
+              "name": "--rc-menu-button-trigger-padding-block",
+              "default": "var(--rc-control-padding-block)"
+            },
+            {
+              "description": "Trigger inline-axis padding",
+              "name": "--rc-menu-button-trigger-padding-inline",
+              "default": "var(--rc-control-padding-inline)"
+            },
+            {
+              "description": "Trigger border",
+              "name": "--rc-menu-button-trigger-border",
+              "default": "var(--rc-border)"
+            },
+            {
+              "description": "Trigger border radius",
+              "name": "--rc-menu-button-trigger-radius",
+              "default": "var(--rc-control-radius)"
+            },
+            {
+              "description": "Trigger background",
+              "name": "--rc-menu-button-trigger-background",
+              "default": "var(--rc-button-bg)"
+            },
+            {
+              "description": "Trigger text color",
+              "name": "--rc-menu-button-trigger-color",
+              "default": "var(--rc-button-text)"
+            },
+            {
+              "description": "Z-index of the popup overlay",
+              "name": "--rc-menu-button-popup-z-index",
+              "default": "1000"
+            }
+          ],
+          "cssParts": [
+            {
+              "description": "The root container element",
+              "name": "root"
+            },
+            {
+              "description": "The popup container element",
+              "name": "popup"
+            }
+          ],
+          "slots": [
+            {
+              "description": "The button element that triggers the menu",
+              "name": "trigger"
+            },
+            {
+              "description": "The rc-menu element to display as popup",
+              "name": "default"
+            }
+          ],
+          "members": [
+            {
+              "kind": "field",
+              "name": "shadowRootOptions",
+              "type": {
+                "text": "ShadowRootInit"
+              },
+              "static": true,
+              "default": "{ ...LitElement.shadowRootOptions, delegatesFocus: true, }",
+              "description": "Enables delegatesFocus so the browser routes focus() on the host element\nto the slotted trigger button. This lets the host participate in a\nroving-tabindex group (e.g. rc-toolbar) as a single tab stop while the\ntrigger remains the visible focus target."
+            },
+            {
+              "kind": "field",
+              "name": "_defaultOpen",
+              "type": {
+                "text": "boolean"
+              },
+              "privacy": "private",
+              "default": "false"
+            },
+            {
+              "kind": "field",
+              "name": "_open",
+              "type": {
+                "text": "boolean"
+              },
+              "privacy": "private",
+              "default": "false"
+            },
+            {
+              "kind": "field",
+              "name": "open",
+              "type": {
+                "text": "boolean"
+              },
+              "description": "Whether the menu is currently open. Host writes update silently.",
+              "attribute": "open",
+              "reflects": true
+            },
+            {
+              "kind": "field",
+              "name": "defaultOpen",
+              "type": {
+                "text": "boolean"
+              },
+              "description": "Initial uncontrolled open state.",
+              "attribute": "default-open"
+            },
+            {
+              "kind": "field",
+              "name": "orientation",
+              "type": {
+                "text": "'horizontal' | 'vertical' | undefined"
+              },
+              "description": "Orientation of this menu button, affects which arrow keys open/close the menu.\nIf not set, inherits from a parent rc-menubar or element with role=\"menubar\".",
+              "attribute": "orientation",
+              "reflects": true
+            },
+            {
+              "kind": "field",
+              "name": "placement",
+              "type": {
+                "text": "AnchorPlacement"
+              },
+              "default": "'bottom-start'",
+              "description": "Preferred placement of the popup relative to the trigger button.",
+              "attribute": "placement",
+              "reflects": true
+            },
+            {
+              "kind": "field",
+              "name": "_effectivePlacement",
+              "type": {
+                "text": "AnchorPlacement"
+              },
+              "privacy": "private",
+              "readonly": true
+            },
+            {
+              "kind": "field",
+              "name": "_resolvedOrientation",
+              "type": {
+                "text": "'horizontal' | 'vertical'"
+              },
+              "privacy": "private",
+              "description": "Resolved orientation, considering inheritance from parent menubar.\nFalls back to 'horizontal' if no orientation is set or inherited.",
+              "readonly": true
+            },
+            {
+              "kind": "field",
+              "name": "_$root",
+              "type": {
+                "text": "HTMLElement"
+              },
+              "privacy": "private"
+            },
+            {
+              "kind": "field",
+              "name": "_$popup",
+              "type": {
+                "text": "HTMLElement"
+              },
+              "privacy": "private"
+            },
+            {
+              "kind": "field",
+              "name": "_trigger",
+              "type": {
+                "text": "WeakRef<HTMLElement> | undefined"
+              },
+              "privacy": "private",
+              "description": "Reference to the trigger button element"
+            },
+            {
+              "kind": "field",
+              "name": "_menu",
+              "type": {
+                "text": "WeakRef<RCMenu> | undefined"
+              },
+              "privacy": "private",
+              "description": "Reference to the menu element"
+            },
+            {
+              "kind": "field",
+              "name": "_anchorCtrl",
+              "privacy": "private",
+              "default": "new AnchorController(this, { anchor: () => this._$root ?? null, floating: () => this._$popup ?? null, shadowHost: () => this, placement: 'bottom-start', offset: 2, })"
+            },
+            {
+              "kind": "field",
+              "name": "_boundHandleDocumentClick",
+              "privacy": "private",
+              "description": "Bound handler for document click (light dismiss)"
+            },
+            {
+              "kind": "field",
+              "name": "_tabObserver",
+              "type": {
+                "text": "MutationObserver | undefined"
+              },
+              "privacy": "private",
+              "description": "Watches the host's own `tabindex` attribute so the trigger button's\ntabindex can be kept in sync. When a parent (e.g. rc-toolbar) places the\nhost under roving-tabindex management it sets/removes tabindex on the\nhost; we mirror that to the trigger so it doesn't become an independent\ntab stop. When the host has no tabindex the trigger keeps its natural\ntabindex=0 for standalone usage."
+            },
+            {
+              "kind": "method",
+              "name": "openMenu",
+              "parameters": [
+                {
+                  "name": "focusTarget",
+                  "default": "'first'",
+                  "type": {
+                    "text": "'first' | 'last'"
+                  }
+                }
+              ],
+              "description": "Opens the menu and focuses the first or last item"
+            },
+            {
+              "kind": "method",
+              "name": "closeMenu",
+              "parameters": [
+                {
+                  "name": "returnFocus",
+                  "default": "true"
+                }
+              ],
+              "description": "Closes the menu and optionally returns focus to trigger"
+            },
+            {
+              "kind": "method",
+              "name": "toggleMenu",
+              "description": "Toggles the menu open/closed"
+            },
+            {
+              "kind": "method",
+              "name": "_dispatchToggle",
+              "privacy": "private"
+            },
+            {
+              "kind": "method",
+              "name": "_handleTriggerSlotChange",
+              "privacy": "private",
+              "parameters": [
+                {
+                  "name": "e",
+                  "type": {
+                    "text": "Event"
+                  }
+                }
+              ]
+            },
+            {
+              "kind": "method",
+              "name": "_syncTriggerTabindex",
+              "privacy": "private",
+              "description": "Mirrors the host's `tabindex` attribute to the trigger button.\n\nWhen a roving-tabindex parent (e.g. rc-toolbar) marks this host inactive\nwith `tabindex=\"-1\"`, the trigger must also be suppressed so it does not\nbecome an independent tab stop. When the host is the active item\n(`tabindex=\"0\"`) or standalone (no tabindex), the trigger retains its\nnatural focusability so that Chrome's delegatesFocus can route sequential\nTab navigation through the host to the trigger."
+            },
+            {
+              "kind": "method",
+              "name": "focus",
+              "parameters": [
+                {
+                  "name": "options",
+                  "optional": true,
+                  "type": {
+                    "text": "FocusOptions"
+                  }
+                }
+              ],
+              "description": "Overrides the default focus() so that programmatic focus calls (e.g. from\na roving-tabindex parent navigating back to this element via arrow keys)\nalways reach the trigger.\n\nChrome's delegatesFocus will not delegate to a tabindex=\"-1\" element, so\nwhen the toolbar marks this host inactive it suppresses the trigger — and\nthe next focusItem() call silently fails. Lifting the suppression here and\ndirectly calling trigger.focus() bypasses that restriction."
+            },
+            {
+              "kind": "method",
+              "name": "_handleMenuSlotChange",
+              "privacy": "private",
+              "parameters": [
+                {
+                  "name": "e",
+                  "type": {
+                    "text": "Event"
+                  }
+                }
+              ]
+            },
+            {
+              "kind": "field",
+              "name": "_onNavigate",
+              "privacy": "private"
+            },
+            {
+              "kind": "method",
+              "name": "_handleTriggerClick",
+              "privacy": "private",
+              "parameters": [
+                {
+                  "name": "e",
+                  "type": {
+                    "text": "MouseEvent"
+                  }
+                }
+              ]
+            },
+            {
+              "kind": "method",
+              "name": "_handleMenuClose",
+              "privacy": "private"
+            },
+            {
+              "kind": "method",
+              "name": "_handleMenuActivate",
+              "privacy": "private"
+            },
+            {
+              "kind": "method",
+              "name": "_handleDocumentClick",
+              "privacy": "private",
+              "parameters": [
+                {
+                  "name": "e",
+                  "type": {
+                    "text": "MouseEvent"
+                  }
+                }
+              ]
+            },
+            {
+              "kind": "method",
+              "name": "_setOpen",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "open",
+                  "type": {
+                    "text": "boolean"
+                  }
+                },
+                {
+                  "name": "dispatch",
+                  "type": {
+                    "text": "boolean"
+                  }
+                }
+              ]
+            },
+            {
+              "kind": "method",
+              "name": "_syncTriggerAria",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              }
+            }
+          ],
+          "events": [
+            {
+              "name": "rc-menu-button-toggle",
+              "type": {
+                "text": "CustomEvent"
+              },
+              "description": "Fired when the menu opens or closes"
+            }
+          ],
+          "attributes": [
+            {
+              "description": "Preferred placement of the popup relative to the trigger button.",
+              "name": "placement",
+              "type": {
+                "text": "AnchorPlacement"
+              },
+              "default": "'bottom-start'",
+              "fieldName": "placement"
+            },
+            {
+              "name": "open",
+              "type": {
+                "text": "boolean"
+              },
+              "description": "Whether the menu is currently open. Host writes update silently.",
+              "fieldName": "open"
+            },
+            {
+              "name": "default-open",
+              "type": {
+                "text": "boolean"
+              },
+              "description": "Initial uncontrolled open state.",
+              "fieldName": "defaultOpen"
+            },
+            {
+              "name": "orientation",
+              "type": {
+                "text": "'horizontal' | 'vertical' | undefined"
+              },
+              "description": "Orientation of this menu button, affects which arrow keys open/close the menu.\nIf not set, inherits from a parent rc-menubar or element with role=\"menubar\".",
+              "fieldName": "orientation"
+            }
+          ],
+          "superclass": {
+            "name": "LitElement",
+            "package": "lit"
+          },
+          "tagName": "rc-menu-button",
+          "customElement": true
+        }
+      ],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "RCMenuButton",
+          "declaration": {
+            "name": "RCMenuButton",
+            "module": "src/rc-menu-button.ts"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "default",
+          "declaration": {
+            "name": "RCMenuButton",
+            "module": "src/rc-menu-button.ts"
+          }
+        }
+      ]
+    }
+  ]
+}

package/dist/demo.css

@@ -0,0 +1,85 @@
+*, *::before, *::after {
+  box-sizing: border-box;
+}
+
+:root {
+  color-scheme: light dark;
+  --rc-accent: Highlight; /* Chrome doesn't support AccentColor on the open web */
+}
+
+@supports (color: AccentColor) {
+  :root {
+    --rc-accent: AccentColor;
+  }
+}
+
+[data-theme="light"] { color-scheme: light; }
+[data-theme="dark"]  { color-scheme: dark;  }
+
+[data-theme="solarized-light"] {
+  color-scheme: light;
+  --rc-surface: #fdf6e3;
+  --rc-text:    #657b83;
+  --rc-border:  1px solid #93a1a1;
+  --rc-shadow:  0 2px 8px rgba(0, 0, 0, .12);
+}
+
+[data-theme="solarized-dark"] {
+  color-scheme: dark;
+  --rc-surface: #002b36;
+  --rc-text:    #839496;
+  --rc-border:  1px solid #586e75;
+  --rc-shadow:  0 2px 8px rgba(0, 0, 0, .3);
+}
+
+body {
+  font-family: system-ui, sans-serif;
+  margin: 0;
+}
+
+.demo-page {
+  max-width: 60rem;
+  margin: 0 auto;
+  padding: 2rem 1.5rem;
+}
+
+.demo-controls {
+  display: flex;
+  align-items: center;
+  gap: 1rem;
+  margin-bottom: 2rem;
+  padding-bottom: 1rem;
+  border-bottom: 1px solid ButtonBorder;
+}
+
+.demo-controls .demo-title {
+  flex: 1;
+}
+
+.demo-controls h1 {
+  margin: 0 0 0.15rem;
+  font-size: 1.5rem;
+}
+
+.demo-controls a {
+  font-size: 0.8rem;
+}
+
+.demo-section {
+  margin-bottom: 2rem;
+}
+
+.demo-section h2 {
+  margin: 0 0 0.5rem;
+}
+
+.theme-picker {
+  padding: 0.35em 0.75em;
+  font-family: inherit;
+  font-size: 0.8rem;
+  cursor: pointer;
+  border: 1px solid ButtonBorder;
+  border-radius: 4px;
+  background: Canvas;
+  color: CanvasText;
+}

package/dist/demo.js

@@ -0,0 +1,40 @@
+const THEMES = ['', 'light', 'dark', 'solarized-light', 'solarized-dark'];
+const LABELS = ['Auto', 'Light', 'Dark', 'Solarized ☀', 'Solarized ☾'];
+
+const stored = localStorage.getItem('rc-demo-theme') ?? '';
+applyTheme(stored);
+
+function applyTheme(theme) {
+  if (theme) {
+    document.documentElement.dataset.theme = theme;
+  } else {
+    delete document.documentElement.dataset.theme;
+  }
+}
+
+function currentIndex() {
+  const current = document.documentElement.dataset.theme ?? '';
+  const idx = THEMES.indexOf(current);
+  return idx === -1 ? 0 : idx;
+}
+
+function updateButtons() {
+  const label = LABELS[currentIndex()];
+  document.querySelectorAll('.theme-picker').forEach((btn) => {
+    btn.textContent = label;
+  });
+}
+
+window.cycleTheme = function () {
+  const next = THEMES[(currentIndex() + 1) % THEMES.length];
+  applyTheme(next);
+  localStorage.setItem('rc-demo-theme', next);
+  updateButtons();
+};
+
+document.addEventListener('DOMContentLoaded', () => {
+  updateButtons();
+  document.querySelectorAll('.theme-picker').forEach((btn) => {
+    btn.addEventListener('click', window.cycleTheme);
+  });
+});

package/dist/rc-menu-button-CmzW7P4h.js

@@ -0,0 +1,270 @@
+import { css as g, LitElement as p, html as b } from "lit";
+import { property as l, query as h, state as d } from "lit/decorators.js";
+import { AnchorController as f, keyNavigation as m } from "@rcarls/rc-common";
+const _ = g`
+  :host {
+    display: inline-block;
+  }
+
+  :host([orientation='vertical']) {
+    display: block;
+  }
+
+  #root {
+    display: inline-block;
+  }
+
+  :host([orientation='vertical']) #root {
+    display: block;
+  }
+
+  #trigger-wrap {
+    display: contents;
+  }
+
+  slot[name='trigger']::slotted(button),
+  slot[name='trigger']::slotted([role='button']) {
+    min-block-size: var(--rc-menu-button-trigger-block-size, var(--rc-control-block-size, 2.25em));
+    padding: var(--rc-menu-button-trigger-padding-block, var(--rc-control-padding-block, 0.25em))
+      var(--rc-menu-button-trigger-padding-inline, var(--rc-control-padding-inline, 0.5em));
+    border: var(--rc-menu-button-trigger-border, var(--rc-border, 1px solid ButtonBorder));
+    border-radius: var(--rc-menu-button-trigger-radius, var(--rc-control-radius, 0.125em));
+    background: var(--rc-menu-button-trigger-background, var(--rc-button-bg, ButtonFace));
+    color: var(--rc-menu-button-trigger-color, var(--rc-button-text, ButtonText));
+    font: inherit;
+  }
+
+  :host([orientation='vertical']) slot[name='trigger']::slotted(button),
+  :host([orientation='vertical']) slot[name='trigger']::slotted([role='button']) {
+    inline-size: 100%;
+    text-align: start;
+  }
+
+  #popup {
+    z-index: var(--rc-menu-button-popup-z-index, 1000);
+  }
+
+  #popup[hidden] {
+    display: none;
+  }
+`;
+var v = Object.defineProperty, O = Object.getOwnPropertyDescriptor, o = (u, t, e, r) => {
+  for (var n = r > 1 ? void 0 : r ? O(t, e) : t, s = u.length - 1, c; s >= 0; s--)
+    (c = u[s]) && (n = (r ? c(t, e, n) : c(n)) || n);
+  return r && n && v(t, e, n), n;
+};
+const a = class a extends p {
+  constructor() {
+    super(...arguments), this._defaultOpen = !1, this._open = !1, this.placement = "bottom-start", this._anchorCtrl = new f(this, {
+      anchor: () => this._$root ?? null,
+      floating: () => this._$popup ?? null,
+      shadowHost: () => this,
+      placement: "bottom-start",
+      offset: 2
+    }), this._boundHandleDocumentClick = this._handleDocumentClick.bind(this), this._onNavigate = (t) => {
+      switch (t) {
+        case "open-to-first":
+        case "activate":
+          this.openMenu();
+          break;
+        case "open-to-last":
+          this.openMenu("last");
+          break;
+        case "escape":
+          this.closeMenu();
+          break;
+      }
+    };
+  }
+  get open() {
+    return this._open;
+  }
+  /** Whether the menu is currently open. Host writes update silently. */
+  set open(t) {
+    const e = this._open;
+    t !== void 0 && (this._setOpen(t, !1), this.requestUpdate("open", e));
+  }
+  get defaultOpen() {
+    return this._defaultOpen;
+  }
+  /** Initial uncontrolled open state. */
+  set defaultOpen(t) {
+    const e = this._defaultOpen;
+    this._defaultOpen = t, t && !this._open && this._setOpen(!0, !1), this.requestUpdate("defaultOpen", e);
+  }
+  get _effectivePlacement() {
+    return this.placement !== "bottom-start" ? this.placement : this._resolvedOrientation === "vertical" ? "right-start" : this.placement;
+  }
+  /**
+   * Resolved orientation, considering inheritance from parent menubar.
+   * Falls back to 'horizontal' if no orientation is set or inherited.
+   */
+  get _resolvedOrientation() {
+    if (this.orientation) return this.orientation;
+    const t = this.closest('rc-menubar, [role="menubar"]');
+    if (t) {
+      const e = t.getAttribute("orientation") ?? t.getAttribute("aria-orientation");
+      if (e === "vertical") return "vertical";
+      if (e === "horizontal") return "horizontal";
+    }
+    return "horizontal";
+  }
+  connectedCallback() {
+    super.connectedCallback(), this._tabObserver = new MutationObserver(() => this._syncTriggerTabindex()), this._tabObserver.observe(this, { attributes: !0, attributeFilter: ["tabindex"] }), document.addEventListener("click", this._boundHandleDocumentClick, !0), this.defaultOpen && this._setOpen(!0, !1);
+  }
+  disconnectedCallback() {
+    this._tabObserver?.disconnect(), this._tabObserver = void 0, super.disconnectedCallback(), document.removeEventListener("click", this._boundHandleDocumentClick, !0);
+  }
+  /** Opens the menu and focuses the first or last item */
+  openMenu(t = "first") {
+    this.open || (this._anchorCtrl.setOptions({ placement: this._effectivePlacement }), this._setOpen(!0, !0), this._anchorCtrl.update(), this.updateComplete.then(() => {
+      const e = this._menu?.deref();
+      t === "last" ? e?.focusLast() : e?.focusFirst();
+    }));
+  }
+  /** Closes the menu and optionally returns focus to trigger */
+  closeMenu(t = !0) {
+    this.open && (this._setOpen(!1, !0), t && this._trigger?.deref()?.focus());
+  }
+  /** Toggles the menu open/closed */
+  toggleMenu() {
+    this.open ? this.closeMenu() : this.openMenu();
+  }
+  _dispatchToggle() {
+    this.dispatchEvent(
+      new CustomEvent("rc-menu-button-toggle", {
+        bubbles: !0,
+        composed: !0,
+        detail: { open: this.open }
+      })
+    );
+  }
+  _handleTriggerSlotChange(t) {
+    const r = t.currentTarget.assignedElements()[0];
+    r && (this._trigger = new WeakRef(r), this._syncTriggerAria(), this._syncTriggerTabindex());
+  }
+  /**
+   * Mirrors the host's `tabindex` attribute to the trigger button.
+   *
+   * When a roving-tabindex parent (e.g. rc-toolbar) marks this host inactive
+   * with `tabindex="-1"`, the trigger must also be suppressed so it does not
+   * become an independent tab stop. When the host is the active item
+   * (`tabindex="0"`) or standalone (no tabindex), the trigger retains its
+   * natural focusability so that Chrome's delegatesFocus can route sequential
+   * Tab navigation through the host to the trigger.
+   */
+  _syncTriggerTabindex() {
+    const t = this._trigger?.deref();
+    t && (this.getAttribute("tabindex") === "-1" ? t.setAttribute("tabindex", "-1") : t.removeAttribute("tabindex"));
+  }
+  /**
+   * Overrides the default focus() so that programmatic focus calls (e.g. from
+   * a roving-tabindex parent navigating back to this element via arrow keys)
+   * always reach the trigger.
+   *
+   * Chrome's delegatesFocus will not delegate to a tabindex="-1" element, so
+   * when the toolbar marks this host inactive it suppresses the trigger — and
+   * the next focusItem() call silently fails. Lifting the suppression here and
+   * directly calling trigger.focus() bypasses that restriction.
+   */
+  focus(t) {
+    const e = this._trigger?.deref();
+    if (!e) {
+      super.focus(t);
+      return;
+    }
+    e.removeAttribute("tabindex"), e.focus(t);
+  }
+  _handleMenuSlotChange(t) {
+    const n = t.currentTarget.assignedElements().find((s) => s.tagName === "RC-MENU");
+    n && (this._menu = new WeakRef(n));
+  }
+  _handleTriggerClick(t) {
+    t.preventDefault(), this.toggleMenu();
+  }
+  _handleMenuClose() {
+    this.closeMenu();
+  }
+  _handleMenuActivate() {
+    this.closeMenu();
+  }
+  _handleDocumentClick(t) {
+    !this.open || t.composedPath().includes(this) || this.closeMenu(!1);
+  }
+  updated(t) {
+    super.updated(t), t.has("open") && this._syncTriggerAria(), (t.has("placement") || t.has("orientation")) && this._anchorCtrl.setOptions({ placement: this._effectivePlacement });
+  }
+  _setOpen(t, e) {
+    if (this._open === t) return;
+    const r = this._open;
+    this._open = t, this.requestUpdate("open", r), this._syncTriggerAria(), e && this._dispatchToggle();
+  }
+  _syncTriggerAria() {
+    const t = this._trigger?.deref();
+    t?.isConnected && (t.setAttribute("aria-haspopup", "menu"), t.setAttribute("aria-expanded", String(this.open)));
+  }
+  render() {
+    return b`
+      <div id="root" part="root">
+        <div
+          id="trigger-wrap"
+          ${m(this._onNavigate, {
+      navigationAxis: this._resolvedOrientation,
+      handleNavAxis: !1,
+      handleOpenAxis: !0,
+      handleActivate: !0,
+      handleEscape: this.open
+    })}
+          @click=${this._handleTriggerClick}
+        >
+          <slot
+            name="trigger"
+            @slotchange=${this._handleTriggerSlotChange}
+          ></slot>
+        </div>
+        <div
+          id="popup"
+          part="popup"
+          ?hidden=${!this.open}
+          @rc-menu-close=${this._handleMenuClose}
+          @rc-menu-activate=${this._handleMenuActivate}
+        >
+          <slot @slotchange=${this._handleMenuSlotChange}></slot>
+        </div>
+      </div>
+    `;
+  }
+};
+a.styles = [_], a.shadowRootOptions = {
+  ...p.shadowRootOptions,
+  delegatesFocus: !0
+};
+let i = a;
+o([
+  l({ type: Boolean, reflect: !0 })
+], i.prototype, "open", 1);
+o([
+  l({ type: Boolean, attribute: "default-open" })
+], i.prototype, "defaultOpen", 1);
+o([
+  l({ type: String, reflect: !0 })
+], i.prototype, "orientation", 2);
+o([
+  l({ reflect: !0 })
+], i.prototype, "placement", 2);
+o([
+  h("#root")
+], i.prototype, "_$root", 2);
+o([
+  h("#popup")
+], i.prototype, "_$popup", 2);
+o([
+  d()
+], i.prototype, "_trigger", 2);
+o([
+  d()
+], i.prototype, "_menu", 2);
+export {
+  i as R
+};
+//# sourceMappingURL=rc-menu-button-CmzW7P4h.js.map

package/dist/rc-menu-button-CmzW7P4h.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rc-menu-button-CmzW7P4h.js","sources":["../src/rc-menu-button.styles.ts","../src/rc-menu-button.ts"],"sourcesContent":["import { css } from 'lit';\n\nexport const menuButtonStyles = css`\n  :host {\n    display: inline-block;\n  }\n\n  :host([orientation='vertical']) {\n    display: block;\n  }\n\n  #root {\n    display: inline-block;\n  }\n\n  :host([orientation='vertical']) #root {\n    display: block;\n  }\n\n  #trigger-wrap {\n    display: contents;\n  }\n\n  slot[name='trigger']::slotted(button),\n  slot[name='trigger']::slotted([role='button']) {\n    min-block-size: var(--rc-menu-button-trigger-block-size, var(--rc-control-block-size, 2.25em));\n    padding: var(--rc-menu-button-trigger-padding-block, var(--rc-control-padding-block, 0.25em))\n      var(--rc-menu-button-trigger-padding-inline, var(--rc-control-padding-inline, 0.5em));\n    border: var(--rc-menu-button-trigger-border, var(--rc-border, 1px solid ButtonBorder));\n    border-radius: var(--rc-menu-button-trigger-radius, var(--rc-control-radius, 0.125em));\n    background: var(--rc-menu-button-trigger-background, var(--rc-button-bg, ButtonFace));\n    color: var(--rc-menu-button-trigger-color, var(--rc-button-text, ButtonText));\n    font: inherit;\n  }\n\n  :host([orientation='vertical']) slot[name='trigger']::slotted(button),\n  :host([orientation='vertical']) slot[name='trigger']::slotted([role='button']) {\n    inline-size: 100%;\n    text-align: start;\n  }\n\n  #popup {\n    z-index: var(--rc-menu-button-popup-z-index, 1000);\n  }\n\n  #popup[hidden] {\n    display: none;\n  }\n`;\n\nexport default menuButtonStyles;\n","import { LitElement, html } from 'lit';\nimport { property, query, state } from 'lit/decorators.js';\n\nimport {\n  AnchorController,\n  keyNavigation,\n  type AnchorPlacement,\n  type KeyboardNavigationAction,\n} from '@rcarls/rc-common';\nimport type { RCMenu } from '@rcarls/rc-menu';\n\nimport menuButtonStyles from './rc-menu-button.styles';\n\nexport interface RCMenuButtonToggleEvent {\n  open: boolean;\n}\n\ndeclare global {\n  interface HTMLElementTagNameMap {\n    'rc-menu-button': RCMenuButton;\n  }\n}\n\n/**\n * A menu button component that opens/closes a menu popup\n *\n * @see https://www.w3.org/WAI/ARIA/apg/patterns/menu-button/\n * @slot trigger - The button element that triggers the menu\n * @slot default - The rc-menu element to display as popup\n * @fires rc-menu-button-toggle - Fired when the menu opens or closes\n * @cssprop [--rc-menu-button-trigger-block-size=var(--rc-control-block-size)] - Minimum block size of the trigger\n * @cssprop [--rc-menu-button-trigger-padding-block=var(--rc-control-padding-block)] - Trigger block-axis padding\n * @cssprop [--rc-menu-button-trigger-padding-inline=var(--rc-control-padding-inline)] - Trigger inline-axis padding\n * @cssprop [--rc-menu-button-trigger-border=var(--rc-border)] - Trigger border\n * @cssprop [--rc-menu-button-trigger-radius=var(--rc-control-radius)] - Trigger border radius\n * @cssprop [--rc-menu-button-trigger-background=var(--rc-button-bg)] - Trigger background\n * @cssprop [--rc-menu-button-trigger-color=var(--rc-button-text)] - Trigger text color\n * @cssprop [--rc-menu-button-popup-z-index=1000] - Z-index of the popup overlay\n * @csspart root - The root container element\n * @csspart popup - The popup container element\n * @attr placement - Preferred placement of the popup relative to the trigger.\n */\nexport class RCMenuButton extends LitElement {\n  static styles = [menuButtonStyles];\n\n  /**\n   * Enables delegatesFocus so the browser routes focus() on the host element\n   * to the slotted trigger button. This lets the host participate in a\n   * roving-tabindex group (e.g. rc-toolbar) as a single tab stop while the\n   * trigger remains the visible focus target.\n   */\n  static override shadowRootOptions: ShadowRootInit = {\n    ...LitElement.shadowRootOptions,\n    delegatesFocus: true,\n  };\n\n  private _defaultOpen = false;\n  private _open = false;\n\n  /** Whether the menu is currently open. Host writes update silently. */\n  @property({ type: Boolean, reflect: true })\n  get open(): boolean {\n    return this._open;\n  }\n\n  /** Whether the menu is currently open. Host writes update silently. */\n  set open(value: boolean | undefined) {\n    const oldValue = this._open;\n\n    if (value === undefined) return;\n\n    this._setOpen(value, false);\n    this.requestUpdate('open', oldValue);\n  }\n\n  /** Initial uncontrolled open state. */\n  @property({ type: Boolean, attribute: 'default-open' })\n  get defaultOpen(): boolean {\n    return this._defaultOpen;\n  }\n\n  /** Initial uncontrolled open state. */\n  set defaultOpen(value: boolean) {\n    const oldValue = this._defaultOpen;\n\n    this._defaultOpen = value;\n\n    if (value && !this._open) {\n      this._setOpen(true, false);\n    }\n\n    this.requestUpdate('defaultOpen', oldValue);\n  }\n\n  /**\n   * Orientation of this menu button, affects which arrow keys open/close the menu.\n   * If not set, inherits from a parent rc-menubar or element with role=\"menubar\".\n   */\n  @property({ type: String, reflect: true })\n  orientation: 'horizontal' | 'vertical' | undefined;\n\n  /** Preferred placement of the popup relative to the trigger button. */\n  @property({ reflect: true })\n  placement: AnchorPlacement = 'bottom-start';\n\n  private get _effectivePlacement(): AnchorPlacement {\n    if (this.placement !== 'bottom-start') return this.placement;\n    return this._resolvedOrientation === 'vertical' ? 'right-start' : this.placement;\n  }\n\n  /**\n   * Resolved orientation, considering inheritance from parent menubar.\n   * Falls back to 'horizontal' if no orientation is set or inherited.\n   */\n  private get _resolvedOrientation(): 'horizontal' | 'vertical' {\n    if (this.orientation) return this.orientation;\n\n    // Inherit from parent rc-menubar or element with role=\"menubar\"\n    const menubar = this.closest('rc-menubar, [role=\"menubar\"]');\n    if (menubar) {\n      const orientation =\n        menubar.getAttribute('orientation') ??\n        menubar.getAttribute('aria-orientation');\n      if (orientation === 'vertical') return 'vertical';\n      if (orientation === 'horizontal') return 'horizontal';\n    }\n\n    return 'horizontal';\n  }\n\n  @query('#root') private _$root!: HTMLElement;\n  @query('#popup') private _$popup!: HTMLElement;\n\n  /** Reference to the trigger button element */\n  @state()\n  private _trigger: WeakRef<HTMLElement> | undefined;\n\n  /** Reference to the menu element */\n  @state()\n  private _menu: WeakRef<RCMenu> | undefined;\n\n  private _anchorCtrl = new AnchorController(this, {\n    anchor: () => this._$root ?? null,\n    floating: () => this._$popup ?? null,\n    shadowHost: () => this,\n    placement: 'bottom-start',\n    offset: 2,\n  });\n\n  /** Bound handler for document click (light dismiss) */\n  private _boundHandleDocumentClick = this._handleDocumentClick.bind(this);\n\n  /**\n   * Watches the host's own `tabindex` attribute so the trigger button's\n   * tabindex can be kept in sync. When a parent (e.g. rc-toolbar) places the\n   * host under roving-tabindex management it sets/removes tabindex on the\n   * host; we mirror that to the trigger so it doesn't become an independent\n   * tab stop. When the host has no tabindex the trigger keeps its natural\n   * tabindex=0 for standalone usage.\n   */\n  private _tabObserver?: MutationObserver;\n\n  connectedCallback() {\n    super.connectedCallback();\n\n    this._tabObserver = new MutationObserver(() => this._syncTriggerTabindex());\n    this._tabObserver.observe(this, { attributes: true, attributeFilter: ['tabindex'] });\n\n    document.addEventListener('click', this._boundHandleDocumentClick, true);\n\n    if (this.defaultOpen) {\n      this._setOpen(true, false);\n    }\n  }\n\n  disconnectedCallback() {\n    this._tabObserver?.disconnect();\n    this._tabObserver = undefined;\n\n    super.disconnectedCallback();\n    document.removeEventListener('click', this._boundHandleDocumentClick, true);\n  }\n\n  /** Opens the menu and focuses the first or last item */\n  openMenu(focusTarget: 'first' | 'last' = 'first') {\n    if (this.open) return;\n\n    this._anchorCtrl.setOptions({ placement: this._effectivePlacement });\n    this._setOpen(true, true);\n    this._anchorCtrl.update();\n\n    this.updateComplete.then(() => {\n      const menu = this._menu?.deref();\n      focusTarget === 'last' ? menu?.focusLast() : menu?.focusFirst();\n    });\n  }\n\n  /** Closes the menu and optionally returns focus to trigger */\n  closeMenu(returnFocus = true) {\n    if (!this.open) return;\n\n    this._setOpen(false, true);\n\n    if (returnFocus) {\n      const trigger = this._trigger?.deref();\n      trigger?.focus();\n    }\n  }\n\n  /** Toggles the menu open/closed */\n  toggleMenu() {\n    if (this.open) {\n      this.closeMenu();\n    } else {\n      this.openMenu();\n    }\n  }\n\n  private _dispatchToggle() {\n    this.dispatchEvent(\n      new CustomEvent<RCMenuButtonToggleEvent>('rc-menu-button-toggle', {\n        bubbles: true,\n        composed: true,\n        detail: { open: this.open },\n      }),\n    );\n  }\n\n  private _handleTriggerSlotChange(e: Event) {\n    const slot = e.currentTarget as HTMLSlotElement;\n    const trigger = slot.assignedElements()[0] as HTMLElement | undefined;\n\n    if (trigger) {\n      this._trigger = new WeakRef(trigger);\n      this._syncTriggerAria();\n      this._syncTriggerTabindex();\n    }\n  }\n\n  /**\n   * Mirrors the host's `tabindex` attribute to the trigger button.\n   *\n   * When a roving-tabindex parent (e.g. rc-toolbar) marks this host inactive\n   * with `tabindex=\"-1\"`, the trigger must also be suppressed so it does not\n   * become an independent tab stop. When the host is the active item\n   * (`tabindex=\"0\"`) or standalone (no tabindex), the trigger retains its\n   * natural focusability so that Chrome's delegatesFocus can route sequential\n   * Tab navigation through the host to the trigger.\n   */\n  private _syncTriggerTabindex() {\n    const trigger = this._trigger?.deref();\n\n    if (!trigger) return;\n\n    if (this.getAttribute('tabindex') === '-1') {\n      trigger.setAttribute('tabindex', '-1');\n    } else {\n      trigger.removeAttribute('tabindex');\n    }\n  }\n\n  /**\n   * Overrides the default focus() so that programmatic focus calls (e.g. from\n   * a roving-tabindex parent navigating back to this element via arrow keys)\n   * always reach the trigger.\n   *\n   * Chrome's delegatesFocus will not delegate to a tabindex=\"-1\" element, so\n   * when the toolbar marks this host inactive it suppresses the trigger — and\n   * the next focusItem() call silently fails. Lifting the suppression here and\n   * directly calling trigger.focus() bypasses that restriction.\n   */\n  override focus(options?: FocusOptions) {\n    const trigger = this._trigger?.deref();\n\n    if (!trigger) {\n      super.focus(options);\n      return;\n    }\n\n    trigger.removeAttribute('tabindex');\n    trigger.focus(options);\n  }\n\n\n  private _handleMenuSlotChange(e: Event) {\n    const slot = e.currentTarget as HTMLSlotElement;\n    const elements = slot.assignedElements();\n    const menu = elements.find((el) => el.tagName === 'RC-MENU') as\n      | RCMenu\n      | undefined;\n\n    if (menu) {\n      this._menu = new WeakRef(menu);\n    }\n  }\n\n  private _onNavigate = (action: KeyboardNavigationAction) => {\n    switch (action) {\n      case 'open-to-first':\n      case 'activate':\n        this.openMenu();\n        break;\n      case 'open-to-last':\n        this.openMenu('last');\n        break;\n      case 'escape':\n        this.closeMenu();\n        break;\n    }\n  };\n\n  private _handleTriggerClick(e: MouseEvent) {\n    e.preventDefault();\n    this.toggleMenu();\n  }\n\n  private _handleMenuClose() {\n    this.closeMenu();\n  }\n\n  private _handleMenuActivate() {\n    // Close menu after item activation\n    this.closeMenu();\n  }\n\n  private _handleDocumentClick(e: MouseEvent) {\n    if (!this.open) return;\n\n    const path = e.composedPath();\n\n    // Check if click was inside this component\n    if (path.includes(this)) return;\n\n    // Close menu on outside click\n    this.closeMenu(false);\n  }\n\n  protected updated(changedProperties: Map<PropertyKey, unknown>) {\n    super.updated(changedProperties);\n\n    // Keep aria-expanded in sync\n    if (changedProperties.has('open')) {\n      this._syncTriggerAria();\n    }\n\n    if (\n      changedProperties.has('placement') ||\n      changedProperties.has('orientation')\n    ) {\n      this._anchorCtrl.setOptions({ placement: this._effectivePlacement });\n    }\n  }\n\n  private _setOpen(open: boolean, dispatch: boolean): void {\n    if (this._open === open) return;\n\n    const oldValue = this._open;\n\n    this._open = open;\n    this.requestUpdate('open', oldValue);\n    this._syncTriggerAria();\n\n    if (dispatch) this._dispatchToggle();\n  }\n\n  private _syncTriggerAria(): void {\n    const trigger = this._trigger?.deref();\n    if (!trigger?.isConnected) return;\n\n    trigger.setAttribute('aria-haspopup', 'menu');\n    trigger.setAttribute('aria-expanded', String(this.open));\n  }\n\n  protected render() {\n    return html`\n      <div id=\"root\" part=\"root\">\n        <div\n          id=\"trigger-wrap\"\n          ${keyNavigation(this._onNavigate, {\n            navigationAxis: this._resolvedOrientation,\n            handleNavAxis: false,\n            handleOpenAxis: true,\n            handleActivate: true,\n            handleEscape: this.open,\n          })}\n          @click=${this._handleTriggerClick}\n        >\n          <slot\n            name=\"trigger\"\n            @slotchange=${this._handleTriggerSlotChange}\n          ></slot>\n        </div>\n        <div\n          id=\"popup\"\n          part=\"popup\"\n          ?hidden=${!this.open}\n          @rc-menu-close=${this._handleMenuClose}\n          @rc-menu-activate=${this._handleMenuActivate}\n        >\n          <slot @slotchange=${this._handleMenuSlotChange}></slot>\n        </div>\n      </div>\n    `;\n  }\n}\n\nexport default RCMenuButton;\n"],"names":["menuButtonStyles","css","_RCMenuButton","LitElement","AnchorController","action","value","oldValue","menubar","orientation","focusTarget","menu","returnFocus","e","trigger","options","el","changedProperties","open","dispatch","html","keyNavigation","RCMenuButton","__decorateClass","property","query","state"],"mappings":"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"}

package/dist/rc-menu-button-define.js

@@ -0,0 +1,7 @@
+import "@rcarls/rc-menu/define";
+import { R as t } from "./rc-menu-button-CmzW7P4h.js";
+customElements.get("rc-menu-button") || customElements.define("rc-menu-button", t);
+export {
+  t as RCMenuButton
+};
+//# sourceMappingURL=rc-menu-button-define.js.map

package/dist/rc-menu-button-define.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rc-menu-button-define.js","sources":["../src/define.ts"],"sourcesContent":["import '@rcarls/rc-menu/define';\nimport { RCMenuButton } from './index.js';\n\ncustomElements.get('rc-menu-button') || customElements.define('rc-menu-button', RCMenuButton);\n\nexport * from './index.js';\n"],"names":["RCMenuButton"],"mappings":";;AAGA,eAAe,IAAI,gBAAgB,KAAK,eAAe,OAAO,kBAAkBA,CAAY;"}

package/dist/rc-menu-button.js

@@ -0,0 +1,5 @@
+import { R as e } from "./rc-menu-button-CmzW7P4h.js";
+export {
+  e as RCMenuButton
+};
+//# sourceMappingURL=rc-menu-button.js.map

package/dist/rc-menu-button.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rc-menu-button.js","sources":[],"sourcesContent":[],"names":[],"mappings":";"}

package/dist/types/packages/rc-menu-button/src/define.d.ts

@@ -0,0 +1 @@
+export * from './index.js';

package/dist/types/packages/rc-menu-button/src/index.d.ts

@@ -0,0 +1 @@
+export * from './rc-menu-button';

package/dist/types/packages/rc-menu-button/src/rc-menu-button.d.ts

@@ -0,0 +1,123 @@
+import { LitElement } from 'lit';
+import { AnchorPlacement } from '@rcarls/rc-common';
+export interface RCMenuButtonToggleEvent {
+    open: boolean;
+}
+declare global {
+    interface HTMLElementTagNameMap {
+        'rc-menu-button': RCMenuButton;
+    }
+}
+/**
+ * A menu button component that opens/closes a menu popup
+ *
+ * @see https://www.w3.org/WAI/ARIA/apg/patterns/menu-button/
+ * @slot trigger - The button element that triggers the menu
+ * @slot default - The rc-menu element to display as popup
+ * @fires rc-menu-button-toggle - Fired when the menu opens or closes
+ * @cssprop [--rc-menu-button-trigger-block-size=var(--rc-control-block-size)] - Minimum block size of the trigger
+ * @cssprop [--rc-menu-button-trigger-padding-block=var(--rc-control-padding-block)] - Trigger block-axis padding
+ * @cssprop [--rc-menu-button-trigger-padding-inline=var(--rc-control-padding-inline)] - Trigger inline-axis padding
+ * @cssprop [--rc-menu-button-trigger-border=var(--rc-border)] - Trigger border
+ * @cssprop [--rc-menu-button-trigger-radius=var(--rc-control-radius)] - Trigger border radius
+ * @cssprop [--rc-menu-button-trigger-background=var(--rc-button-bg)] - Trigger background
+ * @cssprop [--rc-menu-button-trigger-color=var(--rc-button-text)] - Trigger text color
+ * @cssprop [--rc-menu-button-popup-z-index=1000] - Z-index of the popup overlay
+ * @csspart root - The root container element
+ * @csspart popup - The popup container element
+ * @attr placement - Preferred placement of the popup relative to the trigger.
+ */
+export declare class RCMenuButton extends LitElement {
+    static styles: import('lit').CSSResult[];
+    /**
+     * Enables delegatesFocus so the browser routes focus() on the host element
+     * to the slotted trigger button. This lets the host participate in a
+     * roving-tabindex group (e.g. rc-toolbar) as a single tab stop while the
+     * trigger remains the visible focus target.
+     */
+    static shadowRootOptions: ShadowRootInit;
+    private _defaultOpen;
+    private _open;
+    /** Whether the menu is currently open. Host writes update silently. */
+    get open(): boolean;
+    /** Whether the menu is currently open. Host writes update silently. */
+    set open(value: boolean | undefined);
+    /** Initial uncontrolled open state. */
+    get defaultOpen(): boolean;
+    /** Initial uncontrolled open state. */
+    set defaultOpen(value: boolean);
+    /**
+     * Orientation of this menu button, affects which arrow keys open/close the menu.
+     * If not set, inherits from a parent rc-menubar or element with role="menubar".
+     */
+    orientation: 'horizontal' | 'vertical' | undefined;
+    /** Preferred placement of the popup relative to the trigger button. */
+    placement: AnchorPlacement;
+    private get _effectivePlacement();
+    /**
+     * Resolved orientation, considering inheritance from parent menubar.
+     * Falls back to 'horizontal' if no orientation is set or inherited.
+     */
+    private get _resolvedOrientation();
+    private _$root;
+    private _$popup;
+    /** Reference to the trigger button element */
+    private _trigger;
+    /** Reference to the menu element */
+    private _menu;
+    private _anchorCtrl;
+    /** Bound handler for document click (light dismiss) */
+    private _boundHandleDocumentClick;
+    /**
+     * Watches the host's own `tabindex` attribute so the trigger button's
+     * tabindex can be kept in sync. When a parent (e.g. rc-toolbar) places the
+     * host under roving-tabindex management it sets/removes tabindex on the
+     * host; we mirror that to the trigger so it doesn't become an independent
+     * tab stop. When the host has no tabindex the trigger keeps its natural
+     * tabindex=0 for standalone usage.
+     */
+    private _tabObserver?;
+    connectedCallback(): void;
+    disconnectedCallback(): void;
+    /** Opens the menu and focuses the first or last item */
+    openMenu(focusTarget?: 'first' | 'last'): void;
+    /** Closes the menu and optionally returns focus to trigger */
+    closeMenu(returnFocus?: boolean): void;
+    /** Toggles the menu open/closed */
+    toggleMenu(): void;
+    private _dispatchToggle;
+    private _handleTriggerSlotChange;
+    /**
+     * Mirrors the host's `tabindex` attribute to the trigger button.
+     *
+     * When a roving-tabindex parent (e.g. rc-toolbar) marks this host inactive
+     * with `tabindex="-1"`, the trigger must also be suppressed so it does not
+     * become an independent tab stop. When the host is the active item
+     * (`tabindex="0"`) or standalone (no tabindex), the trigger retains its
+     * natural focusability so that Chrome's delegatesFocus can route sequential
+     * Tab navigation through the host to the trigger.
+     */
+    private _syncTriggerTabindex;
+    /**
+     * Overrides the default focus() so that programmatic focus calls (e.g. from
+     * a roving-tabindex parent navigating back to this element via arrow keys)
+     * always reach the trigger.
+     *
+     * Chrome's delegatesFocus will not delegate to a tabindex="-1" element, so
+     * when the toolbar marks this host inactive it suppresses the trigger — and
+     * the next focusItem() call silently fails. Lifting the suppression here and
+     * directly calling trigger.focus() bypasses that restriction.
+     */
+    focus(options?: FocusOptions): void;
+    private _handleMenuSlotChange;
+    private _onNavigate;
+    private _handleTriggerClick;
+    private _handleMenuClose;
+    private _handleMenuActivate;
+    private _handleDocumentClick;
+    protected updated(changedProperties: Map<PropertyKey, unknown>): void;
+    private _setOpen;
+    private _syncTriggerAria;
+    protected render(): import('lit').TemplateResult<1>;
+}
+export default RCMenuButton;

package/dist/types/packages/rc-menu-button/src/rc-menu-button.styles.d.ts

@@ -0,0 +1,2 @@
+export declare const menuButtonStyles: import('lit').CSSResult;
+export default menuButtonStyles;

package/package.json

@@ -0,0 +1,70 @@
+{
+  "name": "@rcarls/rc-menu-button",
+  "publishConfig": {
+    "access": "public"
+  },
+  "version": "0.1.0",
+  "description": "Headless WAI-ARIA menu button web component built with Lit",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/richardcarls/rc-webcomponents.git",
+    "directory": "packages/rc-menu-button"
+  },
+  "homepage": "https://github.com/richardcarls/rc-webcomponents#readme",
+  "license": "MIT",
+  "type": "module",
+  "files": [
+    "dist"
+  ],
+  "module": "./dist/rc-menu-button.js",
+  "exports": {
+    ".": {
+      "import": {
+        "types": "./dist/types/packages/rc-menu-button/src/index.d.ts",
+        "default": "./dist/rc-menu-button.js"
+      }
+    },
+    "./define": {
+      "import": {
+        "types": "./dist/types/packages/rc-menu-button/src/define.d.ts",
+        "default": "./dist/rc-menu-button-define.js"
+      }
+    }
+  },
+  "types": "./dist/types/packages/rc-menu-button/src/index.d.ts",
+  "sideEffects": [
+    "./dist/rc-menu-button-define.js"
+  ],
+  "customElements": "dist/custom-elements.json",
+  "scripts": {
+    "dev": "vite",
+    "build": "tsc && vite build && cem analyze",
+    "cem:analyze": "cem analyze",
+    "preview": "vite preview",
+    "test:browser": "vitest",
+    "test:browser:chrome": "vitest --project=chromium",
+    "test:browser:firefox": "vitest --project=firefox",
+    "yalc:publish": "yalc publish --push"
+  },
+  "dependencies": {
+    "@rcarls/rc-common": "workspace:^",
+    "@rcarls/rc-menu": "workspace:^",
+    "@types/node": "^25.6.0"
+  },
+  "devDependencies": {
+    "@custom-elements-manifest/analyzer": "0.11.0",
+    "@guanghechen/rollup-plugin-copy": "^6.0.9",
+    "@vitest/browser-playwright": "4.1.5",
+    "lit": "^3.0.0",
+    "playwright": "^1.56.0",
+    "rollup": "^4.60.2",
+    "typescript": "~5.9.3",
+    "vite": "^7.1.7",
+    "vite-plugin-dts": "^4.5.4",
+    "vitest": "^4.0.6",
+    "vitest-browser-lit": "^1.0.1"
+  },
+  "peerDependencies": {
+    "lit": "^3.0.0"
+  }
+}