@instructure/ui-color-picker 8.25.1-snapshot-20

package/CHANGELOG.md

@@ -0,0 +1,17 @@
+# Change Log
+
+All notable changes to this project will be documented in this file.
+See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
+
+## [8.25.1-snapshot-20](https://github.com/instructure/instructure-ui/compare/v8.25.0...v8.25.1-snapshot-20) (2022-06-30)
+
+
+### Features
+
+* **ui-code-editor:** Add ColorPicker component ([1cbd877](https://github.com/instructure/instructure-ui/commit/1cbd87783da67144ffbd1f6ed535ccd370fd4eeb))
+
+
+
+
+
+See the instructure-ui mono-repo [change log](#CHANGELOG) for past changes.

package/README.md

@@ -0,0 +1,46 @@
+---
+category: packages
+---
+
+## ui-color-picker
+
+[![npm][npm]][npm-url] 
+[![MIT License][license-badge]][license] 
+[![Code of Conduct][coc-badge]][coc]
+
+A robust component for picking, mixing, validating colors
+
+### Installation
+
+```sh
+yarn add @instructure/ui-color-picker
+```
+
+### Components
+
+#### ColorPicker
+
+The main component. It comes with an input field and can be customized to fit any input need
+
+#### ColorIndicator
+
+A component displaying a circle with checkerboard background capable of displaying colors
+
+#### ColorMixer
+
+Made for mixing colors setting `hue`, `saturation`, `luminance` and `alpha` or just typing in an `rgba` color
+
+#### ColorPreset
+
+Lets the user pick from a collection of preset colors. The list can be modified (added, removed) by the user if needed
+
+#### ColorContrast
+
+Calculates, visualizes and validates against WCAG 2.1 standards the contrast between two colors
+
+[npm]: https://img.shields.io/npm/v/@instructure/ui-color-picker.svg
+[npm-url]: https://npmjs.com/package/@instructure/ui-color-picker
+[license-badge]: https://img.shields.io/npm/l/instructure-ui.svg?style=flat-square
+[license]: https://github.com/instructure/instructure-ui/blob/master/LICENSE
+[coc-badge]: https://img.shields.io/badge/code%20of-conduct-ff69b4.svg?style=flat-square
+[coc]: https://github.com/instructure/instructure-ui/blob/master/CODE_OF_CONDUCT.md

package/es/ColorContrast/ColorContrastLocator.js

@@ -0,0 +1,54 @@
+/*
+ * The MIT License (MIT)
+ *
+ * Copyright (c) 2015 - present Instructure, Inc.
+ *
+ * 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.
+ */
+import { locator } from '@instructure/ui-test-locator';
+import { find } from '@instructure/ui-test-queries';
+/* eslint-disable no-restricted-imports */
+// @ts-expect-error bypass no type definition found error
+
+import { PillLocator } from '@instructure/ui-pill/es/Pill/PillLocator';
+/* eslint-enable no-restricted-imports */
+
+import { ColorContrast } from './index'; // @ts-expect-error ts-migrate(2339) FIXME: Property 'selector' does not exist on type 'typeof... Remove this comment to see the full error message
+
+export const ColorContrastLocator = locator(ColorContrast.selector, {
+  findPreview: function () {
+    for (var _len = arguments.length, args = new Array(_len), _key = 0; _key < _len; _key++) {
+      args[_key] = arguments[_key];
+    }
+
+    return find('[class$=-colorContrast__colorPreview]', ...args);
+  },
+  findNormalTextCheckPill: async () => {
+    const pills = await PillLocator.findAll();
+    return pills[0];
+  },
+  findLargeTextCheckPill: async () => {
+    const pills = await PillLocator.findAll();
+    return pills[1];
+  },
+  findGraphicsCheckPill: async () => {
+    const pills = await PillLocator.findAll();
+    return pills[2];
+  }
+});

package/es/ColorContrast/index.js

@@ -0,0 +1,174 @@
+import _objectWithoutProperties from "@babel/runtime/helpers/esm/objectWithoutProperties";
+const _excluded = ["styles", "elementRef", "failureLabel", "successLabel", "withoutColorPreview", "firstColor", "secondColor", "label", "firstColorLabel", "secondColorLabel", "normalTextLabel", "largeTextLabel", "graphicsTextLabel"];
+
+var _dec, _dec2, _class, _class2;
+
+/*
+ * The MIT License (MIT)
+ *
+ * Copyright (c) 2015 - present Instructure, Inc.
+ *
+ * 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.
+ */
+
+/** @jsx jsx */
+
+/** @jsxFrag React.Fragment */
+import React, { Component } from 'react';
+import { passthroughProps } from '@instructure/ui-react-utils';
+import { testable } from '@instructure/ui-testable';
+import { withStyle, jsx } from '@instructure/emotion';
+import { Text } from '@instructure/ui-text';
+import ColorIndicator from '../ColorIndicator';
+import { propTypes, allowedProps } from './props';
+import generateStyle from './styles';
+import generateComponentTheme from './theme';
+import { contrast as getContrast, colorToRGB, colorToHex8 } from '@instructure/ui-color-utils';
+import { Pill } from '@instructure/ui-pill';
+
+/**
+---
+category: components
+---
+@tsProps
+**/
+let ColorContrast = (_dec = withStyle(generateStyle, generateComponentTheme), _dec2 = testable(), _dec(_class = _dec2(_class = (_class2 = class ColorContrast extends Component {
+  constructor(props) {
+    super(props);
+    this.ref = null;
+
+    this.handleRef = el => {
+      const elementRef = this.props.elementRef;
+      this.ref = el;
+
+      if (typeof elementRef === 'function') {
+        elementRef(el);
+      }
+    };
+
+    this.renderStatus = (pass, description) => {
+      const _this$props = this.props,
+            successLabel = _this$props.successLabel,
+            failureLabel = _this$props.failureLabel,
+            styles = _this$props.styles;
+      return jsx("div", {
+        css: styles === null || styles === void 0 ? void 0 : styles.statusWrapper
+      }, jsx("div", {
+        css: pass ? styles === null || styles === void 0 ? void 0 : styles.successDescription : styles === null || styles === void 0 ? void 0 : styles.failureDescription
+      }, description), jsx("div", {
+        css: styles === null || styles === void 0 ? void 0 : styles.statusIndicatorWrapper
+      }, jsx(Pill, {
+        color: pass ? 'success' : 'danger'
+      }, pass ? successLabel : failureLabel)));
+    };
+
+    this.renderColorIndicator = (color, label) => {
+      var _this$props$styles, _this$props$styles2, _this$props$styles3;
+
+      return jsx(React.Fragment, null, jsx("div", null, jsx("div", {
+        css: (_this$props$styles = this.props.styles) === null || _this$props$styles === void 0 ? void 0 : _this$props$styles.colorIndicator
+      }, jsx(ColorIndicator, {
+        color: color
+      }))), jsx("div", null, jsx("div", {
+        css: (_this$props$styles2 = this.props.styles) === null || _this$props$styles2 === void 0 ? void 0 : _this$props$styles2.colorIndicatorLabel
+      }, label), jsx("div", {
+        css: (_this$props$styles3 = this.props.styles) === null || _this$props$styles3 === void 0 ? void 0 : _this$props$styles3.pickedColorHex
+      }, color)));
+    };
+
+    this.calcBlendedColor = (c1, c2) => {
+      const alpha = 1 - (1 - c1.a) * (1 - c2.a);
+      return {
+        r: c2.r * c2.a / alpha + c1.r * c1.a * (1 - c2.a) / alpha,
+        g: c2.g * c2.a / alpha + c1.g * c1.a * (1 - c2.a) / alpha,
+        b: c2.b * c2.a / alpha + c1.b * c1.a * (1 - c2.a) / alpha,
+        a: 1
+      };
+    };
+  }
+
+  componentDidMount() {
+    var _this$props$makeStyle, _this$props2;
+
+    (_this$props$makeStyle = (_this$props2 = this.props).makeStyles) === null || _this$props$makeStyle === void 0 ? void 0 : _this$props$makeStyle.call(_this$props2);
+  }
+
+  componentDidUpdate() {
+    var _this$props$makeStyle2, _this$props3;
+
+    (_this$props$makeStyle2 = (_this$props3 = this.props).makeStyles) === null || _this$props$makeStyle2 === void 0 ? void 0 : _this$props$makeStyle2.call(_this$props3);
+  }
+
+  //We project the firstColor onto an opaque white background, then we project the secondColor onto
+  //the projected first color. We calculate the contrast of these two, projected colors.
+  get calcContrast() {
+    const c1RGBA = colorToRGB(this.props.firstColor);
+    const c2RGBA = colorToRGB(this.props.secondColor);
+    const c1OnWhite = this.calcBlendedColor({
+      r: 255,
+      g: 255,
+      b: 255,
+      a: 1
+    }, c1RGBA);
+    const c2OnC1OnWhite = this.calcBlendedColor(c1OnWhite, c2RGBA);
+    return getContrast(colorToHex8(c1OnWhite), colorToHex8(c2OnC1OnWhite), 2);
+  }
+
+  render() {
+    var _this$props$styles4, _this$props$styles5, _this$props$styles6, _this$props$styles7;
+
+    const _this$props4 = this.props,
+          styles = _this$props4.styles,
+          elementRef = _this$props4.elementRef,
+          failureLabel = _this$props4.failureLabel,
+          successLabel = _this$props4.successLabel,
+          withoutColorPreview = _this$props4.withoutColorPreview,
+          firstColor = _this$props4.firstColor,
+          secondColor = _this$props4.secondColor,
+          label = _this$props4.label,
+          firstColorLabel = _this$props4.firstColorLabel,
+          secondColorLabel = _this$props4.secondColorLabel,
+          normalTextLabel = _this$props4.normalTextLabel,
+          largeTextLabel = _this$props4.largeTextLabel,
+          graphicsTextLabel = _this$props4.graphicsTextLabel,
+          props = _objectWithoutProperties(_this$props4, _excluded);
+
+    const contrast = this.calcContrast;
+    return jsx("div", Object.assign({}, passthroughProps(props), {
+      ref: this.handleRef,
+      css: styles === null || styles === void 0 ? void 0 : styles.colorContrast
+    }), jsx("div", {
+      css: (_this$props$styles4 = this.props.styles) === null || _this$props$styles4 === void 0 ? void 0 : _this$props$styles4.label
+    }, jsx(Text, {
+      weight: "bold",
+      as: "div"
+    }, label)), jsx(Text, {
+      size: "x-large"
+    }, contrast, ":1"), !withoutColorPreview && jsx("div", {
+      css: (_this$props$styles5 = this.props.styles) === null || _this$props$styles5 === void 0 ? void 0 : _this$props$styles5.colorPreview
+    }, jsx("div", {
+      css: (_this$props$styles6 = this.props.styles) === null || _this$props$styles6 === void 0 ? void 0 : _this$props$styles6.firstColorPreview
+    }, this.renderColorIndicator(firstColor, firstColorLabel || '')), jsx("div", {
+      css: (_this$props$styles7 = this.props.styles) === null || _this$props$styles7 === void 0 ? void 0 : _this$props$styles7.secondColorPreview
+    }, this.renderColorIndicator(secondColor, secondColorLabel || ''))), this.renderStatus(contrast >= 4.5, normalTextLabel), this.renderStatus(contrast >= 3, largeTextLabel), this.renderStatus(contrast >= 3, graphicsTextLabel));
+  }
+
+}, _class2.displayName = "ColorContrast", _class2.propTypes = propTypes, _class2.allowedProps = allowedProps, _class2.componentId = 'ColorContrast', _class2)) || _class) || _class);
+export { ColorContrast };
+export default ColorContrast;

package/es/ColorContrast/props.js

@@ -0,0 +1,40 @@
+/*
+ * The MIT License (MIT)
+ *
+ * Copyright (c) 2015 - present Instructure, Inc.
+ *
+ * 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.
+ */
+import PropTypes from 'prop-types';
+const propTypes = {
+  elementRef: PropTypes.func,
+  failureLabel: PropTypes.string.isRequired,
+  firstColor: PropTypes.string.isRequired,
+  firstColorLabel: PropTypes.string,
+  graphicsTextLabel: PropTypes.string.isRequired,
+  withoutColorPreview: PropTypes.bool,
+  label: PropTypes.string.isRequired,
+  largeTextLabel: PropTypes.string.isRequired,
+  normalTextLabel: PropTypes.string.isRequired,
+  secondColor: PropTypes.string.isRequired,
+  secondColorLabel: PropTypes.string,
+  successLabel: PropTypes.string.isRequired
+};
+const allowedProps = ['elementRef', 'failureLabel', 'firstColor', 'firstColorLabel', 'graphicsTextLabel', 'withoutColorPreview', 'label', 'largeTextLabel', 'normalTextLabel', 'secondColor', 'secondColorLabel', 'successLabel'];
+export { propTypes, allowedProps };

package/es/ColorContrast/styles.js

@@ -0,0 +1,99 @@
+/*
+ * The MIT License (MIT)
+ *
+ * Copyright (c) 2015 - present Instructure, Inc.
+ *
+ * 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.
+ */
+
+/**
+ * ---
+ * private: true
+ * ---
+ * Generates the style object from the theme and provided additional information
+ * @param  {Object} componentTheme The theme variable object.
+ * @param  {Object} props the props of the component, the style is applied to
+ * @param  {Object} state the state of the component, the style is applied to
+ * @return {Object} The final style object, which will be used in the component
+ */
+const generateStyle = componentTheme => {
+  const statusDescriptionStyle = pass => ({
+    label: pass ? 'colorContrast__successDescription' : 'colorContrast__failureDescription',
+    flex: 1,
+    color: pass ? componentTheme.successColor : componentTheme.failureColor
+  });
+
+  return {
+    colorContrast: {
+      label: 'colorContrast',
+      width: componentTheme.width,
+      fontFamily: componentTheme.fontFamily,
+      fontWeight: componentTheme.fontWeight,
+      lineHeight: componentTheme.lineHeight,
+      fontSize: componentTheme.fontSize
+    },
+    statusWrapper: {
+      label: 'colorContrast__statusWrapper',
+      width: '100%',
+      display: 'flex',
+      marginBottom: componentTheme.statusWrapperBottomMargin
+    },
+    successDescription: statusDescriptionStyle(true),
+    failureDescription: statusDescriptionStyle(false),
+    colorIndicator: {
+      marginInlineEnd: componentTheme.colorIndicatorRightMargin
+    },
+    statusIndicatorWrapper: {
+      label: 'colorContrast__statusIndicatorWrapper',
+      flex: 1,
+      display: 'flex',
+      flexDirection: 'row-reverse'
+    },
+    colorIndicatorLabel: {
+      label: 'colorContrast__colorIndicatorLabel',
+      wordBreak: 'break-all'
+    },
+    pickedColorHex: {
+      label: 'colorContrast__pickedColorHex',
+      color: componentTheme.pickedHexColor
+    },
+    colorPreview: {
+      label: 'colorContrast__colorPreview',
+      display: 'flex',
+      width: '100%',
+      marginBottom: componentTheme.colorPreviewBottomMargin,
+      marginTop: componentTheme.colorPreviewTopMargin
+    },
+    firstColorPreview: {
+      label: 'colorContrast__firstColorPreview',
+      display: 'flex',
+      flex: 1
+    },
+    secondColorPreview: {
+      label: 'colorContrast__secondColorPreview',
+      display: 'flex'
+    },
+    label: {
+      label: 'colorContrast__label',
+      marginBottom: componentTheme.labelBottomMargin
+    }
+  };
+};
+
+export default generateStyle;

package/es/ColorContrast/theme.js

@@ -0,0 +1,55 @@
+/*
+ * The MIT License (MIT)
+ *
+ * Copyright (c) 2015 - present Instructure, Inc.
+ *
+ * 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.
+ */
+
+/**
+ * Generates the theme object for the component from the theme and provided additional information
+ * @param  {Object} theme The actual theme object.
+ * @return {Object} The final theme object with the overrides and component variables
+ */
+const generateComponentTheme = theme => {
+  const colors = theme.colors,
+        typography = theme.typography,
+        spacing = theme.spacing,
+        borders = theme.borders;
+  const componentVariables = {
+    width: '17rem',
+    fontFamily: typography === null || typography === void 0 ? void 0 : typography.fontFamily,
+    fontWeight: typography === null || typography === void 0 ? void 0 : typography.fontWeightNormal,
+    lineHeight: typography === null || typography === void 0 ? void 0 : typography.lineHeight,
+    fontSize: typography === null || typography === void 0 ? void 0 : typography.fontSizeMedium,
+    statusWrapperBottomMargin: spacing === null || spacing === void 0 ? void 0 : spacing.xxSmall,
+    colorIndicatorRightMargin: spacing === null || spacing === void 0 ? void 0 : spacing.small,
+    colorPreviewBottomMargin: spacing === null || spacing === void 0 ? void 0 : spacing.small,
+    colorPreviewTopMargin: spacing === null || spacing === void 0 ? void 0 : spacing.xSmall,
+    labelBottomMargin: spacing === null || spacing === void 0 ? void 0 : spacing.xxSmall,
+    smallBorder: borders.widthSmall,
+    successColor: colors.shamrock,
+    failureColor: colors.crimson,
+    pickedHexColor: colors.ash
+  };
+  return { ...componentVariables
+  };
+};
+
+export default generateComponentTheme;

package/es/ColorIndicator/ColorIndicatorLocator.js

@@ -0,0 +1,40 @@
+/*
+ * The MIT License (MIT)
+ *
+ * Copyright (c) 2015 - present Instructure, Inc.
+ *
+ * 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.
+ */
+import { locator } from '@instructure/ui-test-locator';
+import { ColorIndicator } from './index';
+import { colorToRGB } from '@instructure/ui-color-utils'; // @ts-expect-error ts-migrate(2339) FIXME: Property 'selector' does not exist on type 'typeof... Remove this comment to see the full error message
+
+export const ColorIndicatorLocator = locator(ColorIndicator.selector, {
+  getColorRGBA: element => {
+    const _getComputedStyle = getComputedStyle(element),
+          boxShadow = _getComputedStyle.boxShadow;
+
+    if (boxShadow === 'none') {
+      return boxShadow;
+    }
+
+    const shadowColor = /rgba?\(\d+,\s\d+,\s\d+(,\s.+)?\)/.exec(boxShadow)[0];
+    return colorToRGB(shadowColor);
+  }
+});

package/es/ColorIndicator/index.js

@@ -0,0 +1,91 @@
+import _objectWithoutProperties from "@babel/runtime/helpers/esm/objectWithoutProperties";
+const _excluded = ["color", "elementRef"];
+
+var _dec, _dec2, _class, _class2;
+
+/*
+ * The MIT License (MIT)
+ *
+ * Copyright (c) 2015 - present Instructure, Inc.
+ *
+ * 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.
+ */
+
+/** @jsx jsx */
+import { Component } from 'react';
+import { testable } from '@instructure/ui-testable';
+import { passthroughProps } from '@instructure/ui-react-utils';
+import { withStyle, jsx } from '@instructure/emotion';
+import generateStyle from './styles';
+import generateComponentTheme from './theme';
+import { propTypes, allowedProps } from './props';
+/**
+---
+category: components
+---
+@tsProps
+**/
+
+let ColorIndicator = (_dec = withStyle(generateStyle, generateComponentTheme), _dec2 = testable(), _dec(_class = _dec2(_class = (_class2 = class ColorIndicator extends Component {
+  constructor() {
+    super(...arguments);
+    this.ref = null;
+
+    this.handleRef = el => {
+      const elementRef = this.props.elementRef;
+      this.ref = el;
+
+      if (typeof elementRef === 'function') {
+        elementRef(el);
+      }
+    };
+  }
+
+  componentDidMount() {
+    var _this$props$makeStyle, _this$props;
+
+    (_this$props$makeStyle = (_this$props = this.props).makeStyles) === null || _this$props$makeStyle === void 0 ? void 0 : _this$props$makeStyle.call(_this$props);
+  }
+
+  componentDidUpdate() {
+    var _this$props$makeStyle2, _this$props2;
+
+    (_this$props$makeStyle2 = (_this$props2 = this.props).makeStyles) === null || _this$props$makeStyle2 === void 0 ? void 0 : _this$props$makeStyle2.call(_this$props2);
+  }
+
+  render() {
+    var _this$props$styles;
+
+    const _this$props3 = this.props,
+          color = _this$props3.color,
+          elementRef = _this$props3.elementRef,
+          props = _objectWithoutProperties(_this$props3, _excluded);
+
+    return jsx("div", Object.assign({}, passthroughProps(props), {
+      ref: this.handleRef,
+      css: (_this$props$styles = this.props.styles) === null || _this$props$styles === void 0 ? void 0 : _this$props$styles.colorIndicator
+    }));
+  }
+
+}, _class2.displayName = "ColorIndicator", _class2.propTypes = propTypes, _class2.allowedProps = allowedProps, _class2.componentId = 'ColorIndicator', _class2.defaultProps = {
+  color: '',
+  shape: 'circle'
+}, _class2)) || _class) || _class);
+export default ColorIndicator;
+export { ColorIndicator };

package/es/ColorIndicator/props.js

@@ -0,0 +1,31 @@
+/*
+ * The MIT License (MIT)
+ *
+ * Copyright (c) 2015 - present Instructure, Inc.
+ *
+ * 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.
+ */
+import PropTypes from 'prop-types';
+const propTypes = {
+  color: PropTypes.string,
+  elementRef: PropTypes.func,
+  shape: PropTypes.oneOf(['circle', 'rectangle'])
+};
+const allowedProps = ['color', 'elementRef', 'shape'];
+export { propTypes, allowedProps };