@primer/components 0.0.0-202111023322 → 0.0.0-2021111104725

package/lib/Overlay.js

@@ -0,0 +1,184 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.default = void 0;
+
+var _styledComponents = _interopRequireDefault(require("styled-components"));
+
+var _react = _interopRequireWildcard(require("react"));
+
+var _useIsomorphicLayoutEffect = _interopRequireDefault(require("./utils/useIsomorphicLayoutEffect"));
+
+var _constants = require("./constants");
+
+var _hooks = require("./hooks");
+
+var _Portal = _interopRequireDefault(require("./Portal"));
+
+var _sx = _interopRequireDefault(require("./sx"));
+
+var _useCombinedRefs = require("./hooks/useCombinedRefs");
+
+var _ThemeProvider = require("./ThemeProvider");
+
+function _getRequireWildcardCache(nodeInterop) { if (typeof WeakMap !== "function") return null; var cacheBabelInterop = new WeakMap(); var cacheNodeInterop = new WeakMap(); return (_getRequireWildcardCache = function (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 _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
+
+function _extends() { _extends = Object.assign || function (target) { for (var i = 1; i < arguments.length; i++) { var source = arguments[i]; for (var key in source) { if (Object.prototype.hasOwnProperty.call(source, key)) { target[key] = source[key]; } } } return target; }; return _extends.apply(this, arguments); }
+
+const heightMap = {
+  xsmall: '192px',
+  small: '256px',
+  medium: '320px',
+  large: '432px',
+  xlarge: '600px',
+  auto: 'auto',
+  initial: 'auto' // Passing 'initial' initially applies 'auto'
+
+};
+const widthMap = {
+  small: '256px',
+  medium: '320px',
+  large: '480px',
+  xlarge: '640px',
+  xxlarge: '960px',
+  auto: 'auto'
+};
+const animationDuration = 200;
+
+function getSlideAnimationStartingVector(anchorSide) {
+  if (anchorSide !== null && anchorSide !== void 0 && anchorSide.endsWith('bottom')) {
+    return {
+      x: 0,
+      y: -1
+    };
+  } else if (anchorSide !== null && anchorSide !== void 0 && anchorSide.endsWith('top')) {
+    return {
+      x: 0,
+      y: 1
+    };
+  } else if (anchorSide !== null && anchorSide !== void 0 && anchorSide.endsWith('right')) {
+    return {
+      x: -1,
+      y: 0
+    };
+  } else if (anchorSide !== null && anchorSide !== void 0 && anchorSide.endsWith('left')) {
+    return {
+      x: 1,
+      y: 0
+    };
+  }
+
+  return {
+    x: 0,
+    y: 0
+  };
+}
+
+const StyledOverlay = _styledComponents.default.div.withConfig({
+  displayName: "Overlay__StyledOverlay",
+  componentId: "jhwkzw-0"
+})(["background-color:", ";box-shadow:", ";position:absolute;min-width:192px;max-width:640px;height:", ";max-height:", ";width:", ";border-radius:12px;overflow:hidden;animation:overlay-appear ", "ms ", ";@keyframes overlay-appear{0%{opacity:0;}100%{opacity:1;}}visibility:var(--styled-overlay-visibility);:focus{outline:none;}", ";"], (0, _constants.get)('colors.canvas.overlay'), (0, _constants.get)('shadows.overlay.shadow'), props => heightMap[props.height || 'auto'], props => props.maxHeight && heightMap[props.maxHeight], props => widthMap[props.width || 'auto'], animationDuration, (0, _constants.get)('animation.easeOutCubic'), _sx.default);
+
+/**
+ * An `Overlay` is a flexible floating surface, used to display transient content such as menus,
+ * selection options, dialogs, and more. Overlays use shadows to express elevation. The `Overlay`
+ * component handles all behaviors needed by overlay UIs as well as the common styles that all overlays * should have.
+ * @param ignoreClickRefs Optional. An array of ref objects to ignore clicks on in the `onOutsideClick` behavior. This is often used to ignore clicking on the element that toggles the open/closed state for the `Overlay` to prevent the `Overlay` from being toggled twice.
+ * @param initialFocusRef Optional. Ref for the element to focus when the `Overlay` is opened. If nothing is provided, the first focusable element in the `Overlay` body is focused.
+ * @param returnFocusRef Required. Ref for the element to focus when the `Overlay` is closed.
+ * @param onClickOutside  Required. Function to call when clicking outside of the `Overlay`. Typically this function removes the Overlay.
+ * @param onEscape Required. Function to call when user presses `Escape`. Typically this function removes the Overlay.
+ * @param width Sets the width of the `Overlay`, pick from our set list of widths, or pass `auto` to automatically set the width based on the content of the `Overlay`. `small` corresponds to `256px`, `medium` corresponds to `320px`, `large` corresponds to `480px`, `xlarge` corresponds to `640px`, `xxlarge` corresponds to `960px`.
+ * @param height Sets the height of the `Overlay`, pick from our set list of heights, or pass `auto` to automatically set the height based on the content of the `Overlay`, or pass `initial` to set the height based on the initial content of the `Overlay` (i.e. ignoring content changes). `xsmall` corresponds to `192px`, `small` corresponds to `256px`, `medium` corresponds to `320px`, `large` corresponds to `432px`, `xlarge` corresponds to `600px`.
+ * @param maxHeight Sets the maximum height of the `Overlay`, pick from our set list of heights. `xsmall` corresponds to `192px`, `small` corresponds to `256px`, `medium` corresponds to `320px`, `large` corresponds to `432px`, `xlarge` corresponds to `600px`.
+ * @param anchorSide If provided, the Overlay will slide into position from the side of the anchor with a brief animation
+ * @param top Optional. Vertical position of the overlay, relative to its closest positioned ancestor (often its `Portal`).
+ * @param left Optional. Horizontal position of the overlay, relative to its closest positioned ancestor (often its `Portal`).
+ * @param portalContainerName Optional. The name of the portal container to render the Overlay into.
+ */
+const Overlay = /*#__PURE__*/_react.default.forwardRef(({
+  onClickOutside,
+  role = 'none',
+  initialFocusRef,
+  returnFocusRef,
+  ignoreClickRefs,
+  onEscape,
+  visibility = 'visible',
+  height,
+  top,
+  left,
+  anchorSide,
+  portalContainerName,
+  preventFocusOnOpen,
+  ...rest
+}, forwardedRef) => {
+  const overlayRef = (0, _react.useRef)(null);
+  const combinedRef = (0, _useCombinedRefs.useCombinedRefs)(overlayRef, forwardedRef);
+  const {
+    theme
+  } = (0, _ThemeProvider.useTheme)();
+  const slideAnimationDistance = parseInt((0, _constants.get)('space.2')(theme).replace('px', ''));
+  const slideAnimationEasing = (0, _constants.get)('animation.easeOutCubic')(theme);
+  (0, _hooks.useOverlay)({
+    overlayRef,
+    returnFocusRef,
+    onEscape,
+    ignoreClickRefs,
+    onClickOutside,
+    initialFocusRef,
+    preventFocusOnOpen
+  });
+  (0, _react.useEffect)(() => {
+    var _combinedRef$current;
+
+    if (height === 'initial' && (_combinedRef$current = combinedRef.current) !== null && _combinedRef$current !== void 0 && _combinedRef$current.clientHeight) {
+      combinedRef.current.style.height = `${combinedRef.current.clientHeight}px`;
+    }
+  }, [height, combinedRef]);
+  (0, _useIsomorphicLayoutEffect.default)(() => {
+    var _overlayRef$current;
+
+    const {
+      x,
+      y
+    } = getSlideAnimationStartingVector(anchorSide);
+
+    if (!x && !y || !((_overlayRef$current = overlayRef.current) !== null && _overlayRef$current !== void 0 && _overlayRef$current.animate) || visibility === 'hidden') {
+      return;
+    } // JS animation is required because Safari does not allow css animations to start paused and then run
+
+
+    overlayRef.current.animate({
+      transform: [`translate(${slideAnimationDistance * x}px, ${slideAnimationDistance * y}px)`, `translate(0, 0)`]
+    }, {
+      duration: animationDuration,
+      easing: slideAnimationEasing
+    });
+  }, [anchorSide, slideAnimationDistance, slideAnimationEasing, visibility]);
+  return /*#__PURE__*/_react.default.createElement(_Portal.default, {
+    containerName: portalContainerName
+  }, /*#__PURE__*/_react.default.createElement(StyledOverlay, _extends({
+    height: height,
+    role: role
+  }, rest, {
+    ref: combinedRef,
+    style: {
+      top: `${top || 0}px`,
+      left: `${left || 0}px`,
+      '--styled-overlay-visibility': visibility
+    }
+  })));
+});
+
+Overlay.defaultProps = {
+  height: 'auto',
+  width: 'auto'
+};
+var _default = Overlay;
+exports.default = _default;

package/lib/Pagehead.js

@@ -5,30 +5,18 @@ Object.defineProperty(exports, "__esModule", {
 });
 exports.default = void 0;
 
-var _propTypes = _interopRequireDefault(require("prop-types"));
-
 var _styledComponents = _interopRequireDefault(require("styled-components"));
 
 var _constants = require("./constants");
 
 var _sx = _interopRequireDefault(require("./sx"));
 
-var _theme = _interopRequireDefault(require("./theme"));
-
 function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
 
 const Pagehead = _styledComponents.default.div.withConfig({
   displayName: "Pagehead",
   componentId: "sc-1ntn78e-0"
-})(["position:relative;padding-top:", ";padding-bottom:", ";margin-bottom:", ";border-bottom:1px solid ", ";", ";", ";"], (0, _constants.get)('space.4'), (0, _constants.get)('space.4'), (0, _constants.get)('space.4'), (0, _constants.get)('colors.border.gray'), _constants.COMMON, _sx.default);
+})(["position:relative;padding-top:", ";padding-bottom:", ";margin-bottom:", ";border-bottom:1px solid ", ";", ";"], (0, _constants.get)('space.4'), (0, _constants.get)('space.4'), (0, _constants.get)('space.4'), (0, _constants.get)('colors.border.default'), _sx.default);
 
-Pagehead.defaultProps = {
-  theme: _theme.default
-};
-Pagehead.propTypes = {
-  children: _propTypes.default.node,
-  ..._constants.COMMON.propTypes,
-  ..._sx.default.propTypes
-};
 var _default = Pagehead;
 exports.default = _default;

package/lib/Pagination/Pagination.js

@@ -7,17 +7,13 @@ exports.default = void 0;
 
 var _react = _interopRequireDefault(require("react"));
 
-var _propTypes = _interopRequireDefault(require("prop-types"));
-
 var _styledComponents = _interopRequireDefault(require("styled-components"));
 
-var _sx = _interopRequireDefault(require("../sx"));
+var _Box = _interopRequireDefault(require("../Box"));
 
 var _constants = require("../constants");
 
-var _theme = _interopRequireDefault(require("../theme"));
-
-var _Box = _interopRequireDefault(require("../Box"));
+var _sx = _interopRequireDefault(require("../sx"));
 
 var _model = require("./model");
 
@@ -27,8 +23,8 @@ function _extends() { _extends = Object.assign || function (target) { for (var i
 
 const Page = _styledComponents.default.a.withConfig({
   displayName: "Pagination__Page",
-  componentId: "sc-58gpf2-0"
-})(["display:inline-block;min-width:32px;padding:5px 10px;font-style:normal;line-height:20px;color:", ";text-align:center;white-space:nowrap;vertical-align:middle;cursor:pointer;user-select:none;text-decoration:none;margin-right:", ";&:last-child{margin-right:0;}border:", " solid transparent;border-radius:", ";transition:border-color 0.2s cubic-bezier(0.3,0,0.5,1);&:hover,&:focus{text-decoration:none;border-color:", ";outline:0;transition-duration:0.1s;}&:active{border-color:", ";}&[rel='prev'],&[rel='next']{color:", ";}&[aria-current],&[aria-current]:hover{color:", ";background-color:", ";border-color:", ";}&[aria-disabled],&[aria-disabled]:hover{color:", ";cursor:default;border-color:", ";}@supports (clip-path:polygon(50% 0,100% 50%,50% 100%)){&[rel='prev']::before,&[rel='next']::after{display:inline-block;width:16px;height:16px;vertical-align:text-bottom;content:'';background-color:currentColor;}&[rel='prev']::before{margin-right:", ";clip-path:polygon( 9.8px 12.8px,8.7px 12.8px,4.5px 8.5px,4.5px 7.5px,8.7px 3.2px,9.8px 4.3px,6.1px 8px,9.8px 11.7px,9.8px 12.8px );}&[rel='next']::after{margin-left:", ";clip-path:polygon( 6.2px 3.2px,7.3px 3.2px,11.5px 7.5px,11.5px 8.5px,7.3px 12.8px,6.2px 11.7px,9.9px 8px,6.2px 4.3px,6.2px 3.2px );}}", ";"], (0, _constants.get)('pagination.colors.normal.fg'), (0, _constants.get)('pagination.spaceBetween'), (0, _constants.get)('borderWidths.1'), (0, _constants.get)('pagination.borderRadius'), (0, _constants.get)('pagination.colors.hover.border'), (0, _constants.get)('pagination.colors.active.border'), (0, _constants.get)('pagination.colors.nextPrevious.fg'), (0, _constants.get)('pagination.colors.selected.fg'), (0, _constants.get)('pagination.colors.selected.bg'), (0, _constants.get)('pagination.colors.selected.border'), (0, _constants.get)('pagination.colors.disabled.fg'), (0, _constants.get)('pagination.colors.disabled.border'), (0, _constants.get)('pagination.spaceBetween'), (0, _constants.get)('pagination.spaceBetween'), _constants.COMMON);
+  componentId: "b80nss-0"
+})(["display:inline-block;min-width:32px;padding:5px 10px;font-style:normal;line-height:20px;color:", ";text-align:center;white-space:nowrap;vertical-align:middle;cursor:pointer;user-select:none;text-decoration:none;margin-right:", ";&:last-child{margin-right:0;}border:", " solid transparent;border-radius:", ";transition:border-color 0.2s cubic-bezier(0.3,0,0.5,1);&:hover,&:focus{text-decoration:none;border-color:", ";outline:0;transition-duration:0.1s;}&:active{border-color:", ";}&[rel='prev'],&[rel='next']{color:", ";}&[aria-current],&[aria-current]:hover{color:", ";background-color:", ";border-color:transparent;}&[aria-disabled],&[aria-disabled]:hover{color:", ";cursor:default;border-color:transparent;}@supports (clip-path:polygon(50% 0,100% 50%,50% 100%)){&[rel='prev']::before,&[rel='next']::after{display:inline-block;width:16px;height:16px;vertical-align:text-bottom;content:'';background-color:currentColor;}&[rel='prev']::before{margin-right:", ";clip-path:polygon( 9.8px 12.8px,8.7px 12.8px,4.5px 8.5px,4.5px 7.5px,8.7px 3.2px,9.8px 4.3px,6.1px 8px,9.8px 11.7px,9.8px 12.8px );}&[rel='next']::after{margin-left:", ";clip-path:polygon( 6.2px 3.2px,7.3px 3.2px,11.5px 7.5px,11.5px 8.5px,7.3px 12.8px,6.2px 11.7px,9.9px 8px,6.2px 4.3px,6.2px 3.2px );}}"], (0, _constants.get)('colors.fg.default'), (0, _constants.get)('space.1'), (0, _constants.get)('borderWidths.1'), (0, _constants.get)('radii.2'), (0, _constants.get)('colors.border.default'), (0, _constants.get)('colors.border.muted'), (0, _constants.get)('colors.accent.fg'), (0, _constants.get)('colors.fg.onEmphasis'), (0, _constants.get)('colors.accent.emphasis'), (0, _constants.get)('colors.primer.fg.disabled'), (0, _constants.get)('space.1'), (0, _constants.get)('space.1'));
 
 function usePaginationPages({
   theme,
@@ -43,7 +39,7 @@ function usePaginationPages({
   const pageChange = _react.default.useCallback(n => e => onPageChange(e, n), [onPageChange]);
 
   const model = _react.default.useMemo(() => {
-    return (0, _model.buildPaginationModel)(pageCount, currentPage, showPages, marginPageCount, surroundingPageCount);
+    return (0, _model.buildPaginationModel)(pageCount, currentPage, !!showPages, marginPageCount, surroundingPageCount);
   }, [pageCount, currentPage, showPages, marginPageCount, surroundingPageCount]);
 
   const children = _react.default.useMemo(() => {
@@ -65,18 +61,18 @@ function usePaginationPages({
 
 const PaginationContainer = _styledComponents.default.nav.withConfig({
   displayName: "Pagination__PaginationContainer",
-  componentId: "sc-58gpf2-1"
+  componentId: "b80nss-1"
 })(["margin-top:20px;margin-bottom:15px;text-align:center;", ";"], _sx.default);
 
 function Pagination({
   theme,
   pageCount,
   currentPage,
-  onPageChange,
-  hrefBuilder,
-  marginPageCount,
-  showPages,
-  surroundingPageCount,
+  onPageChange = noop,
+  hrefBuilder = defaultHrefBuilder,
+  marginPageCount = 1,
+  showPages = true,
+  surroundingPageCount = 2,
   ...rest
 }) {
   const pageElements = usePaginationPages({
@@ -103,28 +99,17 @@ Pagination.displayName = "Pagination";
 
 function defaultHrefBuilder(pageNum) {
   return `#${pageNum}`;
-}
+} // eslint-disable-next-line @typescript-eslint/no-empty-function
+
 
 function noop() {}
 
-Pagination.propTypes = {
-  currentPage: _propTypes.default.number.isRequired,
-  hrefBuilder: _propTypes.default.func,
-  marginPageCount: _propTypes.default.number,
-  onPageChange: _propTypes.default.func,
-  pageCount: _propTypes.default.number.isRequired,
-  showPages: _propTypes.default.bool,
-  surroundingPageCount: _propTypes.default.number,
-  ..._constants.COMMON.propTypes,
-  ..._sx.default.propTypes
-};
 Pagination.defaultProps = {
   hrefBuilder: defaultHrefBuilder,
   marginPageCount: 1,
   onPageChange: noop,
   showPages: true,
-  surroundingPageCount: 2,
-  theme: _theme.default
+  surroundingPageCount: 2
 };
 var _default = Pagination;
 exports.default = _default;

package/lib/Pagination/model.js

@@ -188,7 +188,7 @@ function buildComponentData(page, hrefBuilder, onClick) {
     case 'NUM':
       {
         key = `page-${page.num}`;
-        content = page.num;
+        content = String(page.num);
 
         if (page.selected) {
           Object.assign(props, {

package/lib/PointerBox.js

@@ -7,14 +7,10 @@ exports.default = void 0;
 
 var _react = _interopRequireDefault(require("react"));
 
-var _propTypes = _interopRequireDefault(require("prop-types"));
-
 var _BorderBox = _interopRequireDefault(require("./BorderBox"));
 
 var _Caret = _interopRequireDefault(require("./Caret"));
 
-var _theme = _interopRequireDefault(require("./theme"));
-
 function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
 
 function _extends() { _extends = Object.assign || function (target) { for (var i = 1; i < arguments.length; i++) { var source = arguments[i]; for (var key in source) { if (Object.prototype.hasOwnProperty.call(source, key)) { target[key] = source[key]; } } } return target; }; return _extends.apply(this, arguments); }
@@ -24,7 +20,8 @@ function PointerBox(props) {
   const {
     bg,
     border,
-    borderColor
+    borderColor,
+    theme
   } = props;
   const {
     caret,
@@ -35,7 +32,8 @@ function PointerBox(props) {
     bg,
     borderColor,
     borderWidth: border,
-    location: caret
+    location: caret,
+    theme
   };
   return /*#__PURE__*/_react.default.createElement(_BorderBox.default, _extends({
     sx: {
@@ -45,12 +43,5 @@ function PointerBox(props) {
 }
 
 PointerBox.displayName = "PointerBox";
-PointerBox.defaultProps = {
-  theme: _theme.default
-};
-PointerBox.propTypes = { ..._BorderBox.default.propTypes,
-  caret: _Caret.default.propTypes.location,
-  theme: _propTypes.default.object
-};
 var _default = PointerBox;
 exports.default = _default;

package/lib/Popover.js

@@ -5,18 +5,12 @@ Object.defineProperty(exports, "__esModule", {
 });
 exports.default = void 0;
 
-var _propTypes = _interopRequireDefault(require("prop-types"));
+var _classnames = _interopRequireDefault(require("classnames"));
 
 var _styledComponents = _interopRequireDefault(require("styled-components"));
 
-var _classnames = _interopRequireDefault(require("classnames"));
-
 var _constants = require("./constants");
 
-var _theme = _interopRequireDefault(require("./theme"));
-
-var _BorderBox = _interopRequireDefault(require("./BorderBox"));
-
 var _sx = _interopRequireDefault(require("./sx"));
 
 function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
@@ -30,38 +24,21 @@ const Popover = _styledComponents.default.div.attrs(({
   };
 }).withConfig({
   displayName: "Popover",
-  componentId: "sc-16dgy07-0"
-})(["position:", ";z-index:100;display:", ";", ";", ";", ";", ";"], props => props.relative ? 'relative' : 'absolute', props => props.open ? 'block' : 'none', _constants.COMMON, _constants.LAYOUT, _constants.POSITION, _sx.default);
+  componentId: "sc-1nxygy2-0"
+})(["position:", ";z-index:100;display:", ";", ";"], props => props.relative ? 'relative' : 'absolute', props => props.open ? 'block' : 'none', _sx.default);
+
+const PopoverContent = _styledComponents.default.div.withConfig({
+  displayName: "Popover__PopoverContent",
+  componentId: "sc-1nxygy2-1"
+})(["border:1px solid ", ";border-radius:", ";position:relative;width:232px;margin-right:auto;margin-left:auto;padding:", ";background-color:", ";&::before,&::after{position:absolute;left:50%;display:inline-block;content:'';}&::before{top:-", ";margin-left:-9px;border:", " solid transparent;border-bottom-color:", ";}&::after{top:-14px;margin-left:-", ";border:7px solid transparent;border-bottom-color:", ";}", ".caret-pos--bottom &,", ".caret-pos--bottom-right &,", ".caret-pos--bottom-left &{&::before,&::after{top:auto;border-bottom-color:transparent;}&::before{bottom:-", ";border-top-color:", ";}&::after{bottom:-14px;border-top-color:", ";}}", ".caret-pos--top-right &,", ".caret-pos--bottom-right &{right:-9px;margin-right:0;&::before,&::after{left:auto;margin-left:0;}&::before{right:20px;}&::after{right:21px;}}", ".caret-pos--top-left &,", ".caret-pos--bottom-left &{left:-9px;margin-left:0;&::before,&::after{left:", ";margin-left:0;}&::after{left:calc(", " + 1px);}}", ".caret-pos--right &,", ".caret-pos--right-top &,", ".caret-pos--right-bottom &,", ".caret-pos--left &,", ".caret-pos--left-top &,", ".caret-pos--left-bottom &{&::before,&::after{top:50%;left:auto;margin-left:0;border-bottom-color:transparent;}&::before{margin-top:calc((", " + 1px) * -1);}&::after{margin-top:-", ";}}", ".caret-pos--right &,", ".caret-pos--right-top &,", ".caret-pos--right-bottom &{&::before{right:-", ";border-left-color:", ";}&::after{right:-14px;border-left-color:", ";}}", ".caret-pos--left &,", ".caret-pos--left-top &,", ".caret-pos--left-bottom &{&::before{left:-", ";border-right-color:", ";}&::after{left:-14px;border-right-color:", ";}}", ".caret-pos--right-top &,", ".caret-pos--left-top &{&::before,&::after{top:", ";}}", ".caret-pos--right-bottom &,", ".caret-pos--left-bottom &{&::before,&::after{top:auto;}&::before{bottom:", ";}&::after{bottom:calc(", " + 1px);}}", ";"], (0, _constants.get)('colors.border.default'), (0, _constants.get)('radii.2'), (0, _constants.get)('space.4'), (0, _constants.get)('colors.canvas.overlay'), (0, _constants.get)('space.3'), (0, _constants.get)('space.2'), (0, _constants.get)('colors.border.default'), (0, _constants.get)('space.2'), (0, _constants.get)('colors.canvas.overlay'), Popover, Popover, Popover, (0, _constants.get)('space.3'), (0, _constants.get)('colors.border.default'), (0, _constants.get)('colors.canvas.overlay'), Popover, Popover, Popover, Popover, (0, _constants.get)('space.4'), (0, _constants.get)('space.4'), Popover, Popover, Popover, Popover, Popover, Popover, (0, _constants.get)('space.2'), (0, _constants.get)('space.2'), Popover, Popover, Popover, (0, _constants.get)('space.3'), (0, _constants.get)('colors.border.default'), (0, _constants.get)('colors.canvas.overlay'), Popover, Popover, Popover, (0, _constants.get)('space.3'), (0, _constants.get)('colors.border.default'), (0, _constants.get)('colors.canvas.overlay'), Popover, Popover, (0, _constants.get)('space.4'), Popover, Popover, (0, _constants.get)('space.3'), (0, _constants.get)('space.3'), _sx.default);
 
-Popover.Content = (0, _styledComponents.default)(_BorderBox.default).withConfig({
-  displayName: "Popover__Content",
-  componentId: "sc-16dgy07-1"
-})(["position:relative;width:232px;margin-right:auto;margin-left:auto;padding:", ";background-color:", ";", ";", ";&::before,&::after{position:absolute;left:50%;display:inline-block;content:'';}&::before{top:-", ";margin-left:-9px;border:", " solid transparent;border-bottom-color:", ";}&::after{top:-14px;margin-left:-", ";border:7px solid transparent;border-bottom-color:", ";}", ".caret-pos--bottom &,", ".caret-pos--bottom-right &,", ".caret-pos--bottom-left &{&::before,&::after{top:auto;border-bottom-color:transparent;}&::before{bottom:-", ";border-top-color:", ";}&::after{bottom:-14px;border-top-color:", ";}}", ".caret-pos--top-right &,", ".caret-pos--bottom-right &{right:-9px;margin-right:0;&::before,&::after{left:auto;margin-left:0;}&::before{right:20px;}&::after{right:21px;}}", ".caret-pos--top-left &,", ".caret-pos--bottom-left &{left:-9px;margin-left:0;&::before,&::after{left:", ";margin-left:0;}&::after{left:calc(", " + 1px);}}", ".caret-pos--right &,", ".caret-pos--right-top &,", ".caret-pos--right-bottom &,", ".caret-pos--left &,", ".caret-pos--left-top &,", ".caret-pos--left-bottom &{&::before,&::after{top:50%;left:auto;margin-left:0;border-bottom-color:transparent;}&::before{margin-top:calc((", " + 1px) * -1);}&::after{margin-top:-", ";}}", ".caret-pos--right &,", ".caret-pos--right-top &,", ".caret-pos--right-bottom &{&::before{right:-", ";border-left-color:", ";}&::after{right:-14px;border-left-color:", ";}}", ".caret-pos--left &,", ".caret-pos--left-top &,", ".caret-pos--left-bottom &{&::before{left:-", ";border-right-color:", ";}&::after{left:-14px;border-right-color:", ";}}", ".caret-pos--right-top &,", ".caret-pos--left-top &{&::before,&::after{top:", ";}}", ".caret-pos--right-bottom &,", ".caret-pos--left-bottom &{&::before,&::after{top:auto;}&::before{bottom:", ";}&::after{bottom:calc(", " + 1px);}}", ";"], (0, _constants.get)('space.4'), (0, _constants.get)('colors.white'), _constants.COMMON, _constants.LAYOUT, (0, _constants.get)('space.3'), (0, _constants.get)('space.2'), (0, _constants.get)('popovers.colors.caret'), (0, _constants.get)('space.2'), (0, _constants.get)('colors.white'), Popover, Popover, Popover, (0, _constants.get)('space.3'), (0, _constants.get)('popovers.colors.caret'), (0, _constants.get)('colors.white'), Popover, Popover, Popover, Popover, (0, _constants.get)('space.4'), (0, _constants.get)('space.4'), Popover, Popover, Popover, Popover, Popover, Popover, (0, _constants.get)('space.2'), (0, _constants.get)('space.2'), Popover, Popover, Popover, (0, _constants.get)('space.3'), (0, _constants.get)('popovers.colors.caret'), (0, _constants.get)('colors.white'), Popover, Popover, Popover, (0, _constants.get)('space.3'), (0, _constants.get)('popovers.colors.caret'), (0, _constants.get)('colors.white'), Popover, Popover, (0, _constants.get)('space.4'), Popover, Popover, (0, _constants.get)('space.3'), (0, _constants.get)('space.3'), _sx.default);
-Popover.CARET_POSITIONS = ['top', 'bottom', 'left', 'right', 'bottom-left', 'bottom-right', 'top-left', 'top-right', 'left-bottom', 'left-top', 'right-bottom', 'right-top'];
 Popover.defaultProps = {
-  caret: 'top',
-  theme: _theme.default
+  caret: 'top'
 };
-Popover.propTypes = {
-  as: _propTypes.default.elementType,
-  caret: _propTypes.default.oneOf(Popover.CARET_POSITIONS),
-  open: _propTypes.default.bool,
-  relative: _propTypes.default.bool,
-  theme: _propTypes.default.object,
-  ..._constants.COMMON.propTypes,
-  ..._constants.LAYOUT.propTypes,
-  ..._constants.POSITION.propTypes,
-  ..._sx.default.propTypes
-};
-Popover.Content.defaultProps = {
-  theme: _theme.default
-};
-Popover.Content.propTypes = {
-  as: _propTypes.default.elementType,
-  theme: _propTypes.default.object,
-  ..._BorderBox.default.propTypes,
-  ..._sx.default.propTypes
-};
-Popover.Content.displayName = 'Popover.Content';
-var _default = Popover;
+PopoverContent.displayName = 'Popover.Content';
+
+var _default = Object.assign(Popover, {
+  Content: PopoverContent
+});
+
 exports.default = _default;

package/lib/Portal/Portal.js

@@ -0,0 +1,101 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.registerPortalRoot = registerPortalRoot;
+exports.Portal = void 0;
+
+var _react = _interopRequireDefault(require("react"));
+
+var _reactDom = require("react-dom");
+
+var _useIsomorphicLayoutEffect = _interopRequireDefault(require("../utils/useIsomorphicLayoutEffect"));
+
+function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
+
+const PRIMER_PORTAL_ROOT_ID = '__primerPortalRoot__';
+const DEFAULT_PORTAL_CONTAINER_NAME = '__default__';
+const portalRootRegistry = {};
+/**
+ * Register a container to serve as a portal root.
+ * @param root The element that will be the root for portals created in this container
+ * @param name The name of the container, to be used with the `containerName` prop on the Portal Component.
+ * If name is not specified, registers the default portal root.
+ */
+
+function registerPortalRoot(root, name = DEFAULT_PORTAL_CONTAINER_NAME) {
+  portalRootRegistry[name] = root;
+} // Ensures that a default portal root exists and is registered. If a DOM element exists
+// with id __primerPortalRoot__, allow that element to serve as the default portal root.
+// Otherwise, create that element and attach it to the end of document.body.
+
+
+function ensureDefaultPortal() {
+  const existingDefaultPortalContainer = portalRootRegistry[DEFAULT_PORTAL_CONTAINER_NAME];
+
+  if (!existingDefaultPortalContainer || !document.body.contains(existingDefaultPortalContainer)) {
+    let defaultPortalContainer = document.getElementById(PRIMER_PORTAL_ROOT_ID);
+
+    if (!(defaultPortalContainer instanceof Element)) {
+      defaultPortalContainer = document.createElement('div');
+      defaultPortalContainer.setAttribute('id', PRIMER_PORTAL_ROOT_ID);
+      defaultPortalContainer.style.position = 'absolute';
+      defaultPortalContainer.style.top = '0';
+      defaultPortalContainer.style.left = '0';
+      const suitablePortalRoot = document.querySelector('[data-portal-root]');
+
+      if (suitablePortalRoot) {
+        suitablePortalRoot.appendChild(defaultPortalContainer);
+      } else {
+        document.body.appendChild(defaultPortalContainer);
+      }
+    }
+
+    registerPortalRoot(defaultPortalContainer);
+  }
+}
+
+/**
+ * Creates a React Portal, placing all children in a separate physical DOM root node.
+ * @see https://reactjs.org/docs/portals.html
+ */
+const Portal = ({
+  children,
+  onMount,
+  containerName: _containerName
+}) => {
+  const hostElement = document.createElement('div'); // Portaled content should get their own stacking context so they don't interfere
+  // with each other in unexpected ways. One should never find themselves tempted
+  // to change the zIndex to a value other than "1".
+
+  hostElement.style.position = 'relative';
+  hostElement.style.zIndex = '1';
+
+  const elementRef = _react.default.useRef(hostElement);
+
+  (0, _useIsomorphicLayoutEffect.default)(() => {
+    let containerName = _containerName;
+
+    if (containerName === undefined) {
+      containerName = DEFAULT_PORTAL_CONTAINER_NAME;
+      ensureDefaultPortal();
+    }
+
+    const parentElement = portalRootRegistry[containerName];
+
+    if (!parentElement) {
+      throw new Error(`Portal container '${_containerName}' is not yet registered. Container must be registered with registerPortal before use.`);
+    }
+
+    const element = elementRef.current;
+    parentElement.appendChild(element);
+    onMount === null || onMount === void 0 ? void 0 : onMount();
+    return () => {
+      parentElement.removeChild(element);
+    }; // eslint-disable-next-line react-hooks/exhaustive-deps
+  }, [elementRef]);
+  return /*#__PURE__*/(0, _reactDom.createPortal)(children, elementRef.current);
+};
+
+exports.Portal = Portal;

package/lib/Portal/index.js

@@ -0,0 +1,17 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+Object.defineProperty(exports, "registerPortalRoot", {
+  enumerable: true,
+  get: function () {
+    return _Portal.registerPortalRoot;
+  }
+});
+exports.default = void 0;
+
+var _Portal = require("./Portal");
+
+var _default = _Portal.Portal;
+exports.default = _default;