@hashicorp/design-system-components 4.13.0 → 4.14.0

package/dist/styles/components/app-side-nav/main.scss

@@ -0,0 +1,147 @@
+/**
+ * Copyright (c) HashiCorp, Inc.
+ * SPDX-License-Identifier: MPL-2.0
+ */
+
+//
+// APP-SIDE-NAV
+//
+
+.hds-app-side-nav {
+  position: relative;
+  width: var(--hds-app-side-nav-width-fixed); // "default" width used by the `AppSideNav::Base` subcomponent (that is not responsive)
+  height: 100%;
+  min-height: 100%;
+  isolation: isolate; // used to create a new stacking context (so we can set the overlay's z-index to -1)
+
+  // RESPONSIVENESS - This controls the width of the top-level container ("sidebar") in the grid, and impacts the available space for the "main" grid area
+
+  &.hds-app-side-nav--is-responsive {
+    transition:
+      width var(--hds-app-side-nav-animation-duration)
+      var(--hds-app-side-nav-animation-easing);
+  }
+
+  // mobile
+  &.hds-app-side-nav--is-mobile {
+    width: var(--hds-app-side-nav-width-minimized);
+  }
+
+  // desktop
+  &.hds-app-side-nav--is-desktop {
+    &.hds-app-side-nav--is-not-minimized {
+      width: var(--hds-app-side-nav-width-expanded);
+    }
+
+    &.hds-app-side-nav--is-minimized {
+      width: var(--hds-app-side-nav-width-minimized);
+    }
+  }
+}
+
+// OVERLAY
+
+.hds-app-side-nav__overlay {
+  position: fixed;
+  z-index: -1;
+  inset: 0;
+  background-color: var(--token-color-palette-neutral-700);
+  opacity: 0.2;
+  transition:
+    opacity var(--hds-app-side-nav-animation-duration)
+    var(--hds-app-side-nav-animation-easing)
+    var(--hds-app-side-nav-animation-delay);
+
+  // when we're minimized (mobile) we don't want the overlay to be visible/interactive
+  .hds-app-side-nav--is-minimized & {
+    opacity: 0;
+    pointer-events: none;
+  }
+
+  // when it's desktop we _never_ want the overlay to be visible
+  .hds-app-side-nav--is-desktop & {
+    display: none;
+  }
+}
+
+// RESPONSIVE WRAPPER
+// this container element is used to control the width of the sidebar at different viewports (desktop/mobile) and states (minimized/expanded)
+
+.hds-app-side-nav__wrapper {
+  display: flex;
+  flex-direction: column;
+  height: 100%;
+  color: var(--token-app-side-nav-color-foreground-primary); // we set a default color (in case generic content is added to the body of the appsidenav)
+  background: var(--token-app-side-nav-color-surface-primary);
+  border-right: var(--token-app-side-nav-wrapper-border-width) solid var(--token-app-side-nav-wrapper-border-color);
+
+  // RESPONSIVENESS - This controls the width of the "sidenav" container, and is independent (bur related) from the parent "sidebar" grid area
+
+  .hds-app-side-nav--is-responsive & {
+    transition:
+      width var(--hds-app-side-nav-animation-duration)
+      var(--hds-app-side-nav-animation-easing);
+  }
+
+  .hds-app-side-nav--is-minimized & {
+    width: var(--hds-app-side-nav-width-minimized);
+  }
+
+  .hds-app-side-nav--is-not-minimized & {
+    width: var(--hds-app-side-nav-width-expanded);
+  }
+}
+
+// wrapper's child "containers"
+
+.hds-app-side-nav__wrapper-body {
+  flex: 1;
+  padding:
+    var(--token-app-side-nav-wrapper-padding-vertical)
+    var(--token-app-side-nav-wrapper-padding-horizontal);
+  // this is necessary, otherwise when the sidenav is minimized an horizontal scrollbar may appear
+  // (if there are words longer than the width of the available space for the list "item" content)
+  overflow-x: hidden;
+  // we want the content to vertically scroll if needed
+  overflow-y: auto;
+}
+
+// "HIDE-WHEN-MINIMIZED" SPECIAL CLASS
+// this is a special class that is used to control which elements of the sidenav need to be:
+// - hidden (immediately) when the sidenav is "minimized"
+// - shown (transitioning their opacity) when the sidenav is "expanded"
+
+.hds-app-side-nav-hide-when-minimized {
+  .hds-app-side-nav--is-minimized & {
+    visibility: hidden !important; // we need `!important` here to override the inline style applied to the single panels
+    opacity: 0;
+    // this is needed because, despite the element having `visibility: hidden`,
+    // the child elements ("panels") have their visibility dynamically managed via JS
+    // and when they have "visibility: visible" applied, they are not visually visible
+    // (because of the `opacity: 0` of the parent) but the user can still interact with them
+    // and click on the links inside the sidenav even if they're not visible at all,
+    // so we have to block the interactivity of the whole container
+    // for reference see these PRs:
+    // - https://github.com/hashicorp/design-system/pull/1338
+    // - https://github.com/hashicorp/design-system/pull/1388
+    // - https://github.com/hashicorp/design-system/pull/1516
+    // and this codepen with a redux of the problem:
+    // - https://codepen.io/didoo/pen/mdQKMJW?editors=1100
+    pointer-events: none;
+  }
+
+  .hds-app-side-nav--is-not-minimized & {
+    visibility: visible;
+    opacity: 1;
+    transition:
+      opacity var(--hds-app-side-nav-animation-duration)
+      var(--hds-app-side-nav-animation-easing)
+      var(--hds-app-side-nav-animation-delay);
+  }
+
+  // we want to avoid accidental interactions with the navigation elements while the sidenav is animating its width
+  // (elements with `visibility: visible` can already be interacted with, while their opacity is transitioning)
+  .hds-app-side-nav--is-animating & {
+    pointer-events: none;
+  }
+}

package/dist/styles/components/app-side-nav/toggle-button.scss

@@ -0,0 +1,101 @@
+/**
+ * Copyright (c) HashiCorp, Inc.
+ * SPDX-License-Identifier: MPL-2.0
+ */
+
+//
+// APP-SIDE-NAV > TOGGLE BUTTON
+//
+
+
+.hds-app-side-nav__toggle-button {
+  position: absolute;
+  top: var(--token-app-side-nav-wrapper-padding-vertical); // visually align with :header content
+  left: calc(var(--token-app-side-nav-wrapper-border-width) * -1);
+  z-index: 1;
+  display: flex;
+  flex-direction: row-reverse;
+  align-items: center;
+  width: var(--hds-app-side-nav-toggle-button-width);
+  height: 36px;
+  padding: 0 4px;
+  color: var(--token-color-foreground-primary);
+  background: none;
+  background-color: var(--token-app-side-nav-color-surface-primary);
+  border: var(--token-app-side-nav-wrapper-border-width) solid var(--token-app-side-nav-wrapper-border-color);
+  border-left-color: transparent;
+  border-top-right-radius: var(--token-app-side-nav-toggle-button-border-radius);
+  border-bottom-right-radius: var(--token-app-side-nav-toggle-button-border-radius);
+  transform: translateX(var(--hds-app-side-nav-width-expanded));
+  cursor: pointer;
+  transition:
+    transform var(--hds-app-side-nav-animation-duration)
+    var(--hds-app-side-nav-animation-easing),
+    width var(--hds-app-side-nav-animation-duration)
+    var(--hds-app-side-nav-animation-easing);
+
+  &::before {
+    position: absolute;
+    top: calc(var(--token-app-side-nav-toggle-button-border-radius) * -2);
+    left: calc(var(--token-app-side-nav-wrapper-border-width) * -1);
+    box-sizing: border-box;
+    width: calc(var(--token-app-side-nav-toggle-button-border-radius) * 2);
+    height: calc(var(--token-app-side-nav-toggle-button-border-radius) * 2);
+    border-bottom: var(--token-app-side-nav-wrapper-border-width) solid var(--token-app-side-nav-wrapper-border-color);
+    border-left: var(--token-app-side-nav-wrapper-border-width) solid var(--token-app-side-nav-wrapper-border-color);
+    border-bottom-left-radius: var(--token-app-side-nav-toggle-button-border-radius);
+    box-shadow: 0 var(--token-app-side-nav-toggle-button-border-radius) 0 var(--token-app-side-nav-color-surface-primary);
+    content: "";
+  }
+
+  &::after {
+    position: absolute;
+    bottom: calc(var(--token-app-side-nav-toggle-button-border-radius) * -2);
+    left: calc(var(--token-app-side-nav-wrapper-border-width) * -1);
+    box-sizing: border-box;
+    width: calc(var(--token-app-side-nav-toggle-button-border-radius) * 2);
+    height: calc(var(--token-app-side-nav-toggle-button-border-radius) * 2);
+    border-bottom: var(--token-app-side-nav-wrapper-border-width) solid var(--token-app-side-nav-wrapper-border-color);
+    border-left: var(--token-app-side-nav-wrapper-border-width) solid var(--token-app-side-nav-wrapper-border-color);
+    border-bottom-left-radius: var(--token-app-side-nav-toggle-button-border-radius);
+    box-shadow: 0 var(--token-app-side-nav-toggle-button-border-radius) 0 var(--token-app-side-nav-color-surface-primary);
+    transform: scaleY(-1); // rotate so same clip path can be used
+    content: "";
+  }
+
+  &:hover,
+  &.mock-hover {
+    width: 30px;
+    background-color: var(--token-app-side-nav-color-surface-interactive-hover);
+
+    &::before,
+    &::after {
+      box-shadow: 0 var(--token-app-side-nav-toggle-button-border-radius) 0 var(--token-app-side-nav-color-surface-interactive-hover);
+    }
+  }
+
+  &:active,
+  &.mock-active {
+    background-color: var(--token-app-side-nav-color-surface-interactive-active);
+
+    &::before,
+    &::after {
+      box-shadow: 0 var(--token-app-side-nav-toggle-button-border-radius) 0 var(--token-app-side-nav-color-surface-interactive-active);
+    }
+  }
+
+  &:focus-visible,
+  &.mock-focus {
+    border-color: var(--token-color-focus-action-internal);
+    outline: 3px solid var(--token-color-focus-action-external);
+
+    &::before,
+    &::after {
+      display: none;
+    }
+  }
+
+  .hds-app-side-nav--is-minimized & {
+    transform: translateX(var(--hds-app-side-nav-width-minimized));
+  }
+}

package/dist/styles/components/app-side-nav/vars.scss

@@ -0,0 +1,36 @@
+/**
+ * Copyright (c) HashiCorp, Inc.
+ * SPDX-License-Identifier: MPL-2.0
+ */
+
+//
+// APP-SIDE-NAV - VARS
+//
+
+
+// LOCAL VARIABLES
+// we use `hds-app` as prefix to distinguish them from the normal tokens
+// notice: they may be overwritten at consumer-level side if needed by re-defining the variables in a container element
+
+:root {
+  // breakpoint
+  --hds-app-desktop-breakpoint: 1088px; // this is used only to read its value via JS and set the `hds-app-side-nav--is-desktop` class
+  // widths
+  --hds-app-side-nav-width-minimized: 16px;
+  --hds-app-side-nav-width-expanded: 280px;
+  --hds-app-side-nav-width-fixed: var(--hds-app-sidenav-width-expanded);
+  // animation
+  --hds-app-side-nav-animation-duration: 200ms;
+  --hds-app-side-nav-animation-delay: var(--hds-app-sidenav-animation-duration);
+  --hds-app-side-nav-animation-easing: cubic-bezier(0.65, 0, 0.35, 1);
+  // toggle-button
+  --hds-app-side-nav-toggle-button-width: 24px;
+}
+
+// reduced motion
+
+@media (prefers-reduced-motion) {
+  :root {
+    --hds-app-side-nav-animation-duration: 0;
+  }
+}

package/dist/styles/components/dropdown.scss

@@ -136,6 +136,12 @@ $hds-dropdown-toggle-border-radius: $hds-button-border-radius;
 
 .hds-dropdown-toggle-button--size-small {
   padding-right: 0.375rem;
+
+  // For small variant with chevron, force the icon size to custom (even if the SGV size is `16px`)
+  .hds-dropdown-toggle-chevron .hds-icon {
+    width: 12px;
+    height: 12px;
+  }
 }
 
 .hds-dropdown-toggle-button--size-medium {

package/dist/styles/components/side-nav/content.scss

@@ -35,6 +35,11 @@
 
 .hds-side-nav__content-panel {
   padding: 0 var(--token-side-nav-wrapper-padding-horizontal);
+  overflow: hidden; // the panel itself does not need to be scrollable
+
+  &[aria-hidden="true"] {
+    max-height: 0; // prevents hidden panels from causing scrolling
+  }
 }
 
 // (LIST) TITLE

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hashicorp/design-system-components",
-  "version": "4.13.0",
+  "version": "4.14.0",
   "description": "Helios Design System Components",
   "keywords": [
     "hashicorp",
@@ -42,6 +42,7 @@
     "@floating-ui/dom": "^1.6.3",
     "@hashicorp/design-system-tokens": "^2.2.1",
     "@hashicorp/flight-icons": "^3.7.0",
+    "clipboard-polyfill": "^4.1.0",
     "decorator-transforms": "^1.1.0",
     "ember-a11y-refocus": "^4.1.3",
     "ember-cli-sass": "^11.0.1",
@@ -86,6 +87,7 @@
     "concurrently": "^8.2.2",
     "ember-basic-dropdown": "^8.1.0",
     "ember-concurrency": "^4.0.2",
+    "ember-source": "~5.9.0",
     "ember-template-lint": "^6.0.0",
     "ember-template-lint-plugin-prettier": "^5.0.0",
     "eslint": "^8.57.0",
@@ -95,8 +97,9 @@
     "eslint-plugin-n": "^17.7.0",
     "eslint-plugin-prettier": "^5.1.3",
     "eslint-plugin-qunit": "^8.1.1",
+    "postcss": "^8.4.47",
     "prettier": "^3.3.2",
-    "rollup": "^4.17.2",
+    "rollup": "^4.22.4",
     "rollup-plugin-copy": "^3.5.0",
     "rollup-plugin-scss": "^4.0.0",
     "rollup-plugin-ts": "^3.4.5",
@@ -134,9 +137,6 @@
       "./components/hds/app-frame/parts/main.js": "./dist/_app_/components/hds/app-frame/parts/main.js",
       "./components/hds/app-frame/parts/modals.js": "./dist/_app_/components/hds/app-frame/parts/modals.js",
       "./components/hds/app-frame/parts/sidebar.js": "./dist/_app_/components/hds/app-frame/parts/sidebar.js",
-      "./components/hds/app-header/home-link.js": "./dist/_app_/components/hds/app-header/home-link.js",
-      "./components/hds/app-header/index.js": "./dist/_app_/components/hds/app-header/index.js",
-      "./components/hds/app-header/menu-button.js": "./dist/_app_/components/hds/app-header/menu-button.js",
       "./components/hds/application-state/body.js": "./dist/_app_/components/hds/application-state/body.js",
       "./components/hds/application-state/footer.js": "./dist/_app_/components/hds/application-state/footer.js",
       "./components/hds/application-state/header.js": "./dist/_app_/components/hds/application-state/header.js",

package/dist/_app_/components/hds/app-header/home-link.js

@@ -1 +0,0 @@
-export { default } from "@hashicorp/design-system-components/components/hds/app-header/home-link";

package/dist/_app_/components/hds/app-header/index.js

@@ -1 +0,0 @@
-export { default } from "@hashicorp/design-system-components/components/hds/app-header/index";

package/dist/_app_/components/hds/app-header/menu-button.js

@@ -1 +0,0 @@
-export { default } from "@hashicorp/design-system-components/components/hds/app-header/menu-button";