@spectrum-web-components/sidenav 0.0.0-20241209155954

package/README.md

@@ -0,0 +1,148 @@
+## Description
+
+Side navigation allows users to locate information and features within the UI.
+It can be used for either hierarchical or flat navigation, and gives the ability
+to group navigable items categorically. Side navigation is an opportunity to
+prioritize content or features based on your users’ needs in a way that
+maintains clear, persistent visibility. Use side navigation within the context
+of larger elements and mechanisms within the app frame.
+
+`<sp-sidenav>` elements accept both `<sp-sidenav-item>` and `<sp-sidenav-heading>` elements as children in order to construct a hierarchy of navigation elements. [`<sp-sidenav-item>`](./components/sidenav-item) elements will place themselves as a togglable child of their `<sp-sidenav>` element parent. `<sp-sidenav-heading>` elements will create visible structure by grouping their child `<sp-sidenav-item>` children under a non-interactive heading.
+
+### Usage
+
+[![See it on NPM!](https://img.shields.io/npm/v/@spectrum-web-components/sidenav?style=for-the-badge)](https://www.npmjs.com/package/@spectrum-web-components/sidenav)
+[![How big is this package in your project?](https://img.shields.io/bundlephobia/minzip/@spectrum-web-components/sidenav?style=for-the-badge)](https://bundlephobia.com/result?p=@spectrum-web-components/sidenav)
+[![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/WQ6UEUP8wfm9bKUKpWgi/src/index.ts)
+
+```
+yarn add @spectrum-web-components/sidenav
+```
+
+Import the side effectful registration of `<sp-sidenav>`, `<sp-sidenav-heading>`, or `<sp-sidenav-item>` via:
+
+```
+import '@spectrum-web-components/sidenav/sp-sidenav.js';
+import '@spectrum-web-components/sidenav/sp-sidenav-heading.js';
+import '@spectrum-web-components/sidenav/sp-sidenav-item.js';
+```
+
+When looking to leverage the `Sidenav`, `SidenavHeading`, or `SidenavItem` base classes as a type and/or for extension purposes, do so via:
+
+```
+import {
+    Sidenav,
+    SidenavHeading,
+    SidenavItem
+} from '@spectrum-web-components/sidenav';
+```
+
+## Example
+
+```html
+<sp-sidenav defaultValue="Docs">
+    <sp-sidenav-item
+        value="Docs"
+        href="/components/SideNav"
+        label="Docs"
+        selected
+    ></sp-sidenav-item>
+    <sp-sidenav-item
+        value="Guides"
+        href="/guides/getting_started"
+        label="Guides"
+    ></sp-sidenav-item>
+    <sp-sidenav-item
+        value="Community"
+        href="/community"
+        label="Community"
+    ></sp-sidenav-item>
+    <sp-sidenav-item
+        value="Storybook"
+        href="/storybook"
+        target="_blank"
+        label="Storybook"
+    ></sp-sidenav-item>
+    <sp-sidenav-item
+        value="Releases"
+        href="http://git.corp.adobe.com/React/react-spectrum/releases"
+        target="_blank"
+        label="Releases"
+        disabled
+    ></sp-sidenav-item>
+    <sp-sidenav-item
+        value="GitHub"
+        href="http://git.corp.adobe.com/React/react-spectrum"
+        target="_blank"
+        label="Github"
+    ></sp-sidenav-item>
+</sp-sidenav>
+```
+
+## Multi-level
+
+Use this variation when you have multiple layers of hierarchical navigation. The
+headers are styled differently and possess the same interactive behavior as a
+treeview; clicking the header opens and collapses the children navigation items.
+In the instances where a top-level navigation item has no children, clicking
+will send the user to the location of the item.
+
+```html
+<sp-sidenav variant="multilevel" defaultValue="Layout">
+    <sp-sidenav-item value="Guidelines" label="Guidelines">
+    </sp-sidenav-item>
+    <sp-sidenav-item value="Styles" label="Styles" expanded>
+        <sp-sidenav-item value="Color" label="Color">
+        </sp-sidenav-item>
+        <sp-sidenav-item value="Grid" label="Grid" expanded>
+            <sp-sidenav-item value="Layout" label="Layout">
+            </sp-sidenav-item>
+            <sp-sidenav-item value="Responsive" label="Responsive">
+            </sp-sidenav-item>
+        </sp-sidenav-item>
+        <sp-sidenav-item value="Typography" label="Typography">
+        </sp-sidenav-item>
+    </sp-sidenav-item>
+    <sp-sidenav-item value="Elements" label="Elements">
+    </sp-sidenav-item>
+    <sp-sidenav-item value="Patterns" label="Patterns">
+    </sp-sidenav-item>
+</sp-sidenav-itm>
+```
+
+## Icon
+
+```html
+<sp-sidenav>
+    <sp-sidenav-item value="Section Title 1" label="Section Title 1">
+        <sp-icon-star slot="icon"></sp-icon-star>
+    </sp-sidenav-item>
+    <sp-sidenav-item value="Section Title 2" label="Section Title 2">
+        <sp-icon-star slot="icon"></sp-icon-star>
+    </sp-sidenav-item>
+    <sp-sidenav-item value="Section Title 3" label="Section Title 3">
+        <sp-icon-star slot="icon"></sp-icon-star>
+    </sp-sidenav-item>
+</sp-sidenav>
+```
+
+## Heading
+
+```html
+<sp-sidenav variant="multilevel">
+    <sp-sidenav-item value="Section 1" label="Section 1"></sp-sidenav-item>
+    <sp-sidenav-item value="Section 2" label="Section 2"></sp-sidenav-item>
+    <sp-sidenav-heading label="Category 1">
+        <sp-sidenav-item value="Section 3" label="Section 3"></sp-sidenav-item>
+        <sp-sidenav-item value="Section 4" label="Section 4"></sp-sidenav-item>
+    </sp-sidenav-heading>
+    <sp-sidenav-heading label="Category 2">
+        <sp-sidenav-item value="Section 5" label="Section 5"></sp-sidenav-item>
+        <sp-sidenav-item value="Section 6" label="Section 6"></sp-sidenav-item>
+    </sp-sidenav-heading>
+</sp-sidenav>
+```
+
+## Accessibility
+
+When the `manage-tab-index` attribute is set on an `sp-sidenav` element then it will presents its child `sp-sidenav-item` children with a single tab-stop. This will leave items beyond the selected item, or first when there is no focusable selected item, will be accessibile via the up and down arrow keys.

package/package.json

@@ -0,0 +1,94 @@
+{
+    "name": "@spectrum-web-components/sidenav",
+    "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/sidenav"
+    },
+    "author": "",
+    "homepage": "https://opensource.adobe.com/spectrum-web-components/components/sidenav",
+    "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/Sidenav.js": {
+            "development": "./src/Sidenav.dev.js",
+            "default": "./src/Sidenav.js"
+        },
+        "./src/SidenavHeading.js": {
+            "development": "./src/SidenavHeading.dev.js",
+            "default": "./src/SidenavHeading.js"
+        },
+        "./src/SidenavItem.js": {
+            "development": "./src/SidenavItem.dev.js",
+            "default": "./src/SidenavItem.js"
+        },
+        "./src/index.js": {
+            "development": "./src/index.dev.js",
+            "default": "./src/index.js"
+        },
+        "./src/sidenav-heading-overrides.css.js": "./src/sidenav-heading-overrides.css.js",
+        "./src/sidenav-heading.css.js": "./src/sidenav-heading.css.js",
+        "./src/sidenav-item-overrides.css.js": "./src/sidenav-item-overrides.css.js",
+        "./src/sidenav-item.css.js": "./src/sidenav-item.css.js",
+        "./src/sidenav-overrides.css.js": "./src/sidenav-overrides.css.js",
+        "./src/sidenav.css.js": "./src/sidenav.css.js",
+        "./sp-sidenav.js": {
+            "development": "./sp-sidenav.dev.js",
+            "default": "./sp-sidenav.js"
+        },
+        "./sp-sidenav-heading.js": {
+            "development": "./sp-sidenav-heading.dev.js",
+            "default": "./sp-sidenav-heading.js"
+        },
+        "./sp-sidenav-item.js": {
+            "development": "./sp-sidenav-item.dev.js",
+            "default": "./sp-sidenav-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": {
+        "@spectrum-web-components/base": "0.0.0-20241209155954",
+        "@spectrum-web-components/reactive-controllers": "0.0.0-20241209155954",
+        "@spectrum-web-components/shared": "0.0.0-20241209155954"
+    },
+    "devDependencies": {
+        "@spectrum-css/sidenav": "^6.0.0-s2-foundations.15"
+    },
+    "types": "./src/index.d.ts",
+    "customElements": "custom-elements.json",
+    "sideEffects": [
+        "./sp-*.js",
+        "./**/*.dev.js"
+    ]
+}

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

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

package/sp-sidenav-heading.dev.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["sp-sidenav-heading.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 { SideNavHeading } from './src/SidenavHeading.dev.js'\nimport { defineElement } from '@spectrum-web-components/base/src/define-element.js';\n\ndefineElement('sp-sidenav-heading', SideNavHeading);\n\ndeclare global {\n    interface HTMLElementTagNameMap {\n        'sp-sidenav-heading': SideNavHeading;\n    }\n}\n"],
+  "mappings": ";AAWA,SAAS,sBAAsB;AAC/B,SAAS,qBAAqB;AAE9B,cAAc,sBAAsB,cAAc;",
+  "names": []
+}

package/sp-sidenav-heading.js

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

package/sp-sidenav-heading.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["sp-sidenav-heading.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 { SideNavHeading } from './src/SidenavHeading.js';\nimport { defineElement } from '@spectrum-web-components/base/src/define-element.js';\n\ndefineElement('sp-sidenav-heading', SideNavHeading);\n\ndeclare global {\n    interface HTMLElementTagNameMap {\n        'sp-sidenav-heading': SideNavHeading;\n    }\n}\n"],
+  "mappings": "aAWA,OAAS,kBAAAA,MAAsB,0BAC/B,OAAS,iBAAAC,MAAqB,sDAE9BA,EAAc,qBAAsBD,CAAc",
+  "names": ["SideNavHeading", "defineElement"]
+}

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

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

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

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["sp-sidenav-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 { SideNavItem } from './src/SidenavItem.dev.js'\nimport { defineElement } from '@spectrum-web-components/base/src/define-element.js';\n\ndefineElement('sp-sidenav-item', SideNavItem);\n\ndeclare global {\n    interface HTMLElementTagNameMap {\n        'sp-sidenav-item': SideNavItem;\n    }\n}\n"],
+  "mappings": ";AAWA,SAAS,mBAAmB;AAC5B,SAAS,qBAAqB;AAE9B,cAAc,mBAAmB,WAAW;",
+  "names": []
+}

package/sp-sidenav-item.js

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

package/sp-sidenav-item.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["sp-sidenav-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 { SideNavItem } from './src/SidenavItem.js';\nimport { defineElement } from '@spectrum-web-components/base/src/define-element.js';\n\ndefineElement('sp-sidenav-item', SideNavItem);\n\ndeclare global {\n    interface HTMLElementTagNameMap {\n        'sp-sidenav-item': SideNavItem;\n    }\n}\n"],
+  "mappings": "aAWA,OAAS,eAAAA,MAAmB,uBAC5B,OAAS,iBAAAC,MAAqB,sDAE9BA,EAAc,kBAAmBD,CAAW",
+  "names": ["SideNavItem", "defineElement"]
+}

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

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

package/sp-sidenav.dev.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["sp-sidenav.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 { SideNav } from './src/Sidenav.dev.js'\nimport { defineElement } from '@spectrum-web-components/base/src/define-element.js';\n\ndefineElement('sp-sidenav', SideNav);\n\ndeclare global {\n    interface HTMLElementTagNameMap {\n        'sp-sidenav': SideNav;\n    }\n}\n"],
+  "mappings": ";AAWA,SAAS,eAAe;AACxB,SAAS,qBAAqB;AAE9B,cAAc,cAAc,OAAO;",
+  "names": []
+}

package/sp-sidenav.js

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

package/sp-sidenav.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["sp-sidenav.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 { SideNav } from './src/Sidenav.js';\nimport { defineElement } from '@spectrum-web-components/base/src/define-element.js';\n\ndefineElement('sp-sidenav', SideNav);\n\ndeclare global {\n    interface HTMLElementTagNameMap {\n        'sp-sidenav': SideNav;\n    }\n}\n"],
+  "mappings": "aAWA,OAAS,WAAAA,MAAe,mBACxB,OAAS,iBAAAC,MAAqB,sDAE9BA,EAAc,aAAcD,CAAO",
+  "names": ["SideNav", "defineElement"]
+}

package/src/Sidenav.d.ts

@@ -0,0 +1,49 @@
+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;
+    /**
+     * The multilevel variant will have multiple layers of hierarchical navigation items.
+     */
+    variant?: 'multilevel';
+    /**
+     * An accessible label that describes the component,
+     * so that the side navigation can be distinguished
+     * from other navigation by screen reader users.
+     * It will be applied to aria-label, but not visually rendered.
+     */
+    label?: string | undefined;
+    private handleSelect;
+    focus(): void;
+    blur(): void;
+    click(): void;
+    get focusElement(): SideNavItem | SideNav;
+    private isDisabledChild;
+    private handleSlotchange;
+    protected render(): TemplateResult;
+    protected willUpdate(): void;
+    protected updated(changes: PropertyValues): void;
+}
+declare global {
+    interface GlobalEventHandlersEventMap {
+        'sp-sidenav:select': CustomEvent<SidenavSelectDetail>;
+    }
+}

package/src/Sidenav.dev.js

@@ -0,0 +1,167 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __decorateClass = (decorators, target, key, kind) => {
+  var result = kind > 1 ? void 0 : kind ? __getOwnPropDesc(target, key) : target;
+  for (var i = decorators.length - 1, decorator; i >= 0; i--)
+    if (decorator = decorators[i])
+      result = (kind ? decorator(target, key, result) : decorator(result)) || result;
+  if (kind && result) __defProp(target, key, result);
+  return result;
+};
+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.dev.js";
+import { SideNavHeading } from "./SidenavHeading.dev.js";
+import { ifDefined } from "@spectrum-web-components/base/src/directives.js";
+export class SideNav extends Focusable {
+  constructor() {
+    super(...arguments);
+    this.items = /* @__PURE__ */ new Set();
+    this.rovingTabindexController = new RovingTabindexController(this, {
+      focusInIndex: (elements) => {
+        let parentSideNavItem;
+        let index = elements.findIndex((el) => {
+          if (el.value === this.value && this.isDisabledChild(el)) {
+            parentSideNavItem = el.closest(
+              "sp-sidenav-item:not([expanded])"
+            );
+          }
+          return this.value ? !el.disabled && !this.isDisabledChild(el) && el.value === this.value : !el.disabled && !this.isDisabledChild(el);
+        });
+        if (index === -1 && parentSideNavItem) {
+          index = elements.findIndex((el) => el === parentSideNavItem);
+        }
+        return index;
+      },
+      direction: "vertical",
+      elements: () => [...this.querySelectorAll("sp-sidenav-item")],
+      isFocusableElement: (el) => !el.disabled && !this.isDisabledChild(el)
+    });
+    this.manageTabIndex = false;
+    this.value = void 0;
+    this.variant = void 0;
+    this.label = void 0;
+  }
+  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}
+                aria-label=${ifDefined(this.label)}
+            >
+                <div role="list">
+                    <slot
+                        name="descendant"
+                        @slotchange=${this.handleSlotchange}
+                    ></slot>
+                </div>
+            </nav>
+        `;
+  }
+  willUpdate() {
+    if (!this.hasUpdated) {
+      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();
+      }
+    }
+  }
+}
+__decorateClass([
+  property({ type: Boolean, reflect: true, attribute: "manage-tab-index" })
+], SideNav.prototype, "manageTabIndex", 2);
+__decorateClass([
+  property({ reflect: true })
+], SideNav.prototype, "value", 2);
+__decorateClass([
+  property({ reflect: true })
+], SideNav.prototype, "variant", 2);
+__decorateClass([
+  property({ reflect: true })
+], SideNav.prototype, "label", 2);
+//# sourceMappingURL=Sidenav.dev.js.map

package/src/Sidenav.dev.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["Sidenav.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*/\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.dev.js'\nimport { SideNavHeading } from './SidenavHeading.dev.js'\nimport { ifDefined } from '@spectrum-web-components/base/src/directives.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 override 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            let parentSideNavItem: SideNavItem | undefined;\n            let index = elements.findIndex((el) => {\n                // If the selected item's parent is collapsed, save it for later.\n                if (el.value === this.value && this.isDisabledChild(el)) {\n                    parentSideNavItem = el.closest(\n                        'sp-sidenav-item:not([expanded])'\n                    ) as SideNavItem;\n                }\n                return this.value\n                    ? !el.disabled &&\n                          !this.isDisabledChild(el) &&\n                          el.value === this.value\n                    : !el.disabled && !this.isDisabledChild(el);\n            });\n            // If the selected item's parent is collapsed, focus the collapsed parent.\n            if (index === -1 && parentSideNavItem) {\n                index = elements.findIndex((el) => el === parentSideNavItem);\n            }\n            return index;\n        },\n        direction: 'vertical',\n        elements: () =>\n            [...this.querySelectorAll('sp-sidenav-item')] as SideNavItem[],\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    /**\n     * The multilevel variant will have multiple layers of hierarchical navigation items.\n     */\n    @property({ reflect: true })\n    public variant?: 'multilevel' = undefined;\n\n    /**\n     * An accessible label that describes the component,\n     * so that the side navigation can be distinguished\n     * from other navigation by screen reader users.\n     * It will be applied to aria-label, but not visually rendered.\n     */\n    @property({ reflect: true })\n    public label?: 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 override focus(): void {\n        this.rovingTabindexController.focus();\n    }\n\n    public override blur(): void {\n        if (this.focusElement === this) {\n            return;\n        }\n\n        super.blur();\n    }\n\n    public override click(): void {\n        if (this.focusElement === this) {\n            return;\n        }\n\n        super.click();\n    }\n\n    public override 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 override render(): TemplateResult {\n        return html`\n            <nav\n                @sidenav-select=${this.handleSelect}\n                aria-label=${ifDefined(this.label)}\n            >\n                <div role=\"list\">\n                    <slot\n                        name=\"descendant\"\n                        @slotchange=${this.handleSlotchange}\n                    ></slot>\n                </div>\n            </nav>\n        `;\n    }\n\n    protected override willUpdate(): void {\n        if (!this.hasUpdated) {\n            const selectedChild = this.querySelector(\n                '[selected]'\n            ) as SideNavItem;\n            if (selectedChild) {\n                this.value = selectedChild.value;\n            }\n        }\n    }\n\n    protected override 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"],
+  "mappings": "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",
+  "names": []
+}

package/src/Sidenav.js

@@ -0,0 +1,14 @@
+"use strict";var o=Object.defineProperty;var u=Object.getOwnPropertyDescriptor;var r=(d,l,e,t)=>{for(var a=t>1?void 0:t?u(l,e):l,i=d.length-1,s;i>=0;i--)(s=d[i])&&(a=(t?s(l,e,a):s(a))||a);return t&&a&&o(l,e,a),a};import{html as v}from"@spectrum-web-components/base";import{property as n}from"@spectrum-web-components/base/src/decorators.js";import{RovingTabindexController as c}from"@spectrum-web-components/reactive-controllers/src/RovingTabindex.js";import m from"./sidenav.css.js";import{Focusable as p}from"@spectrum-web-components/shared";import{SideNavItem as h}from"./SidenavItem.js";import{SideNavHeading as b}from"./SidenavHeading.js";import{ifDefined as f}from"@spectrum-web-components/base/src/directives.js";export class SideNav extends p{constructor(){super(...arguments);this.items=new Set;this.rovingTabindexController=new c(this,{focusInIndex:e=>{let t,a=e.findIndex(i=>(i.value===this.value&&this.isDisabledChild(i)&&(t=i.closest("sp-sidenav-item:not([expanded])")),this.value?!i.disabled&&!this.isDisabledChild(i)&&i.value===this.value:!i.disabled&&!this.isDisabledChild(i)));return a===-1&&t&&(a=e.findIndex(i=>i===t)),a},direction:"vertical",elements:()=>[...this.querySelectorAll("sp-sidenav-item")],isFocusableElement:e=>!e.disabled&&!this.isDisabledChild(e)});this.manageTabIndex=!1;this.value=void 0;this.variant=void 0;this.label=void 0}static get styles(){return[m]}startTrackingSelectionForItem(e){this.items.add(e),this.rovingTabindexController.clearElementCache()}stopTrackingSelectionForItem(e){this.items.delete(e),this.rovingTabindexController.clearElementCache()}handleSelect(e){if(e.stopPropagation(),this.value===e.detail.value)return;const t=this.value;this.value=e.detail.value,this.dispatchEvent(new Event("change",{bubbles:!0,composed:!0,cancelable:!0}))?this.items.forEach(i=>i.handleSideNavSelect(e)):(this.value=t,e.target.selected=!1,e.preventDefault())}focus(){this.rovingTabindexController.focus()}blur(){this.focusElement!==this&&super.blur()}click(){this.focusElement!==this&&super.click()}get focusElement(){return this.rovingTabindexController.focusInElement||this}isDisabledChild(e){if(e.disabled)return!0;let t=e.parentElement;for(;t instanceof b||!t.disabled&&t instanceof h&&t.expanded;)t=t.parentElement;return t!==this}handleSlotchange(){this.manageTabIndex?this.rovingTabindexController.manage():this.rovingTabindexController.unmanage()}render(){return v`
+            <nav
+                @sidenav-select=${this.handleSelect}
+                aria-label=${f(this.label)}
+            >
+                <div role="list">
+                    <slot
+                        name="descendant"
+                        @slotchange=${this.handleSlotchange}
+                    ></slot>
+                </div>
+            </nav>
+        `}willUpdate(){if(!this.hasUpdated){const e=this.querySelector("[selected]");e&&(this.value=e.value)}}updated(e){super.updated(e),e.has("manageTabIndex")&&(this.manageTabIndex?this.rovingTabindexController.manage():this.rovingTabindexController.unmanage())}}r([n({type:Boolean,reflect:!0,attribute:"manage-tab-index"})],SideNav.prototype,"manageTabIndex",2),r([n({reflect:!0})],SideNav.prototype,"value",2),r([n({reflect:!0})],SideNav.prototype,"variant",2),r([n({reflect:!0})],SideNav.prototype,"label",2);
+//# sourceMappingURL=Sidenav.js.map