@spectrum-web-components/sidenav 0.12.6 → 0.12.7

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@spectrum-web-components/sidenav",
-    "version": "0.12.6",
+    "version": "0.12.7",
     "publishConfig": {
         "access": "public"
     },
@@ -48,9 +48,9 @@
         "lit-html"
     ],
     "dependencies": {
-        "@spectrum-web-components/base": "^0.5.3",
-        "@spectrum-web-components/reactive-controllers": "^0.2.1",
-        "@spectrum-web-components/shared": "^0.13.5",
+        "@spectrum-web-components/base": "^0.5.4",
+        "@spectrum-web-components/reactive-controllers": "^0.2.2",
+        "@spectrum-web-components/shared": "^0.13.6",
         "tslib": "^2.0.0"
     },
     "devDependencies": {
@@ -61,5 +61,5 @@
     "sideEffects": [
         "./sp-*.js"
     ],
-    "gitHead": "57aba8030b6af96af4015a0aa830e342a17dc219"
+    "gitHead": "caf12727e7f91dcf961e1fadacc727eea9ece27b"
 }

package/sp-sidenav-heading.d.ts

@@ -0,0 +1,6 @@
+import { SideNavHeading } from './src/SidenavHeading.js';
+declare global {
+    interface HTMLElementTagNameMap {
+        'sp-sidenav-heading': SideNavHeading;
+    }
+}

package/sp-sidenav-heading.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 { SideNavHeading } from './src/SidenavHeading.js';
+customElements.define('sp-sidenav-heading', SideNavHeading);
+//# sourceMappingURL=sp-sidenav-heading.js.map

package/sp-sidenav-heading.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sp-sidenav-heading.js","sourceRoot":"","sources":["sp-sidenav-heading.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;EAUE;AACF,OAAO,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AAEzD,cAAc,CAAC,MAAM,CAAC,oBAAoB,EAAE,cAAc,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 { SideNavHeading } from './src/SidenavHeading.js';\n\ncustomElements.define('sp-sidenav-heading', SideNavHeading);\n\ndeclare global {\n    interface HTMLElementTagNameMap {\n        'sp-sidenav-heading': SideNavHeading;\n    }\n}\n"]}

package/sp-sidenav-item.d.ts

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

package/sp-sidenav-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 { SideNavItem } from './src/SidenavItem.js';
+customElements.define('sp-sidenav-item', SideNavItem);
+//# sourceMappingURL=sp-sidenav-item.js.map

package/sp-sidenav-item.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sp-sidenav-item.js","sourceRoot":"","sources":["sp-sidenav-item.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 { SideNavItem } from './src/SidenavItem.js';\n\ncustomElements.define('sp-sidenav-item', SideNavItem);\n\ndeclare global {\n    interface HTMLElementTagNameMap {\n        'sp-sidenav-item': SideNavItem;\n    }\n}\n"]}

package/sp-sidenav.d.ts

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

package/sp-sidenav.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 { SideNav } from './src/Sidenav.js';
+customElements.define('sp-sidenav', SideNav);
+//# sourceMappingURL=sp-sidenav.js.map

package/sp-sidenav.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sp-sidenav.js","sourceRoot":"","sources":["sp-sidenav.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;EAUE;AACF,OAAO,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAE3C,cAAc,CAAC,MAAM,CAAC,YAAY,EAAE,OAAO,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 { SideNav } from './src/Sidenav.js';\n\ncustomElements.define('sp-sidenav', SideNav);\n\ndeclare global {\n    interface HTMLElementTagNameMap {\n        'sp-sidenav': SideNav;\n    }\n}\n"]}

package/src/Sidenav.d.ts

@@ -0,0 +1,38 @@
+import { CSSResultArray, PropertyValues, TemplateResult } from '@spectrum-web-components/base';
+import { RovingTabindexController } from '@spectrum-web-components/reactive-controllers/src/RovingTabindex.js';
+import { Focusable } from '@spectrum-web-components/shared';
+import { SideNavItem } from './SidenavItem.js';
+export interface SidenavSelectDetail {
+    value: string;
+}
+/**
+ * @element sp-sidenav
+ *
+ * @slot - the Sidenav Items to display
+ * @fires change - Announces a change in the `value` property of the navigation element.
+ * This change can be "canceled" via `event.preventDefault()`.
+ */
+export declare class SideNav extends Focusable {
+    static get styles(): CSSResultArray;
+    private items;
+    startTrackingSelectionForItem(item: SideNavItem): void;
+    stopTrackingSelectionForItem(item: SideNavItem): void;
+    rovingTabindexController: RovingTabindexController<SideNavItem>;
+    manageTabIndex: boolean;
+    value: string | undefined;
+    private handleSelect;
+    focus(): void;
+    blur(): void;
+    click(): void;
+    get focusElement(): SideNavItem | SideNav;
+    private isDisabledChild;
+    private handleSlotchange;
+    protected render(): TemplateResult;
+    protected firstUpdated(changes: PropertyValues): void;
+    protected updated(changes: PropertyValues): void;
+}
+declare global {
+    interface GlobalEventHandlersEventMap {
+        'sp-sidenav:select': CustomEvent<SidenavSelectDetail>;
+    }
+}

package/src/Sidenav.js

@@ -0,0 +1,154 @@
+/*
+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 { __decorate } from "tslib";
+import { html, } from '@spectrum-web-components/base';
+import { property } from '@spectrum-web-components/base/src/decorators.js';
+import { RovingTabindexController } from '@spectrum-web-components/reactive-controllers/src/RovingTabindex.js';
+import sidenavStyles from './sidenav.css.js';
+import { Focusable } from '@spectrum-web-components/shared';
+import { SideNavItem } from './SidenavItem.js';
+import { SideNavHeading } from './SidenavHeading.js';
+/**
+ * @element sp-sidenav
+ *
+ * @slot - the Sidenav Items to display
+ * @fires change - Announces a change in the `value` property of the navigation element.
+ * This change can be "canceled" via `event.preventDefault()`.
+ */
+export class SideNav extends Focusable {
+    constructor() {
+        super(...arguments);
+        this.items = new Set();
+        this.rovingTabindexController = new RovingTabindexController(this, {
+            focusInIndex: (elements) => {
+                return elements.findIndex((el) => {
+                    return this.value
+                        ? !el.disabled &&
+                            !this.isDisabledChild(el) &&
+                            el.value === this.value
+                        : !el.disabled && !this.isDisabledChild(el);
+                });
+            },
+            direction: 'vertical',
+            elements: () => [...this.querySelectorAll('sp-sidenav-item')],
+            isFocusableElement: (el) => !el.disabled && !this.isDisabledChild(el),
+        });
+        this.manageTabIndex = false;
+        this.value = undefined;
+    }
+    static get styles() {
+        return [sidenavStyles];
+    }
+    startTrackingSelectionForItem(item) {
+        this.items.add(item);
+        this.rovingTabindexController.clearElementCache();
+    }
+    stopTrackingSelectionForItem(item) {
+        this.items.delete(item);
+        this.rovingTabindexController.clearElementCache();
+    }
+    handleSelect(event) {
+        event.stopPropagation();
+        if (this.value === event.detail.value) {
+            return;
+        }
+        const oldValue = this.value;
+        this.value = event.detail.value;
+        const applyDefault = this.dispatchEvent(new Event('change', {
+            bubbles: true,
+            composed: true,
+            cancelable: true,
+        }));
+        if (!applyDefault) {
+            this.value = oldValue;
+            event.target.selected = false;
+            event.preventDefault();
+        }
+        else {
+            this.items.forEach((item) => item.handleSideNavSelect(event));
+        }
+    }
+    focus() {
+        this.rovingTabindexController.focus();
+    }
+    blur() {
+        if (this.focusElement === this) {
+            return;
+        }
+        super.blur();
+    }
+    click() {
+        if (this.focusElement === this) {
+            return;
+        }
+        super.click();
+    }
+    get focusElement() {
+        return this.rovingTabindexController.focusInElement || this;
+    }
+    isDisabledChild(child) {
+        if (child.disabled) {
+            return true;
+        }
+        let parent = child.parentElement;
+        while (parent instanceof SideNavHeading ||
+            (!parent.disabled &&
+                parent instanceof SideNavItem &&
+                parent.expanded)) {
+            parent = parent.parentElement;
+        }
+        return parent !== this;
+    }
+    handleSlotchange() {
+        if (this.manageTabIndex) {
+            this.rovingTabindexController.manage();
+        }
+        else {
+            this.rovingTabindexController.unmanage();
+        }
+    }
+    render() {
+        return html `
+            <nav @sidenav-select=${this.handleSelect}>
+                <slot
+                    name="descendant"
+                    @slotchange=${this.handleSlotchange}
+                ></slot>
+            </nav>
+        `;
+    }
+    firstUpdated(changes) {
+        super.firstUpdated(changes);
+        const selectedChild = this.querySelector('[selected]');
+        if (selectedChild) {
+            this.value = selectedChild.value;
+        }
+    }
+    updated(changes) {
+        super.updated(changes);
+        if (changes.has('manageTabIndex')) {
+            if (this.manageTabIndex) {
+                this.rovingTabindexController.manage();
+            }
+            else {
+                this.rovingTabindexController.unmanage();
+            }
+        }
+    }
+}
+__decorate([
+    property({ type: Boolean, reflect: true, attribute: 'manage-tab-index' })
+], SideNav.prototype, "manageTabIndex", void 0);
+__decorate([
+    property({ reflect: true })
+], SideNav.prototype, "value", void 0);
+//# sourceMappingURL=Sidenav.js.map

package/src/Sidenav.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Sidenav.js","sourceRoot":"","sources":["Sidenav.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;EAUE;;AAEF,OAAO,EAEH,IAAI,GAGP,MAAM,+BAA+B,CAAC;AACvC,OAAO,EAAE,QAAQ,EAAE,MAAM,iDAAiD,CAAC;AAC3E,OAAO,EAAE,wBAAwB,EAAE,MAAM,qEAAqE,CAAC;AAE/G,OAAO,aAAa,MAAM,kBAAkB,CAAC;AAC7C,OAAO,EAAE,SAAS,EAAE,MAAM,iCAAiC,CAAC;AAC5D,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC/C,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAMrD;;;;;;GAMG;AACH,MAAM,OAAO,OAAQ,SAAQ,SAAS;IAAtC;;QAKY,UAAK,GAAG,IAAI,GAAG,EAAe,CAAC;QAYvC,6BAAwB,GAAG,IAAI,wBAAwB,CAAc,IAAI,EAAE;YACvE,YAAY,EAAE,CAAC,QAAuB,EAAE,EAAE;gBACtC,OAAO,QAAQ,CAAC,SAAS,CAAC,CAAC,EAAE,EAAE,EAAE;oBAC7B,OAAO,IAAI,CAAC,KAAK;wBACb,CAAC,CAAC,CAAC,EAAE,CAAC,QAAQ;4BACR,CAAC,IAAI,CAAC,eAAe,CAAC,EAAE,CAAC;4BACzB,EAAE,CAAC,KAAK,KAAK,IAAI,CAAC,KAAK;wBAC7B,CAAC,CAAC,CAAC,EAAE,CAAC,QAAQ,IAAI,CAAC,IAAI,CAAC,eAAe,CAAC,EAAE,CAAC,CAAC;gBACpD,CAAC,CAAC,CAAC;YACP,CAAC;YACD,SAAS,EAAE,UAAU;YACrB,QAAQ,EAAE,GAAG,EAAE,CAAC,CAAC,GAAG,IAAI,CAAC,gBAAgB,CAAC,iBAAiB,CAAC,CAAC;YAC7D,kBAAkB,EAAE,CAAC,EAAe,EAAE,EAAE,CACpC,CAAC,EAAE,CAAC,QAAQ,IAAI,CAAC,IAAI,CAAC,eAAe,CAAC,EAAE,CAAC;SAChD,CAAC,CAAC;QAGI,mBAAc,GAAG,KAAK,CAAC;QAGvB,UAAK,GAAuB,SAAS,CAAC;IA8GjD,CAAC;IAlJU,MAAM,KAAK,MAAM;QACpB,OAAO,CAAC,aAAa,CAAC,CAAC;IAC3B,CAAC;IAIM,6BAA6B,CAAC,IAAiB;QAClD,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QACrB,IAAI,CAAC,wBAAwB,CAAC,iBAAiB,EAAE,CAAC;IACtD,CAAC;IAEM,4BAA4B,CAAC,IAAiB;QACjD,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QACxB,IAAI,CAAC,wBAAwB,CAAC,iBAAiB,EAAE,CAAC;IACtD,CAAC;IAwBO,YAAY,CAChB,KAAiE;QAEjE,KAAK,CAAC,eAAe,EAAE,CAAC;QACxB,IAAI,IAAI,CAAC,KAAK,KAAK,KAAK,CAAC,MAAM,CAAC,KAAK,EAAE;YACnC,OAAO;SACV;QACD,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC;QAC5B,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC;QAChC,MAAM,YAAY,GAAG,IAAI,CAAC,aAAa,CACnC,IAAI,KAAK,CAAC,QAAQ,EAAE;YAChB,OAAO,EAAE,IAAI;YACb,QAAQ,EAAE,IAAI;YACd,UAAU,EAAE,IAAI;SACnB,CAAC,CACL,CAAC;QACF,IAAI,CAAC,YAAY,EAAE;YACf,IAAI,CAAC,KAAK,GAAG,QAAQ,CAAC;YACtB,KAAK,CAAC,MAAM,CAAC,QAAQ,GAAG,KAAK,CAAC;YAC9B,KAAK,CAAC,cAAc,EAAE,CAAC;SAC1B;aAAM;YACH,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,mBAAmB,CAAC,KAAK,CAAC,CAAC,CAAC;SACjE;IACL,CAAC;IAEM,KAAK;QACR,IAAI,CAAC,wBAAwB,CAAC,KAAK,EAAE,CAAC;IAC1C,CAAC;IAEM,IAAI;QACP,IAAI,IAAI,CAAC,YAAY,KAAK,IAAI,EAAE;YAC5B,OAAO;SACV;QAED,KAAK,CAAC,IAAI,EAAE,CAAC;IACjB,CAAC;IAEM,KAAK;QACR,IAAI,IAAI,CAAC,YAAY,KAAK,IAAI,EAAE;YAC5B,OAAO;SACV;QAED,KAAK,CAAC,KAAK,EAAE,CAAC;IAClB,CAAC;IAED,IAAW,YAAY;QACnB,OAAO,IAAI,CAAC,wBAAwB,CAAC,cAAc,IAAI,IAAI,CAAC;IAChE,CAAC;IAEO,eAAe,CAAC,KAAkB;QACtC,IAAI,KAAK,CAAC,QAAQ,EAAE;YAChB,OAAO,IAAI,CAAC;SACf;QACD,IAAI,MAAM,GAAG,KAAK,CAAC,aAGC,CAAC;QACrB,OACI,MAAM,YAAY,cAAc;YAChC,CAAC,CAAE,MAAsB,CAAC,QAAQ;gBAC9B,MAAM,YAAY,WAAW;gBAC7B,MAAM,CAAC,QAAQ,CAAC,EACtB;YACE,MAAM,GAAG,MAAM,CAAC,aAGI,CAAC;SACxB;QACD,OAAO,MAAM,KAAK,IAAI,CAAC;IAC3B,CAAC;IAEO,gBAAgB;QACpB,IAAI,IAAI,CAAC,cAAc,EAAE;YACrB,IAAI,CAAC,wBAAwB,CAAC,MAAM,EAAE,CAAC;SAC1C;aAAM;YACH,IAAI,CAAC,wBAAwB,CAAC,QAAQ,EAAE,CAAC;SAC5C;IACL,CAAC;IAES,MAAM;QACZ,OAAO,IAAI,CAAA;mCACgB,IAAI,CAAC,YAAY;;;kCAGlB,IAAI,CAAC,gBAAgB;;;SAG9C,CAAC;IACN,CAAC;IAES,YAAY,CAAC,OAAuB;QAC1C,KAAK,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC;QAC5B,MAAM,aAAa,GAAG,IAAI,CAAC,aAAa,CAAC,YAAY,CAAgB,CAAC;QACtE,IAAI,aAAa,EAAE;YACf,IAAI,CAAC,KAAK,GAAG,aAAa,CAAC,KAAK,CAAC;SACpC;IACL,CAAC;IAES,OAAO,CAAC,OAAuB;QACrC,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;QACvB,IAAI,OAAO,CAAC,GAAG,CAAC,gBAAgB,CAAC,EAAE;YAC/B,IAAI,IAAI,CAAC,cAAc,EAAE;gBACrB,IAAI,CAAC,wBAAwB,CAAC,MAAM,EAAE,CAAC;aAC1C;iBAAM;gBACH,IAAI,CAAC,wBAAwB,CAAC,QAAQ,EAAE,CAAC;aAC5C;SACJ;IACL,CAAC;CACJ;AAjHG;IADC,QAAQ,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,kBAAkB,EAAE,CAAC;+CAC5C;AAG9B;IADC,QAAQ,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;sCACiB","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*/\n\nimport {\n    CSSResultArray,\n    html,\n    PropertyValues,\n    TemplateResult,\n} from '@spectrum-web-components/base';\nimport { property } from '@spectrum-web-components/base/src/decorators.js';\nimport { RovingTabindexController } from '@spectrum-web-components/reactive-controllers/src/RovingTabindex.js';\n\nimport sidenavStyles from './sidenav.css.js';\nimport { Focusable } from '@spectrum-web-components/shared';\nimport { SideNavItem } from './SidenavItem.js';\nimport { SideNavHeading } from './SidenavHeading.js';\n\nexport interface SidenavSelectDetail {\n    value: string;\n}\n\n/**\n * @element sp-sidenav\n *\n * @slot - the Sidenav Items to display\n * @fires change - Announces a change in the `value` property of the navigation element.\n * This change can be \"canceled\" via `event.preventDefault()`.\n */\nexport class SideNav extends Focusable {\n    public static get styles(): CSSResultArray {\n        return [sidenavStyles];\n    }\n\n    private items = new Set<SideNavItem>();\n\n    public startTrackingSelectionForItem(item: SideNavItem): void {\n        this.items.add(item);\n        this.rovingTabindexController.clearElementCache();\n    }\n\n    public stopTrackingSelectionForItem(item: SideNavItem): void {\n        this.items.delete(item);\n        this.rovingTabindexController.clearElementCache();\n    }\n\n    rovingTabindexController = new RovingTabindexController<SideNavItem>(this, {\n        focusInIndex: (elements: SideNavItem[]) => {\n            return elements.findIndex((el) => {\n                return this.value\n                    ? !el.disabled &&\n                          !this.isDisabledChild(el) &&\n                          el.value === this.value\n                    : !el.disabled && !this.isDisabledChild(el);\n            });\n        },\n        direction: 'vertical',\n        elements: () => [...this.querySelectorAll('sp-sidenav-item')],\n        isFocusableElement: (el: SideNavItem) =>\n            !el.disabled && !this.isDisabledChild(el),\n    });\n\n    @property({ type: Boolean, reflect: true, attribute: 'manage-tab-index' })\n    public manageTabIndex = false;\n\n    @property({ reflect: true })\n    public value: string | undefined = undefined;\n\n    private handleSelect(\n        event: CustomEvent<SidenavSelectDetail> & { target: SideNavItem }\n    ): void {\n        event.stopPropagation();\n        if (this.value === event.detail.value) {\n            return;\n        }\n        const oldValue = this.value;\n        this.value = event.detail.value;\n        const applyDefault = this.dispatchEvent(\n            new Event('change', {\n                bubbles: true,\n                composed: true,\n                cancelable: true,\n            })\n        );\n        if (!applyDefault) {\n            this.value = oldValue;\n            event.target.selected = false;\n            event.preventDefault();\n        } else {\n            this.items.forEach((item) => item.handleSideNavSelect(event));\n        }\n    }\n\n    public focus(): void {\n        this.rovingTabindexController.focus();\n    }\n\n    public blur(): void {\n        if (this.focusElement === this) {\n            return;\n        }\n\n        super.blur();\n    }\n\n    public click(): void {\n        if (this.focusElement === this) {\n            return;\n        }\n\n        super.click();\n    }\n\n    public get focusElement(): SideNavItem | SideNav {\n        return this.rovingTabindexController.focusInElement || this;\n    }\n\n    private isDisabledChild(child: SideNavItem): boolean {\n        if (child.disabled) {\n            return true;\n        }\n        let parent = child.parentElement as\n            | SideNavItem\n            | SideNav\n            | SideNavHeading;\n        while (\n            parent instanceof SideNavHeading ||\n            (!(parent as SideNavItem).disabled &&\n                parent instanceof SideNavItem &&\n                parent.expanded)\n        ) {\n            parent = parent.parentElement as\n                | SideNavItem\n                | SideNav\n                | SideNavHeading;\n        }\n        return parent !== this;\n    }\n\n    private handleSlotchange(): void {\n        if (this.manageTabIndex) {\n            this.rovingTabindexController.manage();\n        } else {\n            this.rovingTabindexController.unmanage();\n        }\n    }\n\n    protected render(): TemplateResult {\n        return html`\n            <nav @sidenav-select=${this.handleSelect}>\n                <slot\n                    name=\"descendant\"\n                    @slotchange=${this.handleSlotchange}\n                ></slot>\n            </nav>\n        `;\n    }\n\n    protected firstUpdated(changes: PropertyValues): void {\n        super.firstUpdated(changes);\n        const selectedChild = this.querySelector('[selected]') as SideNavItem;\n        if (selectedChild) {\n            this.value = selectedChild.value;\n        }\n    }\n\n    protected updated(changes: PropertyValues): void {\n        super.updated(changes);\n        if (changes.has('manageTabIndex')) {\n            if (this.manageTabIndex) {\n                this.rovingTabindexController.manage();\n            } else {\n                this.rovingTabindexController.unmanage();\n            }\n        }\n    }\n}\n\ndeclare global {\n    interface GlobalEventHandlersEventMap {\n        'sp-sidenav:select': CustomEvent<SidenavSelectDetail>;\n    }\n}\n"]}

package/src/SidenavHeading.d.ts

@@ -0,0 +1,12 @@
+import { CSSResultArray, PropertyValues, SpectrumElement, TemplateResult } from '@spectrum-web-components/base';
+/**
+ * @element sp-sidenav-heading
+ *
+ * @slot - the Sidenav Items to display in association with the heading
+ */
+export declare class SideNavHeading extends SpectrumElement {
+    label: string;
+    static get styles(): CSSResultArray;
+    protected update(changes: PropertyValues): void;
+    protected render(): TemplateResult;
+}

package/src/SidenavHeading.js

@@ -0,0 +1,48 @@
+/*
+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 { __decorate } from "tslib";
+import { html, SpectrumElement, } from '@spectrum-web-components/base';
+import { property } from '@spectrum-web-components/base/src/decorators.js';
+import sidenavItemStyles from './sidenav-item.css.js';
+import sidenavHeadingStyles from './sidenav-heading.css.js';
+/**
+ * @element sp-sidenav-heading
+ *
+ * @slot - the Sidenav Items to display in association with the heading
+ */
+export class SideNavHeading extends SpectrumElement {
+    constructor() {
+        super(...arguments);
+        this.label = '';
+    }
+    static get styles() {
+        return [sidenavItemStyles, sidenavHeadingStyles];
+    }
+    update(changes) {
+        if (!this.hasAttribute('slot')) {
+            this.slot = 'descendant';
+        }
+        super.update(changes);
+    }
+    render() {
+        return html `
+            <h2 id="heading">${this.label}</h2>
+            <div id="list" aria-labelledby="heading">
+                <slot name="descendant"></slot>
+            </div>
+        `;
+    }
+}
+__decorate([
+    property({ reflect: true })
+], SideNavHeading.prototype, "label", void 0);
+//# sourceMappingURL=SidenavHeading.js.map

package/src/SidenavHeading.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SidenavHeading.js","sourceRoot":"","sources":["SidenavHeading.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;EAUE;;AAEF,OAAO,EAEH,IAAI,EAEJ,eAAe,GAElB,MAAM,+BAA+B,CAAC;AACvC,OAAO,EAAE,QAAQ,EAAE,MAAM,iDAAiD,CAAC;AAE3E,OAAO,iBAAiB,MAAM,uBAAuB,CAAC;AACtD,OAAO,oBAAoB,MAAM,0BAA0B,CAAC;AAE5D;;;;GAIG;AACH,MAAM,OAAO,cAAe,SAAQ,eAAe;IAAnD;;QAEW,UAAK,GAAG,EAAE,CAAC;IAqBtB,CAAC;IAnBU,MAAM,KAAK,MAAM;QACpB,OAAO,CAAC,iBAAiB,EAAE,oBAAoB,CAAC,CAAC;IACrD,CAAC;IAES,MAAM,CAAC,OAAuB;QACpC,IAAI,CAAC,IAAI,CAAC,YAAY,CAAC,MAAM,CAAC,EAAE;YAC5B,IAAI,CAAC,IAAI,GAAG,YAAY,CAAC;SAC5B;QACD,KAAK,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IAC1B,CAAC;IAES,MAAM;QACZ,OAAO,IAAI,CAAA;+BACY,IAAI,CAAC,KAAK;;;;SAIhC,CAAC;IACN,CAAC;CACJ;AArBG;IADC,QAAQ,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;6CACV","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*/\n\nimport {\n    CSSResultArray,\n    html,\n    PropertyValues,\n    SpectrumElement,\n    TemplateResult,\n} from '@spectrum-web-components/base';\nimport { property } from '@spectrum-web-components/base/src/decorators.js';\n\nimport sidenavItemStyles from './sidenav-item.css.js';\nimport sidenavHeadingStyles from './sidenav-heading.css.js';\n\n/**\n * @element sp-sidenav-heading\n *\n * @slot - the Sidenav Items to display in association with the heading\n */\nexport class SideNavHeading extends SpectrumElement {\n    @property({ reflect: true })\n    public label = '';\n\n    public static get styles(): CSSResultArray {\n        return [sidenavItemStyles, sidenavHeadingStyles];\n    }\n\n    protected update(changes: PropertyValues): void {\n        if (!this.hasAttribute('slot')) {\n            this.slot = 'descendant';\n        }\n        super.update(changes);\n    }\n\n    protected render(): TemplateResult {\n        return html`\n            <h2 id=\"heading\">${this.label}</h2>\n            <div id=\"list\" aria-labelledby=\"heading\">\n                <slot name=\"descendant\"></slot>\n            </div>\n        `;\n    }\n}\n"]}

package/src/SidenavItem.d.ts

@@ -0,0 +1,35 @@
+import { CSSResultArray, PropertyValues, TemplateResult } from '@spectrum-web-components/base';
+import { Focusable } from '@spectrum-web-components/shared/src/focusable.js';
+import { SideNav } from './Sidenav.js';
+declare const SideNavItem_base: typeof Focusable & {
+    new (...args: any[]): import("@spectrum-web-components/shared/src/like-anchor.js").LikeAnchorInterface;
+    prototype: import("@spectrum-web-components/shared/src/like-anchor.js").LikeAnchorInterface;
+};
+/**
+ * @element sp-sidenav-item
+ *
+ * @slot - the Sidenav Items to display as children of this item
+ */
+export declare class SideNavItem extends SideNavItem_base {
+    static get styles(): CSSResultArray;
+    value: string | undefined;
+    selected: boolean;
+    expanded: boolean;
+    protected get parentSideNav(): SideNav | undefined;
+    protected _parentSidenav?: SideNav;
+    protected get hasChildren(): boolean;
+    protected get depth(): number;
+    handleSideNavSelect(event: Event): void;
+    protected handleClick(event?: Event): void;
+    private announceSelected;
+    click(): void;
+    get focusElement(): HTMLElement;
+    protected update(changes: PropertyValues): void;
+    protected render(): TemplateResult;
+    protected updated(changes: PropertyValues): void;
+    connectedCallback(): void;
+    disconnectedCallback(): void;
+    private startTrackingSelection;
+    private stopTrackingSelection;
+}
+export {};

package/src/SidenavItem.js

@@ -0,0 +1,154 @@
+/*
+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 { __decorate } from "tslib";
+import { html, } from '@spectrum-web-components/base';
+import { property } from '@spectrum-web-components/base/src/decorators.js';
+import { ifDefined } from '@spectrum-web-components/base/src/directives.js';
+import { LikeAnchor } from '@spectrum-web-components/shared/src/like-anchor.js';
+import { Focusable } from '@spectrum-web-components/shared/src/focusable.js';
+import sidenavItemStyles from './sidenav-item.css.js';
+/**
+ * @element sp-sidenav-item
+ *
+ * @slot - the Sidenav Items to display as children of this item
+ */
+export class SideNavItem extends LikeAnchor(Focusable) {
+    constructor() {
+        super(...arguments);
+        this.value = undefined;
+        this.selected = false;
+        this.expanded = false;
+    }
+    static get styles() {
+        return [sidenavItemStyles];
+    }
+    get parentSideNav() {
+        if (!this._parentSidenav) {
+            this._parentSidenav = this.closest('sp-sidenav');
+        }
+        return this._parentSidenav;
+    }
+    get hasChildren() {
+        return !!this.querySelector('sp-sidenav-item');
+    }
+    get depth() {
+        let depth = 0;
+        let element = this.parentElement;
+        while (element instanceof SideNavItem) {
+            depth++;
+            element = element.parentElement;
+        }
+        return depth;
+    }
+    handleSideNavSelect(event) {
+        this.selected = event.target === this;
+    }
+    handleClick(event) {
+        if (!this.href && event) {
+            event.preventDefault();
+        }
+        if (!this.disabled) {
+            if (this.hasChildren) {
+                this.expanded = !this.expanded;
+            }
+            else if (this.value) {
+                this.announceSelected(this.value);
+            }
+        }
+    }
+    announceSelected(value) {
+        const selectDetail = {
+            value,
+        };
+        const selectionEvent = new CustomEvent('sidenav-select', {
+            bubbles: true,
+            composed: true,
+            detail: selectDetail,
+        });
+        this.dispatchEvent(selectionEvent);
+    }
+    click() {
+        this.handleClick();
+    }
+    get focusElement() {
+        return this.shadowRoot.querySelector('#item-link');
+    }
+    update(changes) {
+        if (!this.hasAttribute('slot')) {
+            this.slot = 'descendant';
+        }
+        super.update(changes);
+    }
+    render() {
+        return html `
+            <a
+                href=${this.href || '#'}
+                target=${ifDefined(this.target)}
+                download=${ifDefined(this.download)}
+                rel=${ifDefined(this.rel)}
+                data-level="${this.depth}"
+                @click="${this.handleClick}"
+                id="item-link"
+                aria-current=${ifDefined(this.selected && this.href ? 'page' : undefined)}
+            >
+                <slot name="icon"></slot>
+                ${this.label}
+                <slot></slot>
+            </a>
+            ${this.expanded
+            ? html `
+                      <slot name="descendant"></slot>
+                  `
+            : html ``}
+        `;
+    }
+    updated(changes) {
+        if (this.hasChildren && this.expanded && !this.selected) {
+            this.focusElement.tabIndex = -1;
+        }
+        super.updated(changes);
+    }
+    connectedCallback() {
+        super.connectedCallback();
+        this.startTrackingSelection();
+    }
+    disconnectedCallback() {
+        this.stopTrackingSelection();
+        super.disconnectedCallback();
+    }
+    async startTrackingSelection() {
+        const parentSideNav = this.parentSideNav;
+        if (parentSideNav) {
+            await parentSideNav.updateComplete;
+            parentSideNav.startTrackingSelectionForItem(this);
+            this.selected =
+                this.value != null && this.value === parentSideNav.value;
+        }
+    }
+    stopTrackingSelection() {
+        const parentSideNav = this.parentSideNav;
+        if (parentSideNav) {
+            parentSideNav.stopTrackingSelectionForItem(this);
+        }
+        this._parentSidenav = undefined;
+    }
+}
+__decorate([
+    property()
+], SideNavItem.prototype, "value", void 0);
+__decorate([
+    property({ type: Boolean, reflect: true })
+], SideNavItem.prototype, "selected", void 0);
+__decorate([
+    property({ type: Boolean, reflect: true })
+], SideNavItem.prototype, "expanded", void 0);
+//# sourceMappingURL=SidenavItem.js.map

package/src/SidenavItem.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SidenavItem.js","sourceRoot":"","sources":["SidenavItem.ts"],"names":[],"mappings":"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","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*/\n\nimport {\n    CSSResultArray,\n    html,\n    PropertyValues,\n    TemplateResult,\n} from '@spectrum-web-components/base';\nimport { property } from '@spectrum-web-components/base/src/decorators.js';\nimport { ifDefined } from '@spectrum-web-components/base/src/directives.js';\nimport { LikeAnchor } from '@spectrum-web-components/shared/src/like-anchor.js';\nimport { Focusable } from '@spectrum-web-components/shared/src/focusable.js';\n\nimport { SideNav, SidenavSelectDetail } from './Sidenav.js';\n\nimport sidenavItemStyles from './sidenav-item.css.js';\n\n/**\n * @element sp-sidenav-item\n *\n * @slot - the Sidenav Items to display as children of this item\n */\nexport class SideNavItem extends LikeAnchor(Focusable) {\n    public static get styles(): CSSResultArray {\n        return [sidenavItemStyles];\n    }\n\n    @property()\n    public value: string | undefined = undefined;\n\n    @property({ type: Boolean, reflect: true })\n    public selected = false;\n\n    @property({ type: Boolean, reflect: true })\n    public expanded = false;\n\n    protected get parentSideNav(): SideNav | undefined {\n        if (!this._parentSidenav) {\n            this._parentSidenav = this.closest('sp-sidenav') as\n                | SideNav\n                | undefined;\n        }\n        return this._parentSidenav;\n    }\n\n    protected _parentSidenav?: SideNav;\n\n    protected get hasChildren(): boolean {\n        return !!this.querySelector('sp-sidenav-item');\n    }\n\n    protected get depth(): number {\n        let depth = 0;\n        let element = this.parentElement;\n        while (element instanceof SideNavItem) {\n            depth++;\n            element = element.parentElement;\n        }\n        return depth;\n    }\n\n    public handleSideNavSelect(event: Event): void {\n        this.selected = event.target === this;\n    }\n\n    protected handleClick(event?: Event): void {\n        if (!this.href && event) {\n            event.preventDefault();\n        }\n        if (!this.disabled) {\n            if (this.hasChildren) {\n                this.expanded = !this.expanded;\n            } else if (this.value) {\n                this.announceSelected(this.value);\n            }\n        }\n    }\n\n    private announceSelected(value: string): void {\n        const selectDetail: SidenavSelectDetail = {\n            value,\n        };\n\n        const selectionEvent = new CustomEvent('sidenav-select', {\n            bubbles: true,\n            composed: true,\n            detail: selectDetail,\n        });\n\n        this.dispatchEvent(selectionEvent);\n    }\n\n    public click(): void {\n        this.handleClick();\n    }\n\n    public get focusElement(): HTMLElement {\n        return this.shadowRoot.querySelector('#item-link') as HTMLElement;\n    }\n\n    protected update(changes: PropertyValues): void {\n        if (!this.hasAttribute('slot')) {\n            this.slot = 'descendant';\n        }\n        super.update(changes);\n    }\n\n    protected render(): TemplateResult {\n        return html`\n            <a\n                href=${this.href || '#'}\n                target=${ifDefined(this.target)}\n                download=${ifDefined(this.download)}\n                rel=${ifDefined(this.rel)}\n                data-level=\"${this.depth}\"\n                @click=\"${this.handleClick}\"\n                id=\"item-link\"\n                aria-current=${ifDefined(\n                    this.selected && this.href ? 'page' : undefined\n                )}\n            >\n                <slot name=\"icon\"></slot>\n                ${this.label}\n                <slot></slot>\n            </a>\n            ${this.expanded\n                ? html`\n                      <slot name=\"descendant\"></slot>\n                  `\n                : html``}\n        `;\n    }\n\n    protected updated(changes: PropertyValues): void {\n        if (this.hasChildren && this.expanded && !this.selected) {\n            this.focusElement.tabIndex = -1;\n        }\n        super.updated(changes);\n    }\n\n    public connectedCallback(): void {\n        super.connectedCallback();\n        this.startTrackingSelection();\n    }\n\n    public disconnectedCallback(): void {\n        this.stopTrackingSelection();\n        super.disconnectedCallback();\n    }\n\n    private async startTrackingSelection(): Promise<void> {\n        const parentSideNav = this.parentSideNav;\n        if (parentSideNav) {\n            await parentSideNav.updateComplete;\n            parentSideNav.startTrackingSelectionForItem(this);\n            this.selected =\n                this.value != null && this.value === parentSideNav.value;\n        }\n    }\n\n    private stopTrackingSelection(): void {\n        const parentSideNav = this.parentSideNav;\n        if (parentSideNav) {\n            parentSideNav.stopTrackingSelectionForItem(this);\n        }\n        this._parentSidenav = undefined;\n    }\n}\n"]}

package/src/index.d.ts

@@ -0,0 +1,3 @@
+export * from './Sidenav.js';
+export * from './SidenavItem.js';
+export * from './SidenavHeading.js';

package/src/index.js

@@ -0,0 +1,15 @@
+/*
+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.
+*/
+export * from './Sidenav.js';
+export * from './SidenavItem.js';
+export * from './SidenavHeading.js';
+//# sourceMappingURL=index.js.map

package/src/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;EAUE;AACF,cAAc,cAAc,CAAC;AAC7B,cAAc,kBAAkB,CAAC;AACjC,cAAc,qBAAqB,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*/\nexport * from './Sidenav.js';\nexport * from './SidenavItem.js';\nexport * from './SidenavHeading.js';\n"]}

package/src/sidenav-heading.css.d.ts

@@ -0,0 +1,2 @@
+declare const styles: import("@spectrum-web-components/base").CSSResult;
+export default styles;