@primer/components 30.3.0-rc.2010c7d4 → 30.3.0-rc.9dbc85a9

package/lib-esm/stories/Autocomplete.stories.js

@@ -0,0 +1,549 @@
+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, useRef, useState } from 'react';
+import { BaseStyles, Box, Text, TextInput, ThemeProvider } from '..';
+import TextInputTokens from '../TextInputWithTokens';
+import Autocomplete from '../Autocomplete/Autocomplete';
+import { AnchoredOverlay } from '../AnchoredOverlay';
+import { ButtonInvisible } from '../Button';
+const items = [{
+  text: 'zero',
+  id: 0
+}, {
+  text: 'one',
+  id: 1
+}, {
+  text: 'two',
+  id: 2
+}, {
+  text: 'three',
+  id: 3
+}, {
+  text: 'four',
+  id: 4
+}, {
+  text: 'five',
+  id: 5
+}, {
+  text: 'six',
+  id: 6
+}, {
+  text: 'seven',
+  id: 7
+}, {
+  text: 'twenty',
+  id: 20
+}, {
+  text: 'twentyone',
+  id: 21
+}];
+const mockTokens = [{
+  text: 'zero',
+  id: 0
+}, {
+  text: 'one',
+  id: 1
+}, {
+  text: 'three',
+  id: 3
+}, {
+  text: 'four',
+  id: 4
+}];
+export default {
+  title: 'Forms/Autocomplete',
+  decorators: [Story => {
+    const [lastKey, setLastKey] = useState('none');
+    const reportKey = useCallback(event => {
+      setLastKey(event.key);
+    }, []);
+    return /*#__PURE__*/React.createElement(ThemeProvider, null, /*#__PURE__*/React.createElement(BaseStyles, null, /*#__PURE__*/React.createElement(Box, {
+      onKeyDownCapture: reportKey
+    }, /*#__PURE__*/React.createElement(Box, {
+      position: "absolute",
+      right: 5,
+      top: 2
+    }, "Last key pressed: ", lastKey), /*#__PURE__*/React.createElement(Box, {
+      paddingTop: 5
+    }, /*#__PURE__*/React.createElement(Story, null)))));
+  }]
+};
+export const SingleSelect = () => {
+  return /*#__PURE__*/React.createElement(React.Fragment, null, /*#__PURE__*/React.createElement(Box, {
+    as: "label",
+    display: "block",
+    htmlFor: "autocompleteInput",
+    id: "autocompleteLabel"
+  }, "Pick an option"), /*#__PURE__*/React.createElement(Autocomplete, null, /*#__PURE__*/React.createElement(Autocomplete.Input, {
+    id: "autocompleteInput"
+  }), /*#__PURE__*/React.createElement(Autocomplete.Overlay, null, /*#__PURE__*/React.createElement(Autocomplete.Menu, {
+    items: items,
+    selectedItemIds: [],
+    "aria-labelledby": "autocompleteLabel"
+  }))));
+};
+export const MultiSelect = () => {
+  const [selectedItemIds, setSelectedItemIds] = useState([]);
+
+  const onSelectedChange = newlySelectedItems => {
+    if (!Array.isArray(newlySelectedItems)) {
+      return;
+    }
+
+    setSelectedItemIds(newlySelectedItems.map(item => item.id));
+  };
+
+  const getItemById = id => items.find(item => item.id === id);
+
+  return /*#__PURE__*/React.createElement(Box, {
+    display: "flex",
+    sx: {
+      gap: '1em'
+    }
+  }, /*#__PURE__*/React.createElement("div", null, /*#__PURE__*/React.createElement(Box, {
+    as: "label",
+    display: "block",
+    htmlFor: "autocompleteInput",
+    id: "autocompleteLabel"
+  }, "Pick an option"), /*#__PURE__*/React.createElement(Autocomplete, null, /*#__PURE__*/React.createElement(Autocomplete.Input, {
+    id: "autocompleteInput"
+  }), /*#__PURE__*/React.createElement(Autocomplete.Overlay, null, /*#__PURE__*/React.createElement(Autocomplete.Menu, {
+    items: items,
+    selectedItemIds: selectedItemIds,
+    "aria-labelledby": "autocompleteLabel",
+    onSelectedChange: onSelectedChange,
+    selectionVariant: "multiple"
+  })))), /*#__PURE__*/React.createElement("div", null, /*#__PURE__*/React.createElement("div", null, "Selected items:"), /*#__PURE__*/React.createElement(Box, {
+    as: "ul",
+    my: 0
+  }, selectedItemIds.map(selectedItemId => {
+    var _getItemById;
+
+    return /*#__PURE__*/React.createElement("li", {
+      key: selectedItemId
+    }, (_getItemById = getItemById(selectedItemId)) === null || _getItemById === void 0 ? void 0 : _getItemById.text);
+  }))));
+};
+MultiSelect.displayName = "MultiSelect";
+export const MultiSelectWithTokenInput = () => {
+  const [tokens, setTokens] = useState(mockTokens);
+  const selectedTokenIds = tokens.map(token => token.id);
+  const [selectedItemIds, setSelectedItemIds] = useState(selectedTokenIds);
+
+  const onTokenRemove = tokenId => {
+    setTokens(tokens.filter(token => token.id !== tokenId));
+    setSelectedItemIds(selectedItemIds.filter(id => id !== tokenId));
+  };
+
+  const onSelectedChange = newlySelectedItems => {
+    if (!Array.isArray(newlySelectedItems)) {
+      return;
+    }
+
+    setSelectedItemIds(newlySelectedItems.map(item => item.id));
+
+    if (newlySelectedItems.length < selectedItemIds.length) {
+      const newlySelectedItemIds = newlySelectedItems.map(({
+        id
+      }) => id);
+      const removedItemIds = selectedTokenIds.filter(id => !newlySelectedItemIds.includes(id));
+
+      for (const removedItemId of removedItemIds) {
+        onTokenRemove(removedItemId);
+      }
+
+      return;
+    }
+
+    setTokens(newlySelectedItems.map(({
+      id,
+      text
+    }) => ({
+      id,
+      text
+    })));
+  };
+
+  return /*#__PURE__*/React.createElement(React.Fragment, null, /*#__PURE__*/React.createElement(Box, {
+    as: "label",
+    display: "block",
+    htmlFor: "autocompleteInput",
+    id: "autocompleteLabel"
+  }, "Pick options"), /*#__PURE__*/React.createElement(Autocomplete, null, /*#__PURE__*/React.createElement(Autocomplete.Input, {
+    as: TextInputTokens,
+    tokens: tokens,
+    onTokenRemove: onTokenRemove,
+    id: "autocompleteInput"
+  }), /*#__PURE__*/React.createElement(Autocomplete.Overlay, null, /*#__PURE__*/React.createElement(Autocomplete.Menu, {
+    items: items,
+    selectedItemIds: selectedItemIds,
+    onSelectedChange: onSelectedChange,
+    selectionVariant: "multiple",
+    "aria-labelledby": "autocompleteLabel"
+  }))));
+};
+export const MultiSelectAddNewItem = () => {
+  const [localItemsState, setLocalItemsState] = useState(items);
+  const [filterVal, setFilterVal] = useState('');
+  const [tokens, setTokens] = useState(mockTokens);
+  const selectedTokenIds = tokens.map(token => token.id);
+  const [selectedItemIds, setSelectedItemIds] = useState(selectedTokenIds);
+
+  const onTokenRemove = tokenId => {
+    setTokens(tokens.filter(token => token.id !== tokenId));
+    setSelectedItemIds(selectedItemIds.filter(id => id !== tokenId));
+  };
+
+  const onSelectedChange = newlySelectedItems => {
+    if (!Array.isArray(newlySelectedItems)) {
+      return;
+    }
+
+    setSelectedItemIds(newlySelectedItems.map(item => item.id));
+
+    if (newlySelectedItems.length < selectedItemIds.length) {
+      const newlySelectedItemIds = newlySelectedItems.map(({
+        id
+      }) => id);
+      const removedItemIds = selectedTokenIds.filter(id => !newlySelectedItemIds.includes(id));
+
+      for (const removedItemId of removedItemIds) {
+        onTokenRemove(removedItemId);
+      }
+
+      return;
+    }
+
+    setTokens(newlySelectedItems.map(({
+      id,
+      text
+    }) => ({
+      id,
+      text
+    })));
+  };
+
+  const onItemSelect = item => {
+    onSelectedChange([...selectedItemIds.map(id => items.find(selectedItem => selectedItem.id === id)), item]);
+
+    if (!localItemsState.some(localItem => localItem.id === item.id)) {
+      setLocalItemsState([...localItemsState, item]);
+    }
+  };
+
+  const handleChange = e => {
+    setFilterVal(e.currentTarget.value);
+  };
+
+  return /*#__PURE__*/React.createElement(React.Fragment, null, /*#__PURE__*/React.createElement(Box, {
+    as: "label",
+    display: "block",
+    htmlFor: "autocompleteInput",
+    id: "autocompleteLabel"
+  }, "Pick options"), /*#__PURE__*/React.createElement(Autocomplete, null, /*#__PURE__*/React.createElement(Autocomplete.Input, {
+    as: TextInputTokens,
+    tokens: tokens,
+    onTokenRemove: onTokenRemove,
+    onChange: handleChange,
+    id: "autocompleteInput"
+  }), /*#__PURE__*/React.createElement(Autocomplete.Overlay, null, /*#__PURE__*/React.createElement(Autocomplete.Menu, {
+    addNewItem: filterVal && !localItemsState.map(localItem => localItem.text).includes(filterVal) ? {
+      text: `Add '${filterVal}'`,
+      handleAddItem: item => {
+        onItemSelect({ ...item,
+          text: filterVal,
+          selected: true
+        });
+        setFilterVal('');
+      }
+    } : undefined,
+    items: localItemsState,
+    selectedItemIds: selectedItemIds,
+    onSelectedChange: onSelectedChange,
+    selectionVariant: "multiple",
+    "aria-labelledby": "autocompleteLabel"
+  }))));
+};
+export const CustomEmptyStateMessage = () => {
+  return /*#__PURE__*/React.createElement(React.Fragment, null, /*#__PURE__*/React.createElement(Box, {
+    as: "label",
+    display: "block",
+    htmlFor: "autocompleteInput",
+    id: "autocompleteLabel"
+  }, "Pick an option"), /*#__PURE__*/React.createElement(Autocomplete, null, /*#__PURE__*/React.createElement(Autocomplete.Input, {
+    id: "autocompleteInput"
+  }), /*#__PURE__*/React.createElement(Autocomplete.Overlay, null, /*#__PURE__*/React.createElement(Autocomplete.Menu, {
+    items: items,
+    selectedItemIds: [],
+    "aria-labelledby": "autocompleteLabel",
+    emptyStateText: "Sorry, no matches"
+  }))));
+};
+export const CustomSearchFilter = () => {
+  const [filterVal, setFilterVal] = useState('');
+
+  const handleChange = e => {
+    setFilterVal(e.currentTarget.value);
+  };
+
+  const customFilterFn = item => item.text.includes(filterVal);
+
+  return /*#__PURE__*/React.createElement(React.Fragment, null, /*#__PURE__*/React.createElement(Box, {
+    as: "label",
+    display: "block",
+    htmlFor: "autocompleteInput",
+    id: "autocompleteLabel"
+  }, "Pick an option"), /*#__PURE__*/React.createElement(Autocomplete, null, /*#__PURE__*/React.createElement(Autocomplete.Input, {
+    id: "autocompleteInput",
+    onChange: handleChange
+  }), /*#__PURE__*/React.createElement(Autocomplete.Overlay, null, /*#__PURE__*/React.createElement(Autocomplete.Menu, {
+    items: items,
+    selectedItemIds: [],
+    "aria-labelledby": "autocompleteLabel",
+    filterFn: customFilterFn
+  }))), /*#__PURE__*/React.createElement(Text, {
+    fontSize: 0,
+    display: "block",
+    color: "fg.subtle",
+    mt: 2
+  }, "Items in dropdown are filtered if their text has no part that matches the input value"));
+};
+export const CustomSortAfterMenuClose = () => {
+  const [selectedItemIds, setSelectedItemIds] = useState([]);
+
+  const isItemSelected = itemId => selectedItemIds.includes(itemId);
+
+  const onSelectedChange = newlySelectedItems => {
+    if (!Array.isArray(newlySelectedItems)) {
+      return;
+    }
+
+    setSelectedItemIds(newlySelectedItems.map(item => item.id));
+  };
+
+  const customSortFn = (itemIdA, itemIdB) => isItemSelected(itemIdA) === isItemSelected(itemIdB) ? 0 : isItemSelected(itemIdA) ? 1 : -1;
+
+  return /*#__PURE__*/React.createElement(React.Fragment, null, /*#__PURE__*/React.createElement(Box, {
+    as: "label",
+    display: "block",
+    htmlFor: "autocompleteInput",
+    id: "autocompleteLabel"
+  }, "Pick an option"), /*#__PURE__*/React.createElement(Autocomplete, null, /*#__PURE__*/React.createElement(Autocomplete.Input, {
+    id: "autocompleteInput"
+  }), /*#__PURE__*/React.createElement(Autocomplete.Overlay, null, /*#__PURE__*/React.createElement(Autocomplete.Menu, {
+    items: items,
+    selectedItemIds: selectedItemIds,
+    "aria-labelledby": "autocompleteLabel",
+    onSelectedChange: onSelectedChange,
+    sortOnCloseFn: customSortFn,
+    selectionVariant: "multiple"
+  }))), /*#__PURE__*/React.createElement(Text, {
+    fontSize: 0,
+    display: "block",
+    color: "fg.subtle",
+    mt: 2
+  }, "When the dropdown closes, selected items are sorted to the end"));
+};
+export const WithCallbackWhenOverlayOpenStateChanges = () => {
+  const [isMenuOpen, setIsMenuOpen] = useState(false);
+
+  const onOpenChange = isOpen => {
+    setIsMenuOpen(isOpen);
+  };
+
+  return /*#__PURE__*/React.createElement(Box, {
+    display: "flex",
+    sx: {
+      gap: '1em'
+    }
+  }, /*#__PURE__*/React.createElement("div", null, /*#__PURE__*/React.createElement(Box, {
+    as: "label",
+    display: "block",
+    htmlFor: "autocompleteInput",
+    id: "autocompleteLabel"
+  }, "Pick an option"), /*#__PURE__*/React.createElement(Autocomplete, null, /*#__PURE__*/React.createElement(Autocomplete.Input, {
+    id: "autocompleteInput"
+  }), /*#__PURE__*/React.createElement(Autocomplete.Overlay, null, /*#__PURE__*/React.createElement(Autocomplete.Menu, {
+    items: items,
+    selectedItemIds: [],
+    "aria-labelledby": "autocompleteLabel",
+    onOpenChange: onOpenChange
+  })))), /*#__PURE__*/React.createElement("div", null, "The menu is ", /*#__PURE__*/React.createElement("strong", null, isMenuOpen ? 'opened' : 'closed')));
+};
+WithCallbackWhenOverlayOpenStateChanges.displayName = "WithCallbackWhenOverlayOpenStateChanges";
+export const AsyncLoadingOfItems = () => {
+  const [loadedItems, setLoadedItems] = useState([]);
+
+  const onOpenChange = () => {
+    setTimeout(() => {
+      setLoadedItems(items);
+    }, 1500);
+  };
+
+  return /*#__PURE__*/React.createElement(React.Fragment, null, /*#__PURE__*/React.createElement(Box, {
+    as: "label",
+    display: "block",
+    htmlFor: "autocompleteInput",
+    id: "autocompleteLabel"
+  }, "Pick an option"), /*#__PURE__*/React.createElement(Autocomplete, null, /*#__PURE__*/React.createElement(Autocomplete.Input, {
+    id: "autocompleteInput"
+  }), /*#__PURE__*/React.createElement(Autocomplete.Overlay, null, /*#__PURE__*/React.createElement(Autocomplete.Menu, {
+    items: loadedItems,
+    selectedItemIds: [],
+    "aria-labelledby": "autocompleteLabel",
+    onOpenChange: onOpenChange,
+    loading: loadedItems.length === 0
+  }))));
+};
+export const RenderingTheMenuOutsideAnOverlay = () => {
+  return /*#__PURE__*/React.createElement(React.Fragment, null, /*#__PURE__*/React.createElement(Box, {
+    as: "label",
+    display: "block",
+    htmlFor: "autocompleteInput",
+    id: "autocompleteLabel"
+  }, "Pick an option"), /*#__PURE__*/React.createElement(Autocomplete, null, /*#__PURE__*/React.createElement(Autocomplete.Input, {
+    id: "autocompleteInput"
+  }), /*#__PURE__*/React.createElement(Autocomplete.Menu, {
+    items: items,
+    selectedItemIds: [],
+    "aria-labelledby": "autocompleteLabel"
+  })));
+};
+export const CustomOverlayMenuAnchor = () => {
+  const menuAnchorRef = useRef(null);
+  const anchorWrapperStyles = {
+    display: 'flex',
+    alignItems: 'center',
+    flexGrow: 1,
+    flexShrink: 0,
+    flexBasis: '25%',
+    border: '1px solid black',
+    padding: '1em'
+  };
+  return /*#__PURE__*/React.createElement(React.Fragment, null, /*#__PURE__*/React.createElement(Box, {
+    as: "label",
+    htmlFor: "autocompleteInput",
+    id: "autocompleteLabel"
+  }, "Pick labels"), /*#__PURE__*/React.createElement(Box, _extends({}, anchorWrapperStyles, {
+    ref: menuAnchorRef
+  }), /*#__PURE__*/React.createElement(Autocomplete, null, /*#__PURE__*/React.createElement(Autocomplete.Input, {
+    as: TextInput,
+    id: "autocompleteInput",
+    sx: {
+      border: '0',
+      padding: '0',
+      boxShadow: 'none',
+      ':focus-within': {
+        border: '0',
+        boxShadow: 'none'
+      }
+    }
+  }), /*#__PURE__*/React.createElement(Autocomplete.Overlay, {
+    menuAnchorRef: menuAnchorRef
+  }, /*#__PURE__*/React.createElement(Autocomplete.Menu, {
+    items: items,
+    selectedItemIds: [],
+    "aria-labelledby": "autocompleteLabel"
+  })))), /*#__PURE__*/React.createElement(Text, {
+    fontSize: 0,
+    display: "block",
+    color: "fg.subtle",
+    mt: 2
+  }, "The overlay menu's position is anchored to the div with the black border instead of to the text input"));
+};
+export const WithCustomOverlayProps = () => {
+  return /*#__PURE__*/React.createElement(React.Fragment, null, /*#__PURE__*/React.createElement(Box, {
+    as: "label",
+    display: "block",
+    htmlFor: "autocompleteInput",
+    id: "autocompleteLabel"
+  }, "Pick an option"), /*#__PURE__*/React.createElement(Autocomplete, null, /*#__PURE__*/React.createElement(Autocomplete.Input, {
+    id: "autocompleteInput"
+  }), /*#__PURE__*/React.createElement(Autocomplete.Overlay, {
+    overlayProps: {
+      width: 'large',
+      height: 'xsmall'
+    }
+  }, /*#__PURE__*/React.createElement(Autocomplete.Menu, {
+    items: items,
+    selectedItemIds: [],
+    "aria-labelledby": "autocompleteLabel"
+  }))));
+};
+export const InOverlayWithCustomScrollContainerRef = () => {
+  const scrollContainerRef = useRef(null);
+  const inputRef = useRef(null);
+  const [isOpen, setIsOpen] = useState(false);
+
+  const handleOpen = () => {
+    setIsOpen(true);
+    inputRef.current && inputRef.current.focus();
+  };
+
+  return /*#__PURE__*/React.createElement(AnchoredOverlay, {
+    open: isOpen,
+    onOpen: handleOpen,
+    onClose: () => setIsOpen(false),
+    width: "large",
+    height: "xsmall",
+    focusTrapSettings: {
+      initialFocusRef: inputRef
+    },
+    side: "inside-top",
+    renderAnchor: props => /*#__PURE__*/React.createElement(ButtonInvisible, props, "open overlay")
+  }, /*#__PURE__*/React.createElement(Box, {
+    as: "label",
+    display: "block",
+    htmlFor: "autocompleteInput",
+    id: "autocompleteLabel",
+    sx: {
+      // 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'
+    }
+  }, "Pick options"), /*#__PURE__*/React.createElement(Autocomplete, null, /*#__PURE__*/React.createElement(Box, {
+    display: "flex",
+    flexDirection: "column",
+    height: "100%"
+  }, /*#__PURE__*/React.createElement(Box, {
+    paddingX: "3",
+    paddingY: "1",
+    borderWidth: 0,
+    borderBottomWidth: 1,
+    borderColor: "border.default",
+    borderStyle: "solid"
+  }, /*#__PURE__*/React.createElement(Autocomplete.Input, {
+    block: true,
+    as: TextInput,
+    ref: inputRef,
+    id: "autocompleteInput",
+    sx: {
+      display: 'flex',
+      border: '0',
+      padding: '0',
+      boxShadow: 'none',
+      ':focus-within': {
+        border: '0',
+        boxShadow: 'none'
+      }
+    }
+  })), /*#__PURE__*/React.createElement(Box, {
+    overflow: "auto",
+    flexGrow: 1,
+    ref: scrollContainerRef
+  }, /*#__PURE__*/React.createElement(Autocomplete.Menu, {
+    items: items,
+    selectedItemIds: [] // onSelectedChange={onSelectedChange}
+    ,
+    customScrollContainerRef: scrollContainerRef,
+    "aria-labelledby": "autocompleteLabel"
+  })))));
+};
+InOverlayWithCustomScrollContainerRef.displayName = "InOverlayWithCustomScrollContainerRef";

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

@@ -0,0 +1,3 @@
+export declare type MandateProps<T extends unknown, K extends keyof T> = Omit<T, K> & {
+    [MK in K]-?: NonNullable<T[MK]>;
+};

package/lib-esm/utils/types/MandateProps.js

@@ -0,0 +1 @@
+export {};

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

@@ -2,3 +2,4 @@ export * from './AriaRole';
 export * from './ComponentProps';
 export * from './Flatten';
 export * from './Merge';
+export * from './MandateProps';

package/lib-esm/utils/types/index.js

@@ -1,4 +1,5 @@
 export * from './AriaRole';
 export * from './ComponentProps';
 export * from './Flatten';
-export * from './Merge';
+export * from './Merge';
+export * from './MandateProps';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@primer/components",
-  "version": "30.3.0-rc.2010c7d4",
+  "version": "30.3.0-rc.9dbc85a9",
   "description": "Primer react components",
   "main": "lib/index.js",
   "module": "lib-esm/index.js",

package/src/AnchoredOverlay/AnchoredOverlay.tsx

@@ -4,6 +4,7 @@ import {FocusTrapHookSettings, useFocusTrap} from '../hooks/useFocusTrap'
 import {FocusZoneHookSettings, useFocusZone} from '../hooks/useFocusZone'
 import {useAnchoredPosition, useProvidedRefOrCreate, useRenderForcingRef} from '../hooks'
 import {useSSRSafeId} from '@react-aria/ssr'
+import {PositionSettings} from '../behaviors/anchoredPosition'
 
 interface AnchoredOverlayPropsWithAnchor {
   /**
@@ -69,7 +70,8 @@ interface AnchoredOverlayBaseProps extends Pick<OverlayProps, 'height' | 'width'
 }
 
 export type AnchoredOverlayProps = AnchoredOverlayBaseProps &
-  (AnchoredOverlayPropsWithAnchor | AnchoredOverlayPropsWithoutAnchor)
+  (AnchoredOverlayPropsWithAnchor | AnchoredOverlayPropsWithoutAnchor) &
+  Partial<Pick<PositionSettings, 'align' | 'side'>>
 
 /**
  * An `AnchoredOverlay` provides an anchor that will open a floating overlay positioned relative to the anchor.
@@ -86,7 +88,9 @@ export const AnchoredOverlay: React.FC<AnchoredOverlayProps> = ({
   width,
   overlayProps,
   focusTrapSettings,
-  focusZoneSettings
+  focusZoneSettings,
+  side,
+  align
 }) => {
   const anchorRef = useProvidedRefOrCreate(externalAnchorRef)
   const [overlayRef, updateOverlayRef] = useRenderForcingRef<HTMLDivElement>()
@@ -123,7 +127,9 @@ export const AnchoredOverlay: React.FC<AnchoredOverlayProps> = ({
   const {position} = useAnchoredPosition(
     {
       anchorElementRef: anchorRef,
-      floatingElementRef: overlayRef
+      floatingElementRef: overlayRef,
+      side,
+      align
     },
     [overlayRef.current]
   )
@@ -178,3 +184,8 @@ export const AnchoredOverlay: React.FC<AnchoredOverlayProps> = ({
 }
 
 AnchoredOverlay.displayName = 'AnchoredOverlay'
+
+AnchoredOverlay.defaultProps = {
+  side: 'outside-bottom',
+  align: 'start'
+}