Change Log
============

1.7.0 - April 9, 2026
----------
New Features:
* New `syntaxColorBlack` and `syntaxColorWhite` tokens (SUI-8584).
* New base design tokens that define theme-invariant color primitives (SUI-8608).
* New `unstable_splunk1cdThemeCustomizer` export for applying the 1CD (One Cisco Design) theme variant (SUI-8769).
* `storybook-addon-splunk-themes` now supports `enableSplunk1cdOption` parameter to show the `splunk-1cd` family option in the Storybook toolbar (SUI-8769).
* New data visualization color tokens with improved accessibility support: Static A/B, Categorical A/B (default and Strong), Divergent A-D (default and Strong), and Sequential A-F (default and Strong) (SUI-8574).

Bug Fixes:
* `storybook-addon-splunk-themes` global styles no longer incorrectly apply to all `thead th` elements in the Storybook canvas (SUI-8763).
* Fixed a cache-invalidation issue with `customizeTheme` that prevented multiple customizers from being applied (SUI-8769).

Deprecations:
* `static1`-`static20`, `categorical1D/1L/2D/2L`, `highLow1D`-`4L`, `divergent1D`-`4L`, and `sequential1D`-`6L` are deprecated (SUI-8574).

Notes:
* `tinycolor2` has been replaced with `colorjs.io` as the internal color manipulation library.

1.6.0 - March 5, 2026
----------
New Features:
* `pageBase` mixin now sets `lineHeight` (SUI-8635).

Bug Fixes:
* `contentColorLink` in Enterprise light theme updated to improve visual contrast between `neutral100` and `neutral200` (SUI-8552).

Docs:
* Updated recommended tokens replacements for deprecated `accentColor*` tokens (SUI-8586).

1.5.0 - February 10, 2026
----------
New Features:
* New `lineLengthMinimum` token (SUI-8622).

Deprecations:
* `draggableBackground` has been deprecated (SUI-8623).

1.4.1 - December 3, 2025
----------
Bug Fixes:
* `backgroundColorSection` in Enterprise dark theme updated to improve visual contrast between `neutralColor` and to reduce its overall brightness (SUI-7879).

1.4.0  - November 4, 2025
----------
New Features:
* New `contentColorLinkDisabled`, `contentColorLinkVisited`, and `contentColorLinkVisitedDisabled` tokens (SUI-8244).

1.3.0 - October 7, 2025
----------
New Features:
* New `actionColorContent*` tokens (SUI-8101).
* `@splunk/themes/storybook-addon-splunk-themes` now supports enabling the Splunk Magnetic theme family as an option by using the `enableSplunkMagneticOption` storybook param (SUI-8283).

Bug Fixes:
* Fix incorrect action content colors in Magnetic theme customizer (SUI-8101).

Deprecations:
* `contentColorInfo`, `contentColorNegativeStrong`, `contentColorPositive` and `contentColorWarning` have been deprecated (SUI-8251)
* `@splunk/themes/storybook-addon-splunk-themes`'s `disableDualTheme` storybook param is deprecated, use `disableMultiThemeOptions` instead (SUI-8283).
* `@splunk/themes/storybook-addon-splunk-themes`'s theme configuration options `both` value deprecated, use `all` instead (SUI-8283).

1.2.1 - September 2, 2025
----------
Bug Fixes:
* Added missing `sansFontFamily` token in Magnetic theme customizer (SUI-8101).

Docs:
* Added missing data visualization color categories (`categorical2D`, `categorical2L`, `divergent1D`) to design tokens documentation (SUI-8139).

1.2.0 - August 5, 2025
----------
New Features:
* New `lineHeight*` variables (SUI-7993).

Bug Fixes:
* Updated `skipLink` mixin to override `min-width` and `min-height` properties.

1.1.0 - July 2, 2025
----------
New Features:
* `@splunk/themes/storybook-addon-splunk-themes` now supports disabling 'both' option via `disableDualTheme` story param (SUI-7702).
* Added `pageBase` mixin for `html` and `body` base styling (SUI-7665).
* New `skipLink` mixin (SUI-7854)

Bug Fixes:
* Updated Prisma and Magnetic light syntax token values to maintain 4.5:1 contrast with line highlight (SUI-6644).
  * Tokens updated: `syntaxBlue`, `syntaxBrown`, `syntaxGray`, `syntaxGreen`, `syntaxHighlight`, `syntaxOrange`, `syntaxPink`, `syntaxPurple`, `syntaxRed`, and `syntaxTeal`.
* Updated `actionColorBackgroundSecondaryActive` token values in Enterprise and Prisma themes to fix visual regression in `Radio Bar` (SUI-7864).
* Updated `interactiveColorOverlayActive` token values in Prisma and Enterprise themes to match `actionColorBackgroundSecondaryActive` values for consistent active overlay states (SUI-7864).
* Updated enterprise theme light mode neutral color tokens `neutral300`, `neutral400`, and `neutral500` to fix lightness steps from previous changes. (SUI-7879)
* Added neutral tokens (`neutral50`, `neutral100`, `neutral200`, `neutral300`, `neutral400`, `neutral500`) to Magnetic theme customizer with light and dark color scheme support, matching Enterprise and Prisma theme. (SUI-7879)

1.0.1 - June 5, 2025
----------
Bug Fixes:
* Corrected `@types/react` peer dependency to allow `@types/react` `16` or `17` (SUI-7838).

1.0.0 - June 3, 2025
----------
* Includes all changes from `1.0.0-beta` and `1.0.0-rc` releases.

Bug Fixes:
* Color variables `backgroundColorPage`, `backgroundColorNavigation`,`backgroundColorSideBar`,`neutral50`,`neutral100` and `neutral200` in Enterprise light have been updated to align better with Prisma themes (SUI-7584).
* `@types/react` peer dependency now includes `^16 | ^17` and no longer blocks installation using `npm` in React 16 or 17 environments (SUI-7838).
* Color variables for `actionColorBorderSecondary*`, `actionColorBackgroundSecondary*`, and `interactiveColorBorderDisabled` have been updated to align with both Prisma and Enterprise themes (SUI-7839).

1.0.0-rc.2 - May 28, 2025
----------
* Release candidate 2.

1.0.0-rc.1 - May 14, 2025
----------
API Changes:
* `SplunkThemeProvider`'s default `density` has been changed from `"comfortable"` to `"compact"` (SUI-5709).

1.0.0-beta.5 - May 7, 2025
----------
New Features:
* New `interactiveColorAccentErrorWeak` variable (SUI-7757).
* `typography` has reintroduced the `withReset` prop, which defaults to `false`. When set to `true`, it removes all browser-default styles and applies theme-specific defaults (SUI-7638).

1.0.0-beta.4 - April 22, 2025
----------
New Features:
* New `inputBorderWidth` variable (SUI-7384).

API Changes:
* `typescript` version is now `^5.8.3` (SUI-7601).
* `borderActiveColor` has been deprecated. (SUI-7633).
    * Use `interactiveColorBorderActive` for Data Entry components or `actionColorBorderSecondaryActive` for Buttons.
* `backgroundColorHover` have been deprecated. (SUI-7633).
    * Use `interactiveColorOverlayHover` for Data Entry components or `actionColorBackgroundSecondaryHover` for Buttons.
* `hoverShadow` has been deprecated. See notes on `backgroundColorHover` for hover affordances. (SUI-7621)

Bug Fixes:
* Fixes broken CSS for Splunk Magnetic's `backgroundColorNavigation` override (SUI-7653).

Deprecations:
* `statusColor*`s have been deprecated. Instead use the appropriate `notificationColor*` or `severityColor*`(SUI-7303).

1.0.0-beta.3 - April 2, 2025
----------
New Features:
* New `neutral50` variable (SUI-7384).
* New `notificationColor` variables (SUI-7303).
* New `severityColor` variables (SUI-7303).

Bug Fixes:
* Updates `interactiveColorBackground` and `interactiveColorBackgroundDisabled` to be transparent in all themes (SUI-7347).
* The `@types/react` peer dependency is now correctly set to `^18.2.0` (SUI-7548).

Deprecations:
* `interactiveColorPrimary` has been deprecated (SUI-3568).

1.0.0-beta.2 - March 5, 2025
----------
New Features:
* New `contentColorLink` variable (SUI-3568).
* The data-viz variables are supported in all themes (SUI-3568).

API Changes:
* `accentColor` variable has been removed from Prisma themes (SUI-3568).
* `borderColor`, `borderColorStrong`, and `borderColorWeak` have had alpha removed from their values (SUI-7340).
* `embossShadow`, `overlayShadow`, `dragShadow`, and `modalShadow` variables have been updated in Enterprise themes to match Prisma (SUI-7334).
* Enterprise only tokens have been deprecated: `brandColor*`, `gray*`,  `accentColor*`, `errorColor*`, `alertColor*`, `warningColor*`, `successColor*`, `infoColor*`, `diverging*Color*`, and `cat*Color*`.

Deprecations:
* `linkColor` and `linkColorHover` have been deprecated. Instead use `contentColorLink` (SUI-3568).

1.0.0-beta.1 - February 20, 2025
----------
New Features:
* Enterprise themes now support the `interactiveColorOverlayHover` Prisma alias (SUI-6289).
* All themes now support color variable `interactiveColorAccent` (SUI-6304).
* All themes now support color variable `interactiveColorAccentError` (SUI-6395).
* Enterprise themes now support the `interactiveColorOverlaySelected` Prisma alias.
* All themes now support color variable `contentBackgroundColorNegativeWeak` (SUI-6395).
* Enterprise themes now support color variable `contentColorInverted` (SUI-6530).
* All themes now support color variable `contentColorNegative` (SUI-6408).
* Prisma themes now support color variable `accentColor` (SUI-6657).
* All themes now support new `actionColor` tokens (SUI-6616).
* All themes now support color variable `contentColorAccent` (SUI-6711).
* All themes now support color variables `contentColorInfo`, `contentColorPositive`, and `contentColorWarning` (SUI-6830).
* Enterprise themes now support the `interactiveColorOverlayActive` (SUI-6870).
* All themes now support color variable `interactiveColorAccentErrorStrong` (SUI-6869).
* All themes now support color variable `interactiveColorBackground` (SUI-6983).
* New `layout` mixin (SUI-6678).
* Enterprise themes now support color variable `backgroundColorSidebar` (SUI-7102).

API Changes:
* `react` and `react-dom` peer dependencies are now `"^16.8.0 || ^17.0.0 || ^18.0.0"`.
* `px` sizing for `variables.fontSize*` and `mixins.typography` have been replaced with `rem` sizing (SUI-5509).
    * This results in minor differences in text sizing; but is required to meet WCAG 1.4.4 and WCAG 1.4.10.
* `typography` `size` param no longer supports `56` `36` `32` and `10`.
* `variables.lineHeight` is no longer defined in `px` to improve readability of font at all scales (SUI-5509).
* `typography`'s mixin for `Title5`'s has been updated to text color `variables.contentColorActive` in Prisma theme (SUI-5685).
    * This change affects `Heading` and `Typography` components.
* The font size and line height no longer change with density. The default font-size in Enterprise Compact now is 14px (SUI-5508).
* `typography`'s `line-height`, `size`, and `font-weight` values have been consolidated between Enterprise and Prisma themes (SUI-5684).
* `typography`'s `withReset` prop has been removed (SUI-5686).
* `variables.activeBorder` has been removed (SUI-6362).
* Spacing variables in Enterprise themes are now aligned with Prisma themes (SUI-6530).
  * `spacingXSmall`, `spacingSmall`, `spacingMedium`, `spacingLarge`, `spacingXLarge`, `spacingXXLarge`, `spacingXXXLarge` have been updated to match Prisma themes.
  * `spacingQuarter`, `spacingHalf`, and `spacing` are deprecated and should not be used.
* Enterprise theme `statusColor*` variables have been shifted to align brightness values with Prisma themes (SUI-6348).
* Enterprise theme's `focusShadow` variable has been updated to match Prisma (SUI-6481).
* Enterprise theme's `focusShadowInset` variable has been updated to match Prisma (SUI-6487).
* `typography` supports a new scale for line-height that uses unitless values (SUI-6593).
* `typography` no longer support pixel values for line-height (SUI-6593).
* `typography` no longer supports the `title7` and `footnote` variants (SUI-6593).
* `typography` parameters now supports `family: "title"`.
* `fontSizeXLarge` size has been changed (SUI-6593).
* Enterprise themes support the `contentColorActive`, `contentColorDefault`, `contentColorDisabled`, `contentColorInverted`, and `contentColorMuted` tokens (SUI-6160).

Deprecations:
* Enterprise theme tokens `textColor`, `textGray`, and `textDisabledColor` have been deprecated (SUI-6160).
* Enterprise theme token `backgroundColor` has been deprecated (SUI-6656).
* `accentColorPositive`, `accentColorWarning`, `accentColorAlert`, and `accentColorNegative` have been deprecated (SUI-3658).

0.24.0 - May 6, 2025
----------
Bug Fixes:
* Added `main` and `types` properties to package.json (SUI-7464).

0.23.0 - February 5, 2025
----------
Bug Fixes:
* Added peer dependencies needed to incorporate the themes package standalone (SUI-6874).

0.22.0 - October 1, 2024
----------
New Features:
* New Status Color tokens for weak and strong variants (SUI-6348).
* `@splunk/themes/storybook-addon-splunk-themes` now supports showing both versions of a single theme setting side by side (SUI-6281).

0.21.0 - August 26, 2024
----------
New Features:
* Prisma `focusColor` transparency removed to increase contrast and meet accessibility requirements (SUI-6519).

0.20.0 - August 7, 2024
----------
New Features:
* Prisma light theme's `interactiveColorBorder` value has been updated to meet accessibility requirements (SUI-6342).

0.19.0 - June 4, 2024
----------
New Features:
* Enterprise themes now support the following Prisma aliases: `interactiveColorBorderActive`, `interactiveColorBorderHover`, `interactiveColorBorderDisabled`, and `interactiveColorBackgroundDisabled` (SUI-6062).

API Changes:
* Enterprise theme's `interactiveColorBorder` Prisma alias has been updated in dark mode (SUI-6062).

0.18.0 - May 6, 2024
----------
New Features:

* All themes now support color variables for decorative borders:
    * `borderColorStrong` and `borderColorWeak` added to all themes
    * `borderColor` now also available in Prisma themes
    * Note: Use `interactiveColorBorder` when creating a border for an interactive control

Bug Fixes:
* Enterprise light theme `interactiveColorBorder` value has been updated to meet contrast requirements.

API Changes:
* Enterprise theme `borderLightColor` has been deprecated. Instead, use `borderColorWeak`.
* Enterprise dark theme `borderDarkColor` has been removed. Instead, use `borderColorStrong`.
* `@splunk/themes/storybook-addon-splunk-themes` has been updated to work with `@storybook@^7` and no longer works with `@storybook@^6` (SUI-6170).

0.17.0 - March 21, 2024
----------
New Features:
* Added new variable `activeBorder`.

0.16.4 - December 5, 2023
----------
Bug Fixes:
* `syntaxColors` have been updated to meet A11y_WCAG 1.4.3 contrast requirements for prisma and enterprise themes (SUI-5750).

0.16.3 - October 11, 2023
----------
Bug Fixes:
* This package should now load correctly in Webpack 4 environments (SUI-5802).

0.16.2 - October 4, 2023
----------
Bug Fixes:
* `typography` mixin's `title4`, `title5`, and `title6` should now correctly follow the font hierarchy (SUI-5668).
  * `title5` is now larger and bolder than `title6` in Prisma themes.
  * `title4` it now larger than `title6` in the Enterprise compact theme.
* `typography`'s mixin's `title5` color has been changed to `active` in prisma theme to match the Splunk Design System.

API Changes:
* `list-style` has been removed for `mixins.reset` (SUI-5622).

0.16.1 - June 6, 2023
----------
API Changes:
* Added support for the latest `styled-components@5` (SUI-5467).

0.16.0 - April 6, 2023
----------
Breaking Changes:
* `typography` mixin's `weight` param now only accepts keyword values. Number values have been removed (SUI-5344).

New Features:
* Added variables for supported font weights; the `typography` mixin's `weight` param supports these as keyword values (SUI-5344).

Bug Fixes:
* `typography` mixin properly applies correct CSS for `weight` params (SUI-5344).


0.15.0 - January 25, 2023
----------
New Features:
* Added theme specific code in `typography` mixin for title variations (SUI-5272).

Bug Fixes:
* `mixins` now applies `color-scheme` (SUI-1926).
    * This causes form controls, scrollbars, and other elements to respect the color scheme specified by `ThemeProvider`.
* Fixes documentation typo in `typography` mixin where 'subtitle' and 'smallSubtitle' should be instead be named 'title6' and 'title7' respectively.

0.14.0 - January 10, 2023
----------
New Features:
* Added `inherit` option for `color` prop in `typography` mixin.

0.13.1 - December 6, 2022
----------
* Optimizes bundle sizes of consumers by reducing footprint of "lodash" (SUI-5090).

0.13.0 - September 6, 2022
----------
New Features:
* Added `typography` mixin (SUI-2809).

0.12.0 - August 2, 2022
----------
New Features:
* Added `zIndexLayer` variable (SUI-2809).

API Changes:
* Status and accent colors have been updated in Prisma themes.

    The amount of distinct color values have been consolidated: e.g. `statusColorHigh` and `accentColorNegative` are both `#e00000`.

    The contrast between these colors have been increased to improve accessibility (SUI-3758).

0.11.0 - May 4, 2022
----------
New Features:
* Added Data visualization colors to Prisma themes.

0.10.1 - April 5, 2022
----------
Bug Fixes:
* Pinned `styled-components@5.1.1` to avoid breaking changes introduced in `styled-components@5.2.0`.

  **`@splunk/themes` is incompatible with styled-components version(s) `^5.2.0`**.

  `styled-components@5.2.0` changed how selectors like `& + &` are compiled; [styled-components PR#3236](https://github.com/styled-components/styled-components/pull/3236).
  This breaks styles that worked in previous versions of styled-components; [styled-components issue #3265](https://github.com/styled-components/styled-components/issues/3265).

  **Until noted otherwise in a future release of `@splunk/themes` do not use `styled-components@^5.2.0` with` @splunk/themes`**.

0.10.0 - February 23, 2022
----------
New Features:
* Utility variables, `isPrisma`, `isEnterprise`, `isComfortable`, `isCompact`, `isDark`, and `isLight`, added to `useSplunkTheme()` and `withSplunkTheme()` (SUI-2376).

0.9.0 - September 8, 2021
----------
API Changes:
* Prisma content colors no longer use transparency (SUI-2688).

0.8.0 - March 31, 2021
----------
New Features:
* New variable `backgroundColorDialog`.
* New Storybook Add-on, `@splunk/themes/storybook-addon-splunk-themes`.

API Changes:
* `backgroundColorModal` has been removed. Instead, use the new variable `backgroundColorDialog`.

Bug Fixes:
* Enterprise `draggable` and `draggableDark` assets updated to improve contrast (SUI-2494).

0.7.0 - February 4, 2021
----------

0.7.0 is a major departure from previous versions of this library. It has been optimized to work with React and styled-components,
but variables can still be used for other use cases.

New Features:
* `overlayColors` mixin supports nested template functions.
* `compact` variables.

API Changes:
* `scp` theme renamed to `prisma`.
* `prisma` `dark` is the default theme.
* `lite` theme removed. That is, the orange theme for the Splunk Light product was removed.
* New `SplunkThemeProvider`.
* New `pick()` function for switching css blocks and variables in styled-components templates.
* Individual themes are no longer exported directly.
    * Use `useSplunkTheme()` for variables in React components;
    * Use `variables` for variables in styled-components templates;
    * Use `getTheme()` should you need a full list of theme variables for use outside of React and styled-components;
* Consuming packages no longer need to export their themes.
* Deprecated variables have been removed from `prisma`.
* `mixins` are no longer theme-specific – they are theme-aware. That is, one set of mixins work in all themes.
* `mixins` cannot be used outside of `styled-components`.
* `reset` mixin no longer supports the `full` and `all` parameters.
* Enterprise theme `backgroundColor` variable changed to improve contrast ratios for primary `Button`s (SUI-2441).

0.6.1 - August 31, 2020
----------
Bug Fixes:
* `syntaxOrange` and `syntaxBrown` colors corrected in the `scp` theme (SUI-2341).

0.6.0 - July 7, 2020
----------
New Features:
* New `scpLight` theme (SUI-2099).
* New usage-based variables in `scp` theme.
* Added `overlayColors` mixin.

API Changes:
* Changes to variables in the `scp` theme:
  * `gray##` variable removed. Replace with usage-based grays. In limited cases, such as borders, `neutralColor###` may be used.
  * `successColor` variable removed. Replace with `accentColorPositive`.
  * `successColorX##` variable removed. Blend `accentColorPositive` with `interactiveColorOverlayXXX` or use a transparency.
  * `blue#` variable removed. Replace with `interactiveColorPrimary` and possibly blend with `interactiveColorOverlayXXX`.
  * `green1` variable removed. Replace with `accentColorPositive` or `statusColorNormal`.
  * `yellow1` variable removed. Replace with `accentColorWarning` or `statusColorLow`.
  * `orange1` variable removed. Replace with `accentColorAlert` or `statusColorMedium`.
  * `red1` variable removed. Replace with `accentColorNegative` or `statusColorCritical`.
  * `accentColor` variable removed. Replace with `interactiveColorPrimary` or `statusColorInfo`.
  * `accentColorX##` variable removed. Replace with `interactiveColorPrimary` or `statusColorInfo`.
  * `infoColor` variable removed. Replace with `statusColorInfo` or `contentColorActive`.
  * `infoColorX##` variable removed. Blend `accentColorWarning` with `interactiveColorOverlayXXX` or use a transparency.
  * `warningColor` variable removed. Replace with `accentColorWarning`.
  * `warningColorX##` variable removed. Blend `accentColorWarning` with `interactiveColorOverlayXXX` or use a transparency.
  * `alertColor` variable removed. Replace with `accentColorAlert`.
  * `alertColorX##` variable removed. Blend `accentColorPositive` with `interactiveColorOverlayXXX` or use a transparency.
  * `errorColor` variable removed. Replace with `accentColorNegative`.
  * `errorColorX##` variable removed. Blend `accentColorPositive` with `interactiveColorOverlayXXX` or use a transparency.
  * `linkColorHover` variable removed. Remove css or use `linkColor`.
  * `syntaxBlueLight` variable removed. Replace with `syntaxBlue`.
  * `syntaxGreenLight` variable removed. Replace with `syntaxGreen`.
  * `syntaxPurpleLight` variable removed. Replace with `syntaxPurple`.
  * `syntaxRedLight` variable removed. Replace with `syntaxRed`.

Bug Fixes:
* Focus styles are updated in `enterprise` and Splunk Light `lite` themes to improve accessibility (SPL-188569).

0.5.0 - May 1, 2020
----------
API Changes:
* The `reset` mixin now enables `cursor` inheritance.

0.4.2 - February 5, 2020
----------
New Features:
* Added `screenReaderContent` mixin.

0.4.1 - October 14, 2019
----------
Notes:
* Relicensed to `Apache-2.0`.

0.4.0 - October 8, 2019
----------
New Features:
* Added `scp` theme.

0.3.1 - September 12, 2019
----------
New Features:
* The `reset` mixin now supports an additional argument, `all`.

Bug Fixes:
* Fixed a visual issue with links that use the `reset` mixin, on Chrome 77 (SUI-1905).

0.3.0 - September 13, 2018
----------
New Features:
* Added `enterpriseDark` theme.

API Changes:
* Theme modules export only one default object now. Mixins are now nested in `mixins`.

Notes:
* Relicensed to `Splunk Software License Agreement`.

0.2.0 - June 30, 2018
----------
* Initial Release.
