@salt-ds/theme 0.0.0-snapshot-20240726102508 → 0.0.0-snapshot-20240726124318

package/CHANGELOG.md

@@ -0,0 +1,1308 @@
+# @salt-ds/theme
+
+## 0.0.0-snapshot-20240726124318
+
+### Minor Changes
+
+- fc66238: Added tertiary variables in theme next theme
+
+  ```
+  --salt-container-tertiary-borderColor
+  --salt-container-tertiary-borderColor-disabled
+  ```
+
+  Added tertiary variables in existing theme
+
+  ```
+  --salt-container-tertiary-background
+  --salt-container-tertiary-background-disabled
+  --salt-container-tertiary-borderColor
+  --salt-container-tertiary-borderColor-disabled
+  ```
+
+  Added gray 30 and 50 fade background in fade.css
+
+  ```
+  --salt-color-gray-30-fade-background
+  --salt-color-gray-50-fade-background
+  ```
+
+  Un-deprecated tertiary palette variables in characteristics.css and palette.css and added those to neutral.css
+
+  ```
+  --salt-palette-neutral-tertiary-background
+  --salt-palette-neutral-tertiary-background-disabled
+  --salt-palette-neutral-tertiary-border
+  --salt-palette-neutral-tertiary-border-disabled
+  ```
+
+### Patch Changes
+
+- 82846ca: Update build tooling
+- 3c635db: Fixed `--salt-size-selectable` double defined in deprecated token list
+
+## 1.20.0
+
+### Minor Changes
+
+- fc60301: Added status bold background and content bold foreground tokens
+
+  ```
+  --salt-status-info-bold-background
+  --salt-status-error-bold-background
+  --salt-status-warning-bold-background
+  --salt-status-success-bold-background
+
+  --salt-content-bold-foreground
+  --salt-content-bold-foreground-disabled
+  ```
+
+### Patch Changes
+
+- baa5aaa: Added `--salt-overlayable-rangeSelection` variable in theme next, pointing to the same underlying value as before.
+
+  Closes #3517.
+
+## 1.19.0
+
+### Minor Changes
+
+- f89189d: Added theme tokens supporting action font switch.
+
+  ```css
+  --salt-text-action-fontFamily: var(--salt-palette-text-fontFamily-action);
+
+  --salt-palette-text-fontFamily-action: var(
+    --salt-typography-fontFamily-openSans
+  );
+  --salt-palette-text-action-fontWeight: var(
+    --salt-typography-fontWeight-semiBold
+  );
+  ```
+
+  Updated `--salt-text-action-fontWeight` to use `var(--salt-palette-text-action-fontWeight)`.
+
+  In theme next, palette layer tokens can be switched between Open Sans and Amplitude.
+
+  Closes #3528.
+
+## 1.18.0
+
+### Minor Changes
+
+- d0b6912: Added display 4 text tokens, which have the same value as display 3.
+
+  In theme next, display sizes are remapped to reflect larger size than h1.
+
+- 87791a1: Updated H1 font weight
+
+  | H1      | Before     | New       |
+  | ------- | ---------- | --------- |
+  | Default | Bold       | Semi bold |
+  | Small   | Medium     | Regular   |
+  | Strong  | Extra bold | Bold      |
+
+  Added font weight in palette layer for display, heading, body and notation.
+
+  ```diff
+  + --salt-palette-text-display-fontWeight: var(--salt-typography-fontWeight-semiBold);
+  + --salt-palette-text-display-fontWeight-small: var(--salt-typography-fontWeight-regular);
+  + --salt-palette-text-display-fontWeight-strong: var(--salt-typography-fontWeight-bold);
+  + --salt-palette-text-heading-fontWeight: var(--salt-typography-fontWeight-semiBold);
+  + --salt-palette-text-heading-fontWeight-small: var(--salt-typography-fontWeight-regular);
+  + --salt-palette-text-heading-fontWeight-strong: var(--salt-typography-fontWeight-bold);
+  + --salt-palette-text-body-fontWeight: var(--salt-typography-fontWeight-regular);
+  + --salt-palette-text-body-fontWeight-small: var(--salt-typography-fontWeight-light);
+  + --salt-palette-text-body-fontWeight-strong: var(--salt-typography-fontWeight-semiBold);
+  + --salt-palette-text-notation-fontWeight: var(--salt-typography-fontWeight-semiBold);
+  + --salt-palette-text-notation-fontWeight-small: var(--salt-typography-fontWeight-regular);
+  + --salt-palette-text-notation-fontWeight-strong: var(--salt-typography-fontWeight-bold);
+  ```
+
+  Wired text characteristics font weight to newly added palette tokens.
+
+  In theme next, when Amplitude is used for heading, font weight will be adjusted accordingly.
+
+- 400c730: - Added `--salt-opacity-45: 0.45`.
+  - Updated `--salt-palette-opacity-primary-border` from `var(--salt-opacity-40)` to `var(--salt-opacity-45)`.
+- 416b7dd: Updated foundation color palette used in theme next due to color contrast concerns, below colors are impacted.
+
+  ```
+  --salt-color-blue-200
+  --salt-color-blue-300
+  --salt-color-blue-400
+  --salt-color-blue-600
+  --salt-color-blue-700
+  --salt-color-blue-800
+  --salt-color-blue-900
+  --salt-color-green-200
+  --salt-color-green-300
+  --salt-color-green-400
+  --salt-color-green-600
+  --salt-color-green-700
+  --salt-color-green-800
+  --salt-color-green-900
+  --salt-color-teal-200
+  --salt-color-teal-300
+  --salt-color-teal-400
+  --salt-color-teal-600
+  --salt-color-teal-700
+  --salt-color-teal-800
+  --salt-color-teal-900
+  --salt-color-orange-200
+  --salt-color-orange-300
+  --salt-color-orange-400
+  --salt-color-orange-500
+  --salt-color-orange-600
+  --salt-color-orange-700
+  --salt-color-orange-800
+  --salt-color-red-300
+  --salt-color-red-400
+  --salt-color-red-600
+  --salt-color-red-700
+  --salt-color-red-800
+  --salt-color-red-900
+  --salt-color-purple-200
+  --salt-color-purple-300
+  --salt-color-purple-400
+  --salt-color-purple-600
+  --salt-color-purple-700
+  --salt-color-purple-800
+  --salt-color-purple-900
+  ```
+
+- 081c82b: Added 20 groups of categorical palette and category characteristics tokens, e.g., cat 1 tokens
+
+  Characteristics
+
+  - `--salt-category-1-subtle-foreground`
+  - `--salt-category-1-subtle-background`
+  - `--salt-category-1-subtle-borderColor`
+  - `--salt-category-1-bold-background`
+  - `--salt-category-1-bold-foreground`
+
+  Palette
+
+  - `--salt-palette-categorical-1`
+  - `--salt-palette-categorical-1-strong`
+  - `--salt-palette-categorical-1-weakest`
+
+## 1.17.0
+
+### Minor Changes
+
+- 2199704e: Added categorical colors. Refer to [color page](https://www.saltdesignsystem.com/salt/foundations/color) for more detail. Closes #2523.
+
+### Patch Changes
+
+- 353e9171: Updated status tokens for theme next to match latest design
+
+## 1.16.0
+
+### Minor Changes
+
+- 25e38e48: ## Characteristics
+
+  Added decorative and informative status foreground tokens. This ensures contrast requirements are met for both text and non-text elements.
+
+  ```diff
+  +  --salt-status-info-foreground-decorative: var(--salt-palette-info-foreground-decorative);
+  +  --salt-status-error-foreground-decorative: var(--salt-palette-error-foreground-decorative);
+  +  --salt-status-warning-foreground-decorative: var(--salt-palette-warning-foreground-decorative);
+  +  --salt-status-success-foreground-decorative: var(--salt-palette-success-foreground-decorative);
+  +
+  +  --salt-status-info-foreground-informative: var(--salt-palette-info-foreground-informative);
+  +  --salt-status-error-foreground-informative: var(--salt-palette-error-foreground-informative);
+  +  --salt-status-warning-foreground-informative: var(--salt-palette-warning-foreground-informative);
+  +  --salt-status-success-foreground-informative: var(--salt-palette-success-foreground-informative);
+  ```
+
+  Deprecated status foreground tokens.
+
+  | Name                             | Replacement                                 |
+  | -------------------------------- | ------------------------------------------- |
+  | --salt-status-info-foreground    | --salt-status-info-foreground-decorative    |
+  | --salt-status-error-foreground   | --salt-status-error-foreground-decorative   |
+  | --salt-status-warning-foreground | --salt-status-warning-foreground-decorative |
+  | --salt-status-success-foreground | --salt-status-success-foreground-decorative |
+
+  ## Palette
+
+  Added decorative and informative info, error, warning and success foreground tokens.
+
+  ### Light
+
+  ```diff
+  +  --salt-palette-info-foreground-decorative: var(--salt-color-blue-500);
+  +  --salt-palette-info-foreground-informative: var(--salt-color-blue-600);
+  +  --salt-palette-error-foreground-decorative: var(--salt-color-red-500);
+  +  --salt-palette-error-foreground-informative: var(--salt-color-red-600);
+  +  --salt-palette-warning-foreground-decorative: var(--salt-color-orange-700);
+  +  --salt-palette-warning-foreground-informative: var(--salt-color-orange-850);
+  +  --salt-palette-success-foreground-decorative: var(--salt-color-green-500);
+  +  --salt-palette-success-foreground-informative: var(--salt-color-green-600);
+  ```
+
+  ### Dark
+
+  ```diff
+  +  --salt-palette-info-foreground-decorative: var(--salt-color-blue-100);
+  +  --salt-palette-info-foreground-informative: var(--salt-color-blue-200);
+  +  --salt-palette-error-foreground-decorative: var(--salt-color-red-400);
+  +  --salt-palette-error-foreground-informative: var(--salt-color-red-200);
+  +  --salt-palette-warning-foreground-decorative: var(--salt-color-orange-500);
+  +  --salt-palette-warning-foreground-informative: var(--salt-color-orange-400);
+  +  --salt-palette-success-foreground-decorative: var(--salt-color-green-400);
+  +  --salt-palette-success-foreground-informative: var(--salt-color-green-200);
+  ```
+
+  Updated info and error border tokens.
+
+  ```diff
+  -  --salt-palette-info-border: var(--salt-color-blue-500);
+  +  --salt-palette-info-border: var(--salt-color-blue-400);
+  -  --salt-palette-error-border: var(--salt-color-red-500);
+  +  --salt-palette-error-border: var(--salt-color-red-400);
+  ```
+
+  Deprecated status foreground tokens.
+
+  | Name                              | Replacement                                  |
+  | --------------------------------- | -------------------------------------------- |
+  | --salt-palette-info-foreground    | --salt-palette-info-foreground-decorative    |
+  | --salt-palette-error-foreground   | --salt-palette-error-foreground-decorative   |
+  | --salt-palette-warning-foreground | --salt-palette-warning-foreground-decorative |
+  | --salt-palette-success-foreground | --salt-palette-success-foreground-decorative |
+
+  ## Foundations
+
+  Added `--salt-color-orange-850`:
+
+  ```diff
+  +  --salt-color-orange-850: rgb(194, 52, 7);
+  ```
+
+- eaab9d89: Switched to use new color palette in theme next when using `UNSTABLE_SaltProviderNext`.
+
+  Refer to [documentation](https://storybook.saltdesignsystem.com/?path=/docs/experimental-theme-next--docs) for more information.
+
+  Closes #3394
+
+- 5ed8ed88: Added new `--salt-overlayable-rangeSelection` token, which points to new `--salt-palette-neutral-selection` and resolves to black@15% in light mode and white@15% in dark mode.
+- e1d4aab8: Supports heading font switch when using `UNSTABLE_SaltProviderNext`.
+
+  Refer to [documentation](https://storybook.saltdesignsystem.com/?path=/docs/experimental-theme-next--docs) for more information.
+
+## 1.15.0
+
+### Minor Changes
+
+- 3fa8b97c: Added new tokens
+
+  | Tier       | Token                                    | Value                                   |
+  | ---------- | ---------------------------------------- | --------------------------------------- |
+  | Foundation | `--salt-typography-fontFamily-openSans`  | "Open Sans"                             |
+  | Foundation | `--salt-typography-fontFamily-ptMono`    | "PT Mono"                               |
+  | Palette    | `--salt-palette-text-fontFamily`         | `--salt-typography-fontFamily-openSans` |
+  | Palette    | `--salt-palette-text-fontFamily-heading` | `--salt-typography-fontFamily-openSans` |
+  | Palette    | `--salt-palette-text-fontFamily-code`    | `--salt-typography-fontFamily-ptMono`   |
+
+  Updated existing token value mapping to use new tokens
+
+  ```diff
+  - --salt-text-fontFamily: var(--salt-typography-fontFamily);
+  + --salt-text-fontFamily: var(--salt-palette-text-fontFamily);
+  - --salt-text-notation-fontFamily: var(--salt-typography-fontFamily);
+  + --salt-text-notation-fontFamily: var(--salt-palette-text-fontFamily);
+  - --salt-text-h1-fontFamily: var(--salt-typography-fontFamily);
+  + --salt-text-h1-fontFamily: var(--salt-palette-text-fontFamily-heading);
+  - --salt-text-h2-fontFamily: var(--salt-typography-fontFamily);
+  + --salt-text-h2-fontFamily: var(--salt-palette-text-fontFamily-heading);
+  - --salt-text-h3-fontFamily: var(--salt-typography-fontFamily);
+  + --salt-text-h3-fontFamily: var(--salt-palette-text-fontFamily-heading);
+  - --salt-text-h4-fontFamily: var(--salt-typography-fontFamily);
+  + --salt-text-h4-fontFamily: var(--salt-palette-text-fontFamily-heading);
+  - --salt-text-label-fontFamily: var(--salt-typography-fontFamily);
+  + --salt-text-label-fontFamily: var(--salt-palette-text-fontFamily);
+  - --salt-text-display1-fontFamily: var(--salt-typography-fontFamily);
+  + --salt-text-display1-fontFamily: var(--salt-palette-text-fontFamily-heading);
+  - --salt-text-display2-fontFamily: var(--salt-typography-fontFamily);
+  + --salt-text-display2-fontFamily: var(--salt-palette-text-fontFamily-heading);
+  - --salt-text-display3-fontFamily: var(--salt-typography-fontFamily);
+  + --salt-text-display3-fontFamily: var(--salt-palette-text-fontFamily-heading);
+  - --salt-text-code-fontFamily: var(--salt-typography-fontFamily-code);
+  + --salt-text-code-fontFamily: var(--salt-palette-text-fontFamily-code);
+  ```
+
+  Deprecated below tokens, use replacement token instead
+
+  ```
+    --salt-typography-fontFamily: var(--salt-typography-fontFamily-openSans);
+    --salt-typography-fontFamily-code: var(--salt-typography-fontFamily-ptMono);
+  ```
+
+- 3fa8b97c: Updated global theme css font family pointing to text chractertics instead of foundation value
+
+  ```diff
+  - font-family: var(--salt-typography-fontFamily);
+  + font-family: var(--salt-text-fontFamily);
+  ```
+
+## 1.14.0
+
+### Minor Changes
+
+- f6202615: Updated `--salt-size-indicator`.
+
+  | Density | Before (px) | After (px) |
+  | ------- | ----------- | ---------- |
+  | High    | 1           | 2          |
+  | Medium  | 2           | 3          |
+  | Low     | 3           | 4          |
+  | Touch   | 4           | 5          |
+
+## 1.13.1
+
+### Patch Changes
+
+- 4f925b41: Fix `--salt-navigable-background-hover` referencing deprecated value `--salt-palette-navigate-primary-background-hover`, change to reference correct value `--salt-palette-navigate-background-hover`
+
+## 1.13.0
+
+### Minor Changes
+
+- f27ecfa7: Added `theme-next.css` which includes experimental theme implementation. Refer to [documentation](https://storybook.saltdesignsystem.com/?path=/docs/experimental-theme-next--docs) for more information.
+
+## 1.12.1
+
+### Patch Changes
+
+- 9d23fdce: Removed `box-sizing: border-box` from global.css. This was causing issues in applications that were built using `box-sizing: content-box`.
+
+## 1.12.0
+
+### Minor Changes
+
+- a374c206: Added `--salt-color-gray-50-fade-border`.
+
+  ```diff
+  + --salt-color-gray-50-fade-border: rgba(206, 210, 217, var(--salt-palette-opacity-disabled));
+  ```
+
+  Updated the values of `--salt-palette-neutral-primary-border`, `--salt-palette-neutral-primary-border-disabled`, `--salt-palette-neutral-secondary-border` and `--salt-palette-neutral-secondary-border-disabled`.
+
+  This will affect the border color of Card, InteractableCard, FileDropZone, ToggleButtonGroup, Overlay, CircularProgress, LinearProgress and SteppedTracker.
+
+  New values in light mode:
+
+  ```diff
+  - --salt-palette-neutral-primary-border: var(--salt-color-gray-60);
+  - --salt-palette-neutral-primary-border-disabled: var(--salt-color-gray-60-fade-border);
+  + --salt-palette-neutral-primary-border: var(--salt-color-gray-50);
+  + --salt-palette-neutral-primary-border-disabled: var(--salt-color-gray-50-fade-border);
+  ```
+
+  ```diff
+  - --salt-palette-neutral-secondary-border: var(--salt-color-gray-90);
+  - --salt-palette-neutral-secondary-border-disabled: var(--salt-color-gray-90-fade-border);
+  + --salt-palette-neutral-secondary-border: var(--salt-color-gray-50);
+  + --salt-palette-neutral-secondary-border-disabled: var(--salt-color-gray-50-fade-border);
+  ```
+
+  New values in dark mode:
+
+  ```diff
+  - --salt-palette-neutral-secondary-border: var(--salt-color-gray-90);
+  - --salt-palette-neutral-secondary-border-disabled: var(--salt-color-gray-90-fade-border);
+  + --salt-palette-neutral-secondary-border: var(--salt-color-gray-300);
+  + --salt-palette-neutral-secondary-border-disabled: var(--salt-color-gray-300-fade-border);
+  ```
+
+## 1.11.1
+
+### Patch Changes
+
+- bef0d509: Undeprecated `--salt-track-borderColor`, which was incorrectly deprecated in feb80146.
+
+## 1.11.0
+
+### Minor Changes
+
+- c6db7d56: Added `--salt-color-white-fade-backdrop` token with value `rgba(255, 255, 255, var(--salt-palette-opacity-backdrop))`
+  Updated `--salt-color-black-fade-backdrop` token to value `rgba(0, 0, 0, var(--salt-palette-opacity-backdrop))`
+
+## 1.10.1
+
+### Patch Changes
+
+- dbc44243: Add --salt-text-background-selected back as a deprecated token after it was accidentally removed.
+
+## 1.10.0
+
+### Minor Changes
+
+- feb80146: **_Theming and CSS updates_** Although these changes are not considered breaking. For teams customizing theme, the following tokens will be impacted. Update them as per suggestion. Deprecated tokens will be removed in the next major version.
+
+  ### Characteristics
+
+  - New tokens added to `text` characteristics
+
+  ```diff
+  + --salt-text-notation-fontFamily: var(--salt-typography-fontFamily);
+  + --salt-text-notation-fontWeight-small: var(--salt-typography-fontWeight-regular);
+  + --salt-text-notation-fontWeight-strong: var(--salt-typography-fontWeight-bold);
+  ```
+
+  - Deprecated tokens in characteristics, use replacement tokens as listed. The change is motivated by several factors including:
+    - reduced number of tokens
+    - easier theming experience
+    - `text.css` updated to `content.css` as tokens are used for more than just texts i.e. icon
+    - consolidating tokens into `text.css` to ensure all text-related tokens are within the same file, aside from text colors, they sit within `content.css`
+    - tidying tokens: `container` no longer has a `tertiary` variant
+
+  #### `text-*` to `content`
+
+  ```diff
+  - --salt-text-link-foreground-hover
+  - --salt-text-link-foreground-active
+  - --salt-text-link-foreground-visited
+  + --salt-content-foreground-hover
+  + --salt-content-foreground-active
+  + --salt-content-foreground-visited
+
+  - --salt-text-primary-foreground
+  - --salt-text-primary-foreground-disabled
+  - --salt-text-secondary-foreground
+  - --salt-text-secondary-foreground-disabled
+  + --salt-content-primary-foreground
+  + --salt-content-primary-foreground-disabled
+  + --salt-content-secondary-foreground
+  + --salt-content-secondary-foreground-disabled
+
+  - --salt-text-background-selected
+  + --salt-content-foreground-highlight
+  ```
+
+  #### `actionable` to `text-action`
+
+  ```diff
+  - --salt-actionable-primary-fontWeight
+  - --salt-actionable-secondary-fontWeight
+  - --salt-actionable-cta-fontWeight
+  + --salt-text-action-fontWeight
+
+  - --salt-actionable-letterSpacing
+  + --salt-text-action-letterSpacing
+
+  - --salt-actionable-textTransform
+  + --salt-text-action-textTransform
+
+  - --salt-actionable-textAlign
+  + --salt-text-action-textAlign
+  ```
+
+  #### `selectable` to various others
+
+  ```diff
+
+  - --salt-selectable-primary-foreground-selected
+  + --salt-actionable-primary-foreground-active
+
+  - --salt-selectable-primary-foreground-selectedDisabled
+  + --salt-color-white-fade-foreground
+
+  - --salt-selectable-primary-background
+  - --salt-selectable-primary-background-disabled
+  - --salt-selectable-primary-background-hover
+  - --salt-selectable-primary-background-selected
+  - --salt-selectable-primary-background-selectedDisabled
+  + --salt-palette-interact-background
+  + --salt-palette-interact-background-disabled
+  + --salt-palette-interact-primary-background-hover
+  + --salt-palette-interact-primary-background-active
+  + --salt-palette-interact-primary-background-activeDisabled
+
+  - --salt-selectable-secondary-foreground-hover
+  - --salt-selectable-secondary-foreground-selected
+  - --salt-selectable-secondary-foreground-selectedDisabled
+  + --salt-palette-interact-secondary-foreground-hover
+  + --salt-palette-interact-secondary-foreground-active
+  + --salt-palette-interact-secondary-foreground-activeDisabled
+
+  - --salt-selectable-secondary-background
+  - --salt-selectable-secondary-background-disabled
+  - --salt-selectable-secondary-background-hover
+  - --salt-selectable-secondary-background-selected
+  - --salt-selectable-secondary-background-selectedDisabled
+  + --salt-palette-interact-background
+  + --salt-palette-interact-background-disabled
+  + --salt-palette-interact-secondary-background-hover
+  + --salt-palette-interact-secondary-background-active
+  + --salt-palette-interact-secondary-background-activeDisabled
+
+  ```
+
+  #### `track` to various others
+
+  ```diff
+  - --salt-track-borderWidth
+  - --salt-track-borderWidth-active
+  - --salt-track-borderWidth-complete
+  - --salt-track-borderWidth-incomplete
+  + --salt-size-border-strong
+  ```
+
+  #### Miscellaneous
+
+  ```diff
+  - --salt-overlayable-shadow-borderRegion
+  + --salt-overlayable-shadow-region
+
+  - --salt-text-link-textDecoration
+  - --salt-text-link-textDecoration-hover
+  - --salt-text-link-textDecoration-selected
+  + --salt-navigable-textDecoration
+  + --salt-navigable-textDecoration-hover
+  + --salt-navigable-textDecoration-selected
+
+  - --salt-navigable-primary-background-hover
+  + --salt-navigable-background-hover
+
+  - --salt-accent-fontWeight
+  - --salt-accent-fontSize
+  - --salt-accent-lineHeight
+  + --salt-text-notation-fontWeight
+  + --salt-text-notation-fontSize
+  + --salt-text-notation-lineHeight: 10px; /* Value previously 11px in HD */
+
+  ```
+
+  - Deprecated tokens with no direct replacement tokens, use values suggested in comments
+
+  ```diff
+  - --salt-taggable-cursor-hover /* Use `pointer` */
+  - --salt-taggable-cursor-active /* Use `pointer` */
+  - --salt-taggable-cursor-disabled /* Use `not-allowed` */
+
+  - --salt-taggable-background /* Use rgb(197, 201, 208) in light mode, rgb(76, 80, 91) in dark mode */
+  - --salt-taggable-background-hover /* Use rgb(217, 221, 227) in light mode, rgb(97, 101, 110) in dark mode */
+  - --salt-taggable-background-active /* Use --salt-palette-interact-primary-background-active Use rgb(97, 101, 110) in light mode, rgb(180, 183, 190) in dark mode */
+  - --salt-taggable-background-disabled /* Use --salt-palette-interact-primary-background-disabled Use rgba(197, 201, 208, 0.4) in light mode, rgba(76, 80, 91, 0.4) in dark mode */
+
+  - --salt-taggable-foreground /* Use rgb(255, 255, 255) */
+  - --salt-taggable-foreground-hover /* Use rgb(255, 255, 255) */
+  - --salt-taggable-foreground-active /* Use rgb(22, 22, 22) */
+  - --salt-taggable-foreground-disabled /* Use rgba(255, 255, 255, 0.4) */
+
+  - --salt-navigable-primary-background /* Use `transparent` */
+  - --salt-navigable-primary-background-active /* Use `transparent` */
+  - --salt-navigable-secondary-background /* Use `transparent` */
+  - --salt-navigable-secondary-background-hover /* Use rgb(76, 80, 91) in light mode, rgb(47, 49, 54) in dark mode */
+  - --salt-navigable-secondary-background-active /* Use `transparent` */
+  - --salt-navigable-tertiary-background /* Use `transparent` */
+  - --salt-navigable-tertiary-background-hover /* Use rgb(234, 237, 239) in light mode,  rgb(42, 44, 47) in dark mode */
+  - --salt-navigable-tertiary-background-active /* Use `transparent` */
+
+  - --salt-navigable-indicator-activeDisabled /* Use rgba(224, 101, 25, 0.4) in light mode, rgba(238, 133, 43, 0.4) in dark mode */
+
+  - --salt-accent-foreground-disabled /* Use rgba(255, 255, 255, 0.4) */
+  - --salt-accent-background-disabled /* Use rgba(38, 112, 169, 0.4) */
+  - --salt-accent-borderColor-disabled /* Use --salt-container-primary-borderColor-disabled */
+
+  - --salt-track-fontWeight /* Use --salt-typography-fontWeight-semiBold */
+  - --salt-track-textAlign /* Use `center` */
+
+  - --salt-track-background  /* Use rgb(197, 201, 208) in light mode, rgb(76, 80, 91); in dark mode */
+  - --salt-track-background-disabled /* Use  rgba(197, 201, 208,0.4) in light mode, rgba(76, 80, 91,0.4) in dark mode */
+
+  - --salt-track-borderColor-disabled /* Use rgba(132, 135, 142, 0.4) in both light and dark modes */
+
+  - --salt-selectable-cta-foreground-hover /* Use rgb(255, 255, 255) in both light and dark mode */
+  - --salt-selectable-cta-foreground-selected /* Use rgb(255, 255, 255) in both light and dark mode */
+  - --salt-selectable-cta-foreground-selectedDisabled /* Use rgba(255, 255, 255,0.4) in both light and dark mode  */
+
+  - --salt-selectable-cta-background /* Use `transparent` */
+  - --salt-selectable-cta-background-disabled /* Use `transparent` */
+  - --salt-selectable-cta-background-hover /* Use rgb(203, 231, 249) in light mode, rgb(39, 60, 77) in dark mode */
+  - --salt-selectable-cta-background-selected /* Use rgb(164, 213, 244) in light mode, rgb(0, 71, 123) in dark mode */
+  - --salt-selectable-cta-background-selectedDisabled /* Use  rgba(164, 213, 244,0.4) in light mode,rgba(0, 71, 123, 0.4) in dark mode */
+  - --salt-selectable-primary-foreground-hover /* Use rgb(38, 112, 169) in both light and dark mode */
+
+  - --salt-container-tertiary-background /* Use `transparent` */
+  - --salt-container-tertiary-background-disabled /* Use `transparent` */
+  - --salt-container-tertiary-borderColor /* Use `transparent` */
+  - --salt-container-tertiary-borderColor-disabled /* Use `transparent` */
+  ```
+
+  ### Foundations
+
+  - Updated `neutral` token value in `light` mode
+
+  ```diff
+  - --salt-palette-neutral-backdrop: var(--salt-color-black-fade-backdrop)
+  + --salt-palette-neutral-backdrop: var(--salt-color-white-fade-backdrop)
+  ```
+
+  - Updated `size` token value for HD. Expect components using this token to have visual changes. This change would not affect `Icon` component as the smallest icon size remains as `12px`, like in UITK.
+
+  ```diff
+  - --salt-size-icon: 12px;
+  + --salt-size-icon: 10px;
+  ```
+
+  - New tokens added
+
+  In `size.css` foundations,
+
+  ```diff
+  + --salt-size-bar-small: 2px; /* for all densities */
+  + --salt-size-border-strong: 2px /* for all densities */
+  + --salt-size-bar-strong
+  ```
+
+  In `fade.css` foundations,
+
+  ```diff
+  + --salt-color-black-fade-background-hover: rgba(0, 0, 0, var(--salt-opacity-8))
+  + --salt-color-white-fade-background-hover: rgba(255, 255, 255, var(--salt-opacity-8))
+  ```
+
+  - Deprecated tokens in foundations, use replacement tokens as listed
+
+  ```diff
+  - --salt-icon-size-base
+  - --salt-icon-size-status-adornment
+  + --salt-size-icon
+  + --salt-size-adornment
+
+  - --salt-shadow-1
+  - --salt-shadow-2
+  - --salt-shadow-3
+  - --salt-shadow-4
+  - --salt-shadow-5
+  + --salt-shadow-100
+  + --salt-shadow-200
+  + --salt-shadow-300
+  + --salt-shadow-400
+  + --salt-shadow-500
+
+  - --salt-shadow-1-color
+  - --salt-shadow-2-color
+  - --salt-shadow-3-color
+  - --salt-shadow-4-color
+  - --salt-shadow-5-color
+  + --salt-shadow-100-color
+  + --salt-shadow-200-color
+  + --salt-shadow-300-color
+  + --salt-shadow-400-color
+  + --salt-shadow-500-color
+
+  - --salt-palette-navigate-primary-background-hover (light mode)
+  + --salt-palette-navigate-background-hover: var(--salt-color-black-fade-background-hover)
+  - --salt-palette-navigate-primary-background-hover (dark mode)
+  + --salt-palette-navigate-background-hover: var(--salt-color-white-fade-background-hover)
+  ```
+
+  - Deprecated tokens with no replacement tokens, use values suggested in comments
+
+  ```diff
+  - --salt-shadow-0 /* Use `none` */
+  ```
+
+  ### Palette
+
+  - Deprecated tokens with no replacement tokens, use values suggested in comments
+
+  ```diff
+  - --salt-palette-navigate-primary-background /* Use `transparent` */
+  - --salt-palette-navigate-primary-background-active /* Use `transparent` */
+  - --salt-palette-navigate-secondary-background /* Use `transparent` */
+  - --salt-palette-navigate-secondary-background-hover /* Use --salt-color-gray-30 in light mode, --salt-color-gray-600 in dark mode */
+  - --salt-palette-navigate-secondary-background-active /* Use `transparent` */
+  - --salt-palette-navigate-tertiary-background /* Use `transparent` */
+  - --salt-palette-navigate-tertiary-background-hover /* Use --salt-color-gray-20 in light mode, --salt-color-gray-700 in dark mode */
+  - --salt-palette-navigate-tertiary-background-active /* Use `transparent` */
+
+  - --salt-palette-navigate-indicator-activeDisabled /* Use --salt-color-orange-600-fade-border in light mode, --salt-color-orange-400-fade-border in dark mode */
+
+  - --salt-palette-neutral-tertiary-background /* Use `transparent` */
+  - --salt-palette-neutral-tertiary-background-disabled /* Use `transparent` */
+  - --salt-palette-neutral-tertiary-border /* Use `transparent` */
+  - --salt-palette-neutral-tertiary-border-disabled /* Use `transparent` */
+
+  - --salt-palette-track-border /* Use --salt-color-gray-90 */
+  - --salt-palette-track-border-disabled /* Use --salt-color-gray-90-fade-border */
+
+  - --salt-palette-track-background /* Use --salt-color-gray-60 in light mode, --salt-color-gray-300 in dark mode */
+  - --salt-palette-track-background-disabled /* Use --salt-color-gray-60-fade-border in light mode, --salt-color-gray-300-fade-border in dark mode */
+
+  - --salt-palette-interact-cta-foreground-activeDisabled /* Use --salt-color-white-fade-foreground */
+  - --salt-palette-interact-cta-background-activeDisabled /* Use --salt-color-blue-700-fade-background */
+
+  - --salt-palette-interact-primary-foreground-activeDisabled /* Use --salt-color-white-fade-foreground in light mode, --salt-color-gray-900-fade-foreground in dark mode */
+  - --salt-palette-interact-primary-background-activeDisabled /* Use --salt-color-gray-200-fade-background in light mode, --salt-color-gray-70-fade-background in dark mode */
+
+  - --salt-palette-interact-secondary-foreground-activeDisabled /* Use --salt-color-white-fade-foreground in light mode, --salt-color-gray-900-fade-foreground in dark mode */
+  - --salt-palette-interact-secondary-background-activeDisabled /* Use --salt-color-gray-200-fade-background in light mode, --salt-color-gray-70-fade-background in dark mode */
+
+  - --salt-palette-accent-foreground-disabled /* Use --salt-color-white-fade-foreground */
+  - --salt-palette-accent-background-disabled /* Use --salt-color-blue-500-fade-background */
+  - --salt-palette-accent-border-disabled /* Use --salt-color-blue-500-fade-border */
+  ```
+
+## 1.9.0
+
+### Minor Changes
+
+- 319140a6: New token added in `size.css` foundations:
+
+  ```diff
+  + --salt-size-bar-small
+  ```
+
+- 01f3a2b3: New token added in `size.css` foundations:
+
+  ```diff
+  + --salt-size-bar-strong
+  + --salt-size-bar-small
+  ```
+
+## 1.8.0
+
+### Minor Changes
+
+- 7f03e39f: Added a new size token: `--salt-size-indicator`
+
+### Patch Changes
+
+- 7f03e39f: Deprecated the following size tokens:
+
+  | Name                              | Replacement                               |
+  | --------------------------------- | ----------------------------------------- |
+  | `--salt-size-basis-unit`          | 4px                                       |
+  | `--salt-size-adornmentGap`        | `--salt-spacing-75`                       |
+  | `--salt-size-container-spacing`   | `--salt-spacing-300`                      |
+  | `--salt-size-divider-strokeWidth` | `--salt-size-border`                      |
+  | `--salt-size-separator-height`    | `--salt-size-base`                        |
+  | `--salt-size-stackable`           | `--salt-size-base` + `--salt-spacing-100` |
+  | `--salt-size-unit`                | `--salt-spacing-100`                      |
+  | `--salt-size-compact`             | `--salt-size-adornment`                   |
+  | `--salt-size-accent`              | `--salt-size-bar`                         |
+  | `--salt-size-sharktooth-height`   | 5px                                       |
+  | `--salt-size-sharktooth-width`    | 10px                                      |
+
+- f1815504: Deprecated `--salt-zIndex-docked`. You can use `1050` directly if you need to.
+
+## 1.7.1
+
+### Patch Changes
+
+- 2c6d86dd: Theme
+
+  - Added `both` fill-mode to `--salt-animation-slide-out-*` css animation vars
+
+## 1.7.0
+
+### Minor Changes
+
+- 21a76576: Added a new selectable token: `--salt-selectable-borderColor-readonly`.
+
+  Changed the value of `--salt-palette-opacity-border-readonly`.
+
+  ```diff
+  - --salt-palette-opacity-border-readonly: var(--salt-opacity-8);
+  + --salt-palette-opacity-border-readonly: var(--salt-opacity-15);
+  ```
+
+- b2ec14d9: Changed opacity foundation to a new scaled system.
+  Deprecated tokens `--salt-opacity-1`, `--salt-opacity-2`, `--salt-opacity-3`, `--salt-opacity-4`.
+
+  | Foundation token (deprecated) | Value | Use instead       |
+  | ----------------------------- | ----- | ----------------- |
+  | --salt-opacity-1              | 0.15  | --salt-opacity-15 |
+  | --salt-opacity-2              | 0.25  | --salt-opacity-25 |
+  | --salt-opacity-3              | 0.40  | --salt-opacity-40 |
+  | --salt-opacity-4              | 0.70  | --salt-opacity-70 |
+
+  ```diff
+  - --salt-opacity-15: 0.15;
+  - --salt-opacity-25: 0.25;
+  - --salt-opacity-40: 0.40;
+  - --salt-opacity-70: 0.70;
+  + --salt-opacity-0: 0.00;
+  + --salt-opacity-8: 0.08;
+  + --salt-opacity-15: 0.15;
+  + --salt-opacity-25: 0.25;
+  + --salt-opacity-40: 0.40;
+  + --salt-opacity-70: 0.70;
+  ```
+
+  Added `--salt-palette-opacity-disabled` to replace `--salt-palette-opacity-border`, `--salt-palette-opacity-background`, `--salt-palette-opacity-foreground`, `--salt-palette-opacity-fill`, `--salt-palette-opacity-stroke`
+
+  | Palette token (deprecated)        | Value  | Use instead                     | New value |
+  | --------------------------------- | ------ | ------------------------------- | --------- |
+  | --salt-palette-opacity-background | 0.40   | --salt-palette-opacity-disabled | 0.40      |
+  | --salt-palette-opacity-border     | 0.40   | --salt-palette-opacity-disabled | 0.40      |
+  | --salt-palette-opacity-stroke     | 0.40   | --salt-palette-opacity-disabled | 0.40      |
+  | --salt-palette-opacity-fill       | 0.40   | --salt-palette-opacity-disabled | 0.40      |
+  | --salt-palette-opacity-foreground | 0.70\* | --salt-palette-opacity-disabled | 0.40      |
+
+  \* Usages of `--salt-palette-opacity-foreground` should now map to a value of 0.40 rather than 0.70
+
+  Mapped palette opacity tokens to new opacity values
+
+  | Palette token                              | Old value              | New value               |
+  | ------------------------------------------ | ---------------------- | ----------------------- |
+  | --salt-palette-opacity-background-readonly | --salt-opacity-1: 0.15 | --salt-opacity-0: 0.00  |
+  | --salt-palette-opacity-border-readonly     | --salt-opacity-2: 0.25 | --salt-opacity-8: 0.08  |
+  | --salt-palette-opacity-backdrop            | --salt-opacity-4: 0.70 | --salt-opacity-70: 0.70 |
+  | --salt-palette-opacity-primary-border      | --salt-opacity-3: 0.40 | --salt-opacity-40: 0.40 |
+  | --salt-palette-opacity-secondary-border    | --salt-opacity-2: 0.25 | --salt-opacity-25: 0.25 |
+  | --salt-palette-opacity-tertiary-border     | --salt-opacity-1: 0.15 | --salt-opacity-15: 0.15 |
+
+  ```diff
+  - --salt-palette-opacity-background: var(--salt-opacity-3);
+  - --salt-palette-opacity-border: var(--salt-opacity-3);
+  - --salt-palette-opacity-foreground: var(--salt-opacity-4);
+  - --salt-palette-opacity-fill: var(--salt-opacity-3);
+  - --salt-palette-opacity-stroke: var(--salt-opacity-3);
+  - --salt-palette-opacity-background-readonly:   var(--salt-opacity-1);
+  - --salt-palette-opacity-border-readonly: var(--salt-opacity-2);
+  - --salt-palette-opacity-backdrop: var(--salt-opacity-4);
+  - --salt-palette-opacity-primary-border: var(--salt-opacity-3);
+  - --salt-palette-opacity-secondary-border: var(--salt-opacity-2);
+  - --salt-palette-opacity-tertiary-border: var(--salt-opacity-1);
+  + --salt-palette-opacity-backdrop: var(--salt-opacity-70);
+  + --salt-palette-opacity-background-readonly: var(--salt-opacity-0);
+  + --salt-palette-opacity-border-readonly: var(--salt-opacity-8);
+  + --salt-palette-opacity-primary-border: var(--salt-opacity-40);
+  + --salt-palette-opacity-secondary-border: var(--salt-opacity-25);
+  + --salt-palette-opacity-tertiary-border: var(--salt-opacity-15);
+  + --salt-palette-opacity-disabled: var(--salt-opacity-40);
+  ```
+
+### Patch Changes
+
+- 1f0cb87d: Refactored the theme file structure for easier maintainability.
+
+  Added the missing deprecated token: `--salt-palette-warning-foreground-disabled`.
+
+- 87556137: Changed `--salt-duration-instant` to 0ms
+
+## 1.6.0
+
+### Minor Changes
+
+- c9981881: New token introduced in `selectable` characteristic, new palette tokens
+
+  ```diff
+  + --salt-selectable-background-selectedDisabled: var(--salt-palette-interact-background-activeDisabled);
+  ```
+
+  New value in light mode
+
+  ```diff
+  + --salt-palette-interact-background-activeDisabled: var(--salt-color-blue-30-fade-background);
+  ```
+
+  New value in dark mode
+
+  ```diff
+  + --salt-palette-interact-background-activeDisabled: var(--salt-color-blue-700-fade-background);
+  ```
+
+- 71fc7474: Add new list components: ListNext, ListItemNext
+
+  ```
+  <ListNext>
+    <ListItemNext value={Alaska}>
+      {Alaska}
+    </ListItemNext>
+  </ListNext>
+
+  ```
+
+- b52cc743: Deprecated the following tokens: Use hex value as replacement if needed.
+
+  ```diff
+  - --salt-status-info-foreground-disabled: #2670A9B3
+  - --salt-status-success-foreground-disabled: #24874BB3
+  - --salt-status-warning-foreground-disabled: #EA7319B3
+  - --salt-status-error-foreground-disabled: #E32B16B3
+  - --salt-status-static-foreground-disabled: #61656E | #B4B7BE
+  - --salt-status-negative-foreground-disabled: #FF5942B3 | #A6150BB3
+  - --salt-status-positive-foreground-disabled: #3CAB60B3 | #0C5D2EB3
+  - --salt-status-info-borderColor-disabled: #2670A966
+  - --salt-status-success-borderColor-disabled: #24874B66
+  - --salt-status-warning-borderColor-disabled: #EA731966
+  - --salt-status-error-borderColor-disabled: #E32B1666
+  - --salt-palette-error-border-disabled: #E32B1666
+  - --salt-palette-warning-border-disabled: #EA731966
+  - --salt-palette-success-border-disabled: #24874B66
+  - --salt-palette-info-border-disabled: #2670A966
+  - --salt-palette-error-foreground-disabled: #E32B16B3
+  - --salt-palette-success-foreground-disabled: #24874BB3
+  - --salt-palette-info-foreground-disabled: #2670A9B3
+  ```
+
+  Any components that have a validation state should not be able to simultaneously be disabled. Consider altering code if this is the case.
+
+- 5227fd57: Added `--salt-selectable-cursor-readonly` token with `not-allowed` value
+
+## 1.5.1
+
+### Patch Changes
+
+- 813daa28: Fixed the duration foundation token values having invalid values
+
+## 1.5.0
+
+### Minor Changes
+
+- b6f304f9: Added size tokens
+
+  ```diff
+  + --salt-size-adornment
+  + --salt-size-bar
+  + --salt-size-selectable
+  + --salt-size-icon
+  ```
+
+  `--salt-size-base ` changed from a calculation on the basis unit to hardcoded values per density
+  `--salt-size-border` defined as 1px per density rather than set globally
+
+- e8b146a5: Add new spacing tokens and a spacing foundation.
+
+  ```css
+  --salt-spacing-25
+  --salt-spacing-50
+  --salt-spacing-75
+  --salt-spacing-100
+  --salt-spacing-150
+  --salt-spacing-200
+  --salt-spacing-250
+  --salt-spacing-300
+  --salt-spacing-350
+  --salt-spacing-400
+  ```
+
+### Patch Changes
+
+- 1e9ef1a2: Fix duplicate Salt libraries being installed when multiple libraries are installed
+
+## 1.4.0
+
+### Minor Changes
+
+- 8bcc9d04: Deprecated tertiary editable tokens: If needed, use `#00000066` as a replacement for `--salt-editable-tertiary-background-readonly`, and use `transparent` as a replacement for all remaining tokens
+  Deprecated `tertiary` variant in FormField
+- bf66b578: Deprecated -emphasize tokens in status and palette; replaced with default tokens
+
+  `--salt-status-error-background-emphasize` replaced with `--salt-status-error-background`
+  `--salt-status-info-background-emphasize` replaced with `--salt-status-info-background`
+  `--salt-status-success-background-emphasize` replaced with `--salt-status-success-background`
+  `--salt-status-warning-background-emphasize` replaced with `--salt-status-warning-background`
+
+  `--salt-palette-error-background-emphasize` replaced with `--salt-palette-error-background`
+  `--salt-palette-info-background-emphasize` replaced with `--salt-palette-info-background`
+  `--salt-palette-success-background-emphasize` replaced with `--salt-palette-success-background`
+  `--salt-palette-warning-background-emphasize` replaced with `--salt-palette-warning-background`
+
+- ea857f24: Deprecated `--salt-size-icon-base`, replaced with `--salt-icon-size-base`
+  Added `--salt-icon-size-status-adornment`
+
+## 1.3.0
+
+### Minor Changes
+
+- 6d2c3a32: Deprecate delay foundation; replace with duration
+- ea010ffa: New `--salt-size-container-spacing` and `--salt-size-adornmentGap` tokens
+
+  ```diff
+  +  --salt-size-container-spacing: calc(3 * var(--salt-size-unit));
+  +  --salt-size-adornmentGap: calc(0.75 * var(--salt-size-unit));
+  ```
+
+- d8f8b305: Added `--salt-accent-foreground-disabled`
+
+  ```diff
+  + --salt-accent-foreground-disabled: var(--salt-palette-accent-foreground-disabled)
+  + --salt-palette-accent-foreground-disabled
+  ```
+
+- 7a025091: Bug fix
+
+  ```diff
+  - --salt-palette-interact-foreground-disabled: var(--salt-color-90-fade-foreground);
+  + --salt-palette-interact-foreground-disabled: var(--salt-color-gray-90-fade-foreground);
+  ```
+
+- 91e7cbdf: Added `--salt-accent-borderColor-disabled`
+
+  ```diff
+  + --salt-accent-borderColor-disabled: var(--salt-palette-accent-border-disabled);
+  + --salt-palette-accent-border-disabled
+  ```
+
+### Patch Changes
+
+- 8d29c01f: New font family css variable for all text components which point to `--salt-typography-fontFamily`.
+
+  ```
+  --salt-text-display1-fontFamily
+  --salt-text-display2-fontFamily
+  --salt-text-display3-fontFamily
+  --salt-text-h1-fontFamily
+  --salt-text-h2-fontFamily
+  --salt-text-h3-fontFamily
+  --salt-text-h4-fontFamily
+  --salt-text-label-fontFamily
+  ```
+
+## 1.2.0
+
+### Minor Changes
+
+- 974c92da: - New characteristics introduced in `accent`, new palette token
+
+  ```diff
+  + --salt-accent-background-disabled: var(--salt-palette-accent-background-disabled);
+  + --salt-palette-accent-background-disabled
+  ```
+
+  - New characteristics introduced in `selectable`, new palette tokens
+
+  ```diff
+  + --salt-selectable-foreground: var(--salt-palette-interact-foreground);
+  + --salt-selectable-foreground-disabled: var(--salt-palette-interact-foreground-disabled);
+  + --salt-selectable-foreground-hover: var(--salt-palette-interact-foreground-hover);
+  + --salt-selectable-foreground-selected: var(--salt-palette-interact-foreground-active);
+  + --salt-selectable-foreground-selectedDisabled: var(--salt-palette-interact-foreground-activeDisabled);
+  + --salt-palette-interact-foreground-active
+  + --salt-palette-interact-foreground-activeDisabled
+  + --salt-palette-interact-foreground-hover
+  ```
+
+  Updated values in light mode
+
+  ```diff
+  - --salt-palette-interact-foreground: var(--salt-color-gray-900);
+  + --salt-palette-interact-foreground: var(--salt-color-gray-200);
+  - --salt-palette-interact-foreground-disabled: var(--salt-color-gray-900-fade-foreground);
+  + --salt-palette-interact-foreground-disabled: var(--salt-color-gray-200-fade-foreground);
+  - --salt-palette-interact-foreground-hover: var(--salt-color-gray-500);
+  + --salt-palette-interact-foreground-hover: var(--salt-color-blue-500);
+  ```
+
+  Updated values in dark mode
+
+  ```diff
+  - --salt-palette-interact-foreground: var(--salt-color-white);
+  + --salt-palette-interact-foreground: var(--salt-color-gray-90);
+  - --salt-palette-interact-foreground-disabled: var(--salt-color-white-fade-foreground);
+  + --salt-palette-interact-foreground-disabled: var(--salt-color-gray-90-fade-foreground);
+  - --salt-palette-interact-foreground-hover: var(--salt-color-gray-500);
+  + --salt-palette-interact-foreground-hover: var(--salt-color-blue-500);
+  ```
+
+  - Deprecated the following `selectable` tokens, use `--salt-text-primary-foreground` and `--salt-text-primary-foreground-disabled` as replacements
+
+  ```diff
+  - --salt-selectable-cta-foreground
+  - --salt-selectable-cta-foreground-disabled
+  - --salt-selectable-primary-foreground
+  - --salt-selectable-primary-foreground-disabled
+  - --salt-selectable-secondary-foreground
+  - --salt-selectable-secondary-foreground-disabled
+  - --salt-selectable-foreground-partial
+  - --salt-selectable-foreground-partialDisabled
+  ```
+
+  - `Measured` characteristic replaced with `Track`
+
+  Deprecated tokens prefixed by `--salt-measured-` and corresponding palette tokens
+  New `--salt-track-` tokens and corresponding palette tokens
+
+  The following are a direct replacement mapping:
+
+  ```diff
+  - --salt-measured-borderStyle
+  - --salt-measured-borderStyle-active
+  - --salt-measured-borderStyle-complete
+  - --salt-measured-borderStyle-incomplete
+  + --salt-track-borderStyle
+  + --salt-track-borderStyle-active
+  + --salt-track-borderStyle-complete
+  + --salt-track-borderStyle-incomplete
+  - --salt-measured-borderWidth
+  - --salt-measured-borderWidth-active
+  - --salt-measured-borderWidth-complete
+  - --salt-measured-borderWidth-incomplete
+  + --salt-track-borderWidth
+  + --salt-track-borderWidth-active
+  + --salt-track-borderWidth-complete
+  + --salt-track-borderWidth-incomplete
+  - --salt-measured-fontWeight
+  - --salt-measured-textAlign
+  + --salt-track-fontWeight
+  + --salt-track-textAlign
+  - --salt-measured-background: var(--salt-palette-measured-background);
+  - --salt-measured-background-disabled: var(--salt-palette-measured-background-disabled);
+  - --salt-measured-borderColor: var(--salt-palette-measured-border);
+  + --salt-track-background: var(--salt-palette-track-background);
+  + --salt-track-background-disabled: var(--salt-palette-track-background-disabled);
+  + --salt-track-borderColor: var(--salt-palette-track-border);
+  + --salt-track-borderColor-disabled: var(--salt-palette-track-border-disabled);
+  - --salt-palette-measured-background
+  - --salt-palette-measured-background-disabled
+  - --salt-palette-measured-border
+  - --salt-palette-measured-border-disabled
+  + --salt-palette-track-background
+  + --salt-palette-track-background-disabled
+  + --salt-palette-track-border
+  + --salt-palette-track-border-disabled
+  ```
+
+  The following should be replaced with the corresponding `selectable` tokens:
+
+  ```diff
+  - --salt-measured-foreground: var(--salt-palette-measured-foreground);
+  - --salt-measured-foreground-disabled: var(--salt-palette-measured-foreground-disabled);
+  - --salt-measured-foreground-hover: var(--salt-palette-measured-foreground-active);
+  - --salt-measured-foreground-active: var(--salt-palette-measured-foreground-active);
+  - --salt-measured-foreground-activeDisabled: var(--salt-palette-measured-foreground-activeDisabled);
+  - --salt-measured-borderColor-disabled: var(--salt-palette-measured-border-disabled);
+  ```
+
+  The following should be replaced with the corresponding `accent` background tokens:
+
+  ```diff
+  - --salt-measured-fill: var(--salt-palette-measured-fill);
+  - --salt-measured-fill-disabled: var(--salt-palette-measured-fill-disabled);
+  ```
+
+  - Usages of `measured` tokens in core and labs components updated to use appropriate characteristic replacement
+
+  - Deprecated the following tokens, use hex value as replacement if needed:
+
+  ```diff
+  - --salt-measured-foreground-undo: #2670a9
+  - --salt-palette-measured-fill: #2670A9
+  - --salt-palette-measured-fill-disabled: #2670A966
+  - --salt-palette-measured-foreground-active: #2670A9
+  - --salt-palette-measured-foreground-activeDisabled: #2670A966
+  - --salt-palette-interact-foreground-partial: #155C93
+  - --salt-palette-interact-foreground-partialDisabled: #155C93B3
+  ```
+
+- d2b983de: New status tokens
+
+  ```diff
+  + --salt-status-info-foreground-disabled: var(--salt-palette-info-foreground-disabled);
+  + --salt-status-success-foreground-disabled: var(--salt-palette-success-foreground-disabled);
+  + --salt-status-warning-foreground-disabled: var(--salt-palette-warning-foreground-disabled);
+  + --salt-status-error-foreground-disabled: var(--salt-palette-error-foreground-disabled);
+  + --salt-status-static-foreground-disabled: var(--salt-palette-neutral-secondary-foreground-disabled);
+  + --salt-status-negative-foreground-disabled: var(--salt-palette-negative-foreground-disabled);
+  + --salt-status-positive-foreground-disabled: var(--salt-palette-positive-foreground-disabled);
+
+  + --salt-status-info-borderColor-disabled: var(--salt-palette-info-border-disabled);
+  + --salt-status-success-borderColor-disabled: var(--salt-palette-success-border-disabled);
+  + --salt-status-warning-borderColor-disabled: var(--salt-palette-warning-border-disabled);
+  + --salt-status-error-borderColor-disabled: var(--salt-palette-error-border-disabled);
+
+  + --salt-palette-info-border-disabled
+  + --salt-palette-info-foreground-disabled
+  + --salt-palette-warning-border-disabled
+  + --salt-palette-warning-foreground-disabled
+  + --salt-palette-error-border-disabled
+  + --salt-palette-error-foreground-disabled
+  + --salt-palette-success-foreground-disabled
+  + --salt-palette-success-border-disabled
+  + --salt-palette-negative-foreground-disabled
+  + --salt-palette-positive-foreground-disabled
+  ```
+
+## 1.1.0
+
+### Minor Changes
+
+- d460fb7b: Deprecated `--salt-size-detail`; replaced with `--salt-size-compact`
+- 5ead0bbf: Deprecated `--salt-size-selection`; replaced with `--salt-size-selectable`
+- 2e0fdff0: Deprecated `--salt-size-graphic-small`, `--salt-size-graphic-medium`, `--salt-size-graphic-large`
+  Deprecated `--salt-size-divider-height`, `--salt-size-divider-strokeWidth`, replaced with `--salt-size-separator-height`, `--salt-size-separator-strokeWidth`
+- 9d3dda91: Theme update: changed the value of `--salt-palette-warning-border` and `--salt-palette-warning-foreground` to `--salt-color-orange-700` in light mode to fix accessibility issues
+- 649d5394: Added a new opacity token for readonly backgrounds
+
+  ```diff
+  - --salt-color-white-fade-background-readonly: rgba(255, 255, 255, var(--salt-palette-opacity-readonly));
+  - --salt-color-gray-20-fade-background-readonly: rgba(234, 237, 239, var(--salt-palette-opacity-readonly));
+  - --salt-color-gray-600-fade-background-readonly: rgba(47, 49, 54, var(--salt-palette-opacity-readonly));
+  - --salt-color-gray-800-fade-background-readonly: rgba(36, 37, 38, var(--salt-palette-opacity-readonly));
+  + --salt-palette-opacity-background-readonly: var(--salt-opacity-1)
+  + --salt-color-white-fade-background-readonly: rgba(255, 255, 255, var(--salt-palette-opacity-background-readonly));
+  + --salt-color-gray-20-fade-background-readonly: rgba(234, 237, 239, var(--salt-palette-opacity-background-readonly));
+  + --salt-color-gray-600-fade-background-readonly: rgba(47, 49, 54, var(--salt-palette-opacity-background-readonly));
+  + --salt-color-gray-800-fade-background-readonly: rgba(36, 37, 38, var(--salt-palette-opacity-background-readonly));
+  ```
+
+- e33f5610: Theme update: changed the value of `--salt-palette-success-border` and `--salt-palette-success-foreground` to `--salt-color-green-400` in dark mode to fix accessibility issues
+- d975171f: Deprecated `--salt-size-brandBar`; replaced with `--salt-size-accent` with new density dependent values
+- 9cae606a: Deprecated differential characteristic; replaced tokens with below
+  Moved differential tokens to status characteristic
+  Added 'static' status variant
+
+  ```diff
+  - --salt-differential-positive-foreground
+  - --salt-differential-negative-foreground
+  + --salt-status-positive-foreground
+  + --salt-status-negative-foreground
+  + --salt-status-static-foreground
+  ```
+
+- 1f579da6: Added tokens for success, warning, and error backgrounds on selected state
+
+  ```diff
+  + --salt-status-success-background-selected
+  + --salt-status-warning-background-selected
+  + --salt-status-error-background-selected
+  + --salt-palette-success-background-selected
+  + --salt-palette-warning-background-selected
+  + --salt-palette-error-background-selected
+  ```
+
+### Patch Changes
+
+- 8e9446bf: Fixed the shadow token value
+
+  ```diff
+  - --salt-shadow-5: 0 12px 40px 5px var(--salt-shadow-5-color);
+  + --salt-shadow-5: 0 12px 40px 0 var(--salt-shadow-5-color);
+  ```
+
+- 1ad02da3: Deprecated `--salt-overlayable-shadow-scroll-color`, use `--salt-shadow-1-color` instead
+
+## 1.0.0
+
+### Major Changes
+
+- c1bc7479: Salt is the J.P. Morgan design system, an open-source solution for building exceptional products and digital experiences in financial services and other industries. It offers you well-documented, accessible components as well as comprehensive design templates, style libraries and assets.
+
+  With this initial release we're providing:
+
+  - AG Grid Theme
+  - Border Layout
+  - Button
+  - Data Grid
+  - Flex Layout
+  - Flow Layout
+  - Grid Layout
+  - Icon
+  - Link
+  - Salt Provider
+  - Stack Layout
+  - Status Indicator
+  - Text
+  - Theme
+
+  And a number of other lab components.