@aurodesignsystem/design-tokens 4.3.1 → 4.5.0

package/CHANGELOG.md

@@ -1,5 +1,31 @@
 # Semantic Release Automated Changelog
 
+# [4.5.0](https://github.com/AlaskaAirlines/AuroDesignTokens/compare/v4.4.0...v4.5.0) (2024-05-23)
+
+
+### Features
+
+* add excursion theme [#151](https://github.com/AlaskaAirlines/AuroDesignTokens/issues/151) ([1f33445](https://github.com/AlaskaAirlines/AuroDesignTokens/commit/1f334454c520871a7130f9f4a086b777e2ad2010))
+* add new and depcrecate old tier 2 color tokens ([e3b946c](https://github.com/AlaskaAirlines/AuroDesignTokens/commit/e3b946cda3a96842d23e4cd141284435f0d28960))
+* add new and deprecate old tier 1 color tokens ([4a40ba2](https://github.com/AlaskaAirlines/AuroDesignTokens/commit/4a40ba25a911ae5fcc869d81921045e76f2dcb78))
+
+
+### Performance Improvements
+
+* remove previously deprecated tokens ([1bc164b](https://github.com/AlaskaAirlines/AuroDesignTokens/commit/1bc164bc7b111f8defd6155edbd199711ca53ae5))
+
+# [4.4.0](https://github.com/AlaskaAirlines/AuroDesignTokens/compare/v4.3.1...v4.4.0) (2024-05-09)
+
+
+### Features
+
+* add support for JSON flat and nested [#144](https://github.com/AlaskaAirlines/AuroDesignTokens/issues/144) ([af7a657](https://github.com/AlaskaAirlines/AuroDesignTokens/commit/af7a657f49aa247172d7f862fbc175992049d7a4))
+
+
+### Performance Improvements
+
+* convert hard value to token [#124](https://github.com/AlaskaAirlines/AuroDesignTokens/issues/124) ([f54d4f4](https://github.com/AlaskaAirlines/AuroDesignTokens/commit/f54d4f485b15893bb454bc32fb3f7f789dca8b7e))
+
 ## [4.3.1](https://github.com/AlaskaAirlines/AuroDesignTokens/compare/v4.3.0...v4.3.1) (2024-01-29)
 
 

package/README.md

@@ -1,6 +1,6 @@
 # Auro Design Tokens
 
-## Install
+## Installation
 
 [![Build Status](https://img.shields.io/github/actions/workflow/status/AlaskaAirlines/AuroDesignTokens/testPublish.yml?branch=master&style=for-the-badge)](https://github.com/AlaskaAirlines/AuroDesignTokens/actions/workflows/testPublish.yml)
 [![See it on NPM!](https://img.shields.io/npm/v/@aurodesignsystem/design-tokens.svg?style=for-the-badge&color=orange)](https://www.npmjs.com/package/@aurodesignsystem/design-tokens)
@@ -10,15 +10,17 @@
 $ npm i @aurodesignsystem/design-tokens
 ```
 
-## Use pre-processed resources
+## Using Pre-processed Resources
 
-Located in the `./dist/tokens` directory of the [npm](https://www.npmjs.com/package/@aurodesignsystem/design-tokens).
+Pre-processed resources are available in the `./dist/tokens` directory of the [npm package](https://www.npmjs.com/package/@aurodesignsystem/design-tokens).
 
 ```
 └── tokens
    ├── CSSCustomProperties.css
    ├── CSSSizeCustomProperties.css
    ├── JSData--color.js
+   ├── JSONVariablesFlat.json
+   ├── JSONVariablesNested.json
    ├── JSObject--allTokens.js
    ├── JSObject--deprecated.js
    ├── JSVariables--color.js
@@ -27,71 +29,82 @@ Located in the `./dist/tokens` directory of the [npm](https://www.npmjs.com/pack
    ├── SCSSVariablesMapFlat.scss
    ├── SassCustomProperties.scss
    ├── SassSizeCustomProperties.scss
-   └── darkmode
-      ├── CSSCustomProperties.css
-      ├── JSDataColor.js
-      ├── JSObject--allDarkTokens.js
-      ├── JSVariablesColor.js
-      ├── SCSSVariables.scss
-      ├── SCSSVariablesMapFlat.scss
-      └── SassCustomProperties.scss
+   ├── darkmode
+   |  ├── CSSCustomProperties.css
+   |  ├── JSDataColor.js
+   |  ├── JSObject--deprecatedDark.js
+   |  ├── JSVariablesColor.js
+   |  ├── SCSSVariables.scss
+   |  ├── SCSSVariablesMapFlat.scss
+   |  └── SassCustomProperties.scss
+   └── excursion
+      ├── JSONVariablesFlat.json
+      └── JSONVariablesNested.json
 ```
 
 ### Resource Descriptions
 
-| file | syntax | type | status | filter type / description |
-|---|---|---|---|---|
-| CSSCustomProperties | CSS | custom properties | current | full list of v3.0x release tokens |
-| CSSSizeCustomProperties | CSS | custom properties | current | filter: size, public |
-| JSData--color | JS module | color data | current | filter: color, current |
-| JSObject--deprecated | JS module | deprecated tokens | current | filter: deprecated, pubic |
-| JSObject--allTokens.js | JS module | all data | current | filter: public |
-| JSVariables--color | js es6 | color data | current | filter: color |
-| SCSSVariableMap | Sass | Sass variable map | current | filter: size, public |
-| SCSSVariables | scss | Sass variables | current | full list of v3.0x release tokens |
-| SCSSVariablesMapFlat | scss | Scss variable map | current | full list of v3.0x release tokens |
-| SassCustomProperties | scss | custom properties | current | full list of v3.0x release tokens |
-| SassSizeCustomProperties | Sass | custom properties | current | filter: size, public |
-
+| File                   | Syntax    | Type               | Status  | Filter Type / Description  |
+|------------------------|-----------|--------------------|---------|-----------------------------|
+| CSSCustomProperties    | CSS       | Custom properties  | Current | All v4.0x release tokens   |
+| CSSSizeCustomProperties| CSS       | Custom properties  | Current | Filter: size, public       |
+| JSData--color          | JS module | Color data         | Current | Filter: color, current      |
+| JSONVariablesFlat      | JSON Data | All data           | Current | All v4.0x release tokens   |
+| JSONVariablesNested    | JSON Data | All data           | Current | All v4.0x release tokens   |
+| JSObject--deprecated   | JS module | Deprecated tokens | Current | Filter: deprecated, public |
+| JSObject--allTokens.js | JS module | All data           | Current | All v4.0x release tokens   |
+| JSVariables--color     | JS ES6    | Color data         | Current | Filter: color               |
+| SCSSVariableMap        | Sass      | Sass variable map  | Current | Filter: size, public       |
+| SCSSVariables          | SCSS      | Sass variables     | Current | All v4.0x release tokens   |
+| SCSSVariablesMapFlat   | SCSS      | Sass variable map  | Current | All v4.0x release tokens   |
+| SassCustomProperties   | SCSS      | Custom properties  | Current | All v4.0x release tokens   |
+| SassSizeCustomProperties| Sass     | Custom properties  | Current | Filter: size, public       |
 
 ### Migration from 3.x to 4.x
 
-With the release of Auro Design Tokens 4.x a new variable namespace was introduced. The project has removed `--auro` and replaced with `--ds`. This was done to support upcoming theming capabilities. 
-
-Since not all Auro web components are using the new tokens, simply removing the 3.x version and replacing with the 4.x version will break your UI. 
+With the release of Auro Design Tokens 4.x, a new variable namespace was introduced. The project has replaced `--auro` with `--ds` to support upcoming theming capabilities.
 
-To allow for a seamless transition between the two sets of design tokens, we highly recommend the following install supoprt.
+Since not all Auro web components are using the new tokens, simply replacing the 3.x version with the 4.x version will break your UI.
 
-1. In your app, please install the new `@aurodesignsystem/design-tokens@4.x`, but DO NOT uninstall `@alaskaairux/design-tokens@3.15.5`.
-1. Update to use the new `@aurodesignsystem/webcorestylesheets` which fully supports the new token naming spec.
-1. Please review the [Deprecated tokens list](https://auro.alaskaair.com/getting-started/developers/design-tokens/deprecated) for a matrix of changes. Understand that some tokens have been removed from the project and need to be updated. 
+To ensure a smooth transition between the two sets of design tokens, we highly recommend the following approach:
 
-By allowing your project to support both the legacy and new Auro design tokens, this will ensure a smooth transition until all Auro components have been updated and your project has also updated local SCSS/CSS files with the new references. 
+1. Install the new `@aurodesignsystem/design-tokens@4.x` in your app, but DO NOT uninstall `@alaskaairux/design-tokens@3.15.5`.
+2. Update to use the new `@aurodesignsystem/webcorestylesheets`, which fully supports the new token naming spec.
+3. Review the [Deprecated tokens list](https://auro.alaskaair.com/getting-started/developers/design-tokens/deprecated) for a matrix of changes. Some tokens have been removed from the project and need to be updated.
 
+By supporting both the legacy and new Auro design tokens in your project, you ensure a smooth transition until all Auro components have been updated and your project has also updated local SCSS/CSS files with the new references.
 
 ### Install with Sass
 
+When working with Sass, the preprocessor scripting language, there are several options for incorporating design tokens into your project. First, ensure that all design tokens are included to fulfill CSS custom property requests. This can be achieved by importing the SCSS file as demonstrated below:
+
 ```scss
-@import "~@aurodesignsystem/design-tokens/dist/tokens/SCSSVariables";
+@import "~@aurodesignsystem/design-tokens/dist/tokens/SassCustomProperties.scss";
+```
 
-// or
+Even if Sass isn't utilized, `SassCustomProperties.scss` remains an option, though not mandatory. Alternatively, you can load all tokens using `CSSCustomProperties.css` anywhere within the project's header.
 
-@import "~@aurodesignsystem/design-tokens/dist/tokens/SassCustomProperties";
+Moreover, if project specifications dictate the use of Sass variables, `SCSSVariables.scss` can be imported. This is necessary for projects utilizing WCSS due to a dependency on these variables.
+
+```scss
+@import "~@aurodesignsystem/design-tokens/dist/tokens/SCSSVariables.scss";
 ```
 
+**NOTE:** When developing new UI code in Sass, it's still advisable to leverage CSS custom properties over Sass variables. See **Install with CSS** below.
+
 ### Install with CSS
 
-With React or similar framework, the CSS file can be imported directly from the npm:
+For React or similar frameworks, simply import the CSS file directly from npm:
 
 ```js
 import "@aurodesignsystem/design-tokens/dist/tokens/CSSCustomProperties.css"
 ```
 
-For other frameworks, it's suggested that the CSS file be copied from the npm into the scope of the project with a build scenario.
+For other frameworks, you'll need to copy the CSS file from the npm resource into your project using a build scenario.
 
 ### Install ESModules
 
-Within a webpack supported application or a `type="module"` script:
+In a webpack-supported application or a `type="module"` script:
 
 ```js
 import { AuroColorAlertNotificationOnLight, AuroColorBorderErrorOnLight } from '@aurodesignsystem/design-tokens/dist/tokens/JSVariables--color.js';
@@ -99,10 +112,10 @@ import { AuroColorAlertNotificationOnLight, AuroColorBorderErrorOnLight } from '
 
 ### Install from CDN
 
-Using the `https://cdn.jsdelivr.net/npm/` CDN,  every file in the dist directory can be accessed like so.
+Using the `https://cdn.jsdelivr.net/npm/` CDN, every file in the dist directory can be accessed like so:
 
 ```html
 <link rel="stylesheet" href="https://cdn.jsdelivr.net/npm//@aurodesignsystem/design-tokens@latest/dist/tokens/CSSCustomProperties.css">
 ```
 
-**NOTE:** Please use caution when using the CDN solution. We are not responsible for the CDN `https://cdn.jsdelivr.net/` [uptime](https://www.isitupdown.com/jsdelivr) and are unable to effectively troubleshoot when there are response issues. It is recommended to use the installed version of Auro Design Tokens when using them in critical UIs.
+**Note:** Exercise caution when using this CDN solution. The Auro team is NOT responsible for the maintenance of the CDN `https://cdn.jsdelivr.net/` [uptime](https://www.isitupdown.com/jsdelivr) and are unable to effectively troubleshoot response issues. It is recommended to use the installed version of Auro Design Tokens for critical UIs. Any additional CDN solution must be maintained by the team using this solution per this [Discussion](https://github.com/orgs/AlaskaAirlines/discussions/513).