focus-trap 6.6.1 → 6.7.3

package/dist/focus-trap.min.js.map

@@ -1 +1 @@
-{"version":3,"file":"focus-trap.min.js","sources":["../index.js"],"sourcesContent":["import { tabbable, isFocusable } from 'tabbable';\n\nconst activeFocusTraps = (function () {\n  const trapQueue = [];\n  return {\n    activateTrap(trap) {\n      if (trapQueue.length > 0) {\n        const activeTrap = trapQueue[trapQueue.length - 1];\n        if (activeTrap !== trap) {\n          activeTrap.pause();\n        }\n      }\n\n      const trapIndex = trapQueue.indexOf(trap);\n      if (trapIndex === -1) {\n        trapQueue.push(trap);\n      } else {\n        // move this existing trap to the front of the queue\n        trapQueue.splice(trapIndex, 1);\n        trapQueue.push(trap);\n      }\n    },\n\n    deactivateTrap(trap) {\n      const trapIndex = trapQueue.indexOf(trap);\n      if (trapIndex !== -1) {\n        trapQueue.splice(trapIndex, 1);\n      }\n\n      if (trapQueue.length > 0) {\n        trapQueue[trapQueue.length - 1].unpause();\n      }\n    },\n  };\n})();\n\nconst isSelectableInput = function (node) {\n  return (\n    node.tagName &&\n    node.tagName.toLowerCase() === 'input' &&\n    typeof node.select === 'function'\n  );\n};\n\nconst isEscapeEvent = function (e) {\n  return e.key === 'Escape' || e.key === 'Esc' || e.keyCode === 27;\n};\n\nconst isTabEvent = function (e) {\n  return e.key === 'Tab' || e.keyCode === 9;\n};\n\nconst delay = function (fn) {\n  return setTimeout(fn, 0);\n};\n\n// Array.find/findIndex() are not supported on IE; this replicates enough\n//  of Array.findIndex() for our needs\nconst findIndex = function (arr, fn) {\n  let idx = -1;\n\n  arr.every(function (value, i) {\n    if (fn(value)) {\n      idx = i;\n      return false; // break\n    }\n\n    return true; // next\n  });\n\n  return idx;\n};\n\n/**\n * Get an option's value when it could be a plain value, or a handler that provides\n *  the value.\n * @param {*} value Option's value to check.\n * @param {...*} [params] Any parameters to pass to the handler, if `value` is a function.\n * @returns {*} The `value`, or the handler's returned value.\n */\nconst valueOrHandler = function (value, ...params) {\n  return typeof value === 'function' ? value(...params) : value;\n};\n\nconst createFocusTrap = function (elements, userOptions) {\n  const doc = document;\n\n  const config = {\n    returnFocusOnDeactivate: true,\n    escapeDeactivates: true,\n    delayInitialFocus: true,\n    ...userOptions,\n  };\n\n  const state = {\n    // @type {Array<HTMLElement>}\n    containers: [],\n\n    // list of objects identifying the first and last tabbable nodes in all containers/groups in\n    //  the trap\n    // NOTE: it's possible that a group has no tabbable nodes if nodes get removed while the trap\n    //  is active, but the trap should never get to a state where there isn't at least one group\n    //  with at least one tabbable node in it (that would lead to an error condition that would\n    //  result in an error being thrown)\n    // @type {Array<{ container: HTMLElement, firstTabbableNode: HTMLElement|null, lastTabbableNode: HTMLElement|null }>}\n    tabbableGroups: [],\n\n    nodeFocusedBeforeActivation: null,\n    mostRecentlyFocusedNode: null,\n    active: false,\n    paused: false,\n\n    // timer ID for when delayInitialFocus is true and initial focus in this trap\n    //  has been delayed during activation\n    delayInitialFocusTimer: undefined,\n  };\n\n  let trap; // eslint-disable-line prefer-const -- some private functions reference it, and its methods reference private functions, so we must declare here and define later\n\n  const getOption = (configOverrideOptions, optionName, configOptionName) => {\n    return configOverrideOptions &&\n      configOverrideOptions[optionName] !== undefined\n      ? configOverrideOptions[optionName]\n      : config[configOptionName || optionName];\n  };\n\n  const containersContain = function (element) {\n    return state.containers.some((container) => container.contains(element));\n  };\n\n  const getNodeForOption = function (optionName) {\n    const optionValue = config[optionName];\n    if (!optionValue) {\n      return null;\n    }\n\n    let node = optionValue;\n\n    if (typeof optionValue === 'string') {\n      node = doc.querySelector(optionValue);\n      if (!node) {\n        throw new Error(`\\`${optionName}\\` refers to no known node`);\n      }\n    }\n\n    if (typeof optionValue === 'function') {\n      node = optionValue();\n      if (!node) {\n        throw new Error(`\\`${optionName}\\` did not return a node`);\n      }\n    }\n\n    return node;\n  };\n\n  const getInitialFocusNode = function () {\n    let node;\n\n    // false indicates we want no initialFocus at all\n    if (getOption({}, 'initialFocus') === false) {\n      return false;\n    }\n\n    if (getNodeForOption('initialFocus') !== null) {\n      node = getNodeForOption('initialFocus');\n    } else if (containersContain(doc.activeElement)) {\n      node = doc.activeElement;\n    } else {\n      const firstTabbableGroup = state.tabbableGroups[0];\n      const firstTabbableNode =\n        firstTabbableGroup && firstTabbableGroup.firstTabbableNode;\n      node = firstTabbableNode || getNodeForOption('fallbackFocus');\n    }\n\n    if (!node) {\n      throw new Error(\n        'Your focus-trap needs to have at least one focusable element'\n      );\n    }\n\n    return node;\n  };\n\n  const updateTabbableNodes = function () {\n    state.tabbableGroups = state.containers\n      .map((container) => {\n        const tabbableNodes = tabbable(container);\n\n        if (tabbableNodes.length > 0) {\n          return {\n            container,\n            firstTabbableNode: tabbableNodes[0],\n            lastTabbableNode: tabbableNodes[tabbableNodes.length - 1],\n          };\n        }\n\n        return undefined;\n      })\n      .filter((group) => !!group); // remove groups with no tabbable nodes\n\n    // throw if no groups have tabbable nodes and we don't have a fallback focus node either\n    if (\n      state.tabbableGroups.length <= 0 &&\n      !getNodeForOption('fallbackFocus')\n    ) {\n      throw new Error(\n        'Your focus-trap must have at least one container with at least one tabbable node in it at all times'\n      );\n    }\n  };\n\n  const tryFocus = function (node) {\n    if (node === false) {\n      return;\n    }\n\n    if (node === doc.activeElement) {\n      return;\n    }\n\n    if (!node || !node.focus) {\n      tryFocus(getInitialFocusNode());\n      return;\n    }\n\n    node.focus({ preventScroll: !!config.preventScroll });\n    state.mostRecentlyFocusedNode = node;\n\n    if (isSelectableInput(node)) {\n      node.select();\n    }\n  };\n\n  const getReturnFocusNode = function (previousActiveElement) {\n    const node = getNodeForOption('setReturnFocus');\n\n    return node ? node : previousActiveElement;\n  };\n\n  // This needs to be done on mousedown and touchstart instead of click\n  // so that it precedes the focus event.\n  const checkPointerDown = function (e) {\n    if (containersContain(e.target)) {\n      // allow the click since it ocurred inside the trap\n      return;\n    }\n\n    if (valueOrHandler(config.clickOutsideDeactivates, e)) {\n      // immediately deactivate the trap\n      trap.deactivate({\n        // if, on deactivation, we should return focus to the node originally-focused\n        //  when the trap was activated (or the configured `setReturnFocus` node),\n        //  then assume it's also OK to return focus to the outside node that was\n        //  just clicked, causing deactivation, as long as that node is focusable;\n        //  if it isn't focusable, then return focus to the original node focused\n        //  on activation (or the configured `setReturnFocus` node)\n        // NOTE: by setting `returnFocus: false`, deactivate() will do nothing,\n        //  which will result in the outside click setting focus to the node\n        //  that was clicked, whether it's focusable or not; by setting\n        //  `returnFocus: true`, we'll attempt to re-focus the node originally-focused\n        //  on activation (or the configured `setReturnFocus` node)\n        returnFocus: config.returnFocusOnDeactivate && !isFocusable(e.target),\n      });\n      return;\n    }\n\n    // This is needed for mobile devices.\n    // (If we'll only let `click` events through,\n    // then on mobile they will be blocked anyways if `touchstart` is blocked.)\n    if (valueOrHandler(config.allowOutsideClick, e)) {\n      // allow the click outside the trap to take place\n      return;\n    }\n\n    // otherwise, prevent the click\n    e.preventDefault();\n  };\n\n  // In case focus escapes the trap for some strange reason, pull it back in.\n  const checkFocusIn = function (e) {\n    const targetContained = containersContain(e.target);\n    // In Firefox when you Tab out of an iframe the Document is briefly focused.\n    if (targetContained || e.target instanceof Document) {\n      if (targetContained) {\n        state.mostRecentlyFocusedNode = e.target;\n      }\n    } else {\n      // escaped! pull it back in to where it just left\n      e.stopImmediatePropagation();\n      tryFocus(state.mostRecentlyFocusedNode || getInitialFocusNode());\n    }\n  };\n\n  // Hijack Tab events on the first and last focusable nodes of the trap,\n  // in order to prevent focus from escaping. If it escapes for even a\n  // moment it can end up scrolling the page and causing confusion so we\n  // kind of need to capture the action at the keydown phase.\n  const checkTab = function (e) {\n    updateTabbableNodes();\n\n    let destinationNode = null;\n\n    if (state.tabbableGroups.length > 0) {\n      // make sure the target is actually contained in a group\n      // NOTE: the target may also be the container itself if it's tabbable\n      //  with tabIndex='-1' and was given initial focus\n      const containerIndex = findIndex(state.tabbableGroups, ({ container }) =>\n        container.contains(e.target)\n      );\n\n      if (containerIndex < 0) {\n        // target not found in any group: quite possible focus has escaped the trap,\n        //  so bring it back in to...\n        if (e.shiftKey) {\n          // ...the last node in the last group\n          destinationNode =\n            state.tabbableGroups[state.tabbableGroups.length - 1]\n              .lastTabbableNode;\n        } else {\n          // ...the first node in the first group\n          destinationNode = state.tabbableGroups[0].firstTabbableNode;\n        }\n      } else if (e.shiftKey) {\n        // REVERSE\n\n        // is the target the first tabbable node in a group?\n        let startOfGroupIndex = findIndex(\n          state.tabbableGroups,\n          ({ firstTabbableNode }) => e.target === firstTabbableNode\n        );\n\n        if (\n          startOfGroupIndex < 0 &&\n          state.tabbableGroups[containerIndex].container === e.target\n        ) {\n          // an exception case where the target is the container itself, in which\n          //  case, we should handle shift+tab as if focus were on the container's\n          //  first tabbable node, and go to the last tabbable node of the LAST group\n          startOfGroupIndex = containerIndex;\n        }\n\n        if (startOfGroupIndex >= 0) {\n          // YES: then shift+tab should go to the last tabbable node in the\n          //  previous group (and wrap around to the last tabbable node of\n          //  the LAST group if it's the first tabbable node of the FIRST group)\n          const destinationGroupIndex =\n            startOfGroupIndex === 0\n              ? state.tabbableGroups.length - 1\n              : startOfGroupIndex - 1;\n\n          const destinationGroup = state.tabbableGroups[destinationGroupIndex];\n          destinationNode = destinationGroup.lastTabbableNode;\n        }\n      } else {\n        // FORWARD\n\n        // is the target the last tabbable node in a group?\n        let lastOfGroupIndex = findIndex(\n          state.tabbableGroups,\n          ({ lastTabbableNode }) => e.target === lastTabbableNode\n        );\n\n        if (\n          lastOfGroupIndex < 0 &&\n          state.tabbableGroups[containerIndex].container === e.target\n        ) {\n          // an exception case where the target is the container itself, in which\n          //  case, we should handle tab as if focus were on the container's\n          //  last tabbable node, and go to the first tabbable node of the FIRST group\n          lastOfGroupIndex = containerIndex;\n        }\n\n        if (lastOfGroupIndex >= 0) {\n          // YES: then tab should go to the first tabbable node in the next\n          //  group (and wrap around to the first tabbable node of the FIRST\n          //  group if it's the last tabbable node of the LAST group)\n          const destinationGroupIndex =\n            lastOfGroupIndex === state.tabbableGroups.length - 1\n              ? 0\n              : lastOfGroupIndex + 1;\n\n          const destinationGroup = state.tabbableGroups[destinationGroupIndex];\n          destinationNode = destinationGroup.firstTabbableNode;\n        }\n      }\n    } else {\n      destinationNode = getNodeForOption('fallbackFocus');\n    }\n\n    if (destinationNode) {\n      e.preventDefault();\n      tryFocus(destinationNode);\n    }\n    // else, let the browser take care of [shift+]tab and move the focus\n  };\n\n  const checkKey = function (e) {\n    if (\n      isEscapeEvent(e) &&\n      valueOrHandler(config.escapeDeactivates) !== false\n    ) {\n      e.preventDefault();\n      trap.deactivate();\n      return;\n    }\n\n    if (isTabEvent(e)) {\n      checkTab(e);\n      return;\n    }\n  };\n\n  const checkClick = function (e) {\n    if (valueOrHandler(config.clickOutsideDeactivates, e)) {\n      return;\n    }\n\n    if (containersContain(e.target)) {\n      return;\n    }\n\n    if (valueOrHandler(config.allowOutsideClick, e)) {\n      return;\n    }\n\n    e.preventDefault();\n    e.stopImmediatePropagation();\n  };\n\n  //\n  // EVENT LISTENERS\n  //\n\n  const addListeners = function () {\n    if (!state.active) {\n      return;\n    }\n\n    // There can be only one listening focus trap at a time\n    activeFocusTraps.activateTrap(trap);\n\n    // Delay ensures that the focused element doesn't capture the event\n    // that caused the focus trap activation.\n    state.delayInitialFocusTimer = config.delayInitialFocus\n      ? delay(function () {\n          tryFocus(getInitialFocusNode());\n        })\n      : tryFocus(getInitialFocusNode());\n\n    doc.addEventListener('focusin', checkFocusIn, true);\n    doc.addEventListener('mousedown', checkPointerDown, {\n      capture: true,\n      passive: false,\n    });\n    doc.addEventListener('touchstart', checkPointerDown, {\n      capture: true,\n      passive: false,\n    });\n    doc.addEventListener('click', checkClick, {\n      capture: true,\n      passive: false,\n    });\n    doc.addEventListener('keydown', checkKey, {\n      capture: true,\n      passive: false,\n    });\n\n    return trap;\n  };\n\n  const removeListeners = function () {\n    if (!state.active) {\n      return;\n    }\n\n    doc.removeEventListener('focusin', checkFocusIn, true);\n    doc.removeEventListener('mousedown', checkPointerDown, true);\n    doc.removeEventListener('touchstart', checkPointerDown, true);\n    doc.removeEventListener('click', checkClick, true);\n    doc.removeEventListener('keydown', checkKey, true);\n\n    return trap;\n  };\n\n  //\n  // TRAP DEFINITION\n  //\n\n  trap = {\n    activate(activateOptions) {\n      if (state.active) {\n        return this;\n      }\n\n      const onActivate = getOption(activateOptions, 'onActivate');\n      const onPostActivate = getOption(activateOptions, 'onPostActivate');\n      const checkCanFocusTrap = getOption(activateOptions, 'checkCanFocusTrap');\n\n      if (!checkCanFocusTrap) {\n        updateTabbableNodes();\n      }\n\n      state.active = true;\n      state.paused = false;\n      state.nodeFocusedBeforeActivation = doc.activeElement;\n\n      if (onActivate) {\n        onActivate();\n      }\n\n      const finishActivation = () => {\n        if (checkCanFocusTrap) {\n          updateTabbableNodes();\n        }\n        addListeners();\n        if (onPostActivate) {\n          onPostActivate();\n        }\n      };\n\n      if (checkCanFocusTrap) {\n        checkCanFocusTrap(state.containers.concat()).then(\n          finishActivation,\n          finishActivation\n        );\n        return this;\n      }\n\n      finishActivation();\n      return this;\n    },\n\n    deactivate(deactivateOptions) {\n      if (!state.active) {\n        return this;\n      }\n\n      clearTimeout(state.delayInitialFocusTimer); // noop if undefined\n      state.delayInitialFocusTimer = undefined;\n\n      removeListeners();\n      state.active = false;\n      state.paused = false;\n\n      activeFocusTraps.deactivateTrap(trap);\n\n      const onDeactivate = getOption(deactivateOptions, 'onDeactivate');\n      const onPostDeactivate = getOption(deactivateOptions, 'onPostDeactivate');\n      const checkCanReturnFocus = getOption(\n        deactivateOptions,\n        'checkCanReturnFocus'\n      );\n\n      if (onDeactivate) {\n        onDeactivate();\n      }\n\n      const returnFocus = getOption(\n        deactivateOptions,\n        'returnFocus',\n        'returnFocusOnDeactivate'\n      );\n\n      const finishDeactivation = () => {\n        delay(() => {\n          if (returnFocus) {\n            tryFocus(getReturnFocusNode(state.nodeFocusedBeforeActivation));\n          }\n          if (onPostDeactivate) {\n            onPostDeactivate();\n          }\n        });\n      };\n\n      if (returnFocus && checkCanReturnFocus) {\n        checkCanReturnFocus(\n          getReturnFocusNode(state.nodeFocusedBeforeActivation)\n        ).then(finishDeactivation, finishDeactivation);\n        return this;\n      }\n\n      finishDeactivation();\n      return this;\n    },\n\n    pause() {\n      if (state.paused || !state.active) {\n        return this;\n      }\n\n      state.paused = true;\n      removeListeners();\n\n      return this;\n    },\n\n    unpause() {\n      if (!state.paused || !state.active) {\n        return this;\n      }\n\n      state.paused = false;\n      updateTabbableNodes();\n      addListeners();\n\n      return this;\n    },\n\n    updateContainerElements(containerElements) {\n      const elementsAsArray = [].concat(containerElements).filter(Boolean);\n\n      state.containers = elementsAsArray.map((element) =>\n        typeof element === 'string' ? doc.querySelector(element) : element\n      );\n\n      if (state.active) {\n        updateTabbableNodes();\n      }\n\n      return this;\n    },\n  };\n\n  // initialize container elements\n  trap.updateContainerElements(elements);\n\n  return trap;\n};\n\nexport { createFocusTrap };\n"],"names":["trapQueue","activeFocusTraps","activateTrap","trap","length","activeTrap","pause","trapIndex","indexOf","splice","push","deactivateTrap","unpause","delay","fn","setTimeout","findIndex","arr","idx","every","value","i","valueOrHandler","params","elements","userOptions","doc","document","config","returnFocusOnDeactivate","escapeDeactivates","delayInitialFocus","state","containers","tabbableGroups","nodeFocusedBeforeActivation","mostRecentlyFocusedNode","active","paused","delayInitialFocusTimer","undefined","getOption","configOverrideOptions","optionName","configOptionName","containersContain","element","some","container","contains","getNodeForOption","optionValue","node","querySelector","Error","getInitialFocusNode","activeElement","firstTabbableGroup","firstTabbableNode","updateTabbableNodes","map","tabbableNodes","tabbable","lastTabbableNode","filter","group","tryFocus","focus","preventScroll","tagName","toLowerCase","select","isSelectableInput","getReturnFocusNode","previousActiveElement","checkPointerDown","e","target","clickOutsideDeactivates","deactivate","returnFocus","isFocusable","allowOutsideClick","preventDefault","checkFocusIn","targetContained","Document","stopImmediatePropagation","checkKey","key","keyCode","isEscapeEvent","isTabEvent","destinationNode","containerIndex","shiftKey","startOfGroupIndex","destinationGroupIndex","lastOfGroupIndex","checkTab","checkClick","addListeners","addEventListener","capture","passive","removeListeners","removeEventListener","activate","activateOptions","this","onActivate","onPostActivate","checkCanFocusTrap","finishActivation","concat","then","deactivateOptions","clearTimeout","onDeactivate","onPostDeactivate","checkCanReturnFocus","finishDeactivation","updateContainerElements","containerElements","elementsAsArray","Boolean"],"mappings":"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"}
+{"version":3,"file":"focus-trap.min.js","sources":["../index.js"],"sourcesContent":["import { tabbable, focusable, isFocusable, isTabbable } from 'tabbable';\n\nconst activeFocusTraps = (function () {\n  const trapQueue = [];\n  return {\n    activateTrap(trap) {\n      if (trapQueue.length > 0) {\n        const activeTrap = trapQueue[trapQueue.length - 1];\n        if (activeTrap !== trap) {\n          activeTrap.pause();\n        }\n      }\n\n      const trapIndex = trapQueue.indexOf(trap);\n      if (trapIndex === -1) {\n        trapQueue.push(trap);\n      } else {\n        // move this existing trap to the front of the queue\n        trapQueue.splice(trapIndex, 1);\n        trapQueue.push(trap);\n      }\n    },\n\n    deactivateTrap(trap) {\n      const trapIndex = trapQueue.indexOf(trap);\n      if (trapIndex !== -1) {\n        trapQueue.splice(trapIndex, 1);\n      }\n\n      if (trapQueue.length > 0) {\n        trapQueue[trapQueue.length - 1].unpause();\n      }\n    },\n  };\n})();\n\nconst isSelectableInput = function (node) {\n  return (\n    node.tagName &&\n    node.tagName.toLowerCase() === 'input' &&\n    typeof node.select === 'function'\n  );\n};\n\nconst isEscapeEvent = function (e) {\n  return e.key === 'Escape' || e.key === 'Esc' || e.keyCode === 27;\n};\n\nconst isTabEvent = function (e) {\n  return e.key === 'Tab' || e.keyCode === 9;\n};\n\nconst delay = function (fn) {\n  return setTimeout(fn, 0);\n};\n\n// Array.find/findIndex() are not supported on IE; this replicates enough\n//  of Array.findIndex() for our needs\nconst findIndex = function (arr, fn) {\n  let idx = -1;\n\n  arr.every(function (value, i) {\n    if (fn(value)) {\n      idx = i;\n      return false; // break\n    }\n\n    return true; // next\n  });\n\n  return idx;\n};\n\n/**\n * Get an option's value when it could be a plain value, or a handler that provides\n *  the value.\n * @param {*} value Option's value to check.\n * @param {...*} [params] Any parameters to pass to the handler, if `value` is a function.\n * @returns {*} The `value`, or the handler's returned value.\n */\nconst valueOrHandler = function (value, ...params) {\n  return typeof value === 'function' ? value(...params) : value;\n};\n\nconst getActualTarget = function (event) {\n  // NOTE: If the trap is _inside_ a shadow DOM, event.target will always be the\n  //  shadow host. However, event.target.composedPath() will be an array of\n  //  nodes \"clicked\" from inner-most (the actual element inside the shadow) to\n  //  outer-most (the host HTML document). If we have access to composedPath(),\n  //  then use its first element; otherwise, fall back to event.target (and\n  //  this only works for an _open_ shadow DOM; otherwise,\n  //  composedPath()[0] === event.target always).\n  return event.target.shadowRoot && typeof event.composedPath === 'function'\n    ? event.composedPath()[0]\n    : event.target;\n};\n\nconst createFocusTrap = function (elements, userOptions) {\n  // SSR: a live trap shouldn't be created in this type of environment so this\n  //  should be safe code to execute if the `document` option isn't specified\n  const doc = userOptions?.document || document;\n\n  const config = {\n    returnFocusOnDeactivate: true,\n    escapeDeactivates: true,\n    delayInitialFocus: true,\n    ...userOptions,\n  };\n\n  const state = {\n    // @type {Array<HTMLElement>}\n    containers: [],\n\n    // list of objects identifying the first and last tabbable nodes in all containers/groups in\n    //  the trap\n    // NOTE: it's possible that a group has no tabbable nodes if nodes get removed while the trap\n    //  is active, but the trap should never get to a state where there isn't at least one group\n    //  with at least one tabbable node in it (that would lead to an error condition that would\n    //  result in an error being thrown)\n    // @type {Array<{\n    //   container: HTMLElement,\n    //   firstTabbableNode: HTMLElement|null,\n    //   lastTabbableNode: HTMLElement|null,\n    //   nextTabbableNode: (node: HTMLElement, forward: boolean) => HTMLElement|undefined\n    // }>}\n    tabbableGroups: [],\n\n    nodeFocusedBeforeActivation: null,\n    mostRecentlyFocusedNode: null,\n    active: false,\n    paused: false,\n\n    // timer ID for when delayInitialFocus is true and initial focus in this trap\n    //  has been delayed during activation\n    delayInitialFocusTimer: undefined,\n  };\n\n  let trap; // eslint-disable-line prefer-const -- some private functions reference it, and its methods reference private functions, so we must declare here and define later\n\n  const getOption = (configOverrideOptions, optionName, configOptionName) => {\n    return configOverrideOptions &&\n      configOverrideOptions[optionName] !== undefined\n      ? configOverrideOptions[optionName]\n      : config[configOptionName || optionName];\n  };\n\n  const containersContain = function (element) {\n    return !!(\n      element &&\n      state.containers.some((container) => container.contains(element))\n    );\n  };\n\n  /**\n   * Gets the node for the given option, which is expected to be an option that\n   *  can be either a DOM node, a string that is a selector to get a node, `false`\n   *  (if a node is explicitly NOT given), or a function that returns any of these\n   *  values.\n   * @param {string} optionName\n   * @returns {undefined | false | HTMLElement | SVGElement} Returns\n   *  `undefined` if the option is not specified; `false` if the option\n   *  resolved to `false` (node explicitly not given); otherwise, the resolved\n   *  DOM node.\n   * @throws {Error} If the option is set, not `false`, and is not, or does not\n   *  resolve to a node.\n   */\n  const getNodeForOption = function (optionName, ...params) {\n    let optionValue = config[optionName];\n\n    if (typeof optionValue === 'function') {\n      optionValue = optionValue(...params);\n    }\n\n    if (!optionValue) {\n      if (optionValue === undefined || optionValue === false) {\n        return optionValue;\n      }\n      // else, empty string (invalid), null (invalid), 0 (invalid)\n\n      throw new Error(\n        `\\`${optionName}\\` was specified but was not a node, or did not return a node`\n      );\n    }\n\n    let node = optionValue; // could be HTMLElement, SVGElement, or non-empty string at this point\n\n    if (typeof optionValue === 'string') {\n      node = doc.querySelector(optionValue); // resolve to node, or null if fails\n      if (!node) {\n        throw new Error(\n          `\\`${optionName}\\` as selector refers to no known node`\n        );\n      }\n    }\n\n    return node;\n  };\n\n  const getInitialFocusNode = function () {\n    let node = getNodeForOption('initialFocus');\n\n    // false explicitly indicates we want no initialFocus at all\n    if (node === false) {\n      return false;\n    }\n\n    if (node === undefined) {\n      // option not specified: use fallback options\n      if (containersContain(doc.activeElement)) {\n        node = doc.activeElement;\n      } else {\n        const firstTabbableGroup = state.tabbableGroups[0];\n        const firstTabbableNode =\n          firstTabbableGroup && firstTabbableGroup.firstTabbableNode;\n\n        // NOTE: `fallbackFocus` option function cannot return `false` (not supported)\n        node = firstTabbableNode || getNodeForOption('fallbackFocus');\n      }\n    }\n\n    if (!node) {\n      throw new Error(\n        'Your focus-trap needs to have at least one focusable element'\n      );\n    }\n\n    return node;\n  };\n\n  const updateTabbableNodes = function () {\n    state.tabbableGroups = state.containers\n      .map((container) => {\n        const tabbableNodes = tabbable(container);\n\n        // NOTE: if we have tabbable nodes, we must have focusable nodes; focusable nodes\n        //  are a superset of tabbable nodes\n        const focusableNodes = focusable(container);\n\n        if (tabbableNodes.length > 0) {\n          return {\n            container,\n            firstTabbableNode: tabbableNodes[0],\n            lastTabbableNode: tabbableNodes[tabbableNodes.length - 1],\n\n            /**\n             * Finds the __tabbable__ node that follows the given node in the specified direction,\n             *  in this container, if any.\n             * @param {HTMLElement} node\n             * @param {boolean} [forward] True if going in forward tab order; false if going\n             *  in reverse.\n             * @returns {HTMLElement|undefined} The next tabbable node, if any.\n             */\n            nextTabbableNode(node, forward = true) {\n              // NOTE: If tabindex is positive (in order to manipulate the tab order separate\n              //  from the DOM order), this __will not work__ because the list of focusableNodes,\n              //  while it contains tabbable nodes, does not sort its nodes in any order other\n              //  than DOM order, because it can't: Where would you place focusable (but not\n              //  tabbable) nodes in that order? They have no order, because they aren't tabbale...\n              // Support for positive tabindex is already broken and hard to manage (possibly\n              //  not supportable, TBD), so this isn't going to make things worse than they\n              //  already are, and at least makes things better for the majority of cases where\n              //  tabindex is either 0/unset or negative.\n              // FYI, positive tabindex issue: https://github.com/focus-trap/focus-trap/issues/375\n              const nodeIdx = focusableNodes.findIndex((n) => n === node);\n              if (forward) {\n                return focusableNodes\n                  .slice(nodeIdx + 1)\n                  .find((n) => isTabbable(n));\n              }\n              return focusableNodes\n                .slice(0, nodeIdx)\n                .reverse()\n                .find((n) => isTabbable(n));\n            },\n          };\n        }\n\n        return undefined;\n      })\n      .filter((group) => !!group); // remove groups with no tabbable nodes\n\n    // throw if no groups have tabbable nodes and we don't have a fallback focus node either\n    if (\n      state.tabbableGroups.length <= 0 &&\n      !getNodeForOption('fallbackFocus') // returning false not supported for this option\n    ) {\n      throw new Error(\n        'Your focus-trap must have at least one container with at least one tabbable node in it at all times'\n      );\n    }\n  };\n\n  const tryFocus = function (node) {\n    if (node === false) {\n      return;\n    }\n\n    if (node === doc.activeElement) {\n      return;\n    }\n\n    if (!node || !node.focus) {\n      tryFocus(getInitialFocusNode());\n      return;\n    }\n\n    node.focus({ preventScroll: !!config.preventScroll });\n    state.mostRecentlyFocusedNode = node;\n\n    if (isSelectableInput(node)) {\n      node.select();\n    }\n  };\n\n  const getReturnFocusNode = function (previousActiveElement) {\n    const node = getNodeForOption('setReturnFocus', previousActiveElement);\n    return node ? node : node === false ? false : previousActiveElement;\n  };\n\n  // This needs to be done on mousedown and touchstart instead of click\n  // so that it precedes the focus event.\n  const checkPointerDown = function (e) {\n    const target = getActualTarget(e);\n\n    if (containersContain(target)) {\n      // allow the click since it ocurred inside the trap\n      return;\n    }\n\n    if (valueOrHandler(config.clickOutsideDeactivates, e)) {\n      // immediately deactivate the trap\n      trap.deactivate({\n        // if, on deactivation, we should return focus to the node originally-focused\n        //  when the trap was activated (or the configured `setReturnFocus` node),\n        //  then assume it's also OK to return focus to the outside node that was\n        //  just clicked, causing deactivation, as long as that node is focusable;\n        //  if it isn't focusable, then return focus to the original node focused\n        //  on activation (or the configured `setReturnFocus` node)\n        // NOTE: by setting `returnFocus: false`, deactivate() will do nothing,\n        //  which will result in the outside click setting focus to the node\n        //  that was clicked, whether it's focusable or not; by setting\n        //  `returnFocus: true`, we'll attempt to re-focus the node originally-focused\n        //  on activation (or the configured `setReturnFocus` node)\n        returnFocus: config.returnFocusOnDeactivate && !isFocusable(target),\n      });\n      return;\n    }\n\n    // This is needed for mobile devices.\n    // (If we'll only let `click` events through,\n    // then on mobile they will be blocked anyways if `touchstart` is blocked.)\n    if (valueOrHandler(config.allowOutsideClick, e)) {\n      // allow the click outside the trap to take place\n      return;\n    }\n\n    // otherwise, prevent the click\n    e.preventDefault();\n  };\n\n  // In case focus escapes the trap for some strange reason, pull it back in.\n  const checkFocusIn = function (e) {\n    const target = getActualTarget(e);\n    const targetContained = containersContain(target);\n\n    // In Firefox when you Tab out of an iframe the Document is briefly focused.\n    if (targetContained || target instanceof Document) {\n      if (targetContained) {\n        state.mostRecentlyFocusedNode = target;\n      }\n    } else {\n      // escaped! pull it back in to where it just left\n      e.stopImmediatePropagation();\n      tryFocus(state.mostRecentlyFocusedNode || getInitialFocusNode());\n    }\n  };\n\n  // Hijack Tab events on the first and last focusable nodes of the trap,\n  // in order to prevent focus from escaping. If it escapes for even a\n  // moment it can end up scrolling the page and causing confusion so we\n  // kind of need to capture the action at the keydown phase.\n  const checkTab = function (e) {\n    const target = getActualTarget(e);\n    updateTabbableNodes();\n\n    let destinationNode = null;\n\n    if (state.tabbableGroups.length > 0) {\n      // make sure the target is actually contained in a group\n      // NOTE: the target may also be the container itself if it's focusable\n      //  with tabIndex='-1' and was given initial focus\n      const containerIndex = findIndex(state.tabbableGroups, ({ container }) =>\n        container.contains(target)\n      );\n      const containerGroup =\n        containerIndex >= 0 ? state.tabbableGroups[containerIndex] : undefined;\n\n      if (containerIndex < 0) {\n        // target not found in any group: quite possible focus has escaped the trap,\n        //  so bring it back in to...\n        if (e.shiftKey) {\n          // ...the last node in the last group\n          destinationNode =\n            state.tabbableGroups[state.tabbableGroups.length - 1]\n              .lastTabbableNode;\n        } else {\n          // ...the first node in the first group\n          destinationNode = state.tabbableGroups[0].firstTabbableNode;\n        }\n      } else if (e.shiftKey) {\n        // REVERSE\n\n        // is the target the first tabbable node in a group?\n        let startOfGroupIndex = findIndex(\n          state.tabbableGroups,\n          ({ firstTabbableNode }) => target === firstTabbableNode\n        );\n\n        if (\n          startOfGroupIndex < 0 &&\n          (containerGroup.container === target ||\n            (isFocusable(target) &&\n              !isTabbable(target) &&\n              !containerGroup.nextTabbableNode(target, false)))\n        ) {\n          // an exception case where the target is either the container itself, or\n          //  a non-tabbable node that was given focus (i.e. tabindex is negative\n          //  and user clicked on it or node was programmatically given focus)\n          //  and is not followed by any other tabbable node, in which\n          //  case, we should handle shift+tab as if focus were on the container's\n          //  first tabbable node, and go to the last tabbable node of the LAST group\n          startOfGroupIndex = containerIndex;\n        }\n\n        if (startOfGroupIndex >= 0) {\n          // YES: then shift+tab should go to the last tabbable node in the\n          //  previous group (and wrap around to the last tabbable node of\n          //  the LAST group if it's the first tabbable node of the FIRST group)\n          const destinationGroupIndex =\n            startOfGroupIndex === 0\n              ? state.tabbableGroups.length - 1\n              : startOfGroupIndex - 1;\n\n          const destinationGroup = state.tabbableGroups[destinationGroupIndex];\n          destinationNode = destinationGroup.lastTabbableNode;\n        }\n      } else {\n        // FORWARD\n\n        // is the target the last tabbable node in a group?\n        let lastOfGroupIndex = findIndex(\n          state.tabbableGroups,\n          ({ lastTabbableNode }) => target === lastTabbableNode\n        );\n\n        if (\n          lastOfGroupIndex < 0 &&\n          (containerGroup.container === target ||\n            (isFocusable(target) &&\n              !isTabbable(target) &&\n              !containerGroup.nextTabbableNode(target)))\n        ) {\n          // an exception case where the target is the container itself, or\n          //  a non-tabbable node that was given focus (i.e. tabindex is negative\n          //  and user clicked on it or node was programmatically given focus)\n          //  and is not followed by any other tabbable node, in which\n          //  case, we should handle tab as if focus were on the container's\n          //  last tabbable node, and go to the first tabbable node of the FIRST group\n          lastOfGroupIndex = containerIndex;\n        }\n\n        if (lastOfGroupIndex >= 0) {\n          // YES: then tab should go to the first tabbable node in the next\n          //  group (and wrap around to the first tabbable node of the FIRST\n          //  group if it's the last tabbable node of the LAST group)\n          const destinationGroupIndex =\n            lastOfGroupIndex === state.tabbableGroups.length - 1\n              ? 0\n              : lastOfGroupIndex + 1;\n\n          const destinationGroup = state.tabbableGroups[destinationGroupIndex];\n          destinationNode = destinationGroup.firstTabbableNode;\n        }\n      }\n    } else {\n      // NOTE: the fallbackFocus option does not support returning false to opt-out\n      destinationNode = getNodeForOption('fallbackFocus');\n    }\n\n    if (destinationNode) {\n      e.preventDefault();\n      tryFocus(destinationNode);\n    }\n    // else, let the browser take care of [shift+]tab and move the focus\n  };\n\n  const checkKey = function (e) {\n    if (\n      isEscapeEvent(e) &&\n      valueOrHandler(config.escapeDeactivates, e) !== false\n    ) {\n      e.preventDefault();\n      trap.deactivate();\n      return;\n    }\n\n    if (isTabEvent(e)) {\n      checkTab(e);\n      return;\n    }\n  };\n\n  const checkClick = function (e) {\n    if (valueOrHandler(config.clickOutsideDeactivates, e)) {\n      return;\n    }\n\n    const target = getActualTarget(e);\n\n    if (containersContain(target)) {\n      return;\n    }\n\n    if (valueOrHandler(config.allowOutsideClick, e)) {\n      return;\n    }\n\n    e.preventDefault();\n    e.stopImmediatePropagation();\n  };\n\n  //\n  // EVENT LISTENERS\n  //\n\n  const addListeners = function () {\n    if (!state.active) {\n      return;\n    }\n\n    // There can be only one listening focus trap at a time\n    activeFocusTraps.activateTrap(trap);\n\n    // Delay ensures that the focused element doesn't capture the event\n    // that caused the focus trap activation.\n    state.delayInitialFocusTimer = config.delayInitialFocus\n      ? delay(function () {\n          tryFocus(getInitialFocusNode());\n        })\n      : tryFocus(getInitialFocusNode());\n\n    doc.addEventListener('focusin', checkFocusIn, true);\n    doc.addEventListener('mousedown', checkPointerDown, {\n      capture: true,\n      passive: false,\n    });\n    doc.addEventListener('touchstart', checkPointerDown, {\n      capture: true,\n      passive: false,\n    });\n    doc.addEventListener('click', checkClick, {\n      capture: true,\n      passive: false,\n    });\n    doc.addEventListener('keydown', checkKey, {\n      capture: true,\n      passive: false,\n    });\n\n    return trap;\n  };\n\n  const removeListeners = function () {\n    if (!state.active) {\n      return;\n    }\n\n    doc.removeEventListener('focusin', checkFocusIn, true);\n    doc.removeEventListener('mousedown', checkPointerDown, true);\n    doc.removeEventListener('touchstart', checkPointerDown, true);\n    doc.removeEventListener('click', checkClick, true);\n    doc.removeEventListener('keydown', checkKey, true);\n\n    return trap;\n  };\n\n  //\n  // TRAP DEFINITION\n  //\n\n  trap = {\n    activate(activateOptions) {\n      if (state.active) {\n        return this;\n      }\n\n      const onActivate = getOption(activateOptions, 'onActivate');\n      const onPostActivate = getOption(activateOptions, 'onPostActivate');\n      const checkCanFocusTrap = getOption(activateOptions, 'checkCanFocusTrap');\n\n      if (!checkCanFocusTrap) {\n        updateTabbableNodes();\n      }\n\n      state.active = true;\n      state.paused = false;\n      state.nodeFocusedBeforeActivation = doc.activeElement;\n\n      if (onActivate) {\n        onActivate();\n      }\n\n      const finishActivation = () => {\n        if (checkCanFocusTrap) {\n          updateTabbableNodes();\n        }\n        addListeners();\n        if (onPostActivate) {\n          onPostActivate();\n        }\n      };\n\n      if (checkCanFocusTrap) {\n        checkCanFocusTrap(state.containers.concat()).then(\n          finishActivation,\n          finishActivation\n        );\n        return this;\n      }\n\n      finishActivation();\n      return this;\n    },\n\n    deactivate(deactivateOptions) {\n      if (!state.active) {\n        return this;\n      }\n\n      clearTimeout(state.delayInitialFocusTimer); // noop if undefined\n      state.delayInitialFocusTimer = undefined;\n\n      removeListeners();\n      state.active = false;\n      state.paused = false;\n\n      activeFocusTraps.deactivateTrap(trap);\n\n      const onDeactivate = getOption(deactivateOptions, 'onDeactivate');\n      const onPostDeactivate = getOption(deactivateOptions, 'onPostDeactivate');\n      const checkCanReturnFocus = getOption(\n        deactivateOptions,\n        'checkCanReturnFocus'\n      );\n\n      if (onDeactivate) {\n        onDeactivate();\n      }\n\n      const returnFocus = getOption(\n        deactivateOptions,\n        'returnFocus',\n        'returnFocusOnDeactivate'\n      );\n\n      const finishDeactivation = () => {\n        delay(() => {\n          if (returnFocus) {\n            tryFocus(getReturnFocusNode(state.nodeFocusedBeforeActivation));\n          }\n          if (onPostDeactivate) {\n            onPostDeactivate();\n          }\n        });\n      };\n\n      if (returnFocus && checkCanReturnFocus) {\n        checkCanReturnFocus(\n          getReturnFocusNode(state.nodeFocusedBeforeActivation)\n        ).then(finishDeactivation, finishDeactivation);\n        return this;\n      }\n\n      finishDeactivation();\n      return this;\n    },\n\n    pause() {\n      if (state.paused || !state.active) {\n        return this;\n      }\n\n      state.paused = true;\n      removeListeners();\n\n      return this;\n    },\n\n    unpause() {\n      if (!state.paused || !state.active) {\n        return this;\n      }\n\n      state.paused = false;\n      updateTabbableNodes();\n      addListeners();\n\n      return this;\n    },\n\n    updateContainerElements(containerElements) {\n      const elementsAsArray = [].concat(containerElements).filter(Boolean);\n\n      state.containers = elementsAsArray.map((element) =>\n        typeof element === 'string' ? doc.querySelector(element) : element\n      );\n\n      if (state.active) {\n        updateTabbableNodes();\n      }\n\n      return this;\n    },\n  };\n\n  // initialize container elements\n  trap.updateContainerElements(elements);\n\n  return trap;\n};\n\nexport { createFocusTrap };\n"],"names":["trapQueue","activeFocusTraps","activateTrap","trap","length","activeTrap","pause","trapIndex","indexOf","splice","push","deactivateTrap","unpause","delay","fn","setTimeout","findIndex","arr","idx","every","value","i","valueOrHandler","params","getActualTarget","event","target","shadowRoot","composedPath","elements","userOptions","doc","document","config","returnFocusOnDeactivate","escapeDeactivates","delayInitialFocus","state","containers","tabbableGroups","nodeFocusedBeforeActivation","mostRecentlyFocusedNode","active","paused","delayInitialFocusTimer","undefined","getOption","configOverrideOptions","optionName","configOptionName","containersContain","element","some","container","contains","getNodeForOption","optionValue","Error","node","querySelector","getInitialFocusNode","activeElement","firstTabbableGroup","firstTabbableNode","updateTabbableNodes","map","tabbableNodes","tabbable","focusableNodes","focusable","lastTabbableNode","nextTabbableNode","forward","nodeIdx","n","slice","find","isTabbable","reverse","filter","group","tryFocus","focus","preventScroll","tagName","toLowerCase","select","isSelectableInput","getReturnFocusNode","previousActiveElement","checkPointerDown","e","clickOutsideDeactivates","deactivate","returnFocus","isFocusable","allowOutsideClick","preventDefault","checkFocusIn","targetContained","Document","stopImmediatePropagation","checkKey","key","keyCode","isEscapeEvent","isTabEvent","destinationNode","containerIndex","containerGroup","shiftKey","startOfGroupIndex","destinationGroupIndex","lastOfGroupIndex","checkTab","checkClick","addListeners","addEventListener","capture","passive","removeListeners","removeEventListener","activate","activateOptions","this","onActivate","onPostActivate","checkCanFocusTrap","finishActivation","concat","then","deactivateOptions","clearTimeout","onDeactivate","onPostDeactivate","checkCanReturnFocus","finishDeactivation","updateContainerElements","containerElements","elementsAsArray","Boolean"],"mappings":"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"}

package/dist/focus-trap.umd.js

@@ -1,5 +1,5 @@
 /*!
-* focus-trap 6.6.1
+* focus-trap 6.7.3
 * @license MIT, https://github.com/focus-trap/focus-trap/blob/master/LICENSE
 */
 (function (global, factory) {
@@ -10,22 +10,17 @@
     var exports = global.focusTrap = {};
     factory(exports, global.tabbable);
     exports.noConflict = function () { global.focusTrap = current; return exports; };
-  }()));
-}(this, (function (exports, tabbable) { 'use strict';
+  })());
+})(this, (function (exports, tabbable) { 'use strict';
 
   function ownKeys(object, enumerableOnly) {
     var keys = Object.keys(object);
 
     if (Object.getOwnPropertySymbols) {
       var symbols = Object.getOwnPropertySymbols(object);
-
-      if (enumerableOnly) {
-        symbols = symbols.filter(function (sym) {
-          return Object.getOwnPropertyDescriptor(object, sym).enumerable;
-        });
-      }
-
-      keys.push.apply(keys, symbols);
+      enumerableOnly && (symbols = symbols.filter(function (sym) {
+        return Object.getOwnPropertyDescriptor(object, sym).enumerable;
+      })), keys.push.apply(keys, symbols);
     }
 
     return keys;
@@ -33,19 +28,12 @@
 
   function _objectSpread2(target) {
     for (var i = 1; i < arguments.length; i++) {
-      var source = arguments[i] != null ? arguments[i] : {};
-
-      if (i % 2) {
-        ownKeys(Object(source), true).forEach(function (key) {
-          _defineProperty(target, key, source[key]);
-        });
-      } else if (Object.getOwnPropertyDescriptors) {
-        Object.defineProperties(target, Object.getOwnPropertyDescriptors(source));
-      } else {
-        ownKeys(Object(source)).forEach(function (key) {
-          Object.defineProperty(target, key, Object.getOwnPropertyDescriptor(source, key));
-        });
-      }
+      var source = null != arguments[i] ? arguments[i] : {};
+      i % 2 ? ownKeys(Object(source), !0).forEach(function (key) {
+        _defineProperty(target, key, source[key]);
+      }) : Object.getOwnPropertyDescriptors ? Object.defineProperties(target, Object.getOwnPropertyDescriptors(source)) : ownKeys(Object(source)).forEach(function (key) {
+        Object.defineProperty(target, key, Object.getOwnPropertyDescriptor(source, key));
+      });
     }
 
     return target;
@@ -149,8 +137,21 @@
     return typeof value === 'function' ? value.apply(void 0, params) : value;
   };
 
+  var getActualTarget = function getActualTarget(event) {
+    // NOTE: If the trap is _inside_ a shadow DOM, event.target will always be the
+    //  shadow host. However, event.target.composedPath() will be an array of
+    //  nodes "clicked" from inner-most (the actual element inside the shadow) to
+    //  outer-most (the host HTML document). If we have access to composedPath(),
+    //  then use its first element; otherwise, fall back to event.target (and
+    //  this only works for an _open_ shadow DOM; otherwise,
+    //  composedPath()[0] === event.target always).
+    return event.target.shadowRoot && typeof event.composedPath === 'function' ? event.composedPath()[0] : event.target;
+  };
+
   var createFocusTrap = function createFocusTrap(elements, userOptions) {
-    var doc = document;
+    // SSR: a live trap shouldn't be created in this type of environment so this
+    //  should be safe code to execute if the `document` option isn't specified
+    var doc = (userOptions === null || userOptions === void 0 ? void 0 : userOptions.document) || document;
 
     var config = _objectSpread2({
       returnFocusOnDeactivate: true,
@@ -167,7 +168,12 @@
       //  is active, but the trap should never get to a state where there isn't at least one group
       //  with at least one tabbable node in it (that would lead to an error condition that would
       //  result in an error being thrown)
-      // @type {Array<{ container: HTMLElement, firstTabbableNode: HTMLElement|null, lastTabbableNode: HTMLElement|null }>}
+      // @type {Array<{
+      //   container: HTMLElement,
+      //   firstTabbableNode: HTMLElement|null,
+      //   lastTabbableNode: HTMLElement|null,
+      //   nextTabbableNode: (node: HTMLElement, forward: boolean) => HTMLElement|undefined
+      // }>}
       tabbableGroups: [],
       nodeFocusedBeforeActivation: null,
       mostRecentlyFocusedNode: null,
@@ -184,33 +190,52 @@
     };
 
     var containersContain = function containersContain(element) {
-      return state.containers.some(function (container) {
+      return !!(element && state.containers.some(function (container) {
         return container.contains(element);
-      });
+      }));
     };
+    /**
+     * Gets the node for the given option, which is expected to be an option that
+     *  can be either a DOM node, a string that is a selector to get a node, `false`
+     *  (if a node is explicitly NOT given), or a function that returns any of these
+     *  values.
+     * @param {string} optionName
+     * @returns {undefined | false | HTMLElement | SVGElement} Returns
+     *  `undefined` if the option is not specified; `false` if the option
+     *  resolved to `false` (node explicitly not given); otherwise, the resolved
+     *  DOM node.
+     * @throws {Error} If the option is set, not `false`, and is not, or does not
+     *  resolve to a node.
+     */
+
 
     var getNodeForOption = function getNodeForOption(optionName) {
       var optionValue = config[optionName];
 
-      if (!optionValue) {
-        return null;
+      if (typeof optionValue === 'function') {
+        for (var _len2 = arguments.length, params = new Array(_len2 > 1 ? _len2 - 1 : 0), _key2 = 1; _key2 < _len2; _key2++) {
+          params[_key2 - 1] = arguments[_key2];
+        }
+
+        optionValue = optionValue.apply(void 0, params);
       }
 
-      var node = optionValue;
+      if (!optionValue) {
+        if (optionValue === undefined || optionValue === false) {
+          return optionValue;
+        } // else, empty string (invalid), null (invalid), 0 (invalid)
 
-      if (typeof optionValue === 'string') {
-        node = doc.querySelector(optionValue);
 
-        if (!node) {
-          throw new Error("`".concat(optionName, "` refers to no known node"));
-        }
+        throw new Error("`".concat(optionName, "` was specified but was not a node, or did not return a node"));
       }
 
-      if (typeof optionValue === 'function') {
-        node = optionValue();
+      var node = optionValue; // could be HTMLElement, SVGElement, or non-empty string at this point
+
+      if (typeof optionValue === 'string') {
+        node = doc.querySelector(optionValue); // resolve to node, or null if fails
 
         if (!node) {
-          throw new Error("`".concat(optionName, "` did not return a node"));
+          throw new Error("`".concat(optionName, "` as selector refers to no known node"));
         }
       }
 
@@ -218,20 +243,22 @@
     };
 
     var getInitialFocusNode = function getInitialFocusNode() {
-      var node; // false indicates we want no initialFocus at all
+      var node = getNodeForOption('initialFocus'); // false explicitly indicates we want no initialFocus at all
 
-      if (getOption({}, 'initialFocus') === false) {
+      if (node === false) {
         return false;
       }
 
-      if (getNodeForOption('initialFocus') !== null) {
-        node = getNodeForOption('initialFocus');
-      } else if (containersContain(doc.activeElement)) {
-        node = doc.activeElement;
-      } else {
-        var firstTabbableGroup = state.tabbableGroups[0];
-        var firstTabbableNode = firstTabbableGroup && firstTabbableGroup.firstTabbableNode;
-        node = firstTabbableNode || getNodeForOption('fallbackFocus');
+      if (node === undefined) {
+        // option not specified: use fallback options
+        if (containersContain(doc.activeElement)) {
+          node = doc.activeElement;
+        } else {
+          var firstTabbableGroup = state.tabbableGroups[0];
+          var firstTabbableNode = firstTabbableGroup && firstTabbableGroup.firstTabbableNode; // NOTE: `fallbackFocus` option function cannot return `false` (not supported)
+
+          node = firstTabbableNode || getNodeForOption('fallbackFocus');
+        }
       }
 
       if (!node) {
@@ -243,13 +270,51 @@
 
     var updateTabbableNodes = function updateTabbableNodes() {
       state.tabbableGroups = state.containers.map(function (container) {
-        var tabbableNodes = tabbable.tabbable(container);
+        var tabbableNodes = tabbable.tabbable(container); // NOTE: if we have tabbable nodes, we must have focusable nodes; focusable nodes
+        //  are a superset of tabbable nodes
+
+        var focusableNodes = tabbable.focusable(container);
 
         if (tabbableNodes.length > 0) {
           return {
             container: container,
             firstTabbableNode: tabbableNodes[0],
-            lastTabbableNode: tabbableNodes[tabbableNodes.length - 1]
+            lastTabbableNode: tabbableNodes[tabbableNodes.length - 1],
+
+            /**
+             * Finds the __tabbable__ node that follows the given node in the specified direction,
+             *  in this container, if any.
+             * @param {HTMLElement} node
+             * @param {boolean} [forward] True if going in forward tab order; false if going
+             *  in reverse.
+             * @returns {HTMLElement|undefined} The next tabbable node, if any.
+             */
+            nextTabbableNode: function nextTabbableNode(node) {
+              var forward = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : true;
+              // NOTE: If tabindex is positive (in order to manipulate the tab order separate
+              //  from the DOM order), this __will not work__ because the list of focusableNodes,
+              //  while it contains tabbable nodes, does not sort its nodes in any order other
+              //  than DOM order, because it can't: Where would you place focusable (but not
+              //  tabbable) nodes in that order? They have no order, because they aren't tabbale...
+              // Support for positive tabindex is already broken and hard to manage (possibly
+              //  not supportable, TBD), so this isn't going to make things worse than they
+              //  already are, and at least makes things better for the majority of cases where
+              //  tabindex is either 0/unset or negative.
+              // FYI, positive tabindex issue: https://github.com/focus-trap/focus-trap/issues/375
+              var nodeIdx = focusableNodes.findIndex(function (n) {
+                return n === node;
+              });
+
+              if (forward) {
+                return focusableNodes.slice(nodeIdx + 1).find(function (n) {
+                  return tabbable.isTabbable(n);
+                });
+              }
+
+              return focusableNodes.slice(0, nodeIdx).reverse().find(function (n) {
+                return tabbable.isTabbable(n);
+              });
+            }
           };
         }
 
@@ -259,7 +324,8 @@
       }); // remove groups with no tabbable nodes
       // throw if no groups have tabbable nodes and we don't have a fallback focus node either
 
-      if (state.tabbableGroups.length <= 0 && !getNodeForOption('fallbackFocus')) {
+      if (state.tabbableGroups.length <= 0 && !getNodeForOption('fallbackFocus') // returning false not supported for this option
+      ) {
         throw new Error('Your focus-trap must have at least one container with at least one tabbable node in it at all times');
       }
     };
@@ -289,14 +355,16 @@
     };
 
     var getReturnFocusNode = function getReturnFocusNode(previousActiveElement) {
-      var node = getNodeForOption('setReturnFocus');
-      return node ? node : previousActiveElement;
+      var node = getNodeForOption('setReturnFocus', previousActiveElement);
+      return node ? node : node === false ? false : previousActiveElement;
     }; // This needs to be done on mousedown and touchstart instead of click
     // so that it precedes the focus event.
 
 
     var checkPointerDown = function checkPointerDown(e) {
-      if (containersContain(e.target)) {
+      var target = getActualTarget(e);
+
+      if (containersContain(target)) {
         // allow the click since it ocurred inside the trap
         return;
       }
@@ -315,7 +383,7 @@
           //  that was clicked, whether it's focusable or not; by setting
           //  `returnFocus: true`, we'll attempt to re-focus the node originally-focused
           //  on activation (or the configured `setReturnFocus` node)
-          returnFocus: config.returnFocusOnDeactivate && !tabbable.isFocusable(e.target)
+          returnFocus: config.returnFocusOnDeactivate && !tabbable.isFocusable(target)
         });
         return;
       } // This is needed for mobile devices.
@@ -334,11 +402,12 @@
 
 
     var checkFocusIn = function checkFocusIn(e) {
-      var targetContained = containersContain(e.target); // In Firefox when you Tab out of an iframe the Document is briefly focused.
+      var target = getActualTarget(e);
+      var targetContained = containersContain(target); // In Firefox when you Tab out of an iframe the Document is briefly focused.
 
-      if (targetContained || e.target instanceof Document) {
+      if (targetContained || target instanceof Document) {
         if (targetContained) {
-          state.mostRecentlyFocusedNode = e.target;
+          state.mostRecentlyFocusedNode = target;
         }
       } else {
         // escaped! pull it back in to where it just left
@@ -352,17 +421,19 @@
 
 
     var checkTab = function checkTab(e) {
+      var target = getActualTarget(e);
       updateTabbableNodes();
       var destinationNode = null;
 
       if (state.tabbableGroups.length > 0) {
         // make sure the target is actually contained in a group
-        // NOTE: the target may also be the container itself if it's tabbable
+        // NOTE: the target may also be the container itself if it's focusable
         //  with tabIndex='-1' and was given initial focus
         var containerIndex = findIndex(state.tabbableGroups, function (_ref) {
           var container = _ref.container;
-          return container.contains(e.target);
+          return container.contains(target);
         });
+        var containerGroup = containerIndex >= 0 ? state.tabbableGroups[containerIndex] : undefined;
 
         if (containerIndex < 0) {
           // target not found in any group: quite possible focus has escaped the trap,
@@ -379,11 +450,14 @@
           // is the target the first tabbable node in a group?
           var startOfGroupIndex = findIndex(state.tabbableGroups, function (_ref2) {
             var firstTabbableNode = _ref2.firstTabbableNode;
-            return e.target === firstTabbableNode;
+            return target === firstTabbableNode;
           });
 
-          if (startOfGroupIndex < 0 && state.tabbableGroups[containerIndex].container === e.target) {
-            // an exception case where the target is the container itself, in which
+          if (startOfGroupIndex < 0 && (containerGroup.container === target || tabbable.isFocusable(target) && !tabbable.isTabbable(target) && !containerGroup.nextTabbableNode(target, false))) {
+            // an exception case where the target is either the container itself, or
+            //  a non-tabbable node that was given focus (i.e. tabindex is negative
+            //  and user clicked on it or node was programmatically given focus)
+            //  and is not followed by any other tabbable node, in which
             //  case, we should handle shift+tab as if focus were on the container's
             //  first tabbable node, and go to the last tabbable node of the LAST group
             startOfGroupIndex = containerIndex;
@@ -402,11 +476,14 @@
           // is the target the last tabbable node in a group?
           var lastOfGroupIndex = findIndex(state.tabbableGroups, function (_ref3) {
             var lastTabbableNode = _ref3.lastTabbableNode;
-            return e.target === lastTabbableNode;
+            return target === lastTabbableNode;
           });
 
-          if (lastOfGroupIndex < 0 && state.tabbableGroups[containerIndex].container === e.target) {
-            // an exception case where the target is the container itself, in which
+          if (lastOfGroupIndex < 0 && (containerGroup.container === target || tabbable.isFocusable(target) && !tabbable.isTabbable(target) && !containerGroup.nextTabbableNode(target))) {
+            // an exception case where the target is the container itself, or
+            //  a non-tabbable node that was given focus (i.e. tabindex is negative
+            //  and user clicked on it or node was programmatically given focus)
+            //  and is not followed by any other tabbable node, in which
             //  case, we should handle tab as if focus were on the container's
             //  last tabbable node, and go to the first tabbable node of the FIRST group
             lastOfGroupIndex = containerIndex;
@@ -423,6 +500,7 @@
           }
         }
       } else {
+        // NOTE: the fallbackFocus option does not support returning false to opt-out
         destinationNode = getNodeForOption('fallbackFocus');
       }
 
@@ -434,7 +512,7 @@
     };
 
     var checkKey = function checkKey(e) {
-      if (isEscapeEvent(e) && valueOrHandler(config.escapeDeactivates) !== false) {
+      if (isEscapeEvent(e) && valueOrHandler(config.escapeDeactivates, e) !== false) {
         e.preventDefault();
         trap.deactivate();
         return;
@@ -451,7 +529,9 @@
         return;
       }
 
-      if (containersContain(e.target)) {
+      var target = getActualTarget(e);
+
+      if (containersContain(target)) {
         return;
       }
 
@@ -639,5 +719,5 @@
 
   Object.defineProperty(exports, '__esModule', { value: true });
 
-})));
+}));
 //# sourceMappingURL=focus-trap.umd.js.map