@elastic/eui 88.0.0 → 88.2.0

package/es/components/text_truncate/text_truncate.styles.js

@@ -0,0 +1,49 @@
+function _EMOTION_STRINGIFIED_CSS_ERROR__() { return "You have tried to stringify object returned from `css` function. It isn't supposed to be used directly (e.g. as value of the `className` prop), but rather handed to emotion so it can handle it (e.g. as value of `css` prop)."; }
+/*
+ * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one
+ * or more contributor license agreements. Licensed under the Elastic License
+ * 2.0 and the Server Side Public License, v 1; you may not use this file except
+ * in compliance with, at your election, the Elastic License 2.0 or the Server
+ * Side Public License, v 1.
+ */
+
+import { css } from '@emotion/react';
+export var euiTextTruncateStyles = {
+  euiTextTruncate: process.env.NODE_ENV === "production" ? {
+    name: "7o5qnz-euiTextTruncate",
+    styles: "position:relative;overflow:hidden;white-space:nowrap;label:euiTextTruncate;"
+  } : {
+    name: "7o5qnz-euiTextTruncate",
+    styles: "position:relative;overflow:hidden;white-space:nowrap;label:euiTextTruncate;",
+    toString: _EMOTION_STRINGIFIED_CSS_ERROR__
+  },
+  /**
+   * The below CSS is a hack to get double clicking and selecting the *full* text
+   * instead of the truncated text (useful for copying/pasting, and mimics how
+   * `text-overflow: ellipsis` works).
+   *
+   * Real talk: I'm lowkey amazed it works and it wouldn't surprise me if we ran into
+   * cross-browser issues with this at some point. Hopefully CSS natively implements
+   * custom text truncation some day (https://github.com/w3c/csswg-drafts/issues/3937)
+   * and there'll be no need for the entire component at that point 🙏
+   */
+  // Makes the truncated text unselectable/un-clickable
+  truncatedText: process.env.NODE_ENV === "production" ? {
+    name: "1dore6v-truncatedText",
+    styles: "user-select:none;pointer-events:none;label:truncatedText;"
+  } : {
+    name: "1dore6v-truncatedText",
+    styles: "user-select:none;pointer-events:none;label:truncatedText;",
+    toString: _EMOTION_STRINGIFIED_CSS_ERROR__
+  },
+  // Positions the full text on top of the truncated text (so that clicking targets it)
+  // and gives it a color opacity of 0 so that it's not actually visible
+  fullText: process.env.NODE_ENV === "production" ? {
+    name: "1kxt4rj-fullText",
+    styles: "position:absolute;inset:0;overflow:hidden;color:rgba(0, 0, 0, 0);@supports (-webkit-hyphens: none){text-overflow:ellipsis;};label:fullText;"
+  } : {
+    name: "1kxt4rj-fullText",
+    styles: "position:absolute;inset:0;overflow:hidden;color:rgba(0, 0, 0, 0);@supports (-webkit-hyphens: none){text-overflow:ellipsis;};label:fullText;",
+    toString: _EMOTION_STRINGIFIED_CSS_ERROR__
+  }
+};

package/es/components/text_truncate/utils.js

@@ -0,0 +1,348 @@
+var _excluded = ["container"],
+  _excluded2 = ["font", "container"];
+function _typeof(obj) { "@babel/helpers - typeof"; return _typeof = "function" == typeof Symbol && "symbol" == typeof Symbol.iterator ? function (obj) { return typeof obj; } : function (obj) { return obj && "function" == typeof Symbol && obj.constructor === Symbol && obj !== Symbol.prototype ? "symbol" : typeof obj; }, _typeof(obj); }
+function _objectWithoutProperties(source, excluded) { if (source == null) return {}; var target = _objectWithoutPropertiesLoose(source, excluded); var key, i; if (Object.getOwnPropertySymbols) { var sourceSymbolKeys = Object.getOwnPropertySymbols(source); for (i = 0; i < sourceSymbolKeys.length; i++) { key = sourceSymbolKeys[i]; if (excluded.indexOf(key) >= 0) continue; if (!Object.prototype.propertyIsEnumerable.call(source, key)) continue; target[key] = source[key]; } } return target; }
+function _objectWithoutPropertiesLoose(source, excluded) { if (source == null) return {}; var target = {}; var sourceKeys = Object.keys(source); var key, i; for (i = 0; i < sourceKeys.length; i++) { key = sourceKeys[i]; if (excluded.indexOf(key) >= 0) continue; target[key] = source[key]; } return target; }
+function _inherits(subClass, superClass) { if (typeof superClass !== "function" && superClass !== null) { throw new TypeError("Super expression must either be null or a function"); } subClass.prototype = Object.create(superClass && superClass.prototype, { constructor: { value: subClass, writable: true, configurable: true } }); Object.defineProperty(subClass, "prototype", { writable: false }); if (superClass) _setPrototypeOf(subClass, superClass); }
+function _setPrototypeOf(o, p) { _setPrototypeOf = Object.setPrototypeOf ? Object.setPrototypeOf.bind() : function _setPrototypeOf(o, p) { o.__proto__ = p; return o; }; return _setPrototypeOf(o, p); }
+function _createSuper(Derived) { var hasNativeReflectConstruct = _isNativeReflectConstruct(); return function _createSuperInternal() { var Super = _getPrototypeOf(Derived), result; if (hasNativeReflectConstruct) { var NewTarget = _getPrototypeOf(this).constructor; result = Reflect.construct(Super, arguments, NewTarget); } else { result = Super.apply(this, arguments); } return _possibleConstructorReturn(this, result); }; }
+function _possibleConstructorReturn(self, call) { if (call && (_typeof(call) === "object" || typeof call === "function")) { return call; } else if (call !== void 0) { throw new TypeError("Derived constructors may only return object or undefined"); } return _assertThisInitialized(self); }
+function _assertThisInitialized(self) { if (self === void 0) { throw new ReferenceError("this hasn't been initialised - super() hasn't been called"); } return self; }
+function _isNativeReflectConstruct() { if (typeof Reflect === "undefined" || !Reflect.construct) return false; if (Reflect.construct.sham) return false; if (typeof Proxy === "function") return true; try { Boolean.prototype.valueOf.call(Reflect.construct(Boolean, [], function () {})); return true; } catch (e) { return false; } }
+function _getPrototypeOf(o) { _getPrototypeOf = Object.setPrototypeOf ? Object.getPrototypeOf.bind() : function _getPrototypeOf(o) { return o.__proto__ || Object.getPrototypeOf(o); }; return _getPrototypeOf(o); }
+function _slicedToArray(arr, i) { return _arrayWithHoles(arr) || _iterableToArrayLimit(arr, i) || _unsupportedIterableToArray(arr, i) || _nonIterableRest(); }
+function _nonIterableRest() { throw new TypeError("Invalid attempt to destructure non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method."); }
+function _unsupportedIterableToArray(o, minLen) { if (!o) return; if (typeof o === "string") return _arrayLikeToArray(o, minLen); var n = Object.prototype.toString.call(o).slice(8, -1); if (n === "Object" && o.constructor) n = o.constructor.name; if (n === "Map" || n === "Set") return Array.from(o); if (n === "Arguments" || /^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(n)) return _arrayLikeToArray(o, minLen); }
+function _arrayLikeToArray(arr, len) { if (len == null || len > arr.length) len = arr.length; for (var i = 0, arr2 = new Array(len); i < len; i++) arr2[i] = arr[i]; return arr2; }
+function _iterableToArrayLimit(arr, i) { var _i = null == arr ? null : "undefined" != typeof Symbol && arr[Symbol.iterator] || arr["@@iterator"]; if (null != _i) { var _s, _e, _x, _r, _arr = [], _n = !0, _d = !1; try { if (_x = (_i = _i.call(arr)).next, 0 === i) { if (Object(_i) !== _i) return; _n = !1; } else for (; !(_n = (_s = _x.call(_i)).done) && (_arr.push(_s.value), _arr.length !== i); _n = !0); } catch (err) { _d = !0, _e = err; } finally { try { if (!_n && null != _i.return && (_r = _i.return(), Object(_r) !== _r)) return; } finally { if (_d) throw _e; } } return _arr; } }
+function _arrayWithHoles(arr) { if (Array.isArray(arr)) return arr; }
+function _defineProperties(target, props) { for (var i = 0; i < props.length; i++) { var descriptor = props[i]; descriptor.enumerable = descriptor.enumerable || false; descriptor.configurable = true; if ("value" in descriptor) descriptor.writable = true; Object.defineProperty(target, _toPropertyKey(descriptor.key), descriptor); } }
+function _createClass(Constructor, protoProps, staticProps) { if (protoProps) _defineProperties(Constructor.prototype, protoProps); if (staticProps) _defineProperties(Constructor, staticProps); Object.defineProperty(Constructor, "prototype", { writable: false }); return Constructor; }
+function _classCallCheck(instance, Constructor) { if (!(instance instanceof Constructor)) { throw new TypeError("Cannot call a class as a function"); } }
+function _defineProperty(obj, key, value) { key = _toPropertyKey(key); if (key in obj) { Object.defineProperty(obj, key, { value: value, enumerable: true, configurable: true, writable: true }); } else { obj[key] = value; } return obj; }
+function _toPropertyKey(arg) { var key = _toPrimitive(arg, "string"); return _typeof(key) === "symbol" ? key : String(key); }
+function _toPrimitive(input, hint) { if (_typeof(input) !== "object" || input === null) return input; var prim = input[Symbol.toPrimitive]; if (prim !== undefined) { var res = prim.call(input, hint || "default"); if (_typeof(res) !== "object") return res; throw new TypeError("@@toPrimitive must return a primitive value."); } return (hint === "string" ? String : Number)(input); }
+/*
+ * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one
+ * or more contributor license agreements. Licensed under the Elastic License
+ * 2.0 and the Server Side Public License, v 1; you may not use this file except
+ * in compliance with, at your election, the Elastic License 2.0 or the Server
+ * Side Public License, v 1.
+ */
+/**
+ * This internal shared/base class contains the actual logic for truncating text
+ * (as well as a few handy utilities for checking whether truncation is possible
+ * or even necessary).
+ *
+ * How the underlying mechanism works: the full text is rendered, and then
+ * characters are removed one by one until the width of the text fits within
+ * the specified available width.
+ *
+ * Side note: The exception to this is the `truncateStartEndAtPosition` method,
+ * which works by building up from an empty string / by adding characters
+ * instead of removing them.
+ */
+var _TruncationUtils = /*#__PURE__*/_createClass(function _TruncationUtils(_ref) {
+  var _this = this;
+  var fullText = _ref.fullText,
+    ellipsis = _ref.ellipsis,
+    availableWidth = _ref.availableWidth;
+  _classCallCheck(this, _TruncationUtils);
+  _defineProperty(this, "fullText", void 0);
+  _defineProperty(this, "ellipsis", void 0);
+  _defineProperty(this, "availableWidth", void 0);
+  /**
+   * Early return checks
+   */
+  _defineProperty(this, "checkIfTruncationIsNeeded", function () {
+    _this.setTextToCheck(_this.fullText);
+    if (_this.availableWidth > _this.textWidth) {
+      return false;
+    }
+  });
+  _defineProperty(this, "checkSufficientEllipsisWidth", function (truncation) {
+    var textToCheck = truncation === 'startEnd' ? "".concat(_this.ellipsis, " ").concat(_this.ellipsis) // startEnd needs a little more space
+    : _this.ellipsis;
+    _this.setTextToCheck(textToCheck);
+    if (_this.textWidth >= _this.availableWidth * 0.9) {
+      console.error('The truncation ellipsis is larger than the available width. No text can be rendered.');
+      return false;
+    }
+  });
+  _defineProperty(this, "checkTruncationOffsetWidth", function (text) {
+    _this.setTextToCheck(text);
+    if (_this.textWidth > _this.availableWidth) {
+      console.error("The passed truncationOffset is too large for the available width. Truncating the offset instead.");
+      return false;
+    }
+  });
+  /**
+   * Truncation types logic. This is where the magic happens
+   */
+  _defineProperty(this, "truncateStart", function (truncationOffset) {
+    var truncatedText = _this.fullText;
+    var leadingText = '';
+    var combinedText = function combinedText() {
+      return "".concat(leadingText).concat(truncatedText);
+    };
+    if (truncationOffset) {
+      var _splitText$at = splitText(_this.fullText).at(truncationOffset);
+      var _splitText$at2 = _slicedToArray(_splitText$at, 2);
+      leadingText = _splitText$at2[0];
+      truncatedText = _splitText$at2[1];
+      var widthCheck = "".concat(leadingText).concat(_this.ellipsis);
+      if (_this.checkTruncationOffsetWidth(widthCheck) === false) {
+        truncatedText = leadingText;
+        leadingText = '';
+      }
+    }
+    leadingText += _this.ellipsis;
+    _this.setTextToCheck(combinedText());
+    while (_this.textWidth > _this.availableWidth) {
+      truncatedText = removeFirstCharacter(truncatedText);
+      _this.setTextToCheck(combinedText());
+    }
+    return combinedText();
+  });
+  _defineProperty(this, "truncateEnd", function (truncationOffset) {
+    var truncatedText = _this.fullText;
+    var trailingText = '';
+    var combinedText = function combinedText() {
+      return "".concat(truncatedText).concat(trailingText);
+    };
+    if (truncationOffset) {
+      var index = _this.fullText.length - truncationOffset;
+      var _splitText$at3 = splitText(_this.fullText).at(index);
+      var _splitText$at4 = _slicedToArray(_splitText$at3, 2);
+      truncatedText = _splitText$at4[0];
+      trailingText = _splitText$at4[1];
+      var widthCheck = "".concat(_this.ellipsis).concat(trailingText);
+      if (_this.checkTruncationOffsetWidth(widthCheck) === false) {
+        truncatedText = trailingText;
+        trailingText = '';
+      }
+    }
+    trailingText = _this.ellipsis + trailingText;
+    _this.setTextToCheck(combinedText());
+    while (_this.textWidth > _this.availableWidth) {
+      truncatedText = removeLastCharacter(truncatedText);
+      _this.setTextToCheck(combinedText());
+    }
+    return combinedText();
+  });
+  _defineProperty(this, "truncateStartEndAtPosition", function (truncationPosition) {
+    // If using a non-centered startEnd anchor position, we need to *build*
+    // the string from scratch instead of *removing* from the full text string,
+    // to make sure we don't go past the beginning or end of the text
+    var truncatedText = '';
+    _this.setTextToCheck(truncatedText);
+
+    // Ellipses are conditional - if the anchor is towards the beginning or end,
+    // it's possible they shouldn't render
+    var startingEllipsis = _this.ellipsis;
+    var endingEllipsis = _this.ellipsis;
+
+    // Split the text into two at the anchor position
+    var _splitText$at5 = splitText(_this.fullText).at(truncationPosition),
+      _splitText$at6 = _slicedToArray(_splitText$at5, 2),
+      firstPart = _splitText$at6[0],
+      secondPart = _splitText$at6[1];
+    var combinedText = function combinedText() {
+      return "".concat(startingEllipsis).concat(truncatedText).concat(endingEllipsis);
+    };
+    while (_this.textWidth <= _this.availableWidth) {
+      if (firstPart.length > 0) {
+        truncatedText = "".concat(getLastCharacter(firstPart)).concat(truncatedText);
+        firstPart = removeLastCharacter(firstPart);
+      } else {
+        startingEllipsis = '';
+      }
+      if (secondPart.length > 0) {
+        truncatedText = "".concat(truncatedText).concat(getFirstCharacter(secondPart));
+        secondPart = removeFirstCharacter(secondPart);
+      } else {
+        endingEllipsis = '';
+      }
+      _this.setTextToCheck(combinedText());
+    }
+
+    // Because this logic builds text outwards vs. removing inwards, the final
+    // text width ends up a little larger than the container, and we need to
+    // remove the last added character(s)
+    if (!startingEllipsis) {
+      truncatedText = removeLastCharacter(truncatedText);
+    } else if (!endingEllipsis) {
+      truncatedText = removeFirstCharacter(truncatedText);
+    } else {
+      truncatedText = removeFirstAndLastCharacters(truncatedText);
+    }
+    return combinedText();
+  });
+  _defineProperty(this, "truncateStartEndAtMiddle", function () {
+    var truncatedText = _this.fullText;
+    _this.setTextToCheck(truncatedText);
+    var combinedText = function combinedText() {
+      return "".concat(_this.ellipsis).concat(truncatedText).concat(_this.ellipsis);
+    };
+    while (_this.textWidth > _this.availableWidth) {
+      truncatedText = removeFirstAndLastCharacters(truncatedText);
+      _this.setTextToCheck(combinedText());
+    }
+    return combinedText();
+  });
+  _defineProperty(this, "truncateMiddle", function () {
+    var middlePosition = Math.floor(_this.fullText.length / 2);
+    var _splitText$at7 = splitText(_this.fullText).at(middlePosition),
+      _splitText$at8 = _slicedToArray(_splitText$at7, 2),
+      firstHalf = _splitText$at8[0],
+      secondHalf = _splitText$at8[1];
+    var trimfirstHalf;
+    var combinedText = function combinedText() {
+      return "".concat(firstHalf).concat(_this.ellipsis).concat(secondHalf);
+    };
+    _this.setTextToCheck(combinedText());
+    while (_this.textWidth > _this.availableWidth) {
+      trimfirstHalf = !trimfirstHalf;
+      if (trimfirstHalf) {
+        firstHalf = removeLastCharacter(firstHalf);
+      } else {
+        secondHalf = removeFirstCharacter(secondHalf);
+      }
+      _this.setTextToCheck(combinedText());
+    }
+    return combinedText();
+  });
+  this.fullText = fullText;
+  this.ellipsis = ellipsis;
+  this.availableWidth = availableWidth;
+}
+
+/**
+ * Internal measurement utils which will be overridden depending on the
+ * rendering approach used (e.g. DOM vs Canvas).
+ */);
+/**
+ * Creates a temporary vanilla JS DOM element for manipulating text and
+ * determining text width.
+ *
+ * Requires passing in a container element to which the temporary element
+ * will be appended. Any CSS/font styles that need to be accounted for should
+ * be automatically inherited from the container.
+ *
+ * NOTE: The consumer is responsible for calling the `cleanup()` method manually
+ * to remove the temporary DOM node once their usage of this utility is complete.
+ */
+
+export var TruncationUtilsWithDOM = /*#__PURE__*/function (_TruncationUtils2) {
+  _inherits(TruncationUtilsWithDOM, _TruncationUtils2);
+  var _super = _createSuper(TruncationUtilsWithDOM);
+  function TruncationUtilsWithDOM(_ref2) {
+    var _this2;
+    var container = _ref2.container,
+      rest = _objectWithoutProperties(_ref2, _excluded);
+    _classCallCheck(this, TruncationUtilsWithDOM);
+    _this2 = _super.call(this, rest);
+    _defineProperty(_assertThisInitialized(_this2), "container", void 0);
+    _defineProperty(_assertThisInitialized(_this2), "span", void 0);
+    _defineProperty(_assertThisInitialized(_this2), "setTextToCheck", function (text) {
+      _this2.span.textContent = text;
+    });
+    _defineProperty(_assertThisInitialized(_this2), "cleanup", function () {
+      _this2.container.removeChild(_this2.span);
+    });
+    _this2.container = container;
+    _this2.span = document.createElement('span');
+    _this2.span.style.position = 'absolute'; // Prevent page reflow/repaint for performance
+    _this2.span.style.whiteSpace = 'nowrap'; // EuiTextTruncate already sets this on the parent, but we'll set it here as well for consumers who use this util standalone
+    _this2.container.appendChild(_this2.span);
+    return _this2;
+  }
+  _createClass(TruncationUtilsWithDOM, [{
+    key: "textWidth",
+    get: function get() {
+      return this.span.offsetWidth;
+    }
+  }]);
+  return TruncationUtilsWithDOM;
+}(_TruncationUtils);
+
+/**
+ * Creates a temporary Canvas element for manipulating text & determining
+ * text width. This method is compatible with charts or other canvas-rendered
+ * frameworks, and requires no cleanup method.
+ *
+ * To accurately measure text, canvas rendering requires either a container to
+ * compute/derive font styles from, or a static font string (useful for usage
+ * outside the DOM). Particular care should be applied when fallback fonts are
+ * used, as more fallback fonts can lead to less precision.
+ *
+ * Please note that while canvas is more performant than DOM measurement, there
+ * are subpixel to single digit pixel differences between DOM and canvas
+ * measurement due to the different rendering engines used.
+ */
+export var TruncationUtilsWithCanvas = /*#__PURE__*/function (_TruncationUtils3) {
+  _inherits(TruncationUtilsWithCanvas, _TruncationUtils3);
+  var _super2 = _createSuper(TruncationUtilsWithCanvas);
+  function TruncationUtilsWithCanvas(_ref3) {
+    var _this3;
+    var font = _ref3.font,
+      container = _ref3.container,
+      rest = _objectWithoutProperties(_ref3, _excluded2);
+    _classCallCheck(this, TruncationUtilsWithCanvas);
+    _this3 = _super2.call(this, rest);
+    _defineProperty(_assertThisInitialized(_this3), "context", void 0);
+    _defineProperty(_assertThisInitialized(_this3), "currentText", '');
+    _defineProperty(_assertThisInitialized(_this3), "computeFontFromElement", function (element) {
+      var computedStyles = window.getComputedStyle(element);
+      return ['font-style', 'font-variant', 'font-weight', 'font-size', 'font-family'].map(function (prop) {
+        return computedStyles.getPropertyValue(prop);
+      }).join(' ').trim();
+    });
+    _defineProperty(_assertThisInitialized(_this3), "setTextToCheck", function (text) {
+      _this3.currentText = text;
+    });
+    _this3.context = document.createElement('canvas').getContext('2d');
+
+    // Set the canvas font to ensure text width calculations are correct
+    if (font) {
+      _this3.context.font = font;
+    } else if (container) {
+      _this3.context.font = _this3.computeFontFromElement(container);
+    }
+    return _this3;
+  }
+  _createClass(TruncationUtilsWithCanvas, [{
+    key: "textWidth",
+    get: function get() {
+      return this.context.measureText(this.currentText).width;
+    }
+  }]);
+  return TruncationUtilsWithCanvas;
+}(_TruncationUtils);
+
+/**
+ * DRY character/substring utils
+ */
+
+var removeLastCharacter = function removeLastCharacter(text) {
+  return text.substring(0, text.length - 1);
+};
+var getLastCharacter = function getLastCharacter(text) {
+  return text.substring(text.length - 1);
+};
+var removeFirstCharacter = function removeFirstCharacter(text) {
+  return text.substring(1);
+};
+var getFirstCharacter = function getFirstCharacter(text) {
+  return text.substring(0, 1);
+};
+var removeFirstAndLastCharacters = function removeFirstAndLastCharacters(text) {
+  return text.substring(1, text.length - 1);
+};
+var splitText = function splitText(text) {
+  return {
+    at: function at(index) {
+      return [text.substring(0, index), text.substring(index)];
+    }
+  };
+};

package/es/global_styling/functions/typography.js

@@ -20,16 +20,16 @@ export function euiFontSizeFromScale(scale, _ref) {
   var base = _ref.base,
     font = _ref.font;
   var _ref2 = arguments.length > 2 && arguments[2] !== undefined ? arguments[2] : {},
-    _ref2$measurement = _ref2.measurement,
-    measurement = _ref2$measurement === void 0 ? 'rem' : _ref2$measurement,
+    _ref2$unit = _ref2.unit,
+    unit = _ref2$unit === void 0 ? font.defaultUnits : _ref2$unit,
     customScale = _ref2.customScale;
-  if (measurement === 'em') {
+  if (unit === 'em') {
     return "".concat(font.scale[scale], "em");
   }
   var numerator = base * font.scale[scale];
   if (customScale) numerator *= font.scale[customScale];
   var denominator = base * font.scale[font.body.scale];
-  return measurement === 'px' ? "".concat(numerator, "px") : "".concat((numerator / denominator).toFixed(4), "rem");
+  return unit === 'px' ? "".concat(numerator, "px") : "".concat((numerator / denominator).toFixed(4), "rem");
 }
 
 /**
@@ -48,8 +48,8 @@ export function euiLineHeightFromBaseline(scale, _ref3) {
   var base = _ref3.base,
     font = _ref3.font;
   var _ref4 = arguments.length > 2 && arguments[2] !== undefined ? arguments[2] : {},
-    _ref4$measurement = _ref4.measurement,
-    measurement = _ref4$measurement === void 0 ? 'rem' : _ref4$measurement,
+    _ref4$unit = _ref4.unit,
+    unit = _ref4$unit === void 0 ? font.defaultUnits : _ref4$unit,
     customScale = _ref4.customScale;
   var baseline = font.baseline,
     lineHeightMultiplier = font.lineHeightMultiplier;
@@ -57,13 +57,13 @@ export function euiLineHeightFromBaseline(scale, _ref3) {
   if (customScale) numerator *= font.scale[customScale];
   var denominator = base * font.scale[font.body.scale];
   var _lineHeightMultiplier = numerator <= base ? lineHeightMultiplier : lineHeightMultiplier * 0.833;
-  if (measurement === 'em') {
+  if (unit === 'em') {
     // Even though the line-height via `em` cannot be determined against the pixel baseline grid;
     // we will assume that typically larger scale font-sizes should have a shorter line-height;
     return _lineHeightMultiplier.toFixed(4).toString();
   }
   var pixelValue = Math.floor(Math.round(numerator * _lineHeightMultiplier) / baseline) * baseline;
-  return measurement === 'px' ? "".concat(pixelValue, "px") : "".concat((pixelValue / denominator).toFixed(4), "rem");
+  return unit === 'px' ? "".concat(pixelValue, "px") : "".concat((pixelValue / denominator).toFixed(4), "rem");
 }
 
 /**

package/es/global_styling/variables/typography.js

@@ -10,7 +10,7 @@
  * Font units of measure
  */
 
-export var EuiThemeFontSizeMeasurements = ['rem', 'px', 'em'];
+export var EuiThemeFontUnits = ['rem', 'px', 'em'];
 /*
  * Font scale
  */

package/es/services/theme/context.js

@@ -18,5 +18,7 @@ export var EuiNestedThemeContext = /*#__PURE__*/createContext({
   isGlobalTheme: true,
   hasDifferentColorFromGlobalTheme: false,
   bodyColor: '',
-  colorClassName: ''
+  colorClassName: '',
+  setGlobalCSSVariables: function setGlobalCSSVariables() {},
+  setNearestThemeCSSVariables: function setNearestThemeCSSVariables() {}
 });

package/es/services/theme/hooks.js

@@ -8,7 +8,7 @@ function _extends() { _extends = Object.assign ? Object.assign.bind() : function
  */
 
 import React, { forwardRef, useContext, useMemo } from 'react';
-import { EuiThemeContext, EuiModificationsContext, EuiColorModeContext, defaultComputedTheme } from './context';
+import { EuiThemeContext, EuiModificationsContext, EuiColorModeContext, defaultComputedTheme, EuiNestedThemeContext } from './context';
 import { emitEuiProviderWarning } from './warning';
 import { jsx as ___EmotionJSX } from "@emotion/react";
 var providerMessage = "`EuiProvider` is missing which can result in negative effects.\nWrap your component in `EuiProvider`: https://ela.st/euiprovider.";
@@ -63,4 +63,22 @@ export var RenderWithEuiTheme = function RenderWithEuiTheme(_ref) {
   var children = _ref.children;
   var theme = useEuiTheme();
   return children(theme);
+};
+
+/**
+ * Minor syntactical sugar hook for theme CSS variables.
+ * Primarily meant for internal EUI usage.
+ */
+export var useEuiThemeCSSVariables = function useEuiThemeCSSVariables() {
+  var _useContext = useContext(EuiNestedThemeContext),
+    setGlobalCSSVariables = _useContext.setGlobalCSSVariables,
+    globalCSSVariables = _useContext.globalCSSVariables,
+    setNearestThemeCSSVariables = _useContext.setNearestThemeCSSVariables,
+    themeCSSVariables = _useContext.themeCSSVariables;
+  return {
+    setGlobalCSSVariables: setGlobalCSSVariables,
+    globalCSSVariables: globalCSSVariables,
+    setNearestThemeCSSVariables: setNearestThemeCSSVariables,
+    themeCSSVariables: themeCSSVariables
+  };
 };

package/es/services/theme/index.js

@@ -7,7 +7,7 @@
  */
 
 export { EuiSystemContext, EuiThemeContext, EuiNestedThemeContext, EuiModificationsContext, EuiColorModeContext } from './context';
-export { useEuiTheme, withEuiTheme, RenderWithEuiTheme } from './hooks';
+export { useEuiTheme, withEuiTheme, RenderWithEuiTheme, useEuiThemeCSSVariables } from './hooks';
 export { EuiThemeProvider } from './provider';
 export { getEuiDevProviderWarning, setEuiDevProviderWarning } from './warning';
 export { buildTheme, computed, isInverseColorMode, getColorMode, getComputed, getOn, mergeDeep, setOn, Computed } from './utils';

package/es/services/theme/provider.js

@@ -1,4 +1,5 @@
 function _typeof(obj) { "@babel/helpers - typeof"; return _typeof = "function" == typeof Symbol && "symbol" == typeof Symbol.iterator ? function (obj) { return typeof obj; } : function (obj) { return obj && "function" == typeof Symbol && obj.constructor === Symbol && obj !== Symbol.prototype ? "symbol" : typeof obj; }, _typeof(obj); }
+import { css as _css } from "@emotion/react";
 var _excluded = ["cloneElement", "className"];
 function _extends() { _extends = Object.assign ? Object.assign.bind() : function (target) { for (var i = 1; i < arguments.length; i++) { var source = arguments[i]; for (var key in source) { if (Object.prototype.hasOwnProperty.call(source, key)) { target[key] = source[key]; } } } return target; }; return _extends.apply(this, arguments); }
 function _objectWithoutProperties(source, excluded) { if (source == null) return {}; var target = _objectWithoutPropertiesLoose(source, excluded); var key, i; if (Object.getOwnPropertySymbols) { var sourceSymbolKeys = Object.getOwnPropertySymbols(source); for (i = 0; i < sourceSymbolKeys.length; i++) { key = sourceSymbolKeys[i]; if (excluded.indexOf(key) >= 0) continue; if (!Object.prototype.propertyIsEnumerable.call(source, key)) continue; target[key] = source[key]; } } return target; }
@@ -22,10 +23,12 @@ function _arrayWithHoles(arr) { if (Array.isArray(arr)) return arr; }
  * Side Public License, v 1.
  */
 
-import React, { useContext, useEffect, useRef, useMemo, useState } from 'react';
+import React, { useContext, useEffect, useRef, useMemo, useState, useCallback } from 'react';
 import classNames from 'classnames';
 import { css } from '@emotion/css';
+import { Global } from '@emotion/react';
 import isEqual from 'lodash/isEqual';
+import { cloneElementWithCss } from '../emotion';
 import { EuiSystemContext, EuiThemeContext, EuiNestedThemeContext, EuiModificationsContext, EuiColorModeContext } from './context';
 import { EuiEmotionThemeProvider } from './emotion';
 import { buildTheme, getColorMode, getComputed, mergeDeep } from './utils';
@@ -38,7 +41,9 @@ export var EuiThemeProvider = function EuiThemeProvider(_ref) {
     wrapperProps = _ref.wrapperProps;
   var _useContext = useContext(EuiNestedThemeContext),
     isGlobalTheme = _useContext.isGlobalTheme,
-    bodyColor = _useContext.bodyColor;
+    bodyColor = _useContext.bodyColor,
+    globalCSSVariables = _useContext.globalCSSVariables,
+    setGlobalCSSVariables = _useContext.setGlobalCSSVariables;
   var parentSystem = useContext(EuiSystemContext);
   var parentModifications = useContext(EuiModificationsContext);
   var parentColorMode = useContext(EuiColorModeContext);
@@ -93,15 +98,28 @@ export var EuiThemeProvider = function EuiThemeProvider(_ref) {
       setTheme(getComputed(system, buildTheme(modifications, "_".concat(system.key)), colorMode));
     }
   }, [colorMode, system, modifications]);
+  var _useState9 = useState(),
+    _useState10 = _slicedToArray(_useState9, 2),
+    themeCSSVariables = _useState10[0],
+    _setThemeCSSVariables = _useState10[1];
+  var setThemeCSSVariables = useCallback(function (variables) {
+    return _setThemeCSSVariables(function (previous) {
+      return _objectSpread(_objectSpread({}, previous), variables);
+    });
+  }, []);
   var nestedThemeContext = useMemo(function () {
     return {
       isGlobalTheme: false,
       // The theme that determines the global body styles
       bodyColor: isGlobalTheme ? theme.colors.text : bodyColor,
       hasDifferentColorFromGlobalTheme: isGlobalTheme ? false : bodyColor !== theme.colors.text,
-      colorClassName: /*#__PURE__*/css("label:euiColorMode-", _colorMode, ";color:", theme.colors.text, ";;label:colorClassName;")
+      colorClassName: /*#__PURE__*/css("label:euiColorMode-", _colorMode, ";color:", theme.colors.text, ";;label:colorClassName;"),
+      setGlobalCSSVariables: isGlobalTheme ? setThemeCSSVariables : setGlobalCSSVariables,
+      globalCSSVariables: isGlobalTheme ? themeCSSVariables : globalCSSVariables,
+      setNearestThemeCSSVariables: setThemeCSSVariables,
+      themeCSSVariables: themeCSSVariables
     };
-  }, [theme, isGlobalTheme, bodyColor, _colorMode]);
+  }, [theme, isGlobalTheme, bodyColor, _colorMode, setGlobalCSSVariables, globalCSSVariables, setThemeCSSVariables, themeCSSVariables]);
   var renderedChildren = useMemo(function () {
     if (isGlobalTheme) {
       return children; // No wrapper
@@ -114,8 +132,15 @@ export var EuiThemeProvider = function EuiThemeProvider(_ref) {
     var props = _objectSpread(_objectSpread({}, rest), {}, {
       className: classNames(className, nestedThemeContext.colorClassName)
     });
+    // Condition avoids rendering an empty Emotion selector if no
+    // theme-specific CSS variables have been set by child components
+    if (themeCSSVariables) {
+      props.css = _objectSpread({
+        label: 'euiCSSVariables'
+      }, themeCSSVariables);
+    }
     if (cloneElement) {
-      return /*#__PURE__*/React.cloneElement(children, _objectSpread(_objectSpread({}, props), {}, {
+      return cloneElementWithCss(children, _objectSpread(_objectSpread({}, props), {}, {
         className: classNames(children.props.className, props.className)
       }));
     } else {
@@ -123,8 +148,12 @@ export var EuiThemeProvider = function EuiThemeProvider(_ref) {
         className: classNames('euiThemeProvider', props.className)
       }), children);
     }
-  }, [isGlobalTheme, nestedThemeContext, wrapperProps, children]);
-  return ___EmotionJSX(EuiColorModeContext.Provider, {
+  }, [isGlobalTheme, themeCSSVariables, nestedThemeContext, wrapperProps, children]);
+  return ___EmotionJSX(React.Fragment, null, isGlobalTheme && themeCSSVariables && ___EmotionJSX(Global, {
+    styles: /*#__PURE__*/_css({
+      ':root': themeCSSVariables
+    }, ";label:EuiThemeProvider;")
+  }), ___EmotionJSX(EuiColorModeContext.Provider, {
     value: colorMode
   }, ___EmotionJSX(EuiSystemContext.Provider, {
     value: system
@@ -134,5 +163,5 @@ export var EuiThemeProvider = function EuiThemeProvider(_ref) {
     value: theme
   }, ___EmotionJSX(EuiNestedThemeContext.Provider, {
     value: nestedThemeContext
-  }, ___EmotionJSX(EuiEmotionThemeProvider, null, renderedChildren))))));
+  }, ___EmotionJSX(EuiEmotionThemeProvider, null, renderedChildren)))))));
 };

package/es/themes/amsterdam/global_styling/variables/_typography.js

@@ -38,6 +38,7 @@ export var fontBase = {
   familySerif: 'Georgia, Times, Times New Roman, serif',
   // Careful using ligatures. Code editors like ACE will often error because of width calculations
   featureSettings: "'calt' 1, 'kern' 1, 'liga' 1",
+  defaultUnits: 'rem',
   baseline: computed(function (_ref) {
     var _ref2 = _slicedToArray(_ref, 1),
       base = _ref2[0];