@spectrum-web-components/menu 0.12.2 → 0.12.3-express.0

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@spectrum-web-components/menu",
-    "version": "0.12.2",
+    "version": "0.12.3-express.0+7a2be85d7",
     "publishConfig": {
         "access": "public"
     },
@@ -54,7 +54,7 @@
         "@spectrum-web-components/base": "^0.5.3",
         "@spectrum-web-components/icon": "^0.11.4",
         "@spectrum-web-components/icons-ui": "^0.8.4",
-        "@spectrum-web-components/overlay": "^0.15.0",
+        "@spectrum-web-components/overlay": "^0.15.1-express.0+7a2be85d7",
         "@spectrum-web-components/shared": "^0.13.5",
         "tslib": "^2.0.0"
     },
@@ -66,5 +66,5 @@
     "sideEffects": [
         "./sp-*.js"
     ],
-    "gitHead": "57aba8030b6af96af4015a0aa830e342a17dc219"
+    "gitHead": "7a2be85d7e231dcf4141a86b7056f6c139a43851"
 }

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.js

@@ -0,0 +1,14 @@
+/*
+Copyright 2020 Adobe. All rights reserved.
+This file is licensed to you under the Apache License, Version 2.0 (the "License");
+you may not use this file except in compliance with the License. You may obtain a copy
+of the License at http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing, software distributed under
+the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR REPRESENTATIONS
+OF ANY KIND, either express or implied. See the License for the specific language
+governing permissions and limitations under the License.
+*/
+import { MenuDivider } from './src/MenuDivider.js';
+customElements.define('sp-menu-divider', MenuDivider);
+//# sourceMappingURL=sp-menu-divider.js.map

package/sp-menu-divider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sp-menu-divider.js","sourceRoot":"","sources":["sp-menu-divider.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;EAUE;AACF,OAAO,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAEnD,cAAc,CAAC,MAAM,CAAC,iBAAiB,EAAE,WAAW,CAAC,CAAC","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';\n\ncustomElements.define('sp-menu-divider', MenuDivider);\n\ndeclare global {\n    interface HTMLElementTagNameMap {\n        'sp-menu-divider': MenuDivider;\n    }\n}\n"]}

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.js

@@ -0,0 +1,14 @@
+/*
+Copyright 2020 Adobe. All rights reserved.
+This file is licensed to you under the Apache License, Version 2.0 (the "License");
+you may not use this file except in compliance with the License. You may obtain a copy
+of the License at http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing, software distributed under
+the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR REPRESENTATIONS
+OF ANY KIND, either express or implied. See the License for the specific language
+governing permissions and limitations under the License.
+*/
+import { MenuGroup } from './src/MenuGroup.js';
+customElements.define('sp-menu-group', MenuGroup);
+//# sourceMappingURL=sp-menu-group.js.map

package/sp-menu-group.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sp-menu-group.js","sourceRoot":"","sources":["sp-menu-group.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;EAUE;AACF,OAAO,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAE/C,cAAc,CAAC,MAAM,CAAC,eAAe,EAAE,SAAS,CAAC,CAAC","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';\n\ncustomElements.define('sp-menu-group', MenuGroup);\n\ndeclare global {\n    interface HTMLElementTagNameMap {\n        'sp-menu-group': MenuGroup;\n    }\n}\n"]}

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.js

@@ -0,0 +1,14 @@
+/*
+Copyright 2020 Adobe. All rights reserved.
+This file is licensed to you under the Apache License, Version 2.0 (the "License");
+you may not use this file except in compliance with the License. You may obtain a copy
+of the License at http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing, software distributed under
+the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR REPRESENTATIONS
+OF ANY KIND, either express or implied. See the License for the specific language
+governing permissions and limitations under the License.
+*/
+import { MenuItem } from './src/MenuItem.js';
+customElements.define('sp-menu-item', MenuItem);
+//# sourceMappingURL=sp-menu-item.js.map

package/sp-menu-item.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sp-menu-item.js","sourceRoot":"","sources":["sp-menu-item.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;EAUE;AACF,OAAO,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAE7C,cAAc,CAAC,MAAM,CAAC,cAAc,EAAE,QAAQ,CAAC,CAAC","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';\n\ncustomElements.define('sp-menu-item', MenuItem);\n\ndeclare global {\n    interface HTMLElementTagNameMap {\n        'sp-menu-item': MenuItem;\n    }\n}\n"]}

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.js

@@ -0,0 +1,14 @@
+/*
+Copyright 2020 Adobe. All rights reserved.
+This file is licensed to you under the Apache License, Version 2.0 (the "License");
+you may not use this file except in compliance with the License. You may obtain a copy
+of the License at http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing, software distributed under
+the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR REPRESENTATIONS
+OF ANY KIND, either express or implied. See the License for the specific language
+governing permissions and limitations under the License.
+*/
+import { Menu } from './src/Menu.js';
+customElements.define('sp-menu', Menu);
+//# sourceMappingURL=sp-menu.js.map

package/sp-menu.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sp-menu.js","sourceRoot":"","sources":["sp-menu.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;EAUE;AACF,OAAO,EAAE,IAAI,EAAE,MAAM,eAAe,CAAC;AAErC,cAAc,CAAC,MAAM,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC","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';\n\ncustomElements.define('sp-menu', Menu);\n\ndeclare global {\n    interface HTMLElementTagNameMap {\n        'sp-menu': Menu;\n    }\n}\n"]}

package/src/Menu.d.ts

@@ -0,0 +1,104 @@
+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;
+}
+/**
+ * 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 SpectrumElement {
+    static get styles(): CSSResultArray;
+    get closeSelfAsSubmenu(): (leave?: boolean) => void;
+    setCloseSelfAsSubmenu(cb: (leave?: boolean) => void): void;
+    _closeSelfAsSubmenu: () => void;
+    isSubmenu: boolean;
+    get closeOpenSubmenu(): (leave?: boolean) => void;
+    setCloseOpenSubmenu(cb: (leave?: boolean) => void): void;
+    _closeOpenSubmenu: () => void;
+    hasOpenSubmenu: boolean;
+    label: string;
+    selects: undefined | 'inherit' | 'single' | 'multiple';
+    value: string;
+    valueSeparator: string;
+    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;
+    submenuWillCloseOn(menuItem: MenuItem): void;
+    private onClick;
+    handleFocusin(event: FocusEvent): void;
+    startListeningToKeyboard(): void;
+    handleFocusout(event: FocusEvent): void;
+    stopListeningToKeyboard(): void;
+    selectOrToggleItem(targetItem: MenuItem): Promise<void>;
+    protected navigateWithinMenu(event: KeyboardEvent): void;
+    protected navigateBetweenRelatedMenus(code: string): void;
+    handleKeydown(event: KeyboardEvent): void;
+    focusMenuItemByOffset(offset: number): MenuItem;
+    private prepareToCleanUp;
+    updateSelectedItemIndex(): void;
+    private _willUpdateItems;
+    private handleItemsChanged;
+    private updateItemFocus;
+    private forwardFocusVisibleToItem;
+    render(): TemplateResult;
+    private _notFirstUpdated;
+    protected firstUpdated(changed: PropertyValues): void;
+    protected updated(changes: PropertyValues<this>): void;
+    protected selectsChanged(): void;
+    connectedCallback(): void;
+    protected childItemsUpdated: Promise<unknown[]>;
+    protected cacheUpdated: Promise<void>;
+    protected getUpdateComplete(): Promise<boolean>;
+}