@spectrum-web-components/menu 0.0.0-20241209155954

package/README.md

@@ -0,0 +1,164 @@
+## Description
+
+An `<sp-menu>` is used for creating a menu list. The various elements inside a menu are given as `<sp-menu-group>`, `<sp-menu-item>`, or `<sp-menu-divider>`. Often a `<sp-menu>` element will appear in a `<sp-popover>` element so that it displays as a togglig menu.
+
+### Usage
+
+[![See it on NPM!](https://img.shields.io/npm/v/@spectrum-web-components/menu?style=for-the-badge)](https://www.npmjs.com/package/@spectrum-web-components/menu)
+[![How big is this package in your project?](https://img.shields.io/bundlephobia/minzip/@spectrum-web-components/menu?style=for-the-badge)](https://bundlephobia.com/result?p=@spectrum-web-components/menu)
+[![Try it on webcomponents.dev](https://img.shields.io/badge/Try%20it%20on-webcomponents.dev-green?style=for-the-badge)](https://webcomponents.dev/edit/collection/fO75441E1Q5ZlI0e9pgq/FikFeTXNsYhxAVmCz2f4/src/index.ts)
+
+```
+yarn add @spectrum-web-components/menu
+```
+
+Import the side effectful registration of `<sp-menu>`, `<sp-menu-group>`, `<sp-menu-item>`, or `<sp-menu-divider>` individually as follows:
+
+```
+import '@spectrum-web-components/menu/sp-menu.js';
+import '@spectrum-web-components/menu/sp-menu-group.js';
+import '@spectrum-web-components/menu/sp-menu-item.js';
+import '@spectrum-web-components/menu/sp-menu-divider.js';
+```
+
+When looking to leverage the `Menu`, `MenuGroup`, `MenuItem`, or `MenuDivider` base classes as a type and/or for extension purposes, do so via:
+
+```
+import {
+    Menu,
+    MenuGroup,
+    MenuItem,
+    MenuDivider
+} from '@spectrum-web-components/menu';
+```
+
+## Example
+
+<!-- prettier-ignore -->
+```html
+<sp-menu>
+    <sp-menu-item>
+        Deselect
+    </sp-menu-item>
+    <sp-menu-item>
+        Select inverse
+    </sp-menu-item>
+    <sp-menu-item>
+        Feather...
+    </sp-menu-item>
+    <sp-menu-item>
+        Select and mask...
+    </sp-menu-item>
+    <sp-menu-item>
+        Save selection
+    </sp-menu-item>
+    <sp-menu-item disabled>
+        Make work path
+    </sp-menu-item>
+</sp-menu>
+```
+
+Often an `<sp-menu>` element will be delivered inside of an `<sp-popover>` element when displaying it above other content.
+
+```html
+<sp-popover open style="position: relative">
+    <sp-menu>
+        <sp-menu-item value="item-1">Deselect</sp-menu-item>
+        <sp-menu-item value="item-2">Select inverse</sp-menu-item>
+        <sp-menu-item value="item-3">Feather...</sp-menu-item>
+        <sp-menu-item value="item-4">Select and mask...</sp-menu-item>
+        <sp-menu-item value="item-5">Save selection</sp-menu-item>
+        <sp-menu-item value="item-6" disabled>Make work path</sp-menu-item>
+    </sp-menu>
+</sp-popover>
+```
+
+## Managing a selection
+
+The `<sp-menu>` element can be instructed to maintain a selection via the `selects` attribute. Depending on the chosen algorithm, the `<sp-menu>` element will hold a `value` property and manage the `selected` state of its `<sp-menu-item>` descendants.
+
+### selects="single"
+
+When `selects` is set to `single`, the `<sp-menu>` element will maintain one selected item after an initial selection is made.
+
+```html
+<p>
+    The value of the `&lt;sp-menu&gt;` element is:
+    <span id="single-value"></span>
+</p>
+<sp-menu
+    label="Choose a shape"
+    selects="single"
+    onchange="this.previousElementSibling.querySelector('#single-value').textContent=this.value"
+>
+    <sp-menu-item value="item-1">Square</sp-menu-item>
+    <sp-menu-item value="item-2">Triangle</sp-menu-item>
+    <sp-menu-item value="item-3">Parallelogram</sp-menu-item>
+    <sp-menu-item value="item-4">Star</sp-menu-item>
+    <sp-menu-item value="item-5">Hexagon</sp-menu-item>
+    <sp-menu-item value="item-6" disabled>Circle</sp-menu-item>
+</sp-menu>
+```
+
+### selects="multiple"
+
+When `selects` is set to `multiple`, the `<sp-menu>` element will maintain zero or more selected items.
+
+```html
+<p>
+    The value of the `&lt;sp-menu&gt;` element is:
+    <span id="multiple-value">item-3,item-4</span>
+</p>
+<sp-menu
+    label="Choose some fruit"
+    selects="multiple"
+    onchange="this.previousElementSibling.querySelector('#multiple-value').textContent=this.value"
+>
+    <sp-menu-item value="item-1">Apple</sp-menu-item>
+    <sp-menu-item value="item-2">Banana</sp-menu-item>
+    <sp-menu-item value="item-3" selected>Goji berry</sp-menu-item>
+    <sp-menu-item value="item-4" selected>Grapes</sp-menu-item>
+    <sp-menu-item value="item-5" disabled>Kumquat</sp-menu-item>
+    <sp-menu-item value="item-6">Orange</sp-menu-item>
+</sp-menu>
+```
+
+### selects="inherit"
+
+When `selects` is set to `inherit`, the `<sp-menu>` element will allow its `<sp-menu-item>` children to participate in the selection of its nearest `<sp-menu>` ancestor.
+
+```html
+<p>
+    The value of the `&lt;sp-menu&gt;` element is:
+    <span id="inherit-value">item-3 || item-4 || item-8 || item-11</span>
+</p>
+<sp-menu
+    label="Choose some groceries"
+    selects="multiple"
+    value-separator=" || "
+    onchange="this.previousElementSibling.querySelector('#inherit-value').textContent=this.value"
+>
+    <sp-menu label="Fruit" selects="inherit">
+        <sp-menu-item value="item-1">Apple</sp-menu-item>
+        <sp-menu-item value="item-2">Banana</sp-menu-item>
+        <sp-menu-item value="item-3" selected>Goji berry</sp-menu-item>
+        <sp-menu-item value="item-4" selected>Grapes</sp-menu-item>
+        <sp-menu-item value="item-5" disabled>Kumquat</sp-menu-item>
+        <sp-menu-item value="item-6">Orange</sp-menu-item>
+    </sp-menu>
+    <sp-menu label="Vegetables" selects="inherit">
+        <sp-menu-item value="item-7">Carrot</sp-menu-item>
+        <sp-menu-item value="item-8" selected>Garlic</sp-menu-item>
+        <sp-menu-item value="item-9" disabled>Lettuce</sp-menu-item>
+        <sp-menu-item value="item-10">Onion</sp-menu-item>
+        <sp-menu-item value="item-11" selected>Potato</sp-menu-item>
+        <sp-menu-item value="item-12">Tomato</sp-menu-item>
+    </sp-menu>
+</sp-menu>
+```
+
+## "change" event
+
+Whether `<sp-menu>` carries a selection or not, when one of the `<sp-menu-item>` children that it manages is activated the `<sp-menu>` element will dispatch a `change` event. At dispatch time, even when a selection is not held due to the absence of the `selects` attribute, the `value` of the `<sp-menu>` will correspond to the `<sp-menu-item>` that was activated. When the `selects` attribute is present, this `value` will be persisted beyond the lifecycle of the `change` event. When `selects="multiple"` the values of multiple items will be comma separated unless otherwise set via the `value-separator` attribute.
+
+Note: The `change` event is only dispatched on a left mouse click or Enter/Space keypress. Right/Middle mouse clicks will not dispatch the `change` event.

package/package.json

@@ -0,0 +1,112 @@
+{
+    "name": "@spectrum-web-components/menu",
+    "version": "0.0.0-20241209155954",
+    "publishConfig": {
+        "access": "public"
+    },
+    "description": "",
+    "license": "Apache-2.0",
+    "repository": {
+        "type": "git",
+        "url": "https://github.com/adobe/spectrum-web-components.git",
+        "directory": "packages/menu"
+    },
+    "author": "",
+    "homepage": "https://opensource.adobe.com/spectrum-web-components/components/menu",
+    "bugs": {
+        "url": "https://github.com/adobe/spectrum-web-components/issues"
+    },
+    "main": "./src/index.js",
+    "module": "./src/index.js",
+    "type": "module",
+    "exports": {
+        ".": {
+            "development": "./src/index.dev.js",
+            "default": "./src/index.js"
+        },
+        "./package.json": "./package.json",
+        "./src/Menu.js": {
+            "development": "./src/Menu.dev.js",
+            "default": "./src/Menu.js"
+        },
+        "./src/MenuDivider.js": {
+            "development": "./src/MenuDivider.dev.js",
+            "default": "./src/MenuDivider.js"
+        },
+        "./src/MenuGroup.js": {
+            "development": "./src/MenuGroup.dev.js",
+            "default": "./src/MenuGroup.js"
+        },
+        "./src/MenuItem.js": {
+            "development": "./src/MenuItem.dev.js",
+            "default": "./src/MenuItem.js"
+        },
+        "./src/checkmark-overrides.css.js": "./src/checkmark-overrides.css.js",
+        "./src/chevron-overrides.css.js": "./src/chevron-overrides.css.js",
+        "./src/index.js": {
+            "development": "./src/index.dev.js",
+            "default": "./src/index.js"
+        },
+        "./src/menu-divider-overrides.css.js": "./src/menu-divider-overrides.css.js",
+        "./src/menu-divider.css.js": "./src/menu-divider.css.js",
+        "./src/menu-group.css.js": "./src/menu-group.css.js",
+        "./src/menu-item-overrides.css.js": "./src/menu-item-overrides.css.js",
+        "./src/menu-item.css.js": "./src/menu-item.css.js",
+        "./src/menu-overrides.css.js": "./src/menu-overrides.css.js",
+        "./src/menu.css.js": "./src/menu.css.js",
+        "./sp-menu.js": {
+            "development": "./sp-menu.dev.js",
+            "default": "./sp-menu.js"
+        },
+        "./sp-menu-divider.js": {
+            "development": "./sp-menu-divider.dev.js",
+            "default": "./sp-menu-divider.js"
+        },
+        "./sp-menu-group.js": {
+            "development": "./sp-menu-group.dev.js",
+            "default": "./sp-menu-group.js"
+        },
+        "./sp-menu-item.js": {
+            "development": "./sp-menu-item.dev.js",
+            "default": "./sp-menu-item.js"
+        }
+    },
+    "scripts": {
+        "test": "echo \"Error: run tests from mono-repo root.\" && exit 1"
+    },
+    "files": [
+        "**/*.d.ts",
+        "**/*.js",
+        "**/*.js.map",
+        "custom-elements.json",
+        "!stories/",
+        "!test/"
+    ],
+    "keywords": [
+        "spectrum css",
+        "web components",
+        "lit-element",
+        "lit-html"
+    ],
+    "dependencies": {
+        "@lit-labs/observers": "^2.0.2",
+        "@spectrum-web-components/action-button": "0.0.0-20241209155954",
+        "@spectrum-web-components/base": "0.0.0-20241209155954",
+        "@spectrum-web-components/divider": "0.0.0-20241209155954",
+        "@spectrum-web-components/icon": "0.0.0-20241209155954",
+        "@spectrum-web-components/icons-ui": "0.0.0-20241209155954",
+        "@spectrum-web-components/overlay": "0.0.0-20241209155954",
+        "@spectrum-web-components/popover": "0.0.0-20241209155954",
+        "@spectrum-web-components/reactive-controllers": "0.0.0-20241209155954",
+        "@spectrum-web-components/shared": "0.0.0-20241209155954"
+    },
+    "devDependencies": {
+        "@spectrum-css/menu": "^8.0.0-s2-foundations.16"
+    },
+    "types": "./src/index.d.ts",
+    "customElements": "custom-elements.json",
+    "sideEffects": [
+        "./sp-*.js",
+        "./**/*.dev.js"
+    ]
+}

package/sp-menu-divider.d.ts

@@ -0,0 +1,6 @@
+import { MenuDivider } from './src/MenuDivider.js';
+declare global {
+    interface HTMLElementTagNameMap {
+        'sp-menu-divider': MenuDivider;
+    }
+}

package/sp-menu-divider.dev.js

@@ -0,0 +1,5 @@
+"use strict";
+import { MenuDivider } from "./src/MenuDivider.dev.js";
+import { defineElement } from "@spectrum-web-components/base/src/define-element.js";
+defineElement("sp-menu-divider", MenuDivider);
+//# sourceMappingURL=sp-menu-divider.dev.js.map

package/sp-menu-divider.dev.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["sp-menu-divider.ts"],
+  "sourcesContent": ["/*\nCopyright 2020 Adobe. All rights reserved.\nThis file is licensed to you under the Apache License, Version 2.0 (the \"License\");\nyou may not use this file except in compliance with the License. You may obtain a copy\nof the License at http://www.apache.org/licenses/LICENSE-2.0\n\nUnless required by applicable law or agreed to in writing, software distributed under\nthe License is distributed on an \"AS IS\" BASIS, WITHOUT WARRANTIES OR REPRESENTATIONS\nOF ANY KIND, either express or implied. See the License for the specific language\ngoverning permissions and limitations under the License.\n*/\nimport { MenuDivider } from './src/MenuDivider.dev.js'\nimport { defineElement } from '@spectrum-web-components/base/src/define-element.js';\n\ndefineElement('sp-menu-divider', MenuDivider);\n\ndeclare global {\n    interface HTMLElementTagNameMap {\n        'sp-menu-divider': MenuDivider;\n    }\n}\n"],
+  "mappings": ";AAWA,SAAS,mBAAmB;AAC5B,SAAS,qBAAqB;AAE9B,cAAc,mBAAmB,WAAW;",
+  "names": []
+}

package/sp-menu-divider.js

@@ -0,0 +1,2 @@
+"use strict";import{MenuDivider as e}from"./src/MenuDivider.js";import{defineElement as i}from"@spectrum-web-components/base/src/define-element.js";i("sp-menu-divider",e);
+//# sourceMappingURL=sp-menu-divider.js.map

package/sp-menu-divider.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["sp-menu-divider.ts"],
+  "sourcesContent": ["/*\nCopyright 2020 Adobe. All rights reserved.\nThis file is licensed to you under the Apache License, Version 2.0 (the \"License\");\nyou may not use this file except in compliance with the License. You may obtain a copy\nof the License at http://www.apache.org/licenses/LICENSE-2.0\n\nUnless required by applicable law or agreed to in writing, software distributed under\nthe License is distributed on an \"AS IS\" BASIS, WITHOUT WARRANTIES OR REPRESENTATIONS\nOF ANY KIND, either express or implied. See the License for the specific language\ngoverning permissions and limitations under the License.\n*/\nimport { MenuDivider } from './src/MenuDivider.js';\nimport { defineElement } from '@spectrum-web-components/base/src/define-element.js';\n\ndefineElement('sp-menu-divider', MenuDivider);\n\ndeclare global {\n    interface HTMLElementTagNameMap {\n        'sp-menu-divider': MenuDivider;\n    }\n}\n"],
+  "mappings": "aAWA,OAAS,eAAAA,MAAmB,uBAC5B,OAAS,iBAAAC,MAAqB,sDAE9BA,EAAc,kBAAmBD,CAAW",
+  "names": ["MenuDivider", "defineElement"]
+}

package/sp-menu-group.d.ts

@@ -0,0 +1,6 @@
+import { MenuGroup } from './src/MenuGroup.js';
+declare global {
+    interface HTMLElementTagNameMap {
+        'sp-menu-group': MenuGroup;
+    }
+}

package/sp-menu-group.dev.js

@@ -0,0 +1,5 @@
+"use strict";
+import { MenuGroup } from "./src/MenuGroup.dev.js";
+import { defineElement } from "@spectrum-web-components/base/src/define-element.js";
+defineElement("sp-menu-group", MenuGroup);
+//# sourceMappingURL=sp-menu-group.dev.js.map

package/sp-menu-group.dev.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["sp-menu-group.ts"],
+  "sourcesContent": ["/*\nCopyright 2020 Adobe. All rights reserved.\nThis file is licensed to you under the Apache License, Version 2.0 (the \"License\");\nyou may not use this file except in compliance with the License. You may obtain a copy\nof the License at http://www.apache.org/licenses/LICENSE-2.0\n\nUnless required by applicable law or agreed to in writing, software distributed under\nthe License is distributed on an \"AS IS\" BASIS, WITHOUT WARRANTIES OR REPRESENTATIONS\nOF ANY KIND, either express or implied. See the License for the specific language\ngoverning permissions and limitations under the License.\n*/\nimport { MenuGroup } from './src/MenuGroup.dev.js'\nimport { defineElement } from '@spectrum-web-components/base/src/define-element.js';\n\ndefineElement('sp-menu-group', MenuGroup);\n\ndeclare global {\n    interface HTMLElementTagNameMap {\n        'sp-menu-group': MenuGroup;\n    }\n}\n"],
+  "mappings": ";AAWA,SAAS,iBAAiB;AAC1B,SAAS,qBAAqB;AAE9B,cAAc,iBAAiB,SAAS;",
+  "names": []
+}

package/sp-menu-group.js

@@ -0,0 +1,2 @@
+"use strict";import{MenuGroup as e}from"./src/MenuGroup.js";import{defineElement as r}from"@spectrum-web-components/base/src/define-element.js";r("sp-menu-group",e);
+//# sourceMappingURL=sp-menu-group.js.map

package/sp-menu-group.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["sp-menu-group.ts"],
+  "sourcesContent": ["/*\nCopyright 2020 Adobe. All rights reserved.\nThis file is licensed to you under the Apache License, Version 2.0 (the \"License\");\nyou may not use this file except in compliance with the License. You may obtain a copy\nof the License at http://www.apache.org/licenses/LICENSE-2.0\n\nUnless required by applicable law or agreed to in writing, software distributed under\nthe License is distributed on an \"AS IS\" BASIS, WITHOUT WARRANTIES OR REPRESENTATIONS\nOF ANY KIND, either express or implied. See the License for the specific language\ngoverning permissions and limitations under the License.\n*/\nimport { MenuGroup } from './src/MenuGroup.js';\nimport { defineElement } from '@spectrum-web-components/base/src/define-element.js';\n\ndefineElement('sp-menu-group', MenuGroup);\n\ndeclare global {\n    interface HTMLElementTagNameMap {\n        'sp-menu-group': MenuGroup;\n    }\n}\n"],
+  "mappings": "aAWA,OAAS,aAAAA,MAAiB,qBAC1B,OAAS,iBAAAC,MAAqB,sDAE9BA,EAAc,gBAAiBD,CAAS",
+  "names": ["MenuGroup", "defineElement"]
+}

package/sp-menu-item.d.ts

@@ -0,0 +1,6 @@
+import { MenuItem } from './src/MenuItem.js';
+declare global {
+    interface HTMLElementTagNameMap {
+        'sp-menu-item': MenuItem;
+    }
+}

package/sp-menu-item.dev.js

@@ -0,0 +1,5 @@
+"use strict";
+import { MenuItem } from "./src/MenuItem.dev.js";
+import { defineElement } from "@spectrum-web-components/base/src/define-element.js";
+defineElement("sp-menu-item", MenuItem);
+//# sourceMappingURL=sp-menu-item.dev.js.map

package/sp-menu-item.dev.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["sp-menu-item.ts"],
+  "sourcesContent": ["/*\nCopyright 2020 Adobe. All rights reserved.\nThis file is licensed to you under the Apache License, Version 2.0 (the \"License\");\nyou may not use this file except in compliance with the License. You may obtain a copy\nof the License at http://www.apache.org/licenses/LICENSE-2.0\n\nUnless required by applicable law or agreed to in writing, software distributed under\nthe License is distributed on an \"AS IS\" BASIS, WITHOUT WARRANTIES OR REPRESENTATIONS\nOF ANY KIND, either express or implied. See the License for the specific language\ngoverning permissions and limitations under the License.\n*/\nimport { MenuItem } from './src/MenuItem.dev.js'\nimport { defineElement } from '@spectrum-web-components/base/src/define-element.js';\n\ndefineElement('sp-menu-item', MenuItem);\n\ndeclare global {\n    interface HTMLElementTagNameMap {\n        'sp-menu-item': MenuItem;\n    }\n}\n"],
+  "mappings": ";AAWA,SAAS,gBAAgB;AACzB,SAAS,qBAAqB;AAE9B,cAAc,gBAAgB,QAAQ;",
+  "names": []
+}

package/sp-menu-item.js

@@ -0,0 +1,2 @@
+"use strict";import{MenuItem as e}from"./src/MenuItem.js";import{defineElement as m}from"@spectrum-web-components/base/src/define-element.js";m("sp-menu-item",e);
+//# sourceMappingURL=sp-menu-item.js.map

package/sp-menu-item.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["sp-menu-item.ts"],
+  "sourcesContent": ["/*\nCopyright 2020 Adobe. All rights reserved.\nThis file is licensed to you under the Apache License, Version 2.0 (the \"License\");\nyou may not use this file except in compliance with the License. You may obtain a copy\nof the License at http://www.apache.org/licenses/LICENSE-2.0\n\nUnless required by applicable law or agreed to in writing, software distributed under\nthe License is distributed on an \"AS IS\" BASIS, WITHOUT WARRANTIES OR REPRESENTATIONS\nOF ANY KIND, either express or implied. See the License for the specific language\ngoverning permissions and limitations under the License.\n*/\nimport { MenuItem } from './src/MenuItem.js';\nimport { defineElement } from '@spectrum-web-components/base/src/define-element.js';\n\ndefineElement('sp-menu-item', MenuItem);\n\ndeclare global {\n    interface HTMLElementTagNameMap {\n        'sp-menu-item': MenuItem;\n    }\n}\n"],
+  "mappings": "aAWA,OAAS,YAAAA,MAAgB,oBACzB,OAAS,iBAAAC,MAAqB,sDAE9BA,EAAc,eAAgBD,CAAQ",
+  "names": ["MenuItem", "defineElement"]
+}

package/sp-menu.d.ts

@@ -0,0 +1,6 @@
+import { Menu } from './src/Menu.js';
+declare global {
+    interface HTMLElementTagNameMap {
+        'sp-menu': Menu;
+    }
+}

package/sp-menu.dev.js

@@ -0,0 +1,5 @@
+"use strict";
+import { Menu } from "./src/Menu.dev.js";
+import { defineElement } from "@spectrum-web-components/base/src/define-element.js";
+defineElement("sp-menu", Menu);
+//# sourceMappingURL=sp-menu.dev.js.map

package/sp-menu.dev.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["sp-menu.ts"],
+  "sourcesContent": ["/*\nCopyright 2020 Adobe. All rights reserved.\nThis file is licensed to you under the Apache License, Version 2.0 (the \"License\");\nyou may not use this file except in compliance with the License. You may obtain a copy\nof the License at http://www.apache.org/licenses/LICENSE-2.0\n\nUnless required by applicable law or agreed to in writing, software distributed under\nthe License is distributed on an \"AS IS\" BASIS, WITHOUT WARRANTIES OR REPRESENTATIONS\nOF ANY KIND, either express or implied. See the License for the specific language\ngoverning permissions and limitations under the License.\n*/\nimport { Menu } from './src/Menu.dev.js'\nimport { defineElement } from '@spectrum-web-components/base/src/define-element.js';\n\ndefineElement('sp-menu', Menu);\n\ndeclare global {\n    interface HTMLElementTagNameMap {\n        'sp-menu': Menu;\n    }\n}\n"],
+  "mappings": ";AAWA,SAAS,YAAY;AACrB,SAAS,qBAAqB;AAE9B,cAAc,WAAW,IAAI;",
+  "names": []
+}

package/sp-menu.js

@@ -0,0 +1,2 @@
+"use strict";import{Menu as e}from"./src/Menu.js";import{defineElement as m}from"@spectrum-web-components/base/src/define-element.js";m("sp-menu",e);
+//# sourceMappingURL=sp-menu.js.map

package/sp-menu.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["sp-menu.ts"],
+  "sourcesContent": ["/*\nCopyright 2020 Adobe. All rights reserved.\nThis file is licensed to you under the Apache License, Version 2.0 (the \"License\");\nyou may not use this file except in compliance with the License. You may obtain a copy\nof the License at http://www.apache.org/licenses/LICENSE-2.0\n\nUnless required by applicable law or agreed to in writing, software distributed under\nthe License is distributed on an \"AS IS\" BASIS, WITHOUT WARRANTIES OR REPRESENTATIONS\nOF ANY KIND, either express or implied. See the License for the specific language\ngoverning permissions and limitations under the License.\n*/\nimport { Menu } from './src/Menu.js';\nimport { defineElement } from '@spectrum-web-components/base/src/define-element.js';\n\ndefineElement('sp-menu', Menu);\n\ndeclare global {\n    interface HTMLElementTagNameMap {\n        'sp-menu': Menu;\n    }\n}\n"],
+  "mappings": "aAWA,OAAS,QAAAA,MAAY,gBACrB,OAAS,iBAAAC,MAAqB,sDAE9BA,EAAc,UAAWD,CAAI",
+  "names": ["Menu", "defineElement"]
+}

package/src/Menu.d.ts

@@ -0,0 +1,118 @@
+import { CSSResultArray, PropertyValues, SpectrumElement, TemplateResult } from '@spectrum-web-components/base';
+import { MenuItem } from './MenuItem.js';
+export interface MenuChildItem {
+    menuItem: MenuItem;
+    managed: boolean;
+    active: boolean;
+    focusable: boolean;
+    focusRoot: Menu;
+}
+declare const Menu_base: typeof SpectrumElement & {
+    new (...args: any[]): import("@spectrum-web-components/base").SizedElementInterface;
+    prototype: import("@spectrum-web-components/base").SizedElementInterface;
+};
+/**
+ * Spectrum Menu Component
+ * @element sp-menu
+ *
+ * @slot - menu items to be listed in the menu
+ * @fires change - Announces that the `value` of the element has changed
+ * @attr selects - whether the element has a specific selection algorithm that it applies
+ *   to its item descendants. `single` allows only one descendent to be selected at a time.
+ *   `multiple` allows many descendants to be selected. `inherit` will be applied dynamically
+ *   when an ancestor of this element is actively managing the selection of its descendents.
+ *   When the `selects` attribute is not present a `value` will not be maintained and the Menu
+ *   Item children of this Menu will not have their `selected` state managed.
+ */
+export declare class Menu extends Menu_base {
+    static get styles(): CSSResultArray;
+    private get isSubmenu();
+    label: string;
+    ignore: boolean;
+    selects: undefined | 'inherit' | 'single' | 'multiple';
+    value: string;
+    valueSeparator: string;
+    get selected(): string[];
+    set selected(selected: string[]);
+    protected _selected: string[];
+    selectedItems: MenuItem[];
+    menuSlot: HTMLSlotElement;
+    private childItemSet;
+    focusedItemIndex: number;
+    focusInItemIndex: number;
+    private selectedItemsMap;
+    get childItems(): MenuItem[];
+    private cachedChildItems;
+    private updateCachedMenuItems;
+    /**
+     * Hide this getter from web-component-analyzer until
+     * https://github.com/runem/web-component-analyzer/issues/131
+     * has been addressed.
+     *
+     * @private
+     */
+    get childRole(): string;
+    protected get ownRole(): string;
+    private resolvedSelects?;
+    private resolvedRole?;
+    /**
+     * When a descendant `<sp-menu-item>` element is added or updated it will dispatch
+     * this event to announce its presence in the DOM. During the CAPTURE phase the first
+     * Menu based element that the event encounters will manage the focus state of the
+     * dispatching `<sp-menu-item>` element.
+     * @param event
+     */
+    private onFocusableItemAddedOrUpdated;
+    /**
+     * When a descendant `<sp-menu-item>` element is added or updated it will dispatch
+     * this event to announce its presence in the DOM. During the BUBBLE phase the first
+     * Menu based element that the event encounters that does not inherit selection will
+     * manage the selection state of the dispatching `<sp-menu-item>` element.
+     * @param event
+     */
+    private onSelectableItemAddedOrUpdated;
+    private addChildItem;
+    private removeChildItem;
+    constructor();
+    focus({ preventScroll }?: FocusOptions): void;
+    private pointerUpTarget;
+    private handleClick;
+    private handlePointerup;
+    private handlePointerBasedSelection;
+    handleFocusin(event: FocusEvent): void;
+    startListeningToKeyboard(): void;
+    handleBlur(event: FocusEvent): void;
+    stopListeningToKeyboard(): void;
+    private descendentOverlays;
+    protected handleDescendentOverlayOpened(event: Event): void;
+    protected handleDescendentOverlayClosed(event: Event): void;
+    handleSubmenuClosed: (event: Event) => void;
+    handleSubmenuOpened: (event: Event) => void;
+    selectOrToggleItem(targetItem: MenuItem): Promise<void>;
+    protected navigateWithinMenu(event: KeyboardEvent): void;
+    protected navigateBetweenRelatedMenus(event: KeyboardEvent): void;
+    handleKeydown(event: KeyboardEvent): void;
+    focusMenuItemByOffset(offset: number): MenuItem;
+    private prepareToCleanUp;
+    private _hasUpdatedSelectedItemIndex;
+    updateSelectedItemIndex(): void;
+    private _willUpdateItems;
+    private handleItemsChanged;
+    private updateCache;
+    private updateItemFocus;
+    closeDescendentOverlays(): void;
+    private forwardFocusVisibleToItem;
+    private handleSlotchange;
+    protected renderMenuItemSlot(): TemplateResult;
+    render(): TemplateResult;
+    protected firstUpdated(changed: PropertyValues): void;
+    protected updated(changes: PropertyValues<this>): void;
+    protected selectsChanged(): void;
+    connectedCallback(): void;
+    disconnectedCallback(): void;
+    protected childItemsUpdated: Promise<unknown[]>;
+    protected cacheUpdated: Promise<void>;
+    protected resolveCacheUpdated: () => void;
+    protected getUpdateComplete(): Promise<boolean>;
+}
+export {};