@primer/components 0.0.0-202195195330 → 0.0.0-202195195659

package/lib-esm/Autocomplete/AutocompleteMenu.d.ts

@@ -0,0 +1,71 @@
+import React from 'react';
+import { ItemProps } from '../ActionList';
+import { ComponentProps, MandateProps } from '../utils/types';
+declare type OnSelectedChange<T> = (item: T | T[]) => void;
+declare type AutocompleteItemProps<T = Record<string, any>> = MandateProps<ItemProps, 'id'> & {
+    metadata?: T;
+};
+declare type AutocompleteMenuInternalProps<T extends AutocompleteItemProps> = {
+    /**
+     * A menu item that is used to allow users make a selection that is not available in the array passed to the `items` prop.
+     * This menu item gets appended to the end of the list of options.
+     */
+    addNewItem?: Omit<T, 'onAction' | 'leadingVisual' | 'id'> & {
+        handleAddItem: (item: Omit<T, 'onAction' | 'leadingVisual'>) => void;
+    };
+    /**
+     * The text that appears in the menu when there are no options in the array passed to the `items` prop.
+     */
+    emptyStateText?: React.ReactNode | false;
+    /**
+     * A custom function used to filter the options in the array passed to the `items` prop.
+     * By default, we filter out items that don't match the value of the autocomplete text input. The default filter is not case-sensitive.
+     */
+    filterFn?: (item: T, i: number) => boolean;
+    /**
+     * The options for field values that are displayed in the dropdown menu.
+     * One or more may be selected depending on the value of the `selectionVariant` prop.
+     */
+    items: T[];
+    /**
+     * Whether the data is loaded for the menu items
+     */
+    loading?: boolean;
+    /**
+     * The IDs of the selected items
+     */
+    selectedItemIds: Array<string | number>;
+    /**
+     * The sort function that is applied to the options in the array passed to the `items` prop after the user closes the menu.
+     * By default, selected items are sorted to the top after the user closes the menu.
+     */
+    sortOnCloseFn?: (itemIdA: string | number, itemIdB: string | number) => number;
+    /**
+     * Whether there can be one item selected from the menu or multiple items selected from the menu
+     */
+    selectionVariant?: 'single' | 'multiple';
+    /**
+     * Function that gets called when the menu is opened or closed
+     */
+    onOpenChange?: (open: boolean) => void;
+    /**
+     * The function that is called when an item in the list is selected or deselected
+     */
+    onSelectedChange?: OnSelectedChange<T>;
+    /**
+     * If the menu is rendered in a scrolling element other than the `Autocomplete.Overlay` component,
+     * pass the ref of that element to `customScrollContainerRef` to ensure the container automatically
+     * scrolls when the user highlights an item in the menu that is outside the scroll container
+     */
+    customScrollContainerRef?: React.MutableRefObject<HTMLElement | null>;
+} & Pick<React.AriaAttributes, 'aria-labelledby'>;
+declare function AutocompleteMenu<T extends AutocompleteItemProps>(props: AutocompleteMenuInternalProps<T>): JSX.Element;
+declare namespace AutocompleteMenu {
+    var defaultProps: {
+        emptyStateText: string;
+        selectionVariant: string;
+    };
+    var displayName: string;
+}
+export declare type AutocompleteMenuProps = ComponentProps<typeof AutocompleteMenu>;
+export default AutocompleteMenu;

package/lib-esm/Autocomplete/AutocompleteMenu.js

@@ -0,0 +1,201 @@
+import React, { useContext, useEffect, useMemo, useRef, useState } from 'react';
+import { ActionList } from '../ActionList';
+import { useFocusZone } from '../hooks/useFocusZone';
+import { Box, Spinner } from '../';
+import { AutocompleteContext } from './AutocompleteContext';
+import { PlusIcon } from '@primer/octicons-react';
+import { uniqueId } from '../utils/uniqueId';
+import { scrollIntoViewingArea } from '../utils/scrollIntoViewingArea';
+
+const getDefaultSortFn = isItemSelectedFn => (itemIdA, itemIdB) => isItemSelectedFn(itemIdA) === isItemSelectedFn(itemIdB) ? 0 : isItemSelectedFn(itemIdA) ? -1 : 1;
+
+function getDefaultItemFilter(filterValue) {
+  return function (item, _i) {
+    var _item$text;
+
+    return Boolean((_item$text = item.text) === null || _item$text === void 0 ? void 0 : _item$text.toLowerCase().startsWith(filterValue.toLowerCase()));
+  };
+}
+
+function getDefaultOnSelectionChange(setInputValueFn) {
+  return function (itemOrItems) {
+    const {
+      text = ''
+    } = Array.isArray(itemOrItems) ? itemOrItems.slice(-1)[0] : itemOrItems;
+    setInputValueFn && setInputValueFn(text);
+  };
+}
+
+const isItemSelected = (itemId, selectedItemIds) => selectedItemIds.includes(itemId);
+
+function getItemById(itemId, items) {
+  return items.find(item => item.id === itemId);
+}
+
+// TODO: consider making 'aria-labelledby' required
+function AutocompleteMenu(props) {
+  const {
+    activeDescendantRef,
+    id,
+    inputRef,
+    inputValue = '',
+    scrollContainerRef,
+    setAutocompleteSuggestion,
+    setShowMenu,
+    setInputValue,
+    setIsMenuDirectlyActivated,
+    setSelectedItemLength,
+    showMenu
+  } = useContext(AutocompleteContext);
+  const {
+    items,
+    selectedItemIds,
+    sortOnCloseFn,
+    emptyStateText,
+    addNewItem,
+    loading,
+    selectionVariant,
+    filterFn = getDefaultItemFilter(inputValue),
+    'aria-labelledby': ariaLabelledBy,
+    onOpenChange,
+    onSelectedChange = getDefaultOnSelectionChange(setInputValue),
+    customScrollContainerRef
+  } = props;
+  const listContainerRef = useRef(null);
+  const [highlightedItem, setHighlightedItem] = useState();
+  const [sortedItemIds, setSortedItemIds] = useState(items.map(({
+    id
+  }) => id));
+  const selectableItems = useMemo(() => items.map(selectableItem => {
+    return { ...selectableItem,
+      role: 'option',
+      id: selectableItem.id,
+      selected: selectionVariant === 'multiple' ? selectedItemIds.includes(selectableItem.id) : undefined,
+      onAction: item => {
+        const otherSelectedItemIds = selectedItemIds.filter(selectedItemId => selectedItemId !== item.id);
+        const newSelectedItemIds = selectedItemIds.includes(item.id) ? otherSelectedItemIds : [...otherSelectedItemIds, item.id];
+        onSelectedChange && onSelectedChange(newSelectedItemIds.map(newSelectedItemId => getItemById(newSelectedItemId, items)));
+
+        if (selectionVariant === 'multiple') {
+          setInputValue && setInputValue('');
+          setAutocompleteSuggestion && setAutocompleteSuggestion('');
+        } else {
+          var _inputRef$current;
+
+          setShowMenu && setShowMenu(false);
+          inputRef === null || inputRef === void 0 ? void 0 : (_inputRef$current = inputRef.current) === null || _inputRef$current === void 0 ? void 0 : _inputRef$current.setSelectionRange(inputRef.current.value.length, inputRef.current.value.length);
+        }
+      }
+    };
+  }), [items, selectedItemIds]);
+  const itemSortOrderData = useMemo(() => sortedItemIds.reduce((acc, curr, i) => {
+    acc[curr] = i;
+    return acc;
+  }, {}), [sortedItemIds]);
+  const sortedAndFilteredItemsToRender = useMemo(() => selectableItems.filter((item, i) => filterFn(item, i)).sort((a, b) => itemSortOrderData[a.id] - itemSortOrderData[b.id]), [selectableItems, itemSortOrderData, filterFn]);
+  const allItemsToRender = useMemo(() => [// sorted and filtered selectable items
+  ...sortedAndFilteredItemsToRender, // menu item used for creating a token from whatever is in the text input
+  ...(addNewItem ? [{ ...addNewItem,
+    leadingVisual: () => /*#__PURE__*/React.createElement(PlusIcon, null),
+    onAction: (item, e) => {
+      // TODO: make it possible to pass a leadingVisual when using `addNewItem`
+      addNewItem.handleAddItem({ ...item,
+        id: item.id || uniqueId(),
+        leadingVisual: undefined
+      });
+
+      if (selectionVariant === 'multiple') {
+        setInputValue && setInputValue('');
+        setAutocompleteSuggestion && setAutocompleteSuggestion('');
+      }
+    }
+  }] : [])], [sortedAndFilteredItemsToRender, addNewItem]);
+  useFocusZone({
+    containerRef: listContainerRef,
+    focusOutBehavior: 'wrap',
+    focusableElementFilter: element => {
+      return !(element instanceof HTMLInputElement);
+    },
+    activeDescendantFocus: inputRef,
+    onActiveDescendantChanged: (current, _previous, directlyActivated) => {
+      if (activeDescendantRef) {
+        activeDescendantRef.current = current || null;
+      }
+
+      if (current) {
+        const selectedItem = selectableItems.find(item => item.id.toString() === current.dataset.id);
+        setHighlightedItem(selectedItem);
+        setIsMenuDirectlyActivated && setIsMenuDirectlyActivated(directlyActivated);
+      }
+
+      if (current && customScrollContainerRef && customScrollContainerRef.current && directlyActivated) {
+        scrollIntoViewingArea(current, customScrollContainerRef.current);
+      } else if (current && scrollContainerRef && scrollContainerRef.current && directlyActivated) {
+        scrollIntoViewingArea(current, scrollContainerRef.current);
+      }
+    }
+  }, [loading]);
+  useEffect(() => {
+    var _highlightedItem$text;
+
+    if (!setAutocompleteSuggestion) {
+      return;
+    }
+
+    if (highlightedItem !== null && highlightedItem !== void 0 && (_highlightedItem$text = highlightedItem.text) !== null && _highlightedItem$text !== void 0 && _highlightedItem$text.startsWith(inputValue) && !selectedItemIds.includes(highlightedItem.id)) {
+      setAutocompleteSuggestion(highlightedItem.text);
+    } else {
+      setAutocompleteSuggestion('');
+    }
+  }, [highlightedItem, inputValue]);
+  useEffect(() => {
+    if (showMenu === false) {
+      setSortedItemIds([...sortedItemIds].sort(sortOnCloseFn ? sortOnCloseFn : getDefaultSortFn(itemId => isItemSelected(itemId, selectedItemIds))));
+    }
+
+    onOpenChange && onOpenChange(Boolean(showMenu));
+  }, [showMenu]);
+  useEffect(() => {
+    if (selectedItemIds.length) {
+      setSelectedItemLength && setSelectedItemLength(selectedItemIds.length);
+    }
+  }, [selectedItemIds]);
+  return /*#__PURE__*/React.createElement(Box, {
+    sx: !showMenu ? {
+      // visually hides this label for sighted users
+      position: 'absolute',
+      width: '1px',
+      height: '1px',
+      padding: '0',
+      margin: '-1px',
+      overflow: 'hidden',
+      clip: 'rect(0, 0, 0, 0)',
+      whiteSpace: 'nowrap',
+      borderWidth: '0'
+    } : {}
+  }, loading ? /*#__PURE__*/React.createElement(Box, {
+    p: 3,
+    display: "flex",
+    justifyContent: "center"
+  }, /*#__PURE__*/React.createElement(Spinner, null)) : /*#__PURE__*/React.createElement("div", {
+    ref: listContainerRef
+  }, allItemsToRender.length ? /*#__PURE__*/React.createElement(ActionList, {
+    selectionVariant: "multiple" // have to typecast to `ItemProps` because we have an extra property
+    // on `items` for Autocomplete: `metadata`
+    ,
+    items: allItemsToRender,
+    role: "listbox",
+    id: `${id}-listbox`,
+    "aria-labelledby": ariaLabelledBy
+  }) : /*#__PURE__*/React.createElement(Box, {
+    p: 3
+  }, emptyStateText)));
+}
+
+AutocompleteMenu.displayName = "AutocompleteMenu";
+AutocompleteMenu.defaultProps = {
+  emptyStateText: 'No selectable options',
+  selectionVariant: 'single'
+};
+AutocompleteMenu.displayName = 'AutocompleteMenu';
+export default AutocompleteMenu;

package/lib-esm/Autocomplete/AutocompleteOverlay.d.ts

@@ -0,0 +1,17 @@
+import React from 'react';
+import { OverlayProps } from '../Overlay';
+import { ComponentProps } from '../utils/types';
+declare type AutocompleteOverlayInternalProps = {
+    /**
+     * The ref of the element that the position of the menu is based on. By default, the menu is positioned based on the text input
+     */
+    menuAnchorRef?: React.RefObject<HTMLElement>;
+    /**
+     * Props to be spread on the internal `Overlay` component.
+     */
+    overlayProps?: Partial<OverlayProps>;
+    children?: React.ReactNode;
+} & Pick<React.AriaAttributes, 'aria-labelledby'>;
+declare const AutocompleteOverlay: React.FC<AutocompleteOverlayInternalProps>;
+export declare type AutocompleteOverlayProps = ComponentProps<typeof AutocompleteOverlay>;
+export default AutocompleteOverlay;

package/lib-esm/Autocomplete/AutocompleteOverlay.js

@@ -0,0 +1,51 @@
+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, { useCallback, useContext } from 'react';
+import { useAnchoredPosition } from '../hooks';
+import Overlay from '../Overlay';
+import { AutocompleteContext } from './AutocompleteContext';
+import { useCombinedRefs } from '../hooks/useCombinedRefs';
+
+// TODO: consider making 'aria-labelledby' required
+const AutocompleteOverlay = ({
+  menuAnchorRef,
+  overlayProps,
+  children
+}) => {
+  const {
+    inputRef,
+    scrollContainerRef,
+    selectedItemLength,
+    setShowMenu,
+    showMenu = false
+  } = useContext(AutocompleteContext);
+  const {
+    floatingElementRef,
+    position
+  } = useAnchoredPosition({
+    side: 'outside-bottom',
+    align: 'start',
+    anchorElementRef: menuAnchorRef ? menuAnchorRef : inputRef
+  }, [showMenu, selectedItemLength]);
+  const combinedOverlayRef = useCombinedRefs(scrollContainerRef, floatingElementRef);
+  const closeOptionList = useCallback(() => {
+    setShowMenu && setShowMenu(false);
+  }, [setShowMenu]);
+  return /*#__PURE__*/React.createElement(Overlay, _extends({
+    returnFocusRef: inputRef,
+    preventFocusOnOpen: true,
+    onClickOutside: closeOptionList,
+    onEscape: closeOptionList,
+    ref: combinedOverlayRef,
+    top: position === null || position === void 0 ? void 0 : position.top,
+    left: position === null || position === void 0 ? void 0 : position.left,
+    visibility: showMenu ? 'visible' : 'hidden',
+    sx: {
+      overflow: 'auto'
+    }
+  }, overlayProps), children);
+};
+
+AutocompleteOverlay.displayName = "AutocompleteOverlay";
+AutocompleteOverlay.displayName = 'AutocompleteOverlay';
+export default AutocompleteOverlay;

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

@@ -0,0 +1,2 @@
+export { default } from './Autocomplete';
+export type { AutocompleteMenuProps, AutocompleteInputProps, AutocompleteOverlayProps } from './Autocomplete';

package/lib-esm/Autocomplete/index.js

@@ -0,0 +1 @@
+export { default } from './Autocomplete';

package/lib-esm/FilteredActionList/FilteredActionList.js

@@ -1,6 +1,7 @@
 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, { useCallback, useEffect, useRef } from 'react';
+import { useSSRSafeId } from '@react-aria/ssr';
 import TextInput from '../TextInput';
 import Box from '../Box';
 import { ActionList } from '../ActionList';
@@ -11,36 +12,7 @@ import styled from 'styled-components';
 import { get } from '../constants';
 import { useProvidedRefOrCreate } from '../hooks/useProvidedRefOrCreate';
 import useScrollFlash from '../hooks/useScrollFlash';
-import { useSSRSafeId } from '@react-aria/ssr';
-
-function scrollIntoViewingArea(child, container, margin = 8, behavior = 'smooth') {
-  const {
-    top: childTop,
-    bottom: childBottom
-  } = child.getBoundingClientRect();
-  const {
-    top: containerTop,
-    bottom: containerBottom
-  } = container.getBoundingClientRect();
-  const isChildTopAboveViewingArea = childTop < containerTop + margin;
-  const isChildBottomBelowViewingArea = childBottom > containerBottom - margin;
-
-  if (isChildTopAboveViewingArea) {
-    const scrollHeightToChildTop = childTop - containerTop + container.scrollTop;
-    container.scrollTo({
-      behavior,
-      top: scrollHeightToChildTop - margin
-    });
-  } else if (isChildBottomBelowViewingArea) {
-    const scrollHeightToChildBottom = childBottom - containerBottom + container.scrollTop;
-    container.scrollTo({
-      behavior,
-      top: scrollHeightToChildBottom + margin
-    });
-  } // either completely in view or outside viewing area on both ends, don't scroll
-
-}
-
+import { scrollIntoViewingArea } from '../utils/scrollIntoViewingArea';
 const StyledHeader = styled.div.withConfig({
   displayName: "FilteredActionList__StyledHeader",
   componentId: "yg3jkv-0"
@@ -94,7 +66,7 @@ export function FilteredActionList({
   useEffect(() => {
     // if items changed, we want to instantly move active descendant into view
     if (activeDescendantRef.current && scrollContainerRef.current) {
-      scrollIntoViewingArea(activeDescendantRef.current, scrollContainerRef.current, undefined, 'auto');
+      scrollIntoViewingArea(activeDescendantRef.current, scrollContainerRef.current, 'vertical', undefined, undefined, 'auto');
     }
   }, [items]);
   useScrollFlash(scrollContainerRef);

package/lib-esm/Overlay.d.ts

@@ -4,7 +4,7 @@ import { ComponentProps } from './utils/types';
 import { TouchOrMouseEvent } from './hooks';
 import { SxProp } from './sx';
 import { AnchorSide } from './behaviors/anchoredPosition';
-declare type StyledOverlayProps = {
+export declare type StyledOverlayProps = {
     width?: keyof typeof widthMap;
     height?: keyof typeof heightMap;
     maxHeight?: keyof Omit<typeof heightMap, 'auto' | 'initial'>;
@@ -40,6 +40,7 @@ export declare type OverlayProps = {
     top: number;
     left: number;
     portalContainerName?: string;
+    preventFocusOnOpen?: boolean;
 } & Omit<ComponentProps<typeof StyledOverlay>, 'visibility' | keyof SystemPositionProps>;
 /**
  * An `Overlay` is a flexible floating surface, used to display transient content such as menus,

package/lib-esm/Overlay.js

@@ -92,6 +92,7 @@ const Overlay = /*#__PURE__*/React.forwardRef(({
   left,
   anchorSide,
   portalContainerName,
+  preventFocusOnOpen,
   ...rest
 }, forwardedRef) => {
   const overlayRef = useRef(null);
@@ -107,7 +108,8 @@ const Overlay = /*#__PURE__*/React.forwardRef(({
     onEscape,
     ignoreClickRefs,
     onClickOutside,
-    initialFocusRef
+    initialFocusRef,
+    preventFocusOnOpen
   });
   useEffect(() => {
     var _combinedRef$current;
@@ -136,9 +138,7 @@ const Overlay = /*#__PURE__*/React.forwardRef(({
       easing: slideAnimationEasing
     });
   }, [anchorSide, slideAnimationDistance, slideAnimationEasing, visibility]);
-  return /*#__PURE__*/React.createElement(Portal, {
-    containerName: portalContainerName
-  }, /*#__PURE__*/React.createElement(StyledOverlay, _extends({
+  const styledOverlay = /*#__PURE__*/React.createElement(StyledOverlay, _extends({
     height: height,
     role: role
   }, rest, {
@@ -149,7 +149,10 @@ const Overlay = /*#__PURE__*/React.forwardRef(({
       ...rest.style,
       '--styled-overlay-visibility': visibility
     }
-  })));
+  }));
+  return /*#__PURE__*/React.createElement(Portal, {
+    containerName: portalContainerName
+  }, styledOverlay);
 });
 Overlay.defaultProps = {
   height: 'auto',

package/lib-esm/hooks/useOverlay.d.ts

@@ -7,8 +7,9 @@ export declare type UseOverlaySettings = {
     onEscape: (e: KeyboardEvent) => void;
     onClickOutside: (e: TouchOrMouseEvent) => void;
     overlayRef?: React.RefObject<HTMLDivElement>;
+    preventFocusOnOpen?: boolean;
 };
 export declare type OverlayReturnProps = {
     ref: React.RefObject<HTMLDivElement>;
 };
-export declare const useOverlay: ({ overlayRef: _overlayRef, returnFocusRef, initialFocusRef, onEscape, ignoreClickRefs, onClickOutside }: UseOverlaySettings) => OverlayReturnProps;
+export declare const useOverlay: ({ overlayRef: _overlayRef, returnFocusRef, initialFocusRef, onEscape, ignoreClickRefs, onClickOutside, preventFocusOnOpen }: UseOverlaySettings) => OverlayReturnProps;

package/lib-esm/hooks/useOverlay.js

@@ -8,14 +8,19 @@ export const useOverlay = ({
   initialFocusRef,
   onEscape,
   ignoreClickRefs,
-  onClickOutside
+  onClickOutside,
+  preventFocusOnOpen
 }) => {
   const overlayRef = useProvidedRefOrCreate(_overlayRef);
-  useOpenAndCloseFocus({
-    containerRef: overlayRef,
-    returnFocusRef,
-    initialFocusRef
-  });
+
+  if (!preventFocusOnOpen) {
+    useOpenAndCloseFocus({
+      containerRef: overlayRef,
+      returnFocusRef,
+      initialFocusRef
+    });
+  }
+
   useOnOutsideClick({
     containerRef: overlayRef,
     ignoreClickRefs,

package/lib-esm/index.d.ts

@@ -24,6 +24,7 @@ export { useConfirm } from './Dialog/ConfirmationDialog';
 export { ActionList } from './ActionList';
 export { ActionMenu } from './ActionMenu';
 export type { ActionMenuProps } from './ActionMenu';
+export { default as Autocomplete } from './Autocomplete';
 export { default as Avatar } from './Avatar';
 export type { AvatarProps } from './Avatar';
 export { default as AvatarPair } from './AvatarPair';

package/lib-esm/index.js

@@ -19,6 +19,7 @@ export { useConfirm } from './Dialog/ConfirmationDialog'; // Components
 
 export { ActionList } from './ActionList';
 export { ActionMenu } from './ActionMenu';
+export { default as Autocomplete } from './Autocomplete';
 export { default as Avatar } from './Avatar';
 export { default as AvatarPair } from './AvatarPair';
 export { default as AvatarStack } from './AvatarStack';

package/lib-esm/utils/scrollIntoViewingArea.d.ts

@@ -0,0 +1 @@
+export declare const scrollIntoViewingArea: (child: HTMLElement, container: HTMLElement, direction?: 'horizontal' | 'vertical', startMargin?: number, endMargin?: number, behavior?: ScrollBehavior) => void;

package/lib-esm/utils/scrollIntoViewingArea.js

@@ -0,0 +1,30 @@
+export const scrollIntoViewingArea = (child, container, direction = 'vertical', startMargin = 8, endMargin = 0, behavior = 'smooth') => {
+  const startSide = direction === 'vertical' ? 'top' : 'left';
+  const endSide = direction === 'vertical' ? 'bottom' : 'right';
+  const scrollSide = direction === 'vertical' ? 'scrollTop' : 'scrollLeft';
+  const {
+    [startSide]: childStart,
+    [endSide]: childEnd
+  } = child.getBoundingClientRect();
+  const {
+    [startSide]: containerStart,
+    [endSide]: containerEnd
+  } = container.getBoundingClientRect();
+  const isChildStartAboveViewingArea = childStart < containerStart + endMargin;
+  const isChildBottomBelowViewingArea = childEnd > containerEnd - startMargin;
+
+  if (isChildStartAboveViewingArea) {
+    const scrollHeightToChildStart = childStart - containerStart + container[scrollSide];
+    container.scrollTo({
+      behavior,
+      [startSide]: scrollHeightToChildStart - endMargin
+    });
+  } else if (isChildBottomBelowViewingArea) {
+    const scrollHeightToChildBottom = childEnd - containerEnd + container[scrollSide];
+    container.scrollTo({
+      behavior,
+      [startSide]: scrollHeightToChildBottom + startMargin
+    });
+  } // either completely in view or outside viewing area on both ends, don't scroll
+
+};

package/lib-esm/utils/types.d.ts

@@ -12,3 +12,6 @@ export declare type ComponentProps<T> = T extends React.ComponentType<infer Prop
  */
 export declare type Flatten<T extends unknown> = T extends (infer U)[] ? U : never;
 export declare type AriaRole = 'alert' | 'alertdialog' | 'application' | 'article' | 'banner' | 'button' | 'cell' | 'checkbox' | 'columnheader' | 'combobox' | 'complementary' | 'contentinfo' | 'definition' | 'dialog' | 'directory' | 'document' | 'feed' | 'figure' | 'form' | 'grid' | 'gridcell' | 'group' | 'heading' | 'img' | 'link' | 'list' | 'listbox' | 'listitem' | 'log' | 'main' | 'marquee' | 'math' | 'menu' | 'menubar' | 'menuitem' | 'menuitemcheckbox ' | 'menuitemradio' | 'navigation' | 'none' | 'note' | 'option' | 'presentation' | 'progressbar' | 'radio' | 'radiogroup' | 'region' | 'row' | 'rowgroup' | 'rowheader' | 'scrollbar' | 'search' | 'searchbox' | 'separator' | 'slider' | 'spinbutton' | 'status' | 'switch' | 'tab' | 'table' | 'tablist' | 'tabpanel' | 'term' | 'textbox' | 'timer' | 'toolbar' | 'tooltip' | 'tree' | 'treegrid' | 'treeitem';
+export declare type MandateProps<T extends {}, K extends keyof T> = Omit<T, K> & {
+    [MK in K]-?: NonNullable<T[MK]>;
+};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@primer/components",
-  "version": "0.0.0-202195195330",
+  "version": "0.0.0-202195195659",
   "description": "Primer react components",
   "main": "lib/index.js",
   "module": "lib-esm/index.js",