@elastic/eui 94.0.0 → 94.1.0

package/test-env/components/basic_table/collapsed_item_actions.js

@@ -8,7 +8,6 @@ Object.defineProperty(exports, "__esModule", {
 exports.CollapsedItemActions = void 0;
 var _slicedToArray2 = _interopRequireDefault(require("@babel/runtime/helpers/slicedToArray"));
 var _react = _interopRequireWildcard(require("react"));
-var _predicate = require("../../services/predicate");
 var _context_menu = require("../context_menu");
 var _popover = require("../popover");
 var _button = require("../button");
@@ -36,9 +35,8 @@ var CollapsedItemActions = function CollapsedItemActions(_ref) {
     _useState2 = (0, _slicedToArray2.default)(_useState, 2),
     popoverOpen = _useState2[0],
     setPopoverOpen = _useState2[1];
-  var onClickItem = (0, _react.useCallback)(function (onClickAction) {
-    setPopoverOpen(false);
-    onClickAction === null || onClickAction === void 0 ? void 0 : onClickAction();
+  var closePopover = (0, _react.useCallback)(function () {
+    return setPopoverOpen(false);
   }, []);
   var controls = (0, _react.useMemo)(function () {
     return actions.reduce(function (controls, action, index) {
@@ -57,16 +55,10 @@ var CollapsedItemActions = function CollapsedItemActions(_ref) {
           key: index,
           className: "euiBasicTable__collapsedCustomAction"
         }, (0, _react2.jsx)("span", {
-          onClick: function onClick() {
-            return onClickItem();
-          }
+          onClick: closePopover
         }, actionControl)));
       } else {
-        var buttonIcon = action.icon;
-        var icon;
-        if (buttonIcon) {
-          icon = (0, _predicate.isString)(buttonIcon) ? buttonIcon : buttonIcon(item);
-        }
+        var icon = action.icon ? (0, _action_types.callWithItemIfFunction)(item)(action.icon) : undefined;
         var buttonContent = (0, _action_types.callWithItemIfFunction)(item)(action.name);
         var toolTipContent = (0, _action_types.callWithItemIfFunction)(item)(action.description);
         var href = (0, _action_types.callWithItemIfFunction)(item)(action.href);
@@ -81,10 +73,11 @@ var CollapsedItemActions = function CollapsedItemActions(_ref) {
           target: target,
           icon: icon,
           "data-test-subj": dataTestSubj,
-          onClick: function onClick() {
-            return onClickItem(_onClick ? function () {
-              return _onClick(item);
-            } : undefined);
+          onClick: function onClick(event) {
+            event.persist();
+            _onClick === null || _onClick === void 0 ? void 0 : _onClick(item, event);
+            // Allow consumer events to prevent the popover from closing if necessary
+            if (!event.isPropagationStopped()) closePopover();
           },
           toolTipContent: toolTipContent,
           toolTipProps: {
@@ -94,7 +87,7 @@ var CollapsedItemActions = function CollapsedItemActions(_ref) {
       }
       return controls;
     }, []);
-  }, [actions, actionsDisabled, item, onClickItem]);
+  }, [actions, actionsDisabled, item, closePopover]);
   var popoverButton = (0, _react2.jsx)(_i18n.EuiI18n, {
     tokens: ['euiCollapsedItemActions.allActions', 'euiCollapsedItemActions.allActionsDisabled'],
     defaults: ['All actions', 'Individual item actions are disabled when rows are being selected.']
@@ -131,9 +124,7 @@ var CollapsedItemActions = function CollapsedItemActions(_ref) {
     id: "".concat(itemId, "-actions"),
     isOpen: popoverOpen,
     button: withTooltip || popoverButton,
-    closePopover: function closePopover() {
-      return setPopoverOpen(false);
-    },
+    closePopover: closePopover,
     panelPaddingSize: "none",
     anchorPosition: "leftCenter"
   }, (0, _react2.jsx)(_context_menu.EuiContextMenuPanel, {

package/test-env/components/basic_table/default_item_action.js

@@ -1,18 +1,19 @@
 "use strict";
 
-var _interopRequireDefault = require("@babel/runtime/helpers/interopRequireDefault");
+var _typeof = require("@babel/runtime/helpers/typeof");
 Object.defineProperty(exports, "__esModule", {
   value: true
 });
 exports.DefaultItemAction = void 0;
-var _react = _interopRequireDefault(require("react"));
-var _predicate = require("../../services/predicate");
+var _react = _interopRequireWildcard(require("react"));
 var _button = require("../button");
 var _tool_tip = require("../tool_tip");
 var _accessibility = require("../../services/accessibility");
 var _accessibility2 = require("../accessibility");
 var _action_types = require("./action_types");
 var _react2 = require("@emotion/react");
+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); }
+function _interopRequireWildcard(obj, nodeInterop) { if (!nodeInterop && obj && obj.__esModule) { return obj; } if (obj === null || _typeof(obj) !== "object" && typeof obj !== "function") { return { default: obj }; } var cache = _getRequireWildcardCache(nodeInterop); if (cache && cache.has(obj)) { return cache.get(obj); } var newObj = {}; var hasPropertyDescriptor = Object.defineProperty && Object.getOwnPropertyDescriptor; for (var key in obj) { if (key !== "default" && Object.prototype.hasOwnProperty.call(obj, key)) { var desc = hasPropertyDescriptor ? Object.getOwnPropertyDescriptor(obj, key) : null; if (desc && (desc.get || desc.set)) { Object.defineProperty(newObj, key, desc); } else { newObj[key] = obj[key]; } } } newObj.default = obj; if (cache) { cache.set(obj, newObj); } return newObj; }
 /*
  * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one
  * or more contributor license agreements. Licensed under the Elastic License
@@ -29,26 +30,20 @@ var DefaultItemAction = function DefaultItemAction(_ref) {
   if (!action.onClick && !action.href) {
     throw new Error("Cannot render item action [".concat(action.name, "]. Missing required 'onClick' callback\n      or 'href' string. If you want to provide a custom action control, make sure to define the 'render' callback"));
   }
-  var onClick = action.onClick ? function () {
-    return action.onClick(item);
-  } : undefined;
-  var buttonColor = action.color;
-  var color = 'primary';
-  if (buttonColor) {
-    color = (0, _predicate.isString)(buttonColor) ? buttonColor : buttonColor(item);
-  }
-  var buttonIcon = action.icon;
-  var icon;
-  if (buttonIcon) {
-    icon = (0, _predicate.isString)(buttonIcon) ? buttonIcon : buttonIcon(item);
-  }
-  var button;
+  var onClick = (0, _react.useCallback)(function (event) {
+    if (!action.onClick) return;
+    event.persist(); // TODO: Remove once React 16 support is dropped
+    action.onClick(item, event);
+  }, [action.onClick, item]);
+  var color = action.color ? (0, _action_types.callWithItemIfFunction)(item)(action.color) : 'primary';
+  var icon = action.icon ? (0, _action_types.callWithItemIfFunction)(item)(action.icon) : undefined;
   var actionContent = (0, _action_types.callWithItemIfFunction)(item)(action.name);
   var tooltipContent = (0, _action_types.callWithItemIfFunction)(item)(action.description);
   var href = (0, _action_types.callWithItemIfFunction)(item)(action.href);
   var dataTestSubj = (0, _action_types.callWithItemIfFunction)(item)(action['data-test-subj']);
   var ariaLabelId = (0, _accessibility.useGeneratedHtmlId)();
   var ariaLabelledBy;
+  var button;
   if (action.type === 'icon') {
     if (!icon) {
       throw new Error("Cannot render item action [".concat(action.name, "]. It is configured to render as an icon but no\n      icon is provided. Make sure to set the 'icon' property of the action"));

package/test-env/components/basic_table/in_memory_table.js

@@ -679,10 +679,14 @@ EuiInMemoryTable.propTypes = {
          */
       description: _propTypes.default.oneOfType([_propTypes.default.string.isRequired, _propTypes.default.func.isRequired]).isRequired,
       /**
-         * A handler function to execute the action
+         * A handler function to execute the action. Passes back the current row
+         * item as the first argument, and the originating React click event
+         * as a second argument.
          */
       /**
-         * A handler function to execute the action
+         * A handler function to execute the action. Passes back the current row
+         * item as the first argument, and the originating React click event
+         * as a second argument.
          */
       onClick: _propTypes.default.func,
       href: _propTypes.default.oneOfType([_propTypes.default.string.isRequired, _propTypes.default.func.isRequired]),

package/test-env/components/table/table_cells_shared.styles.js

@@ -7,6 +7,7 @@ Object.defineProperty(exports, "__esModule", {
 exports.euiTableHeaderFooterCellStyles = exports.euiTableCellCheckboxStyles = void 0;
 var _defineProperty2 = _interopRequireDefault(require("@babel/runtime/helpers/defineProperty"));
 var _react = require("@emotion/react");
+var _services = require("../../services");
 var _global_styling = require("../../global_styling");
 var _table = require("./table.styles");
 function ownKeys(object, enumerableOnly) { var keys = Object.keys(object); if (Object.getOwnPropertySymbols) { var symbols = Object.getOwnPropertySymbols(object); enumerableOnly && (symbols = symbols.filter(function (sym) { return Object.getOwnPropertyDescriptor(object, sym).enumerable; })), keys.push.apply(keys, symbols); } return keys; }
@@ -18,7 +19,8 @@ function _objectSpread(target) { for (var i = 1; i < arguments.length; i++) { va
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           * Side Public License, v 1.
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           */
 var euiTableHeaderFooterCellStyles = function euiTableHeaderFooterCellStyles(euiThemeContext) {
-  var euiTheme = euiThemeContext.euiTheme;
+  var euiTheme = euiThemeContext.euiTheme,
+    colorMode = euiThemeContext.colorMode;
 
   // euiFontSize returns an object, so we keep object notation here to merge into css``
   var sharedStyles = _objectSpread(_objectSpread({}, (0, _global_styling.euiFontSize)(euiThemeContext, 'xs')), {}, {
@@ -29,7 +31,10 @@ var euiTableHeaderFooterCellStyles = function euiTableHeaderFooterCellStyles(eui
   return {
     euiTableHeaderCell: /*#__PURE__*/(0, _react.css)(sharedStyles, ";;label:euiTableHeaderCell;"),
     euiTableHeaderCell__content: /*#__PURE__*/(0, _react.css)("gap:", euiTheme.size.xs, ";;label:euiTableHeaderCell__content;"),
-    euiTableHeaderCell__button: /*#__PURE__*/(0, _react.css)((0, _global_styling.logicalCSS)('width', '100%'), " font-weight:inherit;&:hover,&:focus{color:", euiTheme.colors.primaryText, ";text-decoration:underline;};label:euiTableHeaderCell__button;"),
+    euiTableHeaderCell__button: /*#__PURE__*/(0, _react.css)((0, _global_styling.logicalCSS)('width', '100%'), " font-weight:inherit;line-height:inherit;.euiTableSortIcon--sortable{color:", (0, _services.makeHighContrastColor)(
+    // Tint it arbitrarily high, the contrast util will take care of lowering back down to WCAG
+    (0, _services.tintOrShade)(euiTheme.colors.subduedText, 0.9, colorMode), 3 // 3:1 ratio from https://www.w3.org/WAI/WCAG22/Understanding/non-text-contrast.html
+    )(euiTheme.colors.emptyShade), ";}&:hover,&:focus{color:", euiTheme.colors.primaryText, ";text-decoration:underline;.euiTableSortIcon--sortable{color:", euiTheme.colors.primaryText, ";}};label:euiTableHeaderCell__button;"),
     euiTableFooterCell: /*#__PURE__*/(0, _react.css)(sharedStyles, " background-color:", euiTheme.colors.lightestShade, ";;label:euiTableFooterCell;")
   };
 };

package/test-env/components/table/table_header_cell.js

@@ -33,9 +33,9 @@ var CellContents = function CellContents(_ref) {
     align = _ref.align,
     description = _ref.description,
     children = _ref.children,
+    canSort = _ref.canSort,
     isSorted = _ref.isSorted,
-    isSortAscending = _ref.isSortAscending,
-    showSortMsg = _ref.showSortMsg;
+    isSortAscending = _ref.isSortAscending;
   return (0, _react2.jsx)(_table_cell_content.EuiTableCellContent, {
     className: className,
     align: align,
@@ -56,11 +56,16 @@ var CellContents = function CellContents(_ref) {
         className: "eui-textTruncate"
       }, children);
     });
-  }), description && (0, _react2.jsx)(_accessibility.EuiScreenReaderOnly, null, (0, _react2.jsx)("span", null, description)), showSortMsg && isSorted && (0, _react2.jsx)(_icon.EuiIcon, {
+  }), description && (0, _react2.jsx)(_accessibility.EuiScreenReaderOnly, null, (0, _react2.jsx)("span", null, description)), isSorted ? (0, _react2.jsx)(_icon.EuiIcon, {
     className: "euiTableSortIcon",
     type: isSortAscending ? 'sortUp' : 'sortDown',
     size: "m"
-  }));
+  }) : canSort ? (0, _react2.jsx)(_icon.EuiIcon, {
+    className: "euiTableSortIcon euiTableSortIcon--sortable",
+    type: "sortable",
+    size: "m",
+    color: "subdued" // Tinted a bit further via CSS
+  }) : null);
 };
 var EuiTableHeaderCell = function EuiTableHeaderCell(_ref2) {
   var children = _ref2.children,
@@ -87,45 +92,38 @@ var EuiTableHeaderCell = function EuiTableHeaderCell(_ref2) {
   var CellComponent = children ? 'th' : 'td';
   var cellScope = CellComponent === 'th' ? scope !== null && scope !== void 0 ? scope : 'col' : undefined; // `scope` is only valid on `th` elements
 
-  var cellContents = (0, _react2.jsx)(CellContents, {
+  var canSort = !!(onSort && !readOnly);
+  var ariaSortValue;
+  if (isSorted) {
+    ariaSortValue = isSortAscending ? 'ascending' : 'descending';
+  } else if (canSort) {
+    ariaSortValue = 'none';
+  }
+  var cellContentsProps = {
     css: styles.euiTableHeaderCell__content,
     align: align,
     description: description,
-    showSortMsg: true,
+    canSort: canSort,
     isSorted: isSorted,
-    isSortAscending: isSortAscending
-  }, children);
-  if (onSort || isSorted) {
-    var buttonClasses = (0, _classnames.default)('euiTableHeaderButton', {
-      'euiTableHeaderButton-isSorted': isSorted
-    });
-    var ariaSortValue = 'none';
-    if (isSorted) {
-      ariaSortValue = isSortAscending ? 'ascending' : 'descending';
-    }
-    return (0, _react2.jsx)(CellComponent, (0, _extends2.default)({
-      css: styles.euiTableHeaderCell,
-      className: classes,
-      scope: cellScope,
-      role: "columnheader",
-      "aria-sort": ariaSortValue,
-      "aria-live": "polite",
-      style: inlineStyles
-    }, rest), onSort && !readOnly ? (0, _react2.jsx)("button", {
-      type: "button",
-      css: styles.euiTableHeaderCell__button,
-      className: buttonClasses,
-      onClick: onSort,
-      "data-test-subj": "tableHeaderSortButton"
-    }, cellContents) : cellContents);
-  }
+    isSortAscending: isSortAscending,
+    children: children
+  };
   return (0, _react2.jsx)(CellComponent, (0, _extends2.default)({
     css: styles.euiTableHeaderCell,
     className: classes,
     scope: cellScope,
     role: "columnheader",
+    "aria-sort": ariaSortValue,
     style: inlineStyles
-  }, rest), cellContents);
+  }, rest), canSort ? (0, _react2.jsx)("button", {
+    type: "button",
+    css: styles.euiTableHeaderCell__button,
+    className: (0, _classnames.default)('euiTableHeaderButton', {
+      'euiTableHeaderButton-isSorted': isSorted
+    }),
+    onClick: onSort,
+    "data-test-subj": "tableHeaderSortButton"
+  }, (0, _react2.jsx)(CellContents, cellContentsProps)) : (0, _react2.jsx)(CellContents, cellContentsProps));
 };
 exports.EuiTableHeaderCell = EuiTableHeaderCell;
 EuiTableHeaderCell.propTypes = {

package/src/components/date_picker/react-datepicker/LICENSE

@@ -1,21 +0,0 @@
-The MIT License (MIT)
-
-Copyright (c) 2018 HackerOne Inc and individual contributors
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.

package/src/components/date_picker/react-datepicker/README.md

@@ -1,168 +0,0 @@
-_Forked by @elastic/eui from Hacker0x01/react-datepicker for accessibility and consolidation of services._
-
-Decision to not use a more traditional "vendor" directory approach includes redundant services, unnecessary dependencies, and a separate build pipeline. Most notably, `react-datepicker` included third-party popover and focus trap service and components that do not align with EUI interaction standards and were replaced, at parity, with EUI components.
-
-Other modifications:
-
-* Changed to `.js` naming to conform to EUI build processes
-* Removed files related to repository management and publishing
-* Adjusted `babel.rc` and `package.json` naming to avoid babel configuration conflicts
-
-___
-# React Date Picker
-
-[![npm version](https://badge.fury.io/js/react-datepicker.svg)](https://badge.fury.io/js/react-datepicker)
-[![Build Status](https://travis-ci.org/Hacker0x01/react-datepicker.svg?branch=master)](https://travis-ci.org/Hacker0x01/react-datepicker)
-[![Dependency Status](https://david-dm.org/Hacker0x01/react-datepicker.svg)](https://david-dm.org/Hacker0x01/react-datepicker)
-[![codecov](https://codecov.io/gh/Hacker0x01/react-datepicker/branch/master/graph/badge.svg)](https://codecov.io/gh/Hacker0x01/react-datepicker)
-[![Downloads](http://img.shields.io/npm/dm/react-datepicker.svg)](https://npmjs.org/package/react-datepicker)
-[![Code Quality: Javascript](https://img.shields.io/lgtm/grade/javascript/g/Hacker0x01/react-datepicker.svg?logo=lgtm&logoWidth=18)](https://lgtm.com/projects/g/Hacker0x01/react-datepicker/context:javascript)
-[![Total Alerts](https://img.shields.io/lgtm/alerts/g/Hacker0x01/react-datepicker.svg?logo=lgtm&logoWidth=18)](https://lgtm.com/projects/g/Hacker0x01/react-datepicker/alerts)
-
-A simple and reusable Datepicker component for React ([Demo](https://reactdatepicker.com/))
-
-![](https://cloud.githubusercontent.com/assets/1412392/5339491/c40de124-7ee1-11e4-9f07-9276e2545f27.png)
-
-## Installation
-
-The package can be installed via NPM:
-
-```
-npm install react-datepicker --save
-```
-
-You’ll need to install React, PropTypes, and Moment.js separately since those dependencies aren’t included in the package. Below is a simple example of how to use the Datepicker in a React view. You will also need to require the CSS file from this package (or provide your own). The example below shows how to include the CSS from this package if your build system supports requiring CSS files (Webpack is one that does).
-
-```js
-import React from "react";
-import DatePicker from "react-datepicker";
-import moment from "moment";
-
-import "react-datepicker/dist/react-datepicker.css";
-
-// CSS Modules, react-datepicker-cssmodules.css
-// import 'react-datepicker/dist/react-datepicker-cssmodules.css';
-
-class Example extends React.Component {
-  constructor(props) {
-    super(props);
-    this.state = {
-      startDate: moment()
-    };
-    this.handleChange = this.handleChange.bind(this);
-  }
-
-  handleChange(date) {
-    this.setState({
-      startDate: date
-    });
-  }
-
-  render() {
-    return (
-      <DatePicker
-        selected={this.state.startDate}
-        onChange={this.handleChange}
-      />
-    );
-  }
-}
-```
-
-## Configuration
-
-The most basic use of the DatePicker can be described with:
-
-```js
-<DatePicker selected={this.state.date} onChange={this.handleChange} />
-```
-
-You can use `onSelect` event handler which fires each time some calendar date has been selected
-
-```js
-<DatePicker
-  selected={this.state.date}
-  onSelect={this.handleSelect} //when day is clicked
-  onChange={this.handleChange} //only when value has changed
-/>
-```
-
-`onClickOutside` handler may be useful to close datepicker in `inline` mode
-
-See [here](https://github.com/Hacker0x01/react-datepicker/blob/master/docs/datepicker.md) for a full list of props that may be passed to the component. Examples are given on the [main website](https://hacker0x01.github.io/react-datepicker).
-
-### Time picker
-
-You can also include a time picker by adding the showTimeSelect prop
-
-```js
-<DatePicker
-  selected={this.state.date}
-  onChange={this.handleChange}
-  showTimeSelect
-  dateFormat="LLL"
-/>
-```
-
-Times will be displayed at 30-minute intervals by default (default configurable via timeInterval prop)
-
-More examples of how to use the time picker are given on the [main website](https://hacker0x01.github.io/react-datepicker)
-
-### Localization
-
-The date picker relies on [moment.js internationalization](http://momentjs.com/docs/#/i18n/) to localize its display components. By default, the date picker will use the locale globally set in moment, which is English. Locales can be changed in the following ways:
-
-* **Globally** by calling `moment.locale(lang)`
-* **Picker-specific** by providing the `locale` prop
-
-Locales can be further configured in moment with various [customization options](http://momentjs.com/docs/#/customization/).
-
-_As of version 0.23, the `weekdays` and `weekStart` DatePicker props have been removed. Instead, they can be configured with the `weekdaysMin` and `week.dow` moment locale customization options._
-
-## Compatibility
-
-### React
-
-We're always trying to stay compatible with the latest version of React. We can't support all older versions of React.
-
-Latest compatible versions:
-
-* React 15.5 or newer: All above React-datepicker v.0.40.0
-* React 15.4.1: needs React-datepicker v0.40.0, newer won't work (due to react-onclickoutside dependencies)
-* React 0.14 or newer: All above React-datepicker v0.13.0
-* React 0.13: React-datepicker v0.13.0
-* pre React 0.13: React-datepicker v0.6.2
-
-### Browser Support
-
-The date picker is compatible with the latest versions of Chrome, Firefox, and IE10+.
-
-Unfortunately, it is difficult to support legacy browsers while maintaining our ability to develop new features in the future. For IE9 support, it is known that the [classlist polyfill](https://www.npmjs.com/package/classlist-polyfill) is needed, but this may change or break at any point in the future.
-
-## Local Development
-
-The `master` branch contains the latest version of the Datepicker component. To start your example app, you can run `yarn start`. This starts a simple webserver on http://localhost:8080.
-
-You can run `yarn test` to execute the test suite and linters. To help you develop the component we’ve set up some tests that cover the basic functionality (can be found in `/tests`). Even though we’re big fans of testing, this only covers a small piece of the component. We highly recommend you add tests when you’re adding new functionality.
-
-### The examples
-
-The examples are hosted within the docs folder and are ran in the simple app that loads the Datepicker. To extend the examples with a new example, you can simply duplicate one of the existing examples and change the unique properties of your example.
-
-## Accessibility
-
-### Keyboard support
-
-* _Left_: Move to the previous day.
-* _Right_: Move to the next day.
-* _Up_: Move to the previous week.
-* _Down_: Move to the next week.
-* _PgUp_: Move to the previous month.
-* _PgDn_: Move to the next month.
-* _Home_: Move to the previous year.
-* _End_: Move to the next year.
-* _Enter/Esc/Tab_: close the calendar. (Enter & Esc calls preventDefault)
-
-## License
-
-Copyright (c) 2018 HackerOne Inc. and individual contributors. Licensed under MIT license, see [LICENSE](LICENSE) for the full license.

package/src/services/theme/README.md

@@ -1,153 +0,0 @@
-# JavaScript-based theming in EUI
-
-The style system to replace Sass and Sass-based design tokens in EUI.
-
-* Theme construction via a Proxy-based system with cascading and computed values
-  * Proxy-based: allows for the theme system to reference its own values (for reuse or for computational manipulation)
-  * Cascading: conceptually similar to Sass, where variable location and order are important
-  * Extendable: allows for appending style variables to the EUI theme structure, scoped to a React context provider
-  * Override-able: all theme tokens/variables can be altered by consumers
-* Theme consumption via React hook and HOC methods
-* Color mode support as first-class consideration
-  * "Light" and "dark" mode accounting
-  * Theme consumption is scoped to the current color mode (set in the context provider)
-* Style adaptaion based on a smal set of base values
-  * Text colors are calculated with WCAG Level AA (4.5:1) in mind
-  * Scalable typographic and spacing rhythms 
-
-
-## Layers of the theme system
-
-### Unbuilt theme
-
-_See [`euiThemeDefault`](../../themes/eui/theme.ts)_
-An unbuilt theme is a composed object of style values or `computed` functions.
-
-#### Style values
-
-Think design tokens or CSS property values. Ready to be consumed as-is in an application environment, using some JavaScript method of applying styles (i.e., a CSS-in-JS library is not required).
-
-#### `computed` functions
-
-These properties specify that the value depends upon some other value in the theme, in the shape of:
-
-```js
-computed(
-  ([size]) => size * 2 // predicate. What to do with the dependency values,
-  ['sizes.euiSize'], // dependency array, referencing other properties in the theme object
-)
-```
-
-The dependency array is optional. Omitting the array gives access to the computed theme.
-
-```js
-computed(
-  (theme) => theme.sizes.euiSize * 2
-)
-```
-
-### Theme system (built theme)
-
-_See [`EuiThemeDefault`](../../themes/eui/theme.ts)_
-A built theme by way of `buildTheme`, which transforms the object containing static style values and `computed` functions into a JavaScript Proxy object with handler traps. In this state, the theme is essentially inaccessible and immutable, that is, it requires `getComputed` to correctly order and access values and dependencies, and `set()` is disabled.
-
-### Computed theme
-
-_See [`EuiThemeContext`](../../themes/eui/context.ts)_
-A consumable theme object in which all `computed` function values have been computed; all values are accessible and usable in an application environment.
-Returned from `getComputed`, in the shape of:
-
-```js
-getComputed(
-  EuiThemeDefault, // Theme system (Proxy)
-  {}, // Modifications object
-  'light' // Color mode
-)
-```
-
-#### Modifications
-
-Because the theme system (built theme) is immutable, modifications can only be made at compute time by providing overrides and extensions for theme property values. These modifications are passed to the `EuiThemeProvider` via the `modify` prop and should match the high-level object shape of the theme. 
-
-#### Color mode
-
-Think light and dark mode. A theme has built-in color mode support, using the reserved `LIGHT` and `DARK` keys as a marker:
-
-```js
-colors: {
-  LIGHT: {...}
-  DARK : {...}
-}
-```
-The reserved color mode keys can be used at any level and location in a theme.
-`getComputed` will only compute and return values in the specified current color mode.
-
-
-## React-specific context
-
-### EuiThemeProvider
-
-_See [`EuiThemeProvider`](../../themes/eui/provider.ts)_
-Umbrella provider component that holds the various top-level theme configuration option providers: theme system, color mode, modifications; as well as the primary output provider: computed theme.
-The actual computation for computed theme values takes place at this level, where the three inputs are known (theme system, color mode, modifications) and the output (computed theme) can be cached for consumption. Input changes are captured and the output is recomputed.
-
-```js
-<EuiThemeProvider
-  theme={DefaultEuiTheme}
-  colorMode="light"
-  modify={{}}
-  />
-```
-
-All three props are optional. The default values for EUI will be used in the event that no configuration is provided. Note, however that colorMode switching will require consumers to maintain that app state.
-
-### useEuiTheme
-
-_See [`useEuiTheme`](../../themes/eui/hooks.tsx)_
-A custom React hook that returns the computed theme. This hook is little more than a wrapper around the `useContext` hook, accessing three of the top-level providers: computed theme, color mode, and modifications.
-
-```js
-const { euiTheme, colorMode, modifications } = useEuiTheme();
-```
-
-The `euiTheme` variable has TypeScript support, which will result in IDE autocomplete availability.
-
-### WithEuiTheme
-A higher-order-component that wraps `useEuiTheme` for React class components.
-
-
-___
-
-
-## Emotion
-
-[Emotion](https://emotion.sh/docs/introduction) is the CSS-in-JS library currently selected for use in EUI. Nothing in the EUI theming system is dependent upon Emotion packages, but the Emotion ecosystem will have impacts on generated styles.
-
-### Composition
-
-* Prefer the use of [`css` prop](https://emotion.sh/docs/css-prop) construction over [styled-component-like](https://emotion.sh/docs/styled) component construction
-* Babel-based build accommodation
-
-### Testing
-
-Snapshot testing ([as currently configured](https://emotion.sh/docs/testing#writing-a-test)) will result in generic `emotion-${n}` class names with the generated style object as part of the snapshot.
-
-* This seems good for EUI, but it also affects consumers
-  * Consumers will need to use the `@emotion/jest` snapshot serializer to avoid class name churn.
-  * Not ideal; unsure of any other solutions
-* During the conversion process, the snapshot diffs will look less than ideal when using `shallow` (a single wrapper element; DOM itself is unchanged):
-
-```diff
--  <div
--    className="euiTableRowCell__mobileHeader euiTableRowCell--hideForDesktop"
-+  <EmotionCssPropInternal
-+    __EMOTION_LABEL_PLEASE_DO_NOT_USE__="EuiTableRowCell"
-+    __EMOTION_TYPE_PLEASE_DO_NOT_USE__="td"
-+    className="euiTableRowCell"
-+    style={
-+      Object {
-+        "width": undefined,
-+    }
-+      }
-    >
-```