@atlaskit/tokens 13.0.3 → 13.1.0

package/dist/cjs/utils/color-utils.js

@@ -3,35 +3,50 @@
 Object.defineProperty(exports, "__esModule", {
   value: true
 });
-exports.HSLToRGB = HSLToRGB;
+Object.defineProperty(exports, "HSLToRGB", {
+  enumerable: true,
+  get: function get() {
+    return _hslToRgb.HSLToRGB;
+  }
+});
 exports.deltaE = deltaE;
-exports.getAlpha = getAlpha;
+Object.defineProperty(exports, "getAlpha", {
+  enumerable: true,
+  get: function get() {
+    return _getAlpha.getAlpha;
+  }
+});
 exports.getContrastRatio = getContrastRatio;
 exports.hexToHSL = hexToHSL;
 exports.hexToRgb = hexToRgb;
 exports.hexToRgbA = hexToRgbA;
-exports.isValidBrandHex = void 0;
-exports.relativeLuminanceW3C = relativeLuminanceW3C;
-exports.rgbToHex = rgbToHex;
-// valid hex color with 6 digits
-var isValidBrandHex = exports.isValidBrandHex = function isValidBrandHex(hex) {
-  return /^#[0-9A-F]{6}$/i.test(hex);
-};
-
+Object.defineProperty(exports, "isValidBrandHex", {
+  enumerable: true,
+  get: function get() {
+    return _isValidBrandHex.isValidBrandHex;
+  }
+});
+Object.defineProperty(exports, "relativeLuminanceW3C", {
+  enumerable: true,
+  get: function get() {
+    return _relativeLuminanceW3C.relativeLuminanceW3C;
+  }
+});
+Object.defineProperty(exports, "rgbToHex", {
+  enumerable: true,
+  get: function get() {
+    return _rgbToHex.rgbToHex;
+  }
+});
+var _getAlpha = require("./get-alpha");
+var _relativeLuminanceW3C = require("./relative-luminance-w3-c");
+var _isValidBrandHex = require("./is-valid-brand-hex");
+var _rgbToHex = require("./rgb-to-hex");
+var _hslToRgb = require("./hsl-to-rgb");
 // valid hex color with 4, 6 or 8 digits
 var isValidHex = function isValidHex(hex) {
   return /^#([A-Fa-f0-9]{3,4}){1,2}$/.test(hex);
 };
-function rgbToHex(r, g, b) {
-  return '#' + ((1 << 24) + (r << 16) + (g << 8) + b).toString(16).slice(1);
-}
-function getAlpha(hex) {
-  if (hex.length === 9) {
-    var int = parseInt(hex.slice(7, 9), 16) / 255;
-    return Number(parseFloat(int.toString()).toFixed(2));
-  }
-  return 1;
-}
 function hexToRgbA(hex) {
   if (!isValidHex(hex)) {
     throw new Error('Invalid HEX');
@@ -42,8 +57,10 @@ function hexToRgbA(hex) {
     c = [c[0], c[0], c[1], c[1], c[2], c[2]];
   }
   c = '0x' + c.join('');
-  return [c >> 16 & 255, c >> 8 & 255, c & 255, getAlpha(hex)];
+  return [c >> 16 & 255, c >> 8 & 255, c & 255, (0, _getAlpha.getAlpha)(hex)];
 }
+
+// eslint-disable-next-line @atlaskit/volt-strict-mode/no-multiple-exports
 function hexToRgb(hex) {
   if (!isValidHex(hex)) {
     throw new Error('Invalid HEX');
@@ -56,6 +73,8 @@ function hexToRgb(hex) {
   c = '0x' + c.join('');
   return [c >> 16 & 255, c >> 8 & 255, c & 255];
 }
+
+// eslint-disable-next-line @atlaskit/volt-strict-mode/no-multiple-exports
 function hexToHSL(hex) {
   if (!isValidHex(hex)) {
     throw new Error('Invalid HEX');
@@ -101,43 +120,23 @@ function hexToHSL(hex) {
   l = +(l * 100).toFixed(1);
   return [h, s, l];
 }
-function HSLToRGB(h, s, l) {
-  s /= 100;
-  l /= 100;
-  var k = function k(n) {
-    return (n + h / 30) % 12;
-  };
-  var a = s * Math.min(l, 1 - l);
-  var f = function f(n) {
-    return l - a * Math.max(-1, Math.min(k(n) - 3, Math.min(9 - k(n), 1)));
-  };
-  return [255 * f(0), 255 * f(8), 255 * f(4)];
-}
-function relativeLuminanceW3C(r, g, b) {
-  var RsRGB = r / 255;
-  var GsRGB = g / 255;
-  var BsRGB = b / 255;
-  var R = RsRGB <= 0.03928 ? RsRGB / 12.92 : Math.pow((RsRGB + 0.055) / 1.055, 2.4);
-  var G = GsRGB <= 0.03928 ? GsRGB / 12.92 : Math.pow((GsRGB + 0.055) / 1.055, 2.4);
-  var B = BsRGB <= 0.03928 ? BsRGB / 12.92 : Math.pow((BsRGB + 0.055) / 1.055, 2.4);
 
-  // For the sRGB colorspace, the relative luminance of a color is defined as:
-  var L = 0.2126 * R + 0.7152 * G + 0.0722 * B;
-  return L;
-}
+// eslint-disable-next-line @atlaskit/volt-strict-mode/no-multiple-exports
 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]);
+  var foregroundLuminance = (0, _relativeLuminanceW3C.relativeLuminanceW3C)(foregroundRgb[0], foregroundRgb[1], foregroundRgb[2]);
+  var backgroundLuminance = (0, _relativeLuminanceW3C.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);
 }
+
+// eslint-disable-next-line @atlaskit/volt-strict-mode/no-multiple-exports
 function deltaE(rgbA, rgbB) {
   var labA = rgbToLab(rgbA);
   var labB = rgbToLab(rgbB);

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

@@ -5,13 +5,18 @@ Object.defineProperty(exports, "__esModule", {
   value: true
 });
 exports.findMissingCustomStyleElements = findMissingCustomStyleElements;
-exports.limitSizeOfCustomStyleElements = limitSizeOfCustomStyleElements;
+Object.defineProperty(exports, "limitSizeOfCustomStyleElements", {
+  enumerable: true,
+  get: function get() {
+    return _limitSizeOfCustomStyleElements.limitSizeOfCustomStyleElements;
+  }
+});
 exports.reduceTokenMap = reduceTokenMap;
 var _slicedToArray2 = _interopRequireDefault(require("@babel/runtime/helpers/slicedToArray"));
-var _toConsumableArray2 = _interopRequireDefault(require("@babel/runtime/helpers/toConsumableArray"));
 var _tokenNames = _interopRequireDefault(require("../artifacts/token-names"));
 var _constants = require("../constants");
 var _hash = require("./hash");
+var _limitSizeOfCustomStyleElements = require("./limit-size-of-custom-style-elements");
 function findMissingCustomStyleElements(UNSAFE_themeOptions, mode) {
   var optionString = JSON.stringify(UNSAFE_themeOptions);
   var uniqueId = (0, _hash.hash)(optionString);
@@ -27,15 +32,8 @@ function findMissingCustomStyleElements(UNSAFE_themeOptions, mode) {
   });
   return attrOfMissingCustomStyles;
 }
-function limitSizeOfCustomStyleElements(sizeThreshold) {
-  var styleTags = (0, _toConsumableArray2.default)(Array.from(document.head.querySelectorAll("style[".concat(_constants.CUSTOM_THEME_ATTRIBUTE, "][").concat(_constants.THEME_DATA_ATTRIBUTE, "]"))));
-  if (styleTags.length < sizeThreshold) {
-    return;
-  }
-  styleTags.slice(0, styleTags.length - (sizeThreshold - 1)).forEach(function (element) {
-    return element.remove();
-  });
-}
+
+// eslint-disable-next-line @atlaskit/volt-strict-mode/no-multiple-exports
 function reduceTokenMap(tokenMap, themeRamp) {
   return Object.entries(tokenMap).reduce(function (acc, _ref) {
     var _ref2 = (0, _slicedToArray2.default)(_ref, 2),

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

@@ -53,6 +53,8 @@ var additionalChecks = exports.additionalChecks = [{
 var getColorFromTokenRaw = function getColorFromTokenRaw(tokenName, mode) {
   return mode === 'light' ? _atlassianLightTokenValueForContrastCheck.default[tokenName] : _atlassianDarkTokenValueForContrastCheck.default[tokenName];
 };
+
+// eslint-disable-next-line @atlaskit/volt-strict-mode/no-multiple-exports
 var additionalContrastChecker = exports.additionalContrastChecker = function additionalContrastChecker(_ref) {
   var customThemeTokenMap = _ref.customThemeTokenMap,
     mode = _ref.mode,

package/dist/cjs/utils/generate-custom-color-ramp.js

@@ -4,36 +4,33 @@ var _interopRequireDefault = require("@babel/runtime/helpers/interopRequireDefau
 Object.defineProperty(exports, "__esModule", {
   value: true
 });
-exports.getClosestColorIndex = exports.generateTokenMapWithContrastCheck = exports.generateTokenMap = exports.generateColors = void 0;
+exports.generateTokenMapWithContrastCheck = exports.generateTokenMap = exports.generateColors = void 0;
+Object.defineProperty(exports, "getClosestColorIndex", {
+  enumerable: true,
+  get: function get() {
+    return _getClosestColorIndex.getClosestColorIndex;
+  }
+});
 var _defineProperty2 = _interopRequireDefault(require("@babel/runtime/helpers/defineProperty"));
 var _slicedToArray2 = _interopRequireDefault(require("@babel/runtime/helpers/slicedToArray"));
 var _toConsumableArray2 = _interopRequireDefault(require("@babel/runtime/helpers/toConsumableArray"));
 var _atlassianDarkTokenValueForContrastCheck = _interopRequireDefault(require("../artifacts/atlassian-dark-token-value-for-contrast-check"));
 var _colorUtils = require("./color-utils");
 var _customThemeTokenContrastCheck = require("./custom-theme-token-contrast-check");
+var _getClosestColorIndex = require("./get-closest-color-index");
 var _hctColorUtils = require("./hct-color-utils");
+var _hslToRgb = require("./hsl-to-rgb");
+var _relativeLuminanceW3C = require("./relative-luminance-w3-c");
+var _rgbToHex = require("./rgb-to-hex");
 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) { (0, _defineProperty2.default)(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; }
 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];
-var getClosestColorIndex = exports.getClosestColorIndex = function getClosestColorIndex(themeRamp, brandColor) {
-  // Iterate over themeRamp and find whichever color is closest to brandColor
-  var closestColorIndex = 0;
-  var closestColorDistance = null;
-  themeRamp.forEach(function (value, index) {
-    var distance = (0, _colorUtils.deltaE)((0, _colorUtils.hexToRgb)(value), (0, _colorUtils.hexToRgb)(brandColor));
-    if (closestColorDistance === null || distance < closestColorDistance) {
-      closestColorIndex = index;
-      closestColorDistance = distance;
-    }
-  });
-  return closestColorIndex;
-};
 var generateColors = exports.generateColors = function generateColors(brandColor) {
   // Determine luminance
   var HSLBrandColorHue = (0, _colorUtils.hexToHSL)(brandColor)[0];
-  var baseRgb = (0, _colorUtils.HSLToRGB)(HSLBrandColorHue, 100, 60);
-  var isLowLuminance = (0, _colorUtils.relativeLuminanceW3C)(baseRgb[0], baseRgb[1], baseRgb[2]) < 0.4;
+  var baseRgb = (0, _hslToRgb.HSLToRGB)(HSLBrandColorHue, 100, 60);
+  var isLowLuminance = (0, _relativeLuminanceW3C.relativeLuminanceW3C)(baseRgb[0], baseRgb[1], baseRgb[2]) < 0.4;
   // Choose right palette
   var themeRatios = isLowLuminance ? lowLuminanceContrastRatios : highLuminanceContrastRatios;
   var brandRgba = (0, _colorUtils.hexToRgbA)(brandColor);
@@ -46,9 +43,9 @@ var generateColors = exports.generateColors = function generateColors(brandColor
   var themeRamp = themeRatios.map(function (contrast) {
     var rgbaColor = (0, _hctColorUtils.rgbaFromArgb)(_hctColorUtils.Hct.from(hctColor.hue, hctColor.chroma, _hctColorUtils.Contrast.darker(100, contrast) + 0.25 // Material's utils provide an offset
     ).toInt());
-    return (0, _colorUtils.rgbToHex)(rgbaColor.r, rgbaColor.g, rgbaColor.b);
+    return (0, _rgbToHex.rgbToHex)(rgbaColor.r, rgbaColor.g, rgbaColor.b);
   });
-  var closestColorIndex = getClosestColorIndex(themeRamp, brandColor);
+  var closestColorIndex = (0, _getClosestColorIndex.getClosestColorIndex)(themeRamp, brandColor);
 
   // Replace closet color with brandColor
   var updatedThemeRamp = (0, _toConsumableArray2.default)(themeRamp);
@@ -79,12 +76,14 @@ function getInteractionStates(rampPosition, number, colors) {
   }
   return result;
 }
+
+// eslint-disable-next-line @atlaskit/volt-strict-mode/no-multiple-exports
 var generateTokenMap = exports.generateTokenMap = function generateTokenMap(brandColor, mode, themeRamp) {
   var _generateColors = generateColors(brandColor),
     ramp = _generateColors.ramp,
     replacedColor = _generateColors.replacedColor;
   var colors = themeRamp || ramp;
-  var closestColorIndex = getClosestColorIndex(colors, brandColor);
+  var closestColorIndex = (0, _getClosestColorIndex.getClosestColorIndex)(colors, brandColor);
   var customThemeTokenMapLight = {};
   var customThemeTokenMapDark = {};
   var inputContrast = (0, _colorUtils.getContrastRatio)(brandColor, '#FFFFFF');
@@ -218,6 +217,8 @@ var generateTokenMap = exports.generateTokenMap = function generateTokenMap(bran
     dark: customThemeTokenMapDark
   };
 };
+
+// eslint-disable-next-line @atlaskit/volt-strict-mode/no-multiple-exports
 var generateTokenMapWithContrastCheck = exports.generateTokenMapWithContrastCheck = function generateTokenMapWithContrastCheck(brandColor, mode, themeRamp) {
   var colors = themeRamp || generateColors(brandColor).ramp;
   var tokenMaps = generateTokenMap(brandColor, mode, colors);

package/dist/cjs/utils/get-alpha.js

@@ -0,0 +1,13 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.getAlpha = getAlpha;
+function getAlpha(hex) {
+  if (hex.length === 9) {
+    var int = parseInt(hex.slice(7, 9), 16) / 255;
+    return Number(parseFloat(int.toString()).toFixed(2));
+  }
+  return 1;
+}

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

@@ -0,0 +1,20 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.getClosestColorIndex = void 0;
+var _colorUtils = require("./color-utils");
+var getClosestColorIndex = exports.getClosestColorIndex = function getClosestColorIndex(themeRamp, brandColor) {
+  // Iterate over themeRamp and find whichever color is closest to brandColor
+  var closestColorIndex = 0;
+  var closestColorDistance = null;
+  themeRamp.forEach(function (value, index) {
+    var distance = (0, _colorUtils.deltaE)((0, _colorUtils.hexToRgb)(value), (0, _colorUtils.hexToRgb)(brandColor));
+    if (closestColorDistance === null || distance < closestColorDistance) {
+      closestColorIndex = index;
+      closestColorDistance = distance;
+    }
+  });
+  return closestColorIndex;
+};

package/dist/cjs/utils/get-css-custom-property.js

@@ -0,0 +1,32 @@
+"use strict";
+
+var _interopRequireDefault = require("@babel/runtime/helpers/interopRequireDefault");
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.getCSSCustomProperty = void 0;
+var _toConsumableArray2 = _interopRequireDefault(require("@babel/runtime/helpers/toConsumableArray"));
+var _constants = require("../constants");
+/**
+ * Transforms a style dictionary token path to a CSS custom property.
+ *
+ * A css prefix will be prepended and all [default] key words will be omitted
+ * from the path
+ *
+ * @example <caption>Passing a path as an array</caption>
+ * // Returns ds-background-bold
+ * getCSSCustomProperty(['color', 'background', 'bold', '[default]'])
+ *
+ * @example <caption>Passing a path as a string</caption>
+ * // Returns ds-background-bold
+ * getCSSCustomProperty('color.background.bold.[default]')
+ */
+var getCSSCustomProperty = exports.getCSSCustomProperty = function getCSSCustomProperty(path) {
+  var normalizedPath = typeof path === 'string' ? path.split('.') : path;
+
+  // Opacity and other 'shallow' groups are more readable when not trimmed
+  var slice = _constants.CSS_VAR_FULL.includes(normalizedPath[0]) ? 0 : 1;
+  return "--".concat([_constants.CSS_PREFIX].concat((0, _toConsumableArray2.default)(normalizedPath.slice(slice))).filter(function (el) {
+    return el !== '[default]';
+  }).join('-'));
+};

package/dist/cjs/utils/get-fully-qualified-token-id.js

@@ -0,0 +1,19 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.getFullyQualifiedTokenId = void 0;
+/**
+ * Transforms a style dictionary token path to a fully qualified token id
+ * These Ids are intended to be used internal to this package by style-dictionary
+ *
+ * [default] key words will NOT be omitted from the path
+ *
+ * @example <caption>Passing a path as a string</caption>
+ * // Returns color.background.bold.[default]
+ * getFullyQualifiedTokenId(['color', 'background', 'bold', '[default]'])
+ */
+var getFullyQualifiedTokenId = exports.getFullyQualifiedTokenId = function getFullyQualifiedTokenId(path) {
+  return path.join('.');
+};

package/dist/cjs/utils/get-theme-override-preferences.js

@@ -0,0 +1,12 @@
+"use strict";
+
+var _interopRequireDefault = require("@babel/runtime/helpers/interopRequireDefault");
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.getThemeOverridePreferences = void 0;
+var _toConsumableArray2 = _interopRequireDefault(require("@babel/runtime/helpers/toConsumableArray"));
+var getThemeOverridePreferences = exports.getThemeOverridePreferences = function getThemeOverridePreferences(_themeState) {
+  var themeOverridePreferences = [];
+  return (0, _toConsumableArray2.default)(new Set(themeOverridePreferences));
+};

package/dist/cjs/utils/get-theme-preferences.js

@@ -4,10 +4,17 @@ var _interopRequireDefault = require("@babel/runtime/helpers/interopRequireDefau
 Object.defineProperty(exports, "__esModule", {
   value: true
 });
-exports.getThemePreferences = exports.getThemeOverridePreferences = void 0;
+Object.defineProperty(exports, "getThemeOverridePreferences", {
+  enumerable: true,
+  get: function get() {
+    return _getThemeOverridePreferences.getThemeOverridePreferences;
+  }
+});
+exports.getThemePreferences = void 0;
 var _toConsumableArray2 = _interopRequireDefault(require("@babel/runtime/helpers/toConsumableArray"));
 var _platformFeatureFlags = require("@atlaskit/platform-feature-flags");
 var _getIncreasedContrastTheme = _interopRequireDefault(require("./get-increased-contrast-theme"));
+var _getThemeOverridePreferences = require("./get-theme-override-preferences");
 var getThemePreferences = exports.getThemePreferences = function getThemePreferences(themeState) {
   var colorMode = themeState.colorMode,
     contrastMode = themeState.contrastMode,
@@ -44,8 +51,4 @@ var getThemePreferences = exports.getThemePreferences = function getThemePrefere
     }
   });
   return (0, _toConsumableArray2.default)(new Set(themePreferences));
-};
-var getThemeOverridePreferences = exports.getThemeOverridePreferences = function getThemeOverridePreferences(_themeState) {
-  var themeOverridePreferences = [];
-  return (0, _toConsumableArray2.default)(new Set(themeOverridePreferences));
 };

package/dist/cjs/utils/get-token-id.js

@@ -0,0 +1,26 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.getTokenId = void 0;
+/**
+ * Transforms a style dictionary token path to a shorthand token id
+ * These ids will be typically be how tokens are interacted with via typescript and css
+ *
+ * All [default] key words will be omitted from the path
+ *
+ * @example <caption>Passing a path as an array</caption>
+ * // Returns color.background.bold
+ * getTokenId(['color', 'background', 'bold', '[default]'])
+ *
+ * @example <caption>Passing a path as a string</caption>
+ * // Returns color.background.bold
+ * getTokenId('color.background.bold.[default]')
+ */
+var getTokenId = exports.getTokenId = function getTokenId(path) {
+  var normalizedPath = typeof path === 'string' ? path.split('.') : path;
+  return normalizedPath.filter(function (el) {
+    return el !== '[default]';
+  }).join('.');
+};

package/dist/cjs/utils/hct-color-utils/argb-from-rgb.js

@@ -0,0 +1,12 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.argbFromRgb = argbFromRgb;
+/**
+ * Converts a color from RGB components to ARGB format.
+ */
+function argbFromRgb(red, green, blue) {
+  return (255 << 24 | (red & 255) << 16 | (green & 255) << 8 | blue & 255) >>> 0;
+}

package/dist/cjs/utils/hct-color-utils/clamp-double.js

@@ -0,0 +1,20 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.clampDouble = clampDouble;
+/**
+ * Clamps an integer between two floating-point numbers.
+ *
+ * @return input when min <= input <= max, and either min or max
+ * otherwise.
+ */
+function clampDouble(min, max, input) {
+  if (input < min) {
+    return min;
+  } else if (input > max) {
+    return max;
+  }
+  return input;
+}

package/dist/cjs/utils/hct-color-utils/clamp-int.js

@@ -0,0 +1,20 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.clampInt = clampInt;
+/**
+ * Clamps an integer between two integers.
+ *
+ * @return input when min <= input <= max, and either min or max
+ * otherwise.
+ */
+function clampInt(min, max, input) {
+  if (input < min) {
+    return min;
+  } else if (input > max) {
+    return max;
+  }
+  return input;
+}