The page navigation is complete. You may now navigate the page content as you wish.
Skip to main content

Release notes

npm package: @hashicorp/design-system-components npm version

4.8.0

Minor changes

AppHeader - Added new component.

SideNav - Added new withAppHeader option.

Dropdown - Converted component to TypeScript

MenuPrimitive - Converted component to TypeScript

TooltipModifier - Converted modifier to TypeScript

Breadcrumb - Converted component to TypeScript

ApplicationState:

  • Spacing and alignment updates
  • New @align (left (default), center) argument for aligning content
  • Added new yielded Media child component

ApplicationState::Header:

  • The header now supports an optional @titleTag argument that can override the default title element (div)

ApplicationState::Footer:

  • The footer now yields Button and Dropdown components as well as LinkStandalone
  • The visual separator has been removed to modernize the component’s visual look

SegmentedGroup - Converted component to TypeScript

Patch changes

Add explicit ember-get-config dependency for use in the icon sprite initializer

πŸ”„ Updated dependencies:

  • @hashicorp/design-system-tokens@2.2.0

4.7.0

Minor changes

FileInput, MaskedInput, Select, TextInput, Textarea - Converted to TypeScript

Loads the hds-icon sprite in the components package, and ensures it is only loaded once.

Form::TextInput - added support for "month", "week", and "tel" input types

DialogPrimitive - Added set of utility "dialog" sub-components to act as primitives for Modal and Flyout (and to be used as standalone subcomponents if needed)

Modal - Replaced internal subcomponents to use the DialogPrimitive components.

Flyout - Replaced internal subcomponents to use the DialogPrimitive components.

Modal: Converted component to TypeScript

Converted form primitives to TypeScript

Checkbox, Radio, RadioCard, Toggle - Converted components to TypeScript

Flyout: Converted component to TypeScript

DialogPrimitive - Converted component to TypeScript

Patch changes

Badge: updated @text argument type to include numbers.

πŸ”„ Updated dependencies:

  • @hashicorp/flight-icons@3.5.0
  • @hashicorp/ember-flight-icons@5.1.3

4.6.0

Minor changes

PopoverPrimitive - Converted to TypeScript

hds-register-event (internal modifier) - Converted to TypeScript

hds-anchored-position (internal modifier) - Converted to TypeScript

RichTooltip - Converted to TypeScript

Accordion - added @forceState, @onClickToggle arguments Accordion - added close function to <:content>

Accordion - added @size, @type, and @isStatic arguments. While previously equivalent to large the default Accordion size is now medium; use @size="large" to maintain the original appearance.

Patch changes

Removed popover-polyfill dependency and instantiating code

4.5.3

Patch changes

πŸ”„ Updated dependencies:

  • @hashicorp/ember-flight-icons@5.1.2

4.5.2

🚨 Caution: This version has been deprecated 🚨

Patch changes

πŸ”„ Updated dependencies:

  • @hashicorp/ember-flight-icons@5.1.1

4.5.1

🚨 Caution: This version has been deprecated 🚨

Patch changes

Fixed syncing of <F.Error /> ids to the aria-describedby attribute

4.5.0

🚨 Caution: This version has been deprecated 🚨

4.5.0 documentation

Minor changes

SideNav - Adds option to exclude query params from route transition/focus management

Tabs - Converted component to TypeScript

ApplicationState - Converted component to TypeScript

PageHeader - Converted component to TypeScript

SideNav - Converted component to TypeScript

Patch changes

Alert - Fixed typo in HdsAlertTypes

Dropdown::Toggle::Icon - Fixed inconsistencies with Button including:

  • Added missing text color
  • Reduced icon sizes

πŸ”„ Updated dependencies:

  • @hashicorp/ember-flight-icons@5.1.0

4.4.1

Patch changes

πŸ”„ Updated dependencies:

  • @hashicorp/ember-flight-icons@5.0.3

4.4.0

4.4.0 documentation

Minor changes

Added re-export entries for TypeScript components

CopyButton - Converted component to TypeScript

CopySnippet - Converted component to TypeScript

hds-clipboard - Converted modifier to TypeScript

Patch changes

Template Registry - Removed redundant entries

Fix missing TypeScript declaration

Hds::BadgeCount - Fixed typo in template registry declaration

4.3.0

4.3.0 documentation

Minor changes

Added hds-register-event modifier (for internal use)

Published type declarations

Tag - Converted component to TypeScript

IconTile - Converted component to TypeScript

SuperSelect - added components for single and multiple selection based on PowerSelect

BadgeCount - Converted component to TypeScript

DisclosurePrimitive - Converted component to TypeScript

Added hds-anchored-position modifier (for internal use)

AppFooter - Converted component to TypeScript

Stepper::Step::Indicator - Converted to TypeScript Stepper::Task::Indicator - Converted to TypeScript

Badge - Converted component to TypeScript

Accordion - Converted component to TypeScript

Dropdown - Added support for trailing icon in ListItem::Interactive subcomponent

PopoverPrimitive - Added low-level (internal) headless component to provide anchoring, collision detection, and popover functionalities.

RichTooltip - Added component to provide tooltips that can contain more complex and structured content.

AppFrame - converted component to TypeScript

Toast - Converted component to TypeScript

Reveal - Converted component to TypeScript

ButtonSet - Converted component to TypeScript

Separator - Converted component to TypeScript

Patch changes

Alert::Description - Fixed typo in template-registry.ts file declaration

Dropdown::ListItem::Checkmark - Fixed issue with leading icon spacing

Tooltip - Fixed max-width applied to the "bubble" (it was 304px, now is 280px per design specs)

Alert, Badge, BadgeCount, Button, Card::Container, DisclosurePrimitive, DismissButton, IconTile, Interactive, Link::Inline, Link::Standalone, Tag, Text - Standardized class names and signatures

CodeBlock - Re-mapped class-name variable to color-blue

Fixed default export warnings by preventing types.js files from being reexported

Tabs - Fixed issue with z-index of the active tab "indicator"

πŸ”„ Updated dependencies:

  • @hashicorp/ember-flight-icons@5.0.2

4.2.0

4.2.0 documentation

Minor changes

Link::Inline - Converted component to TypeScript

Card - Converted component to TypeScript

Link::Standalone - Converted component to TypeScript

Text - Converted component to TypeScript

Alert - Converted component to TypeScript

Patch changes

Modal, Flyout - Fixed flaky tests by running @ember/test-waiters in all environments

4.1.2

Patch changes

This version is a re-release of @hashicorp/design-system-components@4.1.1 containing the missing pre-compiled CSS

4.1.1

🚨 Caution: This version is missing the pre-compiled CSS 🚨

You can still use this version if you import styles as Sass and don't require design-system-components.css

Patch changes

Flyout - Fixed issue with Sass operators failing in old versions of Sass

4.1.0

4.1.0 documentation

Minor changes

DismissButton - Converted component to TypeScript

Added image error handling to Dropdown::Toggle::Icon

Patch changes

Enable glint

Upgraded ember-truth-helpers from 3.1.1 to 4.0.3

Added missing aria-label support to copy-snippet component.

Removed dialog-polyfill dependency

πŸ”„ Updated dependencies:

  • @hashicorp/design-system-tokens@2.1.0
  • @hashicorp/ember-flight-icons@5.0.1

4.0.0

4.0.0 documentation

Major changes

Converted Ember packages to v2 addon format.

To migrate, update Sass configuration in ember-cli-build.js to include the paths for ember-flight-icons and design-system-components:

sassOptions: {
  precision: 4,
  includePaths: [
    './node_modules/@hashicorp/design-system-tokens/dist/products/css',
    './node_modules/@hashicorp/ember-flight-icons/dist/styles',
    './node_modules/@hashicorp/design-system-components/dist/styles',
  ],
},

Alternatively, you can import the CSS by adding this configuration in ember-cli-build.js.

app.import(
  "node_modules/@hashicorp/design-system-components/dist/styles/@hashicorp/design-system-components.css",
);

Form::CharacterCount - refactored the component, removing onInsert callback and adding use @value argument

To migrate:

  • for standalone Form::CharacterCount instances, you must pass in a @value argument representing the value of the referenced input
  • when used as a contextual component F.CharacterCount in Form::[MaskedInput|TextInput|Textarea]::Field make sure the form control is updating the associated @value on input (usually using on "input" (fn this.updateValue) function)

Table - Multiple updates to the main component and its subcomponents:

  • Updated table headers to support tooltips
  • Updated visual treatment and location of the "sort" button in the table headers
  • Refactored CSS code to simplify usage of hds-table-related class names

Table::ThSort:

  • Added support for tooltip via the @tooltip argument
  • Updated visual treatment and location of the "sort" button
  • Updated DOM structure of the <th> content
  • Remove class hds-table__th-sort--button-content
  • Replaced class hds-table__th-sort with classes hds-table__th + hds-table__th--sort
  • Replaced class hds-table__th-sort--text--[left|center|right] with hds-table__th--align-[left|center|right]
  • Renamed onClick callback to onClickSort

Table::Th:

  • Added support for tooltip via the @tooltip argument
  • Updated DOM structure of the <th> content
  • Replaced class hds-table__th--text-[left|center|right] with hds-table__th--align-[left|center|right]

Table::Td:

  • Replaced class hds-table__td--text-[left|center|right] with hds-table__td--align-[left|center|right]

To migrate run the codemod v4/table (see readme file)

Pagination - Removed handling of query parameters from onPageSizeChange function for Pagination::Numbered

Unfortunately, it's not possible to cover this breaking change with a codemod. Consumers should review their usage of the onPageSizeChange callback and, if necessary, implement the persistence of the "page number" and "page size" values via query parameters themselves.

Renamed namespaced contextual components as follows:

  • Alert::Link::Standalone to Alert::LinkStandalone
  • ApplicationState::Footer::Link::Standalone to ApplicationState::Footer::LinkStandalone
  • Form::Checkbox::Group::Checkbox::Field to Checkbox::Group::CheckboxField
  • Form::Radio::Group::Radio::Field to Form::Radio::Group::RadioField
  • Form::Toggle::Group::Toggle::Field to Form::Toggle::Group::ToggleField
  • Toast::Link::Standalone to Toast::LinkStandalone

Minor changes

Table - Added multi-select functionality

Tabs - Added @size argument with new "large" size variant

Patch changes

Dropdown - Fixed dropdown list missing an accessible name when Checkmark items were passed in

Flyout - Reduced gap between Flyout and edge of screen from 40px to half of the minimized SideNav width in medium view

Removed ember-deep-tracked dependency that was not used

SideNav - Fixed issue with navigation elements remaining interactive when minimized

πŸ”„ Updated dependencies:

  • @hashicorp/ember-flight-icons@5.0.0
  • @hashicorp/design-system-tokens@2.0.0

3.6.0

3.6.0 documentation

Minor changes

Since this is an update brand colors and product icons, we consider this a minor version release

πŸ”„ Updated dependencies:

  • @hashicorp/design-system-tokens@1.11.0
  • @hashicorp/ember-flight-icons@4.1.0

3.5.0

3.5.0 documentation

Minor changes

IconTile - updated component adding support for vault-radar product

Patch changes

SideNav::List::Title, SideNav::List::BackLink, SideNav::List::Link: fixed issue with long text strings without spaces not wrapping

Added hds- prefix to Sass variables for component styles (where missing).

Tabs - removed @cached decorator and the associated ember-cached-decorator-polyfill

CodeBlock - Fixed the default token color in the syntax highlighting theme.

πŸ”„ Updated dependencies:

  • @hashicorp/design-system-tokens@1.10.0
  • @hashicorp/ember-flight-icons@4.0.6

3.4.1

Patch changes

Modal - Removed close event listener on destroy Flyout - Removed close event listener on destroy

CodeBlock - Fixed issues with dynamic content, compile warning, and line number alignment

SegmentedGroup - Fixed issue with border-radius of single child element being overridden

3.4.0

Minor changes

Button - Added @isInline argument

Table - Added support for baseline vertical alignment

Patch changes

AppFooter - Changed visual alignment from right-aligned to centered.

Tooltip - Fixed issue with text alignment, which was inherited from the parent container (now it's always left aligned).

Tabs - Fixed subcomponents' backing-class names

AppFooter - Updated default accessibility URL to https://hashicorp.com/accessibility

Form::Fieldset as consumed by Form::Checkbox::Group, Form::Radio::Group, Form::RadioCard::Group, and Form::Toggle::Group - Changed spacing between legend and content from 4px to 8px

πŸ”„ Updated dependencies:

  • @hashicorp/ember-flight-icons@4.0.5

3.3.0

Minor changes

Form::CharacterCount - Added new component Form::Field - Added CharacterCount contextual component Form::MaskedInput::Field - Added CharacterCount contextual component Form::TextInput::Field - Added CharacterCount contextual component Form::Textarea::Field - Added CharacterCount contextual component

Patch changes

Button - Updated DOM structure to contain only span elements

Dropdown - Updated button elements DOM structure to contain only span elements

Link::Standalone - Updated DOM structure to contain only span elements


Read the full changelog

npm package: @hashicorp/design-system-tokens npm version

2.2.0

Minor changes

AppHeader - Added design tokens:

  • --token-app-header-height
  • --token-app-header-home-link-size
  • --token-app-header-logo-size

2.1.0

Minor changes

Added new pipeline to Style Dictionary for cloud-email - email/sass-variables to be used in email templating

2.0.0

Major changes

New tokens added for large and medium size Tab variants. The "medium" tokens replace the former equivalent tokens which were not differentiated by size.

  • --token-tabs-tab-height-medium (Replaces --token-tabs-tab-height)
  • --token-tabs-tab-height-large (New)
  • --token-tabs-tab-padding-horizontal-medium (Replaces --token-tabs-tab-padding-horizontal)
  • --token-tabs-tab-padding-horizontal-large (New)

1.11.0

Minor changes

Updated vault, vault-secrets, and vault-radar brand color values

Added design token for terraform-brand-on-dark color

1.10.0

Minor changes

Added color tokens for β€œVault Radar” product

1.9.0

Minor changes

Added design tokens for SideNav with @isCollapsible (to control if users can collapse the sidenav on 'desktop' viewports) and @isMinimized (to control the default state on 'desktop' viewports) arguments

1.8.0

Minor changes

Added color tokens for β€œVault Secrets” product

1.7.0

Minor changes

Added JSON output format for marketing target (and in the process refactored internal logic for tokens generation)

1.6.0

Minor changes

Added design token for loading state icon on search input

1.5.0

Minor changes

  • Added new TooltipButton component and hds-tooltip modifier
  • Added design tokens for Tooltip

1.4.2

Patch changes

Added design tokens for SideNav component

1.4.1

Patch changes

  • Scoped group layout styles to nested child components.
  • Fixed bug with --token-pagination-child-spacing-vertical value so that it adds "px" unit.

1.4.0

Minor changes

Added design tokens for Pagination component

1.3.1

Patch changes

Updated design system name to "Helios"

1.3.0

Minor changes

Added design tokens for indeterminate Checkbox

1.2.0

Minor changes

Patch changes

1.1.0

Minor changes

1.0.1

Patch changes

  • #555 0b245333 Thanks @didoo! - Added design tokens for code-200 and code-300 typographic styles

1.0.0

Major changes

This release signifies the first major release of the HashiCorp Design System. Moving forward we expect to respect SemVer as we make additional changes to the design system.

Note: Even though this is a major version bump, there should not be any breaking changes from the last minor releases.

Minor changes

  • added specific design tokens for the form controls components

0.8.1

Patch changes


Read the full changelog

npm package: @hashicorp/flight-icons npm version

3.5.0

Minor changes

mongodb and twilio icons have been added.

3.4.0

Minor changes

service-now and pager-duty icons added.

Patch changes

search icon (16px only) has been increased in size to better fit within the bounding box and more closely align with other icons of the same size

3.3.0

Minor changes

vagrant, vagrant-color, vagrant-fill, vagrant-fill-color, vagrant-square, vagrant-square-color icons were updated per brand changes.

3.2.0

Minor changes

Added two icon logos: minio and git.

sparkle icon added

3.1.0

Minor changes

Reorganized the icons within the "Core" icon set into 16 more descriptive categories.

Patch changes

Added "category" to the icons' metadata in the catalog.json file.

3.0.0

Major changes

vagrant, vault-radar, and vault-secrets icons have been updated. Also added boxed versions of all product logos.

2.25.0

Minor changes

vault-radar icons added. vault-secrets icons updated per Brand guidance.

2.24.0

Minor changes

rabbitmq, openid, jwt, meetup, and transform-data icons added.

2.23.0

Minor changes

accessibility, channel, minus-circle-fill, plus-circle-fill icons added. Fixed the size and position of the plus-circle icon.

2.22.0

Minor changes

Added IconName type to iconNames export

2.21.0

Minor changes

Added static SVG sprite sheet file

2.20.0

Minor changes

Added "static" version of the animated icons:

  • loading-static
  • running-static

Added new set of icons for Google services:

  • google-docs
  • google-forms
  • google-slides
  • google-sheets
  • google-drive

2.19.0

Minor changes

Added Vault Secrets icon.

2.18.0

Minor changes

Added Vercel and Jira icons

Added twitter-x icon, and older twitter icon. Also the aws-cdk and jfrog icons.

2.17.0

Minor changes

Added new clipboard-x icon

2.16.0

Minor changes

Added elastic-observability and new-relic icons

2.15.0

Minor changes

Added Venafi service icon

2.14.0

Minor changes

Added robot icon (for Service Principals)

2.13.1

Patch changes

Fix color for connection-gateway icon

2.13.0

Minor changes

Added ampersand icon


Read the full changelog

npm package: @hashicorp/ember-flight-icons npm version

5.1.3

Patch changes

πŸ”„ Updated dependencies:

  • @hashicorp/flight-icons@3.5.0

5.1.2

Patch changes

This version is a re-release of @hashicorp/ember-flight-icons@5.1.0 containing the missing dist

5.1.1

🚨 Caution: This version has been deprecated 🚨

5.1.0

🚨 Caution: This version has been deprecated 🚨

Minor changes

FlightIcon - converted component to TypeScript and published types

Patch changes

πŸ”„ Updated dependencies:

  • @hashicorp/flight-icons@3.4.0

5.0.3

Patch changes

πŸ”„ Updated dependencies:

  • @hashicorp/flight-icons@3.3.0

5.0.2

Patch changes

FlightIcon component - Removed initial whitespace (newline) from template

πŸ”„ Updated dependencies:

  • @hashicorp/flight-icons@3.2.0

5.0.1

Patch changes

πŸ”„ Updated dependencies:

  • @hashicorp/flight-icons@3.1.0

5.0.0

Major changes

Converted Ember packages to v2 addon format.

To migrate update Sass configuration in ember-cli-build.js to include the paths for ember-flight-icons and design-system-components:

sassOptions: {
  precision: 4,
  includePaths: [
    './node_modules/@hashicorp/design-system-tokens/dist/products/css',
    './node_modules/@hashicorp/ember-flight-icons/dist/styles',
    './node_modules/@hashicorp/design-system-components/dist/styles',
  ],
},

Alternatively, you can import the CSS by adding this configuration in ember-cli-build.js.

app.import(
  "node_modules/@hashicorp/design-system-components/dist/styles/@hashicorp/design-system-components.css",
);

4.1.0

Minor changes

Since this is an update brand colors and product icons, we consider this a minor version release

Improved resilience of SVG sprite loading script

πŸ”„ Updated dependencies:

  • @hashicorp/flight-icons@3.0.0

4.0.6

Patch changes

remove unused contextRootURL function

πŸ”„ Updated dependencies:

  • @hashicorp/flight-icons@2.25.0

4.0.5

Patch changes

πŸ”„ Updated dependencies:

  • @hashicorp/flight-icons@2.24.0

4.0.4

Patch changes

When lazyEmbed is true, use dynamic import() to bundle the sprite separately

πŸ”„ Updated dependencies:

  • @hashicorp/flight-icons@2.23.0

4.0.3

Patch changes

πŸ”„ Updated dependencies:

  • @hashicorp/flight-icons@2.22.0

4.0.2

Patch changes

Upgraded the following dependencies:

  • ember-cli-babel from 7.26.11 to 8.2.0

Upgraded the following dependencies:

  • ember-cli-htmlbars from 6.2.0 to 6.3.0

πŸ”„ Updated dependencies:

  • @hashicorp/flight-icons@2.21.0

4.0.1

Patch changes

Added missing dependency on ember-get-config

4.0.0

Major changes

Drop support for Node 14

3.1.3

Patch changes

πŸ”„ Updated dependencies:

  • @hashicorp/flight-icons@2.20.0

3.1.2

Patch changes

πŸ”„ Updated dependencies:

  • @hashicorp/flight-icons@2.19.0

3.1.1

Patch changes

πŸ”„ Updated dependencies:

  • @hashicorp/flight-icons@2.18.0

3.1.0

Minor changes

Added opt in flag to allow consumers to move sprite loading out of index.html


Read the full changelog

Components library

Figma library: HDS Product - Components

February 27th, 2024

Breaking changes

Alert and Toast - Updated the StandaloneLink to the secondary variant from the primary variant to align with our documented usage recommendations.

Updating the StandaloneLink to the secondary variant will revert any changes you've made to the text and leading icon properties. Prior to updating the library we recommend annotating (with a comment or otherwise) work that is in progress or is still being referenced by engineering with the intended text and icon variant.

Table - multiple enhancements to the Table components including:

  • Added support for multi-selection with Header Column / Selection and Cell / Selection.
  • Added support for a Tooltip in the Header Column component.
  • Updated the visual language of the sort button in Header Column by decoupling the sort functionality into a nested Sort Button

Adding support for a Tooltip and updates to the Sort Button result in a breaking change in sortable variants. While the Label in the Header Column should persist, we recommend annotating (with a comment or otherwise) work that is in-progress or still being referenced by engineering with the columns that are intended to be sortable.

January 24th, 2024

IconTile - Added Vault Radar logo.

November 6th, 2023

CodeBlock - Added new component.

November 3rd, 2023

Breadcrumb - Updated the number of breadcrumb / _items to the component.

October 23rd, 2023

Button - Updated icon only button variants to be square to match the ToggleIcon.

Dropdown / ToggleIcon - Fixed the small variant so that it’s the correct size (28px height) to match the other small Buttons and ToggleButton.

September 15th, 2023

IconTile and IconTile-Logo - Added a new product variant for Vault Secrets.

August 17th, 2023

SideNav - Changed the icon from User to Help in the first dropdown at the top of the SideNav.

July 31st, 2023

Field/Date, Field/Time, Field/Datetime - Fixed the default width of the components to match the browser default.

July 13th, 2023

Added new components:

  • Accordion
  • MaskedInput

July 12th, 2023

Added a β€œForm Primitives” page to house the Fieldset component.


Read the full changelog

Foundations library

Figma library: HDS Product - Foundations

November 2nd, 2023

Elevation / Mid - Fixed style not being correctly published to consuming libraries.

October 31st, 2023

Components / Code Block / Code / 200 - Added component-specific text style for the CodeBlock.

October 20th, 2023

Components / Code Block / Syntax - Added syntax highlighting styles used by the CodeBlock component.


Read the full changelog