@primer/components 29.1.1 → 30.0.0-rc.9be85598

package/src/__tests__/hooks/useOnEscapePress.tsx

@@ -0,0 +1,16 @@
+import {useOnEscapePress} from '../../hooks/useOnEscapePress'
+import {render, fireEvent} from '@testing-library/react'
+import React from 'react'
+
+it('should call function when user presses escape', () => {
+  const functionToCall = jest.fn()
+  const Component = () => {
+    useOnEscapePress(functionToCall)
+    return <div>content</div>
+  }
+
+  const {getByText} = render(<Component />)
+  const domNode = getByText('content')
+  fireEvent.keyDown(domNode, {key: 'Escape', code: 'Escape', keyCode: 27, charCode: 27})
+  expect(functionToCall).toHaveBeenCalledTimes(1)
+})

package/src/__tests__/hooks/useOnOutsideClick.tsx

@@ -0,0 +1,48 @@
+import {useOnOutsideClick} from '../../hooks/useOnOutsideClick'
+import {render} from '@testing-library/react'
+import React, {useRef} from 'react'
+import userEvent from '@testing-library/user-event'
+
+type ComponentProps = {
+  callback: () => void
+}
+const Component = ({callback}: ComponentProps) => {
+  const containerRef = useRef<HTMLDivElement>(null)
+  const outerButton = useRef<HTMLButtonElement>(null)
+  const secondButton = useRef<HTMLButtonElement>(null)
+  useOnOutsideClick({ignoreClickRefs: [secondButton], containerRef, onClickOutside: callback})
+  return (
+    <div>
+      <button ref={outerButton}>button</button>
+      <button ref={secondButton}>button two</button>
+      <div ref={containerRef}>content</div>
+    </div>
+  )
+}
+it('should call function when user clicks outside container', () => {
+  const mockFunction = jest.fn()
+  const {getByText} = render(<Component callback={mockFunction} />)
+  userEvent.click(getByText('button'))
+  expect(mockFunction).toHaveBeenCalledTimes(1)
+})
+
+it('should not call function when user right clicks', () => {
+  const mockFunction = jest.fn()
+  const {getByText} = render(<Component callback={mockFunction} />)
+  userEvent.click(getByText('button'), {button: 1})
+  expect(mockFunction).toHaveBeenCalledTimes(0)
+})
+
+it('should not call function when clicking on ignored refs', () => {
+  const mockFunction = jest.fn()
+  const {getByText} = render(<Component callback={mockFunction} />)
+  userEvent.click(getByText('button two'))
+  expect(mockFunction).toHaveBeenCalledTimes(0)
+})
+
+it('should not call function when clicking inside container', () => {
+  const mockFunction = jest.fn()
+  const {getByText} = render(<Component callback={mockFunction} />)
+  userEvent.click(getByText('content'))
+  expect(mockFunction).toHaveBeenCalledTimes(0)
+})

package/src/__tests__/hooks/useOpenAndCloseFocus.tsx

@@ -0,0 +1,48 @@
+import React, {useRef} from 'react'
+import {render, waitFor} from '@testing-library/react'
+import {useOpenAndCloseFocus} from '../../hooks/useOpenAndCloseFocus'
+
+const Component = () => {
+  const containerRef = useRef<HTMLDivElement>(null)
+  const returnFocusRef = useRef<HTMLButtonElement>(null)
+  const noButtonRef = useRef<HTMLButtonElement>(null)
+  useOpenAndCloseFocus({containerRef, initialFocusRef: noButtonRef, returnFocusRef})
+  return (
+    <>
+      <button ref={returnFocusRef}>trigger</button>
+      <div ref={containerRef}>
+        <button>yes</button>
+        <button ref={noButtonRef}>no</button>
+      </div>
+    </>
+  )
+}
+
+const ComponentTwo = () => {
+  const buttonRef = useRef<HTMLButtonElement>(null)
+  const containerRef = useRef<HTMLDivElement>(null)
+  useOpenAndCloseFocus({containerRef, returnFocusRef: buttonRef})
+  return (
+    <>
+      <button ref={buttonRef}>button trigger</button>
+      <div ref={containerRef}>
+        <button>yes</button>
+        <button>no</button>
+      </div>
+    </>
+  )
+}
+
+it('should focus element passed into function', async () => {
+  const {getByText} = render(<Component />)
+  await waitFor(() => getByText('no'))
+  const noButton = getByText('no')
+  expect(document.activeElement).toEqual(noButton)
+})
+
+it('should focus first element when nothing is passed', async () => {
+  const {getByText} = render(<ComponentTwo />)
+  await waitFor(() => getByText('yes'))
+  const yesButton = getByText('yes')
+  expect(document.activeElement).toEqual(yesButton)
+})

package/src/__tests__/hooks/useProvidedStateOrCreate.tsx

@@ -0,0 +1,39 @@
+import {useProvidedStateOrCreate} from '../../hooks/useProvidedStateOrCreate'
+import {render} from '@testing-library/react'
+import React, {useState} from 'react'
+
+it('will use the provided state', () => {
+  const Component = () => {
+    const [state, setState] = useState('foo')
+    const [combinedState] = useProvidedStateOrCreate(state, setState, 'bar')
+    return <div>{combinedState}</div>
+  }
+
+  const doc = render(<Component />)
+  expect(doc.baseElement.textContent).toEqual('foo')
+})
+
+it('will set state correctly when provided a set state method', () => {
+  const Component = () => {
+    const [state, setState] = useState('foo')
+    const [combinedState, setCombinedState] = useProvidedStateOrCreate(state, setState, 'bar')
+    if (combinedState !== 'baz') setCombinedState('baz')
+    return <div>{combinedState}</div>
+  }
+
+  const doc = render(<Component />)
+  expect(doc.baseElement.textContent).toEqual('baz')
+})
+
+it('if not provided a state, will use an internal state', () => {
+  const Component = () => {
+    const state = undefined
+    const setState = undefined
+    const [combinedState, setCombinedState] = useProvidedStateOrCreate(state, setState, '')
+    if (combinedState !== 'bar') setCombinedState('bar')
+    return <div>{combinedState}</div>
+  }
+
+  const doc = render(<Component />)
+  expect(doc.baseElement.textContent).toEqual('bar')
+})

package/src/__tests__/theme.ts

@@ -0,0 +1,41 @@
+import {isShadowValue} from '../utils/theme'
+
+describe('isShadowValue', () => {
+  it('accepts transparent', () => {
+    expect(isShadowValue('0 0 0 transparent')).toBe(true)
+  })
+
+  it('accepts hex colors', () => {
+    expect(isShadowValue('0 0 0 #ff0000')).toBe(true)
+    expect(isShadowValue('0 0 0 #ff0')).toBe(true)
+  })
+
+  it('accepts rgba colors', () => {
+    expect(isShadowValue('0 0 0 rgb(255, 0, 0)')).toBe(true)
+    expect(isShadowValue('0 0 0 rgba(255,0,0,0.2)')).toBe(true)
+  })
+
+  it('accepts px values', () => {
+    expect(isShadowValue('12px 24px 0 #000')).toBe(true)
+  })
+
+  it('accepts em values', () => {
+    expect(isShadowValue('0.5em 1em 0 #000')).toBe(true)
+  })
+
+  it('accepts inset values', () => {
+    expect(isShadowValue('inset 12px 24px 0 #000')).toBe(true)
+  })
+
+  it('rejects individual colors', () => {
+    expect(isShadowValue('red')).toBe(false)
+    expect(isShadowValue('#f00')).toBe(false)
+    expect(isShadowValue('rgb(255, 0, 0)')).toBe(false)
+  })
+
+  it('rejects individual numeric values', () => {
+    expect(isShadowValue('0')).toBe(false)
+    expect(isShadowValue('12px')).toBe(false)
+    expect(isShadowValue('0.5em')).toBe(false)
+  })
+})

package/src/__tests__/themeGet.ts

@@ -0,0 +1,15 @@
+import {themeGet} from '..'
+
+describe('themeGet', () => {
+  it('acccepts theme prop', () => {
+    expect(themeGet('example')({theme: {example: 'test'}})).toBe('test')
+  })
+
+  it('allows theme prop to override primer theme', () => {
+    expect(themeGet('colors.gray.0')({theme: {colors: {gray: ['#f00']}}})).toBe('#f00')
+  })
+
+  it('uses primer theme as fallback', () => {
+    expect(themeGet('space.1')({})).toBe('4px')
+  })
+})

package/src/__tests__/useSafeTimeout.tsx

@@ -0,0 +1,36 @@
+import {renderHook} from '@testing-library/react-hooks'
+import useSafeTimeout from '../hooks/useSafeTimeout'
+
+afterEach(() => {
+  jest.useRealTimers()
+})
+
+test('should call callback after time', async () => {
+  const {result, waitFor} = renderHook(() => useSafeTimeout())
+  const mockFunction = jest.fn()
+  result.current.safeSetTimeout(mockFunction, 300)
+  await waitFor(() => expect(mockFunction).toHaveBeenCalled())
+})
+
+test('should clear timeouts when safeClearTimeout is called', () => {
+  jest.useFakeTimers()
+  jest.spyOn(global, 'clearTimeout')
+  const {result} = renderHook(() => useSafeTimeout())
+  const mockFunction = jest.fn()
+  const timeoutId = result.current.safeSetTimeout(mockFunction, 300)
+  result.current.safeClearTimeout(timeoutId)
+  expect(clearTimeout).toHaveBeenCalledTimes(1)
+  expect(clearTimeout).toHaveBeenLastCalledWith(timeoutId)
+})
+
+test('should clear timeouts when the component is unmounted', () => {
+  jest.useFakeTimers()
+  jest.spyOn(global, 'clearTimeout')
+  const {result, unmount} = renderHook(() => useSafeTimeout())
+  const mockFunction = jest.fn()
+  const timeoutId = result.current.safeSetTimeout(mockFunction, 300)
+
+  unmount()
+  expect(clearTimeout).toHaveBeenCalledTimes(1)
+  expect(clearTimeout).toHaveBeenLastCalledWith(timeoutId)
+})

package/src/behaviors/anchoredPosition.ts

@@ -0,0 +1,442 @@
+export type AnchorAlignment = 'start' | 'center' | 'end'
+
+// When prettier supports template literal types...
+// export type AnchorSide = `${'inside' | 'outside'}-${'top' | 'bottom' | 'right' | 'left'}` | 'inside-center'
+export type AnchorSide =
+  | 'inside-top'
+  | 'inside-bottom'
+  | 'inside-left'
+  | 'inside-right'
+  | 'inside-center'
+  | 'outside-top'
+  | 'outside-bottom'
+  | 'outside-left'
+  | 'outside-right'
+
+/**
+ * Settings that customize how a floating element is positioned
+ * with respect to an anchor element.
+ */
+export interface PositionSettings {
+  /**
+   * Sets the side of the anchor element that the floating element should be
+   * pinned to. This side is given by a string starting with either "inside" or
+   * "outside", followed by a hyphen, followed by either "top", "right", "bottom",
+   * or "left". Additionally, "inside-center" is an allowed value.
+   *
+   * The first part of this string, "inside" or "outside", determines whether the
+   * floating element should be attempted to be placed "inside" the anchor element
+   * or "outside" of it. Using "inside" is useful for making it appear that the
+   * anchor _contains_ the floating element, and it can be used for implementing a
+   * dialog that is centered on the screen. The "outside" value is more common and
+   * can be used for tooltips, popovers, menus, etc.
+   *
+   * The second part of this string determines the _edge_ on the anchor element that
+   * the floating element will be anchored to. If side is "inside-center", then
+   * the floating element will be centered in the X-direction (while align is used
+   * to position it in the Y-direction).
+   * Note: "outside-center" is _not_ a valid value for this property.
+   */
+  side: AnchorSide
+
+  /**
+   * Determines how the floating element should align with the anchor element. If
+   * set to "start", the floating element's first edge (top or left) will align
+   * with the anchor element's first edge. If set to "center", the floating
+   * element will be centered along the axis of the anchor edge. If set to "end",
+   * the floating element's last edge will align with the anchor element's last edge.
+   */
+  align: AnchorAlignment
+
+  /**
+   * The number of pixels between the anchor edge and the floating element.
+   *
+   * Positive values move the floating element farther from the anchor element
+   * (for outside positioning) or further inside the anchor element (for inside
+   * positioning). Negative values have the opposite effect.
+   */
+  anchorOffset: number
+
+  /**
+   * An additional offset, in pixels, to move the floating element from
+   * the aligning edge.
+   *
+   * Positive values move the floating element in the direction of center-
+   * alignment. Negative values move the floating element away from center-
+   * alignment. When align is "center", positive offsets move the floating
+   * element right (top or bottom anchor side) or down (left or right
+   * anchor side).
+   */
+  alignmentOffset: number
+
+  /**
+   * If false, when the above settings result in rendering the floating element
+   * wholly or partially outside of the bounds of the containing element, attempt
+   * to adjust the settings to prevent this. Only applies to "outside" positioning.
+   *
+   * First, attempt to flip to the opposite edge of the anchor if the floating
+   * element is getting clipped in that direction. If flipping results in a
+   * similar clipping, try moving to the adjacent sides.
+   *
+   * Once we find a side that does not clip the overlay in its own dimension,
+   * check the rest of the sides to see if we need to adjust the alignment offset
+   * to fit in other dimensions.
+   *
+   * If we try all four sides and get clipped each time, settle for overflowing
+   * and use the "bottom" side, since the ability to scroll is most likely in
+   * this direction.
+   */
+  allowOutOfBounds: boolean
+}
+
+// For each outside anchor position, list the order of alternate positions to try in
+// the event that the original position overflows. See comment on `allowOutOfBounds`
+// for a more detailed description.
+const alternateOrders: Partial<Record<AnchorSide, [AnchorSide, AnchorSide, AnchorSide, AnchorSide]>> = {
+  'outside-top': ['outside-bottom', 'outside-right', 'outside-left', 'outside-bottom'],
+  'outside-bottom': ['outside-top', 'outside-right', 'outside-left', 'outside-bottom'],
+  'outside-left': ['outside-right', 'outside-bottom', 'outside-top', 'outside-bottom'],
+  'outside-right': ['outside-left', 'outside-bottom', 'outside-top', 'outside-bottom']
+}
+
+interface Size {
+  width: number
+  height: number
+}
+
+interface Position {
+  top: number
+  left: number
+}
+
+export interface AnchorPosition {
+  top: number
+  left: number
+  anchorSide: AnchorSide
+}
+
+interface BoxPosition extends Size, Position {}
+
+/**
+ * Given a floating element and an anchor element, return coordinates for the top-left
+ * of the floating element in order to absolutely position it such that it appears
+ * near the anchor element.
+ *
+ * @param floatingElement Element intended to be positioned near or within an anchor
+ * @param anchorElement The element to serve as the position anchor
+ * @param settings Settings to determine the rules for positioning the floating element
+ * @returns {top: number, left: number} coordinates for the floating element
+ */
+export function getAnchoredPosition(
+  floatingElement: Element,
+  anchorElement: Element | DOMRect,
+  settings: Partial<PositionSettings> = {}
+): AnchorPosition {
+  const parentElement = getPositionedParent(floatingElement)
+  const clippingRect = getClippingRect(parentElement)
+
+  const parentElementStyle = getComputedStyle(parentElement)
+  const parentElementRect = parentElement.getBoundingClientRect()
+  const [borderTop, borderLeft] = [parentElementStyle.borderTopWidth, parentElementStyle.borderLeftWidth].map(
+    v => parseInt(v, 10) || 0
+  )
+  const relativeRect = {
+    top: parentElementRect.top + borderTop,
+    left: parentElementRect.left + borderLeft
+  }
+
+  return pureCalculateAnchoredPosition(
+    clippingRect,
+    relativeRect,
+    floatingElement.getBoundingClientRect(),
+    anchorElement instanceof Element ? anchorElement.getBoundingClientRect() : anchorElement,
+    getDefaultSettings(settings)
+  )
+}
+
+/**
+ * Returns the nearest proper HTMLElement parent of `element` whose
+ * position is not "static", or document.body, whichever is closer
+ */
+function getPositionedParent(element: Element) {
+  let parentNode = element.parentNode
+  while (parentNode !== null) {
+    if (parentNode instanceof HTMLElement && getComputedStyle(parentNode).position !== 'static') {
+      return parentNode
+    }
+    parentNode = parentNode.parentNode
+  }
+  return document.body
+}
+
+/**
+ * Returns the rectangle (relative to the window) that will clip the given element
+ * if it is rendered outside of its bounds.
+ * @param element
+ * @returns
+ */
+function getClippingRect(element: Element): BoxPosition {
+  let parentNode: typeof element.parentNode = element
+  while (parentNode !== null) {
+    if (parentNode === document.body) {
+      break
+    }
+    const parentNodeStyle = getComputedStyle(parentNode as Element)
+    if (parentNodeStyle.overflow !== 'visible') {
+      break
+    }
+    parentNode = parentNode.parentNode
+  }
+  const clippingNode = parentNode === document.body || !(parentNode instanceof HTMLElement) ? document.body : parentNode
+
+  const elemRect = clippingNode.getBoundingClientRect()
+  const elemStyle = getComputedStyle(clippingNode)
+
+  const [borderTop, borderLeft, borderRight, borderBottom] = [
+    elemStyle.borderTopWidth,
+    elemStyle.borderLeftWidth,
+    elemStyle.borderRightWidth,
+    elemStyle.borderBottomWidth
+  ].map(v => parseInt(v, 10) || 0)
+
+  return {
+    top: elemRect.top + borderTop,
+    left: elemRect.left + borderLeft,
+    width: elemRect.width - borderRight - borderLeft,
+
+    // If the clipping node is document.body, it can expand to the full height of the window
+    height: Math.max(
+      elemRect.height - borderTop - borderBottom,
+      clippingNode === document.body ? window.innerHeight : -Infinity
+    )
+  }
+}
+
+// Default settings to position a floating element
+const positionDefaults: PositionSettings = {
+  side: 'outside-bottom',
+  align: 'start',
+
+  // note: the following default is not applied if side === "inside-center"
+  anchorOffset: 4,
+
+  // note: the following default is only applied if side starts with "inside"
+  // and align is not center
+  alignmentOffset: 4,
+
+  allowOutOfBounds: false
+}
+
+/**
+ * Compute a full PositionSettings object from the given partial PositionSettings object
+ * by filling in with defaults where applicable.
+ * @param settings Partial settings - any omissions will be defaulted
+ */
+function getDefaultSettings(settings: Partial<PositionSettings> = {}): PositionSettings {
+  const side = settings.side ?? positionDefaults.side
+  const align = settings.align ?? positionDefaults.align
+  return {
+    side,
+    align,
+    // offsets always default to 0 if their respective side/alignment is centered
+    anchorOffset: settings.anchorOffset ?? (side === 'inside-center' ? 0 : positionDefaults.anchorOffset),
+    alignmentOffset:
+      settings.alignmentOffset ??
+      (align !== 'center' && side.startsWith('inside') ? positionDefaults.alignmentOffset : 0),
+    allowOutOfBounds: settings.allowOutOfBounds ?? positionDefaults.allowOutOfBounds
+  }
+}
+
+/**
+ * Note: This is a pure function with no dependency on DOM APIs.
+ * @see getAnchoredPosition
+ * @see getDefaultSettings
+ * @param viewportRect BoxPosition for the rectangle that will clip the floating element if it is
+ *   rendered outside of the boundsof the rectangle.
+ * @param relativePosition Position for the closest positioned proper parent of the floating element
+ * @param floatingRect WidthAndHeight for the floating element
+ * @param anchorRect BoxPosition for the anchor element
+ * @param PositionSettings to customize the calculated position for the floating element.
+ */
+function pureCalculateAnchoredPosition(
+  viewportRect: BoxPosition,
+  relativePosition: Position,
+  floatingRect: Size,
+  anchorRect: BoxPosition,
+  {side, align, allowOutOfBounds, anchorOffset, alignmentOffset}: PositionSettings
+): AnchorPosition {
+  // Compute the relative viewport rect, to bring it into the same coordinate space as `pos`
+  const relativeViewportRect: BoxPosition = {
+    top: viewportRect.top - relativePosition.top,
+    left: viewportRect.left - relativePosition.left,
+    width: viewportRect.width,
+    height: viewportRect.height
+  }
+
+  let pos = calculatePosition(floatingRect, anchorRect, side, align, anchorOffset, alignmentOffset)
+  let anchorSide = side
+  pos.top -= relativePosition.top
+  pos.left -= relativePosition.left
+
+  // Handle screen overflow
+  if (!allowOutOfBounds) {
+    const alternateOrder = alternateOrders[side]
+    let positionAttempt = 0
+    if (alternateOrder) {
+      let prevSide = side
+
+      // Try all the alternate sides until one does not overflow
+      while (
+        positionAttempt < alternateOrder.length &&
+        shouldRecalculatePosition(prevSide, pos, relativeViewportRect, floatingRect)
+      ) {
+        const nextSide = alternateOrder[positionAttempt++]
+        prevSide = nextSide
+
+        // If we have cut off in the same dimension as the "side" option, try flipping to the opposite side.
+        pos = calculatePosition(floatingRect, anchorRect, nextSide, align, anchorOffset, alignmentOffset)
+        pos.top -= relativePosition.top
+        pos.left -= relativePosition.left
+        anchorSide = nextSide
+      }
+    }
+    // At this point we've flipped the position if applicable. Now just nudge until it's on-screen.
+    if (pos.top < relativeViewportRect.top) {
+      pos.top = relativeViewportRect.top
+    }
+    if (pos.left < relativeViewportRect.left) {
+      pos.left = relativeViewportRect.left
+    }
+    if (pos.left + floatingRect.width > viewportRect.width + relativeViewportRect.left) {
+      pos.left = viewportRect.width + relativeViewportRect.left - floatingRect.width
+    }
+    // If we have exhausted all possible positions and none of them worked, we
+    // say that overflowing the bottom of the screen is acceptable since it is
+    // likely to be able to scroll.
+    if (alternateOrder && positionAttempt < alternateOrder.length) {
+      if (pos.top + floatingRect.height > viewportRect.height + relativeViewportRect.top) {
+        pos.top = viewportRect.height + relativeViewportRect.top - floatingRect.height
+      }
+    }
+  }
+
+  return {...pos, anchorSide}
+}
+
+/**
+ * Given a floating element and an anchor element, return coordinates for the
+ * top-left of the floating element in order to absolutely position it such
+ * that it appears near the anchor element.
+ *
+ * @param elementDimensions Dimensions of the floating element
+ * @param anchorPosition Position of the anchor element
+ * @param side Side of the anchor to position the floating element
+ * @param align How to align the floating element with the anchor element
+ * @param anchorOffset Absolute pixel offset for anchor positioning
+ * @param alignmentOffset Absolute pixel offset for alignment
+ * @returns {top: number, left: number} coordinates for the floating element
+ */
+function calculatePosition(
+  elementDimensions: Size,
+  anchorPosition: BoxPosition,
+  side: AnchorSide,
+  align: AnchorAlignment,
+  anchorOffset: number,
+  alignmentOffset: number
+) {
+  const anchorRight = anchorPosition.left + anchorPosition.width
+  const anchorBottom = anchorPosition.top + anchorPosition.height
+  let top = -1
+  let left = -1
+  if (side === 'outside-top') {
+    top = anchorPosition.top - anchorOffset - elementDimensions.height
+  } else if (side === 'outside-bottom') {
+    top = anchorBottom + anchorOffset
+  } else if (side === 'outside-left') {
+    left = anchorPosition.left - anchorOffset - elementDimensions.width
+  } else if (side === 'outside-right') {
+    left = anchorRight + anchorOffset
+  }
+
+  if (side === 'outside-top' || side === 'outside-bottom') {
+    if (align === 'start') {
+      left = anchorPosition.left + alignmentOffset
+    } else if (align === 'center') {
+      left = anchorPosition.left - (elementDimensions.width - anchorPosition.width) / 2 + alignmentOffset
+    } else {
+      // end
+      left = anchorRight - elementDimensions.width - alignmentOffset
+    }
+  }
+
+  if (side === 'outside-left' || side === 'outside-right') {
+    if (align === 'start') {
+      top = anchorPosition.top + alignmentOffset
+    } else if (align === 'center') {
+      top = anchorPosition.top - (elementDimensions.height - anchorPosition.height) / 2 + alignmentOffset
+    } else {
+      // end
+      top = anchorBottom - elementDimensions.height - alignmentOffset
+    }
+  }
+
+  if (side === 'inside-top') {
+    top = anchorPosition.top + anchorOffset
+  } else if (side === 'inside-bottom') {
+    top = anchorBottom - anchorOffset - elementDimensions.height
+  } else if (side === 'inside-left') {
+    left = anchorPosition.left + anchorOffset
+  } else if (side === 'inside-right') {
+    left = anchorRight - anchorOffset - elementDimensions.width
+  } else if (side === 'inside-center') {
+    left = (anchorRight + anchorPosition.left) / 2 - elementDimensions.width / 2 + anchorOffset
+  }
+
+  if (side === 'inside-top' || side === 'inside-bottom') {
+    if (align === 'start') {
+      left = anchorPosition.left + alignmentOffset
+    } else if (align === 'center') {
+      left = anchorPosition.left - (elementDimensions.width - anchorPosition.width) / 2 + alignmentOffset
+    } else {
+      // end
+      left = anchorRight - elementDimensions.width - alignmentOffset
+    }
+  } else if (side === 'inside-left' || side === 'inside-right' || side === 'inside-center') {
+    if (align === 'start') {
+      top = anchorPosition.top + alignmentOffset
+    } else if (align === 'center') {
+      top = anchorPosition.top - (elementDimensions.height - anchorPosition.height) / 2 + alignmentOffset
+    } else {
+      // end
+      top = anchorBottom - elementDimensions.height - alignmentOffset
+    }
+  }
+
+  return {top, left}
+}
+
+/**
+ * Determines if there is an overflow
+ * @param side
+ * @param currentPos
+ * @param containerDimensions
+ * @param elementDimensions
+ */
+function shouldRecalculatePosition(
+  side: AnchorSide,
+  currentPos: Position,
+  containerDimensions: BoxPosition,
+  elementDimensions: Size
+) {
+  if (side === 'outside-top' || side === 'outside-bottom') {
+    return (
+      currentPos.top < containerDimensions.top ||
+      currentPos.top + elementDimensions.height > containerDimensions.height + containerDimensions.top
+    )
+  } else {
+    return (
+      currentPos.left < containerDimensions.left ||
+      currentPos.left + elementDimensions.width > containerDimensions.width + containerDimensions.left
+    )
+  }
+}