@atlaskit/react-select 2.2.0 → 2.2.1

package/dist/es2019/emotion/components/internal/a11y-text.js

@@ -0,0 +1,27 @@
+import _extends from "@babel/runtime/helpers/extends";
+/**
+ * @jsxRuntime classic
+ * @jsx jsx
+ */
+import { css, jsx } from '@emotion/react';
+
+// Assistive text to describe visual elements. Hidden for sighted users.
+const styles = css({
+  width: 1,
+  height: 1,
+  padding: 0,
+  position: 'absolute',
+  zIndex: 9999,
+  border: 0,
+  clip: 'rect(1px, 1px, 1px, 1px)',
+  label: 'a11yText',
+  overflow: 'hidden',
+  userSelect: 'none',
+  // while hidden text is sitting in the DOM, it should not be selectable
+  whiteSpace: 'nowrap'
+});
+const A11yText = props => jsx("span", _extends({
+  css: styles
+  // eslint-disable-next-line @repo/internal/react/no-unsafe-spread-props
+}, props));
+export default A11yText;

package/dist/es2019/emotion/components/internal/dummy-input.js

@@ -0,0 +1,37 @@
+import _extends from "@babel/runtime/helpers/extends";
+/**
+ * @jsxRuntime classic
+ * @jsx jsx
+ */
+
+import { css, jsx } from '@emotion/react';
+import { removeProps } from '../../../utils';
+const dummyInputStyles = css({
+  width: 1,
+  padding: 0,
+  position: 'relative',
+  background: 0,
+  border: 0,
+  caretColor: 'transparent',
+  color: 'transparent',
+  // eslint-disable-next-line @atlaskit/design-system/use-tokens-typography
+  fontSize: 'inherit',
+  gridArea: '1 / 1 / 2 / 3',
+  insetInlineStart: -100,
+  label: 'dummyInput',
+  opacity: 0,
+  outline: 0,
+  transform: 'scale(.01)'
+});
+export default function DummyInput({
+  innerRef,
+  ...props
+}) {
+  // Remove animation props not meant for HTML elements
+  const filteredProps = removeProps(props, 'onExited', 'in', 'enter', 'exit', 'appear');
+  return jsx("input", _extends({
+    ref: innerRef
+  }, filteredProps, {
+    css: dummyInputStyles
+  }));
+}

package/dist/es2019/emotion/components/internal/index.js

@@ -0,0 +1,4 @@
+export { default as A11yText } from './a11y-text';
+export { default as DummyInput } from './dummy-input';
+export { default as ScrollManager } from './scroll-manager';
+export { default as RequiredInput } from './required-input';

package/dist/es2019/emotion/components/internal/notify-open-layer-observer.js

@@ -0,0 +1,16 @@
+import { useNotifyOpenLayerObserver } from '@atlaskit/layering/experimental/open-layer-observer';
+/**
+ * Functional component wrapper around `useNotifyOpenLayerObserver`.
+ *
+ * This is needed as Select is a class component, which cannot use hooks directly.
+ */
+export function NotifyOpenLayerObserver({
+  isOpen,
+  onClose
+}) {
+  useNotifyOpenLayerObserver({
+    isOpen,
+    onClose
+  });
+  return null;
+}

package/dist/es2019/emotion/components/internal/required-input.js

@@ -0,0 +1,35 @@
+/**
+ * @jsxRuntime classic
+ * @jsx jsx
+ */
+
+import { css, jsx } from '@emotion/react';
+import __noop from '@atlaskit/ds-lib/noop';
+const styles = css({
+  width: '100%',
+  position: 'absolute',
+  insetBlockEnd: 0,
+  insetInlineEnd: 0,
+  insetInlineStart: 0,
+  label: 'requiredInput',
+  opacity: 0,
+  pointerEvents: 'none'
+});
+const RequiredInput = ({
+  name,
+  onFocus
+}) => jsx("input", {
+  required: true,
+  name: name,
+  tabIndex: -1,
+  "aria-hidden": "true",
+  onFocus: onFocus,
+  css: styles
+  // Prevent `Switching from uncontrolled to controlled` error
+  ,
+  value: "",
+  onChange: __noop
+});
+
+// eslint-disable-next-line @repo/internal/react/require-jsdoc
+export default RequiredInput;

package/dist/es2019/emotion/components/internal/scroll-manager.js

@@ -0,0 +1,49 @@
+/**
+ * @jsxRuntime classic
+ * @jsx jsx
+ */
+import { Fragment } from 'react';
+import { css, jsx } from '@emotion/react';
+import useScrollCapture from './use-scroll-capture';
+import useScrollLock from './use-scroll-lock';
+const styles = css({
+  position: 'fixed',
+  insetBlockEnd: 0,
+  insetBlockStart: 0,
+  insetInlineEnd: 0,
+  insetInlineStart: 0
+});
+const blurSelectInput = event => {
+  const element = event.target;
+  return element.ownerDocument.activeElement && element.ownerDocument.activeElement.blur();
+};
+export default function ScrollManager({
+  children,
+  lockEnabled,
+  captureEnabled = true,
+  onBottomArrive,
+  onBottomLeave,
+  onTopArrive,
+  onTopLeave
+}) {
+  const setScrollCaptureTarget = useScrollCapture({
+    isEnabled: captureEnabled,
+    onBottomArrive,
+    onBottomLeave,
+    onTopArrive,
+    onTopLeave
+  });
+  const setScrollLockTarget = useScrollLock({
+    isEnabled: lockEnabled
+  });
+  const targetRef = element => {
+    setScrollCaptureTarget(element);
+    setScrollLockTarget(element);
+  };
+  return jsx(Fragment, null, lockEnabled &&
+  // eslint-disable-next-line jsx-a11y/click-events-have-key-events, jsx-a11y/no-static-element-interactions
+  jsx("div", {
+    onClick: blurSelectInput,
+    css: styles
+  }), children(targetRef));
+}

package/dist/es2019/emotion/components/internal/use-scroll-capture.js

@@ -0,0 +1,128 @@
+import { useCallback, useEffect, useRef } from 'react';
+import { supportsPassiveEvents } from '../../../utils';
+const cancelScroll = event => {
+  if (event.cancelable) {
+    event.preventDefault();
+  }
+  event.stopPropagation();
+};
+// TODO: Fill in the hook {description}.
+/**
+ * {description}.
+ */
+export default function useScrollCapture({
+  isEnabled,
+  onBottomArrive,
+  onBottomLeave,
+  onTopArrive,
+  onTopLeave
+}) {
+  const isBottom = useRef(false);
+  const isTop = useRef(false);
+  const touchStart = useRef(0);
+  const scrollTarget = useRef(null);
+  const handleEventDelta = useCallback((event, delta) => {
+    if (scrollTarget.current === null) {
+      return;
+    }
+    const {
+      scrollTop,
+      scrollHeight,
+      clientHeight
+    } = scrollTarget.current;
+    const target = scrollTarget.current;
+    const isDeltaPositive = delta > 0;
+    const availableScroll = scrollHeight - clientHeight - scrollTop;
+    let shouldCancelScroll = false;
+
+    // reset bottom/top flags
+    if (availableScroll > delta && isBottom.current) {
+      if (onBottomLeave) {
+        onBottomLeave(event);
+      }
+      isBottom.current = false;
+    }
+    if (isDeltaPositive && isTop.current) {
+      if (onTopLeave) {
+        onTopLeave(event);
+      }
+      isTop.current = false;
+    }
+
+    // bottom limit
+    if (isDeltaPositive && delta > availableScroll) {
+      if (onBottomArrive && !isBottom.current) {
+        onBottomArrive(event);
+      }
+      target.scrollTop = scrollHeight;
+      shouldCancelScroll = true;
+      isBottom.current = true;
+
+      // top limit
+    } else if (!isDeltaPositive && -delta > scrollTop) {
+      if (onTopArrive && !isTop.current) {
+        onTopArrive(event);
+      }
+      target.scrollTop = 0;
+      shouldCancelScroll = true;
+      isTop.current = true;
+    }
+
+    // cancel scroll
+    if (shouldCancelScroll) {
+      cancelScroll(event);
+    }
+  }, [onBottomArrive, onBottomLeave, onTopArrive, onTopLeave]);
+  const onWheel = useCallback(event => {
+    handleEventDelta(event, event.deltaY);
+  }, [handleEventDelta]);
+  const onTouchStart = useCallback(event => {
+    // set touch start so we can calculate touchmove delta
+    touchStart.current = event.changedTouches[0].clientY;
+  }, []);
+  const onTouchMove = useCallback(event => {
+    const deltaY = touchStart.current - event.changedTouches[0].clientY;
+    handleEventDelta(event, deltaY);
+  }, [handleEventDelta]);
+  const startListening = useCallback(el => {
+    // bail early if no element is available to attach to
+    if (!el) {
+      return;
+    }
+    const notPassive = supportsPassiveEvents ? {
+      passive: false
+    } : false;
+    // eslint-disable-next-line @repo/internal/dom-events/no-unsafe-event-listeners
+    el.addEventListener('wheel', onWheel, notPassive);
+    // eslint-disable-next-line @repo/internal/dom-events/no-unsafe-event-listeners
+    el.addEventListener('touchstart', onTouchStart, notPassive);
+    // eslint-disable-next-line @repo/internal/dom-events/no-unsafe-event-listeners
+    el.addEventListener('touchmove', onTouchMove, notPassive);
+  }, [onTouchMove, onTouchStart, onWheel]);
+  const stopListening = useCallback(el => {
+    // bail early if no element is available to detach from
+    if (!el) {
+      return;
+    }
+
+    // eslint-disable-next-line @repo/internal/dom-events/no-unsafe-event-listeners
+    el.removeEventListener('wheel', onWheel, false);
+    // eslint-disable-next-line @repo/internal/dom-events/no-unsafe-event-listeners
+    el.removeEventListener('touchstart', onTouchStart, false);
+    // eslint-disable-next-line @repo/internal/dom-events/no-unsafe-event-listeners
+    el.removeEventListener('touchmove', onTouchMove, false);
+  }, [onTouchMove, onTouchStart, onWheel]);
+  useEffect(() => {
+    if (!isEnabled) {
+      return;
+    }
+    const element = scrollTarget.current;
+    startListening(element);
+    return () => {
+      stopListening(element);
+    };
+  }, [isEnabled, startListening, stopListening]);
+  return element => {
+    scrollTarget.current = element;
+  };
+}

package/dist/es2019/emotion/components/internal/use-scroll-lock.js

@@ -0,0 +1,143 @@
+import { useCallback, useEffect, useRef } from 'react';
+const STYLE_KEYS = ['boxSizing', 'height', 'overflow', 'paddingRight', 'position'];
+const LOCK_STYLES = {
+  boxSizing: 'border-box',
+  // account for possible declaration `width: 100%;` on body
+  overflow: 'hidden',
+  position: 'relative',
+  height: '100%'
+};
+function preventTouchMove(e) {
+  e.preventDefault();
+}
+function allowTouchMove(e) {
+  e.stopPropagation();
+}
+function preventInertiaScroll() {
+  const top = this.scrollTop;
+  const totalScroll = this.scrollHeight;
+  const currentScroll = top + this.offsetHeight;
+  if (top === 0) {
+    this.scrollTop = 1;
+  } else if (currentScroll === totalScroll) {
+    this.scrollTop = top - 1;
+  }
+}
+
+// `ontouchstart` check works on most browsers
+// `maxTouchPoints` works on IE10/11 and Surface
+function isTouchDevice() {
+  // eslint-disable-next-line compat/compat
+  return 'ontouchstart' in window || navigator.maxTouchPoints;
+}
+const canUseDOM = !!(typeof window !== 'undefined' && window.document && window.document.createElement);
+let activeScrollLocks = 0;
+const listenerOptions = {
+  capture: false,
+  passive: false
+};
+
+// TODO: Fill in the hook {description}.
+/**
+ * {description}.
+ */
+export default function useScrollLock({
+  isEnabled,
+  accountForScrollbars = true
+}) {
+  const originalStyles = useRef({});
+  const scrollTarget = useRef(null);
+  const addScrollLock = useCallback(touchScrollTarget => {
+    if (!canUseDOM) {
+      return;
+    }
+    const target = document.body;
+    const targetStyle = target && target.style;
+    if (accountForScrollbars) {
+      // store any styles already applied to the body
+      STYLE_KEYS.forEach(key => {
+        const val = targetStyle && targetStyle[key];
+        originalStyles.current[key] = val;
+      });
+    }
+
+    // apply the lock styles and padding if this is the first scroll lock
+    if (accountForScrollbars && activeScrollLocks < 1) {
+      const currentPadding = parseInt(originalStyles.current.paddingRight, 10) || 0;
+      const clientWidth = document.body ? document.body.clientWidth : 0;
+      const adjustedPadding = window.innerWidth - clientWidth + currentPadding || 0;
+      Object.keys(LOCK_STYLES).forEach(key => {
+        const val = LOCK_STYLES[key];
+        if (targetStyle) {
+          targetStyle[key] = val;
+        }
+      });
+      if (targetStyle) {
+        targetStyle.paddingRight = `${adjustedPadding}px`;
+      }
+    }
+
+    // account for touch devices
+    if (target && isTouchDevice()) {
+      // Mobile Safari ignores { overflow: hidden } declaration on the body.
+      // eslint-disable-next-line @repo/internal/dom-events/no-unsafe-event-listeners
+      target.addEventListener('touchmove', preventTouchMove, listenerOptions);
+
+      // Allow scroll on provided target
+      if (touchScrollTarget) {
+        // eslint-disable-next-line @repo/internal/dom-events/no-unsafe-event-listeners
+        touchScrollTarget.addEventListener('touchstart', preventInertiaScroll, listenerOptions);
+        // eslint-disable-next-line @repo/internal/dom-events/no-unsafe-event-listeners
+        touchScrollTarget.addEventListener('touchmove', allowTouchMove, listenerOptions);
+      }
+    }
+
+    // increment active scroll locks
+    activeScrollLocks += 1;
+  }, [accountForScrollbars]);
+  const removeScrollLock = useCallback(touchScrollTarget => {
+    if (!canUseDOM) {
+      return;
+    }
+    const target = document.body;
+    const targetStyle = target && target.style;
+
+    // safely decrement active scroll locks
+    activeScrollLocks = Math.max(activeScrollLocks - 1, 0);
+
+    // reapply original body styles, if any
+    if (accountForScrollbars && activeScrollLocks < 1) {
+      STYLE_KEYS.forEach(key => {
+        const val = originalStyles.current[key];
+        if (targetStyle) {
+          targetStyle[key] = val;
+        }
+      });
+    }
+
+    // remove touch listeners
+    if (target && isTouchDevice()) {
+      // eslint-disable-next-line @repo/internal/dom-events/no-unsafe-event-listeners
+      target.removeEventListener('touchmove', preventTouchMove, listenerOptions);
+      if (touchScrollTarget) {
+        // eslint-disable-next-line @repo/internal/dom-events/no-unsafe-event-listeners
+        touchScrollTarget.removeEventListener('touchstart', preventInertiaScroll, listenerOptions);
+        // eslint-disable-next-line @repo/internal/dom-events/no-unsafe-event-listeners
+        touchScrollTarget.removeEventListener('touchmove', allowTouchMove, listenerOptions);
+      }
+    }
+  }, [accountForScrollbars]);
+  useEffect(() => {
+    if (!isEnabled) {
+      return;
+    }
+    const element = scrollTarget.current;
+    addScrollLock(element);
+    return () => {
+      removeScrollLock(element);
+    };
+  }, [isEnabled, addScrollLock, removeScrollLock]);
+  return element => {
+    scrollTarget.current = element;
+  };
+}

package/dist/es2019/emotion/components/live-region.js

@@ -0,0 +1,178 @@
+/* eslint-disable @atlaskit/platform/ensure-feature-flag-prefix */
+/**
+ * @jsxRuntime classic
+ * @jsx jsx
+ * @jsxFrag React.Fragment
+ */
+import React, { Fragment, useMemo, useRef } from 'react';
+import { jsx } from '@emotion/react';
+import { fg } from '@atlaskit/platform-feature-flags';
+import { defaultAriaLiveMessages } from '../../accessibility';
+import A11yText from './internal/a11y-text';
+
+// ==============================
+// Root Container
+// ==============================
+
+// eslint-disable-next-line @repo/internal/react/require-jsdoc
+const LiveRegion = props => {
+  const {
+    ariaSelection,
+    focusedOption,
+    focusedValue,
+    focusableOptions,
+    isFocused,
+    selectValue,
+    selectProps,
+    id,
+    isAppleDevice
+  } = props;
+  const {
+    ariaLiveMessages,
+    getOptionLabel,
+    inputValue,
+    isMulti,
+    isOptionDisabled,
+    isSearchable,
+    label,
+    menuIsOpen,
+    options,
+    screenReaderStatus,
+    tabSelectsValue,
+    isLoading
+  } = selectProps;
+  const ariaLabel = selectProps['aria-label'] || label;
+  const ariaLive = selectProps['aria-live'];
+
+  // for safari, we will use minimum support from aria-live region
+  const isA11yImprovementEnabled = fg('design_system_select-a11y-improvement') && !isAppleDevice;
+
+  // Update aria live message configuration when prop changes
+  const messages = useMemo(() => ({
+    ...defaultAriaLiveMessages,
+    ...(ariaLiveMessages || {})
+  }), [ariaLiveMessages]);
+
+  // Update aria live selected option when prop changes
+  const ariaSelected = useMemo(() => {
+    let message = '';
+    if (isA11yImprovementEnabled && menuIsOpen) {
+      // we don't need to have selected message when the menu is open
+      return '';
+    }
+    if (ariaSelection && messages.onChange) {
+      const {
+        option,
+        options: selectedOptions,
+        removedValue,
+        removedValues,
+        value
+      } = ariaSelection;
+      // select-option when !isMulti does not return option so we assume selected option is value
+      const asOption = val => !Array.isArray(val) ? val : null;
+
+      // If there is just one item from the action then get its label
+      const selected = removedValue || option || asOption(value);
+      const label = selected ? getOptionLabel(selected) : '';
+
+      // If there are multiple items from the action then return an array of labels
+      const multiSelected = selectedOptions || removedValues || undefined;
+      const labels = multiSelected ? multiSelected.map(getOptionLabel) : [];
+      if (isA11yImprovementEnabled && !label && !labels.length) {
+        // return empty string if no labels provided
+        return '';
+      }
+      const onChangeProps = {
+        // multiSelected items are usually items that have already been selected
+        // or set by the user as a default value so we assume they are not disabled
+        isDisabled: selected && isOptionDisabled(selected, selectValue),
+        label,
+        labels,
+        ...ariaSelection
+      };
+      message = messages.onChange(onChangeProps);
+    }
+    return message;
+  }, [ariaSelection, messages, isOptionDisabled, selectValue, getOptionLabel, isA11yImprovementEnabled, menuIsOpen]);
+  const prevInputValue = useRef('');
+  const ariaFocused = useMemo(() => {
+    let focusMsg = '';
+    const focused = focusedOption || focusedValue;
+    const isSelected = !!(focusedOption && selectValue && selectValue.includes(focusedOption));
+    if (inputValue === prevInputValue.current && isA11yImprovementEnabled) {
+      // only announce focus option when searching when ff is on and the input value changed
+      // for safari, we will announce for all
+      return '';
+    }
+    if (focused && messages.onFocus) {
+      const onFocusProps = {
+        focused,
+        label: getOptionLabel(focused),
+        isDisabled: isOptionDisabled(focused, selectValue),
+        isSelected,
+        options: focusableOptions,
+        context: focused === focusedOption ? 'menu' : 'value',
+        selectValue,
+        isMulti
+      };
+      focusMsg = messages.onFocus(onFocusProps);
+    }
+    prevInputValue.current = inputValue;
+    return focusMsg;
+  }, [inputValue, focusedOption, focusedValue, getOptionLabel, isOptionDisabled, messages, focusableOptions, selectValue, isA11yImprovementEnabled, isMulti]);
+  const ariaResults = useMemo(() => {
+    let resultsMsg = '';
+    if (menuIsOpen && options.length && !isLoading && messages.onFilter) {
+      const resultsMessage = screenReaderStatus({
+        count: focusableOptions.length
+      });
+      resultsMsg = messages.onFilter({
+        inputValue,
+        resultsMessage
+      });
+    }
+    return resultsMsg;
+  }, [focusableOptions, inputValue, menuIsOpen, messages, options, screenReaderStatus, isLoading]);
+  const isInitialFocus = (ariaSelection === null || ariaSelection === void 0 ? void 0 : ariaSelection.action) === 'initial-input-focus';
+  const ariaGuidance = useMemo(() => {
+    if (fg('design_system_select-a11y-improvement')) {
+      // don't announce guidance at all when ff is on
+      return '';
+    }
+    let guidanceMsg = '';
+    if (messages.guidance) {
+      const context = focusedValue ? 'value' : menuIsOpen ? 'menu' : 'input';
+      guidanceMsg = messages.guidance({
+        'aria-label': ariaLabel,
+        context,
+        isDisabled: focusedOption && isOptionDisabled(focusedOption, selectValue),
+        isMulti,
+        isSearchable,
+        tabSelectsValue,
+        isInitialFocus
+      });
+    }
+    return guidanceMsg;
+  }, [ariaLabel, focusedOption, focusedValue, isMulti, isOptionDisabled, isSearchable, menuIsOpen, messages, selectValue, tabSelectsValue, isInitialFocus]);
+  const ScreenReaderText = jsx(Fragment, null, jsx("span", {
+    id: "aria-selection"
+  }, ariaSelected), jsx("span", {
+    id: "aria-results"
+  }, ariaResults), !fg('design_system_select-a11y-improvement') && jsx(React.Fragment, null, jsx("span", {
+    id: "aria-focused"
+  }, ariaFocused), jsx("span", {
+    id: "aria-guidance"
+  }, ariaGuidance)));
+  return jsx(Fragment, null, jsx(A11yText, {
+    id: id
+  }, isInitialFocus && ScreenReaderText), jsx(A11yText, {
+    "aria-live": ariaLive // Should be undefined by default unless a specific use case requires it
+    ,
+    "aria-atomic": fg('design_system_select-a11y-improvement') ? undefined : 'false',
+    "aria-relevant": fg('design_system_select-a11y-improvement') ? undefined : 'additions text',
+    role: fg('design_system_select-a11y-improvement') ? 'status' : 'log'
+  }, isFocused && !isInitialFocus && ScreenReaderText));
+};
+
+// eslint-disable-next-line @repo/internal/react/require-jsdoc
+export default LiveRegion;