@skdx/web-components 0.28.0 → 0.30.0

package/dist/menu/MenuRoot.js

@@ -0,0 +1,5 @@
+var h=Object.defineProperty;var f=Object.getOwnPropertyDescriptor;var i=(p,s,e,t)=>{for(var n=t>1?void 0:t?f(s,e):s,l=p.length-1,a;l>=0;l--)(a=p[l])&&(n=(t?a(s,e,n):a(n))||n);return t&&n&&h(s,e,n),n};import{css as g,html as O,LitElement as v}from"lit";import{property as r}from"lit/decorators.js";import{ControlledValue as b}from"../internal/controlled-value.js";import{customElement as E}from"../internal/define.js";import{dispatchAutoFocus as y}from"../internal/dismiss.js";import{nextId as d}from"../internal/ids.js";import{notifyOpenChangeComplete as C}from"../internal/open-change-complete.js";import{releaseOutsideInert as x}from"../internal/outsideInert.js";import{optOutBoolean as c}from"../internal/positioning.js";import{hiddenHostStyles as _}from"../internal/styles.js";import"./MenuArrow.js";import"./MenuPortal.js";import{emit as m}from"../internal/events.js";import{MENU_FAMILY as u}from"./family.js";import{ITEM_SELECTOR as j}from"../internal/menu-sub.js";var G=500,V=10,o=class extends v{constructor(){super(...arguments);this._open=new b(!1);this.defaultOpen=!1;this.openOn="click";this.closeOnSelect=!0;this.contentId=d("skdx-menu-content");this.triggerId=d("skdx-menu-trigger");this.openIntent="first";this.triggerEl=null;this.pointerPoint={x:0,y:0};this.hasUpdatedOnce=!1;this.contentEl=null}get open(){return this._open.value??!1}set open(e){let t=this.open;this._open.fromConsumer(e)&&this.requestUpdate("open",t)}get modal(){return this._modal??this.openOn!=="contextmenu"}set modal(e){let t=this.modal;this._modal=e,this.requestUpdate("modal",t)}setPoint(e){this.pointerPoint=e,u.notify(this)}getPoint(){return this.point??this.pointerPoint}connectedCallback(){super.connectedCallback();let e=this.querySelector("skdx-menu-content")?.id;e&&(this.contentId=e);let t=this.querySelector("skdx-menu-trigger")?.id;t&&(this.triggerId=t),this.defaultOpen&&!this.hasAttribute("open")&&this.writeOpen(!0)}disconnectedCallback(){this.teardownOpenChangeComplete?.(),super.disconnectedCallback()}updated(e){let t=!this.hasUpdatedOnce;this.hasUpdatedOnce=!0,e.has("open")&&!t&&m(this,"open-change",this.open),e.size>0&&u.notify(this),e.has("open")&&!t&&(this.teardownOpenChangeComplete?.(),this.teardownOpenChangeComplete=C(()=>this.querySelector("skdx-menu-content"),this.open,n=>m(this,"open-change-complete",n)))}writeOpen(e){let t=this.open;this._open.propose(e)&&this.requestUpdate("open",t)}setOpen(e){this.writeOpen(e)}focusTrigger(){this.modal&&x(),!(this.contentEl&&!y(this.contentEl,"close-auto-focus"))&&this.triggerEl?.focus()}render(){return O`<slot></slot>`}};o.styles=[_,g`
+      :host {
+        display: contents;
+      }
+    `],i([r({type:Boolean,reflect:!0,noAccessor:!0})],o.prototype,"open",1),i([r({type:Boolean,attribute:"default-open"})],o.prototype,"defaultOpen",2),i([r({type:String,attribute:"open-on"})],o.prototype,"openOn",2),i([r({attribute:!1})],o.prototype,"point",2),i([r({converter:c,noAccessor:!0})],o.prototype,"modal",1),i([r({attribute:"close-on-select",converter:c})],o.prototype,"closeOnSelect",2),o=i([E("skdx-menu-root")],o);export{j as ITEM_SELECTOR,V as LONG_PRESS_MOVE_TOLERANCE,G as LONG_PRESS_MS,o as SkdxMenuRoot};

package/dist/menu/MenuSeparator.cjs

@@ -0,0 +1,5 @@
+"use strict";var i=Object.defineProperty;var c=Object.getOwnPropertyDescriptor;var b=Object.getOwnPropertyNames;var h=Object.prototype.hasOwnProperty;var f=(r,e)=>{for(var s in e)i(r,s,{get:e[s],enumerable:!0})},v=(r,e,s,o)=>{if(e&&typeof e=="object"||typeof e=="function")for(let t of b(e))!h.call(r,t)&&t!==s&&i(r,t,{get:()=>e[t],enumerable:!(o=c(e,t))||o.enumerable});return r};var y=r=>v(i({},"__esModule",{value:!0}),r),d=(r,e,s,o)=>{for(var t=o>1?void 0:o?c(e,s):e,m=r.length-1,n;m>=0;m--)(n=r[m])&&(t=(o?n(e,s,t):n(t))||t);return o&&t&&i(e,s,t),t};var T={};f(T,{SkdxMenuSeparator:()=>l});module.exports=y(T);var a=require("lit"),p=require("../internal/define.cjs"),u=require("../internal/styles.cjs");var l=class extends a.LitElement{connectedCallback(){super.connectedCallback(),this.setAttribute("role","separator"),this.setAttribute("aria-orientation","horizontal")}render(){return a.html``}};l.styles=[u.hiddenHostStyles,a.css`
+      :host {
+        display: block;
+      }
+    `],l=d([(0,p.customElement)("skdx-menu-separator","menu","separator")],l);0&&(module.exports={SkdxMenuSeparator});

package/dist/menu/MenuSeparator.d.cts

@@ -0,0 +1,14 @@
+import { LitElement, type TemplateResult } from 'lit';
+/**
+ * Visual divider between items or groups: `role="separator"` with `aria-orientation="horizontal"`.
+ */
+export declare class SkdxMenuSeparator extends LitElement {
+    static styles: import("lit").CSSResult[];
+    connectedCallback(): void;
+    render(): TemplateResult;
+}
+declare global {
+    interface HTMLElementTagNameMap {
+        'skdx-menu-separator': SkdxMenuSeparator;
+    }
+}

package/dist/menu/MenuSeparator.d.ts

@@ -0,0 +1,14 @@
+import { LitElement, type TemplateResult } from 'lit';
+/**
+ * Visual divider between items or groups: `role="separator"` with `aria-orientation="horizontal"`.
+ */
+export declare class SkdxMenuSeparator extends LitElement {
+    static styles: import("lit").CSSResult[];
+    connectedCallback(): void;
+    render(): TemplateResult;
+}
+declare global {
+    interface HTMLElementTagNameMap {
+        'skdx-menu-separator': SkdxMenuSeparator;
+    }
+}

package/dist/menu/MenuSeparator.js

@@ -0,0 +1,5 @@
+var n=Object.defineProperty;var c=Object.getOwnPropertyDescriptor;var m=(o,r,l,s)=>{for(var e=s>1?void 0:s?c(r,l):r,a=o.length-1,i;a>=0;a--)(i=o[a])&&(e=(s?i(r,l,e):i(e))||e);return s&&e&&n(r,l,e),e};import{css as d,html as p,LitElement as u}from"lit";import{customElement as b}from"../internal/define.js";import{hiddenHostStyles as h}from"../internal/styles.js";var t=class extends u{connectedCallback(){super.connectedCallback(),this.setAttribute("role","separator"),this.setAttribute("aria-orientation","horizontal")}render(){return p``}};t.styles=[h,d`
+      :host {
+        display: block;
+      }
+    `],t=m([b("skdx-menu-separator","menu","separator")],t);export{t as SkdxMenuSeparator};

package/dist/menu/MenuShortcut.cjs

@@ -0,0 +1,5 @@
+"use strict";var a=Object.defineProperty;var d=Object.getOwnPropertyDescriptor;var h=Object.getOwnPropertyNames;var b=Object.prototype.hasOwnProperty;var f=(s,e)=>{for(var r in e)a(s,r,{get:e[r],enumerable:!0})},v=(s,e,r,l)=>{if(e&&typeof e=="object"||typeof e=="function")for(let t of h(e))!b.call(s,t)&&t!==r&&a(s,t,{get:()=>e[t],enumerable:!(l=d(e,t))||l.enumerable});return s};var y=s=>v(a({},"__esModule",{value:!0}),s),c=(s,e,r,l)=>{for(var t=l>1?void 0:l?d(e,r):e,m=s.length-1,n;m>=0;m--)(n=s[m])&&(t=(l?n(e,r,t):n(t))||t);return l&&t&&a(e,r,t),t};var T={};f(T,{SkdxMenuShortcut:()=>o});module.exports=y(T);var i=require("lit"),p=require("../internal/define.cjs"),u=require("../internal/styles.cjs");var o=class extends i.LitElement{connectedCallback(){super.connectedCallback(),this.setAttribute("aria-hidden","true")}render(){return i.html`<slot></slot>`}};o.styles=[u.hiddenHostStyles,i.css`
+      :host {
+        display: inline;
+      }
+    `],o=c([(0,p.customElement)("skdx-menu-shortcut","menu","shortcut")],o);0&&(module.exports={SkdxMenuShortcut});

package/dist/menu/MenuShortcut.d.cts

@@ -0,0 +1,15 @@
+import { LitElement, type TemplateResult } from 'lit';
+/**
+ * Keyboard hint at item's trailing edge, e.g. "⌘K" or "Ctrl+S".
+ * `aria-hidden` so the shortcut isn't announced separately; purely presentational.
+ */
+export declare class SkdxMenuShortcut extends LitElement {
+    static styles: import("lit").CSSResult[];
+    connectedCallback(): void;
+    render(): TemplateResult;
+}
+declare global {
+    interface HTMLElementTagNameMap {
+        'skdx-menu-shortcut': SkdxMenuShortcut;
+    }
+}

package/dist/menu/MenuShortcut.d.ts

@@ -0,0 +1,15 @@
+import { LitElement, type TemplateResult } from 'lit';
+/**
+ * Keyboard hint at item's trailing edge, e.g. "⌘K" or "Ctrl+S".
+ * `aria-hidden` so the shortcut isn't announced separately; purely presentational.
+ */
+export declare class SkdxMenuShortcut extends LitElement {
+    static styles: import("lit").CSSResult[];
+    connectedCallback(): void;
+    render(): TemplateResult;
+}
+declare global {
+    interface HTMLElementTagNameMap {
+        'skdx-menu-shortcut': SkdxMenuShortcut;
+    }
+}

package/dist/menu/MenuShortcut.js

@@ -0,0 +1,5 @@
+var n=Object.defineProperty;var d=Object.getOwnPropertyDescriptor;var m=(l,s,o,r)=>{for(var e=r>1?void 0:r?d(s,o):s,i=l.length-1,a;i>=0;i--)(a=l[i])&&(e=(r?a(s,o,e):a(e))||e);return r&&e&&n(s,o,e),e};import{css as c,html as p,LitElement as u}from"lit";import{customElement as h}from"../internal/define.js";import{hiddenHostStyles as b}from"../internal/styles.js";var t=class extends u{connectedCallback(){super.connectedCallback(),this.setAttribute("aria-hidden","true")}render(){return p`<slot></slot>`}};t.styles=[b,c`
+      :host {
+        display: inline;
+      }
+    `],t=m([h("skdx-menu-shortcut","menu","shortcut")],t);export{t as SkdxMenuShortcut};

package/dist/menu/MenuSub.cjs

@@ -0,0 +1 @@
+"use strict";var c=Object.defineProperty;var g=Object.getOwnPropertyDescriptor;var b=Object.getOwnPropertyNames;var f=Object.prototype.hasOwnProperty;var B=(s,e)=>{for(var r in e)c(s,r,{get:e[r],enumerable:!0})},k=(s,e,r,m)=>{if(e&&typeof e=="object"||typeof e=="function")for(let t of b(e))!f.call(s,t)&&t!==r&&c(s,t,{get:()=>e[t],enumerable:!(m=g(e,t))||m.enumerable});return s};var y=s=>k(c({},"__esModule",{value:!0}),s),o=(s,e,r,m)=>{for(var t=m>1?void 0:m?g(e,r):e,p=s.length-1,d;p>=0;p--)(d=s[p])&&(t=(m?d(e,r,t):d(t))||t);return m&&t&&c(e,r,t),t};var z={};B(z,{SkdxMenuSub:()=>i,SkdxMenuSubContent:()=>n,SkdxMenuSubTrigger:()=>u});module.exports=y(z);var x=require("lit/decorators.js"),l=require("../internal/define.cjs"),a=require("../internal/menu-sub.cjs");var i=class extends a.SkdxMenuSubBase{};i=o([(0,l.customElement)("skdx-menu-sub")],i);var u=class extends a.SkdxMenuSubTriggerBase{};u=o([(0,l.customElement)("skdx-menu-sub-trigger","menu","sub-trigger")],u);var n=class extends a.SkdxMenuSubContentBase{};o([(0,x.property)({type:String,reflect:!0,attribute:"data-size"})],n.prototype,"size",2),n=o([(0,l.customElement)("skdx-menu-sub-content","menu","sub-content")],n);0&&(module.exports={SkdxMenuSub,SkdxMenuSubContent,SkdxMenuSubTrigger});

package/dist/menu/MenuSub.d.cts

@@ -0,0 +1,44 @@
+import { SkdxMenuSubBase, SkdxMenuSubContentBase, SkdxMenuSubTriggerBase } from '../internal/menu-sub.cjs';
+/**
+ * Root of a nested submenu: owns submenu's open state and provides anchor context for positioning.
+ * Renders no DOM element.
+ *
+ * @fires open-change - The submenu opened or closed; fires with the new open state.
+ *
+ * @example
+ * ```html
+ * <skdx-menu-sub>
+ *   <skdx-menu-sub-trigger>Share</skdx-menu-sub-trigger>
+ *   <skdx-menu-sub-content>
+ *     <skdx-menu-item>Email</skdx-menu-item>
+ *   </skdx-menu-sub-content>
+ * </skdx-menu-sub>
+ * ```
+ */
+export declare class SkdxMenuSub extends SkdxMenuSubBase {
+}
+/**
+ * Parent-menu item opening a submenu: `role="menuitem"` with `aria-haspopup`/`aria-expanded`/`aria-controls`.
+ * Opens on click/Enter/Space/ArrowRight (moving focus) or hover; never closes parent menu.
+ */
+export declare class SkdxMenuSubTrigger extends SkdxMenuSubTriggerBase {
+}
+/**
+ * Submenu's floating panel: `role="menu"`, positioned against trigger via `@floating-ui/dom` (defaults to `side="end"` / `align="start"`).
+ * Renders inline (not in a portal) so parent's dismissal treats submenu clicks as inside.
+ * ArrowLeft/Escape close only submenu and return focus to trigger; Tab closes whole menu.
+ */
+export declare class SkdxMenuSubContent extends SkdxMenuSubContentBase {
+    /**
+     * Control scale the skin renders, reflected as `data-size`; may be written as that attribute directly.
+     * @default undefined — the skin’s own default.
+     */
+    size?: 'sm' | 'lg' | (string & {}) | undefined;
+}
+declare global {
+    interface HTMLElementTagNameMap {
+        'skdx-menu-sub': SkdxMenuSub;
+        'skdx-menu-sub-trigger': SkdxMenuSubTrigger;
+        'skdx-menu-sub-content': SkdxMenuSubContent;
+    }
+}

package/dist/menu/MenuSub.d.ts

@@ -0,0 +1,44 @@
+import { SkdxMenuSubBase, SkdxMenuSubContentBase, SkdxMenuSubTriggerBase } from '../internal/menu-sub.js';
+/**
+ * Root of a nested submenu: owns submenu's open state and provides anchor context for positioning.
+ * Renders no DOM element.
+ *
+ * @fires open-change - The submenu opened or closed; fires with the new open state.
+ *
+ * @example
+ * ```html
+ * <skdx-menu-sub>
+ *   <skdx-menu-sub-trigger>Share</skdx-menu-sub-trigger>
+ *   <skdx-menu-sub-content>
+ *     <skdx-menu-item>Email</skdx-menu-item>
+ *   </skdx-menu-sub-content>
+ * </skdx-menu-sub>
+ * ```
+ */
+export declare class SkdxMenuSub extends SkdxMenuSubBase {
+}
+/**
+ * Parent-menu item opening a submenu: `role="menuitem"` with `aria-haspopup`/`aria-expanded`/`aria-controls`.
+ * Opens on click/Enter/Space/ArrowRight (moving focus) or hover; never closes parent menu.
+ */
+export declare class SkdxMenuSubTrigger extends SkdxMenuSubTriggerBase {
+}
+/**
+ * Submenu's floating panel: `role="menu"`, positioned against trigger via `@floating-ui/dom` (defaults to `side="end"` / `align="start"`).
+ * Renders inline (not in a portal) so parent's dismissal treats submenu clicks as inside.
+ * ArrowLeft/Escape close only submenu and return focus to trigger; Tab closes whole menu.
+ */
+export declare class SkdxMenuSubContent extends SkdxMenuSubContentBase {
+    /**
+     * Control scale the skin renders, reflected as `data-size`; may be written as that attribute directly.
+     * @default undefined — the skin’s own default.
+     */
+    size?: 'sm' | 'lg' | (string & {}) | undefined;
+}
+declare global {
+    interface HTMLElementTagNameMap {
+        'skdx-menu-sub': SkdxMenuSub;
+        'skdx-menu-sub-trigger': SkdxMenuSubTrigger;
+        'skdx-menu-sub-content': SkdxMenuSubContent;
+    }
+}

package/dist/menu/MenuSub.js

@@ -0,0 +1 @@
+var p=Object.defineProperty;var d=Object.getOwnPropertyDescriptor;var t=(s,m,i,n)=>{for(var e=n>1?void 0:n?d(m,i):m,u=s.length-1,c;u>=0;u--)(c=s[u])&&(e=(n?c(m,i,e):c(e))||e);return n&&e&&p(m,i,e),e};import{property as g}from"lit/decorators.js";import{customElement as l}from"../internal/define.js";import{SkdxMenuSubBase as x,SkdxMenuSubContentBase as b,SkdxMenuSubTriggerBase as f}from"../internal/menu-sub.js";var a=class extends x{};a=t([l("skdx-menu-sub")],a);var o=class extends f{};o=t([l("skdx-menu-sub-trigger","menu","sub-trigger")],o);var r=class extends b{};t([g({type:String,reflect:!0,attribute:"data-size"})],r.prototype,"size",2),r=t([l("skdx-menu-sub-content","menu","sub-content")],r);export{a as SkdxMenuSub,r as SkdxMenuSubContent,o as SkdxMenuSubTrigger};

package/dist/menu/MenuTrigger.cjs

@@ -0,0 +1,20 @@
+"use strict";var d=Object.defineProperty;var v=Object.getOwnPropertyDescriptor;var f=Object.getOwnPropertyNames;var b=Object.prototype.hasOwnProperty;var E=(r,i)=>{for(var t in i)d(r,t,{get:i[t],enumerable:!0})},P=(r,i,t,e)=>{if(i&&typeof i=="object"||typeof i=="function")for(let o of f(i))!b.call(r,o)&&o!==t&&d(r,o,{get:()=>i[o],enumerable:!(e=v(i,o))||e.enumerable});return r};var L=r=>P(d({},"__esModule",{value:!0}),r),m=(r,i,t,e)=>{for(var o=e>1?void 0:e?v(i,t):i,c=r.length-1,u;c>=0;c--)(u=r[c])&&(o=(e?u(i,t,o):u(o))||o);return e&&o&&d(i,t,o),o};var w={};E(w,{SkdxMenuTrigger:()=>n});module.exports=L(w);var s=require("lit"),g=require("lit/decorators.js"),l=require("../internal/define.cjs"),y=require("../internal/part.cjs"),a=require("../internal/styles.cjs"),h=require("./family.cjs"),p=require("./MenuRoot.cjs");var n=class extends s.LitElement{constructor(){super(...arguments);this.disabled=!1;this.root=null;this.onRootUpdate=()=>{this.syncRegion(),this.requestUpdate()};this.handleClick=()=>{this.root&&(this.root.openIntent="first",this.root.setOpen(!this.root.open))};this.handleKeyDown=t=>{["ArrowDown","ArrowUp"].includes(t.key)&&(this.root&&(this.root.openIntent=t.key==="ArrowUp"?"last":"first"),t.preventDefault(),this.root?.setOpen(!0))};this.longPressOrigin=null;this.disarmLongPress=()=>{clearTimeout(this.longPressTimer),this.longPressOrigin=null,this.style.removeProperty("touch-action")};this.handleContextMenu=t=>{!this.contextMode||this.disabled||(t.preventDefault(),this.root?.setPoint({x:t.clientX,y:t.clientY}),this.root?.setOpen(!0))};this.handlePointerDown=t=>{if(!this.contextMode||this.disabled||t.pointerType!=="touch")return;let{clientX:e,clientY:o}=t;this.longPressOrigin={x:e,y:o},this.style.touchAction="none",clearTimeout(this.longPressTimer),this.longPressTimer=setTimeout(()=>{this.longPressOrigin=null,this.style.removeProperty("touch-action"),this.root?.setPoint({x:e,y:o}),this.root?.setOpen(!0)},p.LONG_PRESS_MS)};this.handlePointerMove=t=>{let e=this.longPressOrigin;e&&Math.hypot(t.clientX-e.x,t.clientY-e.y)>p.LONG_PRESS_MOVE_TOLERANCE&&this.disarmLongPress()};this.handleRegionKeyDown=t=>{if(!this.contextMode||this.disabled||t.key!=="ContextMenu"&&!(t.key==="F10"&&t.shiftKey))return;t.preventDefault();let e=this.getBoundingClientRect();this.root?.setPoint({x:e.left,y:e.bottom}),this.root?.setOpen(!0)};this.regionApplied=!1}get contextMode(){return this.root?.openOn==="contextmenu"}connectedCallback(){super.connectedCallback(),this.root=h.MENU_FAMILY.root(this),this.root&&(0,l.whenUpgraded)(this.root,()=>{this.root&&(this.id?this.root.triggerId=this.id:this.id=this.root.triggerId,this.syncRegion())}),this.root?.addEventListener(h.MENU_FAMILY.event,this.onRootUpdate),this.addEventListener("contextmenu",this.handleContextMenu),this.addEventListener("pointerdown",this.handlePointerDown),this.addEventListener("pointermove",this.handlePointerMove),this.addEventListener("pointerup",this.disarmLongPress),this.addEventListener("pointercancel",this.disarmLongPress),this.addEventListener("keydown",this.handleRegionKeyDown),this.syncRegion()}disconnectedCallback(){this.root?.removeEventListener(h.MENU_FAMILY.event,this.onRootUpdate),this.root?.triggerEl===this&&(this.root.triggerEl=null),this.removeEventListener("contextmenu",this.handleContextMenu),this.removeEventListener("pointerdown",this.handlePointerDown),this.removeEventListener("pointermove",this.handlePointerMove),this.removeEventListener("pointerup",this.disarmLongPress),this.removeEventListener("pointercancel",this.disarmLongPress),this.removeEventListener("keydown",this.handleRegionKeyDown),this.disarmLongPress(),super.disconnectedCallback()}firstUpdated(){let t=this.shadowRoot?.querySelector("button");this.root&&t&&(this.root.triggerEl=t)}syncRegion(){if(!this.contextMode){if(!this.regionApplied)return;this.regionApplied=!1;for(let o of["role","aria-owns","aria-controls","data-state","aria-disabled"])this.removeAttribute(o);let e=this.shadowRoot?.querySelector("button");this.root&&e&&(this.root.triggerEl=e);return}this.regionApplied=!0,this.root&&(this.root.triggerEl=this),this.tabIndex=0,this.setAttribute("role","group");let t=this.root?.open??!1;this.setAttribute("data-state",t?"open":"closed"),this.root&&this.setAttribute("aria-controls",this.root.contentId),t&&this.root?this.setAttribute("aria-owns",this.root.contentId):this.removeAttribute("aria-owns"),this.disabled?this.setAttribute("aria-disabled","true"):this.removeAttribute("aria-disabled")}updated(){(0,y.reflectHostState)(this,{"data-disabled":this.disabled?"":null}),this.syncRegion()}render(){let t=this.root;return t?this.contextMode?s.html`<slot></slot>`:s.html`
+      <button
+        part="trigger"
+        type="button"
+        aria-haspopup="menu"
+        aria-expanded=${t.open}
+        aria-controls=${t.contentId}
+        data-state=${t.open?"open":"closed"}
+        data-disabled=${this.disabled?"":s.nothing}
+        ?disabled=${this.disabled}
+        @click=${this.handleClick}
+        @keydown=${this.handleKeyDown}
+      >
+        <slot></slot>
+      </button>
+    `:s.nothing}};n.shadowRootOptions=a.delegatesFocusShadowRootOptions,n.styles=[a.resetNativeControl,a.hiddenHostStyles,s.css`
+      :host {
+        display: inline-block;
+      }
+    `,a.controlBoxOnHost],m([(0,g.property)({type:Boolean,reflect:!0})],n.prototype,"disabled",2),n=m([(0,l.customElement)("skdx-menu-trigger","menu","trigger")],n);0&&(module.exports={SkdxMenuTrigger});

package/dist/menu/MenuTrigger.d.cts

@@ -0,0 +1,44 @@
+import { LitElement, nothing, type TemplateResult } from 'lit';
+/**
+ * Button element that opens/closes the menu.
+ * Opens on its first item via Enter/Space/ArrowDown; on the last via ArrowUp per WAI-ARIA pattern.
+ * Under the root's `open-on="contextmenu"` it is a focusable region (`role="group"`) instead,
+ * opening the panel at the pointer on right-click, on a 500ms touch long-press, or on Shift+F10.
+ *
+ * @csspart trigger - The native button element, rendered only in click mode.
+ */
+export declare class SkdxMenuTrigger extends LitElement {
+    static shadowRootOptions: ShadowRootInit;
+    static styles: import("lit").CSSResult[];
+    /**
+     * Disables the trigger and prevents opening the menu. Under
+     * `open-on="contextmenu"` the native browser context menu is let through.
+     * @default false
+     */
+    disabled: boolean;
+    private root;
+    private readonly onRootUpdate;
+    private get contextMode();
+    connectedCallback(): void;
+    disconnectedCallback(): void;
+    firstUpdated(): void;
+    private readonly handleClick;
+    private readonly handleKeyDown;
+    private longPressTimer?;
+    private longPressOrigin;
+    private readonly disarmLongPress;
+    private readonly handleContextMenu;
+    private readonly handlePointerDown;
+    private readonly handlePointerMove;
+    private readonly handleRegionKeyDown;
+    private regionApplied;
+    /** Host-level wiring the region mode needs and the button mode must not carry. */
+    private syncRegion;
+    protected updated(): void;
+    render(): TemplateResult | typeof nothing;
+}
+declare global {
+    interface HTMLElementTagNameMap {
+        'skdx-menu-trigger': SkdxMenuTrigger;
+    }
+}

package/dist/menu/MenuTrigger.d.ts

@@ -0,0 +1,44 @@
+import { LitElement, nothing, type TemplateResult } from 'lit';
+/**
+ * Button element that opens/closes the menu.
+ * Opens on its first item via Enter/Space/ArrowDown; on the last via ArrowUp per WAI-ARIA pattern.
+ * Under the root's `open-on="contextmenu"` it is a focusable region (`role="group"`) instead,
+ * opening the panel at the pointer on right-click, on a 500ms touch long-press, or on Shift+F10.
+ *
+ * @csspart trigger - The native button element, rendered only in click mode.
+ */
+export declare class SkdxMenuTrigger extends LitElement {
+    static shadowRootOptions: ShadowRootInit;
+    static styles: import("lit").CSSResult[];
+    /**
+     * Disables the trigger and prevents opening the menu. Under
+     * `open-on="contextmenu"` the native browser context menu is let through.
+     * @default false
+     */
+    disabled: boolean;
+    private root;
+    private readonly onRootUpdate;
+    private get contextMode();
+    connectedCallback(): void;
+    disconnectedCallback(): void;
+    firstUpdated(): void;
+    private readonly handleClick;
+    private readonly handleKeyDown;
+    private longPressTimer?;
+    private longPressOrigin;
+    private readonly disarmLongPress;
+    private readonly handleContextMenu;
+    private readonly handlePointerDown;
+    private readonly handlePointerMove;
+    private readonly handleRegionKeyDown;
+    private regionApplied;
+    /** Host-level wiring the region mode needs and the button mode must not carry. */
+    private syncRegion;
+    protected updated(): void;
+    render(): TemplateResult | typeof nothing;
+}
+declare global {
+    interface HTMLElementTagNameMap {
+        'skdx-menu-trigger': SkdxMenuTrigger;
+    }
+}

package/dist/menu/MenuTrigger.js

@@ -0,0 +1,20 @@
+var c=Object.defineProperty;var u=Object.getOwnPropertyDescriptor;var d=(s,r,t,e)=>{for(var o=e>1?void 0:e?u(r,t):r,n=s.length-1,a;n>=0;n--)(a=s[n])&&(o=(e?a(r,t,o):a(o))||o);return e&&o&&c(r,t,o),o};import{css as m,html as l,LitElement as v,nothing as p}from"lit";import{property as g}from"lit/decorators.js";import{customElement as y,whenUpgraded as f}from"../internal/define.js";import{reflectHostState as b}from"../internal/part.js";import{controlBoxOnHost as E,delegatesFocusShadowRootOptions as P,hiddenHostStyles as L,resetNativeControl as w}from"../internal/styles.js";import{MENU_FAMILY as h}from"./family.js";import{LONG_PRESS_MOVE_TOLERANCE as R,LONG_PRESS_MS as x}from"./MenuRoot.js";var i=class extends v{constructor(){super(...arguments);this.disabled=!1;this.root=null;this.onRootUpdate=()=>{this.syncRegion(),this.requestUpdate()};this.handleClick=()=>{this.root&&(this.root.openIntent="first",this.root.setOpen(!this.root.open))};this.handleKeyDown=t=>{["ArrowDown","ArrowUp"].includes(t.key)&&(this.root&&(this.root.openIntent=t.key==="ArrowUp"?"last":"first"),t.preventDefault(),this.root?.setOpen(!0))};this.longPressOrigin=null;this.disarmLongPress=()=>{clearTimeout(this.longPressTimer),this.longPressOrigin=null,this.style.removeProperty("touch-action")};this.handleContextMenu=t=>{!this.contextMode||this.disabled||(t.preventDefault(),this.root?.setPoint({x:t.clientX,y:t.clientY}),this.root?.setOpen(!0))};this.handlePointerDown=t=>{if(!this.contextMode||this.disabled||t.pointerType!=="touch")return;let{clientX:e,clientY:o}=t;this.longPressOrigin={x:e,y:o},this.style.touchAction="none",clearTimeout(this.longPressTimer),this.longPressTimer=setTimeout(()=>{this.longPressOrigin=null,this.style.removeProperty("touch-action"),this.root?.setPoint({x:e,y:o}),this.root?.setOpen(!0)},x)};this.handlePointerMove=t=>{let e=this.longPressOrigin;e&&Math.hypot(t.clientX-e.x,t.clientY-e.y)>R&&this.disarmLongPress()};this.handleRegionKeyDown=t=>{if(!this.contextMode||this.disabled||t.key!=="ContextMenu"&&!(t.key==="F10"&&t.shiftKey))return;t.preventDefault();let e=this.getBoundingClientRect();this.root?.setPoint({x:e.left,y:e.bottom}),this.root?.setOpen(!0)};this.regionApplied=!1}get contextMode(){return this.root?.openOn==="contextmenu"}connectedCallback(){super.connectedCallback(),this.root=h.root(this),this.root&&f(this.root,()=>{this.root&&(this.id?this.root.triggerId=this.id:this.id=this.root.triggerId,this.syncRegion())}),this.root?.addEventListener(h.event,this.onRootUpdate),this.addEventListener("contextmenu",this.handleContextMenu),this.addEventListener("pointerdown",this.handlePointerDown),this.addEventListener("pointermove",this.handlePointerMove),this.addEventListener("pointerup",this.disarmLongPress),this.addEventListener("pointercancel",this.disarmLongPress),this.addEventListener("keydown",this.handleRegionKeyDown),this.syncRegion()}disconnectedCallback(){this.root?.removeEventListener(h.event,this.onRootUpdate),this.root?.triggerEl===this&&(this.root.triggerEl=null),this.removeEventListener("contextmenu",this.handleContextMenu),this.removeEventListener("pointerdown",this.handlePointerDown),this.removeEventListener("pointermove",this.handlePointerMove),this.removeEventListener("pointerup",this.disarmLongPress),this.removeEventListener("pointercancel",this.disarmLongPress),this.removeEventListener("keydown",this.handleRegionKeyDown),this.disarmLongPress(),super.disconnectedCallback()}firstUpdated(){let t=this.shadowRoot?.querySelector("button");this.root&&t&&(this.root.triggerEl=t)}syncRegion(){if(!this.contextMode){if(!this.regionApplied)return;this.regionApplied=!1;for(let o of["role","aria-owns","aria-controls","data-state","aria-disabled"])this.removeAttribute(o);let e=this.shadowRoot?.querySelector("button");this.root&&e&&(this.root.triggerEl=e);return}this.regionApplied=!0,this.root&&(this.root.triggerEl=this),this.tabIndex=0,this.setAttribute("role","group");let t=this.root?.open??!1;this.setAttribute("data-state",t?"open":"closed"),this.root&&this.setAttribute("aria-controls",this.root.contentId),t&&this.root?this.setAttribute("aria-owns",this.root.contentId):this.removeAttribute("aria-owns"),this.disabled?this.setAttribute("aria-disabled","true"):this.removeAttribute("aria-disabled")}updated(){b(this,{"data-disabled":this.disabled?"":null}),this.syncRegion()}render(){let t=this.root;return t?this.contextMode?l`<slot></slot>`:l`
+      <button
+        part="trigger"
+        type="button"
+        aria-haspopup="menu"
+        aria-expanded=${t.open}
+        aria-controls=${t.contentId}
+        data-state=${t.open?"open":"closed"}
+        data-disabled=${this.disabled?"":p}
+        ?disabled=${this.disabled}
+        @click=${this.handleClick}
+        @keydown=${this.handleKeyDown}
+      >
+        <slot></slot>
+      </button>
+    `:p}};i.shadowRootOptions=P,i.styles=[w,L,m`
+      :host {
+        display: inline-block;
+      }
+    `,E],d([g({type:Boolean,reflect:!0})],i.prototype,"disabled",2),i=d([y("skdx-menu-trigger","menu","trigger")],i);export{i as SkdxMenuTrigger};

package/dist/menu/family.cjs

@@ -0,0 +1 @@
+"use strict";var n=Object.defineProperty;var d=Object.getOwnPropertyDescriptor;var x=Object.getOwnPropertyNames;var M=Object.prototype.hasOwnProperty;var i=(e,o)=>{for(var m in o)n(e,m,{get:o[m],enumerable:!0})},k=(e,o,m,r)=>{if(o&&typeof o=="object"||typeof o=="function")for(let t of x(o))!M.call(e,t)&&t!==m&&n(e,t,{get:()=>o[t],enumerable:!(r=d(o,t))||r.enumerable});return e};var p=e=>k(n({},"__esModule",{value:!0}),e);var f={};i(f,{MENU_FAMILY:()=>s});module.exports=p(f);var u=require("../internal/family.cjs"),s=(0,u.defineFamily)("menu",{selector:"skdx-menu, skdx-menu-root"});0&&(module.exports={MENU_FAMILY});

package/dist/menu/family.d.cts

@@ -0,0 +1,3 @@
+import type { SkdxMenuRoot } from './MenuRoot.cjs';
+/** @internal The broadcast every `<skdx-menu-*>` part re-renders on, and the lookup that finds their root. */
+export declare const MENU_FAMILY: import("../internal/family.cjs").SkdxFamily<SkdxMenuRoot>;

package/dist/menu/family.d.ts

@@ -0,0 +1,3 @@
+import type { SkdxMenuRoot } from './MenuRoot.js';
+/** @internal The broadcast every `<skdx-menu-*>` part re-renders on, and the lookup that finds their root. */
+export declare const MENU_FAMILY: import("../internal/family.js").SkdxFamily<SkdxMenuRoot>;

package/dist/menu/family.js

@@ -0,0 +1 @@
+import{defineFamily as o}from"../internal/family.js";var t=o("menu",{selector:"skdx-menu, skdx-menu-root"});export{t as MENU_FAMILY};

package/dist/menu/index.cjs

@@ -0,0 +1 @@
+"use strict";var p=Object.defineProperty;var u=Object.getOwnPropertyDescriptor;var M=Object.getOwnPropertyNames;var d=Object.prototype.hasOwnProperty;var k=(o,e)=>{for(var n in e)p(o,n,{get:e[n],enumerable:!0})},m=(o,e,n,r)=>{if(e&&typeof e=="object"||typeof e=="function")for(let t of M(e))!d.call(o,t)&&t!==n&&p(o,t,{get:()=>e[t],enumerable:!(r=u(e,t))||r.enumerable});return o};var S=o=>m(p({},"__esModule",{value:!0}),o);var f={};k(f,{SkdxMenu:()=>x.SkdxMenu});module.exports=S(f);var x=require("./Menu.cjs");0&&(module.exports={SkdxMenu});

package/dist/menu/index.d.cts

@@ -0,0 +1,3 @@
+export { SkdxMenu } from './Menu.cjs';
+export type { SkdxMenuOpenOn, SkdxMenuPoint } from './MenuRoot.cjs';
+export type { SkdxMenuItemDescriptor } from './types.cjs';

package/dist/menu/index.d.ts

@@ -0,0 +1,3 @@
+export { SkdxMenu } from './Menu.js';
+export type { SkdxMenuOpenOn, SkdxMenuPoint } from './MenuRoot.js';
+export type { SkdxMenuItemDescriptor } from './types.js';

package/dist/menu/index.js

@@ -0,0 +1 @@
+import{SkdxMenu as t}from"./Menu.js";export{t as SkdxMenu};

package/dist/menu/primitives.cjs

@@ -0,0 +1 @@
+"use strict";var u=Object.defineProperty;var R=Object.getOwnPropertyDescriptor;var h=Object.getOwnPropertyNames;var l=Object.prototype.hasOwnProperty;var G=(e,o)=>{for(var t in o)u(e,t,{get:o[t],enumerable:!0})},T=(e,o,t,n)=>{if(o&&typeof o=="object"||typeof o=="function")for(let x of h(o))!l.call(e,x)&&x!==t&&u(e,x,{get:()=>o[x],enumerable:!(n=R(o,x))||n.enumerable});return e};var w=e=>T(u({},"__esModule",{value:!0}),e);var A={};G(A,{SkdxMenuArrow:()=>p.SkdxMenuArrow,SkdxMenuCheckboxItem:()=>f.SkdxMenuCheckboxItem,SkdxMenuContent:()=>k.SkdxMenuContent,SkdxMenuGroup:()=>I.SkdxMenuGroup,SkdxMenuItem:()=>M.SkdxMenuItem,SkdxMenuItemIndicator:()=>i.SkdxMenuItemIndicator,SkdxMenuLabel:()=>g.SkdxMenuLabel,SkdxMenuPortal:()=>m.SkdxMenuPortal,SkdxMenuRadioGroup:()=>a.SkdxMenuRadioGroup,SkdxMenuRadioItem:()=>b.SkdxMenuRadioItem,SkdxMenuRoot:()=>S.SkdxMenuRoot,SkdxMenuSeparator:()=>c.SkdxMenuSeparator,SkdxMenuShortcut:()=>C.SkdxMenuShortcut,SkdxMenuSub:()=>r.SkdxMenuSub,SkdxMenuSubContent:()=>r.SkdxMenuSubContent,SkdxMenuSubTrigger:()=>r.SkdxMenuSubTrigger,SkdxMenuTrigger:()=>d.SkdxMenuTrigger});module.exports=w(A);var S=require("./MenuRoot.cjs"),d=require("./MenuTrigger.cjs"),m=require("./MenuPortal.cjs"),k=require("./MenuContent.cjs"),p=require("./MenuArrow.cjs"),M=require("./MenuItem.cjs"),f=require("./MenuCheckboxItem.cjs"),a=require("./MenuRadioGroup.cjs"),b=require("./MenuRadioItem.cjs"),i=require("./MenuItemIndicator.cjs"),I=require("./MenuGroup.cjs"),g=require("./MenuLabel.cjs"),c=require("./MenuSeparator.cjs"),C=require("./MenuShortcut.cjs"),r=require("./MenuSub.cjs");0&&(module.exports={SkdxMenuArrow,SkdxMenuCheckboxItem,SkdxMenuContent,SkdxMenuGroup,SkdxMenuItem,SkdxMenuItemIndicator,SkdxMenuLabel,SkdxMenuPortal,SkdxMenuRadioGroup,SkdxMenuRadioItem,SkdxMenuRoot,SkdxMenuSeparator,SkdxMenuShortcut,SkdxMenuSub,SkdxMenuSubContent,SkdxMenuSubTrigger,SkdxMenuTrigger});

package/dist/menu/primitives.d.cts

@@ -0,0 +1,35 @@
+/**
+ * Advanced primitives for `<skdx-menu>` — the parts the recipe
+ * composes. Reach for these when the derived anatomy is not the structure
+ * you need.
+ *
+ * @example
+ * ```ts
+ * import * as Menu from '@skdx/web-components/primitives/menu';
+ * ```
+ * ```html
+ * <skdx-menu-root>
+ *   <skdx-menu-trigger>Options</skdx-menu-trigger>
+ *   <skdx-menu-content>
+ *     <skdx-menu-item>Edit</skdx-menu-item>
+ *     <skdx-menu-separator></skdx-menu-separator>
+ *     <skdx-menu-item>Delete</skdx-menu-item>
+ *   </skdx-menu-content>
+ * </skdx-menu-root>
+ * ```
+ */
+export { SkdxMenuRoot } from './MenuRoot.cjs';
+export { SkdxMenuTrigger } from './MenuTrigger.cjs';
+export { SkdxMenuPortal } from './MenuPortal.cjs';
+export { SkdxMenuContent } from './MenuContent.cjs';
+export { SkdxMenuArrow } from './MenuArrow.cjs';
+export { SkdxMenuItem } from './MenuItem.cjs';
+export { SkdxMenuCheckboxItem } from './MenuCheckboxItem.cjs';
+export { SkdxMenuRadioGroup } from './MenuRadioGroup.cjs';
+export { SkdxMenuRadioItem } from './MenuRadioItem.cjs';
+export { SkdxMenuItemIndicator } from './MenuItemIndicator.cjs';
+export { SkdxMenuGroup } from './MenuGroup.cjs';
+export { SkdxMenuLabel } from './MenuLabel.cjs';
+export { SkdxMenuSeparator } from './MenuSeparator.cjs';
+export { SkdxMenuShortcut } from './MenuShortcut.cjs';
+export { SkdxMenuSub, SkdxMenuSubTrigger, SkdxMenuSubContent } from './MenuSub.cjs';

package/dist/menu/primitives.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Advanced primitives for `<skdx-menu>` — the parts the recipe
+ * composes. Reach for these when the derived anatomy is not the structure
+ * you need.
+ *
+ * @example
+ * ```ts
+ * import * as Menu from '@skdx/web-components/primitives/menu';
+ * ```
+ * ```html
+ * <skdx-menu-root>
+ *   <skdx-menu-trigger>Options</skdx-menu-trigger>
+ *   <skdx-menu-content>
+ *     <skdx-menu-item>Edit</skdx-menu-item>
+ *     <skdx-menu-separator></skdx-menu-separator>
+ *     <skdx-menu-item>Delete</skdx-menu-item>
+ *   </skdx-menu-content>
+ * </skdx-menu-root>
+ * ```
+ */
+export { SkdxMenuRoot } from './MenuRoot.js';
+export { SkdxMenuTrigger } from './MenuTrigger.js';
+export { SkdxMenuPortal } from './MenuPortal.js';
+export { SkdxMenuContent } from './MenuContent.js';
+export { SkdxMenuArrow } from './MenuArrow.js';
+export { SkdxMenuItem } from './MenuItem.js';
+export { SkdxMenuCheckboxItem } from './MenuCheckboxItem.js';
+export { SkdxMenuRadioGroup } from './MenuRadioGroup.js';
+export { SkdxMenuRadioItem } from './MenuRadioItem.js';
+export { SkdxMenuItemIndicator } from './MenuItemIndicator.js';
+export { SkdxMenuGroup } from './MenuGroup.js';
+export { SkdxMenuLabel } from './MenuLabel.js';
+export { SkdxMenuSeparator } from './MenuSeparator.js';
+export { SkdxMenuShortcut } from './MenuShortcut.js';
+export { SkdxMenuSub, SkdxMenuSubTrigger, SkdxMenuSubContent } from './MenuSub.js';

package/dist/menu/primitives.js

@@ -0,0 +1 @@
+import{SkdxMenuRoot as r}from"./MenuRoot.js";import{SkdxMenuTrigger as t}from"./MenuTrigger.js";import{SkdxMenuPortal as n}from"./MenuPortal.js";import{SkdxMenuContent as d}from"./MenuContent.js";import{SkdxMenuArrow as k}from"./MenuArrow.js";import{SkdxMenuItem as M}from"./MenuItem.js";import{SkdxMenuCheckboxItem as a}from"./MenuCheckboxItem.js";import{SkdxMenuRadioGroup as i}from"./MenuRadioGroup.js";import{SkdxMenuRadioItem as g}from"./MenuRadioItem.js";import{SkdxMenuItemIndicator as C}from"./MenuItemIndicator.js";import{SkdxMenuGroup as h}from"./MenuGroup.js";import{SkdxMenuLabel as G}from"./MenuLabel.js";import{SkdxMenuSeparator as w}from"./MenuSeparator.js";import{SkdxMenuShortcut as L}from"./MenuShortcut.js";import{SkdxMenuSub as j,SkdxMenuSubTrigger as q,SkdxMenuSubContent as s}from"./MenuSub.js";export{k as SkdxMenuArrow,a as SkdxMenuCheckboxItem,d as SkdxMenuContent,h as SkdxMenuGroup,M as SkdxMenuItem,C as SkdxMenuItemIndicator,G as SkdxMenuLabel,n as SkdxMenuPortal,i as SkdxMenuRadioGroup,g as SkdxMenuRadioItem,r as SkdxMenuRoot,w as SkdxMenuSeparator,L as SkdxMenuShortcut,j as SkdxMenuSub,s as SkdxMenuSubContent,q as SkdxMenuSubTrigger,t as SkdxMenuTrigger};

package/dist/menu/types.cjs

@@ -0,0 +1 @@
+"use strict";var o=Object.defineProperty;var r=Object.getOwnPropertyDescriptor;var i=Object.getOwnPropertyNames;var s=Object.prototype.hasOwnProperty;var d=(t,e,a,n)=>{if(e&&typeof e=="object"||typeof e=="function")for(let l of i(e))!s.call(t,l)&&l!==a&&o(t,l,{get:()=>e[l],enumerable:!(n=r(e,l))||n.enumerable});return t};var g=t=>d(o({},"__esModule",{value:!0}),t);var b={};module.exports=g(b);

package/dist/menu/types.d.cts

@@ -0,0 +1,60 @@
+/**
+ * One entry in `<skdx-menu>`'s `items`; plain action items have no `type`, others narrow via `'type' in item`.
+ */
+export type SkdxMenuItemDescriptor = {
+    /** Text rendered in the item. */
+    label: string;
+    /** Called when the item is activated, before the root's `item-select`. */
+    onSelect?: () => void;
+    /** Keyboard hint at trailing edge, `aria-hidden` (e.g., "⌘K"). */
+    shortcut?: string;
+    /** Marks `aria-disabled`, blocks selection; stays in roving order. */
+    disabled?: boolean;
+    /** Typeahead text; overrides rendered text. */
+    textValue?: string;
+} | {
+    type: 'separator';
+} | {
+    type: 'checkbox';
+    /** Text rendered in the item. */
+    label: string;
+    /** Checked state, externally controlled; write it back from `onCheckedChange`. */
+    checked?: boolean;
+    /** Called with new checked state on activation. */
+    onCheckedChange?: (checked: boolean) => void;
+    /** Keyboard hint at trailing edge, `aria-hidden`. */
+    shortcut?: string;
+    /** Marks `aria-disabled`, blocks selection. */
+    disabled?: boolean;
+    /** Typeahead text; overrides rendered text. */
+    textValue?: string;
+} | {
+    type: 'radio-group';
+    /** Selected option value, externally controlled. */
+    value?: string;
+    /** Called with newly selected value. */
+    onValueChange?: (value: string) => void;
+    /** The mutually-exclusive options. */
+    items: readonly {
+        label: string;
+        value: string;
+        disabled?: boolean;
+        textValue?: string;
+    }[];
+} | {
+    type: 'submenu';
+    /** Text in the parent item that opens the submenu. */
+    label: string;
+    /** Submenu entries; the union recurses, allowing nested submenus. */
+    items: readonly SkdxMenuItemDescriptor[];
+    /** Marks sub-trigger `aria-disabled`, blocks opening. */
+    disabled?: boolean;
+    /** Typeahead text; overrides sub-trigger's rendered text. */
+    textValue?: string;
+} | {
+    type: 'group';
+    /** Heading text; the group names itself after it. Omit for an unlabelled group. */
+    label?: string;
+    /** The grouped entries. */
+    items: readonly SkdxMenuItemDescriptor[];
+};

package/dist/menu/types.d.ts

@@ -0,0 +1,60 @@
+/**
+ * One entry in `<skdx-menu>`'s `items`; plain action items have no `type`, others narrow via `'type' in item`.
+ */
+export type SkdxMenuItemDescriptor = {
+    /** Text rendered in the item. */
+    label: string;
+    /** Called when the item is activated, before the root's `item-select`. */
+    onSelect?: () => void;
+    /** Keyboard hint at trailing edge, `aria-hidden` (e.g., "⌘K"). */
+    shortcut?: string;
+    /** Marks `aria-disabled`, blocks selection; stays in roving order. */
+    disabled?: boolean;
+    /** Typeahead text; overrides rendered text. */
+    textValue?: string;
+} | {
+    type: 'separator';
+} | {
+    type: 'checkbox';
+    /** Text rendered in the item. */
+    label: string;
+    /** Checked state, externally controlled; write it back from `onCheckedChange`. */
+    checked?: boolean;
+    /** Called with new checked state on activation. */
+    onCheckedChange?: (checked: boolean) => void;
+    /** Keyboard hint at trailing edge, `aria-hidden`. */
+    shortcut?: string;
+    /** Marks `aria-disabled`, blocks selection. */
+    disabled?: boolean;
+    /** Typeahead text; overrides rendered text. */
+    textValue?: string;
+} | {
+    type: 'radio-group';
+    /** Selected option value, externally controlled. */
+    value?: string;
+    /** Called with newly selected value. */
+    onValueChange?: (value: string) => void;
+    /** The mutually-exclusive options. */
+    items: readonly {
+        label: string;
+        value: string;
+        disabled?: boolean;
+        textValue?: string;
+    }[];
+} | {
+    type: 'submenu';
+    /** Text in the parent item that opens the submenu. */
+    label: string;
+    /** Submenu entries; the union recurses, allowing nested submenus. */
+    items: readonly SkdxMenuItemDescriptor[];
+    /** Marks sub-trigger `aria-disabled`, blocks opening. */
+    disabled?: boolean;
+    /** Typeahead text; overrides sub-trigger's rendered text. */
+    textValue?: string;
+} | {
+    type: 'group';
+    /** Heading text; the group names itself after it. Omit for an unlabelled group. */
+    label?: string;
+    /** The grouped entries. */
+    items: readonly SkdxMenuItemDescriptor[];
+};

package/dist/menubar/Menubar.cjs

@@ -1 +1 @@
-"use strict";var i=Object.defineProperty;var u=Object.getOwnPropertyDescriptor;var h=Object.getOwnPropertyNames;var A=Object.prototype.hasOwnProperty;var b=(r,e)=>{for(var o in e)i(r,o,{get:e[o],enumerable:!0})},k=(r,e,o,n)=>{if(e&&typeof e=="object"||typeof e=="function")for(let t of h(e))!A.call(r,t)&&t!==o&&i(r,t,{get:()=>e[t],enumerable:!(n=u(e,t))||n.enumerable});return r};var v=r=>k(i({},"__esModule",{value:!0}),r),p=(r,e,o,n)=>{for(var t=n>1?void 0:n?u(e,o):e,m=r.length-1,l;m>=0;m--)(l=r[m])&&(t=(n?l(e,o,t):l(t))||t);return n&&t&&i(e,o,t),t};var E={};b(E,{SkdxMenubar:()=>a});module.exports=v(E);var d=require("lit"),f=require("lit/decorators.js"),c=require("../internal/authored.cjs"),y=require("../internal/define.cjs"),s=require("./MenubarAnatomy.cjs"),M=require("./MenubarRoot.cjs");var a=class extends M.SkdxMenubarRoot{constructor(){super(...arguments);this.fillAnatomy=()=>{this.menus===this._anatomyMenusRef&&(0,c.hasGeneratedContent)(this,s.MENUBAR_ANATOMY_GENERATED)||(this._anatomyMenusRef=this.menus,(0,s.fillMenubarAnatomy)(this))}}connectedCallback(){super.connectedCallback(),queueMicrotask(this.fillAnatomy)}updated(o){this.fillAnatomy(),super.updated(o)}render(){return d.html`<slot @slotchange=${this.fillAnatomy}></slot>`}};p([(0,f.property)({attribute:!1})],a.prototype,"menus",2),a=p([(0,y.customElement)("skdx-menubar")],a);0&&(module.exports={SkdxMenubar});
+"use strict";var i=Object.defineProperty;var u=Object.getOwnPropertyDescriptor;var h=Object.getOwnPropertyNames;var A=Object.prototype.hasOwnProperty;var b=(r,e)=>{for(var o in e)i(r,o,{get:e[o],enumerable:!0})},v=(r,e,o,n)=>{if(e&&typeof e=="object"||typeof e=="function")for(let t of h(e))!A.call(r,t)&&t!==o&&i(r,t,{get:()=>e[t],enumerable:!(n=u(e,t))||n.enumerable});return r};var R=r=>v(i({},"__esModule",{value:!0}),r),p=(r,e,o,n)=>{for(var t=n>1?void 0:n?u(e,o):e,m=r.length-1,l;m>=0;m--)(l=r[m])&&(t=(n?l(e,o,t):l(t))||t);return n&&t&&i(e,o,t),t};var k={};b(k,{SkdxMenubar:()=>a});module.exports=R(k);var d=require("lit"),f=require("lit/decorators.js"),c=require("../internal/authored.cjs"),y=require("../internal/define.cjs"),s=require("./MenubarAnatomy.cjs"),M=require("./MenubarRoot.cjs");var a=class extends M.SkdxMenubarRoot{constructor(){super(...arguments);this.fillAnatomy=()=>{this.menus===this._anatomyMenusRef&&(0,c.hasGeneratedContent)(this,s.MENUBAR_ANATOMY_GENERATED)||(this._anatomyMenusRef=this.menus,(0,s.fillMenubarAnatomy)(this))}}connectedCallback(){super.connectedCallback(),queueMicrotask(this.fillAnatomy)}updated(o){this.fillAnatomy(),super.updated(o)}render(){return d.html`<slot @slotchange=${this.fillAnatomy}></slot>`}};p([(0,f.property)({attribute:!1})],a.prototype,"menus",2),a=p([(0,y.customElement)("skdx-menubar")],a);0&&(module.exports={SkdxMenubar});