@atlaskit/tokens 13.1.0 → 13.1.1

package/dist/esm/theme-config.js

@@ -1,10 +1,10 @@
 import _toConsumableArray from "@babel/runtime/helpers/toConsumableArray";
-import { fg } from '@atlaskit/platform-feature-flags';
-import { themeIds } from './theme-ids';
 /**
  * This file contains the source of truth for themes and all associated meta data.
  */
 
+import { themeIds } from './theme-ids';
+
 /**
  * Themes: The internal identifier of a theme.
  * These ids are what the actual theme files/folders are called.
@@ -147,48 +147,6 @@ var themeConfig = {
   }
 };
 
-/**
- * ThemeOptionsSchema: additional configuration options used to customize Atlassian's themes
- */
-
-/**
- * ThemeState: the standard representation of an app's current theme and preferences
- */
-
-/**
- * Can't evaluate typography feature flags at the module level,
- * it will always resolve to false when server side rendered or when flags are loaded async.
- */
-
-function getShapeDefault() {
-  if (fg('platform-dst-shape-theme-default')) {
-    return 'shape';
-  }
-  return undefined;
-}
-function getMotionDefault() {
-  if (fg('platform-dst-motion-theme-default')) {
-    return 'motion';
-  }
-  return undefined;
-}
-
-/**
- * themeStateDefaults: the default values for ThemeState used by theming utilities
- */
-// eslint-disable-next-line @atlaskit/volt-strict-mode/no-multiple-exports
-export var themeStateDefaults = {
-  colorMode: 'auto',
-  contrastMode: 'auto',
-  dark: 'dark',
-  light: 'light',
-  shape: getShapeDefault,
-  spacing: 'spacing',
-  typography: 'typography',
-  motion: getMotionDefault,
-  UNSAFE_themeOptions: undefined
-};
-
 /**
  * Represents theme state once mounted to the page
  * (the page doesn't have an "auto" color mode, it's either light or dark)
@@ -197,4 +155,5 @@ export var themeStateDefaults = {
 // eslint-disable-next-line @atlaskit/volt-strict-mode/no-multiple-exports
 export default themeConfig;
 export { themeColorModes } from './theme-color-modes';
-export { themeIds } from './theme-ids';
+export { themeIds } from './theme-ids';
+export { themeStateDefaults } from './theme-state-defaults';

package/dist/esm/theme-object-to-string.js

@@ -0,0 +1,35 @@
+import _typeof from "@babel/runtime/helpers/typeof";
+import _slicedToArray from "@babel/runtime/helpers/slicedToArray";
+import { isColorMode } from './is-color-mode';
+import { isThemeIds } from './is-theme-ids';
+import { isThemeKind } from './is-theme-kind';
+var customThemeOptions = 'UNSAFE_themeOptions';
+
+/**
+ * Converts a theme object to a string formatted for the `data-theme` HTML attribute.
+ *
+ * @param {object} themes The themes that should be applied.
+ *
+ * @example
+ * ```
+ * themeObjectToString({ dark: 'dark', light: 'light', spacing: 'spacing' });
+ * // returns 'dark:dark light:light spacing:spacing'
+ * ```
+ */
+export var themeObjectToString = function themeObjectToString(themeState) {
+  return Object.entries(themeState).reduce(function (themeString, _ref) {
+    var _ref2 = _slicedToArray(_ref, 2),
+      kind = _ref2[0],
+      id = _ref2[1];
+    if (
+    // colorMode theme state
+    kind === 'colorMode' && typeof id === 'string' && isColorMode(id) ||
+    // custom theme state
+    kind === customThemeOptions && _typeof(id) === 'object' ||
+    // other theme states
+    isThemeKind(kind) && typeof id === 'string' && isThemeIds(id)) {
+      return themeString + "".concat(themeString ? ' ' : '') + "".concat(kind, ":").concat(_typeof(id) === 'object' ? JSON.stringify(id) : id);
+    }
+    return themeString;
+  }, '');
+};

package/dist/esm/theme-state-defaults.js

@@ -0,0 +1,34 @@
+import { fg } from '@atlaskit/platform-feature-flags';
+
+/**
+ * Can't evaluate typography feature flags at the module level,
+ * it will always resolve to false when server side rendered or when flags are loaded async.
+ */
+
+function getShapeDefault() {
+  if (fg('platform-dst-shape-theme-default')) {
+    return 'shape';
+  }
+  return undefined;
+}
+function getMotionDefault() {
+  if (fg('platform-dst-motion-theme-default')) {
+    return 'motion';
+  }
+  return undefined;
+}
+
+/**
+ * themeStateDefaults: the default values for ThemeState used by theming utilities
+ */
+export var themeStateDefaults = {
+  colorMode: 'auto',
+  contrastMode: 'auto',
+  dark: 'dark',
+  light: 'light',
+  shape: getShapeDefault,
+  spacing: 'spacing',
+  typography: 'typography',
+  motion: getMotionDefault,
+  UNSAFE_themeOptions: undefined
+};

package/dist/esm/theme-state.js

@@ -0,0 +1 @@
+export {};

package/dist/esm/theme-string-to-object.js

@@ -0,0 +1,44 @@
+import _slicedToArray from "@babel/runtime/helpers/slicedToArray";
+import { isColorMode } from './is-color-mode';
+import { isThemeIds } from './is-theme-ids';
+import { isThemeKind } from './is-theme-kind';
+var customThemeOptions = 'UNSAFE_themeOptions';
+
+/**
+ * Converts a string that is formatted for the `data-theme` HTML attribute
+ * to an object that can be passed to `setGlobalTheme`.
+ *
+ * @param {string} themes The themes that should be applied.
+ *
+ * @example
+ * ```
+ * themeStringToObject('dark:dark light:light spacing:spacing');
+ * // returns { dark: 'dark', light: 'light', spacing: 'spacing' }
+ * ```
+ */
+export var themeStringToObject = function themeStringToObject(themeState) {
+  return themeState.split(' ')
+  // @ts-ignore - TS1501 TypeScript 5.9.2 upgrade
+  .map(function (theme) {
+    return theme.split(/:([^]*)/);
+  }).reduce(function (themeObject, _ref) {
+    var _ref2 = _slicedToArray(_ref, 2),
+      kind = _ref2[0],
+      id = _ref2[1];
+    if (kind === 'colorMode' && isColorMode(id)) {
+      themeObject[kind] = id;
+    }
+    if (isThemeKind(kind) && isThemeIds(id)) {
+      // @ts-expect-error FIXME - this is a valid ts error
+      themeObject[kind] = id;
+    }
+    if (kind === customThemeOptions) {
+      try {
+        themeObject[customThemeOptions] = JSON.parse(id);
+      } catch (_unused) {
+        new Error('Invalid custom theme string');
+      }
+    }
+    return themeObject;
+  }, {});
+};

package/dist/esm/utils/additional-contrast-checker.js

@@ -0,0 +1,36 @@
+import tokenValuesDark from '../artifacts/atlassian-dark-token-value-for-contrast-check';
+import tokenValuesLight from '../artifacts/atlassian-light-token-value-for-contrast-check';
+import { additionalChecks } from './custom-theme-token-contrast-check';
+import { getContrastRatio } from './get-contrast-ratio';
+var getColorFromTokenRaw = function getColorFromTokenRaw(tokenName, mode) {
+  return mode === 'light' ? tokenValuesLight[tokenName] : tokenValuesDark[tokenName];
+};
+export var additionalContrastChecker = function additionalContrastChecker(_ref) {
+  var customThemeTokenMap = _ref.customThemeTokenMap,
+    mode = _ref.mode,
+    themeRamp = _ref.themeRamp;
+  var updatedCustomThemeTokenMap = {};
+  var brandTokens = Object.keys(customThemeTokenMap);
+  additionalChecks.forEach(function (pairing) {
+    var backgroundLight = pairing.backgroundLight,
+      backgroundDark = pairing.backgroundDark,
+      foreground = pairing.foreground,
+      desiredContrast = pairing.desiredContrast,
+      updatedTokens = pairing.updatedTokens;
+    var background = mode === 'light' ? backgroundLight : backgroundDark;
+    var foregroundTokenValue = customThemeTokenMap[foreground];
+    var backgroundTokenValue = customThemeTokenMap[background];
+    var foregroundColor = brandTokens.includes(foreground) ? typeof foregroundTokenValue === 'string' ? foregroundTokenValue : themeRamp[foregroundTokenValue] : getColorFromTokenRaw(foreground, mode);
+    var backgroundColor = brandTokens.includes(background) ? typeof backgroundTokenValue === 'string' ? backgroundTokenValue : themeRamp[backgroundTokenValue] : getColorFromTokenRaw(background, mode);
+    var contrast = getContrastRatio(foregroundColor, backgroundColor);
+    if (contrast <= desiredContrast) {
+      updatedTokens.forEach(function (token) {
+        var rampValue = customThemeTokenMap[token];
+        if (typeof rampValue === 'number') {
+          updatedCustomThemeTokenMap[token] = mode === 'light' ? rampValue + 1 : rampValue - 1;
+        }
+      });
+    }
+  });
+  return updatedCustomThemeTokenMap;
+};

package/dist/esm/utils/custom-theme-loading-utils.js

@@ -1,5 +1,3 @@
-import _slicedToArray from "@babel/runtime/helpers/slicedToArray";
-import tokens from '../artifacts/token-names';
 import { CUSTOM_THEME_ATTRIBUTE, THEME_DATA_ATTRIBUTE } from '../constants';
 import { hash } from './hash';
 export function findMissingCustomStyleElements(UNSAFE_themeOptions, mode) {
@@ -16,16 +14,4 @@ export function findMissingCustomStyleElements(UNSAFE_themeOptions, mode) {
     }
   });
   return attrOfMissingCustomStyles;
-}
-
-// eslint-disable-next-line @atlaskit/volt-strict-mode/no-multiple-exports
-export function reduceTokenMap(tokenMap, themeRamp) {
-  return Object.entries(tokenMap).reduce(function (acc, _ref) {
-    var _ref2 = _slicedToArray(_ref, 2),
-      key = _ref2[0],
-      value = _ref2[1];
-    var cssVar = tokens[key];
-    return cssVar ? "".concat(acc, "\n  ").concat(cssVar, ": ").concat(typeof value === 'string' ? value : themeRamp[value], ";") : acc;
-  }, '');
-}
-export { limitSizeOfCustomStyleElements } from './limit-size-of-custom-style-elements';
+}

package/dist/esm/utils/custom-theme-token-contrast-check.js

@@ -1,6 +1,3 @@
-import tokenValuesDark from '../artifacts/atlassian-dark-token-value-for-contrast-check';
-import tokenValuesLight from '../artifacts/atlassian-light-token-value-for-contrast-check';
-import { getContrastRatio } from './color-utils';
 export var additionalChecks = [{
   foreground: 'color.text.brand',
   backgroundLight: 'elevation.surface.sunken',
@@ -42,38 +39,4 @@ export var additionalChecks = [{
   // In light mode: darken the following tokens by one base token
   // In dark mode: lighten the following tokens by one base token
   updatedTokens: ['color.chart.brand', 'color.chart.brand.hovered']
-}];
-var getColorFromTokenRaw = function getColorFromTokenRaw(tokenName, mode) {
-  return mode === 'light' ? tokenValuesLight[tokenName] : tokenValuesDark[tokenName];
-};
-
-// eslint-disable-next-line @atlaskit/volt-strict-mode/no-multiple-exports
-export var additionalContrastChecker = function additionalContrastChecker(_ref) {
-  var customThemeTokenMap = _ref.customThemeTokenMap,
-    mode = _ref.mode,
-    themeRamp = _ref.themeRamp;
-  var updatedCustomThemeTokenMap = {};
-  var brandTokens = Object.keys(customThemeTokenMap);
-  additionalChecks.forEach(function (pairing) {
-    var backgroundLight = pairing.backgroundLight,
-      backgroundDark = pairing.backgroundDark,
-      foreground = pairing.foreground,
-      desiredContrast = pairing.desiredContrast,
-      updatedTokens = pairing.updatedTokens;
-    var background = mode === 'light' ? backgroundLight : backgroundDark;
-    var foregroundTokenValue = customThemeTokenMap[foreground];
-    var backgroundTokenValue = customThemeTokenMap[background];
-    var foregroundColor = brandTokens.includes(foreground) ? typeof foregroundTokenValue === 'string' ? foregroundTokenValue : themeRamp[foregroundTokenValue] : getColorFromTokenRaw(foreground, mode);
-    var backgroundColor = brandTokens.includes(background) ? typeof backgroundTokenValue === 'string' ? backgroundTokenValue : themeRamp[backgroundTokenValue] : getColorFromTokenRaw(background, mode);
-    var contrast = getContrastRatio(foregroundColor, backgroundColor);
-    if (contrast <= desiredContrast) {
-      updatedTokens.forEach(function (token) {
-        var rampValue = customThemeTokenMap[token];
-        if (typeof rampValue === 'number') {
-          updatedCustomThemeTokenMap[token] = mode === 'light' ? rampValue + 1 : rampValue - 1;
-        }
-      });
-    }
-  });
-  return updatedCustomThemeTokenMap;
-};
+}];

package/dist/esm/utils/delta-e.js

@@ -0,0 +1,20 @@
+import { rgbToLab } from './rgb-to-lab';
+export function deltaE(rgbA, rgbB) {
+  var labA = rgbToLab(rgbA);
+  var labB = rgbToLab(rgbB);
+  var deltaL = labA[0] - labB[0];
+  var deltaA = labA[1] - labB[1];
+  var deltaB = labA[2] - labB[2];
+  var c1 = Math.sqrt(labA[1] * labA[1] + labA[2] * labA[2]);
+  var c2 = Math.sqrt(labB[1] * labB[1] + labB[2] * labB[2]);
+  var deltaC = c1 - c2;
+  var deltaH = deltaA * deltaA + deltaB * deltaB - deltaC * deltaC;
+  deltaH = deltaH < 0 ? 0 : Math.sqrt(deltaH);
+  var sc = 1.0 + 0.045 * c1;
+  var sh = 1.0 + 0.015 * c1;
+  var deltaLKlsl = deltaL / 1.0;
+  var deltaCkcsc = deltaC / sc;
+  var deltaHkhsh = deltaH / sh;
+  var i = deltaLKlsl * deltaLKlsl + deltaCkcsc * deltaCkcsc + deltaHkhsh * deltaHkhsh;
+  return i < 0 ? 0 : Math.sqrt(i);
+}

package/dist/esm/utils/generate-colors.js

@@ -0,0 +1,40 @@
+import _toConsumableArray from "@babel/runtime/helpers/toConsumableArray";
+import { getClosestColorIndex } from './get-closest-color-index';
+import { argbFromRgba, Contrast, Hct, rgbaFromArgb } from './hct-color-utils';
+import { hexToHSL } from './hex-to-hsl';
+import { hexToRgbA } from './hex-to-rgb-a';
+import { HSLToRGB } from './hsl-to-rgb';
+import { relativeLuminanceW3C } from './relative-luminance-w3-c';
+import { rgbToHex } from './rgb-to-hex';
+var lowLuminanceContrastRatios = [1.12, 1.33, 2.03, 2.73, 3.33, 4.27, 5.2, 6.62, 12.46, 14.25];
+var highLuminanceContrastRatios = [1.08, 1.24, 1.55, 1.99, 2.45, 3.34, 4.64, 6.1, 10.19, 12.6];
+export var generateColors = function generateColors(brandColor) {
+  // Determine luminance
+  var HSLBrandColorHue = hexToHSL(brandColor)[0];
+  var baseRgb = HSLToRGB(HSLBrandColorHue, 100, 60);
+  var isLowLuminance = relativeLuminanceW3C(baseRgb[0], baseRgb[1], baseRgb[2]) < 0.4;
+  // Choose right palette
+  var themeRatios = isLowLuminance ? lowLuminanceContrastRatios : highLuminanceContrastRatios;
+  var brandRgba = hexToRgbA(brandColor);
+  var hctColor = Hct.fromInt(argbFromRgba({
+    r: brandRgba[0],
+    g: brandRgba[1],
+    b: brandRgba[2],
+    a: brandRgba[3]
+  }));
+  var themeRamp = themeRatios.map(function (contrast) {
+    var rgbaColor = rgbaFromArgb(Hct.from(hctColor.hue, hctColor.chroma, Contrast.darker(100, contrast) + 0.25 // Material's utils provide an offset
+    ).toInt());
+    return rgbToHex(rgbaColor.r, rgbaColor.g, rgbaColor.b);
+  });
+  var closestColorIndex = getClosestColorIndex(themeRamp, brandColor);
+
+  // Replace closet color with brandColor
+  var updatedThemeRamp = _toConsumableArray(themeRamp);
+  updatedThemeRamp[closestColorIndex] = brandColor;
+  return {
+    ramp: updatedThemeRamp,
+    // add the replaced color into the result
+    replacedColor: themeRamp[closestColorIndex]
+  };
+};

package/dist/esm/utils/generate-token-map-with-contrast-check.js

@@ -0,0 +1,25 @@
+import _defineProperty from "@babel/runtime/helpers/defineProperty";
+import _slicedToArray from "@babel/runtime/helpers/slicedToArray";
+function ownKeys(e, r) { var t = Object.keys(e); if (Object.getOwnPropertySymbols) { var o = Object.getOwnPropertySymbols(e); r && (o = o.filter(function (r) { return Object.getOwnPropertyDescriptor(e, r).enumerable; })), t.push.apply(t, o); } return t; }
+function _objectSpread(e) { for (var r = 1; r < arguments.length; r++) { var t = null != arguments[r] ? arguments[r] : {}; r % 2 ? ownKeys(Object(t), !0).forEach(function (r) { _defineProperty(e, r, t[r]); }) : Object.getOwnPropertyDescriptors ? Object.defineProperties(e, Object.getOwnPropertyDescriptors(t)) : ownKeys(Object(t)).forEach(function (r) { Object.defineProperty(e, r, Object.getOwnPropertyDescriptor(t, r)); }); } return e; }
+import { additionalContrastChecker } from './additional-contrast-checker';
+import { generateColors } from './generate-colors';
+import { generateTokenMap } from './generate-token-map';
+export var generateTokenMapWithContrastCheck = function generateTokenMapWithContrastCheck(brandColor, mode, themeRamp) {
+  var colors = themeRamp || generateColors(brandColor).ramp;
+  var tokenMaps = generateTokenMap(brandColor, mode, colors);
+  var result = {};
+  Object.entries(tokenMaps).forEach(function (_ref) {
+    var _ref2 = _slicedToArray(_ref, 2),
+      mode = _ref2[0],
+      map = _ref2[1];
+    if (mode === 'light' || mode === 'dark') {
+      result[mode] = _objectSpread(_objectSpread({}, map), additionalContrastChecker({
+        customThemeTokenMap: map,
+        mode: mode,
+        themeRamp: colors
+      }));
+    }
+  });
+  return result;
+};

package/dist/esm/utils/{generate-custom-color-ramp.js → generate-token-map.js}

@@ -1,49 +1,8 @@
-import _defineProperty from "@babel/runtime/helpers/defineProperty";
 import _slicedToArray from "@babel/runtime/helpers/slicedToArray";
-import _toConsumableArray from "@babel/runtime/helpers/toConsumableArray";
-function ownKeys(e, r) { var t = Object.keys(e); if (Object.getOwnPropertySymbols) { var o = Object.getOwnPropertySymbols(e); r && (o = o.filter(function (r) { return Object.getOwnPropertyDescriptor(e, r).enumerable; })), t.push.apply(t, o); } return t; }
-function _objectSpread(e) { for (var r = 1; r < arguments.length; r++) { var t = null != arguments[r] ? arguments[r] : {}; r % 2 ? ownKeys(Object(t), !0).forEach(function (r) { _defineProperty(e, r, t[r]); }) : Object.getOwnPropertyDescriptors ? Object.defineProperties(e, Object.getOwnPropertyDescriptors(t)) : ownKeys(Object(t)).forEach(function (r) { Object.defineProperty(e, r, Object.getOwnPropertyDescriptor(t, r)); }); } return e; }
 import rawTokensDark from '../artifacts/atlassian-dark-token-value-for-contrast-check';
-import { getContrastRatio, hexToHSL, hexToRgbA } from './color-utils';
-import { additionalContrastChecker } from './custom-theme-token-contrast-check';
+import { generateColors } from './generate-colors';
 import { getClosestColorIndex } from './get-closest-color-index';
-import { argbFromRgba, Contrast, Hct, rgbaFromArgb } from './hct-color-utils';
-import { HSLToRGB } from './hsl-to-rgb';
-import { relativeLuminanceW3C } from './relative-luminance-w3-c';
-import { rgbToHex } from './rgb-to-hex';
-var lowLuminanceContrastRatios = [1.12, 1.33, 2.03, 2.73, 3.33, 4.27, 5.2, 6.62, 12.46, 14.25];
-var highLuminanceContrastRatios = [1.08, 1.24, 1.55, 1.99, 2.45, 3.34, 4.64, 6.1, 10.19, 12.6];
-export var generateColors = function generateColors(brandColor) {
-  // Determine luminance
-  var HSLBrandColorHue = hexToHSL(brandColor)[0];
-  var baseRgb = HSLToRGB(HSLBrandColorHue, 100, 60);
-  var isLowLuminance = relativeLuminanceW3C(baseRgb[0], baseRgb[1], baseRgb[2]) < 0.4;
-  // Choose right palette
-  var themeRatios = isLowLuminance ? lowLuminanceContrastRatios : highLuminanceContrastRatios;
-  var brandRgba = hexToRgbA(brandColor);
-  var hctColor = Hct.fromInt(argbFromRgba({
-    r: brandRgba[0],
-    g: brandRgba[1],
-    b: brandRgba[2],
-    a: brandRgba[3]
-  }));
-  var themeRamp = themeRatios.map(function (contrast) {
-    var rgbaColor = rgbaFromArgb(Hct.from(hctColor.hue, hctColor.chroma, Contrast.darker(100, contrast) + 0.25 // Material's utils provide an offset
-    ).toInt());
-    return rgbToHex(rgbaColor.r, rgbaColor.g, rgbaColor.b);
-  });
-  var closestColorIndex = getClosestColorIndex(themeRamp, brandColor);
-
-  // Replace closet color with brandColor
-  var updatedThemeRamp = _toConsumableArray(themeRamp);
-  updatedThemeRamp[closestColorIndex] = brandColor;
-  return {
-    ramp: updatedThemeRamp,
-    // add the replaced color into the result
-    replacedColor: themeRamp[closestColorIndex]
-  };
-};
-
+import { getContrastRatio } from './get-contrast-ratio';
 /**
  * Return the interaction tokens for a color, given its ramp position and the number of
  * needed interaction states. Use higher-indexed colors (i.e. darker colors) if possible;
@@ -63,8 +22,6 @@ function getInteractionStates(rampPosition, number, colors) {
   }
   return result;
 }
-
-// eslint-disable-next-line @atlaskit/volt-strict-mode/no-multiple-exports
 export var generateTokenMap = function generateTokenMap(brandColor, mode, themeRamp) {
   var _generateColors = generateColors(brandColor),
     ramp = _generateColors.ramp,
@@ -203,25 +160,4 @@ export var generateTokenMap = function generateTokenMap(brandColor, mode, themeR
     light: customThemeTokenMapLight,
     dark: customThemeTokenMapDark
   };
-};
-
-// eslint-disable-next-line @atlaskit/volt-strict-mode/no-multiple-exports
-export var generateTokenMapWithContrastCheck = function generateTokenMapWithContrastCheck(brandColor, mode, themeRamp) {
-  var colors = themeRamp || generateColors(brandColor).ramp;
-  var tokenMaps = generateTokenMap(brandColor, mode, colors);
-  var result = {};
-  Object.entries(tokenMaps).forEach(function (_ref3) {
-    var _ref4 = _slicedToArray(_ref3, 2),
-      mode = _ref4[0],
-      map = _ref4[1];
-    if (mode === 'light' || mode === 'dark') {
-      result[mode] = _objectSpread(_objectSpread({}, map), additionalContrastChecker({
-        customThemeTokenMap: map,
-        mode: mode,
-        themeRamp: colors
-      }));
-    }
-  });
-  return result;
-};
-export { getClosestColorIndex } from './get-closest-color-index';
+};

package/dist/esm/utils/get-closest-color-index.js

@@ -1,4 +1,5 @@
-import { deltaE, hexToRgb } from './color-utils';
+import { deltaE } from './delta-e';
+import { hexToRgb } from './hex-to-rgb';
 export var getClosestColorIndex = function getClosestColorIndex(themeRamp, brandColor) {
   // Iterate over themeRamp and find whichever color is closest to brandColor
   var closestColorIndex = 0;

package/dist/esm/utils/get-contrast-ratio.js

@@ -0,0 +1,16 @@
+import { hexToRgb } from './hex-to-rgb';
+import { isValidHex } from './is-valid-hex';
+import { relativeLuminanceW3C } from './relative-luminance-w3-c';
+export function getContrastRatio(foreground, background) {
+  if (!isValidHex(foreground) || !isValidHex(background)) {
+    throw new Error('Invalid HEX');
+  }
+  var foregroundRgb = hexToRgb(foreground);
+  var backgroundRgb = hexToRgb(background);
+  var foregroundLuminance = relativeLuminanceW3C(foregroundRgb[0], foregroundRgb[1], foregroundRgb[2]);
+  var backgroundLuminance = relativeLuminanceW3C(backgroundRgb[0], backgroundRgb[1], backgroundRgb[2]);
+  // calculate the color contrast ratio
+  var brightest = Math.max(foregroundLuminance, backgroundLuminance);
+  var darkest = Math.min(foregroundLuminance, backgroundLuminance);
+  return (brightest + 0.05) / (darkest + 0.05);
+}

package/dist/esm/utils/hct-color-utils/alpha-from-argb.js

@@ -0,0 +1,6 @@
+/**
+ * Returns the alpha component of a color in ARGB format.
+ */
+export function alphaFromArgb(argb) {
+  return argb >> 24 & 255;
+}

package/dist/esm/utils/hct-color-utils/argb-from-linrgb.js

@@ -0,0 +1,12 @@
+import { argbFromRgb } from './argb-from-rgb';
+import { delinearized } from './delinearized';
+
+/**
+ * Converts a color from linear RGB components to ARGB format.
+ */
+export function argbFromLinrgb(linrgb) {
+  var r = delinearized(linrgb[0]);
+  var g = delinearized(linrgb[1]);
+  var b = delinearized(linrgb[2]);
+  return argbFromRgb(r, g, b);
+}

package/dist/esm/utils/hct-color-utils/argb-from-lstar.js

@@ -0,0 +1,16 @@
+import { argbFromRgb } from './argb-from-rgb';
+import { delinearized } from './delinearized';
+import { yFromLstar } from './y-from-lstar';
+
+/**
+ * Converts an L* value to an ARGB representation.
+ *
+ * @param lstar L* in L*a*b*
+ * @return ARGB representation of grayscale color with lightness
+ * matching L*
+ */
+export function argbFromLstar(lstar) {
+  var y = yFromLstar(lstar);
+  var component = delinearized(y);
+  return argbFromRgb(component, component, component);
+}

package/dist/esm/utils/hct-color-utils/argb-from-rgba.js

@@ -0,0 +1,18 @@
+import { clampComponent } from './clamp-component';
+/**
+ * Return int32 color from a given RGBA component
+ *
+ * @param rgba RGBA representation of a int32 color.
+ * @returns ARGB representation of a int32 color.
+ */
+export function argbFromRgba(_ref) {
+  var r = _ref.r,
+    g = _ref.g,
+    b = _ref.b,
+    a = _ref.a;
+  var rValue = clampComponent(r);
+  var gValue = clampComponent(g);
+  var bValue = clampComponent(b);
+  var aValue = clampComponent(a);
+  return aValue << 24 | rValue << 16 | gValue << 8 | bValue;
+}

package/dist/esm/utils/hct-color-utils/argb-from-xyz.js

@@ -0,0 +1,24 @@
+import { argbFromRgb } from './argb-from-rgb';
+import { delinearized } from './delinearized';
+
+/**
+ * Color science utilities.
+ *
+ * Utility methods for color science constants and color space
+ * conversions that aren't HCT or CAM16.
+ */
+var XYZ_TO_SRGB = [[3.2413774792388685, -1.5376652402851851, -0.49885366846268053], [-0.9691452513005321, 1.8758853451067872, 0.04156585616912061], [0.05562093689691305, -0.20395524564742123, 1.0571799111220335]];
+
+/**
+ * Converts a color from ARGB to XYZ.
+ */
+export function argbFromXyz(x, y, z) {
+  var matrix = XYZ_TO_SRGB;
+  var linearR = matrix[0][0] * x + matrix[0][1] * y + matrix[0][2] * z;
+  var linearG = matrix[1][0] * x + matrix[1][1] * y + matrix[1][2] * z;
+  var linearB = matrix[2][0] * x + matrix[2][1] * y + matrix[2][2] * z;
+  var r = delinearized(linearR);
+  var g = delinearized(linearG);
+  var b = delinearized(linearB);
+  return argbFromRgb(r, g, b);
+}

package/dist/esm/utils/hct-color-utils/blue-from-argb.js

@@ -0,0 +1,6 @@
+/**
+ * Returns the blue component of a color in ARGB format.
+ */
+export function blueFromArgb(argb) {
+  return argb & 255;
+}

package/dist/esm/utils/hct-color-utils/clamp-component.js

@@ -0,0 +1,9 @@
+export function clampComponent(value) {
+  if (value < 0) {
+    return 0;
+  }
+  if (value > 255) {
+    return 255;
+  }
+  return value;
+}