@rcarls/rc-menu-button 0.0.0-next-20260921045401

package/dist/custom-elements.json

@@ -0,0 +1,648 @@
+{
+  "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.js"
+          }
+        }
+      ]
+    },
+    {
+      "kind": "javascript-module",
+      "path": "src/rc-menu-button.ts",
+      "declarations": [
+        {
+          "kind": "class",
+          "description": "Trigger button that opens an rc-menu popup, following the WAI-ARIA Menu Button pattern.",
+          "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": "Gap between flex children in the trigger",
+              "name": "--rc-menu-button-trigger-gap",
+              "default": "var(--rc-item-gap)"
+            },
+            {
+              "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": "CSS transition applied to the trigger",
+              "name": "--rc-menu-button-trigger-transition"
+            },
+            {
+              "description": "Trigger hover background",
+              "name": "--rc-menu-button-trigger-hover-background",
+              "default": "color-mix(in srgb, Highlight 8%, transparent)"
+            },
+            {
+              "description": "Trigger hover text color",
+              "name": "--rc-menu-button-trigger-hover-color",
+              "default": "inherit"
+            },
+            {
+              "description": "Trigger hover border color",
+              "name": "--rc-menu-button-trigger-hover-border-color",
+              "default": "currentColor"
+            },
+            {
+              "description": "Trigger background when the menu is open",
+              "name": "--rc-menu-button-trigger-open-background",
+              "default": "color-mix(in srgb, Highlight 12%, transparent)"
+            },
+            {
+              "description": "Trigger text color when the menu is open",
+              "name": "--rc-menu-button-trigger-open-color",
+              "default": "inherit"
+            },
+            {
+              "description": "Trigger border color when the menu is open",
+              "name": "--rc-menu-button-trigger-open-border-color",
+              "default": "currentColor"
+            },
+            {
+              "description": "Inline and block size of the slotted indicator",
+              "name": "--rc-menu-button-indicator-size",
+              "default": "1em"
+            },
+            {
+              "description": "Color of the slotted indicator",
+              "name": "--rc-menu-button-indicator-color",
+              "default": "currentColor"
+            },
+            {
+              "description": "Indicator distance from the trigger's inline end",
+              "name": "--rc-menu-button-indicator-inset",
+              "default": "var(--rc-menu-button-trigger-padding-inline)"
+            },
+            {
+              "description": "Inline size of an `icon-only` trigger's visible box. Square by default (equal to `--rc-menu-button-trigger-block-size`); set narrower or wider to change only the trigger's width, independent of its height.",
+              "name": "--rc-menu-button-icon-size"
+            },
+            {
+              "description": "Minimum accessible touch target block size for an `icon-only` trigger. A floor, not a fixed size: has no effect once `--rc-menu-button-trigger-block-size` already meets or exceeds it. Grows the shadow-DOM trigger wrapper (reserving layout space) and the light-DOM hit-slop (the actual larger clickable region) together; the visible trigger itself stays at its own size, centered.",
+              "name": "--rc-menu-button-touch-target-block-size",
+              "default": "3rem"
+            },
+            {
+              "description": "Minimum accessible touch target inline size for an `icon-only` trigger. Defers to `--rc-menu-button-touch-target-block-size` when unset.",
+              "name": "--rc-menu-button-touch-target-inline-size"
+            },
+            {
+              "description": "Zero by default. A theme or consumer sets this on an `icon-only` trigger that sits at a real leading edge (no neighbor on that side) to let its touch-target inflation overlap into whatever sits just outside the host, such as a container's own edge padding, instead of also reserving layout space there.",
+              "name": "--rc-menu-button-touch-target-overlap-inline-start",
+              "default": "0px"
+            },
+            {
+              "description": "The trailing-edge counterpart to `--rc-menu-button-touch-target-overlap-inline-start`.",
+              "name": "--rc-menu-button-touch-target-overlap-inline-end",
+              "default": "0px"
+            },
+            {
+              "description": "Popup open/close fade transition duration.",
+              "name": "--rc-menu-button-popup-duration",
+              "default": "150ms"
+            }
+          ],
+          "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": "Optional decorative indicator rendered at the trigger's inline end",
+              "name": "indicator"
+            },
+            {
+              "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."
+            },
+            {
+              "kind": "field",
+              "name": "_styledRoots",
+              "privacy": "protected",
+              "static": true,
+              "readonly": true,
+              "default": "new Set<Document | ShadowRoot>()"
+            },
+            {
+              "kind": "method",
+              "name": "_ensureBaseStyles",
+              "privacy": "protected",
+              "static": true,
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "root",
+                  "type": {
+                    "text": "Document | ShadowRoot"
+                  }
+                }
+              ]
+            },
+            {
+              "kind": "field",
+              "name": "_defaultOpen",
+              "type": {
+                "text": "boolean"
+              },
+              "privacy": "private",
+              "default": "false"
+            },
+            {
+              "kind": "field",
+              "name": "_open",
+              "type": {
+                "text": "boolean | undefined"
+              },
+              "privacy": "private"
+            },
+            {
+              "kind": "field",
+              "name": "_uncontrolledOpen",
+              "type": {
+                "text": "boolean | undefined"
+              },
+              "privacy": "private"
+            },
+            {
+              "kind": "field",
+              "name": "_openInitialized",
+              "type": {
+                "text": "boolean"
+              },
+              "privacy": "private",
+              "default": "false"
+            },
+            {
+              "kind": "field",
+              "name": "open",
+              "type": {
+                "text": "boolean"
+              },
+              "description": "Applies open state in controlled mode without dispatching an event.",
+              "attribute": "open",
+              "reflects": true
+            },
+            {
+              "kind": "field",
+              "name": "defaultOpen",
+              "type": {
+                "text": "boolean"
+              },
+              "description": "Applies the uncontrolled default before any controlled write occurs.",
+              "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.\n\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": "protected",
+              "description": "Popup placement adjusted for orientation.\n\nSwitches from `bottom-start` to `right-start` when the resolved orientation\nis `vertical`, so vertical menubars open submenus to the side.",
+              "readonly": true
+            },
+            {
+              "kind": "field",
+              "name": "_resolvedOrientation",
+              "type": {
+                "text": "'horizontal' | 'vertical'"
+              },
+              "privacy": "protected",
+              "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": "protected",
+              "description": "Shadow DOM root container. Serves as the anchor element for `_anchorCtrl`."
+            },
+            {
+              "kind": "field",
+              "name": "_$popup",
+              "type": {
+                "text": "HTMLElement"
+              },
+              "privacy": "protected",
+              "description": "Shadow DOM popup container. Hidden when `open` is `false`."
+            },
+            {
+              "kind": "field",
+              "name": "_$trigger",
+              "type": {
+                "text": "WeakRef<HTMLElement> | undefined"
+              },
+              "privacy": "protected",
+              "description": "Weak reference to the slotted trigger button."
+            },
+            {
+              "kind": "field",
+              "name": "_$menu",
+              "type": {
+                "text": "WeakRef<RCMenu> | undefined"
+              },
+              "privacy": "protected",
+              "description": "Weak reference to the slotted `rc-menu` element."
+            },
+            {
+              "kind": "field",
+              "name": "_anchorCtrl",
+              "privacy": "protected",
+              "default": "new AnchorController(this, { anchor: () => this._$root ?? null, floating: () => this._$popup ?? null, shadowHost: () => this, placement: 'bottom-start', offset: 2, })",
+              "description": "Positions the popup relative to the trigger using CSS anchor positioning."
+            },
+            {
+              "kind": "field",
+              "name": "_boundHandleDocumentClick",
+              "privacy": "protected",
+              "description": "Bound handler for document click (light dismiss). Stored for `removeEventListener` pairing."
+            },
+            {
+              "kind": "field",
+              "name": "_tabObserver",
+              "type": {
+                "text": "MutationObserver | undefined"
+              },
+              "privacy": "protected",
+              "description": "Watches the host's own `tabindex` attribute so the trigger button's\ntabindex can be kept in sync.\n\nWhen 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": "which item receives initial focus when the menu opens"
+                }
+              ],
+              "description": "Opens the menu and moves focus into it."
+            },
+            {
+              "kind": "method",
+              "name": "closeMenu",
+              "parameters": [
+                {
+                  "name": "returnFocus",
+                  "default": "true",
+                  "description": "when `true`, returns focus to the trigger button after closing"
+                }
+              ],
+              "description": "Closes the menu."
+            },
+            {
+              "kind": "method",
+              "name": "toggleMenu",
+              "description": "Toggles the menu between open and closed."
+            },
+            {
+              "kind": "method",
+              "name": "_dispatchToggle",
+              "privacy": "protected",
+              "parameters": [
+                {
+                  "name": "open",
+                  "default": "this.open"
+                }
+              ],
+              "description": "Dispatches the `rc-menu-button-toggle` bubbling composed event with the requested open state."
+            },
+            {
+              "kind": "method",
+              "name": "_handleTriggerSlotChange",
+              "privacy": "protected",
+              "parameters": [
+                {
+                  "name": "e",
+                  "type": {
+                    "text": "Event"
+                  }
+                }
+              ],
+              "description": "Caches a weak reference to the first assigned trigger element and syncs its ARIA and tabindex state."
+            },
+            {
+              "kind": "method",
+              "name": "_handleIndicatorSlotChange",
+              "privacy": "protected",
+              "parameters": [
+                {
+                  "name": "e",
+                  "type": {
+                    "text": "Event"
+                  }
+                }
+              ],
+              "description": "Tracks optional indicator content so the trigger reserves its inline-end space."
+            },
+            {
+              "kind": "method",
+              "name": "_syncTriggerTabindex",
+              "privacy": "protected",
+              "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": "protected",
+              "parameters": [
+                {
+                  "name": "e",
+                  "type": {
+                    "text": "Event"
+                  }
+                }
+              ],
+              "description": "Caches a weak reference to the first assigned `rc-menu` element."
+            },
+            {
+              "kind": "field",
+              "name": "_onNavigate",
+              "privacy": "protected",
+              "description": "Keyboard navigation handler.\n\nOpens or closes the menu in response to arrow/Enter/Escape keys."
+            },
+            {
+              "kind": "method",
+              "name": "_handleTriggerClick",
+              "privacy": "protected",
+              "parameters": [
+                {
+                  "name": "e",
+                  "type": {
+                    "text": "MouseEvent"
+                  }
+                }
+              ],
+              "description": "Prevents the default button action and delegates to `toggleMenu`."
+            },
+            {
+              "kind": "method",
+              "name": "_handleMenuClose",
+              "privacy": "protected",
+              "description": "Closes the menu when an `rc-menu-close` event bubbles up from the popup."
+            },
+            {
+              "kind": "method",
+              "name": "_handleMenuActivate",
+              "privacy": "protected",
+              "description": "Closes the menu when an `rc-menu-activate` event bubbles up from the popup."
+            },
+            {
+              "kind": "method",
+              "name": "_handleDocumentClick",
+              "privacy": "protected",
+              "parameters": [
+                {
+                  "name": "e",
+                  "type": {
+                    "text": "MouseEvent"
+                  }
+                }
+              ],
+              "description": "Closes the menu on clicks outside this component (light dismiss)."
+            },
+            {
+              "kind": "method",
+              "name": "_setOpen",
+              "privacy": "protected",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "open",
+                  "type": {
+                    "text": "boolean"
+                  }
+                },
+                {
+                  "name": "dispatch",
+                  "type": {
+                    "text": "boolean"
+                  }
+                }
+              ]
+            },
+            {
+              "kind": "method",
+              "name": "_syncTriggerAria",
+              "privacy": "protected",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "description": "Writes `aria-haspopup` and `aria-expanded` to the trigger button to match the current open state."
+            }
+          ],
+          "events": [
+            {
+              "name": "rc-menu-button-toggle",
+              "type": {
+                "text": "CustomEvent"
+              },
+              "description": "Fired when the menu opens or closes"
+            }
+          ],
+          "attributes": [
+            {
+              "description": "Applies open state in controlled mode without dispatching an event.",
+              "name": "open",
+              "type": {
+                "text": "boolean"
+              },
+              "fieldName": "open"
+            },
+            {
+              "description": "Applies the uncontrolled default before any controlled write occurs.",
+              "name": "default-open",
+              "type": {
+                "text": "boolean"
+              },
+              "fieldName": "defaultOpen"
+            },
+            {
+              "description": "Orientation of this menu button, affects which arrow keys open/close the menu.\n\nIf not set, inherits from a parent rc-menubar or element with role=\"menubar\".",
+              "name": "orientation",
+              "type": {
+                "text": "'horizontal' | 'vertical' | undefined"
+              },
+              "fieldName": "orientation"
+            },
+            {
+              "description": "Preferred placement of the popup relative to the trigger button.",
+              "name": "placement",
+              "type": {
+                "text": "AnchorPlacement"
+              },
+              "default": "'bottom-start'",
+              "fieldName": "placement"
+            },
+            {
+              "description": "Hints that the slotted trigger has no visible label, so themes can size it and its touch target as an icon button (see `--rc-menu-button-icon-size` and `--rc-menu-button-touch-target-*` above). Purely a styling hook; RCMenuButton does not read or derive it — set it whenever the trigger is rendered icon-only.",
+              "name": "icon-only"
+            }
+          ],
+          "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"
+          }
+        }
+      ]
+    }
+  ]
+}