@algolia/satellite 1.0.0-beta.126 → 1.0.0-beta.129

package/cjs/Dropzone/Dropzone.js

@@ -0,0 +1,180 @@
+"use strict";
+
+var _interopRequireDefault = require("@babel/runtime/helpers/interopRequireDefault");
+
+var _typeof = require("@babel/runtime/helpers/typeof");
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports["default"] = exports.Dropzone = void 0;
+
+var _defineProperty2 = _interopRequireDefault(require("@babel/runtime/helpers/defineProperty"));
+
+var _toConsumableArray2 = _interopRequireDefault(require("@babel/runtime/helpers/toConsumableArray"));
+
+var _slicedToArray2 = _interopRequireDefault(require("@babel/runtime/helpers/slicedToArray"));
+
+var _objectWithoutProperties2 = _interopRequireDefault(require("@babel/runtime/helpers/objectWithoutProperties"));
+
+var _taggedTemplateLiteral2 = _interopRequireDefault(require("@babel/runtime/helpers/taggedTemplateLiteral"));
+
+var _classnames = _interopRequireDefault(require("classnames"));
+
+var _react = _interopRequireWildcard(require("react"));
+
+var _reactDropzone = require("react-dropzone");
+
+var _reactFeather = require("react-feather");
+
+var _Button = require("../Button");
+
+var _Field = require("../Field");
+
+var _satellitePrefixer = _interopRequireDefault(require("../styles/helpers/satellitePrefixer"));
+
+var _formatters = require("../utils/formatters");
+
+var _uniqueId = require("../utils/uniqueId");
+
+var _excluded = ["id", "placeholder", "disabled", "multiple", "clearable", "onChange", "className"];
+
+var _templateObject, _templateObject2, _templateObject3, _templateObject4, _templateObject5, _templateObject6, _templateObject7, _templateObject8, _templateObject9, _templateObject10, _templateObject11;
+
+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; }
+
+function ownKeys(object, enumerableOnly) { var keys = Object.keys(object); if (Object.getOwnPropertySymbols) { var symbols = Object.getOwnPropertySymbols(object); if (enumerableOnly) { symbols = symbols.filter(function (sym) { return Object.getOwnPropertyDescriptor(object, sym).enumerable; }); } keys.push.apply(keys, symbols); } return keys; }
+
+function _objectSpread(target) { for (var i = 1; i < arguments.length; i++) { var source = arguments[i] != null ? arguments[i] : {}; if (i % 2) { ownKeys(Object(source), true).forEach(function (key) { (0, _defineProperty2["default"])(target, key, source[key]); }); } else if (Object.getOwnPropertyDescriptors) { Object.defineProperties(target, Object.getOwnPropertyDescriptors(source)); } else { ownKeys(Object(source)).forEach(function (key) { Object.defineProperty(target, key, Object.getOwnPropertyDescriptor(source, key)); }); } } return target; }
+
+var DropzoneFileItem = function DropzoneFileItem(_ref) {
+  var file = _ref.file;
+  return /*#__PURE__*/_react["default"].createElement("span", {
+    className: (0, _satellitePrefixer["default"])(_templateObject || (_templateObject = (0, _taggedTemplateLiteral2["default"])(["truncate text-grey-900"])))
+  }, file.name, " - ", (0, _formatters.formatHumanSize)(file.size));
+};
+
+var STATUS_CLASSNAMES = {
+  "default": "",
+  invalid: (0, _satellitePrefixer["default"])(_templateObject2 || (_templateObject2 = (0, _taggedTemplateLiteral2["default"])(["input-invalid"]))),
+  validated: ""
+};
+
+var InvalidIcon = function InvalidIcon() {
+  return /*#__PURE__*/_react["default"].createElement(_reactFeather.X, {
+    className: (0, _satellitePrefixer["default"])(_templateObject3 || (_templateObject3 = (0, _taggedTemplateLiteral2["default"])(["mr-4 h-4 w-4 text-white bg-red-700 p-px rounded-full"])))
+  });
+};
+
+var ValidatedIcon = function ValidatedIcon() {
+  return /*#__PURE__*/_react["default"].createElement(_reactFeather.Check, {
+    className: (0, _satellitePrefixer["default"])(_templateObject4 || (_templateObject4 = (0, _taggedTemplateLiteral2["default"])(["mr-4 h-4 w-4 text-white bg-accent-700 p-px rounded-full"])))
+  });
+};
+
+var Dropzone = function Dropzone(_ref2) {
+  var id = _ref2.id,
+      placeholder = _ref2.placeholder,
+      disabled = _ref2.disabled,
+      _ref2$multiple = _ref2.multiple,
+      multiple = _ref2$multiple === void 0 ? false : _ref2$multiple,
+      _ref2$clearable = _ref2.clearable,
+      clearable = _ref2$clearable === void 0 ? false : _ref2$clearable,
+      onChange = _ref2.onChange,
+      className = _ref2.className,
+      props = (0, _objectWithoutProperties2["default"])(_ref2, _excluded);
+
+  var _useState = (0, _react.useState)([]),
+      _useState2 = (0, _slicedToArray2["default"])(_useState, 2),
+      files = _useState2[0],
+      setFiles = _useState2[1];
+
+  var _useState3 = (0, _react.useState)(false),
+      _useState4 = (0, _slicedToArray2["default"])(_useState3, 2),
+      focused = _useState4[0],
+      setFocused = _useState4[1];
+
+  var _useFieldState = (0, _Field.useFieldState)(),
+      status = _useFieldState.status;
+
+  var onDrop = (0, _react.useCallback)(function (acceptedFiles, fileRejections) {
+    var updatedFiles = multiple ? [].concat((0, _toConsumableArray2["default"])(files), (0, _toConsumableArray2["default"])(acceptedFiles)) : acceptedFiles;
+    setFiles(updatedFiles);
+    onChange === null || onChange === void 0 ? void 0 : onChange(updatedFiles, fileRejections);
+  }, [multiple, files, onChange]);
+
+  var handleClear = function handleClear(evt) {
+    evt.stopPropagation();
+    setFiles([]);
+    onChange === null || onChange === void 0 ? void 0 : onChange([], []);
+  };
+
+  var _useDropzone = (0, _reactDropzone.useDropzone)(_objectSpread(_objectSpread({
+    disabled: disabled,
+    multiple: multiple
+  }, props), {}, {
+    onDrop: onDrop
+  })),
+      getRootProps = _useDropzone.getRootProps,
+      getInputProps = _useDropzone.getInputProps,
+      isDragActive = _useDropzone.isDragActive,
+      isDragReject = _useDropzone.isDragReject;
+
+  var dropzoneId = (0, _react.useMemo)(function () {
+    return id !== null && id !== void 0 ? id : (0, _uniqueId.uniqueId)("dropzone");
+  }, [id]);
+  var isValueEmpty = files.length === 0;
+  var StatusIcon = status === "invalid" ? InvalidIcon : status === "validated" ? ValidatedIcon : _react["default"].Fragment;
+  return /*#__PURE__*/_react["default"].createElement("div", getRootProps({
+    "aria-controls": dropzoneId,
+    className: (0, _classnames["default"])((0, _satellitePrefixer["default"])(_templateObject5 || (_templateObject5 = (0, _taggedTemplateLiteral2["default"])(["\n            input group\n            ", "\n            ", "\n            min-h-16 cursor-pointer\n            ", ""])), focused && "input-focused", disabled && "input-disabled cursor-not-allowed", isDragReject ? "border-red-200 cursor-not-allowed" : isDragActive ? "border-nebula-500" : null), STATUS_CLASSNAMES[status], className),
+    onClick: function onClick(evt) {
+      // Helps with https://github.com/react-dropzone/react-dropzone/issues/182
+      if (evt.target.closest("label")) {
+        evt.stopPropagation();
+      }
+    }
+  }), /*#__PURE__*/_react["default"].createElement("input", getInputProps({
+    id: dropzoneId,
+    onFocus: function onFocus() {
+      return setFocused(true);
+    },
+    onBlur: function onBlur() {
+      return setFocused(false);
+    }
+  })), /*#__PURE__*/_react["default"].createElement("div", {
+    className: (0, _satellitePrefixer["default"])(_templateObject6 || (_templateObject6 = (0, _taggedTemplateLiteral2["default"])(["flex-1 flex items-center justify-center space-x-2 display-body"])))
+  }, files.length > 0 ? files.length > 1 ? /*#__PURE__*/_react["default"].createElement("ul", null, files.map(function (file) {
+    return /*#__PURE__*/_react["default"].createElement("li", {
+      key: file.name
+    }, /*#__PURE__*/_react["default"].createElement(DropzoneFileItem, {
+      file: file
+    }));
+  })) : /*#__PURE__*/_react["default"].createElement(DropzoneFileItem, {
+    file: files[0]
+  }) : /*#__PURE__*/_react["default"].createElement("div", {
+    className: (0, _satellitePrefixer["default"])(_templateObject7 || (_templateObject7 = (0, _taggedTemplateLiteral2["default"])(["flex items-center justify-center space-x-2 display-body"])))
+  }, /*#__PURE__*/_react["default"].createElement(_reactFeather.UploadCloud, {
+    size: "1rem",
+    className: (0, _satellitePrefixer["default"])(_templateObject8 || (_templateObject8 = (0, _taggedTemplateLiteral2["default"])(["", ""])), disabled ? "text-grey-200" : "text-grey-500")
+  }), /*#__PURE__*/_react["default"].createElement("p", {
+    className: (0, _satellitePrefixer["default"])(_templateObject9 || (_templateObject9 = (0, _taggedTemplateLiteral2["default"])(["", ""])), disabled ? "text-grey-300" : "typo-subdued")
+  }, placeholder !== null && placeholder !== void 0 ? placeholder : "Drop ".concat(multiple ? "files" : "file", " here or click to select.")))), clearable && !disabled && !isValueEmpty && /*#__PURE__*/_react["default"].createElement("span", {
+    className: (0, _satellitePrefixer["default"])(_templateObject10 || (_templateObject10 = (0, _taggedTemplateLiteral2["default"])([""])))
+  }, /*#__PURE__*/_react["default"].createElement(_Button.IconButton, {
+    className: (0, _satellitePrefixer["default"])(_templateObject11 || (_templateObject11 = (0, _taggedTemplateLiteral2["default"])(["mr-2 ", ""])), focused ? "visible" : "invisible group-hover:visible"),
+    title: "Clear input",
+    icon: _reactFeather.X,
+    variant: "subtle",
+    size: "small",
+    tabIndex: -1,
+    "aria-hidden": true,
+    onClick: handleClear
+  })), /*#__PURE__*/_react["default"].createElement(StatusIcon, null));
+};
+
+exports.Dropzone = Dropzone;
+var _default = Dropzone;
+exports["default"] = _default;

package/cjs/Dropzone/index.d.ts

@@ -0,0 +1,2 @@
+export * from "./Dropzone";
+export { default } from "./Dropzone";

package/cjs/Dropzone/index.js

@@ -0,0 +1,32 @@
+"use strict";
+
+var _typeof = require("@babel/runtime/helpers/typeof");
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+var _exportNames = {};
+Object.defineProperty(exports, "default", {
+  enumerable: true,
+  get: function get() {
+    return _Dropzone["default"];
+  }
+});
+
+var _Dropzone = _interopRequireWildcard(require("./Dropzone"));
+
+Object.keys(_Dropzone).forEach(function (key) {
+  if (key === "default" || key === "__esModule") return;
+  if (Object.prototype.hasOwnProperty.call(_exportNames, key)) return;
+  if (key in exports && exports[key] === _Dropzone[key]) return;
+  Object.defineProperty(exports, key, {
+    enumerable: true,
+    get: function get() {
+      return _Dropzone[key];
+    }
+  });
+});
+
+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; }

package/cjs/EmptyState/types.d.ts

@@ -3,7 +3,7 @@ import { FlexGridDirection } from "../FlexGrid";
 export declare type EmptyStateUsageContexts = "result" | "feature" | "page";
 export declare type EmptyStateWidths = "medium" | "large" | "xlarge";
 export interface EmptyStatePropsAll {
-    /** Descriptive title for the state (either a string or a React component) */
+    /** Descriptive title for the state */
     title: React.ReactNode;
     /** Optional description to explain why the screen is empty or define next steps */
     description?: React.ReactNode;

package/cjs/Insert/Insert.d.ts

@@ -5,6 +5,7 @@ declare type InsertContext = {
     variant?: BadgeVariants;
 };
 export interface InsertProps {
+    /** Descriptive title for the `Insert` */
     title: React.ReactNode;
     contexts?: Array<string | InsertContext>;
 }

package/cjs/Medallion/Medallion.js

@@ -15,7 +15,7 @@ var _classnames = _interopRequireDefault(require("classnames"));
 
 var _satellitePrefixer = _interopRequireDefault(require("../styles/helpers/satellitePrefixer"));
 
-var _templateObject, _templateObject2, _templateObject3, _templateObject4, _templateObject5, _templateObject6, _templateObject7, _templateObject8, _templateObject9;
+var _templateObject, _templateObject2, _templateObject3, _templateObject4, _templateObject5, _templateObject6, _templateObject7, _templateObject8, _templateObject9, _templateObject10;
 
 var VARIANT_CLASSNAMES = {
   grey: (0, _satellitePrefixer["default"])(_templateObject || (_templateObject = (0, _taggedTemplateLiteral2["default"])(["medallion-grey text-grey-600"]))),
@@ -24,7 +24,8 @@ var VARIANT_CLASSNAMES = {
   blue: (0, _satellitePrefixer["default"])(_templateObject4 || (_templateObject4 = (0, _taggedTemplateLiteral2["default"])(["medallion-blue text-blue-600"]))),
   green: (0, _satellitePrefixer["default"])(_templateObject5 || (_templateObject5 = (0, _taggedTemplateLiteral2["default"])(["medallion-green text-green-700"]))),
   orange: (0, _satellitePrefixer["default"])(_templateObject6 || (_templateObject6 = (0, _taggedTemplateLiteral2["default"])(["medallion-orange text-orange-600"]))),
-  red: (0, _satellitePrefixer["default"])(_templateObject7 || (_templateObject7 = (0, _taggedTemplateLiteral2["default"])(["medallion-red text-red-600"])))
+  red: (0, _satellitePrefixer["default"])(_templateObject7 || (_templateObject7 = (0, _taggedTemplateLiteral2["default"])(["medallion-red text-red-600"]))),
+  white: (0, _satellitePrefixer["default"])(_templateObject8 || (_templateObject8 = (0, _taggedTemplateLiteral2["default"])(["medallion-white text-nebula-500"])))
 };
 
 var Medallion = function Medallion(_ref) {
@@ -36,9 +37,9 @@ var Medallion = function Medallion(_ref) {
       className = _ref.className;
   var medallionClassName = VARIANT_CLASSNAMES[variant];
   return /*#__PURE__*/_react["default"].createElement("div", {
-    className: (0, _classnames["default"])((0, _satellitePrefixer["default"])(_templateObject8 || (_templateObject8 = (0, _taggedTemplateLiteral2["default"])(["medallion inline-flex items-center justify-center rounded-full ", ""])), size === "large" && "medallion-large"), medallionClassName, className)
+    className: (0, _classnames["default"])((0, _satellitePrefixer["default"])(_templateObject9 || (_templateObject9 = (0, _taggedTemplateLiteral2["default"])(["medallion inline-flex items-center justify-center rounded-full ", ""])), size === "large" && "medallion-large"), medallionClassName, className)
   }, /*#__PURE__*/_react["default"].createElement(Icon, {
-    className: (0, _satellitePrefixer["default"])(_templateObject9 || (_templateObject9 = (0, _taggedTemplateLiteral2["default"])(["p-1 ", ""])), size === "large" && "w-10 h-10")
+    className: (0, _satellitePrefixer["default"])(_templateObject10 || (_templateObject10 = (0, _taggedTemplateLiteral2["default"])(["p-1 ", ""])), size === "large" && "w-10 h-10")
   }));
 };
 

package/cjs/Medallion/Medallion.tailwind.js

@@ -14,7 +14,7 @@ var rgba = require("../styles/rgba");
 var medallionPlugin = function medallionPlugin(_ref) {
   var addComponents = _ref.addComponents,
       theme = _ref.theme;
-  var colors = ["grey", "pink", "accent", "blue", "green", "orange", "red"];
+  var colors = ["grey", "pink", "accent", "blue", "green", "orange", "red", "white"];
   addComponents({
     ".medallion": {
       height: 40,
@@ -28,8 +28,8 @@ var medallionPlugin = function medallionPlugin(_ref) {
 
   colors.map(function (color) {
     return addComponents((0, _defineProperty2["default"])({}, ".medallion-".concat(color), {
-      backgroundImage: "linear-gradient(to bottom, ".concat(theme("colors.".concat(color, ".100")), " 0%, ").concat(theme("colors.".concat(color, ".200")), " 100%)"),
-      boxShadow: "inset 0px -1px 0px 0px ".concat(theme("colors.".concat(color, ".300")), ", inset 0px 1px 0px 0px rgba(255, 255, 255, 0.5), 0px 7px 11px -3px ").concat(rgba(theme("colors.grey.900"), 0.2), ", 0px 2px 4px 0px ").concat(rgba(theme("colors.grey.900"), 0.3))
+      backgroundImage: color === "white" ? "linear-gradient(to bottom, ".concat(theme("colors.white"), " 0%, ").concat(theme("colors.grey.100"), " 100%)") : "linear-gradient(to bottom, ".concat(theme("colors.".concat(color, ".100")), " 0%, ").concat(theme("colors.".concat(color, ".200")), " 100%)"),
+      boxShadow: color === "white" ? "0px 4px 8px -2px rgba(33, 36, 61, 0.25), inset 0px -2px 2px rgba(35, 38, 59, 0.03)" : "0px 4px 8px -2px rgba(33, 36, 61, 0.25), inset 0px -2px 2px ".concat(rgba(theme("colors.".concat(color, ".300")), 0.03))
     }));
   });
 };

package/cjs/Medallion/types.d.ts

@@ -1,2 +1,2 @@
-export declare type MedallionVariant = "accent" | "grey" | "pink" | "blue" | "green" | "orange" | "red";
+export declare type MedallionVariant = "accent" | "grey" | "pink" | "blue" | "green" | "orange" | "red" | "white";
 export declare type MedallionSize = "default" | "large";

package/cjs/index.d.ts

@@ -16,6 +16,7 @@ export * from "./Checkbox";
 export * from "./ClickAwayContainer";
 export * from "./DatePicker";
 export * from "./Dropdown";
+export * from "./Dropzone";
 export * from "./EmptyState";
 export * from "./Field";
 export * from "./Flag";

package/cjs/index.js

@@ -240,6 +240,20 @@ Object.keys(_Dropdown).forEach(function (key) {
   });
 });
 
+var _Dropzone = require("./Dropzone");
+
+Object.keys(_Dropzone).forEach(function (key) {
+  if (key === "default" || key === "__esModule") return;
+  if (Object.prototype.hasOwnProperty.call(_exportNames, key)) return;
+  if (key in exports && exports[key] === _Dropzone[key]) return;
+  Object.defineProperty(exports, key, {
+    enumerable: true,
+    get: function get() {
+      return _Dropzone[key];
+    }
+  });
+});
+
 var _EmptyState = require("./EmptyState");
 
 Object.keys(_EmptyState).forEach(function (key) {

package/cjs/utils/formatters.d.ts

@@ -0,0 +1,25 @@
+declare const defaultHumanSizes: string[];
+export declare function numberWithCommas(x: number | string, precision?: number): string;
+export declare function formatHumanNumber(bytes: number, options?: {
+    /** @default 2 */
+    decimals?: number;
+    /** @default ['', 'K', 'M', 'B', 'T'] */
+    sizes?: typeof defaultHumanSizes;
+    /** @default 1000 */
+    divider?: number;
+    /**
+     * Hides the decimal points if they're 0
+     * @default false
+     */
+    prettyDecimals?: boolean;
+}): string;
+export declare function formatHumanSize(nb: number, options?: {
+    /** @default 2 */
+    decimals?: number;
+    /**
+     * Hides the decimal points if they're 0
+     * @default false
+     */
+    prettyDecimals?: boolean;
+}): string;
+export {};

package/cjs/utils/formatters.js

@@ -0,0 +1,51 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.formatHumanNumber = formatHumanNumber;
+exports.formatHumanSize = formatHumanSize;
+exports.numberWithCommas = numberWithCommas;
+var defaultHumanSizes = ["", "K", "M", "B", "T"];
+
+function numberWithCommas(x) {
+  var precision = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : 0;
+
+  if (typeof x !== "number") {
+    return x;
+  }
+
+  return (x || 0).toFixed(precision).replace(/\B(?=(\d{3})+(?!\d))/g, ",");
+}
+
+function formatHumanNumber(bytes, options) {
+  var _ref = options !== null && options !== void 0 ? options : {},
+      _ref$decimals = _ref.decimals,
+      decimals = _ref$decimals === void 0 ? 2 : _ref$decimals,
+      _ref$sizes = _ref.sizes,
+      sizes = _ref$sizes === void 0 ? defaultHumanSizes : _ref$sizes,
+      _ref$divider = _ref.divider,
+      divider = _ref$divider === void 0 ? 1000 : _ref$divider,
+      _ref$prettyDecimals = _ref.prettyDecimals,
+      prettyDecimals = _ref$prettyDecimals === void 0 ? false : _ref$prettyDecimals;
+
+  if (bytes === 0) return "0";
+  var i = Math.min(Math.max(0, Math.floor(Math.log(Math.abs(bytes)) / Math.log(divider))), sizes.length - 1);
+  var nb = bytes / Math.pow(divider, i);
+  return (Math.abs(nb) > 1000 ? numberWithCommas(nb, decimals) : prettyDecimals ? parseFloat(nb.toFixed(decimals)) : nb.toFixed(decimals)) + sizes[i];
+}
+
+function formatHumanSize(nb, options) {
+  var _ref2 = options !== null && options !== void 0 ? options : {},
+      _ref2$decimals = _ref2.decimals,
+      decimals = _ref2$decimals === void 0 ? 2 : _ref2$decimals,
+      _ref2$prettyDecimals = _ref2.prettyDecimals,
+      prettyDecimals = _ref2$prettyDecimals === void 0 ? false : _ref2$prettyDecimals;
+
+  return formatHumanNumber(nb, {
+    decimals: decimals,
+    sizes: ["", "K", "M", "G", "T"],
+    divider: 1000,
+    prettyDecimals: prettyDecimals
+  }) + "B";
+}

package/esm/AutoComplete/components/AutoCompleteEmptyState.d.ts

@@ -4,7 +4,9 @@ import { MedallionVariant } from "../../Medallion";
 export interface AutoCompleteEmptyStateProps {
     icon?: IconComponentType;
     variant?: MedallionVariant;
+    /** Descriptive title for state */
     title: React.ReactNode;
+    /** Optional description to explain why the screen is empty or define next steps */
     description?: React.ReactNode;
 }
 export declare const AutoCompleteEmptyState: ({ icon, variant, title, description, }: AutoCompleteEmptyStateProps) => JSX.Element;

package/esm/Avatars/UserAvatar.js

@@ -1,9 +1,9 @@
 import _taggedTemplateLiteral from "@babel/runtime/helpers/taggedTemplateLiteral";
 import _slicedToArray from "@babel/runtime/helpers/slicedToArray";
 
-var _templateObject, _templateObject2;
+var _templateObject, _templateObject2, _templateObject3;
 
-import React, { useState } from "react";
+import React, { useEffect, useState } from "react";
 import cx from "classnames";
 import stl from "../styles/helpers/satellitePrefixer";
 import { getUserInitials, getUserBackgroundClassName } from "./utils";
@@ -19,23 +19,28 @@ export var UserAvatar = function UserAvatar(_ref) {
 
   var _useState = useState(false),
       _useState2 = _slicedToArray(_useState, 2),
-      failedToLoadAvatar = _useState2[0],
-      setFailedToLoadAvatar = _useState2[1];
+      imageLoaded = _useState2[0],
+      setImageLoaded = _useState2[1];
 
   var initials = getUserInitials(user);
-  var hasValidAvatar = user.avatar && !failedToLoadAvatar;
+  useEffect(function () {
+    return setImageLoaded(false);
+  }, [user.avatar]);
   return /*#__PURE__*/React.createElement("div", {
-    className: cx(stl(_templateObject || (_templateObject = _taggedTemplateLiteral(["relative overflow-hidden flex justify-center items-center rounded-full text-white uppercase"]))), !hasValidAvatar && getUserBackgroundClassName((_user$email = user.email) !== null && _user$email !== void 0 ? _user$email : "no-email"), className),
+    className: cx(stl(_templateObject || (_templateObject = _taggedTemplateLiteral(["relative overflow-hidden flex justify-center items-center rounded-full text-white uppercase transition-colors"]))), imageLoaded ? stl(_templateObject2 || (_templateObject2 = _taggedTemplateLiteral(["bg-white"]))) : getUserBackgroundClassName((_user$email = user.email) !== null && _user$email !== void 0 ? _user$email : "no-email"), className),
     style: {
       width: size,
       height: size
     }
-  }, /*#__PURE__*/React.createElement("span", null, initials), hasValidAvatar && /*#__PURE__*/React.createElement("img", {
-    className: stl(_templateObject2 || (_templateObject2 = _taggedTemplateLiteral(["w-full absolute top-0 left-0"]))),
+  }, /*#__PURE__*/React.createElement("span", null, initials), /*#__PURE__*/React.createElement("img", {
+    className: stl(_templateObject3 || (_templateObject3 = _taggedTemplateLiteral(["\n          w-full absolute top-0 left-0\n          transition-opacity ", "\n        "])), imageLoaded ? "opacity-100" : "opacity-0"),
     src: user.avatar,
-    alt: "".concat(user.name || user.email, "'s avatar"),
+    alt: imageLoaded ? "".concat(user.name || user.email, "'s avatar") : "",
+    onLoad: function onLoad() {
+      return setImageLoaded(true);
+    },
     onError: function onError() {
-      return setFailedToLoadAvatar(true);
+      return setImageLoaded(false);
     }
   }));
 };

package/esm/Banner/Banner.d.ts

@@ -14,14 +14,17 @@ export interface BannerPropsBase {
 export interface BannerPageProps extends BannerPropsBase {
     /**
      * Usage context description
-     * @default content
+     * @default page
      */
     usageContext?: "page";
 }
 export interface BannerDefaultProps extends BannerPropsBase {
-    /** Usage context description */
+    /**
+     * Usage context description
+     * @default content
+     */
     usageContext?: "inline" | "content" | "section";
-    /** Notification title */
+    /** Descriptive title for the `Banner` */
     title?: React.ReactNode;
 }
 export declare type BannerProps = BannerPageProps | BannerDefaultProps;

package/esm/Banner/Banner.js

@@ -142,7 +142,7 @@ export var Banner = function Banner(props) {
   }, children)), onDismiss && /*#__PURE__*/React.createElement("span", {
     className: stl(_templateObject36 || (_templateObject36 = _taggedTemplateLiteral(["absolute top-2 right-2"])))
   }, /*#__PURE__*/React.createElement(IconButton, {
-    title: "Close banner",
+    title: "Close",
     variant: "subtle",
     size: "small",
     icon: X,

package/esm/Banners/Alert/Alert.d.ts

@@ -1,16 +1,20 @@
 import React, { FunctionComponent } from "react";
 import { ColorVariant, IconComponentType } from "../../types";
 export declare type AlertContextType = "page" | "section";
-declare type AlertColorVariant = Exclude<ColorVariant, "blue">;
+export declare type AlertColorVariant = Exclude<ColorVariant, "blue">;
 export interface AlertProps {
     /** @ignore */
     className?: string;
     /** @ignore */
     style?: React.CSSProperties;
+    /** Descriptive title for `Alert` */
     title?: React.ReactNode;
     /** @default grey */
     variant?: AlertColorVariant;
-    /** @default section */
+    /**
+     * Usage context description
+     * @default section
+     */
     usageContext?: AlertContextType;
     icon?: IconComponentType;
     onDismiss?(): void;

package/esm/Banners/Alert/Alert.js

@@ -115,7 +115,7 @@ export var Alert = function Alert(_ref) {
     className: stl(_templateObject23 || (_templateObject23 = _taggedTemplateLiteral(["absolute top-2 right-2"])))
   }, /*#__PURE__*/React.createElement(IconButton, {
     icon: X,
-    title: "Close banner",
+    title: "Close",
     variant: "subtle",
     size: "small",
     onClick: function onClick(evt) {

package/esm/Banners/Promote/Promote.d.ts

@@ -10,9 +10,9 @@ interface WidePromoteProps {
     illustration?: React.ReactNode;
 }
 export declare type PromoteProps = {
-    /** Product context for the banner (either a string or a React component) */
+    /** Product context for the banner */
     context?: React.ReactNode;
-    /** Descriptive title for banner (either a string or a React component) */
+    /** Descriptive title for banner */
     title: React.ReactNode;
     /** Buttons */
     actions?: React.ReactNode;

package/esm/Banners/Promote/Promote.js

@@ -83,7 +83,7 @@ export var Promote = function Promote(_ref) {
     className: stl(_templateObject12 || (_templateObject12 = _taggedTemplateLiteral(["absolute top-2 right-2"])))
   }, /*#__PURE__*/React.createElement(IconButton, {
     icon: X,
-    title: "Close banner",
+    title: "Close",
     variant: "subtle",
     size: "small",
     onClick: function onClick(evt) {

package/esm/DatePicker/DatePicker/DatePicker.d.ts

@@ -16,7 +16,7 @@ interface RenderTargetParams {
     toggle: (e: React.MouseEvent<HTMLButtonElement, MouseEvent>) => void;
     isOpen: boolean;
 }
-export interface DatePickerProps {
+export declare type DatePickerProps = {
     calendarProps?: Pick<CalendarProps, "fromMonth" | "toMonth" | "disabledDays">;
     onOpen?: DisplayProps["onClick"];
     onChange?: (value: Date | null) => void;
@@ -30,6 +30,11 @@ export interface DatePickerProps {
     initialValue?: Date | null;
     buttonSize?: DisplayProps["size"];
     modalPlacement?: ModalProps["placement"];
-}
+} & ({
+    editableYear?: false;
+} | {
+    editableYear: true;
+    years?: number[];
+});
 declare const DatePicker: FunctionComponent<DatePickerProps>;
 export default DatePicker;

package/esm/DatePicker/DatePicker/DatePicker.js

@@ -4,7 +4,7 @@ import _slicedToArray from "@babel/runtime/helpers/slicedToArray";
 
 var _templateObject, _templateObject2, _templateObject3, _templateObject4;
 
-import React, { useState } from "react";
+import React, { useMemo, useState } from "react";
 import stl from "../../styles/helpers/satellitePrefixer";
 import Modal from "../components/Modal";
 import Footer from "../components/Footer";
@@ -77,6 +77,17 @@ var DatePicker = function DatePicker(props) {
     }
   };
 
+  var yearProps = useMemo(function () {
+    var _state$selected;
+
+    return props.editableYear ? {
+      editableYear: true,
+      initialDate: (_state$selected = state.selected) !== null && _state$selected !== void 0 ? _state$selected : undefined,
+      years: props.years
+    } : {
+      editableYear: false
+    };
+  }, [props]);
   return /*#__PURE__*/React.createElement("div", null, /*#__PURE__*/React.createElement("span", {
     ref: setTargetElement,
     className: stl(_templateObject || (_templateObject = _taggedTemplateLiteral(["inline-block"])))
@@ -108,7 +119,7 @@ var DatePicker = function DatePicker(props) {
   }, (_props$calendarProps = props === null || props === void 0 ? void 0 : props.calendarProps) !== null && _props$calendarProps !== void 0 ? _props$calendarProps : {}, {
     selectedDays: value !== null && value !== void 0 ? value : undefined,
     onDayClick: handleDayClick
-  })), /*#__PURE__*/React.createElement(Footer, null, props.renderLeftFooter && /*#__PURE__*/React.createElement("div", null, props.renderLeftFooter({
+  }, yearProps)), /*#__PURE__*/React.createElement(Footer, null, props.renderLeftFooter && /*#__PURE__*/React.createElement("div", null, props.renderLeftFooter({
     state: state,
     dispatch: dispatch
   })), !props.renderRightPanel && /*#__PURE__*/React.createElement(FooterActions, {

package/esm/DatePicker/DatePicker.tailwind.js

@@ -24,8 +24,16 @@ var datePickerPlugin = function datePickerPlugin(_ref) {
   };
 
   addComponents((_addComponents = {
-    ".DayPicker-Caption": {
-      textAlign: "center"
+    ".DayPicker-Year": {
+      // ChevronDown svg from react-feather,
+      backgroundImage: 'url(\'data:image/svg+xml;utf8,<svg xmlns="http://www.w3.org/2000/svg" width="16" height="16" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><polyline points="6 9 12 15 18 9"></polyline></svg>\')',
+      backgroundRepeat: "no-repeat",
+      backgroundPositionX: "100%",
+      backgroundPositionY: "5px",
+      paddingRight: "1rem"
+    },
+    ".DayPicker-Month": {
+      marginTop: "0rem"
     }
   }, _defineProperty(_addComponents, prefix(".date-picker, .date-range-picker"), {
     "& .DayPicker-Months": {