@hashicorp/design-system-components 2.8.1 → 2.10.0

package/CHANGELOG.md

@@ -1,16 +1,62 @@
 # @hashicorp/design-system-components
 
+## 2.10.0
+
+### Minor Changes
+
+- [#1535](https://github.com/hashicorp/design-system/pull/1535) [`2daa95479`](https://github.com/hashicorp/design-system/commit/2daa95479307fea0b94b2af413126d09525462c8) Thanks [@KristinLBradley](https://github.com/KristinLBradley)! - Add new `FileInput` component
+
+### Patch Changes
+
+- [#1570](https://github.com/hashicorp/design-system/pull/1570) [`7bf297996`](https://github.com/hashicorp/design-system/commit/7bf297996e06a15cb2506bfb23f43d71ecc9b492) Thanks [@Dhaulagiri](https://github.com/Dhaulagiri)! - Remove unnecessary export of `hds/copy/index.js`
+
+- [#1575](https://github.com/hashicorp/design-system/pull/1575) [`0362019ca`](https://github.com/hashicorp/design-system/commit/0362019ca043ef955364f18b23dbcd36f0bfb2bf) Thanks [@alex-ju](https://github.com/alex-ju)! - `Hds::Tabs` - Fix missing tab indicator when used in Modal or Flyout
+
+- [#1567](https://github.com/hashicorp/design-system/pull/1567) [`384faeec2`](https://github.com/hashicorp/design-system/commit/384faeec244011f8090f3bcce0def89da1563164) Thanks [@MelSumner](https://github.com/MelSumner)! - Add support for container in Copy::Snippet and update API docs
+
+- [#1571](https://github.com/hashicorp/design-system/pull/1571) [`8ad8a5908`](https://github.com/hashicorp/design-system/commit/8ad8a59080d0c0c855f2f746f0a10ddf4440e461) Thanks [@alex-ju](https://github.com/alex-ju)! - `Hds::Tabs` - Fix tabs and panels misbehaving on route change
+
+- [#1568](https://github.com/hashicorp/design-system/pull/1568) [`dbe2e437d`](https://github.com/hashicorp/design-system/commit/dbe2e437d7d465cda3b69c7a28b01cbfb2849b79) Thanks [@MelSumner](https://github.com/MelSumner)! - Update error icon for copy components
+
+- [#1555](https://github.com/hashicorp/design-system/pull/1555) [`90a615161`](https://github.com/hashicorp/design-system/commit/90a61516156ea58898febaa5bd66b31386256151) Thanks [@alex-ju](https://github.com/alex-ju)! - `Hds::SegmentedGroup` - prevent `border-radius` from interfering with underlying elements
+
+- [#1565](https://github.com/hashicorp/design-system/pull/1565) [`60154db1a`](https://github.com/hashicorp/design-system/commit/60154db1a00f877b2c3bc4a9c4069556e8af809b) Thanks [@MelSumner](https://github.com/MelSumner)! - Resolved issue where ThSort was not supporting right-aligned text properly
+
+- Updated dependencies [[`8b8d6bcfa`](https://github.com/hashicorp/design-system/commit/8b8d6bcfa67efa5de1a2cc419167a962e747a8c9)]:
+  - @hashicorp/ember-flight-icons@3.1.0
+
+## 2.9.0
+
+### Minor Changes
+
+- [#1488](https://github.com/hashicorp/design-system/pull/1488) [`372bae36d`](https://github.com/hashicorp/design-system/commit/372bae36d87377dc87aa18ed39c7834a4cc545f4) Thanks [@MelSumner](https://github.com/MelSumner)! - Adds the `Hds::CopyButton` and `Hds::CopySnippet` components.
+
+### Patch Changes
+
+- [#1539](https://github.com/hashicorp/design-system/pull/1539) [`9d3f29a42`](https://github.com/hashicorp/design-system/commit/9d3f29a42e8130b2155498a7c3cb77a6da279a68) Thanks [@Dhaulagiri](https://github.com/Dhaulagiri)! - Adjusted closing brace on copywrite headers to avoid terminal noise
+
+- [#1549](https://github.com/hashicorp/design-system/pull/1549) [`a6553ea03`](https://github.com/hashicorp/design-system/commit/a6553ea032f70f0167f149589801b72154c3cf75) Thanks [@fivetanley](https://github.com/fivetanley)! - `Hds::Modal` - reduce test flakiness around closing Modal when using `@ember/test-helpers`
+
+- [#1530](https://github.com/hashicorp/design-system/pull/1530) [`b757e6efb`](https://github.com/hashicorp/design-system/commit/b757e6efb4c115abcd604bc4ef155f731f118c72) Thanks [@alex-ju](https://github.com/alex-ju)! - Fix Embroider warnings caused by incorrect export of internal utility functions
+
+- [#1552](https://github.com/hashicorp/design-system/pull/1552) [`865ff7aad`](https://github.com/hashicorp/design-system/commit/865ff7aad593bddf6f16bfdb1210318bedfa4e22) Thanks [@alex-ju](https://github.com/alex-ju)! - `Hds::Flyout` - reduce test flakiness around closing Flyout when using `@ember/test-helpers`
+
+- [#1529](https://github.com/hashicorp/design-system/pull/1529) [`1433fe098`](https://github.com/hashicorp/design-system/commit/1433fe0988b9c4e0d280ac450e6688e5d606630d) Thanks [@alex-ju](https://github.com/alex-ju)! - `Hds::Form::Field` - Fix error message for unexpected `@layout` values
+
+- Updated dependencies []:
+  - @hashicorp/ember-flight-icons@3.0.9
+
 ## 2.8.1
 
 ### Patch Changes
 
-- [#1516](https://github.com/hashicorp/design-system/pull/1516) [`f2192cad7`](https://github.com/hashicorp/design-system/commit/f2192cad73b6d966bf813f54dcee02e157c76392) Thanks [@didoo](https://github.com/didoo)! - `SideNav` - Fixed issue with links still being interactive (even if visually hidden) when the navigation is "minimized"
+- [#1516](https://github.com/hashicorp/design-system/pull/1516) [`f2192cad7`](https://github.com/hashicorp/design-system/commit/f2192cad73b6d966bf813f54dcee02e157c76392) Thanks [@didoo](https://github.com/didoo)! - `Hds::SideNav` - Fixed issue with links still being interactive (even if visually hidden) when the navigation is "minimized"
 
-- [#1518](https://github.com/hashicorp/design-system/pull/1518) [`5fd48e31e`](https://github.com/hashicorp/design-system/commit/5fd48e31ed3241ee19a8226bb28fa04ad79479c5) Thanks [@didoo](https://github.com/didoo)! - `PageHeader` - Fixed overflow of non-breaking text for `title`, `subtitle` and `description` elements
+- [#1518](https://github.com/hashicorp/design-system/pull/1518) [`5fd48e31e`](https://github.com/hashicorp/design-system/commit/5fd48e31ed3241ee19a8226bb28fa04ad79479c5) Thanks [@didoo](https://github.com/didoo)! - `Hds::PageHeader` - Fixed overflow of non-breaking text for `title`, `subtitle` and `description` elements
 
-- [#1494](https://github.com/hashicorp/design-system/pull/1494) [`169a85b63`](https://github.com/hashicorp/design-system/commit/169a85b6348649bc0e2411f3ab6f6a086eecb692) Thanks [@natmegs](https://github.com/natmegs)! - `Form::TextInput` - Add support for datetime-local type
+- [#1494](https://github.com/hashicorp/design-system/pull/1494) [`169a85b63`](https://github.com/hashicorp/design-system/commit/169a85b6348649bc0e2411f3ab6f6a086eecb692) Thanks [@natmegs](https://github.com/natmegs)! - `Hds::Form::TextInput` - Add support for `datetime-local` type
 
-- [#1500](https://github.com/hashicorp/design-system/pull/1500) [`b6c2867a4`](https://github.com/hashicorp/design-system/commit/b6c2867a4b7d1c183e9a17d16208ed12ce1aa43f) Thanks [@didoo](https://github.com/didoo)! - - `SideNav` - updated layout styling for the `SideNav::List::Title` element
+- [#1500](https://github.com/hashicorp/design-system/pull/1500) [`b6c2867a4`](https://github.com/hashicorp/design-system/commit/b6c2867a4b7d1c183e9a17d16208ed12ce1aa43f) Thanks [@didoo](https://github.com/didoo)! - `Hds::SideNav` - updated layout styling for the `SideNav::List::Title` element
 
 - [#1520](https://github.com/hashicorp/design-system/pull/1520) [`7f7ec22c3`](https://github.com/hashicorp/design-system/commit/7f7ec22c387ac9df05d05de31e5c2b45d6324777) Thanks [@alex-ju](https://github.com/alex-ju)! - Upgrade `ember-style-modifier` to `3.0.1`
 
@@ -22,15 +68,15 @@
 
 ### Minor Changes
 
-- [#1492](https://github.com/hashicorp/design-system/pull/1492) [`a17e5b2ac`](https://github.com/hashicorp/design-system/commit/a17e5b2acf66493ccbb68a623a3b7ba2fd5ab5a8) Thanks [@KristinLBradley](https://github.com/KristinLBradley)! - `Card` - Updated default value of `@overflow` argument to `"visible"` to address an area of consumer confusion and better support the most common use cases.
+- [#1492](https://github.com/hashicorp/design-system/pull/1492) [`a17e5b2ac`](https://github.com/hashicorp/design-system/commit/a17e5b2acf66493ccbb68a623a3b7ba2fd5ab5a8) Thanks [@KristinLBradley](https://github.com/KristinLBradley)! - `Hds::Card` - Updated default value of `@overflow` argument to `"visible"` to address an area of consumer confusion and better support the most common use cases.
 
-  Technically, this is a breaking change as it will require consumers relying upon the previous `hidden` default value to now manually set the value. The result of not setting the a `"hidden"` value can cause square edges of some images to "stick out" and overlap the rounded corners of the Card itself. We considered this to be a fairly minor, low-impact issue however which would not affect functionality or usability.
+  Technically, this is a breaking change as it will require consumers relying upon the previous `hidden` default value to now manually set the value. The result of not setting the a `hidden` value can cause square edges of some images to "stick out" and overlap the rounded corners of the Card itself. We considered this to be a fairly minor, low-impact issue however which would not affect functionality or usability.
 
-- [#1452](https://github.com/hashicorp/design-system/pull/1452) [`c277d0366`](https://github.com/hashicorp/design-system/commit/c277d036673cf572c00ebf5b8b35b424c0b057fd) Thanks [@alex-ju](https://github.com/alex-ju)! - `Form::TextInput` - Add loading state on "search" type
+- [#1452](https://github.com/hashicorp/design-system/pull/1452) [`c277d0366`](https://github.com/hashicorp/design-system/commit/c277d036673cf572c00ebf5b8b35b424c0b057fd) Thanks [@alex-ju](https://github.com/alex-ju)! - `Hds::Form::TextInput` - Add loading state on "search" type
 
-- [#1468](https://github.com/hashicorp/design-system/pull/1468) [`b0a766ccf`](https://github.com/hashicorp/design-system/commit/b0a766ccf5357dd6f0e8dfb68d8c1ee823e76b50) Thanks [@alex-ju](https://github.com/alex-ju)! - Added `MaskedInput` component for forms
+- [#1468](https://github.com/hashicorp/design-system/pull/1468) [`b0a766ccf`](https://github.com/hashicorp/design-system/commit/b0a766ccf5357dd6f0e8dfb68d8c1ee823e76b50) Thanks [@alex-ju](https://github.com/alex-ju)! - Add `Hds::Form::MaskedInput` component
 
-- [#1423](https://github.com/hashicorp/design-system/pull/1423) [`5ac340c8c`](https://github.com/hashicorp/design-system/commit/5ac340c8c3a3adab388704067578cf419e2e2f10) Thanks [@KristinLBradley](https://github.com/KristinLBradley)! - Add new `Accordion` component
+- [#1423](https://github.com/hashicorp/design-system/pull/1423) [`5ac340c8c`](https://github.com/hashicorp/design-system/commit/5ac340c8c3a3adab388704067578cf419e2e2f10) Thanks [@KristinLBradley](https://github.com/KristinLBradley)! - Add `Hds::Accordion` component
 
 ### Patch Changes
 
@@ -78,7 +124,7 @@
 
 - [#1426](https://github.com/hashicorp/design-system/pull/1426) [`1f8886a2d`](https://github.com/hashicorp/design-system/commit/1f8886a2d5117d74a0dddd4bca4a09d9fcedc8da) Thanks [@MelSumner](https://github.com/MelSumner)! - Style tweaks to standalone link
 
-- [#1434](https://github.com/hashicorp/design-system/pull/1434) [`eadefc4bd`](https://github.com/hashicorp/design-system/commit/eadefc4bdb4e5fd6c110a7be1d7d9aa720695678) Thanks [@alex-ju](https://github.com/alex-ju)! - Fix scroll management on `Modal` and `Flyout` resulting in stray `style` attribute on `<body>` element
+- [#1434](https://github.com/hashicorp/design-system/pull/1434) [`eadefc4bd`](https://github.com/hashicorp/design-system/commit/eadefc4bdb4e5fd6c110a7be1d7d9aa720695678) Thanks [@alex-ju](https://github.com/alex-ju)! - Fix scroll management on `Hds::Modal` and `Hds::Flyout` resulting in stray `style` attribute on `<body>` element
 
 - Updated dependencies [[`e6e0c22c5`](https://github.com/hashicorp/design-system/commit/e6e0c22c538e381f4a97428dc35cf1295ce6ae21)]:
   - @hashicorp/ember-flight-icons@3.0.6

package/addon/components/hds/accordion/item/button.hbs

@@ -1,7 +1,7 @@
 {{!
   Copyright (c) HashiCorp, Inc.
   SPDX-License-Identifier: MPL-2.0
-~}}
+}}
 
 <button
   class={{this.classNames}}

package/addon/components/hds/accordion/item/index.hbs

@@ -1,7 +1,7 @@
 {{!
   Copyright (c) HashiCorp, Inc.
   SPDX-License-Identifier: MPL-2.0
-~}}
+}}
 
 <Hds::DisclosurePrimitive class={{this.classNames}} @isOpen={{@isOpen}} ...attributes>
   <:toggle as |t|>

package/addon/components/hds/copy/button/index.hbs

@@ -0,0 +1,16 @@
+{{!
+  Copyright (c) HashiCorp, Inc.
+  SPDX-License-Identifier: MPL-2.0
+}}
+<Hds::Button
+  class={{this.classNames}}
+  @size={{this.size}}
+  @isFullWidth={{@isFullWidth}}
+  @text={{@text}}
+  @icon={{this.icon}}
+  @isIconOnly={{@isIconOnly}}
+  @color="secondary"
+  @iconPosition="trailing"
+  {{clipboard text=@textToCopy target=@targetToCopy container=@container onError=this.onError onSuccess=this.onSuccess}}
+  ...attributes
+/>

package/addon/components/hds/copy/button/index.js

@@ -0,0 +1,91 @@
+/**
+ * Copyright (c) HashiCorp, Inc.
+ * SPDX-License-Identifier: MPL-2.0
+ */
+
+import Component from '@glimmer/component';
+import { assert } from '@ember/debug';
+import { tracked } from '@glimmer/tracking';
+import { action } from '@ember/object';
+
+export const DEFAULT_SIZE = 'medium';
+export const SIZES = ['small', 'medium'];
+export const DEFAULT_ICON = 'clipboard-copy';
+export const SUCCESS_ICON = 'clipboard-checked';
+export const ERROR_ICON = 'clipboard-x';
+export const DEFAULT_STATUS = 'idle';
+
+export default class HdsCopyButtonComponent extends Component {
+  @tracked status = DEFAULT_STATUS;
+  @tracked timer;
+
+  /**
+   * @param icon
+   * @type {string}
+   * @description The icon to be displayed for each status; automatically calculated based on the tracked property `status`.
+   */
+  get icon() {
+    let icon = DEFAULT_ICON;
+    if (this.status === 'success') {
+      icon = SUCCESS_ICON;
+    } else if (this.status === 'error') {
+      icon = ERROR_ICON;
+    }
+    return icon;
+  }
+
+  /**
+   * @param size
+   * @type {string}
+   * @default medium
+   * @description The size of the copy/button; acceptable values are `small` and `medium`
+   */
+  get size() {
+    let { size = DEFAULT_SIZE } = this.args;
+
+    assert(
+      `@size for "Hds::Copy::Button" must be one of the following: ${SIZES.join(
+        ', '
+      )}; received: ${size}`,
+      SIZES.includes(size)
+    );
+
+    return size;
+  }
+
+  /**
+   * Get the class names to apply to the component.
+   * @method CopyButton#classNames
+   * @return {string} The "class" attribute to apply to the component.
+   */
+  get classNames() {
+    let classes = ['hds-copy-button'];
+
+    // add a class based on the @size argument
+    classes.push(`hds-button--size-${this.size}`);
+
+    classes.push(`hds-copy-button--status-${this.status}`);
+
+    return classes.join(' ');
+  }
+
+  @action
+  onSuccess() {
+    this.status = 'success';
+    this.resetStatusDelayed();
+  }
+
+  @action
+  onError() {
+    this.status = 'error';
+    this.resetStatusDelayed();
+  }
+
+  resetStatusDelayed() {
+    clearTimeout(this.timer);
+    // make it fade back to the default state
+    this.timer = setTimeout(() => {
+      this.status = DEFAULT_STATUS;
+    }, 1500);
+  }
+}

package/addon/components/hds/copy/snippet/index.hbs

@@ -0,0 +1,15 @@
+{{!
+  Copyright (c) HashiCorp, Inc.
+  SPDX-License-Identifier: MPL-2.0
+}}
+<button
+  type="button"
+  class={{this.classNames}}
+  {{clipboard text=@textToCopy container=@container onError=this.onError onSuccess=this.onSuccess}}
+  ...attributes
+>
+  <span class="hds-copy-snippet__text hds-typography-code-100 {{if @isTruncated 'hds-copy-snippet__text--truncated'}}">
+    {{@textToCopy}}
+  </span>
+  <FlightIcon @name={{this.icon}} class="hds-copy-snippet__icon" />
+</button>

package/addon/components/hds/copy/snippet/index.js

@@ -0,0 +1,118 @@
+/**
+ * Copyright (c) HashiCorp, Inc.
+ * SPDX-License-Identifier: MPL-2.0
+ */
+
+import Component from '@glimmer/component';
+import { assert } from '@ember/debug';
+import { tracked } from '@glimmer/tracking';
+import { action } from '@ember/object';
+
+export const DEFAULT_COLOR = 'primary';
+export const COLORS = ['primary', 'secondary'];
+export const DEFAULT_ICON = 'clipboard-copy';
+export const SUCCESS_ICON = 'clipboard-checked';
+export const ERROR_ICON = 'clipboard-x';
+export const DEFAULT_STATUS = 'idle';
+
+export default class HdsCopySnippetIndexComponent extends Component {
+  @tracked status = DEFAULT_STATUS;
+  @tracked timer;
+
+  /**
+   * @param icon
+   * @type {string}
+   * @default DEFAULT_ICON
+   * @description Determines the icon to be used, based on the success state. Note that this is auto-tracked because it depends on a tracked property (status).
+   */
+  get icon() {
+    let icon = DEFAULT_ICON;
+    if (this.status === 'success') {
+      icon = SUCCESS_ICON;
+    } else if (this.status === 'error') {
+      icon = ERROR_ICON;
+    }
+    return icon;
+  }
+
+  /**
+   * @param color
+   * @type {string}
+   * @default primary
+   * @description Determines the color of button to be used; acceptable values are `primary` and `secondary`
+   */
+  get color() {
+    let { color = DEFAULT_COLOR } = this.args;
+
+    assert(
+      `@color for "Hds::Copy::Snippet" must be one of the following: ${COLORS.join(
+        ', '
+      )}; received: ${color}`,
+      COLORS.includes(color)
+    );
+
+    return color;
+  }
+
+  /**
+   * @param isFullWidth
+   * @type {boolean}
+   * @default false
+   * @description Indicates that the component should take up the full width of the parent container.
+   */
+  get isFullWidth() {
+    return this.args.isFullWidth ?? false;
+  }
+
+  /**
+   * @param isTruncated
+   * @type {boolean}
+   * @default false
+   * @description Indicates that the component should be truncated instead of wrapping text and using multiple lines.
+   */
+  get isTruncated() {
+    return this.args.isTruncated ?? false;
+  }
+
+  /**
+   * Get the class names to apply to the component.
+   * @method CopySnippet#classNames
+   * @return {string} The "class" attribute to apply to the component.
+   */
+  get classNames() {
+    let classes = ['hds-copy-snippet'];
+
+    // add a class based on the @color argument
+    classes.push(`hds-copy-snippet--color-${this.color}`);
+
+    // add a class based on the tracked status (idle/success/error)
+    classes.push(`hds-copy-snippet--status-${this.status}`);
+
+    // add a class based on the @isFullWidth argument
+    if (this.isFullWidth) {
+      classes.push('hds-copy-snippet--width-full');
+    }
+
+    return classes.join(' ');
+  }
+
+  @action
+  onSuccess() {
+    this.status = 'success';
+    this.resetStatusDelayed();
+  }
+
+  @action
+  onError() {
+    this.status = 'error';
+    this.resetStatusDelayed();
+  }
+
+  resetStatusDelayed() {
+    clearTimeout(this.timer);
+    // make it fade back to the default state
+    this.timer = setTimeout(() => {
+      this.status = DEFAULT_STATUS;
+    }, 1500);
+  }
+}

package/addon/components/hds/dropdown/list-item/copy-item.hbs

@@ -8,13 +8,5 @@
       class="hds-dropdown-list-item__copy-item-title hds-typography-body-100 hds-font-weight-semibold"
     >{{@copyItemTitle}}</div>
   {{/if}}
-  <button type="button" class="{{if this.isSuccess 'is-success'}}" {{on "click" this.copyCode}}>
-    <div class="hds-dropdown-list-item__copy-item-text hds-typography-code-100">
-      {{this.text}}
-    </div>
-    <FlightIcon
-      @name="{{if this.isSuccess 'clipboard-checked' 'clipboard-copy'}}"
-      class="hds-dropdown-list-item__copy-item-icon"
-    />
-  </button>
+  <Hds::Copy::Snippet @textToCopy={{this.text}} @isTruncated={{@isTruncated}} />
 </li>

package/addon/components/hds/dropdown/list-item/copy-item.js

@@ -5,12 +5,8 @@
 
 import Component from '@glimmer/component';
 import { assert } from '@ember/debug';
-import { tracked } from '@glimmer/tracking';
-import { action } from '@ember/object';
 
 export default class HdsDropdownListItemCopyItemComponent extends Component {
-  @tracked isSuccess = false;
-
   /**
    * @param text
    * @type {string}
@@ -26,7 +22,6 @@ export default class HdsDropdownListItemCopyItemComponent extends Component {
 
     return text;
   }
-
   /**
    * Get the class names to apply to the component.
    * @method classNames
@@ -40,29 +35,4 @@ export default class HdsDropdownListItemCopyItemComponent extends Component {
 
     return classes.join(' ');
   }
-
-  @action
-  async copyCode() {
-    // https://developer.mozilla.org/en-US/docs/Web/API/Clipboard
-    await navigator.clipboard.writeText(this.args.text);
-
-    if (navigator.clipboard.readText) {
-      const result = await navigator.clipboard.readText();
-
-      if (result === this.args.text) {
-        this.isSuccess = true;
-      }
-    } else {
-      // assume that it works so Firefox can show the success state
-      // doesn't confirm that you'll get the correct pasted text
-      // but we accept this as a reasonable tradeoff
-      // since users can always copy/paste manually.
-      this.isSuccess = true;
-    }
-
-    // make it fade back to the default state
-    setTimeout(() => {
-      this.isSuccess = false;
-    }, 1000);
-  }
 }

package/addon/components/hds/flyout/index.js

@@ -8,6 +8,15 @@ import { tracked } from '@glimmer/tracking';
 import { action } from '@ember/object';
 import { assert } from '@ember/debug';
 import { getElementId } from '@hashicorp/design-system-components/utils/hds-get-element-id';
+import { buildWaiter } from '@ember/test-waiters';
+import { DEBUG } from '@glimmer/env';
+
+let waiter;
+
+// Notice: this code will get stripped out in production builds (DEBUG evaluates to `true` in dev/test builds, but `false` in prod builds)
+if (DEBUG) {
+  waiter = buildWaiter('@hashicorp/design-system-components:flyout');
+}
 
 export const DEFAULT_SIZE = 'medium';
 export const DEFAULT_HAS_OVERLAY = true;
@@ -115,7 +124,19 @@ export default class HdsFlyoutIndexComponent extends Component {
   }
 
   @action
-  onDismiss() {
+  async onDismiss() {
+    // allow ember test helpers to be aware of when the `close` event fires
+    // when using `click` or other helpers from '@ember/test-helpers'
+    // Notice: this code will get stripped out in production builds (DEBUG evaluates to `true` in dev/test builds, but `false` in prod builds)
+    if (DEBUG && this.element.open) {
+      let token = waiter.beginAsync();
+      let listener = () => {
+        waiter.endAsync(token);
+        this.element.removeEventListener('close', listener);
+      };
+      this.element.addEventListener('close', listener);
+    }
+
     // Make flyout dialog invisible using the native `close` method
     this.element.close();
 

package/addon/components/hds/form/field/index.js

@@ -40,7 +40,7 @@ export default class HdsFormFieldIndexComponent extends Component {
     let { layout } = this.args;
 
     assert(
-      `@type for "Hds::Form::Field" must be one of the following: ${LAYOUT_TYPES.join(
+      `@layout for "Hds::Form::Field" must be one of the following: ${LAYOUT_TYPES.join(
         ', '
       )}; received: ${layout}`,
       LAYOUT_TYPES.includes(layout)

package/addon/components/hds/form/file-input/base.hbs

@@ -0,0 +1,6 @@
+{{!
+  Copyright (c) HashiCorp, Inc.
+  SPDX-License-Identifier: MPL-2.0
+}}
+
+<input class="hds-form-file-input hds-typography-body-200" ...attributes type="file" />

package/addon/components/hds/form/file-input/field.hbs

@@ -0,0 +1,24 @@
+{{!
+  Copyright (c) HashiCorp, Inc.
+  SPDX-License-Identifier: MPL-2.0
+}}
+<Hds::Form::Field
+  @layout="vertical"
+  @extraAriaDescribedBy={{@extraAriaDescribedBy}}
+  @isRequired={{@isRequired}}
+  @isOptional={{@isOptional}}
+  @id={{@id}}
+  as |F|
+>
+  {{! Notice: the order of the elements is not relevant here, because is controlled at "Hds::Form::Field" component level }}
+  {{yield (hash Label=F.Label isRequired=F.isRequired isOptional=F.isOptional)}}
+  {{yield (hash HelperText=F.HelperText Error=F.Error)}}
+  <F.Control>
+    <Hds::Form::FileInput::Base
+      required={{@isRequired}}
+      ...attributes
+      id={{F.id}}
+      aria-describedby={{F.ariaDescribedBy}}
+    />
+  </F.Control>
+</Hds::Form::Field>

package/addon/components/hds/icon-tile/index.js

@@ -133,7 +133,6 @@ export default class HdsIconTileIndexComponent extends Component {
   get entity() {
     let entity;
 
-    // TODO: discuss if we want these kind of tests
     assert(
       `you can't pass both @logo and @icon properties to the "Hds::IconTile" component`,
       !(this.args.logo && this.args.icon)

package/addon/components/hds/modal/index.js

@@ -8,6 +8,15 @@ import { tracked } from '@glimmer/tracking';
 import { action } from '@ember/object';
 import { assert } from '@ember/debug';
 import { getElementId } from '@hashicorp/design-system-components/utils/hds-get-element-id';
+import { buildWaiter } from '@ember/test-waiters';
+import { DEBUG } from '@glimmer/env';
+
+let waiter;
+
+// Notice: this code will get stripped out in production builds (DEBUG evaluates to `true` in dev/test builds, but `false` in prod builds)
+if (DEBUG) {
+  waiter = buildWaiter('@hashicorp/design-system-components:modal');
+}
 
 export const DEFAULT_SIZE = 'medium';
 export const DEFAULT_COLOR = 'neutral';
@@ -156,7 +165,19 @@ export default class HdsModalIndexComponent extends Component {
   }
 
   @action
-  onDismiss() {
+  async onDismiss() {
+    // allow ember test helpers to be aware of when the `close` event fires
+    // when using `click` or other helpers from '@ember/test-helpers'
+    // Notice: this code will get stripped out in production builds (DEBUG evaluates to `true` in dev/test builds, but `false` in prod builds)
+    if (DEBUG && this.element.open) {
+      let token = waiter.beginAsync();
+      let listener = () => {
+        waiter.endAsync(token);
+        this.element.removeEventListener('close', listener);
+      };
+      this.element.addEventListener('close', listener);
+    }
+
     // Make modal dialog invisible using the native `close` method
     this.element.close();
 

package/addon/components/hds/tabs/index.hbs

@@ -11,6 +11,7 @@
           Tab=(component
             "hds/tabs/tab"
             didInsertNode=this.didInsertTab
+            willDestroyNode=this.willDestroyTab
             tabIds=this.tabIds
             panelIds=this.panelIds
             selectedTabIndex=this.selectedTabIndex
@@ -28,6 +29,7 @@
       Panel=(component
         "hds/tabs/panel"
         didInsertNode=this.didInsertPanel
+        willDestroyNode=this.willDestroyPanel
         tabIds=this.tabIds
         panelIds=this.panelIds
         selectedTabIndex=this.selectedTabIndex

package/addon/components/hds/tabs/index.js

@@ -7,6 +7,7 @@ import Component from '@glimmer/component';
 import { tracked } from '@glimmer/tracking';
 import { action } from '@ember/object';
 import { assert } from '@ember/debug';
+import { schedule } from '@ember/runloop';
 
 export default class HdsTabsIndexComponent extends Component {
   @tracked tabNodes = [];
@@ -28,7 +29,10 @@ export default class HdsTabsIndexComponent extends Component {
       }
     });
     this.selectedTabIndex = initialTabIndex;
-    this.setTabIndicator(initialTabIndex);
+
+    schedule('afterRender', () => {
+      this.setTabIndicator(initialTabIndex);
+    });
 
     assert('Only one tab may use isSelected argument', selectedCount <= 1);
 
@@ -44,12 +48,24 @@ export default class HdsTabsIndexComponent extends Component {
     this.tabIds = [...this.tabIds, element.id];
   }
 
+  @action
+  willDestroyTab(element) {
+    this.tabNodes = this.tabNodes.filter((node) => node.id !== element.id);
+    this.tabIds = this.tabIds.filter((tabId) => tabId !== element.id);
+  }
+
   @action
   didInsertPanel(panelId, element) {
     this.panelNodes = [...this.panelNodes, element];
     this.panelIds = [...this.panelIds, panelId];
   }
 
+  @action
+  willDestroyPanel(element) {
+    this.panelNodes = this.panelNodes.filter((node) => node.id !== element.id);
+    this.panelIds = this.panelIds.filter((panelId) => panelId !== element.id);
+  }
+
   @action
   onClick(tabIndex, event) {
     this.selectedTabIndex = tabIndex;

package/addon/components/hds/tabs/panel.hbs

@@ -10,6 +10,7 @@
   id={{this.panelId}}
   hidden={{not this.isSelected}}
   {{did-insert this.didInsertNode}}
+  {{will-destroy this.willDestroyNode}}
 >
   {{yield}}
 </section>

package/addon/components/hds/tabs/panel.js

@@ -42,4 +42,13 @@ export default class HdsTabsIndexComponent extends Component {
       didInsertNode(this.elementId, ...arguments);
     }
   }
+
+  @action
+  willDestroyNode() {
+    let { willDestroyNode } = this.args;
+
+    if (typeof willDestroyNode === 'function') {
+      willDestroyNode(...arguments);
+    }
+  }
 }

package/addon/components/hds/tabs/tab.hbs

@@ -13,6 +13,7 @@
     tabindex={{unless this.isSelected "-1"}}
     data-is-selected={{this.isInitialTab}}
     {{did-insert this.didInsertNode}}
+    {{will-destroy this.willDestroyNode}}
     {{on "click" this.onClick}}
     {{on "keyup" this.onKeyUp}}
   >

package/addon/components/hds/tabs/tab.js

@@ -54,6 +54,15 @@ export default class HdsTabsIndexComponent extends Component {
     }
   }
 
+  @action
+  willDestroyNode() {
+    let { willDestroyNode } = this.args;
+
+    if (typeof willDestroyNode === 'function') {
+      willDestroyNode(...arguments);
+    }
+  }
+
   @action
   onClick() {
     let { onClick } = this.args;

package/app/components/hds/copy/button/index.js

@@ -0,0 +1,6 @@
+/**
+ * Copyright (c) HashiCorp, Inc.
+ * SPDX-License-Identifier: MPL-2.0
+ */
+
+export { default } from '@hashicorp/design-system-components/components/hds/copy/button/index';

package/app/components/hds/copy/snippet/index.js

@@ -0,0 +1,6 @@
+/**
+ * Copyright (c) HashiCorp, Inc.
+ * SPDX-License-Identifier: MPL-2.0
+ */
+
+export { default } from '@hashicorp/design-system-components/components/hds/copy/snippet/index';

package/app/components/hds/form/file-input/base.js

@@ -0,0 +1,6 @@
+/**
+ * Copyright (c) HashiCorp, Inc.
+ * SPDX-License-Identifier: MPL-2.0
+ */
+
+export { default } from '@hashicorp/design-system-components/components/hds/form/file-input/base';

package/app/components/hds/form/file-input/field.js

@@ -0,0 +1,6 @@
+/**
+ * Copyright (c) HashiCorp, Inc.
+ * SPDX-License-Identifier: MPL-2.0
+ */
+
+export { default } from '@hashicorp/design-system-components/components/hds/form/file-input/field';

package/app/styles/@hashicorp/design-system-components.scss

@@ -23,6 +23,7 @@
 @use "../components/button";
 @use "../components/button-set";
 @use "../components/card";
+@use "../components/copy";
 @use "../components/disclosure-primitive";
 @use "../components/dismiss-button";
 @use "../components/dropdown";

package/app/styles/components/copy/button.scss

@@ -0,0 +1,31 @@
+/**
+ * Copyright (c) HashiCorp, Inc.
+ * SPDX-License-Identifier: MPL-2.0
+ */
+
+//
+// COPY > BUTTON
+//
+
+// mostly the hds-button but with a few style tweaks
+// so the CSS is scoped to the component class (we're not changing any of the other class names)
+.hds-copy-button {
+  cursor: pointer;
+
+  .hds-button__icon {
+    color: var(--token-color-foreground-action);
+  }
+
+  &.hds-copy-button--status-success {
+    .hds-button__icon {
+      color: var(--token-color-foreground-success);
+    }
+  }
+
+  &.hds-copy-button--status-error {
+    .hds-button__icon {
+      color: var(--token-color-foreground-critical);
+    }
+  }
+}
+

package/app/styles/components/copy/index.scss

@@ -0,0 +1,8 @@
+/**
+ * Copyright (c) HashiCorp, Inc.
+ * SPDX-License-Identifier: MPL-2.0
+ */
+
+@use "./button.scss";
+@use "./snippet.scss";
+

package/app/styles/components/copy/snippet.scss

@@ -0,0 +1,111 @@
+/**
+ * Copyright (c) HashiCorp, Inc.
+ * SPDX-License-Identifier: MPL-2.0
+ */
+
+//
+// COPY > SNIPPET
+//
+@use "../../mixins/focus-ring" as *;
+
+.hds-copy-snippet {
+  @include hds-focus-ring-with-pseudo-element();
+
+  display: flex;
+  gap: 8px;
+  align-items: center;
+  justify-content: space-between;
+  width: 100%;
+  padding: 6px 4px;
+  white-space: normal;
+  text-align: left;
+  overflow-wrap: anywhere;
+  border: 1px solid transparent;
+  border-radius: 5px;
+  cursor: pointer;
+}
+
+.hds-copy-snippet--color-primary {
+  color: var(--token-color-foreground-action);
+  background-color: var(--token-color-surface-interactive);
+
+  &:hover,
+  &.mock-hover {
+    color: var(--token-color-foreground-action-hover);
+    border-color: var(--token-color-border-strong);
+  }
+
+  &:active,
+  &.mock-active {
+    color: var(--token-color-foreground-action-active);
+    background-color: var(--token-color-surface-interactive-active);
+    border-color: var(--token-color-border-strong);
+  }
+}
+
+.hds-copy-snippet--color-secondary {
+  color: var(--token-color-foreground-primary);
+  background-color: var(--token-color-surface-interactive);
+
+  &:hover,
+  &.mock-hover {
+    border-color: var(--token-color-border-strong);
+  }
+
+  &:active,
+  &.mock-active {
+    background-color: var(--token-color-surface-interactive-active);
+    border-color: var(--token-color-border-strong);
+  }
+
+  .hds-copy-snippet__icon {
+    color: var(--token-color-foreground-action);
+
+    &:hover {
+      color: var(--token-color-foreground-action-hover);
+    }
+
+    &:active {
+      color: var(--token-color-foreground-action-active);
+    }
+
+    &:focus {
+      color: var(--token-color-foreground-action);
+    }
+  }
+}
+
+.hds-copy-snippet--status-success {
+  .hds-copy-snippet__icon {
+    color: var(--token-color-foreground-success);
+  }
+}
+
+.hds-copy-snippet--status-error {
+  .hds-copy-snippet__icon {
+    color: var(--token-color-foreground-critical);
+  }
+}
+
+.hds-copy-snippet__text {
+  flex: 1 0 0;
+  max-width: calc(100% - 24px);
+}
+
+.hds-copy-snippet__icon {
+  flex: none;
+}
+
+.hds-copy-snippet--width-full {
+  justify-content: center;
+
+  .hds-copy-snippet__text {
+    flex: 0 0 auto;
+  }
+}
+
+.hds-copy-snippet__text--truncated {
+  overflow: hidden;
+  white-space: nowrap;
+  text-overflow: ellipsis;
+}

package/app/styles/components/dropdown.scss

@@ -279,60 +279,8 @@ $hds-dropdown-toggle-border-radius: $hds-button-border-radius;
 .hds-dropdown-list-item--variant-copy-item {
   width: 100%;
   padding: 10px 16px 12px;
-
-  button {
-    display: flex;
-    justify-content: space-between;
-    width: 100%;
-    padding: 12px 8px;
-    color: var(--token-color-foreground-primary);
-    background-color: transparent;
-    border: 1px solid var(--token-color-border-primary);
-    border-radius: 5px;
-
-    &:hover,
-    &.mock-hover {
-      background-color: var(--token-color-surface-interactive-hover);
-      cursor: pointer;
-    }
-
-    @include hds-focus-ring-basic();
-
-    &:focus,
-    &.mock-focus {
-      // TODO this focus is just way too complex
-      background-color: var(--token-color-surface-action);
-      border-color: var(--token-color-focus-action-internal);
-    }
-
-    &:active,
-    &.mock-active {
-      background-color: var(--token-color-surface-interactive-active);
-    }
-
-    &.is-success {
-      background-color: var(--token-color-surface-success);
-      border-color: var(--token-color-border-success);
-
-      .hds-dropdown-list-item__copy-item-icon {
-        color: var(--token-color-foreground-success);
-      }
-    }
-  }
-}
-
-.hds-dropdown-list-item__copy-item-text {
-  overflow: hidden;
-  white-space: nowrap;
-  text-align: left;
-  text-overflow: ellipsis;
 }
 
-.hds-dropdown-list-item__copy-item-icon {
-  flex: none;
-  margin-left: 8px;
-  color: var(--token-color-foreground-action);
-}
 
 // HDS::DROPDOWN::LIST-ITEM::DESCRIPTION
 

package/app/styles/components/form/file-input.scss

@@ -0,0 +1,94 @@
+/**
+ * Copyright (c) HashiCorp, Inc.
+ * SPDX-License-Identifier: MPL-2.0
+ */
+
+//
+// FORM > FILE-INPUT
+//
+
+@use "../../mixins/button" as *;
+
+.hds-form-file-input {
+  margin: -4px 0 -4px -4px; // offset shadow padding + default 1px spacing
+  padding: 3px 0 3px 3px; // add padding so button shadow is visible
+  color: var(--token-color-foreground-primary);
+
+  &:focus,
+  &:focus-visible {
+    outline: none;
+  }
+}
+
+// https://developer.mozilla.org/en-US/docs/Web/CSS/::file-selector-button
+// https://caniuse.com/?search=file-selector-button
+
+// Button
+.hds-form-file-input::file-selector-button {
+  min-height: 36px;
+  margin-right: 16px;
+  padding: 7px 16px 7px 37px; // padding in code altered to match Figma visual design
+  color: var(--token-color-foreground-primary);
+  font: inherit;
+  background-color: var(--token-color-surface-faint);
+  // upload icon
+  background-image: url("data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' width='16' height='16' fill='none' viewBox='0 0 16 16'%3E%3Cg fill='%233b3d45'%3E%3Cpath d='M4.24 5.8a.75.75 0 001.06-.04l1.95-2.1v6.59a.75.75 0 001.5 0V3.66l1.95 2.1a.75.75 0 101.1-1.02l-3.25-3.5a.75.75 0 00-1.101.001L4.2 4.74a.75.75 0 00.04 1.06z'/%3E%3Cpath d='M1.75 9a.75.75 0 01.75.75v3c0 .414.336.75.75.75h9.5a.75.75 0 00.75-.75v-3a.75.75 0 011.5 0v3A2.25 2.25 0 0112.75 15h-9.5A2.25 2.25 0 011 12.75v-3A.75.75 0 011.75 9z'/%3E%3C/g%3E%3C/svg%3E");
+  background-repeat: no-repeat;
+  background-position: 15px 50%;
+  background-size: var(--token-form-text-input-background-image-size);
+  border: $hds-button-border-width solid var(--token-color-border-strong);
+  border-radius: $hds-button-border-radius;
+  box-shadow: var(--token-elevation-low-box-shadow);
+  cursor: pointer;
+}
+
+// Button states
+.hds-form-file-input::file-selector-button:hover,
+.hds-form-file-input.mock-hover::file-selector-button {
+  color: var(--token-color-foreground-primary);
+  background-color: var(--token-color-surface-primary);
+  border-color: var(--token-color-border-strong);
+}
+
+.hds-form-file-input:focus-within::file-selector-button,
+.hds-form-file-input.mock-focus::file-selector-button {
+  color: var(--token-color-foreground-primary);
+  background-color: var(--token-color-surface-faint);
+  border-color: var(--token-color-focus-action-internal);
+  outline: 3px solid var(--token-color-focus-action-external);
+}
+
+// Fix issue with button focus style which was displaying after button was activated
+.hds-form-file-input:not(:focus, .mock-focus) {
+  &::file-selector-button {
+    border-color: var(--token-color-border-strong);
+    outline: 0;
+  }
+}
+
+.hds-form-file-input::file-selector-button:active,
+.hds-form-file-input.mock-active::file-selector-button {
+  color: var(--token-color-foreground-primary);
+  background-color: var(--token-color-surface-interactive-active);
+  border-color: var(--token-color-border-strong);
+  box-shadow: none;
+}
+
+.hds-form-file-input {
+  &:disabled,
+  &[disabled],
+  &.mock-disabled,
+  &:disabled:focus,
+  &[disabled]:focus,
+  &.mock-disabled:focus,
+  &:disabled:hover,
+  &[disabled]:hover,
+  &.mock-disabled:hover {
+    color: var(--token-color-foreground-disabled);
+
+    &::file-selector-button {
+      @include hds-button-state-disabled();
+      background-image: url("data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' width='16' height='16' fill='none' viewBox='0 0 16 16'%3E%3Cg fill='%238c909c'%3E%3Cpath d='M4.24 5.8a.75.75 0 001.06-.04l1.95-2.1v6.59a.75.75 0 001.5 0V3.66l1.95 2.1a.75.75 0 101.1-1.02l-3.25-3.5a.75.75 0 00-1.101.001L4.2 4.74a.75.75 0 00.04 1.06z'/%3E%3Cpath d='M1.75 9a.75.75 0 01.75.75v3c0 .414.336.75.75.75h9.5a.75.75 0 00.75-.75v-3a.75.75 0 011.5 0v3A2.25 2.25 0 0112.75 15h-9.5A2.25 2.25 0 011 12.75v-3A.75.75 0 011.75 9z'/%3E%3C/g%3E%3C/svg%3E");
+    }
+  }
+}

package/app/styles/components/form/index.scss

@@ -11,6 +11,7 @@
 @use "./helper-text";
 @use "./error";
 @use "./field";
+@use "./file-input";
 @use "./legend";
 @use "./group";
 @use "./indicator";

package/app/styles/components/segmented-group.scss

@@ -10,10 +10,10 @@
 .hds-segmented-group {
   display: inline-flex;
 
-  .hds-button,
-  .hds-dropdown,
-  .hds-form-select,
-  .hds-form-text-input {
+  > .hds-button,
+  > .hds-dropdown,
+  > .hds-form-select,
+  > .hds-form-text-input {
     &:first-child {
       border-top-right-radius: 0;
       border-bottom-right-radius: 0;

package/app/styles/components/table.scss

@@ -159,6 +159,10 @@ $hds-table-cell-padding-tall: 22px 16px 21px 16px; // the 1px difference is to a
   text-align: right;
 }
 
+.hds-table__th-sort--text-right .hds-table__th-sort--button-content {
+  justify-content: flex-end;
+}
+
 .hds-table__th-sort--text-center,
 .hds-table__th--text-center,
 .hds-table__td--text-center {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hashicorp/design-system-components",
-  "version": "2.8.1",
+  "version": "2.10.0",
   "description": "Helios Design System Components",
   "keywords": [
     "hashicorp",
@@ -40,13 +40,15 @@
   },
   "dependencies": {
     "@ember/render-modifiers": "^2.0.5",
+    "@ember/test-waiters": "^3.0.2",
     "@hashicorp/design-system-tokens": "^1.7.0",
-    "@hashicorp/ember-flight-icons": "^3.0.8",
+    "@hashicorp/ember-flight-icons": "^3.1.0",
     "dialog-polyfill": "^0.5.6",
     "ember-a11y-refocus": "^3.0.2",
     "ember-auto-import": "^2.6.3",
     "ember-cached-decorator-polyfill": "^0.1.4",
     "ember-cli-babel": "^7.26.11",
+    "ember-cli-clipboard": "^1.0.0",
     "ember-cli-htmlbars": "^6.2.0",
     "ember-cli-sass": "^10.0.1",
     "ember-composable-helpers": "^4.5.0",
@@ -73,7 +75,6 @@
     "ember-a11y-testing": "^5.2.1",
     "ember-body-class": "^3.0.0",
     "ember-cli": "~4.12.1",
-    "ember-cli-clipboard": "^1.0.0",
     "ember-cli-dependency-checker": "^3.3.1",
     "ember-cli-deprecation-workflow": "^2.1.0",
     "ember-cli-inject-live-reload": "^2.1.0",

package/app/utils/hds-get-element-id.js

@@ -1,6 +0,0 @@
-/**
- * Copyright (c) HashiCorp, Inc.
- * SPDX-License-Identifier: MPL-2.0
- */
-
-export { default } from '@hashicorp/design-system-components/utils/hds-get-element-id';

package/app/utils/hds-set-aria-described-by.js

@@ -1,6 +0,0 @@
-/**
- * Copyright (c) HashiCorp, Inc.
- * SPDX-License-Identifier: MPL-2.0
- */
-
-export { default } from '@hashicorp/design-system-components/utils/hds-set-aria-described-by';