@primer/components 0.0.0-2021111235020 → 0.0.0-202111136954

package/lib-esm/Overlay.js

@@ -0,0 +1,160 @@
+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); }
+
+import styled from 'styled-components';
+import React, { useEffect, useRef } from 'react';
+import useLayoutEffect from './utils/useIsomorphicLayoutEffect';
+import { get } from './constants';
+import { useOverlay } from './hooks';
+import Portal from './Portal';
+import sx from './sx';
+import { useCombinedRefs } from './hooks/useCombinedRefs';
+import { useTheme } from './ThemeProvider';
+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 = styled.div.withConfig({
+  displayName: "Overlay__StyledOverlay",
+  componentId: "sc-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;}", ";"], get('colors.canvas.overlay'), get('shadows.overlay.shadow'), props => heightMap[props.height || 'auto'], props => props.maxHeight && heightMap[props.maxHeight], props => widthMap[props.width || 'auto'], animationDuration, get('animation.easeOutCubic'), sx);
+
+/**
+ * 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.forwardRef(({
+  onClickOutside,
+  role = 'none',
+  initialFocusRef,
+  returnFocusRef,
+  ignoreClickRefs,
+  onEscape,
+  visibility = 'visible',
+  height,
+  top,
+  left,
+  anchorSide,
+  portalContainerName,
+  preventFocusOnOpen,
+  ...rest
+}, forwardedRef) => {
+  const overlayRef = useRef(null);
+  const combinedRef = useCombinedRefs(overlayRef, forwardedRef);
+  const {
+    theme
+  } = useTheme();
+  const slideAnimationDistance = parseInt(get('space.2')(theme).replace('px', ''));
+  const slideAnimationEasing = get('animation.easeOutCubic')(theme);
+  useOverlay({
+    overlayRef,
+    returnFocusRef,
+    onEscape,
+    ignoreClickRefs,
+    onClickOutside,
+    initialFocusRef,
+    preventFocusOnOpen
+  });
+  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]);
+  useLayoutEffect(() => {
+    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.createElement(Portal, {
+    containerName: portalContainerName
+  }, /*#__PURE__*/React.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'
+};
+export default Overlay;

package/lib-esm/Pagehead.d.ts

@@ -0,0 +1,5 @@
+import { SxProp } from './sx';
+import { ComponentProps } from './utils/types';
+declare const Pagehead: import("styled-components").StyledComponent<"div", any, SxProp, never>;
+export declare type PageheadProps = ComponentProps<typeof Pagehead>;
+export default Pagehead;

package/lib-esm/Pagehead.js

@@ -1,18 +1,8 @@
-import PropTypes from 'prop-types';
 import styled from 'styled-components';
-import { COMMON, get } from './constants';
+import { get } from './constants';
 import sx from './sx';
-import theme from './theme';
 const Pagehead = styled.div.withConfig({
   displayName: "Pagehead",
   componentId: "sc-1ntn78e-0"
-})(["position:relative;padding-top:", ";padding-bottom:", ";margin-bottom:", ";border-bottom:1px solid ", ";", ";", ";"], get('space.4'), get('space.4'), get('space.4'), get('colors.border.gray'), COMMON, sx);
-Pagehead.defaultProps = {
-  theme
-};
-Pagehead.propTypes = {
-  children: PropTypes.node,
-  ...COMMON.propTypes,
-  ...sx.propTypes
-};
+})(["position:relative;padding-top:", ";padding-bottom:", ";margin-bottom:", ";border-bottom:1px solid ", ";", ";"], get('space.4'), get('space.4'), get('space.4'), get('colors.border.default'), sx);
 export default Pagehead;

package/lib-esm/Pagination/Pagination.d.ts

@@ -0,0 +1,24 @@
+import React from 'react';
+export declare type PaginationProps = {
+    theme?: Record<string, unknown>;
+    pageCount: number;
+    currentPage: number;
+    onPageChange?: (e: React.MouseEvent, n: number) => void;
+    hrefBuilder?: (n: number) => string;
+    marginPageCount: number;
+    showPages?: boolean;
+    surroundingPageCount?: number;
+};
+declare function Pagination({ theme, pageCount, currentPage, onPageChange, hrefBuilder, marginPageCount, showPages, surroundingPageCount, ...rest }: PaginationProps): JSX.Element;
+declare namespace Pagination {
+    var defaultProps: {
+        hrefBuilder: typeof defaultHrefBuilder;
+        marginPageCount: number;
+        onPageChange: typeof noop;
+        showPages: boolean;
+        surroundingPageCount: number;
+    };
+}
+declare function defaultHrefBuilder(pageNum: number): string;
+declare function noop(): void;
+export default Pagination;

package/lib-esm/Pagination/Pagination.js

@@ -1,17 +1,15 @@
 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); }
 
 import React from 'react';
-import PropTypes from 'prop-types';
 import styled from 'styled-components';
-import sx from '../sx';
-import { get, COMMON } from '../constants';
-import theme from '../theme';
 import Box from '../Box';
-import { buildPaginationModel, buildComponentData } from './model';
+import { get } from '../constants';
+import sx from '../sx';
+import { buildComponentData, buildPaginationModel } from './model';
 const Page = styled.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 );}}", ";"], get('pagination.colors.normal.fg'), get('pagination.spaceBetween'), get('borderWidths.1'), get('pagination.borderRadius'), get('pagination.colors.hover.border'), get('pagination.colors.active.border'), get('pagination.colors.nextPrevious.fg'), get('pagination.colors.selected.fg'), get('pagination.colors.selected.bg'), get('pagination.colors.selected.border'), get('pagination.colors.disabled.fg'), get('pagination.colors.disabled.border'), get('pagination.spaceBetween'), get('pagination.spaceBetween'), COMMON);
+  componentId: "sc-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 );}}"], get('colors.fg.default'), get('space.1'), get('borderWidths.1'), get('radii.2'), get('colors.border.default'), get('colors.border.muted'), get('colors.accent.fg'), get('colors.fg.onEmphasis'), get('colors.accent.emphasis'), get('colors.primer.fg.disabled'), get('space.1'), get('space.1'));
 
 function usePaginationPages({
   theme,
@@ -25,7 +23,7 @@ function usePaginationPages({
 }) {
   const pageChange = React.useCallback(n => e => onPageChange(e, n), [onPageChange]);
   const model = React.useMemo(() => {
-    return buildPaginationModel(pageCount, currentPage, showPages, marginPageCount, surroundingPageCount);
+    return buildPaginationModel(pageCount, currentPage, !!showPages, marginPageCount, surroundingPageCount);
   }, [pageCount, currentPage, showPages, marginPageCount, surroundingPageCount]);
   const children = React.useMemo(() => {
     return model.map(page => {
@@ -45,18 +43,18 @@ function usePaginationPages({
 
 const PaginationContainer = styled.nav.withConfig({
   displayName: "Pagination__PaginationContainer",
-  componentId: "sc-58gpf2-1"
+  componentId: "sc-b80nss-1"
 })(["margin-top:20px;margin-bottom:15px;text-align:center;", ";"], sx);
 
 function Pagination({
   theme,
   pageCount,
   currentPage,
-  onPageChange,
-  hrefBuilder,
-  marginPageCount,
-  showPages,
-  surroundingPageCount,
+  onPageChange = noop,
+  hrefBuilder = defaultHrefBuilder,
+  marginPageCount = 1,
+  showPages = true,
+  surroundingPageCount = 2,
   ...rest
 }) {
   const pageElements = usePaginationPages({
@@ -83,27 +81,16 @@ Pagination.displayName = "Pagination";
 
 function defaultHrefBuilder(pageNum) {
   return `#${pageNum}`;
-}
+} // eslint-disable-next-line @typescript-eslint/no-empty-function
+
 
 function noop() {}
 
-Pagination.propTypes = {
-  currentPage: PropTypes.number.isRequired,
-  hrefBuilder: PropTypes.func,
-  marginPageCount: PropTypes.number,
-  onPageChange: PropTypes.func,
-  pageCount: PropTypes.number.isRequired,
-  showPages: PropTypes.bool,
-  surroundingPageCount: PropTypes.number,
-  ...COMMON.propTypes,
-  ...sx.propTypes
-};
 Pagination.defaultProps = {
   hrefBuilder: defaultHrefBuilder,
   marginPageCount: 1,
   onPageChange: noop,
   showPages: true,
-  surroundingPageCount: 2,
-  theme
+  surroundingPageCount: 2
 };
 export default Pagination;

package/lib-esm/Pagination/index.d.ts

@@ -0,0 +1,3 @@
+import Pagination from './Pagination';
+export type { PaginationProps } from './Pagination';
+export default Pagination;

package/lib-esm/Pagination/model.d.ts

@@ -0,0 +1,26 @@
+/// <reference types="react" />
+export declare function buildPaginationModel(pageCount: number, currentPage: number, showPages: boolean, marginPageCount: number, surroundingPageCount: number): ({
+    type: string;
+    num: number;
+    disabled: boolean;
+} | {
+    type: string;
+    num: number;
+    selected?: undefined;
+} | {
+    type: string;
+    num: number;
+    selected: boolean;
+})[];
+declare type PageType = {
+    type: string;
+    num: number;
+    disabled?: boolean;
+    selected?: boolean;
+};
+export declare function buildComponentData(page: PageType, hrefBuilder: (n: number) => string, onClick: (e: React.MouseEvent) => void): {
+    props: {};
+    key: string;
+    content: string;
+};
+export {};

package/lib-esm/Pagination/model.js

@@ -179,7 +179,7 @@ export 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-esm/PointerBox.d.ts

@@ -0,0 +1,11 @@
+/// <reference types="react" />
+import { BorderBoxProps } from './BorderBox';
+import { CaretProps } from './Caret';
+export declare type PointerBoxProps = {
+    caret?: CaretProps['location'];
+    bg?: CaretProps['bg'];
+    borderColor?: CaretProps['borderColor'];
+    border?: CaretProps['borderWidth'];
+} & BorderBoxProps;
+declare function PointerBox(props: PointerBoxProps): JSX.Element;
+export default PointerBox;

package/lib-esm/PointerBox.js

@@ -1,17 +1,16 @@
 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); }
 
 import React from 'react';
-import PropTypes from 'prop-types';
 import BorderBox from './BorderBox';
 import Caret from './Caret';
-import theme from './theme';
 
 function PointerBox(props) {
   // don't destructure these, just grab them
   const {
     bg,
     border,
-    borderColor
+    borderColor,
+    theme
   } = props;
   const {
     caret,
@@ -22,7 +21,8 @@ function PointerBox(props) {
     bg,
     borderColor,
     borderWidth: border,
-    location: caret
+    location: caret,
+    theme
   };
   return /*#__PURE__*/React.createElement(BorderBox, _extends({
     sx: {
@@ -32,11 +32,4 @@ function PointerBox(props) {
 }
 
 PointerBox.displayName = "PointerBox";
-PointerBox.defaultProps = {
-  theme
-};
-PointerBox.propTypes = { ...BorderBox.propTypes,
-  caret: Caret.propTypes.location,
-  theme: PropTypes.object
-};
 export default PointerBox;

package/lib-esm/Popover.d.ts

@@ -0,0 +1,20 @@
+/// <reference types="hoist-non-react-statics" />
+import { SxProp } from './sx';
+import { ComponentProps } from './utils/types';
+declare type CaretPosition = 'top' | 'bottom' | 'left' | 'right' | 'bottom-left' | 'bottom-right' | 'top-left' | 'top-right' | 'left-bottom' | 'left-top' | 'right-bottom' | 'right-top';
+declare const Popover: import("styled-components").StyledComponent<"div", any, {
+    caret?: CaretPosition | undefined;
+    relative?: boolean | undefined;
+    open?: boolean | undefined;
+} & SxProp, never>;
+declare const PopoverContent: import("styled-components").StyledComponent<"div", any, SxProp, never>;
+export declare type PopoverProps = ComponentProps<typeof Popover>;
+export declare type PopoverContentProps = ComponentProps<typeof PopoverContent>;
+declare const _default: string & import("styled-components").StyledComponentBase<"div", any, {
+    caret?: CaretPosition | undefined;
+    relative?: boolean | undefined;
+    open?: boolean | undefined;
+} & SxProp, never> & import("hoist-non-react-statics").NonReactStatics<never, {}> & {
+    Content: import("styled-components").StyledComponent<"div", any, SxProp, never>;
+};
+export default _default;

package/lib-esm/Popover.js

@@ -1,10 +1,7 @@
 import classnames from 'classnames';
-import PropTypes from 'prop-types';
 import styled from 'styled-components';
-import BorderBox from './BorderBox';
-import { COMMON, get, LAYOUT, POSITION } from './constants';
+import { get } from './constants';
 import sx from './sx';
-import theme from './theme';
 const Popover = styled.div.attrs(({
   className,
   caret
@@ -15,32 +12,13 @@ const Popover = styled.div.attrs(({
 }).withConfig({
   displayName: "Popover",
   componentId: "sc-1nxygy2-0"
-})(["position:", ";z-index:100;display:", ";", ";", ";", ";", ";"], props => props.relative ? 'relative' : 'absolute', props => props.open ? 'block' : 'none', COMMON, LAYOUT, POSITION, sx);
-const PopoverContent = styled(BorderBox).withConfig({
+})(["position:", ";z-index:100;display:", ";", ";"], props => props.relative ? 'relative' : 'absolute', props => props.open ? 'block' : 'none', sx);
+const PopoverContent = styled.div.withConfig({
   displayName: "Popover__PopoverContent",
   componentId: "sc-1nxygy2-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);}}", ";"], get('space.4'), get('colors.white'), COMMON, LAYOUT, get('space.3'), get('space.2'), get('popovers.colors.caret'), get('space.2'), get('colors.white'), Popover, Popover, Popover, get('space.3'), get('popovers.colors.caret'), get('colors.white'), Popover, Popover, Popover, Popover, get('space.4'), get('space.4'), Popover, Popover, Popover, Popover, Popover, Popover, get('space.2'), get('space.2'), Popover, Popover, Popover, get('space.3'), get('popovers.colors.caret'), get('colors.white'), Popover, Popover, Popover, get('space.3'), get('popovers.colors.caret'), get('colors.white'), Popover, Popover, get('space.4'), Popover, Popover, get('space.3'), get('space.3'), sx);
+})(["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);}}", ";"], get('colors.border.default'), get('radii.2'), get('space.4'), get('colors.canvas.overlay'), get('space.3'), get('space.2'), get('colors.border.default'), get('space.2'), get('colors.canvas.overlay'), Popover, Popover, Popover, get('space.3'), get('colors.border.default'), get('colors.canvas.overlay'), Popover, Popover, Popover, Popover, get('space.4'), get('space.4'), Popover, Popover, Popover, Popover, Popover, Popover, get('space.2'), get('space.2'), Popover, Popover, Popover, get('space.3'), get('colors.border.default'), get('colors.canvas.overlay'), Popover, Popover, Popover, get('space.3'), get('colors.border.default'), get('colors.canvas.overlay'), Popover, Popover, get('space.4'), Popover, Popover, get('space.3'), get('space.3'), sx);
 Popover.defaultProps = {
-  caret: 'top',
-  theme
-};
-Popover.propTypes = {
-  caret: PropTypes.any,
-  open: PropTypes.bool,
-  relative: PropTypes.bool,
-  theme: PropTypes.object,
-  ...COMMON.propTypes,
-  ...LAYOUT.propTypes,
-  ...POSITION.propTypes,
-  ...sx.propTypes
-};
-PopoverContent.defaultProps = {
-  theme
-};
-PopoverContent.propTypes = {
-  theme: PropTypes.object,
-  ...BorderBox.propTypes,
-  ...sx.propTypes
+  caret: 'top'
 };
 PopoverContent.displayName = 'Popover.Content';
 export default Object.assign(Popover, {

package/lib-esm/Portal/Portal.d.ts

@@ -0,0 +1,25 @@
+import React from 'react';
+/**
+ * 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.
+ */
+export declare function registerPortalRoot(root: Element, name?: string): void;
+export interface PortalProps {
+    /**
+     * Called when this portal is added to the DOM
+     */
+    onMount?: () => void;
+    /**
+     * Optional. Mount this portal at the container specified
+     * by this name. The container must be previously registered
+     * with `registerPortal`.
+     */
+    containerName?: string;
+}
+/**
+ * Creates a React Portal, placing all children in a separate physical DOM root node.
+ * @see https://reactjs.org/docs/portals.html
+ */
+export declare const Portal: React.FC<PortalProps>;

package/lib-esm/Portal/Portal.js

@@ -0,0 +1,83 @@
+import React from 'react';
+import { createPortal } from 'react-dom';
+import useLayoutEffect from '../utils/useIsomorphicLayoutEffect';
+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.
+ */
+
+export 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
+ */
+export 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.useRef(hostElement);
+  useLayoutEffect(() => {
+    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__*/createPortal(children, elementRef.current);
+};

package/lib-esm/Portal/index.d.ts

@@ -0,0 +1,4 @@
+import { Portal, PortalProps, registerPortalRoot } from './Portal';
+export default Portal;
+export { registerPortalRoot };
+export type { PortalProps };

package/lib-esm/Portal/index.js

@@ -0,0 +1,3 @@
+import { Portal, registerPortalRoot } from './Portal';
+export default Portal;
+export { registerPortalRoot };