@material/web 2.5.1-nightly.b4de401.0 → 2.5.1-nightly.bd360db.0

package/labs/aria/command.js

@@ -0,0 +1,204 @@
+/**
+ * @license
+ * Copyright 2026 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+/// <reference types="../../types/command-event.d.ts" />
+/// <reference types="../../types/popover.d.ts" />
+import { queryAssociatedById } from './query-associated.js';
+/**
+ * Determines an element's `command` attribute state, given the attribute value.
+ */
+function getCommandState(attrValue) {
+    switch (attrValue) {
+        case 'toggle-popover':
+        case 'show-popover':
+        case 'hide-popover':
+        case 'close':
+        case 'request-close':
+        case 'show-modal':
+            return attrValue;
+        default:
+            return attrValue?.startsWith('--') ? 'custom' : 'unknown';
+    }
+}
+/** Determines the popover state of an element. */
+function getPopoverState(element) {
+    if (element.localName === 'md-aria-menulist') {
+        return 'auto';
+    }
+    const attrValue = element.getAttribute('popover');
+    switch (attrValue) {
+        case '':
+            return 'auto';
+        case 'auto':
+        case 'manual':
+        case 'hint':
+            return attrValue;
+        case null:
+        default:
+            return 'no-popover';
+    }
+}
+/**
+ * Determines the popover target action from an element's `popovertargetaction`
+ * attribute value.
+ */
+function getPopoverTargetActionState(attrValue) {
+    switch (attrValue) {
+        case 'toggle':
+        case 'show':
+        case 'hide':
+            return attrValue;
+        default:
+            return 'toggle';
+    }
+}
+/**
+ * Performs the 'shared command invoker activation steps' for a button or
+ * menuitem, to be called when that element is activated: either runs a command
+ * (i.e. the element has `command` and `commandfor` attributes) or changes a
+ * popover's state (i.e. the element has the `popovertarget` and possibly
+ * `popovertargetaction` attributes).
+ *
+ * https://whatpr.org/html/12011/popover.html#shared-command-invoker-activation-steps
+ *
+ * @param element The button or menuitem being activated.
+ * @param event The event that activated `element`.
+ */
+export function sharedCommandInvokerActivationSteps(element, event) {
+    const idref = element.getAttribute('commandfor');
+    const commandTarget = queryAssociatedById(element, idref ?? '');
+    if (!commandTarget) {
+        popoverTargetAttributeActivationBehavior(element, event.target);
+        return;
+    }
+    const command = element.getAttribute('command');
+    const commandState = getCommandState(command);
+    if (commandState === 'unknown' || command === null) {
+        return;
+    }
+    const isPopover = getPopoverState(commandTarget) !== 'no-popover';
+    if (isPopover && commandState !== 'custom') {
+        // `<dialog>` is the only element that defines 'is valid command steps'.
+        if (commandTarget.localName === 'dialog' &&
+            !['close', 'request-close', 'show-modal'].includes(commandState)) {
+            return;
+        }
+    }
+    const continueSteps = commandTarget.dispatchEvent(new CommandEvent('command', { source: element, command, cancelable: true }));
+    if (!continueSteps ||
+        !commandTarget.isConnected ||
+        commandState === 'custom') {
+        return;
+    }
+    switch (command) {
+        case 'hide-popover':
+            try {
+                // Use `togglePopover` because `hidePopover` doesn't support `source`.
+                commandTarget.togglePopover({ force: false, source: element });
+            }
+            catch (e) {
+                // Do nothing. No exception should be thrown by these steps if the
+                // popover isn't in the expected state.
+            }
+            break;
+        case 'toggle-popover':
+            try {
+                commandTarget.togglePopover({ source: element });
+            }
+            catch (e) {
+                // Do nothing. No exception should be thrown by these steps if the
+                // popover isn't in the expected state.
+            }
+            break;
+        case 'show-popover':
+            try {
+                commandTarget.showPopover({ source: element });
+            }
+            catch (e) {
+                // Do nothing. No exception should be thrown by these steps if the
+                // popover isn't in the expected state.
+            }
+            break;
+        default:
+            // An element can have 'command steps', which are run if the element's
+            // command is not a popover command. Currently, only `<dialog>` defines
+            // 'command steps', so they're inlined here.
+            //
+            // https://whatpr.org/html/12011/popover.html#command-steps
+            // https://whatpr.org/html/12011/interactive-elements.html#the-dialog-element:command-steps
+            if (commandTarget.localName === 'dialog') {
+                const dialog = commandTarget;
+                if (dialog.matches(':popover-open')) {
+                    return;
+                }
+                switch (commandState) {
+                    case 'close':
+                        if (dialog.hasAttribute('open')) {
+                            dialog.close(element.getAttribute('value') ?? undefined);
+                        }
+                        break;
+                    case 'request-close':
+                        if (dialog.hasAttribute('open')) {
+                            dialog.requestClose(element.getAttribute('value') ?? undefined);
+                        }
+                        break;
+                    case 'show-modal':
+                        if (!dialog.hasAttribute('open')) {
+                            dialog.showModal();
+                        }
+                        break;
+                    default:
+                        // Do nothing.
+                        break;
+                }
+            }
+    }
+}
+/**
+ * Performs the 'popover target attribute activation behavior' for a button or
+ * menuitem.
+ *
+ * These steps are taken when a button or menuitem is activated, but doesn't
+ * target an element with a `command` attribute.
+ *
+ * https://whatpr.org/html/12011/popover.html#popover-target-attribute-activation-behavior
+ *
+ * @param element The button or menuitem being activated.
+ * @param eventTarget The target of the event that activated `element`.
+ */
+function popoverTargetAttributeActivationBehavior(element, eventTarget) {
+    const idref = element.getAttribute('popovertarget');
+    const popover = queryAssociatedById(element, idref ?? '');
+    if (!popover) {
+        return;
+    }
+    // TODO: The spec describes a case here that's relevant when the popover is
+    // nested inside its invoker itself, which would cause clicking anywhere in
+    // the popover to close the popover.
+    //
+    // https://github.com/whatwg/html/pull/10770
+    const open = popover.matches(':popover-open');
+    const action = getPopoverTargetActionState(element.getAttribute('popovertargetaction') ?? '');
+    if (!open && (action === 'show' || action === 'toggle')) {
+        try {
+            popover.showPopover({ source: element });
+        }
+        catch (e) {
+            // Do nothing. No exception should be thrown by these steps if the
+            // popover isn't in the expected state.
+        }
+    }
+    else if (open && (action === 'hide' || action === 'toggle')) {
+        try {
+            // Use `togglePopover` because `hidePopover` doesn't support `source`.
+            popover.togglePopover({ force: false, source: element });
+        }
+        catch (e) {
+            // Do nothing. No exception should be thrown by these steps if the
+            // popover isn't in the expected state.
+        }
+    }
+}
+//# sourceMappingURL=command.js.map

package/labs/aria/command.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"command.js","sourceRoot":"","sources":["command.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * @license\n * Copyright 2026 Google LLC\n * SPDX-License-Identifier: Apache-2.0\n */\n\n/// <reference types=\"../../types/command-event.d.ts\" />\n/// <reference types=\"../../types/popover.d.ts\" />\n\nimport {queryAssociatedById} from './query-associated.js';\n\n/**\n * An element's `command` attribute state: either one of a fixed set of commands\n * with spec-defined actions, `custom` (if it begins with `--`), or `unknown`.\n *\n * https://whatpr.org/html/12011/popover.html#attr-command\n */\ntype CommandState =\n  | 'toggle-popover'\n  | 'show-popover'\n  | 'hide-popover'\n  | 'close'\n  | 'request-close'\n  | 'show-modal'\n  | 'custom'\n  | 'unknown';\n\n/**\n * Determines an element's `command` attribute state, given the attribute value.\n */\nfunction getCommandState(attrValue: string | null): CommandState {\n  switch (attrValue) {\n    case 'toggle-popover':\n    case 'show-popover':\n    case 'hide-popover':\n    case 'close':\n    case 'request-close':\n    case 'show-modal':\n      return attrValue;\n    default:\n      return attrValue?.startsWith('--') ? 'custom' : 'unknown';\n  }\n}\n\n/**\n * An element's popover state, as determined by its type or `popover` attribute.\n *\n * https://whatpr.org/html/12011/popover.html#popover-state\n */\ntype PopoverState = 'auto' | 'manual' | 'hint' | 'no-popover';\n\n/** Determines the popover state of an element. */\nfunction getPopoverState(element: HTMLElement): PopoverState {\n  if (element.localName === 'md-aria-menulist') {\n    return 'auto';\n  }\n\n  const attrValue = element.getAttribute('popover');\n  switch (attrValue) {\n    case '':\n      return 'auto';\n    case 'auto':\n    case 'manual':\n    case 'hint':\n      return attrValue;\n    case null:\n    default:\n      return 'no-popover';\n  }\n}\n\n/**\n * An element's popover target action state: the action taken on the popover\n * referenced by the element's `popovertarget` attribute.\n *\n * https://whatpr.org/html/12011/popover.html#attr-popovertargetaction\n */\ntype PopoverTargetActionState = 'toggle' | 'show' | 'hide';\n\n/**\n * Determines the popover target action from an element's `popovertargetaction`\n * attribute value.\n */\nfunction getPopoverTargetActionState(\n  attrValue: string,\n): PopoverTargetActionState {\n  switch (attrValue) {\n    case 'toggle':\n    case 'show':\n    case 'hide':\n      return attrValue;\n    default:\n      return 'toggle';\n  }\n}\n\n/**\n * Performs the 'shared command invoker activation steps' for a button or\n * menuitem, to be called when that element is activated: either runs a command\n * (i.e. the element has `command` and `commandfor` attributes) or changes a\n * popover's state (i.e. the element has the `popovertarget` and possibly\n * `popovertargetaction` attributes).\n *\n * https://whatpr.org/html/12011/popover.html#shared-command-invoker-activation-steps\n *\n * @param element The button or menuitem being activated.\n * @param event The event that activated `element`.\n */\nexport function sharedCommandInvokerActivationSteps(\n  element: HTMLElement,\n  event: Event,\n) {\n  const idref = element.getAttribute('commandfor');\n  const commandTarget = queryAssociatedById(\n    element,\n    idref ?? '',\n  ) as HTMLElement | null;\n  if (!commandTarget) {\n    popoverTargetAttributeActivationBehavior(element, event.target as Node);\n    return;\n  }\n\n  const command = element.getAttribute('command');\n  const commandState = getCommandState(command);\n  if (commandState === 'unknown' || command === null) {\n    return;\n  }\n\n  const isPopover = getPopoverState(commandTarget) !== 'no-popover';\n  if (isPopover && commandState !== 'custom') {\n    // `<dialog>` is the only element that defines 'is valid command steps'.\n    if (\n      commandTarget.localName === 'dialog' &&\n      !['close', 'request-close', 'show-modal'].includes(commandState)\n    ) {\n      return;\n    }\n  }\n\n  const continueSteps = commandTarget.dispatchEvent(\n    new CommandEvent('command', {source: element, command, cancelable: true}),\n  );\n\n  if (\n    !continueSteps ||\n    !commandTarget.isConnected ||\n    commandState === 'custom'\n  ) {\n    return;\n  }\n\n  switch (command) {\n    case 'hide-popover':\n      try {\n        // Use `togglePopover` because `hidePopover` doesn't support `source`.\n        commandTarget.togglePopover({force: false, source: element});\n      } catch (e) {\n        // Do nothing. No exception should be thrown by these steps if the\n        // popover isn't in the expected state.\n      }\n      break;\n    case 'toggle-popover':\n      try {\n        commandTarget.togglePopover({source: element});\n      } catch (e) {\n        // Do nothing. No exception should be thrown by these steps if the\n        // popover isn't in the expected state.\n      }\n      break;\n    case 'show-popover':\n      try {\n        commandTarget.showPopover({source: element});\n      } catch (e) {\n        // Do nothing. No exception should be thrown by these steps if the\n        // popover isn't in the expected state.\n      }\n      break;\n    default:\n      // An element can have 'command steps', which are run if the element's\n      // command is not a popover command. Currently, only `<dialog>` defines\n      // 'command steps', so they're inlined here.\n      //\n      // https://whatpr.org/html/12011/popover.html#command-steps\n      // https://whatpr.org/html/12011/interactive-elements.html#the-dialog-element:command-steps\n      if (commandTarget.localName === 'dialog') {\n        const dialog = commandTarget as HTMLDialogElement;\n        if (dialog.matches(':popover-open')) {\n          return;\n        }\n\n        switch (commandState) {\n          case 'close':\n            if (dialog.hasAttribute('open')) {\n              dialog.close(element.getAttribute('value') ?? undefined);\n            }\n            break;\n          case 'request-close':\n            if (dialog.hasAttribute('open')) {\n              dialog.requestClose(element.getAttribute('value') ?? undefined);\n            }\n            break;\n          case 'show-modal':\n            if (!dialog.hasAttribute('open')) {\n              dialog.showModal();\n            }\n            break;\n          default:\n            // Do nothing.\n            break;\n        }\n      }\n  }\n}\n\n/**\n * Performs the 'popover target attribute activation behavior' for a button or\n * menuitem.\n *\n * These steps are taken when a button or menuitem is activated, but doesn't\n * target an element with a `command` attribute.\n *\n * https://whatpr.org/html/12011/popover.html#popover-target-attribute-activation-behavior\n *\n * @param element The button or menuitem being activated.\n * @param eventTarget The target of the event that activated `element`.\n */\nfunction popoverTargetAttributeActivationBehavior(\n  element: HTMLElement,\n  eventTarget: Node,\n) {\n  const idref = element.getAttribute('popovertarget');\n  const popover = queryAssociatedById(\n    element,\n    idref ?? '',\n  ) as HTMLElement | null;\n  if (!popover) {\n    return;\n  }\n\n  // TODO: The spec describes a case here that's relevant when the popover is\n  // nested inside its invoker itself, which would cause clicking anywhere in\n  // the popover to close the popover.\n  //\n  // https://github.com/whatwg/html/pull/10770\n\n  const open = popover.matches(':popover-open');\n  const action = getPopoverTargetActionState(\n    element.getAttribute('popovertargetaction') ?? '',\n  );\n  if (!open && (action === 'show' || action === 'toggle')) {\n    try {\n      popover.showPopover({source: element});\n    } catch (e) {\n      // Do nothing. No exception should be thrown by these steps if the\n      // popover isn't in the expected state.\n    }\n  } else if (open && (action === 'hide' || action === 'toggle')) {\n    try {\n      // Use `togglePopover` because `hidePopover` doesn't support `source`.\n      popover.togglePopover({force: false, source: element});\n    } catch (e) {\n      // Do nothing. No exception should be thrown by these steps if the\n      // popover isn't in the expected state.\n    }\n  }\n}\n"]}

package/labs/aria/menu/fieldset.d.ts

@@ -0,0 +1,36 @@
+/**
+ * @license
+ * Copyright 2026 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { CSSResultOrNative, LitElement } from 'lit';
+import { resetMenuitemCheckedness } from './internal.js';
+import type { AriaMenuitemElement } from './menuitem.js';
+declare const baseClass: import("../../behaviors/mixin.js").MixinReturn<typeof LitElement, import("../../behaviors/element-internals.js").WithElementInternals>;
+/** Possible values for `AriaFieldsetElement`'s `checkable` property. */
+export type CheckableState = 'single' | 'multiple' | null;
+/**
+ * An element implementing the proposed menu behavior of `<fieldset>`.
+ */
+export declare class AriaFieldsetElement extends baseClass {
+    static styles: CSSResultOrNative[];
+    private internalDisabled;
+    private internalCheckable;
+    private get items();
+    get disabled(): boolean;
+    set disabled(value: boolean);
+    get checkable(): CheckableState;
+    set checkable(value: CheckableState);
+    constructor();
+    render(): import("lit-html").TemplateResult<1>;
+    /**
+     * Unchecks every menuitem in this fieldset apart from the given one.
+     *
+     * `<md-aria-menuitem>` calls this on its cached ancestor fieldset when it
+     * becomes checked in a single-checkable fieldset.
+     *
+     * @param checkedItem The item to leave as-is, or null to uncheck every item.
+     */
+    [resetMenuitemCheckedness](checkedItem: AriaMenuitemElement | null): void;
+}
+export {};

package/labs/aria/menu/fieldset.js

@@ -0,0 +1,103 @@
+/**
+ * @license
+ * Copyright 2026 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { __decorate } from "tslib";
+import { LitElement, css, html } from 'lit';
+import { property } from 'lit/decorators.js';
+import { internals, mixinElementInternals, } from '../../behaviors/element-internals.js';
+import { resetMenuitemCheckedness, setCheckedness, updateUsedValues, } from './internal.js';
+import { sharedSlottedContentStyles } from './shared-slotted-content.js';
+const baseClass = mixinElementInternals(LitElement);
+/**
+ * An element implementing the proposed menu behavior of `<fieldset>`.
+ */
+export class AriaFieldsetElement extends baseClass {
+    get items() {
+        // This naively queries for these elements because this element doesn't need
+        // to support nested fieldsets yet.
+        return this.querySelectorAll('md-aria-menuitem');
+    }
+    get disabled() {
+        return this.internalDisabled;
+    }
+    set disabled(value) {
+        this.internalDisabled = value;
+        for (const item of this.items) {
+            // If this component is upgraded with `disabled` set in HTML,
+            // `<md-aria-menuitem>` children will not be upgraded at this point.
+            // These children will update themselves during `connectedCallback`.
+            item[updateUsedValues]?.();
+        }
+    }
+    get checkable() {
+        return this.internalCheckable;
+    }
+    set checkable(value) {
+        if (typeof value === 'string') {
+            const canonicalizedValue = value.toLowerCase();
+            if (canonicalizedValue === 'single' ||
+                canonicalizedValue === 'multiple') {
+                value = canonicalizedValue;
+            }
+            else {
+                value = 'multiple';
+            }
+        }
+        this.internalCheckable = value;
+        if (value === 'single') {
+            this[resetMenuitemCheckedness](null);
+        }
+        for (const item of this.items) {
+            // If this component is upgraded with `checkable` set in HTML,
+            // `<md-aria-menuitem>` children will not be upgraded at this point.
+            // These children will update themselves during `connectedCallback`.
+            item[updateUsedValues]?.();
+        }
+    }
+    constructor() {
+        super();
+        this.internalDisabled = false;
+        this.internalCheckable = null;
+        this[internals].role = 'group';
+    }
+    render() {
+        return html `<slot></slot>`;
+    }
+    /**
+     * Unchecks every menuitem in this fieldset apart from the given one.
+     *
+     * `<md-aria-menuitem>` calls this on its cached ancestor fieldset when it
+     * becomes checked in a single-checkable fieldset.
+     *
+     * @param checkedItem The item to leave as-is, or null to uncheck every item.
+     */
+    [resetMenuitemCheckedness](checkedItem) {
+        for (const item of this.items) {
+            if (item !== checkedItem) {
+                item[setCheckedness]?.(false);
+            }
+        }
+    }
+}
+AriaFieldsetElement.styles = [
+    sharedSlottedContentStyles,
+    css `
+      :host {
+        display: block;
+        margin-inline: 2px;
+        border: groove 2px ThreeDFace;
+        padding-block: 0.35em 0.625em;
+        padding-inline: 0.75em;
+        min-inline-size: min-content;
+      }
+    `,
+];
+__decorate([
+    property({ type: Boolean, reflect: true })
+], AriaFieldsetElement.prototype, "disabled", null);
+__decorate([
+    property({ type: String, reflect: true })
+], AriaFieldsetElement.prototype, "checkable", null);
+//# sourceMappingURL=fieldset.js.map

package/labs/aria/menu/fieldset.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fieldset.js","sourceRoot":"","sources":["fieldset.ts"],"names":[],"mappings":"AAAA;;;;GAIG;;AAEH,OAAO,EAAoB,UAAU,EAAE,GAAG,EAAE,IAAI,EAAC,MAAM,KAAK,CAAC;AAC7D,OAAO,EAAC,QAAQ,EAAC,MAAM,mBAAmB,CAAC;AAC3C,OAAO,EACL,SAAS,EACT,qBAAqB,GACtB,MAAM,sCAAsC,CAAC;AAC9C,OAAO,EACL,wBAAwB,EACxB,cAAc,EACd,gBAAgB,GACjB,MAAM,eAAe,CAAC;AAEvB,OAAO,EAAC,0BAA0B,EAAC,MAAM,6BAA6B,CAAC;AAEvE,MAAM,SAAS,GAAG,qBAAqB,CAAC,UAAU,CAAC,CAAC;AAMpD;;GAEG;AACH,MAAM,OAAO,mBAAoB,SAAQ,SAAS;IAkBhD,IAAY,KAAK;QACf,4EAA4E;QAC5E,mCAAmC;QACnC,OAAO,IAAI,CAAC,gBAAgB,CAAC,kBAAkB,CAAC,CAAC;IACnD,CAAC;IAGD,IAAI,QAAQ;QACV,OAAO,IAAI,CAAC,gBAAgB,CAAC;IAC/B,CAAC;IACD,IAAI,QAAQ,CAAC,KAAc;QACzB,IAAI,CAAC,gBAAgB,GAAG,KAAK,CAAC;QAC9B,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;YAC9B,6DAA6D;YAC7D,oEAAoE;YACpE,oEAAoE;YACpE,IAAI,CAAC,gBAAgB,CAAC,EAAE,EAAE,CAAC;QAC7B,CAAC;IACH,CAAC;IAGD,IAAI,SAAS;QACX,OAAO,IAAI,CAAC,iBAAiB,CAAC;IAChC,CAAC;IACD,IAAI,SAAS,CAAC,KAAqB;QACjC,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;YAC9B,MAAM,kBAAkB,GAAG,KAAK,CAAC,WAAW,EAAE,CAAC;YAC/C,IACE,kBAAkB,KAAK,QAAQ;gBAC/B,kBAAkB,KAAK,UAAU,EACjC,CAAC;gBACD,KAAK,GAAG,kBAAkB,CAAC;YAC7B,CAAC;iBAAM,CAAC;gBACN,KAAK,GAAG,UAAU,CAAC;YACrB,CAAC;QACH,CAAC;QAED,IAAI,CAAC,iBAAiB,GAAG,KAAK,CAAC;QAE/B,IAAI,KAAK,KAAK,QAAQ,EAAE,CAAC;YACvB,IAAI,CAAC,wBAAwB,CAAC,CAAC,IAAI,CAAC,CAAC;QACvC,CAAC;QAED,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;YAC9B,8DAA8D;YAC9D,oEAAoE;YACpE,oEAAoE;YACpE,IAAI,CAAC,gBAAgB,CAAC,EAAE,EAAE,CAAC;QAC7B,CAAC;IACH,CAAC;IAED;QACE,KAAK,EAAE,CAAC;QAvDF,qBAAgB,GAAG,KAAK,CAAC;QACzB,sBAAiB,GAAmB,IAAI,CAAC;QAuD/C,IAAI,CAAC,SAAS,CAAC,CAAC,IAAI,GAAG,OAAO,CAAC;IACjC,CAAC;IAEQ,MAAM;QACb,OAAO,IAAI,CAAA,eAAe,CAAC;IAC7B,CAAC;IAED;;;;;;;OAOG;IACH,CAAC,wBAAwB,CAAC,CAAC,WAAuC;QAChE,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;YAC9B,IAAI,IAAI,KAAK,WAAW,EAAE,CAAC;gBACzB,IAAI,CAAC,cAAc,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC;YAChC,CAAC;QACH,CAAC;IACH,CAAC;;AA3Fe,0BAAM,GAAwB;IAC5C,0BAA0B;IAC1B,GAAG,CAAA;;;;;;;;;KASF;CACF,AAZqB,CAYpB;AAYF;IADC,QAAQ,CAAC,EAAC,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,IAAI,EAAC,CAAC;mDAGxC;AAYD;IADC,QAAQ,CAAC,EAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,IAAI,EAAC,CAAC;oDAGvC","sourcesContent":["/**\n * @license\n * Copyright 2026 Google LLC\n * SPDX-License-Identifier: Apache-2.0\n */\n\nimport {CSSResultOrNative, LitElement, css, html} from 'lit';\nimport {property} from 'lit/decorators.js';\nimport {\n  internals,\n  mixinElementInternals,\n} from '../../behaviors/element-internals.js';\nimport {\n  resetMenuitemCheckedness,\n  setCheckedness,\n  updateUsedValues,\n} from './internal.js';\nimport type {AriaMenuitemElement} from './menuitem.js';\nimport {sharedSlottedContentStyles} from './shared-slotted-content.js';\n\nconst baseClass = mixinElementInternals(LitElement);\n\n/** Possible values for `AriaFieldsetElement`'s `checkable` property. */\n// tslint:disable-next-line:no-undefined-type-alias Defined by proposed spec\nexport type CheckableState = 'single' | 'multiple' | null;\n\n/**\n * An element implementing the proposed menu behavior of `<fieldset>`.\n */\nexport class AriaFieldsetElement extends baseClass {\n  static override styles: CSSResultOrNative[] = [\n    sharedSlottedContentStyles,\n    css`\n      :host {\n        display: block;\n        margin-inline: 2px;\n        border: groove 2px ThreeDFace;\n        padding-block: 0.35em 0.625em;\n        padding-inline: 0.75em;\n        min-inline-size: min-content;\n      }\n    `,\n  ];\n\n  private internalDisabled = false;\n  private internalCheckable: CheckableState = null;\n\n  private get items(): Iterable<AriaMenuitemElement> {\n    // This naively queries for these elements because this element doesn't need\n    // to support nested fieldsets yet.\n    return this.querySelectorAll('md-aria-menuitem');\n  }\n\n  @property({type: Boolean, reflect: true})\n  get disabled(): boolean {\n    return this.internalDisabled;\n  }\n  set disabled(value: boolean) {\n    this.internalDisabled = value;\n    for (const item of this.items) {\n      // If this component is upgraded with `disabled` set in HTML,\n      // `<md-aria-menuitem>` children will not be upgraded at this point.\n      // These children will update themselves during `connectedCallback`.\n      item[updateUsedValues]?.();\n    }\n  }\n\n  @property({type: String, reflect: true})\n  get checkable(): CheckableState {\n    return this.internalCheckable;\n  }\n  set checkable(value: CheckableState) {\n    if (typeof value === 'string') {\n      const canonicalizedValue = value.toLowerCase();\n      if (\n        canonicalizedValue === 'single' ||\n        canonicalizedValue === 'multiple'\n      ) {\n        value = canonicalizedValue;\n      } else {\n        value = 'multiple';\n      }\n    }\n\n    this.internalCheckable = value;\n\n    if (value === 'single') {\n      this[resetMenuitemCheckedness](null);\n    }\n\n    for (const item of this.items) {\n      // If this component is upgraded with `checkable` set in HTML,\n      // `<md-aria-menuitem>` children will not be upgraded at this point.\n      // These children will update themselves during `connectedCallback`.\n      item[updateUsedValues]?.();\n    }\n  }\n\n  constructor() {\n    super();\n    this[internals].role = 'group';\n  }\n\n  override render() {\n    return html`<slot></slot>`;\n  }\n\n  /**\n   * Unchecks every menuitem in this fieldset apart from the given one.\n   *\n   * `<md-aria-menuitem>` calls this on its cached ancestor fieldset when it\n   * becomes checked in a single-checkable fieldset.\n   *\n   * @param checkedItem The item to leave as-is, or null to uncheck every item.\n   */\n  [resetMenuitemCheckedness](checkedItem: AriaMenuitemElement | null) {\n    for (const item of this.items) {\n      if (item !== checkedItem) {\n        item[setCheckedness]?.(false);\n      }\n    }\n  }\n}\n"]}

package/labs/aria/menu/internal.d.ts

@@ -0,0 +1,15 @@
+/**
+ * @license
+ * Copyright 2026 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+/**
+ * @fileoverview Unique symbols for members that the menu elements share with
+ * each other but that are not part of any of their public APIs.
+ */
+/** Defined by `AriaMenuitemElement`. */
+export declare const updateUsedValues: unique symbol;
+/** Defined by `AriaMenuitemElement`. */
+export declare const setCheckedness: unique symbol;
+/** Defined by `AriaFieldsetElement`. */
+export declare const resetMenuitemCheckedness: unique symbol;

package/labs/aria/menu/internal.js

@@ -0,0 +1,16 @@
+/**
+ * @license
+ * Copyright 2026 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+/**
+ * @fileoverview Unique symbols for members that the menu elements share with
+ * each other but that are not part of any of their public APIs.
+ */
+/** Defined by `AriaMenuitemElement`. */
+export const updateUsedValues = Symbol('updateUsedValues');
+/** Defined by `AriaMenuitemElement`. */
+export const setCheckedness = Symbol('setCheckedness');
+/** Defined by `AriaFieldsetElement`. */
+export const resetMenuitemCheckedness = Symbol('resetMenuitemCheckedness');
+//# sourceMappingURL=internal.js.map

package/labs/aria/menu/internal.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"internal.js","sourceRoot":"","sources":["internal.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;;GAGG;AAEH,wCAAwC;AACxC,MAAM,CAAC,MAAM,gBAAgB,GAAG,MAAM,CAAC,kBAAkB,CAAC,CAAC;AAE3D,wCAAwC;AACxC,MAAM,CAAC,MAAM,cAAc,GAAG,MAAM,CAAC,gBAAgB,CAAC,CAAC;AAEvD,wCAAwC;AACxC,MAAM,CAAC,MAAM,wBAAwB,GAAG,MAAM,CAAC,0BAA0B,CAAC,CAAC","sourcesContent":["/**\n * @license\n * Copyright 2026 Google LLC\n * SPDX-License-Identifier: Apache-2.0\n */\n\n/**\n * @fileoverview Unique symbols for members that the menu elements share with\n * each other but that are not part of any of their public APIs.\n */\n\n/** Defined by `AriaMenuitemElement`. */\nexport const updateUsedValues = Symbol('updateUsedValues');\n\n/** Defined by `AriaMenuitemElement`. */\nexport const setCheckedness = Symbol('setCheckedness');\n\n/** Defined by `AriaFieldsetElement`. */\nexport const resetMenuitemCheckedness = Symbol('resetMenuitemCheckedness');\n"]}

package/labs/aria/menu/md-aria-fieldset.d.ts

@@ -0,0 +1,11 @@
+/**
+ * @license
+ * Copyright 2026 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { AriaFieldsetElement } from './fieldset.js';
+declare global {
+    interface HTMLElementTagNameMap {
+        'md-aria-fieldset': AriaFieldsetElement;
+    }
+}

package/labs/aria/menu/md-aria-fieldset.js

@@ -0,0 +1,8 @@
+/**
+ * @license
+ * Copyright 2026 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { AriaFieldsetElement } from './fieldset.js';
+customElements.define('md-aria-fieldset', AriaFieldsetElement);
+//# sourceMappingURL=md-aria-fieldset.js.map

package/labs/aria/menu/md-aria-fieldset.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"md-aria-fieldset.js","sourceRoot":"","sources":["md-aria-fieldset.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAC,mBAAmB,EAAC,MAAM,eAAe,CAAC;AAQlD,cAAc,CAAC,MAAM,CAAC,kBAAkB,EAAE,mBAAmB,CAAC,CAAC","sourcesContent":["/**\n * @license\n * Copyright 2026 Google LLC\n * SPDX-License-Identifier: Apache-2.0\n */\n\nimport {AriaFieldsetElement} from './fieldset.js';\n\ndeclare global {\n  interface HTMLElementTagNameMap {\n    'md-aria-fieldset': AriaFieldsetElement;\n  }\n}\n\ncustomElements.define('md-aria-fieldset', AriaFieldsetElement);\n"]}

package/labs/aria/menu/md-aria-menuitem.d.ts

@@ -0,0 +1,11 @@
+/**
+ * @license
+ * Copyright 2026 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { AriaMenuitemElement } from './menuitem.js';
+declare global {
+    interface HTMLElementTagNameMap {
+        'md-aria-menuitem': AriaMenuitemElement;
+    }
+}

package/labs/aria/menu/md-aria-menuitem.js

@@ -0,0 +1,8 @@
+/**
+ * @license
+ * Copyright 2026 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { AriaMenuitemElement } from './menuitem.js';
+customElements.define('md-aria-menuitem', AriaMenuitemElement);
+//# sourceMappingURL=md-aria-menuitem.js.map

package/labs/aria/menu/md-aria-menuitem.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"md-aria-menuitem.js","sourceRoot":"","sources":["md-aria-menuitem.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAC,mBAAmB,EAAC,MAAM,eAAe,CAAC;AAQlD,cAAc,CAAC,MAAM,CAAC,kBAAkB,EAAE,mBAAmB,CAAC,CAAC","sourcesContent":["/**\n * @license\n * Copyright 2026 Google LLC\n * SPDX-License-Identifier: Apache-2.0\n */\n\nimport {AriaMenuitemElement} from './menuitem.js';\n\ndeclare global {\n  interface HTMLElementTagNameMap {\n    'md-aria-menuitem': AriaMenuitemElement;\n  }\n}\n\ncustomElements.define('md-aria-menuitem', AriaMenuitemElement);\n"]}

package/labs/aria/menu/md-aria-menulist.d.ts

@@ -0,0 +1,11 @@
+/**
+ * @license
+ * Copyright 2026 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { AriaMenulistElement } from './menulist.js';
+declare global {
+    interface HTMLElementTagNameMap {
+        'md-aria-menulist': AriaMenulistElement;
+    }
+}

package/labs/aria/menu/md-aria-menulist.js

@@ -0,0 +1,8 @@
+/**
+ * @license
+ * Copyright 2026 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { AriaMenulistElement } from './menulist.js';
+customElements.define('md-aria-menulist', AriaMenulistElement);
+//# sourceMappingURL=md-aria-menulist.js.map

package/labs/aria/menu/md-aria-menulist.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"md-aria-menulist.js","sourceRoot":"","sources":["md-aria-menulist.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAC,mBAAmB,EAAC,MAAM,eAAe,CAAC;AAQlD,cAAc,CAAC,MAAM,CAAC,kBAAkB,EAAE,mBAAmB,CAAC,CAAC","sourcesContent":["/**\n * @license\n * Copyright 2026 Google LLC\n * SPDX-License-Identifier: Apache-2.0\n */\n\nimport {AriaMenulistElement} from './menulist.js';\n\ndeclare global {\n  interface HTMLElementTagNameMap {\n    'md-aria-menulist': AriaMenulistElement;\n  }\n}\n\ncustomElements.define('md-aria-menulist', AriaMenulistElement);\n"]}

package/labs/aria/menu/menuitem.d.ts

@@ -0,0 +1,59 @@
+/**
+ * @license
+ * Copyright 2026 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { CSSResultOrNative, LitElement } from 'lit';
+import { setCheckedness, updateUsedValues } from './internal.js';
+declare const baseClass: import("../../behaviors/mixin.js").MixinReturn<import("../../behaviors/mixin.js").MixinReturn<import("../../behaviors/mixin.js").MixinReturn<typeof LitElement, import("../../behaviors/element-internals.js").WithElementInternals>, import("../../behaviors/focusable.js").Focusable>, import("../../behaviors/custom-state-set.js").WithCustomStateSet>;
+/**
+ * An element implementing the proposed `<menuitem>` built-in element.
+ *
+ * @fires {Event} checked - Fired when the item is checked or unchecked.
+ * @cssstate enabled - True when the item is enabled.
+ * @cssstate disabled - True when the item is disabled.
+ * @cssstate checked - True when the item is checked.
+ */
+export declare class AriaMenuitemElement extends baseClass {
+    static styles: CSSResultOrNative[];
+    private internalDisabled;
+    private checkedness;
+    private dirtyCheckedness;
+    private internalDefaultChecked;
+    private cachedAncestorMenulist;
+    private cachedAncestorFieldset;
+    private get usedCheckable();
+    private get usedDisabled();
+    /**
+     * Recomputes this element's used `disabled` and `checkable` values and
+     * projects them onto its ARIA attributes and custom states.
+     *
+     * `<md-aria-fieldset>` calls this on its items when a value they inherit from
+     * it changes.
+     */
+    [updateUsedValues](): void;
+    private resetAncestorElementCache;
+    /**
+     * Sets this element's checkedness directly, without running the rest of the
+     * 'check a menuitem element' steps.
+     *
+     * `<md-aria-fieldset>` calls this to reset the items excluded by a newly
+     * checked item.
+     *
+     * @param value The new checkedness.
+     */
+    [setCheckedness](value: boolean): void;
+    private checkAMenuitemElement;
+    get disabled(): boolean;
+    set disabled(value: boolean);
+    get checked(): boolean;
+    set checked(value: boolean);
+    get defaultChecked(): boolean;
+    set defaultChecked(value: boolean);
+    constructor();
+    render(): import("lit-html").TemplateResult<1>;
+    connectedCallback(): void;
+    disconnectedCallback(): void;
+    click(): void;
+}
+export {};