@elastic/eui 88.0.0 → 88.2.0

package/lib/components/text_truncate/utils.js

@@ -0,0 +1,352 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.TruncationUtilsWithDOM = exports.TruncationUtilsWithCanvas = void 0;
+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.
+ */
+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.
+ */
+exports.TruncationUtilsWithDOM = TruncationUtilsWithDOM;
+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
+ */
+exports.TruncationUtilsWithCanvas = TruncationUtilsWithCanvas;
+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/lib/global_styling/functions/typography.js

@@ -28,16 +28,16 @@ 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");
 }
 
 /**
@@ -56,8 +56,8 @@ 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;
@@ -65,13 +65,13 @@ 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/lib/global_styling/variables/typography.js

@@ -3,7 +3,7 @@
 Object.defineProperty(exports, "__esModule", {
   value: true
 });
-exports.EuiThemeFontWeights = exports.EuiThemeFontSizeMeasurements = exports.EuiThemeFontScales = void 0;
+exports.EuiThemeFontWeights = exports.EuiThemeFontUnits = exports.EuiThemeFontScales = void 0;
 /*
  * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one
  * or more contributor license agreements. Licensed under the Elastic License
@@ -16,8 +16,8 @@ exports.EuiThemeFontWeights = exports.EuiThemeFontSizeMeasurements = exports.Eui
  * Font units of measure
  */
 
-var EuiThemeFontSizeMeasurements = ['rem', 'px', 'em'];
-exports.EuiThemeFontSizeMeasurements = EuiThemeFontSizeMeasurements;
+var EuiThemeFontUnits = ['rem', 'px', 'em'];
+exports.EuiThemeFontUnits = EuiThemeFontUnits;
 /*
  * Font scale
  */

package/lib/services/theme/context.js

@@ -29,6 +29,8 @@ var EuiNestedThemeContext = /*#__PURE__*/(0, _react.createContext)({
   isGlobalTheme: true,
   hasDifferentColorFromGlobalTheme: false,
   bodyColor: '',
-  colorClassName: ''
+  colorClassName: '',
+  setGlobalCSSVariables: function setGlobalCSSVariables() {},
+  setNearestThemeCSSVariables: function setNearestThemeCSSVariables() {}
 });
 exports.EuiNestedThemeContext = EuiNestedThemeContext;

package/lib/services/theme/hooks.js

@@ -4,7 +4,7 @@ function _typeof(obj) { "@babel/helpers - typeof"; return _typeof = "function" =
 Object.defineProperty(exports, "__esModule", {
   value: true
 });
-exports.withEuiTheme = exports.useEuiTheme = exports.RenderWithEuiTheme = void 0;
+exports.withEuiTheme = exports.useEuiThemeCSSVariables = exports.useEuiTheme = exports.RenderWithEuiTheme = void 0;
 var _react = _interopRequireWildcard(require("react"));
 var _context = require("./context");
 var _warning = require("./warning");
@@ -72,4 +72,23 @@ var RenderWithEuiTheme = function RenderWithEuiTheme(_ref) {
   var theme = useEuiTheme();
   return children(theme);
 };
-exports.RenderWithEuiTheme = RenderWithEuiTheme;
+
+/**
+ * Minor syntactical sugar hook for theme CSS variables.
+ * Primarily meant for internal EUI usage.
+ */
+exports.RenderWithEuiTheme = RenderWithEuiTheme;
+var useEuiThemeCSSVariables = function useEuiThemeCSSVariables() {
+  var _useContext = (0, _react.useContext)(_context.EuiNestedThemeContext),
+    setGlobalCSSVariables = _useContext.setGlobalCSSVariables,
+    globalCSSVariables = _useContext.globalCSSVariables,
+    setNearestThemeCSSVariables = _useContext.setNearestThemeCSSVariables,
+    themeCSSVariables = _useContext.themeCSSVariables;
+  return {
+    setGlobalCSSVariables: setGlobalCSSVariables,
+    globalCSSVariables: globalCSSVariables,
+    setNearestThemeCSSVariables: setNearestThemeCSSVariables,
+    themeCSSVariables: themeCSSVariables
+  };
+};
+exports.useEuiThemeCSSVariables = useEuiThemeCSSVariables;

package/lib/services/theme/index.js

@@ -123,6 +123,12 @@ Object.defineProperty(exports, "useEuiTheme", {
     return _hooks.useEuiTheme;
   }
 });
+Object.defineProperty(exports, "useEuiThemeCSSVariables", {
+  enumerable: true,
+  get: function get() {
+    return _hooks.useEuiThemeCSSVariables;
+  }
+});
 Object.defineProperty(exports, "withEuiTheme", {
   enumerable: true,
   get: function get() {

package/lib/services/theme/provider.js

@@ -5,14 +5,15 @@ Object.defineProperty(exports, "__esModule", {
   value: true
 });
 exports.EuiThemeProvider = void 0;
-var _react = _interopRequireWildcard(require("react"));
+var _react = require("@emotion/react");
+var _react2 = _interopRequireWildcard(require("react"));
 var _classnames = _interopRequireDefault(require("classnames"));
-var _css = require("@emotion/css");
+var _css2 = require("@emotion/css");
 var _isEqual = _interopRequireDefault(require("lodash/isEqual"));
+var _emotion = require("../emotion");
 var _context = require("./context");
-var _emotion = require("./emotion");
+var _emotion2 = require("./emotion");
 var _utils = require("./utils");
-var _react2 = require("@emotion/react");
 var _excluded = ["cloneElement", "className"];
 function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
 function _getRequireWildcardCache(nodeInterop) { if (typeof WeakMap !== "function") return null; var cacheBabelInterop = new WeakMap(); var cacheNodeInterop = new WeakMap(); return (_getRequireWildcardCache = function _getRequireWildcardCache(nodeInterop) { return nodeInterop ? cacheNodeInterop : cacheBabelInterop; })(nodeInterop); }
@@ -43,35 +44,37 @@ var EuiThemeProvider = function EuiThemeProvider(_ref) {
     _modifications = _ref.modify,
     children = _ref.children,
     wrapperProps = _ref.wrapperProps;
-  var _useContext = (0, _react.useContext)(_context.EuiNestedThemeContext),
+  var _useContext = (0, _react2.useContext)(_context.EuiNestedThemeContext),
     isGlobalTheme = _useContext.isGlobalTheme,
-    bodyColor = _useContext.bodyColor;
-  var parentSystem = (0, _react.useContext)(_context.EuiSystemContext);
-  var parentModifications = (0, _react.useContext)(_context.EuiModificationsContext);
-  var parentColorMode = (0, _react.useContext)(_context.EuiColorModeContext);
-  var parentTheme = (0, _react.useContext)(_context.EuiThemeContext);
-  var _useState = (0, _react.useState)(_system || parentSystem),
+    bodyColor = _useContext.bodyColor,
+    globalCSSVariables = _useContext.globalCSSVariables,
+    setGlobalCSSVariables = _useContext.setGlobalCSSVariables;
+  var parentSystem = (0, _react2.useContext)(_context.EuiSystemContext);
+  var parentModifications = (0, _react2.useContext)(_context.EuiModificationsContext);
+  var parentColorMode = (0, _react2.useContext)(_context.EuiColorModeContext);
+  var parentTheme = (0, _react2.useContext)(_context.EuiThemeContext);
+  var _useState = (0, _react2.useState)(_system || parentSystem),
     _useState2 = _slicedToArray(_useState, 2),
     system = _useState2[0],
     setSystem = _useState2[1];
-  var prevSystemKey = (0, _react.useRef)(system.key);
-  var _useState3 = (0, _react.useState)((0, _utils.mergeDeep)(parentModifications, _modifications)),
+  var prevSystemKey = (0, _react2.useRef)(system.key);
+  var _useState3 = (0, _react2.useState)((0, _utils.mergeDeep)(parentModifications, _modifications)),
     _useState4 = _slicedToArray(_useState3, 2),
     modifications = _useState4[0],
     setModifications = _useState4[1];
-  var prevModifications = (0, _react.useRef)(modifications);
-  var _useState5 = (0, _react.useState)((0, _utils.getColorMode)(_colorMode, parentColorMode)),
+  var prevModifications = (0, _react2.useRef)(modifications);
+  var _useState5 = (0, _react2.useState)((0, _utils.getColorMode)(_colorMode, parentColorMode)),
     _useState6 = _slicedToArray(_useState5, 2),
     colorMode = _useState6[0],
     setColorMode = _useState6[1];
-  var prevColorMode = (0, _react.useRef)(colorMode);
-  var isParentTheme = (0, _react.useRef)(prevSystemKey.current === parentSystem.key && colorMode === parentColorMode && (0, _isEqual.default)(parentModifications, modifications));
-  var _useState7 = (0, _react.useState)(isParentTheme.current && Object.keys(parentTheme).length ? _objectSpread({}, parentTheme) // Intentionally create a new object to break referential equality
+  var prevColorMode = (0, _react2.useRef)(colorMode);
+  var isParentTheme = (0, _react2.useRef)(prevSystemKey.current === parentSystem.key && colorMode === parentColorMode && (0, _isEqual.default)(parentModifications, modifications));
+  var _useState7 = (0, _react2.useState)(isParentTheme.current && Object.keys(parentTheme).length ? _objectSpread({}, parentTheme) // Intentionally create a new object to break referential equality
     : (0, _utils.getComputed)(system, (0, _utils.buildTheme)(modifications, "_".concat(system.key)), colorMode)),
     _useState8 = _slicedToArray(_useState7, 2),
     theme = _useState8[0],
     setTheme = _useState8[1];
-  (0, _react.useEffect)(function () {
+  (0, _react2.useEffect)(function () {
     var newSystem = _system || parentSystem;
     if (prevSystemKey.current !== newSystem.key) {
       setSystem(newSystem);
@@ -79,7 +82,7 @@ var EuiThemeProvider = function EuiThemeProvider(_ref) {
       isParentTheme.current = false;
     }
   }, [_system, parentSystem]);
-  (0, _react.useEffect)(function () {
+  (0, _react2.useEffect)(function () {
     var newModifications = (0, _utils.mergeDeep)(parentModifications, _modifications);
     if (!(0, _isEqual.default)(prevModifications.current, newModifications)) {
       setModifications(newModifications);
@@ -87,7 +90,7 @@ var EuiThemeProvider = function EuiThemeProvider(_ref) {
       isParentTheme.current = false;
     }
   }, [_modifications, parentModifications]);
-  (0, _react.useEffect)(function () {
+  (0, _react2.useEffect)(function () {
     var newColorMode = (0, _utils.getColorMode)(_colorMode, parentColorMode);
     if (!(0, _isEqual.default)(newColorMode, prevColorMode.current)) {
       setColorMode(newColorMode);
@@ -95,21 +98,34 @@ var EuiThemeProvider = function EuiThemeProvider(_ref) {
       isParentTheme.current = false;
     }
   }, [_colorMode, parentColorMode]);
-  (0, _react.useEffect)(function () {
+  (0, _react2.useEffect)(function () {
     if (!isParentTheme.current) {
       setTheme((0, _utils.getComputed)(system, (0, _utils.buildTheme)(modifications, "_".concat(system.key)), colorMode));
     }
   }, [colorMode, system, modifications]);
-  var nestedThemeContext = (0, _react.useMemo)(function () {
+  var _useState9 = (0, _react2.useState)(),
+    _useState10 = _slicedToArray(_useState9, 2),
+    themeCSSVariables = _useState10[0],
+    _setThemeCSSVariables = _useState10[1];
+  var setThemeCSSVariables = (0, _react2.useCallback)(function (variables) {
+    return _setThemeCSSVariables(function (previous) {
+      return _objectSpread(_objectSpread({}, previous), variables);
+    });
+  }, []);
+  var nestedThemeContext = (0, _react2.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__*/(0, _css.css)("label:euiColorMode-", _colorMode, ";color:", theme.colors.text, ";;label:colorClassName;")
+      colorClassName: /*#__PURE__*/(0, _css2.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]);
-  var renderedChildren = (0, _react.useMemo)(function () {
+  }, [theme, isGlobalTheme, bodyColor, _colorMode, setGlobalCSSVariables, globalCSSVariables, setThemeCSSVariables, themeCSSVariables]);
+  var renderedChildren = (0, _react2.useMemo)(function () {
     if (isGlobalTheme) {
       return children; // No wrapper
     }
@@ -121,26 +137,37 @@ var EuiThemeProvider = function EuiThemeProvider(_ref) {
     var props = _objectSpread(_objectSpread({}, rest), {}, {
       className: (0, _classnames.default)(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.default.cloneElement(children, _objectSpread(_objectSpread({}, props), {}, {
+      return (0, _emotion.cloneElementWithCss)(children, _objectSpread(_objectSpread({}, props), {}, {
         className: (0, _classnames.default)(children.props.className, props.className)
       }));
     } else {
-      return (0, _react2.jsx)("span", _extends({}, props, {
+      return (0, _react.jsx)("span", _extends({}, props, {
         className: (0, _classnames.default)('euiThemeProvider', props.className)
       }), children);
     }
-  }, [isGlobalTheme, nestedThemeContext, wrapperProps, children]);
-  return (0, _react2.jsx)(_context.EuiColorModeContext.Provider, {
+  }, [isGlobalTheme, themeCSSVariables, nestedThemeContext, wrapperProps, children]);
+  return (0, _react.jsx)(_react2.default.Fragment, null, isGlobalTheme && themeCSSVariables && (0, _react.jsx)(_react.Global, {
+    styles: /*#__PURE__*/(0, _react.css)({
+      ':root': themeCSSVariables
+    }, ";label:EuiThemeProvider;")
+  }), (0, _react.jsx)(_context.EuiColorModeContext.Provider, {
     value: colorMode
-  }, (0, _react2.jsx)(_context.EuiSystemContext.Provider, {
+  }, (0, _react.jsx)(_context.EuiSystemContext.Provider, {
     value: system
-  }, (0, _react2.jsx)(_context.EuiModificationsContext.Provider, {
+  }, (0, _react.jsx)(_context.EuiModificationsContext.Provider, {
     value: modifications
-  }, (0, _react2.jsx)(_context.EuiThemeContext.Provider, {
+  }, (0, _react.jsx)(_context.EuiThemeContext.Provider, {
     value: theme
-  }, (0, _react2.jsx)(_context.EuiNestedThemeContext.Provider, {
+  }, (0, _react.jsx)(_context.EuiNestedThemeContext.Provider, {
     value: nestedThemeContext
-  }, (0, _react2.jsx)(_emotion.EuiEmotionThemeProvider, null, renderedChildren))))));
+  }, (0, _react.jsx)(_emotion2.EuiEmotionThemeProvider, null, renderedChildren)))))));
 };
 exports.EuiThemeProvider = EuiThemeProvider;